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,223 @@
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 { hasExternalGateExemptions } from '../skills/hooks-codegate-superpowers.js';
15
+ import { isPreToolUseEntry, isRetiredTemplateEntry } from './claude-settings-retirements.js';
16
+ /**
17
+ * Compare two serialized template strings: does the on-disk file already
18
+ * declare every entry the generated tree declares?
19
+ *
20
+ * This comparator answers "is each entry the GENERATED tree declares present
21
+ * on disk?", NOT "are the two `hooks` trees identical". Extra on-disk entries
22
+ * are IGNORED, so an entry another writer put in this file never makes it look
23
+ * drifted.
24
+ *
25
+ * That is the deliberate other half of the entry-level merge in
26
+ * `mergeTemplateOwnedHooks` / `workspace-claude-settings-materializer.ts`.
27
+ * `.claude/settings.local.json` has a SECOND writer of `hooks.PreToolUse`:
28
+ * `installAutoCompactHook` appends a `Bash|Task` entry. Under the previous
29
+ * exact-tree rule the merged file carried 4 entries against a 3-entry
30
+ * generated tree, so every `peaks workspace init` answered "drifted",
31
+ * rewrote, and reported `refreshed` forever — precisely the state whole-key
32
+ * ownership existed to prevent, and the reason the merge could not ship alone.
33
+ *
34
+ * Matching is order-insensitive AND multiset-aware: the template declares TWO
35
+ * `Bash` entries — a MEASUREMENT, not a memory, so it is pinned to a predicate
36
+ * rather than restated in prose: `buildClaudeSettingsLocalJson().hooks.
37
+ * PreToolUse` filtered on `matcher === 'Bash'` has length 2 (the Step 0.8 gate
38
+ * and `gate enforce`). Each must have its own counterpart on disk, so a file
39
+ * carrying only one of them is still reported as drifted (the previous
40
+ * index-by-index loop had the same property; it is load-bearing, not a
41
+ * detail). The live count was 4 from TEMPLATE_VERSION 1.9.0 until 1.10.0 retired
42
+ * the two layer-B feedback hooks from the template, which is exactly how a
43
+ * prose count goes stale.
44
+ *
45
+ * Returns `true` iff both strings parse to objects whose `hooks.PreToolUse`
46
+ * arrays satisfy that containment, the on-disk file carries NO entry this
47
+ * template has retired (`isRetiredTemplateEntry`), AND the on-disk `env`
48
+ * already carries every exemption the template declares (extra on-disk keys
49
+ * and extra globs are allowed — a user may exempt other trees, and a
50
+ * requirement the file already exceeds must not re-trigger a write).
51
+ *
52
+ * Returns `false` on any `JSON.parse` error, shape mismatch, or
53
+ * missing `hooks.PreToolUse`. Whitespace and key order do NOT affect
54
+ * the result — the comparison is on the parsed AST, not on bytes.
55
+ *
56
+ * This is the comparator `initWorkspace` uses to decide whether to
57
+ * refresh a stale `.peaks/.claude-settings-template.json` on disk.
58
+ */
59
+ export function templateContentMatches(generated, onDisk) {
60
+ let parsedGenerated;
61
+ let parsedOnDisk;
62
+ try {
63
+ parsedGenerated = JSON.parse(generated);
64
+ }
65
+ catch {
66
+ return false;
67
+ }
68
+ try {
69
+ parsedOnDisk = JSON.parse(onDisk);
70
+ }
71
+ catch {
72
+ return false;
73
+ }
74
+ if (!isTemplateShape(parsedGenerated) || !isTemplateShape(parsedOnDisk)) {
75
+ return false;
76
+ }
77
+ // Multiset containment: consume one on-disk entry per generated entry so a
78
+ // file holding a single copy of a doubly-declared entry still fails.
79
+ const unmatched = [...parsedOnDisk.hooks.PreToolUse];
80
+ for (const required of parsedGenerated.hooks.PreToolUse) {
81
+ const at = unmatched.findIndex((candidate) => sameEntry(required, candidate));
82
+ if (at === -1) {
83
+ return false;
84
+ }
85
+ unmatched.splice(at, 1);
86
+ }
87
+ // A RETIRED entry on disk is drift, and this clause is what makes the
88
+ // retirement in `mergeTemplateOwnedHooks` reach an installed file at all.
89
+ //
90
+ // Containment alone cannot express it: a file still carrying
91
+ // `Write|Edit|MultiEdit` declares every entry the template declares, so
92
+ // `templateContentMatches` answered "current", no rewrite ran, and the merge
93
+ // never got the chance to drop it. Measured on a throwaway project root
94
+ // before this clause existed — init against the rebuilt CLI reported
95
+ // `already-current` and the retired entry survived verbatim. Declaring less
96
+ // is not a retirement; the comparator has to say so.
97
+ //
98
+ // One extra rewrite per affected install, then the fixed point holds: the
99
+ // merge emits no retired entry, so the next comparison finds none and
100
+ // answers `current`.
101
+ if (parsedOnDisk.hooks.PreToolUse.some((entry) => isRetiredTemplateEntry(entry))) {
102
+ return false;
103
+ }
104
+ // A project installed by a release that predates a template-declared
105
+ // exemption still needs the refresh this comparator gates — otherwise the
106
+ // entry would only ever appear on a machine that re-ran `peaks hooks
107
+ // install`. `hasExternalGateExemptions` is the same predicate the installer
108
+ // uses, so the two writers cannot drift apart.
109
+ return hasExternalGateExemptions({ env: parsedOnDisk.env });
110
+ }
111
+ /**
112
+ * Merge the on-disk `hooks.PreToolUse` list with the template's.
113
+ *
114
+ * the entries IT DECLARES — and nothing else. Every other on-disk entry is
115
+ * carried across verbatim, whatever its matcher, because the template has no
116
+ * opinion about it:
117
+ *
118
+ * - a `matcher` the template does not declare (`Bash|Task`, the auto-compact
119
+ * hook `installAutoCompactHook` appends) is never touched;
120
+ * - surplus entries BEYOND the template's count for a declared matcher (a
121
+ * user's own `Bash` hook) are surplus too, and survive;
122
+ * - an on-disk entry that fills a declared slot is REPLACED by the template's
123
+ * entry for it. That is what makes a hand-edited (or older-release) entry
124
+ * self-heal instead of lingering next to a correct copy of itself.
125
+ *
126
+ * Slot counting is per `matcher` and positional within it: the template
127
+ * declares TWO `Bash` entries — `buildClaudeSettingsLocalJson()` filtered on
128
+ * `matcher === 'Bash'` is the measurement, and it is 2 — so the first two
129
+ * on-disk `Bash` entries are theirs and a third is the user's. (It was 4 while
130
+ * TEMPLATE_VERSION 1.9.0 also declared the two layer-B feedback hooks; 1.10.0
131
+ * retired those, and because the retirement is tested BEFORE slot counting they
132
+ * never occupy a slot on their way out.) The template's entries are emitted
133
+ * first, in template order, then the preserved ones in their on-disk order —
134
+ * which is a fixed point: re-merging the result yields the result (the
135
+ * template's own entries are encountered first and refill their own slots).
136
+ *
137
+ * Non-conforming entries (no string `matcher`, no `hooks` array) are preserved
138
+ * rather than dropped: guessing at their shape is how a user's entry gets
139
+ * deleted.
140
+ *
141
+ * ONE exception to "preserve what I do not declare": an entry this template
142
+ * used to declare and RETIRED is dropped rather than preserved — TEMPLATE_
143
+ * VERSION 1.8.0's `Write|Edit|MultiEdit` gate, and 1.10.0's two layer-B feedback
144
+ * hooks (see `isRetiredTemplateEntry`). Declaring less cannot retire an entry on
145
+ * its own, because preserving undeclared entries is exactly what this function
146
+ * does; without the drop, a pre-1.8.0 install would keep the no-op handler and
147
+ * its version-pinned script path forever, and a pre-1.10.0 consumer would keep
148
+ * two `Bash` entries whose command points into an `src/` tree it never
149
+ * received. Each predicate is narrow enough that only the exact command this
150
+ * template emitted matches.
151
+ */
152
+ export function mergeTemplateOwnedHooks(onDisk, template) {
153
+ const slots = new Map();
154
+ for (const entry of template) {
155
+ if (!isPreToolUseEntry(entry))
156
+ continue;
157
+ slots.set(entry.matcher, (slots.get(entry.matcher) ?? 0) + 1);
158
+ }
159
+ const taken = new Map();
160
+ const preserved = [];
161
+ for (const entry of onDisk) {
162
+ // Retired by this template — dropped, not carried across.
163
+ if (isRetiredTemplateEntry(entry)) {
164
+ continue;
165
+ }
166
+ // Unowned by construction: not a shape the template could have declared.
167
+ if (!isPreToolUseEntry(entry)) {
168
+ preserved.push(entry);
169
+ continue;
170
+ }
171
+ const declared = slots.get(entry.matcher) ?? 0;
172
+ const used = taken.get(entry.matcher) ?? 0;
173
+ if (used >= declared) {
174
+ preserved.push(entry);
175
+ continue;
176
+ }
177
+ taken.set(entry.matcher, used + 1);
178
+ }
179
+ return [...template, ...preserved];
180
+ }
181
+ /** Structural equality of two `PreToolUse` entries. */
182
+ function sameEntry(a, b) {
183
+ return a.matcher === b.matcher && sameHooksArray(a.hooks, b.hooks);
184
+ }
185
+ function isTemplateShape(value) {
186
+ if (typeof value !== 'object' || value === null) {
187
+ return false;
188
+ }
189
+ const candidate = value;
190
+ if (typeof candidate.hooks !== 'object' || candidate.hooks === null) {
191
+ return false;
192
+ }
193
+ const hooksObj = candidate.hooks;
194
+ return Array.isArray(hooksObj.PreToolUse);
195
+ }
196
+ function sameHooksArray(a, b) {
197
+ if (a.length !== b.length) {
198
+ return false;
199
+ }
200
+ for (let i = 0; i < a.length; i += 1) {
201
+ const ha = a[i];
202
+ const hb = b[i];
203
+ if (ha === undefined || hb === undefined) {
204
+ return false;
205
+ }
206
+ // `shell` participates in the comparison: it is machine-specific (see
207
+ // `resolveHookShell`), so a file written on one platform must be
208
+ // recognized as drifted on the other instead of silently kept.
209
+ if (ha.type !== hb.type || ha.command !== hb.command || ha.shell !== hb.shell) {
210
+ return false;
211
+ }
212
+ }
213
+ return true;
214
+ }
215
+ /**
216
+ * The retirement vocabulary — the entries this template used to declare and has
217
+ * since RETIRED, and the shape predicate that says so — lives in
218
+ * `claude-settings-retirements.ts`. It was extracted when the second retirement
219
+ * pushed this module past the 300-line cap. Re-exported here so
220
+ * `claude-settings-template.ts`, the single public entry point for the template
221
+ * concern, still reaches it through the module it always did.
222
+ */
223
+ export { isRetiredTemplateEntry };
@@ -23,10 +23,17 @@
23
23
  * it can be unit-tested in isolation and so the on-disk file matches
24
24
  * the in-memory template byte-for-byte.
25
25
  *
26
- * Two `Bash` matchers are emitted (the Step 0.8 mechanical gate and the
27
- * SOP gate-enforce handler). No `Write|Edit|MultiEdit` entry is emitted:
28
- * that matcher's gate is `peaks code-gate --json`, installed into the
29
- * committed `.claude/settings.json` by `peaks hooks install`.
26
+ * TWO `Bash` matchers are emitted: the Step 0.8 mechanical gate and the SOP
27
+ * gate-enforce handler. No `Write|Edit|MultiEdit` entry is emitted: that
28
+ * matcher's gate is `peaks code-gate`, installed into the committed
29
+ * `.claude/settings.json` by `peaks hooks install`. TEMPLATE_VERSION 1.10.0
30
+ * removed the two layer-B feedback hooks this file used to emit: they are this
31
+ * repository's OWN development hooks, and this file is written into a
32
+ * CONSUMER project, where `${CLAUDE_PROJECT_DIR}` is that project's root, no
33
+ * `src/**` is ever shipped, and the command therefore points at nothing. They
34
+ * are registered in this repository's tracked `.claude/settings.json` instead;
35
+ * `isRetiredTemplateEntry` in `claude-settings-template-merge.ts` is what makes
36
+ * an install that already has them converge.
30
37
  *
31
38
  * The previous `Bash` matcher (which whitelisted a fixed `peaks
32
39
  * <subcommand>` prefix) was removed in TEMPLATE_VERSION 1.2.0. The
@@ -40,6 +47,14 @@
40
47
  * consumer project's `.claude/settings.json` and which exits 0
41
48
  * silently for any command not guarded by a registered SOP gate.
42
49
  */
50
+ /**
51
+ * The comparison and the entry-level merge live in
52
+ * `claude-settings-template-merge.ts` — they were two thirds of this file's
53
+ * bytes and none of its template shape. Re-exported here so this module stays
54
+ * the single public entry point for the template concern: no caller has to
55
+ * know which half a symbol lives in.
56
+ */
57
+ export { isRetiredTemplateEntry, mergeTemplateOwnedHooks, templateContentMatches } from './claude-settings-template-merge.js';
43
58
  export declare const CLAUDE_SETTINGS_LOCAL_FILENAME = ".claude/settings.local.json";
44
59
  /**
45
60
  * Informational version of the offline template shape. Bumped when the
@@ -97,84 +112,31 @@ export declare const CLAUDE_SETTINGS_LOCAL_FILENAME = ".claude/settings.local.js
97
112
  * `mergeTemplateOwnedHooks` drops the retired entry from
98
113
  * existing on-disk files, so an earlier install converges
99
114
  * instead of keeping a no-op with a stale absolute path.
115
+ * 1.9.0 — added the two layer-B feedback hook entries
116
+ * (`pre-tool-peaks-current-directory-scope.sh` and
117
+ * `pre-tool-piping-a-test-run-reports-the-pipes-exit-code.sh`),
118
+ * pinned to `shell: bash`. Until now their registration existed only
119
+ * in the generated copies on the machine that hand-wrote them: a
120
+ * fresh clone got the two scripts and no registration, so the
121
+ * promotion they carry was true only locally. See
122
+ * `buildFeedbackHookHandler` for why the pin is `bash` and not the
123
+ * `powershell` its three siblings take.
124
+ * 1.10.0 — REMOVED those two entries again, and retired them so every install
125
+ * that already carries them converges. 1.9.0's INTENT was right — a
126
+ * fresh clone should carry the registration, not just the scripts —
127
+ * but this file is the wrong mechanism for it. This template is
128
+ * written into a CONSUMER project's `.claude/settings.local.json`,
129
+ * where `${CLAUDE_PROJECT_DIR}` is the consumer's root, `src/**` is
130
+ * not in the npm `files` list, and nothing copies it, so the two
131
+ * entries were a command that could never resolve in every
132
+ * downstream project; and this repository, whose `settings.local.json`
133
+ * is gitignored, got no tracked copy either. The scripts STAY here —
134
+ * they are this repository's own development hooks — and the
135
+ * registration moved to the tracked `.claude/settings.json`.
136
+ * `isRetiredTemplateEntry` carries the retirement, because declaring
137
+ * less cannot retire an entry on its own.
100
138
  */
101
- export declare const TEMPLATE_VERSION = "1.8.0";
102
- /**
103
- * Compare two serialized template strings: does the on-disk file already
104
- * declare every entry the generated tree declares?
105
- *
106
- * This comparator answers "is each entry the GENERATED tree declares present
107
- * on disk?", NOT "are the two `hooks` trees identical". Extra on-disk entries
108
- * are IGNORED, so an entry another writer put in this file never makes it look
109
- * drifted.
110
- *
111
- * That is the deliberate other half of the entry-level merge in
112
- * `mergeTemplateOwnedHooks` / `workspace-claude-settings-materializer.ts`.
113
- * `.claude/settings.local.json` has a SECOND writer of `hooks.PreToolUse`:
114
- * `installAutoCompactHook` appends a `Bash|Task` entry. Under the previous
115
- * exact-tree rule the merged file carried 4 entries against a 3-entry
116
- * generated tree, so every `peaks workspace init` answered "drifted",
117
- * rewrote, and reported `refreshed` forever — precisely the state whole-key
118
- * ownership existed to prevent, and the reason the merge could not ship alone.
119
- *
120
- * Matching is order-insensitive AND multiset-aware: the template declares TWO
121
- * `Bash` entries, and each must have its own counterpart on disk, so a file
122
- * carrying only one of them is still reported as drifted (the previous
123
- * index-by-index loop had the same property; it is load-bearing, not a
124
- * detail).
125
- *
126
- * Returns `true` iff both strings parse to objects whose `hooks.PreToolUse`
127
- * arrays satisfy that containment, the on-disk file carries NO entry this
128
- * template has retired (`isRetiredTemplateEntry`), AND the on-disk `env`
129
- * already carries every exemption the template declares (extra on-disk keys
130
- * and extra globs are allowed — a user may exempt other trees, and a
131
- * requirement the file already exceeds must not re-trigger a write).
132
- *
133
- * Returns `false` on any `JSON.parse` error, shape mismatch, or
134
- * missing `hooks.PreToolUse`. Whitespace and key order do NOT affect
135
- * the result — the comparison is on the parsed AST, not on bytes.
136
- *
137
- * This is the comparator `initWorkspace` uses to decide whether to
138
- * refresh a stale `.peaks/.claude-settings-template.json` on disk.
139
- */
140
- export declare function templateContentMatches(generated: string, onDisk: string): boolean;
141
- /**
142
- * Merge the on-disk `hooks.PreToolUse` list with the template's.
143
- *
144
- * the entries IT DECLARES — and nothing else. Every other on-disk entry is
145
- * carried across verbatim, whatever its matcher, because the template has no
146
- * opinion about it:
147
- *
148
- * - a `matcher` the template does not declare (`Bash|Task`, the auto-compact
149
- * hook `installAutoCompactHook` appends) is never touched;
150
- * - surplus entries BEYOND the template's count for a declared matcher (a
151
- * user's own `Bash` hook) are surplus too, and survive;
152
- * - an on-disk entry that fills a declared slot is REPLACED by the template's
153
- * entry for it. That is what makes a hand-edited (or older-release) entry
154
- * self-heal instead of lingering next to a correct copy of itself.
155
- *
156
- * Slot counting is per `matcher` and positional within it: the template
157
- * declares TWO `Bash` entries, so the first two on-disk `Bash` entries are
158
- * theirs and a third is the user's. The template's entries are emitted first,
159
- * in template order, then the preserved ones in their on-disk order — which is
160
- * a fixed point: re-merging the result yields the result (the template's own
161
- * entries are encountered first and refill their own slots).
162
- *
163
- * Non-conforming entries (no string `matcher`, no `hooks` array) are preserved
164
- * rather than dropped: guessing at their shape is how a user's entry gets
165
- * deleted.
166
- *
167
- * ONE exception to "preserve what I do not declare": an entry this template
168
- * used to declare and RETIRED (TEMPLATE_VERSION 1.8.0's `Write|Edit|MultiEdit`
169
- * gate — see `isRetiredTemplateEntry`) is dropped rather than preserved.
170
- * Declaring less cannot retire an entry on its own, because preserving
171
- * undeclared entries is exactly what this function does; without the drop, a
172
- * pre-1.8.0 install would keep the no-op handler and its version-pinned script
173
- * path forever. The predicate is narrow enough that only the exact command
174
- * this template emitted matches.
175
- */
176
- export declare function mergeTemplateOwnedHooks(onDisk: ReadonlyArray<unknown>, template: ReadonlyArray<unknown>): unknown[];
177
- export declare function isRetiredTemplateEntry(entry: unknown): boolean;
139
+ export declare const TEMPLATE_VERSION = "1.10.0";
178
140
  type ClaudeHookCommand = {
179
141
  type: 'command';
180
142
  command: string;
@@ -203,11 +165,41 @@ type ClaudeSettingsLocal = {
203
165
  * forcing gate is a core feature that PreToolUse hooks can short-
204
166
  * circuit but that the `permissions` block cannot.
205
167
  *
206
- * As of TEMPLATE_VERSION 1.8.0 the template emits the two `Bash` matchers
207
- * only. The `Write|Edit|MultiEdit` fact-forcing bypass is no longer a hook:
208
- * it is the `env` exemption above, and that matcher's gate
209
- * (`peaks code-gate --json`) is installed into the committed
210
- * `.claude/settings.json` by `peaks hooks install`.
168
+ * As of TEMPLATE_VERSION 1.10.0 the template emits exactly TWO `Bash` matchers:
169
+ * the two below. (1.9.0 added one entry per layer-B feedback hook on top of
170
+ * them, which made four; 1.10.0 removed and retired those — see
171
+ * `isRetiredTemplateEntry`.) The `Write|Edit|MultiEdit` fact-forcing bypass is
172
+ * no longer a hook: it is the `env` exemption above, and that matcher's gate
173
+ * (`peaks code-gate`) is installed into the committed `.claude/settings.json`
174
+ * by `peaks hooks install`.
211
175
  */
212
176
  export declare function buildClaudeSettingsLocalJson(): ClaudeSettingsLocal;
213
- export {};
177
+ /**
178
+ * TEMPLATE_VERSION 1.9.0 emitted the two layer-B feedback hooks from here; 1.10.0
179
+ * removed and RETIRED them. See `claude-settings-retirements.ts` for the retirement
180
+ * itself and for why declaring less cannot carry one. What is worth keeping here:
181
+ *
182
+ * - WHERE THEY LIVE NOW. `pre-tool-peaks-current-directory-scope.sh` and
183
+ * `pre-tool-piping-a-test-run-reports-the-pipes-exit-code.sh` are this
184
+ * repository's OWN development hooks, so their registration is in this
185
+ * repository's tracked `.claude/settings.json` — where `${CLAUDE_PROJECT_DIR}`
186
+ * really is the root that contains `src/`.
187
+ * - THE SHELL PIN THEY STILL CARRY, and why it is not the `powershell` their CLI
188
+ * siblings take. Measured on this host, both shapes run the script and both
189
+ * print its refusal to stderr — but not the same exit code:
190
+ *
191
+ * bash "<script>" exit 2 (the script's own code)
192
+ * powershell "<script>" exit 1 (flattened by the shell)
193
+ *
194
+ * Under the Claude Code hook protocol only exit 2 blocks; any other non-zero
195
+ * exit is a NON-BLOCKING ERROR and the tool call goes ahead. So `powershell`
196
+ * would turn the refusal into a log line and let the command through — the
197
+ * failure these entries exist to prevent. `shell` accepts `bash` and
198
+ * `powershell` only, and `bash` is also the interpreter the command names.
199
+ * - WHAT THEY REFUSE. `peaks-current-directory-scope` refuses global-state
200
+ * mutations (`npm i -g`, writes under `~/.claude`) unless the user explicitly
201
+ * authorises them; `piping-a-test-run-reports-the-pipes-exit-code` refuses a
202
+ * test run piped into a pager, because the exit code read afterwards is the
203
+ * pager's, not the runner's. `tests/unit/hooks/feedback-promoted-pretool-hooks.test.ts`
204
+ * drives both, with a plant for each.
205
+ */