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
@@ -4,6 +4,11 @@
4
4
  // A port call, or an in-memory filter, inside a loop or a lambda blocks only on an added line, as
5
5
  // `access-cost.py --diff` does. Pure.
6
6
  import { WORKSPACE, workspaceRelative } from "../vfs.ts";
7
+ import {
8
+ backToDesign, CODE_INDEX_EMPTY, codeIndexHolds, costLine, costNotComputed, cutAtLines, MEMORY_FILTER_ON_AWAITED,
9
+ NO_CODE_INDEX_WIRED, NO_MEMBER_INDEXED, noChangedFile, noneAwaitsAPort, notIndexedReason, PORTS_IN_A_LAMBDA,
10
+ PORTS_IN_A_LOOP, PORTS_OUTSIDE_LOOPS,
11
+ } from "./messages.ts";
7
12
 
8
13
  export type AccessCost =
9
14
  | { state: "not-computed"; reason: string }
@@ -29,7 +34,7 @@ export function isTestFile(path: string, testRoots: readonly string[]): boolean
29
34
  /** The cost when the crew wires no code index. */
30
35
  export const COST_NOT_WIRED: AccessCost = {
31
36
  state: "not-computed",
32
- reason: "the crew wires no code index; judge the Cost axis from the diff",
37
+ reason: NO_CODE_INDEX_WIRED,
33
38
  };
34
39
 
35
40
  export function notComputed(reason: string): AccessCost {
@@ -38,8 +43,8 @@ export function notComputed(reason: string): AccessCost {
38
43
 
39
44
  /** No `/workspace` root in the index: the use case says so itself, the tool would answer an empty report. */
40
45
  export function notIndexed(roots: readonly string[]): AccessCost {
41
- const holds = roots.length === 0 ? "the code index is empty" : `the code index holds ${roots.join(", ")}, not ${WORKSPACE}`;
42
- return notComputed(`not indexed — ${holds}: run /analyze, then audit the batch again; judge the Cost axis from the diff`);
46
+ const holds = roots.length === 0 ? CODE_INDEX_EMPTY : codeIndexHolds(roots, WORKSPACE);
47
+ return notComputed(notIndexedReason(holds));
43
48
  }
44
49
 
45
50
  /**
@@ -144,9 +149,8 @@ function fileOf(fqn: string): string {
144
149
 
145
150
  /** The `Cost` line of access-cost.py:261. */
146
151
  export function costLineOf(reads: number, writes: number, blocking: number): string {
147
- const verdict = blocking === 0 ? "none" : `${blocking} - back to design`;
148
- return `Cost: ${plural(reads, "read")} + ${plural(writes, "write")} through ports outside loops; ` +
149
- `in a loop, a lambda or a memory filter: ${verdict}`;
152
+ const verdict = blocking === 0 ? "none" : backToDesign(blocking);
153
+ return costLine(plural(reads, "read"), plural(writes, "write"), verdict);
150
154
  }
151
155
 
152
156
  /**
@@ -183,15 +187,15 @@ export function measuredCost(report: AccessCostReport, added: ReadonlyMap<string
183
187
  if (blocks) flagged.push(`${member} L${f.line} ${f.method} memory filter`);
184
188
  }
185
189
  detail.push(`[${member}]`);
186
- show("Ports outside loops", flat);
187
- show("Ports in a loop", loop);
188
- show("Ports in a lambda", lambda);
189
- show("Memory filter on an awaited result", filters);
190
+ show(PORTS_OUTSIDE_LOOPS, flat);
191
+ show(PORTS_IN_A_LOOP, loop);
192
+ show(PORTS_IN_A_LAMBDA, lambda);
193
+ show(MEMORY_FILTER_ON_AWAITED, filters);
190
194
  }
191
195
  if (detail.length === 0) {
192
196
  detail.push(report.members.length === 0
193
- ? "no member of the changed files in the code index"
194
- : `${plural(report.members.length, "member")}, none awaits a port or filters in memory`);
197
+ ? NO_MEMBER_INDEXED
198
+ : noneAwaitsAPort(plural(report.members.length, "member")));
195
199
  }
196
200
  return {
197
201
  state: "measured",
@@ -205,12 +209,12 @@ export function measuredCost(report: AccessCostReport, added: ReadonlyMap<string
205
209
  /** A batch that changes no file under the cost roots: nothing to measure, nothing blocks. */
206
210
  export function nothingChanged(roots: readonly string[]): AccessCost {
207
211
  const where = roots.length === 0 ? "" : ` under ${roots.join(" ")}`;
208
- return { state: "measured", exit: 0, flagged: [], costLine: costLineOf(0, 0, 0), detail: `no changed file${where}\n` };
212
+ return { state: "measured", exit: 0, flagged: [], costLine: costLineOf(0, 0, 0), detail: noChangedFile(where) };
209
213
  }
210
214
 
211
215
  /** The line the command prints under the gate's green line. */
212
216
  export function costSummary(cost: AccessCost): string {
213
- return cost.state === "measured" ? cost.costLine : `Cost: not computed — ${cost.reason}`;
217
+ return cost.state === "measured" ? cost.costLine : costNotComputed(cost.reason);
214
218
  }
215
219
 
216
220
  const DETAIL_LINES = 60;
@@ -220,7 +224,7 @@ export function costSection(cost: AccessCost): string {
220
224
  const detail = cost.detail.split("\n");
221
225
  if (detail.length > 0 && detail[detail.length - 1] === "") detail.pop();
222
226
  const out = [`exit: ${cost.exit}`, ...detail.slice(0, DETAIL_LINES)];
223
- if (detail.length > DETAIL_LINES) out.push(`[cut at ${DETAIL_LINES} lines]`);
227
+ if (detail.length > DETAIL_LINES) out.push(cutAtLines(DETAIL_LINES));
224
228
  out.push(cost.costLine);
225
229
  return `${out.join("\n")}\n`;
226
230
  }
@@ -4,6 +4,7 @@
4
4
  // command: two batches asking at once could not both be answered. That is bypassPermissions alone: acceptEdits still
5
5
  // asks for shell_command, and dontAsk is read-only here (mode-policy.ts), which /dev-batches refuses at any
6
6
  // concurrency. Read by the command's arguments and by the crew's input. Pure.
7
+ import { concurrencyAtMost, concurrencyGitFails, concurrencyModeAsks, concurrencyNotWhole } from "./messages.ts";
7
8
 
8
9
  export const MAX_CONCURRENCY = 4;
9
10
 
@@ -16,21 +17,19 @@ export type Concurrency = { ok: true; value: number } | { ok: false; line: strin
16
17
  export function checkConcurrency(raw: unknown): Concurrency {
17
18
  if (raw === undefined || raw === null) return { ok: true, value: 1 };
18
19
  const n = typeof raw === "number" ? raw : typeof raw === "string" && /^\s*\d+\s*$/.test(raw) ? Number(raw.trim()) : NaN;
19
- if (!Number.isSafeInteger(n) || n < 1) return { ok: false, line: `concurrency must be a whole number from 1, not '${String(raw)}'` };
20
- if (n > MAX_CONCURRENCY) return { ok: false, line: `concurrency ${n} refused: at most ${MAX_CONCURRENCY} batches at once` };
20
+ if (!Number.isSafeInteger(n) || n < 1) return { ok: false, line: concurrencyNotWhole(String(raw)) };
21
+ if (n > MAX_CONCURRENCY) return { ok: false, line: concurrencyAtMost(n, MAX_CONCURRENCY) };
21
22
  return { ok: true, value: n };
22
23
  }
23
24
 
24
25
  /** Above 1, the line refusing a session mode that asks before shell commands; null when the mode lets it run. */
25
26
  export function concurrencyModeRefusal(n: number, mode: string): string | null {
26
27
  if (n <= 1 || SILENT_MODES.includes(mode.trim())) return null;
27
- return `concurrency ${n} refused: the session mode ${mode.trim() || "default"} asks before shell commands, and two batches would ask at once: ` +
28
- "/mode bypassPermissions, or run with --concurrency 1";
28
+ return concurrencyModeAsks(n, mode.trim() || "default");
29
29
  }
30
30
 
31
31
  /** The line refusing a parallel run when git fails in a batch's worktree: a runtime older than the one binding a
32
32
  * linked worktree's git dir under its shell confinement. */
33
33
  export function concurrencyGitRefusal(n: number): string {
34
- return `concurrency ${n} refused: git does not work inside a worktree under this shell confinement (Tools:Shell:Confinement:Mode)` +
35
- "; a runtime from Orkeon/orkeon#191 on binds a linked worktree's git dir: update it, or run with --concurrency 1";
34
+ return concurrencyGitFails(n);
36
35
  }
@@ -4,6 +4,7 @@
4
4
  // was never restored (a cold checkout or worktree), where the flag cannot succeed.
5
5
  import type { RepoPackCommands } from "./repo-pack.ts";
6
6
  import { PLACEHOLDER, plainWords, valueProblem } from "./test-commands.ts";
7
+ import { buildTestPlaceholders, PACK_HAS_NO_BUILD, PACK_HAS_NO_BUILD_TEST, SHELL_OPERATOR_OUTSIDE_QUOTES } from "./messages.ts";
7
8
 
8
9
  export type BuildCommand = { ok: true; command: string; key: "commands.build" | "commands.build_test" } | { ok: false; reason: string };
9
10
 
@@ -11,20 +12,20 @@ export type BuildCommand = { ok: true; command: string; key: "commands.build" |
11
12
  export function buildCommandFor(commands: RepoPackCommands, project?: string): BuildCommand {
12
13
  if (project === undefined) {
13
14
  const build = commands.build?.trim();
14
- return build ? { ok: true, command: build, key: "commands.build" } : { ok: false, reason: "the pack has no commands.build" };
15
+ return build ? { ok: true, command: build, key: "commands.build" } : { ok: false, reason: PACK_HAS_NO_BUILD };
15
16
  }
16
17
  const template = commands.buildTest?.trim();
17
- if (!template) return { ok: false, reason: "the pack has no commands.build_test to build one project" };
18
+ if (!template) return { ok: false, reason: PACK_HAS_NO_BUILD_TEST };
18
19
  const holes = template.match(PLACEHOLDER) ?? [];
19
20
  if (holes.length !== 1) {
20
- return { ok: false, reason: `commands.build_test has ${holes.length} placeholders, not one: '${template}'` };
21
+ return { ok: false, reason: buildTestPlaceholders(holes.length, template) };
21
22
  }
22
23
  const problem = valueProblem(project);
23
24
  if (problem !== null) return { ok: false, reason: problem };
24
25
  const command = template.replace(PLACEHOLDER, project);
25
26
  return plainWords(command)
26
27
  ? { ok: true, command, key: "commands.build_test" }
27
- : { ok: false, reason: "a shell operator outside double quotes" };
28
+ : { ok: false, reason: SHELL_OPERATOR_OUTSIDE_QUOTES };
28
29
  }
29
30
 
30
31
  /** Whether `command` is the pack's restore, or a restore by its verb (`dotnet restore`, `npm ci`, `npm install`). */
@@ -1,5 +1,5 @@
1
- // What a dev crew's onToolCall checks after the host's gate allowed a call, and the /hooks declarations it runs
2
- // around the call — pure, no IO. The host gate runs first and keeps the session's rules; this guard can only
1
+ // What a dev crew's onToolCall checks before the host's gate judges a call, and the /hooks declarations it runs
2
+ // around the call — pure, no IO. The host gate runs next, on the input it returns, and keeps the session's rules; this guard can only
3
3
  // refuse: the step's rule sets again (the only check of them under `orkeon run`, which keeps no session rules), the
4
4
  // role's roots and its rewrite rule, the whole input of the folder readers, each operation of an edit_batch as the
5
5
  // editor it stands for, and the act's mode when the host has no gate. The callbacks
@@ -17,6 +17,14 @@ import type { RepoPackLayout } from "./repo-pack.ts";
17
17
  import { matchesAny, relativePath } from "./test-paths.ts";
18
18
  import { EDIT_BATCH_SHAPE } from "./reading-rule.ts";
19
19
  import { WORKSPACE } from "../vfs.ts";
20
+ import {
21
+ editBatchRefused, NO_LIST_OF_OPERATIONS, notRunInMode, operationNamesNoPath, operationUnknownKind, packGivesNo,
22
+ refusedByRule, rewriteRuleOrigin, rootsOrigin, ruleSetOrigin, validateNotRun, whichPathCanReach, whichPathReaches,
23
+ } from "./messages.ts";
24
+ import {
25
+ CHANGE_EXISTING_SOURCE_BY_NODE, opensNoSourceOrTest, refusedDuringStep, USE_READ_TOOLS, USE_READ_TOOLS_AND_EDITORS,
26
+ USE_VALIDATE_PARSE, writesOutsideRootsOnly,
27
+ } from "./prompts.ts";
20
28
 
21
29
  /** One /hooks declaration the callbacks run; `n` is its number in /hooks list. */
22
30
  export interface ToolHook { n: number; event: "pre-tool" | "post-tool"; command: string }
@@ -77,7 +85,7 @@ export function buildCallGuard(spec: CallGuardSpec): CallGuard {
77
85
  const own = roleRules(role, spec.layout ?? {});
78
86
  for (const rule of own.rules) rules.push({ rule, origin: { kind: "role", role, access } });
79
87
  for (const rule of own.rewrite) rules.push({ rule, origin: { kind: "rewrite", role } });
80
- problems.push(...own.problems, ...own.missing.map((key) => `the pack gives no ${key}: no rule on it`));
88
+ problems.push(...own.problems, ...own.missing.map(packGivesNo));
81
89
  if (access === "write") writable.push(...own.writable);
82
90
  if (role === "test-author") stubs.push(...(spec.writable ?? []).map(relativePath).filter((p) => p !== ""));
83
91
  }
@@ -142,11 +150,8 @@ function modeVerdict(guard: CallGuard, tool: string, input: unknown, mode: strin
142
150
  const known = ["default", "acceptEdits", "plan", "dontAsk"].includes(mode) ? mode : "default";
143
151
  return {
144
152
  allow: false,
145
- reason: `${guard.step}: '${tool}' is not run in mode '${known}': the host has no permission gate, so the crew's ` +
146
- `callback applies the mode itself`,
147
- context: known === "acceptEdits"
148
- ? "Use the read tools and the file editors only."
149
- : "Use the read tools only.",
153
+ reason: notRunInMode(guard.step, tool, known),
154
+ context: known === "acceptEdits" ? USE_READ_TOOLS_AND_EDITORS : USE_READ_TOOLS,
150
155
  };
151
156
  }
152
157
 
@@ -187,7 +192,7 @@ function joinPath(base: string | undefined, tail: string): string {
187
192
 
188
193
  /** The paths a folder reader reaches beyond its `path`: glob's pattern under it, grep's glob under it (or the
189
194
  * whole folder), count_pattern's and directory_search's whole folder. */
190
- function reachedPaths(tool: string, input: Readonly<Record<string, unknown>>): string[] {
195
+ export function reachedPaths(tool: string, input: Readonly<Record<string, unknown>>): string[] {
191
196
  const base = plainText(input.path);
192
197
  if (tool === "glob") {
193
198
  const pattern = plainText(input.pattern);
@@ -215,31 +220,28 @@ function reachesBelow(rule: PermissionRule, joined: string): boolean {
215
220
  }
216
221
 
217
222
  function originText(origin: GuardRule["origin"]): string {
218
- if (origin.kind === "set") return `the rule set ${origin.id}`;
219
- return origin.kind === "rewrite" ? `the ${origin.role}'s rewrite rule` : `the ${origin.role}'s roots`;
223
+ if (origin.kind === "set") return ruleSetOrigin(origin.id);
224
+ return origin.kind === "rewrite" ? rewriteRuleOrigin(origin.role) : rootsOrigin(origin.role);
220
225
  }
221
226
 
222
227
  function contextOf(guard: CallGuard, origin: GuardRule["origin"]): string {
223
- if (origin.kind === "set") return `${RULE_SETS[origin.id].title} are refused during /${stepCommand(guard.step)}: do without this call.`;
224
- if (origin.kind === "rewrite") {
225
- return "This source file exists: change it by node (node_read for its sha256, then node_replace, node_insert or " +
226
- "node_ensure) or with edit_file, never by writing it whole; file_write only creates a file.";
227
- }
228
+ if (origin.kind === "set") return refusedDuringStep(RULE_SETS[origin.id].title, stepCommand(guard.step));
229
+ if (origin.kind === "rewrite") return CHANGE_EXISTING_SOURCE_BY_NODE;
228
230
  return origin.access === "read"
229
- ? `The ${origin.role} opens no source or test file by its path: work from the batch sheet and the plan.`
230
- : `The ${origin.role} writes outside these roots only: ${origin.role === "implementer" ? "leave the tests as they are" : "write the tests, no source file"}.`;
231
+ ? opensNoSourceOrTest(origin.role)
232
+ : writesOutsideRootsOnly(origin.role, origin.role === "implementer");
231
233
  }
232
234
 
233
235
  function ruleVerdict(guard: CallGuard, entry: GuardRule, how: string): CallVerdict {
234
236
  return {
235
237
  allow: false,
236
- reason: `${guard.step}: refused by '${formatRule(entry.rule)}' of ${originText(entry.origin)}${how}`,
238
+ reason: refusedByRule(guard.step, formatRule(entry.rule), originText(entry.origin), how),
237
239
  context: contextOf(guard, entry.origin),
238
240
  };
239
241
  }
240
242
 
241
243
  /**
242
- * One call, after the host's gate allowed it: refused when the host has no gate and the act's mode does not let
244
+ * One call, before the host's gate judges it: refused when the host has no gate and the act's mode does not let
243
245
  * it through, when a deny rule of the guard covers its input, or when it reaches below a covered folder through
244
246
  * a pattern of a folder reader; otherwise allowed. Allow rules are never read: the guard cannot widen the gate.
245
247
  * The hooks are not run here (the callbacks run them after an allow).
@@ -279,11 +281,11 @@ export function checkToolCall(
279
281
  for (const entry of guard.rules) {
280
282
  if (entry.rule.argument !== "path" || leftWritable(guard, entry, joined)) continue;
281
283
  if (matchesRule(entry.rule, tool, { ...args, path: joined })) {
282
- return ruleVerdict(guard, entry, `, which '${joined}' reaches`);
284
+ return ruleVerdict(guard, entry, whichPathReaches(joined));
283
285
  }
284
286
  if (entry.origin.kind === "role" && entry.origin.access === "read" && sameToolName(entry.rule.tool, tool)
285
287
  && reachesBelow(entry.rule, joined)) {
286
- return ruleVerdict(guard, entry, `, which '${joined}' can reach`);
288
+ return ruleVerdict(guard, entry, whichPathCanReach(joined));
287
289
  }
288
290
  }
289
291
  }
@@ -297,7 +299,7 @@ export interface ActFacts { mode: string; gateEnabled: boolean | undefined; newF
297
299
  const BATCH_SHAPE = `Give ${EDIT_BATCH_SHAPE}.`;
298
300
 
299
301
  function batchRefusal(guard: CallGuard, why: string, context = BATCH_SHAPE): CallVerdict {
300
- return { allow: false, reason: `${guard.step}: edit_batch refused: ${why}`, context };
302
+ return { allow: false, reason: editBatchRefused(guard.step, why), context };
301
303
  }
302
304
 
303
305
  /** An edit_batch, operation by operation: each is checked as the editor its `kind` stands for (OPERATION_TOOLS), with
@@ -307,19 +309,18 @@ function batchRefusal(guard: CallGuard, why: string, context = BATCH_SHAPE): Cal
307
309
  function checkOperations(guard: CallGuard, args: Readonly<Record<string, unknown>>, act: ActFacts): CallVerdict {
308
310
  const validate = args.validate;
309
311
  if (validate !== undefined && validate !== null && String(validate).trim().toLowerCase() !== "parse") {
310
- return batchRefusal(guard, `validate '${String(validate)}' is not run in a dev step`,
311
- "Use validate \"parse\" (the default); the build is run_build's, with the pack's command.");
312
+ return batchRefusal(guard, validateNotRun(String(validate)), USE_VALIDATE_PARSE);
312
313
  }
313
314
  const operations = args.operations;
314
- if (!Array.isArray(operations) || operations.length === 0) return batchRefusal(guard, "no list of operations");
315
+ if (!Array.isArray(operations) || operations.length === 0) return batchRefusal(guard, NO_LIST_OF_OPERATIONS);
315
316
  for (const [i, raw] of operations.entries()) {
316
317
  const op = raw !== null && typeof raw === "object" && !Array.isArray(raw) ? raw as Readonly<Record<string, unknown>> : null;
317
318
  const kind = typeof op?.kind === "string" ? op.kind.trim() : "";
318
319
  const editor = Object.entries(OPERATION_TOOLS).find(([k]) => sameToolName(k, kind))?.[1];
319
320
  if (op === null || typeof op.path !== "string" || op.path.trim() === "") {
320
- return batchRefusal(guard, `operation ${i + 1} names no path`);
321
+ return batchRefusal(guard, operationNamesNoPath(i + 1));
321
322
  }
322
- if (editor === undefined) return batchRefusal(guard, `operation ${i + 1} has the unknown kind '${kind}'`);
323
+ if (editor === undefined) return batchRefusal(guard, operationUnknownKind(i + 1, kind));
323
324
  const verdict = checkToolCall(guard, editor, op, { mode: act.mode, gateEnabled: act.gateEnabled });
324
325
  if (!verdict.allow) {
325
326
  return { allow: false, reason: `${verdict.reason} (edit_batch operation ${i + 1}, ${kind} on '${op.path}')`, context: verdict.context };
@@ -1,6 +1,7 @@
1
1
  // A text a brief carries so that the agent opens no file for it: a sheet, a test file, a diff.
2
2
  // Each one goes under its title in a fenced block; past the room given, a text is cut and says
3
3
  // so, the ones after it are left out and named, so the agent knows what it did not get. Pure.
4
+ import { cutLine, notCarried } from "./prompts/brief-blocks.ts";
4
5
 
5
6
  export interface CarriedText {
6
7
  /** What the text is: a path, or a sentence ("what F1 changed (git show ab700a7)"). */
@@ -16,9 +17,6 @@ export interface Carried {
16
17
  whole: ReadonlySet<string>;
17
18
  }
18
19
 
19
- /** The line a cut block ends with. */
20
- const CUT = (left: number): string => `… (cut: ${left} more characters)`;
21
-
22
20
  /** The fenced blocks of `texts`, in order, within `room` characters in all: a text past the room is cut with a
23
21
  * note, the ones after it are listed as not carried. Empty when nothing fits. */
24
22
  export function carriedBlocks(texts: readonly CarriedText[], room: number): string[] {
@@ -40,10 +38,10 @@ export function carry(texts: readonly CarriedText[], room: number): Carried {
40
38
  }
41
39
  const fits = body.length <= left - frame;
42
40
  if (fits && path !== undefined) whole.add(path);
43
- const kept = fits ? body : `${body.slice(0, left - frame - 40)}\n${CUT(body.length - (left - frame - 40))}`;
41
+ const kept = fits ? body : `${body.slice(0, left - frame - 40)}\n${cutLine(body.length - (left - frame - 40))}`;
44
42
  out.push(`### ${title}\n\`\`\`text\n${kept}\n\`\`\``);
45
43
  left -= frame + kept.length;
46
44
  }
47
- if (skipped.length > 0) out.push(`Not carried (no room left): ${skipped.join(", ")}.`);
45
+ if (skipped.length > 0) out.push(notCarried(skipped.join(", ")));
48
46
  return { blocks: out, whole };
49
47
  }
@@ -2,6 +2,7 @@
2
2
  // `<work>/learn-<date>/proposals.json` for --accept and --refuse to read, and the lines
3
3
  // those print. A decision applies nothing: it prints the change to make. Pure, no IO.
4
4
  import { sha1Hex } from "../sha1.ts";
5
+ import { acceptedHarness, acceptedRepository, hasTheWrongShape, THE_TOP_LEVEL } from "./messages.ts";
5
6
 
6
7
  export const LEARN_FOLDER_PATTERN: RegExp = /^learn-\d{4}-\d{2}-\d{2}$/;
7
8
  export function learnFolderName(date: string): string {
@@ -128,7 +129,7 @@ export function parseProposalsFile(text: string): { ok: true; file: ProposalsFil
128
129
  return { ok: false, problem: `not JSON (${(e instanceof Error ? e.message : String(e)).split("\n")[0]})` };
129
130
  }
130
131
  try {
131
- const o = obj(raw, "the top level");
132
+ const o = obj(raw, THE_TOP_LEVEL);
132
133
  if (o.version !== 1) throw new Shape("version");
133
134
  const read = obj(o.read, "read");
134
135
  const counts = Object.fromEntries(READ_KEYS.map((k) => [k, count(read, k, "read")])) as ProposalsFile["read"];
@@ -138,7 +139,7 @@ export function parseProposalsFile(text: string): { ok: true; file: ProposalsFil
138
139
  };
139
140
  return { ok: true, file };
140
141
  } catch (e) {
141
- if (e instanceof Shape) return { ok: false, problem: `${e.message} has the wrong shape` };
142
+ if (e instanceof Shape) return { ok: false, problem: hasTheWrongShape(e.message) };
142
143
  throw e;
143
144
  }
144
145
  }
@@ -169,7 +170,7 @@ export function patchLines(motif: Motif): string[] {
169
170
  /** The lines printed for a motif: the patch for a harness owner, the change to make for a repository owner. */
170
171
  export function acceptLines(motif: Motif): string[] {
171
172
  const head = motif.owner.kind === "harness"
172
- ? `accepted ${motif.id} — ${motif.title}: a harness file is never edited here; apply this in the orkeon-workshop repository:`
173
- : `accepted ${motif.id} — ${motif.title}: ${motif.owner.path} is not edited by /dev-learn; make the change in a batch (/dev-spec <code> refactor, or by hand):`;
173
+ ? acceptedHarness(motif.id, motif.title)
174
+ : acceptedRepository(motif.id, motif.title, motif.owner.path);
174
175
  return [head, ...patchLines(motif).map((l) => ` ${l}`)];
175
176
  }
@@ -1,6 +1,7 @@
1
1
  // The /dev-learn state: the verdict rows already treated and the decision taken on each
2
2
  // motif. Orkeon Code keeps its own file; the harness's file is only read, so a row the
3
3
  // harness treated is not proposed again here. Pure, no IO.
4
+ import { fieldHasTheWrongShape, THE_TOP_LEVEL } from "./messages.ts";
4
5
 
5
6
  /** Orkeon Code's own /dev-learn state, relative to /workspace (temp/04:172-175). */
6
7
  export const LEARN_STATE_FILE = ".orkeon/dev-learn-state.json";
@@ -42,14 +43,14 @@ function decisionRecord(v: unknown): DecisionRecord | null {
42
43
  export function parseLearnState(text: string | null): StateRead<LearnState> {
43
44
  if (text === null) return { ok: true, state: emptyLearnState() };
44
45
  const wrong = (field: string): StateRead<LearnState> =>
45
- ({ ok: false, problem: `${LEARN_STATE_FILE}: ${field} has the wrong shape` });
46
+ ({ ok: false, problem: fieldHasTheWrongShape(LEARN_STATE_FILE, field) });
46
47
  let raw: unknown;
47
48
  try {
48
49
  raw = JSON.parse(text);
49
50
  } catch (e) {
50
51
  return { ok: false, problem: `${LEARN_STATE_FILE} is not JSON (${firstLine(e)})` };
51
52
  }
52
- if (!isRecord(raw)) return wrong("the top level");
53
+ if (!isRecord(raw)) return wrong(THE_TOP_LEVEL);
53
54
  if (raw.version !== 1) return wrong("version");
54
55
  if (!isStringList(raw.treated)) return wrong("treated");
55
56
  if (!Array.isArray(raw.decisions)) return wrong("decisions");
@@ -0,0 +1,107 @@
1
+ // The markers of the dev workflow's files: the headings, verdict words and lines a prompt or a renderer writes and
2
+ // a parser of shared/domain/dev reads back (ADR 0026).
3
+
4
+ // ── Open questions and decisions ────────────────────────────────────────────
5
+
6
+ export const OPEN_QUESTIONS_HEADER = ["| # | Severity | Question | Impact | Options |", "|---|---|---|---|---|"];
7
+
8
+ export const DECISIONS_HEADER = ["| # | Question | Answer | Date |", "|---|---|---|---|"];
9
+
10
+ /** The option a person picks to keep a question open; never written as an option of the file. */
11
+ export const LEAVE_OPEN = "Leave it open";
12
+
13
+ export const RECOMMENDED_MARK = " (recommended)";
14
+
15
+ export const OPEN_QUESTIONS_HEADING = /^## .*Open questions/;
16
+
17
+ export const DECISIONS_HEADING = /^## (\d+\. )?Decisions\s*$/;
18
+
19
+ // ── Specs and change briefs ─────────────────────────────────────────────────
20
+
21
+ export const MUST_NOT_CHANGE = /^## (\d+\. )?What must not change/;
22
+
23
+ export const BLOCKING_CELL = /\| *Blocking *\|/;
24
+
25
+ export const ID_HEADING = /^#{3,4} (UC|BR|CH)-(\d+)\s*[—:-]\s*(.+)$/;
26
+
27
+ export const SPEC_TITLE = /^# (\S+) — (.+)$/;
28
+
29
+ export const BRIEF_TITLE = /^# (\S+) — (.+) — (bug|refactor|perf)\s*$/;
30
+
31
+ export const STATEMENT = "**Statement**";
32
+
33
+ // ── Plans and batch sheets ──────────────────────────────────────────────────
34
+
35
+ export const PLAN_TITLE = /^# (\S+)-PLAN — (.+)$/;
36
+
37
+ export const SUMMARY_HEADING = /^## 0\. Summary/;
38
+
39
+ export const BATCH_LINE = /^### Batch (F\d+) — (.+) — (open|done \((\d{4}-\d{2}-\d{2})\))$/;
40
+
41
+ export const BATCH_PREFIX = /^### Batch (F\d+) — (.*)$/;
42
+
43
+ export const STEP_BOX = /^- \[( |x|X)\] (\d+)\. (.*)$/;
44
+
45
+ export const SHEET_TITLE = /^# (\S+)-PLAN-(F\d+) — (.+?)( — done \((\d{4}-\d{2}-\d{2})\))?$/;
46
+
47
+ export const DEPENDS_ON = /\*\*Depends on\*\*: (.+)$/;
48
+
49
+ export const STEP_HEADING = /^### Step (\d+) — (.+)$/;
50
+
51
+ export const TDD_LINE = /^TDD: RED \[( |x|X)\] GREEN \[( |x|X)\] COST \[( |x|X)\]$/;
52
+
53
+ export const DONE_LINE = /^Done \((\d{4}-\d{2}-\d{2})\) — /;
54
+
55
+ export const ASSUMPTION_ROW = /^\|\s*(H\d+)\s*\|(.*)\|(.*)\|\s*$/;
56
+
57
+ export const ASSUMPTION_BULLET = /^- (H\d+) — (.*) — to be validated by (.+)$/;
58
+
59
+ export const TICKED_TDD_LINE = "TDD: RED [x] GREEN [x] COST [x]";
60
+
61
+ export const OPEN_BOX = /(RED|GREEN|COST) \[ \]/;
62
+
63
+ export const APPLIED_ROW = /^\| *Applied rules *\|/;
64
+
65
+ export const BUILD_STEP = "Build and tests";
66
+
67
+ /** The state a batch line carries once the plan's review left Blocking questions: written by /dev-plan, read
68
+ * back as a state of its own, no parse problem. */
69
+ export const BLOCKED_STATE = "blocked";
70
+
71
+ // ── Verdicts ────────────────────────────────────────────────────────────────
72
+
73
+ export const VERDICT_TITLE = /^# (\S+)-VERIFY-(F\d+) — (\d{4}-\d{2}-\d{2} \d{2}:\d{2}) — (\S+)$/;
74
+
75
+ export const VERDICT_HEADING = /^##\s+Verdict\s+—\s+(VALID|GAPS)\s*$/;
76
+
77
+ export const VALIDATIONS_LINE = /^Validations: (.+)$/;
78
+
79
+ export const NOT_RUN_LINE = /^Not run: (.+)$/;
80
+
81
+ export const MEASURE_LINE = /^Measure: (.+)$/;
82
+
83
+ export const CORRECTION_LINE = /^\s*→ \/dev-batches (\S+) (F\d+) — correction: (.+)$/m;
84
+
85
+ export const CLOSE_LINE = /^\s*→ \/dev-batches (\S+) (F\d+) --close\s*$/;
86
+
87
+ /** The gap of the row dev-verify writes when the step's budget stopped the audit: not a finding of the code, so
88
+ * neither the learning harvest nor a resumed audit takes it as one. Its reason goes in the evidence. */
89
+ export const AUDIT_UNFINISHED_GAP = "the audit did not finish: the step's budget ran out";
90
+
91
+ /** The opening of the line dev-verify writes when a batch is VALID; /dev-batches looks for it in the audit's output. */
92
+ export const batchValidOpening = (batch: string): string => `→ Batch ${batch} VALID.`;
93
+ /** The VALID line of a batch, at the start of a line of dev-verify's output. */
94
+ export const batchValidLine = (batch: string): RegExp =>
95
+ new RegExp("^" + batchValidOpening(batch).replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "m");
96
+
97
+ // ── Written by /dev-plan's sheet, read and edited by /dev-implement ─────────
98
+
99
+ export const ASSUMPTIONS_SECTION = "## Assumptions";
100
+ export const ASSUMPTIONS_TABLE_HEAD = ["| # | Assumption | To be validated by |", "|---|------------|--------------------|"];
101
+ export const DECISIONS_SECTION = "## Decisions";
102
+ /** The TDD line of a step not yet run: TDD_LINE reads it, OPEN_BOX finds its boxes. */
103
+ export const OPEN_TDD_LINE = "TDD: RED [ ] GREEN [ ] COST [ ]";
104
+ /** The name of the sheet's test policy section, after its `## `. */
105
+ export const TEST_POLICY_SECTION = "Test policy and scopes";
106
+ /** The head of a step's test table, in a sheet and in a correction step. */
107
+ export const STEP_TESTS_TABLE_HEAD = ["| # | Test | Level | Project | Ids |", "|---|------|-------|---------|-----|"];