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,207 @@
1
+ /**
2
+ * Reading and comparing the hook rows a settings file actually holds.
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 { existsSync } from 'node:fs';
9
+ import { readJsonObjectFile } from '../ide/shared/atomic-json.js';
10
+ import { hasExternalGateExemptions } from './hooks-codegate-superpowers.js';
11
+ /** True when `target` already holds everything the install would write to it. */
12
+ export function targetIsSatisfied(target, allSentinels) {
13
+ const settings = readSettingsFile(target.settingsPath);
14
+ if (!shapeMatchesDesired(settings, target.entries, allSentinels))
15
+ return false;
16
+ return target.envExemptions !== true || hasExternalGateExemptions(settings);
17
+ }
18
+ /** Flatten the resolved targets into one `{ matcher, sentinel, settingsPath }` row per entry. */
19
+ export function describeEntryTargets(targets) {
20
+ return targets.flatMap((target) => target.entries.map((entry) => ({
21
+ matcher: entry.matcher,
22
+ sentinel: entry.sentinel,
23
+ settingsPath: target.settingsPath
24
+ })));
25
+ }
26
+ /** Read a settings file as an object, or `{}` when it does not exist yet. */
27
+ export function readSettingsFile(settingsPath) {
28
+ return existsSync(settingsPath) ? readJsonObjectFile(settingsPath) : {};
29
+ }
30
+ /** Read the existing hook array entries for the adapter's hookEvent (tolerant of any prior shape). */
31
+ export function readHookEventEntries(settings, eventKey) {
32
+ const hooks = settings.hooks;
33
+ if (!hooks || typeof hooks !== 'object' || Array.isArray(hooks))
34
+ return [];
35
+ const arr = hooks[eventKey];
36
+ return Array.isArray(arr) ? arr : [];
37
+ }
38
+ /** Read the existing hook array entries from a `settings.hooks` object (already extracted). */
39
+ export function readHookEntriesFromHooks(hooks, eventKey) {
40
+ const arr = hooks[eventKey];
41
+ return Array.isArray(arr) ? arr : [];
42
+ }
43
+ /** True when every command handler in the entry matches a known peaks sentinel for the given IDE. */
44
+ export function entryIsPeaksManaged(entry, sentinels) {
45
+ const handlers = Array.isArray(entry?.hooks) ? entry.hooks : [];
46
+ if (handlers.length === 0)
47
+ return false;
48
+ return handlers.every((h) => {
49
+ if (typeof h?.command !== 'string')
50
+ return false;
51
+ const cmd = h.command;
52
+ return sentinels.some((sentinel) => cmd.includes(sentinel));
53
+ });
54
+ }
55
+ export function isInstalledForEntries(settings, entries) {
56
+ const sentinels = entries.map((e) => e.sentinel);
57
+ // Check every distinct event key our entries could be on.
58
+ const eventKeys = new Set(entries.map((e) => e.event));
59
+ for (const eventKey of eventKeys) {
60
+ if (readHookEventEntries(settings, eventKey).some((e) => entryIsPeaksManaged(e, sentinels))) {
61
+ return true;
62
+ }
63
+ }
64
+ return false;
65
+ }
66
+ /**
67
+ * Slice #014: detect the "stale progress entry after pre-#014 install"
68
+ * case. The desired shape is gate-enforce-only. If the file currently
69
+ * has a peaks-managed progress-start entry (left behind by a pre-#014
70
+ * install), the install is NOT a no-op — it must strip the stale
71
+ * entry. This helper returns true exactly when the desired shape is
72
+ * fully reflected on disk: gate-enforce present AND no legacy
73
+ * progress-start present.
74
+ */
75
+ export function shapeMatchesDesired(settings, entries, allPeaksSentinels) {
76
+ const eventKeys = new Set(entries.map((e) => e.event));
77
+ for (const eventKey of eventKeys) {
78
+ // Only the entries that belong to THIS event key can be expected on it —
79
+ // the desired set must be per-event, or a target whose entries span two
80
+ // event keys (claude-code: SessionStart + PreToolUse) would never look
81
+ // installed and every `peaks hooks install` would rewrite the files.
82
+ const desiredSentinels = new Set(entries.filter((e) => e.event === eventKey).map((e) => e.sentinel));
83
+ const present = readHookEventEntries(settings, eventKey);
84
+ const peaksPresent = present.filter((e) => entryIsPeaksManaged(e, allPeaksSentinels));
85
+ // (a) every peaks-managed entry currently on disk must match the
86
+ // desired sentinel set (no stale entries the caller wants removed).
87
+ for (const entry of peaksPresent) {
88
+ const entrySentinels = (entry.hooks ?? [])
89
+ .map((h) => allPeaksSentinels.find((s) => String(h.command ?? '').includes(s)))
90
+ .filter((s) => Boolean(s));
91
+ if (entrySentinels.some((s) => !desiredSentinels.has(s))) {
92
+ return false;
93
+ }
94
+ }
95
+ // (b) every desired entry must be on disk AND carry the matcher it declares.
96
+ // Presence alone cannot see a WRONG matcher, and a wrong matcher is not
97
+ // cosmetic: `''` and `Bash|Task` route the same command to different
98
+ // tool sets, so the entry is present while the hook never fires on the
99
+ // residual R2): a `PostCompact` entry hand-corrupted to matcher
100
+ // `auto|manual` survived `peaks hooks install` unchanged, and the
101
+ // installer was structurally unable to repair it.
102
+ // An absent matcher reads as `''` — the form Claude Code takes as "every
103
+ // source" — so a file written before matchers were explicit converges
104
+ // once instead of churning on every install.
105
+ for (const desired of entries.filter((e) => e.event === eventKey)) {
106
+ // The identity of a desired entry is the PAIR (sentinel, matcher), not the
107
+ // sentinel alone: one command may legitimately be installed under several
108
+ // matchers (the read-only MCP surface rides `peaks gate enforce` under its
109
+ // own matcher set). Matching on the sentinel first found that first entry
110
+ // every time, so the second one never looked installed and every install
111
+ // rewrote the file. A wrong matcher is still un-repaired — it fails to
112
+ // match and the caller rewrites.
113
+ const onDisk = peaksPresent.find((entry) => (entry.matcher ?? '') === desired.matcher &&
114
+ (entry.hooks ?? []).some((h) => String(h.command ?? '').includes(desired.sentinel)));
115
+ if (onDisk === undefined)
116
+ return false;
117
+ }
118
+ }
119
+ return true;
120
+ }
121
+ /**
122
+ * Merge a target's peaks-managed hook entries into `settings`, preserving
123
+ * all other keys and hooks. Entries routed to a DIFFERENT settings file are
124
+ * not part of `entries`, so the legacy-sentinel filter below strips them
125
+ * from this file (that is what migrates a gate-enforce entry that an older
126
+ * peaks release wrote into the shared file).
127
+ */
128
+ export function withHooksInstalled(settings, entries, allSentinels) {
129
+ const existingHooks = settings.hooks && typeof settings.hooks === 'object' && !Array.isArray(settings.hooks)
130
+ ? settings.hooks
131
+ : {};
132
+ // Our entries may sit on more than one event key. Group by event so each
133
+ // event array is independently merged.
134
+ const ourByEvent = new Map();
135
+ for (const spec of entries) {
136
+ const list = ourByEvent.get(spec.event) ?? [];
137
+ list.push(spec);
138
+ ourByEvent.set(spec.event, list);
139
+ }
140
+ // Slice #014: the legacy sentinel set includes the progress-start
141
+ // sentinel so a pre-#014 install's stale progress-start entry is
142
+ // stripped by the filter (the file converges on the new
143
+ // gate-enforce-only shape, idempotently). The desired set (passed
144
+ // in below) only contains the gate-enforce sentinel.
145
+ const nextHooks = { ...existingHooks };
146
+ // An event key this file used to carry but whose entries all moved to the
147
+ // other file still needs its stale peaks entries stripped.
148
+ const eventKeys = new Set([...ourByEvent.keys(), ...Object.keys(existingHooks)]);
149
+ for (const eventKey of eventKeys) {
150
+ const existing = readHookEntriesFromHooks(nextHooks, eventKey);
151
+ const nonPeaks = existing.filter((entry) => !entryIsPeaksManaged(entry, allSentinels));
152
+ const ourFormatted = (ourByEvent.get(eventKey) ?? []).map((spec) => ({
153
+ matcher: spec.matcher,
154
+ hooks: [
155
+ {
156
+ type: 'command',
157
+ command: spec.command,
158
+ ...(spec.shell !== undefined ? { shell: spec.shell } : {})
159
+ }
160
+ ]
161
+ }));
162
+ const merged = [...nonPeaks, ...ourFormatted];
163
+ if (merged.length > 0) {
164
+ nextHooks[eventKey] = merged;
165
+ }
166
+ else {
167
+ delete nextHooks[eventKey];
168
+ }
169
+ }
170
+ return {
171
+ ...settings,
172
+ hooks: nextHooks
173
+ };
174
+ }
175
+ /**
176
+ * Strip every peaks-managed hook row from one target's settings file, on every
177
+ * event key the file carries — a pre-#014 install could have left the legacy
178
+ * progress-start entry on a different event than the gate-enforce one. Returns
179
+ * the rewritten settings plus whether anything was actually removed.
180
+ */
181
+ export function stripPeaksEntries(target, sentinels) {
182
+ const settings = readJsonObjectFile(target.settingsPath);
183
+ const existingHooks = settings.hooks ?? {};
184
+ const eventKeys = new Set([...target.entries.map((e) => e.event), ...Object.keys(existingHooks)]);
185
+ const nextHooks = { ...existingHooks };
186
+ let removed = false;
187
+ for (const eventKey of eventKeys) {
188
+ const entries = readHookEntriesFromHooks(nextHooks, eventKey);
189
+ const kept = entries.filter((entry) => !entryIsPeaksManaged(entry, sentinels));
190
+ if (kept.length !== entries.length)
191
+ removed = true;
192
+ if (kept.length > 0) {
193
+ nextHooks[eventKey] = kept;
194
+ }
195
+ else {
196
+ delete nextHooks[eventKey];
197
+ }
198
+ }
199
+ const nextSettings = { ...settings };
200
+ if (Object.keys(nextHooks).length > 0) {
201
+ nextSettings.hooks = nextHooks;
202
+ }
203
+ else {
204
+ delete nextSettings.hooks;
205
+ }
206
+ return { settings: nextSettings, removed };
207
+ }
@@ -0,0 +1,34 @@
1
+ import { type HookScope } from '../ide/shared/safe-path.js';
2
+ import type { IdeId } from '../ide/ide-types.js';
3
+ /** Resolve settings root dir for a scope. */
4
+ export declare function resolveSettingsRoot(scope: HookScope, projectRoot: string | undefined): string;
5
+ export declare function assertSafeSettingsPathCompat(scope: HookScope, ide: IdeId, root: string, settingsPath: string): void;
6
+ /**
7
+ * Resolve the machine-local settings file an IDE may carry (e.g. Claude
8
+ * Code's `.claude/settings.local.json`), or `undefined` when there is none.
9
+ *
10
+ * B3(b) 2026-09-13: the machine-local layer is an adapter-DECLARED capability,
11
+ * not a name list. It used to be two hardcoded facts here — a `Set(['claude-code'])`
12
+ * membership test and the filename literal `'settings.local.json'` — i.e. a
13
+ * module that routes per-IDE was itself naming one IDE and one IDE's file.
14
+ * Both now read off the adapter that owns them
15
+ * (`IdeSettingsLocation.localSettingsFileName`), exactly as
16
+ * `auto-compact-dispatcher.ts` already did for the same field.
17
+ *
18
+ * Behaviour is UNCHANGED, and that was verified rather than assumed: over all
19
+ * nine registered `IdeId`s, `IDES_WITH_LOCAL_SETTINGS.has(id)` was `true` for
20
+ * exactly the ids whose adapter declares `localSettingsFileName` (claude-code
21
+ * alone, `'settings.local.json'`). So the set was an exact duplicate of a
22
+ * declaration the adapters already carried, not an independent policy — and
23
+ * a new adapter that declares the field now gets this path for free instead
24
+ * of being silently denied it.
25
+ *
26
+ * This ALSO removes a live instance of the vendor guard's limit 1 (indirect
27
+ * identity: `SET.has(ide)`), which no AST check over comparisons or literals
28
+ * can see. The guard's header named this exact line as the example.
29
+ *
30
+ * Global scope resolves to `undefined`: the global settings file
31
+ * (`~/.claude/settings.json`) is already machine-local, so nothing needs
32
+ * relocating there.
33
+ */
34
+ export declare function resolveLocalSettingsPath(scope: HookScope, ide: IdeId, projectRoot: string | undefined): string | undefined;
@@ -0,0 +1,75 @@
1
+ /**
2
+ * The safety checks on an IDE settings path, and the machine-local sibling.
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 { homedir } from 'node:os';
9
+ import { join, resolve } from 'node:path';
10
+ import { assertSafeSettingsFile } from '../ide/shared/safe-path.js';
11
+ import { getAdapter } from '../ide/ide-registry.js';
12
+ /** Resolve settings root dir for a scope. */
13
+ export function resolveSettingsRoot(scope, projectRoot) {
14
+ if (scope === 'global')
15
+ return resolve(homedir());
16
+ if (!projectRoot) {
17
+ throw new Error('Project scope requires a project root');
18
+ }
19
+ return resolve(projectRoot);
20
+ }
21
+ export function assertSafeSettingsPathCompat(scope, ide, root, settingsPath) {
22
+ const adapter = getAdapter(ide);
23
+ assertSafeSettingsFile(scope, root, adapter.settings.dirName, adapter.settings.settingsFileName);
24
+ // The compat path receives the already-computed settingsPath; double-check
25
+ // that the computed path matches what assertSafeSettingsFile would have
26
+ // produced. This guards against drift between the two resolvers.
27
+ const expected = adapter.settings.resolveSettingsFile(scope, scope === 'global' ? homedir() : root);
28
+ if (expected !== settingsPath) {
29
+ throw new Error(`settings path drift: ${expected} vs ${settingsPath}`);
30
+ }
31
+ }
32
+ /**
33
+ * Resolve the machine-local settings file an IDE may carry (e.g. Claude
34
+ * Code's `.claude/settings.local.json`), or `undefined` when there is none.
35
+ *
36
+ * B3(b) 2026-09-13: the machine-local layer is an adapter-DECLARED capability,
37
+ * not a name list. It used to be two hardcoded facts here — a `Set(['claude-code'])`
38
+ * membership test and the filename literal `'settings.local.json'` — i.e. a
39
+ * module that routes per-IDE was itself naming one IDE and one IDE's file.
40
+ * Both now read off the adapter that owns them
41
+ * (`IdeSettingsLocation.localSettingsFileName`), exactly as
42
+ * `auto-compact-dispatcher.ts` already did for the same field.
43
+ *
44
+ * Behaviour is UNCHANGED, and that was verified rather than assumed: over all
45
+ * nine registered `IdeId`s, `IDES_WITH_LOCAL_SETTINGS.has(id)` was `true` for
46
+ * exactly the ids whose adapter declares `localSettingsFileName` (claude-code
47
+ * alone, `'settings.local.json'`). So the set was an exact duplicate of a
48
+ * declaration the adapters already carried, not an independent policy — and
49
+ * a new adapter that declares the field now gets this path for free instead
50
+ * of being silently denied it.
51
+ *
52
+ * This ALSO removes a live instance of the vendor guard's limit 1 (indirect
53
+ * identity: `SET.has(ide)`), which no AST check over comparisons or literals
54
+ * can see. The guard's header named this exact line as the example.
55
+ *
56
+ * Global scope resolves to `undefined`: the global settings file
57
+ * (`~/.claude/settings.json`) is already machine-local, so nothing needs
58
+ * relocating there.
59
+ */
60
+ export function resolveLocalSettingsPath(scope, ide, projectRoot) {
61
+ if (scope === 'global')
62
+ return undefined;
63
+ const adapter = getAdapter(ide);
64
+ const localFileName = adapter.settings.localSettingsFileName;
65
+ // `undefined` = this IDE has no machine-local layer. Note the order: a
66
+ // caller reaching here with an id the registry does not know still throws
67
+ // from `getAdapter` above, exactly as it did before — every path into this
68
+ // function already called `getAdapter(ide)` via `resolveSettingsPath`, so
69
+ // no new throw path is introduced.
70
+ if (localFileName === undefined)
71
+ return undefined;
72
+ const root = resolveSettingsRoot(scope, projectRoot);
73
+ assertSafeSettingsFile(scope, root, adapter.settings.dirName, localFileName);
74
+ return join(root, adapter.settings.dirName, localFileName);
75
+ }
@@ -0,0 +1,39 @@
1
+ /**
2
+ * What `peaks hooks status` reports: the peaks-managed rows actually on disk.
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
+ /**
10
+ * Slice #014: read the *actually-installed* peaks-managed hook entries
11
+ * from a settings object. Replaces the pre-#014 `listInstalledEntriesForIde`
12
+ * helper in `hooks-commands.ts`, which returned the IDE-EXPECTED list
13
+ * (a hardcoded 2-entry array per adapter) rather than what was on disk.
14
+ * That bug surfaced when slice #013's local cleanup installed
15
+ * `peaks hooks install --no-progress` (gate-enforce only), but the
16
+ * status command still reported `entries: [Bash, Task]` because the
17
+ * helper didn't read the file.
18
+ *
19
+ * The new helper:
20
+ * 1. reads each `hooks.<event>` array,
21
+ * 2. filters to entries that are peaks-managed for the given IDE
22
+ * (matches the legacy sentinel set: gate-enforce + the no-longer-
23
+ * installed progress-start),
24
+ * 3. returns one `{ matcher, sentinel }` row per entry, taking the
25
+ * FIRST matching sentinel per entry (entries have a single command
26
+ * handler in practice, but the loop tolerates multi-handler
27
+ * entries by taking the first match).
28
+ *
29
+ * Pre-#014 settings.json files that have a stale progress-start entry
30
+ * will see it surface in the result. This is intentional: the status
31
+ * command is the user's tool for "what is on disk right now", and
32
+ * surfacing a stale entry is the only way the user can know to run
33
+ * `peaks hooks install` (which now strips it) or `peaks hooks
34
+ * uninstall` (which removes it).
35
+ */
36
+ export declare function readInstalledEntriesFromSettings(settings: Record<string, unknown>, ide: IdeId): ReadonlyArray<{
37
+ matcher: string;
38
+ sentinel: string;
39
+ }>;
@@ -0,0 +1,60 @@
1
+ import { resolveLegacySentinels } from './hooks-codegate-superpowers.js';
2
+ import { entryIsPeaksManaged, readHookEntriesFromHooks } from './hooks-settings-file-shape.js';
3
+ /**
4
+ * Slice #014: read the *actually-installed* peaks-managed hook entries
5
+ * from a settings object. Replaces the pre-#014 `listInstalledEntriesForIde`
6
+ * helper in `hooks-commands.ts`, which returned the IDE-EXPECTED list
7
+ * (a hardcoded 2-entry array per adapter) rather than what was on disk.
8
+ * That bug surfaced when slice #013's local cleanup installed
9
+ * `peaks hooks install --no-progress` (gate-enforce only), but the
10
+ * status command still reported `entries: [Bash, Task]` because the
11
+ * helper didn't read the file.
12
+ *
13
+ * The new helper:
14
+ * 1. reads each `hooks.<event>` array,
15
+ * 2. filters to entries that are peaks-managed for the given IDE
16
+ * (matches the legacy sentinel set: gate-enforce + the no-longer-
17
+ * installed progress-start),
18
+ * 3. returns one `{ matcher, sentinel }` row per entry, taking the
19
+ * FIRST matching sentinel per entry (entries have a single command
20
+ * handler in practice, but the loop tolerates multi-handler
21
+ * entries by taking the first match).
22
+ *
23
+ * Pre-#014 settings.json files that have a stale progress-start entry
24
+ * will see it surface in the result. This is intentional: the status
25
+ * command is the user's tool for "what is on disk right now", and
26
+ * surfacing a stale entry is the only way the user can know to run
27
+ * `peaks hooks install` (which now strips it) or `peaks hooks
28
+ * uninstall` (which removes it).
29
+ */
30
+ export function readInstalledEntriesFromSettings(settings, ide) {
31
+ const sentinels = resolveLegacySentinels(ide);
32
+ // Walk every event key the settings file has, not just the
33
+ // adapter-declared one. A pre-#014 install could have left a
34
+ // progress-start entry on a different event than the gate-enforce
35
+ // entry (Trae: both on beforeToolCall, but a stale install on a
36
+ // future IDE could split them).
37
+ const hooksRoot = settings.hooks;
38
+ if (!hooksRoot || typeof hooksRoot !== 'object' || Array.isArray(hooksRoot))
39
+ return [];
40
+ const result = [];
41
+ for (const eventKey of Object.keys(hooksRoot)) {
42
+ const entries = readHookEntriesFromHooks(hooksRoot, eventKey);
43
+ for (const entry of entries) {
44
+ if (!entryIsPeaksManaged(entry, sentinels))
45
+ continue;
46
+ const matcher = typeof entry.matcher === 'string' ? entry.matcher : '';
47
+ // Find the first matching sentinel inside the entry's command
48
+ // handlers. For each handler, find the first sentinel substring
49
+ // it contains. We pick the first handler's first matching
50
+ // sentinel (entries have a single command in practice).
51
+ const firstHandler = Array.isArray(entry.hooks) ? entry.hooks[0] : undefined;
52
+ const cmd = typeof firstHandler?.command === 'string' ? firstHandler.command : '';
53
+ const sentinel = sentinels.find((s) => cmd.includes(s));
54
+ if (matcher === '' || sentinel === undefined)
55
+ continue;
56
+ result.push({ matcher, sentinel });
57
+ }
58
+ }
59
+ return result;
60
+ }
@@ -1,228 +1,28 @@
1
- import type { IdeId } from '../ide/ide-types.js';
2
1
  import type { HookScope } from '../ide/shared/safe-path.js';
3
2
  import { type PeaksHookEntry } from './hooks-codegate-superpowers.js';
4
- export { HOOK_ENFORCE_SENTINEL, HOOK_CODE_GATE_SENTINEL, HOOK_CODE_GATE_MATCHER, HOOK_CODE_GATE_EVENT, HOOK_CODE_GATE_COMMAND, SUPERPOWERS_DENIED_SKILLS, type PeaksHookEntry } from './hooks-codegate-superpowers.js';
3
+ export { HOOK_ENFORCE_SENTINEL, HOOK_CODE_GATE_SENTINEL, HOOK_CODE_GATE_MATCHER, HOOK_CODE_GATE_EVENT, SUPERPOWERS_DENIED_SKILLS, type PeaksHookEntry } from './hooks-codegate-superpowers.js';
5
4
  /**
6
5
  * Install (and remove) the Peaks-managed hooks in an IDE's settings.json.
7
6
  *
8
- * The hook runs `peaks gate enforce` (Claude) or `peaks hook handle` (Trae /
9
- * other future adapters) before every relevant tool call; when a SOP guard's
10
- * gates fail it returns the adapter-specific deny shape, which blocks the
11
- * tool call BEFORE the IDE's permission checks — making the gate
12
- * un-bypassable by the agent.
7
+ * The hook runs `peaks gate enforce` before every relevant tool call; when a SOP
8
+ * guard's gates fail it returns the adapter-specific deny shape, which blocks the
9
+ * tool call BEFORE the IDE's permission checks — making the gate un-bypassable.
13
10
  *
14
- * Slice #1 refactor: this service delegates to the `IdeAdapter` for
15
- * `claude-code`. Slice #2 added Trae. Adapter provides `dirName` /
16
- * `settingsFileName` / `envVar` / `hookEvent` / `toolMatcher`. The Claude
17
- *
18
- * Slice #3 refactor (this commit): the service is now per-IDE aware via an
19
- * optional `options.ide` parameter. The CLI command is responsible for
20
- * resolving the IDE (env → stdin shape → cwd → fallback to 'claude-code')
21
- * via `detectIdeFromContext` and passing the result here. When `ide` is
22
- * omitted, the service defaults to `'claude-code'` so existing tests and
23
- * downstream callers continue to work without modification.
24
- *
25
- * Installation is an EXPLICIT user command (never postinstall): skills describe,
26
- * the CLI performs side effects. Writes preserve all other settings keys and
27
- * any other hooks, reject symlinked targets, and use an atomic rename so a
28
- * partial write can never corrupt the settings file. Our entry is merged into
29
- * (not replacing) the existing `hooks.<event>` array and is identified by a
30
- * sentinel substring in its command, so install is idempotent and uninstall
31
- * removes only our own entry.
11
+ * This file owns the policy and the four operations; the mechanisms live in the
12
+ * `hooks-settings-*` siblings. Installation is an EXPLICIT user command (never
13
+ * postinstall): skills describe, the CLI performs side effects. Writes preserve every
14
+ * other key and hook, reject symlinked targets, and use an atomic rename.
32
15
  */
33
16
  export type { HookScope } from '../ide/shared/safe-path.js';
34
- export type HookInstallOptions = {
35
- /**
36
- * Which IDE's adapter to install for. Defaults to `'claude-code'` for
37
- * backward compatibility. The CLI command should resolve this from
38
- * `detectIdeFromContext({ env, cwd, parsedStdin })` and pass the result.
39
- * Throws if the IDE is not registered in the adapter registry.
40
- */
41
- readonly ide?: IdeId;
42
- /**
43
- * Slice #013 (bugfix — peaks hooks install --no-progress): when `true`,
44
- * skip emitting the progress-start PreToolUse hook entry while still
45
- * installing the gate-enforce entry. The progress-start hook auto-spawns
46
- * a new terminal running `peaks progress watch`; with dispatch +
47
- * heartbeat (slice #009 + #010) that auto-spawn is dead weight. Default
48
- * `false` preserves the pre-slice install shape (both entries). The
49
- * sentinel-based install is idempotent: re-running with `skipProgress:
50
- * true` over a settings.json that previously had the progress entry
51
- * installed will remove that entry. `uninstall` honors the same flag
52
- * so it can find and remove both entries when both are present and
53
- * only the gate-enforce entry when only the gate-enforce is present.
54
- *
55
- * Slice #014 (refactor — full removal of legacy progress-start surface):
56
- * the field is preserved for API stability, but the underlying
57
- * install only ever emits the gate-enforce entry. The progress-start
58
- * entry is no longer installed regardless of this flag's value. The
59
- * legacy `peaks progress start|watch|close` CLI surface is gone
60
- * (replaced by `peaks sub-agent dispatch|heartbeat|share`); the hook
61
- * entry would have been pointing at a `peaks progress start` that no
62
- * longer exists. The sentinel `peaks progress start` constant is still
63
- * exported (some tests + back-compat reads rely on it) but no new
64
- * hook entries use it.
65
- */
66
- readonly skipProgress?: boolean;
67
- };
68
- /** Default (claude-code) hook command — kept as a stable export for tests. */
17
+ export type { HookEntryTarget, HookInstallOptions, HookInstallPlan, HookInstallResult, HookRemoveResult, HookStatus } from './hooks-settings-types.js';
18
+ export { readInstalledEntriesFromSettings } from './hooks-settings-read-installed.js';
19
+ export { TRIGGER_PHRASES, listSuperpowersDenyEntries, withSuperpowersSkillDenylist, withTriggeredDenyList, withoutSuperpowersSkillDenylist, withoutTriggeredDenyList } from './hooks-settings-deny-list.js';
20
+ import type { HookInstallOptions, HookInstallPlan, HookInstallResult, HookRemoveResult, HookStatus } from './hooks-settings-types.js';
21
+ /** Default (claude-code) hook command. */
69
22
  export declare const HOOK_ENFORCE_COMMAND = "peaks gate enforce --project \"${CLAUDE_PROJECT_DIR}\" --json";
70
- /**
71
- * One peaks-managed entry paired with the settings file it is (or will be)
72
- * written to.
73
- *
74
- * `entries` is a flat list of the same matcher/sentinel pairs, which reads as
75
- * "written to `settingsPath`" even when the entry is routed to the other file
76
- * (see `resolveHookTargets`). This carries the routing explicitly so the
77
- * dry-run can name the real target without a real run.
78
- */
79
- export type HookEntryTarget = {
80
- matcher: string;
81
- sentinel: string;
82
- settingsPath: string;
83
- };
84
- export type HookInstallPlan = {
85
- scope: HookScope;
86
- settingsPath: string;
87
- exists: boolean;
88
- alreadyInstalled: boolean;
89
- desiredCommand: string;
90
- sentinel: string;
91
- matcher: string;
92
- /**
93
- * Machine-local, gitignored settings file that the gate-enforce entry is
94
- * written to instead of `settingsPath`. Undefined when the IDE has no such
95
- * file (or the scope is global, where the settings file is already
96
- * machine-local). See `resolveHookTargets`.
97
- */
98
- localSettingsPath?: string;
99
- /** Every entry the install writes, paired with its target file. */
100
- entryTargets: ReadonlyArray<HookEntryTarget>;
101
- };
102
- export type HookInstallResult = HookInstallPlan & {
103
- applied: boolean;
104
- };
105
- export type HookRemoveResult = {
106
- scope: HookScope;
107
- settingsPath: string;
108
- localSettingsPath?: string;
109
- removed: boolean;
110
- };
111
- export type HookStatus = {
112
- scope: HookScope;
113
- settingsPath: string;
114
- exists: boolean;
115
- localSettingsPath?: string;
116
- localExists?: boolean;
117
- installed: boolean;
118
- /**
119
- * Whether this IDE can host a peaks hook AT ALL (`hasHookSpec`).
120
- *
121
- * `status` answers "what is on disk", and for an IDE with no
122
- * `HOOK_COMMAND_BY_IDE` entry the answer is "nothing, and nothing ever will
123
- * be" — which is a successful query returning a negative fact, not a failed
124
- * one. The exit code says the query succeeded; this field says what it found.
125
- * Without it `installed: false` would be indistinguishable from a supported
126
- * IDE that simply has no hook installed yet, which is a state the user can
127
- * act on.
128
- */
129
- supportsHooks: boolean;
130
- };
131
- /**
132
- * Slice #014: read the *actually-installed* peaks-managed hook entries
133
- * from a settings object. Replaces the pre-#014 `listInstalledEntriesForIde`
134
- * helper in `hooks-commands.ts`, which returned the IDE-EXPECTED list
135
- * (a hardcoded 2-entry array per adapter) rather than what was on disk.
136
- * That bug surfaced when slice #013's local cleanup installed
137
- * `peaks hooks install --no-progress` (gate-enforce only), but the
138
- * status command still reported `entries: [Bash, Task]` because the
139
- * helper didn't read the file.
140
- *
141
- * The new helper:
142
- * 1. reads each `hooks.<event>` array,
143
- * 2. filters to entries that are peaks-managed for the given IDE
144
- * (matches the legacy sentinel set: gate-enforce + the no-longer-
145
- * installed progress-start),
146
- * 3. returns one `{ matcher, sentinel }` row per entry, taking the
147
- * FIRST matching sentinel per entry (entries have a single command
148
- * handler in practice, but the loop tolerates multi-handler
149
- * entries by taking the first match).
150
- *
151
- * Pre-#014 settings.json files that have a stale progress-start entry
152
- * will see it surface in the result. This is intentional: the status
153
- * command is the user's tool for "what is on disk right now", and
154
- * surfacing a stale entry is the only way the user can know to run
155
- * `peaks hooks install` (which now strips it) or `peaks hooks
156
- * uninstall` (which removes it).
157
- */
158
- export declare function readInstalledEntriesFromSettings(settings: Record<string, unknown>, ide: IdeId): ReadonlyArray<{
159
- matcher: string;
160
- sentinel: string;
161
- }>;
162
- /**
163
- * Merge the peaks-managed Skill denylist into the existing settings object.
164
- * Preserves every other `permissions.deny` entry the user (or another tool)
165
- * has written so the install is additive, not destructive. The output is
166
- * always deterministic: the same input always yields the same output,
167
- * regardless of insertion order in the source array.
168
- *
169
- * Defensive behavior:
170
- * - `settings.permissions` is missing or non-object → install creates a
171
- * fresh `permissions: { deny: [...our entries] }` object.
172
- * - `settings.permissions.deny` is missing or non-array → install replaces
173
- * the field with a fresh array containing only our entries.
174
- * - Duplicate entries (any source) are collapsed to one via `new Set`.
175
- *
176
- * The function is pure: it does not mutate the input. Atomic write happens
177
- * at the call site (`applyHookInstall`).
178
- */
179
- export declare function withSuperpowersSkillDenylist(settings: Record<string, unknown>): Record<string, unknown>;
180
- /**
181
- * Inverse of `withSuperpowersSkillDenylist`. Removes every peaks-managed
182
- * `UseSkill(...)` entry from the deny list. If the resulting deny list is
183
- * empty, the `deny` field itself is deleted; if the `permissions` object
184
- * becomes empty, the `permissions` field itself is deleted. This is the
185
- * uninstall path: every field we wrote must be removed exactly, and no
186
- * other field may be touched.
187
- *
188
- * Pure (no mutation).
189
- */
190
- export declare function withoutSuperpowersSkillDenylist(settings: Record<string, unknown>): Record<string, unknown>;
191
- /**
192
- * Read-only introspection. Returns the deny entries that `peaks hooks
193
- * install` would write today. Useful for `peaks hooks status` and the
194
- * dry-run envelope.
195
- */
196
- export declare function listSuperpowersDenyEntries(): ReadonlyArray<string>;
197
23
  /** Default (claude-code) peaks-managed hook entries — kept as a stable export for tests. Slice #014: only the gate-enforce entry. */
198
24
  export declare const PEAKS_HOOK_ENTRIES: ReadonlyArray<PeaksHookEntry>;
199
25
  export declare function planHookInstall(scope: HookScope, projectRoot?: string, options?: HookInstallOptions): HookInstallPlan;
200
26
  export declare function applyHookInstall(scope: HookScope, projectRoot?: string, options?: HookInstallOptions): HookInstallResult;
201
27
  export declare function removeHookInstall(scope: HookScope, projectRoot?: string, options?: HookInstallOptions): HookRemoveResult;
202
28
  export declare function readHookStatus(scope: HookScope, projectRoot?: string, options?: HookInstallOptions): HookStatus;
203
- /**
204
- *
205
- * In addition to the static SUPERPOWERS_DENIED_SKILLS list, peaks
206
- * scans the existing settings file for "trigger phrases" that
207
- * indicate the user has configured the superpowers chain (or
208
- * any other auto-run worktree-creating tool) and appends a
209
- * defensive deny to prevent the chain from running raw
210
- * `git worktree add` (or `podman run`) directly.
211
- *
212
- * Triggers detected (substring match on the existing
213
- * permissions.deny / permissions.allow list):
214
- *
215
- * - `superpowers:using-git-worktrees` — the chain's ground zero
216
- * - `superpowers:brainstorming` etc. — the upstream skill
217
- * - `Bash(git worktree add` — the user has explicitly
218
- * allowed raw git worktree, which our L2 lease-aware gate
219
- * would also intercept (defense in depth)
220
- *
221
- * Append-only — never replaces, never re-orders, never removes
222
- * existing entries. Idempotent: re-running the install with
223
- * the same input yields the same output.
224
- */
225
- export declare const TRIGGER_PHRASES: ReadonlyArray<string>;
226
- export declare function withTriggeredDenyList(settings: Record<string, unknown>): Record<string, unknown>;
227
- /** Inverse of withTriggeredDenyList: strip every deny-trigger entry. */
228
- export declare function withoutTriggeredDenyList(settings: Record<string, unknown>): Record<string, unknown>;