@indigoai-us/hq-cloud 6.15.78 → 6.15.80

package/dist/sync/area-ledger-migration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=area-ledger-migration.test.d.ts.map

package/dist/sync/area-ledger-migration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-ledger-migration.test.d.ts","sourceRoot":"","sources":["../../src/sync/area-ledger-migration.test.ts"],"names":[],"mappings":""}

package/dist/sync/area-ledger-migration.test.js

@@ -0,0 +1,274 @@
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { AreaLedgerMigration, areaLayoutManifestPath, assertV3OnlyPinAllowed, resolveAreaLayoutAuthority, setAreaLedgerMigrationTestHooksForTest } from "./area-ledger-migration.js";
+import { AreaResolver } from "./area-resolver.js";
+import { StateStore } from "./state-store.js";
+const roots = [];
+afterEach(() => {
+    setAreaLedgerMigrationTestHooksForTest(undefined);
+    for (const root of roots.splice(0))
+        fs.rmSync(root, { recursive: true, force: true });
+});
+function root() {
+    const value = fs.mkdtempSync(path.join(os.tmpdir(), "hq-area-migration-test-"));
+    roots.push(value);
+    return value;
+}
+function entry(size, tombstone = false) {
+    return {
+        hash: `${size}`.padStart(64, "0"),
+        size,
+        syncedAt: "2026-08-27T00:00:00.000Z",
+        direction: "up",
+        ...(tombstone ? { removedAt: "2026-08-27T00:00:00.000Z", removedReason: "manual" } : {}),
+    };
+}
+function journal(files = {}) {
+    return { version: "2", lastSync: "before", files, pulls: [] };
+}
+const layout = {
+    format: 1,
+    routerVersion: 1,
+    areas: [
+        { id: "root:alpha", prefixes: ["alpha"], paths: [] },
+        { id: "root:beta", prefixes: ["beta"], paths: [] },
+        { id: "root:@files", prefixes: [], paths: [], rootFiles: true },
+    ],
+};
+function openLegacy(stateRoot, initial) {
+    return StateStore.open({
+        rootDir: stateRoot,
+        scopeId: "journal:personal-vault",
+        initialState: { journal: initial },
+        validateRecord: (record) => {
+            if (record.type !== 2)
+                throw new Error("unexpected test journal record");
+        },
+        reduce: (state, record) => {
+            const delta = record.payload;
+            for (const key of delta.deletes)
+                delete state.journal.files[key];
+            Object.assign(state.journal.files, delta.upserts);
+            state.journal.lastSync = delta.lastSync ?? state.journal.lastSync;
+            state.journal.pulls = delta.pulls ?? state.journal.pulls;
+            return state;
+        },
+    });
+}
+function migration(stateRoot, store) {
+    return new AreaLedgerMigration({
+        rootDir: stateRoot,
+        journalSlug: "personal-vault",
+        resolver: new AreaResolver(layout),
+        legacyStore: store,
+        maxRowsPerRecord: 2,
+        maxRecordBytes: 8 * 1024,
+    });
+}
+function migrationWithLimits(stateRoot, store, maxRecordBytes) {
+    return new AreaLedgerMigration({
+        rootDir: stateRoot,
+        journalSlug: "personal-vault",
+        resolver: new AreaResolver(layout),
+        legacyStore: store,
+        maxRowsPerRecord: 100,
+        maxRecordBytes,
+    });
+}
+function append(store, delta) {
+    store.append(2, delta);
+}
+/** Mutate a tiny fixture's authenticated generation number without generating 11,694 files. */
+function retagGeneration(store, generation) {
+    const snapshot = path.join(store.stateDir, "snapshot-1.bin");
+    const wal = path.join(store.stateDir, "wal-1.bin");
+    const retag = (file, checksumOffset) => {
+        const bytes = fs.readFileSync(file);
+        bytes.writeBigUInt64BE(BigInt(generation), 8);
+        crypto.createHash("sha256").update(bytes.subarray(0, checksumOffset)).digest().copy(bytes, checksumOffset);
+        fs.writeFileSync(file, bytes);
+    };
+    // Snapshot checksum covers header + payload, while WAL checksum covers header.
+    retag(snapshot, fs.statSync(snapshot).size - 32);
+    retag(wal, 48);
+    fs.renameSync(snapshot, path.join(store.stateDir, `snapshot-${generation}.bin`));
+    fs.renameSync(wal, path.join(store.stateDir, `wal-${generation}.bin`));
+    fs.writeFileSync(path.join(store.stateDir, "current"), `${generation}\n`);
+}
+describe("AreaLedgerMigration", () => {
+    it("pins and projects a generation-11694 source into bounded area records", () => {
+        const stateRoot = root();
+        const initial = journal({ "alpha/a": entry(1), "alpha/b": entry(2), "beta/c": entry(3, true) });
+        const first = openLegacy(stateRoot, initial);
+        retagGeneration(first, 11_694);
+        const source = openLegacy(stateRoot, journal());
+        const result = migration(stateRoot, source).copyAndCatchUp();
+        expect(result.state.sourceGeneration).toBe(11_694);
+        expect(result.projectedRows).toBe(3);
+        expect(result.maxProjectedRecordBytes).toBeLessThanOrEqual(8 * 1024);
+        expect(resolveAreaLayoutAuthority(stateRoot, "personal-vault")).toBe("legacy");
+        // The fixture has one snapshot/WAL pair, rather than 11,694 large files.
+        expect(fs.readdirSync(source.stateDir).filter((name) => name.startsWith("snapshot-")).length).toBe(1);
+    });
+    it("replays a warm WAL tail idempotently after source rotation", () => {
+        const stateRoot = root();
+        const reader = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        const bridge = migration(stateRoot, reader);
+        bridge.copyAndCatchUp();
+        const writer = openLegacy(stateRoot, journal());
+        append(writer, { version: "2", upserts: { "beta/b": entry(2) }, deletes: [], lastSync: "tail" });
+        writer.replaceState(structuredClone(writer.getState()));
+        bridge.copyAndCatchUp();
+        bridge.copyAndCatchUp();
+        const cutover = bridge.cutOver();
+        expect(cutover.phase).toBe("area-authoritative");
+    });
+    it("reconciles a persisted source cursor when a fresh process already materialized the tail", () => {
+        const stateRoot = root();
+        const initial = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        migration(stateRoot, initial).copyAndCatchUp();
+        const writer = openLegacy(stateRoot, journal());
+        append(writer, { version: "2", upserts: { "beta/from-new-process": entry(2) }, deletes: [] });
+        // A new StateStore.open has no refresh records because it already replayed
+        // the tail. The persisted migration cursor must still drive reconciliation.
+        const reopened = openLegacy(stateRoot, journal());
+        const resumed = migration(stateRoot, reopened);
+        expect(resumed.cutOver().phase).toBe("area-authoritative");
+        expect(resumed.readAreaJournal().files["beta/from-new-process"]).toMatchObject({ size: 2 });
+    });
+    it("flushes before a multi-row projection crosses its byte limit", () => {
+        const stateRoot = root();
+        const long = "x".repeat(420);
+        const source = openLegacy(stateRoot, journal({
+            [`alpha/${long}-one`]: entry(1),
+            [`alpha/${long}-two`]: entry(2),
+        }));
+        const bridge = migrationWithLimits(stateRoot, source, 1024);
+        const result = bridge.copyAndCatchUp();
+        expect(result.maxProjectedRecordBytes).toBeLessThanOrEqual(1024);
+        expect(bridge.cutOver().phase).toBe("area-authoritative");
+    });
+    it("rejects only a single projection row that cannot fit the limit", () => {
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ [`alpha/${"x".repeat(2_000)}`]: entry(1) }));
+        expect(() => migrationWithLimits(stateRoot, source, 1024).copyAndCatchUp())
+            .toThrow("projected record exceeded bounded size");
+    });
+    it("persists and retires the source pin across separate migration processes", () => {
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        const copied = migration(stateRoot, source).copyAndCatchUp();
+        expect(copied.state.sourcePinPath).toBeDefined();
+        expect(fs.readdirSync(source.stateDir).filter((name) => name.startsWith("generation-pin-")).length).toBe(1);
+        const reopened = openLegacy(stateRoot, journal());
+        expect(migration(stateRoot, reopened).cutOver().sourcePinPath).toBeUndefined();
+        expect(fs.readdirSync(source.stateDir).filter((name) => name.startsWith("generation-pin-")).length).toBe(0);
+    });
+    it("retires a persisted source pin when an uncommitted migration is abandoned", () => {
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        migration(stateRoot, source).copyAndCatchUp();
+        expect(fs.readdirSync(source.stateDir).some((name) => name.startsWith("generation-pin-"))).toBe(true);
+        expect(migration(stateRoot, openLegacy(stateRoot, journal())).abandon().phase).toBe("legacy-authoritative");
+        expect(fs.readdirSync(source.stateDir).some((name) => name.startsWith("generation-pin-"))).toBe(false);
+    });
+    it("chooses legacy before the manifest rename and areas after it, including a torn primary manifest", () => {
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        const bridge = migration(stateRoot, source);
+        setAreaLedgerMigrationTestHooksForTest({ beforeManifestCommit: () => { throw new Error("crash before commit"); } });
+        expect(() => bridge.cutOver()).toThrow("crash before commit");
+        expect(resolveAreaLayoutAuthority(stateRoot, "personal-vault")).toBe("legacy");
+        setAreaLedgerMigrationTestHooksForTest(undefined);
+        expect(bridge.cutOver().phase).toBe("area-authoritative");
+        fs.writeFileSync(areaLayoutManifestPath(stateRoot, "personal-vault"), "{torn");
+        expect(resolveAreaLayoutAuthority(stateRoot, "personal-vault")).toBe("areas");
+    });
+    it("keeps legacy authoritative across every interrupted pre-commit durable phase", () => {
+        for (const phase of ["source-pinned", "area-cursor-chunk", "area-cursor", "snapshot-projected", "tail-replayed"]) {
+            const stateRoot = root();
+            const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1), "alpha/b": entry(2), "alpha/c": entry(3) }));
+            setAreaLedgerMigrationTestHooksForTest({ afterDurablePhase: (actual) => {
+                    if (actual === phase)
+                        throw new Error(`crash at ${phase}`);
+                } });
+            expect(() => migration(stateRoot, source).copyAndCatchUp()).toThrow(`crash at ${phase}`);
+            expect(resolveAreaLayoutAuthority(stateRoot, "personal-vault")).toBe("legacy");
+            setAreaLedgerMigrationTestHooksForTest(undefined);
+        }
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        setAreaLedgerMigrationTestHooksForTest({ afterDurablePhase: (phase) => {
+                if (phase === "manifest-commit")
+                    throw new Error("crash after commit");
+            } });
+        expect(() => migration(stateRoot, source).cutOver()).toThrow("crash after commit");
+        expect(resolveAreaLayoutAuthority(stateRoot, "personal-vault")).toBe("areas");
+    });
+    it("keeps rollback unsafe during mirror lag, then composes back before allowing a v3-only pin", () => {
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        const bridge = migration(stateRoot, source);
+        bridge.cutOver();
+        setAreaLedgerMigrationTestHooksForTest({ afterDurablePhase: (phase) => {
+                if (phase === "area-commit")
+                    throw new Error("crash before mirror");
+            } });
+        expect(() => bridge.reverseShadow({ upserts: { "beta/b": entry(2) } })).toThrow("crash before mirror");
+        expect(() => assertV3OnlyPinAllowed(stateRoot, "personal-vault")).toThrow("refusing v3-only pin");
+        setAreaLedgerMigrationTestHooksForTest(undefined);
+        expect(migration(stateRoot, source).composeBackForV3Rollback().rollbackSafe).toBe(true);
+        expect(() => assertV3OnlyPinAllowed(stateRoot, "personal-vault")).not.toThrow();
+    });
+    it("publishes rollback-unsafety before the area append can become durable", () => {
+        const stateRoot = root();
+        const source = openLegacy(stateRoot, journal({ "alpha/a": entry(1) }));
+        const bridge = migration(stateRoot, source);
+        bridge.cutOver();
+        setAreaLedgerMigrationTestHooksForTest({ afterDurablePhase: (phase) => {
+                if (phase === "area-commit-intent")
+                    throw new Error("crash before area append");
+            } });
+        expect(() => bridge.reverseShadow({ upserts: { "beta/not-appended": entry(2) } }))
+            .toThrow("crash before area append");
+        expect(() => assertV3OnlyPinAllowed(stateRoot, "personal-vault")).toThrow("refusing v3-only pin");
+        expect(migration(stateRoot, source).readAreaJournal().files["beta/not-appended"]).toBeUndefined();
+    });
+    it("computes canonical parity digests incrementally with the existing digest contract", () => {
+        const stateRoot = root();
+        const sourceJournal = journal({ "alpha/a": entry(1), "beta/b": entry(2, true) });
+        const source = openLegacy(stateRoot, sourceJournal);
+        const bridge = migration(stateRoot, source);
+        bridge.copyAndCatchUp();
+        const expectedRows = Object.keys(sourceJournal.files).sort()
+            .map((key) => `${key}\n${canonical(sourceJournal.files[key])}`).join("\n");
+        expect(bridge.verifyParity(sourceJournal)).toMatchObject({
+            rowDigest: crypto.createHash("sha256").update(expectedRows).digest("hex"),
+            unionDigest: crypto.createHash("sha256").update("alpha/a\nbeta/b").digest("hex"),
+            tombstoneDigest: crypto.createHash("sha256").update("beta/b").digest("hex"),
+        });
+    });
+    it("models the 300k-row / 232MB production shape without materializing 232MB payloads", () => {
+        const logicalRows = 300_000;
+        const logicalBytes = 232 * 1024 * 1024;
+        const rowBytes = Math.floor(logicalBytes / logicalRows);
+        const maxRecordBytes = DEFAULT_SHAPE_RECORD_BYTES;
+        const records = Math.ceil(logicalRows / Math.floor(maxRecordBytes / rowBytes));
+        expect(records).toBeGreaterThan(1);
+        expect(maxRecordBytes).toBeLessThan(256 * 1024 * 1024);
+    });
+});
+const DEFAULT_SHAPE_RECORD_BYTES = 256 * 1024;
+function canonical(value) {
+    if (value === null || typeof value === "boolean" || typeof value === "string" || typeof value === "number") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(",")}]`;
+    const object = value;
+    return `{${Object.keys(object).sort().map((key) => `${JSON.stringify(key)}:${canonical(object[key])}`).join(",")}}`;
+}
+//# sourceMappingURL=area-ledger-migration.test.js.map

package/dist/sync/area-ledger-migration.test.js.map

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

package/dist/sync/area-ledger.d.ts

@@ -0,0 +1,93 @@
+import type { JournalEntry, PullRecord, SyncJournal } from "../types.js";
+type JournalMetadata = {
+    lastSync?: string;
+    pulls?: PullRecord[];
+};
+export interface AreaLedgerDelta {
+    upserts?: Record<string, JournalEntry>;
+    deletes?: readonly string[];
+    metadata?: JournalMetadata;
+}
+export interface AreaLedgerOptions {
+    rootDir: string;
+    journalSlug: string;
+    layoutEpoch: number;
+    /** Every configured data area. `@meta` is reserved for the ledger itself. */
+    areaIds: readonly string[];
+    /** Returns the one configured area responsible for a canonical journal key. */
+    resolveArea: (key: string) => string | undefined;
+    /** Used only when an area StateStore is first created; this is not migration. */
+    initialJournal?: SyncJournal;
+    maxRecordsBeforeCompaction?: number;
+    maxWalBytesBeforeCompaction?: number;
+}
+interface AreaLedgerTestHooks {
+    afterDataBeforeWatermark?: () => void;
+    afterWatermarkBeforeFinalize?: () => void;
+}
+/** Test-only crash seam: data prepares are durable before a meta watermark. */
+export declare function setAreaLedgerTestHooksForTest(hooks: AreaLedgerTestHooks | undefined): void;
+/**
+ * The storage half of the parallel-sync area design.
+ *
+ * Data records are prepared in area stores first.  The tiny `@meta` record is
+ * the final watermark.  A crash before that watermark leaves a recoverable,
+ * invisible prepare; a crash after it leaves a complete aggregate view.  This
+ * makes global metadata data-first and watermark-last without putting a large
+ * aggregate snapshot behind one append lock.
+ */
+export declare class AreaLedger {
+    private readonly options;
+    private readonly areaIds;
+    private readonly areas;
+    private meta;
+    private readonly opened;
+    private constructor();
+    static open(options: AreaLedgerOptions): AreaLedger;
+    /** Scope identity is stable and human-auditable even though StateStore hashes it on disk. */
+    scopeId(areaId: string): string;
+    /** Opens one data area only. Useful for a one-path, metadata-free operation. */
+    readScoped(keys: readonly string[]): SyncJournal;
+    /** Aggregate read. It is the parity view used by legacy SyncJournal callers. */
+    read(): SyncJournal;
+    /**
+     * Commit a partitioned journal delta.  A metadata-only update still has a
+     * `@meta` append, while all data-bearing commits use the recoverable prepare
+     * protocol so multiple areas never expose a half transaction to `read()`.
+     */
+    append(delta: AreaLedgerDelta): void;
+    /**
+     * Finish a transaction whose process died after durable area prepares but
+     * before its meta watermark.  Incomplete prepares stay invisible, so a
+     * crash can never synthesize a partial aggregate journal.
+     */
+    recoverPendingTransactions(): void;
+    /** Test/diagnostic surface proving independent scopes have independent locks. */
+    stateDirectoriesForTest(): ReadonlyMap<string, string>;
+    openedAreasForTest(): readonly string[];
+    transactionCountsForTest(): {
+        prepared: number;
+        watermarks: number;
+        finalized: number;
+    };
+    private appendMeta;
+    private openArea;
+    private openMeta;
+    private initialAreaJournal;
+    private partition;
+    private resolveArea;
+    private assertKnownArea;
+    private combine;
+    /** A watermark publishes only when every named area has prepared or folded it. */
+    private committedTransactions;
+    /**
+     * Bound replay after publication.  Area folds are individually durable; a
+     * folded marker keeps a still-present watermark atomic if the process dies
+     * between peers.  The watermark is retired only once every named area has
+     * its folded base snapshot, then a later pass clears the transient markers.
+     */
+    private finalizeCommittedTransactions;
+    private finalizePublishedTransactions;
+}
+export {};
+//# sourceMappingURL=area-ledger.d.ts.map

package/dist/sync/area-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-ledger.d.ts","sourceRoot":"","sources":["../../src/sync/area-ledger.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQzE,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,iFAAiF;IACjF,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAoCD,UAAU,mBAAmB;IAC3B,wBAAwB,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,4BAA4B,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3C;AAID,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAE1F;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IAMD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO;IAWP,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAInD,6FAA6F;IAC7F,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAK/B,gFAAgF;IAChF,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW;IA6BhD,gFAAgF;IAChF,IAAI,IAAI,WAAW;IAmBnB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAmCpC;;;;OAIG;IACH,0BAA0B,IAAI,IAAI;IA6BlC,iFAAiF;IACjF,uBAAuB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAOtD,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC,wBAAwB,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAYvF,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,OAAO;IAWf,kFAAkF;IAClF,OAAO,CAAC,qBAAqB;IAY7B;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IA4BrC,OAAO,CAAC,6BAA6B;CAWtC"}