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,103 @@
1
+ // @orkeon-script 1.0
2
+ /// <reference path="../.orkeon/orkeon.d.ts" />
3
+ //
4
+ // DevVerify crew (dev-verify). Composition root: it builds the auditor agent from its
5
+ // charter and wires application/run-dev-verify, which checks the batch's gate, writes
6
+ // the capture under <work>/<code>/capture-F<n>/, measures the access cost over the code index
7
+ // (index_status, incremental_reindex, access_cost), runs the whole suite under full, asks
8
+ // the read-only auditor (its read tools and run_validation, plan mode) - its brief carries the shared memory's
9
+ // mistake precedents (T4) - and writes <CODE>-VERIFY-F<n>.md; after a GAPS verdict, the mistakes that recur in three
10
+ // batches become candidates under memory.dir and /dev-learn is nudged at two (M-7).
11
+ // A red gate or --gate-only returns the gate lines without any model call. The auditor's act runs in a
12
+ // background child, `dev-auditor`, which /tasks lists and stops while it runs (A-3,
13
+ // shared/application/agents/child-agent.ts); on a host without background children it runs inline.
14
+ //
15
+ // Input (globalThis.inputs): { batch: "F<n>", plan?: string | null, mode?: "fast" | "full" | "resume", gateOnly?: boolean,
16
+ // hooks?: the /hooks registry, effort?: "low" | "medium" | "high" | "xhigh" | "max" | null,
17
+ // concurrency?: number, maxInstances?: number, memoryRecall?: false (a session rule denies it) }
18
+ // Run standalone: bash scripts/run-crew.sh src/crews/dev-verify/crew.ork.ts --inputs '{"batch":"F1","gateOnly":true}'
19
+ //
20
+ // Budget: under full, the build (900 s), the whole suite (900 s) and three validations
21
+ // (300 s each) can all run, plus the model's own time: one hour of wall time.
22
+
23
+ import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infrastructure/globals.ts";
24
+ import { runValidationTool, scriptToolSlot } from "../../shared/infrastructure/orkeon/script-tools.ts";
25
+ import type { ValidationCalls } from "../../shared/infrastructure/orkeon/script-tools.ts";
26
+ import { STEP_BUDGETS } from "../../shared/domain/dev/step-budget.ts";
27
+ import { orkeonAgent, orkeonClock, orkeonSessionIo } from "../../shared/infrastructure/orkeon/wiring.ts";
28
+ import { memoryRecallOn, memoryRecallTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
29
+ import { agentTools, verifyCallbacks, verifyDeps } from "../../shared/infrastructure/orkeon/dev-deps.ts";
30
+ import { childAgentBody, withChildAct } from "../../shared/infrastructure/orkeon/child-agents.ts";
31
+ import { createChildBoard } from "../../shared/application/agents/child-agent.ts";
32
+ import { charterCatalogue } from "../../shared/domain/agents/charter.ts";
33
+ import { instanceLimits } from "../../shared/domain/agents/instances.ts";
34
+ import { providerEffort } from "../../shared/domain/agent-policy/behavior-flags.ts";
35
+ import { AUDITOR_CHARTER } from "./domain/auditor-charter.ts";
36
+ import { runDevVerify } from "./application/run-dev-verify.ts";
37
+
38
+ // memory_recall is attached unless a session rule denies every call of it (the command says so).
39
+ const memoryOn = memoryRecallOn(inputs());
40
+ const effort = providerEffort(inputs().effort);
41
+ const limits = instanceLimits(inputs());
42
+ // The auditor's run_validation: built here, bound by the body to the run's recording runner (audit.ts) and
43
+ // released when the audit ends; two runs bound at once make it refuse (script-tool-slot.ts).
44
+ const validationSlot = scriptToolSlot<ValidationCalls>();
45
+ // memory_recall's ports: over the tools of the verifier's body (dev-deps.ts), never the global's.
46
+ const bodyTools = agentTools();
47
+ // The host's gate first, then these callbacks: the step's rule sets again and the /hooks the command passed,
48
+ // over the tools of the body that acts (the verifier's, or the background auditor's own).
49
+ const options = { hooks: inputs().hooks, effort, memoryOn };
50
+ const callbacksFor = (ctx: any) => verifyCallbacks(ctx, options);
51
+
52
+ /** The auditor as a child, added to the crew by its first act (a sequential crew would run an agent it holds from the start). */
53
+ const auditorChild = () => {
54
+ const builder = orkeonAgent()
55
+ .name(AUDITOR_CHARTER.name)
56
+ .role(AUDITOR_CHARTER.role)
57
+ .goal(AUDITOR_CHARTER.goal)
58
+ .tools(charterCatalogue(AUDITOR_CHARTER))
59
+ .withAutonomousTool(runValidationTool(ToolBuilder, validationSlot))
60
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, bodyTools.memoryPorts(), memoryOn))
61
+ .maxIterations(AUDITOR_CHARTER.maxIterations)
62
+ .body(childAgentBody(callbacksFor));
63
+ return effort === undefined ? builder : builder.effort(effort);
64
+ };
65
+
66
+ const verifier = orkeonAgent()
67
+ .name("dev-verifier")
68
+ .role(AUDITOR_CHARTER.role)
69
+ .goal(AUDITOR_CHARTER.goal)
70
+ // The auditor's tools, for the inline audit on a host without background children.
71
+ .tools(charterCatalogue(AUDITOR_CHARTER))
72
+ .withAutonomousTool(runValidationTool(ToolBuilder, validationSlot))
73
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, bodyTools.memoryPorts(), memoryOn))
74
+ .maxIterations(AUDITOR_CHARTER.maxIterations)
75
+ .body(async (_input: any, ctx: any) => {
76
+ bodyTools.bind(ctx.tools);
77
+ const clock = orkeonClock();
78
+ const board = createChildBoard({ state: orkeonSessionIo(ctx.tools), clock, log: ctx.log }, { crew: "dev-verify", step: "dev-verify" });
79
+ try {
80
+ // The ports over this body's tools (dev-deps.ts); the audit's act in a background child, /tasks listing it;
81
+ // T4's precedents in its brief, and after a GAPS verdict the mistakes that recur become candidates (M-7).
82
+ const deps = verifyDeps(ctx, {
83
+ ...options, validationSlot, harvest: true,
84
+ wrapLlm: (llm) => withChildAct(llm, ctx, crew, { board, clock, log: ctx.log, effort },
85
+ { agent: AUDITOR_CHARTER.name, charter: AUDITOR_CHARTER.name, task: `audit of ${String(inputs().batch ?? "the batch")}`, builder: auditorChild }),
86
+ });
87
+ return await runDevVerify(inputs(), deps);
88
+ } finally {
89
+ await board.close();
90
+ }
91
+ })
92
+ .build();
93
+
94
+ const crew = CrewBuilder()
95
+ .name("dev-verify")
96
+ .process("sequential")
97
+ .budget(STEP_BUDGETS["dev-verify"])
98
+ .concurrency(limits.concurrency)
99
+ .maxInstances(limits.maxInstances)
100
+ .withAgent(verifier)
101
+ .build();
102
+
103
+ publishCrew(crew);
@@ -0,0 +1,150 @@
1
+ // The auditor's answer: the JSON schema it is extracted into, and the check that
2
+ // turns the extraction into an AuditAnswer or the list of what is wrong with it.
3
+ // Pure, no IO. Axes are spelt as the verdict files spell them, so the learning
4
+ // pass reads the rows this answer becomes.
5
+
6
+ import type { Severity } from "../../../shared/domain/dev/verdict-format.ts";
7
+ import { AXES } from "../../../shared/domain/dev/verdict-format.ts";
8
+ import type { Axis } from "../../../shared/domain/dev/verdict-format.ts";
9
+ import type { Checked } from "../../../shared/domain/agents/charter.ts";
10
+
11
+ /** The axes live with the verdict format; re-exported for this crew's importers. */
12
+ export { AXES };
13
+ export type { Axis };
14
+ export const SEVERITY_ORDER: readonly Severity[] = ["Blocking", "Major", "Minor"];
15
+
16
+ export interface AuditRow { severity: Severity; axis: Axis; gap: string; evidence: string; fix: string }
17
+ export interface Undecided { check: string; reason: string }
18
+ export interface AuditAnswer { verdict: "VALID" | "GAPS"; rows: AuditRow[]; validations: string[]; undecided: Undecided[] }
19
+
20
+ export const MAX_ANSWER_ROWS = 40;
21
+ export const MAX_VALIDATIONS = 3;
22
+
23
+ export const AUDIT_ANSWER_SCHEMA: object = {
24
+ type: "object",
25
+ properties: {
26
+ verdict: { type: "string", enum: ["VALID", "GAPS"] },
27
+ rows: {
28
+ type: "array",
29
+ items: {
30
+ type: "object",
31
+ properties: {
32
+ severity: { type: "string", enum: [...SEVERITY_ORDER] },
33
+ axis: { type: "string", enum: [...AXES] },
34
+ gap: { type: "string" },
35
+ evidence: { type: "string" },
36
+ fix: { type: "string" },
37
+ },
38
+ required: ["severity", "axis", "gap", "evidence", "fix"],
39
+ },
40
+ },
41
+ validations: { type: "array", items: { type: "string" } },
42
+ undecided: {
43
+ type: "array",
44
+ items: {
45
+ type: "object",
46
+ properties: { check: { type: "string" }, reason: { type: "string" } },
47
+ required: ["check", "reason"],
48
+ },
49
+ },
50
+ },
51
+ required: ["verdict", "rows", "validations"],
52
+ };
53
+
54
+ /** A path:line citation, or the capture it comes from. */
55
+ const CITATION = /[A-Za-z0-9_./-]+:\d+/;
56
+ /** An axis label that names the plan by its staleness (LC:36). */
57
+ const PLAN_ALIAS = "stale plan";
58
+
59
+ function isPlainObject(value: unknown): value is Record<string, unknown> {
60
+ return typeof value === "object" && value !== null && !Array.isArray(value);
61
+ }
62
+
63
+ function text(value: unknown): string {
64
+ return typeof value === "string" ? value.trim() : "";
65
+ }
66
+
67
+ /** The tool's name written around one quoted command: `run_validation "<command>"`, its '…' and `…` forms, or the
68
+ * same between parentheses, where the argument may also be named (`command="<command>"`). A quote may hold its own
69
+ * kind escaped (`\"`), read back unescaped; an unescaped one ends it, so the form has one reading. */
70
+ const TOOL_WRAPPED =
71
+ /^run_validation\s*(\(\s*(?:command\s*[=:]\s*)?)?(?:"((?:[^"\\]|\\.)+)"|'((?:[^'\\]|\\.)+)'|`([^`]+)`)\s*(\))?$/;
72
+
73
+ /** A validation as the pack's commands read it: the command alone, the tool's name around it taken off. */
74
+ export function validationCommand(written: string): string {
75
+ const trimmed = written.trim();
76
+ const m = TOOL_WRAPPED.exec(trimmed);
77
+ if (m === null) return trimmed;
78
+ if ((m[1] !== undefined) !== (m[5] !== undefined)) return trimmed; // an unbalanced parenthesis: no single reading
79
+ if (m[2] !== undefined) return m[2].replace(/\\(["\\])/g, "$1").trim();
80
+ if (m[3] !== undefined) return m[3].replace(/\\(['\\])/g, "$1").trim();
81
+ return m[4].trim();
82
+ }
83
+
84
+ function axisOf(label: string): Axis | undefined {
85
+ const folded = label.toLowerCase();
86
+ if (folded.startsWith(PLAN_ALIAS)) return "Plan";
87
+ return AXES.find((a) => a.toLowerCase() === folded);
88
+ }
89
+
90
+ function citesEvidence(evidence: string): boolean {
91
+ return CITATION.test(evidence) || evidence.includes("table.md") || evidence.includes("capture-");
92
+ }
93
+
94
+ function checkRow(value: unknown, k: number, problems: string[]): AuditRow | undefined {
95
+ const item = isPlainObject(value) ? value : {};
96
+ const before = problems.length;
97
+ const severity = text(item.severity);
98
+ if (!SEVERITY_ORDER.includes(severity as Severity)) problems.push(`row ${k}: severity must be Blocking, Major or Minor`);
99
+ const label = text(item.axis);
100
+ const axis = axisOf(label);
101
+ if (axis === undefined) problems.push(`row ${k}: axis '${label}' is not one of ${AXES.join(", ")}`);
102
+ const fields = { gap: text(item.gap), evidence: text(item.evidence), fix: text(item.fix) };
103
+ for (const [field, value] of Object.entries(fields)) {
104
+ if (value === "") problems.push(`row ${k}: ${field} is empty`);
105
+ }
106
+ if (fields.evidence !== "" && !citesEvidence(fields.evidence)) problems.push(`row ${k}: evidence cites no path:line`);
107
+ if (problems.length > before || axis === undefined) return undefined;
108
+ return { severity: severity as Severity, axis, ...fields };
109
+ }
110
+
111
+ export function checkAuditAnswer(value: unknown): Checked<AuditAnswer> {
112
+ if (!isPlainObject(value)) return { ok: false, problems: ["the answer is not an object"] };
113
+ const problems: string[] = [];
114
+ const verdict = text(value.verdict);
115
+ if (verdict !== "VALID" && verdict !== "GAPS") problems.push("verdict must be VALID or GAPS");
116
+
117
+ const rows: AuditRow[] = [];
118
+ if (!Array.isArray(value.rows)) {
119
+ problems.push("rows must be a list");
120
+ } else {
121
+ if (value.rows.length > MAX_ANSWER_ROWS) problems.push(`at most ${MAX_ANSWER_ROWS} rows, not ${value.rows.length}`);
122
+ value.rows.forEach((item, i) => {
123
+ const checked = checkRow(item, i + 1, problems);
124
+ if (checked) rows.push(checked);
125
+ });
126
+ }
127
+
128
+ let validations: string[] = [];
129
+ if (!Array.isArray(value.validations) || value.validations.some((v) => typeof v !== "string")) {
130
+ problems.push("validations must be a list of commands");
131
+ } else {
132
+ validations = value.validations.map((v: string) => validationCommand(v));
133
+ if (validations.length > MAX_VALIDATIONS) problems.push(`at most ${MAX_VALIDATIONS} validations, not ${validations.length}`);
134
+ }
135
+
136
+ const undecided: Undecided[] = [];
137
+ const items = value.undecided ?? [];
138
+ if (!Array.isArray(items)) {
139
+ problems.push("undecided must be a list");
140
+ } else {
141
+ items.forEach((item, i) => {
142
+ const entry = isPlainObject(item) ? { check: text(item.check), reason: text(item.reason) } : { check: "", reason: "" };
143
+ if (entry.check === "" || entry.reason === "") problems.push(`undecided ${i + 1}: check and reason are needed`);
144
+ else undecided.push(entry);
145
+ });
146
+ }
147
+
148
+ if (problems.length > 0) return { ok: false, problems };
149
+ return { ok: true, value: { verdict: verdict as AuditAnswer["verdict"], rows, validations, undecided } };
150
+ }
@@ -0,0 +1,21 @@
1
+ // The auditor's charter: a read-only sub-agent in plan mode, with seven read
2
+ // tools and no shell: a command it doubts runs through the read-class
3
+ // run_validation tool when its crew offers it, or is named back to code. glob
4
+ // decides a name past the cut of the brief's project list; affected_tests gives
5
+ // the test class a validation is built on.
6
+
7
+ import type { Charter } from "../../../shared/domain/agents/charter.ts";
8
+
9
+ export const AUDITOR_TOOLS: readonly string[] = [
10
+ "file_read", "node_read", "glob", "codebase_search", "symbol_detail", "symbol_source", "affected_tests",
11
+ ];
12
+
13
+ export const AUDITOR_CHARTER: Charter = {
14
+ name: "dev-auditor",
15
+ role: "Batch auditor",
16
+ goal: "Weigh one delivered batch against its code and its sheet, and answer with evidenced gaps",
17
+ mode: "plan",
18
+ tools: AUDITOR_TOOLS,
19
+ disallowed: ["shell_command", "file_write", "rag_ingest"],
20
+ maxIterations: 12,
21
+ };
@@ -0,0 +1,137 @@
1
+ // The sections of a dev-verify capture: how one section text is split into files the
2
+ // model can read whole, and the small readings each section is made of (a build log, a
3
+ // test tail, the classes of a test file). Pure.
4
+ export { isTestFile, isTestRoot } from "../../../shared/domain/dev/access-cost.ts";
5
+
6
+ export const MAX_SECTION_CHARS = 32_000;
7
+ export const SECTION_CUT_CHARS = 31_000;
8
+ export const MAX_SECTION_PARTS = 10;
9
+ export const MAX_DIFF_FILES = 40;
10
+ export const MAX_CLASS_FILES = 40; // AC:354
11
+ export const TEST_TAIL_LINES = 15; // AC:315
12
+ export const BUILD_ERROR_LINES = 6; // AC:211
13
+ export const TRAIT_HIT_LINES = 40; // AC:305
14
+
15
+ const WHY_CHARS = 120;
16
+ const BUILD_LOG_ERROR = /Build FAILED|(^|[^A-Za-z])error [A-Z]+[0-9]+|^exit=[1-9]/m;
17
+ const FAILURE_LINE = /error|Error|failed|Failed|FAIL/;
18
+ const CLASS_DECL = /\b(class|record)\s+([A-Za-z_][A-Za-z0-9_]*)/g;
19
+ const DESCRIBE_CALL = /\bdescribe\(\s*["'`]([^"'`]+)["'`]/g;
20
+
21
+ export interface SectionFile { name: string; content: string } // "build.txt", "diff-003-2.txt"
22
+
23
+ function partName(base: string, k: number): string {
24
+ return k === 1 ? `${base}.txt` : `${base}-${k}.txt`;
25
+ }
26
+
27
+ /** One file when the content fits in 32 000 characters, else parts cut on a line break (§ 2.3). */
28
+ export function splitSection(base: string, content: string): SectionFile[] {
29
+ if (content.length <= MAX_SECTION_CHARS) return [{ name: partName(base, 1), content }];
30
+ const files: SectionFile[] = [];
31
+ let rest = content;
32
+ for (let k = 1; ; k++) {
33
+ if (rest.length <= MAX_SECTION_CHARS) {
34
+ files.push({ name: partName(base, k), content: rest });
35
+ return files;
36
+ }
37
+ const lastBreak = rest.lastIndexOf("\n", SECTION_CUT_CHARS);
38
+ const end = lastBreak >= 0 ? lastBreak + 1 : SECTION_CUT_CHARS;
39
+ const part = rest.slice(0, end);
40
+ rest = rest.slice(end);
41
+ if (k === MAX_SECTION_PARTS) {
42
+ files.push({ name: partName(base, k), content: `${part}\n[cut: ${rest.length} more characters not captured]\n` });
43
+ return files;
44
+ }
45
+ files.push({ name: partName(base, k), content: `${part}\n[continued in ${partName(base, k + 1)}]\n` });
46
+ }
47
+ }
48
+
49
+ /** 1 → "diff-001". */
50
+ export function diffBase(index: number): string {
51
+ return `diff-${String(index).padStart(3, "0")}`;
52
+ }
53
+
54
+ function lines(text: string): string[] {
55
+ const all = text.split("\n").map((l) => l.replace(/\r$/, ""));
56
+ if (all.length > 0 && all[all.length - 1] === "") all.pop();
57
+ return all;
58
+ }
59
+
60
+ /** The first line of the log that marks a failed build (AC:246); null when the log reads green. */
61
+ export function buildLogProblem(log: string): string | null {
62
+ for (const l of lines(log)) if (BUILD_LOG_ERROR.test(l)) return l;
63
+ return null;
64
+ }
65
+
66
+ /** The lines a failed build shows, and why it failed in one line of at most 120 characters (AC:274-275). */
67
+ export function buildFailure(output: string): { why: string; lines: string[] } {
68
+ const all = lines(output);
69
+ const failing = all.filter((l) => FAILURE_LINE.test(l));
70
+ const shown = failing.length > 0 ? failing.slice(0, BUILD_ERROR_LINES) : all.slice(-BUILD_ERROR_LINES);
71
+ const why = (failing[0] ?? all[all.length - 1] ?? "").slice(0, WHY_CHARS);
72
+ return { why, lines: shown };
73
+ }
74
+
75
+ export function tailLines(text: string, n: number): string[] {
76
+ return n <= 0 ? [] : lines(text).slice(-n);
77
+ }
78
+
79
+ export interface TestRunSummary { passed: number | null; failed: number | null; exit: number | null }
80
+
81
+ /** The summary of a test run's tail: VSTest, Microsoft.Testing.Platform and Node's runner, and `exit=` (AC:415-420). */
82
+ export function testRunSummary(tail: readonly string[]): TestRunSummary {
83
+ let passed = 0;
84
+ let failed = 0;
85
+ let seen = false;
86
+ let exit: number | null = null;
87
+ for (const raw of tail) {
88
+ const l = raw.replace(/\r$/, "");
89
+ const vstest = /Failed: *([0-9]+), *Passed: *([0-9]+)/.exec(l);
90
+ if (vstest) { failed += Number(vstest[1]); passed += Number(vstest[2]); seen = true; }
91
+ let m: RegExpExecArray | null;
92
+ if ((m = /^ *failed: *([0-9]+) *$/.exec(l))) { failed += Number(m[1]); seen = true; }
93
+ if ((m = /^ *succeeded: *([0-9]+) *$/.exec(l))) { passed += Number(m[1]); seen = true; }
94
+ if ((m = /^(ℹ|#) (pass|fail) ([0-9]+)\s*$/.exec(l))) {
95
+ if (m[2] === "pass") passed += Number(m[3]);
96
+ else failed += Number(m[3]);
97
+ seen = true;
98
+ }
99
+ if ((m = /^exit=([0-9]+)/.exec(l))) exit = Number(m[1]);
100
+ }
101
+ return { passed: seen ? passed : null, failed: seen ? failed : null, exit };
102
+ }
103
+
104
+ /** The classes and records a test file declares, sorted, then the names of its describe() calls. */
105
+ export function classesIn(source: string): string[] {
106
+ const classes = [...new Set([...source.matchAll(CLASS_DECL)].map((m) => m[2]))].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
107
+ const out = [...classes];
108
+ for (const m of source.matchAll(DESCRIBE_CALL)) if (!out.includes(m[1])) out.push(m[1]);
109
+ return out;
110
+ }
111
+
112
+ /** The basename up to its first "." (AC:341). */
113
+ export function typeNameOf(path: string): string {
114
+ const base = path.slice(path.lastIndexOf("/") + 1);
115
+ const dot = base.indexOf(".");
116
+ return dot < 0 ? base : base.slice(0, dot);
117
+ }
118
+
119
+ /** The `traits` section: the marker, the sheet's ids, then the first 40 hits as `path:line text`. */
120
+ export function traitsSection(marker: string | null, ids: readonly string[], hits: readonly string[] | null): string {
121
+ if (marker === null) return "not checked — the pack has no tests.rule_trait or tests.trait_pattern\n";
122
+ const out = [`marker: ${marker}`, `ids of the sheet: ${ids.join(" ")}`];
123
+ for (const h of (hits ?? []).filter((x) => x !== "").slice(0, TRAIT_HIT_LINES)) out.push(h.replace(/:([0-9]*):/, ":$1 "));
124
+ return `${out.join("\n")}\n`;
125
+ }
126
+
127
+ /**
128
+ * One line of the `test-classes` section. A test file gives its classes; another file gives the
129
+ * test files naming its type, or `why` when they were not searched.
130
+ */
131
+ export function testClassesLine(
132
+ path: string, classes: readonly string[] | null, testFiles: readonly string[] | null, why?: string,
133
+ ): string {
134
+ if (classes !== null) return `${path}: ${classes.length > 0 ? classes.join(", ") : "no class found"}`;
135
+ const found = testFiles === null ? (why ?? "none") : testFiles.length > 0 ? testFiles.join(", ") : "none";
136
+ return `${path} -> tests naming ${typeNameOf(path)}: ${found}`;
137
+ }
@@ -0,0 +1,103 @@
1
+ // The shell lines dev-verify runs, every one frozen here so that the gate, the capture
2
+ // and their tests share one spelling. The runtime's shell runs a command line without
3
+ // operators: quoting is the only syntax used. A builder gives null when a path or name
4
+ // cannot be quoted, or when a list it needs is left empty once the unquotable entries are
5
+ // dropped; its caller says the item is not captured. Pure.
6
+
7
+ const PLAIN_WORD = /^[A-Za-z0-9_./@+,:=-]+$/;
8
+ const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
9
+ const MAX_FIND_PATHS = 200;
10
+
11
+ /** The word as the shell gets it: as is when /^[A-Za-z0-9_./@+,:=-]+$/, else single-quoted; null when it holds a "'". */
12
+ export function shellWord(value: string): string | null {
13
+ if (PLAIN_WORD.test(value)) return value;
14
+ if (value.includes("'")) return null;
15
+ return `'${value}'`;
16
+ }
17
+
18
+ /** AC:104: a folder name, not a path. */
19
+ export function buildOutputProblem(name: string): string | undefined {
20
+ return name === "" || name === "." || name === ".." || name.includes("/")
21
+ ? `layout.build_outputs takes folder names, not paths: ${name}`
22
+ : undefined;
23
+ }
24
+
25
+ /** ["':(exclude,glob)**\/bin/**'", …], one per layout.build_outputs entry (AC:101-106). */
26
+ export function excludePathspecs(buildOutputs: readonly string[]): string[] {
27
+ const out: string[] = [];
28
+ for (const o of buildOutputs) {
29
+ const word = shellWord(`:(exclude,glob)**/${o}/**`);
30
+ if (word !== null) out.push(word);
31
+ }
32
+ return out;
33
+ }
34
+
35
+ export const GIT_CHANGED_TRACKED = "git diff --name-only HEAD";
36
+ export const GIT_DIFF_CHECK = "git diff --check HEAD";
37
+
38
+ function line(parts: ReadonlyArray<string | readonly string[]>): string {
39
+ return parts.flat().filter((p) => p !== "").join(" ");
40
+ }
41
+
42
+ /** The quotable words of `values`; null when a non-empty list keeps none. */
43
+ function words(values: readonly string[]): string[] | null {
44
+ const out = values.map(shellWord).filter((w): w is string => w !== null);
45
+ return values.length > 0 && out.length === 0 ? null : out;
46
+ }
47
+
48
+ /** The reason a caller gives when a builder returned null for an unquotable list. */
49
+ export const UNQUOTABLE_SCOPE = "not captured: unquotable scope";
50
+
51
+ export function gitUntracked(excludes: readonly string[]): string {
52
+ return line(["git ls-files --others --exclude-standard -- .", excludes]);
53
+ }
54
+
55
+ export function gitTraitGrep(ere: string, scope: readonly string[], excludes: readonly string[]): string | null {
56
+ const scopeWords = words(scope);
57
+ return scopeWords === null ? null : line([`git grep --untracked -I -noE -e '${ere}' --`, scopeWords, excludes]);
58
+ }
59
+
60
+ export function gitStatusShort(excludes: readonly string[]): string {
61
+ return line(["git status --short -- .", excludes]);
62
+ }
63
+
64
+ export function gitDiffTracked(path: string): string | null {
65
+ const word = shellWord(path);
66
+ return word === null ? null : `git diff HEAD -- ${word}`;
67
+ }
68
+
69
+ export function gitDiffUntracked(path: string): string | null {
70
+ const word = shellWord(path);
71
+ return word === null ? null : `git diff --no-index -- /dev/null ${word}`;
72
+ }
73
+
74
+ export function gitMethodGrep(methods: readonly string[], testDirs: readonly string[], excludes: readonly string[]): string | null {
75
+ const methodWords = words(methods);
76
+ const dirWords = words(testDirs);
77
+ if (methodWords === null || dirWords === null) return null;
78
+ return line(["git grep --untracked -I -n -o -w -F", methodWords.flatMap((m) => ["-e", m]), "--", dirWords, excludes]);
79
+ }
80
+
81
+ export function gitTestFilesNaming(
82
+ type: string, testDirs: readonly string[], ext: string, excludes: readonly string[],
83
+ ): string | null {
84
+ if (!IDENTIFIER.test(type)) return null;
85
+ const specs: string[] = [];
86
+ for (const dir of testDirs) {
87
+ const d = dir.replace(/\/+$/, "");
88
+ const word = shellWord(d === "" || d === "." ? `:(glob)**/*.${ext}` : `:(glob)${d}/**/*.${ext}`);
89
+ if (word === null) return null;
90
+ specs.push(word);
91
+ }
92
+ return line([`git grep --untracked -I -lw -e ${type} --`, specs, excludes]);
93
+ }
94
+
95
+ /** `find ./<path>… -maxdepth 0 -newer <log>`: "./" keeps a name such as "-delete" a path; null for an absolute path. */
96
+ export function findNewer(paths: readonly string[], log: string): string | null {
97
+ if (paths.length === 0 || paths.length > MAX_FIND_PATHS) return null;
98
+ if (paths.some((p) => p.startsWith("/"))) return null;
99
+ const pathWords = paths.map((p) => shellWord(p.startsWith("./") ? p : `./${p}`));
100
+ const logWord = shellWord(log);
101
+ if (logWord === null || pathWords.some((w) => w === null)) return null;
102
+ return line(["find", pathWords as string[], `-maxdepth 0 -newer ${logWord}`]);
103
+ }
@@ -0,0 +1,126 @@
1
+ // The gate of dev-verify: five mechanical checks on a batch before any audit - the sheet
2
+ // closed, every design id classified, every changed file in scope, every sheet id carried
3
+ // by a test trait, no whitespace error. The ok/FAIL lines keep the harness's wording, so
4
+ // that both gates print the same lines on the same batch. Pure: the application gathers
5
+ // the inputs (run-gate.ts).
6
+ import type { SheetFacts } from "./sheet-facts.ts";
7
+ import type { TraitMarker } from "../../../shared/domain/dev/trait-pattern.ts";
8
+ import { SHEET_ID_SOURCE, idsInMatch } from "../../../shared/domain/dev/trait-pattern.ts";
9
+ import { missingDesignIds } from "../../../shared/domain/dev/plan-checks.ts";
10
+ import type { PlanFolderTexts } from "../../../shared/domain/dev/plan-checks.ts";
11
+ export type { PlanFolderTexts } from "../../../shared/domain/dev/plan-checks.ts";
12
+
13
+ export type GateLineKind = "ok" | "FAIL" | "note";
14
+ export interface GateLine { kind: GateLineKind; text: string }
15
+ export interface GateInput {
16
+ batch: string;
17
+ sheetShown: string; // relative to the top
18
+ sheet: string;
19
+ facts: SheetFacts; // sheetFacts(sheet)
20
+ plan: PlanFolderTexts;
21
+ planDirShown: string; // relative, no trailing "/"
22
+ planDirAbsolute: string; // "/workspace/" + planDirShown (printed by the stray note, AC:194)
23
+ roots: readonly string[];
24
+ changedFiles: readonly string[]; // sorted, unique
25
+ trait: TraitMarker | null;
26
+ traitHits: readonly string[] | null; // lines of gitTraitGrep; null when it was not run
27
+ diffCheckExit: number;
28
+ }
29
+ export interface GateReport {
30
+ green: boolean;
31
+ lines: string[]; // header, check lines, final line: what --gate-only prints
32
+ checks: GateLine[];
33
+ missingDesignIds: string[]; outside: string[]; untested: string[]; stray: string[];
34
+ }
35
+
36
+ const ok = (text: string): GateLine => ({ kind: "ok", text });
37
+ const fail = (text: string): GateLine => ({ kind: "FAIL", text });
38
+ const note = (text: string): GateLine => ({ kind: "note", text });
39
+
40
+ function checkClosed(facts: SheetFacts): GateLine {
41
+ return facts.closed
42
+ ? ok("sheet: every step reads `TDD: RED [x] GREEN [x] COST [x]`")
43
+ : fail("sheet not closed: a `TDD:` line is still open, or none is ticked");
44
+ }
45
+
46
+ function outsideFiles(input: GateInput): string[] {
47
+ const prefixes = input.roots.map((r) => `${r.replace(/\/+$/, "")}/`);
48
+ const planPrefix = `${input.planDirShown}/`;
49
+ return input.changedFiles.filter((f) => {
50
+ if (f === "") return false;
51
+ if (prefixes.some((p) => f.startsWith(p))) return false;
52
+ if (f.startsWith(planPrefix)) return false;
53
+ const base = f.slice(f.lastIndexOf("/") + 1);
54
+ return !input.sheet.includes(base);
55
+ });
56
+ }
57
+
58
+ function knownIds(texts: readonly string[]): Set<string> {
59
+ const known = new Set<string>();
60
+ for (const t of texts) for (const id of t.match(new RegExp(SHEET_ID_SOURCE, "g")) ?? []) known.add(id);
61
+ return known;
62
+ }
63
+
64
+ export function runGateChecks(input: GateInput): GateReport {
65
+ const checks: GateLine[] = [checkClosed(input.facts)];
66
+
67
+ const missing = missingDesignIds(input.plan);
68
+ checks.push(missing.length === 0
69
+ ? ok("design ids: all applied or non-applicable")
70
+ : fail(`design ids neither on an \`Applied rules\` row nor on \`Non-applicable rules\`:${missing.map((id) => ` ${id}`).join("")}`));
71
+
72
+ let outside: string[] = [];
73
+ if (input.roots.length === 0) {
74
+ checks.push(note("scope: the pack names no layout root, not checked"));
75
+ } else {
76
+ const roots = input.roots.join(" ");
77
+ outside = outsideFiles(input);
78
+ if (outside.length === 0) {
79
+ checks.push(ok(`scope: every changed file is under ${roots} or named by the sheet`));
80
+ } else {
81
+ checks.push(fail(`files changed outside ${roots} and absent from the sheet — name them under \`## Decisions\`, or restore them`));
82
+ for (const f of outside) checks.push(note(f));
83
+ }
84
+ }
85
+
86
+ let untested: string[] = [];
87
+ let stray: string[] = [];
88
+ if (input.trait === null) {
89
+ checks.push(note("rule traits: the pack has no tests.rule_trait, not checked"));
90
+ } else if (input.facts.ids.length === 0) {
91
+ checks.push(note("rule traits: the sheet's `## TDD sequence` names no BR-/UC-/CH- id, nothing to check"));
92
+ } else {
93
+ const hits = input.traitHits ?? [];
94
+ const carried = new Set(hits.flatMap(idsInMatch));
95
+ untested = input.facts.ids.filter((id) => !carried.has(id));
96
+ const shown = input.trait.shown;
97
+ checks.push(untested.length === 0
98
+ ? ok(`rule traits: every id of the sheet is carried by a test, ${shown}`)
99
+ : fail(`ids of the sheet's TDD sequence that no test carries as ${shown}:${untested.map((id) => ` ${id}`).join("")}`));
100
+ const known = knownIds(input.plan.all);
101
+ const cited = [...new Set(hits.flatMap((h) => h.match(/(BR|UC|CH)-[0-9]+/g) ?? []))].sort();
102
+ stray = cited.filter((id) => !known.has(id));
103
+ if (stray.length > 0) {
104
+ checks.push(note(`traits citing an id absent from ${input.planDirAbsolute}/*.md:${stray.map((id) => ` ${id}`).join("")}`));
105
+ }
106
+ }
107
+
108
+ checks.push(input.diffCheckExit === 0
109
+ ? ok("git diff --check: clean")
110
+ : fail("git diff --check reports trailing whitespace or conflict markers"));
111
+
112
+ const green = !checks.some((c) => c.kind === "FAIL");
113
+ const lines = [
114
+ `GATE — batch ${input.batch} — sheet ${input.sheetShown}`,
115
+ ...checks.map(gateLineText),
116
+ green ? `GATE — batch ${input.batch}: GREEN` : `GATE — batch ${input.batch}: RED — fix and run again, no audit before`,
117
+ ];
118
+ return { green, lines, checks, missingDesignIds: missing, outside, untested, stray };
119
+ }
120
+
121
+ /** " ok <t>", " FAIL <t>", " <t>" (AC:96-98). */
122
+ export function gateLineText(line: GateLine): string {
123
+ if (line.kind === "ok") return ` ok ${line.text}`;
124
+ if (line.kind === "FAIL") return ` FAIL ${line.text}`;
125
+ return ` ${line.text}`;
126
+ }