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

416 lines
12 KiB
JSON

{
"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"
}
}