@cg3/equip 0.2.22 → 0.4.0

package/lib/detect.js

@@ -1,242 +0,0 @@
-// Platform detection — discovers installed AI coding tools.
-// Zero dependencies.
-
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const { execSync } = require("child_process");
-const { getVsCodeMcpPath, getVsCodeUserDir, getClineConfigPath, getRooConfigPath, getCodexConfigPath, getGeminiSettingsPath, getJunieMcpPath, getCopilotJetBrainsMcpPath, getCopilotCliMcpPath } = require("./platforms");
-const { readMcpEntry } = require("./mcp");
-
-// ─── Helpers ─────────────────────────────────────────────────
-
-function whichSync(cmd) {
-  try {
-    const r = execSync(process.platform === "win32" ? `where ${cmd} 2>nul` : `which ${cmd} 2>/dev/null`, { encoding: "utf-8", timeout: 5000 });
-    return r.trim().split(/\r?\n/)[0] || null;
-  } catch { return null; }
-}
-
-function dirExists(p) {
-  try { return fs.statSync(p).isDirectory(); } catch { return false; }
-}
-
-function fileExists(p) {
-  try { return fs.statSync(p).isFile(); } catch { return false; }
-}
-
-function cliVersion(cmd, regex) {
-  try {
-    const out = execSync(`${cmd} --version 2>&1`, { encoding: "utf-8", timeout: 5000 });
-    const m = out.match(regex || /(\d+\.\d+[\.\d]*)/);
-    return m ? m[1] : "unknown";
-  } catch { return null; }
-}
-
-function getClaudeCodeVersion() {
-  try {
-    const out = execSync("claude --version 2>&1", { encoding: "utf-8", timeout: 5000 });
-    const m = out.match(/(\d+\.\d+[\.\d]*)/);
-    return m ? m[1] : "unknown";
-  } catch { return null; }
-}
-
-// ─── Detection ──────────────────────────────────────────────
-
-/**
- * Detect installed AI coding platforms.
- * @param {string} [serverName] - MCP server name to check for existing config (default: null)
- * @returns {Array<object>} Array of platform objects
- */
-function detectPlatforms(serverName) {
-  const home = os.homedir();
-  const platforms = [];
-
-  // Claude Code
-  const claudeVersion = whichSync("claude") ? getClaudeCodeVersion() : null;
-  if (claudeVersion || dirExists(path.join(home, ".claude"))) {
-    const configPath = path.join(home, ".claude.json");
-    const rulesPath = path.join(home, ".claude", "CLAUDE.md");
-    platforms.push({
-      platform: "claude-code",
-      version: claudeVersion || "unknown",
-      configPath,
-      rulesPath,
-      existingMcp: serverName ? readMcpEntry(configPath, "mcpServers", serverName) : null,
-      hasCli: !!whichSync("claude"),
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // Cursor
-  const cursorDir = path.join(home, ".cursor");
-  if (whichSync("cursor") || dirExists(cursorDir)) {
-    const configPath = path.join(cursorDir, "mcp.json");
-    platforms.push({
-      platform: "cursor",
-      version: cliVersion("cursor") || "unknown",
-      configPath,
-      rulesPath: null, // Cursor: clipboard only
-      existingMcp: serverName ? readMcpEntry(configPath, "mcpServers", serverName) : null,
-      hasCli: !!whichSync("cursor"),
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // Windsurf
-  const windsurfDir = path.join(home, ".codeium", "windsurf");
-  if (dirExists(windsurfDir)) {
-    const configPath = path.join(windsurfDir, "mcp_config.json");
-    const rulesPath = path.join(windsurfDir, "memories", "global_rules.md");
-    platforms.push({
-      platform: "windsurf",
-      version: "unknown",
-      configPath,
-      rulesPath,
-      existingMcp: serverName ? readMcpEntry(configPath, "mcpServers", serverName) : null,
-      hasCli: false,
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // VS Code (Copilot)
-  const vscodeMcpPath = getVsCodeMcpPath();
-  if (whichSync("code") || fileExists(vscodeMcpPath) || dirExists(getVsCodeUserDir())) {
-    platforms.push({
-      platform: "vscode",
-      version: cliVersion("code") || "unknown",
-      configPath: vscodeMcpPath,
-      rulesPath: null, // VS Code: clipboard only
-      existingMcp: serverName ? readMcpEntry(vscodeMcpPath, "servers", serverName) : null,
-      hasCli: !!whichSync("code"),
-      rootKey: "servers",
-      configFormat: "json",
-    });
-  }
-
-  // Cline (VS Code extension)
-  const clineConfigPath = getClineConfigPath();
-  if (fileExists(clineConfigPath) || dirExists(path.dirname(clineConfigPath))) {
-    const home_ = os.homedir();
-    platforms.push({
-      platform: "cline",
-      version: "unknown",
-      configPath: clineConfigPath,
-      rulesPath: path.join(home_, "Documents", "Cline", "Rules"),
-      existingMcp: serverName ? readMcpEntry(clineConfigPath, "mcpServers", serverName) : null,
-      hasCli: false,
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // Roo Code (VS Code extension)
-  const rooConfigPath = getRooConfigPath();
-  if (fileExists(rooConfigPath) || dirExists(path.dirname(rooConfigPath))) {
-    platforms.push({
-      platform: "roo-code",
-      version: "unknown",
-      configPath: rooConfigPath,
-      rulesPath: path.join(os.homedir(), ".roo", "rules"),
-      existingMcp: serverName ? readMcpEntry(rooConfigPath, "mcpServers", serverName) : null,
-      hasCli: false,
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // Codex (OpenAI CLI)
-  const codexHome = process.env.CODEX_HOME || path.join(home, ".codex");
-  const codexConfigPath = getCodexConfigPath();
-  if (whichSync("codex") || dirExists(codexHome)) {
-    platforms.push({
-      platform: "codex",
-      version: cliVersion("codex") || "unknown",
-      configPath: codexConfigPath,
-      rulesPath: path.join(codexHome, "AGENTS.md"),
-      existingMcp: serverName ? readMcpEntry(codexConfigPath, "mcp_servers", serverName, "toml") : null,
-      hasCli: !!whichSync("codex"),
-      rootKey: "mcp_servers",
-      configFormat: "toml",
-    });
-  }
-
-  // Gemini CLI (Google)
-  const geminiDir = path.join(home, ".gemini");
-  const geminiSettingsPath = getGeminiSettingsPath();
-  if (whichSync("gemini") || dirExists(geminiDir)) {
-    platforms.push({
-      platform: "gemini-cli",
-      version: cliVersion("gemini") || "unknown",
-      configPath: geminiSettingsPath,
-      rulesPath: path.join(geminiDir, "GEMINI.md"),
-      existingMcp: serverName ? readMcpEntry(geminiSettingsPath, "mcpServers", serverName) : null,
-      hasCli: !!whichSync("gemini"),
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // Junie (JetBrains CLI)
-  const junieDir = path.join(home, ".junie");
-  const junieMcpPath = getJunieMcpPath();
-  if (whichSync("junie") || dirExists(junieDir)) {
-    platforms.push({
-      platform: "junie",
-      version: cliVersion("junie") || "unknown",
-      configPath: junieMcpPath,
-      rulesPath: null,
-      existingMcp: serverName ? readMcpEntry(junieMcpPath, "mcpServers", serverName) : null,
-      hasCli: !!whichSync("junie"),
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // GitHub Copilot in JetBrains IDEs
-  const copilotJbPath = getCopilotJetBrainsMcpPath();
-  const copilotJbDir = path.dirname(path.dirname(copilotJbPath)); // github-copilot dir
-  if (dirExists(copilotJbDir)) {
-    platforms.push({
-      platform: "copilot-jetbrains",
-      version: "unknown",
-      configPath: copilotJbPath,
-      rulesPath: null,
-      existingMcp: serverName ? readMcpEntry(copilotJbPath, "mcpServers", serverName) : null,
-      hasCli: false,
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  // GitHub Copilot CLI
-  const copilotCliDir = path.join(home, ".copilot");
-  const copilotCliMcpPath = getCopilotCliMcpPath();
-  if (whichSync("copilot") || dirExists(copilotCliDir)) {
-    platforms.push({
-      platform: "copilot-cli",
-      version: cliVersion("copilot") || "unknown",
-      configPath: copilotCliMcpPath,
-      rulesPath: null,
-      existingMcp: serverName ? readMcpEntry(copilotCliMcpPath, "mcpServers", serverName) : null,
-      hasCli: !!whichSync("copilot"),
-      rootKey: "mcpServers",
-      configFormat: "json",
-    });
-  }
-
-  return platforms;
-}
-
-module.exports = {
-  detectPlatforms,
-  whichSync,
-  dirExists,
-  fileExists,
-  cliVersion,
-};

package/lib/hooks.js

@@ -1,238 +0,0 @@
-// Hook installation for platforms that support lifecycle hooks.
-// Equip provides the infrastructure; consumers provide hook definitions.
-// Zero dependencies.
-
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-
-// ─── Platform Hook Capabilities ──────────────────────────────
-
-/**
- * Which platforms support hooks and what events they handle.
- * Returns null if the platform doesn't support hooks.
- */
-function getHookCapabilities(platformId) {
-  const caps = {
-    "claude-code": {
-      settingsPath: () => path.join(os.homedir(), ".claude", "settings.json"),
-      events: ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Stop",
-               "SessionStart", "SessionEnd", "UserPromptSubmit", "Notification",
-               "SubagentStart", "SubagentStop", "PreCompact", "TaskCompleted"],
-      format: "claude-code",
-    },
-    // Future: cursor, etc.
-  };
-  return caps[platformId] || null;
-}
-
-// ─── Hook Config Generation ─────────────────────────────────
-
-/**
- * Build platform-specific hooks config from consumer-defined hook definitions.
- * @param {Array} hookDefs - Array of { event, matcher?, script, name }
- * @param {string} hookDir - Absolute path to directory containing hook scripts
- * @param {string} platformId - Platform id
- * @returns {object|null} Hooks config in the platform's format
- */
-function buildHooksConfig(hookDefs, hookDir, platformId) {
-  const caps = getHookCapabilities(platformId);
-  if (!caps || !hookDefs || hookDefs.length === 0) return null;
-
-  if (caps.format === "claude-code") {
-    const config = {};
-
-    for (const def of hookDefs) {
-      if (!caps.events.includes(def.event)) continue;
-
-      const entry = {
-        hooks: [{
-          type: "command",
-          command: `node "${path.join(hookDir, def.name + ".js")}"`,
-        }],
-      };
-      if (def.matcher) entry.matcher = def.matcher;
-
-      if (!config[def.event]) config[def.event] = [];
-      config[def.event].push(entry);
-    }
-
-    return Object.keys(config).length > 0 ? config : null;
-  }
-
-  return null;
-}
-
-// ─── Installation ────────────────────────────────────────────
-
-/**
- * Install hook scripts to disk and register them in platform settings.
- * @param {object} platform - Platform object from detect()
- * @param {Array} hookDefs - Array of { event, matcher?, script, name }
- * @param {object} [options] - { hookDir, dryRun, marker }
- * @returns {{ installed: boolean, scripts: string[], hookDir: string } | null}
- */
-function installHooks(platform, hookDefs, options = {}) {
-  const caps = getHookCapabilities(platform.platform);
-  if (!caps || !hookDefs || hookDefs.length === 0) return null;
-
-  if (!options.hookDir) throw new Error("hookDir is required");
-  const hookDir = options.hookDir;
-  const dryRun = options.dryRun || false;
-
-  // 1. Write hook scripts
-  const installedScripts = [];
-
-  if (!dryRun) {
-    fs.mkdirSync(hookDir, { recursive: true });
-  }
-
-  for (const def of hookDefs) {
-    if (!caps.events.includes(def.event)) continue;
-    const filePath = path.join(hookDir, def.name + ".js");
-    if (!dryRun) {
-      fs.writeFileSync(filePath, def.script, { mode: 0o755 });
-    }
-    installedScripts.push(def.name + ".js");
-  }
-
-  if (installedScripts.length === 0) return null;
-
-  // 2. Register hooks in platform settings
-  const hooksConfig = buildHooksConfig(hookDefs, hookDir, platform.platform);
-  if (!hooksConfig) return null;
-
-  if (!dryRun) {
-    const settingsPath = caps.settingsPath();
-    let settings = {};
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
-    } catch { /* file doesn't exist yet */ }
-
-    // Merge hooks — preserve existing non-marker hooks
-    if (!settings.hooks) settings.hooks = {};
-
-    for (const [event, hookGroups] of Object.entries(hooksConfig)) {
-      if (!settings.hooks[event]) {
-        settings.hooks[event] = hookGroups;
-      } else {
-        // Remove existing hooks from this marker, then add new ones
-        const hookDirNorm = hookDir.replace(/\\/g, "/");
-        settings.hooks[event] = settings.hooks[event].filter(
-          group => !group.hooks?.some(h => h.command && h.command.replace(/\\/g, "/").includes(hookDirNorm))
-        );
-        settings.hooks[event].push(...hookGroups);
-      }
-    }
-
-    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-  }
-
-  return { installed: true, scripts: installedScripts, hookDir };
-}
-
-/**
- * Uninstall hook scripts and remove from platform settings.
- * @param {object} platform - Platform object
- * @param {Array} hookDefs - Array of { event, matcher?, script, name } (need names to know what to remove)
- * @param {object} [options] - { hookDir, dryRun }
- * @returns {boolean} Whether anything was removed
- */
-function uninstallHooks(platform, hookDefs, options = {}) {
-  const caps = getHookCapabilities(platform.platform);
-  if (!caps || !hookDefs || hookDefs.length === 0) return false;
-
-  if (!options.hookDir) throw new Error("hookDir is required");
-  const hookDir = options.hookDir;
-  const dryRun = options.dryRun || false;
-  let removed = false;
-
-  // 1. Remove hook scripts
-  for (const def of hookDefs) {
-    const filePath = path.join(hookDir, def.name + ".js");
-    try {
-      if (fs.statSync(filePath).isFile()) {
-        if (!dryRun) fs.unlinkSync(filePath);
-        removed = true;
-      }
-    } catch { /* doesn't exist */ }
-  }
-
-  // Clean up empty hooks dir
-  if (!dryRun) {
-    try { fs.rmdirSync(hookDir); } catch { /* not empty or doesn't exist */ }
-  }
-
-  // 2. Remove from platform settings
-  if (!dryRun) {
-    const settingsPath = caps.settingsPath();
-    try {
-      const settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
-      if (settings.hooks) {
-        let changed = false;
-        const hookDirNorm = hookDir.replace(/\\/g, "/");
-        for (const event of Object.keys(settings.hooks)) {
-          const before = settings.hooks[event].length;
-          settings.hooks[event] = settings.hooks[event].filter(
-            group => !group.hooks?.some(h => h.command && h.command.replace(/\\/g, "/").includes(hookDirNorm))
-          );
-          if (settings.hooks[event].length === 0) {
-            delete settings.hooks[event];
-          }
-          if (settings.hooks[event]?.length !== before) changed = true;
-        }
-        if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
-        if (changed) {
-          fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-          removed = true;
-        }
-      }
-    } catch { /* file doesn't exist */ }
-  }
-
-  return removed;
-}
-
-/**
- * Check if hooks are installed for a platform.
- * @param {object} platform - Platform object
- * @param {Array} hookDefs - Array of { event, matcher?, script, name }
- * @param {object} [options] - { hookDir }
- * @returns {boolean}
- */
-function hasHooks(platform, hookDefs, options = {}) {
-  const caps = getHookCapabilities(platform.platform);
-  if (!caps || !hookDefs || hookDefs.length === 0) return false;
-
-  if (!options.hookDir) throw new Error("hookDir is required");
-  const hookDir = options.hookDir;
-
-  // Check scripts exist
-  for (const def of hookDefs) {
-    try {
-      if (!fs.statSync(path.join(hookDir, def.name + ".js")).isFile()) return false;
-    } catch { return false; }
-  }
-
-  // Check settings registration
-  try {
-    const settings = JSON.parse(fs.readFileSync(caps.settingsPath(), "utf-8"));
-    if (!settings.hooks) return false;
-    const hookDirNorm = hookDir.replace(/\\/g, "/");
-    const hasRegistered = Object.values(settings.hooks).some(groups =>
-      groups.some(g => g.hooks?.some(h => h.command && h.command.replace(/\\/g, "/").includes(hookDirNorm)))
-    );
-    return hasRegistered;
-  } catch { return false; }
-}
-
-module.exports = {
-  getHookCapabilities,
-  buildHooksConfig,
-  installHooks,
-  uninstallHooks,
-  hasHooks,
-};