@indigoai-us/hq-cloud 6.16.19 → 6.16.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (132) hide show
  1. package/dist/bin/sync-runner-installation-id.d.ts +66 -0
  2. package/dist/bin/sync-runner-installation-id.d.ts.map +1 -0
  3. package/dist/bin/sync-runner-installation-id.js +138 -0
  4. package/dist/bin/sync-runner-installation-id.js.map +1 -0
  5. package/dist/bin/sync-runner-manifest.d.ts +120 -0
  6. package/dist/bin/sync-runner-manifest.d.ts.map +1 -0
  7. package/dist/bin/sync-runner-manifest.js +348 -0
  8. package/dist/bin/sync-runner-manifest.js.map +1 -0
  9. package/dist/bin/sync-runner-manifest.test.d.ts +12 -0
  10. package/dist/bin/sync-runner-manifest.test.d.ts.map +1 -0
  11. package/dist/bin/sync-runner-manifest.test.js +510 -0
  12. package/dist/bin/sync-runner-manifest.test.js.map +1 -0
  13. package/dist/bin/sync-runner.d.ts +56 -21
  14. package/dist/bin/sync-runner.d.ts.map +1 -1
  15. package/dist/bin/sync-runner.js +86 -61
  16. package/dist/bin/sync-runner.js.map +1 -1
  17. package/dist/bin/sync-runner.test.js +217 -0
  18. package/dist/bin/sync-runner.test.js.map +1 -1
  19. package/dist/cli/share-presign-transport.test.d.ts +22 -0
  20. package/dist/cli/share-presign-transport.test.d.ts.map +1 -0
  21. package/dist/cli/share-presign-transport.test.js +237 -0
  22. package/dist/cli/share-presign-transport.test.js.map +1 -0
  23. package/dist/cli/share.d.ts.map +1 -1
  24. package/dist/cli/share.js +17 -3
  25. package/dist/cli/share.js.map +1 -1
  26. package/dist/cli/sync.d.ts.map +1 -1
  27. package/dist/cli/sync.js +9 -0
  28. package/dist/cli/sync.js.map +1 -1
  29. package/dist/cli/sync.test.js +123 -0
  30. package/dist/cli/sync.test.js.map +1 -1
  31. package/dist/company-slug.d.ts +31 -0
  32. package/dist/company-slug.d.ts.map +1 -0
  33. package/dist/company-slug.js +52 -0
  34. package/dist/company-slug.js.map +1 -0
  35. package/dist/company-slug.test.d.ts +7 -0
  36. package/dist/company-slug.test.d.ts.map +1 -0
  37. package/dist/company-slug.test.js +43 -0
  38. package/dist/company-slug.test.js.map +1 -0
  39. package/dist/company-vault-transport.d.ts +69 -0
  40. package/dist/company-vault-transport.d.ts.map +1 -0
  41. package/dist/company-vault-transport.js +89 -0
  42. package/dist/company-vault-transport.js.map +1 -0
  43. package/dist/company-vault-transport.test.d.ts +12 -0
  44. package/dist/company-vault-transport.test.d.ts.map +1 -0
  45. package/dist/company-vault-transport.test.js +97 -0
  46. package/dist/company-vault-transport.test.js.map +1 -0
  47. package/dist/index.d.ts +2 -0
  48. package/dist/index.d.ts.map +1 -1
  49. package/dist/index.js +5 -0
  50. package/dist/index.js.map +1 -1
  51. package/dist/journal-ledger-index.test.d.ts +15 -0
  52. package/dist/journal-ledger-index.test.d.ts.map +1 -0
  53. package/dist/journal-ledger-index.test.js +247 -0
  54. package/dist/journal-ledger-index.test.js.map +1 -0
  55. package/dist/journal.d.ts +110 -0
  56. package/dist/journal.d.ts.map +1 -1
  57. package/dist/journal.js +253 -5
  58. package/dist/journal.js.map +1 -1
  59. package/dist/manifest/US-002.acceptance.test.d.ts +11 -0
  60. package/dist/manifest/US-002.acceptance.test.d.ts.map +1 -0
  61. package/dist/manifest/US-002.acceptance.test.js +160 -0
  62. package/dist/manifest/US-002.acceptance.test.js.map +1 -0
  63. package/dist/manifest/US-004.acceptance.test.d.ts +12 -0
  64. package/dist/manifest/US-004.acceptance.test.d.ts.map +1 -0
  65. package/dist/manifest/US-004.acceptance.test.js +173 -0
  66. package/dist/manifest/US-004.acceptance.test.js.map +1 -0
  67. package/dist/manifest/build-manifest.bench.test.d.ts +22 -0
  68. package/dist/manifest/build-manifest.bench.test.d.ts.map +1 -0
  69. package/dist/manifest/build-manifest.bench.test.js +544 -0
  70. package/dist/manifest/build-manifest.bench.test.js.map +1 -0
  71. package/dist/manifest/build-manifest.d.ts +319 -0
  72. package/dist/manifest/build-manifest.d.ts.map +1 -0
  73. package/dist/manifest/build-manifest.js +1043 -0
  74. package/dist/manifest/build-manifest.js.map +1 -0
  75. package/dist/manifest/build-manifest.test.d.ts +10 -0
  76. package/dist/manifest/build-manifest.test.d.ts.map +1 -0
  77. package/dist/manifest/build-manifest.test.js +1060 -0
  78. package/dist/manifest/build-manifest.test.js.map +1 -0
  79. package/dist/manifest/contract.d.ts +290 -0
  80. package/dist/manifest/contract.d.ts.map +1 -0
  81. package/dist/manifest/contract.js +476 -0
  82. package/dist/manifest/contract.js.map +1 -0
  83. package/dist/manifest/contract.test.d.ts +17 -0
  84. package/dist/manifest/contract.test.d.ts.map +1 -0
  85. package/dist/manifest/contract.test.js +283 -0
  86. package/dist/manifest/contract.test.js.map +1 -0
  87. package/dist/manifest/import-graph.test.d.ts +25 -0
  88. package/dist/manifest/import-graph.test.d.ts.map +1 -0
  89. package/dist/manifest/import-graph.test.js +120 -0
  90. package/dist/manifest/import-graph.test.js.map +1 -0
  91. package/dist/manifest/ledger-shard-isolation.test.d.ts +18 -0
  92. package/dist/manifest/ledger-shard-isolation.test.d.ts.map +1 -0
  93. package/dist/manifest/ledger-shard-isolation.test.js +153 -0
  94. package/dist/manifest/ledger-shard-isolation.test.js.map +1 -0
  95. package/dist/manifest/snapshot-store.d.ts +143 -0
  96. package/dist/manifest/snapshot-store.d.ts.map +1 -0
  97. package/dist/manifest/snapshot-store.js +291 -0
  98. package/dist/manifest/snapshot-store.js.map +1 -0
  99. package/dist/manifest/snapshot-store.test.d.ts +11 -0
  100. package/dist/manifest/snapshot-store.test.d.ts.map +1 -0
  101. package/dist/manifest/snapshot-store.test.js +133 -0
  102. package/dist/manifest/snapshot-store.test.js.map +1 -0
  103. package/dist/manifest/upload-manifest.d.ts +301 -0
  104. package/dist/manifest/upload-manifest.d.ts.map +1 -0
  105. package/dist/manifest/upload-manifest.js +921 -0
  106. package/dist/manifest/upload-manifest.js.map +1 -0
  107. package/dist/manifest/upload-manifest.test.d.ts +10 -0
  108. package/dist/manifest/upload-manifest.test.d.ts.map +1 -0
  109. package/dist/manifest/upload-manifest.test.js +1052 -0
  110. package/dist/manifest/upload-manifest.test.js.map +1 -0
  111. package/dist/manifest-reconcile.d.ts.map +1 -1
  112. package/dist/manifest-reconcile.js +1 -26
  113. package/dist/manifest-reconcile.js.map +1 -1
  114. package/dist/posix-key.d.ts +36 -0
  115. package/dist/posix-key.d.ts.map +1 -0
  116. package/dist/posix-key.js +38 -0
  117. package/dist/posix-key.js.map +1 -0
  118. package/dist/s3.d.ts +2 -18
  119. package/dist/s3.d.ts.map +1 -1
  120. package/dist/s3.js +6 -20
  121. package/dist/s3.js.map +1 -1
  122. package/dist/sync/journal-ledger-stream.d.ts +56 -0
  123. package/dist/sync/journal-ledger-stream.d.ts.map +1 -0
  124. package/dist/sync/journal-ledger-stream.js +191 -0
  125. package/dist/sync/journal-ledger-stream.js.map +1 -0
  126. package/dist/sync/journal-ledger-stream.test.d.ts +12 -0
  127. package/dist/sync/journal-ledger-stream.test.d.ts.map +1 -0
  128. package/dist/sync/journal-ledger-stream.test.js +134 -0
  129. package/dist/sync/journal-ledger-stream.test.js.map +1 -0
  130. package/dist/types.d.ts +18 -7
  131. package/dist/types.d.ts.map +1 -1
  132. package/package.json +2 -1
@@ -218,6 +218,10 @@ function makeDeps(overrides = {}) {
218
218
  reconcileManifest: vi
219
219
  .fn()
220
220
  .mockResolvedValue({ written: false, added: [], updated: [], skipped: [] }),
221
+ // The US-004 manifest tail step is stubbed by default: the real one walks
222
+ // the HQ root and opens a socket, neither of which belongs in a runner
223
+ // unit test. Its own behavior is covered in sync-runner-manifest.test.ts.
224
+ runManifestUploads: vi.fn().mockResolvedValue([]),
221
225
  ...overrides,
222
226
  stdout,
223
227
  stderr,
@@ -12506,4 +12510,217 @@ describe("watcher delete intents without pre-seeded authorization", () => {
12506
12510
  await stopHarness(h);
12507
12511
  });
12508
12512
  });
12513
+ // ---------------------------------------------------------------------------
12514
+ // Post-sync manifest upload tail step (US-004)
12515
+ // ---------------------------------------------------------------------------
12516
+ describe("post-sync manifest upload hook", () => {
12517
+ const slugs = { cmp_a: "acme", cmp_b: "beta" };
12518
+ function twoCompanyVaultStub() {
12519
+ return makeVaultStub({
12520
+ memberships: [{ companyUid: "cmp_a" }, { companyUid: "cmp_b" }],
12521
+ entityGet: (uid) => Promise.resolve({
12522
+ uid,
12523
+ slug: slugs[uid] ?? uid,
12524
+ }),
12525
+ });
12526
+ }
12527
+ it("offers every cleanly-synced scope to the manifest pass, after all-complete", async () => {
12528
+ const runManifestUploads = vi
12529
+ .fn()
12530
+ .mockImplementation(async (options) => {
12531
+ options.emitEvent({
12532
+ company: "acme",
12533
+ scope: "company",
12534
+ status: "uploaded",
12535
+ mode: "full",
12536
+ chunkCount: 1,
12537
+ uploadedChunks: 1,
12538
+ });
12539
+ return [];
12540
+ });
12541
+ const deps = makeDeps({
12542
+ createVaultClient: () => twoCompanyVaultStub(),
12543
+ runManifestUploads,
12544
+ });
12545
+ const code = await runRunner(["--companies", "--hq-root", "/tmp/fake-hq"], deps);
12546
+ expect(code).toBe(0);
12547
+ expect(runManifestUploads).toHaveBeenCalledTimes(1);
12548
+ const passed = runManifestUploads.mock.calls[0][0];
12549
+ expect(passed.hqRoot).toBe("/tmp/fake-hq");
12550
+ expect([...passed.completedCompanySlugs].sort()).toEqual(["acme", "beta"]);
12551
+ expect(passed.targets.map((target) => target.slug).sort()).toEqual([
12552
+ "acme",
12553
+ "beta",
12554
+ ]);
12555
+ const types = deps.stdout.events().map((event) => event.type);
12556
+ expect(types).toContain("manifest-upload");
12557
+ // Strictly a TAIL step: it can never precede the run's completion event.
12558
+ expect(types.indexOf("manifest-upload")).toBeGreaterThan(types.indexOf("all-complete"));
12559
+ expect(deps.stdout.events().at(-1)).toEqual({
12560
+ type: "manifest-upload",
12561
+ company: "acme",
12562
+ scope: "company",
12563
+ status: "uploaded",
12564
+ mode: "full",
12565
+ chunkCount: 1,
12566
+ uploadedChunks: 1,
12567
+ });
12568
+ });
12569
+ it("withholds a scope whose sync leg aborted", async () => {
12570
+ const runManifestUploads = vi
12571
+ .fn()
12572
+ .mockResolvedValue([]);
12573
+ const deps = makeDeps({
12574
+ createVaultClient: () => twoCompanyVaultStub(),
12575
+ sync: vi
12576
+ .fn()
12577
+ .mockResolvedValueOnce(defaultSyncResult({ aborted: true, conflicts: 1 }))
12578
+ .mockResolvedValueOnce(defaultSyncResult()),
12579
+ runManifestUploads,
12580
+ });
12581
+ const code = await runRunner(["--companies", "--hq-root", "/tmp/fake-hq"], deps);
12582
+ expect(code).toBe(0);
12583
+ expect(runManifestUploads).toHaveBeenCalledTimes(1);
12584
+ expect([
12585
+ ...runManifestUploads.mock.calls[0][0].completedCompanySlugs,
12586
+ ]).toEqual(["beta"]);
12587
+ });
12588
+ it("withholds a scope whose sync leg threw, and still exits 2", async () => {
12589
+ const runManifestUploads = vi
12590
+ .fn()
12591
+ .mockResolvedValue([]);
12592
+ const deps = makeDeps({
12593
+ createVaultClient: () => twoCompanyVaultStub(),
12594
+ sync: vi
12595
+ .fn()
12596
+ .mockRejectedValueOnce(new Error("acme leg blew up"))
12597
+ .mockResolvedValueOnce(defaultSyncResult()),
12598
+ runManifestUploads,
12599
+ });
12600
+ const code = await runRunner(["--companies", "--hq-root", "/tmp/fake-hq"], deps);
12601
+ expect(code).toBe(2);
12602
+ expect([
12603
+ ...runManifestUploads.mock.calls[0][0].completedCompanySlugs,
12604
+ ]).toEqual(["beta"]);
12605
+ });
12606
+ /**
12607
+ * Containment regression (CI #489).
12608
+ *
12609
+ * The tail step used to report its housekeeping through the runner's shared
12610
+ * diagnostic helper, which writes `{type:"error"}` to stderr. On any host
12611
+ * with no enrolled client-health installation — every CI runner, and every
12612
+ * user who has not opened the menubar — a completely clean sync therefore
12613
+ * emitted an `error`, which the menubar forwards to Sentry.
12614
+ *
12615
+ * The invariant this pins: NO manifest failure of ANY kind may produce an
12616
+ * `error` event or change the sync's outcome. The tail may only describe
12617
+ * itself, via `manifest-upload` / `manifest-upload-diagnostic`.
12618
+ */
12619
+ describe("containment: a manifest failure never becomes a sync error", () => {
12620
+ const manifestOnly = new Set([
12621
+ "manifest-upload",
12622
+ "manifest-upload-diagnostic",
12623
+ ]);
12624
+ async function runControl() {
12625
+ const control = makeDeps({
12626
+ createVaultClient: () => twoCompanyVaultStub(),
12627
+ });
12628
+ const code = await runRunner(["--companies", "--hq-root", "/tmp/fake-hq"], control);
12629
+ return { control, code };
12630
+ }
12631
+ const failureModes = [
12632
+ {
12633
+ name: "the phase throws",
12634
+ runManifestUploads: async () => {
12635
+ throw new Error("manifest exploded");
12636
+ },
12637
+ },
12638
+ {
12639
+ name: "the phase rejects with a non-Error",
12640
+ runManifestUploads: async () => {
12641
+ throw "manifest exploded as a string";
12642
+ },
12643
+ },
12644
+ {
12645
+ name: "no enrolled installation is found",
12646
+ runManifestUploads: async (options) => {
12647
+ options.reportDiagnostic?.({
12648
+ event: "runner.manifest_upload.not_enrolled",
12649
+ message: "no enrolled client-health installation for this host; skipping manifest uploads",
12650
+ context: { stateDir: "/home/runner/state" },
12651
+ });
12652
+ return [];
12653
+ },
12654
+ },
12655
+ {
12656
+ name: "identity resolution throws",
12657
+ runManifestUploads: async (options) => {
12658
+ options.reportDiagnostic?.({
12659
+ event: "runner.manifest_upload.identity_failed",
12660
+ message: "enrolled installation lookup failed",
12661
+ err: new Error("EACCES"),
12662
+ });
12663
+ return [];
12664
+ },
12665
+ },
12666
+ {
12667
+ name: "a scope's pass reports failed",
12668
+ runManifestUploads: async (options) => {
12669
+ options.emitEvent({
12670
+ company: "acme",
12671
+ scope: "company",
12672
+ status: "failed",
12673
+ errorKind: "transport",
12674
+ });
12675
+ return [];
12676
+ },
12677
+ },
12678
+ ];
12679
+ for (const mode of failureModes) {
12680
+ it(`emits zero error events and leaves the sync unchanged when ${mode.name}`, async () => {
12681
+ const { control, code: controlCode } = await runControl();
12682
+ const deps = makeDeps({
12683
+ createVaultClient: () => twoCompanyVaultStub(),
12684
+ runManifestUploads: vi
12685
+ .fn()
12686
+ .mockImplementation(mode.runManifestUploads),
12687
+ });
12688
+ const code = await runRunner(["--companies", "--hq-root", "/tmp/fake-hq"], deps);
12689
+ // 1. The sync verdict is byte-identical to a run with a no-op tail.
12690
+ expect(code).toBe(controlCode);
12691
+ expect(deps.stdout.events().filter((event) => !manifestOnly.has(event.type))).toEqual(control.stdout
12692
+ .events()
12693
+ .filter((event) => !manifestOnly.has(event.type)));
12694
+ // 2. Not one error event, on either stream, from any failure mode.
12695
+ expect(deps.stderr.events().filter((event) => event.type === "error")).toEqual([]);
12696
+ expect(deps.stdout.events().filter((event) => event.type === "error")).toEqual([]);
12697
+ expect(deps.stderr.events()).toEqual(control.stderr.events());
12698
+ // 3. Whatever the tail said, it said under its own event types.
12699
+ for (const event of deps.stdout.events()) {
12700
+ if (event.type !== "manifest-upload" &&
12701
+ event.type !== "manifest-upload-diagnostic") {
12702
+ expect(control.stdout.events().map((e) => e.type)).toContain(event.type);
12703
+ }
12704
+ }
12705
+ });
12706
+ }
12707
+ it("describes a phase throw as a manifest-upload-diagnostic on stdout", async () => {
12708
+ const deps = makeDeps({
12709
+ createVaultClient: () => twoCompanyVaultStub(),
12710
+ runManifestUploads: vi
12711
+ .fn()
12712
+ .mockRejectedValue(new Error("manifest exploded")),
12713
+ });
12714
+ await runRunner(["--companies", "--hq-root", "/tmp/fake-hq"], deps);
12715
+ const diagnostics = deps.stdout
12716
+ .events()
12717
+ .filter((event) => event.type === "manifest-upload-diagnostic");
12718
+ expect(diagnostics).toHaveLength(1);
12719
+ expect(diagnostics[0]).toMatchObject({
12720
+ type: "manifest-upload-diagnostic",
12721
+ event: "runner.manifest_upload.failed",
12722
+ });
12723
+ });
12724
+ });
12725
+ });
12509
12726
  //# sourceMappingURL=sync-runner.test.js.map