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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (552) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -0
  3. package/LICENSE.md +21 -0
  4. package/NOTICE.md +17 -0
  5. package/README.fr.md +163 -0
  6. package/README.md +156 -2
  7. package/config/appsettings.anthropic.example.json +77 -0
  8. package/config/appsettings.example.json +71 -0
  9. package/config/appsettings.jev.example.json +131 -0
  10. package/config/appsettings.kev.example.json +133 -0
  11. package/config/appsettings.liquid.example.json +132 -0
  12. package/config/appsettings.ollama-whisper.example.json +93 -0
  13. package/config/appsettings.ollama.example.json +70 -0
  14. package/config/appsettings.whisper.example.json +32 -0
  15. package/mcp/whisper/README.md +294 -0
  16. package/mcp/whisper/pyproject.toml +32 -0
  17. package/mcp/whisper/uv.lock +1641 -0
  18. package/mcp/whisper/whisper_mcp.py +1053 -0
  19. package/orkeon-code +1092 -0
  20. package/orkeon-code.mjs +71 -0
  21. package/orkeon-code.ps1 +939 -0
  22. package/package.json +58 -4
  23. package/scripts/install.ps1 +156 -0
  24. package/scripts/install.sh +148 -0
  25. package/scripts/session-start.ork.ts +90 -0
  26. package/scripts/session-start.sh +74 -0
  27. package/scripts/setup-fixture.sh +88 -0
  28. package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
  29. package/src/commands/_lib/args.ts +194 -0
  30. package/src/commands/_lib/dev/dev-batches.ts +366 -0
  31. package/src/commands/_lib/dev/dev-implement.ts +185 -0
  32. package/src/commands/_lib/dev/dev-source.ts +61 -0
  33. package/src/commands/_lib/dev/dev.ts +341 -0
  34. package/src/commands/_lib/dev/markers.ts +7 -0
  35. package/src/commands/_lib/dev/messages.ts +112 -0
  36. package/src/commands/_lib/dev-step.ts +145 -0
  37. package/src/commands/_lib/dispatch.ts +254 -0
  38. package/src/commands/_lib/effort.ts +15 -0
  39. package/src/commands/_lib/git/branch.ts +94 -0
  40. package/src/commands/_lib/git/commit.ts +90 -0
  41. package/src/commands/_lib/git/diff.ts +107 -0
  42. package/src/commands/_lib/git/messages.ts +54 -0
  43. package/src/commands/_lib/git/review.ts +108 -0
  44. package/src/commands/_lib/memory/memory-admit.ts +148 -0
  45. package/src/commands/_lib/memory/memory.ts +52 -0
  46. package/src/commands/_lib/memory/messages.ts +32 -0
  47. package/src/commands/_lib/messages.ts +48 -0
  48. package/src/commands/_lib/pr-context.ts +32 -0
  49. package/src/commands/_lib/project/analyze.ts +24 -0
  50. package/src/commands/_lib/project/messages.ts +8 -0
  51. package/src/commands/_lib/session/export.ts +105 -0
  52. package/src/commands/_lib/session/messages.ts +87 -0
  53. package/src/commands/_lib/session/prompts.ts +4 -0
  54. package/src/commands/_lib/session/resume.ts +151 -0
  55. package/src/commands/_lib/session/tasks.ts +181 -0
  56. package/src/commands/_lib/settings/advisor.ts +75 -0
  57. package/src/commands/_lib/settings/agents.ts +137 -0
  58. package/src/commands/_lib/settings/choices.ts +8 -0
  59. package/src/commands/_lib/settings/config.ts +141 -0
  60. package/src/commands/_lib/settings/effort.ts +147 -0
  61. package/src/commands/_lib/settings/hooks.ts +50 -0
  62. package/src/commands/_lib/settings/messages.ts +408 -0
  63. package/src/commands/_lib/settings/mode.ts +100 -0
  64. package/src/commands/_lib/settings/model.ts +181 -0
  65. package/src/commands/_lib/settings/output-style.ts +39 -0
  66. package/src/commands/_lib/settings/permissions.ts +287 -0
  67. package/src/commands/_lib/settings/route.ts +63 -0
  68. package/src/commands/_lib/settings/session-config.ts +49 -0
  69. package/src/commands/_lib/settings/skills.ts +93 -0
  70. package/src/commands/_lib/settings/theme.ts +42 -0
  71. package/src/commands/_lib/speech/messages.ts +58 -0
  72. package/src/commands/_lib/speech/prompts.ts +4 -0
  73. package/src/commands/_lib/speech/say.ts +95 -0
  74. package/src/commands/_lib/speech/transcribe.ts +121 -0
  75. package/src/commands/_lib/speech/voice.ts +142 -0
  76. package/src/commands/_lib/status/cache.ts +31 -0
  77. package/src/commands/_lib/status/context.ts +57 -0
  78. package/src/commands/_lib/status/doctor.ts +205 -0
  79. package/src/commands/_lib/status/messages.ts +100 -0
  80. package/src/commands/_lib/status/meta.ts +24 -0
  81. package/src/commands/_lib/status/status.ts +128 -0
  82. package/src/commands/_lib/status/usage-tools.ts +48 -0
  83. package/src/commands/_lib/status/usage.ts +128 -0
  84. package/src/commands/_lib/view.ts +34 -0
  85. package/src/commands/dev/dev-batches.cmd.ts +109 -0
  86. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  87. package/src/commands/dev/dev-plan.cmd.ts +51 -0
  88. package/src/commands/dev/dev-spec.cmd.ts +54 -0
  89. package/src/commands/dev/dev-status.cmd.ts +16 -0
  90. package/src/commands/git/branch.cmd.ts +27 -0
  91. package/src/commands/git/commit.cmd.ts +48 -0
  92. package/src/commands/git/diff.cmd.ts +26 -0
  93. package/src/commands/git/review.cmd.ts +36 -0
  94. package/src/commands/memory/memory.cmd.ts +48 -0
  95. package/src/commands/project/analyze.cmd.ts +32 -0
  96. package/src/commands/project/debug-tool-call.cmd.ts +62 -0
  97. package/src/commands/project/files.cmd.ts +22 -0
  98. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  99. package/src/commands/project/init.cmd.ts +14 -0
  100. package/src/commands/project/verify.cmd.ts +27 -0
  101. package/src/commands/session/assistant.cmd.ts +40 -0
  102. package/src/commands/session/btw.cmd.ts +18 -0
  103. package/src/commands/session/clear.cmd.ts +19 -0
  104. package/src/commands/session/compact.cmd.ts +16 -0
  105. package/src/commands/session/copy.cmd.ts +45 -0
  106. package/src/commands/session/exit.cmd.ts +9 -0
  107. package/src/commands/session/export.cmd.ts +28 -0
  108. package/src/commands/session/rename.cmd.ts +18 -0
  109. package/src/commands/session/resume.cmd.ts +19 -0
  110. package/src/commands/session/rewind.cmd.ts +25 -0
  111. package/src/commands/session/summary.cmd.ts +27 -0
  112. package/src/commands/session/tasks.cmd.ts +46 -0
  113. package/src/commands/settings/advisor.cmd.ts +38 -0
  114. package/src/commands/settings/agents.cmd.ts +19 -0
  115. package/src/commands/settings/config.cmd.ts +19 -0
  116. package/src/commands/settings/effort.cmd.ts +19 -0
  117. package/src/commands/settings/fast.cmd.ts +18 -0
  118. package/src/commands/settings/hooks.cmd.ts +17 -0
  119. package/src/commands/settings/mode.cmd.ts +20 -0
  120. package/src/commands/settings/model.cmd.ts +21 -0
  121. package/src/commands/settings/output-style.cmd.ts +19 -0
  122. package/src/commands/settings/permissions.cmd.ts +25 -0
  123. package/src/commands/settings/proactive.cmd.ts +16 -0
  124. package/src/commands/settings/route.cmd.ts +16 -0
  125. package/src/commands/settings/skills.cmd.ts +17 -0
  126. package/src/commands/settings/theme.cmd.ts +14 -0
  127. package/src/commands/speech/say.cmd.ts +24 -0
  128. package/src/commands/speech/transcribe.cmd.ts +29 -0
  129. package/src/commands/speech/voice.cmd.ts +30 -0
  130. package/src/commands/status/context.cmd.ts +18 -0
  131. package/src/commands/status/doctor.cmd.ts +27 -0
  132. package/src/commands/status/release-notes.cmd.ts +9 -0
  133. package/src/commands/status/status.cmd.ts +25 -0
  134. package/src/commands/status/usage.cmd.ts +21 -0
  135. package/src/crews/.orkeon/orkeon.d.ts +4391 -0
  136. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  137. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
  138. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  139. package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
  140. package/src/crews/advisor/application/messages.ts +4 -0
  141. package/src/crews/advisor/application/prompts.ts +4 -0
  142. package/src/crews/advisor/application/run-advisor.ts +41 -0
  143. package/src/crews/advisor/crew.ork.ts +44 -0
  144. package/src/crews/advisor/domain/advice.ts +119 -0
  145. package/src/crews/advisor/domain/messages.ts +8 -0
  146. package/src/crews/advisor/domain/prompts.ts +26 -0
  147. package/src/crews/agent-run/application/messages.ts +18 -0
  148. package/src/crews/agent-run/application/run-agent-run.ts +43 -0
  149. package/src/crews/agent-run/crew.ork.ts +67 -0
  150. package/src/crews/analyze/application/messages.ts +27 -0
  151. package/src/crews/analyze/application/prompts.ts +4 -0
  152. package/src/crews/analyze/application/run-analyze.ts +120 -0
  153. package/src/crews/analyze/crew.ork.ts +41 -0
  154. package/src/crews/analyze/domain/harvest.ts +269 -0
  155. package/src/crews/analyze/domain/prompts.ts +86 -0
  156. package/src/crews/code-review/application/lens-material.ts +24 -0
  157. package/src/crews/code-review/application/messages.ts +17 -0
  158. package/src/crews/code-review/application/prompts.ts +126 -0
  159. package/src/crews/code-review/application/review.ts +74 -0
  160. package/src/crews/code-review/application/run-code-review.ts +121 -0
  161. package/src/crews/code-review/crew.ork.ts +52 -0
  162. package/src/crews/code-review/domain/lenses.ts +154 -0
  163. package/src/crews/code-review/domain/messages.ts +25 -0
  164. package/src/crews/code-review/domain/prompts.ts +58 -0
  165. package/src/crews/code-review/domain/report.ts +58 -0
  166. package/src/crews/code-review/domain/scope.ts +106 -0
  167. package/src/crews/dev-batches/application/messages.ts +127 -0
  168. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  169. package/src/crews/dev-batches/application/prompts.ts +10 -0
  170. package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
  171. package/src/crews/dev-batches/application/run-wave.ts +452 -0
  172. package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
  173. package/src/crews/dev-batches/crew.ork.ts +146 -0
  174. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  175. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  176. package/src/crews/dev-batches/domain/batches-log.ts +52 -0
  177. package/src/crews/dev-batches/domain/markers.ts +5 -0
  178. package/src/crews/dev-batches/domain/messages.ts +6 -0
  179. package/src/crews/dev-batches/domain/wave-order.ts +44 -0
  180. package/src/crews/dev-change/application/change-material.ts +44 -0
  181. package/src/crews/dev-change/application/evidence.ts +172 -0
  182. package/src/crews/dev-change/application/messages.ts +81 -0
  183. package/src/crews/dev-change/application/prompts.ts +101 -0
  184. package/src/crews/dev-change/application/run-dev-change.ts +324 -0
  185. package/src/crews/dev-change/crew.ork.ts +114 -0
  186. package/src/crews/dev-change/domain/change-answer.ts +163 -0
  187. package/src/crews/dev-change/domain/change-render.ts +77 -0
  188. package/src/crews/dev-change/domain/markers.ts +28 -0
  189. package/src/crews/dev-change/domain/messages.ts +16 -0
  190. package/src/crews/dev-implement/application/close.ts +186 -0
  191. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  192. package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
  193. package/src/crews/dev-implement/application/messages.ts +161 -0
  194. package/src/crews/dev-implement/application/observe.ts +52 -0
  195. package/src/crews/dev-implement/application/prompts.ts +9 -0
  196. package/src/crews/dev-implement/application/report-writes.ts +46 -0
  197. package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
  198. package/src/crews/dev-implement/application/run-role.ts +27 -0
  199. package/src/crews/dev-implement/application/suite-job.ts +122 -0
  200. package/src/crews/dev-implement/application/touched.ts +74 -0
  201. package/src/crews/dev-implement/crew.ork.ts +69 -0
  202. package/src/crews/dev-implement/domain/contracts.ts +255 -0
  203. package/src/crews/dev-implement/domain/correction.ts +103 -0
  204. package/src/crews/dev-implement/domain/cycles.ts +36 -0
  205. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  206. package/src/crews/dev-implement/domain/markers.ts +23 -0
  207. package/src/crews/dev-implement/domain/messages.ts +58 -0
  208. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  209. package/src/crews/dev-implement/domain/roles.ts +49 -0
  210. package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
  211. package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
  212. package/src/crews/dev-implement/domain/step-checks.ts +137 -0
  213. package/src/crews/dev-implement/domain/step-section.ts +129 -0
  214. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  215. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  216. package/src/crews/dev-learn/application/messages.ts +51 -0
  217. package/src/crews/dev-learn/application/prompts.ts +99 -0
  218. package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
  219. package/src/crews/dev-learn/crew.ork.ts +53 -0
  220. package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
  221. package/src/crews/dev-learn/domain/messages.ts +65 -0
  222. package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
  223. package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
  224. package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
  225. package/src/crews/dev-plan/application/inventory.ts +174 -0
  226. package/src/crews/dev-plan/application/messages.ts +88 -0
  227. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  228. package/src/crews/dev-plan/application/prompts.ts +141 -0
  229. package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
  230. package/src/crews/dev-plan/crew.ork.ts +112 -0
  231. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  232. package/src/crews/dev-plan/domain/markers.ts +18 -0
  233. package/src/crews/dev-plan/domain/messages.ts +118 -0
  234. package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
  235. package/src/crews/dev-plan/domain/plan-render.ts +306 -0
  236. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  237. package/src/crews/dev-spec/application/messages.ts +30 -0
  238. package/src/crews/dev-spec/application/prompts.ts +93 -0
  239. package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
  240. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  241. package/src/crews/dev-spec/crew.ork.ts +110 -0
  242. package/src/crews/dev-spec/domain/markers.ts +30 -0
  243. package/src/crews/dev-spec/domain/messages.ts +39 -0
  244. package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
  245. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  246. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  247. package/src/crews/dev-verify/application/audit.ts +267 -0
  248. package/src/crews/dev-verify/application/capture.ts +311 -0
  249. package/src/crews/dev-verify/application/messages.ts +119 -0
  250. package/src/crews/dev-verify/application/prompts.ts +209 -0
  251. package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
  252. package/src/crews/dev-verify/application/run-gate.ts +204 -0
  253. package/src/crews/dev-verify/crew.ork.ts +103 -0
  254. package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
  255. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  256. package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
  257. package/src/crews/dev-verify/domain/commands.ts +103 -0
  258. package/src/crews/dev-verify/domain/gate.ts +131 -0
  259. package/src/crews/dev-verify/domain/markers.ts +16 -0
  260. package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
  261. package/src/crews/dev-verify/domain/messages.ts +92 -0
  262. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  263. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  264. package/src/crews/dev-verify/domain/text.ts +20 -0
  265. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  266. package/src/crews/git-commit/application/draft.ts +133 -0
  267. package/src/crews/git-commit/application/messages.ts +15 -0
  268. package/src/crews/git-commit/application/prompts.ts +47 -0
  269. package/src/crews/git-commit/application/run-git-commit.ts +117 -0
  270. package/src/crews/git-commit/crew.ork.ts +53 -0
  271. package/src/crews/git-commit/domain/commit.ts +200 -0
  272. package/src/crews/git-commit/domain/markers.ts +4 -0
  273. package/src/crews/git-commit/domain/messages.ts +48 -0
  274. package/src/crews/init-verifiers/application/authoring.ts +90 -0
  275. package/src/crews/init-verifiers/application/messages.ts +13 -0
  276. package/src/crews/init-verifiers/application/prompts.ts +107 -0
  277. package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
  278. package/src/crews/init-verifiers/crew.ork.ts +35 -0
  279. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  280. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  281. package/src/crews/main-loop/application/auto-compact.ts +78 -0
  282. package/src/crews/main-loop/application/context-gather.ts +133 -0
  283. package/src/crews/main-loop/application/messages.ts +81 -0
  284. package/src/crews/main-loop/application/prompts.ts +12 -0
  285. package/src/crews/main-loop/application/run-main-loop.ts +383 -0
  286. package/src/crews/main-loop/application/turn-context.ts +111 -0
  287. package/src/crews/main-loop/crew.ork.ts +124 -0
  288. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  289. package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
  290. package/src/crews/main-loop/domain/prompts.ts +336 -0
  291. package/src/crews/main-loop/domain/turn-chains.ts +130 -0
  292. package/src/crews/project-init/application/detect.ts +123 -0
  293. package/src/crews/project-init/application/messages.ts +15 -0
  294. package/src/crews/project-init/application/prompts.ts +105 -0
  295. package/src/crews/project-init/application/run-project-init.ts +31 -0
  296. package/src/crews/project-init/crew.ork.ts +36 -0
  297. package/src/crews/project-init/domain/conventions.ts +36 -0
  298. package/src/crews/project-init/domain/existing-files.ts +65 -0
  299. package/src/crews/project-init/domain/messages.ts +13 -0
  300. package/src/crews/project-init/domain/package-map.ts +73 -0
  301. package/src/crews/project-init/domain/prompts.ts +10 -0
  302. package/src/crews/session-compact/application/prompts.ts +5 -0
  303. package/src/crews/session-compact/crew.ork.ts +56 -0
  304. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  305. package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
  306. package/src/crews/speech/application/messages.ts +3 -0
  307. package/src/crews/speech/application/prompts.ts +3 -0
  308. package/src/crews/speech/application/run-speech.ts +26 -0
  309. package/src/crews/speech/crew.ork.ts +38 -0
  310. package/src/shared/application/agents/child-agent.ts +259 -0
  311. package/src/shared/application/agents/messages.ts +35 -0
  312. package/src/shared/application/agents/route-agent.ts +115 -0
  313. package/src/shared/application/agents/run-sub-agent.ts +119 -0
  314. package/src/shared/application/answer-language.ts +14 -0
  315. package/src/shared/application/attached-skills.ts +36 -0
  316. package/src/shared/application/compaction/compact-session.ts +242 -0
  317. package/src/shared/application/compaction/extract-memories.ts +38 -0
  318. package/src/shared/application/compaction/messages.ts +20 -0
  319. package/src/shared/application/compaction/prune-context.ts +94 -0
  320. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  321. package/src/shared/application/compaction/restore-context.ts +78 -0
  322. package/src/shared/application/config-store.ts +123 -0
  323. package/src/shared/application/dev/brief-inventory.ts +115 -0
  324. package/src/shared/application/dev/close-batch.ts +85 -0
  325. package/src/shared/application/dev/find-repo-pack.ts +78 -0
  326. package/src/shared/application/dev/learn-decision.ts +254 -0
  327. package/src/shared/application/dev/load-dev-context.ts +265 -0
  328. package/src/shared/application/dev/measure-access-cost.ts +69 -0
  329. package/src/shared/application/dev/messages.ts +132 -0
  330. package/src/shared/application/dev/phase-timer.ts +54 -0
  331. package/src/shared/application/dev/plan-source.ts +116 -0
  332. package/src/shared/application/dev/preflight.ts +71 -0
  333. package/src/shared/application/dev/project-files.ts +17 -0
  334. package/src/shared/application/dev/prompts.ts +34 -0
  335. package/src/shared/application/dev/question-round.ts +60 -0
  336. package/src/shared/application/dev/resolve-work-folder.ts +134 -0
  337. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  338. package/src/shared/application/dev/settle-questions.ts +57 -0
  339. package/src/shared/application/dev/source-review.ts +67 -0
  340. package/src/shared/application/dev/source-step.ts +152 -0
  341. package/src/shared/application/dev/spend.ts +55 -0
  342. package/src/shared/application/dev/step-precedents.ts +90 -0
  343. package/src/shared/application/dev/tool-call-policy.ts +87 -0
  344. package/src/shared/application/dev/tool-callbacks.ts +262 -0
  345. package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
  346. package/src/shared/application/dev/verdict-sources.ts +50 -0
  347. package/src/shared/application/dev/wrapped-tools.ts +147 -0
  348. package/src/shared/application/extra-tools.ts +71 -0
  349. package/src/shared/application/git/batch-worktree.ts +102 -0
  350. package/src/shared/application/git/commit-files.ts +191 -0
  351. package/src/shared/application/git/merge-batch.ts +67 -0
  352. package/src/shared/application/git/messages.ts +75 -0
  353. package/src/shared/application/git/open-pull-request.ts +52 -0
  354. package/src/shared/application/host-context.ts +59 -0
  355. package/src/shared/application/host-layout-store.ts +45 -0
  356. package/src/shared/application/instructions-file.ts +19 -0
  357. package/src/shared/application/json-file.ts +34 -0
  358. package/src/shared/application/llm-profile.ts +36 -0
  359. package/src/shared/application/messages.ts +14 -0
  360. package/src/shared/application/permission-rules.ts +169 -0
  361. package/src/shared/application/ports/approvals.ts +20 -0
  362. package/src/shared/application/ports/clock.ts +5 -0
  363. package/src/shared/application/ports/code-index.ts +93 -0
  364. package/src/shared/application/ports/crew.ts +60 -0
  365. package/src/shared/application/ports/decision.ts +14 -0
  366. package/src/shared/application/ports/files.ts +21 -0
  367. package/src/shared/application/ports/human.ts +38 -0
  368. package/src/shared/application/ports/llm.ts +83 -0
  369. package/src/shared/application/ports/memory.ts +30 -0
  370. package/src/shared/application/ports/progress.ts +23 -0
  371. package/src/shared/application/ports/runtime.ts +15 -0
  372. package/src/shared/application/ports/session.ts +74 -0
  373. package/src/shared/application/ports/shared-memory.ts +26 -0
  374. package/src/shared/application/ports/shell.ts +40 -0
  375. package/src/shared/application/ports/telemetry.ts +45 -0
  376. package/src/shared/application/ports/theme.ts +11 -0
  377. package/src/shared/application/ports/tools.ts +46 -0
  378. package/src/shared/application/ports/usage.ts +45 -0
  379. package/src/shared/application/ports.ts +29 -0
  380. package/src/shared/application/project-manifests.ts +106 -0
  381. package/src/shared/application/session-io.ts +85 -0
  382. package/src/shared/application/session-state.ts +36 -0
  383. package/src/shared/application/shared-memory/admit-entries.ts +179 -0
  384. package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
  385. package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
  386. package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
  387. package/src/shared/application/shared-memory/memory-files.ts +111 -0
  388. package/src/shared/application/shared-memory/memory-settings.ts +94 -0
  389. package/src/shared/application/shared-memory/messages.ts +63 -0
  390. package/src/shared/application/shared-memory/push-candidate.ts +149 -0
  391. package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
  392. package/src/shared/application/skills/messages.ts +4 -0
  393. package/src/shared/application/skills/suggest-skills.ts +102 -0
  394. package/src/shared/application/state-snapshot.ts +38 -0
  395. package/src/shared/application/workflow/messages.ts +8 -0
  396. package/src/shared/application/workflow/workflow-state.ts +136 -0
  397. package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
  398. package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
  399. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  400. package/src/shared/domain/agent-policy/messages.ts +66 -0
  401. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  402. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  403. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  404. package/src/shared/domain/agent-policy/permission.ts +625 -0
  405. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  406. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  407. package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
  408. package/src/shared/domain/agent-policy/tool-access.ts +91 -0
  409. package/src/shared/domain/agent-registry.ts +143 -0
  410. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  411. package/src/shared/domain/agents/chain.ts +30 -0
  412. package/src/shared/domain/agents/charter.ts +64 -0
  413. package/src/shared/domain/agents/exclusive.ts +25 -0
  414. package/src/shared/domain/agents/instances.ts +252 -0
  415. package/src/shared/domain/agents/messages.ts +39 -0
  416. package/src/shared/domain/agents/model-route.ts +199 -0
  417. package/src/shared/domain/agents/prompts.ts +20 -0
  418. package/src/shared/domain/code-intel-contract.ts +357 -0
  419. package/src/shared/domain/code-intel-routing.ts +60 -0
  420. package/src/shared/domain/compact-outcome.ts +46 -0
  421. package/src/shared/domain/compaction-thresholds.ts +162 -0
  422. package/src/shared/domain/compaction.ts +288 -0
  423. package/src/shared/domain/config-schema.ts +434 -0
  424. package/src/shared/domain/context-prune.ts +176 -0
  425. package/src/shared/domain/decision/questions.ts +102 -0
  426. package/src/shared/domain/dev/access-cost.ts +230 -0
  427. package/src/shared/domain/dev/artefacts.ts +50 -0
  428. package/src/shared/domain/dev/batches-concurrency.ts +35 -0
  429. package/src/shared/domain/dev/batches-state.ts +49 -0
  430. package/src/shared/domain/dev/build-commands.ts +45 -0
  431. package/src/shared/domain/dev/call-guard.ts +342 -0
  432. package/src/shared/domain/dev/carried-text.ts +47 -0
  433. package/src/shared/domain/dev/design-rules.ts +100 -0
  434. package/src/shared/domain/dev/learn-proposals.ts +176 -0
  435. package/src/shared/domain/dev/learn-state.ts +94 -0
  436. package/src/shared/domain/dev/markers.ts +107 -0
  437. package/src/shared/domain/dev/messages.ts +259 -0
  438. package/src/shared/domain/dev/path-args.ts +42 -0
  439. package/src/shared/domain/dev/path-rebase.ts +93 -0
  440. package/src/shared/domain/dev/phase-timing.ts +50 -0
  441. package/src/shared/domain/dev/plan-checks.ts +191 -0
  442. package/src/shared/domain/dev/plan-format.ts +170 -0
  443. package/src/shared/domain/dev/project-files.ts +29 -0
  444. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  445. package/src/shared/domain/dev/prompts.ts +251 -0
  446. package/src/shared/domain/dev/questions.ts +267 -0
  447. package/src/shared/domain/dev/reading-rule.ts +41 -0
  448. package/src/shared/domain/dev/repo-pack.ts +240 -0
  449. package/src/shared/domain/dev/review-answer.ts +173 -0
  450. package/src/shared/domain/dev/review-brief.ts +54 -0
  451. package/src/shared/domain/dev/reviewer-charter.ts +35 -0
  452. package/src/shared/domain/dev/sheet-facts.ts +81 -0
  453. package/src/shared/domain/dev/spec-format.ts +182 -0
  454. package/src/shared/domain/dev/step-budget.ts +74 -0
  455. package/src/shared/domain/dev/step-rules.ts +109 -0
  456. package/src/shared/domain/dev/test-commands.ts +94 -0
  457. package/src/shared/domain/dev/test-output.ts +33 -0
  458. package/src/shared/domain/dev/test-paths.ts +40 -0
  459. package/src/shared/domain/dev/tool-guards.ts +65 -0
  460. package/src/shared/domain/dev/trait-pattern.ts +87 -0
  461. package/src/shared/domain/dev/verdict-format.ts +162 -0
  462. package/src/shared/domain/dev/whitespace.ts +35 -0
  463. package/src/shared/domain/dev/work-folder.ts +68 -0
  464. package/src/shared/domain/dev/yaml-subset.ts +385 -0
  465. package/src/shared/domain/error-text.ts +13 -0
  466. package/src/shared/domain/git/close.ts +274 -0
  467. package/src/shared/domain/git/messages.ts +20 -0
  468. package/src/shared/domain/git/pull-request.ts +96 -0
  469. package/src/shared/domain/git/worktree.ts +46 -0
  470. package/src/shared/domain/host-layout.ts +147 -0
  471. package/src/shared/domain/host-paths.ts +399 -0
  472. package/src/shared/domain/index-languages.ts +16 -0
  473. package/src/shared/domain/instructions-file.ts +18 -0
  474. package/src/shared/domain/iso-day.ts +4 -0
  475. package/src/shared/domain/llm-failure.ts +134 -0
  476. package/src/shared/domain/llm-profile.ts +44 -0
  477. package/src/shared/domain/marked-message.ts +29 -0
  478. package/src/shared/domain/markers.ts +30 -0
  479. package/src/shared/domain/messages.ts +291 -0
  480. package/src/shared/domain/model-catalog.ts +79 -0
  481. package/src/shared/domain/permission-modes.ts +99 -0
  482. package/src/shared/domain/prelude.ts +92 -0
  483. package/src/shared/domain/project-manifests.ts +84 -0
  484. package/src/shared/domain/prompts.ts +233 -0
  485. package/src/shared/domain/search-routing.ts +77 -0
  486. package/src/shared/domain/secret-patterns.ts +46 -0
  487. package/src/shared/domain/session-keys.ts +92 -0
  488. package/src/shared/domain/session-start.ts +61 -0
  489. package/src/shared/domain/severity.ts +72 -0
  490. package/src/shared/domain/sha1.ts +61 -0
  491. package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
  492. package/src/shared/domain/shared-memory/candidates.ts +40 -0
  493. package/src/shared/domain/shared-memory/entry.ts +151 -0
  494. package/src/shared/domain/shared-memory/front-matter.ts +187 -0
  495. package/src/shared/domain/shared-memory/gate.ts +45 -0
  496. package/src/shared/domain/shared-memory/harvest.ts +64 -0
  497. package/src/shared/domain/shared-memory/layout.ts +190 -0
  498. package/src/shared/domain/shared-memory/markers.ts +9 -0
  499. package/src/shared/domain/shared-memory/messages.ts +66 -0
  500. package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
  501. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  502. package/src/shared/domain/shared-memory/refused.ts +84 -0
  503. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  504. package/src/shared/domain/skills/prompts.ts +4 -0
  505. package/src/shared/domain/skills/shortlist.ts +149 -0
  506. package/src/shared/domain/snip-turns.ts +33 -0
  507. package/src/shared/domain/speech.ts +21 -0
  508. package/src/shared/domain/strip.ts +88 -0
  509. package/src/shared/domain/tool-trace.ts +120 -0
  510. package/src/shared/domain/types.ts +67 -0
  511. package/src/shared/domain/verifiers.ts +33 -0
  512. package/src/shared/domain/vfs.ts +16 -0
  513. package/src/shared/domain/workflow/prompts.ts +15 -0
  514. package/src/shared/domain/workflow/state-file.ts +142 -0
  515. package/src/shared/infrastructure/globals.ts +57 -0
  516. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  517. package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
  518. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  519. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  520. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  521. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  522. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  523. package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
  524. package/src/shared/infrastructure/orkeon/files.ts +58 -0
  525. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
  526. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  527. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  528. package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
  529. package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
  530. package/src/shared/infrastructure/orkeon/llm.ts +164 -0
  531. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  532. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  533. package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
  534. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  535. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  536. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  537. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  538. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  539. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  540. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  541. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  542. package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
  543. package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
  544. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  545. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  546. package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
  547. package/src/shared/infrastructure/orkeon/shell.ts +39 -0
  548. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  549. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
  550. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  551. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  552. package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
@@ -0,0 +1,434 @@
1
+ // Pure /config key space and layering — no IO.
2
+ //
3
+ // B-6: the original's `/config` operates over a VALIDATED key space with
4
+ // settings-file persistence (baseline 04 §/config). Exp07's was a free-form
5
+ // session map: any key was accepted, nothing survived `/clear`, and a
6
+ // typo'd key was indistinguishable from a real one — it was simply stored and
7
+ // never read by anything.
8
+ //
9
+ // A typo mattering silently is not hypothetical here: B-2 introduced
10
+ // `permissions.fallback`, whose whole job is to loosen or tighten the session's
11
+ // permission posture. `/config set permissions.fallbck bypassPermissions` used to
12
+ // report success and change nothing.
13
+
14
+ import { PERMISSION_FALLBACK_CONFIG_KEY, PERMISSION_MODES } from "./permission-modes.ts";
15
+ import {
16
+ EXTRA_TOOLS_CONFIG_KEY, extraToolsProblem, formatExtraTool, parseExtraTools,
17
+ } from "./agent-policy/extra-tools.ts";
18
+ import { sameToolName } from "./agent-policy/permission.ts";
19
+ import { VOICE_REPLY_CONFIG_KEY } from "./speech.ts";
20
+ import { ANSWER_LANGUAGE_CONFIG_KEY } from "./agent-policy/output-styles.ts";
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";
25
+ import { DEV_WORK_DIR_CONFIG_KEY, workFolderProblem } from "./dev/work-folder.ts";
26
+ import { DEV_PR_AUTO_CONFIG_KEY } from "./git/close.ts";
27
+ import { LLM_PROFILE_CONFIG_KEY, llmProfileProblem } from "./llm-profile.ts";
28
+ import {
29
+ MEMORY_AUTO_ADMIT_CONFIG_KEY, MEMORY_DIR_CONFIG_KEY, MEMORY_PROJECT_CONFIG_KEY, memoryDirProblem, memoryProjectProblem,
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";
41
+
42
+ export interface ConfigKeySpec {
43
+ key: string;
44
+ description: string;
45
+ /** Allowed values; omitted = any non-empty string. */
46
+ allowed?: readonly string[];
47
+ /** Why a value is refused, for a key whose values have a notation; undefined = valid. */
48
+ problem?: (value: string) => string | undefined;
49
+ /** Who reads the value, as the user meets it — the commands, and the crew when
50
+ * one reads it — so `/config keys` can say what a setting changes. */
51
+ consumedBy: string;
52
+ }
53
+
54
+ /**
55
+ * The declared key space. Adding a key here is what makes it settable — and the
56
+ * point is that the list is short and every entry names its consumer. A key
57
+ * nothing reads is a key that should not be settable.
58
+ */
59
+ export const CONFIG_KEYS: readonly ConfigKeySpec[] = [
60
+ {
61
+ key: PERMISSION_FALLBACK_CONFIG_KEY,
62
+ ...PERMISSION_FALLBACK_DOC,
63
+ allowed: PERMISSION_MODES,
64
+ },
65
+ {
66
+ key: "review.lenses",
67
+ ...REVIEW_LENSES_DOC,
68
+ },
69
+ {
70
+ key: "advisor.model",
71
+ ...ADVISOR_MODEL_DOC,
72
+ },
73
+ {
74
+ key: LLM_PROFILE_CONFIG_KEY,
75
+ ...LLM_PROFILE_DOC,
76
+ problem: llmProfileProblem,
77
+ },
78
+ {
79
+ key: "commit.requireConfirm",
80
+ ...COMMIT_REQUIRE_CONFIRM_DOC,
81
+ allowed: ["true", "false"],
82
+ },
83
+ {
84
+ key: "spinnerVerbs",
85
+ ...SPINNER_VERBS_DOC,
86
+ },
87
+ {
88
+ key: EXTRA_TOOLS_CONFIG_KEY,
89
+ ...EXTRA_TOOLS_DOC,
90
+ problem: extraToolsProblem,
91
+ },
92
+ {
93
+ key: VOICE_REPLY_CONFIG_KEY,
94
+ ...VOICE_REPLY_DOC,
95
+ allowed: ["on", "off"],
96
+ },
97
+ {
98
+ key: ANSWER_LANGUAGE_CONFIG_KEY,
99
+ ...ANSWER_LANGUAGE_DOC,
100
+ },
101
+ {
102
+ key: COMPACTION_TRIGGER_CONFIG_KEY,
103
+ ...COMPACTION_TRIGGER_DOC,
104
+ problem: compactionTriggerProblem,
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"],
125
+ },
126
+ {
127
+ key: DEV_WORK_DIR_CONFIG_KEY,
128
+ ...DEV_WORK_DIR_DOC,
129
+ problem: workFolderProblem,
130
+ },
131
+ {
132
+ key: DEV_PR_AUTO_CONFIG_KEY,
133
+ ...DEV_PR_AUTO_DOC,
134
+ allowed: ["true", "false"],
135
+ },
136
+ {
137
+ key: MEMORY_DIR_CONFIG_KEY,
138
+ ...MEMORY_DIR_DOC,
139
+ problem: memoryDirProblem,
140
+ },
141
+ {
142
+ key: MEMORY_PROJECT_CONFIG_KEY,
143
+ ...MEMORY_PROJECT_DOC,
144
+ problem: memoryProjectProblem,
145
+ },
146
+ {
147
+ key: MEMORY_AUTO_ADMIT_CONFIG_KEY,
148
+ ...MEMORY_AUTO_ADMIT_DOC,
149
+ allowed: ["true", "false"],
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,
160
+ },
161
+ ];
162
+
163
+ /** Where an effective value came from: the session bag, the project's settings file
164
+ * (`file`), the user settings the launcher mounts read-only (`user`), or nowhere. */
165
+ export type ConfigSource = "session" | "file" | "user" | "unset";
166
+
167
+ export interface ConfigResolution {
168
+ key: string;
169
+ value: string | undefined;
170
+ source: ConfigSource;
171
+ /** The project file's value, or the part of it, set aside because a project file
172
+ * widens nothing (QL-06), and why. */
173
+ ignored?: { value: string; reason: string };
174
+ }
175
+
176
+ /** The modes a project file may set as the fallback; a wider one comes from the user. */
177
+ export const PROJECT_FALLBACK_MODES: readonly string[] = ["default", "plan", "acceptEdits"];
178
+
179
+ /** What a project value leaves in force once narrowed: the value that applies (undefined
180
+ * = none, the user's then applies only when `fallThrough`), and what was set aside. */
181
+ interface Narrowed {
182
+ value: string | undefined;
183
+ fallThrough: boolean;
184
+ ignored?: { value: string; reason: string };
185
+ }
186
+
187
+ /** How far a fallback mode lets a session act without asking: the read-only modes
188
+ * first. A mode that is not one ranks as `default`, which it resolves to. */
189
+ const MODE_WIDTH: Readonly<Record<string, number>> = {
190
+ plan: 0, dontAsk: 0, default: 1, acceptEdits: 2, bypassPermissions: 3,
191
+ };
192
+ const modeWidth = (mode: string): number => MODE_WIDTH[mode] ?? MODE_WIDTH.default;
193
+
194
+ /** The project's fallback: one of PROJECT_FALLBACK_MODES, and never wider than the
195
+ * mode the user settings set (with none, QL-06 lets it set acceptEdits). */
196
+ function narrowFallback(project: string, user: string | undefined): Narrowed {
197
+ const ignore = (reason: string): Narrowed => ({ value: undefined, fallThrough: true, ignored: { value: project, reason } });
198
+ if (!PROJECT_FALLBACK_MODES.includes(project)) {
199
+ return ignore(PROJECT_FALLBACK_TOO_WIDE);
200
+ }
201
+ if (user !== undefined && modeWidth(project) > modeWidth(user)) {
202
+ return ignore(widerThanUserFallback(user));
203
+ }
204
+ return { value: project, fallThrough: false };
205
+ }
206
+
207
+ const ALL_TOOLS = "*";
208
+
209
+ /** The entries of a `tools.extra` value, `*` apart. */
210
+ function userToolEntries(user: string | undefined): { all: boolean; rest: string[] } {
211
+ const entries = String(user ?? "").split(/[\s,]+/).filter((e) => e.length > 0);
212
+ return { all: entries.includes(ALL_TOOLS), rest: entries.filter((e) => e !== ALL_TOOLS) };
213
+ }
214
+
215
+ /** The project's extra tools the user lists too (or every one, under `*`), each `read`
216
+ * only when both lists say `read` — a read tool is the wider grant, offered in plan and
217
+ * dontAsk too — and `write` under `*`, which grants the tools, not their class; the
218
+ * others set aside. An entry that does not parse stays, as written, for the reader to
219
+ * warn about, unless it names a tool the project lists in a valid entry: a second
220
+ * entry of a dropped tool would parse once its twin is gone. Never the user's list in
221
+ * place of the project's: narrowing a list never widens it. */
222
+ function narrowExtraTools(project: string, user: string | undefined): Narrowed {
223
+ const { all, rest } = userToolEntries(user);
224
+ const allowed = parseExtraTools(rest).tools;
225
+ const { tools, invalid } = parseExtraTools(project);
226
+ const kept: string[] = [];
227
+ const dropped: string[] = [];
228
+ for (const tool of tools) {
229
+ const listed = allowed.find((t) => sameToolName(t.name, tool.name));
230
+ if (listed === undefined && !all) {
231
+ dropped.push(formatExtraTool(tool));
232
+ continue;
233
+ }
234
+ const read = listed?.access === "read" && tool.access === "read";
235
+ kept.push(formatExtraTool({ name: tool.name, access: read ? "read" : "write" }));
236
+ }
237
+ // `evil:write, evil:read`: the read twin is invalid only while the write one stands.
238
+ const named = (entry: string): boolean => tools.some((t) => sameToolName(t.name, entry.split(":", 1)[0]));
239
+ const value = [...kept, ...invalid.filter((entry) => !named(entry))];
240
+ return {
241
+ value: value.length > 0 ? value.join(", ") : undefined,
242
+ fallThrough: false,
243
+ ...(dropped.length > 0
244
+ ? { ignored: { value: dropped.join(", "), reason: EXTRA_TOOLS_NOT_ALLOWED } }
245
+ : {}),
246
+ };
247
+ }
248
+
249
+ /** The user's value as it applies: `tools.extra` without its `*`, which grants, names no tool. */
250
+ function userValue(key: string, user: string): string | undefined {
251
+ if (key !== EXTRA_TOOLS_CONFIG_KEY) return user;
252
+ const { rest } = userToolEntries(user);
253
+ return rest.length > 0 ? rest.join(", ") : undefined;
254
+ }
255
+
256
+ /** The project's memory.autoAdmitAudited: 'true' asks nothing, so it applies only when the user's says 'true'. */
257
+ function narrowAutoAdmit(project: string, user: string | undefined): Narrowed {
258
+ if (project !== "true" || user === "true") return { value: project, fallThrough: false };
259
+ return {
260
+ value: undefined, fallThrough: true,
261
+ ignored: { value: project, reason: AUTO_ADMIT_FROM_USER },
262
+ };
263
+ }
264
+
265
+ /** The project's dev.prAuto: 'true' opens a pull request without asking, so it applies only when the user's says 'true'. */
266
+ function narrowPrAuto(project: string, user: string | undefined): Narrowed {
267
+ if (project !== "true" || user === "true") return { value: project, fallThrough: false };
268
+ return {
269
+ value: undefined, fallThrough: true,
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
+ : {}),
289
+ };
290
+ }
291
+
292
+ /** The project value as it applies over the user's: narrowed for the keys that widen, added for paths.deny. */
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);
296
+ if (key === DEV_PR_AUTO_CONFIG_KEY) return narrowPrAuto(project, user);
297
+ if (key === PERMISSION_FALLBACK_CONFIG_KEY) return narrowFallback(project, user);
298
+ if (key === EXTRA_TOOLS_CONFIG_KEY) return narrowExtraTools(project, user);
299
+ if (key === MEMORY_AUTO_ADMIT_CONFIG_KEY) return narrowAutoAdmit(project, user);
300
+ return { value: project, fallThrough: false };
301
+ }
302
+
303
+ export function configKeySpec(key: unknown): ConfigKeySpec | undefined {
304
+ const k = String(key ?? "").trim();
305
+ return CONFIG_KEYS.find((s) => s.key === k);
306
+ }
307
+
308
+ export function isKnownConfigKey(key: unknown): boolean {
309
+ return configKeySpec(key) !== undefined;
310
+ }
311
+
312
+ /** The valid-key list, for the rejection message (acceptance 1). */
313
+ export function knownConfigKeys(): string[] {
314
+ return CONFIG_KEYS.map((s) => s.key);
315
+ }
316
+
317
+ export interface ValueVerdict {
318
+ ok: boolean;
319
+ /** Why not, naming the allowed values when the key constrains them. */
320
+ reason: string;
321
+ }
322
+
323
+ /**
324
+ * Validates a value against its key's spec.
325
+ *
326
+ * An unknown KEY is rejected with the whole list, because the useful reply to a
327
+ * typo is the nearby correct spelling. An invalid VALUE is rejected with that
328
+ * key's allowed set, for the same reason.
329
+ */
330
+ export function validateConfigEntry(key: unknown, value: unknown): ValueVerdict {
331
+ const spec = configKeySpec(key);
332
+ if (!spec) {
333
+ return {
334
+ ok: false,
335
+ reason: unknownConfigKey(String(key ?? ""), knownConfigKeys()),
336
+ };
337
+ }
338
+ const v = String(value ?? "").trim();
339
+ if (v.length === 0) return { ok: false, reason: needsAValue(spec.key) };
340
+ if (spec.allowed && !spec.allowed.includes(v)) {
341
+ return {
342
+ ok: false,
343
+ reason: notAllowedValue(v, spec.key, spec.allowed),
344
+ };
345
+ }
346
+ const problem = spec.problem?.(v);
347
+ if (problem !== undefined) return { ok: false, reason: invalidValue(v, spec.key, problem) };
348
+ return { ok: true, reason: "" };
349
+ }
350
+
351
+ /**
352
+ * Layers the session map over the project file's map over the user settings' map, key
353
+ * by key.
354
+ *
355
+ * The session wins where it is set: a `/config set --session` is a deliberate,
356
+ * temporary override of a persisted setting, and `/clear` drops it back to
357
+ * the file value. The project file comes next, but widens nothing (QL-06): its
358
+ * `permissions.fallback` applies only as default, plan or acceptEdits, its
359
+ * `tools.extra` only for the tools the user settings list, its `dev.prAuto` and
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
363
+ * it must not read a project value unnarrowed. Unknown keys present in any map are
364
+ * NOT returned — they can only be residue from before the schema existed, and
365
+ * surfacing them as effective settings would suggest something reads them.
366
+ */
367
+ export function layerConfig(
368
+ fileMap: Record<string, unknown> | null | undefined,
369
+ sessionMap: Record<string, unknown> | null | undefined,
370
+ userMap: Record<string, unknown> | null | undefined,
371
+ ): ConfigResolution[] {
372
+ return CONFIG_KEYS.map((spec): ConfigResolution => {
373
+ const s = stringValue(sessionMap?.[spec.key]);
374
+ if (s !== undefined) return { key: spec.key, value: s, source: "session" };
375
+ const rawUser = stringValue(userMap?.[spec.key]);
376
+ const user = rawUser === undefined ? undefined : userValue(spec.key, rawUser);
377
+ const fromUser: ConfigResolution = user === undefined
378
+ ? { key: spec.key, value: undefined, source: "unset" }
379
+ : { key: spec.key, value: user, source: "user" };
380
+ const f = stringValue(fileMap?.[spec.key]);
381
+ if (f === undefined) return fromUser;
382
+ const narrowed = narrowProject(spec.key, f, rawUser);
383
+ const ignored = narrowed.ignored === undefined ? {} : { ignored: narrowed.ignored };
384
+ if (narrowed.value !== undefined) return { key: spec.key, value: narrowed.value, source: "file", ...ignored };
385
+ if (narrowed.fallThrough) return { ...fromUser, ...ignored };
386
+ return { key: spec.key, value: undefined, source: "unset", ...ignored };
387
+ });
388
+ }
389
+
390
+ /** A map's value as a setting: a non-blank string, trimmed. */
391
+ function stringValue(raw: unknown): string | undefined {
392
+ return typeof raw === "string" && raw.trim().length > 0 ? raw.trim() : undefined;
393
+ }
394
+
395
+ /** The effective value of one key, or undefined when unset in every layer. */
396
+ export function resolveConfigEntry(
397
+ key: string,
398
+ fileMap: Record<string, unknown> | null | undefined,
399
+ sessionMap: Record<string, unknown> | null | undefined,
400
+ userMap: Record<string, unknown> | null | undefined,
401
+ ): ConfigResolution {
402
+ return layerConfig(fileMap, sessionMap, userMap).find((r) => r.key === key)
403
+ ?? { key, value: undefined, source: "unset" };
404
+ }
405
+
406
+ /**
407
+ * Keys present in a stored map that the schema does not know.
408
+ *
409
+ * Reported rather than deleted: they are someone's data, written when any key was
410
+ * accepted, and silently dropping them on the next write is how a free-form map
411
+ * becomes a schema with data loss in between.
412
+ */
413
+ export function unknownStoredKeys(map: Record<string, unknown> | null | undefined): string[] {
414
+ return Object.keys(map ?? {}).filter((k) => !isKnownConfigKey(k)).sort();
415
+ }
416
+
417
+ /**
418
+ * Known keys a stored map holds nested (`{"permissions": {"fallback": "plan"}}`) instead
419
+ * of flat (`{"permissions.fallback": "plan"}`): nothing reads them, so they are named
420
+ * with the flat spelling a hand-written file needs.
421
+ */
422
+ export function nestedConfigKeys(map: Record<string, unknown> | null | undefined): string[] {
423
+ const found: string[] = [];
424
+ const walk = (prefix: string, value: unknown): void => {
425
+ if (!value || typeof value !== "object" || Array.isArray(value)) return;
426
+ for (const [k, v] of Object.entries(value as Record<string, unknown>)) {
427
+ const key = `${prefix}.${k}`;
428
+ if (isKnownConfigKey(key)) found.push(key);
429
+ else walk(key, v);
430
+ }
431
+ };
432
+ for (const [k, v] of Object.entries(map ?? {})) if (!isKnownConfigKey(k)) walk(k, v);
433
+ return found.sort();
434
+ }
@@ -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
+ }