@claudexor/journal 3.11.0 → 3.12.1

package/dist/journal-core.d.ts

@@ -0,0 +1,96 @@
+import { type JournalRecord } from "./frame-codec.js";
+import type { JournalCompactionOutcome, JournalCompactionResult } from "./journal-compaction.js";
+import type { JournalFold } from "./journal-fold.js";
+import { type JournalRecoveryState } from "./journal-recovery-state.js";
+import type { JournalPreparationReceipt } from "./read-only-preparation.js";
+export interface DurableJournalOptions {
+    rootDir: string;
+    partition: string;
+    now?: () => Date;
+    epochFactory?: () => string;
+    appendAndSync?: (fd: number, bytes: Buffer) => void;
+    /** Growth since the last completed maintenance pass that arms a crossing:
+     * the file bytes appended after the last background pass that reached the
+     * data (an install, a real decline or a failed pass), never the absolute
+     * file size, so a partition whose retained set alone exceeds the threshold
+     * is compacted once per threshold of new bytes rather than on every append.
+     * Under a fold the
+     * replay at open is the first completed pass: the baseline starts at the
+     * file size minus what the fold retired while replaying, so a restart on an
+     * already-compacted partition waits for a threshold of new bytes while a
+     * legacy partition whose replay retires a threshold's worth fires at once.
+     * Without a fold the baseline starts at zero and the inline open-time
+     * compaction keeps its absolute-size trigger. */
+    compactionThresholdBytes?: number;
+    /** The daemon opts into after-admission maintenance; standalone callers keep inline compaction. */
+    deferCompaction?: boolean;
+    /** Applied at replay and at background compaction; the retained set is what
+     * `records()` sees while epoch/seq/chain state always follow the disk. */
+    fold?: JournalFold;
+    /** Fired at most once per threshold crossing after an append — a crossing
+     * being `compactionThresholdBytes` of growth since the last completed pass —
+     * and re-armed when a maintenance pass completes (install, typed decline or
+     * a failed pass), so a daemon that dedupes in-flight requests sees every
+     * new crossing and a
+     * file that stays large never re-fires on every append. Never fires after
+     * `close()`. No timers, no persisted state. */
+    onCompactionThreshold?: () => void;
+}
+/** Writer state, recovery and physical installation shared by the public
+ * `DurableJournal` surface. Not exported from the package entry. */
+export declare abstract class JournalCore {
+    readonly options: Readonly<DurableJournalOptions>;
+    readonly partitionDir: string;
+    readonly path: string;
+    protected readonly now: () => Date;
+    protected readonly appendFrame: (fd: number, bytes: Buffer) => void;
+    protected fd: number;
+    protected entries: JournalRecord[];
+    protected background: {
+        controller: AbortController;
+        promise: Promise<JournalCompactionOutcome>;
+    } | null;
+    protected epoch: string;
+    protected nextSeq: number;
+    protected previousFrameHash: string;
+    protected knownFileBytes: number;
+    protected recovery: JournalRecoveryState;
+    protected preparationState: JournalPreparationReceipt | null;
+    protected writable: boolean;
+    protected closed: boolean;
+    protected thresholdNotified: boolean;
+    /** File size at the last completed pass over the data: a folded replay
+     * sets it to the size minus what it retired (0 without a fold), an install
+     * to the installed size, and any other settled background pass — a real
+     * decline or a failure — to the size it settled at. `atCompactionThreshold`
+     * measures growth from it. */
+    protected compactionBaselineBytes: number;
+    protected replayRetired: {
+        count: number;
+        bytes: number;
+    };
+    protected constructor(options: DurableJournalOptions);
+    /** Growth-since-last-pass edge: true once the file grew by the threshold
+     * beyond the size the last completed pass left (or observed). */
+    atCompactionThreshold(): boolean;
+    /** Replay the file into the retained set and disk chain state. Returns the
+     * pending-suffix bytes recovery discarded; the caller journals that fact. */
+    protected recover(): number;
+    /** A folded replay is a completed pass: what it retired is the growth still
+     * to reclaim (the retired bytes are logical sizes, so the result is clamped
+     * at zero). Without a fold nothing was evaluated and the baseline stays 0. */
+    protected replayBaselineBytes(): number;
+    protected intentPath(): string;
+    protected openWriter(): void;
+    /** One physical install owner for both producers; no serialization or await. */
+    protected installCompaction(result: JournalCompactionResult): void;
+    protected closeWriter(): void;
+    protected failPreparedActivation(error: unknown): never;
+    protected requireRecovery(byteOffset: number, reason: string): Extract<JournalRecoveryState, {
+        status: "recovery_required";
+    }>;
+    protected assertReadable(): void;
+    protected assertWritable(): void;
+    protected assertOpen(): void;
+}
+//# sourceMappingURL=journal-core.d.ts.map

package/dist/journal-core.d.ts.map

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

package/dist/journal-core.js

@@ -0,0 +1,173 @@
+import { closeSync, fstatSync, renameSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fsyncDirectory } from "@claudexor/util";
+import { ZERO_HASH } from "./frame-codec.js";
+import { appendAndSync, openJournalWriter, reopenOriginalWriter } from "./journal-files.js";
+import { journalPartitionDirectory } from "./journal-partition.js";
+import { recoverJournal } from "./journal-recovery.js";
+import { JournalRecoveryRequiredError, journalRecoveryAt, } from "./journal-recovery-state.js";
+const DEFAULT_COMPACTION_THRESHOLD_BYTES = 8 * 1024 * 1024;
+/** Writer state, recovery and physical installation shared by the public
+ * `DurableJournal` surface. Not exported from the package entry. */
+export class JournalCore {
+    options;
+    partitionDir;
+    path;
+    now;
+    appendFrame;
+    fd = -1;
+    entries = [];
+    background = null;
+    epoch = "";
+    nextSeq = 1;
+    previousFrameHash = ZERO_HASH;
+    knownFileBytes = 0;
+    recovery = { status: "ready", discardedTailBytes: 0 };
+    preparationState = null;
+    writable = false;
+    closed = false;
+    thresholdNotified = false;
+    /** File size at the last completed pass over the data: a folded replay
+     * sets it to the size minus what it retired (0 without a fold), an install
+     * to the installed size, and any other settled background pass — a real
+     * decline or a failure — to the size it settled at. `atCompactionThreshold`
+     * measures growth from it. */
+    compactionBaselineBytes = 0;
+    replayRetired = { count: 0, bytes: 0 };
+    constructor(options) {
+        if (!options.partition.trim())
+            throw new Error("journal partition must not be empty");
+        this.options = Object.freeze({ ...options });
+        this.now = options.now ?? (() => new Date());
+        this.appendFrame = options.appendAndSync ?? appendAndSync;
+        this.partitionDir = journalPartitionDirectory(options.rootDir, options.partition);
+        this.path = join(this.partitionDir, "journal.bin");
+    }
+    /** Growth-since-last-pass edge: true once the file grew by the threshold
+     * beyond the size the last completed pass left (or observed). */
+    atCompactionThreshold() {
+        return (this.knownFileBytes - this.compactionBaselineBytes >=
+            (this.options.compactionThresholdBytes ?? DEFAULT_COMPACTION_THRESHOLD_BYTES));
+    }
+    /** Replay the file into the retained set and disk chain state. Returns the
+     * pending-suffix bytes recovery discarded; the caller journals that fact. */
+    recover() {
+        let result;
+        try {
+            result = recoverJournal(this.fd, this.path, this.options, this.intentPath());
+        }
+        catch (error) {
+            if (!(error instanceof JournalRecoveryRequiredError))
+                throw error;
+            this.recovery = error.recovery;
+            return 0;
+        }
+        this.entries = result.retained;
+        this.replayRetired = { count: result.retiredCount, bytes: result.retiredBytes };
+        this.epoch = result.epoch ?? this.epoch;
+        this.nextSeq = result.nextSeq;
+        this.previousFrameHash = result.previousFrameHash;
+        this.knownFileBytes = result.knownFileBytes;
+        this.compactionBaselineBytes = this.replayBaselineBytes();
+        if (result.discardedBytes > 0)
+            this.recovery = { status: "ready", discardedTailBytes: result.discardedBytes };
+        return result.discardedBytes;
+    }
+    /** A folded replay is a completed pass: what it retired is the growth still
+     * to reclaim (the retired bytes are logical sizes, so the result is clamped
+     * at zero). Without a fold nothing was evaluated and the baseline stays 0. */
+    replayBaselineBytes() {
+        if (!this.options.fold)
+            return 0;
+        return Math.max(0, this.knownFileBytes - this.replayRetired.bytes);
+    }
+    intentPath() {
+        return join(this.partitionDir, "append.pending.json");
+    }
+    openWriter() {
+        this.fd = openJournalWriter(this.path);
+        this.writable = true;
+    }
+    /** One physical install owner for both producers; no serialization or await. */
+    installCompaction(result) {
+        const original = fstatSync(this.fd);
+        if (result.knownFileBytes >= this.knownFileBytes)
+            throw new Error("compaction did not reclaim bytes");
+        let renamed = false;
+        let closed = false;
+        const fd = this.fd;
+        this.fd = -1;
+        this.writable = false;
+        try {
+            closeSync(fd);
+            closed = true;
+            renameSync(result.path, this.path);
+            renamed = true;
+            fsyncDirectory(dirname(this.path));
+            this.openWriter();
+        }
+        catch (error) {
+            this.closeWriter();
+            if (closed && !renamed) {
+                this.fd = reopenOriginalWriter(this.path, original);
+                this.writable = this.fd >= 0;
+            }
+            if (!this.writable)
+                throw new JournalRecoveryRequiredError(this.requireRecovery(0, `journal compaction install failed: ${error instanceof Error ? error.message : String(error)}`));
+            throw error;
+        }
+        this.entries = result.records;
+        this.epoch = result.epoch;
+        this.nextSeq = result.nextSeq;
+        this.previousFrameHash = result.previousFrameHash;
+        this.knownFileBytes = result.knownFileBytes;
+        this.compactionBaselineBytes = result.knownFileBytes;
+        this.thresholdNotified = false;
+    }
+    closeWriter() {
+        const fd = this.fd;
+        this.fd = -1;
+        this.writable = false;
+        if (fd < 0)
+            return;
+        try {
+            closeSync(fd);
+        }
+        catch {
+            /* best-effort revocation: the handle number is never reused by this writer */
+        }
+    }
+    failPreparedActivation(error) {
+        this.closeWriter();
+        this.entries.length = 0;
+        this.nextSeq = 1;
+        this.previousFrameHash = ZERO_HASH;
+        this.knownFileBytes = 0;
+        this.compactionBaselineBytes = 0;
+        const recovery = error instanceof JournalRecoveryRequiredError
+            ? error.recovery
+            : this.requireRecovery(0, `prepared activation failed: ${error instanceof Error ? error.message : String(error)}`);
+        this.recovery = structuredClone(recovery);
+        throw new JournalRecoveryRequiredError(recovery);
+    }
+    requireRecovery(byteOffset, reason) {
+        this.recovery = journalRecoveryAt(byteOffset, reason);
+        this.background?.controller.abort();
+        return this.recovery;
+    }
+    assertReadable() {
+        this.assertOpen();
+        if (this.recovery.status === "recovery_required") {
+            throw new JournalRecoveryRequiredError(this.recovery);
+        }
+    }
+    assertWritable() {
+        if (!this.writable)
+            throw new Error("journal preparation is not activated");
+    }
+    assertOpen() {
+        if (this.closed)
+            throw new Error("journal writer is closed");
+    }
+}
+//# sourceMappingURL=journal-core.js.map

package/dist/journal-core.js.map

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

package/dist/journal-files.d.ts

@@ -13,7 +13,6 @@ export declare function appendAndSync(fd: number, bytes: Buffer): void;
  * lack FILE_WRITE_DATA, required by NtSetInformationFile's EOF operation. */
 export declare function truncatePendingSuffix(fd: number, path: string, offset: number, bytes: number): void;
 export declare function ensurePrivateFile(path: string): void;
-export declare function readDescriptor(fd: number): Buffer;
 export declare function readIntent(path: string): AppendIntent | null;
 export declare function writeIntent(path: string, value: AppendIntent): void;
 export declare function removeFile(path: string): void;

package/dist/journal-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal-files.d.ts","sourceRoot":"","sources":["../src/journal-files.ts"],"names":[],"mappings":"AACA,OAAO,EAcL,KAAK,KAAK,EACX,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,SAAgB,GAAG,OAAO,CAQ9F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CActD;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,CAW1E;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;6EAC6E;AAC7E,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CA6BN;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcpD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqB5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAanE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7C"}
+{"version":3,"file":"journal-files.d.ts","sourceRoot":"","sources":["../src/journal-files.ts"],"names":[],"mappings":"AACA,OAAO,EAcL,KAAK,KAAK,EACX,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,SAAgB,GAAG,OAAO,CAQ9F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CActD;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,CAW1E;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;6EAC6E;AAC7E,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CA6BN;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqB5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAanE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7C"}

package/dist/journal-files.js

@@ -94,15 +94,6 @@ export function ensurePrivateFile(path) {
         throw new Error("journal path is not a private regular file");
     }
 }
-export function readDescriptor(fd) {
-    const size = Number(fstatSync(fd, { bigint: true }).size);
-    if (!Number.isSafeInteger(size) || size < 0)
-        throw new Error("journal file size is invalid");
-    const bytes = readFileSync(fd);
-    if (bytes.length !== size)
-        throw new Error("journal changed while being read");
-    return bytes;
-}
 export function readIntent(path) {
     if (!existsSync(path))
         return null;

package/dist/journal-files.js.map

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

package/dist/journal-fold.d.ts

@@ -0,0 +1,47 @@
+/** One logical journal record as the fold sees it: an ordinary frame or one
+ * record inside a compacted snapshot. `byteLength` is the record's serialized
+ * logical size in bytes as stored in its source (informational: it feeds the
+ * retired-bytes receipt, never a decision). */
+export interface FoldRecord {
+    seq: number;
+    type: string;
+    time: string;
+    payload: unknown;
+    byteLength: number;
+}
+/** Default (undefined / empty object) = keep. Deterministic. Called once per
+ * logical record in seq order, for ordinary frames and for records inside
+ * compacted snapshots alike. */
+export interface FoldVerdict {
+    /** Do not retain this record (retire/slot/group still apply). */
+    drop?: boolean;
+    /** Single-holder key: a later record with the same slot drops the earlier holder. */
+    slot?: string;
+    /** Multi-holder key: registered, never auto-superseded. */
+    group?: string;
+    /** Drop every retained record currently registered under these slot/group
+     * names (applied BEFORE registering this record). */
+    retire?: readonly string[];
+}
+/** The policy is supplied by the caller (the daemon); the journal stays generic
+ * and never decides WHAT is dead. */
+export interface JournalFold {
+    verdict(record: FoldRecord): FoldVerdict;
+}
+/** Identity fold: every record is retained. */
+export declare const keepEverything: JournalFold;
+export interface FoldResult<T> {
+    retained: T[];
+    retiredCount: number;
+    retiredBytes: number;
+}
+/** Streaming fold engine. Records are pushed in seq order; a record dropped by
+ * a later verdict leaves no reference behind (tombstones are Map deletions), so
+ * memory is proportional to the retained set plus live slot/group names, never
+ * to the number of records seen. */
+export interface FoldStream<T> {
+    push(record: T, view: FoldRecord): void;
+    finish(): FoldResult<T>;
+}
+export declare function foldStream<T>(fold?: JournalFold): FoldStream<T>;
+//# sourceMappingURL=journal-fold.d.ts.map

package/dist/journal-fold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-fold.d.ts","sourceRoot":"","sources":["../src/journal-fold.ts"],"names":[],"mappings":"AAAA;;;+CAG+C;AAC/C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;gCAEgC;AAChC,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;yDACqD;IACrD,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED;qCACqC;AACrC,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;CAC1C;AAED,+CAA+C;AAC/C,eAAO,MAAM,cAAc,EAAE,WAAoD,CAAC;AAElF,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;oCAGoC;AACpC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;CACzB;AASD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAE,WAA4B,GAAG,UAAU,CAAC,CAAC,CAAC,CAoE/E"}

package/dist/journal-fold.js

@@ -0,0 +1,81 @@
+/** Identity fold: every record is retained. */
+export const keepEverything = Object.freeze({ verdict: () => ({}) });
+export function foldStream(fold = keepEverything) {
+    // Insertion order is seq order; deletions never reorder the survivors.
+    const held = new Map();
+    const slots = new Map();
+    const groups = new Map();
+    let nextId = 0;
+    let retiredCount = 0;
+    let retiredBytes = 0;
+    let finished = false;
+    const drop = (id) => {
+        const entry = held.get(id);
+        if (!entry)
+            return;
+        held.delete(id);
+        retiredCount += 1;
+        retiredBytes += entry.bytes;
+        if (entry.slot !== undefined && slots.get(entry.slot) === id)
+            slots.delete(entry.slot);
+        if (entry.group !== undefined) {
+            const members = groups.get(entry.group);
+            members?.delete(id);
+            if (members && members.size === 0)
+                groups.delete(entry.group);
+        }
+    };
+    const retire = (name) => {
+        const holder = slots.get(name);
+        if (holder !== undefined)
+            drop(holder);
+        const members = groups.get(name);
+        if (members)
+            for (const id of [...members])
+                drop(id);
+    };
+    return {
+        push(record, view) {
+            if (finished)
+                throw new Error("journal fold stream is finished");
+            const verdict = fold.verdict(view) ?? {};
+            if (verdict.retire)
+                for (const name of verdict.retire)
+                    retire(name);
+            if (verdict.slot !== undefined) {
+                const holder = slots.get(verdict.slot);
+                if (holder !== undefined)
+                    drop(holder);
+            }
+            if (verdict.drop) {
+                retiredCount += 1;
+                retiredBytes += view.byteLength;
+                return;
+            }
+            const id = nextId;
+            nextId += 1;
+            held.set(id, { record, bytes: view.byteLength, slot: verdict.slot, group: verdict.group });
+            if (verdict.slot !== undefined)
+                slots.set(verdict.slot, id);
+            if (verdict.group !== undefined) {
+                let members = groups.get(verdict.group);
+                if (!members) {
+                    members = new Set();
+                    groups.set(verdict.group, members);
+                }
+                members.add(id);
+            }
+        },
+        finish() {
+            finished = true;
+            const retained = [];
+            for (const entry of held.values())
+                retained.push(entry.record);
+            held.clear();
+            slots.clear();
+            groups.clear();
+            return { retained, retiredCount, retiredBytes };
+        },
+    };
+}
+//# sourceMappingURL=journal-fold.js.map

package/dist/journal-fold.js.map

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

package/dist/journal-recovery.d.ts

@@ -1,9 +1,21 @@
-import { type JournalRecord } from "./frame-codec.js";
-/** Recover only the original canonical file. A compaction candidate is never
- * consulted as recovery authority. Returns decoded ACK history for its writer. */
-export declare function recoverJournal(fd: number, path: string, partition: string, intentPath: string): {
-    records: JournalRecord[];
+import { type FrameReadResult } from "./frame-reader.js";
+import type { JournalFold } from "./journal-fold.js";
+export interface RecoveredJournal {
+    retained: FrameReadResult["retained"];
+    epoch: string | null;
+    nextSeq: number;
+    previousFrameHash: string;
     knownFileBytes: number;
     discardedBytes: number;
-};
+    retiredCount: number;
+    retiredBytes: number;
+}
+/** Recover only the original canonical file. A compaction candidate is never
+ * consulted as recovery authority. Returns the retained ACK history for its
+ * writer plus the chain state of the last frame on disk. A positional-read
+ * failure propagates with its own message; only intent handling is labelled. */
+export declare function recoverJournal(fd: number, path: string, options: {
+    partition: string;
+    fold?: JournalFold;
+}, intentPath: string): RecoveredJournal;
 //# sourceMappingURL=journal-recovery.d.ts.map

package/dist/journal-recovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal-recovery.d.ts","sourceRoot":"","sources":["../src/journal-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIpE;kFACkF;AAClF,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IACD,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CA+BA"}
+{"version":3,"file":"journal-recovery.d.ts","sourceRoot":"","sources":["../src/journal-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;gFAGgF;AAChF,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE,EAClD,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA8BlB"}

package/dist/journal-recovery.js

@@ -1,40 +1,56 @@
-import { replayFrames } from "./frame-codec.js";
-import { readDescriptor, readIntent, removeFile, truncatePendingSuffix } from "./journal-files.js";
+import { descriptorSize, readFrames } from "./frame-reader.js";
+import { readIntent, removeFile, truncatePendingSuffix, } from "./journal-files.js";
 import { JournalRecoveryRequiredError, journalRecoveryAt } from "./journal-recovery-state.js";
 /** Recover only the original canonical file. A compaction candidate is never
- * consulted as recovery authority. Returns decoded ACK history for its writer. */
-export function recoverJournal(fd, path, partition, intentPath) {
-    let bytes = readDescriptor(fd);
-    let discardedBytes = 0;
+ * consulted as recovery authority. Returns the retained ACK history for its
+ * writer plus the chain state of the last frame on disk. A positional-read
+ * failure propagates with its own message; only intent handling is labelled. */
+export function recoverJournal(fd, path, options, intentPath) {
+    const size = descriptorSize(fd);
+    let intent;
     try {
-        const intent = readIntent(intentPath);
-        if (intent) {
-            const prefix = replayFrames(bytes.subarray(0, intent.offset), partition);
-            if (intent.offset > bytes.length ||
-                bytes.length > intent.offset + intent.length ||
-                prefix.error ||
-                prefix.incompleteOffset !== null) {
-                throw required(intent.offset, "append intent does not match the journal prefix");
-            }
-            discardedBytes = bytes.length - intent.offset;
-            if (discardedBytes > 0) {
-                truncatePendingSuffix(fd, path, intent.offset, bytes.length);
-                bytes = bytes.subarray(0, intent.offset);
-            }
-            removeFile(intentPath);
-        }
+        intent = readIntent(intentPath);
     }
     catch (error) {
-        if (error instanceof JournalRecoveryRequiredError)
-            throw error;
         throw required(0, `append intent is malformed: ${String(error)}`);
     }
-    const decoded = replayFrames(bytes, partition);
-    if (decoded.incompleteOffset !== null)
-        throw required(decoded.incompleteOffset, "unexplained suffix without append intent");
-    if (decoded.error)
-        throw required(decoded.error.offset, decoded.error.reason);
-    return { records: decoded.records, knownFileBytes: bytes.length, discardedBytes };
+    if (!intent) {
+        const decoded = readFrames(fd, options.partition, { fold: options.fold });
+        if (decoded.incompleteOffset !== null)
+            throw required(decoded.incompleteOffset, "unexplained suffix without append intent");
+        if (decoded.error)
+            throw required(decoded.error.offset, decoded.error.reason);
+        return recovered(decoded, size, 0);
+    }
+    if (intent.offset > size || size > intent.offset + intent.length) {
+        throw required(intent.offset, "append intent does not match the journal prefix");
+    }
+    const decoded = readFrames(fd, options.partition, { limit: intent.offset, fold: options.fold });
+    if (decoded.error || decoded.incompleteOffset !== null) {
+        throw required(intent.offset, "append intent does not match the journal prefix");
+    }
+    const discardedBytes = size - intent.offset;
+    try {
+        if (discardedBytes > 0)
+            truncatePendingSuffix(fd, path, intent.offset, size);
+        removeFile(intentPath);
+    }
+    catch (error) {
+        throw required(intent.offset, `append intent recovery failed: ${String(error)}`);
+    }
+    return recovered(decoded, intent.offset, discardedBytes);
+}
+function recovered(decoded, knownFileBytes, discardedBytes) {
+    return {
+        retained: decoded.retained,
+        epoch: decoded.epoch,
+        nextSeq: decoded.nextSeq,
+        previousFrameHash: decoded.previousFrameHash,
+        knownFileBytes,
+        discardedBytes,
+        retiredCount: decoded.retiredCount,
+        retiredBytes: decoded.retiredBytes,
+    };
 }
 function required(byteOffset, reason) {
     return new JournalRecoveryRequiredError(journalRecoveryAt(byteOffset, reason));

package/dist/journal-recovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal-recovery.js","sourceRoot":"","sources":["../src/journal-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE9F;kFACkF;AAClF,MAAM,UAAU,cAAc,CAC5B,EAAU,EACV,IAAY,EACZ,SAAiB,EACjB,UAAkB;IAMlB,IAAI,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;YACzE,IACE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;gBAC5B,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;gBAC5C,MAAM,CAAC,KAAK;gBACZ,MAAM,CAAC,gBAAgB,KAAK,IAAI,EAChC,CAAC;gBACD,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iDAAiD,CAAC,CAAC;YACnF,CAAC;YACD,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9C,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;gBACvB,qBAAqB,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC7D,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YACD,UAAU,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,4BAA4B;YAAE,MAAM,KAAK,CAAC;QAC/D,MAAM,QAAQ,CAAC,CAAC,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;QACnC,MAAM,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,0CAA0C,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,QAAQ,CAAC,UAAkB,EAAE,MAAc;IAClD,OAAO,IAAI,4BAA4B,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"journal-recovery.js","sourceRoot":"","sources":["../src/journal-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAwB,MAAM,mBAAmB,CAAC;AACrF,OAAO,EACL,UAAU,EACV,UAAU,EACV,qBAAqB,GAEtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAa9F;;;gFAGgF;AAChF,MAAM,UAAU,cAAc,CAC5B,EAAU,EACV,IAAY,EACZ,OAAkD,EAClD,UAAkB;IAElB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,MAA2B,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,CAAC,CAAC,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;YACnC,MAAM,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,0CAA0C,CAAC,CAAC;QACvF,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9E,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACjE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iDAAiD,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChG,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iDAAiD,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,cAAc,GAAG,CAAC;YAAE,qBAAqB,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7E,UAAU,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAChB,OAAwB,EACxB,cAAsB,EACtB,cAAsB;IAEtB,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,cAAc;QACd,cAAc;QACd,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,UAAkB,EAAE,MAAc;IAClD,OAAO,IAAI,4BAA4B,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AACjF,CAAC"}