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
@@ -5,84 +5,18 @@
5
5
  * prepare / node ack / node mark-lost / terminalize`. All commands
6
6
  * delegate to the canonical services. Each action emits the typed
7
7
  * envelope via `ok` / `fail` so the LLM runner can branch on `code`.
8
- */
9
- import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
10
- import { addJsonOption, printResult } from '../cli-helpers.js';
11
- import { resolveCallerId } from '../../services/session/resolve-caller-id.js';
12
- import { findProjectRoot } from '../../services/config/config-safety.js';
13
- import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
14
- import { initWorkflow, terminalizeWorkflow } from '../../services/workflow/workflow-presence-lifecycle.js';
15
- import { readGraph, emptyGraph } from '../../services/workflow/workflow-graph-store.js';
16
- import { WORKFLOW_ID_REGEX, TERMINAL_REASONS } from '../../services/workflow/workflow-graph-types.js';
17
- import { prepareNodeAction, transitionNode, transitionLease } from '../../services/workflow/workflow-node-lifecycle.js';
18
- function deriveCallerId() {
19
- try {
20
- return resolveCallerId({});
21
- }
22
- catch (err) {
23
- throw fail('workflow.init', 'PEAKS_CALLER_NOT_RESOLVED', getErrorMessage(err), { callerId: null }, ['Resolve the IDE session identity before running workflow commands.']);
24
- }
25
- }
26
- function deriveProjectRoot(options) {
27
- return options.project ?? process.cwd();
28
- }
29
- /**
30
- * The literal that means "no session could be resolved". Kept as a named
31
- * constant because three call sites now have to ASK whether resolution
32
- * failed rather than consume the value as if it were an id.
33
- */
34
- export const UNKNOWN_SESSION_ID = 'unknown-sid';
35
- /**
36
- * Resolve the session id for every `workflow *` command.
37
- *
38
- * Tier order (matches the idiom every other command family in this CLI
39
- * already uses — see `job-commands.ts:85`, `container-commands.ts:138`):
40
8
  *
41
- * 1. `--session-id <sid>` — explicit wins
42
- * 2. `PEAKS_SESSION_ID` env var — scripted / sub-process callers
43
- * 3. `getCurrentSessionId(projectRoot)` — this caller's OWN binding
44
- * (`callers/<callerId>.json`) falling back to the project-global
45
- * `.peaks/_runtime/session.json`, the same resolver `peaks session
46
- * info --active` and `peaks session checkpoint` use
47
- * 4. `unknown-sid` — nothing is bound
48
- *
49
- * Tier 3 was MISSING until 2026-09-15 (S6), and its absence is the whole
50
- * defect: `workflow init` resolved on tiers 1–2 only, so with no flag and no
51
- * env var it wrote the graph into `.peaks/_runtime/unknown-sid/graphs/`
52
- * regardless of what the binding file said. `peaks workflow node prepare`
53
- * then ran under the CORRECT session dir and reported `PEAKS_GRAPH_NOT_FOUND`
54
- * — the graph it was asking for had been written one bucket over. The bucket
55
- * accumulated artifacts from at least 4 distinct caller ids between 2026-09-01
56
- * and 2026-09-15, i.e. it had never worked for anyone.
57
- *
58
- * The same prior-art sweep (`.peaks/memory/archived/2026-06-26-unknown-sid-root-cause.md`)
59
- * converted six inline `?? 'unknown-sid'` sites to this 4-tier chain;
60
- * `workflow-lifecycle-commands.ts` was missed. This is that site.
61
- *
62
- * The project root passed to tier 3 goes through the same `findProjectRoot`
63
- * walk `session info` uses, so a command run from a SUBDIRECTORY of the
64
- * project resolves the project's binding instead of `cwd`'s (which has none).
9
+ * The verb implementations live beside this file, one module per verb group:
10
+ * `workflow-init-command.ts`, `workflow-graph-commands.ts`,
11
+ * `workflow-node-commands.ts`, `workflow-terminalize-command.ts`, with the
12
+ * option vocabulary and the caller / project / session derivation in
13
+ * `workflow-command-shared.ts`.
65
14
  */
66
- function deriveSessionId(options) {
67
- if (typeof options.sessionId === 'string' && options.sessionId.length > 0)
68
- return options.sessionId;
69
- const fromEnv = process.env.PEAKS_SESSION_ID;
70
- if (typeof fromEnv === 'string' && fromEnv.length > 0)
71
- return fromEnv;
72
- return (getCurrentSessionId(findProjectRoot(options.project ?? process.cwd()) ?? options.project ?? process.cwd()) ?? UNKNOWN_SESSION_ID);
73
- }
74
- /**
75
- * Tier 3 resolving to `unknown-sid` means NO session is bound at all. A
76
- * `workflow` subcommand that WRITES must fail loudly on that rather than
77
- * create a bucket named after a failure — `graph list` already does (see its
78
- * `PEAKS_SESSION_NOT_BOUND` guard below); `init` did not.
79
- */
80
- function buildSessionNotBoundEnvelope(sessionId, projectRoot) {
81
- return fail('workflow.init', 'PEAKS_SESSION_NOT_BOUND', `No peaks session is bound for '${projectRoot}' (derived session id '${sessionId}'): --session-id, PEAKS_SESSION_ID and the project binding are all absent.`, { workflowId: null }, [
82
- 'Run `peaks workspace init --project <p>` to bind a session, then re-run.',
83
- 'Or pass `--session-id <sid>` explicitly.'
84
- ]);
85
- }
15
+ import { registerWorkflowGraphCommands } from './workflow-graph-commands.js';
16
+ import { registerWorkflowInitCommand } from './workflow-init-command.js';
17
+ import { registerWorkflowNodeCommands } from './workflow-node-commands.js';
18
+ import { registerWorkflowTerminalizeCommand } from './workflow-terminalize-command.js';
19
+ export { UNKNOWN_SESSION_ID } from './workflow-command-shared.js';
86
20
  export function registerWorkflowLifecycleCommand(parent, io) {
87
21
  // Reuse the existing `workflow` parent (created by `registerWorkflowCommands`)
88
22
  // to avoid Commander.js's "cannot add command 'workflow' as already have
@@ -90,276 +24,8 @@ export function registerWorkflowLifecycleCommand(parent, io) {
90
24
  const existingWorkflow = parent.commands.find((c) => c.name() === 'workflow');
91
25
  const workflow = existingWorkflow ??
92
26
  parent.command('workflow').description('workflow lifecycle commands (RD §4)');
93
- addJsonOption(workflow
94
- .command('init')
95
- .description('Initialize a workflow graph + canonical lease + caller index.')
96
- .requiredOption('--skill <name>', 'the skill owning this workflow (e.g. peaks-code)')
97
- .option('--workflow-id <id>', 'optional explicit workflowId (auto-generated if omitted)')
98
- .option('--parent-workflow <id>', 'parent workflowId for nested runs')
99
- .option('--session-id <sid>', 'override session id (default: derived from session.json / env)')
100
- .option('--project <path>', 'target project root (defaults to cwd)')).action(async (options) => {
101
- const asJson = options.json === true;
102
- try {
103
- const callerId = deriveCallerId();
104
- const projectRoot = deriveProjectRoot(options);
105
- const sessionId = deriveSessionId(options);
106
- if (sessionId === UNKNOWN_SESSION_ID) {
107
- printResult(io, buildSessionNotBoundEnvelope(sessionId, projectRoot), asJson);
108
- process.exitCode = 1;
109
- return;
110
- }
111
- const workflowId = options.workflowId ?? `wf-${Date.now().toString(36)}`;
112
- if (!WORKFLOW_ID_REGEX.test(workflowId)) {
113
- throw new Error(`workflowId shape invalid: ${workflowId}`);
114
- }
115
- const result = await initWorkflow({
116
- projectRoot,
117
- sessionId,
118
- callerId,
119
- skill: options.skill ?? 'peaks-code',
120
- workflowId,
121
- ...(options.parentWorkflow ? { parentWorkflowId: options.parentWorkflow } : {})
122
- });
123
- printResult(io, ok('workflow.init', {
124
- envelopeVersion: '4.0.8',
125
- workflowId: result.workflowId,
126
- graphRef: result.graphRef,
127
- events: result.events
128
- }), asJson);
129
- }
130
- catch (err) {
131
- const code = err.code ?? 'PEAKS_GRAPH_WRITE_FAILED';
132
- printResult(io, fail('workflow.init', code, getErrorMessage(err), { workflowId: null }, []), asJson);
133
- process.exitCode = 1;
134
- }
135
- });
136
- // Note: `.command('graph show')` and `.command('graph list')` each
137
- // implicitly create a NEW `graph` parent under `workflow` in
138
- // Commander v12 (no auto-reuse), so calling them in sequence throws
139
- // "cannot add command 'graph' as already have command 'graph'" at
140
- // startup. Reuse the first created `graph` parent for the second
141
- // registration.
142
- const graphCmd = workflow.command('graph').description('workflow graph read commands');
143
- graphCmd
144
- .command('show')
145
- .description('Read a workflow graph.')
146
- .option('--workflow <id>', 'workflow id')
147
- .option('--session-id <sid>', 'session id')
148
- .option('--project <path>', 'project root')
149
- .option('--json', 'json output')
150
- .action((options) => {
151
- const asJson = options.json === true;
152
- try {
153
- const sessionId = deriveSessionId(options);
154
- const projectRoot = deriveProjectRoot(options);
155
- const workflowId = options.workflow ?? '';
156
- if (!workflowId || !WORKFLOW_ID_REGEX.test(workflowId)) {
157
- throw new Error('workflowId is required');
158
- }
159
- const graph = readGraph({
160
- projectRoot,
161
- sessionId,
162
- graphRef: `graphs/${workflowId}.json`,
163
- workflowId
164
- });
165
- printResult(io, ok('workflow.graph.show', { envelopeVersion: '4.0.8', graph }), asJson);
166
- }
167
- catch (err) {
168
- const code = err.code ?? 'PEAKS_GRAPH_NOT_FOUND';
169
- printResult(io, fail('workflow.graph.show', code, getErrorMessage(err), { graph: null }, []), asJson);
170
- process.exitCode = 1;
171
- }
172
- });
173
- graphCmd
174
- .command('list')
175
- .description('List workflow graphs (metadata only).')
176
- .option('--session-id <sid>', 'session id')
177
- .option('--project <path>', 'project root')
178
- .option('--json', 'json output')
179
- .action((options) => {
180
- const asJson = options.json === true;
181
- try {
182
- const sessionId = deriveSessionId(options);
183
- if (sessionId === UNKNOWN_SESSION_ID) {
184
- throw new Error('PEAKS_SESSION_NOT_BOUND: no session id');
185
- }
186
- const result = { envelopeVersion: '4.0.8', sessionId, graphs: [] };
187
- printResult(io, ok('workflow.graph.list', result), asJson);
188
- }
189
- catch (err) {
190
- const code = err.code ?? 'PEAKS_SESSION_NOT_BOUND';
191
- printResult(io, fail('workflow.graph.list', code, getErrorMessage(err), { graphs: [] }, []), asJson);
192
- process.exitCode = 1;
193
- }
194
- });
195
- // Reuse one `node` parent for prepare / ack / mark-lost (Commander v12
196
- // creates a NEW parent per `.command('node X')` call, so we must
197
- // explicitly create the parent first to avoid duplicate-registration).
198
- const nodeCmd = workflow.command('node').description('workflow node commands');
199
- nodeCmd
200
- .command('prepare')
201
- .description('Prepare a node in a workflow graph.')
202
- .option('--workflow <id>', 'workflow id')
203
- .option('--node <id>', 'node id')
204
- .option('--kind <k>', 'node kind: step | dispatch | terminal')
205
- .option('--label <text>', 'human-readable label')
206
- .option('--depends-on <ids>', 'comma-separated list of dependency node ids')
207
- .option('--session-id <sid>', 'session id')
208
- .option('--project <path>', 'project root')
209
- .option('--json', 'json output')
210
- .action((options) => {
211
- const asJson = options.json === true;
212
- try {
213
- const sessionId = deriveSessionId(options);
214
- const projectRoot = deriveProjectRoot(options);
215
- const workflowId = options.workflow ?? '';
216
- if (!workflowId || !WORKFLOW_ID_REGEX.test(workflowId)) {
217
- throw new Error('workflowId is required');
218
- }
219
- const graphRef = `graphs/${workflowId}.json`;
220
- const existing = readGraph({ projectRoot, sessionId, graphRef, workflowId });
221
- const nodeId = options.node ?? `node-${Date.now().toString(36)}`;
222
- const kind = (options.kind ?? 'step');
223
- const dependsOn = (options.dependsOn ?? '')
224
- .split(',')
225
- .map((s) => s.trim())
226
- .filter((s) => s.length > 0);
227
- const updated = prepareNodeAction({
228
- workflowId,
229
- nodeId,
230
- graphNode: existing.nodes.find((n) => n.id === nodeId) ?? {
231
- id: nodeId,
232
- kind,
233
- label: options.label ?? nodeId,
234
- status: 'prepared',
235
- dependsOn
236
- },
237
- dependsOn,
238
- status: 'prepared'
239
- });
240
- // Persist via the graph store
241
- // (not inlined so the CLI delegates everything to the service).
242
- printResult(io, ok('workflow.node.prepare', { envelopeVersion: '4.0.8', graph: updated }), asJson);
243
- }
244
- catch (err) {
245
- const code = err.code ?? 'PEAKS_GRAPH_CORRUPTED';
246
- printResult(io, fail('workflow.node.prepare', code, getErrorMessage(err), { graph: null }, []), asJson);
247
- process.exitCode = 1;
248
- }
249
- });
250
- nodeCmd
251
- .command('ack')
252
- .description('Acknowledge a node that has an envelope-received status.')
253
- .option('--workflow <id>', 'workflow id')
254
- .option('--node <id>', 'node id')
255
- .option('--session-id <sid>', 'session id')
256
- .option('--project <path>', 'project root')
257
- .option('--json', 'json output')
258
- .action((options) => {
259
- const asJson = options.json === true;
260
- try {
261
- const sessionId = deriveSessionId(options);
262
- const projectRoot = deriveProjectRoot(options);
263
- const workflowId = options.workflow ?? '';
264
- if (!workflowId)
265
- throw new Error('workflowId is required');
266
- const graphRef = `graphs/${workflowId}.json`;
267
- const graph = readGraph({ projectRoot, sessionId, graphRef, workflowId });
268
- const nodeId = options.node ?? '';
269
- const node = graph.nodes.find((n) => n.id === nodeId);
270
- if (!node)
271
- throw new Error(`node ${nodeId} not found`);
272
- if (node.status !== 'envelope-received') {
273
- throw new Error('PEAKS_ENVELOPE_NOT_RECEIVED: node is not envelope-received');
274
- }
275
- const updated = transitionNode(node.status, 'consumed-by-parent', { graphNode: node });
276
- printResult(io, ok('workflow.node.ack', { envelopeVersion: '4.0.8', node: updated }), asJson);
277
- }
278
- catch (err) {
279
- const code = err.code ?? 'PEAKS_ENVELOPE_NOT_RECEIVED';
280
- printResult(io, fail('workflow.node.ack', code, getErrorMessage(err), { node: null }, []), asJson);
281
- process.exitCode = 1;
282
- }
283
- });
284
- nodeCmd
285
- .command('mark-lost')
286
- .description('Mark a node as lost.')
287
- .option('--workflow <id>', 'workflow id')
288
- .option('--node <id>', 'node id')
289
- .option('--reason <reason>', `terminal reason: ${TERMINAL_REASONS.join(' | ')}`)
290
- .option('--session-id <sid>', 'session id')
291
- .option('--project <path>', 'project root')
292
- .option('--json', 'json output')
293
- .action((options) => {
294
- const asJson = options.json === true;
295
- try {
296
- const workflowId = options.workflow ?? '';
297
- if (!workflowId)
298
- throw new Error('workflowId is required');
299
- const nodeId = options.node ?? '';
300
- if (!nodeId)
301
- throw new Error('nodeId is required');
302
- const reason = options.reason ?? 'unknown';
303
- if (!TERMINAL_REASONS.includes(reason)) {
304
- throw new Error(`PEAKS_TERMINAL_REASON_INVALID: ${reason}`);
305
- }
306
- printResult(io, ok('workflow.node.mark-lost', {
307
- envelopeVersion: '4.0.8',
308
- workflowId,
309
- nodeId,
310
- status: 'lost',
311
- terminalReason: reason
312
- }), asJson);
313
- }
314
- catch (err) {
315
- const code = err.code ?? 'PEAKS_TERMINAL_REASON_INVALID';
316
- printResult(io, fail('workflow.node.mark-lost', code, getErrorMessage(err), { node: null }, []), asJson);
317
- process.exitCode = 1;
318
- }
319
- });
320
- addJsonOption(workflow
321
- .command('terminalize')
322
- .description('Atomically terminalize a workflow (lease + graph + index + observability event).')
323
- .requiredOption('--workflow <id>', 'workflow id')
324
- .requiredOption('--reason <reason>', `terminal reason: ${TERMINAL_REASONS.join(' | ')}`)
325
- .option('--session-id <sid>', 'session id')
326
- .option('--project <path>', 'project root')
327
- .option('--require-consumed', 'fail if there are unconsumed envelopes')).action(async (options) => {
328
- const asJson = options.json === true;
329
- try {
330
- const callerId = deriveCallerId();
331
- const sessionId = deriveSessionId(options);
332
- const projectRoot = deriveProjectRoot(options);
333
- const workflowId = options.workflow ?? '';
334
- if (!workflowId)
335
- throw new Error('workflowId is required');
336
- if (!TERMINAL_REASONS.includes(options.reason)) {
337
- throw new Error(`PEAKS_TERMINAL_REASON_INVALID: ${options.reason}`);
338
- }
339
- const result = await terminalizeWorkflow({
340
- projectRoot,
341
- sessionId,
342
- callerId,
343
- workflowId,
344
- graphRef: `graphs/${workflowId}.json`,
345
- reason: options.reason,
346
- ...(options.requireConsumed ? { requireConsumed: true } : {})
347
- });
348
- printResult(io, ok('workflow.terminalize', {
349
- envelopeVersion: '4.0.8',
350
- lease: result.lease,
351
- graph: result.graph,
352
- events: result.events,
353
- indexCleared: result.indexCleared
354
- }), asJson);
355
- }
356
- catch (err) {
357
- const code = err.code ?? 'PEAKS_TERMINALIZE_ATOMICITY_FAILED';
358
- printResult(io, fail('workflow.terminalize', code, getErrorMessage(err), { lease: null }, []), asJson);
359
- process.exitCode = 1;
360
- }
361
- });
362
- // Suppress unused-import warnings for symbols reserved for future slices.
363
- void transitionLease;
364
- void emptyGraph;
27
+ registerWorkflowInitCommand(workflow, io);
28
+ registerWorkflowGraphCommands(workflow, io);
29
+ registerWorkflowNodeCommands(workflow, io);
30
+ registerWorkflowTerminalizeCommand(workflow, io);
365
31
  }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerWorkflowNodeCommands(workflow: Command, io: ProgramIO): void;
@@ -0,0 +1,154 @@
1
+ // src/cli/commands/workflow-node-commands.ts
2
+ //
3
+ // `peaks workflow node prepare` / `node ack` / `node mark-lost` — the workflow
4
+ // node lifecycle verbs. Split out of `workflow-lifecycle-commands.ts`; every
5
+ // verb name, option and envelope shape is unchanged.
6
+ import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
7
+ import { printResult } from '../cli-helpers.js';
8
+ import { readGraph } from '../../services/workflow/workflow-graph-store.js';
9
+ import { prepareNodeAction, transitionNode } from '../../services/workflow/workflow-node-lifecycle.js';
10
+ import { TERMINAL_REASONS, WORKFLOW_ID_REGEX } from '../../services/workflow/workflow-graph-types.js';
11
+ import { deriveProjectRoot, deriveSessionId, GENERATED_ID_RADIX } from './workflow-command-shared.js';
12
+ /** The comma-separated `--depends-on` list, trimmed, with empties removed. */
13
+ function parseDependsOn(raw) {
14
+ return (raw ?? '')
15
+ .split(',')
16
+ .map((s) => s.trim())
17
+ .filter((s) => s.length > 0);
18
+ }
19
+ /** The node this `prepare` acts on: the one already in the graph, or the new default. */
20
+ function prepareGraphNode(existing, request) {
21
+ return (existing.nodes.find((n) => n.id === request.nodeId) ?? {
22
+ id: request.nodeId,
23
+ kind: request.kind,
24
+ label: request.label ?? request.nodeId,
25
+ status: 'prepared',
26
+ dependsOn: request.dependsOn
27
+ });
28
+ }
29
+ function runWorkflowNodePrepare(io, options) {
30
+ const asJson = options.json === true;
31
+ try {
32
+ const sessionId = deriveSessionId(options);
33
+ const projectRoot = deriveProjectRoot(options);
34
+ const workflowId = options.workflow ?? '';
35
+ if (!workflowId || !WORKFLOW_ID_REGEX.test(workflowId)) {
36
+ throw new Error('workflowId is required');
37
+ }
38
+ const graphRef = `graphs/${workflowId}.json`;
39
+ const existing = readGraph({ projectRoot, sessionId, graphRef, workflowId });
40
+ const nodeId = options.node ?? `node-${Date.now().toString(GENERATED_ID_RADIX)}`;
41
+ const kind = (options.kind ?? 'step');
42
+ const dependsOn = parseDependsOn(options.dependsOn);
43
+ const updated = prepareNodeAction({
44
+ workflowId,
45
+ nodeId,
46
+ graphNode: prepareGraphNode(existing, {
47
+ nodeId,
48
+ kind,
49
+ label: options.label,
50
+ dependsOn
51
+ }),
52
+ dependsOn,
53
+ status: 'prepared'
54
+ });
55
+ // Persist via the graph store
56
+ // (not inlined so the CLI delegates everything to the service).
57
+ printResult(io, ok('workflow.node.prepare', { envelopeVersion: '4.0.8', graph: updated }), asJson);
58
+ }
59
+ catch (err) {
60
+ const code = err.code ?? 'PEAKS_GRAPH_CORRUPTED';
61
+ printResult(io, fail('workflow.node.prepare', code, getErrorMessage(err), { graph: null }, []), asJson);
62
+ process.exitCode = 1;
63
+ }
64
+ }
65
+ function runWorkflowNodeAck(io, options) {
66
+ const asJson = options.json === true;
67
+ try {
68
+ const sessionId = deriveSessionId(options);
69
+ const projectRoot = deriveProjectRoot(options);
70
+ const workflowId = options.workflow ?? '';
71
+ if (!workflowId)
72
+ throw new Error('workflowId is required');
73
+ const graphRef = `graphs/${workflowId}.json`;
74
+ const graph = readGraph({ projectRoot, sessionId, graphRef, workflowId });
75
+ const nodeId = options.node ?? '';
76
+ const node = graph.nodes.find((n) => n.id === nodeId);
77
+ if (!node)
78
+ throw new Error(`node ${nodeId} not found`);
79
+ if (node.status !== 'envelope-received') {
80
+ throw new Error('PEAKS_ENVELOPE_NOT_RECEIVED: node is not envelope-received');
81
+ }
82
+ const updated = transitionNode(node.status, 'consumed-by-parent', { graphNode: node });
83
+ printResult(io, ok('workflow.node.ack', { envelopeVersion: '4.0.8', node: updated }), asJson);
84
+ }
85
+ catch (err) {
86
+ const code = err.code ?? 'PEAKS_ENVELOPE_NOT_RECEIVED';
87
+ printResult(io, fail('workflow.node.ack', code, getErrorMessage(err), { node: null }, []), asJson);
88
+ process.exitCode = 1;
89
+ }
90
+ }
91
+ function runWorkflowNodeMarkLost(io, options) {
92
+ const asJson = options.json === true;
93
+ try {
94
+ const workflowId = options.workflow ?? '';
95
+ if (!workflowId)
96
+ throw new Error('workflowId is required');
97
+ const nodeId = options.node ?? '';
98
+ if (!nodeId)
99
+ throw new Error('nodeId is required');
100
+ const reason = options.reason ?? 'unknown';
101
+ if (!TERMINAL_REASONS.includes(reason)) {
102
+ throw new Error(`PEAKS_TERMINAL_REASON_INVALID: ${reason}`);
103
+ }
104
+ printResult(io, ok('workflow.node.mark-lost', {
105
+ envelopeVersion: '4.0.8',
106
+ workflowId,
107
+ nodeId,
108
+ status: 'lost',
109
+ terminalReason: reason
110
+ }), asJson);
111
+ }
112
+ catch (err) {
113
+ const code = err.code ?? 'PEAKS_TERMINAL_REASON_INVALID';
114
+ printResult(io, fail('workflow.node.mark-lost', code, getErrorMessage(err), { node: null }, []), asJson);
115
+ process.exitCode = 1;
116
+ }
117
+ }
118
+ export function registerWorkflowNodeCommands(workflow, io) {
119
+ // Reuse one `node` parent for prepare / ack / mark-lost (Commander v12
120
+ // creates a NEW parent per `.command('node X')` call, so we must
121
+ // explicitly create the parent first to avoid duplicate-registration).
122
+ const nodeCmd = workflow.command('node').description('workflow node commands');
123
+ nodeCmd
124
+ .command('prepare')
125
+ .description('Prepare a node in a workflow graph.')
126
+ .option('--workflow <id>', 'workflow id')
127
+ .option('--node <id>', 'node id')
128
+ .option('--kind <k>', 'node kind: step | dispatch | terminal')
129
+ .option('--label <text>', 'human-readable label')
130
+ .option('--depends-on <ids>', 'comma-separated list of dependency node ids')
131
+ .option('--session-id <sid>', 'session id')
132
+ .option('--project <path>', 'project root')
133
+ .option('--json', 'json output')
134
+ .action((options) => runWorkflowNodePrepare(io, options));
135
+ nodeCmd
136
+ .command('ack')
137
+ .description('Acknowledge a node that has an envelope-received status.')
138
+ .option('--workflow <id>', 'workflow id')
139
+ .option('--node <id>', 'node id')
140
+ .option('--session-id <sid>', 'session id')
141
+ .option('--project <path>', 'project root')
142
+ .option('--json', 'json output')
143
+ .action((options) => runWorkflowNodeAck(io, options));
144
+ nodeCmd
145
+ .command('mark-lost')
146
+ .description('Mark a node as lost.')
147
+ .option('--workflow <id>', 'workflow id')
148
+ .option('--node <id>', 'node id')
149
+ .option('--reason <reason>', `terminal reason: ${TERMINAL_REASONS.join(' | ')}`)
150
+ .option('--session-id <sid>', 'session id')
151
+ .option('--project <path>', 'project root')
152
+ .option('--json', 'json output')
153
+ .action((options) => runWorkflowNodeMarkLost(io, options));
154
+ }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerWorkflowTerminalizeCommand(workflow: Command, io: ProgramIO): void;
@@ -0,0 +1,56 @@
1
+ // src/cli/commands/workflow-terminalize-command.ts
2
+ //
3
+ // `peaks workflow terminalize` — atomically terminalize a workflow (lease +
4
+ // graph + index + observability event). Split out of
5
+ // `workflow-lifecycle-commands.ts`; the verb name, its options, the
6
+ // `--require-consumed` passthrough and the envelope shape are unchanged.
7
+ import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
8
+ import { addJsonOption, printResult } from '../cli-helpers.js';
9
+ import { terminalizeWorkflow } from '../../services/workflow/workflow-presence-lifecycle.js';
10
+ import { TERMINAL_REASONS } from '../../services/workflow/workflow-graph-types.js';
11
+ import { deriveCallerId, deriveProjectRoot, deriveSessionId } from './workflow-command-shared.js';
12
+ async function runWorkflowTerminalize(io, options) {
13
+ const asJson = options.json === true;
14
+ try {
15
+ const callerId = deriveCallerId();
16
+ const sessionId = deriveSessionId(options);
17
+ const projectRoot = deriveProjectRoot(options);
18
+ const workflowId = options.workflow ?? '';
19
+ if (!workflowId)
20
+ throw new Error('workflowId is required');
21
+ if (!TERMINAL_REASONS.includes(options.reason)) {
22
+ throw new Error(`PEAKS_TERMINAL_REASON_INVALID: ${options.reason}`);
23
+ }
24
+ const result = await terminalizeWorkflow({
25
+ projectRoot,
26
+ sessionId,
27
+ callerId,
28
+ workflowId,
29
+ graphRef: `graphs/${workflowId}.json`,
30
+ reason: options.reason,
31
+ ...(options.requireConsumed ? { requireConsumed: true } : {})
32
+ });
33
+ printResult(io, ok('workflow.terminalize', {
34
+ envelopeVersion: '4.0.8',
35
+ lease: result.lease,
36
+ graph: result.graph,
37
+ events: result.events,
38
+ indexCleared: result.indexCleared
39
+ }), asJson);
40
+ }
41
+ catch (err) {
42
+ const code = err.code ?? 'PEAKS_TERMINALIZE_ATOMICITY_FAILED';
43
+ printResult(io, fail('workflow.terminalize', code, getErrorMessage(err), { lease: null }, []), asJson);
44
+ process.exitCode = 1;
45
+ }
46
+ }
47
+ export function registerWorkflowTerminalizeCommand(workflow, io) {
48
+ addJsonOption(workflow
49
+ .command('terminalize')
50
+ .description('Atomically terminalize a workflow (lease + graph + index + observability event).')
51
+ .requiredOption('--workflow <id>', 'workflow id')
52
+ .requiredOption('--reason <reason>', `terminal reason: ${TERMINAL_REASONS.join(' | ')}`)
53
+ .option('--session-id <sid>', 'session id')
54
+ .option('--project <path>', 'project root')
55
+ .option('--require-consumed', 'fail if there are unconsumed envelopes')).action((options) => runWorkflowTerminalize(io, options));
56
+ }
@@ -66,7 +66,7 @@ function printGcOk(io, options, ctx) {
66
66
  dryRun
67
67
  ? `[dry-run] Would gc ${swept.length} lease(s); no filesystem changes were made.`
68
68
  : `Gc'd ${swept.length} lease(s).`,
69
- 'For per-lease detail, run `peaks worktree status --lease-id <id>`.'
69
+ 'For per-lease detail, run `peaks worktree lease-status --lease-id <id>`.'
70
70
  ]), options.json);
71
71
  }
72
72
  function printGcFailed(io, options, err, sessionId) {
@@ -0,0 +1,53 @@
1
+ import { type RequestType } from './artifact-prerequisites.js';
2
+ import { type RequestTypeSource } from './request-artifact-metadata.js';
3
+ /**
4
+ * The block, or `''` when this role has nothing gated to say under this type.
5
+ * The empty string is the whole byte-identity contract: callers concatenate it,
6
+ * and a role with no gated artifacts must add zero bytes to the prompt.
7
+ */
8
+ export declare function buildArtifactContractBlock(input: {
9
+ role: string;
10
+ requestType: RequestType;
11
+ requestTypeSource: RequestTypeSource;
12
+ requestId: string;
13
+ }): string;
14
+ /**
15
+ * Append the block unless the text already carries one.
16
+ *
17
+ * Idempotent for the same reason `ensureKarpathyBlock` is: a caller prompt can
18
+ * already hold a copy — a re-dispatch, or a resume from a stored prompt — and
19
+ * two sections can DISAGREE (the type may have been declared between the two
20
+ * runs), so a reader cannot tell which contract is authoritative. The presence
21
+ * test is the block's own heading, which nothing else emits.
22
+ *
23
+ * An empty block adds zero bytes even when the text already carries one, so an
24
+ * unaffected dispatch stays byte-identical.
25
+ */
26
+ export declare function ensureArtifactContractBlock(text: string, block: string): string;
27
+ export type ArtifactTypeReading = {
28
+ requestType: RequestType;
29
+ requestTypeSource: RequestTypeSource;
30
+ };
31
+ /**
32
+ * The type recorded for `requestId`, read through the same reader the rest of
33
+ * the CLI uses. Every request artifact of the id is a candidate because the
34
+ * dispatched role's own file frequently does not exist yet at dispatch time —
35
+ * a dated snapshot over the dispatch records of the 2026-10-12 session (77 of
36
+ * them at the time of writing, a count the session is still growing): 18 had any
37
+ * request artifact for the id on disk before the dispatch and 10 had one that
38
+ * declared a type — while a sibling role may have recorded the type already. A
39
+ * `default` result is a real answer — nothing declared it.
40
+ */
41
+ export declare function readArtifactType(input: {
42
+ projectRoot: string;
43
+ sessionId: string;
44
+ requestId: string;
45
+ role: string;
46
+ }): Promise<ArtifactTypeReading>;
47
+ /** The composed block for a dispatch, reading the type from disk first. */
48
+ export declare function readArtifactContractBlock(input: {
49
+ projectRoot: string;
50
+ sessionId: string;
51
+ requestId: string;
52
+ role: string;
53
+ }): Promise<string>;