proagents 1.0.0

package/proagents/.learning/projects/example-project/patterns.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "../../schemas/project-patterns-schema.json",
+  "project_id": "example-project",
+  "project_path": "/path/to/example-project",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "naming_conventions": {
+    "components": {
+      "pattern": "PascalCase",
+      "suffix": "",
+      "examples": ["UserProfile", "DashboardCard", "NavigationMenu"],
+      "confidence": 0.95
+    },
+    "hooks": {
+      "pattern": "camelCase",
+      "prefix": "use",
+      "examples": ["useAuth", "useUserData", "useLocalStorage"],
+      "confidence": 0.98
+    },
+    "services": {
+      "pattern": "PascalCase",
+      "suffix": "Service",
+      "examples": ["UserService", "AuthService", "ApiService"],
+      "confidence": 0.90
+    },
+    "types": {
+      "pattern": "PascalCase",
+      "prefix": "",
+      "suffix": "",
+      "examples": ["User", "ApiResponse", "FormData"],
+      "confidence": 0.92
+    },
+    "files": {
+      "components": "PascalCase.tsx",
+      "hooks": "camelCase.ts",
+      "utils": "camelCase.ts",
+      "tests": "*.test.ts"
+    }
+  },
+
+  "code_patterns": {
+    "imports": {
+      "order": ["react", "third-party", "local", "styles"],
+      "group_by": "type",
+      "examples": [
+        "import React, { useState } from 'react';",
+        "import { useQuery } from '@tanstack/react-query';",
+        "import { UserService } from '@/services/UserService';",
+        "import styles from './Component.module.css';"
+      ]
+    },
+    "exports": {
+      "style": "named",
+      "examples": ["export const Component = ...", "export function useHook() {...}"]
+    },
+    "error_handling": {
+      "style": "try-catch-async",
+      "error_type": "typed",
+      "logging": true
+    },
+    "state_management": {
+      "global": "zustand",
+      "local": "useState",
+      "server": "react-query"
+    }
+  },
+
+  "architecture": {
+    "directory_structure": {
+      "src/components": "Shared UI components",
+      "src/features": "Feature-based modules",
+      "src/hooks": "Custom React hooks",
+      "src/services": "API and business logic",
+      "src/stores": "Zustand stores",
+      "src/types": "TypeScript type definitions",
+      "src/utils": "Utility functions"
+    },
+    "patterns_used": [
+      "feature-based-architecture",
+      "custom-hooks",
+      "service-layer",
+      "typed-api-responses"
+    ]
+  },
+
+  "testing": {
+    "framework": "vitest",
+    "structure": "colocated",
+    "naming": "*.test.ts",
+    "coverage_target": 80,
+    "patterns": {
+      "unit": "describe-it with mocks",
+      "integration": "testing-library with msw",
+      "e2e": "playwright"
+    }
+  },
+
+  "learned_at": "2024-01-15T10:30:00Z",
+  "last_analysis": "2024-01-15T10:30:00Z",
+  "confidence_overall": 0.92
+}

package/proagents/.learning/schemas/README.md

@@ -0,0 +1,48 @@
+# Learning Data Schemas
+
+JSON Schema definitions for the ProAgents learning system data files.
+
+---
+
+## Schema Files
+
+| Schema | Purpose |
+|--------|---------|
+| `user-preferences-schema.json` | User checkpoint and workflow preferences |
+| `patterns-schema.json` | Global code patterns and anti-patterns |
+| `project-patterns-schema.json` | Project-specific patterns and conventions |
+| `corrections-schema.json` | User corrections to AI suggestions |
+| `metrics-schema.json` | Development time and quality metrics |
+| `feedback-schema.json` | User feedback on AI assistance |
+
+---
+
+## Data Structure
+
+```
+.learning/
+├── global/                      # Cross-project learnings
+│   ├── user-preferences.json    # User workflow preferences
+│   └── common-patterns.json     # Common code patterns
+│
+├── projects/                    # Per-project learnings
+│   └── {project-id}/
+│       ├── patterns.json        # Project-specific patterns
+│       ├── corrections.json     # User corrections
+│       ├── metrics.json         # Performance metrics
+│       └── feedback.json        # User feedback
+│
+└── schemas/                     # Schema definitions
+    └── *.json
+```
+
+---
+
+## Validation
+
+All learning data files are validated against their schemas on:
+- Load
+- Save
+- Sync
+
+Invalid data is logged and quarantined for review.

package/proagents/.learning/schemas/corrections-schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "corrections-schema.json",
+  "title": "Corrections Schema",
+  "description": "Schema for user corrections in the ProAgents learning system",
+  "type": "object",
+  "required": ["project_id", "version", "updated_at", "corrections"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "project_id": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "corrections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "created_at", "type", "category"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^corr-\\d+$"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["code_pattern", "naming", "error_handling", "imports", "structure", "other"]
+          },
+          "category": {
+            "type": "string"
+          },
+          "original": {
+            "type": "object",
+            "properties": {
+              "code": { "type": "string" },
+              "pattern": { "type": "string" },
+              "context": { "type": "string" }
+            }
+          },
+          "corrected": {
+            "type": "object",
+            "properties": {
+              "code": { "type": "string" },
+              "pattern": { "type": "string" },
+              "context": { "type": "string" }
+            }
+          },
+          "reason": {
+            "type": "string"
+          },
+          "occurrences": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "auto_apply": {
+            "type": "boolean"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        }
+      }
+    },
+    "statistics": {
+      "type": "object",
+      "properties": {
+        "total_corrections": { "type": "integer", "minimum": 0 },
+        "auto_applied": { "type": "integer", "minimum": 0 },
+        "manual_review": { "type": "integer", "minimum": 0 },
+        "average_confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "time_saved_minutes": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "pending_review": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "correction_id": { "type": "string" },
+          "reason": { "type": "string" },
+          "suggested_action": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/proagents/.learning/schemas/feedback-schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "feedback-schema.json",
+  "title": "Feedback Schema",
+  "description": "Schema for user feedback in the ProAgents learning system",
+  "type": "object",
+  "required": ["project_id", "version", "updated_at", "feedback_entries"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "project_id": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "feedback_entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "timestamp", "type", "rating"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^fb-\\d+$"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "feature_id": {
+            "type": "string"
+          },
+          "phase": {
+            "type": "string",
+            "enum": ["analysis", "requirements", "design", "planning", "implementation", "testing", "review", "documentation", "deployment"]
+          },
+          "type": {
+            "type": "string",
+            "enum": ["positive", "improvement", "negative"]
+          },
+          "rating": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 5
+          },
+          "comment": {
+            "type": "string"
+          },
+          "context": {
+            "type": "object",
+            "properties": {
+              "suggestion_accepted": { "type": "boolean" },
+              "modifications_needed": { "type": "boolean" },
+              "modification_type": { "type": "string" },
+              "required_restart": { "type": "boolean" }
+            }
+          },
+          "improvement_suggestions": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "root_cause": {
+            "type": "string"
+          },
+          "resolution": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "aggregated_feedback": {
+      "type": "object",
+      "properties": {
+        "total_entries": { "type": "integer", "minimum": 0 },
+        "average_rating": { "type": "number", "minimum": 1, "maximum": 5 },
+        "positive_count": { "type": "integer", "minimum": 0 },
+        "improvement_count": { "type": "integer", "minimum": 0 },
+        "negative_count": { "type": "integer", "minimum": 0 },
+        "by_phase": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "average_rating": { "type": "number", "minimum": 1, "maximum": 5 },
+              "count": { "type": "integer", "minimum": 0 }
+            }
+          }
+        },
+        "common_issues": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "issue": { "type": "string" },
+              "frequency": { "type": "integer", "minimum": 0 },
+              "status": { "type": "string" }
+            }
+          }
+        },
+        "strengths": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "area": { "type": "string" },
+              "frequency": { "type": "integer", "minimum": 0 },
+              "confidence": { "type": "number", "minimum": 0, "maximum": 1 }
+            }
+          }
+        }
+      }
+    },
+    "improvement_actions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "status"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^action-\\d+$"
+          },
+          "created_from": { "type": "string" },
+          "description": { "type": "string" },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "in_progress", "completed", "cancelled"]
+          },
+          "completed_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    }
+  }
+}

package/proagents/.learning/schemas/metrics-schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "metrics-schema.json",
+  "title": "Metrics Schema",
+  "description": "Schema for development metrics in the ProAgents learning system",
+  "type": "object",
+  "required": ["project_id", "version", "updated_at"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "project_id": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "features_completed": { "type": "integer", "minimum": 0 },
+        "bugs_fixed": { "type": "integer", "minimum": 0 },
+        "total_development_hours": { "type": "number", "minimum": 0 },
+        "average_feature_duration_hours": { "type": "number", "minimum": 0 },
+        "average_bug_fix_duration_hours": { "type": "number", "minimum": 0 }
+      }
+    },
+    "phase_durations": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "average_minutes": { "type": "number", "minimum": 0 },
+          "min_minutes": { "type": "number", "minimum": 0 },
+          "max_minutes": { "type": "number", "minimum": 0 },
+          "samples": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "checkpoint_metrics": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "average_wait_minutes": { "type": "number", "minimum": 0 },
+          "skip_rate": { "type": "number", "minimum": 0, "maximum": 1 },
+          "approval_rate": { "type": "number", "minimum": 0, "maximum": 1 }
+        }
+      }
+    },
+    "efficiency_trends": {
+      "type": "object",
+      "properties": {
+        "weekly": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "week": { "type": "string", "pattern": "^\\d{4}-W\\d{2}$" },
+              "features": { "type": "integer", "minimum": 0 },
+              "avg_duration_hours": { "type": "number", "minimum": 0 }
+            }
+          }
+        },
+        "improvement_rate": { "type": "number" },
+        "trend": {
+          "type": "string",
+          "enum": ["improving", "stable", "declining"]
+        }
+      }
+    },
+    "quality_metrics": {
+      "type": "object",
+      "properties": {
+        "test_coverage_average": { "type": "number", "minimum": 0, "maximum": 100 },
+        "bugs_per_feature": { "type": "number", "minimum": 0 },
+        "rework_rate": { "type": "number", "minimum": 0, "maximum": 1 },
+        "code_review_iterations_average": { "type": "number", "minimum": 0 }
+      }
+    },
+    "learning_impact": {
+      "type": "object",
+      "properties": {
+        "corrections_auto_applied": { "type": "integer", "minimum": 0 },
+        "time_saved_by_corrections_minutes": { "type": "integer", "minimum": 0 },
+        "patterns_learned": { "type": "integer", "minimum": 0 },
+        "suggestions_accepted_rate": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    }
+  }
+}

package/proagents/.learning/schemas/patterns-schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "patterns-schema.json",
+  "title": "Common Patterns Schema",
+  "description": "Schema for common code patterns in the ProAgents learning system",
+  "type": "object",
+  "required": ["version", "updated_at", "patterns"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Reference to this schema file"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "patterns": {
+      "type": "object",
+      "properties": {
+        "component_patterns": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/pattern" }
+        },
+        "api_patterns": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/pattern" }
+        },
+        "error_handling": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/pattern" }
+        },
+        "testing_patterns": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/pattern" }
+        }
+      }
+    },
+    "anti_patterns": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "name"],
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "detected_count": { "type": "integer", "minimum": 0 },
+          "suggestion": { "type": "string" },
+          "auto_suggest": { "type": "boolean" }
+        }
+      }
+    },
+    "learned_from": {
+      "type": "object",
+      "properties": {
+        "codebase_analysis": { "type": "integer", "minimum": 0 },
+        "user_corrections": { "type": "integer", "minimum": 0 },
+        "explicit_teaching": { "type": "integer", "minimum": 0 }
+      }
+    }
+  },
+  "definitions": {
+    "pattern": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "type": "string" },
+        "name": { "type": "string" },
+        "frequency": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "template": { "type": "string" },
+        "applies_to": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}