@fern-api/replay 0.1.0

package/README.md

@@ -0,0 +1,33 @@
+# @fern-api/replay
+
+Automatically preserves SDK customizations across Fern regenerations.
+
+## What it does
+
+Fern Replay detects user edits to generated SDK code, stores them as patches, and re-applies them after each regeneration using 3-way merge. This means your customizations survive `fern generate` without manual intervention.
+
+## Pipeline
+
+1. **Detect** — Find commits since last generation
+2. **Store** — Save patches to `replay.lock`
+3. **Generate** — Run generator (overwrites all)
+4. **Replay** — Apply patches via 3-way merge
+5. **Commit** — Commit the merged result (or surface conflicts)
+
+## Install
+
+```bash
+npm install @fern-api/replay
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/ConflictPrompt.d.ts

@@ -0,0 +1,13 @@
+import type { FileResult } from "./types.js";
+export type PromptResult = "ours" | "theirs" | "manual" | "abort";
+/**
+ * Prompt the user to resolve a single conflicting file.
+ * Uses readline for zero-dependency interactive input.
+ * Output goes to stderr so stdout stays clean for piping.
+ */
+export declare function promptForConflictResolution(options: {
+    patchId: string;
+    patchMessage: string;
+    file: FileResult;
+}): Promise<PromptResult>;
+//# sourceMappingURL=ConflictPrompt.d.ts.map

package/dist/ConflictPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictPrompt.d.ts","sourceRoot":"","sources":["../src/ConflictPrompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqBxB"}

package/dist/ConflictPrompt.js

@@ -0,0 +1,38 @@
+import { createInterface } from "node:readline";
+/**
+ * Prompt the user to resolve a single conflicting file.
+ * Uses readline for zero-dependency interactive input.
+ * Output goes to stderr so stdout stays clean for piping.
+ */
+export async function promptForConflictResolution(options) {
+    const { patchId, patchMessage, file } = options;
+    const regionCount = file.conflicts?.length ?? 0;
+    process.stderr.write(`\nConflict in: ${file.file}\n`);
+    process.stderr.write(`  Patch: ${patchId} - "${patchMessage}"\n`);
+    process.stderr.write(`  ${regionCount} conflict region(s)\n\n`);
+    process.stderr.write("  [g] Keep generated (discard your customization for this file)\n");
+    process.stderr.write("  [m] Keep mine (discard generated changes for this file)\n");
+    process.stderr.write("  [s] Skip (leave conflict markers for manual resolution)\n");
+    process.stderr.write("  [a] Abort (stop replay, leave working tree as-is)\n\n");
+    const answer = await askSingleChar("Choice [g/m/s/a]: ");
+    switch (answer.toLowerCase()) {
+        case "g": return "ours";
+        case "m": return "theirs";
+        case "a": return "abort";
+        case "s":
+        default: return "manual";
+    }
+}
+function askSingleChar(prompt) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stderr,
+        });
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+//# sourceMappingURL=ConflictPrompt.js.map

package/dist/ConflictPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictPrompt.js","sourceRoot":"","sources":["../src/ConflictPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKhD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAIjD;IACG,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC;IAEhD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,OAAO,YAAY,KAAK,CAAC,CAAC;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,WAAW,yBAAyB,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC1F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAEhF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAEzD,QAAQ,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,KAAK,GAAG,CAAC,CAAC,OAAO,MAAM,CAAC;QACxB,KAAK,GAAG,CAAC,CAAC,OAAO,QAAQ,CAAC;QAC1B,KAAK,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC;QACzB,KAAK,GAAG,CAAC;QACT,OAAO,CAAC,CAAC,OAAO,QAAQ,CAAC;IAC7B,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,eAAe,CAAC;YACvB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC,CAAC;QAEH,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YAC3B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/ConflictResolver.d.ts

@@ -0,0 +1,11 @@
+export type ResolutionStrategy = "ours" | "theirs";
+/**
+ * Resolve conflict markers in a string by keeping the chosen side.
+ * If the content has no conflict markers, it is returned unchanged.
+ */
+export declare function resolveContent(content: string, strategy: ResolutionStrategy): string;
+/**
+ * Read a file, resolve all conflict markers using the given strategy, and write it back.
+ */
+export declare function resolveConflictMarkers(filePath: string, strategy: ResolutionStrategy): Promise<void>;
+//# sourceMappingURL=ConflictResolver.d.ts.map

package/dist/ConflictResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictResolver.d.ts","sourceRoot":"","sources":["../src/ConflictResolver.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAMnD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAuCpF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1G"}

package/dist/ConflictResolver.js

@@ -0,0 +1,53 @@
+import { readFileSync, writeFileSync } from "node:fs";
+const OURS_START = "<<<<<<< OURS (generated)";
+const SEPARATOR = "=======";
+const THEIRS_END = ">>>>>>> THEIRS (your customization)";
+/**
+ * Resolve conflict markers in a string by keeping the chosen side.
+ * If the content has no conflict markers, it is returned unchanged.
+ */
+export function resolveContent(content, strategy) {
+    const lines = content.split("\n");
+    const result = [];
+    let inConflict = false;
+    let inOurs = false;
+    let inTheirs = false;
+    for (const line of lines) {
+        if (line === OURS_START) {
+            inConflict = true;
+            inOurs = true;
+            inTheirs = false;
+            continue;
+        }
+        if (inConflict && line === SEPARATOR) {
+            inOurs = false;
+            inTheirs = true;
+            continue;
+        }
+        if (inConflict && line === THEIRS_END) {
+            inConflict = false;
+            inOurs = false;
+            inTheirs = false;
+            continue;
+        }
+        if (!inConflict) {
+            result.push(line);
+        }
+        else if (inOurs && strategy === "ours") {
+            result.push(line);
+        }
+        else if (inTheirs && strategy === "theirs") {
+            result.push(line);
+        }
+    }
+    return result.join("\n");
+}
+/**
+ * Read a file, resolve all conflict markers using the given strategy, and write it back.
+ */
+export async function resolveConflictMarkers(filePath, strategy) {
+    const content = readFileSync(filePath, "utf-8");
+    const resolved = resolveContent(content, strategy);
+    writeFileSync(filePath, resolved, "utf-8");
+}
+//# sourceMappingURL=ConflictResolver.js.map

package/dist/ConflictResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictResolver.js","sourceRoot":"","sources":["../src/ConflictResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAItD,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,SAAS,GAAG,SAAS,CAAC;AAC5B,MAAM,UAAU,GAAG,qCAAqC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,QAA4B;IACxE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACtB,UAAU,GAAG,IAAI,CAAC;YAClB,MAAM,GAAG,IAAI,CAAC;YACd,QAAQ,GAAG,KAAK,CAAC;YACjB,SAAS;QACb,CAAC;QAED,IAAI,UAAU,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,GAAG,KAAK,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACb,CAAC;QAED,IAAI,UAAU,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACpC,UAAU,GAAG,KAAK,CAAC;YACnB,MAAM,GAAG,KAAK,CAAC;YACf,QAAQ,GAAG,KAAK,CAAC;YACjB,SAAS;QACb,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,MAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB,EAAE,QAA4B;IACvF,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/FernignoreMigrator.d.ts

@@ -0,0 +1,71 @@
+import type { GitClient } from "./git/GitClient.js";
+import type { LockfileManager } from "./LockfileManager.js";
+import type { StoredPatch } from "./types.js";
+export interface MigrationAnalysis {
+    /** Files in .fernignore that have git commit history (can be tracked by Replay) */
+    trackedByBoth: Array<{
+        file: string;
+        commit: string;
+    }>;
+    /** Files in .fernignore but NO recent commit history found after last generation */
+    fernignoreOnly: string[];
+    /** Commits found that AREN'T in .fernignore (inline edits to generated files) */
+    commitsOnly: StoredPatch[];
+    /** Synthetic patches created for .fernignore files that differ from pristine generation */
+    syntheticPatches: StoredPatch[];
+}
+export interface MigrationResult {
+    patchesCreated: number;
+    filesSkipped: string[];
+    warnings: string[];
+}
+export declare class FernignoreMigrator {
+    private git;
+    private lockManager;
+    private outputDir;
+    constructor(git: GitClient, lockManager: LockfileManager, outputDir: string);
+    /**
+     * Check if .fernignore exists in the output directory.
+     */
+    fernignoreExists(): boolean;
+    /**
+     * Read and parse .fernignore patterns.
+     * Filters out comments and empty lines.
+     */
+    readFernignorePatterns(): string[];
+    /**
+     * Analyze correlation between .fernignore patterns and git history.
+     *
+     * For patterns without recent commits (committed before last generation),
+     * creates synthetic patches by diffing the current file state against
+     * the pristine generated state at the generation's tree hash.
+     */
+    analyzeMigration(): Promise<MigrationAnalysis>;
+    /**
+     * Resolve glob patterns to actual file paths on disk.
+     */
+    private resolvePatterns;
+    /**
+     * Read file content from the output directory.
+     */
+    private readFileContent;
+    /**
+     * Create a unified diff for a new file (not in generation tree).
+     */
+    private createNewFileDiff;
+    /**
+     * Create a unified diff between pristine and current content.
+     */
+    private createFileDiff;
+    /**
+     * Perform the migration - create patches for .fernignore files that have history.
+     * Adds detected patches to the lockfile.
+     */
+    migrate(): Promise<MigrationResult>;
+    /**
+     * Move .fernignore patterns to replay.yml exclude list.
+     * This lets Replay skip these files during application.
+     */
+    movePatternsToReplayYml(patterns: string[]): void;
+}
+//# sourceMappingURL=FernignoreMigrator.d.ts.map

package/dist/FernignoreMigrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FernignoreMigrator.d.ts","sourceRoot":"","sources":["../src/FernignoreMigrator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAC9B,mFAAmF;IACnF,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,oFAAoF;IACpF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iFAAiF;IACjF,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,2FAA2F;IAC3F,gBAAgB,EAAE,WAAW,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAS;gBAEd,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM;IAM3E;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;;OAGG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAYlC;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAwGpD;;OAEG;YACW,eAAe;IAgB7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IA8BzC;;;OAGG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAmBpD"}

package/dist/FernignoreMigrator.js

@@ -0,0 +1,243 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { createHash } from "node:crypto";
+import { minimatch } from "minimatch";
+import { stringify, parse } from "yaml";
+import { ReplayDetector } from "./ReplayDetector.js";
+export class FernignoreMigrator {
+    git;
+    lockManager;
+    outputDir;
+    constructor(git, lockManager, outputDir) {
+        this.git = git;
+        this.lockManager = lockManager;
+        this.outputDir = outputDir;
+    }
+    /**
+     * Check if .fernignore exists in the output directory.
+     */
+    fernignoreExists() {
+        return existsSync(join(this.outputDir, ".fernignore"));
+    }
+    /**
+     * Read and parse .fernignore patterns.
+     * Filters out comments and empty lines.
+     */
+    readFernignorePatterns() {
+        const fernignorePath = join(this.outputDir, ".fernignore");
+        if (!existsSync(fernignorePath)) {
+            return [];
+        }
+        const content = readFileSync(fernignorePath, "utf-8");
+        return content
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith("#"));
+    }
+    /**
+     * Analyze correlation between .fernignore patterns and git history.
+     *
+     * For patterns without recent commits (committed before last generation),
+     * creates synthetic patches by diffing the current file state against
+     * the pristine generated state at the generation's tree hash.
+     */
+    async analyzeMigration() {
+        const patterns = this.readFernignorePatterns();
+        const detector = new ReplayDetector(this.git, this.lockManager, this.outputDir);
+        const patches = await detector.detectNewPatches();
+        const trackedByBoth = [];
+        const fernignoreOnly = [];
+        const commitsOnly = [];
+        const syntheticPatches = [];
+        // Check each fernignore pattern against recent patches
+        for (const pattern of patterns) {
+            const matchingPatch = patches.find((p) => p.files.some((f) => minimatch(f, pattern) || f === pattern));
+            if (matchingPatch) {
+                trackedByBoth.push({
+                    file: pattern,
+                    commit: matchingPatch.original_commit,
+                });
+            }
+            else {
+                fernignoreOnly.push(pattern);
+            }
+        }
+        // For fernignore-only patterns, try to create synthetic patches
+        // by diffing current file state against pristine generation tree
+        const lock = this.lockManager.read();
+        const currentGen = lock.generations.find((g) => g.commit_sha === lock.current_generation);
+        if (currentGen && fernignoreOnly.length > 0) {
+            const resolvedFiles = await this.resolvePatterns(fernignoreOnly);
+            const remainingFernignoreOnly = [];
+            for (const { pattern, files } of resolvedFiles) {
+                const patchFiles = [];
+                const diffParts = [];
+                for (const filePath of files) {
+                    const pristine = await this.git.showFile(currentGen.tree_hash, filePath);
+                    const currentContent = this.readFileContent(filePath);
+                    if (currentContent === null) {
+                        // File in .fernignore but not on disk — nothing to track
+                        continue;
+                    }
+                    if (pristine === null) {
+                        // File doesn't exist in generation tree — it's a wholly new file
+                        patchFiles.push(filePath);
+                        diffParts.push(this.createNewFileDiff(filePath, currentContent));
+                    }
+                    else if (pristine !== currentContent) {
+                        // File differs from pristine — user has customized it
+                        patchFiles.push(filePath);
+                        diffParts.push(this.createFileDiff(filePath, pristine, currentContent));
+                    }
+                    // If pristine === currentContent, file is unchanged — skip
+                }
+                if (patchFiles.length > 0) {
+                    const patchContent = diffParts.join("\n");
+                    const contentHash = `sha256:${createHash("sha256").update(patchContent).digest("hex")}`;
+                    syntheticPatches.push({
+                        id: `patch-fernignore-${createHash("sha256").update(pattern).digest("hex").slice(0, 8)}`,
+                        content_hash: contentHash,
+                        original_commit: currentGen.commit_sha,
+                        original_message: `[fernignore-migration] Customizations for ${pattern}`,
+                        original_author: "Fern Replay <replay@buildwithfern.com>",
+                        base_generation: currentGen.commit_sha,
+                        files: patchFiles,
+                        patch_content: patchContent,
+                    });
+                    trackedByBoth.push({
+                        file: pattern,
+                        commit: `synthetic (differs from generated)`,
+                    });
+                }
+                else {
+                    // No diff found — file matches generated output or doesn't exist
+                    remainingFernignoreOnly.push(pattern);
+                }
+            }
+            // Replace fernignoreOnly with only truly untrackable patterns
+            fernignoreOnly.length = 0;
+            fernignoreOnly.push(...remainingFernignoreOnly);
+        }
+        // Find patches that touch files NOT in .fernignore
+        for (const patch of patches) {
+            const hasUnprotectedFiles = patch.files.some((f) => !patterns.some((p) => minimatch(f, p) || f === p));
+            if (hasUnprotectedFiles) {
+                commitsOnly.push(patch);
+            }
+        }
+        return { trackedByBoth, fernignoreOnly, commitsOnly, syntheticPatches };
+    }
+    /**
+     * Resolve glob patterns to actual file paths on disk.
+     */
+    async resolvePatterns(patterns) {
+        const allFiles = (await this.git.exec(["ls-files"])).trim().split("\n").filter(Boolean);
+        const results = [];
+        for (const pattern of patterns) {
+            const matching = allFiles.filter((f) => minimatch(f, pattern) || f === pattern || f.startsWith(pattern + "/"));
+            results.push({ pattern, files: matching.length > 0 ? matching : [pattern] });
+        }
+        return results;
+    }
+    /**
+     * Read file content from the output directory.
+     */
+    readFileContent(filePath) {
+        const fullPath = join(this.outputDir, filePath);
+        if (!existsSync(fullPath)) {
+            return null;
+        }
+        try {
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                return null;
+            }
+            return readFileSync(fullPath, "utf-8");
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Create a unified diff for a new file (not in generation tree).
+     */
+    createNewFileDiff(filePath, content) {
+        const lines = content.split("\n");
+        const hunks = lines.map((l) => `+${l}`).join("\n");
+        return [
+            `diff --git a/${filePath} b/${filePath}`,
+            "new file mode 100644",
+            `--- /dev/null`,
+            `+++ b/${filePath}`,
+            `@@ -0,0 +1,${lines.length} @@`,
+            hunks,
+        ].join("\n");
+    }
+    /**
+     * Create a unified diff between pristine and current content.
+     */
+    createFileDiff(filePath, pristine, current) {
+        const oldLines = pristine.split("\n");
+        const newLines = current.split("\n");
+        // Simple full-file replacement diff — not optimal but correct
+        const removals = oldLines.map((l) => `-${l}`).join("\n");
+        const additions = newLines.map((l) => `+${l}`).join("\n");
+        return [
+            `diff --git a/${filePath} b/${filePath}`,
+            `--- a/${filePath}`,
+            `+++ b/${filePath}`,
+            `@@ -1,${oldLines.length} +1,${newLines.length} @@`,
+            removals,
+            additions,
+        ].join("\n");
+    }
+    /**
+     * Perform the migration - create patches for .fernignore files that have history.
+     * Adds detected patches to the lockfile.
+     */
+    async migrate() {
+        const analysis = await this.analyzeMigration();
+        const detector = new ReplayDetector(this.git, this.lockManager, this.outputDir);
+        const patches = await detector.detectNewPatches();
+        const warnings = [];
+        let patchesCreated = 0;
+        // Add all detected patches to lockfile
+        for (const patch of patches) {
+            this.lockManager.addPatch(patch);
+            patchesCreated++;
+        }
+        if (patchesCreated > 0) {
+            this.lockManager.save();
+        }
+        // Warn about fernignore-only files
+        for (const file of analysis.fernignoreOnly) {
+            warnings.push(`${file}: in .fernignore but no commit history found. Commit this file or keep in .fernignore as fallback.`);
+        }
+        return {
+            patchesCreated,
+            filesSkipped: analysis.fernignoreOnly,
+            warnings,
+        };
+    }
+    /**
+     * Move .fernignore patterns to replay.yml exclude list.
+     * This lets Replay skip these files during application.
+     */
+    movePatternsToReplayYml(patterns) {
+        const replayYmlPath = join(this.outputDir, ".fern", "replay.yml");
+        let config = {};
+        if (existsSync(replayYmlPath)) {
+            const content = readFileSync(replayYmlPath, "utf-8");
+            config = parse(content) ?? {};
+        }
+        const existing = config.exclude ?? [];
+        const merged = [...new Set([...existing, ...patterns])];
+        config.exclude = merged;
+        const dir = dirname(replayYmlPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(replayYmlPath, stringify(config, { lineWidth: 0 }), "utf-8");
+    }
+}
+//# sourceMappingURL=FernignoreMigrator.js.map

package/dist/FernignoreMigrator.js.map

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

package/dist/LockfileManager.d.ts

@@ -0,0 +1,27 @@
+import type { GenerationLock, GenerationRecord, StoredPatch, CustomizationsConfig } from "./types.js";
+export declare class LockfileManager {
+    private outputDir;
+    private lock;
+    constructor(outputDir: string);
+    get lockfilePath(): string;
+    get customizationsPath(): string;
+    exists(): boolean;
+    read(): GenerationLock;
+    initialize(firstGeneration: GenerationRecord): void;
+    /**
+     * Set up in-memory lock state without writing to disk.
+     * Useful for bootstrap dry-run where we need state for detection
+     * but don't want to persist anything.
+     */
+    initializeInMemory(firstGeneration: GenerationRecord): void;
+    save(): void;
+    addGeneration(record: GenerationRecord): void;
+    addPatch(patch: StoredPatch): void;
+    updatePatch(patchId: string, updates: Partial<Pick<StoredPatch, "base_generation" | "patch_content" | "content_hash" | "files">>): void;
+    removePatch(patchId: string): void;
+    getPatches(): StoredPatch[];
+    getGeneration(commitSha: string): GenerationRecord | undefined;
+    getCustomizationsConfig(): CustomizationsConfig;
+    private ensureLoaded;
+}
+//# sourceMappingURL=LockfileManager.d.ts.map

package/dist/LockfileManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockfileManager.d.ts","sourceRoot":"","sources":["../src/LockfileManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACvB,MAAM,YAAY,CAAC;AAIpB,qBAAa,eAAe;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAA+B;gBAE/B,SAAS,EAAE,MAAM;IAI7B,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,MAAM,IAAI,OAAO;IAIjB,IAAI,IAAI,cAAc;IAYtB,UAAU,CAAC,eAAe,EAAE,gBAAgB,GAAG,IAAI;IAKnD;;;;OAIG;IACH,kBAAkB,CAAC,eAAe,EAAE,gBAAgB,GAAG,IAAI;IAS3D,IAAI,IAAI,IAAI;IAmBZ,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAM7C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAKlC,WAAW,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC,GACpG,IAAI;IASP,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC,UAAU,IAAI,WAAW,EAAE;IAK3B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAK9D,uBAAuB,IAAI,oBAAoB;IAQ/C,OAAO,CAAC,YAAY;CAKvB"}

package/dist/LockfileManager.js

@@ -0,0 +1,108 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { stringify, parse } from "yaml";
+const LOCKFILE_HEADER = "# DO NOT EDIT MANUALLY - Managed by Fern Replay\n";
+export class LockfileManager {
+    outputDir;
+    lock = null;
+    constructor(outputDir) {
+        this.outputDir = outputDir;
+    }
+    get lockfilePath() {
+        return join(this.outputDir, ".fern", "replay.lock");
+    }
+    get customizationsPath() {
+        return join(this.outputDir, ".fern", "replay.yml");
+    }
+    exists() {
+        return existsSync(this.lockfilePath);
+    }
+    read() {
+        if (this.lock) {
+            return this.lock;
+        }
+        if (!this.exists()) {
+            throw new Error(`Lockfile not found: ${this.lockfilePath}`);
+        }
+        const content = readFileSync(this.lockfilePath, "utf-8");
+        this.lock = parse(content);
+        return this.lock;
+    }
+    initialize(firstGeneration) {
+        this.initializeInMemory(firstGeneration);
+        this.save();
+    }
+    /**
+     * Set up in-memory lock state without writing to disk.
+     * Useful for bootstrap dry-run where we need state for detection
+     * but don't want to persist anything.
+     */
+    initializeInMemory(firstGeneration) {
+        this.lock = {
+            version: "1.0",
+            generations: [firstGeneration],
+            current_generation: firstGeneration.commit_sha,
+            patches: [],
+        };
+    }
+    save() {
+        if (!this.lock) {
+            throw new Error("No lockfile data to save. Call read() or initialize() first.");
+        }
+        const dir = dirname(this.lockfilePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const yaml = stringify(this.lock, {
+            lineWidth: 0,
+            blockQuote: "literal",
+        });
+        const content = LOCKFILE_HEADER + yaml;
+        // Atomic write: write to temp file then rename (rename is atomic on most filesystems)
+        const tmpPath = this.lockfilePath + ".tmp";
+        writeFileSync(tmpPath, content, "utf-8");
+        renameSync(tmpPath, this.lockfilePath);
+    }
+    addGeneration(record) {
+        this.ensureLoaded();
+        this.lock.generations.push(record);
+        this.lock.current_generation = record.commit_sha;
+    }
+    addPatch(patch) {
+        this.ensureLoaded();
+        this.lock.patches.push(patch);
+    }
+    updatePatch(patchId, updates) {
+        this.ensureLoaded();
+        const patch = this.lock.patches.find((p) => p.id === patchId);
+        if (!patch) {
+            throw new Error(`Patch not found: ${patchId}`);
+        }
+        Object.assign(patch, updates);
+    }
+    removePatch(patchId) {
+        this.ensureLoaded();
+        this.lock.patches = this.lock.patches.filter((p) => p.id !== patchId);
+    }
+    getPatches() {
+        this.ensureLoaded();
+        return this.lock.patches;
+    }
+    getGeneration(commitSha) {
+        this.ensureLoaded();
+        return this.lock.generations.find((g) => g.commit_sha === commitSha);
+    }
+    getCustomizationsConfig() {
+        if (!existsSync(this.customizationsPath)) {
+            return {};
+        }
+        const content = readFileSync(this.customizationsPath, "utf-8");
+        return parse(content) ?? {};
+    }
+    ensureLoaded() {
+        if (!this.lock) {
+            throw new Error("No lockfile loaded. Call read() or initialize() first.");
+        }
+    }
+}
+//# sourceMappingURL=LockfileManager.js.map

package/dist/LockfileManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockfileManager.js","sourceRoot":"","sources":["../src/LockfileManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAQxC,MAAM,eAAe,GAAG,mDAAmD,CAAC;AAE5E,MAAM,OAAO,eAAe;IAChB,SAAS,CAAS;IAClB,IAAI,GAA0B,IAAI,CAAC;IAE3C,YAAY,SAAiB;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,kBAAkB;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAED,MAAM;QACF,OAAO,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,IAAI;QACA,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAmB,CAAC;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,eAAiC;QACxC,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,eAAiC;QAChD,IAAI,CAAC,IAAI,GAAG;YACR,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,CAAC,eAAe,CAAC;YAC9B,kBAAkB,EAAE,eAAe,CAAC,UAAU;YAC9C,OAAO,EAAE,EAAE;SACd,CAAC;IACN,CAAC;IAED,IAAI;QACA,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE;YAC9B,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,SAAS;SACxB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,eAAe,GAAG,IAAI,CAAC;QACvC,sFAAsF;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3C,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa,CAAC,MAAwB;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,IAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC;IACtD,CAAC;IAED,QAAQ,CAAC,KAAkB;QACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,IAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,WAAW,CACP,OAAe,EACf,OAAmG;QAEnG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,IAAK,CAAC,OAAO,GAAG,IAAI,CAAC,IAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,UAAU;QACN,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,IAAK,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,SAAiB;QAC3B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,IAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,uBAAuB;QACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAQ,KAAK,CAAC,OAAO,CAA0B,IAAI,EAAE,CAAC;IAC1D,CAAC;IAEO,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC9E,CAAC;IACL,CAAC;CACJ"}