@polymorphism-tech/morph-spec 8.32.0 → 8.34.2

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

@@ -1,300 +1,300 @@
-/**
- * Claude Settings Manager
- *
- * Extends the original hooks-installer with broader settings management:
- * permissions, env vars, and managed entry tracking.
- *
- * Re-exports installClaudeHooks for backward compatibility.
- */
-
-import { join } from 'path';
-import { readFile, writeFile, mkdir, copyFile } from 'fs/promises';
-import { existsSync } from 'fs';
-
-const MORPH_MANAGED_KEY = '_morph_managed';
-
-// ============================================================================
-// Re-export from hooks-installer (v2 registry-based)
-// ============================================================================
-
-export { installClaudeHooks, installGlobalStatusline, getHooksVersion } from './hooks-installer.js';
-export { installAgents } from './agents-installer.js';
-
-// ============================================================================
-// Extended settings management
-// ============================================================================
-
-/**
- * Install permission rules into .claude/settings.local.json
- * @param {string} targetPath - Project root directory
- * @param {Array<string>} permissions - Permission patterns to add
- * @returns {Promise<Object>} Summary of changes
- */
-export async function installPermissions(targetPath, permissions) {
-  const settings = await loadSettings(targetPath);
-
-  settings.permissions = settings.permissions || [];
-
-  const added = [];
-  for (const perm of permissions) {
-    if (!settings.permissions.includes(perm)) {
-      settings.permissions.push(perm);
-      added.push(perm);
-    }
-  }
-
-  // Track in _morph_managed
-  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
-  settings[MORPH_MANAGED_KEY].permissions_added =
-    settings[MORPH_MANAGED_KEY].permissions_added || [];
-  for (const perm of added) {
-    if (!settings[MORPH_MANAGED_KEY].permissions_added.includes(perm)) {
-      settings[MORPH_MANAGED_KEY].permissions_added.push(perm);
-    }
-  }
-  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
-
-  await saveSettings(targetPath, settings);
-
-  return { added, total: settings.permissions.length };
-}
-
-/**
- * Install environment variables into .claude/settings.local.json
- * @param {string} targetPath - Project root directory
- * @param {Object} envVars - Key-value pairs to add to env
- * @returns {Promise<Object>} Summary of changes
- */
-export async function installEnvVars(targetPath, envVars) {
-  const settings = await loadSettings(targetPath);
-
-  settings.env = settings.env || {};
-
-  const added = [];
-  for (const [key, value] of Object.entries(envVars)) {
-    if (!(key in settings.env)) {
-      settings.env[key] = value;
-      added.push(key);
-    }
-  }
-
-  // Track in _morph_managed
-  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
-  settings[MORPH_MANAGED_KEY].env_added =
-    settings[MORPH_MANAGED_KEY].env_added || [];
-  for (const key of added) {
-    if (!settings[MORPH_MANAGED_KEY].env_added.includes(key)) {
-      settings[MORPH_MANAGED_KEY].env_added.push(key);
-    }
-  }
-  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
-
-  await saveSettings(targetPath, settings);
-
-  return { added, total: Object.keys(settings.env).length };
-}
-
-/**
- * Remove only morph-spec managed entries from settings.
- * Creates backup before modifying.
- * @param {string} targetPath - Project root directory
- * @returns {Promise<Object>} Summary of what was removed
- */
-export async function resetMorphSettings(targetPath) {
-  const claudeDir = join(targetPath, '.claude');
-  const settingsPath = join(claudeDir, 'settings.local.json');
-
-  if (!existsSync(settingsPath)) {
-    return { removed: false, reason: 'file not found' };
-  }
-
-  const settings = await loadSettings(targetPath);
-  const managed = settings[MORPH_MANAGED_KEY];
-
-  if (!managed) {
-    return { removed: false, reason: 'no _morph_managed section found' };
-  }
-
-  // Backup before modifying
-  const backupPath = settingsPath + '.backup';
-  await copyFile(settingsPath, backupPath);
-
-  // Remove managed permissions
-  if (managed.permissions_added && Array.isArray(settings.permissions)) {
-    settings.permissions = settings.permissions.filter(
-      p => !managed.permissions_added.includes(p)
-    );
-    if (settings.permissions.length === 0) {
-      delete settings.permissions;
-    }
-  }
-
-  // Remove managed env vars
-  if (managed.env_added && settings.env) {
-    for (const key of managed.env_added) {
-      delete settings.env[key];
-    }
-    if (Object.keys(settings.env).length === 0) {
-      delete settings.env;
-    }
-  }
-
-  // Remove managed hooks (v2 format: identified by path pattern)
-  if (settings.hooks) {
-    const morphPattern = /framework\/hooks\/claude-code\//;
-    const oldPattern = /agent-teams\/dispatch\.js/;
-
-    for (const [event, entries] of Object.entries(settings.hooks)) {
-      if (!Array.isArray(entries)) continue;
-
-      settings.hooks[event] = entries.filter(entry => {
-        if (!Array.isArray(entry.hooks)) return true;
-        const nonMorphHooks = entry.hooks.filter(h =>
-          typeof h.command !== 'string' ||
-          (!morphPattern.test(h.command) && !oldPattern.test(h.command))
-        );
-        return nonMorphHooks.length > 0;
-      });
-
-      if (settings.hooks[event].length === 0) {
-        delete settings.hooks[event];
-      }
-    }
-    if (Object.keys(settings.hooks).length === 0) {
-      delete settings.hooks;
-    }
-  }
-
-  // Remove managed MCP servers from .mcp.json (primary location)
-  if (managed.mcps_installed) {
-    const mcpJson = await loadMcpJson(targetPath);
-    if (mcpJson.mcpServers) {
-      for (const mcpName of managed.mcps_installed) {
-        delete mcpJson.mcpServers[mcpName];
-      }
-      if (Object.keys(mcpJson.mcpServers).length === 0) {
-        delete mcpJson.mcpServers;
-      }
-      // Write back (or remove file if empty)
-      if (Object.keys(mcpJson).length === 0) {
-        const mcpJsonPath = join(targetPath, '.mcp.json');
-        if (existsSync(mcpJsonPath)) {
-          const { unlink } = await import('fs/promises');
-          await unlink(mcpJsonPath);
-        }
-      } else {
-        await saveMcpJson(targetPath, mcpJson);
-      }
-    }
-
-    // Also clean legacy entries from settings.local.json
-    if (settings.mcpServers) {
-      for (const mcpName of managed.mcps_installed) {
-        delete settings.mcpServers[mcpName];
-      }
-      if (Object.keys(settings.mcpServers).length === 0) {
-        delete settings.mcpServers;
-      }
-    }
-  }
-
-  // Remove the managed marker
-  delete settings[MORPH_MANAGED_KEY];
-
-  await saveSettings(targetPath, settings);
-
-  return {
-    removed: true,
-    backupPath,
-    permissionsRemoved: managed.permissions_added || [],
-    envRemoved: managed.env_added || [],
-    hooksRemoved: managed.hooks_added || [],
-    mcpsRemoved: managed.mcps_installed || [],
-    previouslyGenerated: managed.generated_at
-  };
-}
-
-/**
- * Install MCP server entries into .mcp.json at the project root.
- * Claude Code reads MCP servers from .mcp.json (not settings.local.json).
- * Tracks installed names in settings.local.json _morph_managed.mcps_installed for safe reset.
- *
- * @param {string} targetPath - Project root directory
- * @param {Object} servers - Map of server name → config { type?, command, args, env? }
- * @returns {Promise<Object>} Summary of changes { added, skipped, total }
- */
-export async function installMcpServers(targetPath, servers) {
-  const mcpJson = await loadMcpJson(targetPath);
-
-  mcpJson.mcpServers = mcpJson.mcpServers || {};
-
-  const added = [];
-  const skipped = [];
-
-  for (const [name, config] of Object.entries(servers)) {
-    if (mcpJson.mcpServers[name]) {
-      skipped.push(name);
-    } else {
-      mcpJson.mcpServers[name] = config;
-      added.push(name);
-    }
-  }
-
-  await saveMcpJson(targetPath, mcpJson);
-
-  // Track in settings.local.json _morph_managed
-  const settings = await loadSettings(targetPath);
-  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
-  settings[MORPH_MANAGED_KEY].mcps_installed =
-    settings[MORPH_MANAGED_KEY].mcps_installed || [];
-  for (const name of added) {
-    if (!settings[MORPH_MANAGED_KEY].mcps_installed.includes(name)) {
-      settings[MORPH_MANAGED_KEY].mcps_installed.push(name);
-    }
-  }
-  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
-
-  await saveSettings(targetPath, settings);
-
-  return { added, skipped, total: Object.keys(mcpJson.mcpServers).length };
-}
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-async function loadMcpJson(targetPath) {
-  const mcpJsonPath = join(targetPath, '.mcp.json');
-  try {
-    if (!existsSync(mcpJsonPath)) return {};
-    return JSON.parse(await readFile(mcpJsonPath, 'utf-8'));
-  } catch {
-    return {};
-  }
-}
-
-async function saveMcpJson(targetPath, data) {
-  const mcpJsonPath = join(targetPath, '.mcp.json');
-  await writeFile(mcpJsonPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
-}
-
-async function loadSettings(targetPath) {
-  const settingsPath = join(targetPath, '.claude', 'settings.local.json');
-  try {
-    if (!existsSync(settingsPath)) return {};
-    return JSON.parse(await readFile(settingsPath, 'utf-8'));
-  } catch {
-    return {};
-  }
-}
-
-async function saveSettings(targetPath, settings) {
-  const claudeDir = join(targetPath, '.claude');
-  const settingsPath = join(claudeDir, 'settings.local.json');
-
-  if (!existsSync(claudeDir)) {
-    await mkdir(claudeDir, { recursive: true });
-  }
-
-  await writeFile(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
-}
+/**
+ * Claude Settings Manager
+ *
+ * Extends the original hooks-installer with broader settings management:
+ * permissions, env vars, and managed entry tracking.
+ *
+ * Re-exports installClaudeHooks for backward compatibility.
+ */
+
+import { join } from 'path';
+import { readFile, writeFile, mkdir, copyFile } from 'fs/promises';
+import { existsSync } from 'fs';
+
+const MORPH_MANAGED_KEY = '_morph_managed';
+
+// ============================================================================
+// Re-export from hooks-installer (v2 registry-based)
+// ============================================================================
+
+export { installClaudeHooks, installGlobalStatusline, getHooksVersion } from './hooks-installer.js';
+export { installAgents } from './agents-installer.js';
+
+// ============================================================================
+// Extended settings management
+// ============================================================================
+
+/**
+ * Install permission rules into .claude/settings.local.json
+ * @param {string} targetPath - Project root directory
+ * @param {Array<string>} permissions - Permission patterns to add
+ * @returns {Promise<Object>} Summary of changes
+ */
+export async function installPermissions(targetPath, permissions) {
+  const settings = await loadSettings(targetPath);
+
+  settings.permissions = settings.permissions || [];
+
+  const added = [];
+  for (const perm of permissions) {
+    if (!settings.permissions.includes(perm)) {
+      settings.permissions.push(perm);
+      added.push(perm);
+    }
+  }
+
+  // Track in _morph_managed
+  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
+  settings[MORPH_MANAGED_KEY].permissions_added =
+    settings[MORPH_MANAGED_KEY].permissions_added || [];
+  for (const perm of added) {
+    if (!settings[MORPH_MANAGED_KEY].permissions_added.includes(perm)) {
+      settings[MORPH_MANAGED_KEY].permissions_added.push(perm);
+    }
+  }
+  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
+
+  await saveSettings(targetPath, settings);
+
+  return { added, total: settings.permissions.length };
+}
+
+/**
+ * Install environment variables into .claude/settings.local.json
+ * @param {string} targetPath - Project root directory
+ * @param {Object} envVars - Key-value pairs to add to env
+ * @returns {Promise<Object>} Summary of changes
+ */
+export async function installEnvVars(targetPath, envVars) {
+  const settings = await loadSettings(targetPath);
+
+  settings.env = settings.env || {};
+
+  const added = [];
+  for (const [key, value] of Object.entries(envVars)) {
+    if (!(key in settings.env)) {
+      settings.env[key] = value;
+      added.push(key);
+    }
+  }
+
+  // Track in _morph_managed
+  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
+  settings[MORPH_MANAGED_KEY].env_added =
+    settings[MORPH_MANAGED_KEY].env_added || [];
+  for (const key of added) {
+    if (!settings[MORPH_MANAGED_KEY].env_added.includes(key)) {
+      settings[MORPH_MANAGED_KEY].env_added.push(key);
+    }
+  }
+  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
+
+  await saveSettings(targetPath, settings);
+
+  return { added, total: Object.keys(settings.env).length };
+}
+
+/**
+ * Remove only morph-spec managed entries from settings.
+ * Creates backup before modifying.
+ * @param {string} targetPath - Project root directory
+ * @returns {Promise<Object>} Summary of what was removed
+ */
+export async function resetMorphSettings(targetPath) {
+  const claudeDir = join(targetPath, '.claude');
+  const settingsPath = join(claudeDir, 'settings.local.json');
+
+  if (!existsSync(settingsPath)) {
+    return { removed: false, reason: 'file not found' };
+  }
+
+  const settings = await loadSettings(targetPath);
+  const managed = settings[MORPH_MANAGED_KEY];
+
+  if (!managed) {
+    return { removed: false, reason: 'no _morph_managed section found' };
+  }
+
+  // Backup before modifying
+  const backupPath = settingsPath + '.backup';
+  await copyFile(settingsPath, backupPath);
+
+  // Remove managed permissions
+  if (managed.permissions_added && Array.isArray(settings.permissions)) {
+    settings.permissions = settings.permissions.filter(
+      p => !managed.permissions_added.includes(p)
+    );
+    if (settings.permissions.length === 0) {
+      delete settings.permissions;
+    }
+  }
+
+  // Remove managed env vars
+  if (managed.env_added && settings.env) {
+    for (const key of managed.env_added) {
+      delete settings.env[key];
+    }
+    if (Object.keys(settings.env).length === 0) {
+      delete settings.env;
+    }
+  }
+
+  // Remove managed hooks (v2 format: identified by path pattern)
+  if (settings.hooks) {
+    const morphPattern = /framework\/hooks\/claude-code\//;
+    const oldPattern = /agent-teams\/dispatch\.js/;
+
+    for (const [event, entries] of Object.entries(settings.hooks)) {
+      if (!Array.isArray(entries)) continue;
+
+      settings.hooks[event] = entries.filter(entry => {
+        if (!Array.isArray(entry.hooks)) return true;
+        const nonMorphHooks = entry.hooks.filter(h =>
+          typeof h.command !== 'string' ||
+          (!morphPattern.test(h.command) && !oldPattern.test(h.command))
+        );
+        return nonMorphHooks.length > 0;
+      });
+
+      if (settings.hooks[event].length === 0) {
+        delete settings.hooks[event];
+      }
+    }
+    if (Object.keys(settings.hooks).length === 0) {
+      delete settings.hooks;
+    }
+  }
+
+  // Remove managed MCP servers from .mcp.json (primary location)
+  if (managed.mcps_installed) {
+    const mcpJson = await loadMcpJson(targetPath);
+    if (mcpJson.mcpServers) {
+      for (const mcpName of managed.mcps_installed) {
+        delete mcpJson.mcpServers[mcpName];
+      }
+      if (Object.keys(mcpJson.mcpServers).length === 0) {
+        delete mcpJson.mcpServers;
+      }
+      // Write back (or remove file if empty)
+      if (Object.keys(mcpJson).length === 0) {
+        const mcpJsonPath = join(targetPath, '.mcp.json');
+        if (existsSync(mcpJsonPath)) {
+          const { unlink } = await import('fs/promises');
+          await unlink(mcpJsonPath);
+        }
+      } else {
+        await saveMcpJson(targetPath, mcpJson);
+      }
+    }
+
+    // Also clean legacy entries from settings.local.json
+    if (settings.mcpServers) {
+      for (const mcpName of managed.mcps_installed) {
+        delete settings.mcpServers[mcpName];
+      }
+      if (Object.keys(settings.mcpServers).length === 0) {
+        delete settings.mcpServers;
+      }
+    }
+  }
+
+  // Remove the managed marker
+  delete settings[MORPH_MANAGED_KEY];
+
+  await saveSettings(targetPath, settings);
+
+  return {
+    removed: true,
+    backupPath,
+    permissionsRemoved: managed.permissions_added || [],
+    envRemoved: managed.env_added || [],
+    hooksRemoved: managed.hooks_added || [],
+    mcpsRemoved: managed.mcps_installed || [],
+    previouslyGenerated: managed.generated_at
+  };
+}
+
+/**
+ * Install MCP server entries into .mcp.json at the project root.
+ * Claude Code reads MCP servers from .mcp.json (not settings.local.json).
+ * Tracks installed names in settings.local.json _morph_managed.mcps_installed for safe reset.
+ *
+ * @param {string} targetPath - Project root directory
+ * @param {Object} servers - Map of server name → config { type?, command, args, env? }
+ * @returns {Promise<Object>} Summary of changes { added, skipped, total }
+ */
+export async function installMcpServers(targetPath, servers) {
+  const mcpJson = await loadMcpJson(targetPath);
+
+  mcpJson.mcpServers = mcpJson.mcpServers || {};
+
+  const added = [];
+  const skipped = [];
+
+  for (const [name, config] of Object.entries(servers)) {
+    if (mcpJson.mcpServers[name]) {
+      skipped.push(name);
+    } else {
+      mcpJson.mcpServers[name] = config;
+      added.push(name);
+    }
+  }
+
+  await saveMcpJson(targetPath, mcpJson);
+
+  // Track in settings.local.json _morph_managed
+  const settings = await loadSettings(targetPath);
+  settings[MORPH_MANAGED_KEY] = settings[MORPH_MANAGED_KEY] || {};
+  settings[MORPH_MANAGED_KEY].mcps_installed =
+    settings[MORPH_MANAGED_KEY].mcps_installed || [];
+  for (const name of added) {
+    if (!settings[MORPH_MANAGED_KEY].mcps_installed.includes(name)) {
+      settings[MORPH_MANAGED_KEY].mcps_installed.push(name);
+    }
+  }
+  settings[MORPH_MANAGED_KEY].generated_at = new Date().toISOString();
+
+  await saveSettings(targetPath, settings);
+
+  return { added, skipped, total: Object.keys(mcpJson.mcpServers).length };
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+async function loadMcpJson(targetPath) {
+  const mcpJsonPath = join(targetPath, '.mcp.json');
+  try {
+    if (!existsSync(mcpJsonPath)) return {};
+    return JSON.parse(await readFile(mcpJsonPath, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+async function saveMcpJson(targetPath, data) {
+  const mcpJsonPath = join(targetPath, '.mcp.json');
+  await writeFile(mcpJsonPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+
+async function loadSettings(targetPath) {
+  const settingsPath = join(targetPath, '.claude', 'settings.local.json');
+  try {
+    if (!existsSync(settingsPath)) return {};
+    return JSON.parse(await readFile(settingsPath, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+async function saveSettings(targetPath, settings) {
+  const claudeDir = join(targetPath, '.claude');
+  const settingsPath = join(claudeDir, 'settings.local.json');
+
+  if (!existsSync(claudeDir)) {
+    await mkdir(claudeDir, { recursive: true });
+  }
+
+  await writeFile(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+}

package/src/utils/file-copier.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import { join, dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
+import { WORKTREE_DIR_NAMES } from '../lib/worktree/dirs.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const frameworkRoot = join(__dirname, '..', '..');
@@ -137,12 +138,12 @@ export async function createDirectoryLink(target, link) {
   }
 }
 
-export async function updateGitignore(projectPath) {
-  const gitignorePath = join(projectPath, '.gitignore');
-
-  const morphRules = [
-    '',
-    '# MORPH-SPEC',
+/**
+ * The morph-owned block of the installed .gitignore. Exported so the worktree
+ * container canary (test/lib/worktree/dirs.test.js) can prove both names are
+ * covered without rendering a file.
+ */
+export const MORPH_GITIGNORE_ENTRIES = [
     // Derivable, per-machine state index — rebuilt from the committed
     // .morph/features/{feature}/feature.json files. Never commit it: doing so
     // sweeps every feature's accumulated diffs into one commit. The feature
@@ -165,19 +166,23 @@ export async function updateGitignore(projectPath) {
     '.claude/agents/',
     '.claude/CLAUDE.md',
     '.claude/settings.local.json',
-    '/worktrees/',
-    // Legacy name (pre-C1). Kept so a project that already has `.worktrees/`
-    // on disk does not suddenly see it as untracked dirt — which would also
-    // make `finish`'s clean-root check refuse.
-    '/.worktrees/',
+    // Both container names, anchored at the root. The legacy name (pre-C1) is
+    // kept so a project that already has `.worktrees/` on disk does not
+    // suddenly see it as untracked dirt — which would also make `finish`'s
+    // clean-root check refuse.
+    ...WORKTREE_DIR_NAMES.map((d) => `/${d}/`),
     '.playwright-mcp/',
     'docs/superpowers/',
     // Grafo de codebase — artefato derivado, reconstruído pelo hook do
     // graphify a cada commit. Committá-lo faria de todo commit um diff de
     // megabytes de JSON gerado.
     'graphify-out/',
-    ''
-  ];
+];
+
+export async function updateGitignore(projectPath) {
+  const gitignorePath = join(projectPath, '.gitignore');
+
+  const morphRules = ['', '# MORPH-SPEC', ...MORPH_GITIGNORE_ENTRIES, ''];
 
   let content = '';
   let hasMorphSection = false;