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,79 @@
1
+ // The change brief as code writes it: the harness's template (sections 1 to 8) with a section 9 of decisions, an
2
+ // empty section left out. § 1 (the origin, quoted) and the facts of § 2 (the reproduction or the measurement that
3
+ // ran) are code's and carried over from the file on a revision or a fold; the model adds its own facts after them.
4
+ // A criterion carries a `- **Statement**:` line first, which spec-format.ts reads for /dev-plan. Pure, no IO.
5
+ import { decisionTable, questionTable } from "../../../shared/domain/dev/questions.ts";
6
+ import type { Decision, Question } from "../../../shared/domain/dev/questions.ts";
7
+ import type { ChangeKind } from "../../../shared/domain/dev/spec-format.ts";
8
+ import { criterionId } from "./change-answer.ts";
9
+ import type { ChangeAnswer } from "./change-answer.ts";
10
+
11
+ export const changeFileName = (code: string): string => `CHANGE-${code}.md`;
12
+ export const reproFileName = (code: string): string => `repro-${code}.txt`;
13
+ export const CHANGE_QUESTIONS_SECTION = "## 8. Open questions";
14
+ export const CHANGE_DECISIONS_SECTION = "## 9. Decisions";
15
+ export const ORIGIN_HEADING = /^## 1\. Origin\s*$/;
16
+ export const EVIDENCE_HEADING = /^## 2\. Evidence\s*$/;
17
+ const MAX_ORIGIN_LINES = 12;
18
+
19
+ export interface ChangeRenderInput {
20
+ code: string; kind: ChangeKind; answer: ChangeAnswer;
21
+ /** The body of § 1 and the code's lines of § 2, as written (from the file, or built for a new brief). */
22
+ origin: readonly string[];
23
+ facts: readonly string[];
24
+ open: readonly Question[]; decisions: readonly Decision[];
25
+ }
26
+
27
+ const section = (heading: string, body: readonly string[]): string[] => (body.length === 0 ? [] : [heading, "", ...body, ""]);
28
+ const table = (header: readonly string[], rows: ReadonlyArray<readonly string[]>): string[] =>
29
+ rows.length === 0 ? [] : [
30
+ `| ${header.join(" | ")} |`, `|${header.map(() => "---").join("|")}|`,
31
+ ...rows.map((r) => `| ${r.map((c) => c || "—").join(" | ")} |`),
32
+ ];
33
+
34
+ /** The origin as § 1 quotes it: its first lines, each as a quote. */
35
+ export function originLines(text: string, from: string): string[] {
36
+ const lines = text.trim().split(/\r?\n/);
37
+ const shown = lines.slice(0, MAX_ORIGIN_LINES).map((l) => `> ${l}`.trimEnd());
38
+ if (lines.length > MAX_ORIGIN_LINES) shown.push(`> … (${lines.length - MAX_ORIGIN_LINES} more lines${from === "" ? "" : ` in ${from}`})`);
39
+ return from === "" ? shown : [`From ${from}:`, "", ...shown];
40
+ }
41
+
42
+ /** The body of the `## ` section whose heading matches, without its surrounding blank lines; [] when absent. */
43
+ export function sectionBody(text: string, heading: RegExp): string[] {
44
+ const out: string[] = [];
45
+ let inside = false;
46
+ for (const line of text.split(/\r?\n/)) {
47
+ if (line.startsWith("## ")) { if (inside) break; inside = heading.test(line); continue; }
48
+ if (inside) out.push(line);
49
+ }
50
+ while (out.length > 0 && out[0].trim() === "") out.shift();
51
+ while (out.length > 0 && out[out.length - 1].trim() === "") out.pop();
52
+ return out;
53
+ }
54
+
55
+ export function renderChange(input: ChangeRenderInput): string {
56
+ const a = input.answer;
57
+ const lines: string[] = [`# ${input.code} — ${a.name} — ${input.kind}`, ""];
58
+ if (a.summary !== "") lines.push(...a.summary.split(/\r?\n/).map((l) => `> ${l}`.trimEnd()), "");
59
+ lines.push(...section("## 1. Origin", input.origin));
60
+ const known = input.facts.join("\n");
61
+ const own = a.evidence.filter((e) => !known.includes(e)).map((e) => `- ${e}`);
62
+ const suspected = a.suspected === "" || known.includes(a.suspected) ? [] : [`- **Suspected cause** (suspected): ${a.suspected}`];
63
+ lines.push(...section("## 2. Evidence", [...input.facts, ...(input.facts.length > 0 && own.length + suspected.length > 0 ? [""] : []), ...own, ...suspected]));
64
+ lines.push("## 3. Acceptance", "");
65
+ a.criteria.forEach((c, i) => {
66
+ lines.push(`### ${criterionId(i)} — ${c.name}`, `- **Statement**: ${c.statement} · **Proof**: ${c.proof} · **Severity**: ${c.severity}`, "");
67
+ });
68
+ lines.push(...section("## 4. What must not change", table(
69
+ ["Behaviour", "Pinned by"], a.mustNotChange.map((r) => [r.behaviour, r.pinnedBy === "unpinned" ? "unpinned" : `\`${r.pinnedBy}\``]),
70
+ )));
71
+ lines.push(...section("## 5. Scope", table(["In", "Out"], a.scope.map((s) => [s.in, s.out]))));
72
+ lines.push(...section("## 6. Constraints", a.constraints.map((c) => `- ${c}`)));
73
+ lines.push(...section("## 7. Assumptions", table(
74
+ ["#", "Assumption", "To be validated by"], a.assumptions.map((r, i) => [`A${i + 1}`, r.assumption, r.validatedBy]),
75
+ )));
76
+ lines.push(...section(CHANGE_QUESTIONS_SECTION, questionTable(input.open)));
77
+ lines.push(...section(CHANGE_DECISIONS_SECTION, decisionTable(input.decisions)));
78
+ return `${lines.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
79
+ }
@@ -0,0 +1,183 @@
1
+ // The close of a batch the audit found VALID (`/dev-batches <code> F<n> --close`, or the chain
2
+ // after the audit): the last verdict of `<CODE>-VERIFY-F<n>.md` must be VALID, then the files the
3
+ // roles changed (touched.ts) are committed by name, pushed, and the pull request opened or handed
4
+ // over (shared/application/dev/close-batch.ts). Nothing is committed without that verdict. On the default
5
+ // branch, when the pack asks for a work branch, the close creates `<prefix>/<code>-f<n>` first. Once
6
+ // committed, the batch is marked done: the sheet's title and the global plan's batch (never committed,
7
+ // the work folder stays out of git).
8
+ import type { Files, Shell } from "../../../shared/application/ports.ts";
9
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
10
+ import type { PullRequestOpener } from "../../../shared/application/git/commit-files.ts";
11
+ import { runGit } from "../../../shared/application/git/commit-files.ts";
12
+ import { closeBatch } from "../../../shared/application/dev/close-batch.ts";
13
+ import type { WorkFolder } from "../../../shared/application/dev/resolve-work-folder.ts";
14
+ import { auditCommand, closeCommand, lastVerdict, parseVerdictFile } from "../../../shared/domain/dev/verdict-format.ts";
15
+ import { parseBatchSheet } from "../../../shared/domain/dev/plan-format.ts";
16
+ import type { RepoPack } from "../../../shared/domain/dev/repo-pack.ts";
17
+ import { DEV_PR_AUTO_CONFIG_KEY, GIT_CURRENT_BRANCH_COMMAND, GIT_DEFAULT_BRANCH_COMMAND, parseDefaultBranch } from "../../../shared/domain/git/close.ts";
18
+ import type { PrSummary } from "../../../shared/domain/git/close.ts";
19
+ import type { PermissionRule } from "../../../shared/domain/agent-policy/permission.ts";
20
+ import { under } from "../domain/step-checks.ts";
21
+ import { openSteps, parseImplementSheet } from "../domain/step-section.ts";
22
+ import { markPlanBatchDone, markSheetDone } from "../domain/sheet-edits.ts";
23
+ import { shellQuote, workBranchFromPattern } from "../../../shared/domain/git/close.ts";
24
+ import { verdictMarkOf } from "./touched.ts";
25
+ import type { LocatedSheet } from "./locate-sheet.ts";
26
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
27
+
28
+ export interface CloseInput {
29
+ pack: RepoPack;
30
+ work: WorkFolder;
31
+ located: LocatedSheet;
32
+ batch: string;
33
+ touched: string[];
34
+ /** The verdict file's mark when the touched list was last written (touched.ts). */
35
+ verdictMark: string | null;
36
+ openPr: boolean;
37
+ push: boolean;
38
+ /** The session's rules at the launch (a deny on the push keeps the commit local). */
39
+ rules?: readonly PermissionRule[];
40
+ /** Today, `YYYY-MM-DD`: the date of the done marks. */
41
+ today: string;
42
+ }
43
+
44
+ const LAYERS = ["domain", "application", "infrastructure", "tests"] as const;
45
+
46
+ /** The touched paths grouped by the pack's layout roots, the others last. */
47
+ export function layersOf(pack: RepoPack, touched: readonly string[]): PrSummary["layers"] {
48
+ const left = new Set(touched);
49
+ const out: PrSummary["layers"] = [];
50
+ for (const layer of LAYERS) {
51
+ const root = pack.layout[layer];
52
+ if (!root) continue;
53
+ const paths = [...left].filter((p) => under(p, root)).sort();
54
+ paths.forEach((p) => left.delete(p));
55
+ out.push({ layer, paths });
56
+ }
57
+ out.push({ layer: "other", paths: [...left].sort() });
58
+ return out;
59
+ }
60
+
61
+ async function prAuto(config: Pick<ConfigStore, "readValue">): Promise<boolean> {
62
+ try {
63
+ return (await config.readValue(DEV_PR_AUTO_CONFIG_KEY)).value?.trim() === "true";
64
+ } catch {
65
+ return false;
66
+ }
67
+ }
68
+
69
+ export async function closeDevBatch(
70
+ deps: { files: Files; shell: Shell; config: Pick<ConfigStore, "readValue">; opener?: PullRequestOpener },
71
+ input: CloseInput,
72
+ ): Promise<string[]> {
73
+ const { located, batch } = input;
74
+ const rerun = closeCommand(located.code, batch);
75
+ const verdictName = `${located.prefix}-VERIFY-${batch}.md`;
76
+ let verdictText: string;
77
+ try {
78
+ verdictText = await deps.files.read(`${WORKSPACE}/${located.dir}/${verdictName}`);
79
+ } catch {
80
+ return [`BLOCKED — close: no ${located.dir}/${verdictName}: the batch is audited first (${auditCommand(located.code, batch)})`];
81
+ }
82
+ const verdict = lastVerdict(parseVerdictFile(verdictText));
83
+ if (verdict?.verdict !== "VALID") {
84
+ return [`BLOCKED — close: the last verdict of ${verdictName} is ${verdict?.verdict ?? "missing"}, not VALID: nothing is committed`];
85
+ }
86
+ if (input.touched.length === 0) {
87
+ return [`BLOCKED — close: no file recorded for ${batch} (.orkeon/dev/${located.code}/implement-${batch}.json): commit the batch with /commit <files>`];
88
+ }
89
+ if (input.verdictMark === null || input.verdictMark === verdictMarkOf(verdictText)) {
90
+ return [`BLOCKED — close: ${verdictName} was not written since the last run of ${batch} changed the batch: audit it again (${auditCommand(located.code, batch)})`];
91
+ }
92
+ let sheetText: string;
93
+ try {
94
+ sheetText = await deps.files.read(`${WORKSPACE}/${located.dir}/${located.name}`);
95
+ } catch {
96
+ return [`BLOCKED — close: ${located.dir}/${located.name} cannot be read: nothing is committed`];
97
+ }
98
+ const open = openSteps(parseImplementSheet(sheetText)).map((s) => s.number);
99
+ if (open.length > 0) {
100
+ return [`BLOCKED — close: step ${open.join(", ")} of ${located.name} still has a TDD box open: /dev-batches ${located.code} ${batch} first`];
101
+ }
102
+
103
+ const current = await runGit(deps.shell, GIT_CURRENT_BRANCH_COMMAND);
104
+ const branch = current.exitCode === 0 ? current.stdout.trim() : "";
105
+ if (branch === "") return ["BLOCKED — close: no current branch (a detached HEAD?): check out the work branch, then " + rerun];
106
+ const base = await runGit(deps.shell, GIT_DEFAULT_BRANCH_COMMAND);
107
+ const defaultBranch = base.exitCode === 0 ? parseDefaultBranch(base.stdout) : null;
108
+ const wanted = input.pack.contrib.branch?.trim();
109
+ let onBranch = branch;
110
+ const notes: string[] = [];
111
+ if (wanted && defaultBranch !== null && branch === defaultBranch) {
112
+ const made = await createWorkBranch(deps.shell, wanted, located.code, batch);
113
+ if (!made.ok) return [`BLOCKED — close: ${branch} is the default branch and the pack asks for a work branch (${wanted}): ${made.reason}, then ${rerun}`];
114
+ onBranch = made.branch;
115
+ notes.push(`✓ branch ${made.branch} created from ${branch} (contrib.branch ${wanted})`);
116
+ }
117
+
118
+ const parsed = parseBatchSheet(sheetText);
119
+ const sheetName = parsed.name ?? located.name;
120
+ const message = `feat(${located.code}): ${sheetName} (batch ${batch})`;
121
+ const summary: PrSummary = {
122
+ batch: `${located.prefix} ${batch} — ${sheetName}, from \`${located.dir}/${located.name}\`.`,
123
+ layers: layersOf(input.pack, input.touched),
124
+ validations: verdict.validations,
125
+ assumptions: parsed.assumptions ?? [],
126
+ audit: `VALID${verdict.when ? ` (${verdict.when})` : ""}, \`${located.dir}/${verdictName}\`.`,
127
+ notRun: verdict.notRun.join("; "),
128
+ };
129
+ const result = await closeBatch(
130
+ { shell: deps.shell, files: deps.files, opener: deps.opener },
131
+ {
132
+ touched: input.touched, message, branch: onBranch, work: { folder: input.work.folder, vfsPath: input.work.vfsPath },
133
+ push: input.push, ...(input.rules === undefined ? {} : { rules: input.rules }), openPr: input.openPr || (await prAuto(deps.config)), summary, rerun,
134
+ },
135
+ );
136
+ if (!result.committed) return [...notes, ...result.lines];
137
+ return [...notes, ...result.lines, ...await markDone(deps.files, located, batch, sheetText, input.today)];
138
+ }
139
+
140
+ /** The work branch's name from the pack's pattern: its first alternative before `/`, then `<code>-f<n>`. */
141
+ export function workBranchName(pattern: string, code: string, batch: string): string | null {
142
+ return workBranchFromPattern(pattern, `${code}-${batch.toLowerCase()}`);
143
+ }
144
+
145
+ async function createWorkBranch(
146
+ shell: Pick<Shell, "run">, pattern: string, code: string, batch: string,
147
+ ): Promise<{ ok: true; branch: string } | { ok: false; reason: string }> {
148
+ const name = workBranchName(pattern, code, batch);
149
+ if (name === null) return { ok: false, reason: `no branch name can be made from '${pattern}' (<prefix>/<slug>): create it` };
150
+ const exists = await runGit(shell, `git rev-parse --verify --quiet ${shellQuote(`refs/heads/${name}`)}`);
151
+ if (exists.exitCode === 0) return { ok: false, reason: `the branch ${name} exists already: switch to it (git switch ${name})` };
152
+ const made = await runGit(shell, `git switch -c ${shellQuote(name)}`);
153
+ if (made.exitCode !== 0) {
154
+ return { ok: false, reason: `git switch -c ${name} failed (${(made.stderr || made.stdout).trim().split("\n")[0] || `exit ${made.exitCode}`}): create it` };
155
+ }
156
+ return { ok: true, branch: name };
157
+ }
158
+
159
+ /** The sheet's title and the global plan's batch marked done; a file that cannot be written is said. */
160
+ async function markDone(files: Files, located: LocatedSheet, batch: string, sheetText: string, today: string): Promise<string[]> {
161
+ const out: string[] = [];
162
+ const sheetPath = `${WORKSPACE}/${located.dir}/${located.name}`;
163
+ const planName = `${located.prefix}-PLAN.md`;
164
+ try {
165
+ const now = await files.read(sheetPath).catch(() => sheetText);
166
+ const marked = markSheetDone(now, today);
167
+ if (marked !== now) await files.write(sheetPath, marked);
168
+ out.push(`✓ ${located.name} marked done (${today})`);
169
+ } catch (e) {
170
+ out.push(`⚠ ${located.name} could not be marked done: ${String((e as Error)?.message ?? e).split("\n")[0]}`);
171
+ }
172
+ try {
173
+ const plan = await files.read(`${WORKSPACE}/${located.dir}/${planName}`);
174
+ const marked = markPlanBatchDone(plan, batch, today);
175
+ if (marked !== plan) {
176
+ await files.write(`${WORKSPACE}/${located.dir}/${planName}`, marked);
177
+ out.push(`✓ ${planName}: batch ${batch} marked done`);
178
+ }
179
+ } catch {
180
+ out.push(`⚠ ${planName} not found beside the sheet: its batch ${batch} is not marked done`);
181
+ }
182
+ return out;
183
+ }
@@ -0,0 +1,24 @@
1
+ // The open steps of the batch sheet a dev-implement run will take, counted before the crew starts so
2
+ // that its budget is sized to them (implement-budget.ts). Undefined when the sheet cannot be found or
3
+ // read: the crew then sizes for the default, and its own run says what is wrong.
4
+ import type { Files, Shell } from "../../../shared/application/ports.ts";
5
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
6
+ import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
7
+ import { openSteps, parseImplementSheet } from "../domain/step-section.ts";
8
+ import { locateSheet } from "./locate-sheet.ts";
9
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
10
+
11
+ export async function countOpenSteps(
12
+ deps: { files: Files; shell: Shell; config: Pick<ConfigStore, "readValue"> },
13
+ batch: string, plan: string | null,
14
+ ): Promise<number | undefined> {
15
+ try {
16
+ const context = await loadDevContext(deps);
17
+ const located = await locateSheet(deps.files, context.work.folder, batch, plan);
18
+ if (typeof located === "string") return undefined;
19
+ const sheet = parseImplementSheet(await deps.files.read(`${WORKSPACE}/${located.dir}/${located.name}`));
20
+ return sheet.problems.length > 0 ? undefined : openSteps(sheet).length;
21
+ } catch {
22
+ return undefined;
23
+ }
24
+ }
@@ -0,0 +1,80 @@
1
+ // The batch sheet the command names: by its code (`<work>/<code>/<CODE>-PLAN-F<n>.md`), by the path
2
+ // of its global plan (the sheet beside it), or, with neither, the one sheet of that batch under the
3
+ // work folder. Paths are relative to /workspace.
4
+ import type { Files } from "../../../shared/application/ports.ts";
5
+ import { classifyArtefact, isCode } from "../../../shared/domain/dev/artefacts.ts";
6
+ import { WORKSPACE, workspaceRelative } from "../../../shared/domain/vfs.ts";
7
+
8
+ const ENTRIES_PROBED = 50;
9
+ const LIST_CAP = 500;
10
+
11
+ export interface LocatedSheet {
12
+ /** Folder of the plan, relative to /workspace, e.g. `workbench/prune`. */
13
+ dir: string;
14
+ name: string;
15
+ prefix: string;
16
+ /** The code: the plan folder's own name. */
17
+ code: string;
18
+ }
19
+
20
+ const bare = (entry: string): string => entry.replace(/\/+$/, "");
21
+ const byName = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0);
22
+
23
+ async function listOrEmpty(files: Pick<Files, "list">, path: string): Promise<string[]> {
24
+ try {
25
+ return (await files.list(path, LIST_CAP)).map(bare).sort(byName);
26
+ } catch {
27
+ return [];
28
+ }
29
+ }
30
+
31
+ function located(dir: string, name: string, prefix: string): LocatedSheet {
32
+ return { dir, name, prefix, code: dir.slice(dir.lastIndexOf("/") + 1) };
33
+ }
34
+
35
+ async function sheetsIn(files: Pick<Files, "list">, dir: string, batch: string): Promise<LocatedSheet[]> {
36
+ const out: LocatedSheet[] = [];
37
+ for (const name of await listOrEmpty(files, `${WORKSPACE}/${dir}`)) {
38
+ const a = classifyArtefact(name);
39
+ if (a !== null && a.kind === "sheet" && a.batch === batch) out.push(located(dir, name, a.prefix));
40
+ }
41
+ return out;
42
+ }
43
+
44
+ function several(batch: string, sheets: readonly LocatedSheet[]): string {
45
+ return `several sheets for ${batch}: ${sheets.map((s) => `${s.dir}/${s.name}`).join(", ")}: name the plan, e.g. /dev-batches <code> ${batch}`;
46
+ }
47
+
48
+ /** The sheet, or why none is found. */
49
+ export async function locateSheet(
50
+ files: Pick<Files, "read" | "list">, work: string, batch: string, plan: string | null,
51
+ ): Promise<LocatedSheet | string> {
52
+ if (plan === null) {
53
+ const found: LocatedSheet[] = [];
54
+ for (const entry of (await listOrEmpty(files, `${WORKSPACE}/${work}`)).slice(0, ENTRIES_PROBED)) {
55
+ found.push(...(await sheetsIn(files, `${work}/${entry}`, batch)));
56
+ }
57
+ if (found.length === 0) return `no ${work}/*/*-PLAN-${batch}.md: name the plan, e.g. /dev-batches <code> ${batch}`;
58
+ return found.length === 1 ? found[0] : several(batch, found);
59
+ }
60
+ if (isCode(plan)) {
61
+ const found = await sheetsIn(files, `${work}/${plan}`, batch);
62
+ if (found.length === 0) return `${work}/${plan}/ holds no *-PLAN-${batch}.md`;
63
+ if (found.length === 1) return found[0];
64
+ const named = found.filter((s) => s.prefix === plan.toUpperCase());
65
+ return named.length === 1 ? named[0] : several(batch, found);
66
+ }
67
+ const neither = `'${plan}' is neither a code nor a <CODE>-PLAN.md path`;
68
+ const relative = workspaceRelative(plan);
69
+ const slash = relative.lastIndexOf("/");
70
+ if (relative.startsWith("/") || relative.split("/").includes("..") || slash <= 0) return neither;
71
+ const classified = classifyArtefact(relative.slice(slash + 1));
72
+ if (classified === null || classified.kind !== "plan") return neither;
73
+ const sheet = located(relative.slice(0, slash), `${classified.prefix}-PLAN-${batch}.md`, classified.prefix);
74
+ try {
75
+ await files.read(`${WORKSPACE}/${sheet.dir}/${sheet.name}`, 1);
76
+ } catch {
77
+ return `no ${sheet.dir}/${sheet.name} beside ${relative}`;
78
+ }
79
+ return sheet;
80
+ }
@@ -0,0 +1,50 @@
1
+ // What code sees of the tree between two acts: every path git reports changed or untracked, each
2
+ // with a hash of its content read through Files, so that a second write to a file already dirty
3
+ // is seen too. The checks of domain/step-checks.ts compare two of these.
4
+ import type { Files, Shell } from "../../../shared/application/ports.ts";
5
+ import { statusPaths } from "../domain/step-checks.ts";
6
+ import type { Snapshot } from "../domain/step-checks.ts";
7
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
8
+
9
+ export const STATUS_COMMAND = "git status --porcelain=v1 --untracked-files=all";
10
+ /** The paths one snapshot reads; past this, it keeps the paths alone (unread), and a role's change is known
11
+ * from the paths its write tools named. */
12
+ export const MAX_SNAPSHOT_PATHS = 200;
13
+ const MAX_READ_CHARS = 2_000_000;
14
+ const ABSENT = "absent";
15
+
16
+ /** FNV-1a over the text, with its length: enough to tell two contents of one file apart. */
17
+ export function contentHash(text: string): string {
18
+ let h = 0x811c9dc5;
19
+ for (let i = 0; i < text.length; i++) {
20
+ h ^= text.charCodeAt(i);
21
+ h = Math.imul(h, 0x01000193) >>> 0;
22
+ }
23
+ return `${text.length}:${h.toString(16)}`;
24
+ }
25
+
26
+ export type Observed = { ok: true; snapshot: Snapshot } | { ok: false; problem: string };
27
+
28
+ export async function snapshot(deps: { shell: Pick<Shell, "run">; files: Pick<Files, "read"> }): Promise<Observed> {
29
+ let status;
30
+ try {
31
+ status = await deps.shell.run(STATUS_COMMAND);
32
+ } catch (e) {
33
+ return { ok: false, problem: `${STATUS_COMMAND} could not run: ${String((e as Error)?.message ?? e).split("\n")[0]}` };
34
+ }
35
+ if (status.exitCode !== 0) return { ok: false, problem: `${STATUS_COMMAND} exited ${status.exitCode}` };
36
+ const paths = statusPaths(status.stdout);
37
+ const out = new Map<string, string | null>();
38
+ if (paths.length > MAX_SNAPSHOT_PATHS) {
39
+ for (const path of paths) out.set(path, null);
40
+ return { ok: true, snapshot: out };
41
+ }
42
+ for (const path of paths) {
43
+ try {
44
+ out.set(path, contentHash(await deps.files.read(`${WORKSPACE}/${path}`, MAX_READ_CHARS)));
45
+ } catch (e) {
46
+ out.set(path, /not found/i.test(String((e as Error)?.message ?? e)) ? ABSENT : null);
47
+ }
48
+ }
49
+ return { ok: true, snapshot: out };
50
+ }
@@ -0,0 +1,41 @@
1
+ // The paths a role's write tools name, heard from its callbacks: a call of a file editor or a node editor
2
+ // the callbacks let through reports its `path`, and an edit_batch the path of each operation, so code
3
+ // tells a role's own changes from what its runs of run_tests or run_build left in the tree. The verdicts
4
+ // themselves are unchanged.
5
+ import { sameToolName } from "../../../shared/domain/agent-policy/permission.ts";
6
+
7
+ type Call = { name: string; input: unknown };
8
+ interface ActLike { onToolCall(call: Call): Promise<unknown> }
9
+ interface CallbacksLike { forAct(mode: string, gateEnabled: boolean | undefined): ActLike }
10
+
11
+ export const WRITE_TOOLS: readonly string[] = ["file_write", "edit_file", "node_replace", "node_insert", "node_ensure"];
12
+ export const BATCH_TOOL = "edit_batch";
13
+
14
+ /** The paths a write call names: its `path`, or each operation's of an edit_batch. */
15
+ export function writtenPaths(name: string, input: unknown): string[] {
16
+ const args = input as { path?: unknown; operations?: unknown } | null;
17
+ if (WRITE_TOOLS.some((t) => sameToolName(t, name))) return typeof args?.path === "string" ? [args.path] : [];
18
+ if (!sameToolName(name, BATCH_TOOL) || !Array.isArray(args?.operations)) return [];
19
+ return args.operations.flatMap((op: unknown) => {
20
+ const path = (op as { path?: unknown } | null)?.path;
21
+ return typeof path === "string" ? [path] : [];
22
+ });
23
+ }
24
+
25
+ /** The same callbacks, whose act callbacks also report each write they allow. */
26
+ export function reportingWrites<C extends CallbacksLike>(callbacks: C, wrote: (path: string) => void): C {
27
+ return {
28
+ ...callbacks,
29
+ forAct(mode: string, gateEnabled: boolean | undefined) {
30
+ const inner = callbacks.forAct(mode, gateEnabled);
31
+ return {
32
+ ...inner,
33
+ async onToolCall(call: Call) {
34
+ const verdict = await inner.onToolCall(call);
35
+ if (verdict === "allow") writtenPaths(call.name, call.input).forEach(wrote);
36
+ return verdict;
37
+ },
38
+ };
39
+ },
40
+ } as C;
41
+ }