cgraphx 1.4.3 → 2.0.1

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

@@ -1,34 +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 cgraphx toolset
- * before it sees individual tool descriptions.
- *
- * Goals when editing this:
- *   - Lead the agent to codegraph_explore for any structural/flow question
- *   - Reinforce "explore instead of Read/Grep" for indexed code
- *   - Anti-patterns (don't re-verify with grep; don't hand-reconstruct flows)
- *
- * Keep it tight. The agent reads this every session — long instructions
- * burn tokens. The DEFAULT MCP surface is `codegraph_explore` ALONE (see
- * DEFAULT_MCP_TOOLS in tools.ts) — reference only that tool here. The other
- * tools (node/search/callers/…) stay defined and are re-enablable via
- * CGRAPHX_MCP_TOOLS, but they are NOT listed to agents, so don't name them.
- */
-export declare const SERVER_INSTRUCTIONS = "# Cgraphx \u2014 code intelligence over an indexed knowledge graph\n\nCgraphx is a SQLite knowledge graph of every symbol, edge, and file in\nthe workspace \u2014 pre-computed structure you would otherwise re-derive by\nreading files (cached intelligence: thousands of parse/trace decisions you\ndon't pay to re-reason each run). Reads are sub-millisecond; the index lags\nwrites by ~1s through the file watcher. Reach for it BEFORE *and* while\nwriting or editing code \u2014 not just for questions: one call returns the\nverbatim source PLUS who calls it and what it affects, so you edit with the\nblast radius in view. More accurate context, in far fewer tokens and\nround-trips than reading files yourself.\n\n## One tool: codegraph_explore \u2014 use it instead of reading files\n\nThere is a single tool, `codegraph_explore`, and it is Read-equivalent. It\ntakes either a natural-language question or a bag of symbol/file names and\nreturns the **verbatim, line-numbered source** of the relevant symbols\ngrouped by file \u2014 the same `<n>\\t<line>` shape `Read` gives you, safe to\n`Edit` from \u2014 PLUS the call path among them (including dynamic-dispatch hops\nlike callbacks, React re-render, and JSX children that grep can't follow) and\na blast-radius summary of what depends on them.\n\nWhether you're answering \"how does X work\" or implementing a change (fixing a\nbug, adding a feature), call `codegraph_explore` before you Read. ONE call\nusually answers the whole question. Cgraphx IS the pre-built search index \u2014\nso running your own grep + read loop, or delegating the lookup to a separate\nfile-reading sub-task/agent, repeats work cgraphx already did and costs more\nfor the same answer. A direct cgraphx answer is typically one to a few\ncalls; a grep/read exploration is dozens.\n\n## How to query\n\n- **Almost any question \u2014 \"how does X work\", architecture, a bug, \"what/where is X\", or surveying an area** \u2192 `codegraph_explore` with a natural-language question or the relevant names. ONE capped call returns the verbatim source grouped by file; most often the ONLY call you need.\n- **\"How does X reach/become Y? / the flow / the path from X to Y\"** \u2192 `codegraph_explore`, naming the symbols that span the flow (e.g. `mutateElement renderScene`) \u2014 it surfaces the call path among them, riding dynamic-dispatch hops, and returns their source.\n- **Reading or editing a file/symbol you can name** \u2192 put its name or file path in the `codegraph_explore` query \u2014 it returns that current line-numbered source (safe to `Edit` from) with the call path and blast radius attached, so you don't Read it separately. For an overloaded name it returns every matching definition's body in one call.\n- **Need more?** Call `codegraph_explore` again with more specific names \u2014 treat the source it returns as already Read.\n\n## Anti-patterns\n\n- **Trust cgraphx's results \u2014 don't re-verify them with grep.** They come from a full AST parse; re-checking with grep is slower, less accurate, and wastes context.\n- **Don't grep or Read first** to find or understand indexed code \u2014 ONE `codegraph_explore` returns the relevant symbols' source together in a single round-trip. Reach for raw `Read`/`Grep` only to confirm a specific detail cgraphx didn't cover, or for what cgraphx doesn't index (configs, docs).\n- **Don't reconstruct a flow by hand** \u2014 name the endpoints in one `codegraph_explore` and it surfaces the path between them, dynamic-dispatch hops included.\n- **After editing, check the staleness banner.** When a tool response starts with \"\u26A0\uFE0F Some files referenced below were edited since the last index sync\u2026\", the listed files are pending re-index \u2014 Read those specific files for accurate content. Every file NOT in that banner is fresh, so still trust cgraphx. A different, rarer banner \u2014 \"\u26A0\uFE0F cgraphx auto-sync is DISABLED\u2026\" \u2014 means live watching stopped entirely (the whole index is frozen, not just a few files); until it's resolved, Read files directly to confirm anything that may have changed.\n\n## Limitations\n\n- If a tool reports a project isn't indexed (no `.cgraphx/`), stop calling cgraphx tools for that project for the rest of the session and use your built-in tools there instead. Indexing is the user's decision \u2014 mention they can run `cgraphx init` if it comes up, but don't run it yourself.\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";
-/**
- * Instructions variant sent when the server's own root has NO cgraphx index.
- *
- * The tools are still exposed (gating tool availability on whether `./` has an
- * index is the bug behind #964: it breaks monorepos where only sub-projects are
- * indexed, and a server that started before `cgraphx init` never surfaces the
- * tools afterward). Instead of an "inactive" note, this variant tells the agent
- * cgraphx works **per project**: there's no default project to query, so pass
- * a `projectPath` to any project that HAS a `.cgraphx/`. The full single-
- * project playbook ({@link SERVER_INSTRUCTIONS}) is sent instead when the root
- * IS indexed, so the common case stays tight.
- */
-export declare const SERVER_INSTRUCTIONS_NO_ROOT_INDEX = "# Cgraphx \u2014 available (per-project; pass projectPath)\n\nCgraphx is a SQLite knowledge graph of a codebase's symbols, edges, and\nfiles: one `codegraph_explore` call returns the verbatim, line-numbered source\nof the relevant symbols PLUS the call paths between them and a blast-radius\nsummary \u2014 replacing a grep + Read loop with one round-trip.\n\nThis server started somewhere with no `.cgraphx/` of its own, so there is no\ndefault project \u2014 but the tools are available and work **per project**:\n\n- To query a project that HAS a `.cgraphx/` index (e.g. a service inside a\n  monorepo, or a second repo), pass its path as `projectPath` to\n  `codegraph_explore` (and any other cgraphx tool). Codegraph resolves the\n  nearest `.cgraphx/` at or above that path and answers from it \u2014 for as many\n  projects as you like in one session.\n- For a project with no `.cgraphx/`, use your built-in tools (Read/Grep/Glob)\n  for that project. Indexing is the user's decision \u2014 don't run it yourself, but\n  if it comes up they can run `cgraphx init` in a project to enable cgraphx\n  there (a new index is picked up live, no restart).\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;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,2qJAkD/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC,0oCAmB7C,CAAC"}

package/dist/mcp/server-instructions.js

@@ -1,106 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERVER_INSTRUCTIONS_NO_ROOT_INDEX = exports.SERVER_INSTRUCTIONS = void 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 cgraphx toolset
- * before it sees individual tool descriptions.
- *
- * Goals when editing this:
- *   - Lead the agent to codegraph_explore for any structural/flow question
- *   - Reinforce "explore instead of Read/Grep" for indexed code
- *   - Anti-patterns (don't re-verify with grep; don't hand-reconstruct flows)
- *
- * Keep it tight. The agent reads this every session — long instructions
- * burn tokens. The DEFAULT MCP surface is `codegraph_explore` ALONE (see
- * DEFAULT_MCP_TOOLS in tools.ts) — reference only that tool here. The other
- * tools (node/search/callers/…) stay defined and are re-enablable via
- * CGRAPHX_MCP_TOOLS, but they are NOT listed to agents, so don't name them.
- */
-exports.SERVER_INSTRUCTIONS = `# Cgraphx — code intelligence over an indexed knowledge graph
-
-Cgraphx is a SQLite knowledge graph of every symbol, edge, and file in
-the workspace — pre-computed structure you would otherwise re-derive by
-reading files (cached intelligence: thousands of parse/trace decisions you
-don't pay to re-reason each run). Reads are sub-millisecond; the index lags
-writes by ~1s through the file watcher. Reach for it BEFORE *and* while
-writing or editing code — not just for questions: one call returns the
-verbatim source PLUS who calls it and what it affects, so you edit with the
-blast radius in view. More accurate context, in far fewer tokens and
-round-trips than reading files yourself.
-
-## One tool: codegraph_explore — use it instead of reading files
-
-There is a single tool, \`codegraph_explore\`, and it is Read-equivalent. It
-takes either a natural-language question or a bag of symbol/file names and
-returns the **verbatim, line-numbered source** of the relevant symbols
-grouped by file — the same \`<n>\\t<line>\` shape \`Read\` gives you, safe to
-\`Edit\` from — PLUS the call path among them (including dynamic-dispatch hops
-like callbacks, React re-render, and JSX children that grep can't follow) and
-a blast-radius summary of what depends on them.
-
-Whether you're answering "how does X work" or implementing a change (fixing a
-bug, adding a feature), call \`codegraph_explore\` before you Read. ONE call
-usually answers the whole question. Cgraphx IS the pre-built search index —
-so running your own grep + read loop, or delegating the lookup to a separate
-file-reading sub-task/agent, repeats work cgraphx already did and costs more
-for the same answer. A direct cgraphx answer is typically one to a few
-calls; a grep/read exploration is dozens.
-
-## How to query
-
-- **Almost any question — "how does X work", architecture, a bug, "what/where is X", or surveying an area** → \`codegraph_explore\` with a natural-language question or the relevant names. ONE capped call returns the verbatim source grouped by file; most often the ONLY call you need.
-- **"How does X reach/become Y? / the flow / the path from X to Y"** → \`codegraph_explore\`, naming the symbols that span the flow (e.g. \`mutateElement renderScene\`) — it surfaces the call path among them, riding dynamic-dispatch hops, and returns their source.
-- **Reading or editing a file/symbol you can name** → put its name or file path in the \`codegraph_explore\` query — it returns that current line-numbered source (safe to \`Edit\` from) with the call path and blast radius attached, so you don't Read it separately. For an overloaded name it returns every matching definition's body in one call.
-- **Need more?** Call \`codegraph_explore\` again with more specific names — treat the source it returns as already Read.
-
-## Anti-patterns
-
-- **Trust cgraphx's results — don't re-verify them with grep.** They come from a full AST parse; re-checking with grep is slower, less accurate, and wastes context.
-- **Don't grep or Read first** to find or understand indexed code — ONE \`codegraph_explore\` returns the relevant symbols' source together in a single round-trip. Reach for raw \`Read\`/\`Grep\` only to confirm a specific detail cgraphx didn't cover, or for what cgraphx doesn't index (configs, docs).
-- **Don't reconstruct a flow by hand** — name the endpoints in one \`codegraph_explore\` and it surfaces the path between them, dynamic-dispatch hops included.
-- **After editing, check the staleness banner.** When a tool response starts with "⚠️ Some files referenced below were edited since the last index sync…", the listed files are pending re-index — Read those specific files for accurate content. Every file NOT in that banner is fresh, so still trust cgraphx. A different, rarer banner — "⚠️ cgraphx auto-sync is DISABLED…" — means live watching stopped entirely (the whole index is frozen, not just a few files); until it's resolved, Read files directly to confirm anything that may have changed.
-
-## Limitations
-
-- If a tool reports a project isn't indexed (no \`.cgraphx/\`), stop calling cgraphx tools for that project for the rest of the session and use your built-in tools there instead. Indexing is the user's decision — mention they can run \`cgraphx init\` if it comes up, but don't run it yourself.
-- Index lags file writes by ~1 second.
-- Cross-file resolution is best-effort name matching; ambiguous calls may return multiple candidates.
-- No live correctness validation — that's still the TypeScript compiler / test suite / linter's job. Codegraph supplements those with structural context they don't have.
-`;
-/**
- * Instructions variant sent when the server's own root has NO cgraphx index.
- *
- * The tools are still exposed (gating tool availability on whether `./` has an
- * index is the bug behind #964: it breaks monorepos where only sub-projects are
- * indexed, and a server that started before `cgraphx init` never surfaces the
- * tools afterward). Instead of an "inactive" note, this variant tells the agent
- * cgraphx works **per project**: there's no default project to query, so pass
- * a `projectPath` to any project that HAS a `.cgraphx/`. The full single-
- * project playbook ({@link SERVER_INSTRUCTIONS}) is sent instead when the root
- * IS indexed, so the common case stays tight.
- */
-exports.SERVER_INSTRUCTIONS_NO_ROOT_INDEX = `# Cgraphx — available (per-project; pass projectPath)
-
-Cgraphx is a SQLite knowledge graph of a codebase's symbols, edges, and
-files: one \`codegraph_explore\` call returns the verbatim, line-numbered source
-of the relevant symbols PLUS the call paths between them and a blast-radius
-summary — replacing a grep + Read loop with one round-trip.
-
-This server started somewhere with no \`.cgraphx/\` of its own, so there is no
-default project — but the tools are available and work **per project**:
-
-- To query a project that HAS a \`.cgraphx/\` index (e.g. a service inside a
-  monorepo, or a second repo), pass its path as \`projectPath\` to
-  \`codegraph_explore\` (and any other cgraphx tool). Codegraph resolves the
-  nearest \`.cgraphx/\` at or above that path and answers from it — for as many
-  projects as you like in one session.
-- For a project with no \`.cgraphx/\`, use your built-in tools (Read/Grep/Glob)
-  for that project. Indexing is the user's decision — don't run it yourself, but
-  if it comes up they can run \`cgraphx init\` in a project to enable cgraphx
-  there (a new index is picked up live, no restart).
-`;
-//# sourceMappingURL=server-instructions.js.map

package/dist/mcp/server-instructions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/mcp/server-instructions.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDlC,CAAC;AAEF;;;;;;;;;;;GAWG;AACU,QAAA,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;CAmBhD,CAAC"}

package/dist/mcp/session.d.ts

@@ -1,79 +0,0 @@
-/**
- * MCP per-connection session — speaks the JSON-RPC protocol (initialize,
- * tools/list, tools/call) over a single {@link JsonRpcTransport}. It owns
- * per-client state only (which protocol version the client asked for, whether
- * it advertised `roots`, the one-shot roots/list latch); the heavyweight
- * resources (CodeGraph, watcher, ToolHandler) live in the shared
- * {@link MCPEngine} so daemon mode can collapse N inotify sets / DB handles
- * to one.
- *
- * The state-machine itself mirrors what `MCPServer` used to do inline before
- * issue #411 split it out — the same regression tests in
- * `__tests__/mcp-initialize.test.ts` still drive this code path.
- */
-import { JsonRpcTransport } from './transport';
-import { MCPEngine } from './engine';
-/**
- * MCP Server Info — kept on the session because some clients log it. The
- * version tracks the real package version (was a hard-coded '0.1.0').
- */
-export declare const SERVER_INFO: {
-    name: string;
-    version: string;
-};
-/** MCP Protocol Version (latest the server claims). */
-export declare const PROTOCOL_VERSION = "2024-11-05";
-export interface MCPSessionOptions {
-    /**
-     * Explicit project path from the `--path` CLI flag. When set, the session
-     * will not bother asking the client for `roots/list` — we already know
-     * where the project lives.
-     */
-    explicitProjectPath?: string | null;
-}
-/**
- * One MCP client's view of the server. Created fresh per stdio launch
- * (direct mode) or per socket connection (daemon mode).
- */
-export declare class MCPSession {
-    private transport;
-    private engine;
-    private clientSupportsRoots;
-    /** From the initialize handshake — attributes usage rollups to the agent host. */
-    private clientInfo;
-    private rootsAttempted;
-    private resolvePromise;
-    private explicitProjectPath;
-    constructor(transport: JsonRpcTransport, engine: MCPEngine, opts?: MCPSessionOptions);
-    /**
-     * Start handling messages from the transport. Returns immediately — the
-     * session lives for as long as the transport is open.
-     */
-    start(): void;
-    /**
-     * Tear down the session. Does NOT touch the engine (the engine may serve
-     * other sessions) or call `process.exit` (the daemon decides when to exit).
-     */
-    stop(): void;
-    /** Underlying transport — exposed for daemon-side close hooks. */
-    getTransport(): JsonRpcTransport;
-    private handleMessage;
-    private handleInitialize;
-    private handleToolsList;
-    private handleToolsCall;
-    /**
-     * Lazy default-project resolution. Three layers:
-     *   1. await the in-flight init kicked off from `handleInitialize` (if any);
-     *   2. if still uninitialized and we never asked the client for its roots,
-     *      do so now (one-shot); fall back to cwd if the client lacks roots;
-     *   3. last-resort: re-walk from the best candidate — picks up projects
-     *      that were `cgraphx init`'d *after* the server started.
-     */
-    private retryInitIfNeeded;
-    /**
-     * Ask the client for its workspace root via `roots/list` and open the
-     * first one. Falls back to `process.cwd()` on timeout or empty answer.
-     */
-    private initFromRoots;
-}
-//# sourceMappingURL=session.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/mcp/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAuC,gBAAgB,EAAc,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAOrC;;;GAGG;AAGH,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAmC7C,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,UAAU;IASnB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;IAThB,OAAO,CAAC,mBAAmB,CAAS;IACpC,kFAAkF;IAClF,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,mBAAmB,CAAgB;gBAGjC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,SAAS,EACzB,IAAI,GAAE,iBAAsB;IAK9B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAIZ,kEAAkE;IAClE,YAAY,IAAI,gBAAgB;YAIlB,aAAa;YA0Cb,gBAAgB;YA0DhB,eAAe;YAkBf,eAAe;IAiC7B;;;;;;;OAOG;YACW,iBAAiB;IAyB/B;;;OAGG;YACW,aAAa;CAgB5B"}

package/dist/mcp/session.js

@@ -1,330 +0,0 @@
-"use strict";
-/**
- * MCP per-connection session — speaks the JSON-RPC protocol (initialize,
- * tools/list, tools/call) over a single {@link JsonRpcTransport}. It owns
- * per-client state only (which protocol version the client asked for, whether
- * it advertised `roots`, the one-shot roots/list latch); the heavyweight
- * resources (CodeGraph, watcher, ToolHandler) live in the shared
- * {@link MCPEngine} so daemon mode can collapse N inotify sets / DB handles
- * to one.
- *
- * The state-machine itself mirrors what `MCPServer` used to do inline before
- * issue #411 split it out — the same regression tests in
- * `__tests__/mcp-initialize.test.ts` still drive this code path.
- */
-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.MCPSession = exports.PROTOCOL_VERSION = exports.SERVER_INFO = void 0;
-const path = __importStar(require("path"));
-const transport_1 = require("./transport");
-const tools_1 = require("./tools");
-const server_instructions_1 = require("./server-instructions");
-const version_1 = require("./version");
-const directory_1 = require("../directory");
-const telemetry_1 = require("../telemetry");
-/**
- * MCP Server Info — kept on the session because some clients log it. The
- * version tracks the real package version (was a hard-coded '0.1.0').
- */
-// Exported so the proxy can answer `initialize` locally with the IDENTICAL
-// payload the daemon would send — no drift between the two handshake paths.
-exports.SERVER_INFO = {
-    name: 'cgraphx',
-    version: version_1.CodeGraphPackageVersion,
-};
-/** MCP Protocol Version (latest the server claims). */
-exports.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;
-/**
- * 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);
-        if (process.platform === 'win32' && /^\/[a-zA-Z]:/.test(filePath)) {
-            filePath = filePath.slice(1);
-        }
-        return path.resolve(filePath);
-    }
-    catch {
-        return uri.replace(/^file:\/\/\/?/, '');
-    }
-}
-/** First usable filesystem path from a `roots/list` result, or null. */
-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);
-}
-/**
- * One MCP client's view of the server. Created fresh per stdio launch
- * (direct mode) or per socket connection (daemon mode).
- */
-class MCPSession {
-    transport;
-    engine;
-    clientSupportsRoots = false;
-    /** From the initialize handshake — attributes usage rollups to the agent host. */
-    clientInfo;
-    rootsAttempted = false;
-    resolvePromise = null;
-    explicitProjectPath;
-    constructor(transport, engine, opts = {}) {
-        this.transport = transport;
-        this.engine = engine;
-        this.explicitProjectPath = opts.explicitProjectPath ?? null;
-    }
-    /**
-     * Start handling messages from the transport. Returns immediately — the
-     * session lives for as long as the transport is open.
-     */
-    start() {
-        this.transport.start(this.handleMessage.bind(this));
-    }
-    /**
-     * Tear down the session. Does NOT touch the engine (the engine may serve
-     * other sessions) or call `process.exit` (the daemon decides when to exit).
-     */
-    stop() {
-        this.transport.stop();
-    }
-    /** Underlying transport — exposed for daemon-side close hooks. */
-    getTransport() {
-        return this.transport;
-    }
-    async handleMessage(message) {
-        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.
-                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;
-            case 'resources/list':
-                // We expose no MCP resources, but some clients (opencode, Codex) probe
-                // for them on connect; reply with an empty list instead of a
-                // MethodNotFound error that surfaces as a scary `-32601` log line. (#621)
-                if (isRequest)
-                    this.transport.sendResult(message.id, { resources: [] });
-                break;
-            case 'resources/templates/list':
-                if (isRequest)
-                    this.transport.sendResult(message.id, { resourceTemplates: [] });
-                break;
-            case 'prompts/list':
-                // Likewise — no prompts exposed, but answer the probe cleanly. (#621)
-                if (isRequest)
-                    this.transport.sendResult(message.id, { prompts: [] });
-                break;
-            default:
-                if (isRequest) {
-                    this.transport.sendError(message.id, transport_1.ErrorCodes.MethodNotFound, `Method not found: ${message.method}`);
-                }
-        }
-    }
-    async handleInitialize(request) {
-        const params = request.params;
-        this.clientSupportsRoots = !!params?.capabilities?.roots;
-        if (params?.clientInfo) {
-            this.clientInfo = {
-                name: typeof params.clientInfo.name === 'string' ? params.clientInfo.name : undefined,
-                version: typeof params.clientInfo.version === 'string' ? params.clientInfo.version : undefined,
-            };
-        }
-        // Explicit project signal, strongest first: client-provided rootUri /
-        // workspaceFolders (LSP-style), 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. See issue #196.
-        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.explicitProjectPath) {
-            explicitPath = this.explicitProjectPath;
-        }
-        // Pick the instructions variant by the root's index state — a cheap
-        // synchronous walk-up (existsSync loop only, no DB open, so the #172
-        // respond-fast contract holds). When the root IS indexed, send the full
-        // single-project playbook. When it ISN'T, send the per-project variant
-        // (tools are still exposed — see handleToolsList): it tells the agent there
-        // is no default project and to pass `projectPath` to any project that has a
-        // `.cgraphx/`. Gating tool AVAILABILITY on whether `./` is indexed was the
-        // #964 bug — it broke monorepos (only sub-projects indexed) and never
-        // surfaced the tools after a mid-session `cgraphx init`. When no explicit
-        // path is known yet (roots/list dance pending), cwd is the best predictor of
-        // where the default project will resolve.
-        const indexed = (0, directory_1.findNearestCodeGraphRoot)(explicitPath ?? process.cwd()) !== null;
-        // Respond to the handshake BEFORE doing any heavy init — see issue #172.
-        this.transport.sendResult(request.id, {
-            protocolVersion: exports.PROTOCOL_VERSION,
-            capabilities: { tools: {} },
-            serverInfo: exports.SERVER_INFO,
-            instructions: indexed ? server_instructions_1.SERVER_INSTRUCTIONS : server_instructions_1.SERVER_INSTRUCTIONS_NO_ROOT_INDEX,
-        });
-        if (explicitPath) {
-            // Kick off engine init in the background. If another session in the
-            // same daemon already opened the project, `ensureInitialized` is a
-            // ~free no-op — N concurrent clients pay exactly one open.
-            this.resolvePromise = this.engine.ensureInitialized(explicitPath);
-        }
-    }
-    async handleToolsList(request) {
-        await this.retryInitIfNeeded();
-        // Always expose the tools — even when the server root has no index. Gating
-        // availability on whether `./` is indexed (the old behavior) breaks the
-        // monorepo case where only sub-projects carry a `.cgraphx/` (the agent
-        // saw zero tools and couldn't even reach an indexed sub-project by
-        // `projectPath`), and it hides the tools from a session that started before
-        // the user ran `cgraphx init` (most hosts request the list once, so the
-        // freshly-built index never surfaces). #964. The not-indexed case is still
-        // safe: a call against an un-indexed path returns SUCCESS-shaped guidance
-        // ("pass projectPath / run cgraphx init"), never `isError`, so it can't
-        // teach the agent to abandon codegraph. `getTools()` returns the default
-        // surface even before a project is open.
-        this.transport.sendResult(request.id, {
-            tools: this.engine.getToolHandler().getTools(),
-        });
-    }
-    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 || {};
-        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;
-        }
-        await this.retryInitIfNeeded();
-        const result = await this.engine.getToolHandler().execute(toolName, toolArgs);
-        this.transport.sendResult(request.id, result);
-        // After the reply is on the wire — telemetry must never delay a tool
-        // response (in-memory increment only; see src/telemetry).
-        (0, telemetry_1.getTelemetry)().recordUsage('mcp_tool', toolName, !result.isError, this.clientInfo);
-    }
-    /**
-     * Lazy default-project resolution. Three layers:
-     *   1. await the in-flight init kicked off from `handleInitialize` (if any);
-     *   2. if still uninitialized and we never asked the client for its roots,
-     *      do so now (one-shot); fall back to cwd if the client lacks roots;
-     *   3. last-resort: re-walk from the best candidate — picks up projects
-     *      that were `cgraphx init`'d *after* the server started.
-     */
-    async retryInitIfNeeded() {
-        if (this.resolvePromise) {
-            try {
-                await this.resolvePromise;
-            }
-            catch { /* fall through to retry */ }
-            this.resolvePromise = null;
-        }
-        if (this.engine.hasDefaultCodeGraph())
-            return;
-        const hint = this.explicitProjectPath ?? this.engine.getProjectPath();
-        if (!hint && !this.rootsAttempted) {
-            this.rootsAttempted = true;
-            this.resolvePromise = this.clientSupportsRoots
-                ? this.initFromRoots()
-                : this.engine.ensureInitialized(process.cwd());
-            try {
-                await this.resolvePromise;
-            }
-            catch { /* fall through */ }
-            this.resolvePromise = null;
-            if (this.engine.hasDefaultCodeGraph())
-                return;
-        }
-        // Last resort: walk from the best candidate (sync open). Picks up
-        // projects that appeared after the server started.
-        const candidate = hint ?? process.cwd();
-        this.engine.retryInitializeSync(candidate);
-    }
-    /**
-     * Ask the client for its workspace root via `roots/list` and open the
-     * first one. Falls back to `process.cwd()` on timeout or empty answer.
-     */
-    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('[cgraphx 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(`[cgraphx MCP] roots/list request failed (${msg}); falling back to process cwd.\n`);
-        }
-        await this.engine.ensureInitialized(target);
-    }
-}
-exports.MCPSession = MCPSession;
-//# sourceMappingURL=session.js.map

package/dist/mcp/session.js.map

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

package/dist/mcp/stdin-teardown.d.ts

@@ -1,27 +0,0 @@
-/**
- * Treat a stdin failure as a shutdown signal — issue #799.
- *
- * An MCP stdio server's lifeline is its stdin: when the host/client goes away,
- * stdin should end and the server should exit. The server paths listened for
- * `'end'` and `'close'` — but NOT `'error'`.
- *
- * That gap bites with a socket-backed stdin, which is the shape VS Code /
- * Claude Code use (a socketpair, not a pipe). When the client dies, the socket
- * can surface as an `'error'` (ECONNRESET / hangup) rather than a clean
- * `'close'`. With no `'error'` listener, Node escalates it to the process-wide
- * `uncaughtException` handler, which logs and keeps running — so the server
- * orphans instead of exiting. Worse, on Linux a `POLLHUP` socket fd left
- * registered in epoll wakes the event loop continuously, pinning a core at
- * 100% CPU (the spin reported in #799); once the main thread spins, the
- * `setInterval` PPID watchdog can't even fire, so the orphan runs forever.
- *
- * Fix: listen for `'error'` as well, and DESTROY the stdin stream on any
- * terminal event so the fd leaves epoll and can't keep churning, then run the
- * caller's shutdown. Fires `onTerminal` at most once — callers' shutdowns are
- * already re-entry-guarded, but the single-shot guard also keeps `destroy()`'s
- * follow-on `'close'` from re-invoking it.
- *
- * `stream` is injectable for tests; it defaults to `process.stdin`.
- */
-export declare function treatStdinFailureAsShutdown(onTerminal: () => void, stream?: NodeJS.ReadableStream): void;
-//# sourceMappingURL=stdin-teardown.d.ts.map

package/dist/mcp/stdin-teardown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdin-teardown.d.ts","sourceRoot":"","sources":["../../src/mcp/stdin-teardown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,IAAI,EACtB,MAAM,GAAE,MAAM,CAAC,cAA8B,GAC5C,IAAI,CAiBN"}