@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

package/src/utils/claude-md-injector.js

@@ -1,90 +1,90 @@
-/**
- * claude-md-injector.js
- *
- * Manages the root CLAUDE.md file in client projects.
- * Instead of overwriting the user's CLAUDE.md, injects an @import line
- * that references the morph-spec managed .claude/CLAUDE.md.
- *
- * The root CLAUDE.md belongs to the USER — morph-spec only adds its import.
- */
-
-import { pathExists, readFile, writeFile } from './file-copier.js';
-
-const MORPH_IMPORT = '@.claude/CLAUDE.md';
-const MORPH_MARKER = 'MORPH-SPEC';
-
-/**
- * Injects the morph-spec @import into the root CLAUDE.md.
- *
- * Three scenarios:
- * 1. No CLAUDE.md exists → create minimal file with the import
- * 2. Existing morph-only CLAUDE.md (old overwrite) → replace with minimal + import
- * 3. Existing user CLAUDE.md → append import section at the end
- *
- * Idempotent — does nothing if the import already exists.
- *
- * @param {string} claudeMdPath - Absolute path to root CLAUDE.md
- * @returns {Promise<'created'|'migrated'|'injected'|'already-present'>}
- */
-export async function injectMorphImport(claudeMdPath) {
-  if (!await pathExists(claudeMdPath)) {
-    await writeFile(claudeMdPath, `# Project\n\n${MORPH_IMPORT}\n`);
-    return 'created';
-  }
-
-  const content = await readFile(claudeMdPath);
-
-  if (content.includes(MORPH_IMPORT)) {
-    return 'already-present';
-  }
-
-  if (isMorphOnly(content)) {
-    await writeFile(claudeMdPath, `# Project\n\n${MORPH_IMPORT}\n`);
-    return 'migrated';
-  }
-
-  // User has their own content — append the import section
-  const separator = content.endsWith('\n') ? '\n' : '\n\n';
-  await writeFile(claudeMdPath, `${content}${separator}## MORPH-SPEC\n\n${MORPH_IMPORT}\n`);
-  return 'injected';
-}
-
-/**
- * Checks if CLAUDE.md contains ONLY morph-spec content (old overwrite pattern).
- * Heuristic: contains MORPH-SPEC marker AND no substantial user content.
- */
-function isMorphOnly(content) {
-  if (!content.includes(MORPH_MARKER)) return false;
-
-  // Strip morph-spec boilerplate markers and check if anything meaningful remains
-  const stripped = content
-    .replace(/# MORPH-SPEC Runtime Instructions/g, '')
-    .replace(/by Polymorphism Tech[^\n]*/g, '')
-    .replace(/\*MORPH-SPEC by Polymorphism Tech\*/g, '')
-    .replace(/@\.morph\/context\/README\.md/g, '')
-    .replace(/@\.claude\/CLAUDE\.md/g, '')
-    .replace(/## Critical Rules[\s\S]*?(?=##|$)/g, '')
-    .replace(/## Quick Reference[\s\S]*?(?=##|$)/g, '')
-    .replace(/## State & Outputs[\s\S]*?(?=##|$)/g, '')
-    .replace(/## Phase Sequence[\s\S]*?(?=##|$)/g, '')
-    .replace(/## Agents[\s\S]*?(?=##|$)/g, '')
-    .replace(/## Context Window Tip[\s\S]*?(?=##|$)/g, '')
-    .replace(/## Project Context[\s\S]*?(?=##|$)/g, '')
-    .replace(/[#\-|>*`\s]/g, '');
-
-  return stripped.length < 50;
-}
-
-/**
- * Checks if the root CLAUDE.md has the morph-spec import.
- * Used by doctor.js for health checks.
- *
- * @param {string} claudeMdPath - Absolute path to root CLAUDE.md
- * @returns {Promise<'ok'|'missing'|'missing-import'>}
- */
-export async function checkClaudeMdImport(claudeMdPath) {
-  if (!await pathExists(claudeMdPath)) return 'missing';
-  const content = await readFile(claudeMdPath);
-  if (content.includes(MORPH_IMPORT)) return 'ok';
-  return 'missing-import';
-}
+/**
+ * claude-md-injector.js
+ *
+ * Manages the root CLAUDE.md file in client projects.
+ * Instead of overwriting the user's CLAUDE.md, injects an @import line
+ * that references the morph-spec managed .claude/CLAUDE.md.
+ *
+ * The root CLAUDE.md belongs to the USER — morph-spec only adds its import.
+ */
+
+import { pathExists, readFile, writeFile } from './file-copier.js';
+
+const MORPH_IMPORT = '@.claude/CLAUDE.md';
+const MORPH_MARKER = 'MORPH-SPEC';
+
+/**
+ * Injects the morph-spec @import into the root CLAUDE.md.
+ *
+ * Three scenarios:
+ * 1. No CLAUDE.md exists → create minimal file with the import
+ * 2. Existing morph-only CLAUDE.md (old overwrite) → replace with minimal + import
+ * 3. Existing user CLAUDE.md → append import section at the end
+ *
+ * Idempotent — does nothing if the import already exists.
+ *
+ * @param {string} claudeMdPath - Absolute path to root CLAUDE.md
+ * @returns {Promise<'created'|'migrated'|'injected'|'already-present'>}
+ */
+export async function injectMorphImport(claudeMdPath) {
+  if (!await pathExists(claudeMdPath)) {
+    await writeFile(claudeMdPath, `# Project\n\n${MORPH_IMPORT}\n`);
+    return 'created';
+  }
+
+  const content = await readFile(claudeMdPath);
+
+  if (content.includes(MORPH_IMPORT)) {
+    return 'already-present';
+  }
+
+  if (isMorphOnly(content)) {
+    await writeFile(claudeMdPath, `# Project\n\n${MORPH_IMPORT}\n`);
+    return 'migrated';
+  }
+
+  // User has their own content — append the import section
+  const separator = content.endsWith('\n') ? '\n' : '\n\n';
+  await writeFile(claudeMdPath, `${content}${separator}## MORPH-SPEC\n\n${MORPH_IMPORT}\n`);
+  return 'injected';
+}
+
+/**
+ * Checks if CLAUDE.md contains ONLY morph-spec content (old overwrite pattern).
+ * Heuristic: contains MORPH-SPEC marker AND no substantial user content.
+ */
+function isMorphOnly(content) {
+  if (!content.includes(MORPH_MARKER)) return false;
+
+  // Strip morph-spec boilerplate markers and check if anything meaningful remains
+  const stripped = content
+    .replace(/# MORPH-SPEC Runtime Instructions/g, '')
+    .replace(/by Polymorphism Tech[^\n]*/g, '')
+    .replace(/\*MORPH-SPEC by Polymorphism Tech\*/g, '')
+    .replace(/@\.morph\/context\/README\.md/g, '')
+    .replace(/@\.claude\/CLAUDE\.md/g, '')
+    .replace(/## Critical Rules[\s\S]*?(?=##|$)/g, '')
+    .replace(/## Quick Reference[\s\S]*?(?=##|$)/g, '')
+    .replace(/## State & Outputs[\s\S]*?(?=##|$)/g, '')
+    .replace(/## Phase Sequence[\s\S]*?(?=##|$)/g, '')
+    .replace(/## Agents[\s\S]*?(?=##|$)/g, '')
+    .replace(/## Context Window Tip[\s\S]*?(?=##|$)/g, '')
+    .replace(/## Project Context[\s\S]*?(?=##|$)/g, '')
+    .replace(/[#\-|>*`\s]/g, '');
+
+  return stripped.length < 50;
+}
+
+/**
+ * Checks if the root CLAUDE.md has the morph-spec import.
+ * Used by doctor.js for health checks.
+ *
+ * @param {string} claudeMdPath - Absolute path to root CLAUDE.md
+ * @returns {Promise<'ok'|'missing'|'missing-import'>}
+ */
+export async function checkClaudeMdImport(claudeMdPath) {
+  if (!await pathExists(claudeMdPath)) return 'missing';
+  const content = await readFile(claudeMdPath);
+  if (content.includes(MORPH_IMPORT)) return 'ok';
+  return 'missing-import';
+}

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, installVSCodeTerminalSettings, installShellIntegration, getHooksVersion } from './hooks-installer.js';
+export { installClaudeHooks, installGlobalStatusline, getHooksVersion } from './hooks-installer.js';
 export { installAgents } from './agents-installer.js';
 
 // ============================================================================

package/src/utils/file-copier.js

@@ -1,196 +1,200 @@
-import fs from 'fs-extra';
-import { join, dirname, resolve } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const frameworkRoot = join(__dirname, '..', '..');
-
-function isSamePath(a, b) {
-  return resolve(a) === resolve(b);
-}
-
-export function getContentDir() {
-  return frameworkRoot;
-}
-
-export async function copyDirectory(src, dest, options = {}) {
-  if (isSamePath(src, dest)) return;
-
-  const { filter, overwrite = true } = options;
-
-  await fs.copy(src, dest, {
-    overwrite,
-    filter: filter || (() => true),
-    errorOnExist: false
-  });
-}
-
-export async function copyFile(src, dest) {
-  if (isSamePath(src, dest)) return;
-
-  await fs.ensureDir(dirname(dest));
-  await fs.copy(src, dest, { overwrite: true });
-}
-
-export async function pathExists(path) {
-  return fs.pathExists(path);
-}
-
-export async function readJson(path) {
-  return fs.readJson(path);
-}
-
-export async function writeJson(path, data) {
-  await fs.ensureDir(dirname(path));
-  await fs.writeJson(path, data, { spaces: 2 });
-}
-
-export async function ensureDir(path) {
-  await fs.ensureDir(path);
-}
-
-export async function writeFile(path, content) {
-  await fs.ensureDir(dirname(path));
-  await fs.writeFile(path, content, 'utf8');
-}
-
-export async function removeDir(path) {
-  await fs.remove(path);
-}
-
-export async function readFile(path) {
-  return fs.readFile(path, 'utf8');
-}
-
-/**
- * Create symlink with fallback to copy if symlink fails
- * @param {string} target - Path to the original file/folder
- * @param {string} link - Path where symlink should be created
- * @param {string} type - 'file' or 'dir'
- * @returns {Promise<'symlink' | 'copy'>} - Returns how the link was created
- */
-export async function createSymlink(target, link, type = 'file') {
-  await fs.ensureDir(dirname(link));
-
-  try {
-    // Try to create symlink
-    await fs.ensureSymlink(target, link, type);
-    return 'symlink';
-  } catch (error) {
-    // Fallback: copy the file/directory if symlink fails
-    // (Windows may require admin permissions for symlinks)
-    if (type === 'file') {
-      await copyFile(target, link);
-    } else {
-      await copyDirectory(target, link);
-    }
-    return 'copy';
-  }
-}
-
-/**
- * Create a directory link (junction on Windows, symlink on other platforms)
- * with fallback to directory copy if linking fails.
- * @param {string} target - Path to the original directory
- * @param {string} link - Path where the link should be created
- * @returns {Promise<'junction' | 'symlink' | 'copy'>} - How the link was created
- */
-export async function createDirectoryLink(target, link) {
-  await fs.ensureDir(dirname(link));
-
-  // Remove existing link/directory before recreating
-  if (await pathExists(link)) {
-    await fs.remove(link);
-  }
-
-  if (process.platform === 'win32') {
-    try {
-      // Junction on Windows - does NOT require admin privileges
-      await fs.symlink(target, link, 'junction');
-      return 'junction';
-    } catch {
-      try {
-        await fs.ensureSymlink(target, link, 'dir');
-        return 'symlink';
-      } catch {
-        await copyDirectory(target, link);
-        return 'copy';
-      }
-    }
-  } else {
-    try {
-      await fs.ensureSymlink(target, link, 'dir');
-      return 'symlink';
-    } catch {
-      await copyDirectory(target, link);
-      return 'copy';
-    }
-  }
-}
-
-export async function updateGitignore(projectPath) {
-  const gitignorePath = join(projectPath, '.gitignore');
-
-  const morphRules = [
-    '',
-    '# MORPH-SPEC',
-    '.morph/framework/',
-    '.morph/memory/',
-    '.morph/plans/',
-    '.morph/analytics/',
-    '.claude/commands/',
-    '.claude/rules/',
-    '.claude/skills/',
-    '.claude/agents/',
-    '.claude/CLAUDE.md',
-    '.claude/settings.local.json',
-    '.worktrees/',
-    ''
-  ];
-
-  let content = '';
-  let hasMorphSection = false;
-
-  // Read existing .gitignore if it exists
-  if (await pathExists(gitignorePath)) {
-    content = await readFile(gitignorePath);
-    hasMorphSection = content.includes('# MORPH-SPEC');
-  }
-
-  // If MORPH section already exists, check if rules are up to date
-  if (hasMorphSection) {
-    const lines = content.split('\n');
-    const morphStartIndex = lines.findIndex(line => line.trim() === '# MORPH-SPEC');
-
-    // Find the end of MORPH section (next empty line or section header)
-    let morphEndIndex = morphStartIndex + 1;
-    while (morphEndIndex < lines.length &&
-           lines[morphEndIndex].trim() !== '' &&
-           !lines[morphEndIndex].startsWith('#')) {
-      morphEndIndex++;
-    }
-
-    // Extract current MORPH rules
-    const currentMorphRules = lines.slice(morphStartIndex, morphEndIndex + 1);
-    const expectedMorphRules = morphRules.slice(1, -1); // Remove empty lines from comparison
-
-    // Check if all expected rules are present
-    const missingRules = expectedMorphRules.filter(rule =>
-      rule.startsWith('#') || !currentMorphRules.some(line => line.trim() === rule)
-    );
-
-    if (missingRules.length > 0) {
-      // Update the section with all rules
-      lines.splice(morphStartIndex, morphEndIndex - morphStartIndex, ...morphRules.slice(1, -1));
-      content = lines.join('\n');
-    }
-  } else {
-    // Add MORPH section
-    if (content && !content.endsWith('\n')) {
-      content += '\n';
-    }
-    content += morphRules.join('\n');
-  }
-
-  await writeFile(gitignorePath, content);
-}
+import fs from 'fs-extra';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const frameworkRoot = join(__dirname, '..', '..');
+
+function isSamePath(a, b) {
+  return resolve(a) === resolve(b);
+}
+
+export function getContentDir() {
+  return frameworkRoot;
+}
+
+export async function copyDirectory(src, dest, options = {}) {
+  if (isSamePath(src, dest)) return;
+
+  const { filter, overwrite = true } = options;
+
+  await fs.copy(src, dest, {
+    overwrite,
+    filter: filter || (() => true),
+    errorOnExist: false
+  });
+}
+
+export async function copyFile(src, dest) {
+  if (isSamePath(src, dest)) return;
+
+  await fs.ensureDir(dirname(dest));
+  await fs.copy(src, dest, { overwrite: true });
+}
+
+export async function pathExists(path) {
+  return fs.pathExists(path);
+}
+
+export async function readJson(path) {
+  return fs.readJson(path);
+}
+
+export async function writeJson(path, data) {
+  await fs.ensureDir(dirname(path));
+  await fs.writeJson(path, data, { spaces: 2 });
+}
+
+export async function ensureDir(path) {
+  await fs.ensureDir(path);
+}
+
+export async function writeFile(path, content) {
+  await fs.ensureDir(dirname(path));
+  await fs.writeFile(path, content, 'utf8');
+}
+
+export async function removeDir(path) {
+  await fs.remove(path);
+}
+
+export async function readFile(path) {
+  return fs.readFile(path, 'utf8');
+}
+
+/**
+ * Create a link to a file or directory with platform-aware fallbacks.
+ *
+ * For files: hard link → symlink → copy
+ *   Hard links work on Windows without admin (same NTFS volume).
+ * For dirs: delegates to createDirectoryLink (junction on Windows).
+ *
+ * @param {string} target - Path to the original file/folder
+ * @param {string} link - Path where the link should be created
+ * @param {string} type - 'file' or 'dir'
+ * @returns {Promise<'hardlink' | 'symlink' | 'junction' | 'copy'>}
+ */
+export async function createSymlink(target, link, type = 'file') {
+  await fs.ensureDir(dirname(link));
+
+  if (type === 'dir') {
+    return createDirectoryLink(target, link);
+  }
+
+  // File linking: hard link first (no admin on Windows), then symlink, then copy
+  try {
+    await fs.link(target, link);
+    return 'hardlink';
+  } catch {
+    try {
+      await fs.ensureSymlink(target, link, 'file');
+      return 'symlink';
+    } catch {
+      await copyFile(target, link);
+      return 'copy';
+    }
+  }
+}
+
+/**
+ * Create a directory link (junction on Windows, symlink on other platforms)
+ * with fallback to directory copy if linking fails.
+ * @param {string} target - Path to the original directory
+ * @param {string} link - Path where the link should be created
+ * @returns {Promise<'junction' | 'symlink' | 'copy'>} - How the link was created
+ */
+export async function createDirectoryLink(target, link) {
+  await fs.ensureDir(dirname(link));
+
+  // Remove existing link/directory before recreating
+  if (await pathExists(link)) {
+    await fs.remove(link);
+  }
+
+  if (process.platform === 'win32') {
+    // Junction on Windows — does NOT require admin privileges.
+    // Skip ensureSymlink('dir') fallback: it also needs admin on Windows.
+    try {
+      await fs.symlink(target, link, 'junction');
+      return 'junction';
+    } catch {
+      await copyDirectory(target, link);
+      return 'copy';
+    }
+  } else {
+    try {
+      await fs.ensureSymlink(target, link, 'dir');
+      return 'symlink';
+    } catch {
+      await copyDirectory(target, link);
+      return 'copy';
+    }
+  }
+}
+
+export async function updateGitignore(projectPath) {
+  const gitignorePath = join(projectPath, '.gitignore');
+
+  const morphRules = [
+    '',
+    '# MORPH-SPEC',
+    '.morph/framework/',
+    '.morph/memory/',
+    '.morph/plans/',
+    '.morph/analytics/',
+    '.claude/commands/',
+    '.claude/rules/',
+    '.claude/skills/',
+    '.claude/agents/',
+    '.claude/CLAUDE.md',
+    '.claude/settings.local.json',
+    '.worktrees/',
+    ''
+  ];
+
+  let content = '';
+  let hasMorphSection = false;
+
+  // Read existing .gitignore if it exists
+  if (await pathExists(gitignorePath)) {
+    content = await readFile(gitignorePath);
+    hasMorphSection = content.includes('# MORPH-SPEC');
+  }
+
+  // If MORPH section already exists, check if rules are up to date
+  if (hasMorphSection) {
+    const lines = content.split('\n');
+    const morphStartIndex = lines.findIndex(line => line.trim() === '# MORPH-SPEC');
+
+    // Find the end of MORPH section (next empty line or section header)
+    let morphEndIndex = morphStartIndex + 1;
+    while (morphEndIndex < lines.length &&
+           lines[morphEndIndex].trim() !== '' &&
+           !lines[morphEndIndex].startsWith('#')) {
+      morphEndIndex++;
+    }
+
+    // Extract current MORPH rules
+    const currentMorphRules = lines.slice(morphStartIndex, morphEndIndex + 1);
+    const expectedMorphRules = morphRules.slice(1, -1); // Remove empty lines from comparison
+
+    // Check if all expected rules are present
+    const missingRules = expectedMorphRules.filter(rule =>
+      rule.startsWith('#') || !currentMorphRules.some(line => line.trim() === rule)
+    );
+
+    if (missingRules.length > 0) {
+      // Update the section with all rules
+      lines.splice(morphStartIndex, morphEndIndex - morphStartIndex, ...morphRules.slice(1, -1));
+      content = lines.join('\n');
+    }
+  } else {
+    // Add MORPH section
+    if (content && !content.endsWith('\n')) {
+      content += '\n';
+    }
+    content += morphRules.join('\n');
+  }
+
+  await writeFile(gitignorePath, content);
+}