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,483 @@
1
+ // /dev-plan's use case: checks the inputs and the checkout, resolves the spec or change
2
+ // brief and stops on a Blocking open question before anything else is read, refuses to
3
+ // write over a plan unless asked and never over one whose work has started, inventories
4
+ // the code by the index, asks the model for the plan as JSON (once more on a refused
5
+ // answer), renders and self-checks the plan and its sheets, writes them with plan.json,
6
+ // then has the read-only reviewer question the plan once and writes its rows into the
7
+ // files. The model writes no file; nothing is written outside the code's folder, and
8
+ // nothing under .claude/.
9
+ import type { AnchorIndex, CodeIndex, Files, Llm, Logger, Shell } from "../../../shared/application/ports.ts";
10
+ import type { ActRoute } from "../../../shared/application/agents/route-agent.ts";
11
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
12
+ import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
13
+ import { GIT_TOPLEVEL } from "../../../shared/application/dev/resolve-work-folder.ts";
14
+ import { readPlanSource, resolvePlanSource } from "../../../shared/application/dev/plan-source.ts";
15
+ import type { ResolvedSource } from "../../../shared/application/dev/plan-source.ts";
16
+ import { runSubAgent } from "../../../shared/application/agents/run-sub-agent.ts";
17
+ import { PhaseTimer } from "../../../shared/application/dev/phase-timer.ts";
18
+ import { classifyArtefact, compareBatchIds } from "../../../shared/domain/dev/artefacts.ts";
19
+ import { blockingStop } from "../../../shared/domain/dev/spec-format.ts";
20
+ import type { PlanSource } from "../../../shared/domain/dev/spec-format.ts";
21
+ import { parseBatchSheet, parseGlobalPlan } from "../../../shared/domain/dev/plan-format.ts";
22
+ import { planSelfCheck } from "../../../shared/domain/dev/plan-checks.ts";
23
+ import { REVIEWER_CHARTER } from "../../../shared/domain/dev/reviewer-charter.ts";
24
+ import { REVIEW_ANSWER_SCHEMA, reviewChecks } from "../../../shared/domain/dev/review-answer.ts";
25
+ import type { ReviewAnswer } from "../../../shared/domain/dev/review-answer.ts";
26
+ import { reviewSystem } from "../../../shared/domain/dev/prompts.ts";
27
+ import { buildReviewAnswerPrompt, buildReviewBrief } from "../../../shared/domain/dev/review-brief.ts";
28
+ import { PLAN_ANSWER_SCHEMA, checkPlanAnswer } from "../domain/plan-answer.ts";
29
+ import type { PlanAnswer, PlanCheckContext } from "../domain/plan-answer.ts";
30
+ import { INVENTORY_CAPS, renderInventory } from "../domain/inventory-model.ts";
31
+ import type { Inventory } from "../domain/inventory-model.ts";
32
+ import { renderPlan, repoLines } from "../domain/plan-render.ts";
33
+ import type { RenderInput, RenderedPlan } from "../domain/plan-render.ts";
34
+ import { MAX_PLAN_PROMPT_CHARS, SOURCE_CHARS, buildPlanPrompt } from "./plan-prompt-fit.ts";
35
+ import type { PlanPromptInput } from "./plan-prompt-fit.ts";
36
+ import { buildInventory } from "./inventory.ts";
37
+ import { noPrecedents, precedentsLine, recallQuery } from "../../../shared/application/dev/step-precedents.ts";
38
+ import type { StepPrecedents } from "../../../shared/application/dev/step-precedents.ts";
39
+ import { checkAnchorPaths, repairAnchorKinds } from "./anchor-paths.ts";
40
+ import type { AnchorListings } from "./anchor-paths.ts";
41
+ import { BAD_INPUT_REPLACE, BAD_INPUT_SOURCE, BOTH_LINES, COMMANDS_LINE, END_LINE, REFUSED_TWICE, REVIEWED_FAILS_SELF_CHECK, ROWS_NOT_WRITTEN, SETTLE_CHANGE, SETTLE_SPEC, answerThenReplan, batchIsDone, planCannotBeReadNothingReplaced, planFileNotWritten, everyBatch, fewerBatches, inventoryFromTitles, namesNoTraceableId, noRoomForInventory, notInPack, planBlocked, planExists, planWritten, recordsWorkDone, planRendererDefect, reviewHead, reviewNotRunWithCause, planRunFromCheckout, stepIsTicked, tddLineTicked, planTitleNamesNoKind, titleReadsDone, unreviewed } from "./messages.ts";
42
+ import { PERMISSION_GATE_OFF as GATE_OFF } from "../../../shared/application/dev/messages.ts";
43
+ import { answerAskedAgain, answerDidNotParse } from "../../../shared/application/agents/messages.ts";
44
+ import { errorText } from "../../../shared/domain/error-text.ts";
45
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
46
+
47
+ export interface DevPlanInputs { source?: unknown; replace?: unknown } // source: the token, null for none
48
+ export interface DevPlanDeps {
49
+ files: Files; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">;
50
+ index: CodeIndex; anchors: AnchorIndex; llm: Pick<Llm, "extract" | "act" | "permissionGateEnabled">;
51
+ log: Logger; clock: () => Date;
52
+ /** The shared memory's code-triggered recall (T2); absent, nothing is recalled. */
53
+ precedents?: StepPrecedents;
54
+ /** The route of the plan reviewer's act to a cheaper or stronger profile (shared/application/agents/route-agent.ts actRoute);
55
+ * absent, the act runs on the crew's profile. */
56
+ route?: ActRoute;
57
+ }
58
+ export const PLAN_JSON = "plan.json";
59
+
60
+ const MAX_SOURCE_TOKEN = 300;
61
+ const MAX_WARNINGS = 5;
62
+ const MAX_PROBLEM_LINES = 12;
63
+ const LIST_CAP = 1000;
64
+ const MIN_INVENTORY_CHARS = 2_000;
65
+ /** Room kept for the problems of a re-ask when the inventory is sized to the prompt. */
66
+ const REASK_RESERVE = 4_000;
67
+
68
+ const firstLine = (e: unknown): string => (e instanceof Error ? e.message : String(e)).split("\n")[0];
69
+ const pad2 = (n: number): string => String(n).padStart(2, "0");
70
+ const dateOf = (d: Date): string => `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
71
+ const plural = (n: number, one: string, many: string): string => `${n} ${n === 1 ? one : many}`;
72
+
73
+ class WriteFailure extends Error {
74
+ readonly shown: string;
75
+ constructor(shown: string, cause: unknown) {
76
+ super(firstLine(cause));
77
+ this.shown = shown;
78
+ }
79
+ }
80
+
81
+ interface Place { folderVfs: string; folderShown: string; shown: (name: string) => string; vfs: (name: string) => string }
82
+
83
+ function placeOf(source: ResolvedSource): Place {
84
+ const folderVfs = source.folderShown === "" ? WORKSPACE : `${WORKSPACE}/${source.folderShown}`;
85
+ return {
86
+ folderVfs, folderShown: source.folderShown,
87
+ shown: (name) => (source.folderShown === "" ? name : `${source.folderShown}/${name}`),
88
+ vfs: (name) => `${folderVfs}/${name}`,
89
+ };
90
+ }
91
+
92
+ function checkInputs(input: DevPlanInputs): { source: string | null; replace: boolean } | string {
93
+ const { source, replace } = input;
94
+ if (source !== undefined && source !== null && (typeof source !== "string" || source.length > MAX_SOURCE_TOKEN)) {
95
+ return BAD_INPUT_SOURCE;
96
+ }
97
+ if (replace !== undefined && typeof replace !== "boolean") return BAD_INPUT_REPLACE;
98
+ const token = typeof source === "string" && source.trim() !== "" ? source.trim() : null;
99
+ return { source: token, replace: replace === true };
100
+ }
101
+
102
+ async function toplevelRefusal(shell: Pick<Shell, "run">): Promise<string | null> {
103
+ let top: string;
104
+ try {
105
+ const r = await shell.run(GIT_TOPLEVEL);
106
+ top = r.exitCode === 0 ? r.stdout.trim() : "";
107
+ } catch {
108
+ top = "";
109
+ }
110
+ if (top === WORKSPACE) return null;
111
+ return planRunFromCheckout(WORKSPACE, top);
112
+ }
113
+
114
+ function warningLines(warnings: readonly string[]): string[] {
115
+ const lines = warnings.slice(0, MAX_WARNINGS).map((w) => `warning: ${w}`);
116
+ if (warnings.length > MAX_WARNINGS) lines.push(` … ${warnings.length - MAX_WARNINGS} more warnings`);
117
+ return lines;
118
+ }
119
+
120
+ function problemLines(problems: readonly string[]): string[] {
121
+ const lines = problems.slice(0, MAX_PROBLEM_LINES).map((p) => ` ${p}`);
122
+ if (problems.length > MAX_PROBLEM_LINES) lines.push(` … ${problems.length - MAX_PROBLEM_LINES} more`);
123
+ return lines;
124
+ }
125
+
126
+ // ---- an existing plan (§ 2.9) ------------------------------------------------------
127
+
128
+ type Existing = { ok: true; sheets: string[] } | { ok: false; text: string };
129
+
130
+ /** What a plan or sheet records as done: a done batch, a ticked box, a ticked TDD line, a done title. */
131
+ function workDone(text: string, kind: "plan" | "sheet"): string | null {
132
+ if (kind === "plan") {
133
+ const plan = parseGlobalPlan(text);
134
+ const done = plan.batches.find((b) => b.state.kind === "done");
135
+ if (done) return batchIsDone(done.id);
136
+ for (const b of plan.batches) {
137
+ const box = b.steps.find((s) => s.done);
138
+ if (box) return stepIsTicked(box.number, b.id);
139
+ }
140
+ return null;
141
+ }
142
+ const sheet = parseBatchSheet(text);
143
+ if (sheet.doneDate !== undefined) return titleReadsDone(sheet.doneDate);
144
+ const ticked = sheet.steps.find((s) => s.tdd !== null && (s.tdd.red || s.tdd.green || s.tdd.cost));
145
+ if (ticked) return tddLineTicked(ticked.number);
146
+ return null;
147
+ }
148
+
149
+ async function existingPlan(files: Files, place: Place, source: ResolvedSource, replace: boolean): Promise<Existing> {
150
+ let names: string[];
151
+ try {
152
+ names = (await files.list(place.folderVfs, LIST_CAP)).map((n) => n.replace(/\/+$/, ""));
153
+ } catch {
154
+ names = [];
155
+ }
156
+ const own = names
157
+ .map((n) => classifyArtefact(n))
158
+ .filter((a) => a !== null && (a.kind === "plan" || a.kind === "sheet") && a.prefix === source.prefix);
159
+ if (own.length === 0) return { ok: true, sheets: [] };
160
+ const planName = `${source.prefix}-PLAN.md`;
161
+ if (!replace) {
162
+ return {
163
+ ok: false,
164
+ text: planExists(place.shown(planName), source.code),
165
+ };
166
+ }
167
+ const sheets: string[] = [];
168
+ for (const a of own) {
169
+ if (a === null) continue;
170
+ let text: string;
171
+ try {
172
+ text = await files.read(place.vfs(a.name));
173
+ } catch (e) {
174
+ return { ok: false, text: planCannotBeReadNothingReplaced(place.shown(a.name), firstLine(e)) };
175
+ }
176
+ const done = workDone(text, a.kind === "plan" ? "plan" : "sheet");
177
+ if (done !== null) {
178
+ return {
179
+ ok: false,
180
+ text: recordsWorkDone(place.shown(a.name), done),
181
+ };
182
+ }
183
+ if (a.kind === "sheet") sheets.push(a.name);
184
+ }
185
+ sheets.sort((x, y) => compareBatchIds(classifyArtefact(x)?.batch ?? x, classifyArtefact(y)?.batch ?? y));
186
+ return { ok: true, sheets };
187
+ }
188
+
189
+ // ---- the plan ----------------------------------------------------------------------
190
+
191
+ interface Planned { answer: PlanAnswer; rendered: RenderedPlan; repairs: string[] }
192
+
193
+ async function askPlan(
194
+ deps: DevPlanDeps, promptInput: PlanPromptInput, checkCtx: PlanCheckContext, render: (a: PlanAnswer) => RenderedPlan,
195
+ sourceIds: readonly string[], timer: PhaseTimer,
196
+ ): Promise<{ ok: true; planned: Planned } | { ok: false; problems: string[] }> {
197
+ let problems: string[] = [];
198
+ const listings: AnchorListings = new Map(); // one listing per folder for the run, not per attempt
199
+ for (let attempt = 1; attempt <= 2; attempt++) {
200
+ let value: unknown;
201
+ try {
202
+ value = await timer.time("draft", () => deps.llm.extract(buildPlanPrompt(promptInput, problems), PLAN_ANSWER_SCHEMA));
203
+ } catch (e) {
204
+ problems = [answerDidNotParse(errorText(e))];
205
+ deps.log.info(answerAskedAgain("dev-plan", problems));
206
+ continue;
207
+ }
208
+ const checked = checkPlanAnswer(value, checkCtx);
209
+ if (!checked.ok) {
210
+ problems = checked.problems;
211
+ deps.log.info(answerAskedAgain("dev-plan", problems));
212
+ continue;
213
+ }
214
+ const repairs = await repairAnchorKinds(deps.files, checked.value, listings);
215
+ const paths = await checkAnchorPaths(deps.files, checked.value, listings);
216
+ if (paths.length > 0) {
217
+ problems = paths;
218
+ deps.log.info(answerAskedAgain("dev-plan", problems));
219
+ continue;
220
+ }
221
+ const rendered = render(checked.value);
222
+ const self = planSelfCheck({ plan: rendered.plan, sheets: rendered.sheets, sourceIds });
223
+ if (!self.ok) {
224
+ deps.log.warn(planRendererDefect(self.problems[0]));
225
+ problems = self.problems;
226
+ continue;
227
+ }
228
+ return { ok: true, planned: { answer: checked.value, rendered, repairs } };
229
+ }
230
+ return { ok: false, problems };
231
+ }
232
+
233
+ function planJson(generated: Date, source: ResolvedSource, inventory: Inventory, answer: PlanAnswer, review: ReviewAnswer | null): string {
234
+ return `${JSON.stringify({
235
+ version: 1, generated: generated.toISOString(), source: source.sourceShown, prefix: source.prefix,
236
+ inventory, answer, review,
237
+ }, null, 2)}\n`;
238
+ }
239
+
240
+ async function writeOne(files: Files, place: Place, name: string, content: string): Promise<void> {
241
+ try {
242
+ await files.write(place.vfs(name), content);
243
+ } catch (e) {
244
+ throw new WriteFailure(place.shown(name), e);
245
+ }
246
+ }
247
+
248
+ // ---- the end message (§ 3.3) -------------------------------------------------------
249
+
250
+ function batchLines(rendered: RenderedPlan, answer: PlanAnswer): string[] {
251
+ const summary = parseGlobalPlan(rendered.plan.text).summary;
252
+ return answer.batches.map((b, k) => {
253
+ const row = summary[k];
254
+ const deps = row === undefined || row.dependsOn.length === 0 ? "—" : row.dependsOn.join(", ");
255
+ return ` F${k + 1} — ${b.name} — ${plural(b.steps.length, "step", "steps")} — ${row?.ids ?? "—"} — depends on ${deps}`;
256
+ });
257
+ }
258
+
259
+ /** The next step: the first batch, and with more than one /dev-batches, which runs them all in their order (L-7). */
260
+ function nextCommand(answer: PlanAnswer, planShown: string, code: string): string {
261
+ const first = `/dev-batches ${planShown} F1`;
262
+ if (answer.batches.length < 2) return END_LINE.replace("{command}", first);
263
+ return END_LINE.replace("{command}", everyBatch(first, code));
264
+ }
265
+
266
+ function reviewLines(review: ReviewAnswer): string[] {
267
+ if (review.rows.length === 0) return [`review: ${review.verdict}`];
268
+ const blocking = review.rows.filter((r) => r.severity === "Blocking").length;
269
+ const majors = review.rows.length - blocking;
270
+ const places = new Set<string>();
271
+ if (blocking > 0) places.add("Blocking: § 4");
272
+ for (const r of review.rows) {
273
+ if (r.severity !== "Major") continue;
274
+ places.add(r.target === "plan" ? "plan: § 4" : `${r.target}: under ## Decisions`);
275
+ }
276
+ return [
277
+ reviewHead(review.verdict, blocking, majors, [...places].join("; ")),
278
+ ...review.rows.map((r) => ` ${r.severity} ${r.target} — ${r.question} (${r.evidence})`),
279
+ ];
280
+ }
281
+
282
+ function absentWarning(absent: readonly string[], planName: string, code: string): string[] {
283
+ if (absent.length === 0) return [];
284
+ const where = absent.some((k) => k.startsWith("layout.")) ? BOTH_LINES : COMMANDS_LINE;
285
+ return [notInPack(absent.join(", "), where, planName, code)];
286
+ }
287
+
288
+ // ---- the run -----------------------------------------------------------------------
289
+
290
+ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promise<string> {
291
+ // 1. Inputs.
292
+ const checked = checkInputs(input);
293
+ if (typeof checked === "string") return checked;
294
+ // 2. Checkout.
295
+ const top = await toplevelRefusal(deps.shell);
296
+ if (top !== null) return top;
297
+ // 3. Context.
298
+ const ctx = await loadDevContext(deps);
299
+ // 4. Source.
300
+ const resolution = await resolvePlanSource(deps.files, ctx.work, checked.source);
301
+ if (!resolution.ok) return resolution.text;
302
+ const source = resolution.source;
303
+ const read = await readPlanSource(deps.files, source);
304
+ if (!read.ok) return read.text;
305
+ const parsed: PlanSource = read.parsed;
306
+ // 5. Blocking gate: nothing else is read.
307
+ if (parsed.blocking.length > 0) return blockingStop(source.sourceShown, source.kind, source.code, parsed.blocking);
308
+ // 6. Ids.
309
+ if (parsed.ids.length === 0) return namesNoTraceableId(source.sourceShown);
310
+ if (source.kind === "change" && parsed.changeKind === undefined) {
311
+ return planTitleNamesNoKind(source.sourceShown);
312
+ }
313
+ // 7. Existing plan.
314
+ const place = placeOf(source);
315
+ const existing = await existingPlan(deps.files, place, source, checked.replace);
316
+ if (!existing.ok) return existing.text;
317
+
318
+ // 8. Inventory.
319
+ const timer = new PhaseTimer(deps.clock);
320
+ const pack = ctx.pack;
321
+ const built = await timer.time("inventory", () => buildInventory(deps.index, deps.anchors, {
322
+ titles: parsed.ids.map((i) => ({ id: i.id, title: i.title })),
323
+ workShown: ctx.work.folder,
324
+ layout: pack?.pack.layout ?? null,
325
+ buildOutputs: pack?.pack.layout.buildOutputs ?? [],
326
+ }, deps.log));
327
+ if (!built.ok) return built.text;
328
+ const inventory = built.inventory;
329
+
330
+ // 9. Prompt. T2: the decisions and code structures of earlier work on these use cases, after the inventory.
331
+ const recalled = await (deps.precedents ?? noPrecedents)("T2", recallQuery([source.code, ...parsed.ids.map((i) => i.title)]));
332
+ const repo = repoLines(pack?.pack ?? null, pack?.shown ?? null);
333
+ const unpinned = parsed.mustNotChange.filter((r) => r.pinnedBy === null).map((r, i) => ({ key: `U${i + 1}`, behaviour: r.behaviour }));
334
+ const pinned = parsed.mustNotChange.flatMap((r) => (r.pinnedBy === null ? [] : [r.pinnedBy]));
335
+ let shownInventory = renderInventory(inventory, INVENTORY_CAPS.promptChars);
336
+ const promptInput: PlanPromptInput = {
337
+ sourceShown: source.sourceShown, kind: source.kind,
338
+ ...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
339
+ sourceText: read.text.slice(0, SOURCE_CHARS),
340
+ ids: parsed.ids, pinned, unpinned,
341
+ repoCommands: repo.commands, repoLayout: repo.layout,
342
+ inventory: shownInventory.text, workShown: ctx.work.folder, precedents: recalled.block,
343
+ };
344
+ const fixed = buildPlanPrompt({ ...promptInput, sourceText: "", inventory: "" }, []).length;
345
+ const room = MAX_PLAN_PROMPT_CHARS - fixed - REASK_RESERVE;
346
+ // Below the floor the prompt's cut would drop inventory lines the plan's check still counts as shown: refused.
347
+ if (room < MIN_INVENTORY_CHARS) {
348
+ return noRoomForInventory(fixed, MAX_PLAN_PROMPT_CHARS);
349
+ }
350
+ if (shownInventory.text.length > room) {
351
+ shownInventory = renderInventory(inventory, room);
352
+ promptInput.inventory = shownInventory.text;
353
+ }
354
+
355
+ // 10. Plan.
356
+ const date = dateOf(deps.clock());
357
+ const sourceIds = parsed.ids.map((i) => i.id);
358
+ const byRef = new Map(inventory.entries.map((e) => [e.ref, e]));
359
+ const renderInput = (answer: PlanAnswer, review: ReviewAnswer | null): RenderInput => ({
360
+ prefix: source.prefix, sourceShown: source.sourceShown, kind: source.kind,
361
+ ...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
362
+ sourceIds: parsed.ids, repo, inventory: byRef, answer, review, date,
363
+ });
364
+ const checkCtx: PlanCheckContext = {
365
+ sourceIds, shownRefs: shownInventory.shown, refPaths: new Map(inventory.entries.map((e) => [e.ref, e.path])),
366
+ refNames: new Map(inventory.entries.map((e) => [e.ref, e.name])),
367
+ kind: source.kind, ...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
368
+ pinned, unpinned: unpinned.map((u) => u.key), workFolder: ctx.work.folder,
369
+ };
370
+ const asked = await askPlan(deps, promptInput, checkCtx, (a) => renderPlan(renderInput(a, null)), sourceIds, timer);
371
+ if (!asked.ok) {
372
+ return [REFUSED_TWICE, ...problemLines(asked.problems)].join("\n");
373
+ }
374
+ const { answer } = asked.planned;
375
+ let rendered = asked.planned.rendered;
376
+
377
+ // 10b. A replace with fewer batches would leave stale sheets: refused before any write.
378
+ if (existing.sheets.length > answer.batches.length) {
379
+ const extra = existing.sheets.slice(answer.batches.length).map((n) => place.shown(n));
380
+ return fewerBatches(answer.batches.length, existing.sheets.length, extra.join(", "), source.code);
381
+ }
382
+
383
+ // 11. Write.
384
+ const generated = deps.clock();
385
+ try {
386
+ await timer.time("write", async () => {
387
+ await writeOne(deps.files, place, rendered.plan.name, rendered.plan.text);
388
+ for (const s of rendered.sheets) await writeOne(deps.files, place, s.name, s.text);
389
+ await writeOne(deps.files, place, PLAN_JSON, planJson(generated, source, inventory, answer, null));
390
+ }, "pass");
391
+ } catch (e) {
392
+ const shown = e instanceof WriteFailure ? e.shown : "a file";
393
+ return planFileNotWritten(shown, firstLine(e));
394
+ }
395
+ const planShown = place.shown(rendered.plan.name);
396
+ deps.log.info(planWritten(planShown, rendered.sheets.length));
397
+
398
+ // 12. Review.
399
+ const warnings = [...ctx.warnings, ...inventory.warnings, ...absentWarning(repo.absent, rendered.plan.name, source.code)];
400
+ warnings.push(...asked.planned.repairs);
401
+ if (deps.llm.permissionGateEnabled() === false) warnings.push(GATE_OFF);
402
+ const targets = ["plan", ...answer.batches.map((_, k) => `F${k + 1}`)];
403
+ const outcome = await timer.time("review", () => runSubAgent(timer.timedExtract(deps.llm, "review extract"), {
404
+ charter: REVIEWER_CHARTER,
405
+ system: reviewSystem("plan"),
406
+ brief: buildReviewBrief({
407
+ mode: "plan", folder: place.folderShown === "" ? "." : place.folderShown,
408
+ files: [planShown, ...rendered.sheets.map((s) => place.shown(s.name))],
409
+ source: source.sourceShown, inventory: shownInventory.text, targets,
410
+ }),
411
+ schema: REVIEW_ANSWER_SCHEMA,
412
+ answerPrompt: (reply, problems) => buildReviewAnswerPrompt(reply, problems, targets),
413
+ ...reviewChecks(targets),
414
+ }, deps.route, deps.log));
415
+
416
+ // 13. Review rows into the files; the review is never run again.
417
+ let review: ReviewAnswer | null = null;
418
+ let reviewText: string[];
419
+ if (!outcome.ok) {
420
+ reviewText = [reviewNotRunWithCause(outcome.reason, outcome.problems[0] ?? "no detail")];
421
+ } else {
422
+ const answered = outcome.value;
423
+ review = answered;
424
+ reviewText = reviewLines(answered);
425
+ try {
426
+ const stop = await timer.time("write", async (): Promise<string | null> => {
427
+ if (answered.rows.length > 0) {
428
+ const reviewed = renderPlan(renderInput(answer, answered));
429
+ const self = planSelfCheck({ plan: reviewed.plan, sheets: reviewed.sheets, sourceIds });
430
+ if (!self.ok) {
431
+ return [
432
+ REVIEWED_FAILS_SELF_CHECK,
433
+ ...problemLines(self.problems),
434
+ ROWS_NOT_WRITTEN,
435
+ ...answered.rows.map((r) => ` ${r.severity} ${r.target} — ${r.question} (${r.evidence})`),
436
+ ].join("\n");
437
+ }
438
+ if (reviewed.plan.text !== rendered.plan.text) await writeOne(deps.files, place, reviewed.plan.name, reviewed.plan.text);
439
+ for (const [k, s] of reviewed.sheets.entries()) {
440
+ if (s.text !== rendered.sheets[k].text) await writeOne(deps.files, place, s.name, s.text);
441
+ }
442
+ rendered = reviewed;
443
+ }
444
+ await writeOne(deps.files, place, PLAN_JSON, planJson(generated, source, inventory, answer, answered));
445
+ return null;
446
+ }, "pass");
447
+ if (stop !== null) return stop;
448
+ } catch (e) {
449
+ const shown = e instanceof WriteFailure ? e.shown : "a file";
450
+ return planFileNotWritten(shown, firstLine(e));
451
+ }
452
+ }
453
+
454
+ // 15. End message.
455
+ const ids = sourceIds.join(", ");
456
+ const lines = [
457
+ `dev-plan: ${planShown} — ${plural(answer.batches.length, "batch", "batches")}, ${plural(sourceIds.length, "id", "ids")} traced (${ids})`,
458
+ ...batchLines(rendered, answer),
459
+ `files: ${[planShown, ...rendered.sheets.map((s) => s.name), PLAN_JSON].join(", ")}`,
460
+ inventoryFromTitles(inventory.entries.length, inventory.titlesSearched, inventory.index, inventory.calls),
461
+ ...reviewText,
462
+ ...[precedentsLine([recalled])].filter((l) => l !== ""),
463
+ ...warningLines(warnings),
464
+ ];
465
+ const blocking = review?.rows.filter((r) => r.severity === "Blocking").length ?? 0;
466
+ if (blocking > 0) {
467
+ const settle = source.kind === "change" ? SETTLE_CHANGE : SETTLE_SPEC;
468
+ lines.push(
469
+ planBlocked(plural(blocking, "Blocking question", "Blocking questions"), planShown),
470
+ answerThenReplan(blocking === 1 ? "it" : "them", settle, source.code, source.kind === "change" ? " <its kind>" : ""),
471
+ );
472
+ } else if (!outcome.ok) {
473
+ lines.push(unreviewed(source.code));
474
+ } else {
475
+ lines.push(nextCommand(answer, planShown, source.code));
476
+ }
477
+ const timing = timer.line();
478
+ if (timing !== "") {
479
+ deps.log.info(timing);
480
+ lines.push(timing);
481
+ }
482
+ return lines.join("\n");
483
+ }
@@ -0,0 +1,112 @@
1
+ // @orkeon-script 1.0
2
+ /// <reference path="../.orkeon/orkeon.d.ts" />
3
+ //
4
+ // DevPlan crew (/dev-plan). Composition root: it builds the planner agent and wires application/run-dev-plan,
5
+ // which stops on a Blocking open question, inventories the code by the index, asks the model for the plan as
6
+ // JSON (once more on a refused answer), writes <CODE>-PLAN.md, one sheet per batch and plan.json, then has the
7
+ // read-only reviewer question the plan once. The reviewer's act runs in a background child, `dev-reviewer`
8
+ // (the reviewer's charter: read tools only, plan mode), which /tasks lists and stops while it runs, and repairs by a new run once it has ended
9
+ // (A-3, shared/application/agents/child-agent.ts).
10
+ //
11
+ // Input (globalThis.inputs): { source: string | null, replace?: boolean, hooks?: the /hooks registry,
12
+ // effort?: "low" | "medium" | "high" | "xhigh" | "max" | null, concurrency?: number, maxInstances?: number }
13
+ // Run standalone: bash scripts/run-crew.sh src/crews/dev-plan/crew.ork.ts --inputs '{"source":"prune"}'
14
+ //
15
+ // Budget: up to 59 index and batch_anchors calls by code, at most 40 folder listings for the anchors (one per folder for the run,
16
+ // both attempts sharing them), about 30 other file and git calls, two extract calls and one review of 20
17
+ // iterations (about 3 tool calls each): 59 + 40 + 30 + 2 + 60 = 191, so toolCalls 240 leaves a margin that 200
18
+ // did not. The reviewer runs as a child: the runtime gives it what the parent has left at its spawn
19
+ // (SpawnAgentScriptTool CreateChildBudget), so the 60 is its own estimate, not a cap.
20
+
21
+ import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infrastructure/globals.ts";
22
+ import {
23
+ orkeonActRoute, orkeonPrunedLlm,
24
+ orkeonAgent,
25
+ orkeonAnchorIndex,
26
+ orkeonClock,
27
+ orkeonCodeIndex,
28
+ orkeonConfigStore,
29
+ orkeonFiles,
30
+ orkeonMemoryToolPorts,
31
+ orkeonSessionIo,
32
+ orkeonSharedMemory,
33
+ orkeonShell,
34
+ } from "../../shared/infrastructure/orkeon/wiring.ts";
35
+ import { memoryReadTools, memoryRecallOn, memoryRecallTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
36
+ import { agentLlm } from "../../shared/infrastructure/orkeon/llm.ts";
37
+ import { memoryDirOf } from "../../shared/application/shared-memory/memory-settings.ts";
38
+ import { devToolCallbacks } from "../../shared/application/dev/tool-callbacks.ts";
39
+ import { childAgentBody, openChildAct } from "../../shared/infrastructure/orkeon/child-agents.ts";
40
+ import { charterCatalogue } from "../../shared/domain/agents/charter.ts";
41
+ import { instanceLimits } from "../../shared/domain/agents/instances.ts";
42
+ import { providerEffort } from "../../shared/domain/agent-policy/behavior-flags.ts";
43
+ import { REVIEWER_CHARTER } from "../../shared/domain/dev/reviewer-charter.ts";
44
+ import { reviewerCallbacks } from "../../shared/application/dev/spend.ts";
45
+ import { runDevPlan } from "./application/run-dev-plan.ts";
46
+ import { PLANNER_GOAL, PLAN_REVIEW_TASK } from "./application/messages.ts";
47
+ import { STEP_BUDGETS } from "../../shared/domain/dev/step-budget.ts";
48
+ import { stepPrecedents } from "../../shared/application/dev/step-precedents.ts";
49
+
50
+ const ports = {
51
+ shell: orkeonShell(), files: orkeonFiles(), config: orkeonConfigStore(), index: orkeonCodeIndex(), anchors: orkeonAnchorIndex(),
52
+ };
53
+ // memory_recall is attached unless a session rule denies every call of it (the command says so).
54
+ const memoryOn = memoryRecallOn(inputs());
55
+ const session = orkeonSessionIo();
56
+ const effort = providerEffort(inputs().effort);
57
+ const limits = instanceLimits(inputs());
58
+ // These callbacks, then the host's gate on the input they return (Orkeon #303): the step's rule sets again and the /hooks the command passed.
59
+ // memory_recall (the shared memory's precedents) declares `read`: named in readTools, as run_validation in dev-verify.
60
+ const callbacksFor = (ctx: any) => devToolCallbacks(
61
+ { step: "dev-plan", hooks: inputs().hooks, readTools: memoryReadTools(memoryOn) }, { shell: ports.shell, log: ctx.log, memoryDir: memoryDirOf(ports.config) },
62
+ );
63
+
64
+ /** The reviewer, added to the crew by its first act (a sequential crew would run an agent it holds from the start). */
65
+ const reviewer = () => {
66
+ const builder = orkeonAgent()
67
+ .name(REVIEWER_CHARTER.name)
68
+ .role(REVIEWER_CHARTER.role)
69
+ .goal(REVIEWER_CHARTER.goal)
70
+ .tools(charterCatalogue(REVIEWER_CHARTER))
71
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
72
+ .maxIterations(REVIEWER_CHARTER.maxIterations)
73
+ .body(childAgentBody((ctx: any) => reviewerCallbacks(callbacksFor(ctx)), (llm, ctx) => orkeonPrunedLlm(llm, ctx.log, ctx.tools)));
74
+ return effort === undefined ? builder : builder.effort(effort);
75
+ };
76
+
77
+ const planner = orkeonAgent()
78
+ .name("dev-planner")
79
+ .role("Technical planner")
80
+ .goal(PLANNER_GOAL)
81
+ // The catalogue is the reviewer's: read tools only, for the inline review on a host without background
82
+ // children. The plan itself is an extract call, which offers none.
83
+ .tools(charterCatalogue(REVIEWER_CHARTER))
84
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
85
+ .maxIterations(REVIEWER_CHARTER.maxIterations)
86
+ .body(async (_input: any, ctx: any) => {
87
+ const clock = orkeonClock();
88
+ const child = openChildAct(
89
+ agentLlm(ctx, callbacksFor(ctx), { effort }), ctx, crew, { state: session, clock, log: ctx.log, effort },
90
+ { crew: "dev-plan", step: "dev-plan" },
91
+ { agent: REVIEWER_CHARTER.name, charter: REVIEWER_CHARTER.name, task: PLAN_REVIEW_TASK, builder: reviewer },
92
+ );
93
+ try {
94
+ // T2: the shared memory's precedents in the planner's prompt, unless memory_recall is denied.
95
+ const precedents = stepPrecedents({ ...ports, memory: orkeonSharedMemory(), log: ctx.log }, { on: memoryOn });
96
+ return await runDevPlan(inputs(), { ...ports, llm: child.llm, log: ctx.log, clock, precedents, route: orkeonActRoute(ctx.log) });
97
+ } finally {
98
+ await child.close();
99
+ }
100
+ })
101
+ .build();
102
+
103
+ const crew = CrewBuilder()
104
+ .name("dev-plan")
105
+ .process("sequential")
106
+ .budget(STEP_BUDGETS["dev-plan"])
107
+ .concurrency(limits.concurrency)
108
+ .maxInstances(limits.maxInstances)
109
+ .withAgent(planner)
110
+ .build();
111
+
112
+ publishCrew(crew);