proagents 1.0.0

package/proagents/cost/cost-template.md

@@ -0,0 +1,283 @@
+# Cost Estimation Template
+
+Standardized template for estimating feature and infrastructure costs.
+
+---
+
+## Feature Cost Estimation
+
+```markdown
+# Cost Estimate: [Feature Name]
+
+## Summary
+
+| Category | Monthly Cost | Annual Cost |
+|----------|-------------|-------------|
+| Compute | $XXX | $X,XXX |
+| Storage | $XXX | $X,XXX |
+| Network | $XXX | $X,XXX |
+| Third-party | $XXX | $X,XXX |
+| **Total** | **$XXX** | **$X,XXX** |
+
+## Assumptions
+
+- Expected users: [X,XXX]
+- Requests per user/day: [XX]
+- Average request size: [X KB]
+- Data retention: [X months]
+- Growth rate: [X% monthly]
+
+---
+
+## Detailed Breakdown
+
+### Compute Costs
+
+| Resource | Quantity | Unit Cost | Monthly Total |
+|----------|----------|-----------|---------------|
+| Lambda invocations | X,XXX,XXX | $0.20/1M | $XX |
+| Lambda compute (GB-s) | XXX,XXX | $0.0000166667 | $XX |
+| EC2 instances | X | $XX/month | $XX |
+| ECS Fargate | X vCPU, X GB | $XX/month | $XX |
+| **Compute Total** | | | **$XXX** |
+
+### Storage Costs
+
+| Resource | Quantity | Unit Cost | Monthly Total |
+|----------|----------|-----------|---------------|
+| RDS PostgreSQL | X GB | $0.115/GB | $XX |
+| RDS IOPS | X,XXX | $0.10/IOPS | $XX |
+| S3 Standard | X GB | $0.023/GB | $XX |
+| S3 Requests | X,XXX | $0.005/1000 | $XX |
+| ElastiCache | X GB | $XX/GB | $XX |
+| **Storage Total** | | | **$XXX** |
+
+### Network Costs
+
+| Resource | Quantity | Unit Cost | Monthly Total |
+|----------|----------|-----------|---------------|
+| Data transfer out | X GB | $0.09/GB | $XX |
+| CloudFront | X TB | $0.085/GB | $XX |
+| NAT Gateway | X GB | $0.045/GB | $XX |
+| API Gateway | X M requests | $3.50/M | $XX |
+| **Network Total** | | | **$XXX** |
+
+### Third-Party Services
+
+| Service | Tier/Plan | Monthly Cost |
+|---------|-----------|--------------|
+| Auth0 | Professional | $XX |
+| SendGrid | Pro 100K | $XX |
+| Twilio | Pay-as-you-go | $XX |
+| Sentry | Team | $XX |
+| **Third-Party Total** | | **$XXX** |
+
+---
+
+## Cost by Scale
+
+### Current (1,000 users)
+
+| Category | Cost |
+|----------|------|
+| Compute | $50 |
+| Storage | $30 |
+| Network | $20 |
+| Third-party | $100 |
+| **Total** | **$200** |
+
+### Growth (10,000 users)
+
+| Category | Cost |
+|----------|------|
+| Compute | $200 |
+| Storage | $150 |
+| Network | $100 |
+| Third-party | $300 |
+| **Total** | **$750** |
+
+### Scale (100,000 users)
+
+| Category | Cost |
+|----------|------|
+| Compute | $1,500 |
+| Storage | $800 |
+| Network | $600 |
+| Third-party | $1,000 |
+| **Total** | **$3,900** |
+
+---
+
+## Cost Optimization Opportunities
+
+### Immediate Savings
+
+| Optimization | Current Cost | Optimized Cost | Savings |
+|--------------|-------------|----------------|---------|
+| Reserved instances | $500/mo | $300/mo | $200/mo |
+| S3 lifecycle policies | $100/mo | $60/mo | $40/mo |
+| CloudFront caching | $200/mo | $150/mo | $50/mo |
+| **Total Savings** | | | **$290/mo** |
+
+### Recommendations
+
+1. **Use Reserved Instances**
+   - Current: On-demand EC2
+   - Recommendation: 1-year reserved
+   - Savings: 40%
+
+2. **Implement Caching**
+   - Add Redis for API responses
+   - Reduce database queries by 60%
+   - Cost: $50/mo, Saves: $150/mo
+
+3. **Optimize Storage**
+   - Move old data to S3 Glacier
+   - Implement S3 lifecycle policies
+   - Savings: 30%
+
+---
+
+## ROI Analysis
+
+### Investment
+
+| Item | Cost |
+|------|------|
+| Development | $XX,XXX |
+| Infrastructure (Year 1) | $X,XXX |
+| Third-party setup | $XXX |
+| **Total Investment** | **$XX,XXX** |
+
+### Expected Returns
+
+| Metric | Value |
+|--------|-------|
+| New revenue/month | $XX,XXX |
+| Cost savings/month | $X,XXX |
+| Payback period | X months |
+| First year ROI | XXX% |
+
+---
+
+## Risk Factors
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Higher traffic than expected | +50% costs | Auto-scaling with budget alerts |
+| Third-party price increase | +20% costs | Multi-vendor strategy |
+| Data growth exceeds estimate | +30% storage | Early archival policies |
+
+---
+
+## Approval
+
+| Level | Monthly Increase | Required Approval |
+|-------|-----------------|-------------------|
+| < $100 | Auto-approved | - |
+| $100 - $500 | Team Lead | [Name] |
+| $500 - $2,000 | Manager | [Name] |
+| > $2,000 | Director | [Name] |
+
+**Estimated Monthly Cost:** $XXX
+**Approval Required:** [Level]
+**Approved By:** _____________
+**Date:** _____________
+```
+
+---
+
+## Quick Estimate Calculator
+
+```yaml
+# quick-estimate.yaml
+# Fill in your estimates for quick cost calculation
+
+feature_name: "User Dashboard"
+
+# Traffic Estimates
+traffic:
+  daily_active_users: 1000
+  requests_per_user: 20
+  average_request_size_kb: 5
+  peak_multiplier: 3  # Peak vs average
+
+# Compute
+compute:
+  type: "serverless"  # serverless | container | vm
+  estimated_duration_ms: 100
+  memory_mb: 256
+
+# Storage
+storage:
+  database_gb: 10
+  file_storage_gb: 50
+  cache_gb: 1
+
+# Third-party
+third_party:
+  - name: "Auth Provider"
+    monthly_cost: 50
+  - name: "Email Service"
+    monthly_cost: 25
+
+# Calculated Results (auto-generated)
+results:
+  monthly_requests: 600000  # users * requests * 30
+  lambda_cost: 12           # $0.20/M * 0.6M
+  lambda_compute: 25        # GB-s * cost
+  storage_cost: 15          # RDS + S3
+  network_cost: 5           # Data transfer
+  third_party_cost: 75
+  total_monthly: 132
+  total_annual: 1584
+```
+
+---
+
+## Cost Tracking Dashboard
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Cost Dashboard - January 2024             │
+├──────────────────┬──────────────────┬───────────────────────┤
+│   Budget: $500   │   Actual: $423   │   Remaining: $77      │
+│                  │   (85%)          │   15% under budget    │
+├──────────────────┴──────────────────┴───────────────────────┤
+│                                                             │
+│  Cost Trend (Last 6 Months)                                │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │     ╭─╮                                              │   │
+│  │    ╭╯ ╰╮  ╭──╮     ╭─╮                              │   │
+│  │ ──╯    ╰──╯  ╰─────╯ ╰─────────────────────         │   │
+│  │ Aug  Sep  Oct  Nov  Dec  Jan                        │   │
+│  │ $380 $420 $450 $480 $445 $423                       │   │
+│  └─────────────────────────────────────────────────────┘   │
+│                                                             │
+│  By Category                      │  Top Costs             │
+│  ┌───────────────────────┐       │  ┌──────────────────┐   │
+│  │ Compute    ████  42%  │       │  │ RDS      $150    │   │
+│  │ Storage    ███   30%  │       │  │ Lambda   $100    │   │
+│  │ Network    ██    15%  │       │  │ Auth0    $50     │   │
+│  │ Third-party█     13%  │       │  │ S3       $45     │   │
+│  └───────────────────────┘       │  └──────────────────┘   │
+│                                                             │
+│  Alerts                                                     │
+│  ⚠️  Lambda usage up 25% - consider optimization           │
+│  ✅  Storage costs stable                                  │
+│  ℹ️  New feature estimated +$75/month                      │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/cost-estimate` | Start cost estimation wizard |
+| `/cost-estimate --template` | Get blank template |
+| `/cost-estimate --quick` | Quick estimate calculator |
+| `/cost-report` | Generate cost report |
+| `/cost-compare` | Compare actual vs estimated |

package/proagents/cost/estimation-framework.md

@@ -0,0 +1,287 @@
+# Cost Estimation Framework
+
+Estimate infrastructure and operational costs for new features.
+
+---
+
+## Cost Categories
+
+### 1. Compute Costs
+
+**Serverless Functions:**
+```yaml
+compute:
+  serverless:
+    provider: "aws_lambda"  # aws_lambda | vercel | cloudflare_workers
+
+    estimate:
+      invocations_per_month: 1000000
+      avg_duration_ms: 200
+      memory_mb: 256
+
+    calculation:
+      # AWS Lambda pricing (example)
+      request_cost: "$0.20 per 1M requests"
+      duration_cost: "$0.0000166667 per GB-second"
+
+      monthly_estimate:
+        requests: "$0.20"
+        duration: "$0.83"  # 1M × 0.2s × 0.25GB × $0.0000166667
+        total: "$1.03"
+```
+
+**Container/Server:**
+```yaml
+compute:
+  containers:
+    provider: "aws_ecs"  # aws_ecs | gcp_cloud_run | azure_container
+
+    estimate:
+      instances: 2
+      vcpu: 0.5
+      memory_gb: 1
+      hours_per_month: 730
+
+    monthly_estimate: "$30"
+```
+
+---
+
+### 2. Storage Costs
+
+**Database:**
+```yaml
+storage:
+  database:
+    provider: "aws_rds"  # aws_rds | planetscale | supabase
+
+    estimate:
+      storage_gb: 20
+      iops: 1000
+      backup_retention_days: 7
+
+    monthly_estimate:
+      storage: "$2.30"
+      iops: "$10.00"
+      backup: "$1.00"
+      total: "$13.30"
+```
+
+**File Storage:**
+```yaml
+storage:
+  files:
+    provider: "aws_s3"  # aws_s3 | cloudflare_r2 | gcp_storage
+
+    estimate:
+      storage_gb: 100
+      requests_per_month: 100000
+      bandwidth_gb: 50
+
+    monthly_estimate:
+      storage: "$2.30"
+      requests: "$0.04"
+      bandwidth: "$4.50"
+      total: "$6.84"
+```
+
+---
+
+### 3. Network Costs
+
+```yaml
+network:
+  cdn:
+    provider: "cloudflare"  # cloudflare | aws_cloudfront | vercel
+
+    estimate:
+      bandwidth_gb: 100
+      requests_per_month: 10000000
+
+    monthly_estimate:
+      cloudflare_free: "$0"
+      cloudflare_pro: "$20"
+      aws_cloudfront: "$8.50"
+
+  api_gateway:
+    provider: "aws_api_gateway"
+
+    estimate:
+      requests_per_month: 1000000
+
+    monthly_estimate: "$3.50"
+```
+
+---
+
+### 4. Third-Party Services
+
+```yaml
+third_party:
+  auth:
+    provider: "auth0"
+    estimate:
+      monthly_active_users: 1000
+    monthly_estimate: "$0 (free tier)"  # Up to 7000 MAU
+
+  email:
+    provider: "sendgrid"
+    estimate:
+      emails_per_month: 10000
+    monthly_estimate: "$0 (free tier)"  # Up to 100/day
+
+  monitoring:
+    provider: "datadog"
+    estimate:
+      hosts: 2
+      custom_metrics: 100
+    monthly_estimate: "$30"
+
+  search:
+    provider: "algolia"
+    estimate:
+      records: 10000
+      searches_per_month: 100000
+    monthly_estimate: "$0 (free tier)"
+```
+
+---
+
+## Cost Estimation Template
+
+```markdown
+# Feature Cost Estimate
+
+## Feature: [Feature Name]
+## Date: [YYYY-MM-DD]
+## Estimated By: [Name]
+
+---
+
+## Summary
+
+| Category | Monthly Cost | Annual Cost |
+|----------|-------------|-------------|
+| Compute | $XX | $XXX |
+| Storage | $XX | $XXX |
+| Network | $XX | $XXX |
+| Third-party | $XX | $XXX |
+| **Total** | **$XX** | **$XXX** |
+
+---
+
+## Detailed Breakdown
+
+### Compute
+| Resource | Specs | Cost |
+|----------|-------|------|
+| Lambda functions | 1M invocations, 256MB | $1.03 |
+| ECS containers | 2 × 0.5 vCPU | $30.00 |
+| **Subtotal** | | **$31.03** |
+
+### Storage
+| Resource | Specs | Cost |
+|----------|-------|------|
+| RDS PostgreSQL | 20GB, db.t3.micro | $13.30 |
+| S3 bucket | 100GB, standard | $6.84 |
+| **Subtotal** | | **$20.14** |
+
+### Network
+| Resource | Specs | Cost |
+|----------|-------|------|
+| CloudFront | 100GB bandwidth | $8.50 |
+| API Gateway | 1M requests | $3.50 |
+| **Subtotal** | | **$12.00** |
+
+### Third-Party Services
+| Service | Tier | Cost |
+|---------|------|------|
+| Auth0 | Free | $0 |
+| SendGrid | Free | $0 |
+| Datadog | Pro | $30 |
+| **Subtotal** | | **$30.00** |
+
+---
+
+## Assumptions
+- Traffic estimates based on [source]
+- Growth rate: [X]% monthly
+- Peak traffic: [X]× average
+
+## Scaling Projections
+
+| Users | Monthly Cost |
+|-------|-------------|
+| 1,000 | $93 |
+| 10,000 | $250 |
+| 100,000 | $1,200 |
+
+## Cost Optimization Recommendations
+1. Use reserved instances for predictable workloads
+2. Implement caching to reduce database calls
+3. Use CDN for static assets
+```
+
+---
+
+## Approval Thresholds
+
+```yaml
+cost_approval:
+  thresholds:
+    - range: "$0-100"
+      approver: "auto_approved"
+
+    - range: "$100-500"
+      approver: "tech_lead"
+      requires: "cost_estimate_doc"
+
+    - range: "$500-2000"
+      approver: "engineering_manager"
+      requires:
+        - "cost_estimate_doc"
+        - "scaling_projections"
+
+    - range: "$2000+"
+      approver: "director"
+      requires:
+        - "cost_estimate_doc"
+        - "scaling_projections"
+        - "roi_analysis"
+```
+
+---
+
+## Cost Monitoring
+
+```yaml
+monitoring:
+  alerts:
+    - threshold: "80% of budget"
+      action: "notify"
+      recipients: ["team-lead"]
+
+    - threshold: "100% of budget"
+      action: "notify_urgent"
+      recipients: ["team-lead", "manager"]
+
+    - threshold: "120% of budget"
+      action: "auto_scale_down"
+      notify: ["all"]
+
+  reports:
+    daily: true
+    weekly_summary: true
+    monthly_detailed: true
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/cost-estimate` | Generate cost estimate for feature |
+| `/cost-compare` | Compare costs across providers |
+| `/cost-report` | View current costs |
+| `/cost-optimize` | Get optimization suggestions |

package/proagents/database/README.md

@@ -0,0 +1,72 @@
+# Database Management
+
+Schema migrations, safety checks, and rollback procedures.
+
+---
+
+## Overview
+
+Safe database changes with version control, validation, and rollback capabilities.
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Migration Workflow](./migration-workflow.md) | Creating and running migrations |
+| [Safety Checks](./safety-checks.md) | Pre-migration validation |
+| [Rollback Scripts](./rollback-scripts.md) | Reverting database changes |
+| [Examples](./examples/) | Concrete migration examples |
+
+## Examples
+
+Ready-to-use migration templates:
+
+| Example | Description | Risk |
+|---------|-------------|------|
+| [001-create-users](./examples/001-create-users.sql) | Create table with indexes | Low |
+| [002-add-preferences](./examples/002-add-preferences.sql) | Add JSONB column | Low |
+| [003-add-index](./examples/003-add-index.sql) | Add performance index | Medium |
+| [004-rename-column](./examples/004-rename-column.sql) | Rename column safely | Medium |
+| [005-add-foreign-key](./examples/005-add-foreign-key.sql) | Add relationships | Medium |
+| [006-data-migration](./examples/006-data-migration.sql) | Transform data | High |
+| [007-drop-column](./examples/007-drop-column.sql) | Remove column | High |
+
+## Quick Start
+
+```bash
+# Create a new migration
+proagents db migration create "add_user_preferences"
+
+# Run pending migrations
+proagents db migrate
+
+# Rollback last migration
+proagents db rollback
+
+# Check migration status
+proagents db status
+```
+
+## Safety Features
+
+- **Dry Run**: Preview changes before applying
+- **Backup**: Automatic backup before migrations
+- **Validation**: Check for breaking changes
+- **Rollback Scripts**: Every migration has a rollback
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+database:
+  migrations:
+    directory: "./migrations"
+    backup_before: true
+    require_rollback: true
+
+  safety:
+    block_destructive: true
+    require_approval_for:
+      - "drop_table"
+      - "drop_column"
+```