@polymorphism-tech/morph-spec 4.18.0 → 4.20.0

package/src/dashboard/scanner/standards-scanner.js

@@ -0,0 +1,26 @@
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+export function scanStandards(frameworkDir, agents) {
+  const standardsJsonPath = join(frameworkDir, 'standards', 'STANDARDS.json');
+  if (!existsSync(standardsJsonPath)) return { version: 'unknown', list: [] };
+  const sJson = JSON.parse(readFileSync(standardsJsonPath, 'utf8'));
+  const refMap = {};
+  for (const agent of agents) {
+    for (const std of agent.standards) {
+      if (!refMap[std.id]) refMap[std.id] = [];
+      refMap[std.id].push({ agentId: agent.id, scope: std.scope, priority: std.priority });
+    }
+  }
+  const list = sJson.standards.map(std => {
+    const mdPath = join(frameworkDir, 'standards', std.path);
+    return {
+      id: std.id, name: std.name, path: std.path, category: std.category,
+      subcategory: std.subcategory || null, tags: std.tags || [],
+      digest: std.digest || '', stacks: std.stacks || [],
+      content: existsSync(mdPath) ? readFileSync(mdPath, 'utf8') : '',
+      referencedBy: refMap[std.id] || [],
+    };
+  });
+  return { version: sJson.version, list };
+}

package/src/dashboard/scanner/state-scanner.js

@@ -0,0 +1,8 @@
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+export function scanState(projectDir) {
+  const statePath = join(projectDir, '.morph', 'state.json');
+  if (!existsSync(statePath)) return null;
+  try { return JSON.parse(readFileSync(statePath, 'utf8')); } catch { return null; }
+}

package/src/dashboard/scanner/workflows-scanner.js

@@ -0,0 +1,18 @@
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join } from 'path';
+
+export function scanWorkflows(frameworkDir) {
+  const dir = join(frameworkDir, 'workflows', 'configs');
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir).filter(f => f.endsWith('.json')).map(f => {
+    const d = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+    return {
+      id: d.id, name: d.name, description: d.description || '',
+      criteria: d.criteria || {}, keywords: d.keywords || [],
+      phases: d.phases || { run: [], skip: [] },
+      pausePoints: d.pausePoints || [],
+      outputs: d.outputs || { required: [], optional: [], skip: [] },
+      priority: d.priority || 0,
+    };
+  });
+}

package/src/dashboard/vite-plugin-morph-data.js

@@ -0,0 +1,17 @@
+import { scanAll } from './scanner/index.js';
+
+const VIRTUAL_MODULE_ID = 'virtual:morph-data';
+const RESOLVED_VIRTUAL_ID = '\0' + VIRTUAL_MODULE_ID;
+
+export default function morphDataPlugin(frameworkDir, projectDir) {
+  return {
+    name: 'vite-plugin-morph-data',
+    resolveId(id) { if (id === VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_ID; },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_ID) {
+        const data = scanAll(frameworkDir, projectDir);
+        return `export default ${JSON.stringify(data)}`;
+      }
+    },
+  };
+}

package/src/dashboard/vite.config.js

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import morphDataPlugin from './vite-plugin-morph-data.js';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const frameworkDir = resolve(__dirname, '..', '..', 'framework');
+const projectDir = process.env.MORPH_PROJECT_DIR || process.cwd();
+
+export default defineConfig({
+  root: __dirname,
+  plugins: [
+    react(),
+    tailwindcss(),
+    morphDataPlugin(frameworkDir, projectDir),
+  ],
+  server: {
+    port: 3200,
+  },
+});

package/src/lib/checkpoints/checkpoint-hooks.js

@@ -48,7 +48,8 @@ export async function runCheckpointHooks(featureName, checkpointNum, opts = {})
       passed: valResult.passed,
       errors: valResult.errors,
       warnings: valResult.warnings,
-      details: valResult.results
+      details: valResult.results,
+      scores: valResult.scores || null
     };
     totalErrors += valResult.errors;
     totalWarnings += valResult.warnings;

package/src/lib/contracts/sprint-contract-generator.js

@@ -0,0 +1,137 @@
+/**
+ * Sprint Contract Generator
+ *
+ * Generates sprint contracts from tasks.md + spec.md for the evaluator.
+ * Contracts define objective "definition of done" criteria.
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { getBuildCommand } from '../../../framework/hooks/shared/build-check.js';
+
+/**
+ * Parse a task entry from tasks.md markdown.
+ *
+ * Expected format: ## T001: Task Title [FR001, FR003]
+ *
+ * @param {string} content - tasks.md content
+ * @param {string} taskId - Task ID (e.g., 'T001')
+ * @returns {{ id: string, title: string, frs: string[], description: string }|null}
+ */
+export function parseTaskFromMarkdown(content, taskId) {
+  const pattern = new RegExp(
+    `##\\s+${taskId}:\\s+(.+?)(?:\\s+\\[([^\\]]+)\\])?\\s*\\n([\\s\\S]*?)(?=\\n##\\s|$)`,
+    'i'
+  );
+  const match = content.match(pattern);
+  if (!match) return null;
+
+  const title = match[1].trim();
+  const frString = match[2] || '';
+  const description = match[3].trim();
+
+  const frs = frString
+    ? frString.split(',').map(fr => fr.trim()).filter(Boolean)
+    : [];
+
+  return { id: taskId, title, frs, description };
+}
+
+/**
+ * Generate a sprint contract for a task.
+ *
+ * @param {string} projectPath - Project root
+ * @param {string} featureName - Feature name
+ * @param {string} taskId - Task ID
+ * @returns {Object|null} Contract object or null if unable to generate
+ */
+export function generateSprintContract(projectPath, featureName, taskId) {
+  const featureDir = join(projectPath, '.morph/features', featureName);
+  const tasksPath = join(featureDir, '4-tasks/tasks.md');
+
+  if (!existsSync(tasksPath)) return null;
+
+  const tasksContent = readFileSync(tasksPath, 'utf-8');
+  const task = parseTaskFromMarkdown(tasksContent, taskId);
+  if (!task) return null;
+
+  // Read spec for FR-based criteria
+  const specPath = join(featureDir, '2-design/spec.md');
+  let definitionOfDone = [];
+  if (task.frs.length > 0 && existsSync(specPath)) {
+    const specContent = readFileSync(specPath, 'utf-8');
+    for (const fr of task.frs) {
+      const frPattern = new RegExp(`##\\s+${fr}[:\\s]([\\s\\S]*?)(?=\\n##\\s|$)`, 'i');
+      const frMatch = specContent.match(frPattern);
+      if (frMatch) {
+        const bullets = frMatch[1].match(/^[\s]*[-*]\s+(.+)/gm);
+        if (bullets) {
+          definitionOfDone.push(...bullets.map(b => b.replace(/^[\s]*[-*]\s+/, '').trim()));
+        }
+      }
+    }
+  }
+
+  if (definitionOfDone.length === 0) {
+    definitionOfDone = [task.description || `Complete ${task.title}`];
+  }
+
+  // Read stack for build commands
+  let stack = '';
+  try {
+    const configPath = join(projectPath, '.morph/config/config.json');
+    if (existsSync(configPath)) {
+      const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+      stack = config?.project?.stack || '';
+    }
+  } catch { /* ignore */ }
+
+  const hasTsConfig = existsSync(join(projectPath, 'tsconfig.json'));
+  const buildCmd = getBuildCommand(stack, hasTsConfig);
+
+  const contract = {
+    task: taskId,
+    title: task.title,
+    functionalRequirements: task.frs,
+    definitionOfDone,
+    verification: {
+      build: buildCmd || 'echo "No build command configured"',
+      test: stack.includes('dotnet') ? `dotnet test --filter ${task.title.replace(/\s+/g, '')}` : 'npm test',
+      e2e: null
+    },
+    maxAttempts: 3,
+    generatedAt: new Date().toISOString()
+  };
+
+  // Write contract to disk
+  const contractsDir = join(featureDir, '5-implement/contracts');
+  mkdirSync(contractsDir, { recursive: true });
+  const yamlContent = contractToYaml(contract);
+  writeFileSync(join(contractsDir, `${taskId}-contract.yaml`), yamlContent, 'utf-8');
+
+  return contract;
+}
+
+/**
+ * Simple YAML serializer for contracts (no dependency needed).
+ *
+ * @param {Object} contract - Contract object
+ * @returns {string} YAML string
+ */
+function contractToYaml(contract) {
+  const lines = [
+    `task: ${contract.task}`,
+    `title: "${contract.title}"`,
+    `functionalRequirements:`,
+    ...contract.functionalRequirements.map(fr => `  - ${fr}`),
+    `definitionOfDone:`,
+    ...contract.definitionOfDone.map(d => `  - "${d}"`),
+    `verification:`,
+    `  build: "${contract.verification.build}"`,
+    `  test: "${contract.verification.test}"`,
+    `  e2e: ${contract.verification.e2e ? `"${contract.verification.e2e}"` : 'null'}`,
+    `maxAttempts: ${contract.maxAttempts}`,
+    `generatedAt: "${contract.generatedAt}"`,
+  ];
+  return lines.join('\n') + '\n';
+}

package/src/lib/generators/recap-generator.js

@@ -179,6 +179,21 @@ function buildRecapMarkdown(data) {
     md += `> Verify actual build status with the commands in the section below.\n\n`;
   }
 
+  // Score Breakdown (when rubric scoring is available)
+  if (validationResult.scores) {
+    const scores = validationResult.scores;
+    md += `### Quality Score: ${scores.score}/10\n\n`;
+    md += `| Category | Score | Weight | Status |\n|----------|-------|--------|--------|\n`;
+    const approveThreshold = scores.approveThreshold ?? 8.0;
+    for (const [category, data] of Object.entries(scores.breakdown)) {
+      if (category === '_unmapped') continue;
+      const pct = Math.round(data.weight * 100);
+      const status = data.score >= approveThreshold ? 'Pass' : data.score >= 6 ? 'Needs work' : 'Critical';
+      md += `| ${category} | ${Math.round(data.score * 10) / 10}/10 | ${pct}% | ${status} |\n`;
+    }
+    md += `\n`;
+  }
+
   // Suggested Quality Verification
   const agents = agentsSummary;
   const hasNextjs = agents.some(a => ['nextjs-expert', 'css-specialist', 'ui-designer'].includes(a));

package/src/lib/installers/mcp-installer.js

@@ -148,6 +148,31 @@ export async function installAutoMcps(targetPath, mcpsToInstall) {
   return installMcpServers(targetPath, servers);
 }
 
+/**
+ * Install companion skills for MCPs that define them (e.g., Stitch agent skills).
+ * Reads the `companionSkills` field from registry entries and runs the install command.
+ * @param {Object} mcpsInstalled - Map of mcpName → mcpEntry that were just installed
+ * @param {Function} exec - execSync function (for testing)
+ * @returns {Array<{name: string, repo: string, success: boolean}>}
+ */
+export function installCompanionSkills(mcpsInstalled, exec = execSync) {
+  const results = [];
+
+  for (const [name, entry] of Object.entries(mcpsInstalled)) {
+    const companion = entry.companionSkills;
+    if (!companion?.installCommand) continue;
+
+    try {
+      exec(companion.installCommand, { stdio: 'inherit', timeout: 30000 });
+      results.push({ name, repo: companion.repo, success: true });
+    } catch {
+      results.push({ name, repo: companion.repo, success: false });
+    }
+  }
+
+  return results;
+}
+
 /**
  * Install a single MCP with provided credentials
  * @param {string} targetPath - Project root directory

package/src/lib/validators/score-aggregator.js

@@ -0,0 +1,244 @@
+/**
+ * MORPH-SPEC Score Aggregator
+ *
+ * Converts pass/fail validator results into weighted scores using rubric definitions.
+ * Produces prioritized feedback for the retry loop.
+ *
+ * @module score-aggregator
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/** Fallback rubric when none is configured or found. */
+const FALLBACK_RUBRIC = {
+  id: 'fallback',
+  version: '1.0.0',
+  categories: {
+    general: {
+      weight: 1.0,
+      validators: [],
+      description: 'All validators (fallback — no rubric configured)'
+    }
+  },
+  thresholds: { approve: 8.0, retry: 6.0 }
+};
+
+/**
+ * Load a rubric by ID from the project or framework directory.
+ *
+ * Search order:
+ *   1. .morph/framework/rubrics/{rubricId}.json  (installed in project)
+ *   2. npm package path  (node_modules/@polymorphism-tech/morph-spec/framework/rubrics/)
+ *   3. Local dev path  (framework/rubrics/ relative to this module)
+ *
+ * @param {string} projectPath - Project root
+ * @param {string} rubricId - Rubric identifier (e.g. 'default', 'frontend', 'backend')
+ * @returns {Object} Parsed rubric object
+ */
+export function loadRubric(projectPath, rubricId = 'default') {
+  const filename = `${rubricId}.json`;
+
+  const candidates = [
+    join(projectPath, '.morph', 'framework', 'rubrics', filename),
+    join(projectPath, 'node_modules', '@polymorphism-tech', 'morph-spec', 'framework', 'rubrics', filename),
+    join(__dirname, '..', '..', '..', 'framework', 'rubrics', filename)
+  ];
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      try {
+        return JSON.parse(readFileSync(candidate, 'utf8'));
+      } catch {
+        // Corrupted file — try next candidate
+      }
+    }
+  }
+
+  return FALLBACK_RUBRIC;
+}
+
+/**
+ * Score a single validator result.
+ *
+ * Scoring formula:
+ *   - Base score: 10
+ *   - Each error:   -2  (min 0)
+ *   - Each warning: -1  (min 0)
+ *
+ * @param {Object} validatorResult - { passed: boolean, issues?: Array, error?: string }
+ * @returns {number} Score 0–10
+ */
+export function scoreValidator(validatorResult) {
+  if (!validatorResult) return 10; // Validator didn't run — assume clean
+
+  // Validator threw an error — can't assess
+  if (validatorResult.error) return 5;
+
+  const errors = (validatorResult.issues || []).filter(i => i.level === 'error').length;
+  const warnings = (validatorResult.issues || []).filter(i => i.level === 'warning').length;
+
+  return Math.max(0, 10 - (errors * 2) - (warnings * 1));
+}
+
+/**
+ * Build a reverse map: validatorId → category name.
+ * Validators not mapped to any category go into '_unmapped'.
+ *
+ * @param {Object} rubric
+ * @returns {Map<string, string>}
+ */
+function buildValidatorCategoryMap(rubric) {
+  const map = new Map();
+  for (const [categoryName, category] of Object.entries(rubric.categories)) {
+    for (const validatorId of category.validators || []) {
+      map.set(validatorId, categoryName);
+    }
+  }
+  return map;
+}
+
+/**
+ * Aggregate validator results into weighted scores using a rubric.
+ *
+ * @param {Object} validationResult - From validation-runner.js: { passed, errors, warnings, issues, results }
+ * @param {Object} rubric - Loaded rubric object
+ * @param {Object} [configOverrides] - Optional threshold overrides from config.json
+ * @param {number} [configOverrides.approve] - Override approve threshold
+ * @param {number} [configOverrides.retry] - Override retry threshold
+ * @returns {{
+ *   score: number,
+ *   action: 'approve' | 'retry' | 'escalate',
+ *   breakdown: Object,
+ *   priorityFixes: Array<{ category: string, score: number, weight: number, deficit: number, issues: Array }>
+ * }}
+ */
+export function aggregateScores(validationResult, rubric, configOverrides = {}) {
+  const results = validationResult.results || {};
+  const validatorCategoryMap = buildValidatorCategoryMap(rubric);
+
+  // Collect scores per category
+  const breakdown = {};
+  const unmappedScores = [];
+
+  for (const [categoryName, category] of Object.entries(rubric.categories)) {
+    const mappedValidators = (category.validators || []).filter(v => results[v] !== undefined);
+    const scores = mappedValidators.map(v => scoreValidator(results[v]));
+
+    breakdown[categoryName] = {
+      score: scores.length > 0 ? scores.reduce((a, b) => a + b, 0) / scores.length : 10,
+      weight: category.weight,
+      validators: mappedValidators,
+      issues: mappedValidators.flatMap(v => (results[v]?.issues || []))
+    };
+  }
+
+  // Handle validators not mapped to any rubric category
+  for (const [validatorId, result] of Object.entries(results)) {
+    if (!validatorCategoryMap.has(validatorId)) {
+      unmappedScores.push(scoreValidator(result));
+    }
+  }
+
+  // Handle unmapped validators
+  if (unmappedScores.length > 0) {
+    const unmappedIds = Object.keys(results).filter(id => !validatorCategoryMap.has(id));
+    if (Object.keys(breakdown).length === 0) {
+      // No categories at all — put everything in 'general'
+      breakdown.general = {
+        score: unmappedScores.reduce((a, b) => a + b, 0) / unmappedScores.length,
+        weight: 1.0,
+        validators: unmappedIds,
+        issues: unmappedIds.flatMap(id => results[id]?.issues || [])
+      };
+    } else {
+      // Categories exist but some validators aren't mapped — add as low-weight 'other'
+      const unmappedAvg = unmappedScores.reduce((a, b) => a + b, 0) / unmappedScores.length;
+      breakdown._unmapped = {
+        score: unmappedAvg,
+        weight: 0.05,
+        validators: unmappedIds,
+        issues: unmappedIds.flatMap(id => results[id]?.issues || [])
+      };
+    }
+  }
+
+  // Calculate weighted final score
+  const totalWeight = Object.values(breakdown).reduce((sum, cat) => sum + cat.weight, 0);
+  const weightedScore = totalWeight > 0
+    ? Object.values(breakdown).reduce((sum, cat) => sum + (cat.score * cat.weight), 0) / totalWeight
+    : 10;
+
+  // Round to 1 decimal
+  const score = Math.round(weightedScore * 10) / 10;
+
+  // Determine action
+  const approveThreshold = configOverrides.approve ?? rubric.thresholds?.approve ?? 8.0;
+  const retryThreshold = configOverrides.retry ?? rubric.thresholds?.retry ?? 6.0;
+
+  let action;
+  if (score >= approveThreshold) {
+    action = 'approve';
+  } else if (score >= retryThreshold) {
+    action = 'retry';
+  } else {
+    action = 'escalate';
+  }
+
+  // Build priority fixes — sorted by impact (weight * deficit from 10)
+  const priorityFixes = Object.entries(breakdown)
+    .filter(([, cat]) => cat.issues.length > 0)
+    .map(([categoryName, cat]) => ({
+      category: categoryName,
+      score: Math.round(cat.score * 10) / 10,
+      weight: cat.weight,
+      deficit: Math.round((10 - cat.score) * cat.weight * 10) / 10,
+      issues: cat.issues
+    }))
+    .sort((a, b) => b.deficit - a.deficit);
+
+  return { score, action, breakdown, priorityFixes, approveThreshold };
+}
+
+/**
+ * Format score breakdown as a human-readable string for hook injection.
+ *
+ * @param {Object} scoreResult - From aggregateScores()
+ * @param {number} [approveThreshold] - For display
+ * @returns {string}
+ */
+export function formatScoreBreakdown(scoreResult, approveThreshold = 8.0) {
+  const lines = [];
+
+  lines.push(`Score: ${scoreResult.score}/10 (threshold: ${approveThreshold})`);
+  lines.push('');
+
+  if (scoreResult.priorityFixes.length > 0) {
+    lines.push('Priority fixes (by impact):');
+    for (let i = 0; i < scoreResult.priorityFixes.length; i++) {
+      const fix = scoreResult.priorityFixes[i];
+      const topIssue = fix.issues[0];
+      const issueText = topIssue
+        ? `${topIssue.message}${topIssue.file ? ` (${topIssue.file}${topIssue.line ? ':' + topIssue.line : ''})` : ''}`
+        : 'Issues detected';
+      lines.push(`${i + 1}. [${fix.category}: ${fix.score}/10] ${issueText}`);
+      // Show additional issues count if more than 1
+      if (fix.issues.length > 1) {
+        lines.push(`   ... and ${fix.issues.length - 1} more issue(s) in this category`);
+      }
+    }
+    lines.push('');
+  }
+
+  lines.push('Score breakdown:');
+  for (const [category, data] of Object.entries(scoreResult.breakdown)) {
+    const pct = Math.round(data.weight * 100);
+    const indicator = data.score >= approveThreshold ? '\u2713' : data.score >= 6 ? '\u2193 needs work' : '\u2193\u2193 critical';
+    lines.push(`  ${category}: ${Math.round(data.score * 10) / 10}/10 (weight ${pct}%) ${indicator}`);
+  }
+
+  return lines.join('\n');
+}

package/src/lib/validators/validation-runner.js

@@ -13,6 +13,7 @@ import chalk from 'chalk';
 import { loadState } from '../../core/state/state-manager.js';
 import { getAbsoluteOutputPath, resolveContractsOutputType } from '../../core/paths/output-schema.js';
 import { getStackProfile } from '../stack/stack-profile.js';
+import { aggregateScores, loadRubric } from './score-aggregator.js';
 
 /** Validators that only make sense for .NET projects. */
 const DOTNET_ONLY_VALIDATORS = new Set([
@@ -172,6 +173,17 @@ export async function runValidation(projectPath, featureName, options = {}) {
     ? `✅ All validations passed (${result.warnings} warnings)`
     : `❌ ${result.errors} error(s), ${result.warnings} warning(s)`;
 
+  // Score aggregation — layered on top of pass/fail
+  try {
+    const rubricId = readRubricConfig(projectPath);
+    const rubric = loadRubric(projectPath, rubricId);
+    const thresholdOverrides = readThresholdConfig(projectPath);
+    result.scores = aggregateScores(result, rubric, thresholdOverrides);
+  } catch {
+    // Score aggregation is non-blocking — if it fails, pass/fail still works
+    result.scores = null;
+  }
+
   return result;
 }
 
@@ -303,3 +315,35 @@ export function formatValidationResults(result) {
 
   console.log('');
 }
+
+/**
+ * Read rubric ID from project config.
+ * @param {string} projectPath
+ * @returns {string}
+ */
+function readRubricConfig(projectPath) {
+  try {
+    const configPath = join(projectPath, '.morph', 'config', 'config.json');
+    if (!existsSync(configPath)) return 'default';
+    const config = JSON.parse(readFileSync(configPath, 'utf8'));
+    return config.validation?.rubric ?? 'default';
+  } catch {
+    return 'default';
+  }
+}
+
+/**
+ * Read threshold overrides from project config.
+ * @param {string} projectPath
+ * @returns {Object} { approve?: number, retry?: number }
+ */
+function readThresholdConfig(projectPath) {
+  try {
+    const configPath = join(projectPath, '.morph', 'config', 'config.json');
+    if (!existsSync(configPath)) return {};
+    const config = JSON.parse(readFileSync(configPath, 'utf8'));
+    return config.validation?.thresholds ?? {};
+  } catch {
+    return {};
+  }
+}

package/src/scripts/setup-infra.js

@@ -227,6 +227,14 @@ export async function setupInfra(targetPath, { _exec = execSync, reinstall = fal
     await copyDirectory(hooksSrc, hooksDest);
   }
 
+  // --- 7b. Copy framework/rubrics → .morph/framework/rubrics ---
+  log('Step 7b: Copying rubrics...');
+  const rubricsSrc = join(FRAMEWORK_DIR, 'rubrics');
+  const rubricsDest = join(frameworkDestDir, 'rubrics');
+  if (await pathExists(rubricsSrc)) {
+    await copyDirectory(rubricsSrc, rubricsDest);
+  }
+
   // --- 8. Copy framework/agents.json → .morph/framework/agents.json ---
   log('Step 8: Copying agents.json...');
   const agentsSrc = join(FRAMEWORK_DIR, 'agents.json');

package/src/utils/hooks-installer.js

@@ -15,7 +15,7 @@ import { homedir } from 'os';
 import { execSync } from 'child_process';
 
 /** Current hooks schema version — bump when hook definitions change */
-const HOOKS_VERSION = '2.14.0';
+const HOOKS_VERSION = '3.0.0';
 
 /** Marker for old dispatch.js (v1) */
 const OLD_DISPATCH_COMMAND = 'node framework/hooks/agent-teams/dispatch.js';
@@ -155,6 +155,17 @@ Otherwise respond: {"ok": true}`
     ]
   },
 
+  // === PostToolUse: All — loop detection ===
+  {
+    event: 'PostToolUse',
+    matcher: null,
+    hooks: [{
+      type: 'command',
+      command: 'node framework/hooks/claude-code/post-tool-use/loop-detect.js',
+      timeout: 5000
+    }]
+  },
+
   // === Stop ===
   {
     event: 'Stop',