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
@@ -12,17 +12,32 @@
12
12
  // report success and change nothing.
13
13
 
14
14
  import { PERMISSION_FALLBACK_CONFIG_KEY, PERMISSION_MODES } from "./permission-modes.ts";
15
- import { EXTRA_TOOLS_CONFIG_KEY, extraToolsProblem, formatExtraTool, parseExtraTools } from "./agent-policy/extra-tools.ts";
15
+ import {
16
+ EXTRA_TOOLS_CONFIG_KEY, extraToolsProblem, formatExtraTool, parseExtraTools,
17
+ } from "./agent-policy/extra-tools.ts";
16
18
  import { sameToolName } from "./agent-policy/permission.ts";
17
19
  import { VOICE_REPLY_CONFIG_KEY } from "./speech.ts";
18
20
  import { ANSWER_LANGUAGE_CONFIG_KEY } from "./agent-policy/output-styles.ts";
19
21
  import { COMPACTION_TRIGGER_CONFIG_KEY, compactionTriggerProblem } from "./compaction-thresholds.ts";
22
+ import { PRUNE_CONFIG_KEY } from "./context-prune.ts";
23
+ import { SKILLS_SUGGEST_CONFIG_KEY } from "./skills/shortlist.ts";
24
+ import { ROUTE_AGENTS_CONFIG_KEY, ROUTE_LADDER_CONFIG_KEY, ladderProblem } from "./agents/model-route.ts";
20
25
  import { DEV_WORK_DIR_CONFIG_KEY, workFolderProblem } from "./dev/work-folder.ts";
21
26
  import { DEV_PR_AUTO_CONFIG_KEY } from "./git/close.ts";
22
27
  import { LLM_PROFILE_CONFIG_KEY, llmProfileProblem } from "./llm-profile.ts";
23
28
  import {
24
29
  MEMORY_AUTO_ADMIT_CONFIG_KEY, MEMORY_DIR_CONFIG_KEY, MEMORY_PROJECT_CONFIG_KEY, memoryDirProblem, memoryProjectProblem,
25
30
  } from "./shared-memory/layout.ts";
31
+ import {
32
+ PATHS_ALLOW_CONFIG_KEY, PATHS_DENY_CONFIG_KEY, narrowAllowValue, pathListProblem,
33
+ } from "./agent-policy/path-rules.ts";
34
+ import {
35
+ ADVISOR_MODEL_DOC, ANSWER_LANGUAGE_DOC, AUTO_ADMIT_FROM_USER, COMMIT_REQUIRE_CONFIRM_DOC, COMPACTION_TRIGGER_DOC,
36
+ DEV_PR_AUTO_DOC, DEV_WORK_DIR_DOC, EXTRA_TOOLS_DOC, EXTRA_TOOLS_NOT_ALLOWED, invalidValue, LLM_PROFILE_DOC,
37
+ MEMORY_AUTO_ADMIT_DOC, MEMORY_DIR_DOC, MEMORY_PROJECT_DOC, needsAValue, notAllowedValue, PATHS_ALLOW_DOC,
38
+ PATHS_ALLOW_OUTSIDE_USER, PATHS_DENY_DOC, PERMISSION_FALLBACK_DOC, PR_AUTO_FROM_USER, PRUNE_DOC, PROJECT_FALLBACK_TOO_WIDE,
39
+ REVIEW_LENSES_DOC, ROUTE_AGENTS_DOC, ROUTE_LADDER_DOC, SKILLS_SUGGEST_DOC, SPINNER_VERBS_DOC, unknownConfigKey, VOICE_REPLY_DOC, widerThanUserFallback,
40
+ } from "./messages.ts";
26
41
 
27
42
  export interface ConfigKeySpec {
28
43
  key: string;
@@ -44,126 +59,104 @@ export interface ConfigKeySpec {
44
59
  export const CONFIG_KEYS: readonly ConfigKeySpec[] = [
45
60
  {
46
61
  key: PERMISSION_FALLBACK_CONFIG_KEY,
47
- description:
48
- "Permission mode for a session where neither /mode nor a 'mode:' prefix set one. " +
49
- "Omitted = 'default' (asks on writes, like the original).",
62
+ ...PERMISSION_FALLBACK_DOC,
50
63
  allowed: PERMISSION_MODES,
51
- consumedBy: "/assistant (main-loop crew), /commit, /mode, /permissions",
52
64
  },
53
65
  {
54
66
  key: "review.lenses",
55
- description:
56
- "Comma-separated review lenses for /review (correctness, security, style). " +
57
- "Omitted = all three.",
58
- consumedBy: "/review (code-review crew)",
67
+ ...REVIEW_LENSES_DOC,
59
68
  },
60
69
  {
61
70
  key: "advisor.model",
62
- description:
63
- "Model used for the secondary opinion of /advisor. Omitted = the session's own " +
64
- "model, which makes the review a self-review and worth far less.",
65
- consumedBy: "/advisor (advisor crew)",
71
+ ...ADVISOR_MODEL_DOC,
66
72
  },
67
73
  {
68
74
  key: LLM_PROFILE_CONFIG_KEY,
69
- description:
70
- "The host profile the agents of every crew run on: an LLM profile (Llm:Profiles:<name>) or a decision " +
71
- "profile (Orkeon:Decision:Profiles:<name>, a decision model such as Jev in front of one), e.g. 'guarded'. " +
72
- "A name the host does not declare fails the crew's load, listing the profiles it knows. Omitted = the host's " +
73
- "default model.",
75
+ ...LLM_PROFILE_DOC,
74
76
  problem: llmProfileProblem,
75
- consumedBy: "/assistant, /review, /commit, /advisor, /memory admit, the dev steps and every other command that launches a crew (the model its agents run on)",
76
77
  },
77
78
  {
78
79
  key: "commit.requireConfirm",
79
- description:
80
- "'false' lets /commit launch without a confirmation prompt. Omitted = 'true' " +
81
- "(a confirmation is required; see B-1).",
80
+ ...COMMIT_REQUIRE_CONFIRM_DOC,
82
81
  allowed: ["true", "false"],
83
- consumedBy: "/commit",
84
82
  },
85
83
  {
86
84
  key: "spinnerVerbs",
87
- description:
88
- "Comma-separated verbs the TUI status line rotates through while a turn runs " +
89
- "(tweakcc vocabulary: 'thinking verbs'), e.g. 'Reticulating, Percolating'. " +
90
- "Omitted = the built-in Orkeon gerunds.",
91
- consumedBy: "the orkeon-repl TUI status line (read by the host)",
85
+ ...SPINNER_VERBS_DOC,
92
86
  },
93
87
  {
94
88
  key: EXTRA_TOOLS_CONFIG_KEY,
95
- description:
96
- "Tools of an MCP server or a plugin the assistant may use, e.g. 'transcribe_audio:read, " +
97
- "search_issues': each <name>[:read|:write], write when the class is left out, so plan " +
98
- "and dontAsk offer only the read ones. A name the host does not register is left out " +
99
- "with a warning. Omitted = none.",
89
+ ...EXTRA_TOOLS_DOC,
100
90
  problem: extraToolsProblem,
101
- consumedBy: "/assistant and /summary (the tools offered), /permissions (rules may name them)",
102
91
  },
103
92
  {
104
93
  key: VOICE_REPLY_CONFIG_KEY,
105
- description:
106
- "'on' reads every answer of the assistant aloud, through the speech MCP server's speak " +
107
- "(the launcher's ORKEON_CODE_VOICE=1 opens the speaker); code blocks and tables are not read. " +
108
- "Omitted = 'off'.",
94
+ ...VOICE_REPLY_DOC,
109
95
  allowed: ["on", "off"],
110
- consumedBy: "/assistant, /summary, /transcribe --then, /voice send and /voice --go (each answer read aloud)",
111
96
  },
112
97
  {
113
98
  key: ANSWER_LANGUAGE_CONFIG_KEY,
114
- description:
115
- "The language the assistant answers in, e.g. 'French', unless the user writes in another one. " +
116
- "Omitted = the language of each request.",
117
- consumedBy: "/assistant, /summary, /transcribe --then, /voice send and /voice --go (the main loop's prompt)",
99
+ ...ANSWER_LANGUAGE_DOC,
118
100
  },
119
101
  {
120
102
  key: COMPACTION_TRIGGER_CONFIG_KEY,
121
- description:
122
- "The token count at which the automatic compaction runs, e.g. '90000' or '90k'. Omitted = the " +
123
- "context window minus the room one turn needs.",
103
+ ...COMPACTION_TRIGGER_DOC,
124
104
  problem: compactionTriggerProblem,
125
- consumedBy: "/assistant (the automatic compaction at the head and the tail of a turn), /usage",
105
+ },
106
+ {
107
+ key: PRUNE_CONFIG_KEY,
108
+ ...PRUNE_DOC,
109
+ allowed: ["on", "off"],
110
+ },
111
+ {
112
+ key: ROUTE_AGENTS_CONFIG_KEY,
113
+ ...ROUTE_AGENTS_DOC,
114
+ allowed: ["on", "off"],
115
+ },
116
+ {
117
+ key: ROUTE_LADDER_CONFIG_KEY,
118
+ ...ROUTE_LADDER_DOC,
119
+ problem: ladderProblem,
120
+ },
121
+ {
122
+ key: SKILLS_SUGGEST_CONFIG_KEY,
123
+ ...SKILLS_SUGGEST_DOC,
124
+ allowed: ["on", "off"],
126
125
  },
127
126
  {
128
127
  key: DEV_WORK_DIR_CONFIG_KEY,
129
- description:
130
- "The work folder of the dev workflow, relative to the checkout, e.g. 'backstage/tasks'. Omitted = the " +
131
- "repository pack's layout.work, else 'workbench'. A folder absent from the checkout falls back to 'workbench'.",
128
+ ...DEV_WORK_DIR_DOC,
132
129
  problem: workFolderProblem,
133
- consumedBy: "/dev-status (the work folder it reads), /commit (the work folder it leaves out)",
134
130
  },
135
131
  {
136
132
  key: DEV_PR_AUTO_CONFIG_KEY,
137
- description:
138
- "'true' asks /commit to open the pull request of a pushed branch, as --pr does: through the github tool when " +
139
- "it is registered and the permission gate lets it, else the gh pr create command is printed. Omitted = 'false': " +
140
- "the command is printed. Set in the user settings; a project file may only narrow it to 'false'.",
133
+ ...DEV_PR_AUTO_DOC,
141
134
  allowed: ["true", "false"],
142
- consumedBy: "/commit (the pull request of the branch)",
143
135
  },
144
136
  {
145
137
  key: MEMORY_DIR_CONFIG_KEY,
146
- description:
147
- "The folder of the shared memory, relative to the project: its candidates, admitted entries and refused " +
148
- "topics. Omitted = '.orkeon/memory'. Never the agent memory's '.orkeon/agent-memory'.",
138
+ ...MEMORY_DIR_DOC,
149
139
  problem: memoryDirProblem,
150
- consumedBy: "/memory-admit, /assistant (the memory_recall and memory_push tools)",
151
140
  },
152
141
  {
153
142
  key: MEMORY_PROJECT_CONFIG_KEY,
154
- description:
155
- "The project name the shared memory's entries carry and its index is named after (memory-<project>), " +
156
- "e.g. 'orkeon-code'. Omitted = the name of the origin remote, else 'local'.",
143
+ ...MEMORY_PROJECT_DOC,
157
144
  problem: memoryProjectProblem,
158
- consumedBy: "/memory-admit, /assistant (the memory_recall and memory_push tools)",
159
145
  },
160
146
  {
161
147
  key: MEMORY_AUTO_ADMIT_CONFIG_KEY,
162
- description:
163
- "'true' lets /memory-admit admit a candidate an audit verdict backs without asking. Omitted = 'false': " +
164
- "every candidate is confirmed. A project file may set it to 'true' only when the user settings do.",
148
+ ...MEMORY_AUTO_ADMIT_DOC,
165
149
  allowed: ["true", "false"],
166
- consumedBy: "/memory-admit",
150
+ },
151
+ {
152
+ key: PATHS_DENY_CONFIG_KEY,
153
+ ...PATHS_DENY_DOC,
154
+ problem: pathListProblem,
155
+ },
156
+ {
157
+ key: PATHS_ALLOW_CONFIG_KEY,
158
+ ...PATHS_ALLOW_DOC,
159
+ problem: pathListProblem,
167
160
  },
168
161
  ];
169
162
 
@@ -203,11 +196,10 @@ const modeWidth = (mode: string): number => MODE_WIDTH[mode] ?? MODE_WIDTH.defau
203
196
  function narrowFallback(project: string, user: string | undefined): Narrowed {
204
197
  const ignore = (reason: string): Narrowed => ({ value: undefined, fallThrough: true, ignored: { value: project, reason } });
205
198
  if (!PROJECT_FALLBACK_MODES.includes(project)) {
206
- return ignore("a project file may set only default, plan or acceptEdits; another mode comes from the " +
207
- "user settings (orkeonCode) or /mode");
199
+ return ignore(PROJECT_FALLBACK_TOO_WIDE);
208
200
  }
209
201
  if (user !== undefined && modeWidth(project) > modeWidth(user)) {
210
- return ignore(`it is wider than the user settings' '${user}' (orkeonCode); a project file may only narrow it`);
202
+ return ignore(widerThanUserFallback(user));
211
203
  }
212
204
  return { value: project, fallThrough: false };
213
205
  }
@@ -249,7 +241,7 @@ function narrowExtraTools(project: string, user: string | undefined): Narrowed {
249
241
  value: value.length > 0 ? value.join(", ") : undefined,
250
242
  fallThrough: false,
251
243
  ...(dropped.length > 0
252
- ? { ignored: { value: dropped.join(", "), reason: "the user settings do not allow (orkeonCode tools.extra, or *)" } }
244
+ ? { ignored: { value: dropped.join(", "), reason: EXTRA_TOOLS_NOT_ALLOWED } }
253
245
  : {}),
254
246
  };
255
247
  }
@@ -266,7 +258,7 @@ function narrowAutoAdmit(project: string, user: string | undefined): Narrowed {
266
258
  if (project !== "true" || user === "true") return { value: project, fallThrough: false };
267
259
  return {
268
260
  value: undefined, fallThrough: true,
269
- ignored: { value: project, reason: "admitting without asking comes from the user settings (orkeonCode); a project file may only narrow it" },
261
+ ignored: { value: project, reason: AUTO_ADMIT_FROM_USER },
270
262
  };
271
263
  }
272
264
 
@@ -275,12 +267,32 @@ function narrowPrAuto(project: string, user: string | undefined): Narrowed {
275
267
  if (project !== "true" || user === "true") return { value: project, fallThrough: false };
276
268
  return {
277
269
  value: undefined, fallThrough: true,
278
- ignored: { value: project, reason: "opening a pull request without asking comes from the user settings (orkeonCode); a project file may only narrow it" },
270
+ ignored: { value: project, reason: PR_AUTO_FROM_USER },
271
+ };
272
+ }
273
+
274
+ /** The project's paths.deny adds to the user's: both apply, the effective value is the two lists. */
275
+ function narrowPathDeny(project: string, user: string | undefined): Narrowed {
276
+ return { value: user === undefined ? project : `${user}, ${project}`, fallThrough: false };
277
+ }
278
+
279
+ /** The project's paths.allow: its entries within the user's list, the others set aside (narrowAllowValue); none kept,
280
+ * the user's list applies. */
281
+ function narrowPathAllow(project: string, user: string | undefined): Narrowed {
282
+ const { kept, dropped } = narrowAllowValue(project, user);
283
+ return {
284
+ value: kept.length > 0 ? kept.join(", ") : undefined,
285
+ fallThrough: kept.length === 0,
286
+ ...(dropped.length > 0
287
+ ? { ignored: { value: dropped.join(", "), reason: PATHS_ALLOW_OUTSIDE_USER } }
288
+ : {}),
279
289
  };
280
290
  }
281
291
 
282
- /** The project value as it applies over the user's: narrowed for the keys that widen. */
292
+ /** The project value as it applies over the user's: narrowed for the keys that widen, added for paths.deny. */
283
293
  function narrowProject(key: string, project: string, user: string | undefined): Narrowed {
294
+ if (key === PATHS_DENY_CONFIG_KEY) return narrowPathDeny(project, user);
295
+ if (key === PATHS_ALLOW_CONFIG_KEY) return narrowPathAllow(project, user);
284
296
  if (key === DEV_PR_AUTO_CONFIG_KEY) return narrowPrAuto(project, user);
285
297
  if (key === PERMISSION_FALLBACK_CONFIG_KEY) return narrowFallback(project, user);
286
298
  if (key === EXTRA_TOOLS_CONFIG_KEY) return narrowExtraTools(project, user);
@@ -320,19 +332,19 @@ export function validateConfigEntry(key: unknown, value: unknown): ValueVerdict
320
332
  if (!spec) {
321
333
  return {
322
334
  ok: false,
323
- reason: `unknown config key '${String(key ?? "")}'. Valid keys: ${knownConfigKeys().join(", ")}`,
335
+ reason: unknownConfigKey(String(key ?? ""), knownConfigKeys()),
324
336
  };
325
337
  }
326
338
  const v = String(value ?? "").trim();
327
- if (v.length === 0) return { ok: false, reason: `'${spec.key}' needs a value.` };
339
+ if (v.length === 0) return { ok: false, reason: needsAValue(spec.key) };
328
340
  if (spec.allowed && !spec.allowed.includes(v)) {
329
341
  return {
330
342
  ok: false,
331
- reason: `'${v}' is not valid for '${spec.key}'. Allowed: ${spec.allowed.join(", ")}`,
343
+ reason: notAllowedValue(v, spec.key, spec.allowed),
332
344
  };
333
345
  }
334
346
  const problem = spec.problem?.(v);
335
- if (problem !== undefined) return { ok: false, reason: `'${v}' is not valid for '${spec.key}': ${problem}` };
347
+ if (problem !== undefined) return { ok: false, reason: invalidValue(v, spec.key, problem) };
336
348
  return { ok: true, reason: "" };
337
349
  }
338
350
 
@@ -345,8 +357,9 @@ export function validateConfigEntry(key: unknown, value: unknown): ValueVerdict
345
357
  * the file value. The project file comes next, but widens nothing (QL-06): its
346
358
  * `permissions.fallback` applies only as default, plan or acceptEdits, its
347
359
  * `tools.extra` only for the tools the user settings list, its `dev.prAuto` and
348
- * `memory.autoAdmitAudited` 'true' only when the user settings say 'true'; what it
349
- * loses is returned as `ignored`. The user map is a required argument: a caller that forgets
360
+ * `memory.autoAdmitAudited` 'true' only when the user settings say 'true', its `paths.allow`
361
+ * only within the user's list; its `paths.deny` adds to the user's. What it loses is returned
362
+ * as `ignored`. The user map is a required argument: a caller that forgets
350
363
  * it must not read a project value unnarrowed. Unknown keys present in any map are
351
364
  * NOT returned — they can only be residue from before the schema existed, and
352
365
  * surfacing them as effective settings would suggest something reads them.
@@ -0,0 +1,176 @@
1
+ // The pruning of stale tool results inside a turn's tool loop (ADR 0027). Past a share of the context window, the
2
+ // runtime offers the older results of the read tools that ran (Orkeon #327): the host's decision model says, for
3
+ // each, whether it is still needed and whether it is needed whole, and the answer becomes a judgement: keep, head
4
+ // (the first characters) or drop. The model that decides sees the request and the calls (tool, input, size, age),
5
+ // never a result's content. A verdict answered to the runtime is final for the loop, `keep` included: a result
6
+ // judged needed is therefore left unanswered, and judged again once it has aged. Every number is stated with its
7
+ // reason. Pure.
8
+ import type { DecisionAnswers, DecisionQuestions } from "./decision/questions.ts";
9
+ import { yesNo } from "./decision/questions.ts";
10
+ import { CHARS_PER_TOKEN } from "./compaction-thresholds.ts";
11
+ import { PRUNE_JUDGE_THE_CALL, pruneCallLine, pruneNeededWhole, pruneStateText, pruneStillNeeded } from "./prompts.ts";
12
+
13
+ /** The setting that turns the pruning on: `on`, anything else is off. */
14
+ export const PRUNE_CONFIG_KEY = "compaction.prune";
15
+
16
+ /** The share of the window from which the loop's results are judged. The loop's messages never enter the session
17
+ * buffer, so no compaction relieves them: past the window the provider refuses the call. Under half the window,
18
+ * a turn that goes on reading keeps room for its next results and its answer. The runtime's measure (characters / 4,
19
+ * the tool schemas left out) is a floor, hence a share well under one. */
20
+ export const PRUNE_FILL_SHARE = 0.4;
21
+
22
+ /** The loop's last messages whose results are never offered: two model turns with up to two results each. */
23
+ export const PRUNE_KEEP_RECENT = 6;
24
+
25
+ /** What a `head` verdict keeps of a result: enough to recognise a file or a listing. */
26
+ export const PRUNE_HEAD_CHARS = 300;
27
+
28
+ /** Under this size a result is kept without asking: cutting it to PRUNE_HEAD_CHARS and its note frees nothing. */
29
+ export const PRUNE_MIN_RESULT_CHARS = 2 * PRUNE_HEAD_CHARS;
30
+
31
+ /** The probability of a yes from which a call counts as needed, or needed whole. */
32
+ export const PRUNE_KEEP_THRESHOLD = 0.5;
33
+
34
+ /** Calls judged by one request to the decision model: two questions each. */
35
+ export const PRUNE_BATCH_CALLS = 8;
36
+
37
+ /** Calls judged at one pressure, oldest first; the rest is offered again at the next model turn. */
38
+ export const PRUNE_MAX_CALLS = 3 * PRUNE_BATCH_CALLS;
39
+
40
+ /** Model turns a result judged needed waits before it is judged again: a judgement costs a request to the decision
41
+ * model, and what a task needs does not change at every tool call. */
42
+ export const PRUNE_REJUDGE_TURNS = 8;
43
+
44
+ /** The request and one call's input, as the decision model reads them, in characters. */
45
+ export const PRUNE_REQUEST_CHARS = 2_000;
46
+ export const PRUNE_INPUT_CHARS = 200;
47
+
48
+ /** What happens to one result: the runtime's `ContextPressureVerdict`. */
49
+ export type PruneVerdict = "keep" | "head" | "drop";
50
+
51
+ /** One tool call whose result may be pruned, as the runtime offers it. */
52
+ export interface PressureCall {
53
+ readonly id: string;
54
+ readonly name: string;
55
+ readonly input: unknown;
56
+ /** Characters of the result the model is shown. */
57
+ readonly resultChars: number;
58
+ /** Model turns since the call ran. */
59
+ readonly age: number;
60
+ }
61
+
62
+ /** What the runtime hands when the loop's messages pass the threshold. */
63
+ export interface ContextPressure {
64
+ readonly usedTokens: number;
65
+ readonly thresholdTokens: number;
66
+ readonly calls: ReadonlyArray<PressureCall>;
67
+ }
68
+
69
+ /** When the runtime asks, and what a `head` keeps: the runtime's `contextPressure` option. */
70
+ export interface PressureSettings {
71
+ thresholdTokens: number;
72
+ keepRecent: number;
73
+ headChars: number;
74
+ }
75
+
76
+ /** What a pressure pruned, for the line the log shows. */
77
+ export interface PruneTally {
78
+ judged: number;
79
+ dropped: number;
80
+ cut: number;
81
+ freedTokens: number;
82
+ }
83
+
84
+ /** Whether the setting's value turns the pruning on. */
85
+ export function pruneOn(value: string | null | undefined): boolean {
86
+ return (value ?? "").trim().toLowerCase() === "on";
87
+ }
88
+
89
+ /** The settings of a turn on a window of `window` tokens. */
90
+ export function pressureSettings(window: number): PressureSettings {
91
+ return {
92
+ thresholdTokens: Math.floor(window * PRUNE_FILL_SHARE),
93
+ keepRecent: PRUNE_KEEP_RECENT,
94
+ headChars: PRUNE_HEAD_CHARS,
95
+ };
96
+ }
97
+
98
+ /** Whether a result is large enough for a verdict to free something. */
99
+ export function worthJudging(call: PressureCall): boolean {
100
+ return call.resultChars > PRUNE_MIN_RESULT_CHARS;
101
+ }
102
+
103
+ function cut(text: string, max: number): string {
104
+ return text.length <= max ? text : `${text.slice(0, max)}...`;
105
+ }
106
+
107
+ function inputText(input: unknown): string {
108
+ try {
109
+ return cut(JSON.stringify(input) ?? "", PRUNE_INPUT_CHARS);
110
+ } catch {
111
+ return "";
112
+ }
113
+ }
114
+
115
+ /** Whether a result judged needed when its call was `keptAtAge` turns old is due for another judgement; one never
116
+ * judged (undefined) is. */
117
+ export function dueForJudging(call: PressureCall, keptAtAge: number | undefined): boolean {
118
+ return keptAtAge === undefined || call.age - keptAtAge >= PRUNE_REJUDGE_TURNS;
119
+ }
120
+
121
+ /** The state the decision model judges: the request, then the calls numbered from 1, oldest first. */
122
+ export function pruneState(request: string, calls: ReadonlyArray<PressureCall>): string {
123
+ const lines = calls.map((call, i) => pruneCallLine(i + 1, call.name, inputText(call.input), call.resultChars, call.age));
124
+ return pruneStateText(cut(request.trim(), PRUNE_REQUEST_CHARS), lines.join("\n"));
125
+ }
126
+
127
+ const neededName = (n: number): string => `needed_${n}`;
128
+ const wholeName = (n: number): string => `whole_${n}`;
129
+
130
+ /** Two yes/no questions per call, named by the call's number in the state. */
131
+ export function pruneQuestions(calls: ReadonlyArray<PressureCall>): DecisionQuestions {
132
+ const questions: Record<string, DecisionQuestions[string]> = {};
133
+ calls.forEach((_, i) => {
134
+ questions[neededName(i + 1)] = yesNo(pruneStillNeeded(i + 1), PRUNE_JUDGE_THE_CALL);
135
+ questions[wholeName(i + 1)] = yesNo(pruneNeededWhole(i + 1), PRUNE_JUDGE_THE_CALL);
136
+ });
137
+ return questions;
138
+ }
139
+
140
+ function yes(answers: DecisionAnswers, name: string): boolean | null {
141
+ const answer = answers[name];
142
+ return answer?.type === "noul" ? answer.probability >= PRUNE_KEEP_THRESHOLD : null;
143
+ }
144
+
145
+ /** The judgement of each call the answers settle, by call id: not needed, drop; needed but not whole, head; needed
146
+ * whole, keep. A call an answer is missing for is left out. */
147
+ export function pruneVerdicts(calls: ReadonlyArray<PressureCall>, answers: DecisionAnswers): Record<string, PruneVerdict> {
148
+ const verdicts: Record<string, PruneVerdict> = {};
149
+ calls.forEach((call, i) => {
150
+ const needed = yes(answers, neededName(i + 1));
151
+ const whole = yes(answers, wholeName(i + 1));
152
+ if (needed === null || whole === null) return;
153
+ verdicts[call.id] = !needed ? "drop" : whole ? "keep" : "head";
154
+ });
155
+ return verdicts;
156
+ }
157
+
158
+ /** What the verdicts free, the note a pruned result leaves counted as PRUNE_HEAD_CHARS. */
159
+ export function pruneTally(calls: ReadonlyArray<PressureCall>, verdicts: Readonly<Record<string, PruneVerdict>>): PruneTally {
160
+ const tally: PruneTally = { judged: 0, dropped: 0, cut: 0, freedTokens: 0 };
161
+ let freedChars = 0;
162
+ for (const call of calls) {
163
+ const verdict = verdicts[call.id];
164
+ if (verdict === undefined) continue;
165
+ tally.judged += 1;
166
+ if (verdict === "drop") {
167
+ tally.dropped += 1;
168
+ freedChars += Math.max(0, call.resultChars - PRUNE_HEAD_CHARS);
169
+ } else if (verdict === "head") {
170
+ tally.cut += 1;
171
+ freedChars += Math.max(0, call.resultChars - 2 * PRUNE_HEAD_CHARS);
172
+ }
173
+ }
174
+ tally.freedTokens = Math.floor(freedChars / CHARS_PER_TOKEN);
175
+ return tally;
176
+ }
@@ -0,0 +1,102 @@
1
+ // The questions asked of the host's decision model and the answers read back from it. A decision model answers
2
+ // typed questions about a state with calibrated numbers: one option among described ones, a level on a scale, the
3
+ // probability of a yes. Which model answers (the host's settings name it) is no concern of this module.
4
+
5
+ /** One option among described ones: `criteria` maps each option to what it means. */
6
+ export interface ChoiceDecision {
7
+ type: "choice";
8
+ criteria: Readonly<Record<string, string>>;
9
+ instructions?: string;
10
+ }
11
+
12
+ /** A level on a scale: `criteria` lists the levels, lowest first. */
13
+ export interface ScoreDecision {
14
+ type: "score";
15
+ criteria: readonly string[];
16
+ instructions?: string;
17
+ }
18
+
19
+ /** A yes or a no: `criteria.true` says what yes means. */
20
+ export interface YesNoDecision {
21
+ type: "noul";
22
+ criteria: { readonly true: string };
23
+ instructions?: string;
24
+ }
25
+
26
+ export type DecisionQuestion = ChoiceDecision | ScoreDecision | YesNoDecision;
27
+
28
+ /** The questions of one request, by name. */
29
+ export type DecisionQuestions = Readonly<Record<string, DecisionQuestion>>;
30
+
31
+ export type DecisionAnswer =
32
+ | { type: "choice"; choice: string; confidence: number; probabilities: Record<string, number> }
33
+ | { type: "score"; score: number; confidence: number }
34
+ | { type: "noul"; probability: number };
35
+
36
+ /** The answers of one request, by the name of their question. */
37
+ export type DecisionAnswers = Record<string, DecisionAnswer>;
38
+
39
+ /** A yes/no question: what yes means, and what is judged when it needs saying. */
40
+ export function yesNo(yes: string, instructions?: string): YesNoDecision {
41
+ return instructions === undefined ? { type: "noul", criteria: { true: yes } } : { type: "noul", criteria: { true: yes }, instructions };
42
+ }
43
+
44
+ function record(value: unknown): Record<string, unknown> | null {
45
+ return typeof value === "object" && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : null;
46
+ }
47
+
48
+ /** A number of [0, 1], or null. */
49
+ function share(value: unknown): number | null {
50
+ return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1 ? value : null;
51
+ }
52
+
53
+ function shares(value: unknown): Record<string, number> {
54
+ const out: Record<string, number> = {};
55
+ for (const [option, raw] of Object.entries(record(value) ?? {})) {
56
+ const p = share(raw);
57
+ if (p !== null) out[option] = p;
58
+ }
59
+ return out;
60
+ }
61
+
62
+ function answerOf(question: DecisionQuestion, raw: unknown): DecisionAnswer | null {
63
+ const answer = record(raw);
64
+ if (answer === null) return null;
65
+ if (question.type === "noul") {
66
+ const probability = share(answer.noul);
67
+ return probability === null ? null : { type: "noul", probability };
68
+ }
69
+ const confidence = share(answer.confidence);
70
+ if (confidence === null) return null;
71
+ if (question.type === "score") {
72
+ return typeof answer.score === "number" && Number.isFinite(answer.score) ? { type: "score", score: answer.score, confidence } : null;
73
+ }
74
+ const choice = answer.choice;
75
+ if (typeof choice !== "string" || !Object.hasOwn(question.criteria, choice)) return null;
76
+ return { type: "choice", choice, confidence, probabilities: shares(answer.probabilities) };
77
+ }
78
+
79
+ /**
80
+ * The answers of a decision model to `questions`, read from what it returned (an object by question name, or its
81
+ * JSON). Null unless every question has an answer of its own kind: a choice among the options asked, a score, a
82
+ * probability of [0, 1]. A caller that gets null does what it did without a decision model.
83
+ */
84
+ export function parseDecisionAnswers(questions: DecisionQuestions, raw: unknown): DecisionAnswers | null {
85
+ let value = raw;
86
+ if (typeof raw === "string") {
87
+ try {
88
+ value = JSON.parse(raw);
89
+ } catch {
90
+ return null;
91
+ }
92
+ }
93
+ const given = record(value);
94
+ if (given === null) return null;
95
+ const answers: DecisionAnswers = {};
96
+ for (const [name, question] of Object.entries(questions)) {
97
+ const answer = answerOf(question, given[name]);
98
+ if (answer === null) return null;
99
+ answers[name] = answer;
100
+ }
101
+ return answers;
102
+ }