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,44 @@
1
+ // src/cli/commands/release-watch-command.ts
2
+ //
3
+ // `peaks release watch` — the watch-window status of the promoted release.
4
+ // Split out of `release-commands.ts`; the verb name, its options, the rounded
5
+ // `percentComplete` on the envelope and the `readyForDone` next-action rule are
6
+ // unchanged.
7
+ import { readReleaseState, watchWindow } from '../../services/release/release-state.js';
8
+ import { fail, ok } from 'peaks-loop-shared/result';
9
+ import { addJsonOption, printResult } from '../cli-helpers.js';
10
+ import { resolveReleaseProjectRoot } from './release-command-shared.js';
11
+ function runReleaseWatch(io, opts) {
12
+ const projectRoot = resolveReleaseProjectRoot(opts.project);
13
+ const state = readReleaseState(projectRoot);
14
+ if (state.active === null) {
15
+ printResult(io, fail('release.watch', 'NO_ACTIVE', 'no active release to watch', { projectRoot }, [
16
+ 'Run `peaks release plan <version>` to start one.'
17
+ ]), opts.json ?? false);
18
+ return;
19
+ }
20
+ const win = watchWindow(state.active);
21
+ const readyForDone = win.percentComplete >= 1.0;
22
+ printResult(io, ok('release.watch', {
23
+ projectRoot,
24
+ version: state.active.version,
25
+ currentStage: state.active.currentStage,
26
+ window: {
27
+ elapsedMs: win.elapsedMs,
28
+ remainingMs: win.remainingMs,
29
+ windowMs: win.windowMs,
30
+ percentComplete: Math.round(win.percentComplete * 100) / 100
31
+ },
32
+ readyForDone
33
+ }, readyForDone
34
+ ? ['Watch window complete. Run `peaks release done` to mark the release done.']
35
+ : []), opts.json ?? false);
36
+ }
37
+ export function registerReleaseWatchCommand(release, io) {
38
+ addJsonOption(release
39
+ .command('watch')
40
+ .description('Show the watch window status for the current promoted release. ' +
41
+ '24h window from promoted-at. After the window, run `peaks release done` ' +
42
+ 'to mark the release complete.')
43
+ .option('--project <path>', 'project root (default: cwd)')).action((opts) => runReleaseWatch(io, opts));
44
+ }
@@ -35,6 +35,14 @@ export type RequestTransitionOptions = {
35
35
  forceConfirm?: boolean;
36
36
  json?: boolean;
37
37
  };
38
+ export type RequestRetagOptions = {
39
+ role: RequestArtifactRole;
40
+ type: RequestType;
41
+ project: string;
42
+ /** Required on this write verb — see the note in `request-retag-command.ts`. */
43
+ sessionId: string;
44
+ json?: boolean;
45
+ };
38
46
  export type RequestLintOptions = {
39
47
  role: RequestArtifactRole;
40
48
  project: string;
@@ -1,6 +1,7 @@
1
1
  import { registerRequestInitCommand } from './request-init-command.js';
2
2
  import { registerRequestListCommand } from './request-list-command.js';
3
3
  import { registerRequestShowCommand } from './request-show-command.js';
4
+ import { registerRequestRetagCommand } from './request-retag-command.js';
4
5
  import { registerRequestTransitionCommand } from './request-transition-command.js';
5
6
  import { registerRequestLintCommand } from './request-lint-command.js';
6
7
  import { registerRequestRepairStatusCommand } from './request-repair-status-command.js';
@@ -13,6 +14,7 @@ export function registerRequestCommands(program, io) {
13
14
  registerRequestInitCommand(request, io);
14
15
  registerRequestListCommand(request, io);
15
16
  registerRequestShowCommand(request, io);
17
+ registerRequestRetagCommand(request, io);
16
18
  registerRequestTransitionCommand(request, io);
17
19
  registerRequestLintCommand(request, io);
18
20
  registerRequestRepairStatusCommand(request, io);
@@ -1,27 +1,81 @@
1
1
  import { createRequestArtifact, VALID_REQUEST_TYPES } from '../../services/artifacts/request-artifact-service.js';
2
2
  import { parseRole, parseRequestType, VALID_ROLES } from './request-format-helpers.js';
3
3
  import { fail, ok } from 'peaks-loop-shared/result';
4
- import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
4
+ import { addJsonOption, getErrorMessage, printResult, printableWarningText } from '../cli-helpers.js';
5
+ import { isUnsafePathInput } from '../../shared/path-safety.js';
6
+ import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
5
7
  const INIT_DESCRIPTION = 'Create the per-request artifact template for a Peaks role (dry-run by default)';
6
8
  const INIT_ID_HELP = 'request id, e.g. 2026-05-23-add-foo. With --apply, also pre-creates the canonical change-id scope dir at .peaks/_runtime/change/<id>/ so sub-agents never write .peaks/_runtime/<id>/ at top level.';
7
9
  const INIT_PROJECT_HELP = 'target project root';
8
- const INIT_SESSION_HELP = 'override the default date-stamped session id';
10
+ const INIT_SESSION_HELP = 'explicit session id (default: the active session recorded in .peaks/_runtime/session.json)';
9
11
  const INIT_APPLY_HELP = 'write the artifact file (default: preview only)';
10
12
  const INIT_CALLER_ID_HELP = 'Override the caller id for this invocation (D4 priority: flag beats env beats platform fallback). The resolved callerId is stamped on the artifact body and surfaced in the response envelope.';
11
13
  const CALLER_ID_INVALID_HINTS = [
12
14
  'Set --caller-id to a value matching ^[a-zA-Z0-9._-]{1,200}$',
13
15
  'Or set PEAKS_CALLER_ID env var (or CLAUDE_CODE_SESSION_ID for Claude Code)'
14
16
  ];
15
- function failInitSessionIdRequired(io, options) {
16
- printResult(io, fail('request.init', 'SESSION_ID_REQUIRED', '--session-id is required: the CLI writes envelopes only to .peaks/_runtime/<sessionId>/... (one-axis layout)', { role: options.role, requestId: options.id }, ['Re-run with --session-id <sid>', 'Or run `peaks workspace init` to create a session first']), options.json);
17
+ const INIT_SESSION_HINTS = [
18
+ 'Re-run with --session-id <sid>',
19
+ 'Or run `peaks workspace init` to create a session first'
20
+ ];
21
+ function initSessionProblemMessage(problem) {
22
+ if (problem === 'blank') {
23
+ return '--session-id was passed but is blank. Give it a session id, or omit the flag to use the session recorded in .peaks/_runtime/session.json';
24
+ }
25
+ if (problem === 'malformed') {
26
+ return 'the session id recorded in .peaks/_runtime/session.json is not usable: it must be one printable path segment, because the artifact is scoped to a directory named after it. Pass --session-id, or re-run `peaks workspace init`';
27
+ }
28
+ return 'no session id: pass --session-id, or run inside a workspace that records one in .peaks/_runtime/session.json (the CLI writes envelopes only to .peaks/_runtime/<sessionId>/..., one-axis layout)';
29
+ }
30
+ function failInitSession(io, options, problem) {
31
+ printResult(io, fail('request.init', 'SESSION_ID_REQUIRED', initSessionProblemMessage(problem), { role: options.role, requestId: options.id }, INIT_SESSION_HINTS), options.json);
17
32
  process.exitCode = 1;
18
33
  }
34
+ /**
35
+ * The session id is used verbatim as ONE directory name under `.peaks/_runtime/`,
36
+ * so a usable one is a single printable path segment. `isUnsafePathInput` covers
37
+ * `.`/`..`, separators, drive/UNC/URL shapes — and NOT the C0/C1 control
38
+ * characters, so a recorded id carrying a newline would be accepted and would
39
+ * forge a line in the preview and in the artifact body's `session:` field.
40
+ * `printableWarningText` is the canonical control-character check; a value equal
41
+ * to its printable form carries none.
42
+ */
43
+ function isUsableSessionSegment(value) {
44
+ return !isUnsafePathInput(value) && printableWarningText(value) === value;
45
+ }
46
+ /**
47
+ * The session id the artifact must land under. An explicit `--session-id` wins;
48
+ * otherwise read the workspace's active session from
49
+ * `.peaks/_runtime/session.json` — the source `peaks sub-agent dispatch` and
50
+ * `peaks skill presence` already read for this same id. The caller refuses
51
+ * rather than writing under a placeholder directory; unlike dispatch, this
52
+ * command never falls back to `'unknown-sid'`, because it writes files.
53
+ *
54
+ * A SUPPLIED-but-blank flag is its own problem, not an omission: silently
55
+ * substituting the workspace id would hide a caller mistake (an unset variable
56
+ * expanding to empty would quietly target a different session), and this is the
57
+ * behaviour the flag had before the fallback existed.
58
+ *
59
+ * Only the fallback value is shape-checked here. A value passed via
60
+ * `--session-id` flows downstream exactly as it did before, so a caller who
61
+ * passes that flag sees no change.
62
+ */
63
+ function resolveInitSessionId(options) {
64
+ if (options.sessionId !== undefined) {
65
+ const explicit = options.sessionId.trim();
66
+ return explicit.length === 0 ? { problem: 'blank' } : { id: explicit };
67
+ }
68
+ const recorded = getCurrentSessionId(options.project);
69
+ if (recorded === null)
70
+ return { problem: 'absent' };
71
+ return isUsableSessionSegment(recorded) ? { id: recorded } : { problem: 'malformed' };
72
+ }
19
73
  function buildInitServiceOptions(options, sessionId) {
20
- // One-axis layout: --session-id is REQUIRED. The on-disk root
21
- // is always `.peaks/_runtime/<sessionId>/<role>/...`. The user
22
- // has forbidden the `.peaks/_runtime/<id>/` root layout — without an
23
- // explicit session id, we cannot guarantee the artifact lands
24
- // under `_runtime/`. See
74
+ // One-axis layout: the on-disk root is always
75
+ // `.peaks/_runtime/<sessionId>/<role>/...`, and the session id arrives
76
+ // already resolved (`resolveInitSessionId`) — the caller refuses when it
77
+ // could not be. The user has forbidden the `.peaks/_runtime/<id>/` root
78
+ // layout. See
25
79
  // `.peaks/memory/2026-06-21-peaks-request-session-id-leaks-into-change-id.md`.
26
80
  const serviceOptions = {
27
81
  role: options.role,
@@ -66,11 +120,12 @@ async function resolveInitCallerId(io, options) {
66
120
  }
67
121
  async function runRequestInit(options, io) {
68
122
  try {
69
- if (options.sessionId === undefined || options.sessionId.trim().length === 0) {
70
- failInitSessionIdRequired(io, options);
123
+ const resolved = resolveInitSessionId(options);
124
+ if (resolved.id === undefined) {
125
+ failInitSession(io, options, resolved.problem);
71
126
  return;
72
127
  }
73
- const serviceOptions = buildInitServiceOptions(options, options.sessionId);
128
+ const serviceOptions = buildInitServiceOptions(options, resolved.id);
74
129
  const callerId = await resolveInitCallerId(io, options);
75
130
  if (callerId === null)
76
131
  return;
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerRequestRetagCommand(request: Command, io: ProgramIO): void;
@@ -0,0 +1,50 @@
1
+ import { retagRequestArtifact, describeRetag } from '../../services/artifacts/request-retag-service.js';
2
+ import { VALID_REQUEST_TYPES } from '../../services/artifacts/request-artifact-service.js';
3
+ import { parseRequestType, parseRole, VALID_ROLES } from './request-format-helpers.js';
4
+ import { fail, ok } from 'peaks-loop-shared/result';
5
+ import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
6
+ const RETAG_DESCRIPTION = "Set a request artifact's type, replacing whatever it currently records. Reports the prerequisite table the new type selects and any of its artifacts that are not on disk yet.";
7
+ const RETAG_REQUEST_ID_HELP = 'request id, e.g. 2026-05-23-add-foo';
8
+ const RETAG_TYPE_HELP = `request type (${VALID_REQUEST_TYPES.join(' | ')})`;
9
+ const RETAG_PROJECT_HELP = 'target project root';
10
+ /**
11
+ * Required, unlike the read verbs' optional flag. `showRequestArtifact` resolves
12
+ * the first session holding a matching rid when none is given, which is a fine
13
+ * way to READ and a way to WRITE the wrong artifact — so this verb names its
14
+ * target or does nothing.
15
+ */
16
+ const RETAG_SESSION_HELP = 'session id holding the artifact to retag (required)';
17
+ async function runRequestRetag(requestId, options, io) {
18
+ try {
19
+ const result = await retagRequestArtifact({
20
+ projectRoot: options.project,
21
+ role: options.role,
22
+ requestId,
23
+ requestType: options.type,
24
+ sessionId: options.sessionId
25
+ });
26
+ if (result === null) {
27
+ printResult(io, fail('request.retag', 'REQUEST_NOT_FOUND', `No artifact found for role=${options.role} requestId=${requestId}`, { role: options.role, requestId }, ['Verify the request id, role, and session id']), options.json);
28
+ process.exitCode = 1;
29
+ return;
30
+ }
31
+ printResult(io, ok('request.retag', result, describeRetag(result)), options.json);
32
+ }
33
+ catch (error) {
34
+ printResult(io, fail('request.retag', 'REQUEST_RETAG_FAILED', getErrorMessage(error), {
35
+ role: options.role,
36
+ requestId
37
+ }), options.json);
38
+ process.exitCode = 1;
39
+ }
40
+ }
41
+ export function registerRequestRetagCommand(request, io) {
42
+ addJsonOption(request
43
+ .command('retag')
44
+ .description(RETAG_DESCRIPTION)
45
+ .argument('<request-id>', RETAG_REQUEST_ID_HELP)
46
+ .requiredOption('--role <role>', `target role (${VALID_ROLES.join(' | ')})`, parseRole)
47
+ .requiredOption('--type <type>', RETAG_TYPE_HELP, parseRequestType)
48
+ .requiredOption('--project <path>', RETAG_PROJECT_HELP)
49
+ .requiredOption('--session-id <session>', RETAG_SESSION_HELP)).action((requestId, options) => runRequestRetag(requestId, options, io));
50
+ }
@@ -1,3 +1,11 @@
1
1
  import type { Command } from 'commander';
2
+ import { type ShowRequestArtifactResult } from '../../services/artifacts/request-artifact-service.js';
2
3
  import { type ProgramIO } from '../cli-helpers.js';
4
+ /**
5
+ * The type a `request show` reports is the EFFECTIVE one: an artifact that
6
+ * records no type still reads as `feature`, and a reader who cannot tell that
7
+ * from a chosen `feature` cannot tell which prerequisite table the next gate
8
+ * will apply. The field says which; this line says it in words.
9
+ */
10
+ export declare function typeProvenanceWarning(result: ShowRequestArtifactResult): string[];
3
11
  export declare function registerRequestShowCommand(request: Command, io: ProgramIO): void;
@@ -21,6 +21,19 @@ function buildShowPayload(result, options) {
21
21
  const transformed = applyPerArtifactFormat(result, override ?? format);
22
22
  return transformed === result ? { ...result, format } : transformed;
23
23
  }
24
+ /**
25
+ * The type a `request show` reports is the EFFECTIVE one: an artifact that
26
+ * records no type still reads as `feature`, and a reader who cannot tell that
27
+ * from a chosen `feature` cannot tell which prerequisite table the next gate
28
+ * will apply. The field says which; this line says it in words.
29
+ */
30
+ export function typeProvenanceWarning(result) {
31
+ if (result.requestTypeSource !== 'default')
32
+ return [];
33
+ return [
34
+ `request type '${result.requestType}' is the DEFAULT — this artifact records no type, so the '${result.requestType}' prerequisite table applies. Set one with: peaks request retag <request-id> --role ${result.role} --type <type> --project <path>`
35
+ ];
36
+ }
24
37
  async function runRequestShow(requestId, options, io) {
25
38
  try {
26
39
  const showOptions = {
@@ -36,7 +49,7 @@ async function runRequestShow(requestId, options, io) {
36
49
  failShowNotFound(io, options, requestId);
37
50
  return;
38
51
  }
39
- printResult(io, ok('request.show', buildShowPayload(result, options)), options.json);
52
+ printResult(io, ok('request.show', buildShowPayload(result, options), typeProvenanceWarning(result)), options.json);
40
53
  }
41
54
  catch (error) {
42
55
  printResult(io, fail('request.show', 'REQUEST_SHOW_FAILED', getErrorMessage(error), { role: options.role, requestId }, ['Check role, request id, and project path before retrying']), options.json);
@@ -1,9 +1,9 @@
1
1
  import { transitionRequestArtifact } from '../../services/artifacts/request-artifact-service.js';
2
2
  import { parseRole, parseStateForRole, VALID_ROLES } from './request-format-helpers.js';
3
3
  import { fail, ok } from 'peaks-loop-shared/result';
4
- import { addJsonOption, printResult } from '../cli-helpers.js';
4
+ import { addJsonOption, printableWarningText, printResult } from '../cli-helpers.js';
5
5
  import { runTransitionPreflight } from './request-transition-preflight.js';
6
- import { reportTransitionFailure } from './request-transition-failures.js';
6
+ import { reportTransitionFailure, softWarningExpiryClause } from './request-transition-failures.js';
7
7
  import { buildPrdHandoffResult, collectQaHandoffHooks, preCompactNote } from './request-transition-hooks.js';
8
8
  const TRANSITION_DESCRIPTION = 'Move a per-request artifact to a new state defined by its role state machine';
9
9
  const TRANSITION_REQUEST_ID_HELP = 'request id, e.g. 2026-05-23-add-foo';
@@ -11,7 +11,7 @@ const TRANSITION_STATE_HELP = 'new state name; allowed values depend on role';
11
11
  const TRANSITION_PROJECT_HELP = 'target project root';
12
12
  const TRANSITION_SESSION_HELP = 'restrict to a specific session id';
13
13
  const TRANSITION_REASON_HELP = 'reason appended as a transition note; required when --allow-incomplete is set';
14
- const TRANSITION_ALLOW_INCOMPLETE_HELP = 'bypass artifact prerequisite checks; requires --reason and records the bypass in the artifact';
14
+ const TRANSITION_ALLOW_INCOMPLETE_HELP = 'bypass the prerequisite, lint, file-size and state-order checks; requires --reason and records the bypass in the artifact';
15
15
  const TRANSITION_CONFIRM_HELP = 'skip the confirmation gate (for non-interactive / LLM contexts)';
16
16
  const TRANSITION_FORCE_CONFIRM_HELP = 'bypass mode-enforced confirmation (use with caution)';
17
17
  function buildTransitionOptions(requestId, role, newState, options) {
@@ -71,7 +71,15 @@ function printTransitionResult(io, options, result, hooks) {
71
71
  codegraphRefresh: hooks.codegraphRefresh
72
72
  }, [
73
73
  ...(note === null ? [] : [note]),
74
- ...(hooks.codegraphWarning === null ? [] : [hooks.codegraphWarning])
74
+ ...(hooks.codegraphWarning === null ? [] : [hooks.codegraphWarning]),
75
+ // A soft-passed prerequisite is a warning, not a silent pass: the
76
+ // envelope carries it (and `printResult` puts it on stderr for a human
77
+ // run). `data.prerequisiteWarnings` holds the structured entries.
78
+ // `softWarningExpiryClause` adds the one thing the entry cannot say
79
+ // without `message` moving: whether the window it names has closed.
80
+ ...(result.prerequisiteWarnings ?? []).map((warning) => `Soft prerequisite (not enforced): ${printableWarningText(warning.path)} ` +
81
+ `[${printableWarningText(warning.code)}] — ${printableWarningText(warning.message)}` +
82
+ softWarningExpiryClause(warning))
75
83
  ]), options.json);
76
84
  }
77
85
  async function runRequestTransition(requestId, options, io) {
@@ -1,5 +1,19 @@
1
1
  import { type ProgramIO } from '../cli-helpers.js';
2
2
  import type { RequestTransitionOptions } from './request-command-options.js';
3
+ /**
4
+ * The clause a soft-pass warning gains once its back-compat window has closed.
5
+ * It renders the `expiredWindow` the resolver set (the release the table
6
+ * declared, plus the build it was compared against) and is empty while the
7
+ * window is open — an open window is already the future tense the warning's own
8
+ * message uses, so it needs no clause.
9
+ *
10
+ * Shared with `printTransitionResult` in `request-transition-command.ts`: the
11
+ * success arm and this refusal arm render one fact one way, so an operator who
12
+ * sees the same soft pass through either arm reads the same sentence.
13
+ */
14
+ export declare function softWarningExpiryClause(warning: {
15
+ expiredWindow?: string;
16
+ }): string;
3
17
  /**
4
18
  * Map a thrown transition error to its envelope. `InvalidArgumentError` is
5
19
  * re-thrown: Commander raises it for an unparsable `--state`, and swallowing it
@@ -4,9 +4,26 @@
4
4
  // readable and every branch keeps setting `process.exitCode = 1`.
5
5
  import { InvalidArgumentError } from 'commander';
6
6
  import { PrerequisitesNotSatisfiedError, LintGateError, TypeSanityViolationError, FileSizeViolationError } from '../../services/artifacts/request-artifact-service.js';
7
+ import { StateOrderViolationError } from '../../services/artifacts/request-state-order.js';
7
8
  import { ConfirmationRequiredError } from '../../services/mode/mode-enforcement.js';
8
9
  import { fail } from 'peaks-loop-shared/result';
9
- import { getErrorMessage, printResult } from '../cli-helpers.js';
10
+ import { getErrorMessage, printableWarningText, printResult } from '../cli-helpers.js';
11
+ /**
12
+ * The clause a soft-pass warning gains once its back-compat window has closed.
13
+ * It renders the `expiredWindow` the resolver set (the release the table
14
+ * declared, plus the build it was compared against) and is empty while the
15
+ * window is open — an open window is already the future tense the warning's own
16
+ * message uses, so it needs no clause.
17
+ *
18
+ * Shared with `printTransitionResult` in `request-transition-command.ts`: the
19
+ * success arm and this refusal arm render one fact one way, so an operator who
20
+ * sees the same soft pass through either arm reads the same sentence.
21
+ */
22
+ export function softWarningExpiryClause(warning) {
23
+ return warning.expiredWindow === undefined
24
+ ? ''
25
+ : ` — past expiry: ${printableWarningText(warning.expiredWindow)}`;
26
+ }
10
27
  function reportPrerequisitesFailure(io, options, error) {
11
28
  // The `warnings` list is surfaced inside the 1-minor-release back-compat
12
29
  // window (e.g. MUT_REPORT) so the operator sees both the hard-blocked
@@ -20,7 +37,11 @@ function reportPrerequisitesFailure(io, options, error) {
20
37
  warnings: error.warnings
21
38
  }, [
22
39
  ...error.missing.map((entry) => `Produce ${entry.path}: ${entry.description}`),
23
- ...error.warnings.map((w) => `Soft-blocked (v2.13.3 back-compat window): ${w.path} — ${w.message}`),
40
+ // Sanitised for the same reason the success branch sanitises: a
41
+ // `gateEvidence.<key>` warning can carry a control character decoded out
42
+ // of the handoff frontmatter, and `printResult` puts these on stderr.
43
+ ...error.warnings.map((w) => `Soft-blocked (v2.13.3 back-compat window): ${printableWarningText(w.path)} — ` +
44
+ `${printableWarningText(w.message)}${softWarningExpiryClause(w)}`),
24
45
  'Once every required artifact exists, rerun this transition.',
25
46
  'For exceptional cases (docs-only / config-only change), bypass with: --allow-incomplete --reason "<justification>"'
26
47
  ]), options.json);
@@ -34,6 +55,21 @@ function reportLintGateFailure(io, options, error) {
34
55
  ]), options.json);
35
56
  process.exitCode = 1;
36
57
  }
58
+ function reportStateOrderFailure(io, options, error) {
59
+ printResult(io, fail('request.transition', error.code, error.message, {
60
+ role: error.role,
61
+ from: error.from,
62
+ newState: error.to,
63
+ skipped: error.skipped
64
+ }, [
65
+ error.kind === 'unreadable'
66
+ ? "Restore the artifact's '- state:' line: an unreadable state fails this gate closed"
67
+ : `Walk the states in order — from '${error.from}' the next legal state is ` +
68
+ `'${error.skipped[0] ?? error.to}'`,
69
+ 'Or bypass with: --allow-incomplete --reason "<justification>"'
70
+ ]), options.json);
71
+ process.exitCode = 1;
72
+ }
37
73
  function reportTypeSanityFailure(io, options, error) {
38
74
  printResult(io, fail('request.transition', error.code, error.message, {
39
75
  declaredType: error.declaredType,
@@ -47,7 +83,9 @@ function reportTypeSanityFailure(io, options, error) {
47
83
  }
48
84
  function reportFileSizeFailure(io, options, error) {
49
85
  printResult(io, fail('request.transition', error.code, error.message, { violations: error.violations }, [
50
- ...error.violations.map((v) => `Split ${v.file} (${v.lines} lines) below its ${v.cap}-line cap`),
86
+ ...error.violations.map((v) => v.previousLines === null
87
+ ? `Split ${v.file} (${v.lines} lines) below its ${v.cap}-line cap — this change created it over the cap`
88
+ : `Split ${v.file} back below its ${v.cap}-line cap, or at least down to the ${v.previousLines} lines it had at the base ref (grew +${v.lines - v.previousLines})`),
51
89
  'Or bypass with: --allow-incomplete --reason "<justification>"'
52
90
  ]), options.json);
53
91
  process.exitCode = 1;
@@ -73,6 +111,10 @@ export function reportTransitionFailure(io, options, requestId, error) {
73
111
  reportLintGateFailure(io, options, error);
74
112
  return;
75
113
  }
114
+ if (error instanceof StateOrderViolationError) {
115
+ reportStateOrderFailure(io, options, error);
116
+ return;
117
+ }
76
118
  if (error instanceof TypeSanityViolationError) {
77
119
  reportTypeSanityFailure(io, options, error);
78
120
  return;
@@ -16,7 +16,7 @@ import { acceptanceCoverageNextActions, diffVsScopeNextActions, printAcceptanceC
16
16
  const REQUEST_TYPE_SANITY_DESCRIPTION = 'Cross-verify a declared --type against the actual git diff file mix (catches "feature mis-declared as docs" workflow violations)';
17
17
  const ACCEPTANCE_COVERAGE_DESCRIPTION = 'Verify every PRD "Acceptance criteria" item has at least one linked QA test case (via `- **Acceptance:** A1, A2` field in qa/test-cases/<rid>.md)';
18
18
  const DIFF_VS_SCOPE_DESCRIPTION = 'Verify every file in the git diff matches the RD artifact "Red-line scope" patterns; flags out-of-scope writes and unclassified files';
19
- const FILE_SIZE_DESCRIPTION = 'Check git diff for files exceeding a line count threshold (karpathy-skills "Simplicity First"; tool output, lockfiles and append-only records such as CHANGELOG.md excluded)';
19
+ const FILE_SIZE_DESCRIPTION = 'Check git diff for files this change grew past the line-count cap, or created over it (karpathy-skills "Simplicity First"; a file already over cap at the base ref is accepted, as the gate baseline ratchets it; a rename is measured against its pre-rename size; tool output, lockfiles and append-only records such as CHANGELOG.md excluded)';
20
20
  function runScanRequestTypeSanity(options, io) {
21
21
  try {
22
22
  const serviceOptions = {
@@ -108,7 +108,7 @@ function runScanFileSize(options, io) {
108
108
  });
109
109
  const nextActions = [];
110
110
  if (!result.ok) {
111
- nextActions.push(`${result.violations.length} file(s) exceed their file-size cap. Split into smaller modules.`);
111
+ nextActions.push(`${result.violations.length} file(s) exceed their file-size cap because this change grew them past it (or created them over it). Split into smaller modules.`);
112
112
  }
113
113
  printResult(io, ok('scan.file-size', result, [], nextActions), options.json);
114
114
  if (!result.ok) {
@@ -2,6 +2,14 @@ import { readFileSync } from 'node:fs';
2
2
  import { detectSecurityAudit, isSecurityAuditEnvelope, runSecurityAudit } from '../../services/audit-independent/index.js';
3
3
  import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
4
4
  import { fail, ok } from 'peaks-loop-shared/result';
5
+ /**
6
+ * The judged paths as the service takes them. A call, not a `??` inside the
7
+ * action, because the action's branch budget is already at its cap and a second
8
+ * operator there is a `complexity` finding on the whole command.
9
+ */
10
+ function resolveJudgedPaths(judged) {
11
+ return judged ?? [];
12
+ }
5
13
  function resolveEnvelope(envelopePath) {
6
14
  if (envelopePath === undefined || envelopePath === '-') {
7
15
  // Read from stdin
@@ -19,9 +27,7 @@ function readStdinSync() {
19
27
  // Node 22: read stdin synchronously via fs.readFileSync(0, 'utf8').
20
28
  // We use the file descriptor 0 convention.
21
29
  try {
22
- // Lazy import to avoid pulling readline at module load
23
- const { readFileSync: rfs } = require('node:fs');
24
- const raw = rfs(0, 'utf8');
30
+ const raw = readFileSync(0, 'utf8');
25
31
  if (raw.trim().length === 0) {
26
32
  throw new Error('stdin was empty; expected JSON envelope on stdin or --envelope <path>');
27
33
  }
@@ -63,7 +69,14 @@ export function registerSecurityAuditCommands(program, io) {
63
69
  });
64
70
  const envelope = detect.state === 'ready'
65
71
  ? ok('security-audit.detect', detect, [...detect.warnings], [...detect.nextActions])
66
- : fail('security-audit.detect', detect.state.toUpperCase().replace(/-/g, '_'), `security-audit is not ready: ${detect.state}`, detect, [...detect.nextActions]);
72
+ : {
73
+ // `fail()` builds `warnings: []`, so the detector's own diagnosis is
74
+ // spread over it. Without this the human-readable refusal drops the
75
+ // sentence saying WHY the run is not ready, while `--json` keeps it
76
+ // at `data.detect.warnings` — the 9.2 shape, one surface over.
77
+ ...fail('security-audit.detect', detect.state.toUpperCase().replace(/-/g, '_'), `security-audit is not ready: ${detect.state}`, detect, [...detect.nextActions]),
78
+ warnings: [...detect.warnings]
79
+ };
67
80
  printResult(io, envelope, options.json);
68
81
  if (detect.state !== 'ready') {
69
82
  process.exitCode = 1;
@@ -86,7 +99,8 @@ export function registerSecurityAuditCommands(program, io) {
86
99
  .option('--rid <rid>', 'request id (e.g. 2026-06-27-v2-12-...)')
87
100
  .option('--sid <sid>', 'session id (e.g. 2026-06-27-session-...)')
88
101
  .option('--project <path>', 'project root (default: cwd)')
89
- .option('--envelope <path>', 'path to envelope JSON file; "-" reads from stdin (default: stdin)')).action((options) => {
102
+ .option('--envelope <path>', 'path to envelope JSON file; "-" reads from stdin (default: stdin)')
103
+ .option('--judged <paths...>', 'project-relative paths this audit judged; written into the artifact as the declaration the rd:qa-handoff gate reads back. Not enforced by the parser: an empty or unhashable list is refused by the run itself, which exits 1 and writes nothing.')).action((options) => {
90
104
  const projectRoot = options.project ?? process.cwd();
91
105
  const sid = options.sid;
92
106
  const rid = options.rid;
@@ -115,10 +129,16 @@ export function registerSecurityAuditCommands(program, io) {
115
129
  sessionId: sid,
116
130
  rid,
117
131
  generatedAt: new Date().toISOString(),
132
+ judgedPaths: resolveJudgedPaths(options.judged),
118
133
  envelope: envelopeValue
119
134
  });
120
135
  if (result.detect.state !== 'ready' || result.artifactPath === null) {
121
- printResult(io, fail('security-audit.run', result.detect.state.toUpperCase().replace(/-/g, '_'), `security-audit is not ready: ${result.detect.state}`, result, [...result.detect.nextActions]), options.json);
136
+ printResult(io, {
137
+ // Same spread as the detect arm: the run's refusal is the only place
138
+ // the detector's warning would reach a person, and `fail()` empties it.
139
+ ...fail('security-audit.run', result.detect.state.toUpperCase().replace(/-/g, '_'), `security-audit is not ready: ${result.detect.state}`, result, [...result.detect.nextActions]),
140
+ warnings: [...result.detect.warnings]
141
+ }, options.json);
122
142
  process.exitCode = 1;
123
143
  return;
124
144
  }
@@ -0,0 +1,54 @@
1
+ /** Typed accessor over the flag map produced by `parseFlags`.
2
+ *
3
+ * `parseFlags` internally stores every flag with at least one value as a
4
+ * `string[]`. A flag with no following non-flag token (e.g. `--apply`,
5
+ * `--dry-run`) is recorded as `true`. This helper exposes three typed
6
+ * accessors so call-sites don't have to re-narrow `unknown` or
7
+ * `string | boolean | string[]` on every read:
8
+ *
9
+ * - `flags.list(name)` → `string[]` (always an array; a single
10
+ * occurrence is wrapped to a 1-element
11
+ * array at parse time)
12
+ * - `flags.bool(name)` → `boolean` (presence-of flag; missing
13
+ * flag is `false`)
14
+ * - `flags.maybeString(name)` → `string | undefined` (first value,
15
+ * or `undefined` if the flag was given
16
+ * as a bare boolean with no value)
17
+ *
18
+ * The dispatch layer (runSediment) was previously peppered with
19
+ * `typeof flags.x === "string"` / `Array.isArray(flags.x)` narrowing.
20
+ * With this helper the call-sites collapse to one-line reads and the
21
+ * raw flag map stops leaking across the runSediment boundary.
22
+ */
23
+ export declare class ParsedFlags {
24
+ private readonly raw;
25
+ constructor(raw: Record<string, string[] | true>);
26
+ /** Always returns an array. Missing flag → []. Single-occurrence
27
+ * flag → a 1-element array (parseFlags normalizes this). */
28
+ list(name: string): string[];
29
+ /** Presence-of a bare boolean flag. Missing → false. */
30
+ bool(name: string): boolean;
31
+ /** First value of a flag, or `undefined` if the flag is absent or
32
+ * was given as a bare boolean. */
33
+ maybeString(name: string): string | undefined;
34
+ }
35
+ /** Parse an argv tail into positional args + flag map.
36
+ *
37
+ * Supports:
38
+ * --flag value → flags[flag] = [value, ...] (advance i by 1)
39
+ * --flag → flags[flag] = true (when next token starts with `--` or is undefined)
40
+ * --flag v1 --flag v2 → repeated `--flag` values are accumulated
41
+ *
42
+ * Internally stores all values as `string[]` (or `true` for a bare
43
+ * boolean flag). Use the `ParsedFlags` helper to read typed accessors.
44
+ *
45
+ * Repeatable flag handling (Task 15b): when the same `--key` appears
46
+ * consecutively (e.g. `--segment a --segment b --segment c`), values
47
+ * are accumulated into a single `string[]`. A single occurrence is
48
+ * normalized to a 1-element array so callers can use `.list(name)`
49
+ * uniformly without shape-narrowing on the call-site.
50
+ */
51
+ export declare function parseFlags(argv: string[]): {
52
+ positional: string[];
53
+ flags: ParsedFlags;
54
+ };