@fern-api/replay 0.8.1 → 0.9.1

package/dist/index.d.cts

@@ -3,6 +3,7 @@ interface GenerationLock {
     generations: GenerationRecord[];
     current_generation: string;
     patches: StoredPatch[];
+    forgotten_hashes?: string[];
     replay_skipped_at?: string;
 }
 interface GenerationRecord {
@@ -100,6 +101,7 @@ declare class GitClient {
     }>>;
     isAncestor(commit: string, descendant: string): Promise<boolean>;
     commitExists(sha: string): Promise<boolean>;
+    treeExists(treeHash: string): Promise<boolean>;
     getCommitBody(commitSha: string): Promise<string>;
     getRepoPath(): string;
 }
@@ -137,6 +139,7 @@ declare class LockfileManager {
     updatePatch(patchId: string, updates: Partial<Pick<StoredPatch, "base_generation" | "patch_content" | "content_hash" | "files" | "status">>): void;
     removePatch(patchId: string): void;
     clearPatches(): void;
+    addForgottenHash(hash: string): void;
     getUnresolvedPatches(): StoredPatch[];
     getResolvingPatches(): StoredPatch[];
     markPatchUnresolved(patchId: string): void;
@@ -192,6 +195,7 @@ declare class ReplayApplicator {
     private lockManager;
     private outputDir;
     private renameCache;
+    private treeExistsCache;
     private fileTheirsAccumulator;
     constructor(git: GitClient, lockManager: LockfileManager, outputDir: string);
     /** Reset inter-patch accumulator for a new cycle. */
@@ -206,6 +210,7 @@ declare class ReplayApplicator {
     private applyPatchWithFallback;
     private applyWithThreeWayMerge;
     private mergeFile;
+    private isTreeReachable;
     private isExcluded;
     private resolveFilePath;
     private applyPatchToContent;
@@ -426,18 +431,43 @@ declare function bootstrap(outputDir: string, options?: BootstrapOptions): Promi
 interface ForgetOptions {
     /** Don't actually remove, just show what would be removed */
     dryRun?: boolean;
+    /** Remove all tracked patches (keep lockfile and generation history) */
+    all?: boolean;
+    /** Specific patch IDs to remove */
+    patchIds?: string[];
+    /** Search pattern: file path, glob, or commit message substring */
+    pattern?: string;
+}
+interface DiffStat {
+    additions: number;
+    deletions: number;
+}
+interface MatchedPatch {
+    id: string;
+    message: string;
+    files: string[];
+    diffstat: DiffStat;
+    status?: "unresolved" | "resolving";
 }
 interface ForgetResult {
-    /** Patches that were (or would be) removed */
-    removed: Array<{
-        id: string;
-        message: string;
-        files: string[];
-    }>;
-    /** True if no patches matched the pattern */
+    /** Whether replay is initialized (lockfile exists) */
+    initialized: boolean;
+    /** Patches that were (or would be in dry-run) removed */
+    removed: MatchedPatch[];
+    /** Number of patches remaining after removal */
+    remaining: number;
+    /** True if a search/pattern was given but nothing matched */
     notFound: boolean;
+    /** Patch IDs that were specified but don't exist (idempotent mode) */
+    alreadyForgotten: string[];
+    /** Total patches before removal */
+    totalPatches: number;
+    /** Warnings (e.g., forgetting patches with conflict markers on disk) */
+    warnings: string[];
+    /** Matching patches for interactive selection (search/no-arg mode only) */
+    matched?: MatchedPatch[];
 }
-declare function forget(outputDir: string, filePattern: string, options?: ForgetOptions): ForgetResult;
+declare function forget(outputDir: string, options?: ForgetOptions): ForgetResult;
 
 interface ResetOptions {
     /** Don't actually delete, just show what would happen */
@@ -480,27 +510,45 @@ declare function resolve(outputDir: string, options?: ResolveOptions): Promise<R
 interface StatusResult {
     /** Whether replay is initialized (lockfile exists) */
     initialized: boolean;
-    /** Tracked customization patches */
-    patches: StatusPatch[];
+    /** Total number of generations tracked */
+    generationCount: number;
     /** Last generation info, if available */
     lastGeneration: StatusGeneration | undefined;
+    /** Tracked customization patches */
+    patches: StatusPatch[];
+    /** Count of patches with "unresolved" or "resolving" status */
+    unresolvedCount: number;
+    /** Exclude patterns from replay.yml */
+    excludePatterns: string[];
 }
 interface StatusPatch {
-    /** Short SHA of the original commit */
-    sha: string;
-    /** Author name (without email) */
-    author: string;
+    /** Patch ID (e.g. "patch-def45678") */
+    id: string;
+    /** "added" if patch_content contains "new file mode", otherwise "modified" */
+    type: "added" | "modified";
     /** Original commit message */
     message: string;
+    /** Author name (without email) */
+    author: string;
+    /** Short SHA of the original commit (7 chars) */
+    sha: string;
     /** Files touched by this patch */
     files: string[];
+    /** Number of files */
+    fileCount: number;
+    /** Patch resolution status, if any */
+    status?: "unresolved" | "resolving";
 }
 interface StatusGeneration {
-    /** Full commit SHA */
+    /** Short commit SHA (7 chars) */
     sha: string;
     /** Generation timestamp */
     timestamp: string;
+    /** CLI version used for generation */
+    cliVersion: string;
+    /** Generator versions (e.g. { "fern-java-sdk": "3.35.0" }) */
+    generatorVersions: Record<string, string>;
 }
 declare function status(outputDir: string): StatusResult;
 
-export { type BootstrapOptions, type BootstrapResult, type CommitInfo, type CommitOptions, type ConflictDetail, type ConflictMetadata, type ConflictReason, type ConflictRegion, type CustomizationsConfig, type DetectionResult, FERN_BOT_EMAIL, FERN_BOT_LOGIN, FERN_BOT_NAME, FernignoreMigrator, type FileResult, type ForgetOptions, type ForgetResult, type GenerationLock, type GenerationRecord, GitClient, LockfileManager, type MergeResult, type MigrationAnalysis, type MigrationResult, type MoveDeclaration, ReplayApplicator, ReplayCommitter, type ReplayConfig, ReplayDetector, type ReplayOptions, type ReplayReport, type ReplayResult, ReplayService, type ResetOptions, type ResetResult, type ResolveOptions, type ResolveResult, type StatusGeneration, type StatusPatch, type StatusResult, type StoredPatch, type UnresolvedPatchInfo, bootstrap, forget, isGenerationCommit, isReplayCommit, isRevertCommit, parseRevertedMessage, parseRevertedSha, reset, resolve, status, threeWayMerge };
+export { type BootstrapOptions, type BootstrapResult, type CommitInfo, type CommitOptions, type ConflictDetail, type ConflictMetadata, type ConflictReason, type ConflictRegion, type CustomizationsConfig, type DetectionResult, type DiffStat, FERN_BOT_EMAIL, FERN_BOT_LOGIN, FERN_BOT_NAME, FernignoreMigrator, type FileResult, type ForgetOptions, type ForgetResult, type GenerationLock, type GenerationRecord, GitClient, LockfileManager, type MatchedPatch, type MergeResult, type MigrationAnalysis, type MigrationResult, type MoveDeclaration, ReplayApplicator, ReplayCommitter, type ReplayConfig, ReplayDetector, type ReplayOptions, type ReplayReport, type ReplayResult, ReplayService, type ResetOptions, type ResetResult, type ResolveOptions, type ResolveResult, type StatusGeneration, type StatusPatch, type StatusResult, type StoredPatch, type UnresolvedPatchInfo, bootstrap, forget, isGenerationCommit, isReplayCommit, isRevertCommit, parseRevertedMessage, parseRevertedSha, reset, resolve, status, threeWayMerge };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ interface GenerationLock {
     generations: GenerationRecord[];
     current_generation: string;
     patches: StoredPatch[];
+    forgotten_hashes?: string[];
     replay_skipped_at?: string;
 }
 interface GenerationRecord {
@@ -100,6 +101,7 @@ declare class GitClient {
     }>>;
     isAncestor(commit: string, descendant: string): Promise<boolean>;
     commitExists(sha: string): Promise<boolean>;
+    treeExists(treeHash: string): Promise<boolean>;
     getCommitBody(commitSha: string): Promise<string>;
     getRepoPath(): string;
 }
@@ -137,6 +139,7 @@ declare class LockfileManager {
     updatePatch(patchId: string, updates: Partial<Pick<StoredPatch, "base_generation" | "patch_content" | "content_hash" | "files" | "status">>): void;
     removePatch(patchId: string): void;
     clearPatches(): void;
+    addForgottenHash(hash: string): void;
     getUnresolvedPatches(): StoredPatch[];
     getResolvingPatches(): StoredPatch[];
     markPatchUnresolved(patchId: string): void;
@@ -192,6 +195,7 @@ declare class ReplayApplicator {
     private lockManager;
     private outputDir;
     private renameCache;
+    private treeExistsCache;
     private fileTheirsAccumulator;
     constructor(git: GitClient, lockManager: LockfileManager, outputDir: string);
     /** Reset inter-patch accumulator for a new cycle. */
@@ -206,6 +210,7 @@ declare class ReplayApplicator {
     private applyPatchWithFallback;
     private applyWithThreeWayMerge;
     private mergeFile;
+    private isTreeReachable;
     private isExcluded;
     private resolveFilePath;
     private applyPatchToContent;
@@ -426,18 +431,43 @@ declare function bootstrap(outputDir: string, options?: BootstrapOptions): Promi
 interface ForgetOptions {
     /** Don't actually remove, just show what would be removed */
     dryRun?: boolean;
+    /** Remove all tracked patches (keep lockfile and generation history) */
+    all?: boolean;
+    /** Specific patch IDs to remove */
+    patchIds?: string[];
+    /** Search pattern: file path, glob, or commit message substring */
+    pattern?: string;
+}
+interface DiffStat {
+    additions: number;
+    deletions: number;
+}
+interface MatchedPatch {
+    id: string;
+    message: string;
+    files: string[];
+    diffstat: DiffStat;
+    status?: "unresolved" | "resolving";
 }
 interface ForgetResult {
-    /** Patches that were (or would be) removed */
-    removed: Array<{
-        id: string;
-        message: string;
-        files: string[];
-    }>;
-    /** True if no patches matched the pattern */
+    /** Whether replay is initialized (lockfile exists) */
+    initialized: boolean;
+    /** Patches that were (or would be in dry-run) removed */
+    removed: MatchedPatch[];
+    /** Number of patches remaining after removal */
+    remaining: number;
+    /** True if a search/pattern was given but nothing matched */
     notFound: boolean;
+    /** Patch IDs that were specified but don't exist (idempotent mode) */
+    alreadyForgotten: string[];
+    /** Total patches before removal */
+    totalPatches: number;
+    /** Warnings (e.g., forgetting patches with conflict markers on disk) */
+    warnings: string[];
+    /** Matching patches for interactive selection (search/no-arg mode only) */
+    matched?: MatchedPatch[];
 }
-declare function forget(outputDir: string, filePattern: string, options?: ForgetOptions): ForgetResult;
+declare function forget(outputDir: string, options?: ForgetOptions): ForgetResult;
 
 interface ResetOptions {
     /** Don't actually delete, just show what would happen */
@@ -480,27 +510,45 @@ declare function resolve(outputDir: string, options?: ResolveOptions): Promise<R
 interface StatusResult {
     /** Whether replay is initialized (lockfile exists) */
     initialized: boolean;
-    /** Tracked customization patches */
-    patches: StatusPatch[];
+    /** Total number of generations tracked */
+    generationCount: number;
     /** Last generation info, if available */
     lastGeneration: StatusGeneration | undefined;
+    /** Tracked customization patches */
+    patches: StatusPatch[];
+    /** Count of patches with "unresolved" or "resolving" status */
+    unresolvedCount: number;
+    /** Exclude patterns from replay.yml */
+    excludePatterns: string[];
 }
 interface StatusPatch {
-    /** Short SHA of the original commit */
-    sha: string;
-    /** Author name (without email) */
-    author: string;
+    /** Patch ID (e.g. "patch-def45678") */
+    id: string;
+    /** "added" if patch_content contains "new file mode", otherwise "modified" */
+    type: "added" | "modified";
     /** Original commit message */
     message: string;
+    /** Author name (without email) */
+    author: string;
+    /** Short SHA of the original commit (7 chars) */
+    sha: string;
     /** Files touched by this patch */
     files: string[];
+    /** Number of files */
+    fileCount: number;
+    /** Patch resolution status, if any */
+    status?: "unresolved" | "resolving";
 }
 interface StatusGeneration {
-    /** Full commit SHA */
+    /** Short commit SHA (7 chars) */
     sha: string;
     /** Generation timestamp */
     timestamp: string;
+    /** CLI version used for generation */
+    cliVersion: string;
+    /** Generator versions (e.g. { "fern-java-sdk": "3.35.0" }) */
+    generatorVersions: Record<string, string>;
 }
 declare function status(outputDir: string): StatusResult;
 
-export { type BootstrapOptions, type BootstrapResult, type CommitInfo, type CommitOptions, type ConflictDetail, type ConflictMetadata, type ConflictReason, type ConflictRegion, type CustomizationsConfig, type DetectionResult, FERN_BOT_EMAIL, FERN_BOT_LOGIN, FERN_BOT_NAME, FernignoreMigrator, type FileResult, type ForgetOptions, type ForgetResult, type GenerationLock, type GenerationRecord, GitClient, LockfileManager, type MergeResult, type MigrationAnalysis, type MigrationResult, type MoveDeclaration, ReplayApplicator, ReplayCommitter, type ReplayConfig, ReplayDetector, type ReplayOptions, type ReplayReport, type ReplayResult, ReplayService, type ResetOptions, type ResetResult, type ResolveOptions, type ResolveResult, type StatusGeneration, type StatusPatch, type StatusResult, type StoredPatch, type UnresolvedPatchInfo, bootstrap, forget, isGenerationCommit, isReplayCommit, isRevertCommit, parseRevertedMessage, parseRevertedSha, reset, resolve, status, threeWayMerge };
+export { type BootstrapOptions, type BootstrapResult, type CommitInfo, type CommitOptions, type ConflictDetail, type ConflictMetadata, type ConflictReason, type ConflictRegion, type CustomizationsConfig, type DetectionResult, type DiffStat, FERN_BOT_EMAIL, FERN_BOT_LOGIN, FERN_BOT_NAME, FernignoreMigrator, type FileResult, type ForgetOptions, type ForgetResult, type GenerationLock, type GenerationRecord, GitClient, LockfileManager, type MatchedPatch, type MergeResult, type MigrationAnalysis, type MigrationResult, type MoveDeclaration, ReplayApplicator, ReplayCommitter, type ReplayConfig, ReplayDetector, type ReplayOptions, type ReplayReport, type ReplayResult, ReplayService, type ResetOptions, type ResetResult, type ResolveOptions, type ResolveResult, type StatusGeneration, type StatusPatch, type StatusResult, type StoredPatch, type UnresolvedPatchInfo, bootstrap, forget, isGenerationCommit, isReplayCommit, isRevertCommit, parseRevertedMessage, parseRevertedSha, reset, resolve, status, threeWayMerge };