@polymorphism-tech/morph-spec 4.8.19 → 4.9.0

package/src/scripts/setup-infra.js

@@ -1,224 +1,240 @@
-/**
- * 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 {
-  copyDirectory,
-  copyFile,
-  pathExists,
-  writeJson,
-  ensureDir,
-  writeFile,
-  updateGitignore
-} from '../utils/file-copier.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}`);
-    }
-  }
-}
-
-/**
- * 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
- */
-export async function setupInfra(targetPath, { _exec = execSync } = {}) {
-  const quiet = process.env.MORPH_QUIET === '1';
-
-  function log(msg) {
-    if (!quiet) process.stdout.write(msg + '\n');
-  }
-
-  // --- 0. Install required Claude Code plugins ---
-  await installRequiredPlugins(log, _exec);
-
-  // --- 1. Copy CLAUDE.md (backup existing non-MORPH CLAUDE.md) ---
-  log('Step 1: Copying CLAUDE.md...');
-  const claudeMdSrc = join(FRAMEWORK_DIR, 'CLAUDE.md');
-  const claudeMdDest = join(targetPath, 'CLAUDE.md');
-
-  if (await pathExists(claudeMdDest)) {
-    const { readFile } = await import('../utils/file-copier.js');
-    const existingContent = await readFile(claudeMdDest);
-    if (!existingContent.includes('MORPH-SPEC')) {
-      await copyFile(claudeMdDest, `${claudeMdDest}.backup`);
-    }
-  }
-  await copyFile(claudeMdSrc, claudeMdDest);
-
-  // --- 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(),
-      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-init to generate project 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);
-  }
-
-  // --- 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);
-  }
-
-  // --- 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. Copy framework/rules → .claude/rules ---
-  log('Step 10: Installing path-scoped rules...');
-  const rulesSrc = join(FRAMEWORK_DIR, 'rules');
-  const rulesDest = join(claudeDest, 'rules');
-  if (await pathExists(rulesSrc)) {
-    await copyDirectory(rulesSrc, rulesDest);
-  }
-
-  // --- 11. installSkills ---
-  log('Step 11: Installing skills...');
-  await installSkills(targetPath);
-
-  // --- 12. installAgents ---
-  log('Step 12: Installing agents...');
-  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectStack: null });
-
-  // --- 13. installDomainAgents ---
-  log('Step 13: Installing domain agents...');
-  const domainCounts = await installDomainAgents(targetPath, FRAMEWORK_DIR);
-
-  // --- 14. Copy framework/CLAUDE.md → .claude/CLAUDE.md ---
-  log('Step 14: Installing .claude/CLAUDE.md...');
-  const runtimeClaudeMdDest = join(claudeDest, 'CLAUDE.md');
-  if (await pathExists(claudeMdSrc)) {
-    await copyFile(claudeMdSrc, runtimeClaudeMdDest);
-  }
-
-  // --- 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);
-
-  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 {
+  copyDirectory,
+  copyFile,
+  pathExists,
+  writeJson,
+  ensureDir,
+  writeFile,
+  updateGitignore
+} from '../utils/file-copier.js';
+import { saveProjectMorphVersion, getInstalledCLIVersion } from '../utils/version-checker.js';
+import { installClaudeHooks, installGlobalStatusline, installVSCodeTerminalSettings, installShellIntegration } 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}`);
+    }
+  }
+}
+
+/**
+ * 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
+ */
+export async function setupInfra(targetPath, { _exec = execSync } = {}) {
+  const quiet = process.env.MORPH_QUIET === '1';
+
+  function log(msg) {
+    if (!quiet) process.stdout.write(msg + '\n');
+  }
+
+  // --- 0. Install required Claude Code plugins ---
+  await installRequiredPlugins(log, _exec);
+
+  // --- 1. Copy CLAUDE.md (backup existing non-MORPH CLAUDE.md) ---
+  log('Step 1: Copying CLAUDE.md...');
+  const claudeMdSrc = join(FRAMEWORK_DIR, 'CLAUDE.md');
+  const claudeMdDest = join(targetPath, 'CLAUDE.md');
+
+  if (await pathExists(claudeMdDest)) {
+    const { readFile } = await import('../utils/file-copier.js');
+    const existingContent = await readFile(claudeMdDest);
+    if (!existingContent.includes('MORPH-SPEC')) {
+      await copyFile(claudeMdDest, `${claudeMdDest}.backup`);
+    }
+  }
+  await copyFile(claudeMdSrc, claudeMdDest);
+
+  // --- 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(),
+      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:init to generate project 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);
+  }
+
+  // --- 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);
+  }
+
+  // --- 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. Copy framework/rules → .claude/rules ---
+  log('Step 10: Installing path-scoped rules...');
+  const rulesSrc = join(FRAMEWORK_DIR, 'rules');
+  const rulesDest = join(claudeDest, 'rules');
+  if (await pathExists(rulesSrc)) {
+    await copyDirectory(rulesSrc, rulesDest);
+  }
+
+  // --- 11. installSkills ---
+  log('Step 11: Installing skills...');
+  await installSkills(targetPath);
+
+  // --- 12. installAgents ---
+  log('Step 12: Installing agents...');
+  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectStack: null });
+
+  // --- 13. installDomainAgents ---
+  log('Step 13: Installing domain agents...');
+  const domainCounts = await installDomainAgents(targetPath, FRAMEWORK_DIR);
+
+  // --- 14. Copy framework/CLAUDE.md → .claude/CLAUDE.md ---
+  log('Step 14: Installing .claude/CLAUDE.md...');
+  const runtimeClaudeMdDest = join(claudeDest, 'CLAUDE.md');
+  if (await pathExists(claudeMdSrc)) {
+    await copyFile(claudeMdSrc, runtimeClaudeMdDest);
+  }
+
+  // --- 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);
+
+  // --- 16a. installShellIntegration (non-critical) ---
+  log('Step 16a: Installing shell integration...');
+  try {
+    await installShellIntegration();
+  } catch {
+    // Non-critical — shell profile may not be writable
+  }
+
+  // --- 16b. installVSCodeTerminalSettings (non-critical) ---
+  log('Step 16b: Configuring VS Code terminal settings...');
+  try {
+    await installVSCodeTerminalSettings();
+  } catch {
+    // Non-critical — VS Code settings may not be present
+  }
+
+  // --- 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);
+
+  log('setup-infra: complete.');
+
+  return {
+    agents: {
+      tier1: agentCounts?.tier1 ?? 0,
+      tier2: agentCounts?.tier2 ?? 0,
+      specialists: domainCounts?.specialists ?? 0,
+    },
+  };
+}

package/src/utils/agents-installer.js

@@ -78,14 +78,14 @@ const TIER_DEFAULTS = {
     model: 'inherit',
     tools: 'Read, Grep, Glob, Bash, Task',
     maxTurns: 30,
-    skills: ['morph-checklist'],
+    skills: ['morph:checklist'],
     memory: 'project',
   },
   2: {
     model: 'inherit',
     tools: 'Read, Grep, Glob, Bash',
     maxTurns: 20,
-    skills: ['morph-checklist'],
+    skills: ['morph:checklist'],
     memory: 'local',
   },
 };

package/src/utils/banner.js

@@ -45,7 +45,7 @@ export function printInstallBanner({ version, nodeVersion, results = [] }) {
     '',
     sep('Next'),
     `  ${chalk.cyan('1.')} Open your project in Claude Code`,
-    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('/morph-init')}`,
+    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('/morph:init')}`,
     '',
   ].join('\n'));
 }

package/src/utils/claude-settings-manager.js

@@ -17,7 +17,7 @@ const MORPH_MANAGED_KEY = '_morph_managed';
 // Re-export from hooks-installer (v2 registry-based)
 // ============================================================================
 
-export { installClaudeHooks, installGlobalStatusline, getHooksVersion } from './hooks-installer.js';
+export { installClaudeHooks, installGlobalStatusline, installVSCodeTerminalSettings, installShellIntegration, getHooksVersion } from './hooks-installer.js';
 export { installAgents } from './agents-installer.js';
 
 // ============================================================================

package/src/utils/file-copier.js

@@ -145,6 +145,7 @@ export async function updateGitignore(projectPath) {
     '.claude/CLAUDE.md',
     '.claude/settings.local.json',
     '.mcp.json',
+    '.worktrees/',
     ''
   ];