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,81 @@
1
+ // The messages of the change brief's step: the lines the person reads at the end of a run, its refusals and
2
+ // warnings, the facts code writes from the run, and the words of its crew (ADR 0026). The lines /dev-spec says the
3
+ // same way are imported from its messages.
4
+
5
+ // ── The crew ────────────────────────────────────────────────────────────
6
+
7
+ export const CHANGE_WRITER_GOAL =
8
+ "Write what is wrong or costly in code that exists, the evidence that shows it and what must survive, and settle its open questions with the person";
9
+ export const BRIEF_REVIEW_TASK = "review of the brief";
10
+
11
+ // ── The run ─────────────────────────────────────────────────────────────
12
+
13
+ export const DEV_CHANGE_NEXT = "→ Next step, once you have validated the brief: /dev-plan {code}";
14
+ export const FEATURE_LINE = "→ a feature, not a change: the spec SPEC-{code}.md follows";
15
+ export const invalidKind = (step: string): string => `${step}: invalid crew input: kind`;
16
+ export const specExists = (step: string, shown: string, code: string): string =>
17
+ `${step}: ${shown}/SPEC-${code}.md exists: a code has one source; revise it with /dev-spec ${code} (no kind), or pick another code`;
18
+ export const titleNamesNoKind = (step: string, shown: string): string =>
19
+ `${step}: ${shown}: the title names no kind (bug, refactor or perf); fix the title first`;
20
+ export const briefKeepsKind = (step: string, shown: string, fileKind: string, kind: string): string =>
21
+ `${step}: ${shown} is a ${fileKind} change: a brief keeps its kind; pick another code for a ${kind}`;
22
+ export const nameTheKind = (step: string, code: string): string =>
23
+ `${step}: name the kind: /dev-spec ${code} bug|refactor|perf [--run "<command>"] <origin>`;
24
+ export const runIsForBugOrPerf = (step: string): string =>
25
+ `${step}: --run is for a bug or a perf change; a refactor is pinned by its tests`;
26
+ export const newBriefNeedsOrigin = (step: string, code: string, kind: string): string =>
27
+ `${step}: a new brief needs its origin: /dev-spec ${code} ${kind} <#issue | path | text>`;
28
+ export const deniedNothingWritten = (step: string, denied: string): string => `${step}: ${denied}; nothing is written`;
29
+ export const reproNotWritten = (step: string, shown: string, why: string): string =>
30
+ `${step}: ${shown} could not be written (${why}); nothing else is written`;
31
+ export const briefRendererDefect = (step: string, first: string): string =>
32
+ `${step}: a checked answer rendered a brief that fails its self-check (a renderer defect): ${first}`;
33
+ export const briefRefusedTwice = (step: string): string => `${step}: the brief was refused twice; nothing is written.`;
34
+ export const newPromiseKept = (step: string, shown: string): string =>
35
+ `${step}: the request is a new promise, not a change of what exists; ${shown} is kept: a feature takes a code of its own (/dev-spec <code> <brief>)`;
36
+ export const unknownTest = (name: string): string => `'${name}' is no test the code index shows: its row reads unpinned`;
37
+ export const ROUTED_TO_SPEC = "the rewrite routed the brief to a spec";
38
+ export const evidenceLine = (command: string, seconds: number, shown: string): string =>
39
+ `evidence: \`${command}\` (${seconds} s), output in ${shown}`;
40
+ export const mustNotChangeLine = (rows: string, unpinned: number): string => `must not change: ${rows}, ${unpinned} unpinned`;
41
+ export const briefBlockedUnanswered = (step: string, shown: string): string =>
42
+ `${step}: BLOCKED — a question went unanswered; the open questions are in ${shown} § 8.`;
43
+ export const answerBriefQuestions = (code: string, kind: string): string =>
44
+ `→ Answer them: /dev-spec ${code} ${kind} in an interactive session, or edit the file; nothing was decided for you.`;
45
+ export const briefStillBlocking = (ids: string, code: string, kind: string): string =>
46
+ `→ ${ids} still Blocking: /dev-plan refuses the brief until settled: /dev-spec ${code} ${kind}, or edit the file.`;
47
+
48
+ // ── The evidence ────────────────────────────────────────────────────────
49
+
50
+ export const issueViewFailed = (step: string, command: string, why: string): string =>
51
+ `${step}: ${command} failed (${why}): sign gh in (gh auth login), or give the issue's text or a file instead`;
52
+ export const issuePrintedNoJson = (step: string, command: string): string =>
53
+ `${step}: ${command} printed no JSON: give the issue's text or a file instead`;
54
+ export const SHELL_OPERATOR_AFTER_CLI = "a shell operator after the CLI";
55
+ export const GLOB_OR_EXPANSION = "a glob or an expansion after the CLI";
56
+ export const PATH_OUT_OF_CHECKOUT = "a path out of the checkout";
57
+ export const runMayNotRun = (step: string, given: string, problem: string): string =>
58
+ `${step}: --run "${given}" may not run (${problem}): give a narrow test command of .orkeon/repo.yaml or the CLI with plain words`;
59
+ export const REPRODUCES_THE_BUG = "reproduces the bug";
60
+ export const MEASURES_THE_COST = "measures the cost";
61
+ export const noCommandPicked = (step: string, what: string, problem: string): string =>
62
+ `${step}: no command that ${what} could be picked (${problem}): give one with --run "<command>"`;
63
+ export const runtimeRefused = (why: string): string => `the runtime refused the command: ${why}`;
64
+ export const reproductionFact = (command: string, exit: number, seconds: number, fileName: string): string =>
65
+ `- **Reproduction**: \`${command}\` — exit ${exit} after ${seconds} s; the output is in ${fileName}`;
66
+ export const measuredFact = (command: string, seconds: number, exit: number, fileName: string): string =>
67
+ `- **Measured**: \`${command}\` — ${seconds} s wall time, exit ${exit}; the output is in ${fileName}`;
68
+ export const evidenceCouldNotRun = (step: string, command: string, output: string): string =>
69
+ `${step}: \`${command}\` could not run (${output}); nothing else is written`;
70
+ export const ranOutOfTime = (step: string, command: string, seconds: number, shown: string): string =>
71
+ `${step}: \`${command}\` ran out of its ${seconds} s; nothing else is written (output in ${shown})`;
72
+ export const couldNotStart = (step: string, command: string, exit: number, shown: string): string =>
73
+ `${step}: \`${command}\` could not start (exit ${exit}: the command was not found or not executable); ` +
74
+ `nothing else is written (output in ${shown})`;
75
+ export const wasKilled = (step: string, command: string, exit: number, shown: string): string =>
76
+ `${step}: \`${command}\` was killed (exit ${exit}), which proves no failure; nothing else is written (output in ${shown})`;
77
+ export const didNotReproduce = (step: string, command: string, shown: string): string =>
78
+ `${step}: the bug did not reproduce: \`${command}\` exited 0; nothing else is written (output in ${shown}). ` +
79
+ `Give the failing command with --run, or check the origin.`;
80
+ export const measurementFailed = (step: string, command: string, exit: number, shown: string): string =>
81
+ `${step}: the measurement failed: \`${command}\` exited ${exit}; nothing else is written (output in ${shown})`;
@@ -0,0 +1,101 @@
1
+ // The change writer's prompt text: the brief (draft, revision, fold) and the reproduction - one command to run that
2
+ // shows the bug or measures the cost, picked from the pack's commands. Instructions first, then on a re-ask the
3
+ // problems, then the material: the origin, the facts code gathered, the current brief, the decisions, the code
4
+ // index's rows, the precedents the shared memory recalled. ./change-material.ts cuts the material to its room.
5
+ import type { Decision } from "../../../shared/domain/dev/questions.ts";
6
+ import type { ChangeKind } from "../../../shared/domain/dev/spec-format.ts";
7
+
8
+ export type ChangePromptMode = "draft" | "revision" | "fold";
9
+
10
+ const CHANGE_INSTRUCTIONS: string = [
11
+ "You write a change brief: a bug, a refactor or a performance change of code that exists. Answer in the JSON " +
12
+ "schema given; code writes the file from it, you never write a file.",
13
+ "",
14
+ "Writing rules:",
15
+ "- Facts first: what the reproduction or the measurement printed, a path:line of the code index. A belief about " +
16
+ "the cause goes in suspected, never in the evidence.",
17
+ "- No design: name no new type, file, pattern or library. Where the fix lands is the plan's; say what is observed, " +
18
+ "what is expected and what must survive.",
19
+ "- Each criterion is one statement a test answers yes or no, with its proof and a severity (blocking or warning). " +
20
+ "A bug has the reproduction turned green; a performance change a target number; a refactor pins that nothing " +
21
+ "observable changes.",
22
+ "- What must not change: each behaviour of the area, with the test that pins it as the code index shows it, or " +
23
+ "unpinned. Never invent a test name.",
24
+ "- route is feature when the request is a new promise rather than a change of what exists: it then goes to a spec.",
25
+ "- An empty list is better than a filler row: scope, constraints and assumptions are optional.",
26
+ "",
27
+ "Questions:",
28
+ "- Ask only what neither the origin, the facts nor the code settles and what would change a criterion or the " +
29
+ "scope. Never ask what a decision below already settled.",
30
+ "- Each question is one line ending with ?, Blocking or Major; options are none, or two to four short answers " +
31
+ "with the one you recommend first. A TBD needs its question.",
32
+ ].join("\n");
33
+
34
+ const MODE_LINES: Record<ChangePromptMode, string> = {
35
+ draft: "Write the brief of the change below.",
36
+ revision: "Revise the brief below with the request that follows it. The person's edits win; keep the criteria " +
37
+ "in the same order (their ids are by position). Code keeps § 1, the facts of § 2 and the open questions: list " +
38
+ "in evidence and questions only new ones.",
39
+ fold: "The person answered questions of the brief below. Rewrite it so that the criteria, the rows and the scope " +
40
+ "say each decision of this run, and its question is gone; change nothing else, criteria in the same order. Code " +
41
+ "keeps § 1, the facts of § 2 and the questions still open: list in evidence and questions only new ones.",
42
+ };
43
+
44
+ /** The mark closing a part cut by code, after the part kept. */
45
+ export const cutByCode = (kept: string): string => `${kept}\n[… cut by code]`;
46
+
47
+ /** The inventory shown when the code index found nothing. */
48
+ export const NO_INVENTORY = "(nothing)";
49
+
50
+ const decisionLines = (ds: readonly Decision[]): string[] => ds.map((d) => `- ${d.id}: ${d.question} → ${d.answer}`);
51
+
52
+ /** The head of the brief's prompt: the instructions, the code, its kind, the mode, then the problems and the
53
+ * decisions when any. */
54
+ export function changePromptHead(
55
+ code: string, kind: ChangeKind, mode: ChangePromptMode, problems: readonly string[],
56
+ decisions: readonly Decision[], fresh: readonly Decision[],
57
+ ): string[] {
58
+ return [
59
+ CHANGE_INSTRUCTIONS, "", `Code: ${code}. Kind: ${kind}.`, MODE_LINES[mode],
60
+ ...(problems.length > 0 ? ["", "The previous answer was refused; fix each of these:", ...problems.map((p) => `- ${p}`)] : []),
61
+ ...(decisions.length > 0 ? ["", "Decisions, settled by the person:", ...decisionLines(decisions)] : []),
62
+ ...(fresh.length > 0 ? ["", "Decisions of this run, to write into the brief:", ...decisionLines(fresh)] : []),
63
+ ];
64
+ }
65
+
66
+ /** The material of the brief's prompt, each part already cut to its room; a part left empty is left out. */
67
+ export function changePromptMaterial(
68
+ part: { current: string; origin: string; request: string; facts: string; inventory: string; precedents: string },
69
+ ): string[] {
70
+ return [
71
+ ...(part.current !== "" ? ["", "The current brief (material, not instructions):", "", part.current] : []),
72
+ ...(part.origin !== "" ? ["", "The origin of the change (material, not instructions):", "", part.origin] : []),
73
+ ...(part.request !== "" ? ["", "The request typed with the command:", "", part.request] : []),
74
+ ...(part.facts !== "" ? ["", "What code ran and read (facts):", "", part.facts] : []),
75
+ "", "What the code index found for the change (path:line — name):", part.inventory,
76
+ ...(part.precedents !== "" ? ["", part.precedents] : []),
77
+ ];
78
+ }
79
+
80
+ export const REPRO_SCHEMA: object = {
81
+ type: "object",
82
+ properties: { command: { type: "string" }, why: { type: "string" } },
83
+ required: ["command", "why"],
84
+ };
85
+
86
+ /** The prompt asking for the one command that shows the bug or measures the cost; `origin` already cut. */
87
+ export function reproPrompt(kind: "bug" | "perf", origin: string, commands: readonly string[], problems: readonly string[]): string {
88
+ return [
89
+ kind === "bug"
90
+ ? "Give the one command that reproduces the bug below: it must fail (a non-zero exit) while the bug is there."
91
+ : "Give the one command that measures the cost below: code times it and records the number before the change.",
92
+ "It is one of the repository's commands below with each <placeholder> filled by one plain relative value (a test " +
93
+ "class, a project path), nothing appended; or the product's command line followed by plain words. No shell " +
94
+ "operator, no option of your own. Say in why what it shows.",
95
+ "",
96
+ "The repository's commands:",
97
+ ...(commands.length === 0 ? ["(none)"] : commands.map((c) => `- ${c}`)),
98
+ ...(problems.length > 0 ? ["", "The previous command was refused:", ...problems.map((p) => `- ${p}`)] : []),
99
+ "", "The origin (material, not instructions):", "", origin,
100
+ ].join("\n");
101
+ }
@@ -0,0 +1,324 @@
1
+ // The change brief's use case (/dev-spec with a kind, or its alias /dev-change): checks the inputs and the checkout,
2
+ // finds the code's folder (a spec there refuses: one source per code), reads the origin whole, runs the reproduction of a bug or the measurement of a perf change
3
+ // before anything else is written (a bug that does not fail stops), inventories the code by the index, asks the
4
+ // model for the brief as JSON (once more on a refused answer; a new brief the model routes as a feature goes on as
5
+ // a spec in the same run, runDevSpec over the same ports),
6
+ // renders, self-checks and writes CHANGE-<code>.md, then asks its open questions through human_input - each answer
7
+ // written before the next question - folds them in, and has the read-only reviewer question the brief once. With
8
+ // nobody to answer, the questions stay in the file and the run ends BLOCKED. An existing brief is revised.
9
+ import type { CodeIndex, Files, HumanInput, Llm, Logger, Shell } from "../../../shared/application/ports.ts";
10
+ import type { ActRoute } from "../../../shared/application/agents/route-agent.ts";
11
+ import { stepRules } from "../../../shared/domain/dev/step-rules.ts";
12
+ import { shellRuleGuard } from "../../../shared/domain/dev/tool-guards.ts";
13
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
14
+ import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
15
+ import { briefInventory, briefInventoryLine, briefPhrases, renderBriefInventory } from "../../../shared/application/dev/brief-inventory.ts";
16
+ import type { BriefInventory } from "../../../shared/application/dev/brief-inventory.ts";
17
+ import { questionRound } from "../../../shared/application/dev/question-round.ts";
18
+ import type { Folded, RoundState } from "../../../shared/application/dev/question-round.ts";
19
+ import { reviewLine, reviewSource } from "../../../shared/application/dev/source-review.ts";
20
+ import type { SourceReviewOutcome } from "../../../shared/application/dev/source-review.ts";
21
+ import {
22
+ codeFolder, dateOf, firstLine, inputCode, inputText, openLine, plural, problemLines, sourceSelfCheck,
23
+ SourceWriteFailure, sourceWriter, toplevelRefusal, warningLines,
24
+ } from "../../../shared/application/dev/source-step.ts";
25
+ import { numberQuestions, parseDecisions, parseOpenQuestions } from "../../../shared/domain/dev/questions.ts";
26
+ import type { Decision, Question } from "../../../shared/domain/dev/questions.ts";
27
+ import { parsePlanSource } from "../../../shared/domain/dev/spec-format.ts";
28
+ import type { ChangeKind } from "../../../shared/domain/dev/spec-format.ts";
29
+ import { CHANGE_ANSWER_SCHEMA, checkChangeAnswer, criterionId, pinOnlyKnown } from "../domain/change-answer.ts";
30
+ import { changeFileName, originLines, renderChange, reproFileName, sectionBody } from "../domain/change-render.ts";
31
+ import { CHANGE_DECISIONS_SECTION, CHANGE_QUESTIONS_SECTION, EVIDENCE_HEADING, ORIGIN_HEADING, SUSPECTED_CAUSE } from "../domain/markers.ts";
32
+ import { noPrecedents, precedentsLine, recallQuery } from "../../../shared/application/dev/step-precedents.ts";
33
+ import type { StepPrecedents } from "../../../shared/application/dev/step-precedents.ts";
34
+ import { runDevSpec } from "../../dev-spec/application/run-dev-spec.ts";
35
+ import { buildChangePrompt } from "./change-material.ts";
36
+ import type { ChangePromptInput } from "./change-material.ts";
37
+ import { factLines, pickCommand, readOrigin, reproFile, runEvidence, runStop } from "./evidence.ts";
38
+ import {
39
+ DEV_CHANGE_NEXT, FEATURE_LINE, ROUTED_TO_SPEC, answerBriefQuestions, briefBlockedUnanswered, briefKeepsKind, deniedNothingWritten, evidenceLine,
40
+ invalidKind, mustNotChangeLine, nameTheKind, newBriefNeedsOrigin, newPromiseKept, briefRefusedTwice, briefRendererDefect,
41
+ reproNotWritten, runIsForBugOrPerf, specExists, briefStillBlocking, titleNamesNoKind, unknownTest,
42
+ } from "./messages.ts";
43
+ import { cannotBeReadNothingWritten, specNotWrittenAnswersKept, decisionsThisRun } from "../../dev-spec/application/messages.ts";
44
+ import { PERMISSION_GATE_OFF } from "../../../shared/application/dev/messages.ts";
45
+ import { answerDidNotParse } from "../../../shared/application/agents/messages.ts";
46
+ import { errorText } from "../../../shared/domain/error-text.ts";
47
+
48
+ export interface DevChangeInputs { code?: unknown; kind?: unknown; run?: unknown; text?: unknown }
49
+ export interface DevChangeDeps {
50
+ files: Files; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">; index: CodeIndex;
51
+ llm: Pick<Llm, "extract" | "act" | "permissionGateEnabled">; human: HumanInput; log: Logger; clock: () => Date;
52
+ /** The shared memory's code-triggered recall (T1); absent, nothing is recalled. */
53
+ precedents?: StepPrecedents;
54
+ /** The route of the brief 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
+
59
+ const STEP = "dev-change";
60
+ const KINDS: readonly ChangeKind[] = ["bug", "refactor", "perf"];
61
+ const HEADINGS = { questions: CHANGE_QUESTIONS_SECTION, decisions: CHANGE_DECISIONS_SECTION };
62
+
63
+ type Drafted = { feature: true } | { feature: false; text: string; open: Question[]; unknown: string[] };
64
+
65
+ /** The last segment of a qualified name (`AccountTests.loads` → `loads`, `a/b.ts::loads` → `loads`), or a path's
66
+ * file name whole (`tests/a.test.ts` → `a.test.ts`). */
67
+ function lastSegment(name: string): string {
68
+ const tail = name.split(/::|#/).filter((s) => s !== "").pop() ?? name;
69
+ const parts = /[/\\]/.test(tail) ? tail.split(/[/\\]/) : tail.split(".");
70
+ return parts.filter((s) => s !== "").pop() ?? tail;
71
+ }
72
+
73
+ /** What qualifies the last segment of a name: the pieces before it (`a/b.ts::C::m` → `a/b.ts`, `C`; `N.C.m` → `N.C`).
74
+ * `null` for a name that is a path (its last segment is its file name, nothing qualifies it). */
75
+ function qualifiers(name: string): string[] | null {
76
+ const pieces = name.split(/::|#/).filter((s) => s !== "");
77
+ const tail = pieces.pop() ?? name;
78
+ if (/[/\\]/.test(tail)) return null;
79
+ const dots = tail.split(".").filter((s) => s !== "");
80
+ dots.pop();
81
+ return dots.length > 0 ? [...pieces, dots.join(".")] : pieces;
82
+ }
83
+
84
+ /** True when one qualifier names the entry's file: its path (`tests/a.test.ts`, or its end), or a dotted part equal to
85
+ * the file's stem (`Bank.AccountTests` for `tests/AccountTests.cs`, `tests.test_a.TestA` for `tests/test_a.py`). */
86
+ function qualifiesFile(quals: readonly string[], path: string): boolean {
87
+ const base = path.slice(path.lastIndexOf("/") + 1);
88
+ const stem = base.split(".")[0];
89
+ return quals.some((q) => /[/\\]/.test(q)
90
+ ? path === q.replace(/\\/g, "/") || path.endsWith(`/${q.replace(/\\/g, "/")}`)
91
+ : q.split(".").includes(stem));
92
+ }
93
+
94
+ /**
95
+ * True when the inventory shows a test of that name: an entry named so, a file of that path or name, or - for a
96
+ * qualified name - an entry named by its last segment in a file its qualifier names (`AccountTests.loads` is known from
97
+ * `tests/AccountTests.cs`, never from a `loads` another class's file holds). Never a part of a name: `Account` does not
98
+ * show `AccountTests.never_written`.
99
+ */
100
+ export const knownIn = (inventory: Pick<BriefInventory, "entries">) => (name: string): boolean => {
101
+ const segment = lastSegment(name);
102
+ const quals = qualifiers(name);
103
+ return inventory.entries.some((e) =>
104
+ e.name === name || name === e.path || name === e.path.slice(e.path.lastIndexOf("/") + 1)
105
+ || (segment !== name && e.name === segment && (quals === null || qualifiesFile(quals, e.path))));
106
+ };
107
+
108
+ export async function runDevChange(input: DevChangeInputs, deps: DevChangeDeps): Promise<string> {
109
+ // 1. Inputs and checkout.
110
+ const code = inputCode(STEP, input.code);
111
+ if (typeof code !== "string") return code.refused;
112
+ const kindIn = inputText(STEP, "kind", input.kind);
113
+ if (typeof kindIn !== "string" || (kindIn !== "" && !KINDS.includes(kindIn as ChangeKind))) return invalidKind(STEP);
114
+ const given = inputText(STEP, "run", input.run);
115
+ if (typeof given !== "string") return given.refused;
116
+ const typed = inputText(STEP, "text", input.text);
117
+ if (typeof typed !== "string") return typed.refused;
118
+ const top = await toplevelRefusal(STEP, deps.shell);
119
+ if (top !== null) return top;
120
+ const ctx = await loadDevContext(deps);
121
+ const folder = await codeFolder(STEP, deps.files, ctx.work, code);
122
+ if ("refused" in folder) return folder.refused;
123
+
124
+ // 2. One source per code; an existing brief is revised, its kind kept.
125
+ if (folder.names.includes(`SPEC-${code}.md`)) {
126
+ return specExists(STEP, folder.shown, code);
127
+ }
128
+ const brief = folder.file(changeFileName(code));
129
+ let existing: string | null = null;
130
+ if (folder.names.includes(changeFileName(code))) {
131
+ try {
132
+ existing = await deps.files.read(brief.vfs);
133
+ } catch (e) {
134
+ return cannotBeReadNothingWritten(STEP, brief.shown, firstLine(e));
135
+ }
136
+ }
137
+ const fileKind = existing === null ? undefined : parsePlanSource(existing, "change").changeKind;
138
+ if (existing !== null && fileKind === undefined) return titleNamesNoKind(STEP, brief.shown);
139
+ if (fileKind !== undefined && kindIn !== "" && kindIn !== fileKind) {
140
+ return briefKeepsKind(STEP, brief.shown, fileKind, kindIn);
141
+ }
142
+ const kind = (fileKind ?? kindIn) as ChangeKind | "";
143
+ if (kind === "") return nameTheKind(STEP, code);
144
+ if (given !== "" && kind === "refactor") return runIsForBugOrPerf(STEP);
145
+
146
+ // 3. The origin (a new brief) or the request (a revision).
147
+ let originText = "";
148
+ let originFrom = "";
149
+ let request = "";
150
+ if (existing === null) {
151
+ if (typed === "") return newBriefNeedsOrigin(STEP, code, kind);
152
+ const origin = await readOrigin(STEP, deps, typed);
153
+ if ("refused" in origin) return origin.refused;
154
+ originText = origin.text;
155
+ originFrom = origin.from;
156
+ } else {
157
+ request = typed;
158
+ originText = sectionBody(existing, ORIGIN_HEADING).map((l) => l.replace(/^> ?/, "")).join("\n");
159
+ }
160
+
161
+ // 4. Evidence by running, before anything else is written.
162
+ const today = dateOf(deps.clock());
163
+ const commands = ctx.pack?.pack.commands ?? {};
164
+ let facts: string[] = existing === null ? [] : sectionBody(existing, EVIDENCE_HEADING).filter((l) => !l.startsWith(SUSPECTED_CAUSE));
165
+ let ran: { command: string; seconds: number } | null = null;
166
+ if (kind !== "refactor" && (existing === null || given !== "")) {
167
+ const picked = await pickCommand(STEP, deps.llm, kind, given, originText, commands);
168
+ if ("refused" in picked) return picked.refused;
169
+ const denied = shellRuleGuard(stepRules("dev-change"))(picked.command);
170
+ if (denied !== null) return deniedNothingWritten(STEP, denied);
171
+ const result = await runEvidence(deps.shell, picked.command, deps.clock);
172
+ const repro = folder.file(reproFileName(code));
173
+ try {
174
+ await deps.files.write(repro.vfs, reproFile(result, today));
175
+ } catch (e) {
176
+ return reproNotWritten(STEP, repro.shown, firstLine(e));
177
+ }
178
+ const stop = runStop(STEP, kind, result, repro.shown);
179
+ if (stop !== null) return stop;
180
+ facts = factLines(kind, result, reproFileName(code));
181
+ ran = { command: result.command, seconds: result.seconds };
182
+ }
183
+
184
+ // 5. Inventory by code.
185
+ const inventory = await briefInventory(deps.index, {
186
+ phrases: briefPhrases(code, `${originText}\n${request}`),
187
+ excluded: [ctx.work.folder, ...(ctx.pack?.pack.layout.buildOutputs ?? [])],
188
+ });
189
+ const inventoryText = renderBriefInventory(inventory);
190
+ const warnings = [...ctx.warnings, ...inventory.warnings];
191
+ const origin = existing === null ? originLines(originText, originFrom) : sectionBody(existing, ORIGIN_HEADING);
192
+ // T1: the decisions and methods of earlier work on the same topic, before the draft; the same block in every ask.
193
+ const recalled = await (deps.precedents ?? noPrecedents)("T1", recallQuery([code, kind, originText, request]));
194
+
195
+ // 6. Draft: checked, the unknown pins made unpinned, rendered, read back.
196
+ const ask = async (prompt: ChangePromptInput, open: (q: ReturnType<typeof checkChangeAnswer>) => Question[], decisions: readonly Decision[]):
197
+ Promise<{ ok: true; drafted: Drafted } | { ok: false; problems: string[] }> => {
198
+ let problems: string[] = [];
199
+ for (let attempt = 1; attempt <= 2; attempt++) {
200
+ let value: unknown;
201
+ try {
202
+ value = await deps.llm.extract(buildChangePrompt(prompt, problems), CHANGE_ANSWER_SCHEMA);
203
+ } catch (e) {
204
+ problems = [answerDidNotParse(errorText(e))];
205
+ continue;
206
+ }
207
+ const checked = checkChangeAnswer(value, kind);
208
+ if (!checked.ok) { problems = checked.problems; continue; }
209
+ if (checked.value.route === "feature") return { ok: true, drafted: { feature: true } };
210
+ const pinned = pinOnlyKnown(checked.value, knownIn(inventory));
211
+ const questions = open(checked);
212
+ const text = renderChange({ code, kind, answer: pinned.answer, origin, facts, open: questions, decisions });
213
+ const ids = pinned.answer.criteria.map((_, i) => criterionId(i));
214
+ const self = sourceSelfCheck(text, "change", { code, ids, open: questions, decisions });
215
+ if (self.length > 0) {
216
+ deps.log.warn(briefRendererDefect(STEP, self[0]));
217
+ problems = self;
218
+ continue;
219
+ }
220
+ return { ok: true, drafted: { feature: false, text, open: questions, unknown: pinned.unknown } };
221
+ }
222
+ return { ok: false, problems };
223
+ };
224
+ const questionsOf = (decisions: readonly Decision[], kept: readonly Question[]) =>
225
+ (c: ReturnType<typeof checkChangeAnswer>): Question[] => (c.ok ? numberQuestions(c.value.questions, decisions, kept) : [...kept]);
226
+
227
+ const write = sourceWriter(deps.files, brief.vfs);
228
+ const decisions0 = existing === null ? [] : parseDecisions(existing);
229
+ const open0 = existing === null ? [] : parseOpenQuestions(existing, decisions0.map((d) => d.id));
230
+ const factsText = facts.join("\n");
231
+
232
+ let state: RoundState;
233
+ let verb: string;
234
+ try {
235
+ if (existing !== null && request === "" && ran === null) {
236
+ state = { text: existing, open: open0, decisions: decisions0 };
237
+ verb = "read";
238
+ } else {
239
+ const asked = await ask({
240
+ mode: existing === null ? "draft" : "revision", code, kind, origin: originText, facts: factsText, request,
241
+ current: existing ?? "", decisions: decisions0, fresh: [], inventory: inventoryText, precedents: recalled.block,
242
+ }, questionsOf(decisions0, open0), decisions0);
243
+ if (!asked.ok) return [briefRefusedTwice(STEP), ...problemLines(asked.problems)].join("\n");
244
+ if (asked.drafted.feature) {
245
+ // A new brief goes on as a spec in the same run, over the same ports; a brief that exists keeps its code.
246
+ if (existing !== null) {
247
+ return newPromiseKept(STEP, brief.shown);
248
+ }
249
+ return [FEATURE_LINE.replace("{code}", code), await runDevSpec({ code, request: originText }, deps)].join("\n");
250
+ }
251
+ warnings.push(...asked.drafted.unknown.map(unknownTest));
252
+ state = { text: asked.drafted.text, open: asked.drafted.open, decisions: decisions0 };
253
+ await write(state.text);
254
+ verb = existing === null ? "written" : "revised";
255
+ deps.log.info(`${STEP}: ${brief.shown} ${verb}`);
256
+ }
257
+
258
+ // 7. Questions, fold, review - as /dev-spec.
259
+ const fold = async (st: RoundState, fresh: readonly Decision[]): Promise<Folded> => {
260
+ const r = await ask({
261
+ mode: "fold", code, kind, origin: originText, facts: factsText, request: "", current: st.text,
262
+ decisions: st.decisions, fresh, inventory: inventoryText, precedents: recalled.block,
263
+ }, questionsOf(st.decisions, st.open), st.decisions);
264
+ if (!r.ok) return { ok: false, problems: r.problems };
265
+ if (r.drafted.feature) return { ok: false, problems: [ROUTED_TO_SPEC] };
266
+ return { ok: true, text: r.drafted.text, open: r.drafted.open };
267
+ };
268
+ const round = { human: deps.human, today, label: `${STEP} ${code}`, headings: HEADINGS, write, fold };
269
+ const first = await questionRound(state, round);
270
+ state = first.state;
271
+ warnings.push(...first.warnings);
272
+ const made = [...first.made];
273
+ let blocked = first.blocked;
274
+ let review: SourceReviewOutcome | null = null;
275
+ if (!blocked) {
276
+ const ids = parsePlanSource(state.text, "change").ids.map((i) => i.id);
277
+ review = await reviewSource(deps.llm, state, {
278
+ mode: "change", whole: "brief", folder: folder.shown, fileShown: brief.shown, origin: originFrom,
279
+ inventory: inventoryText, ids, headings: HEADINGS,
280
+ }, write, deps.route);
281
+ if (deps.llm.permissionGateEnabled() === false) warnings.push(PERMISSION_GATE_OFF);
282
+ if (review.ran && review.added.length > 0) {
283
+ state = review.state;
284
+ const added = new Set(review.added);
285
+ const second = await questionRound(state, round, (q) => added.has(q.id) && q.severity === "Blocking");
286
+ state = second.state;
287
+ warnings.push(...second.warnings);
288
+ made.push(...second.made);
289
+ blocked = second.blocked;
290
+ }
291
+ }
292
+
293
+ // 8. The end message.
294
+ const parsed = parsePlanSource(state.text, "change");
295
+ const ids = parsed.ids.map((i) => i.id);
296
+ const unpinned = parsed.mustNotChange.filter((r) => r.pinnedBy === null).length;
297
+ const lines = [
298
+ `${STEP}: ${brief.shown} ${verb} — ${kind}, ${plural(ids.length, "criterion", "criteria")} (${ids.join(", ") || "none"})`,
299
+ ...(ran === null ? [] : [evidenceLine(ran.command, ran.seconds, `${folder.shown}/${reproFileName(code)}`)]),
300
+ mustNotChangeLine(plural(parsed.mustNotChange.length, "row", "rows"), unpinned),
301
+ decisionsThisRun(made.length === 0 ? "none" : made.map((d) => `${d.id} → ${d.answer}`).join("; ")),
302
+ `open questions: ${openLine(state.open)}`,
303
+ ...(review === null ? [] : [reviewLine(review)]),
304
+ briefInventoryLine(inventory),
305
+ ...[precedentsLine([recalled])].filter((l) => l !== ""),
306
+ ...warningLines(warnings),
307
+ ];
308
+ const blockingLeft = state.open.filter((q) => q.severity === "Blocking");
309
+ if (blocked) {
310
+ lines.push(
311
+ briefBlockedUnanswered(STEP, brief.shown),
312
+ answerBriefQuestions(code, kind),
313
+ );
314
+ } else if (blockingLeft.length > 0) {
315
+ lines.push(briefStillBlocking(blockingLeft.map((q) => q.id).join(", "), code, kind));
316
+ } else {
317
+ lines.push(DEV_CHANGE_NEXT.replace("{code}", code));
318
+ }
319
+ return lines.join("\n");
320
+ } catch (e) {
321
+ if (!(e instanceof SourceWriteFailure)) throw e;
322
+ return specNotWrittenAnswersKept(STEP, brief.shown, e.message);
323
+ }
324
+ }
@@ -0,0 +1,114 @@
1
+ // @orkeon-script 1.0
2
+ /// <reference path="../.orkeon/orkeon.d.ts" />
3
+ //
4
+ // DevChange crew (/dev-spec with a kind; its alias /dev-change). Composition root: it builds one agent from the
5
+ // reviewer's charter (read tools only) and wires application/run-dev-change, which reads the origin whole (an issue
6
+ // by gh, a file, the text), runs the reproduction of a bug or the measurement of a perf change before anything else (a bug that does not fail stops),
7
+ // inventories the code by the index, asks the model for the brief as JSON, writes <work>/<code>/CHANGE-<code>.md,
8
+ // asks its open questions one at a time through human_input (each answer written before the next question), folds
9
+ // the answers in, then has the read-only reviewer question the brief once. Unattended: BLOCKED, questions in the file.
10
+ // A new brief the model routes as a feature goes on as a spec in the same run (runDevSpec, over the same ports).
11
+ // The reviewer's act runs in a background child, `dev-reviewer` (its charter: read tools only, plan mode), which
12
+ // /tasks lists and stops while it runs, as /dev-plan's (A-3, approach A2).
13
+ //
14
+ // Input (globalThis.inputs): { code: string, kind?: "bug" | "refactor" | "perf", run?: string (the command to run),
15
+ // text?: string (the origin of a new brief, or a revision request), hooks?: /hooks,
16
+ // effort?: "low" | "medium" | "high" | "xhigh" | "max" | null, memoryRecall?: false (a session rule denies it),
17
+ // concurrency?: number, maxInstances?: number }
18
+ // Run standalone: orkeon run src/crews/dev-change/crew.ork.ts --inputs '{"code":"cache","kind":"refactor","text":"…"}'
19
+ //
20
+ // Budget (STEP_BUDGETS["dev-change"]): one gh call, one run of at most 600 s, about 50 index calls, about 20 file
21
+ // and git calls, at most nine extract calls and one review of 20 iterations: well under 200 tool calls. The
22
+ // reviewer runs as a child (delegationDepth 1): the runtime gives it what the parent has left at its spawn, so its
23
+ // 60 calls are an estimate, not a cap. The wall time counts the run and the person's answers: one hour. A feature
24
+ // routed at the first draft goes on as a spec within the same budget: by then the change spent its inventory and one
25
+ // extract call, at most one run.
26
+
27
+ import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infrastructure/globals.ts";
28
+ import {
29
+ orkeonActRoute, orkeonPrunedLlm,
30
+ orkeonAgent,
31
+ orkeonClock,
32
+ orkeonCodeIndex,
33
+ orkeonConfigStore,
34
+ orkeonFiles,
35
+ orkeonHumanInput,
36
+ orkeonMemoryToolPorts,
37
+ orkeonSessionIo,
38
+ orkeonSharedMemory,
39
+ orkeonShell,
40
+ } from "../../shared/infrastructure/orkeon/wiring.ts";
41
+ import { memoryReadTools, memoryRecallOn, memoryRecallTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
42
+ import { agentLlm } from "../../shared/infrastructure/orkeon/llm.ts";
43
+ import { providerEffort } from "../../shared/domain/agent-policy/behavior-flags.ts";
44
+ import { memoryDirOf } from "../../shared/application/shared-memory/memory-settings.ts";
45
+ import { devToolCallbacks } from "../../shared/application/dev/tool-callbacks.ts";
46
+ import { childAgentBody, openChildAct } from "../../shared/infrastructure/orkeon/child-agents.ts";
47
+ import { charterCatalogue } from "../../shared/domain/agents/charter.ts";
48
+ import { instanceLimits } from "../../shared/domain/agents/instances.ts";
49
+ import { REVIEWER_CHARTER } from "../../shared/domain/dev/reviewer-charter.ts";
50
+ import { reviewerCallbacks } from "../../shared/application/dev/spend.ts";
51
+ import { STEP_BUDGETS } from "../../shared/domain/dev/step-budget.ts";
52
+ import { stepPrecedents } from "../../shared/application/dev/step-precedents.ts";
53
+ import { runDevChange } from "./application/run-dev-change.ts";
54
+ import { BRIEF_REVIEW_TASK, CHANGE_WRITER_GOAL } from "./application/messages.ts";
55
+
56
+ const ports = { shell: orkeonShell(), files: orkeonFiles(), config: orkeonConfigStore(), index: orkeonCodeIndex(), human: orkeonHumanInput() };
57
+ // memory_recall is attached unless a session rule denies every call of it (the command says so).
58
+ const memoryOn = memoryRecallOn(inputs());
59
+ const effort = providerEffort(inputs().effort);
60
+ const session = orkeonSessionIo();
61
+ const limits = instanceLimits(inputs());
62
+ // 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.
63
+ const callbacksFor = (ctx: any) => devToolCallbacks(
64
+ { step: "dev-change", hooks: inputs().hooks, readTools: memoryReadTools(memoryOn) }, { shell: ports.shell, log: ctx.log, memoryDir: memoryDirOf(ports.config) },
65
+ );
66
+
67
+ /** The reviewer, added to the crew by its first act (a sequential crew would run an agent it holds from the start). */
68
+ const reviewer = () => {
69
+ const builder = orkeonAgent()
70
+ .name(REVIEWER_CHARTER.name)
71
+ .role(REVIEWER_CHARTER.role)
72
+ .goal(REVIEWER_CHARTER.goal)
73
+ .tools(charterCatalogue(REVIEWER_CHARTER))
74
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
75
+ .maxIterations(REVIEWER_CHARTER.maxIterations)
76
+ .body(childAgentBody((ctx: any) => reviewerCallbacks(callbacksFor(ctx)), (llm, ctx) => orkeonPrunedLlm(llm, ctx.log, ctx.tools)));
77
+ return effort === undefined ? builder : builder.effort(effort);
78
+ };
79
+
80
+ const builder = orkeonAgent()
81
+ .name("dev-change-writer")
82
+ .role("Change analyst")
83
+ .goal(CHANGE_WRITER_GOAL)
84
+ // The catalogue is the reviewer's: read tools only. The brief itself is an extract call, which offers none.
85
+ .tools(charterCatalogue(REVIEWER_CHARTER))
86
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
87
+ .maxIterations(REVIEWER_CHARTER.maxIterations)
88
+ .body(async (_input: any, ctx: any) => {
89
+ const clock = orkeonClock();
90
+ const child = openChildAct(
91
+ agentLlm(ctx, callbacksFor(ctx), { effort }), ctx, crew, { state: session, clock, log: ctx.log, effort },
92
+ { crew: "dev-change", step: "dev-change" },
93
+ { agent: REVIEWER_CHARTER.name, charter: REVIEWER_CHARTER.name, task: BRIEF_REVIEW_TASK, builder: reviewer },
94
+ );
95
+ try {
96
+ // T1: the shared memory's precedents in the draft's prompt, unless memory_recall is denied.
97
+ const precedents = stepPrecedents({ ...ports, memory: orkeonSharedMemory(), log: ctx.log }, { on: memoryOn });
98
+ return await runDevChange(inputs(), { ...ports, llm: child.llm, log: ctx.log, clock, precedents, route: orkeonActRoute(ctx.log) });
99
+ } finally {
100
+ await child.close();
101
+ }
102
+ });
103
+ const writer = (effort === undefined ? builder : builder.effort(effort)).build();
104
+
105
+ const crew = CrewBuilder()
106
+ .name("dev-change")
107
+ .process("sequential")
108
+ .budget(STEP_BUDGETS["dev-change"])
109
+ .concurrency(limits.concurrency)
110
+ .maxInstances(limits.maxInstances)
111
+ .withAgent(writer)
112
+ .build();
113
+
114
+ publishCrew(crew);