@cg3/equip 0.2.22 → 0.4.0

package/dist/lib/detect.js

@@ -0,0 +1,109 @@
+"use strict";
+// Platform detection — discovers installed AI coding tools.
+// Uses the platform registry as single source of truth.
+// Zero dependencies.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.whichSync = whichSync;
+exports.dirExists = dirExists;
+exports.fileExists = fileExists;
+exports.detectPlatforms = detectPlatforms;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const platforms_1 = require("./platforms");
+const mcp_1 = require("./mcp");
+// ─── Helpers ─────────────────────────────────────────────────
+function whichSync(cmd) {
+    try {
+        const r = (0, child_process_1.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;
+    }
+}
+// ─── Detection ──────────────────────────────────────────────
+/**
+ * Detect installed AI coding platforms.
+ * Checks directories and files first (fast), then CLI presence.
+ * Skips --version calls for performance.
+ * @param serverName - MCP server name to check for existing config
+ */
+function detectPlatforms(serverName) {
+    const platforms = [];
+    for (const [, def] of platforms_1.PLATFORM_REGISTRY) {
+        // Check dirs/files first (fast fs stat), CLI last (slow shell exec)
+        const dirFound = def.detection.dirs.some(fn => dirExists(fn()));
+        const fileFound = def.detection.files.some(fn => fileExists(fn()));
+        const parentDirFound = def.detection.files.some(fn => dirExists(path.dirname(fn())));
+        // Only shell out for `which` if no dir/file evidence found
+        const hasCli = (dirFound || fileFound || parentDirFound)
+            ? (def.detection.cli ? !!whichSync(def.detection.cli) : false)
+            : (def.detection.cli ? !!whichSync(def.detection.cli) : false);
+        if (!hasCli && !dirFound && !fileFound && !parentDirFound)
+            continue;
+        const configPath = def.configPath();
+        const rulesPath = def.rulesPath ? def.rulesPath() : null;
+        platforms.push({
+            platform: def.id,
+            version: "detected",
+            configPath,
+            rulesPath,
+            existingMcp: serverName ? (0, mcp_1.readMcpEntry)(configPath, def.rootKey, serverName, def.configFormat) : null,
+            hasCli,
+            rootKey: def.rootKey,
+            configFormat: def.configFormat,
+        });
+    }
+    return platforms;
+}
+//# sourceMappingURL=detect.js.map

package/dist/lib/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/lib/detect.ts"],"names":[],"mappings":"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"}

package/dist/lib/hooks.d.ts

@@ -0,0 +1,40 @@
+import { type DetectedPlatform, type PlatformHookCapabilities } from "./platforms";
+export interface HookDefinition {
+    event: string;
+    matcher?: string;
+    script: string;
+    name: string;
+}
+/**
+ * Get hook capabilities for a platform (from registry).
+ */
+export declare function getHookCapabilities(platformId: string): PlatformHookCapabilities | null;
+/**
+ * Build platform-specific hooks config from consumer-defined hook definitions.
+ */
+export declare function buildHooksConfig(hookDefs: HookDefinition[], hookDir: string, platformId: string): Record<string, unknown[]> | null;
+/**
+ * Install hook scripts to disk and register them in platform settings.
+ */
+export declare function installHooks(platform: DetectedPlatform, hookDefs: HookDefinition[], options?: {
+    hookDir?: string;
+    dryRun?: boolean;
+}): {
+    installed: boolean;
+    scripts: string[];
+    hookDir: string;
+} | null;
+/**
+ * Uninstall hook scripts and remove from platform settings.
+ */
+export declare function uninstallHooks(platform: DetectedPlatform, hookDefs: HookDefinition[], options?: {
+    hookDir?: string;
+    dryRun?: boolean;
+}): boolean;
+/**
+ * Check if hooks are installed for a platform.
+ */
+export declare function hasHooks(platform: DetectedPlatform, hookDefs: HookDefinition[], options?: {
+    hookDir?: string;
+}): boolean;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/lib/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"AAMA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAItG,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAEvF;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CA0BlI;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuD5M;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAkDpJ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAsB5H"}

package/dist/lib/hooks.js

@@ -0,0 +1,226 @@
+"use strict";
+// Hook installation for platforms that support lifecycle hooks.
+// Reads capabilities from the platform registry.
+// Zero dependencies.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHookCapabilities = getHookCapabilities;
+exports.buildHooksConfig = buildHooksConfig;
+exports.installHooks = installHooks;
+exports.uninstallHooks = uninstallHooks;
+exports.hasHooks = hasHooks;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const platforms_1 = require("./platforms");
+// ─── Capabilities ───────────────────────────────────────────
+/**
+ * Get hook capabilities for a platform (from registry).
+ */
+function getHookCapabilities(platformId) {
+    return platforms_1.PLATFORM_REGISTRY.get(platformId)?.hooks ?? null;
+}
+// ─── Hook Config Generation ─────────────────────────────────
+/**
+ * Build platform-specific hooks config from consumer-defined hook definitions.
+ */
+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.
+ */
+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;
+    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;
+    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 */ }
+        if (!settings.hooks)
+            settings.hooks = {};
+        const hooks = settings.hooks;
+        for (const [event, hookGroups] of Object.entries(hooksConfig)) {
+            if (!hooks[event]) {
+                hooks[event] = hookGroups;
+            }
+            else {
+                const hookDirNorm = hookDir.replace(/\\/g, "/");
+                hooks[event] = hooks[event].filter(group => !group.hooks?.some(h => h.command && h.command.replace(/\\/g, "/").includes(hookDirNorm)));
+                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.
+ */
+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;
+    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 */ }
+    }
+    if (!dryRun) {
+        try {
+            fs.rmdirSync(hookDir);
+        }
+        catch { /* not empty or doesn't exist */ }
+    }
+    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.
+ */
+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;
+    for (const def of hookDefs) {
+        try {
+            if (!fs.statSync(path.join(hookDir, def.name + ".js")).isFile())
+                return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    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;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/lib/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"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"}

package/dist/lib/mcp.d.ts

@@ -0,0 +1,73 @@
+import { type DetectedPlatform } from "./platforms";
+/**
+ * Parse a TOML table entry for [mcp_servers.<name>].
+ * Returns key-value pairs as a plain object. Supports string, number, boolean, arrays.
+ * This is NOT a full TOML parser — only handles flat tables needed for MCP config.
+ */
+export declare function parseTomlServerEntry(tomlContent: string, rootKey: string, serverName: string): Record<string, unknown> | null;
+/**
+ * Parse nested TOML sub-tables (e.g., [mcp_servers.prior.env]).
+ */
+export declare function parseTomlSubTables(tomlContent: string, rootKey: string, serverName: string): Record<string, Record<string, string>>;
+/**
+ * Build TOML text for a server entry.
+ */
+export declare function buildTomlEntry(rootKey: string, serverName: string, config: Record<string, unknown>): string;
+/**
+ * Remove a TOML server entry block from content.
+ */
+export declare function removeTomlEntry(tomlContent: string, rootKey: string, serverName: string): string;
+/**
+ * Read an MCP server entry from a config file (JSON or TOML).
+ */
+export declare function readMcpEntry(configPath: string, rootKey: string, serverName: string, configFormat?: string): Record<string, unknown> | null;
+/**
+ * Build HTTP MCP config for a platform.
+ * Uses the platform registry to determine field names.
+ */
+export declare function buildHttpConfig(serverUrl: string, platform: string): Record<string, unknown>;
+/**
+ * Build HTTP MCP config with auth headers.
+ */
+export declare function buildHttpConfigWithAuth(serverUrl: string, apiKey: string, platform: string, extraHeaders?: Record<string, string>): Record<string, unknown>;
+/**
+ * Build stdio MCP config.
+ */
+export declare function buildStdioConfig(command: string, args: string[], env: Record<string, string>): Record<string, unknown>;
+/**
+ * Install MCP config for a platform.
+ * Tries platform CLI first (if available), falls back to file write.
+ */
+export declare function installMcp(platform: DetectedPlatform, serverName: string, mcpEntry: Record<string, unknown>, options?: {
+    dryRun?: boolean;
+    serverUrl?: string;
+}): {
+    success: boolean;
+    method: string;
+};
+/**
+ * Write MCP config directly to JSON file.
+ */
+export declare function installMcpJson(platform: DetectedPlatform, serverName: string, mcpEntry: Record<string, unknown>, dryRun: boolean): {
+    success: boolean;
+    method: string;
+};
+/**
+ * Write MCP config to TOML file (Codex).
+ */
+export declare function installMcpToml(platform: DetectedPlatform, serverName: string, mcpEntry: Record<string, unknown>, dryRun: boolean): {
+    success: boolean;
+    method: string;
+};
+/**
+ * Remove an MCP server entry from a platform config.
+ */
+export declare function uninstallMcp(platform: DetectedPlatform, serverName: string, dryRun?: boolean): boolean;
+/**
+ * Update API key in existing MCP config.
+ */
+export declare function updateMcpKey(platform: DetectedPlatform, serverName: string, mcpEntry: Record<string, unknown>): {
+    success: boolean;
+    method: string;
+};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/lib/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/lib/mcp.ts"],"names":[],"mappings":"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"}