mindgraph-mcp 0.14.3 → 0.14.5

package/README.md

@@ -151,8 +151,14 @@ mindgraph-mcp uninstall-hooks  Remove MindGraph-owned hook entries
 mindgraph-mcp status           Show installation status
 ```
 
-Options: `--api-key <key>`, `--base-url <url>`, `--scope user|project`,
-`--project-dir <dir>`, `--harness <name>`, `--help`.
+Options: `--api-key <key>`, `--base-url <url>`, `--agent-id <id>`,
+`--scope user|project`, `--project-dir <dir>`, `--harness <name>`, `--help`.
+
+**Teams**: when several people share one org graph, give each member a
+distinct identity — `--agent-id claude-code:<name>` on `install-code` /
+`install-hooks`. Anchored knowledge is shared automatically; distinct agent
+ids keep task leases and resume briefs per-person (identical ids make
+teammates one logical agent, which claims each other's work).
 
 ## Environment
 

package/dist/cli.js

@@ -916,6 +916,15 @@ var init_dist = __esm({
 });
 
 // src/codegraph.ts
+function unavailabilityCaveats(reason, message) {
+  const caveats = [message || "codegraph status failed"];
+  if (reason === "absent") {
+    caveats.push(
+      "Optional: install codegraph (https://github.com/colbymchenry/codegraph) and run `codegraph init` in this repository to enable code anchoring and structural recall. Memory and work tools are unaffected."
+    );
+  }
+  return caveats;
+}
 function normalizePath(path6) {
   return path6.replaceAll("\\", "/").replace(/^\.\//, "");
 }
@@ -1272,11 +1281,12 @@ var init_codegraph = __esm({
           return availability;
         } catch (cause) {
           const failure = cause;
+          const reason = failure.kind ?? "command_failed";
           return {
             available: false,
-            reason: failure.kind ?? "command_failed",
+            reason,
             stale: false,
-            caveats: [failure.message || "codegraph status failed"]
+            caveats: unavailabilityCaveats(reason, failure.message)
           };
         }
       }
@@ -4893,7 +4903,7 @@ Capture knowledge when the user shares something worth remembering:
     server = new import_server.Server(
       {
         name: "mindgraph",
-        version: "0.14.3"
+        version: "0.14.5"
       },
       {
         capabilities: {
@@ -5131,7 +5141,8 @@ function loadHookEnv(dir) {
     const parsed = JSON.parse(raw);
     return {
       baseUrl: typeof parsed.baseUrl === "string" ? parsed.baseUrl : void 0,
-      apiKey: typeof parsed.apiKey === "string" ? parsed.apiKey : void 0
+      apiKey: typeof parsed.apiKey === "string" ? parsed.apiKey : void 0,
+      agentId: typeof parsed.agentId === "string" ? parsed.agentId : void 0
     };
   } catch {
     return {};
@@ -5143,7 +5154,8 @@ function saveHookEnv(env, dir) {
   const existing = loadHookEnv(dir);
   const merged = {
     baseUrl: env.baseUrl ?? existing.baseUrl,
-    apiKey: env.apiKey ?? existing.apiKey
+    apiKey: env.apiKey ?? existing.apiKey,
+    agentId: env.agentId ?? existing.agentId
   };
   import_node_fs.default.writeFileSync(file, `${JSON.stringify(merged, null, 2)}
 `, {
@@ -5163,6 +5175,7 @@ function parseArgs(argv) {
   let projectDir;
   let harness;
   let hooks = false;
+  let agentId = process.env.MINDGRAPH_AGENT_ID;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     switch (arg) {
@@ -5186,6 +5199,9 @@ function parseArgs(argv) {
       case "--harness":
         harness = args[++i];
         break;
+      case "--agent-id":
+        agentId = args[++i];
+        break;
       case "--hooks":
         hooks = true;
         break;
@@ -5203,7 +5219,7 @@ function parseArgs(argv) {
         break;
     }
   }
-  return { command, apiKey, baseUrl, scope, projectDir, harness, hooks };
+  return { command, apiKey, baseUrl, scope, projectDir, harness, hooks, agentId };
 }
 function mcpAddFailureOutput(e) {
   const err5 = e;
@@ -5848,7 +5864,7 @@ function installClaudeDesktop(apiKey, baseUrl) {
   }
   console.log("Restart Claude Desktop to activate.");
 }
-function installClaudeCode(apiKey, baseUrl) {
+function installClaudeCode(apiKey, baseUrl, agentId) {
   const envArgs = [
     `--env`,
     `MINDGRAPH_API_KEY=${apiKey}`,
@@ -5857,7 +5873,7 @@ function installClaudeCode(apiKey, baseUrl) {
     "--env",
     "MINDGRAPH_HARNESS=claude-code",
     "--env",
-    "MINDGRAPH_AGENT_ID=claude-code"
+    `MINDGRAPH_AGENT_ID=${agentId || "claude-code"}`
   ];
   if (baseUrl) {
     envArgs.push("--env", `MINDGRAPH_BASE_URL=${baseUrl}`);
@@ -5951,7 +5967,7 @@ function printStatus() {
 function withHooksFlag() {
   return process.argv.includes("--hooks");
 }
-function finishCodeInstall(apiKey, baseUrl, withHooks) {
+function finishCodeInstall(apiKey, baseUrl, withHooks, agentId) {
   if (withHooks) {
     const runner = installHookRunner(__filename);
     console.log(`Installed pinned hook runner at ${runner}`);
@@ -5959,7 +5975,7 @@ function finishCodeInstall(apiKey, baseUrl, withHooks) {
     console.log(
       `Installed ${result.added} and refreshed ${result.updated} MindGraph Claude Code hook entries in ${result.path}`
     );
-    const envPath = saveHookEnv({ apiKey, baseUrl });
+    const envPath = saveHookEnv({ apiKey, baseUrl, agentId });
     console.log(`Saved hook connection settings to ${envPath} (mode 600)`);
   } else {
     console.log(
@@ -6111,13 +6127,23 @@ async function interactiveInit(baseUrl) {
       installClaudeDesktop(apiKey, baseUrl);
       break;
     case "2":
-      installClaudeCode(apiKey, baseUrl);
-      finishCodeInstall(apiKey, baseUrl, withHooksFlag());
+      installClaudeCode(apiKey, baseUrl, process.env.MINDGRAPH_AGENT_ID);
+      finishCodeInstall(
+        apiKey,
+        baseUrl,
+        withHooksFlag(),
+        process.env.MINDGRAPH_AGENT_ID
+      );
       break;
     case "3":
       installClaudeDesktop(apiKey, baseUrl);
-      installClaudeCode(apiKey, baseUrl);
-      finishCodeInstall(apiKey, baseUrl, withHooksFlag());
+      installClaudeCode(apiKey, baseUrl, process.env.MINDGRAPH_AGENT_ID);
+      finishCodeInstall(
+        apiKey,
+        baseUrl,
+        withHooksFlag(),
+        process.env.MINDGRAPH_AGENT_ID
+      );
       break;
     default:
       console.error("Invalid choice.");
@@ -6126,7 +6152,7 @@ async function interactiveInit(baseUrl) {
   console.log("\nDone! Your knowledge graph is now connected.");
 }
 async function main2() {
-  const { command, apiKey, baseUrl, scope, projectDir, harness, hooks } = parseArgs(process.argv);
+  const { command, apiKey, baseUrl, scope, projectDir, harness, hooks, agentId } = parseArgs(process.argv);
   switch (command) {
     case "help":
       printUsage();
@@ -6150,8 +6176,8 @@ async function main2() {
         );
         process.exit(1);
       }
-      installClaudeCode(apiKey, baseUrl);
-      finishCodeInstall(apiKey, baseUrl, withHooksFlag());
+      installClaudeCode(apiKey, baseUrl, agentId);
+      finishCodeInstall(apiKey, baseUrl, withHooksFlag(), agentId);
       break;
     case "uninstall":
       uninstallClaudeDesktop();
@@ -6169,8 +6195,9 @@ async function main2() {
       console.log(
         `Installed ${result.added} and refreshed ${result.updated} MindGraph Claude Code hook entries in ${result.path}`
       );
-      if (apiKey || baseUrl) {
-        const envPath = saveHookEnv({ apiKey, baseUrl });
+      printCodegraphStatus();
+      if (apiKey || baseUrl || agentId) {
+        const envPath = saveHookEnv({ apiKey, baseUrl, agentId });
         console.log(`Saved hook connection settings to ${envPath} (mode 600)`);
       } else {
         console.log(
@@ -6208,7 +6235,7 @@ async function main2() {
           telemetrySurface: "mcp"
         });
         const output = await runClaudeHook(input, client2, {
-          agentId: process.env.MINDGRAPH_AGENT_ID || "claude-code"
+          agentId: process.env.MINDGRAPH_AGENT_ID || stored.agentId || "claude-code"
         });
         process.stdout.write(`${JSON.stringify(output)}
 `);

package/dist/index.js

@@ -45,6 +45,15 @@ var import_promises = require("fs/promises");
 var import_node_os = require("os");
 var import_node_path = require("path");
 var import_node_crypto = require("crypto");
+function unavailabilityCaveats(reason, message) {
+  const caveats = [message || "codegraph status failed"];
+  if (reason === "absent") {
+    caveats.push(
+      "Optional: install codegraph (https://github.com/colbymchenry/codegraph) and run `codegraph init` in this repository to enable code anchoring and structural recall. Memory and work tools are unaffected."
+    );
+  }
+  return caveats;
+}
 var DEFAULT_TIMEOUT_MS = 5e3;
 var DEFAULT_STATUS_TTL_MS = 6e4;
 var MAX_OUTPUT_BYTES = 5 * 1024 * 1024;
@@ -364,11 +373,12 @@ var CodegraphAdapter = class {
       return availability;
     } catch (cause) {
       const failure = cause;
+      const reason = failure.kind ?? "command_failed";
       return {
         available: false,
-        reason: failure.kind ?? "command_failed",
+        reason,
         stale: false,
-        caveats: [failure.message || "codegraph status failed"]
+        caveats: unavailabilityCaveats(reason, failure.message)
       };
     }
   }
@@ -3931,7 +3941,7 @@ if (PROFILE === "coding") {
 var server = new import_server.Server(
   {
     name: "mindgraph",
-    version: "0.14.3"
+    version: "0.14.5"
   },
   {
     capabilities: {

package/package.json

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