vectorvesper 2.1.1 → 2.4.0

package/dist/mcp-UEQ2Y6FU.js

@@ -0,0 +1,300 @@
+import {
+  loadHookManifest
+} from "./chunk-CPZKZO3A.js";
+import {
+  getAuthToken
+} from "./chunk-SFP5K3ZO.js";
+
+// src/commands/mcp.ts
+import pc from "picocolors";
+
+// src/utils/mcp-install.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+var CLIENT_IDS = ["claude", "cursor", "antigravity", "opencode"];
+var SERVER_NAME = "vectorvesper";
+var ARGS = ["-y", "vectorvesper@latest", "mcp", "--stdio"];
+function home(...parts) {
+  return path.join(os.homedir(), ...parts);
+}
+var CLIENTS = {
+  claude: {
+    label: "Claude Code",
+    projectPath: ".mcp.json",
+    globalPath: home(".claude.json"),
+    dialect: "mcpServers",
+    note: "Project scope is committed with the repo, so teammates get it too."
+  },
+  cursor: {
+    label: "Cursor",
+    projectPath: path.join(".cursor", "mcp.json"),
+    globalPath: home(".cursor", "mcp.json"),
+    dialect: "mcpServers"
+  },
+  antigravity: {
+    label: "Antigravity",
+    // Workspace scope lives under .agents/; the global file is shared by the
+    // IDE, the CLI and Antigravity 2.0, so configuring once covers all three.
+    projectPath: path.join(".agents", "mcp_config.json"),
+    globalPath: home(".gemini", "config", "mcp_config.json"),
+    dialect: "mcpServers",
+    note: "The global file is shared by the Antigravity IDE, CLI and 2.0."
+  },
+  opencode: {
+    label: "opencode",
+    projectPath: null,
+    globalPath: home(".config", "opencode", "opencode.jsonc"),
+    dialect: "opencode",
+    note: "Servers are keyed directly under `mcp` \u2014 there is no `servers` layer."
+  }
+};
+function serverEntry(dialect) {
+  return dialect === "opencode" ? { type: "local", command: ["npx", ...ARGS], enabled: true } : { command: "npx", args: ARGS };
+}
+function snippet(client) {
+  const spec = CLIENTS[client];
+  const body = spec.dialect === "opencode" ? {
+    $schema: "https://opencode.ai/config.json",
+    mcp: { [SERVER_NAME]: serverEntry("opencode") }
+  } : { mcpServers: { [SERVER_NAME]: serverEntry("mcpServers") } };
+  return JSON.stringify(body, null, 2);
+}
+function readConfig(file) {
+  if (!fs.existsSync(file)) return {};
+  const raw = fs.readFileSync(file, "utf-8").trim();
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    try {
+      const stripped = raw.replace(/^\s*\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "").replace(/,(\s*[}\]])/g, "$1");
+      return JSON.parse(stripped);
+    } catch {
+      return void 0;
+    }
+  }
+}
+function installClient(client, opts = {}) {
+  const spec = CLIENTS[client];
+  const cwd = opts.cwd ?? process.cwd();
+  const useGlobal = opts.global || !spec.projectPath;
+  const file = useGlobal ? spec.globalPath : path.join(cwd, spec.projectPath);
+  const existing = readConfig(file);
+  if (existing === void 0) {
+    return {
+      ok: false,
+      client,
+      file,
+      action: "manual",
+      reason: "the file has content this command could not parse, so it was left untouched"
+    };
+  }
+  const existed = fs.existsSync(file) && fs.readFileSync(file, "utf-8").trim().length > 0;
+  const entry = serverEntry(spec.dialect);
+  let changed = false;
+  if (spec.dialect === "opencode") {
+    const mcp = existing.mcp ?? {};
+    if (JSON.stringify(mcp[SERVER_NAME]) !== JSON.stringify(entry)) {
+      mcp[SERVER_NAME] = entry;
+      changed = true;
+    }
+    existing.mcp = mcp;
+    if (!existing.$schema) existing.$schema = "https://opencode.ai/config.json";
+  } else {
+    const servers = existing.mcpServers ?? {};
+    if (JSON.stringify(servers[SERVER_NAME]) !== JSON.stringify(entry)) {
+      servers[SERVER_NAME] = entry;
+      changed = true;
+    }
+    existing.mcpServers = servers;
+  }
+  if (!changed) return { ok: true, client, file, action: "already-present" };
+  try {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+  } catch (error) {
+    return {
+      ok: false,
+      client,
+      file,
+      action: "manual",
+      reason: error instanceof Error ? error.message : String(error)
+    };
+  }
+  return { ok: true, client, file, action: existed ? "updated" : "created" };
+}
+function detectClients(cwd = process.cwd()) {
+  const found = [];
+  for (const id of CLIENT_IDS) {
+    const spec = CLIENTS[id];
+    const project = spec.projectPath ? path.join(cwd, spec.projectPath) : null;
+    const globalDir = path.dirname(spec.globalPath);
+    if (project && fs.existsSync(project) || fs.existsSync(spec.globalPath) || fs.existsSync(globalDir)) {
+      found.push(id);
+    }
+  }
+  return found;
+}
+
+// src/commands/mcp.ts
+var VERSION = true ? "2.4.0" : "0.0.0-dev";
+var CONFIG_SNIPPET = `{
+  "mcpServers": {
+    "vectorvesper": {
+      "command": "npx",
+      "args": ["-y", "vectorvesper@latest", "mcp"]
+    }
+  }
+}`;
+function protectStdout() {
+  const toStderr = (...args) => {
+    console.error(...args);
+  };
+  console.log = toStderr;
+  console.info = toStderr;
+  console.debug = toStderr;
+}
+function printStatus() {
+  const manifest = loadHookManifest();
+  const authed = Boolean(getAuthToken());
+  const ok = (s) => `${pc.green("\u2714")} ${s}`;
+  const bad = (s) => `${pc.red("\u2717")} ${s}`;
+  console.log("");
+  console.log(pc.bold(pc.cyan("  Vector Vesper MCP\n")));
+  console.log(`  ${pc.bold("CLI version:")}   ${VERSION}`);
+  if (manifest) {
+    const hookCount = manifest.hooks.filter((h) => h.category !== "core").length;
+    const coreCount = manifest.hooks.length - hookCount;
+    const patternCount = manifest.patterns?.length ?? 0;
+    console.log(
+      `  ${ok(
+        `Hook manifest: ${hookCount} hooks, ${coreCount} core primitives, ${patternCount} patterns, engine v${manifest.engineVersion}`
+      )}`
+    );
+    console.log(`  ${pc.dim(`Contract level: ${manifest.contractLevel}`)}`);
+  } else {
+    console.log(`  ${bad("Hook manifest: MISSING")}`);
+    console.log(`  ${pc.dim("Reinstall with: npm i -g vectorvesper@latest")}`);
+  }
+  console.log(
+    `  ${authed ? ok("Authenticated \u2014 Pro components available") : pc.dim("\u25CB Not authenticated \u2014 free components only")}`
+  );
+  console.log("");
+  console.log(pc.bold("  Register with an agent"));
+  console.log(pc.dim("  Claude Code:"));
+  console.log(`    ${pc.cyan("claude mcp add -s user vectorvesper -- npx -y vectorvesper@latest mcp")}`);
+  console.log(pc.dim("  Cursor / Claude Desktop / other \u2014 add to the client's MCP config:"));
+  console.log(
+    CONFIG_SNIPPET.split("\n").map((l) => `    ${pc.dim(l)}`).join("\n")
+  );
+  console.log("");
+  console.log(
+    pc.dim(
+      "  Tools: list_hooks \xB7 get_hook \xB7 list_patterns \xB7 get_pattern \xB7 list_components \xB7 get_component \xB7 get_setup_guidance \xB7 search \xB7 check_motion"
+    )
+  );
+  console.log("");
+}
+function printInteractiveHelp() {
+  console.log("");
+  console.log(pc.bold(pc.cyan("  Vector Vesper MCP server")));
+  console.log("");
+  console.log("  This command speaks the Model Context Protocol over stdin/stdout.");
+  console.log("  It is meant to be launched by an AI coding agent, not run by hand \u2014");
+  console.log("  started from a terminal it would just wait for a client that never connects.");
+  console.log("");
+  console.log(`  ${pc.bold("Check your setup:")}  ${pc.cyan("vv mcp status")}`);
+  console.log(`  ${pc.bold("Add to Claude Code:")} ${pc.cyan("claude mcp add vectorvesper -- npx -y vectorvesper@latest mcp")}`);
+  console.log("");
+  console.log(pc.dim("  To run the server here anyway (for debugging): vv mcp --stdio"));
+  console.log("");
+}
+function runInstall(client, options) {
+  const targets = client ? CLIENT_IDS.includes(client) ? [client] : [] : detectClients();
+  if (client && targets.length === 0) {
+    console.error(
+      `
+${pc.red("\u2717")} Unknown client "${client}".
+
+  Known: ${CLIENT_IDS.map((c) => pc.cyan(c)).join(", ")}
+`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (targets.length === 0) {
+    console.log(
+      `
+${pc.yellow("!")} No known MCP client detected on this machine.
+
+  Name one explicitly: ${pc.cyan("vv mcp install <client>")}
+  Known: ${CLIENT_IDS.map((c) => pc.cyan(c)).join(", ")}
+`
+    );
+    return;
+  }
+  console.log("");
+  for (const id of targets) {
+    const spec = CLIENTS[id];
+    const result = installClient(id, { global: options.global });
+    if (!result.ok) {
+      console.log(`${pc.yellow("!")} ${pc.bold(spec.label)} \u2014 ${result.reason}`);
+      console.log(pc.dim(`  ${result.file}`));
+      console.log(pc.dim("  Add this by hand:\n"));
+      console.log(
+        snippet(id).split("\n").map((l) => "    " + pc.dim(l)).join("\n")
+      );
+      console.log("");
+      continue;
+    }
+    const verb = result.action === "already-present" ? pc.dim("already configured") : pc.green(result.action);
+    console.log(`${pc.green("\u2714")} ${pc.bold(spec.label)} \u2014 ${verb}`);
+    console.log(pc.dim(`  ${result.file}`));
+    if (spec.note) console.log(pc.dim(`  ${spec.note}`));
+  }
+  console.log("");
+  console.log(pc.dim("  Restart the client so it picks up the new server."));
+  console.log(pc.dim(`  Then check with: ${pc.cyan("vv mcp status")}`));
+  console.log("");
+}
+async function mcpCommand(action, options = {}) {
+  if (action === "status" || action === "info") {
+    printStatus();
+    return;
+  }
+  if (action === "install" || action === "setup") {
+    runInstall(options.client, { global: options.global });
+    return;
+  }
+  if (action !== void 0) {
+    console.error(
+      `
+${pc.red("\u2717")} Unknown argument "${action}" for \`vv mcp\`.
+
+  ${pc.cyan("vv mcp")}                  start the MCP server (for agents)
+  ${pc.cyan("vv mcp status")}           check the setup and print client config
+  ${pc.cyan("vv mcp install [client]")}  write the config for an agent
+`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (process.stdin.isTTY && !options.stdio) {
+    printInteractiveHelp();
+    return;
+  }
+  protectStdout();
+  const { startMcpServer } = await import("./server-H4XNBFKQ.js");
+  try {
+    await startMcpServer();
+  } catch (error) {
+    console.error(
+      `vectorvesper mcp: failed to start \u2014 ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+}
+export {
+  mcpCommand
+};