memorix 1.8.0 → 1.8.2

package/dist/cli/index.js

@@ -3232,7 +3232,7 @@ ${import_picocolors.default.gray(m3)}  ${s4}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.8.0" : pkg.version;
+  return true ? "1.8.2" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -21630,8 +21630,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;
@@ -21640,9 +21642,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) {
@@ -21651,6 +21654,7 @@ function resetDotenv() {
   injectedKeys.clear();
   dotenvLoaded = false;
   dotenvProjectRoot = null;
+  dotenvHomeDir = null;
   loadedEnvFiles.length = 0;
   loadedEnvKeys.clear();
 }
@@ -21663,7 +21667,7 @@ function getLoadedEnvKeys() {
 function getLoadedEnvValue(key) {
   return loadedEnvValues.get(key);
 }
-var import_dotenv, dotenvLoaded, dotenvProjectRoot, loadedEnvFiles, loadedEnvKeys, loadedEnvValues, injectedKeys;
+var import_dotenv, dotenvLoaded, dotenvProjectRoot, dotenvHomeDir, loadedEnvFiles, loadedEnvKeys, loadedEnvValues, injectedKeys;
 var init_dotenv_loader = __esm({
   "src/config/dotenv-loader.ts"() {
     "use strict";
@@ -21672,6 +21676,7 @@ var init_dotenv_loader = __esm({
     init_config_paths();
     dotenvLoaded = false;
     dotenvProjectRoot = null;
+    dotenvHomeDir = null;
     loadedEnvFiles = [];
     loadedEnvKeys = /* @__PURE__ */ new Set();
     loadedEnvValues = /* @__PURE__ */ new Map();
@@ -22023,33 +22028,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();
@@ -24308,18 +24313,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;
 }
@@ -197170,6 +197176,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);
@@ -197319,6 +197346,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);
@@ -197332,7 +197360,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 to2 = byId.get(target);
-    if (!from || !to2) continue;
+    if (!from || !to2) return void 0;
     relations.push({ from, to: to2, kind, ...line ? { line } : {} });
   }
   const relatedFiles = value.relatedFiles.map((item) => safeRelativePath(projectRoot, item, exclude));
@@ -197350,45 +197378,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 section2 = 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 symbol2 of symbols.slice(0, MAX_EXTERNAL_NODE_COUNT)) {
+        const name = symbol2[1]?.trim();
+        const kind = symbol2[2]?.trim();
+        if (!name || !kind) return void 0;
+        addNode({
+          id: `explore:${filePath}:${name}`,
+          kind,
+          name,
+          filePath
+        }, isFirstFile);
+      }
+      section2 = null;
+      continue;
+    }
+    if (/^#{2,3}\s+Entry Points?\b/i.test(line)) {
+      section2 = "entry";
+      continue;
+    }
+    if (/^#{2,3}\s+Related Symbols?\b/i.test(line)) {
+      section2 = "related";
+      continue;
+    }
+    if (/^\*\*Relationships\*\*$/i.test(line)) {
+      section2 = "relationships";
+      continue;
+    }
+    if (/^\*\*(?:Source Code|Code)\*\*$/i.test(line) || /^#{2,3}\s+/i.test(line)) {
+      section2 = null;
+      continue;
+    }
+    if (section2 === "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 (section2 === "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 symbol2 = rawSymbol.trim().match(/^(.+?)(?::([1-9]\d*))?$/);
+        if (!symbol2?.[1]) return void 0;
+        addNode({
+          id: `explore:${filePath}:${symbol2[1].trim()}`,
+          kind: "unknown",
+          name: symbol2[1].trim(),
+          filePath,
+          ...symbol2[2] ? { startLine: Number(symbol2[2]), endLine: Number(symbol2[2]) } : {}
+        }, false);
+      }
+      continue;
+    }
+    if (section2 === "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 (section2 === "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 to2 = bySymbolName.get(match2[2].trim());
+      if (!from || !to2) continue;
+      relations.push({
+        from: externalSymbol(from),
+        to: externalSymbol(to2),
+        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 to2 = bySymbolName.get(match2[2].trim());
+        if (from && to2) relations.push({ from: externalSymbol(from), to: externalSymbol(to2), 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;
@@ -197399,7 +197616,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;
@@ -218992,6 +219209,51 @@ var init_request_context = __esm({
   }
 });
 
+// src/server/mcp-compat.ts
+function buildMcpDiscoverResult(server, serverInfo) {
+  const getCapabilities = server.server.getCapabilities.bind(server.server);
+  return {
+    resultType: "complete",
+    supportedVersions: [
+      MCP_MODERN_PROTOCOL_VERSION,
+      MCP_LEGACY_PROTOCOL_VERSION,
+      MCP_OLDEST_LEGACY_PROTOCOL_VERSION
+    ],
+    capabilities: getCapabilities(),
+    _meta: {
+      [MCP_SERVER_INFO_META_KEY]: { ...serverInfo }
+    },
+    // v1 has no response-cache negotiation. A zero private TTL is the
+    // conservative result and prevents clients from inventing a shared cache.
+    ttlMs: 0,
+    cacheScope: "private"
+  };
+}
+function registerMcpDiscovery(server, serverInfo) {
+  if (registeredServers.has(server)) return;
+  server.server.setRequestHandler(ServerDiscoverRequestSchema, async () => buildMcpDiscoverResult(server, serverInfo));
+  registeredServers.add(server);
+}
+var MCP_MODERN_PROTOCOL_VERSION, MCP_LEGACY_PROTOCOL_VERSION, MCP_OLDEST_LEGACY_PROTOCOL_VERSION, MCP_SERVER_DISCOVER_METHOD, MCP_SERVER_INFO_META_KEY, ServerDiscoverRequestSchema, registeredServers;
+var init_mcp_compat = __esm({
+  "src/server/mcp-compat.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_types8();
+    init_v4();
+    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";
+    ServerDiscoverRequestSchema = RequestSchema.extend({
+      method: external_exports.literal(MCP_SERVER_DISCOVER_METHOD),
+      params: external_exports.looseObject({}).optional()
+    });
+    registeredServers = /* @__PURE__ */ new WeakSet();
+  }
+});
+
 // src/config/behavior.ts
 var behavior_exports = {};
 __export(behavior_exports, {
@@ -219278,6 +219540,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",
@@ -220770,6 +221033,37 @@ function normalizeDashboardTask(task) {
     preferredRole: task.preferred_role ?? task.preferredRole ?? null
   };
 }
+function emptyTeamSnapshot(mode, scope, status) {
+  return {
+    status,
+    mode,
+    readOnly: true,
+    scope,
+    agents: [],
+    activeCount: 0,
+    recentCount: 0,
+    historicalCount: 0,
+    totalAgents: 0,
+    recentWindowDays: 7,
+    locks: [],
+    tasks: [],
+    availableTasks: 0,
+    sessions: 0,
+    roles: [],
+    roleOccupancy: [],
+    handoffs: [],
+    openTasks: 0,
+    openHandoffs: 0,
+    totalUnread: 0,
+    activeSessions: 0,
+    error: status === "error" ? "Coordination state unavailable" : "Coordination state is incomplete",
+    errorCode: status === "error" ? "COORDINATION_STATE_UNAVAILABLE" : "COORDINATION_STATE_DEGRADED"
+  };
+}
+function logTeamSnapshotFailure(scope, status) {
+  const safeScope = scope === "global" ? "global" : "project";
+  console.error("[dashboard] coordination snapshot unavailable", { status, scope: safeScope });
+}
 async function buildTeamSnapshot(dataDir, projectId, scope, mode) {
   try {
     const { initTeamStore: initTeamStore2 } = await Promise.resolve().then(() => (init_team_store(), team_store_exports));
@@ -220796,8 +221090,9 @@ async function buildTeamSnapshot(dataDir, projectId, scope, mode) {
     const roleOccupancy = effectiveProjectId ? teamStore.getRoleOccupancy(effectiveProjectId) : [];
     const handoffs = effectiveProjectId ? teamStore.listHandoffs(effectiveProjectId) : [];
     return {
+      status: "ok",
       mode,
-      readOnly: mode === "standalone",
+      readOnly: true,
       scope,
       agents: withTier,
       activeCount,
@@ -220818,28 +221113,8 @@ async function buildTeamSnapshot(dataDir, projectId, scope, mode) {
       activeSessions: activeCount
     };
   } catch {
-    return {
-      mode,
-      readOnly: mode === "standalone",
-      scope,
-      agents: [],
-      activeCount: 0,
-      recentCount: 0,
-      historicalCount: 0,
-      totalAgents: 0,
-      recentWindowDays: 7,
-      locks: [],
-      tasks: [],
-      availableTasks: 0,
-      sessions: 0,
-      roles: [],
-      roleOccupancy: [],
-      handoffs: [],
-      openTasks: 0,
-      openHandoffs: 0,
-      totalUnread: 0,
-      activeSessions: 0
-    };
+    logTeamSnapshotFailure(scope, "error");
+    return emptyTeamSnapshot(mode, scope, "error");
   }
 }
 function readBody(req) {
@@ -220858,13 +221133,12 @@ function readBody(req) {
     req.on("error", reject);
   });
 }
-async function startDashboard(dataDir, port, staticDir, projectId, projectName, autoOpen = true, teamInstances, projectRoot = null, projectResolved = true) {
+async function startDashboard(dataDir, port, staticDir, projectId, projectName, autoOpen = true, projectRoot = null, projectResolved = true) {
   await initObservationStore(dataDir);
   await initSessionStore(dataDir);
   const resolvedStaticDir = staticDir;
   const baseDir = getBaseDataDir();
-  const isControlPlane = !!teamInstances;
-  const state = { projectId, projectName, dataDir, projectRoot, projectResolved, mode: isControlPlane ? "control-plane" : "standalone", port };
+  const state = { projectId, projectName, dataDir, projectRoot, projectResolved, mode: "standalone", port };
   const server = createServer(async (req, res) => {
     const url2 = req.url || "/";
     if (url2.startsWith("/api/set-current-project") && req.method === "POST") {
@@ -220886,54 +221160,20 @@ async function startDashboard(dataDir, port, staticDir, projectId, projectName,
       }
       return;
     }
-    if (url2.startsWith("/api/team")) {
-      if (!teamInstances) {
-        const parsedUrl = new URL(url2, `http://127.0.0.1:${port}`);
-        const scope = parsedUrl.searchParams.get("scope") || "project";
-        sendJson(res, await buildTeamSnapshot(state.dataDir, state.projectId, scope, state.mode));
-        return;
-      }
-      try {
-        teamInstances.fileLocks.cleanExpired();
-        const agents = teamInstances.registry.listAgents();
-        const locks = teamInstances.fileLocks.listLocks();
-        const tasks = teamInstances.taskManager.list();
-        const available = teamInstances.taskManager.getAvailable();
-        let roles = [];
-        let roleOccupancy = [];
-        let handoffs = [];
-        try {
-          const { getTeamStore: getTeamStore2, isTeamStoreInitialized: isTeamStoreInitialized2 } = await Promise.resolve().then(() => (init_team_store(), team_store_exports));
-          if (isTeamStoreInitialized2()) {
-            const teamStore = getTeamStore2();
-            const projectId2 = state.projectId;
-            roles = teamStore.listRoles(projectId2);
-            roleOccupancy = teamStore.getRoleOccupancy(projectId2);
-            handoffs = teamStore.listHandoffs(projectId2);
-          }
-        } catch {
-        }
+    const parsedUrl = new URL(url2, `http://127.0.0.1:${port}`);
+    if (parsedUrl.pathname === "/api/team") {
+      if (req.method !== "GET") {
         sendJson(res, {
-          agents: agents.map((a4) => ({
-            ...a4,
-            unread: teamInstances.messageBus.getUnreadCount(a4.id)
-          })),
-          activeCount: teamInstances.registry.getActiveCount(),
-          locks,
-          tasks,
-          availableTasks: available.length,
-          roles,
-          roleOccupancy,
-          handoffs,
-          // Resume data for "Continue this project" area
-          openTasks: tasks.filter((t4) => t4.status === "pending" || t4.status === "in_progress").length,
-          openHandoffs: handoffs.filter((h5) => h5.handoff_status === "open" || h5.handoffStatus === "open").length,
-          totalUnread: agents.reduce((sum, a4) => sum + teamInstances.messageBus.getUnreadCount(a4.id), 0),
-          activeSessions: agents.filter((a4) => a4.status === "active").length
-        });
-      } catch {
-        sendJson(res, { agents: [], activeCount: 0, locks: [], tasks: [], availableTasks: 0, roles: [], roleOccupancy: [], handoffs: [] });
+          status: "error",
+          readOnly: true,
+          error: "Coordination status is read-only",
+          errorCode: "COORDINATION_STATUS_READ_ONLY"
+        }, 405);
+        return;
       }
+      const scope = parsedUrl.searchParams.get("scope") || "project";
+      const snapshot = await buildTeamSnapshot(state.dataDir, state.projectId, scope, state.mode);
+      sendJson(res, snapshot, snapshot.status === "error" ? 503 : 200);
       return;
     }
     if (url2.startsWith("/api/")) {
@@ -220954,13 +221194,12 @@ async function startDashboard(dataDir, port, staticDir, projectId, projectName,
     server.listen(port, "127.0.0.1", () => {
       const url2 = `http://127.0.0.1:${port}`;
       const resolvedLabel = projectResolved ? "resolved" : "unresolved";
-      const modeLabel = isControlPlane ? "Control Plane" : "Standalone";
+      const modeLabel = "Standalone";
       console.error(`  Memorix Dashboard [${modeLabel}]`);
       console.error(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
       console.error(`  Mode:     ${modeLabel}`);
       console.error(`  Project:  ${projectName} (${projectId}) [${resolvedLabel}]`);
       console.error(`  Local:    ${url2}`);
-      if (isControlPlane) console.error(`  MCP:      ${url2}/mcp`);
       console.error(`  Data dir: ${dataDir}`);
       console.error(`
   Press Ctrl+C to stop
@@ -261394,10 +261633,12 @@ The path should point to a directory containing a .git folder.`
       isError: true
     };
   };
-  const server = existingServer ?? new McpServer({
+  const serverInfo = {
     name: "memorix",
-    version: true ? "1.8.0" : "1.0.1"
-  });
+    version: true ? "1.8.2" : "1.0.1"
+  };
+  const server = existingServer ?? new McpServer(serverInfo);
+  registerMcpDiscovery(server, serverInfo);
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
     if (!isToolInProfile(name, toolProfile)) {
@@ -264549,7 +264790,7 @@ ${json4}
           }
         }
         console.error(`[memorix] Dashboard staticDir: ${staticDir}`);
-        startDashboard2(projectDir2, portNum, staticDir, project.id, project.name, false, void 0, project.rootPath, projectResolved).then(() => {
+        startDashboard2(projectDir2, portNum, staticDir, project.id, project.name, false, project.rootPath, projectResolved).then(() => {
           dashboardRunning = true;
         }).catch((err) => {
           console.error("[memorix] Dashboard error:", err);
@@ -264891,7 +265132,7 @@ ${lines.join("\n")}` }] };
   server.registerTool(
     "team_task",
     {
-      title: "Task Board",
+      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: external_exports2.enum(["create", "claim", "complete", "list"]).describe("Operation to perform"),
@@ -265775,6 +266016,7 @@ var init_server4 = __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;
@@ -266256,13 +266498,17 @@ function getMcpDiagnostics() {
     protocol: {
       current: CURRENT_MCP_PROTOCOL_VERSION,
       legacy: LEGACY_MCP_PROTOCOL_VERSION,
-      statelessRequests: "supported",
+      discovery: "supported",
+      versionlessRequests: "legacy-compatible",
+      modernResultMetadata: "discovery-only",
+      statelessRequests: "compatibility-only",
       statefulStreamableHttp: "supported"
     },
     capabilities: {
       tasks: "unsupported",
       polling: "unsupported",
-      listCache: "supported",
+      subscriptions: "unsupported",
+      listCache: "unsupported",
       explicitProjectHandle: "supported"
     }
   };
@@ -266273,7 +266519,7 @@ var init_mcp_diagnostics = __esm({
     "use strict";
     init_esm_shims();
     CURRENT_MCP_PROTOCOL_VERSION = "2026-07-28";
-    LEGACY_MCP_PROTOCOL_VERSION = "2024-11-05";
+    LEGACY_MCP_PROTOCOL_VERSION = "2025-11-25";
     MCP_SERVER_NAME = "io.github.AVIDS2/memorix";
   }
 });
@@ -268517,9 +268763,13 @@ __export(serve_http_exports, {
   MCP_SDK_COMPAT_PROTOCOL_VERSION: () => MCP_SDK_COMPAT_PROTOCOL_VERSION,
   _testing: () => _testing2,
   default: () => serve_http_default,
+  isServerDiscoverRequest: () => isServerDiscoverRequest,
   parseSessionTimeoutMs: () => parseSessionTimeoutMs,
   resolveServeHttpDefaults: () => resolveServeHttpDefaults
 });
+function isServerDiscoverRequest(body) {
+  return Boolean(body && typeof body === "object" && !Array.isArray(body) && body.method === "server/discover");
+}
 function parseSessionTimeoutMs(raw) {
   const value = raw?.trim();
   if (!value) return DEFAULT_SESSION_TIMEOUT_MS;
@@ -268800,7 +269050,7 @@ var init_serve_http = __esm({
           }
           const requestedRoot = typeof req.headers["mcp-project-root"] === "string" ? req.headers["mcp-project-root"] : void 0;
           const root = persisted?.projectRoot ?? requestedRoot ?? projectRoot;
-          if (!persisted && !isInitializeRequest2(body)) {
+          if (!persisted && !isInitializeRequest2(body) && !isServerDiscoverRequest(body)) {
             res.writeHead(400, { "Content-Type": "application/json" });
             res.end(JSON.stringify({ jsonrpc: "2.0", error: { code: -32e3, message: "Stateless MCP requests require Mcp-Project-Handle; initialize first." }, id: null }));
             return;
@@ -268864,7 +269114,7 @@ var init_serve_http = __esm({
           const sessionId = req.headers["mcp-session-id"];
           const body = await parseBody(req);
           const requestedProtocol = req.headers["mcp-protocol-version"];
-          const statelessRequested = req.headers["mcp-stateless"] === "true" || requestedProtocol === CURRENT_MCP_PROTOCOL_VERSION;
+          const statelessRequested = req.headers["mcp-stateless"] === "true" || requestedProtocol === CURRENT_MCP_PROTOCOL_VERSION || typeof req.headers["mcp-project-handle"] === "string" || isServerDiscoverRequest(body);
           if (!sessionId && statelessRequested) {
             await handleStatelessPost(req, res, body);
             return;
@@ -269160,6 +269410,15 @@ var init_serve_http = __esm({
               return;
             }
             if (apiPath === "/team") {
+              if (req.method !== "GET") {
+                sendJson2({
+                  status: "error",
+                  readOnly: true,
+                  error: "Coordination status is read-only",
+                  errorCode: "COORDINATION_STATUS_READ_ONLY"
+                }, 405);
+                return;
+              }
               const { projectId: teamProjectId, dataDir: teamDataDir } = await resolveRequestProject(url2);
               const ts2 = await getTeamStore2(teamDataDir);
               const scope = url2.searchParams.get("scope") || "project";
@@ -269224,8 +269483,9 @@ var init_serve_http = __esm({
               const handoffs = effectiveTeamProjectId ? ts2.listHandoffs(effectiveTeamProjectId) : [];
               const openHandoffs = handoffs.filter((handoff) => handoff.status !== "completed").length;
               sendJson2({
+                status: "ok",
                 mode: "control-plane",
-                readOnly: false,
+                readOnly: true,
                 scope,
                 agents: withTier,
                 // Primary headline number
@@ -269798,6 +270058,23 @@ var init_serve_http = __esm({
             }
             sendJson2({ error: "Not found" }, 404);
           } catch (err) {
+            if (apiPath === "/team") {
+              const scope = url2.searchParams.get("scope") === "global" ? "global" : "project";
+              console.error("[memorix] coordination snapshot unavailable", { status: "error", scope });
+              sendJson2({
+                status: "error",
+                mode: "control-plane",
+                readOnly: true,
+                scope,
+                agents: [],
+                locks: [],
+                tasks: [],
+                handoffs: [],
+                error: "Coordination state unavailable",
+                errorCode: "COORDINATION_STATE_UNAVAILABLE"
+              }, 503);
+              return;
+            }
             sendJson2({ error: err instanceof Error ? err.message : "Unknown error" }, 500);
           }
         }
@@ -276684,7 +276961,7 @@ var init_dashboard = __esm({
         }
         const cliDir = path45.dirname(fileURLToPath9(import.meta.url));
         const staticDir = path45.join(cliDir, "..", "dashboard", "static");
-        await startDashboard2(dataDir, port, staticDir, project.id, project.name, true, void 0, project.rootPath, true);
+        await startDashboard2(dataDir, port, staticDir, project.id, project.name, true, project.rootPath, true);
         await new Promise(() => {
         });
       }