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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (443) hide show
  1. package/.orkeon-runtime +11 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +508 -80
  13. package/orkeon-code.ps1 +129 -11
  14. package/package.json +3 -1
  15. package/scripts/dev-run.sh +139 -0
  16. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  17. package/src/commands/_lib/args.ts +5 -4
  18. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  19. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  20. package/src/commands/_lib/dev/dev-source.ts +7 -11
  21. package/src/commands/_lib/dev/dev.ts +34 -37
  22. package/src/commands/_lib/dev/markers.ts +7 -0
  23. package/src/commands/_lib/dev/messages.ts +112 -0
  24. package/src/commands/_lib/dev-step.ts +16 -13
  25. package/src/commands/_lib/dispatch.ts +62 -39
  26. package/src/commands/_lib/git/branch.ts +9 -10
  27. package/src/commands/_lib/git/commit.ts +9 -13
  28. package/src/commands/_lib/git/diff.ts +22 -12
  29. package/src/commands/_lib/git/messages.ts +54 -0
  30. package/src/commands/_lib/git/review.ts +9 -10
  31. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  32. package/src/commands/_lib/memory/memory.ts +3 -2
  33. package/src/commands/_lib/memory/messages.ts +32 -0
  34. package/src/commands/_lib/messages.ts +48 -0
  35. package/src/commands/_lib/project/messages.ts +8 -0
  36. package/src/commands/_lib/session/export.ts +3 -2
  37. package/src/commands/_lib/session/messages.ts +87 -0
  38. package/src/commands/_lib/session/prompts.ts +4 -0
  39. package/src/commands/_lib/session/resume.ts +15 -24
  40. package/src/commands/_lib/session/tasks.ts +20 -23
  41. package/src/commands/_lib/settings/advisor.ts +11 -16
  42. package/src/commands/_lib/settings/agents.ts +18 -28
  43. package/src/commands/_lib/settings/choices.ts +8 -0
  44. package/src/commands/_lib/settings/config.ts +43 -43
  45. package/src/commands/_lib/settings/effort.ts +147 -0
  46. package/src/commands/_lib/settings/hooks.ts +12 -20
  47. package/src/commands/_lib/settings/messages.ts +408 -0
  48. package/src/commands/_lib/settings/mode.ts +33 -24
  49. package/src/commands/_lib/settings/model.ts +71 -36
  50. package/src/commands/_lib/settings/output-style.ts +39 -0
  51. package/src/commands/_lib/settings/permissions.ts +71 -93
  52. package/src/commands/_lib/settings/route.ts +63 -0
  53. package/src/commands/_lib/settings/skills.ts +53 -11
  54. package/src/commands/_lib/settings/theme.ts +42 -0
  55. package/src/commands/_lib/speech/messages.ts +58 -0
  56. package/src/commands/_lib/speech/prompts.ts +4 -0
  57. package/src/commands/_lib/speech/say.ts +9 -10
  58. package/src/commands/_lib/speech/transcribe.ts +14 -23
  59. package/src/commands/_lib/speech/voice.ts +14 -18
  60. package/src/commands/_lib/status/doctor.ts +47 -28
  61. package/src/commands/_lib/status/messages.ts +101 -0
  62. package/src/commands/_lib/status/meta.ts +5 -25
  63. package/src/commands/_lib/status/status.ts +10 -11
  64. package/src/commands/_lib/status/usage-tools.ts +2 -3
  65. package/src/commands/_lib/status/usage.ts +7 -18
  66. package/src/commands/_lib/view.ts +6 -1
  67. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  68. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  69. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  70. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  71. package/src/commands/git/commit.cmd.ts +3 -3
  72. package/src/commands/git/review.cmd.ts +3 -3
  73. package/src/commands/memory/memory.cmd.ts +2 -2
  74. package/src/commands/project/analyze.cmd.ts +3 -3
  75. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  76. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  77. package/src/commands/project/init.cmd.ts +3 -3
  78. package/src/commands/project/verify.cmd.ts +2 -2
  79. package/src/commands/session/assistant.cmd.ts +2 -2
  80. package/src/commands/session/compact.cmd.ts +1 -1
  81. package/src/commands/session/copy.cmd.ts +8 -7
  82. package/src/commands/session/rename.cmd.ts +3 -2
  83. package/src/commands/session/rewind.cmd.ts +3 -4
  84. package/src/commands/session/summary.cmd.ts +3 -3
  85. package/src/commands/session/tasks.cmd.ts +4 -2
  86. package/src/commands/settings/config.cmd.ts +4 -2
  87. package/src/commands/settings/effort.cmd.ts +10 -31
  88. package/src/commands/settings/fast.cmd.ts +2 -1
  89. package/src/commands/settings/mode.cmd.ts +3 -3
  90. package/src/commands/settings/model.cmd.ts +3 -2
  91. package/src/commands/settings/output-style.cmd.ts +9 -38
  92. package/src/commands/settings/permissions.cmd.ts +2 -2
  93. package/src/commands/settings/proactive.cmd.ts +2 -1
  94. package/src/commands/settings/route.cmd.ts +16 -0
  95. package/src/commands/settings/skills.cmd.ts +3 -3
  96. package/src/commands/settings/theme.cmd.ts +14 -0
  97. package/src/commands/speech/say.cmd.ts +2 -2
  98. package/src/commands/speech/transcribe.cmd.ts +2 -2
  99. package/src/commands/status/release-notes.cmd.ts +1 -1
  100. package/src/crews/.orkeon/orkeon.d.ts +539 -94
  101. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  102. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  103. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  104. package/src/crews/_probe-shared-memory/probe.ork.ts +8 -6
  105. package/src/crews/advisor/application/messages.ts +4 -0
  106. package/src/crews/advisor/application/prompts.ts +4 -0
  107. package/src/crews/advisor/application/run-advisor.ts +2 -1
  108. package/src/crews/advisor/crew.ork.ts +6 -5
  109. package/src/crews/advisor/domain/advice.ts +7 -23
  110. package/src/crews/advisor/domain/messages.ts +8 -0
  111. package/src/crews/advisor/domain/prompts.ts +26 -0
  112. package/src/crews/agent-run/application/messages.ts +18 -0
  113. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  114. package/src/crews/agent-run/crew.ork.ts +4 -4
  115. package/src/crews/analyze/application/messages.ts +27 -0
  116. package/src/crews/analyze/application/prompts.ts +4 -0
  117. package/src/crews/analyze/application/run-analyze.ts +16 -14
  118. package/src/crews/analyze/crew.ork.ts +5 -4
  119. package/src/crews/analyze/domain/harvest.ts +33 -65
  120. package/src/crews/analyze/domain/prompts.ts +86 -0
  121. package/src/crews/code-review/application/lens-material.ts +24 -0
  122. package/src/crews/code-review/application/messages.ts +17 -0
  123. package/src/crews/code-review/application/prompts.ts +10 -17
  124. package/src/crews/code-review/application/review.ts +4 -1
  125. package/src/crews/code-review/application/run-code-review.ts +13 -15
  126. package/src/crews/code-review/crew.ork.ts +6 -5
  127. package/src/crews/code-review/domain/lenses.ts +6 -45
  128. package/src/crews/code-review/domain/messages.ts +25 -0
  129. package/src/crews/code-review/domain/prompts.ts +58 -0
  130. package/src/crews/code-review/domain/report.ts +5 -6
  131. package/src/crews/code-review/domain/scope.ts +6 -12
  132. package/src/crews/dev-batches/application/messages.ts +127 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  134. package/src/crews/dev-batches/application/prompts.ts +10 -0
  135. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  136. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  137. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  138. package/src/crews/dev-batches/crew.ork.ts +13 -10
  139. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  140. package/src/crews/dev-batches/domain/markers.ts +5 -0
  141. package/src/crews/dev-batches/domain/messages.ts +6 -0
  142. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  143. package/src/crews/dev-change/application/change-material.ts +44 -0
  144. package/src/crews/dev-change/application/evidence.ts +25 -22
  145. package/src/crews/dev-change/application/messages.ts +81 -0
  146. package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
  147. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  148. package/src/crews/dev-change/crew.ork.ts +11 -9
  149. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  150. package/src/crews/dev-change/domain/change-render.ts +14 -16
  151. package/src/crews/dev-change/domain/markers.ts +28 -0
  152. package/src/crews/dev-change/domain/messages.ts +16 -0
  153. package/src/crews/dev-implement/application/close.ts +21 -18
  154. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  155. package/src/crews/dev-implement/application/messages.ts +161 -0
  156. package/src/crews/dev-implement/application/observe.ts +4 -2
  157. package/src/crews/dev-implement/application/prompts.ts +9 -0
  158. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  159. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  160. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  161. package/src/crews/dev-implement/crew.ork.ts +2 -1
  162. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  163. package/src/crews/dev-implement/domain/correction.ts +16 -15
  164. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  165. package/src/crews/dev-implement/domain/markers.ts +23 -0
  166. package/src/crews/dev-implement/domain/messages.ts +58 -0
  167. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  168. package/src/crews/dev-implement/domain/roles.ts +3 -7
  169. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  170. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  171. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  172. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  173. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  174. package/src/crews/dev-learn/application/messages.ts +56 -0
  175. package/src/crews/dev-learn/application/prompts.ts +96 -0
  176. package/src/crews/dev-learn/application/run-dev-learn.ts +51 -43
  177. package/src/crews/dev-learn/crew.ork.ts +5 -4
  178. package/src/crews/dev-learn/domain/learn-answer.ts +60 -37
  179. package/src/crews/dev-learn/domain/markers.ts +10 -0
  180. package/src/crews/dev-learn/domain/messages.ts +74 -0
  181. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  182. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  183. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  184. package/src/crews/dev-plan/application/inventory.ts +17 -13
  185. package/src/crews/dev-plan/application/messages.ts +88 -0
  186. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  187. package/src/crews/dev-plan/application/{plan-prompt.ts → prompts.ts} +37 -55
  188. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  189. package/src/crews/dev-plan/crew.ork.ts +12 -9
  190. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  191. package/src/crews/dev-plan/domain/markers.ts +18 -0
  192. package/src/crews/dev-plan/domain/messages.ts +118 -0
  193. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  194. package/src/crews/dev-plan/domain/plan-render.ts +33 -34
  195. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  196. package/src/crews/dev-spec/application/messages.ts +30 -0
  197. package/src/crews/dev-spec/application/{spec-prompt.ts → prompts.ts} +42 -47
  198. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  199. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  200. package/src/crews/dev-spec/crew.ork.ts +11 -9
  201. package/src/crews/dev-spec/domain/markers.ts +30 -0
  202. package/src/crews/dev-spec/domain/messages.ts +39 -0
  203. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  204. package/src/crews/dev-spec/domain/spec-render.ts +21 -21
  205. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  206. package/src/crews/dev-verify/application/audit.ts +38 -30
  207. package/src/crews/dev-verify/application/capture.ts +34 -26
  208. package/src/crews/dev-verify/application/messages.ts +119 -0
  209. package/src/crews/dev-verify/application/prompts.ts +209 -0
  210. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  211. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  212. package/src/crews/dev-verify/crew.ork.ts +7 -7
  213. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  214. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  215. package/src/crews/dev-verify/domain/commands.ts +3 -3
  216. package/src/crews/dev-verify/domain/gate.ts +21 -16
  217. package/src/crews/dev-verify/domain/markers.ts +16 -0
  218. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  219. package/src/crews/dev-verify/domain/messages.ts +92 -0
  220. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  221. package/src/crews/git-commit/application/draft.ts +38 -55
  222. package/src/crews/git-commit/application/messages.ts +17 -0
  223. package/src/crews/git-commit/application/prompts.ts +47 -0
  224. package/src/crews/git-commit/application/run-git-commit.ts +16 -13
  225. package/src/crews/git-commit/crew.ork.ts +6 -5
  226. package/src/crews/git-commit/domain/commit.ts +15 -35
  227. package/src/crews/git-commit/domain/markers.ts +4 -0
  228. package/src/crews/git-commit/domain/messages.ts +48 -0
  229. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  230. package/src/crews/init-verifiers/application/messages.ts +13 -0
  231. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  232. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  233. package/src/crews/init-verifiers/crew.ork.ts +6 -5
  234. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  235. package/src/crews/main-loop/application/messages.ts +81 -0
  236. package/src/crews/main-loop/application/prompts.ts +12 -0
  237. package/src/crews/main-loop/application/run-main-loop.ts +64 -31
  238. package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
  239. package/src/crews/main-loop/crew.ork.ts +12 -7
  240. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  241. package/src/crews/main-loop/domain/prompts.ts +336 -0
  242. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  243. package/src/crews/project-init/application/detect.ts +5 -4
  244. package/src/crews/project-init/application/messages.ts +15 -0
  245. package/src/crews/project-init/application/prompts.ts +11 -7
  246. package/src/crews/project-init/crew.ork.ts +6 -5
  247. package/src/crews/project-init/domain/existing-files.ts +6 -4
  248. package/src/crews/project-init/domain/messages.ts +13 -0
  249. package/src/crews/project-init/domain/package-map.ts +3 -3
  250. package/src/crews/project-init/domain/prompts.ts +10 -0
  251. package/src/crews/session-compact/application/prompts.ts +5 -0
  252. package/src/crews/session-compact/crew.ork.ts +6 -5
  253. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  254. package/src/crews/shared-memory-admit/crew.ork.ts +4 -3
  255. package/src/crews/speech/application/messages.ts +3 -0
  256. package/src/crews/speech/application/prompts.ts +3 -0
  257. package/src/crews/speech/application/run-speech.ts +2 -1
  258. package/src/crews/speech/crew.ork.ts +2 -1
  259. package/src/shared/application/agents/child-agent.ts +11 -7
  260. package/src/shared/application/agents/messages.ts +35 -0
  261. package/src/shared/application/agents/route-agent.ts +115 -0
  262. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  263. package/src/shared/application/compaction/compact-session.ts +19 -14
  264. package/src/shared/application/compaction/messages.ts +20 -0
  265. package/src/shared/application/compaction/prune-context.ts +94 -0
  266. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  267. package/src/shared/application/dev/brief-inventory.ts +6 -4
  268. package/src/shared/application/dev/close-batch.ts +9 -7
  269. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  270. package/src/shared/application/dev/learn-decision.ts +20 -18
  271. package/src/shared/application/dev/load-dev-context.ts +7 -8
  272. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  273. package/src/shared/application/dev/messages.ts +135 -0
  274. package/src/shared/application/dev/phase-timer.ts +54 -0
  275. package/src/shared/application/dev/plan-source.ts +12 -8
  276. package/src/shared/application/dev/preflight.ts +16 -11
  277. package/src/shared/application/dev/prompts.ts +34 -0
  278. package/src/shared/application/dev/question-round.ts +25 -17
  279. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  280. package/src/shared/application/dev/settle-questions.ts +4 -2
  281. package/src/shared/application/dev/source-review.ts +12 -8
  282. package/src/shared/application/dev/source-step.ts +12 -10
  283. package/src/shared/application/dev/spend.ts +17 -4
  284. package/src/shared/application/dev/step-precedents.ts +2 -1
  285. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  286. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  287. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  288. package/src/shared/application/dev/verdict-sources.ts +5 -3
  289. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  290. package/src/shared/application/extra-tools.ts +2 -1
  291. package/src/shared/application/git/batch-worktree.ts +22 -17
  292. package/src/shared/application/git/commit-files.ts +24 -19
  293. package/src/shared/application/git/merge-batch.ts +11 -7
  294. package/src/shared/application/git/messages.ts +75 -0
  295. package/src/shared/application/git/open-pull-request.ts +4 -3
  296. package/src/shared/application/host-context.ts +59 -0
  297. package/src/shared/application/host-layout-store.ts +45 -0
  298. package/src/shared/application/llm-profile.ts +4 -3
  299. package/src/shared/application/messages.ts +14 -0
  300. package/src/shared/application/permission-rules.ts +10 -0
  301. package/src/shared/application/ports/decision.ts +14 -0
  302. package/src/shared/application/ports/human.ts +25 -0
  303. package/src/shared/application/ports/llm.ts +32 -3
  304. package/src/shared/application/ports/memory.ts +1 -1
  305. package/src/shared/application/ports/theme.ts +11 -0
  306. package/src/shared/application/ports.ts +4 -2
  307. package/src/shared/application/session-io.ts +2 -1
  308. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  309. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  310. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  311. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  312. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  313. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  314. package/src/shared/application/shared-memory/messages.ts +63 -0
  315. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  316. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  317. package/src/shared/application/skills/messages.ts +4 -0
  318. package/src/shared/application/skills/suggest-skills.ts +102 -0
  319. package/src/shared/application/workflow/messages.ts +8 -0
  320. package/src/shared/application/workflow/workflow-state.ts +7 -6
  321. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  322. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  323. package/src/shared/domain/agent-policy/messages.ts +66 -0
  324. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  325. package/src/shared/domain/agent-policy/permission.ts +20 -18
  326. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  327. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  328. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  329. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  330. package/src/shared/domain/agent-registry.ts +6 -5
  331. package/src/shared/domain/agents/chain.ts +2 -2
  332. package/src/shared/domain/agents/charter.ts +8 -5
  333. package/src/shared/domain/agents/exclusive.ts +2 -1
  334. package/src/shared/domain/agents/instances.ts +18 -15
  335. package/src/shared/domain/agents/messages.ts +39 -0
  336. package/src/shared/domain/agents/model-route.ts +199 -0
  337. package/src/shared/domain/agents/prompts.ts +20 -0
  338. package/src/shared/domain/code-intel-contract.ts +5 -4
  339. package/src/shared/domain/code-intel-routing.ts +8 -61
  340. package/src/shared/domain/compact-outcome.ts +5 -3
  341. package/src/shared/domain/compaction-thresholds.ts +2 -1
  342. package/src/shared/domain/compaction.ts +22 -113
  343. package/src/shared/domain/config-schema.ts +94 -81
  344. package/src/shared/domain/context-prune.ts +176 -0
  345. package/src/shared/domain/decision/questions.ts +102 -0
  346. package/src/shared/domain/dev/access-cost.ts +19 -15
  347. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  348. package/src/shared/domain/dev/build-commands.ts +5 -4
  349. package/src/shared/domain/dev/call-guard.ts +29 -28
  350. package/src/shared/domain/dev/carried-text.ts +3 -5
  351. package/src/shared/domain/dev/learn-proposals.ts +51 -12
  352. package/src/shared/domain/dev/learn-state.ts +3 -2
  353. package/src/shared/domain/dev/markers.ts +127 -0
  354. package/src/shared/domain/dev/messages.ts +271 -0
  355. package/src/shared/domain/dev/phase-timing.ts +50 -0
  356. package/src/shared/domain/dev/plan-checks.ts +24 -23
  357. package/src/shared/domain/dev/plan-format.ts +15 -25
  358. package/src/shared/domain/dev/project-files.ts +1 -15
  359. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  360. package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
  361. package/src/shared/domain/dev/questions.ts +33 -15
  362. package/src/shared/domain/dev/repo-pack.ts +12 -9
  363. package/src/shared/domain/dev/review-answer.ts +40 -17
  364. package/src/shared/domain/dev/review-brief.ts +54 -0
  365. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  366. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  367. package/src/shared/domain/dev/spec-format.ts +13 -14
  368. package/src/shared/domain/dev/step-budget.ts +4 -2
  369. package/src/shared/domain/dev/step-rules.ts +3 -4
  370. package/src/shared/domain/dev/test-commands.ts +14 -10
  371. package/src/shared/domain/dev/tool-guards.ts +4 -3
  372. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  373. package/src/shared/domain/dev/verdict-format.ts +14 -21
  374. package/src/shared/domain/dev/whitespace.ts +3 -2
  375. package/src/shared/domain/dev/work-folder.ts +6 -4
  376. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  377. package/src/shared/domain/error-text.ts +13 -0
  378. package/src/shared/domain/git/close.ts +14 -11
  379. package/src/shared/domain/git/messages.ts +41 -0
  380. package/src/shared/domain/git/pull-request.ts +5 -5
  381. package/src/shared/domain/host-layout.ts +147 -0
  382. package/src/shared/domain/host-paths.ts +399 -0
  383. package/src/shared/domain/llm-failure.ts +35 -7
  384. package/src/shared/domain/llm-profile.ts +22 -3
  385. package/src/shared/domain/marked-message.ts +1 -5
  386. package/src/shared/domain/markers.ts +30 -0
  387. package/src/shared/domain/messages.ts +291 -0
  388. package/src/shared/domain/model-catalog.ts +2 -9
  389. package/src/shared/domain/permission-modes.ts +4 -8
  390. package/src/shared/domain/prelude.ts +2 -2
  391. package/src/shared/domain/project-manifests.ts +3 -2
  392. package/src/shared/domain/prompts.ts +233 -0
  393. package/src/shared/domain/search-routing.ts +3 -11
  394. package/src/shared/domain/secret-patterns.ts +3 -2
  395. package/src/shared/domain/session-keys.ts +7 -0
  396. package/src/shared/domain/session-start.ts +3 -2
  397. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  398. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  399. package/src/shared/domain/shared-memory/entry.ts +26 -20
  400. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  401. package/src/shared/domain/shared-memory/gate.ts +4 -3
  402. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  403. package/src/shared/domain/shared-memory/layout.ts +11 -8
  404. package/src/shared/domain/shared-memory/markers.ts +9 -0
  405. package/src/shared/domain/shared-memory/messages.ts +66 -0
  406. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  407. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  408. package/src/shared/domain/shared-memory/refused.ts +3 -3
  409. package/src/shared/domain/skills/prompts.ts +4 -0
  410. package/src/shared/domain/skills/shortlist.ts +149 -0
  411. package/src/shared/domain/snip-turns.ts +2 -14
  412. package/src/shared/domain/speech.ts +2 -1
  413. package/src/shared/domain/tool-trace.ts +5 -7
  414. package/src/shared/domain/verifiers.ts +7 -11
  415. package/src/shared/domain/vfs.ts +8 -1
  416. package/src/shared/domain/workflow/prompts.ts +15 -0
  417. package/src/shared/domain/workflow/state-file.ts +14 -12
  418. package/src/shared/infrastructure/globals.ts +7 -2
  419. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  420. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  421. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  422. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  423. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  424. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  425. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  426. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  427. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  428. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  429. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  430. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  431. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  432. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  433. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  434. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  435. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  436. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  437. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  438. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  439. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  440. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  441. package/src/crews/dev-learn/application/learn-prompt.ts +0 -140
  442. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  443. package/src/shared/domain/session-summary.ts +0 -13
@@ -0,0 +1,271 @@
1
+ // The messages of shared/domain/dev: the problems a parser or a check reports and the stops the user reads
2
+ // (ADR 0026).
3
+
4
+ // ── Parse problems of the dev files ─────────────────────────────────────
5
+
6
+ export const unknownBatchLine = (line: string): string => `unknown batch line '${line}'`;
7
+ export const malformedSummaryRow = (row: string): string => `malformed summary row '${row}'`;
8
+ export const malformedTddLine = (line: string): string => `malformed TDD line '${line}'`;
9
+ export const tddLineOutsideStep = (line: string): string => `TDD line outside a step '${line}'`;
10
+ export const twoTddLines = (step: number): string => `step ${step} has two TDD: lines`;
11
+ export const unknownVerdictTitle = (title: string): string => `unknown verdict title '${title}'`;
12
+ export const unknownVerdictLine = (line: string): string => `unknown verdict line '${line}'`;
13
+ export const unknownSeverity = (severity: string): string => `unknown severity '${severity}'`;
14
+ export const malformedGapRow = (row: string): string => `malformed gap row '${row}'`;
15
+ export const duplicatedId = (id: string): string => `duplicated id ${id}`;
16
+ export const idInChangeBrief = (id: string): string => `${id} in a change brief`;
17
+ export const BRIEF_TITLE_NAMES_NO_KIND = "the brief's title names no kind (bug, refactor or perf)";
18
+
19
+ // ── The Blocking stop of /dev-plan ──────────────────────────────────────
20
+
21
+ export const blockingQuestionsOpen = (shown: string, count: number): string =>
22
+ `dev-plan: ${shown} has ${count} open Blocking question(s); no plan is written.`;
23
+ export const settleThemFirst = (settle: string, code: string, change: boolean): string =>
24
+ `→ Settle them first: ${settle} ${code}${change ? " <its kind: bug, refactor or perf>" : ""}, or edit the file; then /dev-plan ${code}.`;
25
+
26
+ // ── A question as a model gives it ──────────────────────────────────────
27
+
28
+ export const severityMustBe = (k: number): string => `question ${k}: severity must be Blocking or Major`;
29
+ export const questionOneLine = (k: number, max: number): string =>
30
+ `question ${k}: one line of at most ${max} characters ending with ?, no '|'`;
31
+ export const impactOneLine = (k: number): string => `question ${k}: the impact is one line, no '|'`;
32
+ export const optionCount = (k: number, max: number): string =>
33
+ `question ${k}: no option, or 2 to ${max} options with the recommended one first`;
34
+ export const optionOneLine = (k: number, max: number): string =>
35
+ `question ${k}: an option is one line of at most ${max} characters, no ';' nor '|'`;
36
+ export const notAnOptionToList = (k: number, option: string): string => `question ${k}: '${option}' is not an option to list`;
37
+ export const twoOptionsSame = (k: number): string => `question ${k}: two options read the same`;
38
+
39
+ // ── The self-check of a plan ────────────────────────────────────────────
40
+
41
+ export const stepOneMissing = (sheet: string): string => `${sheet}: step 1 is missing: the sheet has no step`;
42
+ export const stepOutOfOrder = (sheet: string, step: number, expected: number): string =>
43
+ `${sheet}: step ${step} is numbered out of order (expected ${expected})`;
44
+ export const stepHasNoTdd = (sheet: string, step: number): string => `${sheet}: step ${step} has no TDD: line`;
45
+ export const lastStepIsNot = (sheet: string, step: number, build: string): string =>
46
+ `${sheet}: step ${step} is the last step and is not ${build}`;
47
+ export const buildStepHoldsTdd = (sheet: string, step: number, build: string): string =>
48
+ `${sheet}: step ${step} is ${build} and holds a TDD: line`;
49
+ export const anchorRowsMismatch = (sheet: string, rows: number, steps: number): string =>
50
+ `${sheet}: ## Anchors has ${rows} rows for ${steps} steps`;
51
+ export const designIdsNeither = (missing: readonly string[]): string =>
52
+ `design ids neither applied nor non-applicable: ${missing.join(", ")}`;
53
+ export const batchesDiffer = (summary: string, lines: string, sheets: string): string =>
54
+ `batches differ: summary ${summary}, plan lines ${lines}, sheets ${sheets}`;
55
+ export const dependsOnDiffers = (sheet: string, summary: string, own: string): string =>
56
+ `${sheet}: Depends on differs between the summary (${summary}) and the sheet (${own})`;
57
+ export const noTraceabilityRow = (id: string): string => `${id}: no row of ## 2. Traceability`;
58
+ export const noTestNamesIt = (id: string): string => `${id}: no test of any sheet's ## TDD sequence names it`;
59
+ export const notASourceId = (sheet: string, id: string): string => `${sheet}: ${id} is not an id of the source`;
60
+ export const noAppliedRulesRow = (sheet: string): string => `${sheet}: no Applied rules row`;
61
+ export const assumptionsNotEmpty = (sheet: string): string => `${sheet}: ## Assumptions is not empty`;
62
+ export const idOutsideBatch = (sheet: string, id: string): string =>
63
+ `${sheet}: ${id} appears in ## TDD sequence outside the batch's ids`;
64
+
65
+ // ── The call guard of a dev step: why a call is refused ────────────────
66
+
67
+ export const packGivesNo = (key: string): string => `the pack gives no ${key}: no rule on it`;
68
+ export const notRunInMode = (step: string, tool: string, mode: string): string =>
69
+ `${step}: '${tool}' is not run in mode '${mode}': the host has no permission gate, so the crew's ` +
70
+ `callback applies the mode itself`;
71
+ export const ruleSetOrigin = (id: string): string => `the rule set ${id}`;
72
+ export const rewriteRuleOrigin = (role: string): string => `the ${role}'s rewrite rule`;
73
+ export const rootsOrigin = (role: string): string => `the ${role}'s roots`;
74
+ export const refusedByRule = (step: string, rule: string, origin: string, how: string): string =>
75
+ `${step}: refused by '${rule}' of ${origin}${how}`;
76
+ export const whichPathReaches = (path: string): string => `, which '${path}' reaches`;
77
+ export const whichPathCanReach = (path: string): string => `, which '${path}' can reach`;
78
+ export const editBatchRefused = (step: string, why: string): string => `${step}: edit_batch refused: ${why}`;
79
+ export const validateNotRun = (validate: string): string => `validate '${validate}' is not run in a dev step`;
80
+ export const NO_LIST_OF_OPERATIONS = "no list of operations";
81
+ export const operationNamesNoPath = (n: number): string => `operation ${n} names no path`;
82
+ export const operationUnknownKind = (n: number, kind: string): string => `operation ${n} has the unknown kind '${kind}'`;
83
+
84
+ // ── The access cost of a batch ──────────────────────────────────────────
85
+
86
+ export const NO_CODE_INDEX_WIRED = "the crew wires no code index; judge the Cost axis from the diff";
87
+ export const CODE_INDEX_EMPTY = "the code index is empty";
88
+ export const codeIndexHolds = (roots: readonly string[], workspace: string): string =>
89
+ `the code index holds ${roots.join(", ")}, not ${workspace}`;
90
+ export const notIndexedReason = (holds: string): string =>
91
+ `not indexed — ${holds}: run /analyze, then audit the batch again; judge the Cost axis from the diff`;
92
+ export const backToDesign = (blocking: number): string => `${blocking} - back to design`;
93
+ export const costLine = (reads: string, writes: string, verdict: string): string =>
94
+ `Cost: ${reads} + ${writes} through ports outside loops; ` +
95
+ `in a loop, a lambda or a memory filter: ${verdict}`;
96
+ export const PORTS_OUTSIDE_LOOPS = "Ports outside loops";
97
+ export const PORTS_IN_A_LOOP = "Ports in a loop";
98
+ export const PORTS_IN_A_LAMBDA = "Ports in a lambda";
99
+ export const MEMORY_FILTER_ON_AWAITED = "Memory filter on an awaited result";
100
+ export const NO_MEMBER_INDEXED = "no member of the changed files in the code index";
101
+ export const noneAwaitsAPort = (members: string): string => `${members}, none awaits a port or filters in memory`;
102
+ export const noChangedFile = (where: string): string => `no changed file${where}\n`;
103
+ export const costNotComputed = (reason: string): string => `Cost: not computed — ${reason}`;
104
+ export const cutAtLines = (lines: number): string => `[cut at ${lines} lines]`;
105
+
106
+ // ── The answer of a dev reviewer ────────────────────────────────────────
107
+
108
+ export const QUESTION_EMPTY = "it is empty";
109
+ export const questionLongerThan = (max: number): string => `it is longer than ${max} characters`;
110
+ export const QUESTION_NO_MARK = "it does not end with ?";
111
+ export const rowSeverityMustBe = (k: number): string => `row ${k}: severity must be Blocking or Major`;
112
+ export const rowOneClosedQuestion = (k: number, fault: string): string =>
113
+ `row ${k}: the question must be one closed question ending with ? (${fault})`;
114
+ export const rowEvidenceEmpty = (k: number): string => `row ${k}: evidence is empty`;
115
+ export const rowEvidenceCitesNothing = (k: number): string => `row ${k}: evidence cites no path:line, § section or heading`;
116
+ /** What follows the evidence of a row kept although it cites nothing. */
117
+ export const NO_CITATION = "(no citation)";
118
+ export const rowTargetNotOneOf = (k: number, named: string, targets: string): string =>
119
+ `row ${k}: target '${named}' is not one of ${targets}`;
120
+ export const rowTwoTargets = (k: number, named: string): string => `row ${k}: target '${named}' names two targets`;
121
+ export const ANSWER_NOT_AN_OBJECT = "the answer is not an object";
122
+ export const VERDICT_CLEAR_OR_GAPS = "verdict must be CLEAR or GAPS";
123
+ export const ROWS_MUST_BE_A_LIST = "rows must be a list";
124
+ export const atMostRows = (max: number, count: number): string => `at most ${max} rows, not ${count}`;
125
+ export const rowRepeats = (k: number, first: number): string => `row ${k}: repeats row ${first}`;
126
+
127
+ // ── The YAML subset of the repository pack ──────────────────────────────
128
+
129
+ export const YAML_PROBLEMS = {
130
+ tab: "a tab in the indentation",
131
+ tabInLine: "a tab outside quotes and comments",
132
+ marker: "a document marker is not supported",
133
+ anchor: "anchors, aliases and tags are not supported",
134
+ flowMap: "a flow mapping is not supported",
135
+ flowOpen: "a flow sequence must close on its line",
136
+ flowNested: "a nested flow sequence is not supported",
137
+ flowAfter: "text after a closing bracket",
138
+ flowEmpty: "an empty item in a flow sequence",
139
+ moreIndented: "a more-indented line inside a folded block is not supported",
140
+ quoteOpen: "a quoted scalar must close on its line",
141
+ quoteAfter: "text after a closing quote",
142
+ colon: "': ' inside a plain value: quote it",
143
+ key: "a mapping key must be a plain name",
144
+ indent: "bad indentation (a value continued on the next line is not supported)",
145
+ itemForKey: "a sequence item where a mapping key was expected",
146
+ keyForItem: "a mapping key where a sequence item was expected",
147
+ nestedItem: "a nested sequence item on one line is not supported",
148
+ } as const;
149
+ export const ambiguousNumber = (v: string): string => `an ambiguous number '${v}': quote it`;
150
+ export const ambiguousDate = (v: string): string => `an ambiguous date '${v}': quote it`;
151
+ export const unknownEscape = (e: string): string => `an unknown escape '\\${e}' in a double-quoted scalar`;
152
+ export const plainCannotStartWith = (c: string): string => `a plain value cannot start with '${c}': quote it`;
153
+ export const onlyFoldedBlock = (indicator: string): string => `only the folded block '>-' is supported, not '${indicator}'`;
154
+
155
+ // ── The repository pack ─────────────────────────────────────────────────
156
+
157
+ export const expectedMapping = (kind: string): string => `expected a mapping, found a ${kind}`;
158
+ export const expectedString = (kind: string): string => `expected a string, found a ${kind}`;
159
+ export const LIST_FOUND_MAPPING = "expected a list of strings, found a mapping";
160
+ export const listHolding = (kind: string): string => `expected a list of strings, found a list holding a ${kind}`;
161
+ export const testsAlsoSourceRoot = (tests: string, key: string): string =>
162
+ `'${tests}' is also layout.${key}: the test author and the implementer would both be refused that folder; ` +
163
+ `drop layout.tests and name the test files with layout.test_files ("${tests}/*.test.ts")`;
164
+ export const PACK_NOT_A_MAPPING = "the pack is not a mapping";
165
+ export const noRepositoryPack = (key: string): string => `no repository pack: add ${key} to .orkeon/repo.yaml`;
166
+ export const packHasNo = (pack: string, key: string): string => `the repository pack ${pack} has no ${key}: add it there`;
167
+
168
+ // ── Test traits and test commands ───────────────────────────────────────
169
+
170
+ export const TRAIT_NAME_CHARS = "a trait name takes letters, digits, '_' and '-'";
171
+ export const PATTERN_EMPTY = "the pattern is empty";
172
+ export const PATTERN_TOO_LONG = "the pattern is longer than 80 characters";
173
+ export const PATTERN_NO_TAB_OR_BREAK = "a tab or a line break is not allowed";
174
+ export const PATTERN_NO_SINGLE_QUOTE = "a single quote is not allowed";
175
+ export const PATTERN_NO_PIPE = "a '|' is not allowed: the runtime's shell refuses it";
176
+ export const PATTERN_ONE_ID = "the pattern must hold <id> exactly once";
177
+ export const PATTERN_ONE_NAME = "the pattern may hold <name> once at most";
178
+ export const PATTERN_ANGLES = "'<' and '>' may only enclose <id> and <name>";
179
+ export const PATTERN_TOO_SHORT = "the pattern needs at least two characters around <id>";
180
+ export const valueHoldsDotDot = (value: string): string => `the value '${value}' holds a '..' segment`;
181
+ export const valueNotPlain = (value: string): string => `the value '${value}' is not one plain relative name`;
182
+ export const NOT_ONE_LINE = "not one line of at most 400 characters";
183
+ export const SHELL_OPERATOR_OUTSIDE_QUOTES = "a shell operator outside double quotes";
184
+ export const PACK_HAS_NO_TEST_COMMAND = "the pack has no test_class, test_project or test_integration";
185
+ export const nothingMayFollow = (rest: string): string => `nothing may follow the pack's command: '${rest}'`;
186
+ export const INTEGRATION_WITHOUT_FILTER = "test_integration without a filter is a whole suite";
187
+ export const NOT_A_PACK_TEST_COMMAND = "not one of the pack's test_class, test_project or test_integration commands";
188
+ export const AS_THE_PACK_NAMES_IT = "as the pack names it";
189
+ export const validationLineText = (command: string, exit: number, scope: string, tests: string | number): string =>
190
+ `\`${command}\` — exit ${exit}, scope ${scope}, ${tests} tests`;
191
+
192
+ // ── Concurrency of /dev-batches ─────────────────────────────────────────
193
+
194
+ export const concurrencyNotWhole = (raw: string): string => `concurrency must be a whole number from 1, not '${raw}'`;
195
+ export const concurrencyAtMost = (n: number, max: number): string => `concurrency ${n} refused: at most ${max} batches at once`;
196
+ export const concurrencyModeAsks = (n: number, mode: string): string =>
197
+ `concurrency ${n} refused: the session mode ${mode} asks before shell commands, and two batches would ask at once: ` +
198
+ "/mode bypassPermissions, or run with --concurrency 1";
199
+ export const concurrencyGitFails = (n: number): string =>
200
+ `concurrency ${n} refused: git does not work inside a worktree under this shell confinement (Tools:Shell:Confinement:Mode)` +
201
+ "; a runtime from Orkeon/orkeon#191 on binds a linked worktree's git dir: update it, or run with --concurrency 1";
202
+
203
+ // ── Build commands, tool arguments, whitespace, work folder ─────────────
204
+
205
+ export const PACK_HAS_NO_BUILD = "the pack has no commands.build";
206
+ export const PACK_HAS_NO_BUILD_TEST = "the pack has no commands.build_test to build one project";
207
+ export const buildTestPlaceholders = (holes: number, template: string): string =>
208
+ `commands.build_test has ${holes} placeholders, not one: '${template}'`;
209
+ export const stepRulesDenyShell = (command: string): string => `the rules of this step deny the shell command '${command}'`;
210
+ export const argumentNotAString = (key: string): string => `'${key}' is not a string`;
211
+ export const argumentNotOneLine = (key: string, max: number): string => `'${key}' is not one line of at most ${max} characters`;
212
+ export const trailingWhitespace = (lines: number): string => `trailing whitespace on ${lines} line${lines === 1 ? "" : "s"}`;
213
+ export const ONE_BLANK_LINE_AT_EOF = "a blank line at EOF removed";
214
+ export const blankLinesAtEof = (blank: number): string => `${blank} blank lines at EOF removed`;
215
+ export const AN_ABSOLUTE_PATH = "an absolute path";
216
+ export const AN_EMPTY_SEGMENT = "an empty segment";
217
+ export const notARelativeFolder = (value: string, reason: string): string =>
218
+ `'${value}' is not a relative folder of the checkout: ${reason}`;
219
+
220
+ // ── /dev-learn ──────────────────────────────────────────────────────────
221
+
222
+ export const THE_TOP_LEVEL = "the top level";
223
+ export const hasTheWrongShape = (what: string): string => `${what} has the wrong shape`;
224
+ export const fieldHasTheWrongShape = (file: string, field: string): string => `${file}: ${field} has the wrong shape`;
225
+ export const acceptedHarness = (id: string, title: string): string =>
226
+ `accepted ${id} — ${title}: a harness file is never edited here; apply this in the orkeon-workshop repository:`;
227
+ export const acceptedOrkeonCode = (id: string, title: string): string =>
228
+ `accepted ${id} — ${title}: an Orkeon Code file is never edited here; apply this in the orkeon-code repository, ` +
229
+ "a document with its French twin under docs/fr/, a prompt's behaviour first (ADR 0003):";
230
+ /** A harness owner that is no rule of a repository pack (one of a proposals.json from before the rule): /dev-learn
231
+ * has no patch for it now, whether the file still exists or not. */
232
+ export const acceptedNotAHarnessRule = (id: string, title: string, path: string): string =>
233
+ `accepted ${id} — ${title}: ${path} is not a rule of a repository pack, the only harness file /dev-learn ` +
234
+ "patches now: no patch to apply; run /dev-learn again for a current owner";
235
+ /** An Orkeon Code owner off its rules (one of a proposals.json from before them, or edited by hand). */
236
+ export const acceptedNotAnOrkeonCodeChange = (id: string, title: string, path: string): string =>
237
+ `accepted ${id} — ${title}: /dev-learn patches ${path} only as a listed Orkeon Code destination, with status new ` +
238
+ "and no line removed, which this motif is not: no patch to apply; run /dev-learn again for a current owner";
239
+ export const acceptedRepository = (id: string, title: string, path: string): string =>
240
+ `accepted ${id} — ${title}: ${path} is not edited by /dev-learn; make the change in a batch (/dev-spec <code> refactor, or by hand):`;
241
+
242
+ // ── The timing line of /dev-spec and /dev-plan ──────────────────────────
243
+
244
+ export const timingSeconds = (seconds: number): string => `${seconds} s`;
245
+ export const timingMinutes = (minutes: number, seconds: number): string => `${minutes} min ${seconds} s`;
246
+ export const timingAttempts = (n: number): string => `(${n} attempts)`;
247
+ export const timingRounds = (n: number): string => `(${n} rounds)`;
248
+ export const timingPasses = (n: number): string => `(${n} passes)`;
249
+ /** One phase: its name, its duration, then its runs when it ran more than once ("" otherwise). */
250
+ export const timingPhase = (phase: string, duration: string, runs: string): string =>
251
+ `${phase} ${duration}${runs === "" ? "" : ` ${runs}`}`;
252
+ export const TIMING_SEPARATOR = " · ";
253
+ export const timingLine = (phases: string, total: string): string => `timing: ${phases} — total ${total}`;
254
+
255
+ // ── The permission gate of a dev step ───────────────────────────────────
256
+
257
+ export const GATE_ONLY_HINT = " /dev-batches <code> F<n> --audit --gate-only runs no model and needs no gate.";
258
+ export const gateIsOff = (step: string, setting: string, command: string, gateOnly: string): string =>
259
+ `${step}: refused: the host's permission gate is off (${setting} is not true), so the step's rule ` +
260
+ `sets and its read-only mode would check nothing. The launcher turns the gate on unless a settings file turns ` +
261
+ `it off: remove that setting, restart the REPL and run /${command} again.${gateOnly}`;
262
+
263
+ // The self-checks shared by the spec, the brief, the plan and the learning
264
+ export const rowIsEmpty = (name: string, row: number): string => `${name} ${row} is empty`;
265
+ export const fieldEmpty = (at: string, field: string): string => `${at}: ${field} is empty`;
266
+ export const nameOneLine = (max: number): string => `name: one line of at most ${max} characters, no '—'`;
267
+ export const idNameOneLine = (id: string, max: number): string => `${id}: the name is one line of at most ${max} characters`;
268
+ export const statementOneLine = (id: string, max: number): string =>
269
+ `${id}: the statement is one testable line of at most ${max} characters`;
270
+ export const TBD_WITHOUT_QUESTION = "a TBD in the body has no open question";
271
+ export const tooManyQuestions = (max: number): string => `questions: at most ${max}`;
@@ -0,0 +1,50 @@
1
+ // Where the time of a dev step went: the milliseconds of each named phase, summed over its runs, the phases in the
2
+ // order they first started, and the one line the step's summary ends with. Pure: the caller measures, this adds up and
3
+ // renders. A timing whose clock never moved (total 0 ms) renders nothing: there is nothing to say.
4
+ import {
5
+ TIMING_SEPARATOR, timingAttempts, timingLine as timingText, timingMinutes, timingPasses, timingPhase, timingRounds,
6
+ timingSeconds,
7
+ } from "./messages.ts";
8
+
9
+ /** What a phase run more than once counts: the tries of one call, the rounds of a dialogue, the passes of a write. */
10
+ export type RunUnit = "attempt" | "round" | "pass";
11
+
12
+ export interface PhaseTime { readonly phase: string; readonly ms: number; readonly runs: number; readonly unit: RunUnit }
13
+
14
+ export type PhaseTiming = readonly PhaseTime[];
15
+
16
+ export const NO_TIMING: PhaseTiming = [];
17
+
18
+ /** `timing` with a place for `phase` when it has none yet, run 0 times: a phase takes its place when it starts, so a
19
+ * phase timed inside another comes after it. */
20
+ export function startPhase(timing: PhaseTiming, phase: string, unit: RunUnit = "attempt"): PhaseTiming {
21
+ return timing.some((p) => p.phase === phase) ? timing : [...timing, { phase, ms: 0, runs: 0, unit }];
22
+ }
23
+
24
+ /** `timing` with one run more and `ms` more under `phase` (a negative duration counts as 0), its first unit kept. */
25
+ export function recordPhase(timing: PhaseTiming, phase: string, ms: number, unit: RunUnit = "attempt"): PhaseTiming {
26
+ const spent = Math.max(0, ms);
27
+ return startPhase(timing, phase, unit).map((p) => (p.phase === phase ? { ...p, ms: p.ms + spent, runs: p.runs + 1 } : p));
28
+ }
29
+
30
+ export function timingTotalMs(timing: PhaseTiming): number {
31
+ return timing.reduce((sum, p) => sum + p.ms, 0);
32
+ }
33
+
34
+ /** Whole seconds under a minute, minutes and seconds from there. */
35
+ export function durationText(ms: number): string {
36
+ const seconds = Math.round(Math.max(0, ms) / 1000);
37
+ if (seconds < 60) return timingSeconds(seconds);
38
+ return timingMinutes(Math.floor(seconds / 60), seconds % 60);
39
+ }
40
+
41
+ const RUNS: Record<RunUnit, (n: number) => string> = { attempt: timingAttempts, round: timingRounds, pass: timingPasses };
42
+
43
+ /** The summary's timing line, the phases that never ran left out; "" for a timing with no time spent. */
44
+ export function timingLine(timing: PhaseTiming): string {
45
+ const ran = timing.filter((p) => p.runs > 0);
46
+ const total = timingTotalMs(ran);
47
+ if (total === 0) return "";
48
+ const phases = ran.map((p) => timingPhase(p.phase, durationText(p.ms), p.runs > 1 ? RUNS[p.unit](p.runs) : ""));
49
+ return timingText(phases.join(TIMING_SEPARATOR), durationText(total));
50
+ }
@@ -8,6 +8,12 @@ import { parseBatchSheet, parseGlobalPlan, unfencedLines } from "./plan-format.t
8
8
  import type { Line } from "./plan-format.ts";
9
9
  import { sheetFacts } from "./sheet-facts.ts";
10
10
  import { SHEET_ID_SOURCE } from "./trait-pattern.ts";
11
+ import { ASSUMPTIONS_SECTION, BUILD_STEP } from "./markers.ts";
12
+ import {
13
+ anchorRowsMismatch, assumptionsNotEmpty, batchesDiffer, buildStepHoldsTdd, dependsOnDiffers, designIdsNeither,
14
+ idOutsideBatch, lastStepIsNot, noAppliedRulesRow, noTestNamesIt, noTraceabilityRow, notASourceId, stepHasNoTdd,
15
+ stepOneMissing, stepOutOfOrder,
16
+ } from "./messages.ts";
11
17
 
12
18
  /** The texts of a plan folder, as the gate reads them. */
13
19
  export interface PlanFolderTexts {
@@ -36,9 +42,6 @@ export interface SelfCheckInput {
36
42
  }
37
43
  export interface SelfCheckReport { ok: boolean; problems: string[] }
38
44
 
39
- const BUILD_STEP = "Build and tests";
40
- /** The one parse problem a reviewed plan may carry: a batch the review marked blocked. */
41
- const BLOCKED_BATCH = /^unknown batch line '### Batch F\d+ — .+ — blocked'$/;
42
45
  const SEPARATOR_ROW = /^\|[-: |]+\|?$/;
43
46
 
44
47
  const idsIn = (text: string): string[] => text.match(new RegExp(SHEET_ID_SOURCE, "g")) ?? [];
@@ -94,14 +97,14 @@ interface ReadSheet { id: string; name: string; text: string; lines: Line[] }
94
97
 
95
98
  function stepProblems(s: ReadSheet): string[] {
96
99
  const steps = parseBatchSheet(s.text).steps;
97
- if (steps.length === 0) return [`${s.id}: step 1 is missing: the sheet has no step`];
100
+ if (steps.length === 0) return [stepOneMissing(s.id)];
98
101
  const out: string[] = [];
99
102
  steps.forEach((step, i) => {
100
103
  const last = i === steps.length - 1;
101
- if (step.number !== i + 1) out.push(`${s.id}: step ${step.number} is numbered out of order (expected ${i + 1})`);
102
- if (!last && step.tdd === null) out.push(`${s.id}: step ${step.number} has no TDD: line`);
103
- if (last && step.title !== BUILD_STEP) out.push(`${s.id}: step ${step.number} is the last step and is not ${BUILD_STEP}`);
104
- if (last && step.tdd !== null) out.push(`${s.id}: step ${step.number} is ${BUILD_STEP} and holds a TDD: line`);
104
+ if (step.number !== i + 1) out.push(stepOutOfOrder(s.id, step.number, i + 1));
105
+ if (!last && step.tdd === null) out.push(stepHasNoTdd(s.id, step.number));
106
+ if (last && step.title !== BUILD_STEP) out.push(lastStepIsNot(s.id, step.number, BUILD_STEP));
107
+ if (last && step.tdd !== null) out.push(buildStepHoldsTdd(s.id, step.number, BUILD_STEP));
105
108
  });
106
109
  return out;
107
110
  }
@@ -110,11 +113,11 @@ function anchorProblem(s: ReadSheet): string | null {
110
113
  const steps = parseBatchSheet(s.text).steps.length;
111
114
  const rows = dataRows(section(s.lines, "## Anchors") ?? []);
112
115
  const shaped = rows.length === steps && rows.every((cells, i) => cells[0].startsWith(`${i + 1} — `));
113
- return shaped ? null : `${s.id}: ## Anchors has ${rows.length} rows for ${steps} steps`;
116
+ return shaped ? null : anchorRowsMismatch(s.id, rows.length, steps);
114
117
  }
115
118
 
116
119
  function assumptionsEmpty(s: ReadSheet): boolean {
117
- const body = section(s.lines, "## Assumptions");
120
+ const body = section(s.lines, ASSUMPTIONS_SECTION);
118
121
  if (body === null) return false;
119
122
  const filled = body.map((l) => l.text.trim()).filter((t) => t !== "");
120
123
  return filled.length === 2 && filled[0].startsWith("|") && SEPARATOR_ROW.test(filled[1]);
@@ -129,10 +132,8 @@ export function planSelfCheck(input: SelfCheckInput): SelfCheckReport {
129
132
  const parsed = input.sheets.map((s) => parseBatchSheet(s.text));
130
133
  const source = new Set(input.sourceIds);
131
134
 
132
- // 1, 14: the plan parses back; a batch line the review marked blocked is tolerated.
133
- for (const p of global.problems) {
134
- if (!BLOCKED_BATCH.test(p.message)) problems.push(`${input.plan.name}:${p.line}: ${p.message}`);
135
- }
135
+ // 1, 14: the plan parses back; a batch line the review marked blocked is no problem of the parse.
136
+ for (const p of global.problems) problems.push(`${input.plan.name}:${p.line}: ${p.message}`);
136
137
  // 2: every sheet parses back.
137
138
  input.sheets.forEach((s, i) => {
138
139
  for (const p of parsed[i].problems) problems.push(`${s.name}:${p.line}: ${p.message}`);
@@ -140,13 +141,13 @@ export function planSelfCheck(input: SelfCheckInput): SelfCheckReport {
140
141
  // 3: every design id applied or not applicable.
141
142
  const texts = input.sheets.map((s) => s.text);
142
143
  const missing = missingDesignIds({ sheets: texts, plans: [input.plan.text], all: [input.plan.text, ...texts] });
143
- if (missing.length > 0) problems.push(`design ids neither applied nor non-applicable: ${missing.join(", ")}`);
144
+ if (missing.length > 0) problems.push(designIdsNeither(missing));
144
145
  // 4: the same batches, in order.
145
146
  const summaryIds = global.summary.map((r) => r.id);
146
147
  const lineIds = global.batches.map((b) => b.id);
147
148
  const sheetIds = sheets.map((s) => s.id);
148
149
  if (summaryIds.join() !== lineIds.join() || lineIds.join() !== sheetIds.join()) {
149
- problems.push(`batches differ: summary ${listed(summaryIds)}, plan lines ${listed(lineIds)}, sheets ${listed(sheetIds)}`);
150
+ problems.push(batchesDiffer(listed(summaryIds), listed(lineIds), listed(sheetIds)));
150
151
  }
151
152
  // 5: Depends on agrees between the summary and the sheet.
152
153
  sheets.forEach((s, i) => {
@@ -154,36 +155,36 @@ export function planSelfCheck(input: SelfCheckInput): SelfCheckReport {
154
155
  if (row === undefined) return;
155
156
  const a = listed(row.dependsOn);
156
157
  const b = listed(parsed[i].dependsOn);
157
- if (a !== b) problems.push(`${s.id}: Depends on differs between the summary (${a}) and the sheet (${b})`);
158
+ if (a !== b) problems.push(dependsOnDiffers(s.id, a, b));
158
159
  });
159
160
  // 6: every source id has a traceability row.
160
161
  const traceRows = dataRows(section(unfencedLines(input.plan.text), "## 2. Traceability") ?? []);
161
162
  for (const id of input.sourceIds) {
162
163
  const re = new RegExp(`^${id}(?![0-9])`);
163
- if (!traceRows.some((cells) => re.test(cells[0]))) problems.push(`${id}: no row of ## 2. Traceability`);
164
+ if (!traceRows.some((cells) => re.test(cells[0]))) problems.push(noTraceabilityRow(id));
164
165
  }
165
166
  // 7: every source id is named by some sheet's TDD sequence.
166
167
  const facts = sheets.map((s) => sheetFacts(s.text));
167
168
  const tested = new Set(facts.flatMap((f) => f.ids));
168
169
  for (const id of input.sourceIds) {
169
- if (!tested.has(id)) problems.push(`${id}: no test of any sheet's ## TDD sequence names it`);
170
+ if (!tested.has(id)) problems.push(noTestNamesIt(id));
170
171
  }
171
172
  sheets.forEach((s, i) => {
172
173
  // 8: a sheet tests ids of the source only.
173
- for (const id of facts[i].ids) if (!source.has(id)) problems.push(`${s.id}: ${id} is not an id of the source`);
174
+ for (const id of facts[i].ids) if (!source.has(id)) problems.push(notASourceId(s.id, id));
174
175
  // 9: behaviour steps 1..s, then the build step.
175
176
  problems.push(...stepProblems(s));
176
177
  // 10: one anchor row per step.
177
178
  const anchors = anchorProblem(s);
178
179
  if (anchors !== null) problems.push(anchors);
179
180
  // 11: an Applied rules row.
180
- if (facts[i].appliedRulesRow === null) problems.push(`${s.id}: no Applied rules row`);
181
+ if (facts[i].appliedRulesRow === null) problems.push(noAppliedRulesRow(s.id));
181
182
  // 12: assumptions left empty.
182
- if (!assumptionsEmpty(s)) problems.push(`${s.id}: ## Assumptions is not empty`);
183
+ if (!assumptionsEmpty(s)) problems.push(assumptionsNotEmpty(s.id));
183
184
  // 13: the TDD sequence names only the batch's ids.
184
185
  const own = new Set([...stepTableIds(section(s.lines, "## TDD sequence") ?? []), ...intentIds(s.lines)]);
185
186
  for (const id of facts[i].ids) {
186
- if (!own.has(id)) problems.push(`${s.id}: ${id} appears in ## TDD sequence outside the batch's ids`);
187
+ if (!own.has(id)) problems.push(idOutsideBatch(s.id, id));
187
188
  }
188
189
  });
189
190
  return { ok: problems.length === 0, problems };
@@ -1,6 +1,11 @@
1
1
  // Dev workflow plans: the global plan `<CODE>-PLAN.md` and its batch sheets
2
2
  // `<CODE>-PLAN-F<n>.md`, read line by line. Pure, no IO, never throws: a line that
3
3
  // looks like a format line but does not match becomes a FormatProblem.
4
+ import {
5
+ ASSUMPTION_BULLET, ASSUMPTION_ROW, ASSUMPTIONS_SECTION, BATCH_LINE, BATCH_PREFIX, BLOCKED_STATE, DEPENDS_ON, DONE_LINE, PLAN_TITLE, SHEET_TITLE,
6
+ STEP_BOX, STEP_HEADING, SUMMARY_HEADING, TDD_LINE,
7
+ } from "./markers.ts";
8
+ import { malformedSummaryRow, malformedTddLine, tddLineOutsideStep, twoTddLines, unknownBatchLine } from "./messages.ts";
4
9
 
5
10
  export interface FormatProblem { line: number; message: string }
6
11
  export type BatchState = { kind: "open" } | { kind: "done"; date: string } | { kind: "other"; text: string };
@@ -21,19 +26,7 @@ export interface BatchSheet {
21
26
  }
22
27
  export interface SheetProgress { behaviourSteps: number; red: number; green: number; cost: number; complete: number }
23
28
 
24
- const PLAN_TITLE = /^# (\S+)-PLAN — (.+)$/;
25
- const SUMMARY_HEADING = /^## 0\. Summary/;
26
- const BATCH_LINE = /^### Batch (F\d+) — (.+) — (open|done \((\d{4}-\d{2}-\d{2})\))$/;
27
- const BATCH_PREFIX = /^### Batch (F\d+) — (.*)$/;
28
- const STEP_BOX = /^- \[( |x|X)\] (\d+)\. (.*)$/;
29
- const SHEET_TITLE = /^# (\S+)-PLAN-(F\d+) — (.+?)( — done \((\d{4}-\d{2}-\d{2})\))?$/;
30
- const DEPENDS_ON = /\*\*Depends on\*\*: (.+)$/;
31
- const STEP_HEADING = /^### Step (\d+) — (.+)$/;
32
- const TDD_LINE = /^TDD: RED \[( |x|X)\] GREEN \[( |x|X)\] COST \[( |x|X)\]$/;
33
- const DONE_LINE = /^Done \((\d{4}-\d{2}-\d{2})\) — /;
34
29
  // A row of `## Assumptions`: the table's `| H<n> | <text> | <by> |`, or the list line written before it.
35
- const ASSUMPTION_ROW = /^\|\s*(H\d+)\s*\|(.*)\|(.*)\|\s*$/;
36
- const ASSUMPTION_BULLET = /^- (H\d+) — (.*) — to be validated by (.+)$/;
37
30
 
38
31
  export interface Line { text: string; line: number }
39
32
 
@@ -88,14 +81,11 @@ export function parseGlobalPlan(text: string): GlobalPlan {
88
81
  const state: BatchState = m[4] ? { kind: "done", date: m[4] } : { kind: "open" };
89
82
  batch = { id: m[1], name: m[2], state, steps: [], line };
90
83
  } else {
91
- plan.problems.push({ line, message: `unknown batch line '${t}'` });
92
84
  const p = BATCH_PREFIX.exec(t);
93
- if (p) {
94
- const cut = p[2].lastIndexOf(" — ");
95
- const name = cut >= 0 ? p[2].slice(0, cut) : p[2];
96
- const stateText = cut >= 0 ? p[2].slice(cut + 3) : "";
97
- batch = { id: p[1], name, state: { kind: "other", text: stateText }, steps: [], line };
98
- }
85
+ const cut = p ? p[2].lastIndexOf(" — ") : -1;
86
+ const stateText = p && cut >= 0 ? p[2].slice(cut + 3) : "";
87
+ if (stateText !== BLOCKED_STATE) plan.problems.push({ line, message: unknownBatchLine(t) });
88
+ if (p) batch = { id: p[1], name: cut >= 0 ? p[2].slice(0, cut) : p[2], state: { kind: "other", text: stateText }, steps: [], line };
99
89
  }
100
90
  if (batch) plan.batches.push(batch);
101
91
  }
@@ -109,7 +99,7 @@ export function parseGlobalPlan(text: string): GlobalPlan {
109
99
  const cells = tableCells(t);
110
100
  if (cells && /^F\d+$/.test(cells[0])) {
111
101
  if (cells.length < 5) {
112
- plan.problems.push({ line, message: `malformed summary row '${t}'` });
102
+ plan.problems.push({ line, message: malformedSummaryRow(t) });
113
103
  continue;
114
104
  }
115
105
  plan.summary.push({
@@ -130,7 +120,7 @@ export function parseBatchSheet(text: string): BatchSheet {
130
120
  for (const { text: t, line } of unfencedLines(text)) {
131
121
  if (t.startsWith("#")) {
132
122
  step = null;
133
- if (t.startsWith("## ")) { inIntent = t === "## Intent"; inAssumptions = t === "## Assumptions"; }
123
+ if (t.startsWith("## ")) { inIntent = t === "## Intent"; inAssumptions = t === ASSUMPTIONS_SECTION; }
134
124
  const title = SHEET_TITLE.exec(t);
135
125
  if (title && sheet.prefix === undefined) {
136
126
  sheet.prefix = title[1];
@@ -154,9 +144,9 @@ export function parseBatchSheet(text: string): BatchSheet {
154
144
  }
155
145
  if (t.startsWith("TDD:")) {
156
146
  const m = TDD_LINE.exec(t);
157
- if (!m) { sheet.problems.push({ line, message: `malformed TDD line '${t}'` }); continue; }
158
- if (!step) { sheet.problems.push({ line, message: `TDD line outside a step '${t}'` }); continue; }
159
- if (step.tdd !== null) { sheet.problems.push({ line, message: `step ${step.number} has two TDD: lines` }); continue; }
147
+ if (!m) { sheet.problems.push({ line, message: malformedTddLine(t) }); continue; }
148
+ if (!step) { sheet.problems.push({ line, message: tddLineOutsideStep(t) }); continue; }
149
+ if (step.tdd !== null) { sheet.problems.push({ line, message: twoTddLines(step.number) }); continue; }
160
150
  step.tdd = { red: tick(m[1]), green: tick(m[2]), cost: tick(m[3]), line };
161
151
  continue;
162
152
  }
@@ -165,7 +155,7 @@ export function parseBatchSheet(text: string): BatchSheet {
165
155
  return sheet;
166
156
  }
167
157
 
168
- /** Behaviour steps = steps with a TDD line (none under "Build and tests", plan-template.md:131). */
158
+ /** Behaviour steps = steps with a TDD line; a step under "Build and tests" carries none, so it never counts. */
169
159
  export function sheetProgress(sheet: BatchSheet): SheetProgress {
170
160
  const p: SheetProgress = { behaviourSteps: 0, red: 0, green: 0, cost: 0, complete: 0 };
171
161
  for (const s of sheet.steps) {
@@ -2,25 +2,11 @@
2
2
  // what exists instead of guessing a module's name and reading it. The list is git's (tracked and untracked files
3
3
  // alike, the ignored ones aside), the work folder and `.orkeon/` left out, bounded; its closing line says whether it
4
4
  // is whole (a name absent from it does not exist) or cut (glob with a pattern decides past the cut). Pure.
5
+ import { PROJECT_FILES_HEADING, PROJECT_FILES_WHOLE_LINE, projectFilesCutLine } from "./prompts/brief-blocks.ts";
5
6
 
6
7
  /** The most files a brief lists; past it the count left out is said, and glob with a pattern finds the rest. */
7
8
  export const MAX_LISTED_FILES = 150;
8
9
 
9
- export const PROJECT_FILES_HEADING = "Project files (tracked and untracked, the work folder and .orkeon/ left out):";
10
-
11
- /** The closing line of a whole list. */
12
- export const PROJECT_FILES_WHOLE_LINE = "- (the list is whole: a name absent from it does not exist)";
13
-
14
- /** What a reader makes of the list, said only to an agent whose brief carries it: the closing line decides. */
15
- export const PROJECT_LIST_RULE =
16
- "When the brief lists the project's files, its last line says whether the list is whole: when it is, a name absent " +
17
- "from it does not exist; past a cut, glob with a pattern decides. Never open a name you guessed, nor a folder.";
18
-
19
- /** The closing line of a list cut at its bound, `left` files left out. */
20
- export function projectFilesCutLine(left: number): string {
21
- return `- … and ${left} more: a name absent above may still exist; glob with a pattern lists them`;
22
- }
23
-
24
10
  /** git's listing (one path per line) as a sorted list without duplicates, the work folder and .orkeon/ left out. */
25
11
  export function parseTrackedFiles(stdout: string, work: string): string[] {
26
12
  const folder = work.endsWith("/") ? work : `${work}/`;
@@ -0,0 +1,20 @@
1
+ // The text of the blocks a dev brief carries: the cut and left-out notes, the list of the project's files.
2
+
3
+ /** The line a cut block ends with. */
4
+ export const cutLine = (left: number): string => `… (cut: ${left} more characters)`;
5
+ export const notCarried = (titles: string): string => `Not carried (no room left): ${titles}.`;
6
+
7
+ export const PROJECT_FILES_HEADING = "Project files (tracked and untracked, the work folder and .orkeon/ left out):";
8
+
9
+ /** The closing line of a whole list. */
10
+ export const PROJECT_FILES_WHOLE_LINE = "- (the list is whole: a name absent from it does not exist)";
11
+
12
+ /** What a reader makes of the list, said only to an agent whose brief carries it: the closing line decides. */
13
+ export const PROJECT_LIST_RULE =
14
+ "When the brief lists the project's files, its last line says whether the list is whole: when it is, a name absent " +
15
+ "from it does not exist; past a cut, glob with a pattern decides. Never open a name you guessed, nor a folder.";
16
+
17
+ /** The closing line of a list cut at its bound, `left` files left out. */
18
+ export function projectFilesCutLine(left: number): string {
19
+ return `- … and ${left} more: a name absent above may still exist; glob with a pattern lists them`;
20
+ }