@polymorphism-tech/morph-spec 7.7.3 → 7.8.1

package/src/scripts/setup-infra.js

@@ -1,383 +1,383 @@
-/**
- * setup-infra.js
- *
- * Headless infrastructure setup for MORPH-SPEC.
- * Extracted from init.js (steps 1-10) so it can be called by the
- * /morph-init Claude Code skill via `morph-spec setup-infra` without
- * interactive prompts or stack detection.
- *
- * Usage:
- *   import { setupInfra } from './setup-infra.js';
- *   await setupInfra('/path/to/project');
- */
-
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
-import { readFileSync, readdirSync, copyFileSync, unlinkSync } from 'fs';
-import {
-  copyDirectory,
-  copyFile,
-  pathExists,
-  writeJson,
-  ensureDir,
-  writeFile,
-  updateGitignore
-} from '../utils/file-copier.js';
-import { parseStacks, getProjectTags, shouldInstall } from '../lib/stack-filter.js';
-import { injectMorphImport } from '../utils/claude-md-injector.js';
-import { saveProjectMorphVersion, getInstalledCLIVersion } from '../utils/version-checker.js';
-import { installClaudeHooks, installGlobalStatusline } from '../utils/claude-settings-manager.js';
-import { installSkills } from '../utils/skills-installer.js';
-import { installAgents, installDomainAgents } from '../utils/agents-installer.js';
-
-const FRAMEWORK_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'framework');
-
-const REQUIRED_PLUGINS = [
-  'superpowers@claude-plugins-official',
-  'context7@claude-plugins-official',
-];
-
-async function installRequiredPlugins(log, exec) {
-  log('Step 0: Installing required Claude Code plugins...');
-  for (const plugin of REQUIRED_PLUGINS) {
-    try {
-      exec(`claude plugin install ${plugin}`, { stdio: 'inherit' });
-      log(`  ✓ ${plugin}`);
-    } catch {
-      log(`  ⚠ Failed to install ${plugin} — install manually: claude plugin install ${plugin}`);
-    }
-  }
-}
-
-/**
- * Install only stack-matching rules from rulesSrc to rulesDest.
- * Also removes orphan rules in rulesDest that are no longer in the install set.
- *
- * @param {string} rulesSrc - Source rules directory (framework/rules/)
- * @param {string} rulesDest - Destination rules directory (.claude/rules/)
- * @param {string[]} projectTags - Stack tags from config (e.g., ['dotnet', 'blazor'])
- */
-export function installRulesForStack(rulesSrc, rulesDest, projectTags) {
-  const sourceFiles = readdirSync(rulesSrc).filter(f => f.endsWith('.md'));
-  const installed = new Set();
-
-  for (const file of sourceFiles) {
-    const content = readFileSync(join(rulesSrc, file), 'utf-8');
-    const stacks = parseStacks(content);
-    if (shouldInstall(stacks, projectTags)) {
-      copyFileSync(join(rulesSrc, file), join(rulesDest, file));
-      installed.add(file);
-    }
-  }
-
-  // Cleanup orphans
-  for (const file of readdirSync(rulesDest).filter(f => f.endsWith('.md'))) {
-    if (!installed.has(file)) {
-      unlinkSync(join(rulesDest, file));
-    }
-  }
-}
-
-/**
- * Re-install only stack-aware assets (rules, skills, agents) using current config.json.
- * Skips infrastructure steps (dirs, framework copy, hooks).
- *
- * @param {string} targetPath - Absolute path to the target project directory
- * @param {Function} log - Logging function
- * @returns {{ agentCounts: object, domainCounts: object, projectTags: string[] }}
- */
-async function installStackAwareAssets(targetPath, log) {
-  const configPath = join(targetPath, '.morph', 'config', 'config.json');
-  let projectTags = [];
-  if (await pathExists(configPath)) {
-    try {
-      // BOM-tolerant: a config.json hand-edited on Windows (PS 5.1 Out-File)
-      // carries a UTF-8 BOM; without stripping it this parse fails silently
-      // and only universal personas get installed.
-      const config = JSON.parse(readFileSync(configPath, 'utf-8').replace(/^/, ''));
-      projectTags = getProjectTags(config);
-    } catch { /* ignore malformed config */ }
-  }
-
-  log('Installing stack-filtered rules...');
-  const claudeDest = join(targetPath, '.claude');
-  const rulesSrc = join(FRAMEWORK_DIR, 'rules');
-  const rulesDest = join(claudeDest, 'rules');
-  if (await pathExists(rulesSrc)) {
-    await ensureDir(rulesDest);
-    installRulesForStack(rulesSrc, rulesDest, projectTags);
-  }
-
-  log('Installing skills...');
-  await installSkills(targetPath, { projectTags });
-
-  log('Installing agents...');
-  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectTags });
-
-  log('Installing domain agents...');
-  const domainCounts = await installDomainAgents(targetPath, FRAMEWORK_DIR, { projectTags });
-
-  return { agentCounts, domainCounts, projectTags };
-}
-
-/**
- * Rewrite the managed personas block in .claude/CLAUDE.md with the agents
- * ACTUALLY installed (derived list — never a hand-written promise).
- * No markers / no file → no-op (fail-open).
- * Exported so `morph-spec update` derives the same block on upgrades.
- *
- * @param {string} claudeMdPath - Absolute path to the installed .claude/CLAUDE.md
- * @param {Array<{ name: string, title: string, domains: string[] }>} agents
- */
-export async function updateClaudeMdAgentsBlock(claudeMdPath, agents = []) {
-  if (!(await pathExists(claudeMdPath))) return;
-  const START = '<!-- morph-agents:start -->';
-  const END = '<!-- morph-agents:end -->';
-  const content = readFileSync(claudeMdPath, 'utf-8');
-  if (!content.includes(START) || !content.includes(END)) return;
-
-  const list = agents.length > 0
-    ? agents.map(a => `- \`${a.name}\` — ${a.title}${a.domains?.length ? ` (${a.domains.join(', ')})` : ''}`).join('\n')
-    : '_Nenhuma persona instalada — configure `project.stack` em `.morph/config/config.json` e rode `morph-spec setup-infra --reinstall`._';
-
-  const block = `${START}\n**Personas instaladas neste projeto** (derivado de agents.json na última instalação):\n\n${list}\n${END}`;
-  const updated = content.replace(
-    new RegExp(`${START}[\\s\\S]*?${END}`),
-    block
-  );
-  await writeFile(claudeMdPath, updated);
-}
-
-/**
- * Installs MORPH-SPEC infrastructure into the target project directory.
- * Headless — no prompts, no spinner (suppressed when MORPH_QUIET=1), no stack detection.
- *
- * @param {string} targetPath - Absolute path to the target project directory
- * @param {object} options
- * @param {Function} options._exec - exec function (for testing)
- * @param {boolean} options.reinstall - If true, only re-install stack-aware assets (rules, skills, agents)
- */
-export async function setupInfra(targetPath, { _exec = execSync, reinstall = false } = {}) {
-  const quiet = process.env.MORPH_QUIET === '1';
-
-  function log(msg) {
-    if (!quiet) process.stdout.write(msg + '\n');
-  }
-
-  // --- Reinstall mode: only re-install stack-aware assets ---
-  if (reinstall) {
-    log('setup-infra (reinstall): re-installing stack-aware assets...');
-    const { agentCounts, domainCounts } = await installStackAwareAssets(targetPath, log);
-    // Keep the derived personas list in .claude/CLAUDE.md in sync with what
-    // was actually (re)installed.
-    await updateClaudeMdAgentsBlock(join(targetPath, '.claude', 'CLAUDE.md'), agentCounts?.agents ?? []);
-    log('setup-infra (reinstall): complete.');
-    return {
-      agents: {
-        tier1: agentCounts?.tier1 ?? 0,
-        tier2: agentCounts?.tier2 ?? 0,
-        specialists: domainCounts?.specialists ?? 0,
-      },
-    };
-  }
-
-  // --- 0. Install required Claude Code plugins ---
-  await installRequiredPlugins(log, _exec);
-
-  // --- 1. Inject @import into root CLAUDE.md (preserves user content) ---
-  log('Step 1: Setting up CLAUDE.md...');
-  const claudeMdSrc = join(FRAMEWORK_DIR, 'CLAUDE.md');
-  const claudeMdDest = join(targetPath, 'CLAUDE.md');
-  const importResult = await injectMorphImport(claudeMdDest);
-  log(`  ✓ Root CLAUDE.md: ${importResult}`);
-
-  // --- 2. Create .morph directory structure ---
-  log('Step 2: Creating .morph structure...');
-  const morphPath = join(targetPath, '.morph');
-  const configDir = join(morphPath, 'config');
-  const frameworkDestDir = join(morphPath, 'framework');
-  const contextDir = join(morphPath, 'context');
-  const featuresDir = join(morphPath, 'features');
-  const checkpointsDir = join(morphPath, 'checkpoints');
-  const memoryDir = join(morphPath, 'memory');
-  const archiveDir = join(morphPath, 'archive');
-
-  await ensureDir(configDir);
-  await ensureDir(frameworkDestDir);
-  await ensureDir(contextDir);
-  await ensureDir(featuresDir);
-  await ensureDir(checkpointsDir);
-  await ensureDir(memoryDir);
-  await ensureDir(archiveDir);
-
-  // --- 3. Write minimal config.json (only if not exists) ---
-  log('Step 3: Writing config.json...');
-  const configPath = join(configDir, 'config.json');
-  if (!(await pathExists(configPath))) {
-    const dirName = targetPath.split(/[\/]/).pop();
-    const config = {
-      framework: 'global',
-      frameworkVersion: getInstalledCLIVersion(),
-      trust: 'auto',
-      project: {
-        name: dirName
-      }
-    };
-    await writeJson(configPath, config);
-  }
-
-  // --- 4. Write placeholder context/README.md (only if not exists) ---
-  log('Step 4: Writing context/README.md...');
-  const contextReadmePath = join(contextDir, 'README.md');
-  if (!(await pathExists(contextReadmePath))) {
-    const dirName = targetPath.split(/[\/]/).pop();
-    const readmeContent = `# ${dirName} — Project Context\n\nRun \`morph-spec context refresh\` to generate architecture context.\n`;
-    await writeFile(contextReadmePath, readmeContent);
-  }
-
-  // --- 5. Copy framework/templates → .morph/framework/templates ---
-  log('Step 5: Copying framework templates...');
-  const frameworkTemplatesSrc = join(FRAMEWORK_DIR, 'templates');
-  const templatesDest = join(frameworkDestDir, 'templates');
-  if (await pathExists(frameworkTemplatesSrc)) {
-    await copyDirectory(frameworkTemplatesSrc, templatesDest);
-  } else {
-    await ensureDir(templatesDest);
-  }
-
-  // --- 6. Copy framework/standards → .morph/framework/standards ---
-  log('Step 6: Copying framework standards...');
-  const frameworkStandardsSrc = join(FRAMEWORK_DIR, 'standards');
-  const frameworkStandardsDest = join(frameworkDestDir, 'standards');
-  if (await pathExists(frameworkStandardsSrc)) {
-    await copyDirectory(frameworkStandardsSrc, frameworkStandardsDest);
-  }
-
-  // --- 7. Copy framework/hooks → .morph/framework/hooks ---
-  log('Step 7: Copying hooks...');
-  const hooksSrc = join(FRAMEWORK_DIR, 'hooks');
-  const hooksDest = join(frameworkDestDir, 'hooks');
-  if (await pathExists(hooksSrc)) {
-    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);
-  }
-
-  // --- 7c. Copy framework/evals → .morph/framework/evals ---
-  // Rubricas .md (bandas 0-10) + trace-schema.md — referenciadas por
-  // morph-eval/morph-review/agents.json via .morph/framework/evals/.
-  log('Step 7c: Copying evals (rubrics .md + trace schema)...');
-  const evalsSrc = join(FRAMEWORK_DIR, 'evals');
-  const evalsDest = join(frameworkDestDir, 'evals');
-  if (await pathExists(evalsSrc)) {
-    await copyDirectory(evalsSrc, evalsDest);
-  }
-
-  // --- 8. Copy framework/agents.json → .morph/framework/agents.json ---
-  log('Step 8: Copying agents.json...');
-  const agentsSrc = join(FRAMEWORK_DIR, 'agents.json');
-  const agentsDest = join(frameworkDestDir, 'agents.json');
-  if (await pathExists(agentsSrc)) {
-    await copyFile(agentsSrc, agentsDest);
-  }
-
-  // --- 8b. Copy framework/MORPH.md → .morph/framework/MORPH.md ---
-  log('Step 8b: Copying MORPH.md (NLH charter)...');
-  const morphMdSrc = join(FRAMEWORK_DIR, 'MORPH.md');
-  const morphMdDest = join(frameworkDestDir, 'MORPH.md');
-  if (await pathExists(morphMdSrc)) {
-    await copyFile(morphMdSrc, morphMdDest);
-  }
-
-  // --- 8c. Copy framework/phases.json → .morph/framework/phases.json ---
-  log('Step 8c: Copying phases.json...');
-  const phasesSrc = join(FRAMEWORK_DIR, 'phases.json');
-  const phasesDest = join(frameworkDestDir, 'phases.json');
-  if (await pathExists(phasesSrc)) {
-    await copyFile(phasesSrc, phasesDest);
-  }
-
-  // --- 8d. Copy framework/schemas → .morph/framework/schemas (JSON schemas) ---
-  log('Step 8d: Copying schemas...');
-  const schemasSrc = join(FRAMEWORK_DIR, 'schemas');
-  const schemasDest = join(frameworkDestDir, 'schemas');
-  if (await pathExists(schemasSrc)) {
-    await copyDirectory(schemasSrc, schemasDest);
-  }
-
-  // --- 9. Copy framework/commands → .claude/commands ---
-  log('Step 9: Setting up Claude Code integration...');
-  const claudeDest = join(targetPath, '.claude');
-  const commandsSrc = join(FRAMEWORK_DIR, 'commands');
-  const commandsDest = join(claudeDest, 'commands');
-  if (await pathExists(commandsSrc)) {
-    await copyDirectory(commandsSrc, commandsDest);
-  }
-
-  // --- 10-13. Install stack-aware assets (rules, skills, agents) ---
-  log('Steps 10-13: Installing stack-aware assets...');
-  const { agentCounts, domainCounts } = await installStackAwareAssets(targetPath, log);
-
-  // --- 14. Copy framework/CLAUDE.md → .claude/CLAUDE.md (morph-owned, gitignored) ---
-  log('Step 14: Installing .claude/CLAUDE.md...');
-  const runtimeClaudeMdDest = join(claudeDest, 'CLAUDE.md');
-  if (await pathExists(claudeMdSrc)) {
-    await copyFile(claudeMdSrc, runtimeClaudeMdDest);
-    // Derive the personas section from what step 10-13 actually installed.
-    await updateClaudeMdAgentsBlock(runtimeClaudeMdDest, agentCounts?.agents ?? []);
-  }
-
-  // --- 15. installGlobalStatusline (non-critical) ---
-  log('Step 15: Installing global statusline...');
-  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
-  try {
-    await installGlobalStatusline(HOOKS_SRC);
-  } catch {
-    // Non-critical — global ~/.claude may not be writable
-  }
-
-  // --- 16. installClaudeHooks ---
-  log('Step 16: Installing Claude Code hooks...');
-  await installClaudeHooks(targetPath);
-
-  // --- 17. saveProjectMorphVersion ---
-  log('Step 17: Saving version info...');
-  const cliVersion = getInstalledCLIVersion();
-  await saveProjectMorphVersion(targetPath, cliVersion);
-
-  // --- 18. updateGitignore ---
-  log('Step 18: Updating .gitignore...');
-  await updateGitignore(targetPath);
-
-  // --- 19. Initialize state.json (only if not exists) ---
-  log('Step 19: Initializing state.json...');
-  const statePath = join(morphPath, 'state.json');
-  if (!(await pathExists(statePath))) {
-    const dirName = targetPath.split(/[\/\\]/).pop();
-    const now = new Date().toISOString();
-    await writeJson(statePath, {
-      version: '5.0.0',
-      project: { name: dirName, type: 'unknown', createdAt: now, updatedAt: now },
-      features: {},
-      threads: {},
-      metadata: { totalFeatures: 0, completedFeatures: 0, totalTimeSpent: 0, lastUpdated: now }
-    });
-  }
-
-  log('setup-infra: complete.');
-
-  return {
-    agents: {
-      tier1: agentCounts?.tier1 ?? 0,
-      tier2: agentCounts?.tier2 ?? 0,
-      specialists: domainCounts?.specialists ?? 0,
-    },
-  };
-}
+/**
+ * setup-infra.js
+ *
+ * Headless infrastructure setup for MORPH-SPEC.
+ * Extracted from init.js (steps 1-10) so it can be called by the
+ * /morph-init Claude Code skill via `morph-spec setup-infra` without
+ * interactive prompts or stack detection.
+ *
+ * Usage:
+ *   import { setupInfra } from './setup-infra.js';
+ *   await setupInfra('/path/to/project');
+ */
+
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import { readFileSync, readdirSync, copyFileSync, unlinkSync } from 'fs';
+import {
+  copyDirectory,
+  copyFile,
+  pathExists,
+  writeJson,
+  ensureDir,
+  writeFile,
+  updateGitignore
+} from '../utils/file-copier.js';
+import { parseStacks, getProjectTags, shouldInstall } from '../lib/stack-filter.js';
+import { injectMorphImport } from '../utils/claude-md-injector.js';
+import { saveProjectMorphVersion, getInstalledCLIVersion } from '../utils/version-checker.js';
+import { installClaudeHooks, installGlobalStatusline } from '../utils/claude-settings-manager.js';
+import { installSkills } from '../utils/skills-installer.js';
+import { installAgents, installDomainAgents } from '../utils/agents-installer.js';
+
+const FRAMEWORK_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'framework');
+
+const REQUIRED_PLUGINS = [
+  'superpowers@claude-plugins-official',
+  'context7@claude-plugins-official',
+];
+
+async function installRequiredPlugins(log, exec) {
+  log('Step 0: Installing required Claude Code plugins...');
+  for (const plugin of REQUIRED_PLUGINS) {
+    try {
+      exec(`claude plugin install ${plugin}`, { stdio: 'inherit' });
+      log(`  ✓ ${plugin}`);
+    } catch {
+      log(`  ⚠ Failed to install ${plugin} — install manually: claude plugin install ${plugin}`);
+    }
+  }
+}
+
+/**
+ * Install only stack-matching rules from rulesSrc to rulesDest.
+ * Also removes orphan rules in rulesDest that are no longer in the install set.
+ *
+ * @param {string} rulesSrc - Source rules directory (framework/rules/)
+ * @param {string} rulesDest - Destination rules directory (.claude/rules/)
+ * @param {string[]} projectTags - Stack tags from config (e.g., ['dotnet', 'blazor'])
+ */
+export function installRulesForStack(rulesSrc, rulesDest, projectTags) {
+  const sourceFiles = readdirSync(rulesSrc).filter(f => f.endsWith('.md'));
+  const installed = new Set();
+
+  for (const file of sourceFiles) {
+    const content = readFileSync(join(rulesSrc, file), 'utf-8');
+    const stacks = parseStacks(content);
+    if (shouldInstall(stacks, projectTags)) {
+      copyFileSync(join(rulesSrc, file), join(rulesDest, file));
+      installed.add(file);
+    }
+  }
+
+  // Cleanup orphans
+  for (const file of readdirSync(rulesDest).filter(f => f.endsWith('.md'))) {
+    if (!installed.has(file)) {
+      unlinkSync(join(rulesDest, file));
+    }
+  }
+}
+
+/**
+ * Re-install only stack-aware assets (rules, skills, agents) using current config.json.
+ * Skips infrastructure steps (dirs, framework copy, hooks).
+ *
+ * @param {string} targetPath - Absolute path to the target project directory
+ * @param {Function} log - Logging function
+ * @returns {{ agentCounts: object, domainCounts: object, projectTags: string[] }}
+ */
+async function installStackAwareAssets(targetPath, log) {
+  const configPath = join(targetPath, '.morph', 'config', 'config.json');
+  let projectTags = [];
+  if (await pathExists(configPath)) {
+    try {
+      // BOM-tolerant: a config.json hand-edited on Windows (PS 5.1 Out-File)
+      // carries a UTF-8 BOM; without stripping it this parse fails silently
+      // and only universal personas get installed.
+      const config = JSON.parse(readFileSync(configPath, 'utf-8').replace(/^/, ''));
+      projectTags = getProjectTags(config);
+    } catch { /* ignore malformed config */ }
+  }
+
+  log('Installing stack-filtered rules...');
+  const claudeDest = join(targetPath, '.claude');
+  const rulesSrc = join(FRAMEWORK_DIR, 'rules');
+  const rulesDest = join(claudeDest, 'rules');
+  if (await pathExists(rulesSrc)) {
+    await ensureDir(rulesDest);
+    installRulesForStack(rulesSrc, rulesDest, projectTags);
+  }
+
+  log('Installing skills...');
+  await installSkills(targetPath, { projectTags });
+
+  log('Installing agents...');
+  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectTags });
+
+  log('Installing domain agents...');
+  const domainCounts = await installDomainAgents(targetPath, FRAMEWORK_DIR, { projectTags });
+
+  return { agentCounts, domainCounts, projectTags };
+}
+
+/**
+ * Rewrite the managed personas block in .claude/CLAUDE.md with the agents
+ * ACTUALLY installed (derived list — never a hand-written promise).
+ * No markers / no file → no-op (fail-open).
+ * Exported so `morph-spec update` derives the same block on upgrades.
+ *
+ * @param {string} claudeMdPath - Absolute path to the installed .claude/CLAUDE.md
+ * @param {Array<{ name: string, title: string, domains: string[] }>} agents
+ */
+export async function updateClaudeMdAgentsBlock(claudeMdPath, agents = []) {
+  if (!(await pathExists(claudeMdPath))) return;
+  const START = '<!-- morph-agents:start -->';
+  const END = '<!-- morph-agents:end -->';
+  const content = readFileSync(claudeMdPath, 'utf-8');
+  if (!content.includes(START) || !content.includes(END)) return;
+
+  const list = agents.length > 0
+    ? agents.map(a => `- \`${a.name}\` — ${a.title}${a.domains?.length ? ` (${a.domains.join(', ')})` : ''}`).join('\n')
+    : '_Nenhuma persona instalada — configure `project.stack` em `.morph/config/config.json` e rode `morph-spec setup-infra --reinstall`._';
+
+  const block = `${START}\n**Personas instaladas neste projeto** (derivado de agents.json na última instalação):\n\n${list}\n${END}`;
+  const updated = content.replace(
+    new RegExp(`${START}[\\s\\S]*?${END}`),
+    block
+  );
+  await writeFile(claudeMdPath, updated);
+}
+
+/**
+ * Installs MORPH-SPEC infrastructure into the target project directory.
+ * Headless — no prompts, no spinner (suppressed when MORPH_QUIET=1), no stack detection.
+ *
+ * @param {string} targetPath - Absolute path to the target project directory
+ * @param {object} options
+ * @param {Function} options._exec - exec function (for testing)
+ * @param {boolean} options.reinstall - If true, only re-install stack-aware assets (rules, skills, agents)
+ */
+export async function setupInfra(targetPath, { _exec = execSync, reinstall = false } = {}) {
+  const quiet = process.env.MORPH_QUIET === '1';
+
+  function log(msg) {
+    if (!quiet) process.stdout.write(msg + '\n');
+  }
+
+  // --- Reinstall mode: only re-install stack-aware assets ---
+  if (reinstall) {
+    log('setup-infra (reinstall): re-installing stack-aware assets...');
+    const { agentCounts, domainCounts } = await installStackAwareAssets(targetPath, log);
+    // Keep the derived personas list in .claude/CLAUDE.md in sync with what
+    // was actually (re)installed.
+    await updateClaudeMdAgentsBlock(join(targetPath, '.claude', 'CLAUDE.md'), agentCounts?.agents ?? []);
+    log('setup-infra (reinstall): complete.');
+    return {
+      agents: {
+        tier1: agentCounts?.tier1 ?? 0,
+        tier2: agentCounts?.tier2 ?? 0,
+        specialists: domainCounts?.specialists ?? 0,
+      },
+    };
+  }
+
+  // --- 0. Install required Claude Code plugins ---
+  await installRequiredPlugins(log, _exec);
+
+  // --- 1. Inject @import into root CLAUDE.md (preserves user content) ---
+  log('Step 1: Setting up CLAUDE.md...');
+  const claudeMdSrc = join(FRAMEWORK_DIR, 'CLAUDE.md');
+  const claudeMdDest = join(targetPath, 'CLAUDE.md');
+  const importResult = await injectMorphImport(claudeMdDest);
+  log(`  ✓ Root CLAUDE.md: ${importResult}`);
+
+  // --- 2. Create .morph directory structure ---
+  log('Step 2: Creating .morph structure...');
+  const morphPath = join(targetPath, '.morph');
+  const configDir = join(morphPath, 'config');
+  const frameworkDestDir = join(morphPath, 'framework');
+  const contextDir = join(morphPath, 'context');
+  const featuresDir = join(morphPath, 'features');
+  const checkpointsDir = join(morphPath, 'checkpoints');
+  const memoryDir = join(morphPath, 'memory');
+  const archiveDir = join(morphPath, 'archive');
+
+  await ensureDir(configDir);
+  await ensureDir(frameworkDestDir);
+  await ensureDir(contextDir);
+  await ensureDir(featuresDir);
+  await ensureDir(checkpointsDir);
+  await ensureDir(memoryDir);
+  await ensureDir(archiveDir);
+
+  // --- 3. Write minimal config.json (only if not exists) ---
+  log('Step 3: Writing config.json...');
+  const configPath = join(configDir, 'config.json');
+  if (!(await pathExists(configPath))) {
+    const dirName = targetPath.split(/[\/]/).pop();
+    const config = {
+      framework: 'global',
+      frameworkVersion: getInstalledCLIVersion(),
+      trust: 'auto',
+      project: {
+        name: dirName
+      }
+    };
+    await writeJson(configPath, config);
+  }
+
+  // --- 4. Write placeholder context/README.md (only if not exists) ---
+  log('Step 4: Writing context/README.md...');
+  const contextReadmePath = join(contextDir, 'README.md');
+  if (!(await pathExists(contextReadmePath))) {
+    const dirName = targetPath.split(/[\/]/).pop();
+    const readmeContent = `# ${dirName} — Project Context\n\nRun \`morph-spec context refresh\` to generate architecture context.\n`;
+    await writeFile(contextReadmePath, readmeContent);
+  }
+
+  // --- 5. Copy framework/templates → .morph/framework/templates ---
+  log('Step 5: Copying framework templates...');
+  const frameworkTemplatesSrc = join(FRAMEWORK_DIR, 'templates');
+  const templatesDest = join(frameworkDestDir, 'templates');
+  if (await pathExists(frameworkTemplatesSrc)) {
+    await copyDirectory(frameworkTemplatesSrc, templatesDest);
+  } else {
+    await ensureDir(templatesDest);
+  }
+
+  // --- 6. Copy framework/standards → .morph/framework/standards ---
+  log('Step 6: Copying framework standards...');
+  const frameworkStandardsSrc = join(FRAMEWORK_DIR, 'standards');
+  const frameworkStandardsDest = join(frameworkDestDir, 'standards');
+  if (await pathExists(frameworkStandardsSrc)) {
+    await copyDirectory(frameworkStandardsSrc, frameworkStandardsDest);
+  }
+
+  // --- 7. Copy framework/hooks → .morph/framework/hooks ---
+  log('Step 7: Copying hooks...');
+  const hooksSrc = join(FRAMEWORK_DIR, 'hooks');
+  const hooksDest = join(frameworkDestDir, 'hooks');
+  if (await pathExists(hooksSrc)) {
+    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);
+  }
+
+  // --- 7c. Copy framework/evals → .morph/framework/evals ---
+  // Rubricas .md (bandas 0-10) + trace-schema.md — referenciadas por
+  // morph-eval/morph-review/agents.json via .morph/framework/evals/.
+  log('Step 7c: Copying evals (rubrics .md + trace schema)...');
+  const evalsSrc = join(FRAMEWORK_DIR, 'evals');
+  const evalsDest = join(frameworkDestDir, 'evals');
+  if (await pathExists(evalsSrc)) {
+    await copyDirectory(evalsSrc, evalsDest);
+  }
+
+  // --- 8. Copy framework/agents.json → .morph/framework/agents.json ---
+  log('Step 8: Copying agents.json...');
+  const agentsSrc = join(FRAMEWORK_DIR, 'agents.json');
+  const agentsDest = join(frameworkDestDir, 'agents.json');
+  if (await pathExists(agentsSrc)) {
+    await copyFile(agentsSrc, agentsDest);
+  }
+
+  // --- 8b. Copy framework/MORPH.md → .morph/framework/MORPH.md ---
+  log('Step 8b: Copying MORPH.md (NLH charter)...');
+  const morphMdSrc = join(FRAMEWORK_DIR, 'MORPH.md');
+  const morphMdDest = join(frameworkDestDir, 'MORPH.md');
+  if (await pathExists(morphMdSrc)) {
+    await copyFile(morphMdSrc, morphMdDest);
+  }
+
+  // --- 8c. Copy framework/phases.json → .morph/framework/phases.json ---
+  log('Step 8c: Copying phases.json...');
+  const phasesSrc = join(FRAMEWORK_DIR, 'phases.json');
+  const phasesDest = join(frameworkDestDir, 'phases.json');
+  if (await pathExists(phasesSrc)) {
+    await copyFile(phasesSrc, phasesDest);
+  }
+
+  // --- 8d. Copy framework/schemas → .morph/framework/schemas (JSON schemas) ---
+  log('Step 8d: Copying schemas...');
+  const schemasSrc = join(FRAMEWORK_DIR, 'schemas');
+  const schemasDest = join(frameworkDestDir, 'schemas');
+  if (await pathExists(schemasSrc)) {
+    await copyDirectory(schemasSrc, schemasDest);
+  }
+
+  // --- 9. Copy framework/commands → .claude/commands ---
+  log('Step 9: Setting up Claude Code integration...');
+  const claudeDest = join(targetPath, '.claude');
+  const commandsSrc = join(FRAMEWORK_DIR, 'commands');
+  const commandsDest = join(claudeDest, 'commands');
+  if (await pathExists(commandsSrc)) {
+    await copyDirectory(commandsSrc, commandsDest);
+  }
+
+  // --- 10-13. Install stack-aware assets (rules, skills, agents) ---
+  log('Steps 10-13: Installing stack-aware assets...');
+  const { agentCounts, domainCounts } = await installStackAwareAssets(targetPath, log);
+
+  // --- 14. Copy framework/CLAUDE.md → .claude/CLAUDE.md (morph-owned, gitignored) ---
+  log('Step 14: Installing .claude/CLAUDE.md...');
+  const runtimeClaudeMdDest = join(claudeDest, 'CLAUDE.md');
+  if (await pathExists(claudeMdSrc)) {
+    await copyFile(claudeMdSrc, runtimeClaudeMdDest);
+    // Derive the personas section from what step 10-13 actually installed.
+    await updateClaudeMdAgentsBlock(runtimeClaudeMdDest, agentCounts?.agents ?? []);
+  }
+
+  // --- 15. installGlobalStatusline (non-critical) ---
+  log('Step 15: Installing global statusline...');
+  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
+  try {
+    await installGlobalStatusline(HOOKS_SRC);
+  } catch {
+    // Non-critical — global ~/.claude may not be writable
+  }
+
+  // --- 16. installClaudeHooks ---
+  log('Step 16: Installing Claude Code hooks...');
+  await installClaudeHooks(targetPath);
+
+  // --- 17. saveProjectMorphVersion ---
+  log('Step 17: Saving version info...');
+  const cliVersion = getInstalledCLIVersion();
+  await saveProjectMorphVersion(targetPath, cliVersion);
+
+  // --- 18. updateGitignore ---
+  log('Step 18: Updating .gitignore...');
+  await updateGitignore(targetPath);
+
+  // --- 19. Initialize state.json (only if not exists) ---
+  log('Step 19: Initializing state.json...');
+  const statePath = join(morphPath, 'state.json');
+  if (!(await pathExists(statePath))) {
+    const dirName = targetPath.split(/[\/\\]/).pop();
+    const now = new Date().toISOString();
+    await writeJson(statePath, {
+      version: '5.0.0',
+      project: { name: dirName, type: 'unknown', createdAt: now, updatedAt: now },
+      features: {},
+      threads: {},
+      metadata: { totalFeatures: 0, completedFeatures: 0, totalTimeSpent: 0, lastUpdated: now }
+    });
+  }
+
+  log('setup-infra: complete.');
+
+  return {
+    agents: {
+      tier1: agentCounts?.tier1 ?? 0,
+      tier2: agentCounts?.tier2 ?? 0,
+      specialists: domainCounts?.specialists ?? 0,
+    },
+  };
+}