grepmax 0.26.45 → 0.26.47

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");
@@ -97,6 +97,7 @@ const daemon_client_1 = require("../lib/utils/daemon-client");
 const file_utils_1 = require("../lib/utils/file-utils");
 const format_helpers_1 = require("../lib/utils/format-helpers");
 const import_extractor_1 = require("../lib/utils/import-extractor");
+const mcp_execution_1 = require("../lib/utils/mcp-execution");
 const path_containment_1 = require("../lib/utils/path-containment");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
@@ -374,12 +375,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) => {
@@ -395,7 +406,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)(); };
@@ -404,20 +415,26 @@ exports.mcp = new commander_1.Command("mcp")
     // Propagate project root to worker processes
     process.env.GMAX_PROJECT_ROOT = paths.root;
     // --- Store access ---
+    function sendMcpCommand(cmd, opts) {
+        return (0, mcp_execution_1.mcpOperation)(`Daemon: ${cmd.cmd}`, () => (0, daemon_client_1.sendDaemonCommand)(cmd, Object.assign(Object.assign({}, opts), { signal: (0, mcp_execution_1.mcpSignal)() })));
+    }
     /**
      * One read through the access policy, with MCP's fallback allowances. The
      * `inProcess` branch is entered only when no daemon serves the verb.
      */
     function readStore(name, opts) {
-        return (0, store_access_1.withStoreRead)(name, Object.assign(Object.assign(Object.assign({}, opts), MCP_STORE_FALLBACK), { skipDaemon: secondary() }));
+        return (0, store_access_1.withStoreRead)(name, Object.assign(Object.assign(Object.assign({ signal: (0, mcp_execution_1.mcpSignal)() }, opts), MCP_STORE_FALLBACK), { skipDaemon: secondary() }));
     }
     /** Open the shared store for the duration of one fallback, then close it. */
     function localStore(fn) {
-        return (0, rows_handler_1.withLocalStore)(storeDir(), fn, storeConfig().vectorDim);
+        return (0, mcp_execution_1.mcpOperation)("Reading selected local store", () => (0, rows_handler_1.withLocalStore)(storeDir(), (deps) => __awaiter(this, void 0, void 0, function* () {
+            (0, mcp_execution_1.checkMcpCancellation)();
+            return fn(deps);
+        }), storeConfig().vectorDim));
     }
     /** A graph verb with MCP's fallback allowances. */
     function graphVerb(verb, call) {
-        return (0, graph_handler_1.callGraphVerb)(verb, Object.assign(Object.assign({}, call), { fallback: Object.assign(Object.assign({}, MCP_STORE_FALLBACK), (secondary() ? { skipDaemon: true } : {})) }));
+        return (0, mcp_execution_1.mcpOperation)(`Reading ${verb}`, () => (0, graph_handler_1.callGraphVerb)(verb, Object.assign(Object.assign({}, call), { signal: (0, mcp_execution_1.mcpSignal)(), fallback: Object.assign(Object.assign({}, MCP_STORE_FALLBACK), (secondary() ? { skipDaemon: true } : {})) })));
     }
     /**
      * MCP tools take no `--in`/`--exclude`, so a tool's scope is always the
@@ -447,7 +464,7 @@ exports.mcp = new commander_1.Command("mcp")
      */
     function searchStore(args) {
         return readStore("search", {
-            daemon: () => { var _a; return (0, daemon_client_1.sendDaemonCommand)(Object.assign({ cmd: ((_a = args.filters) === null || _a === void 0 ? void 0 : _a.projectRoots) ? "search-v2" : "search" }, args), { timeoutMs: 60000 }); },
+            daemon: () => { var _a; return sendMcpCommand(Object.assign({ cmd: ((_a = args.filters) === null || _a === void 0 ? void 0 : _a.projectRoots) ? "search-v2" : "search" }, args), { timeoutMs: 60000 }); },
             render: (resp) => {
                 const warnings = Array.isArray(resp.warnings)
                     ? resp.warnings.filter((w) => typeof w === "string")
@@ -466,7 +483,7 @@ exports.mcp = new commander_1.Command("mcp")
                     : undefined;
                 try {
                     const searcher = new searcher_1.Searcher(deps.vectorDb, pool);
-                    return yield searcher.search(args.query, args.limit, { rerank: args.rerank, seeds: args.seeds }, args.filters, args.pathPrefix);
+                    return yield searcher.search(args.query, args.limit, { rerank: args.rerank, seeds: args.seeds }, args.filters, args.pathPrefix, undefined, (0, mcp_execution_1.mcpSignal)());
                 }
                 finally {
                     yield pool === null || pool === void 0 ? void 0 : pool.destroy();
@@ -538,7 +555,7 @@ exports.mcp = new commander_1.Command("mcp")
      * order. Batched so a per-symbol loop costs one round trip, not hundreds.
      */
     function locateRows(root, req) {
-        return (0, rows_handler_1.readRows)(Object.assign({ name: "locate", projectRoot: root, lancedbDir: storeDir(), vectorDim: storeConfig().vectorDim, scope: projectScope(root), fallback: Object.assign(Object.assign({}, MCP_STORE_FALLBACK), { skipDaemon: secondary() }) }, req));
+        return (0, mcp_execution_1.mcpOperation)("Locating indexed rows", () => (0, rows_handler_1.readRows)(Object.assign({ signal: (0, mcp_execution_1.mcpSignal)(), name: "locate", projectRoot: root, lancedbDir: storeDir(), vectorDim: storeConfig().vectorDim, scope: projectScope(root), fallback: Object.assign(Object.assign({}, MCP_STORE_FALLBACK), { skipDaemon: secondary() }) }, req)));
     }
     /**
      * Chunk and file totals for `index_status`, summed per registered project.
@@ -556,8 +573,9 @@ exports.mcp = new commander_1.Command("mcp")
             let chunks = 0;
             let files = 0;
             for (const project of projects) {
+                (0, mcp_execution_1.checkMcpCancellation)();
                 const totals = yield readStore("project-stats", {
-                    daemon: () => (0, daemon_client_1.sendDaemonCommand)({ cmd: "project-stats", root: project.root }, { timeoutMs: 30000 }),
+                    daemon: () => sendMcpCommand({ cmd: "project-stats", root: project.root }, { timeoutMs: 30000 }),
                     render: (resp) => ({
                         chunks: typeof resp.chunks === "number" ? resp.chunks : 0,
                         files: typeof resp.files === "number" ? resp.files : 0,
@@ -581,7 +599,7 @@ exports.mcp = new commander_1.Command("mcp")
     /** `rows.skeleton`: the stored per-file skeleton (and the symbol lookup). */
     function lookupSkeleton(root, req) {
         return readStore("skeleton", {
-            daemon: () => (0, daemon_client_1.sendDaemonCommand)(Object.assign({ cmd: "rows.skeleton", projectRoot: root }, req), { timeoutMs: 30000 }),
+            daemon: () => sendMcpCommand(Object.assign({ cmd: "rows.skeleton", projectRoot: root }, req), { timeoutMs: 30000 }),
             render: (resp) => { var _a, _b; return ({
                 path: ((_a = resp.path) !== null && _a !== void 0 ? _a : null),
                 skeleton: ((_b = resp.skeleton) !== null && _b !== void 0 ? _b : null),
@@ -598,18 +616,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.
@@ -620,21 +626,34 @@ exports.mcp = new commander_1.Command("mcp")
     };
     function ensureWatcher(root) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            try {
-                const watchRoot = root !== null && root !== void 0 ? root : (_a = resolveMcpProject(undefined, currentRoot(), storeProjects())) === null || _a === void 0 ? void 0 : _a.root;
-                if (!watchRoot ||
-                    secondary() ||
-                    (0, stores_1.matchStore)(watchRoot).kind !== "primary")
-                    return;
-                const result = yield (0, watcher_launcher_1.launchWatcher)(watchRoot, WATCH_LEASE);
-                if (result.ok && !result.reused) {
-                    console.log(`[MCP] Started background watcher for ${watchRoot} (PID: ${result.pid})`);
+            return (0, mcp_execution_1.withoutMcpExecution)(() => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                try {
+                    const watchRoot = root !== null && root !== void 0 ? root : (_a = resolveMcpProject(undefined, currentRoot(), storeProjects())) === null || _a === void 0 ? void 0 : _a.root;
+                    if (!watchRoot ||
+                        secondary() ||
+                        (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})`);
+                    }
                 }
-            }
-            catch (err) {
-                console.error("[MCP] Watcher startup failed:", err);
-            }
+                catch (err) {
+                    console.error("[MCP] Watcher startup failed:", err);
+                }
+            }));
         });
     }
     // Resolve the registered project this server scopes to. The server pins to
@@ -1557,7 +1576,7 @@ exports.mcp = new commander_1.Command("mcp")
                 // returns the summary plus the findings this will print, and drops the
                 // raw `pairs` array entirely.
                 const result = yield readStore("surprises", {
-                    daemon: () => (0, daemon_client_1.sendDaemonCommand)({
+                    daemon: () => sendMcpCommand({
                         cmd: "vector.surprises",
                         projectRoot: root,
                         options,
@@ -1733,7 +1752,7 @@ exports.mcp = new commander_1.Command("mcp")
                         ? root
                         : `${root}/`;
                 const entries = yield readStore("symbols", {
-                    daemon: () => (0, daemon_client_1.sendDaemonCommand)({
+                    daemon: () => sendMcpCommand({
                         cmd: "rows.symbols",
                         projectRoot: root,
                         pathPrefix: absPrefix,
@@ -1819,7 +1838,7 @@ exports.mcp = new commander_1.Command("mcp")
                 const { chunks, files } = yield indexTotals(projects);
                 const daemonStatus = secondary()
                     ? { ok: true, projects: [] }
-                    : yield (0, daemon_client_1.sendDaemonCommand)({ cmd: "status" });
+                    : yield sendMcpCommand({ cmd: "status" });
                 const watched = (Array.isArray(daemonStatus.projects) ? daemonStatus.projects : []);
                 const daemonProject = watched.find((p) => p.root === (currentProject === null || currentProject === void 0 ? void 0 : currentProject.root));
                 // Only use the registry when no daemon answered; sandboxed reads stay IPC-only.
@@ -1945,7 +1964,7 @@ exports.mcp = new commander_1.Command("mcp")
                 // rows it was computed from — the same aggregation `gmax project` runs,
                 // in whichever process holds the store.
                 const overview = yield readStore("project", {
-                    daemon: () => (0, daemon_client_1.sendDaemonCommand)({ cmd: "rows.project", projectRoot: root }, { timeoutMs: 120000 }),
+                    daemon: () => sendMcpCommand({ cmd: "rows.project", projectRoot: root }, { timeoutMs: 120000 }),
                     render: (resp) => resp.overview,
                     inProcess: () => localStore((deps) => (0, rows_handler_1.runProject)(deps, root)),
                 });
@@ -2381,7 +2400,7 @@ exports.mcp = new commander_1.Command("mcp")
                 // The source chunk's vector never leaves the store: the daemon looks it
                 // up, runs the vector search, and returns the ranked chunks.
                 const result = yield readStore("similar", {
-                    daemon: () => (0, daemon_client_1.sendDaemonCommand)({
+                    daemon: () => sendMcpCommand({
                         cmd: "vector.similar",
                         projectRoot: root,
                         absPath,
@@ -2629,519 +2648,549 @@ 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(Object.assign({}, config), (mcp_results_1.MCP_READ_OUTPUT_SCHEMAS[name]
-            ? {
-                outputSchema: mcp_results_1.MCP_READ_OUTPUT_SCHEMAS[name],
-                annotations: {
-                    readOnlyHint: true,
-                    destructiveHint: false,
-                    openWorldHint: false,
-                },
-            }
-            : {})), { 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_1, toolArgs_1, startMs_1, result_1, ...args_1) => __awaiter(this, [name_1, toolArgs_1, startMs_1, result_1, ...args_1], void 0, function* (name, toolArgs, startMs, result, root = currentRoot()) {
+            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: root,
+                    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,
+                    },
                 }
-                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;
+                : {})), { inputSchema: zod_1.z.object(Object.assign({ root: zod_1.z.string().optional() }, config.inputSchema)) }), (rawArgs, context) => __awaiter(this, void 0, void 0, function* () {
+                return (0, mcp_execution_1.withMcpExecution)(context === null || context === void 0 ? void 0 : context.mcpReq, () => __awaiter(this, void 0, void 0, function* () {
+                    let args = (rawArgs !== null && rawArgs !== void 0 ? rawArgs : {});
+                    const startMs = Date.now();
+                    let target = projectRoot;
+                    try {
+                        (0, mcp_execution_1.checkMcpCancellation)();
+                        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 (0, mcp_execution_1.mcpOperation)(`Starting ${name}`, () => handler(args));
+                            yield logToolCall(name, args, startMs, result);
+                            return result;
+                        }));
+                    }
+                    catch (error) {
+                        const result = toolError("Tool failed", error);
+                        yield logToolCall(name, args, startMs, result, target);
+                        return result;
                     }
-                    const result = yield handler(args);
-                    yield logToolCall(name, args, startMs, result);
-                    return result;
                 }));
-            }
-            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),
+    });
 }));