orkeon-code 0.0.0-stage → 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 (552) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -0
  3. package/LICENSE.md +21 -0
  4. package/NOTICE.md +17 -0
  5. package/README.fr.md +163 -0
  6. package/README.md +156 -2
  7. package/config/appsettings.anthropic.example.json +77 -0
  8. package/config/appsettings.example.json +71 -0
  9. package/config/appsettings.jev.example.json +131 -0
  10. package/config/appsettings.kev.example.json +133 -0
  11. package/config/appsettings.liquid.example.json +132 -0
  12. package/config/appsettings.ollama-whisper.example.json +93 -0
  13. package/config/appsettings.ollama.example.json +70 -0
  14. package/config/appsettings.whisper.example.json +32 -0
  15. package/mcp/whisper/README.md +294 -0
  16. package/mcp/whisper/pyproject.toml +32 -0
  17. package/mcp/whisper/uv.lock +1641 -0
  18. package/mcp/whisper/whisper_mcp.py +1053 -0
  19. package/orkeon-code +1092 -0
  20. package/orkeon-code.mjs +71 -0
  21. package/orkeon-code.ps1 +939 -0
  22. package/package.json +58 -4
  23. package/scripts/install.ps1 +156 -0
  24. package/scripts/install.sh +148 -0
  25. package/scripts/session-start.ork.ts +90 -0
  26. package/scripts/session-start.sh +74 -0
  27. package/scripts/setup-fixture.sh +88 -0
  28. package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
  29. package/src/commands/_lib/args.ts +194 -0
  30. package/src/commands/_lib/dev/dev-batches.ts +366 -0
  31. package/src/commands/_lib/dev/dev-implement.ts +185 -0
  32. package/src/commands/_lib/dev/dev-source.ts +61 -0
  33. package/src/commands/_lib/dev/dev.ts +341 -0
  34. package/src/commands/_lib/dev/markers.ts +7 -0
  35. package/src/commands/_lib/dev/messages.ts +112 -0
  36. package/src/commands/_lib/dev-step.ts +145 -0
  37. package/src/commands/_lib/dispatch.ts +254 -0
  38. package/src/commands/_lib/effort.ts +15 -0
  39. package/src/commands/_lib/git/branch.ts +94 -0
  40. package/src/commands/_lib/git/commit.ts +90 -0
  41. package/src/commands/_lib/git/diff.ts +107 -0
  42. package/src/commands/_lib/git/messages.ts +54 -0
  43. package/src/commands/_lib/git/review.ts +108 -0
  44. package/src/commands/_lib/memory/memory-admit.ts +148 -0
  45. package/src/commands/_lib/memory/memory.ts +52 -0
  46. package/src/commands/_lib/memory/messages.ts +32 -0
  47. package/src/commands/_lib/messages.ts +48 -0
  48. package/src/commands/_lib/pr-context.ts +32 -0
  49. package/src/commands/_lib/project/analyze.ts +24 -0
  50. package/src/commands/_lib/project/messages.ts +8 -0
  51. package/src/commands/_lib/session/export.ts +105 -0
  52. package/src/commands/_lib/session/messages.ts +87 -0
  53. package/src/commands/_lib/session/prompts.ts +4 -0
  54. package/src/commands/_lib/session/resume.ts +151 -0
  55. package/src/commands/_lib/session/tasks.ts +181 -0
  56. package/src/commands/_lib/settings/advisor.ts +75 -0
  57. package/src/commands/_lib/settings/agents.ts +137 -0
  58. package/src/commands/_lib/settings/choices.ts +8 -0
  59. package/src/commands/_lib/settings/config.ts +141 -0
  60. package/src/commands/_lib/settings/effort.ts +147 -0
  61. package/src/commands/_lib/settings/hooks.ts +50 -0
  62. package/src/commands/_lib/settings/messages.ts +408 -0
  63. package/src/commands/_lib/settings/mode.ts +100 -0
  64. package/src/commands/_lib/settings/model.ts +181 -0
  65. package/src/commands/_lib/settings/output-style.ts +39 -0
  66. package/src/commands/_lib/settings/permissions.ts +287 -0
  67. package/src/commands/_lib/settings/route.ts +63 -0
  68. package/src/commands/_lib/settings/session-config.ts +49 -0
  69. package/src/commands/_lib/settings/skills.ts +93 -0
  70. package/src/commands/_lib/settings/theme.ts +42 -0
  71. package/src/commands/_lib/speech/messages.ts +58 -0
  72. package/src/commands/_lib/speech/prompts.ts +4 -0
  73. package/src/commands/_lib/speech/say.ts +95 -0
  74. package/src/commands/_lib/speech/transcribe.ts +121 -0
  75. package/src/commands/_lib/speech/voice.ts +142 -0
  76. package/src/commands/_lib/status/cache.ts +31 -0
  77. package/src/commands/_lib/status/context.ts +57 -0
  78. package/src/commands/_lib/status/doctor.ts +205 -0
  79. package/src/commands/_lib/status/messages.ts +100 -0
  80. package/src/commands/_lib/status/meta.ts +24 -0
  81. package/src/commands/_lib/status/status.ts +128 -0
  82. package/src/commands/_lib/status/usage-tools.ts +48 -0
  83. package/src/commands/_lib/status/usage.ts +128 -0
  84. package/src/commands/_lib/view.ts +34 -0
  85. package/src/commands/dev/dev-batches.cmd.ts +109 -0
  86. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  87. package/src/commands/dev/dev-plan.cmd.ts +51 -0
  88. package/src/commands/dev/dev-spec.cmd.ts +54 -0
  89. package/src/commands/dev/dev-status.cmd.ts +16 -0
  90. package/src/commands/git/branch.cmd.ts +27 -0
  91. package/src/commands/git/commit.cmd.ts +48 -0
  92. package/src/commands/git/diff.cmd.ts +26 -0
  93. package/src/commands/git/review.cmd.ts +36 -0
  94. package/src/commands/memory/memory.cmd.ts +48 -0
  95. package/src/commands/project/analyze.cmd.ts +32 -0
  96. package/src/commands/project/debug-tool-call.cmd.ts +62 -0
  97. package/src/commands/project/files.cmd.ts +22 -0
  98. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  99. package/src/commands/project/init.cmd.ts +14 -0
  100. package/src/commands/project/verify.cmd.ts +27 -0
  101. package/src/commands/session/assistant.cmd.ts +40 -0
  102. package/src/commands/session/btw.cmd.ts +18 -0
  103. package/src/commands/session/clear.cmd.ts +19 -0
  104. package/src/commands/session/compact.cmd.ts +16 -0
  105. package/src/commands/session/copy.cmd.ts +45 -0
  106. package/src/commands/session/exit.cmd.ts +9 -0
  107. package/src/commands/session/export.cmd.ts +28 -0
  108. package/src/commands/session/rename.cmd.ts +18 -0
  109. package/src/commands/session/resume.cmd.ts +19 -0
  110. package/src/commands/session/rewind.cmd.ts +25 -0
  111. package/src/commands/session/summary.cmd.ts +27 -0
  112. package/src/commands/session/tasks.cmd.ts +46 -0
  113. package/src/commands/settings/advisor.cmd.ts +38 -0
  114. package/src/commands/settings/agents.cmd.ts +19 -0
  115. package/src/commands/settings/config.cmd.ts +19 -0
  116. package/src/commands/settings/effort.cmd.ts +19 -0
  117. package/src/commands/settings/fast.cmd.ts +18 -0
  118. package/src/commands/settings/hooks.cmd.ts +17 -0
  119. package/src/commands/settings/mode.cmd.ts +20 -0
  120. package/src/commands/settings/model.cmd.ts +21 -0
  121. package/src/commands/settings/output-style.cmd.ts +19 -0
  122. package/src/commands/settings/permissions.cmd.ts +25 -0
  123. package/src/commands/settings/proactive.cmd.ts +16 -0
  124. package/src/commands/settings/route.cmd.ts +16 -0
  125. package/src/commands/settings/skills.cmd.ts +17 -0
  126. package/src/commands/settings/theme.cmd.ts +14 -0
  127. package/src/commands/speech/say.cmd.ts +24 -0
  128. package/src/commands/speech/transcribe.cmd.ts +29 -0
  129. package/src/commands/speech/voice.cmd.ts +30 -0
  130. package/src/commands/status/context.cmd.ts +18 -0
  131. package/src/commands/status/doctor.cmd.ts +27 -0
  132. package/src/commands/status/release-notes.cmd.ts +9 -0
  133. package/src/commands/status/status.cmd.ts +25 -0
  134. package/src/commands/status/usage.cmd.ts +21 -0
  135. package/src/crews/.orkeon/orkeon.d.ts +4391 -0
  136. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  137. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
  138. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  139. package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
  140. package/src/crews/advisor/application/messages.ts +4 -0
  141. package/src/crews/advisor/application/prompts.ts +4 -0
  142. package/src/crews/advisor/application/run-advisor.ts +41 -0
  143. package/src/crews/advisor/crew.ork.ts +44 -0
  144. package/src/crews/advisor/domain/advice.ts +119 -0
  145. package/src/crews/advisor/domain/messages.ts +8 -0
  146. package/src/crews/advisor/domain/prompts.ts +26 -0
  147. package/src/crews/agent-run/application/messages.ts +18 -0
  148. package/src/crews/agent-run/application/run-agent-run.ts +43 -0
  149. package/src/crews/agent-run/crew.ork.ts +67 -0
  150. package/src/crews/analyze/application/messages.ts +27 -0
  151. package/src/crews/analyze/application/prompts.ts +4 -0
  152. package/src/crews/analyze/application/run-analyze.ts +120 -0
  153. package/src/crews/analyze/crew.ork.ts +41 -0
  154. package/src/crews/analyze/domain/harvest.ts +269 -0
  155. package/src/crews/analyze/domain/prompts.ts +86 -0
  156. package/src/crews/code-review/application/lens-material.ts +24 -0
  157. package/src/crews/code-review/application/messages.ts +17 -0
  158. package/src/crews/code-review/application/prompts.ts +126 -0
  159. package/src/crews/code-review/application/review.ts +74 -0
  160. package/src/crews/code-review/application/run-code-review.ts +121 -0
  161. package/src/crews/code-review/crew.ork.ts +52 -0
  162. package/src/crews/code-review/domain/lenses.ts +154 -0
  163. package/src/crews/code-review/domain/messages.ts +25 -0
  164. package/src/crews/code-review/domain/prompts.ts +58 -0
  165. package/src/crews/code-review/domain/report.ts +58 -0
  166. package/src/crews/code-review/domain/scope.ts +106 -0
  167. package/src/crews/dev-batches/application/messages.ts +127 -0
  168. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  169. package/src/crews/dev-batches/application/prompts.ts +10 -0
  170. package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
  171. package/src/crews/dev-batches/application/run-wave.ts +452 -0
  172. package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
  173. package/src/crews/dev-batches/crew.ork.ts +146 -0
  174. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  175. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  176. package/src/crews/dev-batches/domain/batches-log.ts +52 -0
  177. package/src/crews/dev-batches/domain/markers.ts +5 -0
  178. package/src/crews/dev-batches/domain/messages.ts +6 -0
  179. package/src/crews/dev-batches/domain/wave-order.ts +44 -0
  180. package/src/crews/dev-change/application/change-material.ts +44 -0
  181. package/src/crews/dev-change/application/evidence.ts +172 -0
  182. package/src/crews/dev-change/application/messages.ts +81 -0
  183. package/src/crews/dev-change/application/prompts.ts +101 -0
  184. package/src/crews/dev-change/application/run-dev-change.ts +324 -0
  185. package/src/crews/dev-change/crew.ork.ts +114 -0
  186. package/src/crews/dev-change/domain/change-answer.ts +163 -0
  187. package/src/crews/dev-change/domain/change-render.ts +77 -0
  188. package/src/crews/dev-change/domain/markers.ts +28 -0
  189. package/src/crews/dev-change/domain/messages.ts +16 -0
  190. package/src/crews/dev-implement/application/close.ts +186 -0
  191. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  192. package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
  193. package/src/crews/dev-implement/application/messages.ts +161 -0
  194. package/src/crews/dev-implement/application/observe.ts +52 -0
  195. package/src/crews/dev-implement/application/prompts.ts +9 -0
  196. package/src/crews/dev-implement/application/report-writes.ts +46 -0
  197. package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
  198. package/src/crews/dev-implement/application/run-role.ts +27 -0
  199. package/src/crews/dev-implement/application/suite-job.ts +122 -0
  200. package/src/crews/dev-implement/application/touched.ts +74 -0
  201. package/src/crews/dev-implement/crew.ork.ts +69 -0
  202. package/src/crews/dev-implement/domain/contracts.ts +255 -0
  203. package/src/crews/dev-implement/domain/correction.ts +103 -0
  204. package/src/crews/dev-implement/domain/cycles.ts +36 -0
  205. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  206. package/src/crews/dev-implement/domain/markers.ts +23 -0
  207. package/src/crews/dev-implement/domain/messages.ts +58 -0
  208. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  209. package/src/crews/dev-implement/domain/roles.ts +49 -0
  210. package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
  211. package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
  212. package/src/crews/dev-implement/domain/step-checks.ts +137 -0
  213. package/src/crews/dev-implement/domain/step-section.ts +129 -0
  214. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  215. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  216. package/src/crews/dev-learn/application/messages.ts +51 -0
  217. package/src/crews/dev-learn/application/prompts.ts +99 -0
  218. package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
  219. package/src/crews/dev-learn/crew.ork.ts +53 -0
  220. package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
  221. package/src/crews/dev-learn/domain/messages.ts +65 -0
  222. package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
  223. package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
  224. package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
  225. package/src/crews/dev-plan/application/inventory.ts +174 -0
  226. package/src/crews/dev-plan/application/messages.ts +88 -0
  227. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  228. package/src/crews/dev-plan/application/prompts.ts +141 -0
  229. package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
  230. package/src/crews/dev-plan/crew.ork.ts +112 -0
  231. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  232. package/src/crews/dev-plan/domain/markers.ts +18 -0
  233. package/src/crews/dev-plan/domain/messages.ts +118 -0
  234. package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
  235. package/src/crews/dev-plan/domain/plan-render.ts +306 -0
  236. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  237. package/src/crews/dev-spec/application/messages.ts +30 -0
  238. package/src/crews/dev-spec/application/prompts.ts +93 -0
  239. package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
  240. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  241. package/src/crews/dev-spec/crew.ork.ts +110 -0
  242. package/src/crews/dev-spec/domain/markers.ts +30 -0
  243. package/src/crews/dev-spec/domain/messages.ts +39 -0
  244. package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
  245. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  246. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  247. package/src/crews/dev-verify/application/audit.ts +267 -0
  248. package/src/crews/dev-verify/application/capture.ts +311 -0
  249. package/src/crews/dev-verify/application/messages.ts +119 -0
  250. package/src/crews/dev-verify/application/prompts.ts +209 -0
  251. package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
  252. package/src/crews/dev-verify/application/run-gate.ts +204 -0
  253. package/src/crews/dev-verify/crew.ork.ts +103 -0
  254. package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
  255. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  256. package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
  257. package/src/crews/dev-verify/domain/commands.ts +103 -0
  258. package/src/crews/dev-verify/domain/gate.ts +131 -0
  259. package/src/crews/dev-verify/domain/markers.ts +16 -0
  260. package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
  261. package/src/crews/dev-verify/domain/messages.ts +92 -0
  262. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  263. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  264. package/src/crews/dev-verify/domain/text.ts +20 -0
  265. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  266. package/src/crews/git-commit/application/draft.ts +133 -0
  267. package/src/crews/git-commit/application/messages.ts +15 -0
  268. package/src/crews/git-commit/application/prompts.ts +47 -0
  269. package/src/crews/git-commit/application/run-git-commit.ts +117 -0
  270. package/src/crews/git-commit/crew.ork.ts +53 -0
  271. package/src/crews/git-commit/domain/commit.ts +200 -0
  272. package/src/crews/git-commit/domain/markers.ts +4 -0
  273. package/src/crews/git-commit/domain/messages.ts +48 -0
  274. package/src/crews/init-verifiers/application/authoring.ts +90 -0
  275. package/src/crews/init-verifiers/application/messages.ts +13 -0
  276. package/src/crews/init-verifiers/application/prompts.ts +107 -0
  277. package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
  278. package/src/crews/init-verifiers/crew.ork.ts +35 -0
  279. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  280. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  281. package/src/crews/main-loop/application/auto-compact.ts +78 -0
  282. package/src/crews/main-loop/application/context-gather.ts +133 -0
  283. package/src/crews/main-loop/application/messages.ts +81 -0
  284. package/src/crews/main-loop/application/prompts.ts +12 -0
  285. package/src/crews/main-loop/application/run-main-loop.ts +383 -0
  286. package/src/crews/main-loop/application/turn-context.ts +111 -0
  287. package/src/crews/main-loop/crew.ork.ts +124 -0
  288. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  289. package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
  290. package/src/crews/main-loop/domain/prompts.ts +336 -0
  291. package/src/crews/main-loop/domain/turn-chains.ts +130 -0
  292. package/src/crews/project-init/application/detect.ts +123 -0
  293. package/src/crews/project-init/application/messages.ts +15 -0
  294. package/src/crews/project-init/application/prompts.ts +105 -0
  295. package/src/crews/project-init/application/run-project-init.ts +31 -0
  296. package/src/crews/project-init/crew.ork.ts +36 -0
  297. package/src/crews/project-init/domain/conventions.ts +36 -0
  298. package/src/crews/project-init/domain/existing-files.ts +65 -0
  299. package/src/crews/project-init/domain/messages.ts +13 -0
  300. package/src/crews/project-init/domain/package-map.ts +73 -0
  301. package/src/crews/project-init/domain/prompts.ts +10 -0
  302. package/src/crews/session-compact/application/prompts.ts +5 -0
  303. package/src/crews/session-compact/crew.ork.ts +56 -0
  304. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  305. package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
  306. package/src/crews/speech/application/messages.ts +3 -0
  307. package/src/crews/speech/application/prompts.ts +3 -0
  308. package/src/crews/speech/application/run-speech.ts +26 -0
  309. package/src/crews/speech/crew.ork.ts +38 -0
  310. package/src/shared/application/agents/child-agent.ts +259 -0
  311. package/src/shared/application/agents/messages.ts +35 -0
  312. package/src/shared/application/agents/route-agent.ts +115 -0
  313. package/src/shared/application/agents/run-sub-agent.ts +119 -0
  314. package/src/shared/application/answer-language.ts +14 -0
  315. package/src/shared/application/attached-skills.ts +36 -0
  316. package/src/shared/application/compaction/compact-session.ts +242 -0
  317. package/src/shared/application/compaction/extract-memories.ts +38 -0
  318. package/src/shared/application/compaction/messages.ts +20 -0
  319. package/src/shared/application/compaction/prune-context.ts +94 -0
  320. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  321. package/src/shared/application/compaction/restore-context.ts +78 -0
  322. package/src/shared/application/config-store.ts +123 -0
  323. package/src/shared/application/dev/brief-inventory.ts +115 -0
  324. package/src/shared/application/dev/close-batch.ts +85 -0
  325. package/src/shared/application/dev/find-repo-pack.ts +78 -0
  326. package/src/shared/application/dev/learn-decision.ts +254 -0
  327. package/src/shared/application/dev/load-dev-context.ts +265 -0
  328. package/src/shared/application/dev/measure-access-cost.ts +69 -0
  329. package/src/shared/application/dev/messages.ts +132 -0
  330. package/src/shared/application/dev/phase-timer.ts +54 -0
  331. package/src/shared/application/dev/plan-source.ts +116 -0
  332. package/src/shared/application/dev/preflight.ts +71 -0
  333. package/src/shared/application/dev/project-files.ts +17 -0
  334. package/src/shared/application/dev/prompts.ts +34 -0
  335. package/src/shared/application/dev/question-round.ts +60 -0
  336. package/src/shared/application/dev/resolve-work-folder.ts +134 -0
  337. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  338. package/src/shared/application/dev/settle-questions.ts +57 -0
  339. package/src/shared/application/dev/source-review.ts +67 -0
  340. package/src/shared/application/dev/source-step.ts +152 -0
  341. package/src/shared/application/dev/spend.ts +55 -0
  342. package/src/shared/application/dev/step-precedents.ts +90 -0
  343. package/src/shared/application/dev/tool-call-policy.ts +87 -0
  344. package/src/shared/application/dev/tool-callbacks.ts +262 -0
  345. package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
  346. package/src/shared/application/dev/verdict-sources.ts +50 -0
  347. package/src/shared/application/dev/wrapped-tools.ts +147 -0
  348. package/src/shared/application/extra-tools.ts +71 -0
  349. package/src/shared/application/git/batch-worktree.ts +102 -0
  350. package/src/shared/application/git/commit-files.ts +191 -0
  351. package/src/shared/application/git/merge-batch.ts +67 -0
  352. package/src/shared/application/git/messages.ts +75 -0
  353. package/src/shared/application/git/open-pull-request.ts +52 -0
  354. package/src/shared/application/host-context.ts +59 -0
  355. package/src/shared/application/host-layout-store.ts +45 -0
  356. package/src/shared/application/instructions-file.ts +19 -0
  357. package/src/shared/application/json-file.ts +34 -0
  358. package/src/shared/application/llm-profile.ts +36 -0
  359. package/src/shared/application/messages.ts +14 -0
  360. package/src/shared/application/permission-rules.ts +169 -0
  361. package/src/shared/application/ports/approvals.ts +20 -0
  362. package/src/shared/application/ports/clock.ts +5 -0
  363. package/src/shared/application/ports/code-index.ts +93 -0
  364. package/src/shared/application/ports/crew.ts +60 -0
  365. package/src/shared/application/ports/decision.ts +14 -0
  366. package/src/shared/application/ports/files.ts +21 -0
  367. package/src/shared/application/ports/human.ts +38 -0
  368. package/src/shared/application/ports/llm.ts +83 -0
  369. package/src/shared/application/ports/memory.ts +30 -0
  370. package/src/shared/application/ports/progress.ts +23 -0
  371. package/src/shared/application/ports/runtime.ts +15 -0
  372. package/src/shared/application/ports/session.ts +74 -0
  373. package/src/shared/application/ports/shared-memory.ts +26 -0
  374. package/src/shared/application/ports/shell.ts +40 -0
  375. package/src/shared/application/ports/telemetry.ts +45 -0
  376. package/src/shared/application/ports/theme.ts +11 -0
  377. package/src/shared/application/ports/tools.ts +46 -0
  378. package/src/shared/application/ports/usage.ts +45 -0
  379. package/src/shared/application/ports.ts +29 -0
  380. package/src/shared/application/project-manifests.ts +106 -0
  381. package/src/shared/application/session-io.ts +85 -0
  382. package/src/shared/application/session-state.ts +36 -0
  383. package/src/shared/application/shared-memory/admit-entries.ts +179 -0
  384. package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
  385. package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
  386. package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
  387. package/src/shared/application/shared-memory/memory-files.ts +111 -0
  388. package/src/shared/application/shared-memory/memory-settings.ts +94 -0
  389. package/src/shared/application/shared-memory/messages.ts +63 -0
  390. package/src/shared/application/shared-memory/push-candidate.ts +149 -0
  391. package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
  392. package/src/shared/application/skills/messages.ts +4 -0
  393. package/src/shared/application/skills/suggest-skills.ts +102 -0
  394. package/src/shared/application/state-snapshot.ts +38 -0
  395. package/src/shared/application/workflow/messages.ts +8 -0
  396. package/src/shared/application/workflow/workflow-state.ts +136 -0
  397. package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
  398. package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
  399. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  400. package/src/shared/domain/agent-policy/messages.ts +66 -0
  401. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  402. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  403. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  404. package/src/shared/domain/agent-policy/permission.ts +625 -0
  405. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  406. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  407. package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
  408. package/src/shared/domain/agent-policy/tool-access.ts +91 -0
  409. package/src/shared/domain/agent-registry.ts +143 -0
  410. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  411. package/src/shared/domain/agents/chain.ts +30 -0
  412. package/src/shared/domain/agents/charter.ts +64 -0
  413. package/src/shared/domain/agents/exclusive.ts +25 -0
  414. package/src/shared/domain/agents/instances.ts +252 -0
  415. package/src/shared/domain/agents/messages.ts +39 -0
  416. package/src/shared/domain/agents/model-route.ts +199 -0
  417. package/src/shared/domain/agents/prompts.ts +20 -0
  418. package/src/shared/domain/code-intel-contract.ts +357 -0
  419. package/src/shared/domain/code-intel-routing.ts +60 -0
  420. package/src/shared/domain/compact-outcome.ts +46 -0
  421. package/src/shared/domain/compaction-thresholds.ts +162 -0
  422. package/src/shared/domain/compaction.ts +288 -0
  423. package/src/shared/domain/config-schema.ts +434 -0
  424. package/src/shared/domain/context-prune.ts +176 -0
  425. package/src/shared/domain/decision/questions.ts +102 -0
  426. package/src/shared/domain/dev/access-cost.ts +230 -0
  427. package/src/shared/domain/dev/artefacts.ts +50 -0
  428. package/src/shared/domain/dev/batches-concurrency.ts +35 -0
  429. package/src/shared/domain/dev/batches-state.ts +49 -0
  430. package/src/shared/domain/dev/build-commands.ts +45 -0
  431. package/src/shared/domain/dev/call-guard.ts +342 -0
  432. package/src/shared/domain/dev/carried-text.ts +47 -0
  433. package/src/shared/domain/dev/design-rules.ts +100 -0
  434. package/src/shared/domain/dev/learn-proposals.ts +176 -0
  435. package/src/shared/domain/dev/learn-state.ts +94 -0
  436. package/src/shared/domain/dev/markers.ts +107 -0
  437. package/src/shared/domain/dev/messages.ts +259 -0
  438. package/src/shared/domain/dev/path-args.ts +42 -0
  439. package/src/shared/domain/dev/path-rebase.ts +93 -0
  440. package/src/shared/domain/dev/phase-timing.ts +50 -0
  441. package/src/shared/domain/dev/plan-checks.ts +191 -0
  442. package/src/shared/domain/dev/plan-format.ts +170 -0
  443. package/src/shared/domain/dev/project-files.ts +29 -0
  444. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  445. package/src/shared/domain/dev/prompts.ts +251 -0
  446. package/src/shared/domain/dev/questions.ts +267 -0
  447. package/src/shared/domain/dev/reading-rule.ts +41 -0
  448. package/src/shared/domain/dev/repo-pack.ts +240 -0
  449. package/src/shared/domain/dev/review-answer.ts +173 -0
  450. package/src/shared/domain/dev/review-brief.ts +54 -0
  451. package/src/shared/domain/dev/reviewer-charter.ts +35 -0
  452. package/src/shared/domain/dev/sheet-facts.ts +81 -0
  453. package/src/shared/domain/dev/spec-format.ts +182 -0
  454. package/src/shared/domain/dev/step-budget.ts +74 -0
  455. package/src/shared/domain/dev/step-rules.ts +109 -0
  456. package/src/shared/domain/dev/test-commands.ts +94 -0
  457. package/src/shared/domain/dev/test-output.ts +33 -0
  458. package/src/shared/domain/dev/test-paths.ts +40 -0
  459. package/src/shared/domain/dev/tool-guards.ts +65 -0
  460. package/src/shared/domain/dev/trait-pattern.ts +87 -0
  461. package/src/shared/domain/dev/verdict-format.ts +162 -0
  462. package/src/shared/domain/dev/whitespace.ts +35 -0
  463. package/src/shared/domain/dev/work-folder.ts +68 -0
  464. package/src/shared/domain/dev/yaml-subset.ts +385 -0
  465. package/src/shared/domain/error-text.ts +13 -0
  466. package/src/shared/domain/git/close.ts +274 -0
  467. package/src/shared/domain/git/messages.ts +20 -0
  468. package/src/shared/domain/git/pull-request.ts +96 -0
  469. package/src/shared/domain/git/worktree.ts +46 -0
  470. package/src/shared/domain/host-layout.ts +147 -0
  471. package/src/shared/domain/host-paths.ts +399 -0
  472. package/src/shared/domain/index-languages.ts +16 -0
  473. package/src/shared/domain/instructions-file.ts +18 -0
  474. package/src/shared/domain/iso-day.ts +4 -0
  475. package/src/shared/domain/llm-failure.ts +134 -0
  476. package/src/shared/domain/llm-profile.ts +44 -0
  477. package/src/shared/domain/marked-message.ts +29 -0
  478. package/src/shared/domain/markers.ts +30 -0
  479. package/src/shared/domain/messages.ts +291 -0
  480. package/src/shared/domain/model-catalog.ts +79 -0
  481. package/src/shared/domain/permission-modes.ts +99 -0
  482. package/src/shared/domain/prelude.ts +92 -0
  483. package/src/shared/domain/project-manifests.ts +84 -0
  484. package/src/shared/domain/prompts.ts +233 -0
  485. package/src/shared/domain/search-routing.ts +77 -0
  486. package/src/shared/domain/secret-patterns.ts +46 -0
  487. package/src/shared/domain/session-keys.ts +92 -0
  488. package/src/shared/domain/session-start.ts +61 -0
  489. package/src/shared/domain/severity.ts +72 -0
  490. package/src/shared/domain/sha1.ts +61 -0
  491. package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
  492. package/src/shared/domain/shared-memory/candidates.ts +40 -0
  493. package/src/shared/domain/shared-memory/entry.ts +151 -0
  494. package/src/shared/domain/shared-memory/front-matter.ts +187 -0
  495. package/src/shared/domain/shared-memory/gate.ts +45 -0
  496. package/src/shared/domain/shared-memory/harvest.ts +64 -0
  497. package/src/shared/domain/shared-memory/layout.ts +190 -0
  498. package/src/shared/domain/shared-memory/markers.ts +9 -0
  499. package/src/shared/domain/shared-memory/messages.ts +66 -0
  500. package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
  501. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  502. package/src/shared/domain/shared-memory/refused.ts +84 -0
  503. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  504. package/src/shared/domain/skills/prompts.ts +4 -0
  505. package/src/shared/domain/skills/shortlist.ts +149 -0
  506. package/src/shared/domain/snip-turns.ts +33 -0
  507. package/src/shared/domain/speech.ts +21 -0
  508. package/src/shared/domain/strip.ts +88 -0
  509. package/src/shared/domain/tool-trace.ts +120 -0
  510. package/src/shared/domain/types.ts +67 -0
  511. package/src/shared/domain/verifiers.ts +33 -0
  512. package/src/shared/domain/vfs.ts +16 -0
  513. package/src/shared/domain/workflow/prompts.ts +15 -0
  514. package/src/shared/domain/workflow/state-file.ts +142 -0
  515. package/src/shared/infrastructure/globals.ts +57 -0
  516. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  517. package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
  518. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  519. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  520. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  521. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  522. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  523. package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
  524. package/src/shared/infrastructure/orkeon/files.ts +58 -0
  525. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
  526. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  527. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  528. package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
  529. package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
  530. package/src/shared/infrastructure/orkeon/llm.ts +164 -0
  531. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  532. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  533. package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
  534. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  535. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  536. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  537. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  538. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  539. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  540. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  541. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  542. package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
  543. package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
  544. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  545. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  546. package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
  547. package/src/shared/infrastructure/orkeon/shell.ts +39 -0
  548. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  549. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
  550. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  551. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  552. package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
@@ -0,0 +1,75 @@
1
+ // /advisor: show, set or disable the advisor model (the /config key advisor.model), or ask for the second
2
+ // opinion it exists for. Only `review` (or `run`) costs an LLM call: it answers `{ launch: true }` and the
3
+ // command starts the advisor crew; every other form answers the lines the command prints.
4
+ //
5
+ // The model is checked against the host's declared catalogue and warned about, not refused:
6
+ // `Llm:AvailableModels` is a hand-written hint that can lag the provider (same rule as /model).
7
+ import { CONFIG_FILE_PATH } from "../../../shared/application/config-store.ts";
8
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
9
+ import type { Logger, SessionMetadata, Telemetry } from "../../../shared/application/ports.ts";
10
+ import { judgeModelChoice } from "../../../shared/domain/model-catalog.ts";
11
+ import {
12
+ ADVISOR_DISABLED, ADVISOR_UNSET, ADVISOR_USAGE, advisorModelLine, advisorSet, declaredModelsLine, refusingToOverwrite,
13
+ refusingUnparsed,
14
+ } from "./messages.ts";
15
+
16
+ const ADVISOR_KEY = "advisor.model";
17
+
18
+ export interface AdvisorDeps {
19
+ config: Pick<ConfigStore, "readValue" | "readFile" | "writeFile">;
20
+ telemetry: Pick<Telemetry, "readMetadata">;
21
+ log: Pick<Logger, "warn">;
22
+ }
23
+
24
+ export type AdvisorOutcome = { launch: true } | { lines: string[] };
25
+
26
+ async function declaredModels(telemetry: AdvisorDeps["telemetry"]): Promise<string[]> {
27
+ const md = await telemetry.readMetadata().catch((): SessionMetadata => ({}));
28
+ return md.availableModels ?? [];
29
+ }
30
+
31
+ /** `/advisor [show | off | review | <model>]`, from the command's raw tokens. */
32
+ export async function runAdvisorCommand(tokens: readonly string[], deps: AdvisorDeps): Promise<AdvisorOutcome> {
33
+ const { config, telemetry } = deps;
34
+ const first = (tokens[0] ?? "").toLowerCase();
35
+
36
+ // `review` is the only path that costs an LLM call, so it is explicit — a bare
37
+ // /advisor shows the setting and spends nothing.
38
+ if (first === "review" || first === "run") return { launch: true };
39
+
40
+ if (tokens.length === 0 || first === "show") {
41
+ const entry = await config.readValue(ADVISOR_KEY);
42
+ const models = await declaredModels(telemetry);
43
+ const lines = [
44
+ entry.value ? advisorModelLine(entry.value, entry.source) : ADVISOR_UNSET,
45
+ ];
46
+ if (models.length > 0) lines.push(declaredModelsLine(models));
47
+ lines.push(ADVISOR_USAGE);
48
+ return { lines };
49
+ }
50
+
51
+ if (first === "off" || first === "disable" || first === "none") {
52
+ const { map, malformed } = await config.readFile();
53
+ if (malformed) return { lines: [refusingUnparsed(CONFIG_FILE_PATH)] };
54
+ delete map[ADVISOR_KEY];
55
+ await config.writeFile(map);
56
+ return { lines: [ADVISOR_DISABLED] };
57
+ }
58
+
59
+ // Anything else is the model name.
60
+ const requested = tokens.join(" ").trim();
61
+ const verdict = judgeModelChoice(await declaredModels(telemetry), requested);
62
+ if (verdict.warning) deps.log.warn(verdict.warning);
63
+
64
+ const { map, malformed } = await config.readFile();
65
+ if (malformed) {
66
+ return {
67
+ lines: [refusingToOverwrite(CONFIG_FILE_PATH)],
68
+ };
69
+ }
70
+ map[ADVISOR_KEY] = requested;
71
+ await config.writeFile(map);
72
+ return {
73
+ lines: [advisorSet(requested, CONFIG_FILE_PATH, Boolean(verdict.warning))],
74
+ };
75
+ }
@@ -0,0 +1,137 @@
1
+ // /agents (B-12) — list, create, edit and delete saved agent configurations
2
+ // (baseline 04 §/agents: "…stored in `.orkeon/agents.json`").
3
+ //
4
+ // A FILE, not session state: a saved agent is meant to outlive the session, so
5
+ // /clear must not take someone's definitions with it. It sits beside
6
+ // config.json (B-6) under /workspace/.orkeon/, hand-editable on purpose.
7
+ //
8
+ // The listing merges two sources and labels them, because only one is mutable:
9
+ // the crews discovered by the host (what actually runs today) and this file.
10
+ // `edit` is `add` over an existing name — a REPL one-liner is a poor field editor,
11
+ // and an overwrite that says "replaced" is clearer than a partial patch.
12
+ //
13
+ // Note on scope: Orkeon Code does not DISPATCH a saved agent: no command turns a
14
+ // definition into a running agent, so the registry is honest storage, and the
15
+ // command says so rather than implying a launch. What does run as an agent is
16
+ // listed beside it: the built-in charters (A-3), each a background child of its
17
+ // dev step (the reviewer of /dev-plan, the auditor of the audit), which /tasks
18
+ // lists, stops, sends to and repairs.
19
+
20
+ import type { CrewHost, Files } from "../../../shared/application/ports.ts";
21
+ import { readJsonFile, writeJsonFile } from "../../../shared/application/json-file.ts";
22
+ import {
23
+ parseAgentRegistry, serializeAgentRegistry, validateSavedAgent,
24
+ upsertAgent, removeAgent, describeAgentRows,
25
+ } from "../../../shared/domain/agent-registry.ts";
26
+ import type { SavedAgent } from "../../../shared/domain/agent-registry.ts";
27
+ import { builtInCharterRows } from "../../../shared/domain/agents/built-in-charters.ts";
28
+ import type { CommandView } from "../view.ts";
29
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
30
+ import {
31
+ AGENTS_USAGE, SAVED_AGENTS_NOTE, agentRemoved, agentSaved, agentsFileLine, builtInCrewNotRemovable,
32
+ builtInCrewNotSaved, droppedAgents, fileLeftUntouched, noSavedAgent, noSavedAgentListHint, refusingToOverwrite,
33
+ refusingUnparsed, savedAgentShown, withAgentsUsage,
34
+ } from "./messages.ts";
35
+
36
+ export const AGENTS_FILE_PATH = `${WORKSPACE}/.orkeon/agents.json`;
37
+
38
+ export interface AgentsDeps {
39
+ files: Pick<Files, "read" | "write">;
40
+ crews: Pick<CrewHost, "listCrews">;
41
+ }
42
+
43
+ /** The same reading as config-store (B-6): absent is empty, and a file that could
44
+ * not be parsed — as JSON, or as a registry — is flagged so that nothing writes
45
+ * over it. */
46
+ async function readRegistry(
47
+ files: Pick<Files, "read">,
48
+ ): Promise<{ agents: SavedAgent[]; dropped: string[]; malformed: boolean }> {
49
+ const { value, malformed } = await readJsonFile(files, AGENTS_FILE_PATH);
50
+ if (malformed) return { agents: [], dropped: [], malformed: true };
51
+ try {
52
+ return { ...parseAgentRegistry(value), malformed: false };
53
+ } catch {
54
+ // An entry whose fields cannot even be read as text (`{"toString":1}`).
55
+ return { agents: [], dropped: [], malformed: true };
56
+ }
57
+ }
58
+
59
+ async function writeRegistry(files: Pick<Files, "write">, agents: readonly SavedAgent[]): Promise<void> {
60
+ await writeJsonFile(files, AGENTS_FILE_PATH, serializeAgentRegistry(agents));
61
+ }
62
+
63
+ /** `/agents [list|show|add|edit|remove|delete] …`, from the command's raw tokens. */
64
+ export async function runAgents(tokens: string[], deps: AgentsDeps): Promise<CommandView> {
65
+ const { files } = deps;
66
+ const sub = (tokens[0] ?? "list").toLowerCase();
67
+ const crews = deps.crews.listCrews();
68
+
69
+ switch (sub) {
70
+ case "list": {
71
+ const { agents, dropped, malformed } = await readRegistry(files);
72
+ const notes = [agentsFileLine(AGENTS_FILE_PATH)];
73
+ if (dropped.length > 0) notes.push(droppedAgents(dropped));
74
+ if (malformed) notes.push(fileLeftUntouched(AGENTS_FILE_PATH));
75
+ notes.push(SAVED_AGENTS_NOTE);
76
+ return { table: [...describeAgentRows(crews, agents), ...builtInCharterRows()], text: notes.join("\n") };
77
+ }
78
+
79
+ case "show": {
80
+ const name = String(tokens[1] ?? "").trim().toLowerCase();
81
+ const { agents } = await readRegistry(files);
82
+ const found = agents.find((a) => a.name === name);
83
+ if (found) {
84
+ return { text: savedAgentShown(found.name, found.role, found.goal, found.tools) };
85
+ }
86
+ if (crews.some((c) => c.toLowerCase() === name)) {
87
+ return { text: builtInCrewNotSaved(name) };
88
+ }
89
+ return { text: noSavedAgentListHint(name) };
90
+ }
91
+
92
+ case "add":
93
+ case "edit": {
94
+ // `add <name> <role> | <goal>` — the pipe separates two free-text fields, so
95
+ // neither has to be quoted in a REPL line.
96
+ const rest = tokens.slice(1).join(" ");
97
+ const [head, ...goalParts] = rest.split("|");
98
+ const headTokens = head.trim().split(/\s+/).filter(Boolean);
99
+ const name = headTokens.shift() ?? "";
100
+ const verdict = validateSavedAgent({
101
+ name,
102
+ role: headTokens.join(" "),
103
+ goal: goalParts.join("|").trim(),
104
+ });
105
+ if (!verdict.ok) return { text: withAgentsUsage(verdict.reason) };
106
+
107
+ const { agents, malformed } = await readRegistry(files);
108
+ if (malformed) {
109
+ return { text: refusingToOverwrite(AGENTS_FILE_PATH) };
110
+ }
111
+ const { agents: next, replaced } = upsertAgent(agents, verdict.agent);
112
+ await writeRegistry(files, next);
113
+ return { text: agentSaved(verdict.agent.name, replaced, AGENTS_FILE_PATH) };
114
+ }
115
+
116
+ case "remove":
117
+ case "delete": {
118
+ const name = String(tokens[1] ?? "").trim();
119
+ if (name.length === 0) return { text: AGENTS_USAGE };
120
+ const { agents, malformed } = await readRegistry(files);
121
+ if (malformed) return { text: refusingUnparsed(AGENTS_FILE_PATH) };
122
+ const { agents: next, removed } = removeAgent(agents, name);
123
+ if (!removed) {
124
+ return {
125
+ text: crews.some((c) => c.toLowerCase() === name.toLowerCase())
126
+ ? builtInCrewNotRemovable(name)
127
+ : noSavedAgent(name),
128
+ };
129
+ }
130
+ await writeRegistry(files, next);
131
+ return { text: agentRemoved(name, AGENTS_FILE_PATH) };
132
+ }
133
+
134
+ default:
135
+ return { text: AGENTS_USAGE };
136
+ }
137
+ }
@@ -0,0 +1,8 @@
1
+ // The options of a panel from plain values.
2
+ import type { ChoiceOption } from "../../../shared/application/ports.ts";
3
+
4
+ /** One option per value, the one in force marked: a model's name matches whatever its case. */
5
+ export function optionsOf(values: readonly string[], current: string): ChoiceOption[] {
6
+ const active = current.toLowerCase();
7
+ return values.map((value) => (value.toLowerCase() === active ? { value, current: true } : { value }));
8
+ }
@@ -0,0 +1,141 @@
1
+ // /config (E-1, schema + persistence in B-6) — read/write settings over a
2
+ // DECLARED key space, in two layers (baseline 04 §/config).
3
+ //
4
+ // Before B-6 this was a free-form session map: any key was accepted, a typo was
5
+ // stored and never read, and nothing survived /clear. That mattered as
6
+ // soon as B-2 added `permissions.fallback`, a key whose job is to state the
7
+ // session's permission posture — `/config set permissions.fallbck bypass…`
8
+ // reported success and changed nothing.
9
+ //
10
+ // file /workspace/.orkeon/config.json survives everything
11
+ // session state bag overrides the file until /clear
12
+
13
+ import {
14
+ CONFIG_KEYS, configKeySpec, knownConfigKeys, resolveConfigEntry, validateConfigEntry,
15
+ } from "../../../shared/domain/config-schema.ts";
16
+ import { CONFIG_FILE_PATH, USER_CONFIG_FILE_PATH } from "../../../shared/application/config-store.ts";
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";
22
+ import type { CommandView } from "../view.ts";
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";
25
+
26
+ export interface ConfigDeps {
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;
32
+ }
33
+
34
+ /** `--session` selects the session layer; the default is the persisted file. */
35
+ function takeSessionFlag(tokens: string[]): { session: boolean; rest: string[] } {
36
+ const rest = tokens.filter((t) => t !== "--session");
37
+ return { session: rest.length !== tokens.length, rest };
38
+ }
39
+
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. */
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> {
54
+ const { config } = deps;
55
+ const { session: useSession, rest } = takeSessionFlag(tokens);
56
+ const [sub, key, ...valueParts] = rest;
57
+
58
+ switch ((sub ?? "list").toLowerCase()) {
59
+ case "list": {
60
+ const view = await config.readView();
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));
65
+ return {
66
+ table: view.entries.map((e) => ({ key: e.key, value: e.value ?? "(unset)", source: e.source })),
67
+ text: notes.join("\n"),
68
+ };
69
+ }
70
+
71
+ case "keys":
72
+ return {
73
+ table: CONFIG_KEYS.map((s) => ({
74
+ key: s.key,
75
+ allowed: s.allowed ? s.allowed.join(" | ") : "(any)",
76
+ "read by": s.consumedBy,
77
+ })),
78
+ text: KEYS_NOTE,
79
+ };
80
+
81
+ case "get": {
82
+ if (!key) return { text: CONFIG_GET_USAGE };
83
+ const spec = configKeySpec(key);
84
+ if (!spec) return { text: unknownConfigKey(key, knownConfigKeys()) };
85
+ const view = await config.readView();
86
+ const entry = view.entries.find((e) => e.key === key)!;
87
+ return {
88
+ text: entry.value === undefined
89
+ ? keyUnset(key, spec.description)
90
+ : keyValue(key, entry.value, entry.source),
91
+ };
92
+ }
93
+
94
+ case "set": {
95
+ const value = valueParts.join(" ");
96
+ // ACCEPTANCE 1: an unknown key is refused WITH the list.
97
+ const verdict = validateConfigEntry(key, value);
98
+ if (!verdict.ok) return { text: verdict.reason };
99
+
100
+ if (useSession) {
101
+ const map = await config.readSession();
102
+ map[key] = value;
103
+ await config.writeSession(map);
104
+ return { text: sessionValueSet(key, value) };
105
+ }
106
+ const { map, malformed } = await config.readFile();
107
+ if (malformed) {
108
+ return { text: refusingToOverwrite(CONFIG_FILE_PATH) };
109
+ }
110
+ map[key] = value;
111
+ await config.writeFile(map);
112
+ const persisted = fileValueSet(key, value, CONFIG_FILE_PATH);
113
+ // A project file widens nothing past the user settings (LI-6): the value is kept, and said to be set aside.
114
+ const { map: user, malformed: userMalformed } = await config.readUserFile();
115
+ const { ignored } = resolveConfigEntry(key, map, {}, user);
116
+ if (ignored === undefined) return { text: persisted };
117
+ const unread = userMalformed ? userSettingsUnparsed(USER_CONFIG_FILE_PATH) : "";
118
+ return { text: valueIgnored(persisted, ignored.value, ignored.reason, unread) };
119
+ }
120
+
121
+ case "unset": {
122
+ if (!key) return { text: CONFIG_UNSET_USAGE };
123
+ if (useSession) {
124
+ const map = await config.readSession();
125
+ if (!(key in map)) return { text: noSessionOverride(key) };
126
+ delete map[key];
127
+ await config.writeSession(map);
128
+ return { text: sessionOverrideRemoved(key) };
129
+ }
130
+ const { map, malformed } = await config.readFile();
131
+ if (malformed) return { text: refusingUnparsed(CONFIG_FILE_PATH) };
132
+ if (!(key in map)) return { text: keyNotInFile(key, CONFIG_FILE_PATH) };
133
+ delete map[key];
134
+ await config.writeFile(map);
135
+ return { text: keyRemoved(key, CONFIG_FILE_PATH) };
136
+ }
137
+
138
+ default:
139
+ return { text: CONFIG_USAGE };
140
+ }
141
+ }
@@ -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
+ }
@@ -0,0 +1,50 @@
1
+ // /hooks — the session's hook registry (session state): list, add, remove. The dev steps (/dev-spec, /dev-plan and
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, 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
+ // assistant does not run them yet, and nothing runs a stop hook. Not a command file: the loader reads *.cmd.ts only.
6
+ import type { SessionStore } from "../../../shared/application/ports.ts";
7
+ import { readJsonArray, writeJson } from "../../../shared/application/session-state.ts";
8
+ import { shellOperatorIn } from "../../../shared/domain/dev/call-guard.ts";
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";
13
+
14
+ export const HOOK_EVENTS = ["pre-tool", "post-tool", "stop"] as const;
15
+
16
+ export interface HookRow { n: number; event: string; command: string }
17
+
18
+ /** What /hooks shows: a table of the hooks when it lists some, then its text. */
19
+ export interface HooksOutcome { table?: HookRow[]; text: string }
20
+
21
+ export async function runHooks(tokens: readonly string[], session: Pick<SessionStore, "readState" | "writeState">): Promise<HooksOutcome> {
22
+ const [sub, event, ...rest] = tokens;
23
+ const hooks = (await readJsonArray(session, HOOKS_STATE_KEY)) as Array<{ event: string; command: string }>;
24
+ switch ((sub ?? "list").toLowerCase()) {
25
+ case "list":
26
+ if (hooks.length === 0) return { text: NO_HOOKS };
27
+ return { table: hooks.map((h, i) => ({ n: i + 1, event: h.event, command: h.command })), text: HOOKS_STATUS };
28
+ case "add": {
29
+ const command = rest.join(" ");
30
+ if (!(HOOK_EVENTS as readonly string[]).includes(String(event)) || !command) return { text: hooksAddUsage(HOOK_EVENTS) };
31
+ // The shell tool runs one program and its arguments: the hook would fail at every call.
32
+ const operator = shellOperatorIn(command);
33
+ if (operator !== undefined) {
34
+ return { text: hookOperatorRefused(operator.replace(/\n/g, "\\n")) };
35
+ }
36
+ hooks.push({ event, command });
37
+ await writeJson(session, HOOKS_STATE_KEY, hooks);
38
+ return { text: hookAdded(hooks.length, event) };
39
+ }
40
+ case "remove": {
41
+ const n = Number(event);
42
+ if (!Number.isInteger(n) || n < 1 || n > hooks.length) return { text: hooksRemoveUsage(hooks.length || 1) };
43
+ hooks.splice(n - 1, 1);
44
+ await writeJson(session, HOOKS_STATE_KEY, hooks);
45
+ return { text: hookRemoved(n) };
46
+ }
47
+ default:
48
+ return { text: HOOKS_USAGE };
49
+ }
50
+ }