@flyingrobots/graft 0.6.0 → 0.7.0

package/dist/mcp/tools/graft-edit.js

@@ -0,0 +1,192 @@
+import { z } from "zod";
+import { evaluateMcpPolicy } from "../policy.js";
+import { RefusedResult } from "../../policy/types.js";
+function countOccurrences(content, needle) {
+    if (needle.length === 0) {
+        return content.length + 1;
+    }
+    let count = 0;
+    let offset = 0;
+    while (offset <= content.length) {
+        const index = content.indexOf(needle, offset);
+        if (index === -1) {
+            return count;
+        }
+        count += 1;
+        offset = index + needle.length;
+    }
+    return count;
+}
+async function actualForFile(content, stat) {
+    const fileStat = await stat();
+    return {
+        lines: content.split("\n").length,
+        bytes: fileStat.size,
+    };
+}
+function refused(input) {
+    return {
+        path: input.path,
+        operation: "replace",
+        projection: "refused",
+        status: "refused",
+        changed: false,
+        matches: input.matches ?? 0,
+        replacements: 0,
+        reason: input.reason,
+        ...(input.reasonDetail !== undefined ? { reasonDetail: input.reasonDetail } : {}),
+        ...(input.next !== undefined ? { next: [...input.next] } : {}),
+        ...(input.actual !== undefined ? { actual: input.actual } : {}),
+    };
+}
+function containsJsdocTypedef(content) {
+    return content
+        .split(/\r?\n/u)
+        .some((line) => line.trimStart().startsWith("* @typedef "));
+}
+function classifyStructuralEdit(input) {
+    const oldHasTypedef = containsJsdocTypedef(input.oldString);
+    const newHasTypedef = containsJsdocTypedef(input.newString);
+    if (oldHasTypedef === newHasTypedef) {
+        return null;
+    }
+    return {
+        path: input.path,
+        pattern: "jsdoc_typedef",
+        direction: oldHasTypedef ? "removed" : "added",
+    };
+}
+function buildDriftWarnings(observation, priorObservations) {
+    if (observation?.direction !== "added") {
+        return [];
+    }
+    let previous;
+    for (let i = priorObservations.length - 1; i >= 0; i--) {
+        const candidate = priorObservations[i];
+        if (candidate?.pattern === observation.pattern && candidate.direction === "removed") {
+            previous = candidate;
+            break;
+        }
+    }
+    if (previous === undefined) {
+        return [];
+    }
+    return [{
+            kind: "structural_pattern_reintroduced",
+            severity: "advisory",
+            pattern: observation.pattern,
+            basis: "session_local_graft_edit",
+            message: "You are adding a typedef in a session that has been removing typedefs.",
+            current: {
+                path: observation.path,
+                direction: "added",
+            },
+            previous: {
+                path: previous.path,
+                direction: "removed",
+            },
+        }];
+}
+export const graftEditTool = {
+    name: "graft_edit",
+    description: "Perform one governed exact string replacement in a repo file. " +
+        "Requires path, old_string, and new_string. Refuses missing or " +
+        "ambiguous old_string matches and policy-denied paths.",
+    schema: {
+        path: z.string(),
+        old_string: z.string(),
+        new_string: z.string(),
+    },
+    createHandler() {
+        const structuralEditObservations = [];
+        return async (args, ctx) => {
+            const filePath = ctx.resolvePath(args["path"]);
+            const oldString = args["old_string"];
+            const newString = args["new_string"];
+            ctx.recordFootprint({ paths: [filePath] });
+            let content;
+            try {
+                content = await ctx.fs.readFile(filePath, "utf-8");
+            }
+            catch {
+                ctx.metrics.recordRefusal();
+                return ctx.respond("graft_edit", {
+                    ...refused({
+                        path: filePath,
+                        reason: "NOT_FOUND",
+                        reasonDetail: "File does not exist or cannot be read",
+                        next: ["Choose an existing file; graft_edit does not create files"],
+                    }),
+                });
+            }
+            const actual = await actualForFile(content, () => ctx.fs.stat(filePath));
+            const policy = evaluateMcpPolicy(ctx, filePath, actual);
+            if (policy instanceof RefusedResult) {
+                ctx.metrics.recordRefusal();
+                return ctx.respond("graft_edit", {
+                    ...refused({
+                        path: filePath,
+                        reason: policy.reason,
+                        reasonDetail: policy.reasonDetail,
+                        next: policy.next,
+                        actual,
+                    }),
+                });
+            }
+            const matches = countOccurrences(content, oldString);
+            if (matches === 0) {
+                ctx.metrics.recordRefusal();
+                return ctx.respond("graft_edit", {
+                    ...refused({
+                        path: filePath,
+                        reason: "OLD_STRING_NOT_FOUND",
+                        reasonDetail: "old_string does not occur in the target file",
+                        next: ["Inspect the current file content and provide an exact old_string"],
+                        actual,
+                        matches,
+                    }),
+                });
+            }
+            if (matches !== 1) {
+                ctx.metrics.recordRefusal();
+                return ctx.respond("graft_edit", {
+                    ...refused({
+                        path: filePath,
+                        reason: "OLD_STRING_AMBIGUOUS",
+                        reasonDetail: "old_string must occur exactly once",
+                        next: ["Provide a longer old_string that uniquely identifies the edit site"],
+                        actual,
+                        matches,
+                    }),
+                });
+            }
+            const nextContent = content.replace(oldString, newString);
+            const changed = nextContent !== content;
+            if (changed) {
+                await ctx.fs.writeFile(filePath, nextContent, "utf-8");
+            }
+            const observation = classifyStructuralEdit({
+                path: filePath,
+                oldString,
+                newString,
+            });
+            const driftWarnings = buildDriftWarnings(observation, structuralEditObservations);
+            if (observation !== null) {
+                structuralEditObservations.push(observation);
+            }
+            const response = {
+                path: filePath,
+                operation: "replace",
+                projection: "edited",
+                status: "edited",
+                changed,
+                matches,
+                replacements: 1,
+                actual,
+                ...(driftWarnings.length > 0 ? { driftWarnings } : {}),
+            };
+            return ctx.respond("graft_edit", { ...response });
+        };
+    },
+};
+//# sourceMappingURL=graft-edit.js.map

package/dist/mcp/tools/graft-edit.js.map

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

package/dist/mcp/tools/knowledge-map.d.ts

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

package/dist/mcp/tools/knowledge-map.d.ts.map

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

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

@@ -0,0 +1,31 @@
+import { buildKnowledgeMap } from "../../operations/knowledge-map.js";
+export const knowledgeMapTool = {
+    name: "knowledge_map",
+    description: "Session knowledge map — answers \"what do I already know?\" " +
+        "Lists all files and symbols observed this session, flags stale " +
+        "files (changed since last read), and shows directory coverage. " +
+        "Use before reading more files to avoid redundant context consumption.",
+    createHandler() {
+        return async (_args, ctx) => {
+            const result = await buildKnowledgeMap({
+                cache: ctx.cache,
+                fs: ctx.fs,
+                projectRoot: ctx.projectRoot,
+            });
+            return ctx.respond("knowledge_map", {
+                totalFiles: result.totalFiles,
+                totalSymbols: result.totalSymbols,
+                files: result.files.map((f) => ({
+                    path: f.path,
+                    symbols: [...f.symbols],
+                    readCount: f.readCount,
+                    lastReadAt: f.lastReadAt,
+                    stale: f.stale,
+                })),
+                staleFiles: [...result.staleFiles],
+                directoryCoverage: result.directoryCoverage,
+            });
+        };
+    },
+};
+//# sourceMappingURL=knowledge-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-map.js","sourceRoot":"","sources":["../../../src/mcp/tools/knowledge-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,8DAA8D;QAC9D,iEAAiE;QACjE,iEAAiE;QACjE,uEAAuE;IACzE,aAAa;QACX,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;gBACrC,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,WAAW,EAAE,GAAG,CAAC,WAAW;aAC7B,CAAC,CAAC;YAEH,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE;gBAClC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;oBACvB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC,CAAC;gBACH,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;gBAClC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export const monitorNudgeTool = {
+    name: "monitor_nudge",
+    description: "Trigger an immediate re-index tick for a running monitor. " +
+        "Use from post-commit hooks to notify graft that HEAD changed.",
+    schema: {
+        cwd: z.string(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            return ctx.respond("monitor_nudge", { ...await ctx.nudgeMonitor({
+                    cwd: args["cwd"],
+                }) });
+        };
+    },
+};
+//# sourceMappingURL=monitor-nudge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-nudge.js","sourceRoot":"","sources":["../../../src/mcp/tools/monitor-nudge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,4DAA4D;QAC5D,+DAA+D;IACjE,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/precision-warp.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"precision-warp.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/precision-warp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAgC5D,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoBrG;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAqCjC"}

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

@@ -1,3 +1,4 @@
+import { observeGraph } from "../../warp/context.js";
 import { allSymbolsLens, commitsLens, fileSymbolsLens, symbolByNameLens } from "../../warp/observers.js";
 import { PrecisionSearchRequest } from "./precision-query.js";
 import { PrecisionSymbolMatch } from "./precision-match.js";
@@ -27,21 +28,25 @@ function toMatch(nodeId, props) {
         ...(typeof props["endLine"] === "number" ? { endLine: props["endLine"] } : {}),
     });
 }
-export async function getIndexedCommitCeilings(warp) {
+export async function getIndexedCommitCeilings(ctx) {
     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;
+    const observer = await observeGraph(ctx, commitsLens());
+    // Slice-first: use query API instead of getNodes() + per-node getNodeProps()
+    const result = await observer.query()
+        .match("commit:*")
+        .select(["id", "props"])
+        .run();
+    for (const node of result.nodes) {
+        const props = node.props ?? {};
+        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) {
+export async function searchWarpSymbols(ctx, request) {
     const lensMode = request.selectLens();
     let lens;
     if (lensMode === "file") {
@@ -59,17 +64,21 @@ export async function searchWarpSymbols(warp, request) {
     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)
+    const observer = await observeGraph(ctx, lens, request.ceiling !== undefined ? { source: { kind: "live", ceiling: request.ceiling } } : undefined);
+    // Slice-first: use query API instead of getNodes() + per-node getNodeProps()
+    const queryResult = await observer.query()
+        .match("*")
+        .select(["id", "props"])
+        .run();
+    const matches = queryResult.nodes.map((node) => {
+        const props = node.props ?? {};
+        if (node.id === undefined)
             return null;
-        const match = toMatch(nodeId, props);
+        const match = toMatch(node.id, props);
         if (match === null)
             return null;
         return request.rank(match);
-    }));
+    });
     const visibleMatches = matches.filter((match) => match !== null);
     return request.sort(visibleMatches);
 }

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

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

package/dist/mcp/tools/refactor-difficulty.d.ts

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

package/dist/mcp/tools/refactor-difficulty.d.ts.map

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

package/dist/mcp/tools/refactor-difficulty.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { toJsonObject } from "../../operations/result-dto.js";
+import { refactorDifficultyFromGraph } from "../../warp/refactor-difficulty.js";
+export const refactorDifficultyTool = {
+    name: "graft_difficulty",
+    description: "Refactor difficulty score for a symbol. Combines WARP aggregate " +
+        "churn curvature with WARP reference-edge friction so agents can " +
+        "choose refactor vs workaround.",
+    schema: {
+        symbol: z.string(),
+        path: z.string().optional(),
+        limit: z.number().int().positive().optional(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            const symbol = args["symbol"];
+            const rawPath = args["path"];
+            const rawLimit = args["limit"];
+            if (typeof symbol !== "string" || symbol.trim().length === 0) {
+                throw new Error("graft_difficulty: symbol must be a non-empty string");
+            }
+            const warp = await ctx.getWarp();
+            const result = await refactorDifficultyFromGraph(warp, {
+                symbol,
+                ...(typeof rawPath === "string" ? { path: rawPath } : {}),
+                ...(typeof rawLimit === "number" ? { limit: rawLimit } : {}),
+            });
+            ctx.recordFootprint({
+                symbols: [symbol.trim()],
+                paths: result.entries.map((entry) => entry.filePath),
+            });
+            return ctx.respond("graft_difficulty", toJsonObject(result));
+        };
+    },
+};
+//# sourceMappingURL=refactor-difficulty.js.map

package/dist/mcp/tools/refactor-difficulty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor-difficulty.js","sourceRoot":"","sources":["../../../src/mcp/tools/refactor-difficulty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAGhF,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,kEAAkE;QAClE,kEAAkE;QAClE,gCAAgC;IAClC,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAC9C;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YAE/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,IAAI,EAAE;gBACrD,MAAM;gBACN,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7D,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CAAC;gBAClB,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACxB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;aACrD,CAAC,CAAC;YAEH,OAAO,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

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

@@ -50,7 +50,7 @@ export const safeReadTool = {
                             actual: cf.actual,
                         });
                     }
-                    cacheResult.obs.touch();
+                    cacheResult.obs.touch(ctx.cache.now());
                     ctx.metrics.recordCacheHit(cf.actual.bytes);
                     ctx.recordFootprint({
                         symbols: cacheResult.obs.outline.map((e) => e.name),
@@ -98,7 +98,7 @@ export const safeReadTool = {
                         jumpTable: cf.jumpTable,
                         actual: cf.actual,
                         readCount: newReadCount,
-                        lastReadAt: updatedObs?.lastReadAt ?? new Date().toISOString(),
+                        lastReadAt: updatedObs?.lastReadAt ?? ctx.cache.now(),
                     });
                 }
             }

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

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

package/dist/mcp/tools/structural-blame.d.ts

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

package/dist/mcp/tools/structural-blame.d.ts.map

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

package/dist/mcp/tools/structural-blame.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { structuralBlameFromGraph } from "../../warp/warp-structural-blame.js";
+import { toJsonObject } from "../../operations/result-dto.js";
+export const structuralBlameTool = {
+    name: "graft_blame",
+    description: "Symbol-level blame: who last changed a symbol's signature, when " +
+        "it was created, and its full change history. Returns creation " +
+        "commit, last signature change, change count, reference count, " +
+        "and chronological history.",
+    schema: {
+        symbol: z.string(),
+        path: z.string().optional(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            const symbol = args["symbol"];
+            const rawPath = args["path"];
+            if (typeof symbol !== "string" || symbol.trim().length === 0) {
+                throw new Error("graft_blame: symbol must be a non-empty string");
+            }
+            const symbolName = symbol.trim();
+            const filePath = typeof rawPath === "string" ? rawPath : undefined;
+            const warp = await ctx.getWarp();
+            const blame = await structuralBlameFromGraph(warp, symbolName, filePath ?? "");
+            ctx.recordFootprint({ symbols: [symbolName] });
+            return ctx.respond("graft_blame", toJsonObject({
+                symbol: blame.symbol,
+                filePath: blame.filePath,
+                changeCount: blame.changeCount,
+                createdInCommit: blame.createdInCommit ?? null,
+                lastSignatureChange: blame.lastSignatureChange ?? null,
+                referenceCount: blame.referenceCount,
+                history: blame.history.map((v) => ({
+                    sha: v.sha,
+                    tick: v.tick,
+                    changeKind: v.changeKind,
+                    present: v.present,
+                    signature: v.signature ?? null,
+                })),
+            }));
+        };
+    },
+};
+//# sourceMappingURL=structural-blame.js.map

package/dist/mcp/tools/structural-blame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-blame.js","sourceRoot":"","sources":["../../../src/mcp/tools/structural-blame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,kEAAkE;QAClE,gEAAgE;QAChE,gEAAgE;QAChE,4BAA4B;IAC9B,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAE7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YACnE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;YAEjC,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAC1C,IAAI,EACJ,UAAU,EACV,QAAQ,IAAI,EAAE,CACf,CAAC;YAEF,GAAG,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAE/C,OAAO,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC;gBAC7C,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;gBAC9C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI;gBACtD,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjC,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;iBAC/B,CAAC,CAAC;aACJ,CAAC,CAAC,CAAC;QACN,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/structural-churn.d.ts

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

package/dist/mcp/tools/structural-churn.d.ts.map

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

package/dist/mcp/tools/structural-churn.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { toJsonObject } from "../../operations/result-dto.js";
+import { structuralChurnFromGraph } from "../../warp/warp-structural-churn.js";
+export const structuralChurnTool = {
+    name: "graft_churn",
+    description: "Structural churn report — which symbols change most frequently? " +
+        "Identifies maintenance hotspots by walking indexed commits and " +
+        "counting per-symbol change frequency.",
+    schema: {
+        path: z.string().optional(),
+        limit: z.number().int().positive().optional(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            const warp = await ctx.getWarp();
+            const options = {};
+            const pathArg = args["path"];
+            const limitArg = args["limit"];
+            if (typeof pathArg === "string")
+                options.path = pathArg;
+            if (typeof limitArg === "number")
+                options.limit = limitArg;
+            const result = await structuralChurnFromGraph(warp, options);
+            return ctx.respond("graft_churn", toJsonObject(result));
+        };
+    },
+};
+//# sourceMappingURL=structural-churn.js.map

package/dist/mcp/tools/structural-churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-churn.js","sourceRoot":"","sources":["../../../src/mcp/tools/structural-churn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,kEAAkE;QAClE,iEAAiE;QACjE,uCAAuC;IACzC,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAC9C;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,OAAO,GAAsC,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;YACxD,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC3D,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7D,OAAO,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/structural-log.d.ts

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

package/dist/mcp/tools/structural-log.d.ts.map

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