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

package/dist/cli/streaming-pull-planner.bench.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resident-memory gate for an all-mode pull at the list -> plan boundary.
+ *
+ * `sync()` receives every remote object through `listRemoteFilesForScope()`;
+ * all mode deliberately invokes the broad `listRemoteFiles()` branch. This
+ * fixture reaches that production seam with a paged ObjectIO transport, then
+ * stops at the emitted plan before transfer/execution can own unrelated data.
+ *
+ * The fixture is 50,000 long-path rows rather than the largest 677,732-row
+ * personal vault. It matches the steady-state phase-two retention harness's
+ * practical full-pass cardinality, makes three independent trials CI-sized,
+ * and keeps the bound per-row so the production scope remains constrained.
+ */
+export {};
+//# sourceMappingURL=streaming-pull-planner.bench.test.d.ts.map

package/dist/cli/streaming-pull-planner.bench.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-pull-planner.bench.test.d.ts","sourceRoot":"","sources":["../../src/cli/streaming-pull-planner.bench.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/cli/streaming-pull-planner.bench.test.js

@@ -0,0 +1,273 @@
+/**
+ * Resident-memory gate for an all-mode pull at the list -> plan boundary.
+ *
+ * `sync()` receives every remote object through `listRemoteFilesForScope()`;
+ * all mode deliberately invokes the broad `listRemoteFiles()` branch. This
+ * fixture reaches that production seam with a paged ObjectIO transport, then
+ * stops at the emitted plan before transfer/execution can own unrelated data.
+ *
+ * The fixture is 50,000 long-path rows rather than the largest 677,732-row
+ * personal vault. It matches the steady-state phase-two retention harness's
+ * practical full-pass cardinality, makes three independent trials CI-sized,
+ * and keeps the bound per-row so the production scope remains constrained.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+import { clearContextCache } from "../context.js";
+import { closeCachedAreaJournalMigration, openJournalStateStoreForMigration, releaseCachedAreaJournalMigrations, writeJournal, } from "../journal.js";
+import { acquireGc, collectGarbage, usedBytes } from "../journal-snapshot-memory-helpers.js";
+import { setObjectIOFactory, } from "../object-io.js";
+import { AreaLedgerMigration } from "../sync/area-ledger-migration.js";
+import { AreaResolver } from "../sync/area-resolver.js";
+import { sync } from "./sync.js";
+const ROW_COUNT = 50_000;
+const PAGE_SIZE = 1_000;
+const TRIALS = 3;
+const CONTROL_BYTES = 16 * 1024 * 1024;
+// The current released phase-two store retains 117.73 B/row. A streaming
+// planner should need no more than two similarly compact per-key structures:
+// a canonical presence marker for delete detection and a decision marker for
+// an actionable item. 2 * 117.73 rounds up to 236 B/row. The fixed 3 MiB
+// covers one 1,000-object page (~0.37 MiB at the measured old shape) plus
+// table capacity and one pass's non-row bookkeeping. The journal itself is
+// deliberately in the pre-measurement baseline.
+const MAX_LIVE_BOUNDARY_BYTES_PER_ROW = 236;
+const MAX_FIXED_LIVE_BOUNDARY_BYTES = 3 * 1024 * 1024;
+const MAX_LIVE_BOUNDARY_BYTES = MAX_FIXED_LIVE_BOUNDARY_BYTES + ROW_COUNT * MAX_LIVE_BOUNDARY_BYTES_PER_ROW;
+const EMPTY_FILE_SHA256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855";
+const STOP_AFTER_PLAN = Symbol("streaming-pull-planner-boundary");
+const ORIGINAL_STATE_DIR = process.env.HQ_STATE_DIR;
+const layout = {
+    format: 1,
+    routerVersion: 1,
+    areas: [
+        { id: "root:docs", prefixes: ["docs"], paths: [] },
+        { id: "root:@files", prefixes: [], paths: [], rootFiles: true },
+    ],
+};
+const vaultConfig = {
+    apiUrl: "https://vault-api.test",
+    authToken: "streaming-pull-planner-test-token",
+    region: "us-east-1",
+    companyVaultUsesPresign: true,
+};
+let baseDir = "";
+let hqRoot = "";
+let stateDir = "";
+let collect;
+function fixtureKey(index) {
+    const token = index.toString(36).padStart(8, "0");
+    return `docs/directory-${index % 400}/nested-${index % 37}/entry-${token.repeat(15)}.md`;
+}
+function remoteEtag(index) {
+    return `streaming-boundary-${index.toString(16).padStart(8, "0")}`;
+}
+function pagedObjectIO() {
+    return {
+        putObject: async () => ({ etag: "unused" }),
+        getObject: async () => {
+            throw new Error("all-mode boundary fixture must stop before download");
+        },
+        deleteObject: async () => {
+            throw new Error("all-mode boundary fixture must stop before delete");
+        },
+        headObject: async () => {
+            throw new Error("all-mode boundary fixture must stop before HEAD");
+        },
+        listObjects: async (input) => {
+            expect(input.prefix).toBeUndefined();
+            const start = input.continuationToken === undefined ? 0 : Number(input.continuationToken);
+            const end = Math.min(start + PAGE_SIZE, ROW_COUNT);
+            const objects = [];
+            for (let index = start; index < end; index += 1) {
+                objects.push({
+                    key: fixtureKey(index),
+                    size: 0,
+                    lastModified: new Date(1_700_000_000_000 + index),
+                    etag: remoteEtag(index),
+                });
+            }
+            return {
+                objects,
+                nextContinuationToken: end < ROW_COUNT ? String(end) : undefined,
+            };
+        },
+    };
+}
+function seedAreaAuthoritativeJournal() {
+    const slug = "streaming-boundary";
+    const companyRoot = path.join(hqRoot, "companies", slug);
+    const files = {};
+    for (let index = 0; index < ROW_COUNT; index += 1) {
+        const key = fixtureKey(index);
+        const localPath = path.join(companyRoot, key);
+        fs.mkdirSync(path.dirname(localPath), { recursive: true });
+        fs.writeFileSync(localPath, "");
+        const stats = fs.lstatSync(localPath);
+        files[key] = {
+            hash: EMPTY_FILE_SHA256,
+            size: 0,
+            syncedAt: "2026-09-15T00:00:00.000Z",
+            direction: "down",
+            kind: "file",
+            remoteEtag: remoteEtag(index),
+            mtimeMs: Math.floor(stats.mtimeMs),
+            ctimeMs: Math.floor(stats.ctimeMs),
+        };
+    }
+    writeJournal(slug, { version: "2", lastSync: "seed", files, pulls: [] });
+    const migration = new AreaLedgerMigration({
+        rootDir: stateDir,
+        journalSlug: slug,
+        resolver: new AreaResolver(layout),
+        legacyStore: openJournalStateStoreForMigration(slug),
+        maxRecordBytes: 32 * 1024 * 1024,
+        maxRowsPerRecord: ROW_COUNT,
+    });
+    migration.copyAndCatchUp();
+    expect(migration.cutOver(Number.POSITIVE_INFINITY).phase).toBe("area-authoritative");
+    migration.dispose();
+}
+async function runThroughAllModePlan(onPlan) {
+    try {
+        await sync({
+            company: "streaming-boundary",
+            vaultConfig,
+            hqRoot,
+            fileTombstones: new Map(),
+            skipReindex: true,
+            operationLockAlreadyHeld: true,
+            onEvent: (event) => {
+                if (event.type !== "plan")
+                    return;
+                onPlan(event);
+                throw STOP_AFTER_PLAN;
+            },
+        });
+    }
+    catch (error) {
+        if (error === STOP_AFTER_PLAN)
+            return;
+        throw error;
+    }
+    throw new Error("all-mode boundary fixture reached an executor instead of stopping at plan");
+}
+async function warmAllModePlan() {
+    let filesToSkip;
+    await runThroughAllModePlan((event) => {
+        filesToSkip = event.filesToSkip;
+    });
+    expect(filesToSkip).toBe(ROW_COUNT);
+}
+async function measureLiveBoundary() {
+    collectGarbage(collect);
+    const baselineBytes = usedBytes();
+    let boundaryBytes;
+    let planFilesToSkip;
+    await runThroughAllModePlan((event) => {
+        planFilesToSkip = event.filesToSkip;
+        // This event is emitted while both the all-mode RemoteFile[] and PullPlan
+        // are still live in syncWithOperationLockHeld's stack frame.
+        collectGarbage(collect);
+        boundaryBytes = usedBytes();
+    });
+    if (boundaryBytes === undefined || planFilesToSkip === undefined) {
+        throw new Error("all-mode boundary fixture did not observe the pull plan");
+    }
+    return {
+        baselineBytes,
+        liveBytes: boundaryBytes - baselineBytes,
+        planFilesToSkip,
+    };
+}
+function measureAllocationControl() {
+    collectGarbage(collect);
+    const baselineBytes = usedBytes();
+    let control = Buffer.alloc(CONTROL_BYTES, 0x5a);
+    expect(control[0]).toBe(0x5a);
+    const detectedBytes = usedBytes() - baselineBytes;
+    control = undefined;
+    collectGarbage(collect);
+    return detectedBytes;
+}
+describe("all-mode list to plan resident boundary", () => {
+    beforeAll(async () => {
+        baseDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-streaming-pull-planner-"));
+        hqRoot = path.join(baseDir, "hq");
+        stateDir = path.join(baseDir, "state");
+        fs.mkdirSync(stateDir, { recursive: true });
+        process.env.HQ_STATE_DIR = stateDir;
+        clearContextCache();
+        releaseCachedAreaJournalMigrations();
+        vi.stubGlobal("fetch", async (url) => {
+            const target = String(url);
+            if (target.includes("/entity/check-slug/me")) {
+                return {
+                    ok: true,
+                    status: 200,
+                    json: async () => ({ available: false, conflictingCompanyUid: "cmp_streaming_boundary" }),
+                    text: async () => "",
+                };
+            }
+            if (target.includes("/entity/by-slug/") || target.includes("/entity/cmp_")) {
+                return {
+                    ok: true,
+                    status: 200,
+                    json: async () => ({
+                        entity: {
+                            uid: "cmp_streaming_boundary",
+                            slug: "streaming-boundary",
+                            bucketName: "hq-vault-streaming-boundary",
+                            status: "active",
+                        },
+                    }),
+                    text: async () => "",
+                };
+            }
+            return { ok: false, status: 404, json: async () => ({}), text: async () => "not found" };
+        });
+        setObjectIOFactory(() => pagedObjectIO());
+        seedAreaAuthoritativeJournal();
+        collect = acquireGc();
+        // The first pass opens the cached area migration. The measured passes are
+        // the steady state after that one-time work has settled.
+        await warmAllModePlan();
+        collectGarbage(collect);
+    }, 300_000);
+    afterAll(() => {
+        setObjectIOFactory(null);
+        clearContextCache();
+        releaseCachedAreaJournalMigrations();
+        closeCachedAreaJournalMigration("streaming-boundary");
+        vi.unstubAllGlobals();
+        if (ORIGINAL_STATE_DIR === undefined)
+            delete process.env.HQ_STATE_DIR;
+        else
+            process.env.HQ_STATE_DIR = ORIGINAL_STATE_DIR;
+        fs.rmSync(baseDir, { recursive: true, force: true });
+    });
+    it(`retains at most ${MAX_LIVE_BOUNDARY_BYTES_PER_ROW} B/row after all-mode list and plan`, async () => {
+        const controlBytes = measureAllocationControl();
+        expect(controlBytes).toBeGreaterThan(CONTROL_BYTES * 0.9);
+        const measurements = [];
+        for (let trial = 0; trial < TRIALS; trial += 1) {
+            const measurement = await measureLiveBoundary();
+            expect(measurement.planFilesToSkip).toBe(ROW_COUNT);
+            measurements.push(measurement);
+        }
+        const liveBytes = measurements.map((measurement) => measurement.liveBytes);
+        const minBytes = Math.min(...liveBytes);
+        const maxBytes = Math.max(...liveBytes);
+        const spreadBytes = maxBytes - minBytes;
+        process.stdout.write(`all-mode list->plan resident: rows=${ROW_COUNT}; trials=${liveBytes.join(",")}; ` +
+            `min=${minBytes}; max=${maxBytes}; spread=${spreadBytes}; ` +
+            `ceiling=${MAX_LIVE_BOUNDARY_BYTES}; control=${controlBytes}\n`);
+        // Use the worst of three steady-state trials: a streaming redesign must
+        // keep this boundary below the budget on every isolated pass, not merely
+        // win one favourable GC sample.
+        expect(maxBytes).toBeLessThanOrEqual(MAX_LIVE_BOUNDARY_BYTES);
+    }, 300_000);
+});
+//# sourceMappingURL=streaming-pull-planner.bench.test.js.map

package/dist/cli/streaming-pull-planner.bench.test.js.map

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

package/dist/cli/sync-scope.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Unit tests for scope-aware download (US-005 wiring into `sync()`).
+ *
+ * Covers the contract added when `syncMode` / `prefixSet` were threaded
+ * through `computePullPlan` + the scope-shrink pass:
+ *
+ *   - `all`    → no filtering (regression guard lives in sync.test.ts).
+ *   - `shared` → only keys covered by `prefixSet` download; the rest are
+ *                classified `skip-out-of-scope` (NOT downloaded).
+ *   - `custom` → same mechanism, driven by the explicit path list.
+ *   - Idempotency → a second `shared` pull downloads nothing and removes
+ *                   nothing (the PullRecord makes scope-change a no-op).
+ *   - Scope shrink → narrowing `all → shared` prunes the now-out-of-scope
+ *                    CLEAN local orphan; a DIRTY orphan aborts with
+ *                    `ScopeShrinkBlockedError` unless `forceScopeShrink`.
+ *
+ * The security contract (this filter is footprint-only, never an authz
+ * boundary) is asserted indirectly: out-of-scope keys are still LISTED and
+ * accessible — the engine simply chooses not to materialize them.
+ */
+export {};
+//# sourceMappingURL=sync-scope.test.d.ts.map

package/dist/cli/sync-scope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-scope.test.d.ts","sourceRoot":"","sources":["../../src/cli/sync-scope.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}