orkeon-code 1.0.0-rc.1 → 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 (440) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +206 -11
  13. package/orkeon-code.ps1 +109 -7
  14. package/package.json +2 -1
  15. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  16. package/src/commands/_lib/args.ts +5 -4
  17. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  18. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  19. package/src/commands/_lib/dev/dev-source.ts +7 -11
  20. package/src/commands/_lib/dev/dev.ts +34 -37
  21. package/src/commands/_lib/dev/markers.ts +7 -0
  22. package/src/commands/_lib/dev/messages.ts +112 -0
  23. package/src/commands/_lib/dev-step.ts +16 -13
  24. package/src/commands/_lib/dispatch.ts +62 -39
  25. package/src/commands/_lib/git/branch.ts +9 -10
  26. package/src/commands/_lib/git/commit.ts +9 -13
  27. package/src/commands/_lib/git/diff.ts +22 -12
  28. package/src/commands/_lib/git/messages.ts +54 -0
  29. package/src/commands/_lib/git/review.ts +9 -10
  30. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  31. package/src/commands/_lib/memory/memory.ts +3 -2
  32. package/src/commands/_lib/memory/messages.ts +32 -0
  33. package/src/commands/_lib/messages.ts +48 -0
  34. package/src/commands/_lib/project/messages.ts +8 -0
  35. package/src/commands/_lib/session/export.ts +3 -2
  36. package/src/commands/_lib/session/messages.ts +87 -0
  37. package/src/commands/_lib/session/prompts.ts +4 -0
  38. package/src/commands/_lib/session/resume.ts +15 -24
  39. package/src/commands/_lib/session/tasks.ts +20 -23
  40. package/src/commands/_lib/settings/advisor.ts +11 -16
  41. package/src/commands/_lib/settings/agents.ts +18 -28
  42. package/src/commands/_lib/settings/choices.ts +8 -0
  43. package/src/commands/_lib/settings/config.ts +43 -43
  44. package/src/commands/_lib/settings/effort.ts +147 -0
  45. package/src/commands/_lib/settings/hooks.ts +12 -20
  46. package/src/commands/_lib/settings/messages.ts +408 -0
  47. package/src/commands/_lib/settings/mode.ts +33 -24
  48. package/src/commands/_lib/settings/model.ts +71 -36
  49. package/src/commands/_lib/settings/output-style.ts +39 -0
  50. package/src/commands/_lib/settings/permissions.ts +71 -93
  51. package/src/commands/_lib/settings/route.ts +63 -0
  52. package/src/commands/_lib/settings/skills.ts +53 -11
  53. package/src/commands/_lib/settings/theme.ts +42 -0
  54. package/src/commands/_lib/speech/messages.ts +58 -0
  55. package/src/commands/_lib/speech/prompts.ts +4 -0
  56. package/src/commands/_lib/speech/say.ts +9 -10
  57. package/src/commands/_lib/speech/transcribe.ts +14 -23
  58. package/src/commands/_lib/speech/voice.ts +14 -18
  59. package/src/commands/_lib/status/doctor.ts +47 -28
  60. package/src/commands/_lib/status/messages.ts +100 -0
  61. package/src/commands/_lib/status/meta.ts +3 -24
  62. package/src/commands/_lib/status/status.ts +10 -11
  63. package/src/commands/_lib/status/usage-tools.ts +2 -3
  64. package/src/commands/_lib/status/usage.ts +7 -18
  65. package/src/commands/_lib/view.ts +6 -1
  66. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  67. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  68. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  69. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  70. package/src/commands/git/commit.cmd.ts +3 -3
  71. package/src/commands/git/review.cmd.ts +3 -3
  72. package/src/commands/memory/memory.cmd.ts +2 -2
  73. package/src/commands/project/analyze.cmd.ts +3 -3
  74. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  75. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  76. package/src/commands/project/init.cmd.ts +3 -3
  77. package/src/commands/project/verify.cmd.ts +2 -2
  78. package/src/commands/session/assistant.cmd.ts +2 -2
  79. package/src/commands/session/compact.cmd.ts +1 -1
  80. package/src/commands/session/copy.cmd.ts +8 -7
  81. package/src/commands/session/rename.cmd.ts +3 -2
  82. package/src/commands/session/rewind.cmd.ts +3 -4
  83. package/src/commands/session/summary.cmd.ts +3 -3
  84. package/src/commands/session/tasks.cmd.ts +4 -2
  85. package/src/commands/settings/config.cmd.ts +4 -2
  86. package/src/commands/settings/effort.cmd.ts +10 -31
  87. package/src/commands/settings/fast.cmd.ts +2 -1
  88. package/src/commands/settings/mode.cmd.ts +3 -3
  89. package/src/commands/settings/model.cmd.ts +3 -2
  90. package/src/commands/settings/output-style.cmd.ts +9 -38
  91. package/src/commands/settings/permissions.cmd.ts +2 -2
  92. package/src/commands/settings/proactive.cmd.ts +2 -1
  93. package/src/commands/settings/route.cmd.ts +16 -0
  94. package/src/commands/settings/skills.cmd.ts +3 -3
  95. package/src/commands/settings/theme.cmd.ts +14 -0
  96. package/src/commands/speech/say.cmd.ts +2 -2
  97. package/src/commands/speech/transcribe.cmd.ts +2 -2
  98. package/src/commands/status/release-notes.cmd.ts +1 -1
  99. package/src/crews/.orkeon/orkeon.d.ts +538 -93
  100. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  101. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  102. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  103. package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
  104. package/src/crews/advisor/application/messages.ts +4 -0
  105. package/src/crews/advisor/application/prompts.ts +4 -0
  106. package/src/crews/advisor/application/run-advisor.ts +2 -1
  107. package/src/crews/advisor/crew.ork.ts +5 -4
  108. package/src/crews/advisor/domain/advice.ts +7 -23
  109. package/src/crews/advisor/domain/messages.ts +8 -0
  110. package/src/crews/advisor/domain/prompts.ts +26 -0
  111. package/src/crews/agent-run/application/messages.ts +18 -0
  112. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  113. package/src/crews/agent-run/crew.ork.ts +3 -3
  114. package/src/crews/analyze/application/messages.ts +27 -0
  115. package/src/crews/analyze/application/prompts.ts +4 -0
  116. package/src/crews/analyze/application/run-analyze.ts +16 -14
  117. package/src/crews/analyze/crew.ork.ts +5 -4
  118. package/src/crews/analyze/domain/harvest.ts +33 -65
  119. package/src/crews/analyze/domain/prompts.ts +86 -0
  120. package/src/crews/code-review/application/lens-material.ts +24 -0
  121. package/src/crews/code-review/application/messages.ts +17 -0
  122. package/src/crews/code-review/application/prompts.ts +10 -17
  123. package/src/crews/code-review/application/review.ts +4 -1
  124. package/src/crews/code-review/application/run-code-review.ts +13 -15
  125. package/src/crews/code-review/crew.ork.ts +5 -4
  126. package/src/crews/code-review/domain/lenses.ts +6 -45
  127. package/src/crews/code-review/domain/messages.ts +25 -0
  128. package/src/crews/code-review/domain/prompts.ts +58 -0
  129. package/src/crews/code-review/domain/report.ts +5 -6
  130. package/src/crews/code-review/domain/scope.ts +6 -12
  131. package/src/crews/dev-batches/application/messages.ts +127 -0
  132. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  133. package/src/crews/dev-batches/application/prompts.ts +10 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  135. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  136. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  137. package/src/crews/dev-batches/crew.ork.ts +12 -9
  138. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  139. package/src/crews/dev-batches/domain/markers.ts +5 -0
  140. package/src/crews/dev-batches/domain/messages.ts +6 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  142. package/src/crews/dev-change/application/change-material.ts +44 -0
  143. package/src/crews/dev-change/application/evidence.ts +25 -22
  144. package/src/crews/dev-change/application/messages.ts +81 -0
  145. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  146. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  147. package/src/crews/dev-change/crew.ork.ts +11 -9
  148. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  149. package/src/crews/dev-change/domain/change-render.ts +13 -15
  150. package/src/crews/dev-change/domain/markers.ts +28 -0
  151. package/src/crews/dev-change/domain/messages.ts +16 -0
  152. package/src/crews/dev-implement/application/close.ts +21 -18
  153. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  154. package/src/crews/dev-implement/application/messages.ts +161 -0
  155. package/src/crews/dev-implement/application/observe.ts +4 -2
  156. package/src/crews/dev-implement/application/prompts.ts +9 -0
  157. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  158. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  159. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  160. package/src/crews/dev-implement/crew.ork.ts +2 -1
  161. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  162. package/src/crews/dev-implement/domain/correction.ts +16 -15
  163. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  164. package/src/crews/dev-implement/domain/markers.ts +23 -0
  165. package/src/crews/dev-implement/domain/messages.ts +58 -0
  166. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  167. package/src/crews/dev-implement/domain/roles.ts +3 -7
  168. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  169. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  170. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  171. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  172. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  173. package/src/crews/dev-learn/application/messages.ts +51 -0
  174. package/src/crews/dev-learn/application/{learn-prompt.ts → prompts.ts} +24 -65
  175. package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
  176. package/src/crews/dev-learn/crew.ork.ts +4 -3
  177. package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
  178. package/src/crews/dev-learn/domain/messages.ts +65 -0
  179. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  180. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  181. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  182. package/src/crews/dev-plan/application/inventory.ts +17 -13
  183. package/src/crews/dev-plan/application/messages.ts +88 -0
  184. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  185. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  186. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  187. package/src/crews/dev-plan/crew.ork.ts +11 -8
  188. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  189. package/src/crews/dev-plan/domain/markers.ts +18 -0
  190. package/src/crews/dev-plan/domain/messages.ts +118 -0
  191. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  192. package/src/crews/dev-plan/domain/plan-render.ts +30 -31
  193. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  194. package/src/crews/dev-spec/application/messages.ts +30 -0
  195. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  196. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  197. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  198. package/src/crews/dev-spec/crew.ork.ts +11 -9
  199. package/src/crews/dev-spec/domain/markers.ts +30 -0
  200. package/src/crews/dev-spec/domain/messages.ts +39 -0
  201. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  202. package/src/crews/dev-spec/domain/spec-render.ts +18 -18
  203. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  204. package/src/crews/dev-verify/application/audit.ts +38 -30
  205. package/src/crews/dev-verify/application/capture.ts +34 -26
  206. package/src/crews/dev-verify/application/messages.ts +119 -0
  207. package/src/crews/dev-verify/application/prompts.ts +209 -0
  208. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  209. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  210. package/src/crews/dev-verify/crew.ork.ts +6 -6
  211. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  212. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  213. package/src/crews/dev-verify/domain/commands.ts +3 -3
  214. package/src/crews/dev-verify/domain/gate.ts +21 -16
  215. package/src/crews/dev-verify/domain/markers.ts +16 -0
  216. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  217. package/src/crews/dev-verify/domain/messages.ts +92 -0
  218. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  219. package/src/crews/git-commit/application/draft.ts +16 -37
  220. package/src/crews/git-commit/application/messages.ts +15 -0
  221. package/src/crews/git-commit/application/prompts.ts +47 -0
  222. package/src/crews/git-commit/application/run-git-commit.ts +13 -12
  223. package/src/crews/git-commit/crew.ork.ts +5 -4
  224. package/src/crews/git-commit/domain/commit.ts +15 -35
  225. package/src/crews/git-commit/domain/markers.ts +4 -0
  226. package/src/crews/git-commit/domain/messages.ts +48 -0
  227. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  228. package/src/crews/init-verifiers/application/messages.ts +13 -0
  229. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  230. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  231. package/src/crews/init-verifiers/crew.ork.ts +5 -4
  232. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  233. package/src/crews/main-loop/application/messages.ts +81 -0
  234. package/src/crews/main-loop/application/prompts.ts +12 -0
  235. package/src/crews/main-loop/application/run-main-loop.ts +63 -30
  236. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  237. package/src/crews/main-loop/crew.ork.ts +12 -7
  238. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  239. package/src/crews/main-loop/domain/prompts.ts +336 -0
  240. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  241. package/src/crews/project-init/application/detect.ts +5 -4
  242. package/src/crews/project-init/application/messages.ts +15 -0
  243. package/src/crews/project-init/application/prompts.ts +11 -7
  244. package/src/crews/project-init/crew.ork.ts +5 -4
  245. package/src/crews/project-init/domain/existing-files.ts +6 -4
  246. package/src/crews/project-init/domain/messages.ts +13 -0
  247. package/src/crews/project-init/domain/package-map.ts +3 -3
  248. package/src/crews/project-init/domain/prompts.ts +10 -0
  249. package/src/crews/session-compact/application/prompts.ts +5 -0
  250. package/src/crews/session-compact/crew.ork.ts +5 -4
  251. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  252. package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
  253. package/src/crews/speech/application/messages.ts +3 -0
  254. package/src/crews/speech/application/prompts.ts +3 -0
  255. package/src/crews/speech/application/run-speech.ts +2 -1
  256. package/src/crews/speech/crew.ork.ts +2 -1
  257. package/src/shared/application/agents/child-agent.ts +11 -7
  258. package/src/shared/application/agents/messages.ts +35 -0
  259. package/src/shared/application/agents/route-agent.ts +115 -0
  260. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  261. package/src/shared/application/compaction/compact-session.ts +19 -14
  262. package/src/shared/application/compaction/messages.ts +20 -0
  263. package/src/shared/application/compaction/prune-context.ts +94 -0
  264. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  265. package/src/shared/application/dev/brief-inventory.ts +6 -4
  266. package/src/shared/application/dev/close-batch.ts +9 -7
  267. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  268. package/src/shared/application/dev/learn-decision.ts +20 -18
  269. package/src/shared/application/dev/load-dev-context.ts +7 -8
  270. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  271. package/src/shared/application/dev/messages.ts +132 -0
  272. package/src/shared/application/dev/phase-timer.ts +54 -0
  273. package/src/shared/application/dev/plan-source.ts +12 -8
  274. package/src/shared/application/dev/preflight.ts +8 -8
  275. package/src/shared/application/dev/prompts.ts +34 -0
  276. package/src/shared/application/dev/question-round.ts +25 -17
  277. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  278. package/src/shared/application/dev/settle-questions.ts +4 -2
  279. package/src/shared/application/dev/source-review.ts +12 -8
  280. package/src/shared/application/dev/source-step.ts +12 -10
  281. package/src/shared/application/dev/spend.ts +17 -4
  282. package/src/shared/application/dev/step-precedents.ts +2 -1
  283. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  284. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  285. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  286. package/src/shared/application/dev/verdict-sources.ts +5 -3
  287. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  288. package/src/shared/application/extra-tools.ts +2 -1
  289. package/src/shared/application/git/batch-worktree.ts +22 -17
  290. package/src/shared/application/git/commit-files.ts +24 -19
  291. package/src/shared/application/git/merge-batch.ts +11 -7
  292. package/src/shared/application/git/messages.ts +75 -0
  293. package/src/shared/application/git/open-pull-request.ts +4 -3
  294. package/src/shared/application/host-context.ts +59 -0
  295. package/src/shared/application/host-layout-store.ts +45 -0
  296. package/src/shared/application/llm-profile.ts +4 -3
  297. package/src/shared/application/messages.ts +14 -0
  298. package/src/shared/application/permission-rules.ts +10 -0
  299. package/src/shared/application/ports/decision.ts +14 -0
  300. package/src/shared/application/ports/human.ts +25 -0
  301. package/src/shared/application/ports/llm.ts +32 -3
  302. package/src/shared/application/ports/memory.ts +1 -1
  303. package/src/shared/application/ports/theme.ts +11 -0
  304. package/src/shared/application/ports.ts +4 -2
  305. package/src/shared/application/session-io.ts +2 -1
  306. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  307. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  308. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  309. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  310. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  311. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  312. package/src/shared/application/shared-memory/messages.ts +63 -0
  313. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  314. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  315. package/src/shared/application/skills/messages.ts +4 -0
  316. package/src/shared/application/skills/suggest-skills.ts +102 -0
  317. package/src/shared/application/workflow/messages.ts +8 -0
  318. package/src/shared/application/workflow/workflow-state.ts +7 -6
  319. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  320. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  321. package/src/shared/domain/agent-policy/messages.ts +66 -0
  322. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  323. package/src/shared/domain/agent-policy/permission.ts +20 -18
  324. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  325. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  326. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  327. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  328. package/src/shared/domain/agent-registry.ts +6 -5
  329. package/src/shared/domain/agents/chain.ts +2 -2
  330. package/src/shared/domain/agents/charter.ts +8 -5
  331. package/src/shared/domain/agents/exclusive.ts +2 -1
  332. package/src/shared/domain/agents/instances.ts +18 -15
  333. package/src/shared/domain/agents/messages.ts +39 -0
  334. package/src/shared/domain/agents/model-route.ts +199 -0
  335. package/src/shared/domain/agents/prompts.ts +20 -0
  336. package/src/shared/domain/code-intel-contract.ts +5 -4
  337. package/src/shared/domain/code-intel-routing.ts +8 -61
  338. package/src/shared/domain/compact-outcome.ts +5 -3
  339. package/src/shared/domain/compaction-thresholds.ts +2 -1
  340. package/src/shared/domain/compaction.ts +22 -113
  341. package/src/shared/domain/config-schema.ts +94 -81
  342. package/src/shared/domain/context-prune.ts +176 -0
  343. package/src/shared/domain/decision/questions.ts +102 -0
  344. package/src/shared/domain/dev/access-cost.ts +19 -15
  345. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  346. package/src/shared/domain/dev/build-commands.ts +5 -4
  347. package/src/shared/domain/dev/call-guard.ts +29 -28
  348. package/src/shared/domain/dev/carried-text.ts +3 -5
  349. package/src/shared/domain/dev/learn-proposals.ts +5 -4
  350. package/src/shared/domain/dev/learn-state.ts +3 -2
  351. package/src/shared/domain/dev/markers.ts +107 -0
  352. package/src/shared/domain/dev/messages.ts +259 -0
  353. package/src/shared/domain/dev/phase-timing.ts +50 -0
  354. package/src/shared/domain/dev/plan-checks.ts +24 -23
  355. package/src/shared/domain/dev/plan-format.ts +14 -24
  356. package/src/shared/domain/dev/project-files.ts +1 -15
  357. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  358. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  359. package/src/shared/domain/dev/questions.ts +33 -15
  360. package/src/shared/domain/dev/repo-pack.ts +12 -9
  361. package/src/shared/domain/dev/review-answer.ts +40 -17
  362. package/src/shared/domain/dev/review-brief.ts +54 -0
  363. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  364. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  365. package/src/shared/domain/dev/spec-format.ts +13 -14
  366. package/src/shared/domain/dev/step-budget.ts +4 -2
  367. package/src/shared/domain/dev/step-rules.ts +3 -4
  368. package/src/shared/domain/dev/test-commands.ts +14 -10
  369. package/src/shared/domain/dev/tool-guards.ts +4 -3
  370. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  371. package/src/shared/domain/dev/verdict-format.ts +14 -21
  372. package/src/shared/domain/dev/whitespace.ts +3 -2
  373. package/src/shared/domain/dev/work-folder.ts +4 -3
  374. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  375. package/src/shared/domain/error-text.ts +13 -0
  376. package/src/shared/domain/git/close.ts +5 -4
  377. package/src/shared/domain/git/messages.ts +20 -0
  378. package/src/shared/domain/git/pull-request.ts +5 -5
  379. package/src/shared/domain/host-layout.ts +147 -0
  380. package/src/shared/domain/host-paths.ts +399 -0
  381. package/src/shared/domain/llm-failure.ts +35 -7
  382. package/src/shared/domain/llm-profile.ts +22 -3
  383. package/src/shared/domain/marked-message.ts +1 -5
  384. package/src/shared/domain/markers.ts +30 -0
  385. package/src/shared/domain/messages.ts +291 -0
  386. package/src/shared/domain/model-catalog.ts +2 -9
  387. package/src/shared/domain/permission-modes.ts +4 -8
  388. package/src/shared/domain/prelude.ts +2 -2
  389. package/src/shared/domain/project-manifests.ts +3 -2
  390. package/src/shared/domain/prompts.ts +233 -0
  391. package/src/shared/domain/search-routing.ts +3 -11
  392. package/src/shared/domain/secret-patterns.ts +3 -2
  393. package/src/shared/domain/session-keys.ts +7 -0
  394. package/src/shared/domain/session-start.ts +3 -2
  395. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  396. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  397. package/src/shared/domain/shared-memory/entry.ts +26 -20
  398. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  399. package/src/shared/domain/shared-memory/gate.ts +4 -3
  400. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  401. package/src/shared/domain/shared-memory/layout.ts +11 -8
  402. package/src/shared/domain/shared-memory/markers.ts +9 -0
  403. package/src/shared/domain/shared-memory/messages.ts +66 -0
  404. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  405. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  406. package/src/shared/domain/shared-memory/refused.ts +3 -3
  407. package/src/shared/domain/skills/prompts.ts +4 -0
  408. package/src/shared/domain/skills/shortlist.ts +149 -0
  409. package/src/shared/domain/snip-turns.ts +2 -14
  410. package/src/shared/domain/speech.ts +2 -1
  411. package/src/shared/domain/tool-trace.ts +5 -7
  412. package/src/shared/domain/verifiers.ts +7 -11
  413. package/src/shared/domain/vfs.ts +8 -1
  414. package/src/shared/domain/workflow/prompts.ts +15 -0
  415. package/src/shared/domain/workflow/state-file.ts +14 -12
  416. package/src/shared/infrastructure/globals.ts +7 -2
  417. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  418. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  419. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  420. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  421. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  422. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  423. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  424. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  425. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  426. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  427. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  428. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  429. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  430. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  431. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  432. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  433. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  434. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  435. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  436. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  437. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  438. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  439. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  440. package/src/shared/domain/session-summary.ts +0 -13
@@ -0,0 +1,187 @@
1
+ // The auditor's brief, follow-up and answer prompt, assembled: the sheet and the capture carried while they fit
2
+ // MAX_BRIEF_CHARS, the rows of the first answer fitted to the follow-up, the reply cut keeping its end. The wording
3
+ // is in ./prompts.ts.
4
+
5
+ import type { AuditAnswer, AuditRow } from "../domain/audit-answer.ts";
6
+ import { cut } from "../domain/text.ts";
7
+ import { MAX_BRIEF_CHARS } from "../../../shared/domain/agents/charter.ts";
8
+ import { projectFileLines } from "../../../shared/domain/dev/project-files.ts";
9
+ import { earlierTextCut } from "../../../shared/domain/dev/prompts.ts";
10
+ import {
11
+ NO_ROWS_LINE, THE_CAPTURE_FOLDER, auditAnswerPrompt, auditRowLine, auditScopeLines, captureFilesToReadLines,
12
+ captureInBriefLines, captureLeftToReadLines, captureTextBlock, fastSuiteLines, firstAnswerLines, mechanicalTableLines,
13
+ previousGapsLines, rowsLeftOutLine, sheetInBriefLines, undecidedLine, validationCommandLines, validationReportSection,
14
+ validationReportsLines, validationsNamedLine,
15
+ } from "./prompts.ts";
16
+
17
+ /** One capture file and its text. */
18
+ export interface CaptureText {
19
+ path: string;
20
+ text: string;
21
+ }
22
+
23
+ /** The most capture text the brief carries; a file past it stays to read. */
24
+ export const INLINE_CAPTURE_CHARS = 12_000;
25
+
26
+ /** The most sheet text the brief carries; a longer sheet stays to read. */
27
+ export const INLINE_SHEET_CHARS = 6_000;
28
+ /** What the brief keeps free under MAX_BRIEF_CHARS once the capture is in. */
29
+ const BRIEF_MARGIN = 200;
30
+ /** The capture files the brief stands for once every other one is in it: the index, the manifest, the table. */
31
+ const CAPTURE_FRAME = /\/(?:index\.txt|manifest\.txt|table\.md)$/;
32
+
33
+ export interface AuditBriefInput {
34
+ mode: "fast" | "full" | "resume";
35
+ batch: string;
36
+ sheetPath: string;
37
+ /** The sheet's text, carried in the brief while it fits INLINE_SHEET_CHARS; absent or longer: read from sheetPath. */
38
+ sheetText?: string;
39
+ captureFiles: readonly string[];
40
+ /** The project's files (tracked and untracked, the work folder left out), listed so that the auditor guesses no
41
+ * name; absent or empty: no list. */
42
+ projectFiles?: readonly string[];
43
+ /** The capture files' texts, table.md aside (the brief carries the table): each goes in the brief while it has
44
+ * room, the rest stay to read. Absent: every capture file is to read. */
45
+ captureTexts?: readonly CaptureText[];
46
+ table: string;
47
+ appliedRules: string;
48
+ commands: { testClass?: string; testProject?: string; testIntegration?: string };
49
+ previousGaps: readonly AuditRow[] | null;
50
+ /** Under full: the whole fast suite as code ran it, before the audit. */
51
+ suite?: { command: string; outcome: string; tail: string };
52
+ /** The "## Precedents" block the step recalled (T4: mistakes whose signal to check), "" or absent when none. */
53
+ precedents?: string;
54
+ }
55
+
56
+ const scopeLines = (input: AuditBriefInput): string[] =>
57
+ auditScopeLines(input.batch, input.mode, input.sheetPath, input.appliedRules);
58
+
59
+ function projectLines({ projectFiles }: AuditBriefInput): string[] {
60
+ const lines = projectFileLines(projectFiles ?? []);
61
+ return lines.length === 0 ? [] : ["", ...lines];
62
+ }
63
+
64
+ const suiteLines = ({ suite }: AuditBriefInput): string[] => (suite === undefined ? [] : fastSuiteLines(suite));
65
+
66
+ function previousLines(input: AuditBriefInput, line: (row: AuditRow) => string): string[] {
67
+ if (input.mode !== "resume") return [];
68
+ return previousGapsLines((input.previousGaps ?? []).map(line));
69
+ }
70
+
71
+ function precedentLines({ precedents }: AuditBriefInput): string[] {
72
+ const block = (precedents ?? "").trimEnd();
73
+ return block === "" ? [] : ["", block];
74
+ }
75
+
76
+ /** The capture as the brief carries it: each text while there is room, then the files left to read. */
77
+ function captureLines(input: AuditBriefInput, room: number): string[] {
78
+ if (input.captureTexts === undefined) return captureFilesToReadLines(input.captureFiles);
79
+ const blocks: string[] = [];
80
+ const carried = new Set<string>();
81
+ let left = Math.min(INLINE_CAPTURE_CHARS, room);
82
+ for (const { path, text } of input.captureTexts) {
83
+ const block = captureTextBlock(path.slice(path.lastIndexOf("/") + 1), text);
84
+ if (block.length + 1 > left) continue;
85
+ blocks.push(block);
86
+ carried.add(path);
87
+ left -= block.length + 1;
88
+ }
89
+ const toRead = input.captureFiles.filter((path) => !carried.has(path));
90
+ const lines = blocks.length > 0 ? captureInBriefLines(blocks) : [];
91
+ if (toRead.some((path) => !CAPTURE_FRAME.test(path))) {
92
+ lines.push(...(lines.length > 0 ? [""] : []), ...captureLeftToReadLines(toRead));
93
+ }
94
+ return lines;
95
+ }
96
+
97
+ /** The sheet as the brief carries it, or nothing (left to read from its path). */
98
+ function sheetLines(input: AuditBriefInput, room: number): string[] {
99
+ const text = input.sheetText?.trimEnd() ?? "";
100
+ if (text === "" || text.length > Math.min(INLINE_SHEET_CHARS, room)) return [];
101
+ return sheetInBriefLines(text);
102
+ }
103
+
104
+ export function buildAuditBrief(input: AuditBriefInput): string {
105
+ const rest = [
106
+ "",
107
+ ...validationCommandLines(input.commands),
108
+ ...suiteLines(input),
109
+ ...previousLines(input, auditRowLine),
110
+ ...precedentLines(input),
111
+ ...mechanicalTableLines(input.table.trimEnd()),
112
+ ];
113
+ const head = [...scopeLines(input), ...projectLines(input)];
114
+ const sheet = sheetLines(input, MAX_BRIEF_CHARS - BRIEF_MARGIN - [...head, "", ...rest].join("\n").length);
115
+ const room = MAX_BRIEF_CHARS - BRIEF_MARGIN - [...head, "", ...sheet, ...rest].join("\n").length;
116
+ return [...head, "", ...sheet, ...captureLines(input, room), ...rest].join("\n");
117
+ }
118
+
119
+ export interface ValidationReport {
120
+ command: string;
121
+ /** "exit 0", "exit 1", "timed out after 300 s", "refused: <reason>", "not run: <reason>". */
122
+ outcome: string;
123
+ /** At most 15 lines and 1 500 characters of the output, stderr after stdout. */
124
+ tail: string;
125
+ }
126
+
127
+ /** The follow-up's caps: one row of the first answer, one report's tail, room kept for the closing lines. */
128
+ const FOLLOW_UP_ROW_CHARS = 240;
129
+ const FOLLOW_UP_TAIL_CHARS = 800;
130
+ const FOLLOW_UP_MARGIN = 200;
131
+
132
+ function folderOf(path: string): string {
133
+ const slash = path.lastIndexOf("/");
134
+ return slash > 0 ? path.slice(0, slash) : ".";
135
+ }
136
+
137
+ /** A report's output, cut to its last FOLLOW_UP_TAIL_CHARS characters. */
138
+ function cutTail(tail: string): string {
139
+ const text = tail.trimEnd();
140
+ return text.length > FOLLOW_UP_TAIL_CHARS ? `…${text.slice(1 - FOLLOW_UP_TAIL_CHARS)}` : text;
141
+ }
142
+
143
+ /**
144
+ * The second brief: the first one without the capture index and the table (named by their
145
+ * folder), the first answer with each row cut, and each report with its tail cut. Rows that
146
+ * would take it past MAX_BRIEF_CHARS are left out and counted.
147
+ */
148
+ export function buildValidationFollowUp(input: AuditBriefInput, first: AuditAnswer, reports: readonly ValidationReport[]): string {
149
+ const capped = (row: AuditRow): string => cut(auditRowLine(row), FOLLOW_UP_ROW_CHARS);
150
+ const folder = input.captureFiles.length > 0 ? folderOf(input.captureFiles[0]) : THE_CAPTURE_FOLDER;
151
+ const head = [
152
+ ...scopeLines(input),
153
+ "",
154
+ ...validationCommandLines(input.commands),
155
+ ...suiteLines(input),
156
+ ...previousLines(input, capped),
157
+ ...firstAnswerLines(folder, first.verdict),
158
+ ];
159
+ const sections = reports.map((r) => validationReportSection(r.command, r.outcome, cutTail(r.tail)));
160
+ const tail = [
161
+ validationsNamedLine(first.validations.map((v) => cut(v, FOLLOW_UP_ROW_CHARS))),
162
+ ...first.undecided.map((u) => cut(undecidedLine(u.check, u.reason), FOLLOW_UP_ROW_CHARS)),
163
+ ...validationReportsLines(sections),
164
+ ];
165
+ let room = MAX_BRIEF_CHARS - FOLLOW_UP_MARGIN - head.join("\n").length - tail.join("\n").length;
166
+ const rows: string[] = [];
167
+ for (const [i, row] of first.rows.entries()) {
168
+ const line = ` ${capped(row)}`;
169
+ if (line.length + 1 > room) {
170
+ rows.push(rowsLeftOutLine(first.rows.length - i));
171
+ break;
172
+ }
173
+ rows.push(line);
174
+ room -= line.length + 1;
175
+ }
176
+ if (first.rows.length === 0) rows.push(NO_ROWS_LINE);
177
+ return [...head, ...rows, ...tail].join("\n");
178
+ }
179
+
180
+ const MAX_REPLY_CHARS_IN_ANSWER_PROMPT = 12_000;
181
+
182
+ export function buildAnswerPrompt(reply: string, problems: readonly string[]): string {
183
+ const text = reply.length > MAX_REPLY_CHARS_IN_ANSWER_PROMPT
184
+ ? earlierTextCut(reply.slice(-MAX_REPLY_CHARS_IN_ANSWER_PROMPT))
185
+ : reply;
186
+ return auditAnswerPrompt(text, problems);
187
+ }
@@ -7,6 +7,7 @@
7
7
  // budget stopped also returns the validations made before, for the verdict the caller writes.
8
8
  import type { Files, Llm, Shell } from "../../../shared/application/ports.ts";
9
9
  import { runSubAgent } from "../../../shared/application/agents/run-sub-agent.ts";
10
+ import type { ActRoute } from "../../../shared/application/agents/route-agent.ts";
10
11
  import type { SubAgentOutcome } from "../../../shared/application/agents/run-sub-agent.ts";
11
12
  import type { RepoPackCommands } from "../../../shared/domain/dev/repo-pack.ts";
12
13
  import type { AuditAnswer, AuditRow } from "../domain/audit-answer.ts";
@@ -19,8 +20,15 @@ import { readBudgetExhausted } from "../../../shared/domain/dev/step-budget.ts";
19
20
  import { checkValidation, validationLine } from "../../../shared/domain/dev/test-commands.ts";
20
21
  import { firstLine } from "../domain/text.ts";
21
22
  import { undecidedNotRun } from "../domain/verdict.ts";
22
- import type { AuditBriefInput, ValidationReport } from "./auditor-prompt.ts";
23
- import { AUDITOR_SYSTEM, buildAnswerPrompt, buildAuditBrief, buildValidationFollowUp } from "./auditor-prompt.ts";
23
+ import type { AuditBriefInput, ValidationReport } from "./audit-brief.ts";
24
+ import { AUDITOR_SYSTEM } from "./prompts.ts";
25
+ import { buildAnswerPrompt, buildAuditBrief, buildValidationFollowUp } from "./audit-brief.ts";
26
+ import { timedOutAfter } from "../domain/messages.ts";
27
+ import {
28
+ blockedBudgetSpent, blockedCancelled, blockedModelFailed, blockedOther, blockedUnparsable, blockedUnwritable, failedCount,
29
+ MAKE_VALIDATION_PASS, namedAfterValidations, NO_PROBLEM_RECORDED, noVerdictWritten, notRunLine, notRunOutcome,
30
+ refusedOutcome, runByTheAudit, validationRed, validationsAlreadyRan,
31
+ } from "./messages.ts";
24
32
 
25
33
  const VALIDATION_TIMEOUT_SECONDS = 300;
26
34
 
@@ -52,8 +60,8 @@ export function recordingRunner(inner: ValidationRunner): RecordingRunner {
52
60
  if (earlier !== undefined) return earlier;
53
61
  let run: ValidationRun;
54
62
  if (ran >= MAX_VALIDATIONS) {
55
- const outcome = `refused: ${MAX_VALIDATIONS} validations already ran in this audit`;
56
- run = { report: { command, outcome, tail: "" }, line: null, notRun: `\`${command}\` — ${outcome}` };
63
+ const outcome = validationsAlreadyRan(MAX_VALIDATIONS);
64
+ run = { report: { command, outcome, tail: "" }, line: null, notRun: notRunLine(command, outcome) };
57
65
  } else {
58
66
  ran += 1; // held while the command runs; given back when the inner runner refused it
59
67
  run = await inner.run(command);
@@ -81,20 +89,20 @@ export function shellValidationRunner(
81
89
  const check = checkValidation(cmd, commands);
82
90
  const reason = check.ok ? runGuards([ruleGuard], check.command) : check.reason;
83
91
  if (!check.ok || reason !== null) {
84
- const outcome = `refused: ${reason}`;
85
- return { report: { command: cmd, outcome, tail: "" }, line: null, notRun: `\`${cmd}\` — ${outcome}` };
92
+ const outcome = refusedOutcome(reason);
93
+ return { report: { command: cmd, outcome, tail: "" }, line: null, notRun: notRunLine(cmd, outcome) };
86
94
  }
87
95
  let result;
88
96
  try {
89
97
  result = await shell.run(check.command, { timeoutSeconds: VALIDATION_TIMEOUT_SECONDS });
90
98
  } catch (error) {
91
- const outcome = `not run: ${reasonOf(error)}`;
92
- return { report: { command: cmd, outcome, tail: "" }, line: null, notRun: `\`${cmd}\` — ${outcome}` };
99
+ const outcome = notRunOutcome(reasonOf(error));
100
+ return { report: { command: cmd, outcome, tail: "" }, line: null, notRun: notRunLine(cmd, outcome) };
93
101
  }
94
102
  const tail = outputTail(result.stdout, result.stderr);
95
103
  if (result.timedOut === true) {
96
- const outcome = `timed out after ${VALIDATION_TIMEOUT_SECONDS} s`;
97
- return { report: { command: cmd, outcome, tail }, line: null, notRun: `\`${cmd}\` — ${outcome}` };
104
+ const outcome = timedOutAfter(VALIDATION_TIMEOUT_SECONDS);
105
+ return { report: { command: cmd, outcome, tail }, line: null, notRun: notRunLine(cmd, outcome) };
98
106
  }
99
107
  const summary = testRunSummary(tail.split("\n"));
100
108
  const tests = summary.passed === null && summary.failed === null ? null : (summary.passed ?? 0) + (summary.failed ?? 0);
@@ -128,24 +136,25 @@ export function redRunRows(runs: readonly ValidationRun[]): AuditRow[] {
128
136
  if (exit === null) continue; // refused, not run or timed out: a Not run line already says so
129
137
  const failed = testRunSummary(report.tail.split("\n")).failed ?? 0;
130
138
  if (exit[1] === "0" && failed === 0) continue;
131
- const counted = failed > 0 ? `, ${failed} failed` : "";
139
+ const counted = failed > 0 ? failedCount(failed) : "";
132
140
  rows.push({
133
141
  severity: "Blocking", axis: "Test",
134
- gap: `a validation is red: ${report.outcome}${counted}`,
135
- evidence: `\`${report.command}\` ${report.outcome}${counted}, run by the audit`,
136
- fix: "make the validation pass",
142
+ gap: validationRed(report.outcome, counted),
143
+ evidence: runByTheAudit(report.command, report.outcome, counted),
144
+ fix: MAKE_VALIDATION_PASS,
137
145
  });
138
146
  }
139
147
  return rows;
140
148
  }
141
149
 
142
- type Deps = { llm: Pick<Llm, "act" | "extract">; files: Pick<Files, "write">; runner: ValidationRunner };
150
+ /** The audit's ports; `route`, when given, routes each act of the auditor (route-agent.ts actRoute). */
151
+ type Deps = { llm: Pick<Llm, "act" | "extract">; files: Pick<Files, "write">; runner: ValidationRunner; route?: ActRoute };
143
152
 
144
- function ask(llm: Pick<Llm, "act" | "extract">, brief: string): Promise<SubAgentOutcome<AuditAnswer>> {
153
+ function ask(llm: Pick<Llm, "act" | "extract">, brief: string, route: ActRoute | undefined): Promise<SubAgentOutcome<AuditAnswer>> {
145
154
  return runSubAgent(llm, {
146
155
  charter: AUDITOR_CHARTER, system: AUDITOR_SYSTEM, brief,
147
156
  schema: AUDIT_ANSWER_SCHEMA, answerPrompt: buildAnswerPrompt, check: checkAuditAnswer,
148
- });
157
+ }, route);
149
158
  }
150
159
 
151
160
  async function blocked(
@@ -156,14 +165,13 @@ async function blocked(
156
165
  try {
157
166
  await files.write(`${captureFolder}/${name}`, `${outcome.reply.trimEnd()}\n--- problems\n${outcome.problems.join("\n")}\n`);
158
167
  } catch (error) {
159
- return { ok: false, text: `dev-verify: BLOCKED — ${captureShown}/${name} cannot be written (${reasonOf(error)})` };
168
+ return { ok: false, text: blockedUnwritable(`${captureShown}/${name}`, reasonOf(error)) };
160
169
  }
161
- const first = outcome.problems[0] ?? "no problem recorded";
170
+ const first = outcome.problems[0] ?? NO_PROBLEM_RECORDED;
162
171
  if (outcome.reason === "unparsable") {
163
172
  return {
164
173
  ok: false,
165
- text: `dev-verify: BLOCKED — the auditor's answer did not parse after one re-ask (${first}): ` +
166
- `its replies are in ${captureShown}/${name}; no verdict written`,
174
+ text: blockedUnparsable(first, `${captureShown}/${name}`),
167
175
  };
168
176
  }
169
177
  const spent = outcome.reason === "model-failed" ? readBudgetExhausted(first) : null;
@@ -171,27 +179,27 @@ async function blocked(
171
179
  // The runs made before the budget ran out stand: the caller writes a verdict that says the audit did not finish.
172
180
  if (runs.length > 0) {
173
181
  const failed = await writeValidations(files, runs, captureFolder, captureShown);
174
- if (failed !== null) return { ok: false, text: `${failed}; no verdict written` };
182
+ if (failed !== null) return { ok: false, text: noVerdictWritten(failed) };
175
183
  }
176
184
  return {
177
185
  ok: false,
178
- text: `dev-verify: BLOCKED — the step's budget is spent (${spent}: ${first}): the capture stays in ${captureShown}/`,
186
+ text: blockedBudgetSpent(spent, first, captureShown),
179
187
  unfinished: { reason: `${spent}: ${first}`, validations: linesOf(runs), notRun: notRunsOf(runs) },
180
188
  };
181
189
  }
182
190
  if (outcome.reason === "cancelled") {
183
191
  return {
184
192
  ok: false,
185
- text: `dev-verify: BLOCKED — the audit was cancelled (${first}): the capture stays in ${captureShown}/; no verdict written`,
193
+ text: blockedCancelled(first, captureShown),
186
194
  };
187
195
  }
188
196
  if (outcome.reason === "model-failed") {
189
197
  return {
190
198
  ok: false,
191
- text: `dev-verify: BLOCKED — the model call failed (${first}): the capture stays in ${captureShown}/; no verdict written`,
199
+ text: blockedModelFailed(first, captureShown),
192
200
  };
193
201
  }
194
- return { ok: false, text: `dev-verify: BLOCKED — ${first}; no verdict written` };
202
+ return { ok: false, text: blockedOther(first) };
195
203
  }
196
204
 
197
205
  /** The validations file: per command, `$ <command>`, the outcome, the tail. */
@@ -203,7 +211,7 @@ async function writeValidations(
203
211
  await files.write(`${captureFolder}/validations.txt`, `${log.join("\n\n")}\n`);
204
212
  return null;
205
213
  } catch (error) {
206
- return `dev-verify: BLOCKED — ${captureShown}/validations.txt cannot be written (${reasonOf(error)})`;
214
+ return blockedUnwritable(`${captureShown}/validations.txt`, reasonOf(error));
207
215
  }
208
216
  }
209
217
 
@@ -214,7 +222,7 @@ export async function runAudit(
214
222
  const ranAlready = (command: string) => runner.runs().some((r) => sameCommand(r.report.command, command));
215
223
 
216
224
  const text = buildAuditBrief(brief);
217
- const first = await ask(deps.llm, text);
225
+ const first = await ask(deps.llm, text, deps.route);
218
226
  if (!first.ok) return blocked(deps.files, first, captureFolder, captureShown, runner.runs());
219
227
  // The validations the answer names that the auditor did not run itself through run_validation.
220
228
  const pending = first.value.validations.slice(0, MAX_VALIDATIONS).filter((c) => !ranAlready(c));
@@ -236,7 +244,7 @@ export async function runAudit(
236
244
  const failed = await writeValidations(deps.files, runner.runs(), captureFolder, captureShown);
237
245
  if (failed !== null) return { ok: false, text: failed };
238
246
 
239
- const second = await ask(deps.llm, buildValidationFollowUp(brief, first.value, reports));
247
+ const second = await ask(deps.llm, buildValidationFollowUp(brief, first.value, reports), deps.route);
240
248
  if (!second.ok) return blocked(deps.files, second, captureFolder, captureShown, runner.runs());
241
249
  const answer = second.value;
242
250
  const runs = runner.runs();
@@ -247,7 +255,7 @@ export async function runAudit(
247
255
  }
248
256
  const late = answer.validations
249
257
  .filter((c) => !ranAlready(c))
250
- .map((c) => `\`${c}\` — named after the validations had run`);
258
+ .map((c) => namedAfterValidations(c));
251
259
  return {
252
260
  ok: true,
253
261
  answer,
@@ -12,16 +12,24 @@ import { measureAccessCost } from "../../../shared/application/dev/measure-acces
12
12
  import type { DevVerifyTarget, GateRun } from "./run-gate.ts";
13
13
  import { TREE_CODE_EXTENSIONS, extensionOf } from "../../../shared/domain/search-routing.ts";
14
14
  import type { BuildState, TableRow } from "../domain/mechanical-table.ts";
15
- import { CHECK_METHODS, mechanicalRows, renderTable } from "../domain/mechanical-table.ts";
15
+ import { mechanicalRows, renderTable } from "../domain/mechanical-table.ts";
16
+ import { CHECK_METHODS } from "../domain/markers.ts";
16
17
  import {
17
18
  MAX_CLASS_FILES, MAX_DIFF_FILES, TEST_TAIL_LINES, buildFailure, buildLogProblem, classesIn, diffBase, isTestFile,
18
19
  isTestRoot, splitSection, tailLines, testClassesLine, testRunSummary, traitsSection, typeNameOf,
19
20
  } from "../domain/capture-sections.ts";
20
21
  import type { TestRunSummary } from "../domain/capture-sections.ts";
21
22
  import {
22
- UNQUOTABLE_SCOPE, findNewer, gitDiffTracked, gitDiffUntracked, gitMethodGrep, gitStatusShort, gitTestFilesNaming,
23
+ findNewer, gitDiffTracked, gitDiffUntracked, gitMethodGrep, gitStatusShort, gitTestFilesNaming,
23
24
  } from "../domain/commands.ts";
25
+ import { UNQUOTABLE_SCOPE_REASON } from "../domain/messages.ts";
24
26
  import { WORKSPACE } from "../../../shared/domain/vfs.ts";
27
+ import {
28
+ BUILD_NOT_RUN, buildNotRunShellRefused, buildReusedLine, buildTimedOut, CANNOT_COMPARE_DATES, cannotCompareDates, captureTitle,
29
+ changedAfter, commandFailed, cutAtFiles, cutByRuntime, diffBeyondFirst, noDiffCaptured, diffQuoteInPath, LOG_HOLDS_ERROR,
30
+ logMissing, logNotReused, NO_CHANGED_FILE, NO_CHANGED_SOURCE, NO_TEST_ROOT_GIVEN, NOT_A_PLAIN_WORD, noTestLogEither,
31
+ testLogEmpty,
32
+ } from "./messages.ts";
25
33
 
26
34
  export const BUILD_TIMEOUT_SECONDS = 900;
27
35
 
@@ -48,7 +56,7 @@ function errorLine(error: unknown): string {
48
56
  }
49
57
 
50
58
  function notCaptured(command: string, error: unknown): string {
51
- return `not captured: '${command}' failed (${errorLine(error)})`;
59
+ return commandFailed(command, errorLine(error));
52
60
  }
53
61
 
54
62
 
@@ -103,20 +111,20 @@ async function diffs(deps: Deps, target: DevVerifyTarget, gate: GateRun): Promis
103
111
  const entries: DiffEntry[] = [];
104
112
  const changed = gate.changedFiles.filter((f) => !f.startsWith(`${target.planDirShown}/`));
105
113
  for (const [i, path] of changed.entries()) {
106
- if (i >= MAX_DIFF_FILES) { entries.push({ path, line: `${path} → no diff captured (beyond the first ${MAX_DIFF_FILES} files)`, added: null }); continue; }
114
+ if (i >= MAX_DIFF_FILES) { entries.push({ path, line: diffBeyondFirst(path, MAX_DIFF_FILES), added: null }); continue; }
107
115
  const command = gate.untrackedFiles.includes(path) ? gitDiffUntracked(path) : gitDiffTracked(path);
108
- if (command === null) { entries.push({ path, line: `${path} → no diff captured (a quote in the path)`, added: null }); continue; }
116
+ if (command === null) { entries.push({ path, line: diffQuoteInPath(path), added: null }); continue; }
109
117
  let raw: string;
110
118
  try {
111
119
  raw = (await deps.shell.run(command)).stdout;
112
120
  } catch (error) {
113
- entries.push({ path, line: `${path} → no diff captured ('${command}' failed (${errorLine(error)}))`, added: null });
121
+ entries.push({ path, line: noDiffCaptured(path, command, errorLine(error)), added: null });
114
122
  continue;
115
123
  }
116
124
  const { kept: stdout, omitted } = runtimeCut(raw);
117
125
  const base = diffBase(i + 1);
118
126
  const lines = lineCount(stdout);
119
- const doubt = omitted > 0 ? ` (cut by the runtime, ${omitted} characters omitted)` : "";
127
+ const doubt = omitted > 0 ? cutByRuntime(omitted) : "";
120
128
  entries.push({
121
129
  path, base,
122
130
  line: `${path} → ${base}.txt (${lines} lines)${doubt}`,
@@ -130,40 +138,40 @@ async function diffs(deps: Deps, target: DevVerifyTarget, gate: GateRun): Promis
130
138
 
131
139
  async function reuseProblem(deps: Deps, target: DevVerifyTarget, gate: GateRun, logShown: string): Promise<string | null> {
132
140
  const log = await readOrNull(deps.files, `${WORKSPACE}/${logShown}`);
133
- if (log === null || log === "") return `log missing or empty: ${logShown}`;
134
- if (buildLogProblem(log) !== null) return "the log holds an error";
141
+ if (log === null || log === "") return logMissing(logShown);
142
+ if (buildLogProblem(log) !== null) return LOG_HOLDS_ERROR;
135
143
  const paths = gate.changedFiles.filter((f) => !f.startsWith(`${target.planDirShown}/`));
136
144
  if (paths.length === 0) return null;
137
145
  const command = findNewer(paths, logShown);
138
- if (command === null) return "the shell cannot compare dates: more than 200 files, or a path the shell cannot quote";
146
+ if (command === null) return CANNOT_COMPARE_DATES;
139
147
  let newer: string[];
140
148
  try {
141
149
  newer = stdoutLines((await deps.shell.run(command)).stdout);
142
150
  } catch (error) {
143
- return `the shell cannot compare dates: ${errorLine(error)}`;
151
+ return cannotCompareDates(errorLine(error));
144
152
  }
145
- return newer.length === 0 ? null : `changed after it:${newer.map((p) => ` ${p.replace(/^\.\//, "")}`).join("")}`;
153
+ return newer.length === 0 ? null : changedAfter(newer.map((p) => ` ${p.replace(/^\.\//, "")}`).join(""));
146
154
  }
147
155
 
148
156
  async function buildSection(deps: Deps, target: DevVerifyTarget, gate: GateRun): Promise<{ content: string; state: BuildState }> {
149
157
  const build = target.pack?.commands.build;
150
158
  if (build === undefined || build.trim() === "") {
151
- return { content: text(["not run — the pack has no commands.build"]), state: { state: "none" } };
159
+ return { content: text([BUILD_NOT_RUN]), state: { state: "none" } };
152
160
  }
153
161
  const logShown = `${target.planDirShown}/logs/${target.batch}-build.txt`;
154
162
  const why = await reuseProblem(deps, target, gate, logShown);
155
163
  if (why === null) {
156
164
  return {
157
- content: text([`command: ${build}`, `exit: 0 (reused ${logShown}: ends green, no changed file newer — one build per batch)`]),
165
+ content: text([`command: ${build}`, buildReusedLine(logShown)]),
158
166
  state: { state: "reused", log: logShown },
159
167
  };
160
168
  }
161
- const head = [`log not reused (${why}): built again`, `command: ${build}`];
169
+ const head = [logNotReused(why), `command: ${build}`];
162
170
  try {
163
171
  const result = await deps.shell.run(build, { timeoutSeconds: BUILD_TIMEOUT_SECONDS });
164
172
  if (result.timedOut === true) {
165
173
  return {
166
- content: text([...head, `exit: none — timed out after ${BUILD_TIMEOUT_SECONDS} s`]),
174
+ content: text([...head, buildTimedOut(BUILD_TIMEOUT_SECONDS)]),
167
175
  state: { state: "timeout", seconds: BUILD_TIMEOUT_SECONDS },
168
176
  };
169
177
  }
@@ -177,7 +185,7 @@ async function buildSection(deps: Deps, target: DevVerifyTarget, gate: GateRun):
177
185
  };
178
186
  } catch (error) {
179
187
  const message = errorLine(error);
180
- return { content: text([...head, `not run — the shell refused it: ${message}`]), state: { state: "refused", message } };
188
+ return { content: text([...head, buildNotRunShellRefused(message)]), state: { state: "refused", message } };
181
189
  }
182
190
  }
183
191
 
@@ -192,8 +200,8 @@ async function testTail(deps: Deps, target: DevVerifyTarget): Promise<{ content:
192
200
  const tail = tailLines(content, TEST_TAIL_LINES);
193
201
  return { content: text([`file: ${shown}`, ...tail]), log: { name: basename(shown), summary: testRunSummary(tail) } };
194
202
  }
195
- if (empty !== null) return { content: text([`missing or empty: ${empty}`]), log: null };
196
- return { content: text([`no test log: neither ${candidates[0]} nor ${candidates[1]}`]), log: null };
203
+ if (empty !== null) return { content: text([testLogEmpty(empty)]), log: null };
204
+ return { content: text([noTestLogEither(candidates[0], candidates[1])]), log: null };
197
205
  }
198
206
 
199
207
  async function testClasses(deps: Deps, target: DevVerifyTarget, gate: GateRun, testRoots: readonly string[]): Promise<string> {
@@ -207,12 +215,12 @@ async function testClasses(deps: Deps, target: DevVerifyTarget, gate: GateRun, t
207
215
  if (test) {
208
216
  out.push(testClassesLine(path, classesIn(source), null));
209
217
  } else if (testRoots.length === 0) {
210
- out.push(testClassesLine(path, null, null, "no test root given"));
218
+ out.push(testClassesLine(path, null, null, NO_TEST_ROOT_GIVEN));
211
219
  } else {
212
220
  const ext = path.slice(path.lastIndexOf(".") + 1);
213
221
  const command = gitTestFilesNaming(typeNameOf(path), testRoots, ext, gate.excludes);
214
222
  if (command === null) {
215
- out.push(testClassesLine(path, null, null, "not searched (the name is not a plain word)"));
223
+ out.push(testClassesLine(path, null, null, NOT_A_PLAIN_WORD));
216
224
  } else {
217
225
  try {
218
226
  out.push(testClassesLine(path, null, stdoutLines((await deps.shell.run(command)).stdout).slice(0, TEST_FILES_SHOWN)));
@@ -222,9 +230,9 @@ async function testClasses(deps: Deps, target: DevVerifyTarget, gate: GateRun, t
222
230
  }
223
231
  }
224
232
  counted++;
225
- if (counted >= MAX_CLASS_FILES) { out.push(`[cut at ${MAX_CLASS_FILES} files]`); break; }
233
+ if (counted >= MAX_CLASS_FILES) { out.push(cutAtFiles(MAX_CLASS_FILES)); break; }
226
234
  }
227
- if (counted === 0) out.push("no changed source file");
235
+ if (counted === 0) out.push(NO_CHANGED_SOURCE);
228
236
  return text(out);
229
237
  }
230
238
 
@@ -233,7 +241,7 @@ async function methodHits(
233
241
  ): Promise<{ hits: string[] | null; failure: string | null }> {
234
242
  if (gate.facts.methods.length === 0 || testRoots.length === 0) return { hits: null, failure: null };
235
243
  const command = gitMethodGrep(gate.facts.methods, testRoots, gate.excludes);
236
- if (command === null) return { hits: null, failure: UNQUOTABLE_SCOPE };
244
+ if (command === null) return { hits: null, failure: UNQUOTABLE_SCOPE_REASON };
237
245
  try {
238
246
  return { hits: stdoutLines((await deps.shell.run(command)).stdout), failure: null };
239
247
  } catch (error) {
@@ -257,7 +265,7 @@ export async function writeCapture(deps: Deps, target: DevVerifyTarget, gate: Ga
257
265
  await writer.section("status", statusText);
258
266
 
259
267
  const entries = await diffs(deps, target, gate);
260
- await writer.section("changed-files", entries.length === 0 ? text(["no changed file"]) : text(entries.map((e) => e.line)));
268
+ await writer.section("changed-files", entries.length === 0 ? text([NO_CHANGED_FILE]) : text(entries.map((e) => e.line)));
261
269
  for (const e of entries) if (e.base !== undefined && e.content !== undefined) await writer.section(e.base, e.content);
262
270
 
263
271
  const build = await buildSection(deps, target, gate);
@@ -288,7 +296,7 @@ export async function writeCapture(deps: Deps, target: DevVerifyTarget, gate: Ga
288
296
  const manifest = text(["index.txt", "manifest.txt", ...writer.written.map((w) => w.name)]);
289
297
  await deps.files.write(`${folder}/manifest.txt`, manifest);
290
298
  const index = text([
291
- `# Audit capture — batch ${target.batch}`,
299
+ captureTitle(target.batch),
292
300
  `sheet: ${target.sheetShown}`,
293
301
  `generated: ${when}`,
294
302
  "gate: green",