@cg3/equip 0.2.22 → 0.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 CG3 LLC
+Copyright (c) 2026 Charles Mulic
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,6 +2,8 @@
 
 Universal MCP server + behavioral rules installer for AI coding agents.
 
+[Join the Discord](https://discord.gg/bBcRHT4J) — bug reports, feedback, share what you're building.
+
 Equip handles the hard part of distributing your MCP tool: detecting which AI coding platforms are installed, writing the correct config format for each one, and managing versioned behavioral rules — all with zero dependencies.
 
 ## Run the Demo
@@ -28,7 +30,7 @@ These platforms get both MCP server config *and* auto-installed behavioral rules
 | Platform | MCP Config | Rules |
 |---|---|---|
 | Claude Code | `~/.claude.json` (JSON, `mcpServers`) | `~/.claude/CLAUDE.md` (append) |
-| Windsurf | `~/.codeium/windsurf/mcp_config.json` (JSON, `mcpServers`) | `global_rules.md` (append) |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` (JSON, `mcpServers`, `serverUrl`) | `~/.codeium/windsurf/memories/global_rules.md` (append) |
 | Cline | `globalStorage/.../cline_mcp_settings.json` (JSON, `mcpServers`) | `~/Documents/Cline/Rules/` (standalone file) |
 | Roo Code | `globalStorage/.../cline_mcp_settings.json` (JSON, `mcpServers`) | `~/.roo/rules/` (standalone file) |
 | Codex | `~/.codex/config.toml` (TOML, `mcp_servers`) | `~/.codex/AGENTS.md` (append) |
@@ -40,13 +42,13 @@ These platforms get MCP server config but don't have a writable global rules fil
 
 | Platform | MCP Config |
 |---|---|
-| Cursor | `~/.cursor/mcp.json` (JSON, `mcpServers`) |
+| Cursor | `~/.cursor/mcp.json` (JSON, `mcpServers`, `type: "streamable-http"`) |
 | VS Code | `Code/User/mcp.json` (JSON, `servers`, `type: "http"`) |
 | Junie (JetBrains) | `~/.junie/mcp/mcp.json` (JSON, `mcpServers`) |
 | Copilot (JetBrains) | `~/.config/github-copilot/intellij/mcp.json` (JSON, `mcpServers`) |
 | Copilot CLI | `~/.copilot/mcp-config.json` (JSON, `mcpServers`) |
 
-For these platforms, `installRules()` returns `{ action: "clipboard" }` if the platform is in the configurable `clipboardPlatforms` list (default: `["cursor", "vscode"]`), or `{ action: "skipped" }` otherwise. It's up to the consumer to decide how to handle this — e.g., copying rules to the clipboard, printing instructions, or skipping silently.
+For these platforms, `installRules()` returns `{ action: "clipboard" }` if the platform is in the configurable `clipboardPlatforms` list (default: `["cursor", "vscode"]`) and automatically copies the rules content to the system clipboard. For platforms with no rules path and not in `clipboardPlatforms`, it returns `{ action: "skipped" }`.
 
 ### Hooks — Structural Enforcement
 
@@ -54,7 +56,7 @@ Some platforms support **lifecycle hooks** — scripts that run automatically at
 
 | Platform | Hooks Support | Events |
 |---|---|---|
-| Claude Code | ✅ | `PostToolUseFailure`, `Stop`, `PreToolUse`, `PostToolUse` |
+| Claude Code | ✅ | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `Stop`, `SessionStart`, `SessionEnd`, `UserPromptSubmit`, `Notification`, `SubagentStart`, `SubagentStop`, `PreCompact`, `TaskCompleted` |
 | All others | ❌ | — |
 
 When hooks are supported, equip writes the consumer-provided scripts to a configurable directory (default: `~/.${name}/hooks/`) and registers them in the platform's settings. Hooks are a **silent enhancement** — if the platform doesn't support them, equip installs only MCP + rules without any error or warning.
@@ -85,7 +87,7 @@ The CLI runs `npx -y <package>@latest <command>` with any extra args forwarded (
 
 ### Shorthand Registry
 
-Registered shorthands save typing. Open a PR to `bin/equip.js` to add yours:
+Registered shorthands save typing. Open a PR to [`registry.json`](./registry.json) to add yours:
 
 | Shorthand | Expands to |
 |---|---|
@@ -137,6 +139,12 @@ for (const p of platforms) {
   - `clipboardPlatforms` — Platform IDs that use clipboard (default: `["cursor", "vscode"]`)
 - `config.stdio` — Stdio transport config (optional, alternative to HTTP)
   - `command`, `args`, `envKey`
+- `config.hooks` — Lifecycle hook definitions (optional, array)
+  - `event` — Hook event name (e.g., `"PostToolUseFailure"`)
+  - `matcher` — Regex matcher for event filtering (optional, e.g., `"Bash"`)
+  - `script` — Hook script content (Node.js)
+  - `name` — Script filename (without `.js` extension)
+- `config.hookDir` — Directory for hook scripts (default: `~/.${name}/hooks/`)
 
 ### Instance Methods
 
@@ -153,14 +161,22 @@ for (const p of platforms) {
 - `equip.hasHooks(platform, options?)` — Check if hooks are installed
 - `equip.supportsHooks(platform)` — Check if platform supports hooks
 
-### Primitives
-
-All internal functions are also exported for advanced usage:
+### Utilities
 
 ```js
-const { detectPlatforms, installMcpJson, installRules, createManualPlatform, platformName, cli } = require("@cg3/equip");
+const { createManualPlatform, platformName, resolvePlatformId, parseRulesVersion, markerPatterns, cli, KNOWN_PLATFORMS, PLATFORM_REGISTRY, getPlatform } = require("@cg3/equip");
 ```
 
+- `createManualPlatform(id)` — Create a platform object for a specific platform ID (bypasses detection)
+- `platformName(id)` — Human-readable display name for a platform ID
+- `resolvePlatformId(input)` — Resolve a friendly name or alias to a canonical platform ID (e.g., `"claude"` → `"claude-code"`, `"roo"` → `"roo-code"`)
+- `parseRulesVersion(content, marker)` — Extract version from a marker block in content
+- `markerPatterns(marker)` — Get regex patterns for a marker name
+- `KNOWN_PLATFORMS` — Array of all supported platform IDs
+- `PLATFORM_REGISTRY` — Map of platform definitions (for advanced use)
+- `getPlatform(id)` — Get a platform definition by ID (throws if unknown)
+- `cli` — Output helpers: `log`, `ok`, `fail`, `warn`, `info`, `step`, `prompt`, `copyToClipboard`, color constants
+
 ## Key Features
 
 - **Zero dependencies** — Pure Node.js, works with Node 18+
@@ -189,4 +205,4 @@ No layer is a silver bullet. Together, they give you the best coverage available
 
 ## License
 
-MIT — CG3 LLC
+MIT — Charles Mulic

package/bin/equip.js

@@ -1,78 +1,155 @@
 #!/usr/bin/env node
-// @cg3/equip CLI — universal entry point for AI tool setup.
-// Usage: npx @cg3/equip <tool> [args...]
-//   e.g. npx @cg3/equip prior --dry-run
+// @cg3/equip CLI — universal MCP tool installer and configuration manager.
+// Usage: equip <command> [args...]
 
 "use strict";
 
-const { spawn } = require("child_process");
+const { spawn, execSync } = require("child_process");
 const path = require("path");
+const fs = require("fs");
 
-const EQUIP_VERSION = JSON.parse(
-  require("fs").readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")
-).version;
+const PKG = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8"));
+const EQUIP_VERSION = PKG.version;
 
-// ─── Tool Registry ──────────────────────────────────────────
+// ─── Registry ───────────────────────────────────────────────
 
-const TOOLS = {
-  prior: { package: "@cg3/prior-node", command: "setup" },
-  demo: { builtin: true },
-};
+const REGISTRY = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "..", "registry.json"), "utf-8")
+);
+const TOOLS = {};
+for (const [key, value] of Object.entries(REGISTRY)) {
+  if (!key.startsWith("$")) TOOLS[key] = value;
+}
 
-// ─── CLI ─────────────────────────────────────────────────────
+// ─── Built-in Commands ──────────────────────────────────────
 
-const alias = process.argv[2];
-const extraArgs = process.argv.slice(3);
+const BUILTIN_COMMANDS = new Set(["status", "doctor", "update", "list", "demo", "--help", "-h", "--version", "-v"]);
+
+function isBuiltin(cmd) {
+  return BUILTIN_COMMANDS.has(cmd);
+}
+
+// ─── Stale Version Nudge ────────────────────────────────────
+
+function checkStaleVersion() {
+  try {
+    const { readState } = require("../dist/lib/state");
+    const state = readState();
+    if (state.lastUpdated) {
+      const daysSince = (Date.now() - new Date(state.lastUpdated).getTime()) / (1000 * 60 * 60 * 24);
+      if (daysSince > 14) {
+        const { YELLOW, RESET, DIM } = require("../dist/lib/cli");
+        process.stderr.write(`  ${YELLOW}equip v${EQUIP_VERSION} is ${Math.floor(daysSince)} days old${RESET} ${DIM}— run "equip update" for platform fixes${RESET}\n\n`);
+      }
+    }
+  } catch {}
+}
 
-if (!alias || alias === "--help" || alias === "-h") {
-  console.log("Usage: npx @cg3/equip <tool> [options]");
+// ─── Command: --version ─────────────────────────────────────
+
+function cmdVersion() {
+  console.log(`equip v${EQUIP_VERSION}`);
+}
+
+// ─── Command: --help ────────────────────────────────────────
+
+function cmdHelp() {
+  console.log(`equip v${EQUIP_VERSION} — universal MCP tool installer`);
   console.log("");
-  console.log("Available tools:");
+  console.log("Usage: equip <command> [options]");
+  console.log("");
+  console.log("Commands:");
+  console.log("  <tool>           Install an MCP tool (e.g. equip prior)");
+  console.log("  status           Show all MCP servers across all platforms");
+  console.log("  doctor           Validate config integrity and detect drift");
+  console.log("  update           Update equip and migrate configs");
+  console.log("  list             Show registered tools");
+  console.log("  demo             Run the built-in demo");
+  console.log("");
+  console.log("Registered tools:");
   for (const [name, info] of Object.entries(TOOLS)) {
-    if (info.builtin) {
-      console.log(`  ${name}  →  built-in (reference example)`);
-    } else {
-      console.log(`  ${name}  →  ${info.package} ${info.command}`);
-    }
+    const desc = info.description ? ` — ${info.description}` : "";
+    console.log(`  ${name}${desc}`);
   }
   console.log("");
-  console.log("Options are forwarded to the tool (e.g. --dry-run, --platform codex)");
-  process.exit(0);
+  console.log("Options:");
+  console.log("  --help, -h       Show this help");
+  console.log("  --version, -v    Show version");
+  console.log("");
+  console.log("Tool options are forwarded (e.g. equip prior --dry-run --platform codex)");
 }
 
-const entry = TOOLS[alias];
+// ─── Command: list ──────────────────────────────────────────
 
-// Built-in tools run from this package directly
-if (entry && entry.builtin) {
-  if (alias === "demo") {
-    const demoPath = path.join(__dirname, "..", "demo", "setup.js");
-    const child = spawn(process.execPath, [demoPath, ...extraArgs], {
-      stdio: "inherit",
-      env: { ...process.env, EQUIP_VERSION },
-    });
-    child.on("close", (code) => process.exit(code || 0));
-    child.on("error", (err) => {
-      console.error(`Failed to run demo: ${err.message}`);
-      process.exit(1);
-    });
-    return;
+function cmdList() {
+  const { GREEN, DIM, RESET, BOLD } = require("../dist/lib/cli");
+  console.log(`\n${BOLD}Registered tools${RESET}\n`);
+  for (const [name, info] of Object.entries(TOOLS)) {
+    const desc = info.description ? `  ${DIM}${info.description}${RESET}` : "";
+    console.log(`  ${GREEN}${name}${RESET}  →  ${info.package} ${info.command}${desc}`);
   }
+  console.log(`\n  ${DIM}Install: equip <tool>${RESET}`);
+  console.log(`  ${DIM}Add yours: PR to registry.json at github.com/CharlesMulic/equip${RESET}\n`);
 }
 
-// No registry match — treat as a package name (e.g. "@scope/pkg setup")
-if (!entry) {
-  const pkg = alias;
-  const command = extraArgs.shift(); // first extra arg is the command
-  if (!command) {
-    console.error(`Usage: npx @cg3/equip <package> <command> [options]`);
-    console.error(`   or: npx @cg3/equip <shorthand> [options]`);
-    console.error("");
-    console.error("Registered shorthands:");
-    for (const [name, info] of Object.entries(TOOLS)) {
-      console.log(`  ${name}  →  ${info.package} ${info.command}`);
-    }
+// ─── Command: demo ──────────────────────────────────────────
+
+function cmdDemo(extraArgs) {
+  const demoPath = path.join(__dirname, "..", "demo", "setup.js");
+  const child = spawn(process.execPath, [demoPath, ...extraArgs], {
+    stdio: "inherit",
+    env: { ...process.env, EQUIP_VERSION },
+  });
+  child.on("close", (code) => process.exit(code || 0));
+  child.on("error", (err) => {
+    console.error(`Failed to run demo: ${err.message}`);
     process.exit(1);
+  });
+}
+
+// ─── Command: status ────────────────────────────────────────
+
+function cmdStatus() {
+  const { runStatus } = require("../dist/lib/commands/status");
+  runStatus();
+}
+
+// ─── Command: doctor ────────────────────────────────────────
+
+function cmdDoctor() {
+  const { runDoctor } = require("../dist/lib/commands/doctor");
+  runDoctor();
+}
+
+// ─── Command: update ────────────────────────────────────────
+
+function cmdUpdate() {
+  const { runUpdate } = require("../dist/lib/commands/update");
+  runUpdate();
+}
+
+// ─── Tool Dispatch ──────────────────────────────────────────
+
+function dispatchTool(alias, extraArgs) {
+  const entry = TOOLS[alias];
+
+  if (!entry) {
+    // No registry match — treat as a package name (e.g. "equip @scope/pkg setup")
+    const pkg = alias;
+    const command = extraArgs.shift();
+    if (!command) {
+      console.error(`Unknown command: ${alias}`);
+      console.error(`Run "equip --help" for usage.`);
+      process.exit(1);
+    }
+    spawnTool(pkg, command, extraArgs);
+    return;
   }
+
+  spawnTool(entry.package, entry.command, extraArgs);
+}
+
+function spawnTool(pkg, command, extraArgs) {
   const npxCmd = process.platform === "win32" ? "npx.cmd" : "npx";
   const child = spawn(npxCmd, ["-y", `${pkg}@latest`, command, ...extraArgs], {
     stdio: "inherit",
@@ -84,19 +161,33 @@ if (!entry) {
     console.error(`Failed to run ${pkg}: ${err.message}`);
     process.exit(1);
   });
-  return;
-}
-
-// Spawn: npx -y <package> <command> [...extraArgs]
-const npxCmd = process.platform === "win32" ? "npx.cmd" : "npx";
-const child = spawn(npxCmd, ["-y", `${entry.package}@latest`, entry.command, ...extraArgs], {
-  stdio: "inherit",
-  shell: process.platform === "win32",
-  env: { ...process.env, EQUIP_VERSION },
-});
-
-child.on("close", (code) => process.exit(code || 0));
-child.on("error", (err) => {
-  console.error(`Failed to run ${entry.package}: ${err.message}`);
-  process.exit(1);
-});
+}
+
+// ─── Main ───────────────────────────────────────────────────
+
+const cmd = process.argv[2];
+const extraArgs = process.argv.slice(3);
+
+if (!cmd || cmd === "--help" || cmd === "-h") {
+  cmdHelp();
+  process.exit(0);
+}
+
+if (cmd === "--version" || cmd === "-v") {
+  cmdVersion();
+  process.exit(0);
+}
+
+// Stale version check for non-trivial commands
+if (cmd !== "update" && cmd !== "--version" && cmd !== "-v") {
+  checkStaleVersion();
+}
+
+switch (cmd) {
+  case "status":  cmdStatus(); break;
+  case "doctor":  cmdDoctor(); break;
+  case "update":  cmdUpdate(); break;
+  case "list":    cmdList(); break;
+  case "demo":    cmdDemo(extraArgs); break;
+  default:        dispatchTool(cmd, extraArgs); break;
+}

package/demo/README.md

@@ -15,7 +15,7 @@ The demo runs in **dry-run mode by default** — it shows exactly what would hap
 
 ## What it does
 
-The demo installs a fictional MCP tool called `my-tool` across all detected AI coding platforms. It walks through the core equip operations:
+The demo installs a fictional MCP tool called `acme-docs` across all detected AI coding platforms. It walks through the core equip operations:
 
 1. **Detect** — scan for installed AI tools (Claude Code, Cursor, VS Code, etc.)
 2. **API key** — prompt for or configure authentication

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { parseRulesVersion, markerPatterns } from "./lib/rules";
+import { type HookDefinition } from "./lib/hooks";
+import { createManualPlatform, platformName, resolvePlatformId, KNOWN_PLATFORMS, PLATFORM_REGISTRY, getPlatform, type DetectedPlatform, type PlatformDefinition, type PlatformHttpShape, type PlatformHookCapabilities } from "./lib/platforms";
+import * as cli from "./lib/cli";
+export interface EquipConfig {
+    name: string;
+    serverUrl?: string;
+    rules?: {
+        content: string;
+        version: string;
+        marker: string;
+        fileName?: string;
+        clipboardPlatforms?: string[];
+    };
+    stdio?: {
+        command: string;
+        args: string[];
+        envKey: string;
+    };
+    hooks?: HookDefinition[];
+    hookDir?: string;
+}
+/**
+ * Equip — configure AI coding tools with your MCP server and behavioral rules.
+ */
+declare class Equip {
+    name: string;
+    serverUrl?: string;
+    rules: EquipConfig["rules"] | null;
+    stdio: EquipConfig["stdio"] | null;
+    hookDefs: HookDefinition[] | null;
+    hookDir: string;
+    constructor(config: EquipConfig);
+    detect(): DetectedPlatform[];
+    buildConfig(platformId: string, apiKey: string, transport?: string): Record<string, unknown>;
+    installMcp(platform: DetectedPlatform, apiKey: string, options?: {
+        transport?: string;
+        dryRun?: boolean;
+    }): {
+        success: boolean;
+        method: string;
+    };
+    uninstallMcp(platform: DetectedPlatform, dryRun?: boolean): boolean;
+    updateMcpKey(platform: DetectedPlatform, apiKey: string, transport?: string): {
+        success: boolean;
+        method: string;
+    };
+    installRules(platform: DetectedPlatform, options?: {
+        dryRun?: boolean;
+    }): {
+        action: string;
+    };
+    uninstallRules(platform: DetectedPlatform, dryRun?: boolean): boolean;
+    readMcp(platform: DetectedPlatform): Record<string, unknown> | null;
+    installHooks(platform: DetectedPlatform, options?: {
+        hookDir?: string;
+        dryRun?: boolean;
+    }): {
+        installed: boolean;
+        scripts: string[];
+        hookDir: string;
+    } | null;
+    uninstallHooks(platform: DetectedPlatform, options?: {
+        hookDir?: string;
+        dryRun?: boolean;
+    }): boolean;
+    hasHooks(platform: DetectedPlatform, options?: {
+        hookDir?: string;
+    }): boolean;
+    supportsHooks(platform: DetectedPlatform): boolean;
+}
+export { Equip, createManualPlatform, platformName, resolvePlatformId, KNOWN_PLATFORMS, PLATFORM_REGISTRY, getPlatform, parseRulesVersion, markerPatterns, cli, };
+export type { DetectedPlatform, PlatformDefinition, PlatformHttpShape, PlatformHookCapabilities, HookDefinition };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAgC,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAA+D,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChP,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AAKjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,cAAM,KAAK;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;gBAEJ,MAAM,EAAE,WAAW;IAY/B,MAAM,IAAI,gBAAgB,EAAE;IAI5B,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQpG,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAepJ,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO;IAQ1E,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAK1H,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAehG,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO;IAS5E,OAAO,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInE,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOjK,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO;IAOzG,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO;IAOjF,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO;CAGnD;AAID,OAAO,EACL,KAAK,EAEL,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,WAAW,EAEX,iBAAiB,EACjB,cAAc,EAEd,GAAG,GACJ,CAAC;AAGF,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,cAAc,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,175 @@
+"use strict";
+// @cg3/equip — Universal MCP + behavioral rules installer for AI coding agents.
+// Zero dependencies. Works with Claude Code, Cursor, Windsurf, VS Code, Cline, Roo Code, Codex, Gemini CLI.
+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.cli = exports.markerPatterns = exports.parseRulesVersion = exports.getPlatform = exports.PLATFORM_REGISTRY = exports.KNOWN_PLATFORMS = exports.resolvePlatformId = exports.platformName = exports.createManualPlatform = exports.Equip = void 0;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const detect_1 = require("./lib/detect");
+const mcp_1 = require("./lib/mcp");
+const rules_1 = require("./lib/rules");
+Object.defineProperty(exports, "parseRulesVersion", { enumerable: true, get: function () { return rules_1.parseRulesVersion; } });
+Object.defineProperty(exports, "markerPatterns", { enumerable: true, get: function () { return rules_1.markerPatterns; } });
+const hooks_1 = require("./lib/hooks");
+const platforms_1 = require("./lib/platforms");
+Object.defineProperty(exports, "createManualPlatform", { enumerable: true, get: function () { return platforms_1.createManualPlatform; } });
+Object.defineProperty(exports, "platformName", { enumerable: true, get: function () { return platforms_1.platformName; } });
+Object.defineProperty(exports, "resolvePlatformId", { enumerable: true, get: function () { return platforms_1.resolvePlatformId; } });
+Object.defineProperty(exports, "KNOWN_PLATFORMS", { enumerable: true, get: function () { return platforms_1.KNOWN_PLATFORMS; } });
+Object.defineProperty(exports, "PLATFORM_REGISTRY", { enumerable: true, get: function () { return platforms_1.PLATFORM_REGISTRY; } });
+Object.defineProperty(exports, "getPlatform", { enumerable: true, get: function () { return platforms_1.getPlatform; } });
+const cli = __importStar(require("./lib/cli"));
+exports.cli = cli;
+const state_1 = require("./lib/state");
+/**
+ * Equip — configure AI coding tools with your MCP server and behavioral rules.
+ */
+class Equip {
+    name;
+    serverUrl;
+    rules;
+    stdio;
+    hookDefs;
+    hookDir;
+    constructor(config) {
+        if (!config.name)
+            throw new Error("Equip: name is required");
+        if (!config.serverUrl && !config.stdio)
+            throw new Error("Equip: serverUrl or stdio is required");
+        this.name = config.name;
+        this.serverUrl = config.serverUrl;
+        this.rules = config.rules || null;
+        this.stdio = config.stdio || null;
+        this.hookDefs = config.hooks || null;
+        this.hookDir = config.hookDir || path.join(os.homedir(), `.${config.name}`, "hooks");
+    }
+    detect() {
+        return (0, detect_1.detectPlatforms)(this.name);
+    }
+    buildConfig(platformId, apiKey, transport = "http") {
+        if (transport === "stdio" && this.stdio) {
+            const env = { [this.stdio.envKey]: apiKey };
+            return (0, mcp_1.buildStdioConfig)(this.stdio.command, this.stdio.args, env);
+        }
+        return (0, mcp_1.buildHttpConfigWithAuth)(this.serverUrl, apiKey, platformId);
+    }
+    installMcp(platform, apiKey, options = {}) {
+        const { transport = "http", dryRun = false } = options;
+        const config = this.buildConfig(platform.platform, apiKey, transport);
+        const result = (0, mcp_1.installMcp)(platform, this.name, config, { dryRun, serverUrl: this.serverUrl });
+        if (result.success && !dryRun) {
+            try {
+                (0, state_1.trackInstall)(this.name, `@cg3/${this.name}`, platform.platform, {
+                    transport,
+                    configPath: platform.configPath,
+                });
+            }
+            catch { /* state tracking is best-effort */ }
+        }
+        return result;
+    }
+    uninstallMcp(platform, dryRun = false) {
+        const removed = (0, mcp_1.uninstallMcp)(platform, this.name, dryRun);
+        if (removed && !dryRun) {
+            try {
+                (0, state_1.trackUninstall)(this.name, platform.platform);
+            }
+            catch { }
+        }
+        return removed;
+    }
+    updateMcpKey(platform, apiKey, transport = "http") {
+        const config = this.buildConfig(platform.platform, apiKey, transport);
+        return (0, mcp_1.updateMcpKey)(platform, this.name, config);
+    }
+    installRules(platform, options = {}) {
+        if (!this.rules)
+            return { action: "skipped" };
+        const result = (0, rules_1.installRules)(platform, { ...this.rules, dryRun: options.dryRun || false });
+        if ((result.action === "created" || result.action === "updated") && !options.dryRun) {
+            try {
+                (0, state_1.trackInstall)(this.name, `@cg3/${this.name}`, platform.platform, {
+                    transport: "http",
+                    rulesVersion: this.rules.version,
+                    configPath: platform.configPath,
+                });
+            }
+            catch { }
+        }
+        return result;
+    }
+    uninstallRules(platform, dryRun = false) {
+        if (!this.rules)
+            return false;
+        return (0, rules_1.uninstallRules)(platform, {
+            marker: this.rules.marker,
+            fileName: this.rules.fileName,
+            dryRun,
+        });
+    }
+    readMcp(platform) {
+        return (0, mcp_1.readMcpEntry)(platform.configPath, platform.rootKey, this.name, platform.configFormat || "json");
+    }
+    installHooks(platform, options = {}) {
+        if (!this.hookDefs)
+            return null;
+        const opts = { ...options };
+        if (this.hookDir && !opts.hookDir)
+            opts.hookDir = this.hookDir;
+        return (0, hooks_1.installHooks)(platform, this.hookDefs, opts);
+    }
+    uninstallHooks(platform, options = {}) {
+        if (!this.hookDefs)
+            return false;
+        const opts = { ...options };
+        if (this.hookDir && !opts.hookDir)
+            opts.hookDir = this.hookDir;
+        return (0, hooks_1.uninstallHooks)(platform, this.hookDefs, opts);
+    }
+    hasHooks(platform, options = {}) {
+        if (!this.hookDefs)
+            return false;
+        const opts = { ...options };
+        if (this.hookDir && !opts.hookDir)
+            opts.hookDir = this.hookDir;
+        return (0, hooks_1.hasHooks)(platform, this.hookDefs, opts);
+    }
+    supportsHooks(platform) {
+        return !!this.hookDefs && this.hookDefs.length > 0 && !!(0, hooks_1.getHookCapabilities)(platform.platform);
+    }
+}
+exports.Equip = Equip;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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