@indigoai-us/hq-cloud 6.16.51-alpha.0 → 6.16.51

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 (157) hide show
  1. package/dist/backup-prune.d.ts +20 -0
  2. package/dist/backup-prune.d.ts.map +1 -1
  3. package/dist/backup-prune.js +62 -3
  4. package/dist/backup-prune.js.map +1 -1
  5. package/dist/backup-prune.test.js +25 -0
  6. package/dist/backup-prune.test.js.map +1 -1
  7. package/dist/bin/rescue-runner.js +2 -1
  8. package/dist/bin/rescue-runner.js.map +1 -1
  9. package/dist/bin/sync-runner-company.d.ts +0 -6
  10. package/dist/bin/sync-runner-company.d.ts.map +1 -1
  11. package/dist/bin/sync-runner-company.js +1 -30
  12. package/dist/bin/sync-runner-company.js.map +1 -1
  13. package/dist/bin/sync-runner-company.test.js +0 -55
  14. package/dist/bin/sync-runner-company.test.js.map +1 -1
  15. package/dist/bin/sync-runner-planning.d.ts +3 -12
  16. package/dist/bin/sync-runner-planning.d.ts.map +1 -1
  17. package/dist/bin/sync-runner-planning.js +3 -65
  18. package/dist/bin/sync-runner-planning.js.map +1 -1
  19. package/dist/bin/sync-runner-planning.test.js +1 -108
  20. package/dist/bin/sync-runner-planning.test.js.map +1 -1
  21. package/dist/bin/sync-runner-watch-loop.d.ts +2 -48
  22. package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
  23. package/dist/bin/sync-runner-watch-loop.js +113 -281
  24. package/dist/bin/sync-runner-watch-loop.js.map +1 -1
  25. package/dist/bin/sync-runner.d.ts +5 -33
  26. package/dist/bin/sync-runner.d.ts.map +1 -1
  27. package/dist/bin/sync-runner.js +4 -34
  28. package/dist/bin/sync-runner.js.map +1 -1
  29. package/dist/bin/sync-runner.test.js +78 -555
  30. package/dist/bin/sync-runner.test.js.map +1 -1
  31. package/dist/cli/rescue-breaker.test.d.ts +2 -0
  32. package/dist/cli/rescue-breaker.test.d.ts.map +1 -0
  33. package/dist/cli/rescue-breaker.test.js +334 -0
  34. package/dist/cli/rescue-breaker.test.js.map +1 -0
  35. package/dist/cli/rescue-core.d.ts +40 -0
  36. package/dist/cli/rescue-core.d.ts.map +1 -1
  37. package/dist/cli/rescue-core.js +1205 -109
  38. package/dist/cli/rescue-core.js.map +1 -1
  39. package/dist/cli/rescue-realpath.test.d.ts +2 -0
  40. package/dist/cli/rescue-realpath.test.d.ts.map +1 -0
  41. package/dist/cli/rescue-realpath.test.js +109 -0
  42. package/dist/cli/rescue-realpath.test.js.map +1 -0
  43. package/dist/cli/rescue-rsync-preflight.test.js +256 -4
  44. package/dist/cli/rescue-rsync-preflight.test.js.map +1 -1
  45. package/dist/cli/rescue-snapshot-copy.test.d.ts +2 -0
  46. package/dist/cli/rescue-snapshot-copy.test.d.ts.map +1 -0
  47. package/dist/cli/rescue-snapshot-copy.test.js +435 -0
  48. package/dist/cli/rescue-snapshot-copy.test.js.map +1 -0
  49. package/dist/cli/rescue-snapshot-recovery.test.d.ts +2 -0
  50. package/dist/cli/rescue-snapshot-recovery.test.d.ts.map +1 -0
  51. package/dist/cli/rescue-snapshot-recovery.test.js +260 -0
  52. package/dist/cli/rescue-snapshot-recovery.test.js.map +1 -0
  53. package/dist/cli/rescue-source-switch-floor.test.d.ts +2 -0
  54. package/dist/cli/rescue-source-switch-floor.test.d.ts.map +1 -0
  55. package/dist/cli/rescue-source-switch-floor.test.js +210 -0
  56. package/dist/cli/rescue-source-switch-floor.test.js.map +1 -0
  57. package/dist/cli/rescue.d.ts +4 -0
  58. package/dist/cli/rescue.d.ts.map +1 -1
  59. package/dist/cli/rescue.js +20 -1
  60. package/dist/cli/rescue.js.map +1 -1
  61. package/dist/cli/rescue.test.js +16 -1
  62. package/dist/cli/rescue.test.js.map +1 -1
  63. package/dist/cli/share-presign-transport.test.js +2 -0
  64. package/dist/cli/share-presign-transport.test.js.map +1 -1
  65. package/dist/cli/share.d.ts +0 -19
  66. package/dist/cli/share.d.ts.map +1 -1
  67. package/dist/cli/share.js +37 -57
  68. package/dist/cli/share.js.map +1 -1
  69. package/dist/cli/share.test.js +93 -87
  70. package/dist/cli/share.test.js.map +1 -1
  71. package/dist/cli/sync-scope.test.js +0 -8
  72. package/dist/cli/sync-scope.test.js.map +1 -1
  73. package/dist/cli/sync.d.ts +0 -12
  74. package/dist/cli/sync.d.ts.map +1 -1
  75. package/dist/cli/sync.js +118 -226
  76. package/dist/cli/sync.js.map +1 -1
  77. package/dist/cli/sync.test.js +2 -215
  78. package/dist/cli/sync.test.js.map +1 -1
  79. package/dist/cli/watch-event-push-conflict.test.js +2 -0
  80. package/dist/cli/watch-event-push-conflict.test.js.map +1 -1
  81. package/dist/cognito-auth.d.ts +30 -0
  82. package/dist/cognito-auth.d.ts.map +1 -1
  83. package/dist/cognito-auth.js +175 -0
  84. package/dist/cognito-auth.js.map +1 -1
  85. package/dist/index.d.ts +2 -2
  86. package/dist/index.d.ts.map +1 -1
  87. package/dist/index.js +1 -1
  88. package/dist/index.js.map +1 -1
  89. package/dist/journal-store.test.js +7 -130
  90. package/dist/journal-store.test.js.map +1 -1
  91. package/dist/journal.d.ts +1 -9
  92. package/dist/journal.d.ts.map +1 -1
  93. package/dist/journal.js +21 -30
  94. package/dist/journal.js.map +1 -1
  95. package/dist/lib/exit-codes.d.ts +0 -15
  96. package/dist/lib/exit-codes.d.ts.map +1 -1
  97. package/dist/lib/exit-codes.js +0 -15
  98. package/dist/lib/exit-codes.js.map +1 -1
  99. package/dist/machine-auth.test.js +295 -0
  100. package/dist/machine-auth.test.js.map +1 -1
  101. package/dist/object-io.d.ts +2 -2
  102. package/dist/object-io.d.ts.map +1 -1
  103. package/dist/object-io.js +18 -3
  104. package/dist/object-io.js.map +1 -1
  105. package/dist/personal-vault.d.ts.map +1 -1
  106. package/dist/personal-vault.js +3 -10
  107. package/dist/personal-vault.js.map +1 -1
  108. package/dist/personal-vault.test.js +0 -35
  109. package/dist/personal-vault.test.js.map +1 -1
  110. package/dist/remote-pull.d.ts.map +1 -1
  111. package/dist/remote-pull.js +2 -9
  112. package/dist/remote-pull.js.map +1 -1
  113. package/dist/remote-pull.test.js +2 -59
  114. package/dist/remote-pull.test.js.map +1 -1
  115. package/dist/s3.d.ts +18 -1
  116. package/dist/s3.d.ts.map +1 -1
  117. package/dist/s3.js +47 -24
  118. package/dist/s3.js.map +1 -1
  119. package/dist/s3.test.js +27 -1
  120. package/dist/s3.test.js.map +1 -1
  121. package/dist/sync/realtime-telemetry.d.ts +1 -1
  122. package/dist/sync/realtime-telemetry.d.ts.map +1 -1
  123. package/dist/sync/realtime-telemetry.js +6 -14
  124. package/dist/sync/realtime-telemetry.js.map +1 -1
  125. package/dist/sync/realtime-telemetry.test.js +16 -136
  126. package/dist/sync/realtime-telemetry.test.js.map +1 -1
  127. package/dist/sync-core.d.ts +6 -4
  128. package/dist/sync-core.d.ts.map +1 -1
  129. package/dist/sync-core.js +10 -4
  130. package/dist/sync-core.js.map +1 -1
  131. package/dist/sync-core.test.js +25 -1
  132. package/dist/sync-core.test.js.map +1 -1
  133. package/package.json +1 -2
  134. package/dist/cli/onepass-pull-planner-regressions.test.d.ts +0 -2
  135. package/dist/cli/onepass-pull-planner-regressions.test.d.ts.map +0 -1
  136. package/dist/cli/onepass-pull-planner-regressions.test.js +0 -300
  137. package/dist/cli/onepass-pull-planner-regressions.test.js.map +0 -1
  138. package/dist/cli/onepass-pull-planner.test.d.ts +0 -2
  139. package/dist/cli/onepass-pull-planner.test.d.ts.map +0 -1
  140. package/dist/cli/onepass-pull-planner.test.js +0 -266
  141. package/dist/cli/onepass-pull-planner.test.js.map +0 -1
  142. package/dist/cli/streaming-pull-planner.bench.test.d.ts +0 -15
  143. package/dist/cli/streaming-pull-planner.bench.test.d.ts.map +0 -1
  144. package/dist/cli/streaming-pull-planner.bench.test.js +0 -273
  145. package/dist/cli/streaming-pull-planner.bench.test.js.map +0 -1
  146. package/dist/s3.list-cost.test.d.ts +0 -2
  147. package/dist/s3.list-cost.test.d.ts.map +0 -1
  148. package/dist/s3.list-cost.test.js +0 -51
  149. package/dist/s3.list-cost.test.js.map +0 -1
  150. package/dist/sync/remote-file-spool.d.ts +0 -16
  151. package/dist/sync/remote-file-spool.d.ts.map +0 -1
  152. package/dist/sync/remote-file-spool.js +0 -91
  153. package/dist/sync/remote-file-spool.js.map +0 -1
  154. package/dist/sync/remote-file-spool.test.d.ts +0 -2
  155. package/dist/sync/remote-file-spool.test.d.ts.map +0 -1
  156. package/dist/sync/remote-file-spool.test.js +0 -77
  157. package/dist/sync/remote-file-spool.test.js.map +0 -1
@@ -4,53 +4,7 @@ import { type FeatureSwitch } from "../sync/feature-flags.js";
4
4
  import { HeapCensus } from "./sync-runner-heap-telemetry.js";
5
5
  import type { TelemetryClaims } from "../telemetry-events.js";
6
6
  import type { JournalEntry } from "../types.js";
7
- import type { CooperativePassCheckpoint, Direction, RunnerLoopDeps, RunnerPassOutcome } from "./sync-runner.js";
8
- /** A deferred full chore must get the next admission after this long. */
9
- export declare const CHORE_STARVATION_CAP_MS: number;
10
- export type GuardedWorkClass = "realtime" | "chore";
11
- export interface GuardedPassContext {
12
- /**
13
- * A durable boundary in a chore. While the chore awaits this promise it
14
- * owns no mutable pass state, so queued realtime work can use the existing
15
- * root lock under a single-flight cooperative hand-off.
16
- */
17
- checkpoint: CooperativePassCheckpoint;
18
- }
19
- /**
20
- * One durable-state owner at a time for a full chore. Realtime work never runs
21
- * beside that chore: it explicitly awaits `checkpoint()` after a completed
22
- * durable unit, then resumes once the hand-off is finished. A separately
23
- * tracked, explicitly opted-in watcher fast pass may use the pre-existing
24
- * scoped fast-over-slow exception, but never while a chore owns durable state.
25
- */
26
- export declare class CooperativePassScheduler<T> {
27
- private readonly now;
28
- private readonly starvationCapMs;
29
- private readonly pending;
30
- private active;
31
- private activeFastRealtime;
32
- private stopped;
33
- private _handoffActive;
34
- constructor(now: () => number, starvationCapMs?: number);
35
- get handoffActive(): boolean;
36
- get hasActiveChore(): boolean;
37
- get hasActiveSlowRealtime(): boolean;
38
- pendingLaneCount(lane: "fast" | "slow"): number;
39
- submit(task: (context: GuardedPassContext) => Promise<T>, workClass: GuardedWorkClass, lane?: "fast" | "slow", allowFastRealtimeOvertake?: boolean): Promise<T>;
40
- stop(): void;
41
- private drain;
42
- private takeNext;
43
- private nextRealtimeIndex;
44
- private nextFastRealtime;
45
- private hasStarvedChore;
46
- private canStartFastRealtime;
47
- private start;
48
- private complete;
49
- private startFastRealtime;
50
- private completeFastRealtime;
51
- private execute;
52
- private checkpoint;
53
- }
7
+ import type { Direction, RunnerLoopDeps, RunnerPassOutcome } from "./sync-runner.js";
54
8
  /**
55
9
  * Area storage is AUTO by default and only applies after durable cutover.
56
10
  * Pass the env switch (`auto`/`on`/`off`) or a boolean force-on/force-off.
@@ -224,7 +178,7 @@ export interface ParsedLoopArgs {
224
178
  direction?: Direction;
225
179
  }
226
180
  export interface WatchLoopRuntime {
227
- runPassWithOperationLockAlreadyHeld: (passArgv: string[], checkpoint?: CooperativePassCheckpoint) => Promise<number | RunnerPassOutcome>;
181
+ runPassWithOperationLockAlreadyHeld: (passArgv: string[]) => Promise<number | RunnerPassOutcome>;
228
182
  authRequiredPassExit: number;
229
183
  defaultGetIdTokenClaims: () => ({
230
184
  email?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"sync-runner-watch-loop.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-watch-loop.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sync-runner-watch-loop.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-watch-loop.ts"],"names":[],"mappings":"AAqBA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAUL,WAAW,EAMZ,MAAM,eAAe,CAAC;AAavB,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AASlC,OAAO,EACL,UAAU,EA0CX,MAAM,iCAAiC,CAAC;AAUzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhD,OAAO,KAAK,EACV,SAAS,EAET,cAAc,EACd,iBAAiB,EAElB,MAAM,kBAAkB,CAAC;AAK1B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,OAAO,GAAG,aAAa,EACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAkDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AACrE,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AACrE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAC/E,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,2BAA2B,QAAkB,CAAC;AAC3D;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,QAAa,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAU5E;AAUD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAmC1C,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;IACtC,kEAAkE;IAClE,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzD,qEAAqE;IACrE,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU,CAY9E;AAED,wBAAgB,qBAAqB,IAAI;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CASA;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE,CAAC,EAAE,CAAC;CACX;AAiDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG;IAC3D,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CAC9B,CA4BA;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GACtD,OAAO,CAyBT;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAMR;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAiC/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AACjE,eAAO,MAAM,yBAAyB,EAAE,MAAM,GAAG,SAAuB,CAAC;AAEzE,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,GAAG,SAAS,CAOpB;AAiBD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,QAAa,CAAC;AACvD,kFAAkF;AAClF,eAAO,MAAM,gCAAgC,QAAc,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAA+B,EACxC,MAAM,GAAE,MAA8B,GACrC,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,qBAAqB,EAAE,OAAO,EAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUxC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC,EAAE,CACnC,QAAQ,EAAE,MAAM,EAAE,KACf,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC;IAC7E,qBAAqB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,GAAG,WAAW,GAC3B,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CASvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iDAAiD,CAC/D,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,EACzC,gBAAgB,EAAE,MAAM,GACvB,MAAM,GAAG,SAAS,CAOpB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAIT;AA6BD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAyjGjB"}
@@ -10,7 +10,7 @@ import { pickCanonicalPersonEntity } from "../vault-client.js";
10
10
  import { acquireOperationLock, withOperationLock, withOperationLockSync, OperationLockedError, OPERATION_LOCKED_EXIT, } from "../operation-lock.js";
11
11
  import { describeError } from "../lib/describe-error.js";
12
12
  import { TRANSIENT_NETWORK_EXIT } from "../lib/net-errors.js";
13
- import { PARTIAL_SYNC_EXIT, UNRESOLVED_COMPANY_EXIT, } from "../lib/exit-codes.js";
13
+ import { PARTIAL_SYNC_EXIT } from "../lib/exit-codes.js";
14
14
  import { getOrCreateMachineId } from "../lib/machine-id.js";
15
15
  import { localPathForVaultKey } from "../local-path-codec.js";
16
16
  import { TreeWatcher, resolveEventDebounceConfig, systemClock, } from "../watcher.js";
@@ -30,219 +30,6 @@ import { InlineSyncWorkerAdapter, } from "../sync/sync-work.js";
30
30
  import { buildRoutePullArgv, buildScopedPushArgv, buildScopedDrainPullArgv, buildTargetedPullArgv, isWatchRouteSelected, routeChangeToTarget, routeKey, } from "./sync-runner-watch-routes.js";
31
31
  import { resolveSkipCompanies } from "./sync-runner-planning.js";
32
32
  const FULL_RECONCILE_EVERY_TICKS = 10;
33
- /** A deferred full chore must get the next admission after this long. */
34
- export const CHORE_STARVATION_CAP_MS = 15 * 60 * 1000;
35
- /**
36
- * One durable-state owner at a time for a full chore. Realtime work never runs
37
- * beside that chore: it explicitly awaits `checkpoint()` after a completed
38
- * durable unit, then resumes once the hand-off is finished. A separately
39
- * tracked, explicitly opted-in watcher fast pass may use the pre-existing
40
- * scoped fast-over-slow exception, but never while a chore owns durable state.
41
- */
42
- export class CooperativePassScheduler {
43
- now;
44
- starvationCapMs;
45
- pending = [];
46
- active = null;
47
- // Scoped fast realtime work has the established in-process lock exception
48
- // while a scoped slow realtime upload is in flight. Keep that slot separate
49
- // from `active`: a chore still has exactly one durable-state owner.
50
- activeFastRealtime = null;
51
- stopped = false;
52
- _handoffActive = false;
53
- constructor(now, starvationCapMs = CHORE_STARVATION_CAP_MS) {
54
- this.now = now;
55
- this.starvationCapMs = starvationCapMs;
56
- }
57
- get handoffActive() {
58
- return this._handoffActive;
59
- }
60
- get hasActiveChore() {
61
- return this.active?.workClass === "chore";
62
- }
63
- get hasActiveSlowRealtime() {
64
- return this.active?.workClass === "realtime" && this.active.lane === "slow";
65
- }
66
- pendingLaneCount(lane) {
67
- return this.pending.filter((entry) => entry.lane === lane).length;
68
- }
69
- submit(task, workClass, lane = "slow", allowFastRealtimeOvertake = false) {
70
- if (this.stopped)
71
- return Promise.resolve(0);
72
- const directEntry = {
73
- task,
74
- workClass,
75
- lane,
76
- allowFastRealtimeOvertake,
77
- // An immediately admitted task cannot starve, so avoid sampling the
78
- // cadence clock merely to stamp it. This preserves the loop's deadline
79
- // accounting and keeps the timestamp meaningful only for real queues.
80
- enqueuedAt: 0,
81
- resolve: () => undefined,
82
- reject: () => undefined,
83
- };
84
- if (this.canStartFastRealtime(directEntry)) {
85
- return this.startFastRealtime(directEntry);
86
- }
87
- if (this.active === null &&
88
- this.activeFastRealtime === null &&
89
- this.pending.length === 0) {
90
- return this.start(directEntry);
91
- }
92
- return new Promise((resolve, reject) => {
93
- const entry = { ...directEntry, enqueuedAt: this.now(), resolve, reject };
94
- this.pending.push(entry);
95
- this.drain();
96
- });
97
- }
98
- stop() {
99
- this.stopped = true;
100
- while (this.pending.length > 0)
101
- this.pending.shift()?.resolve(0);
102
- }
103
- drain() {
104
- if (this.stopped || this.pending.length === 0)
105
- return;
106
- if (this.active !== null) {
107
- const fastRealtime = this.nextFastRealtime();
108
- if (fastRealtime && this.canStartFastRealtime(fastRealtime)) {
109
- this.pending.splice(this.pending.indexOf(fastRealtime), 1);
110
- this.startFastRealtime(fastRealtime);
111
- }
112
- return;
113
- }
114
- if (this.activeFastRealtime !== null)
115
- return;
116
- const next = this.takeNext();
117
- if (next)
118
- this.start(next);
119
- }
120
- takeNext() {
121
- const now = this.now();
122
- const starvedChore = this.pending.findIndex((entry) => entry.workClass === "chore" && now - entry.enqueuedAt >= this.starvationCapMs);
123
- if (starvedChore >= 0)
124
- return this.pending.splice(starvedChore, 1)[0];
125
- // A receiver's bulk drain is still realtime work, but its slow lane is the
126
- // progress boundary for that delivery. Preserve its established turn
127
- // before refilling later fast realtime arrivals; this does not let a
128
- // chore overtake any realtime work.
129
- const realtime = this.nextRealtimeIndex();
130
- if (realtime >= 0)
131
- return this.pending.splice(realtime, 1)[0];
132
- return this.pending.shift();
133
- }
134
- nextRealtimeIndex() {
135
- const slowRealtime = this.pending.findIndex((entry) => entry.workClass === "realtime" && entry.lane === "slow");
136
- return slowRealtime >= 0
137
- ? slowRealtime
138
- : this.pending.findIndex((entry) => entry.workClass === "realtime");
139
- }
140
- nextFastRealtime() {
141
- return this.pending.find((entry) => entry.workClass === "realtime" && entry.lane === "fast");
142
- }
143
- hasStarvedChore() {
144
- const now = this.now();
145
- return this.pending.some((entry) => entry.workClass === "chore" && now - entry.enqueuedAt >= this.starvationCapMs);
146
- }
147
- canStartFastRealtime(entry) {
148
- return (!this._handoffActive &&
149
- this.activeFastRealtime === null &&
150
- entry.workClass === "realtime" &&
151
- entry.lane === "fast" &&
152
- entry.allowFastRealtimeOvertake &&
153
- this.hasActiveSlowRealtime &&
154
- !this.hasStarvedChore());
155
- }
156
- start(entry) {
157
- this.active = entry;
158
- let current;
159
- try {
160
- current = this.execute(entry);
161
- }
162
- catch (error) {
163
- current = Promise.reject(error);
164
- }
165
- void current.then((outcome) => {
166
- entry.resolve(outcome);
167
- this.complete(entry);
168
- }, (error) => {
169
- entry.reject(error);
170
- this.complete(entry);
171
- }).catch(() => undefined);
172
- return current;
173
- }
174
- complete(entry) {
175
- if (this.active === entry)
176
- this.active = null;
177
- this.drain();
178
- }
179
- startFastRealtime(entry) {
180
- this.activeFastRealtime = entry;
181
- let current;
182
- try {
183
- current = this.execute(entry);
184
- }
185
- catch (error) {
186
- current = Promise.reject(error);
187
- }
188
- void current.then((outcome) => {
189
- entry.resolve(outcome);
190
- this.completeFastRealtime(entry);
191
- }, (error) => {
192
- entry.reject(error);
193
- this.completeFastRealtime(entry);
194
- });
195
- return current;
196
- }
197
- completeFastRealtime(entry) {
198
- if (this.activeFastRealtime === entry)
199
- this.activeFastRealtime = null;
200
- this.drain();
201
- }
202
- execute(entry) {
203
- return entry.task({ checkpoint: () => this.checkpoint(entry) });
204
- }
205
- async checkpoint(entry) {
206
- if (this.stopped ||
207
- entry.workClass !== "chore" ||
208
- this.active !== entry ||
209
- !this.pending.some((pending) => pending.workClass === "realtime")) {
210
- return false;
211
- }
212
- // `entry` is suspended at a caller-declared durable boundary. It remains
213
- // the sole full-pass continuation and will resume after this bounded burst.
214
- const deferredAt = this.now();
215
- this.active = null;
216
- this._handoffActive = true;
217
- let handedOff = false;
218
- try {
219
- while (!this.stopped && this.now() - deferredAt < this.starvationCapMs) {
220
- const realtimeIndex = this.nextRealtimeIndex();
221
- if (realtimeIndex < 0)
222
- break;
223
- const realtime = this.pending.splice(realtimeIndex, 1)[0];
224
- handedOff = true;
225
- this.active = realtime;
226
- try {
227
- realtime.resolve(await this.execute(realtime));
228
- }
229
- catch (error) {
230
- realtime.reject(error);
231
- }
232
- finally {
233
- if (this.active === realtime)
234
- this.active = null;
235
- }
236
- }
237
- }
238
- finally {
239
- this._handoffActive = false;
240
- if (!this.stopped)
241
- this.active = entry;
242
- }
243
- return handedOff;
244
- }
245
- }
246
33
  const MAX_FULL_RECONCILE_REASONS = 7;
247
34
  /**
248
35
  * Area storage is AUTO by default and only applies after durable cutover.
@@ -722,7 +509,6 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
722
509
  const idleHeartbeatIntervalMs = deps.idleHeartbeatIntervalMs ?? WATCH_IDLE_HEARTBEAT_INTERVAL_MS;
723
510
  const monotonicNow = deps.monotonicNow ?? (() => performance.now());
724
511
  const runPass = deps.runPass ?? runtime.runPassWithOperationLockAlreadyHeld;
725
- const runPassSupportsCooperativeCheckpoint = deps.runPass === undefined || deps.runPassSupportsCooperativeCheckpoint === true;
726
512
  const pollIdx = argv.indexOf("--poll-remote-ms");
727
513
  // An explicit --poll-remote-ms pins a fixed interval (menubar/CLI still set
728
514
  // one). When it is omitted, the interval is resolved fresh each cycle from
@@ -886,11 +672,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
886
672
  resolveNoOperationLockUsers = resolve;
887
673
  });
888
674
  };
889
- const passScheduler = new CooperativePassScheduler(monotonicNow);
890
- const runPassWithLock = async (passArgvForRun, prepare, lane = "slow", workClass = "chore", checkpoint) => {
891
- const invokePass = () => checkpoint !== undefined && runPassSupportsCooperativeCheckpoint
892
- ? runPass(passArgvForRun, checkpoint)
893
- : runPass(passArgvForRun);
675
+ const runPassWithLock = async (passArgvForRun, prepare, lane = "slow") => {
894
676
  // Observe the heap at pass boundaries — a gated checkpoint immediately before
895
677
  // admitting a pass and immediately after it returns. A pass that runs a long
896
678
  // synchronous stretch starves the interval timer, so these boundary
@@ -913,31 +695,13 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
913
695
  // its keyed journal delta and per-object mutation are independent from the
914
696
  // slow pass's bulk paths, and the slow pass already owns the root lock.
915
697
  // Never bypass the lock when no slow pass is active.
916
- if (
917
- // A full chore is paused at a caller-declared durable checkpoint. Keep
918
- // the root lock held by this process, but lend it to exactly one
919
- // realtime pass; the suspended chore cannot mutate until this returns.
920
- workClass === "realtime" &&
921
- passScheduler.handoffActive &&
922
- processOwnsOperationLock) {
923
- acquireOperationLockUser();
924
- try {
925
- prepare?.();
926
- const outcome = await invokePass();
927
- recordAppliedUpserts(outcome);
928
- return outcome;
929
- }
930
- finally {
931
- releaseOperationLockUser();
932
- }
933
- }
934
698
  if (lane === "fast" &&
935
699
  processOwnsOperationLock &&
936
700
  coordinatorWholeMutationChores === 0) {
937
701
  acquireOperationLockUser();
938
702
  try {
939
703
  prepare?.();
940
- const outcome = await invokePass();
704
+ const outcome = await runPass(passArgvForRun);
941
705
  recordAppliedUpserts(outcome);
942
706
  return outcome;
943
707
  }
@@ -957,7 +721,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
957
721
  acquireOperationLockUser();
958
722
  }
959
723
  prepare?.();
960
- const outcome = await invokePass();
724
+ const outcome = await runPass(passArgvForRun);
961
725
  recordAppliedUpserts(outcome);
962
726
  return outcome;
963
727
  }
@@ -991,7 +755,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
991
755
  }
992
756
  try {
993
757
  prepare?.();
994
- const outcome = await invokePass();
758
+ const outcome = await runPass(passArgvForRun);
995
759
  recordAppliedUpserts(outcome);
996
760
  return outcome;
997
761
  }
@@ -1014,18 +778,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
1014
778
  throw err;
1015
779
  }
1016
780
  };
1017
- const runTaskWithLock = async (task, workClass = "chore") => {
1018
- if (workClass === "realtime" &&
1019
- passScheduler.handoffActive &&
1020
- processOwnsOperationLock) {
1021
- acquireOperationLockUser();
1022
- try {
1023
- return await task();
1024
- }
1025
- finally {
1026
- releaseOperationLockUser();
1027
- }
1028
- }
781
+ const runTaskWithLock = async (task) => {
1029
782
  try {
1030
783
  const handle = acquireOperationLock(hqRoot, "sync", {
1031
784
  timeoutSec: 0,
@@ -1119,15 +872,102 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
1119
872
  heapCheckpoint?.();
1120
873
  }
1121
874
  };
875
+ let activeSlowPass = null;
876
+ let activeFastPass = null;
877
+ const pendingSlowPasses = [];
878
+ const pendingFastPasses = [];
1122
879
  const resolveStoppedQueue = () => {
1123
- passScheduler.stop();
880
+ for (const queue of [pendingFastPasses, pendingSlowPasses]) {
881
+ while (queue.length > 0)
882
+ queue.shift()?.resolve(0);
883
+ }
884
+ };
885
+ const drainQueuedPasses = () => {
886
+ if (stopped) {
887
+ resolveStoppedQueue();
888
+ return;
889
+ }
890
+ // A queued slow pass is the bulk-drain progress boundary. Admit it before
891
+ // refilling the realtime queue; otherwise a steady stream of fast work
892
+ // perpetually leapfrogs a receiver's bulk batch and its SQS poll loop
893
+ // cannot issue another receive.
894
+ if (activeSlowPass === null &&
895
+ activeFastPass === null &&
896
+ pendingSlowPasses.length > 0) {
897
+ const slow = pendingSlowPasses.shift();
898
+ if (slow) {
899
+ const current = startGuardedTask(slow.task, "slow");
900
+ void current.then(slow.resolve, slow.reject);
901
+ }
902
+ }
903
+ if (activeFastPass === null) {
904
+ const fast = pendingFastPasses.shift();
905
+ if (fast) {
906
+ const current = startGuardedTask(fast.task, "fast");
907
+ void current.then(fast.resolve, fast.reject);
908
+ }
909
+ }
910
+ // A fast pass that acquired the operation lock normally (rather than
911
+ // bypassing an in-process slow holder) still owns the cross-process
912
+ // boundary. Slow work must queue behind it; only fast work is allowed to
913
+ // overlap an already-lock-owning slow pass.
914
+ if (activeSlowPass === null && activeFastPass === null) {
915
+ const slow = pendingSlowPasses.shift();
916
+ if (slow) {
917
+ const current = startGuardedTask(slow.task, "slow");
918
+ void current.then(slow.resolve, slow.reject);
919
+ }
920
+ }
921
+ };
922
+ const startGuardedTask = (task, lane) => {
923
+ // Claim the lane before invoking `task`: a task can synchronously activate
924
+ // a watcher/scheduler callback before returning its promise. Without this
925
+ // placeholder that re-entrant callback sees an idle lane and starts a
926
+ // second lock contender.
927
+ const placeholder = Promise.resolve(0);
928
+ if (lane === "fast")
929
+ activeFastPass = placeholder;
930
+ else
931
+ activeSlowPass = placeholder;
932
+ let current;
933
+ try {
934
+ current = stopped ? placeholder : task();
935
+ }
936
+ catch (err) {
937
+ current = Promise.reject(err);
938
+ }
939
+ if (lane === "fast")
940
+ activeFastPass = current;
941
+ else
942
+ activeSlowPass = current;
943
+ void current
944
+ .finally(() => {
945
+ if (lane === "fast" && activeFastPass === current) {
946
+ activeFastPass = null;
947
+ drainQueuedPasses();
948
+ }
949
+ else if (lane === "slow" && activeSlowPass === current) {
950
+ activeSlowPass = null;
951
+ drainQueuedPasses();
952
+ }
953
+ })
954
+ .catch(() => undefined);
955
+ return current;
1124
956
  };
1125
- const runGuardedTask = (task, lane = "slow", workClass = "chore", allowFastRealtimeOvertake = false) =>
1126
- // Lanes still choose the pass execution profile, but no longer decide
1127
- // chore ownership. Realtime normally waits for a chore hand-off; the
1128
- // watcher fast path explicitly opts into its established scoped exception.
1129
- passScheduler.submit(task, workClass, lane, allowFastRealtimeOvertake);
1130
- const runGuarded = (passArgvForRun, prepare, lane = "slow", workClass = "chore", allowFastRealtimeOvertake = false) => runGuardedTask((context) => runPassWithLock(passArgvForRun, prepare, lane, workClass, workClass === "chore" ? context.checkpoint : undefined), lane, workClass, allowFastRealtimeOvertake);
957
+ const runGuardedTask = (task, lane = "slow") => {
958
+ const active = lane === "fast"
959
+ ? activeFastPass
960
+ : activeSlowPass ?? activeFastPass;
961
+ const queued = lane === "fast" ? pendingFastPasses : pendingSlowPasses;
962
+ if (active === null && queued.length === 0) {
963
+ return startGuardedTask(task, lane);
964
+ }
965
+ return new Promise((resolve, reject) => {
966
+ queued.push({ task, lane, resolve, reject });
967
+ drainQueuedPasses();
968
+ });
969
+ };
970
+ const runGuarded = (passArgvForRun, prepare, lane = "slow") => runGuardedTask(() => runPassWithLock(passArgvForRun, prepare, lane), lane);
1131
971
  /*
1132
972
  * Area storage and the parallel coordinator default to AUTO. AUTO turns
1133
973
  * them on after durable personal-vault cutover; explicit off is the kill
@@ -2141,7 +1981,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2141
1981
  }
2142
1982
  return false;
2143
1983
  };
2144
- const runScopedDrain = async (batch, watcherBatchGeneration, wakeOnPushFailure = false, allowFastRealtimeOvertake = false) => {
1984
+ const runScopedDrain = async (batch, watcherBatchGeneration, wakeOnPushFailure = false) => {
2145
1985
  if (batch)
2146
1986
  await resolveDeleteSnapshotCaptures(batch);
2147
1987
  const grouped = batch && batch.paths.size > 0 ? groupBatchByRoute(batch) : null;
@@ -2170,11 +2010,11 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2170
2010
  const scopedArgv = buildScopedPushArgv(group.route, admittedPaths, passArgv, group.deleteScopeRoots);
2171
2011
  return runGuarded(scopedArgv, admittedChanges.size > 0
2172
2012
  ? () => prepareWatcherChanges(admittedChanges)
2173
- : undefined, lane, "realtime", allowFastRealtimeOvertake);
2013
+ : undefined, lane);
2174
2014
  })
2175
2015
  : { result: await runGuarded(buildScopedPushArgv(group.route, group.relPaths, passArgv, group.deleteScopeRoots), group.changes.size > 0
2176
2016
  ? () => prepareWatcherChanges(group.changes)
2177
- : undefined, lane, "realtime", allowFastRealtimeOvertake), accepted: true, coordinatorRefusedPaths: [] };
2017
+ : undefined, lane), accepted: true, coordinatorRefusedPaths: [] };
2178
2018
  const result = execution.result;
2179
2019
  if (execution.accepted && passExitCode(result) === 0) {
2180
2020
  const refusedPaths = new Set(typeof result === "number"
@@ -2244,8 +2084,8 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2244
2084
  ? "fast"
2245
2085
  : "slow";
2246
2086
  const execution = parallelCoordinatorEnabled
2247
- ? await runRealtimePass("watcher", "pull", group.relPaths, lane, (slice) => runGuarded(buildTargetedPullArgv(group.route, passArgv, slice.paths.map((path) => path.canonicalPath)), undefined, lane, "realtime"))
2248
- : { result: await runGuarded(pullArgv, undefined, lane, "realtime"), accepted: true };
2087
+ ? await runRealtimePass("watcher", "pull", group.relPaths, lane, (slice) => runGuarded(buildTargetedPullArgv(group.route, passArgv, slice.paths.map((path) => path.canonicalPath)), undefined, lane))
2088
+ : { result: await runGuarded(pullArgv, undefined, lane), accepted: true };
2249
2089
  const exit = execution.accepted ? passExitCode(execution.result) : 1;
2250
2090
  if (exit !== 0 && worstExit === 0)
2251
2091
  worstExit = exit;
@@ -2450,13 +2290,13 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2450
2290
  return;
2451
2291
  }
2452
2292
  if (lanes?.fast &&
2453
- (passScheduler.hasActiveChore || passScheduler.hasActiveSlowRealtime)) {
2293
+ activeSlowPass !== null) {
2454
2294
  const generation = ++nextWatcherBatchGeneration;
2455
2295
  // Fast dispatch bypasses the pending-batch ingress, so preserve both
2456
2296
  // of its contracts here: only selected routes may run, and V2 sees
2457
2297
  // the same dirty signal as the compatibility drain.
2458
2298
  realtimeState.scheduler?.signal("watcher");
2459
- void runScopedDrain(lanes.fast, generation, true, true).then((exit) => {
2299
+ void runScopedDrain(lanes.fast, generation, true).then((exit) => {
2460
2300
  if (exit === 0)
2461
2301
  return;
2462
2302
  restorePendingWatcherPaths(lanes.fast.paths, generation);
@@ -2575,7 +2415,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2575
2415
  // Submit every route in this lane before awaiting any result. In
2576
2416
  // particular, a later route's fast receipt must never wait for an
2577
2417
  // earlier route's slow pull to finish.
2578
- const completed = await Promise.all([...eventsByRoute.values()].map(({ route, events }) => runRealtimePass("receiver", "pull", events.map((event) => event.relativePath), lane, (slice) => runGuarded(buildTargetedPullArgv(route, passArgv, slice.paths.map((path) => path.canonicalPath)), undefined, lane, "realtime"))));
2418
+ const completed = await Promise.all([...eventsByRoute.values()].map(({ route, events }) => runRealtimePass("receiver", "pull", events.map((event) => event.relativePath), lane, (slice) => runGuarded(buildTargetedPullArgv(route, passArgv, slice.paths.map((path) => path.canonicalPath)), undefined, lane))));
2579
2419
  for (const execution of completed) {
2580
2420
  if (!execution.accepted || passExitCode(execution.result) !== 0) {
2581
2421
  throw new Error(`targeted pull failed with exit code ${passExitCode(execution.result)}`);
@@ -2629,7 +2469,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2629
2469
  }
2630
2470
  for (const { route, paths } of pathsByRoute.values()) {
2631
2471
  const targetedArgv = buildTargetedPullArgv(route, passArgv, paths);
2632
- const result = await runGuarded(targetedArgv, undefined, lane, "realtime");
2472
+ const result = await runGuarded(targetedArgv, undefined, lane);
2633
2473
  if (passExitCode(result) !== 0) {
2634
2474
  throw new Error(`targeted pull failed with exit code ${passExitCode(result)}`);
2635
2475
  }
@@ -2677,14 +2517,14 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2677
2517
  const execution = await runRealtimePass("wake", "pull", [], "slow", async () => runGuardedTask(() => runTaskWithLock(async () => {
2678
2518
  await drain();
2679
2519
  return 0;
2680
- }, "realtime"), "slow", "realtime"));
2520
+ })));
2681
2521
  outcome = execution.accepted ? execution.result : 1;
2682
2522
  }
2683
2523
  else {
2684
2524
  outcome = await runGuardedTask(() => runTaskWithLock(async () => {
2685
2525
  await drain();
2686
2526
  return 0;
2687
- }, "realtime"), "slow", "realtime");
2527
+ }));
2688
2528
  }
2689
2529
  }
2690
2530
  catch (err) {
@@ -2880,8 +2720,8 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2880
2720
  targetedJournalSessions: () => targetedJournalSessionCensusSizes().targetedJournalSessions,
2881
2721
  targetedJournalRows: () => targetedJournalSessionCensusSizes().targetedJournalRows,
2882
2722
  cachedAreaJournalMigrations: () => journalCacheCensusSizes().cachedAreaJournalMigrations,
2883
- pendingSlowPasses: () => passScheduler.pendingLaneCount("slow"),
2884
- pendingFastPasses: () => passScheduler.pendingLaneCount("fast"),
2723
+ pendingSlowPasses: () => pendingSlowPasses.length,
2724
+ pendingFastPasses: () => pendingFastPasses.length,
2885
2725
  },
2886
2726
  eventSyncSizes: () => eventSync?.censusSizes?.(),
2887
2727
  watcherSizes: () => watcher?.censusSizes?.(),
@@ -3270,14 +3110,6 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
3270
3110
  : "") +
3271
3111
  "; staying alive, retrying next poll\n");
3272
3112
  }
3273
- else if (exitCode === UNRESOLVED_COMPANY_EXIT) {
3274
- // HQ-SYNC-COMPANY-ROUTE-UID: routed paths are derived from local
3275
- // company directory names, which may not be memberships. The runner
3276
- // has already emitted the resolution error; terminating here would
3277
- // restart the outpost watcher every 60 seconds for each such route.
3278
- // Keep the watcher alive while preserving the one-shot non-zero code.
3279
- process.stderr.write("hq-sync-runner: watch pass skipped — unresolved company target; retrying next poll\n");
3280
- }
3281
3113
  else if (exitCode !== 0) {
3282
3114
  return exitCode;
3283
3115
  }