@colbymchenry/codegraph 0.8.0 → 0.9.1

package/dist/installer/targets/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;KAChF,CAAC,CAAC;IACH;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IAC1D;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,oEAAoE;IACpE,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAAC;IACvC;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,IAAI,WAAW,CAAC;CACrC"}

package/dist/installer/targets/types.js

@@ -1,16 +0,0 @@
-"use strict";
-/**
- * Agent target abstraction for the installer.
- *
- * Each MCP-capable agent (Claude Code, Cursor, Codex CLI, opencode, ...)
- * implements this interface so the installer orchestrator can write the
- * right MCP-server config + instructions file + permissions for that
- * agent without baking client-specific paths into core code. Adding a
- * new agent = one new file in `targets/` + one entry in `registry.ts`.
- *
- * Closes the Claude-locked installer issue (upstream #137). The
- * runtime MCP server is already agent-agnostic; this brings the
- * installer to the same surface.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/installer/targets/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG"}

package/dist/mcp/index.d.ts

@@ -1,94 +0,0 @@
-/**
- * CodeGraph MCP Server
- *
- * Model Context Protocol server that exposes CodeGraph functionality
- * as tools for AI assistants like Claude.
- *
- * @module mcp
- *
- * @example
- * ```typescript
- * import { MCPServer } from 'codegraph';
- *
- * const server = new MCPServer('/path/to/project');
- * await server.start();
- * ```
- */
-/**
- * MCP Server for CodeGraph
- *
- * Implements the Model Context Protocol to expose CodeGraph
- * functionality as tools that can be called by AI assistants.
- */
-export declare class MCPServer {
-    private transport;
-    private cg;
-    private toolHandler;
-    private projectPath;
-    private initPromise;
-    private clientSupportsRoots;
-    private rootsAttempted;
-    constructor(projectPath?: string);
-    /**
-     * Start the MCP server
-     *
-     * Note: CodeGraph initialization is deferred until the initialize request
-     * is received, which includes the rootUri from the client.
-     */
-    start(): Promise<void>;
-    /**
-     * Try to initialize CodeGraph for the default project.
-     *
-     * Walks up parent directories to find the nearest .codegraph/ folder,
-     * similar to how git finds .git/ directories.
-     *
-     * If initialization fails, the error is recorded but the server continues
-     * to work — cross-project queries and retries on subsequent tool calls
-     * are still possible.
-     */
-    private tryInitializeDefault;
-    /**
-     * Retry initialization of the default project if it previously failed.
-     * Called lazily on tool calls that need the default project.
-     * Re-walks parent directories each time so it picks up projects
-     * initialized after the MCP server started.
-     *
-     * Awaits any in-flight background init (kicked off by handleInitialize) so
-     * we never open the SQLite file twice concurrently.
-     */
-    private retryInitIfNeeded;
-    /**
-     * Resolve the project root via the MCP `roots/list` request and initialize
-     * from the first root the client reports. Falls back to the process cwd if
-     * the client returns no usable root or doesn't answer in time. See issue #196.
-     */
-    private initFromRoots;
-    /**
-     * Start file watching on the active CodeGraph instance.
-     * Logs sync activity to stderr for diagnostics.
-     */
-    private startWatching;
-    /**
-     * Stop the server
-     */
-    stop(): void;
-    /**
-     * Handle incoming JSON-RPC messages
-     */
-    private handleMessage;
-    /**
-     * Handle initialize request
-     */
-    private handleInitialize;
-    /**
-     * Handle tools/list request
-     */
-    private handleToolsList;
-    /**
-     * Handle tools/call request
-     */
-    private handleToolsCall;
-}
-export { StdioTransport } from './transport';
-export { tools, ToolHandler } from './tools';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6DH;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAgB;IAGnC,OAAO,CAAC,WAAW,CAA8B;IAIjD,OAAO,CAAC,mBAAmB,CAAS;IAGpC,OAAO,CAAC,cAAc,CAAS;gBAEnB,WAAW,CAAC,EAAE,MAAM;IAOhC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;;;;;;;;OASG;YACW,oBAAoB;IAyBlC;;;;;;;;OAQG;YACW,iBAAiB;IA+C/B;;;;OAIG;YACW,aAAa;IAiB3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAsCrB;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;YACW,aAAa;IA6C3B;;OAEG;YACW,gBAAgB;IA6D9B;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,eAAe;CAqC9B;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/mcp/index.js

@@ -1,453 +0,0 @@
-"use strict";
-/**
- * CodeGraph MCP Server
- *
- * Model Context Protocol server that exposes CodeGraph functionality
- * as tools for AI assistants like Claude.
- *
- * @module mcp
- *
- * @example
- * ```typescript
- * import { MCPServer } from 'codegraph';
- *
- * const server = new MCPServer('/path/to/project');
- * await server.start();
- * ```
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolHandler = exports.tools = exports.StdioTransport = exports.MCPServer = void 0;
-const path = __importStar(require("path"));
-const index_1 = __importStar(require("../index"));
-const sync_1 = require("../sync");
-const transport_1 = require("./transport");
-const tools_1 = require("./tools");
-const server_instructions_1 = require("./server-instructions");
-/**
- * Convert a file:// URI to a filesystem path.
- * Handles URL encoding and Windows drive letter paths.
- */
-function fileUriToPath(uri) {
-    try {
-        const url = new URL(uri);
-        let filePath = decodeURIComponent(url.pathname);
-        // On Windows, file:///C:/path produces pathname /C:/path — strip leading /
-        if (process.platform === 'win32' && /^\/[a-zA-Z]:/.test(filePath)) {
-            filePath = filePath.slice(1);
-        }
-        return path.resolve(filePath);
-    }
-    catch {
-        // Fallback for non-standard URIs
-        return uri.replace(/^file:\/\/\/?/, '');
-    }
-}
-/**
- * MCP Server Info
- */
-const SERVER_INFO = {
-    name: 'codegraph',
-    version: '0.1.0',
-};
-/**
- * MCP Protocol Version
- */
-const PROTOCOL_VERSION = '2024-11-05';
-/**
- * How long to wait for the client's `roots/list` response before giving up
- * and falling back to the process cwd.
- */
-const ROOTS_LIST_TIMEOUT_MS = 5000;
-/**
- * Extract the first usable filesystem path from a `roots/list` result.
- * Shape per MCP spec: `{ roots: [{ uri: "file:///path", name?: string }] }`.
- * Returns null if the result is empty or malformed.
- */
-function firstRootPath(result) {
-    if (!result || typeof result !== 'object')
-        return null;
-    const roots = result.roots;
-    if (!Array.isArray(roots) || roots.length === 0)
-        return null;
-    const first = roots[0];
-    if (typeof first?.uri !== 'string')
-        return null;
-    return fileUriToPath(first.uri);
-}
-/**
- * MCP Server for CodeGraph
- *
- * Implements the Model Context Protocol to expose CodeGraph
- * functionality as tools that can be called by AI assistants.
- */
-class MCPServer {
-    transport;
-    cg = null;
-    toolHandler;
-    projectPath;
-    // In-flight background init kicked off from handleInitialize. Tracked so the
-    // sync retry path doesn't race against it (double-opening the SQLite file).
-    initPromise = null;
-    // Whether the client advertised the MCP `roots` capability during initialize.
-    // If so, and no explicit project path was given, we ask it for the workspace
-    // root via roots/list rather than guessing from the (often wrong) cwd.
-    clientSupportsRoots = false;
-    // Guards the one-shot deferred resolution (roots/list or cwd) so we don't
-    // re-issue roots/list on every tool call.
-    rootsAttempted = false;
-    constructor(projectPath) {
-        this.projectPath = projectPath || null;
-        this.transport = new transport_1.StdioTransport();
-        // Create ToolHandler eagerly — cross-project queries work even without a default project
-        this.toolHandler = new tools_1.ToolHandler(null);
-    }
-    /**
-     * Start the MCP server
-     *
-     * Note: CodeGraph initialization is deferred until the initialize request
-     * is received, which includes the rootUri from the client.
-     */
-    async start() {
-        // Start listening for messages immediately - don't check initialization yet
-        // We'll get the project path from the initialize request's rootUri
-        this.transport.start(this.handleMessage.bind(this));
-        // Keep the process running
-        process.on('SIGINT', () => this.stop());
-        process.on('SIGTERM', () => this.stop());
-        // When the parent process (Claude Code) exits, stdin closes.
-        // Detect this and shut down gracefully to prevent orphaned processes.
-        process.stdin.on('end', () => this.stop());
-        process.stdin.on('close', () => this.stop());
-    }
-    /**
-     * Try to initialize CodeGraph for the default project.
-     *
-     * Walks up parent directories to find the nearest .codegraph/ folder,
-     * similar to how git finds .git/ directories.
-     *
-     * If initialization fails, the error is recorded but the server continues
-     * to work — cross-project queries and retries on subsequent tool calls
-     * are still possible.
-     */
-    async tryInitializeDefault(projectPath) {
-        // Record where we searched so a later "not initialized" error can name it.
-        this.toolHandler.setDefaultProjectHint(projectPath);
-        // Walk up parent directories to find nearest .codegraph/
-        const resolvedRoot = (0, index_1.findNearestCodeGraphRoot)(projectPath);
-        if (!resolvedRoot) {
-            this.projectPath = projectPath;
-            return;
-        }
-        this.projectPath = resolvedRoot;
-        try {
-            this.cg = await index_1.default.open(resolvedRoot);
-            this.toolHandler.setDefaultCodeGraph(this.cg);
-            this.startWatching();
-        }
-        catch (err) {
-            // Log the error so transient failures are diagnosable (see issue #47)
-            const msg = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`[CodeGraph MCP] Failed to open project at ${resolvedRoot}: ${msg}\n`);
-        }
-    }
-    /**
-     * Retry initialization of the default project if it previously failed.
-     * Called lazily on tool calls that need the default project.
-     * Re-walks parent directories each time so it picks up projects
-     * initialized after the MCP server started.
-     *
-     * Awaits any in-flight background init (kicked off by handleInitialize) so
-     * we never open the SQLite file twice concurrently.
-     */
-    async retryInitIfNeeded() {
-        // Wait for the background init started during handleInitialize, if any.
-        if (this.initPromise) {
-            try {
-                await this.initPromise;
-            }
-            catch { /* errored init falls through to retry */ }
-        }
-        // Already initialized successfully
-        if (this.toolHandler.hasDefaultCodeGraph())
-            return;
-        // No explicit path was given at initialize. Resolve it now, exactly once:
-        // ask the client via roots/list (if it advertised roots), else use cwd.
-        // Deferring to here lets a roots answer override the wrong cwd, and the
-        // one-shot guard means we never re-issue roots/list per tool call.
-        if (!this.projectPath && !this.rootsAttempted) {
-            this.rootsAttempted = true;
-            this.initPromise = (this.clientSupportsRoots
-                ? this.initFromRoots()
-                : this.tryInitializeDefault(process.cwd())).finally(() => { this.initPromise = null; });
-            try {
-                await this.initPromise;
-            }
-            catch { /* fall through to last-resort below */ }
-            if (this.toolHandler.hasDefaultCodeGraph())
-                return;
-        }
-        // Last resort: re-walk from the best candidate we have. Picks up projects
-        // initialized after the server started, and covers clients that sent no
-        // usable initialize signal at all.
-        const candidate = this.projectPath ?? process.cwd();
-        this.toolHandler.setDefaultProjectHint(candidate);
-        const resolvedRoot = (0, index_1.findNearestCodeGraphRoot)(candidate);
-        if (!resolvedRoot)
-            return;
-        try {
-            // Close any previously failed instance to avoid leaking resources
-            if (this.cg) {
-                try {
-                    this.cg.close();
-                }
-                catch { /* ignore */ }
-                this.cg = null;
-            }
-            this.cg = index_1.default.openSync(resolvedRoot);
-            this.projectPath = resolvedRoot;
-            this.toolHandler.setDefaultCodeGraph(this.cg);
-            this.startWatching();
-        }
-        catch {
-            // Still failing — will retry on next tool call
-        }
-    }
-    /**
-     * Resolve the project root via the MCP `roots/list` request and initialize
-     * from the first root the client reports. Falls back to the process cwd if
-     * the client returns no usable root or doesn't answer in time. See issue #196.
-     */
-    async initFromRoots() {
-        let target = process.cwd();
-        try {
-            const result = await this.transport.request('roots/list', undefined, ROOTS_LIST_TIMEOUT_MS);
-            const rootPath = firstRootPath(result);
-            if (rootPath) {
-                target = rootPath;
-            }
-            else {
-                process.stderr.write('[CodeGraph MCP] Client returned no workspace roots; falling back to process cwd.\n');
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`[CodeGraph MCP] roots/list request failed (${msg}); falling back to process cwd.\n`);
-        }
-        await this.tryInitializeDefault(target);
-    }
-    /**
-     * Start file watching on the active CodeGraph instance.
-     * Logs sync activity to stderr for diagnostics.
-     */
-    startWatching() {
-        if (!this.cg)
-            return;
-        // When the watcher is intentionally disabled (e.g. WSL2 /mnt drives, or
-        // CODEGRAPH_NO_WATCH=1), say so explicitly and tell the user how to keep
-        // the graph fresh — otherwise the silent staleness is hard to diagnose.
-        const disabledReason = (0, sync_1.watchDisabledReason)(this.projectPath ?? process.cwd());
-        if (disabledReason) {
-            process.stderr.write(`[CodeGraph MCP] File watcher disabled — ${disabledReason}. ` +
-                `The graph will not auto-update; run \`codegraph sync\` (or install the git sync hooks via \`codegraph init\`) to refresh.\n`);
-            return;
-        }
-        const started = this.cg.watch({
-            onSyncComplete: (result) => {
-                if (result.filesChanged > 0) {
-                    process.stderr.write(`[CodeGraph MCP] Auto-synced ${result.filesChanged} file(s) in ${result.durationMs}ms\n`);
-                }
-            },
-            onSyncError: (err) => {
-                process.stderr.write(`[CodeGraph MCP] Auto-sync error: ${err.message}\n`);
-            },
-        });
-        if (started) {
-            process.stderr.write('[CodeGraph MCP] File watcher active — graph will auto-sync on changes\n');
-        }
-        else {
-            // start() can also return false when recursive fs.watch isn't supported.
-            process.stderr.write('[CodeGraph MCP] File watcher unavailable on this platform — run `codegraph sync` to refresh the graph after changes.\n');
-        }
-    }
-    /**
-     * Stop the server
-     */
-    stop() {
-        // Close all cached cross-project connections first
-        this.toolHandler.closeAll();
-        // Close the main CodeGraph instance
-        if (this.cg) {
-            this.cg.close();
-            this.cg = null;
-        }
-        this.transport.stop();
-        process.exit(0);
-    }
-    /**
-     * Handle incoming JSON-RPC messages
-     */
-    async handleMessage(message) {
-        // Check if it's a request (has id) or notification (no id)
-        const isRequest = 'id' in message;
-        switch (message.method) {
-            case 'initialize':
-                if (isRequest) {
-                    await this.handleInitialize(message);
-                }
-                break;
-            case 'initialized':
-                // Notification that client has finished initialization
-                // No action needed - the client is ready
-                break;
-            case 'tools/list':
-                if (isRequest) {
-                    await this.handleToolsList(message);
-                }
-                break;
-            case 'tools/call':
-                if (isRequest) {
-                    await this.handleToolsCall(message);
-                }
-                break;
-            case 'ping':
-                if (isRequest) {
-                    this.transport.sendResult(message.id, {});
-                }
-                break;
-            default:
-                if (isRequest) {
-                    this.transport.sendError(message.id, transport_1.ErrorCodes.MethodNotFound, `Method not found: ${message.method}`);
-                }
-        }
-    }
-    /**
-     * Handle initialize request
-     */
-    async handleInitialize(request) {
-        const params = request.params;
-        // Does the client support the MCP `roots` protocol? If so, and we have no
-        // explicit path, we ask it for the workspace root after the handshake
-        // instead of falling back to the (frequently wrong) cwd. See issue #196.
-        this.clientSupportsRoots = !!params?.capabilities?.roots;
-        // Explicit project signal, strongest first: a client-provided rootUri /
-        // workspaceFolders (LSP-style, non-standard but some clients send it), else
-        // the --path the server was launched with. cwd is NOT used here — we defer
-        // it so a roots/list answer can win over it.
-        let explicitPath = null;
-        if (params?.rootUri) {
-            explicitPath = fileUriToPath(params.rootUri);
-        }
-        else if (params?.workspaceFolders?.[0]?.uri) {
-            explicitPath = fileUriToPath(params.workspaceFolders[0].uri);
-        }
-        else if (this.projectPath) {
-            explicitPath = this.projectPath;
-        }
-        // Respond to the handshake BEFORE doing any heavy initialization. Loading
-        // the SQLite DB and the tree-sitter WASM runtime can take many seconds on
-        // slow filesystems (Docker Desktop VirtioFS on macOS, WSL2). Clients like
-        // Claude Code time out the handshake at ~30s, which manifested as
-        // "MCP tools never appear" — the child was alive and had received the
-        // initialize but was still awaiting initGrammars(). See issue #172.
-        //
-        // We accept the client's protocol version but respond with our supported
-        // version. The `instructions` field is surfaced by MCP clients in the
-        // agent's system prompt automatically — it's the right place for the
-        // universal tool-selection playbook, ahead of individual tool descriptions.
-        this.transport.sendResult(request.id, {
-            protocolVersion: PROTOCOL_VERSION,
-            capabilities: {
-                tools: {},
-            },
-            serverInfo: SERVER_INFO,
-            instructions: server_instructions_1.SERVER_INSTRUCTIONS,
-        });
-        // If we know the project dir, kick off init in the background now. Tool
-        // calls that arrive before it finishes fall through to `retryInitIfNeeded`,
-        // which waits for this promise rather than racing it with a second open.
-        //
-        // If we DON'T know it (no rootUri, no --path), defer: the first tool call
-        // resolves it via roots/list (when the client supports roots) or cwd. This
-        // is the fix for issue #196 — clients that launch the server outside the
-        // project and don't pass a rootUri previously got a misleading "not
-        // initialized" error on every call.
-        if (explicitPath) {
-            this.initPromise = this.tryInitializeDefault(explicitPath).finally(() => {
-                this.initPromise = null;
-            });
-        }
-    }
-    /**
-     * Handle tools/list request
-     */
-    async handleToolsList(request) {
-        await this.retryInitIfNeeded();
-        this.transport.sendResult(request.id, {
-            tools: this.toolHandler.getTools(),
-        });
-    }
-    /**
-     * Handle tools/call request
-     */
-    async handleToolsCall(request) {
-        const params = request.params;
-        if (!params || !params.name) {
-            this.transport.sendError(request.id, transport_1.ErrorCodes.InvalidParams, 'Missing tool name');
-            return;
-        }
-        const toolName = params.name;
-        const toolArgs = params.arguments || {};
-        // Validate tool exists
-        const tool = tools_1.tools.find(t => t.name === toolName);
-        if (!tool) {
-            this.transport.sendError(request.id, transport_1.ErrorCodes.InvalidParams, `Unknown tool: ${toolName}`);
-            return;
-        }
-        // If the default project isn't initialized yet, retry in case it was
-        // initialized after the MCP server started (e.g. user ran codegraph init)
-        await this.retryInitIfNeeded();
-        const result = await this.toolHandler.execute(toolName, toolArgs);
-        this.transport.sendResult(request.id, result);
-    }
-}
-exports.MCPServer = MCPServer;
-// Export for use in CLI
-var transport_2 = require("./transport");
-Object.defineProperty(exports, "StdioTransport", { enumerable: true, get: function () { return transport_2.StdioTransport; } });
-var tools_2 = require("./tools");
-Object.defineProperty(exports, "tools", { enumerable: true, get: function () { return tools_2.tools; } });
-Object.defineProperty(exports, "ToolHandler", { enumerable: true, get: function () { return tools_2.ToolHandler; } });
-//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/mcp/server-instructions.d.ts

@@ -1,19 +0,0 @@
-/**
- * Server-level instructions emitted in the MCP `initialize` response.
- *
- * MCP clients (Claude Code, Cursor, opencode, LangChain, OpenAI Agent
- * SDK, …) surface this text in the agent's system prompt automatically,
- * giving the agent a high-level playbook for the codegraph toolset
- * before it sees individual tool descriptions.
- *
- * Goals when editing this:
- *   - Tool selection by intent (which tool for which question)
- *   - Common chains (refactor planning = X then Y)
- *   - Anti-patterns (don't grep when codegraph_search is faster)
- *
- * Keep it tight. The agent reads this every session — long instructions
- * burn tokens. Reference only tools that exist on `main`; gate any
- * conditional tools behind feature checks if/when they ship.
- */
-export declare const SERVER_INSTRUCTIONS = "# Codegraph \u2014 code intelligence over an indexed knowledge graph\n\nCodegraph is a SQLite knowledge graph of every symbol, edge, and file\nin the workspace. Reads are sub-millisecond; the index lags writes by\nabout a second through the file watcher. Consult it BEFORE writing or\nediting code, not during.\n\n## Answer directly \u2014 don't delegate exploration\n\nFor \"how does X work\", architecture, trace, or where-is-X questions,\nanswer DIRECTLY using 2-3 codegraph calls: `codegraph_context` first,\nthen ONE `codegraph_explore` for the source of the symbols it surfaces.\nCodegraph IS the pre-built search index \u2014 so delegating the lookup to a\nseparate file-reading sub-task/agent, or running your own grep + read\nloop, repeats work codegraph already did and costs more for the same\nanswer. Reach for raw Read/Grep only to confirm a specific detail\ncodegraph didn't cover. A direct codegraph answer is typically a handful\nof calls; a grep/read exploration is dozens.\n\n## Tool selection by intent\n\n- **\"What is the symbol named X?\"** \u2192 `codegraph_search`\n- **\"What's the deal with this task / feature / area?\"** \u2192 `codegraph_context` (PRIMARY \u2014 composes search + node + callers + callees in one call)\n- **\"What calls this?\"** \u2192 `codegraph_callers`\n- **\"What does this call?\"** \u2192 `codegraph_callees`\n- **\"What would changing this break?\"** \u2192 `codegraph_impact`\n- **\"Show me this symbol's source / signature / docstring.\"** \u2192 `codegraph_node`\n- **\"Show me several related symbols' source / survey an area.\"** \u2192 `codegraph_explore` (ONE capped call; prefer over many codegraph_node/Read)\n- **\"What's in directory X?\"** \u2192 `codegraph_files`\n- **\"Is the index ready / what's its size?\"** \u2192 `codegraph_status`\n\n## Common chains\n\n- **Onboarding**: `codegraph_context` first. If still unclear, `codegraph_explore` for breadth, then `codegraph_node` on specific symbols.\n- **Refactor planning**: `codegraph_search` \u2192 `codegraph_callers` \u2192 `codegraph_impact`. The blast-radius answer comes from impact, not from walking callers manually.\n- **Debugging a regression**: `codegraph_callers` of the suspected symbol; widen with `codegraph_impact` if an unexpected call appears.\n\n## Anti-patterns\n\n- **Don't grep first** when looking up a symbol by name \u2014 `codegraph_search` is faster and returns kind + location + signature.\n- **Don't chain `codegraph_search` + `codegraph_node`** when you just want context \u2014 `codegraph_context` is one round-trip.\n- **Don't loop `codegraph_node` over many symbols** \u2014 one `codegraph_explore` call returns them all grouped by file, while each separate call re-reads the whole context and costs far more. Use `codegraph_node` for a single symbol.\n- **Don't query the index immediately after editing a file** \u2014 the watcher needs ~500ms to debounce + sync. Wait for the next turn.\n\n## Limitations\n\n- Index lags file writes by ~1 second.\n- Cross-file resolution is best-effort name matching; ambiguous calls may return multiple candidates.\n- No live correctness validation \u2014 that's still the TypeScript compiler / test suite / linter's job. Codegraph supplements those with structural context they don't have.\n";
-//# sourceMappingURL=server-instructions.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"server-instructions.d.ts","sourceRoot":"","sources":["../../src/mcp/server-instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB,wtGAiD/B,CAAC"}