mindgraph-mcp 0.24.0 → 0.26.0

package/dist/cli.js

@@ -35,14 +35,14 @@ function errorFields(body) {
     ...typeof fields.retriable === "boolean" ? { retriable: fields.retriable } : {}
   };
 }
-function canRetryRequest(method, path9, body) {
+function canRetryRequest(method, path10, body) {
   if (method === "GET" || method === "HEAD") return true;
   if (method !== "POST") return false;
-  if (READ_POSTS.has(path9)) return true;
+  if (READ_POSTS.has(path10)) return true;
   const fields = body && typeof body === "object" && !Array.isArray(body) ? body : {};
   if (typeof fields.action !== "string") return false;
-  if (Object.prototype.hasOwnProperty.call(READ_ACTIONS, path9) && READ_ACTIONS[path9].includes(fields.action)) return true;
-  return path9 === "/agent/plan" && IDEMPOTENT_WORK.has(fields.action) && typeof fields.idempotency_key === "string" && fields.idempotency_key.trim().length > 0;
+  if (Object.prototype.hasOwnProperty.call(READ_ACTIONS, path10) && READ_ACTIONS[path10].includes(fields.action)) return true;
+  return path10 === "/agent/plan" && IDEMPOTENT_WORK.has(fields.action) && typeof fields.idempotency_key === "string" && fields.idempotency_key.trim().length > 0;
 }
 function permitsRetry(fields) {
   return fields.retriable !== false && ![
@@ -179,8 +179,8 @@ var init_dist = __esm({
         }
       }
       // ---- HTTP helpers ----
-      async request(method, path9, body) {
-        const url = `${this.baseUrl}${path9}`;
+      async request(method, path10, body) {
+        const url = `${this.baseUrl}${path10}`;
         const requestId = createRequestId();
         const init = {
           method,
@@ -195,12 +195,12 @@ var init_dist = __esm({
         }
         const retrySafe = canRetryRequest(
           method,
-          path9,
+          path10,
           typeof init.body === "string" ? JSON.parse(init.body) : void 0
         );
         let lastError;
         for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-          const res = await this.fetchWithDeadline(url, init, method, path9);
+          const res = await this.fetchWithDeadline(url, init, method, path10);
           if (!res.ok) {
             const text22 = await res.text().catch(() => "");
             let parsed;
@@ -210,7 +210,7 @@ var init_dist = __esm({
               parsed = text22;
             }
             const err6 = new MindGraphError(
-              `${method} ${path9} failed: ${res.status}`,
+              `${method} ${path10} failed: ${res.status}`,
               res.status,
               parsed
             );
@@ -234,7 +234,7 @@ var init_dist = __esm({
        * "timeout"`, `status: 0`). Without it the request is sent unchanged — no
        * AbortSignal is attached, preserving the pre-0.16 behaviour.
        */
-      async fetchWithDeadline(url, init, method, path9) {
+      async fetchWithDeadline(url, init, method, path10) {
         if (this.timeoutMs === void 0) {
           return fetch(url, init);
         }
@@ -245,7 +245,7 @@ var init_dist = __esm({
         } catch (error2) {
           if (controller.signal.aborted) {
             throw new MindGraphError(
-              `${method} ${path9} timed out after ${this.timeoutMs}ms`,
+              `${method} ${path10} timed out after ${this.timeoutMs}ms`,
               0,
               { error: "timeout", code: "timeout", retriable: false }
             );
@@ -255,17 +255,17 @@ var init_dist = __esm({
           clearTimeout(timer);
         }
       }
-      get(path9) {
-        return this.request("GET", path9);
+      get(path10) {
+        return this.request("GET", path10);
       }
-      post(path9, body) {
-        return this.request("POST", path9, body);
+      post(path10, body) {
+        return this.request("POST", path10, body);
       }
-      patch(path9, body) {
-        return this.request("PATCH", path9, body);
+      patch(path10, body) {
+        return this.request("PATCH", path10, body);
       }
-      del(path9) {
-        return this.request("DELETE", path9);
+      del(path10) {
+        return this.request("DELETE", path10);
       }
       // ---- Health ----
       async health() {
@@ -1240,14 +1240,14 @@ function unavailabilityCaveats(reason, message) {
   }
   return caveats;
 }
-function normalizePath(path9) {
-  return path9.replaceAll("\\", "/").replace(/^\.\//, "");
+function normalizePath(path10) {
+  return path10.replaceAll("\\", "/").replace(/^\.\//, "");
 }
 function normalizeSignature(signature) {
   return signature.replace(/\s+/g, " ").trim();
 }
-function languageFromPath(path9) {
-  const extension = (0, import_node_path2.extname)(path9).toLowerCase();
+function languageFromPath(path10) {
+  const extension = (0, import_node_path2.extname)(path10).toLowerCase();
   return {
     ".c": "c",
     ".cc": "cpp",
@@ -1313,6 +1313,15 @@ function nearestExistingDirectory(candidate) {
     current = parent;
   }
 }
+function findChildWorkspaceFiles(start) {
+  let entries;
+  try {
+    entries = (0, import_node_fs2.readdirSync)(start, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  return entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).slice(0, MAX_CHILD_DIRECTORIES).map((entry) => (0, import_node_path2.join)(start, entry.name, ".mindgraph", "workspace.json")).filter((candidate) => (0, import_node_fs2.existsSync)(candidate)).sort();
+}
 function findWorkspaceFile(start, explicit) {
   if (explicit) return (0, import_node_path2.resolve)(start, explicit);
   let current = (0, import_node_path2.resolve)(start);
@@ -1408,7 +1417,7 @@ function codeRefIdentityKey(ref) {
     }
   };
 }
-var import_node_child_process, import_node_fs2, import_promises, import_node_os2, import_node_path2, import_node_crypto3, UnknownRepositoryError, DEFAULT_TIMEOUT_MS, DEFAULT_STATUS_TTL_MS, MAX_OUTPUT_BYTES, CodegraphAdapter;
+var import_node_child_process, import_node_fs2, import_promises, import_node_os2, import_node_path2, import_node_crypto3, UnknownRepositoryError, DEFAULT_TIMEOUT_MS, DEFAULT_STATUS_TTL_MS, MAX_OUTPUT_BYTES, MAX_CHILD_DIRECTORIES, CodegraphAdapter;
 var init_codegraph = __esm({
   "src/codegraph.ts"() {
     "use strict";
@@ -1431,12 +1440,14 @@ var init_codegraph = __esm({
     DEFAULT_TIMEOUT_MS = 5e3;
     DEFAULT_STATUS_TTL_MS = 6e4;
     MAX_OUTPUT_BYTES = 5 * 1024 * 1024;
+    MAX_CHILD_DIRECTORIES = 200;
     CodegraphAdapter = class {
       timeoutMs;
       statusTtlMs;
       env;
       cwd;
       workspaceFile;
+      childWorkspaceFiles;
       now;
       identityCache = /* @__PURE__ */ new Map();
       statusCache = /* @__PURE__ */ new Map();
@@ -1449,6 +1460,7 @@ var init_codegraph = __esm({
           this.cwd,
           options.workspaceFile ?? this.env.MINDGRAPH_WORKSPACE_FILE
         );
+        this.childWorkspaceFiles = !this.workspaceFile && options.childWorkspaces ? findChildWorkspaceFiles(this.cwd) : [];
         this.now = options.now ?? Date.now;
       }
       async resolveRepository(repo, fallbackSpaceUid) {
@@ -1772,13 +1784,15 @@ var init_codegraph = __esm({
       }
       configuredRepositories() {
         const configured = [];
-        if (this.workspaceFile && (0, import_node_fs2.existsSync)(this.workspaceFile)) {
+        const workspaceFiles = this.workspaceFile ? [this.workspaceFile] : this.childWorkspaceFiles;
+        for (const workspaceFile of workspaceFiles) {
+          if (!(0, import_node_fs2.existsSync)(workspaceFile)) continue;
           try {
             const parsed = JSON.parse(
-              (0, import_node_fs2.readFileSync)(this.workspaceFile, "utf8")
+              (0, import_node_fs2.readFileSync)(workspaceFile, "utf8")
             );
             if (parsed.v === 1 && Array.isArray(parsed.repositories)) {
-              const configDirectory = (0, import_node_path2.dirname)(this.workspaceFile);
+              const configDirectory = (0, import_node_path2.dirname)(workspaceFile);
               const base = (0, import_node_path2.basename)(configDirectory) === ".mindgraph" ? (0, import_node_path2.dirname)(configDirectory) : configDirectory;
               for (const repository of parsed.repositories) {
                 if (!repository || typeof repository.root !== "string") continue;
@@ -1959,1735 +1973,1926 @@ var init_codegraph = __esm({
   }
 });
 
-// src/error-detail.ts
-function errorDetail(e) {
-  if (e instanceof MindGraphError && e.body !== void 0) {
-    const detail = typeof e.body === "string" ? e.body : JSON.stringify(e.body);
-    return `${e.message} \u2014 ${detail}`;
+// src/render.ts
+function obj(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function str(value) {
+  return typeof value === "string" && value ? value : void 0;
+}
+function num(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function edgeTypeName(value) {
+  return str(value) ?? str(obj(value)?.Custom);
+}
+function renderBudget(requested) {
+  if (requested === void 0 || !Number.isFinite(requested)) return RENDER_CHAR_BUDGET;
+  return Math.min(
+    RENDER_CHAR_BUDGET,
+    Math.max(MIN_RENDER_CHAR_BUDGET, Math.floor(requested))
+  );
+}
+function clip(value, max, state) {
+  const text2 = str(value);
+  if (!text2) return void 0;
+  if (text2.length <= max) return text2;
+  state.bounded = true;
+  return `${text2.slice(0, max - 1)}\u2026`;
+}
+function isNodeShaped(value) {
+  const node = obj(value);
+  return Boolean(
+    node && str(node.uid) && (str(node.label) || str(node.node_type) || obj(node.node_type))
+  );
+}
+function nodeDisplayType(node) {
+  const props = obj(node.props);
+  const plain = str(node.node_type);
+  return (plain && plain !== "Custom" ? plain : void 0) ?? str(obj(node.node_type)?.Custom) ?? str(props?.object_type) ?? str(props?.type_name) ?? str(obj(props?.data)?.domain_type) ?? plain ?? "Node";
+}
+function nodeFields(node) {
+  const props = obj(node.props);
+  return obj(props?.fields) ?? obj(obj(props?.data)?.fields);
+}
+function unwrapSearchResult(value) {
+  if (isNodeShaped(value)) return value;
+  const wrapper = obj(value);
+  const inner = obj(wrapper?.node) ?? obj(wrapper?.object);
+  if (inner && isNodeShaped(inner)) {
+    const score = num(wrapper.score);
+    return score !== void 0 ? { ...inner, retrieval_score: score } : inner;
   }
-  return e instanceof Error ? e.message : String(e);
+  return void 0;
 }
-function conflictState(e) {
-  if (!(e instanceof MindGraphError) || !e.body || typeof e.body !== "object") {
-    return {};
+function supersededBy(node) {
+  const marker = node.superseded;
+  if (!marker) return void 0;
+  const head = obj(marker);
+  if (!head) return str(node.superseded_by) ?? "";
+  const label = (str(head.head_label) ?? str(head.head_uid) ?? "").replace(/\s+/g, " ").trim();
+  const short = label.length <= 80 ? label : `${label.slice(0, 79)}\u2026`;
+  const date = str(head.head_stated_at);
+  return short && date ? `${short} (${date.slice(0, 10)})` : short;
+}
+function statusTag(node) {
+  const tags = [];
+  const replacement = supersededBy(node);
+  if (replacement !== void 0) {
+    tags.push(replacement ? `SUPERSEDED by ${replacement}` : "SUPERSEDED");
   }
-  const body = e.body;
-  const lifted = {};
-  for (const key of CONFLICT_STATE_KEYS) {
-    if (body[key] !== void 0) lifted[key] = body[key];
+  const truth = str(node.truth_status) ?? str(obj(node.props)?.truth_status);
+  if (truth && truth !== "accepted") tags.push(`truth: ${truth}`);
+  if (node.currently_valid === false) tags.push("OUTSIDE ITS VALIDITY WINDOW");
+  if (node.valid_at_time === false) tags.push("NOT VALID AT THE REQUESTED TIME");
+  return tags.length > 0 ? ` [${tags.join("; ")}]` : "";
+}
+function firstQuote(node, state) {
+  const chunks = Array.isArray(node.source_chunks) ? node.source_chunks : [];
+  for (const raw of chunks) {
+    const chunk = obj(raw);
+    const quote = str(chunk?.quote) ?? str(obj(chunk?.anchor)?.exact);
+    if (quote) return clip(quote, QUOTE_MAX, state);
   }
-  return lifted;
+  return void 0;
 }
-function toolError(e, fallbackCode) {
-  const body = e instanceof MindGraphError && e.body && typeof e.body === "object" && !Array.isArray(e.body) ? e.body : {};
-  const code = typeof body.code === "string" ? body.code : fallbackCode;
-  const payload = {
-    error: errorDetail(e),
-    ...conflictState(e),
-    ...e instanceof MindGraphError ? { status: e.status } : {},
-    ...code !== void 0 ? { code } : {},
-    ...typeof body.retriable === "boolean" ? { retriable: body.retriable } : {}
-  };
-  return {
-    content: [{ type: "text", text: JSON.stringify(payload) }],
-    structuredContent: payload,
-    isError: true
-  };
+function sourceTag(node) {
+  const docs = Array.isArray(node.source_documents) ? node.source_documents : [];
+  const first = obj(docs[0]);
+  const title = str(first?.title);
+  if (!title) return void 0;
+  const extra = docs.length > 1 ? ` (+${docs.length - 1} more)` : "";
+  return `from: ${title}${extra}`;
 }
-var CONFLICT_STATE_KEYS;
-var init_error_detail = __esm({
-  "src/error-detail.ts"() {
-    "use strict";
-    init_dist();
-    CONFLICT_STATE_KEYS = [
-      "current_version",
-      "current_epoch",
-      "lease_expires_at",
-      "lease_owner_agent_id"
-    ];
-  }
-});
-
-// src/code-tool.ts
-async function handleCodeTool(client2, args, adapter = new CodegraphAdapter({ cwd: invocationCwd(args) })) {
-  const codeClient = client2;
-  const action = args.action;
-  const refs = Array.isArray(args.code_refs) ? args.code_refs : [];
-  const anchorUids = Array.isArray(args.anchor_uids) ? args.anchor_uids : [];
-  const agentId = typeof args.agent_id === "string" ? args.agent_id : "mcp";
-  const fallbackSpaceUid = typeof args.repo_space_uid === "string" ? args.repo_space_uid : void 0;
-  const options = {
-    repo: typeof args.repo === "string" ? args.repo : void 0,
-    fallbackSpaceUid
-  };
-  const limit = typeof args.limit === "number" ? args.limit : void 0;
-  try {
-    switch (action) {
-      case "anchor": {
-        if (refs.length === 0) return err("missing_code_refs", "code_refs is required for anchor");
-        const resolution = await adapter.resolveRefs(refs, options);
-        const resolved = resolution.results.flatMap(
-          (result) => result.resolved && result.repository ? [{ ref: result.resolved, repository: result.repository }] : []
-        );
-        const unresolved = resolution.results.filter((result) => !result.resolved);
-        if (resolved.length === 0) {
-          return ok({ ...resolution, anchors: [], wrote: false });
-        }
-        const missingSpace = resolved.find(
-          ({ repository }) => typeof args.repo_space_uid !== "string" && !repository.spaceUid
-        );
-        if (missingSpace) {
-          return err(
-            "missing_repository_space",
-            `repo_space_uid, a workspace space_uid, or MINDGRAPH_CODE_SPACE_UID is required for ${missingSpace.repository.repoId}`
-          );
-        }
-        const repositoryAnchors = /* @__PURE__ */ new Map();
-        for (const { repository } of resolved) {
-          if (repositoryAnchors.has(repository.repoRoot)) continue;
-          const spaceUid = typeof args.repo_space_uid === "string" ? args.repo_space_uid : repository.spaceUid;
-          const anchored = await anchorRepository(
-            codeClient,
-            repository,
-            spaceUid,
-            agentId
-          );
-          repositoryAnchors.set(repository.repoRoot, {
-            ...anchored,
-            repository
-          });
-        }
-        const anchors = [];
-        for (const { ref, repository } of resolved) {
-          const repositoryAnchor = repositoryAnchors.get(repository.repoRoot);
-          if (!repositoryAnchor.uid) continue;
-          const spaceUid = typeof args.repo_space_uid === "string" ? args.repo_space_uid : repository.spaceUid;
-          const anchor = await anchorCodeRef(
-            codeClient,
-            ref,
-            repositoryAnchor.uid,
-            spaceUid,
-            agentId
-          );
-          anchors.push(anchor);
-        }
-        return ok({
-          availability: resolution.availability,
-          repository: repositoryAnchors.values().next().value,
-          repositories: [...repositoryAnchors.values()],
-          anchors,
-          unresolved,
-          wrote: anchors.some((anchor) => anchor.created)
-        });
-      }
-      case "recall": {
-        const materialized = new Set(anchorUids);
-        let resolution;
-        if (refs.length > 0) {
-          resolution = await adapter.resolveRefs(refs, options);
-          for (const result of resolution.results) {
-            if (!result.resolved) continue;
-            const uid = await resolveMaterializedUid(codeClient, result.resolved, agentId);
-            if (uid) materialized.add(uid);
-          }
-        }
-        if (materialized.size === 0) {
-          return ok({
-            availability: resolution?.availability,
-            anchors: [],
-            context: [],
-            unresolved: resolution?.results.filter((result) => !result.resolved) ?? []
-          });
-        }
-        const context = await Promise.all(
-          [...materialized].map(async (uid) => ({
-            anchor_uid: uid,
-            graph: await codeClient.traverse({
-              action: "neighborhood",
-              start_uid: uid,
-              depth: 2,
-              max_nodes: Math.min(limit ?? 20, 20)
-            })
-          }))
-        );
-        return ok({
-          availability: resolution?.availability,
-          anchors: [...materialized],
-          context,
-          unresolved: resolution?.results.filter((result) => !result.resolved) ?? []
-        });
-      }
-      case "expand": {
-        const target = await resolveSingleTarget(
-          codeClient,
-          adapter,
-          refs,
-          anchorUids,
-          options
-        );
-        if ("error" in target) return target.error;
-        const expanded = await adapter.expand(target.ref, limit);
-        const joined = await joinMaterialized(
-          codeClient,
-          [...expanded.callers, ...expanded.callees],
-          agentId,
-          Math.min(limit ?? 20, 20)
-        );
-        return ok({ anchor: target.ref, ...expanded, materialized: joined });
-      }
-      case "affected": {
-        const targetUid = typeof args.task_uid === "string" ? args.task_uid : typeof args.execution_uid === "string" ? args.execution_uid : void 0;
-        let graphContext;
-        const graphRefs = [];
-        let unavailableRepositories = [];
-        if (targetUid) {
-          graphContext = await codeClient.traverse({
-            action: "neighborhood",
-            start_uid: targetUid,
-            depth: 2,
-            max_nodes: 50
-          });
-          const fromGraph = await codeRefsFromGraphContext(
-            codeClient,
-            adapter,
-            graphContext
-          );
-          graphRefs.push(...fromGraph.refs);
-          unavailableRepositories = fromGraph.unavailable;
-        }
-        if (refs.length > 0 || anchorUids.length > 0) {
-          const target = await resolveSingleTarget(
-            codeClient,
-            adapter,
-            refs,
-            anchorUids,
-            options
-          );
-          if ("error" in target) return target.error;
-          graphRefs.unshift(target.ref);
-        }
-        const unique = uniqueRefs(graphRefs);
-        if (unique.length === 0) {
-          return ok({
-            target_uid: targetUid,
-            graph_context: graphContext,
-            affected: [],
-            degradation: unavailableRepositories.length > 0 ? `attached code anchors reference repositories unavailable here: ${unavailableRepositories.join(", ")}` : "no materialized code anchors were attached",
-            ...unavailableRepositories.length > 0 ? { unavailable_repositories: unavailableRepositories } : {}
-          });
-        }
-        const impacts = await Promise.all(
-          unique.map(async (ref) => ({ anchor: ref, ...await adapter.affected(ref, limit) }))
-        );
-        const structural = uniqueRefs(impacts.flatMap((impact) => impact.affected));
-        const joined = await joinMaterialized(
-          codeClient,
-          structural,
-          agentId,
-          Math.min(limit ?? 50, 50)
-        );
-        return ok({
-          target_uid: targetUid,
-          graph_context: graphContext,
-          impacts,
-          materialized: joined,
-          ...unavailableRepositories.length > 0 ? { unavailable_repositories: unavailableRepositories } : {}
-        });
-      }
-      default:
-        return err("unknown_action", `unknown mindgraph_code action: ${action}`);
-    }
-  } catch (cause) {
-    if (cause instanceof UnknownRepositoryError) {
-      return err("unknown_repository", cause.message);
-    }
-    return toolError(cause, "code_tool_failed");
+function layer7Fields(node, state) {
+  const fields = nodeFields(node);
+  if (!fields) return void 0;
+  const pairs = Object.entries(fields).filter(([, value]) => value !== null && value !== void 0 && value !== "").map(([key, value]) => `${key}: ${Array.isArray(value) ? value.join(", ") : String(value)}`);
+  if (pairs.length === 0) return void 0;
+  return clip(pairs.join("; "), SUMMARY_MAX, state);
+}
+function nodeSummaryText(node, state) {
+  const props = obj(node.props);
+  return clip(node.summary, SUMMARY_MAX, state) ?? clip(props?.content, SUMMARY_MAX, state) ?? clip(props?.description, SUMMARY_MAX, state) ?? clip(props?.definition, SUMMARY_MAX, state);
+}
+function nodeLines(node, state) {
+  const label = clip(node.label, LABEL_MAX, state) || "(unlabeled)";
+  const type = nodeDisplayType(node);
+  const confidence = num(node.confidence);
+  const score = num(node.retrieval_score);
+  const parenthetical = [
+    type,
+    confidence !== void 0 ? `confidence ${confidence}` : void 0,
+    score !== void 0 ? `score ${Math.round(score * 100) / 100}` : void 0
+  ].filter(Boolean).join(", ");
+  const head = `- **${label}** [${str(node.uid) || "?"}] (${parenthetical})${statusTag(node)}`;
+  const summary = nodeSummaryText(node, state);
+  const lines = [summary && summary !== label ? `${head}: ${summary}` : head];
+  const fields = layer7Fields(node, state);
+  if (fields) lines.push(`  - fields: ${fields}`);
+  const quote = firstQuote(node, state);
+  if (quote) lines.push(`  - source quote: "${quote}"`);
+  const source = sourceTag(node);
+  if (source) lines.push(`  - ${source}`);
+  const believers = Array.isArray(node.believed_by) ? node.believed_by : [];
+  if (believers.length > 0) {
+    const rendered2 = believers.slice(0, 3).map((raw) => {
+      const believer = obj(raw);
+      const conf = num(believer?.confidence);
+      return `${str(believer?.agent_label) || "?"}${conf !== void 0 ? ` (${conf})` : ""}`;
+    }).join(", ");
+    lines.push(`  - believed by: ${rendered2}`);
   }
+  return lines.join("\n");
 }
-async function attachCodeRefsToToolResult(client2, result, args, adapter) {
-  if (result.isError || !Array.isArray(args.code_refs) || args.code_refs.length === 0) {
-    return result;
+function groupedNodeSections(nodes, state, headingPrefix = "") {
+  const groups = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const type = nodeDisplayType(node);
+    const group = groups.get(type) ?? [];
+    group.push(node);
+    groups.set(type, group);
   }
-  const original = JSON.parse(result.content[0]?.text ?? "null");
-  const targetUids = primaryUids(original);
-  if (targetUids.length === 0) {
-    return ok({
-      result: original,
-      code_anchors: {
-        wrote: false,
-        caveat: "the write response exposed no primary UID to attach"
-      }
+  const sections = [];
+  let first = true;
+  for (const [type, group] of groups) {
+    sections.push({
+      heading: `${first ? headingPrefix : ""}### ${type}`,
+      items: group.map((node) => nodeLines(node, state))
     });
+    first = false;
   }
-  const anchorResult = await handleCodeTool(
-    client2,
-    {
-      action: "anchor",
-      code_refs: args.code_refs,
-      repo: args.repo,
-      repo_space_uid: args.repo_space_uid,
-      agent_id: args.agent_id,
-      // Keeps the default adapter anchored to the live session directory
-      // rather than wherever the MCP server process was launched.
-      invocation_context: args.invocation_context
-    },
-    adapter
-  );
-  const anchors = JSON.parse(anchorResult.content[0]?.text ?? "null");
-  if (!anchorResult.isError) {
-    const codeClient = client2;
-    const anchorUids = (anchors.anchors ?? []).flatMap(
-      (anchor) => anchor.uid ? [anchor.uid] : []
-    );
-    const relateFailures = [];
-    for (const targetUid of targetUids) {
-      for (const anchorUid of anchorUids) {
-        try {
-          await codeClient.entity({
-            action: "relate",
-            source_uid: targetUid,
-            target_uid: anchorUid,
-            edge_type: args.action === "lesson" ? "ABOUT" : "RELEVANT_TO",
-            agent_id: args.agent_id
-          });
-        } catch (cause) {
-          relateFailures.push(
-            `${targetUid} -> ${anchorUid}: ${errorDetail(cause)}`
-          );
-        }
+  return sections;
+}
+function relationshipItems(edges, labelByUid, state, options) {
+  const lines = [];
+  for (const raw of edges) {
+    const edge = obj(raw);
+    if (!edge) continue;
+    const type = edgeTypeName(edge.edge_type) || "?";
+    const from = str(edge.from_uid);
+    const to = str(edge.to_uid);
+    if (CURATION_EDGE_TYPES.has(type)) continue;
+    if (!from || !to || from === to) continue;
+    const fromLabel = labelByUid.get(from) ?? (options?.fallbackToUid ? `[${from}]` : void 0);
+    const toLabel = labelByUid.get(to) ?? (options?.fallbackToUid ? `[${to}]` : void 0);
+    if (!fromLabel || !toLabel) continue;
+    lines.push(`- ${fromLabel} \u2014${type}\u2192 ${toLabel}`);
+  }
+  if (lines.length > RELATIONSHIP_MAX) {
+    state.bounded = true;
+    const extra = lines.length - RELATIONSHIP_MAX;
+    state.omitted += extra;
+    return [...lines.slice(0, RELATIONSHIP_MAX), `- (+${extra} more relationships)`];
+  }
+  return lines;
+}
+function assemble(header, sections, state, maxChars) {
+  const budget = renderBudget(maxChars);
+  const packingBudget = Math.max(header.length, budget - BOUNDED_MARKER_RESERVE);
+  const lines = [header];
+  let used = header.length;
+  for (const section of sections) {
+    if (section.items.length === 0 && !section.heading) continue;
+    const headingCost = section.heading.length + 2;
+    if (used + headingCost > packingBudget) {
+      state.bounded = true;
+      state.omitted += Math.max(1, section.items.length);
+      continue;
+    }
+    let sectionUsed = 0;
+    const kept = [];
+    let dropped = 0;
+    for (const item of section.items) {
+      if (used + headingCost + sectionUsed + item.length + 1 > packingBudget) {
+        dropped += 1;
+        continue;
       }
+      kept.push(item);
+      sectionUsed += item.length + 1;
     }
-    if (relateFailures.length > 0) {
-      return ok({
-        result: original,
-        code_anchors: {
-          ...anchors,
-          caveat: `anchors written, but ${relateFailures.length} relate edge(s) failed: ${relateFailures.join("; ")}`
-        }
-      });
+    if (kept.length === 0 && section.items.length > 0) {
+      state.bounded = true;
+      state.omitted += dropped;
+      continue;
+    }
+    if (dropped > 0) {
+      state.bounded = true;
+      state.omitted += dropped;
+      const marker = `(+${dropped} more not shown)`;
+      if (used + headingCost + sectionUsed + marker.length + 1 <= packingBudget) {
+        kept.push(marker);
+        sectionUsed += marker.length + 1;
+      }
     }
+    lines.push(
+      section.items.length === 0 ? section.heading : section.heading ? `${section.heading}
+${kept.join("\n")}` : kept.join("\n")
+    );
+    used += headingCost + sectionUsed;
   }
-  return ok({ result: original, code_anchors: anchors });
+  if (state.bounded) {
+    lines.push(
+      `\u2026[rendered context bounded to ${budget} chars; ${state.omitted} item(s) omitted \u2014 fetch full node content by uid, narrow the query, raise max_output_chars, or pass format: "json" for the raw response]`
+    );
+  }
+  return lines.join("\n\n").slice(0, budget);
 }
-async function anchorRepository(client2, repository, spaceUid, agentId) {
-  return client2.entity({
-    action: "create",
-    label: repository.repoId,
-    props: {
-      entity_type: "repository",
-      canonical_name: repository.repoId,
-      identifiers: { repo_id: repository.repoId }
-    },
-    identity: {
-      namespace: "external.code",
-      key_version: 1,
-      key: repositoryIdentityKey(repository)
-    },
-    identity_space_uid: spaceUid,
-    agent_id: agentId
+function policySections(payload, state) {
+  const policies = Array.isArray(payload.applicable_policies) ? payload.applicable_policies : [];
+  if (policies.length === 0) return [];
+  const items = policies.map((raw) => obj(raw)).filter((policy) => Boolean(policy)).map((policy) => {
+    const rules = Array.isArray(policy.prose_rules) ? policy.prose_rules.map(String).join("; ") : policy.prose_rules;
+    return `- ${str(policy.name) || "(unnamed policy)"}: ${clip(rules, SUMMARY_MAX, state) || "(structured rules apply)"}`;
   });
+  return [{ heading: "## Applicable policies", items }];
 }
-async function anchorCodeRef(client2, ref, repositoryUid, spaceUid, agentId) {
-  const response = await client2.entity({
-    action: "create",
-    label: ref.qualifiedName,
-    props: {
-      entity_type: ref.kind === "file" ? "code_file" : "code_symbol",
-      canonical_name: ref.qualifiedName,
-      identifiers: {
-        repo_id: ref.repoId,
-        path: ref.path,
-        qualified_name: ref.qualifiedName
-      },
-      attributes: { code_ref: storedCodeRef(ref) }
-    },
-    identity: {
-      namespace: "external.code",
-      key_version: 1,
-      key: codeRefIdentityKey(ref)
-    },
-    identity_space_uid: spaceUid,
-    agent_id: agentId
-  });
-  if (response.uid && response.created !== false && response.status !== "existing") {
-    await client2.entity({
-      action: "relate",
-      source_uid: response.uid,
-      target_uid: repositoryUid,
-      edge_type: "PART_OF",
-      agent_id: agentId
-    });
-  }
-  return { ...response, ref };
-}
-async function resolveMaterializedUid(client2, ref, agentId) {
-  const response = await client2.entity({
-    action: "resolve_identity",
-    identity: {
-      namespace: "external.code",
-      key_version: 1,
-      key: codeRefIdentityKey(ref)
-    },
-    agent_id: agentId
-  });
-  return response.status === "existing" ? response.uid : void 0;
-}
-async function codeRefFromAnchor(client2, adapter, uid) {
-  const node = await client2.getNode(uid);
-  const attributes = node.props?.attributes;
-  if (!attributes || typeof attributes !== "object") return void 0;
-  const codeRef = attributes.code_ref;
-  if (!isStoredCodeRef(codeRef)) return void 0;
-  try {
-    const repository = await adapter.resolveRepository(codeRef.repoId);
-    return { ref: { ...codeRef, repoRoot: repository.repoRoot } };
-  } catch (cause) {
-    if (cause instanceof UnknownRepositoryError) {
-      return { missingRepo: codeRef.repoId };
+function hiddenSections(payload) {
+  const hidden = payload.hidden_item_count;
+  if (hidden === void 0 || hidden === null) return [];
+  return [
+    {
+      heading: `Note: ${hidden} item(s) were hidden by access scoping.`,
+      items: []
     }
-    throw cause;
-  }
+  ];
 }
-async function resolveSingleTarget(client2, adapter, refs, anchorUids, options) {
-  if (refs.length > 1 || anchorUids.length > 1) {
-    return { error: err("ambiguous_target", "expand/affected accepts exactly one code target") };
-  }
-  if (anchorUids.length === 1) {
-    const outcome = await codeRefFromAnchor(client2, adapter, anchorUids[0]);
-    if (!outcome) {
-      return { error: err("invalid_anchor", "anchor UID does not contain a typed code_ref") };
-    }
-    if ("missingRepo" in outcome) {
-      return {
-        error: err(
-          "repository_unavailable",
-          `repository ${outcome.missingRepo} is not checked out here or declared in .mindgraph/workspace.json; expand/affected need its local index`
-        )
-      };
+function renderContext(response, maxChars) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  if (typeof payload.context_text === "string" && payload.context_text.length > 0) {
+    const text2 = payload.context_text;
+    if (maxChars !== void 0 && text2.length > maxChars) {
+      return `${text2.slice(0, maxChars)}
+[truncated to ${maxChars} characters]`;
     }
-    return { ref: outcome.ref };
-  }
-  if (refs.length !== 1) {
-    return { error: err("missing_code_ref", "one code_ref or anchor_uid is required") };
-  }
-  const resolution = await adapter.resolveRefs(refs, options);
-  const result = resolution.results[0];
-  if (!result.resolved) {
-    return {
-      error: ok({
-        availability: resolution.availability,
-        result,
-        wrote: false
-      })
-    };
+    return text2;
   }
-  return { ref: result.resolved };
-}
-async function joinMaterialized(client2, refs, agentId, limit) {
-  const joined = [];
-  for (const ref of uniqueRefs(refs).slice(0, limit)) {
-    const uid = await resolveMaterializedUid(client2, ref, agentId);
-    if (!uid) continue;
-    joined.push({
-      ref,
-      anchor_uid: uid,
-      graph: await client2.traverse({
-        action: "neighborhood",
-        start_uid: uid,
-        depth: 2,
-        max_nodes: 20
-      })
+  const graph = obj(payload.graph);
+  const rawNodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
+  const shaped = rawNodes.filter(isNodeShaped);
+  const nodes = shaped.filter((node) => !INFRA_NODE_TYPES.has(str(node.node_type) || ""));
+  const infraOnly = shaped.length - nodes.length;
+  const articles = Array.isArray(payload.articles) ? payload.articles : [];
+  const chunks = Array.isArray(payload.chunks) ? payload.chunks : [];
+  const state = { bounded: false, omitted: 0 };
+  const sections = [];
+  if (articles.length > 0) {
+    sections.push({
+      heading: "## Knowledge articles",
+      items: articles.map((raw) => obj(raw)).filter((article) => Boolean(article)).map(
+        (article) => `### ${str(article.label) || "(untitled)"} [${str(article.uid) || "?"}]
+${clip(article.content, ARTICLE_MAX, state) || ""}`
+      )
     });
   }
-  return joined;
-}
-async function codeRefsFromGraphContext(client2, adapter, context) {
-  const uids = /* @__PURE__ */ new Set();
-  collectUids(context, uids);
-  if (uids.size === 0) return { refs: [], unavailable: [] };
-  const nodes = client2.getNodesBatch ? await client2.getNodesBatch([...uids]) : await Promise.all([...uids].map((uid) => client2.getNode(uid).catch(() => void 0)));
-  const stored = nodes.flatMap((node) => {
-    if (!node) return [];
-    const attributes = node.props?.attributes;
-    if (!attributes || typeof attributes !== "object") return [];
-    const codeRef = attributes.code_ref;
-    return isStoredCodeRef(codeRef) ? [codeRef] : [];
-  });
-  const refs = [];
-  const unavailable = /* @__PURE__ */ new Set();
-  for (const ref of stored) {
-    try {
-      const repository = await adapter.resolveRepository(ref.repoId);
-      refs.push({ ...ref, repoRoot: repository.repoRoot });
-    } catch (cause) {
-      if (cause instanceof UnknownRepositoryError) {
-        unavailable.add(ref.repoId);
-      } else {
-        throw cause;
-      }
+  if (nodes.length > 0) {
+    sections.push(...groupedNodeSections(nodes, state, "## Knowledge graph\n\n"));
+    const labelByUid = /* @__PURE__ */ new Map();
+    for (const node of nodes) labelByUid.set(str(node.uid), str(node.label) || "?");
+    const relationships = relationshipItems(
+      Array.isArray(graph?.edges) ? graph.edges : [],
+      labelByUid,
+      state
+    );
+    if (relationships.length > 0) {
+      sections.push({ heading: "## Relationships", items: relationships });
     }
+  } else if (infraOnly > 0) {
+    sections.push({
+      heading: `Note: ${infraOnly} document/chunk node(s) matched \u2014 use action "document_index" or include_chunks for their content.`,
+      items: []
+    });
   }
-  return { refs, unavailable: [...unavailable].sort() };
-}
-function collectUids(value, uids) {
-  if (Array.isArray(value)) {
-    value.forEach((item) => collectUids(item, uids));
-    return;
+  if (chunks.length > 0) {
+    sections.push({
+      heading: "## Source excerpts",
+      items: chunks.map((raw) => obj(raw)).filter((chunk) => Boolean(chunk)).map(
+        (chunk) => `- [${str(chunk.chunk_uid) || "?"}] from "${str(chunk.document_title) || "unknown document"}": "${clip(chunk.content, CHUNK_MAX, state) || ""}"`
+      )
+    });
   }
-  if (!value || typeof value !== "object") return;
-  for (const [key, child] of Object.entries(value)) {
-    if (typeof child === "string" && ["uid", "node_uid", "neighbor_uid", "from_uid", "to_uid"].includes(key)) {
-      uids.add(child);
-    } else {
-      collectUids(child, uids);
-    }
+  sections.push(...policySections(payload, state));
+  sections.push(...hiddenSections(payload));
+  if (sections.length === 0) {
+    return "No results found for this search.";
   }
+  if (nodes.length === 0 && articles.length === 0 && chunks.length === 0) {
+    return assemble(
+      "# Retrieved context\n\nNo graph results matched this search.",
+      sections,
+      state,
+      maxChars
+    );
+  }
+  return assemble("# Retrieved context", sections, state, maxChars);
 }
-function isStoredCodeRef(value) {
-  if (!value || typeof value !== "object") return false;
-  const ref = value;
-  return typeof ref.repoId === "string" && typeof ref.path === "string" && typeof ref.language === "string" && typeof ref.kind === "string" && typeof ref.qualifiedName === "string" && (typeof ref.signature === "string" || ref.signature === null) && typeof ref.startLine === "number" && typeof ref.endLine === "number";
-}
-function storedCodeRef(ref) {
-  const { repoRoot: _localOnly, ...stored } = ref;
-  return stored;
+function resumeEntry(raw, state, fallbackType) {
+  const wrapper = obj(raw);
+  if (!wrapper) return void 0;
+  const value = obj(wrapper.node) ?? wrapper;
+  if (isNodeShaped(value)) return nodeLines(value, state);
+  const uid = str(value.uid);
+  const props = obj(value.props);
+  const label = clip(value.label, LABEL_MAX, state) ?? clip(value.name, LABEL_MAX, state) ?? clip(value.title, LABEL_MAX, state) ?? clip(value.action, LABEL_MAX, state) ?? fallbackType;
+  const status = str(value.status) ?? str(props?.status);
+  const summary = clip(value.summary, SUMMARY_MAX, state) ?? clip(value.description, SUMMARY_MAX, state) ?? clip(value.content, SUMMARY_MAX, state) ?? clip(value.outcome_summary, SUMMARY_MAX, state) ?? clip(props?.summary, SUMMARY_MAX, state);
+  const details = [
+    status ? `status ${status}` : void 0,
+    str(value.path) ? `path ${str(value.path)}` : void 0,
+    str(value.symbol) ? `symbol ${str(value.symbol)}` : void 0
+  ].filter(Boolean);
+  const head = `- **${label}**${uid ? ` [${uid}]` : ""}${details.length > 0 ? ` (${details.join(", ")})` : ""}`;
+  return summary && summary !== label ? `${head}: ${summary}` : head;
 }
-function uniqueRefs(refs) {
-  const seen = /* @__PURE__ */ new Set();
-  return refs.filter((ref) => {
-    const key = `${ref.repoId}:${ref.path}:${ref.qualifiedName}:${ref.signature ?? ""}`;
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
+function resumeSection(heading, values, state, fallbackType) {
+  const items = values.map((value) => resumeEntry(value, state, fallbackType)).filter((value) => Boolean(value));
+  return items.length > 0 ? { heading, items } : void 0;
 }
-function primaryUids(value) {
-  if (!value || typeof value !== "object") return [];
-  const object2 = value;
-  const keys = [
-    "uid",
-    "claim_uid",
-    "goal_uid",
-    "project_uid",
-    "milestone_uid",
-    "decision_uid",
-    "task_uid",
-    "plan_uid",
-    "step_uid",
-    "execution_uid",
-    "lesson_uid"
-  ];
-  return [
-    ...new Set(
-      keys.flatMap((key) => typeof object2[key] === "string" ? [object2[key]] : [])
-    )
-  ];
-}
-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) }]
-    });
-    err = (code, message, details) => ({
-      content: [
-        {
-          type: "text",
-          text: JSON.stringify({ error: message, code, details })
-        }
-      ],
-      isError: true
+function renderResumeContext(response, maxChars, repositoryNames = {}) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const state = { bounded: false, omitted: 0 };
+  const status = str(payload.status);
+  if (!payload.task && status === "no_eligible_work") {
+    const scopedOut = typeof payload.scoped_out_tasks === "number" ? payload.scoped_out_tasks : 0;
+    const note = scopedOut > 0 ? ` ${scopedOut} task(s) exist outside the requested scope.` : "";
+    return assemble(
+      "# Resume context",
+      [{ heading: `No eligible work was found in the requested scope.${note}`, items: [] }],
+      state,
+      maxChars
+    );
+  }
+  const sections = [];
+  const push = (section) => {
+    if (section) sections.push(section);
+  };
+  push(resumeSection("## Current task", [payload.task], state, "Task"));
+  const other = otherEligibleWork(payload, repositoryNames);
+  if (other.shown > 0) {
+    sections.push({
+      heading: `## Other eligible work (${other.shown} shown${other.more > 0 ? `, ${other.more} more not listed` : ""})`,
+      items: other.groups.flatMap(
+        (group) => group.tasks.map(
+          (task) => `- ${group.repository}: ${task.label} [${task.uid}]${task.detail ? ` \u2014 ${task.detail}` : ""}`
+        )
+      )
     });
-    CODE_TOOL = {
-      name: "mindgraph_code",
-      description: "Resolve typed code references through the local codegraph index and join them to persistent MindGraph memory/work. anchor creates exact repository/code anchors; recall reads attached graph context; expand reads callers/callees; affected reads impact for a code ref or Task/Execution. Ambiguous refs return candidates without writing. Refs with a path route to the repository defining that file (nearest declared root in .mindgraph/workspace.json); bare symbols resolve against the current repository only \u2014 pass path or repo to target a sibling.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          action: {
-            type: "string",
-            enum: ["anchor", "recall", "expand", "affected"]
-          },
-          code_refs: {
-            type: "array",
-            maxItems: 50,
-            items: {
-              oneOf: [
-                { type: "string" },
-                {
-                  type: "object",
-                  properties: {
-                    repo: { type: "string" },
-                    path: { type: "string" },
-                    line: { type: "integer", minimum: 1 },
-                    symbol: { type: "string" },
-                    kind: { type: "string" },
-                    language: { type: "string" },
-                    signature: { type: "string" }
-                  },
-                  additionalProperties: false
-                }
-              ]
-            }
-          },
-          anchor_uids: {
-            type: "array",
-            maxItems: 50,
-            items: { type: "string" },
-            description: "Already-materialized code anchor UIDs (codegraph is not required for recall)"
-          },
-          repo: {
-            type: "string",
-            description: "Configured repository id or repository root"
-          },
-          repo_space_uid: {
-            type: "string",
-            description: "Writable shared Project/repository Space for new anchors (anchor requires this, a workspace space_uid, or MINDGRAPH_CODE_SPACE_UID)"
-          },
-          task_uid: { type: "string" },
-          execution_uid: { type: "string" },
-          limit: { type: "integer", minimum: 1, maximum: 50 },
-          agent_id: { type: "string" }
-        },
-        required: ["action"]
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: true
-      }
-    };
   }
-});
-
-// src/call-ledger.ts
-function callsDir(options) {
-  return import_node_path3.default.join(
-    options.runtimeDir || process.env.MINDGRAPH_RUNTIME_DIR || import_node_path3.default.join(import_node_os3.default.homedir(), ".mindgraph", "runtime"),
-    "calls"
+  push(
+    resumeSection(
+      "## Goal and project",
+      [payload.goal, payload.project].filter(Boolean),
+      state,
+      "Scope"
+    )
   );
-}
-function stableJson(value) {
-  if (Array.isArray(value)) return `[${value.map(stableJson).join(",")}]`;
-  if (value && typeof value === "object") {
-    return `{${Object.entries(value).filter(([, item]) => item !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`).join(",")}}`;
+  push(resumeSection("## Plan", [payload.plan], state, "Plan"));
+  push(
+    resumeSection(
+      "## Next steps",
+      Array.isArray(payload.next_steps) ? payload.next_steps : [],
+      state,
+      "Next step"
+    )
+  );
+  push(
+    resumeSection(
+      "## Blockers",
+      Array.isArray(payload.blockers) ? payload.blockers : [],
+      state,
+      "Blocker"
+    )
+  );
+  const knowledge = obj(payload.knowledge);
+  push(
+    resumeSection(
+      "## Relevant lessons and risks",
+      [
+        ...Array.isArray(knowledge?.lessons) ? knowledge.lessons : [],
+        ...Array.isArray(knowledge?.risks) ? knowledge.risks : []
+      ],
+      state,
+      "Knowledge"
+    )
+  );
+  push(
+    resumeSection(
+      "## Active execution",
+      [payload.active_execution].filter(Boolean),
+      state,
+      "Execution"
+    )
+  );
+  push(
+    resumeSection(
+      "## Recent executions",
+      Array.isArray(payload.recent_executions) ? payload.recent_executions : [],
+      state,
+      "Execution"
+    )
+  );
+  push(
+    resumeSection(
+      "## Code targets",
+      Array.isArray(payload.code_targets) ? payload.code_targets : [],
+      state,
+      "Code target"
+    )
+  );
+  push(resumeSection("## Lease", [payload.lease].filter(Boolean), state, "Lease"));
+  const warning = clip(payload.warning, SUMMARY_MAX, state);
+  if (warning) sections.push({ heading: "## Warning", items: [`- ${warning}`] });
+  const selectionReason = clip(payload.selection_reason, SUMMARY_MAX, state);
+  if (selectionReason) {
+    sections.push({ heading: "## Selection", items: [`- ${selectionReason}`] });
   }
-  return JSON.stringify(value) ?? "null";
-}
-function bareToolName(name) {
-  const cut = name.lastIndexOf("__");
-  return cut === -1 ? name : name.slice(cut + 2);
-}
-function callKey(toolName, toolInput) {
-  return import_node_crypto4.default.createHash("sha256").update(`${bareToolName(toolName)}\0${stableJson(toolInput)}`).digest("hex");
-}
-function sessionKey(sessionId) {
-  return import_node_crypto4.default.createHash("sha256").update(sessionId).digest("hex").slice(0, 16);
+  if (sections.length === 0) return void 0;
+  return assemble("# Resume context", sections, state, maxChars);
 }
-function prune(dir, now) {
-  let names;
-  try {
-    names = import_node_fs3.default.readdirSync(dir);
-  } catch {
-    return;
-  }
-  for (const name of names) {
-    const file = import_node_path3.default.join(dir, name);
-    try {
-      if (now - import_node_fs3.default.statSync(file).mtimeMs > TTL_MS) import_node_fs3.default.unlinkSync(file);
-    } catch {
-    }
+function otherEligibleWork(brief, names = {}) {
+  const listed = Array.isArray(brief?.other_eligible) ? brief.other_eligible : [];
+  const groups = [];
+  let shown = 0;
+  for (const entry of listed) {
+    const task = obj(entry);
+    const uid = typeof task?.uid === "string" ? task.uid : void 0;
+    if (!task || !uid) continue;
+    const scopes = Array.isArray(task.scope_uids) ? task.scope_uids.map(String) : [];
+    const named = scopes.find((scope) => names[scope]);
+    const repository = named ? names[named] : "Other scopes";
+    let group = groups.find((candidate) => candidate.repository === repository);
+    if (!group) {
+      group = { repository, tasks: [] };
+      groups.push(group);
+    }
+    const label = typeof task.label === "string" && task.label ? task.label : "(unlabeled)";
+    const detail = [
+      typeof task.status === "string" ? task.status : void 0,
+      typeof task.priority === "string" && task.priority ? `priority ${task.priority}` : void 0
+    ].filter(Boolean).join(", ");
+    group.tasks.push({
+      uid,
+      label: label.length > 160 ? `${label.slice(0, 159)}\u2026` : label,
+      detail
+    });
+    shown += 1;
   }
+  const total = typeof brief?.eligible_total === "number" ? brief.eligible_total : 0;
+  return { groups, shown, more: Math.max(0, total - 1 - shown) };
 }
-function recordPendingCall(toolName, toolInput, harnessSessionId, fills, options = {}) {
-  const now = (options.now ?? Date.now)();
-  const dir = callsDir(options);
-  try {
-    import_node_fs3.default.mkdirSync(dir, { recursive: true, mode: 448 });
-    prune(dir, now);
-    const record = {
-      harnessSessionId,
-      projectDir: options.projectDir ?? process.env.CLAUDE_PROJECT_DIR,
-      fills,
-      createdAt: now
-    };
-    const file = import_node_path3.default.join(
-      dir,
-      `${callKey(toolName, toolInput)}.${sessionKey(harnessSessionId)}.json`
-    );
-    const temporary = `${file}.${process.pid}.${import_node_crypto4.default.randomUUID()}.tmp`;
-    import_node_fs3.default.writeFileSync(temporary, JSON.stringify(record), { mode: 384 });
-    import_node_fs3.default.renameSync(temporary, file);
-  } catch {
+function renderOtherEligibleWork(brief, names = {}) {
+  const { groups, shown, more } = otherEligibleWork(brief, names);
+  if (shown === 0) return void 0;
+  const lines = [
+    `Other eligible work in this scope (${shown} shown${more > 0 ? `, ${more} more not listed` : ""}; resume one by task_uid):`
+  ];
+  for (const group of groups) {
+    lines.push(`${group.repository}:`);
+    for (const task of group.tasks) {
+      lines.push(`- ${task.label} [${task.uid}]${task.detail ? ` \u2014 ${task.detail}` : ""}`);
+    }
   }
+  return lines.join("\n");
 }
-function resolvePendingCall(toolName, toolInput, options = {}) {
-  const now = (options.now ?? Date.now)();
-  const dir = callsDir(options);
-  const prefix = `${callKey(toolName, toolInput)}.`;
-  let names;
-  try {
-    names = import_node_fs3.default.readdirSync(dir).filter((name) => name.startsWith(prefix) && name.endsWith(".json"));
-  } catch {
-    return void 0;
-  }
-  let matches = [];
-  for (const name of names) {
-    try {
-      const record = JSON.parse(
-        import_node_fs3.default.readFileSync(import_node_path3.default.join(dir, name), "utf8")
-      );
-      if (typeof record.createdAt === "number" && now - record.createdAt <= TTL_MS && record.fills && typeof record.fills === "object") {
-        matches.push(record);
+function renderNodeList(response, title, limit, maxChars) {
+  let candidates = [];
+  if (Array.isArray(response)) {
+    candidates = response;
+  } else {
+    const payload = obj(response);
+    if (!payload) return void 0;
+    for (const key of ["nodes", "results", "items", "goals", "questions", "claims", "preferences", "documents"]) {
+      const candidate = payload[key];
+      if (Array.isArray(candidate) && candidate.some((entry) => unwrapSearchResult(entry))) {
+        candidates = candidate;
+        break;
       }
-    } catch {
     }
   }
-  if (matches.length > 1) {
-    const projectDir = options.projectDir ?? process.env.CLAUDE_PROJECT_DIR;
-    matches = projectDir ? matches.filter((record) => record.projectDir === projectDir) : [];
+  let nodes = candidates.map(unwrapSearchResult).filter((node) => Boolean(node));
+  if (nodes.length === 0) return void 0;
+  const total = nodes.length;
+  const state = { bounded: false, omitted: 0 };
+  if (limit !== void 0 && limit > 0 && nodes.length > limit) {
+    state.omitted += nodes.length - limit;
+    nodes = nodes.slice(0, limit);
+    state.bounded = true;
   }
-  return matches.length === 1 ? matches[0].fills : void 0;
-}
-var import_node_crypto4, import_node_fs3, import_node_os3, import_node_path3, TTL_MS;
-var init_call_ledger = __esm({
-  "src/call-ledger.ts"() {
-    "use strict";
-    import_node_crypto4 = __toESM(require("crypto"));
-    import_node_fs3 = __toESM(require("fs"));
-    import_node_os3 = __toESM(require("os"));
-    import_node_path3 = __toESM(require("path"));
-    TTL_MS = 10 * 6e4;
-  }
-});
-
-// src/hook-installer.ts
-function storedFeatures(homeDir) {
-  const { promptRecall: promptRecall2, capture } = loadHookEnv(
-    import_node_path5.default.join(homeDir || import_node_os5.default.homedir(), ".mindgraph")
+  const sections = groupedNodeSections(nodes, state);
+  const shown = nodes.length;
+  return assemble(
+    `# ${title} (${shown === total ? total : `${shown} of ${total}`})`,
+    sections,
+    state,
+    maxChars
   );
-  return { promptRecall: promptRecall2, capture };
-}
-function command(harness) {
-  return `node "$HOME/${RUNNER_RELATIVE}" hook --harness ${harness} --owner mindgraph`;
-}
-function windowsCommand(harness) {
-  return `node "%USERPROFILE%\\.mindgraph\\bin\\mindgraph-hook.cjs" hook --harness ${harness} --owner mindgraph`;
 }
-function installHookRunner(sourceFile, homeDir, version) {
-  const target = import_node_path5.default.join(homeDir || import_node_os5.default.homedir(), RUNNER_RELATIVE);
-  import_node_fs6.default.mkdirSync(import_node_path5.default.dirname(target), { recursive: true });
-  const temporary = `${target}.${process.pid}.${import_node_crypto6.default.randomUUID()}.tmp`;
-  import_node_fs6.default.copyFileSync(sourceFile, temporary);
-  import_node_fs6.default.renameSync(temporary, target);
-  const versionPath = import_node_path5.default.join(homeDir || import_node_os5.default.homedir(), RUNNER_VERSION_RELATIVE);
-  if (version) {
-    import_node_fs6.default.writeFileSync(versionPath, `${version}
-`);
-  } else {
-    import_node_fs6.default.rmSync(versionPath, { force: true });
+function renderTraversal(response, maxChars) {
+  const directSteps = Array.isArray(response) ? response : void 0;
+  const payload = obj(response);
+  if (!payload && !directSteps) return void 0;
+  const body = payload ?? {};
+  const container = obj(body.graph) ?? body;
+  const rawNodes = Array.isArray(container.nodes) ? container.nodes : [];
+  const nodes = rawNodes.filter(isNodeShaped);
+  const paths = Array.isArray(body.paths) ? body.paths : [];
+  const hasSteps = directSteps !== void 0 || Object.hasOwn(body, "steps");
+  const rawSteps = directSteps ?? (Array.isArray(body.steps) ? body.steps : []);
+  if (nodes.length === 0 && paths.length === 0 && !hasSteps) return void 0;
+  const state = { bounded: false, omitted: 0 };
+  const sections = [];
+  const labelByUid = /* @__PURE__ */ new Map();
+  for (const node of nodes) labelByUid.set(str(node.uid), str(node.label) || "?");
+  if (paths.length > 0) {
+    const items = paths.map((raw) => obj(raw)).filter((path10) => Boolean(path10)).map((path10, index) => {
+      const uids = Array.isArray(path10.node_uids) ? path10.node_uids.map(String) : [];
+      const labels = Array.isArray(path10.labels) ? path10.labels.map(String) : Array.isArray(path10.nodes) ? path10.nodes.map((hop) => {
+        const hopNode = obj(hop);
+        return str(hopNode?.label) || labelByUid.get(str(hopNode?.uid) || "") || str(hop) || "?";
+      }) : [];
+      const route = labels.length > 0 ? labels.join(" \u2192 ") : uids.join(" \u2192 ") || "(path)";
+      const cost = num(path10.cost) ?? num(path10.path_cost);
+      const confidence = num(path10.path_confidence);
+      const meta = [
+        cost !== void 0 ? `cost ${cost}` : void 0,
+        confidence !== void 0 ? `confidence ${confidence}` : void 0
+      ].filter(Boolean);
+      const head = `${index + 1}. ${route}${meta.length > 0 ? ` (${meta.join(", ")})` : ""}`;
+      return labels.length > 0 && uids.length > 0 ? `${head}
+   uids: ${uids.join(" \u2192 ")}` : head;
+    });
+    sections.push({ heading: "## Paths", items });
   }
-  return target;
-}
-function installedHookRunnerVersion(homeDir) {
-  try {
-    const raw = import_node_fs6.default.readFileSync(
-      import_node_path5.default.join(homeDir || import_node_os5.default.homedir(), RUNNER_VERSION_RELATIVE),
-      "utf8"
-    ).trim();
-    return raw || void 0;
-  } catch {
-    return void 0;
+  if (hasSteps) {
+    const stepItems = rawSteps.map((raw) => obj(raw)).filter((step) => Boolean(step)).map((step) => {
+      const depth = num(step.depth);
+      const uid = str(step.node_uid) ?? str(step.uid) ?? str(step.edge_to_uid) ?? "?";
+      const parent = str(step.parent_uid) ?? str(step.edge_from_uid);
+      const label = str(step.label) || "(unlabeled)";
+      const relation = edgeTypeName(step.edge_type);
+      const role = str(step.traversal_role);
+      const type = str(step.node_type) ?? str(obj(step.node_type)?.Custom);
+      const cost = num(step.path_cost);
+      const confidence = num(step.path_confidence);
+      const prefix = [
+        depth !== void 0 ? `depth ${depth}` : void 0,
+        role,
+        relation ? `\u2014${relation}\u2192` : void 0
+      ].filter(Boolean).join(" ");
+      const meta = [
+        type,
+        parent ? `parent ${parent}` : void 0,
+        cost !== void 0 ? `cost ${cost}` : void 0,
+        confidence !== void 0 ? `confidence ${confidence}` : void 0
+      ].filter(Boolean).join(", ");
+      return `- ${prefix ? `${prefix}: ` : ""}**${label}** [${uid}]${meta ? ` (${meta})` : ""}`;
+    });
+    if (stepItems.length > 0) {
+      sections.push({ heading: "## Traversal steps", items: stepItems });
+    } else {
+      const start = str(body.start_uid) || "?";
+      const end = str(body.end_uid);
+      const mode2 = str(body.mode);
+      sections.push({
+        heading: mode2 === "path" && end ? `No path found from [${start}] to [${end}].` : `No traversal steps returned from [${start}].`,
+        items: []
+      });
+    }
+  }
+  if (nodes.length > 0) {
+    sections.push(...groupedNodeSections(nodes, state, "## Nodes\n\n"));
+    const relationships = relationshipItems(
+      Array.isArray(container.edges) ? container.edges : [],
+      labelByUid,
+      state
+    );
+    if (relationships.length > 0) {
+      sections.push({ heading: "## Relationships", items: relationships });
+    }
   }
+  const mode = str(body.mode);
+  return assemble(
+    `# Graph traversal${mode ? ` (${mode})` : ""}`,
+    sections,
+    state,
+    maxChars
+  );
 }
-function parseSemver(value) {
-  if (!value) return void 0;
-  const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value.trim());
-  if (!match) return void 0;
-  return [Number(match[1]), Number(match[2]), Number(match[3])];
+function neighborLine(value) {
+  const node = obj(value);
+  if (!node) return void 0;
+  const label = str(node.label) || "(unlabeled)";
+  const uid = str(node.uid);
+  const type = str(node.node_type);
+  return `- ${label}${uid ? ` [${uid}]` : ""}${type ? ` (${type})` : ""}`;
 }
-function semverNewer(a, b) {
-  for (let index = 0; index < 3; index += 1) {
-    if (a[index] !== b[index]) return a[index] > b[index];
+function renderOntologyAnswer(response) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const objects = Array.isArray(payload.objects) ? payload.objects.filter(isNodeShaped) : isNodeShaped(payload.object) ? [payload.object] : [];
+  const cognitive = obj(payload.cognitive_context);
+  const provenance = Array.isArray(payload.provenance) ? payload.provenance : [];
+  const hasQuerySignature = Array.isArray(payload.objects) || obj(payload.confidence) !== void 0;
+  const cognitiveEmpty = !cognitive || Object.values(cognitive).every((v) => !Array.isArray(v) || v.length === 0);
+  if (objects.length === 0 && cognitiveEmpty && provenance.length === 0) {
+    return hasQuerySignature ? "No matching domain objects." : void 0;
   }
-  return false;
-}
-function refreshHookRunner(serverVersion, sourceBundle, homeDir) {
-  try {
-    if (process.env.MINDGRAPH_HOOK_AUTOUPDATE === "off") {
-      return { refreshed: false, reason: "disabled" };
-    }
-    const home = homeDir || import_node_os5.default.homedir();
-    if (!import_node_fs6.default.existsSync(import_node_path5.default.join(home, RUNNER_RELATIVE))) {
-      return { refreshed: false, reason: "no_runner" };
-    }
-    if (!import_node_fs6.default.existsSync(sourceBundle)) {
-      return { refreshed: false, reason: "no_source" };
-    }
-    const server2 = parseSemver(serverVersion);
-    if (!server2) return { refreshed: false, reason: "unparseable" };
-    const runnerVersion = installedHookRunnerVersion(home);
-    if (runnerVersion !== void 0) {
-      const pinned = parseSemver(runnerVersion);
-      if (!pinned) {
-        return { refreshed: false, reason: "unparseable", runnerVersion };
-      }
-      if (!semverNewer(server2, pinned)) {
-        return {
-          refreshed: false,
-          reason: runnerVersion === serverVersion ? "current" : "downgrade",
-          runnerVersion
-        };
+  const state = { bounded: false, omitted: 0 };
+  const sections = [];
+  if (objects.length > 0) {
+    sections.push(...groupedNodeSections(objects, state));
+  }
+  const labelByUid = /* @__PURE__ */ new Map();
+  for (const node of objects) labelByUid.set(str(node.uid), str(node.label) || "?");
+  const graph = obj(payload.graph);
+  for (const raw of Array.isArray(graph?.nodes) ? graph.nodes : []) {
+    const node = obj(raw);
+    const uid = str(node?.uid);
+    if (uid && !labelByUid.has(uid)) labelByUid.set(uid, str(node?.label) || "?");
+  }
+  if (cognitive) {
+    for (const rawNodes of Object.values(cognitive)) {
+      if (!Array.isArray(rawNodes)) continue;
+      for (const raw of rawNodes) {
+        const node = obj(raw);
+        const uid = str(node?.uid);
+        if (uid && !labelByUid.has(uid)) labelByUid.set(uid, str(node?.label) || "?");
       }
     }
-    installHookRunner(sourceBundle, home, serverVersion);
-    return { refreshed: true, reason: "updated", runnerVersion };
-  } catch {
-    return { refreshed: false, reason: "error" };
   }
-}
-function refreshOwnedClaudeHooks(projectDir = process.cwd(), homeDir) {
-  const refreshed = [];
-  const scopes = ["user", "project"];
-  for (const scope of scopes) {
-    try {
-      const file = settingsPath("claude-code", scope, projectDir, void 0, homeDir);
-      if (!import_node_fs6.default.existsSync(file)) continue;
-      if (!import_node_fs6.default.readFileSync(file, "utf8").includes(OWNER_MARKER)) continue;
-      installHooks(
-        "claude-code",
-        scope,
-        projectDir,
-        void 0,
-        homeDir,
-        storedFeatures(homeDir)
-      );
-      refreshed.push(file);
-    } catch {
+  const relations = Array.isArray(payload.relations) ? payload.relations : [];
+  const relationLines = relationshipItems(relations, labelByUid, state, { fallbackToUid: true });
+  if (relationLines.length > 0) {
+    sections.push({ heading: "## Relations", items: relationLines });
+  }
+  if (cognitive) {
+    for (const [category, rawNodes] of Object.entries(cognitive)) {
+      if (!Array.isArray(rawNodes) || rawNodes.length === 0) continue;
+      const items = rawNodes.map(neighborLine).filter((line) => Boolean(line));
+      if (items.length > 0) {
+        sections.push({ heading: `### Cognitive context \u2014 ${category}`, items });
+      }
     }
   }
-  return refreshed;
-}
-function versionSkewNote(serverVersion, homeDir) {
-  const runnerVersion = installedHookRunnerVersion(homeDir);
-  if (!runnerVersion || runnerVersion === serverVersion) return void 0;
-  return `NOTE: the installed MindGraph hook runner is v${runnerVersion} but this MCP server is v${serverVersion} \u2014 hook behavior and tool contracts may be out of sync. Tell the user to run: npx -y mindgraph-mcp@latest install-hooks (refreshes the pinned runner).`;
-}
-function settingsPath(harness, scope, projectDir = process.cwd(), codexHomeDir = process.env.CODEX_HOME || import_node_path5.default.join(import_node_os5.default.homedir(), ".codex"), homeDir) {
-  if (harness === "codex") {
-    return scope === "user" ? import_node_path5.default.join(codexHomeDir, "hooks.json") : import_node_path5.default.join(projectDir, ".codex", "hooks.json");
+  if (provenance.length > 0) {
+    const items = provenance.map((raw) => obj(raw)).filter((entry) => Boolean(entry)).map((entry) => {
+      const span = clip(entry.text_span, QUOTE_MAX, state) || "";
+      const by = str(entry.ingested_by_name);
+      const suffix = `${by ? ` (ingested by ${by})` : ""} [source ${str(entry.source_uid) || "?"}]`;
+      return str(entry.span_kind) === "anchor" ? `- "${span}"${suffix}` : `- context: ${span}${suffix}`;
+    });
+    sections.push({ heading: "## Sources", items });
   }
-  return scope === "user" ? import_node_path5.default.join(homeDir || import_node_os5.default.homedir(), ".claude", "settings.json") : import_node_path5.default.join(projectDir, ".claude", "settings.json");
+  const confidence = num(obj(payload.confidence)?.overall);
+  const notes = [];
+  if (confidence !== void 0) notes.push(`overall confidence ${confidence}`);
+  if (payload.has_more === true) notes.push("more results exist (has_more)");
+  if (payload.seed_cap_hit === true) notes.push("seed cap hit \u2014 narrow the query for a complete set");
+  if (notes.length > 0) sections.push({ heading: `Note: ${notes.join("; ")}.`, items: [] });
+  return assemble(
+    `# Ontology results (${objects.length} object${objects.length === 1 ? "" : "s"})`,
+    sections,
+    state
+  );
 }
-function readSettings(file) {
-  if (!import_node_fs6.default.existsSync(file)) return {};
-  return JSON.parse(import_node_fs6.default.readFileSync(file, "utf8"));
+function renderObjectList(response, title) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const rawItems = Array.isArray(payload.items) ? payload.items : Array.isArray(payload.rows) && payload.rows.some((row) => unwrapSearchResult(row)) ? payload.rows : void 0;
+  const items = (rawItems ?? []).map(unwrapSearchResult).filter((node) => Boolean(node));
+  if (items.length === 0) {
+    return rawItems ? `# ${title} (0 results)` : void 0;
+  }
+  const state = { bounded: false, omitted: 0 };
+  const sections = groupedNodeSections(items, state);
+  const total = num(payload.total_count);
+  const truncations = Array.isArray(payload.truncation_reasons) ? payload.truncation_reasons.filter((reason) => typeof reason === "string") : [];
+  const notes = [];
+  if (payload.has_more === true) notes.push("more results exist");
+  if (truncations.length > 0) notes.push(`truncated: ${truncations.join(", ")}`);
+  if (notes.length > 0) sections.push({ heading: `Note: ${notes.join("; ")}.`, items: [] });
+  const count = total !== void 0 && total !== items.length ? `${items.length} of ${total}` : `${items.length}`;
+  return assemble(`# ${title} (${count})`, sections, state);
 }
-function ownedHook(harness, timeout, additionalContextLimit) {
-  return {
-    type: "command",
-    command: command(harness),
-    ...harness === "codex" ? { commandWindows: windowsCommand(harness) } : {},
-    timeout,
-    statusMessage: "Syncing MindGraph session context",
-    ...additionalContextLimit === void 0 ? {} : { additionalContextLimit }
-  };
-}
-function desiredEntries(harness, features = {}) {
-  const common = {
-    SessionStart: [
-      {
-        matcher: harness === "claude-code" ? "startup|resume|clear|compact|fork" : "startup|resume|clear|compact",
-        // B7 live acceptance caught cold SessionStart calls crossing the
-        // inherited 20s edge in both harnesses: the hooks correctly failed
-        // open, but no brief reached the model. The same installed runner
-        // completed in 16.84s once warm. Keep a 30s cold-tenant margin.
-        // The declared Codex context limit must not undercut the brief's own
-        // 9,000-char budget: at 3,000 the harness applied a SECOND, tighter
-        // truncation the renderer knew nothing about.
-        hooks: [
-          ownedHook(
-            harness,
-            30,
-            harness === "codex" ? 1e4 : void 0
-          )
-        ]
-      }
-    ],
-    PreToolUse: [
-      {
-        matcher: "mcp__mindgraph__.*",
-        // Repository resolution over a large multi-repo workspace plus three
-        // git probes can exceed 3s on the first (uncached) call; a killed
-        // PreToolUse means the call goes through untagged.
-        hooks: [ownedHook(harness, 5)]
-      }
-    ],
-    // PostToolUse awaits the lease renewal round-trip, which fires exactly
-    // when the tenant is cold (post-idle reclaim) — 5s killed it mid-claim.
-    // Claude Code: only the tools the hook acts on (MindGraph calls, edits,
-    // and the shell/agent calls that keep a lease alive). Read, Grep and Glob
-    // are most of a session's tool calls and the hook did nothing useful for
-    // them but start a process (roadmap H8). Codex names its tools
-    // differently, so it keeps the catch-all.
-    PostToolUse: [
-      {
-        matcher: harness === "claude-code" ? CLAUDE_POST_TOOL_MATCHER : ".*",
-        hooks: [ownedHook(harness, 10)]
-      }
-    ],
-    Stop: [{ hooks: [ownedHook(harness, 5)] }],
-    // SessionEnd makes up to two sequential cloud calls (abandon_iteration +
-    // session close) — the SAME cold-tenant latency SessionStart needs 30s
-    // for. Claude honors the configured budget; Codex clamps SessionEnd to a
-    // 3s platform cap regardless of this value (see codex-hooks.ts wire
-    // map), so the codex adapter instead makes at most ONE call there.
-    SessionEnd: [
-      { hooks: [ownedHook(harness, harness === "codex" ? 3 : 30)] }
-    ]
-  };
-  if (harness !== "claude-code") return common;
-  return {
-    ...common,
-    TaskCreated: [{ hooks: [ownedHook(harness, 3)] }],
-    TaskCompleted: [{ hooks: [ownedHook(harness, 3)] }],
-    // Bounded recall per prompt: the core gives up at 4s and fails open, so
-    // a 5s budget never holds the prompt longer than that.
-    ...features.promptRecall !== false ? { UserPromptSubmit: [{ hooks: [ownedHook(harness, 5)] }] } : {},
-    // Opt-in transcript capture before compaction (cold-tenant ingest).
-    ...features.capture === true ? { PreCompact: [{ hooks: [ownedHook(harness, 30)] }] } : {}
-  };
-}
-function hookCommand(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-  const command2 = value.command;
-  return typeof command2 === "string" ? command2 : void 0;
-}
-function entryHasOwnedHook(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  const hooks = value.hooks;
-  return Array.isArray(hooks) && hooks.some((hook) => hookCommand(hook)?.includes(OWNER_MARKER));
-}
-function writeSettings(file, settings) {
-  import_node_fs6.default.mkdirSync(import_node_path5.default.dirname(file), { recursive: true });
-  const temporary = `${file}.${process.pid}.${import_node_crypto6.default.randomUUID()}.tmp`;
-  import_node_fs6.default.writeFileSync(temporary, `${JSON.stringify(settings, null, 2)}
-`, {
-    mode: 384
+function renderJobs(response) {
+  const jobs = Array.isArray(response) ? response : obj(response)?.jobs;
+  if (!Array.isArray(jobs)) return void 0;
+  if (jobs.length === 0) return "No ingestion jobs.";
+  const state = { bounded: false, omitted: 0 };
+  const sorted = jobs.map((raw) => obj(raw)).filter((job) => Boolean(job)).sort((a, b) => (num(b.created_at) ?? 0) - (num(a.created_at) ?? 0));
+  const shown = sorted.slice(0, JOBS_RENDER_MAX);
+  if (shown.length < sorted.length) state.bounded = true;
+  const items = shown.map((job) => {
+    const progress = obj(job.progress);
+    const failure = obj(job.error_details);
+    const message = str(failure?.message) ?? str(job.error);
+    const done = num(progress?.processed_chunks);
+    const totalChunks = num(progress?.total_chunks);
+    const bits = [
+      str(job.status) || "?",
+      done !== void 0 && totalChunks !== void 0 ? `${done}/${totalChunks} chunks` : void 0,
+      num(progress?.nodes_created) !== void 0 ? `${num(progress?.nodes_created)} nodes` : void 0,
+      num(job.queue_position) !== void 0 ? `queue #${num(job.queue_position)}` : void 0,
+      message ? `error: ${clip(message, 160, state)}` : void 0,
+      str(failure?.code) ? `code: ${clip(failure?.code, 80, state)}` : void 0,
+      num(failure?.status) !== void 0 ? `status: ${num(failure?.status)}` : void 0,
+      typeof failure?.retriable === "boolean" ? `retriable: ${failure.retriable}` : void 0
+    ].filter(Boolean);
+    return `- [${str(job.id) || "?"}] ${clip(job.title, 120, state) || "(untitled)"} \u2014 ${bits.join(", ")}`;
   });
-  import_node_fs6.default.renameSync(temporary, file);
-}
-function installHooks(harness, scope, projectDir = process.cwd(), codexHomeDir, homeDir, features = {}) {
-  const file = settingsPath(harness, scope, projectDir, codexHomeDir, homeDir);
-  const settings = readSettings(file);
-  const hooks = settings.hooks && typeof settings.hooks === "object" && !Array.isArray(settings.hooks) ? settings.hooks : {};
-  let added = 0;
-  let updated = 0;
-  const desired = desiredEntries(harness, features);
-  for (const optional of ["UserPromptSubmit", "PreCompact"]) {
-    if (optional in desired || !Array.isArray(hooks[optional])) continue;
-    const kept = hooks[optional].filter(
-      (entry) => !entryHasOwnedHook(entry)
-    );
-    if (kept.length > 0) hooks[optional] = kept;
-    else delete hooks[optional];
-  }
-  for (const [event, wanted] of Object.entries(desired)) {
-    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) {
-      kept.push(entry);
-      if (hadOwned) updated += 1;
-      else added += 1;
-    }
-    hooks[event] = kept;
-  }
-  settings.hooks = hooks;
-  writeSettings(file, settings);
-  return { path: file, added, updated };
+  return assemble(
+    `# Ingestion jobs (${shown.length}${shown.length < sorted.length ? ` of ${sorted.length}` : ""})`,
+    [{ heading: "", items }],
+    state
+  );
 }
-function uninstallHooks(harness, scope, projectDir = process.cwd(), codexHomeDir) {
-  const file = settingsPath(harness, scope, projectDir, codexHomeDir);
-  if (!import_node_fs6.default.existsSync(file)) return { path: file, removed: 0 };
-  const settings = readSettings(file);
-  const hooks = settings.hooks && typeof settings.hooks === "object" && !Array.isArray(settings.hooks) ? settings.hooks : {};
-  let removed = 0;
-  for (const [event, value] of Object.entries(hooks)) {
-    if (!Array.isArray(value)) continue;
-    const retainedEntries = [];
-    for (const rawEntry of value) {
-      if (!rawEntry || typeof rawEntry !== "object" || Array.isArray(rawEntry)) {
-        retainedEntries.push(rawEntry);
-        continue;
-      }
-      const entry = { ...rawEntry };
-      if (!Array.isArray(entry.hooks)) {
-        retainedEntries.push(entry);
-        continue;
-      }
-      const retainedHooks = entry.hooks.filter((hook) => {
-        const owned = hookCommand(hook)?.includes(OWNER_MARKER) || false;
-        if (owned) removed += 1;
-        return !owned;
-      });
-      if (retainedHooks.length > 0) {
-        entry.hooks = retainedHooks;
-        retainedEntries.push(entry);
-      }
+function renderSignals(response) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const state = { bounded: false, omitted: 0 };
+  const sections = [];
+  for (const [key, value] of Object.entries(payload)) {
+    if (!Array.isArray(value) || value.length === 0) continue;
+    const items = value.map((raw) => obj(raw)).filter((item) => Boolean(item)).map((item) => {
+      const fromLabel = str(item.from_label);
+      const toLabel = str(item.to_label);
+      const anyLabelKey = Object.keys(item).find(
+        (k) => k.endsWith("_label") && str(item[k])
+      );
+      const label = str(item.label) ?? str(item.title) ?? str(item.name) ?? (fromLabel && toLabel ? `${fromLabel} \u2194 ${toLabel}` : void 0) ?? (anyLabelKey ? str(item[anyLabelKey]) : void 0) ?? str(item.uid) ?? str(item.target_uid) ?? "(item)";
+      const uid = str(item.uid) ?? str(item.target_uid);
+      const numbers = Object.entries(item).filter(([, v]) => typeof v === "number").slice(0, 4).map(([k, v]) => `${k} ${Math.round(v * 100) / 100}`);
+      const lists = Object.entries(item).filter(([, v]) => Array.isArray(v) && v.length > 0).slice(0, 2).map(([k, v]) => `${k}: ${v.length}`);
+      const meta = [...numbers, ...lists].join(", ");
+      return `- ${clip(label, 160, state)}${uid && uid !== label ? ` [${uid}]` : ""}${meta ? ` (${meta})` : ""}`;
+    });
+    if (items.length > 0) {
+      sections.push({ heading: `## ${key.replace(/_/g, " ")}`, items });
     }
-    if (retainedEntries.length > 0) hooks[event] = retainedEntries;
-    else delete hooks[event];
   }
-  settings.hooks = hooks;
-  writeSettings(file, settings);
-  return { path: file, removed };
-}
-function installClaudeHooks(scope, projectDir = process.cwd(), features = {}) {
-  return installHooks("claude-code", scope, projectDir, void 0, void 0, features);
-}
-function uninstallClaudeHooks(scope, projectDir = process.cwd()) {
-  return uninstallHooks("claude-code", scope, projectDir);
-}
-function installCodexHooks(scope, projectDir = process.cwd(), codexHomeDir) {
-  return installHooks("codex", scope, projectDir, codexHomeDir);
-}
-function uninstallCodexHooks(scope, projectDir = process.cwd(), codexHomeDir) {
-  return uninstallHooks("codex", scope, projectDir, codexHomeDir);
+  if (sections.length === 0) return void 0;
+  return assemble("# Synthesis signals", sections, state);
 }
-var import_node_fs6, import_node_os5, import_node_path5, import_node_crypto6, OWNER_MARKER, RUNNER_RELATIVE, RUNNER_VERSION_RELATIVE, CLAUDE_POST_TOOL_MATCHER;
-var init_hook_installer = __esm({
-  "src/hook-installer.ts"() {
+var LABEL_MAX, SUMMARY_MAX, QUOTE_MAX, ARTICLE_MAX, CHUNK_MAX, RELATIONSHIP_MAX, RENDER_CHAR_BUDGET, MIN_RENDER_CHAR_BUDGET, BOUNDED_MARKER_RESERVE, CURATION_EDGE_TYPES, INFRA_NODE_TYPES, JOBS_RENDER_MAX;
+var init_render = __esm({
+  "src/render.ts"() {
     "use strict";
-    import_node_fs6 = __toESM(require("fs"));
-    import_node_os5 = __toESM(require("os"));
-    import_node_path5 = __toESM(require("path"));
-    import_node_crypto6 = __toESM(require("crypto"));
-    init_hook_env();
-    OWNER_MARKER = "--owner mindgraph";
-    RUNNER_RELATIVE = ".mindgraph/bin/mindgraph-hook.cjs";
-    RUNNER_VERSION_RELATIVE = `${RUNNER_RELATIVE}.version`;
-    CLAUDE_POST_TOOL_MATCHER = "mcp__mindgraph__.*|Edit|MultiEdit|Write|NotebookEdit|Bash|Task|Agent";
+    LABEL_MAX = 200;
+    SUMMARY_MAX = 400;
+    QUOTE_MAX = 180;
+    ARTICLE_MAX = 6e3;
+    CHUNK_MAX = 6e3;
+    RELATIONSHIP_MAX = 40;
+    RENDER_CHAR_BUDGET = 24e3;
+    MIN_RENDER_CHAR_BUDGET = 512;
+    BOUNDED_MARKER_RESERVE = 220;
+    CURATION_EDGE_TYPES = /* @__PURE__ */ new Set(["POSSIBLE_DUPLICATE", "PossibleDuplicate"]);
+    INFRA_NODE_TYPES = /* @__PURE__ */ new Set(["Chunk", "Document", "Article"]);
+    JOBS_RENDER_MAX = 20;
   }
 });
 
-// src/render.ts
-function obj(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
-}
-function str2(value) {
-  return typeof value === "string" && value ? value : void 0;
-}
-function num(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+// src/error-detail.ts
+function errorDetail(e) {
+  if (e instanceof 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);
 }
-function edgeTypeName(value) {
-  return str2(value) ?? str2(obj(value)?.Custom);
+function conflictState(e) {
+  if (!(e instanceof MindGraphError) || !e.body || typeof e.body !== "object") {
+    return {};
+  }
+  const body = e.body;
+  const lifted = {};
+  for (const key of CONFLICT_STATE_KEYS) {
+    if (body[key] !== void 0) lifted[key] = body[key];
+  }
+  return lifted;
 }
-function renderBudget(requested) {
-  if (requested === void 0 || !Number.isFinite(requested)) return RENDER_CHAR_BUDGET;
-  return Math.min(
-    RENDER_CHAR_BUDGET,
-    Math.max(MIN_RENDER_CHAR_BUDGET, Math.floor(requested))
-  );
-}
-function clip(value, max, state) {
-  const text2 = str2(value);
-  if (!text2) return void 0;
-  if (text2.length <= max) return text2;
-  state.bounded = true;
-  return `${text2.slice(0, max - 1)}\u2026`;
-}
-function isNodeShaped(value) {
-  const node = obj(value);
-  return Boolean(
-    node && str2(node.uid) && (str2(node.label) || str2(node.node_type) || obj(node.node_type))
-  );
-}
-function nodeDisplayType(node) {
-  const props = obj(node.props);
-  const plain = str2(node.node_type);
-  return (plain && plain !== "Custom" ? plain : void 0) ?? str2(obj(node.node_type)?.Custom) ?? str2(props?.object_type) ?? str2(props?.type_name) ?? str2(obj(props?.data)?.domain_type) ?? plain ?? "Node";
-}
-function nodeFields(node) {
-  const props = obj(node.props);
-  return obj(props?.fields) ?? obj(obj(props?.data)?.fields);
+function toolError(e, fallbackCode) {
+  const body = e instanceof MindGraphError && e.body && typeof e.body === "object" && !Array.isArray(e.body) ? e.body : {};
+  const code = typeof body.code === "string" ? body.code : fallbackCode;
+  const payload = {
+    error: errorDetail(e),
+    ...conflictState(e),
+    ...e instanceof MindGraphError ? { status: e.status } : {},
+    ...code !== void 0 ? { code } : {},
+    ...typeof body.retriable === "boolean" ? { retriable: body.retriable } : {}
+  };
+  return {
+    content: [{ type: "text", text: JSON.stringify(payload) }],
+    structuredContent: payload,
+    isError: true
+  };
 }
-function unwrapSearchResult(value) {
-  if (isNodeShaped(value)) return value;
-  const wrapper = obj(value);
-  const inner = obj(wrapper?.node) ?? obj(wrapper?.object);
-  if (inner && isNodeShaped(inner)) {
-    const score = num(wrapper.score);
-    return score !== void 0 ? { ...inner, retrieval_score: score } : inner;
+var CONFLICT_STATE_KEYS;
+var init_error_detail = __esm({
+  "src/error-detail.ts"() {
+    "use strict";
+    init_dist();
+    CONFLICT_STATE_KEYS = [
+      "current_version",
+      "current_epoch",
+      "lease_expires_at",
+      "lease_owner_agent_id"
+    ];
   }
-  return void 0;
-}
-function statusTag(node) {
-  const tags = [];
-  if (node.superseded === true) {
-    tags.push(
-      node.superseded_by ? `SUPERSEDED by ${str2(node.superseded_by)}` : "SUPERSEDED"
-    );
+});
+
+// src/code-tool.ts
+async function handleCodeTool(client2, args, adapter = new CodegraphAdapter({ cwd: invocationCwd(args) })) {
+  const codeClient = client2;
+  const action = args.action;
+  const refs = Array.isArray(args.code_refs) ? args.code_refs : [];
+  const anchorUids = Array.isArray(args.anchor_uids) ? args.anchor_uids : [];
+  const agentId = typeof args.agent_id === "string" ? args.agent_id : "mcp";
+  const fallbackSpaceUid = typeof args.repo_space_uid === "string" ? args.repo_space_uid : void 0;
+  const options = {
+    repo: typeof args.repo === "string" ? args.repo : void 0,
+    fallbackSpaceUid
+  };
+  const limit = typeof args.limit === "number" ? args.limit : void 0;
+  try {
+    switch (action) {
+      case "anchor": {
+        if (refs.length === 0) return err("missing_code_refs", "code_refs is required for anchor");
+        const resolution = await adapter.resolveRefs(refs, options);
+        const resolved = resolution.results.flatMap(
+          (result) => result.resolved && result.repository ? [{ ref: result.resolved, repository: result.repository }] : []
+        );
+        const unresolved = resolution.results.filter((result) => !result.resolved);
+        if (resolved.length === 0) {
+          return ok({ ...resolution, anchors: [], wrote: false });
+        }
+        const missingSpace = resolved.find(
+          ({ repository }) => typeof args.repo_space_uid !== "string" && !repository.spaceUid
+        );
+        if (missingSpace) {
+          return err(
+            "missing_repository_space",
+            `repo_space_uid, a workspace space_uid, or MINDGRAPH_CODE_SPACE_UID is required for ${missingSpace.repository.repoId}`
+          );
+        }
+        const repositoryAnchors = /* @__PURE__ */ new Map();
+        for (const { repository } of resolved) {
+          if (repositoryAnchors.has(repository.repoRoot)) continue;
+          const spaceUid = typeof args.repo_space_uid === "string" ? args.repo_space_uid : repository.spaceUid;
+          const anchored = await anchorRepository(
+            codeClient,
+            repository,
+            spaceUid,
+            agentId
+          );
+          repositoryAnchors.set(repository.repoRoot, {
+            ...anchored,
+            repository
+          });
+        }
+        const anchors = [];
+        for (const { ref, repository } of resolved) {
+          const repositoryAnchor = repositoryAnchors.get(repository.repoRoot);
+          if (!repositoryAnchor.uid) continue;
+          const spaceUid = typeof args.repo_space_uid === "string" ? args.repo_space_uid : repository.spaceUid;
+          const anchor = await anchorCodeRef(
+            codeClient,
+            ref,
+            repositoryAnchor.uid,
+            spaceUid,
+            agentId
+          );
+          anchors.push(anchor);
+        }
+        return ok({
+          availability: resolution.availability,
+          repository: repositoryAnchors.values().next().value,
+          repositories: [...repositoryAnchors.values()],
+          anchors,
+          unresolved,
+          wrote: anchors.some((anchor) => anchor.created)
+        });
+      }
+      case "recall": {
+        const materialized = new Set(anchorUids);
+        let resolution;
+        if (refs.length > 0) {
+          resolution = await adapter.resolveRefs(refs, options);
+          for (const result of resolution.results) {
+            if (!result.resolved) continue;
+            const uid = await resolveMaterializedUid(codeClient, result.resolved, agentId);
+            if (uid) materialized.add(uid);
+          }
+        }
+        if (materialized.size === 0) {
+          return ok({
+            availability: resolution?.availability,
+            anchors: [],
+            context: [],
+            unresolved: resolution?.results.filter((result) => !result.resolved) ?? []
+          });
+        }
+        const context = await Promise.all(
+          [...materialized].map(async (uid) => ({
+            anchor_uid: uid,
+            graph: await codeClient.traverse({
+              action: "neighborhood",
+              start_uid: uid,
+              depth: 2,
+              max_nodes: Math.min(limit ?? 20, 20)
+            })
+          }))
+        );
+        return ok({
+          availability: resolution?.availability,
+          anchors: [...materialized],
+          context,
+          unresolved: resolution?.results.filter((result) => !result.resolved) ?? []
+        });
+      }
+      case "expand": {
+        const target = await resolveSingleTarget(
+          codeClient,
+          adapter,
+          refs,
+          anchorUids,
+          options
+        );
+        if ("error" in target) return target.error;
+        const expanded = await adapter.expand(target.ref, limit);
+        const joined = await joinMaterialized(
+          codeClient,
+          [...expanded.callers, ...expanded.callees],
+          agentId,
+          Math.min(limit ?? 20, 20)
+        );
+        return ok({ anchor: target.ref, ...expanded, materialized: joined });
+      }
+      case "affected": {
+        const targetUid = typeof args.task_uid === "string" ? args.task_uid : typeof args.execution_uid === "string" ? args.execution_uid : void 0;
+        let graphContext;
+        const graphRefs = [];
+        let unavailableRepositories = [];
+        if (targetUid) {
+          graphContext = await codeClient.traverse({
+            action: "neighborhood",
+            start_uid: targetUid,
+            depth: 2,
+            max_nodes: 50
+          });
+          const fromGraph = await codeRefsFromGraphContext(
+            codeClient,
+            adapter,
+            graphContext
+          );
+          graphRefs.push(...fromGraph.refs);
+          unavailableRepositories = fromGraph.unavailable;
+        }
+        if (refs.length > 0 || anchorUids.length > 0) {
+          const target = await resolveSingleTarget(
+            codeClient,
+            adapter,
+            refs,
+            anchorUids,
+            options
+          );
+          if ("error" in target) return target.error;
+          graphRefs.unshift(target.ref);
+        }
+        const unique = uniqueRefs(graphRefs);
+        if (unique.length === 0) {
+          return ok({
+            target_uid: targetUid,
+            graph_context: graphContext,
+            affected: [],
+            degradation: unavailableRepositories.length > 0 ? `attached code anchors reference repositories unavailable here: ${unavailableRepositories.join(", ")}` : "no materialized code anchors were attached",
+            ...unavailableRepositories.length > 0 ? { unavailable_repositories: unavailableRepositories } : {}
+          });
+        }
+        const impacts = await Promise.all(
+          unique.map(async (ref) => ({ anchor: ref, ...await adapter.affected(ref, limit) }))
+        );
+        const structural = uniqueRefs(impacts.flatMap((impact) => impact.affected));
+        const joined = await joinMaterialized(
+          codeClient,
+          structural,
+          agentId,
+          Math.min(limit ?? 50, 50)
+        );
+        return ok({
+          target_uid: targetUid,
+          graph_context: graphContext,
+          impacts,
+          materialized: joined,
+          ...unavailableRepositories.length > 0 ? { unavailable_repositories: unavailableRepositories } : {}
+        });
+      }
+      default:
+        return err("unknown_action", `unknown mindgraph_code action: ${action}`);
+    }
+  } catch (cause) {
+    if (cause instanceof UnknownRepositoryError) {
+      return err("unknown_repository", cause.message);
+    }
+    return toolError(cause, "code_tool_failed");
   }
-  const truth = str2(node.truth_status) ?? str2(obj(node.props)?.truth_status);
-  if (truth && truth !== "accepted") tags.push(`truth: ${truth}`);
-  if (node.currently_valid === false) tags.push("OUTSIDE ITS VALIDITY WINDOW");
-  if (node.valid_at_time === false) tags.push("NOT VALID AT THE REQUESTED TIME");
-  return tags.length > 0 ? ` [${tags.join("; ")}]` : "";
 }
-function firstQuote(node, state) {
-  const chunks = Array.isArray(node.source_chunks) ? node.source_chunks : [];
-  for (const raw of chunks) {
-    const chunk = obj(raw);
-    const quote = str2(chunk?.quote) ?? str2(obj(chunk?.anchor)?.exact);
-    if (quote) return clip(quote, QUOTE_MAX, state);
+async function attachCodeRefsToToolResult(client2, result, args, adapter) {
+  if (result.isError || !Array.isArray(args.code_refs) || args.code_refs.length === 0) {
+    return result;
+  }
+  const original = JSON.parse(result.content[0]?.text ?? "null");
+  const targetUids = primaryUids(original);
+  if (targetUids.length === 0) {
+    return ok({
+      result: original,
+      code_anchors: {
+        wrote: false,
+        caveat: "the write response exposed no primary UID to attach"
+      }
+    });
+  }
+  const anchorResult = await handleCodeTool(
+    client2,
+    {
+      action: "anchor",
+      code_refs: args.code_refs,
+      repo: args.repo,
+      repo_space_uid: args.repo_space_uid,
+      agent_id: args.agent_id,
+      // Keeps the default adapter anchored to the live session directory
+      // rather than wherever the MCP server process was launched.
+      invocation_context: args.invocation_context
+    },
+    adapter
+  );
+  const anchors = JSON.parse(anchorResult.content[0]?.text ?? "null");
+  if (!anchorResult.isError) {
+    const codeClient = client2;
+    const anchorUids = (anchors.anchors ?? []).flatMap(
+      (anchor) => anchor.uid ? [anchor.uid] : []
+    );
+    const relateFailures = [];
+    for (const targetUid of targetUids) {
+      for (const anchorUid of anchorUids) {
+        try {
+          await codeClient.entity({
+            action: "relate",
+            source_uid: targetUid,
+            target_uid: anchorUid,
+            edge_type: args.action === "lesson" ? "ABOUT" : "RELEVANT_TO",
+            agent_id: args.agent_id
+          });
+        } catch (cause) {
+          relateFailures.push(
+            `${targetUid} -> ${anchorUid}: ${errorDetail(cause)}`
+          );
+        }
+      }
+    }
+    if (relateFailures.length > 0) {
+      return ok({
+        result: original,
+        code_anchors: {
+          ...anchors,
+          caveat: `anchors written, but ${relateFailures.length} relate edge(s) failed: ${relateFailures.join("; ")}`
+        }
+      });
+    }
   }
-  return void 0;
+  return ok({ result: original, code_anchors: anchors });
 }
-function sourceTag(node) {
-  const docs = Array.isArray(node.source_documents) ? node.source_documents : [];
-  const first = obj(docs[0]);
-  const title = str2(first?.title);
-  if (!title) return void 0;
-  const extra = docs.length > 1 ? ` (+${docs.length - 1} more)` : "";
-  return `from: ${title}${extra}`;
+async function anchorRepository(client2, repository, spaceUid, agentId) {
+  return client2.entity({
+    action: "create",
+    label: repository.repoId,
+    props: {
+      entity_type: "repository",
+      canonical_name: repository.repoId,
+      identifiers: { repo_id: repository.repoId }
+    },
+    identity: {
+      namespace: "external.code",
+      key_version: 1,
+      key: repositoryIdentityKey(repository)
+    },
+    identity_space_uid: spaceUid,
+    agent_id: agentId
+  });
 }
-function layer7Fields(node, state) {
-  const fields = nodeFields(node);
-  if (!fields) return void 0;
-  const pairs = Object.entries(fields).filter(([, value]) => value !== null && value !== void 0 && value !== "").map(([key, value]) => `${key}: ${Array.isArray(value) ? value.join(", ") : String(value)}`);
-  if (pairs.length === 0) return void 0;
-  return clip(pairs.join("; "), SUMMARY_MAX, state);
+async function anchorCodeRef(client2, ref, repositoryUid, spaceUid, agentId) {
+  const response = await client2.entity({
+    action: "create",
+    label: ref.qualifiedName,
+    props: {
+      entity_type: ref.kind === "file" ? "code_file" : "code_symbol",
+      canonical_name: ref.qualifiedName,
+      identifiers: {
+        repo_id: ref.repoId,
+        path: ref.path,
+        qualified_name: ref.qualifiedName
+      },
+      attributes: { code_ref: storedCodeRef(ref) }
+    },
+    identity: {
+      namespace: "external.code",
+      key_version: 1,
+      key: codeRefIdentityKey(ref)
+    },
+    identity_space_uid: spaceUid,
+    agent_id: agentId
+  });
+  if (response.uid && response.created !== false && response.status !== "existing") {
+    await client2.entity({
+      action: "relate",
+      source_uid: response.uid,
+      target_uid: repositoryUid,
+      edge_type: "PART_OF",
+      agent_id: agentId
+    });
+  }
+  return { ...response, ref };
 }
-function nodeSummaryText(node, state) {
-  const props = obj(node.props);
-  return clip(node.summary, SUMMARY_MAX, state) ?? clip(props?.content, SUMMARY_MAX, state) ?? clip(props?.description, SUMMARY_MAX, state) ?? clip(props?.definition, SUMMARY_MAX, state);
+async function resolveMaterializedUid(client2, ref, agentId) {
+  const response = await client2.entity({
+    action: "resolve_identity",
+    identity: {
+      namespace: "external.code",
+      key_version: 1,
+      key: codeRefIdentityKey(ref)
+    },
+    agent_id: agentId
+  });
+  return response.status === "existing" ? response.uid : void 0;
 }
-function nodeLines(node, state) {
-  const label = clip(node.label, LABEL_MAX, state) || "(unlabeled)";
-  const type = nodeDisplayType(node);
-  const confidence = num(node.confidence);
-  const score = num(node.retrieval_score);
-  const parenthetical = [
-    type,
-    confidence !== void 0 ? `confidence ${confidence}` : void 0,
-    score !== void 0 ? `score ${Math.round(score * 100) / 100}` : void 0
-  ].filter(Boolean).join(", ");
-  const head = `- **${label}** [${str2(node.uid) || "?"}] (${parenthetical})${statusTag(node)}`;
-  const summary = nodeSummaryText(node, state);
-  const lines = [summary && summary !== label ? `${head}: ${summary}` : head];
-  const fields = layer7Fields(node, state);
-  if (fields) lines.push(`  - fields: ${fields}`);
-  const quote = firstQuote(node, state);
-  if (quote) lines.push(`  - source quote: "${quote}"`);
-  const source = sourceTag(node);
-  if (source) lines.push(`  - ${source}`);
-  const believers = Array.isArray(node.believed_by) ? node.believed_by : [];
-  if (believers.length > 0) {
-    const rendered2 = believers.slice(0, 3).map((raw) => {
-      const believer = obj(raw);
-      const conf = num(believer?.confidence);
-      return `${str2(believer?.agent_label) || "?"}${conf !== void 0 ? ` (${conf})` : ""}`;
-    }).join(", ");
-    lines.push(`  - believed by: ${rendered2}`);
+async function codeRefFromAnchor(client2, adapter, uid) {
+  const node = await client2.getNode(uid);
+  const attributes = node.props?.attributes;
+  if (!attributes || typeof attributes !== "object") return void 0;
+  const codeRef = attributes.code_ref;
+  if (!isStoredCodeRef(codeRef)) return void 0;
+  try {
+    const repository = await adapter.resolveRepository(codeRef.repoId);
+    return { ref: { ...codeRef, repoRoot: repository.repoRoot } };
+  } catch (cause) {
+    if (cause instanceof UnknownRepositoryError) {
+      return { missingRepo: codeRef.repoId };
+    }
+    throw cause;
   }
-  return lines.join("\n");
 }
-function groupedNodeSections(nodes, state, headingPrefix = "") {
-  const groups = /* @__PURE__ */ new Map();
-  for (const node of nodes) {
-    const type = nodeDisplayType(node);
-    const group = groups.get(type) ?? [];
-    group.push(node);
-    groups.set(type, group);
+async function resolveSingleTarget(client2, adapter, refs, anchorUids, options) {
+  if (refs.length > 1 || anchorUids.length > 1) {
+    return { error: err("ambiguous_target", "expand/affected accepts exactly one code target") };
   }
-  const sections = [];
-  let first = true;
-  for (const [type, group] of groups) {
-    sections.push({
-      heading: `${first ? headingPrefix : ""}### ${type}`,
-      items: group.map((node) => nodeLines(node, state))
-    });
-    first = false;
+  if (anchorUids.length === 1) {
+    const outcome = await codeRefFromAnchor(client2, adapter, anchorUids[0]);
+    if (!outcome) {
+      return { error: err("invalid_anchor", "anchor UID does not contain a typed code_ref") };
+    }
+    if ("missingRepo" in outcome) {
+      return {
+        error: err(
+          "repository_unavailable",
+          `repository ${outcome.missingRepo} is not checked out here or declared in .mindgraph/workspace.json; expand/affected need its local index`
+        )
+      };
+    }
+    return { ref: outcome.ref };
   }
-  return sections;
-}
-function relationshipItems(edges, labelByUid, state, options) {
-  const lines = [];
-  for (const raw of edges) {
-    const edge = obj(raw);
-    if (!edge) continue;
-    const type = edgeTypeName(edge.edge_type) || "?";
-    const from = str2(edge.from_uid);
-    const to = str2(edge.to_uid);
-    if (CURATION_EDGE_TYPES.has(type)) continue;
-    if (!from || !to || from === to) continue;
-    const fromLabel = labelByUid.get(from) ?? (options?.fallbackToUid ? `[${from}]` : void 0);
-    const toLabel = labelByUid.get(to) ?? (options?.fallbackToUid ? `[${to}]` : void 0);
-    if (!fromLabel || !toLabel) continue;
-    lines.push(`- ${fromLabel} \u2014${type}\u2192 ${toLabel}`);
+  if (refs.length !== 1) {
+    return { error: err("missing_code_ref", "one code_ref or anchor_uid is required") };
   }
-  if (lines.length > RELATIONSHIP_MAX) {
-    state.bounded = true;
-    const extra = lines.length - RELATIONSHIP_MAX;
-    state.omitted += extra;
-    return [...lines.slice(0, RELATIONSHIP_MAX), `- (+${extra} more relationships)`];
+  const resolution = await adapter.resolveRefs(refs, options);
+  const result = resolution.results[0];
+  if (!result.resolved) {
+    return {
+      error: ok({
+        availability: resolution.availability,
+        result,
+        wrote: false
+      })
+    };
   }
-  return lines;
+  return { ref: result.resolved };
 }
-function assemble(header, sections, state, maxChars) {
-  const budget = renderBudget(maxChars);
-  const packingBudget = Math.max(header.length, budget - BOUNDED_MARKER_RESERVE);
-  const lines = [header];
-  let used = header.length;
-  for (const section of sections) {
-    if (section.items.length === 0 && !section.heading) continue;
-    const headingCost = section.heading.length + 2;
-    if (used + headingCost > packingBudget) {
-      state.bounded = true;
-      state.omitted += Math.max(1, section.items.length);
-      continue;
-    }
-    let sectionUsed = 0;
-    const kept = [];
-    let dropped = 0;
-    for (const item of section.items) {
-      if (used + headingCost + sectionUsed + item.length + 1 > packingBudget) {
-        dropped += 1;
-        continue;
-      }
-      kept.push(item);
-      sectionUsed += item.length + 1;
-    }
-    if (kept.length === 0 && section.items.length > 0) {
-      state.bounded = true;
-      state.omitted += dropped;
-      continue;
-    }
-    if (dropped > 0) {
-      state.bounded = true;
-      state.omitted += dropped;
-      const marker = `(+${dropped} more not shown)`;
-      if (used + headingCost + sectionUsed + marker.length + 1 <= packingBudget) {
-        kept.push(marker);
-        sectionUsed += marker.length + 1;
+async function joinMaterialized(client2, refs, agentId, limit) {
+  const joined = [];
+  for (const ref of uniqueRefs(refs).slice(0, limit)) {
+    const uid = await resolveMaterializedUid(client2, ref, agentId);
+    if (!uid) continue;
+    joined.push({
+      ref,
+      anchor_uid: uid,
+      graph: await client2.traverse({
+        action: "neighborhood",
+        start_uid: uid,
+        depth: 2,
+        max_nodes: 20
+      })
+    });
+  }
+  return joined;
+}
+async function codeRefsFromGraphContext(client2, adapter, context) {
+  const uids = /* @__PURE__ */ new Set();
+  collectUids(context, uids);
+  if (uids.size === 0) return { refs: [], unavailable: [] };
+  const nodes = client2.getNodesBatch ? await client2.getNodesBatch([...uids]) : await Promise.all([...uids].map((uid) => client2.getNode(uid).catch(() => void 0)));
+  const stored = nodes.flatMap((node) => {
+    if (!node) return [];
+    const attributes = node.props?.attributes;
+    if (!attributes || typeof attributes !== "object") return [];
+    const codeRef = attributes.code_ref;
+    return isStoredCodeRef(codeRef) ? [codeRef] : [];
+  });
+  const refs = [];
+  const unavailable = /* @__PURE__ */ new Set();
+  for (const ref of stored) {
+    try {
+      const repository = await adapter.resolveRepository(ref.repoId);
+      refs.push({ ...ref, repoRoot: repository.repoRoot });
+    } catch (cause) {
+      if (cause instanceof UnknownRepositoryError) {
+        unavailable.add(ref.repoId);
+      } else {
+        throw cause;
       }
     }
-    lines.push(
-      section.items.length === 0 ? section.heading : section.heading ? `${section.heading}
-${kept.join("\n")}` : kept.join("\n")
-    );
-    used += headingCost + sectionUsed;
   }
-  if (state.bounded) {
-    lines.push(
-      `\u2026[rendered context bounded to ${budget} chars; ${state.omitted} item(s) omitted \u2014 fetch full node content by uid, narrow the query, raise max_output_chars, or pass format: "json" for the raw response]`
-    );
+  return { refs, unavailable: [...unavailable].sort() };
+}
+function collectUids(value, uids) {
+  if (Array.isArray(value)) {
+    value.forEach((item) => collectUids(item, uids));
+    return;
+  }
+  if (!value || typeof value !== "object") return;
+  for (const [key, child] of Object.entries(value)) {
+    if (typeof child === "string" && ["uid", "node_uid", "neighbor_uid", "from_uid", "to_uid"].includes(key)) {
+      uids.add(child);
+    } else {
+      collectUids(child, uids);
+    }
   }
-  return lines.join("\n\n").slice(0, budget);
 }
-function policySections(payload, state) {
-  const policies = Array.isArray(payload.applicable_policies) ? payload.applicable_policies : [];
-  if (policies.length === 0) return [];
-  const items = policies.map((raw) => obj(raw)).filter((policy) => Boolean(policy)).map((policy) => {
-    const rules = Array.isArray(policy.prose_rules) ? policy.prose_rules.map(String).join("; ") : policy.prose_rules;
-    return `- ${str2(policy.name) || "(unnamed policy)"}: ${clip(rules, SUMMARY_MAX, state) || "(structured rules apply)"}`;
+function isStoredCodeRef(value) {
+  if (!value || typeof value !== "object") return false;
+  const ref = value;
+  return typeof ref.repoId === "string" && typeof ref.path === "string" && typeof ref.language === "string" && typeof ref.kind === "string" && typeof ref.qualifiedName === "string" && (typeof ref.signature === "string" || ref.signature === null) && typeof ref.startLine === "number" && typeof ref.endLine === "number";
+}
+function storedCodeRef(ref) {
+  const { repoRoot: _localOnly, ...stored } = ref;
+  return stored;
+}
+function uniqueRefs(refs) {
+  const seen = /* @__PURE__ */ new Set();
+  return refs.filter((ref) => {
+    const key = `${ref.repoId}:${ref.path}:${ref.qualifiedName}:${ref.signature ?? ""}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
   });
-  return [{ heading: "## Applicable policies", items }];
 }
-function hiddenSections(payload) {
-  const hidden = payload.hidden_item_count;
-  if (hidden === void 0 || hidden === null) return [];
+function primaryUids(value) {
+  if (!value || typeof value !== "object") return [];
+  const object2 = value;
+  const keys = [
+    "uid",
+    "claim_uid",
+    "goal_uid",
+    "project_uid",
+    "milestone_uid",
+    "decision_uid",
+    "task_uid",
+    "plan_uid",
+    "step_uid",
+    "execution_uid",
+    "lesson_uid"
+  ];
   return [
-    {
-      heading: `Note: ${hidden} item(s) were hidden by access scoping.`,
-      items: []
-    }
+    ...new Set(
+      keys.flatMap((key) => typeof object2[key] === "string" ? [object2[key]] : [])
+    )
   ];
 }
-function renderContext(response, maxChars) {
-  const payload = obj(response);
-  if (!payload) return void 0;
-  if (typeof payload.context_text === "string" && payload.context_text.length > 0) {
-    const text2 = payload.context_text;
-    if (maxChars !== void 0 && text2.length > maxChars) {
-      return `${text2.slice(0, maxChars)}
-[truncated to ${maxChars} characters]`;
-    }
-    return text2;
+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) }]
+    });
+    err = (code, message, details) => ({
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ error: message, code, details })
+        }
+      ],
+      isError: true
+    });
+    CODE_TOOL = {
+      name: "mindgraph_code",
+      description: "Resolve typed code references through the local codegraph index and join them to persistent MindGraph memory/work. anchor creates exact repository/code anchors; recall reads attached graph context; expand reads callers/callees; affected reads impact for a code ref or Task/Execution. Ambiguous refs return candidates without writing. Refs with a path route to the repository defining that file (nearest declared root in .mindgraph/workspace.json); bare symbols resolve against the current repository only \u2014 pass path or repo to target a sibling.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          action: {
+            type: "string",
+            enum: ["anchor", "recall", "expand", "affected"]
+          },
+          code_refs: {
+            type: "array",
+            maxItems: 50,
+            items: {
+              oneOf: [
+                { type: "string" },
+                {
+                  type: "object",
+                  properties: {
+                    repo: { type: "string" },
+                    path: { type: "string" },
+                    line: { type: "integer", minimum: 1 },
+                    symbol: { type: "string" },
+                    kind: { type: "string" },
+                    language: { type: "string" },
+                    signature: { type: "string" }
+                  },
+                  additionalProperties: false
+                }
+              ]
+            }
+          },
+          anchor_uids: {
+            type: "array",
+            maxItems: 50,
+            items: { type: "string" },
+            description: "Already-materialized code anchor UIDs (codegraph is not required for recall)"
+          },
+          repo: {
+            type: "string",
+            description: "Configured repository id or repository root"
+          },
+          repo_space_uid: {
+            type: "string",
+            description: "Writable shared Project/repository Space for new anchors (anchor requires this, a workspace space_uid, or MINDGRAPH_CODE_SPACE_UID)"
+          },
+          task_uid: { type: "string" },
+          execution_uid: { type: "string" },
+          limit: { type: "integer", minimum: 1, maximum: 50 },
+          agent_id: { type: "string" }
+        },
+        required: ["action"]
+      },
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    };
   }
-  const graph = obj(payload.graph);
-  const rawNodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
-  const shaped = rawNodes.filter(isNodeShaped);
-  const nodes = shaped.filter((node) => !INFRA_NODE_TYPES.has(str2(node.node_type) || ""));
-  const infraOnly = shaped.length - nodes.length;
-  const articles = Array.isArray(payload.articles) ? payload.articles : [];
-  const chunks = Array.isArray(payload.chunks) ? payload.chunks : [];
-  const state = { bounded: false, omitted: 0 };
-  const sections = [];
-  if (articles.length > 0) {
-    sections.push({
-      heading: "## Knowledge articles",
-      items: articles.map((raw) => obj(raw)).filter((article) => Boolean(article)).map(
-        (article) => `### ${str2(article.label) || "(untitled)"} [${str2(article.uid) || "?"}]
-${clip(article.content, ARTICLE_MAX, state) || ""}`
+});
+
+// src/workspace-scope.ts
+function readScopeCache(cache) {
+  if (!cache) return {};
+  try {
+    const parsed = JSON.parse(
+      import_node_fs3.default.readFileSync(import_node_path3.default.join(cache.dir, SCOPE_CACHE_FILE), "utf8")
+    );
+    if (parsed.v !== 1 || parsed.tenant !== cache.tenant || !parsed.entries) return {};
+    const now = (cache.now ?? Date.now)();
+    return Object.fromEntries(
+      Object.entries(parsed.entries).filter(
+        ([, entry]) => typeof entry?.uid === "string" && typeof entry.at === "number" && now - entry.at >= 0 && now - entry.at < SCOPE_CACHE_TTL_MS
       )
-    });
+    );
+  } catch {
+    return {};
   }
-  if (nodes.length > 0) {
-    sections.push(...groupedNodeSections(nodes, state, "## Knowledge graph\n\n"));
-    const labelByUid = /* @__PURE__ */ new Map();
-    for (const node of nodes) labelByUid.set(str2(node.uid), str2(node.label) || "?");
-    const relationships = relationshipItems(
-      Array.isArray(graph?.edges) ? graph.edges : [],
-      labelByUid,
-      state
+}
+function writeScopeCache(cache, entries) {
+  if (!cache) return;
+  try {
+    import_node_fs3.default.mkdirSync(cache.dir, { recursive: true, mode: 448 });
+    const file = import_node_path3.default.join(cache.dir, SCOPE_CACHE_FILE);
+    const temporary = `${file}.${process.pid}.tmp`;
+    import_node_fs3.default.writeFileSync(
+      temporary,
+      JSON.stringify({ v: 1, tenant: cache.tenant, entries }),
+      { mode: 384 }
     );
-    if (relationships.length > 0) {
-      sections.push({ heading: "## Relationships", items: relationships });
-    }
-  } else if (infraOnly > 0) {
-    sections.push({
-      heading: `Note: ${infraOnly} document/chunk node(s) matched \u2014 use action "document_index" or include_chunks for their content.`,
-      items: []
-    });
+    import_node_fs3.default.renameSync(temporary, file);
+  } catch {
   }
-  if (chunks.length > 0) {
-    sections.push({
-      heading: "## Source excerpts",
-      items: chunks.map((raw) => obj(raw)).filter((chunk) => Boolean(chunk)).map(
-        (chunk) => `- [${str2(chunk.chunk_uid) || "?"}] from "${str2(chunk.document_title) || "unknown document"}": "${clip(chunk.content, CHUNK_MAX, state) || ""}"`
-      )
-    });
+}
+function record(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+async function resolveRepositoryScope(cwd, client2, agentId, options = {}) {
+  if (!client2.entity) return { uids: [], names: {}, failures: [] };
+  const adapter = new CodegraphAdapter({
+    cwd,
+    workspaceFile: options.workspaceFile,
+    childWorkspaces: true
+  });
+  const configured = await adapter.resolveRepositories();
+  const repositories = configured.length > 0 ? configured : [await adapter.resolveRepository()];
+  const failures = [];
+  const names = {};
+  const cached = readScopeCache(options.cache);
+  const fresh = {};
+  const stamp = (options.cache?.now ?? Date.now)();
+  const resolved = await Promise.all(
+    repositories.map(async (repository) => {
+      const remembered = cached[repository.repoId];
+      if (remembered) {
+        names[remembered.uid] = repository.repoId;
+        return remembered.uid;
+      }
+      try {
+        const payload = record(
+          await client2.entity({
+            action: "resolve_identity",
+            identity: {
+              namespace: "external.code",
+              key_version: 1,
+              key: repositoryIdentityKey(repository)
+            },
+            agent_id: agentId
+          })
+        );
+        if (payload?.status === "existing" && typeof payload.uid === "string" && payload.uid) {
+          names[payload.uid] = repository.repoId;
+          fresh[repository.repoId] = { uid: payload.uid, at: stamp };
+          return payload.uid;
+        }
+        if (payload?.status === "absent") {
+          const anchored = await anchorRepository(
+            client2,
+            repository,
+            repository.spaceUid ?? `space:agent:${agentId}`,
+            agentId
+          );
+          if (anchored?.uid) {
+            names[anchored.uid] = repository.repoId;
+            fresh[repository.repoId] = { uid: anchored.uid, at: stamp };
+            return anchored.uid;
+          }
+          failures.push(
+            `${repository.repoId}: anchor ${anchored?.status ?? "failed"}`
+          );
+          return void 0;
+        }
+        failures.push(
+          `${repository.repoId}: ${typeof payload?.status === "string" && payload.status ? payload.status : "unresolved"}`
+        );
+        return void 0;
+      } catch (error2) {
+        failures.push(
+          `${repository.repoId}: ${error2?.message || "resolve failed"}`
+        );
+        return void 0;
+      }
+    })
+  );
+  if (Object.keys(fresh).length > 0) {
+    writeScopeCache(options.cache, { ...cached, ...fresh });
   }
-  sections.push(...policySections(payload, state));
-  sections.push(...hiddenSections(payload));
-  if (sections.length === 0) {
-    return "No results found for this search.";
+  return {
+    uids: [...new Set(resolved.filter((uid) => Boolean(uid)))],
+    names,
+    failures
+  };
+}
+var import_node_fs3, import_node_path3, WORKSPACE_RESUME_LIMIT, SCOPE_CACHE_TTL_MS, SCOPE_CACHE_FILE;
+var init_workspace_scope = __esm({
+  "src/workspace-scope.ts"() {
+    "use strict";
+    import_node_fs3 = __toESM(require("fs"));
+    import_node_path3 = __toESM(require("path"));
+    init_codegraph();
+    init_code_tool();
+    WORKSPACE_RESUME_LIMIT = 9;
+    SCOPE_CACHE_TTL_MS = 12 * 60 * 60 * 1e3;
+    SCOPE_CACHE_FILE = "repository-scopes.json";
   }
-  if (nodes.length === 0 && articles.length === 0 && chunks.length === 0) {
-    return assemble(
-      "# Retrieved context\n\nNo graph results matched this search.",
-      sections,
-      state,
-      maxChars
-    );
+});
+
+// src/call-ledger.ts
+function callsDir(options) {
+  return import_node_path4.default.join(
+    options.runtimeDir || process.env.MINDGRAPH_RUNTIME_DIR || import_node_path4.default.join(import_node_os3.default.homedir(), ".mindgraph", "runtime"),
+    "calls"
+  );
+}
+function stableJson(value) {
+  if (Array.isArray(value)) return `[${value.map(stableJson).join(",")}]`;
+  if (value && typeof value === "object") {
+    return `{${Object.entries(value).filter(([, item]) => item !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`).join(",")}}`;
   }
-  return assemble("# Retrieved context", sections, state, maxChars);
+  return JSON.stringify(value) ?? "null";
 }
-function resumeEntry(raw, state, fallbackType) {
-  const wrapper = obj(raw);
-  if (!wrapper) return void 0;
-  const value = obj(wrapper.node) ?? wrapper;
-  if (isNodeShaped(value)) return nodeLines(value, state);
-  const uid = str2(value.uid);
-  const props = obj(value.props);
-  const label = clip(value.label, LABEL_MAX, state) ?? clip(value.name, LABEL_MAX, state) ?? clip(value.title, LABEL_MAX, state) ?? clip(value.action, LABEL_MAX, state) ?? fallbackType;
-  const status = str2(value.status) ?? str2(props?.status);
-  const summary = clip(value.summary, SUMMARY_MAX, state) ?? clip(value.description, SUMMARY_MAX, state) ?? clip(value.content, SUMMARY_MAX, state) ?? clip(value.outcome_summary, SUMMARY_MAX, state) ?? clip(props?.summary, SUMMARY_MAX, state);
-  const details = [
-    status ? `status ${status}` : void 0,
-    str2(value.path) ? `path ${str2(value.path)}` : void 0,
-    str2(value.symbol) ? `symbol ${str2(value.symbol)}` : void 0
-  ].filter(Boolean);
-  const head = `- **${label}**${uid ? ` [${uid}]` : ""}${details.length > 0 ? ` (${details.join(", ")})` : ""}`;
-  return summary && summary !== label ? `${head}: ${summary}` : head;
+function bareToolName(name) {
+  const cut = name.lastIndexOf("__");
+  return cut === -1 ? name : name.slice(cut + 2);
 }
-function resumeSection(heading, values, state, fallbackType) {
-  const items = values.map((value) => resumeEntry(value, state, fallbackType)).filter((value) => Boolean(value));
-  return items.length > 0 ? { heading, items } : void 0;
+function callKey(toolName, toolInput) {
+  return import_node_crypto4.default.createHash("sha256").update(`${bareToolName(toolName)}\0${stableJson(toolInput)}`).digest("hex");
 }
-function renderResumeContext(response, maxChars) {
-  const payload = obj(response);
-  if (!payload) return void 0;
-  const state = { bounded: false, omitted: 0 };
-  const status = str2(payload.status);
-  if (!payload.task && status === "no_eligible_work") {
-    const scopedOut = Array.isArray(payload.scoped_out_tasks) ? payload.scoped_out_tasks.length : 0;
-    const note = scopedOut > 0 ? ` ${scopedOut} task(s) exist outside the requested scope.` : "";
-    return assemble(
-      "# Resume context",
-      [{ heading: `No eligible work was found in the requested scope.${note}`, items: [] }],
-      state,
-      maxChars
-    );
+function sessionKey(sessionId) {
+  return import_node_crypto4.default.createHash("sha256").update(sessionId).digest("hex").slice(0, 16);
+}
+function prune(dir, now) {
+  let names;
+  try {
+    names = import_node_fs4.default.readdirSync(dir);
+  } catch {
+    return;
   }
-  const sections = [];
-  const push = (section) => {
-    if (section) sections.push(section);
-  };
-  push(resumeSection("## Current task", [payload.task], state, "Task"));
-  push(
-    resumeSection(
-      "## Goal and project",
-      [payload.goal, payload.project].filter(Boolean),
-      state,
-      "Scope"
-    )
-  );
-  push(resumeSection("## Plan", [payload.plan], state, "Plan"));
-  push(
-    resumeSection(
-      "## Next steps",
-      Array.isArray(payload.next_steps) ? payload.next_steps : [],
-      state,
-      "Next step"
-    )
-  );
-  push(
-    resumeSection(
-      "## Blockers",
-      Array.isArray(payload.blockers) ? payload.blockers : [],
-      state,
-      "Blocker"
-    )
-  );
-  const knowledge = obj(payload.knowledge);
-  push(
-    resumeSection(
-      "## Relevant lessons and risks",
-      [
-        ...Array.isArray(knowledge?.lessons) ? knowledge.lessons : [],
-        ...Array.isArray(knowledge?.risks) ? knowledge.risks : []
-      ],
-      state,
-      "Knowledge"
-    )
-  );
-  push(
-    resumeSection(
-      "## Active execution",
-      [payload.active_execution].filter(Boolean),
-      state,
-      "Execution"
-    )
-  );
-  push(
-    resumeSection(
-      "## Recent executions",
-      Array.isArray(payload.recent_executions) ? payload.recent_executions : [],
-      state,
-      "Execution"
-    )
-  );
-  push(
-    resumeSection(
-      "## Code targets",
-      Array.isArray(payload.code_targets) ? payload.code_targets : [],
-      state,
-      "Code target"
-    )
-  );
-  push(resumeSection("## Lease", [payload.lease].filter(Boolean), state, "Lease"));
-  const warning = clip(payload.warning, SUMMARY_MAX, state);
-  if (warning) sections.push({ heading: "## Warning", items: [`- ${warning}`] });
-  const selectionReason = clip(payload.selection_reason, SUMMARY_MAX, state);
-  if (selectionReason) {
-    sections.push({ heading: "## Selection", items: [`- ${selectionReason}`] });
+  for (const name of names) {
+    const file = import_node_path4.default.join(dir, name);
+    try {
+      if (now - import_node_fs4.default.statSync(file).mtimeMs > TTL_MS) import_node_fs4.default.unlinkSync(file);
+    } catch {
+    }
   }
-  if (sections.length === 0) return void 0;
-  return assemble("# Resume context", sections, state, maxChars);
 }
-function renderNodeList(response, title, limit, maxChars) {
-  let candidates = [];
-  if (Array.isArray(response)) {
-    candidates = response;
-  } else {
-    const payload = obj(response);
-    if (!payload) return void 0;
-    for (const key of ["nodes", "results", "items", "goals", "questions", "claims", "preferences", "documents"]) {
-      const candidate = payload[key];
-      if (Array.isArray(candidate) && candidate.some((entry) => unwrapSearchResult(entry))) {
-        candidates = candidate;
-        break;
+function recordPendingCall(toolName, toolInput, harnessSessionId, fills, options = {}) {
+  const now = (options.now ?? Date.now)();
+  const dir = callsDir(options);
+  try {
+    import_node_fs4.default.mkdirSync(dir, { recursive: true, mode: 448 });
+    prune(dir, now);
+    const record2 = {
+      harnessSessionId,
+      projectDir: options.projectDir ?? process.env.CLAUDE_PROJECT_DIR,
+      fills,
+      createdAt: now
+    };
+    const file = import_node_path4.default.join(
+      dir,
+      `${callKey(toolName, toolInput)}.${sessionKey(harnessSessionId)}.json`
+    );
+    const temporary = `${file}.${process.pid}.${import_node_crypto4.default.randomUUID()}.tmp`;
+    import_node_fs4.default.writeFileSync(temporary, JSON.stringify(record2), { mode: 384 });
+    import_node_fs4.default.renameSync(temporary, file);
+  } catch {
+  }
+}
+function resolvePendingCall(toolName, toolInput, options = {}) {
+  const now = (options.now ?? Date.now)();
+  const dir = callsDir(options);
+  const prefix = `${callKey(toolName, toolInput)}.`;
+  let names;
+  try {
+    names = import_node_fs4.default.readdirSync(dir).filter((name) => name.startsWith(prefix) && name.endsWith(".json"));
+  } catch {
+    return void 0;
+  }
+  let matches = [];
+  for (const name of names) {
+    try {
+      const record2 = JSON.parse(
+        import_node_fs4.default.readFileSync(import_node_path4.default.join(dir, name), "utf8")
+      );
+      if (typeof record2.createdAt === "number" && now - record2.createdAt <= TTL_MS && record2.fills && typeof record2.fills === "object") {
+        matches.push(record2);
       }
+    } catch {
     }
   }
-  let nodes = candidates.map(unwrapSearchResult).filter((node) => Boolean(node));
-  if (nodes.length === 0) return void 0;
-  const total = nodes.length;
-  const state = { bounded: false, omitted: 0 };
-  if (limit !== void 0 && limit > 0 && nodes.length > limit) {
-    state.omitted += nodes.length - limit;
-    nodes = nodes.slice(0, limit);
-    state.bounded = true;
+  if (matches.length > 1) {
+    const projectDir = options.projectDir ?? process.env.CLAUDE_PROJECT_DIR;
+    matches = projectDir ? matches.filter((record2) => record2.projectDir === projectDir) : [];
   }
-  const sections = groupedNodeSections(nodes, state);
-  const shown = nodes.length;
-  return assemble(
-    `# ${title} (${shown === total ? total : `${shown} of ${total}`})`,
-    sections,
-    state,
-    maxChars
+  return matches.length === 1 ? matches[0].fills : void 0;
+}
+var import_node_crypto4, import_node_fs4, import_node_os3, import_node_path4, TTL_MS;
+var init_call_ledger = __esm({
+  "src/call-ledger.ts"() {
+    "use strict";
+    import_node_crypto4 = __toESM(require("crypto"));
+    import_node_fs4 = __toESM(require("fs"));
+    import_node_os3 = __toESM(require("os"));
+    import_node_path4 = __toESM(require("path"));
+    TTL_MS = 10 * 6e4;
+  }
+});
+
+// src/hook-installer.ts
+function storedFeatures(homeDir) {
+  const { promptRecall: promptRecall2, capture } = loadHookEnv(
+    import_node_path6.default.join(homeDir || import_node_os5.default.homedir(), ".mindgraph")
   );
+  return { promptRecall: promptRecall2, capture };
+}
+function command(harness) {
+  return `node "$HOME/${RUNNER_RELATIVE}" hook --harness ${harness} --owner mindgraph`;
+}
+function windowsCommand(harness) {
+  return `node "%USERPROFILE%\\.mindgraph\\bin\\mindgraph-hook.cjs" hook --harness ${harness} --owner mindgraph`;
+}
+function installHookRunner(sourceFile, homeDir, version) {
+  const target = import_node_path6.default.join(homeDir || import_node_os5.default.homedir(), RUNNER_RELATIVE);
+  import_node_fs7.default.mkdirSync(import_node_path6.default.dirname(target), { recursive: true });
+  const temporary = `${target}.${process.pid}.${import_node_crypto6.default.randomUUID()}.tmp`;
+  import_node_fs7.default.copyFileSync(sourceFile, temporary);
+  import_node_fs7.default.renameSync(temporary, target);
+  const versionPath = import_node_path6.default.join(homeDir || import_node_os5.default.homedir(), RUNNER_VERSION_RELATIVE);
+  if (version) {
+    import_node_fs7.default.writeFileSync(versionPath, `${version}
+`);
+  } else {
+    import_node_fs7.default.rmSync(versionPath, { force: true });
+  }
+  return target;
+}
+function installedHookRunnerVersion(homeDir) {
+  try {
+    const raw = import_node_fs7.default.readFileSync(
+      import_node_path6.default.join(homeDir || import_node_os5.default.homedir(), RUNNER_VERSION_RELATIVE),
+      "utf8"
+    ).trim();
+    return raw || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function parseSemver(value) {
+  if (!value) return void 0;
+  const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value.trim());
+  if (!match) return void 0;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
 }
-function renderTraversal(response, maxChars) {
-  const directSteps = Array.isArray(response) ? response : void 0;
-  const payload = obj(response);
-  if (!payload && !directSteps) return void 0;
-  const body = payload ?? {};
-  const container = obj(body.graph) ?? body;
-  const rawNodes = Array.isArray(container.nodes) ? container.nodes : [];
-  const nodes = rawNodes.filter(isNodeShaped);
-  const paths = Array.isArray(body.paths) ? body.paths : [];
-  const hasSteps = directSteps !== void 0 || Object.hasOwn(body, "steps");
-  const rawSteps = directSteps ?? (Array.isArray(body.steps) ? body.steps : []);
-  if (nodes.length === 0 && paths.length === 0 && !hasSteps) return void 0;
-  const state = { bounded: false, omitted: 0 };
-  const sections = [];
-  const labelByUid = /* @__PURE__ */ new Map();
-  for (const node of nodes) labelByUid.set(str2(node.uid), str2(node.label) || "?");
-  if (paths.length > 0) {
-    const items = paths.map((raw) => obj(raw)).filter((path9) => Boolean(path9)).map((path9, index) => {
-      const uids = Array.isArray(path9.node_uids) ? path9.node_uids.map(String) : [];
-      const labels = Array.isArray(path9.labels) ? path9.labels.map(String) : Array.isArray(path9.nodes) ? path9.nodes.map((hop) => {
-        const hopNode = obj(hop);
-        return str2(hopNode?.label) || labelByUid.get(str2(hopNode?.uid) || "") || str2(hop) || "?";
-      }) : [];
-      const route = labels.length > 0 ? labels.join(" \u2192 ") : uids.join(" \u2192 ") || "(path)";
-      const cost = num(path9.cost) ?? num(path9.path_cost);
-      const confidence = num(path9.path_confidence);
-      const meta = [
-        cost !== void 0 ? `cost ${cost}` : void 0,
-        confidence !== void 0 ? `confidence ${confidence}` : void 0
-      ].filter(Boolean);
-      const head = `${index + 1}. ${route}${meta.length > 0 ? ` (${meta.join(", ")})` : ""}`;
-      return labels.length > 0 && uids.length > 0 ? `${head}
-   uids: ${uids.join(" \u2192 ")}` : head;
-    });
-    sections.push({ heading: "## Paths", items });
+function semverNewer(a, b) {
+  for (let index = 0; index < 3; index += 1) {
+    if (a[index] !== b[index]) return a[index] > b[index];
   }
-  if (hasSteps) {
-    const stepItems = rawSteps.map((raw) => obj(raw)).filter((step) => Boolean(step)).map((step) => {
-      const depth = num(step.depth);
-      const uid = str2(step.node_uid) ?? str2(step.uid) ?? str2(step.edge_to_uid) ?? "?";
-      const parent = str2(step.parent_uid) ?? str2(step.edge_from_uid);
-      const label = str2(step.label) || "(unlabeled)";
-      const relation = edgeTypeName(step.edge_type);
-      const role = str2(step.traversal_role);
-      const type = str2(step.node_type) ?? str2(obj(step.node_type)?.Custom);
-      const cost = num(step.path_cost);
-      const confidence = num(step.path_confidence);
-      const prefix = [
-        depth !== void 0 ? `depth ${depth}` : void 0,
-        role,
-        relation ? `\u2014${relation}\u2192` : void 0
-      ].filter(Boolean).join(" ");
-      const meta = [
-        type,
-        parent ? `parent ${parent}` : void 0,
-        cost !== void 0 ? `cost ${cost}` : void 0,
-        confidence !== void 0 ? `confidence ${confidence}` : void 0
-      ].filter(Boolean).join(", ");
-      return `- ${prefix ? `${prefix}: ` : ""}**${label}** [${uid}]${meta ? ` (${meta})` : ""}`;
-    });
-    if (stepItems.length > 0) {
-      sections.push({ heading: "## Traversal steps", items: stepItems });
-    } else {
-      const start = str2(body.start_uid) || "?";
-      const end = str2(body.end_uid);
-      const mode2 = str2(body.mode);
-      sections.push({
-        heading: mode2 === "path" && end ? `No path found from [${start}] to [${end}].` : `No traversal steps returned from [${start}].`,
-        items: []
-      });
+  return false;
+}
+function refreshHookRunner(serverVersion, sourceBundle, homeDir) {
+  try {
+    if (process.env.MINDGRAPH_HOOK_AUTOUPDATE === "off") {
+      return { refreshed: false, reason: "disabled" };
+    }
+    const home = homeDir || import_node_os5.default.homedir();
+    if (!import_node_fs7.default.existsSync(import_node_path6.default.join(home, RUNNER_RELATIVE))) {
+      return { refreshed: false, reason: "no_runner" };
+    }
+    if (!import_node_fs7.default.existsSync(sourceBundle)) {
+      return { refreshed: false, reason: "no_source" };
+    }
+    const server = parseSemver(serverVersion);
+    if (!server) return { refreshed: false, reason: "unparseable" };
+    const runnerVersion = installedHookRunnerVersion(home);
+    if (runnerVersion !== void 0) {
+      const pinned = parseSemver(runnerVersion);
+      if (!pinned) {
+        return { refreshed: false, reason: "unparseable", runnerVersion };
+      }
+      if (!semverNewer(server, pinned)) {
+        return {
+          refreshed: false,
+          reason: runnerVersion === serverVersion ? "current" : "downgrade",
+          runnerVersion
+        };
+      }
     }
+    installHookRunner(sourceBundle, home, serverVersion);
+    return { refreshed: true, reason: "updated", runnerVersion };
+  } catch {
+    return { refreshed: false, reason: "error" };
   }
-  if (nodes.length > 0) {
-    sections.push(...groupedNodeSections(nodes, state, "## Nodes\n\n"));
-    const relationships = relationshipItems(
-      Array.isArray(container.edges) ? container.edges : [],
-      labelByUid,
-      state
-    );
-    if (relationships.length > 0) {
-      sections.push({ heading: "## Relationships", items: relationships });
+}
+function refreshOwnedClaudeHooks(projectDir = process.cwd(), homeDir) {
+  const refreshed = [];
+  const scopes = ["user", "project"];
+  for (const scope of scopes) {
+    try {
+      const file = settingsPath("claude-code", scope, projectDir, void 0, homeDir);
+      if (!import_node_fs7.default.existsSync(file)) continue;
+      if (!import_node_fs7.default.readFileSync(file, "utf8").includes(OWNER_MARKER)) continue;
+      installHooks(
+        "claude-code",
+        scope,
+        projectDir,
+        void 0,
+        homeDir,
+        storedFeatures(homeDir)
+      );
+      refreshed.push(file);
+    } catch {
     }
   }
-  const mode = str2(body.mode);
-  return assemble(
-    `# Graph traversal${mode ? ` (${mode})` : ""}`,
-    sections,
-    state,
-    maxChars
-  );
+  return refreshed;
 }
-function neighborLine(value) {
-  const node = obj(value);
-  if (!node) return void 0;
-  const label = str2(node.label) || "(unlabeled)";
-  const uid = str2(node.uid);
-  const type = str2(node.node_type);
-  return `- ${label}${uid ? ` [${uid}]` : ""}${type ? ` (${type})` : ""}`;
+function versionSkewNote(serverVersion, homeDir) {
+  const runnerVersion = installedHookRunnerVersion(homeDir);
+  if (!runnerVersion || runnerVersion === serverVersion) return void 0;
+  return `NOTE: the installed MindGraph hook runner is v${runnerVersion} but this MCP server is v${serverVersion} \u2014 hook behavior and tool contracts may be out of sync. Tell the user to run: npx -y mindgraph-mcp@latest install-hooks (refreshes the pinned runner).`;
 }
-function renderOntologyAnswer(response) {
-  const payload = obj(response);
-  if (!payload) return void 0;
-  const objects = Array.isArray(payload.objects) ? payload.objects.filter(isNodeShaped) : isNodeShaped(payload.object) ? [payload.object] : [];
-  const cognitive = obj(payload.cognitive_context);
-  const provenance = Array.isArray(payload.provenance) ? payload.provenance : [];
-  const hasQuerySignature = Array.isArray(payload.objects) || obj(payload.confidence) !== void 0;
-  const cognitiveEmpty = !cognitive || Object.values(cognitive).every((v) => !Array.isArray(v) || v.length === 0);
-  if (objects.length === 0 && cognitiveEmpty && provenance.length === 0) {
-    return hasQuerySignature ? "No matching domain objects." : void 0;
-  }
-  const state = { bounded: false, omitted: 0 };
-  const sections = [];
-  if (objects.length > 0) {
-    sections.push(...groupedNodeSections(objects, state));
+function settingsPath(harness, scope, projectDir = process.cwd(), codexHomeDir = process.env.CODEX_HOME || import_node_path6.default.join(import_node_os5.default.homedir(), ".codex"), homeDir) {
+  if (harness === "codex") {
+    return scope === "user" ? import_node_path6.default.join(codexHomeDir, "hooks.json") : import_node_path6.default.join(projectDir, ".codex", "hooks.json");
   }
-  const labelByUid = /* @__PURE__ */ new Map();
-  for (const node of objects) labelByUid.set(str2(node.uid), str2(node.label) || "?");
-  const graph = obj(payload.graph);
-  for (const raw of Array.isArray(graph?.nodes) ? graph.nodes : []) {
-    const node = obj(raw);
-    const uid = str2(node?.uid);
-    if (uid && !labelByUid.has(uid)) labelByUid.set(uid, str2(node?.label) || "?");
+  return scope === "user" ? import_node_path6.default.join(homeDir || import_node_os5.default.homedir(), ".claude", "settings.json") : import_node_path6.default.join(projectDir, ".claude", "settings.json");
+}
+function readSettings(file) {
+  if (!import_node_fs7.default.existsSync(file)) return {};
+  return JSON.parse(import_node_fs7.default.readFileSync(file, "utf8"));
+}
+function ownedHook(harness, timeout, additionalContextLimit) {
+  return {
+    type: "command",
+    command: command(harness),
+    ...harness === "codex" ? { commandWindows: windowsCommand(harness) } : {},
+    timeout,
+    statusMessage: "Syncing MindGraph session context",
+    ...additionalContextLimit === void 0 ? {} : { additionalContextLimit }
+  };
+}
+function desiredEntries(harness, features = {}) {
+  const common = {
+    SessionStart: [
+      {
+        matcher: harness === "claude-code" ? "startup|resume|clear|compact|fork" : "startup|resume|clear|compact",
+        // B7 live acceptance caught cold SessionStart calls crossing the
+        // inherited 20s edge in both harnesses: the hooks correctly failed
+        // open, but no brief reached the model. The same installed runner
+        // completed in 16.84s once warm. Keep a 30s cold-tenant margin.
+        // The declared Codex context limit must not undercut the brief's own
+        // 9,000-char budget: at 3,000 the harness applied a SECOND, tighter
+        // truncation the renderer knew nothing about.
+        hooks: [
+          ownedHook(
+            harness,
+            30,
+            harness === "codex" ? 1e4 : void 0
+          )
+        ]
+      }
+    ],
+    PreToolUse: [
+      {
+        matcher: "mcp__mindgraph__.*",
+        // Repository resolution over a large multi-repo workspace plus three
+        // git probes can exceed 3s on the first (uncached) call; a killed
+        // PreToolUse means the call goes through untagged.
+        hooks: [ownedHook(harness, 5)]
+      }
+    ],
+    // PostToolUse awaits the lease renewal round-trip, which fires exactly
+    // when the tenant is cold (post-idle reclaim) — 5s killed it mid-claim.
+    // Claude Code: only the tools the hook acts on (MindGraph calls, edits,
+    // and the shell/agent calls that keep a lease alive). Read, Grep and Glob
+    // are most of a session's tool calls and the hook did nothing useful for
+    // them but start a process (roadmap H8). Codex names its tools
+    // differently, so it keeps the catch-all.
+    PostToolUse: [
+      {
+        matcher: harness === "claude-code" ? CLAUDE_POST_TOOL_MATCHER : ".*",
+        hooks: [ownedHook(harness, 10)]
+      }
+    ],
+    Stop: [{ hooks: [ownedHook(harness, 5)] }],
+    // SessionEnd makes up to two sequential cloud calls (abandon_iteration +
+    // session close) — the SAME cold-tenant latency SessionStart needs 30s
+    // for. Claude honors the configured budget; Codex clamps SessionEnd to a
+    // 3s platform cap regardless of this value (see codex-hooks.ts wire
+    // map), so the codex adapter instead makes at most ONE call there.
+    SessionEnd: [
+      { hooks: [ownedHook(harness, harness === "codex" ? 3 : 30)] }
+    ]
+  };
+  if (harness !== "claude-code") return common;
+  return {
+    ...common,
+    TaskCreated: [{ hooks: [ownedHook(harness, 3)] }],
+    TaskCompleted: [{ hooks: [ownedHook(harness, 3)] }],
+    // Bounded recall per prompt: the core gives up at 4s and fails open, so
+    // a 5s budget never holds the prompt longer than that.
+    ...features.promptRecall !== false ? { UserPromptSubmit: [{ hooks: [ownedHook(harness, 5)] }] } : {},
+    // Opt-in transcript capture before compaction (cold-tenant ingest).
+    ...features.capture === true ? { PreCompact: [{ hooks: [ownedHook(harness, 30)] }] } : {}
+  };
+}
+function hookCommand(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const command2 = value.command;
+  return typeof command2 === "string" ? command2 : void 0;
+}
+function entryHasOwnedHook(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const hooks = value.hooks;
+  return Array.isArray(hooks) && hooks.some((hook) => hookCommand(hook)?.includes(OWNER_MARKER));
+}
+function writeSettings(file, settings) {
+  import_node_fs7.default.mkdirSync(import_node_path6.default.dirname(file), { recursive: true });
+  const temporary = `${file}.${process.pid}.${import_node_crypto6.default.randomUUID()}.tmp`;
+  import_node_fs7.default.writeFileSync(temporary, `${JSON.stringify(settings, null, 2)}
+`, {
+    mode: 384
+  });
+  import_node_fs7.default.renameSync(temporary, file);
+}
+function installHooks(harness, scope, projectDir = process.cwd(), codexHomeDir, homeDir, features = {}) {
+  const file = settingsPath(harness, scope, projectDir, codexHomeDir, homeDir);
+  const settings = readSettings(file);
+  const hooks = settings.hooks && typeof settings.hooks === "object" && !Array.isArray(settings.hooks) ? settings.hooks : {};
+  let added = 0;
+  let updated = 0;
+  const desired = desiredEntries(harness, features);
+  for (const optional of ["UserPromptSubmit", "PreCompact"]) {
+    if (optional in desired || !Array.isArray(hooks[optional])) continue;
+    const kept = hooks[optional].filter(
+      (entry) => !entryHasOwnedHook(entry)
+    );
+    if (kept.length > 0) hooks[optional] = kept;
+    else delete hooks[optional];
   }
-  if (cognitive) {
-    for (const rawNodes of Object.values(cognitive)) {
-      if (!Array.isArray(rawNodes)) continue;
-      for (const raw of rawNodes) {
-        const node = obj(raw);
-        const uid = str2(node?.uid);
-        if (uid && !labelByUid.has(uid)) labelByUid.set(uid, str2(node?.label) || "?");
-      }
+  for (const [event, wanted] of Object.entries(desired)) {
+    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) {
+      kept.push(entry);
+      if (hadOwned) updated += 1;
+      else added += 1;
     }
+    hooks[event] = kept;
   }
-  const relations = Array.isArray(payload.relations) ? payload.relations : [];
-  const relationLines = relationshipItems(relations, labelByUid, state, { fallbackToUid: true });
-  if (relationLines.length > 0) {
-    sections.push({ heading: "## Relations", items: relationLines });
-  }
-  if (cognitive) {
-    for (const [category, rawNodes] of Object.entries(cognitive)) {
-      if (!Array.isArray(rawNodes) || rawNodes.length === 0) continue;
-      const items = rawNodes.map(neighborLine).filter((line) => Boolean(line));
-      if (items.length > 0) {
-        sections.push({ heading: `### Cognitive context \u2014 ${category}`, items });
+  settings.hooks = hooks;
+  writeSettings(file, settings);
+  return { path: file, added, updated };
+}
+function uninstallHooks(harness, scope, projectDir = process.cwd(), codexHomeDir) {
+  const file = settingsPath(harness, scope, projectDir, codexHomeDir);
+  if (!import_node_fs7.default.existsSync(file)) return { path: file, removed: 0 };
+  const settings = readSettings(file);
+  const hooks = settings.hooks && typeof settings.hooks === "object" && !Array.isArray(settings.hooks) ? settings.hooks : {};
+  let removed = 0;
+  for (const [event, value] of Object.entries(hooks)) {
+    if (!Array.isArray(value)) continue;
+    const retainedEntries = [];
+    for (const rawEntry of value) {
+      if (!rawEntry || typeof rawEntry !== "object" || Array.isArray(rawEntry)) {
+        retainedEntries.push(rawEntry);
+        continue;
+      }
+      const entry = { ...rawEntry };
+      if (!Array.isArray(entry.hooks)) {
+        retainedEntries.push(entry);
+        continue;
+      }
+      const retainedHooks = entry.hooks.filter((hook) => {
+        const owned = hookCommand(hook)?.includes(OWNER_MARKER) || false;
+        if (owned) removed += 1;
+        return !owned;
+      });
+      if (retainedHooks.length > 0) {
+        entry.hooks = retainedHooks;
+        retainedEntries.push(entry);
       }
     }
+    if (retainedEntries.length > 0) hooks[event] = retainedEntries;
+    else delete hooks[event];
   }
-  if (provenance.length > 0) {
-    const items = provenance.map((raw) => obj(raw)).filter((entry) => Boolean(entry)).map((entry) => {
-      const span = clip(entry.text_span, QUOTE_MAX, state) || "";
-      const by = str2(entry.ingested_by_name);
-      const suffix = `${by ? ` (ingested by ${by})` : ""} [source ${str2(entry.source_uid) || "?"}]`;
-      return str2(entry.span_kind) === "anchor" ? `- "${span}"${suffix}` : `- context: ${span}${suffix}`;
-    });
-    sections.push({ heading: "## Sources", items });
-  }
-  const confidence = num(obj(payload.confidence)?.overall);
-  const notes = [];
-  if (confidence !== void 0) notes.push(`overall confidence ${confidence}`);
-  if (payload.has_more === true) notes.push("more results exist (has_more)");
-  if (payload.seed_cap_hit === true) notes.push("seed cap hit \u2014 narrow the query for a complete set");
-  if (notes.length > 0) sections.push({ heading: `Note: ${notes.join("; ")}.`, items: [] });
-  return assemble(
-    `# Ontology results (${objects.length} object${objects.length === 1 ? "" : "s"})`,
-    sections,
-    state
-  );
+  settings.hooks = hooks;
+  writeSettings(file, settings);
+  return { path: file, removed };
 }
-function renderObjectList(response, title) {
-  const payload = obj(response);
-  if (!payload) return void 0;
-  const rawItems = Array.isArray(payload.items) ? payload.items : Array.isArray(payload.rows) && payload.rows.some((row) => unwrapSearchResult(row)) ? payload.rows : void 0;
-  const items = (rawItems ?? []).map(unwrapSearchResult).filter((node) => Boolean(node));
-  if (items.length === 0) {
-    return rawItems ? `# ${title} (0 results)` : void 0;
-  }
-  const state = { bounded: false, omitted: 0 };
-  const sections = groupedNodeSections(items, state);
-  const total = num(payload.total_count);
-  const truncations = Array.isArray(payload.truncation_reasons) ? payload.truncation_reasons.filter((reason) => typeof reason === "string") : [];
-  const notes = [];
-  if (payload.has_more === true) notes.push("more results exist");
-  if (truncations.length > 0) notes.push(`truncated: ${truncations.join(", ")}`);
-  if (notes.length > 0) sections.push({ heading: `Note: ${notes.join("; ")}.`, items: [] });
-  const count = total !== void 0 && total !== items.length ? `${items.length} of ${total}` : `${items.length}`;
-  return assemble(`# ${title} (${count})`, sections, state);
+function installClaudeHooks(scope, projectDir = process.cwd(), features = {}) {
+  return installHooks("claude-code", scope, projectDir, void 0, void 0, features);
 }
-function renderJobs(response) {
-  const jobs = Array.isArray(response) ? response : obj(response)?.jobs;
-  if (!Array.isArray(jobs)) return void 0;
-  if (jobs.length === 0) return "No ingestion jobs.";
-  const state = { bounded: false, omitted: 0 };
-  const sorted = jobs.map((raw) => obj(raw)).filter((job) => Boolean(job)).sort((a, b) => (num(b.created_at) ?? 0) - (num(a.created_at) ?? 0));
-  const shown = sorted.slice(0, JOBS_RENDER_MAX);
-  if (shown.length < sorted.length) state.bounded = true;
-  const items = shown.map((job) => {
-    const progress = obj(job.progress);
-    const failure = obj(job.error_details);
-    const message = str2(failure?.message) ?? str2(job.error);
-    const done = num(progress?.processed_chunks);
-    const totalChunks = num(progress?.total_chunks);
-    const bits = [
-      str2(job.status) || "?",
-      done !== void 0 && totalChunks !== void 0 ? `${done}/${totalChunks} chunks` : void 0,
-      num(progress?.nodes_created) !== void 0 ? `${num(progress?.nodes_created)} nodes` : void 0,
-      num(job.queue_position) !== void 0 ? `queue #${num(job.queue_position)}` : void 0,
-      message ? `error: ${clip(message, 160, state)}` : void 0,
-      str2(failure?.code) ? `code: ${clip(failure?.code, 80, state)}` : void 0,
-      num(failure?.status) !== void 0 ? `status: ${num(failure?.status)}` : void 0,
-      typeof failure?.retriable === "boolean" ? `retriable: ${failure.retriable}` : void 0
-    ].filter(Boolean);
-    return `- [${str2(job.id) || "?"}] ${clip(job.title, 120, state) || "(untitled)"} \u2014 ${bits.join(", ")}`;
-  });
-  return assemble(
-    `# Ingestion jobs (${shown.length}${shown.length < sorted.length ? ` of ${sorted.length}` : ""})`,
-    [{ heading: "", items }],
-    state
-  );
+function uninstallClaudeHooks(scope, projectDir = process.cwd()) {
+  return uninstallHooks("claude-code", scope, projectDir);
 }
-function renderSignals(response) {
-  const payload = obj(response);
-  if (!payload) return void 0;
-  const state = { bounded: false, omitted: 0 };
-  const sections = [];
-  for (const [key, value] of Object.entries(payload)) {
-    if (!Array.isArray(value) || value.length === 0) continue;
-    const items = value.map((raw) => obj(raw)).filter((item) => Boolean(item)).map((item) => {
-      const fromLabel = str2(item.from_label);
-      const toLabel = str2(item.to_label);
-      const anyLabelKey = Object.keys(item).find(
-        (k) => k.endsWith("_label") && str2(item[k])
-      );
-      const label = str2(item.label) ?? str2(item.title) ?? str2(item.name) ?? (fromLabel && toLabel ? `${fromLabel} \u2194 ${toLabel}` : void 0) ?? (anyLabelKey ? str2(item[anyLabelKey]) : void 0) ?? str2(item.uid) ?? str2(item.target_uid) ?? "(item)";
-      const uid = str2(item.uid) ?? str2(item.target_uid);
-      const numbers = Object.entries(item).filter(([, v]) => typeof v === "number").slice(0, 4).map(([k, v]) => `${k} ${Math.round(v * 100) / 100}`);
-      const lists = Object.entries(item).filter(([, v]) => Array.isArray(v) && v.length > 0).slice(0, 2).map(([k, v]) => `${k}: ${v.length}`);
-      const meta = [...numbers, ...lists].join(", ");
-      return `- ${clip(label, 160, state)}${uid && uid !== label ? ` [${uid}]` : ""}${meta ? ` (${meta})` : ""}`;
-    });
-    if (items.length > 0) {
-      sections.push({ heading: `## ${key.replace(/_/g, " ")}`, items });
-    }
-  }
-  if (sections.length === 0) return void 0;
-  return assemble("# Synthesis signals", sections, state);
+function installCodexHooks(scope, projectDir = process.cwd(), codexHomeDir) {
+  return installHooks("codex", scope, projectDir, codexHomeDir);
 }
-var LABEL_MAX, SUMMARY_MAX, QUOTE_MAX, ARTICLE_MAX, CHUNK_MAX, RELATIONSHIP_MAX, RENDER_CHAR_BUDGET, MIN_RENDER_CHAR_BUDGET, BOUNDED_MARKER_RESERVE, CURATION_EDGE_TYPES, INFRA_NODE_TYPES, JOBS_RENDER_MAX;
-var init_render = __esm({
-  "src/render.ts"() {
+function uninstallCodexHooks(scope, projectDir = process.cwd(), codexHomeDir) {
+  return uninstallHooks("codex", scope, projectDir, codexHomeDir);
+}
+var import_node_fs7, import_node_os5, import_node_path6, import_node_crypto6, OWNER_MARKER, RUNNER_RELATIVE, RUNNER_VERSION_RELATIVE, CLAUDE_POST_TOOL_MATCHER;
+var init_hook_installer = __esm({
+  "src/hook-installer.ts"() {
     "use strict";
-    LABEL_MAX = 200;
-    SUMMARY_MAX = 400;
-    QUOTE_MAX = 180;
-    ARTICLE_MAX = 6e3;
-    CHUNK_MAX = 6e3;
-    RELATIONSHIP_MAX = 40;
-    RENDER_CHAR_BUDGET = 24e3;
-    MIN_RENDER_CHAR_BUDGET = 512;
-    BOUNDED_MARKER_RESERVE = 220;
-    CURATION_EDGE_TYPES = /* @__PURE__ */ new Set(["POSSIBLE_DUPLICATE", "PossibleDuplicate"]);
-    INFRA_NODE_TYPES = /* @__PURE__ */ new Set(["Chunk", "Document", "Article"]);
-    JOBS_RENDER_MAX = 20;
+    import_node_fs7 = __toESM(require("fs"));
+    import_node_os5 = __toESM(require("os"));
+    import_node_path6 = __toESM(require("path"));
+    import_node_crypto6 = __toESM(require("crypto"));
+    init_hook_env();
+    OWNER_MARKER = "--owner mindgraph";
+    RUNNER_RELATIVE = ".mindgraph/bin/mindgraph-hook.cjs";
+    RUNNER_VERSION_RELATIVE = `${RUNNER_RELATIVE}.version`;
+    CLAUDE_POST_TOOL_MATCHER = "mcp__mindgraph__.*|Edit|MultiEdit|Write|NotebookEdit|Bash|Task|Agent";
   }
 });
 
@@ -4583,7 +4788,8 @@ function compactItem(raw, fallbackType) {
     type: fallbackType ?? nodeType2(value),
     label: text(value.label) ?? text(value.document_title),
     truth_status: text(value.truth_status) ?? text(obj2(value.props)?.truth_status),
-    superseded: value.superseded === true ? true : void 0,
+    // `true` from /retrieve, an object naming the replacement from /retrieve/context.
+    superseded: value.superseded ? true : void 0,
     currently_valid: value.currently_valid === false ? false : void 0,
     valid_at_time: value.valid_at_time === false ? false : void 0,
     retrieval_origin: text(value.retrieval_origin),
@@ -4644,6 +4850,10 @@ function resumeCandidates(raw) {
     const item = compactItem(payload[key], key);
     if (item) items.push(item);
   }
+  for (const value of Array.isArray(payload.other_eligible) ? payload.other_eligible : []) {
+    const item = compactItem(value, "Task");
+    if (item) items.push(item);
+  }
   for (const key of ["next_steps", "recent_executions", "blockers", "code_targets"]) {
     for (const value of Array.isArray(payload[key]) ? payload[key] : []) {
       const item = compactItem(value, key.replace(/s$/, ""));
@@ -4688,9 +4898,9 @@ function latestTimestamp(value) {
       for (const item of current) visit(item);
       return;
     }
-    const record = obj2(current);
-    if (!record) return;
-    for (const [key, item] of Object.entries(record)) {
+    const record2 = obj2(current);
+    if (!record2) return;
+    for (const [key, item] of Object.entries(record2)) {
       if (["updated_at", "created_at", "completed_at", "started_at", "observed_at"].includes(key) && typeof item === "string" && !Number.isNaN(Date.parse(item)) && (!latest || Date.parse(item) > Date.parse(latest))) {
         latest = item;
       }
@@ -4714,7 +4924,7 @@ function contextWarnings(raw, rendered2, available, returned) {
       message: `${Math.max(0, available - returned)} structured item(s) were omitted from the rendered context.`
     });
   }
-  if (/"superseded":true/.test(serialized)) {
+  if (/"superseded":(?:true|\{)/.test(serialized)) {
     warnings.push({ code: "superseded_items_present", message: "Some retrieved items are superseded." });
   }
   if (/"currently_valid":false|"valid_at_time":false/.test(serialized)) {
@@ -4763,6 +4973,7 @@ async function handleMemoryTool(client2, args, config = {}) {
   let rendered2;
   let strategy;
   let candidates;
+  let workspace;
   if (mode === "topic") {
     const query = text(args.query);
     if (!query) return error("mode='topic' requires a non-empty query of 1-3 discriminating keywords");
@@ -4785,10 +4996,27 @@ async function handleMemoryTool(client2, args, config = {}) {
     strategy = "retrieve_context";
     candidates = topicCandidates(raw);
   } else {
+    if (args.scope !== void 0 && args.scope !== "workspace") {
+      return error("scope must be 'workspace' when given");
+    }
+    if (args.scope === "workspace") {
+      if (!config.resolveWorkspaceScope) {
+        return error(
+          "scope='workspace' needs the local MindGraph MCP server, which reads .mindgraph/workspace.json beside the checkout; this server has no working directory. Pass scope_uids instead."
+        );
+      }
+      workspace = await config.resolveWorkspaceScope(agentId ?? "mcp");
+      if (workspace.uids.length === 0) {
+        return error(
+          `scope='workspace' resolved no repositories${workspace.failures.length > 0 ? ` (${workspace.failures.join("; ")})` : ""}`
+        );
+      }
+    }
     const scopeUids = Array.from(
       /* @__PURE__ */ new Set([
         ...Array.isArray(args.scope_uids) ? args.scope_uids.map(String) : [],
-        ...text(args.project_uid) ? [text(args.project_uid)] : []
+        ...text(args.project_uid) ? [text(args.project_uid)] : [],
+        ...workspace?.uids ?? []
       ])
     );
     raw = await client2.plan(
@@ -4797,11 +5025,11 @@ async function handleMemoryTool(client2, args, config = {}) {
         task_uid: text(args.task_uid),
         session_uid: text(args.session_uid),
         scope_uids: scopeUids.length > 0 ? scopeUids : void 0,
-        limit: 1,
+        limit: workspace ? WORKSPACE_RESUME_LIMIT : 1,
         agent_id: agentId
       })
     );
-    rendered2 = renderResumeContext(raw, budget) ?? "No eligible work was found in the requested scope.";
+    rendered2 = renderResumeContext(raw, budget, workspace?.names) ?? "No eligible work was found in the requested scope.";
     strategy = "resume_work";
     candidates = resumeCandidates(raw);
   }
@@ -4814,7 +5042,8 @@ async function handleMemoryTool(client2, args, config = {}) {
     project_uid: text(args.project_uid),
     task_uid: text(args.task_uid),
     session_uid: text(args.session_uid),
-    scope_uids: Array.isArray(args.scope_uids) ? args.scope_uids.map(String) : void 0
+    scope_uids: Array.isArray(args.scope_uids) ? args.scope_uids.map(String) : void 0,
+    workspace_repositories: workspace ? Object.values(workspace.names).sort() : void 0
   });
   const contextId = `ctx_${sha2562(
     stableJson2({ mode, scope, strategy, query: text(args.query), rendered_hash: renderedHash })
@@ -4855,7 +5084,15 @@ async function handleMemoryTool(client2, args, config = {}) {
       valid_at: text(args.valid_at),
       latest_source_timestamp: latestTimestamp(raw)
     }),
-    warnings: contextWarnings(raw, rendered2, candidates.length, items.length)
+    warnings: [
+      ...contextWarnings(raw, rendered2, candidates.length, items.length),
+      ...workspace && workspace.failures.length > 0 ? [
+        {
+          code: "workspace_scope_partial",
+          message: `${workspace.failures.length} declared repositories did not resolve and were left out: ${workspace.failures.join("; ")}`
+        }
+      ] : []
+    ]
   };
   return {
     content: [{ type: "text", text: rendered2 }],
@@ -4868,6 +5105,7 @@ var init_memory_tool = __esm({
     "use strict";
     import_node_crypto7 = require("crypto");
     init_render();
+    init_workspace_scope();
     RESULT_SCHEMA_VERSION = "mindgraph.memory.result.v1";
     DEFAULT_OUTPUT_CHARS = 8e3;
     MIN_OUTPUT_CHARS = 512;
@@ -4902,6 +5140,11 @@ var init_memory_tool = __esm({
             items: { type: "string" },
             description: "Optional explicit graph scopes for continuity/resume"
           },
+          scope: {
+            type: "string",
+            enum: ["workspace"],
+            description: "For continuity/resume on a local server: select work across every repository the working directory's .mindgraph/workspace.json declares, and list the other eligible tasks grouped by repository"
+          },
           node_types: {
             type: "array",
             items: { type: "string" },
@@ -5136,12 +5379,12 @@ var init_resources = __esm({
 
 // src/sync-tool.ts
 function safePath(root, candidate) {
-  const absolute = import_node_path6.default.resolve(root, candidate);
-  const relative2 = import_node_path6.default.relative(root, absolute);
-  if (relative2.startsWith("..") || import_node_path6.default.isAbsolute(relative2)) {
+  const absolute = import_node_path7.default.resolve(root, candidate);
+  const relative2 = import_node_path7.default.relative(root, absolute);
+  if (relative2.startsWith("..") || import_node_path7.default.isAbsolute(relative2)) {
     throw new Error(`path escapes repository root: ${candidate}`);
   }
-  if (import_node_fs7.default.existsSync(absolute)) {
+  if (import_node_fs8.default.existsSync(absolute)) {
     if (!pathContains(realPathOf(root), realPathOf(absolute))) {
       throw new Error(`path escapes repository root via symlink: ${candidate}`);
     }
@@ -5150,25 +5393,25 @@ function safePath(root, candidate) {
 }
 function realPathOf(target) {
   try {
-    return import_node_fs7.default.realpathSync(target);
+    return import_node_fs8.default.realpathSync(target);
   } catch {
-    return import_node_path6.default.resolve(target);
+    return import_node_path7.default.resolve(target);
   }
 }
 function markdownFiles(target, realRoot, visited = /* @__PURE__ */ new Set()) {
-  if (!import_node_fs7.default.existsSync(target)) return [];
+  if (!import_node_fs8.default.existsSync(target)) return [];
   const real = realPathOf(target);
   if (!pathContains(realRoot, real)) return [];
-  const stat = import_node_fs7.default.statSync(target);
+  const stat = import_node_fs8.default.statSync(target);
   if (stat.isFile()) return target.endsWith(".md") ? [target] : [];
   if (!stat.isDirectory() || visited.has(real)) return [];
   visited.add(real);
-  return import_node_fs7.default.readdirSync(target, { withFileTypes: true }).flatMap((entry) => markdownFiles(import_node_path6.default.join(target, entry.name), realRoot, visited));
+  return import_node_fs8.default.readdirSync(target, { withFileTypes: true }).flatMap((entry) => markdownFiles(import_node_path7.default.join(target, entry.name), realRoot, visited));
 }
 function fileDescriptor(root, absolute) {
-  const content = import_node_fs7.default.readFileSync(absolute, "utf8");
+  const content = import_node_fs8.default.readFileSync(absolute, "utf8");
   return {
-    logical_path: import_node_path6.default.relative(root, absolute).split(import_node_path6.default.sep).join("/"),
+    logical_path: import_node_path7.default.relative(root, absolute).split(import_node_path7.default.sep).join("/"),
     content_hash: import_node_crypto8.default.createHash("sha256").update(content).digest("hex"),
     bytes: Buffer.byteLength(content),
     content
@@ -5238,7 +5481,7 @@ async function handleSyncTool(client2, args) {
     }
     if (action === "status" && request.logical_path && request.file_present !== false) {
       const absolute = safePath(root, String(request.logical_path));
-      request.file_present = import_node_fs7.default.existsSync(absolute);
+      request.file_present = import_node_fs8.default.existsSync(absolute);
       if (request.file_present && !request.content_hash) {
         request.content_hash = fileDescriptor(root, absolute).content_hash;
       }
@@ -5282,13 +5525,13 @@ async function scanRepository(remote, repository, requested, provider, agentId)
     files: results
   };
 }
-var import_node_crypto8, import_node_fs7, import_node_path6, ok3, err4, SYNC_TOOL;
+var import_node_crypto8, import_node_fs8, import_node_path7, ok3, err4, SYNC_TOOL;
 var init_sync_tool = __esm({
   "src/sync-tool.ts"() {
     "use strict";
     import_node_crypto8 = __toESM(require("crypto"));
-    import_node_fs7 = __toESM(require("fs"));
-    import_node_path6 = __toESM(require("path"));
+    import_node_fs8 = __toESM(require("fs"));
+    import_node_path7 = __toESM(require("path"));
     init_codegraph();
     init_error_detail();
     ok3 = (data) => ({
@@ -7869,14 +8112,14 @@ var init_tools = __esm({
 // src/server.ts
 function buildMindGraphServer(wiring) {
   const { client: client2, hosted } = wiring;
-  const server2 = new import_server.Server(
+  const server = new import_server.Server(
     { name: "mindgraph", version: wiring.serverVersion },
     {
       capabilities: { tools: {}, resources: {}, prompts: {} },
       instructions: wiring.instructions
     }
   );
-  server2.setRequestHandler(import_types.ListToolsRequestSchema, async () => {
+  server.setRequestHandler("tools/list", async () => {
     const generated = await getGeneratedTools(client2, wiring.generatedTools);
     const tools = [...toolsForProfile(wiring.profile), ...generated.tools];
     if (!hosted) return { tools };
@@ -7887,7 +8130,7 @@ function buildMindGraphServer(wiring) {
       ]
     };
   });
-  server2.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
+  server.setRequestHandler("tools/call", async (request) => {
     const { name, arguments: args } = request.params;
     const rawArgs = {
       ...args || {},
@@ -7934,20 +8177,20 @@ function buildMindGraphServer(wiring) {
     }
     return handleTool(client2, name, toolArgs, wiring.memory);
   });
-  server2.setRequestHandler(import_types.ListPromptsRequestSchema, async () => {
+  server.setRequestHandler("prompts/list", async () => {
     return { prompts: PROMPTS };
   });
-  server2.setRequestHandler(import_types.GetPromptRequestSchema, async (request) => {
+  server.setRequestHandler("prompts/get", async (request) => {
     const { name, arguments: args } = request.params;
     return getPrompt(name, args);
   });
-  server2.setRequestHandler(import_types.ListResourcesRequestSchema, async () => {
+  server.setRequestHandler("resources/list", async () => {
     return { resources: RESOURCES };
   });
-  server2.setRequestHandler(import_types.ListResourceTemplatesRequestSchema, async () => {
+  server.setRequestHandler("resources/templates/list", async () => {
     return { resourceTemplates: RESOURCE_TEMPLATES };
   });
-  server2.setRequestHandler(import_types.ReadResourceRequestSchema, async (request) => {
+  server.setRequestHandler("resources/read", async (request) => {
     return readGovernedResource(
       client2,
       request.params.uri,
@@ -7955,15 +8198,13 @@ function buildMindGraphServer(wiring) {
       wiring.memory
     );
   });
-  return server2;
+  return server;
 }
-var import_server, import_webStandardStreamableHttp, import_types;
+var import_server;
 var init_server = __esm({
   "src/server.ts"() {
     "use strict";
-    import_server = require("@modelcontextprotocol/sdk/server/index.js");
-    import_webStandardStreamableHttp = require("@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js");
-    import_types = require("@modelcontextprotocol/sdk/types.js");
+    import_server = require("@modelcontextprotocol/server");
     init_generated_tools();
     init_governance();
     init_hosted_tools();
@@ -7976,22 +8217,24 @@ var init_server = __esm({
 // src/index.ts
 var src_exports = {};
 async function main() {
-  const transport = new import_stdio.StdioServerTransport();
-  await server.connect(transport);
+  (0, import_stdio.serveStdio)(buildServer, {
+    onerror: (error2) => console.error("MindGraph MCP transport error:", error2.message)
+  });
   console.error(
-    `MindGraph MCP server v${"0.24.0"} running on stdio (${BASE_URL})`
+    `MindGraph MCP server v${"0.26.0"} running on stdio (${BASE_URL})`
   );
 }
-var import_stdio, import_node_path7, API_KEY, BASE_URL, AGENT_ID, ORG_ID, PROFILE, HARNESS, client, INSTRUCTIONS, RUNNER_REFRESH, HOOK_SKEW_NOTE, GOVERNANCE_CONFIG, MEMORY_RUNTIME_CONFIG, server;
+var import_stdio, import_node_path8, API_KEY, BASE_URL, AGENT_ID, ORG_ID, PROFILE, HARNESS, client, INSTRUCTIONS, RUNNER_REFRESH, HOOK_SKEW_NOTE, GOVERNANCE_CONFIG, MEMORY_RUNTIME_CONFIG, buildServer;
 var init_src = __esm({
   "src/index.ts"() {
     "use strict";
     init_call_ledger();
-    import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+    import_stdio = require("@modelcontextprotocol/server/stdio");
     init_dist();
     init_hook_env();
     init_server();
-    import_node_path7 = __toESM(require("path"));
+    init_workspace_scope();
+    import_node_path8 = __toESM(require("path"));
     init_hook_installer();
     API_KEY = process.env.MINDGRAPH_API_KEY;
     BASE_URL = process.env.MINDGRAPH_BASE_URL || "https://api.mindgraph.cloud";
@@ -8092,7 +8335,7 @@ Capture knowledge when the user shares something worth remembering:
     }
     RUNNER_REFRESH = (() => {
       try {
-        return refreshHookRunner("0.24.0", import_node_path7.default.join(__dirname, "cli.js"));
+        return refreshHookRunner("0.26.0", import_node_path8.default.join(__dirname, "cli.js"));
       } catch {
         return void 0;
       }
@@ -8106,12 +8349,12 @@ Capture knowledge when the user shares something worth remembering:
         }
       })();
       console.error(
-        `[mindgraph-mcp] refreshed pinned hook runner ${RUNNER_REFRESH.runnerVersion ? `v${RUNNER_REFRESH.runnerVersion}` : "(pre-sidecar)"} \u2192 v${"0.24.0"}` + (refreshedSettings.length > 0 ? `; refreshed owned hook entries in ${refreshedSettings.join(", ")}` : "")
+        `[mindgraph-mcp] refreshed pinned hook runner ${RUNNER_REFRESH.runnerVersion ? `v${RUNNER_REFRESH.runnerVersion}` : "(pre-sidecar)"} \u2192 v${"0.26.0"}` + (refreshedSettings.length > 0 ? `; refreshed owned hook entries in ${refreshedSettings.join(", ")}` : "")
       );
     }
     HOOK_SKEW_NOTE = (() => {
       try {
-        return versionSkewNote("0.24.0");
+        return versionSkewNote("0.26.0");
       } catch {
         return void 0;
       }
@@ -8132,16 +8375,21 @@ ${HOOK_SKEW_NOTE}`;
       }
     };
     MEMORY_RUNTIME_CONFIG = {
-      serverVersion: "0.24.0",
+      serverVersion: "0.26.0",
       baseUrl: BASE_URL,
       profile: PROFILE,
       harness: HARNESS,
       orgId: ORG_ID,
-      agentId: AGENT_ID
+      agentId: AGENT_ID,
+      resolveWorkspaceScope: (agentId) => resolveRepositoryScope(
+        process.env.CLAUDE_PROJECT_DIR || process.cwd(),
+        client,
+        agentId
+      )
     };
-    server = buildMindGraphServer({
+    buildServer = () => buildMindGraphServer({
       client,
-      serverVersion: "0.24.0",
+      serverVersion: "0.26.0",
       instructions: INSTRUCTIONS,
       profile: PROFILE,
       agentId: AGENT_ID,
@@ -8157,8 +8405,8 @@ ${HOOK_SKEW_NOTE}`;
 });
 
 // src/cli.ts
-var fs8 = __toESM(require("fs"));
-var path8 = __toESM(require("path"));
+var fs9 = __toESM(require("fs"));
+var path9 = __toESM(require("path"));
 var os5 = __toESM(require("os"));
 var crypto6 = __toESM(require("crypto"));
 var import_child_process = require("child_process");
@@ -8643,18 +8891,19 @@ async function skillsPush(api, skillPath) {
 
 // src/hook-core.ts
 var import_node_crypto5 = __toESM(require("crypto"));
-var import_node_fs5 = __toESM(require("fs"));
+var import_node_fs6 = __toESM(require("fs"));
 var import_node_os4 = __toESM(require("os"));
-var import_node_path4 = __toESM(require("path"));
+var import_node_path5 = __toESM(require("path"));
 var import_node_child_process2 = require("child_process");
 init_codegraph();
-init_code_tool();
+init_render();
+init_workspace_scope();
 init_call_ledger();
 init_error_detail();
 init_hook_env();
 
 // src/hook-memory.ts
-var import_node_fs4 = __toESM(require("fs"));
+var import_node_fs5 = __toESM(require("fs"));
 var PROMPT_RECALL_LIMIT = 5;
 var PROMPT_RECALL_MAX_CHARS = 4e3;
 var MIN_PROMPT_RECALL_CHARS = 12;
@@ -8724,18 +8973,18 @@ function recallTermOverlap(query, text2) {
 function relevant(query, text2) {
   if (query === void 0) return true;
   const { matched, usable } = recallTermOverlap(query, text2);
-  return usable > 0 && matched >= Math.min(2, usable);
+  return usable >= 2 && matched >= 2;
 }
 var rec = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
-var str = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+var str2 = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
 var oneLine = (value, max) => {
   const flat = value.replace(/\s+/g, " ").trim();
   return flat.length <= max ? flat : `${flat.slice(0, max - 1)}\u2026`;
 };
 var INFRA_TYPES = /* @__PURE__ */ new Set(["Chunk", "Document", "Article", "Session"]);
 function nodeType(node) {
-  const plain = str(node.node_type);
-  return (plain && plain !== "Custom" ? plain : void 0) ?? str(rec(node.node_type)?.Custom) ?? plain ?? "Node";
+  const plain = str2(node.node_type);
+  return (plain && plain !== "Custom" ? plain : void 0) ?? str2(rec(node.node_type)?.Custom) ?? plain ?? "Node";
 }
 function renderPromptRecall(response, query) {
   const payload = rec(response);
@@ -8748,16 +8997,16 @@ function renderPromptRecall(response, query) {
     const type = nodeType(node);
     if (INFRA_TYPES.has(type)) continue;
     const props = rec(node.props);
-    const label = str(node.label) ?? str(props?.label) ?? str(props?.name);
+    const label = str2(node.label) ?? str2(props?.label) ?? str2(props?.name);
     if (!label) continue;
-    const summary = str(node.summary) ?? str(props?.summary) ?? str(props?.description) ?? str(props?.content);
+    const summary = str2(node.summary) ?? str2(props?.summary) ?? str2(props?.description) ?? str2(props?.content);
     const informative = summary && summary !== label ? summary : void 0;
     if (!informative && type === "Entity") continue;
     if (!relevant(query, `${label} ${informative ?? ""}`)) continue;
     const docs = Array.isArray(node.source_documents) ? node.source_documents : [];
-    const source = str(rec(docs[0])?.title);
+    const source = str2(rec(docs[0])?.title);
     let line = `- [${type}] ${oneLine(label, 140)}`;
-    if (node.superseded === true) line += " (superseded)";
+    if (node.superseded) line += " (superseded)";
     if (summary && summary !== label) line += ` \u2014 ${oneLine(summary, 240)}`;
     if (source) line += ` (source: ${oneLine(source, 100)})`;
     lines.push(line);
@@ -8766,9 +9015,9 @@ function renderPromptRecall(response, query) {
   for (const raw of articles) {
     const article = rec(raw);
     if (!article || lines.length >= PROMPT_RECALL_LIMIT) continue;
-    const label = str(article.label);
+    const label = str2(article.label);
     if (!label) continue;
-    const content = str(article.content);
+    const content = str2(article.content);
     if (!relevant(query, `${label} ${content ?? ""}`)) continue;
     lines.push(`- [Article] ${oneLine(label, 140)}${content ? ` \u2014 ${oneLine(content, 240)}` : ""}`);
   }
@@ -8819,7 +9068,7 @@ function renderTranscript(turns) {
   return start >= 0 ? tail.slice(start + 2) : tail;
 }
 function readTranscriptSince(file, offset = 0) {
-  const buffer = import_node_fs4.default.readFileSync(file);
+  const buffer = import_node_fs5.default.readFileSync(file);
   const start = offset > buffer.length ? 0 : offset;
   const lastNewline = buffer.lastIndexOf(10);
   if (lastNewline < start) return { text: "", nextOffset: start };
@@ -8863,33 +9112,33 @@ function defaultLedger(sessionId, options) {
   };
 }
 function runtimeDir(options) {
-  return options.runtimeDir || process.env.MINDGRAPH_RUNTIME_DIR || import_node_path4.default.join(import_node_os4.default.homedir(), ".mindgraph", "runtime");
+  return options.runtimeDir || process.env.MINDGRAPH_RUNTIME_DIR || import_node_path5.default.join(import_node_os4.default.homedir(), ".mindgraph", "runtime");
 }
 function ledgerPath(sessionId, options) {
   const harness = "harness" in options ? options.harness : "claude-code";
   const key = import_node_crypto5.default.createHash("sha256").update(`${harness}\0${sessionId}`).digest("hex");
-  return import_node_path4.default.join(runtimeDir(options), `${key}.json`);
+  return import_node_path5.default.join(runtimeDir(options), `${key}.json`);
 }
 function waitBriefly(ms) {
   Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 }
 function withLedger(sessionId, options, update) {
   const file = ledgerPath(sessionId, options);
-  import_node_fs5.default.mkdirSync(import_node_path4.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs6.default.mkdirSync(import_node_path5.default.dirname(file), { recursive: true, mode: 448 });
   try {
-    import_node_fs5.default.chmodSync(import_node_path4.default.dirname(file), 448);
+    import_node_fs6.default.chmodSync(import_node_path5.default.dirname(file), 448);
   } catch {
   }
   const lock = `${file}.lock`;
   let lockFd;
   for (let attempt = 0; attempt < 400; attempt++) {
     try {
-      lockFd = import_node_fs5.default.openSync(lock, "wx", 384);
+      lockFd = import_node_fs6.default.openSync(lock, "wx", 384);
       break;
     } catch (error2) {
       if (error2.code !== "EEXIST") throw error2;
       try {
-        if (Date.now() - import_node_fs5.default.statSync(lock).mtimeMs > 3e3) import_node_fs5.default.unlinkSync(lock);
+        if (Date.now() - import_node_fs6.default.statSync(lock).mtimeMs > 3e3) import_node_fs6.default.unlinkSync(lock);
       } catch {
       }
       waitBriefly(10);
@@ -8903,25 +9152,25 @@ function withLedger(sessionId, options, update) {
     try {
       ledger = {
         ...ledger,
-        ...JSON.parse(import_node_fs5.default.readFileSync(file, "utf8"))
+        ...JSON.parse(import_node_fs6.default.readFileSync(file, "utf8"))
       };
     } catch {
     }
     const result = update(ledger);
     ledger.updatedAt = Date.now();
     const temporary = `${file}.${process.pid}.${import_node_crypto5.default.randomUUID()}.tmp`;
-    import_node_fs5.default.writeFileSync(temporary, `${JSON.stringify(ledger)}
+    import_node_fs6.default.writeFileSync(temporary, `${JSON.stringify(ledger)}
 `, { mode: 384 });
-    import_node_fs5.default.renameSync(temporary, file);
+    import_node_fs6.default.renameSync(temporary, file);
     try {
-      import_node_fs5.default.chmodSync(file, 384);
+      import_node_fs6.default.chmodSync(file, 384);
     } catch {
     }
     return result;
   } finally {
-    import_node_fs5.default.closeSync(lockFd);
+    import_node_fs6.default.closeSync(lockFd);
     try {
-      import_node_fs5.default.unlinkSync(lock);
+      import_node_fs6.default.unlinkSync(lock);
     } catch {
     }
   }
@@ -9031,6 +9280,11 @@ function renderBrief(brief, meta) {
     );
     const description = clipTracked(props?.description, 400);
     if (description) lines.push(`  ${description}`);
+    const taskScopes = Array.isArray(brief?.task_scope_uids) ? brief.task_scope_uids.map(String) : [];
+    const taskRepository = taskScopes.map((uid) => meta.repositoryNames?.[uid]).find(Boolean);
+    if (taskRepository && Object.keys(meta.repositoryNames ?? {}).length > 1) {
+      lines.push(`Repository: ${taskRepository}`);
+    }
     const reason = string(brief?.selection_reason);
     if (reason) lines.push(`Selection: ${reason}`);
     const lease = object(brief?.claim) || object(brief?.lease);
@@ -9076,6 +9330,8 @@ ${blockerLines.join("\n")}`);
     }
   }
   const optional = [];
+  const otherWork = renderOtherEligibleWork(brief, meta.repositoryNames);
+  if (otherWork) optional.push(otherWork);
   const knowledge = Array.isArray(brief?.knowledge) ? brief.knowledge : [];
   if (knowledge.length > 5) bounded = true;
   const knowledgeLines = knowledge.slice(0, 5).map((item) => nodeLine(item, 350)).filter(Boolean);
@@ -9112,62 +9368,6 @@ ${knowledgeLines.join("\n")}`);
   return rendered2.length <= BRIEF_CHAR_BUDGET ? rendered2 : `${rendered2.slice(0, BRIEF_CHAR_BUDGET - 40)}
 \u2026[bounded work brief truncated]`;
 }
-async function repositoryScopeUids(input, client2, options, agentId) {
-  if (!client2.entity) return { uids: [], failures: [] };
-  const adapter = new CodegraphAdapter({
-    cwd: input.cwd,
-    workspaceFile: options.workspaceFile
-  });
-  const configured = await adapter.resolveRepositories();
-  const repositories = configured.length > 0 ? configured : [await adapter.resolveRepository()];
-  const failures = [];
-  const resolved = await Promise.all(
-    repositories.map(async (repository) => {
-      try {
-        const payload = object(
-          await client2.entity({
-            action: "resolve_identity",
-            identity: {
-              namespace: "external.code",
-              key_version: 1,
-              key: repositoryIdentityKey(repository)
-            },
-            agent_id: agentId
-          })
-        );
-        if (payload?.status === "existing" && string(payload.uid)) {
-          return string(payload.uid);
-        }
-        if (payload?.status === "absent") {
-          const anchored = await anchorRepository(
-            client2,
-            repository,
-            repository.spaceUid ?? `space:agent:${agentId}`,
-            agentId
-          );
-          if (anchored?.uid) return anchored.uid;
-          failures.push(
-            `${repository.repoId}: anchor ${anchored?.status ?? "failed"}`
-          );
-          return void 0;
-        }
-        failures.push(
-          `${repository.repoId}: ${string(payload?.status) || "unresolved"}`
-        );
-        return void 0;
-      } catch (error2) {
-        failures.push(
-          `${repository.repoId}: ${error2?.message || "resolve failed"}`
-        );
-        return void 0;
-      }
-    })
-  );
-  return {
-    uids: [...new Set(resolved.filter((uid) => Boolean(uid)))],
-    failures
-  };
-}
 function isOwnPriorWork(brief, agentId, harness) {
   const reason = string(brief?.selection_reason);
   if (reason === "owned_live_lease" || reason === "same_agent_session_rebind") {
@@ -9191,30 +9391,30 @@ function hasMindgraphServer(servers) {
   return false;
 }
 function pathIsWithin(ancestor, descendant) {
-  const base = import_node_path4.default.resolve(ancestor);
-  const target = import_node_path4.default.resolve(descendant);
-  return target === base || target.startsWith(base + import_node_path4.default.sep);
+  const base = import_node_path5.default.resolve(ancestor);
+  const target = import_node_path5.default.resolve(descendant);
+  return target === base || target.startsWith(base + import_node_path5.default.sep);
 }
 function claudeMcpRegistrationNote(input, options) {
   if (options.harness !== "claude-code") return void 0;
   if (process.env.MINDGRAPH_SKIP_MCP_REGISTRATION_CHECK === "1") return void 0;
   try {
-    const configPath = options.claudeConfigPath || import_node_path4.default.join(import_node_os4.default.homedir(), ".claude.json");
-    if (!import_node_fs5.default.existsSync(configPath)) return void 0;
-    const config = JSON.parse(import_node_fs5.default.readFileSync(configPath, "utf8"));
+    const configPath = options.claudeConfigPath || import_node_path5.default.join(import_node_os4.default.homedir(), ".claude.json");
+    if (!import_node_fs6.default.existsSync(configPath)) return void 0;
+    const config = JSON.parse(import_node_fs6.default.readFileSync(configPath, "utf8"));
     if (hasMindgraphServer(config.mcpServers)) return void 0;
-    const cwd = import_node_path4.default.resolve(input.cwd || ".");
+    const cwd = import_node_path5.default.resolve(input.cwd || ".");
     for (const [projectDir, project] of Object.entries(config.projects || {})) {
       if (!pathIsWithin(projectDir, cwd)) continue;
       if (hasMindgraphServer(project?.mcpServers)) return void 0;
     }
-    for (let dir = cwd; ; dir = import_node_path4.default.dirname(dir)) {
-      const candidate = import_node_path4.default.join(dir, ".mcp.json");
-      if (import_node_fs5.default.existsSync(candidate)) {
-        const parsed = JSON.parse(import_node_fs5.default.readFileSync(candidate, "utf8"));
+    for (let dir = cwd; ; dir = import_node_path5.default.dirname(dir)) {
+      const candidate = import_node_path5.default.join(dir, ".mcp.json");
+      if (import_node_fs6.default.existsSync(candidate)) {
+        const parsed = JSON.parse(import_node_fs6.default.readFileSync(candidate, "utf8"));
         if (hasMindgraphServer(parsed.mcpServers)) return void 0;
       }
-      if (dir === import_node_path4.default.dirname(dir)) break;
+      if (dir === import_node_path5.default.dirname(dir)) break;
     }
   } catch {
     return void 0;
@@ -9244,7 +9444,10 @@ async function sessionStart(input, client2, options) {
       return void 0;
     });
   }
-  const scope = await repositoryScopeUids(input, client2, options, agentId);
+  const scope = await resolveRepositoryScope(input.cwd, client2, agentId, {
+    workspaceFile: options.workspaceFile,
+    cache: options.scopeCacheTenant ? { dir: runtimeDir(options), tenant: options.scopeCacheTenant } : void 0
+  });
   if (scope.failures.length > 0) {
     console.error(
       `mindgraph-hook: ${scope.failures.length} repository scope(s) failed to resolve (${scope.failures.join("; ")}); resume runs ${scope.uids.length > 0 ? "narrowed" : "UNSCOPED"}`
@@ -9256,9 +9459,17 @@ async function sessionStart(input, client2, options) {
       action: "resume_work",
       session_uid: sessionUid,
       ...scopeUids.length > 0 ? { scope_uids: scopeUids } : {},
+      // Above several repositories one task is not the picture: ask for the
+      // work ranked behind it too. An older server ignores the field.
+      ...scopeUids.length > 1 ? { limit: WORKSPACE_RESUME_LIMIT } : {},
       agent_id: agentId
     })
   );
+  const workspaceList = {
+    task_scope_uids: brief?.task_scope_uids,
+    other_eligible: brief?.other_eligible,
+    eligible_total: brief?.eligible_total
+  };
   const task = object(brief?.task);
   const lease = object(brief?.lease);
   const prior = readLedger(input.session_id, options);
@@ -9297,7 +9508,7 @@ async function sessionStart(input, client2, options) {
             agent_id: agentId
           })
         );
-        if (reResumed) brief = reResumed;
+        if (reResumed) brief = { ...reResumed, ...workspaceList };
       } catch {
       }
       if (brief) brief.claim = claimed;
@@ -9308,7 +9519,8 @@ async function sessionStart(input, client2, options) {
   const briefText = renderBrief(brief || { status: "no_eligible_work" }, {
     claimed: Boolean(claimed) || stillHeld,
     claimFailed: claimFailed && !stillHeld,
-    scopeNote
+    scopeNote,
+    repositoryNames: scope.names
   });
   const registrationNote = claudeMcpRegistrationNote(input, options);
   if (registrationNote) {
@@ -9755,7 +9967,7 @@ function previewCapture(transcriptPath, sessionId, options = {}) {
   let ledger = {};
   try {
     ledger = JSON.parse(
-      import_node_fs5.default.readFileSync(
+      import_node_fs6.default.readFileSync(
         ledgerPath(sessionId, { ...options, harness: "claude-code" }),
         "utf8"
       )
@@ -9776,13 +9988,13 @@ function readHookStats(sessionId, options = {}) {
   let best;
   let names = [];
   try {
-    names = import_node_fs5.default.readdirSync(dir).filter((name) => /^[0-9a-f]{64}\.json$/.test(name));
+    names = import_node_fs6.default.readdirSync(dir).filter((name) => /^[0-9a-f]{64}\.json$/.test(name));
   } catch {
     return void 0;
   }
   for (const name of names) {
     try {
-      const ledger = JSON.parse(import_node_fs5.default.readFileSync(import_node_path4.default.join(dir, name), "utf8"));
+      const ledger = JSON.parse(import_node_fs6.default.readFileSync(import_node_path5.default.join(dir, name), "utf8"));
       if (!ledger.harnessSessionId || !ledger.hookStats) continue;
       if (sessionId && ledger.harnessSessionId !== sessionId) continue;
       const updatedAt = Number(ledger.updatedAt) || 0;
@@ -9861,15 +10073,15 @@ async function runCodexHook(input, client2, options = {}) {
 init_hook_installer();
 function recordHookHealth(harness, error2) {
   try {
-    const dir = process.env.MINDGRAPH_RUNTIME_DIR || path8.join(os5.homedir(), ".mindgraph", "runtime");
-    fs8.mkdirSync(dir, { recursive: true, mode: 448 });
-    const file = path8.join(dir, "hook-health.json");
+    const dir = process.env.MINDGRAPH_RUNTIME_DIR || path9.join(os5.homedir(), ".mindgraph", "runtime");
+    fs9.mkdirSync(dir, { recursive: true, mode: 448 });
+    const file = path9.join(dir, "hook-health.json");
     let failures = 0;
     try {
-      failures = Number(JSON.parse(fs8.readFileSync(file, "utf8")).consecutiveFailures) || 0;
+      failures = Number(JSON.parse(fs9.readFileSync(file, "utf8")).consecutiveFailures) || 0;
     } catch {
     }
-    fs8.writeFileSync(
+    fs9.writeFileSync(
       file,
       `${JSON.stringify({
         harness,
@@ -9885,14 +10097,14 @@ function recordHookHealth(harness, error2) {
 }
 function clearHookHealth(harness) {
   try {
-    const file = path8.join(
-      process.env.MINDGRAPH_RUNTIME_DIR || path8.join(os5.homedir(), ".mindgraph", "runtime"),
+    const file = path9.join(
+      process.env.MINDGRAPH_RUNTIME_DIR || path9.join(os5.homedir(), ".mindgraph", "runtime"),
       "hook-health.json"
     );
-    if (!fs8.existsSync(file)) return;
-    const current = JSON.parse(fs8.readFileSync(file, "utf8"));
+    if (!fs9.existsSync(file)) return;
+    const current = JSON.parse(fs9.readFileSync(file, "utf8"));
     if (!Number(current.consecutiveFailures)) return;
-    fs8.writeFileSync(
+    fs9.writeFileSync(
       file,
       `${JSON.stringify({
         harness,
@@ -9908,7 +10120,7 @@ function clearHookHealth(harness) {
 function getClaudeDesktopConfigPath() {
   switch (process.platform) {
     case "darwin":
-      return path8.join(
+      return path9.join(
         os5.homedir(),
         "Library",
         "Application Support",
@@ -9916,13 +10128,13 @@ function getClaudeDesktopConfigPath() {
         "claude_desktop_config.json"
       );
     case "win32":
-      return path8.join(
-        process.env.APPDATA || path8.join(os5.homedir(), "AppData", "Roaming"),
+      return path9.join(
+        process.env.APPDATA || path9.join(os5.homedir(), "AppData", "Roaming"),
         "Claude",
         "claude_desktop_config.json"
       );
     case "linux":
-      return path8.join(
+      return path9.join(
         os5.homedir(),
         ".config",
         "Claude",
@@ -9933,16 +10145,16 @@ function getClaudeDesktopConfigPath() {
   }
 }
 function readJsonFile(filePath) {
-  if (!fs8.existsSync(filePath)) return {};
-  const content = fs8.readFileSync(filePath, "utf-8");
+  if (!fs9.existsSync(filePath)) return {};
+  const content = fs9.readFileSync(filePath, "utf-8");
   return JSON.parse(content);
 }
 function writeJsonFile(filePath, data) {
-  const dir = path8.dirname(filePath);
-  if (!fs8.existsSync(dir)) {
-    fs8.mkdirSync(dir, { recursive: true });
+  const dir = path9.dirname(filePath);
+  if (!fs9.existsSync(dir)) {
+    fs9.mkdirSync(dir, { recursive: true });
   }
-  fs8.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+  fs9.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
 }
 function getMcpServerEntry(apiKey, baseUrl) {
   const env = { MINDGRAPH_API_KEY: apiKey };
@@ -10029,7 +10241,7 @@ function installClaudeCode(apiKey, baseUrl, agentId) {
 }
 function uninstallClaudeDesktop() {
   const configPath = getClaudeDesktopConfigPath();
-  if (!fs8.existsSync(configPath)) {
+  if (!fs9.existsSync(configPath)) {
     console.log("Claude Desktop config not found. Nothing to remove.");
     return;
   }
@@ -10056,7 +10268,7 @@ function uninstallClaudeCode() {
 }
 function printStatus() {
   const desktopPath = getClaudeDesktopConfigPath();
-  if (fs8.existsSync(desktopPath)) {
+  if (fs9.existsSync(desktopPath)) {
     const config = readJsonFile(desktopPath);
     const servers = config.mcpServers;
     if (servers && "mindgraph" in servers) {
@@ -10074,12 +10286,12 @@ function printStatus() {
     `MINDGRAPH_BASE_URL: ${process.env.MINDGRAPH_BASE_URL || "https://api.mindgraph.cloud (default)"}`
   );
   try {
-    const healthFile = path8.join(
-      process.env.MINDGRAPH_RUNTIME_DIR || path8.join(os5.homedir(), ".mindgraph", "runtime"),
+    const healthFile = path9.join(
+      process.env.MINDGRAPH_RUNTIME_DIR || path9.join(os5.homedir(), ".mindgraph", "runtime"),
       "hook-health.json"
     );
-    if (fs8.existsSync(healthFile)) {
-      const health = JSON.parse(fs8.readFileSync(healthFile, "utf8"));
+    if (fs9.existsSync(healthFile)) {
+      const health = JSON.parse(fs9.readFileSync(healthFile, "utf8"));
       const failures = Number(health.consecutiveFailures) || 0;
       console.log(
         failures > 0 ? `Hooks: FAILING (${failures} consecutive; last: ${health.lastError} at ${health.lastFailureAt})` : `Hooks: healthy (last recovery ${health.lastOkAt || "unknown"})`
@@ -10108,21 +10320,21 @@ function printClaudeHookFeatures(features) {
   );
 }
 function latestTranscript(cwd) {
-  const dir = path8.join(
+  const dir = path9.join(
     os5.homedir(),
     ".claude",
     "projects",
     cwd.replace(/[^A-Za-z0-9]/g, "-")
   );
   try {
-    return fs8.readdirSync(dir).filter((name) => name.endsWith(".jsonl")).map((name) => path8.join(dir, name)).sort((a, b) => fs8.statSync(b).mtimeMs - fs8.statSync(a).mtimeMs)[0];
+    return fs9.readdirSync(dir).filter((name) => name.endsWith(".jsonl")).map((name) => path9.join(dir, name)).sort((a, b) => fs9.statSync(b).mtimeMs - fs9.statSync(a).mtimeMs)[0];
   } catch {
     return void 0;
   }
 }
 function finishCodeInstall(apiKey, baseUrl, withHooks, agentId) {
   if (withHooks) {
-    const runner = installHookRunner(__filename, void 0, "0.24.0");
+    const runner = installHookRunner(__filename, void 0, "0.26.0");
     console.log(`Installed pinned hook runner at ${runner}`);
     const features = claudeHookFeatures();
     const result = installClaudeHooks("user", void 0, features);
@@ -10450,7 +10662,7 @@ ${total} skill(s) synced.`);
       if (hookHarness !== "claude-code" && hookHarness !== "codex") {
         throw new Error("--harness must be claude-code or codex");
       }
-      const runner = installHookRunner(__filename, void 0, "0.24.0");
+      const runner = installHookRunner(__filename, void 0, "0.26.0");
       console.log(`Installed pinned hook runner at ${runner}`);
       const features = hookHarness === "claude-code" ? claudeHookFeatures() : void 0;
       const result = hookHarness === "codex" ? installCodexHooks(scope, projectDir) : installClaudeHooks(scope, projectDir, features);
@@ -10525,7 +10737,14 @@ ${total} skill(s) synced.`);
           // No harness-name fallback here: hook-core derives a stable
           // per-user default shared by both harnesses, which is what lets a
           // task claimed under Codex rebind under Claude Code.
-          agentId: process.env.MINDGRAPH_AGENT_ID || stored.agentId
+          agentId: process.env.MINDGRAPH_AGENT_ID || stored.agentId,
+          scopeCacheTenant: crypto6.createHash("sha256").update(
+            [
+              hookBaseUrl || "https://api.mindgraph.cloud",
+              hookApiKey,
+              process.env.MINDGRAPH_ORG_ID || stored.orgId || ""
+            ].join("\n")
+          ).digest("hex").slice(0, 16)
         };
         const output = hookHarness === "codex" ? await runCodexHook(
           input,
@@ -10583,13 +10802,13 @@ ${total} skill(s) synced.`);
         process.exit(1);
       }
       const transcript = positionals[1] || latestTranscript(process.cwd());
-      if (!transcript || !fs8.existsSync(transcript)) {
+      if (!transcript || !fs9.existsSync(transcript)) {
         console.error(
           "No transcript found. Pass a Claude Code transcript path (~/.claude/projects/<dir>/<session>.jsonl)."
         );
         process.exit(1);
       }
-      const sessionId = parseArgs(process.argv).sessionId || path8.basename(transcript, ".jsonl");
+      const sessionId = parseArgs(process.argv).sessionId || path9.basename(transcript, ".jsonl");
       const preview = previewCapture(transcript, sessionId, {
         agentId: process.env.MINDGRAPH_AGENT_ID || loadHookEnv().agentId
       });