@polymorphism-tech/morph-spec 4.18.0 → 4.19.0

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/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/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',