proagents 1.6.19 → 1.6.21

package/.proagents/learning/reports.md

@@ -1,306 +0,0 @@
-# Learning Reports
-
-Progress reports showing how ProAgents has improved over time.
-
----
-
-## Report Types
-
-### 1. Weekly Learning Report
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ ProAgents Learning Report - Week of Jan 15, 2024                │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ SUMMARY                                                         │
-│ ───────                                                         │
-│ Features Completed: 5                                           │
-│ Total Development Time: 18 hours                                │
-│ Time Saved by Learning: ~2.5 hours (estimated)                 │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ NEW PATTERNS LEARNED                                            │
-│ ────────────────────                                            │
-│ • Component structure pattern (confidence: 95%)                │
-│ • API error handling pattern (confidence: 88%)                 │
-│ • Test file organization (confidence: 92%)                     │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ AUTO-CORRECTIONS APPLIED                                        │
-│ ────────────────────────                                        │
-│ • "Use Zustand" applied 8 times                                │
-│ • "Functional components" applied 12 times                     │
-│ • "Colocate tests" applied 6 times                             │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ CHECKPOINT OPTIMIZATIONS                                        │
-│ ────────────────────────                                        │
-│ • Skipped 15 unnecessary checkpoints                           │
-│ • Estimated time saved: 45 minutes                             │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ DECISION ACCURACY                                               │
-│ ─────────────────                                               │
-│ Auto-decisions made: 45                                         │
-│ ├── Accepted without change: 42 (93%)                          │
-│ ├── Minor adjustments: 2 (4%)                                  │
-│ └── Required correction: 1 (3%)                                │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-### 2. Monthly Progress Report
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ ProAgents Monthly Progress - January 2024                       │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ PRODUCTIVITY METRICS                                            │
-│ ────────────────────                                            │
-│                                                                 │
-│ Features Completed     ████████████████████ 20                 │
-│ Bugs Fixed             ████████████ 12                          │
-│ Quick Changes          ██████████████████████████ 35           │
-│                                                                 │
-│ Average Feature Time: 3.2 hours (↓ 25% from first month)       │
-│ Average Bug Fix Time: 35 minutes (↓ 30% from first month)      │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ LEARNING GROWTH                                                 │
-│ ───────────────                                                 │
-│                                                                 │
-│ Patterns Learned:                                               │
-│ Week 1  ████████ 8                                              │
-│ Week 2  ████████████ 12                                         │
-│ Week 3  ██████████ 10                                           │
-│ Week 4  ██████ 6 (stabilizing)                                  │
-│                                                                 │
-│ Total Active Patterns: 36                                       │
-│ Pattern Confidence: 89% average                                │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ TIME SAVINGS                                                    │
-│ ────────────                                                    │
-│                                                                 │
-│ Auto-corrections saved:     ~4 hours                           │
-│ Checkpoint skips saved:     ~3 hours                           │
-│ Pattern following saved:    ~5 hours                           │
-│ Decision automation saved:  ~2 hours                           │
-│ ─────────────────────────────────────                          │
-│ Total Estimated Savings:    ~14 hours                          │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ CORRECTION TRENDS                                               │
-│ ─────────────────                                               │
-│                                                                 │
-│ Corrections Needed:                                             │
-│ Week 1  ████████████████ 16                                     │
-│ Week 2  ████████████ 12                                         │
-│ Week 3  ████████ 8                                              │
-│ Week 4  ████ 4                                                  │
-│                                                                 │
-│ Trend: ↓ 75% reduction in corrections needed                   │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-### 3. Pattern Confidence Report
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ Pattern Confidence Report                                       │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ HIGH CONFIDENCE (90%+) - Auto-applied                          │
-│ ─────────────────────────────────────                          │
-│ • Component style: functional          ████████████████ 98%    │
-│ • State management: zustand            ████████████████ 96%    │
-│ • File structure: feature-based        ███████████████ 95%     │
-│ • Styling: tailwind                    ███████████████ 94%     │
-│ • Testing: vitest + testing-library    ███████████████ 93%     │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ MEDIUM CONFIDENCE (70-89%) - Suggested                         │
-│ ──────────────────────────────────────                         │
-│ • Error handling: error boundaries     ██████████████ 85%      │
-│ • API calls: react-query hooks         █████████████ 82%       │
-│ • Form handling: react-hook-form       ████████████ 78%        │
-│ • Animation: framer-motion             ███████████ 72%         │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ LEARNING (Below 70%) - Still gathering data                    │
-│ ───────────────────────────────────────────                    │
-│ • Caching strategy                     ████████ 55%            │
-│ • WebSocket patterns                   ██████ 45%              │
-│ • Pagination approach                  █████ 40%               │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-### 4. Decision Accuracy Report
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ Decision Accuracy Report - Last 30 Days                         │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ OVERALL ACCURACY: 94%                                           │
-│                                                                 │
-│ BY CATEGORY                                                     │
-│ ───────────                                                     │
-│                                                                 │
-│ Architecture Decisions                                          │
-│ ├── Total: 25                                                  │
-│ ├── Correct: 24 (96%)                                          │
-│ └── Corrected: 1 (4%)                                          │
-│                                                                 │
-│ Code Style Decisions                                            │
-│ ├── Total: 120                                                 │
-│ ├── Correct: 115 (96%)                                         │
-│ └── Corrected: 5 (4%)                                          │
-│                                                                 │
-│ File Location Decisions                                         │
-│ ├── Total: 45                                                  │
-│ ├── Correct: 42 (93%)                                          │
-│ └── Corrected: 3 (7%)                                          │
-│                                                                 │
-│ Implementation Approach                                         │
-│ ├── Total: 30                                                  │
-│ ├── Correct: 27 (90%)                                          │
-│ └── Corrected: 3 (10%)                                         │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ IMPROVEMENT TREND                                               │
-│ ─────────────────                                               │
-│                                                                 │
-│ Month 1: 78% accuracy                                          │
-│ Month 2: 87% accuracy (+9%)                                    │
-│ Month 3: 94% accuracy (+7%)                                    │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Report Generation
-
-### Automatic Reports
-
-```yaml
-reports:
-  automatic:
-    weekly:
-      enabled: true
-      day: "monday"
-      notify: true
-
-    monthly:
-      enabled: true
-      day: 1
-      notify: true
-
-  location: ".proagents/reports/"
-  format: "markdown"  # markdown | html | json
-```
-
-### On-Demand Reports
-
-```bash
-# Generate reports via commands
-pa:report-learning weekly
-pa:report-learning monthly
-pa:report-learning patterns
-pa:report-learning decisions
-pa:report-learning all
-```
-
----
-
-## Report Export
-
-```yaml
-export:
-  formats:
-    - markdown
-    - html
-    - pdf
-    - json
-
-  destinations:
-    - local: ".proagents/reports/"
-    - notion: false  # If Notion integration enabled
-    - slack: false   # If Slack integration enabled
-```
-
----
-
-## Insights & Recommendations
-
-Reports include actionable insights:
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ INSIGHTS & RECOMMENDATIONS                                      │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ 💡 INSIGHTS                                                     │
-│                                                                 │
-│ 1. Your component patterns are highly consistent (98%)         │
-│    → ProAgents can now auto-generate components with           │
-│      high confidence                                           │
-│                                                                 │
-│ 2. Test file organization varies between features              │
-│    → Consider standardizing to improve pattern learning        │
-│                                                                 │
-│ 3. API error handling has 3 different patterns                 │
-│    → Consolidating would improve auto-decisions                │
-│                                                                 │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│ 📋 RECOMMENDATIONS                                              │
-│                                                                 │
-│ 1. Consider disabling "after_testing" checkpoint               │
-│    → You've skipped it 95% of the time                        │
-│    → Run: pa:config set checkpoints.after_testing false       │
-│                                                                 │
-│ 2. Document your preferred caching strategy                    │
-│    → Only 45% confidence, frequently corrected                │
-│    → Add to: .proagents/standards/architecture-rules.md        │
-│                                                                 │
-│ 3. Your features are getting faster to complete!               │
-│    → Average time down 25% from first month                   │
-│    → Keep using consistent patterns                           │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `pa:report-learning` | Show learning summary |
-| `pa:report-learning weekly` | Generate weekly report |
-| `pa:report-learning monthly` | Generate monthly report |
-| `pa:report-patterns` | Pattern confidence report |
-| `pa:report-decisions` | Decision accuracy report |
-| `pa:report-export [format]` | Export reports |

package/.proagents/mcp/README.md

@@ -1,133 +0,0 @@
-# MCP (Model Context Protocol) Integration
-
-Integrate ProAgents with AI tools that support the Model Context Protocol.
-
----
-
-## Overview
-
-MCP (Model Context Protocol) enables AI assistants like Claude to interact with external tools and data sources. ProAgents provides MCP servers that expose workflow capabilities directly to AI assistants.
-
----
-
-## Quick Start
-
-### 1. Install the MCP Server
-
-```bash
-npm install -g @proagents/mcp-server
-```
-
-### 2. Configure Claude Desktop
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "proagents": {
-      "command": "npx",
-      "args": ["-y", "@proagents/mcp-server"],
-      "env": {
-        "PROAGENTS_PROJECT_PATH": "/path/to/your/project"
-      }
-    }
-  }
-}
-```
-
-### 3. Restart Claude Desktop
-
-The ProAgents tools will now be available in Claude.
-
----
-
-## Available MCP Tools
-
-| Tool | Description |
-|------|-------------|
-| `proagents_init` | Initialize ProAgents in a project |
-| `proagents_analyze` | Analyze codebase structure and patterns |
-| `proagents_feature_start` | Start a new feature workflow |
-| `proagents_feature_status` | Check current feature status |
-| `proagents_fix` | Start bug fix workflow |
-| `proagents_test` | Run tests |
-| `proagents_doc` | Generate documentation |
-| `proagents_deploy` | Start deployment workflow |
-| `proagents_rollback` | Execute rollback procedures |
-
----
-
-## MCP Resources
-
-ProAgents exposes these resources via MCP:
-
-| Resource | URI | Description |
-|----------|-----|-------------|
-| Project Config | `proagents://config` | Current configuration |
-| Feature Status | `proagents://features` | Active features |
-| Codebase Analysis | `proagents://analysis` | Cached analysis |
-| Changelog | `proagents://changelog` | Recent changes |
-| Todo List | `proagents://todos` | Current tasks |
-
----
-
-## Configuration
-
-```yaml
-# proagents.config.yaml
-mcp:
-  enabled: true
-
-  # Server settings
-  server:
-    port: 3100
-    host: "localhost"
-
-  # Exposed tools
-  tools:
-    - init
-    - analyze
-    - feature
-    - fix
-    - test
-    - doc
-    - deploy
-    - rollback
-
-  # Exposed resources
-  resources:
-    - config
-    - features
-    - analysis
-    - changelog
-    - todos
-
-  # Security
-  security:
-    require_confirmation: true
-    allowed_operations:
-      - read
-      - analyze
-      - generate
-    restricted_operations:
-      - deploy
-      - delete
-```
-
----
-
-## Documentation
-
-- [Server Configuration](./server-config.md)
-- [Tools Definition](./tools-definition.md)
-- [Context Providers](./context-providers.md)
-
----
-
-## Security Considerations
-
-1. **Project Scope**: MCP server only accesses configured project paths
-2. **Confirmation**: Destructive operations require confirmation
-3. **Audit Logging**: All MCP operations are logged
-4. **Rate Limiting**: Configurable rate limits for operations