@lzehrung/codegraph 3.0.1 → 3.1.1

package/dist/mcp/handlers.d.ts

@@ -30,9 +30,26 @@ export type CodegraphMcpHandlerOptions = {
 export type CodegraphMcpServerOptions = CodegraphMcpHandlerOptions & {
     /**
      * Defaults to `"base"` when Codegraph creates the session itself; defaults to `"off"`
-     * when `session` is supplied explicitly. Pass `"off"` to always start lazily.
+     * when `session` is supplied explicitly. Pass `"off"` to always start lazily. `"base"` builds the project
+     * index, the symbol graph, and the search index in the background, `"symbols"` also the detailed symbol graph.
+     * The server answers `initialize` and `tools/list` at once, whichever mode runs.
      */
     warmup?: CodegraphMcpWarmupMode;
+    /**
+     * Watches the project for file changes and refreshes the index in the background. Defaults to `true` when
+     * Codegraph creates the session itself; has no effect when `session` is supplied. Pass `false` to leave
+     * freshness to the check that every tool call runs.
+     */
+    watch?: boolean;
+    /** Milliseconds of quiet after the last file event before a background refresh starts. Defaults to 500. */
+    watchDebounceMs?: number;
+    /** Minimum milliseconds between background refresh starts. Defaults to 5 seconds. */
+    watchMinRefreshIntervalMs?: number;
+    /**
+     * Pauses the watcher after this many milliseconds without a tool call; the next call resumes it. Use 0 to
+     * never pause. Defaults to 30 minutes.
+     */
+    watchIdleMs?: number;
     host?: string;
     port?: number;
     /** Stdio-only idle exit timeout in ms. Use 0 to disable. Defaults to 30 minutes. */
@@ -49,6 +66,15 @@ export type CodegraphMcpServerOptions = CodegraphMcpHandlerOptions & {
     httpBodyTimeoutMs?: number;
     /** Maximum time to execute one MCP tool call in ms. Use 0 to disable. Defaults to 5 minutes. */
     mcpToolTimeoutMs?: number;
+    /**
+     * Longest time in ms that `search`, `explore`, `orient`, `get_file` with `includeGraphContext`, `review`, `packet_get`,
+     * `workspace_symbols`, and `impact` wait for an index build that is running. Past it, the call answers `{ "status": "index_building" }`
+     * with the build's progress and a retry hint instead of blocking until the client gives up; the build continues,
+     * and a retry waits for what is left of it. Every other tool waits without a limit. Use 0 to wait without a limit
+     * in these eight as well. Defaults to 15 seconds, well below the 30 seconds that MCP clients commonly allow for a
+     * request, because a call also runs its own work once its builds end.
+     */
+    mcpIndexWaitMs?: number;
     onHttpListen?: ((info: CodegraphMcpHttpServerInfo) => void) | undefined;
     runtimeIdentity?: CodegraphRuntimeIdentity;
 };
@@ -271,11 +297,36 @@ type WithAbortSignal<T extends {
 export type CodegraphMcpHandlers = WithAbortSignal<CodegraphMcpHandlerDefinitions> & {
     dispose(): void;
 };
-type WarmedCodegraphMcpResources = {
+export type CodegraphMcpResources = {
     handlers: CodegraphMcpHandlers;
     session: AgentSession;
+    /**
+     * Stops the file watcher and cancels its timers. Safe to call twice; does nothing without a watcher. The promise
+     * settles once a background refresh that was running, and every read of the file list that had started, have ended.
+     * Await it before `session.invalidate()`: until then they keep writing the cache and the session's file signatures.
+     */
+    closeWatcher: () => Promise<void>;
+    /**
+     * Starts the startup warmup in the background, once. A server calls it when its transport is ready to serve, so that
+     * a failed listen or start never begins a build. Without a call, the first tool call that needs the index starts the
+     * build instead.
+     */
+    startWarmup: () => void;
+    /**
+     * Settles when no load that the server started runs, at once when none was started, and never rejects: a warmup
+     * failure is logged. That covers the loads of the startup warmup and of the wait of every budgeted call, including a
+     * call that stopped waiting and a load that ran beside one that failed. Await it, with `closeWatcher`, before
+     * `session.invalidate()`: the loads keep writing the cache until they end.
+     */
+    buildsSettled: () => Promise<void>;
 };
-export declare function createWarmedCodegraphMcpResources(options: CodegraphMcpServerOptions): Promise<WarmedCodegraphMcpResources>;
+/**
+ * Creates the session, its handlers, and the file watcher. It builds nothing: the index builds in the background once
+ * `startWarmup` runs, or at the first tool call that needs it. `search`, `explore`, `orient`, `get_file` with
+ * `includeGraphContext`, `review`, `packet_get`, `workspace_symbols`, and `impact` wait for the loads they read within
+ * `mcpIndexWaitMs`; see `index-readiness.ts`. Every other handler waits for the index without a limit.
+ */
+export declare function createCodegraphMcpResources(options: CodegraphMcpServerOptions): CodegraphMcpResources;
 export declare function createCodegraphMcpHandlers(options: CodegraphMcpHandlerOptions): CodegraphMcpHandlers;
 export {};
 //# sourceMappingURL=handlers.d.ts.map

package/dist/mcp/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"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"}

package/dist/mcp/handlers.js

@@ -17,15 +17,18 @@ import { requireSemanticSymbol, resolveSemanticSymbol } from "../agent/semantic-
 import { getDependencies, getReverseDependencies, getShortestPath } from "../graphs/queries.js";
 import { findReferences, goToDefinition } from "../indexer/navigation.js";
 import { parseQualifiedSymbolPath } from "../indexer/symbols.js";
+import { resolveCacheLocation } from "../indexer/build-cache/location.js";
 import { analyzeImpactFromDiff } from "../impact/index.js";
 import { DEFAULT_BOUNDED_IMPACT_BUDGETS } from "../impact/budgets.js";
 import { buildReviewReport } from "../review.js";
+import { collectReviewChanges } from "../review/changes.js";
 import { boundReviewReportForTransport } from "../review/types.js";
 import { SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY, queryGraphSqliteRaw } from "../sqlite.js";
 import { boundList, countOmitted } from "../presentation/bounds.js";
 import { isPlainRecord } from "../util/guards.js";
 import { toProjectDisplayPath } from "../util/paths.js";
-import { assertNoPrebuiltSessionWithBuildOptions, createAgentSession, listAgentSessionFiles, } from "../agent/session.js";
+import { isMissingPathError } from "../util/errors.js";
+import { assertNoPrebuiltSessionWithBuildOptions, checkSessionFreshness, createAgentSession, listAgentSessionFiles, } from "../agent/session.js";
 import { mapLimit } from "../util/concurrency.js";
 import { assertRealPathCandidateWithinRoot, resolveProjectFile } from "../util/confined-file.js";
 import { SymbolKind } from "../indexer/types.js";
@@ -34,54 +37,181 @@ import { assertMcpSqliteQueryResourceBounded, DEFAULT_SQLITE_BYTE_LIMIT, normali
 import { DEFAULT_CALL_HIERARCHY_LIMIT, MAX_CALL_HIERARCHY_LIMIT, DEFAULT_MCP_COLLECTION_LIMIT, DEFAULT_TYPE_HIERARCHY_LIMIT, MAX_TYPE_HIERARCHY_LIMIT, MAX_MCP_COLLECTION_LIMIT, } from "./tools.js";
 import {} from "../runtime-identity.js";
 import { assertWritableDirectoryRealPathWithinRoot, resolveArtifactSqlitePathCandidate } from "./security.js";
+import { assertMcpWatchMs, createWatchController } from "./project-watcher.js";
+import { assertMcpIndexWait, createMcpBuildProgress, createMcpIndexReadiness, DEFAULT_MCP_INDEX_WAIT_MS, exploreNeeds, searchNeeds, } from "./index-readiness.js";
 const MAX_MCP_FRESHNESS_CHANGED_FILES = 25;
 const MAX_MCP_FRESHNESS_RETRIES = 3;
 const SQLITE_ARTIFACT_STAT_CONCURRENCY = 64;
 function assertMcpSessionOptions(options) {
     assertNoPrebuiltSessionWithBuildOptions(options, "MCP server options");
 }
-function createCodegraphMcpSession(options, root) {
+function createCodegraphMcpSession(options, root, buildProgress) {
     assertMcpSessionOptions(options);
-    return (options.session ??
-        createAgentSession({
-            root,
-            ...(options.buildOptions ? { buildOptions: options.buildOptions } : {}),
-            freshness: { policy: "auto" },
-        }));
+    if (options.session)
+        return options.session;
+    // A session that Codegraph creates reports its builds to `buildProgress` as well as to the caller's own callback, so
+    // that a tool call that outwaits its budget can say what the build is doing.
+    const onProgress = options.buildOptions?.onProgress;
+    const buildOptions = buildProgress
+        ? {
+            ...options.buildOptions,
+            onProgress: (update) => {
+                buildProgress.record(update);
+                onProgress?.(update);
+            },
+        }
+        : options.buildOptions;
+    return createAgentSession({
+        root,
+        ...(buildOptions ? { buildOptions } : {}),
+        freshness: { policy: "auto" },
+    });
 }
-function startCodegraphMcpWarmup(session, warmup, sessionProvidedExplicitly) {
+/**
+ * Where the session writes its disk cache, for the watcher to ignore. A setting that cannot be resolved fails the
+ * session's own first use of the cache with the same error, so the watcher has nothing to ignore until then.
+ */
+function resolveWatchedCacheDirectory(root, buildOptions) {
+    try {
+        return resolveCacheLocation(root, buildOptions).path;
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveStartupWarmupMode(warmup, sessionProvidedExplicitly) {
     // An explicitly supplied session signals the caller already manages its lifecycle (tests,
     // multi-server sharing); only warm it when they ask. A session Codegraph creates itself -
     // the plain `codegraph mcp serve` / library-default path - warms by default so the first
     // real tool call is not the one paying for cold discovery and building.
-    const mode = warmup ?? (sessionProvidedExplicitly ? "off" : "base");
+    return warmup ?? (sessionProvidedExplicitly ? "off" : "base");
+}
+/** What `refresh_index` rebuilds before it answers: nothing, the project index, or also the detailed symbol graph. */
+function rebuildSession(session, mode) {
     if (mode === "off")
         return undefined;
     if (mode === "symbols")
         return session.loadProject();
     return session.loadProject({ symbolGraph: "skip" });
 }
-export async function createWarmedCodegraphMcpResources(options) {
+/**
+ * What the startup warmup loads in the background: the project index, the symbol graph that hybrid searches read, and
+ * the search index; `"symbols"` also the detailed symbol graph.
+ */
+function warmupNeeds(mode) {
+    if (mode === "off")
+        return [];
+    if (mode === "symbols")
+        return ["symbolGraph", "queryIndex", "detailedGraph"];
+    return ["symbolGraph", "queryIndex"];
+}
+/**
+ * Makes `search`, `explore`, `orient`, `workspace_symbols`, `impact`, `get_file` with `includeGraphContext`, and
+ * `packet_get` wait for the session loads they read, within the server's budget, before their handler runs. `review`
+ * waits in its own handler, which asks git first. Every other handler is left as it is and waits for the index without
+ * a limit.
+ */
+function withIndexBudget(handlers, readiness, session) {
+    const budgeted = (tool, handler, needsOf, followUpOf) => async (request, signal) => {
+        const needs = needsOf(request);
+        if (needs)
+            await readiness.waitFor(tool, needs, signal, followUpOf?.(request));
+        return await handler(request, signal);
+    };
+    return {
+        ...handlers,
+        search: budgeted("search", handlers.search, searchNeeds),
+        explore: budgeted("explore", handlers.explore, exploreNeeds),
+        orient: budgeted("orient", handlers.orient, () => ["index"]),
+        workspace_symbols: budgeted("workspace_symbols", handlers.workspace_symbols, () => ["index"]),
+        impact: budgeted("impact", handlers.impact, () => ["index"]),
+        // Only a graph context reads the index; the bytes of a file come from disk.
+        get_file: budgeted("get_file", handlers.get_file, (request) => request.includeGraphContext ? ["index"] : undefined),
+        // A `review:` target builds its own report from git and reads no session build. Any other target reads the detailed
+        // symbol graph, and also the duplicate analysis of its duplicate context, except a SQL object, which has none, and
+        // a target that does not resolve, which fails at once. What the target resolves to is known once the detailed
+        // symbol graph is loaded, so that decision follows it.
+        packet_get: budgeted("packet_get", handlers.packet_get, (request) => (request.target.startsWith("review:") ? [] : ["detailedGraph"]), (request) => request.target.startsWith("review:")
+            ? undefined
+            : async () => {
+                const { kind } = await resolveCodegraphTargetWithSession(session, { target: request.target });
+                return kind === "sql_object" || kind === "not_found" ? [] : ["duplicates"];
+            }),
+    };
+}
+/**
+ * Reports every tool call to the watcher, so its idle timer counts calls and a paused watcher resumes on the
+ * next one. This wraps the handler set instead of `checkMcpFreshness` because tools such as `workspace_symbols`,
+ * `calls`, and `get_file` reach the session's freshness check through their own `*WithSession` helpers.
+ */
+function withToolActivity(handlers, noteActivity) {
+    return new Proxy(handlers, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            if (typeof value !== "function" || property === "dispose")
+                return value;
+            return (...args) => {
+                noteActivity();
+                return Reflect.apply(value, target, args);
+            };
+        },
+    });
+}
+/**
+ * Creates the session, its handlers, and the file watcher. It builds nothing: the index builds in the background once
+ * `startWarmup` runs, or at the first tool call that needs it. `search`, `explore`, `orient`, `get_file` with
+ * `includeGraphContext`, `review`, `packet_get`, `workspace_symbols`, and `impact` wait for the loads they read within
+ * `mcpIndexWaitMs`; see `index-readiness.ts`. Every other handler waits for the index without a limit.
+ */
+export function createCodegraphMcpResources(options) {
     const root = path.resolve(options.root);
     const sessionProvidedExplicitly = options.session !== undefined;
-    const session = createCodegraphMcpSession(options, root);
-    await startCodegraphMcpWarmup(session, options.warmup, sessionProvidedExplicitly);
-    const { warmup, host, port, onHttpListen, ...handlerOptions } = options;
-    void warmup;
+    const { warmup, host, port, onHttpListen, watch, watchDebounceMs, watchMinRefreshIntervalMs, watchIdleMs, mcpIndexWaitMs, ...handlerOptions } = options;
     void host;
     void port;
     void onHttpListen;
+    assertMcpWatchMs("watchDebounceMs", watchDebounceMs);
+    assertMcpWatchMs("watchMinRefreshIntervalMs", watchMinRefreshIntervalMs);
+    assertMcpWatchMs("watchIdleMs", watchIdleMs);
+    const indexWaitMs = assertMcpIndexWait(mcpIndexWaitMs ?? DEFAULT_MCP_INDEX_WAIT_MS);
+    const buildProgress = createMcpBuildProgress();
+    const session = createCodegraphMcpSession(options, root, buildProgress);
+    const readiness = createMcpIndexReadiness(session, {
+        waitMs: indexWaitMs,
+        warmup: warmupNeeds(resolveStartupWarmupMode(warmup, sessionProvidedExplicitly)),
+        progress: buildProgress,
+    });
+    const { handlers, runExclusive } = createCodegraphMcpHandlersForSession({ ...handlerOptions, root }, session, readiness);
+    // Only a session that Codegraph created is watched; a caller that passes its own session manages freshness.
+    // Lazy startup (`warmup: "off"`) stays lazy: the watches open on the first tool call.
+    const watcher = sessionProvidedExplicitly || watch === false
+        ? undefined
+        : createWatchController(session, {
+            root,
+            runExclusive,
+            cacheDirectory: resolveWatchedCacheDirectory(root, options.buildOptions),
+            debounceMs: watchDebounceMs,
+            minRefreshIntervalMs: watchMinRefreshIntervalMs,
+            idleMs: watchIdleMs,
+            startPaused: warmup === "off",
+        });
     return {
-        handlers: createCodegraphMcpHandlersForSession({ ...handlerOptions, root }, session),
+        handlers: watcher ? withToolActivity(handlers, watcher.noteActivity) : handlers,
         session,
+        closeWatcher: () => watcher?.close() ?? Promise.resolve(),
+        startWarmup: readiness.startWarmup,
+        buildsSettled: readiness.buildsSettled,
     };
 }
 export function createCodegraphMcpHandlers(options) {
     const root = path.resolve(options.root);
     const session = createCodegraphMcpSession(options, root);
-    return createCodegraphMcpHandlersForSession(options, session);
+    return createCodegraphMcpHandlersForSession(options, session).handlers;
 }
-function createCodegraphMcpHandlersForSession(options, session) {
+function createCodegraphMcpHandlersForSession(options, session, 
+// The budget of the eight tools that wait within `mcpIndexWaitMs`. Without it the handlers build what they need
+// themselves and wait for as long as that takes.
+readiness) {
     const root = path.resolve(options.root);
     const readOnly = options.readOnly ?? true;
     const realRoot = fs.realpath(root);
@@ -95,6 +225,9 @@ function createCodegraphMcpHandlersForSession(options, session) {
     let sqliteCanRefresh = configuredSqliteCanRefresh;
     let refreshPromise;
     let refreshEpoch = 0;
+    // One turn at a time for everything that rebuilds the session's index or writes artifacts: `refresh_index`,
+    // `artifact_build`, the SQLite rebuild for `query_sqlite`, and the watcher's background refresh. Two of them in
+    // flight would leave the file signatures of whichever build ended last, whatever snapshot the session serves.
     let artifactWritePromise;
     const withArtifactWriteLock = async (operation) => {
         const previous = artifactWritePromise;
@@ -128,17 +261,12 @@ function createCodegraphMcpHandlersForSession(options, session) {
             reason,
         };
     };
-    const checkMcpFreshness = async () => {
-        if (session.checkFreshness)
-            return await session.checkFreshness();
-        return { state: "fresh" };
-    };
     const withFreshness = async (run) => {
         for (let attempt = 0; attempt < MAX_MCP_FRESHNESS_RETRIES; attempt += 1) {
             if (refreshPromise)
                 await refreshPromise;
             const epoch = refreshEpoch;
-            const freshness = await checkMcpFreshness();
+            const freshness = await checkSessionFreshness(session);
             const result = await run();
             if (epoch === refreshEpoch && !refreshPromise)
                 return { ...result, freshness };
@@ -262,7 +390,7 @@ function createCodegraphMcpHandlersForSession(options, session) {
                 signatures.set(relative(file), { path: file, size: stat.size, mtimeMs: stat.mtimeMs });
             }
             catch (error) {
-                if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR")) {
+                if (isMissingPathError(error)) {
                     return;
                 }
                 throw error;
@@ -560,24 +688,36 @@ function createCodegraphMcpHandlersForSession(options, session) {
                 ...DEFAULT_BOUNDED_IMPACT_BUDGETS,
             }));
         }),
-        review: async (request) => await withFreshness(async () => {
-            const report = await buildReviewReport(root, {
+        review: async (request, signal) => {
+            const reviewOptions = {
                 ...options.buildOptions,
                 gitBase: request.base,
                 gitHead: request.head,
                 ...(request.reviewDepth !== undefined ? { reviewDepth: request.reviewDepth } : {}),
-            }, {
-                ...(session.loadProject
-                    ? {
-                        loadIndex: async () => (await session.loadProject({ symbolGraph: "skip" })).index,
-                    }
-                    : {}),
-                ...(session.loadDuplicateAnalysis ? { loadDuplicateAnalysis: session.loadDuplicateAnalysis } : {}),
+            };
+            // The one diff of this call: the report below is built from it. A range without a changed file reads no index,
+            // so git alone answers it, without waiting for a build that runs.
+            const changes = await collectReviewChanges(root, reviewOptions);
+            if (!changes.changedFiles.size) {
+                const report = await buildReviewReport(root, reviewOptions, { changes });
+                return { ...boundReviewReportForTransport(report), freshness: { state: "fresh" } };
+            }
+            await readiness?.waitFor("review", ["index", "duplicates"], signal);
+            return await withFreshness(async () => {
+                const report = await buildReviewReport(root, reviewOptions, {
+                    changes,
+                    ...(session.loadProject
+                        ? {
+                            loadIndex: async () => (await session.loadProject({ symbolGraph: "skip" })).index,
+                        }
+                        : {}),
+                    ...(session.loadDuplicateAnalysis ? { loadDuplicateAnalysis: session.loadDuplicateAnalysis } : {}),
+                });
+                // MCP is a bounded transport (finding #45); library callers that need the
+                // complete, unbounded report should call `buildReviewReport` directly.
+                return boundReviewReportForTransport(report);
             });
-            // MCP is a bounded transport (finding #45); library callers that need the
-            // complete, unbounded report should call `buildReviewReport` directly.
-            return boundReviewReportForTransport(report);
-        }),
+        },
     };
     const artifactHandlers = {
         query_sqlite: async (request, executionOptions) => {
@@ -592,7 +732,7 @@ function createCodegraphMcpHandlersForSession(options, session) {
             let realSqlitePath = await assertRealPathCandidateWithinRoot(await realRoot, sqlitePath, "SQLite artifact");
             let artifactFreshness = await checkSqliteArtifactFreshness(realSqlitePath);
             if (artifactFreshness.state !== "fresh") {
-                const sessionFreshness = await checkMcpFreshness();
+                const sessionFreshness = await checkSessionFreshness(session);
                 // An unchecked (manual) session cannot prove its snapshot matches disk, so rebuilding
                 // the artifact from it is as unsafe as rebuilding from a known-stale one.
                 if (sessionFreshness.state === "stale" || sessionFreshness.state === "unchecked") {
@@ -619,7 +759,7 @@ function createCodegraphMcpHandlersForSession(options, session) {
                 sqlitePath = configuredSqlitePath;
                 sqliteOutDir = configuredSqliteOutDir;
                 sqliteCanRefresh = configuredSqliteCanRefresh;
-                await startCodegraphMcpWarmup(session, warmup, true);
+                await rebuildSession(session, warmup);
             })();
             refreshPromise = refresh;
             try {
@@ -635,7 +775,7 @@ function createCodegraphMcpHandlersForSession(options, session) {
             if (readOnly) {
                 throw new Error("artifact_build is disabled in read-only MCP mode.");
             }
-            const freshness = await checkMcpFreshness();
+            const freshness = await checkSessionFreshness(session);
             if (freshness.state === "stale") {
                 const changed = freshness.changedFiles.length ? ` Changed files: ${freshness.changedFiles.join(", ")}.` : "";
                 const omitted = freshness.omittedChangedFileCount
@@ -669,11 +809,15 @@ function createCodegraphMcpHandlersForSession(options, session) {
                 session.invalidate();
         },
     };
-    return {
+    const handlers = {
         ...searchHandlers,
         ...navigationHandlers,
         ...reviewHandlers,
         ...artifactHandlers,
     };
+    return {
+        handlers: readiness ? withIndexBudget(handlers, readiness, session) : handlers,
+        runExclusive: withArtifactWriteLock,
+    };
 }
 //# sourceMappingURL=handlers.js.map