@indigoai-us/hq-cloud 6.15.0 → 6.15.2

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 (329) hide show
  1. package/dist/bin/sync-mutation.d.ts +16 -0
  2. package/dist/bin/sync-mutation.d.ts.map +1 -0
  3. package/dist/bin/sync-mutation.js +60 -0
  4. package/dist/bin/sync-mutation.js.map +1 -0
  5. package/dist/bin/sync-mutation.test.d.ts +2 -0
  6. package/dist/bin/sync-mutation.test.d.ts.map +1 -0
  7. package/dist/bin/sync-mutation.test.js +165 -0
  8. package/dist/bin/sync-mutation.test.js.map +1 -0
  9. package/dist/bin/sync-runner-company.d.ts +8 -0
  10. package/dist/bin/sync-runner-company.d.ts.map +1 -1
  11. package/dist/bin/sync-runner-company.js +16 -0
  12. package/dist/bin/sync-runner-company.js.map +1 -1
  13. package/dist/bin/sync-runner-company.test.d.ts +2 -0
  14. package/dist/bin/sync-runner-company.test.d.ts.map +1 -0
  15. package/dist/bin/sync-runner-company.test.js +36 -0
  16. package/dist/bin/sync-runner-company.test.js.map +1 -0
  17. package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
  18. package/dist/bin/sync-runner-watch-loop.js +98 -8
  19. package/dist/bin/sync-runner-watch-loop.js.map +1 -1
  20. package/dist/bin/sync-runner.d.ts +17 -0
  21. package/dist/bin/sync-runner.d.ts.map +1 -1
  22. package/dist/bin/sync-runner.js.map +1 -1
  23. package/dist/bin/sync-runner.test.js +109 -0
  24. package/dist/bin/sync-runner.test.js.map +1 -1
  25. package/dist/cli/conflict-recovery.test.d.ts +2 -0
  26. package/dist/cli/conflict-recovery.test.d.ts.map +1 -0
  27. package/dist/cli/conflict-recovery.test.js +201 -0
  28. package/dist/cli/conflict-recovery.test.js.map +1 -0
  29. package/dist/cli/conflict.d.ts +60 -0
  30. package/dist/cli/conflict.d.ts.map +1 -1
  31. package/dist/cli/conflict.js +333 -0
  32. package/dist/cli/conflict.js.map +1 -1
  33. package/dist/cli/sync.d.ts +35 -0
  34. package/dist/cli/sync.d.ts.map +1 -1
  35. package/dist/cli/sync.js +100 -0
  36. package/dist/cli/sync.js.map +1 -1
  37. package/dist/cli/sync.test.js +85 -1
  38. package/dist/cli/sync.test.js.map +1 -1
  39. package/dist/index.d.ts +2 -0
  40. package/dist/index.d.ts.map +1 -1
  41. package/dist/index.js +1 -0
  42. package/dist/index.js.map +1 -1
  43. package/dist/skill-telemetry.d.ts +6 -0
  44. package/dist/skill-telemetry.d.ts.map +1 -1
  45. package/dist/skill-telemetry.js +14 -2
  46. package/dist/skill-telemetry.js.map +1 -1
  47. package/dist/skill-telemetry.test.js +79 -0
  48. package/dist/skill-telemetry.test.js.map +1 -1
  49. package/dist/sync/candidate-uploader.d.ts +88 -0
  50. package/dist/sync/candidate-uploader.d.ts.map +1 -0
  51. package/dist/sync/candidate-uploader.js +212 -0
  52. package/dist/sync/candidate-uploader.js.map +1 -0
  53. package/dist/sync/candidate-uploader.test.d.ts +2 -0
  54. package/dist/sync/candidate-uploader.test.d.ts.map +1 -0
  55. package/dist/sync/candidate-uploader.test.js +132 -0
  56. package/dist/sync/candidate-uploader.test.js.map +1 -0
  57. package/dist/sync/delta-client.d.ts +73 -0
  58. package/dist/sync/delta-client.d.ts.map +1 -0
  59. package/dist/sync/delta-client.js +201 -0
  60. package/dist/sync/delta-client.js.map +1 -0
  61. package/dist/sync/delta-client.test.d.ts +2 -0
  62. package/dist/sync/delta-client.test.d.ts.map +1 -0
  63. package/dist/sync/delta-client.test.js +97 -0
  64. package/dist/sync/delta-client.test.js.map +1 -0
  65. package/dist/sync/durable-apply.d.ts +76 -0
  66. package/dist/sync/durable-apply.d.ts.map +1 -0
  67. package/dist/sync/durable-apply.js +530 -0
  68. package/dist/sync/durable-apply.js.map +1 -0
  69. package/dist/sync/durable-apply.test.d.ts +2 -0
  70. package/dist/sync/durable-apply.test.d.ts.map +1 -0
  71. package/dist/sync/durable-apply.test.js +180 -0
  72. package/dist/sync/durable-apply.test.js.map +1 -0
  73. package/dist/sync/event-sync.d.ts +33 -1
  74. package/dist/sync/event-sync.d.ts.map +1 -1
  75. package/dist/sync/event-sync.js +149 -1
  76. package/dist/sync/event-sync.js.map +1 -1
  77. package/dist/sync/event-sync.test.js +142 -1
  78. package/dist/sync/event-sync.test.js.map +1 -1
  79. package/dist/sync/index.d.ts +2 -0
  80. package/dist/sync/index.d.ts.map +1 -1
  81. package/dist/sync/index.js +1 -0
  82. package/dist/sync/index.js.map +1 -1
  83. package/dist/sync/multipart-uploader.d.ts +99 -0
  84. package/dist/sync/multipart-uploader.d.ts.map +1 -0
  85. package/dist/sync/multipart-uploader.js +447 -0
  86. package/dist/sync/multipart-uploader.js.map +1 -0
  87. package/dist/sync/multipart-uploader.test.d.ts +2 -0
  88. package/dist/sync/multipart-uploader.test.d.ts.map +1 -0
  89. package/dist/sync/multipart-uploader.test.js +119 -0
  90. package/dist/sync/multipart-uploader.test.js.map +1 -0
  91. package/dist/sync/mutation-client.d.ts +85 -0
  92. package/dist/sync/mutation-client.d.ts.map +1 -0
  93. package/dist/sync/mutation-client.js +245 -0
  94. package/dist/sync/mutation-client.js.map +1 -0
  95. package/dist/sync/mutation-client.test.d.ts +2 -0
  96. package/dist/sync/mutation-client.test.d.ts.map +1 -0
  97. package/dist/sync/mutation-client.test.js +51 -0
  98. package/dist/sync/mutation-client.test.js.map +1 -0
  99. package/dist/sync/push-receiver.d.ts +45 -0
  100. package/dist/sync/push-receiver.d.ts.map +1 -1
  101. package/dist/sync/push-receiver.js +101 -0
  102. package/dist/sync/push-receiver.js.map +1 -1
  103. package/dist/sync/push-receiver.test.js +54 -2
  104. package/dist/sync/push-receiver.test.js.map +1 -1
  105. package/dist/sync/scope-inventory-client.d.ts +69 -0
  106. package/dist/sync/scope-inventory-client.d.ts.map +1 -0
  107. package/dist/sync/scope-inventory-client.js +210 -0
  108. package/dist/sync/scope-inventory-client.js.map +1 -0
  109. package/dist/sync/scope-inventory-client.test.d.ts +2 -0
  110. package/dist/sync/scope-inventory-client.test.d.ts.map +1 -0
  111. package/dist/sync/scope-inventory-client.test.js +94 -0
  112. package/dist/sync/scope-inventory-client.test.js.map +1 -0
  113. package/dist/sync/snapshot-client.d.ts +98 -0
  114. package/dist/sync/snapshot-client.d.ts.map +1 -0
  115. package/dist/sync/snapshot-client.js +402 -0
  116. package/dist/sync/snapshot-client.js.map +1 -0
  117. package/dist/sync/snapshot-client.test.d.ts +2 -0
  118. package/dist/sync/snapshot-client.test.d.ts.map +1 -0
  119. package/dist/sync/snapshot-client.test.js +169 -0
  120. package/dist/sync/snapshot-client.test.js.map +1 -0
  121. package/dist/sync/uploader-finalization.d.ts +97 -0
  122. package/dist/sync/uploader-finalization.d.ts.map +1 -0
  123. package/dist/sync/uploader-finalization.js +273 -0
  124. package/dist/sync/uploader-finalization.js.map +1 -0
  125. package/dist/sync/uploader-finalization.test.d.ts +2 -0
  126. package/dist/sync/uploader-finalization.test.d.ts.map +1 -0
  127. package/dist/sync/uploader-finalization.test.js +92 -0
  128. package/dist/sync/uploader-finalization.test.js.map +1 -0
  129. package/dist/telemetry.d.ts +11 -1
  130. package/dist/telemetry.d.ts.map +1 -1
  131. package/dist/telemetry.js +21 -2
  132. package/dist/telemetry.js.map +1 -1
  133. package/dist/telemetry.test.js +80 -0
  134. package/dist/telemetry.test.js.map +1 -1
  135. package/package.json +6 -1
  136. package/.claude/policies/hq-cloud-esm-cannot-spy-fs-builtins.md +0 -30
  137. package/.claude/policies/hq-cloud-strip-types-no-parameter-properties.md +0 -22
  138. package/.github/workflows/ci.yml +0 -84
  139. package/.github/workflows/publish.yml +0 -56
  140. package/.github/workflows/unreleased-commits-nag.yml +0 -256
  141. package/eslint.config.js +0 -67
  142. package/pnpm-workspace.yaml +0 -2
  143. package/scripts/presign-transport-e2e.mjs +0 -250
  144. package/scripts/vault-rebaseline.sh +0 -323
  145. package/scripts/vault-rescue.sh +0 -332
  146. package/src/active-company.test.ts +0 -188
  147. package/src/active-company.ts +0 -168
  148. package/src/agent-codex-instructions.test.ts +0 -332
  149. package/src/agent-codex-instructions.ts +0 -309
  150. package/src/auth.ts +0 -146
  151. package/src/backup-prune.test.ts +0 -98
  152. package/src/backup-prune.ts +0 -182
  153. package/src/bin/backup-prune-runner.ts +0 -33
  154. package/src/bin/rescue-runner.ts +0 -25
  155. package/src/bin/sync-runner-company.ts +0 -695
  156. package/src/bin/sync-runner-events.test.ts +0 -143
  157. package/src/bin/sync-runner-events.ts +0 -55
  158. package/src/bin/sync-runner-planning.test.ts +0 -311
  159. package/src/bin/sync-runner-planning.ts +0 -258
  160. package/src/bin/sync-runner-rollup.test.ts +0 -37
  161. package/src/bin/sync-runner-rollup.ts +0 -97
  162. package/src/bin/sync-runner-telemetry.ts +0 -15
  163. package/src/bin/sync-runner-watch-loop.ts +0 -1235
  164. package/src/bin/sync-runner-watch-routes.test.ts +0 -71
  165. package/src/bin/sync-runner-watch-routes.ts +0 -184
  166. package/src/bin/sync-runner.test.ts +0 -8767
  167. package/src/bin/sync-runner.ts +0 -2190
  168. package/src/cli/accept.ts +0 -124
  169. package/src/cli/conflict.ts +0 -119
  170. package/src/cli/doctor.test.ts +0 -581
  171. package/src/cli/doctor.ts +0 -642
  172. package/src/cli/index.ts +0 -49
  173. package/src/cli/invite.test.ts +0 -250
  174. package/src/cli/invite.ts +0 -214
  175. package/src/cli/promote.ts +0 -157
  176. package/src/cli/reindex-knowledge.test.ts +0 -307
  177. package/src/cli/reindex-knowledge.ts +0 -450
  178. package/src/cli/reindex.test.ts +0 -957
  179. package/src/cli/reindex.ts +0 -979
  180. package/src/cli/rescue-classify-ordering.test.ts +0 -548
  181. package/src/cli/rescue-clone-diagnostics.test.ts +0 -120
  182. package/src/cli/rescue-core.ts +0 -3011
  183. package/src/cli/rescue-drift-reconcile.test.ts +0 -179
  184. package/src/cli/rescue-drop-dir-symlink.test.ts +0 -224
  185. package/src/cli/rescue-exec-bit-preserve.test.ts +0 -187
  186. package/src/cli/rescue-hq-root-guard.test.ts +0 -232
  187. package/src/cli/rescue-journal-reconcile.test.ts +0 -215
  188. package/src/cli/rescue-mtime-preserve.test.ts +0 -203
  189. package/src/cli/rescue-settings-reconcile.test.ts +0 -637
  190. package/src/cli/rescue-snapshot.test.ts +0 -57
  191. package/src/cli/rescue-snapshot.ts +0 -51
  192. package/src/cli/rescue.reindex.test.ts +0 -63
  193. package/src/cli/rescue.test.ts +0 -131
  194. package/src/cli/rescue.ts +0 -182
  195. package/src/cli/share.test.ts +0 -7843
  196. package/src/cli/share.ts +0 -3663
  197. package/src/cli/sync-scope.test.ts +0 -652
  198. package/src/cli/sync.test.ts +0 -5207
  199. package/src/cli/sync.ts +0 -3470
  200. package/src/cli/tombstones.ts +0 -106
  201. package/src/cli/watch-event-push-conflict.test.ts +0 -234
  202. package/src/client-info.test.ts +0 -214
  203. package/src/client-info.ts +0 -121
  204. package/src/cognito-auth.test.ts +0 -712
  205. package/src/cognito-auth.ts +0 -1422
  206. package/src/company-resolver.test.ts +0 -618
  207. package/src/company-resolver.ts +0 -521
  208. package/src/context.test.ts +0 -583
  209. package/src/context.ts +0 -378
  210. package/src/daemon-worker.ts +0 -26
  211. package/src/daemon.ts +0 -99
  212. package/src/entity-resolver.test.ts +0 -315
  213. package/src/entity-resolver.ts +0 -180
  214. package/src/ignore.test.ts +0 -466
  215. package/src/ignore.ts +0 -469
  216. package/src/index.ts +0 -439
  217. package/src/journal.test.ts +0 -968
  218. package/src/journal.ts +0 -765
  219. package/src/lib/cloud-authoritative.test.ts +0 -45
  220. package/src/lib/cloud-authoritative.ts +0 -59
  221. package/src/lib/conflict-file.ts +0 -86
  222. package/src/lib/conflict-index.ts +0 -289
  223. package/src/lib/conflict.test.ts +0 -348
  224. package/src/lib/describe-error.test.ts +0 -100
  225. package/src/lib/describe-error.ts +0 -58
  226. package/src/lib/exit-codes.ts +0 -24
  227. package/src/lib/machine-id.test.ts +0 -231
  228. package/src/lib/machine-id.ts +0 -175
  229. package/src/lib/net-errors.test.ts +0 -65
  230. package/src/lib/net-errors.ts +0 -86
  231. package/src/lib/readlink-safe.test.ts +0 -43
  232. package/src/lib/readlink-safe.ts +0 -29
  233. package/src/local-path-codec.test.ts +0 -138
  234. package/src/local-path-codec.ts +0 -161
  235. package/src/machine-auth.test.ts +0 -1323
  236. package/src/manifest-reconcile.test.ts +0 -1123
  237. package/src/manifest-reconcile.ts +0 -518
  238. package/src/object-io.test.ts +0 -1221
  239. package/src/object-io.ts +0 -1306
  240. package/src/operation-lock.test.ts +0 -484
  241. package/src/operation-lock.ts +0 -680
  242. package/src/outcome-telemetry.test.ts +0 -498
  243. package/src/outcome-telemetry.ts +0 -639
  244. package/src/personal-vault-exclusions.test.ts +0 -308
  245. package/src/personal-vault-exclusions.ts +0 -354
  246. package/src/personal-vault.test.ts +0 -756
  247. package/src/personal-vault.ts +0 -496
  248. package/src/prefix-coalesce.test.ts +0 -240
  249. package/src/prefix-coalesce.ts +0 -273
  250. package/src/public-surface.test.ts +0 -117
  251. package/src/qmd-reindex.test.ts +0 -877
  252. package/src/qmd-reindex.ts +0 -842
  253. package/src/read-only-state-dir.test.ts +0 -188
  254. package/src/remote-pull.test.ts +0 -1130
  255. package/src/remote-pull.ts +0 -618
  256. package/src/s3.symlink-materialize.test.ts +0 -492
  257. package/src/s3.test.ts +0 -1789
  258. package/src/s3.ts +0 -1532
  259. package/src/schemas/signal-types.test.ts +0 -82
  260. package/src/schemas/signal-types.ts +0 -38
  261. package/src/schemas/source-channels.test.ts +0 -82
  262. package/src/schemas/source-channels.ts +0 -53
  263. package/src/scope-shrink.test.ts +0 -633
  264. package/src/scope-shrink.ts +0 -481
  265. package/src/signals/get.test.ts +0 -310
  266. package/src/signals/get.ts +0 -75
  267. package/src/signals/internals.ts +0 -195
  268. package/src/signals/list.test.ts +0 -420
  269. package/src/signals/list.ts +0 -79
  270. package/src/signals/parse.ts +0 -8
  271. package/src/signals/types.ts +0 -91
  272. package/src/skill-telemetry.test.ts +0 -1825
  273. package/src/skill-telemetry.ts +0 -1439
  274. package/src/sources/get.test.ts +0 -293
  275. package/src/sources/get.ts +0 -66
  276. package/src/sources/internals.ts +0 -198
  277. package/src/sources/list.test.ts +0 -402
  278. package/src/sources/list.ts +0 -84
  279. package/src/sources/parse.ts +0 -43
  280. package/src/sources/types.ts +0 -84
  281. package/src/sync/event-sync.test.ts +0 -594
  282. package/src/sync/event-sync.ts +0 -545
  283. package/src/sync/feature-flags.test.ts +0 -378
  284. package/src/sync/feature-flags.ts +0 -62
  285. package/src/sync/index.ts +0 -76
  286. package/src/sync/lease-client.test.ts +0 -128
  287. package/src/sync/lease-client.ts +0 -207
  288. package/src/sync/logger.test.ts +0 -242
  289. package/src/sync/logger.ts +0 -79
  290. package/src/sync/metrics.test.ts +0 -462
  291. package/src/sync/metrics.ts +0 -213
  292. package/src/sync/pull-scope.ts +0 -265
  293. package/src/sync/push-event.test.ts +0 -266
  294. package/src/sync/push-event.ts +0 -224
  295. package/src/sync/push-receiver.test.ts +0 -566
  296. package/src/sync/push-receiver.ts +0 -1048
  297. package/src/sync/push-transport.ts +0 -231
  298. package/src/sync/realtime-rollout.test.ts +0 -86
  299. package/src/sync/realtime-rollout.ts +0 -262
  300. package/src/sync/state-store.test.ts +0 -194
  301. package/src/sync/state-store.ts +0 -727
  302. package/src/sync-core.ts +0 -58
  303. package/src/sync-progress.test.ts +0 -94
  304. package/src/sync-progress.ts +0 -140
  305. package/src/telemetry-events.test.ts +0 -88
  306. package/src/telemetry-events.ts +0 -205
  307. package/src/telemetry.test.ts +0 -1280
  308. package/src/telemetry.ts +0 -1109
  309. package/src/types.ts +0 -314
  310. package/src/vault-client.test.ts +0 -1380
  311. package/src/vault-client.ts +0 -1694
  312. package/src/version.ts +0 -24
  313. package/src/watch-roots.test.ts +0 -278
  314. package/src/watch-roots.ts +0 -162
  315. package/src/watcher-event-gate.test.ts +0 -212
  316. package/src/watcher.test.ts +0 -1079
  317. package/src/watcher.ts +0 -1741
  318. package/test/e2e/sync/cross-tenant-isolation.test.ts +0 -630
  319. package/test/e2e/sync/skill-telemetry-oversized-transcript.test.ts +0 -124
  320. package/test/e2e/sync/transient-company-leg.test.ts +0 -384
  321. package/test/e2e/sync/windows-unreadable-link-leg.test.ts +0 -191
  322. package/test/e2e/watcher-real-chokidar.test.ts +0 -165
  323. package/test/e2e/watcher-recursive-backend.test.ts +0 -181
  324. package/test/e2e/watcher-scoped-coverage.test.ts +0 -381
  325. package/test/invite-flow.integration.test.ts +0 -244
  326. package/test/joiner-manifest-reconcile.integration.test.ts +0 -322
  327. package/test/share-sync.integration.test.ts +0 -213
  328. package/tsconfig.json +0 -19
  329. package/vitest.config.ts +0 -22
@@ -1,179 +0,0 @@
1
- /**
2
- * Integration test for the rescue convergence guard in src/cli/rescue-core.ts.
3
- *
4
- * Regression for the false `.drift-*` litter: in `history_floor` mode the
5
- * rescue overlay flags a scaffold file as USER-EDIT whenever its blob differs
6
- * from the *old* baseline (floor). HQ's own Stop hooks rewrite scaffold files
7
- * every session, so a file routinely drifts from the floor yet lands
8
- * byte-for-byte identical to the *new* upstream HEAD the overlay is about to
9
- * write — and the old code rescued it into personal/ with a redundant
10
- * `.drift-<ts>-<pid>` copy. The guard reclassifies "drifted from floor but
11
- * identical to upstream HEAD" as UNCHANGED (no rescue).
12
- *
13
- * The rescue clones its source from GitHub, so we shim `git clone` to clone a
14
- * local fixture repo instead. Everything runs under --dry-run (no destructive
15
- * ops, no backup) and we assert the classification the rescue reports.
16
- */
17
- import { describe, it, expect, beforeAll, afterAll } from "vitest";
18
- import { execFileSync } from "child_process";
19
- import * as fs from "fs";
20
- import * as os from "os";
21
- import * as path from "path";
22
- import { runRescue } from "./rescue-core.js";
23
-
24
- function hasGit(): boolean {
25
- try {
26
- execFileSync("git", ["--version"], { stdio: "ignore" });
27
- return true;
28
- } catch {
29
- return false;
30
- }
31
- }
32
-
33
- const gitAvailable = hasGit();
34
-
35
- /** Run the rescue in-process, capturing its stdout/stderr. */
36
- function runRescueCapture(argv: string[], env: NodeJS.ProcessEnv) {
37
- let stdout = "";
38
- let stderr = "";
39
- const origOut = process.stdout.write.bind(process.stdout);
40
- const origErr = process.stderr.write.bind(process.stderr);
41
- process.stdout.write = ((chunk: unknown) => {
42
- stdout += String(chunk);
43
- return true;
44
- }) as typeof process.stdout.write;
45
- process.stderr.write = ((chunk: unknown) => {
46
- stderr += String(chunk);
47
- return true;
48
- }) as typeof process.stderr.write;
49
- let status: number;
50
- try {
51
- status = runRescue(argv, { env }).status;
52
- } finally {
53
- process.stdout.write = origOut;
54
- process.stderr.write = origErr;
55
- }
56
- return { status, stdout, stderr };
57
- }
58
-
59
- describe.skipIf(!gitAvailable)("rescue drift convergence guard", () => {
60
- let workDir: string;
61
- let upstream: string;
62
- let hqRoot: string;
63
- let shimDir: string;
64
- let floorSha: string;
65
- let env: NodeJS.ProcessEnv;
66
-
67
- const git = (cwd: string, ...args: string[]) =>
68
- execFileSync("git", args, {
69
- cwd,
70
- stdio: ["ignore", "pipe", "pipe"],
71
- env: {
72
- ...process.env,
73
- GIT_AUTHOR_NAME: "t",
74
- GIT_AUTHOR_EMAIL: "t@t",
75
- GIT_COMMITTER_NAME: "t",
76
- GIT_COMMITTER_EMAIL: "t@t",
77
- },
78
- })
79
- .toString()
80
- .trim();
81
-
82
- beforeAll(() => {
83
- workDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-rescue-drift-"));
84
-
85
- // --- Build a local "upstream" repo: floor commit, then a HEAD commit
86
- // where core/x.md changed (v1 -> v2) and the others stayed put. ---
87
- upstream = path.join(workDir, "upstream");
88
- fs.mkdirSync(path.join(upstream, "core"), { recursive: true });
89
- git(workDir, "init", "-b", "main", "upstream");
90
- fs.writeFileSync(path.join(upstream, "core/x.md"), "v1\n");
91
- fs.writeFileSync(path.join(upstream, "core/edited.md"), "base\n");
92
- fs.writeFileSync(path.join(upstream, "core/keep.md"), "same\n");
93
- git(upstream, "add", "-A");
94
- git(upstream, "commit", "-m", "floor");
95
- floorSha = git(upstream, "rev-parse", "HEAD");
96
- // HEAD: only x.md advances.
97
- fs.writeFileSync(path.join(upstream, "core/x.md"), "v2\n");
98
- git(upstream, "add", "-A");
99
- git(upstream, "commit", "-m", "head");
100
-
101
- // --- Build the local HQ root being rescued. ---
102
- hqRoot = path.join(workDir, "hq");
103
- fs.mkdirSync(path.join(hqRoot, "core"), { recursive: true });
104
- // `companies/` + `personal/` make it "look like" an HQ root (script guard);
105
- // both are preserved (never walked).
106
- fs.mkdirSync(path.join(hqRoot, "personal"), { recursive: true });
107
- fs.mkdirSync(path.join(hqRoot, "companies"), { recursive: true });
108
- // Drifted from floor ("v1") but byte-identical to upstream HEAD ("v2").
109
- // OLD behavior: rescued to personal/x.md (+ .drift on collision).
110
- // NEW behavior: reconciled as UNCHANGED — no rescue.
111
- fs.writeFileSync(path.join(hqRoot, "core/x.md"), "v2\n");
112
- // Genuinely user-edited: differs from both floor and HEAD -> still rescued.
113
- fs.writeFileSync(path.join(hqRoot, "core/edited.md"), "MINE\n");
114
- // Untouched vs floor -> UNCHANGED.
115
- fs.writeFileSync(path.join(hqRoot, "core/keep.md"), "same\n");
116
-
117
- // --- git shim: rewrite `git clone <github-url> dest` to the local fixture. ---
118
- // Resolve the real git BEFORE the shim is on PATH so we don't recurse.
119
- const realGit = execFileSync("bash", ["-lc", "command -v git"]).toString().trim() || "/usr/bin/git";
120
- shimDir = path.join(workDir, "shim");
121
- fs.mkdirSync(shimDir, { recursive: true });
122
- const shim = `#!/usr/bin/env bash
123
- if [ "$1" = "clone" ]; then
124
- args=()
125
- for a in "$@"; do
126
- case "$a" in
127
- https://github.com/*) a=${JSON.stringify(upstream)} ;;
128
- esac
129
- args+=("$a")
130
- done
131
- exec ${JSON.stringify(realGit)} "\${args[@]}"
132
- fi
133
- exec ${JSON.stringify(realGit)} "$@"
134
- `;
135
- fs.writeFileSync(path.join(shimDir, "git"), shim, { mode: 0o755 });
136
-
137
- env = { ...process.env, PATH: `${shimDir}:${process.env.PATH ?? ""}` };
138
- });
139
-
140
- afterAll(() => {
141
- if (workDir) fs.rmSync(workDir, { recursive: true, force: true });
142
- });
143
-
144
- function runRescueDry() {
145
- return runRescueCapture(
146
- [
147
- "--hq-root", hqRoot,
148
- "--source", "test/repo",
149
- "--ref", "main",
150
- "--floor-sha", floorSha,
151
- "--dry-run",
152
- "--yes",
153
- "--no-backup",
154
- ],
155
- env,
156
- );
157
- }
158
-
159
- it("reconciles a floor-drifted file that is identical to upstream HEAD (no rescue)", () => {
160
- const r = runRescueDry();
161
- const out = `${r.stdout}\n${r.stderr}`;
162
- // Sanity: ran in history_floor mode against our floor.
163
- expect(r.status, out).toBe(0);
164
- expect(out).toContain(`Baseline: ${floorSha}`);
165
-
166
- // The drifted-but-identical-to-HEAD file is reconciled, NOT rescued.
167
- expect(out).toContain("drift reconciled (identical to upstream HEAD; no rescue): core/x.md");
168
- expect(out).not.toMatch(/user-edit \(rescue\): core\/x\.md/);
169
-
170
- // The genuinely-edited file is still rescued into personal/.
171
- expect(out).toContain("user-edit (rescue): core/edited.md -> personal/edited.md");
172
-
173
- // Untouched file classified UNCHANGED.
174
- expect(out).toContain("unchanged (preserved in place): core/keep.md");
175
-
176
- // Summary reflects exactly one reconcile.
177
- expect(out).toMatch(/drift reconciled \(== upstream\):\s+1 files/);
178
- });
179
- });
@@ -1,224 +0,0 @@
1
- /**
2
- * Regression for the rescue "drop reindex symlink" fix in
3
- * src/cli/rescue-core.ts (dropReindexSymlink).
4
- *
5
- * The bug: the apply step removed a reindex overlay symlink with
6
- * `fs.rmSync(localPath, { force: true })`. `rmSync` stat-FOLLOWS on some
7
- * platforms (notably macOS), so a symlink whose target is a directory — e.g.
8
- * core/knowledge/ad-creative-engine -> personal/knowledge/ad-creative-engine —
9
- * is seen as a directory and, with `recursive` unset, throws `EISDIR`
10
- * ("Path is a directory"). During a rescue apply that abort rolls back the
11
- * whole update, so /update-hq fails on any install carrying a directory-target
12
- * overlay symlink. The fix removes the link with lstat + unlink semantics
13
- * (`fs.unlinkSync`), which drops the link itself regardless of what it points
14
- * at and never recurses into the target.
15
- *
16
- * The macOS `rmSync` follow-behavior is not reproducible with a plain path on
17
- * Linux CI, so we reproduce it deterministically: `fs` is mocked so `rmSync`
18
- * throws `EISDIR` on exactly a directory-target symlink (every other call is
19
- * delegated to the real implementation). Under that fault the OLD code aborts
20
- * the apply and rolls the whole update back; the fixed code drops the link with
21
- * `unlinkSync` and the rescue still succeeds.
22
- *
23
- * Mirrors rescue-mtime-preserve.test.ts: shim `git clone` to a local fixture
24
- * and run the real rescue (non-dry-run, --no-backup) so the overlay lays files
25
- * down and the symlink-drop action really runs.
26
- */
27
- import { describe, it, expect, beforeAll, afterAll, vi } from "vitest";
28
- import { execFileSync } from "child_process";
29
- import * as fs from "fs";
30
- import * as os from "os";
31
- import * as path from "path";
32
- import { runRescue } from "./rescue-core.js";
33
-
34
- // Simulate the reporter's platform (macOS): fs.rmSync stat-follows a
35
- // symlink-to-directory and throws EISDIR ("Path is a directory"). Only the
36
- // dir-target symlink trips this; every other rmSync call — and every other fs
37
- // function — is the real implementation, so clone/overlay/backup all work.
38
- vi.mock("fs", async (importOriginal) => {
39
- const real = await importOriginal<typeof import("fs")>();
40
- const patchedRmSync: typeof real.rmSync = ((p: fs.PathLike, opts?: fs.RmOptions) => {
41
- try {
42
- const lst = real.lstatSync(p as fs.PathLike);
43
- if (lst.isSymbolicLink() && real.statSync(p as fs.PathLike).isDirectory()) {
44
- const err = new Error(
45
- `EISDIR: illegal operation on a directory, Path is a directory: ${String(p)}`,
46
- ) as NodeJS.ErrnoException;
47
- err.code = "ERR_FS_EISDIR";
48
- throw err;
49
- }
50
- } catch (e) {
51
- if ((e as NodeJS.ErrnoException).code === "ERR_FS_EISDIR") throw e;
52
- // lstat/stat failed (missing path / broken link) — fall through to real rm.
53
- }
54
- return real.rmSync(p, opts);
55
- }) as typeof real.rmSync;
56
- return { ...real, rmSync: patchedRmSync };
57
- });
58
-
59
- function has(bin: string, ...args: string[]): boolean {
60
- try {
61
- execFileSync(bin, args, { stdio: "ignore" });
62
- return true;
63
- } catch {
64
- return false;
65
- }
66
- }
67
- const toolsAvailable = has("git", "--version") && has("rsync", "--version");
68
-
69
- const EPOCH = 1609459200; // 2021-01-01T00:00:00Z
70
-
71
- /** Run the rescue in-process, capturing its stdout/stderr. */
72
- function runRescueCapture(argv: string[], env: NodeJS.ProcessEnv) {
73
- let stdout = "";
74
- let stderr = "";
75
- const origOut = process.stdout.write.bind(process.stdout);
76
- const origErr = process.stderr.write.bind(process.stderr);
77
- process.stdout.write = ((chunk: unknown) => {
78
- stdout += String(chunk);
79
- return true;
80
- }) as typeof process.stdout.write;
81
- process.stderr.write = ((chunk: unknown) => {
82
- stderr += String(chunk);
83
- return true;
84
- }) as typeof process.stderr.write;
85
- let status: number;
86
- try {
87
- status = runRescue(argv, { env }).status;
88
- } finally {
89
- process.stdout.write = origOut;
90
- process.stderr.write = origErr;
91
- }
92
- return { status, stdout, stderr };
93
- }
94
-
95
- describe.skipIf(!toolsAvailable)("rescue drops directory-target reindex symlinks", () => {
96
- let workDir: string;
97
- let upstream: string;
98
- let shimDir: string;
99
- let floorSha: string;
100
- let env: NodeJS.ProcessEnv;
101
-
102
- const gitAt = (cwd: string, ...args: string[]) =>
103
- execFileSync("git", args, {
104
- cwd,
105
- stdio: ["ignore", "pipe", "pipe"],
106
- env: {
107
- ...process.env,
108
- GIT_AUTHOR_NAME: "t",
109
- GIT_AUTHOR_EMAIL: "t@t",
110
- GIT_COMMITTER_NAME: "t",
111
- GIT_COMMITTER_EMAIL: "t@t",
112
- GIT_AUTHOR_DATE: `${EPOCH} +0000`,
113
- GIT_COMMITTER_DATE: `${EPOCH} +0000`,
114
- },
115
- })
116
- .toString()
117
- .trim();
118
-
119
- beforeAll(() => {
120
- workDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-rescue-dirsymlink-"));
121
-
122
- // --- "upstream" repo: a single core/ file so the wipe set includes core/ --
123
- upstream = path.join(workDir, "upstream");
124
- fs.mkdirSync(path.join(upstream, "core/knowledge"), { recursive: true });
125
- gitAt(workDir, "init", "-b", "main", "upstream");
126
- fs.writeFileSync(path.join(upstream, "core/knowledge/README.md"), "shipped\n");
127
- gitAt(upstream, "add", "-A");
128
- gitAt(upstream, "commit", "-m", "floor");
129
- floorSha = gitAt(upstream, "rev-parse", "HEAD");
130
-
131
- // --- git shim: redirect `git clone <github-url>` to the local fixture -----
132
- const realGit =
133
- execFileSync("bash", ["-lc", "command -v git"]).toString().trim() || "/usr/bin/git";
134
- shimDir = path.join(workDir, "shim");
135
- fs.mkdirSync(shimDir, { recursive: true });
136
- const shim = `#!/usr/bin/env bash
137
- if [ "$1" = "clone" ]; then
138
- args=()
139
- for a in "$@"; do
140
- case "$a" in
141
- https://github.com/*) a=${JSON.stringify(upstream)} ;;
142
- esac
143
- args+=("$a")
144
- done
145
- exec ${JSON.stringify(realGit)} "\${args[@]}"
146
- fi
147
- exec ${JSON.stringify(realGit)} "$@"
148
- `;
149
- fs.writeFileSync(path.join(shimDir, "git"), shim, { mode: 0o755 });
150
- env = { ...process.env, PATH: `${shimDir}:${process.env.PATH ?? ""}` };
151
- });
152
-
153
- afterAll(() => {
154
- if (workDir) fs.rmSync(workDir, { recursive: true, force: true });
155
- });
156
-
157
- /**
158
- * Build a fresh local HQ root carrying a directory-target reindex symlink
159
- * (core/knowledge/ad-creative-engine -> <hqRoot>/personal/knowledge/ad-creative-engine),
160
- * whose target directory holds a sentinel file that must survive the drop.
161
- */
162
- function makeHqRoot(): { hqRoot: string; link: string; targetDir: string; sentinel: string } {
163
- const hqRoot = fs.mkdtempSync(path.join(workDir, "hq-"));
164
- // HQ-root shape check: companies/ + one of .claude/|core/|personal/.
165
- fs.mkdirSync(path.join(hqRoot, "companies"), { recursive: true });
166
- fs.mkdirSync(path.join(hqRoot, "core/knowledge"), { recursive: true });
167
- // Unchanged vs upstream so the overlay is a no-op for it.
168
- fs.writeFileSync(path.join(hqRoot, "core/knowledge/README.md"), "shipped\n");
169
-
170
- const targetDir = path.join(hqRoot, "personal/knowledge/ad-creative-engine");
171
- fs.mkdirSync(targetDir, { recursive: true });
172
- const sentinel = path.join(targetDir, "brief.md");
173
- fs.writeFileSync(sentinel, "authored locally\n");
174
-
175
- const link = path.join(hqRoot, "core/knowledge/ad-creative-engine");
176
- // Absolute target that includes "/personal/" — matches the overlay
177
- // convention masterSyncSymlinkTarget() recognizes.
178
- fs.symlinkSync(targetDir, link);
179
-
180
- return { hqRoot, link, targetDir, sentinel };
181
- }
182
-
183
- function rescueArgs(hqRoot: string): string[] {
184
- return [
185
- "--hq-root", hqRoot,
186
- "--source", "test/repo",
187
- "--ref", "main",
188
- "--floor-sha", floorSha,
189
- "--yes",
190
- "--no-backup",
191
- ];
192
- }
193
-
194
- it("sanity: the mocked rmSync reproduces the macOS EISDIR on a dir-target symlink", () => {
195
- const { link, targetDir, sentinel } = makeHqRoot();
196
- // The old apply path used exactly this call — it must throw under the fault.
197
- expect(() => fs.rmSync(link, { force: true })).toThrow(/Path is a directory/);
198
- // ...and the fixed path (unlink) removes the link while sparing the target.
199
- fs.unlinkSync(link);
200
- expect(fs.existsSync(link)).toBe(false);
201
- expect(fs.existsSync(targetDir)).toBe(true);
202
- expect(fs.readFileSync(sentinel, "utf-8")).toBe("authored locally\n");
203
- });
204
-
205
- it("does not abort the apply on a directory-target symlink (drops it, spares the target)", () => {
206
- const { hqRoot, link, targetDir, sentinel } = makeHqRoot();
207
-
208
- const r = runRescueCapture(rescueArgs(hqRoot), env);
209
-
210
- // The apply must survive the simulated-macOS rmSync fault: the fix removes
211
- // the link with unlink semantics, so the whole update no longer rolls back.
212
- // (The old rmSync-based drop throws EISDIR here → non-zero + rollback.)
213
- if (r.status !== 0) {
214
- throw new Error(`rescue aborted on the dir-target symlink (${r.status}):\n${r.stdout}\n${r.stderr}`);
215
- }
216
-
217
- // The link itself is gone (reindex.sh re-lays it later)...
218
- expect(fs.existsSync(link)).toBe(false);
219
- // ...but the target directory and its contents are untouched — the drop
220
- // must never follow/recurse into the target.
221
- expect(fs.existsSync(targetDir)).toBe(true);
222
- expect(fs.readFileSync(sentinel, "utf-8")).toBe("authored locally\n");
223
- });
224
- });
@@ -1,187 +0,0 @@
1
- /**
2
- * Regression for the rescue executable-bit guarantee in src/cli/rescue-core.ts
3
- * (restoreShebangExecBits).
4
- *
5
- * rescue rebuilds the tree with `git clone` + `rsync -a`, which faithfully
6
- * propagates the upstream git tree mode. So a script committed upstream WITHOUT
7
- * its executable bit (a `.sh` checked in as 100644) is delivered non-executable
8
- * to every machine -- and a hook the runtime exec's directly then fails with
9
- * "Permission denied". After the overlay, rescue restores +x on any shipped
10
- * file that begins with a `#!` shebang (and leaves non-shebang files alone).
11
- *
12
- * Mirrors rescue-mtime-preserve.test.ts: shim `git clone` to a local fixture
13
- * and run the real rescue (non-dry-run, --no-backup) so the overlay lays files
14
- * down for real.
15
- */
16
- import { describe, it, expect, beforeAll, afterAll } from "vitest";
17
- import { execFileSync } from "child_process";
18
- import * as fs from "fs";
19
- import * as os from "os";
20
- import * as path from "path";
21
- import { runRescue } from "./rescue-core.js";
22
-
23
- function has(bin: string, ...args: string[]): boolean {
24
- try {
25
- execFileSync(bin, args, { stdio: "ignore" });
26
- return true;
27
- } catch {
28
- return false;
29
- }
30
- }
31
- const toolsAvailable = has("git", "--version") && has("rsync", "--version");
32
-
33
- const FLOOR_EPOCH = 1577836800; // 2020-01-01
34
- const HEAD_EPOCH = 1609459200; // 2021-01-01
35
-
36
- function runRescueCapture(argv: string[], env: NodeJS.ProcessEnv) {
37
- let stdout = "";
38
- let stderr = "";
39
- const origOut = process.stdout.write.bind(process.stdout);
40
- const origErr = process.stderr.write.bind(process.stderr);
41
- process.stdout.write = ((chunk: unknown) => {
42
- stdout += String(chunk);
43
- return true;
44
- }) as typeof process.stdout.write;
45
- process.stderr.write = ((chunk: unknown) => {
46
- stderr += String(chunk);
47
- return true;
48
- }) as typeof process.stderr.write;
49
- let status: number;
50
- try {
51
- status = runRescue(argv, { env }).status;
52
- } finally {
53
- process.stdout.write = origOut;
54
- process.stderr.write = origErr;
55
- }
56
- return { status, stdout, stderr };
57
- }
58
-
59
- describe.skipIf(!toolsAvailable)("rescue restores +x on shipped shebang scripts", () => {
60
- let workDir: string;
61
- let upstream: string;
62
- let hqRoot: string;
63
- let shimDir: string;
64
- let floorSha: string;
65
- let env: NodeJS.ProcessEnv;
66
-
67
- const gitAt = (cwd: string, epoch: number, ...args: string[]) =>
68
- execFileSync("git", args, {
69
- cwd,
70
- stdio: ["ignore", "pipe", "pipe"],
71
- env: {
72
- ...process.env,
73
- GIT_AUTHOR_NAME: "t",
74
- GIT_AUTHOR_EMAIL: "t@t",
75
- GIT_COMMITTER_NAME: "t",
76
- GIT_COMMITTER_EMAIL: "t@t",
77
- GIT_AUTHOR_DATE: `${epoch} +0000`,
78
- GIT_COMMITTER_DATE: `${epoch} +0000`,
79
- },
80
- })
81
- .toString()
82
- .trim();
83
-
84
- const isExec = (p: string) => (fs.statSync(p).mode & 0o111) !== 0;
85
- const mode = (p: string) => fs.statSync(p).mode & 0o777;
86
-
87
- beforeAll(() => {
88
- workDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-rescue-exec-"));
89
-
90
- // --- "upstream" repo ----------------------------------------------------
91
- upstream = path.join(workDir, "upstream");
92
- fs.mkdirSync(path.join(upstream, "core/scripts"), { recursive: true });
93
- fs.mkdirSync(path.join(upstream, "core/docs"), { recursive: true });
94
- gitAt(workDir, FLOOR_EPOCH, "init", "-b", "main", "upstream");
95
-
96
- // Shebang script committed WITHOUT +x (the bug: arrives non-executable).
97
- const needs = path.join(upstream, "core/scripts/needs-exec.sh");
98
- fs.writeFileSync(needs, "#!/bin/bash\necho needs\n", { mode: 0o644 });
99
- fs.chmodSync(needs, 0o644);
100
- // Shebang script committed WITH +x (control: rsync -a already preserves it).
101
- const already = path.join(upstream, "core/scripts/already-exec.sh");
102
- fs.writeFileSync(already, "#!/bin/bash\necho already\n");
103
- fs.chmodSync(already, 0o755);
104
- // Non-shebang data file (control: must NOT be made executable).
105
- fs.writeFileSync(path.join(upstream, "core/docs/note.md"), "# note\n", { mode: 0o644 });
106
-
107
- gitAt(upstream, FLOOR_EPOCH, "add", "-A");
108
- gitAt(upstream, FLOOR_EPOCH, "commit", "-m", "floor");
109
- floorSha = gitAt(upstream, FLOOR_EPOCH, "rev-parse", "HEAD");
110
- // A second commit so floor != HEAD (mirrors the mtime fixture).
111
- fs.writeFileSync(path.join(upstream, "core/docs/head.md"), "head\n");
112
- gitAt(upstream, HEAD_EPOCH, "add", "-A");
113
- gitAt(upstream, HEAD_EPOCH, "commit", "-m", "head");
114
-
115
- // Confirm the fixture actually stored the intended tree modes.
116
- const lsFloor = gitAt(upstream, HEAD_EPOCH, "ls-tree", "-r", "HEAD");
117
- if (!/100644\s+blob\s+\S+\s+core\/scripts\/needs-exec\.sh/.test(lsFloor)) {
118
- throw new Error(`fixture needs-exec.sh not stored as 100644:\n${lsFloor}`);
119
- }
120
- if (!/100755\s+blob\s+\S+\s+core\/scripts\/already-exec\.sh/.test(lsFloor)) {
121
- throw new Error(`fixture already-exec.sh not stored as 100755:\n${lsFloor}`);
122
- }
123
-
124
- // --- local HQ root being rescued (fresh; upstream files are brand-new) --
125
- hqRoot = path.join(workDir, "hq");
126
- fs.mkdirSync(path.join(hqRoot, "core"), { recursive: true });
127
- fs.mkdirSync(path.join(hqRoot, "personal"), { recursive: true });
128
- fs.mkdirSync(path.join(hqRoot, "companies"), { recursive: true });
129
-
130
- // --- git shim: redirect `git clone <github-url>` to the local fixture ---
131
- const realGit = execFileSync("bash", ["-lc", "command -v git"]).toString().trim() || "/usr/bin/git";
132
- shimDir = path.join(workDir, "shim");
133
- fs.mkdirSync(shimDir, { recursive: true });
134
- const shim = `#!/usr/bin/env bash
135
- if [ "$1" = "clone" ]; then
136
- args=()
137
- for a in "$@"; do
138
- case "$a" in
139
- https://github.com/*) a=${JSON.stringify(upstream)} ;;
140
- esac
141
- args+=("$a")
142
- done
143
- exec ${JSON.stringify(realGit)} "\${args[@]}"
144
- fi
145
- exec ${JSON.stringify(realGit)} "$@"
146
- `;
147
- fs.writeFileSync(path.join(shimDir, "git"), shim, { mode: 0o755 });
148
- env = { ...process.env, PATH: `${shimDir}:${process.env.PATH ?? ""}` };
149
-
150
- const r = runRescueCapture(
151
- [
152
- "--hq-root", hqRoot,
153
- "--source", "test/repo",
154
- "--ref", "main",
155
- "--floor-sha", floorSha,
156
- "--yes",
157
- "--no-backup",
158
- ],
159
- env,
160
- );
161
- if (r.status !== 0) {
162
- throw new Error(`rescue failed (${r.status}):\n${r.stdout}\n${r.stderr}`);
163
- }
164
- });
165
-
166
- afterAll(() => {
167
- if (workDir) fs.rmSync(workDir, { recursive: true, force: true });
168
- });
169
-
170
- it("restores +x on a shebang script shipped as 0644 (the bug)", () => {
171
- const f = path.join(hqRoot, "core/scripts/needs-exec.sh");
172
- expect(fs.readFileSync(f, "utf-8")).toBe("#!/bin/bash\necho needs\n");
173
- expect(isExec(f)).toBe(true);
174
- expect(mode(f)).toBe(0o755); // 0644 + (read-bits -> exec-bits)
175
- });
176
-
177
- it("leaves an already-executable shebang script executable", () => {
178
- const f = path.join(hqRoot, "core/scripts/already-exec.sh");
179
- expect(isExec(f)).toBe(true);
180
- });
181
-
182
- it("never makes a non-shebang data file executable", () => {
183
- const f = path.join(hqRoot, "core/docs/note.md");
184
- expect(fs.existsSync(f)).toBe(true);
185
- expect(isExec(f)).toBe(false);
186
- });
187
- });