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
@@ -1,283 +1,113 @@
1
1
  /**
2
+ * The `--from-dag` path of `peaks sub-agent dispatch`.
2
3
  *
3
- * Pulled out of `dispatch-commands.ts` to honor the 800-line file cap
4
- * (Karpathy #2 Simplicity First). The single-dispatch action stays in
5
- * `dispatch-commands.ts`; the DAG-dispatch path lives here because the
6
- * two paths share no logic — the warm-path single dispatch does NOT
7
- * load slice-dag / dag-orchestrator / contract-store (slice 9 perf),
8
- * while the --from-dag codepath loads all three on first call.
4
+ * Pulled out of `dispatch-commands.ts` to honor the file-size cap (Karpathy #2
5
+ * Simplicity First). The single-dispatch action stays in `dispatch-commands.ts`;
6
+ * the DAG-dispatch path lives here because the two share no logic — the
7
+ * warm-path single dispatch does NOT load slice-dag / dag-orchestrator /
8
+ * contract-store (slice 9 perf), while the `--from-dag` codepath loads all
9
+ * three on first call.
9
10
  *
10
- * 2.7.0 slice-dag-dispatcher MVP: read a SliceDag from a file and run
11
- * it through `runDag`. The orchestrator's `runSlice` is a thin wrapper
12
- * that emits the per-IDE `buildToolCall` envelope for each topological
13
- * level.
11
+ * 2.7.0 slice-dag-dispatcher MVP: read a SliceDag from a file and run it
12
+ * through `runLayeredDag`. The orchestrator's `runSlice` is a thin wrapper
13
+ * that emits the per-IDE `buildToolCall` envelope for each topological level.
14
14
  *
15
15
  * 1.2 MVP scope: this dispatches the FIRST topological level synchronously
16
- * (returns the dispatch specs); subsequent levels are not surfaced in
17
- * the CLI envelope because the LLM-side runner must actually execute
18
- * each `buildToolCall` and write the resulting contract before level 2+
19
- * can be safely auto-advanced. The LLM re-invokes
20
- * `peaks sub-agent dispatch --from-dag <file> --batch-id <id>` after
21
- * writing level-1 contracts, which causes runDag to plan level 2+ with
22
- * the level-1 ancestor contracts spliced into their dispatch prompts.
16
+ * (returns the dispatch specs); subsequent levels are not surfaced in the CLI
17
+ * envelope because the LLM-side runner must actually execute each
18
+ * `buildToolCall` and write the resulting contract before level 2+ can be
19
+ * safely auto-advanced. The LLM re-invokes `peaks sub-agent dispatch --from-dag
20
+ * <file> --batch-id <id>` after writing level-1 contracts, which causes
21
+ * `runLayeredDag` to plan level 2+ with the level-1 ancestor contracts spliced
22
+ * into their dispatch prompts.
23
23
  *
24
- * Internally, runDag DOES iterate all levels so its join-barrier +
25
- * cancel-on-fail path is exercised end-to-end during the MVP emit; only
26
- * the CLI envelope is filtered to level-1 toolCalls (see `firstLevelIds`).
24
+ * Internally, `runLayeredDag` DOES iterate all levels so its join-barrier +
25
+ * cancel-on-fail path is exercised end-to-end during the MVP emit; only the
26
+ * CLI envelope is filtered to level-1 toolCalls (see `firstLevelIds`).
27
27
  */
28
- import { randomUUID } from 'node:crypto';
29
28
  import { printResult } from '../cli-helpers.js';
30
- import { fail, ok } from 'peaks-loop-shared/result';
31
- import { detectInstalledIde } from '../../services/ide/ide-detector.js';
32
- import { getAdapter } from '../../services/ide/ide-registry.js';
33
- import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
34
- import { planFileOverlapWaves } from '../../services/dispatch/file-overlap-wave-planner.js';
29
+ import { buildDagSuccessEnvelope } from './dispatch-dag-envelope.js';
30
+ import { emitDagFailure } from './dispatch-dag-failure.js';
31
+ import { assertGraphNodesMapped, loadDagRuntime, readDagOrFail, resolveDagIds, topologicalLevelsOrFail } from './dispatch-dag-preflight.js';
32
+ import { makeCliRunner, makeNoopWriter, planFirstLevelWaves, resolveDagDispatcher } from './dispatch-dag-runners.js';
35
33
  export async function runDispatchFromDag(role, options, asJson, io) {
36
34
  if (!options.fromDag)
37
35
  return;
38
- const projectRoot = options.project ?? process.cwd();
39
- // Auto-resolve sid from .peaks/_runtime/session.json before falling back.
40
- const sid = options.sessionId ??
41
- process.env.PEAKS_SESSION_ID ??
42
- getCurrentSessionId(projectRoot) ??
43
- 'unknown-sid';
44
- const rid = options.requestId ?? 'unknown-rid';
45
- const batchId = options.batchId ?? randomUUID();
46
- // Slice 9 (dispatch CLI latency): the --from-dag codepath loads three
47
- // heavy modules (slice-dag, dag-orchestrator, contract-store) that
48
- // transitively import 10+ more services. They are NOT touched by the
49
- // warm-path single-dispatch action, so we lazy-load them here only
50
- // when --from-dag is actually requested. The dynamic-import promise
51
- // resolves on first call, then ESM caches the module for subsequent
52
- // calls in the same process.
53
- const [{ readFileSync }, sliceDagMod, dagOrchestratorMod, contractStoreMod] = await Promise.all([
54
- import('node:fs'),
55
- import('../../services/dispatch/slice-dag.js'),
56
- import('../../services/code/dag-orchestrator.js'),
57
- import('../../services/dispatch/contract-store.js')
58
- ]);
59
- const { validateDag, topologicalLevels, isSliceComplexity } = sliceDagMod;
60
- const { runLayeredDag } = dagOrchestratorMod;
61
- const { listContracts, hashContract } = contractStoreMod;
62
- let dag;
63
- try {
64
- const raw = readFileSync(options.fromDag, 'utf8');
65
- const parsed = JSON.parse(raw);
66
- validateDag(parsed);
67
- dag = parsed;
68
- }
69
- catch (err) {
70
- printResult(io, fail('sub-agent.dispatch', 'INVALID_DAG', `failed to read or validate DAG from ${options.fromDag}: ${err.message}`, { role, toolCall: null, dispatchRecordPath: null }, [
71
- 'Check the JSON file at the given path; the DAG must have {nodes, edges} and pass validateDag().'
72
- ]), asJson);
73
- process.exitCode = 1;
36
+ const scope = { role, asJson, io };
37
+ const ids = resolveDagIds(options);
38
+ const runtime = await loadDagRuntime();
39
+ const dag = readDagOrFail(runtime, options.fromDag, scope);
40
+ if (dag === null)
74
41
  return;
75
- }
76
- // Slice 4.0.8 RD §4 D4c: each DAG node must map to an explicitly
77
- // prepared workflow graph node before sub-agent dispatch. Reject
78
- // unmapped nodes with PEAKS_GRAPH_NODE_REQUIRED. The mapping is
79
- // carried via the `graphNode` annotation on each DAG node, OR — as
80
- // a back-compat fallback for DAGs without the annotation — the
81
- // DAG node id itself is treated as the graph node id. Either way,
82
- // the graph node must be prepared (RD §3 D4c) before the dispatch
83
- // CLI runs.
84
- for (const node of dag.nodes) {
85
- const graphNodeId = node.graphNode;
86
- const candidate = typeof graphNodeId === 'string' && graphNodeId.length > 0 ? graphNodeId : node.id;
87
- if (typeof candidate !== 'string' || candidate.length === 0) {
88
- printResult(io, fail('sub-agent.dispatch', 'PEAKS_GRAPH_NODE_REQUIRED', `DAG node ${node.id} has no graph-node mapping (RD §4 D4c)`, { role, toolCall: null, dispatchRecordPath: null, dagNodeId: node.id }, [
89
- 'Annotate the DAG node with `graphNode: "<id>"` so each dispatch can bind a prepared graph node.'
90
- ]), asJson);
91
- process.exitCode = 1;
92
- return;
93
- }
94
- }
95
- // MVP (1.2): the orchestrator iterates topological levels + join
96
- // barrier + cancel-on-fail end-to-end. The CLI's runner returns `done`
97
- // for every leaf (so runDag's cancel-on-fail path is exercised when a
98
- // leaf actually fails); the CLI envelope filters `emittedToolCalls` to
99
- // the first level only (see `firstLevelIds`). The LLM-side runner
100
- // re-invokes `--from-dag` for level 2+ after writing level-1
101
- // contracts via `peaks contract write`.
102
- let levelArr;
103
- try {
104
- levelArr = topologicalLevels(dag);
105
- }
106
- catch (err) {
107
- printResult(io, fail('sub-agent.dispatch', 'INVALID_DAG', `topologicalLevels failed for ${options.fromDag}: ${err.message}`, { role, toolCall: null, dispatchRecordPath: null }, [
108
- 'The DAG passed validateDag() but topologicalLevels threw (likely a cycle that slipped past validateDag, or a runtime invariant).',
109
- 'Inspect the DAG file with the editor and re-invoke dispatch. (No peaks scan dag CLI ships in 2.7.0; if you need a programmatic DAG validator, import validateDag / topologicalLevels from src/services/dispatch/slice-dag.ts directly.)'
110
- ]), asJson);
111
- process.exitCode = 1;
42
+ if (assertGraphNodesMapped(dag, scope) === null)
112
43
  return;
113
- }
114
- // Read upstream contracts so downstream-level prompts (when re-invoked
115
- // for level 2+) get auto-injected ancestors via `formatContractInjection`.
116
- // At level-1 emit time, contracts is empty (no ancestors yet); the
117
- // injection matters when the LLM re-invokes for level 2+ after writing
118
- // level-1 contracts via `writeContract`.
119
- const existingContracts = listContracts(projectRoot, sid);
120
- const ide = detectInstalledIde(projectRoot) ?? 'claude-code';
121
- const adapter = getAdapter(ide);
122
- const dispatcher = adapter.subAgentDispatcher;
123
- if (!dispatcher.supportsRole(role)) {
124
- printResult(io, fail('sub-agent.dispatch', 'IDE_NOT_SUPPORTED', `IDE ${ide} does not support role "${role}"`, { role, toolCall: null, dispatchRecordPath: null }, ['Switch to a registered IDE (e.g. claude-code) or pick a role the current IDE supports.']), asJson);
125
- process.exitCode = 1;
44
+ const levelArr = topologicalLevelsOrFail(runtime, dag, options.fromDag, scope);
45
+ if (levelArr === null)
46
+ return;
47
+ const dispatched = resolveDagDispatcher(ids.projectRoot);
48
+ if (!dispatched.dispatcher.supportsRole(role)) {
49
+ emitDagFailure(io, asJson, {
50
+ role,
51
+ code: 'IDE_NOT_SUPPORTED',
52
+ message: `IDE ${dispatched.ide} does not support role "${role}"`,
53
+ nextActions: [
54
+ 'Switch to a registered IDE (e.g. claude-code) or pick a role the current IDE supports.'
55
+ ]
56
+ });
126
57
  return;
127
58
  }
128
- // Track per-level emissions so the CLI envelope can expose ONLY the
129
- // first topological level to the LLM (matching MVP 1.2 semantics: LLM
130
- // executes level-1 toolCalls, writes contracts via `peaks contract
131
- // write`, then re-invokes `--from-dag` for level 2+). Level-2+ leaves
132
- // still flow through runDag's join-barrier — their toolCalls are
133
- // generated internally so the orchestrator's happy path is exercised
134
- // end-to-end, but they are NOT surfaced in the CLI envelope (the LLM
135
- // sees them only after re-invoking with fresh level-1 contracts).
59
+ await runLevels({ runtime, dag, levelArr, dispatched, ids, scope, fromDag: options.fromDag });
60
+ }
61
+ /**
62
+ * Run every topological level through `runLayeredDag` and print the level-1
63
+ * envelope. Upstream contracts are read first so downstream-level prompts get
64
+ * auto-injected ancestors via `formatContractInjection` (empty at level-1 emit
65
+ * time, which is when the LLM re-invokes with fresh level-1 contracts).
66
+ */
67
+ async function runLevels(run) {
68
+ const { runtime, dag, levelArr, dispatched, ids, scope, fromDag } = run;
69
+ const existingContracts = runtime.listContracts(ids.projectRoot, ids.sid);
136
70
  const firstLevelIds = new Set(levelArr[0] ?? []);
137
- // node declares `files`, refine the level into file-overlap waves so the
138
- // LLM fans out without serializing on a shared file. Emitted additively
139
- // in the envelope; the topological dispatch flow itself is unchanged.
140
- // Nodes without `files` → `firstLevelWaves: null` (legacy envelope).
141
- const firstLevelDescriptors = [...firstLevelIds].map((id) => ({
142
- id,
143
- files: dag.nodes.find((n) => n.id === id)?.files ?? []
144
- }));
145
- const firstLevelWaves = firstLevelDescriptors.length > 0 && firstLevelDescriptors.every((d) => d.files.length > 0)
146
- ? planFileOverlapWaves(firstLevelDescriptors).waves
147
- : null;
148
- const emittedToolCalls = [];
149
- const emittedSliceIds = [];
150
- // CLI runner: emit the per-slice `buildToolCall` envelope, then return
151
- // `done` with an empty `publicSurface` placeholder. The orchestrator
152
- // treats the slice as "CLI-emitted, awaiting LLM-side execution" and
153
- // advances to the next topological level (or breaks on failure). The
154
- // placeholder surface is intentionally empty: the real public surface
155
- // arrives later via `peaks contract write` from the LLM-side runner,
156
- // and overwrites the CLI placeholder contract written by `noopWriter`.
157
- // Why not `cancelled`? Returning `cancelled` here short-circuits
158
- // runDag's join-barrier + cancel-on-fail path — the orchestrator
159
- // breaks out after the first level with a cancellation, which hides
160
- // the real cancel-on-fail semantics from the test suite (and from any
161
- // future caller that wants to use `runDag` end-to-end from the CLI).
162
- // Returning `done` exercises the full happy path; cancel-on-fail
163
- // semantics will be covered when 1.3 lands real per-IDE await.
164
- const cliRunner = async (spec) => {
165
- const toolCall = dispatcher.buildToolCall({
166
- role: spec.role,
167
- prompt: spec.prompt,
168
- requestId: rid,
169
- sessionId: sid
170
- });
171
- if (firstLevelIds.has(spec.sliceId)) {
172
- emittedToolCalls.push(toolCall);
173
- emittedSliceIds.push(spec.sliceId);
174
- }
175
- return {
176
- status: 'done',
177
- publicSurface: {
178
- exports: [],
179
- types: [],
180
- publicSignatures: []
181
- }
182
- };
183
- };
184
- // CLI noop writer — the orchestrator collects a `SliceContract` per
185
- // emitted toolCall so downstream re-invocations (level 2+) can splice
186
- // ancestor contracts via `formatContractInjection`. We don't write to
187
- // disk here (the LLM-side runner does that via `peaks contract write`
188
- // after each toolCall resolves), but the returned placeholder MUST be
189
- // shape-valid: the `contractHash` field has to be a real SHA-256 hex
190
- // string so formatContractInjection + downstream validators don't
191
- // reject the placeholder. The placeholder hash is computed from the
192
- // slice identity only (`sliceId|sessionId`) — it's deterministic,
193
- // stable, and collision-free for the MVP run, but obviously does NOT
194
- // represent the slice's actual public surface. The LLM-side runner's
195
- // `peaks contract write` call will overwrite this with a content-based
196
- // hash once the slice finishes.
197
- const noopWriter = (sliceId, _publicSurface) => {
198
- const partial = {
199
- sliceId,
200
- sessionId: sid,
201
- exports: [],
202
- types: [],
203
- publicSignatures: []
204
- };
205
- return {
206
- sliceId,
207
- sessionId: sid,
208
- completedAt: new Date(0).toISOString(), // epoch sentinel = "placeholder, not yet finished"
209
- exports: [],
210
- types: [],
211
- publicSignatures: [],
212
- contractHash: hashContract(partial)
213
- };
214
- };
215
- // runLayeredDag IS in the path: validates the DAG, iterates all
216
- // topological levels (foundation/upstreamSync slices prioritized within
217
- // each level by `topologicalLevels`), runs the join barrier after
218
- // each level, and triggers cancel-on-fail rollback if any leaf
219
- // returns `failed` (or `cancelled`, once 1.3 lands). The CLI
220
- // envelope below filters `emittedToolCalls` / `emittedSliceIds` to
221
- // the first level — see the `firstLevelIds` filter inside `cliRunner`.
71
+ const emissions = { toolCalls: [], sliceIds: [] };
72
+ const runSlice = makeCliRunner({
73
+ firstLevelIds,
74
+ dispatcher: dispatched.dispatcher,
75
+ ids,
76
+ emissions
77
+ });
78
+ const writeContractFn = makeNoopWriter(runtime.hashContract, ids.sid);
222
79
  try {
223
- await runLayeredDag(dag, {
224
- projectRoot,
225
- sessionId: sid,
80
+ await runtime.runLayeredDag(dag, {
81
+ projectRoot: ids.projectRoot,
82
+ sessionId: ids.sid,
226
83
  existingContracts,
227
- runSlice: cliRunner,
228
- writeContractFn: noopWriter
84
+ runSlice,
85
+ writeContractFn
229
86
  });
230
87
  }
231
88
  catch (err) {
232
- // runLayeredDag throws DagPlanError for plan-level failures (e.g.
233
- // cycle slipping past validateDag). Surface it as INVALID_DAG so
234
- // the CLI envelope has a clear failure code, not a generic
235
- // DISPATCH_ERROR.
236
- printResult(io, fail('sub-agent.dispatch', 'INVALID_DAG', `runLayeredDag failed for ${options.fromDag}: ${err.message}`, { role, toolCall: null, dispatchRecordPath: null }, [
237
- 'runLayeredDag threw DagPlanError; the DAG passed validateDag() but failed at topologicalLevels or contractStore dispatch.',
238
- 'Inspect the DAG file and re-run.'
239
- ]), asJson);
240
- process.exitCode = 1;
89
+ emitDagFailure(scope.io, scope.asJson, {
90
+ role: scope.role,
91
+ code: 'INVALID_DAG',
92
+ message: `runLayeredDag failed for ${fromDag}: ${err.message}`,
93
+ nextActions: [
94
+ 'runLayeredDag threw DagPlanError; the DAG passed validateDag() but failed at topologicalLevels or contractStore dispatch.',
95
+ 'Inspect the DAG file and re-run.'
96
+ ]
97
+ });
241
98
  return;
242
99
  }
243
- printResult(io, ok('sub-agent.dispatch', {
244
- envelopeVersion: '2.1.0',
245
- role,
246
- ide: dispatcher.label,
247
- fromDag: options.fromDag,
248
- batchId,
249
- dispatchCount: emittedSliceIds.length,
100
+ printResult(scope.io, buildDagSuccessEnvelope({
101
+ role: scope.role,
102
+ ide: dispatched.dispatcher.label,
103
+ fromDag,
104
+ batchId: ids.batchId,
250
105
  levelsTotal: levelArr.length,
251
- firstLevel: emittedSliceIds,
252
- // §3: file-overlap wave plan for the first level (null when any
253
- // first-level node omits `files`). Additive field.
254
- firstLevelWaves,
255
- toolCalls: emittedToolCalls,
106
+ emittedSliceIds: emissions.sliceIds,
107
+ emittedToolCalls: emissions.toolCalls,
108
+ firstLevelWaves: planFirstLevelWaves(dag, levelArr),
256
109
  existingContractCount: existingContracts.length,
257
- expectedCompletionSeconds: 60,
258
- artifactsPublicPaths: [],
259
- orchestratorVisibleHint: `⏳ Spawning ${emittedSliceIds.length} sub-agents via Task tool from DAG ${options.fromDag}, batch-id=${batchId} (ETA ~60s)`,
260
- // v2.15.0 follow-up — G12/G11/G2: per-slice metadata (foundation /
261
- // upstreamSync / complexity) for downstream scheduling decisions.
262
- sliceMeta: emittedSliceIds.map((id) => {
263
- const node = dag.nodes.find((n) => n.id === id);
264
- return {
265
- id,
266
- foundation: node?.foundation === true,
267
- upstreamSync: node?.upstreamSync === true,
268
- complexity: node?.complexity !== undefined && isSliceComplexity(node.complexity)
269
- ? node.complexity
270
- : null
271
- };
272
- }),
273
- nextActions: [
274
- 'Execute each toolCall in your IDE; on completion, write the slice contract to .peaks/_runtime/<sid>/dispatch/contracts/<slice-id>.json.',
275
- 'Re-invoke `peaks sub-agent dispatch --from-dag <file>` with the same batch-id to advance to the next level once all current-level slices have written contracts.'
276
- ]
277
- }, [], [
278
- 'MVP (1.2) plans the first level via runLayeredDag orchestrator (cancel-on-fail path active); the LLM drives subsequent levels by re-invoking this command after contract writes.',
279
- existingContracts.length > 0
280
- ? `Injected ${existingContracts.length} upstream contract(s) into downstream-level prompts via formatContractInjection.`
281
- : 'No upstream contracts found; first-level prompts have empty ancestor blocks.'
282
- ]), asJson);
110
+ dag,
111
+ isSliceComplexity: runtime.isSliceComplexity
112
+ }), scope.asJson);
283
113
  }
@@ -1,6 +1,7 @@
1
1
  // The `peaks sub-agent dispatch` preflight: every refusal that can be decided from
2
2
  // the argv alone, before the session id, the lease or the prompt blocks are touched.
3
3
  // Returns the prompt-size decision, or `null` when a refusal was already printed.
4
+ import { readFileSync } from 'node:fs';
4
5
  import { printResult } from '../cli-helpers.js';
5
6
  import { fail } from 'peaks-loop-shared/result';
6
7
  import { evaluatePromptSize } from '../../services/context/context-guard.js';
@@ -45,6 +46,47 @@ function applyPromptLengthOverride(options) {
45
46
  }
46
47
  }
47
48
  }
49
+ function rejectPromptFileUnreadable(io, role, prompt, asJson) {
50
+ printResult(io, fail('sub-agent.dispatch', 'PROMPT_FILE_NOT_FOUND', `--prompt "${prompt}" is a file reference ("@<path>") but that path could not be read`, { role, toolCall: null, dispatchRecordPath: null }, [
51
+ 'Fix the path after "@", or pass the prompt text itself.',
52
+ 'A --prompt that does not begin with "@" is sent verbatim.'
53
+ ]), asJson);
54
+ process.exitCode = 1;
55
+ return null;
56
+ }
57
+ function rejectEmptyPromptFile(io, role, prompt, asJson) {
58
+ printResult(io, fail('sub-agent.dispatch', 'MISSING_PROMPT', `--prompt "${prompt}" resolved to an empty file: a dispatch needs instructions`, { role, toolCall: null, dispatchRecordPath: null }, [
59
+ 'Write the brief into the referenced file, or pass the prompt text itself.',
60
+ 'An empty or whitespace-only file carries no brief, so the dispatch would look successful and instruct nothing.'
61
+ ]), asJson);
62
+ process.exitCode = 1;
63
+ return null;
64
+ }
65
+ // `--prompt "@<path>"` is a file reference, mirroring `peaks prd handoff init
66
+ // --body` (prd-commands.ts `resolveBody`). Before this the "@" token was sent
67
+ // as literal text, so a dispatch naming a brief file went out carrying the path
68
+ // and none of the brief — no warning, exit 0. A prompt that does not begin with
69
+ // "@" is returned untouched, byte-identical.
70
+ //
71
+ // The emptiness check is repeated AFTER the read, and only on this branch: the
72
+ // pre-read check sees the token "@<path>", never the file's contents, so an
73
+ // empty file passes it and re-opens the same silent-dispatch defect from the
74
+ // other side. A whitespace-only file is the same input. Both are refused; a
75
+ // LITERAL prompt is not re-checked, so a whitespace-only literal is unchanged.
76
+ function resolvePromptFileRef(io, role, prompt, asJson) {
77
+ if (!prompt.startsWith('@'))
78
+ return { prompt };
79
+ try {
80
+ const content = readFileSync(prompt.slice(1), 'utf8');
81
+ if (content.trim().length === 0) {
82
+ return rejectEmptyPromptFile(io, role, prompt, asJson);
83
+ }
84
+ return { prompt: content };
85
+ }
86
+ catch {
87
+ return rejectPromptFileUnreadable(io, role, prompt, asJson);
88
+ }
89
+ }
48
90
  function rejectPromptTooLarge(io, role, promptLength, asJson) {
49
91
  printResult(io, fail('sub-agent.dispatch', 'PROMPT_TOO_LARGE', `prompt exceeds ${PROMPT_LIMIT_BYTES} bytes (got ${promptLength})`, { role, toolCall: null, dispatchRecordPath: null }, [
50
92
  'Truncate the prompt or split into multiple dispatches.',
@@ -86,6 +128,10 @@ export function preflightDispatch(io, role, options, asJson) {
86
128
  if (!options.prompt || options.prompt.length === 0) {
87
129
  return rejectMissingPrompt(io, role, asJson);
88
130
  }
131
+ const fileRef = resolvePromptFileRef(io, role, options.prompt, asJson);
132
+ if (fileRef === null)
133
+ return null;
134
+ options.prompt = fileRef.prompt;
89
135
  // Slice 4.0.8 RD §4 D4c required `--graph-node` here, before the session
90
136
  // id existed, so the only recovery it could offer was prose. The node is
91
137
  // now provisioned inside the try block below, once `sid` is known.
@@ -1,3 +1,4 @@
1
+ import type { Command } from 'commander';
1
2
  import { type ProgramIO } from '../cli-helpers.js';
2
3
  import { getAdapter } from '../../services/ide/ide-registry.js';
3
4
  import type { ContextGuardDecision } from '../../services/context/context-guard.js';
@@ -16,6 +17,11 @@ export interface ComposeDispatchPromptInput {
16
17
  worktreeBranch: string | null;
17
18
  decision: ContextGuardDecision;
18
19
  asJson: boolean;
20
+ /**
21
+ * The registered CLI, so the prompt's own quotations of it can be resolved
22
+ * against the commands that exist rather than against a second, hand-kept list.
23
+ */
24
+ rootCommand: Command;
19
25
  }
20
26
  export interface ComposedDispatchPrompt {
21
27
  adapter: ReturnType<typeof getAdapter>;
@@ -1,7 +1,3 @@
1
- // The prompt `peaks sub-agent dispatch` hands a sub-agent: the adapter check, the
2
- // optional preflight blocks (memory / codegraph / UI library / fresh context /
3
- // context probe / session capsule), the isolation and must-ls-files blocks, and the
4
- // warning list the envelope carries.
5
1
  import { fail, getErrorMessage } from 'peaks-loop-shared/result';
6
2
  import { printResult } from '../cli-helpers.js';
7
3
  import { detectInstalledIde } from '../../services/ide/ide-detector.js';
@@ -16,6 +12,9 @@ import { computeUiLibraryDispatchBlock } from '../../services/standards/ui-libra
16
12
  import { readFreshContextBlock } from '../../services/fresh-context/fresh-context-block.js';
17
13
  import { deprecatedReviewerWarnings } from './sub-agent-shared.js';
18
14
  import { buildIsolationBlock, buildMustLsFilesBlock } from './dispatch-prompt-blocks.js';
15
+ import { ensureArtifactContractBlock, readArtifactContractBlock } from '../../services/artifacts/artifact-contract-block.js';
16
+ import { ensureKarpathyBlock } from '../../services/dispatch/karpathy-block.js';
17
+ import { cliInvocationWarnings } from './dispatch-cli-invocation-check.js';
19
18
  // loadPreferences can throw on schema mismatch; we fall back to defaults
20
19
  // to avoid breaking the dispatch on a stale preferences.json file.
21
20
  function loadProjectPreferences(projectRoot) {
@@ -154,7 +153,7 @@ async function composeMemoryAugmentedBody(input, projectPrefs) {
154
153
  });
155
154
  }
156
155
  export async function composeDispatchPrompt(io, input) {
157
- const { projectRoot, role, options, isolationMode, leaseId, worktreePath, worktreeBranch, decision, asJson } = input;
156
+ const { projectRoot, sid, rid, role, options, isolationMode, leaseId, worktreePath, worktreeBranch, decision, asJson, rootCommand, prompt } = input;
158
157
  const projectPrefs = loadProjectPreferences(projectRoot);
159
158
  const ide = detectInstalledIde(projectRoot) ?? 'claude-code';
160
159
  const adapter = getAdapter(ide);
@@ -164,8 +163,31 @@ export async function composeDispatchPrompt(io, input) {
164
163
  const memoryAugmentedBody = await composeMemoryAugmentedBody(input, projectPrefs);
165
164
  const isolationBlock = buildIsolationBlock(isolationMode, leaseId, worktreePath, worktreeBranch);
166
165
  const { mustLsFilesVerification, mustLsFilesBlock } = buildMustLsFilesBlock(options, projectRoot);
167
- const effectivePrompt = `${memoryAugmentedBody}${isolationBlock}${mustLsFilesBlock}`;
166
+ // What the downstream gate will demand of this role, named in advance. `''`
167
+ // when this role has no gated artifacts under this type, so an unaffected
168
+ // role's prompt stays byte-identical. Injection is idempotent — a caller
169
+ // prompt that already carries a block keeps exactly one (see the helper).
170
+ const contractBlock = await readArtifactContractBlock({
171
+ projectRoot,
172
+ sessionId: sid,
173
+ requestId: rid,
174
+ role
175
+ });
176
+ // The presence test runs on the ASSEMBLED prompt, not on the caller's draft:
177
+ // this string is what the sub-agent receives as `toolCall.args.prompt` and
178
+ // what the dispatch record stores as `prompt`. A draft that merely names
179
+ // Karpathy (or carries a copy with a word wrong) does not count as carrying
180
+ // the canonical block, so the block is added rather than trusted.
181
+ const effectivePrompt = ensureKarpathyBlock(ensureArtifactContractBlock(`${memoryAugmentedBody}${isolationBlock}${mustLsFilesBlock}`, contractBlock));
182
+ // Findings travel as WARNINGS, never as a refusal, and they are read off the
183
+ // CALLER's prompt rather than the assembled one — both decisions are measured
184
+ // and recorded on `dispatch-cli-invocation-check.ts`.
185
+ const invocationWarnings = cliInvocationWarnings(prompt, rootCommand);
168
186
  // + rerouted here, never refused — rationale on the helper itself.
169
- const warnings = [...decision.warnings, ...deprecatedReviewerWarnings(role)];
187
+ const warnings = [
188
+ ...decision.warnings,
189
+ ...deprecatedReviewerWarnings(role),
190
+ ...invocationWarnings
191
+ ];
170
192
  return { adapter, effectivePrompt, warnings, mustLsFilesVerification };
171
193
  }
@@ -6,6 +6,7 @@
6
6
  *
7
7
  * See `src/services/doc/doc-generator.ts` for the underlying logic.
8
8
  */
9
+ import { mkdirSync, writeFileSync } from 'node:fs';
9
10
  import { resolve as resolvePath } from 'node:path';
10
11
  import { findProjectRoot } from '../../services/config/config-safety.js';
11
12
  import { generateSkillFromCommands, gitLogSince, renderSkillMarkdown, suggestChangelog } from '../../services/doc/doc-generator.js';
@@ -31,7 +32,6 @@ export function registerDocCommands(program, io) {
31
32
  if (opts.output !== undefined) {
32
33
  // Write to file
33
34
  try {
34
- const { writeFileSync, mkdirSync } = require('node:fs');
35
35
  mkdirSync(resolvePath(opts.output, '..'), { recursive: true });
36
36
  writeFileSync(resolvePath(opts.output), md, 'utf8');
37
37
  printResult(io, ok('doc.generate-skill', {
@@ -18,7 +18,7 @@ export const CHECK_UNPROMOTED_DESCRIPTION = 'Scan `.peaks/memory/*.md` and list
18
18
  export const NO_LAYER_NEXT_ACTIONS = [
19
19
  'No --layer passed. Choose one of A / B / C and re-run.',
20
20
  'A: append to sops/*.md (procedural rules)',
21
- 'B: append a matcher to .peaks/.claude-settings-template.json (tool-call interception)',
21
+ 'B: append a matcher to .peaks/.claude-settings-template.json, or to .claude/settings.json for a hook that ships with this repo (tool-call interception)',
22
22
  'C: extend HardFloorCategory in mode-gate.ts (always pauses regardless of mode)',
23
23
  'Or pass --dry-run to preview all three stubs first.'
24
24
  ];
@@ -0,0 +1,44 @@
1
+ import type { FinalReviewOutput } from '../../services/final-review/final-review-types.js';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ /** The two inputs a refusal envelope names, plus why it was refused. */
4
+ export type PrepareRefusal = {
5
+ readonly rid: string;
6
+ readonly code: string;
7
+ readonly message: string;
8
+ readonly sessionId: string;
9
+ readonly auditGoalPath: string;
10
+ readonly nextActions: string[];
11
+ };
12
+ /** Print one refusal envelope and mark the process failed. */
13
+ export declare function emitPrepareFailure(io: ProgramIO, json: boolean | undefined, refusal: PrepareRefusal, missingEnv?: readonly string[]): void;
14
+ /** Where a resolved run reads its audit goal from. */
15
+ export type PrepareGoalPath = {
16
+ readonly sessionId: string;
17
+ readonly auditGoalPath: string;
18
+ };
19
+ /**
20
+ * Stub path: surface a structured "scaffold ready" envelope.
21
+ *
22
+ * The service is NOT called here — the stub runner answers the audit-goal
23
+ * shape, not the 4-dim review shape, so running it through
24
+ * `prepareFinalReview()` would only manufacture a malformed review. The
25
+ * envelope confirms the route is wired end-to-end and reports the audit-goal
26
+ * path the service WOULD read.
27
+ */
28
+ export declare function emitStubEnvelope(io: ProgramIO, rid: string, goal: PrepareGoalPath, json: boolean | undefined): void;
29
+ /** The success envelope of a real-provider run. */
30
+ export declare function emitReviewEnvelope(io: ProgramIO, result: {
31
+ readonly rid: string;
32
+ readonly goal: PrepareGoalPath;
33
+ readonly model: string;
34
+ readonly review: FinalReviewOutput;
35
+ readonly json: boolean | undefined;
36
+ }): void;
37
+ /**
38
+ * Map a thrown error to the CLI's error code. The LLM-layer errors already
39
+ * carry codes precise enough to act on (`LLM_CREDENTIAL_MISSING`,
40
+ * `LLM_REQUEST_FAILED`, …), so they are passed through rather than flattened
41
+ * into one opaque failure.
42
+ */
43
+ export declare function finalReviewErrorCode(error: unknown): string;
44
+ export declare function finalReviewNextActions(code: string): string[];