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

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 (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,193 @@
1
+ // Pure argument parsing for slash commands — no IO, unit-tested with node --test
2
+ // (tests live in ../../tests/, outside the "*.cmd.ts" scan). Extracted from
3
+ // memory.cmd.ts:12-37 and assistant.cmd.ts:9-13.
4
+
5
+ import { MEMORY_CATEGORIES } from "../../shared/domain/agent-policy/memory-categories.ts";
6
+ import { SNIP_COMMAND_TURNS } from "../../shared/domain/compaction-thresholds.ts";
7
+
8
+ export type ParsedMemory =
9
+ | { sub: "add"; category: string; content: string }
10
+ | { sub: "delete"; id: number }
11
+ | { sub: "get"; id: number }
12
+ | { sub: "list"; category?: string };
13
+
14
+ function isCategory(token: string | undefined): boolean {
15
+ return MEMORY_CATEGORIES.includes(String(token ?? "").toLowerCase() as any);
16
+ }
17
+
18
+ /** Parse `/memory <list|add|delete|get> …` tokens into a typed command. */
19
+ export function parseMemoryArgs(tokens: string[]): ParsedMemory {
20
+ const sub = (tokens[0] ?? "list").toLowerCase();
21
+ if (sub === "add") {
22
+ const hasCat = isCategory(tokens[1]);
23
+ const category = hasCat ? tokens[1].toLowerCase() : "user";
24
+ const content = tokens.slice(hasCat ? 2 : 1).join(" ");
25
+ return { sub: "add", category, content };
26
+ }
27
+ if (sub === "delete") return { sub: "delete", id: Number(tokens[1]) };
28
+ if (sub === "get") return { sub: "get", id: Number(tokens[1]) };
29
+ // list (default)
30
+ return { sub: "list", category: isCategory(tokens[1]) ? tokens[1].toLowerCase() : undefined };
31
+ }
32
+
33
+ /** Permission modes accepted as a leading `mode: …` prefix on /assistant. */
34
+ export { PERMISSION_MODES, isPermissionMode } from "../../shared/domain/permission-modes.ts";
35
+ import { PERMISSION_MODES as MODES } from "../../shared/domain/permission-modes.ts";
36
+
37
+ // Derived from the canonical list so a new mode (e.g. dontAsk, E-3) is
38
+ // automatically accepted as a prefix — no second hardcoded mode list.
39
+ const MODE_PREFIX_RE = new RegExp(`^(${MODES.join("|")})\\s*:\\s*(.*)$`, "s");
40
+
41
+ /** Parse `/assistant [mode:] <request>` into { prompt, permissionMode }.
42
+ * permissionMode is null when NO prefix was given — the crew then falls back
43
+ * to the session default set by /mode (an explicit `default:` prefix still
44
+ * pins the mode and bypasses the session default). */
45
+ export function parseAssistantInput(raw: string): { prompt: string; permissionMode: string | null } {
46
+ const trimmed = raw.trim();
47
+ const m = trimmed.match(MODE_PREFIX_RE);
48
+ if (m) return { permissionMode: m[1], prompt: m[2] };
49
+ return { permissionMode: null, prompt: trimmed };
50
+ }
51
+
52
+ /** Join a command's raw tokens back into a single trimmed string. */
53
+ export function rawText(args: any): string {
54
+ return ((args?.raw ?? []) as string[]).join(" ").trim();
55
+ }
56
+
57
+ /** `/compact [--snip [N] | <focus>]`: the snip-only path with how many turns to
58
+ * keep whole (SNIP_COMMAND_TURNS by default, as the runtime), or the focus of the summary. */
59
+ export function parseCompactArgs(tokens: readonly string[]): { snip: number } | { focus: string } {
60
+ if (tokens[0] === "--snip") {
61
+ const n = Number(tokens[1]);
62
+ return { snip: Number.isInteger(n) && n > 0 ? n : SNIP_COMMAND_TURNS };
63
+ }
64
+ return { focus: tokens.join(" ").trim() };
65
+ }
66
+
67
+ /** The name the person typed the command by, read off the line the host hands over (`ctx.command.rawInput`):
68
+ * `/dev-verify F2 cache` → `dev-verify`, an alias as typed. `fallback` when the line names none. */
69
+ export function typedCommand(rawInput: unknown, fallback: string): string {
70
+ return /^\s*\/?([a-z][a-z0-9-]*)(?:\s|$)/.exec(String(rawInput ?? ""))?.[1] ?? fallback;
71
+ }
72
+
73
+ /** A command's raw tokens as a string array. */
74
+ export function rawTokens(args: any): string[] {
75
+ return (args?.raw ?? []) as string[];
76
+ }
77
+
78
+ /**
79
+ * The raw tokens the REPL hands a command, as one line. The REPL splits the line on
80
+ * spaces and keeps the quotes; a token that holds another blank (a tab) is quoted
81
+ * again, so `splitWords` keeps it whole.
82
+ */
83
+ export function commandLine(tokens: readonly string[]): string {
84
+ return tokens.map((t) => (/\s/.test(t) && !t.includes('"') ? `"${t}"` : t)).join(" ");
85
+ }
86
+
87
+ /** A word of a command line: its text, whether it was quoted, and the offset where it ends in the line. */
88
+ export interface Word {
89
+ text: string;
90
+ quoted: boolean;
91
+ end: number;
92
+ }
93
+
94
+ /** Where the quote at `open` closes: the same quote followed by a blank or the end of the line; `line.length` when none does. */
95
+ function closingQuote(line: string, open: number): number {
96
+ const quote = line[open];
97
+ let close = open + 1;
98
+ while (close < line.length && !(line[close] === quote && (close + 1 === line.length || /\s/.test(line[close + 1])))) close++;
99
+ return close;
100
+ }
101
+
102
+ /**
103
+ * Split a line on blanks. A quote that opens a word ("..." or '...') runs to the same
104
+ * quote followed by a blank or the end of the line, and is dropped; so does a quote
105
+ * that opens right after the `=` of an option word (`--note="two words"` is the one
106
+ * word `--note=two words`). A quote with no such close, or elsewhere inside a word
107
+ * (qu'il, l'API), is a letter (the '90s).
108
+ */
109
+ export function splitWords(line: string): Word[] {
110
+ const words: Word[] = [];
111
+ let i = 0;
112
+ while (i < line.length) {
113
+ while (i < line.length && /\s/.test(line[i])) i++;
114
+ if (i >= line.length) break;
115
+ const quote = line[i];
116
+ if (quote === '"' || quote === "'") {
117
+ const close = closingQuote(line, i);
118
+ if (close < line.length) {
119
+ words.push({ text: line.slice(i + 1, close), quoted: true, end: close + 1 });
120
+ i = close + 1;
121
+ continue;
122
+ }
123
+ }
124
+ const option = /^--[^\s="']+=(["'])/.exec(line.slice(i));
125
+ if (option !== null) {
126
+ const open = i + option[0].length - 1;
127
+ const close = closingQuote(line, open);
128
+ if (close < line.length) {
129
+ words.push({ text: line.slice(i, open) + line.slice(open + 1, close), quoted: false, end: close + 1 });
130
+ i = close + 1;
131
+ continue;
132
+ }
133
+ }
134
+ let end = i;
135
+ while (end < line.length && !/\s/.test(line[end])) end++;
136
+ words.push({ text: line.slice(i, end), quoted: false, end });
137
+ i = end;
138
+ }
139
+ return words;
140
+ }
141
+
142
+ /** Whether a word is an option: it starts with `--` and is not quoted ("--stop", quoted, is a text). */
143
+ export function isOption(word: Word | undefined): boolean {
144
+ return word !== undefined && !word.quoted && word.text.startsWith("--");
145
+ }
146
+
147
+ /** The value an option takes: the next word, unless it is missing, blank or another option. */
148
+ export function optionValue(words: readonly Word[], at: number): string | null {
149
+ const value = words[at + 1];
150
+ return value === undefined || isOption(value) || value.text.trim().length === 0 ? null : value.text.trim();
151
+ }
152
+
153
+ // ── B-12: /debug-tool-call ────────────────────────────────────────────────
154
+
155
+ export type ParsedToolCall =
156
+ | { ok: true; tool: string; args: Record<string, unknown> }
157
+ | { ok: false; reason: string };
158
+
159
+ /**
160
+ * Parse `/debug-tool-call <tool_name> [json]` — the tool name, then an optional
161
+ * JSON object of arguments.
162
+ *
163
+ * The JSON is re-joined from the raw tokens rather than taken as one: the REPL
164
+ * splits on whitespace, so `{"path": "/a"}` arrives as two tokens and a naive
165
+ * `tokens[1]` would silently parse `{"path":` and fail with a confusing message.
166
+ *
167
+ * A malformed payload is REFUSED, not coerced. This command exists to reproduce a
168
+ * tool call faithfully; guessing at the caller's intent would defeat its only
169
+ * purpose, and an empty object would look like a successful no-arg call.
170
+ */
171
+ export function parseToolCallArgs(tokens: string[]): ParsedToolCall {
172
+ const tool = String(tokens?.[0] ?? "").trim();
173
+ if (tool.length === 0) {
174
+ return { ok: false, reason: "usage: /debug-tool-call <tool_name> [{\"arg\": \"value\"}]" };
175
+ }
176
+ if (!/^[a-z][a-z0-9_]*$/i.test(tool)) {
177
+ return { ok: false, reason: `'${tool}' is not a tool name (expected snake_case, e.g. file_read)` };
178
+ }
179
+
180
+ const payload = tokens.slice(1).join(" ").trim();
181
+ if (payload.length === 0) return { ok: true, tool, args: {} };
182
+
183
+ let parsed: unknown;
184
+ try {
185
+ parsed = JSON.parse(payload);
186
+ } catch (e: any) {
187
+ return { ok: false, reason: `arguments are not valid JSON (${String(e?.message ?? e)}): ${payload}` };
188
+ }
189
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
190
+ return { ok: false, reason: `arguments must be a JSON OBJECT, got ${Array.isArray(parsed) ? "an array" : typeof parsed}` };
191
+ }
192
+ return { ok: true, tool, args: parsed as Record<string, unknown> };
193
+ }
@@ -0,0 +1,368 @@
1
+ // /dev-batches: its arguments, its three shapes, and what its `completed` does with each answer of a chain.
2
+ // /dev-batches [<code>] [--pr] [--concurrency n] the run of a plan (the dev-batches crew);
3
+ // /dev-batches <code> F<n> [--close [--pr]] [— correction: <finding>] one batch (the dev-implement crew), its
4
+ // audit then its close chained as the batch's own chain (dev-implement.ts chainStep);
5
+ // /dev-batches <code> F<n> --audit [fast|full|resume] [--gate-only] the audit of one batch (the dev-verify crew).
6
+ // The aliases /dev-implement and /dev-verify keep their own lines: typed so, a line is read as the batch or the audit.
7
+ // The answers of a run are told apart by the crew that answered (`result.intent`, the crew's name:
8
+ // ScriptHostFacade.runCrewAsync); a run and one batch get answers from the same crews, so the dispatch records the
9
+ // chain it launched in the session (DEV_BATCHES_CHAIN_STATE_KEY) and `completed` reads it (devBatchesCompleted). The
10
+ // dev-batches crew answers JSON `{ lines, next? }`: its `next` (one batch) is launched. The batch and its audit answer
11
+ // as in the batch's own chain: the audit, then on VALID the close, which commits the batch and is sent `push: false`
12
+ // (the run pushes at its own close; the dev-implement crew keeps it, run-dev-implement.ts implementInputs). An answer
13
+ // of theirs that launches nothing (the batch committed, a stop, a GAPS verdict) launches the dev-batches crew again
14
+ // with the answer's last lines: it logs what came of the batch and names the next one. With `--concurrency n` (2 to 4)
15
+ // the crew runs a wave of batches itself, each under its own worktree, and answers `next: dev-batches` for the
16
+ // next wave: launched as it is, one hop per wave. Every hop of a run is launched with `{ chain: "continue" }` (Orkeon
17
+ // #221): the new instance keeps the depth of the one whose `completed` runs, so a plan of any length closes in one
18
+ // `/dev-batches` where `Orkeon:Cli:ScriptCommands:MaxChainDepth` (8) stopped it after about two batches. Before a
19
+ // hop that writes (a batch, its close, the crew again) the session's context is read again (Orkeon #220): a mode
20
+ // that no longer allows it refuses the hop, else the fresh mode and rules ride in the launch input. The answers are
21
+ // pure functions (batchesChainStep); batchesNextLaunch and launchBatchesHop orchestrate the ports of the `completed`.
22
+ import type { CrewLaunchOptions, SessionStore } from "../../../shared/application/ports.ts";
23
+ import { DEV_BATCHES_CHAIN_STATE_KEY } from "../../../shared/domain/session-keys.ts";
24
+ import { isCode } from "../../../shared/domain/dev/artefacts.ts";
25
+ import { checkConcurrency, concurrencyModeRefusal } from "../../../shared/domain/dev/batches-concurrency.ts";
26
+ import { correctionCommand } from "../../../shared/domain/dev/verdict-format.ts";
27
+ import { workspaceRelative } from "../../../shared/domain/vfs.ts";
28
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
29
+ import { launchCrew, withLlmProfile } from "../dispatch.ts";
30
+ import type { CommandLog, CrewCompletion, LaunchDeps } from "../dispatch.ts";
31
+ import { chainStep, freshContext, launchChained, nextLaunch, withContext, CONTEXT_NOT_READ_LINE } from "./dev-implement.ts";
32
+ import type { ChainHopDeps, ChainLaunch, DevImplementArgs, DevImplementDispatchDeps } from "./dev-implement.ts";
33
+ import { devVerifyStep, markActiveWorkflow, startDevStep, writeModeRefusal } from "../dev-step.ts";
34
+ import { storedEffort } from "../effort.ts";
35
+
36
+ export const DEV_BATCHES_USAGE =
37
+ "usage: /dev-batches [<code>] [--pr] [--concurrency n] | <code> F<n> [--close [--pr]] [— correction: <finding>]" +
38
+ " | <code> F<n> --audit [fast | full | resume] [--gate-only]" +
39
+ " (no code: the run in progress goes on; n from 1 to 4, above 1 in bypassPermissions; with F<n>, <code> may be a <path>/<CODE>-PLAN.md)";
40
+ /** `concurrency` only when the option is typed: without it the run goes on as the plan's run in progress was (one at a
41
+ * time when none is); `--concurrency 1` goes back to one at a time. */
42
+ export interface DevBatchesArgs { code: string | null; pr: boolean; concurrency?: number }
43
+ export type DevVerifyMode = "fast" | "full" | "resume";
44
+ /** The audit of one batch: its plan (a code or a `<path>/<CODE>-PLAN.md`, null to find it), its mode, the gate alone. */
45
+ export interface DevVerifyArgs { batch: string; plan: string | null; mode: DevVerifyMode; gateOnly: boolean }
46
+ /** The shape a line reads to: the run of a plan, one batch, or the audit of one batch. */
47
+ export type DevBatchesParse =
48
+ | { ok: true; route: "run"; args: DevBatchesArgs }
49
+ | { ok: true; route: "batch"; args: DevImplementArgs }
50
+ | { ok: true; route: "audit"; args: DevVerifyArgs }
51
+ | { ok: false; text: string };
52
+
53
+ /** The aliases that keep their own lines: one batch, and the audit of one batch. */
54
+ export const DEV_IMPLEMENT_ALIAS = "dev-implement";
55
+ export const DEV_VERIFY_ALIAS = "dev-verify";
56
+
57
+ const BATCH = /^F\d+$/;
58
+ const AUDIT_MODES: readonly string[] = ["fast", "full", "resume"];
59
+ const CORRECTION_WORD = /^correction:?(.*)$/i;
60
+ /** The options that name a batch: refused on the run of a plan. */
61
+ const BATCH_OPTIONS: readonly string[] = ["--close", "--audit", "--gate-only"];
62
+ const isConcurrency = (tok: string): boolean => tok === "--concurrency" || tok.startsWith("--concurrency=");
63
+ type Refusal = { ok: false; text: string };
64
+ const refuse = (text: string): Refusal => ({ ok: false, text: `dev-batches: ${text}` });
65
+
66
+ /** Splits `… — correction: <finding>` off the tokens: the ones before, and the finding (null without one). */
67
+ function splitCorrection(tokens: readonly string[]): { before: string[]; finding: string | null } {
68
+ for (let i = 0; i < tokens.length; i++) {
69
+ const dash = tokens[i] === "—" || tokens[i] === "--";
70
+ const at = dash ? i + 1 : i;
71
+ const word = tokens[at] ?? "";
72
+ // Without the dash the word needs its colon: `correction` alone may be a plan's code.
73
+ const m = dash || /^correction:/i.test(word) ? CORRECTION_WORD.exec(word) : null;
74
+ if (m === null) {
75
+ if (dash) return { before: [...tokens], finding: null };
76
+ continue;
77
+ }
78
+ const finding = [m[1], ...tokens.slice(at + 1)].join(" ").replace(/\s+/g, " ").trim();
79
+ return { before: tokens.slice(0, i), finding };
80
+ }
81
+ return { before: [...tokens], finding: null };
82
+ }
83
+
84
+ /** A plan named by its path: relative (or under /workspace/ for an audit), ending -PLAN.md, with no ".." segment. */
85
+ function isPlanPath(token: string, underWorkspace: boolean): boolean {
86
+ const relative = underWorkspace ? workspaceRelative(token) : token.replace(/\\/g, "/");
87
+ if (!relative.endsWith("-PLAN.md") || relative.startsWith("/")) return false;
88
+ return !relative.split("/").includes("..");
89
+ }
90
+
91
+ /** The run of a plan; `--concurrency <n>` (or `=<n>`) is checked: 1 to 4. */
92
+ function parseRun(tokens: readonly string[]): DevBatchesParse {
93
+ let code: string | null = null;
94
+ let pr = false;
95
+ let concurrency: number | undefined;
96
+ for (let i = 0; i < tokens.length; i++) {
97
+ const tok = tokens[i];
98
+ if (isConcurrency(tok)) {
99
+ const value = tok === "--concurrency" ? tokens[++i] : tok.slice("--concurrency=".length);
100
+ if (value === undefined) return refuse("--concurrency needs a number");
101
+ const c = checkConcurrency(value);
102
+ if (!c.ok) return refuse(c.line);
103
+ concurrency = c.value;
104
+ continue;
105
+ }
106
+ if (tok === "--pr") pr = true;
107
+ else if (BATCH_OPTIONS.includes(tok)) return refuse(`${tok} names its batch: /dev-batches <code> F<n> ${tok}`);
108
+ else if (tok.startsWith("-")) return refuse(`unknown option '${tok}' (--pr, --concurrency; with F<n>: --close, --audit)`);
109
+ else if (!isCode(tok)) return refuse(`'${tok}' is not a work code (a folder name of the work folder)`);
110
+ else if (code !== null) return refuse(`one code at most, not '${code}' and '${tok}'`);
111
+ else code = tok;
112
+ }
113
+ const args = concurrency !== undefined ? { code, pr, concurrency } : { code, pr };
114
+ return { ok: true, route: "run", args };
115
+ }
116
+
117
+ /** One batch: its plan, the close (`--pr` only with it), or a correction (never with the close). */
118
+ function parseBatch(batch: string, rest: readonly string[], finding: string | null): DevBatchesParse {
119
+ if (finding !== null && finding === "") {
120
+ return refuse(`a correction names its finding: ${correctionCommand("<code>", batch, "<the audit's gap>")}`);
121
+ }
122
+ let plan: string | null = null;
123
+ let close = false;
124
+ let pr = false;
125
+ for (const tok of rest) {
126
+ if (tok === "--close") close = true;
127
+ else if (tok === "--pr") pr = true;
128
+ else if (AUDIT_MODES.includes(tok) || tok === "--gate-only") return refuse(`'${tok}' goes with --audit: /dev-batches <code> ${batch} --audit ${tok}`);
129
+ else if (tok.startsWith("-")) return refuse(`unknown option '${tok}' with ${batch} (--close, --pr, --audit)`);
130
+ else if (isCode(tok) || isPlanPath(tok, false)) {
131
+ if (plan !== null) return refuse(`one plan at most, not '${plan}' and '${tok}'`);
132
+ plan = tok;
133
+ } else return refuse(`'${tok}' is neither a code nor a <CODE>-PLAN.md path`);
134
+ }
135
+ if (pr && !close) return refuse(`with ${batch}, --pr goes with --close (the pull request is opened at the close)`);
136
+ if (close && finding !== null) return refuse("a correction runs the batch, --close commits it: one at a time");
137
+ return { ok: true, route: "batch", args: { batch, plan, close, pr, correction: finding } };
138
+ }
139
+
140
+ /** The audit of one batch: one mode at most (fast by default), the gate alone with --gate-only. The words fast, full
141
+ * and resume are modes: a code spelt so is named by its plan's path. */
142
+ function parseAudit(batch: string, rest: readonly string[]): DevBatchesParse {
143
+ let mode: DevVerifyMode | null = null;
144
+ let plan: string | null = null;
145
+ let gateOnly = false;
146
+ for (const tok of rest) {
147
+ if (AUDIT_MODES.includes(tok)) {
148
+ if (mode !== null) return refuse(`one audit mode at most (fast, full or resume), not '${mode}' and '${tok}'`);
149
+ mode = tok as DevVerifyMode;
150
+ } else if (tok === "--gate-only") {
151
+ gateOnly = true;
152
+ } else if (tok.startsWith("-")) {
153
+ return refuse(`unknown option '${tok}' with --audit (only --gate-only)`);
154
+ } else if (isCode(tok) || isPlanPath(tok, true)) {
155
+ if (plan !== null) return refuse(`one plan at most, not '${plan}' and '${tok}'`);
156
+ plan = tok;
157
+ } else {
158
+ return refuse(`'${tok}' is neither a code nor a <CODE>-PLAN.md path`);
159
+ }
160
+ }
161
+ return { ok: true, route: "audit", args: { batch, plan, mode: mode ?? "fast", gateOnly } };
162
+ }
163
+
164
+ /**
165
+ * The line after /dev-batches, read to its shape: no `F<n>`, the run of a plan; `F<n>`, one batch; `F<n> --audit`,
166
+ * its audit. `typed` is the name the person typed: /dev-implement names a batch, /dev-verify an audit.
167
+ */
168
+ export function parseDevBatchesArgs(tokens: readonly string[], typed = "dev-batches"): DevBatchesParse {
169
+ const { before, finding } = splitCorrection(tokens);
170
+ if (before.includes("--help") || before.includes("-h")) return { ok: false, text: DEV_BATCHES_USAGE };
171
+ const at = before.findIndex((t) => BATCH.test(t));
172
+ const audit = typed === DEV_VERIFY_ALIAS || before.includes("--audit");
173
+ if (at < 0) {
174
+ if (typed === DEV_IMPLEMENT_ALIAS || typed === DEV_VERIFY_ALIAS) {
175
+ return tokens.length === 0 ? { ok: false, text: DEV_BATCHES_USAGE } : refuse(`/${typed} names its batch first: F<n>, e.g. F2`);
176
+ }
177
+ if (finding !== null) return refuse(`a correction names its batch: ${correctionCommand("<code>", "F<n>", "<finding>")}`);
178
+ return parseRun(before);
179
+ }
180
+ const batch = before[at];
181
+ const rest = [...before.slice(0, at), ...before.slice(at + 1)];
182
+ const other = rest.find((t) => BATCH.test(t));
183
+ if (other !== undefined) return refuse(`one batch at most, not ${batch} and ${other}`);
184
+ if (rest.some(isConcurrency)) return refuse(`--concurrency runs a plan's batches: it does not go with ${batch}`);
185
+ if (!audit) return parseBatch(batch, rest, finding);
186
+ if (finding !== null) return refuse("--audit judges the batch, a correction runs it: one at a time");
187
+ return parseAudit(batch, rest.filter((t) => t !== "--audit"));
188
+ }
189
+
190
+ /** What the command launches the crew with: the arguments, then what its dispatch read; `concurrency` when typed. */
191
+ export function batchesLaunchInput(args: DevBatchesArgs, read: Record<string, unknown>): Record<string, unknown> {
192
+ return {
193
+ ...(args.code === null ? {} : { code: args.code }), pr: args.pr, ...read,
194
+ ...(args.concurrency === undefined ? {} : { concurrency: args.concurrency }),
195
+ };
196
+ }
197
+
198
+ /** Above 1, the refusal of a session mode that asks before shell commands, before anything is launched. */
199
+ export function batchesModeRefusal(args: DevBatchesArgs, mode: string): string | null {
200
+ const line = concurrencyModeRefusal(args.concurrency ?? 1, mode);
201
+ return line === null ? null : `dev-batches: ${line}`;
202
+ }
203
+
204
+ /** The lines of an answer handed back to the dev-batches crew. */
205
+ export const AFTER_LINES = 20;
206
+ const DEV_BATCHES_AGAIN = "/dev-batches";
207
+
208
+ /** What a refused hop of a parallel run is typed again as: the same concurrency, the record naming the plan. */
209
+ const parallelAgain = (input: Record<string, unknown>): string =>
210
+ typeof input.concurrency === "number" && input.concurrency > 1 ? `${DEV_BATCHES_AGAIN} --concurrency ${input.concurrency}` : DEV_BATCHES_AGAIN;
211
+
212
+ export interface BatchesChainStep { lines: string[]; launch?: ChainLaunch }
213
+
214
+ function batchesAnswer(payload: string): BatchesChainStep {
215
+ let parsed: unknown = null;
216
+ try {
217
+ parsed = JSON.parse(payload);
218
+ } catch {
219
+ return { lines: payload.split("\n") };
220
+ }
221
+ const a = parsed as { lines?: unknown; next?: { crew?: unknown; input?: Record<string, unknown> } } | null;
222
+ if (a === null || typeof a !== "object" || !Array.isArray(a.lines)) return { lines: payload.split("\n") };
223
+ const lines = a.lines.map(String);
224
+ // The next wave of a parallel run: the crew again, with the input it gave.
225
+ if (a.next?.crew === "dev-batches" && a.next.input !== undefined) {
226
+ return { lines, launch: { crew: "dev-batches", input: { ...a.next.input }, instead: parallelAgain(a.next.input) } };
227
+ }
228
+ if (a.next?.crew !== "dev-implement" || a.next.input === undefined) return { lines };
229
+ const { batch, plan } = a.next.input;
230
+ return { lines, launch: { crew: "dev-implement", input: { ...a.next.input }, instead: `/dev-batches ${plan} ${batch}` } };
231
+ }
232
+
233
+ /** What `completed` prints and launches for one answer, by the crew that gave it. */
234
+ export function batchesChainStep(intent: string, payload: string): BatchesChainStep {
235
+ if (intent === "dev-batches") return batchesAnswer(payload);
236
+ if (intent !== "dev-implement" && intent !== "dev-verify") return { lines: payload.split("\n") };
237
+ const step = chainStep(payload);
238
+ if (step.launch !== undefined) {
239
+ const close = step.launch.crew === "dev-implement" && step.launch.input.close === true;
240
+ // A batch's close never pushes nor opens a pull request: the run's close does both.
241
+ return close ? { lines: step.lines, launch: { ...step.launch, input: { ...step.launch.input, push: false, githubTool: false } } } : step;
242
+ }
243
+ const after = step.lines.filter((l) => l.trim() !== "").slice(-AFTER_LINES);
244
+ return { lines: step.lines, launch: { crew: "dev-batches", input: { after }, instead: DEV_BATCHES_AGAIN } };
245
+ }
246
+
247
+ /** Every hop of the run keeps the depth of the instance whose `completed` launches it (Orkeon #221). */
248
+ export const BATCHES_CHAIN: CrewLaunchOptions = { chain: "continue" };
249
+
250
+ const BATCHES_WRITES = { step: "dev-batches", what: "writes files, commits and pushes" };
251
+ const CHAIN_FAILED_THEN = "then type /dev-batches: the run goes on from the first batch not done";
252
+
253
+ /**
254
+ * What `completed` prints and launches for one answer of the run, the gate put back and, before a hop that writes
255
+ * (every hop but the audit), the session's context read again: a read-only mode, or a mode that asks before a
256
+ * parallel wave, refuses the hop with the command to type; else the launch carries the fresh mode and rules, and
257
+ * the crews read them rather than the run record's. A context that cannot be read leaves the record's in force.
258
+ */
259
+ export async function batchesNextLaunch(result: CrewCompletion, deps: ChainHopDeps): Promise<BatchesChainStep> {
260
+ if (!result.success) {
261
+ return { lines: [`✗ the dev-batches chain failed (${result.intent || "a crew"}): ${result.error ?? "unknown"}`, CHAIN_FAILED_THEN] };
262
+ }
263
+ const step = batchesChainStep(String(result.intent ?? ""), String(result.payload ?? ""));
264
+ if (step.launch === undefined) return step;
265
+ const refusal = deps.reapply(step.launch.crew === "dev-verify" ? "dev-verify" : "dev-implement");
266
+ if (refusal !== null) return { lines: [...step.lines, `✗ ${refusal}`, `then type ${step.launch.instead}`] };
267
+ if (step.launch.crew === "dev-verify") return step;
268
+ const context = await freshContext(deps.context);
269
+ if (context === null) return { lines: [...step.lines, CONTEXT_NOT_READ_LINE], launch: step.launch };
270
+ const concurrency = step.launch.crew === "dev-batches" && typeof step.launch.input.concurrency === "number" ? step.launch.input.concurrency : 1;
271
+ const line = writeModeRefusal(context.permissionMode, BATCHES_WRITES.step, BATCHES_WRITES.what)
272
+ ?? batchesModeRefusal({ code: null, pr: false, concurrency }, context.permissionMode);
273
+ if (line !== null) return { lines: [...step.lines, line.startsWith("✗") ? line : `✗ ${line}`, `then type ${step.launch.instead}`] };
274
+ return { lines: step.lines, launch: { ...step.launch, input: withContext(step.launch.input, context) } };
275
+ }
276
+
277
+ /** Launches a hop of the run with the parent's depth kept (BATCHES_CHAIN): the lines a refusal or a failure leaves. */
278
+ export function launchBatchesHop(launch: ChainLaunch, deps: LaunchDeps): string[] {
279
+ return launchChained(launch, (crew, input, options) => launchCrew(deps, crew, input, {}, options), BATCHES_CHAIN);
280
+ }
281
+
282
+ /** The line `completed` prints when a hop's own reading fails (the context read threw past the handler). */
283
+ export function batchesHopFailedLine(error: unknown): string {
284
+ return `✗ the dev-batches chain stopped (${String((error as Error)?.message ?? error).split("\n")[0]}): ${CHAIN_FAILED_THEN}`;
285
+ }
286
+
287
+ /** The chain a dispatch launched, kept in the session for `completed`: the run of a plan, one batch, one audit. */
288
+ export type BatchesChain = "run" | "batch" | "audit";
289
+ const CHAINS: readonly string[] = ["run", "batch", "audit"];
290
+
291
+ /**
292
+ * Records the chain about to be launched. A run is what an unrecorded chain is read as, so its failure costs
293
+ * nothing; a batch or an audit read as a run would chain the wrong hops, so its failure is the refusal returned.
294
+ */
295
+ export async function recordChain(session: Pick<SessionStore, "writeState">, chain: BatchesChain): Promise<string | null> {
296
+ try {
297
+ await session.writeState(DEV_BATCHES_CHAIN_STATE_KEY, chain);
298
+ return null;
299
+ } catch (error) {
300
+ if (chain === "run") return null;
301
+ const reason = String((error as Error)?.message ?? error).split("\n")[0];
302
+ return `dev-batches: the session could not keep which chain runs (${reason}): nothing was launched`;
303
+ }
304
+ }
305
+
306
+ /** The chain an answer belongs to: the dev-batches crew answers only a run; another crew's answer, the recorded one
307
+ * (a run when none was recorded or the session cannot be read). */
308
+ export async function readChain(session: Pick<SessionStore, "readState">, intent: string): Promise<BatchesChain> {
309
+ if (intent === "dev-batches") return "run";
310
+ try {
311
+ const value = await session.readState(DEV_BATCHES_CHAIN_STATE_KEY);
312
+ return value !== null && CHAINS.includes(value) ? (value as BatchesChain) : "run";
313
+ } catch {
314
+ return "run";
315
+ }
316
+ }
317
+
318
+ export interface BatchesCompletedDeps extends ChainHopDeps { session: Pick<SessionStore, "readState"> }
319
+ export interface BatchesCompletion { chain: BatchesChain; lines: string[]; launch?: ChainLaunch }
320
+
321
+ /**
322
+ * What `completed` prints and launches for one answer, by its chain: a run's hop (batchesNextLaunch), one batch's
323
+ * audit or close (nextLaunch, the chain of a typed batch), or an audit's verdict printed, nothing launched.
324
+ */
325
+ export async function devBatchesCompleted(result: CrewCompletion, deps: BatchesCompletedDeps): Promise<BatchesCompletion> {
326
+ const chain = await readChain(deps.session, String(result.intent ?? ""));
327
+ if (chain === "audit") {
328
+ if (result.success && result.streamed === true) return { chain, lines: [] };
329
+ return { chain, lines: [result.success ? String(result.payload ?? "") : `✗ the audit failed: ${result.error ?? "unknown"}`] };
330
+ }
331
+ const step = chain === "batch" ? await nextLaunch(result, deps) : await batchesNextLaunch(result, deps);
332
+ return { chain, ...step };
333
+ }
334
+
335
+ /** Launches the hop of a completion: a run's keeps its parent's depth (BATCHES_CHAIN), one batch's climbs (at most
336
+ * three hops from a typed command). The lines a refusal or a failure leaves. */
337
+ export async function launchCompletedHop(
338
+ completion: BatchesCompletion, deps: LaunchDeps & { log: Pick<CommandLog, "warn"> }, config: Pick<ConfigStore, "readValue" | "readFile">,
339
+ ): Promise<string[]> {
340
+ if (completion.launch === undefined) return [];
341
+ const profiled = await withLlmProfile(deps, config);
342
+ if (completion.chain !== "batch") return launchBatchesHop(completion.launch, profiled);
343
+ return launchChained(completion.launch, (crew, input) => launchCrew(profiled, crew, input));
344
+ }
345
+
346
+ export type DevVerifyDispatchDeps = Omit<DevImplementDispatchDeps, "files" | "shell">;
347
+ export type DevVerifyDispatch = { refused: string } | { input: Record<string, unknown>; details: Record<string, unknown> };
348
+
349
+ /** One audit's dispatch, from its parsed arguments: unless --gate-only (no model, no gate), the step's rules put in
350
+ * the gate; the batch recorded as the one in progress; the crew's input. */
351
+ export async function runDevVerifyDispatch(args: DevVerifyArgs, deps: DevVerifyDispatchDeps): Promise<DevVerifyDispatch> {
352
+ const step = devVerifyStep(args);
353
+ let details: Record<string, unknown> = {};
354
+ let crewInput: Record<string, unknown> = { hooks: [] };
355
+ if (step !== null) {
356
+ const start = await startDevStep(step, { session: deps.session, config: deps.config, gate: deps.gate(), catalogue: deps.catalogue() });
357
+ if (!start.ok) {
358
+ deps.write(start.line);
359
+ return { refused: start.line };
360
+ }
361
+ for (const line of start.lines) deps.write(line);
362
+ details = { ruleSets: start.sets.join(" "), rules: start.rules, hooks: start.hooks.length };
363
+ crewInput = start.input;
364
+ }
365
+ const unrecorded = await markActiveWorkflow(deps.session, args);
366
+ if (unrecorded !== null) deps.write(unrecorded);
367
+ return { input: { ...args, ...crewInput, effort: await storedEffort(deps.session) }, details };
368
+ }