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,30 @@
1
+ // The markers of shared/domain: the values a writer and a reader share (ADR 0026).
2
+
3
+ // ── Compaction ──────────────────────────────────────────────────────────
4
+
5
+ /** The markers the summary is written between; the host keeps only what they enclose. */
6
+ export const SUMMARY_OPEN = "<summary>";
7
+ export const SUMMARY_CLOSE = "</summary>";
8
+
9
+ /** Content marker of the compaction boundary — survives stores that round-trip
10
+ * only role/content, so detection never depends on `subtype`. The model never
11
+ * reads it: the history block leaves boundaries out. */
12
+ export const COMPACT_BOUNDARY_MARKER = "[compact-boundary]";
13
+
14
+ /** The first line of the summary message: what it is, so its "still to do" part
15
+ * does not read as a fresh request. */
16
+ export const COMPACTED_HEADER = "[compacted] Summary of the earlier turns, written when they were compacted: a record of the work, not a new request.";
17
+
18
+ // ── Marked messages ─────────────────────────────────────────────────────
19
+
20
+ /** The marker of the stored message holding a turn's context lines; the header names it as material. */
21
+ export const TURN_CONTEXT_MARKER = "[turn-context]";
22
+
23
+ /** The marker of a turn's tool trace; the header names it as material. */
24
+ export const TOOL_TRACE_MARKER = "[tools]";
25
+
26
+ /** The reason a compaction is skipped when the buffer holds too little to summarise. */
27
+ export const BUFFER_TOO_SMALL = "buffer too small";
28
+
29
+ /** The line that closes the output of the session start script. */
30
+ export const SESSION_START_END_MARKER = "\n[End of session start script]";
@@ -0,0 +1,291 @@
1
+ // The messages of shared/domain: the text the user reads (ADR 0026).
2
+
3
+ // ── Model failures ──────────────────────────────────────────────────────
4
+
5
+ /** The error a failed model call becomes. */
6
+ export const modelCallFailed = (detail: string): string => `the model call failed: ${detail}`;
7
+
8
+ /** Why a decision stage blocked a request, when it gave no reason but a risk. */
9
+ export const matchesTheRisk = (risk: string): string => `the request matches the risk '${risk}'`;
10
+
11
+ /** What the user reads for a blocked request: a decision, not an outage, and what to do about it. */
12
+ export const blockedByDecisionProfile = (profile: string, stage: string, why: string | null): string =>
13
+ `Blocked by the decision profile '${profile}' (stage '${stage}')${why === null ? "" : `: ${why}`}. ` +
14
+ "The model gave no answer; rephrase the request, or choose another profile with /config set llm.profile.";
15
+
16
+ /** What the error of an exhausted token budget says: the runtime's words, so a reader sees the dimension. */
17
+ export const BUDGET_EXHAUSTED_MESSAGE = "Token budget exhausted: the model made its last call without tools, and its answer is cut short";
18
+
19
+ /** What the error of an act stopped at its iteration cap says: `turns` tool-call turns, no final answer. */
20
+ export const iterationsExhaustedMessage = (turns: number | null): string =>
21
+ `the act used its ${turns === null ? "" : `${turns} `}tool-call turns without a final answer`;
22
+
23
+ // ── Code index ──────────────────────────────────────────────────────────
24
+
25
+ /** What the index cache did, in words. */
26
+ export const CACHE_HIT = "cache hit: the index an earlier session saved, no file changed";
27
+ export const cacheRefreshed = (reindexed: number): string => `cache refreshed: ${reindexed} changed file(s) reindexed`;
28
+ export const CACHE_MISS = "cache miss: built, then saved";
29
+ export const CACHE_BYPASSED = "cache bypassed: rebuilt, then saved";
30
+
31
+ // ── Config keys: what each one does and who reads it, as /config keys shows them ──
32
+
33
+ /** The words of a config key: what it does, and who reads it. */
34
+ export interface ConfigKeyDoc { description: string; consumedBy: string }
35
+
36
+ /** Who reads paths.deny and paths.allow. */
37
+ const PATH_LISTS_CONSUMERS =
38
+ "/assistant, the dev steps and every other command that launches a crew (each act's calls), /permissions (the deny rules in the gate), /doctor";
39
+
40
+ export const PERMISSION_FALLBACK_DOC: ConfigKeyDoc = {
41
+ description:
42
+ "Permission mode for a session where neither /mode nor a 'mode:' prefix set one. " +
43
+ "Omitted = 'default' (asks on writes, like the original).",
44
+ consumedBy: "/assistant (main-loop crew), /commit, /mode, /permissions",
45
+ };
46
+
47
+ export const REVIEW_LENSES_DOC: ConfigKeyDoc = {
48
+ description:
49
+ "Comma-separated review lenses for /review (correctness, security, style). " +
50
+ "Omitted = all three.",
51
+ consumedBy: "/review (code-review crew)",
52
+ };
53
+
54
+ export const ADVISOR_MODEL_DOC: ConfigKeyDoc = {
55
+ description:
56
+ "Model used for the secondary opinion of /advisor. Omitted = the session's own " +
57
+ "model, which makes the review a self-review and worth far less.",
58
+ consumedBy: "/advisor (advisor crew)",
59
+ };
60
+
61
+ export const LLM_PROFILE_DOC: ConfigKeyDoc = {
62
+ description:
63
+ "The host profile the agents of every crew run on: an LLM profile (Llm:Profiles:<name>) or a decision " +
64
+ "profile (Orkeon:Decision:Profiles:<name>, a decision model such as Jev in front of one), e.g. 'guarded'. " +
65
+ "A name the host does not declare fails the crew's load, listing the profiles it knows. Omitted = the host's " +
66
+ "default model.",
67
+ consumedBy: "/assistant, /review, /commit, /advisor, /memory admit, the dev steps and every other command that launches a crew (the model its agents run on)",
68
+ };
69
+
70
+ export const COMMIT_REQUIRE_CONFIRM_DOC: ConfigKeyDoc = {
71
+ description:
72
+ "'false' lets /commit launch without a confirmation prompt. Omitted = 'true' " +
73
+ "(a confirmation is required; see B-1).",
74
+ consumedBy: "/commit",
75
+ };
76
+
77
+ export const SPINNER_VERBS_DOC: ConfigKeyDoc = {
78
+ description:
79
+ "Comma-separated verbs the TUI status line rotates through while a turn runs " +
80
+ "(tweakcc vocabulary: 'thinking verbs'), e.g. 'Reticulating, Percolating'. " +
81
+ "Omitted = the built-in Orkeon gerunds.",
82
+ consumedBy: "the orkeon-repl TUI status line (read by the host)",
83
+ };
84
+
85
+ export const EXTRA_TOOLS_DOC: ConfigKeyDoc = {
86
+ description:
87
+ "Tools of an MCP server or a plugin the assistant may use, e.g. 'transcribe_audio:read, " +
88
+ "search_issues': each <name>[:read|:write], write when the class is left out, so plan " +
89
+ "and dontAsk offer only the read ones. A name the host does not register is left out " +
90
+ "with a warning. Omitted = none.",
91
+ consumedBy: "/assistant and /summary (the tools offered), /permissions (rules may name them)",
92
+ };
93
+
94
+ export const VOICE_REPLY_DOC: ConfigKeyDoc = {
95
+ description:
96
+ "'on' reads every answer of the assistant aloud, through the speech MCP server's speak " +
97
+ "(the launcher's ORKEON_CODE_VOICE=1 opens the speaker); code blocks and tables are not read. " +
98
+ "Omitted = 'off'.",
99
+ consumedBy: "/assistant, /summary, /transcribe --then, /voice send and /voice --go (each answer read aloud)",
100
+ };
101
+
102
+ export const ANSWER_LANGUAGE_DOC: ConfigKeyDoc = {
103
+ description:
104
+ "The language the assistant answers in, e.g. 'French', unless the user writes in another one. " +
105
+ "Omitted = the language of each request.",
106
+ consumedBy: "/assistant, /summary, /transcribe --then, /voice send and /voice --go (the main loop's prompt)",
107
+ };
108
+
109
+ export const PRUNE_DOC: ConfigKeyDoc = {
110
+ description:
111
+ "'on' lets the host's decision model prune the tool loop of a turn: past 40 % of the context window, an older " +
112
+ "result of a read tool that is no longer needed is removed or cut to its first 300 characters, with a note that says how " +
113
+ "to get it back. Needs a decision provider on the host; without one nothing is pruned. Omitted = 'off'.",
114
+ consumedBy:
115
+ "/assistant, /summary, /transcribe --then, /voice send and /voice --go (the tool results of a turn in progress); " +
116
+ "/dev-spec, /dev-change, /dev-plan, /dev-implement, /dev-verify and /dev-batches (the acts of their reviewer, roles and auditor)",
117
+ };
118
+
119
+ export const SKILLS_SUGGEST_DOC: ConfigKeyDoc = {
120
+ description:
121
+ "'on' lets the host's decision model add to a turn the skills of the project that fit its request, three at " +
122
+ "most, among .orkeon/skills/*.md and .claude/skills/*/SKILL.md, as reference material and never one kept for a " +
123
+ "person to invoke; the skills attached with /skills stay. Needs a " +
124
+ "decision provider on the host; without one none is suggested. Omitted = 'off'.",
125
+ consumedBy: "/skills suggest, /assistant, /summary, /transcribe --then, /voice send and /voice --go (the turn's attached skills)",
126
+ };
127
+
128
+ export const ROUTE_AGENTS_DOC: ConfigKeyDoc = {
129
+ description:
130
+ "'on' lets the host's decision model pick, at each launch of a crew, the cheapest profile of route.ladder that " +
131
+ "fits the command; never one above the session's llm.profile (without one, any rung), and the floors of " +
132
+ ".orkeon/route-rules.json apply. A rung the host does not declare leaves the session's profile. " +
133
+ "Needs a decision provider on the host; without one the session's profile stands. Omitted = 'off'.",
134
+ consumedBy: "/route, and the commands that launch a crew routed by it (/dev-spec, /dev-change, /dev-plan, /dev-learn, /review, /analyze, /commit, /init, /init-verifiers)",
135
+ };
136
+
137
+ export const ROUTE_LADDER_DOC: ConfigKeyDoc = {
138
+ description:
139
+ "The host's LLM profiles the routing picks among, cheapest first, separated by commas. Omitted = 'small,large', " +
140
+ "the two profiles of the example settings.",
141
+ consumedBy: "/route, and the commands route.agents routes",
142
+ };
143
+
144
+ export const COMPACTION_TRIGGER_DOC: ConfigKeyDoc = {
145
+ description:
146
+ "The token count at which the automatic compaction runs, e.g. '90000' or '90k'. Omitted = the " +
147
+ "context window minus the room one turn needs.",
148
+ consumedBy: "/assistant (the automatic compaction at the head and the tail of a turn), /usage",
149
+ };
150
+
151
+ export const DEV_WORK_DIR_DOC: ConfigKeyDoc = {
152
+ description:
153
+ "The work folder of the dev workflow, relative to the checkout, e.g. 'backstage/tasks'. Omitted = the " +
154
+ "repository pack's layout.work, else 'workbench'. A folder absent from the checkout falls back to 'workbench'.",
155
+ consumedBy: "/dev-status (the work folder it reads), /commit (the work folder it leaves out)",
156
+ };
157
+
158
+ export const DEV_PR_AUTO_DOC: ConfigKeyDoc = {
159
+ description:
160
+ "'true' asks /commit to open the pull request of a pushed branch, as --pr does: through the github tool when " +
161
+ "it is registered and the permission gate lets it, else the gh pr create command is printed. Omitted = 'false': " +
162
+ "the command is printed. Set in the user settings; a project file may only narrow it to 'false'.",
163
+ consumedBy: "/commit (the pull request of the branch)",
164
+ };
165
+
166
+ export const MEMORY_DIR_DOC: ConfigKeyDoc = {
167
+ description:
168
+ "The folder of the shared memory, relative to the project: its candidates, admitted entries and refused " +
169
+ "topics. Omitted = '.orkeon/memory'. Never the agent memory's '.orkeon/agent-memory'.",
170
+ consumedBy: "/memory-admit, /assistant (the memory_recall and memory_push tools)",
171
+ };
172
+
173
+ export const MEMORY_PROJECT_DOC: ConfigKeyDoc = {
174
+ description:
175
+ "The project name the shared memory's entries carry and its index is named after (memory-<project>), " +
176
+ "e.g. 'orkeon-code'. Omitted = the name of the origin remote, else 'local'.",
177
+ consumedBy: "/memory-admit, /assistant (the memory_recall and memory_push tools)",
178
+ };
179
+
180
+ export const MEMORY_AUTO_ADMIT_DOC: ConfigKeyDoc = {
181
+ description:
182
+ "'true' lets /memory-admit admit a candidate an audit verdict backs without asking. Omitted = 'false': " +
183
+ "every candidate is confirmed. A project file may set it to 'true' only when the user settings do.",
184
+ consumedBy: "/memory-admit",
185
+ };
186
+
187
+ export const PATHS_DENY_DOC: ConfigKeyDoc = {
188
+ description:
189
+ "Paths no tool of the model reads or writes, e.g. '/workspace/secrets, C:\\proj\\keys\\*, tests/fixtures/real': " +
190
+ "entries separated by commas, each a path of a mount in any spelling the host knows or a path under /workspace, " +
191
+ "'*' for any run of characters, a bare path covering what lies below it. Held on the canonical spelling, whatever " +
192
+ "spelling a call uses. The project file's entries add to the user's. Omitted = none.",
193
+ consumedBy: PATH_LISTS_CONSUMERS,
194
+ };
195
+
196
+ export const PATHS_ALLOW_DOC: ConfigKeyDoc = {
197
+ description:
198
+ "The only paths the tools of the model may reach, in the notation of paths.deny; a deny wins over it. " +
199
+ "A project file may only narrow the user's list: an entry outside it is dropped. Omitted = every path of the mounts.",
200
+ consumedBy: PATH_LISTS_CONSUMERS,
201
+ };
202
+
203
+ // ── Config keys: a project value set aside, a value refused ─────────────
204
+
205
+ export const PROJECT_FALLBACK_TOO_WIDE =
206
+ "a project file may set only default, plan or acceptEdits; another mode comes from the " +
207
+ "user settings (orkeonCode) or /mode";
208
+ export const widerThanUserFallback = (user: string): string =>
209
+ `it is wider than the user settings' '${user}' (orkeonCode); a project file may only narrow it`;
210
+ export const EXTRA_TOOLS_NOT_ALLOWED = "the user settings do not allow (orkeonCode tools.extra, or *)";
211
+ export const AUTO_ADMIT_FROM_USER =
212
+ "admitting without asking comes from the user settings (orkeonCode); a project file may only narrow it";
213
+ export const PR_AUTO_FROM_USER =
214
+ "opening a pull request without asking comes from the user settings (orkeonCode); a project file may only narrow it";
215
+ export const PATHS_ALLOW_OUTSIDE_USER =
216
+ "the user settings allow nothing there (orkeonCode paths.allow); a project file may only narrow it";
217
+
218
+ export const unknownConfigKey = (key: string, valid: readonly string[]): string =>
219
+ `unknown config key '${key}'. Valid keys: ${valid.join(", ")}`;
220
+ export const needsAValue = (key: string): string => `'${key}' needs a value.`;
221
+ export const notAllowedValue = (value: string, key: string, allowed: readonly string[]): string =>
222
+ `'${value}' is not valid for '${key}'. Allowed: ${allowed.join(", ")}`;
223
+ export const invalidValue = (value: string, key: string, problem: string): string =>
224
+ `'${value}' is not valid for '${key}': ${problem}`;
225
+
226
+ // ── Saved agents ────────────────────────────────────────────────────────
227
+
228
+ export const invalidAgentName = (name: string): string =>
229
+ `'${name}' is not a valid agent name (lowercase letters, digits and '-', starting with a letter)`;
230
+ export const agentNeedsRole = (name: string): string => `agent '${name}' needs a role`;
231
+ export const agentNeedsGoal = (name: string): string => `agent '${name}' needs a goal`;
232
+ export const DISCOVERED_IN_CREWS = "discovered in crews/ — read-only here";
233
+ export const shadowedByCrew = (role: string): string => `⚠ shadowed by the crew of the same name — never dispatched. ${role}`;
234
+
235
+ // ── Compaction outcome and trigger ──────────────────────────────────────
236
+
237
+ export const stateOfBatch = (path: string): string => `\nstate of the batch in progress: ${path}`;
238
+ export const noStateFileWrittenOnNewLine = (skipped: string): string => `\nno state file written: ${skipped}`;
239
+ export const BUFFER_TOO_SMALL_TO_COMPACT = "Buffer too small to compact.";
240
+ export const SNIPPED_INSTEAD = "\nThe buffer was snipped instead: the earlier turns were removed without a summary.";
241
+ export const A_TOKEN_COUNT = "a token count such as 90000 or 90k";
242
+
243
+ // ── The host layout (launch.json) ───────────────────────────────────────
244
+
245
+ export const LAUNCH_NOT_AN_OBJECT = "launch.json is not an object";
246
+ export const launchVersionIsNot = (version: string, expected: number | string): string =>
247
+ `launch.json version ${version} is not ${expected}`;
248
+ export const launchFlavourIsNot = (flavour: string): string => `launch.json flavour '${flavour}' is not posix, wsl or windows`;
249
+ export const LAUNCH_MOUNTS_NOT_AN_OBJECT = "launch.json mounts is not an object";
250
+ export const notAMountPoint = (virtual: string): string => `launch.json mount '${virtual}' is not a mount point`;
251
+ export const mountHasNoBases = (virtual: string): string => `launch.json mount '${virtual}' has no bases`;
252
+ export const posixBaseNotAbsolute = (virtual: string, base: string): string =>
253
+ `launch.json mount '${virtual}': posix base '${base}' is not an absolute path`;
254
+ export const windowsBaseNotADrive = (virtual: string, base: string): string =>
255
+ `launch.json mount '${virtual}': windows base '${base}' is not a drive or UNC path`;
256
+ export const mountNoUsableBase = (virtual: string): string => `launch.json mount '${virtual}' has no usable base`;
257
+ export const wslWhere = (distro: string, root: string): string => `wsl (${distro}, drives under ${root})`;
258
+ export const noMountBase = (where: string): string => `${where}, no mount base: every path as the runtime spells it`;
259
+
260
+ // ── The LLM profile, the model catalogue ────────────────────────────────
261
+
262
+ export const PROFILE_NAME_EXPECTED = "a profile name is expected";
263
+ export const profileHoldsSpace = (value: string): string =>
264
+ `'${value}' holds a space: a profile is one name, as the host's settings spell it`;
265
+ export const profileHoldsColon = (value: string): string => `'${value}' holds a colon: name the profile alone, not its settings path`;
266
+ export const modelNotDeclared = (name: string, models: string): string =>
267
+ `'${name}' is not among the models this host declares (${models}). ` +
268
+ "Setting it anyway — the list comes from Llm:AvailableModels in the settings and may be " +
269
+ "incomplete. If the provider does not serve it, the next turn fails with an API error.";
270
+
271
+ /** Why the list is empty — the two cases an operator can act on. */
272
+ export const NO_CATALOGUE_NOTE =
273
+ "no models declared. Add `\"AvailableModels\": [\"…\"]` to the `Llm` section of the settings " +
274
+ "file (or Llm__AvailableModels=a,b in the environment) and /model can offer the choice.";
275
+
276
+ // ── The fallback permission mode ────────────────────────────────────────
277
+
278
+ export const builtInFallback = (mode: string, key: string): string =>
279
+ `built-in default '${mode}' (asks on writes, like the original) — ` +
280
+ `set '${key}' to change it`;
281
+ export const fallbackNotAMode = (key: string, raw: string, mode: string, modes: string): string =>
282
+ `'${key}' is '${raw}', which is not a permission mode — ` +
283
+ `IGNORED, running the built-in '${mode}'. ` +
284
+ `Expected one of: ${modes}`;
285
+ export const SANDBOXED_POSTURE = " — sandboxed posture: the container/VFS is the security boundary, approvals never stall a session";
286
+
287
+ // ── Secret patterns, speech ─────────────────────────────────────────────
288
+
289
+ export const PRIVATE_KEY_BLOCK = "private key block";
290
+ export const AWS_ACCESS_KEY_ID = "AWS access key id";
291
+ export const REPLY_READ_ALOUD = "Reply read aloud";
@@ -0,0 +1,79 @@
1
+ // The declared model catalogue and what /model may say about it. Pure, no IO.
2
+ //
3
+ // `/model <name>` (B-10) hot-swaps the model for subsequent turns, and the swap
4
+ // travels over the SAME provider — so a name that provider does not serve is a
5
+ // 4xx on the next turn, one full turn later, with an error the operator has to
6
+ // go read in the log. The host now declares what it serves
7
+ // (`Llm:AvailableModels` → session metadata), so the mistake can be caught at
8
+ // the moment it is made.
9
+ //
10
+ // WARN, never refuse. The list is declarative: hand-written in a settings file,
11
+ // so it can lag behind the provider's catalogue. Refusing on it would block a
12
+ // model that works, which is a worse failure than the one being prevented — and
13
+ // silent for a different reason (the operator would think the model is gone).
14
+ // Same rule as `review.lenses`: an unrecognised entry is reported and the
15
+ // operation proceeds.
16
+ import { modelNotDeclared } from "./messages.ts";
17
+
18
+ /** Nothing declared. Means UNKNOWN — never "no model is available". */
19
+ export const NO_DECLARED_MODELS: readonly string[] = [];
20
+
21
+ /** Normalise the metadata array: strings only, trimmed, blanks and dupes out. */
22
+ export function normalizeModelList(raw: unknown): string[] {
23
+ if (!Array.isArray(raw)) return [];
24
+ const seen = new Set<string>();
25
+ const out: string[] = [];
26
+ for (const entry of raw) {
27
+ const name = String(entry ?? "").trim();
28
+ if (name.length === 0) continue;
29
+ const key = name.toLowerCase();
30
+ if (seen.has(key)) continue;
31
+ seen.add(key);
32
+ out.push(name);
33
+ }
34
+ return out;
35
+ }
36
+
37
+ /** Is `name` in the declared list? Case-insensitive, like the provider APIs. */
38
+ export function isDeclaredModel(models: readonly string[], name: unknown): boolean {
39
+ const n = String(name ?? "").trim().toLowerCase();
40
+ return n.length > 0 && models.some((m) => m.toLowerCase() === n);
41
+ }
42
+
43
+ export interface ModelChoiceVerdict {
44
+ /** Always true: an undeclared model is still applied (see the header). */
45
+ accepted: true;
46
+ /** Non-empty when the name is outside a non-empty declared list. */
47
+ warning: string;
48
+ }
49
+
50
+ /**
51
+ * The verdict for `/model <name>`.
52
+ *
53
+ * No declared list ⇒ no warning: we know nothing, and inventing a doubt would
54
+ * train the operator to ignore the message.
55
+ */
56
+ export function judgeModelChoice(models: readonly string[], name: string): ModelChoiceVerdict {
57
+ if (models.length === 0 || isDeclaredModel(models, name)) {
58
+ return { accepted: true, warning: "" };
59
+ }
60
+ return {
61
+ accepted: true,
62
+ warning: modelNotDeclared(name, models.join(", ")),
63
+ };
64
+ }
65
+
66
+ /**
67
+ * The catalogue as `/model list` shows it: declared order, the effective model
68
+ * marked. Returns "" when nothing is declared so the caller can say why.
69
+ */
70
+ export function renderModelList(
71
+ models: readonly string[],
72
+ effective: string,
73
+ ): string {
74
+ if (models.length === 0) return "";
75
+ const active = effective.trim().toLowerCase();
76
+ return models
77
+ .map((m) => ` ${m.toLowerCase() === active ? "*" : " "} ${m}`)
78
+ .join("\n");
79
+ }
@@ -0,0 +1,99 @@
1
+ // Canonical permission-mode list — pure, no IO. Single source shared by the
2
+ // /mode + /assistant commands (prefix parsing) and the main-loop crew (session
3
+ // default resolution). Mirrors the modes understood by the C# ModePermissionGate.
4
+ //
5
+ // Run tests: node --test src/shared/domain/permission-modes.test.ts
6
+ import { builtInFallback, fallbackNotAMode, SANDBOXED_POSTURE } from "./messages.ts";
7
+
8
+ // `dontAsk` (E-3): the 5th external mode of the original — denies every write
9
+ // fail-closed WITHOUT asking. Catalogue-wise it is read-only like `plan`; the
10
+ // C# gate additionally classifies unknown/never-ask modes fail-closed.
11
+ export const PERMISSION_MODES = ["default", "acceptEdits", "bypassPermissions", "plan", "dontAsk"] as const;
12
+ export type PermissionMode = (typeof PERMISSION_MODES)[number];
13
+
14
+ // ── Session fallback (B-2) ──────────────────────────────────────────────
15
+ // The mode that applies when neither the prompt ("mode:" prefix) nor /mode set
16
+ // one. It used to be the constant `bypassPermissions`, on a sandbox-as-boundary
17
+ // rationale (commit 238c20c) — the single most consequential declared deviation
18
+ // from the original, which runs `default` and asks on writes (baseline 08 §4).
19
+ //
20
+ // The point of B-2 is NOT to overrule that rationale. It is to stop it being a
21
+ // silent constant: an operator reading `/permissions` could not tell that their
22
+ // un-configured session was bypassing every approval, because nothing said so.
23
+ // So the default now matches the original, and the sandboxed posture is an
24
+ // explicit opt-in that names itself in the output.
25
+
26
+ /** Fallback with no configuration — matches the original (asks on writes). */
27
+ export const FALLBACK_PERMISSION_MODE = "default";
28
+
29
+ /** Fallback selected by the opt-in config key; the pre-B-2 behaviour. */
30
+ export const SANDBOX_FALLBACK_PERMISSION_MODE = "bypassPermissions";
31
+
32
+ /** `/config permissions.fallback <mode>` — the opt-in key, read from the config map. */
33
+ export const PERMISSION_FALLBACK_CONFIG_KEY = "permissions.fallback";
34
+
35
+ /** Where the effective fallback came from. Reported by /permissions. */
36
+ export type FallbackSource = "built-in" | "config" | "config-invalid";
37
+
38
+ export interface FallbackResolution {
39
+ /** The mode to apply. Always a valid permission mode. */
40
+ mode: string;
41
+ source: FallbackSource;
42
+ /** One line naming the source — what /permissions prints. */
43
+ explanation: string;
44
+ /** The rejected value, when `source` is "config-invalid". */
45
+ rejected?: string;
46
+ }
47
+
48
+ /**
49
+ * Resolves the session fallback from the configured value. PURE — the caller
50
+ * reads the config map and passes what it found.
51
+ *
52
+ * A configured value that is not a permission mode is NOT silently ignored:
53
+ * that is how an operator ends up believing they tightened a session they did
54
+ * not. It resolves to the built-in and says the value was rejected.
55
+ */
56
+ export function resolveFallbackMode(configured: unknown): FallbackResolution {
57
+ const raw = typeof configured === "string" ? configured.trim() : "";
58
+ if (raw.length === 0) {
59
+ return {
60
+ mode: FALLBACK_PERMISSION_MODE,
61
+ source: "built-in",
62
+ explanation: builtInFallback(FALLBACK_PERMISSION_MODE, PERMISSION_FALLBACK_CONFIG_KEY),
63
+ };
64
+ }
65
+ if (!isPermissionMode(raw)) {
66
+ return {
67
+ mode: FALLBACK_PERMISSION_MODE,
68
+ source: "config-invalid",
69
+ rejected: raw,
70
+ explanation: fallbackNotAMode(PERMISSION_FALLBACK_CONFIG_KEY, raw, FALLBACK_PERMISSION_MODE, PERMISSION_MODES.join(", ")),
71
+ };
72
+ }
73
+ return {
74
+ mode: raw,
75
+ source: "config",
76
+ explanation:
77
+ `'${PERMISSION_FALLBACK_CONFIG_KEY}' = '${raw}'` +
78
+ (raw === SANDBOX_FALLBACK_PERMISSION_MODE
79
+ ? SANDBOXED_POSTURE
80
+ : ""),
81
+ };
82
+ }
83
+
84
+ /** True when the token is one of the known permission modes (case-sensitive). */
85
+ export function isPermissionMode(token: unknown): boolean {
86
+ return PERMISSION_MODES.includes(String(token ?? "") as any);
87
+ }
88
+
89
+ // ── Mode-transition state machine (E-12) ────────────────────────────────
90
+ // Cycle order mirrors the original's Shift+Tab rotation (baseline 08
91
+ // §Modes and transitions). `dontAsk` is reachable only by explicit
92
+ // `/mode dontAsk` — the original excludes it from the cycle too.
93
+ export const MODE_CYCLE = ["default", "acceptEdits", "plan", "bypassPermissions"] as const;
94
+
95
+ /** The next mode in the cycle; unknown/off-cycle modes re-enter at "default". */
96
+ export function getNextPermissionMode(current: string): string {
97
+ const idx = MODE_CYCLE.indexOf(current as any);
98
+ return idx < 0 ? "default" : MODE_CYCLE[(idx + 1) % MODE_CYCLE.length];
99
+ }
@@ -0,0 +1,92 @@
1
+ // A prelude: one tool call a command asks a crew to make before its own work.
2
+ // /transcribe hands the crews a speech-to-text call this way: the crew makes it
3
+ // as the command's call (the user typed the command, so the gate does not ask),
4
+ // where a call may last minutes, which a command's handler cannot (the engine
5
+ // bounds the promise it awaits at 10 s). Pure: the shape of the input, the error
6
+ // a failed call becomes, and the request the model reads once the call answered.
7
+ // The text of a tool result is the adapter's (ToolCatalogue.callText): the domain
8
+ // never reads the runtime's shapes.
9
+ import { withPreludeText } from "./prompts.ts";
10
+
11
+ /** The call: the registered tool name, its arguments, and what to call its result.
12
+ * `as: "request"` makes the result the request itself (/voice --go dictates it);
13
+ * otherwise the result follows the request under its label. */
14
+ export interface PreludeCall {
15
+ tool: string;
16
+ args: Record<string, unknown>;
17
+ label: string;
18
+ as?: "request";
19
+ }
20
+
21
+ /** What a tool that answered no text is reported as. */
22
+ export function nothingReturned(tool: string): string {
23
+ return `${tool} returned nothing`;
24
+ }
25
+
26
+ /** The prelude of a crew input; null when there is none or it names no tool.
27
+ * Arguments that are not an object count as none; a blank label is the tool's name. */
28
+ export function parsePrelude(value: unknown): PreludeCall | null {
29
+ if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
30
+ const fields = value as Record<string, unknown>;
31
+ const tool = typeof fields.tool === "string" ? fields.tool.trim() : "";
32
+ if (tool.length === 0) return null;
33
+ const args = fields.args !== null && typeof fields.args === "object" && !Array.isArray(fields.args)
34
+ ? (fields.args as Record<string, unknown>)
35
+ : {};
36
+ const label = typeof fields.label === "string" && fields.label.trim().length > 0 ? fields.label.trim() : tool;
37
+ return fields.as === "request" ? { tool, args, label, as: "request" } : { tool, args, label };
38
+ }
39
+
40
+ /** A call a command asks a crew to make after its work, with the answer, before the
41
+ * work returns: the answer shows once the call is done (speak returns as soon as the
42
+ * audio is synthesized, and plays it in the background), and a failure never fails
43
+ * the work. voice.reply hands the main loop speak this way: `args` plus the answer
44
+ * under `textArg`. */
45
+ export interface EpilogueCall {
46
+ tool: string;
47
+ args: Record<string, unknown>;
48
+ textArg: string;
49
+ label: string;
50
+ }
51
+
52
+ /** The epilogue of a crew input; null when there is none or it names no tool. A blank
53
+ * `textArg` is "text", a blank label the tool's name. */
54
+ export function parseEpilogue(value: unknown): EpilogueCall | null {
55
+ const call = parsePrelude(value);
56
+ if (call === null) return null;
57
+ const fields = value as Record<string, unknown>;
58
+ const textArg = typeof fields.textArg === "string" && fields.textArg.trim().length > 0 ? fields.textArg.trim() : "text";
59
+ return { tool: call.tool, args: call.args, textArg, label: call.label };
60
+ }
61
+
62
+ /** The arguments of the epilogue's call: its own, and the answer under `textArg`. */
63
+ export function epilogueArgs(epilogue: EpilogueCall, answer: string): Record<string, unknown> {
64
+ return { ...epilogue.args, [epilogue.textArg]: answer };
65
+ }
66
+
67
+ /** The error a failed call becomes: named after the tool, so the run's failure
68
+ * reads "<tool>: <the tool's message>", the way an LlmFailure reads. */
69
+ export function toolFailure(tool: string, failure: string): Error {
70
+ const error = new Error(failure);
71
+ error.name = tool;
72
+ return error;
73
+ }
74
+
75
+ /** An error as one line to show: its message (or the value itself), first line, trimmed. */
76
+ export function errorText(error: unknown): string {
77
+ return (error instanceof Error ? error.message : String(error)).trim().split("\n")[0].trim();
78
+ }
79
+
80
+ /** The request the model reads: the user's request, then the prelude's result under its label. */
81
+ export function withPrelude(request: string, label: string, text: string): string {
82
+ // Between tags, as material: an instruction spoken in a recording is content to
83
+ // work on, not a request from the user who typed the command.
84
+ return withPreludeText(request.trim(), label, text.trim());
85
+ }
86
+
87
+ /** The request once the prelude answered: its text itself for `as: "request"` (after the
88
+ * request typed, if any), else the request followed by the text under the label. */
89
+ export function applyPrelude(request: string, prelude: PreludeCall, text: string): string {
90
+ if (prelude.as === "request") return [request.trim(), text.trim()].filter((part) => part.length > 0).join("\n\n");
91
+ return withPrelude(request, prelude.label, text);
92
+ }