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
@@ -14,8 +14,22 @@
14
14
  const COMMIT_APPLY_PATTERN = /^\s*git\s+(commit|apply)\b/;
15
15
  const DENY_REASON = 'Code Commit Ban Red Line: peaks-* skills must go through peaks-code / peaks-rd. ' +
16
16
  'Use `peaks request transition` instead of `git commit` / `git apply` directly.';
17
+ /**
18
+ * Narrower than plain fail-closed on purpose: it fires only when a peaks skill
19
+ * is actually present in the session. `resolveActiveSkillForCaller` returns
20
+ * `null` for any unbound session, and failing closed on that would block
21
+ * `git commit` for every ordinary session in any repo with the gate installed.
22
+ *
23
+ * This branch exists because the ban used to be skipped wholesale when the
24
+ * driver did not resolve — the caller guarded it with `if (skill !== null)`, so
25
+ * a resolution failure meant no ban at all.
26
+ */
27
+ const UNRESOLVED_IDENTITY_REASON = 'Code Commit Ban Red Line: a peaks skill is registered in this session, but the ' +
28
+ 'caller could not be identified, so this commit cannot be shown to come from a ' +
29
+ 'non-peaks session. Re-run from the bound session, or use ' +
30
+ '`peaks request transition` instead of `git commit` / `git apply`.';
17
31
  export function isCodeCommit(skill, command) {
18
- if (!skill.startsWith('peaks-'))
32
+ if (skill === null || !skill.startsWith('peaks-'))
19
33
  return false;
20
34
  return COMMIT_APPLY_PATTERN.test(command);
21
35
  }
@@ -23,5 +37,11 @@ export function evaluateCodeBan(input) {
23
37
  if (isCodeCommit(input.skill, input.command)) {
24
38
  return { denied: true, reason: DENY_REASON };
25
39
  }
40
+ if (input.skill === null &&
41
+ !input.identityResolved &&
42
+ input.peaksLeasePresent &&
43
+ COMMIT_APPLY_PATTERN.test(input.command)) {
44
+ return { denied: true, reason: UNRESOLVED_IDENTITY_REASON };
45
+ }
26
46
  return { denied: false, reason: '' };
27
47
  }
@@ -29,6 +29,23 @@ export declare const PEAKS_CODE_RUNTIME_CONTRACT: RedLineCatalogEntry;
29
29
  * can spread this list into RED_LINE_CATALOG and add their own without
30
30
  * touching this file.
31
31
  */
32
+ /**
33
+ * The seven `*-runtime` entries below carry `enforcerRef: null` deliberately.
34
+ *
35
+ * They used to point at one module that built seven enforcers out of a shared
36
+ * `buildContract` helper. Nothing imported any of them, so it enforced nothing,
37
+ * and the audit's liveness probe already classified these entries `prose-only`
38
+ * for exactly that reason — the null states the same fact directly rather than
39
+ * through a probe. The module is gone; `peaks audit red-lines` reports identical
40
+ * counts with it gone and with it present, which is the check that this was
41
+ * cleanup and not a change of verdict.
42
+ *
43
+ * Wiring them is not the cheaper-looking alternative. Run against the SKILL.md
44
+ * files as they stand, six of the seven FIRE — only `peaks-doctor` is clean —
45
+ * and each would have to be satisfied by editing a shipped SKILL.md until it
46
+ * contains the phrase its regex expects. Re-decide the contracts first; do not
47
+ * wire these to "restore" them.
48
+ */
32
49
  export declare const PEAKS_AUDIT_RUNTIME: RedLineCatalogEntry;
33
50
  export declare const PEAKS_CONTENT_RUNTIME: RedLineCatalogEntry;
34
51
  export declare const PEAKS_IDE_RUNTIME: RedLineCatalogEntry;
@@ -145,6 +145,23 @@ export const PEAKS_CODE_RUNTIME_CONTRACT = {
145
145
  * can spread this list into RED_LINE_CATALOG and add their own without
146
146
  * touching this file.
147
147
  */
148
+ /**
149
+ * The seven `*-runtime` entries below carry `enforcerRef: null` deliberately.
150
+ *
151
+ * They used to point at one module that built seven enforcers out of a shared
152
+ * `buildContract` helper. Nothing imported any of them, so it enforced nothing,
153
+ * and the audit's liveness probe already classified these entries `prose-only`
154
+ * for exactly that reason — the null states the same fact directly rather than
155
+ * through a probe. The module is gone; `peaks audit red-lines` reports identical
156
+ * counts with it gone and with it present, which is the check that this was
157
+ * cleanup and not a change of verdict.
158
+ *
159
+ * Wiring them is not the cheaper-looking alternative. Run against the SKILL.md
160
+ * files as they stand, six of the seven FIRE — only `peaks-doctor` is clean —
161
+ * and each would have to be satisfied by editing a shipped SKILL.md until it
162
+ * contains the phrase its regex expects. Re-decide the contracts first; do not
163
+ * wire these to "restore" them.
164
+ */
148
165
  export const PEAKS_AUDIT_RUNTIME = {
149
166
  id: 'rl-peaks-audit-runtime-001',
150
167
  rule: 'peaks-audit SKILL.md must declare the audit-runtime contract (machine-readable audit log, six-dimension audit, author identity)',
@@ -155,14 +172,14 @@ export const PEAKS_AUDIT_RUNTIME = {
155
172
  '6 dimensions',
156
173
  'author identity.*local gitconfig'
157
174
  ],
158
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
175
+ enforcerRef: null
159
176
  };
160
177
  export const PEAKS_CONTENT_RUNTIME = {
161
178
  id: 'rl-peaks-content-runtime-001',
162
179
  rule: 'peaks-content SKILL.md must declare the content-runtime contract (what this skill do, failure mode, each red line is written)',
163
180
  markers: ['MANDATORY', 'BLOCKING'],
164
181
  phrases: ['what this skill do', 'failure mode', 'each red line is written'],
165
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
182
+ enforcerRef: null
166
183
  };
167
184
  export const PEAKS_IDE_RUNTIME = {
168
185
  id: 'rl-peaks-ide-runtime-001',
@@ -173,33 +190,33 @@ export const PEAKS_IDE_RUNTIME = {
173
190
  'what this skill do',
174
191
  'general workflow-gating tool'
175
192
  ],
176
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
193
+ enforcerRef: null
177
194
  };
178
195
  export const PEAKS_DOCTOR_RUNTIME = {
179
196
  id: 'rl-peaks-doctor-runtime-001',
180
197
  rule: 'peaks-doctor SKILL.md must declare the doctor-orchestrator marker',
181
198
  markers: ['MANDATORY'],
182
199
  phrases: ['peaks-loop doctor is a doctor orchestrator'],
183
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
200
+ enforcerRef: null
184
201
  };
185
202
  export const PEAKS_ISSUE_FIX_ORCHESTRATOR_RUNTIME = {
186
203
  id: 'rl-peaks-issue-fix-orchestrator-runtime-001',
187
204
  rule: 'peaks-issue-fix-orchestrator SKILL.md must declare the deviation note + autonomous work proceed markers',
188
205
  markers: ['MANDATORY'],
189
206
  phrases: ['deviation note', 'autonomous work proceed'],
190
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
207
+ enforcerRef: null
191
208
  };
192
209
  export const PEAKS_SOP_RUNTIME = {
193
210
  id: 'rl-peaks-sop-runtime-001',
194
211
  rule: 'peaks-sop SKILL.md must declare the sop-runtime contract (each red line below, sop lint reports findings)',
195
212
  markers: ['MANDATORY'],
196
213
  phrases: ['each red line below is written', 'sop lint reports findings'],
197
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
214
+ enforcerRef: null
198
215
  };
199
216
  export const PEAKS_SLICE_DECOMPOSE_RUNTIME = {
200
217
  id: 'rl-peaks-slice-decompose-runtime-001',
201
218
  rule: 'peaks-slice-decompose SKILL.md must declare the slice-decompose contract (what this skill do, failure mode)',
202
219
  markers: ['MANDATORY'],
203
220
  phrases: ['what this skill do', 'failure mode ('],
204
- enforcerRef: 'src/services/audit/enforcers/lint-peaks-skill-runtime.ts'
221
+ enforcerRef: null
205
222
  };
@@ -0,0 +1,26 @@
1
+ export type AuditRole = 'security' | 'perf';
2
+ export interface HandoffMissingRefusal {
3
+ readonly warnings: readonly string[];
4
+ readonly nextActions: readonly string[];
5
+ }
6
+ /**
7
+ * Build the refusal payload for a `handoff-missing` detect result.
8
+ *
9
+ * `envelopeValidated` is a MEASUREMENT, not an assumption — pass
10
+ * `envelope !== undefined && is<Role>AuditEnvelope(envelope)`. The load-bearing
11
+ * sentence is emitted only when it is true: the read-only `detect` surface
12
+ * carries no envelope at all, so claiming there that the envelope was valid
13
+ * would be a claim stronger than the code.
14
+ *
15
+ * An omitted `requestId` is the un-scoped probe: `resolveHandoffPath` could only
16
+ * have tried `prd/handoff.md`, so the refusal must not name the slice-scoped path
17
+ * as the missing one, and must say that the creating command needs a `--rid`
18
+ * this run does not have.
19
+ */
20
+ export declare function handoffMissingRefusal(opts: {
21
+ readonly role: AuditRole;
22
+ readonly projectRoot: string;
23
+ readonly sessionId: string;
24
+ readonly requestId?: string;
25
+ readonly envelopeValidated: boolean;
26
+ }): HandoffMissingRefusal;
@@ -0,0 +1,109 @@
1
+ /**
2
+ * The `handoff-missing` refusal text, in one module so the security and perf
3
+ * arms cannot drift apart.
4
+ *
5
+ * WHY THIS EXISTS. Both audit services read `prd/handoff-<rid>.md` and refuse
6
+ * with detect state `handoff-missing` when it is absent — writing nothing. The
7
+ * refusal used to name only the DIRECTORY and never said the audit itself had
8
+ * succeeded. Measured twice on 2026-10-13, once per slice, by four independent
9
+ * reviewers — the two slice ids are named in the RD request artifact, not here,
10
+ * so this comment carries the fact without carrying provenance that rots:
11
+ * each produced an envelope that PASSED `isSecurityAuditEnvelope` /
12
+ * `isPerfAuditEnvelope` — so the run got past validation to this gate — and then
13
+ * could not land it. The refusal named a file they had never been told they
14
+ * would need, and the real order is handoff → audit.
15
+ *
16
+ * So the refusal now states the order: the envelope was valid, only the write is
17
+ * blocked, here is the missing path, here is the one command that creates it.
18
+ *
19
+ * NOT DONE HERE, deliberately: creating the handoff. An audit must not author
20
+ * its own input — synthesising the capsule would make the audit's premise
21
+ * self-supplied — so this module names the creating command and stops.
22
+ */
23
+ import { join } from 'node:path';
24
+ import { handoffRelativePath } from '../prd/handoff-service.js';
25
+ /** Per-role names, so the two arms differ by data rather than by copy-paste. */
26
+ const ROLE = {
27
+ security: { skill: 'peaks-security-audit', validator: 'isSecurityAuditEnvelope' },
28
+ perf: { skill: 'peaks-perf-audit', validator: 'isPerfAuditEnvelope' }
29
+ };
30
+ /** The replaced range, by name: C0 … DEL … C1. */
31
+ const LAST_C0_CODE_POINT = 0x1f;
32
+ const DEL_CODE_POINT = 0x7f;
33
+ const FIRST_C1_CODE_POINT = 0x80;
34
+ const LAST_C1_CODE_POINT = 0x9f;
35
+ const isControlCodePoint = (code) => code <= LAST_C0_CODE_POINT ||
36
+ code === DEL_CODE_POINT ||
37
+ (code >= FIRST_C1_CODE_POINT && code <= LAST_C1_CODE_POINT);
38
+ /**
39
+ * A value as it may be PRINTED: control code points replaced with `?`, never
40
+ * truncated — the same set `printableWarningText` (`src/cli/cli-helpers.ts`) and
41
+ * `printableToken` (`.husky/pipeline/contract-verdict.mjs`) replace, and the same
42
+ * code-point comparison `printableWarningText` uses to find them.
43
+ *
44
+ * `requestId` is safe without this (`handoffRelativePath` enforces
45
+ * `REQUEST_ID_PATTERN`), but `sessionId` is guarded only by `isUnsafePathInput`,
46
+ * which rejects traversal and drive paths and NOT C0/C1 control characters. A
47
+ * newline in a `--sid` would otherwise split a refusal line and forge one of its
48
+ * own — on the very surface this module exists to make readable.
49
+ */
50
+ function printable(value) {
51
+ let rendered = '';
52
+ for (const char of value) {
53
+ rendered += isControlCodePoint(char.codePointAt(0) ?? 0) ? '?' : char;
54
+ }
55
+ return rendered;
56
+ }
57
+ /**
58
+ * Build the refusal payload for a `handoff-missing` detect result.
59
+ *
60
+ * `envelopeValidated` is a MEASUREMENT, not an assumption — pass
61
+ * `envelope !== undefined && is<Role>AuditEnvelope(envelope)`. The load-bearing
62
+ * sentence is emitted only when it is true: the read-only `detect` surface
63
+ * carries no envelope at all, so claiming there that the envelope was valid
64
+ * would be a claim stronger than the code.
65
+ *
66
+ * An omitted `requestId` is the un-scoped probe: `resolveHandoffPath` could only
67
+ * have tried `prd/handoff.md`, so the refusal must not name the slice-scoped path
68
+ * as the missing one, and must say that the creating command needs a `--rid`
69
+ * this run does not have.
70
+ */
71
+ export function handoffMissingRefusal(opts) {
72
+ const { skill, validator } = ROLE[opts.role];
73
+ // The real paths are built from the RAW ids, so `handoffRelativePath`'s guard
74
+ // runs on exactly the bytes `resolveHandoffPath` would probe. Each value is
75
+ // sanitised at the point it is interpolated, below — not here — so the render
76
+ // is the only thing that changes.
77
+ const prdDir = join(opts.projectRoot, '.peaks', '_runtime', opts.sessionId, 'prd');
78
+ // The path the creating command WRITES. With a rid that is the slice-scoped
79
+ // capsule; `resolveHandoffPath` already ran `handoffRelativePath` for these
80
+ // same ids on the way in, so this join cannot throw where that one did not.
81
+ const missingPath = opts.requestId === undefined
82
+ ? join(prdDir, 'handoff.md')
83
+ : join(opts.projectRoot, handoffRelativePath(opts.sessionId, opts.requestId));
84
+ const createCommand = opts.requestId === undefined
85
+ ? `peaks prd handoff init --rid <request-id> --sid ${opts.sessionId} --body <body> --apply`
86
+ : `peaks prd handoff init --rid ${opts.requestId} --sid ${opts.sessionId} --body <body> --apply`;
87
+ return {
88
+ warnings: [
89
+ `peaks-prd handoff not found under ${printable(prdDir)}`,
90
+ ...(opts.requestId === undefined
91
+ ? [
92
+ "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`."
93
+ ]
94
+ : [])
95
+ ],
96
+ nextActions: [
97
+ ...(opts.envelopeValidated
98
+ ? [
99
+ `The audit envelope passed validation (${validator}); only the artifact write is blocked.`
100
+ ]
101
+ : []),
102
+ opts.requestId === undefined
103
+ ? `The only handoff path probed was: ${printable(missingPath)}`
104
+ : `Missing peaks-prd handoff: ${printable(missingPath)}`,
105
+ `Create it with: ${printable(createCommand)}`,
106
+ `Until the handoff exists, ${skill} cannot start (gate fail).`
107
+ ]
108
+ };
109
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Reading the sha256-locked PRD handoff capsule and the project-level security
3
+ * template. Split out of `security-audit-service.ts` so the audit service and
4
+ * the declaration's producer can both depend on the readers without depending
5
+ * on each other.
6
+ */
7
+ /**
8
+ * Handoff frontmatter — minimal projection of the peaks-prd v2.11.0 handoff
9
+ * frontmatter. We only need sha256 for verification; the rest of the handoff
10
+ * body is consumed by the parent LLM, not by this service.
11
+ */
12
+ export interface HandoffFrontmatter {
13
+ readonly sha256: string;
14
+ readonly schemaVersion: number;
15
+ }
16
+ /**
17
+ * Read the peaks-prd handoff frontmatter + body, verify sha256 matches
18
+ * the body. Returns null on missing file or sha256 mismatch; otherwise
19
+ * returns the parsed frontmatter + body string.
20
+ *
21
+ * Defensive: we read frontmatter via a 1-line regex match, not via
22
+ * a YAML parser. The handoff service (`src/services/prd/handoff-service.ts`)
23
+ * is the canonical writer; we only consume its output here.
24
+ */
25
+ export declare function readAndVerifyHandoff(handoffPath: string, projectRoot: string): {
26
+ frontmatter: HandoffFrontmatter;
27
+ body: string;
28
+ } | null;
29
+ /**
30
+ * Read the project-level security-template.md. Returns the body
31
+ * string (with frontmatter stripped) or null if the file is absent.
32
+ * Does NOT validate the template content; the parent LLM validates
33
+ * by reading.
34
+ */
35
+ export declare function readSecurityTemplate(projectRoot: string): string | null;
36
+ /** The verified handoff's sha256, or `unknown` when there is no capsule. */
37
+ export declare function resolveHandoffHash(projectRoot: string, sessionId: string, rid: string): string;
@@ -0,0 +1,81 @@
1
+ /**
2
+ * Reading the sha256-locked PRD handoff capsule and the project-level security
3
+ * template. Split out of `security-audit-service.ts` so the audit service and
4
+ * the declaration's producer can both depend on the readers without depending
5
+ * on each other.
6
+ */
7
+ import { existsSync, readFileSync } from 'node:fs';
8
+ import { join, resolve, isAbsolute } from 'node:path';
9
+ import { createHash } from 'node:crypto';
10
+ import { resolveHandoffPath } from '../prd/handoff-service.js';
11
+ /**
12
+ * Read the peaks-prd handoff frontmatter + body, verify sha256 matches
13
+ * the body. Returns null on missing file or sha256 mismatch; otherwise
14
+ * returns the parsed frontmatter + body string.
15
+ *
16
+ * Defensive: we read frontmatter via a 1-line regex match, not via
17
+ * a YAML parser. The handoff service (`src/services/prd/handoff-service.ts`)
18
+ * is the canonical writer; we only consume its output here.
19
+ */
20
+ export function readAndVerifyHandoff(handoffPath, projectRoot) {
21
+ if (!handoffPath || !isAbsolute(handoffPath)) {
22
+ const absolutePath = resolve(projectRoot, handoffPath);
23
+ if (!existsSync(absolutePath))
24
+ return null;
25
+ return readAndVerifyHandoff(absolutePath, projectRoot);
26
+ }
27
+ if (!existsSync(handoffPath))
28
+ return null;
29
+ let raw;
30
+ try {
31
+ raw = readFileSync(handoffPath, 'utf8');
32
+ }
33
+ catch {
34
+ // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
35
+ return null;
36
+ }
37
+ // Frontmatter pattern: `---` line, then key: value pairs, then `---` line.
38
+ const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
39
+ if (match === null)
40
+ return null;
41
+ const frontmatterRaw = match[1];
42
+ const body = match[2];
43
+ const sha256Match = frontmatterRaw.match(/^sha256:\s*([a-f0-9]{64})\s*$/m);
44
+ const schemaVersionMatch = frontmatterRaw.match(/^schemaVersion:\s*(\d+)\s*$/m);
45
+ if (sha256Match === null || schemaVersionMatch === null)
46
+ return null;
47
+ const sha256Expected = sha256Match[1];
48
+ const schemaVersion = parseInt(schemaVersionMatch[1], 10);
49
+ const sha256Actual = createHash('sha256').update(body, 'utf8').digest('hex');
50
+ if (sha256Expected !== sha256Actual)
51
+ return null;
52
+ return {
53
+ frontmatter: { sha256: sha256Expected, schemaVersion },
54
+ body
55
+ };
56
+ }
57
+ /**
58
+ * Read the project-level security-template.md. Returns the body
59
+ * string (with frontmatter stripped) or null if the file is absent.
60
+ * Does NOT validate the template content; the parent LLM validates
61
+ * by reading.
62
+ */
63
+ export function readSecurityTemplate(projectRoot) {
64
+ const templatePath = join(projectRoot, '.peaks', 'project-scan', 'security-template.md');
65
+ if (!existsSync(templatePath))
66
+ return null;
67
+ try {
68
+ return readFileSync(templatePath, 'utf8');
69
+ }
70
+ catch {
71
+ // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
72
+ return null;
73
+ }
74
+ }
75
+ /** The verified handoff's sha256, or `unknown` when there is no capsule. */
76
+ export function resolveHandoffHash(projectRoot, sessionId, rid) {
77
+ const handoffPath = resolveHandoffPath({ projectRoot, sessionId, requestId: rid });
78
+ if (handoffPath === null)
79
+ return 'unknown';
80
+ return readAndVerifyHandoff(handoffPath, projectRoot)?.frontmatter.sha256 ?? 'unknown';
81
+ }
@@ -1,2 +1,7 @@
1
- export { runSecurityAudit, isSecurityAuditEnvelope, detectSecurityAudit, readSecurityTemplate, renderSecurityAuditArtifact, type SecurityAuditEnvelope, type SecurityAuditViolation, type SecurityAuditVerdict, type SecurityAuditDetectState, type SecurityAuditDetectResult, type HandoffFrontmatter, readAndVerifyHandoff } from './security-audit-service.js';
1
+ export { runSecurityAudit, isSecurityAuditEnvelope, detectSecurityAudit, type SecurityAuditEnvelope, type SecurityAuditViolation, type SecurityAuditVerdict, type SecurityAuditDetectState, type SecurityAuditDetectResult } from './security-audit-service.js';
2
+ export { readSecurityTemplate, readAndVerifyHandoff, resolveHandoffHash, type HandoffFrontmatter } from './handoff-readers.js';
3
+ export { renderSecurityAuditArtifact, writeSecurityAuditArtifact } from './security-audit-artifact.js';
4
+ export { parseJudgedDeclaration, renderJudgedDeclaration, sha256OfFile, type JudgedDeclaration } from './judged-declaration.js';
5
+ export { buildJudgedDeclaration, buildJudgedDeclarationFor } from './judged-declaration-build.js';
6
+ export { verifyJudgedDeclaration, resolveSecurityArtifact, type JudgedCheckResult, type JudgedRefusal } from './judged-declaration-check.js';
2
7
  export { runPerfAudit, isPerfAuditEnvelope, detectPerfAudit, readPerfTemplate, renderPerfAuditArtifact, type PerfAuditEnvelope, type PerfAuditViolation, type PerfAuditVerdict, type PerfAuditDetectState, type PerfAuditDetectResult } from './perf-audit-service.js';
@@ -1,2 +1,7 @@
1
- export { runSecurityAudit, isSecurityAuditEnvelope, detectSecurityAudit, readSecurityTemplate, renderSecurityAuditArtifact, readAndVerifyHandoff } from './security-audit-service.js';
1
+ export { runSecurityAudit, isSecurityAuditEnvelope, detectSecurityAudit } from './security-audit-service.js';
2
+ export { readSecurityTemplate, readAndVerifyHandoff, resolveHandoffHash } from './handoff-readers.js';
3
+ export { renderSecurityAuditArtifact, writeSecurityAuditArtifact } from './security-audit-artifact.js';
4
+ export { parseJudgedDeclaration, renderJudgedDeclaration, sha256OfFile } from './judged-declaration.js';
5
+ export { buildJudgedDeclaration, buildJudgedDeclarationFor } from './judged-declaration-build.js';
6
+ export { verifyJudgedDeclaration, resolveSecurityArtifact } from './judged-declaration-check.js';
2
7
  export { runPerfAudit, isPerfAuditEnvelope, detectPerfAudit, readPerfTemplate, renderPerfAuditArtifact } from './perf-audit-service.js';
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Building a declaration: hashing the judged paths against the tree, and the
3
+ * detect result the producer substitutes when that build fails. Split from
4
+ * `judged-declaration.ts`, which carries the grammar and the parser.
5
+ */
6
+ import { type JudgedDeclaration, type JudgedParseFailure } from './judged-declaration.js';
7
+ /**
8
+ * Build the declaration for one audit run from the slice's own identifiers.
9
+ * The caller passes its own input object straight through, so the producer
10
+ * needs one call rather than an argument list it would have to grow a branch
11
+ * to guard.
12
+ */
13
+ export declare function buildJudgedDeclarationFor(input: {
14
+ readonly projectRoot: string;
15
+ readonly sessionId: string;
16
+ readonly rid: string;
17
+ readonly generatedAt: string;
18
+ readonly judgedPaths: readonly string[];
19
+ }): {
20
+ ok: true;
21
+ declaration: JudgedDeclaration;
22
+ handoffHash: string;
23
+ } | JudgedParseFailure;
24
+ /** Build a declaration from concrete paths, hashing each against the tree.
25
+ * `roots` is always empty here: no producer in this repo emits a directory
26
+ * root yet, so the gained-path arm is reachable only through the grammar, not
27
+ * through a run. The check supports it and tests it; this builder does not
28
+ * offer it. */
29
+ export declare function buildJudgedDeclaration(input: {
30
+ readonly projectRoot: string;
31
+ readonly judgedAt: string;
32
+ readonly handoffHash: string;
33
+ readonly paths: readonly string[];
34
+ }): {
35
+ ok: true;
36
+ declaration: JudgedDeclaration;
37
+ } | {
38
+ ok: false;
39
+ code: string;
40
+ detail: string;
41
+ };
42
+ /**
43
+ * The rendered section for a set of paths, for a producer that has a project
44
+ * root and a file list but no handoff capsule. Returns an empty string when
45
+ * nothing can be declared — the artifact is then refused by the check, which is
46
+ * the contract's whole point rather than a fallback to fix here.
47
+ */
48
+ export declare function renderJudgedSection(projectRoot: string, paths: readonly string[]): string;
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Building a declaration: hashing the judged paths against the tree, and the
3
+ * detect result the producer substitutes when that build fails. Split from
4
+ * `judged-declaration.ts`, which carries the grammar and the parser.
5
+ */
6
+ import { join } from 'node:path';
7
+ import { JUDGED_SCHEMA_VERSION, renderJudgedDeclaration, sha256OfFile, validateDeclaredPath } from './judged-declaration.js';
8
+ import { resolveHandoffHash } from './handoff-readers.js';
9
+ /**
10
+ * Build the declaration for one audit run from the slice's own identifiers.
11
+ * The caller passes its own input object straight through, so the producer
12
+ * needs one call rather than an argument list it would have to grow a branch
13
+ * to guard.
14
+ */
15
+ export function buildJudgedDeclarationFor(input) {
16
+ const handoffHash = resolveHandoffHash(input.projectRoot, input.sessionId, input.rid);
17
+ const built = buildJudgedDeclaration({
18
+ projectRoot: input.projectRoot,
19
+ judgedAt: input.generatedAt,
20
+ handoffHash,
21
+ paths: input.judgedPaths
22
+ });
23
+ return built.ok ? { ...built, handoffHash } : built;
24
+ }
25
+ /** Build a declaration from concrete paths, hashing each against the tree.
26
+ * `roots` is always empty here: no producer in this repo emits a directory
27
+ * root yet, so the gained-path arm is reachable only through the grammar, not
28
+ * through a run. The check supports it and tests it; this builder does not
29
+ * offer it. */
30
+ export function buildJudgedDeclaration(input) {
31
+ const files = [];
32
+ const seen = new Set();
33
+ for (const raw of input.paths) {
34
+ const checked = validateDeclaredPath(raw);
35
+ if (!checked.ok)
36
+ return { ok: false, code: 'declaration-path', detail: checked.detail };
37
+ if (seen.has(checked.path))
38
+ continue;
39
+ seen.add(checked.path);
40
+ const hashed = sha256OfFile(join(input.projectRoot, ...checked.path.split('/')));
41
+ if (!hashed.ok)
42
+ return { ok: false, code: `declared-path-${hashed.code}`, detail: checked.path };
43
+ files.push({ path: checked.path, sha256: hashed.sha256 });
44
+ }
45
+ if (files.length === 0)
46
+ return { ok: false, code: 'declaration-empty', detail: 'no judged paths' };
47
+ files.sort((a, b) => (a.path < b.path ? -1 : 1));
48
+ return {
49
+ ok: true,
50
+ declaration: {
51
+ schemaVersion: JUDGED_SCHEMA_VERSION,
52
+ judgedAt: input.judgedAt,
53
+ handoffHash: input.handoffHash,
54
+ files,
55
+ roots: []
56
+ }
57
+ };
58
+ }
59
+ /**
60
+ * The rendered section for a set of paths, for a producer that has a project
61
+ * root and a file list but no handoff capsule. Returns an empty string when
62
+ * nothing can be declared — the artifact is then refused by the check, which is
63
+ * the contract's whole point rather than a fallback to fix here.
64
+ */
65
+ export function renderJudgedSection(projectRoot, paths) {
66
+ const built = buildJudgedDeclaration({
67
+ projectRoot,
68
+ judgedAt: new Date(0).toISOString(),
69
+ handoffHash: 'unknown',
70
+ paths
71
+ });
72
+ return built.ok ? `\n${renderJudgedDeclaration(built.declaration)}` : '';
73
+ }
@@ -0,0 +1,79 @@
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 { type JudgedDeclaration } from './judged-declaration.js';
21
+ export type JudgedRefusal = {
22
+ readonly code: string;
23
+ readonly artifact: string;
24
+ readonly path: string;
25
+ };
26
+ export type JudgedCheckResult = {
27
+ readonly refusals: readonly JudgedRefusal[];
28
+ readonly checked: number;
29
+ };
30
+ /** Where the security audit artifact may live, newest tier first. */
31
+ export declare function securityArtifactTiers(rid: string): readonly string[];
32
+ export declare function resolveSecurityArtifact(projectRoot: string, sessionId: string, rid: string): {
33
+ readonly relative: string;
34
+ readonly absolute: string;
35
+ } | null;
36
+ type TreeListing = {
37
+ readonly ok: true;
38
+ readonly files: readonly string[];
39
+ } | {
40
+ readonly ok: false;
41
+ readonly detail: string;
42
+ };
43
+ /**
44
+ * List the files git knows about under a prefix. Fail-closed: a git read that
45
+ * did not happen is reported, never returned as an empty list.
46
+ */
47
+ export declare function listTreeFiles(projectRoot: string, prefix: string): TreeListing;
48
+ /** Compare the declaration against the tree. Returns refusals, ordered by path. */
49
+ export declare function checkDeclarationAgainstTree(input: {
50
+ readonly projectRoot: string;
51
+ readonly artifact: string;
52
+ readonly declaration: JudgedDeclaration;
53
+ }): readonly JudgedRefusal[];
54
+ /**
55
+ * Entry point for the transition gate. An artifact that is not there is not
56
+ * this check's business — the artifact-existence prerequisite owns that.
57
+ *
58
+ * LIMIT, measured rather than assumed — the hole that survives is COMPLETENESS,
59
+ * not tampering: the declaration is the producer's own statement, so ten files
60
+ * touched and one declared passes. Nothing here can know what the producer did
61
+ * not say. Rule: a declaration is a claim about the paths it names, never a
62
+ * claim that those are all the paths.
63
+ *
64
+ * Absence rule, stated where the producer reads it, and the reason it is this
65
+ * blunt: a security artifact that IS there must carry a declaration. No section
66
+ * of the artifact turns the check off, because a requirement that any section
67
+ * can switch off is not a requirement — an earlier draft of this file keyed the
68
+ * requirement on a marker line in the coverage block, and deleting that block
69
+ * (while keeping the declaration, and then rewriting a declared path) passed.
70
+ * The cost is stated rather than hidden: an artifact written before this change
71
+ * is refused until the audit is re-run, and the gate only fires on a
72
+ * transition, so nothing already committed is affected.
73
+ */
74
+ export declare function verifyJudgedDeclaration(input: {
75
+ readonly projectRoot: string;
76
+ readonly sessionId: string;
77
+ readonly requestId: string;
78
+ }): JudgedCheckResult;
79
+ export {};