grepmax 0.26.44 → 0.26.46

package/dist/commands/mcp.js

@@ -69,8 +69,8 @@ exports.formatMcpSurprisingConnections = formatMcpSurprisingConnections;
 exports.mcpLogQuery = mcpLogQuery;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("@modelcontextprotocol/server");
+const stdio_1 = require("@modelcontextprotocol/server/stdio");
 const commander_1 = require("commander");
 const zod_1 = require("zod");
 const config_1 = require("../config");
@@ -85,6 +85,7 @@ const index_config_1 = require("../lib/index/index-config");
 const syncer_1 = require("../lib/index/syncer");
 const agent_search_formatter_1 = require("../lib/output/agent-search-formatter");
 const index_state_footer_1 = require("../lib/output/index-state-footer");
+const mcp_results_1 = require("../lib/output/mcp-results");
 const searcher_1 = require("../lib/search/searcher");
 const annotator_1 = require("../lib/skeleton/annotator");
 const skeletonizer_1 = require("../lib/skeleton/skeletonizer");
@@ -123,8 +124,8 @@ function toStringArray(val) {
     }
     return [];
 }
-function ok(text) {
-    return { content: [{ type: "text", text }] };
+function ok(text, structuredContent) {
+    return Object.assign({ content: [{ type: "text", text }] }, (structuredContent ? { structuredContent } : {}));
 }
 function err(text) {
     return { content: [{ type: "text", text }], isError: true };
@@ -256,13 +257,13 @@ function searchResultPath(r) {
 }
 function searchResultStartLine(r) {
     var _a;
-    var _b, _c;
-    return Number((_c = (_b = r === null || r === void 0 ? void 0 : r.start_line) !== null && _b !== void 0 ? _b : (_a = r === null || r === void 0 ? void 0 : r.generated_metadata) === null || _a === void 0 ? void 0 : _a.start_line) !== null && _c !== void 0 ? _c : 0);
+    var _b, _c, _d;
+    return Number((_d = (_c = (_b = r === null || r === void 0 ? void 0 : r.startLine) !== null && _b !== void 0 ? _b : r === null || r === void 0 ? void 0 : r.start_line) !== null && _c !== void 0 ? _c : (_a = r === null || r === void 0 ? void 0 : r.generated_metadata) === null || _a === void 0 ? void 0 : _a.start_line) !== null && _d !== void 0 ? _d : 0);
 }
 function searchResultEndLine(r, fallbackStart = 0) {
     var _a;
-    var _b, _c;
-    return Number((_c = (_b = r === null || r === void 0 ? void 0 : r.end_line) !== null && _b !== void 0 ? _b : (_a = r === null || r === void 0 ? void 0 : r.generated_metadata) === null || _a === void 0 ? void 0 : _a.end_line) !== null && _c !== void 0 ? _c : fallbackStart);
+    var _b, _c, _d;
+    return Number((_d = (_c = (_b = r === null || r === void 0 ? void 0 : r.endLine) !== null && _b !== void 0 ? _b : r === null || r === void 0 ? void 0 : r.end_line) !== null && _c !== void 0 ? _c : (_a = r === null || r === void 0 ? void 0 : r.generated_metadata) === null || _a === void 0 ? void 0 : _a.end_line) !== null && _d !== void 0 ? _d : fallbackStart);
 }
 function filterMcpSearchResults(data, options = {}) {
     var _a, _b;
@@ -373,12 +374,22 @@ exports.mcp = new commander_1.Command("mcp")
     // an MCP session holds no reader marker under ~/.gmax/lancedb.lease/readers/
     // while a daemon serving the verbs is up.
     let _skeletonizer = null;
-    let _indexReady = false;
-    // Nothing to close: the tools open no store of their own.
-    const exit = () => process.exit(0);
+    let stdio;
+    let watchTimer;
+    const watchedRoots = new Set();
+    let closing = false;
+    // Close the SDK connection before exit so pending requests are aborted.
+    const exit = () => {
+        if (closing)
+            return;
+        closing = true;
+        clearInterval(watchTimer);
+        setTimeout(() => process.exit(0), 1000).unref();
+        void Promise.resolve(stdio === null || stdio === void 0 ? void 0 : stdio.close()).finally(() => process.exit(0));
+    };
     process.on("SIGINT", exit);
     process.on("SIGTERM", exit);
-    // MCP SDK doesn't handle stdin close — exit when the client disconnects
+    // Exit promptly on disconnect, including sessions with a lease timer.
     process.stdin.on("end", exit);
     process.stdin.on("close", exit);
     process.on("unhandledRejection", (reason, promise) => {
@@ -394,7 +405,7 @@ exports.mcp = new commander_1.Command("mcp")
     console.debug = (..._args) => { };
     // --- Project context ---
     const projectRoot = (0, project_root_1.findProjectRoot)(process.cwd());
-    const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
+    const paths = (0, project_root_1.ensureProjectPaths)(projectRoot, { dryRun: true });
     const currentRoot = () => { var _a; var _b; return (_b = (_a = (0, store_context_1.currentStoreContext)()) === null || _a === void 0 ? void 0 : _a.root) !== null && _b !== void 0 ? _b : projectRoot; };
     const storeProjects = () => { var _a; var _b; return (_b = (_a = (0, store_context_1.currentStoreContext)()) === null || _a === void 0 ? void 0 : _a.projects) !== null && _b !== void 0 ? _b : (0, project_registry_1.listProjects)(); };
     const storeConfig = () => { var _a; var _b; return (_b = (_a = (0, store_context_1.currentStoreContext)()) === null || _a === void 0 ? void 0 : _a.config) !== null && _b !== void 0 ? _b : (0, index_config_1.readGlobalConfig)(); };
@@ -597,18 +608,6 @@ exports.mcp = new commander_1.Command("mcp")
             return _skeletonizer;
         });
     }
-    // --- Index sync ---
-    function ensureIndexReady() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (_indexReady)
-                return;
-            const projects = storeProjects();
-            const isRegistered = projects.some((p) => p.root === currentRoot());
-            if (isRegistered) {
-                _indexReady = true;
-            }
-        });
-    }
     // --- Background watcher ---
     // This server's watch lease. It names our PID, so the daemon drops it the
     // minute this session exits; the TTL only covers a wedged server.
@@ -627,6 +626,17 @@ exports.mcp = new commander_1.Command("mcp")
                     (0, stores_1.matchStore)(watchRoot).kind !== "primary")
                     return;
                 const result = yield (0, watcher_launcher_1.launchWatcher)(watchRoot, WATCH_LEASE);
+                if (closing)
+                    return;
+                if (result.ok) {
+                    watchedRoots.add(watchRoot);
+                    // Discovery/catalog requests never reach this path. Renew only roots
+                    // actually read by this session, with one timer for the whole process.
+                    watchTimer !== null && watchTimer !== void 0 ? watchTimer : (watchTimer = setInterval(() => {
+                        for (const root of watchedRoots)
+                            void ensureWatcher(root);
+                    }, MCP_WATCH_LEASE_RENEW_MS).unref());
+                }
                 if (result.ok && !result.reused) {
                     console.log(`[MCP] Started background watcher for ${watchRoot} (PID: ${result.pid})`);
                 }
@@ -772,6 +782,26 @@ exports.mcp = new commander_1.Command("mcp")
                     return (candidate.length > 0 &&
                         allowedRoots.some((root) => (0, path_containment_1.isPathWithin)(root, candidate)));
                 });
+                const structuredSearch = (matches) => { var _a; return ({
+                    schemaVersion: 1,
+                    query,
+                    roots: allowedRoots,
+                    warnings: ((_a = result.warnings) !== null && _a !== void 0 ? _a : []).filter(Boolean),
+                    matches: matches.map((r) => {
+                        var _a;
+                        const startLine = searchResultStartLine(r);
+                        return {
+                            path: chunkAbsPath(r),
+                            startLine: startLine + 1,
+                            endLine: searchResultEndLine(r, startLine) + 1,
+                            symbols: chunkSymbols(r),
+                            role: String((_a = r.role) !== null && _a !== void 0 ? _a : "IMPLEMENTATION"),
+                            score: typeof r.score === "number" && Number.isFinite(r.score)
+                                ? r.score
+                                : null,
+                        };
+                    }),
+                }); };
                 // Prepend any searcher warnings to whatever body we return.
                 const prefixNotes = (body) => {
                     var _a;
@@ -779,7 +809,7 @@ exports.mcp = new commander_1.Command("mcp")
                     return notes.length ? `${notes.join("\n")}\n\n${body}` : body;
                 };
                 if (!result.data || result.data.length === 0) {
-                    return ok(prefixNotes("No matches found. Try broadening your query, using fewer keywords, or check `gmax status` to verify the project is indexed."));
+                    return ok(prefixNotes("No matches found. Try broadening your query, using fewer keywords, or check `gmax status` to verify the project is indexed."), structuredSearch([]));
                 }
                 const minScore = typeof args.min_score === "number" ? args.min_score : 0;
                 const maxPerFile = typeof args.max_per_file === "number" ? args.max_per_file : 0;
@@ -809,21 +839,25 @@ exports.mcp = new commander_1.Command("mcp")
                         getImportsForFile,
                         query,
                     });
-                    return ok(prefixNotes(output));
+                    return ok(prefixNotes(output), structuredSearch(filterMcpSearchResults(result.data, {
+                        minScore,
+                        maxPerFile,
+                        namePattern,
+                    })));
                 }
                 let results = result.data.map((r) => {
-                    var _a, _b, _c;
-                    var _d, _e, _f, _g, _h, _j, _k, _l, _m;
-                    const absPath = (_e = (_d = r.path) !== null && _d !== void 0 ? _d : (_a = r.metadata) === null || _a === void 0 ? void 0 : _a.path) !== null && _e !== void 0 ? _e : "";
+                    var _a;
+                    var _b, _c, _d, _e, _f;
+                    const absPath = (_c = (_b = r.path) !== null && _b !== void 0 ? _b : (_a = r.metadata) === null || _a === void 0 ? void 0 : _a.path) !== null && _c !== void 0 ? _c : "";
                     const relPath = absPath.startsWith(displayRoot)
                         ? absPath.slice(displayRoot.length + 1)
                         : absPath;
-                    const startLine = (_g = (_f = r.startLine) !== null && _f !== void 0 ? _f : (_b = r.generated_metadata) === null || _b === void 0 ? void 0 : _b.start_line) !== null && _g !== void 0 ? _g : 0;
-                    const endLine = (_j = (_h = r.endLine) !== null && _h !== void 0 ? _h : (_c = r.generated_metadata) === null || _c === void 0 ? void 0 : _c.end_line) !== null && _j !== void 0 ? _j : 0;
-                    const defs = toStringArray((_k = r.definedSymbols) !== null && _k !== void 0 ? _k : r.defined_symbols);
-                    const refs = toStringArray((_l = r.referenced_symbols) !== null && _l !== void 0 ? _l : r.referencedSymbols);
+                    const startLine = searchResultStartLine(r);
+                    const endLine = searchResultEndLine(r, startLine);
+                    const defs = toStringArray((_d = r.definedSymbols) !== null && _d !== void 0 ? _d : r.defined_symbols);
+                    const refs = toStringArray((_e = r.referenced_symbols) !== null && _e !== void 0 ? _e : r.referencedSymbols);
                     const symbol = defs[0] || "(anonymous)";
-                    const role = ((_m = r.role) !== null && _m !== void 0 ? _m : "IMPL").slice(0, 4).toUpperCase();
+                    const role = ((_f = r.role) !== null && _f !== void 0 ? _f : "IMPL").slice(0, 4).toUpperCase();
                     const exported = r.is_exported ? "exported " : "";
                     const complexity = typeof r.complexity === "number" && r.complexity > 0
                         ? ` C:${Math.round(r.complexity)}`
@@ -855,7 +889,7 @@ exports.mcp = new commander_1.Command("mcp")
                                             .map((l, i) => `${ctxStart + i + 1}│${l}`)
                                             .join("\n");
                             }
-                            catch (_o) {
+                            catch (_g) {
                                 // Fall through to chunk content
                             }
                         }
@@ -885,6 +919,7 @@ exports.mcp = new commander_1.Command("mcp")
                         }
                     }
                     return {
+                        row: r,
                         absPath,
                         text,
                         score: typeof r.score === "number" ? r.score : 0,
@@ -957,7 +992,7 @@ exports.mcp = new commander_1.Command("mcp")
                         // Trace failed — return search results without trace
                     }
                 }
-                return ok(prefixNotes(output));
+                return ok(prefixNotes(output), structuredSearch(results.map((r) => r.row)));
             }
             catch (e) {
                 return toolError("Search failed", e);
@@ -1105,8 +1140,9 @@ exports.mcp = new commander_1.Command("mcp")
                     render: (resp) => resp.graph,
                     inProcess: () => localStore((deps) => (0, graph_handler_1.runGraphTrace)(deps.vectorDb, { symbol, hops: depth, scope })),
                 });
+                const structured = (0, mcp_results_1.traceResult)(symbol, root, graph);
                 if (!graph.center) {
-                    return ok(`Symbol '${symbol}' not found in the index. Check \`gmax status\` to see which projects are indexed, or try \`gmax search ${symbol}\` to find similar symbols.`);
+                    return ok(`Symbol '${symbol}' not found in the index. Check \`gmax status\` to see which projects are indexed, or try \`gmax search ${symbol}\` to find similar symbols.`, structured);
                 }
                 const lines = [];
                 // Center
@@ -1165,7 +1201,7 @@ exports.mcp = new commander_1.Command("mcp")
                 else {
                     lines.push("Calls: none");
                 }
-                return ok(lines.join("\n"));
+                return ok(lines.join("\n"), structured);
             }
             catch (e) {
                 return toolError("Trace failed", e);
@@ -1406,16 +1442,17 @@ exports.mcp = new commander_1.Command("mcp")
                     render: (resp) => resp.dead,
                     inProcess: () => localStore((deps) => (0, graph_handler_1.runGraphDead)(deps.vectorDb, { symbol, scope })),
                 });
+                const structured = (0, mcp_results_1.deadResult)(symbol, root, facts);
                 if (!facts.found) {
-                    return ok(`Symbol '${symbol}' not found in the index. Check \`gmax status\` to see which projects are indexed, or try \`gmax search ${symbol}\` to find similar symbols.`);
+                    return ok(`Symbol '${symbol}' not found in the index. Check \`gmax status\` to see which projects are indexed, or try \`gmax search ${symbol}\` to find similar symbols.`, structured);
                 }
                 const rel = (p) => p.startsWith(root) ? p.slice(root.length + 1) : p;
                 const defLoc = `${rel(facts.defPath)}:${facts.defLine + 1}`;
                 if (facts.callerCount === 0) {
                     if (facts.isExported) {
-                        return ok(`PUBLIC EXPORT  ${defLoc} defines ${symbol} — no internal callers found; check external usage`);
+                        return ok(`PUBLIC EXPORT  ${defLoc} defines ${symbol} — no internal callers found; check external usage`, structured);
                     }
-                    return ok(`DEAD  ${defLoc} defines ${symbol}`);
+                    return ok(`DEAD  ${defLoc} defines ${symbol}`, structured);
                 }
                 const top = facts.topCallers;
                 const lines = [
@@ -1424,7 +1461,7 @@ exports.mcp = new commander_1.Command("mcp")
                 for (const c of top) {
                     lines.push(`  ${rel(c.file)}:${c.line + 1}`);
                 }
-                return ok(lines.join("\n"));
+                return ok(lines.join("\n"), structured);
             }
             catch (e) {
                 return toolError("Dead check failed", e);
@@ -1782,7 +1819,7 @@ exports.mcp = new commander_1.Command("mcp")
     }
     function handleIndexStatus() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c, _d, _e;
             try {
                 const globalConfig = storeConfig();
                 const projects = storeProjects();
@@ -1834,7 +1871,36 @@ exports.mcp = new commander_1.Command("mcp")
                     (0, compaction_result_1.formatCompactionStatus)(daemonStatus.compaction),
                     `Projects: ${projects.length} indexed (call list_projects for names + per-project chunk counts)`,
                 ].filter(Boolean);
-                return ok(lines.join("\n"));
+                const compaction = mcp_results_1.compactionSchema.safeParse(daemonStatus.compaction);
+                return ok(lines.join("\n"), {
+                    schemaVersion: 1,
+                    root: currentRoot(),
+                    store: storeDir(),
+                    secondary: secondary(),
+                    chunks,
+                    files,
+                    projects: projects.length,
+                    embedding: {
+                        state: identity.state,
+                        configured: {
+                            tier: identity.configured.tier,
+                            vectorDim: identity.configured.vectorDim,
+                            fingerprint: identity.configured.fingerprint,
+                        },
+                        built: identity.built
+                            ? {
+                                tier: identity.built.tier,
+                                vectorDim: identity.built.vectorDim,
+                                fingerprint: identity.built.fingerprint,
+                            }
+                            : null,
+                    },
+                    watcher: {
+                        status: (_d = (_c = daemonProject === null || daemonProject === void 0 ? void 0 : daemonProject.status) !== null && _c !== void 0 ? _c : watcher === null || watcher === void 0 ? void 0 : watcher.status) !== null && _d !== void 0 ? _d : (secondary() || !daemonStatus.ok ? "unobserved" : "not_running"),
+                        indexState: (_e = daemonProject === null || daemonProject === void 0 ? void 0 : daemonProject.indexState) !== null && _e !== void 0 ? _e : null,
+                    },
+                    compaction: compaction.success ? compaction.data : null,
+                });
             }
             catch (e) {
                 return toolError("Status check failed", e);
@@ -2572,510 +2638,544 @@ exports.mcp = new commander_1.Command("mcp")
         });
     }
     // --- MCP server setup ---
-    // Local-only MCP: client-owned pipes, no HTTP/SSE/TCP listener or host option.
-    const transport = new stdio_js_1.StdioServerTransport();
-    const server = new mcp_js_1.McpServer({
-        name: "gmax",
-        version: JSON.parse(fs.readFileSync(path.join(__dirname, "../../package.json"), {
-            encoding: "utf-8",
-        })).version,
-    }, {
-        capabilities: {
-            tools: {},
-        },
-        instructions: "gmax is a local semantic code-search index over one or more projects. " +
-            "By default tools operate on the project at the server's working directory. " +
-            "If you are NOT inside a specific repo, or want a different one: call " +
-            '`list_projects` to see what\'s indexed, then pass `projects:"name"` (or ' +
-            '`scope:"all"`) to `semantic_search`. When the working directory isn\'t an ' +
-            "indexed project, `semantic_search` errors instead of searching everything " +
-            "implicitly. Prefer `semantic_search` (detail:'pointer') for discovery, then " +
-            "`extract_symbol`/`peek_symbol`/`code_skeleton` to read, and " +
-            "`trace_calls`/`impact_analysis`/`find_tests` for call-graph questions. " +
-            "Use `audit` and experimental `surprising_connections` for project orientation.",
-    });
-    // Best-effort query logging, applied uniformly to every tool exactly as the
-    // old single CallToolRequestSchema dispatch did before each return.
-    const logToolCall = (name, toolArgs, startMs, result) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
-        var _c;
-        try {
-            const { logQuery } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/query-log")));
-            const text = (_c = (_b = (_a = result.content) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.text) !== null && _c !== void 0 ? _c : "";
-            const resultLines = text.split("\n").filter((l) => l.trim()).length;
-            logQuery({
-                ts: new Date().toISOString(),
-                source: "mcp",
-                tool: name,
-                query: mcpLogQuery(name, toolArgs),
-                project: currentRoot(),
-                results: resultLines,
-                ms: Date.now() - startMs,
-                error: result.isError ? text.slice(0, 200) : undefined,
-            });
-        }
-        catch (_d) { }
-    });
-    // Register a tool, wrapping its handler with timing + query logging. Zod raw
-    // shapes give us free input validation (the SDK rejects calls that violate
-    // the schema before the handler runs); handlers stay defensively coded.
-    function tool(name, config, handler) {
-        server.registerTool(name, Object.assign(Object.assign({}, config), { inputSchema: Object.assign({ root: zod_1.z.string().optional() }, config.inputSchema) }), (rawArgs) => __awaiter(this, void 0, void 0, function* () {
-            let args = (rawArgs !== null && rawArgs !== void 0 ? rawArgs : {});
-            const startMs = Date.now();
-            let target = projectRoot;
+    // One fresh catalog per pinned connection or disposable discovery probe.
+    // Building it performs no daemon, model, store or watcher startup.
+    function createServer() {
+        const server = new server_1.McpServer({
+            name: "gmax",
+            version: JSON.parse(fs.readFileSync(path.join(__dirname, "../../package.json"), {
+                encoding: "utf-8",
+            })).version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+            instructions: "gmax is a local semantic code-search index over one or more projects. " +
+                "By default tools operate on the project at the server's working directory. " +
+                "If you are NOT inside a specific repo, or want a different one: call " +
+                '`list_projects` to see what\'s indexed, then pass `projects:"name"` (or ' +
+                '`scope:"all"`) to `semantic_search`. When the working directory isn\'t an ' +
+                "indexed project, `semantic_search` errors instead of searching everything " +
+                "implicitly. Prefer `semantic_search` (detail:'pointer') for discovery, then " +
+                "`extract_symbol`/`peek_symbol`/`code_skeleton` to read, and " +
+                "`trace_calls`/`impact_analysis`/`find_tests` for call-graph questions. " +
+                "Use `audit` and experimental `surprising_connections` for project orientation.",
+        });
+        // Best-effort query logging, applied uniformly to every tool exactly as the
+        // old single CallToolRequestSchema dispatch did before each return.
+        const logToolCall = (name, toolArgs, startMs, result) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            var _c;
             try {
-                if (typeof args.root === "string" && args.root.trim()) {
-                    const raw = args.root.trim();
-                    if (path.isAbsolute(raw) || raw.includes(path.sep))
-                        target = path.resolve(raw);
-                    else {
-                        const projects = [
-                            ...(0, project_registry_1.listProjects)(),
-                            ...(0, store_context_1.storeInventory)().flatMap((store) => store.projects),
-                        ].filter((project, i, all) => all.findIndex((p) => p.root === project.root) === i);
-                        const selected = resolveMcpProject(raw, projectRoot, projects);
-                        if (!selected)
-                            return err(`Unknown or ambiguous registered project: ${raw}. Use list_projects or an exact root.`);
-                        target = selected.root;
+                const { logQuery } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/query-log")));
+                const text = (_c = (_b = (_a = result.content) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.text) !== null && _c !== void 0 ? _c : "";
+                const resultLines = text.split("\n").filter((l) => l.trim()).length;
+                logQuery({
+                    ts: new Date().toISOString(),
+                    source: "mcp",
+                    tool: name,
+                    query: mcpLogQuery(name, toolArgs),
+                    project: currentRoot(),
+                    results: resultLines,
+                    ms: Date.now() - startMs,
+                    error: result.isError ? text.slice(0, 200) : undefined,
+                });
+            }
+            catch (_d) { }
+        });
+        // Register a tool, wrapping its handler with timing + query logging. Zod raw
+        // shapes give us free input validation (the SDK rejects calls that violate
+        // the schema before the handler runs); handlers stay defensively coded.
+        function tool(name, config, handler) {
+            server.registerTool(name, Object.assign(Object.assign(Object.assign({}, config), (mcp_results_1.MCP_READ_OUTPUT_SCHEMAS[name]
+                ? {
+                    outputSchema: zod_1.z.object(mcp_results_1.MCP_READ_OUTPUT_SCHEMAS[name]),
+                    annotations: {
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        openWorldHint: false,
+                    },
+                }
+                : {})), { inputSchema: zod_1.z.object(Object.assign({ root: zod_1.z.string().optional() }, config.inputSchema)) }), (rawArgs) => __awaiter(this, void 0, void 0, function* () {
+                let args = (rawArgs !== null && rawArgs !== void 0 ? rawArgs : {});
+                const startMs = Date.now();
+                let target = projectRoot;
+                try {
+                    if (typeof args.root === "string" && args.root.trim()) {
+                        const raw = args.root.trim();
+                        if (path.isAbsolute(raw) || raw.includes(path.sep))
+                            target = path.resolve(raw);
+                        else {
+                            const projects = [
+                                ...(0, project_registry_1.listProjects)(),
+                                ...(0, store_context_1.storeInventory)().flatMap((store) => store.projects),
+                            ].filter((project, i, all) => all.findIndex((p) => p.root === project.root) === i);
+                            const selected = resolveMcpProject(raw, projectRoot, projects);
+                            if (!selected)
+                                return err(`Unknown or ambiguous registered project: ${raw}. Use list_projects or an exact root.`);
+                            target = selected.root;
+                        }
                     }
+                    return yield (0, store_context_1.withStoreContext)(target, () => __awaiter(this, void 0, void 0, function* () {
+                        if (args.root !== undefined) {
+                            const selected = resolveMcpProject(args.root, currentRoot(), storeProjects());
+                            if (!selected)
+                                return err(`Unknown registered project: ${args.root}. Use list_projects to select a project name or exact root.`);
+                            args = Object.assign(Object.assign({}, args), { root: selected.root });
+                            (0, store_context_1.currentStoreContext)().root = selected.root;
+                        }
+                        const result = yield handler(args);
+                        yield logToolCall(name, args, startMs, result);
+                        return result;
+                    }));
                 }
-                return yield (0, store_context_1.withStoreContext)(target, () => __awaiter(this, void 0, void 0, function* () {
-                    if (args.root !== undefined) {
-                        const selected = resolveMcpProject(args.root, currentRoot(), storeProjects());
-                        if (!selected)
-                            return err(`Unknown registered project: ${args.root}. Use list_projects to select a project name or exact root.`);
-                        args = Object.assign(Object.assign({}, args), { root: selected.root });
-                        (0, store_context_1.currentStoreContext)().root = selected.root;
-                    }
-                    const result = yield handler(args);
-                    yield logToolCall(name, args, startMs, result);
-                    return result;
-                }));
-            }
-            catch (error) {
-                return toolError("Tool failed", error);
-            }
-        }));
+                catch (error) {
+                    return toolError("Tool failed", error);
+                }
+            }));
+        }
+        tool("semantic_search", {
+            description: "Search code by meaning. Use scope:'all' for cross-project. Prefer CLI: gmax \"query\" --plain",
+            inputSchema: {
+                query: zod_1.z
+                    .string()
+                    .describe("Natural language query (5+ words recommended)"),
+                limit: zod_1.z
+                    .number()
+                    .describe("Max results (default 3, max 50)")
+                    .optional(),
+                root: zod_1.z
+                    .string()
+                    .describe("Registered project name or exact root")
+                    .optional(),
+                path: zod_1.z
+                    .string()
+                    .describe("Path prefix filter (e.g. 'src/auth/')")
+                    .optional(),
+                detail: zod_1.z
+                    .string()
+                    .describe("'pointer' (default), 'code', or 'full'")
+                    .optional(),
+                min_score: zod_1.z
+                    .number()
+                    .describe("Min score 0-1 (default 0)")
+                    .optional(),
+                max_per_file: zod_1.z
+                    .number()
+                    .describe("Max results per file")
+                    .optional(),
+                file: zod_1.z
+                    .string()
+                    .describe("Filename filter (e.g. 'syncer.ts')")
+                    .optional(),
+                exclude: zod_1.z
+                    .string()
+                    .describe("Exclude path prefix (e.g. 'tests/')")
+                    .optional(),
+                language: zod_1.z
+                    .string()
+                    .describe("Extension filter (e.g. 'ts', 'py')")
+                    .optional(),
+                role: zod_1.z
+                    .string()
+                    .describe("'ORCHESTRATION', 'DEFINITION', or 'IMPLEMENTATION'")
+                    .optional(),
+                context_lines: zod_1.z
+                    .number()
+                    .describe("Lines before/after chunk (max 20)")
+                    .optional(),
+                mode: zod_1.z
+                    .string()
+                    .describe("'default' or 'symbol' (appends call graph)")
+                    .optional(),
+                include_imports: zod_1.z
+                    .boolean()
+                    .describe("Prepend file imports to results")
+                    .optional(),
+                name_pattern: zod_1.z
+                    .string()
+                    .describe("Regex filter on symbol name")
+                    .optional(),
+                scope: zod_1.z
+                    .string()
+                    .describe("'project' (default) or 'all' (search everything)")
+                    .optional(),
+                projects: zod_1.z
+                    .string()
+                    .describe("Project names to include (comma-separated)")
+                    .optional(),
+                exclude_projects: zod_1.z
+                    .string()
+                    .describe("Project names to exclude (comma-separated)")
+                    .optional(),
+                seed_files: zod_1.z
+                    .string()
+                    .describe("Bias results toward your working context: comma-separated paths you have open (e.g. 'src/lib/llm/server.ts'). On-topic chunks in these files get lifted; off-topic ones are not.")
+                    .optional(),
+                seed_symbols: zod_1.z
+                    .string()
+                    .describe("Bias results toward identifiers you're working with: comma-separated symbol names. Chunks defining a seeded symbol are preferred over mere callers.")
+                    .optional(),
+            },
+        }, handleSemanticSearch);
+        tool("code_skeleton", {
+            description: "File structure with bodies collapsed (~4x fewer tokens). Accepts file, directory, or comma-separated paths.",
+            inputSchema: {
+                target: zod_1.z
+                    .string()
+                    .describe("File, directory, or comma-separated paths"),
+                limit: zod_1.z
+                    .number()
+                    .describe("Max files for directory mode (default 10)")
+                    .optional(),
+                format: zod_1.z
+                    .string()
+                    .describe("'text' (default) or 'json'")
+                    .optional(),
+            },
+        }, handleCodeSkeleton);
+        tool("trace_calls", {
+            description: "Call graph: importers, callers (multi-hop), callees with file:line.",
+            inputSchema: {
+                symbol: zod_1.z.string().describe("Function/class name to trace"),
+                depth: zod_1.z
+                    .number()
+                    .describe("Caller depth (default 1, max 3)")
+                    .optional(),
+            },
+        }, handleTraceCalls);
+        tool("extract_symbol", {
+            description: "Extract complete function/class body by symbol name.",
+            inputSchema: {
+                symbol: zod_1.z.string().describe("Symbol name to extract"),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (absolute path)")
+                    .optional(),
+                include_imports: zod_1.z
+                    .boolean()
+                    .describe("Prepend file imports")
+                    .optional(),
+            },
+        }, handleExtractSymbol);
+        tool("peek_symbol", {
+            description: "Compact symbol overview: signature + callers + callees.",
+            inputSchema: {
+                symbol: zod_1.z.string().describe("Symbol name"),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (absolute path)")
+                    .optional(),
+                depth: zod_1.z
+                    .number()
+                    .describe("Caller depth (default 1, max 3)")
+                    .optional(),
+            },
+        }, handlePeekSymbol);
+        tool("dead", {
+            description: "Report whether a symbol has zero inbound callers in the indexed call graph. Returns DEAD, PUBLIC EXPORT (exported with no internal callers), or LIVE with caller count. Hypothesis, not proof: dynamic dispatch, reflection, and string-built call sites won't show up.",
+            inputSchema: {
+                symbol: zod_1.z.string().describe("Symbol name to check"),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (absolute path)")
+                    .optional(),
+            },
+        }, handleDead);
+        tool("audit", {
+            description: "Graph-summary of the indexed project in one call: god nodes (most depended-upon symbols), hub files (most depended-upon files), symbol-derived file dependency cycles, and dead-code candidates (non-exported symbols with zero inbound references). Built from the static reference graph; dynamic dispatch, reflection, and eval are invisible, so dead candidates are hypotheses; verify with the `dead` tool before acting.",
+            inputSchema: {
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (default: current)")
+                    .optional(),
+                top: zod_1.z
+                    .number()
+                    .describe("How many of each category to return (default 10)")
+                    .optional(),
+            },
+        }, handleAudit);
+        tool("surprising_connections", {
+            description: "Experimental orientation signal: embedding-similar cross-directory file pairs that are not directly connected by the static symbol graph. Useful for spotting duplicate or parallel logic. Requires experimental:true.",
+            inputSchema: {
+                experimental: zod_1.z
+                    .boolean()
+                    .describe("Must be true to acknowledge experimental signal quality"),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (default: current)")
+                    .optional(),
+                sample: zod_1.z
+                    .number()
+                    .describe("Indexed code chunks to sample (default 160, max 10000)")
+                    .optional(),
+                neighbors: zod_1.z
+                    .number()
+                    .describe("Nearest neighbors per sampled chunk (default 20, max 200)")
+                    .optional(),
+                top: zod_1.z
+                    .number()
+                    .describe("Grouped findings to return (default 10, max 100)")
+                    .optional(),
+                dir_depth: zod_1.z
+                    .number()
+                    .describe("Directory bucket depth considered unsurprising")
+                    .optional(),
+                min_similarity: zod_1.z
+                    .number()
+                    .describe("Minimum similarity 0-1 (default 0)")
+                    .optional(),
+                max_rows: zod_1.z
+                    .number()
+                    .describe(`Maximum indexed rows to scan (default 50000, max ${surprising_connections_1.MAX_SURPRISE_ROWS})`)
+                    .optional(),
+                in: zod_1.z
+                    .string()
+                    .describe("Restrict to a sub-path of the project")
+                    .optional(),
+                exclude: zod_1.z
+                    .string()
+                    .describe("Exclude a sub-path of the project")
+                    .optional(),
+                include_tests: zod_1.z
+                    .boolean()
+                    .describe("Include test files")
+                    .optional(),
+                include_eval: zod_1.z
+                    .boolean()
+                    .describe("Include eval/experiment/script files")
+                    .optional(),
+            },
+        }, handleSurprisingConnections);
+        tool("get_neighbors", {
+            description: "Graph primitive: symbols reachable from a node along call edges within N hops. direction 'callees' = what it calls (outbound), 'callers' = what calls it (inbound). Each result carries its hop distance and definition location. Static call graph — same caveats as `dead`/`audit`.",
+            inputSchema: {
+                symbol: zod_1.z.string().describe("Starting symbol"),
+                direction: zod_1.z
+                    .enum(["callers", "callees"])
+                    .describe("Edge direction (default callees)")
+                    .optional(),
+                max_hops: zod_1.z
+                    .number()
+                    .describe("Max hops (default 2, max 5)")
+                    .optional(),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (absolute path)")
+                    .optional(),
+            },
+        }, handleGetNeighbors);
+        tool("find_paths", {
+            description: "Graph primitive: shortest call-graph path between two symbols, as a symbol sequence. direction 'callees' searches outward from `from` (does `from` transitively call `to`?), 'callers' searches inward. Returns 'no path' if unreachable within max_hops.",
+            inputSchema: {
+                from: zod_1.z.string().describe("Start symbol"),
+                to: zod_1.z.string().describe("Target symbol"),
+                direction: zod_1.z
+                    .enum(["callers", "callees"])
+                    .describe("Search direction (default callees)")
+                    .optional(),
+                max_hops: zod_1.z
+                    .number()
+                    .describe("Max hops (default 6, max 10)")
+                    .optional(),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (absolute path)")
+                    .optional(),
+            },
+        }, handleFindPaths);
+        tool("subgraph_for_files", {
+            description: "Graph primitive: the local dependency subgraph for a set of files — symbols they define, the call edges among those symbols, and their outbound external dependencies. Paths may be absolute or project-root-relative.",
+            inputSchema: {
+                files: zod_1.z
+                    .array(zod_1.z.string())
+                    .describe("File paths (absolute or root-relative)"),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (absolute path)")
+                    .optional(),
+            },
+        }, handleSubgraphForFiles);
+        tool("list_symbols", {
+            description: "List indexed symbols with role and export status.",
+            inputSchema: {
+                pattern: zod_1.z
+                    .string()
+                    .describe("Name filter (case-insensitive)")
+                    .optional(),
+                limit: zod_1.z.number().describe("Max results (default 20)").optional(),
+                path: zod_1.z.string().describe("Path prefix filter").optional(),
+            },
+        }, handleListSymbols);
+        tool("index_status", {
+            description: "Index health: chunks, files, projects, watcher status.",
+            inputSchema: {},
+            _meta: { "anthropic/alwaysLoad": true },
+        }, handleIndexStatus);
+        tool("list_projects", {
+            description: "List every gmax-indexed project (name, root, status, chunk count). Use this to pick a search scope when you're not inside a specific repo: feed a name into semantic_search's projects: param, or use scope:'all'. The working-directory project is marked (current).",
+            inputSchema: {},
+            _meta: { "anthropic/alwaysLoad": true },
+        }, handleListProjects);
+        tool("summarize_directory", {
+            description: "Generate LLM summaries for indexed chunks.",
+            inputSchema: {
+                path: zod_1.z
+                    .string()
+                    .describe("Directory to summarize (default: project root)")
+                    .optional(),
+                limit: zod_1.z
+                    .number()
+                    .describe("Max chunks (default 200, max 5000)")
+                    .optional(),
+            },
+        }, handleSummarizeDirectory);
+        tool("summarize_project", {
+            description: "Project overview: languages, structure, roles, key symbols, entry points.",
+            inputSchema: {
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (default: current)")
+                    .optional(),
+            },
+        }, handleSummarizeProject);
+        tool("related_files", {
+            description: "Find dependencies and dependents of a file by shared symbols.",
+            inputSchema: {
+                file: zod_1.z.string().describe("File path relative to project root"),
+                limit: zod_1.z
+                    .number()
+                    .describe("Max results per direction (default 10)")
+                    .optional(),
+            },
+        }, handleRelatedFiles);
+        tool("recent_changes", {
+            description: "Recently modified indexed files with timestamps.",
+            inputSchema: {
+                limit: zod_1.z
+                    .number()
+                    .describe("Max files to return (default 20)")
+                    .optional(),
+                root: zod_1.z
+                    .string()
+                    .describe("Project root (defaults to current project)")
+                    .optional(),
+            },
+        }, handleRecentChanges);
+        tool("diff_changes", {
+            description: "Search code scoped to git changes. Omit ref for uncommitted changes.",
+            inputSchema: {
+                ref: zod_1.z
+                    .string()
+                    .describe("Git ref to diff against (e.g. main, HEAD~5)")
+                    .optional(),
+                query: zod_1.z
+                    .string()
+                    .describe("Semantic search within changed files")
+                    .optional(),
+                limit: zod_1.z.number().describe("Max results (default 10)").optional(),
+                role: zod_1.z
+                    .string()
+                    .describe("Filter by role: ORCHESTRATION, DEFINITION, IMPLEMENTATION")
+                    .optional(),
+            },
+        }, handleDiffChanges);
+        tool("find_tests", {
+            description: "Find tests that exercise a symbol or file via reverse call graph.",
+            inputSchema: {
+                target: zod_1.z.string().describe("Symbol name or file path"),
+                depth: zod_1.z
+                    .number()
+                    .describe("Caller traversal depth 1-3 (default 1)")
+                    .optional(),
+            },
+        }, handleFindTests);
+        tool("impact_analysis", {
+            description: "Change impact: dependents and affected tests for a symbol or file.",
+            inputSchema: {
+                target: zod_1.z.string().describe("Symbol name or file path"),
+                depth: zod_1.z
+                    .number()
+                    .describe("Caller traversal depth 1-3 (default 1)")
+                    .optional(),
+                rollup: zod_1.z
+                    .boolean()
+                    .describe("Return export/package rollup TSV rows")
+                    .optional(),
+                top: zod_1.z
+                    .number()
+                    .describe("Max rows per rollup section (default 10)")
+                    .optional(),
+            },
+        }, handleImpactAnalysis);
+        tool("find_similar", {
+            description: "Find semantically similar code using vector similarity.",
+            inputSchema: {
+                target: zod_1.z.string().describe("Symbol name or file path"),
+                limit: zod_1.z.number().describe("Max results (default 5)").optional(),
+                threshold: zod_1.z
+                    .number()
+                    .describe("Min similarity 0-1 (default 0)")
+                    .optional(),
+            },
+        }, handleFindSimilar);
+        tool("build_context", {
+            description: "Token-budgeted topic summary (search + skeleton + extract).",
+            inputSchema: {
+                topic: zod_1.z
+                    .string()
+                    .describe("Natural language topic or directory path"),
+                budget: zod_1.z.number().describe("Max tokens (default 4000)").optional(),
+                limit: zod_1.z
+                    .number()
+                    .describe("Search result limit (default 10)")
+                    .optional(),
+            },
+        }, handleBuildContext);
+        tool("investigate", {
+            description: "Agentic codebase Q&A: a local LLM answers questions using search, trace, peek, impact, and related tools. Requires LLM to be enabled (gmax llm on).",
+            inputSchema: {
+                question: zod_1.z
+                    .string()
+                    .describe("Natural language question about the codebase"),
+                max_rounds: zod_1.z
+                    .number()
+                    .describe("Max tool-call rounds (default 10)")
+                    .optional(),
+            },
+        }, handleInvestigate);
+        tool("review_commit", {
+            description: "Review a git commit for bugs, breaking changes, and security issues using local LLM + codebase context. Returns structured findings. Requires LLM to be enabled (gmax llm on).",
+            inputSchema: {
+                commit: zod_1.z
+                    .string()
+                    .describe("Git ref to review (default: HEAD)")
+                    .optional(),
+            },
+        }, handleReviewCommit);
+        tool("review_report", {
+            description: "Get the accumulated code review report for the current project. Returns findings from all reviewed commits.",
+            inputSchema: {
+                json: zod_1.z
+                    .boolean()
+                    .describe("Return raw JSON instead of text (default: false)")
+                    .optional(),
+            },
+        }, handleReviewReport);
+        tool("review_risk", {
+            description: "Deterministic risk ranking of the symbols a commit's diff touches, ordered by blast radius (inbound callers) × test presence × file churn. No LLM required — fast, graph + git only. Use to triage what a change endangers before a deep review.",
+            inputSchema: {
+                commit: zod_1.z
+                    .string()
+                    .describe("Git ref to analyze (default: HEAD)")
+                    .optional(),
+            },
+        }, handleReviewRisk);
+        return server;
     }
-    tool("semantic_search", {
-        description: "Search code by meaning. Use scope:'all' for cross-project. Prefer CLI: gmax \"query\" --plain",
-        inputSchema: {
-            query: zod_1.z
-                .string()
-                .describe("Natural language query (5+ words recommended)"),
-            limit: zod_1.z
-                .number()
-                .describe("Max results (default 3, max 50)")
-                .optional(),
-            root: zod_1.z
-                .string()
-                .describe("Registered project name or exact root")
-                .optional(),
-            path: zod_1.z
-                .string()
-                .describe("Path prefix filter (e.g. 'src/auth/')")
-                .optional(),
-            detail: zod_1.z
-                .string()
-                .describe("'pointer' (default), 'code', or 'full'")
-                .optional(),
-            min_score: zod_1.z
-                .number()
-                .describe("Min score 0-1 (default 0)")
-                .optional(),
-            max_per_file: zod_1.z.number().describe("Max results per file").optional(),
-            file: zod_1.z
-                .string()
-                .describe("Filename filter (e.g. 'syncer.ts')")
-                .optional(),
-            exclude: zod_1.z
-                .string()
-                .describe("Exclude path prefix (e.g. 'tests/')")
-                .optional(),
-            language: zod_1.z
-                .string()
-                .describe("Extension filter (e.g. 'ts', 'py')")
-                .optional(),
-            role: zod_1.z
-                .string()
-                .describe("'ORCHESTRATION', 'DEFINITION', or 'IMPLEMENTATION'")
-                .optional(),
-            context_lines: zod_1.z
-                .number()
-                .describe("Lines before/after chunk (max 20)")
-                .optional(),
-            mode: zod_1.z
-                .string()
-                .describe("'default' or 'symbol' (appends call graph)")
-                .optional(),
-            include_imports: zod_1.z
-                .boolean()
-                .describe("Prepend file imports to results")
-                .optional(),
-            name_pattern: zod_1.z
-                .string()
-                .describe("Regex filter on symbol name")
-                .optional(),
-            scope: zod_1.z
-                .string()
-                .describe("'project' (default) or 'all' (search everything)")
-                .optional(),
-            projects: zod_1.z
-                .string()
-                .describe("Project names to include (comma-separated)")
-                .optional(),
-            exclude_projects: zod_1.z
-                .string()
-                .describe("Project names to exclude (comma-separated)")
-                .optional(),
-            seed_files: zod_1.z
-                .string()
-                .describe("Bias results toward your working context: comma-separated paths you have open (e.g. 'src/lib/llm/server.ts'). On-topic chunks in these files get lifted; off-topic ones are not.")
-                .optional(),
-            seed_symbols: zod_1.z
-                .string()
-                .describe("Bias results toward identifiers you're working with: comma-separated symbol names. Chunks defining a seeded symbol are preferred over mere callers.")
-                .optional(),
-        },
-    }, handleSemanticSearch);
-    tool("code_skeleton", {
-        description: "File structure with bodies collapsed (~4x fewer tokens). Accepts file, directory, or comma-separated paths.",
-        inputSchema: {
-            target: zod_1.z
-                .string()
-                .describe("File, directory, or comma-separated paths"),
-            limit: zod_1.z
-                .number()
-                .describe("Max files for directory mode (default 10)")
-                .optional(),
-            format: zod_1.z.string().describe("'text' (default) or 'json'").optional(),
-        },
-    }, handleCodeSkeleton);
-    tool("trace_calls", {
-        description: "Call graph: importers, callers (multi-hop), callees with file:line.",
-        inputSchema: {
-            symbol: zod_1.z.string().describe("Function/class name to trace"),
-            depth: zod_1.z
-                .number()
-                .describe("Caller depth (default 1, max 3)")
-                .optional(),
-        },
-    }, handleTraceCalls);
-    tool("extract_symbol", {
-        description: "Extract complete function/class body by symbol name.",
-        inputSchema: {
-            symbol: zod_1.z.string().describe("Symbol name to extract"),
-            root: zod_1.z.string().describe("Project root (absolute path)").optional(),
-            include_imports: zod_1.z
-                .boolean()
-                .describe("Prepend file imports")
-                .optional(),
-        },
-    }, handleExtractSymbol);
-    tool("peek_symbol", {
-        description: "Compact symbol overview: signature + callers + callees.",
-        inputSchema: {
-            symbol: zod_1.z.string().describe("Symbol name"),
-            root: zod_1.z.string().describe("Project root (absolute path)").optional(),
-            depth: zod_1.z
-                .number()
-                .describe("Caller depth (default 1, max 3)")
-                .optional(),
-        },
-    }, handlePeekSymbol);
-    tool("dead", {
-        description: "Report whether a symbol has zero inbound callers in the indexed call graph. Returns DEAD, PUBLIC EXPORT (exported with no internal callers), or LIVE with caller count. Hypothesis, not proof: dynamic dispatch, reflection, and string-built call sites won't show up.",
-        inputSchema: {
-            symbol: zod_1.z.string().describe("Symbol name to check"),
-            root: zod_1.z.string().describe("Project root (absolute path)").optional(),
-        },
-    }, handleDead);
-    tool("audit", {
-        description: "Graph-summary of the indexed project in one call: god nodes (most depended-upon symbols), hub files (most depended-upon files), symbol-derived file dependency cycles, and dead-code candidates (non-exported symbols with zero inbound references). Built from the static reference graph; dynamic dispatch, reflection, and eval are invisible, so dead candidates are hypotheses; verify with the `dead` tool before acting.",
-        inputSchema: {
-            root: zod_1.z
-                .string()
-                .describe("Project root (default: current)")
-                .optional(),
-            top: zod_1.z
-                .number()
-                .describe("How many of each category to return (default 10)")
-                .optional(),
-        },
-    }, handleAudit);
-    tool("surprising_connections", {
-        description: "Experimental orientation signal: embedding-similar cross-directory file pairs that are not directly connected by the static symbol graph. Useful for spotting duplicate or parallel logic. Requires experimental:true.",
-        inputSchema: {
-            experimental: zod_1.z
-                .boolean()
-                .describe("Must be true to acknowledge experimental signal quality"),
-            root: zod_1.z
-                .string()
-                .describe("Project root (default: current)")
-                .optional(),
-            sample: zod_1.z
-                .number()
-                .describe("Indexed code chunks to sample (default 160, max 10000)")
-                .optional(),
-            neighbors: zod_1.z
-                .number()
-                .describe("Nearest neighbors per sampled chunk (default 20, max 200)")
-                .optional(),
-            top: zod_1.z
-                .number()
-                .describe("Grouped findings to return (default 10, max 100)")
-                .optional(),
-            dir_depth: zod_1.z
-                .number()
-                .describe("Directory bucket depth considered unsurprising")
-                .optional(),
-            min_similarity: zod_1.z
-                .number()
-                .describe("Minimum similarity 0-1 (default 0)")
-                .optional(),
-            max_rows: zod_1.z
-                .number()
-                .describe(`Maximum indexed rows to scan (default 50000, max ${surprising_connections_1.MAX_SURPRISE_ROWS})`)
-                .optional(),
-            in: zod_1.z
-                .string()
-                .describe("Restrict to a sub-path of the project")
-                .optional(),
-            exclude: zod_1.z
-                .string()
-                .describe("Exclude a sub-path of the project")
-                .optional(),
-            include_tests: zod_1.z.boolean().describe("Include test files").optional(),
-            include_eval: zod_1.z
-                .boolean()
-                .describe("Include eval/experiment/script files")
-                .optional(),
-        },
-    }, handleSurprisingConnections);
-    tool("get_neighbors", {
-        description: "Graph primitive: symbols reachable from a node along call edges within N hops. direction 'callees' = what it calls (outbound), 'callers' = what calls it (inbound). Each result carries its hop distance and definition location. Static call graph — same caveats as `dead`/`audit`.",
-        inputSchema: {
-            symbol: zod_1.z.string().describe("Starting symbol"),
-            direction: zod_1.z
-                .enum(["callers", "callees"])
-                .describe("Edge direction (default callees)")
-                .optional(),
-            max_hops: zod_1.z
-                .number()
-                .describe("Max hops (default 2, max 5)")
-                .optional(),
-            root: zod_1.z.string().describe("Project root (absolute path)").optional(),
-        },
-    }, handleGetNeighbors);
-    tool("find_paths", {
-        description: "Graph primitive: shortest call-graph path between two symbols, as a symbol sequence. direction 'callees' searches outward from `from` (does `from` transitively call `to`?), 'callers' searches inward. Returns 'no path' if unreachable within max_hops.",
-        inputSchema: {
-            from: zod_1.z.string().describe("Start symbol"),
-            to: zod_1.z.string().describe("Target symbol"),
-            direction: zod_1.z
-                .enum(["callers", "callees"])
-                .describe("Search direction (default callees)")
-                .optional(),
-            max_hops: zod_1.z
-                .number()
-                .describe("Max hops (default 6, max 10)")
-                .optional(),
-            root: zod_1.z.string().describe("Project root (absolute path)").optional(),
-        },
-    }, handleFindPaths);
-    tool("subgraph_for_files", {
-        description: "Graph primitive: the local dependency subgraph for a set of files — symbols they define, the call edges among those symbols, and their outbound external dependencies. Paths may be absolute or project-root-relative.",
-        inputSchema: {
-            files: zod_1.z
-                .array(zod_1.z.string())
-                .describe("File paths (absolute or root-relative)"),
-            root: zod_1.z.string().describe("Project root (absolute path)").optional(),
-        },
-    }, handleSubgraphForFiles);
-    tool("list_symbols", {
-        description: "List indexed symbols with role and export status.",
-        inputSchema: {
-            pattern: zod_1.z
-                .string()
-                .describe("Name filter (case-insensitive)")
-                .optional(),
-            limit: zod_1.z.number().describe("Max results (default 20)").optional(),
-            path: zod_1.z.string().describe("Path prefix filter").optional(),
-        },
-    }, handleListSymbols);
-    tool("index_status", {
-        description: "Index health: chunks, files, projects, watcher status.",
-        inputSchema: {},
-        _meta: { "anthropic/alwaysLoad": true },
-    }, handleIndexStatus);
-    tool("list_projects", {
-        description: "List every gmax-indexed project (name, root, status, chunk count). Use this to pick a search scope when you're not inside a specific repo: feed a name into semantic_search's projects: param, or use scope:'all'. The working-directory project is marked (current).",
-        inputSchema: {},
-        _meta: { "anthropic/alwaysLoad": true },
-    }, handleListProjects);
-    tool("summarize_directory", {
-        description: "Generate LLM summaries for indexed chunks.",
-        inputSchema: {
-            path: zod_1.z
-                .string()
-                .describe("Directory to summarize (default: project root)")
-                .optional(),
-            limit: zod_1.z
-                .number()
-                .describe("Max chunks (default 200, max 5000)")
-                .optional(),
-        },
-    }, handleSummarizeDirectory);
-    tool("summarize_project", {
-        description: "Project overview: languages, structure, roles, key symbols, entry points.",
-        inputSchema: {
-            root: zod_1.z
-                .string()
-                .describe("Project root (default: current)")
-                .optional(),
-        },
-    }, handleSummarizeProject);
-    tool("related_files", {
-        description: "Find dependencies and dependents of a file by shared symbols.",
-        inputSchema: {
-            file: zod_1.z.string().describe("File path relative to project root"),
-            limit: zod_1.z
-                .number()
-                .describe("Max results per direction (default 10)")
-                .optional(),
-        },
-    }, handleRelatedFiles);
-    tool("recent_changes", {
-        description: "Recently modified indexed files with timestamps.",
-        inputSchema: {
-            limit: zod_1.z
-                .number()
-                .describe("Max files to return (default 20)")
-                .optional(),
-            root: zod_1.z
-                .string()
-                .describe("Project root (defaults to current project)")
-                .optional(),
-        },
-    }, handleRecentChanges);
-    tool("diff_changes", {
-        description: "Search code scoped to git changes. Omit ref for uncommitted changes.",
-        inputSchema: {
-            ref: zod_1.z
-                .string()
-                .describe("Git ref to diff against (e.g. main, HEAD~5)")
-                .optional(),
-            query: zod_1.z
-                .string()
-                .describe("Semantic search within changed files")
-                .optional(),
-            limit: zod_1.z.number().describe("Max results (default 10)").optional(),
-            role: zod_1.z
-                .string()
-                .describe("Filter by role: ORCHESTRATION, DEFINITION, IMPLEMENTATION")
-                .optional(),
-        },
-    }, handleDiffChanges);
-    tool("find_tests", {
-        description: "Find tests that exercise a symbol or file via reverse call graph.",
-        inputSchema: {
-            target: zod_1.z.string().describe("Symbol name or file path"),
-            depth: zod_1.z
-                .number()
-                .describe("Caller traversal depth 1-3 (default 1)")
-                .optional(),
-        },
-    }, handleFindTests);
-    tool("impact_analysis", {
-        description: "Change impact: dependents and affected tests for a symbol or file.",
-        inputSchema: {
-            target: zod_1.z.string().describe("Symbol name or file path"),
-            depth: zod_1.z
-                .number()
-                .describe("Caller traversal depth 1-3 (default 1)")
-                .optional(),
-            rollup: zod_1.z
-                .boolean()
-                .describe("Return export/package rollup TSV rows")
-                .optional(),
-            top: zod_1.z
-                .number()
-                .describe("Max rows per rollup section (default 10)")
-                .optional(),
-        },
-    }, handleImpactAnalysis);
-    tool("find_similar", {
-        description: "Find semantically similar code using vector similarity.",
-        inputSchema: {
-            target: zod_1.z.string().describe("Symbol name or file path"),
-            limit: zod_1.z.number().describe("Max results (default 5)").optional(),
-            threshold: zod_1.z
-                .number()
-                .describe("Min similarity 0-1 (default 0)")
-                .optional(),
-        },
-    }, handleFindSimilar);
-    tool("build_context", {
-        description: "Token-budgeted topic summary (search + skeleton + extract).",
-        inputSchema: {
-            topic: zod_1.z
-                .string()
-                .describe("Natural language topic or directory path"),
-            budget: zod_1.z.number().describe("Max tokens (default 4000)").optional(),
-            limit: zod_1.z
-                .number()
-                .describe("Search result limit (default 10)")
-                .optional(),
-        },
-    }, handleBuildContext);
-    tool("investigate", {
-        description: "Agentic codebase Q&A: a local LLM answers questions using search, trace, peek, impact, and related tools. Requires LLM to be enabled (gmax llm on).",
-        inputSchema: {
-            question: zod_1.z
-                .string()
-                .describe("Natural language question about the codebase"),
-            max_rounds: zod_1.z
-                .number()
-                .describe("Max tool-call rounds (default 10)")
-                .optional(),
-        },
-    }, handleInvestigate);
-    tool("review_commit", {
-        description: "Review a git commit for bugs, breaking changes, and security issues using local LLM + codebase context. Returns structured findings. Requires LLM to be enabled (gmax llm on).",
-        inputSchema: {
-            commit: zod_1.z
-                .string()
-                .describe("Git ref to review (default: HEAD)")
-                .optional(),
-        },
-    }, handleReviewCommit);
-    tool("review_report", {
-        description: "Get the accumulated code review report for the current project. Returns findings from all reviewed commits.",
-        inputSchema: {
-            json: zod_1.z
-                .boolean()
-                .describe("Return raw JSON instead of text (default: false)")
-                .optional(),
-        },
-    }, handleReviewReport);
-    tool("review_risk", {
-        description: "Deterministic risk ranking of the symbols a commit's diff touches, ordered by blast radius (inbound callers) × test presence × file churn. No LLM required — fast, graph + git only. Use to triage what a change endangers before a deep review.",
-        inputSchema: {
-            commit: zod_1.z
-                .string()
-                .describe("Git ref to analyze (default: HEAD)")
-                .optional(),
-        },
-    }, handleReviewRisk);
-    yield server.connect(transport);
-    // Start the singleton daemon in the background without delaying MCP startup.
-    void Promise.resolve().then(() => __importStar(require("../lib/utils/daemon-client"))).then(({ ensureDaemonRunning }) => ensureDaemonRunning())
-        .catch((e) => console.error("[MCP] Daemon startup failed:", e));
-    // Kick off index readiness check and watcher in background
-    ensureIndexReady().catch((e) => console.error("[MCP] Index readiness check failed:", e));
-    ensureWatcher();
-    // Keep this session's project leased while the session lives. The daemon
-    // only watches projects some session holds.
-    setInterval(() => void ensureWatcher(), MCP_WATCH_LEASE_RENEW_MS).unref();
+    // Local-only, dual-era MCP: client-owned stdin/stdout pipes only.
+    stdio = (0, stdio_1.serveStdio)(createServer, {
+        legacy: "serve",
+        onerror: (error) => console.error("[MCP] Transport error:", error),
+    });
 }));