orkeon-code 0.0.0-stage → 1.0.0-rc.1

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 (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,409 @@
1
+ // dev-verify's use case: checks the inputs and the checkout, resolves the batch sheet,
2
+ // runs the gate, and on a green gate writes the capture, runs the whole suite under full,
3
+ // hands the batch to the read-only auditor and writes the verdict file. It returns the
4
+ // completion text the command prints. --gate-only stops after the gate: no model call,
5
+ // no write.
6
+ import type { CostIndex, Files, Llm, Logger, Shell } from "../../../shared/application/ports.ts";
7
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
8
+ import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
9
+ import type { DevContext } from "../../../shared/application/dev/load-dev-context.ts";
10
+ import { GIT_TOPLEVEL, workFolderLabel } from "../../../shared/application/dev/resolve-work-folder.ts";
11
+ import { costSummary } from "../../../shared/domain/dev/access-cost.ts";
12
+ import { classifyArtefact, isCode } from "../../../shared/domain/dev/artefacts.ts";
13
+ import type { RepoPack } from "../../../shared/domain/dev/repo-pack.ts";
14
+ import {
15
+ AUDIT_UNFINISHED_GAP, auditCommand, closeLine, correctionLine, isAuditUnfinishedGap, isUnfinishedSection, lastFinishedVerdict, lastVerdict,
16
+ parseVerdictFile,
17
+ } from "../../../shared/domain/dev/verdict-format.ts";
18
+ import type { GapRow } from "../../../shared/domain/dev/verdict-format.ts";
19
+ import { AXES } from "../domain/audit-answer.ts";
20
+ import type { AuditRow, Axis } from "../domain/audit-answer.ts";
21
+ import { testRunSummary } from "../domain/capture-sections.ts";
22
+ import { cut, firstLine } from "../domain/text.ts";
23
+ import {
24
+ carriedRows, formatWhen, renderVerdictSection, verdictFileName, writeVerdictFile,
25
+ } from "../domain/verdict.ts";
26
+ import { listProjectFiles } from "../../../shared/application/dev/project-files.ts";
27
+ import { outputTail, recordingRunner, runAudit, shellValidationRunner } from "./audit.ts";
28
+ import type { UnfinishedAudit, ValidationRunner } from "./audit.ts";
29
+ import { stepRules } from "../../../shared/domain/dev/step-rules.ts";
30
+ import type { AuditBriefInput } from "./auditor-prompt.ts";
31
+ import { writeCapture } from "./capture.ts";
32
+ import { noPrecedents, precedentsLine, recallQuery, sheetTitle } from "../../../shared/application/dev/step-precedents.ts";
33
+ import type { StepPrecedents } from "../../../shared/application/dev/step-precedents.ts";
34
+ import type { WorkFolder } from "../../../shared/application/dev/resolve-work-folder.ts";
35
+ import { runGate } from "./run-gate.ts";
36
+ import type { DevVerifyTarget } from "./run-gate.ts";
37
+ import { WORKSPACE, workspaceRelative } from "../../../shared/domain/vfs.ts";
38
+
39
+ export interface DevVerifyInputs { batch?: unknown; plan?: unknown; mode?: unknown; gateOnly?: unknown }
40
+ export interface DevVerifyDeps {
41
+ files: Files; shell: Shell; config: Pick<ConfigStore, "readValue">;
42
+ llm: Pick<Llm, "act" | "extract">; log: Logger; clock: () => Date;
43
+ /** The run_validation tool's slot, when the crew offers the tool: bound to this audit's runner. */
44
+ validationSlot?: { bind(runner: ValidationRunner): () => void };
45
+ /** The access cost's code index; without it the Cost line says the crew wires none. */
46
+ costIndex?: CostIndex;
47
+ /** The shared memory's code-triggered recall (T4, before the audit); absent, nothing is recalled. */
48
+ precedents?: StepPrecedents;
49
+ /** After a GAPS verdict: the mistakes harvested into candidates and the /dev-learn nudge (M-7); absent, none. */
50
+ harvest?: (work: Pick<WorkFolder, "folder" | "vfsPath">) => Promise<string[]>;
51
+ }
52
+ const FULL_SUITE_TIMEOUT_SECONDS = 900;
53
+
54
+ type Mode = "fast" | "full" | "resume";
55
+ interface Checked { batch: string; plan: string | null; mode: Mode; gateOnly: boolean }
56
+
57
+ const MAX_WARNINGS = 5;
58
+ const LIST_CAP = 500;
59
+ const ENTRIES_PROBED = 50;
60
+ const MAX_FILES_SHOWN = 10;
61
+ const MAX_GAP_CHARS = 120;
62
+ const MODES: readonly string[] = ["fast", "full", "resume"];
63
+ /** The exit code a shell result carries when the process reported none. */
64
+ const NO_EXIT_CODE = -1;
65
+
66
+ /** The row of an audit the step's budget stopped: Blocking, since nothing vouches for the batch; the replies are its evidence. */
67
+ export function unfinishedRow(unfinished: UnfinishedAudit, captureShown: string, batch: string): AuditRow {
68
+ return {
69
+ severity: "Blocking", axis: "Correctness",
70
+ gap: AUDIT_UNFINISHED_GAP,
71
+ evidence: `${unfinished.reason} — ${captureShown}/auditor-replies.txt`,
72
+ fix: `audit the batch again (${auditCommand("<code>", batch, "resume")}), or split it if it spends the budget again`,
73
+ };
74
+ }
75
+
76
+ const reasonOf = (error: unknown): string => firstLine(error instanceof Error ? error.message : String(error));
77
+
78
+ const bare = (entry: string): string => entry.replace(/\/+$/, "");
79
+ const byName = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0);
80
+
81
+ /** A write that fails names its path, so the BLOCKED line can say which. */
82
+ class WriteFailure extends Error {
83
+ readonly path: string;
84
+ constructor(path: string, cause: unknown) {
85
+ super(reasonOf(cause));
86
+ this.path = path;
87
+ }
88
+ }
89
+
90
+ function recordingWriter(files: Files): Files {
91
+ return {
92
+ read: (path, max) => files.read(path, max),
93
+ list: (path, max) => files.list(path, max),
94
+ mounts: () => files.mounts(),
95
+ write: async (path, content) => {
96
+ try {
97
+ await files.write(path, content);
98
+ } catch (error) {
99
+ throw new WriteFailure(path, error);
100
+ }
101
+ },
102
+ };
103
+ }
104
+
105
+ function shown(path: string): string {
106
+ return workspaceRelative(path);
107
+ }
108
+
109
+ function checkInputs(input: DevVerifyInputs): Checked | string {
110
+ const { batch, plan, mode, gateOnly } = input;
111
+ if (typeof batch !== "string" || !/^F\d+$/.test(batch)) return "dev-verify: the input batch must be F<n>, e.g. F2";
112
+ if (plan !== undefined && plan !== null && (typeof plan !== "string" || plan === "")) {
113
+ return "dev-verify: the input plan must be a code or a <CODE>-PLAN.md path";
114
+ }
115
+ if (mode !== undefined && (typeof mode !== "string" || !MODES.includes(mode))) {
116
+ return "dev-verify: the input mode must be fast, full or resume";
117
+ }
118
+ if (gateOnly !== undefined && typeof gateOnly !== "boolean") return "dev-verify: the input gateOnly must be true or false";
119
+ return {
120
+ batch, plan: typeof plan === "string" ? plan : null, mode: (mode ?? "fast") as Mode, gateOnly: gateOnly === true,
121
+ };
122
+ }
123
+
124
+ function warningLines(warnings: readonly string[]): string[] {
125
+ const lines = warnings.slice(0, MAX_WARNINGS).map((w) => `warning: ${w}`);
126
+ if (warnings.length > MAX_WARNINGS) lines.push(`… ${warnings.length - MAX_WARNINGS} more warnings`);
127
+ return lines;
128
+ }
129
+
130
+ async function listOrEmpty(files: Pick<Files, "list">, path: string): Promise<string[]> {
131
+ try {
132
+ return await files.list(path, LIST_CAP);
133
+ } catch {
134
+ return [];
135
+ }
136
+ }
137
+
138
+ interface Sheet { planDir: string; name: string; prefix: string }
139
+
140
+ async function sheetsIn(files: Pick<Files, "list">, planDir: string, batch: string): Promise<Sheet[]> {
141
+ const names = (await listOrEmpty(files, `${WORKSPACE}/${planDir}`)).map(bare).sort(byName);
142
+ const out: Sheet[] = [];
143
+ for (const name of names) {
144
+ const a = classifyArtefact(name);
145
+ if (a !== null && a.kind === "sheet" && a.batch === batch) out.push({ planDir, name, prefix: a.prefix });
146
+ }
147
+ return out;
148
+ }
149
+
150
+ function several(batch: string, sheets: readonly Sheet[]): string {
151
+ return `dev-verify: several sheets for ${batch}: ${sheets.map((s) => `${s.planDir}/${s.name}`).join(", ")}: ` +
152
+ `name the plan, e.g. ${auditCommand("<code>", batch)}`;
153
+ }
154
+
155
+ /** The sheet the plan token names, or the refusal text. */
156
+ async function resolveSheet(files: Pick<Files, "read" | "list">, work: string, args: Checked): Promise<Sheet | string> {
157
+ const { batch, plan } = args;
158
+ if (plan === null) {
159
+ const entries = (await listOrEmpty(files, `${WORKSPACE}/${work}`)).map(bare).sort(byName).slice(0, ENTRIES_PROBED);
160
+ const found: Sheet[] = [];
161
+ for (const entry of entries) found.push(...(await sheetsIn(files, `${work}/${entry}`, batch)));
162
+ if (found.length === 0) return `dev-verify: no ${work}/*/*-PLAN-${batch}.md: name the plan, e.g. ${auditCommand("<code>", batch)}`;
163
+ if (found.length > 1) return several(batch, found);
164
+ return found[0];
165
+ }
166
+ const neither = `dev-verify: '${plan}' is neither a code nor a <CODE>-PLAN.md path`;
167
+ if (isCode(plan)) {
168
+ const found = await sheetsIn(files, `${work}/${plan}`, batch);
169
+ if (found.length === 0) return `dev-verify: ${work}/${plan}/ holds no *-PLAN-${batch}.md`;
170
+ if (found.length === 1) return found[0];
171
+ const named = found.filter((s) => s.prefix === plan.toUpperCase());
172
+ return named.length === 1 ? named[0] : several(batch, found);
173
+ }
174
+ const relative = workspaceRelative(plan);
175
+ const slash = relative.lastIndexOf("/");
176
+ if (relative.startsWith("/") || relative.split("/").includes("..") || slash <= 0) return neither;
177
+ // The capture and the verdict are written beside the plan: a plan outside the work folder would put them elsewhere.
178
+ if (!relative.startsWith(`${work}/`) || relative.split("/").some((s) => s === "" || s === ".")) {
179
+ return `dev-verify: '${plan}' is not under the work folder ${work}/`;
180
+ }
181
+ const classified = classifyArtefact(relative.slice(slash + 1));
182
+ if (classified === null || classified.kind !== "plan") return neither;
183
+ const sheet: Sheet = { planDir: relative.slice(0, slash), name: `${classified.prefix}-PLAN-${batch}.md`, prefix: classified.prefix };
184
+ try {
185
+ await files.read(`${WORKSPACE}/${sheet.planDir}/${sheet.name}`);
186
+ } catch {
187
+ return `dev-verify: no ${sheet.planDir}/${sheet.name} beside ${relative}`;
188
+ }
189
+ return sheet;
190
+ }
191
+
192
+ function auditRowOf(row: GapRow): AuditRow {
193
+ const axis: Axis = AXES.find((a) => a.toLowerCase() === row.axis.trim().toLowerCase()) ?? "Correctness";
194
+ return { severity: row.severity, axis, gap: row.gap, evidence: row.evidence, fix: row.expectedFix };
195
+ }
196
+
197
+ interface SuiteRun {
198
+ validation: string | null;
199
+ notRun: string | null;
200
+ row: AuditRow | null;
201
+ brief: AuditBriefInput["suite"];
202
+ }
203
+
204
+ /** Under full: the pack's whole fast suite, once, with its own timeout. */
205
+ async function runSuite(shell: Pick<Shell, "run">, pack: RepoPack | null): Promise<SuiteRun> {
206
+ const command = pack?.commands.test;
207
+ if (command === undefined || command.trim() === "") {
208
+ return { validation: null, notRun: "commands.test — the pack has none", row: null, brief: undefined };
209
+ }
210
+ let result;
211
+ try {
212
+ result = await shell.run(command, { timeoutSeconds: FULL_SUITE_TIMEOUT_SECONDS });
213
+ } catch (error) {
214
+ return { validation: null, notRun: `\`${command}\` — not run: ${reasonOf(error)}`, row: null, brief: undefined };
215
+ }
216
+ const tail = outputTail(result.stdout, result.stderr);
217
+ if (result.timedOut === true) {
218
+ const outcome = `timed out after ${FULL_SUITE_TIMEOUT_SECONDS} s`;
219
+ const row: AuditRow = {
220
+ severity: "Major", axis: "Test",
221
+ gap: `the whole fast suite did not finish within ${FULL_SUITE_TIMEOUT_SECONDS} s`,
222
+ evidence: `\`${command}\` ${outcome}, run by the full audit`,
223
+ fix: "make the suite finish within its timeout, or run it by hand and record the outcome",
224
+ };
225
+ return { validation: null, notRun: `\`${command}\` — ${outcome}`, row, brief: { command, outcome, tail } };
226
+ }
227
+ const exit = result.exitCode;
228
+ const exitText = exit === NO_EXIT_CODE ? "no exit code reported" : `exit ${exit}`;
229
+ const summary = testRunSummary(tail.split("\n"));
230
+ const failed = summary.failed ?? 0;
231
+ const row: AuditRow | null = exit !== 0 || failed > 0
232
+ ? {
233
+ severity: "Blocking", axis: "Test",
234
+ gap: `the whole fast suite is red: ${exitText}${summary.failed === null ? "" : `, ${failed} failed`}`,
235
+ evidence: `\`${command}\` ${exitText}, run by the full audit`,
236
+ fix: "make the suite green",
237
+ }
238
+ : null;
239
+ return { validation: `whole fast suite — ${exitText}`, notRun: null, row, brief: { command, outcome: exitText, tail } };
240
+ }
241
+
242
+ function filesLine(changed: readonly string[], work: string): string {
243
+ const outside = changed.filter((f) => !f.startsWith(`${work}/`));
244
+ if (outside.length === 0) return " files: none";
245
+ const kept = outside.slice(0, MAX_FILES_SHOWN);
246
+ if (outside.length > MAX_FILES_SHOWN) kept.push(`… ${outside.length - MAX_FILES_SHOWN} more`);
247
+ return ` files: ${kept.join(", ")}`;
248
+ }
249
+
250
+ async function toplevelRefusal(shell: Pick<Shell, "run">): Promise<string | null> {
251
+ let top: string;
252
+ try {
253
+ const r = await shell.run(GIT_TOPLEVEL);
254
+ if (r.exitCode !== 0) return "dev-verify: not inside a git work tree";
255
+ top = r.stdout.trim();
256
+ } catch {
257
+ return "dev-verify: not inside a git work tree";
258
+ }
259
+ if (top === "") return "dev-verify: not inside a git work tree";
260
+ return top === WORKSPACE
261
+ ? null
262
+ : `dev-verify: the git work tree is ${top}, not ${WORKSPACE}: run Orkeon Code at the top of the repository`;
263
+ }
264
+
265
+ function target(ctx: DevContext, sheet: Sheet, batch: string): DevVerifyTarget {
266
+ return {
267
+ batch, code: sheet.planDir.slice(sheet.planDir.lastIndexOf("/") + 1), prefix: sheet.prefix,
268
+ workShown: ctx.work.folder, planDirShown: sheet.planDir, sheetShown: `${sheet.planDir}/${sheet.name}`,
269
+ pack: ctx.pack?.pack ?? null, packShown: ctx.pack?.shown ?? null,
270
+ };
271
+ }
272
+
273
+ export async function runDevVerify(input: DevVerifyInputs, deps: DevVerifyDeps): Promise<string> {
274
+ const args = checkInputs(input);
275
+ if (typeof args === "string") return args;
276
+ const top = await toplevelRefusal(deps.shell);
277
+ if (top !== null) return top;
278
+
279
+ const ctx = await loadDevContext(deps);
280
+ const out = warningLines(ctx.warnings);
281
+ const done = (...lines: string[]): string => [...out, ...lines].join("\n");
282
+ const work = ctx.work.folder;
283
+ if (ctx.work.outcome === "main-worktree") {
284
+ return done(`dev-verify: the work folder ${work} is in the main worktree, outside the mounts: run the audit from the main checkout`);
285
+ }
286
+
287
+ const sheet = await resolveSheet(deps.files, work, args);
288
+ if (typeof sheet === "string") return done(sheet);
289
+ const t = target(ctx, sheet, args.batch);
290
+ out.push(`batch ${args.batch} — sheet ${t.sheetShown} — mode ${args.mode} — work folder ${workFolderLabel(ctx.work, t.packShown)}`);
291
+
292
+ const verdictShown = `${t.planDirShown}/${verdictFileName(t.prefix, args.batch)}`;
293
+ let previous: string | null = null;
294
+ let previousGaps: AuditRow[] | null = null;
295
+ /** The audit's own mode: a resume with no finished audit to resume audits the whole batch, and still appends. */
296
+ let auditMode: Mode = args.mode;
297
+ if (args.mode === "resume" && !args.gateOnly) {
298
+ try {
299
+ previous = await deps.files.read(`${WORKSPACE}/${verdictShown}`);
300
+ } catch {
301
+ return done(`dev-verify: resume needs ${verdictShown}: run ${auditCommand(t.code, args.batch)} first`);
302
+ }
303
+ // An unfinished audit's row is no gap of the code: the resumed audit is not asked to judge it. After an audit the
304
+ // budget stopped, the resume takes the gaps of the last audit that finished; with none, the whole batch is audited.
305
+ const parsed = parseVerdictFile(previous);
306
+ const last = lastVerdict(parsed);
307
+ const finished = last !== null && isUnfinishedSection(last) ? lastFinishedVerdict(parsed) : last;
308
+ if (finished === null) {
309
+ auditMode = "fast";
310
+ out.push("resume: no audit of this batch finished — the whole batch is audited (fast), the section appended");
311
+ } else {
312
+ if (finished !== last) out.push(`resume: the last audit did not finish — the gaps of the audit of ${finished.when ?? "before"} are resumed`);
313
+ previousGaps = finished.rows.filter((r) => !isAuditUnfinishedGap(r.gap)).map(auditRowOf);
314
+ }
315
+ }
316
+
317
+ const gate = await runGate(deps, t);
318
+ if (!gate.ok) return done(`dev-verify: ${gate.error}`);
319
+ const report = gate.run.report;
320
+ if (!report.green) return done(...report.lines);
321
+ if (args.gateOnly) return done(...report.lines, "dev-verify: --gate-only: the gate alone, no capture and no audit");
322
+ const greenLine = report.lines[report.lines.length - 1];
323
+
324
+ const files = recordingWriter(deps.files);
325
+ const when = formatWhen(deps.clock());
326
+ try {
327
+ const capture = await writeCapture({ files, shell: deps.shell, costIndex: deps.costIndex }, t, gate.run, when);
328
+ const costLine = costSummary(capture.cost);
329
+ const suite = args.mode === "full" ? await runSuite(deps.shell, t.pack) : null;
330
+ const commands = t.pack?.commands ?? {};
331
+ // T4: the mistakes earlier audits found, from the sheet's title and the changed paths, before the auditor reads.
332
+ const recalled = await (deps.precedents ?? noPrecedents)("T4", recallQuery([
333
+ sheetTitle(gate.run.sheet), ...gate.run.changedFiles.filter((f) => !f.startsWith(`${work}/`)),
334
+ ]));
335
+ const brief: AuditBriefInput = {
336
+ mode: auditMode, batch: args.batch, sheetPath: t.sheetShown, sheetText: gate.run.sheet, captureFiles: capture.files, captureTexts: capture.texts, table: capture.table,
337
+ projectFiles: await listProjectFiles(deps.shell, work),
338
+ appliedRules: gate.run.facts.appliedIds.length > 0 ? gate.run.facts.appliedIds.join(", ") : "none",
339
+ commands: { testClass: commands.testClass, testProject: commands.testProject, testIntegration: commands.testIntegration },
340
+ previousGaps,
341
+ ...(suite?.brief === undefined ? {} : { suite: suite.brief }),
342
+ precedents: recalled.block,
343
+ };
344
+ // One runner for the tool and for code: a command the auditor ran through run_validation is not run again.
345
+ // The step's rules apply to a validation as to the auditor's own shell_command (the gate does not see it).
346
+ const runner = recordingRunner(shellValidationRunner(deps.shell, commands, stepRules("dev-verify")));
347
+ const release = deps.validationSlot?.bind(runner);
348
+ let audit: Awaited<ReturnType<typeof runAudit>>;
349
+ try {
350
+ audit = await runAudit({ llm: deps.llm, files, runner }, brief, capture.folder, capture.folderShown);
351
+ } finally {
352
+ release?.();
353
+ }
354
+ if (!audit.ok) {
355
+ if (audit.unfinished === undefined) return done(greenLine, costLine, audit.text);
356
+ const unfinished = audit.unfinished;
357
+ // The budget ran out mid-audit: the verdict still says so, with the validations that ran, never a silent BLOCKED.
358
+ const stopped = unfinishedRow(unfinished, capture.folderShown, args.batch);
359
+ // The stopped row covers no mechanical gap: each one is carried, as no auditor weighed it.
360
+ const answered = suite?.row ? [suite.row] : [];
361
+ const section = renderVerdictSection({
362
+ prefix: t.prefix, batch: args.batch, when, mode: auditMode,
363
+ rows: [stopped, ...answered, ...carriedRows(answered, capture.rows)],
364
+ validations: [...(suite?.validation ? [suite.validation] : []), ...unfinished.validations],
365
+ notRun: [...(suite?.notRun ? [suite.notRun] : []), ...unfinished.notRun],
366
+ });
367
+ await files.write(`${WORKSPACE}/${verdictShown}`, writeVerdictFile(previous, section.text, args.mode));
368
+ deps.log.info(`dev-verify: ${section.verdict} written to ${verdictShown} (the audit did not finish)`);
369
+ return done(greenLine, costLine, ...section.text.trimEnd().split("\n"),
370
+ `${audit.text}; ${section.verdict} written to ${verdictShown}: the audit did not finish`);
371
+ }
372
+
373
+ const answered = [...audit.answer.rows, ...audit.redRows, ...(suite?.row ? [suite.row] : [])];
374
+ const section = renderVerdictSection({
375
+ prefix: t.prefix, batch: args.batch, when, mode: auditMode,
376
+ rows: [...answered, ...carriedRows(answered, capture.rows)],
377
+ validations: [...(suite?.validation ? [suite.validation] : []), ...audit.validations],
378
+ notRun: [...(suite?.notRun ? [suite.notRun] : []), ...audit.notRun],
379
+ });
380
+ if (audit.answer.verdict !== section.verdict) {
381
+ deps.log.warn(`the auditor said ${audit.answer.verdict}; the rows make it ${section.verdict}`);
382
+ }
383
+ await files.write(`${WORKSPACE}/${verdictShown}`, writeVerdictFile(previous, section.text, args.mode));
384
+ deps.log.info(`dev-verify: ${section.verdict} written to ${verdictShown}`);
385
+
386
+ const lines = [greenLine, costLine, ...section.text.trimEnd().split("\n"), `written: ${verdictShown} — capture: ${capture.folderShown}/`];
387
+ const recalledLine = precedentsLine([recalled]);
388
+ if (recalledLine !== "") lines.push(recalledLine);
389
+ if (section.verdict === "VALID") {
390
+ lines.push(
391
+ `→ Batch ${args.batch} VALID. The close commits the batch's files (run by itself when /dev-batches launched this audit):`,
392
+ closeLine(t.code, args.batch),
393
+ filesLine(gate.run.changedFiles, work),
394
+ );
395
+ } else {
396
+ const first = section.shown[0];
397
+ lines.push(
398
+ correctionLine(t.code, args.batch, `${first.severity} ${first.axis}: ${cut(first.gap, MAX_GAP_CHARS)}`),
399
+ ` it appends the gap to the sheet as a new step and runs it; the audit follows by itself (${auditCommand(t.code, args.batch, "resume")})`,
400
+ );
401
+ // M-7: the verdict is written; the harvest reads it with the others and can only add lines.
402
+ if (deps.harvest !== undefined) lines.push(...await deps.harvest(ctx.work));
403
+ }
404
+ return done(...lines);
405
+ } catch (error) {
406
+ if (error instanceof WriteFailure) return done(greenLine, `dev-verify: BLOCKED — ${shown(error.path)} cannot be written (${error.message})`);
407
+ throw error;
408
+ }
409
+ }
@@ -0,0 +1,202 @@
1
+ // Gathers what the gate needs - the sheet, the texts of the plan folder, the changed files,
2
+ // the trait hits, the whitespace check - with git calls only, then runs the five checks.
3
+ // Fast and side-effect free: no build, no write (`--gate-only` relies on it).
4
+ import type { Files, Shell } from "../../../shared/application/ports.ts";
5
+ import { firstLine, stdoutLines } from "../domain/text.ts";
6
+ import { runtimeCut } from "../domain/runtime-cut.ts";
7
+ import type { RepoPack } from "../../../shared/domain/dev/repo-pack.ts";
8
+ import type { TraitMarker } from "../../../shared/domain/dev/trait-pattern.ts";
9
+ import { traitMarker } from "../../../shared/domain/dev/trait-pattern.ts";
10
+ import type { GateLine, GateReport } from "../domain/gate.ts";
11
+ import { gateLineText, runGateChecks } from "../domain/gate.ts";
12
+ import type { SheetFacts } from "../domain/sheet-facts.ts";
13
+ import { sheetFacts } from "../domain/sheet-facts.ts";
14
+ import {
15
+ GIT_CHANGED_TRACKED, GIT_DIFF_CHECK, UNQUOTABLE_SCOPE, buildOutputProblem, excludePathspecs, gitTraitGrep, gitUntracked,
16
+ } from "../domain/commands.ts";
17
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
18
+
19
+ const MAX_PLAN_ENTRIES = 500;
20
+ const MAX_PLAN_FILES = 60;
21
+
22
+ /** What a run audits, resolved by run-dev-verify.ts (P4). */
23
+ export interface DevVerifyTarget {
24
+ batch: string; // "F2"
25
+ code: string; // the folder name, "demo"
26
+ prefix: string; // <CODE> of the file names, "DEMO"
27
+ workShown: string; // "workbench"
28
+ planDirShown: string; // "workbench/demo"
29
+ sheetShown: string; // "workbench/demo/DEMO-PLAN-F2.md"
30
+ pack: RepoPack | null;
31
+ packShown: string | null;
32
+ }
33
+
34
+ /** layout.domain, application, infrastructure, tests: set ones, de-duplicated, in that order (prod first, tests last: AC:36-37). */
35
+ export function gateRoots(pack: RepoPack | null): string[] {
36
+ if (pack === null) return [];
37
+ const { domain, application, infrastructure, tests } = pack.layout;
38
+ const roots: string[] = [];
39
+ for (const r of [domain, application, infrastructure, tests]) {
40
+ if (r !== undefined && r !== "" && !roots.includes(r)) roots.push(r);
41
+ }
42
+ return roots;
43
+ }
44
+
45
+ export interface GateRun {
46
+ report: GateReport;
47
+ sheet: string; facts: SheetFacts;
48
+ roots: string[]; excludes: string[];
49
+ changedFiles: string[]; untrackedFiles: string[];
50
+ trait: TraitMarker | null; traitHits: string[] | null;
51
+ }
52
+ export type GateOutcome = { ok: true; run: GateRun } | { ok: false; error: string };
53
+
54
+ function errorLine(error: unknown): string {
55
+ return firstLine(error instanceof Error ? error.message : String(error));
56
+ }
57
+
58
+ function byCodeUnit(a: string, b: string): number {
59
+ return a < b ? -1 : a > b ? 1 : 0;
60
+ }
61
+
62
+ class GateCommandError extends Error {}
63
+
64
+ /**
65
+ * The stdout of a git call, without the runtime's cut notice; a throw or an exit outside `okExits`
66
+ * (-1: none reported) refuses the gate. `cut` is a FAIL line when the runtime cut the stdout.
67
+ */
68
+ async function runOrRefuse(
69
+ shell: Pick<Shell, "run">, command: string, okExits: readonly number[] = [0],
70
+ ): Promise<{ stdout: string; cut: GateLine | null }> {
71
+ let result;
72
+ try {
73
+ result = await shell.run(command);
74
+ } catch (error) {
75
+ throw new GateCommandError(`the gate could not run '${command}': ${errorLine(error)}`);
76
+ }
77
+ if (result.exitCode !== -1 && !okExits.includes(result.exitCode)) {
78
+ const why = firstLine(result.stderr);
79
+ throw new GateCommandError(`the gate could not run '${command}': exit ${result.exitCode}${why === "" ? "" : ` (${why})`}`);
80
+ }
81
+ const { kept, omitted } = runtimeCut(result.stdout);
82
+ const cut = omitted > 0
83
+ ? { kind: "FAIL" as const, text: `the output of '${command}' was cut by the runtime (${omitted} characters omitted): the list is incomplete, run the gate again on a smaller change` }
84
+ : null;
85
+ return { stdout: kept, cut };
86
+ }
87
+
88
+ /** The report with the run's own lines added after the checks, green and the last line recomputed. */
89
+ function withChecks(report: GateReport, input: { batch: string; sheetShown: string }, extra: readonly GateLine[]): GateReport {
90
+ if (extra.length === 0) return report;
91
+ const checks = [...report.checks, ...extra];
92
+ const green = !checks.some((c) => c.kind === "FAIL");
93
+ const lines = [
94
+ `GATE — batch ${input.batch} — sheet ${input.sheetShown}`,
95
+ ...checks.map(gateLineText),
96
+ green ? `GATE — batch ${input.batch}: GREEN` : `GATE — batch ${input.batch}: RED — fix and run again, no audit before`,
97
+ ];
98
+ return { ...report, green, lines, checks };
99
+ }
100
+
101
+ async function planTexts(files: Pick<Files, "read" | "list">, planDir: string) {
102
+ let names: string[];
103
+ try {
104
+ names = await files.list(planDir, MAX_PLAN_ENTRIES);
105
+ } catch {
106
+ names = [];
107
+ }
108
+ const sheets: string[] = [];
109
+ const plans: string[] = [];
110
+ const all: string[] = [];
111
+ const warnings: GateLine[] = [];
112
+ const isPlan = (n: string): boolean => /-PLAN[^/]*\.md$/.test(n);
113
+ const md = names.filter((n) => n.endsWith(".md")).sort(byCodeUnit);
114
+ const ordered = [...md.filter(isPlan), ...md.filter((n) => !isPlan(n))];
115
+ for (const name of ordered.slice(MAX_PLAN_FILES)) {
116
+ warnings.push({ kind: "note", text: `plan folder: ${name} not read (beyond the first ${MAX_PLAN_FILES} .md files, *-PLAN*.md first)` });
117
+ }
118
+ for (const name of ordered.slice(0, MAX_PLAN_FILES)) {
119
+ let text: string;
120
+ try {
121
+ text = await files.read(`${planDir}/${name}`);
122
+ } catch {
123
+ continue;
124
+ }
125
+ all.push(text);
126
+ if (/-PLAN-F\d+\.md$/.test(name)) sheets.push(text);
127
+ if (/-PLAN\.md$/.test(name)) plans.push(text);
128
+ }
129
+ return { texts: { sheets, plans, all }, warnings };
130
+ }
131
+
132
+ export async function runGate(
133
+ deps: { files: Pick<Files, "read" | "list">; shell: Pick<Shell, "run"> },
134
+ target: DevVerifyTarget,
135
+ ): Promise<GateOutcome> {
136
+ const outputs = target.pack?.layout.buildOutputs ?? [];
137
+ for (const o of outputs) {
138
+ const problem = buildOutputProblem(o);
139
+ if (problem !== undefined) return { ok: false, error: problem };
140
+ }
141
+ const excludes = excludePathspecs(outputs);
142
+ const roots = gateRoots(target.pack);
143
+
144
+ let sheet: string;
145
+ try {
146
+ sheet = await deps.files.read(`${WORKSPACE}/${target.sheetShown}`);
147
+ } catch (error) {
148
+ return { ok: false, error: `the sheet ${target.sheetShown} cannot be read (${errorLine(error)})` };
149
+ }
150
+ const { texts: plan, warnings } = await planTexts(deps.files, `${WORKSPACE}/${target.planDirShown}`);
151
+
152
+ try {
153
+ const extra: GateLine[] = [...warnings];
154
+ const trackedRun = await runOrRefuse(deps.shell, GIT_CHANGED_TRACKED);
155
+ const untrackedRun = await runOrRefuse(deps.shell, gitUntracked(excludes));
156
+ const tracked = stdoutLines(trackedRun.stdout);
157
+ const untrackedFiles = stdoutLines(untrackedRun.stdout);
158
+ for (const r of [trackedRun, untrackedRun]) if (r.cut !== null) extra.push(r.cut);
159
+ const changedFiles = [...new Set([...tracked, ...untrackedFiles])].sort(byCodeUnit);
160
+
161
+ const facts = sheetFacts(sheet);
162
+ const trait = traitMarker(target.pack?.tests.ruleTrait, target.pack?.tests.traitPattern);
163
+ let traitHits: string[] | null = null;
164
+ if (trait !== null && facts.ids.length > 0) {
165
+ const command = gitTraitGrep(trait.ere, roots.length > 0 ? roots : ["."], excludes);
166
+ if (command === null) {
167
+ extra.push({ kind: "FAIL", text: `rule traits: ${UNQUOTABLE_SCOPE}` });
168
+ } else {
169
+ // git grep exits 1 when nothing matches.
170
+ const grep = await runOrRefuse(deps.shell, command, [0, 1]);
171
+ traitHits = stdoutLines(grep.stdout);
172
+ if (grep.cut !== null) extra.push(grep.cut);
173
+ }
174
+ }
175
+
176
+ let diffCheckExit: number;
177
+ try {
178
+ diffCheckExit = (await deps.shell.run(GIT_DIFF_CHECK)).exitCode;
179
+ } catch {
180
+ diffCheckExit = 1;
181
+ }
182
+
183
+ const report = withChecks(runGateChecks({
184
+ batch: target.batch,
185
+ sheetShown: target.sheetShown,
186
+ sheet,
187
+ facts,
188
+ plan,
189
+ planDirShown: target.planDirShown,
190
+ planDirAbsolute: `${WORKSPACE}/${target.planDirShown}`,
191
+ roots,
192
+ changedFiles,
193
+ trait,
194
+ traitHits,
195
+ diffCheckExit,
196
+ }), target, extra);
197
+ return { ok: true, run: { report, sheet, facts, roots, excludes, changedFiles, untrackedFiles, trait, traitHits } };
198
+ } catch (error) {
199
+ if (error instanceof GateCommandError) return { ok: false, error: error.message };
200
+ throw error;
201
+ }
202
+ }