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
@@ -1,17 +1,57 @@
1
1
  // /skills (E-1) — manage skill attachments (baseline 04 §/skills). Skills in
2
2
  // Orkeon Code are workspace markdown files whose PATH is registered here; attached
3
3
  // skills are restorable context (the post-compaction restore, E-4, re-injects
4
- // path-mentioned files). DEVIATION (recorded in RESULTS.md): no autonomous
5
- // skill triggering — attachment is explicit.
4
+ // path-mentioned files). Attachment is explicit; `/skills suggest on` adds, turn by turn, the project's skills the
5
+ // host's decision model finds fit for the request (shared/application/skills/suggest-skills.ts, ADR 0027).
6
6
 
7
- import type { Files, SessionStore } from "../../../shared/application/ports.ts";
7
+ import type { DecisionModel, Files, SessionStore } from "../../../shared/application/ports.ts";
8
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
9
+ import { SKILLS_SUGGEST_CONFIG_KEY, suggestOn } from "../../../shared/domain/skills/shortlist.ts";
10
+ import type { SkillPick } from "../../../shared/domain/skills/shortlist.ts";
8
11
  import { readJsonArray, writeJson } from "../../../shared/application/session-state.ts";
9
- import { SKILLS_STATE_KEY } from "../../../shared/domain/session-keys.ts";
12
+ import { SKILLS_STATE_KEY, SKILLS_SUGGESTED_STATE_KEY } from "../../../shared/domain/session-keys.ts";
10
13
  import type { CommandView } from "../view.ts";
14
+ import {
15
+ NO_SKILLS, NOTHING_SUGGESTED_YET, SKILLS_ATTACH_USAGE, SKILLS_SUGGEST_USAGE, SKILLS_USAGE, cannotAttach, noSkillFit, skillAttached,
16
+ skillDetached, skillsDetachUsage, skillsOffered, suggestSet, suggestStatus, suggestedSkill,
17
+ } from "./messages.ts";
11
18
 
12
19
  export interface SkillsDeps {
13
20
  session: Pick<SessionStore, "readState" | "writeState">;
14
21
  files: Pick<Files, "read">;
22
+ /** The settings and the decision model `/skills suggest` reads; absent, the sub-command answers its usage. */
23
+ config?: Pick<ConfigStore, "readValue" | "readSession" | "writeSession">;
24
+ decision?: Pick<DecisionModel, "available">;
25
+ }
26
+
27
+ /** What the last turn was suggested, as stored; null when nothing readable is. */
28
+ function lastSuggestion(stored: string | null): { offered: number; picks: SkillPick[] } | null {
29
+ try {
30
+ const raw = JSON.parse(stored ?? "null") as { offered?: unknown; picks?: unknown } | null;
31
+ if (raw === null || typeof raw.offered !== "number" || !Array.isArray(raw.picks)) return null;
32
+ return { offered: raw.offered, picks: raw.picks.filter((p): p is SkillPick => typeof p?.path === "string" && typeof p?.share === "number") };
33
+ } catch {
34
+ return null;
35
+ }
36
+ }
37
+
38
+ /** `/skills suggest [on|off|why]`. */
39
+ async function runSuggest(word: string, deps: SkillsDeps): Promise<CommandView> {
40
+ const { config, decision } = deps;
41
+ if (config === undefined || decision === undefined) return { text: SKILLS_SUGGEST_USAGE };
42
+ if (word === "") {
43
+ const value = await config.readValue(SKILLS_SUGGEST_CONFIG_KEY).then((read) => read.value).catch(() => undefined);
44
+ return { text: suggestStatus(suggestOn(value), decision.available()) };
45
+ }
46
+ if (word === "why") {
47
+ const last = lastSuggestion(await deps.session.readState(SKILLS_SUGGESTED_STATE_KEY).catch(() => null));
48
+ if (last === null) return { text: NOTHING_SUGGESTED_YET };
49
+ if (last.picks.length === 0) return { text: noSkillFit(last.offered) };
50
+ return { lines: last.picks.map((pick) => suggestedSkill(pick.path, pick.share)), text: skillsOffered(last.offered) };
51
+ }
52
+ if (word !== "on" && word !== "off") return { text: SKILLS_SUGGEST_USAGE };
53
+ await config.writeSession({ ...await config.readSession(), [SKILLS_SUGGEST_CONFIG_KEY]: word });
54
+ return { text: suggestSet(word === "on", decision.available()) };
15
55
  }
16
56
 
17
57
  /** `/skills [list|attach <path>|detach <n>]`, from the command's raw tokens. */
@@ -22,30 +62,32 @@ export async function runSkills(tokens: string[], deps: SkillsDeps): Promise<Com
22
62
  switch ((sub ?? "list").toLowerCase()) {
23
63
  case "list":
24
64
  if (skills.length === 0) {
25
- return { text: "no skills attached. usage: /skills attach <workspace path to a .md playbook>" };
65
+ return { text: NO_SKILLS };
26
66
  }
27
67
  return { table: skills.map((p, i) => ({ n: i + 1, path: String(p) })) };
28
68
  case "attach": {
29
- if (!arg) return { text: "usage: /skills attach <path>" };
69
+ if (!arg) return { text: SKILLS_ATTACH_USAGE };
30
70
  try {
31
71
  await files.read(arg, 1);
32
72
  } catch {
33
- return { text: `cannot attach '${arg}' — the file is not readable in the mounted workspace.` };
73
+ return { text: cannotAttach(arg) };
34
74
  }
35
75
  if (!skills.includes(arg)) skills.push(arg);
36
76
  await writeJson(session, SKILLS_STATE_KEY, skills);
37
- return { text: `skill attached: ${arg} (${skills.length} attached; /clear clears).` };
77
+ return { text: skillAttached(arg, skills.length) };
38
78
  }
39
79
  case "detach": {
40
80
  const n = Number(arg);
41
81
  if (!Number.isInteger(n) || n < 1 || n > skills.length) {
42
- return { text: `usage: /skills detach <1-${skills.length || 1}>` };
82
+ return { text: skillsDetachUsage(skills.length || 1) };
43
83
  }
44
84
  const [removed] = skills.splice(n - 1, 1);
45
85
  await writeJson(session, SKILLS_STATE_KEY, skills);
46
- return { text: `skill detached: ${removed}` };
86
+ return { text: skillDetached(removed) };
47
87
  }
88
+ case "suggest":
89
+ return runSuggest((arg ?? "").toLowerCase(), deps);
48
90
  default:
49
- return { text: "usage: /skills [list|attach <path>|detach <n>]" };
91
+ return { text: SKILLS_USAGE };
50
92
  }
51
93
  }
@@ -0,0 +1,42 @@
1
+ // /theme [<name>|show]: the console's palette for this session. The start palette is the setting Orkeon:Cli:Tui:Theme.
2
+ import type { Chooser, ThemeConsole, ThemeName } from "../../../shared/application/ports.ts";
3
+ import type { CommandView } from "../view.ts";
4
+ import { optionsOf } from "./choices.ts";
5
+ import { NO_PALETTES, THEME_CHOICE, themeSet, themeShown, themeUnchanged, unknownTheme } from "./messages.ts";
6
+
7
+ const THEMES: readonly ThemeName[] = ["dark", "light", "none"];
8
+
9
+ export interface ThemeDeps {
10
+ console: ThemeConsole;
11
+ /** Where a bare /theme opens a panel, when it can. */
12
+ chooser?: Chooser;
13
+ }
14
+
15
+ const isTheme = (token: string): token is ThemeName => (THEMES as readonly string[]).includes(token);
16
+
17
+ /** `/theme [<name>|show]`, from the command's raw tokens. No argument opens a panel, or without one shows the palette,
18
+ * as `show` does. */
19
+ export async function runTheme(tokens: string[], deps: ThemeDeps): Promise<CommandView> {
20
+ const { console, chooser } = deps;
21
+ const requested = (tokens[0] ?? "").toLowerCase();
22
+ if (requested && requested !== "show" && !isTheme(requested)) {
23
+ return { text: unknownTheme(requested, THEMES) };
24
+ }
25
+ const current = console.theme;
26
+ if (current === null) return { text: NO_PALETTES };
27
+
28
+ if (isTheme(requested)) return setTheme(console, requested);
29
+ if (!requested && chooser?.interactive) {
30
+ const answer = await chooser.choose({
31
+ message: THEME_CHOICE,
32
+ options: optionsOf(THEMES, current),
33
+ });
34
+ return answer ? setTheme(console, answer.value as ThemeName) : { text: themeUnchanged(current) };
35
+ }
36
+ return { text: themeShown(current, THEMES) };
37
+ }
38
+
39
+ function setTheme(console: ThemeConsole, name: ThemeName): CommandView {
40
+ if (!console.setTheme(name)) return { text: NO_PALETTES };
41
+ return { text: themeSet(name) };
42
+ }
@@ -0,0 +1,58 @@
1
+ // The text /say, /transcribe and /voice show the user (ADR 0026): their usage, their refusals and what a completion
2
+ // prints. Read by say.ts, transcribe.ts and voice.ts.
3
+
4
+ export const SAY_USAGE = "usage: /say [<text>] [--voice <voice>]\n /say --stop";
5
+
6
+ export const TRANSCRIBE_USAGE =
7
+ 'usage: /transcribe <file> [--lang <code>] [--prompt "<words>"] [--then "<instruction>"]\n' +
8
+ " /transcribe --list";
9
+
10
+ export const VOICE_USAGE =
11
+ 'usage: /voice [--go] [--lang <code>] [--prompt "<words>"] [--max <seconds>] [--silence <seconds>]\n' +
12
+ " /voice send";
13
+
14
+ // The refusals of a bad line
15
+ export const unknownArgument = (word: string) => `unknown argument ${word}`;
16
+ export const VOICE_NEEDS_NAME = "--voice needs a voice name (fr_FR-siwis-medium, en_US-lessac-medium...)";
17
+ export const STOP_ALONE = "--stop takes nothing else";
18
+ export const NAME_A_FILE = "name a file under /audio (/transcribe --list shows them)";
19
+ export const oneFileAtATime = (file: string, word: string) =>
20
+ `one file at a time (${file}, ${word}): quote a name that holds a space`;
21
+ export const needsLanguageCode = (option: string) => `${option} needs a language code (fr, en...)`;
22
+ export const PROMPT_NEEDS_WORDS = '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")';
23
+ export const THEN_NEEDS_INSTRUCTION = "--then needs an instruction";
24
+ export const LIST_ALONE = "--list takes no file and no option";
25
+ export const SEND_ALONE = "send takes no option and no quotes: /voice send sends the last dictation";
26
+ export const secondsBetween = (option: string, min: number, max: number) =>
27
+ `${option} takes seconds between ${min} and ${max}`;
28
+
29
+ /** The line that says what to do when the server's tools are not registered. */
30
+ export function missingToolMessage(tool: string): string {
31
+ return (
32
+ `no registered tool '${tool}': the Whisper MCP server is not connected. Start orkeon-code with ` +
33
+ "ORKEON_CODE_AUDIO_DIR set (docs/configuration.md, Speech-to-text); /debug-tool-call list shows what this host registers."
34
+ );
35
+ }
36
+
37
+ // /say
38
+ export const STOPPED = "stopped";
39
+ export const toolFailed = (tool: string, failure: string) => `✗ ${tool}: ${failure}`;
40
+ export const lastAnswerUnreadable = (reason: string) => `cannot read the session's last answer: ${reason}`;
41
+ export const NOTHING_TO_READ = "nothing to read: give a text, or ask the assistant first (/say alone reads its last answer)";
42
+ export const TEXT_READ_ALOUD = "text read aloud";
43
+ export const LAST_ANSWER_READ_ALOUD = "last answer read aloud";
44
+
45
+ // /transcribe
46
+ export const filesUnder = (root: string) => `the files under ${root}`;
47
+ export const transcriptionOf = (path: string) => `transcription of ${path}`;
48
+
49
+ // /voice
50
+ export const recordingLine = (silenceSeconds: number, maxSeconds: number, go: boolean) =>
51
+ `🎙 recording: speak, then stay silent ${silenceSeconds} s to stop (${maxSeconds} s at most)` +
52
+ (go ? "; the text goes straight to the assistant" : "");
53
+ export const noDictationToSend = (file: string) => `no dictation to send: /voice records one (it is kept in ${file})`;
54
+ export const cannotRead = (file: string, reason: string) => `cannot read ${file}: ${reason}`;
55
+ export const voiceFailed = (error: string) => `✗ voice failed: ${error}`;
56
+ export const NOTHING_HEARD = "nothing was heard: /voice records again";
57
+ export const dictationLine = (payload: string) => `🎙 ${payload}`;
58
+ export const DICTATION_NEXT = "send it: /voice send · edit it: /assistant <text> · record again: /voice";
@@ -0,0 +1,4 @@
1
+ // The text /transcribe hands the model (ADR 0026): the label of the transcription a --then turn reads first.
2
+
3
+ export const transcriptionPreludeLabel = (path: string) =>
4
+ `Transcription of ${path}, made by /transcribe before this request`;
@@ -15,12 +15,11 @@ import { SPEAK_TOOL } from "../../../shared/domain/speech.ts";
15
15
  import { commandLine, isOption, optionValue, splitWords } from "../args.ts";
16
16
  import { launchCrew, withLlmProfile } from "../dispatch.ts";
17
17
  import type { CommandLog, LaunchDeps, LaunchResult } from "../dispatch.ts";
18
- import { missingToolMessage } from "./transcribe.ts";
18
+ import { LAST_ANSWER_READ_ALOUD, NOTHING_TO_READ, SAY_USAGE, STOP_ALONE, STOPPED, TEXT_READ_ALOUD, VOICE_NEEDS_NAME, lastAnswerUnreadable, missingToolMessage, toolFailed } from "./messages.ts";
19
+ import { unknownOption } from "../messages.ts";
19
20
 
20
21
  export const STOP_TOOL = "stop_speaking";
21
22
 
22
- export const SAY_USAGE = "usage: /say [<text>] [--voice <voice>]\n /say --stop";
23
-
24
23
  export type SayRequest = { kind: "stop" } | { kind: "say"; text: string; voice: string };
25
24
 
26
25
  export type ParsedSay = { ok: true; request: SayRequest } | { ok: false; error: string };
@@ -38,12 +37,12 @@ export function parseSayArgs(tokens: readonly string[]): ParsedSay {
38
37
  text.push(word);
39
38
  } else if (word === "--voice") {
40
39
  const value = optionValue(words, i++);
41
- if (value === null) return { ok: false, error: "--voice needs a voice name (fr_FR-siwis-medium, en_US-lessac-medium...)" };
40
+ if (value === null) return { ok: false, error: VOICE_NEEDS_NAME };
42
41
  voice = value;
43
42
  } else if (word === "--stop") {
44
- return { ok: false, error: "--stop takes nothing else" };
43
+ return { ok: false, error: STOP_ALONE };
45
44
  } else {
46
- return { ok: false, error: `unknown option ${word}` };
45
+ return { ok: false, error: unknownOption(word) };
47
46
  }
48
47
  }
49
48
  return { ok: true, request: { kind: "say", text: text.join(" ").trim(), voice } };
@@ -75,7 +74,7 @@ export async function dispatchSay(tokens: readonly string[], deps: SayDeps): Pro
75
74
  const stop = deps.catalogue.find(STOP_TOOL);
76
75
  if (stop === undefined) return { message: missingToolMessage(STOP_TOOL) };
77
76
  const outcome = await deps.catalogue.callText(stop, {});
78
- return { message: outcome.ok ? (outcome.text || "stopped") : `✗ ${STOP_TOOL}: ${outcome.failure}` };
77
+ return { message: outcome.ok ? (outcome.text || STOPPED) : toolFailed(STOP_TOOL, outcome.failure) };
79
78
  }
80
79
  const speak = deps.catalogue.find(SPEAK_TOOL);
81
80
  if (speak === undefined) return { message: missingToolMessage(SPEAK_TOOL) };
@@ -84,13 +83,13 @@ export async function dispatchSay(tokens: readonly string[], deps: SayDeps): Pro
84
83
  try {
85
84
  text = lastAnswer((await deps.session.readMessages()).messages);
86
85
  } catch (error) {
87
- return { message: `cannot read the session's last answer: ${errorText(error)}` };
86
+ return { message: lastAnswerUnreadable(errorText(error)) };
88
87
  }
89
88
  }
90
- if (!text) return { message: "nothing to read: give a text, or ask the assistant first (/say alone reads its last answer)" };
89
+ if (!text) return { message: NOTHING_TO_READ };
91
90
  const args: Record<string, unknown> = { text };
92
91
  if (request.voice) args.voice = request.voice;
93
- return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: speak, args, label: request.text ? "text read aloud" : "last answer read aloud" }, {
92
+ return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: speak, args, label: request.text ? TEXT_READ_ALOUD : LAST_ANSWER_READ_ALOUD }, {
94
93
  characters: text.length, ...(request.voice ? { voice: request.voice } : {}),
95
94
  });
96
95
  }
@@ -12,15 +12,14 @@ import type { PreludeCall } from "../../../shared/domain/prelude.ts";
12
12
  import { commandLine, isOption, optionValue, parseAssistantInput, splitWords } from "../args.ts";
13
13
  import { launchCrew, launchMainLoop, withLlmProfile } from "../dispatch.ts";
14
14
  import type { LaunchResult, MainLoopLaunchDeps } from "../dispatch.ts";
15
+ import { LIST_ALONE, NAME_A_FILE, PROMPT_NEEDS_WORDS, THEN_NEEDS_INSTRUCTION, TRANSCRIBE_USAGE, filesUnder, missingToolMessage, needsLanguageCode, oneFileAtATime, transcriptionOf } from "./messages.ts";
16
+ import { unknownOption } from "../messages.ts";
17
+ import { transcriptionPreludeLabel } from "./prompts.ts";
15
18
 
16
19
  export const TRANSCRIBE_TOOL = "transcribe_audio";
17
20
  export const LIST_AUDIO_TOOL = "list_audio";
18
21
  export const AUDIO_ROOT = "/audio";
19
22
 
20
- export const TRANSCRIBE_USAGE =
21
- 'usage: /transcribe <file> [--lang <code>] [--prompt "<words>"] [--then "<instruction>"]\n' +
22
- " /transcribe --list";
23
-
24
23
  /** What /transcribe was asked: the listing of /audio, or one file. */
25
24
  export type TranscribeRequest =
26
25
  | { kind: "list" }
@@ -50,45 +49,37 @@ export function parseTranscribeArgs(tokens: readonly string[]): ParsedTranscribe
50
49
  for (let i = 0; i < words.length; i++) {
51
50
  const word = words[i].text;
52
51
  if (!isOption(words[i])) {
53
- if (word.trim().length === 0) return { ok: false, error: "name a file under /audio (/transcribe --list shows them)" };
54
- if (file !== null) return { ok: false, error: `one file at a time (${file}, ${word}): quote a name that holds a space` };
52
+ if (word.trim().length === 0) return { ok: false, error: NAME_A_FILE };
53
+ if (file !== null) return { ok: false, error: oneFileAtATime(file, word) };
55
54
  file = word;
56
55
  } else if (word === "--list") {
57
56
  list = true;
58
57
  } else if (word === "--lang" || word === "--language") {
59
58
  const value = optionValue(words, i++);
60
- if (value === null) return { ok: false, error: `${word} needs a language code (fr, en...)` };
59
+ if (value === null) return { ok: false, error: needsLanguageCode(word) };
61
60
  language = value;
62
61
  } else if (word === "--prompt") {
63
62
  const value = optionValue(words, i++);
64
- if (value === null) return { ok: false, error: '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")' };
63
+ if (value === null) return { ok: false, error: PROMPT_NEEDS_WORDS };
65
64
  vocabulary = value;
66
65
  } else if (word === "--then") {
67
66
  // One quoted instruction loses its quotes; otherwise the rest is kept as typed, quotes included.
68
67
  const rest = words.slice(i + 1);
69
68
  then = (rest.length === 1 ? rest[0].text : line.slice(words[i].end)).trim();
70
- if (then.length === 0) return { ok: false, error: "--then needs an instruction" };
69
+ if (then.length === 0) return { ok: false, error: THEN_NEEDS_INSTRUCTION };
71
70
  break;
72
71
  } else {
73
- return { ok: false, error: `unknown option ${word}` };
72
+ return { ok: false, error: unknownOption(word) };
74
73
  }
75
74
  }
76
75
  if (list) {
77
- if (file !== null || then !== null || language || vocabulary) return { ok: false, error: "--list takes no file and no option" };
76
+ if (file !== null || then !== null || language || vocabulary) return { ok: false, error: LIST_ALONE };
78
77
  return { ok: true, request: { kind: "list" } };
79
78
  }
80
- if (file === null) return { ok: false, error: "name a file under /audio (/transcribe --list shows them)" };
79
+ if (file === null) return { ok: false, error: NAME_A_FILE };
81
80
  return { ok: true, request: { kind: "file", path: audioPath(file), language, vocabulary, then } };
82
81
  }
83
82
 
84
- /** The line that says what to do when the server's tools are not registered. */
85
- export function missingToolMessage(tool: string): string {
86
- return (
87
- `no registered tool '${tool}': the Whisper MCP server is not connected. Start orkeon-code with ` +
88
- "ORKEON_CODE_AUDIO_DIR set (docs/configuration.md, Speech-to-text); /debug-tool-call list shows what this host registers."
89
- );
90
- }
91
-
92
83
  /** The arguments of transcribe_audio for a file request (the server's parameter names). */
93
84
  export function transcribeCall(registered: string, request: Extract<TranscribeRequest, { kind: "file" }>, label: string): PreludeCall {
94
85
  const args: Record<string, unknown> = { path: request.path };
@@ -118,13 +109,13 @@ export async function dispatchTranscribe(
118
109
  const registered = deps.catalogue.find(wanted);
119
110
  if (registered === undefined) return { message: missingToolMessage(wanted) };
120
111
  if (request.kind === "list") {
121
- return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: registered, args: {}, label: `the files under ${AUDIO_ROOT}` });
112
+ return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: registered, args: {}, label: filesUnder(AUDIO_ROOT) });
122
113
  }
123
114
  if (request.then === null) {
124
- const call = transcribeCall(registered, request, `transcription of ${request.path}`);
115
+ const call = transcribeCall(registered, request, transcriptionOf(request.path));
125
116
  return launchCrew(await withLlmProfile(deps, deps.config), "speech", { ...call }, call.args);
126
117
  }
127
118
  const { prompt, permissionMode } = parseAssistantInput(request.then);
128
- const prelude = transcribeCall(registered, request, `Transcription of ${request.path}, made by /transcribe before this request`);
119
+ const prelude = transcribeCall(registered, request, transcriptionPreludeLabel(request.path));
129
120
  return await launchMainLoop(deps, { prompt, permissionMode, prelude });
130
121
  }
@@ -15,17 +15,14 @@ import { errorText, nothingReturned } from "../../../shared/domain/prelude.ts";
15
15
  import { commandLine, isOption, optionValue, parseAssistantInput, splitWords } from "../args.ts";
16
16
  import { launchCrew, launchMainLoop, withLlmProfile } from "../dispatch.ts";
17
17
  import type { CrewCompletion, LaunchResult, MainLoopLaunchDeps } from "../dispatch.ts";
18
- import { missingToolMessage } from "./transcribe.ts";
18
+ import { DICTATION_NEXT, NOTHING_HEARD, PROMPT_NEEDS_WORDS, SEND_ALONE, VOICE_USAGE, cannotRead, dictationLine, missingToolMessage, needsLanguageCode, noDictationToSend, recordingLine, secondsBetween, unknownArgument, voiceFailed } from "./messages.ts";
19
+ import { unknownOption } from "../messages.ts";
19
20
 
20
21
  export const RECORD_TOOL = "record_and_transcribe";
21
22
  export const DICTATION_FILE = "/transcripts/dictation.txt";
22
23
  const DEFAULT_MAX_SECONDS = 60;
23
24
  const DEFAULT_SILENCE_SECONDS = 2;
24
25
 
25
- export const VOICE_USAGE =
26
- 'usage: /voice [--go] [--lang <code>] [--prompt "<words>"] [--max <seconds>] [--silence <seconds>]\n' +
27
- " /voice send";
28
-
29
26
  export type VoiceRequest =
30
27
  | { kind: "record"; go: boolean; language: string; vocabulary: string; maxSeconds: number; silenceSeconds: number }
31
28
  | { kind: "send" };
@@ -35,7 +32,7 @@ export type ParsedVoice = { ok: true; request: VoiceRequest } | { ok: false; err
35
32
  /** A number option within bounds, or the reason it is not one. */
36
33
  function seconds(option: string, value: string | null, min: number, max: number): number | string {
37
34
  const n = value === null ? Number.NaN : Number(value);
38
- if (!Number.isFinite(n) || n < min || n > max) return `${option} takes seconds between ${min} and ${max}`;
35
+ if (!Number.isFinite(n) || n < min || n > max) return secondsBetween(option, min, max);
39
36
  return n;
40
37
  }
41
38
 
@@ -50,17 +47,17 @@ export function parseVoiceArgs(tokens: readonly string[]): ParsedVoice {
50
47
  for (let i = 0; i < words.length; i++) {
51
48
  const word = words[i].text;
52
49
  if (!isOption(words[i])) {
53
- if (word === "send") return { ok: false, error: "send takes no option and no quotes: /voice send sends the last dictation" };
54
- return { ok: false, error: `unknown argument ${word}` };
50
+ if (word === "send") return { ok: false, error: SEND_ALONE };
51
+ return { ok: false, error: unknownArgument(word) };
55
52
  } else if (word === "--go") {
56
53
  request.go = true;
57
54
  } else if (word === "--lang" || word === "--language") {
58
55
  const value = optionValue(words, i++);
59
- if (value === null) return { ok: false, error: `${word} needs a language code (fr, en...)` };
56
+ if (value === null) return { ok: false, error: needsLanguageCode(word) };
60
57
  request.language = value;
61
58
  } else if (word === "--prompt") {
62
59
  const value = optionValue(words, i++);
63
- if (value === null) return { ok: false, error: '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")' };
60
+ if (value === null) return { ok: false, error: PROMPT_NEEDS_WORDS };
64
61
  request.vocabulary = value;
65
62
  } else if (word === "--max" || word === "--silence") {
66
63
  const value = optionValue(words, i++);
@@ -69,7 +66,7 @@ export function parseVoiceArgs(tokens: readonly string[]): ParsedVoice {
69
66
  if (word === "--max") request.maxSeconds = parsed;
70
67
  else request.silenceSeconds = parsed;
71
68
  } else {
72
- return { ok: false, error: `unknown option ${word}` };
69
+ return { ok: false, error: unknownOption(word) };
73
70
  }
74
71
  }
75
72
  return { ok: true, request };
@@ -85,8 +82,7 @@ export function recordArgs(request: Extract<VoiceRequest, { kind: "record" }>):
85
82
 
86
83
  /** The line shown when the microphone opens. */
87
84
  export function recordingNotice(request: Extract<VoiceRequest, { kind: "record" }>): string {
88
- return `🎙 recording: speak, then stay silent ${request.silenceSeconds} s to stop (${request.maxSeconds} s at most)` +
89
- (request.go ? "; the text goes straight to the assistant" : "");
85
+ return recordingLine(request.silenceSeconds, request.maxSeconds, request.go);
90
86
  }
91
87
 
92
88
  /** What /voice reads and drives: the registered tools, the files (the last dictation, for
@@ -97,7 +93,7 @@ export type VoiceDeps = MainLoopLaunchDeps & {
97
93
  out: { writeLine(text: string): void };
98
94
  };
99
95
 
100
- const NOTHING_TO_SEND = `no dictation to send: /voice records one (it is kept in ${DICTATION_FILE})`;
96
+ const NOTHING_TO_SEND = noDictationToSend(DICTATION_FILE);
101
97
 
102
98
  /** Launch what the request asks and return its ticket, or the message to show when it launches nothing. */
103
99
  export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps): Promise<LaunchResult | { message: string }> {
@@ -111,7 +107,7 @@ export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps):
111
107
  } catch (error) {
112
108
  // A missing file is the common case (no dictation yet); the runtime's read says so, as json-file.ts reads it.
113
109
  if (/not found|no such|does not exist/i.test(errorText(error))) return { message: NOTHING_TO_SEND };
114
- return { message: `cannot read ${DICTATION_FILE}: ${errorText(error)}` };
110
+ return { message: cannotRead(DICTATION_FILE, errorText(error)) };
115
111
  }
116
112
  if (text.length === 0) return { message: NOTHING_TO_SEND };
117
113
  const { prompt, permissionMode } = parseAssistantInput(text);
@@ -135,12 +131,12 @@ export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps):
135
131
  * "script-host", and the crew's name as the intent).
136
132
  */
137
133
  export function renderVoiceCompletion(result: CrewCompletion & { agent?: string; intent?: string }): string[] {
138
- if (!result.success) return [`✗ voice failed: ${result.error ?? "unknown"}`];
134
+ if (!result.success) return [voiceFailed(result.error ?? "unknown")];
139
135
  const payload = (result.payload ?? "").trim();
140
136
  if (result.intent !== "speech") return [payload];
141
137
  // The crew names the tool as the host registers it: compared case aside.
142
138
  if (payload.length === 0 || payload.toLowerCase() === nothingReturned(RECORD_TOOL).toLowerCase()) {
143
- return ["nothing was heard: /voice records again"];
139
+ return [NOTHING_HEARD];
144
140
  }
145
- return [`🎙 ${payload}`, "send it: /voice send · edit it: /assistant <text> · record again: /voice"];
141
+ return [dictationLine(payload), DICTATION_NEXT];
146
142
  }
@@ -21,9 +21,18 @@ import type {
21
21
  import type { ConfigStore } from "../../../shared/application/config-store.ts";
22
22
  import { CODE_INTEL_TOOLS } from "../../../shared/domain/code-intel-contract.ts";
23
23
  import { knownConfigKeys } from "../../../shared/domain/config-schema.ts";
24
- import { CLI_BUILD, CLI_NAME, CLI_VERSION, isPinnedCommit, ORKEON_RUNTIME_PIN } from "./meta.ts";
24
+ import { readHostContext } from "../../../shared/application/host-context.ts";
25
+ import { describeHostLayout } from "../../../shared/domain/host-layout.ts";
26
+ import { listedEntries } from "../../../shared/domain/agent-policy/path-rules.ts";
27
+ import { CLI_BUILD, CLI_NAME, CLI_VERSION, isPinnedCommit } from "./meta.ts";
25
28
  import type { CommandView } from "../view.ts";
26
29
  import { WORKSPACE } from "../../../shared/domain/vfs.ts";
30
+ import {
31
+ ALL_CHECKS_PASSED, CHECK_CODE_INTEL, CHECK_LLM_CATALOGUE, CHECK_LLM_MODEL, CHECK_PROJECT_FILE, CHECK_SESSIONS,
32
+ NO_AVAILABLE_MODELS, NO_MODEL, NO_PATH_LIST, checksFailed, checksPassedWarned, codeIntelAbsent, essentialsPresent,
33
+ modelNotPinged, oldSessionsLeft, projectSettingIgnored, versionNoRuntime, versionNotPinned, versionPinned,
34
+ workspaceNotWritable,
35
+ } from "./messages.ts";
27
36
 
28
37
  /** Tools the coding agent cannot work without — absence is a FAIL, not a note. */
29
38
  export const ESSENTIAL_TOOLS = ["file_read", "file_write", "shell_command", "directory_read", "session_store"];
@@ -40,8 +49,10 @@ export interface DoctorDeps {
40
49
  shell: Shell;
41
50
  telemetry: Pick<Telemetry, "readMetadata">;
42
51
  catalogue: Pick<ToolCatalogue, "names">;
43
- files: Pick<Files, "mounts" | "list">;
44
- config: Pick<ConfigStore, "readValue">;
52
+ /** The mounts, the old sessions folder, and launch.json (the host's layout). */
53
+ files: Pick<Files, "mounts" | "list" | "read">;
54
+ /** What the project file could not widen, and the two settings files' path lists. */
55
+ config: Pick<ConfigStore, "readValue" | "readFile" | "readUserFile">;
45
56
  /** The running runtime's reader (Orkeon #225); absent, or answering nothing: the version row names the pin alone. */
46
57
  runtime?: RuntimeInfoReader;
47
58
  }
@@ -57,18 +68,16 @@ export function versionRow(runtime: RuntimeInfo | undefined): DoctorRow {
57
68
  return {
58
69
  check: "version",
59
70
  result: PASS,
60
- detail: `${CODE_VERSION_DETAIL}; Orkeon expected at commit ${ORKEON_RUNTIME_PIN} (.orkeon-version), the host names no runtime: ` +
61
- "orkeon-code --version in a terminal says the one found",
71
+ detail: versionNoRuntime(CODE_VERSION_DETAIL),
62
72
  };
63
73
  }
64
74
  const found = `Orkeon ${runtime.version}${runtime.commit ? `+${runtime.commit}` : ""} (${runtime.channel})`;
65
75
  return isPinnedCommit(runtime.commit)
66
- ? { check: "version", result: PASS, detail: `${CODE_VERSION_DETAIL}; ${found}, the pin of .orkeon-version` }
76
+ ? { check: "version", result: PASS, detail: versionPinned(CODE_VERSION_DETAIL, found) }
67
77
  : {
68
78
  check: "version",
69
79
  result: WARN,
70
- detail: `${CODE_VERSION_DETAIL}; ${found} runs, commit ${ORKEON_RUNTIME_PIN} expected (.orkeon-version): ` +
71
- "the commands were checked against the pin",
80
+ detail: versionNotPinned(CODE_VERSION_DETAIL, found),
72
81
  };
73
82
  }
74
83
 
@@ -97,18 +106,14 @@ export async function runDoctor(deps: DoctorDeps): Promise<CommandView> {
97
106
  const model = (md.model ?? "").trim();
98
107
  const declared = md.availableModels ?? [];
99
108
  rows.push({
100
- check: "llm: model configured",
109
+ check: CHECK_LLM_MODEL,
101
110
  result: model ? PASS : FAIL,
102
- detail: model
103
- ? `${model} (not pinged — a reachability test costs a real call)`
104
- : "the host reports NO model: expect every /assistant turn to no-op. Check the `Llm` section of the settings file.",
111
+ detail: model ? modelNotPinged(model) : NO_MODEL,
105
112
  });
106
113
  rows.push({
107
- check: "llm: declared catalogue",
114
+ check: CHECK_LLM_CATALOGUE,
108
115
  result: declared.length > 0 ? PASS : WARN,
109
- detail: declared.length > 0
110
- ? declared.join(", ")
111
- : "no Llm:AvailableModels — /model cannot offer a choice or flag an unserved name",
116
+ detail: declared.length > 0 ? declared.join(", ") : NO_AVAILABLE_MODELS,
112
117
  });
113
118
 
114
119
  // 3. Tool catalogue.
@@ -118,16 +123,16 @@ export async function runDoctor(deps: DoctorDeps): Promise<CommandView> {
118
123
  check: "tools: essential",
119
124
  result: missingEssential.length === 0 ? PASS : FAIL,
120
125
  detail: missingEssential.length === 0
121
- ? `${available.size} registered, all ${ESSENTIAL_TOOLS.length} essentials present`
126
+ ? essentialsPresent(available.size, ESSENTIAL_TOOLS.length)
122
127
  : `MISSING: ${missingEssential.join(", ")}`,
123
128
  });
124
129
  const missingIntel = CODE_INTEL_TOOLS.filter((t) => !available.has(t));
125
130
  rows.push({
126
- check: "tools: code intelligence",
131
+ check: CHECK_CODE_INTEL,
127
132
  result: missingIntel.length === 0 ? PASS : WARN,
128
133
  detail: missingIntel.length === 0
129
134
  ? `all ${CODE_INTEL_TOOLS.length} present`
130
- : `absent: ${missingIntel.join(", ")} — the agent falls back to reading files`,
135
+ : codeIntelAbsent(missingIntel),
131
136
  });
132
137
 
133
138
  // 4. VFS mounts — /workspace read-write is the precondition for everything.
@@ -143,32 +148,46 @@ export async function runDoctor(deps: DoctorDeps): Promise<CommandView> {
143
148
  // /workspace read-WRITE is the precondition for everything the agent does;
144
149
  // a read-only mount would fail every edit with a permissions error later.
145
150
  detail: (described.join(" ") || "(none)") +
146
- (hasWorkspace ? "" : ` ← ${WORKSPACE} is missing or not writable`),
151
+ (hasWorkspace ? "" : workspaceNotWritable(WORKSPACE)),
147
152
  });
148
153
  } catch (e: any) {
149
154
  rows.push({ check: "vfs: mounts", result: WARN, detail: `list_mounts unavailable: ${String(e?.message ?? e).split("\n")[0]}` });
150
155
  }
151
156
 
157
+ // 4b. The host the launcher described (launch.json) and the user's path lists, as every act's callbacks read them:
158
+ // the layout with each mount's base, the lists, and every entry or file they could not read.
159
+ const host = await readHostContext(files, deps.config);
160
+ const lists = [
161
+ ...(host.lists.deny.length > 0 ? [`deny: ${listedEntries(host.lists.deny).join(", ")}`] : []),
162
+ ...(host.lists.allow.length > 0 ? [`allow: ${listedEntries(host.lists.allow).join(", ")}`] : []),
163
+ ];
164
+ rows.push({
165
+ check: "host: paths",
166
+ result: host.problems.length === 0 ? PASS : WARN,
167
+ detail: [
168
+ describeHostLayout(host.layout), ...(lists.length > 0 ? lists : [NO_PATH_LIST]), ...host.problems.map((p) => `⚠ ${p}`),
169
+ ].join("; "),
170
+ });
171
+
152
172
  // 5. Sessions left in the project: the runtime kept them in /workspace/.orkeon/sessions
153
173
  // before the launcher mounted /sessions outside the project (QL-04). Left alone, named here.
154
174
  const inProject = await files.list(OLD_SESSIONS_DIR, 1).catch((): string[] => []);
155
175
  rows.push({
156
- check: "sessions: outside the project",
176
+ check: CHECK_SESSIONS,
157
177
  result: inProject.length === 0 ? PASS : WARN,
158
178
  detail: inProject.length === 0
159
179
  ? "nothing in .orkeon/sessions"
160
- : `${OLD_SESSIONS_DIR} holds sessions of an older start, left alone: sessions now live in the launcher's state folder, outside the project ` +
161
- "(orkeon-code --resume lists them); delete the folder once you no longer need it",
180
+ : oldSessionsLeft(OLD_SESSIONS_DIR),
162
181
  });
163
182
 
164
183
  // 6. What the project file set and could not widen (QL-06): said here as /permissions says it.
165
184
  const ignored: string[] = [];
166
185
  for (const key of knownConfigKeys()) {
167
186
  const r = await deps.config.readValue(key).catch(() => undefined);
168
- if (r?.ignored !== undefined) ignored.push(`the project file sets ${key} '${r.ignored.value}': ignored, ${r.ignored.reason}`);
187
+ if (r?.ignored !== undefined) ignored.push(projectSettingIgnored(key, r.ignored.value, r.ignored.reason));
169
188
  }
170
189
  rows.push({
171
- check: "settings: project file",
190
+ check: CHECK_PROJECT_FILE,
172
191
  result: ignored.length === 0 ? PASS : WARN,
173
192
  detail: ignored.length === 0 ? "widens nothing" : ignored.join("; "),
174
193
  });
@@ -178,9 +197,9 @@ export async function runDoctor(deps: DoctorDeps): Promise<CommandView> {
178
197
  return {
179
198
  table: rows,
180
199
  text: failed > 0
181
- ? `${failed} check(s) FAILED, ${warned} warning(s) — the host is not fully usable.`
200
+ ? checksFailed(failed, warned)
182
201
  : warned > 0
183
- ? `all checks passed, ${warned} warning(s).`
184
- : "all checks passed.",
202
+ ? checksPassedWarned(warned)
203
+ : ALL_CHECKS_PASSED,
185
204
  };
186
205
  }