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
@@ -5,6 +5,9 @@
5
5
 
6
6
  import type { Logger, Shell } from "../../../shared/application/ports.ts";
7
7
  import type { CommandView } from "../view.ts";
8
+ import {
9
+ andMore, branchRefusedLog, checkoutFailed, dirtyTreeRefusal, exitCode, looksLikeOption, notABranchName, switchedTo,
10
+ } from "./messages.ts";
8
11
 
9
12
  /** True when `git status --porcelain` reported at least one changed path. */
10
13
  export function hasUncommittedChanges(porcelain: unknown): boolean {
@@ -34,12 +37,12 @@ export function planBranch(tokens: readonly string[]): BranchPlan {
34
37
  const name = String((tokens ?? [])[0] ?? "").trim();
35
38
  if (name.length === 0) return { action: "show" };
36
39
  if (name.startsWith("-")) {
37
- return { action: "refuse", reason: `'${name}' looks like an option, not a branch name` };
40
+ return { action: "refuse", reason: looksLikeOption(name) };
38
41
  }
39
42
  if (!SAFE_BRANCH.test(name)) {
40
43
  return {
41
44
  action: "refuse",
42
- reason: `'${name}' is not a plausible branch name (letters, digits, '.', '_', '/', '-')`,
45
+ reason: notABranchName(name),
43
46
  };
44
47
  }
45
48
  return { action: "checkout", branch: name };
@@ -55,11 +58,7 @@ export function planBranch(tokens: readonly string[]): BranchPlan {
55
58
  export function describeDirtyTreeRefusal(branch: string, porcelain: string): string {
56
59
  const changed = porcelain.split("\n").filter((l) => l.trim().length > 0);
57
60
  const shown = changed.slice(0, 5).map((l) => ` ${l.trim()}`).join("\n");
58
- return (
59
- `refusing to check out '${branch}': ${changed.length} uncommitted change(s) in the working tree.\n` +
60
- `${shown}${changed.length > 5 ? `\n … and ${changed.length - 5} more` : ""}\n` +
61
- "Commit them (/commit) or stash them first — a checkout would either fail or carry them across."
62
- );
61
+ return dirtyTreeRefusal(branch, changed.length, shown, changed.length > 5 ? andMore(changed.length - 5) : "");
63
62
  }
64
63
 
65
64
  export interface BranchDeps {
@@ -83,13 +82,13 @@ export async function runBranch(tokens: readonly string[], deps: BranchDeps): Pr
83
82
  const status = await shell.run("git status --porcelain");
84
83
  const porcelain = status.stdout;
85
84
  if (status.exitCode === 0 && hasUncommittedChanges(porcelain)) {
86
- deps.log.warn(`/branch refused: uncommitted changes block the checkout of '${plan.branch}'`);
85
+ deps.log.warn(branchRefusedLog(plan.branch));
87
86
  return { text: describeDirtyTreeRefusal(plan.branch, porcelain) };
88
87
  }
89
88
 
90
89
  const r = await shell.run(`git checkout ${plan.branch}`);
91
90
  if (r.exitCode !== 0) {
92
- return { text: `checkout failed: ${r.stderr.trim() || r.stdout.trim() || `exit code ${r.exitCode}`}` };
91
+ return { text: checkoutFailed(r.stderr.trim() || r.stdout.trim() || exitCode(r.exitCode)) };
93
92
  }
94
- return { text: r.stderr.trim() || r.stdout.trim() || `switched to '${plan.branch}'` };
93
+ return { text: r.stderr.trim() || r.stdout.trim() || switchedTo(plan.branch) };
95
94
  }
@@ -9,6 +9,9 @@ import { buildCommitPlan, isCommitPermitted, parseCommitArgs } from "../../../cr
9
9
  import { commandLine, splitWords } from "../args.ts";
10
10
  import { readPullRequestContext } from "../pr-context.ts";
11
11
  import type { PullRequestContext, PullRequestContextPorts } from "../pr-context.ts";
12
+ import { COMMIT_CANCELLED, NO_ANSWER_REFUSAL, cannotPromptRefusal, commitApproved } from "./messages.ts";
13
+ import { refusedLine } from "../../../shared/application/git/messages.ts";
14
+ import { failedLine } from "../messages.ts";
12
15
 
13
16
  export interface CommitCommandDeps {
14
17
  session: Pick<SessionIo, "resolveEffectiveSessionMode">;
@@ -35,20 +38,13 @@ async function confirmOrRefuse(deps: Pick<CommitCommandDeps, "confirm" | "write"
35
38
  try {
36
39
  answer = await deps.confirm(question);
37
40
  } catch (e: any) {
38
- return (
39
- "refused: /commit needs a confirmation and this session cannot prompt " +
40
- `(${String(e?.message ?? e)}). Re-run as '/commit --yes' if you intend to stage ` +
41
- "and commit the changed files unattended."
42
- );
41
+ return cannotPromptRefusal(String(e?.message ?? e));
43
42
  }
44
43
  if (answer === true) return null;
45
44
  if (typeof answer !== "boolean") {
46
- return (
47
- "refused: the confirmation prompt returned no answer (non-interactive session). " +
48
- "Re-run as '/commit --yes' to stage and commit the changed files unattended."
49
- );
45
+ return NO_ANSWER_REFUSAL;
50
46
  }
51
- return "cancelled — nothing was staged and nothing was committed.";
47
+ return COMMIT_CANCELLED;
52
48
  }
53
49
 
54
50
  /** `/commit [--yes] [--push] [--pr] [--note <text>] [<path>…]`, from the command's raw tokens: the refusal, written,
@@ -65,7 +61,7 @@ export async function runCommitCommand(tokens: readonly string[], deps: CommitCo
65
61
 
66
62
  const permitted = isCommitPermitted(mode);
67
63
  if (!permitted.allowed) {
68
- deps.write(`✗ refused: ${permitted.reason}`);
64
+ deps.write(refusedLine(permitted.reason));
69
65
  return { refused: permitted.reason };
70
66
  }
71
67
 
@@ -73,12 +69,12 @@ export async function runCommitCommand(tokens: readonly string[], deps: CommitCo
73
69
  const plan = buildCommitPlan({ push, pr, paths });
74
70
  const refusal = await confirmOrRefuse(deps, plan.notice, plan.question);
75
71
  if (refusal !== null) {
76
- deps.write(`✗ ${refusal}`);
72
+ deps.write(failedLine(refusal));
77
73
  return { refused: refusal };
78
74
  }
79
75
  }
80
76
 
81
- deps.log.info(`commit approved — permission mode '${mode}' (${via})`);
77
+ deps.log.info(commitApproved(mode, via));
82
78
  const context: PullRequestContext | null = pr || push ? await readPullRequestContext(deps.pr) : null;
83
79
  // A yes to a plan that named the pull request is the question the github call needs; --yes asked nothing.
84
80
  return {
@@ -5,11 +5,17 @@
5
5
 
6
6
  import type { Logger, Shell } from "../../../shared/application/ports.ts";
7
7
  import type { CommandView } from "../view.ts";
8
+ import {
9
+ NOT_A_PATHSPEC, STAGED_CHANGES, WORKING_TREE_CHANGES, argumentsIgnored, diffFailed, diffIgnored, exitCode, noChanges,
10
+ notAnAllowedDiffOption, scopeLine,
11
+ } from "./messages.ts";
8
12
 
9
13
  export interface DiffPlan {
10
14
  /** The git argument string, already assembled. */
11
15
  args: string;
12
16
  staged: boolean;
17
+ /** Whether git answers with a unified diff, which the console can colour, rather than a summary. */
18
+ unified: boolean;
13
19
  /** Tokens that were dropped, with the reason — never silently ignored. */
14
20
  rejected: Array<{ value: string; reason: string }>;
15
21
  }
@@ -29,6 +35,9 @@ export const ALLOWED_DIFF_FLAGS = [
29
35
  "--numstat", "--shortstat", "-p", "--unified", "--word-diff",
30
36
  ];
31
37
 
38
+ /** The allowed options under which git answers with something other than a unified diff. */
39
+ const NOT_UNIFIED_FLAGS = ["--stat", "--name-only", "--name-status", "--numstat", "--shortstat", "--word-diff"];
40
+
32
41
  /** A pathspec: no leading dash, no shell metacharacter, no parent traversal. */
33
42
  const SAFE_PATHSPEC = /^[A-Za-z0-9._/\-*]+$/;
34
43
 
@@ -45,12 +54,12 @@ export function planDiff(tokens: readonly string[]): DiffPlan {
45
54
  // `--unified=3` and `-U3` carry a value; compare on the option part.
46
55
  const head = token.split("=")[0];
47
56
  if (ALLOWED_DIFF_FLAGS.includes(head)) flags.push(token);
48
- else rejected.push({ value: token, reason: `not an allowed diff option (allowed: ${ALLOWED_DIFF_FLAGS.join(" ")})` });
57
+ else rejected.push({ value: token, reason: notAnAllowedDiffOption(ALLOWED_DIFF_FLAGS.join(" ")) });
49
58
  continue;
50
59
  }
51
60
 
52
61
  if (!SAFE_PATHSPEC.test(token) || token.includes("..")) {
53
- rejected.push({ value: token, reason: "not a plausible pathspec (letters, digits, '.', '_', '/', '-', '*'; no '..')" });
62
+ rejected.push({ value: token, reason: NOT_A_PATHSPEC });
54
63
  continue;
55
64
  }
56
65
  paths.push(token);
@@ -59,14 +68,12 @@ export function planDiff(tokens: readonly string[]): DiffPlan {
59
68
  const staged = flags.some((f) => f === "--staged" || f === "--cached");
60
69
  // `--` separates options from pathspecs, so a path that looks like a ref stays a path.
61
70
  const args = [...flags, ...(paths.length > 0 ? ["--", ...paths] : [])].join(" ");
62
- return { args, staged, rejected };
71
+ const unified = !flags.some((f) => NOT_UNIFIED_FLAGS.includes(f.split("=")[0]));
72
+ return { args, staged, unified, rejected };
63
73
  }
64
74
 
65
- /** Baseline wording for an empty diff — a distinct sentence, not "(no output)". */
66
- export const NO_CHANGES_MESSAGE = "No changes to show.";
67
-
68
75
  export function describeDiffScope(plan: DiffPlan): string {
69
- return plan.staged ? "staged changes" : "working-tree changes since the last commit";
76
+ return plan.staged ? STAGED_CHANGES : WORKING_TREE_CHANGES;
70
77
  }
71
78
 
72
79
  export interface DiffDeps {
@@ -78,20 +85,23 @@ export interface DiffDeps {
78
85
  * each ignored token logged and counted in the closing message. */
79
86
  export async function runDiff(tokens: readonly string[], deps: DiffDeps): Promise<CommandView> {
80
87
  const plan = planDiff(tokens);
81
- for (const r of plan.rejected) deps.log.warn(`/diff ignored '${r.value}' — ${r.reason}`);
88
+ for (const r of plan.rejected) deps.log.warn(diffIgnored(r.value, r.reason));
82
89
 
83
90
  const r = await deps.shell.run(`git diff ${plan.args}`.trim());
84
91
  if (r.exitCode !== 0) {
85
92
  const err = r.stderr.trim();
86
- return { text: `git diff failed: ${err || `exit code ${r.exitCode}`}` };
93
+ return { text: diffFailed(err || exitCode(r.exitCode)) };
87
94
  }
88
95
 
89
96
  const out = r.stdout;
90
97
  if (out.trim().length === 0) {
91
- return { text: `${NO_CHANGES_MESSAGE} (${describeDiffScope(plan)})` };
98
+ return { text: noChanges(describeDiffScope(plan)) };
92
99
  }
100
+ const scope = scopeLine(describeDiffScope(plan));
101
+ // A merge conflict's combined diff (`@@@`, two columns of signs) is not the unified form the block numbers.
102
+ const unified = plan.unified && !/^@@@ /m.test(out);
93
103
  return {
94
- lines: [`── ${describeDiffScope(plan)}`, out],
95
- ...(plan.rejected.length > 0 ? { text: `${plan.rejected.length} argument(s) ignored — see the log.` } : {}),
104
+ ...(unified ? { lines: [scope], diff: out } : { lines: [scope, out] }),
105
+ ...(plan.rejected.length > 0 ? { text: argumentsIgnored(plan.rejected.length) } : {}),
96
106
  };
97
107
  }
@@ -0,0 +1,54 @@
1
+ // The text /branch, /commit, /diff, /review and /passes show the user (ADR 0026): their refusals and their answers.
2
+ // Read by branch.ts, commit.ts, diff.ts and review.ts.
3
+
4
+ // /branch
5
+ export const looksLikeOption = (name: string) => `'${name}' looks like an option, not a branch name`;
6
+ export const notABranchName = (name: string) =>
7
+ `'${name}' is not a plausible branch name (letters, digits, '.', '_', '/', '-')`;
8
+ export const dirtyTreeRefusal = (branch: string, count: number, shown: string, more: string) =>
9
+ `refusing to check out '${branch}': ${count} uncommitted change(s) in the working tree.\n` +
10
+ `${shown}${more}\n` +
11
+ "Commit them (/commit) or stash them first — a checkout would either fail or carry them across.";
12
+ export const andMore = (count: number) => `\n … and ${count} more`;
13
+ export const branchRefusedLog = (branch: string) =>
14
+ `/branch refused: uncommitted changes block the checkout of '${branch}'`;
15
+ export const checkoutFailed = (reason: string) => `checkout failed: ${reason}`;
16
+ export const switchedTo = (branch: string) => `switched to '${branch}'`;
17
+ export const exitCode = (code: number) => `exit code ${code}`;
18
+
19
+ // /commit
20
+ export const cannotPromptRefusal = (reason: string) =>
21
+ "refused: /commit needs a confirmation and this session cannot prompt " +
22
+ `(${reason}). Re-run as '/commit --yes' if you intend to stage ` +
23
+ "and commit the changed files unattended.";
24
+ export const NO_ANSWER_REFUSAL =
25
+ "refused: the confirmation prompt returned no answer (non-interactive session). " +
26
+ "Re-run as '/commit --yes' to stage and commit the changed files unattended.";
27
+ export const COMMIT_CANCELLED = "cancelled — nothing was staged and nothing was committed.";
28
+ export const commitApproved = (mode: string, via: string) => `commit approved — permission mode '${mode}' (${via})`;
29
+
30
+ // /diff
31
+ /** Baseline wording for an empty diff — a distinct sentence, not "(no output)". */
32
+ export const NO_CHANGES_MESSAGE = "No changes to show.";
33
+ export const notAnAllowedDiffOption = (allowed: string) => `not an allowed diff option (allowed: ${allowed})`;
34
+ export const NOT_A_PATHSPEC = "not a plausible pathspec (letters, digits, '.', '_', '/', '-', '*'; no '..')";
35
+ export const STAGED_CHANGES = "staged changes";
36
+ export const WORKING_TREE_CHANGES = "working-tree changes since the last commit";
37
+ export const diffIgnored = (value: string, reason: string) => `/diff ignored '${value}' — ${reason}`;
38
+ export const diffFailed = (reason: string) => `git diff failed: ${reason}`;
39
+ export const noChanges = (scope: string) => `${NO_CHANGES_MESSAGE} (${scope})`;
40
+ export const scopeLine = (scope: string) => `── ${scope}`;
41
+ export const argumentsIgnored = (count: number) => `${count} argument(s) ignored — see the log.`;
42
+
43
+ // /review and /passes
44
+ export const invalidPassCount = (token: string, min: number, max: number) =>
45
+ `invalid pass count '${token}' — expected an integer between ${min} and ${max}.`;
46
+ export const reviewUnknownOption = (token: string) =>
47
+ `review: unknown option '${token}' (--files, --commit, --lens, --passes)`;
48
+ export const reviewTakesValue = (name: string) => `review: ${name} takes a value`;
49
+ export const reviewLensTakes = (lenses: string, lens: string) => `review: --lens takes ${lenses}, not '${lens}'`;
50
+ export const passesShown = (current: string, min: number, max: number) =>
51
+ `reasoning passes: ${current}\n/review runs that many lens rounds.\n` +
52
+ `usage: /passes <${min}-${max}> (this session) or /review --passes <${min}-${max}> (one run)`;
53
+ export const passesSet = (n: number, calls: number) =>
54
+ `reasoning passes set to ${n} — /review will make ${calls} lens calls per run (session-scoped; /clear clears it).`;
@@ -10,6 +10,8 @@ import { MAX_PASSES, MIN_PASSES } from "../../../shared/domain/agent-policy/beha
10
10
  import { PASSES_STATE_KEY } from "../../../shared/domain/session-keys.ts";
11
11
  import { commandLine, splitWords } from "../args.ts";
12
12
  import type { CommandView } from "../view.ts";
13
+ import { invalidPassCount, passesSet, passesShown, reviewLensTakes, reviewTakesValue, reviewUnknownOption } from "./messages.ts";
14
+ import { markedDefault as defaultPasses } from "../messages.ts";
13
15
 
14
16
  export const REVIEW_LENSES: readonly string[] = ["correctness", "security", "style"];
15
17
 
@@ -32,7 +34,7 @@ export type ReviewRoute =
32
34
 
33
35
  /** The refusal of a pass count that is not an integer from 1 to 5. */
34
36
  export function invalidPassesText(token: string): string {
35
- return `invalid pass count '${token}' — expected an integer between ${MIN_PASSES} and ${MAX_PASSES}.`;
37
+ return invalidPassCount(token, MIN_PASSES, MAX_PASSES);
36
38
  }
37
39
 
38
40
  /** A pass count from 1 to 5, or null. */
@@ -69,10 +71,10 @@ export function parseReviewArgs(raw: readonly string[], typed: string): ReviewRo
69
71
  continue;
70
72
  }
71
73
  if (name !== "--commit" && name !== "--lens" && name !== "--passes") {
72
- return { route: "refused", text: `review: unknown option '${token}' (--files, --commit, --lens, --passes)` };
74
+ return { route: "refused", text: reviewUnknownOption(token) };
73
75
  }
74
76
  const value = inline ?? (i + 1 < tokens.length && !tokens[i + 1].startsWith("--") ? tokens[++i] : "");
75
- if (value === "") return { route: "refused", text: `review: ${name} takes a value` };
77
+ if (value === "") return { route: "refused", text: reviewTakesValue(name) };
76
78
  if (name === "--commit") commit = value;
77
79
  else if (name === "--lens") lens = value;
78
80
  else {
@@ -83,7 +85,7 @@ export function parseReviewArgs(raw: readonly string[], typed: string): ReviewRo
83
85
  }
84
86
  if (typed === "security-review") lens = "security";
85
87
  else if (lens !== "" && !REVIEW_LENSES.includes(lens)) {
86
- return { route: "refused", text: `review: --lens takes ${REVIEW_LENSES.join(", ")}, not '${lens}'` };
88
+ return { route: "refused", text: reviewLensTakes(REVIEW_LENSES.join(", "), lens) };
87
89
  }
88
90
  return { route: "review", input: { files, commit, lenses: lens, ...(passes === undefined ? {} : { passes }) } };
89
91
  }
@@ -95,15 +97,12 @@ export interface PassesDeps {
95
97
  /** `/passes [n]`: the session's pass count shown, or set from 1 to 5 (session-scoped; /clear clears it). */
96
98
  export async function runPasses(token: string, deps: PassesDeps): Promise<CommandView> {
97
99
  if (token === "") {
98
- const current = (await deps.session.readState(PASSES_STATE_KEY).catch(() => null)) ?? `${MIN_PASSES} (default)`;
99
- return {
100
- text: `reasoning passes: ${current}\n/review runs that many lens rounds.\n` +
101
- `usage: /passes <${MIN_PASSES}-${MAX_PASSES}> (this session) or /review --passes <${MIN_PASSES}-${MAX_PASSES}> (one run)`,
102
- };
100
+ const current = (await deps.session.readState(PASSES_STATE_KEY).catch(() => null)) ?? defaultPasses(MIN_PASSES);
101
+ return { text: passesShown(current, MIN_PASSES, MAX_PASSES) };
103
102
  }
104
103
  const n = passCount(token);
105
104
  if (n === null) return { text: invalidPassesText(token) };
106
105
  await deps.session.writeState(PASSES_STATE_KEY, String(n));
107
106
  // n rounds × 3 lenses is n × 3 LLM calls: say so, the cost is the operator's.
108
- return { text: `reasoning passes set to ${n} — /review will make ${n * 3} lens calls per run (session-scoped; /clear clears it).` };
107
+ return { text: passesSet(n, n * 3) };
109
108
  }
@@ -17,6 +17,11 @@ import { admitEntries, admitReport } from "../../../shared/application/shared-me
17
17
  import { admissionProblem, asksConfirmation } from "../../../shared/domain/shared-memory/gate.ts";
18
18
  import { candidatesList } from "../../../shared/domain/shared-memory/candidates.ts";
19
19
  import { importAgentMemory, importReport } from "../../../shared/application/shared-memory/import-agent-memory.ts";
20
+ import {
21
+ ADMITTED_UNASKED, HEADLESS, IMPORT_TAKES_NOTHING, LEFT_AS_CANDIDATE, LIST_TAKES_NOTHING, NOTHING_ADMITTED,
22
+ NO_INGESTION_ON_REFUSAL, REFUSE_USAGE, admitQuestion, motifTooLong, noPendingCandidate, notACandidateId, notPending,
23
+ stoppedAt, unknownAdmitOption,
24
+ } from "./messages.ts";
20
25
 
21
26
  /** The crew that writes an admission, launched exclusively: the host refuses an admission while the previous one is
22
27
  * still being written, so two never write the shared memory side by side; the list, a refusal and the import launch
@@ -34,21 +39,21 @@ export type MemoryAdmitArgs =
34
39
 
35
40
  export function parseMemoryAdmitArgs(tokens: readonly string[]): { ok: true; args: MemoryAdmitArgs } | { ok: false; text: string } {
36
41
  if (tokens[0] === "--list") {
37
- return tokens.length === 1 ? { ok: true, args: { kind: "list" } } : { ok: false, text: "memory-admit: --list takes nothing else" };
42
+ return tokens.length === 1 ? { ok: true, args: { kind: "list" } } : { ok: false, text: LIST_TAKES_NOTHING };
38
43
  }
39
44
  if (tokens[0] === "--import") {
40
- return tokens.length === 1 ? { ok: true, args: { kind: "import" } } : { ok: false, text: "memory-admit: --import takes nothing else" };
45
+ return tokens.length === 1 ? { ok: true, args: { kind: "import" } } : { ok: false, text: IMPORT_TAKES_NOTHING };
41
46
  }
42
47
  if (tokens[0] === "--refuse") {
43
48
  const id = tokens[1];
44
- if (id === undefined || !ID.test(id)) return { ok: false, text: "memory-admit: --refuse <id> [<motif>]: the id of a pending candidate" };
49
+ if (id === undefined || !ID.test(id)) return { ok: false, text: REFUSE_USAGE };
45
50
  const motif = tokens.slice(2).join(" ").replace(/\s+/g, " ").trim();
46
- if (Array.from(motif).length > MAX_MOTIF_CHARS) return { ok: false, text: `memory-admit: a motif of at most ${MAX_MOTIF_CHARS} characters` };
51
+ if (Array.from(motif).length > MAX_MOTIF_CHARS) return { ok: false, text: motifTooLong(MAX_MOTIF_CHARS) };
47
52
  return { ok: true, args: motif === "" ? { kind: "refuse", id } : { kind: "refuse", id, motif } };
48
53
  }
49
54
  for (const tok of tokens) {
50
- if (tok.startsWith("--")) return { ok: false, text: `memory-admit: unknown option '${tok}' (--list, --refuse, --import)` };
51
- if (!ID.test(tok)) return { ok: false, text: `memory-admit: '${tok}' is not a candidate id` };
55
+ if (tok.startsWith("--")) return { ok: false, text: unknownAdmitOption(tok) };
56
+ if (!ID.test(tok)) return { ok: false, text: notACandidateId(tok) };
52
57
  }
53
58
  return { ok: true, args: { kind: "admit", ids: [...new Set(tokens)] } };
54
59
  }
@@ -84,18 +89,11 @@ function candidateNotice(c: StoredEntry): string {
84
89
  return [...lines, ...body.map((l) => ` | ${l}`)].join("\n");
85
90
  }
86
91
 
87
- const HEADLESS = "refused: /memory-admit asks before admitting and this session cannot prompt: no asked candidate was admitted. " +
88
- "Run it in an interactive session (an audited candidate admits unasked when memory.autoAdmitAudited is true).";
89
-
90
92
  /** No answer: the questions left are refused, the admissions already made - unasked or confirmed - still go. */
91
93
  function headless(admit: Confirmed[], settings: MemorySettings, why: string): MemoryAdmitResult {
92
94
  return admit.length === 0 ? { refused: why } : { admit, settings, refusedQuestions: why };
93
95
  }
94
96
 
95
- /** A question cancelled after another was answered: the session can prompt, the person stopped. */
96
- const stoppedAt = (id: string): string =>
97
- `refused: the question about ${id} got no answer: it and the candidates after it stay candidates. Run /memory-admit again for them.`;
98
-
99
97
  export async function runMemoryAdmit(args: MemoryAdmitArgs, deps: MemoryAdmitDeps, io: MemoryAdmitIo): Promise<MemoryAdmitResult> {
100
98
  const settings = await readMemorySettings(deps);
101
99
  for (const warning of settings.warnings) io.writeLine(`warning: ${warning}`);
@@ -105,28 +103,28 @@ export async function runMemoryAdmit(args: MemoryAdmitArgs, deps: MemoryAdmitDep
105
103
  }
106
104
  const pending = await pendingCandidates(deps.files, settings.layout);
107
105
  if (args.kind === "list") {
108
- return { message: pending.length === 0 ? `No pending candidate in ${settings.layout.candidates}.` : candidatesList(pending.map((c) => c.entry)).trimEnd() };
106
+ return { message: pending.length === 0 ? noPendingCandidate(settings.layout.candidates) : candidatesList(pending.map((c) => c.entry)).trimEnd() };
109
107
  }
110
108
  if (args.kind === "refuse") {
111
- const outcome = await admitEntries({ ...deps, memory: { ingest: async () => { throw new Error("no ingestion on a refusal"); } } },
109
+ const outcome = await admitEntries({ ...deps, memory: { ingest: async () => { throw new Error(NO_INGESTION_ON_REFUSAL); } } },
112
110
  settings, { admit: [], refuse: [{ id: args.id, ...(args.motif === undefined ? {} : { motif: args.motif }) }] });
113
111
  return outcome.refused.length > 0 ? { message: admitReport(outcome) } : { refused: admitReport(outcome) };
114
112
  }
115
113
  const chosen: StoredEntry[] = [];
116
114
  for (const id of args.ids) {
117
115
  const hit = pending.find((c) => c.entry.id === id);
118
- if (hit === undefined) io.writeLine(`${id}: not a pending candidate (/memory-admit --list)`);
116
+ if (hit === undefined) io.writeLine(notPending(id));
119
117
  else chosen.push(hit);
120
118
  }
121
119
  const asked = args.ids.length === 0 ? pending : chosen;
122
- if (asked.length === 0) return { message: args.ids.length === 0 ? `No pending candidate in ${settings.layout.candidates}.` : "Nothing admitted." };
120
+ if (asked.length === 0) return { message: args.ids.length === 0 ? noPendingCandidate(settings.layout.candidates) : NOTHING_ADMITTED };
123
121
  const admit: Confirmed[] = [];
124
122
  const confirmed = (c: StoredEntry): Confirmed => ({ id: c.entry.id, sha1: sha1Hex(c.text) });
125
123
  // The admissions that need no question first: a session that cannot prompt still applies them.
126
124
  const unasked = asked.filter((c) => admissionProblem(c.entry) === undefined && !asksConfirmation(c.entry, settings.autoAdmitAudited));
127
125
  for (const c of unasked) {
128
126
  io.writeLine(candidateNotice(c));
129
- io.writeLine(" admitted without a question (audited, memory.autoAdmitAudited is true)");
127
+ io.writeLine(ADMITTED_UNASKED);
130
128
  admit.push(confirmed(c));
131
129
  }
132
130
  let answered = false;
@@ -136,7 +134,7 @@ export async function runMemoryAdmit(args: MemoryAdmitArgs, deps: MemoryAdmitDep
136
134
  if (problem !== undefined) { io.writeLine(` not admissible: ${problem}`); continue; }
137
135
  let answer: unknown;
138
136
  try {
139
- answer = await io.confirm(`Admit ${c.entry.id} into the shared memory?`);
137
+ answer = await io.confirm(admitQuestion(c.entry.id));
140
138
  } catch {
141
139
  answer = undefined;
142
140
  }
@@ -144,7 +142,7 @@ export async function runMemoryAdmit(args: MemoryAdmitArgs, deps: MemoryAdmitDep
144
142
  if (typeof answer !== "boolean") return headless(admit, settings, answered ? stoppedAt(c.entry.id) : HEADLESS);
145
143
  answered = true;
146
144
  if (answer) admit.push(confirmed(c));
147
- else io.writeLine(" left as a candidate");
145
+ else io.writeLine(LEFT_AS_CANDIDATE);
148
146
  }
149
- return admit.length === 0 ? { message: "Nothing admitted." } : { admit, settings };
147
+ return admit.length === 0 ? { message: NOTHING_ADMITTED } : { admit, settings };
150
148
  }
@@ -8,6 +8,7 @@
8
8
  import type { MemoryStore } from "../../../shared/application/ports.ts";
9
9
  import { parseMemoryArgs } from "../args.ts";
10
10
  import type { CommandView } from "../view.ts";
11
+ import { FEEDBACK_RECORDED, FEEDBACK_USAGE } from "./messages.ts";
11
12
 
12
13
  export interface MemoryDeps {
13
14
  memory: MemoryStore;
@@ -22,9 +23,9 @@ export function admitTokens(tokens: readonly string[], typed: string): string[]
22
23
 
23
24
  /** `/feedback <text>`: a 'feedback' memory, the reply saying the agent replays it. */
24
25
  async function runFeedback(tokens: string[], deps: MemoryDeps): Promise<CommandView> {
25
- if (tokens.join(" ").trim() === "") return { text: "usage: /feedback <what should change or keep happening>" };
26
+ if (tokens.join(" ").trim() === "") return { text: FEEDBACK_USAGE };
26
27
  await runMemory(["add", "feedback", ...tokens], deps);
27
- return { text: "feedback recorded — the agent replays feedback memories on every /assistant turn." };
28
+ return { text: FEEDBACK_RECORDED };
28
29
  }
29
30
 
30
31
  /** `/memory [list|add|delete|get] …`, from the command's raw tokens; typed by its alias `feedback`, an add of a feedback. */
@@ -0,0 +1,32 @@
1
+ // The text the memory commands show the user (ADR 0026): /memory, /feedback and /memory-admit.
2
+
3
+ // /memory and /feedback
4
+
5
+ export const FEEDBACK_USAGE = "usage: /feedback <what should change or keep happening>";
6
+ export const FEEDBACK_RECORDED = "feedback recorded — the agent replays feedback memories on every /assistant turn.";
7
+
8
+ // /memory-admit
9
+
10
+ export const LIST_TAKES_NOTHING = "memory-admit: --list takes nothing else";
11
+ export const IMPORT_TAKES_NOTHING = "memory-admit: --import takes nothing else";
12
+ export const REFUSE_USAGE = "memory-admit: --refuse <id> [<motif>]: the id of a pending candidate";
13
+ export const motifTooLong = (max: number): string => `memory-admit: a motif of at most ${max} characters`;
14
+ export const unknownAdmitOption = (option: string): string =>
15
+ `memory-admit: unknown option '${option}' (--list, --refuse, --import)`;
16
+ export const notACandidateId = (token: string): string => `memory-admit: '${token}' is not a candidate id`;
17
+
18
+ export const HEADLESS =
19
+ "refused: /memory-admit asks before admitting and this session cannot prompt: no asked candidate was admitted. " +
20
+ "Run it in an interactive session (an audited candidate admits unasked when memory.autoAdmitAudited is true).";
21
+
22
+ /** A question cancelled after another was answered: the session can prompt, the person stopped. */
23
+ export const stoppedAt = (id: string): string =>
24
+ `refused: the question about ${id} got no answer: it and the candidates after it stay candidates. Run /memory-admit again for them.`;
25
+
26
+ export const noPendingCandidate = (dir: string): string => `No pending candidate in ${dir}.`;
27
+ export const NO_INGESTION_ON_REFUSAL = "no ingestion on a refusal";
28
+ export const notPending = (id: string): string => `${id}: not a pending candidate (/memory-admit --list)`;
29
+ export const NOTHING_ADMITTED = "Nothing admitted.";
30
+ export const ADMITTED_UNASKED = " admitted without a question (audited, memory.autoAdmitAudited is true)";
31
+ export const admitQuestion = (id: string): string => `Admit ${id} into the shared memory?`;
32
+ export const LEFT_AS_CANDIDATE = " left as a candidate";
@@ -0,0 +1,48 @@
1
+ // The text the shared helpers of commands/_lib/ show the user (ADR 0026): the warnings of a launch, the refusals of a
2
+ // dev step. Read by dispatch.ts, dev-step.ts and args.ts.
3
+
4
+ // dispatch.ts: the main loop's launch
5
+ export const extraToolMissing = (name: string) =>
6
+ `extra tool '${name}' is not registered by the host and is left out ` +
7
+ "(its MCP server did not connect, its plugin did not load, or the name is mistyped)";
8
+ export const extraToolIgnored = (key: string, entry: string, rule: string) => `${key}: '${entry}' is ignored (${rule})`;
9
+ export const extraToolsUnreadable = (key: string, reason: string) =>
10
+ `${key} could not be read (${reason}): no extra tool this turn`;
11
+ export const ruleOverridden = (rule: string) =>
12
+ `permission rule '${rule}' is left out of the gate: a built-in rule denies the same calls (the shared memory's candidates and entries, the user configuration, paths.deny)`;
13
+ export const ruleDormant = (rule: string, key: string) =>
14
+ `permission rule '${rule}' is dormant: ${key} does not list its tool, the gate does not get it`;
15
+ export const invalidPermissionEntries = (count: number) =>
16
+ `${count} stored permission entr(ies) are not rules and were ignored`;
17
+ export const NO_SESSION_RULES = "the host keeps no session rules: the gate decides each call from the mode alone";
18
+ export const voiceReplyUnreadable = (key: string, reason: string) =>
19
+ `${key} could not be read (${reason}): the answer is not read aloud this turn`;
20
+ export const voiceReplyNoSpeakTool = (key: string, tool: string) =>
21
+ `${key} is on but the host registers no '${tool}': the answer is not read aloud ` +
22
+ "(start orkeon-code with ORKEON_CODE_AUDIO_DIR and ORKEON_CODE_VOICE=1)";
23
+
24
+ // dev-step.ts: the start of a dev step
25
+ export const stepRulesNotInGate = (command: string) =>
26
+ `warning: the host keeps no session rules: /${command}'s rule sets are not in the host's gate, the crew's callback alone checks them.`;
27
+ export const sessionRuleLeftOut = (rule: string, command: string) =>
28
+ `warning: the session's rule '${rule}' is left out of the gate during /${command}: the step denies the same calls.`;
29
+ export const modeUnreadableRefusal = (command: string, writes: string) =>
30
+ `✗ refused: the session mode could not be read, and /${command} ${writes}: run it again`;
31
+ export const modeUnknownRefusal = (mode: string, command: string, writes: string) =>
32
+ `✗ refused: the session mode ${mode} is not one Orkeon Code knows, and /${command} ${writes}: /mode default, then run it again`;
33
+ export const modeReadOnlyRefusal = (mode: string, command: string, writes: string) =>
34
+ `✗ refused: the session mode ${mode} is read-only, and /${command} ${writes}: /mode default, then run it again`;
35
+ export const batchNotRecorded = (reason: string) =>
36
+ `warning: the batch in progress could not be recorded (${reason}): a compaction will write no state file for it.`;
37
+
38
+ // args.ts: /debug-tool-call
39
+ export const DEBUG_TOOL_CALL_USAGE = "usage: /debug-tool-call <tool_name> [{\"arg\": \"value\"}]";
40
+ export const notAToolName = (tool: string) => `'${tool}' is not a tool name (expected snake_case, e.g. file_read)`;
41
+ export const argumentsNotJson = (reason: string, payload: string) =>
42
+ `arguments are not valid JSON (${reason}): ${payload}`;
43
+ export const argumentsNotObject = (got: string) => `arguments must be a JSON OBJECT, got ${got}`;
44
+
45
+ // Shared by several command groups
46
+ export const failedLine = (reason: string) => `✗ ${reason}`;
47
+ export const unknownOption = (word: string) => `unknown option ${word}`;
48
+ export const markedDefault = (value: number | string) => `${value} (default)`;
@@ -0,0 +1,8 @@
1
+ // The text the project commands show the user (ADR 0026): /debug-tool-call.
2
+
3
+ export const toolCatalogue = (names: readonly string[]): string =>
4
+ `${names.length} registered tools:\n${names.join(", ")}\n` +
5
+ "usage: /debug-tool-call <tool_name> [{\"arg\": \"value\"}]\n" +
6
+ "(argument schemas are not exposed to script-land — # TBD_tool_schema)";
7
+ export const noRegisteredToolSeeList = (tool: string): string =>
8
+ `no registered tool '${tool}'. /debug-tool-call list shows what this host has.`;
@@ -8,6 +8,7 @@ import type {
8
8
  } from "../../../shared/application/ports.ts";
9
9
  import { MEMORY_CATEGORIES } from "../../../shared/domain/agent-policy/memory-categories.ts";
10
10
  import type { CommandView } from "../view.ts";
11
+ import { EMPTY_SESSION_BUFFER, exported } from "./messages.ts";
11
12
 
12
13
  export interface ExportInputs {
13
14
  messages: ReadonlyArray<{ role?: unknown; content?: unknown }>;
@@ -54,7 +55,7 @@ export function renderSessionExport(i: ExportInputs): string {
54
55
 
55
56
  out.push("## Conversation", "");
56
57
  if (i.messages.length === 0) {
57
- out.push("_(the session buffer is empty)_", "");
58
+ out.push(EMPTY_SESSION_BUFFER, "");
58
59
  } else {
59
60
  for (const m of i.messages) {
60
61
  out.push(`**${String(m.role ?? "?")}:** ${String(m.content ?? "")}`, "");
@@ -100,5 +101,5 @@ export async function runExport(tokens: readonly string[], deps: ExportDeps): Pr
100
101
 
101
102
  await deps.files.write(path, md);
102
103
  const memoryCount = Object.values(memory).reduce((n, v) => n + v.length, 0);
103
- return { text: `exported → ${path} (${messages.length} message(s), ${memoryCount} memory entr(y/ies), cost included)` };
104
+ return { text: exported(path, messages.length, memoryCount) };
104
105
  }