@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,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
- };