@indigoai-us/hq-cloud 6.16.7 → 6.16.9

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 (46) hide show
  1. package/dist/bin/sync-runner-post-sync-flags.d.ts +27 -0
  2. package/dist/bin/sync-runner-post-sync-flags.d.ts.map +1 -0
  3. package/dist/bin/sync-runner-post-sync-flags.js +58 -0
  4. package/dist/bin/sync-runner-post-sync-flags.js.map +1 -0
  5. package/dist/bin/sync-runner-post-sync-flags.test.d.ts +2 -0
  6. package/dist/bin/sync-runner-post-sync-flags.test.d.ts.map +1 -0
  7. package/dist/bin/sync-runner-post-sync-flags.test.js +104 -0
  8. package/dist/bin/sync-runner-post-sync-flags.test.js.map +1 -0
  9. package/dist/bin/sync-runner-watch-loop.d.ts +21 -7
  10. package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
  11. package/dist/bin/sync-runner-watch-loop.js +79 -21
  12. package/dist/bin/sync-runner-watch-loop.js.map +1 -1
  13. package/dist/bin/sync-runner-watch-loop.test.js +40 -1
  14. package/dist/bin/sync-runner-watch-loop.test.js.map +1 -1
  15. package/dist/bin/sync-runner.d.ts +6 -0
  16. package/dist/bin/sync-runner.d.ts.map +1 -1
  17. package/dist/bin/sync-runner.js +27 -5
  18. package/dist/bin/sync-runner.js.map +1 -1
  19. package/dist/bin/sync-runner.test.js +404 -38
  20. package/dist/bin/sync-runner.test.js.map +1 -1
  21. package/dist/context.d.ts.map +1 -1
  22. package/dist/context.js +7 -1
  23. package/dist/context.js.map +1 -1
  24. package/dist/context.test.js +24 -0
  25. package/dist/context.test.js.map +1 -1
  26. package/dist/credential-scope-error.d.ts +21 -0
  27. package/dist/credential-scope-error.d.ts.map +1 -0
  28. package/dist/credential-scope-error.js +57 -0
  29. package/dist/credential-scope-error.js.map +1 -0
  30. package/dist/index.d.ts +2 -0
  31. package/dist/index.d.ts.map +1 -1
  32. package/dist/index.js +1 -0
  33. package/dist/index.js.map +1 -1
  34. package/dist/sync/state-store.d.ts +7 -0
  35. package/dist/sync/state-store.d.ts.map +1 -1
  36. package/dist/sync/state-store.js +113 -17
  37. package/dist/sync/state-store.js.map +1 -1
  38. package/dist/sync/state-store.test.js +79 -1
  39. package/dist/sync/state-store.test.js.map +1 -1
  40. package/dist/vault-client.d.ts +3 -2
  41. package/dist/vault-client.d.ts.map +1 -1
  42. package/dist/vault-client.js +17 -2
  43. package/dist/vault-client.js.map +1 -1
  44. package/dist/vault-client.test.js +49 -0
  45. package/dist/vault-client.test.js.map +1 -1
  46. package/package.json +2 -1
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Registry-backed decisions for post-sync tail work.
3
+ *
4
+ * The runner deliberately evaluates these synchronously: post-sync work must
5
+ * remain usable before authentication has settled and while offline.
6
+ */
7
+ export declare const POST_SYNC_FLAG_KEYS: {
8
+ readonly qmdReindex: "sync.qmd-reindex";
9
+ readonly conflictPrune: "sync.conflict-prune";
10
+ readonly codexMaterialize: "agents.codex-materialize";
11
+ };
12
+ export type PostSyncFlagKey = (typeof POST_SYNC_FLAG_KEYS)[keyof typeof POST_SYNC_FLAG_KEYS];
13
+ export interface PostSyncFlagEvaluator {
14
+ isEnabled(flagKey: PostSyncFlagKey): boolean;
15
+ ready(): Promise<void>;
16
+ refresh(): Promise<void>;
17
+ }
18
+ export interface CreatePostSyncFlagEvaluatorOptions {
19
+ endpoint: string;
20
+ getToken: () => string | Promise<string>;
21
+ env?: Readonly<Record<string, string | undefined>>;
22
+ fetch?: typeof fetch;
23
+ onError?: (error: unknown) => void;
24
+ requestTimeoutMs?: number;
25
+ }
26
+ export declare function createPostSyncFlagEvaluator(options: CreatePostSyncFlagEvaluatorOptions): PostSyncFlagEvaluator;
27
+ //# sourceMappingURL=sync-runner-post-sync-flags.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner-post-sync-flags.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-post-sync-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,qBAAqB,CA6BvB"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Registry-backed decisions for post-sync tail work.
3
+ *
4
+ * The runner deliberately evaluates these synchronously: post-sync work must
5
+ * remain usable before authentication has settled and while offline.
6
+ */
7
+ import { createFlagClient } from "@indigoai-us/hq-flags-client";
8
+ export const POST_SYNC_FLAG_KEYS = {
9
+ qmdReindex: "sync.qmd-reindex",
10
+ conflictPrune: "sync.conflict-prune",
11
+ codexMaterialize: "agents.codex-materialize",
12
+ };
13
+ export function createPostSyncFlagEvaluator(options) {
14
+ const client = createFlagClient({
15
+ endpoint: options.endpoint,
16
+ getToken: options.getToken,
17
+ env: options.env,
18
+ fetch: options.fetch,
19
+ // A runner pass is finite and watch mode creates fresh passes. Do not leave
20
+ // an interval behind; the next pass is the revalidation opportunity.
21
+ refreshIntervalMs: 0,
22
+ requestTimeoutMs: options.requestTimeoutMs,
23
+ // The runner's output streams are NDJSON, so the client's console.warn
24
+ // default would corrupt stderr. Registry failure simply preserves legacy
25
+ // behaviour until a later pass can refresh.
26
+ onError: options.onError ?? (() => { }),
27
+ });
28
+ // Best effort only. `isEnabled` consults the held snapshot synchronously,
29
+ // falling back to the legacy variables while this request waits for a bearer
30
+ // or the registry is unavailable. Never await this from startup or watch
31
+ // lifecycle code: those paths must remain available offline.
32
+ const ready = client.ready();
33
+ return {
34
+ isEnabled(flagKey) {
35
+ return client.isEnabled(flagKey, legacyLookupFor(flagKey));
36
+ },
37
+ ready: () => ready,
38
+ refresh: () => client.refresh(),
39
+ };
40
+ }
41
+ function legacyLookupFor(flagKey) {
42
+ const globalEnvVar = flagKey === POST_SYNC_FLAG_KEYS.qmdReindex
43
+ ? "HQ_QMD_REINDEX_ON_SYNC"
44
+ : flagKey === POST_SYNC_FLAG_KEYS.conflictPrune
45
+ ? "HQ_CONFLICT_PRUNE_ON_SYNC"
46
+ : "HQ_AGENT_CODEX_MATERIALIZE";
47
+ return {
48
+ globalEnvVar,
49
+ globalValueSemantics: {
50
+ onValues: [],
51
+ offValues: ["0"],
52
+ unrecognizedValue: true,
53
+ unsetValue: true,
54
+ },
55
+ fallback: true,
56
+ };
57
+ }
58
+ //# sourceMappingURL=sync-runner-post-sync-flags.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner-post-sync-flags.js","sourceRoot":"","sources":["../../src/bin/sync-runner-post-sync-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,kBAAkB;IAC9B,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,0BAA0B;CACpC,CAAC;AAoBX,MAAM,UAAU,2BAA2B,CACzC,OAA2C;IAE3C,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,4EAA4E;QAC5E,qEAAqE;QACrE,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,uEAAuE;QACvE,yEAAyE;QACzE,4CAA4C;QAC5C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;KACvC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,6EAA6E;IAC7E,yEAAyE;IACzE,6DAA6D;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAE7B,OAAO;QACL,SAAS,CAAC,OAAO;YACf,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;QAClB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAwB;IAC/C,MAAM,YAAY,GAChB,OAAO,KAAK,mBAAmB,CAAC,UAAU;QACxC,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,OAAO,KAAK,mBAAmB,CAAC,aAAa;YAC7C,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,4BAA4B,CAAC;IAErC,OAAO;QACL,YAAY;QACZ,oBAAoB,EAAE;YACpB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,CAAC,GAAG,CAAC;YAChB,iBAAiB,EAAE,IAAI;YACvB,UAAU,EAAE,IAAI;SACjB;QACD,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=sync-runner-post-sync-flags.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner-post-sync-flags.test.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner-post-sync-flags.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,104 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+ import { createPostSyncFlagEvaluator, POST_SYNC_FLAG_KEYS, } from "./sync-runner-post-sync-flags.js";
3
+ function jsonResponse(flags, version = 1) {
4
+ return new Response(JSON.stringify({ version, flags }), {
5
+ status: 200,
6
+ headers: { etag: `"${version}"`, "content-type": "application/json" },
7
+ });
8
+ }
9
+ describe("post-sync registry evaluator", () => {
10
+ it('keeps every legacy gate on for an unset value and for "false"; only exact "0" opts out before registry readiness', () => {
11
+ const pendingToken = new Promise(() => undefined);
12
+ const fetch = vi.fn();
13
+ const evaluator = createPostSyncFlagEvaluator({
14
+ endpoint: "https://flags.example.test",
15
+ getToken: () => pendingToken,
16
+ fetch,
17
+ env: {
18
+ HQ_QMD_REINDEX_ON_SYNC: "false",
19
+ HQ_CONFLICT_PRUNE_ON_SYNC: "0",
20
+ },
21
+ });
22
+ // No await: sync startup cannot wait for a bearer or a network response.
23
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.qmdReindex)).toBe(true);
24
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.conflictPrune)).toBe(false);
25
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.codexMaterialize)).toBe(true);
26
+ expect(fetch).not.toHaveBeenCalled();
27
+ });
28
+ it("uses one global registry snapshot for all three gates without a speculative company query", async () => {
29
+ const fetch = vi.fn().mockResolvedValue(jsonResponse({
30
+ [POST_SYNC_FLAG_KEYS.qmdReindex]: true,
31
+ [POST_SYNC_FLAG_KEYS.conflictPrune]: false,
32
+ [POST_SYNC_FLAG_KEYS.codexMaterialize]: true,
33
+ }));
34
+ const evaluator = createPostSyncFlagEvaluator({
35
+ endpoint: "https://flags.example.test/",
36
+ getToken: () => "person-access-token",
37
+ fetch,
38
+ env: {
39
+ HQ_QMD_REINDEX_ON_SYNC: "0",
40
+ HQ_CONFLICT_PRUNE_ON_SYNC: "0",
41
+ HQ_AGENT_CODEX_MATERIALIZE: "0",
42
+ },
43
+ });
44
+ await evaluator.ready();
45
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.qmdReindex)).toBe(true);
46
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.conflictPrune)).toBe(false);
47
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.codexMaterialize)).toBe(true);
48
+ expect(fetch).toHaveBeenCalledWith("https://flags.example.test/v1/flags/resolve", expect.objectContaining({
49
+ headers: expect.objectContaining({ authorization: "Bearer person-access-token" }),
50
+ }));
51
+ });
52
+ it("falls back to the exact legacy values when the registry is unavailable", async () => {
53
+ const onError = vi.fn();
54
+ const evaluator = createPostSyncFlagEvaluator({
55
+ endpoint: "https://flags.example.test",
56
+ getToken: () => "person-access-token",
57
+ fetch: vi.fn().mockRejectedValue(new Error("offline")),
58
+ onError,
59
+ env: {
60
+ HQ_QMD_REINDEX_ON_SYNC: "0",
61
+ HQ_CONFLICT_PRUNE_ON_SYNC: "false",
62
+ HQ_AGENT_CODEX_MATERIALIZE: "0",
63
+ },
64
+ });
65
+ await evaluator.ready();
66
+ expect(onError).toHaveBeenCalledTimes(1);
67
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.qmdReindex)).toBe(false);
68
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.conflictPrune)).toBe(true);
69
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.codexMaterialize)).toBe(false);
70
+ });
71
+ it("keeps the last valid registry state when a later refresh fails", async () => {
72
+ const fetch = vi
73
+ .fn()
74
+ .mockResolvedValueOnce(jsonResponse({ [POST_SYNC_FLAG_KEYS.qmdReindex]: false }))
75
+ .mockRejectedValueOnce(new Error("temporary outage"));
76
+ const evaluator = createPostSyncFlagEvaluator({
77
+ endpoint: "https://flags.example.test",
78
+ getToken: () => "person-access-token",
79
+ fetch,
80
+ onError: vi.fn(),
81
+ env: { HQ_QMD_REINDEX_ON_SYNC: "0" },
82
+ });
83
+ await evaluator.ready();
84
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.qmdReindex)).toBe(false);
85
+ await evaluator.refresh();
86
+ expect(evaluator.isEnabled(POST_SYNC_FLAG_KEYS.qmdReindex)).toBe(false);
87
+ });
88
+ it.each([
89
+ ["person access token", "person-access-token"],
90
+ ["machine ID token", "machine-id-token"],
91
+ ])("sends the current %s to the registry", async (_identity, token) => {
92
+ const fetch = vi.fn().mockResolvedValue(jsonResponse({}));
93
+ const evaluator = createPostSyncFlagEvaluator({
94
+ endpoint: "https://flags.example.test",
95
+ getToken: () => token,
96
+ fetch,
97
+ });
98
+ await evaluator.ready();
99
+ expect(fetch.mock.calls[0]?.[1]).toMatchObject({
100
+ headers: { authorization: `Bearer ${token}` },
101
+ });
102
+ });
103
+ });
104
+ //# sourceMappingURL=sync-runner-post-sync-flags.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner-post-sync-flags.test.js","sourceRoot":"","sources":["../../src/bin/sync-runner-post-sync-flags.test.ts"],"names":[],"mappings":"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"}
@@ -12,13 +12,15 @@ import type { Direction, RunnerLoopDeps, RunnerPassOutcome } from "./sync-runner
12
12
  */
13
13
  export declare function shouldUseAreaStorage(areaStorage: boolean | FeatureSwitch, stateDir: string, journalSlug: string): boolean;
14
14
  /**
15
- * Targeted-pass batch limit: an event batch touching more distinct paths than
16
- * this falls back to one full reconcile pass. The limit catches genuine
17
- * whole-tree events (restore, branch swap), not ordinary bursts of edits. The
18
- * crossover is determined by the vault's size and the changed paths' coalesced
19
- * scope, not by one fixed path count: a full pass re-lists the whole vault and
20
- * re-walks its local tree, while a targeted pass restricts work to its paths.
21
- * `HQ_SYNC_EVENT_BATCH_LIMIT` overrides; 0/invalid = default.
15
+ * Targeted-pass batch limit: a fully-enumerated event batch larger than this
16
+ * is drained in bounded chunks across successive ticks instead of one giant
17
+ * scoped pass. Size is not a full-reconcile signal — unknown scope is
18
+ * (`overflowed` with no route hints, warm-up catch-up failure, first tick,
19
+ * scheduled interval, bare wake). The crossover for a *chunk* is the number
20
+ * of `--scope-path` arguments a targeted pass can carry without becoming a
21
+ * de-facto whole-tree walk. `HQ_SYNC_EVENT_BATCH_LIMIT` overrides; 0/invalid
22
+ * = default. Do not raise this to "fix" a large warm-up catch-up: that only
23
+ * moves the cliff.
22
24
  */
23
25
  export declare const DEFAULT_EVENT_BATCH_LIMIT = 10000;
24
26
  export declare const EVENT_BATCH_LIMIT_ENV = "HQ_SYNC_EVENT_BATCH_LIMIT";
@@ -98,6 +100,18 @@ export declare function isFastLocalBatch(paths: Iterable<string>, changes?: Read
98
100
  /** A receiver event needs a known small upsert size before it can go realtime. */
99
101
  export declare function isFastReceiverBatch(eventCount: number): boolean;
100
102
  export declare function resolveEventBatchLimit(env?: Record<string, string | undefined>): number;
103
+ /**
104
+ * Take the next bounded slice of a fully-enumerated watcher batch and leave
105
+ * the rest for a later tick. Insertion order is preserved so a killed or
106
+ * stalled runner that already drained earlier chunks does not restart the
107
+ * whole batch: remaining paths stay queued. Overflow metadata is not copied
108
+ * onto either side — callers must not use this helper for unknown-scope
109
+ * overflow (those batches still full-reconcile).
110
+ */
111
+ export declare function takeEnumeratedBatchChunk(batch: TreeChangeBatch, limit: number): {
112
+ chunk: TreeChangeBatch;
113
+ remainder: TreeChangeBatch | null;
114
+ };
101
115
  /**
102
116
  * Optional elapsed-time cadence for full reconciles. Leaving this unset keeps
103
117
  * the legacy every-`FULL_RECONCILE_EVERY_TICKS` cadence exactly intact; set
@@ -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":"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"}
@@ -57,13 +57,15 @@ function emitFullReconcileDecision({ mode, reasons, triggers, pollTick, configur
57
57
  }) + "\n");
58
58
  }
59
59
  /**
60
- * Targeted-pass batch limit: an event batch touching more distinct paths than
61
- * this falls back to one full reconcile pass. The limit catches genuine
62
- * whole-tree events (restore, branch swap), not ordinary bursts of edits. The
63
- * crossover is determined by the vault's size and the changed paths' coalesced
64
- * scope, not by one fixed path count: a full pass re-lists the whole vault and
65
- * re-walks its local tree, while a targeted pass restricts work to its paths.
66
- * `HQ_SYNC_EVENT_BATCH_LIMIT` overrides; 0/invalid = default.
60
+ * Targeted-pass batch limit: a fully-enumerated event batch larger than this
61
+ * is drained in bounded chunks across successive ticks instead of one giant
62
+ * scoped pass. Size is not a full-reconcile signal — unknown scope is
63
+ * (`overflowed` with no route hints, warm-up catch-up failure, first tick,
64
+ * scheduled interval, bare wake). The crossover for a *chunk* is the number
65
+ * of `--scope-path` arguments a targeted pass can carry without becoming a
66
+ * de-facto whole-tree walk. `HQ_SYNC_EVENT_BATCH_LIMIT` overrides; 0/invalid
67
+ * = default. Do not raise this to "fix" a large warm-up catch-up: that only
68
+ * moves the cliff.
67
69
  */
68
70
  export const DEFAULT_EVENT_BATCH_LIMIT = 10_000;
69
71
  export const EVENT_BATCH_LIMIT_ENV = "HQ_SYNC_EVENT_BATCH_LIMIT";
@@ -276,6 +278,46 @@ export function resolveEventBatchLimit(env = process.env) {
276
278
  return DEFAULT_EVENT_BATCH_LIMIT;
277
279
  return Math.trunc(parsed);
278
280
  }
281
+ /**
282
+ * Take the next bounded slice of a fully-enumerated watcher batch and leave
283
+ * the rest for a later tick. Insertion order is preserved so a killed or
284
+ * stalled runner that already drained earlier chunks does not restart the
285
+ * whole batch: remaining paths stay queued. Overflow metadata is not copied
286
+ * onto either side — callers must not use this helper for unknown-scope
287
+ * overflow (those batches still full-reconcile).
288
+ */
289
+ export function takeEnumeratedBatchChunk(batch, limit) {
290
+ if (limit <= 0 || batch.paths.size <= limit) {
291
+ return { chunk: batch, remainder: null };
292
+ }
293
+ const chunkPaths = new Map();
294
+ const remainderPaths = new Map();
295
+ let index = 0;
296
+ for (const [absolutePath, relativePath] of batch.paths) {
297
+ if (index < limit)
298
+ chunkPaths.set(absolutePath, relativePath);
299
+ else
300
+ remainderPaths.set(absolutePath, relativePath);
301
+ index += 1;
302
+ }
303
+ const splitChanges = (targetPaths) => {
304
+ if (batch.changes === undefined || batch.changes.size === 0) {
305
+ return undefined;
306
+ }
307
+ const split = new Map();
308
+ for (const absolutePath of targetPaths.keys()) {
309
+ const change = batch.changes.get(absolutePath);
310
+ if (change !== undefined)
311
+ split.set(absolutePath, change);
312
+ }
313
+ return split.size > 0 ? split : undefined;
314
+ };
315
+ const asBatch = (paths, changes) => (changes === undefined ? { paths } : { paths, changes });
316
+ return {
317
+ chunk: asBatch(chunkPaths, splitChanges(chunkPaths)),
318
+ remainder: asBatch(remainderPaths, splitChanges(remainderPaths)),
319
+ };
320
+ }
279
321
  /**
280
322
  * Optional elapsed-time cadence for full reconciles. Leaving this unset keeps
281
323
  * the legacy every-`FULL_RECONCILE_EVERY_TICKS` cadence exactly intact; set
@@ -2699,14 +2741,6 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2699
2741
  // (backend resync / hint-cap blowout) still needs the full fanout.
2700
2742
  const overflowWithKnownRoutes = pending.batch?.overflowed === true &&
2701
2743
  pending.batch.droppedRouteHints !== undefined;
2702
- // Safety rail: a batch touching more distinct paths than the limit is
2703
- // treated as a mass change and reconciled with one full pass instead of
2704
- // hundreds of scoped ones.
2705
- const batchOverLimit = (pending.batch?.paths.size ?? 0) > resolveEventBatchLimit();
2706
- if (batchOverLimit) {
2707
- process.stderr.write(`hq-sync-runner: event batch of ${pending.batch.paths.size} path(s) ` +
2708
- `exceeds the targeted-pass limit; running a full reconcile\n`);
2709
- }
2710
2744
  const elapsedSinceLastCompletedFullReconcileMs = lastCompletedFullReconcileAt === null
2711
2745
  ? null
2712
2746
  : monotonicNow() - lastCompletedFullReconcileAt;
@@ -2724,7 +2758,6 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2724
2758
  "event-push-surfaces-inactive": eventPushSurfacesInactive,
2725
2759
  "first-tick": firstTick,
2726
2760
  "bare-wake": bareWake,
2727
- "batch-over-limit": batchOverLimit,
2728
2761
  "overflow-routes-unknown": overflowRoutesUnknown,
2729
2762
  "watcher-warmup-catch-up": watcherWarmupCatchup,
2730
2763
  "watcher-warmup-catch-up-failed": watcherWarmupCatchupFailed,
@@ -2736,10 +2769,35 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2736
2769
  const shouldRunFull = eventPushSurfacesInactive ||
2737
2770
  firstTick ||
2738
2771
  bareWake ||
2739
- batchOverLimit ||
2740
2772
  overflowRoutesUnknown ||
2741
2773
  watcherWarmupCatchupFailed ||
2742
2774
  scheduledInterval;
2775
+ // Size is not unknown-scope. A fully-enumerated over-limit batch still
2776
+ // has every path listed, so drain it in bounded chunks and keep the
2777
+ // remainder queued. Skip this when a genuine full-reconcile trigger
2778
+ // already owns the tick — that pass covers the whole taken batch.
2779
+ let workingBatch = pending.batch;
2780
+ if (!shouldRunFull &&
2781
+ workingBatch !== null &&
2782
+ workingBatch.overflowed !== true) {
2783
+ const eventBatchLimit = resolveEventBatchLimit();
2784
+ if (workingBatch.paths.size > eventBatchLimit) {
2785
+ const originalSize = workingBatch.paths.size;
2786
+ const split = takeEnumeratedBatchChunk(workingBatch, eventBatchLimit);
2787
+ process.stderr.write(JSON.stringify({
2788
+ type: "watcher-batch-chunked",
2789
+ batchPathCount: originalSize,
2790
+ chunkPathCount: split.chunk.paths.size,
2791
+ remainingPathCount: split.remainder?.paths.size ?? 0,
2792
+ }) + "\n");
2793
+ if (split.remainder !== null) {
2794
+ const queued = addPendingWatcherChange(undefined, split.remainder);
2795
+ if (queued)
2796
+ interruptWait();
2797
+ }
2798
+ workingBatch = split.chunk;
2799
+ }
2800
+ }
2743
2801
  const emitDecision = (mode, decisionReasons) => {
2744
2802
  emitFullReconcileDecision({
2745
2803
  mode,
@@ -2748,7 +2806,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2748
2806
  pollTick,
2749
2807
  configuredIntervalMs: fullReconcileIntervalMs ?? null,
2750
2808
  elapsedSinceLastCompletedFullReconcileMs,
2751
- batchPathCount: pending.batch?.paths.size ?? 0,
2809
+ batchPathCount: workingBatch?.paths.size ?? 0,
2752
2810
  });
2753
2811
  };
2754
2812
  let result;
@@ -2811,7 +2869,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2811
2869
  result = await runGuarded(passArgv);
2812
2870
  }
2813
2871
  }
2814
- else if (pending.batch === null) {
2872
+ else if (workingBatch === null) {
2815
2873
  // There is no watcher batch and no full-reconcile trigger. Do not
2816
2874
  // substitute the legacy all-companies pull: it enumerates the vault
2817
2875
  // despite the decision record previously calling this pass "scoped".
@@ -2821,8 +2879,8 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
2821
2879
  else {
2822
2880
  try {
2823
2881
  result = overflowWithKnownRoutes
2824
- ? await runOverflowRouteDrain(pending.batch)
2825
- : await runScopedDrain(pending.batch, pending.generation);
2882
+ ? await runOverflowRouteDrain(workingBatch)
2883
+ : await runScopedDrain(workingBatch, pending.generation);
2826
2884
  // Known-route overflow intentionally runs whole *routes* (the paths
2827
2885
  // were dropped); ordinary batches remain path-scoped. Label those
2828
2886
  // distinct scopes so operators can distinguish them from a full