@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/framework/hooks/agent-stop/validate-checkpoints.js

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-/**
- * Stop Hook: validate-checkpoints
- *
- * Checks that the last 3 tasks passed their checkpoints.
- * Reads from state.json checkpoint history.
- *
- * Output format: { passed, issues, suggestions, checkpointSummary, error }
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-const cwd = process.cwd();
-const REQUIRED_PASSING = 3;
-
-function validateCheckpoints() {
-  const statePath = join(cwd, '.morph/state.json');
-
-  if (!existsSync(statePath)) {
-    process.stdout.write(JSON.stringify({
-      passed: true,
-      issues: [],
-      suggestions: ['State file not found — checkpoint validation skipped'],
-      checkpointSummary: null,
-      error: null
-    }));
-    process.exit(0);
-  }
-
-  let state;
-  try {
-    state = JSON.parse(readFileSync(statePath, 'utf8'));
-  } catch (err) {
-    process.stdout.write(JSON.stringify({
-      passed: false,
-      issues: [{ message: `Failed to read state.json: ${err.message}`, severity: 'error' }],
-      suggestions: [],
-      error: err.message
-    }));
-    process.exit(1);
-  }
-
-  // Find all features with checkpoints
-  const features = Object.entries(state.features || {});
-  const issues = [];
-  const suggestions = [];
-  let allPassed = true;
-
-  for (const [featureName, feature] of features) {
-    if (feature.phase !== 'implement') continue;
-
-    const checkpoints = feature.checkpoints || [];
-    const recentCheckpoints = checkpoints.slice(-REQUIRED_PASSING);
-
-    if (recentCheckpoints.length === 0) {
-      // No checkpoints yet — pass
-      continue;
-    }
-
-    const failedRecent = recentCheckpoints.filter(c => c.passed === false);
-    if (failedRecent.length > 0) {
-      allPassed = false;
-      issues.push({
-        message: `Feature ${featureName}: ${failedRecent.length} recent checkpoint(s) failed`,
-        severity: 'error'
-      });
-      suggestions.push(`Review checkpoint failures in ${featureName} before continuing`);
-    }
-  }
-
-  const checkpointSummary = features.map(([name, f]) => ({
-    feature: name,
-    totalCheckpoints: f.checkpoints?.length || 0,
-    recentPassed: (f.checkpoints || []).slice(-3).filter(c => c.passed !== false).length
-  }));
-
-  const output = {
-    passed: allPassed,
-    issues,
-    suggestions,
-    checkpointSummary,
-    timestamp: new Date().toISOString(),
-    error: null
-  };
-
-  process.stdout.write(JSON.stringify(output));
-  process.exit(allPassed ? 0 : 1);
-}
-
-try {
-  validateCheckpoints();
-} catch (err) {
-  process.stdout.write(JSON.stringify({
-    passed: false,
-    issues: [{ message: err.message, severity: 'error' }],
-    suggestions: [],
-    error: err.message
-  }));
-  process.exit(1);
-}

package/framework/hooks/agent-stop/validate-tests.js

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-/**
- * Stop Hook: validate-tests
- *
- * Runs the project test suite (if available) and returns results.
- * Gracefully handles projects without tests.
- *
- * Output format: { passed, issues, suggestions, testResults, error }
- */
-
-import { execSync } from 'child_process';
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-
-const cwd = process.cwd();
-
-function validateTests() {
-  // Check if test runner is configured
-  let pkgJson;
-  try {
-    pkgJson = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
-  } catch {
-    process.stdout.write(JSON.stringify({
-      passed: true,
-      issues: [],
-      suggestions: ['No package.json found — test validation skipped'],
-      testResults: null,
-      error: null
-    }));
-    process.exit(0);
-  }
-
-  const hasTestScript = pkgJson.scripts?.test && !pkgJson.scripts.test.includes('no test specified');
-  const hasVitest = pkgJson.dependencies?.vitest || pkgJson.devDependencies?.vitest;
-  const hasJest = pkgJson.dependencies?.jest || pkgJson.devDependencies?.jest;
-
-  if (!hasTestScript && !hasVitest && !hasJest) {
-    process.stdout.write(JSON.stringify({
-      passed: true,
-      issues: [],
-      suggestions: ['No test runner configured — consider adding vitest or jest'],
-      testResults: { skipped: true, reason: 'No test runner found' },
-      error: null
-    }));
-    process.exit(0);
-  }
-
-  try {
-    const testCmd = hasVitest ? 'npx vitest run' : (hasJest ? 'npx jest' : 'npm test');
-    const output = execSync(`${testCmd} --passWithNoTests`, {
-      encoding: 'utf8',
-      stdio: 'pipe',
-      cwd,
-      timeout: 300000 // 5 minutes for tests
-    });
-
-    // Parse test results from output
-    const passedMatch = output.match(/(\d+)\s+passed/);
-    const failedMatch = output.match(/(\d+)\s+failed/);
-    const skippedMatch = output.match(/(\d+)\s+skipped/);
-
-    const testResults = {
-      passed: parseInt(passedMatch?.[1] || '0'),
-      failed: parseInt(failedMatch?.[1] || '0'),
-      skipped: parseInt(skippedMatch?.[1] || '0'),
-      rawOutput: output.substring(0, 500) // First 500 chars
-    };
-
-    process.stdout.write(JSON.stringify({
-      passed: testResults.failed === 0,
-      issues: testResults.failed > 0
-        ? [{ message: `${testResults.failed} test(s) failed`, severity: 'error' }]
-        : [],
-      suggestions: testResults.failed > 0
-        ? ['Fix failing tests before continuing implementation']
-        : [],
-      testResults,
-      timestamp: new Date().toISOString(),
-      error: null
-    }));
-    process.exit(testResults.failed === 0 ? 0 : 1);
-  } catch (err) {
-    // Extract test failure count from error output
-    const output = err.stdout || err.stderr || err.message;
-    const failedMatch = output.match(/(\d+)\s+failed/);
-    const failed = parseInt(failedMatch?.[1] || '1');
-
-    process.stdout.write(JSON.stringify({
-      passed: false,
-      issues: [{ message: `Test suite failed with ${failed} failure(s)`, severity: 'error' }],
-      suggestions: ['Review test output and fix failing tests', 'Run: npm test locally'],
-      testResults: { failed, rawOutput: output.substring(0, 500) },
-      error: null
-    }));
-    process.exit(1);
-  }
-}
-
-try {
-  validateTests();
-} catch (err) {
-  process.stdout.write(JSON.stringify({
-    passed: false,
-    issues: [{ message: err.message, severity: 'error' }],
-    suggestions: [],
-    error: err.message
-  }));
-  process.exit(1);
-}

package/framework/hooks/agent-teams/dispatch.js

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Agent Teams Hook Dispatcher
- *
- * Reads Claude Code PostToolUse JSON from stdin and dispatches to the
- * appropriate agent-teams hook based on the Bash command content.
- *
- * Wired via .claude/settings.local.json:
- *   "PostToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "node framework/hooks/agent-teams/dispatch.js" }] }]
- *
- * Dispatches:
- *   morph-spec task done <feature> <taskId>  → task-completed.js <feature> <taskId>
- *   morph-spec phase advance <feature>       → phase-advanced.js <feature> <from> <to>
- */
-
-import { execSync } from 'child_process';
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-let input = '';
-process.stdin.setEncoding('utf-8');
-process.stdin.on('data', chunk => { input += chunk; });
-process.stdin.on('end', () => {
-  try {
-    const payload = JSON.parse(input || '{}');
-    const command = payload?.tool_input?.command || '';
-    dispatch(command);
-  } catch {
-    // Non-JSON or empty stdin — ignore silently
-    process.exit(0);
-  }
-});
-
-function dispatch(command) {
-  // morph-spec task done <feature> <taskId> [--skip-validation]
-  const taskDoneMatch = command.match(/morph-spec\s+task\s+done\s+(\S+)\s+(\S+)/);
-  if (taskDoneMatch) {
-    const [, feature, taskId] = taskDoneMatch;
-    run(`node "${join(__dirname, 'task-completed.js')}" ${feature} ${taskId}`);
-    return;
-  }
-
-  // morph-spec phase advance <feature>
-  const phaseAdvanceMatch = command.match(/morph-spec\s+phase\s+advance\s+(\S+)/);
-  if (phaseAdvanceMatch) {
-    const [, feature] = phaseAdvanceMatch;
-    // from/to phases not available at PostToolUse time — use placeholder
-    run(`node "${join(__dirname, 'phase-advanced.js')}" ${feature} unknown advanced`);
-    return;
-  }
-
-  // No match — exit cleanly
-  process.exit(0);
-}
-
-function run(cmd) {
-  try {
-    execSync(cmd, { stdio: 'inherit', cwd: join(__dirname, '../../..') });
-  } catch {
-    // Hook failures are non-blocking for the dispatch layer
-  }
-  process.exit(0);
-}

package/framework/hooks/agent-teams/phase-advanced.js

@@ -1,80 +0,0 @@
-#!/usr/bin/env node
-// Scope: universal | Validates feature outputs when phase is advanced
-// MORPH-SPEC Agent Teams Hook: PhaseAdvanced Event
-
-import { executeHook, formatHookResults } from '../../../src/lib/hooks/hook-executor.js';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Parse arguments
-const args = process.argv.slice(2);
-const [featureName, fromPhase, toPhase] = args.filter(arg => !arg.startsWith('--'));
-
-if (!featureName || !fromPhase || !toPhase) {
-  console.error('Usage: phase-advanced.js <feature> <from-phase> <to-phase> [--dry-run] [--verbose]');
-  console.error('');
-  console.error('Example:');
-  console.error('  node phase-advanced.js user-auth design clarify');
-  process.exit(2);
-}
-
-const dryRun = args.includes('--dry-run');
-const verbose = args.includes('--verbose');
-
-// Project path is 3 levels up from framework/hooks/agent-teams/
-const projectPath = join(__dirname, '../../..');
-
-async function main() {
-  if (verbose) {
-    console.log(`🔍 PhaseAdvanced Hook triggered:`);
-    console.log(`   Feature: ${featureName}`);
-    console.log(`   Transition: ${fromPhase} → ${toPhase}`);
-    console.log(`   Mode: ${dryRun ? 'DRY RUN' : 'LIVE'}`);
-    console.log('');
-  }
-
-  try {
-    const results = await executeHook(projectPath, featureName, 'PhaseAdvanced', {
-      fromPhase,
-      toPhase,
-      dryRun,
-      verbose
-    });
-
-    const output = formatHookResults(results, 'PhaseAdvanced');
-    console.log(output);
-
-    if (results.blocked) {
-      console.error('');
-      console.error('❌ Cannot advance phase - fix errors above');
-      console.error('');
-      console.error('To override (not recommended):');
-      console.error(`  npx morph-spec advance-phase ${featureName} ${toPhase} --skip-validation`);
-      process.exit(1);
-    }
-
-    if (verbose) {
-      console.log('');
-      console.log('✅ Phase advancement validated successfully');
-    }
-
-    process.exit(0);
-  } catch (error) {
-    console.error('');
-    console.error('❌ Hook execution failed:');
-    console.error(`   ${error.message}`);
-
-    if (verbose && error.stack) {
-      console.error('');
-      console.error('Stack trace:');
-      console.error(error.stack);
-    }
-
-    process.exit(1);
-  }
-}
-
-main();

package/framework/hooks/agent-teams/task-completed.js

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-
-// Scope: universal | Task completion validation
-
-/**
- * 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/hooks/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 framework/hooks/agent-teams/)
-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,
-      taskId
-    });
-
-    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/framework/hooks/agent-teams/teammate-idle.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-
-// Scope: universal | Agent Teams idle event validation
-
-/**
- * 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/hooks/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 framework/hooks/agent-teams/)
-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/src/commands/agents/agents-fuse.js

@@ -1,97 +0,0 @@
-/**
- * Agents Fuse CLI command — F-Thread fusion execution
- *
- * Usage:
- *   morph-spec agents fuse --prompt "..." --count=3 --strategy=best-of-n [--feature=<f>]
- *   morph-spec agents review aggregate <feature> --agents=a1,a2,a3
- */
-
-import chalk from 'chalk';
-import { runFusion, aggregateResults, displayFusionSummary } from '../../lib/execution/fusion-executor.js';
-
-export async function agentsFuseCommand(options) {
-  if (!options.prompt) {
-    console.error(chalk.red('--prompt is required'));
-    process.exit(1);
-  }
-
-  const count = parseInt(options.count || '3', 10);
-  const strategy = options.strategy || 'best-of-n';
-  const feature = options.feature || 'fusion-session';
-  const agents = options.agents ? options.agents.split(',').map(a => a.trim()) : null;
-
-  console.log(chalk.cyan(`\n  F-Thread Fusion Execution\n`));
-  console.log(`  Strategy:  ${strategy}`);
-  console.log(`  Agents:    ${count}`);
-  console.log(`  Feature:   ${feature}`);
-  console.log(`  Prompt:    ${options.prompt.substring(0, 80)}${options.prompt.length > 80 ? '...' : ''}`);
-  console.log('');
-
-  try {
-    const fusionSession = await runFusion(options.prompt, {
-      feature,
-      count,
-      strategy,
-      agents
-    });
-
-    console.log(chalk.cyan(`  ${fusionSession.threads.length} fusion threads spawned:\n`));
-    for (let i = 0; i < fusionSession.threads.length; i++) {
-      const thread = fusionSession.threads[i];
-      const agent = fusionSession.agentConfigs[i];
-      console.log(`  ${chalk.gray(thread.id.substring(0, 8))} — Agent: ${agent.agentId} (${thread.status})`);
-    }
-
-    console.log(chalk.yellow('\n  ⚠ Fusion threads spawned. To aggregate results:'));
-    console.log(chalk.gray('  1. Execute each thread using the Task tool with the agent configs'));
-    console.log(chalk.gray('  2. Collect results from each agent'));
-    console.log(chalk.gray('  3. Run: morph-spec agents fuse-aggregate --results=<file> --strategy=' + strategy));
-    console.log('');
-
-    if (options.json) {
-      console.log(JSON.stringify({
-        threads: fusionSession.threads.map(t => ({ id: t.id, agent: t.agent, status: t.status })),
-        agentConfigs: fusionSession.agentConfigs,
-        strategy,
-        feature
-      }, null, 2));
-    }
-  } catch (err) {
-    console.error(chalk.red(`Error: ${err.message}`));
-    process.exit(1);
-  }
-}
-
-export async function agentsReviewAggregateCommand(feature, options) {
-  if (!options.agents) {
-    console.error(chalk.red('--agents is required (comma-separated list)'));
-    process.exit(1);
-  }
-
-  const agentList = options.agents.split(',').map(a => a.trim());
-  const strategy = options.strategy || 'best-of-n';
-
-  console.log(chalk.yellow('\n  ⚠ [STUB] This command returns mock data. Real aggregation not yet implemented.\n'));
-  console.log(chalk.cyan(`  Aggregate Reviews — ${feature}\n`));
-  console.log(`  Agents:   ${agentList.join(', ')}`);
-  console.log(`  Strategy: ${strategy}`);
-  console.log('');
-
-  // Mock results for demo — in real usage, results come from agent output files
-  const mockResults = agentList.map((agentId, i) => ({
-    agentId,
-    content: `Agent ${agentId} review for ${feature}`,
-    checkpointsPassed: Math.floor(Math.random() * 3) + 2,
-    checkpointsFailed: Math.floor(Math.random() * 2),
-    errors: Math.floor(Math.random() * 2),
-    warnings: Math.floor(Math.random() * 3)
-  }));
-
-  try {
-    const aggregated = aggregateResults(mockResults, strategy);
-    displayFusionSummary(aggregated);
-  } catch (err) {
-    console.error(chalk.red(`Error: ${err.message}`));
-    process.exit(1);
-  }
-}