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

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 (443) hide show
  1. package/.orkeon-runtime +11 -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 +508 -80
  13. package/orkeon-code.ps1 +129 -11
  14. package/package.json +3 -1
  15. package/scripts/dev-run.sh +139 -0
  16. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  17. package/src/commands/_lib/args.ts +5 -4
  18. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  19. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  20. package/src/commands/_lib/dev/dev-source.ts +7 -11
  21. package/src/commands/_lib/dev/dev.ts +34 -37
  22. package/src/commands/_lib/dev/markers.ts +7 -0
  23. package/src/commands/_lib/dev/messages.ts +112 -0
  24. package/src/commands/_lib/dev-step.ts +16 -13
  25. package/src/commands/_lib/dispatch.ts +62 -39
  26. package/src/commands/_lib/git/branch.ts +9 -10
  27. package/src/commands/_lib/git/commit.ts +9 -13
  28. package/src/commands/_lib/git/diff.ts +22 -12
  29. package/src/commands/_lib/git/messages.ts +54 -0
  30. package/src/commands/_lib/git/review.ts +9 -10
  31. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  32. package/src/commands/_lib/memory/memory.ts +3 -2
  33. package/src/commands/_lib/memory/messages.ts +32 -0
  34. package/src/commands/_lib/messages.ts +48 -0
  35. package/src/commands/_lib/project/messages.ts +8 -0
  36. package/src/commands/_lib/session/export.ts +3 -2
  37. package/src/commands/_lib/session/messages.ts +87 -0
  38. package/src/commands/_lib/session/prompts.ts +4 -0
  39. package/src/commands/_lib/session/resume.ts +15 -24
  40. package/src/commands/_lib/session/tasks.ts +20 -23
  41. package/src/commands/_lib/settings/advisor.ts +11 -16
  42. package/src/commands/_lib/settings/agents.ts +18 -28
  43. package/src/commands/_lib/settings/choices.ts +8 -0
  44. package/src/commands/_lib/settings/config.ts +43 -43
  45. package/src/commands/_lib/settings/effort.ts +147 -0
  46. package/src/commands/_lib/settings/hooks.ts +12 -20
  47. package/src/commands/_lib/settings/messages.ts +408 -0
  48. package/src/commands/_lib/settings/mode.ts +33 -24
  49. package/src/commands/_lib/settings/model.ts +71 -36
  50. package/src/commands/_lib/settings/output-style.ts +39 -0
  51. package/src/commands/_lib/settings/permissions.ts +71 -93
  52. package/src/commands/_lib/settings/route.ts +63 -0
  53. package/src/commands/_lib/settings/skills.ts +53 -11
  54. package/src/commands/_lib/settings/theme.ts +42 -0
  55. package/src/commands/_lib/speech/messages.ts +58 -0
  56. package/src/commands/_lib/speech/prompts.ts +4 -0
  57. package/src/commands/_lib/speech/say.ts +9 -10
  58. package/src/commands/_lib/speech/transcribe.ts +14 -23
  59. package/src/commands/_lib/speech/voice.ts +14 -18
  60. package/src/commands/_lib/status/doctor.ts +47 -28
  61. package/src/commands/_lib/status/messages.ts +101 -0
  62. package/src/commands/_lib/status/meta.ts +5 -25
  63. package/src/commands/_lib/status/status.ts +10 -11
  64. package/src/commands/_lib/status/usage-tools.ts +2 -3
  65. package/src/commands/_lib/status/usage.ts +7 -18
  66. package/src/commands/_lib/view.ts +6 -1
  67. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  68. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  69. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  70. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  71. package/src/commands/git/commit.cmd.ts +3 -3
  72. package/src/commands/git/review.cmd.ts +3 -3
  73. package/src/commands/memory/memory.cmd.ts +2 -2
  74. package/src/commands/project/analyze.cmd.ts +3 -3
  75. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  76. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  77. package/src/commands/project/init.cmd.ts +3 -3
  78. package/src/commands/project/verify.cmd.ts +2 -2
  79. package/src/commands/session/assistant.cmd.ts +2 -2
  80. package/src/commands/session/compact.cmd.ts +1 -1
  81. package/src/commands/session/copy.cmd.ts +8 -7
  82. package/src/commands/session/rename.cmd.ts +3 -2
  83. package/src/commands/session/rewind.cmd.ts +3 -4
  84. package/src/commands/session/summary.cmd.ts +3 -3
  85. package/src/commands/session/tasks.cmd.ts +4 -2
  86. package/src/commands/settings/config.cmd.ts +4 -2
  87. package/src/commands/settings/effort.cmd.ts +10 -31
  88. package/src/commands/settings/fast.cmd.ts +2 -1
  89. package/src/commands/settings/mode.cmd.ts +3 -3
  90. package/src/commands/settings/model.cmd.ts +3 -2
  91. package/src/commands/settings/output-style.cmd.ts +9 -38
  92. package/src/commands/settings/permissions.cmd.ts +2 -2
  93. package/src/commands/settings/proactive.cmd.ts +2 -1
  94. package/src/commands/settings/route.cmd.ts +16 -0
  95. package/src/commands/settings/skills.cmd.ts +3 -3
  96. package/src/commands/settings/theme.cmd.ts +14 -0
  97. package/src/commands/speech/say.cmd.ts +2 -2
  98. package/src/commands/speech/transcribe.cmd.ts +2 -2
  99. package/src/commands/status/release-notes.cmd.ts +1 -1
  100. package/src/crews/.orkeon/orkeon.d.ts +539 -94
  101. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  102. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  103. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  104. package/src/crews/_probe-shared-memory/probe.ork.ts +8 -6
  105. package/src/crews/advisor/application/messages.ts +4 -0
  106. package/src/crews/advisor/application/prompts.ts +4 -0
  107. package/src/crews/advisor/application/run-advisor.ts +2 -1
  108. package/src/crews/advisor/crew.ork.ts +6 -5
  109. package/src/crews/advisor/domain/advice.ts +7 -23
  110. package/src/crews/advisor/domain/messages.ts +8 -0
  111. package/src/crews/advisor/domain/prompts.ts +26 -0
  112. package/src/crews/agent-run/application/messages.ts +18 -0
  113. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  114. package/src/crews/agent-run/crew.ork.ts +4 -4
  115. package/src/crews/analyze/application/messages.ts +27 -0
  116. package/src/crews/analyze/application/prompts.ts +4 -0
  117. package/src/crews/analyze/application/run-analyze.ts +16 -14
  118. package/src/crews/analyze/crew.ork.ts +5 -4
  119. package/src/crews/analyze/domain/harvest.ts +33 -65
  120. package/src/crews/analyze/domain/prompts.ts +86 -0
  121. package/src/crews/code-review/application/lens-material.ts +24 -0
  122. package/src/crews/code-review/application/messages.ts +17 -0
  123. package/src/crews/code-review/application/prompts.ts +10 -17
  124. package/src/crews/code-review/application/review.ts +4 -1
  125. package/src/crews/code-review/application/run-code-review.ts +13 -15
  126. package/src/crews/code-review/crew.ork.ts +6 -5
  127. package/src/crews/code-review/domain/lenses.ts +6 -45
  128. package/src/crews/code-review/domain/messages.ts +25 -0
  129. package/src/crews/code-review/domain/prompts.ts +58 -0
  130. package/src/crews/code-review/domain/report.ts +5 -6
  131. package/src/crews/code-review/domain/scope.ts +6 -12
  132. package/src/crews/dev-batches/application/messages.ts +127 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  134. package/src/crews/dev-batches/application/prompts.ts +10 -0
  135. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  136. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  137. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  138. package/src/crews/dev-batches/crew.ork.ts +13 -10
  139. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  140. package/src/crews/dev-batches/domain/markers.ts +5 -0
  141. package/src/crews/dev-batches/domain/messages.ts +6 -0
  142. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  143. package/src/crews/dev-change/application/change-material.ts +44 -0
  144. package/src/crews/dev-change/application/evidence.ts +25 -22
  145. package/src/crews/dev-change/application/messages.ts +81 -0
  146. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  147. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  148. package/src/crews/dev-change/crew.ork.ts +11 -9
  149. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  150. package/src/crews/dev-change/domain/change-render.ts +14 -16
  151. package/src/crews/dev-change/domain/markers.ts +28 -0
  152. package/src/crews/dev-change/domain/messages.ts +16 -0
  153. package/src/crews/dev-implement/application/close.ts +21 -18
  154. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  155. package/src/crews/dev-implement/application/messages.ts +161 -0
  156. package/src/crews/dev-implement/application/observe.ts +4 -2
  157. package/src/crews/dev-implement/application/prompts.ts +9 -0
  158. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  159. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  160. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  161. package/src/crews/dev-implement/crew.ork.ts +2 -1
  162. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  163. package/src/crews/dev-implement/domain/correction.ts +16 -15
  164. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  165. package/src/crews/dev-implement/domain/markers.ts +23 -0
  166. package/src/crews/dev-implement/domain/messages.ts +58 -0
  167. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  168. package/src/crews/dev-implement/domain/roles.ts +3 -7
  169. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  170. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  171. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  172. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  173. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  174. package/src/crews/dev-learn/application/messages.ts +56 -0
  175. package/src/crews/dev-learn/application/prompts.ts +96 -0
  176. package/src/crews/dev-learn/application/run-dev-learn.ts +51 -43
  177. package/src/crews/dev-learn/crew.ork.ts +5 -4
  178. package/src/crews/dev-learn/domain/learn-answer.ts +60 -37
  179. package/src/crews/dev-learn/domain/markers.ts +10 -0
  180. package/src/crews/dev-learn/domain/messages.ts +74 -0
  181. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  182. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  183. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  184. package/src/crews/dev-plan/application/inventory.ts +17 -13
  185. package/src/crews/dev-plan/application/messages.ts +88 -0
  186. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  187. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  188. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  189. package/src/crews/dev-plan/crew.ork.ts +12 -9
  190. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  191. package/src/crews/dev-plan/domain/markers.ts +18 -0
  192. package/src/crews/dev-plan/domain/messages.ts +118 -0
  193. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  194. package/src/crews/dev-plan/domain/plan-render.ts +33 -34
  195. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  196. package/src/crews/dev-spec/application/messages.ts +30 -0
  197. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  198. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  199. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  200. package/src/crews/dev-spec/crew.ork.ts +11 -9
  201. package/src/crews/dev-spec/domain/markers.ts +30 -0
  202. package/src/crews/dev-spec/domain/messages.ts +39 -0
  203. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  204. package/src/crews/dev-spec/domain/spec-render.ts +21 -21
  205. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  206. package/src/crews/dev-verify/application/audit.ts +38 -30
  207. package/src/crews/dev-verify/application/capture.ts +34 -26
  208. package/src/crews/dev-verify/application/messages.ts +119 -0
  209. package/src/crews/dev-verify/application/prompts.ts +209 -0
  210. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  211. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  212. package/src/crews/dev-verify/crew.ork.ts +7 -7
  213. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  214. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  215. package/src/crews/dev-verify/domain/commands.ts +3 -3
  216. package/src/crews/dev-verify/domain/gate.ts +21 -16
  217. package/src/crews/dev-verify/domain/markers.ts +16 -0
  218. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  219. package/src/crews/dev-verify/domain/messages.ts +92 -0
  220. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  221. package/src/crews/git-commit/application/draft.ts +38 -55
  222. package/src/crews/git-commit/application/messages.ts +17 -0
  223. package/src/crews/git-commit/application/prompts.ts +47 -0
  224. package/src/crews/git-commit/application/run-git-commit.ts +16 -13
  225. package/src/crews/git-commit/crew.ork.ts +6 -5
  226. package/src/crews/git-commit/domain/commit.ts +15 -35
  227. package/src/crews/git-commit/domain/markers.ts +4 -0
  228. package/src/crews/git-commit/domain/messages.ts +48 -0
  229. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  230. package/src/crews/init-verifiers/application/messages.ts +13 -0
  231. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  232. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  233. package/src/crews/init-verifiers/crew.ork.ts +6 -5
  234. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  235. package/src/crews/main-loop/application/messages.ts +81 -0
  236. package/src/crews/main-loop/application/prompts.ts +12 -0
  237. package/src/crews/main-loop/application/run-main-loop.ts +64 -31
  238. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  239. package/src/crews/main-loop/crew.ork.ts +12 -7
  240. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  241. package/src/crews/main-loop/domain/prompts.ts +336 -0
  242. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  243. package/src/crews/project-init/application/detect.ts +5 -4
  244. package/src/crews/project-init/application/messages.ts +15 -0
  245. package/src/crews/project-init/application/prompts.ts +11 -7
  246. package/src/crews/project-init/crew.ork.ts +6 -5
  247. package/src/crews/project-init/domain/existing-files.ts +6 -4
  248. package/src/crews/project-init/domain/messages.ts +13 -0
  249. package/src/crews/project-init/domain/package-map.ts +3 -3
  250. package/src/crews/project-init/domain/prompts.ts +10 -0
  251. package/src/crews/session-compact/application/prompts.ts +5 -0
  252. package/src/crews/session-compact/crew.ork.ts +6 -5
  253. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  254. package/src/crews/shared-memory-admit/crew.ork.ts +4 -3
  255. package/src/crews/speech/application/messages.ts +3 -0
  256. package/src/crews/speech/application/prompts.ts +3 -0
  257. package/src/crews/speech/application/run-speech.ts +2 -1
  258. package/src/crews/speech/crew.ork.ts +2 -1
  259. package/src/shared/application/agents/child-agent.ts +11 -7
  260. package/src/shared/application/agents/messages.ts +35 -0
  261. package/src/shared/application/agents/route-agent.ts +115 -0
  262. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  263. package/src/shared/application/compaction/compact-session.ts +19 -14
  264. package/src/shared/application/compaction/messages.ts +20 -0
  265. package/src/shared/application/compaction/prune-context.ts +94 -0
  266. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  267. package/src/shared/application/dev/brief-inventory.ts +6 -4
  268. package/src/shared/application/dev/close-batch.ts +9 -7
  269. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  270. package/src/shared/application/dev/learn-decision.ts +20 -18
  271. package/src/shared/application/dev/load-dev-context.ts +7 -8
  272. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  273. package/src/shared/application/dev/messages.ts +135 -0
  274. package/src/shared/application/dev/phase-timer.ts +54 -0
  275. package/src/shared/application/dev/plan-source.ts +12 -8
  276. package/src/shared/application/dev/preflight.ts +16 -11
  277. package/src/shared/application/dev/prompts.ts +34 -0
  278. package/src/shared/application/dev/question-round.ts +25 -17
  279. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  280. package/src/shared/application/dev/settle-questions.ts +4 -2
  281. package/src/shared/application/dev/source-review.ts +12 -8
  282. package/src/shared/application/dev/source-step.ts +12 -10
  283. package/src/shared/application/dev/spend.ts +17 -4
  284. package/src/shared/application/dev/step-precedents.ts +2 -1
  285. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  286. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  287. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  288. package/src/shared/application/dev/verdict-sources.ts +5 -3
  289. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  290. package/src/shared/application/extra-tools.ts +2 -1
  291. package/src/shared/application/git/batch-worktree.ts +22 -17
  292. package/src/shared/application/git/commit-files.ts +24 -19
  293. package/src/shared/application/git/merge-batch.ts +11 -7
  294. package/src/shared/application/git/messages.ts +75 -0
  295. package/src/shared/application/git/open-pull-request.ts +4 -3
  296. package/src/shared/application/host-context.ts +59 -0
  297. package/src/shared/application/host-layout-store.ts +45 -0
  298. package/src/shared/application/llm-profile.ts +4 -3
  299. package/src/shared/application/messages.ts +14 -0
  300. package/src/shared/application/permission-rules.ts +10 -0
  301. package/src/shared/application/ports/decision.ts +14 -0
  302. package/src/shared/application/ports/human.ts +25 -0
  303. package/src/shared/application/ports/llm.ts +32 -3
  304. package/src/shared/application/ports/memory.ts +1 -1
  305. package/src/shared/application/ports/theme.ts +11 -0
  306. package/src/shared/application/ports.ts +4 -2
  307. package/src/shared/application/session-io.ts +2 -1
  308. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  309. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  310. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  311. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  312. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  313. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  314. package/src/shared/application/shared-memory/messages.ts +63 -0
  315. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  316. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  317. package/src/shared/application/skills/messages.ts +4 -0
  318. package/src/shared/application/skills/suggest-skills.ts +102 -0
  319. package/src/shared/application/workflow/messages.ts +8 -0
  320. package/src/shared/application/workflow/workflow-state.ts +7 -6
  321. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  322. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  323. package/src/shared/domain/agent-policy/messages.ts +66 -0
  324. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  325. package/src/shared/domain/agent-policy/permission.ts +20 -18
  326. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  327. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  328. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  329. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  330. package/src/shared/domain/agent-registry.ts +6 -5
  331. package/src/shared/domain/agents/chain.ts +2 -2
  332. package/src/shared/domain/agents/charter.ts +8 -5
  333. package/src/shared/domain/agents/exclusive.ts +2 -1
  334. package/src/shared/domain/agents/instances.ts +18 -15
  335. package/src/shared/domain/agents/messages.ts +39 -0
  336. package/src/shared/domain/agents/model-route.ts +199 -0
  337. package/src/shared/domain/agents/prompts.ts +20 -0
  338. package/src/shared/domain/code-intel-contract.ts +5 -4
  339. package/src/shared/domain/code-intel-routing.ts +8 -61
  340. package/src/shared/domain/compact-outcome.ts +5 -3
  341. package/src/shared/domain/compaction-thresholds.ts +2 -1
  342. package/src/shared/domain/compaction.ts +22 -113
  343. package/src/shared/domain/config-schema.ts +94 -81
  344. package/src/shared/domain/context-prune.ts +176 -0
  345. package/src/shared/domain/decision/questions.ts +102 -0
  346. package/src/shared/domain/dev/access-cost.ts +19 -15
  347. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  348. package/src/shared/domain/dev/build-commands.ts +5 -4
  349. package/src/shared/domain/dev/call-guard.ts +29 -28
  350. package/src/shared/domain/dev/carried-text.ts +3 -5
  351. package/src/shared/domain/dev/learn-proposals.ts +51 -12
  352. package/src/shared/domain/dev/learn-state.ts +3 -2
  353. package/src/shared/domain/dev/markers.ts +127 -0
  354. package/src/shared/domain/dev/messages.ts +271 -0
  355. package/src/shared/domain/dev/phase-timing.ts +50 -0
  356. package/src/shared/domain/dev/plan-checks.ts +24 -23
  357. package/src/shared/domain/dev/plan-format.ts +15 -25
  358. package/src/shared/domain/dev/project-files.ts +1 -15
  359. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  360. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  361. package/src/shared/domain/dev/questions.ts +33 -15
  362. package/src/shared/domain/dev/repo-pack.ts +12 -9
  363. package/src/shared/domain/dev/review-answer.ts +40 -17
  364. package/src/shared/domain/dev/review-brief.ts +54 -0
  365. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  366. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  367. package/src/shared/domain/dev/spec-format.ts +13 -14
  368. package/src/shared/domain/dev/step-budget.ts +4 -2
  369. package/src/shared/domain/dev/step-rules.ts +3 -4
  370. package/src/shared/domain/dev/test-commands.ts +14 -10
  371. package/src/shared/domain/dev/tool-guards.ts +4 -3
  372. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  373. package/src/shared/domain/dev/verdict-format.ts +14 -21
  374. package/src/shared/domain/dev/whitespace.ts +3 -2
  375. package/src/shared/domain/dev/work-folder.ts +6 -4
  376. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  377. package/src/shared/domain/error-text.ts +13 -0
  378. package/src/shared/domain/git/close.ts +14 -11
  379. package/src/shared/domain/git/messages.ts +41 -0
  380. package/src/shared/domain/git/pull-request.ts +5 -5
  381. package/src/shared/domain/host-layout.ts +147 -0
  382. package/src/shared/domain/host-paths.ts +399 -0
  383. package/src/shared/domain/llm-failure.ts +35 -7
  384. package/src/shared/domain/llm-profile.ts +22 -3
  385. package/src/shared/domain/marked-message.ts +1 -5
  386. package/src/shared/domain/markers.ts +30 -0
  387. package/src/shared/domain/messages.ts +291 -0
  388. package/src/shared/domain/model-catalog.ts +2 -9
  389. package/src/shared/domain/permission-modes.ts +4 -8
  390. package/src/shared/domain/prelude.ts +2 -2
  391. package/src/shared/domain/project-manifests.ts +3 -2
  392. package/src/shared/domain/prompts.ts +233 -0
  393. package/src/shared/domain/search-routing.ts +3 -11
  394. package/src/shared/domain/secret-patterns.ts +3 -2
  395. package/src/shared/domain/session-keys.ts +7 -0
  396. package/src/shared/domain/session-start.ts +3 -2
  397. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  398. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  399. package/src/shared/domain/shared-memory/entry.ts +26 -20
  400. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  401. package/src/shared/domain/shared-memory/gate.ts +4 -3
  402. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  403. package/src/shared/domain/shared-memory/layout.ts +11 -8
  404. package/src/shared/domain/shared-memory/markers.ts +9 -0
  405. package/src/shared/domain/shared-memory/messages.ts +66 -0
  406. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  407. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  408. package/src/shared/domain/shared-memory/refused.ts +3 -3
  409. package/src/shared/domain/skills/prompts.ts +4 -0
  410. package/src/shared/domain/skills/shortlist.ts +149 -0
  411. package/src/shared/domain/snip-turns.ts +2 -14
  412. package/src/shared/domain/speech.ts +2 -1
  413. package/src/shared/domain/tool-trace.ts +5 -7
  414. package/src/shared/domain/verifiers.ts +7 -11
  415. package/src/shared/domain/vfs.ts +8 -1
  416. package/src/shared/domain/workflow/prompts.ts +15 -0
  417. package/src/shared/domain/workflow/state-file.ts +14 -12
  418. package/src/shared/infrastructure/globals.ts +7 -2
  419. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  420. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  421. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  422. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  423. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  424. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  425. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  426. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  427. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  428. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  429. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  430. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  431. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  432. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  433. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  434. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  435. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  436. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  437. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  438. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  439. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  440. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  441. package/src/crews/dev-learn/application/learn-prompt.ts +0 -140
  442. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  443. package/src/shared/domain/session-summary.ts +0 -13
@@ -20,6 +20,9 @@ import type { CrewCompletion, LaunchResult } from "../dispatch.ts";
20
20
  import { storedEffort } from "../effort.ts";
21
21
  import { readPullRequestContext } from "../pr-context.ts";
22
22
  import type { PullRequestContext } from "../pr-context.ts";
23
+ import { VALID_LINE, WRITTEN_LINE } from "./markers.ts";
24
+ import { CLOSE_COMMITS, CONTEXT_NOT_READ_LINE, WRITES_COMMITS_PUSHES, batchChainFailed, closeFollows, couldNotBeLaunched, thenType } from "./messages.ts";
25
+ import { failedLine } from "../messages.ts";
23
26
 
24
27
  /** One batch of a plan, as `/dev-batches <code> F<n> [--close [--pr]] [— correction: <finding>]` reads it
25
28
  * (dev-batches.ts parseDevBatchesArgs): the batch, its plan (a code or a `<path>/<CODE>-PLAN.md`, null to find it). */
@@ -28,9 +31,6 @@ export interface DevImplementArgs { batch: string; plan: string | null; close: b
28
31
  export interface ChainLaunch { crew: string; input: Record<string, unknown>; instead: string }
29
32
  export interface ChainStep { lines: string[]; launch?: ChainLaunch }
30
33
 
31
- const VALID_LINE = /^→ Batch (F\d+) VALID\./m;
32
- const WRITTEN_LINE = /^written: (\S+)\/([A-Za-z0-9][A-Za-z0-9._-]*)-VERIFY-(F\d+)\.md\b/m;
33
-
34
34
  /** What `completed` prints and launches for one answer of the chain. */
35
35
  export function chainStep(payload: string): ChainStep {
36
36
  let parsed: unknown = null;
@@ -59,7 +59,7 @@ export function chainStep(payload: string): ChainStep {
59
59
  if (valid === null || written === null || valid[1] !== written[3]) return { lines };
60
60
  const plan = `${written[1]}/${written[2]}-PLAN.md`;
61
61
  return {
62
- lines: [...lines, `→ the close follows: ${closeCommand(plan, valid[1])}`],
62
+ lines: [...lines, closeFollows(closeCommand(plan, valid[1]))],
63
63
  launch: { crew: "dev-implement", input: { batch: valid[1], plan, close: true }, instead: closeCommand(plan, valid[1]) },
64
64
  };
65
65
  }
@@ -82,7 +82,7 @@ export type DevImplementDispatch =
82
82
  /** One batch's dispatch, from its parsed arguments: the refusal, written, or the crew's input and the launch's details. */
83
83
  export async function runDevImplementDispatch(args: DevImplementArgs, deps: DevImplementDispatchDeps): Promise<DevImplementDispatch> {
84
84
  const prContext = await readPullRequestContext({ catalogue: deps.catalogue, rules: deps.gate, session: deps.session });
85
- const line = writeModeRefusal(String(prContext.permissionMode ?? ""), "dev-batches", "writes files, commits and pushes");
85
+ const line = writeModeRefusal(String(prContext.permissionMode ?? ""), "dev-batches", WRITES_COMMITS_PUSHES);
86
86
  if (line !== null) {
87
87
  deps.write(line);
88
88
  return { refused: line };
@@ -117,11 +117,8 @@ export interface ChainHopDeps {
117
117
  context: () => Promise<PullRequestContext>;
118
118
  }
119
119
 
120
- /** The line a hop prints when the session's context could not be read again: the crew reads its record. */
121
- export const CONTEXT_NOT_READ_LINE = "⚠ the session's mode could not be read again: the context read at the launch applies";
122
-
123
120
  /** What the close writes, for the refusal of a read-only mode. */
124
- const CLOSE_WRITES = { step: "dev-batches", what: "commits (the close of the batch)" };
121
+ const CLOSE_WRITES = { step: "dev-batches", what: CLOSE_COMMITS };
125
122
 
126
123
  /** The session's context now, or null when it cannot be read (a throw, an empty mode). */
127
124
  export async function freshContext(read: () => Promise<PullRequestContext>): Promise<PullRequestContext | null> {
@@ -152,7 +149,7 @@ export async function writingHop(
152
149
  const context = await freshContext(read);
153
150
  if (context === null) return { lines: [CONTEXT_NOT_READ_LINE], launch };
154
151
  const refusal = writeModeRefusal(context.permissionMode, writes.step, writes.what);
155
- if (refusal !== null) return { lines: [refusal, `then type ${launch.instead}`] };
152
+ if (refusal !== null) return { lines: [refusal, thenType(launch.instead)] };
156
153
  return { lines: [], launch: { ...launch, input: withContext(launch.input, context) } };
157
154
  }
158
155
 
@@ -162,11 +159,11 @@ export async function writingHop(
162
159
  * the close then reads the session's context again (writingHop); the audit is launched as the crew named it.
163
160
  */
164
161
  export async function nextLaunch(result: CrewCompletion, deps: ChainHopDeps): Promise<ChainStep> {
165
- if (!result.success) return { lines: [`✗ the batch's chain failed: ${result.error ?? "unknown"}`] };
162
+ if (!result.success) return { lines: [batchChainFailed(result.error ?? "unknown")] };
166
163
  const step = chainStep(String(result.payload ?? ""));
167
164
  if (step.launch === undefined) return step;
168
165
  const refusal = deps.reapply(step.launch.crew === "dev-verify" ? "dev-verify" : "dev-implement");
169
- if (refusal !== null) return { lines: [...step.lines, `✗ ${refusal}`, `then type ${step.launch.instead}`] };
166
+ if (refusal !== null) return { lines: [...step.lines, failedLine(refusal), thenType(step.launch.instead)] };
170
167
  if (step.launch.crew !== "dev-implement") return step;
171
168
  const hop = await writingHop(step.launch, deps.context, CLOSE_WRITES);
172
169
  return hop.launch === undefined ? { lines: [...step.lines, ...hop.lines] } : { lines: [...step.lines, ...hop.lines], launch: hop.launch };
@@ -181,8 +178,8 @@ export function launchChained(
181
178
  ): string[] {
182
179
  try {
183
180
  const launched = run(launch.crew, launch.input, options);
184
- return "refused" in launched ? [`✗ ${launched.refused}`, `then type ${launch.instead}`] : [];
181
+ return "refused" in launched ? [failedLine(launched.refused), thenType(launch.instead)] : [];
185
182
  } catch (e) {
186
- return [`✗ ${launch.crew} could not be launched (${String((e as Error)?.message ?? e).split("\n")[0]}): type ${launch.instead}`];
183
+ return [couldNotBeLaunched(launch.crew, String((e as Error)?.message ?? e).split("\n")[0], launch.instead)];
187
184
  }
188
185
  }
@@ -6,9 +6,9 @@
6
6
  // revision of a brief (the crew checks it).
7
7
  import { commandLine, isOption, splitWords } from "../args.ts";
8
8
  import { isCode } from "../../../shared/domain/dev/artefacts.ts";
9
+ import { DEV_SPEC_USAGE, RUN_BEFORE_TEXT, RUN_NEEDS_COMMAND, RUN_NEEDS_KIND, notASpecCode, withUsage } from "./messages.ts";
10
+ import { unknownOption } from "../messages.ts";
9
11
 
10
- export const DEV_SPEC_USAGE =
11
- 'usage: /dev-spec <code> [bug | refactor | perf] [--run "<command>"] [<brief text> | <path>.md | <#issue> | <revision request>]';
12
12
  export interface DevSpecArgs { code: string; request: string }
13
13
  export interface DevChangeArgs { code: string; kind: string; run: string; text: string }
14
14
  /** The crew the line runs, with its input: a spec without a kind, a change brief with one. */
@@ -22,13 +22,9 @@ const KINDS = new Set(["bug", "refactor", "perf"]);
22
22
  /** The alias that keeps /dev-change's own shape. */
23
23
  export const DEV_CHANGE_ALIAS = "dev-change";
24
24
 
25
- /** Why --run needs a kind, said where it is refused. */
26
- export const RUN_NEEDS_KIND =
27
- "--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";
28
-
29
25
  function codeOf(word: string | undefined): { ok: true; code: string } | { ok: false; text: string } {
30
26
  if (word === undefined || word.trim() === "") return { ok: false, text: DEV_SPEC_USAGE };
31
- if (word.length > MAX_CODE || !isCode(word)) return { ok: false, text: `'${word}' is not a code (letters, digits, '.', '_', '-')\n${DEV_SPEC_USAGE}` };
27
+ if (word.length > MAX_CODE || !isCode(word)) return { ok: false, text: withUsage(notASpecCode(word), DEV_SPEC_USAGE) };
32
28
  return { ok: true, code: word };
33
29
  }
34
30
 
@@ -47,18 +43,18 @@ export function parseDevSpecArgs(tokens: readonly string[], typed = "dev-spec"):
47
43
  if (words[at] !== undefined && !words[at].quoted && KINDS.has(words[at].text)) { kind = words[at].text; at++; }
48
44
  let run = "";
49
45
  if (isOption(words[at])) {
50
- if (words[at].text !== "--run") return { ok: false, text: `unknown option ${words[at].text}\n${DEV_SPEC_USAGE}` };
46
+ if (words[at].text !== "--run") return { ok: false, text: withUsage(unknownOption(words[at].text), DEV_SPEC_USAGE) };
51
47
  const value = words[at + 1];
52
- if (value === undefined || isOption(value) || value.text.trim() === "") return { ok: false, text: `--run needs the command, quoted\n${DEV_SPEC_USAGE}` };
48
+ if (value === undefined || isOption(value) || value.text.trim() === "") return { ok: false, text: withUsage(RUN_NEEDS_COMMAND, DEV_SPEC_USAGE) };
53
49
  run = value.text.trim();
54
50
  at += 2;
55
51
  }
56
52
  if (words.slice(at).some((w) => !w.quoted && w.text === "--run")) {
57
- return { ok: false, text: `--run comes before the text\n${DEV_SPEC_USAGE}` };
53
+ return { ok: false, text: withUsage(RUN_BEFORE_TEXT, DEV_SPEC_USAGE) };
58
54
  }
59
55
  const text = words.length === at + 1 && words[at].quoted ? words[at].text : restOf(line, words, at);
60
56
  if (kind === "" && typed !== DEV_CHANGE_ALIAS) {
61
- if (run !== "") return { ok: false, text: `${RUN_NEEDS_KIND}\n${DEV_SPEC_USAGE}` };
57
+ if (run !== "") return { ok: false, text: withUsage(RUN_NEEDS_KIND, DEV_SPEC_USAGE) };
62
58
  return { ok: true, crew: "dev-spec", args: { code: code.code, request: text } };
63
59
  }
64
60
  return { ok: true, crew: "dev-change", args: { code: code.code, kind, run, text } };
@@ -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
  }