@fern-api/replay 0.1.0

package/dist/ReplayCommitter.js

@@ -0,0 +1,84 @@
+export class ReplayCommitter {
+    git;
+    outputDir;
+    constructor(git, outputDir) {
+        this.git = git;
+        this.outputDir = outputDir;
+    }
+    /**
+     * Commit the generation output (after generator runs, before replay).
+     * Uses [fern-generated] prefix for detection.
+     */
+    async commitGeneration(message, options) {
+        await this.stageAll();
+        if (!(await this.hasStagedChanges())) {
+            return (await this.git.exec(["rev-parse", "HEAD"])).trim();
+        }
+        let fullMessage = `[fern-generated] ${message}\n\nGenerated by Fern`;
+        if (options?.cliVersion) {
+            fullMessage += `\nCLI Version: ${options.cliVersion}`;
+        }
+        if (options?.generatorVersions && Object.keys(options.generatorVersions).length > 0) {
+            fullMessage += "\nGenerators:";
+            for (const [name, version] of Object.entries(options.generatorVersions)) {
+                fullMessage += `\n  - ${name}: ${version}`;
+            }
+        }
+        await this.git.exec(["commit", "-m", fullMessage]);
+        return (await this.git.exec(["rev-parse", "HEAD"])).trim();
+    }
+    /**
+     * Commit the replay result (after patches applied).
+     * Uses [fern-replay] prefix for detection.
+     */
+    async commitReplay(patchCount, patches) {
+        await this.stageAll();
+        if (!(await this.hasStagedChanges())) {
+            return (await this.git.exec(["rev-parse", "HEAD"])).trim();
+        }
+        let fullMessage = `[fern-replay] Applied ${patchCount} customization(s)`;
+        if (patches && patches.length > 0) {
+            fullMessage += "\n\nPatches replayed:";
+            for (const patch of patches) {
+                fullMessage += `\n  - ${patch.id}: ${patch.original_message}`;
+            }
+        }
+        await this.git.exec(["commit", "-m", fullMessage]);
+        return (await this.git.exec(["rev-parse", "HEAD"])).trim();
+    }
+    /**
+     * Create a GenerationRecord for the current state.
+     * Captures commit SHA and tree hash for future 3-way merges.
+     */
+    async createGenerationRecord(options) {
+        const commitSha = (await this.git.exec(["rev-parse", "HEAD"])).trim();
+        const treeHash = await this.getTreeHash(commitSha);
+        return {
+            commit_sha: commitSha,
+            tree_hash: treeHash,
+            timestamp: new Date().toISOString(),
+            cli_version: options?.cliVersion ?? "unknown",
+            generator_versions: options?.generatorVersions ?? {},
+        };
+    }
+    /**
+     * Stage all changes in output directory.
+     */
+    async stageAll() {
+        await this.git.exec(["add", "-A", this.outputDir]);
+    }
+    /**
+     * Check if there are staged changes to commit.
+     */
+    async hasStagedChanges() {
+        const output = await this.git.exec(["diff", "--cached", "--name-only"]);
+        return output.trim().length > 0;
+    }
+    /**
+     * Get the tree hash for a commit.
+     */
+    async getTreeHash(commitSha) {
+        return this.git.getTreeHash(commitSha);
+    }
+}
+//# sourceMappingURL=ReplayCommitter.js.map

package/dist/ReplayCommitter.js.map

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

package/dist/ReplayDetector.d.ts

@@ -0,0 +1,25 @@
+import type { GitClient } from "./git/GitClient.js";
+import type { LockfileManager } from "./LockfileManager.js";
+import type { StoredPatch } from "./types.js";
+export declare class ReplayDetector {
+    private git;
+    private lockManager;
+    private sdkOutputDir;
+    readonly warnings: string[];
+    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string);
+    /**
+     * Detect new customization patches since last generation.
+     * Filters out generation/replay commits, merge commits,
+     * and already-tracked patches (by SHA or content hash).
+     */
+    detectNewPatches(): Promise<StoredPatch[]>;
+    /**
+     * Compute content hash for deduplication.
+     * Removes commit SHA line and index lines before hashing,
+     * so rebased commits with same content produce the same hash.
+     */
+    computeContentHash(patchContent: string): string;
+    private parseGitLog;
+    private getLastGeneration;
+}
+//# sourceMappingURL=ReplayDetector.d.ts.map

package/dist/ReplayDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayDetector.d.ts","sourceRoot":"","sources":["../src/ReplayDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAA8B,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1E,qBAAa,cAAc;IACvB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;gBAErB,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM;IAM9E;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiFhD;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAShD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,iBAAiB;CAG5B"}

package/dist/ReplayDetector.js

@@ -0,0 +1,110 @@
+import { createHash } from "node:crypto";
+import { isGenerationCommit } from "./git/CommitDetection.js";
+// Infrastructure files managed by the generation pipeline, not user code.
+// Changes to these should never be captured as customization patches.
+const INFRASTRUCTURE_FILES = new Set([".fernignore"]);
+export class ReplayDetector {
+    git;
+    lockManager;
+    sdkOutputDir;
+    warnings = [];
+    constructor(git, lockManager, sdkOutputDir) {
+        this.git = git;
+        this.lockManager = lockManager;
+        this.sdkOutputDir = sdkOutputDir;
+    }
+    /**
+     * Detect new customization patches since last generation.
+     * Filters out generation/replay commits, merge commits,
+     * and already-tracked patches (by SHA or content hash).
+     */
+    async detectNewPatches() {
+        const lock = this.lockManager.read();
+        const lastGen = this.getLastGeneration(lock);
+        if (!lastGen) {
+            return [];
+        }
+        const exists = await this.git.commitExists(lastGen.commit_sha);
+        if (!exists) {
+            this.warnings.push(`Generation commit ${lastGen.commit_sha.slice(0, 7)} not found in git history. ` +
+                `Skipping new patch detection. Existing lockfile patches will still be applied.`);
+            return [];
+        }
+        const log = await this.git.exec([
+            "log",
+            "--format=%H%x00%an%x00%ae%x00%s",
+            `${lastGen.commit_sha}..HEAD`,
+            "--",
+            this.sdkOutputDir
+        ]);
+        if (!log.trim()) {
+            return [];
+        }
+        const commits = this.parseGitLog(log);
+        const newPatches = [];
+        for (const commit of commits) {
+            if (isGenerationCommit(commit)) {
+                continue;
+            }
+            const parents = await this.git.getCommitParents(commit.sha);
+            if (parents.length > 1) {
+                continue;
+            }
+            if (lock.patches.find((p) => p.original_commit === commit.sha)) {
+                continue;
+            }
+            const patchContent = await this.git.formatPatch(commit.sha);
+            const contentHash = this.computeContentHash(patchContent);
+            if (lock.patches.find((p) => p.content_hash === contentHash)) {
+                continue;
+            }
+            const filesOutput = await this.git.exec(["diff-tree", "--no-commit-id", "--name-only", "-r", commit.sha]);
+            const files = filesOutput
+                .trim()
+                .split("\n")
+                .filter(Boolean)
+                .filter((f) => !INFRASTRUCTURE_FILES.has(f));
+            // Skip patches that only touch infrastructure files
+            if (files.length === 0) {
+                continue;
+            }
+            newPatches.push({
+                id: `patch-${commit.sha.slice(0, 8)}`,
+                content_hash: contentHash,
+                original_commit: commit.sha,
+                original_message: commit.message,
+                original_author: `${commit.authorName} <${commit.authorEmail}>`,
+                base_generation: lastGen.commit_sha,
+                files,
+                patch_content: patchContent
+            });
+        }
+        // Reverse so patches apply in chronological order (oldest first)
+        return newPatches.reverse();
+    }
+    /**
+     * Compute content hash for deduplication.
+     * Removes commit SHA line and index lines before hashing,
+     * so rebased commits with same content produce the same hash.
+     */
+    computeContentHash(patchContent) {
+        const normalized = patchContent
+            .split("\n")
+            .filter((line) => !line.startsWith("From ") && !line.startsWith("index ") && !line.startsWith("Date: "))
+            .join("\n");
+        return `sha256:${createHash("sha256").update(normalized).digest("hex")}`;
+    }
+    parseGitLog(log) {
+        return log
+            .trim()
+            .split("\n")
+            .map((line) => {
+            const [sha, authorName, authorEmail, message] = line.split("\0");
+            return { sha, authorName, authorEmail, message };
+        });
+    }
+    getLastGeneration(lock) {
+        return lock.generations.find((g) => g.commit_sha === lock.current_generation);
+    }
+}
+//# sourceMappingURL=ReplayDetector.js.map

package/dist/ReplayDetector.js.map

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

package/dist/ReplayService.d.ts

@@ -0,0 +1,103 @@
+import type { ReplayConfig, StoredPatch, FileResult } from "./types.js";
+export interface ConflictDetail {
+    patchId: string;
+    patchMessage: string;
+    reason?: string;
+    files: FileResult[];
+}
+export interface ReplayReport {
+    flow: "first-generation" | "no-patches" | "normal-regeneration";
+    patchesDetected: number;
+    patchesApplied: number;
+    patchesWithConflicts: number;
+    patchesSkipped: number;
+    patchesAbsorbed?: number;
+    patchesRepointed?: number;
+    patchesContentRebased?: number;
+    patchesKeptAsUserOwned?: number;
+    conflicts: FileResult[];
+    conflictDetails?: ConflictDetail[];
+    wouldApply?: StoredPatch[];
+    warnings?: string[];
+}
+export declare class ReplayConflictError extends Error {
+    readonly report: ReplayReport;
+    constructor(report: ReplayReport);
+}
+export interface ReplayOptions {
+    /** Log what would happen but don't modify anything */
+    dryRun?: boolean;
+    /** Write files and stage changes, but don't commit */
+    stageOnly?: boolean;
+    /** CLI version for commit metadata */
+    cliVersion?: string;
+    /** Generator versions for commit metadata */
+    generatorVersions?: Record<string, string>;
+}
+export declare class ReplayService {
+    private git;
+    private config;
+    private detector;
+    private applicator;
+    private committer;
+    private lockManager;
+    private outputDir;
+    constructor(outputDir: string, config: ReplayConfig);
+    /**
+     * Run the full replay flow.
+     */
+    runReplay(options?: ReplayOptions): Promise<ReplayReport>;
+    /**
+     * Determine which flow to use based on lockfile state.
+     */
+    private determineFlow;
+    /**
+     * First generation - just create lockfile, no patches to apply.
+     */
+    private handleFirstGeneration;
+    /**
+     * No existing patches - detect new ones and apply if any.
+     */
+    private handleNoPatchesRegeneration;
+    /**
+     * Normal flow - apply existing patches + detect new ones.
+     */
+    private handleNormalRegeneration;
+    /**
+     * Get the active conflict policy based on config and environment.
+     * Returns undefined when on_conflict is not configured (backwards-compatible).
+     */
+    private getConflictPolicy;
+    /**
+     * Auto-resolve all conflict markers in conflicted files.
+     * "ours" = keep generated code, "theirs" = keep user customization.
+     */
+    private autoResolveConflicts;
+    /**
+     * Phase 1: Resolve conflict markers on disk BEFORE rebasing.
+     * Handles keep-mine, keep-generated, and prompt policies.
+     * Must run before rebasePatches() so rebased content captures clean files.
+     */
+    private resolveConflictsOnDisk;
+    /**
+     * Phase 2: Throw for "fail" policy AFTER lockfile save.
+     * This ensures the lockfile is preserved even when we reject the commit.
+     */
+    private enforceConflictFailPolicy;
+    /**
+     * Rebase cleanly applied patches so they are relative to the current generation.
+     * This prevents recurring conflicts on subsequent regenerations.
+     * Returns the number of patches rebased.
+     */
+    private rebasePatches;
+    /**
+     * Read .fernignore patterns from the output directory.
+     * Returns an empty array if .fernignore doesn't exist.
+     */
+    private readFernignorePatterns;
+    /**
+     * Build the final report from results.
+     */
+    private buildReport;
+}
+//# sourceMappingURL=ReplayService.d.ts.map

package/dist/ReplayService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayService.d.ts","sourceRoot":"","sources":["../src/ReplayService.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,kBAAkB,GAAG,YAAY,GAAG,qBAAqB,CAAC;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,YAAY,CAAC;gBAEzB,MAAM,EAAE,YAAY;CAKnC;AAED,MAAM,WAAW,aAAa;IAC1B,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,qBAAa,aAAa;IACtB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAS;gBAGtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY;IAYxB;;OAEG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAa/D;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;YACW,qBAAqB;IA+BnC;;OAEG;YACW,2BAA2B;IAoEzC;;OAEG;YACW,wBAAwB;IA6DtC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;YACW,oBAAoB;IAsBlC;;;;OAIG;YACW,sBAAsB;IA+DpC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;OAIG;YACW,aAAa;IAqG3B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;IACH,OAAO,CAAC,WAAW;CAmCtB"}