peaks-loop 4.1.3 → 4.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) hide show
  1. package/.claude-plugin/marketplace.json +7 -2
  2. package/CHANGELOG.md +168 -0
  3. package/README-en.md +1 -1
  4. package/README.md +1 -1
  5. package/dist/cli/cli-helpers.d.ts +20 -0
  6. package/dist/cli/cli-helpers.js +34 -0
  7. package/dist/cli/commands/_register.js +2 -0
  8. package/dist/cli/commands/asset-command-shared.d.ts +12 -0
  9. package/dist/cli/commands/asset-command-shared.js +45 -0
  10. package/dist/cli/commands/asset-commands.d.ts +6 -1
  11. package/dist/cli/commands/asset-commands.js +11 -372
  12. package/dist/cli/commands/asset-crystallize-command.d.ts +3 -0
  13. package/dist/cli/commands/asset-crystallize-command.js +60 -0
  14. package/dist/cli/commands/asset-crystallize-payload.d.ts +47 -0
  15. package/dist/cli/commands/asset-crystallize-payload.js +85 -0
  16. package/dist/cli/commands/asset-crystallize-runner.d.ts +3 -0
  17. package/dist/cli/commands/asset-crystallize-runner.js +133 -0
  18. package/dist/cli/commands/asset-dispose-command.d.ts +3 -0
  19. package/dist/cli/commands/asset-dispose-command.js +99 -0
  20. package/dist/cli/commands/asset-status-command.d.ts +3 -0
  21. package/dist/cli/commands/asset-status-command.js +100 -0
  22. package/dist/cli/commands/baseline-audit-command.d.ts +3 -0
  23. package/dist/cli/commands/baseline-audit-command.js +64 -0
  24. package/dist/cli/commands/baseline-command-shared.d.ts +23 -0
  25. package/dist/cli/commands/baseline-command-shared.js +39 -0
  26. package/dist/cli/commands/baseline-commands.js +33 -313
  27. package/dist/cli/commands/baseline-freeze-commands.d.ts +4 -0
  28. package/dist/cli/commands/baseline-freeze-commands.js +81 -0
  29. package/dist/cli/commands/baseline-guard-command.d.ts +3 -0
  30. package/dist/cli/commands/baseline-guard-command.js +52 -0
  31. package/dist/cli/commands/baseline-read-commands.d.ts +5 -0
  32. package/dist/cli/commands/baseline-read-commands.js +72 -0
  33. package/dist/cli/commands/baseline-rollback-commands.d.ts +4 -0
  34. package/dist/cli/commands/baseline-rollback-commands.js +88 -0
  35. package/dist/cli/commands/classify-downgrade-command.d.ts +9 -0
  36. package/dist/cli/commands/classify-downgrade-command.js +21 -0
  37. package/dist/cli/commands/classify-run-command.d.ts +9 -0
  38. package/dist/cli/commands/classify-run-command.js +73 -0
  39. package/dist/cli/commands/classify-signals.d.ts +5 -0
  40. package/dist/cli/commands/classify-signals.js +104 -0
  41. package/dist/cli/commands/code-commands.d.ts +6 -4
  42. package/dist/cli/commands/code-commands.js +6 -4
  43. package/dist/cli/commands/code-emit-handoff-command.js +40 -3
  44. package/dist/cli/commands/code-gate-command.d.ts +5 -5
  45. package/dist/cli/commands/code-gate-command.js +49 -9
  46. package/dist/cli/commands/code-gate-step-08-command.js +25 -9
  47. package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
  48. package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
  49. package/dist/cli/commands/codegraph-command-options.d.ts +22 -0
  50. package/dist/cli/commands/codegraph-command-options.js +22 -0
  51. package/dist/cli/commands/codegraph-commands.d.ts +2 -2
  52. package/dist/cli/commands/codegraph-commands.js +14 -397
  53. package/dist/cli/commands/codegraph-config-restore-command.d.ts +3 -0
  54. package/dist/cli/commands/codegraph-config-restore-command.js +200 -0
  55. package/dist/cli/commands/codegraph-proxy-commands.d.ts +10 -0
  56. package/dist/cli/commands/codegraph-proxy-commands.js +159 -0
  57. package/dist/cli/commands/codegraph-repair-commands.d.ts +3 -0
  58. package/dist/cli/commands/codegraph-repair-commands.js +94 -0
  59. package/dist/cli/commands/codegraph-status-command.d.ts +1 -1
  60. package/dist/cli/commands/codegraph-status-command.js +27 -214
  61. package/dist/cli/commands/codegraph-status-integrity.d.ts +44 -0
  62. package/dist/cli/commands/codegraph-status-integrity.js +121 -0
  63. package/dist/cli/commands/codegraph-status-json.d.ts +5 -0
  64. package/dist/cli/commands/codegraph-status-json.js +127 -0
  65. package/dist/cli/commands/container-command-shared.d.ts +60 -0
  66. package/dist/cli/commands/container-command-shared.js +52 -0
  67. package/dist/cli/commands/container-commands.d.ts +1 -1
  68. package/dist/cli/commands/container-commands.js +4 -216
  69. package/dist/cli/commands/container-release-command.d.ts +3 -0
  70. package/dist/cli/commands/container-release-command.js +105 -0
  71. package/dist/cli/commands/container-spawn-command.d.ts +3 -0
  72. package/dist/cli/commands/container-spawn-command.js +148 -0
  73. package/dist/cli/commands/context-check-command.d.ts +3 -0
  74. package/dist/cli/commands/context-check-command.js +81 -0
  75. package/dist/cli/commands/context-commands.d.ts +2 -7
  76. package/dist/cli/commands/context-commands.js +6 -276
  77. package/dist/cli/commands/context-layer-command.d.ts +3 -0
  78. package/dist/cli/commands/context-layer-command.js +34 -0
  79. package/dist/cli/commands/context-layer-fetchers.d.ts +15 -0
  80. package/dist/cli/commands/context-layer-fetchers.js +162 -0
  81. package/dist/cli/commands/context-status-command.d.ts +17 -0
  82. package/dist/cli/commands/context-status-command.js +41 -0
  83. package/dist/cli/commands/contract-write-command.d.ts +3 -0
  84. package/dist/cli/commands/contract-write-command.js +144 -0
  85. package/dist/cli/commands/core/doctor-bindings.d.ts +17 -0
  86. package/dist/cli/commands/core/doctor-bindings.js +30 -0
  87. package/dist/cli/commands/core/doctor-command.d.ts +4 -18
  88. package/dist/cli/commands/core/doctor-command.js +2 -323
  89. package/dist/cli/commands/core/doctor-logs.d.ts +8 -0
  90. package/dist/cli/commands/core/doctor-logs.js +32 -0
  91. package/dist/cli/commands/core/doctor-probes.d.ts +3 -0
  92. package/dist/cli/commands/core/doctor-probes.js +55 -0
  93. package/dist/cli/commands/core/doctor-run-command.d.ts +12 -0
  94. package/dist/cli/commands/core/doctor-run-command.js +172 -0
  95. package/dist/cli/commands/core/doctor-summary.d.ts +7 -0
  96. package/dist/cli/commands/core/doctor-summary.js +39 -0
  97. package/dist/cli/commands/core/memory-command-shared.d.ts +25 -0
  98. package/dist/cli/commands/core/memory-command-shared.js +20 -0
  99. package/dist/cli/commands/core/memory-command.d.ts +1 -1
  100. package/dist/cli/commands/core/memory-command.js +6 -227
  101. package/dist/cli/commands/core/memory-delegated-verbs.d.ts +4 -0
  102. package/dist/cli/commands/core/memory-delegated-verbs.js +178 -0
  103. package/dist/cli/commands/core/memory-extract-command.d.ts +3 -0
  104. package/dist/cli/commands/core/memory-extract-command.js +95 -0
  105. package/dist/cli/commands/core/memory-sync-command.d.ts +3 -0
  106. package/dist/cli/commands/core/memory-sync-command.js +38 -0
  107. package/dist/cli/commands/core/session-command.d.ts +1 -1
  108. package/dist/cli/commands/core/session-command.js +12 -206
  109. package/dist/cli/commands/core/session-info-command.d.ts +3 -0
  110. package/dist/cli/commands/core/session-info-command.js +142 -0
  111. package/dist/cli/commands/core/session-verb-commands.d.ts +5 -0
  112. package/dist/cli/commands/core/session-verb-commands.js +58 -0
  113. package/dist/cli/commands/core/standards-command.d.ts +1 -24
  114. package/dist/cli/commands/core/standards-command.js +33 -201
  115. package/dist/cli/commands/core/standards-init-command.d.ts +3 -0
  116. package/dist/cli/commands/core/standards-init-command.js +87 -0
  117. package/dist/cli/commands/core/standards-lint.d.ts +24 -0
  118. package/dist/cli/commands/core/standards-lint.js +57 -0
  119. package/dist/cli/commands/core/standards-migrate-command.d.ts +3 -0
  120. package/dist/cli/commands/core/standards-migrate-command.js +57 -0
  121. package/dist/cli/commands/cron-scheduler-commands.d.ts +5 -1
  122. package/dist/cli/commands/cron-scheduler-commands.js +36 -206
  123. package/dist/cli/commands/cron-scheduler-run-once-command.d.ts +7 -0
  124. package/dist/cli/commands/cron-scheduler-run-once-command.js +35 -0
  125. package/dist/cli/commands/cron-scheduler-shared.d.ts +6 -0
  126. package/dist/cli/commands/cron-scheduler-shared.js +48 -0
  127. package/dist/cli/commands/cron-scheduler-start-command.d.ts +7 -0
  128. package/dist/cli/commands/cron-scheduler-start-command.js +65 -0
  129. package/dist/cli/commands/cron-scheduler-status-command.d.ts +7 -0
  130. package/dist/cli/commands/cron-scheduler-status-command.js +46 -0
  131. package/dist/cli/commands/cron-scheduler-stop-command.d.ts +7 -0
  132. package/dist/cli/commands/cron-scheduler-stop-command.js +61 -0
  133. package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
  134. package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
  135. package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
  136. package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
  137. package/dist/cli/commands/dispatch-commands.js +12 -5
  138. package/dist/cli/commands/dispatch-dag-envelope.d.ts +41 -0
  139. package/dist/cli/commands/dispatch-dag-envelope.js +49 -0
  140. package/dist/cli/commands/dispatch-dag-failure.d.ts +18 -0
  141. package/dist/cli/commands/dispatch-dag-failure.js +16 -0
  142. package/dist/cli/commands/dispatch-dag-preflight.d.ts +51 -0
  143. package/dist/cli/commands/dispatch-dag-preflight.js +105 -0
  144. package/dist/cli/commands/dispatch-dag-runners.d.ts +48 -0
  145. package/dist/cli/commands/dispatch-dag-runners.js +73 -0
  146. package/dist/cli/commands/dispatch-from-dag.d.ts +27 -0
  147. package/dist/cli/commands/dispatch-from-dag.js +87 -257
  148. package/dist/cli/commands/dispatch-preflight.js +46 -0
  149. package/dist/cli/commands/dispatch-prompt-composition.d.ts +6 -0
  150. package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
  151. package/dist/cli/commands/doc-commands.js +1 -1
  152. package/dist/cli/commands/feedback-commands-helpers.js +1 -1
  153. package/dist/cli/commands/final-review-command-envelopes.d.ts +44 -0
  154. package/dist/cli/commands/final-review-command-envelopes.js +100 -0
  155. package/dist/cli/commands/final-review-command-shared.d.ts +52 -0
  156. package/dist/cli/commands/final-review-command-shared.js +35 -0
  157. package/dist/cli/commands/final-review-commands.d.ts +7 -27
  158. package/dist/cli/commands/final-review-commands.js +13 -240
  159. package/dist/cli/commands/final-review-prepare-command.d.ts +3 -0
  160. package/dist/cli/commands/final-review-prepare-command.js +221 -0
  161. package/dist/cli/commands/gate-commands-enforce.js +3 -3
  162. package/dist/cli/commands/governance-classify-contract-commands.d.ts +23 -9
  163. package/dist/cli/commands/governance-classify-contract-commands.js +26 -269
  164. package/dist/cli/commands/hook-handle.js +41 -20
  165. package/dist/cli/commands/hooks-command-shared.d.ts +42 -0
  166. package/dist/cli/commands/hooks-command-shared.js +32 -0
  167. package/dist/cli/commands/hooks-commands.d.ts +20 -0
  168. package/dist/cli/commands/hooks-commands.js +75 -309
  169. package/dist/cli/commands/hooks-install-envelopes.d.ts +6 -0
  170. package/dist/cli/commands/hooks-install-envelopes.js +144 -0
  171. package/dist/cli/commands/hooks-status-command.d.ts +3 -0
  172. package/dist/cli/commands/hooks-status-command.js +93 -0
  173. package/dist/cli/commands/hooks-uninstall-command.d.ts +3 -0
  174. package/dist/cli/commands/hooks-uninstall-command.js +43 -0
  175. package/dist/cli/commands/lint-commands.js +3 -1
  176. package/dist/cli/commands/loop-command-shared.d.ts +31 -0
  177. package/dist/cli/commands/loop-command-shared.js +15 -0
  178. package/dist/cli/commands/loop-commands.d.ts +12 -17
  179. package/dist/cli/commands/loop-commands.js +56 -238
  180. package/dist/cli/commands/loop-eval-capture-index.js +2 -4
  181. package/dist/cli/commands/loop-export-command.d.ts +3 -0
  182. package/dist/cli/commands/loop-export-command.js +73 -0
  183. package/dist/cli/commands/loop-goal-compose-command.d.ts +3 -0
  184. package/dist/cli/commands/loop-goal-compose-command.js +36 -0
  185. package/dist/cli/commands/loop-import-command.d.ts +3 -0
  186. package/dist/cli/commands/loop-import-command.js +86 -0
  187. package/dist/cli/commands/loop-placeholder-commands.d.ts +3 -0
  188. package/dist/cli/commands/loop-placeholder-commands.js +52 -0
  189. package/dist/cli/commands/memory-command-shared.d.ts +59 -0
  190. package/dist/cli/commands/memory-command-shared.js +39 -0
  191. package/dist/cli/commands/memory-commands.d.ts +6 -79
  192. package/dist/cli/commands/memory-commands.js +19 -309
  193. package/dist/cli/commands/memory-ingest-command.d.ts +3 -0
  194. package/dist/cli/commands/memory-ingest-command.js +50 -0
  195. package/dist/cli/commands/memory-list-command.d.ts +16 -0
  196. package/dist/cli/commands/memory-list-command.js +129 -0
  197. package/dist/cli/commands/memory-reindex-command.d.ts +9 -0
  198. package/dist/cli/commands/memory-reindex-command.js +78 -0
  199. package/dist/cli/commands/memory-rotate-command.d.ts +3 -0
  200. package/dist/cli/commands/memory-rotate-command.js +55 -0
  201. package/dist/cli/commands/memory-search-command.d.ts +7 -0
  202. package/dist/cli/commands/memory-search-command.js +46 -0
  203. package/dist/cli/commands/openspec-archive-command.d.ts +3 -0
  204. package/dist/cli/commands/openspec-archive-command.js +55 -0
  205. package/dist/cli/commands/openspec-command-shared.d.ts +62 -0
  206. package/dist/cli/commands/openspec-command-shared.js +135 -0
  207. package/dist/cli/commands/openspec-commands.d.ts +1 -1
  208. package/dist/cli/commands/openspec-commands.js +33 -306
  209. package/dist/cli/commands/openspec-from-doctor-command.d.ts +3 -0
  210. package/dist/cli/commands/openspec-from-doctor-command.js +66 -0
  211. package/dist/cli/commands/openspec-init-command.d.ts +3 -0
  212. package/dist/cli/commands/openspec-init-command.js +49 -0
  213. package/dist/cli/commands/openspec-list-command.d.ts +3 -0
  214. package/dist/cli/commands/openspec-list-command.js +27 -0
  215. package/dist/cli/commands/openspec-render-command.d.ts +3 -0
  216. package/dist/cli/commands/openspec-render-command.js +33 -0
  217. package/dist/cli/commands/openspec-show-command.d.ts +3 -0
  218. package/dist/cli/commands/openspec-show-command.js +33 -0
  219. package/dist/cli/commands/openspec-to-rd-command.d.ts +3 -0
  220. package/dist/cli/commands/openspec-to-rd-command.js +33 -0
  221. package/dist/cli/commands/openspec-validate-command.d.ts +3 -0
  222. package/dist/cli/commands/openspec-validate-command.js +45 -0
  223. package/dist/cli/commands/perf-audit-commands.js +15 -5
  224. package/dist/cli/commands/playwright-browser-command.d.ts +8 -0
  225. package/dist/cli/commands/playwright-browser-command.js +61 -0
  226. package/dist/cli/commands/playwright-commands.d.ts +10 -62
  227. package/dist/cli/commands/playwright-commands.js +77 -400
  228. package/dist/cli/commands/playwright-envelope.d.ts +8 -0
  229. package/dist/cli/commands/playwright-envelope.js +29 -0
  230. package/dist/cli/commands/playwright-ls-stop-commands.d.ts +4 -0
  231. package/dist/cli/commands/playwright-ls-stop-commands.js +74 -0
  232. package/dist/cli/commands/playwright-session-store.d.ts +65 -0
  233. package/dist/cli/commands/playwright-session-store.js +189 -0
  234. package/dist/cli/commands/project-commands.d.ts +19 -0
  235. package/dist/cli/commands/project-commands.js +101 -259
  236. package/dist/cli/commands/project-context-command.d.ts +3 -0
  237. package/dist/cli/commands/project-context-command.js +44 -0
  238. package/dist/cli/commands/project-dashboard-command.d.ts +3 -0
  239. package/dist/cli/commands/project-dashboard-command.js +74 -0
  240. package/dist/cli/commands/project-knowledge-command.d.ts +3 -0
  241. package/dist/cli/commands/project-knowledge-command.js +48 -0
  242. package/dist/cli/commands/project-memories-show-command.d.ts +3 -0
  243. package/dist/cli/commands/project-memories-show-command.js +87 -0
  244. package/dist/cli/commands/project-memory-index-command.d.ts +3 -0
  245. package/dist/cli/commands/project-memory-index-command.js +31 -0
  246. package/dist/cli/commands/qa-archive-screenshots-command.d.ts +3 -0
  247. package/dist/cli/commands/qa-archive-screenshots-command.js +53 -0
  248. package/dist/cli/commands/qa-commands.d.ts +14 -87
  249. package/dist/cli/commands/qa-commands.js +17 -315
  250. package/dist/cli/commands/qa-context-prestep.d.ts +1 -0
  251. package/dist/cli/commands/qa-context-prestep.js +34 -0
  252. package/dist/cli/commands/qa-run-command.d.ts +3 -0
  253. package/dist/cli/commands/qa-run-command.js +105 -0
  254. package/dist/cli/commands/qa-run-options.d.ts +23 -0
  255. package/dist/cli/commands/qa-run-options.js +31 -0
  256. package/dist/cli/commands/qa-run-slice.d.ts +41 -0
  257. package/dist/cli/commands/qa-run-slice.js +145 -0
  258. package/dist/cli/commands/race-commands.d.ts +15 -0
  259. package/dist/cli/commands/race-commands.js +65 -0
  260. package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
  261. package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
  262. package/dist/cli/commands/release-canary-command.d.ts +28 -0
  263. package/dist/cli/commands/release-canary-command.js +129 -0
  264. package/dist/cli/commands/release-command-shared.d.ts +13 -0
  265. package/dist/cli/commands/release-command-shared.js +18 -0
  266. package/dist/cli/commands/release-commands.d.ts +10 -18
  267. package/dist/cli/commands/release-commands.js +25 -298
  268. package/dist/cli/commands/release-done-command.d.ts +3 -0
  269. package/dist/cli/commands/release-done-command.js +64 -0
  270. package/dist/cli/commands/release-hotfix-command.d.ts +3 -0
  271. package/dist/cli/commands/release-hotfix-command.js +50 -0
  272. package/dist/cli/commands/release-plan-command.d.ts +3 -0
  273. package/dist/cli/commands/release-plan-command.js +33 -0
  274. package/dist/cli/commands/release-precheck-command.d.ts +3 -0
  275. package/dist/cli/commands/release-precheck-command.js +28 -0
  276. package/dist/cli/commands/release-promote-command.d.ts +3 -0
  277. package/dist/cli/commands/release-promote-command.js +34 -0
  278. package/dist/cli/commands/release-rollback-command.d.ts +3 -0
  279. package/dist/cli/commands/release-rollback-command.js +33 -0
  280. package/dist/cli/commands/release-watch-command.d.ts +3 -0
  281. package/dist/cli/commands/release-watch-command.js +44 -0
  282. package/dist/cli/commands/request-command-options.d.ts +8 -0
  283. package/dist/cli/commands/request-commands.js +2 -0
  284. package/dist/cli/commands/request-init-command.js +67 -12
  285. package/dist/cli/commands/request-retag-command.d.ts +3 -0
  286. package/dist/cli/commands/request-retag-command.js +50 -0
  287. package/dist/cli/commands/request-show-command.d.ts +8 -0
  288. package/dist/cli/commands/request-show-command.js +14 -1
  289. package/dist/cli/commands/request-transition-command.js +12 -4
  290. package/dist/cli/commands/request-transition-failures.d.ts +14 -0
  291. package/dist/cli/commands/request-transition-failures.js +45 -3
  292. package/dist/cli/commands/scan-scope-commands.js +2 -2
  293. package/dist/cli/commands/security-audit-commands.js +26 -6
  294. package/dist/cli/commands/sediment-argv-flags.d.ts +54 -0
  295. package/dist/cli/commands/sediment-argv-flags.js +116 -0
  296. package/dist/cli/commands/sediment-command-shared.d.ts +15 -0
  297. package/dist/cli/commands/sediment-command-shared.js +5 -0
  298. package/dist/cli/commands/sediment-commands.d.ts +35 -59
  299. package/dist/cli/commands/sediment-commands.js +36 -590
  300. package/dist/cli/commands/sediment-pool-commands.d.ts +9 -0
  301. package/dist/cli/commands/sediment-pool-commands.js +185 -0
  302. package/dist/cli/commands/sediment-query-commands.d.ts +4 -0
  303. package/dist/cli/commands/sediment-query-commands.js +94 -0
  304. package/dist/cli/commands/sediment-release-commands.d.ts +8 -0
  305. package/dist/cli/commands/sediment-release-commands.js +232 -0
  306. package/dist/cli/commands/sop-advance-command.d.ts +3 -0
  307. package/dist/cli/commands/sop-advance-command.js +160 -0
  308. package/dist/cli/commands/sop-check-command.d.ts +3 -0
  309. package/dist/cli/commands/sop-check-command.js +44 -0
  310. package/dist/cli/commands/sop-command-shared.d.ts +23 -0
  311. package/dist/cli/commands/sop-command-shared.js +18 -0
  312. package/dist/cli/commands/sop-commands.d.ts +15 -1
  313. package/dist/cli/commands/sop-commands.js +26 -240
  314. package/dist/cli/commands/sop-init-command.d.ts +3 -0
  315. package/dist/cli/commands/sop-init-command.js +51 -0
  316. package/dist/cli/commands/sop-lint-command.d.ts +3 -0
  317. package/dist/cli/commands/sop-lint-command.js +64 -0
  318. package/dist/cli/commands/sop-register-command.d.ts +3 -0
  319. package/dist/cli/commands/sop-register-command.js +48 -0
  320. package/dist/cli/commands/sop-registry-command.d.ts +3 -0
  321. package/dist/cli/commands/sop-registry-command.js +30 -0
  322. package/dist/cli/commands/statusline-command-shared.d.ts +73 -0
  323. package/dist/cli/commands/statusline-command-shared.js +90 -0
  324. package/dist/cli/commands/statusline-commands.d.ts +1 -19
  325. package/dist/cli/commands/statusline-commands.js +48 -287
  326. package/dist/cli/commands/statusline-compact-command.d.ts +4 -0
  327. package/dist/cli/commands/statusline-compact-command.js +54 -0
  328. package/dist/cli/commands/statusline-install-command.d.ts +3 -0
  329. package/dist/cli/commands/statusline-install-command.js +48 -0
  330. package/dist/cli/commands/statusline-render-command.d.ts +9 -0
  331. package/dist/cli/commands/statusline-render-command.js +55 -0
  332. package/dist/cli/commands/statusline-status-command.d.ts +3 -0
  333. package/dist/cli/commands/statusline-status-command.js +23 -0
  334. package/dist/cli/commands/statusline-uninstall-command.d.ts +3 -0
  335. package/dist/cli/commands/statusline-uninstall-command.js +23 -0
  336. package/dist/cli/commands/test-command-run-helpers.d.ts +27 -0
  337. package/dist/cli/commands/test-command-run-helpers.js +73 -0
  338. package/dist/cli/commands/test-command-runner-resolution.d.ts +57 -0
  339. package/dist/cli/commands/test-command-runner-resolution.js +183 -0
  340. package/dist/cli/commands/test-commands.d.ts +8 -56
  341. package/dist/cli/commands/test-commands.js +26 -249
  342. package/dist/cli/commands/vm-command-shared.d.ts +23 -0
  343. package/dist/cli/commands/vm-command-shared.js +23 -0
  344. package/dist/cli/commands/vm-commands.d.ts +1 -28
  345. package/dist/cli/commands/vm-commands.js +36 -270
  346. package/dist/cli/commands/vm-hypervisor-runtime.d.ts +15 -0
  347. package/dist/cli/commands/vm-hypervisor-runtime.js +64 -0
  348. package/dist/cli/commands/vm-release-command.d.ts +5 -0
  349. package/dist/cli/commands/vm-release-command.js +101 -0
  350. package/dist/cli/commands/vm-spawn-command.d.ts +5 -0
  351. package/dist/cli/commands/vm-spawn-command.js +177 -0
  352. package/dist/cli/commands/web-command-shared.d.ts +12 -0
  353. package/dist/cli/commands/web-command-shared.js +30 -0
  354. package/dist/cli/commands/web-commands.d.ts +7 -14
  355. package/dist/cli/commands/web-commands.js +6 -314
  356. package/dist/cli/commands/web-install-command.d.ts +10 -0
  357. package/dist/cli/commands/web-install-command.js +116 -0
  358. package/dist/cli/commands/web-lifecycle-commands.d.ts +9 -30
  359. package/dist/cli/commands/web-lifecycle-commands.js +14 -322
  360. package/dist/cli/commands/web-login-command.d.ts +14 -0
  361. package/dist/cli/commands/web-login-command.js +189 -0
  362. package/dist/cli/commands/web-op-payload.d.ts +22 -0
  363. package/dist/cli/commands/web-op-payload.js +89 -0
  364. package/dist/cli/commands/web-op-refusals.d.ts +37 -0
  365. package/dist/cli/commands/web-op-refusals.js +73 -0
  366. package/dist/cli/commands/web-op-runner.d.ts +14 -0
  367. package/dist/cli/commands/web-op-runner.js +166 -0
  368. package/dist/cli/commands/web-status-command.d.ts +4 -0
  369. package/dist/cli/commands/web-status-command.js +32 -0
  370. package/dist/cli/commands/web-stop-command.d.ts +10 -0
  371. package/dist/cli/commands/web-stop-command.js +59 -0
  372. package/dist/cli/commands/web-verb-specs.d.ts +18 -0
  373. package/dist/cli/commands/web-verb-specs.js +66 -0
  374. package/dist/cli/commands/workflow-command-shared.d.ts +102 -0
  375. package/dist/cli/commands/workflow-command-shared.js +74 -0
  376. package/dist/cli/commands/workflow-graph-commands.d.ts +3 -0
  377. package/dist/cli/commands/workflow-graph-commands.js +73 -0
  378. package/dist/cli/commands/workflow-init-command.d.ts +3 -0
  379. package/dist/cli/commands/workflow-init-command.js +68 -0
  380. package/dist/cli/commands/workflow-lifecycle-commands.d.ts +9 -59
  381. package/dist/cli/commands/workflow-lifecycle-commands.js +14 -348
  382. package/dist/cli/commands/workflow-node-commands.d.ts +3 -0
  383. package/dist/cli/commands/workflow-node-commands.js +154 -0
  384. package/dist/cli/commands/workflow-terminalize-command.d.ts +3 -0
  385. package/dist/cli/commands/workflow-terminalize-command.js +56 -0
  386. package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
  387. package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
  388. package/dist/services/artifacts/artifact-contract-block.js +212 -0
  389. package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
  390. package/dist/services/artifacts/artifact-prerequisites.js +63 -133
  391. package/dist/services/artifacts/artifact-templates.d.ts +1 -1
  392. package/dist/services/artifacts/artifact-templates.js +17 -10
  393. package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
  394. package/dist/services/artifacts/prerequisite-checks.js +198 -0
  395. package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
  396. package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
  397. package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
  398. package/dist/services/artifacts/request-artifact-metadata.js +44 -0
  399. package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
  400. package/dist/services/artifacts/request-artifact-service.js +23 -51
  401. package/dist/services/artifacts/request-artifact-state-helpers.d.ts +12 -0
  402. package/dist/services/artifacts/request-artifact-state-helpers.js +28 -4
  403. package/dist/services/artifacts/request-retag-service.d.ts +68 -0
  404. package/dist/services/artifacts/request-retag-service.js +125 -0
  405. package/dist/services/artifacts/request-state-order.d.ts +38 -0
  406. package/dist/services/artifacts/request-state-order.js +99 -0
  407. package/dist/services/artifacts/request-type-demand.d.ts +44 -0
  408. package/dist/services/artifacts/request-type-demand.js +71 -0
  409. package/dist/services/audit/audit-goal-service.d.ts +7 -0
  410. package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
  411. package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
  412. package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
  413. package/dist/services/audit/enforcers/code-ban.js +21 -1
  414. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
  415. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
  416. package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
  417. package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
  418. package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
  419. package/dist/services/audit-independent/handoff-readers.js +81 -0
  420. package/dist/services/audit-independent/index.d.ts +6 -1
  421. package/dist/services/audit-independent/index.js +6 -1
  422. package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
  423. package/dist/services/audit-independent/judged-declaration-build.js +73 -0
  424. package/dist/services/audit-independent/judged-declaration-check.d.ts +79 -0
  425. package/dist/services/audit-independent/judged-declaration-check.js +155 -0
  426. package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
  427. package/dist/services/audit-independent/judged-declaration.js +218 -0
  428. package/dist/services/audit-independent/perf-audit-service.js +12 -14
  429. package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
  430. package/dist/services/audit-independent/security-audit-artifact.js +90 -0
  431. package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
  432. package/dist/services/audit-independent/security-audit-service.js +34 -178
  433. package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
  434. package/dist/services/code/auto-compact-artifacts.d.ts +54 -0
  435. package/dist/services/code/auto-compact-artifacts.js +135 -0
  436. package/dist/services/code/auto-compact-attempt.d.ts +46 -0
  437. package/dist/services/code/auto-compact-attempt.js +88 -0
  438. package/dist/services/code/auto-compact-decision.d.ts +74 -0
  439. package/dist/services/code/auto-compact-decision.js +149 -0
  440. package/dist/services/code/auto-compact-dispatch-gate.d.ts +36 -0
  441. package/dist/services/code/auto-compact-dispatch-gate.js +86 -0
  442. package/dist/services/code/auto-compact-envelopes.d.ts +33 -0
  443. package/dist/services/code/auto-compact-envelopes.js +134 -0
  444. package/dist/services/code/auto-compact-history.d.ts +46 -0
  445. package/dist/services/code/auto-compact-history.js +17 -0
  446. package/dist/services/code/auto-compact-orchestrator.d.ts +11 -240
  447. package/dist/services/code/auto-compact-orchestrator.js +165 -686
  448. package/dist/services/code/auto-compact-run-types.d.ts +123 -0
  449. package/dist/services/code/auto-compact-run-types.js +1 -0
  450. package/dist/services/code/emit-handoff.d.ts +35 -1
  451. package/dist/services/code/emit-handoff.js +128 -7
  452. package/dist/services/code/step-08-gate.d.ts +28 -19
  453. package/dist/services/code/step-08-gate.js +92 -35
  454. package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
  455. package/dist/services/config/config-coercion.d.ts +7 -0
  456. package/dist/services/config/config-coercion.js +156 -0
  457. package/dist/services/config/config-file-io.d.ts +11 -0
  458. package/dist/services/config/config-file-io.js +61 -0
  459. package/dist/services/config/config-get.d.ts +2 -0
  460. package/dist/services/config/config-get.js +36 -0
  461. package/dist/services/config/config-global-loader.d.ts +15 -0
  462. package/dist/services/config/config-global-loader.js +111 -0
  463. package/dist/services/config/config-nested-path.d.ts +3 -0
  464. package/dist/services/config/config-nested-path.js +53 -0
  465. package/dist/services/config/config-primitives.d.ts +16 -0
  466. package/dist/services/config/config-primitives.js +24 -0
  467. package/dist/services/config/config-service.d.ts +9 -33
  468. package/dist/services/config/config-service.js +16 -665
  469. package/dist/services/config/config-validation.d.ts +19 -0
  470. package/dist/services/config/config-validation.js +152 -0
  471. package/dist/services/config/config-workspace.d.ts +10 -0
  472. package/dist/services/config/config-workspace.js +158 -0
  473. package/dist/services/context/build-dispatch-system-prompt.d.ts +3 -3
  474. package/dist/services/context/build-dispatch-system-prompt.js +7 -7
  475. package/dist/services/context/collector.js +5 -1
  476. package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
  477. package/dist/services/dispatch/active-dispatch-index.js +118 -0
  478. package/dist/services/dispatch/batch-counter.js +1 -2
  479. package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
  480. package/dist/services/dispatch/dispatch-record-writer.js +58 -100
  481. package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
  482. package/dist/services/dispatch/karpathy-block.d.ts +55 -0
  483. package/dist/services/dispatch/karpathy-block.js +101 -0
  484. package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
  485. package/dist/services/dispatch/ledger-reaper.js +131 -0
  486. package/dist/services/evidence/evidence-generator.js +15 -8
  487. package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
  488. package/dist/services/feedback/feedback-promotion-service.js +30 -35
  489. package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
  490. package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
  491. package/dist/services/feedback/promotion-artifact-missing.js +63 -0
  492. package/dist/services/final-review/final-review-contract.d.ts +95 -4
  493. package/dist/services/final-review/final-review-contract.js +64 -0
  494. package/dist/services/final-review/final-review-delivery.d.ts +13 -0
  495. package/dist/services/final-review/final-review-delivery.js +26 -12
  496. package/dist/services/final-review/final-review-evidence-collect.js +8 -53
  497. package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
  498. package/dist/services/final-review/final-review-evidence-records.js +67 -0
  499. package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
  500. package/dist/services/final-review/final-review-evidence-sources.js +28 -4
  501. package/dist/services/final-review/final-review-prompt.js +19 -6
  502. package/dist/services/final-review/final-review-runner.js +5 -0
  503. package/dist/services/final-review/final-review-service.d.ts +2 -2
  504. package/dist/services/final-review/index.d.ts +1 -1
  505. package/dist/services/final-review/pre-post-diff.d.ts +2 -75
  506. package/dist/services/final-review/pre-post-diff.js +60 -59
  507. package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
  508. package/dist/services/hooks/pre-tool-code-gate.js +21 -2
  509. package/dist/services/hooks/worktree-authorization-gate.js +6 -31
  510. package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
  511. package/dist/services/hooks/worktree-refusal-messages.js +102 -0
  512. package/dist/services/lint/eslint-runner-support.d.ts +1 -1
  513. package/dist/services/lint/eslint-runner-support.js +2 -1
  514. package/dist/services/lint/eslint-runner-types.d.ts +8 -0
  515. package/dist/services/lint/eslint-runner.js +17 -4
  516. package/dist/services/llm/anthropic-runner.js +24 -7
  517. package/dist/services/loop/loop-observability.d.ts +39 -0
  518. package/dist/services/loop/loop-observability.js +55 -0
  519. package/dist/services/loop/monotonic-guard.js +6 -9
  520. package/dist/services/loop/monotonic-runner.js +8 -7
  521. package/dist/services/loop/run-driver.js +18 -22
  522. package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
  523. package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
  524. package/dist/services/memory/project-memory-service/index.d.ts +2 -2
  525. package/dist/services/memory/project-memory-service/index.js +1 -1
  526. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
  527. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
  528. package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
  529. package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
  530. package/dist/services/memory/project-memory-service/types.d.ts +32 -0
  531. package/dist/services/observability/observability-service.d.ts +7 -0
  532. package/dist/services/observability/observability-service.js +2 -1
  533. package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
  534. package/dist/services/prd/gate-evidence-derivation.js +4 -3
  535. package/dist/services/qa/bdd-test-style-verifier.js +22 -8
  536. package/dist/services/race/gate2-evaluator.d.ts +58 -0
  537. package/dist/services/race/gate2-evaluator.js +111 -0
  538. package/dist/services/race/gate2-policy.d.ts +17 -0
  539. package/dist/services/race/gate2-policy.js +31 -0
  540. package/dist/services/race/lane-phase.d.ts +19 -0
  541. package/dist/services/race/lane-phase.js +113 -0
  542. package/dist/services/race/pilot-gate-store.d.ts +67 -0
  543. package/dist/services/race/pilot-gate-store.js +227 -0
  544. package/dist/services/scan/file-size-baseline.d.ts +26 -0
  545. package/dist/services/scan/file-size-baseline.js +150 -0
  546. package/dist/services/scan/file-size-scan.d.ts +42 -3
  547. package/dist/services/scan/file-size-scan.js +58 -42
  548. package/dist/services/scan/type-sanity-service.js +13 -3
  549. package/dist/services/skill/resume-detector.js +3 -3
  550. package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
  551. package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
  552. package/dist/services/skills/hooks-settings-deny-list.d.ts +61 -0
  553. package/dist/services/skills/hooks-settings-deny-list.js +173 -0
  554. package/dist/services/skills/hooks-settings-envelopes.d.ts +20 -0
  555. package/dist/services/skills/hooks-settings-envelopes.js +79 -0
  556. package/dist/services/skills/hooks-settings-file-shape.d.ts +43 -0
  557. package/dist/services/skills/hooks-settings-file-shape.js +207 -0
  558. package/dist/services/skills/hooks-settings-paths.d.ts +34 -0
  559. package/dist/services/skills/hooks-settings-paths.js +75 -0
  560. package/dist/services/skills/hooks-settings-read-installed.d.ts +39 -0
  561. package/dist/services/skills/hooks-settings-read-installed.js +60 -0
  562. package/dist/services/skills/hooks-settings-service.d.ts +13 -213
  563. package/dist/services/skills/hooks-settings-service.js +72 -658
  564. package/dist/services/skills/hooks-settings-types.d.ts +139 -0
  565. package/dist/services/skills/hooks-settings-types.js +1 -0
  566. package/dist/services/skills/presence-lease-order.d.ts +13 -0
  567. package/dist/services/skills/presence-lease-order.js +24 -0
  568. package/dist/services/skills/skill-conformance-service.js +1 -0
  569. package/dist/services/skills/skill-statusline-service.js +4 -7
  570. package/dist/services/slice/slice-check-service.js +8 -8
  571. package/dist/services/workflow/pipeline-verify-gate-support.js +2 -1
  572. package/dist/services/workflow/pipeline-verify-service.js +1 -1
  573. package/dist/services/workflow/workflow-skip-service.d.ts +0 -20
  574. package/dist/services/workflow/workflow-skip-service.js +3 -4
  575. package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
  576. package/dist/services/workspace/claude-settings-retirements.js +112 -0
  577. package/dist/services/workspace/claude-settings-template-merge.d.ts +109 -0
  578. package/dist/services/workspace/claude-settings-template-merge.js +223 -0
  579. package/dist/services/workspace/claude-settings-template.d.ts +79 -87
  580. package/dist/services/workspace/claude-settings-template.js +80 -235
  581. package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
  582. package/dist/services/workspace/reconcile-service.js +0 -1
  583. package/dist/shared/incrementing-number.d.ts +10 -0
  584. package/dist/shared/incrementing-number.js +27 -0
  585. package/package.json +5 -5
  586. package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
  587. package/skills/bee/peaks-prd/SKILL.md +1 -1
  588. package/skills/bee/peaks-qa/SKILL.md +1 -1
  589. package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
  590. package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
  591. package/skills/bee/peaks-rd/SKILL.md +2 -2
  592. package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
  593. package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
  594. package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
  595. package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
  596. package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
  597. package/skills/bee/peaks-reviewer/SKILL.md +1 -1
  598. package/skills/bee/peaks-sc/SKILL.md +1 -1
  599. package/skills/bee/peaks-security-audit/SKILL.md +10 -2
  600. package/skills/bee/peaks-txt/SKILL.md +4 -3
  601. package/skills/bee/peaks-ui/SKILL.md +3 -3
  602. package/skills/peaks-audit/SKILL.md +29 -1
  603. package/skills/peaks-code/SKILL.md +5 -2
  604. package/skills/peaks-code/references/fast-lane-norm.md +42 -0
  605. package/skills/peaks-code/references/fast-mode.md +3 -2
  606. package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
  607. package/skills/peaks-code/references/micro-cycle.md +3 -3
  608. package/skills/peaks-code/references/resume-detection.md +1 -1
  609. package/skills/peaks-code/references/runbook.md +12 -6
  610. package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
  611. package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
  612. package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
  613. package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
  614. package/skills/peaks-code/references/worktree-governance.md +4 -4
  615. package/skills/peaks-content/SKILL.md +1 -1
  616. package/skills/peaks-doctor/SKILL.md +1 -1
  617. package/skills/peaks-final-review/SKILL.md +31 -11
  618. package/skills/peaks-ide/SKILL.md +1 -1
  619. package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
  620. package/skills/peaks-race-code/SKILL.md +185 -0
  621. package/skills/peaks-resume/SKILL.md +1 -1
  622. package/skills/peaks-slice-decompose/SKILL.md +1 -1
  623. package/skills/peaks-solo/SKILL.md +1 -1
  624. package/skills/peaks-sop/SKILL.md +1 -1
  625. package/skills/peaks-status/SKILL.md +1 -1
  626. package/skills/peaks-test/SKILL.md +7 -4
  627. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
  628. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
@@ -0,0 +1,100 @@
1
+ // src/cli/commands/final-review-command-envelopes.ts
2
+ //
3
+ // Every envelope `peaks prepare-final-review` can print, and the error-code
4
+ // mapping behind the failure one. Split out of `final-review-commands.ts`; the
5
+ // codes, messages, data fields and next-action strings are unchanged.
6
+ import { fail, ok } from 'peaks-loop-shared/result';
7
+ import { IncompleteFinalReviewError } from '../../services/final-review/final-review-service.js';
8
+ import { LlmBindingError, LlmRequestError } from '../../services/llm/anthropic-runner.js';
9
+ import { printResult } from '../cli-helpers.js';
10
+ import { emptyFinalReviewData } from './final-review-command-shared.js';
11
+ /** Print one refusal envelope and mark the process failed. */
12
+ export function emitPrepareFailure(io, json, refusal, missingEnv) {
13
+ printResult(io, fail('final-review.prepare', refusal.code, refusal.message, emptyFinalReviewData(refusal.rid, refusal.sessionId, refusal.auditGoalPath, missingEnv), refusal.nextActions), json ?? false);
14
+ process.exitCode = 1;
15
+ }
16
+ /**
17
+ * Stub path: surface a structured "scaffold ready" envelope.
18
+ *
19
+ * The service is NOT called here — the stub runner answers the audit-goal
20
+ * shape, not the 4-dim review shape, so running it through
21
+ * `prepareFinalReview()` would only manufacture a malformed review. The
22
+ * envelope confirms the route is wired end-to-end and reports the audit-goal
23
+ * path the service WOULD read.
24
+ */
25
+ export function emitStubEnvelope(io, rid, goal, json) {
26
+ const data = {
27
+ status: 'scaffold-only',
28
+ rid,
29
+ sessionId: goal.sessionId,
30
+ auditGoalPath: goal.auditGoalPath,
31
+ serviceWired: true,
32
+ providerBinding: 'stub'
33
+ };
34
+ const envelope = ok('final-review.prepare', data, [], [
35
+ 'Stub provider: no 4-dim review was performed. This envelope only proves the route is wired and reachable.',
36
+ `Audit-goal file is present at: ${goal.auditGoalPath}`,
37
+ 'Re-run with `--llm-provider anthropic` to produce a real review.'
38
+ ]);
39
+ printResult(io, envelope, json ?? false);
40
+ }
41
+ /** The success envelope of a real-provider run. */
42
+ export function emitReviewEnvelope(io, result) {
43
+ const { rid, goal, model, review, json } = result;
44
+ const data = {
45
+ status: 'review-complete',
46
+ rid,
47
+ sessionId: goal.sessionId,
48
+ auditGoalPath: goal.auditGoalPath,
49
+ serviceWired: true,
50
+ providerBinding: 'anthropic-messages-api',
51
+ model,
52
+ review
53
+ };
54
+ const envelope = ok('final-review.prepare', data, review.allPass
55
+ ? []
56
+ : [
57
+ `Dimensions needing human attention: ${review.needsAttention.join(', ') || 'none flagged'}.`
58
+ ], [
59
+ `4-dim review produced by anthropic-messages-api (model: ${model}).`,
60
+ `allPass: ${String(review.allPass)}.`
61
+ ]);
62
+ printResult(io, envelope, json ?? false);
63
+ }
64
+ /**
65
+ * Map a thrown error to the CLI's error code. The LLM-layer errors already
66
+ * carry codes precise enough to act on (`LLM_CREDENTIAL_MISSING`,
67
+ * `LLM_REQUEST_FAILED`, …), so they are passed through rather than flattened
68
+ * into one opaque failure.
69
+ */
70
+ export function finalReviewErrorCode(error) {
71
+ if (error instanceof LlmBindingError ||
72
+ error instanceof LlmRequestError ||
73
+ error instanceof IncompleteFinalReviewError) {
74
+ return error.code;
75
+ }
76
+ return 'FINAL_REVIEW_FAILED';
77
+ }
78
+ export function finalReviewNextActions(code) {
79
+ switch (code) {
80
+ case 'LLM_CREDENTIAL_MISSING':
81
+ return [
82
+ 'Export ANTHROPIC_AUTH_TOKEN (or ANTHROPIC_API_KEY) in the environment that launches peaks, then re-run.',
83
+ 'For an offline scaffold instead of a review, re-run with `--llm-provider stub` — it performs NO review.'
84
+ ];
85
+ case 'LLM_MODEL_MISSING':
86
+ return [
87
+ 'Export ANTHROPIC_MODEL (or CLAUDE_CODE_SUBAGENT_MODEL) in the environment that launches peaks, then re-run.'
88
+ ];
89
+ case 'LLM_REQUEST_FAILED':
90
+ return [
91
+ 'Check ANTHROPIC_BASE_URL and network reachability, then re-run — a transport failure produces no review.'
92
+ ];
93
+ case 'INCOMPLETE_FINAL_REVIEW':
94
+ return [
95
+ 'The LLM reply was not valid JSON or omitted a required dimension; re-run so the gate is never read as complete.'
96
+ ];
97
+ default:
98
+ return ['Re-run with `--llm-provider stub` to validate the CLI route without a real LLM.'];
99
+ }
100
+ }
@@ -0,0 +1,52 @@
1
+ import type { FinalReviewOutput } from '../../services/final-review/final-review-types.js';
2
+ /** Whitelist of supported `--llm-provider` values for `peaks prepare-final-review`. */
3
+ export declare const SUPPORTED_LLM_PROVIDERS: readonly ["anthropic", "stub"];
4
+ export type SupportedLlmProvider = (typeof SUPPORTED_LLM_PROVIDERS)[number];
5
+ /**
6
+ * Default stays `stub` (unlike `peaks audit goal`, whose default is the real
7
+ * provider): the scaffold route is what CI and the registered e2e contract
8
+ * exercise without credentials, and the stub envelope is labelled
9
+ * `status: 'scaffold-only'` / `providerBinding: 'stub'` so it can never be
10
+ * read as a review.
11
+ */
12
+ export declare const DEFAULT_LLM_PROVIDER: SupportedLlmProvider;
13
+ export declare function isSupportedLlmProvider(value: string): value is SupportedLlmProvider;
14
+ export type FinalReviewStatus = 'scaffold-only' | 'review-complete' | 'not-applicable';
15
+ /**
16
+ * Which LLM produced this envelope. `unknown` is reserved for failure
17
+ * envelopes, where no binding was ever established.
18
+ */
19
+ export type FinalReviewProviderBinding = 'stub' | 'anthropic-messages-api' | 'unknown';
20
+ export interface FinalReviewData {
21
+ readonly status: FinalReviewStatus;
22
+ readonly rid: string;
23
+ readonly sessionId: string;
24
+ readonly auditGoalPath: string;
25
+ readonly serviceWired: boolean;
26
+ readonly providerBinding: FinalReviewProviderBinding;
27
+ /** Model id the bound provider answered with (real-provider runs only). */
28
+ readonly model?: string;
29
+ /** The 4-dim review the service produced (real-provider runs only). */
30
+ readonly review?: FinalReviewOutput;
31
+ /**
32
+ * Environment variables that were absent when binding failed. Surfaced on
33
+ * `data` because `fail()` redacts `message` through
34
+ * `redactSensitiveErrorMessage`, whose catch-all pattern matches the words
35
+ * `token` / `api_key` and would blank out the very names an operator needs.
36
+ */
37
+ readonly missingEnv?: readonly string[];
38
+ }
39
+ /**
40
+ * Empty placeholder used by `fail()` envelopes. `status` is
41
+ * `'not-applicable'` on the error path so consumers can tell
42
+ * "this is a placeholder on a failure" apart from "this is a real
43
+ * scaffold-only success".
44
+ */
45
+ export declare function emptyFinalReviewData(rid: string, sessionId: string, auditGoalPath: string, missingEnv?: readonly string[]): FinalReviewData;
46
+ export type PrepareFinalReviewOptions = {
47
+ project: string;
48
+ sessionId: string;
49
+ llmProvider?: string;
50
+ base?: string;
51
+ json?: boolean;
52
+ };
@@ -0,0 +1,35 @@
1
+ // src/cli/commands/final-review-command-shared.ts
2
+ //
3
+ // What `peaks prepare-final-review` reports: the envelope's data shape, its
4
+ // provider vocabulary, and the placeholder a failure carries. Split out of
5
+ // `final-review-commands.ts`; every value and every field name is unchanged.
6
+ /** Whitelist of supported `--llm-provider` values for `peaks prepare-final-review`. */
7
+ export const SUPPORTED_LLM_PROVIDERS = ['anthropic', 'stub'];
8
+ /**
9
+ * Default stays `stub` (unlike `peaks audit goal`, whose default is the real
10
+ * provider): the scaffold route is what CI and the registered e2e contract
11
+ * exercise without credentials, and the stub envelope is labelled
12
+ * `status: 'scaffold-only'` / `providerBinding: 'stub'` so it can never be
13
+ * read as a review.
14
+ */
15
+ export const DEFAULT_LLM_PROVIDER = 'stub';
16
+ export function isSupportedLlmProvider(value) {
17
+ return SUPPORTED_LLM_PROVIDERS.includes(value);
18
+ }
19
+ /**
20
+ * Empty placeholder used by `fail()` envelopes. `status` is
21
+ * `'not-applicable'` on the error path so consumers can tell
22
+ * "this is a placeholder on a failure" apart from "this is a real
23
+ * scaffold-only success".
24
+ */
25
+ export function emptyFinalReviewData(rid, sessionId, auditGoalPath, missingEnv) {
26
+ return {
27
+ status: 'not-applicable',
28
+ rid,
29
+ sessionId,
30
+ auditGoalPath,
31
+ serviceWired: false,
32
+ providerBinding: 'unknown',
33
+ ...(missingEnv === undefined ? {} : { missingEnv })
34
+ };
35
+ }
@@ -4,7 +4,8 @@
4
4
  *
5
5
  * Exposes the `prepareFinalReview()` service (W2 T9 on
6
6
  * `feature/slice-topology-multipass`) via the CLI surface. The service
7
- * depends on an injected `LlmRunner`; this file owns the binding:
7
+ * depends on an injected `LlmRunner`; the binding lives in
8
+ * `final-review-prepare-command.ts`:
8
9
  * - `--llm-provider stub` (default) returns a structured "scaffold ready"
9
10
  * envelope WITHOUT calling the service, so CI can verify the route
10
11
  * offline. It performs no review, and says so in every hint it emits.
@@ -23,33 +24,12 @@
23
24
  * - `peaks audit goal` — propose a 6-dim goal from a human need
24
25
  * - `peaks prepare-final-review` — produce a 4-dim review evidence
25
26
  * pack for human acceptance
27
+ *
28
+ * This file is the registration module only; the run body it dispatches to
29
+ * lives in `final-review-prepare-command.ts` and the envelope vocabulary in
30
+ * `final-review-command-shared.ts`.
26
31
  */
27
32
  import type { Command } from 'commander';
28
33
  import { type ProgramIO } from '../cli-helpers.js';
29
- import type { FinalReviewOutput } from '../../services/final-review/final-review-types.js';
30
- export type FinalReviewStatus = 'scaffold-only' | 'review-complete' | 'not-applicable';
31
- /**
32
- * Which LLM produced this envelope. `unknown` is reserved for failure
33
- * envelopes, where no binding was ever established.
34
- */
35
- export type FinalReviewProviderBinding = 'stub' | 'anthropic-messages-api' | 'unknown';
36
- export interface FinalReviewData {
37
- readonly status: FinalReviewStatus;
38
- readonly rid: string;
39
- readonly sessionId: string;
40
- readonly auditGoalPath: string;
41
- readonly serviceWired: boolean;
42
- readonly providerBinding: FinalReviewProviderBinding;
43
- /** Model id the bound provider answered with (real-provider runs only). */
44
- readonly model?: string;
45
- /** The 4-dim review the service produced (real-provider runs only). */
46
- readonly review?: FinalReviewOutput;
47
- /**
48
- * Environment variables that were absent when binding failed. Surfaced on
49
- * `data` because `fail()` redacts `message` through
50
- * `redactSensitiveErrorMessage`, whose catch-all pattern matches the words
51
- * `token` / `api_key` and would blank out the very names an operator needs.
52
- */
53
- readonly missingEnv?: readonly string[];
54
- }
55
34
  export declare function registerFinalReviewCommands(program: Command, io: ProgramIO): void;
35
+ export { emptyFinalReviewData, isSupportedLlmProvider, type FinalReviewData, type FinalReviewProviderBinding, type FinalReviewStatus, type PrepareFinalReviewOptions } from './final-review-command-shared.js';
@@ -4,7 +4,8 @@
4
4
  *
5
5
  * Exposes the `prepareFinalReview()` service (W2 T9 on
6
6
  * `feature/slice-topology-multipass`) via the CLI surface. The service
7
- * depends on an injected `LlmRunner`; this file owns the binding:
7
+ * depends on an injected `LlmRunner`; the binding lives in
8
+ * `final-review-prepare-command.ts`:
8
9
  * - `--llm-provider stub` (default) returns a structured "scaffold ready"
9
10
  * envelope WITHOUT calling the service, so CI can verify the route
10
11
  * offline. It performs no review, and says so in every hint it emits.
@@ -23,91 +24,14 @@
23
24
  * - `peaks audit goal` — propose a 6-dim goal from a human need
24
25
  * - `peaks prepare-final-review` — produce a 4-dim review evidence
25
26
  * pack for human acceptance
27
+ *
28
+ * This file is the registration module only; the run body it dispatches to
29
+ * lives in `final-review-prepare-command.ts` and the envelope vocabulary in
30
+ * `final-review-command-shared.ts`.
26
31
  */
27
- import { existsSync, statSync } from 'node:fs';
28
- import { join, resolve } from 'node:path';
29
- import { REQUEST_ID_PATTERN } from '../../services/artifacts/request-artifact-service.js';
30
- import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
31
- import { fail, ok } from 'peaks-loop-shared/result';
32
- import { createAnthropicRunner, LlmBindingError, LlmRequestError, resolveAnthropicConfig } from '../../services/llm/anthropic-runner.js';
33
- import { IncompleteFinalReviewError, prepareFinalReview } from '../../services/final-review/final-review-service.js';
34
- /** Whitelist of supported `--llm-provider` values for `peaks prepare-final-review`. */
35
- const SUPPORTED_LLM_PROVIDERS = ['anthropic', 'stub'];
36
- /**
37
- * Default stays `stub` (unlike `peaks audit goal`, whose default is the real
38
- * provider): the scaffold route is what CI and the registered e2e contract
39
- * exercise without credentials, and the stub envelope is labelled
40
- * `status: 'scaffold-only'` / `providerBinding: 'stub'` so it can never be
41
- * read as a review.
42
- */
43
- const DEFAULT_LLM_PROVIDER = 'stub';
44
- function isSupportedLlmProvider(value) {
45
- return SUPPORTED_LLM_PROVIDERS.includes(value);
46
- }
47
- /**
48
- * Empty placeholder used by `fail()` envelopes. `status` is
49
- * `'not-applicable'` on the error path so consumers can tell
50
- * "this is a placeholder on a failure" apart from "this is a real
51
- * scaffold-only success".
52
- */
53
- function emptyFinalReviewData(rid, sessionId, auditGoalPath, missingEnv) {
54
- return {
55
- status: 'not-applicable',
56
- rid,
57
- sessionId,
58
- auditGoalPath,
59
- serviceWired: false,
60
- providerBinding: 'unknown',
61
- ...(missingEnv === undefined ? {} : { missingEnv })
62
- };
63
- }
64
- function validateProjectRoot(projectArg) {
65
- const projectRoot = resolve(projectArg);
66
- if (!existsSync(projectRoot)) {
67
- return {
68
- ok: false,
69
- code: 'PROJECT_NOT_FOUND',
70
- message: `project path does not exist: ${projectArg}`
71
- };
72
- }
73
- let stat;
74
- try {
75
- stat = statSync(projectRoot);
76
- }
77
- catch (error) {
78
- return { ok: false, code: 'INVALID_PROJECT', message: getErrorMessage(error) };
79
- }
80
- if (!stat.isDirectory()) {
81
- return {
82
- ok: false,
83
- code: 'INVALID_PROJECT',
84
- message: `project path is not a directory: ${projectArg}`
85
- };
86
- }
87
- return { ok: true, projectRoot };
88
- }
89
- /**
90
- * Validate the session id. Rejects empty, path-traversal (`..`), and
91
- * any segment separator (`/`, `\`) so the caller cannot escape
92
- * `.peaks/_runtime/<sessionId>/audit-goal/` via CLI flags.
93
- */
94
- function validateSessionId(sessionId) {
95
- if (sessionId.length === 0) {
96
- return {
97
- ok: false,
98
- code: 'MISSING_REQUIRED_FLAG',
99
- message: '`--session-id` is required and must be a non-empty string'
100
- };
101
- }
102
- if (sessionId.includes('..') || sessionId.includes('/') || sessionId.includes('\\')) {
103
- return {
104
- ok: false,
105
- code: 'INVALID_SESSION_ID',
106
- message: '`--session-id` must not contain path-traversal or path-separator characters (rejected: "..", "/", "\\")'
107
- };
108
- }
109
- return { ok: true, sessionId };
110
- }
32
+ import { addJsonOption } from '../cli-helpers.js';
33
+ import { DEFAULT_LLM_PROVIDER, SUPPORTED_LLM_PROVIDERS } from './final-review-command-shared.js';
34
+ import { runPrepareFinalReview } from './final-review-prepare-command.js';
111
35
  export function registerFinalReviewCommands(program, io) {
112
36
  addJsonOption(program
113
37
  .command('prepare-final-review <rid>')
@@ -115,159 +39,8 @@ export function registerFinalReviewCommands(program, io) {
115
39
  .requiredOption('--project <path>', 'target project root')
116
40
  .requiredOption('--session-id <sid>', 'session id whose .peaks/_runtime/<sid>/audit-goal/<rid>.json is the approved goal source')
117
41
  .option('--llm-provider <name>', `LLM provider name: ${SUPPORTED_LLM_PROVIDERS.join(' | ')} (default: ${DEFAULT_LLM_PROVIDER} — performs no review)`, DEFAULT_LLM_PROVIDER)
118
- .option('--base <ref>', 'base ref for the pre/post baseline diff (`existing-functionality-intact`); default: merge-base with origin/HEAD, then origin/main, then origin/master, then HEAD~1 — pass this explicitly when none of those resolve')).action(async (rid, options) => {
119
- // 1. Project root must exist and be a directory.
120
- const projectValidation = validateProjectRoot(options.project);
121
- if (!projectValidation.ok) {
122
- printResult(io, fail('final-review.prepare', projectValidation.code, projectValidation.message, emptyFinalReviewData(rid, options.sessionId, ''), ['Verify the project path exists and is a directory']), options.json);
123
- process.exitCode = 1;
124
- return;
125
- }
126
- // 2. Session id must be a safe single-segment string.
127
- const sessionValidation = validateSessionId(options.sessionId);
128
- if (!sessionValidation.ok) {
129
- printResult(io, fail('final-review.prepare', sessionValidation.code, sessionValidation.message, emptyFinalReviewData(rid, options.sessionId, ''), [
130
- 'Pass a non-empty `--session-id` whose value is a single segment (no "..", "/", or "\\")'
131
- ]), options.json);
132
- process.exitCode = 1;
133
- return;
134
- }
135
- // 3. Compute the audit-goal path the service WOULD read. We do this
136
- // in two places: the pre-flight existence check (here) and the
137
- // stub-path envelope (below). The service computes it identically
138
- // at `src/services/final-review/final-review-service.ts:45-52`.
139
- //
140
- // Rid axis. The rid is the CLI positional and it is the FILENAME
141
- // segment below, so it is checked here, at the join. Added 2026-09-14
142
- // (repair R1): this join was a second-slot hole — the `--session-id`
143
- // validation above passed and the rid slot escaped. Found by the
144
- // widened rule D, not by a human reading the file.
145
- if (!REQUEST_ID_PATTERN.test(rid)) {
146
- printResult(io, fail('final-review.prepare', 'RID_INVALID', `Invalid request id: ${rid} (expected letters, digits, dots, underscores, or dashes)`, emptyFinalReviewData(rid, options.sessionId, ''), ['Pass the rid of the slice, e.g. 2026-09-14-some-slug']), options.json);
147
- process.exitCode = 1;
148
- return;
149
- }
150
- const auditGoalPath = join(projectValidation.projectRoot, '.peaks', '_runtime', sessionValidation.sessionId, 'audit-goal', `${rid}.json`);
151
- // 4. Pre-flight: if the audit-goal file is missing, surface a 404
152
- // BEFORE the stub/provider check so the caller learns the real
153
- // reason their request can't proceed.
154
- if (!existsSync(auditGoalPath)) {
155
- printResult(io, fail('final-review.prepare', 'AUDIT_GOAL_NOT_FOUND', `audit-goal file not found at expected path: ${auditGoalPath}`, emptyFinalReviewData(rid, sessionValidation.sessionId, auditGoalPath), [
156
- 'Run `peaks audit goal --project <path> --need <text>` first to produce the approved goal JSON.',
157
- 'Confirm `--session-id` matches the session that wrote the goal.'
158
- ]), options.json);
159
- process.exitCode = 1;
160
- return;
161
- }
162
- // 5. Provider check: unknown names fail loudly — a silent fallback to
163
- // `stub` would hand the caller a scaffold envelope that reads as a
164
- // review route, which is the defect class this gate exists to stop.
165
- const provider = options.llmProvider ?? DEFAULT_LLM_PROVIDER;
166
- if (!isSupportedLlmProvider(provider)) {
167
- printResult(io, fail('final-review.prepare', 'LLM_PROVIDER_NOT_IMPLEMENTED', `LLM provider "${provider}" is not implemented. Supported providers: ${SUPPORTED_LLM_PROVIDERS.join(', ')}.`, emptyFinalReviewData(rid, sessionValidation.sessionId, auditGoalPath), [
168
- `Re-run with \`--llm-provider anthropic\` for a real 4-dim review, or \`--llm-provider ${DEFAULT_LLM_PROVIDER}\` for an offline scaffold.`
169
- ]), options.json);
170
- process.exitCode = 1;
171
- return;
172
- }
173
- // 6. Stub path: surface a structured "scaffold ready" envelope.
174
- // We DO NOT call the service here — the stub runner answers the
175
- // audit-goal shape, not the 4-dim review shape, so running it through
176
- // `prepareFinalReview()` would only manufacture a malformed review.
177
- // The envelope confirms the route is wired end-to-end and reports the
178
- // audit-goal path the service WOULD read.
179
- if (provider === 'stub') {
180
- const data = {
181
- status: 'scaffold-only',
182
- rid,
183
- sessionId: sessionValidation.sessionId,
184
- auditGoalPath,
185
- serviceWired: true,
186
- providerBinding: 'stub'
187
- };
188
- const envelope = ok('final-review.prepare', data, [], [
189
- 'Stub provider: no 4-dim review was performed. This envelope only proves the route is wired and reachable.',
190
- `Audit-goal file is present at: ${auditGoalPath}`,
191
- 'Re-run with `--llm-provider anthropic` to produce a real review.'
192
- ]);
193
- printResult(io, envelope, options.json);
194
- return;
195
- }
196
- // 7. Real provider path: bind a real `LlmRunner` and run the service.
197
- // Binding happens INSIDE the try so an absent credential surfaces as
198
- // `LlmBindingError`'s own code instead of escaping as a crash. No
199
- // envelope is emitted on that path — a "successful" empty review would
200
- // be worse than an error.
201
- try {
202
- const config = resolveAnthropicConfig();
203
- const llmRunner = createAnthropicRunner(config);
204
- const review = await prepareFinalReview(rid, {
205
- projectRoot: projectValidation.projectRoot,
206
- sessionId: sessionValidation.sessionId,
207
- llmRunner,
208
- ...(options.base === undefined ? {} : { baseRef: options.base })
209
- });
210
- const data = {
211
- status: 'review-complete',
212
- rid,
213
- sessionId: sessionValidation.sessionId,
214
- auditGoalPath,
215
- serviceWired: true,
216
- providerBinding: 'anthropic-messages-api',
217
- model: config.model,
218
- review
219
- };
220
- const envelope = ok('final-review.prepare', data, review.allPass
221
- ? []
222
- : [
223
- `Dimensions needing human attention: ${review.needsAttention.join(', ') || 'none flagged'}.`
224
- ], [
225
- `4-dim review produced by anthropic-messages-api (model: ${config.model}).`,
226
- `allPass: ${String(review.allPass)}.`
227
- ]);
228
- printResult(io, envelope, options.json);
229
- }
230
- catch (error) {
231
- const code = finalReviewErrorCode(error);
232
- printResult(io, fail('final-review.prepare', code, getErrorMessage(error), emptyFinalReviewData(rid, sessionValidation.sessionId, auditGoalPath, error instanceof LlmBindingError ? error.missingEnv : undefined), finalReviewNextActions(code)), options.json);
233
- process.exitCode = 1;
234
- }
235
- });
236
- }
237
- /**
238
- * Map a thrown error to the CLI's error code. The LLM-layer errors already
239
- * carry codes precise enough to act on (`LLM_CREDENTIAL_MISSING`,
240
- * `LLM_REQUEST_FAILED`, …), so they are passed through rather than flattened
241
- * into one opaque failure.
242
- */
243
- function finalReviewErrorCode(error) {
244
- if (error instanceof LlmBindingError ||
245
- error instanceof LlmRequestError ||
246
- error instanceof IncompleteFinalReviewError) {
247
- return error.code;
248
- }
249
- return 'FINAL_REVIEW_FAILED';
250
- }
251
- function finalReviewNextActions(code) {
252
- switch (code) {
253
- case 'LLM_CREDENTIAL_MISSING':
254
- return [
255
- 'Export ANTHROPIC_AUTH_TOKEN (or ANTHROPIC_API_KEY) in the environment that launches peaks, then re-run.',
256
- 'For an offline scaffold instead of a review, re-run with `--llm-provider stub` — it performs NO review.'
257
- ];
258
- case 'LLM_MODEL_MISSING':
259
- return [
260
- 'Export ANTHROPIC_MODEL (or CLAUDE_CODE_SUBAGENT_MODEL) in the environment that launches peaks, then re-run.'
261
- ];
262
- case 'LLM_REQUEST_FAILED':
263
- return [
264
- 'Check ANTHROPIC_BASE_URL and network reachability, then re-run — a transport failure produces no review.'
265
- ];
266
- case 'INCOMPLETE_FINAL_REVIEW':
267
- return [
268
- 'The LLM reply was not valid JSON or omitted a required dimension; re-run so the gate is never read as complete.'
269
- ];
270
- default:
271
- return ['Re-run with `--llm-provider stub` to validate the CLI route without a real LLM.'];
272
- }
42
+ .option('--base <ref>', 'base ref for the pre/post baseline diff (`existing-functionality-intact`); default: merge-base with origin/HEAD, then origin/main, then origin/master, then HEAD~1 — pass this explicitly when none of those resolve')).action((rid, options) => runPrepareFinalReview(rid, options, io));
273
43
  }
44
+ // Re-export for tests / external consumers: the envelope vocabulary and the
45
+ // types this command's surface is documented with.
46
+ export { emptyFinalReviewData, isSupportedLlmProvider } from './final-review-command-shared.js';
@@ -0,0 +1,3 @@
1
+ import { type ProgramIO } from '../cli-helpers.js';
2
+ import { type PrepareFinalReviewOptions } from './final-review-command-shared.js';
3
+ export declare function runPrepareFinalReview(rid: string, options: PrepareFinalReviewOptions, io: ProgramIO): Promise<void>;