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,452 @@
1
+ // One wave of a parallel /dev-batches (`--concurrency n`, n from 2; temp/26 L8P-D1): the batches of the wave, at
2
+ // most n, each on its own worktree `.orkeon/worktrees/<code>-F<n>` and branch `batches/<code>/F<n>`, made from the
3
+ // work branch or reused when a killed run left it. The first wave's probe proves git works under a worktree as a
4
+ // working root (Orkeon/orkeon#188); every worktree is seeded (seed-harvest.ts); the launches are logged and written;
5
+ // then `runBatch`, the crew's (a batch agent under the worktree, its implement, audit and close), runs them all at
6
+ // once. Once all have settled the driver, only writer of the main checkout, takes them in id order: a VALID batch is
7
+ // merged by fast-forward (rebased in its worktree when needed), its files harvested, its batch marked done in the
8
+ // global plan, its worktree removed; a GAPS or BLOCKED one is logged and keeps its worktree, its sheet, verdict and
9
+ // code there alone - the main checkout never claims work whose code it lacks - and the run stops there (a human
10
+ // decides) - a neighbour still running is never stopped (L8P-D9). A GAPS verdict is first relaunched at once in its
11
+ // worktree, the verdict's Blocking and Major rows as the correction, until the third audit round in GAPS since the last
12
+ // VALID (GAPS_ROUNDS_MAX); that one stops. Typed again with its concurrency, the run relaunches a stopped batch in that
13
+ // worktree, a GAPS verdict's correction carried by the log.
14
+ import type { Files, Shell } from "../../../shared/application/ports.ts";
15
+ import { gitReason, runGit } from "../../../shared/application/git/commit-files.ts";
16
+ import { createBatchWorktree, mergeValidBatch, removeBatchWorktree } from "../../../shared/application/git/batch-worktree.ts";
17
+ import { concurrencyGitRefusal } from "../../../shared/domain/dev/batches-concurrency.ts";
18
+ import type { BatchesLogEntry } from "../../../shared/domain/dev/batches-state.ts";
19
+ import { parseBatchSheet } from "../../../shared/domain/dev/plan-format.ts";
20
+ import { batchValidLine } from "../../../shared/domain/dev/markers.ts";
21
+ import { batchBranch, batchWorktreeName, gitBranchExists, gitCommitsNotIn, gitIsIgnored, gitIsMergedInto, gitWorktreeHead, worktreePlace } from "../../../shared/domain/git/worktree.ts";
22
+ import type { WorktreePlace } from "../../../shared/domain/git/worktree.ts";
23
+ import { shellQuote } from "../../../shared/domain/git/close.ts";
24
+ import { markPlanBatchDone } from "../../dev-implement/domain/sheet-edits.ts";
25
+ import { eventLine, lastEntryOf } from "../domain/batches-log.ts";
26
+ import { harvestBatch, seedWorktree } from "./seed-harvest.ts";
27
+ import type { SeedSnapshot, SeedTarget } from "./seed-harvest.ts";
28
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
29
+ import { BATCH_ANSWERED_NOTHING, HASH_NOT_READ, IT_ANSWERED_NOTHING, LOG_UNWRITABLE, NO_CORRECTION_RESUMES, batchAgentAnswered, branchNotOnWorktree, budgetStop, closeStop, doneBeforeStop, gapsRoundsHuman, logUnwritableNotRelaunched, stoppedNoVerdict, notAWorktreeName, planNotMarked, relaunchedAfterGaps, stateNotIgnored, stayInWorktree, worktreeKept } from "./messages.ts";
30
+ import { worktreeCreated as worktreeMade } from "../../../shared/application/git/messages.ts";
31
+ import {
32
+ GAPS_ROUNDS_MAX, gapsFinding, gapsRoundsOf, isNextStepLine, parseCorrectionLine, parseVerdictFile,
33
+ } from "../../../shared/domain/dev/verdict-format.ts";
34
+
35
+ /** What the crew's batch agent is run with. */
36
+ export interface BatchRun {
37
+ /** The work code: the plan its chain runs. */
38
+ code: string;
39
+ batch: string;
40
+ /** The worktree's name, `<code>-F<n>`. */
41
+ name: string;
42
+ /** The agent's working root, `/workspace/.orkeon/worktrees/<name>`. */
43
+ root: string;
44
+ branch: string;
45
+ /** The open steps of its sheet; absent, every step. */
46
+ steps?: number;
47
+ /** The finding of the GAPS verdict it returned last (the log's), appended to its sheet as a step first. */
48
+ correction?: string;
49
+ /** The `stale:` lines of its review's Major rows, on its first launch only: they end its RED and GREEN prompts. */
50
+ stale?: readonly string[];
51
+ }
52
+
53
+ /** What a batch agent answers. */
54
+ export interface BatchOutcome {
55
+ batch: string;
56
+ verdict: "VALID" | "GAPS" | "BLOCKED" | null;
57
+ /** The close's commit, on a VALID batch. */
58
+ hash?: string;
59
+ lines: string[];
60
+ /** The tool calls it made. */
61
+ spent: number;
62
+ /** On GAPS, the finding its audit names for the correction. */
63
+ correction?: string;
64
+ }
65
+
66
+ /** The outcome a batch agent answered (its JSON, for this batch); its text as the lines of a BLOCKED one otherwise. */
67
+ export function outcomeOf(batch: string, answered: unknown): BatchOutcome {
68
+ const text = typeof answered === "string" ? answered : JSON.stringify(answered);
69
+ try {
70
+ const value = JSON.parse(text) as BatchOutcome;
71
+ if (value !== null && value.batch === batch && Array.isArray(value.lines)) return value;
72
+ } catch {
73
+ // Not the chain's JSON.
74
+ }
75
+ return { batch, verdict: "BLOCKED", lines: [batchAgentAnswered(text.split("\n")[0])], spent: 0 };
76
+ }
77
+
78
+ export interface WaveDeps {
79
+ files: Pick<Files, "read" | "write" | "list">;
80
+ shell: Pick<Shell, "run">;
81
+ /** Runs one batch under its worktree, the crew's. */
82
+ runBatch(run: BatchRun): Promise<BatchOutcome>;
83
+ /** git's top as an agent under `root` sees it (`git rev-parse --show-toplevel`); throws when the root is refused. */
84
+ probe?(root: string): Promise<{ exitCode: number; top: string }>;
85
+ /** After a GAPS verdict, over the work folder of the batch's worktree (`vfsPath`), where its verdict stays: the
86
+ * mistakes harvested, its lines. */
87
+ afterGaps?(vfsPath: string): Promise<string[]>;
88
+ }
89
+
90
+ /** The driver's log, appended in memory and written by `save` (the line saying it could not, else null). */
91
+ export interface WaveLog {
92
+ add(line: string): void;
93
+ entries(): readonly BatchesLogEntry[];
94
+ save(): Promise<string | null>;
95
+ }
96
+
97
+ export interface WaveRequest {
98
+ code: string;
99
+ concurrency: number;
100
+ /** The batches of the wave, in id order, at most `concurrency`. */
101
+ wave: readonly string[];
102
+ workBranch: string;
103
+ /** The work folder and memory.dir, relative to the checkout. */
104
+ work: string;
105
+ memoryDir: string;
106
+ /** The clock each logged event reads: a wave runs for minutes. */
107
+ clock(): Date;
108
+ /** True for the run's first wave: the probe runs before any launch. */
109
+ probe: boolean;
110
+ /** Each batch's sheet file name. */
111
+ sheets: Readonly<Record<string, string>>;
112
+ /** The audits of a batch's verdict file now (the launch's detail). */
113
+ audits(batch: string): number;
114
+ steps(batch: string): number | undefined;
115
+ /** The `stale:` lines the review of each batch left (its Major rows), handed to its first launch. */
116
+ stale?: Readonly<Record<string, readonly string[]>>;
117
+ book: WaveLog;
118
+ }
119
+
120
+ /** `refused`: stopped before any batch ran, the last line saying why. */
121
+ export interface WaveResult { lines: string[]; stopped: boolean; refused?: true }
122
+
123
+ interface Slot {
124
+ batch: string; place: WorktreePlace; branch: string; made: boolean; reopened: boolean; done: boolean;
125
+ snapshot?: SeedSnapshot; correction?: string; stale?: readonly string[];
126
+ /** The lines of its GAPS rounds relaunched within the wave, said before its outcome. */
127
+ said: string[];
128
+ /** The batch's verdict file in its worktree after its last GAPS, null when it could not be read. */
129
+ verdict?: string | null;
130
+ }
131
+
132
+ const reasonOf = (e: unknown): string => String((e as Error)?.message ?? e).split("\n")[0];
133
+ const stop = (lines: string[], line: string): WaveResult => ({ lines: [...lines, line], stopped: true, refused: true });
134
+
135
+ /** The line naming a kept worktree: a suite run on the main checkout may glob into it. */
136
+ export function keptLine(place: WorktreePlace): string {
137
+ return worktreeKept(place.path);
138
+ }
139
+
140
+ /** The line saying where a stopped batch is and the exact command that relaunches it there. */
141
+ export function resumeLine(req: Pick<WaveRequest, "code" | "concurrency">, batch: string, place: WorktreePlace, correction?: string): string {
142
+ return stayInWorktree(batch, place.path, req.code, req.concurrency, correction);
143
+ }
144
+
145
+ const CORRECTION = /— correction: (.+)$/;
146
+ /** The correction a log entry `returned GAPS — correction: <finding>` carries. */
147
+ const correctionOf = (detail: string): string | undefined =>
148
+ detail.startsWith("GAPS") ? CORRECTION.exec(detail)?.[1]?.trim() : undefined;
149
+
150
+ /** The worktree of a batch: made, or reused when its branch exists with the worktree on it. */
151
+ async function placeOf(shell: Pick<Shell, "run">, req: WaveRequest, batch: string): Promise<{ ok: true; slot: Slot } | { ok: false; line: string }> {
152
+ const name = batchWorktreeName(req.code, batch);
153
+ const branch = batchBranch(req.code, batch);
154
+ const place = worktreePlace(name);
155
+ if (place === null) return { ok: false, line: notAWorktreeName(name) };
156
+ const entries = req.book.entries();
157
+ const last = lastEntryOf(entries, batch);
158
+ const reopened = last !== undefined;
159
+ const correction = last?.event === "returned" ? correctionOf(last.detail) : undefined;
160
+ // The stale lines go to the batch's first launch only: a relaunch (from the log or after a GAPS) carries none, the
161
+ // first implementation already saw them.
162
+ const launchedBefore = entries.some((e) => e.batch === batch && (e.event === "launched" || e.event === "relaunched"));
163
+ const stale = launchedBefore ? undefined : req.stale?.[batch];
164
+ const extra = { said: [], ...(correction === undefined ? {} : { correction }), ...(stale === undefined || stale.length === 0 ? {} : { stale }) };
165
+ if ((await runGit(shell, gitBranchExists(branch))).exitCode !== 0) {
166
+ const made = await createBatchWorktree(shell, { name, branch, base: req.workBranch });
167
+ return made.ok ? { ok: true, slot: { batch, place, branch, made: true, reopened, done: false, ...extra } } : { ok: false, line: made.line };
168
+ }
169
+ const head = await runGit(shell, gitWorktreeHead(place.path));
170
+ if (head.exitCode !== 0 || head.stdout.trim() !== `refs/heads/${branch}`) {
171
+ return { ok: false, line: branchNotOnWorktree(branch, place.path, head.exitCode === 0 ? head.stdout.trim() : gitReason(head)) };
172
+ }
173
+ return { ok: true, slot: { batch, place, branch, made: false, reopened: true, done: false, ...extra } };
174
+ }
175
+
176
+ /** A reused worktree whose sheet is done and whose branch holds the close's commit, merged or not yet (a run killed
177
+ * between its merge and its removal): merged, harvested and removed without a run. */
178
+ /** The main checkout's global plan with a merged batch marked done: the plan never comes back from a worktree
179
+ * (seed-harvest.ts), so the driver marks it, as the close of a one-at-a-time run does beside the sheet. */
180
+ async function markPlanDone(files: Pick<Files, "read" | "write">, req: WaveRequest, batch: string): Promise<string[]> {
181
+ const sheet = req.sheets[batch];
182
+ if (sheet === undefined) return [];
183
+ const name = sheet.replace(/-F\d+\.md$/, ".md");
184
+ const path = `${WORKSPACE}/${req.work}/${req.code}/${name}`;
185
+ try {
186
+ const plan = await files.read(path);
187
+ const marked = markPlanBatchDone(plan, batch, req.clock().toISOString().slice(0, 10));
188
+ if (marked !== plan) await files.write(path, marked);
189
+ return [];
190
+ } catch (e) {
191
+ return [planNotMarked(name, batch, reasonOf(e))];
192
+ }
193
+ }
194
+
195
+ async function closedBefore(deps: WaveDeps, req: WaveRequest, slot: Slot): Promise<boolean> {
196
+ const sheet = req.sheets[slot.batch];
197
+ if (slot.made || sheet === undefined) return false;
198
+ try {
199
+ const text = await deps.files.read(`${slot.place.root}/${req.work}/${req.code}/${sheet}`);
200
+ if (parseBatchSheet(text).doneDate === undefined) return false;
201
+ } catch {
202
+ return false;
203
+ }
204
+ const ahead = await runGit(deps.shell, gitCommitsNotIn(slot.branch, req.workBranch));
205
+ if (ahead.exitCode === 0 && Number(ahead.stdout.trim()) > 0) return true;
206
+ return (await runGit(deps.shell, gitIsMergedInto(slot.branch, req.workBranch))).exitCode === 0;
207
+ }
208
+
209
+ /** The probe's refusal, null when git answers under the worktree with the worktree as its top. */
210
+ async function probeRefusal(deps: WaveDeps, req: WaveRequest, place: WorktreePlace): Promise<string | null> {
211
+ if (!req.probe || deps.probe === undefined) return null;
212
+ try {
213
+ const seen = await deps.probe(place.root);
214
+ if (seen.exitCode === 0 && seen.top.trim() === place.root) return null;
215
+ } catch (e) {
216
+ return `BLOCKED — ${reasonOf(e)}`;
217
+ }
218
+ return `BLOCKED — ${concurrencyGitRefusal(req.concurrency)}`;
219
+ }
220
+
221
+ /** The verdict file a batch's audit wrote in its worktree, named after its sheet; null when it cannot be read. */
222
+ async function worktreeVerdict(files: Pick<Files, "read">, req: WaveRequest, slot: Slot): Promise<string | null> {
223
+ const sheet = req.sheets[slot.batch];
224
+ if (sheet === undefined) return null;
225
+ try {
226
+ return await files.read(`${slot.place.root}/${req.work}/${req.code}/${sheet.replace(/-PLAN-(F\d+)\.md$/, "-VERIFY-$1.md")}`);
227
+ } catch {
228
+ return null;
229
+ }
230
+ }
231
+
232
+ /** The stop's detail of a batch that ended neither VALID nor GAPS. */
233
+ function blockedDetail(outcome: BatchOutcome): string {
234
+ const said = outcome.lines.map((l) => l.trim()).find((l) => /^(stopped )?BLOCKED\b/.test(l));
235
+ if (said !== undefined) return `BLOCKED — ${said.replace(/^(stopped )?BLOCKED\s*—?\s*/, "")}`;
236
+ const first = outcome.lines.map((l) => l.trim()).find((l) => l !== "");
237
+ return `BLOCKED — ${first ?? BATCH_ANSWERED_NOTHING}`;
238
+ }
239
+
240
+ export async function runWave(req: WaveRequest, deps: WaveDeps): Promise<WaveResult> {
241
+ const lines: string[] = [];
242
+ const slots: Slot[] = [];
243
+ const target = (slot: Slot): SeedTarget =>
244
+ ({ place: slot.place, work: req.work, code: req.code, memoryDir: req.memoryDir, batch: slot.batch });
245
+
246
+ // 0. The dev state a worktree is seeded with must be ignored by git, or no worktree could be removed clean.
247
+ const state = `.orkeon/dev/${req.code}`;
248
+ if (req.wave.length > 0 && (await runGit(deps.shell, gitIsIgnored(state))).exitCode !== 0) {
249
+ return stop(lines, stateNotIgnored(state));
250
+ }
251
+
252
+ // 1. The worktrees, made or reused; the probe under the first one.
253
+ for (const batch of req.wave) {
254
+ const placed = await placeOf(deps.shell, req, batch);
255
+ if (!placed.ok) return stop(lines, `BLOCKED — worktree: ${placed.line}`);
256
+ slots.push(placed.slot);
257
+ if (placed.slot.made) lines.push(worktreeMade(placed.slot.place.path, placed.slot.branch, req.workBranch));
258
+ }
259
+ const refused = slots.length === 0 ? null : await probeRefusal(deps, req, slots[0].place);
260
+ if (refused !== null) {
261
+ for (const slot of slots.filter((s) => s.made)) {
262
+ const removed = await removeBatchWorktree(deps.shell, { name: slot.place.name, branch: slot.branch, into: req.workBranch });
263
+ if (!removed.ok) lines.push(`⚠ ${removed.line}`);
264
+ }
265
+ return stop(lines, refused);
266
+ }
267
+
268
+ // 2. Seeded, then the launches logged and written before any batch runs: a killed run finds them.
269
+ for (const slot of slots) {
270
+ slot.done = await closedBefore(deps, req, slot);
271
+ if (slot.done) continue;
272
+ const seeded = await seedWorktree(deps.files, target(slot), slot.made);
273
+ if (!seeded.ok) return stop(lines, `BLOCKED — seed: ${seeded.line}`);
274
+ slot.snapshot = seeded.snapshot;
275
+ }
276
+ const running = slots.filter((s) => !s.done);
277
+ for (const slot of running) {
278
+ const event = slot.reopened ? "relaunched" : "launched";
279
+ req.book.add(eventLine(req.clock(), slot.batch, event, `${slot.place.name} audits ${req.audits(slot.batch)}`));
280
+ lines.push(`→ ${slot.batch} ${event} in ${slot.place.path}`);
281
+ }
282
+ for (const slot of slots.filter((s) => s.done)) lines.push(doneBeforeStop(slot.batch, slot.place.path));
283
+ const unsaved = running.length === 0 ? null : await req.book.save();
284
+ if (unsaved !== null) return stop([...lines, unsaved], LOG_UNWRITABLE);
285
+
286
+ // 3. Every batch at once; a rejected run is a stop of its batch alone. A GAPS verdict whose audit rounds in GAPS
287
+ // are fewer than GAPS_ROUNDS_MAX runs the batch again at once in its worktree, the verdict's rows as the correction
288
+ // (none after an audit the budget stopped: its resume runs), logged returned then relaunched.
289
+ const runSlot = async (slot: Slot): Promise<BatchOutcome> => {
290
+ let correction = slot.correction;
291
+ let stale = slot.stale;
292
+ let steps = req.steps(slot.batch);
293
+ for (let round = 0; ; round++) {
294
+ const outcome = await deps.runBatch({
295
+ code: req.code, batch: slot.batch, name: slot.place.name, root: slot.place.root, branch: slot.branch,
296
+ ...(steps !== undefined ? { steps } : {}),
297
+ ...(correction !== undefined ? { correction } : {}),
298
+ ...(stale !== undefined ? { stale } : {}),
299
+ });
300
+ if (outcome.verdict !== "GAPS") return outcome;
301
+ const text = await worktreeVerdict(deps.files, req, slot);
302
+ slot.verdict = text;
303
+ // Only a verdict this audit wrote last is relaunched: one the file does not end with is a human's to read.
304
+ if (text === null || parseVerdictFile(text).sections.at(-1)?.verdict !== "GAPS") return outcome;
305
+ const rounds = gapsRoundsOf(text);
306
+ if (rounds >= GAPS_ROUNDS_MAX || round >= GAPS_ROUNDS_MAX) {
307
+ slot.said.push(gapsRoundsHuman(slot.batch, rounds));
308
+ return outcome;
309
+ }
310
+ const finding = gapsFinding(text);
311
+ const fix = finding === undefined ? "" : ` — correction: ${finding}`;
312
+ req.book.add(eventLine(req.clock(), slot.batch, "returned", `GAPS${fix}`));
313
+ req.book.add(eventLine(req.clock(), slot.batch, "relaunched", `${slot.place.name} audits ${parseVerdictFile(text).sections.length}, round ${rounds + 1}${fix}`));
314
+ slot.said.push(relaunchedAfterGaps(slot.batch, slot.place.path, rounds + 1, GAPS_ROUNDS_MAX) +
315
+ (finding === undefined ? NO_CORRECTION_RESUMES : fix));
316
+ if (deps.afterGaps !== undefined) slot.said.push(...await deps.afterGaps(`${slot.place.root}/${req.work}`));
317
+ const unsaved = await req.book.save();
318
+ if (unsaved !== null) {
319
+ slot.said.push(unsaved, logUnwritableNotRelaunched(slot.batch));
320
+ return outcome;
321
+ }
322
+ correction = finding;
323
+ stale = undefined;
324
+ steps = undefined;
325
+ }
326
+ };
327
+ const settled = await Promise.allSettled(running.map(runSlot));
328
+ const outcomes = new Map<string, BatchOutcome>();
329
+ running.forEach((slot, i) => {
330
+ const s = settled[i];
331
+ outcomes.set(slot.batch, s.status === "fulfilled" ? s.value : { batch: slot.batch, verdict: "BLOCKED", lines: [`BLOCKED — ${reasonOf(s.reason)}`], spent: 0 });
332
+ });
333
+ for (const slot of slots.filter((s) => s.done)) outcomes.set(slot.batch, { batch: slot.batch, verdict: "VALID", lines: [], spent: 0 });
334
+
335
+ // 4. In id order: merged, harvested and removed; or logged and kept, nothing of it brought back.
336
+ let stopped = false;
337
+ for (const slot of slots) {
338
+ const outcome = outcomes.get(slot.batch)!;
339
+ lines.push(...slot.said);
340
+ const harvest = async () => {
341
+ const back = await harvestBatch(deps.files, target(slot), slot.snapshot);
342
+ if (!back.ok) lines.push(back.line);
343
+ };
344
+ if (outcome.verdict === "VALID") {
345
+ const merged = await mergeValidBatch(deps.shell, {
346
+ batch: slot.batch, verdict: "VALID", branch: slot.branch, workBranch: req.workBranch, name: slot.place.name,
347
+ });
348
+ if (!merged.merged) {
349
+ req.book.add(eventLine(req.clock(), slot.batch, "stopped", `BLOCKED — merge: ${merged.line}`));
350
+ lines.push(`${slot.batch} stopped BLOCKED — merge: ${merged.line}`, keptLine(slot.place), resumeLine(req, slot.batch, slot.place));
351
+ stopped = true;
352
+ continue;
353
+ }
354
+ const tip = await runGit(deps.shell, `git rev-parse --verify ${shellQuote(`refs/heads/${slot.branch}`)}`);
355
+ const hash = tip.exitCode === 0 && tip.stdout.trim() !== "" ? tip.stdout.trim() : outcome.hash ?? HASH_NOT_READ;
356
+ req.book.add(eventLine(req.clock(), slot.batch, "returned", "VALID"));
357
+ req.book.add(eventLine(req.clock(), slot.batch, "merged", hash));
358
+ await harvest();
359
+ lines.push(`✓ ${slot.batch} VALID, ${merged.line} (${hash})`, ...await markPlanDone(deps.files, req, slot.batch));
360
+ const removed = await removeBatchWorktree(deps.shell, { name: slot.place.name, branch: slot.branch, into: req.workBranch });
361
+ lines.push(removed.ok ? removed.line : `⚠ ${removed.line}`);
362
+ continue;
363
+ }
364
+ stopped = true;
365
+ if (outcome.verdict === "GAPS") {
366
+ // The verdict's own rows, as a relaunch within the wave carries them; else the audit's correction line.
367
+ const correction = ((slot.verdict ? gapsFinding(slot.verdict) : undefined) ?? outcome.correction)?.replace(/\s+/g, " ").trim();
368
+ req.book.add(eventLine(req.clock(), slot.batch, "returned", correction === undefined ? "GAPS" : `GAPS — correction: ${correction}`));
369
+ // The audit's own next step names the batch's correction on the main checkout, which lacks its code: left out.
370
+ const said = outcome.lines.filter((l) => !isNextStepLine(l) && !/^\s*it appends the gap\b/.test(l));
371
+ lines.push(`${slot.batch} returned GAPS`, ...said.slice(-3).map((l) => ` ${l}`));
372
+ if (deps.afterGaps !== undefined) lines.push(...await deps.afterGaps(`${slot.place.root}/${req.work}`));
373
+ lines.push(keptLine(slot.place), resumeLine(req, slot.batch, slot.place, correction));
374
+ } else {
375
+ const detail = blockedDetail(outcome);
376
+ req.book.add(eventLine(req.clock(), slot.batch, "stopped", detail));
377
+ lines.push(`${slot.batch} stopped ${detail}`, keptLine(slot.place), resumeLine(req, slot.batch, slot.place));
378
+ }
379
+ }
380
+ return { lines, stopped };
381
+ }
382
+
383
+ /** What a batch agent's body runs, in its own agent and under its worktree: the crews' use cases, and its spend. */
384
+ export interface BatchChain {
385
+ /** dev-implement's use case: its JSON answer. */
386
+ implement(input: Record<string, unknown>): Promise<string>;
387
+ /** dev-verify's, its audit inline in the batch agent (L8P-D2): its lines. */
388
+ verify(input: Record<string, unknown>): Promise<string>;
389
+ /** The tool calls the batch made and the bound past which its callbacks deny them (L8P-D12). */
390
+ spend: { limit: number; calls(): number; exhausted(): boolean };
391
+ }
392
+
393
+ const WRITTEN = /^written: \S+-VERIFY-(F\d+)\.md\b/m;
394
+ const COMMITTED = /^✓ committed ([0-9a-f]{4,40}) on /m;
395
+
396
+ function parsed(payload: string): { lines: string[]; next?: { crew?: unknown; input?: Record<string, unknown> } } {
397
+ try {
398
+ const value = JSON.parse(payload) as { lines?: unknown; next?: { crew?: unknown; input?: Record<string, unknown> } };
399
+ if (value !== null && Array.isArray(value.lines)) return { lines: value.lines.map(String), ...(value.next ? { next: value.next } : {}) };
400
+ } catch {
401
+ // Not the use case's JSON: its text as lines.
402
+ }
403
+ return { lines: payload.split("\n") };
404
+ }
405
+
406
+ /**
407
+ * The chain one batch runs in code, as the command's `completed` chains it for a sequential run: its steps
408
+ * (dev-implement), its audit (dev-verify), and on VALID its close, committed on the batch's branch, never pushed.
409
+ * A batch that spent its tool calls stops there.
410
+ */
411
+ export async function runBatchChain(run: BatchRun, launch: Readonly<Record<string, unknown>>, chain: BatchChain): Promise<BatchOutcome> {
412
+ const lines: string[] = [];
413
+ const answer = (verdict: BatchOutcome["verdict"], extra: string[] = [], hash?: string): BatchOutcome =>
414
+ ({ batch: run.batch, verdict, ...(hash === undefined ? {} : { hash }), lines: [...lines, ...extra], spent: chain.spend.calls() });
415
+ const spent = (): BatchOutcome | null =>
416
+ chain.spend.exhausted() ? answer("BLOCKED", [budgetStop(chain.spend.limit)]) : null;
417
+
418
+ const implemented = parsed(await chain.implement({
419
+ ...launch, batch: run.batch, ...(run.steps !== undefined ? { steps: run.steps } : {}),
420
+ ...(run.correction !== undefined ? { correction: run.correction } : {}),
421
+ ...(run.stale !== undefined && run.stale.length > 0 ? { stale: run.stale } : {}),
422
+ }));
423
+ lines.push(...implemented.lines);
424
+ const after = spent();
425
+ if (after !== null) return after;
426
+ if (implemented.next?.crew !== "dev-verify" || implemented.next.input === undefined) return answer("BLOCKED");
427
+
428
+ const verified = await chain.verify({ ...implemented.next.input });
429
+ lines.push(...verified.split("\n"));
430
+ const audited = spent();
431
+ if (audited !== null) return audited;
432
+ const written = WRITTEN.exec(verified);
433
+ if (written === null || written[1] !== run.batch) {
434
+ const trimmed = verified.split("\n").map((l) => l.trim()).filter((l) => l !== "");
435
+ const last = trimmed.at(-1) ?? IT_ANSWERED_NOTHING;
436
+ // The gate's RED names only its own line: the checks that failed say why.
437
+ const fails = trimmed.filter((l) => l.startsWith("FAIL ")).map((l) => l.slice(5));
438
+ return answer("BLOCKED", [stoppedNoVerdict(last, fails)]);
439
+ }
440
+ const rest = verified.slice(written.index + written[0].length);
441
+ if (!batchValidLine(run.batch).test(rest)) {
442
+ const correction = parseCorrectionLine(rest)?.finding;
443
+ return { ...answer("GAPS"), ...(correction === undefined ? {} : { correction }) };
444
+ }
445
+
446
+ const closed = parsed(await chain.implement({ ...launch, batch: run.batch, close: true, push: false }));
447
+ lines.push(...closed.lines);
448
+ const hash = COMMITTED.exec(closed.lines.join("\n"))?.[1];
449
+ if (hash !== undefined) return answer("VALID", [], hash);
450
+ const failed = closed.lines.map((l) => l.trim()).find((l) => l.startsWith("✗"));
451
+ return spent() ?? answer("BLOCKED", [closeStop(failed?.replace(/^✗\s*/, ""))]);
452
+ }
@@ -0,0 +1,163 @@
1
+ // The files a batch's worktree needs and does not get from git, and the ones it writes back. The driver of a
2
+ // parallel /dev-batches, only writer of the main checkout, seeds the worktree before the batch agent is built - the
3
+ // work code's folder (plan, sheets, verdicts), its dev state, the config, the session's settings, the packs and the
4
+ // shared memory, none of them tracked in every repository - and, once a VALID batch is merged, harvests the files
5
+ // the batch owns: the names carry its batch (sheet and verdict `*-F<n>.md`, `capture-F<n>/`, the logs `F<n>-*`,
6
+ // `implement-F<n>.json`); the plan never comes back, a batch's done being read from its sheet (L7-D3).
7
+ //
8
+ // Both go through the Files port, file by file: the runtime's shell_command refuses `&&`, `;` and `|`
9
+ // (ShellCommandTool.cs, s_forbiddenOperators) and allows no `cp`. The seed is an explicit copy: a fresh worktree's
10
+ // files equal the main checkout's, whatever the mtime git gave its committed copies; a reused one keeps the files
11
+ // its batch owns (its ticks, its verdict), the rest refreshed. The seed answers a snapshot of the main checkout's
12
+ // copies of those owned files, and the harvest brings back only what the batch changed against it, never over a
13
+ // file the main checkout changed meanwhile (that one is named, the batch's copy staying in the worktree).
14
+ import type { Files } from "../../../shared/application/ports.ts";
15
+ import { isCode } from "../../../shared/domain/dev/artefacts.ts";
16
+ import type { WorktreePlace } from "../../../shared/domain/git/worktree.ts";
17
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
18
+ import { changedSinceSeed, memoryDirOutside, notAWorkCode, notBroughtBack, tooManyToSeed, workFolderOutside } from "./messages.ts";
19
+
20
+ export interface SeedTarget {
21
+ place: WorktreePlace;
22
+ /** The work folder, relative to the checkout ("todo", "backstage/tasks"). */
23
+ work: string;
24
+ code: string;
25
+ /** memory.dir, relative to the checkout. */
26
+ memoryDir: string;
27
+ batch: string;
28
+ }
29
+
30
+ /** The main checkout's copies of the files a batch owns, at its seed: path (relative) → content, absent ones left out. */
31
+ export type SeedSnapshot = ReadonlyMap<string, string>;
32
+
33
+ /** The most files a seed copies: past it, the seed is refused rather than half done. */
34
+ export const SEED_MAX_FILES = 2000;
35
+ const LIST_CAP = 1000;
36
+
37
+ const reasonOf = (e: unknown): string => String((e as Error)?.message ?? e).split("\n")[0];
38
+
39
+ function sources(target: SeedTarget): string[] {
40
+ return [
41
+ `${target.work}/${target.code}`, `.orkeon/dev/${target.code}`, ".orkeon/config.json", ".orkeon/repo.yaml",
42
+ ".claude/settings.local.json", ".claude/harness/packs", target.memoryDir,
43
+ ];
44
+ }
45
+
46
+ /** True for a file of the batch (relative path): its sheet and verdict, its capture, its logs, its implement record. */
47
+ export function ownedBy(target: Pick<SeedTarget, "work" | "code" | "batch">, path: string): boolean {
48
+ const folder = `${target.work}/${target.code}/`;
49
+ if (path === `.orkeon/dev/${target.code}/implement-${target.batch}.json`) return true;
50
+ if (!path.startsWith(folder)) return false;
51
+ const rest = path.slice(folder.length);
52
+ return (!rest.includes("/") && rest.endsWith(`-${target.batch}.md`))
53
+ || rest.startsWith(`capture-${target.batch}/`)
54
+ || (rest.startsWith("logs/") && !rest.slice(5).includes("/") && rest.slice(5).startsWith(`${target.batch}-`));
55
+ }
56
+
57
+ /** Every file under `base/path` (a file, or a folder walked), relative to `base`, with its content; absent: none. */
58
+ async function walk(files: Pick<Files, "read" | "list">, base: string, path: string, out: Map<string, string>): Promise<void> {
59
+ if (out.size > SEED_MAX_FILES) return;
60
+ const full = `${base}/${path}`;
61
+ try {
62
+ out.set(path, await files.read(full));
63
+ return;
64
+ } catch {
65
+ // Not a readable file: a folder, or nothing.
66
+ }
67
+ let names: string[];
68
+ try {
69
+ names = await files.list(full, LIST_CAP);
70
+ } catch {
71
+ return;
72
+ }
73
+ for (const raw of names) {
74
+ const name = raw.replace(/\/+$/, "").split("/").pop() ?? "";
75
+ if (name === "" || name === "." || name === "..") continue;
76
+ await walk(files, base, `${path}/${name}`, out);
77
+ }
78
+ }
79
+
80
+ function unsafe(target: SeedTarget): string | null {
81
+ const relative = (p: string) => p !== "" && !p.startsWith("/") && !p.split("/").includes("..");
82
+ if (!relative(target.work)) return workFolderOutside(target.work);
83
+ if (!relative(target.memoryDir)) return memoryDirOutside(target.memoryDir);
84
+ if (!isCode(target.code)) return notAWorkCode(target.code);
85
+ return null;
86
+ }
87
+
88
+ async function readOrNull(files: Pick<Files, "read">, path: string): Promise<string | null> {
89
+ try {
90
+ return await files.read(path);
91
+ } catch {
92
+ return null;
93
+ }
94
+ }
95
+
96
+ /**
97
+ * Seeds the worktree from the main checkout; `fresh`: just made, every file written over the committed copy git
98
+ * gave it. Answers the snapshot the harvest compares with, or the line saying why it was not seeded.
99
+ */
100
+ export async function seedWorktree(
101
+ files: Pick<Files, "read" | "write" | "list">, target: SeedTarget, fresh: boolean,
102
+ ): Promise<{ ok: true; snapshot: SeedSnapshot } | { ok: false; line: string }> {
103
+ const refused = unsafe(target);
104
+ if (refused !== null) return { ok: false, line: `${target.place.path} not seeded: ${refused}` };
105
+ const found = new Map<string, string>();
106
+ for (const source of sources(target)) await walk(files, WORKSPACE, source, found);
107
+ if (found.size > SEED_MAX_FILES) {
108
+ return { ok: false, line: tooManyToSeed(target.place.path, SEED_MAX_FILES) };
109
+ }
110
+ const snapshot = new Map<string, string>();
111
+ try {
112
+ for (const [path, content] of found) {
113
+ const owned = ownedBy(target, path);
114
+ if (owned) snapshot.set(path, content);
115
+ const to = `${target.place.root}/${path}`;
116
+ // A reused worktree keeps what its batch wrote: its ticks, its verdict, its capture.
117
+ if (!fresh && owned && await readOrNull(files, to) !== null) continue;
118
+ await files.write(to, content);
119
+ }
120
+ } catch (e) {
121
+ return { ok: false, line: `${target.place.path} not seeded: ${reasonOf(e)}` };
122
+ }
123
+ return { ok: true, snapshot };
124
+ }
125
+
126
+ /**
127
+ * Brings back what the batch changed of its own files, against `snapshot` (none: the main checkout as it is). A file
128
+ * the main checkout changed since the seed is left as it is there and named; any other failure is a warning line too,
129
+ * the batch's commit being what counts.
130
+ */
131
+ export async function harvestBatch(
132
+ files: Pick<Files, "read" | "write" | "list">, target: SeedTarget, snapshot?: SeedSnapshot,
133
+ ): Promise<{ ok: true; brought: string[] } | { ok: false; brought: string[]; line: string }> {
134
+ const brought: string[] = [];
135
+ const refused = unsafe(target);
136
+ if (refused !== null) return { ok: false, brought, line: notBroughtBack(target.batch, target.place.path, refused) };
137
+ const found = new Map<string, string>();
138
+ for (const source of [`${target.work}/${target.code}`, `.orkeon/dev/${target.code}`]) await walk(files, target.place.root, source, found);
139
+ const kept: string[] = [];
140
+ try {
141
+ for (const [path, content] of found) {
142
+ if (!ownedBy(target, path)) continue;
143
+ const main = await readOrNull(files, `${WORKSPACE}/${path}`);
144
+ const seeded = snapshot === undefined ? main : snapshot.get(path) ?? null;
145
+ if (content === seeded || content === main) continue;
146
+ if (main !== seeded) {
147
+ kept.push(path);
148
+ continue;
149
+ }
150
+ await files.write(`${WORKSPACE}/${path}`, content);
151
+ brought.push(path);
152
+ }
153
+ } catch (e) {
154
+ return { ok: false, brought, line: notBroughtBack(target.batch, target.place.path, reasonOf(e)) };
155
+ }
156
+ if (kept.length > 0) {
157
+ return {
158
+ ok: false, brought,
159
+ line: changedSinceSeed(target.batch, kept.join(", "), target.place.path),
160
+ };
161
+ }
162
+ return { ok: true, brought };
163
+ }