@indigoai-us/hq-cloud 6.14.50 → 6.15.1

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 (340) hide show
  1. package/dist/bin/sync-mutation.d.ts +14 -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 +64 -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/reindex-knowledge.d.ts +7 -0
  34. package/dist/cli/reindex-knowledge.d.ts.map +1 -0
  35. package/dist/cli/reindex-knowledge.js +389 -0
  36. package/dist/cli/reindex-knowledge.js.map +1 -0
  37. package/dist/cli/reindex-knowledge.test.d.ts +12 -0
  38. package/dist/cli/reindex-knowledge.test.d.ts.map +1 -0
  39. package/dist/cli/reindex-knowledge.test.js +260 -0
  40. package/dist/cli/reindex-knowledge.test.js.map +1 -0
  41. package/dist/cli/reindex.d.ts.map +1 -1
  42. package/dist/cli/reindex.js +8 -0
  43. package/dist/cli/reindex.js.map +1 -1
  44. package/dist/cli/rescue-settings-reconcile.test.js +47 -0
  45. package/dist/cli/rescue-settings-reconcile.test.js.map +1 -1
  46. package/dist/cli/sync.d.ts +27 -0
  47. package/dist/cli/sync.d.ts.map +1 -1
  48. package/dist/cli/sync.js +52 -0
  49. package/dist/cli/sync.js.map +1 -1
  50. package/dist/cli/sync.test.js +31 -1
  51. package/dist/cli/sync.test.js.map +1 -1
  52. package/dist/index.d.ts +2 -0
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +1 -0
  55. package/dist/index.js.map +1 -1
  56. package/dist/skill-telemetry.d.ts +6 -0
  57. package/dist/skill-telemetry.d.ts.map +1 -1
  58. package/dist/skill-telemetry.js +14 -2
  59. package/dist/skill-telemetry.js.map +1 -1
  60. package/dist/skill-telemetry.test.js +79 -0
  61. package/dist/skill-telemetry.test.js.map +1 -1
  62. package/dist/sync/candidate-uploader.d.ts +88 -0
  63. package/dist/sync/candidate-uploader.d.ts.map +1 -0
  64. package/dist/sync/candidate-uploader.js +212 -0
  65. package/dist/sync/candidate-uploader.js.map +1 -0
  66. package/dist/sync/candidate-uploader.test.d.ts +2 -0
  67. package/dist/sync/candidate-uploader.test.d.ts.map +1 -0
  68. package/dist/sync/candidate-uploader.test.js +132 -0
  69. package/dist/sync/candidate-uploader.test.js.map +1 -0
  70. package/dist/sync/delta-client.d.ts +73 -0
  71. package/dist/sync/delta-client.d.ts.map +1 -0
  72. package/dist/sync/delta-client.js +201 -0
  73. package/dist/sync/delta-client.js.map +1 -0
  74. package/dist/sync/delta-client.test.d.ts +2 -0
  75. package/dist/sync/delta-client.test.d.ts.map +1 -0
  76. package/dist/sync/delta-client.test.js +97 -0
  77. package/dist/sync/delta-client.test.js.map +1 -0
  78. package/dist/sync/durable-apply.d.ts +76 -0
  79. package/dist/sync/durable-apply.d.ts.map +1 -0
  80. package/dist/sync/durable-apply.js +530 -0
  81. package/dist/sync/durable-apply.js.map +1 -0
  82. package/dist/sync/durable-apply.test.d.ts +2 -0
  83. package/dist/sync/durable-apply.test.d.ts.map +1 -0
  84. package/dist/sync/durable-apply.test.js +180 -0
  85. package/dist/sync/durable-apply.test.js.map +1 -0
  86. package/dist/sync/event-sync.d.ts +33 -1
  87. package/dist/sync/event-sync.d.ts.map +1 -1
  88. package/dist/sync/event-sync.js +149 -1
  89. package/dist/sync/event-sync.js.map +1 -1
  90. package/dist/sync/event-sync.test.js +142 -1
  91. package/dist/sync/event-sync.test.js.map +1 -1
  92. package/dist/sync/index.d.ts +2 -0
  93. package/dist/sync/index.d.ts.map +1 -1
  94. package/dist/sync/index.js +1 -0
  95. package/dist/sync/index.js.map +1 -1
  96. package/dist/sync/multipart-uploader.d.ts +99 -0
  97. package/dist/sync/multipart-uploader.d.ts.map +1 -0
  98. package/dist/sync/multipart-uploader.js +447 -0
  99. package/dist/sync/multipart-uploader.js.map +1 -0
  100. package/dist/sync/multipart-uploader.test.d.ts +2 -0
  101. package/dist/sync/multipart-uploader.test.d.ts.map +1 -0
  102. package/dist/sync/multipart-uploader.test.js +119 -0
  103. package/dist/sync/multipart-uploader.test.js.map +1 -0
  104. package/dist/sync/mutation-client.d.ts +82 -0
  105. package/dist/sync/mutation-client.d.ts.map +1 -0
  106. package/dist/sync/mutation-client.js +221 -0
  107. package/dist/sync/mutation-client.js.map +1 -0
  108. package/dist/sync/mutation-client.test.d.ts +2 -0
  109. package/dist/sync/mutation-client.test.d.ts.map +1 -0
  110. package/dist/sync/mutation-client.test.js +51 -0
  111. package/dist/sync/mutation-client.test.js.map +1 -0
  112. package/dist/sync/push-receiver.d.ts +45 -0
  113. package/dist/sync/push-receiver.d.ts.map +1 -1
  114. package/dist/sync/push-receiver.js +101 -0
  115. package/dist/sync/push-receiver.js.map +1 -1
  116. package/dist/sync/push-receiver.test.js +54 -2
  117. package/dist/sync/push-receiver.test.js.map +1 -1
  118. package/dist/sync/scope-inventory-client.d.ts +69 -0
  119. package/dist/sync/scope-inventory-client.d.ts.map +1 -0
  120. package/dist/sync/scope-inventory-client.js +210 -0
  121. package/dist/sync/scope-inventory-client.js.map +1 -0
  122. package/dist/sync/scope-inventory-client.test.d.ts +2 -0
  123. package/dist/sync/scope-inventory-client.test.d.ts.map +1 -0
  124. package/dist/sync/scope-inventory-client.test.js +94 -0
  125. package/dist/sync/scope-inventory-client.test.js.map +1 -0
  126. package/dist/sync/snapshot-client.d.ts +98 -0
  127. package/dist/sync/snapshot-client.d.ts.map +1 -0
  128. package/dist/sync/snapshot-client.js +402 -0
  129. package/dist/sync/snapshot-client.js.map +1 -0
  130. package/dist/sync/snapshot-client.test.d.ts +2 -0
  131. package/dist/sync/snapshot-client.test.d.ts.map +1 -0
  132. package/dist/sync/snapshot-client.test.js +169 -0
  133. package/dist/sync/snapshot-client.test.js.map +1 -0
  134. package/dist/sync/uploader-finalization.d.ts +97 -0
  135. package/dist/sync/uploader-finalization.d.ts.map +1 -0
  136. package/dist/sync/uploader-finalization.js +273 -0
  137. package/dist/sync/uploader-finalization.js.map +1 -0
  138. package/dist/sync/uploader-finalization.test.d.ts +2 -0
  139. package/dist/sync/uploader-finalization.test.d.ts.map +1 -0
  140. package/dist/sync/uploader-finalization.test.js +92 -0
  141. package/dist/sync/uploader-finalization.test.js.map +1 -0
  142. package/dist/telemetry.d.ts +11 -1
  143. package/dist/telemetry.d.ts.map +1 -1
  144. package/dist/telemetry.js +21 -2
  145. package/dist/telemetry.js.map +1 -1
  146. package/dist/telemetry.test.js +80 -0
  147. package/dist/telemetry.test.js.map +1 -1
  148. package/package.json +6 -1
  149. package/.claude/policies/hq-cloud-esm-cannot-spy-fs-builtins.md +0 -30
  150. package/.claude/policies/hq-cloud-strip-types-no-parameter-properties.md +0 -22
  151. package/.github/workflows/ci.yml +0 -84
  152. package/.github/workflows/publish.yml +0 -56
  153. package/.github/workflows/unreleased-commits-nag.yml +0 -256
  154. package/eslint.config.js +0 -67
  155. package/pnpm-workspace.yaml +0 -2
  156. package/scripts/presign-transport-e2e.mjs +0 -250
  157. package/scripts/vault-rebaseline.sh +0 -323
  158. package/scripts/vault-rescue.sh +0 -332
  159. package/src/active-company.test.ts +0 -188
  160. package/src/active-company.ts +0 -168
  161. package/src/agent-codex-instructions.test.ts +0 -332
  162. package/src/agent-codex-instructions.ts +0 -309
  163. package/src/auth.ts +0 -146
  164. package/src/backup-prune.test.ts +0 -98
  165. package/src/backup-prune.ts +0 -182
  166. package/src/bin/backup-prune-runner.ts +0 -33
  167. package/src/bin/rescue-runner.ts +0 -25
  168. package/src/bin/sync-runner-company.ts +0 -695
  169. package/src/bin/sync-runner-events.test.ts +0 -143
  170. package/src/bin/sync-runner-events.ts +0 -55
  171. package/src/bin/sync-runner-planning.test.ts +0 -311
  172. package/src/bin/sync-runner-planning.ts +0 -258
  173. package/src/bin/sync-runner-rollup.test.ts +0 -37
  174. package/src/bin/sync-runner-rollup.ts +0 -97
  175. package/src/bin/sync-runner-telemetry.ts +0 -15
  176. package/src/bin/sync-runner-watch-loop.ts +0 -1235
  177. package/src/bin/sync-runner-watch-routes.test.ts +0 -71
  178. package/src/bin/sync-runner-watch-routes.ts +0 -184
  179. package/src/bin/sync-runner.test.ts +0 -8767
  180. package/src/bin/sync-runner.ts +0 -2190
  181. package/src/cli/accept.ts +0 -124
  182. package/src/cli/conflict.ts +0 -119
  183. package/src/cli/doctor.test.ts +0 -581
  184. package/src/cli/doctor.ts +0 -642
  185. package/src/cli/index.ts +0 -49
  186. package/src/cli/invite.test.ts +0 -250
  187. package/src/cli/invite.ts +0 -214
  188. package/src/cli/promote.ts +0 -157
  189. package/src/cli/reindex.test.ts +0 -957
  190. package/src/cli/reindex.ts +0 -970
  191. package/src/cli/rescue-classify-ordering.test.ts +0 -548
  192. package/src/cli/rescue-clone-diagnostics.test.ts +0 -120
  193. package/src/cli/rescue-core.ts +0 -3011
  194. package/src/cli/rescue-drift-reconcile.test.ts +0 -179
  195. package/src/cli/rescue-drop-dir-symlink.test.ts +0 -224
  196. package/src/cli/rescue-exec-bit-preserve.test.ts +0 -187
  197. package/src/cli/rescue-hq-root-guard.test.ts +0 -232
  198. package/src/cli/rescue-journal-reconcile.test.ts +0 -215
  199. package/src/cli/rescue-mtime-preserve.test.ts +0 -203
  200. package/src/cli/rescue-settings-reconcile.test.ts +0 -583
  201. package/src/cli/rescue-snapshot.test.ts +0 -57
  202. package/src/cli/rescue-snapshot.ts +0 -51
  203. package/src/cli/rescue.reindex.test.ts +0 -63
  204. package/src/cli/rescue.test.ts +0 -131
  205. package/src/cli/rescue.ts +0 -182
  206. package/src/cli/share.test.ts +0 -7843
  207. package/src/cli/share.ts +0 -3663
  208. package/src/cli/sync-scope.test.ts +0 -652
  209. package/src/cli/sync.test.ts +0 -5207
  210. package/src/cli/sync.ts +0 -3470
  211. package/src/cli/tombstones.ts +0 -106
  212. package/src/cli/watch-event-push-conflict.test.ts +0 -234
  213. package/src/client-info.test.ts +0 -214
  214. package/src/client-info.ts +0 -121
  215. package/src/cognito-auth.test.ts +0 -712
  216. package/src/cognito-auth.ts +0 -1422
  217. package/src/company-resolver.test.ts +0 -618
  218. package/src/company-resolver.ts +0 -521
  219. package/src/context.test.ts +0 -583
  220. package/src/context.ts +0 -378
  221. package/src/daemon-worker.ts +0 -26
  222. package/src/daemon.ts +0 -99
  223. package/src/entity-resolver.test.ts +0 -315
  224. package/src/entity-resolver.ts +0 -180
  225. package/src/ignore.test.ts +0 -466
  226. package/src/ignore.ts +0 -469
  227. package/src/index.ts +0 -439
  228. package/src/journal.test.ts +0 -968
  229. package/src/journal.ts +0 -765
  230. package/src/lib/cloud-authoritative.test.ts +0 -45
  231. package/src/lib/cloud-authoritative.ts +0 -59
  232. package/src/lib/conflict-file.ts +0 -86
  233. package/src/lib/conflict-index.ts +0 -289
  234. package/src/lib/conflict.test.ts +0 -348
  235. package/src/lib/describe-error.test.ts +0 -100
  236. package/src/lib/describe-error.ts +0 -58
  237. package/src/lib/exit-codes.ts +0 -24
  238. package/src/lib/machine-id.test.ts +0 -231
  239. package/src/lib/machine-id.ts +0 -175
  240. package/src/lib/net-errors.test.ts +0 -65
  241. package/src/lib/net-errors.ts +0 -86
  242. package/src/lib/readlink-safe.test.ts +0 -43
  243. package/src/lib/readlink-safe.ts +0 -29
  244. package/src/local-path-codec.test.ts +0 -138
  245. package/src/local-path-codec.ts +0 -161
  246. package/src/machine-auth.test.ts +0 -1323
  247. package/src/manifest-reconcile.test.ts +0 -1123
  248. package/src/manifest-reconcile.ts +0 -518
  249. package/src/object-io.test.ts +0 -1221
  250. package/src/object-io.ts +0 -1306
  251. package/src/operation-lock.test.ts +0 -484
  252. package/src/operation-lock.ts +0 -680
  253. package/src/outcome-telemetry.test.ts +0 -498
  254. package/src/outcome-telemetry.ts +0 -639
  255. package/src/personal-vault-exclusions.test.ts +0 -308
  256. package/src/personal-vault-exclusions.ts +0 -354
  257. package/src/personal-vault.test.ts +0 -756
  258. package/src/personal-vault.ts +0 -496
  259. package/src/prefix-coalesce.test.ts +0 -240
  260. package/src/prefix-coalesce.ts +0 -273
  261. package/src/public-surface.test.ts +0 -117
  262. package/src/qmd-reindex.test.ts +0 -877
  263. package/src/qmd-reindex.ts +0 -842
  264. package/src/read-only-state-dir.test.ts +0 -188
  265. package/src/remote-pull.test.ts +0 -1130
  266. package/src/remote-pull.ts +0 -618
  267. package/src/s3.symlink-materialize.test.ts +0 -492
  268. package/src/s3.test.ts +0 -1789
  269. package/src/s3.ts +0 -1532
  270. package/src/schemas/signal-types.test.ts +0 -82
  271. package/src/schemas/signal-types.ts +0 -38
  272. package/src/schemas/source-channels.test.ts +0 -82
  273. package/src/schemas/source-channels.ts +0 -53
  274. package/src/scope-shrink.test.ts +0 -633
  275. package/src/scope-shrink.ts +0 -481
  276. package/src/signals/get.test.ts +0 -310
  277. package/src/signals/get.ts +0 -75
  278. package/src/signals/internals.ts +0 -195
  279. package/src/signals/list.test.ts +0 -420
  280. package/src/signals/list.ts +0 -79
  281. package/src/signals/parse.ts +0 -8
  282. package/src/signals/types.ts +0 -91
  283. package/src/skill-telemetry.test.ts +0 -1825
  284. package/src/skill-telemetry.ts +0 -1439
  285. package/src/sources/get.test.ts +0 -293
  286. package/src/sources/get.ts +0 -66
  287. package/src/sources/internals.ts +0 -198
  288. package/src/sources/list.test.ts +0 -402
  289. package/src/sources/list.ts +0 -84
  290. package/src/sources/parse.ts +0 -43
  291. package/src/sources/types.ts +0 -84
  292. package/src/sync/event-sync.test.ts +0 -594
  293. package/src/sync/event-sync.ts +0 -545
  294. package/src/sync/feature-flags.test.ts +0 -378
  295. package/src/sync/feature-flags.ts +0 -62
  296. package/src/sync/index.ts +0 -76
  297. package/src/sync/lease-client.test.ts +0 -128
  298. package/src/sync/lease-client.ts +0 -207
  299. package/src/sync/logger.test.ts +0 -242
  300. package/src/sync/logger.ts +0 -79
  301. package/src/sync/metrics.test.ts +0 -462
  302. package/src/sync/metrics.ts +0 -213
  303. package/src/sync/pull-scope.ts +0 -265
  304. package/src/sync/push-event.test.ts +0 -266
  305. package/src/sync/push-event.ts +0 -224
  306. package/src/sync/push-receiver.test.ts +0 -566
  307. package/src/sync/push-receiver.ts +0 -1048
  308. package/src/sync/push-transport.ts +0 -231
  309. package/src/sync/realtime-rollout.test.ts +0 -86
  310. package/src/sync/realtime-rollout.ts +0 -262
  311. package/src/sync/state-store.test.ts +0 -194
  312. package/src/sync/state-store.ts +0 -727
  313. package/src/sync-core.ts +0 -58
  314. package/src/sync-progress.test.ts +0 -94
  315. package/src/sync-progress.ts +0 -140
  316. package/src/telemetry-events.test.ts +0 -88
  317. package/src/telemetry-events.ts +0 -205
  318. package/src/telemetry.test.ts +0 -1280
  319. package/src/telemetry.ts +0 -1109
  320. package/src/types.ts +0 -314
  321. package/src/vault-client.test.ts +0 -1380
  322. package/src/vault-client.ts +0 -1694
  323. package/src/version.ts +0 -24
  324. package/src/watch-roots.test.ts +0 -278
  325. package/src/watch-roots.ts +0 -162
  326. package/src/watcher-event-gate.test.ts +0 -212
  327. package/src/watcher.test.ts +0 -1079
  328. package/src/watcher.ts +0 -1741
  329. package/test/e2e/sync/cross-tenant-isolation.test.ts +0 -630
  330. package/test/e2e/sync/skill-telemetry-oversized-transcript.test.ts +0 -124
  331. package/test/e2e/sync/transient-company-leg.test.ts +0 -384
  332. package/test/e2e/sync/windows-unreadable-link-leg.test.ts +0 -191
  333. package/test/e2e/watcher-real-chokidar.test.ts +0 -165
  334. package/test/e2e/watcher-recursive-backend.test.ts +0 -181
  335. package/test/e2e/watcher-scoped-coverage.test.ts +0 -381
  336. package/test/invite-flow.integration.test.ts +0 -244
  337. package/test/joiner-manifest-reconcile.integration.test.ts +0 -322
  338. package/test/share-sync.integration.test.ts +0 -213
  339. package/tsconfig.json +0 -19
  340. package/vitest.config.ts +0 -22
@@ -1,308 +0,0 @@
1
- /**
2
- * Tests for `personal-vault-exclusions.ts`. Pin the regex / segment contracts
3
- * for every entry in PERSONAL_VAULT_DEFAULT_EXCLUSIONS so a future edit that
4
- * relaxes one (e.g. dropping the `_legacy-` prefix match, or changing the
5
- * `.cache_*` shape) surfaces here instead of in the field.
6
- *
7
- * Two test layers:
8
- *
9
- * 1. Per-rule predicate tests. Each exclusion is exercised with at least
10
- * one match-positive and one match-negative path so the regex shape is
11
- * pinned. The `byId` event field on the runner uses `ex.id` directly,
12
- * so the id stability is part of the contract too — tests assert
13
- * against the literal id string.
14
- *
15
- * 2. Filter-wrap integration. Confirms that `wrapFilterWithPersonalVaultDefaults`
16
- * defers to the underlying filter, computes the relative path correctly,
17
- * and only fires the `onExcluded` callback when the underlying filter
18
- * WOULD have allowed the path (so the count tracks only "newly blocked
19
- * by these defaults", not "blocked by .hqignore too").
20
- */
21
-
22
- import { describe, expect, it } from "vitest";
23
- import * as path from "node:path";
24
- import {
25
- PERSONAL_VAULT_DEFAULT_EXCLUSIONS,
26
- isPersonalVaultExcluded,
27
- matchPersonalVaultExclusion,
28
- wrapFilterWithPersonalVaultDefaults,
29
- _testing,
30
- } from "./personal-vault-exclusions.js";
31
-
32
- describe("PERSONAL_VAULT_DEFAULT_EXCLUSIONS", () => {
33
- it("exports a non-empty, frozen-shaped list", () => {
34
- expect(PERSONAL_VAULT_DEFAULT_EXCLUSIONS.length).toBeGreaterThan(10);
35
- // Every entry has the four required fields; this pins the public shape
36
- // so a future addition without `category` or `id` fails fast.
37
- for (const ex of PERSONAL_VAULT_DEFAULT_EXCLUSIONS) {
38
- expect(typeof ex.id).toBe("string");
39
- expect(ex.id.length).toBeGreaterThan(0);
40
- expect(typeof ex.category).toBe("string");
41
- expect(typeof ex.test).toBe("function");
42
- expect(typeof ex.pattern).toBe("string");
43
- }
44
- });
45
-
46
- it("has unique ids (event byId aggregation requires it)", () => {
47
- const ids = new Set<string>();
48
- for (const ex of PERSONAL_VAULT_DEFAULT_EXCLUSIONS) {
49
- expect(ids.has(ex.id)).toBe(false);
50
- ids.add(ex.id);
51
- }
52
- });
53
- });
54
-
55
- // ── Per-rule predicate matrix ───────────────────────────────────────────────
56
- //
57
- // One block per rule. The positives prove "this path SHOULD be excluded"; the
58
- // negatives prove "this path SHOULD NOT" (guards against over-broad regexes
59
- // that would block legitimate user content).
60
-
61
- describe("env-file exclusion (secrets)", () => {
62
- it.each([".env", ".env.local", ".env.production", "core/.env", "personal/.env.local"])(
63
- "matches %s",
64
- (p) => {
65
- expect(isPersonalVaultExcluded(p)).toBe(true);
66
- expect(matchPersonalVaultExclusion(p)?.id).toBe("env-file");
67
- },
68
- );
69
-
70
- it.each(["envconfig.md", ".env-example.md", "core/policies/env-vars.md"])(
71
- "does NOT match %s",
72
- (p) => {
73
- // ".env-example.md" is intentionally a negative — the basename starts
74
- // with ".env-", not ".env." (dot vs hyphen). We want to allow docs
75
- // that reference env-vars without the regex grabbing them.
76
- const m = matchPersonalVaultExclusion(p);
77
- expect(m?.id).not.toBe("env-file");
78
- },
79
- );
80
- });
81
-
82
- describe("mcp-config exclusion (secrets)", () => {
83
- it.each([".mcp.json", "personal/.mcp.json", "core/.claude/.mcp.json"])(
84
- "matches %s",
85
- (p) => {
86
- expect(matchPersonalVaultExclusion(p)?.id).toBe("mcp-config");
87
- },
88
- );
89
-
90
- it.each(["mcp.json", "core/policies/mcp.md", ".mcp.example.json"])(
91
- "does NOT match %s",
92
- (p) => {
93
- expect(matchPersonalVaultExclusion(p)?.id).not.toBe("mcp-config");
94
- },
95
- );
96
- });
97
-
98
- describe("beads exclusion (machine-local SQLite)", () => {
99
- it.each([
100
- ".beads/beads.db",
101
- ".beads/beads.db-wal",
102
- ".beads/beads.db-shm",
103
- ".beads/beads.left.jsonl",
104
- "personal/.beads/issue.json",
105
- ])("matches %s", (p) => {
106
- expect(matchPersonalVaultExclusion(p)?.id).toBe("beads-db");
107
- });
108
-
109
- it.each(["beads.md", "core/knowledge/beads-guide.md"])("does NOT match %s", (p) => {
110
- expect(matchPersonalVaultExclusion(p)?.id).not.toBe("beads-db");
111
- });
112
- });
113
-
114
- describe("obsidian / vercel / cache exclusions", () => {
115
- it("matches .obsidian/", () => {
116
- expect(matchPersonalVaultExclusion(".obsidian/workspace.json")?.id).toBe("obsidian-workspace");
117
- });
118
- it("matches .vercel/", () => {
119
- expect(matchPersonalVaultExclusion(".vercel/project.json")?.id).toBe("vercel-link");
120
- });
121
- it("matches .cache_ggshield", () => {
122
- expect(matchPersonalVaultExclusion(".cache_ggshield")?.id).toBe("cache-dir");
123
- });
124
- it("matches .cache_anything", () => {
125
- expect(matchPersonalVaultExclusion(".cache_foo")?.id).toBe("cache-dir");
126
- });
127
- it("does NOT match .cache (no underscore)", () => {
128
- // `.cache_*` is the segment shape — bare `.cache` should be left for
129
- // other rules / .hqignore. Pinned so a future widen-of-pattern surfaces here.
130
- expect(matchPersonalVaultExclusion(".cache")).toBeUndefined();
131
- });
132
- });
133
-
134
- describe("update-output / legacy / hq-conflicts exclusions (scratch)", () => {
135
- it.each([
136
- "output/hatch-pet/scaffold.md",
137
- "personal/data/output/hatch-pet/file.md",
138
- "core/output/x.md",
139
- ])("matches %s as update-output", (p) => {
140
- expect(matchPersonalVaultExclusion(p)?.id).toBe("update-output");
141
- });
142
-
143
- it.each([
144
- "_legacy-pre14.2/x.md",
145
- "personal/_legacy-2024/old.md",
146
- "_legacy_v1/y.md",
147
- "_legacy/z.md",
148
- ])("matches %s as legacy-dir", (p) => {
149
- expect(matchPersonalVaultExclusion(p)?.id).toBe("legacy-dir");
150
- });
151
-
152
- it.each([".hq-conflicts/file.md", "personal/.hq-conflicts/x.md"])(
153
- "matches %s as hq-conflicts-dir",
154
- (p) => {
155
- expect(matchPersonalVaultExclusion(p)?.id).toBe("hq-conflicts-dir");
156
- },
157
- );
158
-
159
- it("does NOT match 'output.md' (basename collision guard)", () => {
160
- expect(matchPersonalVaultExclusion("core/output.md")).toBeUndefined();
161
- });
162
- });
163
-
164
- describe("OS / build cruft exclusions", () => {
165
- it("matches .DS_Store anywhere", () => {
166
- expect(matchPersonalVaultExclusion(".DS_Store")?.id).toBe("ds-store");
167
- expect(matchPersonalVaultExclusion("personal/.DS_Store")?.id).toBe("ds-store");
168
- });
169
-
170
- it.each([
171
- ["node_modules/x.js", "node-modules"],
172
- ["personal/x/node_modules/y.js", "node-modules"],
173
- ["dist/bundle.js", "dist-dir"],
174
- [".next/build/file.js", "next-dir"],
175
- ["build/output.js", "build-dir"],
176
- // Regression: the personal vault was re-uploading the pnpm cache because
177
- // its exclusion list (separate from the company DEFAULT_IGNORES) missed
178
- // .pnpm-store — 9.5k+ junk files dominated the personal sync count.
179
- [".pnpm-store/v10/files/00/abc", "pnpm-store"],
180
- ["personal/x/.pnpm-store/v10/y", "pnpm-store"],
181
- ])("matches %s as %s", (p, expectedId) => {
182
- expect(matchPersonalVaultExclusion(p)?.id).toBe(expectedId);
183
- });
184
- });
185
-
186
- describe("generated namespaced skill-wrapper exclusion", () => {
187
- it.each([
188
- ".claude/skills/indigo:call-prep-brief/scripts",
189
- ".claude/skills/indigo:team-agent-telemetry-report/agents",
190
- ".claude/skills/indigo%3Astandup-brief/template",
191
- ".claude/skills/core:review/SKILL.md",
192
- ])("excludes the derived link-farm path %s", (p) => {
193
- expect(matchPersonalVaultExclusion(p)?.id).toBe("generated-skill-wrapper");
194
- });
195
-
196
- it.each([
197
- ".claude/skills/deep-plan/SKILL.md",
198
- "personal/skills/indigo:custom/SKILL.md",
199
- ".claude/skills/indigo-call-prep/scripts",
200
- ".claude/skills/:missing-namespace/SKILL.md",
201
- ".claude/skills/missing-skill:/SKILL.md",
202
- ])("does not exclude non-wrapper content %s", (p) => {
203
- expect(matchPersonalVaultExclusion(p)?.id).not.toBe(
204
- "generated-skill-wrapper",
205
- );
206
- });
207
- });
208
-
209
- describe("generated namespaced command-wrapper exclusion", () => {
210
- it.each([
211
- ".claude/commands/core:review.md",
212
- ".claude/commands/indigo:standup-brief.md",
213
- ".claude/commands/personal:note.md",
214
- ".claude/commands/hq-pack-demo:hello.md",
215
- ".claude/commands/indigo%3Astandup-brief.md",
216
- ])("excludes the derived command-link path %s", (p) => {
217
- expect(matchPersonalVaultExclusion(p)?.id).toBe("generated-command-wrapper");
218
- });
219
-
220
- it.each([
221
- // A canonical source command (under the namespace, not .claude/) — synced.
222
- "core/commands/review.md",
223
- "personal/commands/note.md",
224
- // A native, non-namespaced Claude command file — not a reindex link.
225
- ".claude/commands/deploy.md",
226
- // Leading colon → no namespace text before it, must not be swept up.
227
- ".claude/commands/:missing-namespace.md",
228
- ])("does not exclude non-wrapper content %s", (p) => {
229
- expect(matchPersonalVaultExclusion(p)?.id).not.toBe("generated-command-wrapper");
230
- });
231
- });
232
-
233
- // ── _testing internals ───────────────────────────────────────────────────────
234
-
235
- describe("_testing internals", () => {
236
- it("hasSegment matches exact / prefix / middle / suffix forms", () => {
237
- expect(_testing.hasSegment("foo", "foo")).toBe(true);
238
- expect(_testing.hasSegment("foo/bar", "foo")).toBe(true);
239
- expect(_testing.hasSegment("a/foo/b", "foo")).toBe(true);
240
- expect(_testing.hasSegment("a/foo", "foo")).toBe(true);
241
- expect(_testing.hasSegment("foobar", "foo")).toBe(false);
242
- expect(_testing.hasSegment("a/foobar", "foo")).toBe(false);
243
- });
244
-
245
- it("basename returns the trailing segment", () => {
246
- expect(_testing.basename("a/b/c.md")).toBe("c.md");
247
- expect(_testing.basename("c.md")).toBe("c.md");
248
- expect(_testing.basename("")).toBe("");
249
- });
250
- });
251
-
252
- // ── Filter-wrap integration ──────────────────────────────────────────────────
253
-
254
- describe("wrapFilterWithPersonalVaultDefaults", () => {
255
- // Use a syncRoot path independent of the test runner's cwd so the
256
- // path.relative() calls inside the wrapper produce predictable results
257
- // regardless of where the test runs from.
258
- const syncRoot = "/tmp/hq-root";
259
-
260
- it("defers to the underlying filter when it rejects", () => {
261
- const calls: Array<{ rel: string; id: string }> = [];
262
- const wrapped = wrapFilterWithPersonalVaultDefaults(
263
- () => false, // underlying rejects everything
264
- syncRoot,
265
- (rel, match) => calls.push({ rel, id: match.id }),
266
- );
267
-
268
- // Even though `.env` matches a default exclusion, the underlying
269
- // filter already rejected it — onExcluded must NOT fire (we only
270
- // want to count things that would have made it past the user's
271
- // .hqignore but are blocked by our defaults).
272
- expect(wrapped(path.join(syncRoot, ".env"))).toBe(false);
273
- expect(calls).toEqual([]);
274
- });
275
-
276
- it("rejects and tags onExcluded when underlying allows + default blocks", () => {
277
- const calls: Array<{ rel: string; id: string }> = [];
278
- const wrapped = wrapFilterWithPersonalVaultDefaults(
279
- () => true, // underlying allows everything
280
- syncRoot,
281
- (rel, match) => calls.push({ rel, id: match.id }),
282
- );
283
-
284
- expect(wrapped(path.join(syncRoot, ".env"))).toBe(false);
285
- expect(wrapped(path.join(syncRoot, "personal", ".env.local"))).toBe(false);
286
- expect(wrapped(path.join(syncRoot, "personal", "agents.md"))).toBe(true);
287
- expect(calls).toEqual([
288
- { rel: ".env", id: "env-file" },
289
- { rel: "personal/.env.local", id: "env-file" },
290
- // "personal/agents.md" was allowed — no onExcluded callback fired.
291
- ]);
292
- });
293
-
294
- it("does not fire onExcluded for paths outside syncRoot (defensive)", () => {
295
- const calls: Array<{ rel: string; id: string }> = [];
296
- const wrapped = wrapFilterWithPersonalVaultDefaults(
297
- () => true,
298
- syncRoot,
299
- (rel, match) => calls.push({ rel, id: match.id }),
300
- );
301
-
302
- // Outside-syncRoot paths come back with a `..` prefix from path.relative;
303
- // the wrapper defers (returns true) without consulting the exclusion
304
- // list since "outside scope" is the upstream containment check's job.
305
- expect(wrapped("/tmp/other/.env")).toBe(true);
306
- expect(calls).toEqual([]);
307
- });
308
- });
@@ -1,354 +0,0 @@
1
- /**
2
- * Personal-vault default exclusions — second-tier scope filter that complements
3
- * `PERSONAL_VAULT_EXCLUDED_TOP_LEVEL` (`.git`, `companies`, `repos`,
4
- * `workspace`) in `./personal-vault.ts`.
5
- *
6
- * Where the top-level constant filters the four big buckets at scope root, this
7
- * file filters categories of nested files that ride along with an HQ install
8
- * but have no business round-tripping to a personal vault — regardless of
9
- * where they sit in the tree:
10
- *
11
- * 1. Secrets at root or nested. `.env`, `.env.local`, `.env.<anything>`,
12
- * `.mcp.json`. Pre-fix these were being uploaded if the user hadn't
13
- * added `.env` to their `.hqignore` (the default starter `.hqignore`
14
- * only listed `companies/*\/settings/`).
15
- *
16
- * 2. Machine-local state. `.beads/` (SQLite issue-tracker + WAL/SHM),
17
- * `.obsidian/`, `.vercel/`, `.cache_*`. Per-machine layouts/caches;
18
- * multi-device sync either corrupts (SQLite WAL) or causes spurious
19
- * churn (caches regenerate on demand).
20
- *
21
- * 3. Update-flow scratch. `output/`, `_legacy-*` directories. Created by
22
- * `/update-hq` / `/promote-hq-core` workflows as checkout scratch;
23
- * naming themselves "legacy" / sitting under "output" is a self-
24
- * declared "do not preserve" signal.
25
- *
26
- * 4. Pre-5.24 conflict mirror dir. `.hq-conflicts/` is a directory of
27
- * mirror copies from older sync runs (sibling to the now-fixed
28
- * `.conflict-YYYY-MM-DDTHH-MM-SSZ-{hash}.{ext}` ephemeral files
29
- * handled by `EPHEMERAL_PATH_PATTERN` in share.ts). Same logic
30
- * applies: these are local-only safety backups.
31
- *
32
- * 5. Reindex-generated skill wrappers. `.claude/skills/<ns>:<skill>/`
33
- * (encoded as `<ns>%3A<skill>` on Windows) is a derived link farm over
34
- * canonical `core/`, `personal/`, package, or company skill sources.
35
- * Syncing the links duplicates their owners and makes personal pulls
36
- * fight reindex over directory links.
37
- *
38
- * 6. OS / build cruft. `.DS_Store`, `node_modules/`, `dist/`, `.next/`,
39
- * `build/`. Universally noise inside HQ (personal scope should not
40
- * contain code projects, but defense-in-depth catches anyone who
41
- * symlinks a project subtree in).
42
- *
43
- * Policy: refuse + warn (5.25 default). The walk filter drops these so they
44
- * never upload; the delete-plan walker uses the same filter so already-
45
- * journaled entries that match a new exclusion get orphaned in the journal
46
- * (no DELETE issued, no churn). A one-shot purge script handles the cleanup
47
- * of objects that landed on remote before this version.
48
- *
49
- * Application scope: personal vault only. Company vaults have separate
50
- * first-push protection (settings/, data/, workers/, .git/ exclusion in
51
- * `src-tauri/src/util/ignore.rs`) and may legitimately ship `output/` or
52
- * `.env*` paths inside their data folders. Wired only when `personalMode`
53
- * is true.
54
- *
55
- * Wire-points (parallel to `EPHEMERAL_PATH_PATTERN`):
56
- * - `collectFiles` / `walkDir` (push) — wrap `shouldSync` so excluded
57
- * relative paths are rejected before upload.
58
- * - `computeDeletePlan` (delete) — same `shouldSync` wrap, so journal
59
- * entries matching an exclusion are skipped on the delete pass too.
60
- * - `computePullPlan` (pull) — reject legacy remote objects before any
61
- * local inspection or download so excluded state cannot rematerialize.
62
- */
63
-
64
- import * as path from "path";
65
-
66
- /**
67
- * Each entry is matched against the relative path from the personal-vault
68
- * sync root (which IS hq_root in personalMode), using forward-slash
69
- * separators. Patterns:
70
- *
71
- * - `prefix:foo/` — match if the path starts with `foo/` or equals `foo`
72
- * (handles both the dir itself and any descendant)
73
- * - `basename:.env` — match if any path segment equals `.env`
74
- * - `basename:.env-prefix:.env.` — match if the basename starts with `.env.`
75
- * - `segment:node_modules` — match if any path segment equals literally
76
- *
77
- * The literal-segment form catches nested cases (e.g., `repos/foo/node_modules/`
78
- * is already excluded by top-level repos/ skip, but `personal/x/node_modules/`
79
- * would slip through without segment matching).
80
- */
81
- export interface PersonalVaultExclusion {
82
- /** Internal id for telemetry / explainability in events. */
83
- id: string;
84
- /** Human-readable category for the warning event. */
85
- category:
86
- | "secret"
87
- | "machine-local"
88
- | "scratch"
89
- | "conflict-mirror"
90
- | "generated-mirror"
91
- | "os-cruft"
92
- | "build-output";
93
- /**
94
- * Predicate. Pure: relative path (forward-slash separated, no leading slash)
95
- * + optional isDir hint. Returns true to EXCLUDE.
96
- */
97
- test: (relPath: string, isDir?: boolean) => boolean;
98
- /** Doc-only — shown alongside `id` in the warning event sample. */
99
- pattern: string;
100
- }
101
-
102
- /**
103
- * Cheap segment-equality check. Avoids allocating a regex per call.
104
- */
105
- function hasSegment(relPath: string, segment: string): boolean {
106
- if (relPath === segment) return true;
107
- if (relPath.startsWith(`${segment}/`)) return true;
108
- return relPath.includes(`/${segment}/`) || relPath.endsWith(`/${segment}`);
109
- }
110
-
111
- function basename(relPath: string): string {
112
- const i = relPath.lastIndexOf("/");
113
- return i === -1 ? relPath : relPath.slice(i + 1);
114
- }
115
-
116
- /**
117
- * Reindex owns every namespaced wrapper under `.claude/skills/`. The wrapper
118
- * segment is `<namespace>:<skill>` on POSIX and `<namespace>%3A<skill>` after
119
- * the Win32 local-path codec escapes the reserved colon. Require non-empty
120
- * names on both sides so hand-authored malformed paths are not swept up.
121
- */
122
- /**
123
- * True when a `.claude/{skills,commands}` path segment carries the reindex
124
- * `<namespace>:<name>` marker — a literal ':' or its Win32 `%3A` encoding —
125
- * with non-empty text on BOTH sides (so a malformed ':x' / 'x:' / trailing
126
- * '%3A' is not swept up). Shared by the skill-wrapper and command-wrapper
127
- * detectors so both track the exact naming reindex emits.
128
- */
129
- function segmentHasNamespaceColon(segment: string): boolean {
130
- const literalColon = segment.indexOf(":");
131
- if (literalColon > 0 && literalColon < segment.length - 1) return true;
132
-
133
- const encodedColon = segment.toUpperCase().indexOf("%3A");
134
- return encodedColon > 0 && encodedColon + 3 < segment.length;
135
- }
136
-
137
- function isGeneratedSkillWrapperPath(relPath: string): boolean {
138
- const parts = relPath.split("/");
139
- if (parts[0] !== ".claude" || parts[1] !== "skills" || parts.length < 3) {
140
- return false;
141
- }
142
- return segmentHasNamespaceColon(parts[2] ?? "");
143
- }
144
-
145
- // reindex surfaces slash commands as `.claude/commands/<ns>:<cmd>.md` symlinks
146
- // (single file per source, the flat sibling of the skill link farm). Their
147
- // canonical sources live under `<ns>/commands/`, so the generated `.claude/`
148
- // surface must be excluded from personal-vault push/pull just like the skill
149
- // wrappers — otherwise reindex-owned links round-trip as user data and can
150
- // re-wake the watcher.
151
- export function isGeneratedCommandWrapperPath(relPath: string): boolean {
152
- const parts = relPath.split("/");
153
- if (parts[0] !== ".claude" || parts[1] !== "commands" || parts.length < 3) {
154
- return false;
155
- }
156
- return segmentHasNamespaceColon(parts[2] ?? "");
157
- }
158
-
159
- export const PERSONAL_VAULT_DEFAULT_EXCLUSIONS: readonly PersonalVaultExclusion[] = [
160
- // ── secrets ───────────────────────────────────────────────────────────
161
- {
162
- id: "env-file",
163
- category: "secret",
164
- pattern: "**/.env, **/.env.*",
165
- test: (p) => {
166
- const b = basename(p);
167
- return b === ".env" || b.startsWith(".env.");
168
- },
169
- },
170
- {
171
- id: "mcp-config",
172
- category: "secret",
173
- pattern: "**/.mcp.json",
174
- test: (p) => basename(p) === ".mcp.json",
175
- },
176
- // ── machine-local tooling state ───────────────────────────────────────
177
- {
178
- id: "beads-db",
179
- category: "machine-local",
180
- pattern: "**/.beads/**",
181
- test: (p) => hasSegment(p, ".beads"),
182
- },
183
- {
184
- id: "obsidian-workspace",
185
- category: "machine-local",
186
- pattern: "**/.obsidian/**",
187
- test: (p) => hasSegment(p, ".obsidian"),
188
- },
189
- {
190
- id: "vercel-link",
191
- category: "machine-local",
192
- pattern: "**/.vercel/**",
193
- test: (p) => hasSegment(p, ".vercel"),
194
- },
195
- {
196
- id: "cache-dir",
197
- category: "machine-local",
198
- pattern: "**/.cache_*",
199
- test: (p) => basename(p).startsWith(".cache_"),
200
- },
201
- // ── update-flow scratch ───────────────────────────────────────────────
202
- {
203
- id: "update-output",
204
- category: "scratch",
205
- pattern: "**/output/**",
206
- test: (p) => hasSegment(p, "output"),
207
- },
208
- {
209
- id: "legacy-dir",
210
- category: "scratch",
211
- pattern: "**/_legacy-*/**",
212
- test: (p) => {
213
- // Match any segment that starts with `_legacy-` or `_legacy_` or equals `_legacy`.
214
- const segs = p.split("/");
215
- return segs.some(
216
- (s) => s === "_legacy" || s.startsWith("_legacy-") || s.startsWith("_legacy_"),
217
- );
218
- },
219
- },
220
- // ── pre-5.24 conflict mirror directory ────────────────────────────────
221
- // Sibling to EPHEMERAL_PATH_PATTERN (handles the .conflict-<iso>-<hash>.ext
222
- // file form). This handles the older directory form some HQ installs
223
- // accumulated.
224
- {
225
- id: "hq-conflicts-dir",
226
- category: "conflict-mirror",
227
- pattern: "**/.hq-conflicts/**",
228
- test: (p) => hasSegment(p, ".hq-conflicts"),
229
- },
230
- // ── reindex-generated link farm ───────────────────────────────────────
231
- {
232
- id: "generated-skill-wrapper",
233
- category: "generated-mirror",
234
- pattern: ".claude/skills/<namespace>:<skill>/**",
235
- test: (p) => isGeneratedSkillWrapperPath(p),
236
- },
237
- {
238
- id: "generated-command-wrapper",
239
- category: "generated-mirror",
240
- pattern: ".claude/commands/<namespace>:<command>.md",
241
- test: (p) => isGeneratedCommandWrapperPath(p),
242
- },
243
- // ── OS / build cruft ──────────────────────────────────────────────────
244
- {
245
- id: "ds-store",
246
- category: "os-cruft",
247
- pattern: "**/.DS_Store",
248
- test: (p) => basename(p) === ".DS_Store",
249
- },
250
- {
251
- id: "node-modules",
252
- category: "build-output",
253
- pattern: "**/node_modules/**",
254
- test: (p) => hasSegment(p, "node_modules"),
255
- },
256
- {
257
- // pnpm's content-addressed store. Tens of thousands of cache files that
258
- // regenerate on `pnpm install` — never personal data, pure churn. The
259
- // company sync already ignores it (DEFAULT_IGNORES `.pnpm-store/`); the
260
- // personal vault used a separate exclusion list that missed it, so the
261
- // cache round-tripped to the vault and dominated the personal sync count.
262
- id: "pnpm-store",
263
- category: "build-output",
264
- pattern: "**/.pnpm-store/**",
265
- test: (p) => hasSegment(p, ".pnpm-store"),
266
- },
267
- {
268
- id: "dist-dir",
269
- category: "build-output",
270
- pattern: "**/dist/**",
271
- test: (p) => hasSegment(p, "dist"),
272
- },
273
- {
274
- id: "next-dir",
275
- category: "build-output",
276
- pattern: "**/.next/**",
277
- test: (p) => hasSegment(p, ".next"),
278
- },
279
- {
280
- id: "build-dir",
281
- category: "build-output",
282
- pattern: "**/build/**",
283
- test: (p) => hasSegment(p, "build"),
284
- },
285
- ];
286
-
287
- /**
288
- * First-match result for a path. Returns the matching exclusion (so callers
289
- * can surface category/id in events) or undefined for "not excluded".
290
- */
291
- export function matchPersonalVaultExclusion(
292
- relPath: string,
293
- isDir?: boolean,
294
- ): PersonalVaultExclusion | undefined {
295
- for (const ex of PERSONAL_VAULT_DEFAULT_EXCLUSIONS) {
296
- if (ex.test(relPath, isDir)) return ex;
297
- }
298
- return undefined;
299
- }
300
-
301
- /**
302
- * Boolean version — true if any exclusion matches.
303
- */
304
- export function isPersonalVaultExcluded(relPath: string, isDir?: boolean): boolean {
305
- return matchPersonalVaultExclusion(relPath, isDir) !== undefined;
306
- }
307
-
308
- /**
309
- * Wrap an existing path filter (typically from `createIgnoreFilter`) with the
310
- * personal-vault default exclusions. The wrapper:
311
- *
312
- * 1. Calls the underlying filter first; if it already rejects, defer
313
- * (counter does not fire — we only want to count things the underlying
314
- * filter would have allowed but the personal-vault defaults reject).
315
- * 2. Computes a relative path from `syncRoot` (the personal-vault sync
316
- * root, which is hq_root in personalMode).
317
- * 3. Probes `matchPersonalVaultExclusion`; if it matches, returns false
318
- * and tags the match via `onExcluded` so the runner can emit a single
319
- * `personal-vault-out-of-policy` event with a count + sample at end of
320
- * run.
321
- *
322
- * The wrapper keeps the `(absolutePath, isDir) => boolean` shape the existing
323
- * collectFiles / walkDir / computeDeletePlan code already uses, so wiring is
324
- * a single line change at the share() filter construction site.
325
- */
326
- export function wrapFilterWithPersonalVaultDefaults(
327
- underlying: (absPath: string, isDir?: boolean) => boolean,
328
- syncRoot: string,
329
- onExcluded: (relPath: string, match: PersonalVaultExclusion) => void,
330
- ): (absPath: string, isDir?: boolean) => boolean {
331
- return (absPath: string, isDir?: boolean) => {
332
- if (!underlying(absPath, isDir)) return false;
333
- const rel = path.relative(syncRoot, absPath).split(path.sep).join("/");
334
- if (rel === "" || rel.startsWith("..")) return true; // outside scope, defer
335
- const match = matchPersonalVaultExclusion(rel, isDir);
336
- if (match) {
337
- onExcluded(rel, match);
338
- return false;
339
- }
340
- return true;
341
- };
342
- }
343
-
344
- /**
345
- * Test-only export. Mirrors the `_testing` namespace pattern used by
346
- * `share.ts` for `EPHEMERAL_PATH_PATTERN` — direct access to the list +
347
- * internal helpers for regression-critical pinning without round-tripping
348
- * through share().
349
- */
350
- export const _testing = {
351
- hasSegment,
352
- basename,
353
- isGeneratedSkillWrapperPath,
354
- };