@spikedpunch/mast 0.1.0

package/dist/mcp/tools/_helpers.d.ts

@@ -0,0 +1,26 @@
+import type { Db } from '../../graph/db.js';
+import type { ResolvedConfig } from '../../store/config.js';
+import type { AppContext } from '../context.js';
+import { type StalenessCheckResult } from '../staleness.js';
+export { collectPotentialMatches, collectPotentialMatchCandidates, type ChunkByIdSource, type PotentialMatchCandidate, type PotentialMatchCandidatesResult, type PotentialMatchesResult, } from '../../search/potential-matches.js';
+/**
+ * True when the `chunks` table has zero rows — i.e. nothing is indexed yet,
+ * whether that's a never-indexed state dir mid-background-reindex (the
+ * legitimate §7.4 startup-ladder window Part A deliberately leaves alone) or
+ * a genuinely empty corpus. Every read tool with a primary result array
+ * calls this ONLY on its empty-result path (`ast/types.ts`'s `index_empty`
+ * field) to distinguish "empty because nothing indexed" from "empty because
+ * no match" — never called when results were found, so a populated index
+ * pays nothing extra per call.
+ */
+export declare function isIndexEmpty(ctx: AppContext): Promise<boolean>;
+/** Extract the first JSDoc comment block from chunk content, if present. */
+export declare function extractDoc(content: string): string | null;
+export { globToRegex } from '../../indexer/walker.js';
+/**
+ * Look up the stored mtime for `filePath` from the `files` table and run a JIT
+ * single-file re-parse if the disk version is newer. Returns `{ busy: false,
+ * refreshed: false }` when the file is not yet indexed.
+ */
+export declare function jitRefreshFile(db: Db, config: ResolvedConfig, filePath: string): Promise<StalenessCheckResult>;
+//# sourceMappingURL=_helpers.d.ts.map

package/dist/mcp/tools/_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AASpF,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,GAC5B,MAAM,mCAAmC,CAAC;AAM3C;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAID,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAQ/B"}

package/dist/mcp/tools/_helpers.js

@@ -0,0 +1,54 @@
+import { checkAndRefreshIfStale } from '../staleness.js';
+// collectPotentialMatches/collectPotentialMatchCandidates moved to
+// search/potential-matches.ts (Stage 1.2) so the `mast index --checker` pass
+// (graph/checker-resolver.ts) can share the exact same "what counts as a
+// potential match" definition without an mcp/tools → graph layering
+// inversion — `search` already sits between `graph`/`store` and their
+// consumers. Re-exported here so mast_callers/mast_rename_impact's existing
+// `from './_helpers.js'` imports keep working unchanged.
+export { collectPotentialMatches, collectPotentialMatchCandidates, } from '../../search/potential-matches.js';
+// ---------------------------------------------------------------------------
+// M6 Part B (eval/GITNEXUS_COMPARISON.md §13.8 item 4): empty-index signal.
+// ---------------------------------------------------------------------------
+/**
+ * True when the `chunks` table has zero rows — i.e. nothing is indexed yet,
+ * whether that's a never-indexed state dir mid-background-reindex (the
+ * legitimate §7.4 startup-ladder window Part A deliberately leaves alone) or
+ * a genuinely empty corpus. Every read tool with a primary result array
+ * calls this ONLY on its empty-result path (`ast/types.ts`'s `index_empty`
+ * field) to distinguish "empty because nothing indexed" from "empty because
+ * no match" — never called when results were found, so a populated index
+ * pays nothing extra per call.
+ */
+export async function isIndexEmpty(ctx) {
+    return (await ctx.chunkStore.chunkCount()) === 0;
+}
+/** Extract the first JSDoc comment block from chunk content, if present. */
+export function extractDoc(content) {
+    const match = /\/\*\*([\s\S]*?)\*\//.exec(content);
+    return match != null ? match[0].trim() : null;
+}
+// globToRegex moved to indexer/walker.ts (file-discovery domain) so watch mode
+// can use it without an indexer → mcp dependency; re-exported for existing users.
+export { globToRegex } from '../../indexer/walker.js';
+/**
+ * Look up the stored mtime for `filePath` from the `files` table and run a JIT
+ * single-file re-parse if the disk version is newer. Returns `{ busy: false,
+ * refreshed: false }` when the file is not yet indexed.
+ */
+export async function jitRefreshFile(db, config, filePath) {
+    const row = await db
+        .selectFrom('files')
+        .select('mtime')
+        .where('path', '=', filePath)
+        .executeTakeFirst();
+    if (row === undefined)
+        return { busy: false, refreshed: false };
+    return checkAndRefreshIfStale(db, config, filePath, row.mtime);
+}
+// countStaleFiles removed 2026-08-20 (D035). It enumerated the `files` table,
+// so a file on disk that was never indexed was in no row and therefore
+// invisible to it — `mast_status` reported a fresh index while `mast status`
+// reported the same index stale. Freshness now has one producer for both
+// surfaces: `indexer/freshness.ts` `measureFreshness`.
+//# sourceMappingURL=_helpers.js.map

package/dist/mcp/tools/_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../../src/mcp/tools/_helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAA6B,MAAM,iBAAiB,CAAC;AAEpF,mEAAmE;AACnE,6EAA6E;AAC7E,yEAAyE;AACzE,oEAAoE;AACpE,sEAAsE;AACtE,4EAA4E;AAC5E,yDAAyD;AACzD,OAAO,EACL,uBAAuB,EACvB,+BAA+B,GAKhC,MAAM,mCAAmC,CAAC;AAE3C,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAe;IAChD,OAAO,CAAC,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,+EAA+E;AAC/E,kFAAkF;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAM,EACN,MAAsB,EACtB,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,EAAE;SACjB,UAAU,CAAC,OAAO,CAAC;SACnB,MAAM,CAAC,OAAO,CAAC;SACf,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC;SAC5B,gBAAgB,EAAE,CAAC;IACtB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAChE,OAAO,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,uEAAuE;AACvE,6EAA6E;AAC7E,yEAAyE;AACzE,uDAAuD"}

package/dist/mcp/tools/callers.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+export declare function registerCallersTool(server: McpServer, ctx: AppContext): void;
+//# sourceMappingURL=callers.d.ts.map

package/dist/mcp/tools/callers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callers.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/callers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAYhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CA2H5E"}

package/dist/mcp/tools/callers.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { buildToolStats, recordToolCall, buildArgsJson, buildResultsJson } from '../../telemetry/metrics.js';
+import { countTokens, estimateFullFileBound } from '../../telemetry/tokenizer.js';
+import { querySymbolByName, queryVerifiedCallers } from '../../graph/queries.js';
+import { jitRefreshFile, collectPotentialMatches, isIndexEmpty } from './_helpers.js';
+export function registerCallersTool(server, ctx) {
+    server.tool('mast_callers', 'Call sites of a named symbol, partitioned into verified (graph-resolved) and potential (identifier-FTS) sets. Always check both sets — the graph only covers statically-linked call sites. Verified entries with resolution "checker" were proven by the opt-in `mast index --checker` TypeScript pass; the same pass drops non-call-site / wrong-declaration noise out of potential_matches (summary.checker_classified_* report how many).', {
+        symbol: z.string().describe('Symbol name whose callers to find'),
+        file_path: z.string().nullable().optional().describe('File that defines the symbol (disambiguates overloaded names)'),
+        transitive: z.boolean().optional().describe('Follow callers-of-callers recursively via POTENTIAL_CALL edges (verified set only)'),
+        include_potential: z.boolean().optional().describe('Include identifier-FTS matches as potential_matches (default: true)'),
+    }, async (args) => {
+        const start = Date.now();
+        const filePath = args.file_path ?? null;
+        // §9.0 TOCTOU policy. This JITs the file that DECLARES the symbol (not
+        // each caller's file — see CallersResponse.file_busy_returning_stale_cache
+        // for why that puts the flag at the envelope, not per-VerifiedCaller).
+        let fileBusy = false;
+        if (filePath != null) {
+            const r = await jitRefreshFile(ctx.db, ctx.config, filePath);
+            fileBusy = r.busy;
+        }
+        const symbols = await querySymbolByName(ctx.db, args.symbol, filePath ?? undefined);
+        if (symbols.length === 0) {
+            const noSymbolFiles = filePath != null ? [filePath] : [];
+            // M6 (§13.8 item 4): both sets are unconditionally empty on this
+            // branch (no symbol to look up callers of), so the only question is
+            // whether the index itself is empty.
+            const indexEmptyField = await isIndexEmpty(ctx) ? { index_empty: true } : {};
+            const response = {
+                verified_callers: [],
+                potential_matches: [],
+                // §9.0 TOCTOU policy: omitted when false, never present-and-false.
+                ...(fileBusy ? { file_busy_returning_stale_cache: true } : {}),
+                ...indexEmptyField,
+                summary: {
+                    verified_count: 0,
+                    potential_count: 0,
+                    transitive: args.transitive ?? false,
+                    checker_classified_non_call_site: 0,
+                    checker_classified_different_declaration: 0,
+                },
+                _stats: buildToolStats('mast_callers', 0, estimateFullFileBound(noSymbolFiles, ctx.config.resolved_project_root), noSymbolFiles, Date.now() - start),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+        }
+        // Use the first symbol (querySymbolByName orders by exported-first, then path).
+        const target = symbols[0];
+        const verifiedRows = await queryVerifiedCallers(ctx.db, target.id, args.transitive ?? false);
+        const verified_callers = verifiedRows.map((r) => ({
+            file_path: r.file_path,
+            line: r.line,
+            caller_symbol: r.caller_symbol,
+            context: r.context,
+            resolution: r.resolution,
+        }));
+        let potential_matches = [];
+        let checkerClassifiedNonCallSite = 0;
+        let checkerClassifiedDifferentDeclaration = 0;
+        let potentialTruncated;
+        if (args.include_potential !== false) {
+            const potentialResult = await collectPotentialMatches(ctx.db, ctx.chunkStore, target.id, args.symbol, verified_callers);
+            potential_matches = potentialResult.matches;
+            checkerClassifiedNonCallSite = potentialResult.checkerClassifiedNonCallSite;
+            checkerClassifiedDifferentDeclaration = potentialResult.checkerClassifiedDifferentDeclaration;
+            potentialTruncated = potentialResult.truncatedMatchCount;
+        }
+        const filesReferenced = [
+            ...new Set([
+                ...verified_callers.map((c) => c.file_path),
+                ...potential_matches.map((m) => m.file_path),
+            ]),
+        ];
+        const text = JSON.stringify({ verified_callers, potential_matches });
+        const tokens = countTokens(text);
+        const tokensFullFileBound = estimateFullFileBound(filesReferenced, ctx.config.resolved_project_root);
+        const durationMs = Date.now() - start;
+        // M6 (§13.8 item 4): checked ONLY when BOTH sets came back empty.
+        const indexEmptyField = verified_callers.length === 0 && potential_matches.length === 0 && await isIndexEmpty(ctx)
+            ? { index_empty: true }
+            : {};
+        const response = {
+            verified_callers,
+            potential_matches,
+            // §9.0 TOCTOU policy: omitted when false, never present-and-false.
+            ...(fileBusy ? { file_busy_returning_stale_cache: true } : {}),
+            ...indexEmptyField,
+            summary: {
+                verified_count: verified_callers.length,
+                potential_count: potential_matches.length,
+                transitive: args.transitive ?? false,
+                checker_classified_non_call_site: checkerClassifiedNonCallSite,
+                checker_classified_different_declaration: checkerClassifiedDifferentDeclaration,
+                // F10: omitted-when-false — present only when the identifier-FTS cap was hit.
+                ...(potentialTruncated !== undefined ? { potential_truncated: potentialTruncated } : {}),
+            },
+            _stats: buildToolStats('mast_callers', tokens, tokensFullFileBound, filesReferenced, durationMs),
+        };
+        const resultIdentities = [
+            ...verified_callers.map((c) => ({ file_path: c.file_path, symbol_name: c.caller_symbol })),
+            ...potential_matches.map((m) => ({ file_path: m.file_path, symbol_name: m.context || null })),
+        ];
+        void recordToolCall(ctx.db, {
+            toolName: 'mast_callers', tokensReturned: tokens, tokensFullFileBound,
+            durationMs, sessionId: ctx.sessionId, status: 'ok',
+            argsJson: buildArgsJson(args),
+            resultsJson: buildResultsJson(resultIdentities),
+        }).catch(() => { });
+        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+    });
+}
+//# sourceMappingURL=callers.js.map

package/dist/mcp/tools/callers.js.map

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

package/dist/mcp/tools/dependencies.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+export declare function registerDependenciesTool(server: McpServer, ctx: AppContext): void;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/mcp/tools/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAsCjF"}

package/dist/mcp/tools/dependencies.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { buildToolStats, recordToolCall } from '../../telemetry/metrics.js';
+import { countTokens, estimateFullFileBound } from '../../telemetry/tokenizer.js';
+import { queryDependencies } from '../../graph/queries.js';
+import { jitRefreshFile, isIndexEmpty } from './_helpers.js';
+export function registerDependenciesTool(server, ctx) {
+    server.tool('mast_dependencies', 'All imports for a file — what it depends on, whether each dependency is external or internal, and the resolved path for monorepo imports.', {
+        file_path: z.string().describe('Path to the file, relative to the project root'),
+    }, async (args) => {
+        const start = Date.now();
+        const { busy } = await jitRefreshFile(ctx.db, ctx.config, args.file_path);
+        const imports = await queryDependencies(ctx.db, args.file_path);
+        const text = JSON.stringify(imports);
+        const tokens = countTokens(text);
+        const tokensFullFileBound = estimateFullFileBound([args.file_path], ctx.config.resolved_project_root);
+        const durationMs = Date.now() - start;
+        // M6 (§13.8 item 4): checked ONLY on the empty-result path.
+        const indexEmptyField = imports.length === 0 && await isIndexEmpty(ctx)
+            ? { index_empty: true }
+            : {};
+        const response = {
+            file_path: args.file_path,
+            imports,
+            // §9.0 TOCTOU policy: omitted when false, never present-and-false.
+            ...(busy ? { file_busy_returning_stale_cache: true } : {}),
+            ...indexEmptyField,
+            _stats: buildToolStats('mast_dependencies', tokens, tokensFullFileBound, [args.file_path], durationMs),
+        };
+        void recordToolCall(ctx.db, {
+            toolName: 'mast_dependencies', tokensReturned: tokens, tokensFullFileBound,
+            durationMs, sessionId: ctx.sessionId, status: 'ok',
+        }).catch(() => { });
+        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+    });
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/mcp/tools/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/mcp/tools/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,GAAe;IACzE,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,2IAA2I,EAC3I;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KACjF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAE1E,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACtG,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEtC,4DAA4D;QAC5D,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,YAAY,CAAC,GAAG,CAAC;YACrE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAa,EAAE;YAChC,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,QAAQ,GAAyB;YACrC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO;YACP,mEAAmE;YACnE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,+BAA+B,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,eAAe;YAClB,MAAM,EAAE,cAAc,CAAC,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;SACvG,CAAC;QACF,KAAK,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE;YAC1B,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB;YAC1E,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI;SACnD,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IAClF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/efficiency.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+export declare function registerEfficiencyTool(server: McpServer, ctx: AppContext): void;
+//# sourceMappingURL=efficiency.d.ts.map

package/dist/mcp/tools/efficiency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"efficiency.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/efficiency.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAmD/E"}

package/dist/mcp/tools/efficiency.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { queryMetricsSummary, querySessionSummary } from '../../telemetry/metrics.js';
+import { TOKENIZER_LABEL } from '../../telemetry/tokenizer.js';
+export function registerEfficiencyTool(server, ctx) {
+    server.tool('mast_efficiency', 'Token savings report: how many tokens MAST returned vs. how many a naive full-file read would have cost, for this session or globally.', {
+        scope: z.enum(['session', 'global']).describe('"session" = current MCP session only; "global" = all-time from metrics DB'),
+        since_minutes: z.number().int().min(1).optional().describe('Only include calls within the last N minutes (global scope only)'),
+    }, async (args) => {
+        const rows = args.scope === 'session'
+            ? await querySessionSummary(ctx.db, ctx.sessionId)
+            : await queryMetricsSummary(ctx.db, args.since_minutes !== undefined
+                ? Date.now() - args.since_minutes * 60_000
+                : 0);
+        const tokensReturned = rows.reduce((s, r) => s + r.tokens_returned_total, 0);
+        const tokensFullFile = rows.reduce((s, r) => s + r.tokens_full_file_total, 0);
+        const callsTotal = rows.reduce((s, r) => s + r.calls, 0);
+        const callsByTool = Object.fromEntries(rows.map((r) => [r.tool_name, r.calls]));
+        const efficiencyRatio = tokensFullFile > 0 ? 1 - tokensReturned / tokensFullFile : 0;
+        const saved = tokensFullFile - tokensReturned;
+        const windowStartedAt = args.scope === 'global' && args.since_minutes !== undefined
+            ? new Date(Date.now() - args.since_minutes * 60_000).toISOString()
+            : new Date(0).toISOString();
+        const result = {
+            scope: args.scope,
+            window_started_at: windowStartedAt,
+            tokens_returned: tokensReturned,
+            tokens_full_file_upper_bound: tokensFullFile,
+            efficiency_ratio: efficiencyRatio,
+            calls_total: callsTotal,
+            calls_by_tool: callsByTool,
+            tokenizer: TOKENIZER_LABEL,
+            counterfactual: tokensFullFile > 0
+                ? `Would have cost ~${tokensFullFile} tokens with naive full-file reads; saved ~${saved} tokens (${(efficiencyRatio * 100).toFixed(1)}%).`
+                : 'No tool calls recorded yet.',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+}
+//# sourceMappingURL=efficiency.js.map

package/dist/mcp/tools/efficiency.js.map

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

package/dist/mcp/tools/exports.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+export declare function registerExportsTool(server: McpServer, ctx: AppContext): void;
+//# sourceMappingURL=exports.d.ts.map

package/dist/mcp/tools/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/exports.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CA8D5E"}

package/dist/mcp/tools/exports.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { join } from 'node:path';
+import { buildToolStats, recordToolCall, buildArgsJson, buildResultsJson } from '../../telemetry/metrics.js';
+import { countTokens, estimateFullFileBound } from '../../telemetry/tokenizer.js';
+import { extractFileSignatures } from '../../ast/extract.js';
+import { extractDoc, jitRefreshFile, isIndexEmpty } from './_helpers.js';
+export function registerExportsTool(server, ctx) {
+    server.tool('mast_exports', 'All exported symbols from a single file with type signatures. No function bodies. Use to answer "what does this file expose?" before deciding whether to open it.', {
+        file_path: z.string().describe('Path to the file, relative to the project root'),
+    }, async (args) => {
+        const start = Date.now();
+        const { busy } = await jitRefreshFile(ctx.db, ctx.config, args.file_path);
+        const chunks = await ctx.chunkStore.getChunksByFilePath(args.file_path);
+        // Body-free signatures (params/return stripped of bodies, §10.2), keyed
+        // by symbol name. Falls back to chunk content if a symbol isn't found.
+        const sigs = extractFileSignatures(join(ctx.config.resolved_project_root, args.file_path));
+        const sigByName = new Map(sigs.map((s) => [s.name, s]));
+        // Methods surface through their class_shell — omit them here.
+        const topLevel = chunks.filter((c) => c.is_exported && c.chunk_type !== 'method');
+        const exports = topLevel.map((c) => {
+            const sig = c.symbol_name !== null ? sigByName.get(c.symbol_name) : undefined;
+            return {
+                name: c.symbol_name ?? '',
+                kind: c.chunk_type === 'class_shell' ? 'class' : c.chunk_type,
+                signature: sig?.signature ?? c.content,
+                line: c.start_line,
+                doc: sig?.doc ?? extractDoc(c.content),
+            };
+        });
+        const text = JSON.stringify(exports);
+        const tokens = countTokens(text);
+        const tokensFullFileBound = estimateFullFileBound([args.file_path], ctx.config.resolved_project_root);
+        const durationMs = Date.now() - start;
+        // M6 (§13.8 item 4): checked ONLY on the empty-result path.
+        const indexEmptyField = exports.length === 0 && await isIndexEmpty(ctx)
+            ? { index_empty: true }
+            : {};
+        const response = {
+            file_path: args.file_path,
+            exports,
+            // §9.0 TOCTOU policy: omitted when false, never present-and-false.
+            ...(busy ? { file_busy_returning_stale_cache: true } : {}),
+            ...indexEmptyField,
+            _stats: buildToolStats('mast_exports', tokens, tokensFullFileBound, [args.file_path], durationMs),
+        };
+        const resultIdentities = exports.map((e) => ({ file_path: args.file_path, symbol_name: e.name }));
+        void recordToolCall(ctx.db, {
+            toolName: 'mast_exports', tokensReturned: tokens, tokensFullFileBound,
+            durationMs, sessionId: ctx.sessionId, status: 'ok',
+            argsJson: buildArgsJson(args),
+            resultsJson: buildResultsJson(resultIdentities),
+        }).catch(() => { });
+        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+    });
+}
+//# sourceMappingURL=exports.js.map

package/dist/mcp/tools/exports.js.map

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

package/dist/mcp/tools/implementors.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+export declare function registerImplementorsTool(server: McpServer, ctx: AppContext): void;
+//# sourceMappingURL=implementors.d.ts.map

package/dist/mcp/tools/implementors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementors.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/implementors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQhD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CA+CjF"}

package/dist/mcp/tools/implementors.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { buildToolStats, recordToolCall } from '../../telemetry/metrics.js';
+import { countTokens, estimateFullFileBound } from '../../telemetry/tokenizer.js';
+import { queryImplementors } from '../../graph/queries.js';
+import { findStaleFiles } from '../staleness.js';
+import { isIndexEmpty } from './_helpers.js';
+export function registerImplementorsTool(server, ctx) {
+    server.tool('mast_implementors', 'All classes that implement a named interface, with the list of methods each class provides.', {
+        interface_name: z.string().describe('Name of the interface to find implementors of'),
+    }, async (args) => {
+        const start = Date.now();
+        const results = await queryImplementors(ctx.db, args.interface_name);
+        const filesReferenced = [...new Set(results.map((r) => r.file_path))];
+        // F7/C1: stat-and-flag, not JIT refresh — surfaced as `stale`, not
+        // `file_busy_returning_stale_cache` (that name is reserved for the
+        // JIT-refresh tools, where a refresh is actually attempted). See
+        // staleness.ts's `findStaleFiles` WHY-comment. Flag before token
+        // counting so `_stats.tokens_returned` reflects the payload actually
+        // returned.
+        const staleFiles = await findStaleFiles(ctx.db, ctx.config, filesReferenced);
+        const flaggedResults = staleFiles.size === 0
+            ? results
+            : results.map((r) => ({
+                ...r,
+                ...(staleFiles.has(r.file_path) ? { stale: true } : {}),
+            }));
+        const text = JSON.stringify(flaggedResults);
+        const tokens = countTokens(text);
+        const tokensFullFileBound = estimateFullFileBound(filesReferenced, ctx.config.resolved_project_root);
+        const durationMs = Date.now() - start;
+        // M6 (§13.8 item 4): checked ONLY on the empty-result path.
+        const indexEmptyField = flaggedResults.length === 0 && await isIndexEmpty(ctx)
+            ? { index_empty: true }
+            : {};
+        const response = {
+            results: flaggedResults,
+            ...indexEmptyField,
+            _stats: buildToolStats('mast_implementors', tokens, tokensFullFileBound, filesReferenced, durationMs),
+        };
+        void recordToolCall(ctx.db, {
+            toolName: 'mast_implementors', tokensReturned: tokens, tokensFullFileBound,
+            durationMs, sessionId: ctx.sessionId, status: 'ok',
+        }).catch(() => { });
+        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+    });
+}
+//# sourceMappingURL=implementors.js.map

package/dist/mcp/tools/implementors.js.map

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

package/dist/mcp/tools/project-skeleton.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+export declare function registerProjectSkeletonTool(server: McpServer, ctx: AppContext): void;
+//# sourceMappingURL=project-skeleton.d.ts.map

package/dist/mcp/tools/project-skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-skeleton.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/project-skeleton.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAkEpF"}

package/dist/mcp/tools/project-skeleton.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { buildToolStats, recordToolCall } from '../../telemetry/metrics.js';
+import { countTokens, estimateFullFileBound } from '../../telemetry/tokenizer.js';
+import { queryProjectSkeleton } from '../../graph/queries.js';
+import { globToRegex, isIndexEmpty } from './_helpers.js';
+export function registerProjectSkeletonTool(server, ctx) {
+    server.tool('mast_project_skeleton', 'All file paths in the project with their exported top-level symbol names. Returns names only — no signatures or bodies. Use early in a task for architectural orientation.', {
+        directory: z.string().nullable().optional().describe('Scope to a subtree of the project (e.g. "api/services/auth")'),
+        max_depth: z.number().int().min(1).optional().describe('Max directory depth relative to `directory` (default: unlimited)'),
+        file_pattern: z.string().nullable().optional().describe('Glob to further restrict files returned'),
+    }, async (args) => {
+        const start = Date.now();
+        const directory = args.directory ?? undefined;
+        let rows = await queryProjectSkeleton(ctx.db, directory);
+        if (args.max_depth != null && directory != null) {
+            const prefix = directory.endsWith('/') ? directory : `${directory}/`;
+            rows = rows.filter((r) => {
+                const rel = r.file_path.startsWith(prefix)
+                    ? r.file_path.slice(prefix.length)
+                    : r.file_path.slice(directory.length).replace(/^\//, '');
+                const depth = (rel.match(/\//g) ?? []).length;
+                return depth < args.max_depth;
+            });
+        }
+        if (args.file_pattern != null) {
+            const rx = globToRegex(args.file_pattern);
+            rows = rows.filter((r) => rx.test(r.file_path));
+        }
+        // Group by file_path, preserving declaration order.
+        const fileMap = new Map();
+        for (const row of rows) {
+            const symbols = fileMap.get(row.file_path) ?? [];
+            symbols.push(row.symbol_name);
+            fileMap.set(row.file_path, symbols);
+        }
+        const files = [...fileMap.entries()].map(([file_path, exports]) => ({
+            file_path,
+            exports,
+        }));
+        const text = JSON.stringify(files);
+        const tokens = countTokens(text);
+        const durationMs = Date.now() - start;
+        const filesReferenced = files.map((f) => f.file_path);
+        const tokensFullFileBound = estimateFullFileBound(filesReferenced, ctx.config.resolved_project_root);
+        // M6 (§13.8 item 4): checked ONLY on the empty-result path.
+        const indexEmptyField = files.length === 0 && await isIndexEmpty(ctx)
+            ? { index_empty: true }
+            : {};
+        const response = {
+            files,
+            ...indexEmptyField,
+            _stats: buildToolStats('mast_project_skeleton', tokens, tokensFullFileBound, filesReferenced, durationMs),
+        };
+        void recordToolCall(ctx.db, {
+            toolName: 'mast_project_skeleton', tokensReturned: tokens, tokensFullFileBound,
+            durationMs, sessionId: ctx.sessionId, status: 'ok',
+        }).catch(() => { });
+        return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+    });
+}
+//# sourceMappingURL=project-skeleton.js.map

package/dist/mcp/tools/project-skeleton.js.map

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

package/dist/mcp/tools/reindex.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppContext } from '../context.js';
+import type { ReindexResult } from '../../ast/types.js';
+import { type IndexResult } from '../../indexer/index.js';
+export declare function registerReindexTool(server: McpServer, ctx: AppContext): void;
+/**
+ * Map the indexer's internal `IndexResult` to the wire `ReindexResult` DTO.
+ * Exported so the mapping's VALUES — not just the presence of `write_errors`
+ * on the type — are unit-tested directly (§14.6: shape-only assertions have
+ * hidden exactly this class of bug before), without needing to drive a real
+ * chunk-store failure through the MCP transport.
+ */
+export declare function toReindexResult(result: IndexResult): ReindexResult;
+//# sourceMappingURL=reindex.d.ts.map

package/dist/mcp/tools/reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/reindex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAc5E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAYlE"}

package/dist/mcp/tools/reindex.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { runIndex } from '../../indexer/index.js';
+export function registerReindexTool(server, ctx) {
+    server.tool('mast_reindex', 'Synchronously reindex changed files. Call this immediately after writing files so subsequent queries see your changes. Incremental by default — only re-parses files whose mtime changed.', {
+        full: z.boolean().optional().describe('Force a full reindex of all files (slow; use only after large structural changes)'),
+    }, async (args) => {
+        const result = await runIndex(ctx.config, { incremental: !(args.full ?? false) });
+        const reindexResult = toReindexResult(result);
+        return { content: [{ type: 'text', text: JSON.stringify(reindexResult) }] };
+    });
+}
+/**
+ * Map the indexer's internal `IndexResult` to the wire `ReindexResult` DTO.
+ * Exported so the mapping's VALUES — not just the presence of `write_errors`
+ * on the type — are unit-tested directly (§14.6: shape-only assertions have
+ * hidden exactly this class of bug before), without needing to drive a real
+ * chunk-store failure through the MCP transport.
+ */
+export function toReindexResult(result) {
+    return {
+        files_indexed: result.filesIndexed,
+        files_skipped: result.filesSkipped,
+        chunks_added: result.chunksAdded,
+        chunks_removed: result.chunksRemoved,
+        parse_errors: result.parseErrors,
+        write_errors: result.writeErrors,
+        stale_write_rejections: result.staleWriteRejections,
+        miscased_imports: result.miscasedImports.count,
+        duration_ms: result.durationMs,
+    };
+}
+//# sourceMappingURL=reindex.js.map