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,242 @@
1
+ // The compaction pipeline, called inline by BOTH the session-compact crew
2
+ // (/compact, forced) and the main loop's automatic compaction (above the trigger
3
+ // only) — a plain function call, never a crew launch from a crew. In order: the
4
+ // durable facts go to typed memory first, so nothing worth keeping is lost; the
5
+ // summary is written from the whole buffer as it stands (clipped head and tail by
6
+ // the prompt), then the files the conversation was working on and the attached
7
+ // skills are read back. A request still waiting for its answer (the compaction at the head of a turn) stays last,
8
+ // after all of them, so the answer that follows has its request before it. The deterministic snip (session_snip) is the fallback of a
9
+ // summary that fails, and `/compact --snip`: it keeps the head and the last turns whole (runtimeTurnsToKeep), and
10
+ // either leaves a notice in the buffer saying the earlier turns were removed without a summary.
11
+ //
12
+ // The pipeline runs on the ports of CompactDeps: both entry points wire the Orkeon
13
+ // adapters and the running agent's model, log and clock. Memory extraction and the
14
+ // restoration of files and skills are in ./extract-memories.ts and
15
+ // ./restore-context.ts; the outcome and its line in shared/domain/compact-outcome.ts.
16
+
17
+ import type { Clock, Files, Llm, Logger, MemoryStore, Progress, SessionStore } from "../ports.ts";
18
+ import type { CompactOutcome } from "../../domain/compact-outcome.ts";
19
+ import type { StateWritten } from "../workflow/workflow-state.ts";
20
+ import {
21
+ MIN_COMPACTABLE,
22
+ buildCompactedBuffer,
23
+ buildMemoryRecapMessage,
24
+ buildRestoredStateMessage,
25
+ buildSnipNoticeMessage,
26
+ buildSummaryPrompt,
27
+ buildTranscript,
28
+ extractSummary,
29
+ } from "../../domain/compaction.ts";
30
+ import { COMPACTION_TRIGGER_CONFIG_KEY, SNIP_RETAIN_COUNT, parseTokenCount, shouldCompact } from "../../domain/compaction-thresholds.ts";
31
+ import type { ConfigStore } from "../config-store.ts";
32
+ import { extractMemories } from "./extract-memories.ts";
33
+ import { restoreAttachedSkills, restoreRecentFiles } from "./restore-context.ts";
34
+ import { WORKSPACE } from "../../domain/vfs.ts";
35
+ import { isoDay } from "../../domain/iso-day.ts";
36
+ import { pendingRequestLength } from "../../domain/marked-message.ts";
37
+ import { runtimeTurnsToKeep } from "../../domain/snip-turns.ts";
38
+ import type { SessionMsg } from "../../domain/types.ts";
39
+ import { BUFFER_TOO_SMALL } from "../../domain/markers.ts";
40
+ import {
41
+ PHASE_ATTACHED_SKILLS, PHASE_RECENT_FILES, PHASE_SUMMARY, SUMMARY_CAME_BACK_EMPTY, bufferWasSnipped, couldNotBeWritten,
42
+ filesReinjected, noStateFileWritten, skillsReinjected, snipNoticeNotWritten, snippedLine, stateNotWritten, stateWrittenTo,
43
+ } from "./messages.ts";
44
+
45
+ /** The ports the pipeline runs on. */
46
+ export interface CompactDeps {
47
+ progress: Progress;
48
+ session: SessionStore;
49
+ files: Files;
50
+ memory: MemoryStore;
51
+ llm: Llm;
52
+ log: Logger;
53
+ /** Today's date for the memory extraction, so a relative date is saved as an absolute one: the UTC day, as the
54
+ * Environment line of the turn gives it. */
55
+ clock: Clock;
56
+ /** Step 0: writes the state file of the dev batch in progress (null: none is). Absent, no step 0. */
57
+ workflow?: (trigger: "manual" | "auto") => Promise<StateWritten | null>;
58
+ }
59
+
60
+ /**
61
+ * Run the compaction pipeline. `force: true` (the /compact crew) skips the
62
+ * threshold check; `force: false` (main-loop auto-compaction) only acts above the
63
+ * trigger. Past it, every run pays one summary call over the whole buffer.
64
+ * `focus` is what the operator asked the summary to keep above all
65
+ * (`/compact <focus>`). A summary that comes back empty, or a model that fails,
66
+ * fails the compaction (the breaker counts it) rather than replace the history
67
+ * with nothing: the buffer is snipped instead, with a notice, and the outcome says
68
+ * so (`fallback: "snip"`).
69
+ */
70
+ export async function compactSession(
71
+ opts: { force?: boolean; focus?: string; trigger?: number },
72
+ deps: CompactDeps,
73
+ ): Promise<CompactOutcome> {
74
+ const { progress, session, files, memory, llm, log } = deps;
75
+ const force = opts.force === true;
76
+ let state: StateWritten | null = null;
77
+ const withState = (o: CompactOutcome): CompactOutcome =>
78
+ state === null ? o : { ...o, state: "path" in state ? { path: state.path } : { skipped: state.skipped } };
79
+ try {
80
+ // The budget first: under the trigger the automatic run reads no message, so a turn does not pay a read of
81
+ // the whole buffer at its head and its tail.
82
+ const gated = force ? null : await session.readBudget();
83
+ if (gated !== null && !shouldCompact(gated.used, gated.window, opts.trigger))
84
+ return { status: "skipped", reason: "below trigger", usedTokens: gated.used };
85
+ const raw = await session.readMessages();
86
+ // 0. The state of the dev batch in progress goes to its file first, from files and
87
+ // git alone. /compact (force) refreshes it whatever the buffer holds.
88
+ if (force) state = await writeState(deps, "manual");
89
+ if (raw.stored.length <= MIN_COMPACTABLE)
90
+ return withState({ status: "skipped", reason: BUFFER_TOO_SMALL });
91
+ const { used } = gated ?? await session.readBudget();
92
+ if (!force) state = await writeState(deps, "auto");
93
+
94
+ // Progress: reported only past the threshold checks (a skipped compaction must
95
+ // not flash a bar), released on EVERY exit below — the fallback included.
96
+ try {
97
+ // 1. Memory extraction BEFORE any loss — best-effort (extract throws on
98
+ // non-JSON replies; compaction must never fail because of it).
99
+ await progress.report(compactPhase(1, "extracting memories"));
100
+ const transcript = buildTranscript(raw.messages);
101
+ const memories = await extractMemories(llm, memory, transcript, isoDay(deps.clock()));
102
+
103
+ // 2. The summary, from the buffer as it stands: the prompt clips the transcript head and tail.
104
+ await progress.report(compactPhase(2, PHASE_SUMMARY));
105
+ const summary = await summarise(llm, transcript, opts.focus);
106
+ if ("failure" in summary) return withState(await snipFallback(deps, raw.messages, summary.failure));
107
+ const buffer = buildCompactedBuffer(raw.stored[0], summary.text);
108
+ if (memories.length > 0) buffer.push(buildMemoryRecapMessage(memories));
109
+ // 3. Re-inject the recently-touched files so the agent keeps its working
110
+ // context (paths harvested from the buffer before the compaction).
111
+ await progress.report(compactPhase(3, PHASE_RECENT_FILES));
112
+ const restored = await restoreRecentFiles(files, raw.messages);
113
+ if (restored.length > 0) {
114
+ buffer.push(...restored);
115
+ note(log, filesReinjected(restored.length));
116
+ }
117
+ // 4. Re-inject the ATTACHED SKILLS under their own budget. Files came
118
+ // back because the agent was touching them; skills come back because the
119
+ // operator attached them and expects them to outlive every compaction —
120
+ // which is exactly what "the agent forgot the rules" looks like when they
121
+ // do not.
122
+ await progress.report(compactPhase(4, PHASE_ATTACHED_SKILLS));
123
+ const skills = await restoreAttachedSkills(session, files);
124
+ if (skills.length > 0) {
125
+ buffer.push(...skills);
126
+ note(log, skillsReinjected(skills.length));
127
+ }
128
+ // 5. The pointer to the state file written at step 0, last: what to read first.
129
+ if (state !== null && "path" in state) buffer.push(buildRestoredStateMessage(`${WORKSPACE}/${state.path}`, state.firstOpen));
130
+ // 6. The request still waiting for its answer, with its [turn-context], stays last: the summary records it, and
131
+ // the answer appended next must follow it.
132
+ const pending = pendingRequestLength(raw.messages);
133
+ if (pending > 0) buffer.push(...raw.stored.slice(raw.stored.length - pending));
134
+ await session.writeMessages(buffer);
135
+
136
+ return withState({ status: "compacted", before: raw.stored.length, after: buffer.length, usedTokens: used });
137
+ } finally {
138
+ await progress.done(COMPACT_PROGRESS_LABEL);
139
+ }
140
+ } catch (e: any) {
141
+ return withState({ status: "failed", reason: String(e?.message ?? e) });
142
+ }
143
+ }
144
+
145
+ /** The summary of `transcript`, or why there is none: an empty reply or a model that failed. */
146
+ async function summarise(llm: Llm, transcript: string, focus: string | undefined): Promise<{ text: string } | { failure: string }> {
147
+ try {
148
+ const prompt = buildSummaryPrompt(transcript, focus);
149
+ const reply = await llm.complete(prompt.user, { system: prompt.system });
150
+ const text = extractSummary(String(reply ?? ""));
151
+ return text.length === 0 ? { failure: SUMMARY_CAME_BACK_EMPTY } : { text };
152
+ } catch (e: any) {
153
+ return { failure: String(e?.message ?? e) };
154
+ }
155
+ }
156
+
157
+ /** No summary: the buffer (`messages`, as just read) is snipped to its last turns with a notice, and the compaction
158
+ * still fails (the breaker counts it). A snip that fails too, or removes nothing (no more turns than it keeps), leaves
159
+ * the failure of the summary as the reason and no fallback; a notice that cannot be written is logged, the fallback
160
+ * kept (the buffer was cut). */
161
+ async function snipFallback(deps: CompactDeps, messages: readonly SessionMsg[], reason: string): Promise<CompactOutcome> {
162
+ const keep = runtimeTurnsToKeep(messages, SNIP_RETAIN_COUNT);
163
+ if (keep === null) return { status: "failed", reason };
164
+ let removed: number;
165
+ try {
166
+ ({ removed } = await deps.session.snip(keep));
167
+ } catch {
168
+ return { status: "failed", reason };
169
+ }
170
+ if (removed === 0) return { status: "failed", reason };
171
+ try {
172
+ await leaveSnipNotice(deps.session);
173
+ } catch (e: any) {
174
+ note(deps.log, snipNoticeNotWritten(String(e?.message ?? e).split("\n")[0]));
175
+ }
176
+ note(deps.log, bufferWasSnipped(reason));
177
+ return { status: "failed", reason, fallback: "snip" };
178
+ }
179
+
180
+ /** The notice that the turns a snip removed were not summarised, right after the head: the kept tail opens on a whole
181
+ * turn and the current request stays last. None added when one already sits there (a second snip). */
182
+ async function leaveSnipNotice(session: Pick<SessionStore, "readMessages" | "writeMessages">): Promise<void> {
183
+ const { stored } = await session.readMessages();
184
+ const notice = buildSnipNoticeMessage();
185
+ if (stored.length > 1 && String((stored[1] as { content?: unknown })?.content ?? "") === notice.content) return;
186
+ await session.writeMessages(stored.length === 0 ? [notice] : [stored[0], notice, ...stored.slice(1)]);
187
+ }
188
+
189
+ /** Step 0, best-effort: a state that cannot be written is logged, and the compaction goes on. */
190
+ async function writeState(deps: CompactDeps, trigger: "manual" | "auto"): Promise<StateWritten | null> {
191
+ if (deps.workflow === undefined) return null;
192
+ try {
193
+ const state = await deps.workflow(trigger);
194
+ if (state !== null) {
195
+ note(deps.log, "path" in state ? stateWrittenTo(state.path) : noStateFileWritten(state.skipped));
196
+ }
197
+ return state;
198
+ } catch (e: any) {
199
+ const reason = String(e?.message ?? e).split("\n")[0];
200
+ try { deps.log.warn(stateNotWritten(reason)); } catch { /* best-effort */ }
201
+ return { skipped: couldNotBeWritten(reason) };
202
+ }
203
+ }
204
+
205
+ /** `/compact --snip [N]`: the head and the last N turns kept whole, nothing summarised, a notice saying so. A buffer
206
+ * with no more turns than that is left as it is. */
207
+ export async function snipBuffer(
208
+ turns: number,
209
+ deps: { session: Pick<SessionStore, "snip" | "readMessages" | "writeMessages"> },
210
+ ): Promise<string> {
211
+ const { messages } = await deps.session.readMessages();
212
+ const keep = runtimeTurnsToKeep(messages, turns);
213
+ if (keep === null) return snippedLine(0, messages.length);
214
+ const { removed, retained } = await deps.session.snip(keep);
215
+ if (removed > 0) await leaveSnipNotice(deps.session);
216
+ return snippedLine(removed, retained);
217
+ }
218
+
219
+ /** The `compaction.trigger` setting as a token count; undefined when unset, invalid
220
+ * or unreadable (the computed trigger then applies). */
221
+ export async function readCompactionTrigger(config: Pick<ConfigStore, "readValue">): Promise<number | undefined> {
222
+ try {
223
+ return parseTokenCount((await config.readValue(COMPACTION_TRIGGER_CONFIG_KEY)).value);
224
+ } catch {
225
+ return undefined;
226
+ }
227
+ }
228
+
229
+ /** Status-line headline of the compaction progress. */
230
+ export const COMPACT_PROGRESS_LABEL = "Compacting conversation";
231
+
232
+ /** Total phases of the full pipeline (extract, synthesis, files, skills). */
233
+ const COMPACT_PROGRESS_TOTAL = 4;
234
+
235
+ function compactPhase(step: number, message: string) {
236
+ return { label: COMPACT_PROGRESS_LABEL, step, total: COMPACT_PROGRESS_TOTAL, message };
237
+ }
238
+
239
+ /** Logging is best-effort: a log that fails never fails the compaction. */
240
+ function note(log: Logger, message: string): void {
241
+ try { log.info(message); } catch { /* logging is best-effort */ }
242
+ }
@@ -0,0 +1,38 @@
1
+ // Pre-compaction memory extraction: the model lists the durable facts of the
2
+ // conversation, and each one goes to the typed-memory store, so that nothing worth
3
+ // keeping is lost to the summary. What the store already holds is listed in the
4
+ // prompt by id, the newest first (the list is capped), so a fact is not saved twice
5
+ // and a fact that makes a known entry out of date replaces it in place; today's date
6
+ // is given, so a relative date is saved as an absolute one.
7
+
8
+ import type { Llm, MemoryEntry, MemoryStore } from "../ports.ts";
9
+ import {
10
+ buildMemoryExtractionPrompt,
11
+ MEMORY_EXTRACTION_SCHEMA,
12
+ sanitizeExtractedMemories,
13
+ type ExtractedMemory,
14
+ } from "../../domain/compaction.ts";
15
+
16
+ /** Extract + persist durable memories; failures degrade to an empty list. `today` is YYYY-MM-DD. */
17
+ export async function extractMemories(
18
+ llm: Pick<Llm, "extract">,
19
+ memory: Pick<MemoryStore, "add" | "list" | "replace">,
20
+ transcript: string,
21
+ today?: string,
22
+ ): Promise<ExtractedMemory[]> {
23
+ try {
24
+ const known = await memory.list(undefined, { newestFirst: true }).catch(() => [] as MemoryEntry[]);
25
+ const raw = await llm.extract(buildMemoryExtractionPrompt(transcript, known, today), MEMORY_EXTRACTION_SCHEMA);
26
+ const items = sanitizeExtractedMemories(raw, known);
27
+ for (const it of items) {
28
+ try {
29
+ // A stale entry is replaced in place; a replacement the store refuses is added as a new entry.
30
+ if (it.replaces !== undefined && await memory.replace(it.replaces, it.content).catch(() => false)) continue;
31
+ await memory.add(it.category, it.content);
32
+ } catch { /* store unavailable → memory only lives in the recap message */ }
33
+ }
34
+ return items;
35
+ } catch {
36
+ return [];
37
+ }
38
+ }
@@ -0,0 +1,20 @@
1
+ // The text the compaction reports: its progress phases, its log lines and the outcome of a snip.
2
+
3
+ export const PHASE_SUMMARY = "synthesizing the summary";
4
+ export const PHASE_RECENT_FILES = "restoring recent files";
5
+ export const PHASE_ATTACHED_SKILLS = "restoring attached skills";
6
+ export const filesReinjected = (count: number): string => `post-compaction restore: ${count} file(s) re-injected`;
7
+ export const skillsReinjected = (count: number): string => `post-compaction restore: ${count} skill(s) re-injected`;
8
+ export const SUMMARY_CAME_BACK_EMPTY = "the summary came back empty";
9
+ export const snipNoticeNotWritten = (reason: string): string => `the notice of the snip could not be written: ${reason}`;
10
+ export const bufferWasSnipped = (reason: string): string => `compaction path: no summary (${reason}), the buffer was snipped`;
11
+ export const stateWrittenTo = (path: string): string => `state of the batch in progress written to ${path}`;
12
+ export const noStateFileWritten = (skipped: string): string => `no state file written: ${skipped}`;
13
+ export const stateNotWritten = (reason: string): string => `the state of the batch in progress could not be written: ${reason}`;
14
+ export const couldNotBeWritten = (reason: string): string => `it could not be written (${reason})`;
15
+ export const snippedLine = (removed: number, kept: number): string => `snipped: ${removed} removed, ${kept} kept.`;
16
+ export const PRUNE_WITHOUT_DECISION_MODEL =
17
+ "compaction.prune is on and the host has no decision model: nothing is pruned (set Orkeon:Decision:Provider, or Orkeon:TypeSafe)";
18
+ export const PRUNE_DECISION_FAILED = "context pruning: the decision model did not answer, nothing more is pruned in this act";
19
+ export const prunedLine = (judged: number, dropped: number, cut: number, freedTokens: number): string =>
20
+ `context pruning: ${judged} tool result(s) judged, ${dropped} removed, ${cut} cut, about ${freedTokens} tokens freed`;
@@ -0,0 +1,94 @@
1
+ // The pruning of a turn's tool loop, bound for one act (ADR 0027): with `compaction.prune` on and a decision model on
2
+ // the host, the act carries a callback the runtime asks once its loop passes 40 % of the window. The callback keeps
3
+ // the small results without asking, has the decision model judge the others by batches, oldest first, and answers
4
+ // the runtime's verdicts; a result judged needed is left unanswered and judged again once it has aged. It fails
5
+ // open at every step: a setting that cannot be read, no decision model, a model that does not answer leave the
6
+ // loop as it is, and a model that failed once is not asked again in that act. One binding serves one act: the main
7
+ // loop binds it itself, the dev crews get it from their Llm (pruned-llm.ts).
8
+ import type { ActRequest, DecisionModel, Logger, SessionStore } from "../ports.ts";
9
+ import type { ConfigStore } from "../config-store.ts";
10
+ import { DEFAULT_CONTEXT_WINDOW } from "../../domain/compaction-thresholds.ts";
11
+ import type { ContextPressure, PressureCall, PruneVerdict } from "../../domain/context-prune.ts";
12
+ import {
13
+ PRUNE_BATCH_CALLS, PRUNE_CONFIG_KEY, PRUNE_MAX_CALLS, dueForJudging, pressureSettings, pruneOn, pruneQuestions, pruneState, pruneTally,
14
+ pruneVerdicts, worthJudging,
15
+ } from "../../domain/context-prune.ts";
16
+ import { PRUNE_DECISION_FAILED, PRUNE_WITHOUT_DECISION_MODEL, prunedLine } from "./messages.ts";
17
+
18
+ /** What the pruning adds to an act's request; nothing when it is off. */
19
+ export type ContextPruning = Pick<ActRequest, "onContextPressure" | "contextPressure">;
20
+
21
+ export interface PruneDeps {
22
+ config: Pick<ConfigStore, "readValue">;
23
+ decision: DecisionModel;
24
+ session: Pick<SessionStore, "readBudget">;
25
+ log: Pick<Logger, "info" | "warn">;
26
+ }
27
+
28
+ async function settingOn(config: PruneDeps["config"]): Promise<boolean> {
29
+ try {
30
+ const value = (await config.readValue(PRUNE_CONFIG_KEY)).value;
31
+ return pruneOn(typeof value === "string" ? value : null);
32
+ } catch {
33
+ return false;
34
+ }
35
+ }
36
+
37
+ async function windowOf(session: PruneDeps["session"]): Promise<number> {
38
+ try {
39
+ const { window } = await session.readBudget();
40
+ return window > 0 ? window : DEFAULT_CONTEXT_WINDOW;
41
+ } catch {
42
+ return DEFAULT_CONTEXT_WINDOW;
43
+ }
44
+ }
45
+
46
+ /** The callback of one act working on `request`. Its memory is the act's: the model that failed, and the age at
47
+ * which each result was last judged needed (the runtime numbers the calls of an act, `call-1`, `call-2`...). */
48
+ function judge(deps: Pick<PruneDeps, "decision" | "log">, request: string): NonNullable<ActRequest["onContextPressure"]> {
49
+ let failed = false;
50
+ const keptAt = new Map<string, number>();
51
+ return async (pressure: ContextPressure) => {
52
+ const verdicts: Record<string, PruneVerdict> = {};
53
+ if (failed) return verdicts;
54
+ const due: PressureCall[] = [];
55
+ for (const call of pressure.calls) {
56
+ // A small result is settled for the loop: nothing to free, never offered again.
57
+ if (!worthJudging(call)) verdicts[call.id] = "keep";
58
+ else if (dueForJudging(call, keptAt.get(call.id))) due.push(call);
59
+ }
60
+ const asked = due.slice(0, PRUNE_MAX_CALLS);
61
+ const batches: PressureCall[][] = [];
62
+ for (let start = 0; start < asked.length; start += PRUNE_BATCH_CALLS) batches.push(asked.slice(start, start + PRUNE_BATCH_CALLS));
63
+ // The batches are asked together: the model turn waits for the slowest, not for their sum.
64
+ const replies = await Promise.all(batches.map((batch) => deps.decision.ask(pruneState(request, batch), pruneQuestions(batch))));
65
+ const judged: Record<string, PruneVerdict> = {};
66
+ replies.forEach((answers, i) => {
67
+ if (answers === null) failed = true;
68
+ else Object.assign(judged, pruneVerdicts(batches[i], answers));
69
+ });
70
+ if (failed) deps.log.warn(PRUNE_DECISION_FAILED);
71
+ for (const call of asked) {
72
+ const verdict = judged[call.id];
73
+ // A result judged needed is left unanswered, so the runtime offers it again; it is judged again once aged.
74
+ if (verdict === "keep") keptAt.set(call.id, call.age);
75
+ else if (verdict !== undefined) verdicts[call.id] = verdict;
76
+ }
77
+ const tally = pruneTally(asked, judged);
78
+ if (tally.judged > 0) deps.log.info(prunedLine(tally.judged, tally.dropped, tally.cut, tally.freedTokens));
79
+ return verdicts;
80
+ };
81
+ }
82
+
83
+ /** What an act working on `request` carries: the callback and its settings, or nothing. */
84
+ export async function contextPruning(deps: PruneDeps, request: string): Promise<ContextPruning> {
85
+ if (!await settingOn(deps.config)) return {};
86
+ if (!deps.decision.available()) {
87
+ deps.log.warn(PRUNE_WITHOUT_DECISION_MODEL);
88
+ return {};
89
+ }
90
+ return {
91
+ contextPressure: pressureSettings(await windowOf(deps.session)),
92
+ onContextPressure: judge(deps, request),
93
+ };
94
+ }
@@ -0,0 +1,35 @@
1
+ // An Llm whose acts carry the pruning of their tool loop (prune-context.ts, ADR 0032): the crews whose acts are made
2
+ // by a use case that knows nothing of the pruning (the sub-agents and the roles of the dev crews) get it from the
3
+ // Llm they are handed. Each act asks for its own binding, on its prompt. It adds nothing, and the request leaves as
4
+ // it came, when the binding is empty (the setting off, no decision model), when asking for it fails, and when the
5
+ // request already carries a callback of its own.
6
+ import type { ActRequest, Llm } from "../ports.ts";
7
+ import type { ContextPruning } from "./prune-context.ts";
8
+
9
+ /** What binds the pruning of one act working on `request`: `contextPruning` over the entry point's ports. */
10
+ export type PruningFor = (request: string) => Promise<ContextPruning>;
11
+
12
+ async function bindingOf(prune: PruningFor, prompt: string): Promise<ContextPruning> {
13
+ try {
14
+ return await prune(prompt);
15
+ } catch {
16
+ return {};
17
+ }
18
+ }
19
+
20
+ async function prunedRequest(prune: PruningFor, prompt: string, request: ActRequest): Promise<ActRequest> {
21
+ if (request.onContextPressure !== undefined) return request;
22
+ const binding = await bindingOf(prune, prompt);
23
+ return binding.onContextPressure === undefined ? request : { ...request, ...binding };
24
+ }
25
+
26
+ /** `llm` with the pruning `prune` binds on each of its acts; its other calls unchanged. */
27
+ export function prunedLlm(llm: Llm, prune: PruningFor): Llm {
28
+ return {
29
+ act: async (prompt, request) => llm.act(prompt, await prunedRequest(prune, prompt, request)),
30
+ complete: (prompt, request) => llm.complete(prompt, request),
31
+ extract: (prompt, schema) => llm.extract(prompt, schema),
32
+ permissionGateEnabled: () => llm.permissionGateEnabled(),
33
+ effortSent: (request) => llm.effortSent(request),
34
+ };
35
+ }
@@ -0,0 +1,78 @@
1
+ // After a full synthesis, the compaction re-injects the working context the
2
+ // summary would lose: the files the conversation touched last and the attached
3
+ // skills, each under its own token budget (chars/4 heuristic).
4
+
5
+ import type { Files, SessionStore } from "../ports.ts";
6
+ import type { SessionMsg } from "../../domain/types.ts";
7
+ import {
8
+ buildRestoredFileMessage,
9
+ buildRestoredFileNotice,
10
+ buildRestoredSkillMessage,
11
+ extractRecentFilePaths,
12
+ } from "../../domain/compaction.ts";
13
+ import {
14
+ CHARS_PER_TOKEN,
15
+ POST_COMPACT_MAX_FILES_TO_RESTORE,
16
+ POST_COMPACT_PER_FILE_TOKENS,
17
+ POST_COMPACT_TOKEN_BUDGET,
18
+ POST_COMPACT_SKILLS_TOKEN_BUDGET,
19
+ POST_COMPACT_PER_SKILL_TOKENS,
20
+ } from "../../domain/compaction-thresholds.ts";
21
+ import { readAttachedSkills } from "../attached-skills.ts";
22
+
23
+ /**
24
+ * Read back up to POST_COMPACT_MAX_FILES_TO_RESTORE recently-mentioned files
25
+ * (recency order) under the restore budget. A file larger than the per-file cap,
26
+ * or than what the budget has left, comes back as its path with a note, never as
27
+ * a cut copy: a cut copy reads as the whole file and could feed a whole-file
28
+ * write. Unreadable/gone paths are skipped silently — the harvest regex is
29
+ * conservative but the filesystem stays the arbiter.
30
+ */
31
+ export async function restoreRecentFiles(
32
+ files: Pick<Files, "read">,
33
+ preCompaction: SessionMsg[],
34
+ ): Promise<SessionMsg[]> {
35
+ const candidates = extractRecentFilePaths(preCompaction, POST_COMPACT_MAX_FILES_TO_RESTORE * 4);
36
+ const out: SessionMsg[] = [];
37
+ let budgetChars = POST_COMPACT_TOKEN_BUDGET * CHARS_PER_TOKEN;
38
+ const perFileChars = POST_COMPACT_PER_FILE_TOKENS * CHARS_PER_TOKEN;
39
+ for (const path of candidates) {
40
+ if (out.length >= POST_COMPACT_MAX_FILES_TO_RESTORE) break;
41
+ try {
42
+ const content = await files.read(path);
43
+ if (content.length === 0) continue;
44
+ if (content.length > Math.min(perFileChars, budgetChars)) {
45
+ out.push(buildRestoredFileNotice(path));
46
+ continue;
47
+ }
48
+ budgetChars -= content.length;
49
+ out.push(buildRestoredFileMessage(path, content));
50
+ } catch { /* not a real/readable file → skip */ }
51
+ }
52
+ return out;
53
+ }
54
+
55
+ /**
56
+ * Read back every attached skill under POST_COMPACT_SKILLS_TOKEN_BUDGET, each
57
+ * capped like the skills block of a turn.
58
+ *
59
+ * Reads the registry from the session bag rather than taking it as an argument:
60
+ * this runs inside the compaction, which has no caller able to supply it. A gone,
61
+ * unreadable or blank skill is skipped (readAttachedSkills) — a
62
+ * detached-then-deleted playbook must not fail a compaction.
63
+ */
64
+ export async function restoreAttachedSkills(
65
+ session: Pick<SessionStore, "readState">,
66
+ files: Pick<Files, "read">,
67
+ ): Promise<SessionMsg[]> {
68
+ const out: SessionMsg[] = [];
69
+ let budgetChars = POST_COMPACT_SKILLS_TOKEN_BUDGET * CHARS_PER_TOKEN;
70
+ const perSkillChars = POST_COMPACT_PER_SKILL_TOKENS * CHARS_PER_TOKEN;
71
+ for (const { path, content } of await readAttachedSkills(session, files)) {
72
+ if (budgetChars <= 0) break;
73
+ const capped = content.slice(0, Math.min(perSkillChars, budgetChars));
74
+ budgetChars -= capped.length;
75
+ out.push(buildRestoredSkillMessage(path, capped));
76
+ }
77
+ return out;
78
+ }
@@ -0,0 +1,123 @@
1
+ // Two-layer /config store (B-6): a VFS settings file that survives everything,
2
+ // and the session state bag that overrides it until /clear. Under both, the user
3
+ // settings the launcher mounts read-only (LI-6): the project file widens nothing past them.
4
+ //
5
+ // The original persists `/config` to a settings file (baseline 04 §/config);
6
+ // The first version had only the session bag, so nothing set with `/config` outlived a
7
+ // `/clear` — including `permissions.fallback`, whose entire purpose is to
8
+ // state a durable posture.
9
+ //
10
+ // Built over the Files and SessionStore ports (createConfigStore); the instance
11
+ // wired to the runtime is orkeonConfigStore() in shared/infrastructure/orkeon/.
12
+
13
+ import type { Files, SessionStore } from "./ports.ts";
14
+ import { layerConfig, resolveConfigEntry, unknownStoredKeys, nestedConfigKeys } from "../domain/config-schema.ts";
15
+ import type { ConfigResolution } from "../domain/config-schema.ts";
16
+ import { CONFIG_MAP_STATE_KEY } from "../domain/session-keys.ts";
17
+ import { readJsonFile, writeJsonFile } from "./json-file.ts";
18
+ import { readJsonObject, writeJson } from "./session-state.ts";
19
+ import { WORKSPACE } from "../domain/vfs.ts";
20
+
21
+ /** The persisted settings file. Under /workspace so it lives with the repo. */
22
+ export const CONFIG_FILE_PATH = `${WORKSPACE}/.orkeon/config.json`;
23
+
24
+ /**
25
+ * The user's settings: the `orkeonCode` block of the user settings file, which the
26
+ * launcher writes at each start to a folder it mounts here read-only. Outside the
27
+ * project, so a cloned repository cannot ship it; the project file widens nothing
28
+ * past it (QL-06, config-schema.ts layerConfig). A script reads neither the host
29
+ * settings nor the environment (V-04), so the launcher hands the block over as a file.
30
+ */
31
+ export const USER_CONFIG_FILE_PATH = "/user-config/config.json";
32
+
33
+ function asMap(raw: unknown): Record<string, unknown> {
34
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
35
+ return raw as Record<string, unknown>;
36
+ }
37
+
38
+ export interface ConfigView {
39
+ entries: ConfigResolution[];
40
+ /** Keys stored by the pre-schema free-form map; reported, never deleted. */
41
+ unknown: string[];
42
+ /** Known keys the project or user file holds nested: nothing reads them (nestedConfigKeys). */
43
+ nested: string[];
44
+ fileMalformed: boolean;
45
+ /** The user settings file could not be read or parsed: no user setting applies. */
46
+ userMalformed: boolean;
47
+ }
48
+
49
+ export interface ConfigStore {
50
+ /**
51
+ * Reads the settings file. An absent file is the normal first state; a malformed
52
+ * one yields `{}` and a flag, because overwriting a file we could not parse would
53
+ * destroy whatever it did contain.
54
+ */
55
+ readFile(): Promise<{ map: Record<string, unknown>; malformed: boolean }>;
56
+ /** Reads the user settings file, read-only: a failed read is an absent file, content
57
+ * that does not parse is malformed. */
58
+ readUserFile(): Promise<{ map: Record<string, unknown>; malformed: boolean }>;
59
+ /** Writes the settings file (pretty-printed — a human edits this by hand too). */
60
+ writeFile(map: Record<string, unknown>): Promise<void>;
61
+ /** Reads the session override map. */
62
+ readSession(): Promise<Record<string, unknown>>;
63
+ /** Writes the session override map. */
64
+ writeSession(map: Record<string, unknown>): Promise<void>;
65
+ /** The effective configuration: user settings, overridden by the project file
66
+ * (which widens nothing past them), overridden by the session. */
67
+ readView(): Promise<ConfigView>;
68
+ /** The effective value of one key, layered. */
69
+ readValue(key: string): Promise<ConfigResolution>;
70
+ }
71
+
72
+ export function createConfigStore(deps: {
73
+ files: Files;
74
+ session: Pick<SessionStore, "readState" | "writeState">;
75
+ }): ConfigStore {
76
+ const { files, session } = deps;
77
+
78
+ async function readMap(path: string): Promise<{ map: Record<string, unknown>; malformed: boolean }> {
79
+ const { value, malformed } = await readJsonFile(files, path);
80
+ return { map: asMap(value), malformed };
81
+ }
82
+ const readFile = () => readMap(CONFIG_FILE_PATH);
83
+ // The user file is the launcher's, mounted read-only: nothing here ever writes it, so a
84
+ // read that fails (no mount, an older launcher) is the absent layer, not data to guard.
85
+ async function readUserFile(): Promise<{ map: Record<string, unknown>; malformed: boolean }> {
86
+ let content: string;
87
+ try {
88
+ content = (await files.read(USER_CONFIG_FILE_PATH)).trim();
89
+ } catch {
90
+ return { map: {}, malformed: false };
91
+ }
92
+ if (content.length === 0) return { map: {}, malformed: false };
93
+ try {
94
+ return { map: asMap(JSON.parse(content)), malformed: false };
95
+ } catch {
96
+ return { map: {}, malformed: true };
97
+ }
98
+ }
99
+
100
+ const readSession = (): Promise<Record<string, unknown>> => readJsonObject(session, CONFIG_MAP_STATE_KEY);
101
+
102
+ return {
103
+ readFile,
104
+ readUserFile,
105
+ writeFile: (map) => writeJsonFile(files, CONFIG_FILE_PATH, map),
106
+ readSession,
107
+ writeSession: (map) => writeJson(session, CONFIG_MAP_STATE_KEY, map),
108
+ async readView() {
109
+ const [{ map: file, malformed }, overrides, user] = await Promise.all([readFile(), readSession(), readUserFile()]);
110
+ return {
111
+ entries: layerConfig(file, overrides, user.map),
112
+ unknown: [...new Set([file, overrides, user.map].flatMap(unknownStoredKeys))].sort(),
113
+ nested: [...new Set([file, user.map].flatMap(nestedConfigKeys))].sort(),
114
+ fileMalformed: malformed,
115
+ userMalformed: user.malformed,
116
+ };
117
+ },
118
+ async readValue(key) {
119
+ const [{ map: file }, overrides, { map: user }] = await Promise.all([readFile(), readSession(), readUserFile()]);
120
+ return resolveConfigEntry(key, file, overrides, user);
121
+ },
122
+ };
123
+ }