@polymorphism-tech/morph-spec 7.9.4 → 8.0.0

package/src/lib/detectors/claude-config-detector.js

@@ -1,152 +1,152 @@
-/**
- * @fileoverview Claude Config Detector
- *
- * Scans .claude/ settings and plugins for MCP servers, hooks, skills, and commands.
- * Used by mcp-setup and session-start hooks.
- *
- * @module detectors/claude-config-detector
- */
-
-import { existsSync, readFileSync, readdirSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
-/**
- * Detect Claude Code configuration for a project.
- *
- * @param {string} targetPath - Root path of the project
- * @returns {{ plugins: string[], mcpServers: Array<{name: string, config: Object}>, superpowers: boolean, customSkills: string[], customCommands: string[], hooks: string[] }}
- */
-export function detectClaudeConfig(targetPath) {
-  const result = {
-    plugins: [],
-    mcpServers: [],
-    superpowers: false,
-    customSkills: [],
-    customCommands: [],
-    hooks: [],
-  };
-
-  const mcpJsonNames = new Set();
-
-  try {
-    // ── MCP Servers from .mcp.json (primary — Claude Code reads this) ───────
-    const mcpJsonPath = join(targetPath, '.mcp.json');
-    if (existsSync(mcpJsonPath)) {
-      try {
-        const mcpJson = JSON.parse(readFileSync(mcpJsonPath, 'utf8'));
-        const mcps = mcpJson.mcpServers || {};
-        for (const [name, config] of Object.entries(mcps)) {
-          result.mcpServers.push({ name, config });
-          mcpJsonNames.add(name);
-        }
-      } catch { /* invalid JSON */ }
-    }
-
-    // ── MCP Servers + hooks from settings (legacy + hooks/permissions) ───────
-    const settingsPaths = [
-      join(targetPath, '.claude', 'settings.json'),
-      join(targetPath, '.claude', 'settings.local.json'),
-    ];
-
-    for (const sp of settingsPaths) {
-      if (existsSync(sp)) {
-        try {
-          const settings = JSON.parse(readFileSync(sp, 'utf8'));
-          // Legacy MCP entries — skip if already in .mcp.json, but allow later settings files to override earlier ones
-          const mcps = settings.mcpServers || {};
-          for (const [name, config] of Object.entries(mcps)) {
-            if (mcpJsonNames.has(name)) continue; // .mcp.json takes priority
-            const idx = result.mcpServers.findIndex(m => m.name === name);
-            if (idx >= 0) {
-              result.mcpServers[idx] = { name, config }; // later file wins
-            } else {
-              result.mcpServers.push({ name, config });
-            }
-          }
-
-          // Collect hooks
-          if (settings.hooks) {
-            for (const [event, eventHooks] of Object.entries(settings.hooks)) {
-              for (const group of (Array.isArray(eventHooks) ? eventHooks : [])) {
-                for (const h of (group.hooks || [])) {
-                  result.hooks.push(`${event}:${h.type || 'unknown'}`);
-                }
-              }
-            }
-          }
-        } catch { /* invalid JSON */ }
-      }
-    }
-
-    // ── Plugins from global config ──────────────────────────────────────────
-    const pluginsPath = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
-    if (existsSync(pluginsPath)) {
-      try {
-        const pluginsData = JSON.parse(readFileSync(pluginsPath, 'utf8'));
-        const plugins = pluginsData.plugins || {};
-        result.plugins = Object.keys(plugins);
-        result.superpowers = 'superpowers@claude-plugins-official' in plugins;
-      } catch { /* invalid JSON */ }
-    }
-
-    // ── Custom skills ───────────────────────────────────────────────────────
-    const skillsPath = join(targetPath, '.claude', 'skills');
-    if (existsSync(skillsPath)) {
-      try {
-        result.customSkills = readdirSync(skillsPath).filter(f => !f.startsWith('.'));
-      } catch { /* ignore */ }
-    }
-
-    // ── Custom commands ─────────────────────────────────────────────────────
-    const commandsPath = join(targetPath, '.claude', 'commands');
-    if (existsSync(commandsPath)) {
-      try {
-        result.customCommands = readdirSync(commandsPath).filter(f => f.endsWith('.md'));
-      } catch { /* ignore */ }
-    }
-  } catch {
-    // Fail-safe
-  }
-
-  return result;
-}
-
-/**
- * Cross-reference configured MCPs with the MCP registry's phase matrix.
- *
- * @param {Array<{name: string}>} mcpServers - Detected MCP server list
- * @param {Object} phaseMatrix - From mcp-registry.json → phaseMatrix
- * @param {string} currentPhase - Current morph-spec phase
- * @returns {{ available: string[], recommended: string[], missing: string[] }}
- */
-export function mapMcpsToPhases(mcpServers, phaseMatrix, currentPhase) {
-  const configuredNames = new Set(mcpServers.map(m => m.name.toLowerCase()));
-  const recommended = (phaseMatrix[currentPhase] || []);
-
-  return {
-    available: recommended.filter(name => configuredNames.has(name)),
-    recommended,
-    missing: recommended.filter(name => !configuredNames.has(name)),
-  };
-}
-
-/**
- * Format a human-readable one-liner summary of detected config.
- *
- * @param {{ plugins: string[], mcpServers: Array<{name: string}>, superpowers: boolean }} config
- * @returns {string}
- */
-export function formatConfigSummary(config) {
-  const parts = [];
-  if (config.mcpServers.length > 0) {
-    parts.push(`MCPs: ${config.mcpServers.map(m => m.name).join(', ')}`);
-  }
-  if (config.plugins.length > 0) {
-    parts.push(`Plugins: ${config.plugins.length}`);
-  }
-  if (config.superpowers) {
-    parts.push('superpowers: yes');
-  }
-  return parts.join(' | ') || 'No Claude config detected';
-}
+/**
+ * @fileoverview Claude Config Detector
+ *
+ * Scans .claude/ settings and plugins for MCP servers, hooks, skills, and commands.
+ * Used by mcp-setup and session-start hooks.
+ *
+ * @module detectors/claude-config-detector
+ */
+
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+/**
+ * Detect Claude Code configuration for a project.
+ *
+ * @param {string} targetPath - Root path of the project
+ * @returns {{ plugins: string[], mcpServers: Array<{name: string, config: Object}>, superpowers: boolean, customSkills: string[], customCommands: string[], hooks: string[] }}
+ */
+export function detectClaudeConfig(targetPath) {
+  const result = {
+    plugins: [],
+    mcpServers: [],
+    superpowers: false,
+    customSkills: [],
+    customCommands: [],
+    hooks: [],
+  };
+
+  const mcpJsonNames = new Set();
+
+  try {
+    // ── MCP Servers from .mcp.json (primary — Claude Code reads this) ───────
+    const mcpJsonPath = join(targetPath, '.mcp.json');
+    if (existsSync(mcpJsonPath)) {
+      try {
+        const mcpJson = JSON.parse(readFileSync(mcpJsonPath, 'utf8'));
+        const mcps = mcpJson.mcpServers || {};
+        for (const [name, config] of Object.entries(mcps)) {
+          result.mcpServers.push({ name, config });
+          mcpJsonNames.add(name);
+        }
+      } catch { /* invalid JSON */ }
+    }
+
+    // ── MCP Servers + hooks from settings (legacy + hooks/permissions) ───────
+    const settingsPaths = [
+      join(targetPath, '.claude', 'settings.json'),
+      join(targetPath, '.claude', 'settings.local.json'),
+    ];
+
+    for (const sp of settingsPaths) {
+      if (existsSync(sp)) {
+        try {
+          const settings = JSON.parse(readFileSync(sp, 'utf8'));
+          // Legacy MCP entries — skip if already in .mcp.json, but allow later settings files to override earlier ones
+          const mcps = settings.mcpServers || {};
+          for (const [name, config] of Object.entries(mcps)) {
+            if (mcpJsonNames.has(name)) continue; // .mcp.json takes priority
+            const idx = result.mcpServers.findIndex(m => m.name === name);
+            if (idx >= 0) {
+              result.mcpServers[idx] = { name, config }; // later file wins
+            } else {
+              result.mcpServers.push({ name, config });
+            }
+          }
+
+          // Collect hooks
+          if (settings.hooks) {
+            for (const [event, eventHooks] of Object.entries(settings.hooks)) {
+              for (const group of (Array.isArray(eventHooks) ? eventHooks : [])) {
+                for (const h of (group.hooks || [])) {
+                  result.hooks.push(`${event}:${h.type || 'unknown'}`);
+                }
+              }
+            }
+          }
+        } catch { /* invalid JSON */ }
+      }
+    }
+
+    // ── Plugins from global config ──────────────────────────────────────────
+    const pluginsPath = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
+    if (existsSync(pluginsPath)) {
+      try {
+        const pluginsData = JSON.parse(readFileSync(pluginsPath, 'utf8'));
+        const plugins = pluginsData.plugins || {};
+        result.plugins = Object.keys(plugins);
+        result.superpowers = 'superpowers@claude-plugins-official' in plugins;
+      } catch { /* invalid JSON */ }
+    }
+
+    // ── Custom skills ───────────────────────────────────────────────────────
+    const skillsPath = join(targetPath, '.claude', 'skills');
+    if (existsSync(skillsPath)) {
+      try {
+        result.customSkills = readdirSync(skillsPath).filter(f => !f.startsWith('.'));
+      } catch { /* ignore */ }
+    }
+
+    // ── Custom commands ─────────────────────────────────────────────────────
+    const commandsPath = join(targetPath, '.claude', 'commands');
+    if (existsSync(commandsPath)) {
+      try {
+        result.customCommands = readdirSync(commandsPath).filter(f => f.endsWith('.md'));
+      } catch { /* ignore */ }
+    }
+  } catch {
+    // Fail-safe
+  }
+
+  return result;
+}
+
+/**
+ * Cross-reference configured MCPs with the MCP registry's phase matrix.
+ *
+ * @param {Array<{name: string}>} mcpServers - Detected MCP server list
+ * @param {Object} phaseMatrix - From mcp-registry.json → phaseMatrix
+ * @param {string} currentPhase - Current morph-spec phase
+ * @returns {{ available: string[], recommended: string[], missing: string[] }}
+ */
+export function mapMcpsToPhases(mcpServers, phaseMatrix, currentPhase) {
+  const configuredNames = new Set(mcpServers.map(m => m.name.toLowerCase()));
+  const recommended = (phaseMatrix[currentPhase] || []);
+
+  return {
+    available: recommended.filter(name => configuredNames.has(name)),
+    recommended,
+    missing: recommended.filter(name => !configuredNames.has(name)),
+  };
+}
+
+/**
+ * Format a human-readable one-liner summary of detected config.
+ *
+ * @param {{ plugins: string[], mcpServers: Array<{name: string}>, superpowers: boolean }} config
+ * @returns {string}
+ */
+export function formatConfigSummary(config) {
+  const parts = [];
+  if (config.mcpServers.length > 0) {
+    parts.push(`MCPs: ${config.mcpServers.map(m => m.name).join(', ')}`);
+  }
+  if (config.plugins.length > 0) {
+    parts.push(`Plugins: ${config.plugins.length}`);
+  }
+  if (config.superpowers) {
+    parts.push('superpowers: yes');
+  }
+  return parts.join(' | ') || 'No Claude config detected';
+}