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,145 @@
1
+ // src/cli/commands/qa-run-slice.ts
2
+ //
3
+ // The pure `peaks qa run` slice: the gate list, the restart detector wiring and
4
+ // the MUT.sig gate, with no commander and no I/O. Extracted from
5
+ // `qa-commands.ts`; the exported names, the gate order and every envelope field
6
+ // are unchanged.
7
+ //
8
+ // The browser-E2E gate is what the restart-loop detector guards, so the slice
9
+ // wires it here: it constructs a `BrowserRestartDetector` (configurable via
10
+ // `--max-browser-restarts` / `--no-restart-detector`) and a `BrowserEventLogger`
11
+ // that writes the per-slice JSONL log to
12
+ // `.peaks/_runtime/<session-id>/qa/browser-events.jsonl`.
13
+ import { join } from 'node:path';
14
+ import { BrowserRestartDetector } from '../../services/qa/browser-restart-detector.js';
15
+ import { BrowserEventLogger } from '../../services/qa/browser-event-logger.js';
16
+ import { BROWSER_REUSE_HINT } from '../../services/qa/browser-reuse-hint.js';
17
+ import { isUnsafePathInput } from '../../shared/path-safety.js';
18
+ export const DEFAULT_MAX_BROWSER_RESTARTS = 3;
19
+ export function runQaSlice(input) {
20
+ // Sid axis: this is the join for `qa/browser-events.jsonl`. The `qa gate run`
21
+ // action guards before calling in, but the function is exported for tests and
22
+ // states its own contract at the join.
23
+ if (isUnsafePathInput(input.sessionId)) {
24
+ throw new Error(`Invalid session id: ${input.sessionId} (must be a single path segment)`);
25
+ }
26
+ const detector = new BrowserRestartDetector({
27
+ maxRestarts: input.maxRestarts,
28
+ enabled: input.detectorEnabled
29
+ });
30
+ const logPath = join(input.project, '.peaks', '_runtime', input.sessionId, 'qa', 'browser-events.jsonl');
31
+ const logger = new BrowserEventLogger({ filePath: logPath });
32
+ // PRD AC4 + P1: when browser E2E is off, the detector must NOT record events
33
+ // at all (otherwise a user passing both --no-browser AND a hot detector would
34
+ // see spurious detectorTriggered=true and exit code 2).
35
+ if (input.browserEnabled) {
36
+ recordBrowserEvents(detector, logger, input.events, input.sessionId);
37
+ }
38
+ const gates = [
39
+ { name: 'functional', status: 'passed' },
40
+ { name: 'security', status: 'passed' },
41
+ browserGateStatus(input.browserEnabled, detector),
42
+ mutationGateStatus(input)
43
+ ];
44
+ const halt = detector.shouldHalt();
45
+ return {
46
+ sessionId: input.sessionId,
47
+ project: input.project,
48
+ browserEnabled: input.browserEnabled,
49
+ gates,
50
+ detectorTriggered: halt,
51
+ ...(halt ? { diagnostic: detector.diagnostic() } : {}),
52
+ subAgentPromptHint: BROWSER_REUSE_HINT,
53
+ // Surface MUT.sig ONLY when the gate is actually evaluated
54
+ // (mutation enabled AND a report was loaded). --no-mutation or
55
+ // missing report -> undefined, so downstream consumers cannot
56
+ // mistake a skipped gate for a chain-trail anchor.
57
+ ...(input.mutationEnabled && input.mutationReport !== null
58
+ ? { mutSig: input.mutationReport.sha256 }
59
+ : {})
60
+ };
61
+ }
62
+ /**
63
+ * Feed one slice's events to the detector, logging a close→navigate pair as a
64
+ * spurious restart. The pairing state is local to the run: a close with no
65
+ * following navigate logs nothing, and a second navigate in a row clears it.
66
+ */
67
+ function recordBrowserEvents(detector, logger, events, sessionId) {
68
+ let pendingCloseTs = null;
69
+ for (const ev of events) {
70
+ detector.record(ev);
71
+ if (ev.tool === 'browser_close') {
72
+ pendingCloseTs = ev.ts;
73
+ }
74
+ else if (ev.tool === 'browser_navigate' && pendingCloseTs !== null) {
75
+ const deltaMs = Date.parse(ev.ts) - Date.parse(pendingCloseTs);
76
+ logger.append({
77
+ kind: 'spurious_restart',
78
+ ts: ev.ts,
79
+ sessionId,
80
+ closeTs: pendingCloseTs,
81
+ navigateTs: ev.ts,
82
+ deltaMs
83
+ });
84
+ pendingCloseTs = null;
85
+ }
86
+ else if (ev.tool === 'browser_navigate') {
87
+ pendingCloseTs = null;
88
+ }
89
+ }
90
+ }
91
+ function browserGateStatus(browserEnabled, detector) {
92
+ if (!browserEnabled) {
93
+ return { name: 'browser-e2e', status: 'skipped', reason: '--no-browser' };
94
+ }
95
+ return detector.shouldHalt()
96
+ ? { name: 'browser-e2e', status: 'failed', reason: detector.diagnostic() }
97
+ : { name: 'browser-e2e', status: 'passed' };
98
+ }
99
+ /**
100
+ * Plan 2 / Task 8 — MUT.sig gate.
101
+ * Gate semantics (per spec lines 1292-1341):
102
+ * - `skipped` when peaks-mut was not run (no report) OR --no-mutation
103
+ * - `passed` when the report's `thresholds.passed` is true
104
+ * - `failed` when the report's `thresholds.passed` is false
105
+ * "Skipped" is NOT a failure — the gate is a no-op so existing sessions that
106
+ * have not yet adopted peaks-mut keep passing.
107
+ */
108
+ function mutationGateStatus(input) {
109
+ if (!input.mutationEnabled) {
110
+ return { name: 'mutation', status: 'skipped', reason: '--no-mutation' };
111
+ }
112
+ const report = input.mutationReport;
113
+ if (report === null) {
114
+ return { name: 'mutation', status: 'skipped', reason: 'peaks mut not run' };
115
+ }
116
+ return report.thresholds.passed
117
+ ? { name: 'mutation', status: 'passed', mutSig: report.sha256 }
118
+ : {
119
+ name: 'mutation',
120
+ status: 'failed',
121
+ reason: deriveMutationFailureReason(report),
122
+ mutSig: report.sha256
123
+ };
124
+ }
125
+ /**
126
+ * Plan 2 / Task 8 — pure helper that explains WHY the mutation gate
127
+ * failed. Used only when the report's `thresholds.passed` is false.
128
+ * Reads the threshold block from the report itself (already
129
+ * CLI-computed by `buildMutReport`) so the message matches what
130
+ * peaks-mut's CLI surface prints.
131
+ */
132
+ function deriveMutationFailureReason(report) {
133
+ const t = report.thresholds;
134
+ const fragments = [];
135
+ if (report.mutation.killRate < t.mutationKillRateMin) {
136
+ fragments.push(`mutation kill rate ${report.mutation.killRate.toFixed(2)} < ${t.mutationKillRateMin.toFixed(2)}`);
137
+ }
138
+ if (report.assertions.weakRate > t.weakAssertionRateMax) {
139
+ fragments.push(`weak assertion rate ${report.assertions.weakRate.toFixed(2)} > ${t.weakAssertionRateMax.toFixed(2)}`);
140
+ }
141
+ if (fragments.length === 0) {
142
+ return `mutation thresholds failed (MUT.sig=${report.sha256})`;
143
+ }
144
+ return `${fragments.join('; ')} (MUT.sig=${report.sha256})`;
145
+ }
@@ -0,0 +1,15 @@
1
+ import type { Command } from 'commander';
2
+ import { type PilotGateCounts, type PilotGateReason, type PilotGateVerdict } from '../../services/race/gate2-evaluator.js';
3
+ import { type RaceGate2Policy } from '../../services/race/gate2-policy.js';
4
+ import { type ProgramIO } from '../cli-helpers.js';
5
+ export type PilotStatusReport = {
6
+ readonly policyVersion: string;
7
+ readonly evaluatorVersion: string;
8
+ readonly recordedPolicyVersion?: string;
9
+ readonly policy: RaceGate2Policy;
10
+ readonly verdict: PilotGateVerdict;
11
+ readonly counts: PilotGateCounts;
12
+ readonly reasons: readonly PilotGateReason[];
13
+ readonly evidencePath: string;
14
+ };
15
+ export declare function registerRaceCommands(program: Command, io: ProgramIO): void;
@@ -0,0 +1,65 @@
1
+ import { CLI_VERSION } from 'peaks-loop-shared/version';
2
+ import { fail, ok } from 'peaks-loop-shared/result';
3
+ import { evaluatePilotGate } from '../../services/race/gate2-evaluator.js';
4
+ import { RACE_GATE2_POLICY_V1, RACE_GATE2_POLICY_VERSION } from '../../services/race/gate2-policy.js';
5
+ import { readPilotGate } from '../../services/race/pilot-gate-store.js';
6
+ import { addJsonOption, printResult } from '../cli-helpers.js';
7
+ import { registerRacePilotGateRecordCommand } from './race-pilot-gate-record-command.js';
8
+ const RACE_DESCRIPTION = 'peaks-race-code fast lane: gate-2 threshold policy and evidence';
9
+ const PILOT_STATUS_DESCRIPTION = 'Judge .peaks/race/pilot-gate.json against the gate-2 policy. Read-only; prints pass | fail | insufficient-evidence.';
10
+ const PROJECT_HELP = 'project root (default: cwd)';
11
+ export function registerRaceCommands(program, io) {
12
+ const race = program.command('race').description(RACE_DESCRIPTION);
13
+ registerRacePilotStatusCommand(race, io);
14
+ registerRacePilotGateRecordCommand(race, io);
15
+ }
16
+ function registerRacePilotStatusCommand(race, io) {
17
+ addJsonOption(race
18
+ .command('pilot-status')
19
+ .description(PILOT_STATUS_DESCRIPTION)
20
+ .option('--project <path>', PROJECT_HELP, '.')).action((options) => runPilotStatus(options, io));
21
+ }
22
+ function refuseNoVerdict(io, options, refusal, path) {
23
+ printResult(io, fail('race.pilot-status', refusal.code, refusal.message, { evidencePath: path }, [
24
+ refusal.nextAction
25
+ ]), options.json);
26
+ process.exitCode = 1;
27
+ }
28
+ function runPilotStatus(options, io) {
29
+ const read = readPilotGate(options.project);
30
+ if (read.kind === 'missing') {
31
+ refuseNoVerdict(io, options, {
32
+ code: 'PILOT_GATE_EVIDENCE_MISSING',
33
+ message: `No gate-2 evidence at ${read.path}: no verdict was reached`,
34
+ nextAction: 'Record a pilot task with `peaks race pilot-gate record`'
35
+ }, read.path);
36
+ return;
37
+ }
38
+ if (read.kind === 'invalid') {
39
+ refuseNoVerdict(io, options, {
40
+ code: 'PILOT_GATE_EVIDENCE_INVALID',
41
+ message: `Gate-2 evidence at ${read.path} is unreadable, so no verdict was reached: ${read.message}`,
42
+ nextAction: 'Repair or re-record the evidence file before judging it'
43
+ }, read.path);
44
+ return;
45
+ }
46
+ const evaluation = evaluatePilotGate(read.gate.tasks, RACE_GATE2_POLICY_V1);
47
+ const report = {
48
+ policyVersion: RACE_GATE2_POLICY_VERSION,
49
+ evaluatorVersion: CLI_VERSION,
50
+ policy: RACE_GATE2_POLICY_V1,
51
+ verdict: evaluation.verdict,
52
+ counts: evaluation.counts,
53
+ reasons: evaluation.reasons,
54
+ evidencePath: read.path
55
+ };
56
+ const withRecorded = read.gate.policyVersion === undefined
57
+ ? report
58
+ : { ...report, recordedPolicyVersion: read.gate.policyVersion };
59
+ printResult(io, ok('race.pilot-status', withRecorded, [], []), options.json);
60
+ // `fail` is the only non-zero verdict: `insufficient-evidence` is the normal
61
+ // "keep running the pilot" state, not a failure (PRD §5.1).
62
+ if (evaluation.verdict === 'fail') {
63
+ process.exitCode = 1;
64
+ }
65
+ }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerRacePilotGateRecordCommand(race: Command, io: ProgramIO): void;
@@ -0,0 +1,81 @@
1
+ import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
2
+ import { buildPilotTaskRow, RISK_SURFACE_MAX, upsertPilotTask, HANDLING_VALUES, LANE_CHOSEN_BY_VALUES, OUTCOME_VALUES } from '../../services/race/pilot-gate-store.js';
3
+ import { addJsonOption, multipleOption, printResult } from '../cli-helpers.js';
4
+ const PILOT_GATE_DESCRIPTION = 'Gate-2 evidence for the peaks-race-code fast lane';
5
+ const RECORD_DESCRIPTION = 'Upsert one gate-2 evidence row into .peaks/race/pilot-gate.json, keyed by --rid. Refreshes lastEvaluation.';
6
+ const PROJECT_HELP = 'project root (default: cwd)';
7
+ /**
8
+ * A boolean is required with an explicit `true|false` rather than a `--no-*`
9
+ * flag: Commander's negated form DEFAULTS the flag, which would let a row be
10
+ * written with a `false` nobody chose. A required value makes "must be given
11
+ * explicitly" mechanical instead of a convention.
12
+ */
13
+ function parseBooleanFlag(value) {
14
+ if (value === 'true')
15
+ return true;
16
+ if (value === 'false')
17
+ return false;
18
+ throw new Error(`expected true or false, got ${JSON.stringify(value)}`);
19
+ }
20
+ export function registerRacePilotGateRecordCommand(race, io) {
21
+ const pilotGate = race.command('pilot-gate').description(PILOT_GATE_DESCRIPTION);
22
+ addJsonOption(pilotGate
23
+ .command('record')
24
+ .description(RECORD_DESCRIPTION)
25
+ .requiredOption('--rid <id>', 'task request id (letters or digits, then letters, digits, ".", "_" or "-")')
26
+ .requiredOption('--session-id <session>', 'session the task ran in')
27
+ .requiredOption('--date <YYYY-MM-DD>', 'task date')
28
+ .requiredOption('--lane-chosen-by <who>', `who chose the lane (${LANE_CHOSEN_BY_VALUES.join(' | ')})`)
29
+ .requiredOption('--outcome <outcome>', `task outcome (${OUTCOME_VALUES.join(' | ')})`)
30
+ .option('--file <path>', 'repo-relative changed file (repeatable)', multipleOption, [])
31
+ .option('--risk-surface <n>', `risk surface hit, 1..${RISK_SURFACE_MAX} (repeatable)`, multipleOption, [])
32
+ .requiredOption('--risk-surface-handling <handling>', `how a hit was handled (${HANDLING_VALUES.join(' | ')})`)
33
+ .requiredOption('--rolled-back <true|false>', 'was the change rolled back?', parseBooleanFlag)
34
+ .requiredOption('--ci-red <true|false>', 'is a CI failure attributed to this task?', parseBooleanFlag)
35
+ .requiredOption('--missed-risk-surface <true|false>', 'is a missed risk surface known? (no procedure exists for setting this yet)', parseBooleanFlag)
36
+ .option('--project <path>', PROJECT_HELP, '.')).action((options) => runRecord(options, io));
37
+ }
38
+ /**
39
+ * Validate, then write. Validation is fail-closed and runs BEFORE the upsert:
40
+ * a refusal leaves the evidence file exactly as it was, and the message names
41
+ * the flag that broke a rule.
42
+ */
43
+ /** Flags in, row input out. Every value is re-validated by the store. */
44
+ function toInput(options) {
45
+ return {
46
+ rid: options.rid,
47
+ sessionId: options.sessionId,
48
+ date: options.date,
49
+ laneChosenBy: options.laneChosenBy,
50
+ outcome: options.outcome,
51
+ filesChanged: options.file ?? [],
52
+ riskSurfacesHit: (options.riskSurface ?? []).map((value) => Number(value)),
53
+ riskSurfaceHandling: options.riskSurfaceHandling,
54
+ rolledBack: options.rolledBack,
55
+ ciRed: options.ciRed,
56
+ missedRiskSurface: options.missedRiskSurface
57
+ };
58
+ }
59
+ function runRecord(options, io) {
60
+ const built = buildPilotTaskRow(toInput(options));
61
+ if (built.kind === 'invalid') {
62
+ printResult(io, fail('race.pilot-gate.record', 'PILOT_TASK_INVALID', built.message, { rid: options.rid }, [
63
+ 'Fix the flag this message names; nothing was written'
64
+ ]), options.json);
65
+ process.exitCode = 1;
66
+ return;
67
+ }
68
+ try {
69
+ const result = upsertPilotTask(options.project, built.row);
70
+ printResult(io, ok('race.pilot-gate.record', {
71
+ rid: built.row.rid,
72
+ evidencePath: result.path,
73
+ verdict: result.evaluation.verdict,
74
+ counts: result.evaluation.counts
75
+ }, [], []), options.json);
76
+ }
77
+ catch (error) {
78
+ printResult(io, fail('race.pilot-gate.record', 'PILOT_GATE_WRITE_FAILED', getErrorMessage(error), { rid: options.rid }, ['The evidence file was left as it was']), options.json);
79
+ process.exitCode = 1;
80
+ }
81
+ }
@@ -0,0 +1,28 @@
1
+ import type { Command } from 'commander';
2
+ import { type LayerResult } from '../../services/release/version-precheck-service.js';
3
+ import { type ProgramIO } from '../cli-helpers.js';
4
+ /**
5
+ * The payload an outcome carries. The `error` member is declared so the
6
+ * INVALID_TRANSITION message is read as a `string` rather than as `unknown`
7
+ * off the open index signature.
8
+ */
9
+ type CanaryPayload = Readonly<Record<string, unknown>> & {
10
+ readonly error?: string;
11
+ };
12
+ type CanaryOutcome = {
13
+ ok: boolean;
14
+ payload: CanaryPayload;
15
+ status: 'PRECHECK_BLOCKER' | 'INVALID_PERCENT' | 'INVALID_TRANSITION' | 'OK';
16
+ blockerLayer?: {
17
+ name: string;
18
+ result: LayerResult;
19
+ };
20
+ };
21
+ export declare function executeCanaryAction(opts: {
22
+ percent: string;
23
+ note?: string;
24
+ project?: string;
25
+ json?: boolean;
26
+ }, io: ProgramIO, projectRoot: string): CanaryOutcome;
27
+ export declare function registerReleaseCanaryCommand(release: Command, io: ProgramIO): void;
28
+ export {};
@@ -0,0 +1,129 @@
1
+ // src/cli/commands/release-canary-command.ts
2
+ //
3
+ // `peaks release canary --percent <10|50>` — advance the active release to a
4
+ // canary stage. Split out of `release-commands.ts`; the verb name, its options,
5
+ // the canary percent vocabulary, the precheck gate and every envelope shape are
6
+ // unchanged. `executeCanaryAction` keeps its name and signature (it is the
7
+ // function the cross-cutting e2e harness names) and is re-exported by
8
+ // `release-commands.ts`.
9
+ import { readReleaseState, transitionRelease, writeReleaseState } from '../../services/release/release-state.js';
10
+ import { runAllLayers } from '../../services/release/version-precheck-service.js';
11
+ import { runChangesetHardGate } from '../../services/changeset/changeset-check-service.js';
12
+ import { fail, ok } from 'peaks-loop-shared/result';
13
+ import { addJsonOption, printResult } from '../cli-helpers.js';
14
+ import { CANARY_PERCENT_FIRST, CANARY_PERCENT_SECOND, CANARY_PERCENTS, resolveReleaseProjectRoot } from './release-command-shared.js';
15
+ function precheckBlockerOutcome(projectRoot, snapshotAt, name, result) {
16
+ return {
17
+ ok: false,
18
+ status: 'PRECHECK_BLOCKER',
19
+ blockerLayer: { name, result },
20
+ payload: {
21
+ projectRoot,
22
+ precheckSnapshotAt: snapshotAt,
23
+ layer: name,
24
+ message: result.message,
25
+ remediation: result.remediation
26
+ }
27
+ };
28
+ }
29
+ // precheck-guard via direct function call (not via program.parseAsync with a
30
+ // mocked service). Returns the result envelope for the caller to print.
31
+ export function executeCanaryAction(opts, io, projectRoot) {
32
+ // this function is called (step 0 short-circuits with CHANGESET_BLOCKED).
33
+ // Layers C/D default warning → do not block canary; --strict upgrade would
34
+ const precheck = runAllLayers({ projectRoot, strict: false });
35
+ const blockerEntry = Object.entries(precheck.layers).find(([, l]) => l.status === 'blocker');
36
+ if (blockerEntry !== undefined) {
37
+ const [name, result] = blockerEntry;
38
+ return precheckBlockerOutcome(projectRoot, precheck.snapshotAt, name, result);
39
+ }
40
+ const percent = Number.parseInt(opts.percent, 10);
41
+ if (percent !== CANARY_PERCENT_FIRST && percent !== CANARY_PERCENT_SECOND) {
42
+ return {
43
+ ok: false,
44
+ status: 'INVALID_PERCENT',
45
+ payload: { projectRoot, got: opts.percent }
46
+ };
47
+ }
48
+ const state = readReleaseState(projectRoot);
49
+ const targetStage = CANARY_PERCENTS[percent];
50
+ const result = transitionRelease(state, targetStage, opts.note);
51
+ if ('error' in result) {
52
+ return {
53
+ ok: false,
54
+ status: 'INVALID_TRANSITION',
55
+ payload: { projectRoot, error: result.error }
56
+ };
57
+ }
58
+ writeReleaseState(projectRoot, result.state);
59
+ return {
60
+ ok: true,
61
+ status: 'OK',
62
+ payload: {
63
+ projectRoot,
64
+ percent,
65
+ currentStage: targetStage,
66
+ nextAction: percent === CANARY_PERCENT_FIRST
67
+ ? 'peaks release canary --percent 50'
68
+ : 'peaks release promote'
69
+ }
70
+ };
71
+ }
72
+ /** The refusal a staged changeset triggers, before the precheck even runs. */
73
+ function changesetBlockedOutcome(gate, projectRoot) {
74
+ return fail('release.canary', 'CHANGESET_BLOCKED', `${gate.stagedFiles.length} staged .changeset/*.md file(s) — refusing canary`, {
75
+ projectRoot,
76
+ state: gate.state,
77
+ stagedFiles: [...gate.stagedFiles],
78
+ snapshotAt: gate.snapshotAt
79
+ }, [
80
+ `Drain pending changesets (coordinating LLM: drain via the standard changeset consumption path), then re-run \`peaks changeset check --project ${projectRoot}\` to confirm clean state.`
81
+ ]);
82
+ }
83
+ /** The precheck refusal, with the layer that blocked and where to read the rest. */
84
+ function precheckBlockerEnvelope(projectRoot, result) {
85
+ const layer = result.blockerLayer;
86
+ return fail('release.canary', 'PRECHECK_BLOCKER', `precheck blocker on layer '${layer?.name ?? 'unknown'}': ${layer?.result.message ?? ''}`, result.payload, [
87
+ `Run 'peaks release precheck --project ${projectRoot}' for the full 4-layer envelope.`,
88
+ `Run 'peaks release precheck --strict' to also surface warning-layer issues.`,
89
+ `Remediation: ${layer?.result.remediation ?? ''}`
90
+ ]);
91
+ }
92
+ /** The outcome of the canary attempt, printed as the envelope its status selects. */
93
+ function printCanaryOutcome(io, opts, projectRoot, result) {
94
+ const asJson = opts.json ?? false;
95
+ if (result.status === 'PRECHECK_BLOCKER') {
96
+ printResult(io, precheckBlockerEnvelope(projectRoot, result), asJson);
97
+ return;
98
+ }
99
+ if (result.status === 'INVALID_PERCENT') {
100
+ printResult(io, fail('release.canary', 'INVALID_PERCENT', `--percent must be 10 or 50 (got "${opts.percent}")`, result.payload, []), asJson);
101
+ return;
102
+ }
103
+ if (result.status === 'INVALID_TRANSITION') {
104
+ printResult(io, fail('release.canary', 'INVALID_TRANSITION', String(result.payload['error'] ?? ''), result.payload, []), asJson);
105
+ return;
106
+ }
107
+ printResult(io, ok('release.canary', result.payload, [], []), asJson);
108
+ }
109
+ function runReleaseCanary(io, opts) {
110
+ const projectRoot = resolveReleaseProjectRoot(opts.project);
111
+ const gate = runChangesetHardGate(projectRoot);
112
+ if (gate.state === 'staged-present') {
113
+ process.exitCode = 1;
114
+ printResult(io, changesetBlockedOutcome(gate, projectRoot), opts.json ?? false);
115
+ return;
116
+ }
117
+ printCanaryOutcome(io, opts, projectRoot, executeCanaryAction(opts, io, projectRoot));
118
+ }
119
+ export function registerReleaseCanaryCommand(release, io) {
120
+ addJsonOption(release
121
+ .command('canary')
122
+ .description('Advance the active release to a canary stage. Two percent values supported: ' +
123
+ '10 (first canary, requires stage=planned) and 50 (second canary, requires ' +
124
+ 'stage=canary-10). Runs `peaks release precheck` first and refuses with ' +
125
+ 'PRECHECK_BLOCKER if any blocker layer (rootVsShared or tagCollision) fails.')
126
+ .requiredOption('--percent <10|50>', 'canary percent (10 or 50)')
127
+ .option('--note <text>', 'optional note for the stage transition')
128
+ .option('--project <path>', 'project root (default: cwd)')).action((opts) => runReleaseCanary(io, opts));
129
+ }
@@ -0,0 +1,13 @@
1
+ import type { ReleaseStage } from '../../services/release/release-state.js';
2
+ /** The two canary stages the CLI supports, as the `--percent` values that select them. */
3
+ export declare const CANARY_PERCENT_FIRST = 10;
4
+ export declare const CANARY_PERCENT_SECOND = 50;
5
+ export type CanaryPercent = typeof CANARY_PERCENT_FIRST | typeof CANARY_PERCENT_SECOND;
6
+ export declare const CANARY_PERCENTS: Readonly<Record<CanaryPercent, ReleaseStage>>;
7
+ /** `--project <path>`, else the nearest project root, else cwd — unchanged order. */
8
+ export declare function resolveReleaseProjectRoot(project: string | undefined): string;
9
+ /** `--project` + `--json`, the two options every verb in this family declares. */
10
+ export type ReleaseProjectOptions = {
11
+ project?: string;
12
+ json?: boolean;
13
+ };
@@ -0,0 +1,18 @@
1
+ // src/cli/commands/release-command-shared.ts
2
+ //
3
+ // What every `peaks release *` verb shares: the project-root resolution and the
4
+ // two canary percents, named so the state machine's vocabulary is not spelled
5
+ // out as literals in each verb. Split out of `release-commands.ts`; the values
6
+ // and the resolution order are unchanged.
7
+ import { findProjectRoot } from '../../services/config/config-safety.js';
8
+ /** The two canary stages the CLI supports, as the `--percent` values that select them. */
9
+ export const CANARY_PERCENT_FIRST = 10;
10
+ export const CANARY_PERCENT_SECOND = 50;
11
+ export const CANARY_PERCENTS = {
12
+ [CANARY_PERCENT_FIRST]: 'canary-10',
13
+ [CANARY_PERCENT_SECOND]: 'canary-50'
14
+ };
15
+ /** `--project <path>`, else the nearest project root, else cwd — unchanged order. */
16
+ export function resolveReleaseProjectRoot(project) {
17
+ return project ?? findProjectRoot(process.cwd()) ?? process.cwd();
18
+ }
@@ -18,24 +18,16 @@
18
18
  *
19
19
  * Real deployment (k8s rollout, LB config, monitoring integration) is
20
20
  * OUT OF SCOPE for this slice.
21
+ *
22
+ * The verb implementations live beside this file, one module per verb:
23
+ * `release-plan-command.ts`, `release-canary-command.ts`,
24
+ * `release-promote-command.ts`, `release-watch-command.ts`,
25
+ * `release-done-command.ts`, `release-rollback-command.ts`,
26
+ * `release-hotfix-command.ts`, `release-precheck-command.ts`, with their shared
27
+ * project-root / canary-percent vocabulary in `release-command-shared.ts`.
21
28
  */
22
29
  import type { Command } from 'commander';
23
- import { isReleaseStage } from '../../services/release/release-state.js';
24
- import { type LayerResult } from '../../services/release/version-precheck-service.js';
25
- import { type ProgramIO } from '../cli-helpers.js';
26
- export declare function executeCanaryAction(opts: {
27
- percent: string;
28
- note?: string;
29
- project?: string;
30
- json?: boolean;
31
- }, io: ProgramIO, projectRoot: string): {
32
- ok: boolean;
33
- payload: Readonly<Record<string, unknown>>;
34
- status: 'PRECHECK_BLOCKER' | 'INVALID_PERCENT' | 'INVALID_TRANSITION' | 'OK';
35
- blockerLayer?: {
36
- name: string;
37
- result: LayerResult;
38
- };
39
- };
30
+ import type { ProgramIO } from '../cli-helpers.js';
40
31
  export declare function registerReleaseCommands(program: Command, io: ProgramIO): void;
41
- export { isReleaseStage };
32
+ export { executeCanaryAction } from './release-canary-command.js';
33
+ export { isReleaseStage } from '../../services/release/release-state.js';