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 @@
1
+ 839818d6aedefd96954bc470d4cefa6541aec1ba
package/LICENSE.md ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Orkeon Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/NOTICE.md ADDED
@@ -0,0 +1,17 @@
1
+ # Notice
2
+
3
+ Orkeon Code
4
+ Copyright (c) 2026 Orkeon Contributors. Licensed under the MIT License (see [LICENSE.md](LICENSE.md)).
5
+
6
+ Orkeon Code runs on the [Orkeon](https://github.com/Orkeon/orkeon) runtime (MIT), which is distributed separately
7
+ (the release archives, the `orkeon-runners` container image, the apt package, the .NET tools) with its own
8
+ third-party notices.
9
+
10
+ This repository ships TypeScript sources, and the Python sources of its speech MCP server (`mcp/whisper/`). Its
11
+ development dependencies (esbuild, MIT; TypeScript, Apache-2.0; `@types/node`, MIT) are not redistributed, nor are
12
+ the server's, which uv resolves on each machine: `mcp` (MIT), faster-whisper (MIT) and, as optional extras, openai
13
+ (Apache-2.0), sounddevice (MIT), NVIDIA's cuBLAS and cuDNN wheels (NVIDIA's own licence) and piper-tts (GPL-3.0),
14
+ which the server runs as a separate process and never imports. The 5-second sample `mcp/whisper/samples/fr-5s.wav`
15
+ is CC0 ([samples/README.md](mcp/whisper/samples/README.md)).
16
+
17
+ Orkeon Code is an independent project. Product names mentioned in its documentation belong to their owners.
package/README.fr.md ADDED
@@ -0,0 +1,169 @@
1
+ > 🇬🇧 [English version](README.md)
2
+
3
+ # Orkeon Code
4
+
5
+ [![CI](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml/badge.svg)](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml)
6
+ [![Licence : MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
7
+ [![Documentation](https://img.shields.io/badge/documentation-orkeon.github.io-blue.svg)](https://orkeon.github.io/orkeon-code/)
8
+
9
+ <p align="center">
10
+ <img src="docs/assets/kama-surfer-docker.jpg" alt="Mascotte d'Orkeon Code — un caméléon qui surfe sur une vague" width="320">
11
+ </p>
12
+
13
+ **Un assistant de code agentique en TypeScript sur le runtime [Orkeon](https://github.com/Orkeon/orkeon).**
14
+ Travaillez avec lui dans le terminal sous le mode de permission de votre choix, laissez-le mener une tâche jusqu'au
15
+ bout tout seul, ou lancez ses crews depuis un script, un planificateur ou votre propre application. Il lit, cherche,
16
+ modifie et exécute le code de votre projet par appels d'outils, et tout ce qu'il peut toucher est déclaré : un projet
17
+ monté, un shell sous liste blanche, un catalogue d'outils réduit selon le mode. Chaque commande, chaque crew et
18
+ chaque prompt est un fichier source : modifiez-le, ou ajoutez le vôtre.
19
+
20
+ > **Statut : release candidate.** La boucle, les crews et les modes de permission fonctionnent de bout en bout sur de vrais LLM.
21
+ > Des aspérités et des changements cassants restent possibles avant la 1.0.
22
+
23
+ ## Ce qu'il fait
24
+
25
+ - **`/assistant`** : la boucle interactive. Le modèle explore le code avec les outils de recherche et d'intelligence
26
+ de code (recherche hybride, source d'un symbole, graphes d'appels, analyse d'impact), modifie des fichiers et lance
27
+ des commandes, tour après tour, sous un budget d'exécution. Le texte libre saisi sans `/` initial y est envoyé.
28
+ - **Modes de permission** : `plan` (lecture seule), `default` (vous demande avant une modification, une commande ou
29
+ un appel réseau), `acceptEdits` (modifie sans demander), `dontAsk`, `bypassPermissions`, choisis par requête
30
+ (`plan: explique le flux d'authentification`) ou pour la session (`/mode`), plus des règles autoriser/refuser sur un
31
+ outil ou sur ses arguments (`allow shell_command command=npm test*`). Le runtime Orkeon les applique et pose les
32
+ questions.
33
+ - **Des outils de serveurs MCP et de plugins** : les outils qu'Orkeon connecte (`MCP:Servers`, `Plugins`) rejoignent
34
+ le catalogue de l'assistant dès que `tools.extra` les nomme
35
+ ([Configuration](docs/fr/configuration.md#outils-supplémentaires--serveurs-mcp-et-plugins)).
36
+ - **La transcription de la parole** : un serveur MCP Whisper est livré dans `mcp/whisper/` ; `ORKEON_CODE_AUDIO_DIR`
37
+ l'active, et l'assistant transcrit notes vocales, réunions et vidéos d'écran sur votre machine ; `/voice` dicte une
38
+ requête et `/say` lit à voix haute ([Configuration](docs/fr/configuration.md#transcription-de-la-parole)).
39
+ - **Des crews pour les tâches récurrentes** : `/init` (décrire le projet pour l'agent), `/commit` (un commit
40
+ conventionnel tiré du diff), `/review` (revue de code multi-angles ; `--lens security` pour le seul angle sécurité), `/analyze`
41
+ (analyse déterministe du code), `/compact` et `/summary` (gestion du contexte), `/init-verifiers`, `/advisor`.
42
+ - **Un workflow dev, étape par étape** : `/dev-spec` écrit la spec ou la fiche de changement,
43
+ `/dev-plan` la découpe en lots qu'un relecteur en lecture seule questionne, `/dev-batches` exécute les lots d'un
44
+ plan l'un après l'autre, chacun en test d'abord (tests rouges, puis le moindre code, puis un audit en lecture seule)
45
+ et clos par un commit (`<code> F<n>` un lot, `<code> F<n> --audit` son audit seul), `/dev-status` dit où en
46
+ est un travail et `/dev-learn` propose des règles à partir des écarts récurrents des audits. Chaque étape s'exécute
47
+ sous des règles de refus que son crew vérifie à nouveau
48
+ ([Permissions](docs/fr/permissions.md#jeux-de-règles-des-étapes-dev)).
49
+ - **Une mémoire partagée** : décisions, structures, méthodes et erreurs que les étapes retrouvent, admises seulement
50
+ par `/memory admit` ([Mémoire partagée](docs/fr/shared-memory.md)).
51
+ - **Gestion du contexte** : compaction automatique avec disjoncteur, `/compact` qui résume toute la session
52
+ (la troncature est `/compact --snip`, ou le repli d'un résumé en échec), restauration des fichiers après
53
+ compaction, paliers de pression du contexte, mémoire typée tenue par le processus Orkeon (`/memory`).
54
+ - **48 commandes slash** au total : [docs/fr/commands.md](docs/fr/commands.md).
55
+
56
+ ## Démarrage rapide
57
+
58
+ Il faut le runtime Orkeon et une clé d'API pour un fournisseur LLM pris en charge par Orkeon (tout point d'accès
59
+ compatible OpenAI, Anthropic...). Orkeon Code est vérifié contre les sources d'Orkeon au commit de `.orkeon-version` ;
60
+ les releases le font tourner aussi, en retard sur cette épingle. Chacun de ces trois fait tourner Orkeon Code :
61
+
62
+ - **`orkeon-repl`** de la dernière release, `1.0.0-rc.6`, du paquet Debian/Ubuntu `orkeon` (amd64 et arm64 ; une release candidate est publiée sur le canal
63
+ apt `rc`, le canal `stable` par défaut ne porte que les versions finales) ou de
64
+ l'[archive de release d'Orkeon](https://github.com/Orkeon/orkeon/releases) de votre plateforme (Linux x64 et arm64,
65
+ macOS x64 et arm64, `.zip` Windows x64), autonome : aucun .NET à installer ;
66
+ - **Docker** : la dernière image `orkeon-runners` publiée (amd64 et arm64 ; `1.0.0-rc.5`, l'image `1.0.0-rc.6` n'est
67
+ pas publiée), rien d'autre à installer ;
68
+ - **un checkout d'Orkeon** à l'épingle, le runtime de référence : `ORKEON_SOURCE=<checkout> ./orkeon-code --mode source`.
69
+
70
+ **Windows** : `orkeon-code.ps1` n'a ni mode source ni `--demo` (`-Mode` accepte `docker` ou `tool`) : le mode tool sur
71
+ le `orkeon-<version>-win-x64.zip` de la release est celui de Windows ; la voie que ce projet pratique est WSL avec le
72
+ lanceur bash ([tutoriel](docs/fr/wsl-tutorial.md)).
73
+
74
+ Orkeon Code lui-même s'installe depuis une release (`install.sh`, `install.ps1`) ou depuis npm (`npm install -g
75
+ orkeon-code@next`), ou tourne depuis un clone comme ci-dessous. Détails : [Premiers pas](docs/fr/getting-started.md).
76
+
77
+ ```bash
78
+ git clone https://github.com/Orkeon/orkeon-code.git ~/orkeon-code
79
+ cd ~/orkeon-code
80
+ cp config/appsettings.example.json config/appsettings.local.json # choisir le modèle et le point d'accès
81
+ export DEEPSEEK_API_KEY=... # la variable nommée par Llm:ApiKeyEnvVar
82
+
83
+ ./orkeon-code --demo # l'essayer sur un dépôt d'exemple jetable
84
+ cd ~/src/mon-projet && ~/orkeon-code/orkeon-code # ou sur votre projet
85
+ ```
86
+
87
+ Puis, dans le REPL (*Read–Eval–Print Loop* : la boucle interactive lire-évaluer-afficher) :
88
+
89
+ ```text
90
+ /init décrire le projet (écrit AGENTS.md)
91
+ plan: comment la configuration est-elle chargée ? question en lecture seule
92
+ acceptEdits: valide les entrées de parseArgs et ajoute un test
93
+ /diff
94
+ /commit
95
+ /review
96
+ ```
97
+
98
+ ## Fonctionnement
99
+
100
+ ```text
101
+ vous ──▶ /commande ──▶ *.cmd.ts (src/commands) ──script-host──▶ crew.ork.ts (src/crews)
102
+ │ ctx.llm.act() : boucle LLM ⇄ outils
103
+ ▼
104
+ runtime Orkeon (.NET) : outils, garde de permission, VFS, fournisseurs LLM
105
+ │
106
+ /workspace = votre projet
107
+ ```
108
+
109
+ Orkeon Code est la couche TypeScript : les commandes slash, les crews et la logique de domaine partagée. Le runtime
110
+ [Orkeon](https://github.com/Orkeon/orkeon) les exécute (Jint), fournit les outils, applique la garde de permission et
111
+ confine tout accès fichier au projet monté. Le runtime est épinglé dans [`.orkeon-version`](.orkeon-version), un
112
+ commit du `main` d'Orkeon.
113
+ Détails : [Architecture](docs/fr/architecture.md).
114
+
115
+ ## Interactif, autonome, embarqué
116
+
117
+ Le REPL est une façon de lancer les crews, pas la seule.
118
+
119
+ - **Interactif** : `./orkeon-code` sur votre projet. `plan:` pour demander, `acceptEdits:` pour le laisser modifier,
120
+ `/mode` pour la session ; en mode `default`, le runtime vous demande avant une modification, une commande ou un
121
+ appel réseau.
122
+ - **Autonome** : en `bypassPermissions`, la boucle mène une tâche jusqu'au bout sans poser de question, sous un budget
123
+ (200 appels d'outils, 30 minutes, 400k tokens) et la garde de l'hôte. `scripts/run-crew.sh` lance le même crew en un
124
+ coup depuis un shell, une ligne de cron ou un job de CI, et imprime son résultat en JSON.
125
+ - **Embarqué** : une application lance l'outil `orkeon` (nuget.org) ou l'image `orkeon-runners` sur un crew et lit le
126
+ JSON ; le démon `orkeon-host` d'Orkeon peut héberger les crews derrière un canal de chat ou un point d'accès A2A.
127
+ L'intégration .NET en processus attend que la couche de scripting soit publiée en paquet.
128
+
129
+ Détails et limites : [Exécutions autonomes et embarquées](docs/fr/headless.md).
130
+
131
+ ## Faites-en le vôtre
132
+
133
+ Une commande est un fichier dans `src/commands`, un crew un dossier dans `src/crews`, un outil un `toolBuilder()`
134
+ dans un crew, un prompt une chaîne avec son test, et les modes de permission une table de noms d'outils. Pas d'étape
135
+ de build : le runtime bundle le TypeScript et l'exécute au prochain démarrage. Vos propres crews et commandes peuvent
136
+ vivre hors du checkout (`--crews-dir`, `--commands-dir`), et les outils des serveurs MCP et des plugins rejoignent le
137
+ catalogue dès que `tools.extra` les nomme, sans une ligne de code. Ce qui bouge à chaque changement, et les limites :
138
+ [Étendre Orkeon Code](docs/fr/extending.md).
139
+
140
+ ## Documentation
141
+
142
+ La documentation est publiée en français et en anglais, en site consultable, avec recherche :
143
+ <https://orkeon.github.io/orkeon-code/>. Les pages ci-dessous sont les françaises ; les mêmes existent
144
+ [en anglais](docs/README.md), et les décisions (ADR) ne sont écrites qu'en anglais.
145
+
146
+ | | |
147
+ |---|---|
148
+ | [Premiers pas](docs/fr/getting-started.md) | Modes docker, tool et source, première session |
149
+ | [Tutoriel WSL](docs/fr/wsl-tutorial.md) | La voix et un modèle local sous WSL2, sur le GPU, pas à pas |
150
+ | [Configuration](docs/fr/configuration.md) | Fournisseurs LLM, fichier de settings, variables d'environnement |
151
+ | [Permissions](docs/fr/permissions.md) | Modes, règles, ce que l'agent peut toucher |
152
+ | [Hooks](docs/fr/hooks.md) | Vos commandes autour des appels d'outils du modèle dans les étapes dev |
153
+ | [Mémoire partagée](docs/fr/shared-memory.md) | Décisions, structures, méthodes et erreurs admises que les agents rappellent |
154
+ | [Commandes](docs/fr/commands.md) | La liste complète (générée) |
155
+ | [Architecture](docs/fr/architecture.md) | Couches, ports, crews, la boucle, l'assemblage du prompt, recettes |
156
+ | [Exécutions autonomes et embarquées](docs/fr/headless.md) | Tours sans opérateur, lancement en un coup, planificateurs et CI, votre application |
157
+ | [Étendre](docs/fr/extending.md) | Commandes, crews, outils, prompts, modes, vos propres dossiers, les limites |
158
+ | [Développement](docs/fr/development.md) | Tests, vérifications, typings, montée de version d'Orkeon, release |
159
+ | [Feuille de route](docs/fr/roadmap.md) | Ce qui manque et ce qui vient |
160
+
161
+ ## Contribuer
162
+
163
+ Issues et pull requests sont bienvenues : lisez d'abord [CONTRIBUTING.md](CONTRIBUTING.md). Un problème du runtime
164
+ lui-même (outils, VFS, fournisseurs, hôte REPL) relève d'[Orkeon/orkeon](https://github.com/Orkeon/orkeon/issues). Les
165
+ signalements de sécurité suivent [SECURITY.md](SECURITY.md).
166
+
167
+ ## Licence
168
+
169
+ [MIT](LICENSE.md) © 2026 Orkeon Contributors.
package/README.md CHANGED
@@ -1,3 +1,163 @@
1
- # Temporary Holding Version
1
+ > 🇫🇷 [Version française](README.fr.md)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ # Orkeon Code
4
+
5
+ [![CI](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml/badge.svg)](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml)
6
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
7
+ [![Documentation](https://img.shields.io/badge/documentation-orkeon.github.io-blue.svg)](https://orkeon.github.io/orkeon-code/)
8
+
9
+ <p align="center">
10
+ <img src="docs/assets/kama-surfer-docker.jpg" alt="Orkeon Code mascot — a chameleon surfing a wave" width="320">
11
+ </p>
12
+
13
+ **An agentic coding assistant in TypeScript on the [Orkeon](https://github.com/Orkeon/orkeon) runtime.** Pair with
14
+ it in the terminal under a permission mode you choose, let it run a task to the end on its own, or start its crews
15
+ from a script, a scheduler or your own application. It reads, searches, edits and runs code in your project through
16
+ tool calls, and everything it can touch is declared: one mounted project, an allow-listed shell, a tool catalogue
17
+ trimmed by the mode. Every command, crew and prompt is a source file: change it, or add yours.
18
+
19
+ > **Status: release candidate.** The loop, the crews and the permission modes work end to end against real LLMs. Rough
20
+ > edges and breaking changes remain possible before 1.0.
21
+
22
+ ## What it does
23
+
24
+ - **`/assistant`**: the interactive loop. The model explores the code with search and code-intelligence tools
25
+ (hybrid code search, symbol source, call graphs, impact analysis), edits files and runs commands, turn after turn,
26
+ under an execution budget. Free text typed without a leading `/` goes there.
27
+ - **Permission modes**: `plan` (read-only), `default` (asks you before an edit, a command or a network call),
28
+ `acceptEdits` (edits without asking), `dontAsk`, `bypassPermissions`, chosen per request
29
+ (`plan: explain the auth flow`) or for the session (`/mode`), plus allow/deny rules on a tool or on its arguments
30
+ (`allow shell_command command=npm test*`). The Orkeon runtime enforces them and asks the questions.
31
+ - **Tools from MCP servers and plugins**: the tools Orkeon connects (`MCP:Servers`, `Plugins`) join the assistant's
32
+ catalogue once `tools.extra` names them ([Configuration](docs/configuration.md#extra-tools-mcp-servers-and-plugins)).
33
+ - **Speech-to-text**: a Whisper MCP server ships in `mcp/whisper/`; `ORKEON_CODE_AUDIO_DIR` turns it on, and the
34
+ assistant transcribes voice notes, meetings and screen recordings on your machine; `/voice` dictates a request
35
+ and `/say` reads aloud ([Configuration](docs/configuration.md#speech-to-text)).
36
+ - **Crews for the recurring jobs**: `/init` (describe the project for the agent), `/commit` (a conventional commit
37
+ from the diff), `/review` (multi-lens code review; `--lens security` for the security lens alone), `/analyze` (deterministic
38
+ codebase analysis), `/compact` and `/summary` (context management), `/init-verifiers`, `/advisor`.
39
+ - **A dev workflow, step by step**: `/dev-spec` writes the spec or the change brief, `/dev-plan`
40
+ cuts it into batches a read-only reviewer questions, `/dev-batches` runs a plan's batches one after the other, each
41
+ test-first (red tests, then the least code, then a read-only audit) and closed with a commit (`<code> F<n>` one
42
+ batch, `<code> F<n> --audit` its audit alone), `/dev-status` says where a piece of work stands and `/dev-learn` proposes rules
43
+ from the audits' recurring gaps. Each step runs under deny rules its crew checks again
44
+ ([Permissions](docs/permissions.md#rule-sets-of-the-dev-steps)).
45
+ - **A shared memory**: decisions, structures, methods and mistakes the steps recall, admitted only through
46
+ `/memory admit` ([Shared memory](docs/shared-memory.md)).
47
+ - **Context management**: automatic compaction with a circuit breaker, a `/compact` that summarises the whole session
48
+ (the snip is `/compact --snip`, or the fallback of a failed summary), file restore after compaction, context
49
+ pressure tiers, typed memory held by the Orkeon process (`/memory`).
50
+ - **48 slash commands** in all: [docs/commands.md](docs/commands.md).
51
+
52
+ ## Quick start
53
+
54
+ You need the Orkeon runtime and an API key for an LLM provider Orkeon supports (any OpenAI-compatible endpoint,
55
+ Anthropic...). Orkeon Code is checked against Orkeon's sources at the commit of `.orkeon-version`; the releases run
56
+ it too, behind that pin. Any of these runs Orkeon Code:
57
+
58
+ - **`orkeon-repl`** of the last release, `1.0.0-rc.6`, from the `orkeon` Debian/Ubuntu package (amd64 and arm64; a release candidate is published on the
59
+ apt `rc` channel, the default `stable` channel carries finals only) or from the
60
+ [Orkeon release archive](https://github.com/Orkeon/orkeon/releases) of your platform (Linux x64 and arm64, macOS x64
61
+ and arm64, Windows x64 `.zip`), self-contained: no .NET to install;
62
+ - **Docker**: the last `orkeon-runners` image published (amd64 and arm64; `1.0.0-rc.5`, the `1.0.0-rc.6` image is not
63
+ published), nothing else to install;
64
+ - **an Orkeon checkout** at the pin, the reference runtime: `ORKEON_SOURCE=<checkout> ./orkeon-code --mode source`.
65
+
66
+ **Windows**: `orkeon-code.ps1` has no source mode and no `--demo` (`-Mode` takes `docker` or `tool`): the tool mode on
67
+ the release's `orkeon-<version>-win-x64.zip` is the one for Windows; the path this project exercises is WSL with the
68
+ bash launcher ([tutorial](docs/wsl-tutorial.md)).
69
+
70
+ Orkeon Code itself installs from a release (`install.sh`, `install.ps1`) or from npm (`npm install -g
71
+ orkeon-code@next`), or runs from a clone as below. Details: [Getting started](docs/getting-started.md).
72
+
73
+ ```bash
74
+ git clone https://github.com/Orkeon/orkeon-code.git ~/orkeon-code
75
+ cd ~/orkeon-code
76
+ cp config/appsettings.example.json config/appsettings.local.json # pick the model and endpoint
77
+ export DEEPSEEK_API_KEY=... # the variable named by Llm:ApiKeyEnvVar
78
+
79
+ ./orkeon-code --demo # try it on a throwaway sample repository
80
+ cd ~/src/my-project && ~/orkeon-code/orkeon-code # or on your project
81
+ ```
82
+
83
+ Then, in the REPL (Read–Eval–Print Loop — the interactive console):
84
+
85
+ ```text
86
+ /init describe the project (writes AGENTS.md)
87
+ plan: how is the configuration loaded? read-only question
88
+ acceptEdits: add input validation to parseArgs and a test for it
89
+ /diff
90
+ /commit
91
+ /review
92
+ ```
93
+
94
+ ## How it works
95
+
96
+ ```text
97
+ you ──▶ /command ──▶ *.cmd.ts (src/commands) ──script-host──▶ crew.ork.ts (src/crews)
98
+ │ ctx.llm.act(): LLM ⇄ tools loop
99
+ ▼
100
+ Orkeon runtime (.NET): tools, permission gate, VFS, LLM providers
101
+ │
102
+ /workspace = your project
103
+ ```
104
+
105
+ Orkeon Code is the TypeScript layer: slash commands, crews and the shared domain logic they use. The
106
+ [Orkeon](https://github.com/Orkeon/orkeon) runtime executes them (Jint), provides the tools, enforces the permission
107
+ gate and confines every file access to the mounted project. The runtime is pinned in
108
+ [`.orkeon-version`](.orkeon-version), a commit of Orkeon's `main`. Details: [Architecture](docs/architecture.md).
109
+
110
+ ## Interactive, autonomous, embedded
111
+
112
+ The REPL is one way to run the crews, not the only one.
113
+
114
+ - **Interactive**: `./orkeon-code` on your project. `plan:` to ask, `acceptEdits:` to let it edit, `/mode` for the
115
+ session; in `default` mode the runtime asks you before an edit, a command or a network call.
116
+ - **Autonomous**: in `bypassPermissions` the loop runs a task to the end without a question, under a budget (200 tool
117
+ calls, 30 minutes, 400k tokens) and the host gate. `scripts/run-crew.sh` runs the same crew in one shot from a shell, a
118
+ cron line or a CI job, and prints its result as JSON.
119
+ - **Embedded**: an application starts the `orkeon` tool (nuget.org) or the `orkeon-runners` image on a crew and reads
120
+ the JSON; Orkeon's `orkeon-host` daemon can host the crews behind a chat channel or an A2A endpoint. In-process
121
+ .NET embedding waits for the scripting layer to ship as a package.
122
+
123
+ Details and limits: [Autonomous and embedded runs](docs/headless.md).
124
+
125
+ ## Make it yours
126
+
127
+ A command is a file in `src/commands`, a crew is a folder in `src/crews`, a tool is a `toolBuilder()` in a crew, a
128
+ prompt is a string with its test, and the permission modes are a table of tool names. There is no build step: the
129
+ runtime bundles the TypeScript and runs it at the next start. Your own crews and commands can live outside the
130
+ checkout (`--crews-dir`, `--commands-dir`), and the tools of MCP servers and plugins join the catalogue once
131
+ `tools.extra` names them, without a line of code. What moves with each change, and the limits:
132
+ [Extending Orkeon Code](docs/extending.md).
133
+
134
+ ## Documentation
135
+
136
+ The pages below are published as a browsable site, with a search box:
137
+ <https://orkeon.github.io/orkeon-code/>. The same pages exist [in French](docs/fr/README.md); the decisions (ADR)
138
+ are written in English only.
139
+
140
+ | | |
141
+ |---|---|
142
+ | [Getting started](docs/getting-started.md) | Docker, tool and source modes, first session |
143
+ | [WSL tutorial](docs/wsl-tutorial.md) | Speech and a local model on WSL2, on the GPU, step by step |
144
+ | [Configuration](docs/configuration.md) | LLM providers, settings file, environment variables |
145
+ | [Permissions](docs/permissions.md) | Modes, rules, what the agent can touch |
146
+ | [Hooks](docs/hooks.md) | Your commands around the model's tool calls in the dev steps |
147
+ | [Shared memory](docs/shared-memory.md) | Admitted decisions, structures, methods and mistakes the agents recall |
148
+ | [Slash commands](docs/commands.md) | The full list (generated) |
149
+ | [Architecture](docs/architecture.md) | Layers, ports, crews, the loop, prompt assembly, recipes |
150
+ | [Autonomous and embedded runs](docs/headless.md) | Unattended turns, one-shot runs, schedulers and CI, your application |
151
+ | [Extending](docs/extending.md) | Commands, crews, tools, prompts, modes, your own directories, the limits |
152
+ | [Development](docs/development.md) | Tests, checks, typings, upgrading Orkeon, releasing |
153
+ | [Roadmap](docs/roadmap.md) | What is missing and what comes next |
154
+
155
+ ## Contributing
156
+
157
+ Issues and pull requests are welcome: read [CONTRIBUTING.md](CONTRIBUTING.md) first. A problem in the runtime itself
158
+ (tools, VFS, providers, the REPL host) belongs to [Orkeon/orkeon](https://github.com/Orkeon/orkeon/issues). Security
159
+ reports follow [SECURITY.md](SECURITY.md).
160
+
161
+ ## License
162
+
163
+ [MIT](LICENSE.md) © 2026 Orkeon Contributors.
@@ -0,0 +1,77 @@
1
+ {
2
+ "_comment": "Orkeon Code on Claude, through the API credits of a Max plan. Since October 2026 a Max plan includes monthly API credits (100 USD on Max 5x, 200 USD on Max 20x, no rollover), spent through an API key of the Anthropic Console organisation linked to the plan: on claude.ai, Settings, Billing, API credits, Link organization (the link is made once, only the support changes it), then create a key in that organisation. The key goes in the environment, export ANTHROPIC_API_KEY=..., never in this file; beyond the credits the key is billed at the API's usage rates. Signing in with the plan itself is reserved to Anthropic's own applications, so it is not a way to run Orkeon Code. Copy this file to config/appsettings.local.json (ignored by git), or pass it with --settings. Orkeon recognises Anthropic by its address; every agent of Orkeon Code asks it to cache its system prompt and its tools (cache_control), and Orkeon reads the tokens it served, so /usage and /context show cacheRead and cacheWrite. No Temperature: the current Claude generation refuses one, and Orkeon sends only what the file sets. The AvailableModels are the other Claude models /model switches to: claude-fable-5-1 is the most capable and costs about two and a half times claude-opus-5-5 per token, so it empties the monthly credits faster, and it needs an organisation with the standard 30-day data retention (one under zero data retention gets a 400). /effort sets the thinking effort. The other sections are those of config/appsettings.example.json; every key is explained in docs/configuration.md.",
3
+ "Llm": {
4
+ "Model": "claude-opus-5-5",
5
+ "BaseUrl": "https://api.anthropic.com",
6
+ "ApiKeyEnvVar": "ANTHROPIC_API_KEY",
7
+ "AvailableModels": [
8
+ "claude-opus-5-5",
9
+ "claude-fable-5-1",
10
+ "claude-sonnet-5-5",
11
+ "claude-haiku-5-5"
12
+ ],
13
+ "MaxTokens": 24576,
14
+ "TimeoutSeconds": 600,
15
+ "MaxRateLimitWait": "00:05:00"
16
+ },
17
+ "RateLimiting": {
18
+ "MaxConcurrentRequests": 16,
19
+ "GlobalRequestsPerMinute": 300,
20
+ "ProviderRequestsPerMinute": 300,
21
+ "AgentRequestsPerMinute": 10,
22
+ "QueueLimit": 512
23
+ },
24
+ "Orkeon": {
25
+ "Rag": {
26
+ "Retrieval": {
27
+ "MinScore": 0.6
28
+ }
29
+ },
30
+ "Scripting": {
31
+ "Limits": {
32
+ "ExecutionTimeout": "00:30:00",
33
+ "MemoryLimitBytes": 2147483648
34
+ }
35
+ },
36
+ "Security": {
37
+ "PermissionGate": {
38
+ "Enabled": true
39
+ }
40
+ },
41
+ "Tools": {
42
+ "Shell": {
43
+ "AllowInterpreters": true,
44
+ "ExtraAllowedCommands": [
45
+ "make"
46
+ ],
47
+ "Confinement": {
48
+ "Mode": "None"
49
+ }
50
+ },
51
+ "ResultLimits": {
52
+ "MaxParallelToolCalls": 4,
53
+ "Limits": {
54
+ "shell_command": 10000
55
+ }
56
+ }
57
+ },
58
+ "Cli": {
59
+ "ConsoleStreaming": {
60
+ "Enabled": true
61
+ },
62
+ "Session": {
63
+ "Persist": true
64
+ },
65
+ "Memory": {
66
+ "Persist": true,
67
+ "RootDirectory": "/workspace/.orkeon/typed-memory"
68
+ },
69
+ "ScriptCommands": {
70
+ "Limits": {
71
+ "ExecutionTimeout": "00:30:00",
72
+ "MemoryLimitBytes": 2147483648
73
+ }
74
+ }
75
+ }
76
+ }
77
+ }
@@ -0,0 +1,71 @@
1
+ {
2
+ "_comment": "Orkeon Code settings template. Copy it to config/appsettings.local.json (ignored by git) and adjust the Llm section. The API key never goes in this file: ApiKeyEnvVar names the environment variable that holds it, and ORKEON_Llm__ApiKey, when set, wins over everything. Any OpenAI-compatible endpoint works through BaseUrl; see docs/configuration.md for the providers Orkeon supports, and for the MCP:Servers and Plugins sections whose tools the tools.extra session key offers to the assistant. Every key below is explained in docs/configuration.md: Orkeon refuses a key it does not know inside its sections, so this file carries no other comment.",
3
+ "Llm": {
4
+ "Model": "deepseek-v4-flash",
5
+ "BaseUrl": "https://api.deepseek.com",
6
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
7
+ "AvailableModels": ["deepseek-v4-flash", "deepseek-v4-pro"],
8
+ "Temperature": 0.2,
9
+ "MaxTokens": 24576,
10
+ "TimeoutSeconds": 600,
11
+ "MaxRateLimitWait": "00:05:00"
12
+ },
13
+ "RateLimiting": {
14
+ "MaxConcurrentRequests": 16,
15
+ "GlobalRequestsPerMinute": 300,
16
+ "ProviderRequestsPerMinute": 300,
17
+ "AgentRequestsPerMinute": 10,
18
+ "QueueLimit": 512
19
+ },
20
+ "Orkeon": {
21
+ "Rag": {
22
+ "Retrieval": {
23
+ "MinScore": 0.6
24
+ }
25
+ },
26
+ "Scripting": {
27
+ "Limits": {
28
+ "ExecutionTimeout": "00:30:00",
29
+ "MemoryLimitBytes": 2147483648
30
+ }
31
+ },
32
+ "Security": {
33
+ "PermissionGate": {
34
+ "Enabled": true
35
+ }
36
+ },
37
+ "Tools": {
38
+ "Shell": {
39
+ "AllowInterpreters": true,
40
+ "ExtraAllowedCommands": ["make"],
41
+ "Confinement": {
42
+ "Mode": "None"
43
+ }
44
+ },
45
+ "ResultLimits": {
46
+ "MaxParallelToolCalls": 4,
47
+ "Limits": {
48
+ "shell_command": 10000
49
+ }
50
+ }
51
+ },
52
+ "Cli": {
53
+ "ConsoleStreaming": {
54
+ "Enabled": true
55
+ },
56
+ "Session": {
57
+ "Persist": true
58
+ },
59
+ "Memory": {
60
+ "Persist": true,
61
+ "RootDirectory": "/workspace/.orkeon/typed-memory"
62
+ },
63
+ "ScriptCommands": {
64
+ "Limits": {
65
+ "ExecutionTimeout": "00:30:00",
66
+ "MemoryLimitBytes": 2147483648
67
+ }
68
+ }
69
+ }
70
+ }
71
+ }
@@ -0,0 +1,128 @@
1
+ {
2
+ "_comment": "Orkeon Code settings with a decision model, Jev (TypeSafe's System One), in front of the LLM. Copy it to config/appsettings.local.json (ignored by git): the Llm section is the default profile, as in appsettings.example.json; Llm:Profiles declares the named profiles a decision profile targets; Orkeon:TypeSafe reaches Jev, its key in the variable ApiKeyEnvVar names (TYPESAFE_API_KEY), never in this file; Orkeon:Decision:Profiles:guarded guards every request of the small profile against prompt injection, verifies the answer and escalates to the large profile when it does not hold. Then, in the REPL, /config set llm.profile guarded: every crew a command launches builds its agents on it; without the key, nothing changes. See docs/configuration.md.",
3
+ "Llm": {
4
+ "Model": "deepseek-v4-flash",
5
+ "BaseUrl": "https://api.deepseek.com",
6
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
7
+ "AvailableModels": [
8
+ "deepseek-v4-flash",
9
+ "deepseek-v4-pro"
10
+ ],
11
+ "Temperature": 0.2,
12
+ "MaxTokens": 24576,
13
+ "TimeoutSeconds": 600,
14
+ "MaxRateLimitWait": "00:05:00",
15
+ "Profiles": {
16
+ "small": {
17
+ "Model": "deepseek-v4-flash",
18
+ "BaseUrl": "https://api.deepseek.com",
19
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
20
+ "Temperature": 0.2,
21
+ "MaxTokens": 24576,
22
+ "TimeoutSeconds": 600,
23
+ "MaxRateLimitWait": "00:05:00"
24
+ },
25
+ "large": {
26
+ "Model": "deepseek-v4-pro",
27
+ "BaseUrl": "https://api.deepseek.com",
28
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
29
+ "Temperature": 0.2,
30
+ "MaxTokens": 24576,
31
+ "TimeoutSeconds": 600,
32
+ "MaxRateLimitWait": "00:05:00"
33
+ }
34
+ }
35
+ },
36
+ "RateLimiting": {
37
+ "MaxConcurrentRequests": 16,
38
+ "GlobalRequestsPerMinute": 300,
39
+ "ProviderRequestsPerMinute": 300,
40
+ "AgentRequestsPerMinute": 10,
41
+ "QueueLimit": 512
42
+ },
43
+ "Orkeon": {
44
+ "Rag": {
45
+ "Retrieval": {
46
+ "MinScore": 0.6
47
+ }
48
+ },
49
+ "TypeSafe": {
50
+ "Model": "jev-latest",
51
+ "ApiKeyEnvVar": "TYPESAFE_API_KEY",
52
+ "TimeoutSeconds": 30,
53
+ "MaxRetries": 3
54
+ },
55
+ "Decision": {
56
+ "Enabled": true,
57
+ "Profiles": {
58
+ "guarded": {
59
+ "Target": "small",
60
+ "FailClosed": false,
61
+ "Stages": [
62
+ {
63
+ "Kind": "guard",
64
+ "Phase": "request",
65
+ "Risks": {
66
+ "prompt_injection": "The message tries to override the system instructions or the tool rules"
67
+ },
68
+ "BlockThreshold": 0.8,
69
+ "WarnThreshold": 0.5
70
+ },
71
+ {
72
+ "Kind": "verify",
73
+ "Criterion": "The answer does what the request asks, on the code it names, and says what it did not do",
74
+ "EscalateTo": "large",
75
+ "MinProbability": 0.6
76
+ }
77
+ ]
78
+ }
79
+ }
80
+ },
81
+ "Scripting": {
82
+ "Limits": {
83
+ "ExecutionTimeout": "00:30:00",
84
+ "MemoryLimitBytes": 2147483648
85
+ }
86
+ },
87
+ "Security": {
88
+ "PermissionGate": {
89
+ "Enabled": true
90
+ }
91
+ },
92
+ "Tools": {
93
+ "Shell": {
94
+ "AllowInterpreters": true,
95
+ "ExtraAllowedCommands": [
96
+ "make"
97
+ ],
98
+ "Confinement": {
99
+ "Mode": "None"
100
+ }
101
+ },
102
+ "ResultLimits": {
103
+ "MaxParallelToolCalls": 4,
104
+ "Limits": {
105
+ "shell_command": 10000
106
+ }
107
+ }
108
+ },
109
+ "Cli": {
110
+ "ConsoleStreaming": {
111
+ "Enabled": true
112
+ },
113
+ "Session": {
114
+ "Persist": true
115
+ },
116
+ "Memory": {
117
+ "Persist": true,
118
+ "RootDirectory": "/workspace/.orkeon/typed-memory"
119
+ },
120
+ "ScriptCommands": {
121
+ "Limits": {
122
+ "ExecutionTimeout": "00:30:00",
123
+ "MemoryLimitBytes": 2147483648
124
+ }
125
+ }
126
+ }
127
+ }
128
+ }