@indigoai-us/hq-cloud 6.16.46-alpha.1 → 6.16.47

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 (75) hide show
  1. package/dist/bin/sync-runner-planning.d.ts +3 -12
  2. package/dist/bin/sync-runner-planning.d.ts.map +1 -1
  3. package/dist/bin/sync-runner-planning.js +3 -65
  4. package/dist/bin/sync-runner-planning.js.map +1 -1
  5. package/dist/bin/sync-runner-planning.test.js +1 -108
  6. package/dist/bin/sync-runner-planning.test.js.map +1 -1
  7. package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
  8. package/dist/bin/sync-runner-watch-loop.js +1 -9
  9. package/dist/bin/sync-runner-watch-loop.js.map +1 -1
  10. package/dist/bin/sync-runner.d.ts +4 -15
  11. package/dist/bin/sync-runner.d.ts.map +1 -1
  12. package/dist/bin/sync-runner.js +1 -27
  13. package/dist/bin/sync-runner.js.map +1 -1
  14. package/dist/bin/sync-runner.test.js +2 -211
  15. package/dist/bin/sync-runner.test.js.map +1 -1
  16. package/dist/cli/rescue-core.d.ts +18 -0
  17. package/dist/cli/rescue-core.d.ts.map +1 -1
  18. package/dist/cli/rescue-core.js +69 -31
  19. package/dist/cli/rescue-core.js.map +1 -1
  20. package/dist/cli/rescue-realpath.test.d.ts +2 -0
  21. package/dist/cli/rescue-realpath.test.d.ts.map +1 -0
  22. package/dist/cli/rescue-realpath.test.js +109 -0
  23. package/dist/cli/rescue-realpath.test.js.map +1 -0
  24. package/dist/cli/rescue-rsync-preflight.test.js +256 -4
  25. package/dist/cli/rescue-rsync-preflight.test.js.map +1 -1
  26. package/dist/cli/rescue-source-switch-floor.test.d.ts +2 -0
  27. package/dist/cli/rescue-source-switch-floor.test.d.ts.map +1 -0
  28. package/dist/cli/rescue-source-switch-floor.test.js +210 -0
  29. package/dist/cli/rescue-source-switch-floor.test.js.map +1 -0
  30. package/dist/cli/sync-scope.test.js +0 -8
  31. package/dist/cli/sync-scope.test.js.map +1 -1
  32. package/dist/cli/sync.d.ts.map +1 -1
  33. package/dist/cli/sync.js +76 -135
  34. package/dist/cli/sync.js.map +1 -1
  35. package/dist/cli/sync.test.js +1 -11
  36. package/dist/cli/sync.test.js.map +1 -1
  37. package/dist/lib/exit-codes.d.ts +0 -15
  38. package/dist/lib/exit-codes.d.ts.map +1 -1
  39. package/dist/lib/exit-codes.js +0 -15
  40. package/dist/lib/exit-codes.js.map +1 -1
  41. package/dist/s3.d.ts +0 -1
  42. package/dist/s3.d.ts.map +1 -1
  43. package/dist/s3.js +2 -20
  44. package/dist/s3.js.map +1 -1
  45. package/dist/sync/realtime-telemetry.d.ts +1 -1
  46. package/dist/sync/realtime-telemetry.d.ts.map +1 -1
  47. package/dist/sync/realtime-telemetry.js +6 -14
  48. package/dist/sync/realtime-telemetry.js.map +1 -1
  49. package/dist/sync/realtime-telemetry.test.js +16 -136
  50. package/dist/sync/realtime-telemetry.test.js.map +1 -1
  51. package/package.json +1 -2
  52. package/dist/cli/onepass-pull-planner-regressions.test.d.ts +0 -2
  53. package/dist/cli/onepass-pull-planner-regressions.test.d.ts.map +0 -1
  54. package/dist/cli/onepass-pull-planner-regressions.test.js +0 -300
  55. package/dist/cli/onepass-pull-planner-regressions.test.js.map +0 -1
  56. package/dist/cli/onepass-pull-planner.test.d.ts +0 -2
  57. package/dist/cli/onepass-pull-planner.test.d.ts.map +0 -1
  58. package/dist/cli/onepass-pull-planner.test.js +0 -266
  59. package/dist/cli/onepass-pull-planner.test.js.map +0 -1
  60. package/dist/cli/streaming-pull-planner.bench.test.d.ts +0 -15
  61. package/dist/cli/streaming-pull-planner.bench.test.d.ts.map +0 -1
  62. package/dist/cli/streaming-pull-planner.bench.test.js +0 -273
  63. package/dist/cli/streaming-pull-planner.bench.test.js.map +0 -1
  64. package/dist/s3.list-cost.test.d.ts +0 -2
  65. package/dist/s3.list-cost.test.d.ts.map +0 -1
  66. package/dist/s3.list-cost.test.js +0 -51
  67. package/dist/s3.list-cost.test.js.map +0 -1
  68. package/dist/sync/remote-file-spool.d.ts +0 -16
  69. package/dist/sync/remote-file-spool.d.ts.map +0 -1
  70. package/dist/sync/remote-file-spool.js +0 -91
  71. package/dist/sync/remote-file-spool.js.map +0 -1
  72. package/dist/sync/remote-file-spool.test.d.ts +0 -2
  73. package/dist/sync/remote-file-spool.test.d.ts.map +0 -1
  74. package/dist/sync/remote-file-spool.test.js +0 -77
  75. package/dist/sync/remote-file-spool.test.js.map +0 -1
@@ -27,6 +27,17 @@ export declare function envValue(env: NodeJS.ProcessEnv, name: string): string |
27
27
  * drive roots explicitly instead of relying on Cygwin's native-path fallback.
28
28
  */
29
29
  export declare function toCygwinRsyncPath(localPath: string): string;
30
+ interface RsyncPathCandidate {
31
+ path: string;
32
+ executable: boolean;
33
+ }
34
+ interface RsyncLauncher {
35
+ command: string;
36
+ leadingArgs: string[];
37
+ }
38
+ export declare function findRsyncOnPath(entries: string[], env: NodeJS.ProcessEnv): RsyncPathCandidate | undefined;
39
+ /** The overlay requires rsync; do not allocate a recovery copy when it cannot run. */
40
+ export declare function requireWorkingRsync(env: NodeJS.ProcessEnv, err: (s: string) => void): RsyncLauncher;
30
41
  /**
31
42
  * Parse the rescue argv exactly as the bash `while case` loop did, including
32
43
  * validation and the same exit codes (1 unknown/usage, 2 bad option). Throws
@@ -54,6 +65,13 @@ export declare function runRescue(argv: string[], opts?: {
54
65
  * absolute.
55
66
  */
56
67
  export declare function isUsableRescueRoot(root: string, platformPath?: path.PlatformPath): boolean;
68
+ /**
69
+ * Canonicalize the rescue root without treating a known-good directory as
70
+ * unusable when Node's JavaScript realpath walker cannot inspect a Windows
71
+ * drive prefix. Prefer the native syscall, retain the JS walker as a fallback,
72
+ * and use an absolute path only after stat confirms it is a directory.
73
+ */
74
+ export declare function realpathOrExit(p: string, err: (s: string) => void): string;
57
75
  export type RescueDecision = {
58
76
  kind: "skip";
59
77
  rel: string;
@@ -1 +1 @@
1
- {"version":3,"file":"rescue-core.d.ts","sourceRoot":"","sources":["../../src/cli/rescue-core.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"rescue-core.d.ts","sourceRoot":"","sources":["../../src/cli/rescue-core.ts"],"names":[],"mappings":"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"}
@@ -148,10 +148,26 @@ function boundedDiagnostic(value, limit) {
148
148
  function pathEntries(pathValue) {
149
149
  return pathValue ? pathValue.split(path.delimiter) : [];
150
150
  }
151
- function findRsyncOnPath(entries) {
151
+ const DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS = [".COM", ".EXE", ".BAT", ".CMD"];
152
+ function rsyncCandidateNames(env) {
153
+ if (process.platform !== "win32")
154
+ return ["rsync", "rsync.exe"];
155
+ const configuredExtensions = envValue(env, "PATHEXT")
156
+ ?.split(";")
157
+ .map((extension) => extension.trim())
158
+ .filter((extension) => /^\.[A-Za-z0-9]+$/.test(extension));
159
+ const extensions = [
160
+ ...(configuredExtensions?.length
161
+ ? configuredExtensions
162
+ : DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS),
163
+ ...DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS,
164
+ ];
165
+ return [...new Set(["rsync", ...extensions.map((extension) => `rsync${extension.toLowerCase()}`)])];
166
+ }
167
+ export function findRsyncOnPath(entries, env) {
152
168
  let firstUnexecutable;
153
169
  for (const entry of entries) {
154
- for (const name of ["rsync", "rsync.exe"]) {
170
+ for (const name of rsyncCandidateNames(env)) {
155
171
  const candidate = path.resolve(entry || ".", name);
156
172
  try {
157
173
  if (!fs.statSync(candidate).isFile())
@@ -174,14 +190,22 @@ function findRsyncOnPath(entries) {
174
190
  : undefined;
175
191
  }
176
192
  /** The overlay requires rsync; do not allocate a recovery copy when it cannot run. */
177
- function requireWorkingRsync(env, err) {
193
+ export function requireWorkingRsync(env, err) {
178
194
  const resolvedPath = envValue(env, "PATH");
179
195
  const entries = pathEntries(resolvedPath);
180
- const foundRsync = findRsyncOnPath(entries);
181
- const probe = runWithSpawnError("rsync", ["--version"], { env });
196
+ const foundRsync = findRsyncOnPath(entries, env);
197
+ // Node documents that Windows .cmd/.bat files require cmd.exe rather than a
198
+ // direct child-process launch. Keep the path and fixed argument as distinct
199
+ // arguments instead of enabling shell:true for a constructed command string.
200
+ const launcher = process.platform === "win32" && /\.(?:cmd|bat)$/i.test(foundRsync?.path ?? "")
201
+ ? { command: "cmd.exe", leadingArgs: ["/d", "/s", "/c", foundRsync.path] }
202
+ : { command: "rsync", leadingArgs: [] };
203
+ const probe = runWithSpawnError(launcher.command, [...launcher.leadingArgs, "--version"], {
204
+ env,
205
+ });
182
206
  const output = `${probe.stdout}\n${probe.stderr}`;
183
207
  if (probe.status === 0 && /\brsync\b.*\bversion\b/i.test(output))
184
- return;
208
+ return launcher;
185
209
  err("error: rsync preflight failed before any safety snapshot was allocated.\n");
186
210
  if (probe.error) {
187
211
  const errorDetail = "code" in probe.error && typeof probe.error.code === "string"
@@ -483,17 +507,33 @@ export function isUsableRescueRoot(root, platformPath = path) {
483
507
  return platformPath.isAbsolute(root);
484
508
  }
485
509
  /**
486
- * `fs.realpathSync` that converts failure into the rescue's clean error path
487
- * (message + ExitError) instead of an uncaught exception. An uncaught throw
488
- * here is what turned one bad `--hq-root` into a daily crash-loop on Windows.
510
+ * Canonicalize the rescue root without treating a known-good directory as
511
+ * unusable when Node's JavaScript realpath walker cannot inspect a Windows
512
+ * drive prefix. Prefer the native syscall, retain the JS walker as a fallback,
513
+ * and use an absolute path only after stat confirms it is a directory.
489
514
  */
490
- function realpathOrExit(p, err) {
515
+ export function realpathOrExit(p, err) {
491
516
  try {
492
- return fs.realpathSync(p);
517
+ return fs.realpathSync.native(p);
493
518
  }
494
- catch (e) {
495
- err(`error: cannot resolve --hq-root ${p}: ${e instanceof Error ? e.message : String(e)}\n`);
496
- throw new ExitError(1);
519
+ catch {
520
+ try {
521
+ return fs.realpathSync(p);
522
+ }
523
+ catch (realpathError) {
524
+ const resolved = path.resolve(p);
525
+ try {
526
+ if (!fs.statSync(resolved).isDirectory()) {
527
+ throw new Error("resolved path is not a directory");
528
+ }
529
+ }
530
+ catch {
531
+ err(`error: cannot resolve --hq-root ${p}: ${realpathError instanceof Error ? realpathError.message : String(realpathError)}\n`);
532
+ throw new ExitError(1);
533
+ }
534
+ err("warning: could not canonicalize --hq-root; using a normalized absolute path.\n");
535
+ return resolved;
536
+ }
497
537
  }
498
538
  }
499
539
  function doRescue(cfg, env, out, err, setTmp) {
@@ -548,7 +588,7 @@ function doRescue(cfg, env, out, err, setTmp) {
548
588
  // Both the release overlay and a restorable snapshot require rsync. A shim
549
589
  // which merely starts but exits non-zero used to trigger an enormous cp -a
550
590
  // fallback, then fail later at overlay. Stop before classification/allocation.
551
- requireWorkingRsync(env, err);
591
+ const rsyncLauncher = requireWorkingRsync(env, err);
552
592
  // --- Capture the pre-rescue .claude/settings.json (BEFORE the wipe) ---
553
593
  // This is `ours` for the post-overlay settings reconcile. It must be read now
554
594
  // because the overlay-safe classification deletes/overwrites it before
@@ -582,8 +622,9 @@ function doRescue(cfg, env, out, err, setTmp) {
582
622
  prevSyncRef = yq('.replaced_from_source.ref // .replaced_from_staging.ref // ""');
583
623
  prevSyncAt = yq('.replaced_from_source.last_sync_at // .replaced_from_staging.last_sync_at // ""');
584
624
  }
585
- // Caller override (--floor-sha) wins only when the on-disk stamp is empty.
586
- if (!prevSyncSha && cfg.floorShaOverride) {
625
+ // An explicit caller floor is the recovery path for a missing or stale stamp.
626
+ // It remains safe because the selected release clone must still contain it.
627
+ if (cfg.floorShaOverride) {
587
628
  prevSyncSha = cfg.floorShaOverride;
588
629
  prevSyncSource = cfg.sourceRepo;
589
630
  prevSyncRef = "(caller-supplied floor)";
@@ -592,12 +633,8 @@ function doRescue(cfg, env, out, err, setTmp) {
592
633
  out(`==> HQ root: ${hqRoot}\n`);
593
634
  out(`==> Source: https://github.com/${cfg.sourceRepo} @ ${cfg.ref}\n`);
594
635
  if (prevSyncSha) {
595
- if (prevSyncSource === cfg.sourceRepo) {
596
- out(`==> Prior sync: ${prevSyncSha} from ${prevSyncSource}@${prevSyncRef} (${prevSyncAt}) — will use as history floor\n`);
597
- }
598
- else {
599
- out(`==> Prior sync: ${prevSyncSha} from ${prevSyncSource} (different source — ignoring as floor)\n`);
600
- }
636
+ const sourceLabel = prevSyncSource || "(source not recorded)";
637
+ out(`==> Prior sync: ${prevSyncSha} from ${sourceLabel}@${prevSyncRef} (${prevSyncAt}) — checking cloned release history for floor\n`);
601
638
  }
602
639
  if (cfg.narrowPaths.length !== 0) {
603
640
  out("==> Mode: narrow (--paths)\n");
@@ -753,21 +790,22 @@ function doRescue(cfg, env, out, err, setTmp) {
753
790
  // --- Resolve history floor ---
754
791
  let historyFloor = "";
755
792
  let baselineMode = "head_compare";
756
- if (cfg.historyCheck && prevSyncSha && prevSyncSource === cfg.sourceRepo) {
793
+ if (cfg.historyCheck && prevSyncSha) {
757
794
  if (run("git", ["cat-file", "-e", prevSyncSha], { cwd: srcDir, env })
758
795
  .status === 0) {
759
796
  historyFloor = prevSyncSha;
760
797
  baselineMode = "history_floor";
761
798
  }
762
799
  else {
763
- out(` prior-sync SHA ${prevSyncSha} not reachable in clone (rebased/dropped?); falling back to head_compare\n`);
800
+ out(` WARN: prior-sync SHA ${prevSyncSha} is not reachable in the cloned release history; falling back to head_compare\n`);
764
801
  }
765
802
  }
766
803
  if (baselineMode === "history_floor") {
767
804
  out(`==> Baseline: ${historyFloor} (last-sync floor reachable)\n`);
768
805
  }
769
806
  else {
770
- out("==> Baseline: HEAD compare (no usable last-sync stamp; first-ever run or stamp mismatch)\n");
807
+ out("==> Baseline: HEAD compare (no usable reachable last-sync floor)\n");
808
+ out("==> WARNING: retired release files cannot be detected or removed in head_compare mode. Re-run with history checking and --floor-sha <sha> for a reachable baseline.\n");
771
809
  }
772
810
  // --- Build wipe/overlay arg sets per mode ---
773
811
  const pruneNames = [];
@@ -892,7 +930,7 @@ function doRescue(cfg, env, out, err, setTmp) {
892
930
  if (cfg.dryRun) {
893
931
  out("\n");
894
932
  out("==> DRY RUN classification summary:\n");
895
- out(` user-only (leave in place): ${counts.userOnly} files\n`);
933
+ out(` user-only (left in place under release-managed roots): ${counts.userOnly} files\n`);
896
934
  out(` unchanged (preserved/re-laid): ${counts.unchanged} files\n`);
897
935
  out(` user-edit (rescue / diff-append): ${counts.userEdit} files\n`);
898
936
  out(` user-edit (conflict quarantine): ${counts.userConflict} files\n`);
@@ -968,7 +1006,7 @@ function doRescue(cfg, env, out, err, setTmp) {
968
1006
  ];
969
1007
  // Exercise the exact overlay command before any classified delete/move. A
970
1008
  // Cygwin path conversion or filter failure therefore leaves the root intact.
971
- const overlayPreflight = run("rsync", ["--dry-run", ...overlayArgs], { env });
1009
+ const overlayPreflight = run(rsyncLauncher.command, [...rsyncLauncher.leadingArgs, "--dry-run", ...overlayArgs], { env });
972
1010
  if (overlayPreflight.status !== 0) {
973
1011
  err(overlayPreflight.stderr);
974
1012
  throw new ExitError(overlayPreflight.status || 1);
@@ -1053,7 +1091,7 @@ function doRescue(cfg, env, out, err, setTmp) {
1053
1091
  toCygwinRsyncPath(hqRoot + "/"),
1054
1092
  ]
1055
1093
  : overlayArgs;
1056
- const overlay = run("rsync", overlayRunArgs, { env });
1094
+ const overlay = run(rsyncLauncher.command, [...rsyncLauncher.leadingArgs, ...overlayRunArgs], { env });
1057
1095
  if (overlay.status !== 0) {
1058
1096
  // bash runs under set -e: a failed rsync aborts with its status.
1059
1097
  err(overlay.stderr);
@@ -1194,7 +1232,7 @@ function doRescue(cfg, env, out, err, setTmp) {
1194
1232
  }
1195
1233
  out("\n");
1196
1234
  out("==> Classification:\n");
1197
- out(` user-only (left in place): ${counts.userOnly} files\n`);
1235
+ out(` user-only (left in place under release-managed roots): ${counts.userOnly} files\n`);
1198
1236
  out(` unchanged (preserved/re-laid): ${counts.unchanged} files\n`);
1199
1237
  out(` user-edits (rescued): ${counts.userEdit} files\n`);
1200
1238
  out(` user-edits (conflict quarantine): ${counts.userConflict} files\n`);
@@ -1229,7 +1267,7 @@ function doRescue(cfg, env, out, err, setTmp) {
1229
1267
  lines.push("Baseline: head_compare (no last-sync stamp; first run or floor unreachable)");
1230
1268
  }
1231
1269
  lines.push("", "## What the rescue did");
1232
- lines.push(` user-only (left in place): ${counts.userOnly}`);
1270
+ lines.push(` user-only (left in place under release-managed roots): ${counts.userOnly}`);
1233
1271
  lines.push(` unchanged (preserved/re-laid): ${counts.unchanged}`);
1234
1272
  lines.push(` user-edit (rescued into personal/): ${counts.userEdit}`);
1235
1273
  lines.push(` user-edit (conflict quarantine): ${counts.userConflict}`);