@opensip-cli/mcp 0.1.15

package/dist/__tests__/sqlite-graph-read-port.test.js

@@ -0,0 +1,322 @@
+/**
+ * `SqliteGraphReadPort` against a REAL in-memory `DataStore` (Task 6.1 steps 2,
+ * 4, 7 — ports return Result; persistence round-trip; generation snapshotting;
+ * forward-compat; no raw body in DTOs).
+ *
+ * Seeds a hand-built catalog through the graph engine's `CatalogRepo` (the same
+ * persistence path `runGraph` writes), then drives the port — no `runGraph`
+ * needed at this level. A separate suite seeds NOTHING to assert the
+ * missing-catalog ok-`fresh:false` contract.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { CatalogRepo } from '@opensip-cli/graph/internal';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { workingTreeContextFromCatalog } from '../freshness.js';
+import { SqliteGraphReadPort } from '../sqlite-graph-read-port.js';
+const BUILT_AT = '2026-05-22T00:00:00.000Z';
+/** A `FunctionOccurrence` with only the required fields set (pre-feature shape). */
+function fnOcc(over) {
+    return {
+        qualifiedName: over.simpleName,
+        line: 1,
+        column: 0,
+        endLine: 5,
+        kind: 'function-declaration',
+        params: [],
+        returnType: null,
+        enclosingClass: null,
+        decorators: [],
+        visibility: 'module-local',
+        inTestFile: false,
+        definedInGenerated: false,
+        calls: [],
+        ...over,
+    };
+}
+function makeCatalog(over = {}) {
+    return {
+        version: '3.0',
+        tool: 'graph',
+        language: 'typescript',
+        builtAt: BUILT_AT,
+        cacheKey: 'ts-5.7.3-test',
+        filesFingerprint: '0\n',
+        functions: {},
+        ...over,
+    };
+}
+/** caller→target plus two unreachable functions, for blast + dead-code + arch. */
+function seededCatalog(builtAt = BUILT_AT) {
+    return makeCatalog({
+        builtAt,
+        functions: {
+            caller: [
+                fnOcc({
+                    bodyHash: 'h-caller',
+                    simpleName: 'caller',
+                    filePath: 'src/caller.ts',
+                    line: 10,
+                    column: 2,
+                    endLine: 20,
+                    // `calls[].to` holds RESOLVED body hashes (post stage-2), not names.
+                    calls: [
+                        {
+                            to: ['h-target'],
+                            line: 12,
+                            column: 4,
+                            resolution: 'static',
+                            confidence: 'high',
+                            text: 'target()',
+                        },
+                    ],
+                }),
+            ],
+            target: [fnOcc({ bodyHash: 'h-target', simpleName: 'target', filePath: 'src/target.ts' })],
+            lonely1: [fnOcc({ bodyHash: 'h-l1', simpleName: 'lonely1', filePath: 'src/l1.ts' })],
+            lonely2: [fnOcc({ bodyHash: 'h-l2', simpleName: 'lonely2', filePath: 'src/l2.ts' })],
+        },
+    });
+}
+let store;
+beforeEach(() => {
+    store = DataStoreFactory.open({ backend: 'memory' });
+});
+afterEach(() => {
+    store.close();
+});
+function seed(catalog) {
+    new CatalogRepo(store).replaceAll(catalog);
+}
+describe('SqliteGraphReadPort — missing catalog', () => {
+    it('reports getGeneration ok with fresh:false (missing) and no auto-build', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.getGeneration();
+        expect(out.ok).toBe(true);
+        if (out.ok) {
+            expect(out.value.data).toBeUndefined();
+            expect(out.value.freshness).toEqual({ fresh: false, reason: 'missing' });
+        }
+    });
+    it('resolveSymbolId on a missing catalog is ok with undefined data (not an error)', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.resolveSymbolId('src/a.ts:1:0');
+        expect(out.ok).toBe(true);
+        expect(out.ok && out.value.data).toBeUndefined();
+    });
+    it('refresh without a rebuild provider returns a structured err', async () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = await port.refresh();
+        expect(out.ok).toBe(false);
+        expect(!out.ok && out.error.code).toBe('refresh-unavailable');
+    });
+});
+describe('SqliteGraphReadPort — seeded catalog reads', () => {
+    beforeEach(() => seed(seededCatalog()));
+    it('round-trips the catalog: getGeneration ok with the builtAt', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.getGeneration();
+        expect(out.ok && out.value.data?.builtAt).toBe(BUILT_AT);
+    });
+    it('resolves a known symbolId to a metadata-only SymbolRef (bodyHash, never a raw body)', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.resolveSymbolId('src/caller.ts:10:2');
+        expect(out.ok).toBe(true);
+        const ref = out.ok ? out.value.data : undefined;
+        expect(ref?.qualifiedName).toBe('caller');
+        expect(ref?.bodyHash).toBe('h-caller');
+        expect(ref).not.toHaveProperty('body');
+        expect(ref).not.toHaveProperty('source');
+        expect(ref).not.toHaveProperty('calls');
+    });
+    it('returns ok-undefined for an unknown symbolId', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.resolveSymbolId('src/nope.ts:99:9');
+        expect(out.ok && out.value.data).toBeUndefined();
+    });
+    it('searches symbols by case-insensitive substring and applies the limit with truncated', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const all = port.searchSymbols('lonely');
+        expect(all.ok && all.value.data.map((r) => r.qualifiedName).sort()).toEqual([
+            'lonely1',
+            'lonely2',
+        ]);
+        const capped = port.searchSymbols('lonely', { limit: 1 });
+        expect(capped.ok && capped.value.data).toHaveLength(1);
+        expect(capped.ok && capped.value.truncated).toBe(true);
+    });
+    it('findBySpan returns the occurrence whose [line, endLine] span encloses the line', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.findBySpan('src/caller.ts', 15);
+        expect(out.ok && out.value.data.map((r) => r.qualifiedName)).toEqual(['caller']);
+        const none = port.findBySpan('src/caller.ts', 99);
+        expect(none.ok && none.value.data).toHaveLength(0);
+    });
+    it('exposes caller/callee adjacency snapshots that resolve body hashes to SymbolRefs', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const callee = port.calleeGraph();
+        expect(callee.ok).toBe(true);
+        if (callee.ok) {
+            const snap = callee.value.data;
+            expect(snap.edges.get('h-caller')).toContain('h-target');
+            expect(snap.resolve('h-target')?.qualifiedName).toBe('target');
+        }
+        const caller = port.callerGraph();
+        expect(caller.ok && caller.value.data.edges.get('h-target')).toContain('h-caller');
+    });
+    it('computes blast via graph’s canonical scoring (target has one direct caller)', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.blast('src/target.ts:1:0');
+        expect(out.ok).toBe(true);
+        const dto = out.ok ? out.value.data : undefined;
+        expect(dto?.direct).toBe(1);
+        expect(dto?.symbol.qualifiedName).toBe('target');
+    });
+    it('blast on an unknown symbolId is ok with undefined data', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.blast('src/nope.ts:1:0');
+        expect(out.ok && out.value.data).toBeUndefined();
+    });
+    it('reports dead code (orphans) and honors the limit with truncated', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const all = port.deadCode();
+        expect(all.ok).toBe(true);
+        const total = all.ok ? all.value.data.length : 0;
+        expect(total).toBeGreaterThanOrEqual(2);
+        const capped = port.deadCode(1);
+        expect(capped.ok && capped.value.data).toHaveLength(1);
+        expect(capped.ok && capped.value.truncated).toBe(true);
+    });
+    it('summarizes architecture (function/edge counts, languages, hotspots)', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.architectureSummary();
+        expect(out.ok).toBe(true);
+        if (out.ok) {
+            expect(out.value.data.functionCount).toBe(4);
+            expect(out.value.data.languages).toEqual(['typescript']);
+            expect(out.value.data.edgeCount).toBeGreaterThanOrEqual(1);
+        }
+    });
+});
+describe('SqliteGraphReadPort — freshness', () => {
+    it('reports fresh:true (unverified) when no freshness context is wired', () => {
+        seed(seededCatalog());
+        const port = new SqliteGraphReadPort({ store });
+        expect(port.freshness()).toEqual({ fresh: true, builtAt: BUILT_AT });
+    });
+    it('a pre-fingerprint catalog still loads and classifies without throwing (forward-compat)', () => {
+        const { filesFingerprint, ...withoutFp } = seededCatalog();
+        void filesFingerprint;
+        seed(withoutFp);
+        // Freshness context provider returns undefined for a catalog with no fingerprint.
+        const port = new SqliteGraphReadPort({
+            store,
+            freshnessContext: workingTreeContextFromCatalog,
+        });
+        expect(() => port.freshness()).not.toThrow();
+        expect(port.freshness().fresh).toBe(true);
+        // Reads still work over the older-shaped occurrences.
+        expect(port.searchSymbols('caller').ok).toBe(true);
+    });
+});
+describe('SqliteGraphReadPort — generation snapshotting (TOCTOU-safe refresh)', () => {
+    it('an interleaved read sees the stable OLD generation until a slow refresh swaps', async () => {
+        seed(seededCatalog(BUILT_AT));
+        const NEW_BUILT_AT = '2026-06-01T00:00:00.000Z';
+        let releaseRebuild;
+        const rebuildGate = new Promise((resolve) => {
+            releaseRebuild = resolve;
+        });
+        const port = new SqliteGraphReadPort({ store, rebuild: () => rebuildGate });
+        const builtAt = () => {
+            const out = port.getGeneration();
+            return out.ok ? out.value.data?.builtAt : undefined;
+        };
+        // Pin the current generation.
+        expect(builtAt()).toBe(BUILT_AT);
+        // Start a refresh but do not let the rebuild resolve yet.
+        const refreshing = port.refresh();
+        // Mid-rebuild, reads still see the OLD generation.
+        expect(builtAt()).toBe(BUILT_AT);
+        // Let the rebuild complete; the generation swaps atomically on resolve.
+        releaseRebuild(seededCatalog(NEW_BUILT_AT));
+        const result = await refreshing;
+        expect(result.ok).toBe(true);
+        expect(builtAt()).toBe(NEW_BUILT_AT);
+    });
+});
+describe('SqliteGraphReadPort — every read degrades gracefully on a missing catalog', () => {
+    it('returns empty/undefined ok results (never throws, never auto-builds)', () => {
+        const port = new SqliteGraphReadPort({ store });
+        const search = port.searchSymbols('x');
+        expect(search.ok && search.value.data).toEqual([]);
+        const span = port.findBySpan('a.ts', 1);
+        expect(span.ok && span.value.data).toEqual([]);
+        const blast = port.blast('a.ts:1:0');
+        expect(blast.ok && blast.value.data).toBeUndefined();
+        const dead = port.deadCode();
+        expect(dead.ok && dead.value.data).toEqual([]);
+        const caller = port.callerGraph();
+        if (caller.ok) {
+            expect(caller.value.data.edges.size).toBe(0);
+            expect(caller.value.data.resolve('h')).toBeUndefined();
+        }
+        const callee = port.calleeGraph();
+        if (callee.ok)
+            expect(callee.value.data.edges.size).toBe(0);
+        const arch = port.architectureSummary();
+        expect(arch.ok && arch.value.data.functionCount).toBe(0);
+        expect(arch.ok && arch.value.freshness).toEqual({ fresh: false, reason: 'missing' });
+    });
+});
+describe('SqliteGraphReadPort — search excludes module-init occurrences', () => {
+    it('a <module-init> occurrence whose name matches the query is not returned', () => {
+        seed(makeCatalog({
+            functions: {
+                '<module-init:mod.ts>': [
+                    fnOcc({
+                        bodyHash: 'h-mod',
+                        simpleName: 'modinit-target',
+                        filePath: 'mod.ts',
+                        kind: 'module-init',
+                    }),
+                ],
+                real: [fnOcc({ bodyHash: 'h-real', simpleName: 'modinit-real', filePath: 'real.ts' })],
+            },
+        }));
+        const port = new SqliteGraphReadPort({ store });
+        const out = port.searchSymbols('modinit');
+        expect(out.ok && out.value.data.map((r) => r.qualifiedName)).toEqual(['modinit-real']);
+    });
+});
+describe('SqliteGraphReadPort — concurrent refresh serializes to one rebuild', () => {
+    it('two overlapping refresh() calls share a single in-flight build', async () => {
+        seed(seededCatalog());
+        let rebuilds = 0;
+        const port = new SqliteGraphReadPort({
+            store,
+            rebuild: async () => {
+                rebuilds += 1;
+                await Promise.resolve();
+                return seededCatalog('2026-07-01T00:00:00.000Z');
+            },
+        });
+        const [a, b] = await Promise.all([port.refresh(), port.refresh()]);
+        expect(a.ok && b.ok).toBe(true);
+        expect(rebuilds).toBe(1);
+    });
+});
+describe('persistence invariant — MCP adds no migration', () => {
+    it('no datastore migration references "mcp" (read-only server owns no schema)', () => {
+        const migrationsDir = fileURLToPath(new URL('../../../datastore/migrations', import.meta.url));
+        const sqlFiles = readdirSync(migrationsDir).filter((f) => f.endsWith('.sql'));
+        expect(sqlFiles.length).toBeGreaterThan(0);
+        for (const file of sqlFiles) {
+            const contents = readFileSync(join(migrationsDir, file), 'utf8').toLowerCase();
+            expect(contents, `${file} must not introduce an mcp-owned table`).not.toContain('mcp');
+        }
+    });
+});
+//# sourceMappingURL=sqlite-graph-read-port.test.js.map

package/dist/__tests__/sqlite-graph-read-port.test.js.map

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

package/dist/__tests__/tool-descriptor.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The `@opensip-cli/mcp` Tool descriptor + tool registration wiring (Task 6.1).
+ *
+ * Asserts the bundled tool descriptor (`mcp` identity, the single `mcp` command,
+ * the `mcp-graph-adapter` capability registrar) and that `registerMcpTools`
+ * mounts all 13 tools (9 graph + 4 result) through the server's register seam.
+ */
+export {};
+//# sourceMappingURL=tool-descriptor.test.d.ts.map

package/dist/__tests__/tool-descriptor.test.d.ts.map

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

package/dist/__tests__/tool-descriptor.test.js

@@ -0,0 +1,55 @@
+/**
+ * The `@opensip-cli/mcp` Tool descriptor + tool registration wiring (Task 6.1).
+ *
+ * Asserts the bundled tool descriptor (`mcp` identity, the single `mcp` command,
+ * the `mcp-graph-adapter` capability registrar) and that `registerMcpTools`
+ * mounts all 13 tools (9 graph + 4 result) through the server's register seam.
+ */
+import { describe, expect, it } from 'vitest';
+import { mcpTool, MCP_IDENTITY, MCP_STABLE_ID } from '../index.js';
+import { registerMcpTools } from '../tools/register.js';
+describe('mcpTool descriptor', () => {
+    it('declares the mcp identity, one command, and the graph-adapter registrar', () => {
+        expect(MCP_IDENTITY.name).toBe('mcp');
+        expect(mcpTool.identity.name).toBe('mcp');
+        expect(mcpTool.metadata.id).toBe(MCP_STABLE_ID);
+        const commands = mcpTool.commands ?? [];
+        expect(commands).toHaveLength(1);
+        expect(commands[0]?.name).toBe('mcp');
+        expect(mcpTool.extensionPoints?.capabilityRegistrars).toHaveProperty('mcp-graph-adapter');
+    });
+});
+describe('registerMcpTools', () => {
+    it('mounts all 13 MCP tools (9 graph + 4 result) on the server', () => {
+        const names = [];
+        const server = {
+            register: (name) => {
+                names.push(name);
+                return undefined;
+            },
+        };
+        const deps = {
+            graph: {},
+            results: {},
+            validToolIds: new Set(),
+        };
+        registerMcpTools(server, deps);
+        expect(names).toHaveLength(13);
+        expect(new Set(names)).toEqual(new Set([
+            'search_symbols',
+            'get_symbol',
+            'who_calls',
+            'callees_of',
+            'trace_path',
+            'blast_radius',
+            'find_dead_code',
+            'get_architecture',
+            'refresh_graph',
+            'get_agent_catalog',
+            'list_runs',
+            'show_run',
+            'get_latest_findings',
+        ]));
+    });
+});
+//# sourceMappingURL=tool-descriptor.test.js.map

package/dist/__tests__/tool-descriptor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-descriptor.test.js","sourceRoot":"","sources":["../../src/__tests__/tool-descriptor.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAOxD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG;YACb,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE;gBACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,OAAO,SAAS,CAAC;YACnB,CAAC;SAC2B,CAAC;QAC/B,MAAM,IAAI,GAAgB;YACxB,KAAK,EAAE,EAAmB;YAC1B,OAAO,EAAE,EAAqB;YAC9B,YAAY,EAAE,IAAI,GAAG,EAAE;SACxB,CAAC;QAEF,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE/B,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAC5B,IAAI,GAAG,CAAC;YACN,gBAAgB;YAChB,YAAY;YACZ,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,cAAc;YACd,gBAAgB;YAChB,kBAAkB;YAClB,eAAe;YACf,mBAAmB;YACnB,WAAW;YACX,UAAU;YACV,qBAAqB;SACtB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/catalog-generation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Immutable catalog generation (ADR-0084).
+ *
+ * The server holds EXACTLY ONE generation in memory at a time: an immutable
+ * `{ catalog, indexes, builtAt }` snapshot. Reads pin the current generation;
+ * `refresh()` builds the next and swaps the reference atomically on completion
+ * (a single synchronous assignment after the async rebuild resolves), so
+ * in-flight reads keep the old generation until the swap — TOCTOU-safe. The
+ * `Indexes` are derived per generation via the graph engine's canonical
+ * `buildIndexes`, never persisted.
+ */
+import type { Catalog, Indexes } from '@opensip-cli/graph';
+/** One immutable in-memory snapshot of the served catalog + its derived indexes. */
+export interface CatalogGeneration {
+    readonly catalog: Catalog;
+    readonly indexes: Indexes;
+    /** ISO timestamp the catalog was built at (its `builtAt`). */
+    readonly builtAt: string;
+}
+/** Derive a generation snapshot from a loaded catalog (builds adjacency once). */
+export declare function createGeneration(catalog: Catalog): CatalogGeneration;
+//# sourceMappingURL=catalog-generation.d.ts.map

package/dist/catalog-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generation.d.ts","sourceRoot":"","sources":["../src/catalog-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE3D,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAMpE"}

package/dist/catalog-generation.js

@@ -0,0 +1,21 @@
+/**
+ * Immutable catalog generation (ADR-0084).
+ *
+ * The server holds EXACTLY ONE generation in memory at a time: an immutable
+ * `{ catalog, indexes, builtAt }` snapshot. Reads pin the current generation;
+ * `refresh()` builds the next and swaps the reference atomically on completion
+ * (a single synchronous assignment after the async rebuild resolves), so
+ * in-flight reads keep the old generation until the swap — TOCTOU-safe. The
+ * `Indexes` are derived per generation via the graph engine's canonical
+ * `buildIndexes`, never persisted.
+ */
+import { buildIndexes } from '@opensip-cli/graph/internal';
+/** Derive a generation snapshot from a loaded catalog (builds adjacency once). */
+export function createGeneration(catalog) {
+    return {
+        catalog,
+        indexes: buildIndexes(catalog),
+        builtAt: catalog.builtAt,
+    };
+}
+//# sourceMappingURL=catalog-generation.js.map

package/dist/catalog-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generation.js","sourceRoot":"","sources":["../src/catalog-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO;QACL,OAAO;QACP,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/dist/command.d.ts

@@ -0,0 +1,3 @@
+import type { ToolCliContext } from '@opensip-cli/core';
+export declare const mcpCommandSpec: import("@opensip-cli/core").PrimaryCommandSpecDraft<unknown, ToolCliContext>;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIlE,eAAO,MAAM,cAAc,8EA2FzB,CAAC"}

package/dist/command.js

@@ -0,0 +1,111 @@
+/**
+ * The `opensip mcp` command (ADR-0084).
+ *
+ * A long-lived, BLOCKING stdio JSON-RPC server. `output: 'raw-stream'` +
+ * `rawStreamReason: 'mcp-stdio'` because the protocol genuinely owns stdout: an
+ * MCP client speaks JSON-RPC frames over this command's stdin/stdout for the
+ * whole serve lifetime, so the host must render NOTHING and the handler owns its
+ * entire output surface. This is the documented raw-stream escape hatch — NOT a
+ * bypass of the `SignalEnvelope`/`CommandResult` currency: there is no run
+ * verdict to render, only a transport. Every diagnostic goes to stderr (the
+ * server routes the structured logger sink there for the serve lifetime); stdout
+ * carries only JSON-RPC. See ADR-0084 and `server.ts`.
+ *
+ * The handler captures the entered `RunScope` (never `currentScope()`), opens the
+ * per-run datastore through the documented `cli.scope.datastore()` seam, builds
+ * the two read ports from it, and hands the captured scope + ports to the server
+ * — which re-enters the scope around every tool dispatch (the EventEmitter ALS
+ * fix). It resolves to a clean exit (0) when the transport closes on stdin EOF.
+ */
+import { definePrimaryCommand, readPackageVersion } from '@opensip-cli/core';
+import { runGraph } from '@opensip-cli/graph/internal';
+import { workingTreeContextFromCatalog } from './freshness.js';
+import { McpStdioServer } from './server.js';
+import { SessionResultsReadPort } from './session-results-read-port.js';
+import { SqliteGraphReadPort } from './sqlite-graph-read-port.js';
+import { registerMcpTools } from './tools/register.js';
+export const mcpCommandSpec = definePrimaryCommand({
+    description: 'Serve the OpenSIP call graph + stored results to MCP agents over stdio',
+    commonFlags: ['cwd'],
+    scope: 'project',
+    output: 'raw-stream',
+    rawStreamReason: 'mcp-stdio',
+    handler: async (_opts, cli) => {
+        // The host enters a concrete `RunScope` for the project-scoped command and
+        // hands it to tools as the narrowed `ToolScope` view; the MCP server needs
+        // the full `RunScope` — for `runWithScope` re-entry AND the `tools` registry
+        // the results port replays through — so we narrow back to the runtime type.
+        // We capture it here (NOT `currentScope()`) because the SDK's EventEmitter
+        // dispatch would lose the ambient scope inside tool handlers.
+        const scope = cli.scope;
+        // Documented per-run datastore seam (no raw `DataStore.db`, no `SessionRepo`).
+        const store = cli.scope.datastore();
+        if (store === undefined) {
+            await cli.reportFailure({
+                message: 'opensip mcp requires a project datastore, but none is available.',
+                suggestion: 'Run `opensip mcp` from inside an opensip-cli project (where `opensip init` has been run).',
+                code: 'MCP.DATASTORE_UNAVAILABLE',
+                exitCode: 2,
+                log: { evt: 'mcp.server.datastore_unavailable', level: 'error' },
+            });
+            return;
+        }
+        // Pre-build both read ports from the captured datastore (Phase 2 impls).
+        //
+        // Freshness (Task 4.4): the provider derives the working-tree
+        // `ValidationContext` from the served catalog's OWN recorded inputs
+        // (`workingTreeContextFromCatalog`) — the file set (recovered from the
+        // persisted `filesFingerprint`, in order) plus the catalog's language +
+        // cacheKey. `classifyCatalog` then re-stats those files, so a mutated/deleted
+        // tracked file flips `fresh` to false. (Newly-added files / a tsconfig change
+        // are catalog-additive and resolved by the explicit `refresh_graph` op — see
+        // the helper's doc for the precise approximation.)
+        //
+        // Rebuild (Task 4.4): `refresh_graph` runs the graph engine's programmatic
+        // build (`runGraph`) over the project root, threading the same datastore so
+        // the rebuilt catalog persists where the port reads it. v1 is the exact
+        // single-program build (no cloud egress, no live render).
+        const projectRoot = scope.projectContext?.projectRoot ?? process.cwd();
+        /**
+         * The `refresh_graph` rebuild thunk: runs the graph engine's programmatic
+         * build over the project root and returns the fresh catalog.
+         *
+         * @throws {Error} when the build discovers no source files (no catalog
+         *   produced) — surfaced to the refresh tool as an infra-boundary failure.
+         */
+        async function rebuild() {
+            const outcome = await runGraph({ cwd: projectRoot, datastore: store });
+            if (outcome.catalog === null) {
+                throw new Error('graph rebuild produced no catalog (no source files discovered).');
+            }
+            return outcome.catalog;
+        }
+        const graph = new SqliteGraphReadPort({
+            store,
+            freshnessContext: workingTreeContextFromCatalog,
+            rebuild,
+        });
+        const results = new SessionResultsReadPort({ store, tools: scope.tools });
+        const server = new McpStdioServer({
+            scope,
+            graph,
+            results,
+            version: readPackageVersion(import.meta.url),
+        });
+        // Mount the tool catalog through the server's scope-wrapping register seam.
+        // `validToolIds` lets the result tools reject an unknown `tool` argument. It
+        // must be the per-tool LAYOUT KEY (`fit`/`sim`/`graph`/`yagni`) — the key
+        // sessions are stored under and the value `sessions show --tool <k>` accepts —
+        // NOT `identity.name` (`fitness`/`simulation`), or `get_latest_findings({ tool:
+        // 'fit' })`, the headline result-first path, would be rejected as unknown.
+        const validToolIds = new Set(scope.tools.list().map((t) => t.identity.layoutKey ?? t.identity.name));
+        // `void`: registerMcpTools is synchronous (returns void); the leading `void`
+        // marks the discard explicitly so the detached-promises heuristic (which can't
+        // see cross-file sync callables) doesn't read this floating call as a promise.
+        void registerMcpTools(server, { graph, results, validToolIds });
+        // Block for the serve lifetime; resolves on stdin EOF (or graceful SIGINT).
+        await server.serve();
+        cli.setExitCode(0);
+    },
+});
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

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