@opensip-cli/mcp 0.1.15

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

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

package/dist/__tests__/freshness.test.js

@@ -0,0 +1,78 @@
+/**
+ * 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.
+ */
+import { describe, expect, it } from 'vitest';
+import { freshnessFromVerdict, missingFreshness, unverifiedFreshness, workingTreeContextFromCatalog, } from '../freshness.js';
+const BUILT_AT = '2026-05-22T00:00:00.000Z';
+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,
+    };
+}
+describe('missingFreshness', () => {
+    it('is fresh:false with reason "missing" and no builtAt', () => {
+        expect(missingFreshness()).toEqual({ fresh: false, reason: 'missing' });
+    });
+});
+describe('unverifiedFreshness', () => {
+    it('reports fresh:true with the builtAt (matches graph lookup serving the persisted catalog)', () => {
+        expect(unverifiedFreshness(BUILT_AT)).toEqual({ fresh: true, builtAt: BUILT_AT });
+    });
+});
+describe('freshnessFromVerdict', () => {
+    it('maps a valid verdict to fresh:true', () => {
+        const verdict = { kind: 'valid' };
+        expect(freshnessFromVerdict(verdict, BUILT_AT)).toEqual({ fresh: true, builtAt: BUILT_AT });
+    });
+    it('maps an incremental verdict to fresh:false with a changed-file reason', () => {
+        const verdict = {
+            kind: 'incremental',
+            changedFiles: ['a.ts', 'b.ts'],
+        };
+        const fresh = freshnessFromVerdict(verdict, BUILT_AT);
+        expect(fresh.fresh).toBe(false);
+        expect(fresh.builtAt).toBe(BUILT_AT);
+        expect(fresh.reason).toContain('2 file(s) changed');
+    });
+    it('maps an invalid verdict to fresh:false with its reason', () => {
+        const verdict = {
+            kind: 'invalid',
+            reason: 'version-mismatch',
+        };
+        const fresh = freshnessFromVerdict(verdict, BUILT_AT);
+        expect(fresh.fresh).toBe(false);
+        expect(fresh.reason).toContain('version-mismatch');
+    });
+});
+describe('workingTreeContextFromCatalog', () => {
+    it('recovers the tracked file set (in order) from the persisted fingerprint', () => {
+        const catalog = makeCatalog({
+            filesFingerprint: '2\nsrc/a.ts|111|10\nsrc/b.ts|222|20\n',
+        });
+        const ctx = workingTreeContextFromCatalog(catalog);
+        expect(ctx).toBeDefined();
+        expect(ctx?.currentFiles).toEqual(['src/a.ts', 'src/b.ts']);
+        expect(ctx?.currentLanguage).toBe('typescript');
+        expect(ctx?.currentCacheKey).toBe('ts-5.7.3-test');
+    });
+    it('returns undefined for a pre-fingerprint catalog (older build)', () => {
+        const { filesFingerprint, ...withoutFp } = makeCatalog();
+        void filesFingerprint;
+        expect(workingTreeContextFromCatalog(withoutFp)).toBeUndefined();
+    });
+    it('returns undefined when the fingerprint records zero files', () => {
+        expect(workingTreeContextFromCatalog(makeCatalog({ filesFingerprint: '0\n' }))).toBeUndefined();
+    });
+});
+//# sourceMappingURL=freshness.test.js.map

package/dist/__tests__/freshness.test.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * MCP integration (Task 6.2) — real adapter registrar + real catalog build +
+ * real read ports, in-process.
+ *
+ * Exercises the genuine capability wiring a recent core fix enables: MCP's own
+ * `registerMcpGraphAdapter` routes the bundled `graph-*` adapter into the
+ * scope-owned adapter registry (`currentAdapterRegistry()`), so `runGraph`'s
+ * `pickAdapter()` finds it under an mcp-owned run — BEFORE any `refresh_graph`.
+ * Then it builds a real catalog over a tiny TS fixture and drives the SQLite
+ * `GraphReadPort` end-to-end (search → get_symbol → who_calls → blast →
+ * dead_code), and seeds sessions to drive the session-backed `ResultsReadPort`
+ * (list → latest → show) over a real `DataStore`.
+ *
+ * The full host bootstrap (`loadOwningToolCapabilities` driving the
+ * `mcp-graph-adapter` domain from the manifest) is proven against the REAL built
+ * CLI in e2e-stdio.test.ts; this suite proves the registrar + ports in-process
+ * without coupling the package to the composition root.
+ */
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/__tests__/integration.test.d.ts.map

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

package/dist/__tests__/integration.test.js

@@ -0,0 +1,178 @@
+/**
+ * MCP integration (Task 6.2) — real adapter registrar + real catalog build +
+ * real read ports, in-process.
+ *
+ * Exercises the genuine capability wiring a recent core fix enables: MCP's own
+ * `registerMcpGraphAdapter` routes the bundled `graph-*` adapter into the
+ * scope-owned adapter registry (`currentAdapterRegistry()`), so `runGraph`'s
+ * `pickAdapter()` finds it under an mcp-owned run — BEFORE any `refresh_graph`.
+ * Then it builds a real catalog over a tiny TS fixture and drives the SQLite
+ * `GraphReadPort` end-to-end (search → get_symbol → who_calls → blast →
+ * dead_code), and seeds sessions to drive the session-backed `ResultsReadPort`
+ * (list → latest → show) over a real `DataStore`.
+ *
+ * The full host bootstrap (`loadOwningToolCapabilities` driving the
+ * `mcp-graph-adapter` domain from the manifest) is proven against the REAL built
+ * CLI in e2e-stdio.test.ts; this suite proves the registrar + ports in-process
+ * without coupling the package to the composition root.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { applyToolContributeScope, RunScope, runWithScope, runWithScopeSync, } 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 { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { workingTreeContextFromCatalog } from '../freshness.js';
+import { registerMcpGraphAdapter } from '../register-mcp-graph-adapters.js';
+import { SessionResultsReadPort } from '../session-results-read-port.js';
+import { SqliteGraphReadPort } from '../sqlite-graph-read-port.js';
+const TSCONFIG = JSON.stringify({
+    compilerOptions: {
+        target: 'ES2022',
+        module: 'Node16',
+        moduleResolution: 'Node16',
+        strict: true,
+        rootDir: '.',
+    },
+    include: ['**/*.ts'],
+});
+const SOURCE = [
+    'export function main(): number { return helper(); }',
+    'function helper(): number { return 1; }',
+    'function unused(): number { return 7; }',
+    '',
+].join('\n');
+let dir;
+let store;
+let scope;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), 'mcp-int-'));
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'tsconfig.json'), TSCONFIG, 'utf8');
+    writeFileSync(join(dir, 'index.ts'), SOURCE, 'utf8');
+    store = DataStoreFactory.open({ backend: 'memory' });
+    scope = new RunScope();
+    applyToolContributeScope(scope, graphTool);
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+    store.close();
+});
+/** Build the graph read port whose rebuild runs the real engine under the scope. */
+function buildGraphPort() {
+    const rebuild = async () => {
+        const outcome = await runWithScope(scope, () => runGraph({ cwd: dir, datastore: store }));
+        if (outcome.catalog === null)
+            throw new Error('graph build produced no catalog');
+        return outcome.catalog;
+    };
+    return new SqliteGraphReadPort({
+        store,
+        freshnessContext: workingTreeContextFromCatalog,
+        rebuild,
+    });
+}
+describe('MCP integration — adapter load + real catalog', () => {
+    it('routes the bundled graph adapter into the scope registry BEFORE a build', () => {
+        runWithScopeSync(scope, () => {
+            expect(currentAdapterRegistry().size).toBe(0);
+            registerMcpGraphAdapter(typescriptGraphAdapter);
+            expect(currentAdapterRegistry().size).toBeGreaterThan(0);
+            expect(currentAdapterRegistry().getById('typescript')).toBeDefined();
+        });
+    });
+    it('refresh_graph builds a real catalog, then the port answers structural queries', async () => {
+        runWithScopeSync(scope, () => registerMcpGraphAdapter(typescriptGraphAdapter));
+        const graph = buildGraphPort();
+        // refresh_graph: a project without a loaded catalog → build it.
+        const refreshed = await graph.refresh();
+        expect(refreshed.ok).toBe(true);
+        // search → get_symbol
+        const search = graph.searchSymbols('helper');
+        expect(search.ok).toBe(true);
+        const helperRef = search.ok
+            ? search.value.data.find((r) => r.qualifiedName.includes('helper'))
+            : undefined;
+        expect(helperRef).toBeDefined();
+        const span = graph.findBySpan(helperRef.filePath, helperRef.line);
+        expect(span.ok && span.value.data.some((r) => r.bodyHash === helperRef.bodyHash)).toBe(true);
+        // who_calls (reverse adjacency): main calls helper.
+        const callers = graph.callerGraph();
+        expect(callers.ok).toBe(true);
+        if (callers.ok) {
+            const callerHashes = callers.value.data.edges.get(helperRef.bodyHash) ?? [];
+            const callerNames = callerHashes
+                .map((h) => callers.value.data.resolve(h)?.qualifiedName ?? '')
+                .join(',');
+            expect(callerNames).toContain('main');
+        }
+        // blast: helper has at least one direct caller.
+        const blast = graph.blast(helperRef.symbolId);
+        expect(blast.ok).toBe(true);
+        expect(blast.ok && (blast.value.data?.direct ?? 0)).toBeGreaterThanOrEqual(1);
+        // dead_code: `unused` is unreachable.
+        const dead = graph.deadCode();
+        expect(dead.ok).toBe(true);
+        const deadNames = dead.ok ? dead.value.data.map((d) => d.symbol.qualifiedName) : [];
+        expect(deadNames.some((n) => n.includes('unused'))).toBe(true);
+    });
+});
+// ── session-backed ResultsReadPort over a real DataStore ─────────────
+function makeSession(over = {}) {
+    return {
+        id: 'fit-int-1',
+        tool: 'fit',
+        startedAt: '2026-05-21T12:00:00.000Z',
+        completedAt: '2026-05-21T12:00:30.000Z',
+        cwd: dir,
+        recipe: 'default',
+        score: 88,
+        passed: true,
+        durationMs: 30_000,
+        payload: { summary: { total: 1, passed: 1, failed: 0, errors: 0, warnings: 0 } },
+        ...over,
+    };
+}
+const buildStubReplay = (stored) => ({
+    result: {},
+    envelope: {
+        schemaVersion: 2,
+        tool: stored.tool,
+        runId: 'r',
+        createdAt: stored.startedAt,
+        verdict: {
+            score: stored.score,
+            passed: stored.passed,
+            summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+        },
+        units: [],
+        signals: [],
+        baselineIdentity: { fingerprintStrategyId: 'x', fingerprintStrategyVersion: 1 },
+    },
+    fidelity: 'projection',
+});
+const stubResolver = () => buildStubReplay;
+describe('MCP integration — session replay over a real DataStore', () => {
+    it('lists, replays latest, and shows a seeded run (replay only, never re-run)', async () => {
+        new SessionRepo(store).save(makeSession({ id: 'fit-int-1' }));
+        new SessionRepo(store).save(makeSession({
+            id: 'fit-int-2',
+            startedAt: '2026-05-22T00:00:00.000Z',
+            completedAt: '2026-05-22T00:00:30.000Z',
+        }));
+        const results = new SessionResultsReadPort({ store, replayFor: stubResolver });
+        const list = results.listRuns();
+        expect(list.ok && list.value.map((r) => r.id)).toEqual(['fit-int-2', 'fit-int-1']);
+        const latest = await results.latestFindings({ tool: 'fit' });
+        expect(latest.ok).toBe(true);
+        expect(latest.ok && latest.value.session?.id).toBe('fit-int-2');
+        const shown = await results.showRun({ ref: 'fit-int-1' });
+        expect(shown.ok && shown.value.session?.id).toBe('fit-int-1');
+        expect(shown.ok && shown.value.data.fidelity).toBe('projection');
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/__tests__/integration.test.js.map

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

package/dist/__tests__/register-mcp-graph-adapters.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP graph-adapter registrar (Task 6.1 step 6 — Scope).
+ *
+ * `registerMcpGraphAdapter` mirrors graph's own `registerGraphAdapter`: a routed
+ * capability contribution is registered into THIS run's scope-owned adapter
+ * registry (`scope.graph.adapters`, reached via `currentAdapterRegistry()`).
+ * Because graph's `contributeScope` runs for every bundled tool, that registry
+ * exists under `opensip mcp` even though the dispatched tool is `mcp` — the
+ * wiring a recent core fix routes through MCP's own domain.
+ */
+export {};
+//# sourceMappingURL=register-mcp-graph-adapters.test.d.ts.map

package/dist/__tests__/register-mcp-graph-adapters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-mcp-graph-adapters.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/register-mcp-graph-adapters.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/register-mcp-graph-adapters.test.js

@@ -0,0 +1,47 @@
+/**
+ * MCP graph-adapter registrar (Task 6.1 step 6 — Scope).
+ *
+ * `registerMcpGraphAdapter` mirrors graph's own `registerGraphAdapter`: a routed
+ * capability contribution is registered into THIS run's scope-owned adapter
+ * registry (`scope.graph.adapters`, reached via `currentAdapterRegistry()`).
+ * Because graph's `contributeScope` runs for every bundled tool, that registry
+ * exists under `opensip mcp` even though the dispatched tool is `mcp` — the
+ * wiring a recent core fix routes through MCP's own domain.
+ */
+import { applyToolContributeScope, RunScope, runWithScopeSync } from '@opensip-cli/core';
+import { currentAdapterRegistry, graphTool } from '@opensip-cli/graph';
+import { typescriptGraphAdapter } from '@opensip-cli/graph-typescript';
+import { describe, expect, it } from 'vitest';
+import { registerMcpGraphAdapter } from '../register-mcp-graph-adapters.js';
+/** A scope carrying graph's contributed subscope (so `scope.graph.adapters` exists). */
+function graphScope() {
+    const scope = new RunScope();
+    applyToolContributeScope(scope, graphTool);
+    return scope;
+}
+describe('registerMcpGraphAdapter', () => {
+    it('registers a routed graph adapter into the scope-owned adapter registry', () => {
+        const scope = graphScope();
+        runWithScopeSync(scope, () => {
+            expect(currentAdapterRegistry().size).toBe(0);
+            // The host routes the contribution (already shape-checked) through this registrar.
+            registerMcpGraphAdapter(typescriptGraphAdapter);
+            expect(currentAdapterRegistry().size).toBe(1);
+            expect(currentAdapterRegistry().getById('typescript')).toBeDefined();
+        });
+    });
+    it('routes through the scope active at registration time (no module singleton)', () => {
+        // A first scope gets the adapter; a second, independent scope does NOT —
+        // proving registration targets the active scope's registry, not a global.
+        const first = graphScope();
+        runWithScopeSync(first, () => registerMcpGraphAdapter(typescriptGraphAdapter));
+        const second = graphScope();
+        runWithScopeSync(second, () => {
+            expect(currentAdapterRegistry().size).toBe(0);
+        });
+        runWithScopeSync(first, () => {
+            expect(currentAdapterRegistry().size).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=register-mcp-graph-adapters.test.js.map

package/dist/__tests__/register-mcp-graph-adapters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-mcp-graph-adapters.test.js","sourceRoot":"","sources":["../../src/__tests__/register-mcp-graph-adapters.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,wFAAwF;AACxF,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC7B,wBAAwB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,mFAAmF;YACnF,uBAAuB,CAAC,sBAAsB,CAAC,CAAC;YAChD,MAAM,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,sBAAsB,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,yEAAyE;QACzE,0EAA0E;QAC1E,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAE/E,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/session-results-read-port.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `SessionResultsReadPort` against a REAL in-memory `DataStore` (Task 6.1 step 5,
+ * 7 — result-first behavior; replay only, never re-run).
+ *
+ * Sessions are seeded via `SessionRepo` (test files may import it; production MCP
+ * source never names it). The per-tool replay is injected as a deterministic
+ * fake `replayFor` — so the test exercises the port's filter mapping
+ * (severity → `errors-only`/`warnings-only`, limit → `top:N`) and provenance
+ * without depending on a specific tool's replay internals. The fake replay also
+ * proves the port REPLAYS a stored session — it never invokes a run command.
+ */
+export {};
+//# sourceMappingURL=session-results-read-port.test.d.ts.map

package/dist/__tests__/session-results-read-port.test.d.ts.map

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

package/dist/__tests__/session-results-read-port.test.js

@@ -0,0 +1,151 @@
+/**
+ * `SessionResultsReadPort` against a REAL in-memory `DataStore` (Task 6.1 step 5,
+ * 7 — result-first behavior; replay only, never re-run).
+ *
+ * Sessions are seeded via `SessionRepo` (test files may import it; production MCP
+ * source never names it). The per-tool replay is injected as a deterministic
+ * fake `replayFor` — so the test exercises the port's filter mapping
+ * (severity → `errors-only`/`warnings-only`, limit → `top:N`) and provenance
+ * without depending on a specific tool's replay internals. The fake replay also
+ * proves the port REPLAYS a stored session — it never invokes a run command.
+ */
+import { buildSignalEnvelope, } from '@opensip-cli/contracts';
+import { createSignal, HOST_VERDICT_POLICY_FALLBACK, } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { SessionRepo } from '@opensip-cli/session-store';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { SessionResultsReadPort } from '../session-results-read-port.js';
+let store;
+let replayCalls;
+beforeEach(() => {
+    store = DataStoreFactory.open({ backend: 'memory' });
+    replayCalls = [];
+});
+afterEach(() => {
+    store.close();
+});
+function makeSession(over = {}) {
+    return {
+        id: 'fit-1',
+        tool: 'fit',
+        startedAt: '2026-05-21T12:00:00.000Z',
+        completedAt: '2026-05-21T12:00:30.000Z',
+        cwd: '/proj',
+        recipe: 'default',
+        score: 80,
+        passed: false,
+        durationMs: 30_000,
+        payload: { summary: { total: 2, passed: 0, failed: 2, errors: 1, warnings: 1 } },
+        ...over,
+    };
+}
+/** A replay envelope with one error-rung + one warning-rung signal. */
+function replayEnvelope(tool) {
+    const signals = [
+        createSignal({ source: 'u', severity: 'high', ruleId: 'err-rule', message: 'an error' }),
+        createSignal({ source: 'u', severity: 'medium', ruleId: 'warn-rule', message: 'a warning' }),
+    ];
+    const envelope = buildSignalEnvelope({
+        tool,
+        runId: 'r',
+        createdAt: '2026-05-21T12:00:00.000Z',
+        units: [{ slug: 'u', passed: false, durationMs: 1 }],
+        signals,
+        policy: HOST_VERDICT_POLICY_FALLBACK,
+        runFaulted: false,
+    });
+    return { result: {}, envelope, fidelity: 'projection' };
+}
+/** Records every replayed tool (proving "no re-run") then returns its envelope. */
+const replayAndRecord = (stored) => {
+    replayCalls.push(stored.tool);
+    return replayEnvelope(stored.tool);
+};
+/** A replay resolver that records every tool it replays (proving "no re-run"). */
+const recordingResolver = () => replayAndRecord;
+function port() {
+    return new SessionResultsReadPort({ store, replayFor: recordingResolver });
+}
+describe('SessionResultsReadPort — listRuns', () => {
+    it('lists stored runs as lean RunSummary pointers (newest first)', () => {
+        new SessionRepo(store).save(makeSession({
+            id: 'a',
+            startedAt: '2026-05-01T00:00:00.000Z',
+            completedAt: '2026-05-01T00:00:00.000Z',
+        }));
+        new SessionRepo(store).save(makeSession({
+            id: 'b',
+            startedAt: '2026-05-02T00:00:00.000Z',
+            completedAt: '2026-05-02T00:00:00.000Z',
+        }));
+        const out = port().listRuns();
+        expect(out.ok).toBe(true);
+        if (out.ok) {
+            expect(out.value.map((r) => r.id)).toEqual(['b', 'a']);
+            expect(out.value[0]?.showCommand).toContain('opensip sessions show');
+        }
+    });
+    it('honors the tool filter', () => {
+        new SessionRepo(store).save(makeSession({ id: 'fit-x', tool: 'fit' }));
+        new SessionRepo(store).save(makeSession({ id: 'graph-x', tool: 'graph' }));
+        const out = port().listRuns({ tool: 'graph' });
+        expect(out.ok && out.value.map((r) => r.id)).toEqual(['graph-x']);
+    });
+});
+describe('SessionResultsReadPort — latestFindings (severity/limit → replay filters)', () => {
+    beforeEach(() => {
+        new SessionRepo(store).save(makeSession());
+    });
+    it('maps severity:errors → errors-only and returns only error-rung findings', async () => {
+        const out = await port().latestFindings({ tool: 'fit', severity: 'errors' });
+        expect(out.ok).toBe(true);
+        if (out.ok) {
+            expect(out.value.filtersApplied).toContain('errors-only');
+            expect(out.value.data.map((f) => f.ruleId)).toEqual(['err-rule']);
+        }
+        // It REPLAYED the persisted fit session — it never ran the tool.
+        expect(replayCalls).toEqual(['fit']);
+    });
+    it('maps severity:warnings → warnings-only', async () => {
+        const out = await port().latestFindings({ tool: 'fit', severity: 'warnings' });
+        expect(out.ok && out.value.filtersApplied).toContain('warnings-only');
+        expect(out.ok && out.value.data.map((f) => f.ruleId)).toEqual(['warn-rule']);
+    });
+    it('maps limit → top:N', async () => {
+        const out = await port().latestFindings({ tool: 'fit', limit: 1 });
+        expect(out.ok && out.value.filtersApplied).toContain('top:1');
+        expect(out.ok && out.value.data).toHaveLength(1);
+    });
+    it('applies no severity filter for severity:all', async () => {
+        const out = await port().latestFindings({ tool: 'fit', severity: 'all' });
+        expect(out.ok && out.value.data.map((f) => f.ruleId).sort()).toEqual(['err-rule', 'warn-rule']);
+    });
+    it('returns a structured err when no run exists for the tool', async () => {
+        const out = await port().latestFindings({ tool: 'graph' });
+        expect(out.ok).toBe(false);
+    });
+});
+describe('SessionResultsReadPort — showRun', () => {
+    it('replays a stored run by id with provenance + recommendedNext (never re-runs)', async () => {
+        new SessionRepo(store).save(makeSession({ id: 'fit-1' }));
+        const out = await port().showRun({ ref: 'fit-1' });
+        expect(out.ok).toBe(true);
+        if (out.ok) {
+            expect(out.value.data.fidelity).toBe('projection');
+            expect(out.value.session?.id).toBe('fit-1');
+            expect(out.value.recommendedNext?.rerunCommand).toBe('opensip fit');
+        }
+        expect(replayCalls).toEqual(['fit']);
+    });
+    it('returns a structured err for an unknown ref', async () => {
+        const out = await port().showRun({ ref: 'does-not-exist' });
+        expect(out.ok).toBe(false);
+    });
+});
+describe('SessionResultsReadPort — agentCatalog', () => {
+    it('returns the self-describing agent catalog', () => {
+        const out = port().agentCatalog();
+        expect(out.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=session-results-read-port.test.js.map

package/dist/__tests__/session-results-read-port.test.js.map

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

package/dist/__tests__/sqlite-graph-read-port.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `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.
+ */
+export {};
+//# sourceMappingURL=sqlite-graph-read-port.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-graph-read-port.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sqlite-graph-read-port.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}