remem-mcp 0.7.0 → 0.7.3

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   ingestFile,
   redact,
   searchWiki
-} from "./chunk-TGLOMFIE.js";
+} from "./chunk-ITMR6THY.js";
 import {
   engine_exports,
   findCallees,
@@ -19,14 +19,14 @@ import {
   init_engine,
   listSymbols,
   searchSymbols
-} from "./chunk-ZXI67YIV.js";
+} from "./chunk-YU7WBJU5.js";
 import {
   LocalEmbedder,
   SQLiteBackend,
   init_local,
   local_exports,
   stripQueryProperNouns
-} from "./chunk-OYUNKUZK.js";
+} from "./chunk-4WCDAEPP.js";
 import {
   generateId,
   init_ulid
@@ -5954,8 +5954,7 @@ function hookPreToolUse(dbPath) {
         }
         return;
       }
-      const isRelevantCommand = /^(npm|npx|yarn|pnpm|biome|eslint|tsc|cargo|make|pytest|vitest|jest)\b/.test(command) || /\b(lint|test|build|typecheck|check|format)\b/.test(command);
-      if (!isRelevantCommand) {
+      if (!isRelevantBuildCommand(command) && !isDecisionLearningCommand(command)) {
         if (contextBlocks.length > 0) {
           process.stdout.write(JSON.stringify({
             hookSpecificOutput: {
@@ -6032,7 +6031,8 @@ function hookPreToolUse(dbPath) {
             provenance: m.fix_provenance ?? "auto_captured",
             inherited: r.session_key !== sessionKey,
             rollbackPlan: m.rollback_plan ?? null,
-            autoNotes: m.auto_notes ?? []
+            autoNotes: m.auto_notes ?? [],
+            failedCommand: m.command ?? ""
           };
         });
         if (resolvedFixes.length < 2) {
@@ -6058,14 +6058,20 @@ function hookPreToolUse(dbPath) {
               provenance: "inherited",
               inherited: true,
               rollbackPlan: m.rollback_plan ?? null,
-              autoNotes: m.auto_notes ?? []
+              autoNotes: m.auto_notes ?? [],
+              failedCommand: m.command ?? ""
             });
           }
         }
         rDb.close();
       } catch {
       }
-      if (errors2.length === 0 && resolvedFixes.length === 0) {
+      const relevantErrors = errors2.filter((err) => {
+        const meta = err.metadata ? JSON.parse(err.metadata) : {};
+        return isErrorRelevantToCommand(command, meta);
+      });
+      const relevantFixes = resolvedFixes;
+      if (relevantErrors.length === 0 && relevantFixes.length === 0) {
         try {
           const decDb = new Database8(dbPath, { readonly: true });
           const lowerCmd = command.toLowerCase();
@@ -6154,13 +6160,13 @@ function hookPreToolUse(dbPath) {
         process.stdout.write(JSON.stringify({}));
         return;
       }
-      const validErrors = errors2.filter((err) => {
+      const validErrors = relevantErrors.filter((err) => {
         const meta = err.metadata ? JSON.parse(err.metadata) : {};
         const filesInError = extractFilePaths(err.content);
         if (filesInError.length === 0) return true;
         return filesInError.some((f) => existsSync8(join9(cwd, f)));
       });
-      if (validErrors.length === 0 && resolvedFixes.length === 0) {
+      if (validErrors.length === 0 && relevantFixes.length === 0) {
         logToFile("PreToolUse: all past errors are stale and no proven fixes");
         process.stdout.write(JSON.stringify({}));
         return;
@@ -6199,12 +6205,12 @@ function hookPreToolUse(dbPath) {
           }
         }
       }
-      if (resolvedFixes.length > 0) {
+      if (relevantFixes.length > 0) {
         lines.push("");
         lines.push("Proven fixes from past resolved errors:");
         const stalenessDays = Number(process.env.REMEM_FIX_STALENESS_DAYS ?? 180);
         const stalenessMs = stalenessDays * 864e5;
-        for (const fix of resolvedFixes) {
+        for (const fix of relevantFixes) {
           const fixAgeMs = Date.now() - new Date(fix.resolvedAt).getTime();
           const isStale = fixAgeMs > stalenessMs;
           const staleTag = isStale ? " [STALE \u2014 verify before applying]" : "";
@@ -6417,6 +6423,98 @@ function isNoiseCommand(command) {
   if (/git\s+diff\s+.*--exit-code/.test(lower)) return true;
   return false;
 }
+var COMMAND_INTENTS = {
+  biome: "check",
+  build: "build",
+  cargo: "build",
+  check: "check",
+  eslint: "lint",
+  format: "format",
+  jest: "test",
+  lint: "lint",
+  make: "build",
+  mvn: "build",
+  mypy: "typecheck",
+  pytest: "test",
+  ruff: "lint",
+  tsc: "typecheck",
+  typecheck: "typecheck",
+  vitest: "test"
+};
+function getCommandIntent(command) {
+  for (const segment of command.split(/&&|\|\||[;|]/)) {
+    let part = segment.trim();
+    if (!part) continue;
+    while (/^[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S*)\s+/.test(part)) {
+      part = part.replace(/^[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S*)\s+/, "");
+    }
+    const tokens = part.split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) continue;
+    while (tokens[0] === "sudo" || tokens[0] === "time") tokens.shift();
+    const executable = (tokens[0] ?? "").split("/").pop() ?? "";
+    if (["cd", "pushd", "popd"].includes(executable)) continue;
+    if (["npm", "pnpm", "yarn"].includes(executable)) {
+      const args = tokens.slice(1);
+      const runAt = args.findIndex((arg) => arg === "run" || arg === "exec");
+      const action = runAt >= 0 ? args[runAt + 1] : args.find((arg) => !arg.startsWith("-"));
+      if (action && COMMAND_INTENTS[action]) return COMMAND_INTENTS[action];
+      continue;
+    }
+    if (executable === "python" && tokens[1] === "-m") {
+      const module = (tokens[2] ?? "").split("/").pop() ?? "";
+      if (COMMAND_INTENTS[module]) return COMMAND_INTENTS[module];
+      continue;
+    }
+    if (COMMAND_INTENTS[executable]) return COMMAND_INTENTS[executable];
+    if (["cargo", "dotnet", "go", "gradle", "mvn"].includes(executable)) {
+      const action = (tokens[1] ?? "").toLowerCase();
+      if (action === "test") return "test";
+      if (action === "fmt") return "format";
+      if (["build", "vet", "clippy"].includes(action)) return "check";
+    }
+  }
+  return null;
+}
+function isRelevantBuildCommand(command) {
+  return getCommandIntent(command) !== null;
+}
+function isDecisionLearningCommand(command) {
+  return /\b(?:npm|pnpm|yarn)\s+(?:install|i|add)\b/.test(command) || /\b(?:pip|uv)\s+install\b/.test(command) || /\bcargo\s+add\b/.test(command) || /\bgit\s+commit\b/.test(command);
+}
+function isErrorRelevantToCommand(command, meta) {
+  const intent = getCommandIntent(command);
+  if (!intent) return false;
+  const failedCommand = typeof meta.command === "string" ? meta.command : "";
+  if (failedCommand) {
+    if (getCommandIntent(failedCommand) === intent) return true;
+    const genericWords = /* @__PURE__ */ new Set([
+      "and",
+      "error",
+      "failed",
+      "false",
+      "npm",
+      "npx",
+      "pnpm",
+      "run",
+      "the",
+      "true",
+      "yarn"
+    ]);
+    const words = (text) => new Set(
+      text.toLowerCase().split(/[^a-z0-9@/_-]+/).filter(
+        (word) => word.length >= 3 && !genericWords.has(word)
+      )
+    );
+    const currentWords = words(command);
+    const failedWords = words(failedCommand);
+    for (const word of currentWords) {
+      if (failedWords.has(word)) return true;
+    }
+    return false;
+  }
+  const errorType = typeof meta.error_type === "string" ? meta.error_type.toLowerCase() : "";
+  return !errorType || errorType === intent || intent === "check";
+}
 function checkDangerousCommand(command) {
   const lower = command.toLowerCase();
   if (/git\s+push\s+(--force|-f)(?!\S)/.test(lower)) {
@@ -7137,7 +7235,7 @@ async function hookPostCommit(dbPath) {
     const { join: join17, dirname: dirname11 } = await import("path");
     const { fileURLToPath: fileURLToPath5 } = await import("url");
     const sqliteVec5 = await import("sqlite-vec");
-    const { indexFile: indexFile2 } = await import("./engine-3JUSB3RK.js");
+    const { indexFile: indexFile2 } = await import("./engine-S47HHGAO.js");
     const db = new Database8(dbPath);
     ensureSchema2(db);
     try {
@@ -7685,6 +7783,53 @@ function hookCommand(subcommand) {
   }
   return `npx --prefer-offline -y remem-mcp ${subcommand}`;
 }
+var CODEX_HOOK_SUBCOMMANDS = [
+  "hook-recall",
+  "hook-pre-tool-use",
+  "hook-post-tool-use",
+  "hook-post-compaction",
+  "hook-user-prompt",
+  "hook-stop",
+  "hook-session-end"
+];
+function hasCodexRememHooks(content) {
+  return CODEX_HOOK_SUBCOMMANDS.some((subcommand) => content.includes(` ${subcommand}"`));
+}
+function removeCodexHooksFromToml(content) {
+  const lines = content.split(/\r?\n/);
+  const output2 = [];
+  let index = 0;
+  while (index < lines.length) {
+    const match = lines[index].match(/^\[\[hooks\.([A-Za-z]+)\]\]\s*$/);
+    if (!match) {
+      output2.push(lines[index]);
+      index++;
+      continue;
+    }
+    const event = match[1];
+    const nestedPrefix = `[[hooks.${event}.hooks]]`;
+    let end = index + 1;
+    while (end < lines.length) {
+      const line2 = lines[end];
+      if (line2.startsWith(nestedPrefix)) {
+        end++;
+        continue;
+      }
+      if (/^\[./.test(line2)) break;
+      end++;
+    }
+    const block = lines.slice(index, end);
+    if (CODEX_HOOK_SUBCOMMANDS.some((subcommand) => block.includes(` ${subcommand}"`))) {
+      while (output2.length > 0 && (output2[output2.length - 1].trim() === "" || /^\s*#/.test(output2[output2.length - 1]) && output2[output2.length - 1].includes("remem-mcp"))) {
+        output2.pop();
+      }
+    } else {
+      output2.push(...block);
+    }
+    index = end;
+  }
+  return output2.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
+}
 var HOOKS_CONFIG = {
   SessionStart: [
     {
@@ -7860,7 +8005,7 @@ function installCodexHooks() {
     return false;
   }
   let content = readFileSync7(configPath, "utf-8");
-  if (content.includes(">>> remem-mcp SessionStart >>>")) {
+  if (hasCodexRememHooks(content)) {
     console.log(`  Codex CLI: Hooks already installed in ${configPath}`);
     return true;
   }
@@ -8030,8 +8175,9 @@ async function uninstallHooks() {
   const codexPath = join10(homedir8(), ".codex", "config.toml");
   if (existsSync9(codexPath)) {
     let content = readFileSync7(codexPath, "utf-8");
-    if (content.includes(">>> remem-mcp")) {
-      content = content.replace(/\n?# >>> remem-mcp[\s\S]*?# <<< remem-mcp[^<]*<<<\n?/g, "\n");
+    const cleaned = removeCodexHooksFromToml(content);
+    if (cleaned !== content) {
+      content = cleaned;
       writeFileSync6(codexPath, content.trimEnd() + "\n", "utf-8");
       console.log(`  Codex CLI: Hooks removed from ${codexPath}`);
       removed++;
@@ -8587,8 +8733,8 @@ var AuditLogger = class {
 // src/server.ts
 init_esm_shims();
 init_engine();
-import { createHash as createHash5 } from "crypto";
 import { execSync as execSync3 } from "child_process";
+import { createHash as createHash5 } from "crypto";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import {
   CallToolRequestSchema,
@@ -8651,6 +8797,7 @@ function formatResults(results) {
 
 // src/server.ts
 init_ulid();
+var indexingStatus = /* @__PURE__ */ new Map();
 function defaultSessionKey() {
   if (process.env.REMEM_SESSION_KEY) return process.env.REMEM_SESSION_KEY;
   const cwd = process.cwd();
@@ -8838,6 +8985,29 @@ var TOOLS = [
       }
     }
   },
+  {
+    name: "feedback",
+    description: "Record a quality signal for a recalled memory. Call this AFTER using a recall result: use 'helpful' if the memory answered your question, 'not_helpful' if it was irrelevant, 'stale' if the information is outdated, or 'wrong' if it is incorrect. This creates a feedback flywheel \u2014 useful memories rise, unhelpful ones fade. Do not call this for memories you have not actually used.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        capture_id: {
+          type: "string",
+          description: "The capture ID from a recall/search result."
+        },
+        signal: {
+          type: "string",
+          enum: ["helpful", "not_helpful", "stale", "wrong"],
+          description: "helpful = memory was useful (salience +0.1, max 2.0). not_helpful = memory was irrelevant (salience -0.1, min 0.1). stale = information is outdated (salience floored at 0.3). wrong = information is incorrect (salience floored at 0.1)."
+        },
+        reason: {
+          type: "string",
+          description: "Optional explanation for the feedback signal."
+        }
+      },
+      required: ["capture_id", "signal"]
+    }
+  },
   {
     name: "search",
     description: "Search memory by keyword or by semantic similarity. Use this tool when recall is too broad and you need specific facts. Automatically searches both project and global cross-project memory when REMEM_GLOBAL_SESSION_KEY is configured.",
@@ -8881,6 +9051,11 @@ var TOOLS = [
           enum: ["text", "json"],
           default: "text",
           description: "The response format. Use 'json' for structured data (e.g. benchmarks). Defaults to 'text'."
+        },
+        explain: {
+          type: "boolean",
+          default: false,
+          description: "When true, attach per-hit score_details explaining ranking (BM25 rank, vector score, entity matches, authority multiplier, feedback salience, link provenance). Useful for debugging search quality."
         }
       },
       required: ["query"]
@@ -9274,7 +9449,7 @@ var TOOLS = [
   },
   {
     name: "codegraph_search",
-    description: "Search for code symbols by name. Returns matching functions, classes, methods, etc. with file paths and line numbers. Use this INSTEAD of grep when looking for function/class/method definitions. If the codebase hasn't been indexed yet, this auto-indexes src/ (or cwd) on first use \u2014 no manual setup needed.",
+    description: "Search for code symbols by name. Returns matching functions, classes, methods, etc. with file paths and line numbers. Use this INSTEAD of grep when looking for function/class/method definitions. If the codebase hasn't been indexed yet, this starts background indexing and asks you to retry in a few seconds \u2014 non-blocking, so you can continue working while indexing runs.",
     inputSchema: {
       type: "object",
       properties: {
@@ -9379,6 +9554,20 @@ var TOOLS = [
       required: ["repo_path"]
     }
   },
+  {
+    name: "codegraph_stats",
+    description: "Return indexed CodeGraph statistics: total symbols, calls, resolved calls, imports, and file counts. Optionally scoped to a repo_path. Use this to check indexing coverage before searching.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repo_path: {
+          type: "string",
+          description: "Optional: scope stats to this repository root path."
+        },
+        team_id: { type: "string", description: "The team ID for isolation." }
+      }
+    }
+  },
   // ─── Wiki tools ───
   {
     name: "wiki_ingest",
@@ -9876,6 +10065,8 @@ function createServer(opts) {
         return handleRecall(args, opts);
       case "capture":
         return handleCapture(args, opts);
+      case "feedback":
+        return handleFeedback(args, opts);
       case "search":
         return handleSearch(args, opts);
       case "related":
@@ -9922,6 +10113,8 @@ function createServer(opts) {
         return handleCodegraphList(args, opts);
       case "codegraph_detect_changes":
         return handleCodegraphDetectChanges(args, opts);
+      case "codegraph_stats":
+        return handleCodegraphStats(args, opts);
       case "wiki_ingest":
         return handleWikiIngest(args, opts);
       case "wiki_search":
@@ -9979,6 +10172,12 @@ function extractTenant(args) {
     taskId: args.task_id
   };
 }
+function textResult(text) {
+  return { content: [{ type: "text", text }] };
+}
+function errorResult(text) {
+  return { content: [{ type: "text", text }], isError: true };
+}
 async function handleRecall(args, opts) {
   const query = args.query;
   const sessionKey = args.session_key ?? defaultSessionKey();
@@ -10139,6 +10338,27 @@ ${text}`;
   });
   return { content: [{ type: "text", text: finalText }] };
 }
+async function handleFeedback(args, opts) {
+  const captureId = String(args.capture_id ?? "");
+  const signal = String(args.signal ?? "");
+  const reason = args.reason ? String(args.reason) : void 0;
+  if (!captureId || !signal) {
+    return errorResult("capture_id and signal are required");
+  }
+  const validSignals = ["helpful", "not_helpful", "stale", "wrong"];
+  if (!validSignals.includes(signal)) {
+    return errorResult(`signal must be one of: ${validSignals.join(", ")}`);
+  }
+  const storage = opts.storage;
+  const entry = await storage.get(captureId);
+  if (!entry) {
+    return errorResult(`capture not found: ${captureId}`);
+  }
+  storage.recordFeedback(captureId, signal, reason, opts.agentId ?? detectAgentId());
+  return textResult(
+    `Recorded feedback: ${signal} for capture ${captureId.slice(-8)}. Salience multiplier adjusted. This memory will ${signal === "helpful" ? "rank higher" : signal === "not_helpful" ? "rank lower" : signal === "stale" ? "be deprioritized as outdated" : "be deprioritized as incorrect"} in future searches.`
+  );
+}
 async function handleCapture(args, opts) {
   const type2 = args.type ?? "conversation";
   const tags = args.tags ?? [];
@@ -10441,6 +10661,7 @@ async function handleSearch(args, opts) {
   const query = args.query;
   const mode = args.mode ?? "hybrid";
   const format = args.format ?? "text";
+  const explain = args.explain ?? false;
   const filters = args.filters;
   const limit = Math.min(args.limit ?? 20, 500);
   let queryEmbedding = null;
@@ -10476,7 +10697,8 @@ async function handleSearch(args, opts) {
       limit: projectLimit,
       offset: 0,
       mode,
-      filters: searchFilters
+      filters: searchFilters,
+      explain
     });
     let globalResults = [];
     try {
@@ -10485,7 +10707,8 @@ async function handleSearch(args, opts) {
         limit: reservedGlobal,
         offset: 0,
         mode,
-        filters: searchFilters
+        filters: searchFilters,
+        explain
       });
     } catch {
     }
@@ -10498,7 +10721,8 @@ async function handleSearch(args, opts) {
       limit,
       offset: 0,
       mode,
-      filters: searchFilters
+      filters: searchFilters,
+      explain
     });
   }
   results = dedupByContentPrefix(results, 60);
@@ -11262,6 +11486,7 @@ async function handleConfirm(args, opts) {
   }
   try {
     db.prepare("UPDATE captures SET confirmations = confirmations + 1 WHERE id = ?").run(captureId);
+    opts.storage.recordFeedback(captureId, "helpful", "auto: confirmed by agent", opts.agentId ?? detectAgentId());
   } catch (err) {
     return { content: [{ type: "text", text: `Error: ${err}` }], isError: true };
   }
@@ -11272,7 +11497,7 @@ async function handleConfirm(args, opts) {
     content: [
       {
         type: "text",
-        text: `Confirmed capture ${captureId}. Confidence: ${confidence.toFixed(2)} (${row.confirmations + 1} confirmations, ${row.corrections} corrections).`
+        text: `Confirmed capture ${captureId}. Confidence: ${confidence.toFixed(2)} (${row.confirmations + 1} confirmations, ${row.corrections} corrections). Feedback salience boosted.`
       }
     ]
   };
@@ -11301,6 +11526,7 @@ async function handleCorrect(args, opts) {
     if (reason) {
       db.prepare("UPDATE captures SET rejection_reason = ? WHERE id = ?").run(reason, captureId);
     }
+    opts.storage.recordFeedback(captureId, "wrong", reason ? `auto: ${reason}` : "auto: corrected by agent", opts.agentId ?? detectAgentId());
   } catch (err) {
     return { content: [{ type: "text", text: `Error: ${err}` }], isError: true };
   }
@@ -12202,31 +12428,70 @@ async function handleCodegraphSearch(args, opts) {
       indexPath = existsSync17(`${cwd}/src`) ? `${cwd}/src` : cwd;
       repoRoot = cwd;
     }
-    try {
-      const results = await indexDirectory(db, indexPath, repoRoot, teamId, 500);
-      const indexed = results.filter((r) => !r.skipped);
-      if (indexed.length > 0) {
-        symbols = searchSymbols(db, query, { teamId, kind, language, limit, repoPath: repoRoot });
-      }
+    const statusKey = `${repoRoot}:${teamId ?? "default"}`;
+    const status2 = indexingStatus.get(statusKey);
+    if (!status2 || status2.state === "error") {
+      indexingStatus.set(statusKey, {
+        state: "indexing",
+        startedAt: Date.now()
+      });
+      indexDirectory(db, indexPath, repoRoot, teamId, 1e4).then((results) => {
+        const indexed = results.filter((r) => !r.skipped);
+        const totalSymbols = indexed.reduce((s, r) => s + r.symbols, 0);
+        indexingStatus.set(statusKey, {
+          state: "done",
+          startedAt: status2?.startedAt ?? Date.now(),
+          finishedAt: Date.now(),
+          fileCount: indexed.length,
+          symbolCount: totalSymbols
+        });
+        console.error(
+          `[remem-mcp] background index complete: ${indexed.length} files, ${totalSymbols} symbols from ${indexPath}`
+        );
+      }).catch((err) => {
+        indexingStatus.set(statusKey, {
+          state: "error",
+          startedAt: status2?.startedAt ?? Date.now(),
+          finishedAt: Date.now(),
+          error: String(err)
+        });
+        console.error(`[remem-mcp] background index failed: ${err}`);
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `No symbols found yet. Background indexing started for ${indexPath}.
+Retry codegraph_search in ~10-30s (large repos may take longer).
+You can continue working \u2014 indexing runs in the background.`
+          }
+        ]
+      };
+    } else if (status2.state === "indexing") {
+      const elapsed = Math.round((Date.now() - status2.startedAt) / 1e3);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `No symbols found yet. Indexing in progress (${elapsed}s elapsed).
+Retry codegraph_search in a few seconds.
+Meanwhile, use grep/glob for immediate code navigation.`
+          }
+        ]
+      };
+    } else if (status2.state === "done") {
+      symbols = searchSymbols(db, query, { teamId, kind, language, limit, repoPath: repoRoot });
       if (symbols.length === 0) {
         return {
           content: [
             {
               type: "text",
-              text: `No symbols found. Auto-indexed ${indexed.length} files from ${indexPath} \u2014 try a different search term, or call codegraph_index with a specific path.`
+              text: `No symbols found for "${query}". Indexing completed: ${status2.fileCount} files, ${status2.symbolCount} symbols.
+Try a different search term, or call codegraph_index with a specific path.`
             }
           ]
         };
       }
-    } catch {
-      return {
-        content: [
-          {
-            type: "text",
-            text: "No symbols found. Call codegraph_index with a path to index your codebase first."
-          }
-        ]
-      };
     }
   }
   const lines = symbols.map(
@@ -12418,6 +12683,49 @@ function handleCodegraphDetectChanges(args, opts) {
     content: [{ type: "text", text: lines.join("\n") }]
   };
 }
+function handleCodegraphStats(args, opts) {
+  const repoPath = args.repo_path ?? void 0;
+  const teamId = args.team_id ?? void 0;
+  const db = getDb(opts);
+  const repoClause = repoPath ? "AND repo_path IS ?" : "";
+  const repoParams = repoPath ? [repoPath] : [];
+  const teamClause = teamId !== void 0 ? "AND team_id IS ?" : "";
+  const teamParams = teamId !== void 0 ? [teamId] : [];
+  const filter = `${repoClause} ${teamClause}`.trim();
+  const symbolCount = db.prepare(`SELECT COUNT(*) as c FROM symbols WHERE 1=1 ${filter}`).get(...repoParams, ...teamParams);
+  const callCount = db.prepare(
+    `SELECT COUNT(*) as c FROM calls AS c
+       JOIN symbols AS caller ON caller.id = c.caller_id
+       WHERE 1=1 ${filter}`
+  ).get(...repoParams, ...teamParams);
+  const resolvedCount = db.prepare(
+    `SELECT COUNT(*) as c FROM calls AS c
+       JOIN symbols AS caller ON caller.id = c.caller_id
+       WHERE c.callee_id IS NOT NULL ${filter}`
+  ).get(...repoParams, ...teamParams);
+  const importCount = db.prepare(`SELECT COUNT(*) as c FROM imports WHERE 1=1 ${filter}`).get(...repoParams, ...teamParams);
+  const fileCount = db.prepare(`SELECT COUNT(DISTINCT file_path) as c FROM symbols WHERE 1=1 ${filter}`).get(...repoParams, ...teamParams);
+  const byKind = db.prepare(
+    `SELECT kind, COUNT(*) as c FROM symbols WHERE 1=1 ${filter} GROUP BY kind ORDER BY c DESC`
+  ).all(...repoParams, ...teamParams);
+  const lines = [
+    `CodeGraph Statistics${repoPath ? ` (repo: ${repoPath})` : ""}`,
+    `  files:    ${fileCount.c}`,
+    `  symbols:  ${symbolCount.c}`,
+    `  calls:    ${callCount.c} (${resolvedCount.c} resolved, ${callCount.c - resolvedCount.c} unresolved)`,
+    `  imports:  ${importCount.c}`,
+    ""
+  ];
+  if (byKind.length > 0) {
+    lines.push("By kind:");
+    for (const k of byKind) {
+      lines.push(`  ${k.kind.padEnd(12)} ${k.c}`);
+    }
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }]
+  };
+}
 async function handleWikiIngest(args, opts) {
   const path = args.path;
   const repoPath = args.repo_path ?? path;
@@ -15514,7 +15822,7 @@ ${sorted.length} unique tag(s).`);
     return;
   }
   if (arg === "proxy") {
-    const { loadProxyConfig, startProxyServer } = await import("./server-SUKPVQWL.js");
+    const { loadProxyConfig, startProxyServer } = await import("./server-5PWQTRGZ.js");
     const proxyConfig = loadProxyConfig();
     if (!proxyConfig.dbPath) {
       proxyConfig.dbPath = defaultDbPath3();