proagents 1.0.0

package/proagents/active-features/README.md

@@ -0,0 +1,176 @@
+# Active Features Tracking
+
+Track parallel feature development and manage conflicts.
+
+---
+
+## Overview
+
+This directory tracks all features currently in development. It enables:
+
+- Parallel feature development
+- Conflict detection
+- Dependency management
+- Progress tracking
+
+---
+
+## Directory Structure
+
+```
+active-features/
+├── README.md                    # This file
+├── _index.json                  # Master list of features (auto-generated)
+├── feature-user-auth/           # Example feature directory
+│   ├── status.json             # Machine-readable status
+│   ├── status.md               # Human-readable status
+│   ├── requirements.md         # Feature requirements
+│   ├── design.md               # Design decisions
+│   ├── files-modified.json     # Files this feature touches
+│   └── dependencies.json       # Dependencies on other features
+└── feature-dashboard/           # Another feature
+    └── ...
+```
+
+---
+
+## Feature Index (_index.json)
+
+```json
+{
+  "active_features": [
+    {
+      "id": "feature-user-auth",
+      "name": "User Authentication",
+      "branch": "feature/user-auth",
+      "current_phase": "implementation",
+      "progress": 60,
+      "started": "2024-01-15T10:00:00Z",
+      "assignee": "developer-1",
+      "blockers": []
+    }
+  ],
+  "completed_features": [],
+  "blocked_features": []
+}
+```
+
+---
+
+## Feature Status (status.json)
+
+```json
+{
+  "feature_id": "feature-user-auth",
+  "name": "User Authentication",
+  "branch": "feature/user-auth",
+  "status": "in_progress",
+  "phase": "implementation",
+  "phase_progress": 60,
+  "started": "2024-01-15T10:00:00Z",
+  "last_updated": "2024-01-16T14:30:00Z",
+  "phases_completed": [
+    "analysis",
+    "requirements",
+    "design",
+    "planning"
+  ],
+  "files_created": 8,
+  "files_modified": 3,
+  "tests_added": 12
+}
+```
+
+---
+
+## Conflict Detection
+
+Files that multiple features modify are tracked:
+
+```json
+// files-modified.json
+{
+  "feature_id": "feature-user-auth",
+  "files": [
+    {
+      "path": "src/components/Header.tsx",
+      "sections": ["navigation", "user-menu"],
+      "last_modified": "2024-01-16T10:00:00Z"
+    }
+  ]
+}
+```
+
+When conflicts are detected:
+
+```
+⚠️ CONFLICT DETECTED
+
+Files modified by multiple features:
+- src/components/Header.tsx
+  - feature-user-auth (navigation section)
+  - feature-dashboard (navigation section)
+
+Recommendation: Coordinate before merge
+```
+
+---
+
+## Usage
+
+### Start Feature Tracking
+
+When you run `/feature-start "Feature Name"`:
+1. Directory created: `active-features/feature-name/`
+2. Status files initialized
+3. Added to `_index.json`
+
+### Check Conflicts
+
+```
+/conflict-check
+```
+
+Shows any file conflicts with other active features.
+
+### View Status
+
+```
+/feature-status
+```
+
+Shows current feature progress and any blockers.
+
+### Complete Feature
+
+When feature is done:
+1. Moved to `completed_features` in index
+2. Files archived (optional)
+3. Conflict tracking removed
+
+---
+
+## .gitignore Recommendation
+
+```gitignore
+# In your project .gitignore
+proagents/active-features/_index.json
+proagents/active-features/*/status.json
+proagents/active-features/*/files-modified.json
+
+# Keep these (optional)
+# proagents/active-features/*/requirements.md
+# proagents/active-features/*/design.md
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/feature-start` | Start new feature tracking |
+| `/feature-status` | View current status |
+| `/feature-list` | List all active features |
+| `/conflict-check` | Check for conflicts |
+| `/feature-complete` | Mark feature complete |

package/proagents/active-features/_index.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "./schemas/index-schema.json",
+  "version": "1.0.0",
+  "last_updated": "2024-01-15T10:30:00Z",
+
+  "active_features": [
+    {
+      "id": "feature-user-auth",
+      "name": "User Authentication",
+      "description": "Add user authentication with OAuth support",
+      "current_phase": "implementation",
+      "phase_progress": 60,
+      "branch": "feature/user-auth",
+      "started": "2024-01-10T09:00:00Z",
+      "last_updated": "2024-01-15T10:30:00Z",
+      "estimated_completion": "2024-01-17T17:00:00Z",
+      "assignee": "developer-1",
+      "priority": "high",
+      "blockers": [],
+      "dependencies": [],
+      "files_modified_count": 12,
+      "checkpoints_completed": ["after_analysis", "after_requirements", "after_design"],
+      "checkpoints_pending": ["after_implementation", "before_deployment"]
+    }
+  ],
+
+  "paused_features": [
+    {
+      "id": "feature-notifications",
+      "name": "Push Notifications",
+      "description": "Add push notification support",
+      "current_phase": "requirements",
+      "phase_progress": 30,
+      "branch": "feature/notifications",
+      "started": "2024-01-08T14:00:00Z",
+      "paused_at": "2024-01-12T11:00:00Z",
+      "pause_reason": "Waiting for user-auth to complete",
+      "assignee": "developer-2",
+      "priority": "medium",
+      "blocked_by": ["feature-user-auth"]
+    }
+  ],
+
+  "completed_features": [
+    {
+      "id": "feature-dark-mode",
+      "name": "Dark Mode Support",
+      "completed_at": "2024-01-09T16:00:00Z",
+      "duration_hours": 18,
+      "merged_commit": "abc123def",
+      "pr_number": 42
+    }
+  ],
+
+  "conflicts": {
+    "active": [],
+    "resolved": [
+      {
+        "features": ["feature-user-auth", "feature-dark-mode"],
+        "file": "src/styles/theme.ts",
+        "resolved_at": "2024-01-09T15:30:00Z",
+        "resolution": "merged"
+      }
+    ]
+  },
+
+  "statistics": {
+    "total_active": 1,
+    "total_paused": 1,
+    "total_completed": 1,
+    "average_completion_days": 3.5,
+    "conflict_rate": 0.15
+  }
+}

package/proagents/active-features/feature-user-auth/dependencies.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "../schemas/dependencies-schema.json",
+  "feature_id": "feature-user-auth",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "depends_on": [],
+
+  "blocks": [
+    {
+      "feature_id": "feature-notifications",
+      "reason": "Notifications require authenticated user context",
+      "required_phase": "implementation_complete",
+      "blocking_since": "2024-01-12T11:00:00Z"
+    },
+    {
+      "feature_id": "feature-user-preferences",
+      "reason": "Preferences need user authentication",
+      "required_phase": "testing_complete"
+    }
+  ],
+
+  "shared_resources": [
+    {
+      "resource": "prisma/schema.prisma",
+      "shared_with": ["feature-user-preferences"],
+      "conflict_risk": "medium",
+      "coordination_required": true
+    },
+    {
+      "resource": "src/middleware.ts",
+      "shared_with": [],
+      "conflict_risk": "low"
+    }
+  ],
+
+  "external_dependencies": {
+    "packages": [
+      {
+        "name": "next-auth",
+        "version": "^4.24.0",
+        "added": true,
+        "reason": "Authentication framework"
+      },
+      {
+        "name": "@auth/prisma-adapter",
+        "version": "^1.0.0",
+        "added": true,
+        "reason": "Prisma adapter for NextAuth"
+      }
+    ],
+    "services": [
+      {
+        "name": "Google OAuth",
+        "type": "oauth_provider",
+        "required": true,
+        "configured": true
+      },
+      {
+        "name": "GitHub OAuth",
+        "type": "oauth_provider",
+        "required": true,
+        "configured": true
+      }
+    ],
+    "environment_variables": [
+      "NEXTAUTH_SECRET",
+      "NEXTAUTH_URL",
+      "GOOGLE_CLIENT_ID",
+      "GOOGLE_CLIENT_SECRET",
+      "GITHUB_CLIENT_ID",
+      "GITHUB_CLIENT_SECRET"
+    ]
+  },
+
+  "merge_requirements": {
+    "order": 1,
+    "can_merge_independently": true,
+    "requires_features": [],
+    "required_before": ["feature-notifications", "feature-user-preferences"]
+  }
+}

package/proagents/active-features/feature-user-auth/files-modified.json

@@ -0,0 +1,126 @@
+{
+  "$schema": "../schemas/files-schema.json",
+  "feature_id": "feature-user-auth",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "summary": {
+    "total_files": 12,
+    "new_files": 8,
+    "modified_files": 4,
+    "deleted_files": 0,
+    "lines_added": 845,
+    "lines_removed": 23
+  },
+
+  "files": [
+    {
+      "path": "src/lib/auth.ts",
+      "status": "new",
+      "lines_added": 120,
+      "lines_removed": 0,
+      "last_modified": "2024-01-14T16:30:00Z",
+      "purpose": "Core authentication utilities"
+    },
+    {
+      "path": "src/app/api/auth/[...nextauth]/route.ts",
+      "status": "new",
+      "lines_added": 85,
+      "lines_removed": 0,
+      "last_modified": "2024-01-14T14:00:00Z",
+      "purpose": "NextAuth API route handler"
+    },
+    {
+      "path": "src/components/auth/LoginButton.tsx",
+      "status": "new",
+      "lines_added": 45,
+      "lines_removed": 0,
+      "last_modified": "2024-01-15T09:00:00Z",
+      "purpose": "Login button component"
+    },
+    {
+      "path": "src/components/auth/LogoutButton.tsx",
+      "status": "new",
+      "lines_added": 35,
+      "lines_removed": 0,
+      "last_modified": "2024-01-15T09:15:00Z",
+      "purpose": "Logout button component"
+    },
+    {
+      "path": "src/components/auth/UserMenu.tsx",
+      "status": "new",
+      "lines_added": 78,
+      "lines_removed": 0,
+      "last_modified": "2024-01-15T10:00:00Z",
+      "purpose": "User dropdown menu"
+    },
+    {
+      "path": "src/hooks/useAuth.ts",
+      "status": "new",
+      "lines_added": 52,
+      "lines_removed": 0,
+      "last_modified": "2024-01-14T15:00:00Z",
+      "purpose": "Authentication hook"
+    },
+    {
+      "path": "src/middleware.ts",
+      "status": "modified",
+      "lines_added": 35,
+      "lines_removed": 5,
+      "last_modified": "2024-01-14T17:00:00Z",
+      "purpose": "Added auth middleware"
+    },
+    {
+      "path": "src/types/auth.ts",
+      "status": "new",
+      "lines_added": 28,
+      "lines_removed": 0,
+      "last_modified": "2024-01-14T11:00:00Z",
+      "purpose": "Authentication type definitions"
+    },
+    {
+      "path": "src/app/layout.tsx",
+      "status": "modified",
+      "lines_added": 15,
+      "lines_removed": 8,
+      "last_modified": "2024-01-15T10:30:00Z",
+      "purpose": "Added SessionProvider wrapper"
+    },
+    {
+      "path": "prisma/schema.prisma",
+      "status": "modified",
+      "lines_added": 42,
+      "lines_removed": 0,
+      "last_modified": "2024-01-13T14:00:00Z",
+      "purpose": "Added User and Session models"
+    },
+    {
+      "path": ".env.example",
+      "status": "modified",
+      "lines_added": 8,
+      "lines_removed": 0,
+      "last_modified": "2024-01-13T10:00:00Z",
+      "purpose": "Added auth environment variables"
+    },
+    {
+      "path": "src/tests/auth.test.ts",
+      "status": "new",
+      "lines_added": 302,
+      "lines_removed": 0,
+      "last_modified": "2024-01-15T10:15:00Z",
+      "purpose": "Authentication test suite"
+    }
+  ],
+
+  "conflicts": {
+    "potential": [],
+    "detected": [],
+    "resolved": []
+  },
+
+  "impact_analysis": {
+    "affected_modules": ["auth", "middleware", "database"],
+    "breaking_changes": false,
+    "requires_migration": true,
+    "security_sensitive": true
+  }
+}

package/proagents/active-features/feature-user-auth/status.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "../schemas/feature-schema.json",
+  "id": "feature-user-auth",
+  "name": "User Authentication",
+  "description": "Add user authentication with OAuth support for Google and GitHub",
+  "created_at": "2024-01-10T09:00:00Z",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "workflow": {
+    "mode": "full",
+    "entry_point": "feature_start",
+    "current_phase": "implementation",
+    "phase_progress": 60
+  },
+
+  "phases": {
+    "init": {
+      "status": "completed",
+      "started_at": "2024-01-10T09:00:00Z",
+      "completed_at": "2024-01-10T09:15:00Z",
+      "duration_minutes": 15
+    },
+    "analysis": {
+      "status": "completed",
+      "started_at": "2024-01-10T09:15:00Z",
+      "completed_at": "2024-01-10T10:00:00Z",
+      "duration_minutes": 45,
+      "artifacts": ["analysis-report.md"]
+    },
+    "requirements": {
+      "status": "completed",
+      "started_at": "2024-01-10T10:00:00Z",
+      "completed_at": "2024-01-10T11:30:00Z",
+      "duration_minutes": 90,
+      "artifacts": ["requirements.md", "user-stories.md"]
+    },
+    "design": {
+      "status": "completed",
+      "started_at": "2024-01-10T13:00:00Z",
+      "completed_at": "2024-01-10T15:00:00Z",
+      "duration_minutes": 120,
+      "artifacts": ["ui-specification.md", "component-designs.md"]
+    },
+    "planning": {
+      "status": "completed",
+      "started_at": "2024-01-10T15:00:00Z",
+      "completed_at": "2024-01-10T16:00:00Z",
+      "duration_minutes": 60,
+      "artifacts": ["implementation-plan.md"]
+    },
+    "implementation": {
+      "status": "in_progress",
+      "started_at": "2024-01-11T09:00:00Z",
+      "progress": 60,
+      "tasks_completed": 6,
+      "tasks_total": 10
+    },
+    "testing": {
+      "status": "pending"
+    },
+    "review": {
+      "status": "pending"
+    },
+    "documentation": {
+      "status": "pending"
+    },
+    "deployment": {
+      "status": "pending"
+    }
+  },
+
+  "checkpoints": {
+    "after_analysis": {
+      "triggered": true,
+      "approved": true,
+      "approved_by": "@tech-lead",
+      "approved_at": "2024-01-10T10:05:00Z"
+    },
+    "after_requirements": {
+      "triggered": true,
+      "approved": true,
+      "approved_by": "@product-manager",
+      "approved_at": "2024-01-10T11:45:00Z"
+    },
+    "after_design": {
+      "triggered": true,
+      "approved": true,
+      "approved_by": "@tech-lead",
+      "approved_at": "2024-01-10T15:15:00Z"
+    },
+    "after_implementation": {
+      "triggered": false
+    },
+    "before_deployment": {
+      "triggered": false
+    }
+  },
+
+  "git": {
+    "branch": "feature/user-auth",
+    "base_branch": "develop",
+    "commits": 12,
+    "last_commit": "abc123def",
+    "pr_number": null,
+    "pr_status": null
+  },
+
+  "assignees": {
+    "primary": "developer-1",
+    "reviewers": ["tech-lead", "developer-2"]
+  },
+
+  "context": {
+    "key_decisions": [
+      "Using NextAuth.js for authentication",
+      "JWT tokens stored in httpOnly cookies",
+      "Refresh token rotation enabled"
+    ],
+    "open_questions": [],
+    "blockers": []
+  }
+}

package/proagents/active-features/schemas/dependencies-schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "active-features-dependencies-schema.json",
+  "title": "Active Features Dependencies Schema",
+  "description": "Schema for tracking feature dependencies in ProAgents",
+  "type": "object",
+  "required": ["feature_id", "updated_at"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^feature-[a-z0-9-]+$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "depends_on": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/feature_dependency" }
+    },
+    "blocks": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/feature_dependency" }
+    },
+    "shared_resources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["resource"],
+        "properties": {
+          "resource": { "type": "string" },
+          "shared_with": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "conflict_risk": {
+            "type": "string",
+            "enum": ["low", "medium", "high"]
+          },
+          "coordination_required": { "type": "boolean" }
+        }
+      }
+    },
+    "external_dependencies": {
+      "type": "object",
+      "properties": {
+        "packages": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "version"],
+            "properties": {
+              "name": { "type": "string" },
+              "version": { "type": "string" },
+              "added": { "type": "boolean" },
+              "reason": { "type": "string" }
+            }
+          }
+        },
+        "services": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "type": { "type": "string" },
+              "required": { "type": "boolean" },
+              "configured": { "type": "boolean" }
+            }
+          }
+        },
+        "environment_variables": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "merge_requirements": {
+      "type": "object",
+      "properties": {
+        "order": { "type": "integer", "minimum": 1 },
+        "can_merge_independently": { "type": "boolean" },
+        "requires_features": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "required_before": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "feature_dependency": {
+      "type": "object",
+      "required": ["feature_id"],
+      "properties": {
+        "feature_id": { "type": "string" },
+        "reason": { "type": "string" },
+        "required_phase": {
+          "type": "string",
+          "enum": [
+            "analysis_complete",
+            "design_complete",
+            "implementation_complete",
+            "testing_complete",
+            "review_complete",
+            "deployed"
+          ]
+        },
+        "blocking_since": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}