proagents 1.0.0

package/proagents/dependency-management/update-policies.md

@@ -0,0 +1,374 @@
+# Update Policies
+
+Configure how different types of updates are handled.
+
+---
+
+## Update Types
+
+### Semantic Versioning
+
+```
+Major.Minor.Patch
+  │     │     │
+  │     │     └── Bug fixes (safe, auto-merge)
+  │     └──────── New features (review recommended)
+  └────────────── Breaking changes (manual review required)
+```
+
+### Policy by Update Type
+
+```yaml
+dependencies:
+  policies:
+    # Patch updates (x.x.PATCH)
+    patch:
+      description: "Bug fixes and security patches"
+      auto_merge: true
+      require_tests: true
+      require_review: false
+      max_batch: 10  # Max patches per update
+
+    # Minor updates (x.MINOR.x)
+    minor:
+      description: "New features, backwards compatible"
+      auto_merge: false
+      require_tests: true
+      require_review: true
+      create_pr: true
+      reviewers: ["@team/dependencies"]
+
+    # Major updates (MAJOR.x.x)
+    major:
+      description: "Breaking changes"
+      auto_merge: false
+      require_tests: true
+      require_review: true
+      require_manual_testing: true
+      create_pr: true
+      reviewers: ["@team/tech-leads"]
+      changelog_review: true
+```
+
+---
+
+## Package-Specific Policies
+
+### Override for Specific Packages
+
+```yaml
+dependencies:
+  package_policies:
+    # TypeScript - allow minor updates
+    typescript:
+      minor:
+        auto_merge: true  # Override default
+
+    # React - group with react-dom
+    react:
+      group_with: ["react-dom", "@types/react"]
+      major:
+        require_migration_guide: true
+
+    # Database drivers - extra caution
+    pg:
+      minor:
+        require_review: true
+        require_staging_test: true
+      major:
+        require_dba_review: true
+
+    # Internal packages - always update
+    "@company/*":
+      patch:
+        auto_merge: true
+      minor:
+        auto_merge: true
+```
+
+### Lock Specific Versions
+
+```yaml
+dependencies:
+  locked:
+    # Never update these
+    - package: "legacy-api-client"
+      version: "2.3.4"
+      reason: "Breaking changes in 3.x incompatible with our API"
+      until: "2024-06-01"  # Optional expiry
+
+    - package: "node-sass"
+      version: "7.0.0"
+      reason: "Migrating to dart-sass, no point updating"
+```
+
+---
+
+## Update Scheduling
+
+### Schedule Configuration
+
+```yaml
+dependencies:
+  schedule:
+    # When to check for updates
+    check: "0 6 * * 1"  # Every Monday at 6am
+
+    # When to apply auto-merged updates
+    apply: "0 2 * * 2"  # Every Tuesday at 2am
+
+    # Security updates
+    security:
+      check: "0 */6 * * *"  # Every 6 hours
+      apply: "immediate"    # Apply immediately if auto-merge
+```
+
+### Time Windows
+
+```yaml
+dependencies:
+  schedule:
+    # Only update during these windows
+    allowed_windows:
+      - days: ["monday", "tuesday", "wednesday"]
+        hours: "02:00-06:00"
+
+    # Never update during
+    blackout_windows:
+      - name: "Release freeze"
+        start: "2024-03-01"
+        end: "2024-03-15"
+
+      - name: "Holiday"
+        recurring: "december 20-january 5"
+```
+
+---
+
+## Update Grouping
+
+### Group Related Packages
+
+```yaml
+dependencies:
+  groups:
+    # React ecosystem
+    - name: "react-ecosystem"
+      packages:
+        - "react"
+        - "react-dom"
+        - "@types/react"
+        - "@types/react-dom"
+      update_together: true
+      strategy: "latest_compatible"
+
+    # Testing libraries
+    - name: "testing"
+      packages:
+        - "jest"
+        - "@types/jest"
+        - "ts-jest"
+      update_together: true
+
+    # ESLint plugins
+    - name: "eslint"
+      pattern: "eslint-*"
+      update_together: true
+      max_batch: 5
+
+    # All TypeScript types
+    - name: "types"
+      pattern: "@types/*"
+      update_together: false
+      auto_merge: true
+```
+
+---
+
+## Approval Workflows
+
+### Review Requirements
+
+```yaml
+dependencies:
+  approvals:
+    # Default reviewers
+    default_reviewers:
+      - "@team/developers"
+
+    # By update type
+    by_type:
+      major:
+        required_approvals: 2
+        reviewers:
+          - "@team/tech-leads"
+          - "@team/security"
+
+      minor:
+        required_approvals: 1
+        reviewers:
+          - "@team/developers"
+
+    # By package category
+    by_category:
+      security:
+        required_approvals: 2
+        reviewers:
+          - "@team/security"
+
+      database:
+        reviewers:
+          - "@team/dba"
+```
+
+### Approval Escalation
+
+```yaml
+dependencies:
+  approvals:
+    escalation:
+      # If not approved within time
+      timeout: "48h"
+      action: "escalate"
+      escalate_to: "@team/tech-leads"
+
+      # Reminder schedule
+      reminders:
+        - after: "24h"
+          message: "Dependency update PR needs review"
+        - after: "36h"
+          message: "Urgent: Dependency update blocking"
+```
+
+---
+
+## Testing Requirements
+
+### Test Configuration
+
+```yaml
+dependencies:
+  testing:
+    # Always run these
+    always_run:
+      - "npm test"
+      - "npm run lint"
+      - "npm run type-check"
+
+    # For minor/major updates
+    extended:
+      - "npm run test:integration"
+      - "npm run test:e2e"
+
+    # For specific packages
+    package_specific:
+      react:
+        - "npm run test:components"
+      prisma:
+        - "npm run test:db"
+        - "npm run migrate:check"
+
+    # Require passing
+    require_passing:
+      patch: ["unit"]
+      minor: ["unit", "integration"]
+      major: ["unit", "integration", "e2e"]
+```
+
+### Staging Deployment
+
+```yaml
+dependencies:
+  testing:
+    staging:
+      # Deploy to staging for major updates
+      required_for: ["major"]
+
+      # Staging environment
+      environment: "staging"
+
+      # Smoke test after deploy
+      smoke_test: "npm run test:smoke"
+
+      # Manual approval after staging
+      require_approval: true
+      approval_timeout: "4h"
+```
+
+---
+
+## Notification Configuration
+
+```yaml
+dependencies:
+  notifications:
+    # Update available
+    on_update_available:
+      channels: ["slack:#dependencies"]
+      include:
+        - security_advisories
+        - changelog_summary
+
+    # Auto-merged
+    on_auto_merge:
+      channels: ["slack:#dependencies"]
+      summary: true
+
+    # PR created
+    on_pr_created:
+      channels: ["slack:#pr-reviews"]
+      mention_reviewers: true
+
+    # Failed update
+    on_failure:
+      channels: ["slack:#dev-alerts"]
+      include:
+        - error_details
+        - test_output
+        - rollback_instructions
+```
+
+---
+
+## Update Reports
+
+### Weekly Summary
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Dependency Update Report - Week 3, January 2024            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Updates Processed: 23                                       │
+│ ├── Auto-merged: 18 (patches)                              │
+│ ├── PRs Created: 4 (minor)                                 │
+│ └── Blocked: 1 (breaking change)                           │
+│                                                             │
+│ Security Updates: 2                                         │
+│ ├── lodash: Fixed prototype pollution (auto-merged)        │
+│ └── axios: Fixed SSRF vulnerability (auto-merged)          │
+│                                                             │
+│ Pending Review:                                             │
+│ • react 18.2.0 → 18.3.0 (PR #234)                         │
+│ • typescript 5.2.0 → 5.3.0 (PR #235)                      │
+│                                                             │
+│ Failed Updates:                                             │
+│ • jest 29.0.0 → 30.0.0 (breaking: test runner API)        │
+│   Action needed: Review migration guide                     │
+│                                                             │
+│ Next Scheduled: Monday, Jan 22 at 6:00 AM                  │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Best Practices
+
+1. **Start Conservative**: Begin with manual reviews, enable auto-merge gradually
+2. **Group Related Packages**: Update ecosystems together
+3. **Test Thoroughly**: Higher update type = more tests
+4. **Review Changelogs**: Especially for minor/major updates
+5. **Schedule Wisely**: Update during low-traffic periods
+6. **Monitor After Updates**: Watch for issues post-update
+7. **Document Locks**: Explain why packages are locked

package/proagents/disaster-recovery/README.md

@@ -0,0 +1,247 @@
+# Disaster Recovery
+
+Comprehensive disaster recovery procedures and automation for development workflows.
+
+---
+
+## Overview
+
+ProAgents provides disaster recovery features to ensure business continuity and rapid recovery from failures.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Disaster Recovery                         │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  Prevention ─────────────────────────────────────────────  │
+│  ├── Automated backups                                     │
+│  ├── Redundant storage                                     │
+│  └── Health monitoring                                     │
+│                                                             │
+│  Detection ──────────────────────────────────────────────  │
+│  ├── Automated alerts                                      │
+│  ├── Error rate monitoring                                 │
+│  └── Performance degradation                               │
+│                                                             │
+│  Response ───────────────────────────────────────────────  │
+│  ├── Automated rollback                                    │
+│  ├── Manual rollback procedures                            │
+│  └── Incident management                                   │
+│                                                             │
+│  Recovery ───────────────────────────────────────────────  │
+│  ├── System restoration                                    │
+│  ├── Data recovery                                         │
+│  └── Post-incident analysis                                │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Quick Start
+
+### Enable Disaster Recovery
+
+```yaml
+# proagents.config.yaml
+
+disaster_recovery:
+  enabled: true
+  auto_rollback: true
+  backup:
+    enabled: true
+    frequency: "daily"
+```
+
+### Key Commands
+
+```bash
+# Check DR status
+proagents dr status
+
+# Create backup
+proagents dr backup create
+
+# Rollback deployment
+proagents rollback production
+
+# Start DR procedure
+proagents dr activate
+```
+
+---
+
+## Recovery Time Objectives
+
+| Component | RTO | RPO |
+|-----------|-----|-----|
+| Frontend | < 5 min | < 1 hour |
+| Backend API | < 10 min | < 1 hour |
+| Database | < 30 min | < 15 min |
+| Full System | < 1 hour | < 1 hour |
+
+**RTO**: Recovery Time Objective (max downtime)
+**RPO**: Recovery Point Objective (max data loss)
+
+---
+
+## Documentation Files
+
+| File | Description |
+|------|-------------|
+| [rollback-procedures.md](./rollback-procedures.md) | Deployment rollback procedures |
+| [backup-recovery.md](./backup-recovery.md) | Backup and data recovery |
+| [incident-response.md](./incident-response.md) | Incident response runbook |
+| [automation.md](./automation.md) | Automated DR features |
+| [testing.md](./testing.md) | DR testing procedures |
+
+---
+
+## Recovery Scenarios
+
+### Scenario 1: Failed Deployment
+
+```
+Trigger: Deployment causes errors
+Detection: Error rate spike
+Response: Automatic rollback
+Recovery: Previous version restored
+Time: < 5 minutes
+```
+
+### Scenario 2: Data Corruption
+
+```
+Trigger: Data integrity failure
+Detection: Validation checks
+Response: Alert + manual assessment
+Recovery: Point-in-time restore
+Time: < 30 minutes
+```
+
+### Scenario 3: Security Breach
+
+```
+Trigger: Security incident detected
+Detection: Security monitoring
+Response: System isolation
+Recovery: Clean restore + patch
+Time: Varies based on severity
+```
+
+### Scenario 4: Infrastructure Failure
+
+```
+Trigger: Cloud provider outage
+Detection: Health checks fail
+Response: Failover to backup region
+Recovery: Traffic redirection
+Time: < 15 minutes
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+
+disaster_recovery:
+  enabled: true
+
+  # Automated responses
+  auto_rollback:
+    enabled: true
+    triggers:
+      error_rate_threshold: 5     # % increase
+      response_time_threshold: 3   # x baseline
+      health_check_failures: 3
+
+  # Backup configuration
+  backup:
+    enabled: true
+    frequency: "hourly"
+    retention_days: 30
+    encryption: true
+    destinations:
+      - type: "s3"
+        bucket: "company-backups"
+        region: "us-east-1"
+      - type: "gcs"
+        bucket: "company-backups-dr"
+        region: "us-west1"
+
+  # Monitoring
+  monitoring:
+    health_check_interval: 30  # seconds
+    alerting:
+      - channel: "pagerduty"
+        severity: ["critical"]
+      - channel: "slack"
+        severity: ["warning", "critical"]
+
+  # Recovery targets
+  targets:
+    frontend:
+      rto_minutes: 5
+      rpo_minutes: 60
+    backend:
+      rto_minutes: 10
+      rpo_minutes: 60
+    database:
+      rto_minutes: 30
+      rpo_minutes: 15
+
+  # Testing
+  testing:
+    schedule: "quarterly"
+    notification_hours: 24
+```
+
+---
+
+## DR Dashboard
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Disaster Recovery Status                                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Overall Status: ✅ Healthy                                  │
+│                                                             │
+│ Components:                                                 │
+│ ├── Frontend: ✅ Healthy (v2.1.0)                          │
+│ ├── Backend: ✅ Healthy (v3.4.2)                           │
+│ ├── Database: ✅ Healthy (replica synced)                  │
+│ └── Cache: ✅ Healthy                                      │
+│                                                             │
+│ Last Backup: 2024-01-15 09:00 UTC (1 hour ago)            │
+│ Backup Status: ✅ All backups verified                     │
+│                                                             │
+│ Recent Incidents: None in last 30 days                     │
+│                                                             │
+│ DR Test: Last run Dec 15, 2023 (45 days ago)              │
+│          Next scheduled: Mar 15, 2024                      │
+│                                                             │
+│ Recovery Readiness:                                         │
+│ ├── Runbooks: ✅ Up to date                                │
+│ ├── Contacts: ✅ Verified                                  │
+│ └── Automation: ✅ Tested                                  │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `proagents dr status` | Show DR status |
+| `proagents dr backup create` | Create manual backup |
+| `proagents dr backup list` | List backups |
+| `proagents dr backup restore` | Restore from backup |
+| `proagents rollback` | Rollback deployment |
+| `proagents dr test` | Run DR test |
+| `proagents dr activate` | Activate DR mode |
+| `proagents dr runbook` | Show runbook |