proagents 1.6.17 → 1.6.19

package/.proagents/reporting/quality-metrics.md

@@ -1,385 +0,0 @@
-# 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

@@ -1,56 +0,0 @@
-# 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

@@ -1,187 +0,0 @@
-{
-  "$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
-    }
-  ]
-}