mindgraph-mcp 0.14.0 → 0.14.2

package/dist/cli.js

@@ -710,6 +710,22 @@ var init_codegraph = __esm({
   }
 });
 
+// src/error-detail.ts
+function errorDetail(e) {
+  if (e instanceof import_mindgraph.MindGraphError && e.body !== void 0) {
+    const detail = typeof e.body === "string" ? e.body : JSON.stringify(e.body);
+    return `${e.message} \u2014 ${detail}`;
+  }
+  return e instanceof Error ? e.message : String(e);
+}
+var import_mindgraph;
+var init_error_detail = __esm({
+  "src/error-detail.ts"() {
+    "use strict";
+    import_mindgraph = require("mindgraph");
+  }
+});
+
 // src/code-tool.ts
 async function handleCodeTool(client2, args, adapter = new CodegraphAdapter()) {
   const codeClient = client2;
@@ -893,10 +909,7 @@ async function handleCodeTool(client2, args, adapter = new CodegraphAdapter()) {
         return err("unknown_action", `unknown mindgraph_code action: ${action}`);
     }
   } catch (cause) {
-    return err(
-      "code_tool_failed",
-      cause instanceof Error ? cause.message : String(cause)
-    );
+    return err("code_tool_failed", errorDetail(cause));
   }
 }
 async function attachCodeRefsToToolResult(client2, result, args, adapter) {
@@ -1136,6 +1149,7 @@ var ok, err, CODE_TOOL;
 var init_code_tool = __esm({
   "src/code-tool.ts"() {
     "use strict";
+    init_error_detail();
     init_codegraph();
     ok = (data) => ({
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -1304,10 +1318,7 @@ async function handleSyncTool(client2, args) {
     }
     return ok2(await remote.memorySync(request));
   } catch (error) {
-    return err2(
-      "sync_failed",
-      error instanceof Error ? error.message : String(error)
-    );
+    return err2("sync_failed", errorDetail(error));
   }
 }
 async function scanRepository(remote, repository, requested, provider, agentId) {
@@ -1351,6 +1362,7 @@ var init_sync_tool = __esm({
     import_node_fs5 = __toESM(require("fs"));
     import_node_path5 = __toESM(require("path"));
     init_codegraph();
+    init_error_detail();
     ok2 = (data) => ({
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
     });
@@ -1495,12 +1507,7 @@ async function handleTool(client2, name, args) {
     ].includes(action);
     return attach ? await attachCodeRefsToToolResult(client2, result, args) : result;
   } catch (e) {
-    if (e instanceof import_mindgraph.MindGraphError && e.body !== void 0) {
-      const detail = typeof e.body === "string" ? e.body : JSON.stringify(e.body);
-      return err3(`${e.message} \u2014 ${detail}`);
-    }
-    const message = e instanceof Error ? e.message : String(e);
-    return err3(message);
+    return err3(errorDetail(e));
   }
 }
 async function handleCapture(client2, args) {
@@ -1638,13 +1645,23 @@ async function handleReason(client2, args) {
     agent_id
   } = args;
   if (action === "claim") {
-    const claimObj = claim || (label ? { label, confidence } : null);
+    const claimObj = claim ? {
+      label: claim.label,
+      confidence: claim.confidence,
+      ...claim.content ? { props: { content: claim.content } } : {}
+    } : label ? { label, confidence } : null;
     if (!claimObj) return err3("claim object or label is required for action=claim");
     return ok3(
       await client2.argue({
         claim: claimObj,
-        evidence,
-        warrant,
+        evidence: evidence?.map((e) => ({
+          label: e.label,
+          ...e.description ? { props: { description: e.description } } : {}
+        })),
+        warrant: warrant ? {
+          label: warrant.label,
+          ...warrant.content ? { props: { content: warrant.content } } : {}
+        } : void 0,
         argument,
         agent_id
       })
@@ -2384,11 +2401,11 @@ async function handleOntology(client2, args) {
       return err3(`Unknown ontology action: ${action}`);
   }
 }
-var import_mindgraph, TOOLS, INVOCATION_CONTEXT_SCHEMA;
+var TOOLS, INVOCATION_CONTEXT_SCHEMA;
 var init_tools = __esm({
   "src/tools.ts"() {
     "use strict";
-    import_mindgraph = require("mindgraph");
+    init_error_detail();
     init_code_tool();
     init_sync_tool();
     TOOLS = [
@@ -3988,7 +4005,7 @@ Capture knowledge when the user shares something worth remembering:
     server = new import_server.Server(
       {
         name: "mindgraph",
-        version: "0.14.0"
+        version: "0.14.2"
       },
       {
         capabilities: {
@@ -4300,6 +4317,17 @@ function parseArgs(argv) {
   }
   return { command, apiKey, baseUrl, scope, projectDir, harness, hooks };
 }
+function mcpAddFailureOutput(e) {
+  const err5 = e;
+  return `${err5.stdout ?? ""}${err5.stderr ?? ""}`.trim();
+}
+function classifyMcpAddFailure(e) {
+  if (e?.code === "ENOENT") return "missing-cli";
+  if (mcpAddFailureOutput(e).toLowerCase().includes("already exists")) {
+    return "already-exists";
+  }
+  return "other";
+}
 
 // src/claude-hooks.ts
 var import_node_crypto2 = __toESM(require("crypto"));
@@ -4738,7 +4766,20 @@ var import_node_os4 = __toESM(require("os"));
 var import_node_path4 = __toESM(require("path"));
 var import_node_crypto3 = __toESM(require("crypto"));
 var OWNER_MARKER = "--owner mindgraph";
-var COMMAND = "npx -y mindgraph-mcp@latest hook --harness claude-code --owner mindgraph";
+var RUNNER_RELATIVE = ".mindgraph/bin/mindgraph-hook.cjs";
+var COMMAND = `node "$HOME/${RUNNER_RELATIVE}" hook --harness claude-code --owner mindgraph`;
+function installHookRunner(sourceFile, homeDir) {
+  const target = import_node_path4.default.join(homeDir || import_node_os4.default.homedir(), RUNNER_RELATIVE);
+  import_node_fs4.default.mkdirSync(import_node_path4.default.dirname(target), { recursive: true });
+  import_node_fs4.default.copyFileSync(sourceFile, target);
+  return target;
+}
+function uninstallHookRunner(homeDir) {
+  try {
+    import_node_fs4.default.rmSync(import_node_path4.default.join(homeDir || import_node_os4.default.homedir(), RUNNER_RELATIVE));
+  } catch {
+  }
+}
 function settingsPath(scope, projectDir = process.cwd()) {
   return scope === "user" ? import_node_path4.default.join(import_node_os4.default.homedir(), ".claude", "settings.json") : import_node_path4.default.join(projectDir, ".claude", "settings.json");
 }
@@ -4759,7 +4800,7 @@ function desiredEntries() {
     SessionStart: [
       {
         matcher: "startup|resume|clear|compact|fork",
-        hooks: [ownedHook(8)]
+        hooks: [ownedHook(20)]
       }
     ],
     PreToolUse: [
@@ -4799,19 +4840,21 @@ function installClaudeHooks(scope, projectDir = process.cwd()) {
   const settings = readSettings(file);
   const hooks = settings.hooks && typeof settings.hooks === "object" && !Array.isArray(settings.hooks) ? settings.hooks : {};
   let added = 0;
+  let updated = 0;
   for (const [event, wanted] of Object.entries(desiredEntries())) {
     const current = Array.isArray(hooks[event]) ? [...hooks[event]] : [];
+    const kept = current.filter((entry) => !entryHasOwnedHook(entry));
+    const hadOwned = kept.length !== current.length;
     for (const entry of wanted) {
-      if (!current.some(entryHasOwnedHook)) {
-        current.push(entry);
-        added += 1;
-      }
+      kept.push(entry);
+      if (hadOwned) updated += 1;
+      else added += 1;
     }
-    hooks[event] = current;
+    hooks[event] = kept;
   }
   settings.hooks = hooks;
   writeSettings(file, settings);
-  return { path: file, added };
+  return { path: file, added, updated };
 }
 function uninstallClaudeHooks(scope, projectDir = process.cwd()) {
   const file = settingsPath(scope, projectDir);
@@ -4932,7 +4975,7 @@ function installClaudeCode(apiKey, baseUrl) {
     envArgs.push("--env", `MINDGRAPH_BASE_URL=${baseUrl}`);
   }
   try {
-    (0, import_child_process.execFileSync)(
+    const out = (0, import_child_process.execFileSync)(
       "claude",
       [
         "mcp",
@@ -4944,15 +4987,30 @@ function installClaudeCode(apiKey, baseUrl) {
         "-y",
         "mindgraph-mcp@latest"
       ],
-      { stdio: "inherit" }
+      { stdio: ["inherit", "pipe", "pipe"] }
     );
+    if (out?.length) process.stdout.write(out);
     console.log("Added MindGraph MCP server to Claude Code.");
-  } catch {
-    console.error(
-      "Failed to run 'claude mcp add'. Is Claude Code CLI installed?"
-    );
-    console.error("Install it from: https://claude.ai/code");
-    process.exit(1);
+  } catch (e) {
+    switch (classifyMcpAddFailure(e)) {
+      case "already-exists":
+        console.log(
+          "MindGraph MCP server already registered in Claude Code \u2014 leaving it in place."
+        );
+        break;
+      case "missing-cli":
+        console.error(
+          "Failed to run 'claude mcp add'. Is Claude Code CLI installed?"
+        );
+        console.error("Install it from: https://claude.ai/code");
+        process.exit(1);
+        break;
+      default: {
+        const detail = mcpAddFailureOutput(e);
+        console.error(detail || "'claude mcp add' failed.");
+        process.exit(1);
+      }
+    }
   }
 }
 function uninstallClaudeDesktop() {
@@ -5007,9 +5065,11 @@ function withHooksFlag() {
 }
 function finishCodeInstall(apiKey, baseUrl, withHooks) {
   if (withHooks) {
+    const runner = installHookRunner(__filename);
+    console.log(`Installed pinned hook runner at ${runner}`);
     const result = installClaudeHooks("user");
     console.log(
-      `Installed ${result.added} MindGraph Claude Code hook entries in ${result.path}`
+      `Installed ${result.added} and refreshed ${result.updated} MindGraph Claude Code hook entries in ${result.path}`
     );
     const envPath = saveHookEnv({ apiKey, baseUrl });
     console.log(`Saved hook connection settings to ${envPath} (mode 600)`);
@@ -5215,9 +5275,11 @@ async function main2() {
       if ((harness || "claude-code") !== "claude-code") {
         throw new Error("only --harness claude-code is available in this release");
       }
+      const runner = installHookRunner(__filename);
+      console.log(`Installed pinned hook runner at ${runner}`);
       const result = installClaudeHooks(scope, projectDir);
       console.log(
-        `Installed ${result.added} MindGraph Claude Code hook entries in ${result.path}`
+        `Installed ${result.added} and refreshed ${result.updated} MindGraph Claude Code hook entries in ${result.path}`
       );
       if (apiKey || baseUrl) {
         const envPath = saveHookEnv({ apiKey, baseUrl });
@@ -5233,6 +5295,7 @@ async function main2() {
       if ((harness || "claude-code") !== "claude-code") {
         throw new Error("only --harness claude-code is available in this release");
       }
+      uninstallHookRunner();
       const result = uninstallClaudeHooks(scope, projectDir);
       console.log(
         `Removed ${result.removed} MindGraph Claude Code hooks from ${result.path}`

package/dist/index.js

@@ -28,8 +28,15 @@ var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_mindgraph2 = require("mindgraph");
 
-// src/tools.ts
+// src/error-detail.ts
 var import_mindgraph = require("mindgraph");
+function errorDetail(e) {
+  if (e instanceof import_mindgraph.MindGraphError && e.body !== void 0) {
+    const detail = typeof e.body === "string" ? e.body : JSON.stringify(e.body);
+    return `${e.message} \u2014 ${detail}`;
+  }
+  return e instanceof Error ? e.message : String(e);
+}
 
 // src/codegraph.ts
 var import_node_child_process = require("child_process");
@@ -964,10 +971,7 @@ async function handleCodeTool(client2, args, adapter = new CodegraphAdapter()) {
         return err("unknown_action", `unknown mindgraph_code action: ${action}`);
     }
   } catch (cause) {
-    return err(
-      "code_tool_failed",
-      cause instanceof Error ? cause.message : String(cause)
-    );
+    return err("code_tool_failed", errorDetail(cause));
   }
 }
 async function attachCodeRefsToToolResult(client2, result, args, adapter) {
@@ -1374,10 +1378,7 @@ async function handleSyncTool(client2, args) {
     }
     return ok2(await remote.memorySync(request));
   } catch (error) {
-    return err2(
-      "sync_failed",
-      error instanceof Error ? error.message : String(error)
-    );
+    return err2("sync_failed", errorDetail(error));
   }
 }
 async function scanRepository(remote, repository, requested, provider, agentId) {
@@ -2426,12 +2427,7 @@ async function handleTool(client2, name, args) {
     ].includes(action);
     return attach ? await attachCodeRefsToToolResult(client2, result, args) : result;
   } catch (e) {
-    if (e instanceof import_mindgraph.MindGraphError && e.body !== void 0) {
-      const detail = typeof e.body === "string" ? e.body : JSON.stringify(e.body);
-      return err3(`${e.message} \u2014 ${detail}`);
-    }
-    const message = e instanceof Error ? e.message : String(e);
-    return err3(message);
+    return err3(errorDetail(e));
   }
 }
 async function handleCapture(client2, args) {
@@ -2569,13 +2565,23 @@ async function handleReason(client2, args) {
     agent_id
   } = args;
   if (action === "claim") {
-    const claimObj = claim || (label ? { label, confidence } : null);
+    const claimObj = claim ? {
+      label: claim.label,
+      confidence: claim.confidence,
+      ...claim.content ? { props: { content: claim.content } } : {}
+    } : label ? { label, confidence } : null;
     if (!claimObj) return err3("claim object or label is required for action=claim");
     return ok3(
       await client2.argue({
         claim: claimObj,
-        evidence,
-        warrant,
+        evidence: evidence?.map((e) => ({
+          label: e.label,
+          ...e.description ? { props: { description: e.description } } : {}
+        })),
+        warrant: warrant ? {
+          label: warrant.label,
+          ...warrant.content ? { props: { content: warrant.content } } : {}
+        } : void 0,
         argument,
         agent_id
       })
@@ -3925,7 +3931,7 @@ if (PROFILE === "coding") {
 var server = new import_server.Server(
   {
     name: "mindgraph",
-    version: "0.14.0"
+    version: "0.14.2"
   },
   {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph-mcp",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "MCP server for MindGraph — connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
   "repository": {
     "type": "git",