# Cloud-Only Features Analysis

Features that need removal or replacement for self-hosted CleverAgents.

## Summary

- Total cloud features identified: 15
- Features to remove: 6
- Features to replace: 9
- Go files affected: 35

## Replacement Strategies

### Features to Remove

These features should be completely removed:

- **billing_ui** (high priority)
  - Web-based billing and subscription UI
  - Notes: Replace with self-host cost estimation guide

- **api_proxy** (high priority)
  - Cloud API key proxying service
  - Notes: Users manage their own provider API keys

- **old_api_versions** (medium priority)
  - Backward compatibility with old API versions
  - Notes: CleverAgents starts fresh with v1 only

- **cloud_backups** (low priority)
  - Automated cloud backups
  - Notes: Provide backup scripts and best practices

- **push_notifications** (low priority)
  - Mobile/desktop push notifications
  - Notes: Focus on CLI/TUI notifications

- **legacy_models** (low priority)
  - Support for deprecated model versions
  - Notes: Remove support for EOL models

### Features to Replace

These features need local alternatives:

- **managed_auth** (high priority)
  - Cloud-based authentication service
  - Replacement: Local auth with optional LDAP/SAML
  - Notes: Implement local user management with pluggable auth

- **email_service** (high priority)
  - Cloud email service integration
  - Replacement: SMTP configuration with local mail server
  - Notes: Support standard SMTP with templates

- **usage_limits** (medium priority)
  - Usage-based limits and quotas
  - Replacement: Configurable local limits
  - Notes: Make limits configurable via settings

- **usage_telemetry** (medium priority)
  - Usage tracking and analytics
  - Replacement: Opt-in local telemetry with OpenTelemetry
  - Notes: Default to disabled, provide local dashboard option

- **api_keys_cloud** (medium priority)
  - Cloud-managed API keys
  - Replacement: Local API key management
  - Notes: Store encrypted keys locally

- **cdn_assets** (medium priority)
  - CDN-hosted static assets
  - Replacement: Bundle assets in distribution
  - Notes: Include all assets in package

- **org_management** (medium priority)
  - Cloud-based organization management
  - Replacement: Local team management with roles
  - Notes: Simplified local team structure

- **error_reporting** (low priority)
  - Centralized error reporting service
  - Replacement: Local error logging with optional export
  - Notes: Use structured logging with export options

- **team_sync** (low priority)
  - Real-time team state synchronization
  - Replacement: Database-based sync for multi-user mode
  - Notes: Use DB polling or websockets locally

## Detailed Analysis by Category

### Billing
Payment processing and subscription management

#### Billing Ui
- **Action**: remove
- **Priority**: high
- **Description**: Web-based billing and subscription UI
- **Replacement**: Documentation on self-hosting costs
- **Notes**: Replace with self-host cost estimation guide

#### Usage Limits
- **Action**: replace
- **Priority**: medium
- **Description**: Usage-based limits and quotas
- **Functionality**:
  - API call limits
  - Storage quotas
  - Team size limits
- **Replacement**: Configurable local limits
- **Notes**: Make limits configurable via settings

### Telemetry
Usage tracking and analytics

#### Usage Telemetry
- **Action**: replace
- **Priority**: medium
- **Description**: Usage tracking and analytics
- **Replacement**: Opt-in local telemetry with OpenTelemetry
- **Notes**: Default to disabled, provide local dashboard option

#### Error Reporting
- **Action**: replace
- **Priority**: low
- **Description**: Centralized error reporting service
- **Replacement**: Local error logging with optional export
- **Notes**: Use structured logging with export options

### Managed Auth
Centralized authentication service

#### Managed Auth
- **Action**: replace
- **Priority**: high
- **Description**: Cloud-based authentication service
- **Functionality**:
  - OAuth providers
  - SSO integration
  - Password reset emails
  - Email verification
- **Replacement**: Local auth with optional LDAP/SAML
- **Notes**: Implement local user management with pluggable auth

#### Api Keys Cloud
- **Action**: replace
- **Priority**: medium
- **Description**: Cloud-managed API keys
- **Functionality**:
  - Key generation
  - Key rotation
  - Usage tracking per key
- **Replacement**: Local API key management
- **Notes**: Store encrypted keys locally

### Cloud Storage
Cloud-based data storage

#### Cloud Backups
- **Action**: remove
- **Priority**: low
- **Description**: Automated cloud backups
- **Functionality**:
  - Automated S3 backups
  - Point-in-time recovery
  - Cross-region replication
- **Replacement**: Local backup documentation
- **Notes**: Provide backup scripts and best practices

#### Cdn Assets
- **Action**: replace
- **Priority**: medium
- **Description**: CDN-hosted static assets
- **Replacement**: Bundle assets in distribution
- **Notes**: Include all assets in package

### Notifications
Cloud notification services

#### Email Service
- **Action**: replace
- **Priority**: high
- **Description**: Cloud email service integration
- **Functionality**:
  - Invite emails
  - Password reset
  - Notifications
  - Reports
- **Replacement**: SMTP configuration with local mail server
- **Notes**: Support standard SMTP with templates

#### Push Notifications
- **Action**: remove
- **Priority**: low
- **Description**: Mobile/desktop push notifications
- **Replacement**: In-app notifications only
- **Notes**: Focus on CLI/TUI notifications

### Rate Limiting
Cloud-based rate limiting

### Team Management
Centralized team/org management

#### Org Management
- **Action**: replace
- **Priority**: medium
- **Description**: Cloud-based organization management
- **Functionality**:
  - Org creation
  - Member management
  - Role assignment
  - Billing per org
- **Replacement**: Local team management with roles
- **Notes**: Simplified local team structure

#### Team Sync
- **Action**: replace
- **Priority**: low
- **Description**: Real-time team state synchronization
- **Functionality**:
  - Real-time updates
  - Presence tracking
  - Shared contexts
- **Replacement**: Database-based sync for multi-user mode
- **Notes**: Use DB polling or websockets locally

### Api Proxying
API key management and proxying

#### Api Proxy
- **Action**: remove
- **Priority**: high
- **Description**: Cloud API key proxying service
- **Functionality**:
  - Hide user API keys
  - Rate limit per user
  - Usage tracking
  - Cost allocation
- **Replacement**: Direct API usage with user keys
- **Notes**: Users manage their own provider API keys