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,155 @@
1
+ /**
2
+ * The check that reads a declaration back and refuses when the tree moved.
3
+ *
4
+ * It hashes the bytes of every declared path. A commit does not change bytes,
5
+ * so the check is commitment-invariant by construction rather than by way of a
6
+ * git ref. A rename or a delete removes the path, and a rewrite changes its
7
+ * hash; each is refused by name. A path that appears under a declared root and
8
+ * was not declared is refused too, which is the one arm that needs a tree
9
+ * listing rather than a hash.
10
+ *
11
+ * The listing is `git ls-files -c -o --exclude-standard`, which is invariant
12
+ * under a commit: a commit redistributes tracked and untracked entries, it does
13
+ * not change the set of files on disk.
14
+ *
15
+ * Absence rule, stated where the producer reads it: an artifact that is present
16
+ * but carries no declaration is refused. There is no back-compat window,
17
+ * because this check is reached only from a transition that a slice in flight
18
+ * can re-run.
19
+ */
20
+ import { existsSync, readFileSync } from 'node:fs';
21
+ import { execFileSync } from 'node:child_process';
22
+ import { join } from 'node:path';
23
+ import { parseJudgedDeclaration, sha256OfFile } from './judged-declaration.js';
24
+ /** Where the security audit artifact may live, newest tier first. */
25
+ export function securityArtifactTiers(rid) {
26
+ return [
27
+ `audit/security-${rid}.md`,
28
+ 'audit/security.md',
29
+ `rd/security-review-${rid}.md`,
30
+ 'rd/security-review.md'
31
+ ];
32
+ }
33
+ export function resolveSecurityArtifact(projectRoot, sessionId, rid) {
34
+ const root = join(projectRoot, '.peaks', '_runtime', sessionId);
35
+ for (const relative of securityArtifactTiers(rid)) {
36
+ const absolute = join(root, ...relative.split('/'));
37
+ if (existsSync(absolute))
38
+ return { relative, absolute };
39
+ }
40
+ return null;
41
+ }
42
+ /**
43
+ * List the files git knows about under a prefix. Fail-closed: a git read that
44
+ * did not happen is reported, never returned as an empty list.
45
+ */
46
+ export function listTreeFiles(projectRoot, prefix) {
47
+ try {
48
+ const raw = execFileSync('git', ['-C', projectRoot, 'ls-files', '-c', '-o', '--exclude-standard', '--', prefix], { encoding: 'utf8', windowsHide: true });
49
+ const files = raw
50
+ .split(/\r?\n/)
51
+ .map((line) => line.trim())
52
+ .filter((line) => line.length > 0);
53
+ return { ok: true, files };
54
+ }
55
+ catch (error) {
56
+ return { ok: false, detail: error instanceof Error ? error.message : String(error) };
57
+ }
58
+ }
59
+ function readArtifact(absolute) {
60
+ try {
61
+ return { ok: true, body: readFileSync(absolute, 'utf8') };
62
+ }
63
+ catch (error) {
64
+ return { ok: false, detail: error instanceof Error ? error.message : String(error) };
65
+ }
66
+ }
67
+ function fileRefusals(input) {
68
+ const refusals = [];
69
+ for (const file of input.files) {
70
+ const hashed = sha256OfFile(join(input.projectRoot, ...file.path.split('/')));
71
+ if (!hashed.ok) {
72
+ refusals.push({
73
+ code: hashed.code === 'missing' ? 'declared-path-gone' : 'declared-path-unreadable',
74
+ artifact: input.artifact,
75
+ path: file.path
76
+ });
77
+ }
78
+ else if (hashed.sha256 !== file.sha256) {
79
+ refusals.push({ code: 'declared-path-modified', artifact: input.artifact, path: file.path });
80
+ }
81
+ }
82
+ return refusals;
83
+ }
84
+ function rootRefusals(input) {
85
+ const refusals = [];
86
+ for (const root of input.roots) {
87
+ const listed = listTreeFiles(input.projectRoot, root.path);
88
+ if (!listed.ok) {
89
+ refusals.push({ code: 'root-listing-failed', artifact: input.artifact, path: root.path });
90
+ continue;
91
+ }
92
+ for (const found of listed.files) {
93
+ if (input.declared.has(found))
94
+ continue;
95
+ if (found !== root.path && !found.startsWith(`${root.path}/`))
96
+ continue;
97
+ refusals.push({ code: 'undeclared-path-under-root', artifact: input.artifact, path: found });
98
+ }
99
+ }
100
+ return refusals;
101
+ }
102
+ /** Compare the declaration against the tree. Returns refusals, ordered by path. */
103
+ export function checkDeclarationAgainstTree(input) {
104
+ const refusals = [
105
+ ...fileRefusals({ ...input, files: input.declaration.files }),
106
+ ...rootRefusals({
107
+ ...input,
108
+ roots: input.declaration.roots,
109
+ declared: new Set(input.declaration.files.map((f) => f.path))
110
+ })
111
+ ];
112
+ return refusals.sort((a, b) => (a.path < b.path ? -1 : 1));
113
+ }
114
+ /**
115
+ * Entry point for the transition gate. An artifact that is not there is not
116
+ * this check's business — the artifact-existence prerequisite owns that.
117
+ *
118
+ * LIMIT, measured rather than assumed — the hole that survives is COMPLETENESS,
119
+ * not tampering: the declaration is the producer's own statement, so ten files
120
+ * touched and one declared passes. Nothing here can know what the producer did
121
+ * not say. Rule: a declaration is a claim about the paths it names, never a
122
+ * claim that those are all the paths.
123
+ *
124
+ * Absence rule, stated where the producer reads it, and the reason it is this
125
+ * blunt: a security artifact that IS there must carry a declaration. No section
126
+ * of the artifact turns the check off, because a requirement that any section
127
+ * can switch off is not a requirement — an earlier draft of this file keyed the
128
+ * requirement on a marker line in the coverage block, and deleting that block
129
+ * (while keeping the declaration, and then rewriting a declared path) passed.
130
+ * The cost is stated rather than hidden: an artifact written before this change
131
+ * is refused until the audit is re-run, and the gate only fires on a
132
+ * transition, so nothing already committed is affected.
133
+ */
134
+ export function verifyJudgedDeclaration(input) {
135
+ const resolved = resolveSecurityArtifact(input.projectRoot, input.sessionId, input.requestId);
136
+ if (resolved === null)
137
+ return { refusals: [], checked: 0 };
138
+ const artifact = resolved.relative;
139
+ const read = readArtifact(resolved.absolute);
140
+ if (!read.ok) {
141
+ return { refusals: [{ code: 'artifact-unreadable', artifact, path: artifact }], checked: 0 };
142
+ }
143
+ const parsed = parseJudgedDeclaration(read.body);
144
+ if (!parsed.ok) {
145
+ // The refusal no section can switch off: the declaration is missing, or it
146
+ // does not parse to the grammar.
147
+ return { refusals: [{ code: parsed.code, artifact, path: artifact }], checked: 0 };
148
+ }
149
+ const refusals = checkDeclarationAgainstTree({
150
+ projectRoot: input.projectRoot,
151
+ artifact,
152
+ declaration: parsed.declaration
153
+ });
154
+ return { refusals, checked: parsed.declaration.files.length };
155
+ }
@@ -0,0 +1,94 @@
1
+ /**
2
+ * The machine-readable declaration of what an audit judged.
3
+ *
4
+ * `## Red-line scope` in the RD request is prose for a human and is read by no
5
+ * machine here. The declaration is the only machine-read statement of a
6
+ * slice's surface, and the producer that emits the artifact writes it, so a
7
+ * caller cannot produce the artifact without one.
8
+ *
9
+ * Grammar — exactly one fenced json block under the heading `## Judged content`:
10
+ *
11
+ * ## Judged content
12
+ *
13
+ * ```json
14
+ * {"schemaVersion":1,"judgedAt":"2026-10-13T00:00:00.000Z","handoffHash":"unknown",
15
+ * "files":[{"path":"src/a.ts","sha256":"<64 hex>"}],
16
+ * "roots":[{"path":"src/dir","why":"<text>"}]}
17
+ * ```
18
+ *
19
+ * Rules. No backslash anywhere in the block: JSON resolves an escaped spelling
20
+ * to the same string, so a raw reader and a parsing reader could disagree about
21
+ * what was declared. A `path` is a relative POSIX path with no `..` and no
22
+ * leading slash; `files` is non-empty; a duplicate path is refused. A root
23
+ * entry must carry a non-empty `why` — a bare directory root is refused.
24
+ *
25
+ * LIMIT, recorded rather than fixed: any rule keyed on a self-reported field is
26
+ * closed against accidental shedding, and not against a producer that rewrites
27
+ * its own field.
28
+ */
29
+ export declare const JUDGED_HEADING = "## Judged content";
30
+ export declare const JUDGED_SCHEMA_VERSION = 1;
31
+ export type JudgedFile = {
32
+ readonly path: string;
33
+ readonly sha256: string;
34
+ };
35
+ export type JudgedRoot = {
36
+ readonly path: string;
37
+ readonly why: string;
38
+ };
39
+ export type JudgedDeclaration = {
40
+ readonly schemaVersion: number;
41
+ readonly judgedAt: string;
42
+ readonly handoffHash: string;
43
+ readonly files: readonly JudgedFile[];
44
+ readonly roots: readonly JudgedRoot[];
45
+ };
46
+ export type JudgedParseFailure = {
47
+ readonly ok: false;
48
+ readonly code: string;
49
+ readonly detail: string;
50
+ };
51
+ export type JudgedParseResult = {
52
+ readonly ok: true;
53
+ readonly declaration: JudgedDeclaration;
54
+ } | JudgedParseFailure;
55
+ /**
56
+ * The audit service's detect result when the declaration cannot be built. It
57
+ * lives here so the producer can substitute it for the probe's verdict without
58
+ * growing the service's own branch count.
59
+ */
60
+ export declare function declarationMissingDetect(detect: {
61
+ readonly handoffPresent: boolean;
62
+ readonly templatePresent: boolean;
63
+ }, failure: JudgedParseFailure): {
64
+ readonly state: 'declaration-missing';
65
+ readonly handoffPresent: boolean;
66
+ readonly templatePresent: boolean;
67
+ readonly warnings: readonly string[];
68
+ readonly nextActions: readonly string[];
69
+ };
70
+ export type Sha256Result = {
71
+ readonly ok: true;
72
+ readonly sha256: string;
73
+ } | {
74
+ readonly ok: false;
75
+ readonly code: 'missing' | 'unreadable';
76
+ readonly detail: string;
77
+ };
78
+ /** Hash the bytes of one file. A missing file is reported, never guessed. */
79
+ export declare function sha256OfFile(absPath: string): Sha256Result;
80
+ /** A declared path is a relative POSIX path pointing at one file. */
81
+ export declare function validateDeclaredPath(raw: unknown): {
82
+ ok: true;
83
+ path: string;
84
+ } | {
85
+ ok: false;
86
+ detail: string;
87
+ };
88
+ /** Render the declaration as the artifact section the check reads back. */
89
+ export declare function renderJudgedDeclaration(declaration: JudgedDeclaration): string;
90
+ /**
91
+ * Parse the declaration out of an artifact body. Strict on shape: a block that
92
+ * parses to something other than the grammar is a refusal, never a default.
93
+ */
94
+ export declare function parseJudgedDeclaration(body: string): JudgedParseResult;
@@ -0,0 +1,218 @@
1
+ /**
2
+ * The machine-readable declaration of what an audit judged.
3
+ *
4
+ * `## Red-line scope` in the RD request is prose for a human and is read by no
5
+ * machine here. The declaration is the only machine-read statement of a
6
+ * slice's surface, and the producer that emits the artifact writes it, so a
7
+ * caller cannot produce the artifact without one.
8
+ *
9
+ * Grammar — exactly one fenced json block under the heading `## Judged content`:
10
+ *
11
+ * ## Judged content
12
+ *
13
+ * ```json
14
+ * {"schemaVersion":1,"judgedAt":"2026-10-13T00:00:00.000Z","handoffHash":"unknown",
15
+ * "files":[{"path":"src/a.ts","sha256":"<64 hex>"}],
16
+ * "roots":[{"path":"src/dir","why":"<text>"}]}
17
+ * ```
18
+ *
19
+ * Rules. No backslash anywhere in the block: JSON resolves an escaped spelling
20
+ * to the same string, so a raw reader and a parsing reader could disagree about
21
+ * what was declared. A `path` is a relative POSIX path with no `..` and no
22
+ * leading slash; `files` is non-empty; a duplicate path is refused. A root
23
+ * entry must carry a non-empty `why` — a bare directory root is refused.
24
+ *
25
+ * LIMIT, recorded rather than fixed: any rule keyed on a self-reported field is
26
+ * closed against accidental shedding, and not against a producer that rewrites
27
+ * its own field.
28
+ */
29
+ import { createHash } from 'node:crypto';
30
+ import { readFileSync } from 'node:fs';
31
+ export const JUDGED_HEADING = '## Judged content';
32
+ export const JUDGED_SCHEMA_VERSION = 1;
33
+ /**
34
+ * The audit service's detect result when the declaration cannot be built. It
35
+ * lives here so the producer can substitute it for the probe's verdict without
36
+ * growing the service's own branch count.
37
+ */
38
+ export function declarationMissingDetect(detect, failure) {
39
+ return {
40
+ state: 'declaration-missing',
41
+ handoffPresent: detect.handoffPresent,
42
+ templatePresent: detect.templatePresent,
43
+ warnings: [
44
+ `security-audit refused: the judged declaration is not buildable (${failure.code}: ${failure.detail}).`
45
+ ],
46
+ nextActions: [
47
+ 'Pass every judged path with --judged <path> (repeatable); each must exist and be a file.',
48
+ 'A run that declares nothing is refused rather than given an unbounded surface.'
49
+ ]
50
+ };
51
+ }
52
+ /** Hash the bytes of one file. A missing file is reported, never guessed. */
53
+ export function sha256OfFile(absPath) {
54
+ let bytes;
55
+ try {
56
+ bytes = readFileSync(absPath);
57
+ }
58
+ catch (error) {
59
+ const code = error.code === 'ENOENT' ? 'missing' : 'unreadable';
60
+ const detail = error instanceof Error ? error.message : String(error);
61
+ return { ok: false, code, detail };
62
+ }
63
+ return { ok: true, sha256: createHash('sha256').update(bytes).digest('hex') };
64
+ }
65
+ /** A declared path is a relative POSIX path pointing at one file. */
66
+ export function validateDeclaredPath(raw) {
67
+ if (typeof raw !== 'string' || raw.length === 0) {
68
+ return { ok: false, detail: 'path must be a non-empty string' };
69
+ }
70
+ if (raw.includes('\\'))
71
+ return { ok: false, detail: `path must not contain a backslash: ${raw}` };
72
+ if (raw.startsWith('/'))
73
+ return { ok: false, detail: `path must be relative: ${raw}` };
74
+ if (/^[a-zA-Z]:/.test(raw))
75
+ return { ok: false, detail: `path must be relative: ${raw}` };
76
+ if (raw.endsWith('/')) {
77
+ return { ok: false, detail: `path must name a file, not a directory: ${raw}` };
78
+ }
79
+ const segments = raw.split('/');
80
+ if (segments.some((s) => s === '' || s === '.' || s === '..')) {
81
+ return { ok: false, detail: `path must be normalised with no traversal: ${raw}` };
82
+ }
83
+ return { ok: true, path: raw };
84
+ }
85
+ const HEX64 = /^[a-f0-9]{64}$/;
86
+ /** Render the declaration as the artifact section the check reads back. */
87
+ export function renderJudgedDeclaration(declaration) {
88
+ const payload = {
89
+ schemaVersion: declaration.schemaVersion,
90
+ judgedAt: declaration.judgedAt,
91
+ handoffHash: declaration.handoffHash,
92
+ files: declaration.files.map((f) => ({ path: f.path, sha256: f.sha256 })),
93
+ roots: declaration.roots.map((r) => ({ path: r.path, why: r.why }))
94
+ };
95
+ return [JUDGED_HEADING, '', '```json', JSON.stringify(payload), '```', ''].join('\n');
96
+ }
97
+ /**
98
+ * Extract the fenced block under the heading. Returns the raw block text or a
99
+ * code naming why there is none. Deliberately literal: a heading that does not
100
+ * match byte-for-byte is a missing declaration, not a variant to accommodate.
101
+ */
102
+ function extractJudgedBlock(body) {
103
+ const lines = body.split(/\r?\n/);
104
+ const start = lines.findIndex((line) => line.trimEnd() === JUDGED_HEADING);
105
+ if (start === -1)
106
+ return { ok: false, code: 'declaration-missing' };
107
+ const rest = lines.slice(start + 1);
108
+ const fenceStart = rest.findIndex((line) => line.trim() === '```json');
109
+ if (fenceStart === -1)
110
+ return { ok: false, code: 'declaration-unfenced' };
111
+ const block = [];
112
+ for (const line of rest.slice(fenceStart + 1)) {
113
+ if (line.trim() === '```')
114
+ return { ok: true, block: block.join('\n') };
115
+ block.push(line);
116
+ }
117
+ return { ok: false, code: 'declaration-unterminated' };
118
+ }
119
+ function parseFileEntries(raw) {
120
+ if (!Array.isArray(raw) || raw.length === 0) {
121
+ return { ok: false, code: 'declaration-empty', detail: 'files must be a non-empty array' };
122
+ }
123
+ const files = [];
124
+ const seen = new Set();
125
+ for (const entry of raw) {
126
+ if (entry === null || typeof entry !== 'object') {
127
+ return { ok: false, code: 'declaration-schema', detail: 'a files entry is not an object' };
128
+ }
129
+ const row = entry;
130
+ const checked = validateDeclaredPath(row['path']);
131
+ if (!checked.ok)
132
+ return { ok: false, code: 'declaration-path', detail: checked.detail };
133
+ if (typeof row['sha256'] !== 'string' || !HEX64.test(row['sha256'])) {
134
+ return { ok: false, code: 'declaration-hash', detail: checked.path };
135
+ }
136
+ if (seen.has(checked.path)) {
137
+ return { ok: false, code: 'declaration-duplicate', detail: checked.path };
138
+ }
139
+ seen.add(checked.path);
140
+ files.push({ path: checked.path, sha256: row['sha256'] });
141
+ }
142
+ return { ok: true, files };
143
+ }
144
+ function parseRootEntries(raw) {
145
+ if (!Array.isArray(raw)) {
146
+ return { ok: false, code: 'declaration-schema', detail: 'roots must be an array' };
147
+ }
148
+ const roots = [];
149
+ for (const entry of raw) {
150
+ if (entry === null || typeof entry !== 'object') {
151
+ return { ok: false, code: 'declaration-schema', detail: 'a roots entry is not an object' };
152
+ }
153
+ const row = entry;
154
+ const checked = validateDeclaredPath(row['path']);
155
+ if (!checked.ok)
156
+ return { ok: false, code: 'declaration-path', detail: checked.detail };
157
+ const why = row['why'];
158
+ if (typeof why !== 'string' || why.trim().length === 0) {
159
+ return { ok: false, code: 'declaration-bare-root', detail: checked.path };
160
+ }
161
+ roots.push({ path: checked.path, why });
162
+ }
163
+ return { ok: true, roots };
164
+ }
165
+ function parseEnvelopeBlock(block) {
166
+ // A backslash is refused before parsing, not after: JSON resolves escapes, so
167
+ // a parsed value and the raw bytes could describe different surfaces.
168
+ if (block.includes('\\')) {
169
+ return { ok: false, code: 'declaration-escaped', detail: 'the block contains a backslash' };
170
+ }
171
+ let raw;
172
+ try {
173
+ raw = JSON.parse(block);
174
+ }
175
+ catch (error) {
176
+ const detail = error instanceof Error ? error.message : String(error);
177
+ return { ok: false, code: 'declaration-unparsable', detail };
178
+ }
179
+ if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
180
+ return { ok: false, code: 'declaration-unparsable', detail: 'the block is not a JSON object' };
181
+ }
182
+ const obj = raw;
183
+ if (obj['schemaVersion'] !== JUDGED_SCHEMA_VERSION) {
184
+ return { ok: false, code: 'declaration-schema', detail: String(obj['schemaVersion']) };
185
+ }
186
+ if (typeof obj['judgedAt'] !== 'string' || typeof obj['handoffHash'] !== 'string') {
187
+ return { ok: false, code: 'declaration-schema', detail: 'judgedAt / handoffHash' };
188
+ }
189
+ return { ok: true, obj };
190
+ }
191
+ /**
192
+ * Parse the declaration out of an artifact body. Strict on shape: a block that
193
+ * parses to something other than the grammar is a refusal, never a default.
194
+ */
195
+ export function parseJudgedDeclaration(body) {
196
+ const extracted = extractJudgedBlock(body);
197
+ if (!extracted.ok)
198
+ return { ok: false, code: extracted.code, detail: JUDGED_HEADING };
199
+ const envelope = parseEnvelopeBlock(extracted.block);
200
+ if (!envelope.ok)
201
+ return envelope;
202
+ const files = parseFileEntries(envelope.obj['files']);
203
+ if (!files.ok)
204
+ return files;
205
+ const roots = parseRootEntries(envelope.obj['roots'] ?? []);
206
+ if (!roots.ok)
207
+ return roots;
208
+ return {
209
+ ok: true,
210
+ declaration: {
211
+ schemaVersion: JUDGED_SCHEMA_VERSION,
212
+ judgedAt: envelope.obj['judgedAt'],
213
+ handoffHash: envelope.obj['handoffHash'],
214
+ files: files.files,
215
+ roots: roots.roots
216
+ }
217
+ };
218
+ }
@@ -20,11 +20,12 @@
20
20
  * - Schema: `.peaks/project-scan/audit-output-schema.md` (schemaVersion: 1)
21
21
  * - Companion: `src/services/audit-independent/security-audit-service.ts`
22
22
  */
23
- import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
23
+ import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';
24
24
  import { join, resolve, isAbsolute } from 'node:path';
25
25
  import { createHash } from 'node:crypto';
26
26
  import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
27
27
  import { resolveHandoffPath } from '../prd/handoff-service.js';
28
+ import { handoffMissingRefusal } from './handoff-missing-refusal.js';
28
29
  /**
29
30
  * Validate a raw value as a PerfAuditEnvelope. Mirrors the
30
31
  * `isSecurityAuditEnvelope` strict-shape pattern.
@@ -150,22 +151,20 @@ export function detectPerfAudit(input) {
150
151
  const templatePath = join(input.projectRoot, '.peaks', 'project-scan', 'perf-template.md');
151
152
  const templatePresent = existsSync(templatePath);
152
153
  if (!handoffPresent) {
154
+ const refusal = handoffMissingRefusal({
155
+ role: 'perf',
156
+ projectRoot: input.projectRoot,
157
+ sessionId: input.sessionId,
158
+ ...(input.requestId !== undefined ? { requestId: input.requestId } : {}),
159
+ // Measured, not assumed: `detect` supplies no envelope at all.
160
+ envelopeValidated: input.envelope !== undefined && isPerfAuditEnvelope(input.envelope)
161
+ });
153
162
  return {
154
163
  state: 'handoff-missing',
155
164
  handoffPresent: false,
156
165
  templatePresent,
157
- warnings: [
158
- `peaks-prd handoff not found under ${join(input.projectRoot, '.peaks', '_runtime', input.sessionId, 'prd')}`,
159
- ...(input.requestId === undefined
160
- ? [
161
- "No --rid was supplied, so only the pre-rid-scoping `prd/handoff.md` could be probed. Pass --rid to resolve this slice's `prd/handoff-<rid>.md`."
162
- ]
163
- : [])
164
- ],
165
- nextActions: [
166
- 'Run peaks-prd handoff init to produce a sha256-locked handoff before running peaks perf-audit.',
167
- 'Until the handoff exists, peaks-perf-audit cannot start (gate fail).'
168
- ]
166
+ warnings: refusal.warnings,
167
+ nextActions: refusal.nextActions
169
168
  };
170
169
  }
171
170
  if (!templatePresent) {
@@ -303,7 +302,6 @@ export function writePerfAuditArtifact(projectRoot, sessionId, rid, body) {
303
302
  const tmpPath = `${targetPath}.tmp`;
304
303
  writeFileSync(tmpPath, body, 'utf8');
305
304
  // Sync rename: on Windows, fs.renameSync overwrites if target exists (Node 22+)
306
- const { renameSync } = require('node:fs');
307
305
  renameSync(tmpPath, targetPath);
308
306
  return targetPath;
309
307
  }
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Rendering and writing of the security audit artifact. Split out of
3
+ * `security-audit-service.ts`, which was over the per-file cap; the service now
4
+ * depends on this module rather than carrying the markdown itself.
5
+ */
6
+ import type { SecurityAuditEnvelope, SecurityAuditVerdict } from './security-audit-service.js';
7
+ /**
8
+ * Render a SecurityAuditEnvelope to the canonical audit artifact body
9
+ * (markdown). Produce a markdown body with all required sections, ready to
10
+ * write to `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
11
+ */
12
+ export declare function renderSecurityAuditArtifact(env: SecurityAuditEnvelope, opts: {
13
+ rid: string;
14
+ handoffHash: string;
15
+ generatedAt: string;
16
+ }): {
17
+ body: string;
18
+ violationsCount: number;
19
+ verdict: SecurityAuditVerdict;
20
+ };
21
+ /**
22
+ * Write the rendered audit artifact to
23
+ * `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
24
+ *
25
+ * Atomic write (tmp + rename) to avoid partial writes on crash.
26
+ * Returns the absolute path on success.
27
+ */
28
+ export declare function writeSecurityAuditArtifact(projectRoot: string, sessionId: string, rid: string, body: string): string;
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Rendering and writing of the security audit artifact. Split out of
3
+ * `security-audit-service.ts`, which was over the per-file cap; the service now
4
+ * depends on this module rather than carrying the markdown itself.
5
+ */
6
+ import { mkdirSync, renameSync, writeFileSync } from 'node:fs';
7
+ import { join } from 'node:path';
8
+ import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
9
+ /**
10
+ * Render a SecurityAuditEnvelope to the canonical audit artifact body
11
+ * (markdown). Produce a markdown body with all required sections, ready to
12
+ * write to `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
13
+ */
14
+ export function renderSecurityAuditArtifact(env, opts) {
15
+ const counts = {};
16
+ for (const v of env.violations) {
17
+ counts[v.severity] = (counts[v.severity] ?? 0) + 1;
18
+ }
19
+ const criticalCount = counts['CRITICAL'] ?? 0;
20
+ const findingsBullets = env.violations.length === 0
21
+ ? '- (none)'
22
+ : env.violations
23
+ .map((v) => `- [${v.severity}] ${v.dimension} @ ${v.file}:${v.line} — ${v.hint}`)
24
+ .join('\n');
25
+ const requiredFixes = buildRequiredFixes(env);
26
+ const body = [
27
+ '## Summary',
28
+ '',
29
+ env.summary,
30
+ '',
31
+ '## Threat model coverage',
32
+ '',
33
+ `audited at: ${opts.generatedAt}`,
34
+ `verdict: ${env.verdict}`,
35
+ `handoffHash: ${opts.handoffHash}`,
36
+ '',
37
+ '## Findings',
38
+ '',
39
+ findingsBullets,
40
+ '',
41
+ requiredFixes,
42
+ '## Verdict',
43
+ '',
44
+ `verdict: ${env.verdict}`,
45
+ `CRITICAL: ${criticalCount}`,
46
+ ''
47
+ ]
48
+ .filter((s) => s.length > 0)
49
+ .join('\n');
50
+ return {
51
+ body,
52
+ violationsCount: env.violations.length,
53
+ verdict: env.verdict
54
+ };
55
+ }
56
+ function buildRequiredFixes(env) {
57
+ const requiredFixes = env.violations.length === 0
58
+ ? ''
59
+ : [
60
+ '## Required fixes',
61
+ '',
62
+ ...env.violations.map((v) => `- [${v.severity}] ${v.file}:${v.line} — ${v.hint}`),
63
+ ''
64
+ ].join('\n');
65
+ return requiredFixes;
66
+ }
67
+ /**
68
+ * Write the rendered audit artifact to
69
+ * `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
70
+ *
71
+ * Atomic write (tmp + rename) to avoid partial writes on crash.
72
+ * Returns the absolute path on success.
73
+ */
74
+ export function writeSecurityAuditArtifact(projectRoot, sessionId, rid, body) {
75
+ // The rid is a filename below, and the write is tmp+rename, so an
76
+ // unvalidated rid can OVERWRITE an arbitrary `.md` rather than merely create
77
+ // one. Guarded here (not only at the CLI boundary) so no caller can skip it.
78
+ if (!REQUEST_ID_PATTERN.test(rid)) {
79
+ throw new Error(`Invalid request id: ${rid} (expected letters, digits, dots, underscores, or dashes)`);
80
+ }
81
+ const targetDir = join(projectRoot, '.peaks', '_runtime', sessionId, 'audit');
82
+ mkdirSync(targetDir, { recursive: true });
83
+ const targetPath = join(targetDir, `security-${rid}.md`);
84
+ // tmp + rename for atomicity
85
+ const tmpPath = `${targetPath}.tmp`;
86
+ writeFileSync(tmpPath, body, 'utf8');
87
+ // Sync rename: on Windows, fs.renameSync overwrites if target exists (Node 22+)
88
+ renameSync(tmpPath, targetPath);
89
+ return targetPath;
90
+ }