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
@@ -15,13 +15,20 @@ import {
15
15
  } from "../../../shared/domain/config-schema.ts";
16
16
  import { CONFIG_FILE_PATH, USER_CONFIG_FILE_PATH } from "../../../shared/application/config-store.ts";
17
17
  import type { ConfigStore } from "../../../shared/application/config-store.ts";
18
+ import { readLlmProfile } from "../../../shared/application/llm-profile.ts";
19
+ import type { ReasoningReader } from "../../../shared/application/ports.ts";
20
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
21
+ import { storedEffortWarning } from "./effort.ts";
18
22
  import type { CommandView } from "../view.ts";
19
-
20
- export const CONFIG_USAGE =
21
- "usage: /config [list|keys|get <key>|set [--session] <key> <value>|unset [--session] <key>]";
23
+ import { CONFIG_GET_USAGE, CONFIG_UNSET_USAGE, CONFIG_USAGE, KEYS_NOTE, configFileLine, configFileMalformed, fileValueSet, keyNotInFile, keyRemoved, keyUnset, keyValue, nestedKeys, noSessionOverride, refusingToOverwrite, refusingUnparsed, sessionOverrideRemoved, sessionValueSet, unknownStoredKeys, userSettingsUnparsed, valueIgnored } from "./messages.ts";
24
+ import { unknownConfigKey } from "../../../shared/domain/messages.ts";
22
25
 
23
26
  export interface ConfigDeps {
24
27
  config: ConfigStore;
28
+ /** Where the effort /effort stored is read, once `llm.profile` changed. */
29
+ session?: Pick<SessionIo, "readState">;
30
+ /** What the profile the turns now run on makes of that effort; absent: nothing is said of it. */
31
+ reasoning?: ReasoningReader;
25
32
  }
26
33
 
27
34
  /** `--session` selects the session layer; the default is the persisted file. */
@@ -30,8 +37,20 @@ function takeSessionFlag(tokens: string[]): { session: boolean; rest: string[] }
30
37
  return { session: rest.length !== tokens.length, rest };
31
38
  }
32
39
 
33
- /** `/config [list|keys|get|set|unset] …`, from the command's raw tokens. */
40
+ /** `/config [list|keys|get|set|unset] …`, from the command's raw tokens. A set or an unset that changes the
41
+ * session's `llm.profile` moves its turns onto another model: the answer then warns, as /model does, when the
42
+ * effort /effort stored does not go as asked there. */
34
43
  export async function runConfig(tokens: string[], deps: ConfigDeps): Promise<CommandView> {
44
+ const { session, reasoning, config } = deps;
45
+ if (session === undefined || reasoning === undefined) return applyConfig(tokens, deps);
46
+ const before = (await readLlmProfile(config)).profile;
47
+ const view = await applyConfig(tokens, deps);
48
+ if ((await readLlmProfile(config)).profile === before || view.text === undefined) return view;
49
+ const warning = await storedEffortWarning({ session, config, reasoning });
50
+ return warning === "" ? view : { ...view, text: `${view.text}\n${warning}` };
51
+ }
52
+
53
+ async function applyConfig(tokens: string[], deps: ConfigDeps): Promise<CommandView> {
35
54
  const { config } = deps;
36
55
  const { session: useSession, rest } = takeSessionFlag(tokens);
37
56
  const [sub, key, ...valueParts] = rest;
@@ -39,21 +58,10 @@ export async function runConfig(tokens: string[], deps: ConfigDeps): Promise<Com
39
58
  switch ((sub ?? "list").toLowerCase()) {
40
59
  case "list": {
41
60
  const view = await config.readView();
42
- const notes: string[] = [`file: ${CONFIG_FILE_PATH} — session overrides it until /clear.`];
43
- if (view.unknown.length > 0) {
44
- notes.push(
45
- `⚠ stored but NOT in the key space (pre-B-6 residue, nothing reads them): ${view.unknown.join(", ")}`,
46
- );
47
- }
48
- if (view.nested.length > 0) {
49
- notes.push(
50
- `⚠ written nested, so nothing reads them: ${view.nested.join(", ")} — a settings file holds each key flat ` +
51
- `("${view.nested[0]}": …).`,
52
- );
53
- }
54
- if (view.fileMalformed) {
55
- notes.push(`⚠ ${CONFIG_FILE_PATH} could not be parsed — it is left untouched; fix or delete it.`);
56
- }
61
+ const notes: string[] = [configFileLine(CONFIG_FILE_PATH)];
62
+ if (view.unknown.length > 0) notes.push(unknownStoredKeys(view.unknown));
63
+ if (view.nested.length > 0) notes.push(nestedKeys(view.nested));
64
+ if (view.fileMalformed) notes.push(configFileMalformed(CONFIG_FILE_PATH));
57
65
  return {
58
66
  table: view.entries.map((e) => ({ key: e.key, value: e.value ?? "(unset)", source: e.source })),
59
67
  text: notes.join("\n"),
@@ -67,19 +75,19 @@ export async function runConfig(tokens: string[], deps: ConfigDeps): Promise<Com
67
75
  allowed: s.allowed ? s.allowed.join(" | ") : "(any)",
68
76
  "read by": s.consumedBy,
69
77
  })),
70
- text: "every key names its consumer — a key nothing reads is not settable.",
78
+ text: KEYS_NOTE,
71
79
  };
72
80
 
73
81
  case "get": {
74
- if (!key) return { text: "usage: /config get <key>" };
82
+ if (!key) return { text: CONFIG_GET_USAGE };
75
83
  const spec = configKeySpec(key);
76
- if (!spec) return { text: `unknown config key '${key}'. Valid keys: ${knownConfigKeys().join(", ")}` };
84
+ if (!spec) return { text: unknownConfigKey(key, knownConfigKeys()) };
77
85
  const view = await config.readView();
78
86
  const entry = view.entries.find((e) => e.key === key)!;
79
87
  return {
80
88
  text: entry.value === undefined
81
- ? `${key} is unset (${spec.description})`
82
- : `${key} = ${entry.value} [${entry.source}]`,
89
+ ? keyUnset(key, spec.description)
90
+ : keyValue(key, entry.value, entry.source),
83
91
  };
84
92
  }
85
93
 
@@ -93,46 +101,38 @@ export async function runConfig(tokens: string[], deps: ConfigDeps): Promise<Com
93
101
  const map = await config.readSession();
94
102
  map[key] = value;
95
103
  await config.writeSession(map);
96
- return { text: `${key} = ${value} [session] — overrides the file until /clear.` };
104
+ return { text: sessionValueSet(key, value) };
97
105
  }
98
106
  const { map, malformed } = await config.readFile();
99
107
  if (malformed) {
100
- return {
101
- text: `refusing to write: ${CONFIG_FILE_PATH} exists but could not be parsed, and overwriting it ` +
102
- "would discard whatever it holds. Fix or delete it, then retry.",
103
- };
108
+ return { text: refusingToOverwrite(CONFIG_FILE_PATH) };
104
109
  }
105
110
  map[key] = value;
106
111
  await config.writeFile(map);
107
- const persisted = `${key} = ${value} [file] — persisted in ${CONFIG_FILE_PATH}.`;
112
+ const persisted = fileValueSet(key, value, CONFIG_FILE_PATH);
108
113
  // A project file widens nothing past the user settings (LI-6): the value is kept, and said to be set aside.
109
114
  const { map: user, malformed: userMalformed } = await config.readUserFile();
110
115
  const { ignored } = resolveConfigEntry(key, map, {}, user);
111
116
  if (ignored === undefined) return { text: persisted };
112
- const unread = userMalformed
113
- ? ` The user settings (${USER_CONFIG_FILE_PATH}) could not be parsed: none applies.`
114
- : "";
115
- return {
116
- text: `${persisted}\n↳ ignored: '${ignored.value}': ${ignored.reason}.${unread} A setting of your own goes in ` +
117
- "the orkeonCode block of the user settings file (the one the launcher reads).",
118
- };
117
+ const unread = userMalformed ? userSettingsUnparsed(USER_CONFIG_FILE_PATH) : "";
118
+ return { text: valueIgnored(persisted, ignored.value, ignored.reason, unread) };
119
119
  }
120
120
 
121
121
  case "unset": {
122
- if (!key) return { text: "usage: /config unset [--session] <key>" };
122
+ if (!key) return { text: CONFIG_UNSET_USAGE };
123
123
  if (useSession) {
124
124
  const map = await config.readSession();
125
- if (!(key in map)) return { text: `${key} has no session override.` };
125
+ if (!(key in map)) return { text: noSessionOverride(key) };
126
126
  delete map[key];
127
127
  await config.writeSession(map);
128
- return { text: `${key} session override removed (the file value applies again).` };
128
+ return { text: sessionOverrideRemoved(key) };
129
129
  }
130
130
  const { map, malformed } = await config.readFile();
131
- if (malformed) return { text: `refusing to write: ${CONFIG_FILE_PATH} could not be parsed.` };
132
- if (!(key in map)) return { text: `${key} is not set in ${CONFIG_FILE_PATH}.` };
131
+ if (malformed) return { text: refusingUnparsed(CONFIG_FILE_PATH) };
132
+ if (!(key in map)) return { text: keyNotInFile(key, CONFIG_FILE_PATH) };
133
133
  delete map[key];
134
134
  await config.writeFile(map);
135
- return { text: `${key} removed from ${CONFIG_FILE_PATH}.` };
135
+ return { text: keyRemoved(key, CONFIG_FILE_PATH) };
136
136
  }
137
137
 
138
138
  default:
@@ -0,0 +1,147 @@
1
+ // /effort [<level>|show]: the session's reasoning-effort level. It picks the act() iteration ladder of every later
2
+ // /assistant turn and reaches the provider as `act({effort})`. What the session's model takes, and what the runtime
3
+ // sends for a level it does not take, are read from the runtime (Orkeon #359, #360), never worked out here: the
4
+ // level stored stays the one asked, since the ladder follows it and the model may change.
5
+ import type { Chooser, ReasoningReader } from "../../../shared/application/ports.ts";
6
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
7
+ import { readLlmProfile } from "../../../shared/application/llm-profile.ts";
8
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
9
+ import {
10
+ DEFAULT_EFFORT, EFFORT_LEVELS as LEVELS, EFFORT_MAX_ITERATIONS, providerEffort,
11
+ } from "../../../shared/domain/agent-policy/behavior-flags.ts";
12
+ import type { EffortLevel } from "../../../shared/domain/agent-policy/behavior-flags.ts";
13
+ import type { EffortReport, ReasoningCapabilities, ReasoningTarget } from "../../../shared/domain/agent-policy/reasoning.ts";
14
+ import { EFFORT_STATE_KEY, MODEL_PREFERENCE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
15
+ import type { CommandView } from "../view.ts";
16
+ import { optionsOf } from "./choices.ts";
17
+ import {
18
+ EFFORT_CHOICE, EFFORT_UNCHANGED, NONE_SENT, THINKING_NOT_REQUESTED, actIterations, effortDropped, effortLowered,
19
+ effortSet, effortShown, effortUnchangedNoneStored, effortUnchecked, effortWarning, effortWarningDevSteps, hostAsks, itTakes, modelTakes, sentAs,
20
+ thinkingAt, thinkingDevSteps, unknownEffort,
21
+ } from "./messages.ts";
22
+ import { markedDefault as defaultLevel } from "../messages.ts";
23
+
24
+ export interface EffortDeps {
25
+ session: Pick<SessionIo, "readState" | "writeState">;
26
+ /** Where a bare /effort opens a panel, when it can. */
27
+ chooser?: Chooser;
28
+ /** What the session's model takes and what a level becomes on it; absent, or answering nothing: nothing is said. */
29
+ reasoning?: ReasoningReader;
30
+ /** Where the session's `llm.profile` is read: under a profile, its model is the one judged. */
31
+ config?: Pick<ConfigStore, "readValue" | "readFile">;
32
+ }
33
+
34
+ type TargetDeps = { session: Pick<SessionIo, "readState"> } & Pick<EffortDeps, "config">;
35
+
36
+ /** What the session's turns run on: its `llm.profile`, else its /model override, else the host's own model. */
37
+ async function sessionTarget(deps: TargetDeps): Promise<ReasoningTarget> {
38
+ const [model, profile] = await Promise.all([
39
+ deps.session.readState(MODEL_PREFERENCE_STATE_KEY).catch(() => null),
40
+ deps.config === undefined ? null : readLlmProfile(deps.config).then((read) => read.profile),
41
+ ]);
42
+ return { profile, model: (model ?? "").trim() };
43
+ }
44
+
45
+ /** The host's own model: under a /model override, the dev steps and the sub-agents still run on it. */
46
+ const HOST_TARGET: ReasoningTarget = { profile: null, model: "" };
47
+
48
+ /** Whether the turns run on a /model override: no profile, which would win over it, and a model named. */
49
+ function overridden(target: ReasoningTarget): boolean {
50
+ return target.profile === null && target.model !== "";
51
+ }
52
+
53
+ /** What to say of an effort that does not go as asked; empty when it does, or when the runtime did not say. */
54
+ export function effortNote(report: EffortReport | null, capabilities: ReasoningCapabilities | null): string {
55
+ if (report === null || report.notice === null) return "";
56
+ if (report.notice === "unchecked") return effortUnchecked(report.model, report.asked);
57
+ const takes = capabilities !== null && capabilities.known ? itTakes(capabilities.efforts) : "";
58
+ if (report.sent !== null) return effortLowered(report.model, report.asked, report.sent) + takes;
59
+ // A level the model takes is dropped by the provider or the host's settings (its thinking switched off): the
60
+ // model's levels would read as the cause, so they are left out.
61
+ const taken = capabilities !== null && capabilities.efforts.includes(report.asked);
62
+ return effortDropped(report.model, report.asked) + (taken ? "" : takes);
63
+ }
64
+
65
+ /** `effortNote` without the model the table does not know: that one is `show`'s to say, since most hosts serve
66
+ * some. */
67
+ export function effortWarningNote(report: EffortReport | null, capabilities: ReasoningCapabilities | null): string {
68
+ return report?.notice === "unchecked" ? "" : effortNote(report, capabilities);
69
+ }
70
+
71
+ /** The warning lines for the effort the session stored, on what it reaches; empty when no level is stored or the
72
+ * level goes out as asked, checked or not. The turns of /assistant run on the session's target; under a /model
73
+ * override the dev steps and the sub-agents still run on the host's own model, so that one is judged too, and
74
+ * said when its line differs. /model says it after a switch. */
75
+ export async function storedEffortWarning(deps: TargetDeps & Pick<EffortDeps, "reasoning">): Promise<string> {
76
+ const { reasoning } = deps;
77
+ if (reasoning === undefined) return "";
78
+ const level = providerEffort(await deps.session.readState(EFFORT_STATE_KEY).catch(() => null));
79
+ if (level === undefined) return "";
80
+ const target = await sessionTarget(deps);
81
+ const targets = overridden(target) ? [target, HOST_TARGET] : [target];
82
+ const [turns, devSteps] = targets.map((each) => effortWarningNote(reasoning.effort(each, level), reasoning.capabilities(each)));
83
+ const lines = [turns === "" ? "" : effortWarning(turns)];
84
+ if (devSteps !== undefined && devSteps !== "" && devSteps !== turns) lines.push(effortWarningDevSteps(devSteps));
85
+ return lines.filter((line) => line !== "").join("\n");
86
+ }
87
+
88
+ /** The thinking line of `show`: the level asked, then what does not go as asked, else the levels the model takes.
89
+ * Under a /model override, a second line for the host's own model, which the dev steps and the sub-agents keep,
90
+ * when the level (the one stored, else the host's own) does not go as asked there and not the way the first says. */
91
+ function thinkingShown(stored: EffortLevel | undefined, reasoning: ReasoningReader | undefined, target: ReasoningTarget): string {
92
+ const capabilities = reasoning?.capabilities(target) ?? null;
93
+ const takes = capabilities !== null && capabilities.known ? `; ${modelTakes(capabilities.model, capabilities.efforts)}` : "";
94
+ // With no level stored, the host's own `Llm:Thinking:Effort` goes out on every call all the same.
95
+ const report = reasoning?.effort(target, stored ?? null) ?? null;
96
+ const note = effortNote(report, capabilities);
97
+ const asked = stored !== undefined ? thinkingAt(stored) : report === null ? THINKING_NOT_REQUESTED : hostAsks(report.asked);
98
+ const line = asked + (note === "" ? takes : ` — ${note}`);
99
+ if (reasoning === undefined || !overridden(target)) return line;
100
+ const hostNote = effortNote(reasoning.effort(HOST_TARGET, stored ?? null), reasoning.capabilities(HOST_TARGET));
101
+ return hostNote === "" || hostNote === note ? line : line + thinkingDevSteps(hostNote);
102
+ }
103
+
104
+ /** What a level of the panel becomes on the session's model, after its iterations; empty when it goes as asked. */
105
+ function becomes(report: EffortReport | null): string {
106
+ if (report === null || report.notice === null || report.notice === "unchecked") return "";
107
+ return report.sent === null ? NONE_SENT : sentAs(report.sent);
108
+ }
109
+
110
+ /** `/effort [<level>|show]`, from the command's raw tokens. No argument opens a panel, or without one shows the level,
111
+ * as `show` does. */
112
+ export async function runEffort(tokens: string[], deps: EffortDeps): Promise<CommandView> {
113
+ const requested = (tokens[0] ?? "").toLowerCase();
114
+ if (!requested || requested === "show") {
115
+ const stored = await deps.session.readState(EFFORT_STATE_KEY).catch(() => null);
116
+ const target = await sessionTarget(deps);
117
+ if (!requested && deps.chooser?.interactive) {
118
+ const answer = await deps.chooser.choose({
119
+ message: EFFORT_CHOICE,
120
+ options: LEVELS.map((level) => ({
121
+ ...optionsOf([level], stored ?? DEFAULT_EFFORT)[0],
122
+ description: actIterations(EFFORT_MAX_ITERATIONS[level]) + becomes(deps.reasoning?.effort(target, level) ?? null),
123
+ })),
124
+ });
125
+ if (!answer) return { text: EFFORT_UNCHANGED };
126
+ // Confirming the level marked changes nothing: with none stored, it would ask the provider for thinking.
127
+ if (answer.value === (stored ?? DEFAULT_EFFORT)) {
128
+ return {
129
+ text: stored ? EFFORT_UNCHANGED : effortUnchangedNoneStored(answer.value),
130
+ };
131
+ }
132
+ return runEffort([answer.value], { ...deps, chooser: undefined });
133
+ }
134
+ const level = stored ?? defaultLevel(DEFAULT_EFFORT);
135
+ const ladder = LEVELS.map((l) => `${l}=${EFFORT_MAX_ITERATIONS[l]}`).join(", ");
136
+ return { text: effortShown(level, ladder, thinkingShown(providerEffort(stored), deps.reasoning, target), LEVELS) };
137
+ }
138
+ if (!LEVELS.includes(requested as (typeof LEVELS)[number])) {
139
+ return { text: unknownEffort(requested, LEVELS) };
140
+ }
141
+ await deps.session.writeState(EFFORT_STATE_KEY, requested);
142
+ // Says what it buys: the iterations, and the provider's thinking at that level; then what the session's model
143
+ // makes of that level, when it does not take it.
144
+ const warning = await storedEffortWarning(deps);
145
+ const text = effortSet(requested, EFFORT_MAX_ITERATIONS[requested as (typeof LEVELS)[number]]);
146
+ return { text: warning === "" ? text : `${text}\n${warning}` };
147
+ }
@@ -1,23 +1,18 @@
1
1
  // /hooks — the session's hook registry (session state): list, add, remove. The dev steps (/dev-spec, /dev-plan and
2
2
  // /dev-batches, and a /tasks repair) hand it to their crew, whose tool callbacks
3
- // (shared/application/dev/tool-callbacks.ts) run each pre-tool hook before a model's tool call the gate allowed
4
- // (a failing hook refuses the call) and each post-tool hook after it (a failing one adds a line to the result). The
3
+ // (shared/application/dev/tool-callbacks.ts) run each pre-tool hook before a model's tool call, ahead of the host's gate
4
+ // (Orkeon #303; a failing hook refuses the call) and each post-tool hook after it (a failing one adds a line to the result). The
5
5
  // assistant does not run them yet, and nothing runs a stop hook. Not a command file: the loader reads *.cmd.ts only.
6
6
  import type { SessionStore } from "../../../shared/application/ports.ts";
7
7
  import { readJsonArray, writeJson } from "../../../shared/application/session-state.ts";
8
8
  import { shellOperatorIn } from "../../../shared/domain/dev/call-guard.ts";
9
9
  import { HOOKS_STATE_KEY } from "../../../shared/domain/session-keys.ts";
10
+ import {
11
+ HOOKS_STATUS, HOOKS_USAGE, NO_HOOKS, hookAdded, hookOperatorRefused, hookRemoved, hooksAddUsage, hooksRemoveUsage,
12
+ } from "./messages.ts";
10
13
 
11
14
  export const HOOK_EVENTS = ["pre-tool", "post-tool", "stop"] as const;
12
15
 
13
- /** Where the hooks run, said on every listing: a populated registry is exactly when someone
14
- * believes they all run. */
15
- export const HOOKS_STATUS =
16
- "pre-tool and post-tool hooks run around each tool call the model makes in the dev steps (/dev-spec, " +
17
- "/dev-plan, /dev-batches) and a /tasks repair (a failing pre-tool hook refuses the call); " +
18
- "the assistant does not run " +
19
- "them yet, and no stop hook runs.";
20
-
21
16
  export interface HookRow { n: number; event: string; command: string }
22
17
 
23
18
  /** What /hooks shows: a table of the hooks when it lists some, then its text. */
@@ -28,31 +23,28 @@ export async function runHooks(tokens: readonly string[], session: Pick<SessionS
28
23
  const hooks = (await readJsonArray(session, HOOKS_STATE_KEY)) as Array<{ event: string; command: string }>;
29
24
  switch ((sub ?? "list").toLowerCase()) {
30
25
  case "list":
31
- if (hooks.length === 0) return { text: `no hooks configured. usage: /hooks add <pre-tool|post-tool|stop> <command>\n${HOOKS_STATUS}` };
26
+ if (hooks.length === 0) return { text: NO_HOOKS };
32
27
  return { table: hooks.map((h, i) => ({ n: i + 1, event: h.event, command: h.command })), text: HOOKS_STATUS };
33
28
  case "add": {
34
29
  const command = rest.join(" ");
35
- if (!(HOOK_EVENTS as readonly string[]).includes(String(event)) || !command) return { text: `usage: /hooks add <${HOOK_EVENTS.join("|")}> <command>` };
30
+ if (!(HOOK_EVENTS as readonly string[]).includes(String(event)) || !command) return { text: hooksAddUsage(HOOK_EVENTS) };
36
31
  // The shell tool runs one program and its arguments: the hook would fail at every call.
37
32
  const operator = shellOperatorIn(command);
38
33
  if (operator !== undefined) {
39
- return {
40
- text: `refused: the command holds '${operator.replace(/\n/g, "\\n")}', which the shell tool refuses: a hook is one program ` +
41
- "and its arguments. Put the steps in a script: /hooks add pre-tool node .orkeon/hooks/pre.mjs {tool} {path}",
42
- };
34
+ return { text: hookOperatorRefused(operator.replace(/\n/g, "\\n")) };
43
35
  }
44
36
  hooks.push({ event, command });
45
37
  await writeJson(session, HOOKS_STATE_KEY, hooks);
46
- return { text: `hook #${hooks.length} added on '${event}' (/clear clears). ${HOOKS_STATUS}` };
38
+ return { text: hookAdded(hooks.length, event) };
47
39
  }
48
40
  case "remove": {
49
41
  const n = Number(event);
50
- if (!Number.isInteger(n) || n < 1 || n > hooks.length) return { text: `usage: /hooks remove <1-${hooks.length || 1}>` };
42
+ if (!Number.isInteger(n) || n < 1 || n > hooks.length) return { text: hooksRemoveUsage(hooks.length || 1) };
51
43
  hooks.splice(n - 1, 1);
52
44
  await writeJson(session, HOOKS_STATE_KEY, hooks);
53
- return { text: `hook #${n} removed.` };
45
+ return { text: hookRemoved(n) };
54
46
  }
55
47
  default:
56
- return { text: "usage: /hooks [list|add <event> <command>|remove <n>]" };
48
+ return { text: HOOKS_USAGE };
57
49
  }
58
50
  }