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

package/dist/sync-core.test.js

@@ -0,0 +1,189 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { machineAlreadyBusy, resolveTransferConcurrency, resolveUploadByteBudget, hasRemoteChanged, } from "./sync-core.js";
+import { MAX_CONCURRENCY_ENV, setBandwidthGovernorForTesting, } from "./bandwidth.js";
+// A host doing nothing else: a fraction of a core runnable, most RAM available.
+const IDLE = { cores: 8, load1: 0.5, availableMemFraction: 0.6 };
+// CPU already saturated by other work: per-core load 0.8 (>= 0.5 threshold).
+const BUSY_CPU = { cores: 8, load1: 6.4, availableMemFraction: 0.6 };
+// Memory already tight: 10% available (< 25% floor), CPU quiet.
+const TIGHT_MEM = { cores: 8, load1: 0.2, availableMemFraction: 0.1 };
+describe("hasRemoteChanged content lineage", () => {
+    it("uses the published SHA-256 before an SSE-KMS ETag when both hashes exist", () => {
+        const hash = "a".repeat(64);
+        expect(hasRemoteChanged({
+            lastModified: new Date("2026-09-10T19:45:50Z"),
+            etag: "different-kms-etag",
+            contentHash: hash,
+        }, {
+            syncedAt: "2026-09-10T19:45:00Z",
+            remoteEtag: "prior-kms-etag",
+            hash,
+        })).toBe(false);
+    });
+    it("falls back to the ETag for a legacy object with no published hash", () => {
+        expect(hasRemoteChanged({
+            lastModified: new Date("2026-09-10T19:45:50Z"),
+            etag: "current-kms-etag",
+        }, {
+            syncedAt: "2026-09-10T19:45:00Z",
+            remoteEtag: "prior-kms-etag",
+            hash: "a".repeat(64),
+        })).toBe(true);
+    });
+});
+describe("resolveTransferConcurrency", () => {
+    const KEY = "HQ_SYNC_TRANSFER_CONCURRENCY";
+    let saved;
+    beforeEach(() => {
+        saved = process.env[KEY];
+        delete process.env[KEY];
+    });
+    afterEach(() => {
+        if (saved === undefined)
+            delete process.env[KEY];
+        else
+            process.env[KEY] = saved;
+    });
+    it("defaults to 64-way on an otherwise-idle host", () => {
+        expect(resolveTransferConcurrency(IDLE)).toBe(64);
+    });
+    it("keeps the realtime pool independent of chore load and governor limits", () => {
+        const savedMaxConcurrency = process.env[MAX_CONCURRENCY_ENV];
+        setBandwidthGovernorForTesting(null);
+        process.env[KEY] = "1";
+        process.env[MAX_CONCURRENCY_ENV] = "1";
+        try {
+            expect(resolveTransferConcurrency(BUSY_CPU, "realtime")).toBe(64);
+        }
+        finally {
+            if (savedMaxConcurrency === undefined)
+                delete process.env[MAX_CONCURRENCY_ENV];
+            else
+                process.env[MAX_CONCURRENCY_ENV] = savedMaxConcurrency;
+            setBandwidthGovernorForTesting(null);
+        }
+    });
+    it("steps down to 32 when the host CPU is already busy", () => {
+        expect(resolveTransferConcurrency(BUSY_CPU)).toBe(32);
+    });
+    it("steps down to 32 when host available memory is already tight", () => {
+        expect(resolveTransferConcurrency(TIGHT_MEM)).toBe(32);
+    });
+    it("honors an explicit valid override regardless of host load", () => {
+        process.env[KEY] = "100";
+        expect(resolveTransferConcurrency(BUSY_CPU)).toBe(100);
+        process.env[KEY] = "4";
+        expect(resolveTransferConcurrency(IDLE)).toBe(4);
+    });
+    it("ignores a malformed/zero/negative override and uses the adaptive default", () => {
+        process.env[KEY] = "abc";
+        expect(resolveTransferConcurrency(IDLE)).toBe(64);
+        process.env[KEY] = "0";
+        expect(resolveTransferConcurrency(BUSY_CPU)).toBe(32);
+        process.env[KEY] = "-5";
+        expect(resolveTransferConcurrency(IDLE)).toBe(64);
+    });
+    describe("HQ_SYNC_MAX_CONCURRENCY clamp (bandwidth governor)", () => {
+        let savedClamp;
+        beforeEach(() => {
+            savedClamp = process.env[MAX_CONCURRENCY_ENV];
+            setBandwidthGovernorForTesting(null); // re-read env per test
+        });
+        afterEach(() => {
+            if (savedClamp === undefined)
+                delete process.env[MAX_CONCURRENCY_ENV];
+            else
+                process.env[MAX_CONCURRENCY_ENV] = savedClamp;
+            setBandwidthGovernorForTesting(null);
+        });
+        it("clamps the adaptive default down", () => {
+            process.env[MAX_CONCURRENCY_ENV] = "2";
+            expect(resolveTransferConcurrency(IDLE)).toBe(2);
+            expect(resolveTransferConcurrency(BUSY_CPU)).toBe(2);
+        });
+        it("clamps an explicit HQ_SYNC_TRANSFER_CONCURRENCY override too", () => {
+            process.env[KEY] = "100";
+            process.env[MAX_CONCURRENCY_ENV] = "3";
+            expect(resolveTransferConcurrency(IDLE)).toBe(3);
+        });
+        it("never raises the pool above its resolved size", () => {
+            process.env[MAX_CONCURRENCY_ENV] = "500";
+            expect(resolveTransferConcurrency(IDLE)).toBe(64);
+        });
+        it("0 / invalid clamp values leave the default untouched", () => {
+            process.env[MAX_CONCURRENCY_ENV] = "0";
+            expect(resolveTransferConcurrency(IDLE)).toBe(64);
+            setBandwidthGovernorForTesting(null);
+            process.env[MAX_CONCURRENCY_ENV] = "nope";
+            expect(resolveTransferConcurrency(IDLE)).toBe(64);
+        });
+    });
+    it("reads real host load when no probe is injected (never throws, always positive)", () => {
+        delete process.env[KEY];
+        const n = resolveTransferConcurrency();
+        expect(n === 32 || n === 64).toBe(true);
+    });
+});
+describe("machineAlreadyBusy", () => {
+    it("is false on an otherwise-idle host", () => {
+        expect(machineAlreadyBusy(IDLE)).toBe(false);
+    });
+    it("is true exactly at the per-core load threshold (0.5)", () => {
+        // cores 10, load1 5 => per-core 0.5
+        expect(machineAlreadyBusy({ cores: 10, load1: 5, availableMemFraction: 0.6 })).toBe(true);
+    });
+    it("is false just under the per-core load threshold", () => {
+        // cores 10, load1 4.9 => per-core 0.49
+        expect(machineAlreadyBusy({ cores: 10, load1: 4.9, availableMemFraction: 0.6 })).toBe(false);
+    });
+    it("is true just under the available-memory floor (0.25)", () => {
+        expect(machineAlreadyBusy({ cores: 10, load1: 0, availableMemFraction: 0.249 })).toBe(true);
+    });
+    it("is false at the available-memory floor", () => {
+        expect(machineAlreadyBusy({ cores: 10, load1: 0, availableMemFraction: 0.25 })).toBe(false);
+    });
+    it("treats unknown core count (0) as not-CPU-busy so we never divide by zero", () => {
+        expect(machineAlreadyBusy({ cores: 0, load1: 99, availableMemFraction: 0.6 })).toBe(false);
+    });
+});
+describe("resolveUploadByteBudget", () => {
+    const KEY = "HQ_SYNC_UPLOAD_BYTE_BUDGET_MB";
+    let saved;
+    const MiB = 1024 * 1024;
+    const GiB = 1024 * MiB;
+    beforeEach(() => {
+        saved = process.env[KEY];
+        delete process.env[KEY];
+    });
+    afterEach(() => {
+        if (saved === undefined)
+            delete process.env[KEY];
+        else
+            process.env[KEY] = saved;
+    });
+    it("sizes to 25% of AVAILABLE memory", () => {
+        // 8 GiB total, 20% available => 1.6 GiB available, 25% of that = 400 MiB.
+        expect(resolveUploadByteBudget(0.2, 8 * GiB)).toBe(Math.floor(0.2 * 8 * GiB * 0.25));
+    });
+    it("caps at 1 GiB when available memory is plentiful", () => {
+        expect(resolveUploadByteBudget(0.9, 64 * GiB)).toBe(GiB);
+    });
+    it("shrinks with available memory on a tight host (no oversized floor)", () => {
+        // 8 GiB total, 500 MiB available => 25% = 125 MiB. A total-RAM budget would
+        // have allowed ~819 MiB here, more than what's free.
+        const availFrac = (500 * MiB) / (8 * GiB);
+        expect(resolveUploadByteBudget(availFrac, 8 * GiB)).toBe(Math.floor(500 * MiB * 0.25));
+    });
+    it("never returns below 1 byte even when available rounds to ~0", () => {
+        expect(resolveUploadByteBudget(0, 8 * GiB)).toBe(1);
+    });
+    it("honors an explicit fractional-MB override regardless of available memory", () => {
+        process.env[KEY] = "0.005"; // ~5 KiB, for driving the pool test
+        expect(resolveUploadByteBudget(0.9, 64 * GiB)).toBe(Math.floor(0.005 * MiB));
+    });
+    it("ignores a malformed override and uses the available-based default", () => {
+        process.env[KEY] = "nope";
+        expect(resolveUploadByteBudget(0.2, 8 * GiB)).toBe(Math.floor(0.2 * 8 * GiB * 0.25));
+    });
+});
+//# sourceMappingURL=sync-core.test.js.map

package/dist/sync-core.test.js.map

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

package/dist/sync-progress.test.d.ts

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

package/dist/sync-progress.test.d.ts.map

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

package/dist/sync-progress.test.js

@@ -0,0 +1,277 @@
+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 { createSyncProgressRecorder, createFanoutProgressRecorder, createPassSummaryRecorder, readSyncLastPass, readSyncProgress, syncLastPassPath, PASS_SUMMARY_MAX_PROGRESS, } from "./sync-progress.js";
+const planEvent = (download, upload, del) => ({
+    type: "plan",
+    filesToDownload: download,
+    bytesToDownload: 0,
+    filesToUpload: upload,
+    bytesToUpload: 0,
+    filesToSkip: 0,
+    filesToConflict: 0,
+    filesToDelete: del,
+});
+describe("sync-progress", () => {
+    let stateDir;
+    beforeEach(() => {
+        stateDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-progress-test-"));
+        process.env.HQ_STATE_DIR = stateDir;
+    });
+    afterEach(() => {
+        delete process.env.HQ_STATE_DIR;
+        fs.rmSync(stateDir, { recursive: true, force: true });
+    });
+    it("returns null when no sync has written a snapshot", () => {
+        expect(readSyncProgress()).toBeNull();
+    });
+    it("writes an initial syncing snapshot on creation, before any event", () => {
+        // The menubar must show the sync as active the moment it initialises —
+        // before the remote listing/planning that produces the first `plan` event.
+        createSyncProgressRecorder({ company: "acme", phase: "pull" });
+        const snap = readSyncProgress();
+        expect(snap).not.toBeNull();
+        expect(snap.status).toBe("syncing");
+        expect(snap.company).toBe("acme");
+        expect(snap.phase).toBe("pull");
+        expect(snap.filesTotal).toBe(0);
+        expect(snap.filesDone).toBe(0);
+    });
+    it("accumulates plan totals, progress, and conflicts into the shared snapshot", () => {
+        const record = createSyncProgressRecorder({ company: "acme", phase: "pull" });
+        record(planEvent(3, 0, 1)); // 3 to download + 1 to delete = 4 total
+        record({ type: "progress", path: "a.md", bytes: 10 });
+        record({ type: "progress", path: "b.md", bytes: 10 });
+        record({
+            type: "conflict",
+            path: "c.md",
+            direction: "pull",
+            resolution: "keep",
+        });
+        const snap = readSyncProgress();
+        expect(snap).not.toBeNull();
+        expect(snap.company).toBe("acme");
+        expect(snap.phase).toBe("pull");
+        expect(snap.filesTotal).toBe(4);
+        expect(snap.filesDone).toBe(2);
+        expect(snap.conflicts).toBe(1);
+        expect(snap.currentFile).toBe("b.md");
+        expect(snap.status).toBe("syncing");
+        expect(snap.pid).toBe(process.pid);
+        expect(typeof snap.updatedAt).toBe("string");
+    });
+    it("records the push leg + personal scope (company null)", () => {
+        const record = createSyncProgressRecorder({ company: null, phase: "push" });
+        record(planEvent(0, 5, 0));
+        const snap = readSyncProgress();
+        expect(snap.phase).toBe("push");
+        expect(snap.company).toBeNull();
+        expect(snap.filesTotal).toBe(5);
+    });
+    it("ignores non-progress events (no churn from new-files/reconciled)", () => {
+        const record = createSyncProgressRecorder({ company: "acme", phase: "pull" });
+        record(planEvent(1, 0, 0));
+        record({ type: "new-files", files: [] });
+        record({ type: "reconciled", path: "x.md", direction: "pull" });
+        const snap = readSyncProgress();
+        expect(snap.filesDone).toBe(0);
+        expect(snap.filesTotal).toBe(1);
+    });
+    /**
+     * REGRESSION: New Flow Test 1 (agt_529GZC4SD0874S43QR29FWCG1M) 2026-09-30.
+     * The indigo first pull planned 63805 downloads. 18 chat/attachments were
+     * denied at presign (FILES_PRESIGN_FORBIDDEN), which sync.ts's pull loop
+     * downgrades to a deliberate skip. The old recorder ignored every event
+     * except `progress`, so `filesDone` stopped at 63787 and the hq-console
+     * wizard's inactivity watch paged "0:41 without progress" forever even
+     * though the runner actually exited 0. Deliberate per-file skips must
+     * advance `filesDone` — the file was in the plan total, so counting it
+     * as done is the only truthful projection.
+     */
+    it("REGRESSION: deliberate per-file skips advance filesDone alongside progress", () => {
+        const record = createSyncProgressRecorder({ company: "indigo", phase: "pull" });
+        record(planEvent(20, 0, 0));
+        for (let i = 0; i < 2; i++) {
+            record({
+                type: "progress",
+                path: `f${i}.md`,
+                bytes: 1,
+            });
+        }
+        record({
+            type: "skip-access-denied",
+            path: "chat/attachments/chan/x/deny-1.png",
+            reason: "FILES_PRESIGN_FORBIDDEN",
+            message: "Access denied",
+        });
+        record({
+            type: "skip-access-denied",
+            path: "chat/attachments/chan/x/deny-2.png",
+            reason: "FILES_PRESIGN_FORBIDDEN",
+            message: "Access denied",
+        });
+        record({
+            type: "skip-vanished-remote",
+            path: "inbox/pending/vanished.json",
+            message: "not found",
+        });
+        record({
+            type: "skip-symlink-privilege",
+            path: "a-link",
+            target: "a-file",
+            remedy: "enable Developer Mode",
+        });
+        record({
+            type: "skip-rename-blocked",
+            path: "held-open.txt",
+            remedy: "close the app",
+        });
+        record({
+            type: "skip-archived-session-log",
+            path: "session-logs/archived.jsonl",
+        });
+        const snap = readSyncProgress();
+        expect(snap.filesTotal).toBe(20);
+        // 2 progress + 6 deliberate skips (2 access-denied + 1 vanished + 1
+        // symlink + 1 rename + 1 archived) = 8 done. A denied file MUST NOT
+        // leave filesDone < filesTotal forever.
+        expect(snap.filesDone).toBe(8);
+    });
+    it("REGRESSION (fanout): deliberate per-file skips advance filesDone across concurrent targets", () => {
+        const progress = createFanoutProgressRecorder();
+        progress.startTarget("indigo", "indigo", "pull");
+        progress.record("indigo", "pull", planEvent(3, 0, 0));
+        progress.record("indigo", "pull", {
+            type: "skip-access-denied",
+            path: "chat/attachments/chan/x/deny-1.png",
+            reason: "FILES_PRESIGN_FORBIDDEN",
+            message: "Access denied",
+        });
+        progress.record("indigo", "pull", {
+            type: "skip-vanished-remote",
+            path: "inbox/pending/x.json",
+            message: "not found",
+        });
+        progress.record("indigo", "pull", {
+            type: "progress",
+            path: "ok.md",
+            bytes: 1,
+        });
+        const snap = readSyncProgress();
+        expect(snap.filesTotal).toBe(3);
+        expect(snap.filesDone).toBe(3);
+        progress.finishTarget("indigo");
+        progress.dispose();
+    });
+    it("keeps one monotonic, live snapshot while concurrent fanout targets run", async () => {
+        vi.useFakeTimers();
+        try {
+            const progress = createFanoutProgressRecorder();
+            const totals = [];
+            progress.startTarget("acme", "acme", "push");
+            progress.record("acme", "push", planEvent(0, 5, 0));
+            totals.push(readSyncProgress().filesTotal);
+            progress.startTarget("personal", null, "push");
+            progress.record("personal", "push", planEvent(0, 4, 0));
+            totals.push(readSyncProgress().filesTotal);
+            expect(readSyncProgress().company).toBe("multiple");
+            progress.record("acme", "push", { type: "progress", path: "acme/a.md", bytes: 1 });
+            totals.push(readSyncProgress().filesTotal);
+            progress.finishTarget("acme");
+            totals.push(readSyncProgress().filesTotal);
+            expect(totals).toEqual([5, 9, 9, 9]);
+            await vi.advanceTimersByTimeAsync(3_000);
+            const whilePersonalPlans = readSyncProgress();
+            expect(whilePersonalPlans).toMatchObject({
+                status: "syncing",
+                filesTotal: 9,
+                filesDone: 1,
+            });
+            progress.finishTarget("personal");
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+});
+describe("sync-last-pass (the end-of-pass record a host app reads when it does not own the runner's stdout)", () => {
+    let stateDir;
+    beforeEach(() => {
+        stateDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-last-pass-test-"));
+        process.env.HQ_STATE_DIR = stateDir;
+    });
+    afterEach(() => {
+        delete process.env.HQ_STATE_DIR;
+        fs.rmSync(stateDir, { recursive: true, force: true });
+    });
+    const allComplete = { type: "all-complete", companiesAttempted: 1, conflictPaths: [], errors: [] };
+    it("returns null when no pass has finished", () => {
+        expect(readSyncLastPass()).toBeNull();
+    });
+    it("writes nothing until the pass completes", () => {
+        const recorder = createPassSummaryRecorder();
+        recorder.record({ type: "plan", company: "acme", filesToDownload: 1 });
+        recorder.record({ type: "progress", company: "acme", path: "a.md", bytes: 1 });
+        expect(fs.existsSync(syncLastPassPath())).toBe(false);
+    });
+    it("records the pass's events in order when all-complete arrives", () => {
+        const recorder = createPassSummaryRecorder();
+        const events = [
+            { type: "plan", company: "acme", filesToDownload: 1 },
+            { type: "progress", company: "acme", path: "a.md", bytes: 1 },
+            { type: "conflict", company: "acme", path: "c.md", direction: "pull" },
+            { type: "plan-limit", company: "acme", message: "over plan" },
+            { type: "error", company: "acme", path: "e.md", message: "boom" },
+            { type: "auth-error", company: "acme", message: "expired" },
+            { type: "complete", company: "acme", filesDownloaded: 1 },
+            allComplete,
+        ];
+        for (const event of events)
+            recorder.record(event);
+        const pass = readSyncLastPass();
+        expect(pass).toMatchObject({ schema: 1, pid: process.pid, droppedProgress: 0 });
+        expect(typeof pass.passId).toBe("string");
+        expect(Date.parse(pass.completedAt)).not.toBeNaN();
+        expect(pass.events).toEqual(events);
+    });
+    it("leaves out events a host app does not act on, and diagnostic errors", () => {
+        const recorder = createPassSummaryRecorder();
+        recorder.record({ type: "fanout-plan", companies: [] });
+        recorder.record({ type: "heartbeat" });
+        recorder.record({ type: "maintenance-progress", company: "acme", bytesProcessed: 1, totalBytes: 2 });
+        recorder.record({ type: "error", company: "acme", path: "x", message: "rate limited", diagnostic: true });
+        recorder.record(allComplete);
+        expect(readSyncLastPass().events).toEqual([allComplete]);
+    });
+    it("keeps the first progress events up to the cap and counts the rest", () => {
+        const recorder = createPassSummaryRecorder();
+        for (let i = 0; i < PASS_SUMMARY_MAX_PROGRESS + 5; i++) {
+            recorder.record({ type: "progress", company: "acme", path: `f${i}.md`, bytes: 1 });
+        }
+        recorder.record(allComplete);
+        const pass = readSyncLastPass();
+        expect(pass.events.filter((e) => e.type === "progress")).toHaveLength(PASS_SUMMARY_MAX_PROGRESS);
+        expect(pass.droppedProgress).toBe(5);
+    });
+    it("starts each pass fresh and gives it a new id", () => {
+        const recorder = createPassSummaryRecorder();
+        recorder.record({ type: "conflict", company: "acme", path: "c.md", direction: "pull" });
+        recorder.record(allComplete);
+        const first = readSyncLastPass();
+        recorder.record(allComplete);
+        const second = readSyncLastPass();
+        expect(second.passId).not.toBe(first.passId);
+        expect(second.events).toEqual([allComplete]);
+    });
+    it("does not touch the live progress snapshot", () => {
+        const recorder = createPassSummaryRecorder();
+        recorder.record(allComplete);
+        expect(readSyncProgress()).toBeNull();
+    });
+    it("treats an unreadable record as absent", () => {
+        fs.writeFileSync(syncLastPassPath(), "{not json");
+        expect(readSyncLastPass()).toBeNull();
+    });
+});
+//# sourceMappingURL=sync-progress.test.js.map

package/dist/sync-progress.test.js.map

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

package/dist/telemetry-events.test.d.ts

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

package/dist/telemetry-events.test.d.ts.map

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

package/dist/telemetry-events.test.js

@@ -0,0 +1,113 @@
+import { describe, expect, it, vi } from "vitest";
+import { emitCloudTelemetry, } from "./telemetry-events.js";
+describe("emitCloudTelemetry", () => {
+    it("is best-effort, stamps metadata, caps batches, and sanitizes properties", async () => {
+        const posts = [];
+        const client = {
+            postTelemetryEvents: vi.fn(async (batch) => {
+                posts.push(batch);
+                throw new Error("vault unavailable");
+            }),
+        };
+        const logs = [];
+        const events = Array.from({ length: 55 }, (_, i) => ({
+            eventName: `sync_completed_${i}`,
+            source: "hq-sync",
+            companyUid: "cmp_abc",
+            sessionId: "sync_123",
+            properties: i === 0
+                ? {
+                    fileCount: 2,
+                    result: "success",
+                    companyUid: "cmp_abc",
+                    labels: ["completed", "has spaces", "cmp_abc"],
+                    path: "/Users/alice/company/secret.md",
+                    filename: "secret.md",
+                    secretToken: "tok_123",
+                    message: "free text should not leave the process",
+                    unsafeLabel: "contains spaces",
+                    nanCount: Number.NaN,
+                    enabled: true,
+                    nested: { value: "nope" },
+                    "bad-key": "nope",
+                }
+                : { fileCount: i },
+        }));
+        await expect(emitCloudTelemetry(client, events, {
+            claims: {
+                "custom:entityType": "agent",
+                "custom:entityUid": "agt_runner",
+            },
+            timeoutMs: 25,
+            log: (message) => logs.push(message),
+        })).resolves.toBeUndefined();
+        expect(client.postTelemetryEvents).toHaveBeenCalledTimes(1);
+        expect(client.postTelemetryEvents).toHaveBeenCalledWith({ events: expect.any(Array) }, { timeoutMs: 25 });
+        expect(posts).toHaveLength(1);
+        expect(posts[0].events).toHaveLength(50);
+        const first = posts[0].events[0];
+        expect(first).toMatchObject({
+            eventName: "sync_completed_0",
+            app: "hq-cloud",
+            source: "hq-sync",
+            companyUid: "cmp_abc",
+            agentUid: "agt_runner",
+            sessionId: "sync_123",
+            schemaVersion: 1,
+            properties: {
+                fileCount: 2,
+                result: "success",
+                companyUid: "cmp_abc",
+                labels: ["completed", "cmp_abc"],
+            },
+        });
+        expect(Number.isNaN(Date.parse(first.occurredAt))).toBe(false);
+        expect(JSON.stringify(posts[0])).not.toContain("personUid");
+        expect(JSON.stringify(posts[0])).not.toContain("/Users/alice");
+        expect(JSON.stringify(posts[0])).not.toContain("secret.md");
+        expect(JSON.stringify(posts[0])).not.toContain("free text");
+        expect(JSON.stringify(posts[0])).not.toContain("tok_123");
+        expect(logs).toEqual(["[telemetry-events] postTelemetryEvents failed (Error)"]);
+        expect(logs.join("\n")).not.toContain("vault unavailable");
+    });
+    it("returns undefined and does not report an in-time post failure again", async () => {
+        const client = {
+            postTelemetryEvents: vi.fn(async () => {
+                const err = new Error("vault unavailable");
+                err.name = "VaultDown";
+                throw err;
+            }),
+        };
+        const logs = [];
+        await expect(emitCloudTelemetry(client, { eventName: "sync_completed", source: "hq-sync" }, { timeoutMs: 50, log: (message) => logs.push(message) })).resolves.toBeUndefined();
+        await flushMicrotasks();
+        expect(logs).toEqual(["[telemetry-events] postTelemetryEvents failed (VaultDown)"]);
+        expect(logs.join("\n")).not.toContain("after timeout");
+        expect(logs.join("\n")).not.toContain("vault unavailable");
+    });
+    it("returns undefined and reports a post failure that settles after the deadline once", async () => {
+        let rejectPost = () => { };
+        const client = {
+            postTelemetryEvents: vi.fn(() => new Promise((_resolve, reject) => {
+                rejectPost = reject;
+            })),
+        };
+        const logs = [];
+        await expect(emitCloudTelemetry(client, { eventName: "sync_completed", source: "hq-sync" }, { timeoutMs: 10, log: (message) => logs.push(message) })).resolves.toBeUndefined();
+        expect(logs).toEqual(["[telemetry-events] postTelemetryEvents failed (Error)"]);
+        const late = new TypeError("socket hang up");
+        rejectPost(late);
+        await flushMicrotasks();
+        expect(logs).toEqual([
+            "[telemetry-events] postTelemetryEvents failed (Error)",
+            "[telemetry-events] postTelemetryEvents failed after timeout (TypeError)",
+        ]);
+        expect(logs.filter((line) => line.includes("after timeout"))).toHaveLength(1);
+        expect(logs.join("\n")).not.toContain("socket hang up");
+    });
+});
+async function flushMicrotasks() {
+    await Promise.resolve();
+    await Promise.resolve();
+}
+//# sourceMappingURL=telemetry-events.test.js.map

package/dist/telemetry-events.test.js.map

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