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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (440) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +206 -11
  13. package/orkeon-code.ps1 +109 -7
  14. package/package.json +2 -1
  15. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  16. package/src/commands/_lib/args.ts +5 -4
  17. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  18. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  19. package/src/commands/_lib/dev/dev-source.ts +7 -11
  20. package/src/commands/_lib/dev/dev.ts +34 -37
  21. package/src/commands/_lib/dev/markers.ts +7 -0
  22. package/src/commands/_lib/dev/messages.ts +112 -0
  23. package/src/commands/_lib/dev-step.ts +16 -13
  24. package/src/commands/_lib/dispatch.ts +62 -39
  25. package/src/commands/_lib/git/branch.ts +9 -10
  26. package/src/commands/_lib/git/commit.ts +9 -13
  27. package/src/commands/_lib/git/diff.ts +22 -12
  28. package/src/commands/_lib/git/messages.ts +54 -0
  29. package/src/commands/_lib/git/review.ts +9 -10
  30. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  31. package/src/commands/_lib/memory/memory.ts +3 -2
  32. package/src/commands/_lib/memory/messages.ts +32 -0
  33. package/src/commands/_lib/messages.ts +48 -0
  34. package/src/commands/_lib/project/messages.ts +8 -0
  35. package/src/commands/_lib/session/export.ts +3 -2
  36. package/src/commands/_lib/session/messages.ts +87 -0
  37. package/src/commands/_lib/session/prompts.ts +4 -0
  38. package/src/commands/_lib/session/resume.ts +15 -24
  39. package/src/commands/_lib/session/tasks.ts +20 -23
  40. package/src/commands/_lib/settings/advisor.ts +11 -16
  41. package/src/commands/_lib/settings/agents.ts +18 -28
  42. package/src/commands/_lib/settings/choices.ts +8 -0
  43. package/src/commands/_lib/settings/config.ts +43 -43
  44. package/src/commands/_lib/settings/effort.ts +147 -0
  45. package/src/commands/_lib/settings/hooks.ts +12 -20
  46. package/src/commands/_lib/settings/messages.ts +408 -0
  47. package/src/commands/_lib/settings/mode.ts +33 -24
  48. package/src/commands/_lib/settings/model.ts +71 -36
  49. package/src/commands/_lib/settings/output-style.ts +39 -0
  50. package/src/commands/_lib/settings/permissions.ts +71 -93
  51. package/src/commands/_lib/settings/route.ts +63 -0
  52. package/src/commands/_lib/settings/skills.ts +53 -11
  53. package/src/commands/_lib/settings/theme.ts +42 -0
  54. package/src/commands/_lib/speech/messages.ts +58 -0
  55. package/src/commands/_lib/speech/prompts.ts +4 -0
  56. package/src/commands/_lib/speech/say.ts +9 -10
  57. package/src/commands/_lib/speech/transcribe.ts +14 -23
  58. package/src/commands/_lib/speech/voice.ts +14 -18
  59. package/src/commands/_lib/status/doctor.ts +47 -28
  60. package/src/commands/_lib/status/messages.ts +100 -0
  61. package/src/commands/_lib/status/meta.ts +3 -24
  62. package/src/commands/_lib/status/status.ts +10 -11
  63. package/src/commands/_lib/status/usage-tools.ts +2 -3
  64. package/src/commands/_lib/status/usage.ts +7 -18
  65. package/src/commands/_lib/view.ts +6 -1
  66. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  67. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  68. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  69. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  70. package/src/commands/git/commit.cmd.ts +3 -3
  71. package/src/commands/git/review.cmd.ts +3 -3
  72. package/src/commands/memory/memory.cmd.ts +2 -2
  73. package/src/commands/project/analyze.cmd.ts +3 -3
  74. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  75. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  76. package/src/commands/project/init.cmd.ts +3 -3
  77. package/src/commands/project/verify.cmd.ts +2 -2
  78. package/src/commands/session/assistant.cmd.ts +2 -2
  79. package/src/commands/session/compact.cmd.ts +1 -1
  80. package/src/commands/session/copy.cmd.ts +8 -7
  81. package/src/commands/session/rename.cmd.ts +3 -2
  82. package/src/commands/session/rewind.cmd.ts +3 -4
  83. package/src/commands/session/summary.cmd.ts +3 -3
  84. package/src/commands/session/tasks.cmd.ts +4 -2
  85. package/src/commands/settings/config.cmd.ts +4 -2
  86. package/src/commands/settings/effort.cmd.ts +10 -31
  87. package/src/commands/settings/fast.cmd.ts +2 -1
  88. package/src/commands/settings/mode.cmd.ts +3 -3
  89. package/src/commands/settings/model.cmd.ts +3 -2
  90. package/src/commands/settings/output-style.cmd.ts +9 -38
  91. package/src/commands/settings/permissions.cmd.ts +2 -2
  92. package/src/commands/settings/proactive.cmd.ts +2 -1
  93. package/src/commands/settings/route.cmd.ts +16 -0
  94. package/src/commands/settings/skills.cmd.ts +3 -3
  95. package/src/commands/settings/theme.cmd.ts +14 -0
  96. package/src/commands/speech/say.cmd.ts +2 -2
  97. package/src/commands/speech/transcribe.cmd.ts +2 -2
  98. package/src/commands/status/release-notes.cmd.ts +1 -1
  99. package/src/crews/.orkeon/orkeon.d.ts +538 -93
  100. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  101. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  102. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  103. package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
  104. package/src/crews/advisor/application/messages.ts +4 -0
  105. package/src/crews/advisor/application/prompts.ts +4 -0
  106. package/src/crews/advisor/application/run-advisor.ts +2 -1
  107. package/src/crews/advisor/crew.ork.ts +5 -4
  108. package/src/crews/advisor/domain/advice.ts +7 -23
  109. package/src/crews/advisor/domain/messages.ts +8 -0
  110. package/src/crews/advisor/domain/prompts.ts +26 -0
  111. package/src/crews/agent-run/application/messages.ts +18 -0
  112. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  113. package/src/crews/agent-run/crew.ork.ts +3 -3
  114. package/src/crews/analyze/application/messages.ts +27 -0
  115. package/src/crews/analyze/application/prompts.ts +4 -0
  116. package/src/crews/analyze/application/run-analyze.ts +16 -14
  117. package/src/crews/analyze/crew.ork.ts +5 -4
  118. package/src/crews/analyze/domain/harvest.ts +33 -65
  119. package/src/crews/analyze/domain/prompts.ts +86 -0
  120. package/src/crews/code-review/application/lens-material.ts +24 -0
  121. package/src/crews/code-review/application/messages.ts +17 -0
  122. package/src/crews/code-review/application/prompts.ts +10 -17
  123. package/src/crews/code-review/application/review.ts +4 -1
  124. package/src/crews/code-review/application/run-code-review.ts +13 -15
  125. package/src/crews/code-review/crew.ork.ts +5 -4
  126. package/src/crews/code-review/domain/lenses.ts +6 -45
  127. package/src/crews/code-review/domain/messages.ts +25 -0
  128. package/src/crews/code-review/domain/prompts.ts +58 -0
  129. package/src/crews/code-review/domain/report.ts +5 -6
  130. package/src/crews/code-review/domain/scope.ts +6 -12
  131. package/src/crews/dev-batches/application/messages.ts +127 -0
  132. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  133. package/src/crews/dev-batches/application/prompts.ts +10 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  135. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  136. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  137. package/src/crews/dev-batches/crew.ork.ts +12 -9
  138. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  139. package/src/crews/dev-batches/domain/markers.ts +5 -0
  140. package/src/crews/dev-batches/domain/messages.ts +6 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  142. package/src/crews/dev-change/application/change-material.ts +44 -0
  143. package/src/crews/dev-change/application/evidence.ts +25 -22
  144. package/src/crews/dev-change/application/messages.ts +81 -0
  145. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  146. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  147. package/src/crews/dev-change/crew.ork.ts +11 -9
  148. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  149. package/src/crews/dev-change/domain/change-render.ts +13 -15
  150. package/src/crews/dev-change/domain/markers.ts +28 -0
  151. package/src/crews/dev-change/domain/messages.ts +16 -0
  152. package/src/crews/dev-implement/application/close.ts +21 -18
  153. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  154. package/src/crews/dev-implement/application/messages.ts +161 -0
  155. package/src/crews/dev-implement/application/observe.ts +4 -2
  156. package/src/crews/dev-implement/application/prompts.ts +9 -0
  157. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  158. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  159. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  160. package/src/crews/dev-implement/crew.ork.ts +2 -1
  161. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  162. package/src/crews/dev-implement/domain/correction.ts +16 -15
  163. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  164. package/src/crews/dev-implement/domain/markers.ts +23 -0
  165. package/src/crews/dev-implement/domain/messages.ts +58 -0
  166. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  167. package/src/crews/dev-implement/domain/roles.ts +3 -7
  168. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  169. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  170. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  171. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  172. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  173. package/src/crews/dev-learn/application/messages.ts +51 -0
  174. package/src/crews/dev-learn/application/{learn-prompt.ts → prompts.ts} +24 -65
  175. package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
  176. package/src/crews/dev-learn/crew.ork.ts +4 -3
  177. package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
  178. package/src/crews/dev-learn/domain/messages.ts +65 -0
  179. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  180. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  181. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  182. package/src/crews/dev-plan/application/inventory.ts +17 -13
  183. package/src/crews/dev-plan/application/messages.ts +88 -0
  184. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  185. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  186. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  187. package/src/crews/dev-plan/crew.ork.ts +11 -8
  188. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  189. package/src/crews/dev-plan/domain/markers.ts +18 -0
  190. package/src/crews/dev-plan/domain/messages.ts +118 -0
  191. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  192. package/src/crews/dev-plan/domain/plan-render.ts +30 -31
  193. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  194. package/src/crews/dev-spec/application/messages.ts +30 -0
  195. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  196. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  197. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  198. package/src/crews/dev-spec/crew.ork.ts +11 -9
  199. package/src/crews/dev-spec/domain/markers.ts +30 -0
  200. package/src/crews/dev-spec/domain/messages.ts +39 -0
  201. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  202. package/src/crews/dev-spec/domain/spec-render.ts +18 -18
  203. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  204. package/src/crews/dev-verify/application/audit.ts +38 -30
  205. package/src/crews/dev-verify/application/capture.ts +34 -26
  206. package/src/crews/dev-verify/application/messages.ts +119 -0
  207. package/src/crews/dev-verify/application/prompts.ts +209 -0
  208. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  209. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  210. package/src/crews/dev-verify/crew.ork.ts +6 -6
  211. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  212. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  213. package/src/crews/dev-verify/domain/commands.ts +3 -3
  214. package/src/crews/dev-verify/domain/gate.ts +21 -16
  215. package/src/crews/dev-verify/domain/markers.ts +16 -0
  216. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  217. package/src/crews/dev-verify/domain/messages.ts +92 -0
  218. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  219. package/src/crews/git-commit/application/draft.ts +16 -37
  220. package/src/crews/git-commit/application/messages.ts +15 -0
  221. package/src/crews/git-commit/application/prompts.ts +47 -0
  222. package/src/crews/git-commit/application/run-git-commit.ts +13 -12
  223. package/src/crews/git-commit/crew.ork.ts +5 -4
  224. package/src/crews/git-commit/domain/commit.ts +15 -35
  225. package/src/crews/git-commit/domain/markers.ts +4 -0
  226. package/src/crews/git-commit/domain/messages.ts +48 -0
  227. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  228. package/src/crews/init-verifiers/application/messages.ts +13 -0
  229. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  230. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  231. package/src/crews/init-verifiers/crew.ork.ts +5 -4
  232. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  233. package/src/crews/main-loop/application/messages.ts +81 -0
  234. package/src/crews/main-loop/application/prompts.ts +12 -0
  235. package/src/crews/main-loop/application/run-main-loop.ts +63 -30
  236. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  237. package/src/crews/main-loop/crew.ork.ts +12 -7
  238. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  239. package/src/crews/main-loop/domain/prompts.ts +336 -0
  240. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  241. package/src/crews/project-init/application/detect.ts +5 -4
  242. package/src/crews/project-init/application/messages.ts +15 -0
  243. package/src/crews/project-init/application/prompts.ts +11 -7
  244. package/src/crews/project-init/crew.ork.ts +5 -4
  245. package/src/crews/project-init/domain/existing-files.ts +6 -4
  246. package/src/crews/project-init/domain/messages.ts +13 -0
  247. package/src/crews/project-init/domain/package-map.ts +3 -3
  248. package/src/crews/project-init/domain/prompts.ts +10 -0
  249. package/src/crews/session-compact/application/prompts.ts +5 -0
  250. package/src/crews/session-compact/crew.ork.ts +5 -4
  251. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  252. package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
  253. package/src/crews/speech/application/messages.ts +3 -0
  254. package/src/crews/speech/application/prompts.ts +3 -0
  255. package/src/crews/speech/application/run-speech.ts +2 -1
  256. package/src/crews/speech/crew.ork.ts +2 -1
  257. package/src/shared/application/agents/child-agent.ts +11 -7
  258. package/src/shared/application/agents/messages.ts +35 -0
  259. package/src/shared/application/agents/route-agent.ts +115 -0
  260. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  261. package/src/shared/application/compaction/compact-session.ts +19 -14
  262. package/src/shared/application/compaction/messages.ts +20 -0
  263. package/src/shared/application/compaction/prune-context.ts +94 -0
  264. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  265. package/src/shared/application/dev/brief-inventory.ts +6 -4
  266. package/src/shared/application/dev/close-batch.ts +9 -7
  267. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  268. package/src/shared/application/dev/learn-decision.ts +20 -18
  269. package/src/shared/application/dev/load-dev-context.ts +7 -8
  270. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  271. package/src/shared/application/dev/messages.ts +132 -0
  272. package/src/shared/application/dev/phase-timer.ts +54 -0
  273. package/src/shared/application/dev/plan-source.ts +12 -8
  274. package/src/shared/application/dev/preflight.ts +8 -8
  275. package/src/shared/application/dev/prompts.ts +34 -0
  276. package/src/shared/application/dev/question-round.ts +25 -17
  277. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  278. package/src/shared/application/dev/settle-questions.ts +4 -2
  279. package/src/shared/application/dev/source-review.ts +12 -8
  280. package/src/shared/application/dev/source-step.ts +12 -10
  281. package/src/shared/application/dev/spend.ts +17 -4
  282. package/src/shared/application/dev/step-precedents.ts +2 -1
  283. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  284. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  285. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  286. package/src/shared/application/dev/verdict-sources.ts +5 -3
  287. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  288. package/src/shared/application/extra-tools.ts +2 -1
  289. package/src/shared/application/git/batch-worktree.ts +22 -17
  290. package/src/shared/application/git/commit-files.ts +24 -19
  291. package/src/shared/application/git/merge-batch.ts +11 -7
  292. package/src/shared/application/git/messages.ts +75 -0
  293. package/src/shared/application/git/open-pull-request.ts +4 -3
  294. package/src/shared/application/host-context.ts +59 -0
  295. package/src/shared/application/host-layout-store.ts +45 -0
  296. package/src/shared/application/llm-profile.ts +4 -3
  297. package/src/shared/application/messages.ts +14 -0
  298. package/src/shared/application/permission-rules.ts +10 -0
  299. package/src/shared/application/ports/decision.ts +14 -0
  300. package/src/shared/application/ports/human.ts +25 -0
  301. package/src/shared/application/ports/llm.ts +32 -3
  302. package/src/shared/application/ports/memory.ts +1 -1
  303. package/src/shared/application/ports/theme.ts +11 -0
  304. package/src/shared/application/ports.ts +4 -2
  305. package/src/shared/application/session-io.ts +2 -1
  306. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  307. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  308. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  309. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  310. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  311. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  312. package/src/shared/application/shared-memory/messages.ts +63 -0
  313. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  314. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  315. package/src/shared/application/skills/messages.ts +4 -0
  316. package/src/shared/application/skills/suggest-skills.ts +102 -0
  317. package/src/shared/application/workflow/messages.ts +8 -0
  318. package/src/shared/application/workflow/workflow-state.ts +7 -6
  319. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  320. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  321. package/src/shared/domain/agent-policy/messages.ts +66 -0
  322. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  323. package/src/shared/domain/agent-policy/permission.ts +20 -18
  324. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  325. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  326. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  327. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  328. package/src/shared/domain/agent-registry.ts +6 -5
  329. package/src/shared/domain/agents/chain.ts +2 -2
  330. package/src/shared/domain/agents/charter.ts +8 -5
  331. package/src/shared/domain/agents/exclusive.ts +2 -1
  332. package/src/shared/domain/agents/instances.ts +18 -15
  333. package/src/shared/domain/agents/messages.ts +39 -0
  334. package/src/shared/domain/agents/model-route.ts +199 -0
  335. package/src/shared/domain/agents/prompts.ts +20 -0
  336. package/src/shared/domain/code-intel-contract.ts +5 -4
  337. package/src/shared/domain/code-intel-routing.ts +8 -61
  338. package/src/shared/domain/compact-outcome.ts +5 -3
  339. package/src/shared/domain/compaction-thresholds.ts +2 -1
  340. package/src/shared/domain/compaction.ts +22 -113
  341. package/src/shared/domain/config-schema.ts +94 -81
  342. package/src/shared/domain/context-prune.ts +176 -0
  343. package/src/shared/domain/decision/questions.ts +102 -0
  344. package/src/shared/domain/dev/access-cost.ts +19 -15
  345. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  346. package/src/shared/domain/dev/build-commands.ts +5 -4
  347. package/src/shared/domain/dev/call-guard.ts +29 -28
  348. package/src/shared/domain/dev/carried-text.ts +3 -5
  349. package/src/shared/domain/dev/learn-proposals.ts +5 -4
  350. package/src/shared/domain/dev/learn-state.ts +3 -2
  351. package/src/shared/domain/dev/markers.ts +107 -0
  352. package/src/shared/domain/dev/messages.ts +259 -0
  353. package/src/shared/domain/dev/phase-timing.ts +50 -0
  354. package/src/shared/domain/dev/plan-checks.ts +24 -23
  355. package/src/shared/domain/dev/plan-format.ts +14 -24
  356. package/src/shared/domain/dev/project-files.ts +1 -15
  357. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  358. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  359. package/src/shared/domain/dev/questions.ts +33 -15
  360. package/src/shared/domain/dev/repo-pack.ts +12 -9
  361. package/src/shared/domain/dev/review-answer.ts +40 -17
  362. package/src/shared/domain/dev/review-brief.ts +54 -0
  363. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  364. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  365. package/src/shared/domain/dev/spec-format.ts +13 -14
  366. package/src/shared/domain/dev/step-budget.ts +4 -2
  367. package/src/shared/domain/dev/step-rules.ts +3 -4
  368. package/src/shared/domain/dev/test-commands.ts +14 -10
  369. package/src/shared/domain/dev/tool-guards.ts +4 -3
  370. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  371. package/src/shared/domain/dev/verdict-format.ts +14 -21
  372. package/src/shared/domain/dev/whitespace.ts +3 -2
  373. package/src/shared/domain/dev/work-folder.ts +4 -3
  374. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  375. package/src/shared/domain/error-text.ts +13 -0
  376. package/src/shared/domain/git/close.ts +5 -4
  377. package/src/shared/domain/git/messages.ts +20 -0
  378. package/src/shared/domain/git/pull-request.ts +5 -5
  379. package/src/shared/domain/host-layout.ts +147 -0
  380. package/src/shared/domain/host-paths.ts +399 -0
  381. package/src/shared/domain/llm-failure.ts +35 -7
  382. package/src/shared/domain/llm-profile.ts +22 -3
  383. package/src/shared/domain/marked-message.ts +1 -5
  384. package/src/shared/domain/markers.ts +30 -0
  385. package/src/shared/domain/messages.ts +291 -0
  386. package/src/shared/domain/model-catalog.ts +2 -9
  387. package/src/shared/domain/permission-modes.ts +4 -8
  388. package/src/shared/domain/prelude.ts +2 -2
  389. package/src/shared/domain/project-manifests.ts +3 -2
  390. package/src/shared/domain/prompts.ts +233 -0
  391. package/src/shared/domain/search-routing.ts +3 -11
  392. package/src/shared/domain/secret-patterns.ts +3 -2
  393. package/src/shared/domain/session-keys.ts +7 -0
  394. package/src/shared/domain/session-start.ts +3 -2
  395. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  396. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  397. package/src/shared/domain/shared-memory/entry.ts +26 -20
  398. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  399. package/src/shared/domain/shared-memory/gate.ts +4 -3
  400. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  401. package/src/shared/domain/shared-memory/layout.ts +11 -8
  402. package/src/shared/domain/shared-memory/markers.ts +9 -0
  403. package/src/shared/domain/shared-memory/messages.ts +66 -0
  404. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  405. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  406. package/src/shared/domain/shared-memory/refused.ts +3 -3
  407. package/src/shared/domain/skills/prompts.ts +4 -0
  408. package/src/shared/domain/skills/shortlist.ts +149 -0
  409. package/src/shared/domain/snip-turns.ts +2 -14
  410. package/src/shared/domain/speech.ts +2 -1
  411. package/src/shared/domain/tool-trace.ts +5 -7
  412. package/src/shared/domain/verifiers.ts +7 -11
  413. package/src/shared/domain/vfs.ts +8 -1
  414. package/src/shared/domain/workflow/prompts.ts +15 -0
  415. package/src/shared/domain/workflow/state-file.ts +14 -12
  416. package/src/shared/infrastructure/globals.ts +7 -2
  417. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  418. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  419. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  420. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  421. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  422. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  423. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  424. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  425. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  426. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  427. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  428. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  429. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  430. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  431. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  432. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  433. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  434. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  435. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  436. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  437. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  438. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  439. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  440. package/src/shared/domain/session-summary.ts +0 -13
@@ -5,6 +5,8 @@
5
5
  import type { CodeIndex } from "../ports.ts";
6
6
  import { WORKSPACE } from "../../domain/vfs.ts";
7
7
  import { indexCacheNote } from "../../domain/code-intel-contract.ts";
8
+ import { indexUnavailable, inventoryLine, searchFailed } from "./messages.ts";
9
+ import { INDEX_FOUND_NOTHING } from "./prompts.ts";
8
10
 
9
11
  export interface BriefInventoryEntry { path: string; line: number; name: string }
10
12
  export interface BriefInventory {
@@ -67,7 +69,7 @@ export async function briefInventory(index: CodeIndex, request: BriefInventoryRe
67
69
  if (note !== "") out.cache = note;
68
70
  }
69
71
  } catch (e) {
70
- out.warnings.push(`the code index is not available (${firstLine(e)}): the draft has no inventory`);
72
+ out.warnings.push(indexUnavailable(firstLine(e)));
71
73
  return out;
72
74
  }
73
75
  const excluded = excludedBy(request.excluded);
@@ -79,7 +81,7 @@ export async function briefInventory(index: CodeIndex, request: BriefInventoryRe
79
81
  out.calls++;
80
82
  hits = await index.search(phrase, BRIEF_INVENTORY_CAPS.topK);
81
83
  } catch (e) {
82
- out.warnings.push(`search failed for '${phrase}': ${firstLine(e)}`);
84
+ out.warnings.push(searchFailed(phrase, firstLine(e)));
83
85
  continue;
84
86
  }
85
87
  for (const hit of hits) {
@@ -104,10 +106,10 @@ export async function briefInventory(index: CodeIndex, request: BriefInventoryRe
104
106
  /** The inventory's line of a draft's end message: its entries, its index calls, what the index cache did. */
105
107
  export function briefInventoryLine(inventory: BriefInventory): string {
106
108
  const cache = inventory.cache === undefined ? "" : `; ${inventory.cache}`;
107
- return `inventory: ${inventory.entries.length} entries (${inventory.calls} index calls${cache})`;
109
+ return inventoryLine(inventory.entries.length, inventory.calls, cache);
108
110
  }
109
111
 
110
112
  export function renderBriefInventory(inventory: BriefInventory): string {
111
- if (inventory.entries.length === 0) return "(the index found nothing for this request)";
113
+ if (inventory.entries.length === 0) return INDEX_FOUND_NOTHING;
112
114
  return inventory.entries.map((e) => `- ${e.path}${e.line > 0 ? `:${e.line}` : ""} — ${e.name}`).join("\n");
113
115
  }
@@ -19,6 +19,8 @@ import {
19
19
  commitFiles, defaultBranch, gitReason, handOverPullRequest, pushBranch, readIdentity, runGit,
20
20
  } from "../git/commit-files.ts";
21
21
  import { WORKSPACE } from "../../domain/vfs.ts";
22
+ import { NOTHING_TO_COMMIT_LINE, gitStatusFailedLine, leftOutWorkFolder, noChangeToCommit, notCommittedUnsafe, pushDeniedByRule } from "./messages.ts";
23
+ import { pushedToOrigin } from "../git/messages.ts";
22
24
 
23
25
  export interface CloseBatchRequest {
24
26
  /** The files the batch touched, from its sheet and its roles' diffs. */
@@ -50,15 +52,15 @@ export async function closeBatch(
50
52
  if (!identity.ok) return { committed: false, lines: [identityStop(identity.detail, req.rerun)] };
51
53
 
52
54
  const status = await runGit(deps.shell, GIT_STATUS_COMMAND);
53
- if (status.exitCode !== 0) return { committed: false, lines: [`✗ git status failed: ${gitReason(status)}`] };
55
+ if (status.exitCode !== 0) return { committed: false, lines: [gitStatusFailedLine(gitReason(status))] };
54
56
  const selection = selectCommitFiles({ status: status.stdout, workFolder: req.work.folder, named: req.touched });
55
57
  const notes: string[] = [];
56
- if (selection.inWorkFolder.length > 0) notes.push(`left out (the work folder is never committed): ${selection.inWorkFolder.join(", ")}`);
57
- if (selection.unchanged.length > 0) notes.push(`no change to commit: ${selection.unchanged.join(", ")}`);
58
+ if (selection.inWorkFolder.length > 0) notes.push(leftOutWorkFolder(selection.inWorkFolder.join(", ")));
59
+ if (selection.unchanged.length > 0) notes.push(noChangeToCommit(selection.unchanged.join(", ")));
58
60
  if (selection.unsafe.length > 0) {
59
- return { committed: false, lines: [...notes, `✗ not committed: ${selection.unsafe.join(", ")} cannot go through the shell; commit by hand`] };
61
+ return { committed: false, lines: [...notes, notCommittedUnsafe(selection.unsafe.join(", "))] };
60
62
  }
61
- if (selection.files.length === 0) return { committed: false, lines: [...notes, "✗ nothing to commit"] };
63
+ if (selection.files.length === 0) return { committed: false, lines: [...notes, NOTHING_TO_COMMIT_LINE] };
62
64
 
63
65
  const commit = await commitFiles(deps, { files: selection.files, status: status.stdout, message: req.message });
64
66
  if (!commit.ok) return { committed: false, lines: [...notes, `✗ ${commit.line}`] };
@@ -67,12 +69,12 @@ export async function closeBatch(
67
69
  if (!req.push) return { committed: true, hash: commit.hash, lines };
68
70
  const pushCommand = gitPushCommand(req.branch);
69
71
  if (req.rules !== undefined && ruleDecision(req.rules, "shell_command", { command: pushCommand, working_directory: WORKSPACE }) === "deny") {
70
- lines.push(`✗ not pushed: a session rule denies '${pushCommand}'; the commit stays local`);
72
+ lines.push(pushDeniedByRule(pushCommand));
71
73
  return { committed: true, hash: commit.hash, lines };
72
74
  }
73
75
 
74
76
  const pushed = await pushBranch(deps.shell, req.branch);
75
- lines.push(pushed.ok ? `✓ pushed ${req.branch} to origin` : `✗ ${pushed.line}`);
77
+ lines.push(pushed.ok ? pushedToOrigin(req.branch) : `✗ ${pushed.line}`);
76
78
  const base = await defaultBranch(deps.shell);
77
79
  if (base !== null && base === req.branch) return { committed: true, hash: commit.hash, lines };
78
80
  lines.push(...await handOverPullRequest(deps, {
@@ -7,6 +7,7 @@ import { parseRepoPack } from "../../domain/dev/repo-pack.ts";
7
7
  import type { RepoPack, RepoPackIssue } from "../../domain/dev/repo-pack.ts";
8
8
  import { formatYamlError } from "../../domain/dev/yaml-subset.ts";
9
9
  import { WORKSPACE, workspaceRelative } from "../../domain/vfs.ts";
10
+ import { packIgnored, packUnreadable, severalPacks } from "./messages.ts";
10
11
 
11
12
  export const ORKEON_PACK_PATH = `${WORKSPACE}/.orkeon/repo.yaml`;
12
13
  export const HARNESS_PACKS_DIR = `${WORKSPACE}/.claude/harness/packs`;
@@ -40,12 +41,12 @@ function decide(path: string, origin: FoundPack["origin"], a: Exclude<Attempt, {
40
41
  const shown = shownOf(path);
41
42
  if (a.kind === "failed") {
42
43
  const first = messageOf(a.error).split("\n")[0];
43
- warnings.push(`${shown} cannot be read (${first}): no repository pack is used`);
44
+ warnings.push(packUnreadable(shown, first));
44
45
  return { found: null, warnings };
45
46
  }
46
47
  const parsed = parseRepoPack(a.text);
47
48
  if (!parsed.ok) {
48
- warnings.push(`${formatYamlError(shown, parsed.error)}: the repository pack is ignored`);
49
+ warnings.push(packIgnored(formatYamlError(shown, parsed.error)));
49
50
  return { found: null, warnings };
50
51
  }
51
52
  for (const issue of parsed.issues) warnings.push(`${shown}: ${issue.key}: ${issue.message}`);
@@ -69,7 +70,7 @@ export async function findRepoPack(files: Pick<Files, "read" | "list">): Promise
69
70
  const a = await attempt(files, path);
70
71
  if (a.kind === "absent") continue;
71
72
  if (packs.length > 1) {
72
- warnings.push(`several repository packs are deployed (${packs.join(", ")}): ${shownOf(path)} is read`);
73
+ warnings.push(severalPacks(packs.join(", "), shownOf(path)));
73
74
  }
74
75
  return decide(path, "harness", a, warnings);
75
76
  }
@@ -13,6 +13,8 @@ import type { LearnState } from "../../domain/dev/learn-state.ts";
13
13
  import { appendRefused, parseRefused, projectFromRemote, topicOf } from "../../domain/shared-memory/refused.ts";
14
14
  import { readRefusedFile } from "../shared-memory/memory-settings.ts";
15
15
  import { WORKSPACE } from "../../domain/vfs.ts";
16
+ import { alreadyDecided, alreadyRefused, axisDone, cannotBeListed, learnBlockedNotWritten, learnNoWorkFolder, learnOutsideMounts, learnStateInvalid, learnStateLine, learnStateUnreadable, noProposalInNewestFolders, refuseByWords, refusedLeftOut, refusedUnreadable } from "./messages.ts";
17
+ import { cannotBeRead } from "../messages.ts";
16
18
 
17
19
  export type DevLearnDecisionArgs = { kind: "accept"; ids: string[] } | { kind: "refuse"; target: string };
18
20
  export type DevLearnDecisionDeps = DevContextDeps & { files: Pick<Files, "read" | "list" | "write">; clock: () => Date };
@@ -68,7 +70,7 @@ export async function readProposals(files: Pick<Files, "read" | "list">, work: W
68
70
  try {
69
71
  names = await files.list(vfsPath, LEARN_LIST_CAP);
70
72
  } catch (e) {
71
- lookup.warnings.push(`${work.folder}/ cannot be listed (${firstLineOf(e)})`);
73
+ lookup.warnings.push(cannotBeListed(work.folder, firstLineOf(e)));
72
74
  return lookup;
73
75
  }
74
76
  const folders = names.filter((n) => LEARN_FOLDER_PATTERN.test(n)).sort().reverse().slice(0, PROPOSALS_LOOKED_UP);
@@ -78,11 +80,11 @@ export async function readProposals(files: Pick<Files, "read" | "list">, work: W
78
80
  try {
79
81
  text = await files.read(`${vfsPath}/${folder}/${PROPOSALS_JSON}`);
80
82
  } catch (e) {
81
- lookup.warnings.push(`${shown} cannot be read (${firstLineOf(e)})`);
83
+ lookup.warnings.push(cannotBeRead(shown, firstLineOf(e)));
82
84
  continue;
83
85
  }
84
86
  const parsed = parseProposalsFile(text);
85
- if (!parsed.ok) lookup.warnings.push(`${shown} cannot be read (${parsed.problem})`);
87
+ if (!parsed.ok) lookup.warnings.push(cannotBeRead(shown, parsed.problem));
86
88
  else lookup.files.push({ folder, file: parsed.file });
87
89
  }
88
90
  return lookup;
@@ -104,7 +106,7 @@ function completeAxes(state: LearnState, touched: ReadonlyMap<string, AxisPropos
104
106
  for (const axis of touched.values()) {
105
107
  if (axis.motifs.length === 0 || !axis.motifs.every((m) => decisionOf(next, m.id) !== undefined)) continue;
106
108
  next = { ...next, treated: [...new Set([...next.treated, ...axis.shownRows])].sort() };
107
- lines.push(`axis ${axis.axis} done: ${axis.shownRows.length} gaps marked treated`);
109
+ lines.push(axisDone(axis.axis, axis.shownRows.length));
108
110
  }
109
111
  return next;
110
112
  }
@@ -116,10 +118,10 @@ async function loadLearnState(files: Pick<Files, "read">): Promise<StateLoad> {
116
118
  try {
117
119
  text = await readOrNull(files, `${WORKSPACE}/${LEARN_STATE_FILE}`);
118
120
  } catch (e) {
119
- return { ok: false, text: `dev-learn: ${LEARN_STATE_FILE} cannot be read (${firstLineOf(e)}): fix or delete it; nothing was written` };
121
+ return { ok: false, text: learnStateUnreadable(LEARN_STATE_FILE, firstLineOf(e)) };
120
122
  }
121
123
  const read = parseLearnState(text);
122
- return read.ok ? { ok: true, state: read.state } : { ok: false, text: `dev-learn: ${read.problem}: fix or delete it; nothing was written` };
124
+ return read.ok ? { ok: true, state: read.state } : { ok: false, text: learnStateInvalid(read.problem) };
123
125
  }
124
126
 
125
127
  /** Writes the state; the BLOCKED text when the write throws, null when it went through. */
@@ -128,13 +130,13 @@ async function saveLearnState(files: Pick<Files, "write">, state: LearnState): P
128
130
  await files.write(`${WORKSPACE}/${LEARN_STATE_FILE}`, serializeLearnState(state));
129
131
  return null;
130
132
  } catch (e) {
131
- return `dev-learn: BLOCKED — ${LEARN_STATE_FILE} cannot be written (${firstLineOf(e)})`;
133
+ return learnBlockedNotWritten(LEARN_STATE_FILE, firstLineOf(e));
132
134
  }
133
135
  }
134
136
 
135
137
  const notFoundText = (work: WorkFolder, id: string): string =>
136
- `dev-learn: no proposal ${id} in the 10 newest ${work.folder}/learn-*/ folders`;
137
- const stateLine = (state: LearnState): string => `state: ${LEARN_STATE_FILE} — ${state.treated.length} gaps treated in all`;
138
+ noProposalInNewestFolders(id, work.folder);
139
+ const stateLine = (state: LearnState): string => learnStateLine(LEARN_STATE_FILE, state.treated.length);
138
140
 
139
141
  async function acceptMotifs(ids: readonly string[], lookup: ProposalsLookup, work: WorkFolder, deps: DevLearnDecisionDeps): Promise<string[]> {
140
142
  const load = await loadLearnState(deps.files);
@@ -149,7 +151,7 @@ async function acceptMotifs(ids: readonly string[], lookup: ProposalsLookup, wor
149
151
  if (found === null) {
150
152
  lines.push(notFoundText(work, id));
151
153
  } else if (earlier !== undefined) {
152
- lines.push(`${id} was already ${earlier.decision} on ${earlier.date}`);
154
+ lines.push(alreadyDecided(id, earlier.decision, earlier.date));
153
155
  } else {
154
156
  const { motif, axis } = found;
155
157
  lines.push(...acceptLines(motif));
@@ -183,17 +185,17 @@ async function recordRefusal(topic: string, motifText: string, date: string, dep
183
185
  try {
184
186
  previous = await readOrNull(deps.files, path);
185
187
  } catch (e) {
186
- return { ok: false, line: `dev-learn: ${refusedFile} cannot be read (${firstLineOf(e)}): nothing was written` };
188
+ return { ok: false, line: refusedUnreadable(refusedFile, firstLineOf(e)) };
187
189
  }
188
190
  const already = previous === null ? undefined : parseRefused(previous).motifs.find((m) => m.topic === topic);
189
- if (already !== undefined) return { ok: true, line: `${topic} was already refused on ${already.date}` };
191
+ if (already !== undefined) return { ok: true, line: alreadyRefused(topic, already.date) };
190
192
  const project = await projectName(deps.shell);
191
193
  try {
192
194
  await deps.files.write(path, appendRefused(previous, { topic, project, date, motif: motifText }));
193
195
  } catch (e) {
194
- return { ok: false, line: `dev-learn: BLOCKED — ${refusedFile} cannot be written (${firstLineOf(e)})` };
196
+ return { ok: false, line: learnBlockedNotWritten(refusedFile, firstLineOf(e)) };
195
197
  }
196
- return { ok: true, line: `refused: ${topic} — left out of future proposals (${refusedFile})` };
198
+ return { ok: true, line: refusedLeftOut(topic, refusedFile) };
197
199
  }
198
200
 
199
201
  async function refuseMotif(target: string, lookup: ProposalsLookup, work: WorkFolder, deps: DevLearnDecisionDeps): Promise<string[]> {
@@ -202,11 +204,11 @@ async function refuseMotif(target: string, lookup: ProposalsLookup, work: WorkFo
202
204
  return [(await recordRefusal(topicOf(target), target, date, deps)).line];
203
205
  }
204
206
  const found = findMotif(lookup, target);
205
- if (found === null) return [`${notFoundText(work, target)} (to refuse a motif by its words, write more than an id)`];
207
+ if (found === null) return [refuseByWords(notFoundText(work, target))];
206
208
  const load = await loadLearnState(deps.files);
207
209
  if (!load.ok) return [load.text];
208
210
  const earlier = decisionOf(load.state, target);
209
- if (earlier !== undefined) return [`${target} was already ${earlier.decision} on ${earlier.date}`];
211
+ if (earlier !== undefined) return [alreadyDecided(target, earlier.decision, earlier.date)];
210
212
  const { motif, axis } = found;
211
213
  const refusal = await recordRefusal(motif.topic, motif.title, date, deps);
212
214
  if (!refusal.ok) return [refusal.line];
@@ -225,9 +227,9 @@ export async function runDevLearnDecision(
225
227
  const ctx = await loadDevContext(deps);
226
228
  const work = ctx.work;
227
229
  if (work.vfsPath === null) {
228
- return `dev-learn: the work folder ${work.folder} is in the main worktree, outside the mounts: run /dev-learn from the main checkout`;
230
+ return learnOutsideMounts(work.folder);
229
231
  }
230
- if (!work.exists) return `dev-learn: no work folder ${work.folder}/: nothing to learn from`;
232
+ if (!work.exists) return learnNoWorkFolder(work.folder);
231
233
  const lookup = await readProposals(deps.files, work, work.vfsPath);
232
234
  const lines = args.kind === "accept"
233
235
  ? await acceptMotifs(args.ids, lookup, work, deps)
@@ -18,6 +18,8 @@ import type { VerdictFile } from "../../domain/dev/verdict-format.ts";
18
18
  import { parseBatchesState } from "../../domain/dev/batches-state.ts";
19
19
  import type { BatchesState } from "../../domain/dev/batches-state.ts";
20
20
  import { WORKSPACE } from "../../domain/vfs.ts";
21
+ import { TODO_HOLDS_HARNESS_WORK, notIgnoredByGit, severalPlans, workDirUnreadable } from "./messages.ts";
22
+ import { cannotBeRead } from "../messages.ts";
21
23
 
22
24
  export interface DevContextDeps {
23
25
  files: Pick<Files, "read" | "list">; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">;
@@ -49,7 +51,7 @@ async function readWorkDirSetting(config: Pick<ConfigStore, "readValue">, warnin
49
51
  try {
50
52
  return (await config.readValue(DEV_WORK_DIR_CONFIG_KEY)).value;
51
53
  } catch (e) {
52
- warnings.push(`${DEV_WORK_DIR_CONFIG_KEY} could not be read (${firstLine(e)}): the pack or the default decides`);
54
+ warnings.push(workDirUnreadable(DEV_WORK_DIR_CONFIG_KEY, firstLine(e)));
53
55
  return undefined;
54
56
  }
55
57
  }
@@ -68,7 +70,7 @@ async function checkIgnored(shell: Pick<Shell, "run">, work: WorkFolder, warning
68
70
  if (result.exitCode !== 0 && result.exitCode !== 1) return;
69
71
  const ignored = new Set(result.stdout.split(/\r?\n/).map((l) => l.trim()).filter((l) => l !== ""));
70
72
  for (const path of paths) {
71
- if (!ignored.has(path)) warnings.push(`${path} is not ignored by git: add it to .gitignore (Orkeon Code never edits it)`);
73
+ if (!ignored.has(path)) warnings.push(notIgnoredByGit(path));
72
74
  }
73
75
  }
74
76
 
@@ -119,10 +121,7 @@ export async function loadDevContext(deps: DevContextDeps): Promise<DevContext>
119
121
  if (request === null) {
120
122
  const named = (await harnessWorkDir(deps.files))?.trim().replace(/^\.\//, "").replace(/\/+$/, "");
121
123
  if (named !== DEFAULT_WORK_FOLDER && (await todoHoldsHarnessWork(deps.files))) {
122
- warnings.push(
123
- "todo/ holds harness artefacts and nothing names workbench/: set layout.work: workbench in the pack, " +
124
- "or HARNESS_WORK_DIR=workbench in .claude/settings.local.json env (W-01)",
125
- );
124
+ warnings.push(TODO_HOLDS_HARNESS_WORK);
126
125
  }
127
126
  }
128
127
  return { pack, work, warnings };
@@ -182,7 +181,7 @@ export async function loadDevCode(deps: Pick<DevContextDeps, "files">, work: Wor
182
181
  try {
183
182
  return await deps.files.read(`${folder}/${name}`);
184
183
  } catch (e) {
185
- warnings.push(`${shown}/${name} cannot be read (${firstLine(e)})`);
184
+ warnings.push(cannotBeRead(`${shown}/${name}`, firstLine(e)));
186
185
  return null;
187
186
  }
188
187
  };
@@ -194,7 +193,7 @@ export async function loadDevCode(deps: Pick<DevContextDeps, "files">, work: Wor
194
193
  if (plans.length > 0) {
195
194
  const chosen = plans.find((p) => p.prefix.toUpperCase() === code.toUpperCase()) ?? plans[0];
196
195
  if (plans.length > 1) {
197
- warnings.push(`several plans in ${shown}/: ${plans.map((p) => p.name).join(", ")}: ${chosen.name} is read`);
196
+ warnings.push(severalPlans(shown, plans.map((p) => p.name).join(", "), chosen.name));
198
197
  }
199
198
  const text = await read(chosen.name);
200
199
  if (text !== null) {
@@ -7,6 +7,7 @@ import type { AccessCost } from "../../domain/dev/access-cost.ts";
7
7
  import { COST_NOT_WIRED, isTestFile, isTestRoot, measuredCost, notComputed, notIndexed, nothingChanged, receiversArgument, underRoots } from "../../domain/dev/access-cost.ts";
8
8
  import type { RepoPack } from "../../domain/dev/repo-pack.ts";
9
9
  import { WORKSPACE } from "../../domain/vfs.ts";
10
+ import { NO_READABLE_REPORT, accessCostErrorJudgeFromDiff, reindexErrorJudgeFromDiff, toolFailedJudgeFromDiff } from "./prompts.ts";
10
11
 
11
12
  const firstLine = (text: string): string => (text.split("\n")[0] ?? "").trim();
12
13
 
@@ -19,7 +20,7 @@ export function costRoots(pack: RepoPack | null): string[] {
19
20
  }
20
21
 
21
22
  function failed(tool: string, error: unknown): AccessCost {
22
- return notComputed(`${tool} failed (${firstLine(error instanceof Error ? error.message : String(error))}); judge the Cost axis from the diff`);
23
+ return notComputed(toolFailedJudgeFromDiff(tool, firstLine(error instanceof Error ? error.message : String(error))));
23
24
  }
24
25
 
25
26
  function normalRoot(root: string): string {
@@ -49,7 +50,7 @@ export async function measureAccessCost(
49
50
 
50
51
  try {
51
52
  const errors = await index.refresh(WORKSPACE, files);
52
- if (errors.length > 0) return notComputed(`incremental_reindex: ${firstLine(errors[0])}; judge the Cost axis from the diff`);
53
+ if (errors.length > 0) return notComputed(reindexErrorJudgeFromDiff(firstLine(errors[0])));
53
54
  } catch (error) {
54
55
  return failed("incremental_reindex", error);
55
56
  }
@@ -60,8 +61,8 @@ export async function measureAccessCost(
60
61
  } catch (error) {
61
62
  return failed("access_cost", error);
62
63
  }
63
- if (answer.errors.length > 0) return notComputed(`access_cost: ${firstLine(answer.errors[0])}; judge the Cost axis from the diff`);
64
- if (answer.report === null) return notComputed("access_cost returned no readable report; judge the Cost axis from the diff");
64
+ if (answer.errors.length > 0) return notComputed(accessCostErrorJudgeFromDiff(firstLine(answer.errors[0])));
65
+ if (answer.report === null) return notComputed(NO_READABLE_REPORT);
65
66
 
66
67
  const added = new Map(changed.map((f) => [`${WORKSPACE}/${f.path}`, f.added] as const));
67
68
  return measuredCost(answer.report, added);
@@ -0,0 +1,132 @@
1
+ // The text the dev services show the user: refusals of a step, warnings, preflight and close lines, the decisions of
2
+ // /dev-learn.
3
+
4
+ // brief-inventory.ts
5
+ export const indexUnavailable = (reason: string): string => `the code index is not available (${reason}): the draft has no inventory`;
6
+ export const searchFailed = (phrase: string, reason: string): string => `search failed for '${phrase}': ${reason}`;
7
+ export const inventoryLine = (entries: number, calls: number, cache: string): string =>
8
+ `inventory: ${entries} entries (${calls} index calls${cache})`;
9
+
10
+ // close-batch.ts
11
+ export const gitStatusFailedLine = (reason: string): string => `✗ git status failed: ${reason}`;
12
+ export const leftOutWorkFolder = (paths: string): string => `left out (the work folder is never committed): ${paths}`;
13
+ export const noChangeToCommit = (paths: string): string => `no change to commit: ${paths}`;
14
+ export const notCommittedUnsafe = (paths: string): string => `✗ not committed: ${paths} cannot go through the shell; commit by hand`;
15
+ export const NOTHING_TO_COMMIT_LINE = "✗ nothing to commit";
16
+ export const pushDeniedByRule = (command: string): string => `✗ not pushed: a session rule denies '${command}'; the commit stays local`;
17
+
18
+ // find-repo-pack.ts
19
+ export const packUnreadable = (path: string, reason: string): string => `${path} cannot be read (${reason}): no repository pack is used`;
20
+ export const packIgnored = (error: string): string => `${error}: the repository pack is ignored`;
21
+ export const severalPacks = (packs: string, path: string): string => `several repository packs are deployed (${packs}): ${path} is read`;
22
+
23
+ // learn-decision.ts
24
+ export const cannotBeListed = (folder: string, reason: string): string => `${folder}/ cannot be listed (${reason})`;
25
+ export const axisDone = (axis: string, count: number): string => `axis ${axis} done: ${count} gaps marked treated`;
26
+ export const learnStateUnreadable = (file: string, reason: string): string =>
27
+ `dev-learn: ${file} cannot be read (${reason}): fix or delete it; nothing was written`;
28
+ export const learnStateInvalid = (problem: string): string => `dev-learn: ${problem}: fix or delete it; nothing was written`;
29
+ export const learnBlockedNotWritten = (file: string, reason: string): string => `dev-learn: BLOCKED — ${file} cannot be written (${reason})`;
30
+ export const noProposalInNewestFolders = (id: string, folder: string): string => `dev-learn: no proposal ${id} in the 10 newest ${folder}/learn-*/ folders`;
31
+ export const learnStateLine = (file: string, treated: number): string => `state: ${file} — ${treated} gaps treated in all`;
32
+ export const alreadyDecided = (id: string, decision: string, date: string): string => `${id} was already ${decision} on ${date}`;
33
+ export const refusedUnreadable = (file: string, reason: string): string => `dev-learn: ${file} cannot be read (${reason}): nothing was written`;
34
+ export const alreadyRefused = (topic: string, date: string): string => `${topic} was already refused on ${date}`;
35
+ export const refusedLeftOut = (topic: string, file: string): string => `refused: ${topic} — left out of future proposals (${file})`;
36
+ export const refuseByWords = (notFound: string): string => `${notFound} (to refuse a motif by its words, write more than an id)`;
37
+ export const learnOutsideMounts = (folder: string): string =>
38
+ `dev-learn: the work folder ${folder} is in the main worktree, outside the mounts: run /dev-learn from the main checkout`;
39
+ export const learnNoWorkFolder = (folder: string): string => `dev-learn: no work folder ${folder}/: nothing to learn from`;
40
+
41
+ // load-dev-context.ts
42
+ export const workDirUnreadable = (key: string, reason: string): string =>
43
+ `${key} could not be read (${reason}): the pack or the default decides`;
44
+ export const notIgnoredByGit = (path: string): string => `${path} is not ignored by git: add it to .gitignore (Orkeon Code never edits it)`;
45
+ export const TODO_HOLDS_HARNESS_WORK =
46
+ "todo/ holds harness artefacts and nothing names workbench/: set layout.work: workbench in the pack, " +
47
+ "or HARNESS_WORK_DIR=workbench in .claude/settings.local.json env (W-01)";
48
+ export const severalPlans = (shown: string, names: string, chosen: string): string => `several plans in ${shown}/: ${names}: ${chosen} is read`;
49
+
50
+ // plan-source.ts
51
+ export const bothSpecAndChange = (shown: string, code: string): string =>
52
+ `dev-plan: ${shown}/ holds both SPEC-${code}.md and CHANGE-${code}.md: name the file`;
53
+ export const neitherSpecNorChange = (shown: string, code: string): string => `dev-plan: ${shown}/ holds no SPEC-${code}.md nor CHANGE-${code}.md`;
54
+ export const notASource = (token: string): string => `dev-plan: '${token}' is neither a code nor a SPEC-<code>.md / CHANGE-<code>.md path`;
55
+ export const SOURCE_UNDER_CLAUDE = "dev-plan: a source under .claude/ is the harness's own: copy it to the work folder first";
56
+ export const planOutsideWorkspace = (folder: string, workspace: string): string =>
57
+ `dev-plan: the work folder ${folder} is outside ${workspace}: run /dev-plan from the main worktree`;
58
+ export const noSourceToPlan = (folder: string): string =>
59
+ `dev-plan: no SPEC- or CHANGE- file without a plan in ${folder}/: name one, e.g. /dev-plan <code>`;
60
+ export const severalCodes = (codes: string, first: string): string =>
61
+ `dev-plan: several codes could be planned (${codes}): name one, e.g. /dev-plan ${first}`;
62
+ export const planSourceUnreadable = (path: string, reason: string): string => `dev-plan: ${path} cannot be read (${reason})`;
63
+
64
+ // preflight.ts
65
+ export const PLAN_NONE = "plan: none in the code's folder: /dev-plan first";
66
+ export const noSheetFor = (batches: string): string => `sheets: no sheet for ${batches}`;
67
+ export const SHEETS_OK = "preflight ✓ sheets: one for every batch not done";
68
+ export const identityMissing = (detail: string): string =>
69
+ `git identity: ${detail} (each batch's close commits): git config user.name and user.email in the repository ` +
70
+ "(a confined shell reads no --global file)";
71
+ export const identityOk = (name: string, email: string): string => `preflight ✓ git identity: ${name} <${email}>`;
72
+ export const BRANCH_NONE = "branch: none checked out (a detached HEAD?): check out the work branch";
73
+ export const changesOutsideWorkFolder = (count: number, paths: string): string =>
74
+ `preflight ⚠ tree: ${count} change(s) outside the work folder (${paths}): a close commits only its batch's files`;
75
+
76
+ // question-round.ts, settle-questions.ts
77
+ export const REWRITE_REFUSED = "the rewrite was refused";
78
+ export const decisionsNotFolded = (problem: string): string =>
79
+ `the body does not say the decisions yet (${problem}); ` +
80
+ "they are recorded under Decisions";
81
+ export const EMPTY_ANSWER_LEAVES_OPEN = "\n(an empty answer leaves the questions in the file)";
82
+
83
+ // resolve-work-folder.ts
84
+ export const notARelativeFolderFallback = (source: string, value: string, reason: string, fallback: string): string =>
85
+ `${source} '${value}' is not a relative folder of the checkout (${reason}): ${fallback}/ applies`;
86
+ export const absentFromCheckout = (source: string, value: string, fallback: string): string =>
87
+ `${source} '${value}' is absent from the checkout: ${fallback}/ applies`;
88
+ export const linkedWorktreeNote = (folder: string): string =>
89
+ `this checkout is a linked worktree: the work folder is the main worktree's ${folder}`;
90
+
91
+ // source-review.ts
92
+ export const reviewNotRun = (reason: string): string => `review: not run (${reason})`;
93
+ export const addedAsOpenQuestions = (count: number): string => `, ${count} added as open questions`;
94
+ export const reviewCounts = (verdict: string, blocking: number, major: number, kept: string): string =>
95
+ `review: ${verdict} — ${blocking} Blocking, ${major} Major${kept}`;
96
+
97
+ // source-step.ts
98
+ export const invalidCode = (step: string): string => `${step}: invalid crew input: code`;
99
+ export const invalidInput = (step: string, name: string): string => `${step}: invalid crew input: ${name}`;
100
+ export const NO_WORK_TREE = "no work tree";
101
+ export const runFromCheckout = (step: string, workspace: string, top: string): string =>
102
+ `${step}: run from the checkout at ${workspace} (git reports ${top})`;
103
+ export const workFolderOutsideCheckoutMounts = (step: string, folder: string): string =>
104
+ `${step}: the work folder ${folder} is outside the checkout's mounts: run from the main worktree`;
105
+ export const outsideCheckout = (step: string, request: string, workspace: string): string =>
106
+ `${step}: ${request} is outside the checkout: give a path under ${workspace}`;
107
+ export const titleDoesNotReadCode = (code: string): string => `the title does not read the code ${code}`;
108
+ export const idsReadBack = (read: string, expected: string): string => `the ids read back are ${read}, not ${expected}`;
109
+ export const openQuestionsReadBack = (read: number, written: number): string => `${read} open questions read back, ${written} written`;
110
+ export const DECISIONS_DO_NOT_READ_BACK = "the decisions do not read back";
111
+
112
+ // step-precedents.ts, tool-call-policy.ts, tool-callbacks.ts
113
+ export const namedRecallFailed = (trigger: string, reason: string): string => `shared memory: recall ${trigger} failed, no precedents (${reason})`;
114
+ export const relativePathResolved = (step: string, tool: string): string => `${step}: ${tool}: a relative path resolved under the checkout`;
115
+ export const mountCheckRefusedPreHook = (step: string, n: number, tool: string): string =>
116
+ `${step}: the runtime's mount check refused pre-tool hook #${n} for ${tool}`;
117
+ export const preHookRefused = (step: string, n: number, tool: string): string => `${step}: pre-tool hook #${n} refused ${tool}`;
118
+ export const postHooksFailed = (step: string, count: number, tool: string): string =>
119
+ `${step}: ${count} post-tool hook(s) failed after ${tool}`;
120
+
121
+ // verdict-sources.ts
122
+ export const folderListsTooMany = (folder: string, cap: number): string =>
123
+ `${folder}/ lists ${cap} entries or more: later files are not read`;
124
+ export const workListsTooMany = (folder: string, cap: number): string =>
125
+ `${folder}/ lists ${cap} entries or more: later folders are not read`;
126
+
127
+ // wrapped-tools.ts
128
+ export const restoreNotRun = (reason: string): string => `restore not run: ${reason}`;
129
+
130
+ // Shared by the dev crews
131
+ export const neitherCodeNorPlan = (plan: string): string => `'${plan}' is neither a code nor a <CODE>-PLAN.md path`;
132
+ export const PERMISSION_GATE_OFF = "the host's permission gate is off; the reviewer was offered read tools only";
@@ -0,0 +1,54 @@
1
+ // The clock of a dev step's phases: each awaited step is timed with the Clock port and its time recorded under its
2
+ // phase (shared/domain/dev/phase-timing.ts), a step that throws included, its error rethrown. A step timed inside
3
+ // another counts for its own phase alone: the outer phase keeps the time its inner steps did not take. The line ends
4
+ // with `other`, what the run spent outside every phase.
5
+ import type { Clock, Llm } from "../ports.ts";
6
+ import { NO_TIMING, recordPhase, startPhase, timingLine, timingTotalMs } from "../../domain/dev/phase-timing.ts";
7
+ import type { PhaseTiming, RunUnit } from "../../domain/dev/phase-timing.ts";
8
+
9
+ /** The phase of what no step was timed under (the recall of precedents, the reads of the context). */
10
+ export const OTHER_PHASE = "other";
11
+
12
+ export class PhaseTimer {
13
+ private readonly clock: Clock;
14
+ private recorded: PhaseTiming = NO_TIMING;
15
+
16
+ private readonly started: number;
17
+
18
+ constructor(clock: Clock) {
19
+ this.clock = clock;
20
+ this.started = clock().getTime();
21
+ }
22
+
23
+ get timing(): PhaseTiming {
24
+ return this.recorded;
25
+ }
26
+
27
+ /** The summary's timing line ("" when no time was spent): the phases, then `other`, the time since the timer was
28
+ * made that no phase took, so that the total is the run's own. */
29
+ line(): string {
30
+ const other = this.clock().getTime() - this.started - timingTotalMs(this.recorded);
31
+ if (other <= 0) return timingLine(this.recorded);
32
+ return timingLine(recordPhase(startPhase(this.recorded, OTHER_PHASE, "attempt"), OTHER_PHASE, other, "attempt"));
33
+ }
34
+
35
+ async time<T>(phase: string, step: () => Promise<T>, unit: RunUnit = "attempt"): Promise<T> {
36
+ this.recorded = startPhase(this.recorded, phase, unit);
37
+ const inner = timingTotalMs(this.recorded);
38
+ const start = this.clock().getTime();
39
+ try {
40
+ return await step();
41
+ } finally {
42
+ const elapsed = this.clock().getTime() - start;
43
+ this.recorded = recordPhase(this.recorded, phase, elapsed - (timingTotalMs(this.recorded) - inner), unit);
44
+ }
45
+ }
46
+
47
+ /** `llm` with each extraction timed under `phase`: its act is left as it is. */
48
+ timedExtract(llm: Pick<Llm, "act" | "extract">, phase: string): Pick<Llm, "act" | "extract"> {
49
+ return {
50
+ act: (prompt, request) => llm.act(prompt, request),
51
+ extract: (prompt, schema) => this.time(phase, () => llm.extract(prompt, schema)),
52
+ };
53
+ }
54
+ }
@@ -9,6 +9,10 @@ import { classifyArtefact, isCode } from "../../domain/dev/artefacts.ts";
9
9
  import { parsePlanSource } from "../../domain/dev/spec-format.ts";
10
10
  import type { PlanSource, SourceKind } from "../../domain/dev/spec-format.ts";
11
11
  import { WORKSPACE } from "../../domain/vfs.ts";
12
+ import {
13
+ SOURCE_UNDER_CLAUDE, bothSpecAndChange, neitherSpecNorChange, noSourceToPlan, notASource, planOutsideWorkspace, planSourceUnreadable,
14
+ severalCodes,
15
+ } from "./messages.ts";
12
16
 
13
17
  export interface ResolvedSource {
14
18
  kind: SourceKind;
@@ -41,14 +45,14 @@ async function byCode(files: Pick<Files, "list">, work: WorkFolder, vfsPath: str
41
45
  const spec = names.includes(`SPEC-${code}.md`);
42
46
  const change = names.includes(`CHANGE-${code}.md`);
43
47
  const shown = `${work.folder}/${code}`;
44
- if (spec && change) return refuse(`dev-plan: ${shown}/ holds both SPEC-${code}.md and CHANGE-${code}.md: name the file`);
45
- if (!spec && !change) return refuse(`dev-plan: ${shown}/ holds no SPEC-${code}.md nor CHANGE-${code}.md`);
48
+ if (spec && change) return refuse(bothSpecAndChange(shown, code));
49
+ if (!spec && !change) return refuse(neitherSpecNorChange(shown, code));
46
50
  return resolved(spec ? "spec" : "change", code, shown, spec ? `SPEC-${code}.md` : `CHANGE-${code}.md`);
47
51
  }
48
52
 
49
53
  /** A path relative to the checkout, or under /workspace/, naming a spec or a brief. */
50
54
  function byPath(token: string): Resolution {
51
- const notSource = refuse(`dev-plan: '${token}' is neither a code nor a SPEC-<code>.md / CHANGE-<code>.md path`);
55
+ const notSource = refuse(notASource(token));
52
56
  let relative = token.replace(/^\.\//, "");
53
57
  if (relative.startsWith("/")) {
54
58
  if (!relative.startsWith(`${WORKSPACE}/`)) return notSource;
@@ -61,7 +65,7 @@ function byPath(token: string): Resolution {
61
65
  const artefact = classifyArtefact(fileName);
62
66
  if (artefact === null || (artefact.kind !== "spec" && artefact.kind !== "change") || !isCode(artefact.prefix)) return notSource;
63
67
  if (segments[0] === ".claude") {
64
- return refuse("dev-plan: a source under .claude/ is the harness's own: copy it to the work folder first");
68
+ return refuse(SOURCE_UNDER_CLAUDE);
65
69
  }
66
70
  return resolved(artefact.kind, artefact.prefix, segments.slice(0, -1).join("/"), fileName);
67
71
  }
@@ -76,7 +80,7 @@ export async function resolvePlanSource(
76
80
  files: Pick<Files, "list" | "read">, work: WorkFolder, token: string | null,
77
81
  ): Promise<{ ok: true; source: ResolvedSource } | { ok: false; text: string }> {
78
82
  if (work.vfsPath === null) {
79
- return refuse(`dev-plan: the work folder ${work.folder} is outside ${WORKSPACE}: run /dev-plan from the main worktree`);
83
+ return refuse(planOutsideWorkspace(work.folder, WORKSPACE));
80
84
  }
81
85
  if (token !== null && looksLikePath(token)) return byPath(token);
82
86
  if (token !== null) {
@@ -90,10 +94,10 @@ export async function resolvePlanSource(
90
94
  codes = [];
91
95
  }
92
96
  if (codes.length === 0) {
93
- return refuse(`dev-plan: no SPEC- or CHANGE- file without a plan in ${work.folder}/: name one, e.g. /dev-plan <code>`);
97
+ return refuse(noSourceToPlan(work.folder));
94
98
  }
95
99
  if (codes.length > 1) {
96
- return refuse(`dev-plan: several codes could be planned (${codes.join(", ")}): name one, e.g. /dev-plan ${codes[0]}`);
100
+ return refuse(severalCodes(codes.join(", "), codes[0]));
97
101
  }
98
102
  return byCode(files, work, work.vfsPath, codes[0]);
99
103
  }
@@ -106,7 +110,7 @@ export async function readPlanSource(
106
110
  try {
107
111
  text = await files.read(`${WORKSPACE}/${source.sourceShown}`, MAX_SOURCE_CHARS);
108
112
  } catch (e) {
109
- return { ok: false, text: `dev-plan: ${source.sourceShown} cannot be read (${firstLine(e)})` };
113
+ return { ok: false, text: planSourceUnreadable(source.sourceShown, firstLine(e)) };
110
114
  }
111
115
  return { ok: true, text, parsed: parsePlanSource(text, source.kind) };
112
116
  }