Files
cleveragents-core/docs/reference/cloud/cloud_features.yaml
T

331 lines
9.8 KiB
YAML

cloud_features:
billing_ui:
category: billing
description: Web-based billing and subscription UI
action: remove
go_references:
- app/cli/cmd/billing.go
- app/server/handlers/billing_handlers.go
- app/shared/billing.go
ui_elements:
- Billing dashboard links
- Subscription status display
- Payment method prompts
replacement: Documentation on self-hosting costs
priority: high
notes: Replace with self-host cost estimation guide
usage_limits:
category: billing
description: Usage-based limits and quotas
action: replace
go_references:
- app/server/middleware/usage_limits.go
- app/shared/usage.go
functionality:
- API call limits
- Storage quotas
- Team size limits
replacement: Configurable local limits
priority: medium
notes: Make limits configurable via settings
usage_telemetry:
category: telemetry
description: Usage tracking and analytics
action: replace
go_references:
- app/cli/lib/telemetry.go
- app/server/telemetry/telemetry.go
- app/shared/telemetry.go
data_collected:
- Command usage statistics
- Model usage metrics
- Error tracking
- Performance metrics
replacement: Opt-in local telemetry with OpenTelemetry
priority: medium
notes: Default to disabled, provide local dashboard option
error_reporting:
category: telemetry
description: Centralized error reporting service
action: replace
go_references:
- app/cli/lib/error_reporting.go
- app/server/errors/reporting.go
services:
- Sentry integration
- Error aggregation
- Alert notifications
replacement: Local error logging with optional export
priority: low
notes: Use structured logging with export options
managed_auth:
category: managed_auth
description: Cloud-based authentication service
action: replace
go_references:
- app/server/auth/cloud_auth.go
- app/cli/lib/auth_cloud.go
- app/shared/auth.go
functionality:
- OAuth providers
- SSO integration
- Password reset emails
- Email verification
replacement: Local auth with optional LDAP/SAML
priority: high
notes: Implement local user management with pluggable auth
api_keys_cloud:
category: managed_auth
description: Cloud-managed API keys
action: replace
go_references:
- app/server/api/keys.go
- app/cli/cmd/api_keys.go
functionality:
- Key generation
- Key rotation
- Usage tracking per key
replacement: Local API key management
priority: medium
notes: Store encrypted keys locally
cloud_backups:
category: cloud_storage
description: Automated cloud backups
action: remove
go_references:
- app/server/backup/cloud_backup.go
- app/cli/cmd/backup.go
functionality:
- Automated S3 backups
- Point-in-time recovery
- Cross-region replication
replacement: Local backup documentation
priority: low
notes: Provide backup scripts and best practices
cdn_assets:
category: cloud_storage
description: CDN-hosted static assets
action: replace
go_references:
- app/server/static/cdn.go
- app/shared/assets.go
assets:
- Documentation images
- UI components
- Model metadata
replacement: Bundle assets in distribution
priority: medium
notes: Include all assets in package
email_service:
category: notifications
description: Cloud email service integration
action: replace
go_references:
- app/server/email/sendgrid.go
- app/server/email/ses.go
- app/shared/notifications.go
functionality:
- Invite emails
- Password reset
- Notifications
- Reports
replacement: SMTP configuration with local mail server
priority: high
notes: Support standard SMTP with templates
push_notifications:
category: notifications
description: Mobile/desktop push notifications
action: remove
go_references:
- app/server/push/push.go
- app/cli/lib/notifications.go
services:
- Firebase messaging
- APNS
- Web push
replacement: In-app notifications only
priority: low
notes: Focus on CLI/TUI notifications
org_management:
category: team_management
description: Cloud-based organization management
action: replace
go_references:
- app/server/org/org_management.go
- app/cli/cmd/org.go
- app/shared/org.go
functionality:
- Org creation
- Member management
- Role assignment
- Billing per org
replacement: Local team management with roles
priority: medium
notes: Simplified local team structure
team_sync:
category: team_management
description: Real-time team state synchronization
action: replace
go_references:
- app/server/sync/team_sync.go
- app/shared/sync.go
functionality:
- Real-time updates
- Presence tracking
- Shared contexts
replacement: Database-based sync for multi-user mode
priority: low
notes: Use DB polling or websockets locally
api_proxy:
category: api_proxying
description: Cloud API key proxying service
action: remove
go_references:
- app/server/proxy/api_proxy.go
- app/cli/lib/proxy.go
functionality:
- Hide user API keys
- Rate limit per user
- Usage tracking
- Cost allocation
replacement: Direct API usage with user keys
priority: high
notes: Users manage their own provider API keys
legacy_models:
category: deprecated
description: Support for deprecated model versions
action: remove
go_references:
- app/shared/deprecated_models.go
- app/cli/lib/legacy_models.go
models:
- GPT-3 variants
- Claude v1
- Old Codex models
replacement: Current models only
priority: low
notes: Remove support for EOL models
old_api_versions:
category: deprecated
description: Backward compatibility with old API versions
action: remove
go_references:
- app/server/handlers/v1/
- app/server/handlers/v2/
versions:
- API v1
- API v2
- Legacy endpoints
replacement: Single current API version
priority: medium
notes: CleverAgents starts fresh with v1 only
replacements:
remove:
- feature: billing_ui
description: Web-based billing and subscription UI
replacement: Documentation on self-hosting costs
priority: high
notes: Replace with self-host cost estimation guide
- feature: api_proxy
description: Cloud API key proxying service
replacement: Direct API usage with user keys
priority: high
notes: Users manage their own provider API keys
- feature: old_api_versions
description: Backward compatibility with old API versions
replacement: Single current API version
priority: medium
notes: CleverAgents starts fresh with v1 only
- feature: cloud_backups
description: Automated cloud backups
replacement: Local backup documentation
priority: low
notes: Provide backup scripts and best practices
- feature: push_notifications
description: Mobile/desktop push notifications
replacement: In-app notifications only
priority: low
notes: Focus on CLI/TUI notifications
- feature: legacy_models
description: Support for deprecated model versions
replacement: Current models only
priority: low
notes: Remove support for EOL models
replace:
- feature: managed_auth
description: Cloud-based authentication service
replacement: Local auth with optional LDAP/SAML
priority: high
notes: Implement local user management with pluggable auth
- feature: email_service
description: Cloud email service integration
replacement: SMTP configuration with local mail server
priority: high
notes: Support standard SMTP with templates
- feature: usage_limits
description: Usage-based limits and quotas
replacement: Configurable local limits
priority: medium
notes: Make limits configurable via settings
- feature: usage_telemetry
description: Usage tracking and analytics
replacement: Opt-in local telemetry with OpenTelemetry
priority: medium
notes: Default to disabled, provide local dashboard option
- feature: api_keys_cloud
description: Cloud-managed API keys
replacement: Local API key management
priority: medium
notes: Store encrypted keys locally
- feature: cdn_assets
description: CDN-hosted static assets
replacement: Bundle assets in distribution
priority: medium
notes: Include all assets in package
- feature: org_management
description: Cloud-based organization management
replacement: Local team management with roles
priority: medium
notes: Simplified local team structure
- feature: error_reporting
description: Centralized error reporting service
replacement: Local error logging with optional export
priority: low
notes: Use structured logging with export options
- feature: team_sync
description: Real-time team state synchronization
replacement: Database-based sync for multi-user mode
priority: low
notes: Use DB polling or websockets locally
defer: []
statistics:
total_features: 15
by_category:
billing: 2
telemetry: 2
managed_auth: 2
cloud_storage: 2
notifications: 2
team_management: 2
api_proxying: 1
deprecated: 2
by_action:
remove: 6
replace: 9
defer: 0
by_priority:
high: 4
medium: 6
low: 5
go_files_affected: 35
functionality_count: 28
categories:
billing: Payment processing and subscription management
telemetry: Usage tracking and analytics
managed_auth: Centralized authentication service
cloud_storage: Cloud-based data storage
notifications: Cloud notification services
rate_limiting: Cloud-based rate limiting
team_management: Centralized team/org management
api_proxying: API key management and proxying