orkeon-code 1.0.0-rc.1 → 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 (440) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +206 -11
  13. package/orkeon-code.ps1 +109 -7
  14. package/package.json +2 -1
  15. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  16. package/src/commands/_lib/args.ts +5 -4
  17. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  18. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  19. package/src/commands/_lib/dev/dev-source.ts +7 -11
  20. package/src/commands/_lib/dev/dev.ts +34 -37
  21. package/src/commands/_lib/dev/markers.ts +7 -0
  22. package/src/commands/_lib/dev/messages.ts +112 -0
  23. package/src/commands/_lib/dev-step.ts +16 -13
  24. package/src/commands/_lib/dispatch.ts +62 -39
  25. package/src/commands/_lib/git/branch.ts +9 -10
  26. package/src/commands/_lib/git/commit.ts +9 -13
  27. package/src/commands/_lib/git/diff.ts +22 -12
  28. package/src/commands/_lib/git/messages.ts +54 -0
  29. package/src/commands/_lib/git/review.ts +9 -10
  30. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  31. package/src/commands/_lib/memory/memory.ts +3 -2
  32. package/src/commands/_lib/memory/messages.ts +32 -0
  33. package/src/commands/_lib/messages.ts +48 -0
  34. package/src/commands/_lib/project/messages.ts +8 -0
  35. package/src/commands/_lib/session/export.ts +3 -2
  36. package/src/commands/_lib/session/messages.ts +87 -0
  37. package/src/commands/_lib/session/prompts.ts +4 -0
  38. package/src/commands/_lib/session/resume.ts +15 -24
  39. package/src/commands/_lib/session/tasks.ts +20 -23
  40. package/src/commands/_lib/settings/advisor.ts +11 -16
  41. package/src/commands/_lib/settings/agents.ts +18 -28
  42. package/src/commands/_lib/settings/choices.ts +8 -0
  43. package/src/commands/_lib/settings/config.ts +43 -43
  44. package/src/commands/_lib/settings/effort.ts +147 -0
  45. package/src/commands/_lib/settings/hooks.ts +12 -20
  46. package/src/commands/_lib/settings/messages.ts +408 -0
  47. package/src/commands/_lib/settings/mode.ts +33 -24
  48. package/src/commands/_lib/settings/model.ts +71 -36
  49. package/src/commands/_lib/settings/output-style.ts +39 -0
  50. package/src/commands/_lib/settings/permissions.ts +71 -93
  51. package/src/commands/_lib/settings/route.ts +63 -0
  52. package/src/commands/_lib/settings/skills.ts +53 -11
  53. package/src/commands/_lib/settings/theme.ts +42 -0
  54. package/src/commands/_lib/speech/messages.ts +58 -0
  55. package/src/commands/_lib/speech/prompts.ts +4 -0
  56. package/src/commands/_lib/speech/say.ts +9 -10
  57. package/src/commands/_lib/speech/transcribe.ts +14 -23
  58. package/src/commands/_lib/speech/voice.ts +14 -18
  59. package/src/commands/_lib/status/doctor.ts +47 -28
  60. package/src/commands/_lib/status/messages.ts +100 -0
  61. package/src/commands/_lib/status/meta.ts +3 -24
  62. package/src/commands/_lib/status/status.ts +10 -11
  63. package/src/commands/_lib/status/usage-tools.ts +2 -3
  64. package/src/commands/_lib/status/usage.ts +7 -18
  65. package/src/commands/_lib/view.ts +6 -1
  66. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  67. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  68. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  69. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  70. package/src/commands/git/commit.cmd.ts +3 -3
  71. package/src/commands/git/review.cmd.ts +3 -3
  72. package/src/commands/memory/memory.cmd.ts +2 -2
  73. package/src/commands/project/analyze.cmd.ts +3 -3
  74. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  75. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  76. package/src/commands/project/init.cmd.ts +3 -3
  77. package/src/commands/project/verify.cmd.ts +2 -2
  78. package/src/commands/session/assistant.cmd.ts +2 -2
  79. package/src/commands/session/compact.cmd.ts +1 -1
  80. package/src/commands/session/copy.cmd.ts +8 -7
  81. package/src/commands/session/rename.cmd.ts +3 -2
  82. package/src/commands/session/rewind.cmd.ts +3 -4
  83. package/src/commands/session/summary.cmd.ts +3 -3
  84. package/src/commands/session/tasks.cmd.ts +4 -2
  85. package/src/commands/settings/config.cmd.ts +4 -2
  86. package/src/commands/settings/effort.cmd.ts +10 -31
  87. package/src/commands/settings/fast.cmd.ts +2 -1
  88. package/src/commands/settings/mode.cmd.ts +3 -3
  89. package/src/commands/settings/model.cmd.ts +3 -2
  90. package/src/commands/settings/output-style.cmd.ts +9 -38
  91. package/src/commands/settings/permissions.cmd.ts +2 -2
  92. package/src/commands/settings/proactive.cmd.ts +2 -1
  93. package/src/commands/settings/route.cmd.ts +16 -0
  94. package/src/commands/settings/skills.cmd.ts +3 -3
  95. package/src/commands/settings/theme.cmd.ts +14 -0
  96. package/src/commands/speech/say.cmd.ts +2 -2
  97. package/src/commands/speech/transcribe.cmd.ts +2 -2
  98. package/src/commands/status/release-notes.cmd.ts +1 -1
  99. package/src/crews/.orkeon/orkeon.d.ts +538 -93
  100. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  101. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  102. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  103. package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
  104. package/src/crews/advisor/application/messages.ts +4 -0
  105. package/src/crews/advisor/application/prompts.ts +4 -0
  106. package/src/crews/advisor/application/run-advisor.ts +2 -1
  107. package/src/crews/advisor/crew.ork.ts +5 -4
  108. package/src/crews/advisor/domain/advice.ts +7 -23
  109. package/src/crews/advisor/domain/messages.ts +8 -0
  110. package/src/crews/advisor/domain/prompts.ts +26 -0
  111. package/src/crews/agent-run/application/messages.ts +18 -0
  112. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  113. package/src/crews/agent-run/crew.ork.ts +3 -3
  114. package/src/crews/analyze/application/messages.ts +27 -0
  115. package/src/crews/analyze/application/prompts.ts +4 -0
  116. package/src/crews/analyze/application/run-analyze.ts +16 -14
  117. package/src/crews/analyze/crew.ork.ts +5 -4
  118. package/src/crews/analyze/domain/harvest.ts +33 -65
  119. package/src/crews/analyze/domain/prompts.ts +86 -0
  120. package/src/crews/code-review/application/lens-material.ts +24 -0
  121. package/src/crews/code-review/application/messages.ts +17 -0
  122. package/src/crews/code-review/application/prompts.ts +10 -17
  123. package/src/crews/code-review/application/review.ts +4 -1
  124. package/src/crews/code-review/application/run-code-review.ts +13 -15
  125. package/src/crews/code-review/crew.ork.ts +5 -4
  126. package/src/crews/code-review/domain/lenses.ts +6 -45
  127. package/src/crews/code-review/domain/messages.ts +25 -0
  128. package/src/crews/code-review/domain/prompts.ts +58 -0
  129. package/src/crews/code-review/domain/report.ts +5 -6
  130. package/src/crews/code-review/domain/scope.ts +6 -12
  131. package/src/crews/dev-batches/application/messages.ts +127 -0
  132. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  133. package/src/crews/dev-batches/application/prompts.ts +10 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  135. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  136. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  137. package/src/crews/dev-batches/crew.ork.ts +12 -9
  138. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  139. package/src/crews/dev-batches/domain/markers.ts +5 -0
  140. package/src/crews/dev-batches/domain/messages.ts +6 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  142. package/src/crews/dev-change/application/change-material.ts +44 -0
  143. package/src/crews/dev-change/application/evidence.ts +25 -22
  144. package/src/crews/dev-change/application/messages.ts +81 -0
  145. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  146. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  147. package/src/crews/dev-change/crew.ork.ts +11 -9
  148. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  149. package/src/crews/dev-change/domain/change-render.ts +13 -15
  150. package/src/crews/dev-change/domain/markers.ts +28 -0
  151. package/src/crews/dev-change/domain/messages.ts +16 -0
  152. package/src/crews/dev-implement/application/close.ts +21 -18
  153. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  154. package/src/crews/dev-implement/application/messages.ts +161 -0
  155. package/src/crews/dev-implement/application/observe.ts +4 -2
  156. package/src/crews/dev-implement/application/prompts.ts +9 -0
  157. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  158. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  159. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  160. package/src/crews/dev-implement/crew.ork.ts +2 -1
  161. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  162. package/src/crews/dev-implement/domain/correction.ts +16 -15
  163. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  164. package/src/crews/dev-implement/domain/markers.ts +23 -0
  165. package/src/crews/dev-implement/domain/messages.ts +58 -0
  166. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  167. package/src/crews/dev-implement/domain/roles.ts +3 -7
  168. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  169. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  170. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  171. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  172. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  173. package/src/crews/dev-learn/application/messages.ts +51 -0
  174. package/src/crews/dev-learn/application/{learn-prompt.ts → prompts.ts} +24 -65
  175. package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
  176. package/src/crews/dev-learn/crew.ork.ts +4 -3
  177. package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
  178. package/src/crews/dev-learn/domain/messages.ts +65 -0
  179. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  180. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  181. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  182. package/src/crews/dev-plan/application/inventory.ts +17 -13
  183. package/src/crews/dev-plan/application/messages.ts +88 -0
  184. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  185. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  186. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  187. package/src/crews/dev-plan/crew.ork.ts +11 -8
  188. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  189. package/src/crews/dev-plan/domain/markers.ts +18 -0
  190. package/src/crews/dev-plan/domain/messages.ts +118 -0
  191. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  192. package/src/crews/dev-plan/domain/plan-render.ts +30 -31
  193. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  194. package/src/crews/dev-spec/application/messages.ts +30 -0
  195. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  196. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  197. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  198. package/src/crews/dev-spec/crew.ork.ts +11 -9
  199. package/src/crews/dev-spec/domain/markers.ts +30 -0
  200. package/src/crews/dev-spec/domain/messages.ts +39 -0
  201. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  202. package/src/crews/dev-spec/domain/spec-render.ts +18 -18
  203. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  204. package/src/crews/dev-verify/application/audit.ts +38 -30
  205. package/src/crews/dev-verify/application/capture.ts +34 -26
  206. package/src/crews/dev-verify/application/messages.ts +119 -0
  207. package/src/crews/dev-verify/application/prompts.ts +209 -0
  208. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  209. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  210. package/src/crews/dev-verify/crew.ork.ts +6 -6
  211. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  212. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  213. package/src/crews/dev-verify/domain/commands.ts +3 -3
  214. package/src/crews/dev-verify/domain/gate.ts +21 -16
  215. package/src/crews/dev-verify/domain/markers.ts +16 -0
  216. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  217. package/src/crews/dev-verify/domain/messages.ts +92 -0
  218. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  219. package/src/crews/git-commit/application/draft.ts +16 -37
  220. package/src/crews/git-commit/application/messages.ts +15 -0
  221. package/src/crews/git-commit/application/prompts.ts +47 -0
  222. package/src/crews/git-commit/application/run-git-commit.ts +13 -12
  223. package/src/crews/git-commit/crew.ork.ts +5 -4
  224. package/src/crews/git-commit/domain/commit.ts +15 -35
  225. package/src/crews/git-commit/domain/markers.ts +4 -0
  226. package/src/crews/git-commit/domain/messages.ts +48 -0
  227. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  228. package/src/crews/init-verifiers/application/messages.ts +13 -0
  229. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  230. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  231. package/src/crews/init-verifiers/crew.ork.ts +5 -4
  232. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  233. package/src/crews/main-loop/application/messages.ts +81 -0
  234. package/src/crews/main-loop/application/prompts.ts +12 -0
  235. package/src/crews/main-loop/application/run-main-loop.ts +63 -30
  236. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  237. package/src/crews/main-loop/crew.ork.ts +12 -7
  238. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  239. package/src/crews/main-loop/domain/prompts.ts +336 -0
  240. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  241. package/src/crews/project-init/application/detect.ts +5 -4
  242. package/src/crews/project-init/application/messages.ts +15 -0
  243. package/src/crews/project-init/application/prompts.ts +11 -7
  244. package/src/crews/project-init/crew.ork.ts +5 -4
  245. package/src/crews/project-init/domain/existing-files.ts +6 -4
  246. package/src/crews/project-init/domain/messages.ts +13 -0
  247. package/src/crews/project-init/domain/package-map.ts +3 -3
  248. package/src/crews/project-init/domain/prompts.ts +10 -0
  249. package/src/crews/session-compact/application/prompts.ts +5 -0
  250. package/src/crews/session-compact/crew.ork.ts +5 -4
  251. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  252. package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
  253. package/src/crews/speech/application/messages.ts +3 -0
  254. package/src/crews/speech/application/prompts.ts +3 -0
  255. package/src/crews/speech/application/run-speech.ts +2 -1
  256. package/src/crews/speech/crew.ork.ts +2 -1
  257. package/src/shared/application/agents/child-agent.ts +11 -7
  258. package/src/shared/application/agents/messages.ts +35 -0
  259. package/src/shared/application/agents/route-agent.ts +115 -0
  260. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  261. package/src/shared/application/compaction/compact-session.ts +19 -14
  262. package/src/shared/application/compaction/messages.ts +20 -0
  263. package/src/shared/application/compaction/prune-context.ts +94 -0
  264. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  265. package/src/shared/application/dev/brief-inventory.ts +6 -4
  266. package/src/shared/application/dev/close-batch.ts +9 -7
  267. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  268. package/src/shared/application/dev/learn-decision.ts +20 -18
  269. package/src/shared/application/dev/load-dev-context.ts +7 -8
  270. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  271. package/src/shared/application/dev/messages.ts +132 -0
  272. package/src/shared/application/dev/phase-timer.ts +54 -0
  273. package/src/shared/application/dev/plan-source.ts +12 -8
  274. package/src/shared/application/dev/preflight.ts +8 -8
  275. package/src/shared/application/dev/prompts.ts +34 -0
  276. package/src/shared/application/dev/question-round.ts +25 -17
  277. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  278. package/src/shared/application/dev/settle-questions.ts +4 -2
  279. package/src/shared/application/dev/source-review.ts +12 -8
  280. package/src/shared/application/dev/source-step.ts +12 -10
  281. package/src/shared/application/dev/spend.ts +17 -4
  282. package/src/shared/application/dev/step-precedents.ts +2 -1
  283. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  284. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  285. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  286. package/src/shared/application/dev/verdict-sources.ts +5 -3
  287. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  288. package/src/shared/application/extra-tools.ts +2 -1
  289. package/src/shared/application/git/batch-worktree.ts +22 -17
  290. package/src/shared/application/git/commit-files.ts +24 -19
  291. package/src/shared/application/git/merge-batch.ts +11 -7
  292. package/src/shared/application/git/messages.ts +75 -0
  293. package/src/shared/application/git/open-pull-request.ts +4 -3
  294. package/src/shared/application/host-context.ts +59 -0
  295. package/src/shared/application/host-layout-store.ts +45 -0
  296. package/src/shared/application/llm-profile.ts +4 -3
  297. package/src/shared/application/messages.ts +14 -0
  298. package/src/shared/application/permission-rules.ts +10 -0
  299. package/src/shared/application/ports/decision.ts +14 -0
  300. package/src/shared/application/ports/human.ts +25 -0
  301. package/src/shared/application/ports/llm.ts +32 -3
  302. package/src/shared/application/ports/memory.ts +1 -1
  303. package/src/shared/application/ports/theme.ts +11 -0
  304. package/src/shared/application/ports.ts +4 -2
  305. package/src/shared/application/session-io.ts +2 -1
  306. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  307. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  308. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  309. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  310. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  311. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  312. package/src/shared/application/shared-memory/messages.ts +63 -0
  313. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  314. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  315. package/src/shared/application/skills/messages.ts +4 -0
  316. package/src/shared/application/skills/suggest-skills.ts +102 -0
  317. package/src/shared/application/workflow/messages.ts +8 -0
  318. package/src/shared/application/workflow/workflow-state.ts +7 -6
  319. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  320. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  321. package/src/shared/domain/agent-policy/messages.ts +66 -0
  322. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  323. package/src/shared/domain/agent-policy/permission.ts +20 -18
  324. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  325. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  326. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  327. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  328. package/src/shared/domain/agent-registry.ts +6 -5
  329. package/src/shared/domain/agents/chain.ts +2 -2
  330. package/src/shared/domain/agents/charter.ts +8 -5
  331. package/src/shared/domain/agents/exclusive.ts +2 -1
  332. package/src/shared/domain/agents/instances.ts +18 -15
  333. package/src/shared/domain/agents/messages.ts +39 -0
  334. package/src/shared/domain/agents/model-route.ts +199 -0
  335. package/src/shared/domain/agents/prompts.ts +20 -0
  336. package/src/shared/domain/code-intel-contract.ts +5 -4
  337. package/src/shared/domain/code-intel-routing.ts +8 -61
  338. package/src/shared/domain/compact-outcome.ts +5 -3
  339. package/src/shared/domain/compaction-thresholds.ts +2 -1
  340. package/src/shared/domain/compaction.ts +22 -113
  341. package/src/shared/domain/config-schema.ts +94 -81
  342. package/src/shared/domain/context-prune.ts +176 -0
  343. package/src/shared/domain/decision/questions.ts +102 -0
  344. package/src/shared/domain/dev/access-cost.ts +19 -15
  345. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  346. package/src/shared/domain/dev/build-commands.ts +5 -4
  347. package/src/shared/domain/dev/call-guard.ts +29 -28
  348. package/src/shared/domain/dev/carried-text.ts +3 -5
  349. package/src/shared/domain/dev/learn-proposals.ts +5 -4
  350. package/src/shared/domain/dev/learn-state.ts +3 -2
  351. package/src/shared/domain/dev/markers.ts +107 -0
  352. package/src/shared/domain/dev/messages.ts +259 -0
  353. package/src/shared/domain/dev/phase-timing.ts +50 -0
  354. package/src/shared/domain/dev/plan-checks.ts +24 -23
  355. package/src/shared/domain/dev/plan-format.ts +14 -24
  356. package/src/shared/domain/dev/project-files.ts +1 -15
  357. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  358. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  359. package/src/shared/domain/dev/questions.ts +33 -15
  360. package/src/shared/domain/dev/repo-pack.ts +12 -9
  361. package/src/shared/domain/dev/review-answer.ts +40 -17
  362. package/src/shared/domain/dev/review-brief.ts +54 -0
  363. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  364. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  365. package/src/shared/domain/dev/spec-format.ts +13 -14
  366. package/src/shared/domain/dev/step-budget.ts +4 -2
  367. package/src/shared/domain/dev/step-rules.ts +3 -4
  368. package/src/shared/domain/dev/test-commands.ts +14 -10
  369. package/src/shared/domain/dev/tool-guards.ts +4 -3
  370. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  371. package/src/shared/domain/dev/verdict-format.ts +14 -21
  372. package/src/shared/domain/dev/whitespace.ts +3 -2
  373. package/src/shared/domain/dev/work-folder.ts +4 -3
  374. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  375. package/src/shared/domain/error-text.ts +13 -0
  376. package/src/shared/domain/git/close.ts +5 -4
  377. package/src/shared/domain/git/messages.ts +20 -0
  378. package/src/shared/domain/git/pull-request.ts +5 -5
  379. package/src/shared/domain/host-layout.ts +147 -0
  380. package/src/shared/domain/host-paths.ts +399 -0
  381. package/src/shared/domain/llm-failure.ts +35 -7
  382. package/src/shared/domain/llm-profile.ts +22 -3
  383. package/src/shared/domain/marked-message.ts +1 -5
  384. package/src/shared/domain/markers.ts +30 -0
  385. package/src/shared/domain/messages.ts +291 -0
  386. package/src/shared/domain/model-catalog.ts +2 -9
  387. package/src/shared/domain/permission-modes.ts +4 -8
  388. package/src/shared/domain/prelude.ts +2 -2
  389. package/src/shared/domain/project-manifests.ts +3 -2
  390. package/src/shared/domain/prompts.ts +233 -0
  391. package/src/shared/domain/search-routing.ts +3 -11
  392. package/src/shared/domain/secret-patterns.ts +3 -2
  393. package/src/shared/domain/session-keys.ts +7 -0
  394. package/src/shared/domain/session-start.ts +3 -2
  395. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  396. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  397. package/src/shared/domain/shared-memory/entry.ts +26 -20
  398. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  399. package/src/shared/domain/shared-memory/gate.ts +4 -3
  400. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  401. package/src/shared/domain/shared-memory/layout.ts +11 -8
  402. package/src/shared/domain/shared-memory/markers.ts +9 -0
  403. package/src/shared/domain/shared-memory/messages.ts +66 -0
  404. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  405. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  406. package/src/shared/domain/shared-memory/refused.ts +3 -3
  407. package/src/shared/domain/skills/prompts.ts +4 -0
  408. package/src/shared/domain/skills/shortlist.ts +149 -0
  409. package/src/shared/domain/snip-turns.ts +2 -14
  410. package/src/shared/domain/speech.ts +2 -1
  411. package/src/shared/domain/tool-trace.ts +5 -7
  412. package/src/shared/domain/verifiers.ts +7 -11
  413. package/src/shared/domain/vfs.ts +8 -1
  414. package/src/shared/domain/workflow/prompts.ts +15 -0
  415. package/src/shared/domain/workflow/state-file.ts +14 -12
  416. package/src/shared/infrastructure/globals.ts +7 -2
  417. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  418. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  419. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  420. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  421. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  422. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  423. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  424. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  425. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  426. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  427. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  428. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  429. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  430. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  431. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  432. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  433. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  434. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  435. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  436. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  437. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  438. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  439. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  440. package/src/shared/domain/session-summary.ts +0 -13
@@ -0,0 +1,102 @@
1
+ // The skills suggested for one turn (ADR 0027): with `skills.suggest` on and a decision model on the host, the
2
+ // project's skill files are listed, the model is told of each by one line, and the few that fit the request are read
3
+ // and handed to the turn, apart from the ones a person attached: the turn reads them as reference material the
4
+ // operator did not choose. A skill kept for a person to invoke is never offered. It fails open at every step: the setting off or
5
+ // unreadable, no decision model, no skill folder, a model that does not answer suggest nothing. What was suggested
6
+ // is logged and kept in the session for `/skills suggest why`.
7
+ import type { DecisionModel, Files, Logger, SessionStore } from "../ports.ts";
8
+ import type { ConfigStore } from "../config-store.ts";
9
+ import type { AttachedSkill } from "../attached-skills.ts";
10
+ import { WORKSPACE } from "../../domain/vfs.ts";
11
+ import { SKILLS_SUGGESTED_STATE_KEY } from "../../domain/session-keys.ts";
12
+ import type { DecisionAnswers } from "../../domain/decision/questions.ts";
13
+ import type { SkillCard, SkillPick } from "../../domain/skills/shortlist.ts";
14
+ import {
15
+ CLAUDE_SKILLS_DIR, CLAUDE_SKILL_FILE, ORKEON_SKILLS_DIR, SKILL_HEAD_CHARS, SKILLS_LISTING_MAX, SKILLS_SUGGEST_CONFIG_KEY,
16
+ SUGGEST_MAX_CANDIDATES, offerable, shortlistOf, shortlistQuestion, skillCard, skillKey, suggestOn, suggestState,
17
+ } from "../../domain/skills/shortlist.ts";
18
+ import { SUGGEST_WITHOUT_DECISION_MODEL, skillsSuggested } from "./messages.ts";
19
+
20
+ export interface SuggestDeps {
21
+ config: Pick<ConfigStore, "readValue">;
22
+ decision: DecisionModel;
23
+ files: Pick<Files, "read" | "list">;
24
+ session: Pick<SessionStore, "writeState">;
25
+ log: Pick<Logger, "info" | "warn">;
26
+ }
27
+
28
+ async function settingOn(config: SuggestDeps["config"]): Promise<boolean> {
29
+ try {
30
+ return suggestOn((await config.readValue(SKILLS_SUGGEST_CONFIG_KEY)).value);
31
+ } catch {
32
+ return false;
33
+ }
34
+ }
35
+
36
+ async function entries(files: SuggestDeps["files"], dir: string): Promise<string[]> {
37
+ try {
38
+ return [...await files.list(dir, SKILLS_LISTING_MAX)].map((name) => name.replace(/\/+$/, "")).sort();
39
+ } catch {
40
+ return [];
41
+ }
42
+ }
43
+
44
+ /** The skill files of the project, the project's own first, each folder in name order, SUGGEST_MAX_CANDIDATES at most. */
45
+ async function skillPaths(files: SuggestDeps["files"]): Promise<string[]> {
46
+ const own = (await entries(files, `${WORKSPACE}/${ORKEON_SKILLS_DIR}`))
47
+ .filter((name) => /\.md$/i.test(name))
48
+ .map((name) => `${WORKSPACE}/${ORKEON_SKILLS_DIR}/${name}`);
49
+ // A folder per skill: an entry that ends like a file (README.md, notes.txt) is none.
50
+ const others = (await entries(files, `${WORKSPACE}/${CLAUDE_SKILLS_DIR}`))
51
+ .filter((name) => !/\.[A-Za-z0-9]{1,5}$/.test(name))
52
+ .map((name) => `${WORKSPACE}/${CLAUDE_SKILLS_DIR}/${name}/${CLAUDE_SKILL_FILE}`);
53
+ return [...own, ...others].slice(0, SUGGEST_MAX_CANDIDATES);
54
+ }
55
+
56
+ /** The card of each skill file that can be read, is not blank and may be offered to a model. */
57
+ async function cards(files: SuggestDeps["files"], paths: readonly string[]): Promise<SkillCard[]> {
58
+ const read = await Promise.all(paths.map(async (path) => {
59
+ try {
60
+ const head = await files.read(path, SKILL_HEAD_CHARS);
61
+ return head.trim().length === 0 || !offerable(head) ? null : skillCard(path, head);
62
+ } catch {
63
+ return null;
64
+ }
65
+ }));
66
+ return read.filter((card): card is SkillCard => card !== null);
67
+ }
68
+
69
+ async function contents(files: SuggestDeps["files"], picks: readonly SkillPick[]): Promise<AttachedSkill[]> {
70
+ const out: AttachedSkill[] = [];
71
+ for (const pick of picks) {
72
+ try {
73
+ const content = await files.read(pick.path);
74
+ if (content.trim().length > 0) out.push({ path: pick.path, content });
75
+ } catch { /* a skill gone since its card was read is left out */ }
76
+ }
77
+ return out;
78
+ }
79
+
80
+ /** The skills suggested for `request`, those of `attached` (paths a person attached) left out. */
81
+ export async function suggestSkills(deps: SuggestDeps, request: string, attached: readonly string[]): Promise<AttachedSkill[]> {
82
+ if (!await settingOn(deps.config)) return [];
83
+ if (!deps.decision.available()) {
84
+ deps.log.warn(SUGGEST_WITHOUT_DECISION_MODEL);
85
+ return [];
86
+ }
87
+ const held = new Set(attached.map(skillKey));
88
+ const offered = (await cards(deps.files, await skillPaths(deps.files))).filter((card) => !held.has(skillKey(card.path)));
89
+ if (offered.length === 0) return [];
90
+ let answers: DecisionAnswers | null = null;
91
+ try {
92
+ answers = await deps.decision.ask(suggestState(request), shortlistQuestion(offered));
93
+ } catch { /* a decision model that throws is one that did not answer */ }
94
+ const picks = shortlistOf(answers, offered);
95
+ try {
96
+ await deps.session.writeState(SKILLS_SUGGESTED_STATE_KEY, JSON.stringify({ offered: offered.length, picks }));
97
+ } catch { /* the record is a convenience: the turn goes on without it */ }
98
+ if (picks.length === 0) return [];
99
+ const skills = await contents(deps.files, picks);
100
+ deps.log.info(skillsSuggested(skills.map((skill) => skill.path).join(", ")));
101
+ return skills;
102
+ }
@@ -0,0 +1,8 @@
1
+ // Why no state file of the batch in progress was written, and what the tree's status could not say.
2
+
3
+ export const noWorkCode = (code: string, folder: string, reason: string): string => `no work code '${code}' in ${folder}/ (${reason})`;
4
+ export const noSheetOf = (phase: string, shown: string): string => `no sheet of ${phase} in ${shown}/`;
5
+ export const noOpenSheetOf = (phase: string, folder: string): string => `no open sheet of ${phase} in ${folder}/`;
6
+ export const gitStatusFailed = (reason: string): string => `git status failed: ${reason}`;
7
+ export const gitStatusCouldNotRun = (reason: string): string => `git status could not run: ${reason}`;
8
+ export const workFolderUnreachable = (folder: string): string => `the work folder ${folder}/ cannot be reached`;
@@ -17,6 +17,7 @@ import { listDevCodes, loadDevCode, loadDevContext } from "../dev/load-dev-conte
17
17
  import type { CodeSheet, DevCode } from "../dev/load-dev-context.ts";
18
18
  import type { WorkFolder } from "../dev/resolve-work-folder.ts";
19
19
  import { WORKSPACE } from "../../domain/vfs.ts";
20
+ import { gitStatusCouldNotRun, gitStatusFailed, noOpenSheetOf, noSheetOf, noWorkCode, workFolderUnreachable } from "./messages.ts";
20
21
 
21
22
  export async function readActiveWorkflow(session: Pick<SessionStore, "readState">): Promise<ActiveWorkflow | null> {
22
23
  return parseActiveWorkflow(await session.readState(WORKFLOW_ACTIVE_STATE_KEY));
@@ -51,9 +52,9 @@ async function findSheet(
51
52
  ): Promise<{ code: DevCode; sheet: CodeSheet } | { skipped: string }> {
52
53
  if (active.code !== null) {
53
54
  const lookup = await loadDevCode(deps, work, active.code);
54
- if (lookup.found === null) return { skipped: `no work code '${active.code}' in ${work.folder}/ (${lookup.reason})` };
55
+ if (lookup.found === null) return { skipped: noWorkCode(active.code, work.folder, lookup.reason) };
55
56
  const any = lookup.found.sheets.find((s) => s.batch === active.phase);
56
- if (any === undefined) return { skipped: `no sheet of ${active.phase} in ${lookup.found.shown}/` };
57
+ if (any === undefined) return { skipped: noSheetOf(active.phase, lookup.found.shown) };
57
58
  if (any.sheet.doneDate !== undefined) return { skipped: `${lookup.found.shown}/${any.name} is done (${any.sheet.doneDate})` };
58
59
  return { code: lookup.found, sheet: any };
59
60
  }
@@ -64,7 +65,7 @@ async function findSheet(
64
65
  const sheet = openSheet(lookup.found, active.phase);
65
66
  if (sheet !== undefined) return { code: lookup.found, sheet };
66
67
  }
67
- return { skipped: `no open sheet of ${active.phase} in ${work.folder}/` };
68
+ return { skipped: noOpenSheetOf(active.phase, work.folder) };
68
69
  }
69
70
 
70
71
  /** The batch's events: Code's own log when there is one, else the log of the work code's
@@ -95,10 +96,10 @@ async function readReports(files: Pick<Files, "list">, folder: string, phase: st
95
96
  async function readTree(shell: Pick<Shell, "run">): Promise<{ lines: string[] } | { note: string }> {
96
97
  try {
97
98
  const r = await shell.run("git status --short");
98
- if (r.exitCode !== 0) return { note: `git status failed: ${(r.stderr || r.stdout).trim().split("\n")[0] || `exit ${r.exitCode}`}` };
99
+ if (r.exitCode !== 0) return { note: gitStatusFailed((r.stderr || r.stdout).trim().split("\n")[0] || `exit ${r.exitCode}`) };
99
100
  return { lines: r.stdout.split(/\r?\n/).filter((l) => l.trim().length > 0) };
100
101
  } catch (error) {
101
- return { note: `git status could not run: ${error instanceof Error ? error.message : String(error)}` };
102
+ return { note: gitStatusCouldNotRun(error instanceof Error ? error.message : String(error)) };
102
103
  }
103
104
  }
104
105
 
@@ -112,7 +113,7 @@ export async function writeWorkflowState(
112
113
  const active = await readActiveWorkflow(deps.session);
113
114
  if (active === null) return null;
114
115
  const { work } = await loadDevContext(deps);
115
- if (work.vfsPath === null) return { skipped: `the work folder ${work.folder}/ cannot be reached` };
116
+ if (work.vfsPath === null) return { skipped: workFolderUnreachable(work.folder) };
116
117
  const found = await findSheet(deps, work, active);
117
118
  if ("skipped" in found) return found;
118
119
 
@@ -8,6 +8,8 @@
8
8
  // before the flags existed. Every default below is therefore the value that was hard-coded at
9
9
  // the call site (40 act iterations, one review pass, nothing dropped, no extra
10
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";
11
13
 
12
14
  // ── /effort → the act() iteration ladder ─────────────────────────────────
13
15
 
@@ -20,7 +22,7 @@ export const DEFAULT_EFFORT: EffortLevel = "medium";
20
22
  /**
21
23
  * Iterations granted to `ctx.llm.act` per level.
22
24
  *
23
- * The ladder bounds the tool-calling loop. Since Orkeon 1.0.0-rc.6 the level also reaches the
25
+ * The ladder bounds the tool-calling loop. The level also reaches the
24
26
  * provider: `act({ effort })` and `AgentBuilder.effort()` turn its thinking on at that level (A-3).
25
27
  * Only a level `/effort` stored is forwarded (`providerEffort`): an unconfigured session sends none,
26
28
  * so it keeps the provider's own default and the 40 iterations it always had.
@@ -99,14 +101,6 @@ export function fastModeDrops(fast: boolean): readonly DroppableBlock[] {
99
101
 
100
102
  // ── /proactive → the follow-up clause ────────────────────────────────────
101
103
 
102
- /**
103
- * Appended to the task block (last, with the request) rather than added as its
104
- * own context block: it is an instruction about the ANSWER's shape, and the
105
- * furthest thing from the task is the easiest for a model to lose.
106
- */
107
- export const PROACTIVE_CLAUSE =
108
- "(Proactive mode: after the answer, suggest at most three concrete next steps under " +
109
- "'Next steps'; leave the list out when the work is self-contained.)";
110
104
 
111
105
  export function proactiveSuffix(on: boolean): string {
112
106
  return on ? `\n\n${PROACTIVE_CLAUSE}` : "";
@@ -158,7 +152,7 @@ export function describeActiveFlags(flags: BehaviorFlags): string {
158
152
  const active: string[] = [];
159
153
  // A stored level, even `medium`, is named: it turns the provider's thinking on.
160
154
  if (flags.thinking !== null) {
161
- active.push(`effort=${flags.effort} (act maxIterations=${EFFORT_MAX_ITERATIONS[flags.effort]}, provider thinking ${flags.thinking})`);
155
+ active.push(effortFlag(flags.effort, EFFORT_MAX_ITERATIONS[flags.effort], flags.thinking));
162
156
  }
163
157
  if (flags.passes !== DEFAULT_PASSES) active.push(`passes=${flags.passes}`);
164
158
  if (flags.fast) active.push(`fast=on (dropping ${FAST_MODE_DROPPED_BLOCKS.join(", ")})`);
@@ -12,13 +12,11 @@
12
12
 
13
13
  import { builtInTool, sameToolName } from "./permission.ts";
14
14
  import type { ExtraTool } from "./permission.ts";
15
+ import { EXTRA_TOOL_ENTRY_RULE, NAMES_NO_TOOL } from "./messages.ts";
15
16
 
16
17
  /** The /config key that lists them. */
17
18
  export const EXTRA_TOOLS_CONFIG_KEY = "tools.extra";
18
19
 
19
- /** What an entry must be, for messages. */
20
- export const EXTRA_TOOL_ENTRY_RULE = "each entry is <name>[:read|:write], a tool that is not built in, named once";
21
-
22
20
  /** A tool name as the host registers it: letters, digits, `_`, `-`, `.`. */
23
21
  const TOOL_NAME = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
24
22
 
@@ -65,5 +63,5 @@ export function extraToolsProblem(value: string): string | undefined {
65
63
  if (invalid.length > 0) {
66
64
  return `${EXTRA_TOOL_ENTRY_RULE}; not: ${invalid.join(", ")}`;
67
65
  }
68
- return tools.length === 0 ? "it names no tool" : undefined;
66
+ return tools.length === 0 ? NAMES_NO_TOOL : undefined;
69
67
  }
@@ -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,299 @@
1
+ // The user's path lists — pure, no IO: `paths.deny` names what the assistant may neither read nor write,
2
+ // `paths.allow` the only paths it may; both match on the canonical virtual spelling (host-paths.ts toVirtual), so a
3
+ // physical spelling of a mount's base (`C:\…`, `/mnt/c/…`, `\\wsl$\…`) or another letter case on a Windows disk
4
+ // reaches the same rule. The notation:
5
+ //
6
+ // /workspace/secrets, C:\proj\keys\*, tests/fixtures/real
7
+ //
8
+ // entries separated by commas (a path may hold spaces), each a virtual path, a physical spelling of a mount's base,
9
+ // or a relative path under /workspace; `*` stands for any run of characters as the gate reads it; a bare path covers
10
+ // itself and everything below it. Deny wins over allow; a non-empty allow refuses every path outside it, on every
11
+ // mount. Two readers: pathListRules gives the gate the deny rules on the canonical spelling (and lists them in
12
+ // /permissions); pathListRefusal, run by the acts' callbacks on the canonicalised call, holds against every spelling,
13
+ // every case the host ignores, each operation of an edit_batch, what a folder reader reaches and the words of a
14
+ // shell command. The built-in deny of the whole /user-config mount (userConfigRules) keeps the physical bases of
15
+ // launch.json and the user settings out of the model's reach.
16
+
17
+ import { globMatches, sameToolName, shellCommandForms, shellWords } from "./permission.ts";
18
+ import type { PermissionRule } from "./permission.ts";
19
+ import {
20
+ FOLDER_READ_TOOLS, OPERATIONS_TOOL, PATH_READ_TOOLS, PATH_WRITE_TOOLS, UNSCOPED_READ_TOOLS, UNSCOPED_WRITE_TOOLS,
21
+ denyEach, denyWhole,
22
+ } from "./rule-sets.ts";
23
+ import { normalisePath, reachedPaths } from "../dev/call-guard.ts";
24
+ import { textToVirtual, toVirtual } from "../host-paths.ts";
25
+ import { IDENTITY_HOST } from "../host-layout.ts";
26
+ import type { HostLayout } from "../host-layout.ts";
27
+ import { MOUNT_POINTS, WORKSPACE } from "../vfs.ts";
28
+ import {
29
+ holdsAQuote, namesEveryPath, namesEveryPathNoRule, outsideAllow, outsideUserList, PATH_ENTRY_RULE, refusedByDeny,
30
+ refusedOwnMount, underNoMount,
31
+ } from "./messages.ts";
32
+
33
+ /** The /config keys. */
34
+ export const PATHS_DENY_CONFIG_KEY = "paths.deny";
35
+ export const PATHS_ALLOW_CONFIG_KEY = "paths.allow";
36
+
37
+ /** The mount Orkeon Code keeps to itself: config.json and launch.json, the physical bases inside. */
38
+ export const USER_CONFIG_MOUNT = "/user-config";
39
+
40
+ /** The lists as the callbacks check them: canonical patterns, a bare entry present as itself and as `<entry>/*`. */
41
+ export interface PathLists {
42
+ deny: readonly string[];
43
+ allow: readonly string[];
44
+ }
45
+
46
+ export const EMPTY_PATH_LISTS: PathLists = Object.freeze({ deny: Object.freeze([]), allow: Object.freeze([]) }) as PathLists;
47
+
48
+ export interface PathListsParse extends PathLists {
49
+ /** Each entry left out, as written, and why. */
50
+ problems: string[];
51
+ }
52
+
53
+ /** The raw values of the two keys of one settings file, undefined when unset. */
54
+ export interface PathListValues {
55
+ deny?: string;
56
+ allow?: string;
57
+ }
58
+
59
+ const DRIVE_OR_UNC = /^(?:[A-Za-z]:|\\\\|\/\/|\\)/;
60
+
61
+ /** Whether a path is spelled as a Windows drive or UNC path. */
62
+ const windowsSpelled = (text: string): boolean => DRIVE_OR_UNC.test(text);
63
+
64
+ const escapeRegExp = (text: string): string => text.replace(/[.*+?^$|()[\]{}\\]/g, "\\$&");
65
+
66
+ /** Whether a posix path lies under a Windows drive the WSL automount exposes (`/mnt/c/…`). */
67
+ function underAutomount(path: string, layout: HostLayout): boolean {
68
+ const root = layout.automountRoot === "/" ? "" : layout.automountRoot;
69
+ return new RegExp(`^${escapeRegExp(root)}/[A-Za-z](?:/|$)`).test(path);
70
+ }
71
+
72
+ /** Whether a canonical path starts with a mount point of the VFS: one the launchers give, or one of the layout. */
73
+ function onMount(path: string, layout: HostLayout): boolean {
74
+ const first = `/${path.split("/")[1] ?? ""}`;
75
+ return MOUNT_POINTS.includes(first) || layout.mounts.some((m) => m.virtual === first);
76
+ }
77
+
78
+ /** One entry to its canonical virtual spelling, or the reason it has none. */
79
+ function canonicalEntry(given: string, layout: HostLayout): { canonical?: string; problem?: string } {
80
+ const relative = !given.startsWith("/") && !windowsSpelled(given);
81
+ const virtual = normalisePath(toVirtual(relative ? `${WORKSPACE}/${given}` : given, layout));
82
+ if (!virtual.startsWith("/")) return { problem: underNoMount(given) };
83
+ if (virtual === "/") return { problem: namesEveryPathNoRule(given) };
84
+ if (layout.flavour === "wsl" && underAutomount(virtual, layout)) {
85
+ return { problem: underNoMount(given) };
86
+ }
87
+ return { canonical: virtual };
88
+ }
89
+
90
+ /** The entries of a value as written: trimmed, the blanks left out. */
91
+ const writtenEntries = (value: string): string[] => value.split(/[,\n]/).map((e) => e.trim()).filter((e) => e.length > 0);
92
+
93
+ /** Why a value of paths.deny or paths.allow is refused by /config set, on its notation alone (which mount an entry
94
+ * lies under is the run's to judge, with the host's layout): no entry, an entry holding a quote, one naming every path. */
95
+ export function pathListProblem(value: string): string | undefined {
96
+ const entries = writtenEntries(value);
97
+ if (entries.length === 0) return `no entry (${PATH_ENTRY_RULE})`;
98
+ for (const entry of entries) {
99
+ if (/["'`]/.test(entry)) return holdsAQuote(entry, PATH_ENTRY_RULE);
100
+ if (/^[\\/]?\*?[\\/]?$/.test(entry)) return namesEveryPath(entry, PATH_ENTRY_RULE);
101
+ }
102
+ return undefined;
103
+ }
104
+
105
+ /** The patterns one canonical entry stands for: a bare path covers itself and what is below it. */
106
+ const patternsOf = (canonical: string): string[] => canonical.includes("*") ? [canonical] : [canonical, `${canonical}/*`];
107
+
108
+ /** The entries of one value, each canonical, in the order given; `problems` says what was left out and why. */
109
+ export function parsePathEntries(value: unknown, layout: HostLayout): { entries: string[]; problems: string[] } {
110
+ const given = writtenEntries(String(value ?? ""));
111
+ const entries: string[] = [];
112
+ const problems: string[] = [];
113
+ for (const entry of given) {
114
+ const { canonical, problem } = canonicalEntry(entry, layout);
115
+ if (problem !== undefined) problems.push(problem);
116
+ else if (canonical !== undefined && !entries.includes(canonical)) entries.push(canonical);
117
+ }
118
+ return { entries, problems };
119
+ }
120
+
121
+ /** Whether `path` lies within what `pattern` covers, case folded as the host folds it. */
122
+ function within(pattern: string, path: string, layout: HostLayout): boolean {
123
+ return globMatches(folded(pattern, layout), folded(path, layout));
124
+ }
125
+
126
+ /** A path as it is compared: lower-cased where the host's file system ignores the case (every path on native Windows,
127
+ * a path under a mount whose base is a Windows drive under WSL), as written elsewhere. */
128
+ function folded(path: string, layout: HostLayout): string {
129
+ if (layout.flavour === "windows") return path.toLowerCase();
130
+ if (layout.flavour !== "wsl") return path;
131
+ const virtual = `/${path.split("/")[1] ?? ""}`;
132
+ const mount = layout.mounts.find((m) => m.virtual === virtual);
133
+ const onDrive = mount !== undefined
134
+ && ((mount.posix !== undefined && underAutomount(mount.posix, layout)) || /^[A-Za-z]:/.test(mount.windows ?? ""));
135
+ return onDrive ? path.toLowerCase() : path;
136
+ }
137
+
138
+ /**
139
+ * The lists as they apply: the user's denies and the project's, added; the user's allows, and the project's allow
140
+ * entries within them — a project file narrows, never widens: when the user allows nothing in particular, the
141
+ * project's allows stand whole. Every entry canonical; the problems name each entry left out, with its key.
142
+ */
143
+ export function readPathLists(user: PathListValues, project: PathListValues, layout: HostLayout): PathListsParse {
144
+ const problems: string[] = [];
145
+ const read = (value: unknown, key: string, who: string): string[] => {
146
+ const parsed = parsePathEntries(value, layout);
147
+ problems.push(...parsed.problems.map((p) => `${key} (${who}): ${p}`));
148
+ return parsed.entries;
149
+ };
150
+ const userDeny = read(user.deny, PATHS_DENY_CONFIG_KEY, "user");
151
+ const projectDeny = read(project.deny, PATHS_DENY_CONFIG_KEY, "project");
152
+ const userAllow = read(user.allow, PATHS_ALLOW_CONFIG_KEY, "user");
153
+ const projectAllow = read(project.allow, PATHS_ALLOW_CONFIG_KEY, "project").filter((entry) => {
154
+ const kept = userAllow.length === 0 || userAllow.some((u) => patternsOf(u).some((p) => within(p, entry, layout)));
155
+ if (!kept) problems.push(outsideUserList(PATHS_ALLOW_CONFIG_KEY, entry));
156
+ return kept;
157
+ });
158
+ const unique = (entries: string[]): string[] => [...new Set(entries.flatMap(patternsOf))];
159
+ return { deny: unique([...userDeny, ...projectDeny]), allow: unique([...userAllow, ...projectAllow]), problems };
160
+ }
161
+
162
+ /**
163
+ * The project's paths.allow as it applies over the user's, judged without the host (the config schema's layering,
164
+ * /config list and /doctor): an entry within the user's list is kept as written, one outside it is dropped; an entry
165
+ * the identity host cannot read (a physical spelling) is kept, the run judges it with the layout. A user allowing
166
+ * nothing in particular keeps them all, as readPathLists does.
167
+ */
168
+ export function narrowAllowValue(project: string, user: string | undefined): { kept: string[]; dropped: string[] } {
169
+ const userPatterns = user === undefined ? [] : parsePathEntries(user, IDENTITY_HOST).entries.flatMap(patternsOf);
170
+ if (userPatterns.length === 0) return { kept: writtenEntries(project), dropped: [] };
171
+ const kept: string[] = [];
172
+ const dropped: string[] = [];
173
+ for (const entry of writtenEntries(project)) {
174
+ const { canonical } = canonicalEntry(entry, IDENTITY_HOST);
175
+ const inside = canonical === undefined || userPatterns.some((p) => within(p, canonical, IDENTITY_HOST));
176
+ (inside ? kept : dropped).push(entry);
177
+ }
178
+ return { kept, dropped };
179
+ }
180
+
181
+ /** The entries of a list as a reader meets them: each canonical entry once, without the `<entry>/*` twin a bare entry
182
+ * stands for. */
183
+ export function listedEntries(patterns: readonly string[]): string[] {
184
+ return patterns.filter((p) => !(p.endsWith("/*") && patterns.includes(p.slice(0, -2))));
185
+ }
186
+
187
+ /** The spellings the gate may meet a canonical pattern in: itself, and relative to the project when under it. */
188
+ function gateForms(pattern: string): string[] {
189
+ return pattern.startsWith(`${WORKSPACE}/`) ? [pattern, pattern.slice(WORKSPACE.length + 1)] : [pattern];
190
+ }
191
+
192
+ /**
193
+ * The deny rules of the lists for the gate, on the canonical spelling and the relative one: each pattern on the
194
+ * `path` of every reading and writing tool; a shell rule on the absolute pattern as a run of the command's text; and
195
+ * once a deny exists, the tools whose paths the gate cannot read denied whole (UNSCOPED_READ_TOOLS and
196
+ * UNSCOPED_WRITE_TOOLS). An allow gives the gate nothing: it narrows, and pathListRefusal holds it. The other
197
+ * spellings and the host's case are pathListRefusal's too.
198
+ */
199
+ export function pathListRules(lists: PathLists): PermissionRule[] {
200
+ if (lists.deny.length === 0) return [];
201
+ const tools = [...PATH_READ_TOOLS, ...PATH_WRITE_TOOLS];
202
+ const paths = lists.deny.flatMap((pattern) => denyEach(tools, "path", gateForms(pattern)));
203
+ const commands = lists.deny.filter((p) => !p.endsWith("/*")).map((p): PermissionRule =>
204
+ ({ effect: "deny", tool: "shell_command", argument: "command", pattern: `*${p}*` }));
205
+ return [...paths, ...commands, ...denyWhole([...UNSCOPED_READ_TOOLS, ...UNSCOPED_WRITE_TOOLS])];
206
+ }
207
+
208
+ /** The built-in rules that close the whole /user-config mount to the model: its readers and writers by path, the
209
+ * folder readers on the mount itself, and any shell command naming it. In force beside the memory rules. */
210
+ export function userConfigRules(): PermissionRule[] {
211
+ return [
212
+ ...denyEach([...PATH_READ_TOOLS, ...PATH_WRITE_TOOLS], "path", [`${USER_CONFIG_MOUNT}/*`]),
213
+ ...denyEach(FOLDER_READ_TOOLS, "path", [USER_CONFIG_MOUNT]),
214
+ { effect: "deny", tool: "shell_command", argument: "command", pattern: `*${USER_CONFIG_MOUNT}*` },
215
+ ];
216
+ }
217
+
218
+ const BUILT_IN_DENIES: readonly string[] = [USER_CONFIG_MOUNT, `${USER_CONFIG_MOUNT}/*`];
219
+
220
+ /** A path named by a call: as the call spells it, and canonical. A word of a shell command that names no mount
221
+ * (`/dev/null`, `/usr/bin/env`) is `unmounted`: a deny may still cover it, the allow list does not judge it. */
222
+ interface NamedPath { given: string; canonical: string; unmounted?: boolean }
223
+
224
+ /** A spelling to its canonical virtual path: a relative one under the project; a Windows spelling under no mount
225
+ * stays as written (the VFS refuses it anyway) and a deny never matches it. */
226
+ function canonicalOf(given: string, layout: HostLayout): string {
227
+ const virtual = toVirtual(given, layout);
228
+ if (windowsSpelled(virtual)) return virtual;
229
+ return normalisePath(virtual.startsWith("/") ? virtual : `${WORKSPACE}/${virtual}`);
230
+ }
231
+
232
+ const plain = (value: unknown): string | undefined => typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
233
+
234
+ /** The words of a shell command that name a path: absolute or Windows spelled, or holding a separator (a relative
235
+ * path); the value of a `key=value` word (`--out=…`, `FOO=…`), the target of a redirection (`2>/dev/null`); never
236
+ * an option, a URL or a bare word. The command is read with its physical spellings canonicalised first
237
+ * (textToVirtual), so an unquoted Windows path with spaces is one word, never its fragments. */
238
+ function commandPaths(command: string, layout: HostLayout): string[] {
239
+ const words = new Set(shellCommandForms(textToVirtual(command, layout)).flatMap(shellWords));
240
+ const paths: string[] = [];
241
+ for (const word of words) {
242
+ const equals = word.indexOf("=");
243
+ const assigned = equals > 0 && !/[/\\]/.test(word.slice(0, equals)) ? word.slice(equals + 1) : word;
244
+ const value = assigned.replace(/^[0-9]*[<>]{1,2}&?/, "");
245
+ if (value === "" || value.startsWith("-") || /^[a-z][a-z0-9+.-]*:\/\//i.test(value)) continue;
246
+ const pathLike = value.startsWith("/") || windowsSpelled(value) || /[/\\]/.test(value);
247
+ if (pathLike && !paths.includes(value)) paths.push(value);
248
+ }
249
+ return paths;
250
+ }
251
+
252
+ /** Every path one call names, canonical beside its spelling. */
253
+ function namedPaths(tool: string, args: Readonly<Record<string, unknown>>, layout: HostLayout): NamedPath[] {
254
+ const given: string[] = [];
255
+ for (const field of ["path", "root_path", "working_directory"]) {
256
+ const value = plain(args[field]);
257
+ if (value !== undefined) given.push(value);
258
+ }
259
+ if (Array.isArray(args.paths)) given.push(...args.paths.map(plain).filter((p): p is string => p !== undefined));
260
+ if (sameToolName(tool, OPERATIONS_TOOL) && Array.isArray(args.operations)) {
261
+ for (const op of args.operations) {
262
+ const path = op !== null && typeof op === "object" ? plain((op as { path?: unknown }).path) : undefined;
263
+ if (path !== undefined) given.push(path);
264
+ }
265
+ }
266
+ given.push(...reachedPaths(tool, args));
267
+ const named: NamedPath[] = [...new Set(given)].map((g) => ({ given: g, canonical: canonicalOf(g, layout) }));
268
+ if (sameToolName(tool, "shell_command") && typeof args.command === "string") {
269
+ for (const word of commandPaths(args.command, layout)) {
270
+ const canonical = canonicalOf(word, layout);
271
+ if (!named.some((n) => n.given === word)) named.push({ given: word, canonical, unmounted: !onMount(canonical, layout) });
272
+ }
273
+ }
274
+ return named;
275
+ }
276
+
277
+ const spelled = (p: NamedPath): string => p.given === p.canonical ? `'${p.given}'` : `'${p.given}' (${p.canonical})`;
278
+
279
+ /**
280
+ * Why a call falls under the lists, or null: the first path it names (its `path`, `root_path`, `working_directory`,
281
+ * `paths`, each operation of an edit_batch, what a folder reader reaches, the words of a shell command) that a deny
282
+ * pattern covers, the built-in deny of /user-config included; else, when an allow list stands, the first path outside
283
+ * every allow pattern, the words of a shell command that name no mount (`/dev/null`) apart. Each path read canonical
284
+ * and in the host's case. Best effort on a shell command: what a script reaches by itself, and a folder reader over
285
+ * a folder above a denied one, are outside this check.
286
+ */
287
+ export function pathListRefusal(lists: PathLists, layout: HostLayout, tool: string, input: unknown): string | null {
288
+ const args = input !== null && typeof input === "object" && !Array.isArray(input) ? input as Readonly<Record<string, unknown>> : {};
289
+ const named = namedPaths(tool, args, layout);
290
+ for (const path of named) {
291
+ const builtIn = BUILT_IN_DENIES.find((p) => within(p, path.canonical, layout));
292
+ if (builtIn !== undefined) return refusedOwnMount(tool, spelled(path), USER_CONFIG_MOUNT);
293
+ const deny = lists.deny.find((p) => within(p, path.canonical, layout));
294
+ if (deny !== undefined) return refusedByDeny(tool, spelled(path), PATHS_DENY_CONFIG_KEY, deny);
295
+ }
296
+ if (lists.allow.length === 0) return null;
297
+ const outside = named.find((path) => path.unmounted !== true && !lists.allow.some((p) => within(p, path.canonical, layout)));
298
+ return outside === undefined ? null : outsideAllow(tool, spelled(outside), PATHS_ALLOW_CONFIG_KEY);
299
+ }