@flyingrobots/graft 0.4.0 → 0.6.0

package/dist/mcp/tools/map.js

@@ -0,0 +1,154 @@
+import * as path from "node:path";
+import { z } from "zod";
+import { extractOutline } from "../../parser/outline.js";
+import { detectLang } from "../../parser/lang.js";
+import { GitFileQuery, listGitFiles } from "./git-files.js";
+import { evaluateMcpRefusal } from "../policy.js";
+import { collectSymbols, normalizeRepoPath } from "./precision.js";
+/** Maximum files before auto-truncation to summary-only mode. */
+export const MAX_MAP_FILES = 100;
+/** Maximum response bytes before auto-truncation to summary-only mode. */
+export const MAX_MAP_BYTES = 50_000;
+class StructuralMapRequest {
+    directory;
+    constructor(args, projectRoot) {
+        const rawPath = args["path"];
+        if (rawPath !== undefined && typeof rawPath !== "string") {
+            throw new Error("StructuralMapRequest: path must be a string when provided");
+        }
+        this.directory = rawPath !== undefined && rawPath.trim().length > 0
+            ? normalizeRepoPath(projectRoot, rawPath)
+            : ".";
+        Object.freeze(this);
+    }
+    toGitFileQuery(projectRoot) {
+        return GitFileQuery.project(projectRoot, this.directory === "." ? "" : this.directory);
+    }
+}
+class StructuralMapSymbol {
+    name;
+    kind;
+    signature;
+    exported;
+    startLine;
+    endLine;
+    constructor(opts) {
+        this.name = opts.name;
+        this.kind = opts.kind;
+        this.exported = opts.exported;
+        if (opts.signature !== undefined)
+            this.signature = opts.signature;
+        if (opts.startLine !== undefined)
+            this.startLine = opts.startLine;
+        if (opts.endLine !== undefined)
+            this.endLine = opts.endLine;
+        Object.freeze(this);
+    }
+}
+class StructuralMapFile {
+    path;
+    lang;
+    symbols;
+    constructor(opts) {
+        this.path = opts.path;
+        this.lang = opts.lang;
+        this.symbols = Object.freeze([...opts.symbols]);
+        Object.freeze(this);
+    }
+}
+export const mapTool = {
+    name: "graft_map",
+    description: "Structural map of a directory — all files and their symbols " +
+        "(function signatures, class shapes, exports) in one call. " +
+        "Uses tree-sitter to parse the working tree directly.",
+    schema: {
+        path: z.string().optional(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            const request = new StructuralMapRequest(args, ctx.projectRoot);
+            // Budget gate: if the session budget is exhausted, return summary-only.
+            const budget = ctx.governor.getBudget();
+            if (budget !== null && budget.remaining <= 0) {
+                const filePaths = (await listGitFiles(request.toGitFileQuery(ctx.projectRoot), ctx.git)).paths;
+                return ctx.respond("graft_map", {
+                    directory: request.directory,
+                    files: [],
+                    summary: `${String(filePaths.length)} files (budget exhausted — summary only)`,
+                    truncated: true,
+                    truncatedReason: "BUDGET_EXHAUSTED",
+                });
+            }
+            const filePaths = (await listGitFiles(request.toGitFileQuery(ctx.projectRoot), ctx.git)).paths;
+            const files = [];
+            const refused = [];
+            for (const filePath of filePaths) {
+                let content;
+                try {
+                    content = await ctx.fs.readFile(path.join(ctx.projectRoot, filePath), "utf-8");
+                }
+                catch {
+                    continue;
+                }
+                const actual = {
+                    lines: content.split("\n").length,
+                    bytes: Buffer.byteLength(content),
+                };
+                const refusal = evaluateMcpRefusal(ctx, filePath, actual);
+                if (refusal !== null) {
+                    refused.push(refusal);
+                    continue;
+                }
+                const lang = detectLang(filePath);
+                if (lang === null)
+                    continue;
+                const result = extractOutline(content, lang);
+                const symbols = collectSymbols(result.entries, filePath, result.jumpTable ?? []).map((symbol) => new StructuralMapSymbol({
+                    name: symbol.name,
+                    kind: symbol.kind,
+                    exported: symbol.exported,
+                    ...(symbol.signature !== undefined ? { signature: symbol.signature } : {}),
+                    ...(symbol.startLine !== undefined ? { startLine: symbol.startLine } : {}),
+                    ...(symbol.endLine !== undefined ? { endLine: symbol.endLine } : {}),
+                }));
+                files.push(new StructuralMapFile({ path: filePath, lang, symbols }));
+            }
+            files.sort((a, b) => a.path.localeCompare(b.path));
+            const totalFiles = files.length;
+            const totalSymbols = files.reduce((n, f) => n + f.symbols.length, 0);
+            // Size gate: if the result exceeds limits, switch to summary-only.
+            const serialized = JSON.stringify(files);
+            const responseBytes = Buffer.byteLength(serialized);
+            if (totalFiles > MAX_MAP_FILES || responseBytes > MAX_MAP_BYTES) {
+                // Build per-language file counts for the summary.
+                const langCounts = new Map();
+                for (const f of files) {
+                    langCounts.set(f.lang, (langCounts.get(f.lang) ?? 0) + 1);
+                }
+                const langBreakdown = [...langCounts.entries()]
+                    .sort((a, b) => b[1] - a[1])
+                    .map(([lang, count]) => `${lang}: ${String(count)}`)
+                    .join(", ");
+                return ctx.respond("graft_map", {
+                    directory: request.directory,
+                    files: [],
+                    ...(refused.length > 0 ? { refused } : {}),
+                    summary: `${String(totalFiles)} files, ${String(totalSymbols)} symbols (${langBreakdown})`,
+                    truncated: true,
+                    truncatedReason: "OUTPUT_LIMIT",
+                    next: [
+                        "Narrow the path argument to a specific subdirectory",
+                        `Current: ${String(totalFiles)} files, ${String(Math.round(responseBytes / 1024))}KB — limit: ${String(MAX_MAP_FILES)} files / ${String(Math.round(MAX_MAP_BYTES / 1024))}KB`,
+                    ],
+                });
+            }
+            return ctx.respond("graft_map", {
+                directory: request.directory,
+                files,
+                ...(refused.length > 0 ? { refused } : {}),
+                summary: `${String(files.length)} files, ${String(totalSymbols)} symbols`,
+            });
+        };
+    },
+};
+//# sourceMappingURL=map.js.map

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

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

package/dist/mcp/tools/monitor-pause.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../context.js";
+export declare const monitorPauseTool: ToolDefinition;
+//# sourceMappingURL=monitor-pause.d.ts.map

package/dist/mcp/tools/monitor-pause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-pause.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-pause.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,gBAAgB,EAAE,cAc9B,CAAC"}

package/dist/mcp/tools/monitor-pause.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export const monitorPauseTool = {
+    name: "monitor_pause",
+    description: "Pause the repo-scoped background index monitor for an authorized workspace.",
+    schema: {
+        cwd: z.string(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            return ctx.respond("monitor_pause", { ...await ctx.pauseMonitor({
+                    cwd: args["cwd"],
+                }) });
+        };
+    },
+};
+//# sourceMappingURL=monitor-pause.js.map

package/dist/mcp/tools/monitor-pause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-pause.js","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-pause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,6EAA6E;IAC/E,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC;oBAC9D,GAAG,EAAE,IAAI,CAAC,KAAK,CAAW;iBAC3B,CAAC,EAAE,CAAC,CAAC;QACR,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/monitor-resume.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../context.js";
+export declare const monitorResumeTool: ToolDefinition;
+//# sourceMappingURL=monitor-resume.d.ts.map

package/dist/mcp/tools/monitor-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-resume.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-resume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE,cAc/B,CAAC"}

package/dist/mcp/tools/monitor-resume.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export const monitorResumeTool = {
+    name: "monitor_resume",
+    description: "Resume a paused repo-scoped background index monitor for an authorized workspace.",
+    schema: {
+        cwd: z.string(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            return ctx.respond("monitor_resume", { ...await ctx.resumeMonitor({
+                    cwd: args["cwd"],
+                }) });
+        };
+    },
+};
+//# sourceMappingURL=monitor-resume.js.map

package/dist/mcp/tools/monitor-resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-resume.js","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,mFAAmF;IACrF,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;oBAChE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAW;iBAC3B,CAAC,EAAE,CAAC,CAAC;QACR,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/monitor-start.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../context.js";
+export declare const monitorStartTool: ToolDefinition;
+//# sourceMappingURL=monitor-start.d.ts.map

package/dist/mcp/tools/monitor-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-start.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-start.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,gBAAgB,EAAE,cAgB9B,CAAC"}

package/dist/mcp/tools/monitor-start.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export const monitorStartTool = {
+    name: "monitor_start",
+    description: "Start or resume the repo-scoped background index monitor for an authorized workspace.",
+    schema: {
+        cwd: z.string(),
+        pollIntervalMs: z.number().int().positive().optional(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            return ctx.respond("monitor_start", { ...await ctx.startMonitor({
+                    cwd: args["cwd"],
+                    pollIntervalMs: args["pollIntervalMs"],
+                }) });
+        };
+    },
+};
+//# sourceMappingURL=monitor-start.js.map

package/dist/mcp/tools/monitor-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-start.js","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,uFAAuF;IACzF,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACvD;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC;oBAC9D,GAAG,EAAE,IAAI,CAAC,KAAK,CAAW;oBAC1B,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAuB;iBAC7D,CAAC,EAAE,CAAC,CAAC;QACR,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/monitor-stop.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../context.js";
+export declare const monitorStopTool: ToolDefinition;
+//# sourceMappingURL=monitor-stop.d.ts.map

package/dist/mcp/tools/monitor-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-stop.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-stop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,eAAe,EAAE,cAc7B,CAAC"}

package/dist/mcp/tools/monitor-stop.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export const monitorStopTool = {
+    name: "monitor_stop",
+    description: "Stop the repo-scoped background index monitor for an authorized workspace.",
+    schema: {
+        cwd: z.string(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            return ctx.respond("monitor_stop", { ...await ctx.stopMonitor({
+                    cwd: args["cwd"],
+                }) });
+        };
+    },
+};
+//# sourceMappingURL=monitor-stop.js.map

package/dist/mcp/tools/monitor-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-stop.js","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,4EAA4E;IAC9E,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC;oBAC5D,GAAG,EAAE,IAAI,CAAC,KAAK,CAAW;iBAC3B,CAAC,EAAE,CAAC,CAAC;QACR,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/precision-live.d.ts

@@ -0,0 +1,20 @@
+import type { JumpEntry, OutlineEntry } from "../../parser/types.js";
+import type { ToolContext } from "../context.js";
+import { type McpPolicyRefusal } from "../policy.js";
+import { PrecisionSearchRequest } from "./precision-query.js";
+import { PrecisionSymbolMatch } from "./precision-match.js";
+export type PrecisionPolicyRefusal = McpPolicyRefusal;
+export declare function collectSymbols(entries: readonly OutlineEntry[], filePath: string, jumpTable: readonly JumpEntry[], jumpCursor?: Map<string, number>): PrecisionSymbolMatch[];
+export declare function loadFileContent(ctx: ToolContext, filePath: string, ref?: string): Promise<string | null>;
+export declare function evaluatePrecisionPolicy(ctx: ToolContext, filePath: string, content: string): PrecisionPolicyRefusal | null;
+export declare function searchLiveSymbols(ctx: ToolContext, filePaths: readonly string[], request: PrecisionSearchRequest, ref?: string): Promise<PrecisionSymbolMatch[]>;
+export declare function readRangeFromContent(filePath: string, content: string, start: number, end: number): {
+    path: string;
+    content?: string | undefined;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+    truncated?: boolean | undefined;
+    clipped?: boolean | undefined;
+    reason?: string | undefined;
+};
+//# sourceMappingURL=precision-live.d.ts.map

package/dist/mcp/tools/precision-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-live.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-live.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAgB5D,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAEtD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,UAAU,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAA6B,GAC1D,oBAAoB,EAAE,CA2BxB;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,sBAAsB,GAAG,IAAI,CAM/B;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,sBAAsB,EAC/B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoBjC;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CA6BA"}

package/dist/mcp/tools/precision-live.js

@@ -0,0 +1,105 @@
+import { getFileAtRef } from "../../git/diff.js";
+import { detectLang } from "../../parser/lang.js";
+import { extractOutline } from "../../parser/outline.js";
+import { evaluateMcpRefusal } from "../policy.js";
+import { PrecisionSearchRequest } from "./precision-query.js";
+import { PrecisionSymbolMatch } from "./precision-match.js";
+const MAX_RANGE_LINES = 250;
+function buildJumpLookup(jumpTable) {
+    const lookup = new Map();
+    for (const entry of jumpTable) {
+        const existing = lookup.get(entry.symbol) ?? [];
+        existing.push({ start: entry.start, end: entry.end });
+        lookup.set(entry.symbol, existing);
+    }
+    return lookup;
+}
+export function collectSymbols(entries, filePath, jumpTable, jumpCursor = new Map()) {
+    const jumpLookup = buildJumpLookup(jumpTable);
+    const results = [];
+    for (const entry of entries) {
+        const candidates = jumpLookup.get(entry.name) ?? [];
+        const jumpIndex = jumpCursor.get(entry.name) ?? 0;
+        const jump = candidates[jumpIndex];
+        if (jump !== undefined) {
+            jumpCursor.set(entry.name, jumpIndex + 1);
+        }
+        results.push(new PrecisionSymbolMatch({
+            name: entry.name,
+            kind: entry.kind,
+            path: filePath,
+            exported: entry.exported,
+            ...(entry.signature !== undefined ? { signature: entry.signature } : {}),
+            ...(jump?.start !== undefined ? { startLine: jump.start } : {}),
+            ...(jump?.end !== undefined ? { endLine: jump.end } : {}),
+        }));
+        if (entry.children !== undefined && entry.children.length > 0) {
+            results.push(...collectSymbols(entry.children, filePath, jumpTable, jumpCursor));
+        }
+    }
+    return results;
+}
+export async function loadFileContent(ctx, filePath, ref) {
+    if (ref !== undefined) {
+        return getFileAtRef(ref, filePath, { cwd: ctx.projectRoot, git: ctx.git });
+    }
+    try {
+        return await ctx.fs.readFile(ctx.resolvePath(filePath), "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+export function evaluatePrecisionPolicy(ctx, filePath, content) {
+    const actual = {
+        lines: content.split("\n").length,
+        bytes: Buffer.byteLength(content),
+    };
+    return evaluateMcpRefusal(ctx, filePath, actual);
+}
+export async function searchLiveSymbols(ctx, filePaths, request, ref) {
+    const matches = [];
+    for (const filePath of filePaths) {
+        const lang = detectLang(filePath);
+        if (lang === null)
+            continue;
+        const content = await loadFileContent(ctx, filePath, ref);
+        if (content === null)
+            continue;
+        const result = extractOutline(content, lang);
+        const symbols = collectSymbols(result.entries, filePath, result.jumpTable ?? []);
+        for (const symbol of symbols) {
+            const ranked = request.rank(symbol);
+            if (ranked !== null)
+                matches.push(ranked);
+        }
+    }
+    return request.sort(matches);
+}
+export function readRangeFromContent(filePath, content, start, end) {
+    if (start > end) {
+        return { path: filePath, reason: "INVALID_RANGE" };
+    }
+    const allLines = content.split("\n");
+    const totalLines = allLines.length;
+    let effectiveEnd = end;
+    let truncated = false;
+    let clipped = false;
+    if (effectiveEnd - start + 1 > MAX_RANGE_LINES) {
+        effectiveEnd = start + MAX_RANGE_LINES - 1;
+        truncated = true;
+    }
+    if (effectiveEnd > totalLines) {
+        effectiveEnd = totalLines;
+        clipped = true;
+    }
+    return {
+        path: filePath,
+        content: allLines.slice(start - 1, effectiveEnd).join("\n"),
+        startLine: start,
+        endLine: effectiveEnd,
+        ...(truncated ? { truncated: true, reason: "RANGE_EXCEEDED" } : {}),
+        ...(clipped ? { clipped: true } : {}),
+    };
+}
+//# sourceMappingURL=precision-live.js.map

package/dist/mcp/tools/precision-live.js.map

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

package/dist/mcp/tools/precision-match.d.ts

@@ -0,0 +1,21 @@
+export declare class PrecisionSymbolMatch {
+    readonly name: string;
+    readonly kind: string;
+    readonly path: string;
+    readonly identityId?: string;
+    readonly signature?: string;
+    readonly exported: boolean;
+    readonly startLine?: number;
+    readonly endLine?: number;
+    constructor(opts: {
+        name: string;
+        kind: string;
+        path: string;
+        identityId?: string;
+        signature?: string;
+        exported: boolean;
+        startLine?: number;
+        endLine?: number;
+    });
+}
+//# sourceMappingURL=precision-match.d.ts.map

package/dist/mcp/tools/precision-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-match.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-match.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAkCF"}

package/dist/mcp/tools/precision-match.js

@@ -0,0 +1,46 @@
+export class PrecisionSymbolMatch {
+    name;
+    kind;
+    path;
+    identityId;
+    signature;
+    exported;
+    startLine;
+    endLine;
+    constructor(opts) {
+        if (opts.name.trim().length === 0) {
+            throw new Error("PrecisionSymbolMatch: name must be non-empty");
+        }
+        if (opts.kind.trim().length === 0) {
+            throw new Error("PrecisionSymbolMatch: kind must be non-empty");
+        }
+        if (opts.path.trim().length === 0) {
+            throw new Error("PrecisionSymbolMatch: path must be non-empty");
+        }
+        if (opts.startLine !== undefined && (!Number.isInteger(opts.startLine) || opts.startLine < 1)) {
+            throw new Error("PrecisionSymbolMatch: startLine must be an integer >= 1");
+        }
+        if (opts.endLine !== undefined && (!Number.isInteger(opts.endLine) || opts.endLine < 1)) {
+            throw new Error("PrecisionSymbolMatch: endLine must be an integer >= 1");
+        }
+        if (opts.startLine !== undefined &&
+            opts.endLine !== undefined &&
+            opts.endLine < opts.startLine) {
+            throw new Error("PrecisionSymbolMatch: endLine must be >= startLine");
+        }
+        this.name = opts.name.trim();
+        this.kind = opts.kind.trim();
+        this.path = opts.path.trim();
+        this.exported = opts.exported;
+        if (opts.identityId !== undefined)
+            this.identityId = opts.identityId;
+        if (opts.signature !== undefined)
+            this.signature = opts.signature;
+        if (opts.startLine !== undefined)
+            this.startLine = opts.startLine;
+        if (opts.endLine !== undefined)
+            this.endLine = opts.endLine;
+        Object.freeze(this);
+    }
+}
+//# sourceMappingURL=precision-match.js.map

package/dist/mcp/tools/precision-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-match.js","sourceRoot":"","sources":["../../../src/mcp/tools/precision-match.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAoB;IACtB,IAAI,CAAS;IACb,IAAI,CAAS;IACb,IAAI,CAAS;IACb,UAAU,CAAU;IACpB,SAAS,CAAU;IACnB,QAAQ,CAAU;IAClB,SAAS,CAAU;IACnB,OAAO,CAAU;IAE1B,YAAY,IASX;QACC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IACE,IAAI,CAAC,SAAS,KAAK,SAAS;YAC5B,IAAI,CAAC,OAAO,KAAK,SAAS;YAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,EAC7B,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACrE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/mcp/tools/precision-paths.d.ts

@@ -0,0 +1,7 @@
+import type { GitClient } from "../../ports/git.js";
+export declare function normalizeRepoPath(projectRoot: string, input: string): string;
+export declare function requireRepoPath(projectRoot: string, input: string): string;
+export declare function resolveGitRef(ref: string, gitClient: GitClient, cwd: string): Promise<string>;
+export declare function listTrackedFilesAtRef(dirPath: string, gitClient: GitClient, cwd: string, ref: string): Promise<string[]>;
+export declare function isWorkingTreeDirty(gitClient: GitClient, cwd: string): Promise<boolean>;
+//# sourceMappingURL=precision-paths.d.ts.map

package/dist/mcp/tools/precision-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-paths.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-paths.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnG;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM5F"}

package/dist/mcp/tools/precision-paths.js

@@ -0,0 +1,53 @@
+import * as path from "node:path";
+import { GitError } from "../../git/diff.js";
+async function git(gitClient, args, cwd) {
+    const result = await gitClient.run({ args, cwd });
+    if (result.error !== undefined || result.status !== 0) {
+        throw result.error ?? new Error(result.stderr.trim() || `git exited with status ${String(result.status)}`);
+    }
+    return result.stdout;
+}
+export function normalizeRepoPath(projectRoot, input) {
+    if (!path.isAbsolute(input))
+        return input;
+    const rel = path.relative(projectRoot, input);
+    if (rel === "")
+        return ".";
+    return rel.startsWith("..") ? input : rel;
+}
+export function requireRepoPath(projectRoot, input) {
+    const normalized = normalizeRepoPath(projectRoot, input);
+    if (path.isAbsolute(normalized)) {
+        throw new Error(`Path must be inside the repository for git-ref queries: ${input}`);
+    }
+    return normalized;
+}
+export async function resolveGitRef(ref, gitClient, cwd) {
+    try {
+        return (await git(gitClient, ["rev-parse", "--verify", ref], cwd)).trim();
+    }
+    catch {
+        throw new GitError(`ref does not exist: ${ref}`);
+    }
+}
+export async function listTrackedFilesAtRef(dirPath, gitClient, cwd, ref) {
+    try {
+        const args = dirPath.length > 0
+            ? ["ls-tree", "-r", "--name-only", ref, "--", dirPath]
+            : ["ls-tree", "-r", "--name-only", ref];
+        const output = (await git(gitClient, args, cwd)).trim();
+        return output.length === 0 ? [] : output.split("\n");
+    }
+    catch {
+        return [];
+    }
+}
+export async function isWorkingTreeDirty(gitClient, cwd) {
+    try {
+        return (await git(gitClient, ["status", "--porcelain"], cwd)).trim().length > 0;
+    }
+    catch {
+        return true;
+    }
+}
+//# sourceMappingURL=precision-paths.js.map

package/dist/mcp/tools/precision-paths.js.map

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

package/dist/mcp/tools/precision-query.d.ts

@@ -0,0 +1,38 @@
+import { PrecisionSymbolMatch } from "./precision-match.js";
+type SymbolQueryMode = "glob" | "plain";
+export declare class RankedPrecisionSymbolMatch {
+    readonly match: PrecisionSymbolMatch;
+    readonly score: number;
+    constructor(opts: {
+        match: PrecisionSymbolMatch;
+        score: number;
+    });
+}
+declare class PrecisionSymbolQuery {
+    #private;
+    readonly text: string;
+    readonly mode: SymbolQueryMode;
+    constructor(query: string);
+    score(name: string): number | null;
+}
+export declare class PrecisionSearchRequest {
+    readonly exactName?: string;
+    readonly query?: PrecisionSymbolQuery;
+    readonly kind?: string;
+    readonly filePath?: string;
+    readonly pathPrefix?: string;
+    readonly ceiling?: number;
+    constructor(opts: {
+        exactName?: string;
+        query?: string;
+        kind?: string;
+        filePath?: string;
+        pathPrefix?: string;
+        ceiling?: number;
+    });
+    selectLens(): "file" | "exact" | "all";
+    rank(match: PrecisionSymbolMatch): RankedPrecisionSymbolMatch | null;
+    sort(matches: readonly RankedPrecisionSymbolMatch[]): PrecisionSymbolMatch[];
+}
+export {};
+//# sourceMappingURL=precision-query.d.ts.map

package/dist/mcp/tools/precision-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-query.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAExC,qBAAa,0BAA0B;IACrC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE;QAChB,KAAK,EAAE,oBAAoB,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;KACf;CAQF;AAED,cAAM,oBAAoB;;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAGnB,KAAK,EAAE,MAAM;IAezB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAanC;AAED,qBAAa,sBAAsB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IA0BD,UAAU,IAAI,MAAM,GAAG,OAAO,GAAG,KAAK;IAMtC,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,0BAA0B,GAAG,IAAI;IAYpE,IAAI,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAAG,oBAAoB,EAAE;CAU7E"}