memorix 1.8.1 → 1.8.3

package/dist/index.js

@@ -3279,8 +3279,10 @@ function loadEnvFile(filePath) {
   loadedEnvFiles.push(filePath);
 }
 function loadDotenv(projectRoot, options = {}) {
-  if (dotenvLoaded && dotenvProjectRoot === (projectRoot ?? null)) return;
-  if (dotenvLoaded && dotenvProjectRoot !== (projectRoot ?? null)) {
+  const userHomeDir = options.userHomeDir ?? homedir4();
+  const normalizedProjectRoot = projectRoot ?? null;
+  if (dotenvLoaded && dotenvProjectRoot === normalizedProjectRoot && dotenvHomeDir === userHomeDir) return;
+  if (dotenvLoaded && (dotenvProjectRoot !== normalizedProjectRoot || dotenvHomeDir !== userHomeDir)) {
     resetDotenv();
   }
   loadedEnvFiles.length = 0;
@@ -3289,9 +3291,10 @@ function loadDotenv(projectRoot, options = {}) {
   if (projectRoot) {
     loadEnvFile(getProjectDotenvPath(projectRoot));
   }
-  loadEnvFile(getGlobalDotenvPath(options.userHomeDir ?? homedir4()));
+  loadEnvFile(getGlobalDotenvPath(userHomeDir));
   dotenvLoaded = true;
-  dotenvProjectRoot = projectRoot ?? null;
+  dotenvProjectRoot = normalizedProjectRoot;
+  dotenvHomeDir = userHomeDir;
 }
 function resetDotenv() {
   for (const key of injectedKeys) {
@@ -3300,6 +3303,7 @@ function resetDotenv() {
   injectedKeys.clear();
   dotenvLoaded = false;
   dotenvProjectRoot = null;
+  dotenvHomeDir = null;
   loadedEnvFiles.length = 0;
   loadedEnvKeys.clear();
 }
@@ -3312,7 +3316,7 @@ function getLoadedEnvKeys() {
 function getLoadedEnvValue(key) {
   return loadedEnvValues.get(key);
 }
-var dotenvLoaded, dotenvProjectRoot, loadedEnvFiles, loadedEnvKeys, loadedEnvValues, injectedKeys;
+var dotenvLoaded, dotenvProjectRoot, dotenvHomeDir, loadedEnvFiles, loadedEnvKeys, loadedEnvValues, injectedKeys;
 var init_dotenv_loader = __esm({
   "src/config/dotenv-loader.ts"() {
     "use strict";
@@ -3320,6 +3324,7 @@ var init_dotenv_loader = __esm({
     init_config_paths();
     dotenvLoaded = false;
     dotenvProjectRoot = null;
+    dotenvHomeDir = null;
     loadedEnvFiles = [];
     loadedEnvKeys = /* @__PURE__ */ new Set();
     loadedEnvValues = /* @__PURE__ */ new Map();
@@ -3671,33 +3676,33 @@ __export(config_exports, {
   resetConfigCache: () => resetConfigCache,
   resetDotenv: () => resetDotenv
 });
-function getLLMApiKey() {
-  return getResolvedMemoryLane().llm.apiKey;
+function getLLMApiKey(options = {}) {
+  return getResolvedMemoryLane(options).llm.apiKey;
 }
-function getLLMProvider() {
-  const provider2 = getResolvedMemoryLane().llm.provider;
+function getLLMProvider(options = {}) {
+  const provider2 = getResolvedMemoryLane(options).llm.provider;
   if (provider2) return provider2;
   if (process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY) return "anthropic";
   if (process.env.OPENROUTER_API_KEY && !process.env.OPENAI_API_KEY) return "openrouter";
   return "openai";
 }
-function getLLMModel(providerDefault) {
-  return getResolvedMemoryLane().llm.model || providerDefault;
+function getLLMModel(providerDefault, options = {}) {
+  return getResolvedMemoryLane(options).llm.model || providerDefault;
 }
-function getLLMBaseUrl(providerDefault) {
-  return getResolvedMemoryLane().llm.baseUrl || providerDefault;
+function getLLMBaseUrl(providerDefault, options = {}) {
+  return getResolvedMemoryLane(options).llm.baseUrl || providerDefault;
 }
-function getAgentLLMApiKey() {
-  return getResolvedAgentLane().apiKey;
+function getAgentLLMApiKey(options = {}) {
+  return getResolvedAgentLane(options).apiKey;
 }
-function getAgentLLMProvider() {
-  return getResolvedAgentLane().provider || getLLMProvider();
+function getAgentLLMProvider(options = {}) {
+  return getResolvedAgentLane(options).provider || getLLMProvider(options);
 }
-function getAgentLLMModel(providerDefault) {
-  return getResolvedAgentLane().model || getLLMModel(providerDefault);
+function getAgentLLMModel(providerDefault, options = {}) {
+  return getResolvedAgentLane(options).model || getLLMModel(providerDefault, options);
 }
-function getAgentLLMBaseUrl(providerDefault) {
-  return getResolvedAgentLane().baseUrl || getLLMBaseUrl(providerDefault);
+function getAgentLLMBaseUrl(providerDefault, options = {}) {
+  return getResolvedAgentLane(options).baseUrl || getLLMBaseUrl(providerDefault, options);
 }
 function getEmbeddingMode() {
   const provider2 = getResolvedEmbeddingLane().provider?.toLowerCase()?.trim();
@@ -5956,18 +5961,19 @@ async function* callLLMWithToolsStream(messages, tools) {
 }
 function initLLM(options = {}) {
   const scope = options.scope ?? "memory";
-  const apiKey = scope === "agent" ? getAgentLLMApiKey() : getLLMApiKey();
+  const configOptions = { projectRoot: options.projectRoot, homeDir: options.homeDir };
+  const apiKey = scope === "agent" ? getAgentLLMApiKey(configOptions) : getLLMApiKey(configOptions);
   if (!apiKey) {
     currentConfig = null;
     return null;
   }
-  const provider2 = scope === "agent" ? getAgentLLMProvider() : getLLMProvider();
+  const provider2 = scope === "agent" ? getAgentLLMProvider(configOptions) : getLLMProvider(configOptions);
   const defaults2 = PROVIDER_DEFAULTS[provider2] ?? PROVIDER_DEFAULTS.openai;
   currentConfig = {
     provider: provider2,
     apiKey,
-    model: scope === "agent" ? getAgentLLMModel(defaults2.model) : getLLMModel(defaults2.model),
-    baseUrl: scope === "agent" ? getAgentLLMBaseUrl(defaults2.baseUrl) : getLLMBaseUrl(defaults2.baseUrl)
+    model: scope === "agent" ? getAgentLLMModel(defaults2.model, configOptions) : getLLMModel(defaults2.model, configOptions),
+    baseUrl: scope === "agent" ? getAgentLLMBaseUrl(defaults2.baseUrl, configOptions) : getLLMBaseUrl(defaults2.baseUrl, configOptions)
   };
   return currentConfig;
 }
@@ -65987,11 +65993,11 @@ var require_bignumber = __commonJS({
         return n > 0 || n === i2 ? i2 : i2 - 1;
       }
       function coeffToString(a) {
-        var s2, z627, i2 = 1, j = a.length, r2 = a[0] + "";
+        var s2, z628, i2 = 1, j = a.length, r2 = a[0] + "";
         for (; i2 < j; ) {
           s2 = a[i2++] + "";
-          z627 = LOG_BASE - s2.length;
-          for (; z627--; s2 = "0" + s2) ;
+          z628 = LOG_BASE - s2.length;
+          for (; z628--; s2 = "0" + s2) ;
           r2 += s2;
         }
         for (j = r2.length; r2.charCodeAt(--j) === 48; ) ;
@@ -66024,15 +66030,15 @@ var require_bignumber = __commonJS({
       function toExponential(str2, e2) {
         return (str2.length > 1 ? str2.charAt(0) + "." + str2.slice(1) : str2) + (e2 < 0 ? "e" : "e+") + e2;
       }
-      function toFixedPoint(str2, e2, z627) {
+      function toFixedPoint(str2, e2, z628) {
         var len, zs;
         if (e2 < 0) {
-          for (zs = z627 + "."; ++e2; zs += z627) ;
+          for (zs = z628 + "."; ++e2; zs += z628) ;
           str2 = zs + str2;
         } else {
           len = str2.length;
           if (++e2 > len) {
-            for (zs = z627, e2 -= len; --e2; zs += z627) ;
+            for (zs = z628, e2 -= len; --e2; zs += z628) ;
             str2 += zs;
           } else if (e2 < len) {
             str2 = str2.slice(0, e2) + "." + str2.slice(e2);
@@ -158111,6 +158117,74 @@ var init_request_context = __esm({
   }
 });
 
+// src/server/mcp-discovery.ts
+function getMcpServerInfo() {
+  return {
+    name: "memorix",
+    version: true ? "1.8.3" : "1.0.1"
+  };
+}
+function createMcpDiscoverResult(capabilities, serverInfo) {
+  return {
+    resultType: "complete",
+    supportedVersions: [
+      MCP_MODERN_PROTOCOL_VERSION,
+      MCP_LEGACY_PROTOCOL_VERSION,
+      MCP_OLDEST_LEGACY_PROTOCOL_VERSION
+    ],
+    capabilities,
+    _meta: {
+      [MCP_SERVER_INFO_META_KEY]: { ...serverInfo }
+    },
+    // v1 has no response-cache negotiation. A zero private TTL prevents clients
+    // from inventing a shared cache for an implementation that cannot invalidate it.
+    ttlMs: 0,
+    cacheScope: "private"
+  };
+}
+function createMcpStartupDiscoverResult(serverInfo) {
+  return createMcpDiscoverResult({ tools: { listChanged: true } }, serverInfo);
+}
+var MCP_MODERN_PROTOCOL_VERSION, MCP_LEGACY_PROTOCOL_VERSION, MCP_OLDEST_LEGACY_PROTOCOL_VERSION, MCP_SERVER_DISCOVER_METHOD, MCP_SERVER_INFO_META_KEY;
+var init_mcp_discovery = __esm({
+  "src/server/mcp-discovery.ts"() {
+    "use strict";
+    init_esm_shims();
+    MCP_MODERN_PROTOCOL_VERSION = "2026-07-28";
+    MCP_LEGACY_PROTOCOL_VERSION = "2025-11-25";
+    MCP_OLDEST_LEGACY_PROTOCOL_VERSION = "2024-11-05";
+    MCP_SERVER_DISCOVER_METHOD = "server/discover";
+    MCP_SERVER_INFO_META_KEY = "io.modelcontextprotocol/serverInfo";
+  }
+});
+
+// src/server/mcp-compat.ts
+import { RequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { z as z625 } from "zod/v4";
+function buildMcpDiscoverResult(server, serverInfo) {
+  const getCapabilities = server.server.getCapabilities.bind(server.server);
+  return createMcpDiscoverResult(getCapabilities(), serverInfo);
+}
+function registerMcpDiscovery(server, serverInfo) {
+  if (registeredServers.has(server)) return;
+  server.server.setRequestHandler(ServerDiscoverRequestSchema, async () => buildMcpDiscoverResult(server, serverInfo));
+  registeredServers.add(server);
+}
+var ServerDiscoverRequestSchema, registeredServers;
+var init_mcp_compat = __esm({
+  "src/server/mcp-compat.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_mcp_discovery();
+    init_mcp_discovery();
+    ServerDiscoverRequestSchema = RequestSchema.extend({
+      method: z625.literal(MCP_SERVER_DISCOVER_METHOD),
+      params: z625.looseObject({}).optional()
+    });
+    registeredServers = /* @__PURE__ */ new WeakSet();
+  }
+});
+
 // src/runtime/maintenance-targets.ts
 var maintenance_targets_exports = {};
 __export(maintenance_targets_exports, {
@@ -159841,6 +159915,27 @@ function unavailableHealth(result) {
   if (result.outputLimited) return { state: "invalid", reason: "A local CodeGraph response exceeded the safety limit." };
   return { state: "unavailable", reason: "A local CodeGraph command did not complete." };
 }
+function notAttemptedDiagnostic(command) {
+  return { command, attempted: false, outcome: "not-attempted" };
+}
+function commandDiagnostic(command, result, outcome, reason) {
+  return {
+    command,
+    attempted: true,
+    outcome,
+    ...typeof result.exitCode === "number" ? { exitCode: result.exitCode } : {},
+    ...reason ? { reason: sanitizeCredentials(reason).slice(0, 240) } : {}
+  };
+}
+function failedCommandDiagnostic(command, result) {
+  const outcome = result.timedOut ? "timed-out" : result.outputLimited ? "output-limited" : "failed";
+  return commandDiagnostic(
+    command,
+    result,
+    outcome,
+    result.error || result.stderr || "CodeGraph command did not complete."
+  );
+}
 async function runSafely(runner, input) {
   try {
     return await runner.run(input);
@@ -159990,6 +160085,7 @@ function parseOutline(value, projectRoot, exclude) {
   if (nodes.some((node) => !node)) return void 0;
   const byId = /* @__PURE__ */ new Map();
   for (const node of nodes) {
+    if (byId.has(node.id)) return void 0;
     byId.set(node.id, externalSymbol(node));
   }
   const entryPoints = value.entryPoints.map((item) => parseNode(item, projectRoot, exclude)).filter((node) => Boolean(node)).map(externalSymbol).filter((node, index, items) => items.findIndex((item) => item.id === node.id) === index).slice(0, 5);
@@ -160003,7 +160099,7 @@ function parseOutline(value, projectRoot, exclude) {
     if (!source || !target || !kind || rawEdge.line !== void 0 && (!line || line < 1)) return void 0;
     const from = byId.get(source);
     const to = byId.get(target);
-    if (!from || !to) continue;
+    if (!from || !to) return void 0;
     relations.push({ from, to, kind, ...line ? { line } : {} });
   }
   const relatedFiles = value.relatedFiles.map((item) => safeRelativePath(projectRoot, item, exclude));
@@ -160021,45 +160117,234 @@ function parseOutline(value, projectRoot, exclude) {
     stats: { nodes: nodeCount, edges: edgeCount, files: fileCount }
   };
 }
+function parseTextLocation(value) {
+  const match2 = value.trim().match(/^(.*?)(?::([1-9]\d*))?$/);
+  if (!match2?.[1]) return void 0;
+  return {
+    filePath: match2[1].trim(),
+    ...match2[2] ? { line: Number(match2[2]) } : {}
+  };
+}
+function parseExploreText(value, projectRoot, exclude) {
+  if (!value.trim() || Buffer.byteLength(value, "utf8") > MAX_EXTERNAL_CODEGRAPH_OUTPUT_BYTES) return void 0;
+  const entryPoints = [];
+  const nodes = [];
+  const relatedFiles = /* @__PURE__ */ new Set();
+  const byName = /* @__PURE__ */ new Map();
+  let section = null;
+  let relationKind = "references";
+  const addNode = (node, entry) => {
+    const key = `${node.filePath}\0${node.name}`;
+    const existing = byName.get(key);
+    if (existing) return;
+    byName.set(key, node);
+    relatedFiles.add(node.filePath);
+    (entry ? entryPoints : nodes).push(node);
+  };
+  for (const rawLine of value.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    const fileHeader = line.match(/^\*\*`([^`]+)`\*\*\s+(?:—|-)\s+(.+)$/);
+    if (fileHeader) {
+      const filePath = safeRelativePath(projectRoot, fileHeader[1], exclude);
+      if (!filePath) return void 0;
+      const symbolText = fileHeader[2].split(/\s+·\s+/, 1)[0] ?? "";
+      const symbols = [...symbolText.matchAll(/([^,]+?)\(([^()]+)\)/g)];
+      if (symbols.length === 0) return void 0;
+      const isFirstFile = entryPoints.length === 0 && nodes.length === 0;
+      for (const symbol of symbols.slice(0, MAX_EXTERNAL_NODE_COUNT)) {
+        const name = symbol[1]?.trim();
+        const kind = symbol[2]?.trim();
+        if (!name || !kind) return void 0;
+        addNode({
+          id: `explore:${filePath}:${name}`,
+          kind,
+          name,
+          filePath
+        }, isFirstFile);
+      }
+      section = null;
+      continue;
+    }
+    if (/^#{2,3}\s+Entry Points?\b/i.test(line)) {
+      section = "entry";
+      continue;
+    }
+    if (/^#{2,3}\s+Related Symbols?\b/i.test(line)) {
+      section = "related";
+      continue;
+    }
+    if (/^\*\*Relationships\*\*$/i.test(line)) {
+      section = "relationships";
+      continue;
+    }
+    if (/^\*\*(?:Source Code|Code)\*\*$/i.test(line) || /^#{2,3}\s+/i.test(line)) {
+      section = null;
+      continue;
+    }
+    if (section === "entry") {
+      const match2 = line.match(/^-\s+\*\*(.+?)\*\*\s+\(([^)]+)\)\s+-\s+(.+)$/);
+      if (!match2) continue;
+      const location = parseTextLocation(match2[3]);
+      if (!location) return void 0;
+      const filePath = safeRelativePath(projectRoot, location.filePath, exclude);
+      if (!filePath) return void 0;
+      addNode({
+        id: `explore:${filePath}:${match2[1]}`,
+        kind: match2[2],
+        name: match2[1],
+        filePath,
+        ...location.line ? { startLine: location.line, endLine: location.line } : {}
+      }, true);
+      continue;
+    }
+    if (section === "related") {
+      const match2 = line.match(/^-\s+([^:]+):\s+(.+)$/);
+      if (!match2) continue;
+      const filePath = safeRelativePath(projectRoot, match2[1], exclude);
+      if (!filePath) return void 0;
+      relatedFiles.add(filePath);
+      for (const rawSymbol of match2[2].split(",")) {
+        const symbol = rawSymbol.trim().match(/^(.+?)(?::([1-9]\d*))?$/);
+        if (!symbol?.[1]) return void 0;
+        addNode({
+          id: `explore:${filePath}:${symbol[1].trim()}`,
+          kind: "unknown",
+          name: symbol[1].trim(),
+          filePath,
+          ...symbol[2] ? { startLine: Number(symbol[2]), endLine: Number(symbol[2]) } : {}
+        }, false);
+      }
+      continue;
+    }
+    if (section === "relationships") {
+      const kind = line.match(/^\*\*([^*]+):\*\*$/);
+      if (kind?.[1]) {
+        relationKind = kind[1].trim();
+        continue;
+      }
+    }
+  }
+  const bySymbolName = /* @__PURE__ */ new Map();
+  for (const node of [...entryPoints, ...nodes]) {
+    if (!bySymbolName.has(node.name)) bySymbolName.set(node.name, node);
+  }
+  const relations = [];
+  if (section === "relationships") {
+    for (const rawLine of value.split(/\r?\n/)) {
+      const line = rawLine.trim();
+      const match2 = line.match(/^-\s+(.+?)\s+(?:\u2192|->)\s+(.+)$/);
+      if (!match2) continue;
+      const from = bySymbolName.get(match2[1].trim());
+      const to = bySymbolName.get(match2[2].trim());
+      if (!from || !to) continue;
+      relations.push({
+        from: externalSymbol(from),
+        to: externalSymbol(to),
+        kind: relationKind
+      });
+    }
+  } else {
+    const relationshipStart = value.split(/\r?\n/).findIndex((line) => /^\s*\*\*Relationships\*\*\s*$/i.test(line));
+    if (relationshipStart >= 0) {
+      const relationshipLines = value.split(/\r?\n/).slice(relationshipStart + 1);
+      for (const rawLine of relationshipLines) {
+        const line = rawLine.trim();
+        if (/^\*\*(?:Source Code|Code)\*\*$/i.test(line) || /^#{2,3}\s+/i.test(line)) break;
+        const kind = line.match(/^\*\*([^*]+):\*\*$/);
+        if (kind?.[1]) {
+          relationKind = kind[1].trim();
+          continue;
+        }
+        const match2 = line.match(/^-\s+(.+?)\s+(?:\u2192|->)\s+(.+)$/);
+        if (!match2) continue;
+        const from = bySymbolName.get(match2[1].trim());
+        const to = bySymbolName.get(match2[2].trim());
+        if (from && to) relations.push({ from: externalSymbol(from), to: externalSymbol(to), kind: relationKind });
+      }
+    }
+  }
+  const allNodes = [...entryPoints, ...nodes];
+  if (allNodes.length === 0) return void 0;
+  return {
+    provider: "external",
+    entryPoints: entryPoints.map(externalSymbol).slice(0, 5),
+    relations: relations.slice(0, 6),
+    relatedFiles: [...relatedFiles].slice(0, 5),
+    stats: {
+      nodes: allNodes.length,
+      edges: relations.length,
+      files: relatedFiles.size
+    }
+  };
+}
+function parseExplorePayload(value, projectRoot, exclude) {
+  if (typeof value === "string") return parseExploreText(value, projectRoot, exclude);
+  if (isRecord3(value) && isRecord3(value.result)) value = value.result;
+  if (isRecord3(value) && Array.isArray(value.content)) {
+    const text2 = value.content.filter((item) => isRecord3(item) && item.type === "text" && typeof item.text === "string").map((item) => item.text).join("\n");
+    return parseExploreText(text2, projectRoot, exclude);
+  }
+  return parseOutline(value, projectRoot, exclude);
+}
 function fallbackCaution(health) {
   if (health.state === "disabled" || health.state === "not-detected" || health.state === "not-initialized" || health.state === "ready") return void 0;
   return "External semantic CodeGraph is " + health.state + "; using Lite structural evidence for this brief.";
 }
+function queryFallbackCaution(diagnostics) {
+  return `External semantic CodeGraph context was unavailable (context: ${diagnostics.context.outcome}; explore: ${diagnostics.explore.outcome}); using Lite structural evidence.`;
+}
 async function getExternalCodeGraphContext(input) {
   const inspected = await inspectExternalCodeGraph(input);
   if (inspected.health.state !== "ready") {
     return { ...inspected, caution: fallbackCaution(inspected.health) };
   }
   const mode = input.mode ?? "auto";
-  const result = await runSafely(input.runner ?? defaultRunner, {
+  const runner = input.runner ?? defaultRunner;
+  const contextResult = await runSafely(runner, {
     command: input.command,
     args: ["context", "--path", input.projectRoot, "--format", "json", "--max-nodes", "8", "--no-code", input.task],
     cwd: input.projectRoot,
     timeoutMs: boundedTimeout(input.timeoutMs),
     maxOutputBytes: MAX_EXTERNAL_CODEGRAPH_OUTPUT_BYTES
   });
-  if (!result.ok) {
-    const health = unavailableHealth(result);
+  const diagnostics = {
+    context: contextResult.ok ? commandDiagnostic("context", contextResult, "success") : failedCommandDiagnostic("context", contextResult),
+    explore: notAttemptedDiagnostic("explore")
+  };
+  const contextOutline = contextResult.ok ? parseOutline(parseJson2(contextResult.stdout), input.projectRoot, input.exclude) : void 0;
+  if (contextOutline && (contextOutline.entryPoints.length > 0 || contextOutline.relations.length > 0 || contextOutline.relatedFiles.length > 0)) {
     return {
-      health,
-      quality: providerQuality({ mode, health }),
-      caution: fallbackCaution(health)
+      ...inspected,
+      outline: contextOutline,
+      diagnostics,
+      quality: providerQuality({ mode, health: inspected.health, selected: "external" })
     };
   }
-  const outline = parseOutline(parseJson2(result.stdout), input.projectRoot, input.exclude);
-  if (!outline) {
-    const health = { state: "invalid", reason: "The local CodeGraph context payload failed validation." };
+  if (contextResult.ok) diagnostics.context = commandDiagnostic("context", contextResult, "invalid-output", "The context payload failed validation or contained no safe outline.");
+  const exploreResult = await runSafely(runner, {
+    command: input.command,
+    args: ["explore", "--path", input.projectRoot, "--max-files", "4", input.task],
+    cwd: input.projectRoot,
+    timeoutMs: boundedTimeout(input.timeoutMs),
+    maxOutputBytes: MAX_EXTERNAL_CODEGRAPH_OUTPUT_BYTES
+  });
+  diagnostics.explore = exploreResult.ok ? commandDiagnostic("explore", exploreResult, "success") : failedCommandDiagnostic("explore", exploreResult);
+  const exploreOutline = exploreResult.ok ? parseExplorePayload(parseJson2(exploreResult.stdout) ?? exploreResult.stdout, input.projectRoot, input.exclude) : void 0;
+  if (exploreOutline && (exploreOutline.entryPoints.length > 0 || exploreOutline.relations.length > 0 || exploreOutline.relatedFiles.length > 0)) {
     return {
-      health,
-      quality: providerQuality({ mode, health }),
-      caution: fallbackCaution(health)
+      ...inspected,
+      outline: exploreOutline,
+      diagnostics,
+      quality: providerQuality({ mode, health: inspected.health, selected: "external" })
     };
   }
-  const contributes = outline.entryPoints.length > 0 || outline.relations.length > 0 || outline.relatedFiles.length > 0;
+  if (exploreResult.ok) diagnostics.explore = commandDiagnostic("explore", exploreResult, "invalid-output", "The explore payload failed validation or contained no safe outline.");
+  const health = exploreResult.ok ? { state: "invalid", reason: "The local CodeGraph context and explore payloads failed validation." } : unavailableHealth(exploreResult);
   return {
-    ...inspected,
-    ...contributes ? { outline } : {},
-    quality: providerQuality({ mode, health: inspected.health, ...contributes ? { selected: "external" } : {} })
+    health,
+    quality: providerQuality({ mode, health }),
+    diagnostics,
+    caution: queryFallbackCaution(diagnostics)
   };
 }
 var DEFAULT_EXTERNAL_CODEGRAPH_TIMEOUT_MS, MAX_EXTERNAL_CODEGRAPH_TIMEOUT_MS, EXTERNAL_CODEGRAPH_LIFECYCLE_TIMEOUT_MS, MAX_EXTERNAL_CODEGRAPH_OUTPUT_BYTES, MAX_EXTERNAL_NODE_COUNT, MAX_EXTERNAL_EDGE_COUNT, MAX_EXTERNAL_FILE_COUNT, MAX_EXTERNAL_TEXT_LENGTH, LITE_SUPPORTED_LANGUAGES, defaultRunner;
@@ -160070,7 +160355,7 @@ var init_external_provider = __esm({
     init_secret_filter();
     init_exclude3();
     init_ids();
-    DEFAULT_EXTERNAL_CODEGRAPH_TIMEOUT_MS = 1200;
+    DEFAULT_EXTERNAL_CODEGRAPH_TIMEOUT_MS = 3e3;
     MAX_EXTERNAL_CODEGRAPH_TIMEOUT_MS = 5e3;
     EXTERNAL_CODEGRAPH_LIFECYCLE_TIMEOUT_MS = 3e4;
     MAX_EXTERNAL_CODEGRAPH_OUTPUT_BYTES = 256 * 1024;
@@ -163353,6 +163638,7 @@ async function executeCleanup(context, payload, token) {
   return { action: "cleanup", projectId: context.projectId, ...result };
 }
 async function previewDeduplicate(context) {
+  initLLM({ scope: "memory", projectRoot: context.projectRoot });
   if (!isLLMEnabled()) {
     return {
       action: "deduplicate",
@@ -165109,7 +165395,7 @@ var init_event_bus = __esm({
 });
 
 // src/orchestrate/task-graph.ts
-import { z as z625 } from "zod";
+import { z as z626 } from "zod";
 function parseTaskGraph(raw) {
   const json2 = extractJson(raw);
   if (!json2) {
@@ -165301,25 +165587,25 @@ var init_task_graph = __esm({
   "src/orchestrate/task-graph.ts"() {
     "use strict";
     init_esm_shims();
-    TaskNodeSchema = z625.object({
-      tempId: z625.string().min(1).describe('Temporary ID like "t1", "t2"'),
-      role: z625.enum(["pm", "engineer", "qa", "reviewer"]),
-      description: z625.string().min(30).describe("Self-contained task description with all context"),
-      deps: z625.array(z625.string()).describe("tempIds of prerequisite tasks"),
-      files: z625.array(z625.string()).optional().describe("Files this task will create or modify"),
+    TaskNodeSchema = z626.object({
+      tempId: z626.string().min(1).describe('Temporary ID like "t1", "t2"'),
+      role: z626.enum(["pm", "engineer", "qa", "reviewer"]),
+      description: z626.string().min(30).describe("Self-contained task description with all context"),
+      deps: z626.array(z626.string()).describe("tempIds of prerequisite tasks"),
+      files: z626.array(z626.string()).optional().describe("Files this task will create or modify"),
       /** Phase 7: Natural-language acceptance criteria (Goal-First Testing) */
-      goals: z625.array(z625.string()).optional().describe("Acceptance criteria for task verification")
+      goals: z626.array(z626.string()).optional().describe("Acceptance criteria for task verification")
     });
-    TaskGraphSchema = z625.object({
-      summary: z625.string().min(10).describe("One-paragraph plan summary"),
-      tasks: z625.array(TaskNodeSchema).min(2).max(30)
+    TaskGraphSchema = z626.object({
+      summary: z626.string().min(10).describe("One-paragraph plan summary"),
+      tasks: z626.array(TaskNodeSchema).min(2).max(30)
     }).superRefine((data, ctx) => {
       const ids = new Set(data.tasks.map((t2) => t2.tempId));
       for (const task of data.tasks) {
         for (const dep of task.deps) {
           if (!ids.has(dep)) {
             ctx.addIssue({
-              code: z625.ZodIssueCode.custom,
+              code: z626.ZodIssueCode.custom,
               message: `Task "${task.tempId}" references unknown dependency "${dep}"`,
               path: ["tasks"]
             });
@@ -165327,7 +165613,7 @@ var init_task_graph = __esm({
         }
         if (task.deps.includes(task.tempId)) {
           ctx.addIssue({
-            code: z625.ZodIssueCode.custom,
+            code: z626.ZodIssueCode.custom,
             message: `Task "${task.tempId}" depends on itself`,
             path: ["tasks"]
           });
@@ -165335,21 +165621,21 @@ var init_task_graph = __esm({
       }
       if (data.tasks.length > 0 && data.tasks[data.tasks.length - 1].role !== "reviewer") {
         ctx.addIssue({
-          code: z625.ZodIssueCode.custom,
+          code: z626.ZodIssueCode.custom,
           message: 'Last task must have role "reviewer"',
           path: ["tasks"]
         });
       }
       if (hasCycle(data.tasks)) {
         ctx.addIssue({
-          code: z625.ZodIssueCode.custom,
+          code: z626.ZodIssueCode.custom,
           message: "Task graph contains a cycle",
           path: ["tasks"]
         });
       }
       if (ids.size !== data.tasks.length) {
         ctx.addIssue({
-          code: z625.ZodIssueCode.custom,
+          code: z626.ZodIssueCode.custom,
           message: "Duplicate tempId values detected",
           path: ["tasks"]
         });
@@ -167812,7 +168098,7 @@ __export(server_exports2, {
 });
 import { createHash as createHash16 } from "crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z as z626 } from "zod";
+import { z as z627 } from "zod";
 function formatFormationStageDurations(stageDurationsMs) {
   const orderedStages = ["extract", "resolve", "evaluate"];
   const parts = orderedStages.filter((stage) => stageDurationsMs[stage] !== void 0).map((stage) => `${stage}=${stageDurationsMs[stage]}ms`);
@@ -168184,10 +168470,9 @@ The path should point to a directory containing a .git folder.`
       isError: true
     };
   };
-  const server = existingServer ?? new McpServer({
-    name: "memorix",
-    version: true ? "1.8.1" : "1.0.1"
-  });
+  const serverInfo = getMcpServerInfo();
+  const server = existingServer ?? new McpServer(serverInfo);
+  registerMcpDiscovery(server, serverInfo);
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
     if (!isToolInProfile(name, toolProfile)) {
@@ -168270,42 +168555,42 @@ The path should point to a directory containing a .git folder.`
       title: "Store Memory",
       description: "Store a new observation/memory. Automatically indexed for search. Use type to classify: gotcha ([GOTCHA] critical pitfall), decision ([DECISION] architecture choice), problem-solution ([FIX] bug fix), how-it-works ([INFO] explanation), what-changed ([CHANGE] change), discovery ([DISCOVERY] insight), why-it-exists ([WHY] rationale), trade-off ([TRADEOFF] compromise), session-request ([SESSION] original goal). Project visibility is the default. Personal or team visibility requires an explicitly joined coordination identity. Set longTerm only when the caller explicitly wants an additional source-backed long-term candidate; it is never injected until an operator records a review through the CLI. For a read-only task, do not store unless the user explicitly asks to save a record.",
       inputSchema: {
-        entityName: z626.string().describe('The entity this observation belongs to (e.g., "auth-module", "port-config")'),
-        type: z626.enum(OBSERVATION_TYPES).describe("Observation type for classification"),
-        title: z626.string().describe("Short descriptive title (~5-10 words)"),
-        narrative: z626.string().describe("Full description of the observation"),
-        facts: z626.array(z626.string()).optional().describe('Structured facts (e.g., "Default timeout: 60s")'),
-        filesModified: z626.array(z626.string()).optional().describe("Files involved"),
-        concepts: z626.array(z626.string()).optional().describe("Related concepts/keywords"),
-        topicKey: z626.string().optional().describe(
+        entityName: z627.string().describe('The entity this observation belongs to (e.g., "auth-module", "port-config")'),
+        type: z627.enum(OBSERVATION_TYPES).describe("Observation type for classification"),
+        title: z627.string().describe("Short descriptive title (~5-10 words)"),
+        narrative: z627.string().describe("Full description of the observation"),
+        facts: z627.array(z627.string()).optional().describe('Structured facts (e.g., "Default timeout: 60s")'),
+        filesModified: z627.array(z627.string()).optional().describe("Files involved"),
+        concepts: z627.array(z627.string()).optional().describe("Related concepts/keywords"),
+        topicKey: z627.string().optional().describe(
           'Optional topic identifier for upserts (e.g., "architecture/auth-model"). If an observation with the same topicKey already exists in this project, it will be UPDATED instead of creating a new one. Use memorix_suggest_topic_key to generate a stable key. Good for evolving decisions, architecture docs, etc.'
         ),
-        progress: z626.object({
-          feature: z626.string().describe("Feature or task name"),
-          status: z626.enum(["in-progress", "completed", "blocked"]).describe("Current status"),
-          completion: z626.number().optional().describe("Completion percentage 0-100")
+        progress: z627.object({
+          feature: z627.string().describe("Feature or task name"),
+          status: z627.enum(["in-progress", "completed", "blocked"]).describe("Current status"),
+          completion: z627.number().optional().describe("Completion percentage 0-100")
         }).optional().describe("Progress tracking for task/feature observations"),
-        relatedCommits: z626.array(z626.string()).optional().describe("Git commit hashes this memory relates to (links ground truth \u2194 reasoning)"),
-        relatedEntities: z626.array(z626.string()).optional().describe("Other entity names this memory cross-references"),
-        visibility: z626.enum(["personal", "project", "team"]).optional().describe(
+        relatedCommits: z627.array(z627.string()).optional().describe("Git commit hashes this memory relates to (links ground truth \u2194 reasoning)"),
+        relatedEntities: z627.array(z627.string()).optional().describe("Other entity names this memory cross-references"),
+        visibility: z627.enum(["personal", "project", "team"]).optional().describe(
           "Retrieval scope. Project is the normal shared default; personal/team require memorix_session_start with joinTeam=true."
         ),
-        longTerm: z626.object({
-          kind: z626.enum(["episodic", "semantic", "procedural"]).describe("Cognitive kind for an additional long-term candidate."),
-          scope: z626.enum(["project", "user", "team"]).optional().default("project").describe("Long-term scope. User capture is private source evidence and needs a bound agent identity."),
-          tags: z626.array(z626.string()).optional().describe("Small set of retrieval tags for the candidate."),
-          applicability: z626.string().optional().describe("When this durable fact or procedure applies.")
+        longTerm: z627.object({
+          kind: z627.enum(["episodic", "semantic", "procedural"]).describe("Cognitive kind for an additional long-term candidate."),
+          scope: z627.enum(["project", "user", "team"]).optional().default("project").describe("Long-term scope. User capture is private source evidence and needs a bound agent identity."),
+          tags: z627.array(z627.string()).optional().describe("Small set of retrieval tags for the candidate."),
+          applicability: z627.string().optional().describe("When this durable fact or procedure applies.")
         }).optional().describe("Optional explicit request to create a source-backed long-term candidate alongside this observation. Candidates are not automatically injected."),
-        overrideReadOnly: z626.boolean().optional().describe(
+        overrideReadOnly: z627.boolean().optional().describe(
           "Use only when the user explicitly asks to save memory during a read-only or no-modification task."
         ),
-        attachments: z626.array(z626.object({
-          modality: z626.enum(["image", "audio", "video", "document"]),
-          url: z626.string().describe(
+        attachments: z627.array(z627.object({
+          modality: z627.enum(["image", "audio", "video", "document"]),
+          url: z627.string().describe(
             "Public HTTPS provenance reference without query parameters or fragments. Memorix does not fetch this URL: attachment metadata is persisted and BM25-searchable, while observation vectors remain text-only."
           ),
-          mimeType: z626.string().optional(),
-          name: z626.string().optional()
+          mimeType: z627.string().optional(),
+          name: z627.string().optional()
         })).optional().describe("Safe public provenance references. They are stored as metadata for lexical retrieval; raw inline media is never stored.")
       }
     },
@@ -168843,8 +169128,8 @@ Entity: ${entityName} | Type: ${type} | Project: ${project.id}${obs.topicKey ? `
       title: "Suggest Topic Key",
       description: 'Suggest a stable topic_key for memory upserts. Use this before memorix_store when you want evolving topics (like architecture decisions, config docs) to update a single observation over time instead of creating duplicates. Returns a key like "architecture/auth-model" or "bug/timeout-in-api-gateway".',
       inputSchema: {
-        type: z626.string().describe("Observation type (e.g., decision, architecture, bugfix, discovery)"),
-        title: z626.string().describe("Observation title \u2014 used to generate the stable key")
+        type: z627.string().describe("Observation type (e.g., decision, architecture, bugfix, discovery)"),
+        title: z627.string().describe("Observation title \u2014 used to generate the stable key")
       }
     },
     async ({ type: obsType, title }) => {
@@ -168869,28 +169154,28 @@ Use this as the \`topicKey\` parameter in \`memorix_store\` to enable upsert beh
       title: "Search Memory",
       description: "Search project memory. Returns a compact index (~50-100 tokens/result). Do not use as a follow-up to a complete memorix_project_context brief unless a specific fact is still missing or the user asks for deeper history; provide purpose when intentionally expanding. Use memorix_detail to fetch full content for specific IDs. Use memorix_timeline to see chronological context. Searches across all observations stored from any IDE session \u2014 enabling cross-session and cross-agent context retrieval.",
       inputSchema: {
-        query: z626.string().describe("Search query (natural language or keywords)"),
-        limit: z626.number().optional().describe("Max results (default: 20)"),
-        type: z626.enum(OBSERVATION_TYPES).optional().describe("Filter by observation type"),
-        maxTokens: z626.number().optional().describe("Token budget \u2014 trim results to fit (0 = unlimited)"),
-        scope: z626.enum(["project", "global"]).optional().default("project").describe(
+        query: z627.string().describe("Search query (natural language or keywords)"),
+        limit: z627.number().optional().describe("Max results (default: 20)"),
+        type: z627.enum(OBSERVATION_TYPES).optional().describe("Filter by observation type"),
+        maxTokens: z627.number().optional().describe("Token budget \u2014 trim results to fit (0 = unlimited)"),
+        scope: z627.enum(["project", "global"]).optional().default("project").describe(
           'Search scope: "project" (default) only searches current project, "global" searches all projects'
         ),
-        since: z626.string().optional().describe('Only return observations created after this date (ISO 8601 or natural like "2025-01-15")'),
-        until: z626.string().optional().describe('Only return observations created before this date (ISO 8601 or natural like "2025-02-01")'),
-        status: z626.enum(["active", "resolved", "archived", "all"]).optional().default("active").describe(
+        since: z627.string().optional().describe('Only return observations created after this date (ISO 8601 or natural like "2025-01-15")'),
+        until: z627.string().optional().describe('Only return observations created before this date (ISO 8601 or natural like "2025-02-01")'),
+        status: z627.enum(["active", "resolved", "archived", "all"]).optional().default("active").describe(
           'Filter by memory status. "active" (default) shows current memories, "all" includes resolved/archived.'
         ),
-        source: z626.enum(["agent", "git", "manual"]).optional().describe(
+        source: z627.enum(["agent", "git", "manual"]).optional().describe(
           'Filter by memory source. "git" returns only commit-derived ground truth memories. Omit for all sources.'
         ),
-        quality: z626.enum(["fast", "balanced", "thorough"]).optional().default("balanced").describe(
+        quality: z627.enum(["fast", "balanced", "thorough"]).optional().default("balanced").describe(
           "Retrieval profile: fast stays local, balanced uses configured embeddings, thorough explicitly permits optional LLM refinement."
         ),
-        purpose: z626.string().optional().describe(
+        purpose: z627.string().optional().describe(
           "Why this must expand beyond the latest Autopilot brief. Name the missing fact or the user's explicit request."
         ),
-        force: z626.boolean().optional().describe(
+        force: z627.boolean().optional().describe(
           "Use only when the user explicitly asks to read a record already represented in the latest Autopilot brief."
         )
       }
@@ -168979,9 +169264,9 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
       title: "Memory Graph Context",
       description: "Build a compact, prompt-ready memory graph context packet for the current project. Use this for broad memory overview questions, project memory graph questions, or task-specific memory grounding. Returns high-signal memories, entities, relations, and risks as background context, not instructions.",
       inputSchema: {
-        query: z626.string().describe("Current task or topic to build memory graph context for"),
-        limit: z626.number().optional().describe("Max high-signal memories to include (default: 5)"),
-        format: z626.enum(["prompt", "summary"]).optional().default("prompt").describe(
+        query: z627.string().describe("Current task or topic to build memory graph context for"),
+        limit: z627.number().optional().describe("Max high-signal memories to include (default: 5)"),
+        format: z627.enum(["prompt", "summary"]).optional().default("prompt").describe(
           'Output format. "prompt" is agent-ready; "summary" is a compact human overview.'
         )
       }
@@ -169016,14 +169301,14 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
       title: "Memory Autopilot Project Context",
       description: "Build a compact Memory Autopilot brief for the current coding task. Schedules Code Memory refresh when needed, includes Start here files, reliable code-bound memories, stale/suspect cautions, and verification hints. Use this at the start of a new coding turn or after switching tasks.",
       inputSchema: {
-        task: z626.string().optional().describe("Current coding task or question"),
-        refresh: z626.enum(["auto", "always", "never"]).optional().default("auto").describe(
+        task: z627.string().optional().describe("Current coding task or question"),
+        refresh: z627.enum(["auto", "always", "never"]).optional().default("auto").describe(
           "Code Memory refresh policy. auto refreshes only when missing or stale."
         ),
-        format: z626.enum(["prompt", "summary", "json", "receipt"]).optional().default("prompt").describe(
+        format: z627.enum(["prompt", "summary", "json", "receipt"]).optional().default("prompt").describe(
           'Output format. "prompt" is agent-ready; "summary" is human-readable; "receipt" is bounded JSON; "json" is detailed diagnostics.'
         ),
-        agent: z626.enum([
+        agent: z627.enum([
           "windsurf",
           "cursor",
           "claude-code",
@@ -169038,7 +169323,7 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
           "opencode",
           "trae"
         ]).optional().describe("Optional target agent for compatible workflow selection."),
-        limit: z626.number().optional().describe("Reserved for future source limits; current prompt stays compact by default.")
+        limit: z627.number().optional().describe("Reserved for future source limits; current prompt stays compact by default.")
       }
     },
     async ({ task, refresh, format, agent }) => {
@@ -169139,12 +169424,12 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
       title: "Context Pack",
       description: "Build a prompt-ready working context pack for a coding task. Combines relevant memories, CodeGraph Memory facts, freshness warnings, suggested reads, and verification hints. After a complete memorix_project_context brief, provide purpose only when deliberately expanding beyond it.",
       inputSchema: {
-        task: z626.string().describe("Current coding task or question"),
-        limit: z626.preprocess(
+        task: z627.string().describe("Current coding task or question"),
+        limit: z627.preprocess(
           (value) => typeof value === "string" && value.trim() !== "" ? Number(value) : value,
-          z626.number().int().positive().max(100)
+          z627.number().int().positive().max(100)
         ).optional().describe("Max active memories to inspect before code-ref filtering (default: 20)"),
-        purpose: z626.string().optional().describe(
+        purpose: z627.string().optional().describe(
           "Why this must expand beyond the latest Autopilot brief. Name the missing fact or the user's explicit request."
         )
       }
@@ -169239,7 +169524,7 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
       title: "Knowledge Workspace",
       description: "Manage the reviewable project Knowledge Workspace. Use it only for deliberate knowledge operations: initialize a local or versioned workspace, review source-backed claims, compile proposals, lint, apply a reviewed proposal, or manage canonical workflows. It is intentionally absent from the default micro/lite profiles.",
       inputSchema: {
-        action: z626.enum([
+        action: z627.enum([
           "workspace_init",
           "status",
           "claim_list",
@@ -169254,21 +169539,21 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
           "workflow_apply",
           "workflow_run"
         ]).describe("Knowledge operation to perform"),
-        mode: z626.enum(["local", "versioned"]).optional().default("local").describe("Workspace mode; versioned writes require an explicit project path during workspace_init"),
-        path: z626.string().optional().describe("Explicit versioned workspace path, used only by workspace_init"),
-        proposalId: z626.string().optional().describe("Pending proposal id for proposal_apply"),
-        allowManualOverwrite: z626.boolean().optional().default(false).describe("Explicitly allow proposal_apply to replace a manually edited page"),
-        claimId: z626.string().optional().describe("Source-backed claim id for claim_review"),
-        claimReviewState: z626.enum(["approved", "rejected"]).optional().describe("Deliberate review verdict for claim_review"),
-        reviewDetail: z626.string().max(2e3).optional().describe("Evidence check performed before approving or rejecting a claim"),
-        workflowId: z626.string().optional().describe("Canonical workflow id for workflow preview, apply, or run"),
-        agent: z626.string().optional().describe("Target agent for a workflow adapter"),
-        task: z626.string().optional().describe("Task text for workflow selection or a workflow run"),
-        outcome: z626.enum(["passed", "failed", "cancelled", "in-progress"]).optional().describe("Workflow run outcome"),
-        verificationVerdict: z626.enum(["passed", "failed", "not-run"]).optional().describe("Workflow run verification verdict"),
-        failureReason: z626.string().optional().describe("Sanitized workflow failure reason"),
-        startingSnapshotId: z626.string().optional().describe("Code snapshot id present when a workflow run began"),
-        evidenceIds: z626.array(z626.string()).max(24).optional().describe("Selected evidence ids for a workflow run")
+        mode: z627.enum(["local", "versioned"]).optional().default("local").describe("Workspace mode; versioned writes require an explicit project path during workspace_init"),
+        path: z627.string().optional().describe("Explicit versioned workspace path, used only by workspace_init"),
+        proposalId: z627.string().optional().describe("Pending proposal id for proposal_apply"),
+        allowManualOverwrite: z627.boolean().optional().default(false).describe("Explicitly allow proposal_apply to replace a manually edited page"),
+        claimId: z627.string().optional().describe("Source-backed claim id for claim_review"),
+        claimReviewState: z627.enum(["approved", "rejected"]).optional().describe("Deliberate review verdict for claim_review"),
+        reviewDetail: z627.string().max(2e3).optional().describe("Evidence check performed before approving or rejecting a claim"),
+        workflowId: z627.string().optional().describe("Canonical workflow id for workflow preview, apply, or run"),
+        agent: z627.string().optional().describe("Target agent for a workflow adapter"),
+        task: z627.string().optional().describe("Task text for workflow selection or a workflow run"),
+        outcome: z627.enum(["passed", "failed", "cancelled", "in-progress"]).optional().describe("Workflow run outcome"),
+        verificationVerdict: z627.enum(["passed", "failed", "not-run"]).optional().describe("Workflow run verification verdict"),
+        failureReason: z627.string().optional().describe("Sanitized workflow failure reason"),
+        startingSnapshotId: z627.string().optional().describe("Code snapshot id present when a workflow run began"),
+        evidenceIds: z627.array(z627.string()).max(24).optional().describe("Selected evidence ids for a workflow run")
       }
     },
     async ({
@@ -169544,8 +169829,8 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
       title: "Resolve Memories",
       description: `Mark observations as resolved (completed/no longer active). Resolved memories are hidden from default search but can still be found with status="all". Use this to mark completed tasks, fixed bugs, or outdated information so they don't pollute future context.`,
       inputSchema: {
-        ids: z626.array(z626.number()).describe("Observation IDs to mark as resolved"),
-        status: z626.enum(["resolved", "archived"]).optional().default("resolved").describe(
+        ids: z627.array(z627.number()).describe("Observation IDs to mark as resolved"),
+        status: z627.enum(["resolved", "archived"]).optional().default("resolved").describe(
           'Target status: "resolved" (default, completed/done) or "archived" (permanently hidden)'
         )
       }
@@ -169583,17 +169868,17 @@ _Search mode: ${getLastSearchMode2(project.id)}_`;
       title: "Store Reasoning Trace",
       description: "Store a reasoning trace \u2014 WHY you chose this approach, what alternatives you considered, and what outcome you expect. This creates a searchable record of your decision-making process. Use this when making non-trivial technical decisions, choosing between approaches, or solving complex problems. Unlike regular memories that record WHAT happened, reasoning memories record HOW you thought about it.",
       inputSchema: {
-        entityName: z626.string().describe('The entity this reasoning applies to (e.g., "auth-module", "database-schema")'),
-        decision: z626.string().describe("What was decided or chosen"),
-        alternatives: z626.array(z626.string()).optional().describe("Other options that were considered"),
-        rationale: z626.string().describe("Why this approach was chosen over alternatives"),
-        constraints: z626.array(z626.string()).optional().describe("Constraints that influenced the decision (time, perf, compat, etc.)"),
-        expectedOutcome: z626.string().optional().describe("What outcome is expected from this decision"),
-        risks: z626.array(z626.string()).optional().describe("Known risks or potential downsides"),
-        concepts: z626.array(z626.string()).optional().describe("Related technical concepts"),
-        filesModified: z626.array(z626.string()).optional().describe("Files related to this reasoning"),
-        relatedCommits: z626.array(z626.string()).optional().describe("Git commit hashes this reasoning explains (links ground truth \u2194 reasoning)"),
-        relatedEntities: z626.array(z626.string()).optional().describe("Other entity names this reasoning relates to (cross-references)")
+        entityName: z627.string().describe('The entity this reasoning applies to (e.g., "auth-module", "database-schema")'),
+        decision: z627.string().describe("What was decided or chosen"),
+        alternatives: z627.array(z627.string()).optional().describe("Other options that were considered"),
+        rationale: z627.string().describe("Why this approach was chosen over alternatives"),
+        constraints: z627.array(z627.string()).optional().describe("Constraints that influenced the decision (time, perf, compat, etc.)"),
+        expectedOutcome: z627.string().optional().describe("What outcome is expected from this decision"),
+        risks: z627.array(z627.string()).optional().describe("Known risks or potential downsides"),
+        concepts: z627.array(z627.string()).optional().describe("Related technical concepts"),
+        filesModified: z627.array(z627.string()).optional().describe("Files related to this reasoning"),
+        relatedCommits: z627.array(z627.string()).optional().describe("Git commit hashes this reasoning explains (links ground truth \u2194 reasoning)"),
+        relatedEntities: z627.array(z627.string()).optional().describe("Other entity names this reasoning relates to (cross-references)")
       }
     },
     async ({ entityName, decision, alternatives, rationale, constraints, expectedOutcome, risks, concepts, filesModified, relatedCommits, relatedEntities }) => {
@@ -169668,7 +169953,7 @@ Entity: ${entityName} | ${facts.length} facts | ${obs.tokens} tokens${reasoningA
       title: "Audit Project Attribution",
       description: "Scan the current project for observations that may have been written to the wrong project bucket. Identifies observations whose entityName appears exclusively in a different project. Read-only \u2014 no data is changed. Use memorix_resolve to archive confirmed mis-attributed observations.",
       inputSchema: {
-        threshold: z626.number().int().min(1).optional().describe(
+        threshold: z627.number().int().min(1).optional().describe(
           "Minimum occurrences of an entityName in another project to flag it as suspicious (default: 2)"
         )
       }
@@ -169732,9 +170017,9 @@ Entity: ${entityName} | ${facts.length} facts | ${obs.tokens} tokens${reasoningA
       title: "Search Reasoning Patterns",
       description: "Search past reasoning traces to understand WHY decisions were made. Returns reasoning memories that explain the thought process behind technical choices. Use this when revisiting code, questioning a design decision, or looking for precedent on how similar problems were solved before.",
       inputSchema: {
-        query: z626.string().describe('Search query \u2014 describe what reasoning you want to find (e.g., "why did we choose PostgreSQL", "auth approach rationale")'),
-        limit: z626.number().optional().describe("Max results (default: 10)"),
-        scope: z626.enum(["project", "global"]).optional().default("project").describe("Search scope")
+        query: z627.string().describe('Search query \u2014 describe what reasoning you want to find (e.g., "why did we choose PostgreSQL", "auth approach rationale")'),
+        limit: z627.number().optional().describe("Max results (default: 10)"),
+        scope: z627.enum(["project", "global"]).optional().default("project").describe("Search scope")
       }
     },
     async ({ query, limit: limit2, scope }) => {
@@ -169768,8 +170053,8 @@ ${result.formatted}` }]
       title: "Deduplicate Memories",
       description: "Scan active memories for duplicates, contradictions, and outdated information using LLM analysis. Automatically resolves redundant memories. Requires LLM to be configured (set MEMORIX_LLM_API_KEY or OPENAI_API_KEY environment variable). Without LLM, falls back to basic similarity-based consolidation.",
       inputSchema: {
-        query: z626.string().optional().describe("Optional query to scope dedup to a topic (default: scan all)"),
-        dryRun: z626.boolean().optional().default(false).describe("Preview only \u2014 show what would be resolved without making changes")
+        query: z627.string().optional().describe("Optional query to scope dedup to a topic (default: scan all)"),
+        dryRun: z627.boolean().optional().default(false).describe("Preview only \u2014 show what would be resolved without making changes")
       }
     },
     async ({ query, dryRun }) => {
@@ -169838,9 +170123,9 @@ ${actionLines.join("\n")}`
       title: "Memory Timeline",
       description: "Deep retrieval: expand chronological context around a specific observation \u2014 distinguishes explicit memory evolution, hook activity traces, and git-backed facts. Natural follow-up after session L1 routing hints (hook traces) or L3 evidence pointers (git memory).",
       inputSchema: {
-        anchorId: z626.number().describe("Observation ID to center the timeline on"),
-        depthBefore: z626.number().optional().describe("Number of observations before (default: 3)"),
-        depthAfter: z626.number().optional().describe("Number of observations after (default: 3)")
+        anchorId: z627.number().describe("Observation ID to center the timeline on"),
+        depthBefore: z627.number().optional().describe("Number of observations before (default: 3)"),
+        depthAfter: z627.number().optional().describe("Number of observations after (default: 3)")
       }
     },
     async ({ anchorId, depthBefore, depthAfter }) => {
@@ -169870,18 +170155,18 @@ ${actionLines.join("\n")}`
       title: "Memory Details",
       description: 'Fetch full observation, mini-skill, or curated durable-memory details \u2014 includes source kind (explicit memory / hook trace / git evidence), value category, and cross-references (~500-1000 tokens each). Do not re-fetch content already covered by a complete memorix_project_context brief unless a specific fact is still missing or the user asks for deeper history; provide purpose when intentionally expanding. Always use memorix_search first to find relevant IDs, then fetch only what you need. Accepts typed refs from search results (e.g. "obs:42", "skill:3") and durable refs from a project brief (e.g. "durable:<uuid>") via the typedRefs field, or legacy numeric ids / object refs for backward compatibility.',
       inputSchema: {
-        ids: z626.array(z626.number()).optional().describe("Observation IDs to fetch (legacy, from memorix_search results)"),
-        refs: z626.array(
-          z626.object({
-            id: z626.number().describe("Observation ID"),
-            projectId: z626.string().optional().describe("Project ID for global-search disambiguation")
+        ids: z627.array(z627.number()).optional().describe("Observation IDs to fetch (legacy, from memorix_search results)"),
+        refs: z627.array(
+          z627.object({
+            id: z627.number().describe("Observation ID"),
+            projectId: z627.string().optional().describe("Project ID for global-search disambiguation")
           })
         ).optional().describe("Explicit observation refs. Prefer this for global search results."),
-        typedRefs: z626.array(z626.string()).optional().describe('Typed memory refs from search results or a project brief, e.g. "obs:42", "skill:3", "durable:<uuid>", "obs:42@org/proj"'),
-        purpose: z626.string().optional().describe(
+        typedRefs: z627.array(z627.string()).optional().describe('Typed memory refs from search results or a project brief, e.g. "obs:42", "skill:3", "durable:<uuid>", "obs:42@org/proj"'),
+        purpose: z627.string().optional().describe(
           "Why this must expand beyond the latest Autopilot brief. Name the missing fact or the user's explicit request."
         ),
-        force: z626.boolean().optional().describe(
+        force: z627.boolean().optional().describe(
           "Use only when the user explicitly asks to read a record already represented in the latest Autopilot brief."
         )
       }
@@ -169960,7 +170245,7 @@ ${actionLines.join("\n")}`
       title: "Memory Retention Status & Archive",
       description: 'Show memory retention status or archive expired memories. action="report" (default): show active/stale/archive-candidate counts. action="archive": move expired observations to archive file (reversible). action="stale": list stale observations with full retention explanation. Uses exponential decay scoring based on importance, age, and access patterns.',
       inputSchema: {
-        action: z626.enum(["report", "archive", "stale"]).optional().describe('Action: "report" (show status, default) or "archive" (move expired to archive) or "stale" (list stale observations with explanation)')
+        action: z627.enum(["report", "archive", "stale"]).optional().describe('Action: "report" (show status, default) or "archive" (move expired to archive) or "stale" (list stale observations with explanation)')
       }
     },
     async (args) => {
@@ -170225,10 +170510,10 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Create Entities",
         description: "Create multiple new entities in the knowledge graph",
         inputSchema: {
-          entities: z626.array(z626.object({
-            name: z626.string().describe("The name of the entity"),
-            entityType: z626.string().describe("The type of the entity"),
-            observations: z626.array(z626.string()).describe("Initial observations")
+          entities: z627.array(z627.object({
+            name: z627.string().describe("The name of the entity"),
+            entityType: z627.string().describe("The type of the entity"),
+            observations: z627.array(z627.string()).describe("Initial observations")
           }))
         }
       },
@@ -170248,10 +170533,10 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Create Relations",
         description: "Create multiple new relations between entities in the knowledge graph. Relations should be in active voice. Recommended relation types (from mcp-memory-service): causes, fixes, supports, opposes, contradicts, depends_on, implements, extends, replaces, documents",
         inputSchema: {
-          relations: z626.array(z626.object({
-            from: z626.string().describe("Source entity name"),
-            to: z626.string().describe("Target entity name"),
-            relationType: z626.string().describe("Type of relation (e.g., causes, fixes, supports, depends_on, implements)")
+          relations: z627.array(z627.object({
+            from: z627.string().describe("Source entity name"),
+            to: z627.string().describe("Target entity name"),
+            relationType: z627.string().describe("Type of relation (e.g., causes, fixes, supports, depends_on, implements)")
           }))
         }
       },
@@ -170271,9 +170556,9 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Add Observations",
         description: "Add new observations to existing entities in the knowledge graph",
         inputSchema: {
-          observations: z626.array(z626.object({
-            entityName: z626.string().describe("Entity name to add observations to"),
-            contents: z626.array(z626.string()).describe("Observation contents to add")
+          observations: z627.array(z627.object({
+            entityName: z627.string().describe("Entity name to add observations to"),
+            contents: z627.array(z627.string()).describe("Observation contents to add")
           }))
         }
       },
@@ -170293,7 +170578,7 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Delete Entities",
         description: "Delete multiple entities and their associated relations from the knowledge graph",
         inputSchema: {
-          entityNames: z626.array(z626.string()).describe("Entity names to delete")
+          entityNames: z627.array(z627.string()).describe("Entity names to delete")
         }
       },
       async ({ entityNames }) => {
@@ -170312,9 +170597,9 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Delete Observations",
         description: "Delete specific observations from entities in the knowledge graph",
         inputSchema: {
-          deletions: z626.array(z626.object({
-            entityName: z626.string().describe("Entity containing the observations"),
-            observations: z626.array(z626.string()).describe("Observations to delete")
+          deletions: z627.array(z627.object({
+            entityName: z627.string().describe("Entity containing the observations"),
+            observations: z627.array(z627.string()).describe("Observations to delete")
           }))
         }
       },
@@ -170334,10 +170619,10 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Delete Relations",
         description: "Delete multiple relations from the knowledge graph",
         inputSchema: {
-          relations: z626.array(z626.object({
-            from: z626.string(),
-            to: z626.string(),
-            relationType: z626.string()
+          relations: z627.array(z627.object({
+            from: z627.string(),
+            to: z627.string(),
+            relationType: z627.string()
           }))
         }
       },
@@ -170386,7 +170671,7 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Search Nodes",
         description: "Search for nodes in the knowledge graph based on a query",
         inputSchema: {
-          query: z626.string().describe("Search query to match against entity names, types, and observations")
+          query: z627.string().describe("Search query to match against entity names, types, and observations")
         }
       },
       async ({ query }) => {
@@ -170405,7 +170690,7 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
         title: "Open Nodes",
         description: "Open specific nodes in the knowledge graph by their names",
         inputSchema: {
-          names: z626.array(z626.string()).describe("Entity names to retrieve")
+          names: z627.array(z627.string()).describe("Entity names to retrieve")
         }
       },
       async ({ names }) => {
@@ -170427,8 +170712,8 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
       title: "Rules Sync",
       description: "Scan project for agent rule files (Cursor, Claude Code, Codex, Windsurf, Antigravity, Gemini CLI, Copilot, Kiro, OpenCode, Trae), deduplicate, detect conflicts, and optionally generate rules for a target agent format. Without target: returns sync status report. With target: generates converted rule files.",
       inputSchema: {
-        action: z626.enum(["status", "generate"]).describe('Action: "status" for report, "generate" to produce target files'),
-        target: z626.enum(RULE_SOURCES).optional().describe("Target agent format for generation (required when action=generate)")
+        action: z627.enum(["status", "generate"]).describe('Action: "status" for report, "generate" to produce target files'),
+        target: z627.enum(RULE_SOURCES).optional().describe("Target agent format for generation (required when action=generate)")
       }
     },
     async ({ action, target }) => {
@@ -170483,9 +170768,9 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
       title: "Workspace Sync",
       description: 'Migrate your entire workspace environment between AI coding agents (Cursor, Windsurf, Claude Code, Codex, Copilot, Gemini CLI, OpenClaw, Hermes Agent, Oh-my-Pi, Kiro, Antigravity, OpenCode, Trae). Syncs MCP server configs, workflows, rules, and skills across IDEs. Action "scan": detect all workspace configs. Action "migrate": generate configs for target agent (preview only). Action "apply": migrate AND write configs to disk with backup/rollback.',
       inputSchema: {
-        action: z626.enum(["scan", "migrate", "apply"]).describe('Action: "scan" to detect configs, "migrate" to preview, "apply" to write to disk'),
-        target: z626.enum(AGENT_TARGETS).optional().describe("Target agent for migration (required for migrate)"),
-        items: z626.array(z626.string()).optional().describe('Selective sync: list specific MCP server or skill names to sync (e.g. ["figma-remote-mcp-server", "create-subagent"]). Omit to sync all.')
+        action: z627.enum(["scan", "migrate", "apply"]).describe('Action: "scan" to detect configs, "migrate" to preview, "apply" to write to disk'),
+        target: z627.enum(AGENT_TARGETS).optional().describe("Target agent for migration (required for migrate)"),
+        items: z627.array(z627.string()).optional().describe('Selective sync: list specific MCP server or skill names to sync (e.g. ["figma-remote-mcp-server", "create-subagent"]). Omit to sync all.')
       }
     },
     async ({ action, target, items }) => {
@@ -170581,10 +170866,10 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
       title: "Project Skills",
       description: `Memory-driven project skills. Action "list": show all available skills from all agents. Action "generate": auto-generate project-specific skills from observation patterns (gotchas, decisions, how-it-works). Action "inject": return a specific skill's full content for direct use. Generated skills follow the SKILL.md standard and can be synced across Cursor, Windsurf, Claude Code, Codex, Copilot, Kiro, Antigravity, OpenCode, and Trae. OpenClaw, Hermes Agent, and Oh-my-Pi receive skills through their official bundle/plugin/package setup lanes rather than generic workspace skill copy.`,
       inputSchema: {
-        action: z626.enum(["list", "generate", "inject"]).describe('Action: "list" to discover skills, "generate" to create from memory, "inject" to get skill content'),
-        name: z626.string().optional().describe('Skill name (required for "inject")'),
-        target: z626.enum(AGENT_TARGETS).optional().describe('Target agent to write generated skills to (optional for "generate")'),
-        write: z626.boolean().optional().describe("Whether to write generated skills to disk (default: false, preview only)")
+        action: z627.enum(["list", "generate", "inject"]).describe('Action: "list" to discover skills, "generate" to create from memory, "inject" to get skill content'),
+        name: z627.string().optional().describe('Skill name (required for "inject")'),
+        target: z627.enum(AGENT_TARGETS).optional().describe('Target agent to write generated skills to (optional for "generate")'),
+        write: z627.boolean().optional().describe("Whether to write generated skills to disk (default: false, preview only)")
       }
     },
     async ({ action, name, target, write }) => {
@@ -170694,12 +170979,12 @@ ${skill2.content}` }]
       title: "Promote to Mini-Skill",
       description: 'Promote observations to permanent mini-skills that never decay and are auto-injected at session start. Action "promote": convert observation(s) to a mini-skill. Action "list": show all active mini-skills. Action "delete": remove a mini-skill by ID.\n\nMini-skills are project-specific specialized knowledge derived from your actual memories \u2014 gotchas, decisions, fixes that generic online skills cannot provide.',
       inputSchema: {
-        action: z626.enum(["promote", "list", "delete"]).describe("Action to perform"),
-        observationIds: z626.array(z626.number()).optional().describe('Observation IDs to promote (required for "promote")'),
-        skillId: z626.number().optional().describe('Mini-skill ID to delete (required for "delete")'),
-        trigger: z626.string().optional().describe("Override: when this skill should be applied"),
-        instruction: z626.string().optional().describe("Override: what the agent should do"),
-        tags: z626.array(z626.string()).optional().describe("Extra classification tags")
+        action: z627.enum(["promote", "list", "delete"]).describe("Action to perform"),
+        observationIds: z627.array(z627.number()).optional().describe('Observation IDs to promote (required for "promote")'),
+        skillId: z627.number().optional().describe('Mini-skill ID to delete (required for "delete")'),
+        trigger: z627.string().optional().describe("Override: when this skill should be applied"),
+        instruction: z627.string().optional().describe("Override: what the agent should do"),
+        tags: z627.array(z627.string()).optional().describe("Extra classification tags")
       }
     },
     async ({ action, observationIds, skillId, trigger, instruction, tags }) => {
@@ -170778,8 +171063,8 @@ ${skill2.content}` }]
       title: "Consolidate Memories",
       description: 'Find and merge similar observations to reduce memory bloat. Uses text similarity to cluster related observations by entity+type, then merges them into single consolidated records. Use action="preview" to see candidates without changing data, action="execute" to merge.\n\nExample: 10 similar gotchas about Windows paths \u2192 1 consolidated gotcha with all facts preserved.',
       inputSchema: {
-        action: z626.enum(["preview", "execute"]).describe("preview = dry run showing candidates, execute = actually merge"),
-        threshold: z626.number().optional().describe("Similarity threshold 0.0-1.0 (default: 0.45). Lower = more aggressive merging")
+        action: z627.enum(["preview", "execute"]).describe("preview = dry run showing candidates, execute = actually merge"),
+        threshold: z627.number().optional().describe("Similarity threshold 0.0-1.0 (default: 0.45). Lower = more aggressive merging")
       }
     },
     async ({ action, threshold }) => {
@@ -170825,13 +171110,13 @@ ${skill2.content}` }]
       title: "Start Session",
       description: "Start a new coding session. Returns a compact continuation card with the latest handoff and a few memory references. Call this at the beginning of a session to track activity; retrieve a referenced memory only when it is relevant. Any previous active session for this project will be auto-closed. By default this is lightweight: it binds the project, opens a session, and avoids dumping full history into the new context. Coordination identity is opt-in via `joinTeam: true` or a separate `team_manage` join call.\n\nIMPORTANT for HTTP/control-plane mode: pass `projectRoot` with the absolute path to your workspace root (e.g., the directory open in your IDE). Memorix uses this to detect the git project and bind this session to the correct project context. Without it, project-scoped tools will be disabled.",
       inputSchema: {
-        sessionId: z626.string().optional().describe("Custom session ID (auto-generated if omitted)"),
-        agent: z626.string().optional().describe('Agent/IDE name (e.g., "cursor", "windsurf", "claude-code")'),
-        agentType: z626.string().optional().describe('Agent type used for optional coordination identity mapping (e.g., "windsurf", "cursor").'),
-        instanceId: z626.string().optional().describe("Stable instance ID for optional coordination identity across restarts. If omitted with joinTeam=true, Memorix derives a deterministic fallback from the project and agent identity."),
-        joinTeam: z626.boolean().optional().describe("If true, also join orchestration coordination state for this session. Defaults to false."),
-        role: z626.string().optional().describe("Explicit role override used only when joinTeam=true."),
-        projectRoot: z626.string().optional().describe(
+        sessionId: z627.string().optional().describe("Custom session ID (auto-generated if omitted)"),
+        agent: z627.string().optional().describe('Agent/IDE name (e.g., "cursor", "windsurf", "claude-code")'),
+        agentType: z627.string().optional().describe('Agent type used for optional coordination identity mapping (e.g., "windsurf", "cursor").'),
+        instanceId: z627.string().optional().describe("Stable instance ID for optional coordination identity across restarts. If omitted with joinTeam=true, Memorix derives a deterministic fallback from the project and agent identity."),
+        joinTeam: z627.boolean().optional().describe("If true, also join orchestration coordination state for this session. Defaults to false."),
+        role: z627.string().optional().describe("Explicit role override used only when joinTeam=true."),
+        projectRoot: z627.string().optional().describe(
           "Absolute path to the workspace/project root directory (e.g., the folder open in your IDE). Memorix will detect the git project from this path and bind this session to it. Required for HTTP transport when multiple projects are open simultaneously or when rebinding an existing control-plane session."
         )
       }
@@ -171038,8 +171323,8 @@ ${s2.instruction}`.toLowerCase();
       title: "End Session",
       description: "End a coding session with a structured summary. This summary will be injected into the next session so the next agent can resume work seamlessly.\n\nRecommended summary format:\n## Goal\n[What we were working on]\n\n## Discoveries\n- [Technical findings, gotchas, learnings]\n\n## Accomplished\n- [OK] [Completed tasks]\n- [PENDING] [Pending for next session]\n\n## Relevant Files\n- path/to/file \u2014 [what changed]",
       inputSchema: {
-        sessionId: z626.string().describe("Session ID to close (from memorix_session_start)"),
-        summary: z626.string().optional().describe("Structured session summary (Goal/Discoveries/Accomplished/Files format)")
+        sessionId: z627.string().describe("Session ID to close (from memorix_session_start)"),
+        summary: z627.string().optional().describe("Structured session summary (Goal/Discoveries/Accomplished/Files format)")
       }
     },
     async ({ sessionId, summary }) => {
@@ -171067,7 +171352,7 @@ ${summary ? "Summary saved for next session context injection." : "No summary pr
       title: "Session Context",
       description: "Get context from previous coding sessions. Use this after compaction to recover lost context, or to manually review session history. Returns previous session summaries and key observations.",
       inputSchema: {
-        limit: z626.number().optional().describe("Number of recent sessions to include (default: 3)")
+        limit: z627.number().optional().describe("Number of recent sessions to include (default: 3)")
       }
     },
     async ({ limit: limit2 }) => {
@@ -171100,14 +171385,14 @@ ${summary ? "Summary saved for next session context injection." : "No summary pr
       title: "Compact Continuity Checkpoints",
       description: "Inspect, preview, or archive bounded checkpoints recorded around a host-native context compaction. Use only to debug or explicitly review compaction continuity. These are lifecycle records, not durable memories or transcript backups. CLI equivalent: memorix checkpoint list|show|context|archive.",
       inputSchema: {
-        action: z626.enum(["list", "show", "context", "archive"]).default("list"),
-        id: z626.string().optional().describe("Checkpoint ID for show, context, or archive"),
-        sessionId: z626.string().optional().describe("Optional host session ID filter"),
-        agent: z626.string().optional().describe("Optional host agent filter"),
-        task: z626.string().optional().describe("Current task for a bounded context preview"),
-        maxTokens: z626.number().optional().describe("Maximum tokens for action=context (default: 420)"),
-        limit: z626.number().optional().describe("Maximum records for action=list (default: 20)"),
-        includeArchived: z626.boolean().optional().default(false).describe("Include archived records in action=list")
+        action: z627.enum(["list", "show", "context", "archive"]).default("list"),
+        id: z627.string().optional().describe("Checkpoint ID for show, context, or archive"),
+        sessionId: z627.string().optional().describe("Optional host session ID filter"),
+        agent: z627.string().optional().describe("Optional host agent filter"),
+        task: z627.string().optional().describe("Current task for a bounded context preview"),
+        maxTokens: z627.number().optional().describe("Maximum tokens for action=context (default: 420)"),
+        limit: z627.number().optional().describe("Maximum records for action=list (default: 20)"),
+        includeArchived: z627.boolean().optional().default(false).describe("Include archived records in action=list")
       }
     },
     async ({ action, id, sessionId, agent, task, maxTokens, limit: limit2, includeArchived }) => {
@@ -171180,9 +171465,9 @@ ${summary ? "Summary saved for next session context injection." : "No summary pr
       title: "Transfer Memories",
       description: 'Export or import project memories. Action "export": export observations visible to the current agent and project sessions (JSON or Markdown). Action "import": import from a JSON export (re-assigns IDs, skips duplicate topicKeys).',
       inputSchema: {
-        action: z626.enum(["export", "import"]).describe("Operation: export or import"),
-        format: z626.enum(["json", "markdown"]).optional().describe("Export format (for export, default: json)"),
-        data: z626.string().optional().describe("JSON string from a previous export (for import)")
+        action: z627.enum(["export", "import"]).describe("Operation: export or import"),
+        format: z627.enum(["json", "markdown"]).optional().describe("Export format (for export, default: json)"),
+        data: z627.string().optional().describe("JSON string from a previous export (for import)")
       }
     },
     async ({ action, format, data: jsonStr }) => {
@@ -171231,7 +171516,7 @@ ${json2}
       title: "Launch Dashboard",
       description: "Launch the Memorix Web Dashboard in the browser. In HTTP control-plane mode, this reuses the current control-plane dashboard. In stdio/standalone mode, it starts the standalone dashboard server.",
       inputSchema: {
-        port: z626.number().optional().describe("Optional port override for standalone mode. In HTTP control-plane mode, the active dashboard port is reused.")
+        port: z627.number().optional().describe("Optional port override for standalone mode. In HTTP control-plane mode, the active dashboard port is reused.")
       }
     },
     async ({ port: dashboardPort }) => {
@@ -171395,13 +171680,13 @@ ${json2}
       title: "Evidence Cards",
       description: "Inspect the bounded, project-scoped provenance cards behind Memorix context. Use list for a compact index, get/events for one source, sync to repair the projection, and stale when known source files changed. Cards expose sourceRef, locator, capturedHash, and freshness.",
       inputSchema: {
-        action: z626.enum(["list", "get", "sync", "stale", "events"]).describe("Evidence operation"),
-        candidateKind: z626.enum(["observation", "code", "git", "test", "document", "workflow", "graph"]).optional().default("observation"),
-        candidateId: z626.string().optional().describe("Candidate id, usually an observation id"),
-        query: z626.string().optional().describe("Optional title/source query for list"),
-        paths: z626.array(z626.string()).max(200).optional().describe("Changed source paths for stale"),
-        reason: z626.string().max(500).optional().describe("Why evidence became stale"),
-        limit: z626.number().int().positive().max(100).optional().default(20)
+        action: z627.enum(["list", "get", "sync", "stale", "events"]).describe("Evidence operation"),
+        candidateKind: z627.enum(["observation", "code", "git", "test", "document", "workflow", "graph"]).optional().default("observation"),
+        candidateId: z627.string().optional().describe("Candidate id, usually an observation id"),
+        query: z627.string().optional().describe("Optional title/source query for list"),
+        paths: z627.array(z627.string()).max(200).optional().describe("Changed source paths for stale"),
+        reason: z627.string().max(500).optional().describe("Why evidence became stale"),
+        limit: z627.number().int().positive().max(100).optional().default(20)
       }
     },
     async ({ action, candidateKind, candidateId, query, paths, reason, limit: limit2 }) => {
@@ -171441,15 +171726,15 @@ ${json2}
       title: "Memory Feedback",
       description: "Record or inspect auditable memory outcomes. Positive verification/use strengthens recall; correction, conflict, source change, or weaken lowers it. Use revoke with targetEventId to undo one prior signal without deleting audit history.",
       inputSchema: {
-        action: z626.enum(["record", "show", "audit"]).describe("Feedback operation"),
-        candidateKind: z626.enum(["observation", "claim", "durable-memory", "workflow"]).optional().default("observation"),
-        candidateId: z626.string().describe("Memory or knowledge candidate id"),
-        signal: z626.enum(["user-correction", "verification-success", "verification-failure", "code-change", "used", "not-used", "code-conflict", "strengthen", "weaken", "revoke"]).optional(),
-        sourceRef: z626.string().max(500).optional().describe("Source of this feedback, such as test:run-42 or user:chat"),
-        actor: z626.string().max(200).optional(),
-        note: z626.string().max(2e3).optional(),
-        targetEventId: z626.string().optional().describe("Existing event id when action=record and signal=revoke"),
-        limit: z626.number().int().positive().max(200).optional().default(100)
+        action: z627.enum(["record", "show", "audit"]).describe("Feedback operation"),
+        candidateKind: z627.enum(["observation", "claim", "durable-memory", "workflow"]).optional().default("observation"),
+        candidateId: z627.string().describe("Memory or knowledge candidate id"),
+        signal: z627.enum(["user-correction", "verification-success", "verification-failure", "code-change", "used", "not-used", "code-conflict", "strengthen", "weaken", "revoke"]).optional(),
+        sourceRef: z627.string().max(500).optional().describe("Source of this feedback, such as test:run-42 or user:chat"),
+        actor: z627.string().max(200).optional(),
+        note: z627.string().max(2e3).optional(),
+        targetEventId: z627.string().optional().describe("Existing event id when action=record and signal=revoke"),
+        limit: z627.number().int().positive().max(200).optional().default(100)
       }
     },
     async ({ action, candidateKind, candidateId, signal, sourceRef, actor, note, targetEventId, limit: limit2 }) => {
@@ -171515,19 +171800,19 @@ ${json2}
       title: "Coordination Management",
       description: 'Register, unregister, or list agents in the project coordination state. Action "join": register this agent (returns agent ID and instance ID for reactivation). Action "leave": mark agent inactive, release locks. Action "status": list all agents with roles and capabilities, plus role occupancy. Action "listRoles": show defined roles for this project. Action "addRole": define a new role for this project. Action "removeRole": remove a role definition.',
       inputSchema: {
-        action: z626.enum(["join", "leave", "status", "listRoles", "addRole", "removeRole"]).describe("Operation to perform"),
-        name: z626.string().optional().describe('Agent display name for join (e.g., "cursor-frontend")'),
-        agentType: z626.string().optional().describe('Agent type for join (e.g., "windsurf", "cursor", "claude-code")'),
-        instanceId: z626.string().optional().describe("Stable instance ID for join (preserves identity across restarts)"),
-        role: z626.string().optional().describe("Agent role for join (defaults by agentType if omitted)"),
-        capabilities: z626.array(z626.string()).optional().describe("Agent capabilities for join"),
-        agentId: z626.string().optional().describe("Agent ID for leave"),
+        action: z627.enum(["join", "leave", "status", "listRoles", "addRole", "removeRole"]).describe("Operation to perform"),
+        name: z627.string().optional().describe('Agent display name for join (e.g., "cursor-frontend")'),
+        agentType: z627.string().optional().describe('Agent type for join (e.g., "windsurf", "cursor", "claude-code")'),
+        instanceId: z627.string().optional().describe("Stable instance ID for join (preserves identity across restarts)"),
+        role: z627.string().optional().describe("Agent role for join (defaults by agentType if omitted)"),
+        capabilities: z627.array(z627.string()).optional().describe("Agent capabilities for join"),
+        agentId: z627.string().optional().describe("Agent ID for leave"),
         // Role management params
-        roleId: z626.string().optional().describe("Role ID (for addRole/removeRole)"),
-        label: z626.string().optional().describe("Role label (for addRole)"),
-        roleDescription: z626.string().optional().describe("Role description (for addRole)"),
-        preferredAgentTypes: z626.array(z626.string()).optional().describe("Preferred agent types for this role (for addRole)"),
-        maxConcurrent: z626.number().optional().describe("Max concurrent agents for this role (for addRole, default 1)")
+        roleId: z627.string().optional().describe("Role ID (for addRole/removeRole)"),
+        label: z627.string().optional().describe("Role label (for addRole)"),
+        roleDescription: z627.string().optional().describe("Role description (for addRole)"),
+        preferredAgentTypes: z627.array(z627.string()).optional().describe("Preferred agent types for this role (for addRole)"),
+        maxConcurrent: z627.number().optional().describe("Max concurrent agents for this role (for addRole, default 1)")
       }
     },
     async ({ action, name, agentType, instanceId, role, capabilities, agentId, roleId, label, roleDescription, preferredAgentTypes, maxConcurrent }) => {
@@ -171640,9 +171925,9 @@ ${agentLines.join("\n")}`
       title: "File Lock Management",
       description: 'Advisory file locks to prevent conflicting edits. Auto-releases after 10 min TTL. Action "lock": acquire lock. Action "unlock": release lock. Action "status": check lock status.',
       inputSchema: {
-        action: z626.enum(["lock", "unlock", "status"]).describe("Operation to perform"),
-        file: z626.string().optional().describe("File path (required for lock/unlock, optional for status \u2014 omit to list all)"),
-        agentId: z626.string().optional().describe("Agent ID (required for lock/unlock)")
+        action: z627.enum(["lock", "unlock", "status"]).describe("Operation to perform"),
+        file: z627.string().optional().describe("File path (required for lock/unlock, optional for status \u2014 omit to list all)"),
+        agentId: z627.string().optional().describe("Agent ID (required for lock/unlock)")
       }
     },
     async ({ action, file, agentId }) => {
@@ -171684,17 +171969,17 @@ ${lines.join("\n")}` }] };
       title: "Task Status",
       description: 'Create, claim, complete, or list tasks in the team task board. Supports dependencies. Action "create": create a task. Action "claim": assign to yourself (atomic, race-safe). Action "complete": mark done with result. Action "list": show tasks.',
       inputSchema: {
-        action: z626.enum(["create", "claim", "complete", "list"]).describe("Operation to perform"),
-        description: z626.string().optional().describe("Task description (for create)"),
-        deps: z626.array(z626.string()).optional().describe("Dependency task IDs (for create)"),
-        taskId: z626.string().optional().describe("Task ID (for claim/complete)"),
-        agentId: z626.string().optional().describe("Agent ID (for claim/complete)"),
-        result: z626.string().optional().describe("Result summary (for complete)"),
-        status: z626.enum(["pending", "in_progress", "completed", "failed"]).optional().describe("Filter by status (for list)"),
-        available: z626.boolean().optional().describe("Show only claimable tasks (for list)"),
-        metadata: z626.string().optional().describe("JSON metadata for the task (for create). Used by planner/review tasks for autonomous mode."),
-        requiredRole: z626.string().optional().describe("Required role for this task (for create). Agents without this role cannot claim."),
-        preferredRole: z626.string().optional().describe("Preferred role for this task (for create). Agents with this role are prioritized.")
+        action: z627.enum(["create", "claim", "complete", "list"]).describe("Operation to perform"),
+        description: z627.string().optional().describe("Task description (for create)"),
+        deps: z627.array(z627.string()).optional().describe("Dependency task IDs (for create)"),
+        taskId: z627.string().optional().describe("Task ID (for claim/complete)"),
+        agentId: z627.string().optional().describe("Agent ID (for claim/complete)"),
+        result: z627.string().optional().describe("Result summary (for complete)"),
+        status: z627.enum(["pending", "in_progress", "completed", "failed"]).optional().describe("Filter by status (for list)"),
+        available: z627.boolean().optional().describe("Show only claimable tasks (for list)"),
+        metadata: z627.string().optional().describe("JSON metadata for the task (for create). Used by planner/review tasks for autonomous mode."),
+        requiredRole: z627.string().optional().describe("Required role for this task (for create). Agents without this role cannot claim."),
+        preferredRole: z627.string().optional().describe("Preferred role for this task (for create). Agents with this role are prioritized.")
       }
     },
     async ({ action, description: desc, deps, taskId, agentId, result, status, available, metadata, requiredRole, preferredRole }) => {
@@ -171767,15 +172052,15 @@ ${lines.join("\n")}` }] };
       title: "Team Messaging",
       description: `Send, broadcast, or read messages between agents. Durable: messages survive restarts and reach inactive recipients. Action "send": direct message to one agent. Action "broadcast": message all agents. Action "inbox": read this agent's inbox.`,
       inputSchema: {
-        action: z626.enum(["send", "broadcast", "inbox"]).describe("Operation to perform"),
-        from: z626.string().optional().describe("Your sender agent ID. Omit it to use this session identity."),
-        to: z626.string().optional().describe("Receiver agent ID (for send)"),
-        type: z626.enum(["request", "response", "info", "announcement", "contract", "error", "handoff"]).optional().describe("Message type (for send/broadcast)"),
-        content: z626.string().optional().describe("Message content (for send/broadcast)"),
-        agentId: z626.string().optional().describe("Agent ID (for inbox)"),
-        markRead: z626.boolean().optional().default(false).describe("Mark messages as read (for inbox)"),
-        toRole: z626.string().optional().describe("Target role for role-based messaging/handoff (for send)"),
-        handoffStatus: z626.enum(["open", "claimed", "completed", "archived"]).optional().describe("Handoff status (for send with type=handoff)")
+        action: z627.enum(["send", "broadcast", "inbox"]).describe("Operation to perform"),
+        from: z627.string().optional().describe("Your sender agent ID. Omit it to use this session identity."),
+        to: z627.string().optional().describe("Receiver agent ID (for send)"),
+        type: z627.enum(["request", "response", "info", "announcement", "contract", "error", "handoff"]).optional().describe("Message type (for send/broadcast)"),
+        content: z627.string().optional().describe("Message content (for send/broadcast)"),
+        agentId: z627.string().optional().describe("Agent ID (for inbox)"),
+        markRead: z627.boolean().optional().default(false).describe("Mark messages as read (for inbox)"),
+        toRole: z627.string().optional().describe("Target role for role-based messaging/handoff (for send)"),
+        handoffStatus: z627.enum(["open", "claimed", "completed", "archived"]).optional().describe("Handoff status (for send with type=handoff)")
       }
     },
     async ({ action, from, to, type: msgType, content, agentId, markRead, toRole, handoffStatus }) => {
@@ -171845,8 +172130,8 @@ ${lines.join("\n")}` }] };
       title: "Team Poll \u2014 Situational Awareness",
       description: "Get a full snapshot of your project coordination state in one call. Returns: your agent info, watermark (new observations since last session), inbox (unread messages), tasks (your in-progress, available to claim, completed, failed), and team roster (active agents). Use this to decide what to work on next.",
       inputSchema: {
-        agentId: z626.string().optional().describe("Your agent ID (from team_manage join or session_start with joinTeam=true). If omitted, returns project-level overview only."),
-        markInboxRead: z626.boolean().optional().describe("If true, mark all inbox messages as read after returning them.")
+        agentId: z627.string().optional().describe("Your agent ID (from team_manage join or session_start with joinTeam=true). If omitted, returns project-level overview only."),
+        markInboxRead: z627.boolean().optional().describe("If true, mark all inbox messages as read after returning them.")
       }
     },
     async ({ agentId, markInboxRead }) => {
@@ -171940,13 +172225,13 @@ ${lines.join("\n")}` }] };
       title: "Team Handoff \u2014 Agent Context Transfer",
       description: "Create a structured handoff artifact when passing work to another agent. A targeted handoff is visible only to its sender and recipient; a broadcast handoff is team-visible. The handoff is stored as a durable observation (immune to archival) and a notification message is sent to the recipient. Use this when completing a task and another agent should continue, or when you want to leave context for whoever works on this next.",
       inputSchema: {
-        fromAgentId: z626.string().describe("Your agent ID (from team_manage join or session_start with joinTeam=true)"),
-        summary: z626.string().describe("Human-readable summary of what you did and what needs to happen next"),
-        context: z626.string().describe("Detailed context for the next agent: what was done, current state, known issues, next steps"),
-        toAgentId: z626.string().optional().describe("Specific recipient agent ID. Omit to broadcast to all."),
-        taskId: z626.string().optional().describe("Link to a specific team_task ID"),
-        filesModified: z626.array(z626.string()).optional().describe("Files you modified during this work"),
-        concepts: z626.array(z626.string()).optional().describe("Key concepts for search discoverability")
+        fromAgentId: z627.string().describe("Your agent ID (from team_manage join or session_start with joinTeam=true)"),
+        summary: z627.string().describe("Human-readable summary of what you did and what needs to happen next"),
+        context: z627.string().describe("Detailed context for the next agent: what was done, current state, known issues, next steps"),
+        toAgentId: z627.string().optional().describe("Specific recipient agent ID. Omit to broadcast to all."),
+        taskId: z627.string().optional().describe("Link to a specific team_task ID"),
+        filesModified: z627.array(z627.string()).optional().describe("Files you modified during this work"),
+        concepts: z627.array(z627.string()).optional().describe("Key concepts for search discoverability")
       }
     },
     async ({ fromAgentId, summary, context, toAgentId, taskId, filesModified, concepts }) => {
@@ -172026,7 +172311,7 @@ ${lines.join("\n")}` }] };
       title: "Manage Controlled Media",
       description: "Use the controlled local media library for an explicit import, attachment, inspection, or MiniMax generation request. Assets stay outside the Git worktree and enter normal memory only when attach is explicitly true. Use the CLI for destructive removal, quota cleanup, and direct generation. MCP generation is disabled by default and requires MEMORIX_MCP_MEDIA_GENERATION=1 after the operator reviews provider billing.",
       inputSchema: {
-        action: z626.enum([
+        action: z627.enum([
           "import",
           "attach",
           "list",
@@ -172037,32 +172322,32 @@ ${lines.join("\n")}` }] };
           ...mediaTranscriptionEnabled ? ["derive-audio"] : [],
           ...mediaGenerationEnabled ? ["generate-image", "generate-video"] : []
         ]),
-        path: z626.string().optional().describe("Explicit local image/audio/video/PDF path for import."),
-        assetId: z626.string().optional().describe("Controlled MediaAsset ID for attach/show."),
-        jobId: z626.string().optional().describe("Durable media job ID for status."),
-        kind: z626.enum(["image", "audio", "video", "document"]).optional().describe("Optional asset list filter."),
-        limit: z626.number().int().min(1).max(100).optional().describe("Maximum assets to list."),
-        title: z626.string().optional().describe("Observation title when attaching generated/imported output."),
-        narrative: z626.string().optional().describe("Short retrieval text when attaching an asset."),
-        maxPages: z626.number().int().min(1).max(100).optional().describe("Bounded PDF extraction page limit."),
-        maxChars: z626.number().int().min(1).max(6e4).optional().describe("Bounded PDF extraction character limit."),
-        attach: z626.boolean().optional().describe("Attach generated/imported output to normal project memory explicitly."),
+        path: z627.string().optional().describe("Explicit local image/audio/video/PDF path for import."),
+        assetId: z627.string().optional().describe("Controlled MediaAsset ID for attach/show."),
+        jobId: z627.string().optional().describe("Durable media job ID for status."),
+        kind: z627.enum(["image", "audio", "video", "document"]).optional().describe("Optional asset list filter."),
+        limit: z627.number().int().min(1).max(100).optional().describe("Maximum assets to list."),
+        title: z627.string().optional().describe("Observation title when attaching generated/imported output."),
+        narrative: z627.string().optional().describe("Short retrieval text when attaching an asset."),
+        maxPages: z627.number().int().min(1).max(100).optional().describe("Bounded PDF extraction page limit."),
+        maxChars: z627.number().int().min(1).max(6e4).optional().describe("Bounded PDF extraction character limit."),
+        attach: z627.boolean().optional().describe("Attach generated/imported output to normal project memory explicitly."),
         ...mediaGenerationOrTranscription ? {
-          model: z626.string().max(160).optional().describe("Provider model for the selected media action."),
-          prompt: z626.string().optional().describe("Explicit prompt for generation or transcription.")
+          model: z627.string().max(160).optional().describe("Provider model for the selected media action."),
+          prompt: z627.string().optional().describe("Explicit prompt for generation or transcription.")
         } : {},
         ...mediaTranscriptionEnabled ? {
-          provider: z626.enum(["openai", "groq"]).optional().describe("Explicit audio transcription provider."),
-          language: z626.string().max(32).optional().describe("Optional ISO-639-1 hint for audio transcription.")
+          provider: z627.enum(["openai", "groq"]).optional().describe("Explicit audio transcription provider."),
+          language: z627.string().max(32).optional().describe("Optional ISO-639-1 hint for audio transcription.")
         } : {},
         ...mediaGenerationEnabled ? {
-          image: z626.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
-          region: z626.enum(["global", "cn"]).optional().describe("MiniMax deployment region."),
-          n: z626.number().int().min(1).max(4).optional().describe("Image output count."),
-          ratio: z626.enum(["adaptive", "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"]).optional().describe("Image or video aspect ratio."),
-          width: z626.number().int().min(1).max(8192).optional().describe("Requested image width."),
-          height: z626.number().int().min(1).max(8192).optional().describe("Requested image height."),
-          duration: z626.union([z626.literal(5), z626.literal(10)]).optional().describe("MiniMax video duration in seconds.")
+          image: z627.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
+          region: z627.enum(["global", "cn"]).optional().describe("MiniMax deployment region."),
+          n: z627.number().int().min(1).max(4).optional().describe("Image output count."),
+          ratio: z627.enum(["adaptive", "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"]).optional().describe("Image or video aspect ratio."),
+          width: z627.number().int().min(1).max(8192).optional().describe("Requested image width."),
+          height: z627.number().int().min(1).max(8192).optional().describe("Requested image height."),
+          duration: z627.union([z627.literal(5), z627.literal(10)]).optional().describe("MiniMax video duration in seconds.")
         } : {}
       }
     },
@@ -172260,10 +172545,10 @@ ${lines.join("\n")}` }] };
       title: "Ingest Image",
       description: "Legacy compatibility path: import caller-provided image bytes into the controlled local asset library, then store a text retrieval projection. For durable media operations, prefer memorix_media or the media CLI.",
       inputSchema: {
-        base64: z626.string().describe("Base64-encoded image data"),
-        mimeType: z626.string().optional().describe("Deprecated compatibility hint. Memorix detects the actual MIME type from the image bytes."),
-        filename: z626.string().optional().describe("Original filename"),
-        prompt: z626.string().optional().describe("Custom analysis prompt")
+        base64: z627.string().describe("Base64-encoded image data"),
+        mimeType: z627.string().optional().describe("Deprecated compatibility hint. Memorix detects the actual MIME type from the image bytes."),
+        filename: z627.string().optional().describe("Original filename"),
+        prompt: z627.string().optional().describe("Custom analysis prompt")
       }
     },
     async (args) => {
@@ -172563,6 +172848,7 @@ var init_server2 = __esm({
     init_secret_filter();
     init_surfaced_registry();
     init_request_context();
+    init_mcp_compat();
     FORMATION_TIMEOUT_MS = parseFormationTimeoutMs(process.env.MEMORIX_FORMATION_TIMEOUT_MS);
     COMPACT_ON_WRITE_TIMEOUT_MS = 12e3;
     COMPRESSION_TIMEOUT_MS = 5e3;
@@ -172591,6 +172877,218 @@ var init_server2 = __esm({
   }
 });
 
+// src/server/stdio-startup-gate.ts
+import { PassThrough as PassThrough3 } from "stream";
+var STDIO_STARTUP_GATE_MAX_BUFFER_SIZE, StdioStartupGate;
+var init_stdio_startup_gate = __esm({
+  "src/server/stdio-startup-gate.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_mcp_discovery();
+    STDIO_STARTUP_GATE_MAX_BUFFER_SIZE = 10 * 1024 * 1024;
+    StdioStartupGate = class {
+      input = new PassThrough3();
+      stdin;
+      stdout;
+      serverInfo;
+      maxBufferSize;
+      onError;
+      onEnd;
+      queuedMessages = [];
+      pendingInput = "";
+      queuedBytes = 0;
+      started = false;
+      ready = false;
+      stopped = false;
+      stdinEnded = false;
+      endNotified = false;
+      onData = (chunk) => {
+        if (this.stopped) return;
+        if (this.ready) {
+          if (Buffer.byteLength(chunk, "utf8") > this.maxBufferSize) {
+            this.fail(new Error(`stdio input chunk exceeded ${this.maxBufferSize} bytes`));
+            return;
+          }
+          this.input.write(chunk);
+          return;
+        }
+        const text2 = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+        if (this.queuedBytes + Buffer.byteLength(this.pendingInput, "utf8") + Buffer.byteLength(text2, "utf8") > this.maxBufferSize) {
+          this.fail(new Error(`stdio startup input exceeded ${this.maxBufferSize} bytes before a complete JSON-RPC line`));
+          return;
+        }
+        this.pendingInput += text2;
+        let newline = this.pendingInput.indexOf("\n");
+        while (newline >= 0 && !this.stopped) {
+          const line = this.pendingInput.slice(0, newline + 1);
+          this.pendingInput = this.pendingInput.slice(newline + 1);
+          this.handleLine(line);
+          newline = this.pendingInput.indexOf("\n");
+        }
+        if (!this.stopped && Buffer.byteLength(this.pendingInput, "utf8") > this.maxBufferSize) {
+          this.fail(new Error(`stdio startup input exceeded ${this.maxBufferSize} bytes`));
+        }
+      };
+      onStdinError = (error) => {
+        this.fail(error);
+      };
+      onStdinEnd = () => {
+        this.stdinEnded = true;
+        if (this.ready) this.finishInput();
+      };
+      constructor(options) {
+        this.stdin = options.stdin;
+        this.stdout = options.stdout;
+        this.serverInfo = { ...options.serverInfo };
+        this.maxBufferSize = options.maxBufferSize ?? STDIO_STARTUP_GATE_MAX_BUFFER_SIZE;
+        this.onError = options.onError;
+        this.onEnd = options.onEnd;
+      }
+      start() {
+        if (this.started || this.stopped) return;
+        this.started = true;
+        this.stdin.on("data", this.onData);
+        this.stdin.on("error", this.onStdinError);
+        this.stdin.on("end", this.onStdinEnd);
+      }
+      /** Release queued messages only after StdioServerTransport has installed its listener. */
+      markReady() {
+        if (this.stopped || this.ready) return;
+        this.ready = true;
+        for (const message of this.queuedMessages) this.input.write(message);
+        this.queuedMessages.length = 0;
+        this.queuedBytes = 0;
+        if (this.pendingInput) {
+          this.input.write(this.pendingInput);
+          this.pendingInput = "";
+        }
+        if (this.stdinEnded) this.finishInput();
+      }
+      stop() {
+        if (this.stopped) return;
+        this.stopped = true;
+        this.stdin.off("data", this.onData);
+        this.stdin.off("error", this.onStdinError);
+        this.stdin.off("end", this.onStdinEnd);
+        this.queuedMessages.length = 0;
+        this.pendingInput = "";
+        this.queuedBytes = 0;
+        if (!this.input.destroyed) this.input.end();
+      }
+      handleLine(line) {
+        const parsed = this.parseLine(line);
+        if (!parsed) return;
+        if ("error" in parsed) {
+          this.writeJsonRpcError(null, parsed.error.code, parsed.error.message);
+          return;
+        }
+        if (!this.ready && this.isDiscoveryRequest(parsed.message)) {
+          const response = {
+            jsonrpc: "2.0",
+            id: parsed.message.id,
+            result: createMcpStartupDiscoverResult(this.serverInfo)
+          };
+          try {
+            this.stdout.write(`${JSON.stringify(response)}
+`);
+          } catch (error) {
+            this.fail(error instanceof Error ? error : new Error(String(error)));
+          }
+          return;
+        }
+        if (this.ready) {
+          this.input.write(line);
+          return;
+        }
+        const bytes = Buffer.byteLength(line, "utf8");
+        if (this.queuedBytes + bytes > this.maxBufferSize) {
+          this.fail(new Error(`stdio startup queue exceeded ${this.maxBufferSize} bytes`));
+          return;
+        }
+        this.queuedMessages.push(line);
+        this.queuedBytes += bytes;
+      }
+      parseLine(line) {
+        const trimmed = line.endsWith("\n") ? line.slice(0, -1).replace(/\r$/, "") : line;
+        if (!trimmed.trim()) return null;
+        let value;
+        try {
+          value = JSON.parse(trimmed);
+        } catch {
+          return { error: { code: -32700, message: "Parse error" } };
+        }
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+          return { error: { code: -32600, message: "Invalid Request" } };
+        }
+        const message = value;
+        if (message.jsonrpc !== "2.0") {
+          return { error: { code: -32600, message: "Invalid Request" } };
+        }
+        const hasId = Object.prototype.hasOwnProperty.call(message, "id");
+        const hasMethod = typeof message.method === "string";
+        const hasResult = Object.prototype.hasOwnProperty.call(message, "result");
+        const hasError = Object.prototype.hasOwnProperty.call(message, "error");
+        if (hasMethod && (hasResult || hasError)) {
+          return { error: { code: -32600, message: "Invalid Request" } };
+        }
+        if (!hasMethod && !hasResult && !hasError) {
+          return { error: { code: -32600, message: "Invalid Request" } };
+        }
+        if (hasId && !this.isValidRequestId(message.id)) {
+          return { error: { code: -32600, message: "Invalid Request" } };
+        }
+        if (!hasMethod && !hasId) {
+          return { error: { code: -32600, message: "Invalid Request" } };
+        }
+        return { message };
+      }
+      isDiscoveryRequest(message) {
+        if (message.method !== MCP_SERVER_DISCOVER_METHOD) return false;
+        if (!Object.prototype.hasOwnProperty.call(message, "id")) return false;
+        const params = message.params;
+        return params === void 0 || typeof params === "object" && params !== null && !Array.isArray(params);
+      }
+      isValidRequestId(id) {
+        return id === null || typeof id === "string" || typeof id === "number" && Number.isFinite(id);
+      }
+      writeJsonRpcError(id, code, message) {
+        try {
+          this.stdout.write(`${JSON.stringify({
+            jsonrpc: "2.0",
+            id,
+            error: { code, message }
+          })}
+`);
+        } catch (error) {
+          this.fail(error instanceof Error ? error : new Error(String(error)));
+        }
+      }
+      finishInput() {
+        if (!this.ready || this.input.destroyed || this.input.writableEnded) return;
+        this.input.end();
+        this.input.once("end", () => this.notifyEnd());
+      }
+      notifyEnd() {
+        if (this.endNotified) return;
+        this.endNotified = true;
+        this.onEnd?.();
+      }
+      fail(error) {
+        if (this.stopped) return;
+        this.stopped = true;
+        this.stdin.off("data", this.onData);
+        this.stdin.off("error", this.onStdinError);
+        this.stdin.off("end", this.onStdinEnd);
+        this.queuedMessages.length = 0;
+        this.pendingInput = "";
+        this.queuedBytes = 0;
+        if (!this.input.destroyed) this.input.destroy();
+        this.onError?.(error);
+      }
+    };
+  }
+});
+
 // src/cli/mcp-root-path.ts
 import path35 from "path";
 function mcpFileUriToPath(uri, platform = process.platform) {
@@ -172735,7 +173233,7 @@ var init_serve_shared = __esm({
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.8.1" : pkg.version;
+  return true ? "1.8.3" : pkg.version;
 }
 var init_version3 = __esm({
   "src/cli/version.ts"() {
@@ -172965,6 +173463,8 @@ var init_serve = __esm({
     "use strict";
     init_esm_shims();
     init_tool_profile();
+    init_mcp_discovery();
+    init_stdio_startup_gate();
     init_mcp_root_path();
     serve_default = defineCommand({
       meta: {
@@ -172989,15 +173489,25 @@ var init_serve = __esm({
         }
       },
       run: async ({ args }) => {
+        const startupGate = new StdioStartupGate({
+          stdin: process.stdin,
+          stdout: process.stdout,
+          serverInfo: getMcpServerInfo(),
+          onError: (error) => {
+            console.error(`[memorix] stdio startup gate error: ${error.message}`);
+            process.exit(1);
+          },
+          onEnd: () => {
+            console.error("[memorix] stdin closed \u2014 exiting");
+            process.exitCode = 0;
+          }
+        });
+        startupGate.start();
         const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
         const { createMemorixServer: createMemorixServer2 } = await Promise.resolve().then(() => (init_server2(), server_exports2));
         const { detectProject: detectProject2, findGitInSubdirs: findGitInSubdirs2, isSystemDirectory: isSystemDirectory2 } = await Promise.resolve().then(() => (init_detector(), detector_exports));
         const { homedir: homedir27 } = await import("os");
         const { resolveServeProject: resolveServeProject2 } = await Promise.resolve().then(() => (init_serve_shared(), serve_shared_exports));
-        process.stdin.on("end", () => {
-          console.error("[memorix] stdin closed \u2014 exiting");
-          process.exit(0);
-        });
         let safeCwd;
         try {
           safeCwd = process.cwd();
@@ -173032,8 +173542,9 @@ var init_serve = __esm({
         const toolProfile = resolveToolProfile({ explicit: args.mode, envValue: process.env.MEMORIX_MODE, fallback: "micro" });
         const serverOptions = detected ? { toolProfile, deferProjectRuntimeInit: true } : { allowUntrackedFallback: allowUntracked, deferProjectInitUntilBound: !allowUntracked, deferProjectRuntimeInit: true, toolProfile };
         const { server, projectId, deferredInit, switchProject } = await createMemorixServer2(projectRoot, void 0, void 0, serverOptions);
-        const transport = new StdioServerTransport();
+        const transport = new StdioServerTransport(startupGate.input, process.stdout);
         await server.connect(transport);
+        startupGate.markReady();
         console.error(`[memorix] MCP Server running on stdio (project: ${projectId})`);
         console.error(`[memorix] Project root: ${detected?.rootPath ?? projectRoot}`);
         const tryRootsSwitch = async () => {