@polymorphism-tech/morph-spec 4.10.9 → 4.11.0

package/src/scripts/global-install.js

@@ -1,58 +1,112 @@
-// src/scripts/global-install.js
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { homedir } from 'os';
-import { mkdir, copyFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import { installGlobalStatusline } from '../utils/hooks-installer.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const FRAMEWORK_DIR = join(__dirname, '..', '..', 'framework');
-
-/**
- * Install morph-init skill to a Claude global skills directory.
- * @param {string} claudeDir - target ~/.claude dir (defaults to real ~/.claude)
- */
-export async function installGlobalSkill(claudeDir = join(homedir(), '.claude')) {
-  const src = join(FRAMEWORK_DIR, 'skills', 'level-0-meta', 'morph-init', 'SKILL.md');
-  const destDir = join(claudeDir, 'skills', 'morph-init');
-  const dest = join(destDir, 'SKILL.md');
-
-  if (!existsSync(src)) {
-    console.warn(`morph-init skill not found at ${src} — skipping global install`);
-    return;
-  }
-
-  await mkdir(destDir, { recursive: true });
-  await copyFile(src, dest);
-}
-
-// Run as postinstall script
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
-  const { readFileSync } = await import('fs');
-  const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
-
-  const [skillResult, statuslineResult] = await Promise.allSettled([
-    installGlobalSkill(),
-    installGlobalStatusline(HOOKS_SRC),
-  ]);
-
-  const results = [
-    {
-      ok: skillResult.status === 'fulfilled',
-      label: 'morph-init skill',
-      path: '~/.claude/skills/',
-      error: skillResult.reason?.message,
-    },
-    {
-      ok: statuslineResult.status === 'fulfilled',
-      label: 'statusline',
-      path: '~/.claude/',
-      error: statuslineResult.reason?.message,
-    },
-  ];
-
-  const { printInstallBanner } = await import('../utils/banner.js');
-  printInstallBanner({ version: pkg.version, nodeVersion: process.version, results });
-}
+// src/scripts/global-install.js
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir, platform } from 'os';
+import { mkdir, copyFile, readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { execSync } from 'child_process';
+import { installGlobalStatusline } from '../utils/hooks-installer.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FRAMEWORK_DIR = join(__dirname, '..', '..', 'framework');
+
+/**
+ * Install morph-init skill to a Claude global skills directory.
+ * @param {string} claudeDir - target ~/.claude dir (defaults to real ~/.claude)
+ */
+export async function installGlobalSkill(claudeDir = join(homedir(), '.claude')) {
+  const src = join(FRAMEWORK_DIR, 'skills', 'level-0-meta', 'morph-init', 'SKILL.md');
+  const destDir = join(claudeDir, 'skills', 'morph-init');
+  const dest = join(destDir, 'SKILL.md');
+
+  if (!existsSync(src)) {
+    console.warn(`morph-init skill not found at ${src} — skipping global install`);
+    return;
+  }
+
+  await mkdir(destDir, { recursive: true });
+  await copyFile(src, dest);
+}
+
+/**
+ * Ensure the npm global bin directory is in the user's PATH on Windows.
+ * Adds it to the PowerShell $PROFILE so new terminals find `morph-spec`.
+ */
+export async function ensureNpmGlobalInPath() {
+  if (platform() !== 'win32') return;
+
+  let npmGlobalDir;
+  try {
+    npmGlobalDir = execSync('npm prefix -g', { encoding: 'utf8' }).trim();
+  } catch {
+    return; // can't determine npm global dir
+  }
+
+  if (!npmGlobalDir || !existsSync(npmGlobalDir)) return;
+
+  // --- PowerShell $PROFILE ---
+  const psProfile = join(homedir(), 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1');
+  const psProfileLegacy = join(homedir(), 'Documents', 'WindowsPowerShell', 'Microsoft.PowerShell_profile.ps1');
+
+  const marker = '# morph-spec: ensure npm global in PATH';
+  const snippet = [
+    marker,
+    `if ($env:PATH -notlike "*${npmGlobalDir.replace(/\\/g, '\\\\')}*") {`,
+    `  $env:PATH += ";${npmGlobalDir}"`,
+    '}',
+    '# end morph-spec PATH',
+  ].join('\n');
+
+  for (const profilePath of [psProfile, psProfileLegacy]) {
+    try {
+      let content = '';
+      if (existsSync(profilePath)) {
+        content = await readFile(profilePath, 'utf8');
+        if (content.includes(marker)) continue; // already patched
+      } else {
+        await mkdir(dirname(profilePath), { recursive: true });
+      }
+      const newContent = content ? `${content}\n\n${snippet}\n` : `${snippet}\n`;
+      await writeFile(profilePath, newContent, 'utf8');
+    } catch {
+      // non-critical — skip silently
+    }
+  }
+}
+
+// Run as postinstall script
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
+  const { readFileSync } = await import('fs');
+  const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+
+  const [skillResult, statuslineResult, pathResult] = await Promise.allSettled([
+    installGlobalSkill(),
+    installGlobalStatusline(HOOKS_SRC),
+    ensureNpmGlobalInPath(),
+  ]);
+
+  const results = [
+    {
+      ok: skillResult.status === 'fulfilled',
+      label: 'morph-init skill',
+      path: '~/.claude/skills/',
+      error: skillResult.reason?.message,
+    },
+    {
+      ok: statuslineResult.status === 'fulfilled',
+      label: 'statusline',
+      path: '~/.claude/',
+      error: statuslineResult.reason?.message,
+    },
+    {
+      ok: pathResult.status === 'fulfilled',
+      label: 'PATH (npm global)',
+      path: '$PROFILE',
+      error: pathResult.reason?.message,
+    },
+  ];
+
+  const { printInstallBanner } = await import('../utils/banner.js');
+  printInstallBanner({ version: pkg.version, nodeVersion: process.version, results });
+}

package/src/scripts/install-plugin.js

@@ -1,126 +1,126 @@
-// src/scripts/install-plugin.js
-import { join } from 'path';
-import { homedir } from 'os';
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
-import { mkdir, writeFile } from 'fs/promises';
-import https from 'node:https';
-
-const PLUGINS_DIR = join(homedir(), '.claude', 'plugins');
-const CACHE_DIR = join(PLUGINS_DIR, 'cache', 'claude-plugins-official');
-const INSTALLED_FILE = join(PLUGINS_DIR, 'installed_plugins.json');
-const GH_REPO = 'anthropics/claude-plugins-official';
-
-/** Fetch JSON from GitHub API (no auth — public repo) */
-async function fetchGitHub(path) {
-  return new Promise((resolve, reject) => {
-    const opts = {
-      hostname: 'api.github.com',
-      path,
-      headers: { 'User-Agent': 'morph-spec', 'Accept': 'application/vnd.github.v3+json' }
-    };
-    https.get(opts, (res) => {
-      let data = '';
-      res.on('data', c => data += c);
-      res.on('end', () => {
-        try { resolve(JSON.parse(data)); }
-        catch (e) { reject(new Error(`GitHub API parse error: ${data.slice(0, 200)}`)); }
-      });
-    }).on('error', reject);
-  });
-}
-
-/** Download raw file content from a URL, following one redirect */
-async function downloadFile(rawUrl) {
-  return new Promise((resolve, reject) => {
-    const doGet = (url) => {
-      const parsed = new URL(url);
-      https.get({
-        hostname: parsed.hostname,
-        path: parsed.pathname + parsed.search,
-        headers: { 'User-Agent': 'morph-spec' }
-      }, (res) => {
-        if (res.statusCode === 301 || res.statusCode === 302) {
-          return doGet(res.headers.location);
-        }
-        const chunks = [];
-        res.on('data', c => chunks.push(c));
-        res.on('end', () => resolve(Buffer.concat(chunks)));
-      }).on('error', reject);
-    };
-    doGet(rawUrl);
-  });
-}
-
-/** Read installed_plugins.json safely */
-export function readInstalledPlugins() {
-  if (!existsSync(INSTALLED_FILE)) return { version: 2, plugins: {} };
-  try { return JSON.parse(readFileSync(INSTALLED_FILE, 'utf8')); }
-  catch { return { version: 2, plugins: {} }; }
-}
-
-/** Check if plugin key exists in the plugins map */
-export function isPluginInstalled(plugins, name) {
-  return `${name}@claude-plugins-official` in plugins;
-}
-
-/** Build an installed_plugins.json entry */
-export function buildInstallEntry(pluginName, installPath, gitCommitSha, version) {
-  const now = new Date().toISOString();
-  return { scope: 'user', installPath, version, installedAt: now, lastUpdated: now, gitCommitSha };
-}
-
-/** Resolve latest commit SHA for a plugin path in the repo */
-export async function resolvePluginVersion(pluginName) {
-  const commits = await fetchGitHub(`/repos/${GH_REPO}/commits?path=${pluginName}&per_page=1`);
-  if (!Array.isArray(commits) || commits.length === 0) {
-    throw new Error(`Could not resolve version for plugin: ${pluginName}`);
-  }
-  const sha = commits[0].sha;
-  return { sha, shortSha: sha.slice(0, 12) };
-}
-
-/** Download all files for a plugin from the repo tree */
-async function downloadPluginFiles(pluginName, sha, destDir) {
-  const tree = await fetchGitHub(`/repos/${GH_REPO}/git/trees/${sha}?recursive=1`);
-  if (!tree.tree) throw new Error('GitHub tree API returned unexpected shape');
-
-  const pluginFiles = tree.tree.filter(f => f.path.startsWith(`${pluginName}/`) && f.type === 'blob');
-  if (pluginFiles.length === 0) throw new Error(`Plugin "${pluginName}" not found in repository`);
-
-  for (const file of pluginFiles) {
-    const relativePath = file.path.slice(pluginName.length + 1);
-    const destPath = join(destDir, relativePath);
-    await mkdir(join(destPath, '..'), { recursive: true });
-    const content = await downloadFile(
-      `https://raw.githubusercontent.com/${GH_REPO}/${sha}/${file.path}`
-    );
-    await writeFile(destPath, content);
-  }
-}
-
-/**
- * Install a Claude Code plugin from GitHub.
- * @param {string} pluginName - e.g. "superpowers"
- * @returns {{ installed: boolean, version: string, alreadyInstalled: boolean }}
- */
-export async function installPlugin(pluginName) {
-  const data = readInstalledPlugins();
-  if (isPluginInstalled(data.plugins, pluginName)) {
-    const existing = data.plugins[`${pluginName}@claude-plugins-official`];
-    const version = Array.isArray(existing) ? existing[0]?.version : 'unknown';
-    return { installed: true, alreadyInstalled: true, version };
-  }
-
-  const { sha, shortSha } = await resolvePluginVersion(pluginName);
-  const installPath = join(CACHE_DIR, pluginName, shortSha);
-
-  await mkdir(installPath, { recursive: true });
-  await downloadPluginFiles(pluginName, sha, installPath);
-
-  const entry = buildInstallEntry(pluginName, installPath, sha, shortSha);
-  data.plugins[`${pluginName}@claude-plugins-official`] = [entry];
-  mkdirSync(PLUGINS_DIR, { recursive: true });
-  writeFileSync(INSTALLED_FILE, JSON.stringify(data, null, 2));
-
-  return { installed: true, alreadyInstalled: false, version: shortSha };
-}
+// src/scripts/install-plugin.js
+import { join } from 'path';
+import { homedir } from 'os';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { mkdir, writeFile } from 'fs/promises';
+import https from 'node:https';
+
+const PLUGINS_DIR = join(homedir(), '.claude', 'plugins');
+const CACHE_DIR = join(PLUGINS_DIR, 'cache', 'claude-plugins-official');
+const INSTALLED_FILE = join(PLUGINS_DIR, 'installed_plugins.json');
+const GH_REPO = 'anthropics/claude-plugins-official';
+
+/** Fetch JSON from GitHub API (no auth — public repo) */
+async function fetchGitHub(path) {
+  return new Promise((resolve, reject) => {
+    const opts = {
+      hostname: 'api.github.com',
+      path,
+      headers: { 'User-Agent': 'morph-spec', 'Accept': 'application/vnd.github.v3+json' }
+    };
+    https.get(opts, (res) => {
+      let data = '';
+      res.on('data', c => data += c);
+      res.on('end', () => {
+        try { resolve(JSON.parse(data)); }
+        catch (e) { reject(new Error(`GitHub API parse error: ${data.slice(0, 200)}`)); }
+      });
+    }).on('error', reject);
+  });
+}
+
+/** Download raw file content from a URL, following one redirect */
+async function downloadFile(rawUrl) {
+  return new Promise((resolve, reject) => {
+    const doGet = (url) => {
+      const parsed = new URL(url);
+      https.get({
+        hostname: parsed.hostname,
+        path: parsed.pathname + parsed.search,
+        headers: { 'User-Agent': 'morph-spec' }
+      }, (res) => {
+        if (res.statusCode === 301 || res.statusCode === 302) {
+          return doGet(res.headers.location);
+        }
+        const chunks = [];
+        res.on('data', c => chunks.push(c));
+        res.on('end', () => resolve(Buffer.concat(chunks)));
+      }).on('error', reject);
+    };
+    doGet(rawUrl);
+  });
+}
+
+/** Read installed_plugins.json safely */
+export function readInstalledPlugins() {
+  if (!existsSync(INSTALLED_FILE)) return { version: 2, plugins: {} };
+  try { return JSON.parse(readFileSync(INSTALLED_FILE, 'utf8')); }
+  catch { return { version: 2, plugins: {} }; }
+}
+
+/** Check if plugin key exists in the plugins map */
+export function isPluginInstalled(plugins, name) {
+  return `${name}@claude-plugins-official` in plugins;
+}
+
+/** Build an installed_plugins.json entry */
+export function buildInstallEntry(pluginName, installPath, gitCommitSha, version) {
+  const now = new Date().toISOString();
+  return { scope: 'user', installPath, version, installedAt: now, lastUpdated: now, gitCommitSha };
+}
+
+/** Resolve latest commit SHA for a plugin path in the repo */
+export async function resolvePluginVersion(pluginName) {
+  const commits = await fetchGitHub(`/repos/${GH_REPO}/commits?path=${pluginName}&per_page=1`);
+  if (!Array.isArray(commits) || commits.length === 0) {
+    throw new Error(`Could not resolve version for plugin: ${pluginName}`);
+  }
+  const sha = commits[0].sha;
+  return { sha, shortSha: sha.slice(0, 12) };
+}
+
+/** Download all files for a plugin from the repo tree */
+async function downloadPluginFiles(pluginName, sha, destDir) {
+  const tree = await fetchGitHub(`/repos/${GH_REPO}/git/trees/${sha}?recursive=1`);
+  if (!tree.tree) throw new Error('GitHub tree API returned unexpected shape');
+
+  const pluginFiles = tree.tree.filter(f => f.path.startsWith(`${pluginName}/`) && f.type === 'blob');
+  if (pluginFiles.length === 0) throw new Error(`Plugin "${pluginName}" not found in repository`);
+
+  for (const file of pluginFiles) {
+    const relativePath = file.path.slice(pluginName.length + 1);
+    const destPath = join(destDir, relativePath);
+    await mkdir(join(destPath, '..'), { recursive: true });
+    const content = await downloadFile(
+      `https://raw.githubusercontent.com/${GH_REPO}/${sha}/${file.path}`
+    );
+    await writeFile(destPath, content);
+  }
+}
+
+/**
+ * Install a Claude Code plugin from GitHub.
+ * @param {string} pluginName - e.g. "superpowers"
+ * @returns {{ installed: boolean, version: string, alreadyInstalled: boolean }}
+ */
+export async function installPlugin(pluginName) {
+  const data = readInstalledPlugins();
+  if (isPluginInstalled(data.plugins, pluginName)) {
+    const existing = data.plugins[`${pluginName}@claude-plugins-official`];
+    const version = Array.isArray(existing) ? existing[0]?.version : 'unknown';
+    return { installed: true, alreadyInstalled: true, version };
+  }
+
+  const { sha, shortSha } = await resolvePluginVersion(pluginName);
+  const installPath = join(CACHE_DIR, pluginName, shortSha);
+
+  await mkdir(installPath, { recursive: true });
+  await downloadPluginFiles(pluginName, sha, installPath);
+
+  const entry = buildInstallEntry(pluginName, installPath, sha, shortSha);
+  data.plugins[`${pluginName}@claude-plugins-official`] = [entry];
+  mkdirSync(PLUGINS_DIR, { recursive: true });
+  writeFileSync(INSTALLED_FILE, JSON.stringify(data, null, 2));
+
+  return { installed: true, alreadyInstalled: false, version: shortSha };
+}

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';
+}