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,185 @@
1
+ // One batch of /dev-batches (`/dev-batches <code> F<n> …`, its alias /dev-implement): its dispatch, and what its
2
+ // `completed` does with each answer of the batch's chain. The dev-implement crew answers JSON `{ lines, next? }`: the
3
+ // lines are printed and `next` (the audit, its input as the crew wrote it: mode, hooks, effort) is launched. The
4
+ // audit (the dev-verify crew), launched from here, drains to the same `completed` as plain text: printed, and on its
5
+ // VALID line the close is launched (`/dev-batches <plan> F<n> --close`). A launch that cannot run prints the command
6
+ // for the user instead. Before a hop that writes (the close), the session's context is read again (Orkeon #220,
7
+ // `completed` awaited by the host): a mode that no longer allows it refuses the hop with the command to type, else the
8
+ // fresh mode, rules and github tool ride in the launch input, so the crew reads them rather than the context its
9
+ // record kept at the launch; a context that cannot be read leaves the record's in force, said in a line. The dispatch
10
+ // (runDevImplementDispatch) checks the mode, starts the step and sizes the run to the sheet's open steps over the
11
+ // ports it is handed; the chain's launch is handed to it too.
12
+ import type { CrewLaunchOptions, Files, PermissionRules, Shell, ToolCatalogue } from "../../../shared/application/ports.ts";
13
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
14
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
15
+ import { auditCommand, closeCommand } from "../../../shared/domain/dev/verdict-format.ts";
16
+ import type { DevStep } from "../../../shared/domain/dev/step-rules.ts";
17
+ import { countOpenSteps } from "../../../crews/dev-implement/application/count-open-steps.ts";
18
+ import { markActiveWorkflow, startDevStep, writeModeRefusal } from "../dev-step.ts";
19
+ import type { CrewCompletion, LaunchResult } from "../dispatch.ts";
20
+ import { storedEffort } from "../effort.ts";
21
+ import { readPullRequestContext } from "../pr-context.ts";
22
+ import type { PullRequestContext } from "../pr-context.ts";
23
+ import { VALID_LINE, WRITTEN_LINE } from "./markers.ts";
24
+ import { CLOSE_COMMITS, CONTEXT_NOT_READ_LINE, WRITES_COMMITS_PUSHES, batchChainFailed, closeFollows, couldNotBeLaunched, thenType } from "./messages.ts";
25
+ import { failedLine } from "../messages.ts";
26
+
27
+ /** One batch of a plan, as `/dev-batches <code> F<n> [--close [--pr]] [— correction: <finding>]` reads it
28
+ * (dev-batches.ts parseDevBatchesArgs): the batch, its plan (a code or a `<path>/<CODE>-PLAN.md`, null to find it). */
29
+ export interface DevImplementArgs { batch: string; plan: string | null; close: boolean; pr: boolean; correction: string | null }
30
+
31
+ export interface ChainLaunch { crew: string; input: Record<string, unknown>; instead: string }
32
+ export interface ChainStep { lines: string[]; launch?: ChainLaunch }
33
+
34
+ /** What `completed` prints and launches for one answer of the chain. */
35
+ export function chainStep(payload: string): ChainStep {
36
+ let parsed: unknown = null;
37
+ try {
38
+ parsed = JSON.parse(payload);
39
+ } catch {
40
+ parsed = null;
41
+ }
42
+ const answer = parsed as { lines?: unknown; next?: { crew?: unknown; input?: Record<string, unknown> } } | null;
43
+ if (answer !== null && typeof answer === "object" && Array.isArray(answer.lines)) {
44
+ const lines = answer.lines.map(String);
45
+ const next = answer.next;
46
+ if (next?.crew === "dev-verify" && next.input !== undefined) {
47
+ const { batch, plan, mode } = next.input;
48
+ const instead = auditCommand(String(plan ?? "<code>"), String(batch), mode === "resume" ? "resume" : undefined);
49
+ return { lines, launch: { crew: "dev-verify", input: { ...next.input }, instead } };
50
+ }
51
+ return { lines };
52
+ }
53
+ // The audit's own answer, drained here by the chain.
54
+ const lines = payload.split("\n");
55
+ // The VALID line is the audit's own: at the start of a line, after the verdict file's, for that file's batch; a
56
+ // gap that quotes it from model text launches nothing.
57
+ const written = WRITTEN_LINE.exec(payload);
58
+ const valid = written === null ? null : VALID_LINE.exec(payload.slice(written.index + written[0].length));
59
+ if (valid === null || written === null || valid[1] !== written[3]) return { lines };
60
+ const plan = `${written[1]}/${written[2]}-PLAN.md`;
61
+ return {
62
+ lines: [...lines, closeFollows(closeCommand(plan, valid[1]))],
63
+ launch: { crew: "dev-implement", input: { batch: valid[1], plan, close: true }, instead: closeCommand(plan, valid[1]) },
64
+ };
65
+ }
66
+
67
+ export interface DevImplementDispatchDeps {
68
+ session: Pick<SessionIo, "resolveEffectiveSessionMode" | "readState" | "writeState">;
69
+ config: Pick<ConfigStore, "readValue" | "readFile">;
70
+ files: Files;
71
+ shell: Shell;
72
+ /** The host's gate and its tools, each made when read: a host without the service fails there. */
73
+ gate: () => PermissionRules;
74
+ catalogue: () => Pick<ToolCatalogue, "find">;
75
+ write(line: string): void;
76
+ }
77
+
78
+ export type DevImplementDispatch =
79
+ | { refused: string }
80
+ | { input: Record<string, unknown>; details: { ruleSets: string; rules: number; hooks: number } };
81
+
82
+ /** One batch's dispatch, from its parsed arguments: the refusal, written, or the crew's input and the launch's details. */
83
+ export async function runDevImplementDispatch(args: DevImplementArgs, deps: DevImplementDispatchDeps): Promise<DevImplementDispatch> {
84
+ const prContext = await readPullRequestContext({ catalogue: deps.catalogue, rules: deps.gate, session: deps.session });
85
+ const line = writeModeRefusal(String(prContext.permissionMode ?? ""), "dev-batches", WRITES_COMMITS_PUSHES);
86
+ if (line !== null) {
87
+ deps.write(line);
88
+ return { refused: line };
89
+ }
90
+ const start = await startDevStep("dev-implement", {
91
+ session: deps.session, config: deps.config, gate: deps.gate(), catalogue: deps.catalogue(),
92
+ });
93
+ if (!start.ok) {
94
+ deps.write(start.line);
95
+ return { refused: start.line };
96
+ }
97
+ for (const line of start.lines) deps.write(line);
98
+ const unrecorded = await markActiveWorkflow(deps.session, args);
99
+ if (unrecorded !== null) deps.write(unrecorded);
100
+ // The budget is sized to the open steps of the sheet (the crew sizes for its default when they cannot be counted).
101
+ // A correction adds one step, appended by the crew after this count.
102
+ const open = args.close
103
+ ? undefined
104
+ : await countOpenSteps({ files: deps.files, shell: deps.shell, config: deps.config }, args.batch, args.plan);
105
+ const steps = open === undefined || args.correction === null ? open : open + 1;
106
+ const input = {
107
+ ...args, ...start.input, effort: await storedEffort(deps.session), ...(steps === undefined ? {} : { steps }), ...prContext,
108
+ };
109
+ return { input, details: { ruleSets: start.sets.join(" "), rules: start.rules, hooks: start.hooks.length } };
110
+ }
111
+
112
+ /** What a hop of a chain reads before it launches: the gate put back, the session's context read again. */
113
+ export interface ChainHopDeps {
114
+ /** Puts the step's rules back in the gate; its refusal launches nothing. */
115
+ reapply: (step: DevStep) => string | null;
116
+ /** The session's context as it is now (readPullRequestContext); a read that fails leaves the record's in force. */
117
+ context: () => Promise<PullRequestContext>;
118
+ }
119
+
120
+ /** What the close writes, for the refusal of a read-only mode. */
121
+ const CLOSE_WRITES = { step: "dev-batches", what: CLOSE_COMMITS };
122
+
123
+ /** The session's context now, or null when it cannot be read (a throw, an empty mode). */
124
+ export async function freshContext(read: () => Promise<PullRequestContext>): Promise<PullRequestContext | null> {
125
+ try {
126
+ const context = await read();
127
+ return context.permissionMode.trim() === "" ? null : context;
128
+ } catch {
129
+ return null;
130
+ }
131
+ }
132
+
133
+ /** The launch input with the fresh mode and rules; the github tool as the input names it, else as the session has it. */
134
+ export function withContext(input: Record<string, unknown>, context: PullRequestContext): Record<string, unknown> {
135
+ return {
136
+ ...input, permissionMode: context.permissionMode, permissionRules: [...context.permissionRules],
137
+ githubTool: typeof input.githubTool === "boolean" ? input.githubTool : context.githubTool,
138
+ };
139
+ }
140
+
141
+ /**
142
+ * A hop that writes, with the session's context read again (Orkeon #220): refused, with the command to type, when
143
+ * the mode no longer lets `writes.step` write; the launch with the fresh context in its input otherwise; the launch
144
+ * as it is, said in a line, when the context cannot be read.
145
+ */
146
+ export async function writingHop(
147
+ launch: ChainLaunch, read: () => Promise<PullRequestContext>, writes: { step: string; what: string },
148
+ ): Promise<ChainStep> {
149
+ const context = await freshContext(read);
150
+ if (context === null) return { lines: [CONTEXT_NOT_READ_LINE], launch };
151
+ const refusal = writeModeRefusal(context.permissionMode, writes.step, writes.what);
152
+ if (refusal !== null) return { lines: [refusal, thenType(launch.instead)] };
153
+ return { lines: [], launch: { ...launch, input: withContext(launch.input, context) } };
154
+ }
155
+
156
+ /**
157
+ * What `completed` prints for one answer of the chain, and the launch that follows. No dispatch runs before a
158
+ * chained launch: the gate is checked and the step's rules put back by `reapply`, whose refusal launches nothing;
159
+ * the close then reads the session's context again (writingHop); the audit is launched as the crew named it.
160
+ */
161
+ export async function nextLaunch(result: CrewCompletion, deps: ChainHopDeps): Promise<ChainStep> {
162
+ if (!result.success) return { lines: [batchChainFailed(result.error ?? "unknown")] };
163
+ const step = chainStep(String(result.payload ?? ""));
164
+ if (step.launch === undefined) return step;
165
+ const refusal = deps.reapply(step.launch.crew === "dev-verify" ? "dev-verify" : "dev-implement");
166
+ if (refusal !== null) return { lines: [...step.lines, failedLine(refusal), thenType(step.launch.instead)] };
167
+ if (step.launch.crew !== "dev-implement") return step;
168
+ const hop = await writingHop(step.launch, deps.context, CLOSE_WRITES);
169
+ return hop.launch === undefined ? { lines: [...step.lines, ...hop.lines] } : { lines: [...step.lines, ...hop.lines], launch: hop.launch };
170
+ }
171
+
172
+ /** The lines a chained launch leaves: none once launched; its refusal or its failure, and the command to type instead.
173
+ * `options` go to the launch as they are (`{ chain: "continue" }` for a driver that relaunches itself). */
174
+ export function launchChained(
175
+ launch: ChainLaunch,
176
+ run: (crew: string, input: Record<string, unknown>, options?: CrewLaunchOptions) => LaunchResult,
177
+ options?: CrewLaunchOptions,
178
+ ): string[] {
179
+ try {
180
+ const launched = run(launch.crew, launch.input, options);
181
+ return "refused" in launched ? [failedLine(launched.refused), thenType(launch.instead)] : [];
182
+ } catch (e) {
183
+ return [couldNotBeLaunched(launch.crew, String((e as Error)?.message ?? e).split("\n")[0], launch.instead)];
184
+ }
185
+ }
@@ -0,0 +1,61 @@
1
+ // The arguments of /dev-spec and of its alias /dev-change, read from the line the REPL hands over (quotes kept, so a
2
+ // --run command stays whole). A code first, then a kind (bug, refactor or perf: a change brief, run by the dev-change
3
+ // crew), a --run "<command>" after the kind and before the text, and the rest as one text: the brief, the origin or a
4
+ // revision request. Without a kind the line is a spec, run by the dev-spec crew, and --run is refused. Typed as
5
+ // /dev-change (the alias), the line keeps that command's shape: always the dev-change crew, the kind optional on a
6
+ // revision of a brief (the crew checks it).
7
+ import { commandLine, isOption, splitWords } from "../args.ts";
8
+ import { isCode } from "../../../shared/domain/dev/artefacts.ts";
9
+ import { DEV_SPEC_USAGE, RUN_BEFORE_TEXT, RUN_NEEDS_COMMAND, RUN_NEEDS_KIND, notASpecCode, withUsage } from "./messages.ts";
10
+ import { unknownOption } from "../messages.ts";
11
+
12
+ export interface DevSpecArgs { code: string; request: string }
13
+ export interface DevChangeArgs { code: string; kind: string; run: string; text: string }
14
+ /** The crew the line runs, with its input: a spec without a kind, a change brief with one. */
15
+ export type DevSourceParse =
16
+ | { ok: true; crew: "dev-spec"; args: DevSpecArgs }
17
+ | { ok: true; crew: "dev-change"; args: DevChangeArgs }
18
+ | { ok: false; text: string };
19
+
20
+ const MAX_CODE = 64;
21
+ const KINDS = new Set(["bug", "refactor", "perf"]);
22
+ /** The alias that keeps /dev-change's own shape. */
23
+ export const DEV_CHANGE_ALIAS = "dev-change";
24
+
25
+ function codeOf(word: string | undefined): { ok: true; code: string } | { ok: false; text: string } {
26
+ if (word === undefined || word.trim() === "") return { ok: false, text: DEV_SPEC_USAGE };
27
+ if (word.length > MAX_CODE || !isCode(word)) return { ok: false, text: withUsage(notASpecCode(word), DEV_SPEC_USAGE) };
28
+ return { ok: true, code: word };
29
+ }
30
+
31
+ /** The text after the word at `from`: what the person typed, as typed. */
32
+ const restOf = (line: string, words: ReturnType<typeof splitWords>, from: number): string =>
33
+ from >= words.length ? "" : line.slice(from === 0 ? 0 : words[from - 1].end).trim();
34
+
35
+ /** The line after /dev-spec (or `typed`, the name the person typed: /dev-change keeps its own shape). */
36
+ export function parseDevSpecArgs(tokens: readonly string[], typed = "dev-spec"): DevSourceParse {
37
+ const line = commandLine(tokens);
38
+ const words = splitWords(line);
39
+ const code = codeOf(words[0]?.text);
40
+ if (!code.ok) return code;
41
+ let at = 1;
42
+ let kind = "";
43
+ if (words[at] !== undefined && !words[at].quoted && KINDS.has(words[at].text)) { kind = words[at].text; at++; }
44
+ let run = "";
45
+ if (isOption(words[at])) {
46
+ if (words[at].text !== "--run") return { ok: false, text: withUsage(unknownOption(words[at].text), DEV_SPEC_USAGE) };
47
+ const value = words[at + 1];
48
+ if (value === undefined || isOption(value) || value.text.trim() === "") return { ok: false, text: withUsage(RUN_NEEDS_COMMAND, DEV_SPEC_USAGE) };
49
+ run = value.text.trim();
50
+ at += 2;
51
+ }
52
+ if (words.slice(at).some((w) => !w.quoted && w.text === "--run")) {
53
+ return { ok: false, text: withUsage(RUN_BEFORE_TEXT, DEV_SPEC_USAGE) };
54
+ }
55
+ const text = words.length === at + 1 && words[at].quoted ? words[at].text : restOf(line, words, at);
56
+ if (kind === "" && typed !== DEV_CHANGE_ALIAS) {
57
+ if (run !== "") return { ok: false, text: withUsage(RUN_NEEDS_KIND, DEV_SPEC_USAGE) };
58
+ return { ok: true, crew: "dev-spec", args: { code: code.code, request: text } };
59
+ }
60
+ return { ok: true, crew: "dev-change", args: { code: code.code, kind, run, text } };
61
+ }
@@ -0,0 +1,341 @@
1
+ // /dev-status: where a piece of dev work stands, read from the files the dev workflow
2
+ // leaves in the work folder (the global plan, the batch sheets, the verdicts and the
3
+ // batches log). Read-only. The use case takes its ports and returns a CommandView;
4
+ // dev-status.cmd.ts wires the real ports and shows it.
5
+ import type { CommandView } from "../view.ts";
6
+ import type { CodeSummary, DevCode, DevContext, DevContextDeps } from "../../../shared/application/dev/load-dev-context.ts";
7
+ import { loadDevCode, loadDevContext, probeDevCodes } from "../../../shared/application/dev/load-dev-context.ts";
8
+ import { workFolderLabel } from "../../../shared/application/dev/resolve-work-folder.ts";
9
+ import { PROPOSAL_ID, runDevLearnDecision } from "../../../shared/application/dev/learn-decision.ts";
10
+ export { runDevLearnDecision };
11
+ export type { DevLearnDecisionDeps } from "../../../shared/application/dev/learn-decision.ts";
12
+ import { compareBatchIds, isCode } from "../../../shared/domain/dev/artefacts.ts";
13
+ import { sheetProgress } from "../../../shared/domain/dev/plan-format.ts";
14
+ import type { BatchState, PlanBatch } from "../../../shared/domain/dev/plan-format.ts";
15
+ import { lastVerdict, severityCounts } from "../../../shared/domain/dev/verdict-format.ts";
16
+ import { readPlanSource, resolvePlanSource } from "../../../shared/application/dev/plan-source.ts";
17
+ import { blockingStop } from "../../../shared/domain/dev/spec-format.ts";
18
+ import { ACCEPT_NEEDS_ID, ACCEPT_REFUSE_ALONE, DEV_STATUS_USAGE, NOT_IN_THE_PLAN, NO_CODE_HERE, NO_SHEET, NO_VERDICT, REFUSED_MOTIF_TOO_LONG, REFUSE_NEEDS_TARGET, REPLACE_ONCE, devStatusCannotList, codesHere, holdsNoDevFile, learnUnknownOption, moreBatches, moreFoldersNotProbed, moreWarnings, noBatchLine, noCodeUnder, noFolder, notAProposalId, notAStatusCode, notAnAxis, oneAxisAtMost, oneSourceAtMost, packLine, planLine, planUnknownOption, sheetOpenTicks, validButOpen, warningLine, workFolderInMainWorktree, workFolderLine } from "./messages.ts";
19
+ import { notASource as notACodeNorSource } from "../../../shared/application/dev/messages.ts";
20
+
21
+ export type DevStatusDeps = DevContextDeps;
22
+ const MAX_BATCH_LINES = 20;
23
+ export const MAX_WARNING_LINES = 5;
24
+ export const MAX_LINE_CHARS = 160;
25
+
26
+ const MAX_WARNING_CHARS = 200;
27
+ const MAX_NAME_CHARS = 40;
28
+ const MAX_CODES_LISTED = 30;
29
+ const MAX_CODE_ENTRY_CHARS = 60;
30
+ const TEXT_BUDGET = 3900;
31
+ const SHRUNK_BATCH_LINES = 15;
32
+ const SHRUNK_WARNING_LINES = 3;
33
+
34
+ const messageOf = (e: unknown): string => (e instanceof Error ? e.message : String(e));
35
+
36
+ function cut(text: string, max: number): string {
37
+ return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
38
+ }
39
+
40
+ function contextLines(ctx: DevContext): string[] {
41
+ const packShown = ctx.pack?.shown ?? null;
42
+ return [
43
+ cut(workFolderLine(workFolderLabel(ctx.work, packShown)), MAX_LINE_CHARS),
44
+ cut(packLine(packShown ?? "none"), MAX_LINE_CHARS),
45
+ ];
46
+ }
47
+
48
+ function warningLines(warnings: readonly string[], max: number): string[] {
49
+ const shown = warnings.slice(0, max).map((w) => cut(warningLine(w), MAX_WARNING_CHARS));
50
+ if (warnings.length > max) shown.push(moreWarnings(warnings.length - max));
51
+ return shown;
52
+ }
53
+
54
+ function refusal(ctx: DevContext, text: string): CommandView {
55
+ return { lines: [...contextLines(ctx), ...warningLines(ctx.warnings, MAX_WARNING_LINES)], text };
56
+ }
57
+
58
+ function stateText(batch: PlanBatch | undefined): string {
59
+ if (!batch) return NOT_IN_THE_PLAN;
60
+ const s: BatchState = batch.state;
61
+ if (s.kind === "open") return "open";
62
+ if (s.kind === "done") return `done ${s.date}`;
63
+ return s.text;
64
+ }
65
+
66
+ function verdictText(code: DevCode, id: string): { text: string; valid: boolean } {
67
+ let section = null;
68
+ for (const v of code.verdicts) if (v.batch === id) section = lastVerdict(v.file) ?? section;
69
+ if (section === null || section.verdict === null) return { text: NO_VERDICT, valid: false };
70
+ const head = [section.verdict, section.when, section.mode].filter((p) => p !== undefined && p !== "").join(" ");
71
+ const counts = severityCounts(section);
72
+ if (section.verdict === "VALID") {
73
+ return { text: counts.Minor > 0 ? `${head} (${counts.Minor} Minor)` : head, valid: true };
74
+ }
75
+ const gaps = [
76
+ counts.Blocking > 0 ? `${counts.Blocking} Blocking` : "",
77
+ counts.Major > 0 ? `${counts.Major} Major` : "",
78
+ ].filter((p) => p !== "");
79
+ return { text: gaps.length > 0 ? `${head}: ${gaps.join(", ")}` : head, valid: false };
80
+ }
81
+
82
+ function runningText(code: DevCode, id: string): string | null {
83
+ const state = code.state?.state;
84
+ if (!state || !state.open.includes(id)) return null;
85
+ const last = [...state.entries].reverse().find((e) => e.batch === id);
86
+ return last ? `running (${last.event} ${last.date} ${last.time})` : "running";
87
+ }
88
+
89
+ /** The batch lines (all of them) and the consistency warnings they raise. */
90
+ function batchLines(code: DevCode): { ids: string[]; lines: string[]; warnings: string[] } {
91
+ const planBatches = code.plan?.plan.batches ?? [];
92
+ const ids = [...new Set([
93
+ ...planBatches.map((b) => b.id), ...code.sheets.map((s) => s.batch), ...code.verdicts.map((v) => v.batch),
94
+ ])].filter((id) => id !== "").sort(compareBatchIds);
95
+ const lines: string[] = [];
96
+ const warnings: string[] = [];
97
+ for (const id of ids) {
98
+ const batch = planBatches.find((b) => b.id === id);
99
+ const sheet = code.sheets.find((s) => s.batch === id);
100
+ const name = cut(batch?.name ?? sheet?.sheet.name ?? "", MAX_NAME_CHARS);
101
+ const parts = [name === "" ? id : `${id} ${name}`, stateText(batch)];
102
+ if (batch) parts.push(`boxes ${batch.steps.filter((s) => s.done).length}/${batch.steps.length}`);
103
+ if (sheet) {
104
+ const p = sheetProgress(sheet.sheet);
105
+ const n = p.behaviourSteps;
106
+ parts.push(`sheet RED ${p.red}/${n} GREEN ${p.green}/${n} COST ${p.cost}/${n}`);
107
+ if (batch?.state.kind === "done" && p.complete < n) {
108
+ warnings.push(sheetOpenTicks(id, p.red, n));
109
+ }
110
+ } else {
111
+ parts.push(NO_SHEET);
112
+ }
113
+ const verdict = verdictText(code, id);
114
+ parts.push(verdict.text);
115
+ if (verdict.valid && batch?.state.kind === "open") warnings.push(validButOpen(id));
116
+ const running = runningText(code, id);
117
+ if (running !== null) parts.push(running);
118
+ lines.push(cut(parts.join(" — "), MAX_LINE_CHARS));
119
+ }
120
+ if (code.plan) {
121
+ const planned = new Set(planBatches.map((b) => b.id));
122
+ for (const f of [...code.sheets, ...code.verdicts]) {
123
+ if (!planned.has(f.batch)) warnings.push(noBatchLine(f.name));
124
+ }
125
+ }
126
+ return { ids, lines, warnings };
127
+ }
128
+
129
+ function codeLine(code: DevCode): string {
130
+ const what = code.spec !== null ? `spec ${code.spec}` : code.change !== null ? `change ${code.change}` : "no spec";
131
+ let plan = "no plan";
132
+ if (code.plan) {
133
+ const p = code.plan.plan;
134
+ const done = p.batches.filter((b) => b.state.kind === "done").length;
135
+ const feature = p.feature === undefined ? "" : ` "${p.feature}"`;
136
+ plan = planLine(code.plan.name, feature, p.batches.length, done);
137
+ }
138
+ return cut(`code: ${code.shown}/ — ${what} — ${plan}`, MAX_LINE_CHARS);
139
+ }
140
+
141
+ /** The lines of § 3.1; adds the consistency warnings to code.warnings. */
142
+ function renderDevStatus(ctx: DevContext, code: DevCode): string[] {
143
+ const batches = batchLines(code);
144
+ for (const w of batches.warnings) if (!code.warnings.includes(w)) code.warnings.push(w);
145
+ const warnings = [...ctx.warnings, ...code.warnings];
146
+ const head = [...contextLines(ctx), codeLine(code)];
147
+
148
+ const build = (maxBatches: number, maxWarnings: number): string[] => {
149
+ const out = [...head, ...batches.lines.slice(0, maxBatches)];
150
+ const hidden = batches.ids.slice(maxBatches);
151
+ if (hidden.length > 0) out.push(moreBatches(hidden.length, hidden[0], hidden[hidden.length - 1]));
152
+ return [...out, ...warningLines(warnings, maxWarnings)];
153
+ };
154
+ const full = build(MAX_BATCH_LINES, MAX_WARNING_LINES);
155
+ return full.join("\n").length <= TEXT_BUDGET ? full : build(SHRUNK_BATCH_LINES, SHRUNK_WARNING_LINES);
156
+ }
157
+
158
+ function plural(n: number, word: string): string {
159
+ return `${n} ${word}${n === 1 ? "" : "s"}`;
160
+ }
161
+
162
+ function codeEntry(c: CodeSummary): string {
163
+ const what = [
164
+ c.spec ? "spec" : "", c.change ? "change" : "", c.plan ? "plan" : "",
165
+ c.sheets > 0 ? plural(c.sheets, "sheet") : "", c.verdicts > 0 ? plural(c.verdicts, "verdict") : "",
166
+ ].filter((p) => p !== "");
167
+ return cut(`${c.code} — ${what.join(", ")}`, MAX_CODE_ENTRY_CHARS);
168
+ }
169
+
170
+ /** The codes line of § 3.2: at most MAX_CODES_LISTED entries, fewer when the line would pass MAX_LINE_CHARS. */
171
+ function codesLine(codes: readonly CodeSummary[]): string {
172
+ const entries = codes.slice(0, MAX_CODES_LISTED).map(codeEntry);
173
+ const line = (k: number): string => {
174
+ const shown = entries.slice(0, k);
175
+ if (codes.length > k) shown.push(`… ${codes.length - k} more`);
176
+ return `codes (${codes.length}): ${shown.join(" · ")}`;
177
+ };
178
+ let k = entries.length;
179
+ while (k > 1 && line(k).length > MAX_LINE_CHARS) k--;
180
+ return cut(line(k), MAX_LINE_CHARS);
181
+ }
182
+
183
+ /** The lines of § 3.2; `notProbed` counts the folders the probe cap left out. */
184
+ function renderCodeList(ctx: DevContext, codes: readonly CodeSummary[], notProbed = 0): string[] {
185
+ const lines = contextLines(ctx);
186
+ if (codes.length === 0 && notProbed === 0) {
187
+ lines.push(noCodeUnder(ctx.work.folder));
188
+ } else {
189
+ if (codes.length > 0) lines.push(codesLine(codes));
190
+ if (notProbed > 0) lines.push(moreFoldersNotProbed(notProbed));
191
+ }
192
+ return [...lines, ...warningLines(ctx.warnings, MAX_WARNING_LINES)];
193
+ }
194
+
195
+ export async function runDevStatus(tokens: readonly string[], deps: DevStatusDeps): Promise<CommandView> {
196
+ if (tokens.length > 1) return { text: DEV_STATUS_USAGE };
197
+ const ctx = await loadDevContext(deps);
198
+ const work = ctx.work;
199
+ const code = tokens[0];
200
+ if (code !== undefined && !isCode(code)) {
201
+ return refusal(ctx, notAStatusCode(code));
202
+ }
203
+ const mainWorktree = workFolderInMainWorktree(work.folder);
204
+ if (work.outcome === "main-worktree") return refusal(ctx, mainWorktree);
205
+
206
+ if (code === undefined) {
207
+ let probe: { codes: CodeSummary[]; notProbed: number } = { codes: [], notProbed: 0 };
208
+ if (work.exists) {
209
+ try {
210
+ probe = await probeDevCodes(deps, work);
211
+ } catch (e) {
212
+ return refusal(ctx, devStatusCannotList(work.folder, messageOf(e).split("\n")[0]));
213
+ }
214
+ }
215
+ return { lines: renderCodeList(ctx, probe.codes, probe.notProbed) };
216
+ }
217
+
218
+ const lookup = await loadDevCode(deps, work, code);
219
+ if (lookup.found !== null) return { lines: renderDevStatus(ctx, lookup.found) };
220
+ if (lookup.reason === "unreachable") return refusal(ctx, mainWorktree);
221
+ if (lookup.reason === "empty") {
222
+ return refusal(ctx, holdsNoDevFile(work.folder, code));
223
+ }
224
+ const here = lookup.codes.length > 0 ? codesHere(lookup.codes.join(", ")) : NO_CODE_HERE;
225
+ return refusal(ctx, noFolder(work.folder, code, here));
226
+ }
227
+
228
+ // /dev-learn: the arguments, and the two decisions (--accept, --refuse). Proposing and
229
+ // listing read every verdict file, so they run in crews/dev-learn; a decision is a few
230
+ // reads and one or two writes, answered by the command itself through
231
+ // shared/application/dev/learn-decision.ts (re-exported here). Nothing there edits the
232
+ // file a proposal names: --accept prints the change to make.
233
+ export type DevLearnArgs =
234
+ | { kind: "propose"; axis: string | null }
235
+ | { kind: "list"; axis: string | null }
236
+ | { kind: "accept"; ids: string[] }
237
+ | { kind: "refuse"; target: string };
238
+
239
+ const MAX_AXIS_CHARS = 40;
240
+ const MAX_REFUSED_CHARS = 200;
241
+ const ALONE = ACCEPT_REFUSE_ALONE;
242
+
243
+ type DevLearnParse = { ok: true; args: DevLearnArgs } | { ok: false; text: string };
244
+
245
+ function parseAcceptIds(rest: readonly string[]): DevLearnParse {
246
+ const ids: string[] = [];
247
+ for (const tok of rest) {
248
+ if (tok === "--refuse" || tok === "--accept" || tok === "--list") return { ok: false, text: ALONE };
249
+ for (const piece of tok.split(",")) {
250
+ if (piece === "") continue;
251
+ const id = piece.toLowerCase();
252
+ if (!PROPOSAL_ID.test(id)) {
253
+ return { ok: false, text: notAProposalId(piece) };
254
+ }
255
+ ids.push(id);
256
+ }
257
+ }
258
+ if (ids.length === 0) return { ok: false, text: ACCEPT_NEEDS_ID };
259
+ return { ok: true, args: { kind: "accept", ids } };
260
+ }
261
+
262
+ function parseRefuseTarget(rest: readonly string[]): DevLearnParse {
263
+ if (rest.includes("--accept") || rest.includes("--refuse") || rest.includes("--list")) return { ok: false, text: ALONE };
264
+ const joined = rest.join(" ").trim();
265
+ // An id is read as one whatever its case, as --accept reads it; the motif's words keep theirs.
266
+ const target = PROPOSAL_ID.test(joined.toLowerCase()) ? joined.toLowerCase() : joined;
267
+ if (target === "") return { ok: false, text: REFUSE_NEEDS_TARGET };
268
+ if (Array.from(target).length > MAX_REFUSED_CHARS) return { ok: false, text: REFUSED_MOTIF_TOO_LONG };
269
+ return { ok: true, args: { kind: "refuse", target } };
270
+ }
271
+
272
+ /** `--accept` and `--refuse` take the rest of the line; `--list` is a flag; one other word is the axis. */
273
+ export function parseDevLearnArgs(tokens: readonly string[]): DevLearnParse {
274
+ let axis: string | null = null;
275
+ let list = false;
276
+ for (const [i, tok] of tokens.entries()) {
277
+ if (tok === "--accept" || tok === "--refuse") {
278
+ if (axis !== null || list) return { ok: false, text: ALONE };
279
+ const rest = tokens.slice(i + 1);
280
+ return tok === "--accept" ? parseAcceptIds(rest) : parseRefuseTarget(rest);
281
+ }
282
+ if (tok === "--list") {
283
+ list = true;
284
+ } else if (tok.startsWith("--")) {
285
+ return { ok: false, text: learnUnknownOption(tok) };
286
+ } else if (axis !== null) {
287
+ return { ok: false, text: oneAxisAtMost(axis, tok) };
288
+ } else if (tok.includes("|") || /[\r\n]/.test(tok) || Array.from(tok).length > MAX_AXIS_CHARS) {
289
+ return { ok: false, text: notAnAxis(tok) };
290
+ } else {
291
+ axis = tok;
292
+ }
293
+ }
294
+ return { ok: true, args: list ? { kind: "list", axis } : { kind: "propose", axis } };
295
+ }
296
+
297
+ // files and the review run in crews/dev-plan, which runs the same gate again.
298
+ export interface DevPlanArgs { source: string | null; replace: boolean }
299
+ export type DevPlanGateDeps = DevContextDeps;
300
+
301
+ /** A spec or change brief named by its path: ends .md, with no ".." segment (plan-source checks the name). */
302
+ function isSourcePath(token: string): boolean {
303
+ return token.endsWith(".md") && !token.split("/").includes("..");
304
+ }
305
+
306
+ /** At most one source (a code or a .md path) and the flag --replace, in any order. */
307
+ export function parseDevPlanArgs(tokens: readonly string[]): { ok: true; args: DevPlanArgs } | { ok: false; text: string } {
308
+ let source: string | null = null;
309
+ let replace = false;
310
+ for (const tok of tokens) {
311
+ if (tok === "--replace") {
312
+ if (replace) return { ok: false, text: REPLACE_ONCE };
313
+ replace = true;
314
+ } else if (tok.startsWith("--")) {
315
+ return { ok: false, text: planUnknownOption(tok) };
316
+ } else if (isCode(tok) || isSourcePath(tok)) {
317
+ if (source !== null) return { ok: false, text: oneSourceAtMost(source, tok) };
318
+ source = tok;
319
+ } else {
320
+ return { ok: false, text: notACodeNorSource(tok) };
321
+ }
322
+ }
323
+ return { ok: true, args: { source, replace } };
324
+ }
325
+
326
+ /** The Blocking gate, in the handler: null to launch the crew, else the message to print. */
327
+ export async function devPlanGate(args: DevPlanArgs, deps: DevPlanGateDeps): Promise<string | null> {
328
+ try {
329
+ const ctx = await loadDevContext(deps);
330
+ const resolution = await resolvePlanSource(deps.files, ctx.work, args.source);
331
+ if (!resolution.ok) return resolution.text;
332
+ const source = resolution.source;
333
+ const read = await readPlanSource(deps.files, source);
334
+ if (!read.ok) return read.text;
335
+ const rows = read.parsed.blocking;
336
+ return rows.length === 0 ? null : blockingStop(source.sourceShown, source.kind, source.code, rows);
337
+ } catch {
338
+ // The crew runs the same checks and reports what went wrong; the handler never fails on its own gate.
339
+ return null;
340
+ }
341
+ }
@@ -0,0 +1,7 @@
1
+ // The lines of the audit's answer the batch's chain reads (ADR 0026): the dev-verify crew writes them, chainStep
2
+ // (dev-implement.ts) parses them to launch the close.
3
+
4
+ /** The audit's VALID verdict, at the start of a line: the batch. */
5
+ export const VALID_LINE = /^→ Batch (F\d+) VALID\./m;
6
+ /** The verdict file the audit wrote: its folder, its code and its batch. */
7
+ export const WRITTEN_LINE = /^written: (\S+)\/([A-Za-z0-9][A-Za-z0-9._-]*)-VERIFY-(F\d+)\.md\b/m;