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,46 @@
1
+ // The outcome of one compaction attempt, and the line that reports it. Pure — no IO.
2
+ // The pipeline (shared/application/compaction/) returns it, the main-loop circuit
3
+ // breaker counts its status, and the session-compact crew prints its line.
4
+ import { BUFFER_TOO_SMALL_TO_COMPACT, noStateFileWrittenOnNewLine, SNIPPED_INSTEAD, stateOfBatch } from "./messages.ts";
5
+ import { BUFFER_TOO_SMALL } from "./markers.ts";
6
+
7
+ /** Status of one compaction attempt; the main-loop circuit breaker counts the
8
+ * consecutive `failed` ones. */
9
+ export type CompactStatus = "skipped" | "compacted" | "failed";
10
+
11
+ /** Outcome of one compaction attempt — a value, never an exception (the
12
+ * main-loop circuit breaker consumes `status`). */
13
+ export interface CompactOutcome {
14
+ status: CompactStatus;
15
+ reason?: string;
16
+ before?: number;
17
+ after?: number;
18
+ usedTokens?: number;
19
+ /** A failed summary whose buffer was snipped instead: the earlier turns removed without a summary. */
20
+ fallback?: "snip";
21
+ /** The state file written before the compaction (a dev batch in progress), or why none was. */
22
+ state?: { path: string } | { skipped: string };
23
+ }
24
+
25
+ /** Human-readable outcome line (session-compact crew output / logs). */
26
+ export function formatOutcome(o: CompactOutcome): string {
27
+ return outcomeLine(o) + stateLine(o);
28
+ }
29
+
30
+ function stateLine(o: CompactOutcome): string {
31
+ if (o.state === undefined) return "";
32
+ return "path" in o.state ? stateOfBatch(o.state.path) : noStateFileWrittenOnNewLine(o.state.skipped);
33
+ }
34
+
35
+ function outcomeLine(o: CompactOutcome): string {
36
+ switch (o.status) {
37
+ case "compacted":
38
+ return `✓ compacted ${o.before} → ${o.after} messages` +
39
+ (o.usedTokens !== undefined ? ` (was ~${o.usedTokens} tokens)` : "");
40
+ case "skipped":
41
+ return o.reason === BUFFER_TOO_SMALL ? BUFFER_TOO_SMALL_TO_COMPACT : `Compaction skipped (${o.reason}).`;
42
+ default:
43
+ return `Compaction failed: ${o.reason}` +
44
+ (o.fallback === "snip" ? SNIPPED_INSTEAD : "");
45
+ }
46
+ }
@@ -0,0 +1,162 @@
1
+ // Compaction thresholds and budgets — pure constants and the trigger math.
2
+ //
3
+ // Every number is derived from a fact of this project, stated next to it: the
4
+ // runtime's cut of a file_read result, the answer size of the example settings,
5
+ // the ceiling of the main loop's header, the skills block's cap. Change the fact
6
+ // and the number follows; a number with no such reason does not belong here.
7
+ //
8
+ // Run tests: node --test src/shared/domain/compaction-thresholds.test.ts
9
+ import { A_TOKEN_COUNT } from "./messages.ts";
10
+
11
+ /** chars→tokens heuristic shared with the token_budget tool. */
12
+ export const CHARS_PER_TOKEN = 4;
13
+
14
+ /** The largest single tool result a turn receives: the runtime cuts a file_read
15
+ * result at 32 000 characters. */
16
+ export const FILE_READ_CUT_TOKENS = 32_000 / CHARS_PER_TOKEN;
17
+
18
+ /** The longest answer a turn may write: `Llm:MaxTokens` of config/appsettings.example.json. */
19
+ export const ANSWER_RESERVE_TOKENS = 24_576;
20
+
21
+ /** The parts of a turn that are not the history: the system header (at most
22
+ * 9 500 characters, MAX_STATIC_HEADER_CHARS) and the user body's fixed blocks,
23
+ * rounded up. */
24
+ export const TURN_FIXED_TOKENS = 4_000;
25
+
26
+ /**
27
+ * Room a turn needs above the buffer it starts from: its fixed parts, one file
28
+ * read at the runtime's cut and an answer at the example settings' size.
29
+ * Compaction triggers when the buffer leaves less room than that.
30
+ */
31
+ export const AUTOCOMPACT_BUFFER_TOKENS = TURN_FIXED_TOKENS + FILE_READ_CUT_TOKENS + ANSWER_RESERVE_TOKENS;
32
+
33
+ /**
34
+ * The window assumed when token_budget reports none. Erring small is the safe
35
+ * side: an underestimate compacts early, an overestimate overflows. 128 000
36
+ * tokens is a window most current chat models offer.
37
+ */
38
+ export const DEFAULT_CONTEXT_WINDOW = 128_000;
39
+
40
+ /**
41
+ * Failed compactions in a row before the breaker opens. One failure can be a
42
+ * provider hiccup; several in a row mean the summary call itself is broken, and
43
+ * retrying it at the head and the tail of every turn would triple each turn's cost.
44
+ */
45
+ export const MAX_CONSECUTIVE_FAILURES = 3;
46
+
47
+ /**
48
+ * The transcript fed to the summary and to the memory extraction, in characters
49
+ * (12 000 tokens). With the instructions and a summary at its word cap it fits any
50
+ * window this code assumes, and cut in the middle (head and tail kept) it still
51
+ * holds the task and the current work of a long session.
52
+ */
53
+ export const TRANSCRIPT_CAP_CHARS = 48_000;
54
+
55
+ /** Turns the fallback of a failed summary keeps, besides the head: a turn is a user request with the tool traces and
56
+ * the answer that follow it, kept whole (Orkeon #287). Two, below the runtime's default of three: the snip runs with
57
+ * the window past the trigger, where three whole turns may free little; two keep the exchange a short reply answers
58
+ * ("yes, do it") with the request still waiting at the head of a turn, about what the five messages kept before #287.
59
+ * `/compact --snip` keeps SNIP_COMMAND_TURNS unless told otherwise. */
60
+ export const SNIP_RETAIN_COUNT = 2;
61
+
62
+ /** Turns `/compact --snip` keeps whole when it names no count: three, the runtime's own default (Orkeon #287). */
63
+ export const SNIP_COMMAND_TURNS = 3;
64
+
65
+ /** Facts extracted per compaction: a session yields a handful of durable facts;
66
+ * more is task state passing for memory. */
67
+ export const MAX_EXTRACTED_MEMORIES = 8;
68
+
69
+ // ── After a compaction: files and skills read back ──────────────────────
70
+
71
+ /** Files read back after a compaction, the most recently named first: the
72
+ * current step's file and a few it depends on. Anything older the agent reads
73
+ * again when it needs it. */
74
+ export const POST_COMPACT_MAX_FILES_TO_RESTORE = 5;
75
+
76
+ /** Largest file read back whole (20 000 characters, inside file_read's cut). A
77
+ * larger file comes back as its path with a note to read it, never cut: a cut
78
+ * copy could feed a whole-file write and erase the rest. */
79
+ export const POST_COMPACT_PER_FILE_TOKENS = 5_000;
80
+
81
+ /** Token budget for all restored files together: bounded by construction. */
82
+ export const POST_COMPACT_TOKEN_BUDGET = POST_COMPACT_MAX_FILES_TO_RESTORE * POST_COMPACT_PER_FILE_TOKENS;
83
+
84
+ /** A skill read back after a compaction is capped like the skills block of a turn
85
+ * (4 000 characters, MAX_SKILL_FRAGMENT_CHARS), so the copy is never longer than
86
+ * what the turn shows. */
87
+ export const POST_COMPACT_PER_SKILL_TOKENS = 1_000;
88
+
89
+ /**
90
+ * Skills read back after a compaction get their OWN budget, five skills at their
91
+ * cap, separate from the files'. The two restores serve different reasons: files
92
+ * are what the agent was just touching, skills are what the operator decided
93
+ * should always apply. Sharing one budget would let a handful of large files
94
+ * silently evict every playbook — the failure would look like "the agent forgot
95
+ * the rules after a compaction".
96
+ */
97
+ export const POST_COMPACT_SKILLS_TOKEN_BUDGET = 5 * POST_COMPACT_PER_SKILL_TOKENS;
98
+
99
+ // ── Pressure tiers ──────────────────────────────────────────────────────
100
+
101
+ /** Warning tier: the room left is below what a turn needs. Compaction is due; if
102
+ * it could not run (the breaker is open), the turn must wind down. */
103
+ export const WARNING_THRESHOLD_BUFFER_TOKENS = AUTOCOMPACT_BUFFER_TOKENS;
104
+
105
+ /** Error tier: one more file read at the runtime's cut could overflow the window. */
106
+ export const ERROR_THRESHOLD_BUFFER_TOKENS = FILE_READ_CUT_TOKENS;
107
+
108
+ /** Normalise a possibly-unreported window to the default (shared by the tiers). */
109
+ function effectiveWindow(contextWindow: number): number {
110
+ return contextWindow > 0 ? contextWindow : DEFAULT_CONTEXT_WINDOW;
111
+ }
112
+
113
+ /** The setting that moves the automatic compaction's trigger (`/config set compaction.trigger 90k`). */
114
+ export const COMPACTION_TRIGGER_CONFIG_KEY = "compaction.trigger";
115
+
116
+ /** A token count as the setting writes it: `90000` or `90k`; undefined when it is not one. */
117
+ export function parseTokenCount(value: unknown): number | undefined {
118
+ const m = /^\s*(\d+(?:\.\d+)?)\s*(k)?\s*$/i.exec(String(value ?? ""));
119
+ if (!m) return undefined;
120
+ const n = Math.round(Number(m[1]) * (m[2] ? 1_000 : 1));
121
+ return n > 0 ? n : undefined;
122
+ }
123
+
124
+ /** Why a compaction.trigger value is refused; undefined when it is a token count. */
125
+ export function compactionTriggerProblem(value: string): string | undefined {
126
+ return parseTokenCount(value) === undefined ? A_TOKEN_COUNT : undefined;
127
+ }
128
+
129
+ /** Token count at which auto-compaction triggers for a given window: the
130
+ * `compaction.trigger` setting when one is given, else the window minus the buffer. */
131
+ export function computeTrigger(contextWindow: number, trigger?: number): number {
132
+ if (trigger !== undefined && trigger > 0) return trigger;
133
+ return effectiveWindow(contextWindow) - AUTOCOMPACT_BUFFER_TOKENS;
134
+ }
135
+
136
+ /** True when the used tokens have reached the trigger (equality counts). */
137
+ export function shouldCompact(usedTokens: number, contextWindow: number, trigger?: number): boolean {
138
+ return usedTokens >= computeTrigger(contextWindow, trigger);
139
+ }
140
+
141
+ /** Warning tier reached: used ≥ window − WARNING_THRESHOLD_BUFFER_TOKENS. */
142
+ export function isAboveWarningThreshold(usedTokens: number, contextWindow: number): boolean {
143
+ return usedTokens >= effectiveWindow(contextWindow) - WARNING_THRESHOLD_BUFFER_TOKENS;
144
+ }
145
+
146
+ /** Error tier reached: used ≥ window − ERROR_THRESHOLD_BUFFER_TOKENS. */
147
+ export function isAboveErrorThreshold(usedTokens: number, contextWindow: number): boolean {
148
+ return usedTokens >= effectiveWindow(contextWindow) - ERROR_THRESHOLD_BUFFER_TOKENS;
149
+ }
150
+
151
+ /** Percentage of the window still free, clamped to [0, 100]. */
152
+ export function percentLeft(usedTokens: number, contextWindow: number): number {
153
+ const window = effectiveWindow(contextWindow);
154
+ return Math.max(0, Math.min(100, Math.round(100 * (window - usedTokens) / window)));
155
+ }
156
+
157
+ /** The graduated pressure tier (`/context`, `/usage`, the turn's gauge): ok | warning | error. */
158
+ export function pressureTier(usedTokens: number, contextWindow: number): "ok" | "warning" | "error" {
159
+ if (isAboveErrorThreshold(usedTokens, contextWindow)) return "error";
160
+ if (isAboveWarningThreshold(usedTokens, contextWindow)) return "warning";
161
+ return "ok";
162
+ }
@@ -0,0 +1,288 @@
1
+ // Pure compaction helpers — no IO. The prompts of the compaction (the summary and
2
+ // the memory extraction), the markers the model later reads in its history, and
3
+ // the buffer rewrite. Shared by /compact and the main loop's automatic compaction
4
+ // (shared/application/compaction/). The prompt text is written from the
5
+ // specification in docs/turn.md, "Compaction and memory".
6
+ //
7
+ // Run tests: node --test src/shared/domain/compaction.test.ts
8
+
9
+ import type { CompactBoundaryMessage, PromptPair, SessionMsg } from "./types.ts";
10
+ import { MAX_EXTRACTED_MEMORIES, TRANSCRIPT_CAP_CHARS } from "./compaction-thresholds.ts";
11
+ import { MEMORY_CATEGORIES } from "./agent-policy/memory-categories.ts";
12
+ import { COMPACT_BOUNDARY_MARKER, COMPACTED_HEADER, SUMMARY_CLOSE, SUMMARY_OPEN } from "./markers.ts";
13
+ import {
14
+ EVERY_TDD_LINE_TICKED, EXTRACTION_TRANSCRIPT_INTRO, firstOpenStep, KNOWN_MEMORIES, KNOWN_MEMORIES_WITH_IDS,
15
+ MEMORY_EXTRACTION_INSTRUCTIONS, MEMORY_RECAP_HEADING, middleLeftOut, restoredFile, restoredFileNotice, restoredSkill,
16
+ restoredState, SNIP_NOTICE, SUMMARY_INSTRUCTIONS, summaryClosing, summaryFocus, todayIs,
17
+ } from "./prompts.ts";
18
+
19
+ /** A buffer with this many messages or fewer is not worth compacting. */
20
+ export const MIN_COMPACTABLE = 2;
21
+
22
+ /** Render the conversation buffer as a `role: content` transcript. */
23
+ export function buildTranscript(messages: SessionMsg[]): string {
24
+ return messages.map((m) => `${m.role}: ${m.content}`).join("\n");
25
+ }
26
+
27
+ /** Ceiling on the summary's length, stated to the model, in words. */
28
+ export const SUMMARY_MAX_WORDS = 900;
29
+
30
+ /**
31
+ * Fit a transcript to `cap` characters, keeping its head and its tail.
32
+ *
33
+ * The head holds the task as the user first stated it, the tail the current work:
34
+ * cutting at the head (as a plain slice does) loses the recent work first, which is
35
+ * exactly what the next turn needs. A quarter goes to the head, the rest to the
36
+ * tail, and the marker in between says how much was left out.
37
+ */
38
+ export function clipTranscript(transcript: string, cap: number): string {
39
+ if (transcript.length <= cap) return transcript;
40
+ const head = Math.floor(cap / 4);
41
+ const tail = cap - head;
42
+ const omitted = transcript.length - head - tail;
43
+ return (
44
+ transcript.slice(0, head) +
45
+ middleLeftOut(omitted) +
46
+ transcript.slice(transcript.length - tail)
47
+ );
48
+ }
49
+
50
+ /** The transcript as material: between fixed tags, after the instructions. */
51
+ function asMaterial(transcript: string): string {
52
+ return "<transcript>\n" + clipTranscript(transcript, TRANSCRIPT_CAP_CHARS) + "\n</transcript>";
53
+ }
54
+
55
+ /**
56
+ * Prompt that asks the model for the compaction summary.
57
+ *
58
+ * The summary REPLACES the history, so it is written for a reader who resumes
59
+ * cold, not as a recap; what comes back on its own after a compaction (memory,
60
+ * the instructions file, the playbooks, a few files read back) is named so the
61
+ * summary spends its words on the state of the work. The answer goes between fixed markers so the
62
+ * host stores the summary and nothing else. `focus` is the operator's
63
+ * `/compact <focus>`. The instructions are the system message, the transcript the
64
+ * user message.
65
+ */
66
+ export function buildSummaryPrompt(transcript: string, focus?: string): PromptPair {
67
+ const lines = [...SUMMARY_INSTRUCTIONS];
68
+ const keep = String(focus ?? "").trim();
69
+ if (keep.length > 0) {
70
+ lines.push("", summaryFocus(keep));
71
+ }
72
+ lines.push("", summaryClosing(SUMMARY_MAX_WORDS, SUMMARY_OPEN, SUMMARY_CLOSE));
73
+ return { system: lines.join("\n"), user: asMaterial(transcript) };
74
+ }
75
+
76
+ /**
77
+ * The summary the model wrote: the text between the markers when it used them
78
+ * (the last closing marker, so a marker quoted inside the summary does not cut
79
+ * it), else the whole reply. "" means the model returned nothing usable.
80
+ */
81
+ export function extractSummary(raw: string): string {
82
+ const text = String(raw ?? "");
83
+ const open = text.indexOf(SUMMARY_OPEN);
84
+ const close = text.lastIndexOf(SUMMARY_CLOSE);
85
+ if (open >= 0 && close > open) return text.slice(open + SUMMARY_OPEN.length, close).trim();
86
+ return text.split(SUMMARY_OPEN).join("").split(SUMMARY_CLOSE).join("").trim();
87
+ }
88
+
89
+ /** The typed boundary inserted as the FIRST post-compact message. */
90
+ export function buildCompactBoundaryMessage(): CompactBoundaryMessage {
91
+ return { role: "system", subtype: "compact_boundary", content: COMPACT_BOUNDARY_MARKER };
92
+ }
93
+
94
+ /**
95
+ * The note left in the buffer when earlier turns were cut with no summary (a snip
96
+ * alone). It opens with [compacted] so the history reads it as material, and it is
97
+ * no boundary: `isCompactBoundary` matches the subtype or `[compact-boundary]` only,
98
+ * and the history block hides boundaries, while this note must be read.
99
+ */
100
+ export function buildSnipNoticeMessage(): SessionMsg {
101
+ return { role: "system", content: SNIP_NOTICE };
102
+ }
103
+
104
+ /** True for a compaction boundary — by subtype when present, else by marker. */
105
+ export function isCompactBoundary(msg: any): boolean {
106
+ return String(msg?.subtype ?? "") === "compact_boundary"
107
+ || String(msg?.content ?? "").startsWith(COMPACT_BOUNDARY_MARKER);
108
+ }
109
+
110
+ /** Count the compaction boundaries in a buffer (`/context` display). */
111
+ export function countCompactBoundaries(messages: any[]): number {
112
+ return (messages ?? []).filter(isCompactBoundary).length;
113
+ }
114
+
115
+ /** Rewrite the buffer: keep the first message as an anchor, insert the typed
116
+ * boundary, then replace the rest with the summary. `head` verbatim: the entry
117
+ * as the session stored it, whatever its shape. */
118
+ export function buildCompactedBuffer<Head>(head: Head, summary: string): Array<Head | SessionMsg> {
119
+ return [
120
+ head,
121
+ buildCompactBoundaryMessage(),
122
+ { role: "system", content: COMPACTED_HEADER + "\n" + summary.trim() },
123
+ ];
124
+ }
125
+
126
+ // ── Post-compaction file restoration — pure parts ───────────────────────
127
+
128
+ // A path-like token: at least one directory separator and a dotted extension,
129
+ // not part of a URL. Kept deliberately conservative — a missed path only means
130
+ // one fewer restored file, while a false positive costs a failed fileRead.
131
+ const FILE_PATH_RE = /(?:^|[\s"'`(\[<=:])((?:\/|\.{1,2}\/)?(?:[\w@.-]+\/)+[\w@.-]+\.[A-Za-z0-9]{1,8})(?=$|[\s"'`)\]>,;])/g;
132
+
133
+ /** Extract path-like tokens from the buffer, most recent first, deduped. */
134
+ export function extractRecentFilePaths(messages: SessionMsg[], cap: number): string[] {
135
+ const seen = new Set<string>();
136
+ const out: string[] = [];
137
+ for (let i = (messages ?? []).length - 1; i >= 0 && out.length < cap; i--) {
138
+ const content = String(messages[i]?.content ?? "");
139
+ if (content.includes("://")) continue; // URL-bearing lines: skip cheaply, not worth splitting
140
+ const local: string[] = [];
141
+ let m: RegExpExecArray | null;
142
+ FILE_PATH_RE.lastIndex = 0;
143
+ while ((m = FILE_PATH_RE.exec(content)) !== null) local.push(m[1]);
144
+ // Within one message keep textual order; messages themselves are walked
145
+ // newest-first so the overall order is recency.
146
+ for (const p of local) {
147
+ if (seen.has(p)) continue;
148
+ seen.add(p);
149
+ out.push(p);
150
+ if (out.length >= cap) break;
151
+ }
152
+ }
153
+ return out;
154
+ }
155
+
156
+ /** The message that points at the state file written before the compaction (step 0): the
157
+ * batch in progress, where its facts are, and the step to resume at. */
158
+ export function buildRestoredStateMessage(path: string, firstOpen: string | null): SessionMsg {
159
+ const resume = firstOpen === null ? EVERY_TDD_LINE_TICKED : firstOpenStep(firstOpen);
160
+ return { role: "system", content: restoredState(resume, path) };
161
+ }
162
+
163
+ /** The re-injected file message: the whole content between an opening line that
164
+ * says what it is and a closing marker, so the model sees where the copy ends. */
165
+ export function buildRestoredFileMessage(path: string, content: string): SessionMsg {
166
+ return { role: "system", content: restoredFile(path, content) };
167
+ }
168
+
169
+ /** A file too large to read back whole: its path and a note, never a cut copy (a
170
+ * cut copy could feed a whole-file write and erase the rest of the file). */
171
+ export function buildRestoredFileNotice(path: string): SessionMsg {
172
+ return { role: "system", content: restoredFileNotice(path) };
173
+ }
174
+
175
+ /**
176
+ * A skill re-injected after compaction.
177
+ *
178
+ * A distinct marker from `[restored-file]` on purpose: a file came back because
179
+ * the agent had just touched it, a skill came back because the operator attached
180
+ * it and expects it to survive every compaction. Reading the buffer afterwards,
181
+ * the two answer different questions.
182
+ */
183
+ export function buildRestoredSkillMessage(path: string, content: string): SessionMsg {
184
+ return { role: "system", content: restoredSkill(path, content) };
185
+ }
186
+
187
+ /** One durable fact extracted from the conversation before compaction; `replaces` is the id of the known entry it
188
+ * makes out of date, when it names one the prompt listed, of the same category. */
189
+ export interface ExtractedMemory {
190
+ category: string;
191
+ content: string;
192
+ replaces?: number;
193
+ }
194
+
195
+ /** An entry the memory store already holds, as the extraction prompt lists it: by its id when the store gives one. */
196
+ export interface KnownMemory {
197
+ id?: number;
198
+ /** Undefined when the store reports none: such an entry is never replaced. */
199
+ category?: string;
200
+ content: string;
201
+ }
202
+
203
+ /** JSON schema handed to the extraction call of the pre-compaction memory pass. */
204
+ export const MEMORY_EXTRACTION_SCHEMA = {
205
+ type: "object",
206
+ properties: {
207
+ items: {
208
+ type: "array",
209
+ items: {
210
+ type: "object",
211
+ properties: {
212
+ category: { type: "string", enum: [...MEMORY_CATEGORIES] },
213
+ content: { type: "string" },
214
+ replaces: { type: "integer" },
215
+ },
216
+ required: ["category", "content"],
217
+ },
218
+ },
219
+ },
220
+ required: ["items"],
221
+ } as const;
222
+
223
+ /** How many known memories the extraction prompt lists, so it can skip them. */
224
+ export const MAX_KNOWN_MEMORIES_IN_PROMPT = 40;
225
+
226
+ /** The known entries the extraction prompt lists: the non-empty ones, trimmed, capped. */
227
+ function listedKnown(known: readonly KnownMemory[]): KnownMemory[] {
228
+ return known
229
+ .map((k) => ({ ...k, content: String(k.content ?? "").trim() }))
230
+ .filter((k) => k.content.length > 0)
231
+ .slice(0, MAX_KNOWN_MEMORIES_IN_PROMPT);
232
+ }
233
+
234
+ /**
235
+ * Prompt for the memory extraction run before a compaction.
236
+ *
237
+ * Each category is defined together with what does not belong in it, because the
238
+ * failure is never an empty list: it is task state stored as memory. `known` are
239
+ * the entries the store already holds, listed so the model does not repeat them, each
240
+ * by its id when it has one, so a new fact can name the stale entry it replaces.
241
+ * `today` (YYYY-MM-DD), when given, is stated so a relative date becomes an absolute one.
242
+ */
243
+ export function buildMemoryExtractionPrompt(transcript: string, known: readonly KnownMemory[] = [], today?: string): string {
244
+ const lines = [...MEMORY_EXTRACTION_INSTRUCTIONS];
245
+ const date = String(today ?? "").trim();
246
+ if (date.length > 0) {
247
+ lines.splice(1, 0, todayIs(date));
248
+ }
249
+ const already = listedKnown(known);
250
+ if (already.length > 0) {
251
+ const intro = already.some((k) => k.id !== undefined) ? KNOWN_MEMORIES_WITH_IDS : KNOWN_MEMORIES;
252
+ lines.push("", intro, ...already.map((k) => `- ${k.id === undefined ? "" : `[${k.id}] `}${k.content}`));
253
+ }
254
+ lines.push("", EXTRACTION_TRANSCRIPT_INTRO, asMaterial(transcript));
255
+ return lines.join("\n");
256
+ }
257
+
258
+ /** Keep only well-formed items with a valid category, capped. An item keeps its `replaces` when it names an entry of
259
+ * `known` the prompt listed, of the item's own category (the store's `replace` keeps the entry's category), and the
260
+ * first item to name it only; any other item is added. */
261
+ export function sanitizeExtractedMemories(raw: any, known: readonly KnownMemory[] = []): ExtractedMemory[] {
262
+ const items: any[] = Array.isArray(raw?.items) ? raw.items : Array.isArray(raw) ? raw : [];
263
+ const valid = new Set<string>(MEMORY_CATEGORIES);
264
+ const replaceable = new Map(listedKnown(known).flatMap((k) => (k.id === undefined ? [] : [[k.id, k.category] as const])));
265
+ const kept = items
266
+ .map((it) => ({
267
+ category: String(it?.category ?? "").trim(),
268
+ content: String(it?.content ?? "").trim(),
269
+ replaces: it?.replaces,
270
+ }))
271
+ .filter((it) => valid.has(it.category) && it.content.length > 0)
272
+ .slice(0, MAX_EXTRACTED_MEMORIES);
273
+ return kept.map(({ replaces, ...it }) => {
274
+ if (!Number.isInteger(replaces) || !replaceable.has(replaces) || replaceable.get(replaces) !== it.category) return it;
275
+ replaceable.delete(replaces);
276
+ return { ...it, replaces };
277
+ });
278
+ }
279
+
280
+ /** Bounded recap re-injected after the rewrite so the memories stay visible until
281
+ * the Memory block of the next turn shows them. */
282
+ export function buildMemoryRecapMessage(items: ExtractedMemory[]): SessionMsg {
283
+ const lines = items.map((it) => `- [${it.category}] ${it.content}`);
284
+ return {
285
+ role: "system",
286
+ content: MEMORY_RECAP_HEADING + lines.join("\n"),
287
+ };
288
+ }