@agentic15.com/agentic15-claude-zen 4.2.3 → 5.0.4

package/{templates/.claude → framework}/PROJECT-PLAN-TEMPLATE.json

@@ -1,223 +1,223 @@
-{
-  "version": "2.0",
-  "project": {
-    "id": "PROJ-001",
-    "name": "E-commerce Platform",
-    "description": "Full-featured online store with payment processing",
-    "status": "planning",
-    "createdAt": "2025-12-18T00:00:00.000Z",
-    "createdBy": "human",
-    "locked": false,
-    "subprojects": [
-      {
-        "id": "SUB-001",
-        "name": "User Management System",
-        "description": "Authentication, authorization, and user profiles",
-        "status": "pending",
-        "dependencies": [],
-        "milestones": [
-          {
-            "id": "MILE-001",
-            "name": "Core Authentication",
-            "description": "Basic login/logout functionality",
-            "status": "pending",
-            "dependencies": [],
-            "tasks": [
-              {
-                "id": "TASK-001",
-                "title": "Design user database schema",
-                "description": "Create ERD for users, roles, sessions",
-                "status": "pending",
-                "phase": "design",
-                "dependencies": [],
-                "estimatedHours": 4,
-                "completionCriteria": [
-                  "ERD diagram completed",
-                  "Schema reviewed by team",
-                  "Migration scripts ready"
-                ],
-                "artifacts": {
-                  "design": ["./Agent/db/schema/users.sql"],
-                  "code": [],
-                  "tests": [],
-                  "documentation": ["./docs/database-design.md"]
-                }
-              },
-              {
-                "id": "TASK-002",
-                "title": "Implement user registration API",
-                "description": "POST /api/auth/register endpoint",
-                "status": "pending",
-                "phase": "implementation",
-                "dependencies": ["TASK-001"],
-                "estimatedHours": 6,
-                "completionCriteria": [
-                  "Email validation implemented",
-                  "Password hashing with bcrypt",
-                  "Duplicate email check",
-                  "Returns JWT token"
-                ],
-                "testCases": [
-                  "Valid registration succeeds",
-                  "Invalid email rejected",
-                  "Weak password rejected",
-                  "Duplicate email rejected"
-                ],
-                "artifacts": {
-                  "design": [],
-                  "code": [
-                    "./Agent/src/controllers/authController.js",
-                    "./Agent/src/services/userService.js"
-                  ],
-                  "tests": ["./Agent/tests/auth.test.js"],
-                  "documentation": []
-                }
-              },
-              {
-                "id": "TASK-003",
-                "title": "Write unit tests for registration",
-                "description": "Test all registration edge cases",
-                "status": "pending",
-                "phase": "testing",
-                "dependencies": ["TASK-002"],
-                "estimatedHours": 3,
-                "completionCriteria": [
-                  "100% code coverage for registration",
-                  "All edge cases tested",
-                  "Integration tests pass"
-                ],
-                "artifacts": {
-                  "code": [],
-                  "tests": [
-                    "./Agent/tests/auth.test.js",
-                    "./Agent/tests/integration/register.test.js"
-                  ]
-                }
-              }
-            ]
-          },
-          {
-            "id": "MILE-002",
-            "name": "User Profile Management",
-            "description": "Profile viewing and editing",
-            "status": "pending",
-            "dependencies": ["MILE-001"],
-            "tasks": [
-              {
-                "id": "TASK-004",
-                "title": "Create profile update API",
-                "description": "PATCH /api/users/:id endpoint",
-                "status": "pending",
-                "phase": "implementation",
-                "dependencies": ["TASK-003"],
-                "estimatedHours": 5,
-                "completionCriteria": [
-                  "Can update name, email, avatar",
-                  "Email uniqueness validated",
-                  "Authorization checked"
-                ],
-                "artifacts": {
-                  "code": ["./Agent/src/controllers/userController.js"],
-                  "tests": ["./Agent/tests/userProfile.test.js"]
-                }
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "id": "SUB-002",
-        "name": "Product Catalog System",
-        "description": "Product listings, search, and categories",
-        "status": "pending",
-        "dependencies": [],
-        "milestones": [
-          {
-            "id": "MILE-003",
-            "name": "Basic Product CRUD",
-            "description": "Create, read, update, delete products",
-            "status": "pending",
-            "dependencies": [],
-            "tasks": [
-              {
-                "id": "TASK-005",
-                "title": "Design product database schema",
-                "description": "Tables for products, categories, images",
-                "status": "pending",
-                "phase": "design",
-                "dependencies": [],
-                "estimatedHours": 3,
-                "completionCriteria": [
-                  "Schema supports multiple categories",
-                  "Image URLs stored properly",
-                  "Price and inventory tracked"
-                ],
-                "artifacts": {
-                  "design": ["./Agent/db/schema/products.sql"]
-                }
-              },
-              {
-                "id": "TASK-006",
-                "title": "Implement product listing API",
-                "description": "GET /api/products with pagination",
-                "status": "pending",
-                "phase": "implementation",
-                "dependencies": ["TASK-005"],
-                "estimatedHours": 4,
-                "completionCriteria": [
-                  "Pagination works (limit/offset)",
-                  "Filtering by category",
-                  "Sorting by price, name, date"
-                ],
-                "artifacts": {
-                  "code": ["./Agent/src/controllers/productController.js"],
-                  "tests": ["./Agent/tests/products.test.js"]
-                }
-              }
-            ]
-          }
-        ]
-      },
-      {
-        "id": "SUB-003",
-        "name": "Shopping Cart & Checkout",
-        "description": "Cart management and order processing",
-        "status": "pending",
-        "dependencies": ["SUB-001", "SUB-002"],
-        "milestones": [
-          {
-            "id": "MILE-004",
-            "name": "Shopping Cart",
-            "description": "Add/remove/update cart items",
-            "status": "pending",
-            "dependencies": ["MILE-001", "MILE-003"],
-            "tasks": [
-              {
-                "id": "TASK-007",
-                "title": "Implement cart management",
-                "description": "Session-based cart for guests, DB for users",
-                "status": "pending",
-                "phase": "implementation",
-                "dependencies": ["TASK-002", "TASK-006"],
-                "estimatedHours": 8,
-                "completionCriteria": [
-                  "Add items to cart",
-                  "Update quantities",
-                  "Calculate totals",
-                  "Persist cart for logged-in users"
-                ],
-                "artifacts": {
-                  "code": [
-                    "./Agent/src/services/cartService.js",
-                    "./Agent/src/controllers/cartController.js"
-                  ],
-                  "tests": ["./Agent/tests/cart.test.js"]
-                }
-              }
-            ]
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "version": "2.0",
+  "project": {
+    "id": "PROJ-001",
+    "name": "E-commerce Platform",
+    "description": "Full-featured online store with payment processing",
+    "status": "planning",
+    "createdAt": "2025-12-18T00:00:00.000Z",
+    "createdBy": "human",
+    "locked": false,
+    "subprojects": [
+      {
+        "id": "SUB-001",
+        "name": "User Management System",
+        "description": "Authentication, authorization, and user profiles",
+        "status": "pending",
+        "dependencies": [],
+        "milestones": [
+          {
+            "id": "MILE-001",
+            "name": "Core Authentication",
+            "description": "Basic login/logout functionality",
+            "status": "pending",
+            "dependencies": [],
+            "tasks": [
+              {
+                "id": "TASK-001",
+                "title": "Design user database schema",
+                "description": "Create ERD for users, roles, sessions",
+                "status": "pending",
+                "phase": "design",
+                "dependencies": [],
+                "estimatedHours": 4,
+                "completionCriteria": [
+                  "ERD diagram completed",
+                  "Schema reviewed by team",
+                  "Migration scripts ready"
+                ],
+                "artifacts": {
+                  "design": ["./Agent/db/schema/users.sql"],
+                  "code": [],
+                  "tests": [],
+                  "documentation": ["./docs/database-design.md"]
+                }
+              },
+              {
+                "id": "TASK-002",
+                "title": "Implement user registration API",
+                "description": "POST /api/auth/register endpoint",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-001"],
+                "estimatedHours": 6,
+                "completionCriteria": [
+                  "Email validation implemented",
+                  "Password hashing with bcrypt",
+                  "Duplicate email check",
+                  "Returns JWT token"
+                ],
+                "testCases": [
+                  "Valid registration succeeds",
+                  "Invalid email rejected",
+                  "Weak password rejected",
+                  "Duplicate email rejected"
+                ],
+                "artifacts": {
+                  "design": [],
+                  "code": [
+                    "./Agent/src/controllers/authController.js",
+                    "./Agent/src/services/userService.js"
+                  ],
+                  "tests": ["./Agent/tests/auth.test.js"],
+                  "documentation": []
+                }
+              },
+              {
+                "id": "TASK-003",
+                "title": "Write unit tests for registration",
+                "description": "Test all registration edge cases",
+                "status": "pending",
+                "phase": "testing",
+                "dependencies": ["TASK-002"],
+                "estimatedHours": 3,
+                "completionCriteria": [
+                  "100% code coverage for registration",
+                  "All edge cases tested",
+                  "Integration tests pass"
+                ],
+                "artifacts": {
+                  "code": [],
+                  "tests": [
+                    "./Agent/tests/auth.test.js",
+                    "./Agent/tests/integration/register.test.js"
+                  ]
+                }
+              }
+            ]
+          },
+          {
+            "id": "MILE-002",
+            "name": "User Profile Management",
+            "description": "Profile viewing and editing",
+            "status": "pending",
+            "dependencies": ["MILE-001"],
+            "tasks": [
+              {
+                "id": "TASK-004",
+                "title": "Create profile update API",
+                "description": "PATCH /api/users/:id endpoint",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-003"],
+                "estimatedHours": 5,
+                "completionCriteria": [
+                  "Can update name, email, avatar",
+                  "Email uniqueness validated",
+                  "Authorization checked"
+                ],
+                "artifacts": {
+                  "code": ["./Agent/src/controllers/userController.js"],
+                  "tests": ["./Agent/tests/userProfile.test.js"]
+                }
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "id": "SUB-002",
+        "name": "Product Catalog System",
+        "description": "Product listings, search, and categories",
+        "status": "pending",
+        "dependencies": [],
+        "milestones": [
+          {
+            "id": "MILE-003",
+            "name": "Basic Product CRUD",
+            "description": "Create, read, update, delete products",
+            "status": "pending",
+            "dependencies": [],
+            "tasks": [
+              {
+                "id": "TASK-005",
+                "title": "Design product database schema",
+                "description": "Tables for products, categories, images",
+                "status": "pending",
+                "phase": "design",
+                "dependencies": [],
+                "estimatedHours": 3,
+                "completionCriteria": [
+                  "Schema supports multiple categories",
+                  "Image URLs stored properly",
+                  "Price and inventory tracked"
+                ],
+                "artifacts": {
+                  "design": ["./Agent/db/schema/products.sql"]
+                }
+              },
+              {
+                "id": "TASK-006",
+                "title": "Implement product listing API",
+                "description": "GET /api/products with pagination",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-005"],
+                "estimatedHours": 4,
+                "completionCriteria": [
+                  "Pagination works (limit/offset)",
+                  "Filtering by category",
+                  "Sorting by price, name, date"
+                ],
+                "artifacts": {
+                  "code": ["./Agent/src/controllers/productController.js"],
+                  "tests": ["./Agent/tests/products.test.js"]
+                }
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "id": "SUB-003",
+        "name": "Shopping Cart & Checkout",
+        "description": "Cart management and order processing",
+        "status": "pending",
+        "dependencies": ["SUB-001", "SUB-002"],
+        "milestones": [
+          {
+            "id": "MILE-004",
+            "name": "Shopping Cart",
+            "description": "Add/remove/update cart items",
+            "status": "pending",
+            "dependencies": ["MILE-001", "MILE-003"],
+            "tasks": [
+              {
+                "id": "TASK-007",
+                "title": "Implement cart management",
+                "description": "Session-based cart for guests, DB for users",
+                "status": "pending",
+                "phase": "implementation",
+                "dependencies": ["TASK-002", "TASK-006"],
+                "estimatedHours": 8,
+                "completionCriteria": [
+                  "Add items to cart",
+                  "Update quantities",
+                  "Calculate totals",
+                  "Persist cart for logged-in users"
+                ],
+                "artifacts": {
+                  "code": [
+                    "./Agent/src/services/cartService.js",
+                    "./Agent/src/controllers/cartController.js"
+                  ],
+                  "tests": ["./Agent/tests/cart.test.js"]
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}

package/{templates/.claude → framework}/hooks/enforce-plan-template.js

@@ -1,106 +1,106 @@
-#!/usr/bin/env node
-
-/**
- * Enforce Plan Template Hook
- *
- * CRITICAL: Blocks custom plan formats - ONLY allow official template
- *
- * When Claude writes PROJECT-PLAN.json, this hook validates:
- * 1. Plan follows PLAN-SCHEMA.json structure
- * 2. Has required fields: planId, projectName, structure, tasks
- * 3. Tasks have proper format: id, title, description, phase, dependencies
- * 4. No custom formats allowed
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Read the tool input
-const input = process.argv[2] || '{}';
-const toolData = JSON.parse(input);
-
-const filePath = toolData.tool_input?.file_path;
-const content = toolData.tool_input?.content;
-const tool = toolData.tool;
-
-// Only check when writing PROJECT-PLAN.json
-if (tool === 'Write' && filePath && filePath.includes('PROJECT-PLAN.json')) {
-
-  let plan;
-  try {
-    plan = JSON.parse(content);
-  } catch (error) {
-    console.error('\n❌ BLOCKED: PROJECT-PLAN.json must be valid JSON');
-    console.error(`   Parse error: ${error.message}\n`);
-    process.exit(2);
-  }
-
-  const errors = [];
-
-  // Required top-level fields
-  const requiredFields = ['planId', 'projectName', 'description', 'structure', 'tasks'];
-  for (const field of requiredFields) {
-    if (!plan[field]) {
-      errors.push(`Missing required field: ${field}`);
-    }
-  }
-
-  // Validate structure field
-  if (plan.structure && typeof plan.structure !== 'string') {
-    errors.push('Field "structure" must be "flat" or "hierarchical"');
-  }
-
-  // Validate tasks array
-  if (plan.tasks && !Array.isArray(plan.tasks)) {
-    errors.push('Field "tasks" must be an array');
-  }
-
-  // Validate each task
-  if (Array.isArray(plan.tasks)) {
-    const taskRequiredFields = ['id', 'title', 'description', 'phase', 'dependencies', 'estimatedHours'];
-
-    plan.tasks.forEach((task, index) => {
-      for (const field of taskRequiredFields) {
-        if (task[field] === undefined) {
-          errors.push(`Task ${task.id || index}: Missing required field "${field}"`);
-        }
-      }
-
-      // Validate task ID format
-      if (task.id && !task.id.match(/^TASK-\d{3}$/)) {
-        errors.push(`Task ${task.id || index}: Invalid ID format. Must be TASK-XXX (e.g., TASK-001)`);
-      }
-
-      // Validate dependencies is array
-      if (task.dependencies && !Array.isArray(task.dependencies)) {
-        errors.push(`Task ${task.id || index}: dependencies must be an array`);
-      }
-
-      // Validate phase
-      const validPhases = ['design', 'implementation', 'testing', 'deployment'];
-      if (task.phase && !validPhases.includes(task.phase)) {
-        errors.push(`Task ${task.id || index}: Invalid phase "${task.phase}". Must be one of: ${validPhases.join(', ')}`);
-      }
-    });
-  }
-
-  // If errors found, block
-  if (errors.length > 0) {
-    console.error('\n❌ BLOCKED: PROJECT-PLAN.json does NOT follow template');
-    console.error('\n   Validation errors:');
-    errors.forEach(err => console.error(`   • ${err}`));
-    console.error('\n   ✅ Use the official template:');
-    console.error('   1. Read .claude/PLAN-SCHEMA.json for structure');
-    console.error('   2. Read .claude/PROJECT-PLAN-TEMPLATE.json for format');
-    console.error('   3. Follow the exact structure');
-    console.error('\n   Required fields:');
-    console.error('   - planId, projectName, description, structure, tasks');
-    console.error('   - Each task: id (TASK-XXX), title, description, phase, dependencies, estimatedHours\n');
-    process.exit(2);
-  }
-
-  // Validation passed
-  console.log('✅ PROJECT-PLAN.json follows official template');
-}
-
-process.exit(0);
+#!/usr/bin/env node
+
+/**
+ * Enforce Plan Template Hook
+ *
+ * CRITICAL: Blocks custom plan formats - ONLY allow official template
+ *
+ * When Claude writes PROJECT-PLAN.json, this hook validates:
+ * 1. Plan follows PLAN-SCHEMA.json structure
+ * 2. Has required fields: planId, projectName, structure, tasks
+ * 3. Tasks have proper format: id, title, description, phase, dependencies
+ * 4. No custom formats allowed
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Read the tool input
+const input = process.argv[2] || '{}';
+const toolData = JSON.parse(input);
+
+const filePath = toolData.tool_input?.file_path;
+const content = toolData.tool_input?.content;
+const tool = toolData.tool;
+
+// Only check when writing PROJECT-PLAN.json
+if (tool === 'Write' && filePath && filePath.includes('PROJECT-PLAN.json')) {
+
+  let plan;
+  try {
+    plan = JSON.parse(content);
+  } catch (error) {
+    console.error('\n❌ BLOCKED: PROJECT-PLAN.json must be valid JSON');
+    console.error(`   Parse error: ${error.message}\n`);
+    process.exit(2);
+  }
+
+  const errors = [];
+
+  // Required top-level fields
+  const requiredFields = ['planId', 'projectName', 'description', 'structure', 'tasks'];
+  for (const field of requiredFields) {
+    if (!plan[field]) {
+      errors.push(`Missing required field: ${field}`);
+    }
+  }
+
+  // Validate structure field
+  if (plan.structure && typeof plan.structure !== 'string') {
+    errors.push('Field "structure" must be "flat" or "hierarchical"');
+  }
+
+  // Validate tasks array
+  if (plan.tasks && !Array.isArray(plan.tasks)) {
+    errors.push('Field "tasks" must be an array');
+  }
+
+  // Validate each task
+  if (Array.isArray(plan.tasks)) {
+    const taskRequiredFields = ['id', 'title', 'description', 'phase', 'dependencies', 'estimatedHours'];
+
+    plan.tasks.forEach((task, index) => {
+      for (const field of taskRequiredFields) {
+        if (task[field] === undefined) {
+          errors.push(`Task ${task.id || index}: Missing required field "${field}"`);
+        }
+      }
+
+      // Validate task ID format
+      if (task.id && !task.id.match(/^TASK-\d{3}$/)) {
+        errors.push(`Task ${task.id || index}: Invalid ID format. Must be TASK-XXX (e.g., TASK-001)`);
+      }
+
+      // Validate dependencies is array
+      if (task.dependencies && !Array.isArray(task.dependencies)) {
+        errors.push(`Task ${task.id || index}: dependencies must be an array`);
+      }
+
+      // Validate phase
+      const validPhases = ['design', 'implementation', 'testing', 'deployment'];
+      if (task.phase && !validPhases.includes(task.phase)) {
+        errors.push(`Task ${task.id || index}: Invalid phase "${task.phase}". Must be one of: ${validPhases.join(', ')}`);
+      }
+    });
+  }
+
+  // If errors found, block
+  if (errors.length > 0) {
+    console.error('\n❌ BLOCKED: PROJECT-PLAN.json does NOT follow template');
+    console.error('\n   Validation errors:');
+    errors.forEach(err => console.error(`   • ${err}`));
+    console.error('\n   ✅ Use the official template:');
+    console.error('   1. Read node_modules/@agentic15.com/agentic15-claude-zen/framework/PLAN-SCHEMA.json for structure');
+    console.error('   2. Read node_modules/@agentic15.com/agentic15-claude-zen/framework/PROJECT-PLAN-TEMPLATE.json for format');
+    console.error('   3. Follow the exact structure');
+    console.error('\n   Required fields:');
+    console.error('   - planId, projectName, description, structure, tasks');
+    console.error('   - Each task: id (TASK-XXX), title, description, phase, dependencies, estimatedHours\n');
+    process.exit(2);
+  }
+
+  // Validation passed
+  console.log('✅ PROJECT-PLAN.json follows official template');
+}
+
+process.exit(0);