peaks-loop 4.1.3 → 4.1.5

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 (628) hide show
  1. package/.claude-plugin/marketplace.json +7 -2
  2. package/CHANGELOG.md +168 -0
  3. package/README-en.md +1 -1
  4. package/README.md +1 -1
  5. package/dist/cli/cli-helpers.d.ts +20 -0
  6. package/dist/cli/cli-helpers.js +34 -0
  7. package/dist/cli/commands/_register.js +2 -0
  8. package/dist/cli/commands/asset-command-shared.d.ts +12 -0
  9. package/dist/cli/commands/asset-command-shared.js +45 -0
  10. package/dist/cli/commands/asset-commands.d.ts +6 -1
  11. package/dist/cli/commands/asset-commands.js +11 -372
  12. package/dist/cli/commands/asset-crystallize-command.d.ts +3 -0
  13. package/dist/cli/commands/asset-crystallize-command.js +60 -0
  14. package/dist/cli/commands/asset-crystallize-payload.d.ts +47 -0
  15. package/dist/cli/commands/asset-crystallize-payload.js +85 -0
  16. package/dist/cli/commands/asset-crystallize-runner.d.ts +3 -0
  17. package/dist/cli/commands/asset-crystallize-runner.js +133 -0
  18. package/dist/cli/commands/asset-dispose-command.d.ts +3 -0
  19. package/dist/cli/commands/asset-dispose-command.js +99 -0
  20. package/dist/cli/commands/asset-status-command.d.ts +3 -0
  21. package/dist/cli/commands/asset-status-command.js +100 -0
  22. package/dist/cli/commands/baseline-audit-command.d.ts +3 -0
  23. package/dist/cli/commands/baseline-audit-command.js +64 -0
  24. package/dist/cli/commands/baseline-command-shared.d.ts +23 -0
  25. package/dist/cli/commands/baseline-command-shared.js +39 -0
  26. package/dist/cli/commands/baseline-commands.js +33 -313
  27. package/dist/cli/commands/baseline-freeze-commands.d.ts +4 -0
  28. package/dist/cli/commands/baseline-freeze-commands.js +81 -0
  29. package/dist/cli/commands/baseline-guard-command.d.ts +3 -0
  30. package/dist/cli/commands/baseline-guard-command.js +52 -0
  31. package/dist/cli/commands/baseline-read-commands.d.ts +5 -0
  32. package/dist/cli/commands/baseline-read-commands.js +72 -0
  33. package/dist/cli/commands/baseline-rollback-commands.d.ts +4 -0
  34. package/dist/cli/commands/baseline-rollback-commands.js +88 -0
  35. package/dist/cli/commands/classify-downgrade-command.d.ts +9 -0
  36. package/dist/cli/commands/classify-downgrade-command.js +21 -0
  37. package/dist/cli/commands/classify-run-command.d.ts +9 -0
  38. package/dist/cli/commands/classify-run-command.js +73 -0
  39. package/dist/cli/commands/classify-signals.d.ts +5 -0
  40. package/dist/cli/commands/classify-signals.js +104 -0
  41. package/dist/cli/commands/code-commands.d.ts +6 -4
  42. package/dist/cli/commands/code-commands.js +6 -4
  43. package/dist/cli/commands/code-emit-handoff-command.js +40 -3
  44. package/dist/cli/commands/code-gate-command.d.ts +5 -5
  45. package/dist/cli/commands/code-gate-command.js +49 -9
  46. package/dist/cli/commands/code-gate-step-08-command.js +25 -9
  47. package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
  48. package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
  49. package/dist/cli/commands/codegraph-command-options.d.ts +22 -0
  50. package/dist/cli/commands/codegraph-command-options.js +22 -0
  51. package/dist/cli/commands/codegraph-commands.d.ts +2 -2
  52. package/dist/cli/commands/codegraph-commands.js +14 -397
  53. package/dist/cli/commands/codegraph-config-restore-command.d.ts +3 -0
  54. package/dist/cli/commands/codegraph-config-restore-command.js +200 -0
  55. package/dist/cli/commands/codegraph-proxy-commands.d.ts +10 -0
  56. package/dist/cli/commands/codegraph-proxy-commands.js +159 -0
  57. package/dist/cli/commands/codegraph-repair-commands.d.ts +3 -0
  58. package/dist/cli/commands/codegraph-repair-commands.js +94 -0
  59. package/dist/cli/commands/codegraph-status-command.d.ts +1 -1
  60. package/dist/cli/commands/codegraph-status-command.js +27 -214
  61. package/dist/cli/commands/codegraph-status-integrity.d.ts +44 -0
  62. package/dist/cli/commands/codegraph-status-integrity.js +121 -0
  63. package/dist/cli/commands/codegraph-status-json.d.ts +5 -0
  64. package/dist/cli/commands/codegraph-status-json.js +127 -0
  65. package/dist/cli/commands/container-command-shared.d.ts +60 -0
  66. package/dist/cli/commands/container-command-shared.js +52 -0
  67. package/dist/cli/commands/container-commands.d.ts +1 -1
  68. package/dist/cli/commands/container-commands.js +4 -216
  69. package/dist/cli/commands/container-release-command.d.ts +3 -0
  70. package/dist/cli/commands/container-release-command.js +105 -0
  71. package/dist/cli/commands/container-spawn-command.d.ts +3 -0
  72. package/dist/cli/commands/container-spawn-command.js +148 -0
  73. package/dist/cli/commands/context-check-command.d.ts +3 -0
  74. package/dist/cli/commands/context-check-command.js +81 -0
  75. package/dist/cli/commands/context-commands.d.ts +2 -7
  76. package/dist/cli/commands/context-commands.js +6 -276
  77. package/dist/cli/commands/context-layer-command.d.ts +3 -0
  78. package/dist/cli/commands/context-layer-command.js +34 -0
  79. package/dist/cli/commands/context-layer-fetchers.d.ts +15 -0
  80. package/dist/cli/commands/context-layer-fetchers.js +162 -0
  81. package/dist/cli/commands/context-status-command.d.ts +17 -0
  82. package/dist/cli/commands/context-status-command.js +41 -0
  83. package/dist/cli/commands/contract-write-command.d.ts +3 -0
  84. package/dist/cli/commands/contract-write-command.js +144 -0
  85. package/dist/cli/commands/core/doctor-bindings.d.ts +17 -0
  86. package/dist/cli/commands/core/doctor-bindings.js +30 -0
  87. package/dist/cli/commands/core/doctor-command.d.ts +4 -18
  88. package/dist/cli/commands/core/doctor-command.js +2 -323
  89. package/dist/cli/commands/core/doctor-logs.d.ts +8 -0
  90. package/dist/cli/commands/core/doctor-logs.js +32 -0
  91. package/dist/cli/commands/core/doctor-probes.d.ts +3 -0
  92. package/dist/cli/commands/core/doctor-probes.js +55 -0
  93. package/dist/cli/commands/core/doctor-run-command.d.ts +12 -0
  94. package/dist/cli/commands/core/doctor-run-command.js +172 -0
  95. package/dist/cli/commands/core/doctor-summary.d.ts +7 -0
  96. package/dist/cli/commands/core/doctor-summary.js +39 -0
  97. package/dist/cli/commands/core/memory-command-shared.d.ts +25 -0
  98. package/dist/cli/commands/core/memory-command-shared.js +20 -0
  99. package/dist/cli/commands/core/memory-command.d.ts +1 -1
  100. package/dist/cli/commands/core/memory-command.js +6 -227
  101. package/dist/cli/commands/core/memory-delegated-verbs.d.ts +4 -0
  102. package/dist/cli/commands/core/memory-delegated-verbs.js +178 -0
  103. package/dist/cli/commands/core/memory-extract-command.d.ts +3 -0
  104. package/dist/cli/commands/core/memory-extract-command.js +95 -0
  105. package/dist/cli/commands/core/memory-sync-command.d.ts +3 -0
  106. package/dist/cli/commands/core/memory-sync-command.js +38 -0
  107. package/dist/cli/commands/core/session-command.d.ts +1 -1
  108. package/dist/cli/commands/core/session-command.js +12 -206
  109. package/dist/cli/commands/core/session-info-command.d.ts +3 -0
  110. package/dist/cli/commands/core/session-info-command.js +142 -0
  111. package/dist/cli/commands/core/session-verb-commands.d.ts +5 -0
  112. package/dist/cli/commands/core/session-verb-commands.js +58 -0
  113. package/dist/cli/commands/core/standards-command.d.ts +1 -24
  114. package/dist/cli/commands/core/standards-command.js +33 -201
  115. package/dist/cli/commands/core/standards-init-command.d.ts +3 -0
  116. package/dist/cli/commands/core/standards-init-command.js +87 -0
  117. package/dist/cli/commands/core/standards-lint.d.ts +24 -0
  118. package/dist/cli/commands/core/standards-lint.js +57 -0
  119. package/dist/cli/commands/core/standards-migrate-command.d.ts +3 -0
  120. package/dist/cli/commands/core/standards-migrate-command.js +57 -0
  121. package/dist/cli/commands/cron-scheduler-commands.d.ts +5 -1
  122. package/dist/cli/commands/cron-scheduler-commands.js +36 -206
  123. package/dist/cli/commands/cron-scheduler-run-once-command.d.ts +7 -0
  124. package/dist/cli/commands/cron-scheduler-run-once-command.js +35 -0
  125. package/dist/cli/commands/cron-scheduler-shared.d.ts +6 -0
  126. package/dist/cli/commands/cron-scheduler-shared.js +48 -0
  127. package/dist/cli/commands/cron-scheduler-start-command.d.ts +7 -0
  128. package/dist/cli/commands/cron-scheduler-start-command.js +65 -0
  129. package/dist/cli/commands/cron-scheduler-status-command.d.ts +7 -0
  130. package/dist/cli/commands/cron-scheduler-status-command.js +46 -0
  131. package/dist/cli/commands/cron-scheduler-stop-command.d.ts +7 -0
  132. package/dist/cli/commands/cron-scheduler-stop-command.js +61 -0
  133. package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
  134. package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
  135. package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
  136. package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
  137. package/dist/cli/commands/dispatch-commands.js +12 -5
  138. package/dist/cli/commands/dispatch-dag-envelope.d.ts +41 -0
  139. package/dist/cli/commands/dispatch-dag-envelope.js +49 -0
  140. package/dist/cli/commands/dispatch-dag-failure.d.ts +18 -0
  141. package/dist/cli/commands/dispatch-dag-failure.js +16 -0
  142. package/dist/cli/commands/dispatch-dag-preflight.d.ts +51 -0
  143. package/dist/cli/commands/dispatch-dag-preflight.js +105 -0
  144. package/dist/cli/commands/dispatch-dag-runners.d.ts +48 -0
  145. package/dist/cli/commands/dispatch-dag-runners.js +73 -0
  146. package/dist/cli/commands/dispatch-from-dag.d.ts +27 -0
  147. package/dist/cli/commands/dispatch-from-dag.js +87 -257
  148. package/dist/cli/commands/dispatch-preflight.js +46 -0
  149. package/dist/cli/commands/dispatch-prompt-composition.d.ts +6 -0
  150. package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
  151. package/dist/cli/commands/doc-commands.js +1 -1
  152. package/dist/cli/commands/feedback-commands-helpers.js +1 -1
  153. package/dist/cli/commands/final-review-command-envelopes.d.ts +44 -0
  154. package/dist/cli/commands/final-review-command-envelopes.js +100 -0
  155. package/dist/cli/commands/final-review-command-shared.d.ts +52 -0
  156. package/dist/cli/commands/final-review-command-shared.js +35 -0
  157. package/dist/cli/commands/final-review-commands.d.ts +7 -27
  158. package/dist/cli/commands/final-review-commands.js +13 -240
  159. package/dist/cli/commands/final-review-prepare-command.d.ts +3 -0
  160. package/dist/cli/commands/final-review-prepare-command.js +221 -0
  161. package/dist/cli/commands/gate-commands-enforce.js +3 -3
  162. package/dist/cli/commands/governance-classify-contract-commands.d.ts +23 -9
  163. package/dist/cli/commands/governance-classify-contract-commands.js +26 -269
  164. package/dist/cli/commands/hook-handle.js +41 -20
  165. package/dist/cli/commands/hooks-command-shared.d.ts +42 -0
  166. package/dist/cli/commands/hooks-command-shared.js +32 -0
  167. package/dist/cli/commands/hooks-commands.d.ts +20 -0
  168. package/dist/cli/commands/hooks-commands.js +75 -309
  169. package/dist/cli/commands/hooks-install-envelopes.d.ts +6 -0
  170. package/dist/cli/commands/hooks-install-envelopes.js +144 -0
  171. package/dist/cli/commands/hooks-status-command.d.ts +3 -0
  172. package/dist/cli/commands/hooks-status-command.js +93 -0
  173. package/dist/cli/commands/hooks-uninstall-command.d.ts +3 -0
  174. package/dist/cli/commands/hooks-uninstall-command.js +43 -0
  175. package/dist/cli/commands/lint-commands.js +3 -1
  176. package/dist/cli/commands/loop-command-shared.d.ts +31 -0
  177. package/dist/cli/commands/loop-command-shared.js +15 -0
  178. package/dist/cli/commands/loop-commands.d.ts +12 -17
  179. package/dist/cli/commands/loop-commands.js +56 -238
  180. package/dist/cli/commands/loop-eval-capture-index.js +2 -4
  181. package/dist/cli/commands/loop-export-command.d.ts +3 -0
  182. package/dist/cli/commands/loop-export-command.js +73 -0
  183. package/dist/cli/commands/loop-goal-compose-command.d.ts +3 -0
  184. package/dist/cli/commands/loop-goal-compose-command.js +36 -0
  185. package/dist/cli/commands/loop-import-command.d.ts +3 -0
  186. package/dist/cli/commands/loop-import-command.js +86 -0
  187. package/dist/cli/commands/loop-placeholder-commands.d.ts +3 -0
  188. package/dist/cli/commands/loop-placeholder-commands.js +52 -0
  189. package/dist/cli/commands/memory-command-shared.d.ts +59 -0
  190. package/dist/cli/commands/memory-command-shared.js +39 -0
  191. package/dist/cli/commands/memory-commands.d.ts +6 -79
  192. package/dist/cli/commands/memory-commands.js +19 -309
  193. package/dist/cli/commands/memory-ingest-command.d.ts +3 -0
  194. package/dist/cli/commands/memory-ingest-command.js +50 -0
  195. package/dist/cli/commands/memory-list-command.d.ts +16 -0
  196. package/dist/cli/commands/memory-list-command.js +129 -0
  197. package/dist/cli/commands/memory-reindex-command.d.ts +9 -0
  198. package/dist/cli/commands/memory-reindex-command.js +78 -0
  199. package/dist/cli/commands/memory-rotate-command.d.ts +3 -0
  200. package/dist/cli/commands/memory-rotate-command.js +55 -0
  201. package/dist/cli/commands/memory-search-command.d.ts +7 -0
  202. package/dist/cli/commands/memory-search-command.js +46 -0
  203. package/dist/cli/commands/openspec-archive-command.d.ts +3 -0
  204. package/dist/cli/commands/openspec-archive-command.js +55 -0
  205. package/dist/cli/commands/openspec-command-shared.d.ts +62 -0
  206. package/dist/cli/commands/openspec-command-shared.js +135 -0
  207. package/dist/cli/commands/openspec-commands.d.ts +1 -1
  208. package/dist/cli/commands/openspec-commands.js +33 -306
  209. package/dist/cli/commands/openspec-from-doctor-command.d.ts +3 -0
  210. package/dist/cli/commands/openspec-from-doctor-command.js +66 -0
  211. package/dist/cli/commands/openspec-init-command.d.ts +3 -0
  212. package/dist/cli/commands/openspec-init-command.js +49 -0
  213. package/dist/cli/commands/openspec-list-command.d.ts +3 -0
  214. package/dist/cli/commands/openspec-list-command.js +27 -0
  215. package/dist/cli/commands/openspec-render-command.d.ts +3 -0
  216. package/dist/cli/commands/openspec-render-command.js +33 -0
  217. package/dist/cli/commands/openspec-show-command.d.ts +3 -0
  218. package/dist/cli/commands/openspec-show-command.js +33 -0
  219. package/dist/cli/commands/openspec-to-rd-command.d.ts +3 -0
  220. package/dist/cli/commands/openspec-to-rd-command.js +33 -0
  221. package/dist/cli/commands/openspec-validate-command.d.ts +3 -0
  222. package/dist/cli/commands/openspec-validate-command.js +45 -0
  223. package/dist/cli/commands/perf-audit-commands.js +15 -5
  224. package/dist/cli/commands/playwright-browser-command.d.ts +8 -0
  225. package/dist/cli/commands/playwright-browser-command.js +61 -0
  226. package/dist/cli/commands/playwright-commands.d.ts +10 -62
  227. package/dist/cli/commands/playwright-commands.js +77 -400
  228. package/dist/cli/commands/playwright-envelope.d.ts +8 -0
  229. package/dist/cli/commands/playwright-envelope.js +29 -0
  230. package/dist/cli/commands/playwright-ls-stop-commands.d.ts +4 -0
  231. package/dist/cli/commands/playwright-ls-stop-commands.js +74 -0
  232. package/dist/cli/commands/playwright-session-store.d.ts +65 -0
  233. package/dist/cli/commands/playwright-session-store.js +189 -0
  234. package/dist/cli/commands/project-commands.d.ts +19 -0
  235. package/dist/cli/commands/project-commands.js +101 -259
  236. package/dist/cli/commands/project-context-command.d.ts +3 -0
  237. package/dist/cli/commands/project-context-command.js +44 -0
  238. package/dist/cli/commands/project-dashboard-command.d.ts +3 -0
  239. package/dist/cli/commands/project-dashboard-command.js +74 -0
  240. package/dist/cli/commands/project-knowledge-command.d.ts +3 -0
  241. package/dist/cli/commands/project-knowledge-command.js +48 -0
  242. package/dist/cli/commands/project-memories-show-command.d.ts +3 -0
  243. package/dist/cli/commands/project-memories-show-command.js +87 -0
  244. package/dist/cli/commands/project-memory-index-command.d.ts +3 -0
  245. package/dist/cli/commands/project-memory-index-command.js +31 -0
  246. package/dist/cli/commands/qa-archive-screenshots-command.d.ts +3 -0
  247. package/dist/cli/commands/qa-archive-screenshots-command.js +53 -0
  248. package/dist/cli/commands/qa-commands.d.ts +14 -87
  249. package/dist/cli/commands/qa-commands.js +17 -315
  250. package/dist/cli/commands/qa-context-prestep.d.ts +1 -0
  251. package/dist/cli/commands/qa-context-prestep.js +34 -0
  252. package/dist/cli/commands/qa-run-command.d.ts +3 -0
  253. package/dist/cli/commands/qa-run-command.js +105 -0
  254. package/dist/cli/commands/qa-run-options.d.ts +23 -0
  255. package/dist/cli/commands/qa-run-options.js +31 -0
  256. package/dist/cli/commands/qa-run-slice.d.ts +41 -0
  257. package/dist/cli/commands/qa-run-slice.js +145 -0
  258. package/dist/cli/commands/race-commands.d.ts +15 -0
  259. package/dist/cli/commands/race-commands.js +65 -0
  260. package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
  261. package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
  262. package/dist/cli/commands/release-canary-command.d.ts +28 -0
  263. package/dist/cli/commands/release-canary-command.js +129 -0
  264. package/dist/cli/commands/release-command-shared.d.ts +13 -0
  265. package/dist/cli/commands/release-command-shared.js +18 -0
  266. package/dist/cli/commands/release-commands.d.ts +10 -18
  267. package/dist/cli/commands/release-commands.js +25 -298
  268. package/dist/cli/commands/release-done-command.d.ts +3 -0
  269. package/dist/cli/commands/release-done-command.js +64 -0
  270. package/dist/cli/commands/release-hotfix-command.d.ts +3 -0
  271. package/dist/cli/commands/release-hotfix-command.js +50 -0
  272. package/dist/cli/commands/release-plan-command.d.ts +3 -0
  273. package/dist/cli/commands/release-plan-command.js +33 -0
  274. package/dist/cli/commands/release-precheck-command.d.ts +3 -0
  275. package/dist/cli/commands/release-precheck-command.js +28 -0
  276. package/dist/cli/commands/release-promote-command.d.ts +3 -0
  277. package/dist/cli/commands/release-promote-command.js +34 -0
  278. package/dist/cli/commands/release-rollback-command.d.ts +3 -0
  279. package/dist/cli/commands/release-rollback-command.js +33 -0
  280. package/dist/cli/commands/release-watch-command.d.ts +3 -0
  281. package/dist/cli/commands/release-watch-command.js +44 -0
  282. package/dist/cli/commands/request-command-options.d.ts +8 -0
  283. package/dist/cli/commands/request-commands.js +2 -0
  284. package/dist/cli/commands/request-init-command.js +67 -12
  285. package/dist/cli/commands/request-retag-command.d.ts +3 -0
  286. package/dist/cli/commands/request-retag-command.js +50 -0
  287. package/dist/cli/commands/request-show-command.d.ts +8 -0
  288. package/dist/cli/commands/request-show-command.js +14 -1
  289. package/dist/cli/commands/request-transition-command.js +12 -4
  290. package/dist/cli/commands/request-transition-failures.d.ts +14 -0
  291. package/dist/cli/commands/request-transition-failures.js +45 -3
  292. package/dist/cli/commands/scan-scope-commands.js +2 -2
  293. package/dist/cli/commands/security-audit-commands.js +26 -6
  294. package/dist/cli/commands/sediment-argv-flags.d.ts +54 -0
  295. package/dist/cli/commands/sediment-argv-flags.js +116 -0
  296. package/dist/cli/commands/sediment-command-shared.d.ts +15 -0
  297. package/dist/cli/commands/sediment-command-shared.js +5 -0
  298. package/dist/cli/commands/sediment-commands.d.ts +35 -59
  299. package/dist/cli/commands/sediment-commands.js +36 -590
  300. package/dist/cli/commands/sediment-pool-commands.d.ts +9 -0
  301. package/dist/cli/commands/sediment-pool-commands.js +185 -0
  302. package/dist/cli/commands/sediment-query-commands.d.ts +4 -0
  303. package/dist/cli/commands/sediment-query-commands.js +94 -0
  304. package/dist/cli/commands/sediment-release-commands.d.ts +8 -0
  305. package/dist/cli/commands/sediment-release-commands.js +232 -0
  306. package/dist/cli/commands/sop-advance-command.d.ts +3 -0
  307. package/dist/cli/commands/sop-advance-command.js +160 -0
  308. package/dist/cli/commands/sop-check-command.d.ts +3 -0
  309. package/dist/cli/commands/sop-check-command.js +44 -0
  310. package/dist/cli/commands/sop-command-shared.d.ts +23 -0
  311. package/dist/cli/commands/sop-command-shared.js +18 -0
  312. package/dist/cli/commands/sop-commands.d.ts +15 -1
  313. package/dist/cli/commands/sop-commands.js +26 -240
  314. package/dist/cli/commands/sop-init-command.d.ts +3 -0
  315. package/dist/cli/commands/sop-init-command.js +51 -0
  316. package/dist/cli/commands/sop-lint-command.d.ts +3 -0
  317. package/dist/cli/commands/sop-lint-command.js +64 -0
  318. package/dist/cli/commands/sop-register-command.d.ts +3 -0
  319. package/dist/cli/commands/sop-register-command.js +48 -0
  320. package/dist/cli/commands/sop-registry-command.d.ts +3 -0
  321. package/dist/cli/commands/sop-registry-command.js +30 -0
  322. package/dist/cli/commands/statusline-command-shared.d.ts +73 -0
  323. package/dist/cli/commands/statusline-command-shared.js +90 -0
  324. package/dist/cli/commands/statusline-commands.d.ts +1 -19
  325. package/dist/cli/commands/statusline-commands.js +48 -287
  326. package/dist/cli/commands/statusline-compact-command.d.ts +4 -0
  327. package/dist/cli/commands/statusline-compact-command.js +54 -0
  328. package/dist/cli/commands/statusline-install-command.d.ts +3 -0
  329. package/dist/cli/commands/statusline-install-command.js +48 -0
  330. package/dist/cli/commands/statusline-render-command.d.ts +9 -0
  331. package/dist/cli/commands/statusline-render-command.js +55 -0
  332. package/dist/cli/commands/statusline-status-command.d.ts +3 -0
  333. package/dist/cli/commands/statusline-status-command.js +23 -0
  334. package/dist/cli/commands/statusline-uninstall-command.d.ts +3 -0
  335. package/dist/cli/commands/statusline-uninstall-command.js +23 -0
  336. package/dist/cli/commands/test-command-run-helpers.d.ts +27 -0
  337. package/dist/cli/commands/test-command-run-helpers.js +73 -0
  338. package/dist/cli/commands/test-command-runner-resolution.d.ts +57 -0
  339. package/dist/cli/commands/test-command-runner-resolution.js +183 -0
  340. package/dist/cli/commands/test-commands.d.ts +8 -56
  341. package/dist/cli/commands/test-commands.js +26 -249
  342. package/dist/cli/commands/vm-command-shared.d.ts +23 -0
  343. package/dist/cli/commands/vm-command-shared.js +23 -0
  344. package/dist/cli/commands/vm-commands.d.ts +1 -28
  345. package/dist/cli/commands/vm-commands.js +36 -270
  346. package/dist/cli/commands/vm-hypervisor-runtime.d.ts +15 -0
  347. package/dist/cli/commands/vm-hypervisor-runtime.js +64 -0
  348. package/dist/cli/commands/vm-release-command.d.ts +5 -0
  349. package/dist/cli/commands/vm-release-command.js +101 -0
  350. package/dist/cli/commands/vm-spawn-command.d.ts +5 -0
  351. package/dist/cli/commands/vm-spawn-command.js +177 -0
  352. package/dist/cli/commands/web-command-shared.d.ts +12 -0
  353. package/dist/cli/commands/web-command-shared.js +30 -0
  354. package/dist/cli/commands/web-commands.d.ts +7 -14
  355. package/dist/cli/commands/web-commands.js +6 -314
  356. package/dist/cli/commands/web-install-command.d.ts +10 -0
  357. package/dist/cli/commands/web-install-command.js +116 -0
  358. package/dist/cli/commands/web-lifecycle-commands.d.ts +9 -30
  359. package/dist/cli/commands/web-lifecycle-commands.js +14 -322
  360. package/dist/cli/commands/web-login-command.d.ts +14 -0
  361. package/dist/cli/commands/web-login-command.js +189 -0
  362. package/dist/cli/commands/web-op-payload.d.ts +22 -0
  363. package/dist/cli/commands/web-op-payload.js +89 -0
  364. package/dist/cli/commands/web-op-refusals.d.ts +37 -0
  365. package/dist/cli/commands/web-op-refusals.js +73 -0
  366. package/dist/cli/commands/web-op-runner.d.ts +14 -0
  367. package/dist/cli/commands/web-op-runner.js +166 -0
  368. package/dist/cli/commands/web-status-command.d.ts +4 -0
  369. package/dist/cli/commands/web-status-command.js +32 -0
  370. package/dist/cli/commands/web-stop-command.d.ts +10 -0
  371. package/dist/cli/commands/web-stop-command.js +59 -0
  372. package/dist/cli/commands/web-verb-specs.d.ts +18 -0
  373. package/dist/cli/commands/web-verb-specs.js +66 -0
  374. package/dist/cli/commands/workflow-command-shared.d.ts +102 -0
  375. package/dist/cli/commands/workflow-command-shared.js +74 -0
  376. package/dist/cli/commands/workflow-graph-commands.d.ts +3 -0
  377. package/dist/cli/commands/workflow-graph-commands.js +73 -0
  378. package/dist/cli/commands/workflow-init-command.d.ts +3 -0
  379. package/dist/cli/commands/workflow-init-command.js +68 -0
  380. package/dist/cli/commands/workflow-lifecycle-commands.d.ts +9 -59
  381. package/dist/cli/commands/workflow-lifecycle-commands.js +14 -348
  382. package/dist/cli/commands/workflow-node-commands.d.ts +3 -0
  383. package/dist/cli/commands/workflow-node-commands.js +154 -0
  384. package/dist/cli/commands/workflow-terminalize-command.d.ts +3 -0
  385. package/dist/cli/commands/workflow-terminalize-command.js +56 -0
  386. package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
  387. package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
  388. package/dist/services/artifacts/artifact-contract-block.js +212 -0
  389. package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
  390. package/dist/services/artifacts/artifact-prerequisites.js +63 -133
  391. package/dist/services/artifacts/artifact-templates.d.ts +1 -1
  392. package/dist/services/artifacts/artifact-templates.js +17 -10
  393. package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
  394. package/dist/services/artifacts/prerequisite-checks.js +198 -0
  395. package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
  396. package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
  397. package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
  398. package/dist/services/artifacts/request-artifact-metadata.js +44 -0
  399. package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
  400. package/dist/services/artifacts/request-artifact-service.js +23 -51
  401. package/dist/services/artifacts/request-artifact-state-helpers.d.ts +12 -0
  402. package/dist/services/artifacts/request-artifact-state-helpers.js +28 -4
  403. package/dist/services/artifacts/request-retag-service.d.ts +68 -0
  404. package/dist/services/artifacts/request-retag-service.js +125 -0
  405. package/dist/services/artifacts/request-state-order.d.ts +38 -0
  406. package/dist/services/artifacts/request-state-order.js +99 -0
  407. package/dist/services/artifacts/request-type-demand.d.ts +44 -0
  408. package/dist/services/artifacts/request-type-demand.js +71 -0
  409. package/dist/services/audit/audit-goal-service.d.ts +7 -0
  410. package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
  411. package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
  412. package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
  413. package/dist/services/audit/enforcers/code-ban.js +21 -1
  414. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
  415. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
  416. package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
  417. package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
  418. package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
  419. package/dist/services/audit-independent/handoff-readers.js +81 -0
  420. package/dist/services/audit-independent/index.d.ts +6 -1
  421. package/dist/services/audit-independent/index.js +6 -1
  422. package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
  423. package/dist/services/audit-independent/judged-declaration-build.js +73 -0
  424. package/dist/services/audit-independent/judged-declaration-check.d.ts +79 -0
  425. package/dist/services/audit-independent/judged-declaration-check.js +155 -0
  426. package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
  427. package/dist/services/audit-independent/judged-declaration.js +218 -0
  428. package/dist/services/audit-independent/perf-audit-service.js +12 -14
  429. package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
  430. package/dist/services/audit-independent/security-audit-artifact.js +90 -0
  431. package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
  432. package/dist/services/audit-independent/security-audit-service.js +34 -178
  433. package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
  434. package/dist/services/code/auto-compact-artifacts.d.ts +54 -0
  435. package/dist/services/code/auto-compact-artifacts.js +135 -0
  436. package/dist/services/code/auto-compact-attempt.d.ts +46 -0
  437. package/dist/services/code/auto-compact-attempt.js +88 -0
  438. package/dist/services/code/auto-compact-decision.d.ts +74 -0
  439. package/dist/services/code/auto-compact-decision.js +149 -0
  440. package/dist/services/code/auto-compact-dispatch-gate.d.ts +36 -0
  441. package/dist/services/code/auto-compact-dispatch-gate.js +86 -0
  442. package/dist/services/code/auto-compact-envelopes.d.ts +33 -0
  443. package/dist/services/code/auto-compact-envelopes.js +134 -0
  444. package/dist/services/code/auto-compact-history.d.ts +46 -0
  445. package/dist/services/code/auto-compact-history.js +17 -0
  446. package/dist/services/code/auto-compact-orchestrator.d.ts +11 -240
  447. package/dist/services/code/auto-compact-orchestrator.js +165 -686
  448. package/dist/services/code/auto-compact-run-types.d.ts +123 -0
  449. package/dist/services/code/auto-compact-run-types.js +1 -0
  450. package/dist/services/code/emit-handoff.d.ts +35 -1
  451. package/dist/services/code/emit-handoff.js +128 -7
  452. package/dist/services/code/step-08-gate.d.ts +28 -19
  453. package/dist/services/code/step-08-gate.js +92 -35
  454. package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
  455. package/dist/services/config/config-coercion.d.ts +7 -0
  456. package/dist/services/config/config-coercion.js +156 -0
  457. package/dist/services/config/config-file-io.d.ts +11 -0
  458. package/dist/services/config/config-file-io.js +61 -0
  459. package/dist/services/config/config-get.d.ts +2 -0
  460. package/dist/services/config/config-get.js +36 -0
  461. package/dist/services/config/config-global-loader.d.ts +15 -0
  462. package/dist/services/config/config-global-loader.js +111 -0
  463. package/dist/services/config/config-nested-path.d.ts +3 -0
  464. package/dist/services/config/config-nested-path.js +53 -0
  465. package/dist/services/config/config-primitives.d.ts +16 -0
  466. package/dist/services/config/config-primitives.js +24 -0
  467. package/dist/services/config/config-service.d.ts +9 -33
  468. package/dist/services/config/config-service.js +16 -665
  469. package/dist/services/config/config-validation.d.ts +19 -0
  470. package/dist/services/config/config-validation.js +152 -0
  471. package/dist/services/config/config-workspace.d.ts +10 -0
  472. package/dist/services/config/config-workspace.js +158 -0
  473. package/dist/services/context/build-dispatch-system-prompt.d.ts +3 -3
  474. package/dist/services/context/build-dispatch-system-prompt.js +7 -7
  475. package/dist/services/context/collector.js +5 -1
  476. package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
  477. package/dist/services/dispatch/active-dispatch-index.js +118 -0
  478. package/dist/services/dispatch/batch-counter.js +1 -2
  479. package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
  480. package/dist/services/dispatch/dispatch-record-writer.js +58 -100
  481. package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
  482. package/dist/services/dispatch/karpathy-block.d.ts +55 -0
  483. package/dist/services/dispatch/karpathy-block.js +101 -0
  484. package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
  485. package/dist/services/dispatch/ledger-reaper.js +131 -0
  486. package/dist/services/evidence/evidence-generator.js +15 -8
  487. package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
  488. package/dist/services/feedback/feedback-promotion-service.js +30 -35
  489. package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
  490. package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
  491. package/dist/services/feedback/promotion-artifact-missing.js +63 -0
  492. package/dist/services/final-review/final-review-contract.d.ts +95 -4
  493. package/dist/services/final-review/final-review-contract.js +64 -0
  494. package/dist/services/final-review/final-review-delivery.d.ts +13 -0
  495. package/dist/services/final-review/final-review-delivery.js +26 -12
  496. package/dist/services/final-review/final-review-evidence-collect.js +8 -53
  497. package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
  498. package/dist/services/final-review/final-review-evidence-records.js +67 -0
  499. package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
  500. package/dist/services/final-review/final-review-evidence-sources.js +28 -4
  501. package/dist/services/final-review/final-review-prompt.js +19 -6
  502. package/dist/services/final-review/final-review-runner.js +5 -0
  503. package/dist/services/final-review/final-review-service.d.ts +2 -2
  504. package/dist/services/final-review/index.d.ts +1 -1
  505. package/dist/services/final-review/pre-post-diff.d.ts +2 -75
  506. package/dist/services/final-review/pre-post-diff.js +60 -59
  507. package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
  508. package/dist/services/hooks/pre-tool-code-gate.js +21 -2
  509. package/dist/services/hooks/worktree-authorization-gate.js +6 -31
  510. package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
  511. package/dist/services/hooks/worktree-refusal-messages.js +102 -0
  512. package/dist/services/lint/eslint-runner-support.d.ts +1 -1
  513. package/dist/services/lint/eslint-runner-support.js +2 -1
  514. package/dist/services/lint/eslint-runner-types.d.ts +8 -0
  515. package/dist/services/lint/eslint-runner.js +17 -4
  516. package/dist/services/llm/anthropic-runner.js +24 -7
  517. package/dist/services/loop/loop-observability.d.ts +39 -0
  518. package/dist/services/loop/loop-observability.js +55 -0
  519. package/dist/services/loop/monotonic-guard.js +6 -9
  520. package/dist/services/loop/monotonic-runner.js +8 -7
  521. package/dist/services/loop/run-driver.js +18 -22
  522. package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
  523. package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
  524. package/dist/services/memory/project-memory-service/index.d.ts +2 -2
  525. package/dist/services/memory/project-memory-service/index.js +1 -1
  526. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
  527. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
  528. package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
  529. package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
  530. package/dist/services/memory/project-memory-service/types.d.ts +32 -0
  531. package/dist/services/observability/observability-service.d.ts +7 -0
  532. package/dist/services/observability/observability-service.js +2 -1
  533. package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
  534. package/dist/services/prd/gate-evidence-derivation.js +4 -3
  535. package/dist/services/qa/bdd-test-style-verifier.js +22 -8
  536. package/dist/services/race/gate2-evaluator.d.ts +58 -0
  537. package/dist/services/race/gate2-evaluator.js +111 -0
  538. package/dist/services/race/gate2-policy.d.ts +17 -0
  539. package/dist/services/race/gate2-policy.js +31 -0
  540. package/dist/services/race/lane-phase.d.ts +19 -0
  541. package/dist/services/race/lane-phase.js +113 -0
  542. package/dist/services/race/pilot-gate-store.d.ts +67 -0
  543. package/dist/services/race/pilot-gate-store.js +227 -0
  544. package/dist/services/scan/file-size-baseline.d.ts +26 -0
  545. package/dist/services/scan/file-size-baseline.js +150 -0
  546. package/dist/services/scan/file-size-scan.d.ts +42 -3
  547. package/dist/services/scan/file-size-scan.js +58 -42
  548. package/dist/services/scan/type-sanity-service.js +13 -3
  549. package/dist/services/skill/resume-detector.js +3 -3
  550. package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
  551. package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
  552. package/dist/services/skills/hooks-settings-deny-list.d.ts +61 -0
  553. package/dist/services/skills/hooks-settings-deny-list.js +173 -0
  554. package/dist/services/skills/hooks-settings-envelopes.d.ts +20 -0
  555. package/dist/services/skills/hooks-settings-envelopes.js +79 -0
  556. package/dist/services/skills/hooks-settings-file-shape.d.ts +43 -0
  557. package/dist/services/skills/hooks-settings-file-shape.js +207 -0
  558. package/dist/services/skills/hooks-settings-paths.d.ts +34 -0
  559. package/dist/services/skills/hooks-settings-paths.js +75 -0
  560. package/dist/services/skills/hooks-settings-read-installed.d.ts +39 -0
  561. package/dist/services/skills/hooks-settings-read-installed.js +60 -0
  562. package/dist/services/skills/hooks-settings-service.d.ts +13 -213
  563. package/dist/services/skills/hooks-settings-service.js +72 -658
  564. package/dist/services/skills/hooks-settings-types.d.ts +139 -0
  565. package/dist/services/skills/hooks-settings-types.js +1 -0
  566. package/dist/services/skills/presence-lease-order.d.ts +13 -0
  567. package/dist/services/skills/presence-lease-order.js +24 -0
  568. package/dist/services/skills/skill-conformance-service.js +1 -0
  569. package/dist/services/skills/skill-statusline-service.js +4 -7
  570. package/dist/services/slice/slice-check-service.js +8 -8
  571. package/dist/services/workflow/pipeline-verify-gate-support.js +2 -1
  572. package/dist/services/workflow/pipeline-verify-service.js +1 -1
  573. package/dist/services/workflow/workflow-skip-service.d.ts +0 -20
  574. package/dist/services/workflow/workflow-skip-service.js +3 -4
  575. package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
  576. package/dist/services/workspace/claude-settings-retirements.js +112 -0
  577. package/dist/services/workspace/claude-settings-template-merge.d.ts +109 -0
  578. package/dist/services/workspace/claude-settings-template-merge.js +223 -0
  579. package/dist/services/workspace/claude-settings-template.d.ts +79 -87
  580. package/dist/services/workspace/claude-settings-template.js +80 -235
  581. package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
  582. package/dist/services/workspace/reconcile-service.js +0 -1
  583. package/dist/shared/incrementing-number.d.ts +10 -0
  584. package/dist/shared/incrementing-number.js +27 -0
  585. package/package.json +5 -5
  586. package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
  587. package/skills/bee/peaks-prd/SKILL.md +1 -1
  588. package/skills/bee/peaks-qa/SKILL.md +1 -1
  589. package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
  590. package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
  591. package/skills/bee/peaks-rd/SKILL.md +2 -2
  592. package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
  593. package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
  594. package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
  595. package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
  596. package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
  597. package/skills/bee/peaks-reviewer/SKILL.md +1 -1
  598. package/skills/bee/peaks-sc/SKILL.md +1 -1
  599. package/skills/bee/peaks-security-audit/SKILL.md +10 -2
  600. package/skills/bee/peaks-txt/SKILL.md +4 -3
  601. package/skills/bee/peaks-ui/SKILL.md +3 -3
  602. package/skills/peaks-audit/SKILL.md +29 -1
  603. package/skills/peaks-code/SKILL.md +5 -2
  604. package/skills/peaks-code/references/fast-lane-norm.md +42 -0
  605. package/skills/peaks-code/references/fast-mode.md +3 -2
  606. package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
  607. package/skills/peaks-code/references/micro-cycle.md +3 -3
  608. package/skills/peaks-code/references/resume-detection.md +1 -1
  609. package/skills/peaks-code/references/runbook.md +12 -6
  610. package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
  611. package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
  612. package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
  613. package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
  614. package/skills/peaks-code/references/worktree-governance.md +4 -4
  615. package/skills/peaks-content/SKILL.md +1 -1
  616. package/skills/peaks-doctor/SKILL.md +1 -1
  617. package/skills/peaks-final-review/SKILL.md +31 -11
  618. package/skills/peaks-ide/SKILL.md +1 -1
  619. package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
  620. package/skills/peaks-race-code/SKILL.md +185 -0
  621. package/skills/peaks-resume/SKILL.md +1 -1
  622. package/skills/peaks-slice-decompose/SKILL.md +1 -1
  623. package/skills/peaks-solo/SKILL.md +1 -1
  624. package/skills/peaks-sop/SKILL.md +1 -1
  625. package/skills/peaks-status/SKILL.md +1 -1
  626. package/skills/peaks-test/SKILL.md +7 -4
  627. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
  628. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
@@ -0,0 +1,139 @@
1
+ /**
2
+ * The public type surface of the hooks settings service.
3
+ *
4
+ * Split out of `hooks-settings-service.ts` (file-size cap campaign). The
5
+ * service re-exports every name declared here, so existing importers keep
6
+ * using `./hooks-settings-service.js` unchanged.
7
+ */
8
+ import type { IdeId } from '../ide/ide-types.js';
9
+ import type { HookScope } from '../ide/shared/safe-path.js';
10
+ import type { PeaksHookEntry } from './hooks-codegate-superpowers.js';
11
+ export type HookInstallOptions = {
12
+ /**
13
+ * Which IDE's adapter to install for. Defaults to `'claude-code'` for
14
+ * backward compatibility. The CLI command should resolve this from
15
+ * `detectIdeFromContext({ env, cwd, parsedStdin })` and pass the result.
16
+ * Throws if the IDE is not registered in the adapter registry.
17
+ */
18
+ readonly ide?: IdeId;
19
+ /**
20
+ * Slice #013 (bugfix — peaks hooks install --no-progress): when `true`,
21
+ * skip emitting the progress-start PreToolUse hook entry while still
22
+ * installing the gate-enforce entry. The progress-start hook auto-spawns
23
+ * a new terminal running `peaks progress watch`; with dispatch +
24
+ * heartbeat (slice #009 + #010) that auto-spawn is dead weight. Default
25
+ * `false` preserves the pre-slice install shape (both entries). The
26
+ * sentinel-based install is idempotent: re-running with `skipProgress:
27
+ * true` over a settings.json that previously had the progress entry
28
+ * installed will remove that entry. `uninstall` honors the same flag
29
+ * so it can find and remove both entries when both are present and
30
+ * only the gate-enforce entry when only the gate-enforce is present.
31
+ *
32
+ * Slice #014 (refactor — full removal of legacy progress-start surface):
33
+ * the field is preserved for API stability, but the underlying
34
+ * install only ever emits the gate-enforce entry. The progress-start
35
+ * entry is no longer installed regardless of this flag's value. The
36
+ * legacy `peaks progress start|watch|close` CLI surface is gone
37
+ * (replaced by `peaks sub-agent dispatch|heartbeat|share`); the hook
38
+ * entry would have been pointing at a `peaks progress start` that no
39
+ * longer exists. The sentinel `peaks progress start` constant is still
40
+ * exported (some tests + back-compat reads rely on it) but no new
41
+ * hook entries use it.
42
+ */
43
+ readonly skipProgress?: boolean;
44
+ };
45
+ /**
46
+ * One peaks-managed entry paired with the settings file it is (or will be)
47
+ * written to.
48
+ *
49
+ * `entries` is a flat list of the same matcher/sentinel pairs, which reads as
50
+ * "written to `settingsPath`" even when the entry is routed to the other file
51
+ * (see `resolveHookTargets`). This carries the routing explicitly so the
52
+ * dry-run can name the real target without a real run.
53
+ */
54
+ export type HookEntryTarget = {
55
+ matcher: string;
56
+ sentinel: string;
57
+ settingsPath: string;
58
+ };
59
+ export type HookInstallPlan = {
60
+ scope: HookScope;
61
+ settingsPath: string;
62
+ exists: boolean;
63
+ alreadyInstalled: boolean;
64
+ desiredCommand: string;
65
+ sentinel: string;
66
+ matcher: string;
67
+ /**
68
+ * Machine-local, gitignored settings file that the gate-enforce entry is
69
+ * written to instead of `settingsPath`. Undefined when the IDE has no such
70
+ * file (or the scope is global, where the settings file is already
71
+ * machine-local). See `resolveHookTargets`.
72
+ */
73
+ localSettingsPath?: string;
74
+ /** Every entry the install writes, paired with its target file. */
75
+ entryTargets: ReadonlyArray<HookEntryTarget>;
76
+ };
77
+ export type HookInstallResult = HookInstallPlan & {
78
+ applied: boolean;
79
+ };
80
+ export type HookRemoveResult = {
81
+ scope: HookScope;
82
+ settingsPath: string;
83
+ localSettingsPath?: string;
84
+ removed: boolean;
85
+ };
86
+ export type HookStatus = {
87
+ scope: HookScope;
88
+ settingsPath: string;
89
+ exists: boolean;
90
+ localSettingsPath?: string;
91
+ localExists?: boolean;
92
+ installed: boolean;
93
+ /**
94
+ * Whether this IDE can host a peaks hook AT ALL (`hasHookSpec`).
95
+ *
96
+ * `status` answers "what is on disk", and for an IDE with no
97
+ * `HOOK_COMMAND_BY_IDE` entry the answer is "nothing, and nothing ever will
98
+ * be" — which is a successful query returning a negative fact, not a failed
99
+ * one. The exit code says the query succeeded; this field says what it found.
100
+ * Without it `installed: false` would be indistinguishable from a supported
101
+ * IDE that simply has no hook installed yet, which is a state the user can
102
+ * act on.
103
+ */
104
+ supportsHooks: boolean;
105
+ };
106
+ export type HookHandler = {
107
+ type?: string;
108
+ command?: string;
109
+ };
110
+ export type HookMatcherEntry = {
111
+ matcher?: string;
112
+ hooks?: HookHandler[];
113
+ };
114
+ /**
115
+ * A peaks-managed hook entry set grouped by the settings file that must
116
+ * carry it.
117
+ *
118
+ * Peaks hooks normally land in the adapter's settings file. The gate-enforce
119
+ * Bash entry is the exception: on Windows its `shell` must be pinned to
120
+ * `powershell`, because the default Git-Bash shell force-allocates a console
121
+ * window on every Bash tool call (MSYS2 behaviour — see the 2026-09-10
122
+ * hook-console finding). A machine-specific value must never be committed
123
+ * into the SHARED `.claude/settings.json` that a macOS/Linux teammate reads
124
+ * too, so that entry is materialized into the machine-local file instead.
125
+ * The routing decision is platform-independent (it keys off the entry's
126
+ * `machineLocal` flag, not off `process.platform`) so the shared file's
127
+ * content does not depend on which OS ran the install.
128
+ */
129
+ export type HookTarget = {
130
+ settingsPath: string;
131
+ entries: PeaksHookEntry[];
132
+ /**
133
+ * When true this file also receives the third-party PreToolUse gate
134
+ * exemptions (`EXTERNAL_GATE_EXEMPT_ENV`). Claude Code only — `env` is a
135
+ * Claude Code settings key — and only ever on a machine-local file, never
136
+ * on the committed shared one.
137
+ */
138
+ envExemptions?: boolean;
139
+ };
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,13 @@
1
+ import type { SkillPresenceLease } from './presence-lease-types.js';
2
+ /**
3
+ * Most recent lease first: `lastHeartbeat` desc, `startedAt` desc as the
4
+ * tie-break.
5
+ *
6
+ * The tie-break is not decorative. Nothing refreshes the on-disk heartbeat
7
+ * today — no caller runs `setPresenceLease` on a cadence — so `lastHeartbeat`
8
+ * frequently equals `startedAt`, and two leases written in the same millisecond
9
+ * tie on heartbeat alone. That tie then falls through to `Array.prototype.sort`
10
+ * stability, i.e. `readdirSync` order, which is the input this ordering exists
11
+ * to stop depending on.
12
+ */
13
+ export declare function comparePresenceLeases(a: SkillPresenceLease, b: SkillPresenceLease): number;
@@ -0,0 +1,24 @@
1
+ // Shared ordering for a peaks session's presence leases.
2
+ //
3
+ // Lives on its own because the three readers that need it — the resolver, the
4
+ // statusline projection, and the per-caller legacy read — sit in three modules
5
+ // and none of them owns the other. They used to order the same lease set three
6
+ // ways (two by heartbeat alone, one with a tie-break), so they could name
7
+ // different leases as "who is driving".
8
+ /**
9
+ * Most recent lease first: `lastHeartbeat` desc, `startedAt` desc as the
10
+ * tie-break.
11
+ *
12
+ * The tie-break is not decorative. Nothing refreshes the on-disk heartbeat
13
+ * today — no caller runs `setPresenceLease` on a cadence — so `lastHeartbeat`
14
+ * frequently equals `startedAt`, and two leases written in the same millisecond
15
+ * tie on heartbeat alone. That tie then falls through to `Array.prototype.sort`
16
+ * stability, i.e. `readdirSync` order, which is the input this ordering exists
17
+ * to stop depending on.
18
+ */
19
+ export function comparePresenceLeases(a, b) {
20
+ const byHeartbeat = (b.lastHeartbeat ?? '').localeCompare(a.lastHeartbeat ?? '');
21
+ if (byHeartbeat !== 0)
22
+ return byHeartbeat;
23
+ return (b.startedAt ?? '').localeCompare(a.startedAt ?? '');
24
+ }
@@ -29,6 +29,7 @@ const SKILL_NAMES = [
29
29
  'peaks-qa',
30
30
  'peaks-sc',
31
31
  'peaks-code',
32
+ 'peaks-race-code',
32
33
  'peaks-resume',
33
34
  'peaks-status',
34
35
  'peaks-test',
@@ -1,6 +1,7 @@
1
1
  import { findProjectRoot } from '../config/config-safety.js';
2
2
  import { getSessionIdCanonical } from '../session/session-manager.js';
3
3
  import { resolveActiveSkillForCaller } from '../audit/enforcers/active-skill-resolver.js';
4
+ import { comparePresenceLeases } from './presence-lease-order.js';
4
5
  import { listPresenceLeases } from './presence-lease-service.js';
5
6
  import { read24hOverlay, readActiveLeaf, readCompactState, resolveCallerId, resolveCwdFromStdin } from './skill-statusline-model.js';
6
7
  export { parseStatusLineStdin, read24hOverlay } from './skill-statusline-model.js';
@@ -101,13 +102,9 @@ function readPresenceReadOnly(projectRoot, callerId) {
101
102
  if (inFlight.length === 0) {
102
103
  return { presence: null, invalid: false };
103
104
  }
104
- // Most recent wins — sort by `lastHeartbeat` desc, fall back to `startedAt`.
105
- const sorted = inFlight.slice().sort((a, b) => {
106
- const hb = b.lastHeartbeat.localeCompare(a.lastHeartbeat);
107
- if (hb !== 0)
108
- return hb;
109
- return b.startedAt.localeCompare(a.startedAt);
110
- });
105
+ // Most recent wins, through the shared comparator so every reader of one
106
+ // lease set names the same lease.
107
+ const sorted = inFlight.slice().sort(comparePresenceLeases);
111
108
  const latest = sorted[0];
112
109
  if (latest === undefined || typeof latest.skill !== 'string' || latest.skill.length === 0) {
113
110
  return { presence: null, invalid: false };
@@ -243,22 +243,22 @@ async function runUnitTests(projectRoot, runTests) {
243
243
  }
244
244
  };
245
245
  }
246
- // carry the rid now. Candidate order is canonical-first, then the
247
- // back-compat tiers — the same order `artifact-prerequisites.ts` resolves
248
- // in, so this boundary gate and the transition gate agree on which file is
249
- // a slice's evidence. `<rid>` is substituted at probe time.
246
+ // Candidate order is canonical-first, then the back-compat tiers, mirroring
247
+ // `artifact-prerequisites.ts` (v2.12.0 moved security + perf to audit skills).
250
248
  const REVIEW_FILES = [
251
249
  {
252
250
  name: 'code-review',
253
251
  paths: ['rd/code-review-<rid>.md', 'rd/code-review.md'],
254
252
  label: 'code-review'
255
253
  },
256
- // v2.12.0 collapse: security + perf moved to standalone audit skills.
257
- // OR the v2.11.x legacy path during the 1-minor-release back-compat
258
- // window (v2.13.0 hard-deletes the legacy paths — see CHANGELOG [2.12.0]).
259
254
  {
260
255
  name: 'security-review',
261
- paths: ['audit/security-<rid>.md', 'audit/security.md', 'rd/security-review.md'],
256
+ paths: [
257
+ 'audit/security-<rid>.md',
258
+ 'audit/security.md',
259
+ 'rd/security-review-<rid>.md',
260
+ 'rd/security-review.md'
261
+ ],
262
262
  label: 'security-review'
263
263
  },
264
264
  {
@@ -8,7 +8,8 @@
8
8
  */
9
9
  import { existsSync, readFileSync } from 'node:fs';
10
10
  import { join } from 'node:path';
11
- import { getPrerequisitesFor, prerequisiteBodyViolations } from '../artifacts/artifact-prerequisites.js';
11
+ import { getPrerequisitesFor } from '../artifacts/artifact-prerequisites.js';
12
+ import { prerequisiteBodyViolations } from '../artifacts/prerequisite-checks.js';
12
13
  import { showRequestArtifact } from '../artifacts/request-artifact-service.js';
13
14
  import { readArtifactState } from '../artifacts/request-artifact-state-helpers.js';
14
15
  export function extractState(markdown) {
@@ -209,7 +209,7 @@ export async function verifyPipeline(options) {
209
209
  // artifact is absent, so `unpromoted` mixes "never promoted" with
210
210
  // "promoted on paper only" — the reason on each entry says which.
211
211
  feedbackGates[0].detail = `${unpromoted.length} feedback memor${unpromoted.length === 1 ? 'y' : 'ies'} without a backed promotion: ${unpromoted.map((u) => `${u.name} (${u.reason})`).join('; ')}${exemptNote}`;
212
- violations.push(`Gate H feedback-promotion FAILED: ${unpromoted.length} feedback memor${unpromoted.length === 1 ? 'y is' : 'ies are'} not yet promoted to an enforcement layer with a real artifact (${unpromoted.map((u) => u.name).join(', ')})${exemptNote}. A marker alone does not count: layer A needs a registered SOP manifest, layer B a hook command that runs something named after the rule in .peaks/.claude-settings-template.json, layer C a hard-floor category in src/services/code/mode-gate.ts. Run \`peaks feedback promote <memory-file> --layer <A|B|C>\` for each and read what it reports. See sops/feedback-promotion-sop.md.`);
212
+ violations.push(`Gate H feedback-promotion FAILED: ${unpromoted.length} feedback memor${unpromoted.length === 1 ? 'y is' : 'ies are'} not yet promoted to an enforcement layer with a real artifact (${unpromoted.map((u) => u.name).join(', ')})${exemptNote}. A marker alone does not count: layer A needs a registered SOP manifest, layer B a hook command that runs something named after the rule in .peaks/.claude-settings-template.json or the tracked .claude/settings.json, layer C a hard-floor category in src/services/code/mode-gate.ts. Run \`peaks feedback promote <memory-file> --layer <A|B|C>\` for each and read what it reports. See sops/feedback-promotion-sop.md.`);
213
213
  nextActions.push(`Run \`peaks feedback promote <memory-file> --layer <A|B|C>\` for each feedback memory without a backed promotion to satisfy Gate H.`);
214
214
  }
215
215
  }
@@ -1,23 +1,3 @@
1
- /**
2
- *
3
- * Pure-function classifier (`canSkipSlice`) + side-effecting applicator
4
- * (`applySkip`). Both are testable without filesystem mocks (the
5
- * applicator accepts an injected `readSkipState` / `writeSkipState`
6
- * pair so the unit tests use in-memory fakes; the production caller
7
- * passes the real store from `workflow-state-store.ts`).
8
- *
9
- * Three rules (per RD §Why + Tech Doc §2-4):
10
- * - Rule 1 (slice type allowlist): `bugfix` / `feature` / `refactor`
11
- * can never skip QA, regardless of `--reason`. The allowlist is
12
- * `['docs', 'config', 'chore']`.
13
- * - Rule 2 (one-time semantics): if a skip-marker already exists for
14
- * this rid AND the requested skip is the same → idempotent
15
- * no-op (`applied: false, idempotent: true`). If different → deny
16
- * with `reason: "rid already has a different skip applied"`.
17
- * - Rule 3 (role-based authorization): scripts (caller kind derived
18
- * from `$PEAKS_CALLER_ID` env var) MUST pass `--i-have-reviewed`
19
- * in addition to `--reason`.
20
- */
21
1
  import { type WorkflowSkipState } from './workflow-state-store.js';
22
2
  import type { RequestType } from '../artifacts/artifact-prerequisites.js';
23
3
  export type SkipArgs = {
@@ -18,6 +18,8 @@
18
18
  * from `$PEAKS_CALLER_ID` env var) MUST pass `--i-have-reviewed`
19
19
  * in addition to `--reason`.
20
20
  */
21
+ import { execFileSync } from 'node:child_process';
22
+ import { userInfo } from 'node:os';
21
23
  import { readSkipState, writeSkipState } from './workflow-state-store.js';
22
24
  import { showRequestArtifact } from '../artifacts/request-artifact-service.js';
23
25
  const SKIPPABLE_TYPES = ['docs', 'config', 'chore'];
@@ -190,8 +192,6 @@ function pathFromStateFile(projectRoot, sessionId, rid) {
190
192
  * unavailable. Never throws. */
191
193
  function resolveSkipAppliedBy() {
192
194
  try {
193
- // Lazy require so the unit tests can stub via process.env.
194
- const { execFileSync } = require('node:child_process');
195
195
  const out = execFileSync('git', ['config', '--global', 'user.name'], {
196
196
  encoding: 'utf8',
197
197
  stdio: ['ignore', 'pipe', 'ignore'],
@@ -207,8 +207,7 @@ function resolveSkipAppliedBy() {
207
207
  // fall through
208
208
  }
209
209
  try {
210
- const os = require('node:os');
211
- const info = os.userInfo();
210
+ const info = userInfo();
212
211
  return info.username;
213
212
  }
214
213
  catch {
@@ -0,0 +1,54 @@
1
+ /**
2
+ * `claude-settings-retirements.ts` — the `hooks.PreToolUse` entries this template
3
+ * used to declare and has since RETIRED, plus the shape predicate the retirement
4
+ * is tested against.
5
+ *
6
+ * WHY A RETIREMENT IS NOT A DELETION. `mergeTemplateOwnedHooks` (in
7
+ * `claude-settings-template-merge.ts`) carries across every on-disk entry the
8
+ * template does not declare — that is the whole point of the entry-level
9
+ * ownership rule, and it is what keeps `installAutoCompactHook`'s `Bash|Task`
10
+ * entry alive across an init. So simply STOPPING the emission reaches nobody: an
11
+ * install written by an earlier release keeps the entry forever. Declaring less
12
+ * cannot retire an entry; something has to say "this one is gone", and
13
+ * `isRetiredTemplateEntry` is that something. `templateContentMatches` calls it
14
+ * too, because a file still carrying a retired entry has to compare as DRIFTED or
15
+ * the merge that would drop it never runs.
16
+ *
17
+ * Extracted from `claude-settings-template-merge.ts` when the second retirement
18
+ * pushed that module past the 300-line cap. The bodies moved verbatim; the
19
+ * predicate and its two shape types came along because the predicate is their
20
+ * only reader inside that module.
21
+ *
22
+ * TWO RETIREMENTS SO FAR:
23
+ * - TEMPLATE_VERSION 1.8.0 — the `Write|Edit|MultiEdit` gate handler;
24
+ * - TEMPLATE_VERSION 1.10.0 — the two layer-B feedback hooks.
25
+ * They share neither a matcher nor a command form, so each gets its own narrow
26
+ * predicate rather than one looser rule. The narrowness is load-bearing: a
27
+ * predicate that dropped "anything on this matcher" would delete a USER's hook,
28
+ * which is the failure the ownership rule exists to prevent.
29
+ */
30
+ /** One handler in a `hooks.PreToolUse` entry, in the shape this template declares. */
31
+ export type TemplateHookCommand = {
32
+ type: string;
33
+ command: string;
34
+ shell?: string;
35
+ };
36
+ /**
37
+ * One `hooks.PreToolUse` entry in the shape this template declares. The
38
+ * `matcher` + `hooks` pair is the entry's identity everywhere in this concern:
39
+ * `matcher` alone is not unique (two `Bash` entries), and whole-object identity
40
+ * would make a hand-edited entry unrecognizable and therefore unrepairable.
41
+ */
42
+ export type TemplatePreToolUseEntry = {
43
+ matcher: string;
44
+ hooks: TemplateHookCommand[];
45
+ };
46
+ export declare function isPreToolUseEntry(value: unknown): value is TemplatePreToolUseEntry;
47
+ /**
48
+ * Is `entry` one this template used to declare and has since RETIRED?
49
+ *
50
+ * Each retirement gets its own narrow predicate — the shapes share neither a
51
+ * matcher nor a command form. An entry whose shape matches nothing here is not
52
+ * retired, and is preserved.
53
+ */
54
+ export declare function isRetiredTemplateEntry(entry: unknown): boolean;
@@ -0,0 +1,112 @@
1
+ /**
2
+ * `claude-settings-retirements.ts` — the `hooks.PreToolUse` entries this template
3
+ * used to declare and has since RETIRED, plus the shape predicate the retirement
4
+ * is tested against.
5
+ *
6
+ * WHY A RETIREMENT IS NOT A DELETION. `mergeTemplateOwnedHooks` (in
7
+ * `claude-settings-template-merge.ts`) carries across every on-disk entry the
8
+ * template does not declare — that is the whole point of the entry-level
9
+ * ownership rule, and it is what keeps `installAutoCompactHook`'s `Bash|Task`
10
+ * entry alive across an init. So simply STOPPING the emission reaches nobody: an
11
+ * install written by an earlier release keeps the entry forever. Declaring less
12
+ * cannot retire an entry; something has to say "this one is gone", and
13
+ * `isRetiredTemplateEntry` is that something. `templateContentMatches` calls it
14
+ * too, because a file still carrying a retired entry has to compare as DRIFTED or
15
+ * the merge that would drop it never runs.
16
+ *
17
+ * Extracted from `claude-settings-template-merge.ts` when the second retirement
18
+ * pushed that module past the 300-line cap. The bodies moved verbatim; the
19
+ * predicate and its two shape types came along because the predicate is their
20
+ * only reader inside that module.
21
+ *
22
+ * TWO RETIREMENTS SO FAR:
23
+ * - TEMPLATE_VERSION 1.8.0 — the `Write|Edit|MultiEdit` gate handler;
24
+ * - TEMPLATE_VERSION 1.10.0 — the two layer-B feedback hooks.
25
+ * They share neither a matcher nor a command form, so each gets its own narrow
26
+ * predicate rather than one looser rule. The narrowness is load-bearing: a
27
+ * predicate that dropped "anything on this matcher" would delete a USER's hook,
28
+ * which is the failure the ownership rule exists to prevent.
29
+ */
30
+ export function isPreToolUseEntry(value) {
31
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
32
+ return false;
33
+ }
34
+ const candidate = value;
35
+ return typeof candidate.matcher === 'string' && Array.isArray(candidate.hooks);
36
+ }
37
+ /**
38
+ * The retired `Write|Edit|MultiEdit` gate entry, as an on-disk file written by a
39
+ * pre-1.8.0 release holds it.
40
+ *
41
+ * TEMPLATE_VERSION 1.8.0 stopped emitting this entry. Declaring less is not
42
+ * enough on its own: `mergeTemplateOwnedHooks` preserves every on-disk entry the
43
+ * template does not declare — that is the whole point of the entry-level
44
+ * ownership rule (it is what keeps `installAutoCompactHook`'s `Bash|Task` entry
45
+ * alive) — so a project installed by an earlier release would keep the no-op
46
+ * handler, and its `node "C:/…/nvm/v24.14.0/…"` path, forever.
47
+ *
48
+ * Deliberately narrow. It matches the exact command shape this template used to
49
+ * emit — one handler, `node "<…>/services/hooks/write-gate.js"` — under the exact
50
+ * legacy matcher spelling, so a user's OWN `Write|Edit|MultiEdit` entry (a
51
+ * different command, or more than one handler) is preserved like any other entry
52
+ * the template does not declare.
53
+ */
54
+ const RETIRED_WRITE_GATE_MATCHER = 'Write|Edit|MultiEdit';
55
+ const RETIRED_WRITE_GATE_COMMAND = /^node "[^"]*\/services\/hooks\/write-gate\.js"$/;
56
+ /**
57
+ * The two layer-B feedback hooks TEMPLATE_VERSION 1.10.0 retired, as a file
58
+ * written by 1.9.0 holds them.
59
+ *
60
+ * 1.9.0 emitted them into the CONSUMER template on purpose, to make the promotion
61
+ * a property of a fresh clone rather than of one machine. The template cannot do
62
+ * that: it is written into a consumer project's `.claude/settings.local.json`,
63
+ * where `${CLAUDE_PROJECT_DIR}` is the CONSUMER's root, `src/**` is absent from
64
+ * the npm `files` list, and nothing copies it — so every downstream project
65
+ * received two `Bash` PreToolUse entries whose command could never resolve, and a
66
+ * fresh clone of THIS repository got neither them nor a tracked copy of the
67
+ * registration (`settings.local.json` is gitignored). They are this repository's
68
+ * own development hooks; the registration now lives in this repository's tracked
69
+ * `.claude/settings.json`, where `${CLAUDE_PROJECT_DIR}` really is the root that
70
+ * contains `src/`.
71
+ *
72
+ * Same mechanism and same reason as the write gate above: `mergeTemplateOwnedHooks`
73
+ * preserves every on-disk entry the template does not declare, so REMOVING the
74
+ * spread from `buildClaudeSettingsLocalJson` would leave the two unresolvable
75
+ * entries in every install that already had them, forever.
76
+ *
77
+ * Deliberately narrow: it matches the exact command string 1.9.0 emitted — `bash`,
78
+ * then the project-root variable, then that script's shipped path — under the
79
+ * matcher 1.9.0 used, with a single handler. A consumer's own `Bash` entry (a
80
+ * different command, or more than one handler) is preserved like any other entry
81
+ * the template does not declare.
82
+ */
83
+ const RETIRED_FEEDBACK_HOOK_MATCHER = 'Bash';
84
+ const RETIRED_FEEDBACK_HOOK_COMMANDS = new Set([
85
+ 'pre-tool-peaks-current-directory-scope.sh',
86
+ 'pre-tool-piping-a-test-run-reports-the-pipes-exit-code.sh'
87
+ ].map((script) => `bash "\${CLAUDE_PROJECT_DIR}/src/services/hooks/${script}"`));
88
+ /**
89
+ * Is `entry` one this template used to declare and has since RETIRED?
90
+ *
91
+ * Each retirement gets its own narrow predicate — the shapes share neither a
92
+ * matcher nor a command form. An entry whose shape matches nothing here is not
93
+ * retired, and is preserved.
94
+ */
95
+ export function isRetiredTemplateEntry(entry) {
96
+ if (!isPreToolUseEntry(entry))
97
+ return false;
98
+ if (entry.hooks.length !== 1)
99
+ return false;
100
+ const [handler] = entry.hooks;
101
+ if (handler === undefined)
102
+ return false;
103
+ if (handler.type !== 'command')
104
+ return false;
105
+ if (entry.matcher === RETIRED_WRITE_GATE_MATCHER) {
106
+ return RETIRED_WRITE_GATE_COMMAND.test(handler.command);
107
+ }
108
+ if (entry.matcher === RETIRED_FEEDBACK_HOOK_MATCHER) {
109
+ return RETIRED_FEEDBACK_HOOK_COMMANDS.has(handler.command);
110
+ }
111
+ return false;
112
+ }
@@ -0,0 +1,109 @@
1
+ /**
2
+ * `claude-settings-template-merge.ts` — the comparison and the merge that decide
3
+ * whether an on-disk settings file still declares what the template declares, and
4
+ * that carry every entry the template does not declare across untouched.
5
+ *
6
+ * Split out of `claude-settings-template.ts` (475 raw lines against the 300 cap)
7
+ * when the two layer-B feedback hook entries had to be added to the template: that
8
+ * file now holds the template's own shape, and this one holds the merge machinery.
9
+ * The bodies moved verbatim; the three non-null assertions became the explicit
10
+ * `undefined` checks they already were in effect, so this module is clean at birth.
11
+ * `claude-settings-template.ts` re-exports every symbol below, so it stays the
12
+ * single public entry point for this concern.
13
+ */
14
+ import { isRetiredTemplateEntry } from './claude-settings-retirements.js';
15
+ /**
16
+ * Compare two serialized template strings: does the on-disk file already
17
+ * declare every entry the generated tree declares?
18
+ *
19
+ * This comparator answers "is each entry the GENERATED tree declares present
20
+ * on disk?", NOT "are the two `hooks` trees identical". Extra on-disk entries
21
+ * are IGNORED, so an entry another writer put in this file never makes it look
22
+ * drifted.
23
+ *
24
+ * That is the deliberate other half of the entry-level merge in
25
+ * `mergeTemplateOwnedHooks` / `workspace-claude-settings-materializer.ts`.
26
+ * `.claude/settings.local.json` has a SECOND writer of `hooks.PreToolUse`:
27
+ * `installAutoCompactHook` appends a `Bash|Task` entry. Under the previous
28
+ * exact-tree rule the merged file carried 4 entries against a 3-entry
29
+ * generated tree, so every `peaks workspace init` answered "drifted",
30
+ * rewrote, and reported `refreshed` forever — precisely the state whole-key
31
+ * ownership existed to prevent, and the reason the merge could not ship alone.
32
+ *
33
+ * Matching is order-insensitive AND multiset-aware: the template declares TWO
34
+ * `Bash` entries — a MEASUREMENT, not a memory, so it is pinned to a predicate
35
+ * rather than restated in prose: `buildClaudeSettingsLocalJson().hooks.
36
+ * PreToolUse` filtered on `matcher === 'Bash'` has length 2 (the Step 0.8 gate
37
+ * and `gate enforce`). Each must have its own counterpart on disk, so a file
38
+ * carrying only one of them is still reported as drifted (the previous
39
+ * index-by-index loop had the same property; it is load-bearing, not a
40
+ * detail). The live count was 4 from TEMPLATE_VERSION 1.9.0 until 1.10.0 retired
41
+ * the two layer-B feedback hooks from the template, which is exactly how a
42
+ * prose count goes stale.
43
+ *
44
+ * Returns `true` iff both strings parse to objects whose `hooks.PreToolUse`
45
+ * arrays satisfy that containment, the on-disk file carries NO entry this
46
+ * template has retired (`isRetiredTemplateEntry`), AND the on-disk `env`
47
+ * already carries every exemption the template declares (extra on-disk keys
48
+ * and extra globs are allowed — a user may exempt other trees, and a
49
+ * requirement the file already exceeds must not re-trigger a write).
50
+ *
51
+ * Returns `false` on any `JSON.parse` error, shape mismatch, or
52
+ * missing `hooks.PreToolUse`. Whitespace and key order do NOT affect
53
+ * the result — the comparison is on the parsed AST, not on bytes.
54
+ *
55
+ * This is the comparator `initWorkspace` uses to decide whether to
56
+ * refresh a stale `.peaks/.claude-settings-template.json` on disk.
57
+ */
58
+ export declare function templateContentMatches(generated: string, onDisk: string): boolean;
59
+ /**
60
+ * Merge the on-disk `hooks.PreToolUse` list with the template's.
61
+ *
62
+ * the entries IT DECLARES — and nothing else. Every other on-disk entry is
63
+ * carried across verbatim, whatever its matcher, because the template has no
64
+ * opinion about it:
65
+ *
66
+ * - a `matcher` the template does not declare (`Bash|Task`, the auto-compact
67
+ * hook `installAutoCompactHook` appends) is never touched;
68
+ * - surplus entries BEYOND the template's count for a declared matcher (a
69
+ * user's own `Bash` hook) are surplus too, and survive;
70
+ * - an on-disk entry that fills a declared slot is REPLACED by the template's
71
+ * entry for it. That is what makes a hand-edited (or older-release) entry
72
+ * self-heal instead of lingering next to a correct copy of itself.
73
+ *
74
+ * Slot counting is per `matcher` and positional within it: the template
75
+ * declares TWO `Bash` entries — `buildClaudeSettingsLocalJson()` filtered on
76
+ * `matcher === 'Bash'` is the measurement, and it is 2 — so the first two
77
+ * on-disk `Bash` entries are theirs and a third is the user's. (It was 4 while
78
+ * TEMPLATE_VERSION 1.9.0 also declared the two layer-B feedback hooks; 1.10.0
79
+ * retired those, and because the retirement is tested BEFORE slot counting they
80
+ * never occupy a slot on their way out.) The template's entries are emitted
81
+ * first, in template order, then the preserved ones in their on-disk order —
82
+ * which is a fixed point: re-merging the result yields the result (the
83
+ * template's own entries are encountered first and refill their own slots).
84
+ *
85
+ * Non-conforming entries (no string `matcher`, no `hooks` array) are preserved
86
+ * rather than dropped: guessing at their shape is how a user's entry gets
87
+ * deleted.
88
+ *
89
+ * ONE exception to "preserve what I do not declare": an entry this template
90
+ * used to declare and RETIRED is dropped rather than preserved — TEMPLATE_
91
+ * VERSION 1.8.0's `Write|Edit|MultiEdit` gate, and 1.10.0's two layer-B feedback
92
+ * hooks (see `isRetiredTemplateEntry`). Declaring less cannot retire an entry on
93
+ * its own, because preserving undeclared entries is exactly what this function
94
+ * does; without the drop, a pre-1.8.0 install would keep the no-op handler and
95
+ * its version-pinned script path forever, and a pre-1.10.0 consumer would keep
96
+ * two `Bash` entries whose command points into an `src/` tree it never
97
+ * received. Each predicate is narrow enough that only the exact command this
98
+ * template emitted matches.
99
+ */
100
+ export declare function mergeTemplateOwnedHooks(onDisk: ReadonlyArray<unknown>, template: ReadonlyArray<unknown>): unknown[];
101
+ /**
102
+ * The retirement vocabulary — the entries this template used to declare and has
103
+ * since RETIRED, and the shape predicate that says so — lives in
104
+ * `claude-settings-retirements.ts`. It was extracted when the second retirement
105
+ * pushed this module past the 300-line cap. Re-exported here so
106
+ * `claude-settings-template.ts`, the single public entry point for the template
107
+ * concern, still reaches it through the module it always did.
108
+ */
109
+ export { isRetiredTemplateEntry };