@fern-api/replay 0.16.1 → 0.17.4

package/dist/index.d.cts

@@ -101,6 +101,17 @@ interface FileResult {
      * if needed. Empty/undefined when no such lines exist.
      */
     droppedContextLines?: string[];
+    /**
+     * INC-866 silent-loss signal. Set on a `new-file-both` result when BASE was
+     * null because the patch's base-generation tree is unreachable (shallow
+     * clone window too small / pruned history) rather than because the file is
+     * genuinely new. In that state an edited-existing-file customization can be
+     * dropped with no conflict and no error. Surfaced as a ReplayReport warning
+     * (`recordUnreachableBaseWarnings`) so callers/CLI learn the clone window
+     * was insufficient instead of losing the edit silently. Undefined/false in
+     * the benign case.
+     */
+    baseTreeUnreachable?: boolean;
 }
 interface ConflictRegion {
     startLine: number;
@@ -266,8 +277,9 @@ declare class ReplayDetector {
     private git;
     private lockManager;
     private sdkOutputDir;
+    private fernignorePatterns;
     readonly warnings: string[];
-    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string);
+    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string, fernignorePatterns?: readonly string[]);
     /**
      * Derive the previous-generation SHA from git history instead of trusting
      * `lock.current_generation`.
@@ -737,6 +749,19 @@ declare class ReplayService {
      * `applyPreparedReplay` (e.g., `[fern-autoversion]`).
      */
     prepareReplay(options?: ReplayOptions): Promise<ReplayPreparation>;
+    /**
+     * ADR 0002 migration step. Strips `.fernignore`-matched entries from
+     * `patch.files`, `patch.theirs_snapshot` keys, and `diff --git` sections
+     * in `patch.patch_content` for every patch in the lockfile. Patches that
+     * end up with no surviving files are removed entirely.
+     *
+     * Idempotent: a second run is a no-op because the first run already
+     * matches the contract. Per-patch try/catch ensures one bad patch does
+     * not block the rest. Each affected patch emits a warning naming the
+     * stripped paths. `patch_content` is left untouched if no parseable
+     * `diff --git` headers are found (fail-safe for exotic legacy formats).
+     */
+    private cleanseLegacyFernignoreEntries;
     /**
      * Phase 2 of the two-phase replay flow. Applies patches, rebases them against
      * the generation, saves the lockfile, and commits `[fern-replay]` (or stages
@@ -871,6 +896,22 @@ declare class ReplayService {
      */
     /** @internal Used by Flow implementations in `src/flows/`. */
     recordDroppedContextLineWarnings(results: ReplayResult[]): void;
+    /**
+     * After applyPatches(), surface a warning for each (patch × file) where a
+     * customization's BASE could not be read because the patch's
+     * base-generation tree is unreachable in this clone (shallow-clone window
+     * too small / pruned history). In that state the merge pipeline falls
+     * through to `new-file-both` and the customer's edit can be dropped with NO
+     * conflict and NO error — the INC-866 silent-loss class. This converts that
+     * silence into an explicit, actionable warning naming the file and the
+     * likely cause (insufficient clone window).
+     *
+     * Mirrors `recordDroppedContextLineWarnings`'s "surface, never silently
+     * drop" contract. De-duplicated per file path so a single insufficient
+     * window doesn't spam one warning per touched file repeatedly.
+     */
+    /** @internal Used by Flow implementations in `src/flows/`. */
+    recordUnreachableBaseWarnings(results: ReplayResult[]): void;
     /**
      * After applyPatches(), strip conflict markers from conflicting files
      * so only clean content is committed. Keeps the Generated (OURS) side.

package/dist/index.d.ts

@@ -101,6 +101,17 @@ interface FileResult {
      * if needed. Empty/undefined when no such lines exist.
      */
     droppedContextLines?: string[];
+    /**
+     * INC-866 silent-loss signal. Set on a `new-file-both` result when BASE was
+     * null because the patch's base-generation tree is unreachable (shallow
+     * clone window too small / pruned history) rather than because the file is
+     * genuinely new. In that state an edited-existing-file customization can be
+     * dropped with no conflict and no error. Surfaced as a ReplayReport warning
+     * (`recordUnreachableBaseWarnings`) so callers/CLI learn the clone window
+     * was insufficient instead of losing the edit silently. Undefined/false in
+     * the benign case.
+     */
+    baseTreeUnreachable?: boolean;
 }
 interface ConflictRegion {
     startLine: number;
@@ -266,8 +277,9 @@ declare class ReplayDetector {
     private git;
     private lockManager;
     private sdkOutputDir;
+    private fernignorePatterns;
     readonly warnings: string[];
-    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string);
+    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string, fernignorePatterns?: readonly string[]);
     /**
      * Derive the previous-generation SHA from git history instead of trusting
      * `lock.current_generation`.
@@ -737,6 +749,19 @@ declare class ReplayService {
      * `applyPreparedReplay` (e.g., `[fern-autoversion]`).
      */
     prepareReplay(options?: ReplayOptions): Promise<ReplayPreparation>;
+    /**
+     * ADR 0002 migration step. Strips `.fernignore`-matched entries from
+     * `patch.files`, `patch.theirs_snapshot` keys, and `diff --git` sections
+     * in `patch.patch_content` for every patch in the lockfile. Patches that
+     * end up with no surviving files are removed entirely.
+     *
+     * Idempotent: a second run is a no-op because the first run already
+     * matches the contract. Per-patch try/catch ensures one bad patch does
+     * not block the rest. Each affected patch emits a warning naming the
+     * stripped paths. `patch_content` is left untouched if no parseable
+     * `diff --git` headers are found (fail-safe for exotic legacy formats).
+     */
+    private cleanseLegacyFernignoreEntries;
     /**
      * Phase 2 of the two-phase replay flow. Applies patches, rebases them against
      * the generation, saves the lockfile, and commits `[fern-replay]` (or stages
@@ -871,6 +896,22 @@ declare class ReplayService {
      */
     /** @internal Used by Flow implementations in `src/flows/`. */
     recordDroppedContextLineWarnings(results: ReplayResult[]): void;
+    /**
+     * After applyPatches(), surface a warning for each (patch × file) where a
+     * customization's BASE could not be read because the patch's
+     * base-generation tree is unreachable in this clone (shallow-clone window
+     * too small / pruned history). In that state the merge pipeline falls
+     * through to `new-file-both` and the customer's edit can be dropped with NO
+     * conflict and NO error — the INC-866 silent-loss class. This converts that
+     * silence into an explicit, actionable warning naming the file and the
+     * likely cause (insufficient clone window).
+     *
+     * Mirrors `recordDroppedContextLineWarnings`'s "surface, never silently
+     * drop" contract. De-duplicated per file path so a single insufficient
+     * window doesn't spam one warning per touched file repeatedly.
+     */
+    /** @internal Used by Flow implementations in `src/flows/`. */
+    recordUnreachableBaseWarnings(results: ReplayResult[]): void;
     /**
      * After applyPatches(), strip conflict markers from conflicting files
      * so only clean content is committed. Keeps the Generated (OURS) side.