optave-codegraph 3.13.0

package/dist/infrastructure/registry.js.map

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

package/dist/infrastructure/result-formatter.d.ts

@@ -0,0 +1,2 @@
+export { outputResult } from '../presentation/result-formatter.js';
+//# sourceMappingURL=result-formatter.d.ts.map

package/dist/infrastructure/result-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/result-formatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/infrastructure/result-formatter.js

@@ -0,0 +1,3 @@
+// Re-export from presentation layer — this file exists for backward compatibility.
+export { outputResult } from '../presentation/result-formatter.js';
+//# sourceMappingURL=result-formatter.js.map

package/dist/infrastructure/result-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.js","sourceRoot":"","sources":["../../src/infrastructure/result-formatter.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/infrastructure/suppress.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Catch-suppression helpers for intentional error swallowing.
+ *
+ * Lives in `infrastructure/` (not `shared/`) because it depends on the
+ * structured logger — keeping `shared/errors.ts` dependency-free.
+ */
+/**
+ * Run `fn` and return its result. If it throws, log a debug message and
+ * return `fallback` instead. Use this for intentional catch suppression
+ * where the error is expected and non-fatal (e.g. optional file reads,
+ * graceful feature probes, cleanup that may fail).
+ *
+ * @example
+ *   const version = suppressError(() => readPkgVersion(), 'read package version', '');
+ */
+export declare function suppressError<T>(fn: () => T, context: string, fallback: T): T;
+/**
+ * Async variant of {@link suppressError}. Awaits `fn()` and returns `fallback`
+ * on rejection, logging the error via `debug()`.
+ *
+ * @example
+ *   const data = await suppressErrorAsync(() => fetchOptionalData(), 'fetch data', null);
+ */
+export declare function suppressErrorAsync<T>(fn: () => Promise<T>, context: string, fallback: T): Promise<T>;
+//# sourceMappingURL=suppress.d.ts.map

package/dist/infrastructure/suppress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppress.d.ts","sourceRoot":"","sources":["../../src/infrastructure/suppress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAO7E;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/infrastructure/suppress.js

@@ -0,0 +1,43 @@
+/**
+ * Catch-suppression helpers for intentional error swallowing.
+ *
+ * Lives in `infrastructure/` (not `shared/`) because it depends on the
+ * structured logger — keeping `shared/errors.ts` dependency-free.
+ */
+import { toErrorMessage } from '../shared/errors.js';
+import { debug } from './logger.js';
+/**
+ * Run `fn` and return its result. If it throws, log a debug message and
+ * return `fallback` instead. Use this for intentional catch suppression
+ * where the error is expected and non-fatal (e.g. optional file reads,
+ * graceful feature probes, cleanup that may fail).
+ *
+ * @example
+ *   const version = suppressError(() => readPkgVersion(), 'read package version', '');
+ */
+export function suppressError(fn, context, fallback) {
+    try {
+        return fn();
+    }
+    catch (e) {
+        debug(`${context}: ${toErrorMessage(e)}`);
+        return fallback;
+    }
+}
+/**
+ * Async variant of {@link suppressError}. Awaits `fn()` and returns `fallback`
+ * on rejection, logging the error via `debug()`.
+ *
+ * @example
+ *   const data = await suppressErrorAsync(() => fetchOptionalData(), 'fetch data', null);
+ */
+export async function suppressErrorAsync(fn, context, fallback) {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        debug(`${context}: ${toErrorMessage(e)}`);
+        return fallback;
+    }
+}
+//# sourceMappingURL=suppress.js.map

package/dist/infrastructure/suppress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppress.js","sourceRoot":"","sources":["../../src/infrastructure/suppress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAI,EAAW,EAAE,OAAe,EAAE,QAAW;IACxE,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAoB,EACpB,OAAe,EACf,QAAW;IAEX,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/infrastructure/test-filter.d.ts

@@ -0,0 +1,5 @@
+/** Pattern matching test/spec/stories files. */
+export declare const TEST_PATTERN: RegExp;
+/** Check whether a file path looks like a test file. */
+export declare function isTestFile(filePath: string): boolean;
+//# sourceMappingURL=test-filter.d.ts.map

package/dist/infrastructure/test-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-filter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/test-filter.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,YAAY,QAAmD,CAAC;AAE7E,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/infrastructure/test-filter.js

@@ -0,0 +1,7 @@
+/** Pattern matching test/spec/stories files. */
+export const TEST_PATTERN = /\.(test|spec)\.|__test__|__tests__|\.stories\./;
+/** Check whether a file path looks like a test file. */
+export function isTestFile(filePath) {
+    return TEST_PATTERN.test(filePath);
+}
+//# sourceMappingURL=test-filter.js.map

package/dist/infrastructure/test-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-filter.js","sourceRoot":"","sources":["../../src/infrastructure/test-filter.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,gDAAgD,CAAC;AAE7E,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/infrastructure/update-check.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Minimal semver comparison. Returns -1, 0, or 1.
+ * Strips pre-release suffixes (e.g. "3.9.3-dev.6" → "3.9.3") before comparing.
+ */
+export declare function semverCompare(a: string, b: string): -1 | 0 | 1;
+interface UpdateResult {
+    current: string;
+    latest: string;
+}
+interface CheckForUpdatesOptions {
+    cachePath?: string;
+    _fetchLatest?: () => Promise<string | null>;
+}
+/**
+ * Check whether a newer version of codegraph is available.
+ *
+ * Returns `{ current, latest }` if an update is available, `null` otherwise.
+ * Silently returns null on any error — never affects CLI operation.
+ */
+export declare function checkForUpdates(currentVersion: string, options?: CheckForUpdatesOptions): Promise<UpdateResult | null>;
+/**
+ * Print a visible update notification box to stderr.
+ */
+export declare function printUpdateNotification(current: string, latest: string): void;
+export {};
+//# sourceMappingURL=update-check.d.ts.map

package/dist/infrastructure/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/infrastructure/update-check.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAU9D;AA+ED,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,sBAAsB;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7C;AA4BD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqB9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAa7E"}

package/dist/infrastructure/update-check.js

@@ -0,0 +1,164 @@
+import fs from 'node:fs';
+import https from 'node:https';
+import os from 'node:os';
+import path from 'node:path';
+const CACHE_PATH = process.env.CODEGRAPH_UPDATE_CACHE_PATH ||
+    path.join(os.homedir(), '.codegraph', 'update-check.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const FETCH_TIMEOUT_MS = 3000;
+const REGISTRY_URL = 'https://registry.npmjs.org/optave-codegraph/latest';
+/**
+ * Minimal semver comparison. Returns -1, 0, or 1.
+ * Strips pre-release suffixes (e.g. "3.9.3-dev.6" → "3.9.3") before comparing.
+ */
+export function semverCompare(a, b) {
+    const pa = a.replace(/-.*$/, '').split('.').map(Number);
+    const pb = b.replace(/-.*$/, '').split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const na = pa[i] || 0;
+        const nb = pb[i] || 0;
+        if (na < nb)
+            return -1;
+        if (na > nb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Load the cached update-check result from disk.
+ * Returns null on missing or corrupt file.
+ */
+function loadCache(cachePath = CACHE_PATH) {
+    try {
+        const raw = fs.readFileSync(cachePath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (!data || typeof data.lastCheckedAt !== 'number' || typeof data.latestVersion !== 'string') {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the cache to disk (atomic write via temp + rename).
+ */
+function saveCache(cache, cachePath = CACHE_PATH) {
+    const dir = path.dirname(cachePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const tmp = `${cachePath}.tmp.${process.pid}`;
+    fs.writeFileSync(tmp, JSON.stringify(cache), 'utf-8');
+    fs.renameSync(tmp, cachePath);
+}
+/**
+ * Collect the full response body from an IncomingMessage stream.
+ * Resolves with the body string, or null on parse/status error.
+ */
+function collectResponseBody(res) {
+    return new Promise((resolve) => {
+        if (res.statusCode !== 200) {
+            res.resume();
+            resolve(null);
+            return;
+        }
+        let body = '';
+        res.setEncoding('utf-8');
+        res.on('data', (chunk) => {
+            body += chunk;
+        });
+        res.on('end', () => {
+            try {
+                const data = JSON.parse(body);
+                resolve(typeof data.version === 'string' ? data.version : null);
+            }
+            catch {
+                resolve(null);
+            }
+        });
+    });
+}
+/**
+ * Fetch the latest version string from the npm registry.
+ * Returns the version string or null on failure.
+ */
+function fetchLatestVersion() {
+    return new Promise((resolve) => {
+        const req = https.get(REGISTRY_URL, { timeout: FETCH_TIMEOUT_MS, headers: { Accept: 'application/json' } }, (res) => {
+            collectResponseBody(res).then(resolve);
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(null);
+        });
+    });
+}
+/**
+ * Return the latest version from cache if fresh, or fetch it from the registry.
+ * Persists the fetched version to the cache only when a network fetch occurs
+ * (i.e. the cache is stale or missing). Returns the cached value directly
+ * without updating the cache when the cache is still within `CACHE_TTL_MS`.
+ * Returns null when the network fetch fails or the cache is corrupt.
+ */
+async function resolveLatestVersion(cachePath, fetchFn) {
+    const cache = loadCache(cachePath);
+    if (cache && Date.now() - cache.lastCheckedAt < CACHE_TTL_MS) {
+        // Cache is fresh — use stored value directly
+        return cache.latestVersion;
+    }
+    // Cache is stale or missing — fetch from registry
+    const latest = await fetchFn();
+    if (!latest)
+        return null;
+    saveCache({ lastCheckedAt: Date.now(), latestVersion: latest }, cachePath);
+    return latest;
+}
+/**
+ * Check whether a newer version of codegraph is available.
+ *
+ * Returns `{ current, latest }` if an update is available, `null` otherwise.
+ * Silently returns null on any error — never affects CLI operation.
+ */
+export async function checkForUpdates(currentVersion, options = {}) {
+    // Suppress in non-interactive / CI contexts
+    if (process.env.CI)
+        return null;
+    if (process.env.NO_UPDATE_CHECK)
+        return null;
+    if (!process.stderr.isTTY)
+        return null;
+    if (currentVersion.includes('-'))
+        return null;
+    const cachePath = options.cachePath || CACHE_PATH;
+    const fetchFn = options._fetchLatest || fetchLatestVersion;
+    try {
+        const latest = await resolveLatestVersion(cachePath, fetchFn);
+        if (!latest)
+            return null;
+        if (semverCompare(currentVersion, latest) < 0) {
+            return { current: currentVersion, latest };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Print a visible update notification box to stderr.
+ */
+export function printUpdateNotification(current, latest) {
+    const msg1 = `Update available: ${current} → ${latest}`;
+    const msg2 = 'Run `npm i -g optave-codegraph` to update';
+    const width = Math.max(msg1.length, msg2.length) + 4;
+    const top = `┌${'─'.repeat(width)}┐`;
+    const bot = `└${'─'.repeat(width)}┘`;
+    const pad1 = ' '.repeat(width - msg1.length - 2);
+    const pad2 = ' '.repeat(width - msg2.length - 2);
+    const line1 = `│  ${msg1}${pad1}│`;
+    const line2 = `│  ${msg2}${pad2}│`;
+    process.stderr.write(`\n${top}\n${line1}\n${line2}\n${bot}\n\n`);
+}
+//# sourceMappingURL=update-check.js.map

package/dist/infrastructure/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/infrastructure/update-check.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export { startMCPServer } from './server.js';
+export { buildToolList, TOOLS } from './tool-registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,3 @@
+export { startMCPServer } from './server.js';
+export { buildToolList, TOOLS } from './tool-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/middleware.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP middleware helpers — pagination defaults and limits.
+ */
+import { MCP_DEFAULTS, MCP_MAX_LIMIT } from '../shared/paginate.js';
+export { MCP_DEFAULTS, MCP_MAX_LIMIT };
+/**
+ * Initialize MCP defaults from config. Call once at server startup.
+ */
+export declare function initMcpDefaults(configMcpDefaults?: Record<string, number>): void;
+/**
+ * Reset MCP defaults back to the base defaults. Useful for test isolation.
+ */
+export declare function resetMcpDefaults(): void;
+/**
+ * Resolve effective limit for a tool call.
+ */
+export declare function effectiveLimit(args: {
+    limit?: number;
+}, toolName: string): number;
+/**
+ * Resolve effective offset for a tool call.
+ */
+export declare function effectiveOffset(args: {
+    offset?: number;
+}): number;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/mcp/middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAkB,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAKvC;;GAEG;AACH,wBAAgB,eAAe,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEjE"}

package/dist/mcp/middleware.js

@@ -0,0 +1,32 @@
+/**
+ * MCP middleware helpers — pagination defaults and limits.
+ */
+import { getMcpDefaults, MCP_DEFAULTS, MCP_MAX_LIMIT } from '../shared/paginate.js';
+export { MCP_DEFAULTS, MCP_MAX_LIMIT };
+/** Resolved MCP defaults (may include config overrides). Set via initMcpDefaults(). */
+let resolvedDefaults = MCP_DEFAULTS;
+/**
+ * Initialize MCP defaults from config. Call once at server startup.
+ */
+export function initMcpDefaults(configMcpDefaults) {
+    resolvedDefaults = getMcpDefaults(configMcpDefaults);
+}
+/**
+ * Reset MCP defaults back to the base defaults. Useful for test isolation.
+ */
+export function resetMcpDefaults() {
+    resolvedDefaults = MCP_DEFAULTS;
+}
+/**
+ * Resolve effective limit for a tool call.
+ */
+export function effectiveLimit(args, toolName) {
+    return Math.min(args.limit ?? resolvedDefaults[toolName] ?? 100, MCP_MAX_LIMIT);
+}
+/**
+ * Resolve effective offset for a tool call.
+ */
+export function effectiveOffset(args) {
+    return args.offset ?? 0;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/mcp/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/mcp/middleware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAEvC,uFAAuF;AACvF,IAAI,gBAAgB,GAA2B,YAAY,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,iBAA0C;IACxE,gBAAgB,GAAG,cAAc,CAAC,iBAAiB,CAA2B,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,gBAAgB,GAAG,YAAY,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB,EAAE,QAAgB;IACvE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,aAAa,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP (Model Context Protocol) server for codegraph.
+ * Exposes codegraph queries as tools that AI coding assistants can call.
+ *
+ * Requires: npm install @modelcontextprotocol/sdk
+ */
+import type { CodegraphConfig, MCPServerOptions } from '../types.js';
+import type { McpToolContext } from './types.js';
+export type { McpToolContext };
+interface MCPServerOptionsInternal extends MCPServerOptions {
+    config?: CodegraphConfig;
+}
+export declare function startMCPServer(customDbPath?: string, options?: MCPServerOptionsInternal): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,UAAU,wBAAyB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAoKD,wBAAsB,cAAc,CAClC,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/mcp/server.js

@@ -0,0 +1,193 @@
+/**
+ * MCP (Model Context Protocol) server for codegraph.
+ * Exposes codegraph queries as tools that AI coding assistants can call.
+ *
+ * Requires: npm install @modelcontextprotocol/sdk
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require('../../package.json');
+import { getDatabase } from '../db/better-sqlite3.js';
+import { findDbPath } from '../db/index.js';
+import { loadConfig } from '../infrastructure/config.js';
+import { debug } from '../infrastructure/logger.js';
+import { CodegraphError, ConfigError, toErrorMessage } from '../shared/errors.js';
+import { MCP_MAX_LIMIT } from '../shared/paginate.js';
+import { initMcpDefaults } from './middleware.js';
+import { buildToolList } from './tool-registry.js';
+import { TOOL_HANDLERS } from './tools/index.js';
+/**
+ * Module-level guard to register shutdown handlers only once per process.
+ * Because tests use vi.resetModules(), this module-level variable resets
+ * on each re-import — but the process-level flag on `process` persists.
+ */
+let _activeServer = null;
+async function loadMCPSdk() {
+    try {
+        const sdk = await import('@modelcontextprotocol/sdk/server/index.js');
+        const transport = await import('@modelcontextprotocol/sdk/server/stdio.js');
+        const types = await import('@modelcontextprotocol/sdk/types.js');
+        return {
+            Server: sdk.Server,
+            StdioServerTransport: transport.StdioServerTransport,
+            ListToolsRequestSchema: types.ListToolsRequestSchema,
+            CallToolRequestSchema: types.CallToolRequestSchema,
+        };
+    }
+    catch (e) {
+        debug(`MCP SDK import failed: ${toErrorMessage(e)}`);
+        throw new ConfigError('MCP server requires @modelcontextprotocol/sdk.\nInstall it with: npm install @modelcontextprotocol/sdk');
+    }
+}
+function createLazyLoaders() {
+    let _queries;
+    return {
+        async getQueries() {
+            if (!_queries)
+                _queries = await import('../domain/queries.js');
+            return _queries;
+        },
+    };
+}
+async function resolveDbPath(customDbPath, args, allowedRepos) {
+    let dbPath = customDbPath || undefined;
+    if (args.repo) {
+        if (allowedRepos && !allowedRepos.includes(args.repo)) {
+            throw new ConfigError(`Repository "${args.repo}" is not in the allowed repos list.`);
+        }
+        const { resolveRepoDbPath } = await import('../infrastructure/registry.js');
+        const resolved = resolveRepoDbPath(args.repo);
+        if (!resolved)
+            throw new ConfigError(`Repository "${args.repo}" not found in registry or its database is missing.`);
+        dbPath = resolved;
+    }
+    return dbPath;
+}
+function validateMultiRepoAccess(multiRepo, args) {
+    if (!multiRepo && args.repo) {
+        throw new ConfigError('Multi-repo access is disabled. Restart with `codegraph mcp --multi-repo` to access other repositories.');
+    }
+    // Note: the `list_repos` tool is excluded from `enabledToolNames` when
+    // `multiRepo` is false (see `buildToolList`), so any call to it is rejected
+    // earlier in `createCallToolHandler` with an "Unknown tool" error.
+}
+/**
+ * Register process-level shutdown and error handlers once per process.
+ * Ensures graceful cleanup when the MCP client disconnects or the transport
+ * encounters broken-pipe errors. Uses a globalThis flag to survive
+ * vi.resetModules() in tests.
+ */
+function registerShutdownHandlers() {
+    const g = globalThis;
+    if (g.__codegraph_shutdown_installed)
+        return;
+    g.__codegraph_shutdown_installed = true;
+    const shutdown = async () => {
+        try {
+            await _activeServer?.close();
+        }
+        catch (shutdownErr) {
+            debug(`MCP shutdown close failed (transport may already be gone): ${toErrorMessage(shutdownErr)}`);
+        }
+        process.exit(0);
+    };
+    const silentExit = (err) => {
+        // Only suppress broken-pipe errors from closed stdio transport;
+        // let real bugs surface with a non-zero exit code.
+        if (err.code === 'EPIPE' || err.code === 'ERR_STREAM_DESTROYED') {
+            process.exit(0);
+        }
+        process.stderr.write(`Uncaught exception: ${err.stack ?? err.message}\n`);
+        process.exit(1);
+    };
+    const silentReject = (reason) => {
+        const err = reason instanceof Error ? reason : new Error(String(reason));
+        const code = err.code;
+        if (code === 'EPIPE' || code === 'ERR_STREAM_DESTROYED') {
+            process.exit(0);
+        }
+        process.stderr.write(`Unhandled rejection: ${err.stack ?? err.message}\n`);
+        process.exit(1);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    process.on('SIGHUP', shutdown);
+    process.on('uncaughtException', silentExit);
+    process.on('unhandledRejection', silentReject);
+}
+function createCallToolHandler(multiRepo, customDbPath, allowedRepos, getQueries, enabledToolNames) {
+    return async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            if (!enabledToolNames.has(name)) {
+                return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+            }
+            validateMultiRepoAccess(multiRepo, args);
+            const dbPath = await resolveDbPath(customDbPath, args, allowedRepos);
+            const toolEntry = TOOL_HANDLERS.get(name);
+            if (!toolEntry) {
+                return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+            }
+            const ctx = {
+                dbPath: dbPath,
+                getQueries,
+                getDatabase,
+                findDbPath,
+                allowedRepos,
+                MCP_MAX_LIMIT,
+            };
+            const result = await toolEntry.handler(args, ctx);
+            if (result && typeof result === 'object' && 'content' in result) {
+                return result;
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            const code = err instanceof CodegraphError ? err.code : 'UNKNOWN_ERROR';
+            const text = err instanceof CodegraphError
+                ? `[${code}] ${err.message}`
+                : `Error: ${toErrorMessage(err)}`;
+            return { content: [{ type: 'text', text }], isError: true };
+        }
+    };
+}
+export async function startMCPServer(customDbPath, options = {}) {
+    const { allowedRepos } = options;
+    const multiRepo = options.multiRepo || !!allowedRepos;
+    // Apply config-based MCP page-size overrides
+    const config = options.config || loadConfig();
+    initMcpDefaults(config.mcp?.defaults ? { ...config.mcp.defaults } : undefined);
+    const disabledTools = [...(config.mcp?.disabledTools ?? [])];
+    const enabledTools = buildToolList(multiRepo, disabledTools);
+    const enabledToolNames = new Set(enabledTools.map((tool) => tool.name));
+    const { Server, StdioServerTransport, ListToolsRequestSchema, CallToolRequestSchema } = await loadMCPSdk();
+    // Connect transport FIRST so the server can receive the client's
+    // `initialize` request while heavy modules (queries, better-sqlite3)
+    // are still loading.  These are lazy-loaded on the first tool call
+    // and cached for subsequent calls.
+    const { getQueries } = createLazyLoaders();
+    const server = new Server({ name: 'codegraph', version: PKG_VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: enabledTools,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, createCallToolHandler(multiRepo, customDbPath, allowedRepos, getQueries, enabledToolNames));
+    const transport = new StdioServerTransport();
+    // Graceful shutdown — when the client disconnects (e.g. session clear),
+    // close the server cleanly so the process exits without error.
+    // Track the active server at module level so handlers always reference
+    // the latest instance (matters when tests call startMCPServer repeatedly).
+    _activeServer = server;
+    registerShutdownHandlers();
+    try {
+        await server.connect(transport);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'EPIPE' || code === 'ERR_STREAM_DESTROYED') {
+            process.exit(0);
+        }
+        process.stderr.write(`MCP transport connect failed: ${err instanceof Error ? (err.stack ?? err.message) : toErrorMessage(err)}\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=server.js.map