@flyingrobots/graft 0.4.0 → 0.6.0

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

@@ -0,0 +1,116 @@
+import picomatch from "picomatch";
+import { PrecisionSymbolMatch } from "./precision-match.js";
+export class RankedPrecisionSymbolMatch {
+    match;
+    score;
+    constructor(opts) {
+        if (opts.score < 0) {
+            throw new Error("RankedPrecisionSymbolMatch: score must be >= 0");
+        }
+        this.match = opts.match;
+        this.score = opts.score;
+        Object.freeze(this);
+    }
+}
+class PrecisionSymbolQuery {
+    text;
+    mode;
+    #globMatcher;
+    constructor(query) {
+        const normalizedQuery = query.trim();
+        if (normalizedQuery.length === 0) {
+            throw new Error("PrecisionSymbolQuery: query must be non-empty");
+        }
+        this.text = normalizedQuery;
+        if (picomatch.scan(normalizedQuery).isGlob) {
+            this.mode = "glob";
+            this.#globMatcher = picomatch(normalizedQuery, { nocase: true });
+        }
+        else {
+            this.mode = "plain";
+        }
+        Object.freeze(this);
+    }
+    score(name) {
+        if (this.mode === "glob") {
+            return this.#globMatcher?.(name) === true ? 0 : null;
+        }
+        const loweredName = name.toLowerCase();
+        const loweredQuery = this.text.toLowerCase();
+        if (name === this.text)
+            return 0;
+        if (loweredName === loweredQuery)
+            return 1;
+        if (name.startsWith(this.text))
+            return 2;
+        if (loweredName.startsWith(loweredQuery))
+            return 3;
+        return loweredName.includes(loweredQuery) ? 4 : null;
+    }
+}
+export class PrecisionSearchRequest {
+    exactName;
+    query;
+    kind;
+    filePath;
+    pathPrefix;
+    ceiling;
+    constructor(opts) {
+        const exactName = opts.exactName?.trim();
+        const query = opts.query?.trim();
+        const kind = opts.kind?.trim().toLowerCase();
+        const filePath = opts.filePath?.trim();
+        const pathPrefix = opts.pathPrefix?.trim();
+        if ((exactName?.length ?? 0) === 0 && (query?.length ?? 0) === 0) {
+            throw new Error("PrecisionSearchRequest: exactName or query is required");
+        }
+        if (opts.ceiling !== undefined &&
+            (!Number.isInteger(opts.ceiling) || opts.ceiling < 1)) {
+            throw new Error("PrecisionSearchRequest: ceiling must be an integer >= 1");
+        }
+        if (exactName !== undefined && exactName.length > 0)
+            this.exactName = exactName;
+        if (query !== undefined && query.length > 0)
+            this.query = new PrecisionSymbolQuery(query);
+        if (kind !== undefined && kind.length > 0)
+            this.kind = kind;
+        if (filePath !== undefined && filePath.length > 0)
+            this.filePath = filePath;
+        if (pathPrefix !== undefined && pathPrefix.length > 0)
+            this.pathPrefix = pathPrefix;
+        if (opts.ceiling !== undefined)
+            this.ceiling = opts.ceiling;
+        Object.freeze(this);
+    }
+    selectLens() {
+        if (this.filePath !== undefined)
+            return "file";
+        if (this.exactName !== undefined)
+            return "exact";
+        return "all";
+    }
+    rank(match) {
+        if (this.exactName !== undefined && match.name !== this.exactName)
+            return null;
+        if (this.kind !== undefined && match.kind.toLowerCase() !== this.kind)
+            return null;
+        if (this.filePath !== undefined && match.path !== this.filePath)
+            return null;
+        if (this.pathPrefix !== undefined && !match.path.startsWith(this.pathPrefix))
+            return null;
+        if (this.query === undefined) {
+            return new RankedPrecisionSymbolMatch({ match, score: 0 });
+        }
+        const score = this.query.score(match.name);
+        return score === null ? null : new RankedPrecisionSymbolMatch({ match, score });
+    }
+    sort(matches) {
+        return [...matches]
+            .sort((a, b) => a.score - b.score ||
+            (this.query?.mode === "plain" ? a.match.name.length - b.match.name.length : 0) ||
+            a.match.path.localeCompare(b.match.path) ||
+            a.match.name.localeCompare(b.match.name))
+            .map((entry) => entry.match);
+    }
+}
+//# sourceMappingURL=precision-query.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { ToolContext } from "../context.js";
+import type { PrecisionSymbolMatch } from "./precision-match.js";
+export interface CodeShowResolution {
+    readonly layer: "commit_worldline" | "ref_view" | "workspace_overlay";
+    readonly source: "warp" | "live";
+    readonly resolvedRef?: string | undefined;
+    readonly locations: PrecisionSymbolMatch[];
+}
+export declare function resolveCodeShowLocations(ctx: ToolContext, input: {
+    symbolName: string;
+    targetPath?: string | undefined;
+    ref?: string | undefined;
+    allowWarp: boolean;
+}): Promise<CodeShowResolution>;
+//# sourceMappingURL=precision-show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precision-show.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-show.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAejD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,GAAG,mBAAmB,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,oBAAoB,EAAE,CAAC;CAC5C;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IACL,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAqD7B"}

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

@@ -0,0 +1,46 @@
+import { listProjectFiles } from "./git-files.js";
+import { getIndexedCommitCeilings, searchWarpSymbols, } from "./precision-warp.js";
+import { listTrackedFilesAtRef, requireRepoPath, resolveGitRef, } from "./precision-paths.js";
+import { searchLiveSymbols, } from "./precision-live.js";
+import { PrecisionSearchRequest } from "./precision-query.js";
+export async function resolveCodeShowLocations(ctx, input) {
+    const repoState = ctx.getRepoState();
+    const layer = input.ref !== undefined
+        ? "commit_worldline"
+        : repoState.dirty
+            ? "workspace_overlay"
+            : "ref_view";
+    let resolvedRef;
+    if (input.ref !== undefined) {
+        resolvedRef = await resolveGitRef(input.ref, ctx.git, ctx.projectRoot);
+    }
+    if (resolvedRef !== undefined) {
+        const repoPath = input.targetPath !== undefined
+            ? requireRepoPath(ctx.projectRoot, input.targetPath)
+            : undefined;
+        if (input.allowWarp) {
+            const warp = await ctx.getWarp();
+            const ceilings = await getIndexedCommitCeilings(warp);
+            const ceiling = ceilings.get(resolvedRef);
+            if (ceiling !== undefined) {
+                const locations = await searchWarpSymbols(warp, new PrecisionSearchRequest({
+                    exactName: input.symbolName,
+                    ...(repoPath !== undefined ? { filePath: repoPath } : {}),
+                    ceiling,
+                }));
+                return { layer, source: "warp", resolvedRef, locations };
+            }
+        }
+        const filePaths = repoPath !== undefined
+            ? [repoPath]
+            : await listTrackedFilesAtRef("", ctx.git, ctx.projectRoot, resolvedRef);
+        const locations = await searchLiveSymbols(ctx, filePaths, new PrecisionSearchRequest({ exactName: input.symbolName }), resolvedRef);
+        return { layer, source: "live", resolvedRef, locations };
+    }
+    const filePaths = input.targetPath !== undefined
+        ? [input.targetPath]
+        : await listProjectFiles("", ctx.projectRoot, ctx.git);
+    const locations = await searchLiveSymbols(ctx, filePaths, new PrecisionSearchRequest({ exactName: input.symbolName }));
+    return { layer, source: "live", locations };
+}
+//# sourceMappingURL=precision-show.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { ToolContext } from "../context.js";
+import { type PrecisionPolicyRefusal } from "./precision-live.js";
+import type { PrecisionSymbolMatch } from "./precision-match.js";
+export interface PrecisionVisibilityResult {
+    readonly visibleMatches: PrecisionSymbolMatch[];
+    readonly fileCache: Map<string, string>;
+    readonly firstRefusal: PrecisionPolicyRefusal | undefined;
+}
+export declare function filterVisiblePrecisionMatches(ctx: ToolContext, matches: readonly PrecisionSymbolMatch[], ref?: string): Promise<PrecisionVisibilityResult>;
+//# sourceMappingURL=precision-visibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precision-visibility.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,EAAE,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,YAAY,EACjB,sBAAsB,GACtB,SAAS,CAAC;CACf;AAED,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,yBAAyB,CAAC,CAuBpC"}

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

@@ -0,0 +1,24 @@
+import { evaluatePrecisionPolicy, loadFileContent, } from "./precision-live.js";
+export async function filterVisiblePrecisionMatches(ctx, matches, ref) {
+    const visibleMatches = [];
+    const fileCache = new Map();
+    let firstRefusal;
+    for (const match of matches) {
+        let content = fileCache.get(match.path);
+        if (content === undefined) {
+            const loaded = await loadFileContent(ctx, match.path, ref);
+            if (loaded === null)
+                continue;
+            fileCache.set(match.path, loaded);
+            content = loaded;
+        }
+        const refusal = evaluatePrecisionPolicy(ctx, match.path, content);
+        if (refusal !== null) {
+            firstRefusal ??= refusal;
+            continue;
+        }
+        visibleMatches.push(match);
+    }
+    return { visibleMatches, fileCache, firstRefusal };
+}
+//# sourceMappingURL=precision-visibility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precision-visibility.js","sourceRoot":"","sources":["../../../src/mcp/tools/precision-visibility.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAW7B,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAgB,EAChB,OAAwC,EACxC,GAAY;IAEZ,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,IAAI,YAAgD,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3D,IAAI,MAAM,KAAK,IAAI;gBAAE,SAAS;YAC9B,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAClC,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,uBAAuB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,YAAY,KAAK,OAAO,CAAC;YACzB,SAAS;QACX,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { WarpHandle } from "../../ports/warp.js";
+import { PrecisionSearchRequest } from "./precision-query.js";
+import { PrecisionSymbolMatch } from "./precision-match.js";
+export declare function getIndexedCommitCeilings(warp: WarpHandle): Promise<ReadonlyMap<string, number>>;
+export declare function searchWarpSymbols(warp: WarpHandle, request: PrecisionSearchRequest): Promise<PrecisionSymbolMatch[]>;
+//# sourceMappingURL=precision-warp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precision-warp.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-warp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAgC5D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAerG;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC"}

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

@@ -0,0 +1,76 @@
+import { allSymbolsLens, commitsLens, fileSymbolsLens, symbolByNameLens } from "../../warp/observers.js";
+import { PrecisionSearchRequest } from "./precision-query.js";
+import { PrecisionSymbolMatch } from "./precision-match.js";
+function decodeSymbolPath(nodeId) {
+    if (!nodeId.startsWith("sym:"))
+        return null;
+    const lastColon = nodeId.lastIndexOf(":");
+    if (lastColon <= "sym:".length)
+        return null;
+    return nodeId.slice("sym:".length, lastColon);
+}
+function toMatch(nodeId, props) {
+    const name = props["name"];
+    const kind = props["kind"];
+    const path = decodeSymbolPath(nodeId);
+    if (typeof name !== "string" || typeof kind !== "string" || path === null) {
+        return null;
+    }
+    return new PrecisionSymbolMatch({
+        name,
+        kind,
+        path,
+        ...(typeof props["identityId"] === "string" ? { identityId: props["identityId"] } : {}),
+        ...(typeof props["signature"] === "string" ? { signature: props["signature"] } : {}),
+        exported: props["exported"] === true,
+        ...(typeof props["startLine"] === "number" ? { startLine: props["startLine"] } : {}),
+        ...(typeof props["endLine"] === "number" ? { endLine: props["endLine"] } : {}),
+    });
+}
+export async function getIndexedCommitCeilings(warp) {
+    const ceilings = new Map();
+    const observer = await warp.observer(commitsLens());
+    const nodeIds = await observer.getNodes();
+    for (const nodeId of nodeIds) {
+        const props = await observer.getNodeProps(nodeId);
+        const sha = typeof props?.["sha"] === "string" ? props["sha"] : null;
+        const tick = typeof props?.["tick"] === "number" ? props["tick"] : null;
+        if (sha !== null && tick !== null) {
+            ceilings.set(sha, tick);
+        }
+    }
+    return ceilings;
+}
+export async function searchWarpSymbols(warp, request) {
+    const lensMode = request.selectLens();
+    let lens;
+    if (lensMode === "file") {
+        if (request.filePath === undefined) {
+            throw new Error("PrecisionSearchRequest selected file lens without filePath");
+        }
+        lens = fileSymbolsLens(request.filePath);
+    }
+    else if (lensMode === "exact") {
+        if (request.exactName === undefined) {
+            throw new Error("PrecisionSearchRequest selected exact lens without exactName");
+        }
+        lens = symbolByNameLens(request.exactName);
+    }
+    else {
+        lens = allSymbolsLens();
+    }
+    const observer = await warp.observer(lens, request.ceiling !== undefined ? { source: { kind: "live", ceiling: request.ceiling } } : undefined);
+    const nodeIds = await observer.getNodes();
+    const matches = await Promise.all(nodeIds.map(async (nodeId) => {
+        const props = await observer.getNodeProps(nodeId);
+        if (props === null)
+            return null;
+        const match = toMatch(nodeId, props);
+        if (match === null)
+            return null;
+        return request.rank(match);
+    }));
+    const visibleMatches = matches.filter((match) => match !== null);
+    return request.sort(visibleMatches);
+}
+//# sourceMappingURL=precision-warp.js.map

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

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

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

@@ -0,0 +1,7 @@
+export { PrecisionSearchRequest } from "./precision-query.js";
+export { PrecisionSymbolMatch } from "./precision-match.js";
+export type { PrecisionPolicyRefusal } from "./precision-live.js";
+export { collectSymbols, loadFileContent, evaluatePrecisionPolicy, searchLiveSymbols, readRangeFromContent, } from "./precision-live.js";
+export { normalizeRepoPath, requireRepoPath, resolveGitRef, listTrackedFilesAtRef, isWorkingTreeDirty, } from "./precision-paths.js";
+export { getIndexedCommitCeilings, searchWarpSymbols, } from "./precision-warp.js";
+//# sourceMappingURL=precision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precision.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/mcp/tools/precision.js

@@ -0,0 +1,6 @@
+export { PrecisionSearchRequest } from "./precision-query.js";
+export { PrecisionSymbolMatch } from "./precision-match.js";
+export { collectSymbols, loadFileContent, evaluatePrecisionPolicy, searchLiveSymbols, readRangeFromContent, } from "./precision-live.js";
+export { normalizeRepoPath, requireRepoPath, resolveGitRef, listTrackedFilesAtRef, isWorkingTreeDirty, } from "./precision-paths.js";
+export { getIndexedCommitCeilings, searchWarpSymbols, } from "./precision-warp.js";
+//# sourceMappingURL=precision.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precision.js","sourceRoot":"","sources":["../../../src/mcp/tools/precision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EACL,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/mcp/tools/read-range.d.ts

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

package/dist/mcp/tools/read-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-range.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/read-range.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAGjE,eAAO,MAAM,aAAa,EAAE,cAsB3B,CAAC"}

package/dist/mcp/tools/read-range.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { readRange } from "../../operations/read-range.js";
+import { toJsonObject } from "../../operations/result-dto.js";
+export const readRangeTool = {
+    name: "read_range",
+    description: "Read a bounded range of lines from a file. Maximum 250 lines. " +
+        "Use jump table entries from file_outline or safe_read to target " +
+        "specific symbols.",
+    schema: { path: z.string(), start: z.number(), end: z.number() },
+    policyCheck: true,
+    createHandler() {
+        return async (args, ctx) => {
+            const filePath = ctx.resolvePath(args["path"]);
+            const startLine = args["start"];
+            const endLine = args["end"];
+            const result = await readRange(filePath, startLine, endLine, { fs: ctx.fs });
+            ctx.metrics.recordRead();
+            ctx.recordFootprint({
+                paths: [filePath],
+                regions: [{ path: filePath, startLine, endLine }],
+            });
+            return ctx.respond("read_range", toJsonObject(result));
+        };
+    },
+};
+//# sourceMappingURL=read-range.js.map

package/dist/mcp/tools/read-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-range.js","sourceRoot":"","sources":["../../../src/mcp/tools/read-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,gEAAgE;QAChE,kEAAkE;QAClE,mBAAmB;IACrB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAChE,WAAW,EAAE,IAAI;IACjB,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAW,CAAC,CAAC;YACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAW,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAW,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7E,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACzB,GAAG,CAAC,eAAe,CAAC;gBAClB,KAAK,EAAE,CAAC,QAAQ,CAAC;gBACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;aAClD,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/run-capture.d.ts

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

package/dist/mcp/tools/run-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-capture.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/run-capture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,eAAe,CAAC;AAiF9E,eAAO,MAAM,cAAc,EAAE,cAiE5B,CAAC"}

package/dist/mcp/tools/run-capture.js

@@ -0,0 +1,125 @@
+import * as path from "node:path";
+import { z } from "zod";
+const RUN_CAPTURE_POLICY_BOUNDARY = {
+    kind: "shell_escape_hatch",
+    boundedReadContract: false,
+    policyEnforced: false,
+};
+const PRIVATE_KEY_BLOCK_RE = /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g;
+const SECRET_ASSIGNMENT_RE = /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|bearer|token|secret|password|passwd|private[_-]?key|client[_-]?secret|session[_-]?key)\b\s*[:=]\s*)([^\r\n]+)/gi;
+const BEARER_TOKEN_RE = /(\bbearer\s+)([A-Za-z0-9._~+/=-]{8,})/gi;
+function tailOutput(output, tail) {
+    const lines = output.split("\n");
+    return {
+        tailed: lines.slice(-tail).join("\n"),
+        totalLines: lines.length,
+    };
+}
+function renderCaptureError(result) {
+    if (result.error !== undefined) {
+        return result.error.message;
+    }
+    const stderr = result.stderr.trim();
+    if (stderr.length > 0) {
+        return stderr;
+    }
+    return `Command exited with status ${String(result.status)}`;
+}
+function redactForLog(output) {
+    let redactions = 0;
+    let value = output.replace(PRIVATE_KEY_BLOCK_RE, () => {
+        redactions++;
+        return "[REDACTED PRIVATE KEY BLOCK]";
+    });
+    value = value.replace(SECRET_ASSIGNMENT_RE, (_match, prefix) => {
+        redactions++;
+        return `${prefix}[REDACTED]`;
+    });
+    value = value.replace(BEARER_TOKEN_RE, (_match, prefix) => {
+        redactions++;
+        return `${prefix}[REDACTED]`;
+    });
+    return { value, redactions };
+}
+async function persistCaptureLog(ctx, output) {
+    if (!ctx.runCapture.persistLogs) {
+        return { logPath: null, logRedactions: 0 };
+    }
+    const logPath = path.join(ctx.graftDir, "logs", "capture.log");
+    const persisted = ctx.runCapture.redactLogs ? redactForLog(output) : { value: output, redactions: 0 };
+    try {
+        await ctx.fs.mkdir(path.dirname(logPath), { recursive: true });
+        await ctx.fs.writeFile(logPath, persisted.value, "utf-8");
+        return {
+            logPath,
+            logRedactions: persisted.redactions,
+        };
+    }
+    catch {
+        return { logPath: null, logRedactions: 0 };
+    }
+}
+export const runCaptureTool = {
+    name: "run_capture",
+    description: "Execute a shell command and return the last N lines of output " +
+        "(default 60). Responses include an explicit policy boundary. " +
+        "Persisted logs can be disabled and obvious secrets are redacted " +
+        "before writing to .graft/logs/capture.log.",
+    schema: { command: z.string(), tail: z.number().optional() },
+    createHandler() {
+        return async (args, ctx) => {
+            const command = args["command"];
+            const tail = Math.max(1, Math.floor(args["tail"] ?? 60));
+            if (!ctx.runCapture.enabled) {
+                return ctx.respond("run_capture", {
+                    output: "",
+                    totalLines: 0,
+                    tailedLines: 0,
+                    logPath: null,
+                    logRedactions: 0,
+                    logPersistenceEnabled: false,
+                    truncated: false,
+                    disabled: true,
+                    error: "run_capture is disabled by configuration",
+                    policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
+                });
+            }
+            const result = ctx.process.run({
+                command: "sh",
+                args: ["-c", command],
+                cwd: ctx.projectRoot,
+                timeoutMs: 30000,
+                maxBufferBytes: 10 * 1024 * 1024,
+            });
+            if (result.error !== undefined || result.status !== 0) {
+                const tailedOutput = tailOutput(result.stdout, tail);
+                return ctx.respond("run_capture", {
+                    error: renderCaptureError(result),
+                    output: tailedOutput.tailed,
+                    totalLines: tailedOutput.totalLines,
+                    tailedLines: Math.min(tail, tailedOutput.totalLines),
+                    logPath: null,
+                    logRedactions: 0,
+                    logPersistenceEnabled: ctx.runCapture.persistLogs,
+                    truncated: tailedOutput.totalLines > tail,
+                    stderr: result.stderr.slice(0, 2000),
+                    policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
+                });
+            }
+            const output = result.stdout;
+            const tailedOutput = tailOutput(output, tail);
+            const persisted = await persistCaptureLog(ctx, output);
+            return ctx.respond("run_capture", {
+                output: tailedOutput.tailed,
+                totalLines: tailedOutput.totalLines,
+                tailedLines: Math.min(tail, tailedOutput.totalLines),
+                logPath: persisted.logPath,
+                logRedactions: persisted.logRedactions,
+                logPersistenceEnabled: ctx.runCapture.persistLogs,
+                truncated: tailedOutput.totalLines > tail,
+                policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
+            });
+        };
+    },
+};
+//# sourceMappingURL=run-capture.js.map

package/dist/mcp/tools/run-capture.js.map

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

package/dist/mcp/tools/safe-read.d.ts

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

package/dist/mcp/tools/safe-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-read.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/safe-read.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAUjE,eAAO,MAAM,YAAY,EAAE,cAgI1B,CAAC"}