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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (440) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +206 -11
  13. package/orkeon-code.ps1 +109 -7
  14. package/package.json +2 -1
  15. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  16. package/src/commands/_lib/args.ts +5 -4
  17. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  18. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  19. package/src/commands/_lib/dev/dev-source.ts +7 -11
  20. package/src/commands/_lib/dev/dev.ts +34 -37
  21. package/src/commands/_lib/dev/markers.ts +7 -0
  22. package/src/commands/_lib/dev/messages.ts +112 -0
  23. package/src/commands/_lib/dev-step.ts +16 -13
  24. package/src/commands/_lib/dispatch.ts +62 -39
  25. package/src/commands/_lib/git/branch.ts +9 -10
  26. package/src/commands/_lib/git/commit.ts +9 -13
  27. package/src/commands/_lib/git/diff.ts +22 -12
  28. package/src/commands/_lib/git/messages.ts +54 -0
  29. package/src/commands/_lib/git/review.ts +9 -10
  30. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  31. package/src/commands/_lib/memory/memory.ts +3 -2
  32. package/src/commands/_lib/memory/messages.ts +32 -0
  33. package/src/commands/_lib/messages.ts +48 -0
  34. package/src/commands/_lib/project/messages.ts +8 -0
  35. package/src/commands/_lib/session/export.ts +3 -2
  36. package/src/commands/_lib/session/messages.ts +87 -0
  37. package/src/commands/_lib/session/prompts.ts +4 -0
  38. package/src/commands/_lib/session/resume.ts +15 -24
  39. package/src/commands/_lib/session/tasks.ts +20 -23
  40. package/src/commands/_lib/settings/advisor.ts +11 -16
  41. package/src/commands/_lib/settings/agents.ts +18 -28
  42. package/src/commands/_lib/settings/choices.ts +8 -0
  43. package/src/commands/_lib/settings/config.ts +43 -43
  44. package/src/commands/_lib/settings/effort.ts +147 -0
  45. package/src/commands/_lib/settings/hooks.ts +12 -20
  46. package/src/commands/_lib/settings/messages.ts +408 -0
  47. package/src/commands/_lib/settings/mode.ts +33 -24
  48. package/src/commands/_lib/settings/model.ts +71 -36
  49. package/src/commands/_lib/settings/output-style.ts +39 -0
  50. package/src/commands/_lib/settings/permissions.ts +71 -93
  51. package/src/commands/_lib/settings/route.ts +63 -0
  52. package/src/commands/_lib/settings/skills.ts +53 -11
  53. package/src/commands/_lib/settings/theme.ts +42 -0
  54. package/src/commands/_lib/speech/messages.ts +58 -0
  55. package/src/commands/_lib/speech/prompts.ts +4 -0
  56. package/src/commands/_lib/speech/say.ts +9 -10
  57. package/src/commands/_lib/speech/transcribe.ts +14 -23
  58. package/src/commands/_lib/speech/voice.ts +14 -18
  59. package/src/commands/_lib/status/doctor.ts +47 -28
  60. package/src/commands/_lib/status/messages.ts +100 -0
  61. package/src/commands/_lib/status/meta.ts +3 -24
  62. package/src/commands/_lib/status/status.ts +10 -11
  63. package/src/commands/_lib/status/usage-tools.ts +2 -3
  64. package/src/commands/_lib/status/usage.ts +7 -18
  65. package/src/commands/_lib/view.ts +6 -1
  66. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  67. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  68. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  69. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  70. package/src/commands/git/commit.cmd.ts +3 -3
  71. package/src/commands/git/review.cmd.ts +3 -3
  72. package/src/commands/memory/memory.cmd.ts +2 -2
  73. package/src/commands/project/analyze.cmd.ts +3 -3
  74. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  75. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  76. package/src/commands/project/init.cmd.ts +3 -3
  77. package/src/commands/project/verify.cmd.ts +2 -2
  78. package/src/commands/session/assistant.cmd.ts +2 -2
  79. package/src/commands/session/compact.cmd.ts +1 -1
  80. package/src/commands/session/copy.cmd.ts +8 -7
  81. package/src/commands/session/rename.cmd.ts +3 -2
  82. package/src/commands/session/rewind.cmd.ts +3 -4
  83. package/src/commands/session/summary.cmd.ts +3 -3
  84. package/src/commands/session/tasks.cmd.ts +4 -2
  85. package/src/commands/settings/config.cmd.ts +4 -2
  86. package/src/commands/settings/effort.cmd.ts +10 -31
  87. package/src/commands/settings/fast.cmd.ts +2 -1
  88. package/src/commands/settings/mode.cmd.ts +3 -3
  89. package/src/commands/settings/model.cmd.ts +3 -2
  90. package/src/commands/settings/output-style.cmd.ts +9 -38
  91. package/src/commands/settings/permissions.cmd.ts +2 -2
  92. package/src/commands/settings/proactive.cmd.ts +2 -1
  93. package/src/commands/settings/route.cmd.ts +16 -0
  94. package/src/commands/settings/skills.cmd.ts +3 -3
  95. package/src/commands/settings/theme.cmd.ts +14 -0
  96. package/src/commands/speech/say.cmd.ts +2 -2
  97. package/src/commands/speech/transcribe.cmd.ts +2 -2
  98. package/src/commands/status/release-notes.cmd.ts +1 -1
  99. package/src/crews/.orkeon/orkeon.d.ts +538 -93
  100. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  101. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  102. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  103. package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
  104. package/src/crews/advisor/application/messages.ts +4 -0
  105. package/src/crews/advisor/application/prompts.ts +4 -0
  106. package/src/crews/advisor/application/run-advisor.ts +2 -1
  107. package/src/crews/advisor/crew.ork.ts +5 -4
  108. package/src/crews/advisor/domain/advice.ts +7 -23
  109. package/src/crews/advisor/domain/messages.ts +8 -0
  110. package/src/crews/advisor/domain/prompts.ts +26 -0
  111. package/src/crews/agent-run/application/messages.ts +18 -0
  112. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  113. package/src/crews/agent-run/crew.ork.ts +3 -3
  114. package/src/crews/analyze/application/messages.ts +27 -0
  115. package/src/crews/analyze/application/prompts.ts +4 -0
  116. package/src/crews/analyze/application/run-analyze.ts +16 -14
  117. package/src/crews/analyze/crew.ork.ts +5 -4
  118. package/src/crews/analyze/domain/harvest.ts +33 -65
  119. package/src/crews/analyze/domain/prompts.ts +86 -0
  120. package/src/crews/code-review/application/lens-material.ts +24 -0
  121. package/src/crews/code-review/application/messages.ts +17 -0
  122. package/src/crews/code-review/application/prompts.ts +10 -17
  123. package/src/crews/code-review/application/review.ts +4 -1
  124. package/src/crews/code-review/application/run-code-review.ts +13 -15
  125. package/src/crews/code-review/crew.ork.ts +5 -4
  126. package/src/crews/code-review/domain/lenses.ts +6 -45
  127. package/src/crews/code-review/domain/messages.ts +25 -0
  128. package/src/crews/code-review/domain/prompts.ts +58 -0
  129. package/src/crews/code-review/domain/report.ts +5 -6
  130. package/src/crews/code-review/domain/scope.ts +6 -12
  131. package/src/crews/dev-batches/application/messages.ts +127 -0
  132. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  133. package/src/crews/dev-batches/application/prompts.ts +10 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  135. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  136. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  137. package/src/crews/dev-batches/crew.ork.ts +12 -9
  138. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  139. package/src/crews/dev-batches/domain/markers.ts +5 -0
  140. package/src/crews/dev-batches/domain/messages.ts +6 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  142. package/src/crews/dev-change/application/change-material.ts +44 -0
  143. package/src/crews/dev-change/application/evidence.ts +25 -22
  144. package/src/crews/dev-change/application/messages.ts +81 -0
  145. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  146. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  147. package/src/crews/dev-change/crew.ork.ts +11 -9
  148. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  149. package/src/crews/dev-change/domain/change-render.ts +13 -15
  150. package/src/crews/dev-change/domain/markers.ts +28 -0
  151. package/src/crews/dev-change/domain/messages.ts +16 -0
  152. package/src/crews/dev-implement/application/close.ts +21 -18
  153. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  154. package/src/crews/dev-implement/application/messages.ts +161 -0
  155. package/src/crews/dev-implement/application/observe.ts +4 -2
  156. package/src/crews/dev-implement/application/prompts.ts +9 -0
  157. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  158. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  159. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  160. package/src/crews/dev-implement/crew.ork.ts +2 -1
  161. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  162. package/src/crews/dev-implement/domain/correction.ts +16 -15
  163. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  164. package/src/crews/dev-implement/domain/markers.ts +23 -0
  165. package/src/crews/dev-implement/domain/messages.ts +58 -0
  166. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  167. package/src/crews/dev-implement/domain/roles.ts +3 -7
  168. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  169. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  170. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  171. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  172. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  173. package/src/crews/dev-learn/application/messages.ts +51 -0
  174. package/src/crews/dev-learn/application/{learn-prompt.ts → prompts.ts} +24 -65
  175. package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
  176. package/src/crews/dev-learn/crew.ork.ts +4 -3
  177. package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
  178. package/src/crews/dev-learn/domain/messages.ts +65 -0
  179. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  180. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  181. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  182. package/src/crews/dev-plan/application/inventory.ts +17 -13
  183. package/src/crews/dev-plan/application/messages.ts +88 -0
  184. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  185. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  186. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  187. package/src/crews/dev-plan/crew.ork.ts +11 -8
  188. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  189. package/src/crews/dev-plan/domain/markers.ts +18 -0
  190. package/src/crews/dev-plan/domain/messages.ts +118 -0
  191. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  192. package/src/crews/dev-plan/domain/plan-render.ts +30 -31
  193. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  194. package/src/crews/dev-spec/application/messages.ts +30 -0
  195. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  196. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  197. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  198. package/src/crews/dev-spec/crew.ork.ts +11 -9
  199. package/src/crews/dev-spec/domain/markers.ts +30 -0
  200. package/src/crews/dev-spec/domain/messages.ts +39 -0
  201. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  202. package/src/crews/dev-spec/domain/spec-render.ts +18 -18
  203. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  204. package/src/crews/dev-verify/application/audit.ts +38 -30
  205. package/src/crews/dev-verify/application/capture.ts +34 -26
  206. package/src/crews/dev-verify/application/messages.ts +119 -0
  207. package/src/crews/dev-verify/application/prompts.ts +209 -0
  208. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  209. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  210. package/src/crews/dev-verify/crew.ork.ts +6 -6
  211. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  212. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  213. package/src/crews/dev-verify/domain/commands.ts +3 -3
  214. package/src/crews/dev-verify/domain/gate.ts +21 -16
  215. package/src/crews/dev-verify/domain/markers.ts +16 -0
  216. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  217. package/src/crews/dev-verify/domain/messages.ts +92 -0
  218. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  219. package/src/crews/git-commit/application/draft.ts +16 -37
  220. package/src/crews/git-commit/application/messages.ts +15 -0
  221. package/src/crews/git-commit/application/prompts.ts +47 -0
  222. package/src/crews/git-commit/application/run-git-commit.ts +13 -12
  223. package/src/crews/git-commit/crew.ork.ts +5 -4
  224. package/src/crews/git-commit/domain/commit.ts +15 -35
  225. package/src/crews/git-commit/domain/markers.ts +4 -0
  226. package/src/crews/git-commit/domain/messages.ts +48 -0
  227. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  228. package/src/crews/init-verifiers/application/messages.ts +13 -0
  229. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  230. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  231. package/src/crews/init-verifiers/crew.ork.ts +5 -4
  232. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  233. package/src/crews/main-loop/application/messages.ts +81 -0
  234. package/src/crews/main-loop/application/prompts.ts +12 -0
  235. package/src/crews/main-loop/application/run-main-loop.ts +63 -30
  236. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  237. package/src/crews/main-loop/crew.ork.ts +12 -7
  238. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  239. package/src/crews/main-loop/domain/prompts.ts +336 -0
  240. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  241. package/src/crews/project-init/application/detect.ts +5 -4
  242. package/src/crews/project-init/application/messages.ts +15 -0
  243. package/src/crews/project-init/application/prompts.ts +11 -7
  244. package/src/crews/project-init/crew.ork.ts +5 -4
  245. package/src/crews/project-init/domain/existing-files.ts +6 -4
  246. package/src/crews/project-init/domain/messages.ts +13 -0
  247. package/src/crews/project-init/domain/package-map.ts +3 -3
  248. package/src/crews/project-init/domain/prompts.ts +10 -0
  249. package/src/crews/session-compact/application/prompts.ts +5 -0
  250. package/src/crews/session-compact/crew.ork.ts +5 -4
  251. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  252. package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
  253. package/src/crews/speech/application/messages.ts +3 -0
  254. package/src/crews/speech/application/prompts.ts +3 -0
  255. package/src/crews/speech/application/run-speech.ts +2 -1
  256. package/src/crews/speech/crew.ork.ts +2 -1
  257. package/src/shared/application/agents/child-agent.ts +11 -7
  258. package/src/shared/application/agents/messages.ts +35 -0
  259. package/src/shared/application/agents/route-agent.ts +115 -0
  260. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  261. package/src/shared/application/compaction/compact-session.ts +19 -14
  262. package/src/shared/application/compaction/messages.ts +20 -0
  263. package/src/shared/application/compaction/prune-context.ts +94 -0
  264. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  265. package/src/shared/application/dev/brief-inventory.ts +6 -4
  266. package/src/shared/application/dev/close-batch.ts +9 -7
  267. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  268. package/src/shared/application/dev/learn-decision.ts +20 -18
  269. package/src/shared/application/dev/load-dev-context.ts +7 -8
  270. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  271. package/src/shared/application/dev/messages.ts +132 -0
  272. package/src/shared/application/dev/phase-timer.ts +54 -0
  273. package/src/shared/application/dev/plan-source.ts +12 -8
  274. package/src/shared/application/dev/preflight.ts +8 -8
  275. package/src/shared/application/dev/prompts.ts +34 -0
  276. package/src/shared/application/dev/question-round.ts +25 -17
  277. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  278. package/src/shared/application/dev/settle-questions.ts +4 -2
  279. package/src/shared/application/dev/source-review.ts +12 -8
  280. package/src/shared/application/dev/source-step.ts +12 -10
  281. package/src/shared/application/dev/spend.ts +17 -4
  282. package/src/shared/application/dev/step-precedents.ts +2 -1
  283. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  284. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  285. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  286. package/src/shared/application/dev/verdict-sources.ts +5 -3
  287. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  288. package/src/shared/application/extra-tools.ts +2 -1
  289. package/src/shared/application/git/batch-worktree.ts +22 -17
  290. package/src/shared/application/git/commit-files.ts +24 -19
  291. package/src/shared/application/git/merge-batch.ts +11 -7
  292. package/src/shared/application/git/messages.ts +75 -0
  293. package/src/shared/application/git/open-pull-request.ts +4 -3
  294. package/src/shared/application/host-context.ts +59 -0
  295. package/src/shared/application/host-layout-store.ts +45 -0
  296. package/src/shared/application/llm-profile.ts +4 -3
  297. package/src/shared/application/messages.ts +14 -0
  298. package/src/shared/application/permission-rules.ts +10 -0
  299. package/src/shared/application/ports/decision.ts +14 -0
  300. package/src/shared/application/ports/human.ts +25 -0
  301. package/src/shared/application/ports/llm.ts +32 -3
  302. package/src/shared/application/ports/memory.ts +1 -1
  303. package/src/shared/application/ports/theme.ts +11 -0
  304. package/src/shared/application/ports.ts +4 -2
  305. package/src/shared/application/session-io.ts +2 -1
  306. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  307. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  308. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  309. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  310. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  311. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  312. package/src/shared/application/shared-memory/messages.ts +63 -0
  313. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  314. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  315. package/src/shared/application/skills/messages.ts +4 -0
  316. package/src/shared/application/skills/suggest-skills.ts +102 -0
  317. package/src/shared/application/workflow/messages.ts +8 -0
  318. package/src/shared/application/workflow/workflow-state.ts +7 -6
  319. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  320. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  321. package/src/shared/domain/agent-policy/messages.ts +66 -0
  322. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  323. package/src/shared/domain/agent-policy/permission.ts +20 -18
  324. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  325. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  326. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  327. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  328. package/src/shared/domain/agent-registry.ts +6 -5
  329. package/src/shared/domain/agents/chain.ts +2 -2
  330. package/src/shared/domain/agents/charter.ts +8 -5
  331. package/src/shared/domain/agents/exclusive.ts +2 -1
  332. package/src/shared/domain/agents/instances.ts +18 -15
  333. package/src/shared/domain/agents/messages.ts +39 -0
  334. package/src/shared/domain/agents/model-route.ts +199 -0
  335. package/src/shared/domain/agents/prompts.ts +20 -0
  336. package/src/shared/domain/code-intel-contract.ts +5 -4
  337. package/src/shared/domain/code-intel-routing.ts +8 -61
  338. package/src/shared/domain/compact-outcome.ts +5 -3
  339. package/src/shared/domain/compaction-thresholds.ts +2 -1
  340. package/src/shared/domain/compaction.ts +22 -113
  341. package/src/shared/domain/config-schema.ts +94 -81
  342. package/src/shared/domain/context-prune.ts +176 -0
  343. package/src/shared/domain/decision/questions.ts +102 -0
  344. package/src/shared/domain/dev/access-cost.ts +19 -15
  345. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  346. package/src/shared/domain/dev/build-commands.ts +5 -4
  347. package/src/shared/domain/dev/call-guard.ts +29 -28
  348. package/src/shared/domain/dev/carried-text.ts +3 -5
  349. package/src/shared/domain/dev/learn-proposals.ts +5 -4
  350. package/src/shared/domain/dev/learn-state.ts +3 -2
  351. package/src/shared/domain/dev/markers.ts +107 -0
  352. package/src/shared/domain/dev/messages.ts +259 -0
  353. package/src/shared/domain/dev/phase-timing.ts +50 -0
  354. package/src/shared/domain/dev/plan-checks.ts +24 -23
  355. package/src/shared/domain/dev/plan-format.ts +14 -24
  356. package/src/shared/domain/dev/project-files.ts +1 -15
  357. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  358. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  359. package/src/shared/domain/dev/questions.ts +33 -15
  360. package/src/shared/domain/dev/repo-pack.ts +12 -9
  361. package/src/shared/domain/dev/review-answer.ts +40 -17
  362. package/src/shared/domain/dev/review-brief.ts +54 -0
  363. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  364. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  365. package/src/shared/domain/dev/spec-format.ts +13 -14
  366. package/src/shared/domain/dev/step-budget.ts +4 -2
  367. package/src/shared/domain/dev/step-rules.ts +3 -4
  368. package/src/shared/domain/dev/test-commands.ts +14 -10
  369. package/src/shared/domain/dev/tool-guards.ts +4 -3
  370. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  371. package/src/shared/domain/dev/verdict-format.ts +14 -21
  372. package/src/shared/domain/dev/whitespace.ts +3 -2
  373. package/src/shared/domain/dev/work-folder.ts +4 -3
  374. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  375. package/src/shared/domain/error-text.ts +13 -0
  376. package/src/shared/domain/git/close.ts +5 -4
  377. package/src/shared/domain/git/messages.ts +20 -0
  378. package/src/shared/domain/git/pull-request.ts +5 -5
  379. package/src/shared/domain/host-layout.ts +147 -0
  380. package/src/shared/domain/host-paths.ts +399 -0
  381. package/src/shared/domain/llm-failure.ts +35 -7
  382. package/src/shared/domain/llm-profile.ts +22 -3
  383. package/src/shared/domain/marked-message.ts +1 -5
  384. package/src/shared/domain/markers.ts +30 -0
  385. package/src/shared/domain/messages.ts +291 -0
  386. package/src/shared/domain/model-catalog.ts +2 -9
  387. package/src/shared/domain/permission-modes.ts +4 -8
  388. package/src/shared/domain/prelude.ts +2 -2
  389. package/src/shared/domain/project-manifests.ts +3 -2
  390. package/src/shared/domain/prompts.ts +233 -0
  391. package/src/shared/domain/search-routing.ts +3 -11
  392. package/src/shared/domain/secret-patterns.ts +3 -2
  393. package/src/shared/domain/session-keys.ts +7 -0
  394. package/src/shared/domain/session-start.ts +3 -2
  395. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  396. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  397. package/src/shared/domain/shared-memory/entry.ts +26 -20
  398. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  399. package/src/shared/domain/shared-memory/gate.ts +4 -3
  400. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  401. package/src/shared/domain/shared-memory/layout.ts +11 -8
  402. package/src/shared/domain/shared-memory/markers.ts +9 -0
  403. package/src/shared/domain/shared-memory/messages.ts +66 -0
  404. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  405. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  406. package/src/shared/domain/shared-memory/refused.ts +3 -3
  407. package/src/shared/domain/skills/prompts.ts +4 -0
  408. package/src/shared/domain/skills/shortlist.ts +149 -0
  409. package/src/shared/domain/snip-turns.ts +2 -14
  410. package/src/shared/domain/speech.ts +2 -1
  411. package/src/shared/domain/tool-trace.ts +5 -7
  412. package/src/shared/domain/verifiers.ts +7 -11
  413. package/src/shared/domain/vfs.ts +8 -1
  414. package/src/shared/domain/workflow/prompts.ts +15 -0
  415. package/src/shared/domain/workflow/state-file.ts +14 -12
  416. package/src/shared/infrastructure/globals.ts +7 -2
  417. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  418. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  419. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  420. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  421. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  422. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  423. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  424. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  425. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  426. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  427. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  428. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  429. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  430. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  431. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  432. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  433. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  434. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  435. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  436. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  437. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  438. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  439. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  440. package/src/shared/domain/session-summary.ts +0 -13
@@ -1,58 +1,70 @@
1
1
  // The session-default permission mode: the mode a prompt runs in when it carries
2
2
  // no explicit "mode:" prefix, persisted in the session state bag (survives crew
3
- // runs; /clear restores "default"). /mode cycles, shows or sets it; typed by its
3
+ // runs; /clear restores "default"). /mode offers, cycles, shows or sets it; typed by its
4
4
  // alias /plan, it toggles it in and out of plan.
5
5
 
6
- import type { Logger } from "../../../shared/application/ports.ts";
6
+ import type { Chooser, Logger } from "../../../shared/application/ports.ts";
7
7
  import type { SessionIo } from "../../../shared/application/session-io.ts";
8
8
  import { PERMISSION_MODES, isPermissionMode, getNextPermissionMode } from "../../../shared/domain/permission-modes.ts";
9
9
  import { DEFAULT_MODE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
10
10
  import { policyFor } from "../../../shared/domain/agent-policy/mode-policy.ts";
11
11
  import type { CommandView } from "../view.ts";
12
+ import {
13
+ LEAVING_PLAN, MODE_CHOICE, MODE_DESCRIPTIONS, MODE_SET_TO, PLAN_OFF, PLAN_ON, enteringReadOnly, modeApplied,
14
+ modeCycled, modeShown, modeUnchanged, unknownMode,
15
+ } from "./messages.ts";
12
16
 
13
17
  export interface ModeDeps {
14
18
  session: Pick<SessionIo, "resolveEffectiveSessionMode" | "readState" | "writeState">;
15
19
  log: Pick<Logger, "info">;
20
+ /** Where a bare /mode opens a panel, when it can. */
21
+ chooser?: Chooser;
16
22
  }
17
23
 
18
24
  /** Persist + announce a mode transition; logs the read-only catalogue strip (E-12). */
19
25
  async function applyMode(deps: ModeDeps, next: string, how: string): Promise<CommandView> {
20
26
  await deps.session.writeState(DEFAULT_MODE_STATE_KEY, next);
21
27
  if (policyFor(next).readOnly) {
22
- deps.log.info(`entering '${next}': the edit, network and shell tools stripped from the catalogue`);
28
+ deps.log.info(enteringReadOnly(next));
23
29
  }
24
- return {
25
- text: `session default permission mode ${how} '${next}' ` +
26
- `(prompts without a "mode:" prefix now run in it; /clear restores 'default').`,
27
- };
30
+ return { text: modeApplied(how, next) };
28
31
  }
29
32
 
30
- /** `/mode [<mode>|show]`, from the command's raw tokens. No argument CYCLES to the
33
+ /** `/mode [<mode>|show]`, from the command's raw tokens. No argument opens a panel, or without one CYCLES to the
31
34
  * next mode (E-12 — the original's Shift+Tab rotation); `show` displays without
32
35
  * changing. Typed by its alias (`typed` "plan"), it toggles plan mode instead. */
33
36
  export async function runMode(tokens: string[], deps: ModeDeps, typed = "mode"): Promise<CommandView> {
34
37
  if (typed === "plan") return runPlanToggle(deps);
35
38
  const requested = (tokens[0] ?? "").trim();
39
+ if (!requested && deps.chooser?.interactive) {
40
+ const { mode: current } = await deps.session.resolveEffectiveSessionMode();
41
+ const answer = await deps.chooser.choose({
42
+ message: MODE_CHOICE,
43
+ options: PERMISSION_MODES.map((mode) => ({
44
+ value: mode,
45
+ description: MODE_DESCRIPTIONS[mode],
46
+ ...(mode === current ? { current: true } : {}),
47
+ })),
48
+ });
49
+ // Confirming the mode in force stores nothing: a fallback it came from stays free to change later.
50
+ if (!answer || answer.value === current) return { text: modeUnchanged(current) };
51
+ return applyMode(deps, answer.value, MODE_SET_TO);
52
+ }
36
53
  if (!requested) {
37
54
  // E-12: bare /mode cycles default → acceptEdits → plan → bypassPermissions.
38
55
  // B-2: cycling starts from the EFFECTIVE mode, fallback included, so the
39
56
  // first press moves from what the session is actually running.
40
57
  const { mode: current } = await deps.session.resolveEffectiveSessionMode();
41
- return applyMode(deps, getNextPermissionMode(current), `cycled ${current} →`);
58
+ return applyMode(deps, getNextPermissionMode(current), modeCycled(current));
42
59
  }
43
60
  if (requested === "show") {
44
61
  const { mode: current, via } = await deps.session.resolveEffectiveSessionMode();
45
- return {
46
- text: `session default permission mode: ${current}\n` +
47
- ` ↳ ${via}\n` +
48
- `usage: /mode [<${PERMISSION_MODES.join("|")}>|show] — bare /mode cycles; ` +
49
- `an explicit "mode:" prefix on a prompt still wins.`,
50
- };
62
+ return { text: modeShown(current, via, PERMISSION_MODES) };
51
63
  }
52
64
  if (!isPermissionMode(requested)) {
53
- return { text: `unknown mode '${requested}' — expected one of: ${PERMISSION_MODES.join(", ")}, show.` };
65
+ return { text: unknownMode(requested, PERMISSION_MODES) };
54
66
  }
55
- return applyMode(deps, requested, "set to");
67
+ return applyMode(deps, requested, MODE_SET_TO);
56
68
  }
57
69
 
58
70
  // ── /plan — a TOGGLE, as the baseline specifies ───────────────────────────
@@ -63,14 +75,11 @@ async function runPlanToggle(deps: ModeDeps): Promise<CommandView> {
63
75
  const { mode, entering } = togglePlanMode(current);
64
76
  await deps.session.writeState(DEFAULT_MODE_STATE_KEY, mode);
65
77
  if (entering) {
66
- deps.log.info("entering 'plan': the edit, network and shell tools stripped from the catalogue");
67
- return { text: "plan mode ON — prompts without a \"mode:\" prefix now run read-only. /plan again to leave." };
78
+ deps.log.info(enteringReadOnly("plan"));
79
+ return { text: PLAN_ON };
68
80
  }
69
- deps.log.info("leaving 'plan': session default back to 'default' (asks on writes)");
70
- return {
71
- text: "plan mode OFF — the session default is 'default' (asks on writes). " +
72
- "It is NOT restored to whatever it was before /plan: use /mode to pick another.",
73
- };
81
+ deps.log.info(LEAVING_PLAN);
82
+ return { text: PLAN_OFF };
74
83
  }
75
84
 
76
85
  /**
@@ -25,14 +25,21 @@
25
25
  // be built from LlmConfig.Default() and REPLACE the provider's config wholesale,
26
26
  // which dropped the API key. Patched in Orkeon.Scripting (JsLlmFacade.ConfigFrom).
27
27
 
28
- import type { Logger, SessionMetadata, SessionStore, Telemetry } from "../../../shared/application/ports.ts";
29
- import { MODEL_PREFERENCE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
28
+ import type { Chooser, Logger, ReasoningReader, SessionMetadata, SessionStore, Telemetry } from "../../../shared/application/ports.ts";
29
+ import { DEFAULT_EFFORT, EFFORT_LEVELS, providerEffort } from "../../../shared/domain/agent-policy/behavior-flags.ts";
30
+ import { EFFORT_STATE_KEY, MODEL_PREFERENCE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
30
31
  import type { ConfigStore } from "../../../shared/application/config-store.ts";
31
32
  import { readLlmProfile } from "../../../shared/application/llm-profile.ts";
32
- import {
33
- judgeModelChoice, renderModelList, NO_CATALOGUE_NOTE,
34
- } from "../../../shared/domain/model-catalog.ts";
33
+ import { judgeModelChoice, renderModelList } from "../../../shared/domain/model-catalog.ts";
34
+ import { NO_CATALOGUE_NOTE } from "../../../shared/domain/messages.ts";
35
35
  import type { CommandView } from "../view.ts";
36
+ import { optionsOf } from "./choices.ts";
37
+ import { runEffort, storedEffortWarning } from "./effort.ts";
38
+ import {
39
+ MODEL_CHOICE, MODEL_UNCHANGED, NO_EFFECTIVE_MODEL, OVERRIDE_CLEARED_NO_BOOT, declaredCatalogue, modelSet,
40
+ modelSetUndeclared, modelSetWarned, modelShown, overrideCleared, overrideNotSent, profileNamesModel,
41
+ profileWinsOverride,
42
+ } from "./messages.ts";
36
43
 
37
44
  export interface ModelDeps {
38
45
  session: Pick<SessionStore, "readState" | "writeState">;
@@ -40,6 +47,16 @@ export interface ModelDeps {
40
47
  /** Where the session's `llm.profile` is read: under a profile, the override is not sent. */
41
48
  config: Pick<ConfigStore, "readValue" | "readFile">;
42
49
  log: Pick<Logger, "warn">;
50
+ /** Where a bare /model opens a panel, when it can and there is something to pick. */
51
+ chooser?: Chooser;
52
+ /** What the model switched to makes of the effort /effort stored; absent: nothing is said of it. */
53
+ reasoning?: ReasoningReader;
54
+ }
55
+
56
+ /** `text`, then the warning when the stored effort does not go as asked on the model the turns now run on. */
57
+ async function withEffortWarning(text: string, deps: ModelDeps): Promise<string> {
58
+ const warning = await storedEffortWarning(deps);
59
+ return warning === "" ? text : `${text}\n${warning}`;
43
60
  }
44
61
 
45
62
  /**
@@ -62,10 +79,6 @@ async function readHostModels(telemetry: ModelDeps["telemetry"]): Promise<{ boot
62
79
  };
63
80
  }
64
81
 
65
- export const NO_MODEL_REPORTED =
66
- "not reported by the host — no LLM provider is registered, or the host predates the " +
67
- "session-metadata fix. Turns will no-op: check that the settings file has an `Llm` section.";
68
-
69
82
  /** `/model [show|list|reset|clear|<name>]`, from the command's raw tokens. */
70
83
  export async function runModel(tokens: string[], deps: ModelDeps): Promise<CommandView> {
71
84
  const { session, telemetry, config, log } = deps;
@@ -80,30 +93,24 @@ export async function runModel(tokens: string[], deps: ModelDeps): Promise<Comma
80
93
  ]);
81
94
  // Under a profile no declared model of the host is the effective one: the profile names its own.
82
95
  const effective = profile === null ? pref || boot : "";
96
+ if (tokens.length === 0 && deps.chooser?.interactive && profile === null && declared.length > 0) {
97
+ return pickModel(deps, deps.chooser, { declared, effective, boot, override: pref ?? "" });
98
+ }
83
99
  const catalogue = renderModelList(declared, effective);
84
100
 
85
101
  // `/model list` is the catalogue alone — the question is "what can I pick".
86
102
  if (first === "list") {
87
- return { text: catalogue ? `declared models (* = effective):\n${catalogue}` : NO_CATALOGUE_NOTE };
103
+ return { text: catalogue ? declaredCatalogue(catalogue) : NO_CATALOGUE_NOTE };
88
104
  }
89
105
 
90
- return {
91
- text: `effective model for the next turn: ${effectiveLine(effective, profile)}\n` +
92
- ` boot model : ${boot || NO_MODEL_REPORTED}\n` +
93
- ` session override: ${pref ? (profile === null ? pref : `${pref} (not sent while llm.profile is set)`) : "(none)"}\n` +
94
- (catalogue ? `declared models (* = effective):\n${catalogue}\n` : `declared models: ${NO_CATALOGUE_NOTE}\n`) +
95
- "usage: /model <name> | /model list | /model reset | /model show",
96
- };
106
+ const override = pref ? (profile === null ? pref : overrideNotSent(pref)) : "(none)";
107
+ return { text: modelShown(effectiveLine(effective, profile), boot, override, catalogue, NO_CATALOGUE_NOTE) };
97
108
  }
98
109
 
99
110
  if (first === "reset" || first === "clear") {
100
111
  await session.writeState(MODEL_PREFERENCE_STATE_KEY, "");
101
112
  const { boot } = await readHostModels(telemetry);
102
- return {
103
- text: boot
104
- ? `model override cleared — turns go back to ${boot}.`
105
- : `model override cleared. Boot model: ${NO_MODEL_REPORTED}`,
106
- };
113
+ return { text: await withEffortWarning(boot ? overrideCleared(boot) : OVERRIDE_CLEARED_NO_BOOT, deps) };
107
114
  }
108
115
 
109
116
  const requested = tokens.join(" ").trim();
@@ -118,29 +125,57 @@ export async function runModel(tokens: string[], deps: ModelDeps): Promise<Comma
118
125
  const { profile } = await readLlmProfile(config);
119
126
  if (profile !== null) {
120
127
  // Stored all the same: it applies again once the profile is unset.
121
- const warning = `llm.profile ${profile} is active: the /model override '${requested}' is stored but not sent ` +
122
- "while it is set (unset llm.profile to use it)";
128
+ const warning = profileWinsOverride(profile, requested);
123
129
  log.warn(warning);
124
- return { text: `model set to '${requested}' — ⚠ ${warning}.` };
130
+ return { text: modelSetWarned(requested, warning) };
125
131
  }
126
132
  if (verdict.warning) {
127
133
  // Terse inline, full reason in the log: in the split-pane console the two land
128
134
  // in different panes, and repeating four lines verbatim next to themselves
129
135
  // trains the eye to skip them.
130
- return {
131
- text: `model set to '${requested}' — ⚠ NOT among the models this host declares ` +
132
- `(${declared.join(", ")}). Applied anyway; see the log. /model list to review.`,
133
- };
136
+ return { text: await withEffortWarning(modelSetUndeclared(requested, declared), deps) };
134
137
  }
135
- return {
136
- text: `model set to '${requested}' — it applies from the next /assistant turn, no relaunch.\n` +
137
- "It travels over the configured provider, so it must be a model that provider serves; " +
138
- "/clear (or /model reset) returns to the boot model.",
139
- };
138
+ return { text: await withEffortWarning(modelSet(requested), deps) };
139
+ }
140
+
141
+ /** The panel of a bare /model: the declared models, the effective one when the host does not declare it (Enter must
142
+ * not switch away from a model the list hides), the boot model when an override hides it, and the session's
143
+ * effort on the side arrows. Only what the answer changes is written, so opening it and pressing Enter turns no
144
+ * provider thinking on. */
145
+ async function pickModel(
146
+ deps: ModelDeps,
147
+ chooser: Chooser,
148
+ { declared, effective, boot, override }: { declared: string[]; effective: string; boot: string; override: string },
149
+ ): Promise<CommandView> {
150
+ const effort = providerEffort(await deps.session.readState(EFFORT_STATE_KEY).catch(() => null)) ?? DEFAULT_EFFORT;
151
+ const isDeclared = !effective || declared.some((name) => name.toLowerCase() === effective.toLowerCase());
152
+ const answer = await chooser.choose({
153
+ message: MODEL_CHOICE,
154
+ options: [
155
+ ...optionsOf(declared, effective),
156
+ ...(isDeclared ? [] : [{ value: effective, current: true }]),
157
+ ...(override ? [{ value: "reset", label: "Boot model", description: boot }] : []),
158
+ ],
159
+ control: { label: "Effort", values: EFFORT_LEVELS, value: effort },
160
+ });
161
+ if (!answer) return { text: MODEL_UNCHANGED };
162
+
163
+ const texts: string[] = [];
164
+ const newEffort = answer.control !== undefined && answer.control !== null && answer.control !== "" && answer.control !== effort;
165
+ if (answer.value.toLowerCase() !== effective.toLowerCase()) {
166
+ // With a new effort too, the level still stored is about to be replaced: the effort's own answer judges the
167
+ // new one on the new model.
168
+ const reasoning = newEffort ? undefined : deps.reasoning;
169
+ texts.push((await runModel([answer.value], { ...deps, chooser: undefined, reasoning })).text ?? "");
170
+ }
171
+ if (answer.control && newEffort) {
172
+ texts.push((await runEffort([answer.control], { session: deps.session, config: deps.config, reasoning: deps.reasoning })).text ?? "");
173
+ }
174
+ return { text: texts.length > 0 ? texts.join("\n") : MODEL_UNCHANGED };
140
175
  }
141
176
 
142
177
  /** The first line of `show`: the profile when one is set, else the effective model. */
143
178
  function effectiveLine(effective: string, profile: string | null): string {
144
- if (profile !== null) return `the one llm.profile ${profile} names (the /model override does not apply)`;
145
- return effective || "(none — see below)";
179
+ if (profile !== null) return profileNamesModel(profile);
180
+ return effective || NO_EFFECTIVE_MODEL;
146
181
  }
@@ -0,0 +1,39 @@
1
+ // /output-style [<name>|show]: the session's answer style, consumed by the main-loop prompt assembly. One
2
+ // session-state key, deliberately not a /config key: two owners for one setting is how a value ends up read from the
3
+ // layer nobody wrote to.
4
+ import type { Chooser } from "../../../shared/application/ports.ts";
5
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
6
+ import { OUTPUT_STYLES, isOutputStyle } from "../../../shared/domain/agent-policy/output-styles.ts";
7
+ import { OUTPUT_STYLE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
8
+ import type { CommandView } from "../view.ts";
9
+ import { optionsOf } from "./choices.ts";
10
+ import { OUTPUT_STYLE_CHOICE, OUTPUT_STYLE_UNCHANGED, outputStyleSet, outputStyleShown, unknownStyle } from "./messages.ts";
11
+
12
+ export interface OutputStyleDeps {
13
+ session: Pick<SessionIo, "readState" | "writeState">;
14
+ /** Where a bare /output-style opens a panel, when it can. */
15
+ chooser?: Chooser;
16
+ }
17
+
18
+ /** `/output-style [<name>|show]`, from the command's raw tokens. No argument opens a panel, or without one shows the
19
+ * style, as `show` does. */
20
+ export async function runOutputStyle(tokens: string[], deps: OutputStyleDeps): Promise<CommandView> {
21
+ const requested = (tokens[0] ?? "").trim();
22
+ const current = (await deps.session.readState(OUTPUT_STYLE_STATE_KEY)) ?? "default";
23
+
24
+ if (!requested && deps.chooser?.interactive) {
25
+ const answer = await deps.chooser.choose({
26
+ message: OUTPUT_STYLE_CHOICE,
27
+ options: optionsOf(OUTPUT_STYLES, current),
28
+ });
29
+ return answer ? runOutputStyle([answer.value], { session: deps.session }) : { text: OUTPUT_STYLE_UNCHANGED };
30
+ }
31
+ if (!requested || requested === "show") {
32
+ return { text: outputStyleShown(current, OUTPUT_STYLES) };
33
+ }
34
+ if (!isOutputStyle(requested)) {
35
+ return { text: unknownStyle(requested, OUTPUT_STYLES) };
36
+ }
37
+ await deps.session.writeState(OUTPUT_STYLE_STATE_KEY, requested);
38
+ return { text: outputStyleSet(requested) };
39
+ }
@@ -17,21 +17,25 @@
17
17
  // or a port that says nothing: it names the setting and the launcher instead.
18
18
 
19
19
  import type { PermissionRules, ToolCatalogue } from "../../../shared/application/ports.ts";
20
- import { USER_CONFIG_FILE_PATH } from "../../../shared/application/config-store.ts";
21
20
  import type { ConfigStore } from "../../../shared/application/config-store.ts";
22
21
  import type { SessionIo } from "../../../shared/application/session-io.ts";
23
22
  import { configuredNames, resolveExtraTools } from "../../../shared/application/extra-tools.ts";
24
23
  import type { ExtraToolsResolution } from "../../../shared/application/extra-tools.ts";
25
24
  import {
26
- addPermissionRule, clearPermissionRules, readPermissionRules, removePermissionRule, syncPermissionRules,
25
+ addPermissionRule, builtInRules, clearPermissionRules, readPermissionRules, removePermissionRule, syncPermissionRules,
27
26
  } from "../../../shared/application/permission-rules.ts";
27
+ import { listsOf } from "../../../shared/application/host-context.ts";
28
+ import type { HostSource } from "../../../shared/application/host-context.ts";
29
+ import {
30
+ USER_CONFIG_MOUNT, listedEntries, pathListRules, userConfigRules,
31
+ } from "../../../shared/domain/agent-policy/path-rules.ts";
28
32
  import type { StoredRules } from "../../../shared/application/permission-rules.ts";
29
33
  import { readMemoryDir } from "../../../shared/application/shared-memory/memory-settings.ts";
30
34
  import { memoryWriteRules } from "../../../shared/domain/shared-memory/layout.ts";
31
35
  import { PERMISSION_FALLBACK_CONFIG_KEY, PERMISSION_MODES } from "../../../shared/domain/permission-modes.ts";
32
36
  import { EXTRA_TOOLS_CONFIG_KEY } from "../../../shared/domain/agent-policy/extra-tools.ts";
33
37
  import {
34
- catalogueFor, checkRule, formatRule, gateLine, isReadOnly, readRule, sameCalls, toolsetFor, RULE_SYNTAX,
38
+ catalogueFor, checkRule, formatRule, gateLine, isReadOnly, readRule, sameCalls, toolsetFor,
35
39
  ACT_TOOLS,
36
40
  MEMORY_TOOLS,
37
41
  RULEABLE_TOOLS,
@@ -42,13 +46,15 @@ import type { ExtraTool, PermissionRule } from "../../../shared/domain/agent-pol
42
46
  import { heldRuleSets } from "../../../shared/domain/agent-policy/rule-sets.ts";
43
47
  import { nestedConfigKeys } from "../../../shared/domain/config-schema.ts";
44
48
  import type { CommandView } from "../view.ts";
45
-
46
- export const PERMISSIONS_USAGE =
47
- `usage: /permissions [show] | add ${RULE_SYNTAX} | remove ${RULE_SYNTAX} | list | clear`;
48
-
49
- /** Said when the host keeps no session rules: a rule is stored, nothing enforces it. */
50
- const NO_GATE_RULES =
51
- "⚠ the host keeps no session rules (orkeon-repl does): the gate decides each call from the mode alone.";
49
+ import {
50
+ ALL_RULES_CLEARED, DORMANT_NOT_LISTED, ENFORCEMENT_LINES, EVERY_CALL, GATE_HOLDS_OTHER_RULES, GATE_HOLDS_RULE_SETS,
51
+ GATE_OFF_LINES, GATE_ON_LINES, GATE_UNKNOWN_LINES, HOST_KEEPS_NO_RULES, INVALID_RULE_GRAMMAR, NO_GATE_RULES,
52
+ NO_PERMISSION_RULES, PERMISSIONS_USAGE, SET_BY_MODE, USER_SETTINGS_UNREADABLE, catalogueOfMode, dormantRule,
53
+ extraToolNotOffered, extraToolsUnreadableWarning, fallbackIgnored, inertRule, invalidRule, invalidStoredEntries, memoryGuard,
54
+ modesLine, nestedKey, noSuchRule, pathsDenyGuard, ruleAdded, ruleNoEffect, ruleRemoved, ruleSetsOfLastStep,
55
+ userConfigGuard, sessionDefaultLine, sourceLine, toolCatalogueLine, withheldLine, removedLine, extraToolsLine,
56
+ sessionRulesLine, hostGateLine,
57
+ } from "./messages.ts";
52
58
 
53
59
  export interface PermissionsDeps {
54
60
  session: Pick<SessionIo, "readDefaultPermissionMode" | "resolveSessionFallbackMode" | "readState" | "writeState">;
@@ -58,6 +64,8 @@ export interface PermissionsDeps {
58
64
  config: Pick<ConfigStore, "readValue" | "readFile" | "readUserFile">;
59
65
  /** The tools the host registers: the catalogue offers the extra tools it has. */
60
66
  catalogue: Pick<ToolCatalogue, "find">;
67
+ /** This run's host context, for its path lists (paths.deny in the gate); absent: no list. */
68
+ host?: HostSource;
61
69
  }
62
70
 
63
71
  /** The mode a turn without a `mode:` prefix runs in: /mode's, else the fallback. */
@@ -72,7 +80,7 @@ function describeExtra(tool: ExtraTool): string {
72
80
 
73
81
  /** The scope of a rule, for the `list` table. */
74
82
  function callsOf(rule: PermissionRule): string {
75
- return rule.argument === undefined ? "every call" : `${rule.argument}=${rule.pattern}`;
83
+ return rule.argument === undefined ? EVERY_CALL : `${rule.argument}=${rule.pattern}`;
76
84
  }
77
85
 
78
86
  /** What the stored rules hold that the gate does not get, and a setting that could not be read. */
@@ -80,15 +88,9 @@ function storedNotes(stored: StoredRules, extras: ExtraToolsResolution): string[
80
88
  return [
81
89
  ...(extras.unreadable === undefined
82
90
  ? []
83
- : [`⚠ ${EXTRA_TOOLS_CONFIG_KEY} could not be read (${extras.unreadable}): no extra tool is known, and the ` +
84
- "rules on extra tools are dormant."]),
85
- ...stored.dormant.map((rule) =>
86
- `⚠ rule ${rule} is dormant: its tool is neither built in nor listed in ${EXTRA_TOOLS_CONFIG_KEY}. It is ` +
87
- "kept, not handed to the gate, and applies again once the tool is listed (/permissions remove deletes it)."),
88
- ...(stored.invalid.length > 0
89
- ? [`⚠ ${stored.invalid.length} stored entr${stored.invalid.length === 1 ? "y is" : "ies are"} not a rule ` +
90
- `(${stored.invalid.join(", ")}): kept as written, ignored; /permissions clear removes them.`]
91
- : []),
91
+ : [extraToolsUnreadableWarning(extras.unreadable)]),
92
+ ...stored.dormant.map(dormantRule),
93
+ ...(stored.invalid.length > 0 ? [invalidStoredEntries(stored.invalid)] : []),
92
94
  ];
93
95
  }
94
96
 
@@ -110,19 +112,11 @@ async function widenedNotes(config: PermissionsDeps["config"]): Promise<{ fallba
110
112
  return {
111
113
  fallback: fallback?.ignored === undefined
112
114
  ? []
113
- : [` ↳ ignored : the project file sets ${PERMISSION_FALLBACK_CONFIG_KEY} '${fallback.ignored.value}': ` +
114
- fallback.ignored.reason],
115
+ : [fallbackIgnored(fallback.ignored.value, fallback.ignored.reason)],
115
116
  notes: [
116
- ...(user.malformed
117
- ? [`⚠ the user settings (${USER_CONFIG_FILE_PATH}) could not be read or parsed: no user setting applies.`]
118
- : []),
119
- ...nested.map((key) =>
120
- `⚠ ${key} is written nested in a settings file ({"${key.split(".")[0]}": {…}}), so nothing reads it: ` +
121
- `write it flat, "${key}": ….`),
122
- ...(extra?.ignored === undefined
123
- ? []
124
- : [`⚠ ${EXTRA_TOOLS_CONFIG_KEY} of the project file names ${extra.ignored.value}, which ${extra.ignored.reason}: ` +
125
- "not offered."]),
117
+ ...(user.malformed ? [USER_SETTINGS_UNREADABLE] : []),
118
+ ...nested.map(nestedKey),
119
+ ...(extra?.ignored === undefined ? [] : [extraToolNotOffered(extra.ignored.value, extra.ignored.reason)]),
126
120
  ],
127
121
  };
128
122
  }
@@ -142,9 +136,14 @@ async function renderShow(deps: PermissionsDeps, extras: ExtraToolsResolution):
142
136
  // built-in rule sets (a dev step's), grouped.
143
137
  const sessionLines = rules.map(gateLine);
144
138
  const memoryDir = (await readMemoryDir(deps.config)).dir;
139
+ const lists = await listsOf(deps.host);
145
140
  const memoryLines = memoryWriteRules(memoryDir).map(gateLine);
141
+ const userConfigLines = userConfigRules().map(gateLine);
142
+ const pathLines = pathListRules(lists).map(gateLine);
143
+ const builtInLines = [...memoryLines, ...userConfigLines, ...pathLines];
146
144
  const all = gate.available() ? gate.list() : null;
147
- const guarded = all === null ? [] : all.filter((l) => memoryLines.includes(l) && !sessionLines.includes(l));
145
+ const guarded = all === null ? [] : all.filter((l) => builtInLines.includes(l) && !sessionLines.includes(l));
146
+ const guardedOf = (lines: string[]): number => guarded.filter((l) => lines.includes(l)).length;
148
147
  const held = all === null ? null : all.filter((l) => !guarded.includes(l));
149
148
  const grouped = held === null ? null : heldRuleSets(held.filter((l) => !sessionLines.includes(l)));
150
149
  const setLines = new Set(held === null || grouped === null
@@ -152,11 +151,19 @@ async function renderShow(deps: PermissionsDeps, extras: ExtraToolsResolution):
152
151
  : held.filter((l) => !sessionLines.includes(l) && !grouped.rest.includes(l)));
153
152
  const plain = held === null ? null : held.filter((l) => !setLines.has(l));
154
153
  const setParts = grouped !== null && grouped.sets.length > 0
155
- ? [`rule sets of the last dev step: ${grouped.sets.map((g) => `${g.id} (${g.count} rules)`).join(", ")}`]
156
- : [];
157
- const guardParts = guarded.length > 0
158
- ? [`the shared memory's guard: no tool of the model writes under ${memoryDir}/candidates or ${memoryDir}/entries (${guarded.length} rules)`]
154
+ ? [ruleSetsOfLastStep(grouped.sets.map((g) => `${g.id} (${g.count} rules)`).join(", "))]
159
155
  : [];
156
+ const guardParts = [
157
+ ...(guardedOf(memoryLines) > 0
158
+ ? [memoryGuard(memoryDir, guardedOf(memoryLines))]
159
+ : []),
160
+ ...(guardedOf(userConfigLines) > 0
161
+ ? [userConfigGuard(USER_CONFIG_MOUNT, guardedOf(userConfigLines))]
162
+ : []),
163
+ ...(guardedOf(pathLines) > 0
164
+ ? [pathsDenyGuard(listedEntries(lists.deny).join(", "), guardedOf(pathLines))]
165
+ : []),
166
+ ];
160
167
  const heldParts = plain === null ? [] : [...(plain.length > 0 ? [plain.join(", ")] : []), ...setParts, ...guardParts];
161
168
 
162
169
  // The shared memory's tools are the main loop's, offered by mode (memory_recall always, memory_push where the
@@ -170,45 +177,29 @@ async function renderShow(deps: PermissionsDeps, extras: ExtraToolsResolution):
170
177
  || ((isReadOnly(mode) || !ACT_TOOLS.includes(t)) && scriptToolAccess(t) === undefined);
171
178
  const vocabulary = [...RULEABLE_TOOLS.filter(withheld), ...extras.present.map((t) => t.name)];
172
179
  const lines = [
173
- `session default mode : ${mode} ${isReadOnly(mode) ? "(read-only)" : ""}`,
174
- ` ↳ source : ${sessionDefault ? "set by /mode (session state)" : fallback.explanation}`,
180
+ sessionDefaultLine(mode, isReadOnly(mode)),
181
+ sourceLine(sessionDefault ? SET_BY_MODE : fallback.explanation),
175
182
  ...widened.fallback,
176
- `modes : ${PERMISSION_MODES.join(", ")} (bare /mode cycles)`,
177
- `tool catalogue : ${[...decision.tools, ...memory].join(", ") || "(empty)"}`,
178
- ` ↳ withheld by mode : ${vocabulary.filter((t) => !offered.includes(t)).join(", ") || "(none)"}`,
179
- ` ↳ removed by rule : ${[...decision.deniedByRule, ...memoryByMode.filter((t) => !memory.includes(t))].join(", ") || "(none)"}`,
183
+ modesLine(PERMISSION_MODES.join(", ")),
184
+ toolCatalogueLine([...decision.tools, ...memory].join(", ")),
185
+ withheldLine(vocabulary.filter((t) => !offered.includes(t)).join(", ")),
186
+ removedLine([...decision.deniedByRule, ...memoryByMode.filter((t) => !memory.includes(t))].join(", ")),
180
187
  ...(extras.present.length + extras.missing.length + extras.invalid.length > 0
181
- ? [
182
- ` ↳ extra tools : ${extras.present.map(describeExtra).join(", ") || "(none registered)"}` +
183
- (extras.missing.length > 0 ? `; not registered: ${extras.missing.map(describeExtra).join(", ")}` : "") +
184
- (extras.invalid.length > 0 ? `; ignored: ${extras.invalid.join(", ")}` : ""),
185
- ]
188
+ ? [extraToolsLine(extras.present.map(describeExtra).join(", "), extras.missing.map(describeExtra), extras.invalid)]
186
189
  : []),
187
- `session rules : ${rules.map(formatRule).join(", ") || "(none)"}` +
188
- (stored.dormant.length > 0 ? `; dormant: ${stored.dormant.join(", ")}` : ""),
189
- `in the host gate : ${plain === null ? "(the host keeps no session rules)" : heldParts.join("; ") || "(none)"}`,
190
- "enforcement : 1) catalogue: what the mode offers, less the tools a deny rule covers whole",
191
- " 2) host gate, at each call: a matching deny refuses; a matching allow runs",
192
- " without asking (not in plan); else the mode decides, and default and",
193
- " acceptEdits ask you: [y] once / [s] session / [n] no; a background",
194
- " command's question names its task (for [t1]), answered from the main prompt",
195
- " 3) dev crews' callback (/dev-spec, /dev-plan, /dev-batches, a /tasks repair),",
196
- " after the gate allowed a call:",
197
- " the step's rule sets and a role's roots again, glob/grep/count_pattern by",
198
- " their whole input, the act's mode when the host has no gate, then the",
199
- " pre-tool and post-tool hooks (/hooks); it can refuse, never allow more",
190
+ sessionRulesLine(rules.map(formatRule).join(", "), stored.dormant),
191
+ plain === null ? hostGateLine(HOST_KEEPS_NO_RULES) : hostGateLine(heldParts.join("; ")),
192
+ ...ENFORCEMENT_LINES,
200
193
  ...gateStateLines(gateOn),
201
194
  ];
202
195
 
203
196
  for (const r of decision.inert) {
204
- lines.push(`⚠ rule ${formatRule(r.rule)} has NO effect in '${mode}': ${r.reason}`);
197
+ lines.push(inertRule(formatRule(r.rule), mode, r.reason));
205
198
  }
206
199
  if (plain !== null && plain.join("\n") !== sessionLines.join("\n")) {
207
- lines.push("⚠ the gate holds other rules than the session: the next change or /assistant hands it these.");
200
+ lines.push(GATE_HOLDS_OTHER_RULES);
208
201
  } else if (setParts.length > 0) {
209
- lines.push(
210
- "⚠ the gate also holds the rule sets of the last dev step: the next /assistant turn or rule change hands it the session's rules alone.",
211
- );
202
+ lines.push(GATE_HOLDS_RULE_SETS);
212
203
  }
213
204
  lines.push(...widened.notes, ...storedNotes(stored, extras));
214
205
  return lines.join("\n");
@@ -216,22 +207,9 @@ async function renderShow(deps: PermissionsDeps, extras: ExtraToolsResolution):
216
207
 
217
208
  /** The closing lines of the enforcement block: what the host says of its gate. */
218
209
  function gateStateLines(on: boolean | undefined): string[] {
219
- if (on === true) {
220
- return [
221
- " the gate is on (Orkeon:Security:PermissionGate:Enabled, the host says): the rules",
222
- " and the modes above hold at each call",
223
- ];
224
- }
225
- if (on === false) {
226
- return [
227
- "⚠ the gate is OFF (Orkeon:Security:PermissionGate:Enabled is not true, the host says): no rule above",
228
- " is enforced and nothing asks",
229
- ];
230
- }
231
- return [
232
- " the gate runs only when Orkeon:Security:PermissionGate:Enabled is true, which",
233
- " the launcher sets: off, no rule above is enforced and nothing asks",
234
- ];
210
+ if (on === true) return [...GATE_ON_LINES];
211
+ if (on === false) return [...GATE_OFF_LINES];
212
+ return [...GATE_UNKNOWN_LINES];
235
213
  }
236
214
 
237
215
  /** `/permissions [show|list|add|remove|clear] …`, from the command's raw tokens. */
@@ -241,7 +219,7 @@ export async function runPermissions(tokens: string[], deps: PermissionsDeps): P
241
219
  const ruleText = ruleTokens.join(" ");
242
220
  const extras = await resolveExtraTools(deps);
243
221
  const extraNames = configuredNames(extras);
244
- const builtIn = memoryWriteRules((await readMemoryDir(deps.config)).dir);
222
+ const builtIn = builtInRules((await readMemoryDir(deps.config)).dir, await listsOf(deps.host));
245
223
  const sync = () => syncPermissionRules({ session, gate, extraNames, builtIn });
246
224
  switch ((sub ?? "show").toLowerCase()) {
247
225
  case "show":
@@ -251,14 +229,14 @@ export async function runPermissions(tokens: string[], deps: PermissionsDeps): P
251
229
  const stored = await readPermissionRules(session, extraNames);
252
230
  const dormant = stored.dormant.map(readRule).filter((r): r is PermissionRule => r !== null);
253
231
  if (stored.rules.length + dormant.length === 0) {
254
- return { text: [`no permission rules set. ${PERMISSIONS_USAGE}`, ...storedNotes(stored, extras)].join("\n") };
232
+ return { text: [NO_PERMISSION_RULES, ...storedNotes(stored, extras)].join("\n") };
255
233
  }
256
234
  const notes = storedNotes({ ...stored, dormant: [] }, extras);
257
235
  return {
258
236
  table: [
259
237
  ...stored.rules.map((r) => ({ effect: r.effect, tool: r.tool, calls: callsOf(r), state: "enforced" })),
260
238
  ...dormant.map((r) => ({
261
- effect: r.effect, tool: r.tool, calls: callsOf(r), state: `dormant: not in ${EXTRA_TOOLS_CONFIG_KEY}`,
239
+ effect: r.effect, tool: r.tool, calls: callsOf(r), state: DORMANT_NOT_LISTED,
262
240
  })),
263
241
  ],
264
242
  text: notes.length > 0 ? notes.join("\n") : undefined,
@@ -267,7 +245,7 @@ export async function runPermissions(tokens: string[], deps: PermissionsDeps): P
267
245
 
268
246
  case "add": {
269
247
  const check = checkRule(ruleText, extraNames);
270
- if (!check.ok) return { text: `invalid rule: ${check.reason}.\n${PERMISSIONS_USAGE}` };
248
+ if (!check.ok) return { text: invalidRule(check.reason) };
271
249
  const { rule } = check;
272
250
  await addPermissionRule(session, rule);
273
251
  const synced = await sync();
@@ -276,10 +254,10 @@ export async function runPermissions(tokens: string[], deps: PermissionsDeps): P
276
254
  const inert = decision.inert.find((r) => r.rule.effect === rule.effect && sameCalls(r.rule, rule));
277
255
  return {
278
256
  text: [
279
- `rule ${formatRule(rule)} added.`,
257
+ ruleAdded(formatRule(rule)),
280
258
  ...(check.warning ? [`⚠ ${check.warning}`] : []),
281
- ...(inert ? [`⚠ it has NO effect in '${mode}': ${inert.reason}`] : []),
282
- `catalogue for '${mode}': ${decision.tools.join(", ") || "(empty)"}`,
259
+ ...(inert ? [ruleNoEffect(mode, inert.reason)] : []),
260
+ catalogueOfMode(mode, decision.tools.join(", ") || "(empty)"),
283
261
  ...syncNotes(synced, extras),
284
262
  ].join("\n"),
285
263
  };
@@ -288,18 +266,18 @@ export async function runPermissions(tokens: string[], deps: PermissionsDeps): P
288
266
  case "remove": {
289
267
  // Read by the grammar alone: a dormant rule, whose tool is not known now, is removed too.
290
268
  const rule = readRule(ruleText);
291
- if (!rule) return { text: `invalid rule: expected ${RULE_SYNTAX}.\n${PERMISSIONS_USAGE}` };
269
+ if (!rule) return { text: INVALID_RULE_GRAMMAR };
292
270
  const removed = await removePermissionRule(session, rule);
293
- if (removed.length === 0) return { text: `no such rule: ${formatRule(rule)}.` };
271
+ if (removed.length === 0) return { text: noSuchRule(formatRule(rule)) };
294
272
  const synced = await sync();
295
- return { text: [`rule ${formatRule(removed[0])} removed.`, ...syncNotes(synced, extras)].join("\n") };
273
+ return { text: [ruleRemoved(formatRule(removed[0])), ...syncNotes(synced, extras)].join("\n") };
296
274
  }
297
275
 
298
276
  case "clear": {
299
277
  await clearPermissionRules(session);
300
278
  const synced = await sync();
301
279
  return {
302
- text: ["all permission rules cleared (the mode decides alone).", ...syncNotes(synced, extras)].join("\n"),
280
+ text: [ALL_RULES_CLEARED, ...syncNotes(synced, extras)].join("\n"),
303
281
  };
304
282
  }
305
283