@opensip-cli/mcp 0.1.15

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,8 @@
+OpenSIP CLI
+Copyright 2026 opensip-ai
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this software except in compliance with the License. A copy of the License is
+included in the LICENSE file and is also available at:
+
+    http://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -0,0 +1,33 @@
+<!-- Generated by scripts/build-package-readmes.mjs — do not edit by hand.
+     Change the package's "description" (or the generator template) and run
+     `pnpm docs:readmes`. CI enforces sync via `pnpm docs:readmes:check`. -->
+
+# @opensip-cli/mcp
+
+> MCP server exposing the OpenSIP call graph and stored results to coding agents over stdio
+
+This package is the **engine** behind a first-party `opensip-cli` tool. The CLI bundles it — you do not normally install it directly.
+
+Part of [**opensip-cli**](https://github.com/opensip-ai/opensip-cli) — an open-source codebase intelligence CLI: fitness checks (`fit`), static call-graph analysis (`graph`), simulation (`sim`), and advisory reduction audits (`yagni`).
+
+**Distribution model:** the published `opensip-cli` npm package is a full-stack bundle of first-party tools, check packs, and language adapters. Third-party tools install separately via the `opensipTools` manifest and host allowlist; a slim install without bundled tools is not a current goal.
+
+## Install
+
+Most users install the CLI, which bundles the first-party tools:
+
+```bash
+curl -fsSL https://opensip.ai/cli/install.sh | bash
+```
+
+This package is published for the CLI and advanced plugin authors; most users should not install `@opensip-cli/mcp` directly.
+
+## Documentation
+
+- 📚 Project docs: https://opensip.ai/docs/opensip-cli/
+- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.15/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.15/packages/mcp
+
+## License
+
+Apache-2.0 © opensip-ai

package/dist/__tests__/command-transport.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `opensip mcp` is a TRANSPORT, not a run (Task 6.1 §Observability).
+ *
+ * - It owns stdout for JSON-RPC: `output: 'raw-stream'` + `rawStreamReason:
+ *   'mcp-stdio'`, project-scoped.
+ * - It records NO session: the command returns no `ToolSessionContribution`, and
+ *   MCP source never names `SessionRepo` / a `persist*Session` / a
+ *   `runSession.record` writer (host-owned-run-timing). Verified structurally
+ *   across the whole package source (the same symbols the dogfood self-checks
+ *   forbid — asserted here as an explicit unit, not just at CI).
+ */
+export {};
+//# sourceMappingURL=command-transport.test.d.ts.map

package/dist/__tests__/command-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-transport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/command-transport.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/command-transport.test.js

@@ -0,0 +1,63 @@
+/**
+ * `opensip mcp` is a TRANSPORT, not a run (Task 6.1 §Observability).
+ *
+ * - It owns stdout for JSON-RPC: `output: 'raw-stream'` + `rawStreamReason:
+ *   'mcp-stdio'`, project-scoped.
+ * - It records NO session: the command returns no `ToolSessionContribution`, and
+ *   MCP source never names `SessionRepo` / a `persist*Session` / a
+ *   `runSession.record` writer (host-owned-run-timing). Verified structurally
+ *   across the whole package source (the same symbols the dogfood self-checks
+ *   forbid — asserted here as an explicit unit, not just at CI).
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { mcpCommandSpec } from '../command.js';
+const SRC_DIR = fileURLToPath(new URL('..', import.meta.url));
+/** Every production `.ts` under `src/` (excludes `__tests__/` and `*.test.ts`). */
+function productionSources(dir) {
+    const out = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === '__tests__')
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...productionSources(full));
+        }
+        else if (entry.name.endsWith('.ts') && !entry.name.endsWith('.test.ts')) {
+            out.push(full);
+        }
+    }
+    return out;
+}
+describe('mcp command — raw-stream transport contract', () => {
+    it('owns stdout for JSON-RPC via the documented raw-stream escape hatch', () => {
+        expect(mcpCommandSpec.output).toBe('raw-stream');
+        expect(mcpCommandSpec.rawStreamReason).toBe('mcp-stdio');
+        expect(mcpCommandSpec.scope).toBe('project');
+    });
+});
+describe('mcp source — no session-record writer (transport, not a run)', () => {
+    const sources = productionSources(SRC_DIR);
+    const contents = new Map(sources.map((f) => [f, readFileSync(f, 'utf8')]));
+    it('discovers the production source set', () => {
+        expect(sources.length).toBeGreaterThan(0);
+    });
+    it('never USES SessionRepo (reads sessions only through the read API; prose mentions are fine)', () => {
+        // The host-owned-run-timing invariant forbids importing/instantiating the
+        // writer — not naming it in a doc-comment that explains the constraint.
+        const offenders = [...contents]
+            .filter(([, c]) => /\bnew\s+SessionRepo\b/.test(c) || /import[^;]*\bSessionRepo\b[^;]*from/.test(c))
+            .map(([f]) => f);
+        expect(offenders, `SessionRepo must not be imported/instantiated:\n${offenders.join('\n')}`).toEqual([]);
+    });
+    it('never returns a ToolSessionContribution or calls a session writer', () => {
+        const forbidden = ['ToolSessionContribution', 'persistSession', 'runSession.record'];
+        for (const needle of forbidden) {
+            const offenders = [...contents].filter(([, c]) => c.includes(needle)).map(([f]) => f);
+            expect(offenders, `${needle} must not appear in MCP source:\n${offenders.join('\n')}`).toEqual([]);
+        }
+    });
+});
+//# sourceMappingURL=command-transport.test.js.map

package/dist/__tests__/command-transport.test.js.map

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

package/dist/__tests__/e2e-stdio.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * E2E stdio (Task 6.3) — the proof that scope survives the SDK round-trip.
+ *
+ * Spawns the REAL built CLI (`node packages/cli/dist/index.js mcp`) and drives it
+ * with the MCP SDK client over a `StdioClientTransport`. This is the gap the
+ * review flagged: an SDK handler dispatches off an EventEmitter, so a tool call
+ * proves the captured `RunScope` (datastore + ports) survives a real
+ * SDK-dispatched handler — not just `initialize`.
+ *
+ * Requires `dist/` (the real CLI + mcp) — it FAILS LOUDLY if missing (no silent
+ * skip). Fixture A pre-seeds a real catalog + a fit session; fixture B has no
+ * catalog (to prove `refresh_graph` builds once the bundled graph adapter loads
+ * under the mcp-owned run — i.e. the real `loadOwningToolCapabilities` path).
+ */
+export {};
+//# sourceMappingURL=e2e-stdio.test.d.ts.map

package/dist/__tests__/e2e-stdio.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-stdio.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/e2e-stdio.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/__tests__/e2e-stdio.test.js

@@ -0,0 +1,271 @@
+/**
+ * E2E stdio (Task 6.3) — the proof that scope survives the SDK round-trip.
+ *
+ * Spawns the REAL built CLI (`node packages/cli/dist/index.js mcp`) and drives it
+ * with the MCP SDK client over a `StdioClientTransport`. This is the gap the
+ * review flagged: an SDK handler dispatches off an EventEmitter, so a tool call
+ * proves the captured `RunScope` (datastore + ports) survives a real
+ * SDK-dispatched handler — not just `initialize`.
+ *
+ * Requires `dist/` (the real CLI + mcp) — it FAILS LOUDLY if missing (no silent
+ * skip). Fixture A pre-seeds a real catalog + a fit session; fixture B has no
+ * catalog (to prove `refresh_graph` builds once the bundled graph adapter loads
+ * under the mcp-owned run — i.e. the real `loadOwningToolCapabilities` path).
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { applyToolContributeScope, resolveProjectPaths, RunScope, runWithScope, } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { currentAdapterRegistry, graphTool } from '@opensip-cli/graph';
+import { runGraph } from '@opensip-cli/graph/internal';
+import { typescriptGraphAdapter } from '@opensip-cli/graph-typescript';
+import { SessionRepo } from '@opensip-cli/session-store';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+const CLI_DIST = fileURLToPath(new URL('../../../../packages/cli/dist/index.js', import.meta.url));
+const TSCONFIG = JSON.stringify({
+    compilerOptions: {
+        target: 'ES2022',
+        module: 'Node16',
+        moduleResolution: 'Node16',
+        strict: true,
+        rootDir: '.',
+    },
+    include: ['**/*.ts'],
+});
+const CONFIG_YML = [
+    'globalExcludes:',
+    "  - 'node_modules/**'",
+    'targets:',
+    '  ts-source:',
+    "    description: 'TypeScript source'",
+    '    languages: [typescript]',
+    '    concerns: [backend]',
+    '    include:',
+    "      - '**/*.ts'",
+    'fitness:',
+    '  failOnErrors: 0',
+    '  failOnWarnings: 0',
+    '  disabledChecks: []',
+    '',
+].join('\n');
+const SOURCE = [
+    'export function main(): number { return helper(); }',
+    'function helper(): number { return 1; }',
+    'function unused(): number { return 7; }',
+    '',
+].join('\n');
+const SAFE_ENV = Object.fromEntries(Object.entries(process.env).filter(([, v]) => v !== undefined));
+/** Materialize a fixture project layout; returns the project root. */
+function scaffold() {
+    const root = mkdtempSync(join(tmpdir(), 'mcp-e2e-'));
+    mkdirSync(join(root, 'opensip-cli', '.runtime'), { recursive: true });
+    writeFileSync(join(root, 'opensip-cli.config.yml'), CONFIG_YML, 'utf8');
+    writeFileSync(join(root, 'tsconfig.json'), TSCONFIG, 'utf8');
+    writeFileSync(join(root, 'index.ts'), SOURCE, 'utf8');
+    return root;
+}
+/** Open the project datastore at its canonical path. */
+function openProjectStore(root) {
+    const path = `${resolveProjectPaths(root).runtimeDir}/datastore.sqlite`;
+    return DataStoreFactory.open({ backend: 'sqlite', path });
+}
+/** Spawn `opensip mcp --cwd root` and connect an MCP client over stdio. */
+async function connect(root) {
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args: [CLI_DIST, 'mcp', '--cwd', root],
+        env: SAFE_ENV,
+        cwd: root,
+        stderr: 'pipe',
+    });
+    const conn = {
+        client: new Client({ name: 'e2e', version: '0.0.0' }),
+        transport,
+        stderr: '',
+    };
+    transport.stderr?.on('data', (chunk) => {
+        conn.stderr += chunk.toString('utf8');
+    });
+    await conn.client.connect(transport);
+    return conn;
+}
+/** Call a tool and parse its single JSON text payload. */
+async function call(conn, name, args = {}) {
+    const result = await conn.client.callTool({ name, arguments: args });
+    const content = result.content;
+    const first = content[0];
+    return JSON.parse(first?.text ?? '{}');
+}
+let fixtureA;
+let fixtureB;
+let helperSymbolId;
+let helperFile;
+let helperLine;
+/**
+ * A seeded run keyed by the per-tool LAYOUT KEY — the value `get_latest_findings`
+ * / `show_run` accept and that sessions are stored under. `validToolIds` is now
+ * built from `identity.layoutKey ?? identity.name`, so `fit`/`sim`/`graph`/`yagni`
+ * all resolve + replay. `graph` (layoutKey `'graph'`) is used here.
+ */
+function graphSession(root) {
+    return {
+        id: 'graph-e2e-1',
+        tool: 'graph',
+        startedAt: '2026-05-21T12:00:00.000Z',
+        completedAt: '2026-05-21T12:00:30.000Z',
+        cwd: root,
+        recipe: 'default',
+        score: 90,
+        passed: true,
+        durationMs: 30_000,
+        payload: {
+            summary: { total: 1, passed: 0, failed: 1, errors: 0, warnings: 1 },
+            checks: [
+                {
+                    checkSlug: 'graph:large-function',
+                    passed: false,
+                    violationCount: 1,
+                    durationMs: 5,
+                    findings: [
+                        {
+                            ruleId: 'graph:large-function',
+                            message: 'a seeded finding',
+                            severity: 'warning',
+                            filePath: 'index.ts',
+                            line: 1,
+                            violationCount: 1,
+                        },
+                    ],
+                },
+            ],
+        },
+    };
+}
+beforeAll(async () => {
+    if (!existsSync(CLI_DIST)) {
+        throw new Error(`e2e requires the built CLI at ${CLI_DIST}. Run \`pnpm build\` before the MCP test suite.`);
+    }
+    // Fixture A: seed a REAL catalog + a fit session into the project datastore.
+    fixtureA = scaffold();
+    const store = openProjectStore(fixtureA);
+    const scope = new RunScope();
+    applyToolContributeScope(scope, graphTool);
+    const outcome = await runWithScope(scope, () => {
+        currentAdapterRegistry().register(typescriptGraphAdapter);
+        return runGraph({ cwd: fixtureA, datastore: store });
+    });
+    const catalog = outcome.catalog;
+    if (catalog === null)
+        throw new Error('e2e seeding failed: runGraph produced no catalog');
+    // Recover helper's symbolId from the seeded catalog.
+    for (const occs of Object.values(catalog.functions)) {
+        for (const occ of occs) {
+            if (occ.simpleName === 'helper') {
+                helperSymbolId = `${occ.filePath}:${String(occ.line)}:${String(occ.column)}`;
+                helperFile = occ.filePath;
+                helperLine = occ.line;
+            }
+        }
+    }
+    new SessionRepo(store).save(graphSession(fixtureA));
+    store.close();
+    if (!helperSymbolId)
+        throw new Error('e2e seeding failed: helper symbol not found in catalog');
+    // Fixture B: a project with NO catalog (refresh_graph must build it).
+    fixtureB = scaffold();
+}, 120_000);
+afterAll(() => {
+    if (fixtureA)
+        rmSync(fixtureA, { recursive: true, force: true });
+    if (fixtureB)
+        rmSync(fixtureB, { recursive: true, force: true });
+});
+describe('MCP e2e over real stdio', () => {
+    it('handshakes and lists all 13 tools', async () => {
+        const conn = await connect(fixtureA);
+        try {
+            const tools = await conn.client.listTools();
+            expect(tools.tools).toHaveLength(13);
+            const names = tools.tools.map((t) => t.name).sort();
+            expect(names).toContain('get_symbol');
+            expect(names).toContain('who_calls');
+            expect(names).toContain('get_latest_findings');
+            expect(names).toContain('refresh_graph');
+        }
+        finally {
+            await conn.client.close();
+        }
+    }, 60_000);
+    it('survives an SDK-dispatched who_calls / get_symbol (scope reaches the handler)', async () => {
+        const conn = await connect(fixtureA);
+        try {
+            // who_calls: proves the captured RunScope (datastore + graph port) reached
+            // an EventEmitter-dispatched handler — not just `initialize`.
+            const who = await call(conn, 'who_calls', { symbolId: helperSymbolId, depth: 5 });
+            const callers = who.data;
+            expect(callers.some((c) => c.qualifiedName.includes('main'))).toBe(true);
+            // get_symbol over file+line resolves to a stable symbolId.
+            const sym = await call(conn, 'get_symbol', { file: helperFile, line: helperLine });
+            const resolved = (sym.data ?? sym.candidates?.[0]);
+            expect(resolved.symbolId).toBe(helperSymbolId);
+        }
+        finally {
+            await conn.client.close();
+        }
+    }, 60_000);
+    it('serves the result-first path: get_latest_findings replays a seeded run (never re-runs)', async () => {
+        const conn = await connect(fixtureA);
+        try {
+            const out = await call(conn, 'get_latest_findings', { tool: 'graph' });
+            const findings = out.data;
+            expect(findings.some((f) => f.ruleId === 'graph:large-function')).toBe(true);
+            expect(out.session).toMatchObject({ tool: 'graph' });
+        }
+        finally {
+            await conn.client.close();
+        }
+    }, 60_000);
+    it('reports freshness.fresh === false after a tracked file is mutated (stale catalog)', async () => {
+        // Mutate a tracked source file → the persisted fingerprint no longer matches.
+        writeFileSync(join(fixtureA, 'index.ts'), SOURCE + '\nexport function added(): number { return 2; }\n', 'utf8');
+        const conn = await connect(fixtureA);
+        try {
+            const arch = await call(conn, 'get_architecture', {});
+            expect(arch.freshness.fresh).toBe(false);
+        }
+        finally {
+            await conn.client.close();
+        }
+        // Restore so the fixture is reusable / idempotent.
+        writeFileSync(join(fixtureA, 'index.ts'), SOURCE, 'utf8');
+    }, 60_000);
+    it('refresh_graph builds a catalog on a project that has none (adapters load under the mcp run)', async () => {
+        const conn = await connect(fixtureB);
+        try {
+            const refreshed = await call(conn, 'refresh_graph', {});
+            expect(typeof refreshed.builtAt).toBe('string');
+            expect(typeof refreshed.durationMs).toBe('number');
+            // After the rebuild, the catalog is fresh and queryable.
+            const search = await call(conn, 'search_symbols', { query: 'helper' });
+            expect(search.data.length).toBeGreaterThan(0);
+        }
+        finally {
+            await conn.client.close();
+        }
+    }, 120_000);
+    it('exits cleanly on stdin close and keeps stdout pure JSON-RPC (diagnostics on stderr)', async () => {
+        const conn = await connect(fixtureA);
+        // Every prior frame parsed by the SDK is itself proof stdout carried only
+        // JSON-RPC (a stray stdout line would break the framed parse). Diagnostics
+        // ride stderr — assert the structured start event landed there.
+        await conn.client.listTools();
+        await conn.client.close();
+        // A graceful close resolves; the child process is torn down by the transport.
+        expect(conn.stderr).toContain('mcp.server.start');
+    }, 60_000);
+});
+//# sourceMappingURL=e2e-stdio.test.js.map

package/dist/__tests__/e2e-stdio.test.js.map

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

package/dist/__tests__/freshness.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Catalog freshness mapping (Task 6.1 — Persistence/freshness).
+ *
+ * Maps the graph engine's `CatalogVerdict` to the agent-facing `Freshness` DTO,
+ * and recovers the working-tree `ValidationContext` from a catalog's recorded
+ * `filesFingerprint`. Pure verdict→DTO logic — no engine re-entry.
+ */
+export {};
+//# sourceMappingURL=freshness.test.d.ts.map