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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (552) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -0
  3. package/LICENSE.md +21 -0
  4. package/NOTICE.md +17 -0
  5. package/README.fr.md +163 -0
  6. package/README.md +156 -2
  7. package/config/appsettings.anthropic.example.json +77 -0
  8. package/config/appsettings.example.json +71 -0
  9. package/config/appsettings.jev.example.json +131 -0
  10. package/config/appsettings.kev.example.json +133 -0
  11. package/config/appsettings.liquid.example.json +132 -0
  12. package/config/appsettings.ollama-whisper.example.json +93 -0
  13. package/config/appsettings.ollama.example.json +70 -0
  14. package/config/appsettings.whisper.example.json +32 -0
  15. package/mcp/whisper/README.md +294 -0
  16. package/mcp/whisper/pyproject.toml +32 -0
  17. package/mcp/whisper/uv.lock +1641 -0
  18. package/mcp/whisper/whisper_mcp.py +1053 -0
  19. package/orkeon-code +1092 -0
  20. package/orkeon-code.mjs +71 -0
  21. package/orkeon-code.ps1 +939 -0
  22. package/package.json +58 -4
  23. package/scripts/install.ps1 +156 -0
  24. package/scripts/install.sh +148 -0
  25. package/scripts/session-start.ork.ts +90 -0
  26. package/scripts/session-start.sh +74 -0
  27. package/scripts/setup-fixture.sh +88 -0
  28. package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
  29. package/src/commands/_lib/args.ts +194 -0
  30. package/src/commands/_lib/dev/dev-batches.ts +366 -0
  31. package/src/commands/_lib/dev/dev-implement.ts +185 -0
  32. package/src/commands/_lib/dev/dev-source.ts +61 -0
  33. package/src/commands/_lib/dev/dev.ts +341 -0
  34. package/src/commands/_lib/dev/markers.ts +7 -0
  35. package/src/commands/_lib/dev/messages.ts +112 -0
  36. package/src/commands/_lib/dev-step.ts +145 -0
  37. package/src/commands/_lib/dispatch.ts +254 -0
  38. package/src/commands/_lib/effort.ts +15 -0
  39. package/src/commands/_lib/git/branch.ts +94 -0
  40. package/src/commands/_lib/git/commit.ts +90 -0
  41. package/src/commands/_lib/git/diff.ts +107 -0
  42. package/src/commands/_lib/git/messages.ts +54 -0
  43. package/src/commands/_lib/git/review.ts +108 -0
  44. package/src/commands/_lib/memory/memory-admit.ts +148 -0
  45. package/src/commands/_lib/memory/memory.ts +52 -0
  46. package/src/commands/_lib/memory/messages.ts +32 -0
  47. package/src/commands/_lib/messages.ts +48 -0
  48. package/src/commands/_lib/pr-context.ts +32 -0
  49. package/src/commands/_lib/project/analyze.ts +24 -0
  50. package/src/commands/_lib/project/messages.ts +8 -0
  51. package/src/commands/_lib/session/export.ts +105 -0
  52. package/src/commands/_lib/session/messages.ts +87 -0
  53. package/src/commands/_lib/session/prompts.ts +4 -0
  54. package/src/commands/_lib/session/resume.ts +151 -0
  55. package/src/commands/_lib/session/tasks.ts +181 -0
  56. package/src/commands/_lib/settings/advisor.ts +75 -0
  57. package/src/commands/_lib/settings/agents.ts +137 -0
  58. package/src/commands/_lib/settings/choices.ts +8 -0
  59. package/src/commands/_lib/settings/config.ts +141 -0
  60. package/src/commands/_lib/settings/effort.ts +147 -0
  61. package/src/commands/_lib/settings/hooks.ts +50 -0
  62. package/src/commands/_lib/settings/messages.ts +408 -0
  63. package/src/commands/_lib/settings/mode.ts +100 -0
  64. package/src/commands/_lib/settings/model.ts +181 -0
  65. package/src/commands/_lib/settings/output-style.ts +39 -0
  66. package/src/commands/_lib/settings/permissions.ts +287 -0
  67. package/src/commands/_lib/settings/route.ts +63 -0
  68. package/src/commands/_lib/settings/session-config.ts +49 -0
  69. package/src/commands/_lib/settings/skills.ts +93 -0
  70. package/src/commands/_lib/settings/theme.ts +42 -0
  71. package/src/commands/_lib/speech/messages.ts +58 -0
  72. package/src/commands/_lib/speech/prompts.ts +4 -0
  73. package/src/commands/_lib/speech/say.ts +95 -0
  74. package/src/commands/_lib/speech/transcribe.ts +121 -0
  75. package/src/commands/_lib/speech/voice.ts +142 -0
  76. package/src/commands/_lib/status/cache.ts +31 -0
  77. package/src/commands/_lib/status/context.ts +57 -0
  78. package/src/commands/_lib/status/doctor.ts +205 -0
  79. package/src/commands/_lib/status/messages.ts +100 -0
  80. package/src/commands/_lib/status/meta.ts +24 -0
  81. package/src/commands/_lib/status/status.ts +128 -0
  82. package/src/commands/_lib/status/usage-tools.ts +48 -0
  83. package/src/commands/_lib/status/usage.ts +128 -0
  84. package/src/commands/_lib/view.ts +34 -0
  85. package/src/commands/dev/dev-batches.cmd.ts +109 -0
  86. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  87. package/src/commands/dev/dev-plan.cmd.ts +51 -0
  88. package/src/commands/dev/dev-spec.cmd.ts +54 -0
  89. package/src/commands/dev/dev-status.cmd.ts +16 -0
  90. package/src/commands/git/branch.cmd.ts +27 -0
  91. package/src/commands/git/commit.cmd.ts +48 -0
  92. package/src/commands/git/diff.cmd.ts +26 -0
  93. package/src/commands/git/review.cmd.ts +36 -0
  94. package/src/commands/memory/memory.cmd.ts +48 -0
  95. package/src/commands/project/analyze.cmd.ts +32 -0
  96. package/src/commands/project/debug-tool-call.cmd.ts +62 -0
  97. package/src/commands/project/files.cmd.ts +22 -0
  98. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  99. package/src/commands/project/init.cmd.ts +14 -0
  100. package/src/commands/project/verify.cmd.ts +27 -0
  101. package/src/commands/session/assistant.cmd.ts +40 -0
  102. package/src/commands/session/btw.cmd.ts +18 -0
  103. package/src/commands/session/clear.cmd.ts +19 -0
  104. package/src/commands/session/compact.cmd.ts +16 -0
  105. package/src/commands/session/copy.cmd.ts +45 -0
  106. package/src/commands/session/exit.cmd.ts +9 -0
  107. package/src/commands/session/export.cmd.ts +28 -0
  108. package/src/commands/session/rename.cmd.ts +18 -0
  109. package/src/commands/session/resume.cmd.ts +19 -0
  110. package/src/commands/session/rewind.cmd.ts +25 -0
  111. package/src/commands/session/summary.cmd.ts +27 -0
  112. package/src/commands/session/tasks.cmd.ts +46 -0
  113. package/src/commands/settings/advisor.cmd.ts +38 -0
  114. package/src/commands/settings/agents.cmd.ts +19 -0
  115. package/src/commands/settings/config.cmd.ts +19 -0
  116. package/src/commands/settings/effort.cmd.ts +19 -0
  117. package/src/commands/settings/fast.cmd.ts +18 -0
  118. package/src/commands/settings/hooks.cmd.ts +17 -0
  119. package/src/commands/settings/mode.cmd.ts +20 -0
  120. package/src/commands/settings/model.cmd.ts +21 -0
  121. package/src/commands/settings/output-style.cmd.ts +19 -0
  122. package/src/commands/settings/permissions.cmd.ts +25 -0
  123. package/src/commands/settings/proactive.cmd.ts +16 -0
  124. package/src/commands/settings/route.cmd.ts +16 -0
  125. package/src/commands/settings/skills.cmd.ts +17 -0
  126. package/src/commands/settings/theme.cmd.ts +14 -0
  127. package/src/commands/speech/say.cmd.ts +24 -0
  128. package/src/commands/speech/transcribe.cmd.ts +29 -0
  129. package/src/commands/speech/voice.cmd.ts +30 -0
  130. package/src/commands/status/context.cmd.ts +18 -0
  131. package/src/commands/status/doctor.cmd.ts +27 -0
  132. package/src/commands/status/release-notes.cmd.ts +9 -0
  133. package/src/commands/status/status.cmd.ts +25 -0
  134. package/src/commands/status/usage.cmd.ts +21 -0
  135. package/src/crews/.orkeon/orkeon.d.ts +4391 -0
  136. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  137. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
  138. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  139. package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
  140. package/src/crews/advisor/application/messages.ts +4 -0
  141. package/src/crews/advisor/application/prompts.ts +4 -0
  142. package/src/crews/advisor/application/run-advisor.ts +41 -0
  143. package/src/crews/advisor/crew.ork.ts +44 -0
  144. package/src/crews/advisor/domain/advice.ts +119 -0
  145. package/src/crews/advisor/domain/messages.ts +8 -0
  146. package/src/crews/advisor/domain/prompts.ts +26 -0
  147. package/src/crews/agent-run/application/messages.ts +18 -0
  148. package/src/crews/agent-run/application/run-agent-run.ts +43 -0
  149. package/src/crews/agent-run/crew.ork.ts +67 -0
  150. package/src/crews/analyze/application/messages.ts +27 -0
  151. package/src/crews/analyze/application/prompts.ts +4 -0
  152. package/src/crews/analyze/application/run-analyze.ts +120 -0
  153. package/src/crews/analyze/crew.ork.ts +41 -0
  154. package/src/crews/analyze/domain/harvest.ts +269 -0
  155. package/src/crews/analyze/domain/prompts.ts +86 -0
  156. package/src/crews/code-review/application/lens-material.ts +24 -0
  157. package/src/crews/code-review/application/messages.ts +17 -0
  158. package/src/crews/code-review/application/prompts.ts +126 -0
  159. package/src/crews/code-review/application/review.ts +74 -0
  160. package/src/crews/code-review/application/run-code-review.ts +121 -0
  161. package/src/crews/code-review/crew.ork.ts +52 -0
  162. package/src/crews/code-review/domain/lenses.ts +154 -0
  163. package/src/crews/code-review/domain/messages.ts +25 -0
  164. package/src/crews/code-review/domain/prompts.ts +58 -0
  165. package/src/crews/code-review/domain/report.ts +58 -0
  166. package/src/crews/code-review/domain/scope.ts +106 -0
  167. package/src/crews/dev-batches/application/messages.ts +127 -0
  168. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  169. package/src/crews/dev-batches/application/prompts.ts +10 -0
  170. package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
  171. package/src/crews/dev-batches/application/run-wave.ts +452 -0
  172. package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
  173. package/src/crews/dev-batches/crew.ork.ts +146 -0
  174. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  175. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  176. package/src/crews/dev-batches/domain/batches-log.ts +52 -0
  177. package/src/crews/dev-batches/domain/markers.ts +5 -0
  178. package/src/crews/dev-batches/domain/messages.ts +6 -0
  179. package/src/crews/dev-batches/domain/wave-order.ts +44 -0
  180. package/src/crews/dev-change/application/change-material.ts +44 -0
  181. package/src/crews/dev-change/application/evidence.ts +172 -0
  182. package/src/crews/dev-change/application/messages.ts +81 -0
  183. package/src/crews/dev-change/application/prompts.ts +101 -0
  184. package/src/crews/dev-change/application/run-dev-change.ts +324 -0
  185. package/src/crews/dev-change/crew.ork.ts +114 -0
  186. package/src/crews/dev-change/domain/change-answer.ts +163 -0
  187. package/src/crews/dev-change/domain/change-render.ts +77 -0
  188. package/src/crews/dev-change/domain/markers.ts +28 -0
  189. package/src/crews/dev-change/domain/messages.ts +16 -0
  190. package/src/crews/dev-implement/application/close.ts +186 -0
  191. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  192. package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
  193. package/src/crews/dev-implement/application/messages.ts +161 -0
  194. package/src/crews/dev-implement/application/observe.ts +52 -0
  195. package/src/crews/dev-implement/application/prompts.ts +9 -0
  196. package/src/crews/dev-implement/application/report-writes.ts +46 -0
  197. package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
  198. package/src/crews/dev-implement/application/run-role.ts +27 -0
  199. package/src/crews/dev-implement/application/suite-job.ts +122 -0
  200. package/src/crews/dev-implement/application/touched.ts +74 -0
  201. package/src/crews/dev-implement/crew.ork.ts +69 -0
  202. package/src/crews/dev-implement/domain/contracts.ts +255 -0
  203. package/src/crews/dev-implement/domain/correction.ts +103 -0
  204. package/src/crews/dev-implement/domain/cycles.ts +36 -0
  205. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  206. package/src/crews/dev-implement/domain/markers.ts +23 -0
  207. package/src/crews/dev-implement/domain/messages.ts +58 -0
  208. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  209. package/src/crews/dev-implement/domain/roles.ts +49 -0
  210. package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
  211. package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
  212. package/src/crews/dev-implement/domain/step-checks.ts +137 -0
  213. package/src/crews/dev-implement/domain/step-section.ts +129 -0
  214. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  215. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  216. package/src/crews/dev-learn/application/messages.ts +51 -0
  217. package/src/crews/dev-learn/application/prompts.ts +99 -0
  218. package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
  219. package/src/crews/dev-learn/crew.ork.ts +53 -0
  220. package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
  221. package/src/crews/dev-learn/domain/messages.ts +65 -0
  222. package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
  223. package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
  224. package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
  225. package/src/crews/dev-plan/application/inventory.ts +174 -0
  226. package/src/crews/dev-plan/application/messages.ts +88 -0
  227. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  228. package/src/crews/dev-plan/application/prompts.ts +141 -0
  229. package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
  230. package/src/crews/dev-plan/crew.ork.ts +112 -0
  231. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  232. package/src/crews/dev-plan/domain/markers.ts +18 -0
  233. package/src/crews/dev-plan/domain/messages.ts +118 -0
  234. package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
  235. package/src/crews/dev-plan/domain/plan-render.ts +306 -0
  236. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  237. package/src/crews/dev-spec/application/messages.ts +30 -0
  238. package/src/crews/dev-spec/application/prompts.ts +93 -0
  239. package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
  240. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  241. package/src/crews/dev-spec/crew.ork.ts +110 -0
  242. package/src/crews/dev-spec/domain/markers.ts +30 -0
  243. package/src/crews/dev-spec/domain/messages.ts +39 -0
  244. package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
  245. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  246. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  247. package/src/crews/dev-verify/application/audit.ts +267 -0
  248. package/src/crews/dev-verify/application/capture.ts +311 -0
  249. package/src/crews/dev-verify/application/messages.ts +119 -0
  250. package/src/crews/dev-verify/application/prompts.ts +209 -0
  251. package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
  252. package/src/crews/dev-verify/application/run-gate.ts +204 -0
  253. package/src/crews/dev-verify/crew.ork.ts +103 -0
  254. package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
  255. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  256. package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
  257. package/src/crews/dev-verify/domain/commands.ts +103 -0
  258. package/src/crews/dev-verify/domain/gate.ts +131 -0
  259. package/src/crews/dev-verify/domain/markers.ts +16 -0
  260. package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
  261. package/src/crews/dev-verify/domain/messages.ts +92 -0
  262. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  263. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  264. package/src/crews/dev-verify/domain/text.ts +20 -0
  265. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  266. package/src/crews/git-commit/application/draft.ts +133 -0
  267. package/src/crews/git-commit/application/messages.ts +15 -0
  268. package/src/crews/git-commit/application/prompts.ts +47 -0
  269. package/src/crews/git-commit/application/run-git-commit.ts +117 -0
  270. package/src/crews/git-commit/crew.ork.ts +53 -0
  271. package/src/crews/git-commit/domain/commit.ts +200 -0
  272. package/src/crews/git-commit/domain/markers.ts +4 -0
  273. package/src/crews/git-commit/domain/messages.ts +48 -0
  274. package/src/crews/init-verifiers/application/authoring.ts +90 -0
  275. package/src/crews/init-verifiers/application/messages.ts +13 -0
  276. package/src/crews/init-verifiers/application/prompts.ts +107 -0
  277. package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
  278. package/src/crews/init-verifiers/crew.ork.ts +35 -0
  279. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  280. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  281. package/src/crews/main-loop/application/auto-compact.ts +78 -0
  282. package/src/crews/main-loop/application/context-gather.ts +133 -0
  283. package/src/crews/main-loop/application/messages.ts +81 -0
  284. package/src/crews/main-loop/application/prompts.ts +12 -0
  285. package/src/crews/main-loop/application/run-main-loop.ts +383 -0
  286. package/src/crews/main-loop/application/turn-context.ts +111 -0
  287. package/src/crews/main-loop/crew.ork.ts +124 -0
  288. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  289. package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
  290. package/src/crews/main-loop/domain/prompts.ts +336 -0
  291. package/src/crews/main-loop/domain/turn-chains.ts +130 -0
  292. package/src/crews/project-init/application/detect.ts +123 -0
  293. package/src/crews/project-init/application/messages.ts +15 -0
  294. package/src/crews/project-init/application/prompts.ts +105 -0
  295. package/src/crews/project-init/application/run-project-init.ts +31 -0
  296. package/src/crews/project-init/crew.ork.ts +36 -0
  297. package/src/crews/project-init/domain/conventions.ts +36 -0
  298. package/src/crews/project-init/domain/existing-files.ts +65 -0
  299. package/src/crews/project-init/domain/messages.ts +13 -0
  300. package/src/crews/project-init/domain/package-map.ts +73 -0
  301. package/src/crews/project-init/domain/prompts.ts +10 -0
  302. package/src/crews/session-compact/application/prompts.ts +5 -0
  303. package/src/crews/session-compact/crew.ork.ts +56 -0
  304. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  305. package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
  306. package/src/crews/speech/application/messages.ts +3 -0
  307. package/src/crews/speech/application/prompts.ts +3 -0
  308. package/src/crews/speech/application/run-speech.ts +26 -0
  309. package/src/crews/speech/crew.ork.ts +38 -0
  310. package/src/shared/application/agents/child-agent.ts +259 -0
  311. package/src/shared/application/agents/messages.ts +35 -0
  312. package/src/shared/application/agents/route-agent.ts +115 -0
  313. package/src/shared/application/agents/run-sub-agent.ts +119 -0
  314. package/src/shared/application/answer-language.ts +14 -0
  315. package/src/shared/application/attached-skills.ts +36 -0
  316. package/src/shared/application/compaction/compact-session.ts +242 -0
  317. package/src/shared/application/compaction/extract-memories.ts +38 -0
  318. package/src/shared/application/compaction/messages.ts +20 -0
  319. package/src/shared/application/compaction/prune-context.ts +94 -0
  320. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  321. package/src/shared/application/compaction/restore-context.ts +78 -0
  322. package/src/shared/application/config-store.ts +123 -0
  323. package/src/shared/application/dev/brief-inventory.ts +115 -0
  324. package/src/shared/application/dev/close-batch.ts +85 -0
  325. package/src/shared/application/dev/find-repo-pack.ts +78 -0
  326. package/src/shared/application/dev/learn-decision.ts +254 -0
  327. package/src/shared/application/dev/load-dev-context.ts +265 -0
  328. package/src/shared/application/dev/measure-access-cost.ts +69 -0
  329. package/src/shared/application/dev/messages.ts +132 -0
  330. package/src/shared/application/dev/phase-timer.ts +54 -0
  331. package/src/shared/application/dev/plan-source.ts +116 -0
  332. package/src/shared/application/dev/preflight.ts +71 -0
  333. package/src/shared/application/dev/project-files.ts +17 -0
  334. package/src/shared/application/dev/prompts.ts +34 -0
  335. package/src/shared/application/dev/question-round.ts +60 -0
  336. package/src/shared/application/dev/resolve-work-folder.ts +134 -0
  337. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  338. package/src/shared/application/dev/settle-questions.ts +57 -0
  339. package/src/shared/application/dev/source-review.ts +67 -0
  340. package/src/shared/application/dev/source-step.ts +152 -0
  341. package/src/shared/application/dev/spend.ts +55 -0
  342. package/src/shared/application/dev/step-precedents.ts +90 -0
  343. package/src/shared/application/dev/tool-call-policy.ts +87 -0
  344. package/src/shared/application/dev/tool-callbacks.ts +262 -0
  345. package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
  346. package/src/shared/application/dev/verdict-sources.ts +50 -0
  347. package/src/shared/application/dev/wrapped-tools.ts +147 -0
  348. package/src/shared/application/extra-tools.ts +71 -0
  349. package/src/shared/application/git/batch-worktree.ts +102 -0
  350. package/src/shared/application/git/commit-files.ts +191 -0
  351. package/src/shared/application/git/merge-batch.ts +67 -0
  352. package/src/shared/application/git/messages.ts +75 -0
  353. package/src/shared/application/git/open-pull-request.ts +52 -0
  354. package/src/shared/application/host-context.ts +59 -0
  355. package/src/shared/application/host-layout-store.ts +45 -0
  356. package/src/shared/application/instructions-file.ts +19 -0
  357. package/src/shared/application/json-file.ts +34 -0
  358. package/src/shared/application/llm-profile.ts +36 -0
  359. package/src/shared/application/messages.ts +14 -0
  360. package/src/shared/application/permission-rules.ts +169 -0
  361. package/src/shared/application/ports/approvals.ts +20 -0
  362. package/src/shared/application/ports/clock.ts +5 -0
  363. package/src/shared/application/ports/code-index.ts +93 -0
  364. package/src/shared/application/ports/crew.ts +60 -0
  365. package/src/shared/application/ports/decision.ts +14 -0
  366. package/src/shared/application/ports/files.ts +21 -0
  367. package/src/shared/application/ports/human.ts +38 -0
  368. package/src/shared/application/ports/llm.ts +83 -0
  369. package/src/shared/application/ports/memory.ts +30 -0
  370. package/src/shared/application/ports/progress.ts +23 -0
  371. package/src/shared/application/ports/runtime.ts +15 -0
  372. package/src/shared/application/ports/session.ts +74 -0
  373. package/src/shared/application/ports/shared-memory.ts +26 -0
  374. package/src/shared/application/ports/shell.ts +40 -0
  375. package/src/shared/application/ports/telemetry.ts +45 -0
  376. package/src/shared/application/ports/theme.ts +11 -0
  377. package/src/shared/application/ports/tools.ts +46 -0
  378. package/src/shared/application/ports/usage.ts +45 -0
  379. package/src/shared/application/ports.ts +29 -0
  380. package/src/shared/application/project-manifests.ts +106 -0
  381. package/src/shared/application/session-io.ts +85 -0
  382. package/src/shared/application/session-state.ts +36 -0
  383. package/src/shared/application/shared-memory/admit-entries.ts +179 -0
  384. package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
  385. package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
  386. package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
  387. package/src/shared/application/shared-memory/memory-files.ts +111 -0
  388. package/src/shared/application/shared-memory/memory-settings.ts +94 -0
  389. package/src/shared/application/shared-memory/messages.ts +63 -0
  390. package/src/shared/application/shared-memory/push-candidate.ts +149 -0
  391. package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
  392. package/src/shared/application/skills/messages.ts +4 -0
  393. package/src/shared/application/skills/suggest-skills.ts +102 -0
  394. package/src/shared/application/state-snapshot.ts +38 -0
  395. package/src/shared/application/workflow/messages.ts +8 -0
  396. package/src/shared/application/workflow/workflow-state.ts +136 -0
  397. package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
  398. package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
  399. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  400. package/src/shared/domain/agent-policy/messages.ts +66 -0
  401. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  402. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  403. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  404. package/src/shared/domain/agent-policy/permission.ts +625 -0
  405. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  406. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  407. package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
  408. package/src/shared/domain/agent-policy/tool-access.ts +91 -0
  409. package/src/shared/domain/agent-registry.ts +143 -0
  410. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  411. package/src/shared/domain/agents/chain.ts +30 -0
  412. package/src/shared/domain/agents/charter.ts +64 -0
  413. package/src/shared/domain/agents/exclusive.ts +25 -0
  414. package/src/shared/domain/agents/instances.ts +252 -0
  415. package/src/shared/domain/agents/messages.ts +39 -0
  416. package/src/shared/domain/agents/model-route.ts +199 -0
  417. package/src/shared/domain/agents/prompts.ts +20 -0
  418. package/src/shared/domain/code-intel-contract.ts +357 -0
  419. package/src/shared/domain/code-intel-routing.ts +60 -0
  420. package/src/shared/domain/compact-outcome.ts +46 -0
  421. package/src/shared/domain/compaction-thresholds.ts +162 -0
  422. package/src/shared/domain/compaction.ts +288 -0
  423. package/src/shared/domain/config-schema.ts +434 -0
  424. package/src/shared/domain/context-prune.ts +176 -0
  425. package/src/shared/domain/decision/questions.ts +102 -0
  426. package/src/shared/domain/dev/access-cost.ts +230 -0
  427. package/src/shared/domain/dev/artefacts.ts +50 -0
  428. package/src/shared/domain/dev/batches-concurrency.ts +35 -0
  429. package/src/shared/domain/dev/batches-state.ts +49 -0
  430. package/src/shared/domain/dev/build-commands.ts +45 -0
  431. package/src/shared/domain/dev/call-guard.ts +342 -0
  432. package/src/shared/domain/dev/carried-text.ts +47 -0
  433. package/src/shared/domain/dev/design-rules.ts +100 -0
  434. package/src/shared/domain/dev/learn-proposals.ts +176 -0
  435. package/src/shared/domain/dev/learn-state.ts +94 -0
  436. package/src/shared/domain/dev/markers.ts +107 -0
  437. package/src/shared/domain/dev/messages.ts +259 -0
  438. package/src/shared/domain/dev/path-args.ts +42 -0
  439. package/src/shared/domain/dev/path-rebase.ts +93 -0
  440. package/src/shared/domain/dev/phase-timing.ts +50 -0
  441. package/src/shared/domain/dev/plan-checks.ts +191 -0
  442. package/src/shared/domain/dev/plan-format.ts +170 -0
  443. package/src/shared/domain/dev/project-files.ts +29 -0
  444. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  445. package/src/shared/domain/dev/prompts.ts +251 -0
  446. package/src/shared/domain/dev/questions.ts +267 -0
  447. package/src/shared/domain/dev/reading-rule.ts +41 -0
  448. package/src/shared/domain/dev/repo-pack.ts +240 -0
  449. package/src/shared/domain/dev/review-answer.ts +173 -0
  450. package/src/shared/domain/dev/review-brief.ts +54 -0
  451. package/src/shared/domain/dev/reviewer-charter.ts +35 -0
  452. package/src/shared/domain/dev/sheet-facts.ts +81 -0
  453. package/src/shared/domain/dev/spec-format.ts +182 -0
  454. package/src/shared/domain/dev/step-budget.ts +74 -0
  455. package/src/shared/domain/dev/step-rules.ts +109 -0
  456. package/src/shared/domain/dev/test-commands.ts +94 -0
  457. package/src/shared/domain/dev/test-output.ts +33 -0
  458. package/src/shared/domain/dev/test-paths.ts +40 -0
  459. package/src/shared/domain/dev/tool-guards.ts +65 -0
  460. package/src/shared/domain/dev/trait-pattern.ts +87 -0
  461. package/src/shared/domain/dev/verdict-format.ts +162 -0
  462. package/src/shared/domain/dev/whitespace.ts +35 -0
  463. package/src/shared/domain/dev/work-folder.ts +68 -0
  464. package/src/shared/domain/dev/yaml-subset.ts +385 -0
  465. package/src/shared/domain/error-text.ts +13 -0
  466. package/src/shared/domain/git/close.ts +274 -0
  467. package/src/shared/domain/git/messages.ts +20 -0
  468. package/src/shared/domain/git/pull-request.ts +96 -0
  469. package/src/shared/domain/git/worktree.ts +46 -0
  470. package/src/shared/domain/host-layout.ts +147 -0
  471. package/src/shared/domain/host-paths.ts +399 -0
  472. package/src/shared/domain/index-languages.ts +16 -0
  473. package/src/shared/domain/instructions-file.ts +18 -0
  474. package/src/shared/domain/iso-day.ts +4 -0
  475. package/src/shared/domain/llm-failure.ts +134 -0
  476. package/src/shared/domain/llm-profile.ts +44 -0
  477. package/src/shared/domain/marked-message.ts +29 -0
  478. package/src/shared/domain/markers.ts +30 -0
  479. package/src/shared/domain/messages.ts +291 -0
  480. package/src/shared/domain/model-catalog.ts +79 -0
  481. package/src/shared/domain/permission-modes.ts +99 -0
  482. package/src/shared/domain/prelude.ts +92 -0
  483. package/src/shared/domain/project-manifests.ts +84 -0
  484. package/src/shared/domain/prompts.ts +233 -0
  485. package/src/shared/domain/search-routing.ts +77 -0
  486. package/src/shared/domain/secret-patterns.ts +46 -0
  487. package/src/shared/domain/session-keys.ts +92 -0
  488. package/src/shared/domain/session-start.ts +61 -0
  489. package/src/shared/domain/severity.ts +72 -0
  490. package/src/shared/domain/sha1.ts +61 -0
  491. package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
  492. package/src/shared/domain/shared-memory/candidates.ts +40 -0
  493. package/src/shared/domain/shared-memory/entry.ts +151 -0
  494. package/src/shared/domain/shared-memory/front-matter.ts +187 -0
  495. package/src/shared/domain/shared-memory/gate.ts +45 -0
  496. package/src/shared/domain/shared-memory/harvest.ts +64 -0
  497. package/src/shared/domain/shared-memory/layout.ts +190 -0
  498. package/src/shared/domain/shared-memory/markers.ts +9 -0
  499. package/src/shared/domain/shared-memory/messages.ts +66 -0
  500. package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
  501. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  502. package/src/shared/domain/shared-memory/refused.ts +84 -0
  503. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  504. package/src/shared/domain/skills/prompts.ts +4 -0
  505. package/src/shared/domain/skills/shortlist.ts +149 -0
  506. package/src/shared/domain/snip-turns.ts +33 -0
  507. package/src/shared/domain/speech.ts +21 -0
  508. package/src/shared/domain/strip.ts +88 -0
  509. package/src/shared/domain/tool-trace.ts +120 -0
  510. package/src/shared/domain/types.ts +67 -0
  511. package/src/shared/domain/verifiers.ts +33 -0
  512. package/src/shared/domain/vfs.ts +16 -0
  513. package/src/shared/domain/workflow/prompts.ts +15 -0
  514. package/src/shared/domain/workflow/state-file.ts +142 -0
  515. package/src/shared/infrastructure/globals.ts +57 -0
  516. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  517. package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
  518. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  519. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  520. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  521. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  522. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  523. package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
  524. package/src/shared/infrastructure/orkeon/files.ts +58 -0
  525. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
  526. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  527. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  528. package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
  529. package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
  530. package/src/shared/infrastructure/orkeon/llm.ts +164 -0
  531. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  532. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  533. package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
  534. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  535. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  536. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  537. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  538. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  539. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  540. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  541. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  542. package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
  543. package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
  544. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  545. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  546. package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
  547. package/src/shared/infrastructure/orkeon/shell.ts +39 -0
  548. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  549. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
  550. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  551. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  552. package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
@@ -0,0 +1,136 @@
1
+ // The batch in progress, and its state file written before a compaction (step 0 of the
2
+ // compaction pipeline). The pointer is the session's (`workflow_active`, written by the
3
+ // step command that starts on a batch); the state is built from files and git only —
4
+ // the sheet, Code's event log, the reports recorded, `git status --short` — never from
5
+ // the model, so a compaction cannot get it wrong.
6
+ import type { Clock, Files, SessionStore, Shell } from "../ports.ts";
7
+ import type { ConfigStore } from "../config-store.ts";
8
+ import { WORKFLOW_ACTIVE_STATE_KEY } from "../../domain/session-keys.ts";
9
+ import {
10
+ batchesStatePath, firstOpenStep, formatActiveWorkflow, parseActiveWorkflow, renderStateFile, sheetStateSteps,
11
+ stateFilePath,
12
+ } from "../../domain/workflow/state-file.ts";
13
+ import type { ActiveWorkflow } from "../../domain/workflow/state-file.ts";
14
+ import { parseBatchesState } from "../../domain/dev/batches-state.ts";
15
+ import type { BatchesLogEntry } from "../../domain/dev/batches-state.ts";
16
+ import { listDevCodes, loadDevCode, loadDevContext } from "../dev/load-dev-context.ts";
17
+ import type { CodeSheet, DevCode } from "../dev/load-dev-context.ts";
18
+ import type { WorkFolder } from "../dev/resolve-work-folder.ts";
19
+ import { WORKSPACE } from "../../domain/vfs.ts";
20
+ import { gitStatusCouldNotRun, gitStatusFailed, noOpenSheetOf, noSheetOf, noWorkCode, workFolderUnreachable } from "./messages.ts";
21
+
22
+ export async function readActiveWorkflow(session: Pick<SessionStore, "readState">): Promise<ActiveWorkflow | null> {
23
+ return parseActiveWorkflow(await session.readState(WORKFLOW_ACTIVE_STATE_KEY));
24
+ }
25
+
26
+ export async function writeActiveWorkflow(session: Pick<SessionStore, "writeState">, active: ActiveWorkflow): Promise<void> {
27
+ await session.writeState(WORKFLOW_ACTIVE_STATE_KEY, formatActiveWorkflow(active));
28
+ }
29
+
30
+ export interface WorkflowStateDeps {
31
+ session: Pick<SessionStore, "readState">;
32
+ files: Pick<Files, "read" | "list" | "write">;
33
+ shell: Pick<Shell, "run">;
34
+ config: Pick<ConfigStore, "readValue">;
35
+ clock: Clock;
36
+ }
37
+
38
+ /** What step 0 did: the file written (relative to the project) and the first open step,
39
+ * or why it wrote none although a batch is in progress. */
40
+ export type StateWritten = { path: string; firstOpen: string | null } | { skipped: string };
41
+
42
+ const REPORTS_LISTED = 200;
43
+ const CODES_SEARCHED = 50;
44
+
45
+ const openSheet = (code: DevCode, phase: string): CodeSheet | undefined =>
46
+ code.sheets.find((s) => s.batch === phase && s.sheet.doneDate === undefined);
47
+
48
+ /** The code and sheet of the batch: the pointer's code, else the first code (by name) with
49
+ * an open sheet of that batch. */
50
+ async function findSheet(
51
+ deps: Pick<WorkflowStateDeps, "files">, work: WorkFolder, active: ActiveWorkflow,
52
+ ): Promise<{ code: DevCode; sheet: CodeSheet } | { skipped: string }> {
53
+ if (active.code !== null) {
54
+ const lookup = await loadDevCode(deps, work, active.code);
55
+ if (lookup.found === null) return { skipped: noWorkCode(active.code, work.folder, lookup.reason) };
56
+ const any = lookup.found.sheets.find((s) => s.batch === active.phase);
57
+ if (any === undefined) return { skipped: noSheetOf(active.phase, lookup.found.shown) };
58
+ if (any.sheet.doneDate !== undefined) return { skipped: `${lookup.found.shown}/${any.name} is done (${any.sheet.doneDate})` };
59
+ return { code: lookup.found, sheet: any };
60
+ }
61
+ const codes = (await listDevCodes(deps, work)).filter((c) => c.sheets > 0).slice(0, CODES_SEARCHED);
62
+ for (const summary of codes) {
63
+ const lookup = await loadDevCode(deps, work, summary.code);
64
+ if (lookup.found === null) continue;
65
+ const sheet = openSheet(lookup.found, active.phase);
66
+ if (sheet !== undefined) return { code: lookup.found, sheet };
67
+ }
68
+ return { skipped: noOpenSheetOf(active.phase, work.folder) };
69
+ }
70
+
71
+ /** The batch's events: Code's own log when there is one, else the log of the work code's
72
+ * folder (`<CODE>-BATCHES-STATE.md`, same line shape). */
73
+ async function readEvents(files: Pick<Files, "read">, code: DevCode, phase: string): Promise<string[]> {
74
+ let entries: BatchesLogEntry[];
75
+ try {
76
+ entries = parseBatchesState(await files.read(`${WORKSPACE}/${batchesStatePath(code.code)}`)).entries;
77
+ } catch {
78
+ entries = code.state?.state.entries ?? [];
79
+ }
80
+ return entries
81
+ .filter((e) => e.batch === phase)
82
+ .map((e) => `- ${e.date} ${e.time} ${e.batch} ${e.event}${e.detail ? ` ${e.detail}` : ""}`);
83
+ }
84
+
85
+ async function readReports(files: Pick<Files, "list">, folder: string, phase: string): Promise<string[]> {
86
+ let names: string[];
87
+ try {
88
+ names = await files.list(`${folder}/reports`, REPORTS_LISTED);
89
+ } catch {
90
+ return [];
91
+ }
92
+ const ofPhase = new RegExp(`(^|[^A-Za-z0-9])${phase}([^0-9]|$)`);
93
+ return names.map((n) => n.replace(/\/+$/, "")).filter((n) => ofPhase.test(n)).sort();
94
+ }
95
+
96
+ async function readTree(shell: Pick<Shell, "run">): Promise<{ lines: string[] } | { note: string }> {
97
+ try {
98
+ const r = await shell.run("git status --short");
99
+ if (r.exitCode !== 0) return { note: gitStatusFailed((r.stderr || r.stdout).trim().split("\n")[0] || `exit ${r.exitCode}`) };
100
+ return { lines: r.stdout.split(/\r?\n/).filter((l) => l.trim().length > 0) };
101
+ } catch (error) {
102
+ return { note: gitStatusCouldNotRun(error instanceof Error ? error.message : String(error)) };
103
+ }
104
+ }
105
+
106
+ /**
107
+ * Write the state file of the batch in progress; null when no batch is. Throws when the
108
+ * work folder cannot be read or the file cannot be written: the caller logs it and goes on.
109
+ */
110
+ export async function writeWorkflowState(
111
+ deps: WorkflowStateDeps, trigger: "manual" | "auto",
112
+ ): Promise<StateWritten | null> {
113
+ const active = await readActiveWorkflow(deps.session);
114
+ if (active === null) return null;
115
+ const { work } = await loadDevContext(deps);
116
+ if (work.vfsPath === null) return { skipped: workFolderUnreachable(work.folder) };
117
+ const found = await findSheet(deps, work, active);
118
+ if ("skipped" in found) return found;
119
+
120
+ const { code, sheet } = found;
121
+ const steps = sheetStateSteps(sheet.sheet);
122
+ const path = stateFilePath(code.code, active.phase);
123
+ const text = renderStateFile({
124
+ code: code.code,
125
+ phase: active.phase,
126
+ at: deps.clock().toISOString().replace(/\.\d{3}Z$/, "Z"),
127
+ trigger,
128
+ sheet: `${code.shown}/${sheet.name}`,
129
+ steps,
130
+ events: await readEvents(deps.files, code, active.phase),
131
+ reports: await readReports(deps.files, `${work.vfsPath}/${code.code}`, active.phase),
132
+ tree: await readTree(deps.shell),
133
+ });
134
+ await deps.files.write(`${WORKSPACE}/${path}`, text);
135
+ return { path, firstOpen: firstOpenStep(steps) };
136
+ }
@@ -0,0 +1,162 @@
1
+ // What the persisted behavior flags actually DO. Pure, no IO.
2
+ //
3
+ // `/effort`, `/fast`, `/passes` and `/proactive` are persisted settings; this
4
+ // module is the semantics half — the loop and the review crew are the consumption
5
+ // half.
6
+ //
7
+ // The governing constraint: an UNCONFIGURED session must behave exactly as it did
8
+ // before the flags existed. Every default below is therefore the value that was hard-coded at
9
+ // the call site (40 act iterations, one review pass, nothing dropped, no extra
10
+ // clause), so turning a flag on is the only thing that changes anything.
11
+ import { effortFlag } from "./messages.ts";
12
+ import { PROACTIVE_CLAUSE } from "./prompts.ts";
13
+
14
+ // ── /effort → the act() iteration ladder ─────────────────────────────────
15
+
16
+ export const EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"] as const;
17
+ export type EffortLevel = (typeof EFFORT_LEVELS)[number];
18
+
19
+ /** Unset ⇒ `medium`, whose ladder rung IS the pre-B-9 hard-coded value. */
20
+ export const DEFAULT_EFFORT: EffortLevel = "medium";
21
+
22
+ /**
23
+ * Iterations granted to `ctx.llm.act` per level.
24
+ *
25
+ * The ladder bounds the tool-calling loop. The level also reaches the
26
+ * provider: `act({ effort })` and `AgentBuilder.effort()` turn its thinking on at that level (A-3).
27
+ * Only a level `/effort` stored is forwarded (`providerEffort`): an unconfigured session sends none,
28
+ * so it keeps the provider's own default and the 40 iterations it always had.
29
+ *
30
+ * `xhigh` and `max` are Anthropic's two levels above `high`; to a provider whose field does not know one the
31
+ * runtime sends the highest level it knows below it, with a warning in its log. The ladder keeps climbing: a
32
+ * turn that asks the model for its most thorough reasoning is also the one given the most room to act.
33
+ */
34
+ export const EFFORT_MAX_ITERATIONS: Readonly<Record<EffortLevel, number>> = {
35
+ low: 10,
36
+ medium: 40,
37
+ high: 80,
38
+ xhigh: 120,
39
+ max: 160,
40
+ };
41
+
42
+ export function isEffortLevel(raw: unknown): raw is EffortLevel {
43
+ return EFFORT_LEVELS.includes(String(raw ?? "").trim().toLowerCase() as EffortLevel);
44
+ }
45
+
46
+ /** Normalise a stored value; anything unrecognised falls back to the default. */
47
+ export function resolveEffort(raw: unknown): EffortLevel {
48
+ const v = String(raw ?? "").trim().toLowerCase();
49
+ return isEffortLevel(v) ? (v as EffortLevel) : DEFAULT_EFFORT;
50
+ }
51
+
52
+ /** The level forwarded to the provider (`act({effort})`): a stored valid level; undefined when none is stored. */
53
+ export function providerEffort(raw: unknown): EffortLevel | undefined {
54
+ const v = String(raw ?? "").trim().toLowerCase();
55
+ return isEffortLevel(v) ? (v as EffortLevel) : undefined;
56
+ }
57
+
58
+ /** The act() iteration cap for a stored effort value. */
59
+ export function maxIterationsFor(raw: unknown): number {
60
+ return EFFORT_MAX_ITERATIONS[resolveEffort(raw)];
61
+ }
62
+
63
+ // ── /passes → review rounds ──────────────────────────────────────────────
64
+
65
+ export const MIN_PASSES = 1;
66
+ export const MAX_PASSES = 5;
67
+ /** Unset ⇒ 1 — the single fan-out /review has always done. */
68
+ export const DEFAULT_PASSES = MIN_PASSES;
69
+
70
+ /** Clamp a stored pass count into 1..5; junk ⇒ the default. */
71
+ export function resolvePasses(raw: unknown): number {
72
+ const n = Number(String(raw ?? "").trim());
73
+ if (!Number.isInteger(n)) return DEFAULT_PASSES;
74
+ return Math.min(MAX_PASSES, Math.max(MIN_PASSES, n));
75
+ }
76
+
77
+ // ── /fast → drop the advisory prompt blocks ──────────────────────────────
78
+
79
+ /**
80
+ * The blocks `/fast` omits from the assembled prompt.
81
+ *
82
+ * Chosen as the two ADVISORY blocks — the ones that widen the model's context
83
+ * without being required to answer the request — and they are also the two
84
+ * largest: an attached skill is capped at 4 000 characters EACH (B-13) and the
85
+ * memory block carries up to four categories of recalled notes.
86
+ *
87
+ * Everything else stays: the static header (identity, tool list, CLAUDE.md) is
88
+ * the cache prefix and dropping it would cost more than it saves; preferences
89
+ * and hooks are operator instructions; git context, history and the gauge are
90
+ * the situation. Dropping those would change WHAT is answered, not how fast.
91
+ *
92
+ * Fast mode is a real degradation, so the loop logs it — a shorter answer with
93
+ * no memory must never look like the model simply forgot.
94
+ */
95
+ export const FAST_MODE_DROPPED_BLOCKS = ["skills", "memory"] as const;
96
+ export type DroppableBlock = (typeof FAST_MODE_DROPPED_BLOCKS)[number];
97
+
98
+ export function fastModeDrops(fast: boolean): readonly DroppableBlock[] {
99
+ return fast ? FAST_MODE_DROPPED_BLOCKS : [];
100
+ }
101
+
102
+ // ── /proactive → the follow-up clause ────────────────────────────────────
103
+
104
+
105
+ export function proactiveSuffix(on: boolean): string {
106
+ return on ? `\n\n${PROACTIVE_CLAUSE}` : "";
107
+ }
108
+
109
+ // ── the flag set the loop reads in one go ────────────────────────────────
110
+
111
+ export interface BehaviorFlags {
112
+ effort: EffortLevel;
113
+ /** The level the provider thinks at: the one /effort stored, null when it stored none (A-3). */
114
+ thinking: EffortLevel | null;
115
+ passes: number;
116
+ fast: boolean;
117
+ proactive: boolean;
118
+ /** `/model` override for this turn; empty ⇒ the boot model (B-10). */
119
+ model: string;
120
+ }
121
+
122
+ /** The unconfigured session — the pre-B-9 behaviour, byte for byte. */
123
+ export const DEFAULT_BEHAVIOR_FLAGS: BehaviorFlags = {
124
+ effort: DEFAULT_EFFORT,
125
+ thinking: null,
126
+ passes: DEFAULT_PASSES,
127
+ fast: false,
128
+ proactive: false,
129
+ model: "",
130
+ };
131
+
132
+ /** Build the flag set from raw stored strings (all optional). */
133
+ export function resolveBehaviorFlags(raw: {
134
+ effort?: unknown; passes?: unknown; fast?: unknown; proactive?: unknown; model?: unknown;
135
+ }): BehaviorFlags {
136
+ return {
137
+ effort: resolveEffort(raw?.effort),
138
+ thinking: providerEffort(raw?.effort) ?? null,
139
+ passes: resolvePasses(raw?.passes),
140
+ fast: String(raw?.fast ?? "") === "true",
141
+ proactive: String(raw?.proactive ?? "") === "true",
142
+ model: String(raw?.model ?? "").trim(),
143
+ };
144
+ }
145
+
146
+ /**
147
+ * One line naming every flag that is NOT at its default, or "" when the session
148
+ * is unconfigured. The loop logs it: a turn that behaves differently must say
149
+ * which setting made it so, otherwise the effect reads as model variance.
150
+ */
151
+ export function describeActiveFlags(flags: BehaviorFlags): string {
152
+ const active: string[] = [];
153
+ // A stored level, even `medium`, is named: it turns the provider's thinking on.
154
+ if (flags.thinking !== null) {
155
+ active.push(effortFlag(flags.effort, EFFORT_MAX_ITERATIONS[flags.effort], flags.thinking));
156
+ }
157
+ if (flags.passes !== DEFAULT_PASSES) active.push(`passes=${flags.passes}`);
158
+ if (flags.fast) active.push(`fast=on (dropping ${FAST_MODE_DROPPED_BLOCKS.join(", ")})`);
159
+ if (flags.proactive) active.push("proactive=on");
160
+ if (flags.model) active.push(`model=${flags.model}`);
161
+ return active.join(" · ");
162
+ }
@@ -0,0 +1,67 @@
1
+ // The `tools.extra` setting — pure, no IO: the tools the host registers beyond
2
+ // Orkeon Code's built-in lists (an MCP server's under Orkeon's `MCP:Servers`, a
3
+ // plugin's) that the main agent may use, each with the access class that decides
4
+ // which modes offer it (mode-policy.ts). The notation:
5
+ //
6
+ // transcribe_audio:read, search_issues, create_issue:write
7
+ //
8
+ // entries separated by commas or spaces, each `<name>` or `<name>:<read|write>`.
9
+ // A name without a class is a write: the read-only modes do not offer it unless
10
+ // the user says it only reads. The host's permission gate still decides each
11
+ // call from the access the tool declares to Orkeon.
12
+
13
+ import { builtInTool, sameToolName } from "./permission.ts";
14
+ import type { ExtraTool } from "./permission.ts";
15
+ import { EXTRA_TOOL_ENTRY_RULE, NAMES_NO_TOOL } from "./messages.ts";
16
+
17
+ /** The /config key that lists them. */
18
+ export const EXTRA_TOOLS_CONFIG_KEY = "tools.extra";
19
+
20
+ /** A tool name as the host registers it: letters, digits, `_`, `-`, `.`. */
21
+ const TOOL_NAME = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
22
+
23
+ export interface ExtraToolsParse {
24
+ /** The valid entries, in the order given. */
25
+ tools: ExtraTool[];
26
+ /** Entries left out, as written: not the notation, a built-in tool (its class is
27
+ * Orkeon Code's), or a name given again. */
28
+ invalid: string[];
29
+ }
30
+
31
+ /**
32
+ * Parses the setting, or the list the crew receives (one entry per item). Never
33
+ * throws: what does not parse is returned in `invalid` for the caller to report.
34
+ */
35
+ export function parseExtraTools(value: unknown): ExtraToolsParse {
36
+ const entries = Array.isArray(value)
37
+ ? value.map((e) => String(e ?? "").trim())
38
+ : String(value ?? "").split(/[\s,]+/);
39
+ const tools: ExtraTool[] = [];
40
+ const invalid: string[] = [];
41
+ for (const entry of entries.filter((e) => e.length > 0)) {
42
+ const colon = entry.indexOf(":");
43
+ const name = colon < 0 ? entry : entry.slice(0, colon);
44
+ const access = colon < 0 ? "write" : entry.slice(colon + 1);
45
+ // Orkeon compares tool names case-insensitively: `File_Read` is the built-in
46
+ // `file_read`, and `Search_Issues` names `search_issues` again.
47
+ const valid = TOOL_NAME.test(name) && (access === "read" || access === "write")
48
+ && builtInTool(name) === undefined && !tools.some((t) => sameToolName(t.name, name));
49
+ if (valid) tools.push({ name, access: access as ExtraTool["access"] });
50
+ else invalid.push(entry);
51
+ }
52
+ return { tools, invalid };
53
+ }
54
+
55
+ /** One entry in the notation, class always written: `search_issues:write`. */
56
+ export function formatExtraTool(tool: ExtraTool): string {
57
+ return `${tool.name}:${tool.access}`;
58
+ }
59
+
60
+ /** Why a value of the setting is refused, or undefined when every entry parses. */
61
+ export function extraToolsProblem(value: string): string | undefined {
62
+ const { tools, invalid } = parseExtraTools(value);
63
+ if (invalid.length > 0) {
64
+ return `${EXTRA_TOOL_ENTRY_RULE}; not: ${invalid.join(", ")}`;
65
+ }
66
+ return tools.length === 0 ? NAMES_NO_TOOL : undefined;
67
+ }
@@ -0,0 +1,6 @@
1
+ // Typed-memory categories — pure, no IO. The set the memory backend accepts
2
+ // (InMemoryCategoryMemoryStore), in the fixed order the prompt renders them; read
3
+ // by /memory, /export, the main-loop memory block and the compaction's memory
4
+ // extraction.
5
+
6
+ export const MEMORY_CATEGORIES = ["user", "project", "feedback", "reference"] as const;
@@ -0,0 +1,66 @@
1
+ // The messages of shared/domain/agent-policy: the text the user reads (ADR 0026).
2
+
3
+ // ── Permission rules ────────────────────────────────────────────────────
4
+
5
+ /** Why an allow rule does nothing in plan, or in a mode that does not offer its tool. */
6
+ export const PLAN_IGNORES_ALLOW_RULES =
7
+ "mode 'plan' ignores every allow rule: the gate decides each call from the mode, which runs reads " +
8
+ "and refuses the rest. Switch mode instead.";
9
+ export const modeDoesNotOffer = (mode: string, tool: string): string =>
10
+ `mode '${mode}' does not offer '${tool}': an allow rule spares a question, ` +
11
+ "it does not hand a tool over. Switch mode instead.";
12
+
13
+ /** What a rule to add is refused or warned for. */
14
+ export const noToolARuleMayName = (tool: string, tools: string): string =>
15
+ `'${tool}' is no tool a rule may name: one of ${tools}`;
16
+ export const offeredToEveryAct = (tool: string): string =>
17
+ `'${tool}' is offered to every act whatever the mode: an allow rule lets it run without asking in ` +
18
+ "dontAsk too.";
19
+ export const argumentsNotKnown = (tool: string, argument: string): string =>
20
+ `the arguments of '${tool}' are not known here (its MCP server or plugin declares them): the rule ` +
21
+ `matches a call only if '${tool}' takes an argument named exactly '${argument}'.`;
22
+ export const takesNoArgument = (tool: string): string => `'${tool}' takes no argument: a rule on it covers every call`;
23
+ export const hasNoArgument = (tool: string, argument: string, known: readonly string[]): string =>
24
+ `'${tool}' has no argument '${argument}': it takes ${known.join(", ")}`;
25
+
26
+ // ── Behaviour flags, extra tools ────────────────────────────────────────
27
+
28
+ export const effortFlag = (effort: string, maxIterations: number, thinking: string): string =>
29
+ `effort=${effort} (act maxIterations=${maxIterations}, provider thinking asked at ${thinking})`;
30
+
31
+ /** What an entry must be, for messages. */
32
+ export const EXTRA_TOOL_ENTRY_RULE = "each entry is <name>[:read|:write], a tool that is not built in, named once";
33
+ export const NAMES_NO_TOOL = "it names no tool";
34
+
35
+ // ── Path rules ──────────────────────────────────────────────────────────
36
+
37
+ /** What an entry must be, for messages. */
38
+ export const PATH_ENTRY_RULE =
39
+ "entries separated by commas, each a path of a mount in any spelling or a path under /workspace, `*` for any run of characters";
40
+ export const underNoMount = (given: string): string => `'${given}' is under no mount of this host: no rule`;
41
+ export const namesEveryPathNoRule = (given: string): string => `'${given}' names every path: no rule`;
42
+ export const holdsAQuote = (entry: string, rule: string): string =>
43
+ `'${entry}' holds a quote: write the path bare, its spaces included (${rule})`;
44
+ export const namesEveryPath = (entry: string, rule: string): string => `'${entry}' names every path (${rule})`;
45
+ export const outsideUserList = (key: string, entry: string): string =>
46
+ `${key} (project): '${entry}' is outside the user's list; a project file may only narrow it`;
47
+ export const refusedOwnMount = (tool: string, path: string, mount: string): string =>
48
+ `${tool} on ${path} is refused: ${mount} is Orkeon Code's own`;
49
+ export const refusedByDeny = (tool: string, path: string, key: string, deny: string): string =>
50
+ `${tool} on ${path} is refused by ${key} '${deny}'`;
51
+ export const outsideAllow = (tool: string, path: string, key: string): string => `${tool} on ${path} is outside ${key}`;
52
+
53
+ // ── Rule sets ───────────────────────────────────────────────────────────
54
+
55
+ export const GIT_READONLY_TITLE = "git commands that change the repository, its branches or its remotes";
56
+ export const INLINE_INTERPRETERS_TITLE = "code handed inline to an interpreter, which could run what the other rules refuse";
57
+ export const READ_NOISE_TITLE = "reads under build outputs, version-control internals and installed packages";
58
+ export const SECRETS_TITLE = "a private key block or a token with a known prefix in written content";
59
+ export const STATE_FILES_TITLE = "files only Orkeon Code's own code writes";
60
+ export const rootWholeProject = (raw: string): string => `root '${raw}' names the whole project: no rule`;
61
+ export const rootOutside = (raw: string, workspace: string): string => `root '${raw}' is outside ${workspace}: no rule`;
62
+ export const rootClimbsOut = (raw: string): string => `root '${raw}' climbs out with '..': no rule`;
63
+ export const rootHoldsStar = (raw: string): string => `root '${raw}' holds '*': a rule on it would cover more than the folder`;
64
+ export const patternWholeProject = (raw: string): string => `pattern '${raw}' covers the whole project: no rule`;
65
+ export const patternOutside = (raw: string, workspace: string): string => `pattern '${raw}' is outside ${workspace}: no rule`;
66
+ export const patternClimbsOut = (raw: string): string => `pattern '${raw}' climbs out with '..': no rule`;
@@ -0,0 +1,51 @@
1
+ // What each permission mode offers the model, one row per mode — pure, no IO.
2
+ // The main-loop catalogue (permission.ts), /commit's refusal
3
+ // (crews/git-commit/domain/commit.ts) and /mode's announcement all read this
4
+ // table, so a mode's policy is stated once: a new mode is an entry of
5
+ // PERMISSION_MODES and a row here.
6
+
7
+ import { isPermissionMode } from "../permission-modes.ts";
8
+ import type { PermissionMode } from "../permission-modes.ts";
9
+
10
+ /**
11
+ * The classes of tools a mode can hand the model, in catalogue order. `extra` is
12
+ * the extra tools of access class `write` (the `tools.extra` setting: an MCP
13
+ * server's or a plugin's tools); an extra tool of class `read` joins `read`.
14
+ */
15
+ export type ToolClass = "read" | "network" | "edit" | "shell" | "extra";
16
+
17
+ export interface ModePolicy {
18
+ /** The turn changes nothing observable: local reads only, no edit, no shell, no network. */
19
+ readOnly: boolean;
20
+ /** The tool classes the model is given, in catalogue order. */
21
+ toolClasses: readonly ToolClass[];
22
+ }
23
+
24
+ export const MODE_POLICIES: Readonly<Record<PermissionMode, ModePolicy>> = {
25
+ // The writing modes offer every class; the host gate decides what asks, from
26
+ // the access each call declares (Orkeon #219 and #223: `github` reads for its
27
+ // read actions, `http_api` for GET, HEAD and OPTIONS without a body nor a
28
+ // method-override header, `rag_eval` edits). In
29
+ // `default` it asks before every call that is not a read (a `github` write,
30
+ // an `http_api` POST, the shell, every edit), in `acceptEdits` before every
31
+ // call that is neither a read nor a file edit, and `bypassPermissions` never asks.
32
+ default: { readOnly: false, toolClasses: ["read", "network", "edit", "shell", "extra"] },
33
+ acceptEdits: { readOnly: false, toolClasses: ["read", "network", "edit", "shell", "extra"] },
34
+ bypassPermissions: { readOnly: false, toolClasses: ["read", "network", "edit", "shell", "extra"] },
35
+ // `plan` inspects only; `dontAsk` (E-3) denies writes without asking. Both get
36
+ // the local read tools only: network reads are withheld too (B-8) because
37
+ // these modes promise that the turn changes nothing observable, and an outbound
38
+ // request is observable elsewhere — it can leak the repository's contents to a
39
+ // third party and it can trigger a side effect on the far end. An extra tool
40
+ // the user did not mark `read` is withheld for the same reason.
41
+ plan: { readOnly: true, toolClasses: ["read"] },
42
+ dontAsk: { readOnly: true, toolClasses: ["read"] },
43
+ };
44
+
45
+ /**
46
+ * The policy of a mode. An unknown mode gets `default`'s: the catalogue degrades
47
+ * to the permissive default (the C# gate classifies unknown modes fail-closed).
48
+ */
49
+ export function policyFor(mode: string): ModePolicy {
50
+ return isPermissionMode(mode) ? MODE_POLICIES[mode as PermissionMode] : MODE_POLICIES.default;
51
+ }
@@ -0,0 +1,11 @@
1
+ // The output styles /output-style accepts and the prompt assembly renders —
2
+ // pure, no IO. A style the assembly cannot render is not settable.
3
+
4
+ export const OUTPUT_STYLES = ["default", "concise", "explanatory", "learning"] as const;
5
+
6
+ export function isOutputStyle(token: unknown): boolean {
7
+ return (OUTPUT_STYLES as readonly string[]).includes(String(token ?? ""));
8
+ }
9
+
10
+ /** The setting naming the language the assistant answers in (`/config set answer.language French`). */
11
+ export const ANSWER_LANGUAGE_CONFIG_KEY = "answer.language";