@fern-api/replay 0.1.0

package/dist/commands/bootstrap.js

@@ -0,0 +1,268 @@
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { GitClient } from "../git/GitClient.js";
+import { isGenerationCommit, isReplayCommit } from "../git/CommitDetection.js";
+import { LockfileManager } from "../LockfileManager.js";
+import { FernignoreMigrator } from "../FernignoreMigrator.js";
+/**
+ * Bootstrap Replay for an existing SDK repository.
+ *
+ * Scans git history to find all generation commits, identifies
+ * user customization patches between them, and creates the initial replay.lock.
+ *
+ * This is a one-time migration step for SDKs that existed before Replay.
+ */
+export async function bootstrap(outputDir, options) {
+    const git = new GitClient(outputDir);
+    const lockManager = new LockfileManager(outputDir);
+    const maxCommits = options?.maxCommitsToScan ?? 500;
+    const warnings = [];
+    // Check for existing lockfile
+    if (lockManager.exists() && !options?.force) {
+        return {
+            generationCommit: null,
+            patchesDetected: 0,
+            patchesCreated: 0,
+            patches: [],
+            fernignorePatterns: [],
+            fernignoreUpdated: false,
+            warnings: [
+                "Replay lockfile already exists. Use --force to overwrite.",
+            ],
+            staleGenerationsSkipped: 0,
+            scannedSinceGeneration: "",
+        };
+    }
+    // 1. Find ALL generation commits (newest first, excluding replay commits)
+    const genCommits = await findAllGenerationCommits(git, maxCommits);
+    if (genCommits.length === 0) {
+        return {
+            generationCommit: null,
+            patchesDetected: 0,
+            patchesCreated: 0,
+            patches: [],
+            fernignorePatterns: [],
+            fernignoreUpdated: false,
+            warnings: [
+                "No generation commits found in the last " + maxCommits + " commits. " +
+                    "Run 'fern generate' first to establish a baseline.",
+            ],
+            staleGenerationsSkipped: 0,
+            scannedSinceGeneration: "",
+        };
+    }
+    const latestGen = genCommits[0];
+    // 2. Set up in-memory lockfile (don't write to disk yet — we may be in dry-run mode)
+    const treeHash = await git.getTreeHash(latestGen.sha);
+    const genRecord = {
+        commit_sha: latestGen.sha,
+        tree_hash: treeHash,
+        timestamp: new Date().toISOString(),
+        cli_version: "unknown",
+        generator_versions: {},
+    };
+    lockManager.initializeInMemory(genRecord);
+    // 3. Scan between ALL generation commit pairs for user patches
+    const patches = await findAllUserPatches(git, genCommits);
+    // 4. Handle .fernignore if present
+    const migrator = new FernignoreMigrator(git, lockManager, outputDir);
+    const fernignorePatterns = migrator.readFernignorePatterns();
+    let fernignoreAnalysis;
+    if (migrator.fernignoreExists() && fernignorePatterns.length > 0) {
+        fernignoreAnalysis = await migrator.analyzeMigration();
+        // Add synthetic patches from .fernignore analysis
+        if (fernignoreAnalysis.syntheticPatches.length > 0) {
+            patches.push(...fernignoreAnalysis.syntheticPatches);
+        }
+        if (fernignoreAnalysis.fernignoreOnly.length > 0) {
+            for (const file of fernignoreAnalysis.fernignoreOnly) {
+                warnings.push(`${file}: in .fernignore but no recent commits found since last generation. ` +
+                    "File may be stale, matches generated output, or does not exist. No customization to track.");
+            }
+        }
+    }
+    // In dry-run mode, don't persist anything
+    if (options?.dryRun) {
+        return {
+            generationCommit: latestGen,
+            patchesDetected: patches.length,
+            patchesCreated: 0,
+            patches,
+            fernignorePatterns,
+            fernignoreAnalysis,
+            fernignoreUpdated: false,
+            warnings,
+            staleGenerationsSkipped: genCommits.length - 1,
+            scannedSinceGeneration: latestGen.sha,
+        };
+    }
+    // 5. Persist patches to lockfile
+    for (const patch of patches) {
+        lockManager.addPatch(patch);
+    }
+    lockManager.save();
+    // 6. Ensure .fernignore protects replay files from generation wipe
+    const fernignoreUpdated = ensureFernignoreEntries(outputDir);
+    // 7. Handle .fernignore migration
+    if (migrator.fernignoreExists() && fernignorePatterns.length > 0) {
+        const action = options?.fernignoreAction ?? "skip";
+        if (action === "migrate") {
+            // Move truly untrackable patterns (no diff from generated) to replay.yml exclude list
+            const patternsToExclude = fernignoreAnalysis?.fernignoreOnly ?? [];
+            if (patternsToExclude.length > 0) {
+                migrator.movePatternsToReplayYml(patternsToExclude);
+            }
+        }
+    }
+    return {
+        generationCommit: latestGen,
+        patchesDetected: patches.length,
+        patchesCreated: patches.length,
+        patches,
+        fernignorePatterns,
+        fernignoreAnalysis,
+        fernignoreUpdated,
+        warnings,
+        staleGenerationsSkipped: genCommits.length - 1,
+        scannedSinceGeneration: latestGen.sha,
+    };
+}
+/**
+ * Find all generation commits in history, newest first.
+ * Excludes replay commits (which also match isGenerationCommit).
+ */
+async function findAllGenerationCommits(git, maxCommits) {
+    const log = await git.exec([
+        "log",
+        "--format=%H%x00%an%x00%ae%x00%s",
+        `-${maxCommits}`,
+    ]);
+    if (!log.trim()) {
+        return [];
+    }
+    const genCommits = [];
+    for (const line of log.trim().split("\n")) {
+        if (!line)
+            continue;
+        const [sha, authorName, authorEmail, message] = line.split("\0");
+        const commit = { sha, authorName, authorEmail, message };
+        if (isGenerationCommit(commit) && !isReplayCommit(commit)) {
+            genCommits.push(commit);
+        }
+    }
+    return genCommits;
+}
+/**
+ * Find user customization patches since the LAST (most recent) generation.
+ *
+ * Only scans commits between the latest generation and HEAD, ignoring stale
+ * commits from older generations. This infers customer intent: if they didn't
+ * protect old edits and let them be regenerated over multiple times, they
+ * likely don't need them tracked.
+ *
+ * Deduplicates by content hash (handles rebased/cherry-picked commits).
+ */
+async function findAllUserPatches(git, genCommits) {
+    const patches = [];
+    const seenHashes = new Set();
+    // Only scan since the LAST (most recent) generation commit to HEAD
+    // This ignores "stale" commits that were regenerated over before the customer activated replay
+    const latestGen = genCommits[0];
+    const recentPatches = await extractUserPatches(git, latestGen.sha, "HEAD", latestGen.sha, seenHashes);
+    patches.push(...recentPatches);
+    return patches;
+}
+/**
+ * Find user commits in a range (fromSha..toRef) and extract patches.
+ * Returns patches in chronological order (oldest first).
+ */
+async function extractUserPatches(git, fromSha, toRef, baseGeneration, seenHashes) {
+    const log = await git.exec([
+        "log",
+        "--format=%H%x00%an%x00%ae%x00%s",
+        `${fromSha}..${toRef}`,
+    ]);
+    if (!log.trim()) {
+        return [];
+    }
+    const commits = parseGitLog(log);
+    const patches = [];
+    // Process in reverse (oldest first) for chronological order
+    for (const commit of commits.reverse()) {
+        if (isGenerationCommit(commit))
+            continue;
+        const parents = await git.getCommitParents(commit.sha);
+        if (parents.length > 1)
+            continue;
+        const patchContent = await git.formatPatch(commit.sha);
+        const contentHash = computeContentHash(patchContent);
+        if (seenHashes.has(contentHash))
+            continue;
+        seenHashes.add(contentHash);
+        const filesOutput = await git.exec([
+            "diff-tree", "--no-commit-id", "--name-only", "-r", commit.sha,
+        ]);
+        patches.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: baseGeneration,
+            files: filesOutput.trim().split("\n").filter(Boolean),
+            patch_content: patchContent,
+        });
+    }
+    return patches;
+}
+function parseGitLog(log) {
+    return log
+        .trim()
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => {
+        const [sha, authorName, authorEmail, message] = line.split("\0");
+        return { sha, authorName, authorEmail, message };
+    });
+}
+const REPLAY_FERNIGNORE_ENTRIES = [".fern/replay.lock", ".fern/replay.yml"];
+/**
+ * Ensure .fernignore contains entries for replay files so they
+ * survive the `git rm -rf .` wipe during generation.
+ * Creates .fernignore if it doesn't exist.
+ * Returns true if .fernignore was modified.
+ */
+function ensureFernignoreEntries(outputDir) {
+    const fernignorePath = join(outputDir, ".fernignore");
+    let content = "";
+    if (existsSync(fernignorePath)) {
+        content = readFileSync(fernignorePath, "utf-8");
+    }
+    const lines = content.split("\n");
+    const toAdd = [];
+    for (const entry of REPLAY_FERNIGNORE_ENTRIES) {
+        if (!lines.some(line => line.trim() === entry)) {
+            toAdd.push(entry);
+        }
+    }
+    if (toAdd.length === 0) {
+        return false;
+    }
+    if (content && !content.endsWith("\n")) {
+        content += "\n";
+    }
+    content += toAdd.join("\n") + "\n";
+    writeFileSync(fernignorePath, content, "utf-8");
+    return true;
+}
+function 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")}`;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/commands/bootstrap.js.map

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

package/dist/commands/forget.d.ts

@@ -0,0 +1,26 @@
+export interface ForgetOptions {
+    /** Don't actually remove, just show what would be removed */
+    dryRun?: boolean;
+}
+export interface ForgetResult {
+    /** Patches that were (or would be) removed */
+    removed: Array<{
+        id: string;
+        message: string;
+        files: string[];
+    }>;
+    /** True if no patches matched the pattern */
+    notFound: boolean;
+}
+/**
+ * Remove patches matching a file path or glob pattern.
+ *
+ * The next regeneration will NOT replay these patches -
+ * generated code will replace the user's customizations for those files.
+ *
+ * @param outputDir - SDK output directory
+ * @param filePattern - File path or glob pattern (e.g., "src/utils/retry.ts" or "src/legacy/**")
+ * @param options - ForgetOptions
+ */
+export declare function forget(outputDir: string, filePattern: string, options?: ForgetOptions): ForgetResult;
+//# sourceMappingURL=forget.d.ts.map

package/dist/commands/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/commands/forget.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,8CAA8C;IAC9C,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjE,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,aAAa,GACxB,YAAY,CAkCd"}

package/dist/commands/forget.js

@@ -0,0 +1,37 @@
+import { LockfileManager } from "../LockfileManager.js";
+import { minimatch } from "minimatch";
+/**
+ * Remove patches matching a file path or glob pattern.
+ *
+ * The next regeneration will NOT replay these patches -
+ * generated code will replace the user's customizations for those files.
+ *
+ * @param outputDir - SDK output directory
+ * @param filePattern - File path or glob pattern (e.g., "src/utils/retry.ts" or "src/legacy/**")
+ * @param options - ForgetOptions
+ */
+export function forget(outputDir, filePattern, options) {
+    const lockManager = new LockfileManager(outputDir);
+    if (!lockManager.exists()) {
+        return { removed: [], notFound: true };
+    }
+    const lock = lockManager.read();
+    // Find patches that match the pattern
+    const matchingPatches = lock.patches.filter((patch) => patch.files.some((file) => file === filePattern || minimatch(file, filePattern)));
+    if (matchingPatches.length === 0) {
+        return { removed: [], notFound: true };
+    }
+    const removed = matchingPatches.map((p) => ({
+        id: p.id,
+        message: p.original_message,
+        files: p.files,
+    }));
+    if (!options?.dryRun) {
+        for (const patch of matchingPatches) {
+            lockManager.removePatch(patch.id);
+        }
+        lockManager.save();
+    }
+    return { removed, notFound: false };
+}
+//# sourceMappingURL=forget.js.map

package/dist/commands/forget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.js","sourceRoot":"","sources":["../../src/commands/forget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AActC;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAClB,SAAiB,EACjB,WAAmB,EACnB,OAAuB;IAEvB,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAEhC,sCAAsC;IACtC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAClD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,KAAK,WAAW,IAAI,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CACvD,CACJ,CAAC;IAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,gBAAgB;QAC3B,KAAK,EAAE,CAAC,CAAC,KAAK;KACjB,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YAClC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,WAAW,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,6 @@
+export { bootstrap, type BootstrapOptions, type BootstrapResult } from "./bootstrap.js";
+export { forget, type ForgetOptions, type ForgetResult } from "./forget.js";
+export { reset, type ResetOptions, type ResetResult } from "./reset.js";
+export { resolve, type ResolveOptions, type ResolveResult } from "./resolve.js";
+export { status, type StatusResult, type StatusPatch, type StatusGeneration } from "./status.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,6 @@
+export { bootstrap } from "./bootstrap.js";
+export { forget } from "./forget.js";
+export { reset } from "./reset.js";
+export { resolve } from "./resolve.js";
+export { status } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA+C,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAyC,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAuC,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,OAAO,EAA2C,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,MAAM,EAA8D,MAAM,aAAa,CAAC"}

package/dist/commands/reset.d.ts

@@ -0,0 +1,28 @@
+export interface ResetOptions {
+    /** Don't actually delete, just show what would happen */
+    dryRun?: boolean;
+}
+export interface ResetResult {
+    /** Whether reset was successful (or would be) */
+    success: boolean;
+    /** Number of patches that were (or would be) removed */
+    patchesRemoved: number;
+    /** Whether the lockfile was (or would be) deleted */
+    lockfileDeleted: boolean;
+    /** True if there was nothing to reset */
+    nothingToReset: boolean;
+}
+/**
+ * Reset Replay - removes replay.lock entirely.
+ *
+ * User's code changes remain in the repository, but they will NOT be
+ * automatically preserved on the next regeneration. The next `fern generate`
+ * will overwrite everything.
+ *
+ * Recovery: Run `fern-replay bootstrap` to re-initialize from git history.
+ *
+ * @param outputDir - SDK output directory
+ * @param options - ResetOptions
+ */
+export declare function reset(outputDir: string, options?: ResetOptions): ResetResult;
+//# sourceMappingURL=reset.d.ts.map

package/dist/commands/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../src/commands/reset.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IACzB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IACxB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAyB5E"}

package/dist/commands/reset.js

@@ -0,0 +1,37 @@
+import { LockfileManager } from "../LockfileManager.js";
+import { unlinkSync } from "node:fs";
+/**
+ * Reset Replay - removes replay.lock entirely.
+ *
+ * User's code changes remain in the repository, but they will NOT be
+ * automatically preserved on the next regeneration. The next `fern generate`
+ * will overwrite everything.
+ *
+ * Recovery: Run `fern-replay bootstrap` to re-initialize from git history.
+ *
+ * @param outputDir - SDK output directory
+ * @param options - ResetOptions
+ */
+export function reset(outputDir, options) {
+    const lockManager = new LockfileManager(outputDir);
+    if (!lockManager.exists()) {
+        return {
+            success: true,
+            patchesRemoved: 0,
+            lockfileDeleted: false,
+            nothingToReset: true,
+        };
+    }
+    const lock = lockManager.read();
+    const patchCount = lock.patches.length;
+    if (!options?.dryRun) {
+        unlinkSync(lockManager.lockfilePath);
+    }
+    return {
+        success: true,
+        patchesRemoved: patchCount,
+        lockfileDeleted: true,
+        nothingToReset: false,
+    };
+}
+//# sourceMappingURL=reset.js.map

package/dist/commands/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../src/commands/reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkBrC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,SAAiB,EAAE,OAAsB;IAC3D,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACxB,OAAO;YACH,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;SACvB,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAEvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACH,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,UAAU;QAC1B,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;KACxB,CAAC;AACN,CAAC"}

package/dist/commands/resolve.d.ts

@@ -0,0 +1,16 @@
+export interface ResolveOptions {
+    /** Check for remaining conflict markers before committing. Default: true */
+    checkMarkers?: boolean;
+}
+export interface ResolveResult {
+    /** Whether the resolve succeeded */
+    success: boolean;
+    /** Commit SHA of the [fern-replay] commit, if created */
+    commitSha?: string;
+    /** Reason for failure */
+    reason?: string;
+    /** Files that still have conflict markers */
+    unresolvedFiles?: string[];
+}
+export declare function resolve(outputDir: string, options?: ResolveOptions): Promise<ResolveResult>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/commands/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/commands/resolve.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC3B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC1B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BjG"}

package/dist/commands/resolve.js

@@ -0,0 +1,28 @@
+import { GitClient } from "../git/GitClient.js";
+import { LockfileManager } from "../LockfileManager.js";
+import { ReplayCommitter } from "../ReplayCommitter.js";
+export async function resolve(outputDir, options) {
+    const lockManager = new LockfileManager(outputDir);
+    if (!lockManager.exists()) {
+        return { success: false, reason: "no-lockfile" };
+    }
+    const lock = lockManager.read();
+    if (lock.patches.length === 0) {
+        return { success: false, reason: "no-patches" };
+    }
+    const git = new GitClient(outputDir);
+    // Check for remaining conflict markers
+    if (options?.checkMarkers !== false) {
+        const markerFiles = await git.exec(["grep", "-l", "<<<<<<<", "--", "."]).catch(() => "");
+        if (markerFiles.trim()) {
+            const files = markerFiles.trim().split("\n").filter(Boolean);
+            return { success: false, reason: "unresolved-conflicts", unresolvedFiles: files };
+        }
+    }
+    // Stage all changes and create [fern-replay] commit
+    const committer = new ReplayCommitter(git, outputDir);
+    await committer.stageAll();
+    const commitSha = await committer.commitReplay(lock.patches.length, lock.patches);
+    return { success: true, commitSha };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/commands/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/commands/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAkBxD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,SAAiB,EAAE,OAAwB;IACrE,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC;IAErC,uCAAuC;IACvC,IAAI,OAAO,EAAE,YAAY,KAAK,KAAK,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;QACtF,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAElF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,34 @@
+export interface StatusResult {
+    /** Whether replay is initialized (lockfile exists) */
+    initialized: boolean;
+    /** Tracked customization patches */
+    patches: StatusPatch[];
+    /** Last generation info, if available */
+    lastGeneration: StatusGeneration | undefined;
+}
+export interface StatusPatch {
+    /** Short SHA of the original commit */
+    sha: string;
+    /** Author name (without email) */
+    author: string;
+    /** Original commit message */
+    message: string;
+    /** Files touched by this patch */
+    files: string[];
+}
+export interface StatusGeneration {
+    /** Full commit SHA */
+    sha: string;
+    /** Generation timestamp */
+    timestamp: string;
+}
+/**
+ * Get the current Replay status for an SDK repository.
+ *
+ * Returns structured info about tracked patches and the last generation.
+ * The CLI can format this however it wants.
+ *
+ * @param outputDir - SDK output directory
+ */
+export declare function status(outputDir: string): StatusResult;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IACzB,sDAAsD;IACtD,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,yCAAyC;IACzC,cAAc,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IACxB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC7B,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CA0BtD"}

package/dist/commands/status.js

@@ -0,0 +1,32 @@
+import { LockfileManager } from "../LockfileManager.js";
+/**
+ * Get the current Replay status for an SDK repository.
+ *
+ * Returns structured info about tracked patches and the last generation.
+ * The CLI can format this however it wants.
+ *
+ * @param outputDir - SDK output directory
+ */
+export function status(outputDir) {
+    const lockManager = new LockfileManager(outputDir);
+    if (!lockManager.exists()) {
+        return { initialized: false, patches: [], lastGeneration: undefined };
+    }
+    const lock = lockManager.read();
+    const patches = lock.patches.map((patch) => ({
+        sha: patch.original_commit.slice(0, 7),
+        author: patch.original_author.split("<")[0]?.trim() ?? "unknown",
+        message: patch.original_message,
+        files: patch.files,
+    }));
+    let lastGeneration;
+    const lastGen = lock.generations.find((g) => g.commit_sha === lock.current_generation);
+    if (lastGen) {
+        lastGeneration = {
+            sha: lastGen.commit_sha,
+            timestamp: lastGen.timestamp,
+        };
+    }
+    return { initialized: true, patches, lastGeneration };
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA6BxD;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,SAAiB;IACpC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAkB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,GAAG,EAAE,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QAChE,OAAO,EAAE,KAAK,CAAC,gBAAgB;QAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;KACrB,CAAC,CAAC,CAAC;IAEJ,IAAI,cAA4C,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACvF,IAAI,OAAO,EAAE,CAAC;QACV,cAAc,GAAG;YACb,GAAG,EAAE,OAAO,CAAC,UAAU;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC/B,CAAC;IACN,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1D,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detect whether the current process is running in a CI environment.
+ */
+export declare function isCI(): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAW9B"}

package/dist/environment.js

@@ -0,0 +1,14 @@
+/**
+ * Detect whether the current process is running in a CI environment.
+ */
+export function isCI() {
+    return !!(process.env.CI ||
+        process.env.CONTINUOUS_INTEGRATION ||
+        process.env.GITHUB_ACTIONS ||
+        process.env.GITLAB_CI ||
+        process.env.CIRCLECI ||
+        process.env.BUILDKITE ||
+        process.env.JENKINS_URL ||
+        process.env.TRAVIS);
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,IAAI;IAChB,OAAO,CAAC,CAAC,CACL,OAAO,CAAC,GAAG,CAAC,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAClC,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,OAAO,CAAC,GAAG,CAAC,SAAS;QACrB,OAAO,CAAC,GAAG,CAAC,QAAQ;QACpB,OAAO,CAAC,GAAG,CAAC,SAAS;QACrB,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CACrB,CAAC;AACN,CAAC"}

package/dist/git/CommitDetection.d.ts

@@ -0,0 +1,17 @@
+import type { CommitInfo } from "../types.js";
+export declare const FERN_BOT_NAME = "fern-api";
+export declare const FERN_BOT_EMAIL = "115122769+fern-api[bot]@users.noreply.github.com";
+export declare const FERN_BOT_LOGIN = "fern-api[bot]";
+/**
+ * Determines if a commit is a Fern generation commit using dual signals:
+ * 1. Author is fern-api bot (but NOT fern-support using the bot account)
+ * 2. Commit message contains generation markers
+ *
+ * Either signal indicates a generation commit.
+ */
+export declare function isGenerationCommit(commit: CommitInfo): boolean;
+/**
+ * Determines if a commit is a replay commit (applied customizations).
+ */
+export declare function isReplayCommit(commit: CommitInfo): boolean;
+//# sourceMappingURL=CommitDetection.d.ts.map

package/dist/git/CommitDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommitDetection.d.ts","sourceRoot":"","sources":["../../src/git/CommitDetection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,cAAc,qDAAqD,CAAC;AACjF,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAO9C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAiB9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE1D"}