@indigoai-us/hq-cloud 6.18.44-alpha.48 → 6.18.44-alpha.49

package/dist/journal-baseline.test.js

@@ -0,0 +1,218 @@
+/**
+ * The write baseline is a fingerprint per row, not a copy of the journal.
+ *
+ * `readJournal` used to remember a `structuredClone` of the whole aggregate so
+ * that `writeJournal` could diff the caller's mutations against it. On the
+ * desktop scope (677k rows) that clone was a second ~950 MB copy of the
+ * journal for every reader that might write. The baseline is now a map from
+ * path to a 53-bit fingerprint of the row's canonical form: the delta a
+ * checkpoint publishes is identical, the retained cost is a number per row,
+ * and the path strings are the aggregate's own keys.
+ *
+ * The property that matters is parity. A row left out of a delta is asserted
+ * unchanged, so a fingerprint that misses a change loses data silently. The
+ * tests below therefore compare the emitted delta against a plain-object diff
+ * over hundreds of random mutation sequences, not against a hand-picked case.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { journalDeltaForTest, readJournal, writeJournal, } from "./journal.js";
+function entry(index, over = {}) {
+    return {
+        hash: index.toString(16).padStart(64, "0"),
+        size: index,
+        syncedAt: "2026-09-01T00:00:00.000Z",
+        direction: index % 2 === 0 ? "up" : "down",
+        remoteEtag: index.toString(16).padStart(32, "f"),
+        kind: "file",
+        mtimeMs: 1_700_000_000_000 + index,
+        ctimeMs: 1_700_000_000_000 + index,
+        ...over,
+    };
+}
+function seeded(count) {
+    const files = {};
+    for (let i = 0; i < count; i++)
+        files[`notes/${i}.md`] = entry(i);
+    return { version: "2", lastSync: "t0", files, pulls: [] };
+}
+/** Value equality over the union of own keys — the diff `writeJournal` promises. */
+function sameEntry(a, b) {
+    const keys = Object.keys(a);
+    if (keys.length !== Object.keys(b).length)
+        return false;
+    return keys.every((key) => {
+        const left = a[key];
+        const right = b[key];
+        if (left === right)
+            return true;
+        if (typeof left === "object" && left !== null && typeof right === "object" && right !== null) {
+            return JSON.stringify(left) === JSON.stringify(right);
+        }
+        return false;
+    });
+}
+/** Reference delta computed from a real copy of the pre-mutation journal. */
+function referenceDelta(previous, next) {
+    const upserts = {};
+    for (const [key, row] of Object.entries(next.files)) {
+        const before = previous.files[key];
+        if (before !== undefined && sameEntry(before, row))
+            continue;
+        upserts[key] = row;
+    }
+    const deletes = Object.keys(previous.files).filter((key) => !Object.hasOwn(next.files, key));
+    return { upserts, deletes: deletes.sort() };
+}
+/** Deterministic PRNG so a failing sequence can be replayed from its seed. */
+function rng(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let t = state;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** Same fields as `row`, own keys in reverse insertion order. */
+function reordered(row) {
+    const out = {};
+    for (const key of Object.keys(row).reverse())
+        out[key] = row[key];
+    return out;
+}
+describe("journal write baseline", () => {
+    let stateDir;
+    beforeEach(() => {
+        stateDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-journal-baseline-"));
+        process.env.HQ_STATE_DIR = stateDir;
+    });
+    afterEach(() => {
+        delete process.env.HQ_STATE_DIR;
+        fs.rmSync(stateDir, { recursive: true, force: true });
+    });
+    it("readJournal does not clone the aggregate to remember its baseline", () => {
+        writeJournal("acme", seeded(2_000));
+        const clone = vi.spyOn(globalThis, "structuredClone");
+        try {
+            const journal = readJournal("acme");
+            expect(Object.keys(journal.files)).toHaveLength(2_000);
+            for (const [value] of clone.mock.calls) {
+                if (typeof value !== "object" || value === null)
+                    continue;
+                const object = value;
+                expect(Object.keys(object.files ?? object.journal?.files ?? {}).length).toBeLessThan(2_000);
+            }
+        }
+        finally {
+            clone.mockRestore();
+        }
+    });
+    it("rejects a row mutated in place after the read", () => {
+        writeJournal("acme", seeded(10));
+        const journal = readJournal("acme");
+        expect(() => { journal.files["notes/3.md"].hash = "b".repeat(64); }).toThrow(TypeError);
+        delete journal.files["notes/7.md"];
+        journal.files["notes/10.md"] = entry(10);
+        const delta = journalDeltaForTest(journal);
+        expect(Object.keys(delta.upserts).sort()).toEqual(["notes/10.md"]);
+        expect(delta.deletes).toEqual(["notes/7.md"]);
+        writeJournal("acme", journal);
+        expect(readJournal("acme")).toEqual(journal);
+    });
+    it("a row rewritten with the same fields in another key order is not an upsert", () => {
+        writeJournal("acme", seeded(10));
+        const journal = readJournal("acme");
+        journal.files["notes/4.md"] = reordered(journal.files["notes/4.md"]);
+        const delta = journalDeltaForTest(journal);
+        expect(delta.upserts).toEqual({});
+        expect(delta.deletes).toEqual([]);
+    });
+    it("an optional field added, removed, or changed inside a nested object is an upsert", () => {
+        writeJournal("acme", seeded(4));
+        const intent = { version: 1, remoteEtag: "e".repeat(32), localHash: "1".repeat(64), localKind: "file" };
+        const journal = readJournal("acme");
+        journal.files["notes/0.md"] = { ...journal.files["notes/0.md"], localDiverges: true };
+        journal.files["notes/1.md"] = { ...journal.files["notes/1.md"], localDeleteIntent: intent };
+        const { remoteEtag: _remoteEtag, ...withoutRemoteEtag } = journal.files["notes/2.md"];
+        journal.files["notes/2.md"] = withoutRemoteEtag;
+        writeJournal("acme", journal);
+        const again = readJournal("acme");
+        again.files["notes/1.md"] = { ...again.files["notes/1.md"], localDeleteIntent: { ...intent, localHash: "2".repeat(64) } };
+        const delta = journalDeltaForTest(again);
+        expect(Object.keys(delta.upserts)).toEqual(["notes/1.md"]);
+        expect(readJournal("acme")).toEqual(journal);
+    });
+    it("a second checkpoint in the same pass publishes only the new mutations", () => {
+        writeJournal("acme", seeded(6));
+        const journal = readJournal("acme");
+        journal.files["notes/1.md"] = { ...journal.files["notes/1.md"], size: 1_001 };
+        writeJournal("acme", journal);
+        journal.files["notes/2.md"] = { ...journal.files["notes/2.md"], size: 1_002 };
+        const delta = journalDeltaForTest(journal);
+        expect(Object.keys(delta.upserts)).toEqual(["notes/2.md"]);
+        expect(delta.deletes).toEqual([]);
+        writeJournal("acme", journal);
+        expect(readJournal("acme")).toEqual(journal);
+    });
+    it("lastSync and pulls changes travel without any row change", () => {
+        writeJournal("acme", seeded(3));
+        const journal = readJournal("acme");
+        expect(journalDeltaForTest(journal).lastSync).toBeUndefined();
+        journal.lastSync = "t1";
+        journal.pulls = [{ companySlug: "acme", scope: "all", at: "2026-09-01T00:00:00.000Z" }];
+        const delta = journalDeltaForTest(journal);
+        expect(delta.lastSync).toBe("t1");
+        expect(delta.pulls).toEqual(journal.pulls);
+        expect(delta.upserts).toEqual({});
+    });
+    it("matches a plain-object diff over random mutation sequences", () => {
+        writeJournal("acme", seeded(120));
+        const kinds = ["modify", "delete", "add", "reorder", "nested", "optional"];
+        for (let seed = 1; seed <= 300; seed++) {
+            const random = rng(seed);
+            const journal = readJournal("acme");
+            const before = JSON.parse(JSON.stringify(journal));
+            const steps = 1 + Math.floor(random() * 12);
+            for (let step = 0; step < steps; step++) {
+                const keys = Object.keys(journal.files);
+                const key = keys[Math.floor(random() * keys.length)];
+                const kind = kinds[Math.floor(random() * kinds.length)];
+                const row = journal.files[key];
+                if (kind === "modify" && row)
+                    journal.files[key] = { ...row, hash: Math.floor(random() * 1e9).toString(16).padStart(64, "0") };
+                else if (kind === "delete")
+                    delete journal.files[key];
+                else if (kind === "add")
+                    journal.files[`notes/new-${seed}-${step}.md`] = entry(1_000 + step);
+                else if (kind === "reorder" && row)
+                    journal.files[key] = reordered(row);
+                else if (kind === "nested" && row) {
+                    journal.files[key] = { ...row, localDeleteIntent: { version: 1, remoteEtag: "e".repeat(32), localHash: Math.floor(random() * 1e9).toString(16).padStart(64, "0"), localKind: "file" } };
+                }
+                else if (kind === "optional" && row) {
+                    if (row.remoteEtag === undefined)
+                        journal.files[key] = { ...row, remoteEtag: "c".repeat(32) };
+                    else {
+                        const { remoteEtag: _remoteEtag, ...withoutRemoteEtag } = row;
+                        journal.files[key] = withoutRemoteEtag;
+                    }
+                }
+            }
+            const expected = referenceDelta(before, journal);
+            const actual = journalDeltaForTest(journal);
+            expect({ seed, upserts: actual.upserts, deletes: [...actual.deletes].sort() })
+                .toEqual({ seed, upserts: expected.upserts, deletes: expected.deletes });
+            // The parity check is the point; the durable round trip is sampled so
+            // the 300 seeds stay well inside the suite's per-test budget under load.
+            if (seed % 10 === 0) {
+                writeJournal("acme", journal);
+                expect(readJournal("acme")).toEqual(journal);
+            }
+        }
+    });
+});
+//# sourceMappingURL=journal-baseline.test.js.map

package/dist/journal-baseline.test.js.map

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

package/dist/journal-decode-window.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=journal-decode-window.test.d.ts.map

package/dist/journal-decode-window.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-decode-window.test.d.ts","sourceRoot":"","sources":["../src/journal-decode-window.test.ts"],"names":[],"mappings":""}

package/dist/journal-decode-window.test.js

@@ -0,0 +1,99 @@
+import { describe, expect, it } from "vitest";
+import { JOURNAL_CACHE_MAX_ROWS, JOURNAL_DECODE_WINDOW, dropJournalDecodeWindow, emitJournalCacheMetric, journalCacheMetric, journalFingerprintMatchesStat, noteJournalDecoded, resetJournalDecodeWindowForTest, } from "./journal-decode-window.js";
+import { JournalRowStore } from "./journal-row-store.js";
+function pathFor(index) {
+    return `tree/${index.toString().padStart(6, "0")}.md`;
+}
+function entry(index) {
+    return {
+        hash: index.toString(16).padStart(64, "0"),
+        size: 100 + index,
+        syncedAt: new Date(1_700_000_000_000 + index).toISOString(),
+        direction: index % 2 === 0 ? "up" : "down",
+        kind: "file",
+        mtimeMs: 1_700_000_000_000 + index,
+        ctimeMs: 1_700_000_000_001 + index,
+    };
+}
+describe("journal decode window constants", () => {
+    it("exports the 10k bound from one place", () => {
+        expect(JOURNAL_DECODE_WINDOW).toBe(10_000);
+        expect(JOURNAL_CACHE_MAX_ROWS).toBe(JOURNAL_DECODE_WINDOW);
+    });
+});
+describe("journal-cache metric", () => {
+    it("emits the stderr JSON shape with in-flight window fields", () => {
+        resetJournalDecodeWindowForTest();
+        noteJournalDecoded(7);
+        const lines = [];
+        emitJournalCacheMetric((line) => lines.push(line));
+        expect(lines).toHaveLength(1);
+        const payload = JSON.parse(lines[0]);
+        expect(payload).toMatchObject({
+            type: "journal-cache",
+            rowsInFlight: 7,
+            peakRowsInFlight: 7,
+            maxRows: JOURNAL_DECODE_WINDOW,
+        });
+        expect(typeof payload.heapUsedMb).toBe("number");
+        expect("rowsInMemory" in payload).toBe(false);
+        expect("hits" in payload).toBe(false);
+        expect("misses" in payload).toBe(false);
+        expect("purgeTo" in payload).toBe(false);
+        dropJournalDecodeWindow();
+        emitJournalCacheMetric((line) => lines.push(line));
+        const afterDrop = JSON.parse(lines[1]);
+        expect(afterDrop.rowsInFlight).toBe(0);
+        expect(afterDrop.peakRowsInFlight).toBe(7);
+    });
+});
+describe("packed store skip fingerprints", () => {
+    it("answers 50k stat-matching fingerprints without decoding rows", () => {
+        resetJournalDecodeWindowForTest();
+        const rowCount = 50_000;
+        const store = new JournalRowStore(rowCount, { trackChanges: false });
+        for (let index = 0; index < rowCount; index++)
+            store.set(pathFor(index), entry(index));
+        resetJournalDecodeWindowForTest();
+        let skipped = 0;
+        for (let index = 0; index < rowCount; index++) {
+            const fingerprint = store.statFingerprint(pathFor(index));
+            const matches = journalFingerprintMatchesStat(fingerprint, {
+                isFile: () => true,
+                size: 100 + index,
+                mtimeMs: 1_700_000_000_000 + index,
+                ctimeMs: 1_700_000_000_001 + index,
+            });
+            if (matches)
+                skipped += 1;
+        }
+        expect(skipped).toBe(rowCount);
+        expect(journalCacheMetric().peakRowsInFlight).toBe(0);
+        expect(journalCacheMetric().rowsInFlight).toBe(0);
+    }, 60_000);
+});
+describe("packed store bytes-per-row probe", () => {
+    it("records resident cost of an unpacked packed store", () => {
+        const gc = globalThis.gc;
+        gc?.();
+        const beforeUsage = process.memoryUsage();
+        const before = beforeUsage.heapUsed + beforeUsage.arrayBuffers;
+        const store = new JournalRowStore(50_000, { trackChanges: false });
+        for (let index = 0; index < 50_000; index++)
+            store.set(pathFor(index), entry(index));
+        gc?.();
+        const afterUsage = process.memoryUsage();
+        const after = afterUsage.heapUsed + afterUsage.arrayBuffers;
+        const bytesPerRow = (after - before) / 50_000;
+        console.log(JSON.stringify({
+            probe: "journal-row-store-packed",
+            rows: 50_000,
+            heapDeltaBytes: after - before,
+            bytesPerRow: Math.round(bytesPerRow),
+        }));
+        expect(store.size).toBe(50_000);
+        expect(Number.isFinite(bytesPerRow)).toBe(true);
+        store.clear();
+    });
+});
+//# sourceMappingURL=journal-decode-window.test.js.map

package/dist/journal-decode-window.test.js.map

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

package/dist/journal-delta-writes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=journal-delta-writes.test.d.ts.map

package/dist/journal-delta-writes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-delta-writes.test.d.ts","sourceRoot":"","sources":["../src/journal-delta-writes.test.ts"],"names":[],"mappings":""}

package/dist/journal-delta-writes.test.js

@@ -0,0 +1,159 @@
+/**
+ * Regression tests for the journal's write amplification.
+ *
+ * `writeJournal` used to do two full-file rewrites per update: a whole-state
+ * snapshot via `replaceState`, and a complete copy of the journal in the pre-v3
+ * JSON format. Measured on a live install, a vault tracking half a million
+ * files paid 178 MB for each of those, about three times a minute — roughly a
+ * gigabyte a minute to record edits worth a few hundred bytes.
+ *
+ * Both are gone. Updates now append a type-2 delta the store has always been
+ * able to read, and the JSON path holds a small locator instead of a copy.
+ *
+ * The property that matters most is the round trip. An entry left out of a
+ * delta is *asserted* to be unchanged, so a diff that is too lenient does not
+ * throw — it silently loses data. Every mutation shape below is therefore
+ * checked by reading the journal back and comparing it whole.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { writeJournal, readJournal, getJournalPath, listJournals } from "./journal.js";
+function entry(over = {}) {
+    return {
+        hash: "a".repeat(64),
+        size: 10,
+        syncedAt: "2026-01-01T00:00:00.000Z",
+        direction: "up",
+        ...over,
+    };
+}
+function journal(files, lastSync = "t0") {
+    return { version: "2", lastSync, files, pulls: [] };
+}
+/** Serialized size of the file at the legacy journal path. */
+function locatorBytes(slug) {
+    return fs.statSync(getJournalPath(slug)).size;
+}
+describe("journal delta writes", () => {
+    let stateDir;
+    beforeEach(() => {
+        stateDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-journal-delta-"));
+        process.env.HQ_STATE_DIR = stateDir;
+    });
+    afterEach(() => {
+        delete process.env.HQ_STATE_DIR;
+        fs.rmSync(stateDir, { recursive: true, force: true });
+    });
+    // --- the round trip, over every mutation shape --------------------------
+    it("round-trips an added file", () => {
+        writeJournal("acme", journal({ "a.md": entry() }));
+        const next = journal({ "a.md": entry(), "b.md": entry({ size: 20 }) }, "t1");
+        writeJournal("acme", next);
+        expect(readJournal("acme")).toEqual(next);
+    });
+    it("round-trips a modified file", () => {
+        writeJournal("acme", journal({ "a.md": entry() }));
+        const next = journal({ "a.md": entry({ hash: "b".repeat(64), size: 99 }) }, "t1");
+        writeJournal("acme", next);
+        expect(readJournal("acme")).toEqual(next);
+    });
+    it("round-trips a deleted file", () => {
+        writeJournal("acme", journal({ "a.md": entry(), "b.md": entry() }));
+        const next = journal({ "a.md": entry() }, "t1");
+        writeJournal("acme", next);
+        expect(readJournal("acme")).toEqual(next);
+        expect(readJournal("acme").files["b.md"]).toBeUndefined();
+    });
+    it("round-trips a change confined to an optional field", () => {
+        // The comparison must cover every property of an entry, not a hand-picked
+        // list — a change only to `remoteEtag` still has to reach the delta.
+        writeJournal("acme", journal({ "a.md": entry() }));
+        const next = journal({ "a.md": entry({ remoteEtag: "etag-1" }) }, "t1");
+        writeJournal("acme", next);
+        expect(readJournal("acme").files["a.md"]?.remoteEtag).toBe("etag-1");
+    });
+    it("round-trips removal of an optional field", () => {
+        writeJournal("acme", journal({ "a.md": entry({ mtimeMs: 5 }) }));
+        const next = journal({ "a.md": entry() }, "t1");
+        writeJournal("acme", next);
+        expect(readJournal("acme").files["a.md"]).not.toHaveProperty("mtimeMs");
+    });
+    it("round-trips lastSync on an otherwise unchanged journal", () => {
+        writeJournal("acme", journal({ "a.md": entry() }, "t0"));
+        writeJournal("acme", journal({ "a.md": entry() }, "t-later"));
+        expect(readJournal("acme").lastSync).toBe("t-later");
+    });
+    it("preserves a concurrent writer's untouched key when a stale writer commits", () => {
+        writeJournal("acme", journal({
+            "pull.md": entry({ remoteEtag: "etag-before" }),
+            "watch.md": entry({ remoteEtag: "etag-before" }),
+        }));
+        // The pull and watcher each loaded this same journal revision. The watcher
+        // commits first; the pull's stale object never touched watch.md and must not
+        // republish its old value while recording pull.md.
+        const pullWriter = readJournal("acme");
+        const watcherWriter = readJournal("acme");
+        watcherWriter.files["watch.md"] = { ...watcherWriter.files["watch.md"], remoteEtag: "watcher-etag" };
+        writeJournal("acme", watcherWriter);
+        pullWriter.files["pull.md"] = { ...pullWriter.files["pull.md"], remoteEtag: "pull-etag" };
+        writeJournal("acme", pullWriter);
+        expect(readJournal("acme").files).toMatchObject({
+            "pull.md": { remoteEtag: "pull-etag" },
+            "watch.md": { remoteEtag: "watcher-etag" },
+        });
+    });
+    it("survives a long run of successive updates", () => {
+        writeJournal("acme", journal({}));
+        const files = {};
+        for (let i = 0; i < 40; i++) {
+            files[`f${i}.md`] = entry({ size: i });
+            if (i % 7 === 3)
+                delete files[`f${i - 1}.md`];
+            writeJournal("acme", journal({ ...files }, `t${i}`));
+        }
+        expect(readJournal("acme")).toEqual(journal({ ...files }, "t39"));
+    });
+    // --- the legacy JSON path is now a locator ------------------------------
+    it("keeps the legacy path tiny instead of copying the journal into it", () => {
+        const many = {};
+        for (let i = 0; i < 4000; i++) {
+            many[`knowledge/notes/file-${i}-${"x".repeat(60)}.md`] = entry();
+        }
+        writeJournal("big", journal(many));
+        writeJournal("big", journal({ ...many, "one-more.md": entry() }, "t1"));
+        // A full copy of this journal is hundreds of KB; the locator is bytes.
+        expect(locatorBytes("big")).toBeLessThan(4096);
+        // …and the real state is intact.
+        expect(Object.keys(readJournal("big").files)).toHaveLength(4001);
+    });
+    it("replaces a pre-existing full copy in place, reclaiming its space", () => {
+        // An install upgrading from the old format arrives with a full copy on
+        // disk. It must be overwritten by an ordinary write — not left to grow, and
+        // not requiring a separate cleanup step anyone has to remember to run.
+        writeJournal("upgraded", journal({ "a.md": entry() }));
+        const bulky = JSON.stringify(journal(Object.fromEntries(Array.from({ length: 3000 }, (_, i) => [`f${i}-${"y".repeat(60)}.md`, entry()]))));
+        fs.writeFileSync(getJournalPath("upgraded"), bulky);
+        expect(locatorBytes("upgraded")).toBeGreaterThan(100_000);
+        writeJournal("upgraded", journal({ "a.md": entry(), "b.md": entry() }, "t1"));
+        expect(locatorBytes("upgraded")).toBeLessThan(4096);
+        expect(Object.keys(readJournal("upgraded").files).sort()).toEqual(["a.md", "b.md"]);
+    });
+    it("still lets listJournals discover every slug", () => {
+        // The locator's remaining job: store directories are named by a one-way
+        // digest, so this filename is the only way to enumerate slugs.
+        writeJournal("alpha", journal({ "a.md": entry() }));
+        writeJournal("bravo", journal({ "b.md": entry() }));
+        writeJournal("charlie", journal({ "c.md": entry() }));
+        expect(listJournals().map((j) => j.slug)).toEqual(["alpha", "bravo", "charlie"]);
+        expect(listJournals().find((j) => j.slug === "bravo")?.journal.files).toHaveProperty("b.md");
+    });
+    it("does not rewrite the locator once it is in place", () => {
+        writeJournal("stable", journal({ "a.md": entry() }));
+        const first = fs.statSync(getJournalPath("stable")).mtimeMs;
+        writeJournal("stable", journal({ "a.md": entry(), "b.md": entry() }, "t1"));
+        expect(fs.statSync(getJournalPath("stable")).mtimeMs).toBe(first);
+    });
+});
+//# sourceMappingURL=journal-delta-writes.test.js.map

package/dist/journal-delta-writes.test.js.map

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

package/dist/journal-ledger-index.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `readJournalLedgerIndex` is the read-only ledger surface the manifest
+ * builder uses, and it takes a shortcut the ordinary journal read does not:
+ * when the shard is a legacy JSON document it is scanned incrementally instead
+ * of parsed whole.
+ *
+ * A shortcut in a read path earns exactly one kind of test — one that pins it
+ * to the SAME answers the path it bypasses would have given, including the
+ * uncomfortable ones. So these cover the recovery and normalisation behaviour
+ * the streaming path could plausibly lose: last-good fallback, tombstone
+ * exclusion, Windows key repair, and the difference between an absent ledger
+ * and an unreadable one.
+ */
+export {};
+//# sourceMappingURL=journal-ledger-index.test.d.ts.map

package/dist/journal-ledger-index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-ledger-index.test.d.ts","sourceRoot":"","sources":["../src/journal-ledger-index.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}