@flyingrobots/graft 0.6.1 → 0.7.0

package/dist/operations/capture-range.js

@@ -0,0 +1,45 @@
+// ---------------------------------------------------------------------------
+// Capture Range — opaque handles for run_capture output
+// ---------------------------------------------------------------------------
+/**
+ * Registry of opaque capture handles.
+ *
+ * Maps UUIDs to capture content. Handles are session-scoped — a
+ * handle from one session is rejected in another.
+ */
+export class CaptureHandleRegistry {
+    nextId = 0;
+    entries = new Map();
+    /**
+     * Register capture content and return an opaque handle.
+     */
+    register(sessionId, content) {
+        const handle = `capture-${String(++this.nextId)}`;
+        const lines = content.split("\n").filter((line, index, arr) => index < arr.length - 1 || line.length > 0);
+        this.entries.set(handle, { sessionId, content, lines });
+        return handle;
+    }
+    /**
+     * Retrieve a line range from a capture handle.
+     *
+     * @param handle - The opaque handle from register()
+     * @param sessionId - The requesting session (must match the registering session)
+     * @param start - 1-based start line (inclusive)
+     * @param end - 1-based end line (inclusive)
+     */
+    getRange(handle, sessionId, start, end) {
+        const entry = this.entries.get(handle);
+        if (entry === undefined) {
+            return { ok: false, error: "Capture handle not found" };
+        }
+        if (entry.sessionId !== sessionId) {
+            return { ok: false, error: "Capture handle belongs to a different session" };
+        }
+        const totalLines = entry.lines.length;
+        const clampedStart = Math.max(1, start);
+        const clampedEnd = Math.min(totalLines, end);
+        const lines = entry.lines.slice(clampedStart - 1, clampedEnd);
+        return { ok: true, lines, totalLines };
+    }
+}
+//# sourceMappingURL=capture-range.js.map

package/dist/operations/capture-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-range.js","sourceRoot":"","sources":["../../src/operations/capture-range.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAe9E;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,GAAG,CAAC,CAAC;IACF,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAe;QACzC,MAAM,MAAM,GAAG,WAAW,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CACtC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAChE,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAc,EAAE,SAAiB,EAAE,KAAa,EAAE,GAAW;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;QAC/E,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;QAE9D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/operations/conversation-primer.d.ts

@@ -0,0 +1,27 @@
+import type { GitClient } from "../ports/git.js";
+import type { FileSystem } from "../ports/filesystem.js";
+import type { PathOps } from "../ports/paths.js";
+/** Result of building a conversation primer. */
+export interface ConversationPrimerResult {
+    readonly scope: string;
+    readonly files: readonly string[];
+    readonly truncated: boolean;
+    readonly totalFiles: number;
+}
+/** Options for building a primer. */
+export interface ConversationPrimerOptions {
+    readonly cwd: string;
+    readonly git: GitClient;
+    readonly fs: FileSystem;
+    readonly pathOps: PathOps;
+    readonly scope?: string;
+    readonly maxFiles?: number;
+}
+/**
+ * Build a conversation primer for the given project.
+ *
+ * Auto-detects the best scope (src/, lib/, etc.) or uses an explicit
+ * scope. Returns a list of tracked files, truncated if beyond maxFiles.
+ */
+export declare function buildConversationPrimer(options: ConversationPrimerOptions): Promise<ConversationPrimerResult>;
+//# sourceMappingURL=conversation-primer.d.ts.map

package/dist/operations/conversation-primer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-primer.d.ts","sourceRoot":"","sources":["../../src/operations/conversation-primer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qCAAqC;AACrC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAcD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAmCnC"}

package/dist/operations/conversation-primer.js

@@ -0,0 +1,52 @@
+// ---------------------------------------------------------------------------
+// Conversation Primer — auto-orient agent at session start via graft_map
+// ---------------------------------------------------------------------------
+/** Common source directory names, in priority order. */
+const COMMON_SCOPES = ["src", "lib", "app", "packages"];
+async function isDirectory(fileSystem, dirPath) {
+    try {
+        await fileSystem.readdir(dirPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build a conversation primer for the given project.
+ *
+ * Auto-detects the best scope (src/, lib/, etc.) or uses an explicit
+ * scope. Returns a list of tracked files, truncated if beyond maxFiles.
+ */
+export async function buildConversationPrimer(options) {
+    const { cwd, git, fs: fileSystem, pathOps, maxFiles = 50 } = options;
+    // Detect scope
+    let scope = options.scope ?? ".";
+    if (options.scope === undefined) {
+        for (const candidate of COMMON_SCOPES) {
+            const candidatePath = pathOps.join(cwd, candidate);
+            if (await isDirectory(fileSystem, candidatePath)) {
+                scope = candidate;
+                break;
+            }
+        }
+    }
+    // List tracked files via git ls-files (allowed by plumbing)
+    const lsResult = await git.run({
+        cwd,
+        args: ["ls-files", "--", scope],
+    });
+    const allFiles = lsResult.stdout
+        .split("\n")
+        .map((f) => f.trim())
+        .filter((f) => f.length > 0);
+    const truncated = allFiles.length > maxFiles;
+    const files = truncated ? allFiles.slice(0, maxFiles) : allFiles;
+    return {
+        scope,
+        files,
+        truncated,
+        totalFiles: allFiles.length,
+    };
+}
+//# sourceMappingURL=conversation-primer.js.map

package/dist/operations/conversation-primer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-primer.js","sourceRoot":"","sources":["../../src/operations/conversation-primer.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAwB9E,wDAAwD;AACxD,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AAExD,KAAK,UAAU,WAAW,CAAC,UAAsB,EAAE,OAAe;IAChE,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAkC;IAElC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAErE,eAAe;IACf,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IACjC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;YACtC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACnD,IAAI,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC;gBACjD,KAAK,GAAG,SAAS,CAAC;gBAClB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;QAC7B,GAAG;QACH,IAAI,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM;SAC7B,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEjE,OAAO;QACL,KAAK;QACL,KAAK;QACL,SAAS;QACT,UAAU,EAAE,QAAQ,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}

package/dist/operations/cross-session-resume.d.ts

@@ -0,0 +1,28 @@
+import type { GitClient } from "../ports/git.js";
+/** A file that changed between saved HEAD and current HEAD. */
+export interface ResumeChangedFile {
+    readonly path: string;
+    readonly status: "added" | "modified" | "deleted" | "renamed";
+}
+/** Result of attempting to resume from a saved session state. */
+export interface SessionResumeResult {
+    readonly resumable: boolean;
+    readonly currentHead: string;
+    readonly savedHead: string;
+    readonly changedFiles: readonly ResumeChangedFile[];
+    readonly commitsBehind: number;
+    readonly error?: string;
+}
+export interface SessionResumeOptions {
+    readonly cwd: string;
+    readonly savedHeadSha: string;
+    readonly git: GitClient;
+}
+/**
+ * Build a structural resume from a saved HEAD to current HEAD.
+ *
+ * Uses plumbing-safe git commands (diff-tree, rev-list, log) to
+ * find changed files and count commits between two points.
+ */
+export declare function buildSessionResume(options: SessionResumeOptions): Promise<SessionResumeResult>;
+//# sourceMappingURL=cross-session-resume.d.ts.map

package/dist/operations/cross-session-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-session-resume.d.ts","sourceRoot":"","sources":["../../src/operations/cross-session-resume.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;CAC/D;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAmE9B"}

package/dist/operations/cross-session-resume.js

@@ -0,0 +1,79 @@
+// ---------------------------------------------------------------------------
+// Cross-session resume — structural diff from saved HEAD to current HEAD
+// ---------------------------------------------------------------------------
+/**
+ * Build a structural resume from a saved HEAD to current HEAD.
+ *
+ * Uses plumbing-safe git commands (diff-tree, rev-list, log) to
+ * find changed files and count commits between two points.
+ */
+export async function buildSessionResume(options) {
+    const { cwd, savedHeadSha, git } = options;
+    const headResult = await git.run({ cwd, args: ["rev-parse", "HEAD"] });
+    const currentHead = headResult.stdout.trim();
+    if (headResult.status !== 0 || currentHead.length === 0) {
+        return {
+            resumable: false, currentHead: "", savedHead: savedHeadSha,
+            changedFiles: [], commitsBehind: 0,
+            error: "Cannot resolve current HEAD",
+        };
+    }
+    // Check if saved HEAD exists in the repo
+    const verifyResult = await git.run({ cwd, args: ["cat-file", "-t", savedHeadSha] });
+    if (verifyResult.stdout.trim() !== "commit") {
+        return {
+            resumable: false, currentHead, savedHead: savedHeadSha,
+            changedFiles: [], commitsBehind: 0,
+            error: "Saved HEAD SHA not found in repository",
+        };
+    }
+    if (currentHead === savedHeadSha) {
+        return {
+            resumable: true, currentHead, savedHead: savedHeadSha,
+            changedFiles: [], commitsBehind: 0,
+        };
+    }
+    // Use diff-tree (plumbing-safe) with -r for recursive
+    const diffResult = await git.run({
+        cwd,
+        args: ["diff-tree", "-r", "--name-status", "--no-commit-id", savedHeadSha, currentHead],
+    });
+    const changedFiles = [];
+    const diffOutput = diffResult.stdout.trim();
+    if (diffOutput.length > 0) {
+        for (const line of diffOutput.split("\n")) {
+            const parts = line.split("\t");
+            if (parts.length < 2)
+                continue;
+            const statusChar = (parts[0] ?? "").charAt(0);
+            const filePath = parts[parts.length - 1] ?? "";
+            let status;
+            switch (statusChar) {
+                case "A":
+                    status = "added";
+                    break;
+                case "D":
+                    status = "deleted";
+                    break;
+                case "R":
+                    status = "renamed";
+                    break;
+                default:
+                    status = "modified";
+                    break;
+            }
+            changedFiles.push({ path: filePath, status });
+        }
+    }
+    // Count commits
+    const countResult = await git.run({
+        cwd,
+        args: ["rev-list", "--count", `${savedHeadSha}..${currentHead}`],
+    });
+    const commitsBehind = parseInt(countResult.stdout.trim(), 10) || 0;
+    return {
+        resumable: true, currentHead, savedHead: savedHeadSha,
+        changedFiles, commitsBehind,
+    };
+}
+//# sourceMappingURL=cross-session-resume.js.map

package/dist/operations/cross-session-resume.js.map

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

package/dist/operations/deterministic-replay.d.ts

@@ -0,0 +1,39 @@
+import type { FileSystem } from "../ports/filesystem.js";
+/** A recorded tool call with its expected result. */
+export interface RecordedToolCall {
+    readonly tool: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly expectedResult: Readonly<Record<string, unknown>>;
+}
+/** A single mismatch between expected and actual. */
+export interface ReplayFailure {
+    readonly index: number;
+    readonly tool: string;
+    readonly expected: Readonly<Record<string, unknown>>;
+    readonly actual: Readonly<Record<string, unknown>>;
+}
+/** Result of replaying a scenario. */
+export interface ReplayResult {
+    readonly passed: boolean;
+    readonly total: number;
+    readonly matched: number;
+    readonly mismatched: number;
+    readonly failures: readonly ReplayFailure[];
+}
+/** Handler that executes a tool call and returns the result. */
+export type ToolCallHandler = (tool: string, args: Readonly<Record<string, unknown>>) => Promise<Readonly<Record<string, unknown>>>;
+/**
+ * Create a mock FileSystem from a snapshot map.
+ *
+ * Keys are file paths, values are file contents. Provides readFile,
+ * readdir, stat, and other FileSystem methods backed by the map.
+ */
+export declare function createSnapshotFs(files: Readonly<Record<string, string>>): FileSystem;
+/**
+ * Replay a sequence of recorded tool calls against a handler.
+ *
+ * Compares each actual result to the expected result from the
+ * recording. Returns pass/fail with details on mismatches.
+ */
+export declare function replayToolCalls(calls: readonly RecordedToolCall[], handler: ToolCallHandler): Promise<ReplayResult>;
+//# sourceMappingURL=deterministic-replay.d.ts.map

package/dist/operations/deterministic-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-replay.d.ts","sourceRoot":"","sources":["../../src/operations/deterministic-replay.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5D;AAQD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,UAAU,CAoDZ;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CAAC,CA6BvB"}

package/dist/operations/deterministic-replay.js

@@ -0,0 +1,90 @@
+// ---------------------------------------------------------------------------
+// Deterministic Scenario Replay — re-drive sessions for CI regression
+// ---------------------------------------------------------------------------
+/**
+ * Create a mock FileSystem from a snapshot map.
+ *
+ * Keys are file paths, values are file contents. Provides readFile,
+ * readdir, stat, and other FileSystem methods backed by the map.
+ */
+export function createSnapshotFs(files) {
+    const fileMap = new Map(Object.entries(files));
+    return {
+        readFile(path, _encoding) {
+            const content = fileMap.get(path);
+            if (content === undefined) {
+                return Promise.reject(new Error(`File not found in snapshot: ${path}`));
+            }
+            return Promise.resolve(content);
+        },
+        readFileSync(path) {
+            const content = fileMap.get(path);
+            if (content === undefined) {
+                throw new Error(`File not found in snapshot: ${path}`);
+            }
+            return content;
+        },
+        readdir(dirPath) {
+            const prefix = dirPath.endsWith("/") ? dirPath : `${dirPath}/`;
+            const entries = new Set();
+            for (const key of fileMap.keys()) {
+                if (key.startsWith(prefix)) {
+                    const rest = key.slice(prefix.length);
+                    const firstSegment = rest.split("/")[0];
+                    if (firstSegment !== undefined && firstSegment.length > 0) {
+                        entries.add(firstSegment);
+                    }
+                }
+            }
+            return Promise.resolve([...entries].sort());
+        },
+        writeFile() {
+            return Promise.resolve();
+        },
+        appendFile() {
+            return Promise.resolve();
+        },
+        mkdir() {
+            return Promise.resolve();
+        },
+        stat(path) {
+            const content = fileMap.get(path);
+            return Promise.resolve({ size: content?.length ?? 0 });
+        },
+    };
+}
+/**
+ * Replay a sequence of recorded tool calls against a handler.
+ *
+ * Compares each actual result to the expected result from the
+ * recording. Returns pass/fail with details on mismatches.
+ */
+export async function replayToolCalls(calls, handler) {
+    const failures = [];
+    let matched = 0;
+    for (let i = 0; i < calls.length; i++) {
+        const call = calls[i] ?? { tool: "", args: {}, expectedResult: {} };
+        const actual = await handler(call.tool, call.args);
+        const expectedJson = JSON.stringify(call.expectedResult);
+        const actualJson = JSON.stringify(actual);
+        if (expectedJson === actualJson) {
+            matched++;
+        }
+        else {
+            failures.push({
+                index: i,
+                tool: call.tool,
+                expected: call.expectedResult,
+                actual,
+            });
+        }
+    }
+    return {
+        passed: failures.length === 0,
+        total: calls.length,
+        matched,
+        mismatched: failures.length,
+        failures,
+    };
+}
+//# sourceMappingURL=deterministic-replay.js.map

package/dist/operations/deterministic-replay.js.map

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

package/dist/operations/export-surface-diff.d.ts

@@ -0,0 +1,36 @@
+import type { GitClient } from "../ports/git.js";
+import type { JsonObject } from "../contracts/json-object.js";
+export interface ExportChange {
+    readonly symbol: string;
+    readonly filePath: string;
+    readonly kind: string;
+    readonly changeType: "added" | "removed" | "signature_changed";
+    readonly signature?: string | undefined;
+    readonly previousSignature?: string | undefined;
+}
+export interface ExportSurfaceDiffResult {
+    readonly base: string;
+    readonly head: string;
+    readonly added: readonly ExportChange[];
+    readonly removed: readonly ExportChange[];
+    readonly changed: readonly ExportChange[];
+    readonly semverImpact: "major" | "minor" | "patch" | "none";
+    readonly summary: string;
+}
+export interface ExportSurfaceDiffOptions {
+    readonly cwd: string;
+    readonly git: GitClient;
+    readonly base?: string | undefined;
+    readonly head?: string | undefined;
+}
+/**
+ * Compute the export surface diff between two git refs.
+ *
+ * Extracts outlines at both refs, filters to exported symbols, and
+ * classifies additions, removals, and signature changes. Derives
+ * the semver impact from the change set.
+ */
+export declare function exportSurfaceDiff(opts: ExportSurfaceDiffOptions): Promise<ExportSurfaceDiffResult>;
+/** Serialize an ExportSurfaceDiffResult for MCP / CLI output. */
+export declare function exportSurfaceDiffToJson(result: ExportSurfaceDiffResult): JsonObject;
+//# sourceMappingURL=export-surface-diff.d.ts.map

package/dist/operations/export-surface-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-surface-diff.d.ts","sourceRoot":"","sources":["../../src/operations/export-surface-diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAI9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,mBAAmB,CAAC;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAkPD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA4DlC;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAEnF"}