proagents 1.0.0

package/proagents/reporting/quality-metrics.md

@@ -0,0 +1,385 @@
+# Quality Metrics
+
+Track code quality, test coverage, and technical health.
+
+---
+
+## Overview
+
+Quality metrics ensure code health and help prevent technical debt accumulation.
+
+---
+
+## Key Metrics
+
+### Test Coverage
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Test Coverage by Project                                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Project     │ Unit    │ Integration │ E2E    │ Overall    │
+│ ────────────┼─────────┼─────────────┼────────┼─────────── │
+│ frontend    │ 85%     │ 72%         │ 45%    │ 78%        │
+│ backend     │ 92%     │ 78%         │ N/A    │ 88%        │
+│ mobile      │ 75%     │ 60%         │ 30%    │ 65%        │
+│ shared      │ 95%     │ 85%         │ N/A    │ 92%        │
+│                                                             │
+│ Workspace Average: 81%                                     │
+│ Target: 80% ✅                                              │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Code Quality Score
+
+```yaml
+quality_score:
+  overall: 85
+  breakdown:
+    maintainability: 88
+    reliability: 90
+    security: 82
+    performance: 80
+    documentation: 75
+
+  trend: "stable"
+  vs_last_month: "+2"
+```
+
+### Technical Debt
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Technical Debt Overview                                     │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Total Debt Items: 47                                       │
+│                                                             │
+│ By Priority:                                                │
+│ ├── Critical: 2 ████                                       │
+│ ├── High: 8 ████████████████                              │
+│ ├── Medium: 22 ████████████████████████████████████████   │
+│ └── Low: 15 ██████████████████████████████                │
+│                                                             │
+│ By Type:                                                    │
+│ ├── Missing Tests: 18                                      │
+│ ├── Code Smells: 12                                        │
+│ ├── Documentation: 8                                       │
+│ ├── Deprecated Code: 5                                     │
+│ └── Security: 4                                            │
+│                                                             │
+│ Estimated Effort: 45 hours                                 │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Quality Reports
+
+### Generate Report
+
+```bash
+# Full quality report
+proagents report quality
+
+# Coverage focused
+proagents report quality --focus coverage
+
+# Security focused
+proagents report quality --focus security
+
+# By project
+proagents report quality --project frontend
+```
+
+### Report Output
+
+```markdown
+# Quality Report - January 2024
+
+## Summary
+- Overall Quality Score: 85/100 (↑ 2 from last month)
+- Test Coverage: 81% (Target: 80%) ✅
+- Technical Debt Items: 47 (↓ 5 from last month)
+- Security Vulnerabilities: 0 critical, 2 medium
+
+## Coverage Analysis
+
+### By Project
+| Project | Coverage | Target | Status |
+|---------|----------|--------|--------|
+| frontend | 78% | 80% | ⚠️ Below |
+| backend | 88% | 85% | ✅ Above |
+| mobile | 65% | 75% | ❌ Below |
+| shared | 92% | 90% | ✅ Above |
+
+### Coverage Gaps
+1. `frontend/src/components/` - 15 untested components
+2. `mobile/src/screens/` - 8 untested screens
+3. `backend/src/utils/` - 5 untested utilities
+
+## Code Quality
+
+### Issues by Severity
+- Critical: 2 (must fix immediately)
+- High: 8 (fix this sprint)
+- Medium: 22 (fix next sprint)
+- Low: 15 (backlog)
+
+### Top Issues
+1. **Critical**: SQL injection risk in UserService.ts
+2. **Critical**: Missing input validation in PaymentController
+3. **High**: Duplicate code in auth modules
+
+## Recommendations
+1. Increase mobile test coverage (add 10% this sprint)
+2. Fix critical security issues immediately
+3. Dedicate 1 day/week to technical debt
+```
+
+---
+
+## Metric Details
+
+### Test Coverage Metrics
+
+```yaml
+coverage:
+  metrics:
+    line_coverage: 81%
+    branch_coverage: 75%
+    function_coverage: 88%
+
+  by_type:
+    unit: 85%
+    integration: 72%
+    e2e: 45%
+
+  trends:
+    vs_last_week: "+1%"
+    vs_last_month: "+3%"
+    vs_last_quarter: "+8%"
+
+  gaps:
+    - path: "src/components/complex"
+      coverage: 45%
+      importance: "high"
+
+    - path: "src/utils/legacy"
+      coverage: 30%
+      importance: "medium"
+```
+
+### Code Review Metrics
+
+```yaml
+code_review:
+  metrics:
+    review_coverage: 98%  # PRs reviewed
+    review_time: "4.2 hours"  # Average time to review
+    comments_per_pr: 3.5
+    approval_rate: 85%  # First-time approval
+
+  by_reviewer:
+    - name: "Senior Dev 1"
+      reviews: 45
+      avg_time: "3.1 hours"
+      quality_score: 92
+
+    - name: "Senior Dev 2"
+      reviews: 38
+      avg_time: "5.2 hours"
+      quality_score: 88
+```
+
+### Bug Metrics
+
+```yaml
+bugs:
+  escape_rate: 5%  # Bugs found in production vs total
+  mttr: "2.3 hours"  # Mean time to resolve
+
+  by_severity:
+    critical: 0
+    high: 2
+    medium: 8
+    low: 15
+
+  by_source:
+    new_features: 60%
+    regressions: 25%
+    edge_cases: 15%
+
+  trends:
+    vs_last_month: "-20%"  # Improvement
+```
+
+---
+
+## Quality Dashboards
+
+### Code Quality Dashboard
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Code Quality Dashboard                                      │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Quality Score: 85/100                                      │
+│ ████████████████████████████████████████░░░░░░░░░░         │
+│                                                             │
+│ Metrics:                                                    │
+│ ├── Maintainability:  ████████░░ 88/100                   │
+│ ├── Reliability:      █████████░ 90/100                   │
+│ ├── Security:         ████████░░ 82/100                   │
+│ ├── Performance:      ████████░░ 80/100                   │
+│ └── Documentation:    ███████░░░ 75/100                   │
+│                                                             │
+│ Trends (Last 30 Days):                                     │
+│ ├── Quality Score:    ↑ 2 points                          │
+│ ├── Coverage:         ↑ 3%                                │
+│ └── Tech Debt:        ↓ 5 items                           │
+│                                                             │
+│ Alerts:                                                     │
+│ ⚠️ 2 critical issues need attention                        │
+│ ⚠️ Mobile coverage below target                            │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Security Dashboard
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Security Dashboard                                          │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│ Security Score: 92/100                                     │
+│                                                             │
+│ Vulnerabilities:                                            │
+│ ├── Critical: 0                                            │
+│ ├── High: 2 (in progress)                                  │
+│ ├── Medium: 5                                              │
+│ └── Low: 12                                                │
+│                                                             │
+│ Dependency Security:                                        │
+│ ├── Known vulnerabilities: 3                               │
+│ ├── Outdated packages: 15                                  │
+│ └── Last scan: 2 hours ago                                │
+│                                                             │
+│ OWASP Top 10 Compliance:                                   │
+│ ├── A01 Access Control:    ✅ Pass                         │
+│ ├── A02 Cryptography:      ✅ Pass                         │
+│ ├── A03 Injection:         ⚠️ 1 issue                     │
+│ ├── A04 Insecure Design:   ✅ Pass                         │
+│ └── ...                                                    │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Quality Targets
+
+### Configuration
+
+```yaml
+quality:
+  targets:
+    coverage:
+      unit: 85
+      integration: 70
+      e2e: 40
+      overall: 80
+
+    quality_score:
+      minimum: 75
+      target: 85
+      stretch: 95
+
+    code_review:
+      review_time_hours: 8
+      approval_rate: 80
+
+    bugs:
+      escape_rate: 5
+      mttr_hours: 4
+
+  alerts:
+    - metric: coverage
+      condition: "< 75%"
+      action: "block_merge"
+
+    - metric: quality_score
+      condition: "< 70"
+      action: "notify_lead"
+
+    - metric: security_vulnerabilities
+      condition: "critical > 0"
+      action: "alert_security_team"
+```
+
+### Quality Gates
+
+```yaml
+quality_gates:
+  pre_merge:
+    - "coverage >= 80%"
+    - "no_critical_issues"
+    - "no_security_vulnerabilities"
+    - "lint_passed"
+
+  pre_deploy:
+    - "all_tests_passed"
+    - "security_scan_passed"
+    - "performance_benchmark_passed"
+```
+
+---
+
+## Improvement Tracking
+
+### Quality Improvement Plan
+
+```yaml
+improvement_plan:
+  q1_2024:
+    goals:
+      - metric: coverage
+        current: 78
+        target: 85
+        actions:
+          - "Add tests for legacy components"
+          - "Require tests for all new code"
+
+      - metric: tech_debt
+        current: 52
+        target: 30
+        actions:
+          - "Dedicate 20% time to debt"
+          - "Include debt in feature estimates"
+
+    milestones:
+      - date: "2024-01-31"
+        target: "Coverage to 80%"
+
+      - date: "2024-02-28"
+        target: "Tech debt to 40 items"
+
+      - date: "2024-03-31"
+        target: "Quality score to 90"
+```
+
+---
+
+## Best Practices
+
+1. **Set Realistic Targets**: Gradual improvement over perfection
+2. **Automate Measurement**: Don't rely on manual tracking
+3. **Act on Data**: Use metrics to drive decisions
+4. **Balance Coverage**: Focus on critical paths
+5. **Address Debt Regularly**: Prevent accumulation
+6. **Review Trends**: Single measurements are noisy

package/proagents/reporting/templates/README.md

@@ -0,0 +1,56 @@
+# Dashboard Templates
+
+Ready-to-use templates for building ProAgents dashboards.
+
+---
+
+## Available Templates
+
+| Template | Description | Format |
+|----------|-------------|--------|
+| [dashboard-config.json](./dashboard-config.json) | Dashboard configuration schema | JSON |
+| [react-dashboard.tsx](./react-dashboard.tsx) | React dashboard component | TSX |
+| [metrics-queries.md](./metrics-queries.md) | SQL/API queries for metrics | Markdown |
+| [widgets.md](./widgets.md) | Widget configuration guide | Markdown |
+
+---
+
+## Quick Start
+
+### 1. Copy Configuration
+
+```bash
+cp proagents/reporting/templates/dashboard-config.json \
+   your-project/dashboard-config.json
+```
+
+### 2. Customize Metrics
+
+Edit the configuration to include your desired metrics and widgets.
+
+### 3. Use React Component
+
+```tsx
+import { ProAgentsDashboard } from './ProAgentsDashboard';
+import config from './dashboard-config.json';
+
+function App() {
+  return <ProAgentsDashboard config={config} />;
+}
+```
+
+---
+
+## Dashboard Types
+
+### Development Velocity Dashboard
+Track feature completion, bug fixes, and team productivity.
+
+### Code Quality Dashboard
+Monitor test coverage, lint errors, and technical debt.
+
+### Deployment Dashboard
+Track deployments, rollbacks, and environment health.
+
+### Team Activity Dashboard
+Monitor PR reviews, code ownership, and collaboration.

package/proagents/reporting/templates/dashboard-config.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "https://proagents.dev/schemas/dashboard-config.json",
+  "version": "1.0.0",
+  "dashboard": {
+    "id": "dev-velocity",
+    "name": "Development Velocity Dashboard",
+    "description": "Track feature completion and team productivity",
+    "refreshInterval": 300,
+    "theme": "auto"
+  },
+  "layout": {
+    "columns": 12,
+    "rowHeight": 80,
+    "margin": [16, 16]
+  },
+  "widgets": [
+    {
+      "id": "features-completed",
+      "type": "stat",
+      "title": "Features Completed",
+      "position": { "x": 0, "y": 0, "w": 3, "h": 2 },
+      "config": {
+        "metric": "features.completed.count",
+        "timeRange": "30d",
+        "comparison": "previous_period",
+        "format": "number",
+        "color": "green"
+      }
+    },
+    {
+      "id": "bugs-fixed",
+      "type": "stat",
+      "title": "Bugs Fixed",
+      "position": { "x": 3, "y": 0, "w": 3, "h": 2 },
+      "config": {
+        "metric": "bugs.fixed.count",
+        "timeRange": "30d",
+        "comparison": "previous_period",
+        "format": "number",
+        "color": "blue"
+      }
+    },
+    {
+      "id": "avg-feature-time",
+      "type": "stat",
+      "title": "Avg Feature Time",
+      "position": { "x": 6, "y": 0, "w": 3, "h": 2 },
+      "config": {
+        "metric": "features.avg_completion_time",
+        "timeRange": "30d",
+        "format": "duration",
+        "suffix": "days"
+      }
+    },
+    {
+      "id": "test-coverage",
+      "type": "gauge",
+      "title": "Test Coverage",
+      "position": { "x": 9, "y": 0, "w": 3, "h": 2 },
+      "config": {
+        "metric": "quality.test_coverage",
+        "min": 0,
+        "max": 100,
+        "thresholds": [
+          { "value": 60, "color": "red" },
+          { "value": 80, "color": "yellow" },
+          { "value": 100, "color": "green" }
+        ]
+      }
+    },
+    {
+      "id": "feature-timeline",
+      "type": "timeline",
+      "title": "Feature Progress",
+      "position": { "x": 0, "y": 2, "w": 8, "h": 3 },
+      "config": {
+        "dataSource": "features.active",
+        "groupBy": "status",
+        "showMilestones": true,
+        "fields": ["name", "phase", "progress", "assignee"]
+      }
+    },
+    {
+      "id": "phase-distribution",
+      "type": "pie",
+      "title": "Features by Phase",
+      "position": { "x": 8, "y": 2, "w": 4, "h": 3 },
+      "config": {
+        "metric": "features.by_phase",
+        "colors": {
+          "analysis": "#3B82F6",
+          "implementation": "#10B981",
+          "testing": "#F59E0B",
+          "review": "#8B5CF6",
+          "deployment": "#EC4899"
+        }
+      }
+    },
+    {
+      "id": "velocity-chart",
+      "type": "line",
+      "title": "Velocity Trend",
+      "position": { "x": 0, "y": 5, "w": 6, "h": 3 },
+      "config": {
+        "metrics": [
+          { "id": "features", "label": "Features", "color": "#3B82F6" },
+          { "id": "bugs", "label": "Bug Fixes", "color": "#10B981" }
+        ],
+        "timeRange": "90d",
+        "granularity": "week",
+        "showTrend": true
+      }
+    },
+    {
+      "id": "team-leaderboard",
+      "type": "table",
+      "title": "Team Contributions",
+      "position": { "x": 6, "y": 5, "w": 6, "h": 3 },
+      "config": {
+        "dataSource": "team.contributions",
+        "columns": [
+          { "field": "developer", "label": "Developer" },
+          { "field": "features", "label": "Features", "align": "right" },
+          { "field": "bugs", "label": "Bugs Fixed", "align": "right" },
+          { "field": "reviews", "label": "Reviews", "align": "right" }
+        ],
+        "sortBy": "features",
+        "sortOrder": "desc",
+        "limit": 10
+      }
+    },
+    {
+      "id": "recent-activity",
+      "type": "feed",
+      "title": "Recent Activity",
+      "position": { "x": 0, "y": 8, "w": 12, "h": 2 },
+      "config": {
+        "dataSource": "activity.feed",
+        "limit": 10,
+        "showTimestamp": true,
+        "eventTypes": ["feature_complete", "deployment", "pr_merged"]
+      }
+    }
+  ],
+  "dataSources": {
+    "features.completed.count": {
+      "type": "api",
+      "endpoint": "/api/metrics/features/completed",
+      "method": "GET"
+    },
+    "bugs.fixed.count": {
+      "type": "api",
+      "endpoint": "/api/metrics/bugs/fixed",
+      "method": "GET"
+    },
+    "features.active": {
+      "type": "api",
+      "endpoint": "/api/features?status=active",
+      "method": "GET"
+    },
+    "team.contributions": {
+      "type": "api",
+      "endpoint": "/api/metrics/team/contributions",
+      "method": "GET"
+    },
+    "activity.feed": {
+      "type": "websocket",
+      "endpoint": "wss://api.example.com/activity"
+    }
+  },
+  "filters": [
+    {
+      "id": "time-range",
+      "type": "date-range",
+      "label": "Time Range",
+      "default": "30d",
+      "options": ["7d", "30d", "90d", "1y"]
+    },
+    {
+      "id": "team",
+      "type": "select",
+      "label": "Team",
+      "dataSource": "teams.list",
+      "multiple": true
+    }
+  ]
+}