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,8 @@
4
4
  import type { Checked } from "../../../shared/domain/agents/charter.ts";
5
5
  import type { CheckKind, MotifStatus, OwnerKind } from "../../../shared/domain/dev/learn-proposals.ts";
6
6
  import { MAX_TOPIC_CHARS, TOPIC_PATTERN } from "../../../shared/domain/shared-memory/refused.ts";
7
+ import { MOTIFS_MUST_BE_LIST, SEEN_LINES_ONLY, addsLines, atProblem, checkIsOneOf, deployedCopy, droppedNeeds, harnessOwnerUnder, lineLength, needsRemovedLine, ownerKindIs, ownerPathNotRelative, removesLines, rowNotGiven, rowTwice, rowsEmpty, sameRows, statusIs, titleLength, tooManyMotifs, topicNotSlug } from "./messages.ts";
8
+ import { ANSWER_NOT_AN_OBJECT as NOT_AN_OBJECT, fieldEmpty } from "../../../shared/domain/dev/messages.ts";
7
9
 
8
10
  export { MAX_TOPIC_CHARS };
9
11
 
@@ -13,12 +15,8 @@ export const MAX_LINE_CHARS = 300;
13
15
  const MAX_TITLE_CHARS = 80;
14
16
  /** A title longer than this is cut in a label: its first LABEL_TITLE_CHARS characters, then an ellipsis. */
15
17
  export const LABEL_TITLE_CHARS = 60;
16
- const ADDS_LINES = `1 to ${MAX_LINES_PER_MOTIF} lines added and at most ${MAX_LINES_PER_MOTIF} removed`;
17
- const REMOVES_LINES = `removes takes out 1 to ${MAX_LINES_PER_MOTIF} lines and adds none`;
18
- /** Why a status other than new is refused on an answer given without owner lines: it copies a line it never saw. */
19
- export const SEEN_LINES_ONLY = (status: string): string =>
20
- `${status} copies a line of its owner, and this answer was given without the owner lines: give status new, ` +
21
- "or copy the line from the owner lines when they are shown";
18
+ const ADDS_LINES = addsLines(MAX_LINES_PER_MOTIF);
19
+ const REMOVES_LINES = removesLines(MAX_LINES_PER_MOTIF);
22
20
 
23
21
  export interface AnswerMotif {
24
22
  title: string; topic: string; rows: string[]; preventiveLine: string;
@@ -123,16 +121,16 @@ function checkMotif(
123
121
  const title = text(item.title);
124
122
  const at = motifLabel(k, title);
125
123
 
126
- if (title === "" || chars(title) > MAX_TITLE_CHARS) problems.push(`${at}: title must be 1 to 80 characters`);
124
+ if (title === "" || chars(title) > MAX_TITLE_CHARS) problems.push(titleLength(at));
127
125
  const topic = text(item.topic);
128
- if (!TOPIC_PATTERN.test(topic)) problems.push(`${at}: topic '${topic}' is not a kebab slug of at most ${MAX_TOPIC_CHARS} characters`);
126
+ if (!TOPIC_PATTERN.test(topic)) problems.push(topicNotSlug(at, topic, MAX_TOPIC_CHARS));
129
127
 
130
128
  const rows = Array.isArray(item.rows) ? item.rows.map(text) : [];
131
- if (rows.length === 0) problems.push(`${at}: rows is empty`);
129
+ if (rows.length === 0) problems.push(rowsEmpty(at));
132
130
  const seen = new Set<string>();
133
131
  for (const id of rows) {
134
- if (!shownIds.has(id)) problems.push(`${at}: row '${id}' is not one of the rows given`);
135
- else if (seen.has(id)) problems.push(`${at}: row '${id}' is listed twice`);
132
+ if (!shownIds.has(id)) problems.push(rowNotGiven(at, id));
133
+ else if (seen.has(id)) problems.push(rowTwice(at, id));
136
134
  seen.add(id);
137
135
  }
138
136
 
@@ -140,25 +138,25 @@ function checkMotif(
140
138
  const novelty = text(item.novelty);
141
139
  const keyTerm = text(item.key_term);
142
140
  for (const [field, v] of [["preventive_line", preventiveLine], ["novelty", novelty], ["key_term", keyTerm]] as const) {
143
- if (v === "") problems.push(`${at}: ${field} is empty`);
141
+ if (v === "") problems.push(fieldEmpty(at, field));
144
142
  }
145
143
 
146
144
  const kind = text(item.owner_kind) as OwnerKind;
147
145
  const path = typeof item.owner_path === "string" ? item.owner_path : "";
148
- if (!OWNER_KINDS.includes(kind)) problems.push(`${at}: owner_kind must be repository or harness`);
146
+ if (!OWNER_KINDS.includes(kind)) problems.push(ownerKindIs(at));
149
147
  if (!isRelativePath(item.owner_path)) {
150
- problems.push(`${at}: owner_path '${path}' is not a relative path`);
148
+ problems.push(ownerPathNotRelative(at, path));
151
149
  } else if (kind === "repository" && (path === ".claude" || path.startsWith(".claude/"))) {
152
- problems.push(`${at}: .claude/ is the harness's deployed copy: name the orkeon-workshop file with owner_kind harness`);
150
+ problems.push(deployedCopy(at));
153
151
  } else if (kind === "harness" && !path.startsWith(HARNESS_PACKS)) {
154
- problems.push(`${at}: a harness owner is a file of the orkeon-workshop repository under ${HARNESS_PACKS}`);
152
+ problems.push(harnessOwnerUnder(at, HARNESS_PACKS));
155
153
  }
156
154
 
157
155
  const check = text(item.check) as CheckKind;
158
- if (!CHECK_KINDS.includes(check)) problems.push(`${at}: check must be one of ${CHECK_KINDS.join(", ")}`);
156
+ if (!CHECK_KINDS.includes(check)) problems.push(checkIsOneOf(at, CHECK_KINDS.join(", ")));
159
157
  const status = text(item.status) as MotifStatus;
160
- if (!STATUSES.includes(status)) problems.push(`${at}: status must be new, refines, replaces or removes`);
161
- else if (status !== "new" && !ownerLinesShown) problems.push(`${at}: ${SEEN_LINES_ONLY(status)}`);
158
+ if (!STATUSES.includes(status)) problems.push(statusIs(at));
159
+ else if (status !== "new" && !ownerLinesShown) problems.push(atProblem(at, SEEN_LINES_ONLY(status)));
162
160
 
163
161
  const removed = lines(item.lines_removed);
164
162
  const added = lines(item.lines_added);
@@ -175,10 +173,10 @@ function checkMotif(
175
173
  ...(Array.isArray(item.lines_removed) ? item.lines_removed : []),
176
174
  ];
177
175
  if (rawLines.some((l) => typeof l !== "string" || chars(l.trim()) > MAX_LINE_CHARS || /[\r\n]/.test(l.trim()))) {
178
- problems.push(`${at}: each line is one line of at most 300 characters`);
176
+ problems.push(lineLength(at));
179
177
  }
180
178
  if ((status === "refines" || status === "replaces") && (removed ?? []).filter((l) => l !== "").length === 0) {
181
- problems.push(`${at}: ${status} needs the line it removes`);
179
+ problems.push(needsRemovedLine(at, status));
182
180
  }
183
181
 
184
182
  if (problems.length > before) return undefined;
@@ -191,7 +189,7 @@ function checkMotif(
191
189
  function checkDropped(value: unknown, problems: string[]): AnswerDropped[] {
192
190
  if (value === undefined) return [];
193
191
  if (!Array.isArray(value)) {
194
- problems.push("dropped 1: title, filter and reason are needed");
192
+ problems.push(droppedNeeds(1));
195
193
  return [];
196
194
  }
197
195
  const out: AnswerDropped[] = [];
@@ -201,7 +199,7 @@ function checkDropped(value: unknown, problems: string[]): AnswerDropped[] {
201
199
  const filter = text(item.filter) as AnswerDropped["filter"];
202
200
  const reason = text(item.reason);
203
201
  if (title === "" || reason === "" || !FILTERS.includes(filter)) {
204
- problems.push(`dropped ${i + 1}: title, filter and reason are needed`);
202
+ problems.push(droppedNeeds(i + 1));
205
203
  return;
206
204
  }
207
205
  out.push({ title, filter, reason });
@@ -214,10 +212,10 @@ function checkDropped(value: unknown, problems: string[]): AnswerDropped[] {
214
212
  export function checkLearnAnswer(
215
213
  value: unknown, shownIds: ReadonlySet<string>, ownerLinesShown: boolean,
216
214
  ): Checked<LearnAnswer> {
217
- if (!isPlainObject(value)) return { ok: false, problems: ["the answer is not an object"] };
218
- if (!Array.isArray(value.motifs)) return { ok: false, problems: ["motifs must be a list"] };
215
+ if (!isPlainObject(value)) return { ok: false, problems: [NOT_AN_OBJECT] };
216
+ if (!Array.isArray(value.motifs)) return { ok: false, problems: [MOTIFS_MUST_BE_LIST] };
219
217
  const problems: string[] = [];
220
- if (value.motifs.length > MAX_MOTIFS_PER_AXIS) problems.push(`at most 3 motifs, not ${value.motifs.length}`);
218
+ if (value.motifs.length > MAX_MOTIFS_PER_AXIS) problems.push(tooManyMotifs(value.motifs.length));
221
219
  const motifs: AnswerMotif[] = [];
222
220
  // A motif's id hashes its axis and its rows: two motifs of one set of rows would share it, and one decision.
223
221
  const rowSets = new Map<string, number>();
@@ -228,7 +226,7 @@ export function checkLearnAnswer(
228
226
  const key = [...motif.rows].sort().join(",");
229
227
  const first = rowSets.get(key);
230
228
  if (first === undefined) rowSets.set(key, i + 1);
231
- else problems.push(`${motifLabel(i + 1, motif.title)}: the same rows as motif ${first}: merge them into one motif`);
229
+ else problems.push(sameRows(motifLabel(i + 1, motif.title), first));
232
230
  });
233
231
  const dropped = checkDropped(value.dropped, problems);
234
232
  return problems.length > 0 ? { ok: false, problems } : { ok: true, value: { motifs, dropped } };
@@ -0,0 +1,65 @@
1
+ // The messages of dev-learn's domain: the problems the check of a learner's answer and the review of its owner
2
+ // report (the model reads them back on a re-ask), and the lines of PROPOSALS.md the person reads (ADR 0026).
3
+
4
+ // ── The problems of a learner's answer ──────────────────────────────────
5
+
6
+ export const addsLines = (max: number): string => `1 to ${max} lines added and at most ${max} removed`;
7
+ export const removesLines = (max: number): string => `removes takes out 1 to ${max} lines and adds none`;
8
+ /** Why a status other than new is refused on an answer given without owner lines: it copies a line it never saw. */
9
+ export const SEEN_LINES_ONLY = (status: string): string =>
10
+ `${status} copies a line of its owner, and this answer was given without the owner lines: give status new, ` +
11
+ "or copy the line from the owner lines when they are shown";
12
+ export const titleLength = (at: string): string => `${at}: title must be 1 to 80 characters`;
13
+ export const topicNotSlug = (at: string, topic: string, max: number): string =>
14
+ `${at}: topic '${topic}' is not a kebab slug of at most ${max} characters`;
15
+ export const rowsEmpty = (at: string): string => `${at}: rows is empty`;
16
+ export const rowNotGiven = (at: string, id: string): string => `${at}: row '${id}' is not one of the rows given`;
17
+ export const rowTwice = (at: string, id: string): string => `${at}: row '${id}' is listed twice`;
18
+ export const ownerKindIs = (at: string): string => `${at}: owner_kind must be repository or harness`;
19
+ export const ownerPathNotRelative = (at: string, path: string): string => `${at}: owner_path '${path}' is not a relative path`;
20
+ export const deployedCopy = (at: string): string =>
21
+ `${at}: .claude/ is the harness's deployed copy: name the orkeon-workshop file with owner_kind harness`;
22
+ export const harnessOwnerUnder = (at: string, packs: string): string =>
23
+ `${at}: a harness owner is a file of the orkeon-workshop repository under ${packs}`;
24
+ export const checkIsOneOf = (at: string, kinds: string): string => `${at}: check must be one of ${kinds}`;
25
+ export const statusIs = (at: string): string => `${at}: status must be new, refines, replaces or removes`;
26
+ export const atProblem = (at: string, problem: string): string => `${at}: ${problem}`;
27
+ export const lineLength = (at: string): string => `${at}: each line is one line of at most 300 characters`;
28
+ export const needsRemovedLine = (at: string, status: string): string => `${at}: ${status} needs the line it removes`;
29
+ export const droppedNeeds = (k: number): string => `dropped ${k}: title, filter and reason are needed`;
30
+ export const MOTIFS_MUST_BE_LIST = "motifs must be a list";
31
+ export const tooManyMotifs = (count: number): string => `at most 3 motifs, not ${count}`;
32
+ export const sameRows = (label: string, first: number): string => `${label}: the same rows as motif ${first}: merge them into one motif`;
33
+
34
+ // ── The owner review ────────────────────────────────────────────────────
35
+
36
+ export const keyTermNotFound = (term: string, path: string): string => `'${term}' not found in ${path}`;
37
+ export const keyTermFound = (term: string, count: number, path: string, first: number): string =>
38
+ `'${term}' on ${count} lines of ${path}, first ${path}:${first}`;
39
+ export const OWNER_MAY_SAY_IT = "; the owner may already say it";
40
+ export const removedNotFound = (line: string): string => `; removed line not found: ${line}`;
41
+ export const keyTermOnLines = (label: string, term: string, count: number, path: string): string =>
42
+ `${label}: '${term}' is on ${count} lines of ${path}, shown below: keep status new only ` +
43
+ "for what they miss; else refine, replace or remove one of them, or drop the motif under novelty";
44
+ export const nearestLine = (shown: string): string => `; nearest: ${shown}`;
45
+ export const keyTermFindsNoLine = (term: string): string => `; '${term}' finds no line there: give the motif status new`;
46
+ export const removedNotFoundIn = (label: string, path: string, line: string, where: string): string =>
47
+ `${label}: removed line not found in ${path}: "${line}"${where}`;
48
+
49
+ // ── PROPOSALS.md ────────────────────────────────────────────────────────
50
+
51
+ export const NO_MOTIF_KEPT = "No motif kept.";
52
+ export const noProposal = (reason: string | undefined): string =>
53
+ `No proposal: the answer did not parse after one re-ask (${reason ?? "no reason given"}).`;
54
+ export const unchangedSince = (since: string | undefined): string => `Unchanged since ${since ?? "an earlier run"}: not asked again.`;
55
+ export const MOTIF_TABLE_HEADER = [
56
+ "| Id | Motif | Batches | Status | Owner | Check | Reconcile |",
57
+ "|----|-------|---------|--------|-------|-------|-----------|",
58
+ ];
59
+ export const notShown = (hidden: number, cap: number): string => `Not shown to the model: ${hidden} gaps (cap ${cap})`;
60
+ export const NOTHING_TO_DECIDE = "Nothing to decide.";
61
+ export const proposalsHead = (
62
+ work: string, gaps: number, batches: number, files: number, orkeon: number, harness: number, refused: number,
63
+ ): string =>
64
+ `Work folder \`${work}\`: ${gaps} untreated gaps across ${batches} batches in ${files} verdict files. ` +
65
+ `Treated before: ${orkeon} by Orkeon Code, ${harness} by the harness. Refused motifs: ${refused}.`;
@@ -5,6 +5,10 @@
5
5
  // of their content. Pure, no IO: the file is read by the use case.
6
6
  import { foldText } from "../../../shared/domain/shared-memory/verdict-rows.ts";
7
7
  import type { AnswerMotif } from "./learn-answer.ts";
8
+ import {
9
+ OWNER_MAY_SAY_IT, keyTermFindsNoLine, keyTermFound, keyTermNotFound, keyTermOnLines, nearestLine, removedNotFound,
10
+ removedNotFoundIn,
11
+ } from "./messages.ts";
8
12
 
9
13
  export const MAX_OWNER_LINES_PER_MOTIF = 8;
10
14
  export const MAX_OWNER_LINE_CHARS = 160;
@@ -56,10 +60,10 @@ function nearest(hits: readonly OwnerHit[], line: string): OwnerHit {
56
60
  export function ownerSummary(motif: ReviewedMotif, path: string, match: OwnerMatch): string {
57
61
  const { hits } = match;
58
62
  let out = hits.length === 0
59
- ? `'${motif.keyTerm}' not found in ${path}`
60
- : `'${motif.keyTerm}' on ${hits.length} lines of ${path}, first ${path}:${hits[0].n}`;
61
- if (motif.status === "new" && hits.length > 0) out += "; the owner may already say it";
62
- for (const removed of match.missing) out += `; removed line not found: ${cut(removed, REMOVED_SHOWN)}`;
63
+ ? keyTermNotFound(motif.keyTerm, path)
64
+ : keyTermFound(motif.keyTerm, hits.length, path, hits[0].n);
65
+ if (motif.status === "new" && hits.length > 0) out += OWNER_MAY_SAY_IT;
66
+ for (const removed of match.missing) out += removedNotFound(cut(removed, REMOVED_SHOWN));
63
67
  return out;
64
68
  }
65
69
 
@@ -70,14 +74,13 @@ export function reviewOwner(label: string, motif: ReviewedMotif, path: string, m
70
74
  const { hits, missing } = match;
71
75
  const problems: string[] = [];
72
76
  if (motif.status === "new" && hits.length > 0) {
73
- problems.push(`${label}: '${motif.keyTerm}' is on ${hits.length} lines of ${path}, shown below: keep status new only ` +
74
- "for what they miss; else refine, replace or remove one of them, or drop the motif under novelty");
77
+ problems.push(keyTermOnLines(label, motif.keyTerm, hits.length, path));
75
78
  }
76
79
  for (const line of missing) {
77
80
  const where = hits.length > 0
78
- ? `; nearest: ${shownLine(path, nearest(hits, line))}`
79
- : `; '${motif.keyTerm}' finds no line there: give the motif status new`;
80
- problems.push(`${label}: removed line not found in ${path}: "${cut(line, REMOVED_SHOWN)}"${where}`);
81
+ ? nearestLine(shownLine(path, nearest(hits, line)))
82
+ : keyTermFindsNoLine(motif.keyTerm);
83
+ problems.push(removedNotFoundIn(label, path, cut(line, REMOVED_SHOWN), where));
81
84
  }
82
85
  const block = (problems.length > 0 || motif.status !== "new") && hits.length > 0
83
86
  ? { label, path, lines: hits.slice(0, MAX_OWNER_LINES_PER_MOTIF).map((h) => shownLine(path, h)) }
@@ -3,6 +3,7 @@
3
3
  // its lines), and the commands that decide. The file is read by people; proposals.json
4
4
  // beside it is the source the decisions read. Pure, no IO.
5
5
  import type { AxisProposal, Motif, ProposalsFile } from "../../../shared/domain/dev/learn-proposals.ts";
6
+ import { MOTIF_TABLE_HEADER, NOTHING_TO_DECIDE, NO_MOTIF_KEPT, noProposal, notShown, proposalsHead, unchangedSince } from "./messages.ts";
6
7
 
7
8
  const TITLE_CELL = 80;
8
9
  const RECONCILE_CELL = 160;
@@ -45,17 +46,16 @@ function motifBlock(m: Motif): string[] {
45
46
  }
46
47
 
47
48
  function outcomeLine(a: AxisProposal): string {
48
- if (a.outcome === "no-motif") return "No motif kept.";
49
- if (a.outcome === "no-proposal") return `No proposal: the answer did not parse after one re-ask (${a.reason ?? "no reason given"}).`;
50
- return `Unchanged since ${a.reason ?? "an earlier run"}: not asked again.`;
49
+ if (a.outcome === "no-motif") return NO_MOTIF_KEPT;
50
+ if (a.outcome === "no-proposal") return noProposal(a.reason);
51
+ return unchangedSince(a.reason);
51
52
  }
52
53
 
53
54
  function axisSection(a: AxisProposal): string[] {
54
55
  const out = [`## ${a.axis} — ${a.batches} batches, ${a.gaps} gaps`, ""];
55
56
  if (a.outcome === "proposed") {
56
57
  out.push(
57
- "| Id | Motif | Batches | Status | Owner | Check | Reconcile |",
58
- "|----|-------|---------|--------|-------|-------|-----------|",
58
+ ...MOTIF_TABLE_HEADER,
59
59
  ...a.motifs.map(tableRow),
60
60
  );
61
61
  } else {
@@ -63,7 +63,7 @@ function axisSection(a: AxisProposal): string[] {
63
63
  }
64
64
  const notes = [
65
65
  ...a.dropped.map((d) => `Dropped: ${d.title} — ${d.filter}: ${d.reason}`),
66
- ...(a.hiddenRows > 0 ? [`Not shown to the model: ${a.hiddenRows} gaps (cap ${ROWS_CAP})`] : []),
66
+ ...(a.hiddenRows > 0 ? [notShown(a.hiddenRows, ROWS_CAP)] : []),
67
67
  ];
68
68
  if (notes.length > 0) out.push("", ...notes);
69
69
  if (a.outcome === "proposed") for (const m of a.motifs) out.push("", ...motifBlock(m));
@@ -72,7 +72,7 @@ function axisSection(a: AxisProposal): string[] {
72
72
 
73
73
  function decideSection(file: ProposalsFile): string[] {
74
74
  const ids = file.axes.flatMap((a) => (a.outcome === "proposed" ? a.motifs.map((m) => m.id) : []));
75
- if (ids.length === 0) return ["## Decide", "", "Nothing to decide."];
75
+ if (ids.length === 0) return ["## Decide", "", NOTHING_TO_DECIDE];
76
76
  return [
77
77
  "## Decide", "",
78
78
  `${FENCE}text`,
@@ -87,8 +87,7 @@ export function renderProposals(file: ProposalsFile): string {
87
87
  const lines = [
88
88
  `# Learn proposals — ${file.date}`,
89
89
  "",
90
- `Work folder \`${file.work}\`: ${r.gaps} untreated gaps across ${r.batches} batches in ${r.files} verdict files. ` +
91
- `Treated before: ${r.treatedOrkeon} by Orkeon Code, ${r.treatedHarness} by the harness. Refused motifs: ${r.refused}.`,
90
+ proposalsHead(file.work, r.gaps, r.batches, r.files, r.treatedOrkeon, r.treatedHarness, r.refused),
92
91
  ];
93
92
  for (const a of file.axes) lines.push("", ...axisSection(a));
94
93
  lines.push("", ...decideSection(file));
@@ -6,6 +6,7 @@
6
6
  import type { Files } from "../../../shared/application/ports.ts";
7
7
  import { stepLabel } from "../domain/plan-answer.ts";
8
8
  import type { AnchorRef, PlanAnswer } from "../domain/plan-answer.ts";
9
+ import { anchorKindSetRight, anchorPathColon, doesNotExist, existsAnchorIt, notCheckedEntries, notCheckedFolders } from "../domain/messages.ts";
9
10
  import { WORKSPACE } from "../../../shared/domain/vfs.ts";
10
11
 
11
12
  export const MAX_ANCHOR_FOLDERS = 40;
@@ -21,28 +22,64 @@ const folderOf = (path: string): string => {
21
22
  };
22
23
  const nameOf = (path: string): string => path.slice(path.lastIndexOf("/") + 1);
23
24
 
25
+ /** The names of `folder`, listed once per run; null past MAX_ANCHOR_FOLDERS folders. A listing that throws is empty. */
26
+ async function listingOf(files: Pick<Files, "list">, listings: AnchorListings, folder: string): Promise<ReadonlySet<string> | null> {
27
+ const known = listings.get(folder);
28
+ if (known !== undefined) return known;
29
+ if (listings.size >= MAX_ANCHOR_FOLDERS) return null;
30
+ let names: string[];
31
+ try {
32
+ names = await files.list(folder === "" ? WORKSPACE : `${WORKSPACE}/${folder}`, LIST_CAP);
33
+ } catch {
34
+ names = [];
35
+ }
36
+ const set = new Set(names.map((n) => n.replace(/\/+$/, "")));
37
+ listings.set(folder, set);
38
+ return set;
39
+ }
40
+
41
+ /**
42
+ * The anchor kind code knows better than the model, set right in `answer` instead of costing a second call: a test
43
+ * or double file given as existing that a whole listing does not hold becomes a file to create. A production file
44
+ * given as existing and absent stays for checkAnchorPaths to refuse (the step meant to change code that is not
45
+ * there), as does a file to create that exists (the plan did not see it). Returns one line per anchor set right.
46
+ */
47
+ export async function repairAnchorKinds(
48
+ files: Pick<Files, "list">, answer: PlanAnswer, listings: AnchorListings = new Map(),
49
+ ): Promise<string[]> {
50
+ const repaired: string[] = [];
51
+ for (const batch of answer.batches) {
52
+ for (const step of batch.steps) {
53
+ const anchors: Array<[AnchorRef, boolean]> = [
54
+ ...step.anchors.tests.map((a): [AnchorRef, boolean] => [a, true]),
55
+ ...step.anchors.doubles.map((a): [AnchorRef, boolean] => [a, true]),
56
+ ...step.anchors.production.map((a): [AnchorRef, boolean] => [a, false]),
57
+ ];
58
+ for (const [a, testSide] of anchors) {
59
+ if (!testSide || a.kind !== "existing" || a.path === undefined) continue;
60
+ const path = a.path.replace(/^\.\//, "");
61
+ if (path.includes(":")) continue;
62
+ const names = await listingOf(files, listings, folderOf(path));
63
+ if (names === null) continue;
64
+ if (a.kind === "existing" && !names.has(nameOf(path)) && names.size < LIST_CAP) {
65
+ a.kind = "create";
66
+ repaired.push(anchorKindSetRight(path));
67
+ }
68
+ }
69
+ }
70
+ }
71
+ return [...new Set(repaired)];
72
+ }
73
+
24
74
  /**
25
75
  * `<step>: <path> does not exist` / `<step>: <path> exists: …` / `<step>: anchor "<path>" not checked: …`, the step
26
- * labelled as the answer check labels it (`B1 "<name>" S2 "<title>"`),
76
+ * labelled as the answer check labels it (`F1 "<name>" S2 "<title>"`),
27
77
  * each once, in plan order. `listings` carries the folders already listed in this run, and gains the new ones.
28
78
  */
29
79
  export async function checkAnchorPaths(
30
80
  files: Pick<Files, "list">, answer: PlanAnswer, listings: AnchorListings = new Map(),
31
81
  ): Promise<string[]> {
32
- const listing = async (folder: string): Promise<ReadonlySet<string> | null> => {
33
- const known = listings.get(folder);
34
- if (known !== undefined) return known;
35
- if (listings.size >= MAX_ANCHOR_FOLDERS) return null;
36
- let names: string[];
37
- try {
38
- names = await files.list(folder === "" ? WORKSPACE : `${WORKSPACE}/${folder}`, LIST_CAP);
39
- } catch {
40
- names = [];
41
- }
42
- const set = new Set(names.map((n) => n.replace(/\/+$/, "")));
43
- listings.set(folder, set);
44
- return set;
45
- };
82
+ const listing = (folder: string) => listingOf(files, listings, folder);
46
83
  const problems: string[] = [];
47
84
  const seen = new Set<string>();
48
85
  for (const [k, batch] of answer.batches.entries()) {
@@ -54,18 +91,18 @@ export async function checkAnchorPaths(
54
91
  const at = stepLabel(batch, k, j);
55
92
  let problem: string | null = null;
56
93
  if (path.includes(":")) {
57
- problem = `${at}: anchor path "${path}" holds ":"`;
94
+ problem = anchorPathColon(at, path);
58
95
  } else {
59
96
  const names = await listing(folderOf(path));
60
97
  if (names === null) {
61
- if (a.kind === "existing") problem = `${at}: anchor "${path}" not checked: more than ${MAX_ANCHOR_FOLDERS} folders`;
98
+ if (a.kind === "existing") problem = notCheckedFolders(at, path, MAX_ANCHOR_FOLDERS);
62
99
  } else {
63
100
  const present = names.has(nameOf(path));
64
101
  // A listing the cap cut short may leave the name out: that is no proof it is absent.
65
102
  if (a.kind === "existing" && !present && names.size >= LIST_CAP) {
66
- problem = `${at}: anchor "${path}" not checked: its folder lists more than ${LIST_CAP} entries`;
67
- } else if (a.kind === "existing" && !present) problem = `${at}: ${path} does not exist`;
68
- if (a.kind === "create" && present) problem = `${at}: ${path} exists: anchor it as existing, or by its ref`;
103
+ problem = notCheckedEntries(at, path, LIST_CAP);
104
+ } else if (a.kind === "existing" && !present) problem = doesNotExist(at, path);
105
+ if (a.kind === "create" && present) problem = existsAnchorIt(at, path);
69
106
  }
70
107
  }
71
108
  if (problem !== null && !seen.has(problem)) { seen.add(problem); problems.push(problem); }
@@ -8,6 +8,10 @@ import { INVENTORY_CAPS, keepPath, layerOf } from "../domain/inventory-model.ts"
8
8
  import type { Inventory, InventoryEntry } from "../domain/inventory-model.ts";
9
9
  import { WORKSPACE } from "../../../shared/domain/vfs.ts";
10
10
  import { indexCacheNote } from "../../../shared/domain/code-intel-contract.ts";
11
+ import {
12
+ INDEX_EMPTY, anchorsFailed, callersAsked, closureTruncated, droppedOutside, entriesLocated, graphFailed, graphJoined,
13
+ indexCannotBeBuilt, indexStatus, searchFailedUnquoted, titlesNotSearched, titlesSearched as titlesSearchedLine,
14
+ } from "./messages.ts";
11
15
 
12
16
  export interface InventoryRequest {
13
17
  titles: ReadonlyArray<{ id: string; title: string }>; // source order: UC, BR, CH
@@ -46,7 +50,7 @@ async function search(
46
50
  const found = await index.search(t.title, INVENTORY_CAPS.topK);
47
51
  hits.push(found.filter((h) => keep(pathPart(h.fqn)) !== null));
48
52
  } catch (e) {
49
- state.warnings.push(`search failed for ${t.id}: ${firstLine(e)}`);
53
+ state.warnings.push(searchFailedUnquoted(t.id, firstLine(e)));
50
54
  hits.push([]);
51
55
  }
52
56
  }
@@ -79,7 +83,7 @@ export async function buildInventory(
79
83
  const state = { calls: 0, warnings: [] as string[] };
80
84
  const refuse = (e: unknown) => ({
81
85
  ok: false as const,
82
- text: `dev-plan: the code index cannot be built (${firstLine(e)}): anchors would be guesses, so no plan is written`,
86
+ text: indexCannotBeBuilt(firstLine(e)),
83
87
  });
84
88
 
85
89
  // 1. The index: present, or built now.
@@ -96,9 +100,9 @@ export async function buildInventory(
96
100
  } catch (e) {
97
101
  return refuse(e);
98
102
  }
99
- log.info(`dev-plan: code index ${status}${note === "" ? "" : `; ${note}`}`);
103
+ log.info(indexStatus(status, note));
100
104
  if (status === "empty") {
101
- state.warnings.push("the code index holds no file: every anchor is a path to create");
105
+ state.warnings.push(INDEX_EMPTY);
102
106
  return { ok: true, inventory: { entries: [], index: status, titlesSearched: 0, calls: state.calls, warnings: state.warnings } };
103
107
  }
104
108
 
@@ -107,10 +111,10 @@ export async function buildInventory(
107
111
  const titlesSearched = Math.min(request.titles.length, INVENTORY_CAPS.titles);
108
112
  if (request.titles.length > INVENTORY_CAPS.titles) {
109
113
  const left = request.titles.slice(INVENTORY_CAPS.titles);
110
- state.warnings.push(`${left.length} titles not searched: ${left.map((t) => t.id).join(", ")}`);
114
+ state.warnings.push(titlesNotSearched(left.length, left.map((t) => t.id).join(", ")));
111
115
  }
112
116
  const kept = await search(index, request, keep, state);
113
- log.info(`dev-plan: ${titlesSearched} titles searched, ${kept.length} symbols kept`);
117
+ log.info(titlesSearchedLine(titlesSearched, kept.length));
114
118
 
115
119
  // 3. Where each kept symbol lives; refs are given to the survivors, in discovery order.
116
120
  const order = new Map(request.titles.map((t, i) => [t.id, i]));
@@ -120,7 +124,7 @@ export async function buildInventory(
120
124
  try {
121
125
  const at = await index.symbolSource(k.fqn);
122
126
  const path = keep(at.path);
123
- if (path === null) { state.warnings.push(`${k.fqn} dropped: ${at.path} is outside what a plan may anchor`); continue; }
127
+ if (path === null) { state.warnings.push(droppedOutside(k.fqn, at.path)); continue; }
124
128
  entries.push({
125
129
  ref: `I${entries.length + 1}`, fqn: k.fqn, name: nameOf(k.fqn), path,
126
130
  line: at.startLine, endLine: at.endLine, language: at.language, firstLine: at.firstLine,
@@ -132,7 +136,7 @@ export async function buildInventory(
132
136
  state.warnings.push(`${k.fqn} dropped: ${firstLine(e)}`);
133
137
  }
134
138
  }
135
- log.info(`dev-plan: ${entries.length} entries located`);
139
+ log.info(entriesLocated(entries.length));
136
140
 
137
141
  if (entries.length > 0) {
138
142
  // 4. The callers and tests of the best entries: their closure without their own subtree.
@@ -143,13 +147,13 @@ export async function buildInventory(
143
147
  const closure = await anchors.closure([e.fqn]);
144
148
  const own = relative(e.fqn);
145
149
  e.callers = closure.nodes.map(relative).filter((n) => !inSubtree(n, own)).slice(0, INVENTORY_CAPS.callers);
146
- if (closure.truncated) state.warnings.push(`closure of ${e.fqn} truncated`);
150
+ if (closure.truncated) state.warnings.push(closureTruncated(e.fqn));
147
151
  if (closure.unresolved.length > 0) state.warnings.push(`${e.fqn} unknown to batch_anchors`);
148
152
  } catch (err) {
149
- state.warnings.push(`anchors failed for ${e.fqn}: ${firstLine(err)}`);
153
+ state.warnings.push(anchorsFailed(e.fqn, firstLine(err)));
150
154
  }
151
155
  }
152
- log.info(`dev-plan: callers asked for ${best.length} entries`);
156
+ log.info(callersAsked(best.length));
153
157
 
154
158
  // 5. The modules each entry's file imports, from one module graph.
155
159
  state.calls++;
@@ -160,9 +164,9 @@ export async function buildInventory(
160
164
  const to = graph.edges.filter((edge) => fileOf(edge.from) === e.path).map((edge) => fileOf(edge.to));
161
165
  e.imports = [...new Set(to)].filter((p) => p !== e.path).slice(0, INVENTORY_CAPS.imports);
162
166
  }
163
- log.info(`dev-plan: module graph of ${graph.edges.length} edges joined`);
167
+ log.info(graphJoined(graph.edges.length));
164
168
  } catch (e) {
165
- state.warnings.push(`the module graph failed: ${firstLine(e)}`);
169
+ state.warnings.push(graphFailed(firstLine(e)));
166
170
  }
167
171
  }
168
172
 
@@ -0,0 +1,88 @@
1
+ // The messages of /dev-plan: its refusals, the warnings and log lines of its inventory, the lines of its end
2
+ // message, and the words of its crew (ADR 0026).
3
+
4
+ // ── The crew ────────────────────────────────────────────────────────────
5
+
6
+ export const PLANNER_GOAL = "Turn a settled specification or change brief into batches a test-first implementation can follow";
7
+ export const PLAN_REVIEW_TASK = "review of the plan";
8
+
9
+ // ── Refusals ────────────────────────────────────────────────────────────
10
+
11
+ /** The last line of a plan ready to implement; `{command}` names the next step. */
12
+ export const END_LINE = "→ Read and validate the plan. Then implement batch by batch: {command}";
13
+ export const BAD_INPUT_SOURCE = "dev-plan: invalid crew input: source";
14
+ export const BAD_INPUT_REPLACE = "dev-plan: invalid crew input: replace";
15
+ export const planRunFromCheckout = (workspace: string, top: string): string =>
16
+ `dev-plan: run from the checkout at ${workspace} (git reports ${top === "" ? "no work tree" : top})`;
17
+
18
+ // ── An existing plan ────────────────────────────────────────────────────
19
+
20
+ export const batchIsDone = (id: string): string => `batch ${id} is done`;
21
+ export const stepIsTicked = (n: number, id: string): string => `step ${n} of ${id} is ticked`;
22
+ export const titleReadsDone = (date: string): string => `its title reads done (${date})`;
23
+ export const tddLineTicked = (n: number): string => `the TDD line of step ${n} is ticked`;
24
+ export const planExists = (shown: string, code: string): string =>
25
+ `dev-plan: ${shown} exists: /dev-plan ${code} --replace writes a new plan over it (nothing is merged)`;
26
+ export const planCannotBeReadNothingReplaced = (shown: string, why: string): string => `dev-plan: ${shown} cannot be read (${why}): nothing is replaced`;
27
+ export const recordsWorkDone = (shown: string, done: string): string =>
28
+ `dev-plan: ${shown} records work done (${done}): a started plan is never replaced; plan the rest as a new change`;
29
+
30
+ // ── The plan ────────────────────────────────────────────────────────────
31
+
32
+ export const planRendererDefect = (first: string): string =>
33
+ `dev-plan: a checked answer rendered a plan that fails its self-check (a renderer defect): ${first}`;
34
+ export const namesNoTraceableId = (shown: string): string => `dev-plan: ${shown} names no UC-, BR- or CH- id: nothing to trace`;
35
+ export const planTitleNamesNoKind = (shown: string): string => `dev-plan: ${shown}: the title names no kind (bug, refactor or perf)`;
36
+ export const noRoomForInventory = (fixed: number, max: number): string =>
37
+ `dev-plan: the prompt leaves no room for the inventory: its instructions, ids, commands and precedents take ${fixed} ` +
38
+ `of ${max} characters; nothing is written. Split the source, or run it again with fewer precedents.`;
39
+ export const REFUSED_TWICE = "dev-plan: the plan was refused twice; nothing is written.";
40
+ export const fewerBatches = (batches: number, previous: number, extra: string, code: string): string =>
41
+ `dev-plan: the new plan has ${batches} batches and the previous one ${previous}; ` +
42
+ `Orkeon Code cannot delete a file: remove ${extra} by hand, then /dev-plan ${code} --replace. Nothing is written.`;
43
+ export const planFileNotWritten = (shown: string, why: string): string =>
44
+ `dev-plan: ${shown} could not be written (${why}); the files before it are written`;
45
+ export const planWritten = (shown: string, sheets: number): string => `dev-plan: ${shown} and ${sheets} sheets written`;
46
+
47
+ // ── The end message ─────────────────────────────────────────────────────
48
+
49
+ export const everyBatch = (first: string, code: string): string =>
50
+ `${first}, or /dev-batches ${code} for every batch in their dependencies' order`;
51
+ export const reviewHead = (verdict: string, blocking: number, majors: number, places: string): string =>
52
+ `review: ${verdict} — ${blocking} Blocking, ${majors} Major (${places})`;
53
+ export const BOTH_LINES = "the Commands and Layout lines";
54
+ export const COMMANDS_LINE = "the Commands line";
55
+ export const notInPack = (keys: string, where: string, planName: string, code: string): string =>
56
+ `${keys} not in the pack: fill them on ${where} of ${planName} § 1, or add them to ` +
57
+ `.orkeon/repo.yaml and run /dev-plan ${code} --replace`;
58
+ export const reviewNotRunWithCause = (reason: string, first: string): string => `review: not run (${reason}: ${first})`;
59
+ export const REVIEWED_FAILS_SELF_CHECK =
60
+ "dev-plan: the reviewed plan fails its self-check; the files written before the review stay as they are.";
61
+ export const ROWS_NOT_WRITTEN = "review rows that could not be written:";
62
+ export const inventoryFromTitles = (entries: number, titles: number, index: string, calls: number): string =>
63
+ `inventory: ${entries} entries from ${titles} titles (index ${index}, ${calls} calls)`;
64
+ export const SETTLE_CHANGE = "the change brief: /dev-spec";
65
+ export const SETTLE_SPEC = "the spec: /dev-spec";
66
+ export const planBlocked = (questions: string, shown: string): string =>
67
+ `dev-plan: the plan is blocked: ${questions} in ${shown} § 4; every batch reads — blocked.`;
68
+ export const answerThenReplan = (pronoun: string, settle: string, code: string, kind: string): string =>
69
+ `→ Answer ${pronoun} in ${settle} ${code}${kind}, then /dev-plan ${code} --replace. Do not implement before.`;
70
+ export const unreviewed = (code: string): string =>
71
+ `→ The plan is written but unreviewed: read it closely before implementing, or /dev-plan ${code} --replace to plan and review again.`;
72
+
73
+ // ── The inventory ───────────────────────────────────────────────────────
74
+
75
+ export const searchFailedUnquoted = (id: string, why: string): string => `search failed for ${id}: ${why}`;
76
+ export const indexCannotBeBuilt = (why: string): string =>
77
+ `dev-plan: the code index cannot be built (${why}): anchors would be guesses, so no plan is written`;
78
+ export const indexStatus = (status: string, note: string): string => `dev-plan: code index ${status}${note === "" ? "" : `; ${note}`}`;
79
+ export const INDEX_EMPTY = "the code index holds no file: every anchor is a path to create";
80
+ export const titlesNotSearched = (count: number, ids: string): string => `${count} titles not searched: ${ids}`;
81
+ export const titlesSearched = (titles: number, kept: number): string => `dev-plan: ${titles} titles searched, ${kept} symbols kept`;
82
+ export const droppedOutside = (fqn: string, path: string): string => `${fqn} dropped: ${path} is outside what a plan may anchor`;
83
+ export const entriesLocated = (count: number): string => `dev-plan: ${count} entries located`;
84
+ export const closureTruncated = (fqn: string): string => `closure of ${fqn} truncated`;
85
+ export const anchorsFailed = (fqn: string, why: string): string => `anchors failed for ${fqn}: ${why}`;
86
+ export const callersAsked = (count: number): string => `dev-plan: callers asked for ${count} entries`;
87
+ export const graphJoined = (edges: number): string => `dev-plan: module graph of ${edges} edges joined`;
88
+ export const graphFailed = (why: string): string => `the module graph failed: ${why}`;