@polymorphism-tech/morph-spec 4.10.5 → 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.5  
+**Version:** 4.10.7  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -358,7 +358,7 @@ npm install -g @polymorphism-tech/morph-spec
 
 ### Hook not triggering on SessionStart
 
-Ensure `.claude/settings.local.json` is not gitignored in your project. The file must be present for Claude Code to load hooks. If it is missing, re-run `morph-spec init --force`.
+Ensure `.claude/settings.local.json` is not gitignored in your project. The file must be present for Claude Code to load hooks. If it is missing, re-run `morph-spec setup-infra` or `morph-spec init --force`.
 
 ---
 
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.10.5 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.5",
+  "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.5 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.5 by Polymorphism Tech*
+*morph-spec v4.10.7 by Polymorphism Tech*

package/framework/agents/backend/hangfire-orchestrator.md

@@ -3,7 +3,7 @@ name: hangfire-orchestrator
 description: Hangfire Orchestrator specialist for background job design, recurring task scheduling, queue management, and idempotent job patterns in .NET. Use when implementing background jobs, scheduling recurring tasks, managing job queues, or integrating Hangfire with .NET services.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 stacks:
-  - dotnet
+  - hangfire
 ---
 
 # Hangfire Orchestrator

package/framework/agents/backend/ms-agent-expert.md

@@ -3,7 +3,8 @@ name: ms-agent-expert
 description: Microsoft Agent Framework Expert for Semantic Kernel, AI extensions, function calling, MCP/A2A protocols, and agentic pipeline implementation. Use when building AI agents with Semantic Kernel, implementing tool/plugin calling, designing multi-agent workflows, or integrating LLMs with .NET services.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 stacks:
-  - dotnet
+  - semantic-kernel
+  - ms-agents
 ---
 
 # Agent Framework Expert

package/framework/agents/integrations/asaas-financial.md

@@ -3,7 +3,7 @@ name: asaas-financial
 description: Asaas Financial specialist for Asaas API integration, payment processing, Pix/boleto billing, and subscription management in Brazilian projects. Use when integrating Asaas payments, implementing billing flows, handling payment webhooks, or building subscription management features.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 stacks:
-  - dotnet
+  - asaas
 ---
 
 # Asaas Financial

package/framework/agents/integrations/clerk-auth.md

@@ -3,8 +3,7 @@ name: clerk-auth
 description: Clerk Auth specialist for Clerk SDK integration, social login, JWT session management, and user management in Next.js and .NET projects. Use when integrating Clerk authentication, implementing social login flows, managing user sessions with Clerk JWT, or protecting routes with Clerk middleware.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 stacks:
-  - dotnet
-  - nextjs
+  - clerk
 ---
 
 # Clerk Auth

package/framework/agents/integrations/hangfire-integration.md

@@ -3,7 +3,7 @@ name: hangfire-orchestrator-integration
 description: Hangfire integration specialist for connecting background jobs with external services, implementing webhook handlers, and building event-driven workflows in .NET. Use when integrating Hangfire with third-party APIs, processing webhooks asynchronously, or designing event-driven job pipelines.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 stacks:
-  - dotnet
+  - hangfire
 ---
 
 # Hangfire Orchestrator

package/framework/agents/integrations/resend-email.md

@@ -3,7 +3,7 @@ name: resend-email
 description: Resend Email specialist for transactional email, HTML/React email templates, Resend API integration, and notification systems in .NET and Next.js. Use when implementing email notifications, integrating Resend API, creating transactional email templates, or configuring email delivery in MORPH-SPEC projects.
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 stacks:
-  - dotnet
+  - resend
 ---
 
 # Resend Email