orkeon-code 1.0.0-rc.1 → 1.0.0-rc.3

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 (443) hide show
  1. package/.orkeon-runtime +11 -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 +508 -80
  13. package/orkeon-code.ps1 +129 -11
  14. package/package.json +3 -1
  15. package/scripts/dev-run.sh +139 -0
  16. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  17. package/src/commands/_lib/args.ts +5 -4
  18. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  19. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  20. package/src/commands/_lib/dev/dev-source.ts +7 -11
  21. package/src/commands/_lib/dev/dev.ts +34 -37
  22. package/src/commands/_lib/dev/markers.ts +7 -0
  23. package/src/commands/_lib/dev/messages.ts +112 -0
  24. package/src/commands/_lib/dev-step.ts +16 -13
  25. package/src/commands/_lib/dispatch.ts +62 -39
  26. package/src/commands/_lib/git/branch.ts +9 -10
  27. package/src/commands/_lib/git/commit.ts +9 -13
  28. package/src/commands/_lib/git/diff.ts +22 -12
  29. package/src/commands/_lib/git/messages.ts +54 -0
  30. package/src/commands/_lib/git/review.ts +9 -10
  31. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  32. package/src/commands/_lib/memory/memory.ts +3 -2
  33. package/src/commands/_lib/memory/messages.ts +32 -0
  34. package/src/commands/_lib/messages.ts +48 -0
  35. package/src/commands/_lib/project/messages.ts +8 -0
  36. package/src/commands/_lib/session/export.ts +3 -2
  37. package/src/commands/_lib/session/messages.ts +87 -0
  38. package/src/commands/_lib/session/prompts.ts +4 -0
  39. package/src/commands/_lib/session/resume.ts +15 -24
  40. package/src/commands/_lib/session/tasks.ts +20 -23
  41. package/src/commands/_lib/settings/advisor.ts +11 -16
  42. package/src/commands/_lib/settings/agents.ts +18 -28
  43. package/src/commands/_lib/settings/choices.ts +8 -0
  44. package/src/commands/_lib/settings/config.ts +43 -43
  45. package/src/commands/_lib/settings/effort.ts +147 -0
  46. package/src/commands/_lib/settings/hooks.ts +12 -20
  47. package/src/commands/_lib/settings/messages.ts +408 -0
  48. package/src/commands/_lib/settings/mode.ts +33 -24
  49. package/src/commands/_lib/settings/model.ts +71 -36
  50. package/src/commands/_lib/settings/output-style.ts +39 -0
  51. package/src/commands/_lib/settings/permissions.ts +71 -93
  52. package/src/commands/_lib/settings/route.ts +63 -0
  53. package/src/commands/_lib/settings/skills.ts +53 -11
  54. package/src/commands/_lib/settings/theme.ts +42 -0
  55. package/src/commands/_lib/speech/messages.ts +58 -0
  56. package/src/commands/_lib/speech/prompts.ts +4 -0
  57. package/src/commands/_lib/speech/say.ts +9 -10
  58. package/src/commands/_lib/speech/transcribe.ts +14 -23
  59. package/src/commands/_lib/speech/voice.ts +14 -18
  60. package/src/commands/_lib/status/doctor.ts +47 -28
  61. package/src/commands/_lib/status/messages.ts +101 -0
  62. package/src/commands/_lib/status/meta.ts +5 -25
  63. package/src/commands/_lib/status/status.ts +10 -11
  64. package/src/commands/_lib/status/usage-tools.ts +2 -3
  65. package/src/commands/_lib/status/usage.ts +7 -18
  66. package/src/commands/_lib/view.ts +6 -1
  67. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  68. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  69. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  70. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  71. package/src/commands/git/commit.cmd.ts +3 -3
  72. package/src/commands/git/review.cmd.ts +3 -3
  73. package/src/commands/memory/memory.cmd.ts +2 -2
  74. package/src/commands/project/analyze.cmd.ts +3 -3
  75. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  76. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  77. package/src/commands/project/init.cmd.ts +3 -3
  78. package/src/commands/project/verify.cmd.ts +2 -2
  79. package/src/commands/session/assistant.cmd.ts +2 -2
  80. package/src/commands/session/compact.cmd.ts +1 -1
  81. package/src/commands/session/copy.cmd.ts +8 -7
  82. package/src/commands/session/rename.cmd.ts +3 -2
  83. package/src/commands/session/rewind.cmd.ts +3 -4
  84. package/src/commands/session/summary.cmd.ts +3 -3
  85. package/src/commands/session/tasks.cmd.ts +4 -2
  86. package/src/commands/settings/config.cmd.ts +4 -2
  87. package/src/commands/settings/effort.cmd.ts +10 -31
  88. package/src/commands/settings/fast.cmd.ts +2 -1
  89. package/src/commands/settings/mode.cmd.ts +3 -3
  90. package/src/commands/settings/model.cmd.ts +3 -2
  91. package/src/commands/settings/output-style.cmd.ts +9 -38
  92. package/src/commands/settings/permissions.cmd.ts +2 -2
  93. package/src/commands/settings/proactive.cmd.ts +2 -1
  94. package/src/commands/settings/route.cmd.ts +16 -0
  95. package/src/commands/settings/skills.cmd.ts +3 -3
  96. package/src/commands/settings/theme.cmd.ts +14 -0
  97. package/src/commands/speech/say.cmd.ts +2 -2
  98. package/src/commands/speech/transcribe.cmd.ts +2 -2
  99. package/src/commands/status/release-notes.cmd.ts +1 -1
  100. package/src/crews/.orkeon/orkeon.d.ts +539 -94
  101. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  102. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  103. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  104. package/src/crews/_probe-shared-memory/probe.ork.ts +8 -6
  105. package/src/crews/advisor/application/messages.ts +4 -0
  106. package/src/crews/advisor/application/prompts.ts +4 -0
  107. package/src/crews/advisor/application/run-advisor.ts +2 -1
  108. package/src/crews/advisor/crew.ork.ts +6 -5
  109. package/src/crews/advisor/domain/advice.ts +7 -23
  110. package/src/crews/advisor/domain/messages.ts +8 -0
  111. package/src/crews/advisor/domain/prompts.ts +26 -0
  112. package/src/crews/agent-run/application/messages.ts +18 -0
  113. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  114. package/src/crews/agent-run/crew.ork.ts +4 -4
  115. package/src/crews/analyze/application/messages.ts +27 -0
  116. package/src/crews/analyze/application/prompts.ts +4 -0
  117. package/src/crews/analyze/application/run-analyze.ts +16 -14
  118. package/src/crews/analyze/crew.ork.ts +5 -4
  119. package/src/crews/analyze/domain/harvest.ts +33 -65
  120. package/src/crews/analyze/domain/prompts.ts +86 -0
  121. package/src/crews/code-review/application/lens-material.ts +24 -0
  122. package/src/crews/code-review/application/messages.ts +17 -0
  123. package/src/crews/code-review/application/prompts.ts +10 -17
  124. package/src/crews/code-review/application/review.ts +4 -1
  125. package/src/crews/code-review/application/run-code-review.ts +13 -15
  126. package/src/crews/code-review/crew.ork.ts +6 -5
  127. package/src/crews/code-review/domain/lenses.ts +6 -45
  128. package/src/crews/code-review/domain/messages.ts +25 -0
  129. package/src/crews/code-review/domain/prompts.ts +58 -0
  130. package/src/crews/code-review/domain/report.ts +5 -6
  131. package/src/crews/code-review/domain/scope.ts +6 -12
  132. package/src/crews/dev-batches/application/messages.ts +127 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  134. package/src/crews/dev-batches/application/prompts.ts +10 -0
  135. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  136. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  137. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  138. package/src/crews/dev-batches/crew.ork.ts +13 -10
  139. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  140. package/src/crews/dev-batches/domain/markers.ts +5 -0
  141. package/src/crews/dev-batches/domain/messages.ts +6 -0
  142. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  143. package/src/crews/dev-change/application/change-material.ts +44 -0
  144. package/src/crews/dev-change/application/evidence.ts +25 -22
  145. package/src/crews/dev-change/application/messages.ts +81 -0
  146. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  147. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  148. package/src/crews/dev-change/crew.ork.ts +11 -9
  149. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  150. package/src/crews/dev-change/domain/change-render.ts +14 -16
  151. package/src/crews/dev-change/domain/markers.ts +28 -0
  152. package/src/crews/dev-change/domain/messages.ts +16 -0
  153. package/src/crews/dev-implement/application/close.ts +21 -18
  154. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  155. package/src/crews/dev-implement/application/messages.ts +161 -0
  156. package/src/crews/dev-implement/application/observe.ts +4 -2
  157. package/src/crews/dev-implement/application/prompts.ts +9 -0
  158. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  159. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  160. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  161. package/src/crews/dev-implement/crew.ork.ts +2 -1
  162. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  163. package/src/crews/dev-implement/domain/correction.ts +16 -15
  164. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  165. package/src/crews/dev-implement/domain/markers.ts +23 -0
  166. package/src/crews/dev-implement/domain/messages.ts +58 -0
  167. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  168. package/src/crews/dev-implement/domain/roles.ts +3 -7
  169. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  170. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  171. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  172. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  173. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  174. package/src/crews/dev-learn/application/messages.ts +56 -0
  175. package/src/crews/dev-learn/application/prompts.ts +96 -0
  176. package/src/crews/dev-learn/application/run-dev-learn.ts +51 -43
  177. package/src/crews/dev-learn/crew.ork.ts +5 -4
  178. package/src/crews/dev-learn/domain/learn-answer.ts +60 -37
  179. package/src/crews/dev-learn/domain/markers.ts +10 -0
  180. package/src/crews/dev-learn/domain/messages.ts +74 -0
  181. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  182. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  183. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  184. package/src/crews/dev-plan/application/inventory.ts +17 -13
  185. package/src/crews/dev-plan/application/messages.ts +88 -0
  186. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  187. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  188. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  189. package/src/crews/dev-plan/crew.ork.ts +12 -9
  190. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  191. package/src/crews/dev-plan/domain/markers.ts +18 -0
  192. package/src/crews/dev-plan/domain/messages.ts +118 -0
  193. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  194. package/src/crews/dev-plan/domain/plan-render.ts +33 -34
  195. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  196. package/src/crews/dev-spec/application/messages.ts +30 -0
  197. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  198. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  199. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  200. package/src/crews/dev-spec/crew.ork.ts +11 -9
  201. package/src/crews/dev-spec/domain/markers.ts +30 -0
  202. package/src/crews/dev-spec/domain/messages.ts +39 -0
  203. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  204. package/src/crews/dev-spec/domain/spec-render.ts +21 -21
  205. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  206. package/src/crews/dev-verify/application/audit.ts +38 -30
  207. package/src/crews/dev-verify/application/capture.ts +34 -26
  208. package/src/crews/dev-verify/application/messages.ts +119 -0
  209. package/src/crews/dev-verify/application/prompts.ts +209 -0
  210. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  211. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  212. package/src/crews/dev-verify/crew.ork.ts +7 -7
  213. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  214. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  215. package/src/crews/dev-verify/domain/commands.ts +3 -3
  216. package/src/crews/dev-verify/domain/gate.ts +21 -16
  217. package/src/crews/dev-verify/domain/markers.ts +16 -0
  218. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  219. package/src/crews/dev-verify/domain/messages.ts +92 -0
  220. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  221. package/src/crews/git-commit/application/draft.ts +38 -55
  222. package/src/crews/git-commit/application/messages.ts +17 -0
  223. package/src/crews/git-commit/application/prompts.ts +47 -0
  224. package/src/crews/git-commit/application/run-git-commit.ts +16 -13
  225. package/src/crews/git-commit/crew.ork.ts +6 -5
  226. package/src/crews/git-commit/domain/commit.ts +15 -35
  227. package/src/crews/git-commit/domain/markers.ts +4 -0
  228. package/src/crews/git-commit/domain/messages.ts +48 -0
  229. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  230. package/src/crews/init-verifiers/application/messages.ts +13 -0
  231. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  232. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  233. package/src/crews/init-verifiers/crew.ork.ts +6 -5
  234. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  235. package/src/crews/main-loop/application/messages.ts +81 -0
  236. package/src/crews/main-loop/application/prompts.ts +12 -0
  237. package/src/crews/main-loop/application/run-main-loop.ts +64 -31
  238. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  239. package/src/crews/main-loop/crew.ork.ts +12 -7
  240. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  241. package/src/crews/main-loop/domain/prompts.ts +336 -0
  242. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  243. package/src/crews/project-init/application/detect.ts +5 -4
  244. package/src/crews/project-init/application/messages.ts +15 -0
  245. package/src/crews/project-init/application/prompts.ts +11 -7
  246. package/src/crews/project-init/crew.ork.ts +6 -5
  247. package/src/crews/project-init/domain/existing-files.ts +6 -4
  248. package/src/crews/project-init/domain/messages.ts +13 -0
  249. package/src/crews/project-init/domain/package-map.ts +3 -3
  250. package/src/crews/project-init/domain/prompts.ts +10 -0
  251. package/src/crews/session-compact/application/prompts.ts +5 -0
  252. package/src/crews/session-compact/crew.ork.ts +6 -5
  253. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  254. package/src/crews/shared-memory-admit/crew.ork.ts +4 -3
  255. package/src/crews/speech/application/messages.ts +3 -0
  256. package/src/crews/speech/application/prompts.ts +3 -0
  257. package/src/crews/speech/application/run-speech.ts +2 -1
  258. package/src/crews/speech/crew.ork.ts +2 -1
  259. package/src/shared/application/agents/child-agent.ts +11 -7
  260. package/src/shared/application/agents/messages.ts +35 -0
  261. package/src/shared/application/agents/route-agent.ts +115 -0
  262. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  263. package/src/shared/application/compaction/compact-session.ts +19 -14
  264. package/src/shared/application/compaction/messages.ts +20 -0
  265. package/src/shared/application/compaction/prune-context.ts +94 -0
  266. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  267. package/src/shared/application/dev/brief-inventory.ts +6 -4
  268. package/src/shared/application/dev/close-batch.ts +9 -7
  269. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  270. package/src/shared/application/dev/learn-decision.ts +20 -18
  271. package/src/shared/application/dev/load-dev-context.ts +7 -8
  272. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  273. package/src/shared/application/dev/messages.ts +135 -0
  274. package/src/shared/application/dev/phase-timer.ts +54 -0
  275. package/src/shared/application/dev/plan-source.ts +12 -8
  276. package/src/shared/application/dev/preflight.ts +16 -11
  277. package/src/shared/application/dev/prompts.ts +34 -0
  278. package/src/shared/application/dev/question-round.ts +25 -17
  279. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  280. package/src/shared/application/dev/settle-questions.ts +4 -2
  281. package/src/shared/application/dev/source-review.ts +12 -8
  282. package/src/shared/application/dev/source-step.ts +12 -10
  283. package/src/shared/application/dev/spend.ts +17 -4
  284. package/src/shared/application/dev/step-precedents.ts +2 -1
  285. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  286. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  287. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  288. package/src/shared/application/dev/verdict-sources.ts +5 -3
  289. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  290. package/src/shared/application/extra-tools.ts +2 -1
  291. package/src/shared/application/git/batch-worktree.ts +22 -17
  292. package/src/shared/application/git/commit-files.ts +24 -19
  293. package/src/shared/application/git/merge-batch.ts +11 -7
  294. package/src/shared/application/git/messages.ts +75 -0
  295. package/src/shared/application/git/open-pull-request.ts +4 -3
  296. package/src/shared/application/host-context.ts +59 -0
  297. package/src/shared/application/host-layout-store.ts +45 -0
  298. package/src/shared/application/llm-profile.ts +4 -3
  299. package/src/shared/application/messages.ts +14 -0
  300. package/src/shared/application/permission-rules.ts +10 -0
  301. package/src/shared/application/ports/decision.ts +14 -0
  302. package/src/shared/application/ports/human.ts +25 -0
  303. package/src/shared/application/ports/llm.ts +32 -3
  304. package/src/shared/application/ports/memory.ts +1 -1
  305. package/src/shared/application/ports/theme.ts +11 -0
  306. package/src/shared/application/ports.ts +4 -2
  307. package/src/shared/application/session-io.ts +2 -1
  308. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  309. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  310. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  311. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  312. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  313. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  314. package/src/shared/application/shared-memory/messages.ts +63 -0
  315. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  316. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  317. package/src/shared/application/skills/messages.ts +4 -0
  318. package/src/shared/application/skills/suggest-skills.ts +102 -0
  319. package/src/shared/application/workflow/messages.ts +8 -0
  320. package/src/shared/application/workflow/workflow-state.ts +7 -6
  321. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  322. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  323. package/src/shared/domain/agent-policy/messages.ts +66 -0
  324. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  325. package/src/shared/domain/agent-policy/permission.ts +20 -18
  326. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  327. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  328. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  329. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  330. package/src/shared/domain/agent-registry.ts +6 -5
  331. package/src/shared/domain/agents/chain.ts +2 -2
  332. package/src/shared/domain/agents/charter.ts +8 -5
  333. package/src/shared/domain/agents/exclusive.ts +2 -1
  334. package/src/shared/domain/agents/instances.ts +18 -15
  335. package/src/shared/domain/agents/messages.ts +39 -0
  336. package/src/shared/domain/agents/model-route.ts +199 -0
  337. package/src/shared/domain/agents/prompts.ts +20 -0
  338. package/src/shared/domain/code-intel-contract.ts +5 -4
  339. package/src/shared/domain/code-intel-routing.ts +8 -61
  340. package/src/shared/domain/compact-outcome.ts +5 -3
  341. package/src/shared/domain/compaction-thresholds.ts +2 -1
  342. package/src/shared/domain/compaction.ts +22 -113
  343. package/src/shared/domain/config-schema.ts +94 -81
  344. package/src/shared/domain/context-prune.ts +176 -0
  345. package/src/shared/domain/decision/questions.ts +102 -0
  346. package/src/shared/domain/dev/access-cost.ts +19 -15
  347. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  348. package/src/shared/domain/dev/build-commands.ts +5 -4
  349. package/src/shared/domain/dev/call-guard.ts +29 -28
  350. package/src/shared/domain/dev/carried-text.ts +3 -5
  351. package/src/shared/domain/dev/learn-proposals.ts +51 -12
  352. package/src/shared/domain/dev/learn-state.ts +3 -2
  353. package/src/shared/domain/dev/markers.ts +127 -0
  354. package/src/shared/domain/dev/messages.ts +271 -0
  355. package/src/shared/domain/dev/phase-timing.ts +50 -0
  356. package/src/shared/domain/dev/plan-checks.ts +24 -23
  357. package/src/shared/domain/dev/plan-format.ts +15 -25
  358. package/src/shared/domain/dev/project-files.ts +1 -15
  359. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  360. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  361. package/src/shared/domain/dev/questions.ts +33 -15
  362. package/src/shared/domain/dev/repo-pack.ts +12 -9
  363. package/src/shared/domain/dev/review-answer.ts +40 -17
  364. package/src/shared/domain/dev/review-brief.ts +54 -0
  365. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  366. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  367. package/src/shared/domain/dev/spec-format.ts +13 -14
  368. package/src/shared/domain/dev/step-budget.ts +4 -2
  369. package/src/shared/domain/dev/step-rules.ts +3 -4
  370. package/src/shared/domain/dev/test-commands.ts +14 -10
  371. package/src/shared/domain/dev/tool-guards.ts +4 -3
  372. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  373. package/src/shared/domain/dev/verdict-format.ts +14 -21
  374. package/src/shared/domain/dev/whitespace.ts +3 -2
  375. package/src/shared/domain/dev/work-folder.ts +6 -4
  376. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  377. package/src/shared/domain/error-text.ts +13 -0
  378. package/src/shared/domain/git/close.ts +14 -11
  379. package/src/shared/domain/git/messages.ts +41 -0
  380. package/src/shared/domain/git/pull-request.ts +5 -5
  381. package/src/shared/domain/host-layout.ts +147 -0
  382. package/src/shared/domain/host-paths.ts +399 -0
  383. package/src/shared/domain/llm-failure.ts +35 -7
  384. package/src/shared/domain/llm-profile.ts +22 -3
  385. package/src/shared/domain/marked-message.ts +1 -5
  386. package/src/shared/domain/markers.ts +30 -0
  387. package/src/shared/domain/messages.ts +291 -0
  388. package/src/shared/domain/model-catalog.ts +2 -9
  389. package/src/shared/domain/permission-modes.ts +4 -8
  390. package/src/shared/domain/prelude.ts +2 -2
  391. package/src/shared/domain/project-manifests.ts +3 -2
  392. package/src/shared/domain/prompts.ts +233 -0
  393. package/src/shared/domain/search-routing.ts +3 -11
  394. package/src/shared/domain/secret-patterns.ts +3 -2
  395. package/src/shared/domain/session-keys.ts +7 -0
  396. package/src/shared/domain/session-start.ts +3 -2
  397. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  398. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  399. package/src/shared/domain/shared-memory/entry.ts +26 -20
  400. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  401. package/src/shared/domain/shared-memory/gate.ts +4 -3
  402. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  403. package/src/shared/domain/shared-memory/layout.ts +11 -8
  404. package/src/shared/domain/shared-memory/markers.ts +9 -0
  405. package/src/shared/domain/shared-memory/messages.ts +66 -0
  406. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  407. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  408. package/src/shared/domain/shared-memory/refused.ts +3 -3
  409. package/src/shared/domain/skills/prompts.ts +4 -0
  410. package/src/shared/domain/skills/shortlist.ts +149 -0
  411. package/src/shared/domain/snip-turns.ts +2 -14
  412. package/src/shared/domain/speech.ts +2 -1
  413. package/src/shared/domain/tool-trace.ts +5 -7
  414. package/src/shared/domain/verifiers.ts +7 -11
  415. package/src/shared/domain/vfs.ts +8 -1
  416. package/src/shared/domain/workflow/prompts.ts +15 -0
  417. package/src/shared/domain/workflow/state-file.ts +14 -12
  418. package/src/shared/infrastructure/globals.ts +7 -2
  419. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  420. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  421. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  422. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  423. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  424. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  425. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  426. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  427. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  428. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  429. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  430. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  431. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  432. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  433. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  434. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  435. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  436. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  437. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  438. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  439. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  440. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  441. package/src/crews/dev-learn/application/learn-prompt.ts +0 -140
  442. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  443. package/src/shared/domain/session-summary.ts +0 -13
@@ -12,9 +12,11 @@ import { gateLineText, runGateChecks } from "../domain/gate.ts";
12
12
  import type { SheetFacts } from "../domain/sheet-facts.ts";
13
13
  import { sheetFacts } from "../domain/sheet-facts.ts";
14
14
  import {
15
- GIT_CHANGED_TRACKED, GIT_DIFF_CHECK, UNQUOTABLE_SCOPE, buildOutputProblem, excludePathspecs, gitTraitGrep, gitUntracked,
15
+ GIT_CHANGED_TRACKED, GIT_DIFF_CHECK, buildOutputProblem, excludePathspecs, gitTraitGrep, gitUntracked,
16
16
  } from "../domain/commands.ts";
17
17
  import { WORKSPACE } from "../../../shared/domain/vfs.ts";
18
+ import { gateGreen, gateHeader, gateRed, UNQUOTABLE_SCOPE_REASON } from "../domain/messages.ts";
19
+ import { gateCouldNotRun, gateExit, outputCutByRuntime, planFileNotRead, sheetUnreadable } from "./messages.ts";
18
20
 
19
21
  const MAX_PLAN_ENTRIES = 500;
20
22
  const MAX_PLAN_FILES = 60;
@@ -72,15 +74,15 @@ async function runOrRefuse(
72
74
  try {
73
75
  result = await shell.run(command);
74
76
  } catch (error) {
75
- throw new GateCommandError(`the gate could not run '${command}': ${errorLine(error)}`);
77
+ throw new GateCommandError(gateCouldNotRun(command, errorLine(error)));
76
78
  }
77
79
  if (result.exitCode !== -1 && !okExits.includes(result.exitCode)) {
78
80
  const why = firstLine(result.stderr);
79
- throw new GateCommandError(`the gate could not run '${command}': exit ${result.exitCode}${why === "" ? "" : ` (${why})`}`);
81
+ throw new GateCommandError(gateExit(command, result.exitCode, why));
80
82
  }
81
83
  const { kept, omitted } = runtimeCut(result.stdout);
82
84
  const cut = omitted > 0
83
- ? { kind: "FAIL" as const, text: `the output of '${command}' was cut by the runtime (${omitted} characters omitted): the list is incomplete, run the gate again on a smaller change` }
85
+ ? { kind: "FAIL" as const, text: outputCutByRuntime(command, omitted) }
84
86
  : null;
85
87
  return { stdout: kept, cut };
86
88
  }
@@ -91,9 +93,9 @@ function withChecks(report: GateReport, input: { batch: string; sheetShown: stri
91
93
  const checks = [...report.checks, ...extra];
92
94
  const green = !checks.some((c) => c.kind === "FAIL");
93
95
  const lines = [
94
- `GATE — batch ${input.batch} — sheet ${input.sheetShown}`,
96
+ gateHeader(input.batch, input.sheetShown),
95
97
  ...checks.map(gateLineText),
96
- green ? `GATE — batch ${input.batch}: GREEN` : `GATE — batch ${input.batch}: RED — fix and run again, no audit before`,
98
+ green ? gateGreen(input.batch) : gateRed(input.batch),
97
99
  ];
98
100
  return { ...report, green, lines, checks };
99
101
  }
@@ -113,7 +115,7 @@ async function planTexts(files: Pick<Files, "read" | "list">, planDir: string) {
113
115
  const md = names.filter((n) => n.endsWith(".md")).sort(byCodeUnit);
114
116
  const ordered = [...md.filter(isPlan), ...md.filter((n) => !isPlan(n))];
115
117
  for (const name of ordered.slice(MAX_PLAN_FILES)) {
116
- warnings.push({ kind: "note", text: `plan folder: ${name} not read (beyond the first ${MAX_PLAN_FILES} .md files, *-PLAN*.md first)` });
118
+ warnings.push({ kind: "note", text: planFileNotRead(name, MAX_PLAN_FILES) });
117
119
  }
118
120
  for (const name of ordered.slice(0, MAX_PLAN_FILES)) {
119
121
  let text: string;
@@ -145,7 +147,7 @@ export async function runGate(
145
147
  try {
146
148
  sheet = await deps.files.read(`${WORKSPACE}/${target.sheetShown}`);
147
149
  } catch (error) {
148
- return { ok: false, error: `the sheet ${target.sheetShown} cannot be read (${errorLine(error)})` };
150
+ return { ok: false, error: sheetUnreadable(target.sheetShown, errorLine(error)) };
149
151
  }
150
152
  const { texts: plan, warnings } = await planTexts(deps.files, `${WORKSPACE}/${target.planDirShown}`);
151
153
 
@@ -164,7 +166,7 @@ export async function runGate(
164
166
  if (trait !== null && facts.ids.length > 0) {
165
167
  const command = gitTraitGrep(trait.ere, roots.length > 0 ? roots : ["."], excludes);
166
168
  if (command === null) {
167
- extra.push({ kind: "FAIL", text: `rule traits: ${UNQUOTABLE_SCOPE}` });
169
+ extra.push({ kind: "FAIL", text: `rule traits: ${UNQUOTABLE_SCOPE_REASON}` });
168
170
  } else {
169
171
  // git grep exits 1 when nothing matches.
170
172
  const grep = await runOrRefuse(deps.shell, command, [0, 1]);
@@ -10,12 +10,12 @@
10
10
  // batches become candidates under memory.dir and /dev-learn is nudged at two (M-7).
11
11
  // A red gate or --gate-only returns the gate lines without any model call. The auditor's act runs in a
12
12
  // background child, `dev-auditor`, which /tasks lists and stops while it runs (A-3,
13
- // shared/application/agents/child-agent.ts); on a host without background children it runs inline.
13
+ // shared/application/agents/child-agent.ts).
14
14
  //
15
15
  // Input (globalThis.inputs): { batch: "F<n>", plan?: string | null, mode?: "fast" | "full" | "resume", gateOnly?: boolean,
16
16
  // hooks?: the /hooks registry, effort?: "low" | "medium" | "high" | "xhigh" | "max" | null,
17
17
  // concurrency?: number, maxInstances?: number, memoryRecall?: false (a session rule denies it) }
18
- // Run standalone: bash scripts/run-crew.sh src/crews/dev-verify/crew.ork.ts --inputs '{"batch":"F1","gateOnly":true}'
18
+ // Run standalone: ./orkeon-code run dev-verify --inputs '{"batch":"F1","gateOnly":true}'
19
19
  //
20
20
  // Budget: under full, the build (900 s), the whole suite (900 s) and three validations
21
21
  // (300 s each) can all run, plus the model's own time: one hour of wall time.
@@ -24,7 +24,7 @@ import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infr
24
24
  import { runValidationTool, scriptToolSlot } from "../../shared/infrastructure/orkeon/script-tools.ts";
25
25
  import type { ValidationCalls } from "../../shared/infrastructure/orkeon/script-tools.ts";
26
26
  import { STEP_BUDGETS } from "../../shared/domain/dev/step-budget.ts";
27
- import { orkeonAgent, orkeonClock, orkeonSessionIo } from "../../shared/infrastructure/orkeon/wiring.ts";
27
+ import { orkeonActRoute, orkeonAgent, orkeonClock, orkeonPrunedLlm, orkeonSessionIo } from "../../shared/infrastructure/orkeon/wiring.ts";
28
28
  import { memoryRecallOn, memoryRecallTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
29
29
  import { agentTools, verifyCallbacks, verifyDeps } from "../../shared/infrastructure/orkeon/dev-deps.ts";
30
30
  import { childAgentBody, withChildAct } from "../../shared/infrastructure/orkeon/child-agents.ts";
@@ -44,7 +44,7 @@ const limits = instanceLimits(inputs());
44
44
  const validationSlot = scriptToolSlot<ValidationCalls>();
45
45
  // memory_recall's ports: over the tools of the verifier's body (dev-deps.ts), never the global's.
46
46
  const bodyTools = agentTools();
47
- // The host's gate first, then these callbacks: the step's rule sets again and the /hooks the command passed,
47
+ // These callbacks, then the host's gate on the input they return (Orkeon #303): the step's rule sets again and the /hooks the command passed,
48
48
  // over the tools of the body that acts (the verifier's, or the background auditor's own).
49
49
  const options = { hooks: inputs().hooks, effort, memoryOn };
50
50
  const callbacksFor = (ctx: any) => verifyCallbacks(ctx, options);
@@ -59,7 +59,7 @@ const auditorChild = () => {
59
59
  .withAutonomousTool(runValidationTool(ToolBuilder, validationSlot))
60
60
  .withAutonomousTools(memoryRecallTools(ToolBuilder, bodyTools.memoryPorts(), memoryOn))
61
61
  .maxIterations(AUDITOR_CHARTER.maxIterations)
62
- .body(childAgentBody(callbacksFor));
62
+ .body(childAgentBody(callbacksFor, (llm, ctx) => orkeonPrunedLlm(llm, ctx.log, ctx.tools)));
63
63
  return effort === undefined ? builder : builder.effort(effort);
64
64
  };
65
65
 
@@ -67,7 +67,7 @@ const verifier = orkeonAgent()
67
67
  .name("dev-verifier")
68
68
  .role(AUDITOR_CHARTER.role)
69
69
  .goal(AUDITOR_CHARTER.goal)
70
- // The auditor's tools, for the inline audit on a host without background children.
70
+ // The auditor's tools.
71
71
  .tools(charterCatalogue(AUDITOR_CHARTER))
72
72
  .withAutonomousTool(runValidationTool(ToolBuilder, validationSlot))
73
73
  .withAutonomousTools(memoryRecallTools(ToolBuilder, bodyTools.memoryPorts(), memoryOn))
@@ -84,7 +84,7 @@ const verifier = orkeonAgent()
84
84
  wrapLlm: (llm) => withChildAct(llm, ctx, crew, { board, clock, log: ctx.log, effort },
85
85
  { agent: AUDITOR_CHARTER.name, charter: AUDITOR_CHARTER.name, task: `audit of ${String(inputs().batch ?? "the batch")}`, builder: auditorChild }),
86
86
  });
87
- return await runDevVerify(inputs(), deps);
87
+ return await runDevVerify(inputs(), { ...deps, route: orkeonActRoute(ctx.log, ctx.tools) });
88
88
  } finally {
89
89
  await board.close();
90
90
  }
@@ -7,6 +7,10 @@ import type { Severity } from "../../../shared/domain/dev/verdict-format.ts";
7
7
  import { AXES } from "../../../shared/domain/dev/verdict-format.ts";
8
8
  import type { Axis } from "../../../shared/domain/dev/verdict-format.ts";
9
9
  import type { Checked } from "../../../shared/domain/agents/charter.ts";
10
+ import { rowAxis, rowFieldEmpty, rowNoCitation, rowSeverity, tooManyValidations, UNDECIDED_NOT_LIST, undecidedIncomplete, VALIDATIONS_NOT_LIST, VERDICT_VALID_OR_GAPS } from "./messages.ts";
11
+ import {
12
+ ANSWER_NOT_AN_OBJECT as ANSWER_NOT_OBJECT, atMostRows as tooManyRows, ROWS_MUST_BE_A_LIST as ROWS_NOT_LIST,
13
+ } from "../../../shared/domain/dev/messages.ts";
10
14
 
11
15
  /** The axes live with the verdict format; re-exported for this crew's importers. */
12
16
  export { AXES };
@@ -95,30 +99,30 @@ function checkRow(value: unknown, k: number, problems: string[]): AuditRow | und
95
99
  const item = isPlainObject(value) ? value : {};
96
100
  const before = problems.length;
97
101
  const severity = text(item.severity);
98
- if (!SEVERITY_ORDER.includes(severity as Severity)) problems.push(`row ${k}: severity must be Blocking, Major or Minor`);
102
+ if (!SEVERITY_ORDER.includes(severity as Severity)) problems.push(rowSeverity(k));
99
103
  const label = text(item.axis);
100
104
  const axis = axisOf(label);
101
- if (axis === undefined) problems.push(`row ${k}: axis '${label}' is not one of ${AXES.join(", ")}`);
105
+ if (axis === undefined) problems.push(rowAxis(k, label, AXES.join(", ")));
102
106
  const fields = { gap: text(item.gap), evidence: text(item.evidence), fix: text(item.fix) };
103
107
  for (const [field, value] of Object.entries(fields)) {
104
- if (value === "") problems.push(`row ${k}: ${field} is empty`);
108
+ if (value === "") problems.push(rowFieldEmpty(k, field));
105
109
  }
106
- if (fields.evidence !== "" && !citesEvidence(fields.evidence)) problems.push(`row ${k}: evidence cites no path:line`);
110
+ if (fields.evidence !== "" && !citesEvidence(fields.evidence)) problems.push(rowNoCitation(k));
107
111
  if (problems.length > before || axis === undefined) return undefined;
108
112
  return { severity: severity as Severity, axis, ...fields };
109
113
  }
110
114
 
111
115
  export function checkAuditAnswer(value: unknown): Checked<AuditAnswer> {
112
- if (!isPlainObject(value)) return { ok: false, problems: ["the answer is not an object"] };
116
+ if (!isPlainObject(value)) return { ok: false, problems: [ANSWER_NOT_OBJECT] };
113
117
  const problems: string[] = [];
114
118
  const verdict = text(value.verdict);
115
- if (verdict !== "VALID" && verdict !== "GAPS") problems.push("verdict must be VALID or GAPS");
119
+ if (verdict !== "VALID" && verdict !== "GAPS") problems.push(VERDICT_VALID_OR_GAPS);
116
120
 
117
121
  const rows: AuditRow[] = [];
118
122
  if (!Array.isArray(value.rows)) {
119
- problems.push("rows must be a list");
123
+ problems.push(ROWS_NOT_LIST);
120
124
  } else {
121
- if (value.rows.length > MAX_ANSWER_ROWS) problems.push(`at most ${MAX_ANSWER_ROWS} rows, not ${value.rows.length}`);
125
+ if (value.rows.length > MAX_ANSWER_ROWS) problems.push(tooManyRows(MAX_ANSWER_ROWS, value.rows.length));
122
126
  value.rows.forEach((item, i) => {
123
127
  const checked = checkRow(item, i + 1, problems);
124
128
  if (checked) rows.push(checked);
@@ -127,20 +131,20 @@ export function checkAuditAnswer(value: unknown): Checked<AuditAnswer> {
127
131
 
128
132
  let validations: string[] = [];
129
133
  if (!Array.isArray(value.validations) || value.validations.some((v) => typeof v !== "string")) {
130
- problems.push("validations must be a list of commands");
134
+ problems.push(VALIDATIONS_NOT_LIST);
131
135
  } else {
132
136
  validations = value.validations.map((v: string) => validationCommand(v));
133
- if (validations.length > MAX_VALIDATIONS) problems.push(`at most ${MAX_VALIDATIONS} validations, not ${validations.length}`);
137
+ if (validations.length > MAX_VALIDATIONS) problems.push(tooManyValidations(MAX_VALIDATIONS, validations.length));
134
138
  }
135
139
 
136
140
  const undecided: Undecided[] = [];
137
141
  const items = value.undecided ?? [];
138
142
  if (!Array.isArray(items)) {
139
- problems.push("undecided must be a list");
143
+ problems.push(UNDECIDED_NOT_LIST);
140
144
  } else {
141
145
  items.forEach((item, i) => {
142
146
  const entry = isPlainObject(item) ? { check: text(item.check), reason: text(item.reason) } : { check: "", reason: "" };
143
- if (entry.check === "" || entry.reason === "") problems.push(`undecided ${i + 1}: check and reason are needed`);
147
+ if (entry.check === "" || entry.reason === "") problems.push(undecidedIncomplete(i + 1));
144
148
  else undecided.push(entry);
145
149
  });
146
150
  }
@@ -2,6 +2,7 @@
2
2
  // model can read whole, and the small readings each section is made of (a build log, a
3
3
  // test tail, the classes of a test file). Pure.
4
4
  export { isTestFile, isTestRoot } from "../../../shared/domain/dev/access-cost.ts";
5
+ import { cutNotCaptured, idsOfTheSheet, NO_CLASS_FOUND, TRAITS_NOT_CHECKED } from "./messages.ts";
5
6
 
6
7
  export const MAX_SECTION_CHARS = 32_000;
7
8
  export const SECTION_CUT_CHARS = 31_000;
@@ -39,7 +40,7 @@ export function splitSection(base: string, content: string): SectionFile[] {
39
40
  const part = rest.slice(0, end);
40
41
  rest = rest.slice(end);
41
42
  if (k === MAX_SECTION_PARTS) {
42
- files.push({ name: partName(base, k), content: `${part}\n[cut: ${rest.length} more characters not captured]\n` });
43
+ files.push({ name: partName(base, k), content: `${part}${cutNotCaptured(rest.length)}` });
43
44
  return files;
44
45
  }
45
46
  files.push({ name: partName(base, k), content: `${part}\n[continued in ${partName(base, k + 1)}]\n` });
@@ -118,8 +119,8 @@ export function typeNameOf(path: string): string {
118
119
 
119
120
  /** The `traits` section: the marker, the sheet's ids, then the first 40 hits as `path:line text`. */
120
121
  export function traitsSection(marker: string | null, ids: readonly string[], hits: readonly string[] | null): string {
121
- if (marker === null) return "not checked — the pack has no tests.rule_trait or tests.trait_pattern\n";
122
- const out = [`marker: ${marker}`, `ids of the sheet: ${ids.join(" ")}`];
122
+ if (marker === null) return TRAITS_NOT_CHECKED;
123
+ const out = [`marker: ${marker}`, idsOfTheSheet(ids.join(" "))];
123
124
  for (const h of (hits ?? []).filter((x) => x !== "").slice(0, TRAIT_HIT_LINES)) out.push(h.replace(/:([0-9]*):/, ":$1 "));
124
125
  return `${out.join("\n")}\n`;
125
126
  }
@@ -131,7 +132,7 @@ export function traitsSection(marker: string | null, ids: readonly string[], hit
131
132
  export function testClassesLine(
132
133
  path: string, classes: readonly string[] | null, testFiles: readonly string[] | null, why?: string,
133
134
  ): string {
134
- if (classes !== null) return `${path}: ${classes.length > 0 ? classes.join(", ") : "no class found"}`;
135
+ if (classes !== null) return `${path}: ${classes.length > 0 ? classes.join(", ") : NO_CLASS_FOUND}`;
135
136
  const found = testFiles === null ? (why ?? "none") : testFiles.length > 0 ? testFiles.join(", ") : "none";
136
137
  return `${path} -> tests naming ${typeNameOf(path)}: ${found}`;
137
138
  }
@@ -4,6 +4,8 @@
4
4
  // cannot be quoted, or when a list it needs is left empty once the unquotable entries are
5
5
  // dropped; its caller says the item is not captured. Pure.
6
6
 
7
+ import { buildOutputsNotPaths } from "./messages.ts";
8
+
7
9
  const PLAIN_WORD = /^[A-Za-z0-9_./@+,:=-]+$/;
8
10
  const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
9
11
  const MAX_FIND_PATHS = 200;
@@ -18,7 +20,7 @@ export function shellWord(value: string): string | null {
18
20
  /** AC:104: a folder name, not a path. */
19
21
  export function buildOutputProblem(name: string): string | undefined {
20
22
  return name === "" || name === "." || name === ".." || name.includes("/")
21
- ? `layout.build_outputs takes folder names, not paths: ${name}`
23
+ ? buildOutputsNotPaths(name)
22
24
  : undefined;
23
25
  }
24
26
 
@@ -45,8 +47,6 @@ function words(values: readonly string[]): string[] | null {
45
47
  return values.length > 0 && out.length === 0 ? null : out;
46
48
  }
47
49
 
48
- /** The reason a caller gives when a builder returned null for an unquotable list. */
49
- export const UNQUOTABLE_SCOPE = "not captured: unquotable scope";
50
50
 
51
51
  export function gitUntracked(excludes: readonly string[]): string {
52
52
  return line(["git ls-files --others --exclude-standard -- .", excludes]);
@@ -9,6 +9,11 @@ import { SHEET_ID_SOURCE, idsInMatch } from "../../../shared/domain/dev/trait-pa
9
9
  import { missingDesignIds } from "../../../shared/domain/dev/plan-checks.ts";
10
10
  import type { PlanFolderTexts } from "../../../shared/domain/dev/plan-checks.ts";
11
11
  export type { PlanFolderTexts } from "../../../shared/domain/dev/plan-checks.ts";
12
+ import {
13
+ DESIGN_IDS_CLASSIFIED, designIdsUnclassified, DIFF_CHECK_CLEAN, DIFF_CHECK_DIRTY, filesOutsideRoots, gateGreen, gateHeader,
14
+ gateRed, idsNotCarried, SCOPE_NO_ROOT, scopeInRoots, SHEET_CLOSED, SHEET_NOT_CLOSED, strayTraitIds, TRAITS_NO_ID,
15
+ TRAITS_NO_RULE, traitsCarried,
16
+ } from "./messages.ts";
12
17
 
13
18
  export type GateLineKind = "ok" | "FAIL" | "note";
14
19
  export interface GateLine { kind: GateLineKind; text: string }
@@ -39,8 +44,8 @@ const note = (text: string): GateLine => ({ kind: "note", text });
39
44
 
40
45
  function checkClosed(facts: SheetFacts): GateLine {
41
46
  return facts.closed
42
- ? ok("sheet: every step reads `TDD: RED [x] GREEN [x] COST [x]`")
43
- : fail("sheet not closed: a `TDD:` line is still open, or none is ticked");
47
+ ? ok(SHEET_CLOSED)
48
+ : fail(SHEET_NOT_CLOSED);
44
49
  }
45
50
 
46
51
  function outsideFiles(input: GateInput): string[] {
@@ -66,19 +71,19 @@ export function runGateChecks(input: GateInput): GateReport {
66
71
 
67
72
  const missing = missingDesignIds(input.plan);
68
73
  checks.push(missing.length === 0
69
- ? ok("design ids: all applied or non-applicable")
70
- : fail(`design ids neither on an \`Applied rules\` row nor on \`Non-applicable rules\`:${missing.map((id) => ` ${id}`).join("")}`));
74
+ ? ok(DESIGN_IDS_CLASSIFIED)
75
+ : fail(designIdsUnclassified(missing)));
71
76
 
72
77
  let outside: string[] = [];
73
78
  if (input.roots.length === 0) {
74
- checks.push(note("scope: the pack names no layout root, not checked"));
79
+ checks.push(note(SCOPE_NO_ROOT));
75
80
  } else {
76
81
  const roots = input.roots.join(" ");
77
82
  outside = outsideFiles(input);
78
83
  if (outside.length === 0) {
79
- checks.push(ok(`scope: every changed file is under ${roots} or named by the sheet`));
84
+ checks.push(ok(scopeInRoots(roots)));
80
85
  } else {
81
- checks.push(fail(`files changed outside ${roots} and absent from the sheet — name them under \`## Decisions\`, or restore them`));
86
+ checks.push(fail(filesOutsideRoots(roots)));
82
87
  for (const f of outside) checks.push(note(f));
83
88
  }
84
89
  }
@@ -86,34 +91,34 @@ export function runGateChecks(input: GateInput): GateReport {
86
91
  let untested: string[] = [];
87
92
  let stray: string[] = [];
88
93
  if (input.trait === null) {
89
- checks.push(note("rule traits: the pack has no tests.rule_trait, not checked"));
94
+ checks.push(note(TRAITS_NO_RULE));
90
95
  } else if (input.facts.ids.length === 0) {
91
- checks.push(note("rule traits: the sheet's `## TDD sequence` names no BR-/UC-/CH- id, nothing to check"));
96
+ checks.push(note(TRAITS_NO_ID));
92
97
  } else {
93
98
  const hits = input.traitHits ?? [];
94
99
  const carried = new Set(hits.flatMap(idsInMatch));
95
100
  untested = input.facts.ids.filter((id) => !carried.has(id));
96
101
  const shown = input.trait.shown;
97
102
  checks.push(untested.length === 0
98
- ? ok(`rule traits: every id of the sheet is carried by a test, ${shown}`)
99
- : fail(`ids of the sheet's TDD sequence that no test carries as ${shown}:${untested.map((id) => ` ${id}`).join("")}`));
103
+ ? ok(traitsCarried(shown))
104
+ : fail(idsNotCarried(shown, untested)));
100
105
  const known = knownIds(input.plan.all);
101
106
  const cited = [...new Set(hits.flatMap((h) => h.match(/(BR|UC|CH)-[0-9]+/g) ?? []))].sort();
102
107
  stray = cited.filter((id) => !known.has(id));
103
108
  if (stray.length > 0) {
104
- checks.push(note(`traits citing an id absent from ${input.planDirAbsolute}/*.md:${stray.map((id) => ` ${id}`).join("")}`));
109
+ checks.push(note(strayTraitIds(input.planDirAbsolute, stray)));
105
110
  }
106
111
  }
107
112
 
108
113
  checks.push(input.diffCheckExit === 0
109
- ? ok("git diff --check: clean")
110
- : fail("git diff --check reports trailing whitespace or conflict markers"));
114
+ ? ok(DIFF_CHECK_CLEAN)
115
+ : fail(DIFF_CHECK_DIRTY));
111
116
 
112
117
  const green = !checks.some((c) => c.kind === "FAIL");
113
118
  const lines = [
114
- `GATE — batch ${input.batch} — sheet ${input.sheetShown}`,
119
+ gateHeader(input.batch, input.sheetShown),
115
120
  ...checks.map(gateLineText),
116
- green ? `GATE — batch ${input.batch}: GREEN` : `GATE — batch ${input.batch}: RED — fix and run again, no audit before`,
121
+ green ? gateGreen(input.batch) : gateRed(input.batch),
117
122
  ];
118
123
  return { green, lines, checks, missingDesignIds: missing, outside, untested, stray };
119
124
  }
@@ -0,0 +1,16 @@
1
+ // The values dev-verify's writers and readers share: the check names of the mechanical table, which the verdict and
2
+ // the capture look rows up by.
3
+
4
+ export const CHECK_BUILD = "capture `build`";
5
+ export const CHECK_TRAITS = "ids carried by traits";
6
+ export const CHECK_METHODS = "step-table methods in the test roots";
7
+ export const CHECK_TEST_RUN = "last test run";
8
+ export const CHECK_SCOPE = "changed files in the batch";
9
+ export const CHECK_COST = "capture `cost`";
10
+ export const CHECK_CONVENTIONS = "layer rules of the changed layers";
11
+ export const CHECK_TICKED = "`TDD:` lines ticked";
12
+ export const CHECK_DESIGN_IDS = "design ids classified";
13
+ export const CHECK_APPLIED = "`Applied rules` ids are design-rule ids";
14
+
15
+ /** The header of the verdict table, which the verdict parsers read back. */
16
+ export const VERDICT_TABLE_HEADER = "| Severity | Axis | Gap | Evidence | Expected fix |";
@@ -5,6 +5,12 @@ import type { AccessCost } from "../../../shared/domain/dev/access-cost.ts";
5
5
  import type { TraitMarker } from "../../../shared/domain/dev/trait-pattern.ts";
6
6
  import { isDesignRuleId } from "../../../shared/domain/dev/design-rules.ts";
7
7
  import type { TestRunSummary } from "./capture-sections.ts";
8
+ import {
9
+ CHECK_APPLIED, CHECK_BUILD, CHECK_CONVENTIONS, CHECK_COST, CHECK_DESIGN_IDS, CHECK_METHODS, CHECK_SCOPE, CHECK_TEST_RUN,
10
+ CHECK_TICKED, CHECK_TRAITS,
11
+ } from "./markers.ts";
12
+ import { BUILD_RUN_GREEN, buildReused, buildRunRed, costGreen, designIdsEvidence, eachDesignRuleId, exitLine, idsCarriedAs, JUDGED_BY_AUDITOR, methodsAbsent, methodsFound, NO_APPLIED_RULES_ROW, NO_EXIT_LINE, NO_LAYOUT_ROOT, NO_TEST_METHOD, NO_TEST_ROOT, noSummaryLine, notComputed, noTestLog, ROW_CITES_NO_ID, scopeEvidence, SHEET_NAMES_NO_ID, shellRefused, TABLE_HEADER, tableTitle, TEST_ROOTS_NOT_SEARCHED, testRunEvidence, tickedNoneOpen, timedOutAfter, TRAITS_NOT_APPLICABLE, unknownDesignRuleIds } from "./messages.ts";
13
+ import { PACK_HAS_NO_BUILD as NO_BUILD_COMMAND } from "../../../shared/domain/dev/messages.ts";
8
14
 
9
15
  export type CheckResult = "ok" | "gap" | "not checked";
10
16
  export interface TableRow { axis: string; check: string; result: CheckResult; evidence: string }
@@ -25,17 +31,6 @@ export interface TableInput {
25
31
  appliedRulesRow: string | null; appliedIds: readonly string[];
26
32
  }
27
33
 
28
- export const CHECK_BUILD = "capture `build`";
29
- export const CHECK_TRAITS = "ids carried by traits";
30
- export const CHECK_METHODS = "step-table methods in the test roots";
31
- export const CHECK_TEST_RUN = "last test run";
32
- export const CHECK_SCOPE = "changed files in the batch";
33
- export const CHECK_COST = "capture `cost`";
34
- export const CHECK_CONVENTIONS = "layer rules of the changed layers";
35
- export const CHECK_TICKED = "`TDD:` lines ticked";
36
- export const CHECK_DESIGN_IDS = "design ids classified";
37
- export const CHECK_APPLIED = "`Applied rules` ids are design-rule ids";
38
-
39
34
  function row(axis: string, check: string, result: CheckResult, evidence: string): TableRow {
40
35
  return { axis, check, result, evidence };
41
36
  }
@@ -50,33 +45,33 @@ function basename(path: string): string {
50
45
 
51
46
  function buildRow(build: BuildState): TableRow {
52
47
  switch (build.state) {
53
- case "none": return row("Build", CHECK_BUILD, "not checked", "the pack has no commands.build");
54
- case "reused": return row("Build", CHECK_BUILD, "ok", `\`exit: 0\` (reused ${basename(build.log)})`);
48
+ case "none": return row("Build", CHECK_BUILD, "not checked", NO_BUILD_COMMAND);
49
+ case "reused": return row("Build", CHECK_BUILD, "ok", buildReused(basename(build.log)));
55
50
  case "run":
56
51
  return build.exit === 0
57
- ? row("Build", CHECK_BUILD, "ok", "`exit: 0` (run)")
58
- : row("Build", CHECK_BUILD, "gap", `\`exit: ${build.exit}\`${build.why !== "" ? ` — ${build.why}` : ""}`);
59
- case "timeout": return row("Build", CHECK_BUILD, "not checked", `timed out after ${build.seconds} s`);
60
- case "refused": return row("Build", CHECK_BUILD, "not checked", `the shell refused it: ${build.message}`);
52
+ ? row("Build", CHECK_BUILD, "ok", BUILD_RUN_GREEN)
53
+ : row("Build", CHECK_BUILD, "gap", buildRunRed(build.exit, build.why));
54
+ case "timeout": return row("Build", CHECK_BUILD, "not checked", timedOutAfter(build.seconds));
55
+ case "refused": return row("Build", CHECK_BUILD, "not checked", shellRefused(build.message));
61
56
  }
62
57
  }
63
58
 
64
59
  function traitsRow(input: TableInput): TableRow {
65
60
  if (input.trait === null) {
66
61
  // Nothing to check: the pack carries ids in no trait, so the row is settled rather than left to the auditor's Not run.
67
- return row("Test", CHECK_TRAITS, "ok", "not applicable: the pack has no tests.rule_trait or tests.trait_pattern");
62
+ return row("Test", CHECK_TRAITS, "ok", TRAITS_NOT_APPLICABLE);
68
63
  }
69
64
  if (input.ids.length === 0) {
70
- return row("Test", CHECK_TRAITS, "not checked", "the sheet's `## TDD sequence` names no BR-/UC-/CH- id");
65
+ return row("Test", CHECK_TRAITS, "not checked", SHEET_NAMES_NO_ID);
71
66
  }
72
67
  const shown = input.trait.shown.split("<id>").join("…");
73
- return row("Test", CHECK_TRAITS, "ok", `gate: ${input.ids.join(", ")} each carried as ${shown} — capture \`traits\``);
68
+ return row("Test", CHECK_TRAITS, "ok", idsCarriedAs(input.ids.join(", "), shown));
74
69
  }
75
70
 
76
71
  function methodsRow(input: TableInput): TableRow {
77
- if (input.methods.length === 0) return row("Test", CHECK_METHODS, "not checked", "the step tables name no test method");
78
- if (input.testRoots.length === 0) return row("Test", CHECK_METHODS, "not checked", "no test root in the pack's layout");
79
- if (input.methodHits === null) return row("Test", CHECK_METHODS, "not checked", "the test roots were not searched");
72
+ if (input.methods.length === 0) return row("Test", CHECK_METHODS, "not checked", NO_TEST_METHOD);
73
+ if (input.testRoots.length === 0) return row("Test", CHECK_METHODS, "not checked", NO_TEST_ROOT);
74
+ if (input.methodHits === null) return row("Test", CHECK_METHODS, "not checked", TEST_ROOTS_NOT_SEARCHED);
80
75
  const absent: string[] = [];
81
76
  let first = "";
82
77
  let found = 0;
@@ -87,45 +82,44 @@ function methodsRow(input: TableInput): TableRow {
87
82
  if (first === "") first = hit.split(":").slice(0, 2).join(":");
88
83
  }
89
84
  if (absent.length === 0) {
90
- return row("Test", CHECK_METHODS, "ok", `${found}/${input.methods.length} found (git grep --untracked), first \`${first}\``);
85
+ return row("Test", CHECK_METHODS, "ok", methodsFound(found, input.methods.length, first));
91
86
  }
92
- return row("Test", CHECK_METHODS, "gap", `absent from ${input.testRoots.join(" ")}: ${ticks(absent)}`);
87
+ return row("Test", CHECK_METHODS, "gap", methodsAbsent(input.testRoots.join(" "), ticks(absent)));
93
88
  }
94
89
 
95
90
  function testRunRow(input: TableInput): TableRow {
96
- if (input.testLog === null) return row("Test", CHECK_TEST_RUN, "not checked", `no test log in ${input.testLogLooked}`);
91
+ if (input.testLog === null) return row("Test", CHECK_TEST_RUN, "not checked", noTestLog(input.testLogLooked));
97
92
  const { name, summary } = input.testLog;
98
- const exit = summary.exit === null ? "no `exit=` line" : `\`exit=${summary.exit}\``;
99
- const evidence = `passed ${summary.passed ?? "-"}, failed ${summary.failed ?? "-"}, ${exit} — ${name}`;
93
+ const exit = summary.exit === null ? NO_EXIT_LINE : exitLine(summary.exit);
94
+ const evidence = testRunEvidence(String(summary.passed ?? "-"), String(summary.failed ?? "-"), exit, name);
100
95
  if ((summary.exit !== null && summary.exit !== 0) || (summary.failed !== null && summary.failed > 0)) {
101
96
  return row("Test", CHECK_TEST_RUN, "gap", evidence);
102
97
  }
103
98
  if (summary.exit === 0 || summary.passed !== null) return row("Test", CHECK_TEST_RUN, "ok", evidence);
104
- return row("Test", CHECK_TEST_RUN, "not checked", `no summary line and no \`exit=\` in the tail of ${name}`);
99
+ return row("Test", CHECK_TEST_RUN, "not checked", noSummaryLine(name));
105
100
  }
106
101
 
107
102
  function scopeRow(roots: readonly string[]): TableRow {
108
- if (roots.length === 0) return row("Scope", CHECK_SCOPE, "not checked", "the pack names no layout root");
109
- return row("Scope", CHECK_SCOPE, "ok",
110
- `gate: every changed file under ${roots.join(" ")}, the plan folder or named by the sheet — capture \`changed-files\``);
103
+ if (roots.length === 0) return row("Scope", CHECK_SCOPE, "not checked", NO_LAYOUT_ROOT);
104
+ return row("Scope", CHECK_SCOPE, "ok", scopeEvidence(roots.join(" ")));
111
105
  }
112
106
 
113
107
  /** The flagged calls the Cost row shows; cost.txt lists them all. */
114
108
  const FLAGGED_SHOWN = 12;
115
109
 
116
110
  function costRow(cost: AccessCost): TableRow {
117
- if (cost.state === "not-computed") return row("Cost", CHECK_COST, "not checked", `not computed — ${cost.reason}`);
118
- if (cost.exit === 0) return row("Cost", CHECK_COST, "ok", `\`exit: 0\` — ${cost.costLine}`);
111
+ if (cost.state === "not-computed") return row("Cost", CHECK_COST, "not checked", notComputed(cost.reason));
112
+ if (cost.exit === 0) return row("Cost", CHECK_COST, "ok", costGreen(cost.costLine));
119
113
  const more = cost.flagged.length > FLAGGED_SHOWN ? ` · … +${cost.flagged.length - FLAGGED_SHOWN}` : "";
120
114
  return row("Cost", CHECK_COST, "gap", `\`exit: 2\` ${cost.flagged.slice(0, FLAGGED_SHOWN).join(" · ")}${more}`.trimEnd());
121
115
  }
122
116
 
123
117
  function appliedRow(input: TableInput): TableRow {
124
- if (input.appliedRulesRow === null) return row("Plan", CHECK_APPLIED, "gap", "the sheet has no `Applied rules` row");
118
+ if (input.appliedRulesRow === null) return row("Plan", CHECK_APPLIED, "gap", NO_APPLIED_RULES_ROW);
125
119
  const unknown = input.appliedIds.filter((id) => !isDesignRuleId(id));
126
- if (unknown.length > 0) return row("Plan", CHECK_APPLIED, "gap", `unknown design-rule ids: ${ticks(unknown)}`);
127
- if (input.appliedIds.length === 0) return row("Plan", CHECK_APPLIED, "ok", "the row cites no id");
128
- return row("Plan", CHECK_APPLIED, "ok", `${input.appliedIds.join(", ")}, each a design-rule id`);
120
+ if (unknown.length > 0) return row("Plan", CHECK_APPLIED, "gap", unknownDesignRuleIds(ticks(unknown)));
121
+ if (input.appliedIds.length === 0) return row("Plan", CHECK_APPLIED, "ok", ROW_CITES_NO_ID);
122
+ return row("Plan", CHECK_APPLIED, "ok", eachDesignRuleId(input.appliedIds.join(", ")));
129
123
  }
130
124
 
131
125
  /** The 10 rows, in the order of § 2.4. */
@@ -137,10 +131,9 @@ export function mechanicalRows(input: TableInput): TableRow[] {
137
131
  testRunRow(input),
138
132
  scopeRow(input.roots),
139
133
  costRow(input.cost),
140
- row("Conventions", CHECK_CONVENTIONS, "not checked", "judged pass (the auditor)"),
141
- row("Plan", CHECK_TICKED, "ok", `gate: ${input.tickedLines} ticked, none open`),
142
- row("Plan", CHECK_DESIGN_IDS, "ok",
143
- `gate: every DDD-/APP-/PERF- id applied or on \`Non-applicable rules\` of ${input.planDirName}/`),
134
+ row("Conventions", CHECK_CONVENTIONS, "not checked", JUDGED_BY_AUDITOR),
135
+ row("Plan", CHECK_TICKED, "ok", tickedNoneOpen(input.tickedLines)),
136
+ row("Plan", CHECK_DESIGN_IDS, "ok", designIdsEvidence(input.planDirName)),
144
137
  appliedRow(input),
145
138
  ];
146
139
  }
@@ -153,9 +146,9 @@ export function escapeCell(text: string): string {
153
146
  /** The content of table.md (§ 3.3). */
154
147
  export function renderTable(batch: string, rows: readonly TableRow[]): string {
155
148
  const out = [
156
- `# Mechanical audit — ${batch}`,
149
+ tableTitle(batch),
157
150
  "",
158
- "| Axis | Check | Result | Evidence |",
151
+ TABLE_HEADER,
159
152
  "|------|-------|--------|----------|",
160
153
  ...rows.map((r) => `| ${r.axis} | ${escapeCell(r.check)} | ${r.result} | ${escapeCell(r.evidence)} |`),
161
154
  ];