@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/content/.morph/hooks/task-completed.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+/**
+ * TaskCompleted Hook - Claude Code Agent Teams
+ *
+ * Triggered when a task is marked as completed.
+ * Validates the task deliverables before allowing the task to be marked done.
+ *
+ * Usage (from Claude Code hooks):
+ *   task-completed.js <feature-name> <task-id> [--dry-run] [--verbose]
+ *
+ * Exit codes:
+ *   0 - All validators passed
+ *   1 - Validation failed and blocked
+ *   2 - Configuration error
+ */
+
+import { executeHook, formatHookResults } from '../../../src/lib/hook-executor.js';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get project root (3 levels up from hooks dir)
+const projectPath = join(__dirname, '../../..');
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length < 2) {
+    console.error('Usage: task-completed.js <feature-name> <task-id> [--dry-run] [--verbose]');
+    process.exit(2);
+  }
+
+  const featureName = args[0];
+  const taskId = args[1];
+  const dryRun = args.includes('--dry-run');
+  const verbose = args.includes('--verbose');
+
+  console.log('🔔 TaskCompleted Hook Triggered');
+  console.log(`   Feature: ${featureName}`);
+  console.log(`   Task: ${taskId}`);
+  console.log(`   Event: Task marked complete, validating deliverables...\n`);
+
+  try {
+    const results = await executeHook(projectPath, featureName, 'TaskCompleted', {
+      dryRun,
+      verbose
+    });
+
+    const output = formatHookResults(results, 'TaskCompleted');
+    console.log(output);
+
+    if (results.blocked) {
+      console.log('\n💡 TIP: Fix the errors above before the task can be marked complete.');
+      console.log(`   Run: morph-spec task done ${featureName} ${taskId} --skip-validation`);
+      console.log('   (Not recommended - only use if you know what you\'re doing)');
+      process.exit(1);
+    }
+
+    console.log('\n✅ Task deliverables validated successfully.');
+    process.exit(0);
+  } catch (err) {
+    console.error(`\n❌ Hook execution error: ${err.message}`);
+    if (verbose) {
+      console.error(err.stack);
+    }
+    process.exit(2);
+  }
+}
+
+main();

package/content/.morph/hooks/teammate-idle.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+/**
+ * TeammateIdle Hook - Claude Code Agent Teams
+ *
+ * Triggered when a teammate is idle and waiting for next instructions.
+ * Validates the teammate's recent work before allowing them to proceed.
+ *
+ * Usage (from Claude Code hooks):
+ *   teammate-idle.js <feature-name> [--dry-run] [--verbose]
+ *
+ * Exit codes:
+ *   0 - All validators passed
+ *   1 - Validation failed and blocked
+ *   2 - Configuration error
+ */
+
+import { executeHook, formatHookResults } from '../../../src/lib/hook-executor.js';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get project root (3 levels up from hooks dir)
+const projectPath = join(__dirname, '../../..');
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('Usage: teammate-idle.js <feature-name> [--dry-run] [--verbose]');
+    process.exit(2);
+  }
+
+  const featureName = args[0];
+  const dryRun = args.includes('--dry-run');
+  const verbose = args.includes('--verbose');
+
+  console.log('🔔 TeammateIdle Hook Triggered');
+  console.log(`   Feature: ${featureName}`);
+  console.log(`   Event: Teammate is idle, validating recent work...\n`);
+
+  try {
+    const results = await executeHook(projectPath, featureName, 'TeammateIdle', {
+      dryRun,
+      verbose
+    });
+
+    const output = formatHookResults(results, 'TeammateIdle');
+    console.log(output);
+
+    if (results.blocked) {
+      console.log('\n💡 TIP: Fix the errors above before the teammate can proceed.');
+      process.exit(1);
+    }
+
+    process.exit(0);
+  } catch (err) {
+    console.error(`\n❌ Hook execution error: ${err.message}`);
+    if (verbose) {
+      console.error(err.stack);
+    }
+    process.exit(2);
+  }
+}
+
+main();

package/content/.morph/schemas/tasks.schema.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://morph-spec.dev/schemas/tasks.schema.json",
+  "title": "MORPH-SPEC Tasks Schema",
+  "description": "Schema for tasks.json files in MORPH-SPEC features",
+  "type": "object",
+  "required": ["version", "feature", "tasks"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "examples": ["3.0.0"]
+    },
+    "feature": {
+      "type": "string",
+      "description": "Feature name (kebab-case)",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "examples": ["scheduled-reports", "user-auth"]
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Creation timestamp"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last update timestamp"
+    },
+    "summary": {
+      "type": "object",
+      "description": "Task summary statistics",
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 },
+        "completed": { "type": "integer", "minimum": 0 },
+        "inProgress": { "type": "integer", "minimum": 0 },
+        "pending": { "type": "integer", "minimum": 0 },
+        "blocked": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "description": "List of tasks",
+      "items": {
+        "$ref": "#/definitions/task"
+      }
+    },
+    "checkpoints": {
+      "type": "array",
+      "description": "Checkpoint definitions",
+      "items": {
+        "$ref": "#/definitions/checkpoint"
+      }
+    }
+  },
+  "definitions": {
+    "task": {
+      "type": "object",
+      "required": ["id", "title", "status"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Task ID (format: T001, T002, etc.)",
+          "pattern": "^T\\d{3}$",
+          "examples": ["T001", "T002", "T010"]
+        },
+        "title": {
+          "type": "string",
+          "description": "Task title (short description)",
+          "maxLength": 100,
+          "examples": ["Create ScheduledReport entity"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Detailed task description"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "in_progress", "completed", "blocked", "skipped"],
+          "description": "Current task status"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["entity", "command", "query", "handler", "service", "component", "page", "test", "migration", "config", "infra", "docs"],
+          "description": "Type of task"
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["low", "medium", "high", "critical"],
+          "description": "Task priority"
+        },
+        "dependencies": {
+          "type": "array",
+          "description": "IDs of tasks that must be completed first",
+          "items": {
+            "type": "string",
+            "pattern": "^T\\d{3}$"
+          },
+          "examples": [["T001", "T002"]]
+        },
+        "files": {
+          "type": "array",
+          "description": "Files to be created or modified",
+          "items": {
+            "type": "string"
+          },
+          "examples": [["Domain/Entities/ScheduledReport.cs", "Infrastructure/Persistence/Config/ScheduledReportConfig.cs"]]
+        },
+        "checkpoint": {
+          "type": "string",
+          "description": "Checkpoint ID this task belongs to",
+          "pattern": "^CP\\d{3}$"
+        },
+        "estimatedLines": {
+          "type": "integer",
+          "description": "Estimated lines of code",
+          "minimum": 0
+        },
+        "actualLines": {
+          "type": "integer",
+          "description": "Actual lines of code (after completion)",
+          "minimum": 0
+        },
+        "completedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Completion timestamp"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Additional notes or comments"
+        },
+        "blockedReason": {
+          "type": "string",
+          "description": "Reason for blocked status"
+        }
+      }
+    },
+    "checkpoint": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Checkpoint ID",
+          "pattern": "^CP\\d{3}$",
+          "examples": ["CP001", "CP002"]
+        },
+        "name": {
+          "type": "string",
+          "description": "Checkpoint name",
+          "examples": ["Entity Layer Complete", "Backend Complete"]
+        },
+        "afterTasks": {
+          "type": "array",
+          "description": "Task IDs after which this checkpoint triggers",
+          "items": {
+            "type": "string",
+            "pattern": "^T\\d{3}$"
+          }
+        },
+        "validation": {
+          "type": "array",
+          "description": "Validation steps for this checkpoint",
+          "items": {
+            "type": "string"
+          },
+          "examples": [["Run tests", "Build project", "Review code"]]
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "version": "3.0.0",
+      "feature": "scheduled-reports",
+      "createdAt": "2024-01-15T10:00:00Z",
+      "summary": {
+        "total": 9,
+        "completed": 0,
+        "inProgress": 0,
+        "pending": 9,
+        "blocked": 0
+      },
+      "tasks": [
+        {
+          "id": "T001",
+          "title": "Create ScheduledReport entity",
+          "status": "pending",
+          "type": "entity",
+          "priority": "high",
+          "files": [
+            "Domain/Entities/ScheduledReport.cs",
+            "Infrastructure/Persistence/Config/ScheduledReportConfig.cs"
+          ],
+          "estimatedLines": 100
+        },
+        {
+          "id": "T002",
+          "title": "Create CreateReportCommand + Handler",
+          "status": "pending",
+          "type": "command",
+          "dependencies": ["T001"],
+          "files": [
+            "Application/Features/Reports/Commands/CreateReportCommand.cs"
+          ]
+        }
+      ],
+      "checkpoints": [
+        {
+          "id": "CP001",
+          "name": "Entity Layer Complete",
+          "afterTasks": ["T001", "T002", "T003"],
+          "validation": ["Build project", "Run unit tests"]
+        }
+      ]
+    }
+  ]
+}