orkeon-code 1.0.0-rc.1 → 1.0.0-rc.2

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 (440) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +206 -11
  13. package/orkeon-code.ps1 +109 -7
  14. package/package.json +2 -1
  15. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  16. package/src/commands/_lib/args.ts +5 -4
  17. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  18. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  19. package/src/commands/_lib/dev/dev-source.ts +7 -11
  20. package/src/commands/_lib/dev/dev.ts +34 -37
  21. package/src/commands/_lib/dev/markers.ts +7 -0
  22. package/src/commands/_lib/dev/messages.ts +112 -0
  23. package/src/commands/_lib/dev-step.ts +16 -13
  24. package/src/commands/_lib/dispatch.ts +62 -39
  25. package/src/commands/_lib/git/branch.ts +9 -10
  26. package/src/commands/_lib/git/commit.ts +9 -13
  27. package/src/commands/_lib/git/diff.ts +22 -12
  28. package/src/commands/_lib/git/messages.ts +54 -0
  29. package/src/commands/_lib/git/review.ts +9 -10
  30. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  31. package/src/commands/_lib/memory/memory.ts +3 -2
  32. package/src/commands/_lib/memory/messages.ts +32 -0
  33. package/src/commands/_lib/messages.ts +48 -0
  34. package/src/commands/_lib/project/messages.ts +8 -0
  35. package/src/commands/_lib/session/export.ts +3 -2
  36. package/src/commands/_lib/session/messages.ts +87 -0
  37. package/src/commands/_lib/session/prompts.ts +4 -0
  38. package/src/commands/_lib/session/resume.ts +15 -24
  39. package/src/commands/_lib/session/tasks.ts +20 -23
  40. package/src/commands/_lib/settings/advisor.ts +11 -16
  41. package/src/commands/_lib/settings/agents.ts +18 -28
  42. package/src/commands/_lib/settings/choices.ts +8 -0
  43. package/src/commands/_lib/settings/config.ts +43 -43
  44. package/src/commands/_lib/settings/effort.ts +147 -0
  45. package/src/commands/_lib/settings/hooks.ts +12 -20
  46. package/src/commands/_lib/settings/messages.ts +408 -0
  47. package/src/commands/_lib/settings/mode.ts +33 -24
  48. package/src/commands/_lib/settings/model.ts +71 -36
  49. package/src/commands/_lib/settings/output-style.ts +39 -0
  50. package/src/commands/_lib/settings/permissions.ts +71 -93
  51. package/src/commands/_lib/settings/route.ts +63 -0
  52. package/src/commands/_lib/settings/skills.ts +53 -11
  53. package/src/commands/_lib/settings/theme.ts +42 -0
  54. package/src/commands/_lib/speech/messages.ts +58 -0
  55. package/src/commands/_lib/speech/prompts.ts +4 -0
  56. package/src/commands/_lib/speech/say.ts +9 -10
  57. package/src/commands/_lib/speech/transcribe.ts +14 -23
  58. package/src/commands/_lib/speech/voice.ts +14 -18
  59. package/src/commands/_lib/status/doctor.ts +47 -28
  60. package/src/commands/_lib/status/messages.ts +100 -0
  61. package/src/commands/_lib/status/meta.ts +3 -24
  62. package/src/commands/_lib/status/status.ts +10 -11
  63. package/src/commands/_lib/status/usage-tools.ts +2 -3
  64. package/src/commands/_lib/status/usage.ts +7 -18
  65. package/src/commands/_lib/view.ts +6 -1
  66. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  67. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  68. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  69. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  70. package/src/commands/git/commit.cmd.ts +3 -3
  71. package/src/commands/git/review.cmd.ts +3 -3
  72. package/src/commands/memory/memory.cmd.ts +2 -2
  73. package/src/commands/project/analyze.cmd.ts +3 -3
  74. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  75. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  76. package/src/commands/project/init.cmd.ts +3 -3
  77. package/src/commands/project/verify.cmd.ts +2 -2
  78. package/src/commands/session/assistant.cmd.ts +2 -2
  79. package/src/commands/session/compact.cmd.ts +1 -1
  80. package/src/commands/session/copy.cmd.ts +8 -7
  81. package/src/commands/session/rename.cmd.ts +3 -2
  82. package/src/commands/session/rewind.cmd.ts +3 -4
  83. package/src/commands/session/summary.cmd.ts +3 -3
  84. package/src/commands/session/tasks.cmd.ts +4 -2
  85. package/src/commands/settings/config.cmd.ts +4 -2
  86. package/src/commands/settings/effort.cmd.ts +10 -31
  87. package/src/commands/settings/fast.cmd.ts +2 -1
  88. package/src/commands/settings/mode.cmd.ts +3 -3
  89. package/src/commands/settings/model.cmd.ts +3 -2
  90. package/src/commands/settings/output-style.cmd.ts +9 -38
  91. package/src/commands/settings/permissions.cmd.ts +2 -2
  92. package/src/commands/settings/proactive.cmd.ts +2 -1
  93. package/src/commands/settings/route.cmd.ts +16 -0
  94. package/src/commands/settings/skills.cmd.ts +3 -3
  95. package/src/commands/settings/theme.cmd.ts +14 -0
  96. package/src/commands/speech/say.cmd.ts +2 -2
  97. package/src/commands/speech/transcribe.cmd.ts +2 -2
  98. package/src/commands/status/release-notes.cmd.ts +1 -1
  99. package/src/crews/.orkeon/orkeon.d.ts +538 -93
  100. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  101. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  102. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  103. package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
  104. package/src/crews/advisor/application/messages.ts +4 -0
  105. package/src/crews/advisor/application/prompts.ts +4 -0
  106. package/src/crews/advisor/application/run-advisor.ts +2 -1
  107. package/src/crews/advisor/crew.ork.ts +5 -4
  108. package/src/crews/advisor/domain/advice.ts +7 -23
  109. package/src/crews/advisor/domain/messages.ts +8 -0
  110. package/src/crews/advisor/domain/prompts.ts +26 -0
  111. package/src/crews/agent-run/application/messages.ts +18 -0
  112. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  113. package/src/crews/agent-run/crew.ork.ts +3 -3
  114. package/src/crews/analyze/application/messages.ts +27 -0
  115. package/src/crews/analyze/application/prompts.ts +4 -0
  116. package/src/crews/analyze/application/run-analyze.ts +16 -14
  117. package/src/crews/analyze/crew.ork.ts +5 -4
  118. package/src/crews/analyze/domain/harvest.ts +33 -65
  119. package/src/crews/analyze/domain/prompts.ts +86 -0
  120. package/src/crews/code-review/application/lens-material.ts +24 -0
  121. package/src/crews/code-review/application/messages.ts +17 -0
  122. package/src/crews/code-review/application/prompts.ts +10 -17
  123. package/src/crews/code-review/application/review.ts +4 -1
  124. package/src/crews/code-review/application/run-code-review.ts +13 -15
  125. package/src/crews/code-review/crew.ork.ts +5 -4
  126. package/src/crews/code-review/domain/lenses.ts +6 -45
  127. package/src/crews/code-review/domain/messages.ts +25 -0
  128. package/src/crews/code-review/domain/prompts.ts +58 -0
  129. package/src/crews/code-review/domain/report.ts +5 -6
  130. package/src/crews/code-review/domain/scope.ts +6 -12
  131. package/src/crews/dev-batches/application/messages.ts +127 -0
  132. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  133. package/src/crews/dev-batches/application/prompts.ts +10 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  135. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  136. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  137. package/src/crews/dev-batches/crew.ork.ts +12 -9
  138. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  139. package/src/crews/dev-batches/domain/markers.ts +5 -0
  140. package/src/crews/dev-batches/domain/messages.ts +6 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  142. package/src/crews/dev-change/application/change-material.ts +44 -0
  143. package/src/crews/dev-change/application/evidence.ts +25 -22
  144. package/src/crews/dev-change/application/messages.ts +81 -0
  145. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  146. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  147. package/src/crews/dev-change/crew.ork.ts +11 -9
  148. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  149. package/src/crews/dev-change/domain/change-render.ts +13 -15
  150. package/src/crews/dev-change/domain/markers.ts +28 -0
  151. package/src/crews/dev-change/domain/messages.ts +16 -0
  152. package/src/crews/dev-implement/application/close.ts +21 -18
  153. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  154. package/src/crews/dev-implement/application/messages.ts +161 -0
  155. package/src/crews/dev-implement/application/observe.ts +4 -2
  156. package/src/crews/dev-implement/application/prompts.ts +9 -0
  157. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  158. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  159. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  160. package/src/crews/dev-implement/crew.ork.ts +2 -1
  161. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  162. package/src/crews/dev-implement/domain/correction.ts +16 -15
  163. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  164. package/src/crews/dev-implement/domain/markers.ts +23 -0
  165. package/src/crews/dev-implement/domain/messages.ts +58 -0
  166. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  167. package/src/crews/dev-implement/domain/roles.ts +3 -7
  168. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  169. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  170. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  171. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  172. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  173. package/src/crews/dev-learn/application/messages.ts +51 -0
  174. package/src/crews/dev-learn/application/{learn-prompt.ts → prompts.ts} +24 -65
  175. package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
  176. package/src/crews/dev-learn/crew.ork.ts +4 -3
  177. package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
  178. package/src/crews/dev-learn/domain/messages.ts +65 -0
  179. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  180. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  181. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  182. package/src/crews/dev-plan/application/inventory.ts +17 -13
  183. package/src/crews/dev-plan/application/messages.ts +88 -0
  184. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  185. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  186. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  187. package/src/crews/dev-plan/crew.ork.ts +11 -8
  188. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  189. package/src/crews/dev-plan/domain/markers.ts +18 -0
  190. package/src/crews/dev-plan/domain/messages.ts +118 -0
  191. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  192. package/src/crews/dev-plan/domain/plan-render.ts +30 -31
  193. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  194. package/src/crews/dev-spec/application/messages.ts +30 -0
  195. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  196. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  197. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  198. package/src/crews/dev-spec/crew.ork.ts +11 -9
  199. package/src/crews/dev-spec/domain/markers.ts +30 -0
  200. package/src/crews/dev-spec/domain/messages.ts +39 -0
  201. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  202. package/src/crews/dev-spec/domain/spec-render.ts +18 -18
  203. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  204. package/src/crews/dev-verify/application/audit.ts +38 -30
  205. package/src/crews/dev-verify/application/capture.ts +34 -26
  206. package/src/crews/dev-verify/application/messages.ts +119 -0
  207. package/src/crews/dev-verify/application/prompts.ts +209 -0
  208. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  209. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  210. package/src/crews/dev-verify/crew.ork.ts +6 -6
  211. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  212. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  213. package/src/crews/dev-verify/domain/commands.ts +3 -3
  214. package/src/crews/dev-verify/domain/gate.ts +21 -16
  215. package/src/crews/dev-verify/domain/markers.ts +16 -0
  216. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  217. package/src/crews/dev-verify/domain/messages.ts +92 -0
  218. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  219. package/src/crews/git-commit/application/draft.ts +16 -37
  220. package/src/crews/git-commit/application/messages.ts +15 -0
  221. package/src/crews/git-commit/application/prompts.ts +47 -0
  222. package/src/crews/git-commit/application/run-git-commit.ts +13 -12
  223. package/src/crews/git-commit/crew.ork.ts +5 -4
  224. package/src/crews/git-commit/domain/commit.ts +15 -35
  225. package/src/crews/git-commit/domain/markers.ts +4 -0
  226. package/src/crews/git-commit/domain/messages.ts +48 -0
  227. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  228. package/src/crews/init-verifiers/application/messages.ts +13 -0
  229. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  230. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  231. package/src/crews/init-verifiers/crew.ork.ts +5 -4
  232. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  233. package/src/crews/main-loop/application/messages.ts +81 -0
  234. package/src/crews/main-loop/application/prompts.ts +12 -0
  235. package/src/crews/main-loop/application/run-main-loop.ts +63 -30
  236. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  237. package/src/crews/main-loop/crew.ork.ts +12 -7
  238. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  239. package/src/crews/main-loop/domain/prompts.ts +336 -0
  240. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  241. package/src/crews/project-init/application/detect.ts +5 -4
  242. package/src/crews/project-init/application/messages.ts +15 -0
  243. package/src/crews/project-init/application/prompts.ts +11 -7
  244. package/src/crews/project-init/crew.ork.ts +5 -4
  245. package/src/crews/project-init/domain/existing-files.ts +6 -4
  246. package/src/crews/project-init/domain/messages.ts +13 -0
  247. package/src/crews/project-init/domain/package-map.ts +3 -3
  248. package/src/crews/project-init/domain/prompts.ts +10 -0
  249. package/src/crews/session-compact/application/prompts.ts +5 -0
  250. package/src/crews/session-compact/crew.ork.ts +5 -4
  251. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  252. package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
  253. package/src/crews/speech/application/messages.ts +3 -0
  254. package/src/crews/speech/application/prompts.ts +3 -0
  255. package/src/crews/speech/application/run-speech.ts +2 -1
  256. package/src/crews/speech/crew.ork.ts +2 -1
  257. package/src/shared/application/agents/child-agent.ts +11 -7
  258. package/src/shared/application/agents/messages.ts +35 -0
  259. package/src/shared/application/agents/route-agent.ts +115 -0
  260. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  261. package/src/shared/application/compaction/compact-session.ts +19 -14
  262. package/src/shared/application/compaction/messages.ts +20 -0
  263. package/src/shared/application/compaction/prune-context.ts +94 -0
  264. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  265. package/src/shared/application/dev/brief-inventory.ts +6 -4
  266. package/src/shared/application/dev/close-batch.ts +9 -7
  267. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  268. package/src/shared/application/dev/learn-decision.ts +20 -18
  269. package/src/shared/application/dev/load-dev-context.ts +7 -8
  270. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  271. package/src/shared/application/dev/messages.ts +132 -0
  272. package/src/shared/application/dev/phase-timer.ts +54 -0
  273. package/src/shared/application/dev/plan-source.ts +12 -8
  274. package/src/shared/application/dev/preflight.ts +8 -8
  275. package/src/shared/application/dev/prompts.ts +34 -0
  276. package/src/shared/application/dev/question-round.ts +25 -17
  277. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  278. package/src/shared/application/dev/settle-questions.ts +4 -2
  279. package/src/shared/application/dev/source-review.ts +12 -8
  280. package/src/shared/application/dev/source-step.ts +12 -10
  281. package/src/shared/application/dev/spend.ts +17 -4
  282. package/src/shared/application/dev/step-precedents.ts +2 -1
  283. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  284. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  285. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  286. package/src/shared/application/dev/verdict-sources.ts +5 -3
  287. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  288. package/src/shared/application/extra-tools.ts +2 -1
  289. package/src/shared/application/git/batch-worktree.ts +22 -17
  290. package/src/shared/application/git/commit-files.ts +24 -19
  291. package/src/shared/application/git/merge-batch.ts +11 -7
  292. package/src/shared/application/git/messages.ts +75 -0
  293. package/src/shared/application/git/open-pull-request.ts +4 -3
  294. package/src/shared/application/host-context.ts +59 -0
  295. package/src/shared/application/host-layout-store.ts +45 -0
  296. package/src/shared/application/llm-profile.ts +4 -3
  297. package/src/shared/application/messages.ts +14 -0
  298. package/src/shared/application/permission-rules.ts +10 -0
  299. package/src/shared/application/ports/decision.ts +14 -0
  300. package/src/shared/application/ports/human.ts +25 -0
  301. package/src/shared/application/ports/llm.ts +32 -3
  302. package/src/shared/application/ports/memory.ts +1 -1
  303. package/src/shared/application/ports/theme.ts +11 -0
  304. package/src/shared/application/ports.ts +4 -2
  305. package/src/shared/application/session-io.ts +2 -1
  306. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  307. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  308. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  309. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  310. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  311. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  312. package/src/shared/application/shared-memory/messages.ts +63 -0
  313. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  314. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  315. package/src/shared/application/skills/messages.ts +4 -0
  316. package/src/shared/application/skills/suggest-skills.ts +102 -0
  317. package/src/shared/application/workflow/messages.ts +8 -0
  318. package/src/shared/application/workflow/workflow-state.ts +7 -6
  319. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  320. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  321. package/src/shared/domain/agent-policy/messages.ts +66 -0
  322. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  323. package/src/shared/domain/agent-policy/permission.ts +20 -18
  324. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  325. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  326. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  327. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  328. package/src/shared/domain/agent-registry.ts +6 -5
  329. package/src/shared/domain/agents/chain.ts +2 -2
  330. package/src/shared/domain/agents/charter.ts +8 -5
  331. package/src/shared/domain/agents/exclusive.ts +2 -1
  332. package/src/shared/domain/agents/instances.ts +18 -15
  333. package/src/shared/domain/agents/messages.ts +39 -0
  334. package/src/shared/domain/agents/model-route.ts +199 -0
  335. package/src/shared/domain/agents/prompts.ts +20 -0
  336. package/src/shared/domain/code-intel-contract.ts +5 -4
  337. package/src/shared/domain/code-intel-routing.ts +8 -61
  338. package/src/shared/domain/compact-outcome.ts +5 -3
  339. package/src/shared/domain/compaction-thresholds.ts +2 -1
  340. package/src/shared/domain/compaction.ts +22 -113
  341. package/src/shared/domain/config-schema.ts +94 -81
  342. package/src/shared/domain/context-prune.ts +176 -0
  343. package/src/shared/domain/decision/questions.ts +102 -0
  344. package/src/shared/domain/dev/access-cost.ts +19 -15
  345. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  346. package/src/shared/domain/dev/build-commands.ts +5 -4
  347. package/src/shared/domain/dev/call-guard.ts +29 -28
  348. package/src/shared/domain/dev/carried-text.ts +3 -5
  349. package/src/shared/domain/dev/learn-proposals.ts +5 -4
  350. package/src/shared/domain/dev/learn-state.ts +3 -2
  351. package/src/shared/domain/dev/markers.ts +107 -0
  352. package/src/shared/domain/dev/messages.ts +259 -0
  353. package/src/shared/domain/dev/phase-timing.ts +50 -0
  354. package/src/shared/domain/dev/plan-checks.ts +24 -23
  355. package/src/shared/domain/dev/plan-format.ts +14 -24
  356. package/src/shared/domain/dev/project-files.ts +1 -15
  357. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  358. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  359. package/src/shared/domain/dev/questions.ts +33 -15
  360. package/src/shared/domain/dev/repo-pack.ts +12 -9
  361. package/src/shared/domain/dev/review-answer.ts +40 -17
  362. package/src/shared/domain/dev/review-brief.ts +54 -0
  363. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  364. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  365. package/src/shared/domain/dev/spec-format.ts +13 -14
  366. package/src/shared/domain/dev/step-budget.ts +4 -2
  367. package/src/shared/domain/dev/step-rules.ts +3 -4
  368. package/src/shared/domain/dev/test-commands.ts +14 -10
  369. package/src/shared/domain/dev/tool-guards.ts +4 -3
  370. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  371. package/src/shared/domain/dev/verdict-format.ts +14 -21
  372. package/src/shared/domain/dev/whitespace.ts +3 -2
  373. package/src/shared/domain/dev/work-folder.ts +4 -3
  374. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  375. package/src/shared/domain/error-text.ts +13 -0
  376. package/src/shared/domain/git/close.ts +5 -4
  377. package/src/shared/domain/git/messages.ts +20 -0
  378. package/src/shared/domain/git/pull-request.ts +5 -5
  379. package/src/shared/domain/host-layout.ts +147 -0
  380. package/src/shared/domain/host-paths.ts +399 -0
  381. package/src/shared/domain/llm-failure.ts +35 -7
  382. package/src/shared/domain/llm-profile.ts +22 -3
  383. package/src/shared/domain/marked-message.ts +1 -5
  384. package/src/shared/domain/markers.ts +30 -0
  385. package/src/shared/domain/messages.ts +291 -0
  386. package/src/shared/domain/model-catalog.ts +2 -9
  387. package/src/shared/domain/permission-modes.ts +4 -8
  388. package/src/shared/domain/prelude.ts +2 -2
  389. package/src/shared/domain/project-manifests.ts +3 -2
  390. package/src/shared/domain/prompts.ts +233 -0
  391. package/src/shared/domain/search-routing.ts +3 -11
  392. package/src/shared/domain/secret-patterns.ts +3 -2
  393. package/src/shared/domain/session-keys.ts +7 -0
  394. package/src/shared/domain/session-start.ts +3 -2
  395. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  396. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  397. package/src/shared/domain/shared-memory/entry.ts +26 -20
  398. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  399. package/src/shared/domain/shared-memory/gate.ts +4 -3
  400. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  401. package/src/shared/domain/shared-memory/layout.ts +11 -8
  402. package/src/shared/domain/shared-memory/markers.ts +9 -0
  403. package/src/shared/domain/shared-memory/messages.ts +66 -0
  404. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  405. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  406. package/src/shared/domain/shared-memory/refused.ts +3 -3
  407. package/src/shared/domain/skills/prompts.ts +4 -0
  408. package/src/shared/domain/skills/shortlist.ts +149 -0
  409. package/src/shared/domain/snip-turns.ts +2 -14
  410. package/src/shared/domain/speech.ts +2 -1
  411. package/src/shared/domain/tool-trace.ts +5 -7
  412. package/src/shared/domain/verifiers.ts +7 -11
  413. package/src/shared/domain/vfs.ts +8 -1
  414. package/src/shared/domain/workflow/prompts.ts +15 -0
  415. package/src/shared/domain/workflow/state-file.ts +14 -12
  416. package/src/shared/infrastructure/globals.ts +7 -2
  417. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  418. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  419. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  420. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  421. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  422. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  423. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  424. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  425. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  426. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  427. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  428. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  429. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  430. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  431. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  432. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  433. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  434. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  435. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  436. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  437. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  438. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  439. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  440. package/src/shared/domain/session-summary.ts +0 -13
@@ -15,9 +15,10 @@ import type { BatchState, PlanBatch } from "../../../shared/domain/dev/plan-form
15
15
  import { lastVerdict, severityCounts } from "../../../shared/domain/dev/verdict-format.ts";
16
16
  import { readPlanSource, resolvePlanSource } from "../../../shared/application/dev/plan-source.ts";
17
17
  import { blockingStop } from "../../../shared/domain/dev/spec-format.ts";
18
+ import { ACCEPT_NEEDS_ID, ACCEPT_REFUSE_ALONE, DEV_STATUS_USAGE, NOT_IN_THE_PLAN, NO_CODE_HERE, NO_SHEET, NO_VERDICT, REFUSED_MOTIF_TOO_LONG, REFUSE_NEEDS_TARGET, REPLACE_ONCE, devStatusCannotList, codesHere, holdsNoDevFile, learnUnknownOption, moreBatches, moreFoldersNotProbed, moreWarnings, noBatchLine, noCodeUnder, noFolder, notAProposalId, notAStatusCode, notAnAxis, oneAxisAtMost, oneSourceAtMost, packLine, planLine, planUnknownOption, sheetOpenTicks, validButOpen, warningLine, workFolderInMainWorktree, workFolderLine } from "./messages.ts";
19
+ import { notASource as notACodeNorSource } from "../../../shared/application/dev/messages.ts";
18
20
 
19
21
  export type DevStatusDeps = DevContextDeps;
20
- export const DEV_STATUS_USAGE = "usage: /dev-status [<code>]";
21
22
  const MAX_BATCH_LINES = 20;
22
23
  export const MAX_WARNING_LINES = 5;
23
24
  export const MAX_LINE_CHARS = 160;
@@ -39,14 +40,14 @@ function cut(text: string, max: number): string {
39
40
  function contextLines(ctx: DevContext): string[] {
40
41
  const packShown = ctx.pack?.shown ?? null;
41
42
  return [
42
- cut(`work folder: ${workFolderLabel(ctx.work, packShown)}`, MAX_LINE_CHARS),
43
- cut(`pack: ${packShown ?? "none"}`, MAX_LINE_CHARS),
43
+ cut(workFolderLine(workFolderLabel(ctx.work, packShown)), MAX_LINE_CHARS),
44
+ cut(packLine(packShown ?? "none"), MAX_LINE_CHARS),
44
45
  ];
45
46
  }
46
47
 
47
48
  function warningLines(warnings: readonly string[], max: number): string[] {
48
- const shown = warnings.slice(0, max).map((w) => cut(`warning: ${w}`, MAX_WARNING_CHARS));
49
- if (warnings.length > max) shown.push(`… ${warnings.length - max} more warnings`);
49
+ const shown = warnings.slice(0, max).map((w) => cut(warningLine(w), MAX_WARNING_CHARS));
50
+ if (warnings.length > max) shown.push(moreWarnings(warnings.length - max));
50
51
  return shown;
51
52
  }
52
53
 
@@ -55,7 +56,7 @@ function refusal(ctx: DevContext, text: string): CommandView {
55
56
  }
56
57
 
57
58
  function stateText(batch: PlanBatch | undefined): string {
58
- if (!batch) return "not in the plan";
59
+ if (!batch) return NOT_IN_THE_PLAN;
59
60
  const s: BatchState = batch.state;
60
61
  if (s.kind === "open") return "open";
61
62
  if (s.kind === "done") return `done ${s.date}`;
@@ -65,7 +66,7 @@ function stateText(batch: PlanBatch | undefined): string {
65
66
  function verdictText(code: DevCode, id: string): { text: string; valid: boolean } {
66
67
  let section = null;
67
68
  for (const v of code.verdicts) if (v.batch === id) section = lastVerdict(v.file) ?? section;
68
- if (section === null || section.verdict === null) return { text: "no verdict", valid: false };
69
+ if (section === null || section.verdict === null) return { text: NO_VERDICT, valid: false };
69
70
  const head = [section.verdict, section.when, section.mode].filter((p) => p !== undefined && p !== "").join(" ");
70
71
  const counts = severityCounts(section);
71
72
  if (section.verdict === "VALID") {
@@ -104,14 +105,14 @@ function batchLines(code: DevCode): { ids: string[]; lines: string[]; warnings:
104
105
  const n = p.behaviourSteps;
105
106
  parts.push(`sheet RED ${p.red}/${n} GREEN ${p.green}/${n} COST ${p.cost}/${n}`);
106
107
  if (batch?.state.kind === "done" && p.complete < n) {
107
- warnings.push(`${id} is done in the plan but its sheet has open ticks (RED ${p.red}/${n})`);
108
+ warnings.push(sheetOpenTicks(id, p.red, n));
108
109
  }
109
110
  } else {
110
- parts.push("no sheet");
111
+ parts.push(NO_SHEET);
111
112
  }
112
113
  const verdict = verdictText(code, id);
113
114
  parts.push(verdict.text);
114
- if (verdict.valid && batch?.state.kind === "open") warnings.push(`${id} is VALID but the plan still says open`);
115
+ if (verdict.valid && batch?.state.kind === "open") warnings.push(validButOpen(id));
115
116
  const running = runningText(code, id);
116
117
  if (running !== null) parts.push(running);
117
118
  lines.push(cut(parts.join(" — "), MAX_LINE_CHARS));
@@ -119,7 +120,7 @@ function batchLines(code: DevCode): { ids: string[]; lines: string[]; warnings:
119
120
  if (code.plan) {
120
121
  const planned = new Set(planBatches.map((b) => b.id));
121
122
  for (const f of [...code.sheets, ...code.verdicts]) {
122
- if (!planned.has(f.batch)) warnings.push(`${f.name} has no batch line in the plan`);
123
+ if (!planned.has(f.batch)) warnings.push(noBatchLine(f.name));
123
124
  }
124
125
  }
125
126
  return { ids, lines, warnings };
@@ -132,7 +133,7 @@ function codeLine(code: DevCode): string {
132
133
  const p = code.plan.plan;
133
134
  const done = p.batches.filter((b) => b.state.kind === "done").length;
134
135
  const feature = p.feature === undefined ? "" : ` "${p.feature}"`;
135
- plan = `plan ${code.plan.name}${feature} (${p.batches.length} batches, ${done} done)`;
136
+ plan = planLine(code.plan.name, feature, p.batches.length, done);
136
137
  }
137
138
  return cut(`code: ${code.shown}/ — ${what} — ${plan}`, MAX_LINE_CHARS);
138
139
  }
@@ -147,7 +148,7 @@ function renderDevStatus(ctx: DevContext, code: DevCode): string[] {
147
148
  const build = (maxBatches: number, maxWarnings: number): string[] => {
148
149
  const out = [...head, ...batches.lines.slice(0, maxBatches)];
149
150
  const hidden = batches.ids.slice(maxBatches);
150
- if (hidden.length > 0) out.push(`… ${hidden.length} more batches (${hidden[0]} to ${hidden[hidden.length - 1]})`);
151
+ if (hidden.length > 0) out.push(moreBatches(hidden.length, hidden[0], hidden[hidden.length - 1]));
151
152
  return [...out, ...warningLines(warnings, maxWarnings)];
152
153
  };
153
154
  const full = build(MAX_BATCH_LINES, MAX_WARNING_LINES);
@@ -183,10 +184,10 @@ function codesLine(codes: readonly CodeSummary[]): string {
183
184
  function renderCodeList(ctx: DevContext, codes: readonly CodeSummary[], notProbed = 0): string[] {
184
185
  const lines = contextLines(ctx);
185
186
  if (codes.length === 0 && notProbed === 0) {
186
- lines.push(`no code under ${ctx.work.folder}/ (a code is a folder holding SPEC-, CHANGE- or *-PLAN.md files)`);
187
+ lines.push(noCodeUnder(ctx.work.folder));
187
188
  } else {
188
189
  if (codes.length > 0) lines.push(codesLine(codes));
189
- if (notProbed > 0) lines.push(`… ${notProbed} more folders not probed`);
190
+ if (notProbed > 0) lines.push(moreFoldersNotProbed(notProbed));
190
191
  }
191
192
  return [...lines, ...warningLines(ctx.warnings, MAX_WARNING_LINES)];
192
193
  }
@@ -197,11 +198,9 @@ export async function runDevStatus(tokens: readonly string[], deps: DevStatusDep
197
198
  const work = ctx.work;
198
199
  const code = tokens[0];
199
200
  if (code !== undefined && !isCode(code)) {
200
- return refusal(ctx,
201
- `dev-status: '${code}' is not a code: letters, digits, '.', '_' and '-', starting with a letter or a digit`);
201
+ return refusal(ctx, notAStatusCode(code));
202
202
  }
203
- const mainWorktree =
204
- `dev-status: the work folder ${work.folder} is in the main worktree, outside the mounts: run /dev-status from the main checkout`;
203
+ const mainWorktree = workFolderInMainWorktree(work.folder);
205
204
  if (work.outcome === "main-worktree") return refusal(ctx, mainWorktree);
206
205
 
207
206
  if (code === undefined) {
@@ -210,7 +209,7 @@ export async function runDevStatus(tokens: readonly string[], deps: DevStatusDep
210
209
  try {
211
210
  probe = await probeDevCodes(deps, work);
212
211
  } catch (e) {
213
- return refusal(ctx, `dev-status: ${work.folder}/ cannot be listed (${messageOf(e).split("\n")[0]})`);
212
+ return refusal(ctx, devStatusCannotList(work.folder, messageOf(e).split("\n")[0]));
214
213
  }
215
214
  }
216
215
  return { lines: renderCodeList(ctx, probe.codes, probe.notProbed) };
@@ -220,10 +219,10 @@ export async function runDevStatus(tokens: readonly string[], deps: DevStatusDep
220
219
  if (lookup.found !== null) return { lines: renderDevStatus(ctx, lookup.found) };
221
220
  if (lookup.reason === "unreachable") return refusal(ctx, mainWorktree);
222
221
  if (lookup.reason === "empty") {
223
- return refusal(ctx, `dev-status: ${work.folder}/${code}/ holds no SPEC-, CHANGE- or *-PLAN.md file`);
222
+ return refusal(ctx, holdsNoDevFile(work.folder, code));
224
223
  }
225
- const here = lookup.codes.length > 0 ? `codes here: ${lookup.codes.join(", ")}` : "no code here";
226
- return refusal(ctx, `dev-status: no folder ${work.folder}/${code}/ (${here})`);
224
+ const here = lookup.codes.length > 0 ? codesHere(lookup.codes.join(", ")) : NO_CODE_HERE;
225
+ return refusal(ctx, noFolder(work.folder, code, here));
227
226
  }
228
227
 
229
228
  // /dev-learn: the arguments, and the two decisions (--accept, --refuse). Proposing and
@@ -231,7 +230,6 @@ export async function runDevStatus(tokens: readonly string[], deps: DevStatusDep
231
230
  // reads and one or two writes, answered by the command itself through
232
231
  // shared/application/dev/learn-decision.ts (re-exported here). Nothing there edits the
233
232
  // file a proposal names: --accept prints the change to make.
234
- export const DEV_LEARN_USAGE = "usage: /dev-learn [<axis>] [--list] | --accept <id>[,<id>…] | --refuse <id | motif text>";
235
233
  export type DevLearnArgs =
236
234
  | { kind: "propose"; axis: string | null }
237
235
  | { kind: "list"; axis: string | null }
@@ -240,7 +238,7 @@ export type DevLearnArgs =
240
238
 
241
239
  const MAX_AXIS_CHARS = 40;
242
240
  const MAX_REFUSED_CHARS = 200;
243
- const ALONE = "dev-learn: --accept and --refuse each come alone";
241
+ const ALONE = ACCEPT_REFUSE_ALONE;
244
242
 
245
243
  type DevLearnParse = { ok: true; args: DevLearnArgs } | { ok: false; text: string };
246
244
 
@@ -252,12 +250,12 @@ function parseAcceptIds(rest: readonly string[]): DevLearnParse {
252
250
  if (piece === "") continue;
253
251
  const id = piece.toLowerCase();
254
252
  if (!PROPOSAL_ID.test(id)) {
255
- return { ok: false, text: `dev-learn: '${piece}' is not a proposal id (8 or 10 hex digits, from PROPOSALS.md)` };
253
+ return { ok: false, text: notAProposalId(piece) };
256
254
  }
257
255
  ids.push(id);
258
256
  }
259
257
  }
260
- if (ids.length === 0) return { ok: false, text: "dev-learn: --accept needs at least one proposal id, e.g. --accept 3f2a9c1e" };
258
+ if (ids.length === 0) return { ok: false, text: ACCEPT_NEEDS_ID };
261
259
  return { ok: true, args: { kind: "accept", ids } };
262
260
  }
263
261
 
@@ -266,8 +264,8 @@ function parseRefuseTarget(rest: readonly string[]): DevLearnParse {
266
264
  const joined = rest.join(" ").trim();
267
265
  // An id is read as one whatever its case, as --accept reads it; the motif's words keep theirs.
268
266
  const target = PROPOSAL_ID.test(joined.toLowerCase()) ? joined.toLowerCase() : joined;
269
- if (target === "") return { ok: false, text: "dev-learn: --refuse needs a proposal id or the motif's words" };
270
- if (Array.from(target).length > MAX_REFUSED_CHARS) return { ok: false, text: "dev-learn: a refused motif is at most 200 characters" };
267
+ if (target === "") return { ok: false, text: REFUSE_NEEDS_TARGET };
268
+ if (Array.from(target).length > MAX_REFUSED_CHARS) return { ok: false, text: REFUSED_MOTIF_TOO_LONG };
271
269
  return { ok: true, args: { kind: "refuse", target } };
272
270
  }
273
271
 
@@ -284,11 +282,11 @@ export function parseDevLearnArgs(tokens: readonly string[]): DevLearnParse {
284
282
  if (tok === "--list") {
285
283
  list = true;
286
284
  } else if (tok.startsWith("--")) {
287
- return { ok: false, text: `dev-learn: unknown option '${tok}' (--list, --accept, --refuse)` };
285
+ return { ok: false, text: learnUnknownOption(tok) };
288
286
  } else if (axis !== null) {
289
- return { ok: false, text: `dev-learn: one axis at most, not '${axis}' and '${tok}'` };
287
+ return { ok: false, text: oneAxisAtMost(axis, tok) };
290
288
  } else if (tok.includes("|") || /[\r\n]/.test(tok) || Array.from(tok).length > MAX_AXIS_CHARS) {
291
- return { ok: false, text: `dev-learn: '${tok}' is not an axis` };
289
+ return { ok: false, text: notAnAxis(tok) };
292
290
  } else {
293
291
  axis = tok;
294
292
  }
@@ -297,7 +295,6 @@ export function parseDevLearnArgs(tokens: readonly string[]): DevLearnParse {
297
295
  }
298
296
 
299
297
  // files and the review run in crews/dev-plan, which runs the same gate again.
300
- export const DEV_PLAN_USAGE = "usage: /dev-plan [<code> | <path>/SPEC-<code>.md | <path>/CHANGE-<code>.md] [--replace]";
301
298
  export interface DevPlanArgs { source: string | null; replace: boolean }
302
299
  export type DevPlanGateDeps = DevContextDeps;
303
300
 
@@ -312,15 +309,15 @@ export function parseDevPlanArgs(tokens: readonly string[]): { ok: true; args: D
312
309
  let replace = false;
313
310
  for (const tok of tokens) {
314
311
  if (tok === "--replace") {
315
- if (replace) return { ok: false, text: "dev-plan: --replace once at most" };
312
+ if (replace) return { ok: false, text: REPLACE_ONCE };
316
313
  replace = true;
317
314
  } else if (tok.startsWith("--")) {
318
- return { ok: false, text: `dev-plan: unknown option '${tok}' (only --replace)` };
315
+ return { ok: false, text: planUnknownOption(tok) };
319
316
  } else if (isCode(tok) || isSourcePath(tok)) {
320
- if (source !== null) return { ok: false, text: `dev-plan: one source at most, not '${source}' and '${tok}'` };
317
+ if (source !== null) return { ok: false, text: oneSourceAtMost(source, tok) };
321
318
  source = tok;
322
319
  } else {
323
- return { ok: false, text: `dev-plan: '${tok}' is neither a code nor a SPEC-<code>.md / CHANGE-<code>.md path` };
320
+ return { ok: false, text: notACodeNorSource(tok) };
324
321
  }
325
322
  }
326
323
  return { ok: true, args: { source, replace } };
@@ -0,0 +1,7 @@
1
+ // The lines of the audit's answer the batch's chain reads (ADR 0026): the dev-verify crew writes them, chainStep
2
+ // (dev-implement.ts) parses them to launch the close.
3
+
4
+ /** The audit's VALID verdict, at the start of a line: the batch. */
5
+ export const VALID_LINE = /^→ Batch (F\d+) VALID\./m;
6
+ /** The verdict file the audit wrote: its folder, its code and its batch. */
7
+ export const WRITTEN_LINE = /^written: (\S+)\/([A-Za-z0-9][A-Za-z0-9._-]*)-VERIFY-(F\d+)\.md\b/m;
@@ -0,0 +1,112 @@
1
+ // The text the dev commands show the user (ADR 0026): their usage, their refusals, the lines of a chain and of
2
+ // /dev-status. Read by dev.ts, dev-batches.ts, dev-implement.ts, dev-source.ts and the *.cmd.ts of commands/dev/.
3
+
4
+ // A chain of crews (dev-implement.ts, dev-batches.ts)
5
+ export const thenType = (command: string) => `then type ${command}`;
6
+ export const closeFollows = (command: string) => `→ the close follows: ${command}`;
7
+ /** The line a hop prints when the session's context could not be read again: the crew reads its record. */
8
+ export const CONTEXT_NOT_READ_LINE = "⚠ the session's mode could not be read again: the context read at the launch applies";
9
+ export const WRITES_FILES = "writes files";
10
+ export const WRITES_COMMITS_PUSHES = "writes files, commits and pushes";
11
+ export const CLOSE_COMMITS = "commits (the close of the batch)";
12
+ export const batchChainFailed = (error: string) => `✗ the batch's chain failed: ${error}`;
13
+ export const couldNotBeLaunched = (crew: string, reason: string, command: string) =>
14
+ `✗ ${crew} could not be launched (${reason}): type ${command}`;
15
+
16
+ // /dev-batches
17
+ export const DEV_BATCHES_USAGE =
18
+ "usage: /dev-batches [<code>] [--pr] [--concurrency n] | <code> F<n> [--close [--pr]] [— correction: <finding>]" +
19
+ " | <code> F<n> --audit [fast | full | resume] [--gate-only]" +
20
+ " (no code: the run in progress goes on; n from 1 to 4, above 1 in bypassPermissions; with F<n>, <code> may be a <path>/<CODE>-PLAN.md)";
21
+ export const devBatchesRefusal = (text: string) => `dev-batches: ${text}`;
22
+ export const CONCURRENCY_NEEDS_NUMBER = "--concurrency needs a number";
23
+ export const namesItsBatch = (option: string) => `${option} names its batch: /dev-batches <code> F<n> ${option}`;
24
+ export const runUnknownOption = (option: string) =>
25
+ `unknown option '${option}' (--pr, --concurrency; with F<n>: --close, --audit)`;
26
+ export const notAWorkCodeExplained = (token: string) => `'${token}' is not a work code (a folder name of the work folder)`;
27
+ export const oneCodeAtMost = (code: string, token: string) => `one code at most, not '${code}' and '${token}'`;
28
+ export const correctionNamesFinding = (command: string) => `a correction names its finding: ${command}`;
29
+ export const goesWithAudit = (token: string, batch: string) =>
30
+ `'${token}' goes with --audit: /dev-batches <code> ${batch} --audit ${token}`;
31
+ export const batchUnknownOption = (option: string, batch: string) =>
32
+ `unknown option '${option}' with ${batch} (--close, --pr, --audit)`;
33
+ export const onePlanAtMost = (plan: string, token: string) => `one plan at most, not '${plan}' and '${token}'`;
34
+ export const prGoesWithClose = (batch: string) =>
35
+ `with ${batch}, --pr goes with --close (the pull request is opened at the close)`;
36
+ export const CORRECTION_OR_CLOSE = "a correction runs the batch, --close commits it: one at a time";
37
+ export const oneAuditMode = (mode: string, token: string) =>
38
+ `one audit mode at most (fast, full or resume), not '${mode}' and '${token}'`;
39
+ export const auditUnknownOption = (option: string) => `unknown option '${option}' with --audit (only --gate-only)`;
40
+ export const namesItsBatchFirst = (typed: string) => `/${typed} names its batch first: F<n>, e.g. F2`;
41
+ export const correctionNamesBatch = (command: string) => `a correction names its batch: ${command}`;
42
+ export const oneBatchAtMost = (batch: string, other: string) => `one batch at most, not ${batch} and ${other}`;
43
+ export const concurrencyNotWithBatch = (batch: string) =>
44
+ `--concurrency runs a plan's batches: it does not go with ${batch}`;
45
+ export const AUDIT_OR_CORRECTION = "--audit judges the batch, a correction runs it: one at a time";
46
+ export const CHAIN_FAILED_THEN = "then type /dev-batches: the run goes on from the first batch not done";
47
+ export const batchesChainFailed = (crew: string, error: string) => `✗ the dev-batches chain failed (${crew}): ${error}`;
48
+ export const A_CREW = "a crew";
49
+ export const batchesChainStopped = (reason: string) => `✗ the dev-batches chain stopped (${reason}): ${CHAIN_FAILED_THEN}`;
50
+ export const chainNotKept = (reason: string) =>
51
+ `dev-batches: the session could not keep which chain runs (${reason}): nothing was launched`;
52
+ export const auditFailed = (error: string) => `✗ the audit failed: ${error}`;
53
+
54
+ // /dev-spec and /dev-change
55
+ export const DEV_SPEC_USAGE =
56
+ 'usage: /dev-spec <code> [bug | refactor | perf] [--run "<command>"] [<brief text> | <path>.md | <#issue> | <revision request>]';
57
+ /** Why --run needs a kind, said where it is refused. */
58
+ export const RUN_NEEDS_KIND =
59
+ "--run goes with a kind: bug (the command that reproduces it) or perf (the command that measures it); a feature is a spec and runs nothing";
60
+ export const withUsage = (text: string, usage: string) => `${text}\n${usage}`;
61
+ export const notASpecCode = (word: string) => `'${word}' is not a code (letters, digits, '.', '_', '-')`;
62
+ export const RUN_NEEDS_COMMAND = "--run needs the command, quoted";
63
+ export const RUN_BEFORE_TEXT = "--run comes before the text";
64
+
65
+ // /dev-status
66
+ export const DEV_STATUS_USAGE = "usage: /dev-status [<code>]";
67
+ export const NOT_IN_THE_PLAN = "not in the plan";
68
+ export const NO_VERDICT = "no verdict";
69
+ export const NO_SHEET = "no sheet";
70
+ export const workFolderLine = (label: string) => `work folder: ${label}`;
71
+ export const packLine = (shown: string) => `pack: ${shown}`;
72
+ export const warningLine = (warning: string) => `warning: ${warning}`;
73
+ export const moreWarnings = (count: number) => `… ${count} more warnings`;
74
+ export const sheetOpenTicks = (id: string, red: number, steps: number) =>
75
+ `${id} is done in the plan but its sheet has open ticks (RED ${red}/${steps})`;
76
+ export const validButOpen = (id: string) => `${id} is VALID but the plan still says open`;
77
+ export const noBatchLine = (name: string) => `${name} has no batch line in the plan`;
78
+ export const planLine = (name: string, feature: string, batches: number, done: number) =>
79
+ `plan ${name}${feature} (${batches} batches, ${done} done)`;
80
+ export const moreBatches = (count: number, first: string, last: string) => `… ${count} more batches (${first} to ${last})`;
81
+ export const noCodeUnder = (folder: string) =>
82
+ `no code under ${folder}/ (a code is a folder holding SPEC-, CHANGE- or *-PLAN.md files)`;
83
+ export const moreFoldersNotProbed = (count: number) => `… ${count} more folders not probed`;
84
+ export const notAStatusCode = (code: string) =>
85
+ `dev-status: '${code}' is not a code: letters, digits, '.', '_' and '-', starting with a letter or a digit`;
86
+ export const workFolderInMainWorktree = (folder: string) =>
87
+ `dev-status: the work folder ${folder} is in the main worktree, outside the mounts: run /dev-status from the main checkout`;
88
+ export const devStatusCannotList = (folder: string, reason: string) => `dev-status: ${folder}/ cannot be listed (${reason})`;
89
+ export const holdsNoDevFile = (folder: string, code: string) =>
90
+ `dev-status: ${folder}/${code}/ holds no SPEC-, CHANGE- or *-PLAN.md file`;
91
+ export const codesHere = (codes: string) => `codes here: ${codes}`;
92
+ export const NO_CODE_HERE = "no code here";
93
+ export const noFolder = (folder: string, code: string, here: string) => `dev-status: no folder ${folder}/${code}/ (${here})`;
94
+
95
+ // /dev-learn
96
+ export const DEV_LEARN_USAGE = "usage: /dev-learn [<axis>] [--list] | --accept <id>[,<id>…] | --refuse <id | motif text>";
97
+ export const ACCEPT_REFUSE_ALONE = "dev-learn: --accept and --refuse each come alone";
98
+ export const notAProposalId = (piece: string) =>
99
+ `dev-learn: '${piece}' is not a proposal id (8 or 10 hex digits, from PROPOSALS.md)`;
100
+ export const ACCEPT_NEEDS_ID = "dev-learn: --accept needs at least one proposal id, e.g. --accept 3f2a9c1e";
101
+ export const REFUSE_NEEDS_TARGET = "dev-learn: --refuse needs a proposal id or the motif's words";
102
+ export const REFUSED_MOTIF_TOO_LONG = "dev-learn: a refused motif is at most 200 characters";
103
+ export const learnUnknownOption = (token: string) => `dev-learn: unknown option '${token}' (--list, --accept, --refuse)`;
104
+ export const oneAxisAtMost = (axis: string, token: string) => `dev-learn: one axis at most, not '${axis}' and '${token}'`;
105
+ export const notAnAxis = (token: string) => `dev-learn: '${token}' is not an axis`;
106
+
107
+ // /dev-plan
108
+ export const DEV_PLAN_USAGE = "usage: /dev-plan [<code> | <path>/SPEC-<code>.md | <path>/CHANGE-<code>.md] [--replace]";
109
+ export const REPLACE_ONCE = "dev-plan: --replace once at most";
110
+ export const planUnknownOption = (token: string) => `dev-plan: unknown option '${token}' (only --replace)`;
111
+ export const oneSourceAtMost = (source: string, token: string) =>
112
+ `dev-plan: one source at most, not '${source}' and '${token}'`;
@@ -6,9 +6,10 @@ import type { PermissionRules, SessionStore, ToolCatalogue } from "../../shared/
6
6
  import type { SessionIo } from "../../shared/application/session-io.ts";
7
7
  import type { ConfigStore } from "../../shared/application/config-store.ts";
8
8
  import { configuredNames, resolveExtraTools } from "../../shared/application/extra-tools.ts";
9
- import { syncStepRules } from "../../shared/application/permission-rules.ts";
9
+ import { builtInRules, syncStepRules } from "../../shared/application/permission-rules.ts";
10
10
  import { readMemoryDir } from "../../shared/application/shared-memory/memory-settings.ts";
11
- import { memoryWriteRules } from "../../shared/domain/shared-memory/layout.ts";
11
+ import { listsOf } from "../../shared/application/host-context.ts";
12
+ import type { HostSource } from "../../shared/application/host-context.ts";
12
13
  import { readJsonArray } from "../../shared/application/session-state.ts";
13
14
  import { HOOKS_STATE_KEY } from "../../shared/domain/session-keys.ts";
14
15
  import { deniesEveryCall, formatRule } from "../../shared/domain/agent-policy/permission.ts";
@@ -21,12 +22,18 @@ import { policyFor } from "../../shared/domain/agent-policy/mode-policy.ts";
21
22
  import { isPermissionMode } from "../../shared/domain/permission-modes.ts";
22
23
  import type { ActiveWorkflow } from "../../shared/domain/workflow/state-file.ts";
23
24
  import { writeActiveWorkflow } from "../../shared/application/workflow/workflow-state.ts";
25
+ import {
26
+ batchNotRecorded, modeReadOnlyRefusal, modeUnknownRefusal, modeUnreadableRefusal, sessionRuleLeftOut,
27
+ stepRulesNotInGate,
28
+ } from "./messages.ts";
24
29
 
25
30
  export interface DevStepDeps {
26
31
  session: Pick<SessionStore, "readState">;
27
32
  gate: PermissionRules;
28
33
  config: Pick<ConfigStore, "readValue" | "readFile">;
29
34
  catalogue: Pick<ToolCatalogue, "find">;
35
+ /** This run's host context, for its path lists (paths.deny in the gate); absent: no list. */
36
+ host?: HostSource;
30
37
  }
31
38
 
32
39
  export type DevStepStart =
@@ -53,14 +60,10 @@ export async function startDevStep(step: DevStep, deps: DevStepDeps): Promise<De
53
60
  const extras = await resolveExtraTools(deps);
54
61
  const sync = await syncStepRules({
55
62
  session: deps.session, gate: deps.gate, extraNames: configuredNames(extras), rules: stepRules(step),
56
- builtIn: memoryWriteRules((await readMemoryDir(deps.config)).dir),
63
+ builtIn: builtInRules((await readMemoryDir(deps.config)).dir, await listsOf(deps.host)),
57
64
  });
58
- if (!sync.applied) {
59
- lines.push(`warning: the host keeps no session rules: /${stepCommand(step)}'s rule sets are not in the host's gate, the crew's callback alone checks them.`);
60
- }
61
- for (const r of sync.overridden) {
62
- lines.push(`warning: the session's rule '${formatRule(r)}' is left out of the gate during /${stepCommand(step)}: the step denies the same calls.`);
63
- }
65
+ if (!sync.applied) lines.push(stepRulesNotInGate(stepCommand(step)));
66
+ for (const r of sync.overridden) lines.push(sessionRuleLeftOut(formatRule(r), stepCommand(step)));
64
67
  const hooks = await readJsonArray(deps.session, HOOKS_STATE_KEY);
65
68
  const memoryDenied = deniesEveryCall(gateRules(deps.gate), "memory_recall");
66
69
  return {
@@ -83,10 +86,10 @@ function gateRules(gate: PermissionRules) {
83
86
  * a step never writes on a mode it does not know); null when it may run. `writes` says what the step writes.
84
87
  */
85
88
  export function writeModeRefusal(mode: string, step: string, writes: string): string | null {
86
- if (mode === "") return `✗ refused: the session mode could not be read, and /${stepCommand(step)} ${writes}: run it again`;
87
- if (!isPermissionMode(mode)) return `✗ refused: the session mode ${mode} is not one Orkeon Code knows, and /${stepCommand(step)} ${writes}: /mode default, then run it again`;
89
+ if (mode === "") return modeUnreadableRefusal(stepCommand(step), writes);
90
+ if (!isPermissionMode(mode)) return modeUnknownRefusal(mode, stepCommand(step), writes);
88
91
  if (!policyFor(mode).readOnly) return null;
89
- return `✗ refused: the session mode ${mode} is read-only, and /${stepCommand(step)} ${writes}: /mode default, then run it again`;
92
+ return modeReadOnlyRefusal(mode, stepCommand(step), writes);
90
93
  }
91
94
 
92
95
  /** writeModeRefusal over the session's effective mode, read here: a read that fails refuses. */
@@ -137,6 +140,6 @@ export async function markActiveWorkflow(
137
140
  return null;
138
141
  } catch (error) {
139
142
  const reason = error instanceof Error ? error.message : String(error);
140
- return `warning: the batch in progress could not be recorded (${reason}): a compaction will write no state file for it.`;
143
+ return batchNotRecorded(reason);
141
144
  }
142
145
  }
@@ -6,25 +6,31 @@
6
6
  // (createCrewHost(ctx.services), createPermissionRules(ctx.services)) and hands
7
7
  // them over with the command's log.
8
8
 
9
+ import { routeAgent } from "../../shared/application/agents/route-agent.ts";
10
+ import type { RouteDeps, RouteTask } from "../../shared/application/agents/route-agent.ts";
9
11
  import type { CrewHost, CrewLaunchOptions, PermissionRules, ToolCatalogue } from "../../shared/application/ports.ts";
10
12
  import type { ConfigStore } from "../../shared/application/config-store.ts";
11
13
  import type { SessionIo } from "../../shared/application/session-io.ts";
12
14
  import { configuredNames, resolveExtraTools } from "../../shared/application/extra-tools.ts";
13
15
  import { readLlmProfile } from "../../shared/application/llm-profile.ts";
14
- import { syncPermissionRules } from "../../shared/application/permission-rules.ts";
16
+ import { builtInRules, syncPermissionRules } from "../../shared/application/permission-rules.ts";
15
17
  import { readMemoryDir } from "../../shared/application/shared-memory/memory-settings.ts";
16
- import { memoryWriteRules } from "../../shared/domain/shared-memory/layout.ts";
18
+ import { listsOf } from "../../shared/application/host-context.ts";
19
+ import type { HostSource } from "../../shared/application/host-context.ts";
17
20
  import { formatRule } from "../../shared/domain/agent-policy/permission.ts";
18
21
  import { chainDepthLine, chainDepthRefusal } from "../../shared/domain/agents/chain.ts";
19
22
  import { exclusiveLine, exclusiveRefusal } from "../../shared/domain/agents/exclusive.ts";
20
- import { LLM_PROFILE_INPUT_KEY } from "../../shared/domain/llm-profile.ts";
23
+ import { LLM_PROFILE_FALLBACK_INPUT_KEY, LLM_PROFILE_INPUT_KEY } from "../../shared/domain/llm-profile.ts";
21
24
  import { errorText } from "../../shared/domain/prelude.ts";
22
25
  import type { EpilogueCall, PreludeCall } from "../../shared/domain/prelude.ts";
23
26
  import type { StartOutput } from "../../shared/domain/session-start.ts";
24
27
  import { SPEAK_TOOL, VOICE_REPLY_CONFIG_KEY, voiceReplyEpilogue, voiceReplyOn } from "../../shared/domain/speech.ts";
28
+ import { EXTRA_TOOLS_CONFIG_KEY, formatExtraTool } from "../../shared/domain/agent-policy/extra-tools.ts";
29
+ import { EXTRA_TOOL_ENTRY_RULE } from "../../shared/domain/agent-policy/messages.ts";
25
30
  import {
26
- EXTRA_TOOLS_CONFIG_KEY, EXTRA_TOOL_ENTRY_RULE, formatExtraTool,
27
- } from "../../shared/domain/agent-policy/extra-tools.ts";
31
+ extraToolIgnored, extraToolMissing, extraToolsUnreadable, invalidPermissionEntries, NO_SESSION_RULES, ruleDormant,
32
+ ruleOverridden, voiceReplyNoSpeakTool, voiceReplyUnreadable,
33
+ } from "./messages.ts";
28
34
 
29
35
  /** The command's log as the runtime hands it to a command: a line and its details. */
30
36
  export interface CommandLog {
@@ -39,6 +45,9 @@ export interface LaunchDeps {
39
45
  crews: Pick<CrewHost, "launch">;
40
46
  log: Pick<CommandLog, "info">;
41
47
  llmProfile?: string | null;
48
+ /** Set when the routing picked `llmProfile`: the session's own profile ("" for the host's default model), which the
49
+ * crew falls back on when the host declares no profile of the routed name. */
50
+ llmProfileFallback?: string;
42
51
  }
43
52
 
44
53
  /** `deps` with the session's `llm.profile` read: what every command hands launchCrew. A setting that cannot be
@@ -51,6 +60,16 @@ export async function withLlmProfile<D extends LaunchDeps & { log: Pick<CommandL
51
60
  return { ...deps, llmProfile: read.profile };
52
61
  }
53
62
 
63
+ /** `deps` with the profile the launch of `task.crew` runs on: the session's `llm.profile`, then, with `route.agents`
64
+ * on, the rung of the ladder the host's decision model picks for the command (shared/application/agents/route-agent). */
65
+ export async function withRoutedProfile<D extends LaunchDeps & { log: Pick<CommandLog, "warn" | "info"> }>(
66
+ deps: D, config: Pick<ConfigStore, "readValue" | "readFile">, routing: Omit<RouteDeps, "config" | "log">, task: RouteTask,
67
+ ): Promise<D & { llmProfile: string | null }> {
68
+ const profiled = await withLlmProfile(deps, config);
69
+ const routed = await routeAgent({ ...routing, config, log: deps.log }, task, profiled.llmProfile);
70
+ return routed === profiled.llmProfile ? profiled : { ...profiled, llmProfile: routed, llmProfileFallback: profiled.llmProfile ?? "" };
71
+ }
72
+
54
73
  /** A crew's completion, as an async command's `completed` receives it; `intent` names the crew that answered,
55
74
  * `streamed` says the console already showed the answer as it was generated (Orkeon #228). */
56
75
  export interface CrewCompletion {
@@ -83,6 +102,7 @@ export function launchCrew(
83
102
  const profile = deps.llmProfile ?? null;
84
103
  if (profile !== null) {
85
104
  input = { ...input, [LLM_PROFILE_INPUT_KEY]: profile };
105
+ if (deps.llmProfileFallback !== undefined) input = { ...input, [LLM_PROFILE_FALLBACK_INPUT_KEY]: deps.llmProfileFallback };
86
106
  details = { ...details, llmProfile: profile };
87
107
  }
88
108
  let ticket: string;
@@ -114,6 +134,8 @@ export interface MainLoopLaunchDeps extends LaunchDeps {
114
134
  config: Pick<ConfigStore, "readValue" | "readFile">;
115
135
  catalogue: Pick<ToolCatalogue, "find">;
116
136
  gate: PermissionRules;
137
+ /** This run's host context, for its path lists (paths.deny in the gate); absent: no list. */
138
+ host?: HostSource;
117
139
  }
118
140
 
119
141
  /**
@@ -140,33 +162,20 @@ export async function launchMainLoop(
140
162
  const permissionMode = resolved ? resolved.mode : input.permissionMode;
141
163
 
142
164
  const extras = await resolveExtraTools(deps);
143
- for (const tool of extras.missing) {
144
- log.warn(
145
- `extra tool '${tool.name}' is not registered by the host and is left out ` +
146
- "(its MCP server did not connect, its plugin did not load, or the name is mistyped)",
147
- );
148
- }
165
+ for (const tool of extras.missing) log.warn(extraToolMissing(tool.name));
149
166
  for (const entry of extras.invalid) {
150
- log.warn(`${EXTRA_TOOLS_CONFIG_KEY}: '${entry}' is ignored (${EXTRA_TOOL_ENTRY_RULE})`);
167
+ log.warn(extraToolIgnored(EXTRA_TOOLS_CONFIG_KEY, entry, EXTRA_TOOL_ENTRY_RULE));
151
168
  }
152
169
  if (extras.unreadable !== undefined) {
153
- log.warn(`${EXTRA_TOOLS_CONFIG_KEY} could not be read (${extras.unreadable}): no extra tool this turn`);
170
+ log.warn(extraToolsUnreadable(EXTRA_TOOLS_CONFIG_KEY, extras.unreadable));
154
171
  }
155
172
 
156
- const builtIn = memoryWriteRules((await readMemoryDir(deps.config)).dir);
173
+ const builtIn = builtInRules((await readMemoryDir(deps.config)).dir, await listsOf(deps.host));
157
174
  const sync = await syncPermissionRules({ session, gate: deps.gate, extraNames: configuredNames(extras), builtIn });
158
- for (const rule of sync.overridden) {
159
- log.warn(`permission rule '${formatRule(rule)}' is left out of the gate: no tool of the model writes the shared memory's candidates or entries`);
160
- }
161
- for (const rule of sync.dormant) {
162
- log.warn(
163
- `permission rule '${rule}' is dormant: ${EXTRA_TOOLS_CONFIG_KEY} does not list its tool, the gate does not get it`,
164
- );
165
- }
166
- if (sync.invalid.length > 0) {
167
- log.warn(`${sync.invalid.length} stored permission entr(ies) are not rules and were ignored`);
168
- }
169
- if (!sync.applied) log.warn("the host keeps no session rules: the gate decides each call from the mode alone");
175
+ for (const rule of sync.overridden) log.warn(ruleOverridden(formatRule(rule)));
176
+ for (const rule of sync.dormant) log.warn(ruleDormant(rule, EXTRA_TOOLS_CONFIG_KEY));
177
+ if (sync.invalid.length > 0) log.warn(invalidPermissionEntries(sync.invalid.length));
178
+ if (!sync.applied) log.warn(NO_SESSION_RULES);
170
179
  const epilogue = await voiceReply(deps);
171
180
  const profiled = deps.llmProfile === undefined ? await withLlmProfile(deps, deps.config) : deps;
172
181
  return launchCrew(
@@ -199,33 +208,47 @@ async function voiceReply(deps: Pick<MainLoopLaunchDeps, "config" | "catalogue"
199
208
  try {
200
209
  value = (await deps.config.readValue(VOICE_REPLY_CONFIG_KEY)).value;
201
210
  } catch (error) {
202
- deps.log.warn(`${VOICE_REPLY_CONFIG_KEY} could not be read (${errorText(error)}): the answer is not read aloud this turn`);
211
+ deps.log.warn(voiceReplyUnreadable(VOICE_REPLY_CONFIG_KEY, errorText(error)));
203
212
  return undefined;
204
213
  }
205
214
  if (!voiceReplyOn(value)) return undefined;
206
215
  const speak = deps.catalogue.find(SPEAK_TOOL);
207
216
  if (speak === undefined) {
208
- deps.log.warn(
209
- `${VOICE_REPLY_CONFIG_KEY} is on but the host registers no '${SPEAK_TOOL}': the answer is not read aloud ` +
210
- "(start orkeon-code with ORKEON_CODE_AUDIO_DIR and ORKEON_CODE_VOICE=1)",
211
- );
217
+ deps.log.warn(voiceReplyNoSpeakTool(VOICE_REPLY_CONFIG_KEY, SPEAK_TOOL));
212
218
  return undefined;
213
219
  }
214
220
  return voiceReplyEpilogue(speak);
215
221
  }
216
222
 
217
- /** Write a crew-completion line: `<okPrefix><payload>` or `✗ <label> failed: …`; nothing for a success the console
218
- * already streamed, or the answer would show twice (Orkeon #228). */
223
+ /** The opening of a markdown block a prefix on the same line would turn into plain text. */
224
+ const OPENS_ON_A_BLOCK = /^\s*(#{1,6}\s|```|~~~|[-*+]\s|\d+\.\s|>|\|)/;
225
+
226
+ /** `<okPrefix><payload>`, the prefix on its own line when the payload opens on a block. */
227
+ function prefixed(okPrefix: string, payload: string): string {
228
+ const inline = !okPrefix || okPrefix.endsWith("\n") || !OPENS_ON_A_BLOCK.test(payload);
229
+ return inline ? okPrefix + payload : `${okPrefix.trimEnd()}\n\n${payload}`;
230
+ }
231
+
232
+ /** Write a crew's completion: `<okPrefix><payload>` as a markdown block, or the line `✗ <label> failed: …`; nothing
233
+ * for a success the console already streamed, or the answer would show twice (Orkeon #228). */
219
234
  export function writeCompleted(
220
- out: { writeLine(text: string): void },
235
+ out: { writeLine(text: string): void; writeBlock(spec: { kind: "markdown"; text: string }): void },
221
236
  result: CrewCompletion,
222
237
  label: string,
223
238
  okPrefix = "",
224
239
  ): void {
225
240
  if (result.success && result.streamed === true) return;
226
- out.writeLine(
227
- result.success
228
- ? okPrefix + result.payload
229
- : "✗ " + label + " failed: " + (result.error ?? "unknown"),
230
- );
241
+ if (result.success) out.writeBlock({ kind: "markdown", text: prefixed(okPrefix, String(result.payload)) });
242
+ else out.writeLine("✗ " + label + " failed: " + (result.error ?? "unknown"));
243
+ }
244
+
245
+ /** `writeCompleted` for what a program wrote and no model did: a transcript, a count. Markdown would change it (the
246
+ * stars of `*.ts`, the underscores of `__init__.py`), so it stays a line. */
247
+ export function writePlainCompleted(
248
+ out: { writeLine(text: string): void },
249
+ result: CrewCompletion,
250
+ label: string,
251
+ ): void {
252
+ if (result.success && result.streamed === true) return;
253
+ out.writeLine(result.success ? String(result.payload) : "✗ " + label + " failed: " + (result.error ?? "unknown"));
231
254
  }