@flyingrobots/graft 0.4.0 → 0.6.0

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

@@ -0,0 +1,202 @@
+import { z } from "zod";
+import { readRange } from "../../operations/read-range.js";
+import { listProjectFiles } from "./git-files.js";
+import { evaluatePrecisionPolicy, getIndexedCommitCeilings, listTrackedFilesAtRef, loadFileContent, normalizeRepoPath, PrecisionSearchRequest, readRangeFromContent, requireRepoPath, resolveGitRef, searchLiveSymbols, searchWarpSymbols, } from "./precision.js";
+export async function runCodeShow(ctx, args, options) {
+    const symbolName = args["symbol"];
+    const rawPath = args["path"];
+    const ref = args["ref"];
+    const targetPath = rawPath !== undefined ? normalizeRepoPath(ctx.projectRoot, rawPath) : undefined;
+    const repoState = ctx.getRepoState();
+    const layer = ref !== undefined
+        ? "commit_worldline"
+        : repoState.dirty
+            ? "workspace_overlay"
+            : "ref_view";
+    let resolvedRef;
+    if (ref !== undefined) {
+        try {
+            resolvedRef = await resolveGitRef(ref, ctx.git, ctx.projectRoot);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return ctx.respond("code_show", {
+                symbol: symbolName,
+                error: message,
+                source: "live",
+                layer,
+            });
+        }
+    }
+    let locations;
+    let source = "live";
+    if (resolvedRef !== undefined) {
+        if (targetPath !== undefined) {
+            try {
+                requireRepoPath(ctx.projectRoot, targetPath);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return ctx.respond("code_show", {
+                    symbol: symbolName,
+                    error: message,
+                    source: "live",
+                    layer,
+                });
+            }
+        }
+        try {
+            const repoPath = targetPath !== undefined ? requireRepoPath(ctx.projectRoot, targetPath) : undefined;
+            if (options.allowWarp) {
+                const warp = await ctx.getWarp();
+                const ceilings = await getIndexedCommitCeilings(warp);
+                const ceiling = ceilings.get(resolvedRef);
+                if (ceiling !== undefined) {
+                    locations = await searchWarpSymbols(warp, new PrecisionSearchRequest({
+                        exactName: symbolName,
+                        ...(repoPath !== undefined ? { filePath: repoPath } : {}),
+                        ceiling,
+                    }));
+                    source = "warp";
+                }
+                else {
+                    const filePaths = repoPath !== undefined
+                        ? [repoPath]
+                        : await listTrackedFilesAtRef("", ctx.git, ctx.projectRoot, resolvedRef);
+                    locations = await searchLiveSymbols(ctx, filePaths, new PrecisionSearchRequest({ exactName: symbolName }), resolvedRef);
+                }
+            }
+            else {
+                const filePaths = repoPath !== undefined
+                    ? [repoPath]
+                    : await listTrackedFilesAtRef("", ctx.git, ctx.projectRoot, resolvedRef);
+                locations = await searchLiveSymbols(ctx, filePaths, new PrecisionSearchRequest({ exactName: symbolName }), resolvedRef);
+            }
+        }
+        catch {
+            const repoPath = targetPath !== undefined ? requireRepoPath(ctx.projectRoot, targetPath) : undefined;
+            const filePaths = repoPath !== undefined
+                ? [repoPath]
+                : await listTrackedFilesAtRef("", ctx.git, ctx.projectRoot, resolvedRef);
+            locations = await searchLiveSymbols(ctx, filePaths, new PrecisionSearchRequest({ exactName: symbolName }), resolvedRef);
+            source = "live";
+        }
+    }
+    else {
+        const filePaths = targetPath !== undefined
+            ? [targetPath]
+            : await listProjectFiles("", ctx.projectRoot, ctx.git);
+        locations = await searchLiveSymbols(ctx, filePaths, new PrecisionSearchRequest({ exactName: symbolName }));
+    }
+    const visibleLocations = [];
+    const fileCache = new Map();
+    let firstRefusal;
+    for (const location of locations) {
+        let content = fileCache.get(location.path);
+        if (content === undefined) {
+            const loaded = await loadFileContent(ctx, location.path, resolvedRef);
+            if (loaded === null)
+                continue;
+            fileCache.set(location.path, loaded);
+            content = loaded;
+        }
+        const refusal = evaluatePrecisionPolicy(ctx, location.path, content);
+        if (refusal !== null) {
+            firstRefusal ??= refusal;
+            continue;
+        }
+        visibleLocations.push(location);
+    }
+    if (visibleLocations.length === 0) {
+        if (firstRefusal !== undefined) {
+            return ctx.respond("code_show", {
+                path: firstRefusal.path,
+                projection: "refused",
+                reason: firstRefusal.reason,
+                reasonDetail: firstRefusal.reasonDetail,
+                next: [...firstRefusal.next],
+                actual: firstRefusal.actual,
+                source,
+                layer,
+            });
+        }
+        return ctx.respond("code_show", {
+            symbol: symbolName,
+            error: `Symbol '${symbolName}' not found`,
+            source,
+            layer,
+        });
+    }
+    if (visibleLocations.length > 1) {
+        ctx.recordFootprint({
+            paths: [...new Set(visibleLocations.map((m) => m.path))],
+            symbols: visibleLocations.map((m) => m.name),
+        });
+        return ctx.respond("code_show", {
+            symbol: symbolName,
+            ambiguous: true,
+            matches: visibleLocations,
+            source,
+            layer,
+        });
+    }
+    const loc = visibleLocations[0];
+    if (loc?.startLine === undefined || loc.endLine === undefined) {
+        return ctx.respond("code_show", {
+            symbol: symbolName,
+            kind: loc?.kind,
+            signature: loc?.signature,
+            path: loc?.path,
+            exported: loc?.exported,
+            error: "Symbol found but line range unavailable — use read_range with file_outline",
+            source,
+            layer,
+        });
+    }
+    const content = fileCache.get(loc.path) ?? await loadFileContent(ctx, loc.path, resolvedRef);
+    if (content === null) {
+        return ctx.respond("code_show", {
+            symbol: symbolName,
+            error: `File '${loc.path}' is no longer readable`,
+            source,
+            layer,
+        });
+    }
+    const rangeResult = resolvedRef !== undefined
+        ? readRangeFromContent(loc.path, content, loc.startLine, loc.endLine)
+        : await readRange(ctx.resolvePath(loc.path), loc.startLine, loc.endLine, { fs: ctx.fs });
+    ctx.recordFootprint({
+        paths: [loc.path],
+        symbols: [loc.name],
+        regions: [{ path: loc.path, startLine: loc.startLine, endLine: loc.endLine }],
+    });
+    return ctx.respond("code_show", {
+        symbol: loc.name,
+        kind: loc.kind,
+        signature: loc.signature,
+        path: loc.path,
+        exported: loc.exported,
+        startLine: loc.startLine,
+        endLine: loc.endLine,
+        content: rangeResult.content,
+        truncated: rangeResult.truncated ?? false,
+        ...(rangeResult.clipped === true ? { clipped: true } : {}),
+        source,
+        layer,
+    });
+}
+export const codeShowTool = {
+    name: "code_show",
+    description: "Focus on a symbol by name and return its source code in one call. " +
+        "Provide a path to target a specific file, or omit to search the " +
+        "project. Returns source, signature, and location.",
+    schema: {
+        symbol: z.string(),
+        path: z.string().optional(),
+        ref: z.string().optional(),
+    },
+    createHandler() {
+        return (args, ctx) => runCodeShow(ctx, args, { allowWarp: true });
+    },
+};
+//# sourceMappingURL=code-show.js.map

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

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

package/dist/mcp/tools/daemon-monitors.d.ts

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

package/dist/mcp/tools/daemon-monitors.d.ts.map

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

package/dist/mcp/tools/daemon-monitors.js

@@ -0,0 +1,12 @@
+export const daemonMonitorsTool = {
+    name: "daemon_monitors",
+    description: "List daemon-managed persistent repo monitors with lifecycle, backlog, and recent failure state.",
+    createHandler() {
+        return async (_args, ctx) => {
+            return ctx.respond("daemon_monitors", {
+                monitors: await ctx.listDaemonMonitors(),
+            });
+        };
+    },
+};
+//# sourceMappingURL=daemon-monitors.js.map

package/dist/mcp/tools/daemon-monitors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-monitors.js","sourceRoot":"","sources":["../../../src/mcp/tools/daemon-monitors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,iGAAiG;IACnG,aAAa;QACX,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE;gBACpC,QAAQ,EAAE,MAAM,GAAG,CAAC,kBAAkB,EAAE;aACzC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/daemon-repos.d.ts

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

package/dist/mcp/tools/daemon-repos.d.ts.map

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

package/dist/mcp/tools/daemon-repos.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export const daemonReposTool = {
+    name: "daemon_repos",
+    description: "List authorized canonical repos with bounded worktree, session, backlog, and monitor summary for daemon-wide inspection.",
+    schema: {
+        repoId: z.string().optional(),
+        cwd: z.string().optional(),
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            return ctx.respond("daemon_repos", {
+                ...await ctx.listDaemonRepos({
+                    repoId: args["repoId"],
+                    cwd: args["cwd"],
+                }),
+            });
+        };
+    },
+};
+//# sourceMappingURL=daemon-repos.js.map

package/dist/mcp/tools/daemon-repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-repos.js","sourceRoot":"","sources":["../../../src/mcp/tools/daemon-repos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,0HAA0H;IAC5H,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC3B;IACD,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE;gBACjC,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC;oBAC3B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;oBAC5C,GAAG,EAAE,IAAI,CAAC,KAAK,CAAuB;iBACvC,CAAC;aACH,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/daemon-sessions.d.ts

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

package/dist/mcp/tools/daemon-sessions.d.ts.map

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

package/dist/mcp/tools/daemon-sessions.js

@@ -0,0 +1,12 @@
+export const daemonSessionsTool = {
+    name: "daemon_sessions",
+    description: "List active daemon sessions with bind state, workspace identity, and capability posture, without exposing session-local receipts or shell output.",
+    createHandler() {
+        return async (_args, ctx) => {
+            return ctx.respond("daemon_sessions", {
+                sessions: await ctx.listDaemonSessions(),
+            });
+        };
+    },
+};
+//# sourceMappingURL=daemon-sessions.js.map

package/dist/mcp/tools/daemon-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-sessions.js","sourceRoot":"","sources":["../../../src/mcp/tools/daemon-sessions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mJAAmJ;IACrJ,aAAa;QACX,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE;gBACpC,QAAQ,EAAE,MAAM,GAAG,CAAC,kBAAkB,EAAE;aACzC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/daemon-status.d.ts

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

package/dist/mcp/tools/daemon-status.d.ts.map

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

package/dist/mcp/tools/daemon-status.js

@@ -0,0 +1,10 @@
+export const daemonStatusTool = {
+    name: "daemon_status",
+    description: "Return daemon-wide health, authorization counts, and default capability posture for the local control plane.",
+    createHandler() {
+        return async (_args, ctx) => {
+            return ctx.respond("daemon_status", { ...await ctx.getDaemonStatus() });
+        };
+    },
+};
+//# sourceMappingURL=daemon-status.js.map

package/dist/mcp/tools/daemon-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-status.js","sourceRoot":"","sources":["../../../src/mcp/tools/daemon-status.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,8GAA8G;IAChH,aAAa;QACX,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/diagnostic-models.d.ts

@@ -0,0 +1,85 @@
+import type { BurdenByKind, BurdenKind } from "../burden.js";
+import type { RuntimeObservabilityState } from "../runtime-observability.js";
+import type { RuntimeCausalContext } from "../runtime-causal-context.js";
+import type { GovernorDepth } from "../../session/types.js";
+import type { PersistedLocalHistorySummary, RepoConcurrencySummary } from "../persisted-local-history.js";
+import type { RuntimeWorkspaceOverlayFooting } from "../runtime-workspace-overlay.js";
+import type { CausalSurfaceNextAction } from "../../contracts/causal-surface-next-action.js";
+export interface SetBudgetResponse {
+    readonly budget: {
+        readonly total: number;
+        readonly consumed: number;
+        readonly remaining: number;
+        readonly fraction: number;
+    } | null;
+}
+export interface StatsResponse {
+    readonly totalReads: number;
+    readonly totalOutlines: number;
+    readonly totalRefusals: number;
+    readonly totalCacheHits: number;
+    readonly totalBytesReturned: number;
+    readonly totalBytesAvoidedByCache: number;
+    readonly totalNonReadBytesReturned: number;
+    readonly burdenByKind: Readonly<BurdenByKind>;
+}
+export interface ExplainResponse {
+    readonly code: string;
+    readonly meaning?: string | undefined;
+    readonly action?: string | undefined;
+    readonly error?: string | undefined;
+    readonly knownCodes?: string | undefined;
+}
+export interface DoctorBurdenSummary {
+    readonly totalBytesReturned: number;
+    readonly totalNonReadBytesReturned: number;
+    readonly topKind: BurdenKind | null;
+    readonly topBytesReturned: number;
+    readonly topCalls: number;
+}
+export interface DoctorResponse {
+    readonly projectRoot: string;
+    readonly parserHealthy: boolean;
+    readonly thresholds: {
+        readonly lines: number;
+        readonly bytes: number;
+    };
+    readonly sessionDepth: GovernorDepth;
+    readonly totalMessages: number;
+    readonly burdenSummary: DoctorBurdenSummary;
+    readonly runtimeObservability: RuntimeObservabilityState;
+    readonly causalContext: RuntimeCausalContext;
+    readonly latestReadEvent: PersistedLocalHistorySummary["latestReadEvent"];
+    readonly latestStageEvent: PersistedLocalHistorySummary["latestStageEvent"];
+    readonly latestTransitionEvent: PersistedLocalHistorySummary["latestTransitionEvent"];
+    readonly repoConcurrency: RepoConcurrencySummary | null;
+    readonly checkoutEpoch: unknown;
+    readonly lastTransition: unknown;
+    readonly semanticTransition: unknown;
+    readonly workspaceOverlayId: unknown;
+    readonly workspaceOverlay: unknown;
+    readonly workspaceOverlayFooting: RuntimeWorkspaceOverlayFooting | null;
+    readonly stagedTarget: unknown;
+    readonly attribution: PersistedLocalHistorySummary["attribution"];
+    readonly persistedLocalHistory: PersistedLocalHistorySummary;
+    readonly recommendedNextAction: CausalSurfaceNextAction;
+}
+export interface RunCapturePolicyBoundary {
+    readonly kind: "shell_escape_hatch";
+    readonly boundedReadContract: false;
+    readonly policyEnforced: false;
+}
+export interface RunCaptureResponse {
+    readonly output: string;
+    readonly totalLines: number;
+    readonly tailedLines: number;
+    readonly logPath: string | null;
+    readonly logRedactions: number;
+    readonly logPersistenceEnabled: boolean;
+    readonly truncated: boolean;
+    readonly policyBoundary: RunCapturePolicyBoundary;
+    readonly disabled?: boolean | undefined;
+    readonly error?: string | undefined;
+    readonly stderr?: string | undefined;
+}
+//# sourceMappingURL=diagnostic-models.d.ts.map

package/dist/mcp/tools/diagnostic-models.d.ts.map

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

package/dist/mcp/tools/diagnostic-models.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Diagnostic tool response models — explicit types for diagnostic tool outputs
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=diagnostic-models.js.map

package/dist/mcp/tools/diagnostic-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-models.js","sourceRoot":"","sources":["../../../src/mcp/tools/diagnostic-models.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E"}

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

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

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

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

package/dist/mcp/tools/doctor.js

@@ -0,0 +1,54 @@
+import { STATIC_THRESHOLDS } from "../../policy/evaluate.js";
+import { topBurdenKind, totalNonReadBytesReturned } from "../burden.js";
+import { buildRuntimeStagedTarget } from "../runtime-staged-target.js";
+import { deriveCausalSurfaceNextAction } from "../semantic-transition-guidance.js";
+import { toJsonObject } from "../../operations/result-dto.js";
+export const doctorTool = {
+    name: "doctor",
+    description: "Runtime health check. Shows project root, parser status, active " +
+        "thresholds, session depth, message count, and burden summary.",
+    createHandler() {
+        return async (_args, ctx) => {
+            const repoState = ctx.getRepoState();
+            const causalContext = ctx.getCausalContext();
+            const workspaceOverlayFooting = await ctx.getWorkspaceOverlayFooting();
+            const metrics = ctx.metrics.snapshot();
+            const topBurden = topBurdenKind(metrics.burdenByKind);
+            const persistedLocalHistory = await ctx.getPersistedLocalHistorySummary();
+            const repoConcurrency = await ctx.getRepoConcurrencySummary();
+            const recommendedNextAction = deriveCausalSurfaceNextAction(persistedLocalHistory.nextAction, repoState.semanticTransition, repoConcurrency);
+            const response = {
+                projectRoot: ctx.projectRoot,
+                parserHealthy: true,
+                thresholds: { lines: STATIC_THRESHOLDS.lines, bytes: STATIC_THRESHOLDS.bytes },
+                sessionDepth: ctx.governor.getGovernorDepth(),
+                totalMessages: ctx.governor.getMessageCount(),
+                burdenSummary: {
+                    totalBytesReturned: metrics.bytesReturned,
+                    totalNonReadBytesReturned: totalNonReadBytesReturned(metrics.burdenByKind),
+                    topKind: topBurden?.kind ?? null,
+                    topBytesReturned: topBurden?.bytesReturned ?? 0,
+                    topCalls: topBurden?.calls ?? 0,
+                },
+                runtimeObservability: ctx.observability,
+                causalContext,
+                latestReadEvent: persistedLocalHistory.latestReadEvent,
+                latestStageEvent: persistedLocalHistory.latestStageEvent,
+                latestTransitionEvent: persistedLocalHistory.latestTransitionEvent,
+                repoConcurrency,
+                checkoutEpoch: repoState.checkoutEpoch,
+                lastTransition: repoState.lastTransition,
+                semanticTransition: repoState.semanticTransition,
+                workspaceOverlayId: repoState.workspaceOverlayId,
+                workspaceOverlay: repoState.workspaceOverlay,
+                workspaceOverlayFooting,
+                stagedTarget: buildRuntimeStagedTarget(ctx.getWorkspaceStatus(), causalContext, repoState, persistedLocalHistory.attribution),
+                attribution: persistedLocalHistory.attribution,
+                persistedLocalHistory,
+                recommendedNextAction,
+            };
+            return ctx.respond("doctor", toJsonObject(response));
+        };
+    },
+};
+//# sourceMappingURL=doctor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/mcp/tools/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,kEAAkE;QAClE,+DAA+D;IACjE,aAAa;QACX,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;YACrC,MAAM,aAAa,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC7C,MAAM,uBAAuB,GAAG,MAAM,GAAG,CAAC,0BAA0B,EAAE,CAAC;YACvE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtD,MAAM,qBAAqB,GAAG,MAAM,GAAG,CAAC,+BAA+B,EAAE,CAAC;YAC1E,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,yBAAyB,EAAE,CAAC;YAC9D,MAAM,qBAAqB,GAAG,6BAA6B,CACzD,qBAAqB,CAAC,UAAU,EAChC,SAAS,CAAC,kBAAkB,EAC5B,eAAe,CAChB,CAAC;YACF,MAAM,QAAQ,GAAmB;gBAC/B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,aAAa,EAAE,IAAI;gBACnB,UAAU,EAAE,EAAE,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE;gBAC9E,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,gBAAgB,EAAE;gBAC7C,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE;gBAC7C,aAAa,EAAE;oBACb,kBAAkB,EAAE,OAAO,CAAC,aAAa;oBACzC,yBAAyB,EAAE,yBAAyB,CAAC,OAAO,CAAC,YAAY,CAAC;oBAC1E,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,IAAI;oBAChC,gBAAgB,EAAE,SAAS,EAAE,aAAa,IAAI,CAAC;oBAC/C,QAAQ,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;iBAChC;gBACD,oBAAoB,EAAE,GAAG,CAAC,aAAa;gBACvC,aAAa;gBACb,eAAe,EAAE,qBAAqB,CAAC,eAAe;gBACtD,gBAAgB,EAAE,qBAAqB,CAAC,gBAAgB;gBACxD,qBAAqB,EAAE,qBAAqB,CAAC,qBAAqB;gBAClE,eAAe;gBACf,aAAa,EAAE,SAAS,CAAC,aAAa;gBACtC,cAAc,EAAE,SAAS,CAAC,cAAc;gBACxC,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;gBAChD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;gBAChD,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;gBAC5C,uBAAuB;gBACvB,YAAY,EAAE,wBAAwB,CACpC,GAAG,CAAC,kBAAkB,EAAE,EACxB,aAAa,EACb,SAAS,EACT,qBAAqB,CAAC,WAAW,CAClC;gBACD,WAAW,EAAE,qBAAqB,CAAC,WAAW;gBAC9C,qBAAqB;gBACrB,qBAAqB;aACtB,CAAC;YACF,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/mcp/tools/explain.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+const EXPLANATIONS = {
+    CONTENT: {
+        meaning: "File is within size thresholds — full content returned.",
+        action: "No action needed. You have the complete file.",
+    },
+    OUTLINE: {
+        meaning: "File exceeds line or byte thresholds. Structural outline returned instead of content.",
+        action: "Use read_range with the jump table to read specific sections. Do not re-request the full file.",
+    },
+    SESSION_CAP: {
+        meaning: "Session-depth byte cap triggered. The file might fit static thresholds but exceeds the dynamic session cap.",
+        action: "Use read_range for targeted reads. Consider whether you truly need this file at this stage of the session.",
+    },
+    BINARY: {
+        meaning: "Binary file (image, PDF, etc.) cannot be usefully read as text.",
+        action: "Use file_outline for metadata. Check for a text alternative.",
+    },
+    LOCKFILE: {
+        meaning: "Machine-generated lockfile is not useful to read directly.",
+        action: "Read the package manifest (package.json, Cargo.toml, etc.) for dependency info instead.",
+    },
+    MINIFIED: {
+        meaning: "Minified file is not human-readable.",
+        action: "Look for the unminified source file.",
+    },
+    BUILD_OUTPUT: {
+        meaning: "File is in a build output directory (dist/, build/, .next/, etc.).",
+        action: "Read the source in src/ instead of the compiled output.",
+    },
+    SECRET: {
+        meaning: "File may contain secrets (keys, credentials, environment variables).",
+        action: "Check for a .example or template version of this file.",
+    },
+    BUDGET_CAP: {
+        meaning: "File exceeds the budget-proportional byte cap. No single read may consume more than 5% of remaining budget.",
+        action: "Use file_outline or read_range for targeted reads. Consider whether this file is worth the budget cost.",
+    },
+    UNSUPPORTED_LANGUAGE: {
+        meaning: "The file type has no parser-backed structural outline in the current build of Graft.",
+        action: "Use read_range or a full read when appropriate. Do not treat the empty outline as parser-derived symbol structure.",
+    },
+    GRAFTIGNORE: {
+        meaning: "File matches a pattern in .graftignore.",
+        action: "Check .graftignore if you believe this file should be readable.",
+    },
+    REREAD_UNCHANGED: {
+        meaning: "File was already read and has not changed. Cached outline returned.",
+        action: "Use the cached outline and jump table. The file content has not changed since your last read.",
+    },
+    CHANGED_SINCE_LAST_READ: {
+        meaning: "File changed since last read. Structural diff returned showing what changed.",
+        action: "Review the diff to understand what changed. Use read_range for details on changed sections.",
+    },
+};
+export const explainTool = {
+    name: "explain",
+    description: "Explain a graft reason code. Returns human-readable meaning and " +
+        "recommended next action for any reason code returned by graft tools.",
+    schema: { code: z.string() },
+    createHandler() {
+        return (args, ctx) => {
+            const code = args["code"].toUpperCase();
+            const entry = EXPLANATIONS[code];
+            if (entry === undefined) {
+                const known = Object.keys(EXPLANATIONS).join(", ");
+                return ctx.respond("explain", {
+                    code,
+                    error: "Unknown reason code",
+                    knownCodes: known,
+                });
+            }
+            return ctx.respond("explain", {
+                code,
+                meaning: entry.meaning,
+                action: entry.action,
+            });
+        };
+    },
+};
+//# sourceMappingURL=explain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/mcp/tools/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,YAAY,GAAkE;IAClF,OAAO,EAAE;QACP,OAAO,EAAE,yDAAyD;QAClE,MAAM,EAAE,+CAA+C;KACxD;IACD,OAAO,EAAE;QACP,OAAO,EAAE,uFAAuF;QAChG,MAAM,EAAE,gGAAgG;KACzG;IACD,WAAW,EAAE;QACX,OAAO,EAAE,6GAA6G;QACtH,MAAM,EAAE,4GAA4G;KACrH;IACD,MAAM,EAAE;QACN,OAAO,EAAE,iEAAiE;QAC1E,MAAM,EAAE,8DAA8D;KACvE;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4DAA4D;QACrE,MAAM,EAAE,yFAAyF;KAClG;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sCAAsC;QAC/C,MAAM,EAAE,sCAAsC;KAC/C;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,oEAAoE;QAC7E,MAAM,EAAE,yDAAyD;KAClE;IACD,MAAM,EAAE;QACN,OAAO,EAAE,sEAAsE;QAC/E,MAAM,EAAE,wDAAwD;KACjE;IACD,UAAU,EAAE;QACV,OAAO,EAAE,6GAA6G;QACtH,MAAM,EAAE,yGAAyG;KAClH;IACD,oBAAoB,EAAE;QACpB,OAAO,EAAE,sFAAsF;QAC/F,MAAM,EAAE,oHAAoH;KAC7H;IACD,WAAW,EAAE;QACX,OAAO,EAAE,yCAAyC;QAClD,MAAM,EAAE,iEAAiE;KAC1E;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,qEAAqE;QAC9E,MAAM,EAAE,+FAA+F;KACxG;IACD,uBAAuB,EAAE;QACvB,OAAO,EAAE,8EAA8E;QACvF,MAAM,EAAE,6FAA6F;KACtG;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,kEAAkE;QAClE,sEAAsE;IACxE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC5B,aAAa;QACX,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,IAAI,GAAI,IAAI,CAAC,MAAM,CAAY,CAAC,WAAW,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnD,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE;oBAC5B,IAAI;oBACJ,KAAK,EAAE,qBAAqB;oBAC5B,UAAU,EAAE,KAAK;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE;gBAC5B,IAAI;gBACJ,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/file-outline.d.ts

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

package/dist/mcp/tools/file-outline.d.ts.map

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