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,58 @@
1
+ // Pure report rendering — no IO. Extracted from code-review/crew.ork.ts:80-91
2
+ // so the report shape can be snapshot-tested without a live LLM run.
3
+
4
+ import type { Finding } from "../../../shared/domain/types.ts";
5
+ import { diffCutLine, findingsLine, NO_ISSUES, NO_ISSUES_IN_PART_REVIEWED, REPORT_TITLE } from "./messages.ts";
6
+
7
+ /** How much of the diff the lenses read: `shown` characters, `leftOut` not reviewed. */
8
+ export interface ReportCut {
9
+ shown: number;
10
+ leftOut: number;
11
+ }
12
+
13
+ /**
14
+ * Render the ranked findings as the code-review-report.md body.
15
+ *
16
+ * `scope` is a human-readable description of what was reviewed — since B-3 that
17
+ * may be a range ("staged changes") or a range restricted to named paths, so the
18
+ * header no longer says "Range" about something that is not one.
19
+ *
20
+ * `cut`, when the diff was cut, puts the amount not reviewed in the header, and an
21
+ * empty review then says it covers the part reviewed only: "No issues found" on a cut
22
+ * diff is not a clean review. `findingsLeftOut` is how many less severe findings the
23
+ * report cap dropped.
24
+ */
25
+ export function renderReport(
26
+ scope: string,
27
+ fileCount: number,
28
+ findings: Finding[],
29
+ plan?: string,
30
+ cut?: ReportCut,
31
+ findingsLeftOut = 0,
32
+ ): string {
33
+ const lines: string[] = [
34
+ REPORT_TITLE,
35
+ ``,
36
+ `- Scope: \`${scope}\``,
37
+ `- Files: ${fileCount}`,
38
+ // B-9: the plan line makes /passes and review.lenses observable in the
39
+ // artefact. Without it, a 3-pass review and a 1-pass review are told apart
40
+ // only by the bill.
41
+ ...(plan ? [`- Review: ${plan}`] : []),
42
+ ...(cut ? [diffCutLine(cut.shown, cut.leftOut)] : []),
43
+ findingsLine(findings.length, findingsLeftOut),
44
+ ``,
45
+ ];
46
+ if (findings.length === 0) {
47
+ lines.push(cut ? NO_ISSUES_IN_PART_REVIEWED : NO_ISSUES);
48
+ } else {
49
+ for (const f of findings) {
50
+ const plausible = f.confidence === "plausible" ? " (plausible)" : "";
51
+ lines.push(`### [${String(f.severity ?? "?").toUpperCase()}]${plausible} ${f.file}:${f.line ?? "?"} — ${f.category ?? f.lens}`);
52
+ lines.push(f.finding ?? "");
53
+ if (f.suggestion) lines.push(``, `**Suggestion:** ${f.suggestion}`);
54
+ lines.push(``);
55
+ }
56
+ }
57
+ return lines.join("\n");
58
+ }
@@ -0,0 +1,106 @@
1
+ // Pure review scope — what `/review` looks at, decided without IO.
2
+ //
3
+ // B-3: the crew's declared input contract is `{ files?: string[], commit?: string }`
4
+ // (crew.ork.ts header) and baseline 03 §CodeReview Crew explicitly covers
5
+ // reviewing NAMED FILES. But `resolveCommitRange` only ever read `inputs.commit`,
6
+ // so a `files` argument was silently ignored and every review fell back to
7
+ // `--staged`. A caller asking to review two files got a review of whatever
8
+ // happened to be staged, with nothing saying the request had been dropped.
9
+ //
10
+ // The second half of this module is not in B-3's acceptance and is here because
11
+ // B-3 could not be written safely without it: `git diff ${range}` interpolates
12
+ // caller input into a shell string (`shared/infrastructure/shell.ts` passes the
13
+ // command through verbatim), so `commit` was already an injection point and
14
+ // `files` would have been a second one. Both are validated, and a rejected value
15
+ // is REPORTED rather than dropped — a silently ignored path is the very defect
16
+ // this item exists to fix.
17
+
18
+ import { ABSOLUTE_PATH, ESCAPING_SEGMENT, IMPLAUSIBLE_REF, UNSAFE_PATH_CHARACTER } from "./messages.ts";
19
+
20
+ /** Characters a git ref may contain here. Deliberately narrower than git's own rule. */
21
+ const SAFE_REF = /^[A-Za-z0-9._/~^-]+$/;
22
+
23
+ /** Characters a repo-relative path may contain. No whitespace, no shell metacharacters. */
24
+ const SAFE_PATH = /^[A-Za-z0-9._/-]+$/;
25
+
26
+ /** What the scope is resolved from: the crew's `commit` and `files` inputs, as the caller gave them. */
27
+ export interface ReviewInputs {
28
+ commit?: unknown;
29
+ files?: unknown;
30
+ }
31
+
32
+ export interface ReviewScope {
33
+ /** The git diff range: `--staged`, or `<commit>~1..<commit>`. */
34
+ range: string;
35
+ /** Validated repo-relative paths restricting the diff; empty = whole range. */
36
+ paths: string[];
37
+ /** The full argument string for `git diff …` — range, then `-- <paths>`. */
38
+ diffArgs: string;
39
+ /** Human-readable scope, for the report header and the log. */
40
+ describe: string;
41
+ /** Inputs refused, with the reason. Never silent. */
42
+ rejected: Array<{ value: string; reason: string }>;
43
+ }
44
+
45
+ /** `<commit>~1..<commit>` for a named commit, else `--staged`. Unchanged since B-3. */
46
+ export function resolveCommitRange(inputs?: ReviewInputs | null): string {
47
+ return inputs?.commit ? `${inputs.commit}~1..${inputs.commit}` : "--staged";
48
+ }
49
+
50
+ function validatePaths(raw: unknown): { paths: string[]; rejected: Array<{ value: string; reason: string }> } {
51
+ const paths: string[] = [];
52
+ const rejected: Array<{ value: string; reason: string }> = [];
53
+ const list = Array.isArray(raw) ? raw : raw == null ? [] : [raw];
54
+ for (const item of list) {
55
+ const p = String(item ?? "").trim();
56
+ if (p.length === 0) continue;
57
+ if (p.startsWith("/")) {
58
+ rejected.push({ value: p, reason: ABSOLUTE_PATH });
59
+ continue;
60
+ }
61
+ if (p.split("/").includes("..")) {
62
+ rejected.push({ value: p, reason: ESCAPING_SEGMENT });
63
+ continue;
64
+ }
65
+ if (!SAFE_PATH.test(p)) {
66
+ rejected.push({ value: p, reason: UNSAFE_PATH_CHARACTER });
67
+ continue;
68
+ }
69
+ if (!paths.includes(p)) paths.push(p);
70
+ }
71
+ return { paths, rejected };
72
+ }
73
+
74
+ /**
75
+ * Resolves what to review.
76
+ *
77
+ * With no `files`, the result is byte-identical to the pre-B-3 behaviour: the
78
+ * range alone, so `git diff --staged` and `git diff --staged --name-only` are the
79
+ * exact commands that used to run.
80
+ */
81
+ export function resolveReviewScope(inputs?: ReviewInputs | null): ReviewScope {
82
+ const rejected: Array<{ value: string; reason: string }> = [];
83
+
84
+ let range = "--staged";
85
+ const commit = String(inputs?.commit ?? "").trim();
86
+ if (commit.length > 0) {
87
+ if (SAFE_REF.test(commit)) {
88
+ range = `${commit}~1..${commit}`;
89
+ } else {
90
+ rejected.push({ value: commit, reason: IMPLAUSIBLE_REF });
91
+ }
92
+ }
93
+
94
+ const { paths, rejected: pathRejects } = validatePaths(inputs?.files);
95
+ rejected.push(...pathRejects);
96
+
97
+ // `--` separates revisions from pathspecs; without it git would try to resolve
98
+ // a path that happens to look like a ref.
99
+ const diffArgs = paths.length > 0 ? `${range} -- ${paths.join(" ")}` : range;
100
+ const where = range === "--staged" ? "staged changes" : `commit ${range}`;
101
+ const describe = paths.length > 0
102
+ ? `${where}, restricted to ${paths.length} path(s): ${paths.join(", ")}`
103
+ : where;
104
+
105
+ return { range, paths, diffArgs, describe, rejected };
106
+ }
@@ -0,0 +1,127 @@
1
+ // The lines /dev-batches shows: its status and report lines, its BLOCKED reasons, the stops it logs and the lines of
2
+ // the plan's close (ADR 0026).
3
+
4
+ import { CLOSE_STOP } from "../../dev-implement/domain/markers.ts";
5
+
6
+ // ── Shared by the run and its waves ─────────────────────────────────────────
7
+
8
+ export const HASH_NOT_READ = "(hash not read)";
9
+ export const LOG_UNWRITABLE = "BLOCKED — the log must be writable before a launch";
10
+ /** The stop of a batch whose close committed nothing; `failed` is the close's own ✗ line, its mark cut. */
11
+ export const closeStop = (failed: string | undefined): string => `${CLOSE_STOP} ${failed ?? "the batch was not committed"}`;
12
+
13
+ // ── The run (run-dev-batches.ts) ────────────────────────────────────────────
14
+
15
+ export const logNotWritten = (path: string, reason: string): string => `⚠ the log ${path} could not be written: ${reason}`;
16
+ export const CHAIN_ANSWERED_NOTHING = "the chain answered nothing";
17
+ export const noBranchFromPattern = (wanted: string): string =>
18
+ `no branch name can be made from contrib.branch '${wanted}' (<prefix>/<slug>): create the work branch`;
19
+ export const backOnBranch = (name: string): string => `✓ back on ${name}, the run's branch`;
20
+ export const FILES_NOT_READ = "(files not read)";
21
+ export const notAWorkCodeBlocked = (code: string): string => `BLOCKED — '${code}' is not a work code (a folder name of the work folder)`;
22
+ export const runInProgress = (active: string, record: string, code: string): string =>
23
+ `BLOCKED — the run of ${active} is in progress (${record}): ` +
24
+ `take it to its close (/dev-batches ${active}), or delete that file to drop it, then /dev-batches ${code}`;
25
+ export const NO_RUN_TO_GO_ON = "no /dev-batches run to go on with: /dev-batches <code>";
26
+ export const blockedReadOnlyMode = (mode: string, code: string): string =>
27
+ `BLOCKED — the session mode ${mode} is read-only: the batches write files and commit (/mode default, then /dev-batches ${code})`;
28
+ export const concurrencyRefused = (parallel: number): string =>
29
+ `BLOCKED — concurrency ${parallel} refused: no batch agents on this host; run with --concurrency 1`;
30
+ export const workOutsideMounts = (folder: string): string => `BLOCKED — the work folder ${folder} is outside the mounts`;
31
+ export const noPlanUnder = (folder: string, code: string, known: string): string => `BLOCKED — no plan under ${folder}/${code}/${known}: /dev-plan first`;
32
+ export const recordNotWritten = (reason: string, code: string): string =>
33
+ `⚠ the run record could not be written (${reason}): after a refused hop, type /dev-batches ${code}`;
34
+ export const runGoesOn = (code: string, parallel: number): string => `→ the run of ${code} goes on, ${parallel} batches at once`;
35
+ export const logUnwritableThen = (code: string): string => `${LOG_UNWRITABLE}, then /dev-batches ${code}`;
36
+ export const doneAndCommitted = (id: string): string => `✓ ${id} done and committed`;
37
+ export const notMarkedDone = (id: string): string => `⚠ ${id} is not marked done in its sheet or the plan: mark it by hand`;
38
+ export const validNotCommitted = (id: string): string =>
39
+ `${id}: an audit since its launch says VALID, and no commit yet: its chain may still be closing it (nothing logged)`;
40
+ export const waitForChain = (close: string, code: string): string =>
41
+ `→ wait for the chain's answer; else the close (${close}), then /dev-batches ${code} goes on`;
42
+ export const relaunchedRound = (id: string, round: number, max: number): string => `→ ${id} relaunched, audit round ${round} of ${max}: `;
43
+ export const resumeAudit = (code: string, id: string): string => `/dev-batches ${code} ${id} (no correction: its audit resumes)`;
44
+ export const humanDecidesCorrection = (rounds: number | null, command: string, code: string): string =>
45
+ `→ a human decides: ${rounds !== null ? `${rounds} audit rounds in GAPS; ` : ""}the correction the audit names (${command}), then /dev-batches ${code} goes on`;
46
+ export const humanDecidesClose = (close: string, code: string): string =>
47
+ `→ a human decides: the close (${close}), then /dev-batches ${code} goes on`;
48
+ export const humanDecidesAgain = (code: string, id: string): string =>
49
+ `→ a human decides; then /dev-batches ${code} goes on (${id} again, from its sheet's ticks)`;
50
+ export const everyBatchDone = (code: string, log: string): string => `${code}: every batch is done and the run is closed (${log})`;
51
+ export const everyBatchDoneArrow = (code: string, log: string): string => `→ ${code}: every batch done, the run closed (${log})`;
52
+ export const preflightBlocked = (code: string): string => `BLOCKED — preflight: settle each ✗ above, then /dev-batches ${code}`;
53
+ export const wavesUnreadable = (code: string): string => `BLOCKED — the plan's waves could not be read, then /dev-batches ${code}`;
54
+ export const batchReviewNotRun = (id: string, reason: string, code: string): string =>
55
+ `→ ${id} not launched: the review could not run (${reason}); /dev-batches ${code} reviews it again`;
56
+ export const NO_REVIEWER = "no reviewer on this host";
57
+ export const reviewGaps = (id: string, blocking: number, major: number): string => `review of ${id}: GAPS — ${blocking} Blocking, ${major} Major`;
58
+ export const settleBlocking = (id: string, sheet: string, code: string): string =>
59
+ `→ ${id} not launched: settle the Blocking questions in ${sheet} (or /dev-plan), then /dev-batches ${code} launches it without a second review`;
60
+ export const detachedHead = (code: string): string =>
61
+ `BLOCKED — branch: the checkout stands on no branch (a detached HEAD): check the work branch out, then /dev-batches ${code}`;
62
+ export const humanDecidesStops = (code: string, parallel: number): string =>
63
+ `→ a human decides: each stop above, its worktree kept; then /dev-batches ${code} --concurrency ${parallel} goes on`;
64
+ export const nextWaveFollows = (code: string, parallel: number): string => `→ the next wave follows: /dev-batches ${code} --concurrency ${parallel}`;
65
+ export const keptByParallelRun = (next: string, path: string, code: string): string =>
66
+ `BLOCKED — ${next} stays in ${path}, kept by a parallel run: /dev-batches ${code} --concurrency 2 relaunches it there; ` +
67
+ `or remove it (git worktree remove --force ${path}, then git branch -D batches/${code}/${next}) to run it here`;
68
+ export const launchLine = (next: string, event: string, position: number, total: number, code: string): string =>
69
+ `→ ${next} ${event} (${position}/${total}): /dev-batches ${code} ${next}, then its audit and its commit`;
70
+
71
+ // ── A wave (run-wave.ts) ────────────────────────────────────────────────────
72
+
73
+ export const batchAgentAnswered = (first: string): string => `BLOCKED — the batch agent answered: ${first}`;
74
+ export const worktreeKept = (path: string): string =>
75
+ ` worktree ${path} kept: a test suite run on the checkout may find its files until it is removed (git worktree remove ${path})`;
76
+ export const stayInWorktree = (batch: string, path: string, code: string, concurrency: number, correction: string | undefined): string =>
77
+ `→ ${batch}'s code, sheet and verdict stay in ${path}: /dev-batches ${code} --concurrency ${concurrency} relaunches it there` +
78
+ (correction === undefined ? "" : `, its correction first (${correction})`);
79
+ export const notAWorktreeName = (name: string): string => `'${name}' is not a worktree name`;
80
+ export const branchNotOnWorktree = (branch: string, path: string, why: string): string =>
81
+ `branch ${branch} exists but ${path} is not on it (${why}): remove the branch or check it out there`;
82
+ export const planNotMarked = (name: string, batch: string, reason: string): string => `⚠ ${name}: batch ${batch} not marked done (${reason})`;
83
+ export const BATCH_ANSWERED_NOTHING = "the batch answered nothing";
84
+ export const stateNotIgnored = (state: string): string =>
85
+ `BLOCKED — worktree: ${state} is not ignored by git: a parallel run needs .orkeon/ ignored (.gitignore or .git/info/exclude); or run with --concurrency 1`;
86
+ export const doneBeforeStop = (batch: string, path: string): string => `${batch}: done and committed in ${path} before the run stopped`;
87
+ export const gapsRoundsHuman = (batch: string, rounds: number): string => `${batch}: ${rounds} audit rounds in GAPS, a human decides`;
88
+ export const relaunchedAfterGaps = (batch: string, path: string, round: number, max: number): string =>
89
+ `${batch} returned GAPS: relaunched in ${path}, audit round ${round} of ${max}`;
90
+ export const NO_CORRECTION_RESUMES = " (no correction: its audit resumes)";
91
+ export const logUnwritableNotRelaunched = (batch: string): string => `${LOG_UNWRITABLE}: ${batch} not relaunched`;
92
+ export const budgetStop = (limit: number): string => `stopped BLOCKED — budget: ${limit} tool calls`;
93
+ export const IT_ANSWERED_NOTHING = "it answered nothing";
94
+ export const stoppedNoVerdict = (last: string, fails: readonly string[]): string =>
95
+ `stopped BLOCKED — dev-verify wrote no verdict: ${last}${fails.length === 0 ? "" : ` (${fails.join("; ")})`}`;
96
+
97
+ // ── The seed and the harvest (seed-harvest.ts) ──────────────────────────────
98
+
99
+ export const workFolderOutside = (work: string): string => `the work folder '${work}' is not a folder of the checkout`;
100
+ export const memoryDirOutside = (dir: string): string => `memory.dir '${dir}' is not a folder of the checkout`;
101
+ export const notAWorkCode = (code: string): string => `'${code}' is not a work code`;
102
+ export const tooManyToSeed = (path: string, max: number): string =>
103
+ `${path} not seeded: more than ${max} files to copy (the work folder, .orkeon/dev, the packs, memory.dir)`;
104
+ export const notBroughtBack = (batch: string, path: string, why: string): string => `⚠ ${batch}'s files not brought back from ${path}: ${why}`;
105
+ export const changedSinceSeed = (batch: string, kept: string, path: string): string =>
106
+ `⚠ ${batch}: ${kept} changed in the checkout since the seed: kept as they are, the batch's copies left in ${path}`;
107
+
108
+ // ── The plan's close (plan-close.ts) ────────────────────────────────────────
109
+
110
+ export const BEFORE_THIS_RUN = "before this run";
111
+ export const planBatches = (prefix: string, feature: string, ids: string, plan: string, commits: string): string =>
112
+ `${prefix} — ${feature}: batches ${ids}, ` +
113
+ `from \`${plan}\`, one commit each (${commits}).`;
114
+ export const closeNoBranch = (code: string): string =>
115
+ `✗ close: no current branch (a detached HEAD?): check out the work branch, then /dev-batches ${code}`;
116
+ export const closeOnDefault = (branch: string, wanted: string, work: string, code: string): string =>
117
+ `✗ close: ${branch} is the default branch and the pack asks for a work branch (${wanted}): ` +
118
+ `git switch ${work}, then /dev-batches ${code}`;
119
+ export const committedOnDefaultWanted = (wanted: string, branch: string): string =>
120
+ `⚠ the pack asks for a work branch (${wanted}), but the batches are committed on ${branch}`;
121
+ export const committedOnDefault = (branch: string, push: string): string =>
122
+ `✓ every batch is committed on ${branch}, the default branch: no pull request; pushing it is yours (${push})`;
123
+ export const onOriginAlready = (branch: string): string => `✓ ${branch} is on origin already`;
124
+ export const pushDenied = (command: string): string => `✗ not pushed: a session rule denies '${command}'; the commits stay local`;
125
+ export const runStaysOpen = (code: string, push: string): string =>
126
+ `the run stays open: /dev-batches ${code} tries the push again; a confined shell reaches no ` +
127
+ `remote, so push from a terminal (${push}), then /dev-batches ${code} closes the run`;
@@ -0,0 +1,181 @@
1
+ // The close of a /dev-batches run, once every batch of the plan is done: one push of the work branch
2
+ // and one pull request for the whole plan (source-space D79: the batches commit, the run pushes once).
3
+ // The pull request's body lists the files of each batch's commit (`merged <hash>` in the log), grouped by
4
+ // the pack's layout roots, each audit's validations and each sheet's assumptions, and is written to
5
+ // `<work>/pr-<slug>/PR.md`; it is opened through the github tool under --pr or dev.prAuto, else its command
6
+ // is handed over. On the default branch nothing is pushed for review, and the close is refused when the pack
7
+ // asks for a work branch (the run's commits are on it). A push that fails leaves the run open: the next
8
+ // /dev-batches tries the close again, and takes a branch already on origin (pushed by hand) as pushed.
9
+ import type { Files, Shell } from "../../../shared/application/ports.ts";
10
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
11
+ import type { PullRequestOpener } from "../../../shared/application/git/commit-files.ts";
12
+ import { defaultBranch, handOverPullRequest, pushBranch, runGit } from "../../../shared/application/git/commit-files.ts";
13
+ import type { WorkFolder } from "../../../shared/application/dev/resolve-work-folder.ts";
14
+ import type { DevCode } from "../../../shared/application/dev/load-dev-context.ts";
15
+ import { lastVerdict } from "../../../shared/domain/dev/verdict-format.ts";
16
+ import type { RepoPack } from "../../../shared/domain/dev/repo-pack.ts";
17
+ import type { PermissionRule } from "../../../shared/domain/agent-policy/permission.ts";
18
+ import { ruleDecision } from "../../../shared/domain/agent-policy/permission.ts";
19
+ import {
20
+ DEV_PR_AUTO_CONFIG_KEY, GIT_CURRENT_BRANCH_COMMAND, gitPushCommand, gitPushedCheckCommand, isPushed, shellQuote,
21
+ workBranchFromPattern,
22
+ } from "../../../shared/domain/git/close.ts";
23
+ import type { PrSummary } from "../../../shared/domain/git/close.ts";
24
+ import { gitBranchExists } from "../../../shared/domain/git/worktree.ts";
25
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
26
+ import { BEFORE_THIS_RUN, closeNoBranch, closeOnDefault, committedOnDefault, committedOnDefaultWanted, onOriginAlready, planBatches, pushDenied, runStaysOpen } from "./messages.ts";
27
+ import { pushedToOrigin } from "../../../shared/application/git/messages.ts";
28
+
29
+ export interface MergedBatch { batch: string; hash: string }
30
+
31
+ export interface PlanCloseInput {
32
+ code: string;
33
+ dev: DevCode;
34
+ pack: RepoPack | null;
35
+ work: WorkFolder;
36
+ /** The batches' commits, in the log's order. */
37
+ merged: readonly MergedBatch[];
38
+ /** --pr: open the pull request rather than hand it over. */
39
+ pr: boolean;
40
+ /** The session's rules read at the launch: a deny on the push keeps the commits local. */
41
+ rules: readonly PermissionRule[];
42
+ }
43
+
44
+ export interface PlanClose { closed: boolean; lines: string[] }
45
+
46
+ const LAYERS = ["domain", "application", "infrastructure", "tests"] as const;
47
+ const MAX_FILES_PER_COMMIT = 200;
48
+
49
+ const under = (path: string, root: string): boolean => {
50
+ const r = root.replace(/\/+$/, "");
51
+ return path === r || path.startsWith(`${r}/`);
52
+ };
53
+
54
+ /** The paths grouped by the pack's layout roots, the others last. */
55
+ export function filesPerLayer(pack: RepoPack | null, paths: readonly string[]): PrSummary["layers"] {
56
+ const left = new Set(paths);
57
+ const out: PrSummary["layers"] = [];
58
+ for (const layer of LAYERS) {
59
+ const root = pack?.layout[layer];
60
+ if (!root) continue;
61
+ const mine = [...left].filter((p) => under(p, root)).sort();
62
+ mine.forEach((p) => left.delete(p));
63
+ out.push({ layer, paths: mine });
64
+ }
65
+ out.push({ layer: "other", paths: [...left].sort() });
66
+ return out;
67
+ }
68
+
69
+ /** The files of the batches' commits; a commit git cannot show adds none. */
70
+ async function filesOf(shell: Pick<Shell, "run">, merged: readonly MergedBatch[]): Promise<string[]> {
71
+ const out = new Set<string>();
72
+ for (const m of merged) {
73
+ if (!/^[0-9a-f]{4,40}$/i.test(m.hash)) continue;
74
+ const r = await runGit(shell, `git show --name-only --format= ${shellQuote(m.hash)}`);
75
+ if (r.exitCode !== 0) continue;
76
+ for (const p of r.stdout.split("\n").map((l) => l.trim()).filter((l) => l !== "").slice(0, MAX_FILES_PER_COMMIT)) out.add(p);
77
+ }
78
+ return [...out];
79
+ }
80
+
81
+ async function prAuto(config: Pick<ConfigStore, "readValue">): Promise<boolean> {
82
+ try {
83
+ return (await config.readValue(DEV_PR_AUTO_CONFIG_KEY)).value?.trim() === "true";
84
+ } catch {
85
+ return false;
86
+ }
87
+ }
88
+
89
+ /** The pull request's summary for the whole plan. */
90
+ export function planSummary(input: PlanCloseInput, files: readonly string[]): PrSummary {
91
+ const { dev } = input;
92
+ const plan = dev.plan;
93
+ const feature = plan?.plan.feature ?? input.code;
94
+ const ids = input.merged.map((m) => m.batch);
95
+ const validations: string[] = [];
96
+ const audits: string[] = [];
97
+ const notRun: string[] = [];
98
+ const assumptions: NonNullable<PrSummary["assumptions"]> = [];
99
+ for (const batch of ids) {
100
+ const sheet = dev.sheets.find((s) => s.batch === batch)?.sheet;
101
+ assumptions.push(...(sheet?.assumptions ?? []).map((a) => ({ ...a, id: `${batch} ${a.id}` })));
102
+ const verdicts = dev.verdicts.filter((v) => v.batch === batch);
103
+ const verdict = verdicts.length === 0 ? null : lastVerdict(verdicts[verdicts.length - 1].file);
104
+ if (verdict === null) continue;
105
+ validations.push(...verdict.validations.map((v) => `${batch}: ${v}`));
106
+ audits.push(`${batch} ${verdict.verdict ?? "?"}${verdict.when ? ` (${verdict.when})` : ""}, \`${dev.shown}/${verdicts[verdicts.length - 1].name}\``);
107
+ notRun.push(...verdict.notRun.map((v) => `${batch}: ${v}`));
108
+ }
109
+ return {
110
+ batch: planBatches(plan?.plan.prefix ?? input.code.toUpperCase(), feature, ids.join(", ") || "none", `${dev.shown}/${plan?.name ?? "?"}`,
111
+ input.merged.map((m) => `${m.batch} ${m.hash || BEFORE_THIS_RUN}`).join(", ")),
112
+ layers: filesPerLayer(input.pack, files),
113
+ validations,
114
+ assumptions,
115
+ audit: audits.join("; "),
116
+ notRun: notRun.join("; "),
117
+ };
118
+ }
119
+
120
+ export async function closePlan(
121
+ deps: { files: Pick<Files, "write">; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">; opener?: PullRequestOpener },
122
+ input: PlanCloseInput,
123
+ ): Promise<PlanClose> {
124
+ const current = await runGit(deps.shell, GIT_CURRENT_BRANCH_COMMAND);
125
+ const branch = current.exitCode === 0 ? current.stdout.trim() : "";
126
+ if (branch === "") {
127
+ return { closed: false, lines: [closeNoBranch(input.code)] };
128
+ }
129
+ const base = await defaultBranch(deps.shell);
130
+ if (base !== null && base === branch) {
131
+ // The pack asks for a work branch: the run made `<prefix>/<code>` (L7-D7), so HEAD went back to the default one.
132
+ // When that branch does not exist, the commits really are on the default one: the close goes on, said.
133
+ const wanted = input.pack?.contrib.branch?.trim();
134
+ const work = wanted ? workBranchFromPattern(wanted, input.code) : null;
135
+ if (wanted && work !== null && (await runGit(deps.shell, gitBranchExists(work))).exitCode === 0) {
136
+ return {
137
+ closed: false,
138
+ lines: [closeOnDefault(branch, wanted, work, input.code)],
139
+ };
140
+ }
141
+ return {
142
+ closed: true,
143
+ lines: [
144
+ ...(wanted ? [committedOnDefaultWanted(wanted, branch)] : []),
145
+ committedOnDefault(branch, gitPushCommand(branch)),
146
+ ],
147
+ };
148
+ }
149
+ const lines: string[] = [];
150
+ const pushCommand = gitPushCommand(branch);
151
+ let pushed = false;
152
+ let closed = true;
153
+ // A confined shell reaches no remote (no network, HOME=/tmp): the user pushes from a terminal, and the
154
+ // remote-tracking ref their push moved, local, tells the next run the branch is on origin.
155
+ const check = await runGit(deps.shell, gitPushedCheckCommand(branch));
156
+ if (check.exitCode === 0 && isPushed(check.stdout)) {
157
+ pushed = true;
158
+ lines.push(onOriginAlready(branch));
159
+ } else if (ruleDecision(input.rules, "shell_command", { command: pushCommand, working_directory: WORKSPACE }) === "deny") {
160
+ lines.push(pushDenied(pushCommand));
161
+ } else {
162
+ const push = await pushBranch(deps.shell, branch);
163
+ pushed = push.ok;
164
+ closed = push.ok;
165
+ lines.push(push.ok ? pushedToOrigin(branch) : `✗ ${push.line}`);
166
+ }
167
+ const files = await filesOf(deps.shell, input.merged);
168
+ const summary = planSummary(input, files);
169
+ const feature = input.dev.plan?.plan.feature ?? input.code;
170
+ lines.push(...await handOverPullRequest(
171
+ { files: deps.files, opener: deps.opener },
172
+ {
173
+ work: { folder: input.work.folder, vfsPath: input.work.vfsPath }, branch, base, title: `feat(${input.code}): ${feature}`,
174
+ pushed, open: input.pr || (await prAuto(deps.config)), summary,
175
+ },
176
+ ));
177
+ if (!closed) {
178
+ lines.push(runStaysOpen(input.code, pushCommand));
179
+ }
180
+ return { closed, lines };
181
+ }
@@ -0,0 +1,10 @@
1
+ // The prompts of /dev-batches' application: the goals of its agents and the title of the review material that
2
+ // shows the reviewer what a merged batch changed (ADR 0026).
3
+
4
+ export const DEV_BATCHES_GOAL = "Run a plan's batches in the order their dependencies allow, and close the plan with one pull request";
5
+ export const batchAgentGoal = (batch: string, code: string): string =>
6
+ `Run batch ${batch} of ${code} test-first under its worktree, audit it and commit it there`;
7
+ export const GIT_TOP_PROBE_GOAL = "Say git's top under the worktree";
8
+
9
+ /** The title of a merged batch's diff in the review material; `short` is its hash cut to 7 characters. */
10
+ export const changedTitle = (batch: string, short: string): string => `what ${batch} changed (git show ${short})`;