@polymorphism-tech/morph-spec 4.10.6 → 4.10.7

package/CLAUDE.md

@@ -0,0 +1,3 @@
+# Project
+
+@.claude/CLAUDE.md

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 4.10.6  
+**Version:** 4.10.7  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.10.6 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.10.7 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { program } from 'commander';
 import chalk from 'chalk';
@@ -26,6 +26,16 @@ import { phaseResetCommand } from '../src/commands/phase/phase-reset.js';
 
 // Agent commands
 import { dispatchAgentsCommand } from '../src/commands/agents/dispatch-agents.js';
+import { auditDispatchCommand } from '../src/commands/agents/audit-dispatch.js';
+import { detectAgentsCommand } from '../src/commands/agents/detect-agents.js';
+import { agentMetricsCommand } from '../src/commands/agents/agent-metrics.js';
+import {
+  agentListCommand,
+  agentShowCommand,
+  agentAddCommand,
+  agentEditCommand,
+  agentRemoveCommand,
+} from '../src/commands/agents/manage-agents.js';
 
 // Task commands
 import { taskDoneCommand, taskStartCommand, taskNextCommand } from '../src/commands/tasks/task.js';
@@ -300,9 +310,33 @@ program
   .description('Build dispatch config for parallel agent orchestration (design | tasks | implement)')
   .option('--table', 'Human-readable table output instead of JSON')
   .option('--mode <mode>', 'Dispatch mode: validate (includes Tier-4 validators as read-only)')
+  .option('--preflight', 'Exit with code 1 if any agent files are missing')
   .option('-v, --verbose', 'Show stack trace on error')
   .action((feature, phase, options) => dispatchAgentsCommand(feature, phase, options));
 
+program
+  .command('audit-dispatch <feature>')
+  .description('Display dispatch audit log for a feature')
+  .option('--json', 'Output as JSON instead of table')
+  .action((feature, options) => auditDispatchCommand(feature, options));
+
+program
+  .command('agent-metrics [feature]')
+  .description('Display agent performance metrics for a feature')
+  .option('--json', 'Output as JSON instead of table')
+  .option('--all', 'Aggregate metrics across all features')
+  .action((feature, options) => agentMetricsCommand(feature, options));
+
+program
+  .command('detect-agents <feature>')
+  .description('Detect relevant agents for a feature based on proposal keywords')
+  .option('--proposal <path>', 'Path to proposal file (default: .morph/features/{feature}/0-proposal/proposal.md)')
+  .option('--json', 'Output as JSON (default)')
+  .option('--table', 'Human-readable table output')
+  .option('--exclude <ids>', 'Comma-separated agent IDs to exclude')
+  .option('--refresh', 'Refresh detection using all phase outputs (additive, mutates state)')
+  .action((feature, options) => detectAgentsCommand(feature, options));
+
 // Scope escalation commands
 const scopeCommand = program
   .command('scope')
@@ -317,4 +351,59 @@ scopeCommand
   .option('--dry-run', 'Show recommendation without executing')
   .action((feature, options) => scopeEscalateCommand(feature, options));
 
+// Agent management commands (CRUD)
+const agentCommand = program
+  .command('agent')
+  .description('Manage agents in agents.json (list, show, add, edit, remove)');
+
+agentCommand
+  .command('list')
+  .description('List all agents with optional filters')
+  .option('--group <name>', 'Filter by group')
+  .option('--tier <n>', 'Filter by tier (1-4)')
+  .option('--json', 'Output as JSON')
+  .action((options) => agentListCommand(options));
+
+agentCommand
+  .command('show <id>')
+  .description('Show detailed info for an agent')
+  .option('--json', 'Output as JSON')
+  .option('--full', 'Show full spawn_prompt (no truncation)')
+  .action((id, options) => agentShowCommand(id, options));
+
+agentCommand
+  .command('add <id>')
+  .description('Add a new agent via interactive wizard')
+  .option('--non-interactive', 'Use flags instead of prompts')
+  .option('--tier <n>', 'Tier (1-4)')
+  .option('--title <title>', 'Agent title')
+  .option('--group <group>', 'Agent group')
+  .option('--active-phases <phases>', 'Comma-separated phases or *')
+  .option('--reports-to <id>', 'Parent agent ID or "user"')
+  .option('--domains <domains>', 'Comma-separated domains')
+  .option('--keywords <keywords>', 'Comma-separated keywords')
+  .option('--spawn-prompt <prompt>', 'Teammate spawn prompt')
+  .option('--role <role>', 'Teammate role')
+  .option('--icon <emoji>', 'Teammate icon')
+  .action((id, options) => agentAddCommand(id, options));
+
+agentCommand
+  .command('edit <id>')
+  .description('Edit agent fields via flags')
+  .option('--tier <n>', 'New tier')
+  .option('--title <title>', 'New title')
+  .option('--group <group>', 'New group')
+  .option('--active-phases <phases>', 'New phases (comma-sep)')
+  .option('--reports-to <id>', 'New reports_to')
+  .option('--keywords <keywords>', 'New keywords (comma-sep)')
+  .option('--domains <domains>', 'New domains (comma-sep)')
+  .option('--spawn-prompt <prompt>', 'New spawn prompt')
+  .action((id, options) => agentEditCommand(id, options));
+
+agentCommand
+  .command('remove <id>')
+  .description('Remove an agent from agents.json')
+  .option('--force', 'Skip confirmation prompt')
+  .action((id, options) => agentRemoveCommand(id, options));
+
 program.parse();

package/bin/task-manager.js

@@ -13,7 +13,7 @@ import { access } from 'fs/promises';
 import { execSync } from 'child_process';
 import chalk from 'chalk';
 
-import { loadState, saveState } from '../src/core/state/state-manager.js';
+import { loadState, saveState, resolveAgentForTask, updateDispatchAgentTiming } from '../src/core/state/state-manager.js';
 import { parseTasksMd, ensureTaskList, syncCounters } from '../src/lib/tasks/task-parser.js';
 import { isTestTask } from '../src/lib/tasks/task-classifier.js';
 import { runTestSuite } from '../src/lib/tasks/test-runner.js';
@@ -124,6 +124,7 @@ class TaskManager {
     // Persist initial taskList so counters are visible in `state get` even if
     // validation fails later and the completion save never runs.
     syncCounters(feature);
+    feature.updatedAt = new Date().toISOString();
     saveState(state);
 
     const results = [];
@@ -160,7 +161,7 @@ class TaskManager {
 
     // Run validation BEFORE marking tasks as complete
     if (tasksToComplete.length > 0 && !options.skipValidation) {
-      const validationResult = await this.runValidation(featureName);
+      const validationResult = await this.runValidation(featureName, { mode: 'light' });
       if (options.dryRun) {
         console.log(chalk.cyan('\n  ℹ️  Dry-run — tasks NOT marked as complete'));
         return [];
@@ -240,10 +241,14 @@ class TaskManager {
     }
 
     // Mark tasks as completed (only after validation passes)
+    // Mark tasks as completed with agent correlation
     for (const task of tasksToComplete) {
       task.status = 'completed';
       task.completedAt = new Date().toISOString();
-      task.completedBy = 'claude';
+
+      // Resolve agent from dispatch (falls back to 'claude')
+      const agentId = resolveAgentForTask(featureName, task.id);
+      task.completedBy = agentId || 'claude';
 
       results.push(task);
 
@@ -255,6 +260,25 @@ class TaskManager {
       }
     }
 
+    // Update dispatch agent timing for completed tasks
+    const agentCompletions = new Map();
+    for (const task of results) {
+      const aid = task.completedBy;
+      if (aid && aid !== 'claude') {
+        if (!agentCompletions.has(aid)) agentCompletions.set(aid, []);
+        agentCompletions.get(aid).push(task.id);
+      }
+    }
+    for (const [aid, taskIds] of agentCompletions) {
+      const lastDispatch = feature.dispatchLog?.[feature.dispatchLog.length - 1];
+      const dispatchAgent = lastDispatch?.agents?.find(a => a.id === aid);
+      const existing = dispatchAgent?.tasksCompleted || [];
+      updateDispatchAgentTiming(featureName, aid, {
+        completedAt: new Date().toISOString(),
+        tasksCompleted: [...new Set([...existing, ...taskIds])]
+      });
+    }
+
     // Sync v3 counters then compute progress
     syncCounters(feature);
     feature.progress = this.calculateProgress(taskList);
@@ -273,6 +297,7 @@ class TaskManager {
     }
 
     // Persist state (atomic write via state-manager)
+    feature.updatedAt = new Date().toISOString();
     saveState(state);
 
     // Run TaskCompleted agent-teams hook for each completed task (non-blocking)
@@ -335,12 +360,12 @@ class TaskManager {
    * @param {string} featureName - Feature name
    * @returns {{ passed: boolean, validators: Object, passRate: number }}
    */
-  async runValidation(featureName) {
+  async runValidation(featureName, opts = {}) {
     try {
       console.log(chalk.cyan('\n🔍 Running code validation...'));
 
       const { runValidation, formatValidationResults } = await import('../src/lib/validators/validation-runner.js');
-      const result = await runValidation('.', featureName, { verbose: true });
+      const result = await runValidation('.', featureName, { verbose: true, ...opts });
 
       formatValidationResults(result);
 
@@ -498,10 +523,24 @@ class TaskManager {
       console.log(chalk.yellow('⚠️  Checkpoint hooks not available, using legacy validation'));
       try {
         const { runValidation } = await import('../src/lib/validators/validation-runner.js');
-        const result = await runValidation('.', featureName, { verbose: false });
+        const result = await runValidation('.', featureName, { verbose: false, mode: 'full' });
         validationNote = result.passed
           ? ' | Validation: PASSED'
           : ` | Validation: ${result.errors} errors, ${result.warnings} warnings`;
+
+        // Persist checkpoint validation results to disk
+        try {
+          const { persistCheckpointValidation } = await import('../src/lib/validators/checkpoint-persistence.js');
+          persistCheckpointValidation(process.cwd(), featureName, {
+            checkpointNum,
+            timestamp: new Date().toISOString(),
+            passed: result.passed,
+            validators: result.results || {},
+            summary: result.summary || '',
+          });
+        } catch {
+          // Non-blocking
+        }
       } catch {
         // No validation available
       }
@@ -683,7 +722,21 @@ class TaskManager {
 
     task.status = 'in_progress';
     task.startedAt = new Date().toISOString();
+
+    // Agent correlation: resolve which agent is assigned this task from the latest dispatch
+    const agentId = resolveAgentForTask(featureName, taskId);
+    if (agentId) {
+      task.assignedAgent = agentId;
+      // Record agent startedAt only for the first task (don't overwrite)
+      const lastDispatch = feature.dispatchLog?.[feature.dispatchLog.length - 1];
+      const dispatchAgent = lastDispatch?.agents?.find(a => a.id === agentId);
+      if (dispatchAgent && !dispatchAgent.startedAt) {
+        updateDispatchAgentTiming(featureName, agentId, { startedAt: task.startedAt });
+      }
+    }
+
     syncCounters(feature);
+    feature.updatedAt = new Date().toISOString();
 
     saveState(state);
 

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "4.10.6",
+  "version": "4.10.7",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -198,4 +198,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v4.10.6 by Polymorphism Tech*
+*morph-spec v4.10.7 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -203,4 +203,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.10.6 by Polymorphism Tech*
+*morph-spec v4.10.7 by Polymorphism Tech*