orkeon-code 0.0.0-stage → 1.0.0-rc.1

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 (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,146 @@
1
+ // /voice: dictate a request. The Whisper MCP server (mcp/whisper) records this
2
+ // machine's microphone until a silence and transcribes it (record_and_transcribe,
3
+ // refused unless the launcher ran with ORKEON_CODE_VOICE=1).
4
+ //
5
+ // Three uses, one dictation at a time:
6
+ // - /voice records and shows the text, which the server keeps as
7
+ // /transcripts/dictation.txt: nothing is sent yet (the confirmation);
8
+ // - /voice send sends that text to the assistant, as /assistant would;
9
+ // - /voice --go records and sends at once: the main loop makes the call before
10
+ // the turn and takes its text as the request (a prelude, `as: "request"`).
11
+ // Recording and transcribing last longer than the 10 s a handler may wait, so
12
+ // the call is made by a crew: the speech crew, or the main loop for --go.
13
+ import type { Files, ToolCatalogue } from "../../../shared/application/ports.ts";
14
+ import { errorText, nothingReturned } from "../../../shared/domain/prelude.ts";
15
+ import { commandLine, isOption, optionValue, parseAssistantInput, splitWords } from "../args.ts";
16
+ import { launchCrew, launchMainLoop, withLlmProfile } from "../dispatch.ts";
17
+ import type { CrewCompletion, LaunchResult, MainLoopLaunchDeps } from "../dispatch.ts";
18
+ import { missingToolMessage } from "./transcribe.ts";
19
+
20
+ export const RECORD_TOOL = "record_and_transcribe";
21
+ export const DICTATION_FILE = "/transcripts/dictation.txt";
22
+ const DEFAULT_MAX_SECONDS = 60;
23
+ const DEFAULT_SILENCE_SECONDS = 2;
24
+
25
+ export const VOICE_USAGE =
26
+ 'usage: /voice [--go] [--lang <code>] [--prompt "<words>"] [--max <seconds>] [--silence <seconds>]\n' +
27
+ " /voice send";
28
+
29
+ export type VoiceRequest =
30
+ | { kind: "record"; go: boolean; language: string; vocabulary: string; maxSeconds: number; silenceSeconds: number }
31
+ | { kind: "send" };
32
+
33
+ export type ParsedVoice = { ok: true; request: VoiceRequest } | { ok: false; error: string };
34
+
35
+ /** A number option within bounds, or the reason it is not one. */
36
+ function seconds(option: string, value: string | null, min: number, max: number): number | string {
37
+ const n = value === null ? Number.NaN : Number(value);
38
+ if (!Number.isFinite(n) || n < min || n > max) return `${option} takes seconds between ${min} and ${max}`;
39
+ return n;
40
+ }
41
+
42
+ /** The arguments of /voice: `send` alone, or the recording options. */
43
+ export function parseVoiceArgs(tokens: readonly string[]): ParsedVoice {
44
+ const words = splitWords(commandLine(tokens));
45
+ if (words.length === 1 && words[0].text === "send" && !words[0].quoted) return { ok: true, request: { kind: "send" } };
46
+ const request = {
47
+ kind: "record" as const, go: false, language: "", vocabulary: "",
48
+ maxSeconds: DEFAULT_MAX_SECONDS, silenceSeconds: DEFAULT_SILENCE_SECONDS,
49
+ };
50
+ for (let i = 0; i < words.length; i++) {
51
+ const word = words[i].text;
52
+ if (!isOption(words[i])) {
53
+ if (word === "send") return { ok: false, error: "send takes no option and no quotes: /voice send sends the last dictation" };
54
+ return { ok: false, error: `unknown argument ${word}` };
55
+ } else if (word === "--go") {
56
+ request.go = true;
57
+ } else if (word === "--lang" || word === "--language") {
58
+ const value = optionValue(words, i++);
59
+ if (value === null) return { ok: false, error: `${word} needs a language code (fr, en...)` };
60
+ request.language = value;
61
+ } else if (word === "--prompt") {
62
+ const value = optionValue(words, i++);
63
+ if (value === null) return { ok: false, error: '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")' };
64
+ request.vocabulary = value;
65
+ } else if (word === "--max" || word === "--silence") {
66
+ const value = optionValue(words, i++);
67
+ const parsed = word === "--max" ? seconds(word, value, 1, 600) : seconds(word, value, 0.5, 10);
68
+ if (typeof parsed === "string") return { ok: false, error: parsed };
69
+ if (word === "--max") request.maxSeconds = parsed;
70
+ else request.silenceSeconds = parsed;
71
+ } else {
72
+ return { ok: false, error: `unknown option ${word}` };
73
+ }
74
+ }
75
+ return { ok: true, request };
76
+ }
77
+
78
+ /** The arguments of record_and_transcribe (the server's parameter names). */
79
+ export function recordArgs(request: Extract<VoiceRequest, { kind: "record" }>): Record<string, unknown> {
80
+ const args: Record<string, unknown> = { max_seconds: request.maxSeconds, silence_seconds: request.silenceSeconds };
81
+ if (request.language) args.language = request.language;
82
+ if (request.vocabulary) args.vocabulary = request.vocabulary;
83
+ return args;
84
+ }
85
+
86
+ /** The line shown when the microphone opens. */
87
+ export function recordingNotice(request: Extract<VoiceRequest, { kind: "record" }>): string {
88
+ return `🎙 recording: speak, then stay silent ${request.silenceSeconds} s to stop (${request.maxSeconds} s at most)` +
89
+ (request.go ? "; the text goes straight to the assistant" : "");
90
+ }
91
+
92
+ /** What /voice reads and drives: the registered tools, the files (the last dictation, for
93
+ * send), the crew and main-loop launches, and the console for the recording notice. */
94
+ export type VoiceDeps = MainLoopLaunchDeps & {
95
+ catalogue: Pick<ToolCatalogue, "find">;
96
+ files: Pick<Files, "read">;
97
+ out: { writeLine(text: string): void };
98
+ };
99
+
100
+ const NOTHING_TO_SEND = `no dictation to send: /voice records one (it is kept in ${DICTATION_FILE})`;
101
+
102
+ /** Launch what the request asks and return its ticket, or the message to show when it launches nothing. */
103
+ export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps): Promise<LaunchResult | { message: string }> {
104
+ const parsed = parseVoiceArgs(tokens);
105
+ if (!parsed.ok) return { message: `${parsed.error}\n${VOICE_USAGE}` };
106
+ const { request } = parsed;
107
+ if (request.kind === "send") {
108
+ let text: string;
109
+ try {
110
+ text = (await deps.files.read(DICTATION_FILE)).trim();
111
+ } catch (error) {
112
+ // A missing file is the common case (no dictation yet); the runtime's read says so, as json-file.ts reads it.
113
+ if (/not found|no such|does not exist/i.test(errorText(error))) return { message: NOTHING_TO_SEND };
114
+ return { message: `cannot read ${DICTATION_FILE}: ${errorText(error)}` };
115
+ }
116
+ if (text.length === 0) return { message: NOTHING_TO_SEND };
117
+ const { prompt, permissionMode } = parseAssistantInput(text);
118
+ return await launchMainLoop(deps, { prompt, permissionMode });
119
+ }
120
+ const registered = deps.catalogue.find(RECORD_TOOL);
121
+ if (registered === undefined) return { message: missingToolMessage(RECORD_TOOL) };
122
+ deps.out.writeLine(recordingNotice(request));
123
+ const args = recordArgs(request);
124
+ if (request.go) {
125
+ return await launchMainLoop(deps, {
126
+ prompt: "", permissionMode: null, prelude: { tool: registered, args, label: "Dictation", as: "request" },
127
+ });
128
+ }
129
+ return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: registered, args, label: "dictation" }, args);
130
+ }
131
+
132
+ /**
133
+ * The lines a completion writes: the dictation and what to do with it, or the assistant's answer. The
134
+ * crew that answered is the completion's `intent` (the script host reports every crew as the agent
135
+ * "script-host", and the crew's name as the intent).
136
+ */
137
+ export function renderVoiceCompletion(result: CrewCompletion & { agent?: string; intent?: string }): string[] {
138
+ if (!result.success) return [`✗ voice failed: ${result.error ?? "unknown"}`];
139
+ const payload = (result.payload ?? "").trim();
140
+ if (result.intent !== "speech") return [payload];
141
+ // The crew names the tool as the host registers it: compared case aside.
142
+ if (payload.length === 0 || payload.toLowerCase() === nothingReturned(RECORD_TOOL).toLowerCase()) {
143
+ return ["nothing was heard: /voice records again"];
144
+ }
145
+ return [`🎙 ${payload}`, "send it: /voice send · edit it: /assistant <text> · record again: /voice"];
146
+ }
@@ -0,0 +1,31 @@
1
+ // The prompt-cache columns /usage and /context show (RT-12): the tokens read
2
+ // from the provider's cache and written to it, over every model of the session,
3
+ // `n/a` when no model reported the count (Orkeon #254: not measured, never 0). With the host's usage account they
4
+ // come from it alone, `n/a` for what it did not measure: never one figure from each source.
5
+ // Lives under commands/_lib/ — the loader's SearchPattern is "*.cmd.ts", so this
6
+ // file is never loaded as a command.
7
+
8
+ import type { SessionStats, UsageSpent } from "../../../shared/application/ports.ts";
9
+
10
+ /** What a column shows for a figure nobody reported: never 0, which would read as measured. */
11
+ export const UNREPORTED = "n/a";
12
+ export type Unreported = typeof UNREPORTED;
13
+
14
+ /** A count as a column shows it: the number when measured, 0 included; `n/a` when null or absent. */
15
+ export function shown(count: number | null | undefined): number | Unreported {
16
+ return count ?? UNREPORTED;
17
+ }
18
+
19
+ export interface CacheColumns {
20
+ cacheRead: number | Unreported;
21
+ cacheWrite: number | Unreported;
22
+ }
23
+
24
+ /** The cache columns: from the host's account when it keeps one (`report`), else from the telemetry's sums. */
25
+ export function cacheColumns(
26
+ s: Pick<SessionStats, "cacheHitTokens" | "cacheWriteTokens">,
27
+ report?: Pick<UsageSpent, "cacheHitTokens" | "cacheWriteTokens">,
28
+ ): CacheColumns {
29
+ const from = report ?? s;
30
+ return { cacheRead: shown(from.cacheHitTokens), cacheWrite: shown(from.cacheWriteTokens) };
31
+ }
@@ -0,0 +1,57 @@
1
+ // /context — the session's context in one row: metadata, buffer size, the tokens used against the
2
+ // window, the pressure tier, the compaction boundaries, the prompt-cache tokens (from the host's usage
3
+ // account when it keeps one, as /usage takes them), and the tokens by kind of entry when the host reports
4
+ // them (Orkeon #226). A count the host does not report reads `n/a`, never 0. Lives under commands/_lib/ — the loader's
5
+ // SearchPattern is "*.cmd.ts", so this file is never loaded as a command.
6
+
7
+ import type {
8
+ SessionMetadata, SessionStats, SessionStore, Telemetry, TokenBudget, TokenKinds, UsageReader,
9
+ } from "../../../shared/application/ports.ts";
10
+ import { DEFAULT_CONTEXT_WINDOW, percentLeft, pressureTier } from "../../../shared/domain/compaction-thresholds.ts";
11
+ import { countCompactBoundaries } from "../../../shared/domain/compaction.ts";
12
+ import { cacheColumns, shown } from "./cache.ts";
13
+ import type { CommandView } from "../view.ts";
14
+
15
+ export interface ContextDeps {
16
+ session: Pick<SessionStore, "readBudget" | "readMessages">;
17
+ telemetry: Pick<Telemetry, "readMetadata" | "readStats">;
18
+ /** The host's account; when it keeps one, the cache columns come from it alone. */
19
+ usage?: UsageReader;
20
+ }
21
+
22
+ /** The by-kind columns: one per kind the host reports, none for an older host. */
23
+ export function kindColumns(kinds: TokenKinds | undefined): Record<string, number> {
24
+ if (kinds === undefined) return {};
25
+ return {
26
+ systemTokens: kinds.system,
27
+ userTokens: kinds.user,
28
+ assistantTokens: kinds.assistant,
29
+ toolTokens: kinds.tool,
30
+ otherTokens: kinds.other,
31
+ };
32
+ }
33
+
34
+ /** `/context`: the one row, each figure read best effort. */
35
+ export async function runContext(deps: ContextDeps): Promise<CommandView> {
36
+ const md = await deps.telemetry.readMetadata().catch((): SessionMetadata => ({}));
37
+ const budget = await deps.session.readBudget().catch((): TokenBudget => ({ used: 0, window: 0 }));
38
+ const stats = await deps.telemetry.readStats().catch((): SessionStats => ({}));
39
+ const boundaries = countCompactBoundaries((await deps.session.readMessages().catch(() => ({ stored: [] }))).stored);
40
+ const { used, window } = budget;
41
+ return {
42
+ table: [{
43
+ title: md.title ?? "(untitled)",
44
+ model: md.model ?? "?",
45
+ messages: shown(md.messageCount),
46
+ estTokens: shown(md.estimatedTokens),
47
+ usedTokens: used,
48
+ window: window || DEFAULT_CONTEXT_WINDOW,
49
+ remaining: Math.max(0, (window || DEFAULT_CONTEXT_WINDOW) - used),
50
+ pressure: pressureTier(used, window),
51
+ percentLeft: percentLeft(used, window) + "%",
52
+ compactions: boundaries,
53
+ ...kindColumns(budget.byKind),
54
+ ...cacheColumns(stats, deps.usage?.report()),
55
+ }],
56
+ };
57
+ }
@@ -0,0 +1,186 @@
1
+ // /doctor — health check: runtime, LLM reachability, tools, mounts
2
+ // (baseline 04 §/doctor: "validate the runtime environment, configuration
3
+ // integrity, API connectivity, and tool availability; emit a per-check
4
+ // pass/fail report").
5
+ //
6
+ // B-11 deepening. The pre-B-11 version probed three binary versions
7
+ // (node/git/dotnet) and stopped, so the four checks the baseline asks for were one:
8
+ // nothing looked at the LLM configuration, the tool catalogue or the VFS mounts.
9
+ //
10
+ // Today's debugging round is the argument for this: a REPL booted with no `Llm`
11
+ // section answered every turn with silence, and /doctor — the command whose entire
12
+ // job is to say "this host is not going to work" — reported three green rows.
13
+ //
14
+ // What "LLM" can honestly check from script-land: whether the host reports a model
15
+ // at all. Reachability would need a real call, i.e. money and a wait, so the check
16
+ // says what it verified and what it did not rather than implying a ping.
17
+
18
+ import type {
19
+ Files, RuntimeInfo, RuntimeInfoReader, SessionMetadata, Shell, Telemetry, ToolCatalogue,
20
+ } from "../../../shared/application/ports.ts";
21
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
22
+ import { CODE_INTEL_TOOLS } from "../../../shared/domain/code-intel-contract.ts";
23
+ import { knownConfigKeys } from "../../../shared/domain/config-schema.ts";
24
+ import { CLI_BUILD, CLI_NAME, CLI_VERSION, isPinnedCommit, ORKEON_RUNTIME_PIN } from "./meta.ts";
25
+ import type { CommandView } from "../view.ts";
26
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
27
+
28
+ /** Tools the coding agent cannot work without — absence is a FAIL, not a note. */
29
+ export const ESSENTIAL_TOOLS = ["file_read", "file_write", "shell_command", "directory_read", "session_store"];
30
+
31
+ /** Where the runtime kept the sessions before the launcher mounted them outside the project. */
32
+ export const OLD_SESSIONS_DIR = `${WORKSPACE}/.orkeon/sessions`;
33
+
34
+ export type DoctorRow = { check: string; result: string; detail: string };
35
+ export const PASS = "✅";
36
+ export const WARN = "⚠";
37
+ export const FAIL = "❌";
38
+
39
+ export interface DoctorDeps {
40
+ shell: Shell;
41
+ telemetry: Pick<Telemetry, "readMetadata">;
42
+ catalogue: Pick<ToolCatalogue, "names">;
43
+ files: Pick<Files, "mounts" | "list">;
44
+ config: Pick<ConfigStore, "readValue">;
45
+ /** The running runtime's reader (Orkeon #225); absent, or answering nothing: the version row names the pin alone. */
46
+ runtime?: RuntimeInfoReader;
47
+ }
48
+
49
+ /** Code's own version, the version row starts with. */
50
+ export const CODE_VERSION_DETAIL = `${CLI_NAME} ${CLI_VERSION} (${CLI_BUILD})`;
51
+
52
+ /** The version row: Code's own, then the running Orkeon, by the commit its build carries, against the commit
53
+ * pinned by .orkeon-version: a pass when they are the same, a warning when they differ or the runtime reports no
54
+ * commit; when the host names no runtime, the pin alone and where the launcher says what it found. */
55
+ export function versionRow(runtime: RuntimeInfo | undefined): DoctorRow {
56
+ if (runtime === undefined) {
57
+ return {
58
+ check: "version",
59
+ result: PASS,
60
+ detail: `${CODE_VERSION_DETAIL}; Orkeon expected at commit ${ORKEON_RUNTIME_PIN} (.orkeon-version), the host names no runtime: ` +
61
+ "orkeon-code --version in a terminal says the one found",
62
+ };
63
+ }
64
+ const found = `Orkeon ${runtime.version}${runtime.commit ? `+${runtime.commit}` : ""} (${runtime.channel})`;
65
+ return isPinnedCommit(runtime.commit)
66
+ ? { check: "version", result: PASS, detail: `${CODE_VERSION_DETAIL}; ${found}, the pin of .orkeon-version` }
67
+ : {
68
+ check: "version",
69
+ result: WARN,
70
+ detail: `${CODE_VERSION_DETAIL}; ${found} runs, commit ${ORKEON_RUNTIME_PIN} expected (.orkeon-version): ` +
71
+ "the commands were checked against the pin",
72
+ };
73
+ }
74
+
75
+ /** Every check, one row each, and the verdict over them. */
76
+ export async function runDoctor(deps: DoctorDeps): Promise<CommandView> {
77
+ const { shell, telemetry, catalogue, files } = deps;
78
+ const rows: DoctorRow[] = [versionRow(deps.runtime?.read())];
79
+
80
+ // 1. Toolchain (unchanged in intent, now one row per binary with the version).
81
+ for (const p of [
82
+ { tool: "node", cmd: "node --version" },
83
+ { tool: "git", cmd: "git --version" },
84
+ { tool: "dotnet", cmd: "dotnet --version" },
85
+ ]) {
86
+ try {
87
+ const r = await shell.run(p.cmd);
88
+ const ok = r.exitCode === 0;
89
+ rows.push({ check: `toolchain: ${p.tool}`, result: ok ? PASS : FAIL, detail: r.stdout.trim() || "(no output)" });
90
+ } catch (e: any) {
91
+ rows.push({ check: `toolchain: ${p.tool}`, result: FAIL, detail: String(e?.message ?? e).split("\n")[0] });
92
+ }
93
+ }
94
+
95
+ // 2. LLM configuration — the check that was missing when it was needed.
96
+ const md = await telemetry.readMetadata().catch((): SessionMetadata => ({}));
97
+ const model = (md.model ?? "").trim();
98
+ const declared = md.availableModels ?? [];
99
+ rows.push({
100
+ check: "llm: model configured",
101
+ result: model ? PASS : FAIL,
102
+ detail: model
103
+ ? `${model} (not pinged — a reachability test costs a real call)`
104
+ : "the host reports NO model: expect every /assistant turn to no-op. Check the `Llm` section of the settings file.",
105
+ });
106
+ rows.push({
107
+ check: "llm: declared catalogue",
108
+ result: declared.length > 0 ? PASS : WARN,
109
+ detail: declared.length > 0
110
+ ? declared.join(", ")
111
+ : "no Llm:AvailableModels — /model cannot offer a choice or flag an unserved name",
112
+ });
113
+
114
+ // 3. Tool catalogue.
115
+ const available = new Set(catalogue.names());
116
+ const missingEssential = ESSENTIAL_TOOLS.filter((t) => !available.has(t));
117
+ rows.push({
118
+ check: "tools: essential",
119
+ result: missingEssential.length === 0 ? PASS : FAIL,
120
+ detail: missingEssential.length === 0
121
+ ? `${available.size} registered, all ${ESSENTIAL_TOOLS.length} essentials present`
122
+ : `MISSING: ${missingEssential.join(", ")}`,
123
+ });
124
+ const missingIntel = CODE_INTEL_TOOLS.filter((t) => !available.has(t));
125
+ rows.push({
126
+ check: "tools: code intelligence",
127
+ result: missingIntel.length === 0 ? PASS : WARN,
128
+ detail: missingIntel.length === 0
129
+ ? `all ${CODE_INTEL_TOOLS.length} present`
130
+ : `absent: ${missingIntel.join(", ")} — the agent falls back to reading files`,
131
+ });
132
+
133
+ // 4. VFS mounts — /workspace read-write is the precondition for everything.
134
+ try {
135
+ const list = await files.mounts();
136
+ const described = list.map((m) => `${m.path}(${m.rights ?? "?"})`);
137
+ const workspace = list.find((m) => m.path === WORKSPACE);
138
+ const hasWorkspace = workspace !== undefined
139
+ && (workspace.rights === "rw" || workspace.rights === "rwnd");
140
+ rows.push({
141
+ check: "vfs: mounts",
142
+ result: hasWorkspace ? PASS : FAIL,
143
+ // /workspace read-WRITE is the precondition for everything the agent does;
144
+ // a read-only mount would fail every edit with a permissions error later.
145
+ detail: (described.join(" ") || "(none)") +
146
+ (hasWorkspace ? "" : ` ← ${WORKSPACE} is missing or not writable`),
147
+ });
148
+ } catch (e: any) {
149
+ rows.push({ check: "vfs: mounts", result: WARN, detail: `list_mounts unavailable: ${String(e?.message ?? e).split("\n")[0]}` });
150
+ }
151
+
152
+ // 5. Sessions left in the project: the runtime kept them in /workspace/.orkeon/sessions
153
+ // before the launcher mounted /sessions outside the project (QL-04). Left alone, named here.
154
+ const inProject = await files.list(OLD_SESSIONS_DIR, 1).catch((): string[] => []);
155
+ rows.push({
156
+ check: "sessions: outside the project",
157
+ result: inProject.length === 0 ? PASS : WARN,
158
+ detail: inProject.length === 0
159
+ ? "nothing in .orkeon/sessions"
160
+ : `${OLD_SESSIONS_DIR} holds sessions of an older start, left alone: sessions now live in the launcher's state folder, outside the project ` +
161
+ "(orkeon-code --resume lists them); delete the folder once you no longer need it",
162
+ });
163
+
164
+ // 6. What the project file set and could not widen (QL-06): said here as /permissions says it.
165
+ const ignored: string[] = [];
166
+ for (const key of knownConfigKeys()) {
167
+ const r = await deps.config.readValue(key).catch(() => undefined);
168
+ if (r?.ignored !== undefined) ignored.push(`the project file sets ${key} '${r.ignored.value}': ignored, ${r.ignored.reason}`);
169
+ }
170
+ rows.push({
171
+ check: "settings: project file",
172
+ result: ignored.length === 0 ? PASS : WARN,
173
+ detail: ignored.length === 0 ? "widens nothing" : ignored.join("; "),
174
+ });
175
+
176
+ const failed = rows.filter((r) => r.result === FAIL).length;
177
+ const warned = rows.filter((r) => r.result === WARN).length;
178
+ return {
179
+ table: rows,
180
+ text: failed > 0
181
+ ? `${failed} check(s) FAILED, ${warned} warning(s) — the host is not fully usable.`
182
+ : warned > 0
183
+ ? `all checks passed, ${warned} warning(s).`
184
+ : "all checks passed.",
185
+ };
186
+ }
@@ -0,0 +1,45 @@
1
+ // Static CLI metadata shared by /status (version) and /release-notes. No IO.
2
+ //
3
+ // Orkeon Code versions independently of the Orkeon runtime it runs on: the
4
+ // runtime is pinned to a commit of Orkeon's main in .orkeon-version, this one follows
5
+ // package.json (tests/repository/version.test.ts keeps the two equal). The counts and crew names in
6
+ // RELEASE_NOTES are pinned by tests/commands/_lib/status/meta.test.ts, which keeps them true.
7
+
8
+ export const CLI_NAME = "orkeon-code";
9
+ export const CLI_VERSION = "1.0.0-rc.1";
10
+ export const CLI_BUILD = "source";
11
+ /** The Orkeon runtime this version runs on: the commit of Orkeon's `main` pinned in .orkeon-version, which the
12
+ * launcher announces (tests/repository/version.test.ts keeps the two equal). A release tag is never the pin: the
13
+ * commands are checked against the sources at this commit (ADR 0013). /status and /doctor compare it with the
14
+ * commit of the runtime that runs them, read from the host's `runtime` service (Orkeon #225). */
15
+ export const ORKEON_RUNTIME_COMMIT = "839818d6aedefd96954bc470d4cefa6541aec1ba";
16
+ /** The pin as the launcher and the rows print it: its first seven characters. */
17
+ export const ORKEON_RUNTIME_PIN = ORKEON_RUNTIME_COMMIT.slice(0, 7);
18
+
19
+ /** Whether a runtime's commit (as its build metadata carries it, short or full; null when none) is the pin: the
20
+ * pin, or at least seven leading characters of it. A commit with a suffix (`-dirty`: a build with local changes)
21
+ * is not the pin. */
22
+ export function isPinnedCommit(commit: string | null): boolean {
23
+ return commit !== null && commit.length >= 7 && ORKEON_RUNTIME_COMMIT.startsWith(commit);
24
+ }
25
+
26
+ export const RELEASE_NOTES = [
27
+ `${CLI_NAME} ${CLI_VERSION} (${CLI_BUILD})`,
28
+ "",
29
+ `First release candidate of 1.0.0, on Orkeon main ${ORKEON_RUNTIME_PIN}.`,
30
+ "",
31
+ "Crews: main-loop (the interactive loop behind /assistant), code-review, git-commit,",
32
+ " project-init, init-verifiers, session-compact, advisor, analyze, speech,",
33
+ " dev-verify, dev-learn, dev-plan, dev-spec, dev-change, dev-implement, dev-batches,",
34
+ " shared-memory-admit, agent-run.",
35
+ "Commands: 48 slash commands; free text without a leading / goes to /assistant.",
36
+ "Permissions: five modes (default, acceptEdits, plan, dontAsk, bypassPermissions),",
37
+ " deny/allow rules (argument patterns too) enforced by the host gate,",
38
+ " questions before writes and commands, /mode for the session default.",
39
+ "Extra tools: tools.extra offers an MCP server's or a plugin's tools to the assistant.",
40
+ "Speech: the MCP server of mcp/whisper, /transcribe [--then], /voice (dictation), /say (read aloud).",
41
+ "Context: automatic compaction with a persistent breaker, snip-first /compact,",
42
+ " file restore after compaction, context pressure tiers.",
43
+ "Models: /model switches the model per turn; /model list offers Llm:AvailableModels.",
44
+ "Code intelligence: index, maps, dependency graph and symbol tools of the Orkeon runtime.",
45
+ ].join("\n");
@@ -0,0 +1,129 @@
1
+ // /status — the session's status in one table: the model, the workspace, the
2
+ // context, the cost, the crews, and the version and platform that /version, /env,
3
+ // /session and /upgrade (its aliases now) used to show apart. runStatus reads the
4
+ // rows over the ports. Lives under commands/_lib/ — the loader's SearchPattern is
5
+ // "*.cmd.ts", so this file is never loaded as a command.
6
+
7
+ import type {
8
+ CrewHost, RuntimeInfo, RuntimeInfoReader, SessionCost, SessionMetadata, SessionStats, SessionStore, Shell, Telemetry,
9
+ } from "../../../shared/application/ports.ts";
10
+ import { CLI_BUILD, CLI_NAME, CLI_VERSION, isPinnedCommit, ORKEON_RUNTIME_PIN } from "./meta.ts";
11
+ import type { CommandView } from "../view.ts";
12
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
13
+
14
+ export interface StatusInputs {
15
+ model?: unknown;
16
+ title?: unknown;
17
+ messages?: unknown;
18
+ usedTokens?: unknown;
19
+ windowTokens?: unknown;
20
+ totalTokens?: unknown;
21
+ costUsd?: unknown;
22
+ calls?: unknown;
23
+ crews?: readonly string[];
24
+ workspace?: unknown;
25
+ /** OS, architecture and node version, as the shell reports them. */
26
+ platform?: unknown;
27
+ /** The host's LLM provider, as its `llm` service names it. */
28
+ provider?: unknown;
29
+ /** The runtime that runs the command, as its `runtime` service names it; absent when the host names none. */
30
+ runtime?: RuntimeInfo;
31
+ }
32
+
33
+ /** The runtime row: the running Orkeon, by the commit its build carries, against the commit pinned by
34
+ * .orkeon-version, or the pin alone when the host names no runtime (Orkeon #225). A runtime that reports no commit
35
+ * is not the pin. */
36
+ export function runtimeRow(runtime: RuntimeInfo | undefined): string {
37
+ if (runtime === undefined) return `Orkeon ${ORKEON_RUNTIME_PIN} (the commit pinned by .orkeon-version)`;
38
+ const found = `Orkeon ${runtime.version}${runtime.commit ? `+${runtime.commit}` : ""} (${runtime.channel})`;
39
+ return isPinnedCommit(runtime.commit)
40
+ ? `${found}, the pin of .orkeon-version`
41
+ : `${found}, NOT the pin ${ORKEON_RUNTIME_PIN} of .orkeon-version`;
42
+ }
43
+
44
+ /** How Orkeon Code is updated: there is no self-update channel. */
45
+ export const UPDATE_NOTE =
46
+ "no self-update: update the orkeon-code checkout (git pull, or a newer release archive) and relaunch; " +
47
+ "the Orkeon runtime it runs on is pinned to a commit of Orkeon's main by its .orkeon-version";
48
+
49
+ /**
50
+ * The `/status` rows.
51
+ *
52
+ * Baseline 04 §/status names four things: model, cost, workspace and crew summary.
53
+ * The pre-B-11 handler showed messages/tokens/cost/calls — so the two the operator
54
+ * most often opens `/status` to check, the model and the workspace, were the two
55
+ * missing. `(unreported)` rather than `?` for the model: it is an absence with a
56
+ * cause (see /model), not an unknown value.
57
+ */
58
+ export function buildStatusRows(i: StatusInputs): Array<{ field: string; value: string }> {
59
+ const used = Number(i.usedTokens ?? 0) || 0;
60
+ const window = Number(i.windowTokens ?? 0) || 0;
61
+ const pct = window > 0 ? ` (${Math.round((used / window) * 100)}% of ${window})` : "";
62
+ const cost = Number(i.costUsd ?? 0) || 0;
63
+
64
+ return [
65
+ { field: "model", value: String(i.model ?? "").trim() || "(unreported by the host — see /model)" },
66
+ // The host's default provider: a turn on another profile runs on that profile's.
67
+ { field: "provider", value: String(i.provider ?? "").trim() ? `${String(i.provider).trim()} (the host's default)` : "(unreported by the host)" },
68
+ { field: "workspace", value: String(i.workspace ?? WORKSPACE) },
69
+ { field: "session", value: String(i.title ?? "").trim() || "(untitled)" },
70
+ { field: "messages", value: String(Number(i.messages ?? 0) || 0) },
71
+ { field: "context", value: `${used} tokens${pct}` },
72
+ { field: "llm", value: `${Number(i.calls ?? 0) || 0} call(s), ${Number(i.totalTokens ?? 0) || 0} token(s)` },
73
+ { field: "cost", value: `$${cost.toFixed(4)}` },
74
+ {
75
+ field: "crews",
76
+ value: (i.crews?.length ?? 0) > 0 ? [...i.crews!].sort().join(", ") : "(none discovered)",
77
+ },
78
+ { field: "version", value: `${CLI_NAME} ${CLI_VERSION} (${CLI_BUILD})` },
79
+ { field: "runtime", value: runtimeRow(i.runtime) },
80
+ { field: "platform", value: String(i.platform ?? "").trim() || "(unavailable)" },
81
+ { field: "updates", value: UPDATE_NOTE },
82
+ ];
83
+ }
84
+
85
+ export interface StatusDeps {
86
+ session: Pick<SessionStore, "readBudget">;
87
+ telemetry: Telemetry;
88
+ crews: Pick<CrewHost, "listCrews">;
89
+ /** For the platform row; absent: the row says unavailable. */
90
+ shell?: Pick<Shell, "run">;
91
+ /** The provider row's reader; absent, or answering nothing: the row says unreported. */
92
+ provider?: () => string | undefined;
93
+ /** The running runtime's reader; absent, or answering nothing: the row names the pin alone. */
94
+ runtime?: RuntimeInfoReader;
95
+ }
96
+
97
+ /** One allow-listed command (node), no shell operator: the shell tool refuses them. */
98
+ export const PLATFORM_COMMAND = "node -p \"[process.platform, process.arch, 'node ' + process.version].join(' ')\"";
99
+
100
+ /** `/status`: the rows, each read best effort and on its own, so a missing session
101
+ * store degrades one row, not the whole command. */
102
+ export async function runStatus(deps: StatusDeps): Promise<CommandView> {
103
+ const { session, telemetry } = deps;
104
+ const [md, cost, stats, budget, platform] = await Promise.all([
105
+ telemetry.readMetadata().catch((): SessionMetadata => ({})),
106
+ telemetry.readCost().catch((): SessionCost => ({})),
107
+ telemetry.readStats().catch((): SessionStats => ({})),
108
+ session.readBudget().catch(() => ({ used: 0, window: 0 })),
109
+ deps.shell ? deps.shell.run(PLATFORM_COMMAND).then((r) => r.stdout).catch(() => "") : Promise.resolve(""),
110
+ ]);
111
+
112
+ return {
113
+ table: buildStatusRows({
114
+ model: md.model,
115
+ title: md.title,
116
+ messages: md.messageCount ?? stats.messageCount,
117
+ usedTokens: budget.used,
118
+ windowTokens: budget.window,
119
+ totalTokens: cost.totalTokens ?? stats.totalTokens,
120
+ costUsd: cost.costUsd,
121
+ calls: cost.totalCalls ?? stats.totalCalls,
122
+ crews: deps.crews.listCrews(),
123
+ workspace: WORKSPACE,
124
+ platform,
125
+ provider: deps.provider?.(),
126
+ runtime: deps.runtime?.read(),
127
+ }),
128
+ };
129
+ }
@@ -0,0 +1,49 @@
1
+ // /usage tools [text]: the session's [tools] messages (shared/domain/tool-trace.ts), each under the request it
2
+ // answered, the lines kept to those holding the text when one is given.
3
+ import type { SessionStore } from "../../../shared/application/ports.ts";
4
+ import type { SessionMsg } from "../../../shared/domain/types.ts";
5
+ import { isToolTrace } from "../../../shared/domain/tool-trace.ts";
6
+ import { isMarkedMessage } from "../../../shared/domain/marked-message.ts";
7
+ import type { CommandView } from "../view.ts";
8
+
9
+ /** A request is cut past this many characters on its line. */
10
+ export const MAX_REQUEST_CHARS = 100;
11
+
12
+ export const NO_TOOL_TRACE = "no tool call recorded in this session yet";
13
+
14
+ export interface UsageToolsDeps {
15
+ session: Pick<SessionStore, "readMessages">;
16
+ }
17
+
18
+ export async function runUsageTools(text: string, deps: UsageToolsDeps): Promise<CommandView> {
19
+ let messages: SessionMsg[];
20
+ try {
21
+ messages = (await deps.session.readMessages()).messages;
22
+ } catch {
23
+ messages = [];
24
+ }
25
+ const lines = toolTraceLines(messages, text.trim());
26
+ if (lines.length > 0) return { lines };
27
+ return { text: text.trim().length === 0 ? NO_TOOL_TRACE : `no tool call holds '${text.trim()}' in this session` };
28
+ }
29
+
30
+ /** Each turn's request, then its calls, the calls holding `text` alone (case aside) when it is not empty. */
31
+ export function toolTraceLines(messages: readonly SessionMsg[], text: string): string[] {
32
+ const needle = text.toLowerCase();
33
+ const out: string[] = [];
34
+ let request = "(no request)";
35
+ for (const m of messages) {
36
+ const content = String(m.content ?? "");
37
+ if (m.role === "user" && !isMarkedMessage(content)) request = content;
38
+ if (m.role !== "system" || !isToolTrace(content)) continue;
39
+ const calls = content.split("\n").slice(1).filter((l) => needle.length === 0 || l.toLowerCase().includes(needle));
40
+ if (calls.length === 0) continue;
41
+ out.push(`> ${requestLine(request)}`, ...calls.map((c) => ` ${c}`));
42
+ }
43
+ return out;
44
+ }
45
+
46
+ function requestLine(request: string): string {
47
+ const flat = request.replace(/\s+/g, " ").trim();
48
+ return flat.length > MAX_REQUEST_CHARS ? flat.slice(0, MAX_REQUEST_CHARS - 1) + "…" : flat;
49
+ }