@opensip-cli/mcp 0.1.15

package/dist/tools/__tests__/refresh-graph.test.js

@@ -0,0 +1,100 @@
+/**
+ * `refresh_graph` handler — observability (Task 6.1 step 5, §Observability).
+ *
+ * Asserts the rebuild-latency metric is recorded on the shared meter with
+ * BOUNDED-cardinality labels only (`{ command, op, outcome }` — never a path /
+ * symbol / id), via an in-memory meter provider; and that the handler logs its
+ * decision points (`mcp.refresh.run.ok` / `.error`) through the structured
+ * logger (the stderr sink during serve — never stdout).
+ */
+import { err, logger, ok } from '@opensip-cli/core';
+import { metrics } from '@opentelemetry/api';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { registerRefreshGraph } from '../refresh-graph.js';
+const recorded = [];
+/** Install a minimal in-memory meter provider that captures every histogram record. */
+function installFakeMeter() {
+    recorded.length = 0;
+    metrics.disable();
+    const provider = {
+        getMeter: () => ({
+            createHistogram: (name) => ({
+                record: (value, attributes) => recorded.push({ name, value, attributes: attributes ?? {} }),
+            }),
+        }),
+    };
+    metrics.setGlobalMeterProvider(provider);
+}
+function captureServer() {
+    const handlers = new Map();
+    const server = {
+        register: (name, _config, cb) => {
+            handlers.set(name, cb);
+            return undefined;
+        },
+    };
+    return { handlers, server };
+}
+const FRESH = { fresh: true, builtAt: '2026-05-22T00:00:00.000Z' };
+function gen() {
+    return { data: { builtAt: FRESH.builtAt ?? '' }, freshness: FRESH };
+}
+function fakeGraph(refresh) {
+    return {
+        refresh,
+        freshness: () => FRESH,
+    };
+}
+function deps(graph) {
+    return { graph, results: {}, validToolIds: new Set() };
+}
+beforeEach(() => {
+    installFakeMeter();
+});
+afterEach(() => {
+    metrics.disable();
+    vi.restoreAllMocks();
+});
+describe('refresh_graph observability', () => {
+    it('records rebuild latency with bounded { command, op, outcome:ok } labels and logs the ok decision point', async () => {
+        const info = vi.spyOn(logger, 'info').mockImplementation(() => undefined);
+        const { server, handlers } = captureServer();
+        registerRefreshGraph(server, deps(fakeGraph(() => Promise.resolve(ok(gen())))));
+        const result = await handlers.get('refresh_graph')({});
+        const body = JSON.parse(result.content[0]?.type === 'text' ? result.content[0].text : '{}');
+        expect(body.builtAt).toBe(FRESH.builtAt);
+        expect(typeof body.durationMs).toBe('number');
+        expect(recorded).toHaveLength(1);
+        expect(recorded[0]?.name).toBe('opensip_cli.mcp.refresh.duration_ms');
+        // Bounded cardinality: EXACTLY these three label keys, no path/symbol/id.
+        expect(recorded[0]?.attributes).toEqual({ command: 'mcp', op: 'refresh', outcome: 'ok' });
+        expect(info).toHaveBeenCalledWith(expect.objectContaining({ evt: 'mcp.refresh.run.ok', module: 'mcp:refresh' }));
+    });
+    it('records outcome:error and logs the error decision point when refresh returns an err', async () => {
+        const error = vi.spyOn(logger, 'error').mockImplementation(() => undefined);
+        const { server, handlers } = captureServer();
+        registerRefreshGraph(server, deps(fakeGraph(() => Promise.resolve(err({ code: 'refresh-unavailable', message: 'not wired' })))));
+        const result = await handlers.get('refresh_graph')({});
+        expect(result.isError).toBe(true);
+        expect(recorded[0]?.attributes.outcome).toBe('error');
+        expect(error).toHaveBeenCalledWith(expect.objectContaining({ evt: 'mcp.refresh.run.error', code: 'refresh-unavailable' }));
+    });
+    it('records outcome:error and re-throws when the rebuild throws at the infra boundary', async () => {
+        const error = vi.spyOn(logger, 'error').mockImplementation(() => undefined);
+        const { server, handlers } = captureServer();
+        registerRefreshGraph(server, deps(fakeGraph(() => Promise.reject(new Error('child build blew up')))));
+        await expect(handlers.get('refresh_graph')({})).rejects.toThrow('child build blew up');
+        expect(recorded[0]?.attributes.outcome).toBe('error');
+        expect(error).toHaveBeenCalledWith(expect.objectContaining({ evt: 'mcp.refresh.run.error' }));
+    });
+    it('coerces a non-Error throwable in the error log (records outcome:error, re-throws)', async () => {
+        vi.spyOn(logger, 'error').mockImplementation(() => undefined);
+        const { server, handlers } = captureServer();
+        registerRefreshGraph(server, 
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- deliberately a non-Error throwable to exercise the String(error) coercion branch
+        deps(fakeGraph(() => Promise.reject('bare string failure'))));
+        await expect(handlers.get('refresh_graph')({})).rejects.toBe('bare string failure');
+        expect(recorded[0]?.attributes.outcome).toBe('error');
+    });
+});
+//# sourceMappingURL=refresh-graph.test.js.map

package/dist/tools/__tests__/refresh-graph.test.js.map

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

package/dist/tools/__tests__/result-handlers.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Result/history tool handlers vs. a FAKE `ResultsReadPort` (Task 6.1 step 5).
+ *
+ * The result tools replay persisted sessions only — they NEVER re-run a tool.
+ * Asserts each handler forwards its args to the port, validates `tool` against
+ * the live registry (unknown → structured error), and surfaces the err arm.
+ */
+export {};
+//# sourceMappingURL=result-handlers.test.d.ts.map

package/dist/tools/__tests__/result-handlers.test.d.ts.map

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

package/dist/tools/__tests__/result-handlers.test.js

@@ -0,0 +1,194 @@
+/**
+ * Result/history tool handlers vs. a FAKE `ResultsReadPort` (Task 6.1 step 5).
+ *
+ * The result tools replay persisted sessions only — they NEVER re-run a tool.
+ * Asserts each handler forwards its args to the port, validates `tool` against
+ * the live registry (unknown → structured error), and surfaces the err arm.
+ */
+import { err, ok } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { registerGetAgentCatalog } from '../get-agent-catalog.js';
+import { registerGetLatestFindings } from '../get-latest-findings.js';
+import { registerListRuns } from '../list-runs.js';
+import { registerShowRun } from '../show-run.js';
+function captureServer() {
+    const handlers = new Map();
+    const server = {
+        register: (name, _config, cb) => {
+            handlers.set(name, cb);
+            return undefined;
+        },
+    };
+    return { handlers, server };
+}
+function parseResult(result) {
+    const first = result.content[0];
+    const text = first?.type === 'text' ? first.text : '';
+    return { isError: result.isError === true, body: JSON.parse(text) };
+}
+function fakeResults(over) {
+    const base = {
+        agentCatalog: () => ok({ commands: [] }),
+        listRuns: () => ok([]),
+        showRun: () => Promise.resolve(err({ code: 'x', message: 'x' })),
+        latestFindings: () => Promise.resolve(err({ code: 'x', message: 'x' })),
+    };
+    return { ...base, ...over };
+}
+function deps(results, validToolIds = new Set(['fit', 'graph'])) {
+    return { graph: {}, results, validToolIds };
+}
+// ── get_latest_findings ──────────────────────────────────────────────
+describe('get_latest_findings handler', () => {
+    it('forwards tool/severity/limit to the port and returns the replay', async () => {
+        let seen;
+        const replay = {
+            data: [{ ruleId: 'r', message: 'm', severity: 'high' }],
+            filtersApplied: ['errors-only', 'top:3'],
+        };
+        const { server, handlers } = captureServer();
+        registerGetLatestFindings(server, deps(fakeResults({
+            latestFindings: (opts) => {
+                seen = opts;
+                return Promise.resolve(ok(replay));
+            },
+        })));
+        const out = parseResult(await handlers.get('get_latest_findings')({
+            tool: 'fit',
+            severity: 'errors',
+            limit: 3,
+        }));
+        expect(seen).toEqual({ tool: 'fit', severity: 'errors', limit: 3 });
+        expect(out.body.data[0]?.ruleId).toBe('r');
+        expect(out.body.filtersApplied).toEqual(['errors-only', 'top:3']);
+    });
+    it('rejects an unknown tool with a structured unknown-tool error (no port call)', async () => {
+        let called = false;
+        const { server, handlers } = captureServer();
+        registerGetLatestFindings(server, deps(fakeResults({
+            latestFindings: () => {
+                called = true;
+                return Promise.resolve(ok({ data: [] }));
+            },
+        })));
+        const out = parseResult(await handlers.get('get_latest_findings')({ tool: 'nope' }));
+        expect(out.isError).toBe(true);
+        expect(out.body.error.code).toBe('unknown-tool');
+        expect(called).toBe(false);
+    });
+    it('surfaces the port err arm', async () => {
+        const { server, handlers } = captureServer();
+        registerGetLatestFindings(server, deps(fakeResults({
+            latestFindings: () => Promise.resolve(err({ code: 'not-found', message: 'no runs' })),
+        })));
+        const out = parseResult(await handlers.get('get_latest_findings')({ tool: 'fit' }));
+        expect(out.isError).toBe(true);
+        expect(out.body.error.code).toBe('not-found');
+    });
+});
+// ── list_runs ────────────────────────────────────────────────────────
+describe('list_runs handler', () => {
+    it('forwards tool/limit/summaryOnly and wraps rows under { runs }', () => {
+        let seen;
+        const row = {
+            id: 's1',
+            tool: 'fit',
+            startedAt: 't',
+            completedAt: 't',
+            score: 90,
+            passed: true,
+            showCommand: 'opensip sessions show s1 --json',
+        };
+        const { server, handlers } = captureServer();
+        registerListRuns(server, deps(fakeResults({
+            listRuns: (opts) => {
+                seen = opts;
+                return ok([row]);
+            },
+        })));
+        const out = parseResult(handlers.get('list_runs')({ tool: 'fit', limit: 10, summaryOnly: true }));
+        expect(seen).toEqual({ tool: 'fit', limit: 10, summaryOnly: true });
+        expect(out.body.runs[0]?.id).toBe('s1');
+    });
+    it('lists with no arguments (all optional filters omitted)', () => {
+        let seen;
+        const { server, handlers } = captureServer();
+        registerListRuns(server, deps(fakeResults({
+            listRuns: (opts) => {
+                seen = opts;
+                return ok([]);
+            },
+        })));
+        const out = parseResult(handlers.get('list_runs')({}));
+        expect(out.isError).toBe(false);
+        expect(seen).toEqual({});
+    });
+    it('rejects an unknown tool filter, naming "(none registered)" when no tools exist', () => {
+        const { server, handlers } = captureServer();
+        registerListRuns(server, deps(fakeResults({ listRuns: () => ok([]) }), new Set()));
+        const out = parseResult(handlers.get('list_runs')({ tool: 'nope' }));
+        expect(out.isError).toBe(true);
+        expect(out.body.error.message).toContain('(none registered)');
+    });
+    it('surfaces a listRuns port error', () => {
+        const { server, handlers } = captureServer();
+        registerListRuns(server, deps(fakeResults({ listRuns: () => err({ code: 'boom', message: 'x' }) })));
+        const out = parseResult(handlers.get('list_runs')({}));
+        expect(out.isError).toBe(true);
+    });
+});
+// ── show_run ─────────────────────────────────────────────────────────
+describe('show_run handler', () => {
+    it('forwards ref/tool/filters/raw to the port', async () => {
+        let seen;
+        const { server, handlers } = captureServer();
+        registerShowRun(server, deps(fakeResults({
+            showRun: (opts) => {
+                seen = opts;
+                return Promise.resolve(ok({
+                    data: { fidelity: 'projection' },
+                }));
+            },
+        })));
+        await handlers.get('show_run')({
+            ref: 'latest',
+            tool: 'fit',
+            filters: ['errors-only'],
+            raw: true,
+        });
+        expect(seen).toEqual({ ref: 'latest', tool: 'fit', filters: ['errors-only'], raw: true });
+    });
+    it('rejects an unknown tool sanity-check', async () => {
+        const { server, handlers } = captureServer();
+        registerShowRun(server, deps(fakeResults({})));
+        const out = parseResult(await handlers.get('show_run')({ ref: 'latest', tool: 'nope' }));
+        expect(out.isError).toBe(true);
+        expect(out.body.error.code).toBe('unknown-tool');
+    });
+    it('surfaces a not-found err arm', async () => {
+        const { server, handlers } = captureServer();
+        registerShowRun(server, deps(fakeResults({
+            showRun: () => Promise.resolve(err({ code: 'not-found', message: 'no session' })),
+        })));
+        const out = parseResult(await handlers.get('show_run')({ ref: 'nope' }));
+        expect(out.isError).toBe(true);
+        expect(out.body.error.code).toBe('not-found');
+    });
+});
+// ── get_agent_catalog ────────────────────────────────────────────────
+describe('get_agent_catalog handler', () => {
+    it('returns the agent catalog', () => {
+        const { server, handlers } = captureServer();
+        registerGetAgentCatalog(server, deps(fakeResults({ agentCatalog: () => ok({ commands: ['fit'] }) })));
+        const out = parseResult(handlers.get('get_agent_catalog')({}));
+        expect(out.isError).toBe(false);
+        expect(out.body.commands).toEqual(['fit']);
+    });
+    it('surfaces an err arm', () => {
+        const { server, handlers } = captureServer();
+        registerGetAgentCatalog(server, deps(fakeResults({ agentCatalog: () => err({ code: 'boom', message: 'x' }) })));
+        const out = parseResult(handlers.get('get_agent_catalog')({}));
+        expect(out.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=result-handlers.test.js.map

package/dist/tools/__tests__/result-handlers.test.js.map

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

package/dist/tools/__tests__/schemas.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Per-tool Zod boundary schemas (Task 6.1 §Hardening).
+ *
+ * Every MCP tool argument is validated by these field schemas BEFORE the handler
+ * runs, so hostile input is rejected at the trust boundary and never reaches a
+ * port: a malformed `symbolId`, a `..`-traversal / absolute `file`, an over-long
+ * `query`, and out-of-range `depth`/`limit`.
+ */
+export {};
+//# sourceMappingURL=schemas.test.d.ts.map

package/dist/tools/__tests__/schemas.test.d.ts.map

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

package/dist/tools/__tests__/schemas.test.js

@@ -0,0 +1,73 @@
+/**
+ * Per-tool Zod boundary schemas (Task 6.1 §Hardening).
+ *
+ * Every MCP tool argument is validated by these field schemas BEFORE the handler
+ * runs, so hostile input is rejected at the trust boundary and never reaches a
+ * port: a malformed `symbolId`, a `..`-traversal / absolute `file`, an over-long
+ * `query`, and out-of-range `depth`/`limit`.
+ */
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_DEPTH, MAX_DEPTH, MAX_LIMIT, MAX_QUERY_LEN, depth, filePath, limit, query, symbolId, } from '../schemas.js';
+describe('symbolId schema', () => {
+    it('accepts the canonical "<filePath>:<line>:<column>" shape', () => {
+        expect(symbolId().safeParse('packages/core/src/a.ts:12:4').success).toBe(true);
+    });
+    it('rejects a bare name (no line:col)', () => {
+        expect(symbolId().safeParse('saveBaseline').success).toBe(false);
+    });
+    it('rejects a malformed id whose trailing groups are not integers', () => {
+        expect(symbolId().safeParse('a.ts:12:x').success).toBe(false);
+        expect(symbolId().safeParse('a.ts:line:col').success).toBe(false);
+    });
+});
+describe('filePath schema', () => {
+    it('accepts a project-relative path', () => {
+        expect(filePath().safeParse('packages/core/src/a.ts').success).toBe(true);
+    });
+    it('rejects an absolute POSIX path', () => {
+        expect(filePath().safeParse('/etc/passwd').success).toBe(false);
+    });
+    it('rejects a Windows drive-absolute path', () => {
+        expect(filePath().safeParse('C:\\windows\\system32').success).toBe(false);
+    });
+    it('rejects a ".." traversal escaping the project root', () => {
+        expect(filePath().safeParse('../../etc/passwd').success).toBe(false);
+        expect(filePath().safeParse('src/../../secret').success).toBe(false);
+    });
+});
+describe('query schema', () => {
+    it('accepts a normal search term', () => {
+        expect(query().safeParse('saveBaseline').success).toBe(true);
+    });
+    it('rejects an over-long (potential ReDoS-payload) query', () => {
+        expect(query().safeParse('x'.repeat(MAX_QUERY_LEN + 1)).success).toBe(false);
+    });
+    it('rejects an empty query', () => {
+        expect(query().safeParse('').success).toBe(false);
+    });
+});
+describe('depth schema', () => {
+    it('defaults to DEFAULT_DEPTH when omitted', () => {
+        const parsed = depth().safeParse(undefined);
+        expect(parsed.success).toBe(true);
+        expect(parsed.success && parsed.data).toBe(DEFAULT_DEPTH);
+    });
+    it('rejects a depth above the maximum (not silently clamped through here)', () => {
+        expect(depth().safeParse(MAX_DEPTH + 1).success).toBe(false);
+    });
+    it('rejects a zero / negative depth', () => {
+        expect(depth().safeParse(0).success).toBe(false);
+    });
+});
+describe('limit schema', () => {
+    it('rejects a limit above MAX_LIMIT', () => {
+        expect(limit().safeParse(MAX_LIMIT + 1).success).toBe(false);
+    });
+    it('accepts the maximum limit', () => {
+        expect(limit().safeParse(MAX_LIMIT).success).toBe(true);
+    });
+    it('is optional', () => {
+        expect(limit().safeParse(undefined).success).toBe(true);
+    });
+});
+//# sourceMappingURL=schemas.test.js.map

package/dist/tools/__tests__/schemas.test.js.map

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

package/dist/tools/blast-radius.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `blast_radius` — change-impact score for a symbol (ADR-0084, Task 4.3).
+ *
+ * Delegates to `graphPort.blast()`, which reuses graph's single canonical
+ * `buildFeatures(['blast'])` scoring site — so the numbers never diverge from
+ * `opensip graph`. NOT a re-implemented BFS. Returns `{ data, freshness }` with
+ * direct/transitive caller counts + the composite score.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerBlastRadius(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=blast-radius.d.ts.map

package/dist/tools/blast-radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast-radius.d.ts","sourceRoot":"","sources":["../../src/tools/blast-radius.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA4BnF"}

package/dist/tools/blast-radius.js

@@ -0,0 +1,33 @@
+/**
+ * `blast_radius` — change-impact score for a symbol (ADR-0084, Task 4.3).
+ *
+ * Delegates to `graphPort.blast()`, which reuses graph's single canonical
+ * `buildFeatures(['blast'])` scoring site — so the numbers never diverge from
+ * `opensip graph`. NOT a re-implemented BFS. Returns `{ data, freshness }` with
+ * direct/transitive caller counts + the composite score.
+ */
+import { symbolId as symbolIdSchema } from './schemas.js';
+import { errorResult, failure, jsonResult } from './tool-result.js';
+export function registerBlastRadius(server, deps) {
+    server.register('blast_radius', {
+        title: 'Blast radius of a symbol',
+        description: 'Change-impact score for a symbol: direct (depth-1) callers, transitive callers, and a ' +
+            'composite blast score (direct + 0.5×transitive) — the same scoring `opensip graph` ' +
+            'uses. Pass a symbolId from search_symbols/get_symbol.',
+        inputSchema: {
+            symbolId: symbolIdSchema(),
+        },
+    }, ({ symbolId }) => {
+        const outcome = deps.graph.blast(symbolId);
+        if (!outcome.ok)
+            return errorResult(outcome.error);
+        const { data, freshness } = outcome.value;
+        if (data === undefined) {
+            return failure('blast-unavailable', freshness.fresh
+                ? `No blast score for symbolId "${symbolId}" — check the id via search_symbols/get_symbol.`
+                : 'The catalog is stale/missing — run refresh_graph, then retry.');
+        }
+        return jsonResult({ data, freshness });
+    });
+}
+//# sourceMappingURL=blast-radius.js.map

package/dist/tools/blast-radius.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast-radius.js","sourceRoot":"","sources":["../../src/tools/blast-radius.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKpE,MAAM,UAAU,mBAAmB,CAAC,MAAsB,EAAE,IAAiB;IAC3E,MAAM,CAAC,QAAQ,CACb,cAAc,EACd;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,wFAAwF;YACxF,qFAAqF;YACrF,uDAAuD;QACzD,WAAW,EAAE;YACX,QAAQ,EAAE,cAAc,EAAE;SAC3B;KACF,EACD,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,OAAO,CACZ,mBAAmB,EACnB,SAAS,CAAC,KAAK;gBACb,CAAC,CAAC,gCAAgC,QAAQ,iDAAiD;gBAC3F,CAAC,CAAC,+DAA+D,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/call-walk-tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared registration for bounded call-graph walk tools.
+ *
+ * `who_calls` and `callees_of` differ only by metadata and adjacency direction;
+ * resolving `symbolId`, enforcing the bounded BFS, freshness propagation, and
+ * `truncated` shaping belong in one implementation.
+ */
+import type { GraphReadPort } from '../graph-read-port.js';
+import type { McpStdioServer } from '../server.js';
+export interface CallWalkToolSpec {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly graph: (port: GraphReadPort) => ReturnType<GraphReadPort['callerGraph']>;
+}
+export declare function registerCallWalkTool(server: McpStdioServer, graphPort: GraphReadPort, spec: CallWalkToolSpec): void;
+//# sourceMappingURL=call-walk-tool.d.ts.map

package/dist/tools/call-walk-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-walk-tool.d.ts","sourceRoot":"","sources":["../../src/tools/call-walk-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;CACnF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAoCN"}

package/dist/tools/call-walk-tool.js

@@ -0,0 +1,46 @@
+/**
+ * Shared registration for bounded call-graph walk tools.
+ *
+ * `who_calls` and `callees_of` differ only by metadata and adjacency direction;
+ * resolving `symbolId`, enforcing the bounded BFS, freshness propagation, and
+ * `truncated` shaping belong in one implementation.
+ */
+import { boundedBfs, MAX_WALK_NODES } from './graph-walk.js';
+import { depth as depthSchema, symbolId as symbolIdSchema } from './schemas.js';
+import { errorResult, failure, jsonResult } from './tool-result.js';
+export function registerCallWalkTool(server, graphPort, spec) {
+    server.register(spec.name, {
+        title: spec.title,
+        description: spec.description,
+        inputSchema: {
+            symbolId: symbolIdSchema(),
+            depth: depthSchema(),
+        },
+    }, ({ symbolId, depth }) => {
+        const resolved = graphPort.resolveSymbolId(symbolId);
+        if (!resolved.ok)
+            return errorResult(resolved.error);
+        const startRef = resolved.value.data;
+        if (startRef === undefined) {
+            return failure('symbol-not-found', `Unknown symbolId "${symbolId}". Obtain a valid symbolId from search_symbols or get_symbol.`);
+        }
+        const graph = spec.graph(graphPort);
+        if (!graph.ok)
+            return errorResult(graph.error);
+        const { data: snapshot, freshness } = graph.value;
+        const walk = boundedBfs(snapshot.edges, startRef.bodyHash, {
+            depth,
+            cap: MAX_WALK_NODES,
+        });
+        const data = walk.order.map((hash) => snapshot.resolve(hash)).filter(isSymbolRef);
+        return jsonResult({
+            data,
+            freshness,
+            ...(walk.truncated ? { truncated: true } : {}),
+        });
+    });
+}
+function isSymbolRef(ref) {
+    return ref !== undefined;
+}
+//# sourceMappingURL=call-walk-tool.js.map

package/dist/tools/call-walk-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-walk-tool.js","sourceRoot":"","sources":["../../src/tools/call-walk-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAapE,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,SAAwB,EACxB,IAAsB;IAEtB,MAAM,CAAC,QAAQ,CACb,IAAI,CAAC,IAAI,EACT;QACE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE;YACX,QAAQ,EAAE,cAAc,EAAE;YAC1B,KAAK,EAAE,WAAW,EAAE;SACrB;KACF,EACD,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACtB,MAAM,QAAQ,GAAG,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CACZ,kBAAkB,EAClB,qBAAqB,QAAQ,+DAA+D,CAC7F,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE;YACzD,KAAK;YACL,GAAG,EAAE,cAAc;SACpB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClF,OAAO,UAAU,CAAC;YAChB,IAAI;YACJ,SAAS;YACT,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAA0B;IAC7C,OAAO,GAAG,KAAK,SAAS,CAAC;AAC3B,CAAC"}

package/dist/tools/callees-of.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `callees_of` — bounded forward call walk (ADR-0084, Task 4.2).
+ *
+ * The forward twin of `who_calls`: resolves `symbolId` via the port, then runs
+ * the shared {@link boundedBfs} over the forward-call adjacency snapshot. Same
+ * bounds (depth default 5, max 5; node cap → `truncated`) and same
+ * `{ data, freshness, truncated? }` envelope.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerCalleesOf(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=callees-of.d.ts.map

package/dist/tools/callees-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callees-of.d.ts","sourceRoot":"","sources":["../../src/tools/callees-of.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAUjF"}

package/dist/tools/callees-of.js

@@ -0,0 +1,20 @@
+/**
+ * `callees_of` — bounded forward call walk (ADR-0084, Task 4.2).
+ *
+ * The forward twin of `who_calls`: resolves `symbolId` via the port, then runs
+ * the shared {@link boundedBfs} over the forward-call adjacency snapshot. Same
+ * bounds (depth default 5, max 5; node cap → `truncated`) and same
+ * `{ data, freshness, truncated? }` envelope.
+ */
+import { registerCallWalkTool } from './call-walk-tool.js';
+export function registerCalleesOf(server, deps) {
+    registerCallWalkTool(server, deps.graph, {
+        name: 'callees_of',
+        title: 'Callees of a symbol',
+        description: 'Find the symbols a symbol calls (forward call graph), out to `depth` levels (default 5, ' +
+            'max 5). Pass a symbolId from search_symbols/get_symbol. Edges are body-hash-union ' +
+            '(twin-aware). Large fan-out is node-capped with truncated:true.',
+        graph: (port) => port.calleeGraph(),
+    });
+}
+//# sourceMappingURL=callees-of.js.map

package/dist/tools/callees-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callees-of.js","sourceRoot":"","sources":["../../src/tools/callees-of.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,UAAU,iBAAiB,CAAC,MAAsB,EAAE,IAAiB;IACzE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE;QACvC,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,0FAA0F;YAC1F,oFAAoF;YACpF,iEAAiE;QACnE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/find-dead-code.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `find_dead_code` — orphan (unreachable) symbols (ADR-0084, Task 4.3).
+ *
+ * Delegates to `graphPort.deadCode()`, backed by graph's `orphan-subtree` rule
+ * (reachability from entry points) — NOT ad-hoc filesystem reachability. Returns
+ * the `{ data, freshness, truncated? }` envelope; `limit` caps the result.
+ */
+import type { McpToolDeps } from './types.js';
+import type { McpStdioServer } from '../server.js';
+export declare function registerFindDeadCode(server: McpStdioServer, deps: McpToolDeps): void;
+//# sourceMappingURL=find-dead-code.d.ts.map

package/dist/tools/find-dead-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-dead-code.d.ts","sourceRoot":"","sources":["../../src/tools/find-dead-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAmBpF"}