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
@@ -5,6 +5,12 @@
5
5
  // The gate keeps the harness's own line test and adds a reading by the Severity column,
6
6
  // so it is never less strict than the harness.
7
7
  import type { FormatProblem } from "./plan-format.ts";
8
+ import {
9
+ BLOCKING_CELL, BRIEF_TITLE, ID_HEADING, MUST_NOT_CHANGE, OPEN_QUESTIONS_HEADING, SPEC_TITLE, STATEMENT,
10
+ } from "./markers.ts";
11
+ import {
12
+ blockingQuestionsOpen, BRIEF_TITLE_NAMES_NO_KIND, duplicatedId, idInChangeBrief, settleThemFirst,
13
+ } from "./messages.ts";
8
14
 
9
15
  export type SourceKind = "spec" | "change";
10
16
  export type ChangeKind = "bug" | "refactor" | "perf";
@@ -21,14 +27,7 @@ export interface PlanSource {
21
27
  problems: FormatProblem[];
22
28
  }
23
29
 
24
- const OPEN_QUESTIONS = /^## .*Open questions/;
25
- const MUST_NOT_CHANGE = /^## (\d+\. )?What must not change/;
26
- const BLOCKING_CELL = /\| *Blocking *\|/;
27
30
  const SEPARATOR_ROW = /^\|?[-: |]+$/;
28
- const ID_HEADING = /^#{3,4} (UC|BR|CH)-(\d+)\s*[—:-]\s*(.+)$/;
29
- const SPEC_TITLE = /^# (\S+) — (.+)$/;
30
- const BRIEF_TITLE = /^# (\S+) — (.+) — (bug|refactor|perf)\s*$/;
31
- const STATEMENT = "**Statement**";
32
31
  const MAX_STATEMENT = 200;
33
32
  const MAX_SHOWN_ROW = 200;
34
33
  const MAX_SHOWN_ROWS = 8;
@@ -72,7 +71,7 @@ function tableRows(section: ReadonlyArray<{ text: string; line: number }>): Tabl
72
71
  }
73
72
 
74
73
  function openQuestions(lines: readonly string[]): OpenQuestion[] {
75
- return tableRows(sectionLines(lines, OPEN_QUESTIONS)).map((r) => {
74
+ return tableRows(sectionLines(lines, OPEN_QUESTIONS_HEADING)).map((r) => {
76
75
  const column = r.header.indexOf("Severity");
77
76
  return { line: r.line, raw: r.text, severity: column >= 0 ? (r.cells[column] ?? "") : "", cells: r.cells };
78
77
  });
@@ -81,7 +80,7 @@ function openQuestions(lines: readonly string[]): OpenQuestion[] {
81
80
  /** The gate alone, run before any other read: the raw lines that stop a plan. */
82
81
  export function blockingRows(text: string): OpenQuestion[] {
83
82
  const lines = linesOf(text);
84
- const section = sectionLines(lines, OPEN_QUESTIONS);
83
+ const section = sectionLines(lines, OPEN_QUESTIONS_HEADING);
85
84
  const bySeverity = new Map<number, OpenQuestion>();
86
85
  for (const q of openQuestions(lines)) if (plain(q.severity).toLowerCase() === "blocking") bySeverity.set(q.line, q);
87
86
  const out: OpenQuestion[] = [];
@@ -118,9 +117,9 @@ function readIds(lines: readonly string[], kind: SourceKind, problems: FormatPro
118
117
  if (!m) return;
119
118
  const id = `${m[1]}-${m[2]}`;
120
119
  const line = i + 1;
121
- if (seen.has(id)) { problems.push({ line, message: `duplicated id ${id}` }); return; }
120
+ if (seen.has(id)) { problems.push({ line, message: duplicatedId(id) }); return; }
122
121
  seen.add(id);
123
- if (kind === "change" && m[1] !== "CH") { problems.push({ line, message: `${id} in a change brief` }); return; }
122
+ if (kind === "change" && m[1] !== "CH") { problems.push({ line, message: idInChangeBrief(id) }); return; }
124
123
  if (kind === "spec" && m[1] === "CH") return;
125
124
  ids.push({ id, title: m[3].trim(), statement: statementOf(lines, i + 1), line });
126
125
  });
@@ -161,7 +160,7 @@ export function parsePlanSource(text: string, kind: SourceKind): PlanSource {
161
160
  source.code = plainTitle[1]; source.name = plainTitle[2];
162
161
  }
163
162
  if (kind === "change" && !brief) {
164
- problems.push({ line: titleIndex + 1, message: "the brief's title names no kind (bug, refactor or perf)" });
163
+ problems.push({ line: titleIndex + 1, message: BRIEF_TITLE_NAMES_NO_KIND });
165
164
  }
166
165
  }
167
166
  source.ids = readIds(lines, kind, problems);
@@ -175,9 +174,9 @@ export function blockingStop(shown: string, kind: SourceKind, code: string, rows
175
174
  const shownRows = rows.slice(0, MAX_SHOWN_ROWS).map((r) => ` ${r.raw.trim().slice(0, MAX_SHOWN_ROW)}`);
176
175
  const more = rows.length > MAX_SHOWN_ROWS ? [` … ${rows.length - MAX_SHOWN_ROWS} more`] : [];
177
176
  return [
178
- `dev-plan: ${shown} has ${rows.length} open Blocking question(s); no plan is written.`,
177
+ blockingQuestionsOpen(shown, rows.length),
179
178
  ...shownRows,
180
179
  ...more,
181
- `→ Settle them first: ${settle} ${code}${kind === "change" ? " <its kind: bug, refactor or perf>" : ""}, or edit the file; then /dev-plan ${code}.`,
180
+ settleThemFirst(settle, code, kind === "change"),
182
181
  ].join("\n");
183
182
  }
@@ -4,7 +4,8 @@
4
4
  // a plain failure, only its message is left, and the runtime's messages name the dimension
5
5
  // (AgentExecutionBudget.cs). Pure.
6
6
 
7
- export type BudgetDimension = "toolCalls" | "delegationDepth" | "wallTime" | "tokens" | "spawnedAgents";
7
+ /** `cost` is the host's own budget (`Orkeon:CostTracking:DefaultCrewBudget`), no step sets it. */
8
+ export type BudgetDimension = "toolCalls" | "delegationDepth" | "wallTime" | "tokens" | "spawnedAgents" | "cost";
8
9
 
9
10
  export interface StepBudget {
10
11
  toolCalls: number;
@@ -48,7 +49,7 @@ export function repairBudget(step: keyof typeof STEP_BUDGETS): StepBudget {
48
49
  return { ...STEP_BUDGETS[step], delegationDepth: 0 };
49
50
  }
50
51
 
51
- const DIMENSIONS: readonly BudgetDimension[] = ["toolCalls", "delegationDepth", "wallTime", "tokens", "spawnedAgents"];
52
+ const DIMENSIONS: readonly BudgetDimension[] = ["toolCalls", "delegationDepth", "wallTime", "tokens", "spawnedAgents", "cost"];
52
53
 
53
54
  /** The runtime's messages, by dimension. */
54
55
  const MESSAGES: ReadonlyArray<[BudgetDimension, RegExp]> = [
@@ -57,6 +58,7 @@ const MESSAGES: ReadonlyArray<[BudgetDimension, RegExp]> = [
57
58
  ["wallTime", /wall time exceeded/i],
58
59
  ["delegationDepth", /delegation depth \d+ exceeds max/i],
59
60
  ["spawnedAgents", /exceeded \d+ spawned sub-agents/i],
61
+ ["cost", /cost budget spent/i],
60
62
  ];
61
63
 
62
64
  /** The dimension a spent budget names: the error's own `dimension`, else its message; null for any other failure. */
@@ -5,6 +5,7 @@ import { pathRules, patternWriteRules, rewriteRules, rulesOf } from "../agent-po
5
5
  import type { PathRules, RuleSetId } from "../agent-policy/rule-sets.ts";
6
6
  import type { PermissionRule } from "../agent-policy/permission.ts";
7
7
  import type { RepoPackLayout } from "./repo-pack.ts";
8
+ import { GATE_ONLY_HINT, gateIsOff } from "./messages.ts";
8
9
 
9
10
  /** A dev step whose crew runs a model under the gate and its callback. */
10
11
  export type DevStep = "dev-verify" | "dev-plan" | "dev-spec" | "dev-change" | "dev-implement";
@@ -100,11 +101,9 @@ export interface GateProblem { refuse: boolean; line: string }
100
101
  * command reports itself. */
101
102
  export function gateProblem(enabled: boolean | undefined, step: DevStep): GateProblem | null {
102
103
  if (enabled !== false) return null;
103
- const gateOnly = step === "dev-verify" ? " /dev-batches <code> F<n> --audit --gate-only runs no model and needs no gate." : "";
104
+ const gateOnly = step === "dev-verify" ? GATE_ONLY_HINT : "";
104
105
  return {
105
106
  refuse: true,
106
- line: `${step}: refused: the host's permission gate is off (${GATE_SETTING} is not true), so the step's rule ` +
107
- `sets and its read-only mode would check nothing. The launcher turns the gate on unless a settings file turns ` +
108
- `it off: remove that setting, restart the REPL and run /${stepCommand(step)} again.${gateOnly}`,
107
+ line: gateIsOff(step, GATE_SETTING, stepCommand(step), gateOnly),
109
108
  };
110
109
  }
@@ -3,6 +3,10 @@
3
3
  // one plain relative value and nothing appended - never the whole suite, never a build, never an
4
4
  // option or a shell operator. Pure.
5
5
  import type { RepoPackCommands } from "./repo-pack.ts";
6
+ import {
7
+ AS_THE_PACK_NAMES_IT, INTEGRATION_WITHOUT_FILTER, NOT_A_PACK_TEST_COMMAND, NOT_ONE_LINE, nothingMayFollow,
8
+ PACK_HAS_NO_TEST_COMMAND, SHELL_OPERATOR_OUTSIDE_QUOTES, validationLineText, valueHoldsDotDot, valueNotPlain,
9
+ } from "./messages.ts";
6
10
 
7
11
  export type ValidationCheck =
8
12
  | { ok: true; command: string; key: "commands.test_class" | "commands.test_project" | "commands.test_integration"; scope: string }
@@ -36,8 +40,8 @@ function templateSource(template: string): string {
36
40
 
37
41
  /** Why a placeholder value is refused, or null when it is one plain relative value. */
38
42
  export function valueProblem(value: string): string | null {
39
- if (value.split("/").includes("..")) return `the value '${value}' holds a '..' segment`;
40
- if (!PLAIN_VALUE.test(value)) return `the value '${value}' is not one plain relative name`;
43
+ if (value.split("/").includes("..")) return valueHoldsDotDot(value);
44
+ if (!PLAIN_VALUE.test(value)) return valueNotPlain(value);
41
45
  return null;
42
46
  }
43
47
 
@@ -46,8 +50,8 @@ type Key = "commands.test_class" | "commands.test_project" | "commands.test_inte
46
50
  export function checkValidation(command: string, commands: RepoPackCommands): ValidationCheck {
47
51
  const c = command.trim();
48
52
  const refuse = (reason: string): ValidationCheck => ({ ok: false, command: c, reason });
49
- if (c === "" || /[\r\n]/.test(c) || c.length > MAX_COMMAND_CHARS) return refuse("not one line of at most 400 characters");
50
- if (!plainWords(c)) return refuse("a shell operator outside double quotes");
53
+ if (c === "" || /[\r\n]/.test(c) || c.length > MAX_COMMAND_CHARS) return refuse(NOT_ONE_LINE);
54
+ if (!plainWords(c)) return refuse(SHELL_OPERATOR_OUTSIDE_QUOTES);
51
55
 
52
56
  const templates: Array<[Key, string | undefined]> = [
53
57
  ["commands.test_class", commands.testClass],
@@ -55,7 +59,7 @@ export function checkValidation(command: string, commands: RepoPackCommands): Va
55
59
  ["commands.test_integration", commands.testIntegration],
56
60
  ];
57
61
  if (templates.every(([, t]) => t === undefined || t.trim() === "")) {
58
- return refuse("the pack has no test_class, test_project or test_integration");
62
+ return refuse(PACK_HAS_NO_TEST_COMMAND);
59
63
  }
60
64
  let bareIntegration = false;
61
65
  let problem: string | null = null;
@@ -71,20 +75,20 @@ export function checkValidation(command: string, commands: RepoPackCommands): Va
71
75
  return { ok: true, command: c, key, scope: scopeOf(values) };
72
76
  }
73
77
  const suffixed = new RegExp(`^${source} (.+)$`).exec(c);
74
- if (suffixed) problem ??= `nothing may follow the pack's command: '${suffixed[suffixed.length - 1]}'`;
78
+ if (suffixed) problem ??= nothingMayFollow(suffixed[suffixed.length - 1]);
75
79
  }
76
80
  if (problem !== null) return refuse(problem);
77
81
  return refuse(bareIntegration
78
- ? "test_integration without a filter is a whole suite"
79
- : "not one of the pack's test_class, test_project or test_integration commands");
82
+ ? INTEGRATION_WITHOUT_FILTER
83
+ : NOT_A_PACK_TEST_COMMAND);
80
84
  }
81
85
 
82
86
  function scopeOf(values: readonly string[]): string {
83
87
  const named = values.join(", ");
84
- return named === "" ? "as the pack names it" : named;
88
+ return named === "" ? AS_THE_PACK_NAMES_IT : named;
85
89
  }
86
90
 
87
91
  /** `\`<command>\` — exit <n>, scope <scope>, <count> tests` (SK:72); count "not counted" when unknown. */
88
92
  export function validationLine(command: string, exit: number, scope: string, tests: number | null): string {
89
- return `\`${command}\` — exit ${exit}, scope ${scope}, ${tests === null ? "not counted" : tests} tests`;
93
+ return validationLineText(command, exit, scope, tests === null ? "not counted" : tests);
90
94
  }
@@ -7,6 +7,7 @@ import type { PermissionRule } from "../agent-policy/permission.ts";
7
7
  import { ruleDecision, shellCommandForms } from "../agent-policy/permission.ts";
8
8
  import { gitConfigSets, holdsGitReadonly } from "../agent-policy/rule-sets.ts";
9
9
  import { WORKSPACE } from "../vfs.ts";
10
+ import { argumentNotAString, argumentNotOneLine, stepRulesDenyShell } from "./messages.ts";
10
11
 
11
12
  /** One check of a call: the reason it is refused, or null when it passes. */
12
13
  export type Guard<T> = (call: T) => string | null;
@@ -33,7 +34,7 @@ export function shellRuleGuard(rules: readonly PermissionRule[]): Guard<string>
33
34
  shellCommandForms(command).some((form) =>
34
35
  ruleDecision(rules, "shell_command", { command: form, working_directory: WORKSPACE }) === "deny")
35
36
  || (gitConfig && gitConfigSets(command))
36
- ? `the rules of this step deny the shell command '${command}'`
37
+ ? stepRulesDenyShell(command)
37
38
  : null;
38
39
  }
39
40
 
@@ -46,9 +47,9 @@ export function stringArgument(input: unknown, key: string, required: boolean):
46
47
  if (value === undefined || value === null || value === "") {
47
48
  return required ? { refused: `'${key}' is required` } : {};
48
49
  }
49
- if (typeof value !== "string") return { refused: `'${key}' is not a string` };
50
+ if (typeof value !== "string") return { refused: argumentNotAString(key) };
50
51
  if (/[\r\n]/.test(value) || value.length > MAX_ARGUMENT_CHARS) {
51
- return { refused: `'${key}' is not one line of at most ${MAX_ARGUMENT_CHARS} characters` };
52
+ return { refused: argumentNotOneLine(key, MAX_ARGUMENT_CHARS) };
52
53
  }
53
54
  return { value: value.trim() };
54
55
  }
@@ -2,6 +2,10 @@
2
2
  // a trait name (tests.rule_trait) and, optionally, a one-line pattern (tests.trait_pattern)
3
3
  // holding <id> once and <name> at most once; the pattern compiles to the POSIX ERE that
4
4
  // git grep -E runs over the test roots. Pure.
5
+ import {
6
+ PATTERN_ANGLES, PATTERN_EMPTY, PATTERN_NO_PIPE, PATTERN_NO_SINGLE_QUOTE, PATTERN_NO_TAB_OR_BREAK, PATTERN_ONE_ID,
7
+ PATTERN_ONE_NAME, PATTERN_TOO_LONG, PATTERN_TOO_SHORT, TRAIT_NAME_CHARS,
8
+ } from "./messages.ts";
5
9
 
6
10
  export const DEFAULT_TRAIT_PATTERN = '[Trait("<name>", "<id>")]';
7
11
  /** The sheet ids the gate checks (AC:166). */
@@ -26,20 +30,20 @@ function count(text: string, token: string): number {
26
30
  }
27
31
 
28
32
  export function ruleTraitProblem(name: string): string | undefined {
29
- return /^[A-Za-z0-9_-]+$/.test(name) ? undefined : "a trait name takes letters, digits, '_' and '-'";
33
+ return /^[A-Za-z0-9_-]+$/.test(name) ? undefined : TRAIT_NAME_CHARS;
30
34
  }
31
35
 
32
36
  export function traitPatternProblem(pattern: string): string | undefined {
33
- if (pattern.trim() === "") return "the pattern is empty";
34
- if (pattern.length > 80) return "the pattern is longer than 80 characters";
35
- if (/[\t\r\n]/.test(pattern)) return "a tab or a line break is not allowed";
36
- if (pattern.includes("'")) return "a single quote is not allowed";
37
- if (pattern.includes("|")) return "a '|' is not allowed: the runtime's shell refuses it";
38
- if (count(pattern, ID_TOKEN) !== 1) return "the pattern must hold <id> exactly once";
39
- if (count(pattern, NAME_TOKEN) > 1) return "the pattern may hold <name> once at most";
37
+ if (pattern.trim() === "") return PATTERN_EMPTY;
38
+ if (pattern.length > 80) return PATTERN_TOO_LONG;
39
+ if (/[\t\r\n]/.test(pattern)) return PATTERN_NO_TAB_OR_BREAK;
40
+ if (pattern.includes("'")) return PATTERN_NO_SINGLE_QUOTE;
41
+ if (pattern.includes("|")) return PATTERN_NO_PIPE;
42
+ if (count(pattern, ID_TOKEN) !== 1) return PATTERN_ONE_ID;
43
+ if (count(pattern, NAME_TOKEN) > 1) return PATTERN_ONE_NAME;
40
44
  const rest = pattern.split(ID_TOKEN).join("").split(NAME_TOKEN).join("");
41
- if (/[<>]/.test(rest)) return "'<' and '>' may only enclose <id> and <name>";
42
- if (rest.replace(/\s/g, "").length < 2) return "the pattern needs at least two characters around <id>";
45
+ if (/[<>]/.test(rest)) return PATTERN_ANGLES;
46
+ if (rest.replace(/\s/g, "").length < 2) return PATTERN_TOO_SHORT;
43
47
  return undefined;
44
48
  }
45
49
 
@@ -2,13 +2,14 @@
2
2
  // resume appends one). Pure, no IO, never throws. Gap rows are cut as the harness's
3
3
  // learning script cuts them, so both read the same rows from the same file.
4
4
  import type { FormatProblem } from "./plan-format.ts";
5
+ import {
6
+ AUDIT_UNFINISHED_GAP, CLOSE_LINE, CORRECTION_LINE, MEASURE_LINE, NOT_RUN_LINE, VALIDATIONS_LINE, VERDICT_HEADING,
7
+ VERDICT_TITLE,
8
+ } from "./markers.ts";
9
+ import { malformedGapRow, unknownSeverity, unknownVerdictLine, unknownVerdictTitle } from "./messages.ts";
5
10
 
6
11
  export type Verdict = "VALID" | "GAPS";
7
12
 
8
- /** The gap of the row dev-verify writes when the step's budget stopped the audit: not a finding of the code, so
9
- * neither the learning harvest nor a resumed audit takes it as one. Its reason goes in the evidence. */
10
- export const AUDIT_UNFINISHED_GAP = "the audit did not finish: the step's budget ran out";
11
-
12
13
  export function isAuditUnfinishedGap(gap: string): boolean {
13
14
  return gap.trim() === AUDIT_UNFINISHED_GAP;
14
15
  }
@@ -26,11 +27,6 @@ export interface VerdictSection {
26
27
  }
27
28
  export interface VerdictFile { sections: VerdictSection[]; problems: FormatProblem[] }
28
29
 
29
- const TITLE = /^# (\S+)-VERIFY-(F\d+) — (\d{4}-\d{2}-\d{2} \d{2}:\d{2}) — (\S+)$/;
30
- const VERDICT = /^##\s+Verdict\s+—\s+(VALID|GAPS)\s*$/;
31
- const VALIDATIONS = /^Validations: (.+)$/;
32
- const NOT_RUN = /^Not run: (.+)$/;
33
- const MEASURE = /^Measure: (.+)$/;
34
30
  const SEVERITIES: ReadonlySet<string> = new Set(["Blocking", "Major", "Minor"]);
35
31
 
36
32
  function emptySection(line: number): VerdictSection {
@@ -46,29 +42,29 @@ export function parseVerdictFile(text: string): VerdictFile {
46
42
  const line = i + 1;
47
43
  if (t.startsWith("#")) {
48
44
  inside = false;
49
- const title = TITLE.exec(t);
45
+ const title = VERDICT_TITLE.exec(t);
50
46
  if (title) {
51
47
  section = { ...emptySection(line), prefix: title[1], batch: title[2], when: title[3], mode: title[4] };
52
48
  file.sections.push(section);
53
49
  return;
54
50
  }
55
- const v = VERDICT.exec(t);
51
+ const v = VERDICT_HEADING.exec(t);
56
52
  if (v) {
57
53
  if (!section || section.verdict !== null) { section = emptySection(line); file.sections.push(section); }
58
54
  section.verdict = v[1] as Verdict;
59
55
  inside = true;
60
56
  return;
61
57
  }
62
- if (/-VERIFY-/.test(t) && t.startsWith("# ")) file.problems.push({ line, message: `unknown verdict title '${t}'` });
63
- else if (/^##\s+Verdict\b/.test(t)) file.problems.push({ line, message: `unknown verdict line '${t}'` });
58
+ if (/-VERIFY-/.test(t) && t.startsWith("# ")) file.problems.push({ line, message: unknownVerdictTitle(t) });
59
+ else if (/^##\s+Verdict\b/.test(t)) file.problems.push({ line, message: unknownVerdictLine(t) });
64
60
  return;
65
61
  }
66
62
  if (!section) return;
67
63
  const current: VerdictSection = section;
68
64
  let m: RegExpExecArray | null;
69
- if ((m = VALIDATIONS.exec(t))) { current.validations.push(m[1]); return; }
70
- if ((m = NOT_RUN.exec(t))) { current.notRun.push(m[1]); return; }
71
- if ((m = MEASURE.exec(t))) { current.measure = m[1]; return; }
65
+ if ((m = VALIDATIONS_LINE.exec(t))) { current.validations.push(m[1]); return; }
66
+ if ((m = NOT_RUN_LINE.exec(t))) { current.notRun.push(m[1]); return; }
67
+ if ((m = MEASURE_LINE.exec(t))) { current.measure = m[1]; return; }
72
68
  if (!inside) return;
73
69
  if (t.trim() === "None.") { current.none = true; return; }
74
70
  const s = t.trim();
@@ -77,8 +73,8 @@ export function parseVerdictFile(text: string): VerdictFile {
77
73
  if (!s.startsWith("|") && !(s.includes("|") && SEVERITIES.has(s.slice(0, s.indexOf("|")).trim()))) return;
78
74
  const cells = s.replace(/^\|+/, "").replace(/\|+$/, "").split("|").map((c) => c.trim());
79
75
  if (cells[0] === "Severity" || /^-+$/.test(cells[0].replace(/:/g, ""))) return;
80
- if (!SEVERITIES.has(cells[0])) { file.problems.push({ line, message: `unknown severity '${cells[0]}'` }); return; }
81
- if (cells.length < 5) { file.problems.push({ line, message: `malformed gap row '${s}'` }); return; }
76
+ if (!SEVERITIES.has(cells[0])) { file.problems.push({ line, message: unknownSeverity(cells[0]) }); return; }
77
+ if (cells.length < 5) { file.problems.push({ line, message: malformedGapRow(s) }); return; }
82
78
  current.rows.push({
83
79
  severity: cells[0] as Severity, axis: cells[1], gap: cells.slice(2, -2).join(" | "),
84
80
  evidence: cells[cells.length - 2], expectedFix: cells[cells.length - 1], line,
@@ -154,9 +150,6 @@ export const correctionLine = (code: string, batch: string, finding: string): st
154
150
  /** The line a VALID verdict ends on: the close to run. */
155
151
  export const closeLine = (code: string, batch: string): string => `→ ${closeCommand(code, batch)}`;
156
152
 
157
- const CORRECTION_LINE = /^\s*→ \/dev-batches (\S+) (F\d+) — correction: (.+)$/m;
158
- const CLOSE_LINE = /^\s*→ \/dev-batches (\S+) (F\d+) --close\s*$/;
159
-
160
153
  /** The first correction line of `text`: its code, batch and finding; null when it holds none. */
161
154
  export function parseCorrectionLine(text: string): { code: string; batch: string; finding: string } | null {
162
155
  const m = CORRECTION_LINE.exec(text);
@@ -1,6 +1,7 @@
1
1
  // The whitespace `git diff --check` refuses, put right by code in a file a role wrote: trailing
2
2
  // spaces or tabs at the end of a line, blank lines at the end of the file. A node insert at the end
3
3
  // of a module leaves a blank line after the last member; the gate would stop the batch for it. Pure.
4
+ import { blankLinesAtEof, ONE_BLANK_LINE_AT_EOF, trailingWhitespace } from "./messages.ts";
4
5
 
5
6
  export interface TidyResult {
6
7
  text: string;
@@ -18,7 +19,7 @@ export function tidyWhitespace(text: string): TidyResult {
18
19
  if (clean !== line) trailing += 1;
19
20
  return clean;
20
21
  });
21
- if (trailing > 0) fixed.push(`trailing whitespace on ${trailing} line${trailing === 1 ? "" : "s"}`);
22
+ if (trailing > 0) fixed.push(trailingWhitespace(trailing));
22
23
  const endsWithNewline = text.endsWith("\n");
23
24
  // The split's last element is "" when the text ends with a newline: the blank lines at EOF are the empty
24
25
  // elements before it.
@@ -28,7 +29,7 @@ export function tidyWhitespace(text: string): TidyResult {
28
29
  end -= 1;
29
30
  blank += 1;
30
31
  }
31
- if (blank > 0) fixed.push(blank === 1 ? "a blank line at EOF removed" : `${blank} blank lines at EOF removed`);
32
+ if (blank > 0) fixed.push(blank === 1 ? ONE_BLANK_LINE_AT_EOF : blankLinesAtEof(blank));
32
33
  const body = stripped.slice(0, end).join("\n");
33
34
  return { text: endsWithNewline ? `${body}\n` : body, fixed };
34
35
  }
@@ -3,6 +3,7 @@
3
3
  // request applies (the config key before the pack's layout.work), and the two
4
4
  // readings of git output the resolution needs. Nothing here touches a file or
5
5
  // runs a command; resolve-work-folder.ts does, through the ports.
6
+ import { AN_ABSOLUTE_PATH, AN_EMPTY_SEGMENT, notARelativeFolder } from "./messages.ts";
6
7
 
7
8
  export const DEFAULT_WORK_FOLDER = "workbench";
8
9
  export const DEV_WORK_DIR_CONFIG_KEY = "dev.workDir";
@@ -22,8 +23,8 @@ export function normalizeWorkDir(raw: string): WorkDirCheck {
22
23
  }
23
24
  if (w === "") return { ok: true, folder: "" };
24
25
  const parts = w.split("/");
25
- if (w.startsWith("/")) return { ok: false, reason: "an absolute path" };
26
- if (w.includes("//")) return { ok: false, reason: "an empty segment" };
26
+ if (w.startsWith("/")) return { ok: false, reason: AN_ABSOLUTE_PATH };
27
+ if (w.includes("//")) return { ok: false, reason: AN_EMPTY_SEGMENT };
27
28
  if (parts.includes("..") || parts.includes(".")) return { ok: false, reason: "a '..' or '.' segment" };
28
29
  if (parts[0] === ".claude" || parts[0] === ".git") return { ok: false, reason: "under .claude/ or .git/" };
29
30
  if (NON_PRINTABLE.test(w)) return { ok: false, reason: "a non-printable character" };
@@ -33,7 +34,7 @@ export function normalizeWorkDir(raw: string): WorkDirCheck {
33
34
  /** For CONFIG_KEYS.problem: undefined when valid, else the reason. */
34
35
  export function workFolderProblem(value: string): string | undefined {
35
36
  const check = normalizeWorkDir(value);
36
- return check.ok ? undefined : `'${value}' is not a relative folder of the checkout: ${check.reason}`;
37
+ return check.ok ? undefined : notARelativeFolder(value, check.reason);
37
38
  }
38
39
 
39
40
  export type WorkDirSource = "dev.workDir" | "layout.work";
@@ -5,6 +5,9 @@
5
5
  // scalars, single- and double-quoted scalars on one line, plain scalars on one line,
6
6
  // comments, the folded block `>-`, and the YAML 1.1 scalar types (null, boolean,
7
7
  // decimal integer, float). Pure: no runtime global, never throws.
8
+ import {
9
+ ambiguousDate, ambiguousNumber, onlyFoldedBlock, plainCannotStartWith, unknownEscape, YAML_PROBLEMS as MSG,
10
+ } from "./messages.ts";
8
11
 
9
12
  export type YamlScalar = string | number | boolean | null;
10
13
  export type YamlValue = YamlScalar | YamlValue[] | YamlMap;
@@ -17,27 +20,6 @@ export function formatYamlError(path: string, error: YamlError): string {
17
20
  return `${path}:${error.line}: ${error.message}`;
18
21
  }
19
22
 
20
- const MSG = {
21
- tab: "a tab in the indentation",
22
- tabInLine: "a tab outside quotes and comments",
23
- marker: "a document marker is not supported",
24
- anchor: "anchors, aliases and tags are not supported",
25
- flowMap: "a flow mapping is not supported",
26
- flowOpen: "a flow sequence must close on its line",
27
- flowNested: "a nested flow sequence is not supported",
28
- flowAfter: "text after a closing bracket",
29
- flowEmpty: "an empty item in a flow sequence",
30
- moreIndented: "a more-indented line inside a folded block is not supported",
31
- quoteOpen: "a quoted scalar must close on its line",
32
- quoteAfter: "text after a closing quote",
33
- colon: "': ' inside a plain value: quote it",
34
- key: "a mapping key must be a plain name",
35
- indent: "bad indentation (a value continued on the next line is not supported)",
36
- itemForKey: "a sequence item where a mapping key was expected",
37
- keyForItem: "a mapping key where a sequence item was expected",
38
- nestedItem: "a nested sequence item on one line is not supported",
39
- } as const;
40
-
41
23
  class YamlStop {
42
24
  readonly line: number;
43
25
  readonly message: string;
@@ -76,8 +58,8 @@ function typePlain(v: string, no: number): YamlScalar {
76
58
  if (FLOAT.test(v)) return Number(v.replace(/_/g, "")) || 0;
77
59
  if (INF.test(v)) return v.startsWith("-") ? -Infinity : Infinity;
78
60
  if (NAN.test(v)) return Number.NaN;
79
- if (AMBIGUOUS.some((re) => re.test(v))) throw new YamlStop(no, `an ambiguous number '${v}': quote it`);
80
- if (DATE.test(v)) throw new YamlStop(no, `an ambiguous date '${v}': quote it`);
61
+ if (AMBIGUOUS.some((re) => re.test(v))) throw new YamlStop(no, ambiguousNumber(v));
62
+ if (DATE.test(v)) throw new YamlStop(no, ambiguousDate(v));
81
63
  return v;
82
64
  }
83
65
 
@@ -103,7 +85,7 @@ function readQuoted(text: string, no: number): { value: string; end: number } {
103
85
  const e = text[i + 1];
104
86
  const map: Record<string, string> = { '"': '"', "\\": "\\", "/": "/", n: "\n", t: "\t" };
105
87
  if (e === undefined || !(e in map)) {
106
- throw new YamlStop(no, `an unknown escape '\\${e ?? ""}' in a double-quoted scalar`);
88
+ throw new YamlStop(no, unknownEscape(e ?? ""));
107
89
  }
108
90
  out += map[e];
109
91
  i += 2;
@@ -148,7 +130,7 @@ const RESERVED_START = /^(?:[%@`|>]|\?(?:\s|$))/;
148
130
  function plainScalar(raw: string, no: number): YamlScalar {
149
131
  const cut = raw.search(/\s#/);
150
132
  const v = (cut < 0 ? raw : raw.slice(0, cut)).trimEnd();
151
- if (RESERVED_START.test(v)) throw new YamlStop(no, `a plain value cannot start with '${v[0]}': quote it`);
133
+ if (RESERVED_START.test(v)) throw new YamlStop(no, plainCannotStartWith(v[0]));
152
134
  if (/:(\s|$)/.test(v)) throw new YamlStop(no, MSG.colon);
153
135
  return typePlain(v, no);
154
136
  }
@@ -344,7 +326,7 @@ class Parser {
344
326
  const indicator = blockIndicator(rest);
345
327
  if (indicator !== null) {
346
328
  if (indicator !== ">-") {
347
- throw new YamlStop(no, `only the folded block '>-' is supported, not '${indicator}'`);
329
+ throw new YamlStop(no, onlyFoldedBlock(indicator));
348
330
  }
349
331
  return this.folded(parentIndent, no);
350
332
  }
@@ -0,0 +1,13 @@
1
+ // An error as one line of text: the whole message, its line breaks and runs of blanks made single spaces, cut at
2
+ // ERROR_TEXT_CHARS. A model's reply the runtime could not parse is quoted with its line breaks, so keeping the first
3
+ // line alone dropped what was wrong with it, for the person and for the re-ask. Since Orkeon #353 that message gives
4
+ // the JSON error, the finish reason and the tokens, then the first and the last 200 characters of the reply: about
5
+ // 850 characters at most, so the cut leaves room for all of it, the end of a reply cut short included. Pure.
6
+
7
+ export const ERROR_TEXT_CHARS = 1200;
8
+
9
+ /** The message of `error` (an Error's, else its string), on one line, at most ERROR_TEXT_CHARS characters. */
10
+ export function errorText(error: unknown): string {
11
+ const flat = (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim();
12
+ return flat.length <= ERROR_TEXT_CHARS ? flat : `${flat.slice(0, ERROR_TEXT_CHARS - 1)}…`;
13
+ }
@@ -2,6 +2,7 @@
2
2
  // explicit list, never the work folder), the command lines that commit, push and
3
3
  // merge them, and the pull request body and command handed over. Pure: nothing
4
4
  // here runs a command; shared/application/git runs these lines through the Shell port.
5
+ import { ASSUMPTIONS_HEADING, ASSUMPTIONS_BY_ID_HEAD, FILES_PER_LAYER_HEADING, noIdentityStop } from "./messages.ts";
5
6
 
6
7
  /** Q-10's switch: `true` asks the close to open the pull request itself. Omitted = false. */
7
8
  export const DEV_PR_AUTO_CONFIG_KEY = "dev.prAuto";
@@ -46,7 +47,7 @@ export const IDENTITY_HANDOVER: readonly string[] = [
46
47
  /** The stop when git has no identity: git's reason, then the two commands, one per line. Never an invented identity. */
47
48
  export function identityStop(detail: string, rerun: string): string {
48
49
  return [
49
- `✗ stopped: git has no identity for the commit (${detail}). Set one in a terminal, then re-run ${rerun}:`,
50
+ noIdentityStop(detail, rerun),
50
51
  ...IDENTITY_HANDOVER.map((c) => ` ${c}`),
51
52
  ].join("\n");
52
53
  }
@@ -250,16 +251,16 @@ export function renderPrBody(s: PrSummary): string {
250
251
  .map((l) => `- ${l.layer}: ${l.paths.map((p) => `\`${p}\``).join(", ")}`);
251
252
  const validations = (s.validations ?? []).map((v) => `- ${v}`);
252
253
  const assumptions = (s.assumptions ?? []).length === 0 ? [NONE] : [
253
- "| Id | Assumption | To be validated by |",
254
+ ASSUMPTIONS_BY_ID_HEAD,
254
255
  "|----|------------|--------------------|",
255
256
  ...(s.assumptions ?? []).map((a) => `| ${a.id} | ${a.assumption} | ${a.by} |`),
256
257
  ];
257
258
  const text = (v: string | undefined): string => (v ?? "").trim() || NONE;
258
259
  return [
259
260
  "## Batch", "", text(s.batch), "",
260
- "## Files, per layer", "", ...(layers.length > 0 ? layers : [NONE]), "",
261
+ FILES_PER_LAYER_HEADING, "", ...(layers.length > 0 ? layers : [NONE]), "",
261
262
  "## Validations", "", ...(validations.length > 0 ? validations : [NONE]), "",
262
- "## Assumptions to validate", "", ...assumptions, "",
263
+ ASSUMPTIONS_HEADING, "", ...assumptions, "",
263
264
  "## Audit", "", text(s.audit), "",
264
265
  "## Not run", "", text(s.notRun), "",
265
266
  ].join("\n");
@@ -0,0 +1,20 @@
1
+ // The text of the git workflow shown to the user: the stop without an identity, the refusals of a pull
2
+ // request, the headings of its body.
3
+
4
+ export const noIdentityStop = (detail: string, rerun: string): string =>
5
+ `✗ stopped: git has no identity for the commit (${detail}). Set one in a terminal, then re-run ${rerun}:`;
6
+
7
+ // ── The body of a pull request ──────────────────────────────────────────
8
+
9
+ export const ASSUMPTIONS_BY_ID_HEAD = "| Id | Assumption | To be validated by |";
10
+ export const FILES_PER_LAYER_HEADING = "## Files, per layer";
11
+ export const ASSUMPTIONS_HEADING = "## Assumptions to validate";
12
+
13
+ // ── Why a pull request is not opened ────────────────────────────────────
14
+
15
+ export const modeDoesNotRun = (mode: string, tool: string): string => `mode '${mode}' does not run ${tool}`;
16
+ export const denyRuleCovers = (tool: string, action: string): string => `a deny rule of /permissions covers ${tool} ${action}`;
17
+ export const dontAskNeedsAllow = (tool: string): string => `mode 'dontAsk' runs ${tool} only under an allow rule`;
18
+ export const asksFirstNotAsked = (tool: string, mode: string, rule: string): string =>
19
+ `${tool} asks first in mode '${mode}' and this run did not ask: ` +
20
+ `'/permissions add ${rule}' lets it open the pull request`;
@@ -11,6 +11,7 @@
11
11
  import { parseStoredRule, ruleDecision } from "../agent-policy/permission.ts";
12
12
  import type { PermissionRule } from "../agent-policy/permission.ts";
13
13
  import { isPermissionMode } from "../permission-modes.ts";
14
+ import { asksFirstNotAsked, denyRuleCovers, dontAskNeedsAllow, modeDoesNotRun } from "./messages.ts";
14
15
 
15
16
  /** The tool, and the action of its call. */
16
17
  export const GITHUB_TOOL = "github";
@@ -62,17 +63,16 @@ export function pullRequestPermission(req: {
62
63
  args: Readonly<Record<string, unknown>>;
63
64
  }): PrPermission {
64
65
  if (!isPermissionMode(req.mode) || req.mode === "plan") {
65
- return { ok: false, reason: `mode '${req.mode}' does not run ${GITHUB_TOOL}` };
66
+ return { ok: false, reason: modeDoesNotRun(req.mode, GITHUB_TOOL) };
66
67
  }
67
68
  const rule = ruleDecision(req.rules, GITHUB_TOOL, req.args);
68
- if (rule === "deny") return { ok: false, reason: `a deny rule of /permissions covers ${GITHUB_TOOL} ${GITHUB_CREATE_PR}` };
69
+ if (rule === "deny") return { ok: false, reason: denyRuleCovers(GITHUB_TOOL, GITHUB_CREATE_PR) };
69
70
  if (rule === "allow") return { ok: true };
70
- if (req.mode === "dontAsk") return { ok: false, reason: `mode 'dontAsk' runs ${GITHUB_TOOL} only under an allow rule` };
71
+ if (req.mode === "dontAsk") return { ok: false, reason: dontAskNeedsAllow(GITHUB_TOOL) };
71
72
  if (req.mode === "bypassPermissions" || req.asked) return { ok: true };
72
73
  return {
73
74
  ok: false,
74
- reason: `${GITHUB_TOOL} asks first in mode '${req.mode}' and this run did not ask: ` +
75
- `'/permissions add ${GITHUB_ALLOW_RULE}' lets it open the pull request`,
75
+ reason: asksFirstNotAsked(GITHUB_TOOL, req.mode, GITHUB_ALLOW_RULE),
76
76
  };
77
77
  }
78
78