@polymorphism-tech/morph-spec 4.3.7 → 4.6.0

package/framework/hooks/agent-stop/validate-and-continue.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-/**
- * Stop Hook: validate-and-continue
- *
- * Runs architecture and security validators.
- * Writes structured JSON to stdout for stop-hook-executor to parse.
- *
- * Output format:
- * {
- *   "passed": boolean,
- *   "issues": [{ "message": string, "severity": "error"|"warning" }],
- *   "suggestions": [string],
- *   "error": string | null
- * }
- */
-
-import { execSync } from 'child_process';
-import { existsSync } from 'fs';
-import { join } from 'path';
-
-const VALIDATORS = ['architecture', 'security'];
-const cwd = process.cwd();
-
-async function runValidators() {
-  const issues = [];
-  const suggestions = [];
-  let allPassed = true;
-
-  for (const validator of VALIDATORS) {
-    try {
-      const validateBin = join(cwd, 'bin/validate.js');
-      if (!existsSync(validateBin)) {
-        // Validator binary not found — skip gracefully
-        suggestions.push(`Install morph-spec validator: bin/validate.js not found`);
-        continue;
-      }
-
-      const result = execSync(
-        `node "${validateBin}" ${validator} --json --quiet`,
-        { encoding: 'utf8', stdio: 'pipe', cwd, timeout: 60000 }
-      );
-
-      const parsed = JSON.parse(result);
-      if (parsed.errors > 0) {
-        allPassed = false;
-        (parsed.issues || []).forEach(issue => {
-          if (issue.severity === 'error') {
-            issues.push({ message: `[${validator}] ${issue.message}`, severity: 'error' });
-          }
-        });
-      }
-
-      if (parsed.warnings > 0) {
-        (parsed.issues || []).forEach(issue => {
-          if (issue.severity === 'warning') {
-            issues.push({ message: `[${validator}] ${issue.message}`, severity: 'warning' });
-          }
-        });
-      }
-    } catch (err) {
-      // If validator fails to run, report as warning but don't block
-      issues.push({
-        message: `[${validator}] Validator execution failed: ${err.message}`,
-        severity: 'warning'
-      });
-      suggestions.push(`Run manually: node bin/validate.js ${validator}`);
-    }
-  }
-
-  if (!allPassed && issues.some(i => i.severity === 'error')) {
-    suggestions.push('Fix architecture and security violations before continuing');
-    suggestions.push('See framework/standards/architecture.md for patterns');
-  }
-
-  const output = {
-    passed: allPassed,
-    validatorsRun: VALIDATORS,
-    issues,
-    suggestions,
-    timestamp: new Date().toISOString(),
-    error: null
-  };
-
-  process.stdout.write(JSON.stringify(output));
-  process.exit(allPassed ? 0 : 1);
-}
-
-runValidators().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-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();