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
@@ -28,7 +28,8 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from
28
28
  import { dirname, join, resolve } from 'node:path';
29
29
  import { registerSop } from '../sop/sop-registry-service.js';
30
30
  import { projectRegistryPath, projectSopManifestPath } from '../sop/sop-paths.js';
31
- import { artifactEvidenceFailure } from './promotion-artifact-evidence.js';
31
+ import { missingArtifacts } from './promotion-artifact-missing.js';
32
+ export { missingArtifacts };
32
33
  /**
33
34
  * PRD-002b slice 2 — extract magic numbers used by the promotion
34
35
  * helper. `slice(0, 5)` was used as a heuristic on the user's body
@@ -47,7 +48,7 @@ export const PROMOTION_LAYER_DETAILS = [
47
48
  {
48
49
  layer: 'B',
49
50
  label: 'peaks-hooks PreToolUse',
50
- description: 'Append a matcher to .peaks/.claude-settings-template.json. Tool-call interception.'
51
+ description: 'Append a matcher to `.peaks/.claude-settings-template.json`, or to `.claude/settings.json` for a hook that ships with this repository. Tool-call interception.'
51
52
  },
52
53
  {
53
54
  layer: 'C',
@@ -72,9 +73,11 @@ export const PROMOTION_LAYER_DETAILS = [
72
73
  * decoration: `gate-enforce-service.enforceBashCommand` enumerates SOPs via
73
74
  * `readRegistry()`, so an unregistered manifest is off the enforcement path
74
75
  * no matter how valid it is.
75
- * - B (peaks-hooks PreToolUse): `.peaks/.claude-settings-template.json` must
76
- * register the rule inside its `hooks` block. The file always exists, so
77
- * existence proves nothing — the evidence is the registration inside it.
76
+ * - B (peaks-hooks PreToolUse): the `hooks` block of one of the two settings
77
+ * files in `LAYER_B_SETTINGS` — the `.peaks/.claude-settings-template.json`
78
+ * snapshot, or this repository's tracked `.claude/settings.json` — must
79
+ * register the rule. The file always exists, so existence proves nothing:
80
+ * the evidence is the registration inside it.
78
81
  * - C (mode-gate hardFloorCategory): `src/services/code/mode-gate.ts` must
79
82
  * register the rule in the hard-floor vocabulary, for the same reason. This
80
83
  * is the repo's existing convention: the one real layer-C promotion cites
@@ -110,7 +113,8 @@ export function promotionArtifactChecks(memoryName, layer) {
110
113
  if (layer === 'B') {
111
114
  return [
112
115
  {
113
- path: '.peaks/.claude-settings-template.json',
116
+ path: LAYER_B_SETTINGS[0],
117
+ alternatives: [LAYER_B_SETTINGS[1]],
114
118
  evidence: 'hook-registration',
115
119
  id: memoryName
116
120
  }
@@ -121,34 +125,25 @@ export function promotionArtifactChecks(memoryName, layer) {
121
125
  ];
122
126
  }
123
127
  /**
124
- * Which of `checks` are not satisfied under `projectRoot`. Empty means the
125
- * promotion is backed by its artifact. Never throws, and never permits: a file
126
- * that is absent, unreadable, or unparseable is a finding, not a warning —
127
- * "cannot read the evidence" must not read as "the evidence is good".
128
+ * The settings files a layer-B hook registration may legitimately live in.
129
+ *
130
+ * TWO locations, because there are two audiences and only one file each.
131
+ * `peaks workspace init` writes `.peaks/.claude-settings-template.json` in every
132
+ * project, consumer or not, so it is tried first. This repository's own
133
+ * development hooks are registered in the tracked `.claude/settings.json`
134
+ * instead — the template above is written into a CONSUMER tree, where
135
+ * `${CLAUDE_PROJECT_DIR}/src/**` names nothing, so a hook of ours cannot live
136
+ * there. Checking only the snapshot reports a rule that IS enforced as
137
+ * unpromoted; checking only the tracked file breaks every consumer.
138
+ *
139
+ * `.claude/settings.local.json` is deliberately NOT a third location: a rule
140
+ * backed only by that untracked file is the "true on one machine" state this
141
+ * artifact check exists to reject.
128
142
  */
129
- export function missingArtifacts(checks, projectRoot) {
130
- const missing = [];
131
- for (const check of checks) {
132
- const absolute = resolve(projectRoot, check.path);
133
- if (!existsSync(absolute)) {
134
- missing.push(`${check.path} (absent)`);
135
- continue;
136
- }
137
- let text;
138
- try {
139
- text = readFileSync(absolute, 'utf8');
140
- }
141
- catch {
142
- missing.push(`${check.path} (unreadable)`);
143
- continue;
144
- }
145
- const failure = artifactEvidenceFailure(check, text);
146
- if (failure !== null) {
147
- missing.push(`${check.path} (${failure})`);
148
- }
149
- }
150
- return missing;
151
- }
143
+ const LAYER_B_SETTINGS = [
144
+ '.peaks/.claude-settings-template.json',
145
+ '.claude/settings.json'
146
+ ];
152
147
  const COMMENT_MARKER_RE = /<!--\s*peaks-feedback-promoted:\s*layer=([ABC])\s*-->/;
153
148
  /**
154
149
  * declaration.
@@ -518,8 +513,8 @@ export function generatePromotionStub(opts) {
518
513
  }
519
514
  if (layer === 'B') {
520
515
  return {
521
- snippet: `{\n "matcher": "Bash",\n "hooks": [\n {\n "type": "command",\n "command": "node -e \\"process.exit(0)\\""\n }\n ]\n}\n<!-- Append the rule-specific matcher to .peaks/.claude-settings-template.json -->`,
522
- targetFiles: ['.peaks/.claude-settings-template.json']
516
+ snippet: `{\n "matcher": "Bash",\n "hooks": [\n {\n "type": "command",\n "command": "node -e \\"process.exit(0)\\""\n }\n ]\n}\n<!-- Append the rule-specific matcher to .peaks/.claude-settings-template.json, or to .claude/settings.json for a hook that ships with this repository -->`,
517
+ targetFiles: [...LAYER_B_SETTINGS]
523
518
  };
524
519
  }
525
520
  // layer === 'C'
@@ -18,6 +18,24 @@ export type PromotionEvidence =
18
18
  export type PromotionArtifactCheck = {
19
19
  /** Project-relative POSIX path whose CONTENT must carry the evidence. */
20
20
  path: string;
21
+ /**
22
+ * Other project-relative paths where the SAME evidence may legitimately live.
23
+ *
24
+ * The conjunction is across CHECKS — layer A needs its manifest AND its
25
+ * registry entry — so an alternative location cannot be expressed as another
26
+ * check: that would demand it too. It belongs here, where the sense is OR.
27
+ *
28
+ * Layer B is the reason the field exists. Its registration is written into
29
+ * whichever Claude settings file the project actually reads: a consumer gets
30
+ * the generated snapshot, while this repository registers its own development
31
+ * hooks in the tracked `.claude/settings.json` — the template that produces the
32
+ * snapshot is written into a consumer tree, where a command naming
33
+ * `${CLAUDE_PROJECT_DIR}/src/**` resolves to nothing.
34
+ *
35
+ * `artifactEvidenceFailure` reads `evidence` and `id` only, so the same check
36
+ * is tried against every candidate as it stands.
37
+ */
38
+ alternatives?: readonly string[];
21
39
  evidence: PromotionEvidence;
22
40
  /** The rule id the evidence must name (a SOP id for layer A, a memory name for B and C). */
23
41
  id: string;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The reader half of the promotion-artifact concern: which of a layer's required
3
+ * artifacts are NOT present, under a given project root.
4
+ *
5
+ * Extracted from `./feedback-promotion-service.ts` for the file-size cap, the way
6
+ * `./promotion-artifact-evidence.ts` was extracted before it. That module builds
7
+ * the decision from a file's text; this one decides whether the file is there to
8
+ * read. The service re-exports `missingArtifacts` from its own path, so no
9
+ * importer changed.
10
+ */
11
+ import { type PromotionArtifactCheck } from './promotion-artifact-evidence.js';
12
+ /**
13
+ * Which of `checks` are not satisfied under `projectRoot`. Empty means the
14
+ * promotion is backed by its artifact. Never throws, and never permits: a file
15
+ * that is absent, unreadable, or unparseable is a finding, not a warning —
16
+ * "cannot read the evidence" must not read as "the evidence is good".
17
+ *
18
+ * A check is satisfied when `path` OR any of its `alternatives` carries the
19
+ * evidence; one that no candidate satisfies is reported ONCE, naming every
20
+ * location it looked in, so a reader is never told about half the search.
21
+ */
22
+ export declare function missingArtifacts(checks: readonly PromotionArtifactCheck[], projectRoot: string): string[];
@@ -0,0 +1,63 @@
1
+ /**
2
+ * The reader half of the promotion-artifact concern: which of a layer's required
3
+ * artifacts are NOT present, under a given project root.
4
+ *
5
+ * Extracted from `./feedback-promotion-service.ts` for the file-size cap, the way
6
+ * `./promotion-artifact-evidence.ts` was extracted before it. That module builds
7
+ * the decision from a file's text; this one decides whether the file is there to
8
+ * read. The service re-exports `missingArtifacts` from its own path, so no
9
+ * importer changed.
10
+ */
11
+ import { existsSync, readFileSync } from 'node:fs';
12
+ import { resolve } from 'node:path';
13
+ import { artifactEvidenceFailure } from './promotion-artifact-evidence.js';
14
+ /**
15
+ * Which of `checks` are not satisfied under `projectRoot`. Empty means the
16
+ * promotion is backed by its artifact. Never throws, and never permits: a file
17
+ * that is absent, unreadable, or unparseable is a finding, not a warning —
18
+ * "cannot read the evidence" must not read as "the evidence is good".
19
+ *
20
+ * A check is satisfied when `path` OR any of its `alternatives` carries the
21
+ * evidence; one that no candidate satisfies is reported ONCE, naming every
22
+ * location it looked in, so a reader is never told about half the search.
23
+ */
24
+ export function missingArtifacts(checks, projectRoot) {
25
+ const missing = [];
26
+ for (const check of checks) {
27
+ const failures = candidateFailures(check, projectRoot);
28
+ if (failures !== null)
29
+ missing.push(failures.join('; '));
30
+ }
31
+ return missing;
32
+ }
33
+ /**
34
+ * One `${path} (${reason})` per location that does NOT back `check`, or `null`
35
+ * when one of them does. `null` and `[]` are different answers, which is why the
36
+ * caller gets the distinction rather than an empty array.
37
+ *
38
+ * `check.alternatives` exists because a layer may legitimately keep its one
39
+ * artifact in more than one place; the conjunction is across CHECKS, so an
40
+ * alternative location cannot be spelled as another check without demanding it.
41
+ */
42
+ function candidateFailures(check, projectRoot) {
43
+ const failures = [];
44
+ for (const candidate of [check.path, ...(check.alternatives ?? [])]) {
45
+ const absolute = resolve(projectRoot, candidate);
46
+ if (!existsSync(absolute)) {
47
+ failures.push(`${candidate} (absent)`);
48
+ continue;
49
+ }
50
+ let text;
51
+ try {
52
+ text = readFileSync(absolute, 'utf8');
53
+ }
54
+ catch {
55
+ failures.push(`${candidate} (unreadable)`);
56
+ continue;
57
+ }
58
+ const failure = artifactEvidenceFailure(check, text);
59
+ if (failure !== null)
60
+ failures.push(`${candidate} (${failure})`);
61
+ }
62
+ return failures.length === 1 + (check.alternatives?.length ?? 0) ? failures : null;
63
+ }
@@ -1,12 +1,20 @@
1
+ /**
2
+ * A completed model call's token accounting: the two counts an observability
3
+ * reader sums, plus a tag saying whether the provider reported them or the
4
+ * runner estimated them. `source` is optional so a runner that always has
5
+ * provider numbers — or a test fake — need not state it.
6
+ */
7
+ export interface LlmTokenUsage {
8
+ readonly input: number;
9
+ readonly output: number;
10
+ readonly source?: 'provider' | 'estimated';
11
+ }
1
12
  export interface LlmRunner {
2
13
  call(systemPrompt: string, userPrompt: string, opts: {
3
14
  maxTokens: number;
4
15
  }): Promise<{
5
16
  output: string;
6
- tokens: {
7
- input: number;
8
- output: number;
9
- };
17
+ tokens: LlmTokenUsage;
10
18
  }>;
11
19
  }
12
20
  export interface PrepareFinalReviewOptions {
@@ -19,8 +27,91 @@ export interface PrepareFinalReviewOptions {
19
27
  * reports the dimension `unavailable` when it cannot.
20
28
  */
21
29
  readonly baseRef?: string;
30
+ /**
31
+ * Called once per COMPLETED review, with the model call's token accounting,
32
+ * immediately before this function returns. The `token-usage` emission
33
+ * belongs in the caller (the CLI holds the session binding and owns the
34
+ * emit), so the service reports the numbers instead of writing observability
35
+ * itself. Optional: a caller that has nowhere to put them simply omits it.
36
+ */
37
+ readonly onLlmTokens?: (tokens: LlmTokenUsage) => void;
22
38
  }
23
39
  export declare class IncompleteFinalReviewError extends Error {
24
40
  readonly code: "INCOMPLETE_FINAL_REVIEW";
25
41
  constructor(message: string);
26
42
  }
43
+ /** Path segments (under `.peaks/_runtime/<sessionId>/`) the artifact lands at. */
44
+ export declare const API_DIFF_ARTIFACT_SEGMENTS: readonly ["final-review", "api-diff.txt"];
45
+ /**
46
+ * The literal that opens the artifact's conclusion line.
47
+ *
48
+ * Exported because the consumer must be able to test for the CONCLUSION, not
49
+ * for a byte count (F-BLOCK-1BYTE): one byte of `api-diff.txt` satisfied
50
+ * "status: found" while conveying nothing, and the delivery gate it fed then let
51
+ * a `pass` stand on a comparison nobody saw. The producer writes the line this
52
+ * marker opens and `final-review-service.ts` requires it in the delivered
53
+ * bytes, so the two cannot drift apart into the same hole again.
54
+ */
55
+ export declare const PRE_POST_DIFF_VERDICT_MARKER = "VERDICT: ";
56
+ /**
57
+ * The three conclusions the artifact may open with, exported as the same
58
+ * literals the verdict writer interpolates.
59
+ *
60
+ * They are constants because reading the conclusion is now part of the
61
+ * consumer's job (F2): the pre/post-diff source is the one source whose
62
+ * conclusion had a machine-readable form all along, and the envelope threw it
63
+ * away — a delivered `STRUCTURAL DRIFT DETECTED` produced `allPass: true` with
64
+ * an empty `needsAttention`. A consumer that must classify the conclusion may
65
+ * only do so against the producer's own literals, never against a re-typed
66
+ * copy of them.
67
+ */
68
+ export declare const PRE_POST_DIFF_NO_DRIFT = "NO STRUCTURAL DRIFT";
69
+ export declare const PRE_POST_DIFF_ADDITIONS_ONLY = "ADDITIONS ONLY";
70
+ export declare const PRE_POST_DIFF_DRIFT_DETECTED = "STRUCTURAL DRIFT DETECTED";
71
+ /**
72
+ * What the artifact's conclusion LINE says, read from the bytes a consumer
73
+ * actually received.
74
+ *
75
+ * `indeterminate` is not "nothing to report": it is "the line is there (or is
76
+ * not) and this consumer cannot classify it", which for a drift DETECTOR is a
77
+ * fact a human has to see — see `enforceStructuralDriftAttention`.
78
+ */
79
+ export type PrePostDiffConclusion = 'no-drift' | 'additions-only' | 'drift-detected' | 'indeterminate';
80
+ /**
81
+ * Classify the delivered conclusion. Pure and total: a caller passes the bytes
82
+ * it received (possibly a head slice) and gets back what the artifact says.
83
+ *
84
+ * Only the FIRST `VERDICT:` line is read. The artifact's header promises the
85
+ * verdict "is repeated nowhere" and that it is the file's conclusion, so a
86
+ * later line cannot be the answer, and reading further would let a document's
87
+ * prose masquerade as its conclusion.
88
+ */
89
+ export declare function classifyPrePostDiffVerdict(content: string): PrePostDiffConclusion;
90
+ export interface PrePostDiffComputed {
91
+ readonly status: 'computed';
92
+ readonly summary: string;
93
+ readonly relativePath: string;
94
+ readonly absolutePath: string;
95
+ readonly content: string;
96
+ }
97
+ export interface PrePostDiffUnavailable {
98
+ readonly status: 'unavailable';
99
+ /** Why no baseline exists, in the operator's terms. */
100
+ readonly reason: string;
101
+ /**
102
+ * `true` when the project root IS a git work tree — i.e. a baseline was
103
+ * expected to be computable and was not. That distinction shapes the REASON
104
+ * the operator is given (a tooling failure to fix, versus a project that has
105
+ * no baseline to offer), and the service refuses a `pass` on this dimension
106
+ * either way: "not a git repository" is the CAUSE of the missing evidence,
107
+ * never a licence to trust the claim the evidence was supposed to support.
108
+ */
109
+ readonly inGitWorkTree: boolean;
110
+ }
111
+ export type PrePostDiffResult = PrePostDiffComputed | PrePostDiffUnavailable;
112
+ export interface ProducePrePostDiffOptions {
113
+ readonly projectRoot: string;
114
+ readonly sessionId: string;
115
+ /** Explicit base ref. Unset ⇒ merge-base with the upstream default branch. */
116
+ readonly baseRef?: string;
117
+ }
@@ -5,6 +5,12 @@
5
5
  // Hoisted verbatim from final-review-service.ts (C wave 7 file-size
6
6
  // split); the service module re-exports all three so no importer's path
7
7
  // or symbol changed.
8
+ //
9
+ // It also carries the pre/post-diff producer's contract with its consumers:
10
+ // where its artifact lands, what its conclusion line says, the shapes it
11
+ // returns and the reader for that conclusion line. Moved here by the file-size
12
+ // split that took `pre-post-diff.ts` back under the cap; `pre-post-diff.ts`
13
+ // re-exports every name, so no importer's path or symbol changed either.
8
14
  export class IncompleteFinalReviewError extends Error {
9
15
  code = 'INCOMPLETE_FINAL_REVIEW';
10
16
  constructor(message) {
@@ -12,3 +18,61 @@ export class IncompleteFinalReviewError extends Error {
12
18
  this.name = 'IncompleteFinalReviewError';
13
19
  }
14
20
  }
21
+ /* ------------------------------------------------------------------ *
22
+ * The pre/post-diff producer's contract, in full: its artifact, the
23
+ * conclusion that artifact opens with, the shapes it returns, and the
24
+ * reader for that conclusion. Hoisted verbatim from pre-post-diff.ts
25
+ * (file-size split); pre-post-diff.ts re-exports every name.
26
+ * ------------------------------------------------------------------ */
27
+ /** Path segments (under `.peaks/_runtime/<sessionId>/`) the artifact lands at. */
28
+ export const API_DIFF_ARTIFACT_SEGMENTS = ['final-review', 'api-diff.txt'];
29
+ /**
30
+ * The literal that opens the artifact's conclusion line.
31
+ *
32
+ * Exported because the consumer must be able to test for the CONCLUSION, not
33
+ * for a byte count (F-BLOCK-1BYTE): one byte of `api-diff.txt` satisfied
34
+ * "status: found" while conveying nothing, and the delivery gate it fed then let
35
+ * a `pass` stand on a comparison nobody saw. The producer writes the line this
36
+ * marker opens and `final-review-service.ts` requires it in the delivered
37
+ * bytes, so the two cannot drift apart into the same hole again.
38
+ */
39
+ export const PRE_POST_DIFF_VERDICT_MARKER = 'VERDICT: ';
40
+ /**
41
+ * The three conclusions the artifact may open with, exported as the same
42
+ * literals the verdict writer interpolates.
43
+ *
44
+ * They are constants because reading the conclusion is now part of the
45
+ * consumer's job (F2): the pre/post-diff source is the one source whose
46
+ * conclusion had a machine-readable form all along, and the envelope threw it
47
+ * away — a delivered `STRUCTURAL DRIFT DETECTED` produced `allPass: true` with
48
+ * an empty `needsAttention`. A consumer that must classify the conclusion may
49
+ * only do so against the producer's own literals, never against a re-typed
50
+ * copy of them.
51
+ */
52
+ export const PRE_POST_DIFF_NO_DRIFT = 'NO STRUCTURAL DRIFT';
53
+ export const PRE_POST_DIFF_ADDITIONS_ONLY = 'ADDITIONS ONLY';
54
+ export const PRE_POST_DIFF_DRIFT_DETECTED = 'STRUCTURAL DRIFT DETECTED';
55
+ /**
56
+ * Classify the delivered conclusion. Pure and total: a caller passes the bytes
57
+ * it received (possibly a head slice) and gets back what the artifact says.
58
+ *
59
+ * Only the FIRST `VERDICT:` line is read. The artifact's header promises the
60
+ * verdict "is repeated nowhere" and that it is the file's conclusion, so a
61
+ * later line cannot be the answer, and reading further would let a document's
62
+ * prose masquerade as its conclusion.
63
+ */
64
+ export function classifyPrePostDiffVerdict(content) {
65
+ const line = content
66
+ .split(/\r?\n/)
67
+ .find((candidate) => candidate.startsWith(PRE_POST_DIFF_VERDICT_MARKER));
68
+ if (line === undefined)
69
+ return 'indeterminate';
70
+ const conclusion = line.slice(PRE_POST_DIFF_VERDICT_MARKER.length);
71
+ if (conclusion.startsWith(PRE_POST_DIFF_DRIFT_DETECTED))
72
+ return 'drift-detected';
73
+ if (conclusion.startsWith(PRE_POST_DIFF_ADDITIONS_ONLY))
74
+ return 'additions-only';
75
+ if (conclusion.startsWith(PRE_POST_DIFF_NO_DRIFT))
76
+ return 'no-drift';
77
+ return 'indeterminate';
78
+ }
@@ -6,10 +6,23 @@ import type { DimensionEvidence, DimensionKind } from './final-review-types.js';
6
6
  */
7
7
  export interface UndeliverableDimensionEvidence {
8
8
  readonly dimension: DimensionKind;
9
+ /**
10
+ * Did the reviewer receive a bounded EXCERPT of at least one of these sources?
11
+ *
12
+ * Measured 2026-10-13 on the all-oversized set this report was written for
13
+ * (`qa-test-report` 19,256 B, `qa/test-cases` 42,335 B, `prd-handoff` 28,414 B
14
+ * against a 10,240 cap): the allocator inlined 30,720 bytes — a cap-sized head
15
+ * of each — into the prompt. So "no source can ever be delivered" was true
16
+ * only of WHOLE delivery, and the report read as if the reviewer had been
17
+ * shown nothing. This flag is which of those two facts it is.
18
+ */
19
+ readonly excerptDelivered: boolean;
9
20
  readonly sources: readonly {
10
21
  readonly key: string;
11
22
  readonly relativePath: string;
12
23
  readonly totalBytes: number;
24
+ /** Bytes of this source inlined as an excerpt (0 when none was inlined). */
25
+ readonly excerptBytes: number;
13
26
  }[];
14
27
  }
15
28
  /**
@@ -8,13 +8,15 @@
8
8
  import { isDelivered } from './final-review-service.js';
9
9
  import { MAX_EVIDENCE_BYTES_PER_FILE, REQUIRED_DIMENSIONS } from './final-review-evidence-budget.js';
10
10
  /**
11
- * Can this source EVER be delivered, whatever the budget?
11
+ * Can this source EVER be delivered WHOLE, whatever the budget?
12
12
  *
13
- * `whole` is the only rule with a structural ceiling. Its test is
14
- * `includedBytes === totalBytes`, and the allocator can only ever inline
13
+ * The whole qualifier is the fact: an over-cap source IS delivered, as a
14
+ * bounded excerpt (see `CollectedEvidence.excerpt`). What it can never be is
15
+ * delivered WHOLE, and `whole` is the only rule with a structural ceiling. Its
16
+ * test is `includedBytes === totalBytes`, and the allocator can only ever inline
15
17
  * `min(bytes, MAX_EVIDENCE_BYTES_PER_FILE)` — so a `whole`-rule source LARGER
16
- * than the per-file cap can never be delivered: not on this run, not on any
17
- * run, not with any budget, because the budget is not what cuts it. Raising
18
+ * than the per-file cap is never whole: not on this run, not on any run, not
19
+ * with any budget, because the budget is not what cuts it. Raising
18
20
  * `MAX_EVIDENCE_BYTES_TOTAL` changes nothing either, since the per-file cap is
19
21
  * derived from it and the reservation spends all of it.
20
22
  *
@@ -74,13 +76,16 @@ export function undeliverableDimensions(collected) {
74
76
  continue;
75
77
  if (!onDisk.every(isStructurallyUndeliverable))
76
78
  continue;
79
+ const sources = onDisk.map((item) => ({
80
+ key: item.source.key,
81
+ relativePath: item.relativePath,
82
+ totalBytes: item.totalBytes,
83
+ excerptBytes: item.excerpt ? item.includedBytes : 0
84
+ }));
77
85
  report.push({
78
86
  dimension,
79
- sources: onDisk.map((item) => ({
80
- key: item.source.key,
81
- relativePath: item.relativePath,
82
- totalBytes: item.totalBytes
83
- }))
87
+ excerptDelivered: sources.some((item) => item.excerptBytes > 0),
88
+ sources
84
89
  });
85
90
  }
86
91
  return report;
@@ -108,11 +113,20 @@ export function enforceDeliveryReachability(dimensions, report) {
108
113
  // The ENVELOPE is not byte-capped, so it names the path as well as the
109
114
  // size: the path is what a human has to act on to fix it.
110
115
  const detail = entry.sources
111
- .map((item) => `${item.key} at ${item.relativePath} (${String(item.totalBytes)} bytes)`)
116
+ .map((item) => `${item.key} at ${item.relativePath} (${String(item.totalBytes)} bytes, ${item.excerptBytes > 0
117
+ ? `${String(item.excerptBytes)} inlined as an excerpt, ${String(item.totalBytes - item.excerptBytes)} withheld`
118
+ : 'none inlined'})`)
112
119
  .join(', ');
120
+ // The consequence is measured, not assumed. Saying "no evidence can ever
121
+ // reach the reviewer" while a cap-sized head of every one of these sources
122
+ // sits in the prompt is a claim stronger than the code — the defect class
123
+ // this module keeps closing.
124
+ const consequence = entry.excerptDelivered
125
+ ? 'a bounded EXCERPT of each was inlined, so the reviewer HAS partial evidence for this dimension — but no source for it can be delivered WHOLE, and a head of a file is not the document: the conclusion may be in the part that was cut'
126
+ : 'none of them was inlined, so no evidence for this dimension reached the reviewer at all';
113
127
  const marker = `[delivery-reachability: ${dimension.verdict === 'pass'
114
128
  ? 'verdict downgraded from "pass" to "inconclusive"'
115
- : `gate ran; verdict "${dimension.verdict}" is already non-"pass" and is left unchanged`} — EVERY source on disk that supports "${dimension.dimension}" (${detail}) is larger than the per-file delivery cap of ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes, and a source is inlined WHOLE or not at all, so no evidence for this dimension can ever reach the reviewer. The dimension is red by byte arithmetic, not by the reviewer's judgement, and it is listed in needsAttention for that reason.]`;
129
+ : `gate ran; verdict "${dimension.verdict}" is already non-"pass" and is left unchanged`} — EVERY source on disk that supports "${dimension.dimension}" (${detail}) is larger than the per-file delivery cap of ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes, and a source is inlined WHOLE or not at all; ${consequence}. The dimension is red by byte arithmetic, not by the reviewer's judgement, and it is listed in needsAttention for that reason.]`;
116
130
  const annotated = {
117
131
  ...dimension,
118
132
  summary: `${dimension.summary} ${marker}`
@@ -4,9 +4,15 @@
4
4
  // budget allocator, hoisted from final-review-service.ts (C wave 7).
5
5
  // evidenceSourcesFor stays in the service module (guard C pins it there)
6
6
  // and is imported from it — a one-directional edge.
7
+ //
8
+ // The `CollectedEvidence` record builders moved to
9
+ // final-review-evidence-records.ts on 2026-10-13, when this file reached 298 of
10
+ // its 300-line cap. What stays here is the read phase, the floor reservation,
11
+ // the allocator and the two byte helpers — collect → records, one way.
7
12
  import { readFileSync } from 'node:fs';
8
13
  import { join } from 'node:path';
9
14
  import { GATE_SOURCE_FOR_DIMENSION } from './final-review-evidence-sources.js';
15
+ import { blankEvidence, foundEvidence, omittedEvidence, readFailureEvidence } from './final-review-evidence-records.js';
10
16
  import { MAX_EVIDENCE_BYTES_TOTAL, REQUIRED_DIMENSIONS, assertFloorReservationAffordable, sourceUnit } from './final-review-evidence-budget.js';
11
17
  import { evidenceSourcesFor } from './final-review-service.js';
12
18
  /**
@@ -27,7 +33,8 @@ export function readEvidence(projectRoot, sessionId, rid, prePostDiffAvailable)
27
33
  // copy would silently swap the evidence this run reports.
28
34
  const attempts = [
29
35
  source.segments,
30
- ...(source.legacySegments !== undefined ? [source.legacySegments] : [])
36
+ ...(source.legacySegments !== undefined ? [source.legacySegments] : []),
37
+ ...(source.olderSegments ?? [])
31
38
  ];
32
39
  // The path reported when nothing resolved stays the CANONICAL one, so the
33
40
  // operator is sent to where the artifact belongs, not to its old home.
@@ -120,63 +127,11 @@ function floorHolders(candidates) {
120
127
  });
121
128
  return holders;
122
129
  }
123
- function readFailureEvidence(base, candidate) {
124
- // `read` is never `'ok'` here (it is set exactly when the read failed),
125
- // and `'ok'` is not a status — the branch is what says which of the two
126
- // failure facts this is.
127
- const status = candidate.read === 'unreadable' ? 'unreadable' : 'missing';
128
- return {
129
- ...base,
130
- status,
131
- totalBytes: 0,
132
- includedBytes: 0,
133
- content: '',
134
- reason: candidate.read === 'missing'
135
- ? candidate.error
136
- : `the file exists but could not be read (${candidate.error})`
137
- };
138
- }
139
- function blankEvidence(base, raw) {
140
- return {
141
- ...base,
142
- status: 'empty',
143
- totalBytes: raw.byteLength,
144
- includedBytes: 0,
145
- content: '',
146
- reason: `file exists but contains no reviewable content (${raw.byteLength} bytes)`
147
- };
148
- }
149
- function omittedEvidence(base, raw, ctx) {
150
- const { allowance, budgetLeft, candidates, holders, pending, reservedElsewhere, unit, index } = ctx;
151
- const waiting = [...pending]
152
- .filter((holder) => holder !== index)
153
- .map((holder) => `${holders.get(holder)} (source ${candidates[holder]?.source.key ?? '?'})`);
154
- return {
155
- ...base,
156
- status: 'omitted',
157
- totalBytes: raw.byteLength,
158
- includedBytes: 0,
159
- content: '',
160
- reason: reservedElsewhere > 0
161
- ? `${reservedElsewhere} bytes of the budget are reserved for dimension(s) ${waiting.join(', ')} — their only remaining evidence comes later in the source order; this source is inlined WHOLE or not at all and needs ${unit} bytes, while ${budgetLeft} were left (${allowance} after the reservation)`
162
- : `total evidence budget (${MAX_EVIDENCE_BYTES_TOTAL} bytes) is exhausted — this source is inlined WHOLE or not at all and needs ${unit} bytes, ${budgetLeft} were left`
163
- };
164
- }
165
130
  function reservedForPending(pending, units, index) {
166
131
  return [...pending]
167
132
  .filter((holder) => holder !== index)
168
133
  .reduce((sum, holder) => sum + (units[holder] ?? 0), 0);
169
134
  }
170
- function foundEvidence(base, raw, unit, content) {
171
- return {
172
- ...base,
173
- status: 'found',
174
- totalBytes: raw.byteLength,
175
- includedBytes: unit,
176
- content,
177
- reason: ''
178
- };
179
- }
180
135
  export function collectEvidence(projectRoot, sessionId, rid, prePostDiffAvailable) {
181
136
  assertFloorReservationAffordable();
182
137
  const candidates = readEvidence(projectRoot, sessionId, rid, prePostDiffAvailable);
@@ -0,0 +1,21 @@
1
+ import type { CollectedEvidence, EvidenceCandidate, EvidenceSource } from './final-review-evidence-sources.js';
2
+ import type { DimensionKind } from './final-review-types.js';
3
+ export interface EvidenceBase {
4
+ readonly source: EvidenceSource;
5
+ readonly relativePath: string;
6
+ readonly absolutePath: string;
7
+ }
8
+ export declare function readFailureEvidence(base: EvidenceBase, candidate: EvidenceCandidate): CollectedEvidence;
9
+ export declare function blankEvidence(base: EvidenceBase, raw: Buffer): CollectedEvidence;
10
+ export interface OmissionContext {
11
+ readonly budgetLeft: number;
12
+ readonly allowance: number;
13
+ readonly holders: ReadonlyMap<number, DimensionKind>;
14
+ readonly pending: Set<number>;
15
+ readonly reservedElsewhere: number;
16
+ readonly unit: number;
17
+ readonly candidates: readonly EvidenceCandidate[];
18
+ readonly index: number;
19
+ }
20
+ export declare function omittedEvidence(base: EvidenceBase, raw: Buffer, ctx: OmissionContext): CollectedEvidence;
21
+ export declare function foundEvidence(base: EvidenceBase, raw: Buffer, unit: number, content: string): CollectedEvidence;