aidp 0.5.0 → 0.8.0

data/templates/README.md

@@ -0,0 +1,279 @@
+# AIDP Configuration Examples
+
+This directory contains example configuration files for the AIDP (AI Dev Pipeline) harness system. Choose the configuration that best fits your needs and copy it to your project root as `aidp.yml`.
+
+## Available Configuration Files
+
+### 1. `aidp.yml.example` - Complete Configuration
+
+**Best for**: Production use, comprehensive setups, advanced users
+
+This is the most comprehensive configuration file that demonstrates all available harness features including:
+
+- Complete harness configuration with all options
+- Multiple provider configurations (Cursor, Claude, Gemini)
+- Advanced features like circuit breakers, load balancing, health checks
+- Environment-specific configurations
+- Mode-specific configurations (analyze vs execute)
+- Feature flags
+- Time-based configurations
+- Step-specific configurations
+- User-specific configurations
+- Comprehensive monitoring and logging
+- Security configurations
+
+### 2. `aidp-minimal.yml.example` - Minimal Configuration
+
+**Best for**: Getting started, simple setups, basic usage
+
+This is a minimal configuration file that includes only the essential settings:
+
+- Basic harness configuration
+- Two providers (Cursor and Claude)
+- Essential features only
+- Simple retry and fallback configuration
+
+### 3. `aidp-production.yml.example` - Production Configuration
+
+**Best for**: Production deployments, enterprise use, high availability
+
+This configuration is optimized for production use with:
+
+- Comprehensive monitoring and alerting
+- Robust error handling and retry logic
+- Circuit breaker patterns for fault tolerance
+- Load balancing and health checks
+- Security configurations
+- Cost tracking and budgeting
+- Audit logging
+- Performance optimizations
+
+### 4. `aidp-development.yml.example` - Development Configuration
+
+**Best for**: Development, testing, debugging
+
+This configuration is optimized for development with:
+
+- Relaxed timeouts and retry settings
+- Enhanced logging and debugging
+- Disabled rate limiting for testing
+- Fast feedback loops
+- Detailed error reporting
+- Request/response logging
+
+## Quick Start
+
+1. **Choose a configuration file** based on your needs
+2. **Copy it to your project root** as `aidp.yml`:
+
+   ```bash
+   cp templates/aidp-minimal.yml.example aidp.yml
+   ```
+
+3. **Set up your API keys** in environment variables:
+
+   ```bash
+   export ANTHROPIC_API_KEY="your_api_key_here"
+   export GEMINI_API_KEY="your_api_key_here"
+   ```
+
+4. **Customize the configuration** for your specific needs
+5. **Run AIDP** with the harness:
+
+   ```bash
+   aidp analyze
+   aidp execute
+   ```
+
+## Configuration Sections
+
+### Harness Configuration
+
+The `harness` section controls the overall behavior of the harness system:
+
+- `default_provider`: Primary provider to use
+- `fallback_providers`: Backup providers in order of preference
+- `max_retries`: Number of retry attempts
+- `request_timeout`: Global request timeout
+- `auto_switch_on_error`: Automatically switch providers on errors
+- `auto_switch_on_rate_limit`: Automatically switch providers on rate limits
+
+### Provider Configuration
+
+The `providers` section defines individual provider settings:
+
+- `type`: Provider type (package, api, byok)
+- `priority`: Provider priority (higher = more preferred)
+- `models`: Available models for the provider
+- `features`: Provider capabilities
+- `auth`: Authentication configuration
+- `endpoints`: API endpoints
+- `monitoring`: Monitoring and metrics
+- `rate_limit`: Rate limiting settings
+- `retry`: Retry configuration
+- `circuit_breaker`: Circuit breaker settings
+- `cost`: Cost tracking
+- `health_check`: Health check configuration
+- `log`: Logging configuration
+- `cache`: Caching configuration
+- `security`: Security settings
+
+### Advanced Features
+
+#### Environment-Specific Configuration
+
+Use the `environments` section to have different settings for different environments:
+
+```yaml
+environments:
+  development:
+    harness:
+      max_retries: 1
+  production:
+    harness:
+      max_retries: 3
+```
+
+#### Mode-Specific Configuration
+
+Use the `analyze_mode` and `execute_mode` sections for different execution modes:
+
+```yaml
+analyze_mode:
+  harness:
+    request_timeout: 600
+execute_mode:
+  harness:
+    request_timeout: 300
+```
+
+#### Feature Flags
+
+Use the `features` section to enable/disable functionality:
+
+```yaml
+features:
+  debugging:
+    harness:
+      log_errors: true
+```
+
+#### Time-Based Configuration
+
+Use the `time_based` section for different settings based on time:
+
+```yaml
+time_based:
+  hours:
+    9..17:  # Business hours
+      harness:
+        max_retries: 2
+```
+
+## Provider Types
+
+### Package Providers
+
+- **Type**: `package`
+- **Pricing**: Fixed monthly/yearly subscription
+- **Examples**: Cursor Pro
+- **Configuration**: No API keys needed
+
+### API Providers
+
+- **Type**: `api`
+- **Pricing**: Pay-per-use based on tokens
+- **Examples**: Claude, Gemini
+- **Configuration**: Requires API keys
+
+### BYOK Providers
+
+- **Type**: `byok`
+- **Pricing**: User provides their own API key
+- **Examples**: OpenAI, custom APIs
+- **Configuration**: User manages API keys
+
+## Best Practices
+
+### Security
+
+- Store API keys in environment variables, not in the config file
+- Use `restrict_to_non_byok: true` to avoid BYOK providers
+- Enable SSL verification in production
+- Configure allowed/blocked hosts appropriately
+
+### Performance
+
+- Enable caching for frequently used responses
+- Use appropriate timeouts for different models
+- Configure rate limits based on your API plans
+- Enable parallel processing for better throughput
+
+### Reliability
+
+- Configure fallback providers for automatic failover
+- Enable circuit breakers for fault tolerance
+- Set up health checks for all providers
+- Configure appropriate retry strategies
+
+### Monitoring
+
+- Enable metrics collection in production
+- Set up log rotation and retention
+- Configure monitoring intervals appropriately
+- Enable audit logging for compliance
+
+### Cost Management
+
+- Configure cost tracking for API providers
+- Set appropriate token limits
+- Monitor usage and costs regularly
+- Use cost-effective models when possible
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Provider not working**: Check API keys and endpoints
+2. **Rate limiting**: Adjust rate limit settings or use fallback providers
+3. **Timeout errors**: Increase timeout values
+4. **Configuration errors**: Validate your YAML syntax
+5. **Permission errors**: Check file permissions for log files
+
+### Validation
+
+Use the AIDP configuration validator to check your configuration:
+
+```bash
+aidp config validate
+```
+
+### Debugging
+
+Enable debug logging to troubleshoot issues:
+
+```yaml
+providers:
+  your_provider:
+    log:
+      level: "debug"
+      log_requests: true
+      log_responses: true
+```
+
+## Support
+
+For more information about AIDP configuration, see:
+
+- [AIDP Documentation](https://github.com/your-org/aidp/docs)
+- [Configuration Schema](https://github.com/your-org/aidp/docs/configuration-schema.md)
+- [Provider Guide](https://github.com/your-org/aidp/docs/providers.md)
+
+## Contributing
+
+To contribute new configuration examples or improve existing ones:
+
+1. Fork the repository
+2. Create a new configuration file or modify an existing one
+3. Test your configuration thoroughly
+4. Submit a pull request with your changes

data/templates/aidp-development.yml.example

@@ -0,0 +1,373 @@
+# Development AIDP Configuration
+# This is a development-friendly configuration with debugging features enabled
+# Copy this file to your project root as 'aidp.yml' and customize as needed
+
+# Harness configuration
+harness:
+  # Default provider to use
+  default_provider: "cursor"
+
+  # Fallback providers
+  fallback_providers: ["claude"]
+
+  # Development settings
+  max_retries: 1
+  request_timeout: 60
+  user_feedback_timeout: 60
+  work_completion_timeout: 300
+
+  # Development features
+  auto_switch_on_error: true
+  auto_switch_on_rate_limit: true
+  max_concurrent_requests: 2
+
+  # Circuit breaker configuration (relaxed for development)
+  circuit_breaker:
+    enabled: false
+    failure_threshold: 10
+    timeout: 60
+    half_open_max_calls: 5
+
+  # Retry configuration (minimal for development)
+  retry:
+    enabled: true
+    max_attempts: 1
+    base_delay: 0.5
+    max_delay: 5.0
+    exponential_base: 2.0
+    jitter: false
+
+  # Rate limiting configuration (relaxed for development)
+  rate_limit:
+    enabled: false
+    default_reset_time: 60
+    burst_limit: 100
+    sustained_limit: 50
+
+  # Load balancing configuration
+  load_balancing:
+    enabled: false
+    strategy: "round_robin"
+    health_check_interval: 300
+    unhealthy_threshold: 10
+
+  # Health check configuration (relaxed for development)
+  health_check:
+    enabled: false
+    interval: 300
+    timeout: 30
+    failure_threshold: 10
+    success_threshold: 1
+
+  # Metrics configuration (minimal for development)
+  metrics:
+    enabled: true
+    retention_days: 1
+    aggregation_interval: 60
+    export_interval: 300
+
+  # Session configuration
+  session:
+    enabled: true
+    timeout: 600
+    sticky_sessions: false
+    session_affinity: "provider"
+
+  # User interface configuration (enhanced for development)
+  ui:
+    enabled: true
+    interactive_mode: true
+    file_selection: true
+    progress_display: true
+    status_updates: true
+    pause_resume: true
+
+  # Error handling configuration (enhanced for development)
+  error_handling:
+    enabled: true
+    log_errors: true
+    retry_on_error: false
+    fallback_on_error: true
+    error_notification: true
+
+  # Performance optimization (disabled for development)
+  performance:
+    enabled: false
+    cache_responses: false
+    parallel_processing: false
+    batch_requests: false
+    connection_pooling: false
+
+  # Security configuration (relaxed for development)
+  security:
+    enabled: false
+    ssl_verify: false
+    allowed_hosts: []
+    blocked_hosts: []
+    api_key_rotation: false
+    audit_logging: false
+
+# Provider configurations
+providers:
+  # Cursor provider (primary for development)
+  cursor:
+    type: "package"
+    priority: 1
+    default_flags: []
+
+    # Available models
+    models: ["cursor-default", "cursor-fast"]
+
+    # Model weights for load balancing
+    model_weights:
+      cursor-default: 2
+      cursor-fast: 1
+
+    # Model-specific configurations
+    models_config:
+      cursor-default:
+        flags: []
+        timeout: 120
+      cursor-fast:
+        flags: ["--fast"]
+        timeout: 60
+
+    # Provider features
+    features:
+      file_upload: true
+      code_generation: true
+      analysis: true
+      streaming: true
+
+    # Monitoring configuration (enhanced for development)
+    monitoring:
+      enabled: true
+      metrics_interval: 10
+
+    # Rate limiting configuration (disabled for development)
+    rate_limit:
+      enabled: false
+      requests_per_minute: 1000
+      requests_per_hour: 10000
+      burst_limit: 100
+
+    # Retry configuration (minimal for development)
+    retry:
+      enabled: true
+      max_attempts: 1
+      base_delay: 0.5
+      max_delay: 5.0
+      exponential_base: 2.0
+      jitter: false
+
+    # Circuit breaker configuration (disabled for development)
+    circuit_breaker:
+      enabled: false
+      failure_threshold: 100
+      timeout: 60
+      half_open_max_calls: 10
+
+    # Cost tracking
+    cost:
+      input_cost_per_token: 0.0
+      output_cost_per_token: 0.0
+      fixed_cost_per_request: 0.0
+      currency: "USD"
+
+    # Health check configuration (disabled for development)
+    health_check:
+      enabled: false
+      interval: 300
+      timeout: 30
+      failure_threshold: 100
+      success_threshold: 1
+
+    # Logging configuration (enhanced for development)
+    log:
+      enabled: true
+      level: "debug"
+      file: "logs/cursor-dev.log"
+      max_size: 10485760  # 10MB
+      max_files: 3
+      format: "text"
+      log_requests: true
+      log_responses: true
+
+    # Cache configuration (disabled for development)
+    cache:
+      enabled: false
+      ttl: 60
+      max_size: 10
+      strategy: "lru"
+
+    # Security configuration (relaxed for development)
+    security:
+      ssl_verify: false
+      allowed_hosts: []
+      blocked_hosts: []
+      timeout: 60
+      max_redirects: 10
+
+  # Claude provider (fallback for development)
+  claude:
+    type: "api"
+    priority: 2
+    max_tokens: 10000
+    default_flags: ["--dangerously-skip-permissions"]
+
+    # Available models (limited for development)
+    models: ["claude-3-5-haiku-20241022"]
+
+    # Model weights for load balancing
+    model_weights:
+      claude-3-5-haiku-20241022: 1
+
+    # Model-specific configurations
+    models_config:
+      claude-3-5-haiku-20241022:
+        flags: ["--dangerously-skip-permissions"]
+        max_tokens: 10000
+        timeout: 60
+
+    # Authentication configuration
+    auth:
+      api_key_env: "ANTHROPIC_API_KEY"
+
+    # Endpoint configuration
+    endpoints:
+      default: "https://api.anthropic.com/v1/messages"
+
+    # Provider features
+    features:
+      file_upload: true
+      code_generation: true
+      analysis: true
+      vision: true
+      streaming: true
+      function_calling: true
+      tool_use: true
+
+    # Monitoring configuration (enhanced for development)
+    monitoring:
+      enabled: true
+      metrics_interval: 10
+
+    # Rate limiting configuration (relaxed for development)
+    rate_limit:
+      enabled: false
+      requests_per_minute: 100
+      requests_per_hour: 1000
+      tokens_per_minute: 10000
+      tokens_per_hour: 100000
+      burst_limit: 20
+
+    # Retry configuration (minimal for development)
+    retry:
+      enabled: true
+      max_attempts: 1
+      base_delay: 0.5
+      max_delay: 5.0
+      exponential_base: 2.0
+      jitter: false
+      retry_on_rate_limit: false
+
+    # Circuit breaker configuration (disabled for development)
+    circuit_breaker:
+      enabled: false
+      failure_threshold: 100
+      timeout: 60
+      half_open_max_calls: 10
+
+    # Cost tracking
+    cost:
+      input_cost_per_token: 0.000003
+      output_cost_per_token: 0.000015
+      fixed_cost_per_request: 0.0
+      currency: "USD"
+
+    # Health check configuration (disabled for development)
+    health_check:
+      enabled: false
+      interval: 300
+      timeout: 30
+      failure_threshold: 100
+      success_threshold: 1
+      check_url: "https://api.anthropic.com/v1/messages"
+
+    # Logging configuration (enhanced for development)
+    log:
+      enabled: true
+      level: "debug"
+      file: "logs/claude-dev.log"
+      max_size: 10485760  # 10MB
+      max_files: 3
+      format: "text"
+      log_requests: true
+      log_responses: true
+
+    # Cache configuration (disabled for development)
+    cache:
+      enabled: false
+      ttl: 60
+      max_size: 10
+      strategy: "lru"
+
+    # Security configuration (relaxed for development)
+    security:
+      ssl_verify: false
+      allowed_hosts: []
+      blocked_hosts: []
+      timeout: 60
+      max_redirects: 10
+
+# Environment-specific configurations
+environments:
+  development:
+    harness:
+      max_retries: 1
+      request_timeout: 60
+    providers:
+      cursor:
+        log:
+          level: "debug"
+        monitoring:
+          enabled: true
+      claude:
+        rate_limit:
+          enabled: false
+        log:
+          level: "debug"
+        monitoring:
+          enabled: true
+
+# Feature flags for development
+features:
+  debugging:
+    harness:
+      log_errors: true
+      error_notification: true
+    providers:
+      cursor:
+        log:
+          level: "debug"
+          log_requests: true
+          log_responses: true
+      claude:
+        log:
+          level: "debug"
+          log_requests: true
+          log_responses: true
+
+# Configuration tips for development:
+# - Use minimal retry settings for faster feedback
+# - Enable detailed logging for debugging
+# - Disable rate limiting for testing
+# - Use relaxed timeouts for development
+# - Enable request/response logging
+# - Disable caching to see fresh results
+# - Use minimal health checks
+# - Disable circuit breakers for testing
+# - Use text format logs for readability
+# - Set up proper API keys in environment variables
+# - Use fast models for quicker iteration
+# - Enable all debugging features

data/templates/aidp-minimal.yml.example

@@ -0,0 +1,48 @@
+# Minimal AIDP Configuration
+# This is a minimal configuration file for basic harness usage
+# Copy this file to your project root as 'aidp.yml' and customize as needed
+
+# Harness configuration
+harness:
+  # Default provider to use
+  default_provider: "cursor"
+
+  # Fallback providers
+  fallback_providers: ["claude"]
+
+  # Basic retry configuration
+  max_retries: 2
+
+# Provider configurations
+providers:
+  # Cursor provider (package-based)
+  cursor:
+    type: "package"
+    priority: 1
+    models: ["cursor-default"]
+    features:
+      file_upload: true
+      code_generation: true
+      analysis: true
+
+  # Claude provider (API-based)
+  claude:
+    type: "api"
+    priority: 2
+    max_tokens: 100000
+    models: ["claude-3-5-sonnet-20241022"]
+    auth:
+      api_key_env: "ANTHROPIC_API_KEY"
+    endpoints:
+      default: "https://api.anthropic.com/v1/messages"
+    features:
+      file_upload: true
+      code_generation: true
+      analysis: true
+      vision: true
+
+# Configuration tips:
+# - Set your ANTHROPIC_API_KEY environment variable for Claude
+# - Adjust max_tokens based on your API plan limits
+# - Add more providers as needed
+# - Configure fallback_providers for automatic failover