@flyingrobots/graft 0.5.0 → 0.6.0

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

@@ -0,0 +1,23 @@
+function parseBooleanFlag(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    if (["0", "false", "no", "off"].includes(normalized))
+        return false;
+    if (["1", "true", "yes", "on"].includes(normalized))
+        return true;
+    return fallback;
+}
+export function resolveRunCaptureConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const base = {
+        enabled: parseBooleanFlag(env["GRAFT_ENABLE_RUN_CAPTURE"], true),
+        persistLogs: parseBooleanFlag(env["GRAFT_RUN_CAPTURE_PERSIST"], true),
+        redactLogs: parseBooleanFlag(env["GRAFT_RUN_CAPTURE_REDACT"], true),
+    };
+    return {
+        ...base,
+        ...options.overrides,
+    };
+}
+//# sourceMappingURL=run-capture-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-capture-config.js","sourceRoot":"","sources":["../../src/mcp/run-capture-config.ts"],"names":[],"mappings":"AAWA,SAAS,gBAAgB,CAAC,KAAyB,EAAE,QAAiB;IACpE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,CAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAA0C,EAAE;IAE5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAqB;QAC7B,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,IAAI,CAAC;QAChE,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,IAAI,CAAC;QACrE,UAAU,EAAE,gBAAgB,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,IAAI,CAAC;KACpE,CAAC;IACF,OAAO;QACL,GAAG,IAAI;QACP,GAAG,OAAO,CAAC,SAAS;KACrB,CAAC;AACJ,CAAC"}

package/dist/mcp/runtime-causal-context.d.ts

@@ -0,0 +1,22 @@
+export interface RuntimeCausalContext {
+    readonly transportSessionId: string;
+    readonly workspaceSliceId: string;
+    readonly causalSessionId: string;
+    readonly strandId: string;
+    readonly checkoutEpochId: string;
+    readonly warpWriterId: string;
+    readonly stability: "runtime_local";
+    readonly provenanceLevel: "artifact_history";
+}
+export declare function buildCheckoutEpochId(repoId: string, worktreeId: string, checkoutEpoch: number): string;
+export declare function buildCausalSessionId(repoId: string, worktreeId: string, transportSessionId: string, workspaceSliceId: string): string;
+export declare function buildStrandId(causalSessionId: string, checkoutEpochId: string, warpWriterId: string): string;
+export declare function buildRuntimeCausalContext(input: {
+    readonly transportSessionId: string;
+    readonly workspaceSliceId: string;
+    readonly repoId: string;
+    readonly worktreeId: string;
+    readonly checkoutEpoch: number;
+    readonly warpWriterId: string;
+}): RuntimeCausalContext;
+//# sourceMappingURL=runtime-causal-context.d.ts.map

package/dist/mcp/runtime-causal-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-causal-context.d.ts","sourceRoot":"","sources":["../../src/mcp/runtime-causal-context.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;CAC9C;AAMD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAER;AAED,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,oBAAoB,CAsBvB"}

package/dist/mcp/runtime-causal-context.js

@@ -0,0 +1,28 @@
+import * as crypto from "node:crypto";
+function stableId(prefix, input) {
+    return `${prefix}:${crypto.createHash("sha256").update(input).digest("hex").slice(0, 16)}`;
+}
+export function buildCheckoutEpochId(repoId, worktreeId, checkoutEpoch) {
+    return stableId("epoch", `${repoId}:${worktreeId}:${String(checkoutEpoch)}`);
+}
+export function buildCausalSessionId(repoId, worktreeId, transportSessionId, workspaceSliceId) {
+    return stableId("causal", `${repoId}:${worktreeId}:${transportSessionId}:${workspaceSliceId}`);
+}
+export function buildStrandId(causalSessionId, checkoutEpochId, warpWriterId) {
+    return stableId("strand", `${causalSessionId}:${checkoutEpochId}:${warpWriterId}`);
+}
+export function buildRuntimeCausalContext(input) {
+    const checkoutEpochId = buildCheckoutEpochId(input.repoId, input.worktreeId, input.checkoutEpoch);
+    const causalSessionId = buildCausalSessionId(input.repoId, input.worktreeId, input.transportSessionId, input.workspaceSliceId);
+    return {
+        transportSessionId: input.transportSessionId,
+        workspaceSliceId: input.workspaceSliceId,
+        causalSessionId,
+        strandId: buildStrandId(causalSessionId, checkoutEpochId, input.warpWriterId),
+        checkoutEpochId,
+        warpWriterId: input.warpWriterId,
+        stability: "runtime_local",
+        provenanceLevel: "artifact_history",
+    };
+}
+//# sourceMappingURL=runtime-causal-context.js.map

package/dist/mcp/runtime-causal-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-causal-context.js","sourceRoot":"","sources":["../../src/mcp/runtime-causal-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAatC,SAAS,QAAQ,CAAC,MAAc,EAAE,KAAa;IAC7C,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,UAAkB,EAClB,aAAqB;IAErB,OAAO,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,IAAI,UAAU,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,UAAkB,EAClB,kBAA0B,EAC1B,gBAAwB;IAExB,OAAO,QAAQ,CAAC,QAAQ,EAAE,GAAG,MAAM,IAAI,UAAU,IAAI,kBAAkB,IAAI,gBAAgB,EAAE,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,eAAuB,EACvB,eAAuB,EACvB,YAAoB;IAEpB,OAAO,QAAQ,CAAC,QAAQ,EAAE,GAAG,eAAe,IAAI,eAAe,IAAI,YAAY,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAOzC;IACC,MAAM,eAAe,GAAG,oBAAoB,CAC1C,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,aAAa,CACpB,CAAC;IACF,MAAM,eAAe,GAAG,oBAAoB,CAC1C,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,kBAAkB,EACxB,KAAK,CAAC,gBAAgB,CACvB,CAAC;IACF,OAAO;QACL,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,eAAe;QACf,QAAQ,EAAE,aAAa,CAAC,eAAe,EAAE,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC;QAC7E,eAAe;QACf,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,eAAe;QAC1B,eAAe,EAAE,kBAAkB;KACpC,CAAC;AACJ,CAAC"}

package/dist/mcp/runtime-observability.d.ts

@@ -0,0 +1,102 @@
+import type { JsonCodec } from "../ports/codec.js";
+import type { FileSystem } from "../ports/filesystem.js";
+import type { MetricsSnapshot } from "./metrics.js";
+import type { BurdenKind } from "./burden.js";
+import type { GovernorDepth } from "../session/types.js";
+export type RuntimeLogPolicy = "metadata_only";
+export interface RuntimeObservabilityState {
+    readonly enabled: boolean;
+    readonly logPath: string;
+    readonly maxBytes: number;
+    readonly logPolicy: RuntimeLogPolicy;
+}
+export interface ResolveRuntimeObservabilityOptions {
+    readonly graftDir: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly overrides?: Partial<RuntimeObservabilityState>;
+}
+export declare function resolveRuntimeObservabilityState(options: ResolveRuntimeObservabilityOptions): RuntimeObservabilityState;
+export interface RuntimeSessionStartedEvent {
+    readonly event: "session_started";
+    readonly sessionId: string;
+    readonly logPath: string;
+    readonly logPolicy: RuntimeLogPolicy;
+}
+export interface RuntimeToolCallStartedEvent {
+    readonly event: "tool_call_started";
+    readonly sessionId: string;
+    readonly traceId: string;
+    readonly tool: string;
+    readonly argKeys: readonly string[];
+    readonly sessionDepth: GovernorDepth;
+}
+/**
+ * Per-tool-call footprint capturing which files, symbols, and regions
+ * were observed. Enables provenance tracing at sub-file granularity.
+ */
+export interface ToolCallFootprint {
+    /** File paths read or scanned by this tool call. */
+    readonly paths: readonly string[];
+    /** Symbol names inspected (when available from outline/precision tools). */
+    readonly symbols: readonly string[];
+    /** Line regions accessed (when available from read_range). */
+    readonly regions: readonly ToolCallFootprintRegion[];
+}
+/** A line region within a specific file. */
+export interface ToolCallFootprintRegion {
+    readonly path: string;
+    readonly startLine: number;
+    readonly endLine: number;
+}
+export interface RuntimeToolCallCompletedEvent {
+    readonly event: "tool_call_completed";
+    readonly sessionId: string;
+    readonly traceId: string;
+    readonly seq: number;
+    readonly tool: string;
+    readonly latencyMs: number;
+    readonly projection: string;
+    readonly reason: string;
+    readonly burdenKind: BurdenKind;
+    readonly nonReadBurden: boolean;
+    readonly returnedBytes: number;
+    readonly fileBytes: number | null;
+    readonly sessionDepth: GovernorDepth;
+    readonly tripwireSignals: readonly string[];
+    readonly metrics: MetricsSnapshot;
+    /** Optional sub-file footprint for provenance granularity. */
+    readonly footprint?: ToolCallFootprint;
+}
+export type RuntimeFailureKind = "validation_error" | "tool_error" | "unknown_error";
+export interface RuntimeToolCallFailedEvent {
+    readonly event: "tool_call_failed";
+    readonly sessionId: string;
+    readonly traceId: string;
+    readonly tool: string;
+    readonly latencyMs: number;
+    readonly sessionDepth: GovernorDepth;
+    readonly argKeys: readonly string[];
+    readonly errorKind: RuntimeFailureKind;
+    readonly errorName: string;
+}
+type RuntimeEvent = RuntimeSessionStartedEvent | RuntimeToolCallStartedEvent | RuntimeToolCallCompletedEvent | RuntimeToolCallFailedEvent;
+export interface RuntimeEventLoggerOptions {
+    readonly fs: FileSystem;
+    readonly codec: JsonCodec;
+    readonly logPath: string;
+    readonly maxBytes: number;
+}
+export declare function ensureGraftDirExcluded(projectRoot: string, graftDir: string, fs: FileSystem): Promise<void>;
+export declare function classifyRuntimeFailure(error: unknown): {
+    kind: RuntimeFailureKind;
+    name: string;
+};
+export { sanitizeArgValues } from "./secret-scrub.js";
+export declare function sanitizeArgKeys(args: Record<string, unknown>): string[];
+export declare class RuntimeEventLogger {
+    private readonly logWriter;
+    private queue;
+    constructor(options: RuntimeEventLoggerOptions);
+    log(event: RuntimeEvent): Promise<void>;
+}
+//# sourceMappingURL=runtime-observability.d.ts.map

package/dist/mcp/runtime-observability.d.ts.map

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

package/dist/mcp/runtime-observability.js

@@ -0,0 +1,95 @@
+import * as path from "node:path";
+import { ZodError } from "zod";
+import { RotatingNdjsonLog } from "../adapters/rotating-ndjson-log.js";
+const DEFAULT_MAX_BYTES = 1_048_576;
+const DEFAULT_POLICY = "metadata_only";
+function parseBooleanFlag(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    if (["0", "false", "no", "off"].includes(normalized))
+        return false;
+    if (["1", "true", "yes", "on"].includes(normalized))
+        return true;
+    return fallback;
+}
+function parsePositiveInteger(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
+}
+export function resolveRuntimeObservabilityState(options) {
+    const env = options.env ?? process.env;
+    const base = {
+        enabled: parseBooleanFlag(env["GRAFT_ENABLE_MCP_RUNTIME_LOG"], true),
+        logPath: env["GRAFT_MCP_RUNTIME_LOG_PATH"]?.trim() ?? path.join(options.graftDir, "logs", "mcp-runtime.ndjson"),
+        maxBytes: parsePositiveInteger(env["GRAFT_MCP_RUNTIME_LOG_MAX_BYTES"], DEFAULT_MAX_BYTES),
+        logPolicy: DEFAULT_POLICY,
+    };
+    return {
+        ...base,
+        ...options.overrides,
+    };
+}
+export async function ensureGraftDirExcluded(projectRoot, graftDir, fs) {
+    const relative = path.relative(projectRoot, graftDir);
+    if (relative.length === 0 || relative.startsWith("..") || path.isAbsolute(relative)) {
+        return;
+    }
+    const entry = relative.replaceAll(path.sep, "/").replace(/\/?$/, "/");
+    const excludePath = path.join(projectRoot, ".git", "info", "exclude");
+    let existing;
+    try {
+        existing = await fs.readFile(excludePath, "utf-8");
+    }
+    catch {
+        return;
+    }
+    const entries = existing
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    if (entries.includes(entry)) {
+        return;
+    }
+    const prefix = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
+    await fs.appendFile(excludePath, `${prefix}${entry}\n`, "utf-8");
+}
+export function classifyRuntimeFailure(error) {
+    if (error instanceof ZodError) {
+        return { kind: "validation_error", name: error.name };
+    }
+    if (error instanceof Error) {
+        return { kind: "tool_error", name: error.name };
+    }
+    return { kind: "unknown_error", name: "UnknownError" };
+}
+export { sanitizeArgValues } from "./secret-scrub.js";
+export function sanitizeArgKeys(args) {
+    return Object.keys(args).sort();
+}
+export class RuntimeEventLogger {
+    logWriter;
+    queue = Promise.resolve();
+    constructor(options) {
+        this.logWriter = new RotatingNdjsonLog({
+            fs: options.fs,
+            codec: options.codec,
+            logPath: options.logPath,
+            maxBytes: options.maxBytes,
+        });
+    }
+    log(event) {
+        const prior = this.queue.catch((_error) => undefined);
+        this.queue = prior
+            .then(async () => {
+            await this.logWriter.append({
+                ts: new Date().toISOString(),
+                ...event,
+            });
+        });
+        return this.queue;
+    }
+}
+//# sourceMappingURL=runtime-observability.js.map

package/dist/mcp/runtime-observability.js.map

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

package/dist/mcp/runtime-staged-target.d.ts

@@ -0,0 +1,28 @@
+import type { AttributionSummary, StagedTarget } from "../contracts/causal-ontology.js";
+import type { RepoObservation } from "./repo-state.js";
+import type { RuntimeCausalContext } from "./runtime-causal-context.js";
+import type { WorkspaceStatus } from "./workspace-router.js";
+export interface RuntimeStagedTargetNone {
+    readonly availability: "none";
+    readonly stability: "runtime_local";
+    readonly provenanceLevel: "artifact_history";
+}
+export interface RuntimeStagedTargetFullFile {
+    readonly availability: "full_file";
+    readonly stability: "runtime_local";
+    readonly provenanceLevel: "artifact_history";
+    readonly attribution: AttributionSummary;
+    readonly target: StagedTarget;
+}
+export interface RuntimeStagedTargetAmbiguous {
+    readonly availability: "ambiguous";
+    readonly stability: "runtime_local";
+    readonly provenanceLevel: "artifact_history";
+    readonly attribution: AttributionSummary;
+    readonly reason: "missing_head_commit" | "missing_workspace_overlay" | "modified_path_selection_requires_deeper_evidence";
+    readonly observedStagedPaths: number;
+    readonly ambiguousPaths: readonly string[];
+}
+export type RuntimeStagedTarget = RuntimeStagedTargetNone | RuntimeStagedTargetFullFile | RuntimeStagedTargetAmbiguous;
+export declare function buildRuntimeStagedTarget(status: WorkspaceStatus, causalContext: RuntimeCausalContext, repoState: RepoObservation, attribution: AttributionSummary): RuntimeStagedTarget;
+//# sourceMappingURL=runtime-staged-target.d.ts.map

package/dist/mcp/runtime-staged-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-staged-target.d.ts","sourceRoot":"","sources":["../../src/mcp/runtime-staged-target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,MAAM,EACX,qBAAqB,GACrB,2BAA2B,GAC3B,kDAAkD,CAAC;IACvD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,mBAAmB,GAC3B,uBAAuB,GACvB,2BAA2B,GAC3B,4BAA4B,CAAC;AA+BjC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,oBAAoB,EACnC,SAAS,EAAE,eAAe,EAC1B,WAAW,EAAE,kBAAkB,GAC9B,mBAAmB,CAsFrB"}

package/dist/mcp/runtime-staged-target.js

@@ -0,0 +1,101 @@
+import * as crypto from "node:crypto";
+const FULL_FILE_SAFE_STATUSES = new Set(["A", "D", "R", "C", "T"]);
+function stableId(prefix, input) {
+    return `${prefix}:${crypto.createHash("sha256").update(input).digest("hex").slice(0, 16)}`;
+}
+function parseMergedStatusLine(line) {
+    if (line.length < 4)
+        return null;
+    return {
+        stagedStatus: line[0] ?? " ",
+        worktreeStatus: line[1] ?? " ",
+        path: line.slice(3),
+    };
+}
+function stagedEntries(statusLines) {
+    return statusLines
+        .map(parseMergedStatusLine)
+        .filter((entry) => entry !== null && entry.stagedStatus !== " " && entry.stagedStatus !== "?");
+}
+function isFullFileSafe(entry) {
+    return entry.worktreeStatus === " " && FULL_FILE_SAFE_STATUSES.has(entry.stagedStatus);
+}
+export function buildRuntimeStagedTarget(status, causalContext, repoState, attribution) {
+    const observedEntries = stagedEntries(repoState.statusLines);
+    if (observedEntries.length === 0) {
+        return {
+            availability: "none",
+            stability: "runtime_local",
+            provenanceLevel: "artifact_history",
+        };
+    }
+    if (repoState.headSha === null) {
+        return {
+            availability: "ambiguous",
+            stability: "runtime_local",
+            provenanceLevel: "artifact_history",
+            attribution,
+            reason: "missing_head_commit",
+            observedStagedPaths: observedEntries.length,
+            ambiguousPaths: observedEntries.map((entry) => entry.path),
+        };
+    }
+    if (repoState.workspaceOverlayId === null || status.repoId === null || status.worktreeId === null) {
+        return {
+            availability: "ambiguous",
+            stability: "runtime_local",
+            provenanceLevel: "artifact_history",
+            attribution,
+            reason: "missing_workspace_overlay",
+            observedStagedPaths: observedEntries.length,
+            ambiguousPaths: observedEntries.map((entry) => entry.path),
+        };
+    }
+    const ambiguousEntries = observedEntries.filter((entry) => !isFullFileSafe(entry));
+    if (ambiguousEntries.length > 0) {
+        return {
+            availability: "ambiguous",
+            stability: "runtime_local",
+            provenanceLevel: "artifact_history",
+            attribution,
+            reason: "modified_path_selection_requires_deeper_evidence",
+            observedStagedPaths: observedEntries.length,
+            ambiguousPaths: ambiguousEntries.map((entry) => entry.path),
+        };
+    }
+    const selectionEntries = observedEntries.map((entry) => ({
+        path: entry.path,
+        symbols: [],
+        regions: [],
+    }));
+    const target = {
+        targetId: stableId("target", JSON.stringify({
+            repoId: status.repoId,
+            worktreeId: status.worktreeId,
+            checkoutEpochId: causalContext.checkoutEpochId,
+            workspaceOverlayId: repoState.workspaceOverlayId,
+            headSha: repoState.headSha,
+            paths: selectionEntries.map((entry) => entry.path),
+        })),
+        targetKind: "staged_target",
+        repoId: status.repoId,
+        worktreeId: status.worktreeId,
+        checkoutEpochId: causalContext.checkoutEpochId,
+        workspaceOverlayId: repoState.workspaceOverlayId,
+        selectedAt: repoState.observedAt,
+        selectionKind: "full_file",
+        selectionEntries,
+        base: {
+            headCommitSha: repoState.headSha,
+            indexTreeSha: null,
+        },
+    };
+    return {
+        availability: "full_file",
+        stability: "runtime_local",
+        provenanceLevel: "artifact_history",
+        attribution,
+        target,
+    };
+}
+//# sourceMappingURL=runtime-staged-target.js.map

package/dist/mcp/runtime-staged-target.js.map

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

package/dist/mcp/runtime-workspace-overlay.d.ts

@@ -0,0 +1,45 @@
+import type { FileSystem } from "../ports/filesystem.js";
+import type { GitClient } from "../ports/git.js";
+import { TARGET_GIT_TRANSITION_HOOKS } from "../git/target-git-hook-bootstrap.js";
+import type { RepoTransition, WorkspaceOverlaySummary } from "./repo-state.js";
+export type GitHookBootstrapPosture = "absent" | "external_unknown" | "installed";
+export type WorkspaceOverlayObservationMode = "inferred_between_tool_calls" | "hook_observed_checkout_boundaries";
+export type WorkspaceOverlayLineagePosture = "stable" | "forked_after_transition";
+export type WorkspaceOverlayBoundaryAuthority = "none" | "repo_snapshot" | "hook_observed";
+export type WorkspaceOverlayDegradedReason = "target_repo_hooks_absent" | "target_repo_hooks_unrecognized" | "local_edit_watchers_absent";
+export interface GitTransitionHookEvent {
+    readonly hookName: (typeof TARGET_GIT_TRANSITION_HOOKS)[number];
+    readonly hookArgs: readonly string[];
+    readonly worktreeRoot: string;
+    readonly observedAt: string;
+}
+export interface GitHookBootstrapStatus {
+    readonly posture: GitHookBootstrapPosture;
+    readonly configuredCoreHooksPath: string | null;
+    readonly resolvedHooksPath: string;
+    readonly requiredHooks: readonly string[];
+    readonly presentHooks: readonly string[];
+    readonly missingHooks: readonly string[];
+    readonly supportsCheckoutBoundaries: boolean;
+}
+export interface RuntimeWorkspaceOverlayFooting {
+    readonly observationMode: WorkspaceOverlayObservationMode;
+    readonly lineagePosture: WorkspaceOverlayLineagePosture;
+    readonly boundaryAuthority: WorkspaceOverlayBoundaryAuthority;
+    readonly degraded: true;
+    readonly degradedReason: WorkspaceOverlayDegradedReason;
+    readonly checkoutEpoch: number;
+    readonly lastTransition: RepoTransition | null;
+    readonly workspaceOverlayId: string | null;
+    readonly workspaceOverlay: WorkspaceOverlaySummary | null;
+    readonly hookBootstrap: GitHookBootstrapStatus;
+    readonly latestHookEvent: GitTransitionHookEvent | null;
+}
+export declare function inspectGitHookBootstrap(fs: FileSystem, gitClient: GitClient, worktreeRoot: string, gitCommonDir: string): Promise<GitHookBootstrapStatus>;
+export declare function buildRuntimeWorkspaceOverlayFooting(fs: FileSystem, gitClient: GitClient, worktreeRoot: string, gitCommonDir: string, repoState: {
+    readonly checkoutEpoch: number;
+    readonly lastTransition: RepoTransition | null;
+    readonly workspaceOverlayId: string | null;
+    readonly workspaceOverlay: WorkspaceOverlaySummary | null;
+}): Promise<RuntimeWorkspaceOverlayFooting>;
+//# sourceMappingURL=runtime-workspace-overlay.d.ts.map

package/dist/mcp/runtime-workspace-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-workspace-overlay.d.ts","sourceRoot":"","sources":["../../src/mcp/runtime-workspace-overlay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAIL,2BAA2B,EAC5B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,kBAAkB,GAAG,WAAW,CAAC;AAClF,MAAM,MAAM,+BAA+B,GACvC,6BAA6B,GAC7B,mCAAmC,CAAC;AACxC,MAAM,MAAM,8BAA8B,GACtC,QAAQ,GACR,yBAAyB,CAAC;AAC9B,MAAM,MAAM,iCAAiC,GACzC,MAAM,GACN,eAAe,GACf,eAAe,CAAC;AACpB,MAAM,MAAM,8BAA8B,GACtC,0BAA0B,GAC1B,gCAAgC,GAChC,4BAA4B,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACzD;AA6FD,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC,CA+CjC;AAED,wBAAsB,mCAAmC,CACvD,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE;IACT,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC3D,GACA,OAAO,CAAC,8BAA8B,CAAC,CAqCzC"}

package/dist/mcp/runtime-workspace-overlay.js

@@ -0,0 +1,153 @@
+import * as path from "node:path";
+import { isRecognizedTargetGitHook, isTargetGitTransitionHookName, resolveGitHooksPath, TARGET_GIT_TRANSITION_HOOKS, } from "../git/target-git-hook-bootstrap.js";
+async function readGitConfig(gitClient, cwd, key) {
+    const result = await gitClient.run({
+        args: ["config", "--get", key],
+        cwd,
+    });
+    if (result.status !== 0) {
+        return null;
+    }
+    const value = result.stdout.trim();
+    return value.length > 0 ? value : null;
+}
+async function fileExists(fs, targetPath) {
+    try {
+        await fs.readFile(targetPath, "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function equivalentWorktreeRoots(left, right) {
+    const leftResolved = path.resolve(left);
+    const rightResolved = path.resolve(right);
+    if (leftResolved === rightResolved) {
+        return true;
+    }
+    return (leftResolved === `/private${rightResolved}`
+        || rightResolved === `/private${leftResolved}`);
+}
+function parseHookEventLine(line, worktreeRoot) {
+    try {
+        const parsed = JSON.parse(line);
+        const hookName = parsed["hookName"];
+        const hookArgs = parsed["hookArgs"];
+        const observedAt = parsed["observedAt"];
+        const observedWorktreeRoot = parsed["worktreeRoot"];
+        if (typeof hookName !== "string"
+            || !isTargetGitTransitionHookName(hookName)
+            || !Array.isArray(hookArgs)
+            || !hookArgs.every((value) => typeof value === "string")
+            || typeof observedAt !== "string"
+            || typeof observedWorktreeRoot !== "string"
+            || !equivalentWorktreeRoots(observedWorktreeRoot, worktreeRoot)) {
+            return null;
+        }
+        return {
+            hookName,
+            hookArgs,
+            worktreeRoot: observedWorktreeRoot,
+            observedAt,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function readLatestHookEvent(fs, worktreeRoot) {
+    const logPath = path.join(worktreeRoot, ".graft", "runtime", "git-transitions.ndjson");
+    try {
+        const content = await fs.readFile(logPath, "utf-8");
+        const lines = content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+        for (let index = lines.length - 1; index >= 0; index -= 1) {
+            const line = lines[index];
+            if (line === undefined)
+                continue;
+            const parsed = parseHookEventLine(line, worktreeRoot);
+            if (parsed !== null) {
+                return parsed;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function inspectGitHookBootstrap(fs, gitClient, worktreeRoot, gitCommonDir) {
+    const configuredCoreHooksPath = await readGitConfig(gitClient, worktreeRoot, "core.hooksPath");
+    const resolvedHooksPath = resolveGitHooksPath(worktreeRoot, gitCommonDir, configuredCoreHooksPath);
+    const presentHooks = [];
+    const missingHooks = [];
+    let recognizedHooks = 0;
+    let externalHooks = 0;
+    for (const hookName of TARGET_GIT_TRANSITION_HOOKS) {
+        const hookPath = path.join(resolvedHooksPath, hookName);
+        if (await fileExists(fs, hookPath)) {
+            presentHooks.push(hookName);
+            try {
+                const content = await fs.readFile(hookPath, "utf-8");
+                if (isRecognizedTargetGitHook(content, hookName)) {
+                    recognizedHooks += 1;
+                }
+                else {
+                    externalHooks += 1;
+                }
+            }
+            catch {
+                externalHooks += 1;
+            }
+        }
+        else {
+            missingHooks.push(hookName);
+        }
+    }
+    const allHooksInstalled = recognizedHooks === TARGET_GIT_TRANSITION_HOOKS.length;
+    return {
+        posture: allHooksInstalled
+            ? "installed"
+            : (presentHooks.length === 0 ? "absent" : "external_unknown"),
+        configuredCoreHooksPath,
+        resolvedHooksPath,
+        requiredHooks: [...TARGET_GIT_TRANSITION_HOOKS],
+        presentHooks,
+        missingHooks,
+        supportsCheckoutBoundaries: allHooksInstalled && externalHooks === 0,
+    };
+}
+export async function buildRuntimeWorkspaceOverlayFooting(fs, gitClient, worktreeRoot, gitCommonDir, repoState) {
+    const hookBootstrap = await inspectGitHookBootstrap(fs, gitClient, worktreeRoot, gitCommonDir);
+    const latestHookEvent = hookBootstrap.supportsCheckoutBoundaries
+        ? await readLatestHookEvent(fs, worktreeRoot)
+        : null;
+    const lineagePosture = repoState.checkoutEpoch > 0 || latestHookEvent !== null || repoState.lastTransition !== null
+        ? "forked_after_transition"
+        : "stable";
+    const boundaryAuthority = latestHookEvent !== null
+        ? "hook_observed"
+        : (repoState.lastTransition !== null || repoState.checkoutEpoch > 0
+            ? "repo_snapshot"
+            : "none");
+    return {
+        observationMode: latestHookEvent === null
+            ? "inferred_between_tool_calls"
+            : "hook_observed_checkout_boundaries",
+        lineagePosture,
+        boundaryAuthority,
+        degraded: true,
+        degradedReason: hookBootstrap.supportsCheckoutBoundaries
+            ? "local_edit_watchers_absent"
+            : (hookBootstrap.posture === "absent"
+                ? "target_repo_hooks_absent"
+                : "target_repo_hooks_unrecognized"),
+        checkoutEpoch: repoState.checkoutEpoch,
+        lastTransition: repoState.lastTransition,
+        workspaceOverlayId: repoState.workspaceOverlayId,
+        workspaceOverlay: repoState.workspaceOverlay,
+        hookBootstrap,
+        latestHookEvent,
+    };
+}
+//# sourceMappingURL=runtime-workspace-overlay.js.map