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,31 @@
1
+ // The adversarial reviewer's charter: a read-only sub-agent in plan mode with ten read tools — files,
2
+ // their nodes, folders, a file pattern lookup (glob, which the cut project list names), the code index, a
3
+ // structural pattern search and its impact view — and no shell,
4
+ // no write and no index build. It lives in the shared domain because more than one
5
+ // crew reviews (a plan now; a specification, a change brief and the next batch later).
6
+
7
+ import type { Charter } from "../agents/charter.ts";
8
+
9
+ export const REVIEWER_TOOLS: readonly string[] = [
10
+ "file_read", "node_outline", "node_read", "directory_read", "glob", "codebase_search", "structural_search",
11
+ "symbol_source", "symbol_detail", "impact_analysis",
12
+ ];
13
+
14
+ export const REVIEWER_CHARTER: Charter = {
15
+ name: "dev-reviewer",
16
+ role: "Adversarial reviewer",
17
+ goal: "Find what a plan, a specification or a change brief leaves undecided, and ask it as closed questions",
18
+ mode: "plan",
19
+ tools: REVIEWER_TOOLS,
20
+ disallowed: ["shell_command", "file_write", "rag_ingest", "index_codebase"],
21
+ maxIterations: 20,
22
+ };
23
+
24
+ /** The review of the next batch of /dev-batches: its brief carries the batch's sheet and what the closed batches
25
+ * changed, so five read tools and eight turns are enough (a plan's review keeps the ten and its twenty); glob is one
26
+ * of them, since its brief lists the project's files and a cut list sends the reader to it. */
27
+ export const NEXT_BATCH_REVIEWER_CHARTER: Charter = {
28
+ ...REVIEWER_CHARTER,
29
+ tools: ["file_read", "node_outline", "node_read", "glob", "codebase_search"],
30
+ maxIterations: 8,
31
+ };
@@ -0,0 +1,83 @@
1
+ // The facts the gate and the mechanical table read off one batch sheet: the ids of its
2
+ // `## TDD sequence`, the test methods of its step tables, its `Applied rules` row and its
3
+ // `TDD:` lines. Line-based, as the harness's greps read the file. Pure.
4
+ import { SHEET_ID_SOURCE } from "./trait-pattern.ts";
5
+
6
+ export interface SheetFacts {
7
+ ids: string[]; // ids of `## TDD sequence`, sorted, unique (AC:166)
8
+ methods: string[]; // step-table Test methods, first-seen order, unique (AC:380-388)
9
+ appliedRulesRow: string | null; // the first line matching /^\| *Applied rules *\|/ (AC:450)
10
+ appliedIds: string[]; // /\b[A-Z]+-[0-9]+\b/ after "Applied rules", first-seen order (AC:454)
11
+ tickedLines: number; // lines holding "TDD: RED [x] GREEN [x] COST [x]" (AC:448)
12
+ closed: boolean; // check 1 (AC:119)
13
+ }
14
+
15
+ const TICKED = "TDD: RED [x] GREEN [x] COST [x]";
16
+ const OPEN_BOX = /(RED|GREEN|COST) \[ \]/;
17
+ const APPLIED_ROW = /^\| *Applied rules *\|/;
18
+ const SEPARATOR_ROW = /^\|[-: |]+$/;
19
+ const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
20
+
21
+ function unique(values: Iterable<string>): string[] {
22
+ return [...new Set(values)];
23
+ }
24
+
25
+ /** The lines of the `## TDD sequence` section, heading excluded; it ends at the next `## ` heading. */
26
+ function tddSection(lines: readonly string[]): string[] {
27
+ const out: string[] = [];
28
+ let inside = false;
29
+ for (const l of lines) {
30
+ if (l.startsWith("## TDD sequence")) { inside = true; continue; }
31
+ if (l.startsWith("## ")) inside = false;
32
+ if (inside) out.push(l);
33
+ }
34
+ return out;
35
+ }
36
+
37
+ /** The method of one Test cell: the first backticked text, call and class cut; null when none. */
38
+ function methodOf(cell: string): string | null {
39
+ const open = cell.indexOf("`");
40
+ if (open < 0) return null;
41
+ let v = cell.slice(open + 1);
42
+ const close = v.indexOf("`");
43
+ if (close >= 0) v = v.slice(0, close);
44
+ const paren = v.indexOf("(");
45
+ if (paren >= 0) v = v.slice(0, paren);
46
+ if (/[<>]/.test(v)) return null;
47
+ const last = v.split(".").at(-1) ?? "";
48
+ return IDENTIFIER.test(last) ? last : null;
49
+ }
50
+
51
+ function stepMethods(section: readonly string[]): string[] {
52
+ const methods: string[] = [];
53
+ let column = 0;
54
+ for (const l of section) {
55
+ if (!l.startsWith("|")) { column = 0; continue; }
56
+ if (SEPARATOR_ROW.test(l)) continue;
57
+ const cells = l.split("|");
58
+ if (column === 0) {
59
+ for (let i = 1; i < cells.length - 1; i++) if (cells[i].trim() === "Test") column = i;
60
+ continue;
61
+ }
62
+ const method = methodOf(cells[column] ?? "");
63
+ if (method !== null) methods.push(method);
64
+ }
65
+ return unique(methods);
66
+ }
67
+
68
+ export function sheetFacts(sheet: string): SheetFacts {
69
+ const lines = sheet.split("\n");
70
+ const section = tddSection(lines);
71
+ const ids = unique(section.flatMap((l) => l.match(new RegExp(SHEET_ID_SOURCE, "g")) ?? [])).sort();
72
+ const appliedRulesRow = lines.find((l) => APPLIED_ROW.test(l)) ?? null;
73
+ const afterLabel = appliedRulesRow === null ? "" : appliedRulesRow.slice(appliedRulesRow.indexOf("Applied rules") + "Applied rules".length);
74
+ const tickedLines = lines.filter((l) => l.includes(TICKED)).length;
75
+ return {
76
+ ids,
77
+ methods: stepMethods(section),
78
+ appliedRulesRow,
79
+ appliedIds: unique(afterLabel.match(/\b[A-Z]+-[0-9]+\b/g) ?? []),
80
+ tickedLines,
81
+ closed: tickedLines > 0 && !lines.some((l) => OPEN_BOX.test(l)),
82
+ };
83
+ }
@@ -0,0 +1,183 @@
1
+ // The source of a plan: a spec (`SPEC-<code>.md`) or a change brief (`CHANGE-<code>.md`),
2
+ // read line by line - its title, its UC/BR/CH ids, its open questions and, for a brief,
3
+ // what must not change - and the Blocking gate that stops a plan while an open question
4
+ // is Blocking. Pure, no IO, never throws: what does not match becomes a FormatProblem.
5
+ // The gate keeps the harness's own line test and adds a reading by the Severity column,
6
+ // so it is never less strict than the harness.
7
+ import type { FormatProblem } from "./plan-format.ts";
8
+
9
+ export type SourceKind = "spec" | "change";
10
+ export type ChangeKind = "bug" | "refactor" | "perf";
11
+ export interface SourceId { id: string; title: string; statement: string; line: number } // statement "" when none
12
+ export interface OpenQuestion { line: number; raw: string; severity: string; cells: string[] }
13
+ export interface MustNotChangeRow { line: number; behaviour: string; pinnedBy: string | null } // null: unpinned
14
+ export interface PlanSource {
15
+ kind: SourceKind;
16
+ code?: string; name?: string; changeKind?: ChangeKind; // from the title line
17
+ ids: SourceId[]; // UC, then BR, then CH, each by number
18
+ openQuestions: OpenQuestion[];
19
+ blocking: OpenQuestion[]; // the gate's rows
20
+ mustNotChange: MustNotChangeRow[]; // change brief only
21
+ problems: FormatProblem[];
22
+ }
23
+
24
+ const OPEN_QUESTIONS = /^## .*Open questions/;
25
+ const MUST_NOT_CHANGE = /^## (\d+\. )?What must not change/;
26
+ const BLOCKING_CELL = /\| *Blocking *\|/;
27
+ const SEPARATOR_ROW = /^\|?[-: |]+$/;
28
+ const ID_HEADING = /^#{3,4} (UC|BR|CH)-(\d+)\s*[—:-]\s*(.+)$/;
29
+ const SPEC_TITLE = /^# (\S+) — (.+)$/;
30
+ const BRIEF_TITLE = /^# (\S+) — (.+) — (bug|refactor|perf)\s*$/;
31
+ const STATEMENT = "**Statement**";
32
+ const MAX_STATEMENT = 200;
33
+ const MAX_SHOWN_ROW = 200;
34
+ const MAX_SHOWN_ROWS = 8;
35
+ const FAMILY_ORDER = ["UC", "BR", "CH"];
36
+
37
+ const linesOf = (text: string): string[] => text.split(/\r?\n/);
38
+ const isTableRow = (line: string): boolean => line.includes("|");
39
+
40
+ function cellsOf(row: string): string[] {
41
+ return row.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
42
+ }
43
+
44
+ /** A severity or a pinned-by cell with its emphasis and code marks removed. */
45
+ const plain = (cell: string): string => cell.replace(/[*_`]/g, "").trim();
46
+
47
+ /** The lines of each `## ` section whose heading matches, numbered from 1, heading excluded. */
48
+ function sectionLines(lines: readonly string[], heading: RegExp): Array<{ text: string; line: number }> {
49
+ const out: Array<{ text: string; line: number }> = [];
50
+ let inside = false;
51
+ lines.forEach((text, i) => {
52
+ if (text.startsWith("## ")) { inside = heading.test(text); return; }
53
+ if (inside) out.push({ text, line: i + 1 });
54
+ });
55
+ return out;
56
+ }
57
+
58
+ interface TableRow { text: string; line: number; cells: string[]; header: string[] }
59
+
60
+ /** The data rows of the tables of a section, each with its table's header cells. */
61
+ function tableRows(section: ReadonlyArray<{ text: string; line: number }>): TableRow[] {
62
+ const out: TableRow[] = [];
63
+ let header: string[] | null = null;
64
+ for (const { text, line } of section) {
65
+ if (!isTableRow(text)) { header = null; continue; }
66
+ if (SEPARATOR_ROW.test(text.trim())) continue;
67
+ const cells = cellsOf(text);
68
+ if (header === null) { header = cells; continue; }
69
+ out.push({ text, line, cells, header });
70
+ }
71
+ return out;
72
+ }
73
+
74
+ function openQuestions(lines: readonly string[]): OpenQuestion[] {
75
+ return tableRows(sectionLines(lines, OPEN_QUESTIONS)).map((r) => {
76
+ const column = r.header.indexOf("Severity");
77
+ return { line: r.line, raw: r.text, severity: column >= 0 ? (r.cells[column] ?? "") : "", cells: r.cells };
78
+ });
79
+ }
80
+
81
+ /** The gate alone, run before any other read: the raw lines that stop a plan. */
82
+ export function blockingRows(text: string): OpenQuestion[] {
83
+ const lines = linesOf(text);
84
+ const section = sectionLines(lines, OPEN_QUESTIONS);
85
+ const bySeverity = new Map<number, OpenQuestion>();
86
+ for (const q of openQuestions(lines)) if (plain(q.severity).toLowerCase() === "blocking") bySeverity.set(q.line, q);
87
+ const out: OpenQuestion[] = [];
88
+ for (const { text: raw, line } of section) {
89
+ const counted = bySeverity.get(line);
90
+ if (counted !== undefined) { out.push(counted); continue; }
91
+ if (BLOCKING_CELL.test(raw)) out.push({ line, raw, severity: "Blocking", cells: cellsOf(raw) });
92
+ }
93
+ return out;
94
+ }
95
+
96
+ function statementOf(lines: readonly string[], from: number): string {
97
+ for (const l of lines.slice(from)) {
98
+ if (l.startsWith("#")) return "";
99
+ const t = l.trim();
100
+ if (!/^[-*] /.test(t)) continue;
101
+ const at = t.indexOf(STATEMENT);
102
+ if (at < 0) return "";
103
+ let s = t.slice(at + STATEMENT.length).replace(/^[\s:*]+/, "");
104
+ for (const stop of [" · ", " **"]) {
105
+ const cut = s.indexOf(stop);
106
+ if (cut >= 0) s = s.slice(0, cut);
107
+ }
108
+ return s.trim().slice(0, MAX_STATEMENT);
109
+ }
110
+ return "";
111
+ }
112
+
113
+ function readIds(lines: readonly string[], kind: SourceKind, problems: FormatProblem[]): SourceId[] {
114
+ const seen = new Set<string>();
115
+ const ids: SourceId[] = [];
116
+ lines.forEach((text, i) => {
117
+ const m = ID_HEADING.exec(text);
118
+ if (!m) return;
119
+ const id = `${m[1]}-${m[2]}`;
120
+ const line = i + 1;
121
+ if (seen.has(id)) { problems.push({ line, message: `duplicated id ${id}` }); return; }
122
+ seen.add(id);
123
+ if (kind === "change" && m[1] !== "CH") { problems.push({ line, message: `${id} in a change brief` }); return; }
124
+ if (kind === "spec" && m[1] === "CH") return;
125
+ ids.push({ id, title: m[3].trim(), statement: statementOf(lines, i + 1), line });
126
+ });
127
+ const rank = (s: SourceId): [number, number] => [FAMILY_ORDER.indexOf(s.id.split("-")[0]), Number(s.id.split("-")[1])];
128
+ return ids.sort((a, b) => {
129
+ const [fa, na] = rank(a);
130
+ const [fb, nb] = rank(b);
131
+ return fa !== fb ? fa - fb : na - nb;
132
+ });
133
+ }
134
+
135
+ function mustNotChange(lines: readonly string[]): MustNotChangeRow[] {
136
+ const out: MustNotChangeRow[] = [];
137
+ for (const r of tableRows(sectionLines(lines, MUST_NOT_CHANGE))) {
138
+ const behaviour = r.header.indexOf("Behaviour");
139
+ const pinned = r.header.indexOf("Pinned by");
140
+ if (behaviour < 0 || pinned < 0) continue;
141
+ const by = (r.cells[pinned] ?? "").replace(/`/g, "").trim();
142
+ out.push({ line: r.line, behaviour: (r.cells[behaviour] ?? "").trim(), pinnedBy: by.toLowerCase() === "unpinned" ? null : by });
143
+ }
144
+ return out;
145
+ }
146
+
147
+ export function parsePlanSource(text: string, kind: SourceKind): PlanSource {
148
+ const lines = linesOf(text);
149
+ const problems: FormatProblem[] = [];
150
+ const source: PlanSource = {
151
+ kind, ids: [], openQuestions: openQuestions(lines), blocking: blockingRows(text), mustNotChange: [], problems,
152
+ };
153
+ const titleIndex = lines.findIndex((l) => l.startsWith("# "));
154
+ if (titleIndex >= 0) {
155
+ const t = lines[titleIndex].trimEnd();
156
+ const brief = kind === "change" ? BRIEF_TITLE.exec(t) : null;
157
+ const plainTitle = SPEC_TITLE.exec(t);
158
+ if (brief) {
159
+ source.code = brief[1]; source.name = brief[2]; source.changeKind = brief[3] as ChangeKind;
160
+ } else if (plainTitle) {
161
+ source.code = plainTitle[1]; source.name = plainTitle[2];
162
+ }
163
+ if (kind === "change" && !brief) {
164
+ problems.push({ line: titleIndex + 1, message: "the brief's title names no kind (bug, refactor or perf)" });
165
+ }
166
+ }
167
+ source.ids = readIds(lines, kind, problems);
168
+ if (kind === "change") source.mustNotChange = mustNotChange(lines);
169
+ return source;
170
+ }
171
+
172
+ /** The stop message: the rows, then the next command. Pure text, shared by the command and the crew. */
173
+ export function blockingStop(shown: string, kind: SourceKind, code: string, rows: readonly OpenQuestion[]): string {
174
+ const settle = "/dev-spec";
175
+ const shownRows = rows.slice(0, MAX_SHOWN_ROWS).map((r) => ` ${r.raw.trim().slice(0, MAX_SHOWN_ROW)}`);
176
+ const more = rows.length > MAX_SHOWN_ROWS ? [` … ${rows.length - MAX_SHOWN_ROWS} more`] : [];
177
+ return [
178
+ `dev-plan: ${shown} has ${rows.length} open Blocking question(s); no plan is written.`,
179
+ ...shownRows,
180
+ ...more,
181
+ `→ Settle them first: ${settle} ${code}${kind === "change" ? " <its kind: bug, refactor or perf>" : ""}, or edit the file; then /dev-plan ${code}.`,
182
+ ].join("\n");
183
+ }
@@ -0,0 +1,72 @@
1
+ // The budget of each dev step crew, sized to one unit (temp/02 G-29: never one long turn, a chain
2
+ // of short steps over a state file), and the reader of the runtime's refusal when one is spent. A
3
+ // spent budget throws BudgetExhaustedError with its `dimension`; once an agent's act turned it into
4
+ // a plain failure, only its message is left, and the runtime's messages name the dimension
5
+ // (AgentExecutionBudget.cs). Pure.
6
+
7
+ export type BudgetDimension = "toolCalls" | "delegationDepth" | "wallTime" | "tokens" | "spawnedAgents";
8
+
9
+ export interface StepBudget {
10
+ toolCalls: number;
11
+ /** Seconds. */
12
+ wallTime: number;
13
+ /** The context counted once (Orkeon #224): each call's completion plus what its prompt grew by, or the part the
14
+ * provider's cache did not serve; a spent one is reported on the `tokens` dimension, as the running sum is. */
15
+ contextTokens: number;
16
+ delegationDepth: number;
17
+ }
18
+
19
+ /**
20
+ * The context a tool call adds, rounded up: a live audit of a 3-file batch grew by about 3 300 tokens a call (its
21
+ * result and the model's turn around it). The context counted once (Orkeon #224) charges each call its completion
22
+ * plus that growth, so a step sizes its context tokens from its calls, and the tool calls stay the limit it meets
23
+ * first.
24
+ */
25
+ export const TOKENS_PER_CALL = 3_500;
26
+
27
+ /**
28
+ * dev-verify: under full, the build (900 s), the whole suite (900 s) and three validations (300 s
29
+ * each), whether code or run_validation runs them, plus the auditor's own time; its 200 calls ask for
30
+ * 700 000 context tokens. dev-plan: the inventory's index queries, the planner and the reviewer, whose calls count
31
+ * against the step's (A-3 Q3): 240 calls ask for 840 000 context tokens. delegationDepth 1: the reviewer and the
32
+ * auditor run as background children of the step's agent (A-3), one level down, never deeper. dev-spec and
33
+ * dev-change: the inventory (about 40 index calls), three extract calls, the reproduction (600 s at most) and one
34
+ * review of 20 iterations, by the reviewer as a background child whose calls count against the step's
35
+ * (delegationDepth 1, as dev-plan): 200 calls ask for 700 000 context tokens; the wall time
36
+ * counts the time a person takes to answer the questions, hence an hour.
37
+ */
38
+ export const STEP_BUDGETS: Readonly<Record<"dev-verify" | "dev-plan" | "dev-spec" | "dev-change", StepBudget>> = {
39
+ "dev-verify": { toolCalls: 200, wallTime: 3600, contextTokens: 200 * TOKENS_PER_CALL, delegationDepth: 1 },
40
+ "dev-plan": { toolCalls: 240, wallTime: 1800, contextTokens: 240 * TOKENS_PER_CALL, delegationDepth: 1 },
41
+ "dev-spec": { toolCalls: 200, wallTime: 3600, contextTokens: 200 * TOKENS_PER_CALL, delegationDepth: 1 },
42
+ "dev-change": { toolCalls: 200, wallTime: 3600, contextTokens: 200 * TOKENS_PER_CALL, delegationDepth: 1 },
43
+ };
44
+
45
+ /** The budget of a repair by a new run (/tasks repair, crew agent-run): the step's own that runs the charter as a
46
+ * child, so that a repaired audit or review stops where the original would; no child of its own. */
47
+ export function repairBudget(step: keyof typeof STEP_BUDGETS): StepBudget {
48
+ return { ...STEP_BUDGETS[step], delegationDepth: 0 };
49
+ }
50
+
51
+ const DIMENSIONS: readonly BudgetDimension[] = ["toolCalls", "delegationDepth", "wallTime", "tokens", "spawnedAgents"];
52
+
53
+ /** The runtime's messages, by dimension. */
54
+ const MESSAGES: ReadonlyArray<[BudgetDimension, RegExp]> = [
55
+ ["toolCalls", /exceeded \d+ tool calls|tool-call budget exhausted/i],
56
+ ["tokens", /token budget exhausted/i],
57
+ ["wallTime", /wall time exceeded/i],
58
+ ["delegationDepth", /delegation depth \d+ exceeds max/i],
59
+ ["spawnedAgents", /exceeded \d+ spawned sub-agents/i],
60
+ ];
61
+
62
+ /** The dimension a spent budget names: the error's own `dimension`, else its message; null for any other failure. */
63
+ export function readBudgetExhausted(failure: unknown): BudgetDimension | null {
64
+ if (failure !== null && typeof failure === "object") {
65
+ const dimension = (failure as { dimension?: unknown }).dimension;
66
+ if (typeof dimension === "string" && (DIMENSIONS as readonly string[]).includes(dimension)) {
67
+ return dimension as BudgetDimension;
68
+ }
69
+ }
70
+ const text = failure instanceof Error ? failure.message : typeof failure === "string" ? failure : "";
71
+ return MESSAGES.find(([, pattern]) => pattern.test(text))?.[0] ?? null;
72
+ }
@@ -0,0 +1,110 @@
1
+ // Which rule sets each dev step puts in the gate before its crew runs (and its crew's callback checks
2
+ // again, call-guard.ts), the rules of a role on the repository pack's roots, and what a step does when
3
+ // the host's gate is off — pure, no IO.
4
+ import { pathRules, patternWriteRules, rewriteRules, rulesOf } from "../agent-policy/rule-sets.ts";
5
+ import type { PathRules, RuleSetId } from "../agent-policy/rule-sets.ts";
6
+ import type { PermissionRule } from "../agent-policy/permission.ts";
7
+ import type { RepoPackLayout } from "./repo-pack.ts";
8
+
9
+ /** A dev step whose crew runs a model under the gate and its callback. */
10
+ export type DevStep = "dev-verify" | "dev-plan" | "dev-spec" | "dev-change" | "dev-implement";
11
+ export const DEV_STEPS: readonly DevStep[] = ["dev-verify", "dev-plan", "dev-spec", "dev-change", "dev-implement"];
12
+
13
+ /** The command a step runs under, named where a line tells the person what to type: a change brief is /dev-spec with
14
+ * a kind, a batch and its audit are shapes of /dev-batches. Any other name is a command already. */
15
+ export function stepCommand(step: string): string {
16
+ if (step === "dev-change") return "dev-spec";
17
+ return step === "dev-implement" || step === "dev-verify" ? "dev-batches" : step;
18
+ }
19
+
20
+ /** The sets every dev step holds today. */
21
+ export const DEV_STEP_RULE_SETS: readonly RuleSetId[] = [
22
+ "git-readonly", "inline-interpreters", "read-noise", "secrets", "state-files",
23
+ ];
24
+ export const STEP_RULE_SETS: Readonly<Record<DevStep, readonly RuleSetId[]>> = {
25
+ "dev-verify": DEV_STEP_RULE_SETS,
26
+ "dev-plan": DEV_STEP_RULE_SETS,
27
+ "dev-spec": DEV_STEP_RULE_SETS,
28
+ "dev-change": DEV_STEP_RULE_SETS,
29
+ "dev-implement": DEV_STEP_RULE_SETS,
30
+ };
31
+
32
+ /** The calls a step lets run without a question. dev-implement's roles act in acceptEdits, where a tool
33
+ * declared `execute` would be asked at every test run: run_tests and run_build check their own commands
34
+ * (application/dev/wrapped-tools.ts). The gate is not cleared when a step completes (its `completed` hook is
35
+ * synchronous and reads no session; reapplyStepRules in commands/_lib/dev-step.ts): an earlier hop's allows stay
36
+ * until the next rule change or /assistant turn, and every deny comes before them. The crews' callback reads deny
37
+ * rules only. */
38
+ export const STEP_ALLOW_RULES: Readonly<Record<DevStep, readonly PermissionRule[]>> = {
39
+ "dev-verify": [],
40
+ "dev-plan": [],
41
+ "dev-spec": [],
42
+ "dev-change": [],
43
+ "dev-implement": [{ effect: "allow", tool: "run_tests" }, { effect: "allow", tool: "run_build" }],
44
+ };
45
+
46
+ /** rulesOf(STEP_RULE_SETS[step]) then the step's allow rules: 479 deny rules for each step today, and two allow
47
+ * rules for dev-implement. */
48
+ export function stepRules(step: DevStep): PermissionRule[] {
49
+ return [...rulesOf(STEP_RULE_SETS[step]), ...STEP_ALLOW_RULES[step]];
50
+ }
51
+
52
+ /** A role of a batch (L-6): the pilot reads no source or test file, the test author writes no
53
+ * source file, the implementer writes no test file. */
54
+ export type DevRole = "pilot" | "test-author" | "implementer";
55
+ export type LayoutRootKey = "domain" | "application" | "infrastructure" | "tests";
56
+ export const ROLE_ROOTS: Readonly<Record<DevRole, { access: "read" | "write"; keys: readonly LayoutRootKey[] }>> = {
57
+ pilot: { access: "read", keys: ["domain", "application", "infrastructure", "tests"] },
58
+ "test-author": { access: "write", keys: ["domain", "application", "infrastructure"] },
59
+ implementer: { access: "write", keys: ["tests"] },
60
+ };
61
+
62
+ /** The pack keys a writing role's rewrite rule covers: every source root, whatever the role writes. */
63
+ export const REWRITE_KEYS: readonly LayoutRootKey[] = ["domain", "application", "infrastructure", "tests"];
64
+
65
+ /** pathRules over the role's roots the pack gives, the pack keys it lacks (`layout.tests`), and the patterns its
66
+ * root denies leave writable: the test author writes the test files beside the code (`layout.test_files`). A
67
+ * writing role also gets its `rewrite` rules: no whole write of an existing source file (rewriteRules). */
68
+ export interface RoleRules extends PathRules { missing: string[]; writable: string[]; rewrite: PermissionRule[] }
69
+
70
+ export function roleRules(role: DevRole, layout: Pick<RepoPackLayout, LayoutRootKey | "testFiles">): RoleRules {
71
+ const { access, keys } = ROLE_ROOTS[role];
72
+ const testFiles = (layout.testFiles ?? []).map((p) => p.trim()).filter((p) => p !== "");
73
+ const roots: string[] = [];
74
+ const missing: string[] = [];
75
+ for (const key of keys) {
76
+ const value = layout[key];
77
+ // A pack that names its tests by pattern only lacks no test folder.
78
+ if (value === undefined || value === "") { if (!(key === "tests" && testFiles.length > 0)) missing.push(`layout.${key}`); }
79
+ else roots.push(value);
80
+ }
81
+ const own = pathRules(access, roots);
82
+ if (role === "implementer" && testFiles.length > 0) {
83
+ const byPattern = patternWriteRules(testFiles);
84
+ const unscoped = new Set(own.rules.filter((r) => r.argument === undefined).map((r) => r.tool));
85
+ own.rules.push(...byPattern.rules.filter((r) => r.argument !== undefined || !unscoped.has(r.tool)));
86
+ own.problems.push(...byPattern.problems);
87
+ }
88
+ const rewrite = access === "write"
89
+ ? rewriteRules(REWRITE_KEYS.flatMap((key) => layout[key]?.trim() ? [layout[key] as string] : []), testFiles)
90
+ : [];
91
+ return { ...own, missing, writable: role === "test-author" ? testFiles : [], rewrite };
92
+ }
93
+
94
+ export const GATE_SETTING = "Orkeon:Security:PermissionGate:Enabled";
95
+
96
+ /** What the step says before launching: refuse (no crew), or warn and launch. */
97
+ export interface GateProblem { refuse: boolean; line: string }
98
+
99
+ /** null when the host's gate is on, or when the host keeps no session rules (undefined), which the
100
+ * command reports itself. */
101
+ export function gateProblem(enabled: boolean | undefined, step: DevStep): GateProblem | null {
102
+ if (enabled !== false) return null;
103
+ const gateOnly = step === "dev-verify" ? " /dev-batches <code> F<n> --audit --gate-only runs no model and needs no gate." : "";
104
+ return {
105
+ refuse: true,
106
+ line: `${step}: refused: the host's permission gate is off (${GATE_SETTING} is not true), so the step's rule ` +
107
+ `sets and its read-only mode would check nothing. The launcher turns the gate on unless a settings file turns ` +
108
+ `it off: remove that setting, restart the REPL and run /${stepCommand(step)} again.${gateOnly}`,
109
+ };
110
+ }
@@ -0,0 +1,90 @@
1
+ // The narrow test commands a validation (run_validation) or a run_tests call may run: one runs
2
+ // only when it is exactly one of the pack's narrow test commands, each placeholder filled with
3
+ // one plain relative value and nothing appended - never the whole suite, never a build, never an
4
+ // option or a shell operator. Pure.
5
+ import type { RepoPackCommands } from "./repo-pack.ts";
6
+
7
+ export type ValidationCheck =
8
+ | { ok: true; command: string; key: "commands.test_class" | "commands.test_project" | "commands.test_integration"; scope: string }
9
+ | { ok: false; command: string; reason: string };
10
+
11
+ const MAX_COMMAND_CHARS = 400;
12
+ export const PLACEHOLDER = /<[^<>]+>/g;
13
+ const ANY_WORD = "(\\S+)";
14
+ /** One placeholder value: a plain relative name, no leading "-", no "~", no glob, no quote. */
15
+ const PLAIN_VALUE = /^[A-Za-z0-9_][A-Za-z0-9_.:/-]*$/;
16
+ const OUTSIDE_FORBIDDEN = new Set([...";&|<>$`\\()'"]);
17
+ const INSIDE_FORBIDDEN = new Set([..."`$\\"]);
18
+
19
+ /** True when the text holds no shell operator outside double quotes and no expansion inside them. */
20
+ export function plainWords(text: string): boolean {
21
+ let quoted = false;
22
+ for (const c of text) {
23
+ if (c === '"') { quoted = !quoted; continue; }
24
+ if (quoted ? INSIDE_FORBIDDEN.has(c) : OUTSIDE_FORBIDDEN.has(c)) return false;
25
+ }
26
+ return !quoted;
27
+ }
28
+
29
+ function escapeRegExp(text: string): string {
30
+ return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
31
+ }
32
+
33
+ function templateSource(template: string): string {
34
+ return template.split(PLACEHOLDER).map(escapeRegExp).join(ANY_WORD);
35
+ }
36
+
37
+ /** Why a placeholder value is refused, or null when it is one plain relative value. */
38
+ export function valueProblem(value: string): string | null {
39
+ if (value.split("/").includes("..")) return `the value '${value}' holds a '..' segment`;
40
+ if (!PLAIN_VALUE.test(value)) return `the value '${value}' is not one plain relative name`;
41
+ return null;
42
+ }
43
+
44
+ type Key = "commands.test_class" | "commands.test_project" | "commands.test_integration";
45
+
46
+ export function checkValidation(command: string, commands: RepoPackCommands): ValidationCheck {
47
+ const c = command.trim();
48
+ const refuse = (reason: string): ValidationCheck => ({ ok: false, command: c, reason });
49
+ if (c === "" || /[\r\n]/.test(c) || c.length > MAX_COMMAND_CHARS) return refuse("not one line of at most 400 characters");
50
+ if (!plainWords(c)) return refuse("a shell operator outside double quotes");
51
+
52
+ const templates: Array<[Key, string | undefined]> = [
53
+ ["commands.test_class", commands.testClass],
54
+ ["commands.test_project", commands.testProject],
55
+ ["commands.test_integration", commands.testIntegration],
56
+ ];
57
+ if (templates.every(([, t]) => t === undefined || t.trim() === "")) {
58
+ return refuse("the pack has no test_class, test_project or test_integration");
59
+ }
60
+ let bareIntegration = false;
61
+ let problem: string | null = null;
62
+ for (const [key, template] of templates) {
63
+ if (template === undefined || template.trim() === "") continue;
64
+ const source = templateSource(template.trim());
65
+ const whole = new RegExp(`^${source}$`).exec(c);
66
+ if (whole) {
67
+ const values = whole.slice(1);
68
+ if (key === "commands.test_integration" && values.length === 0) { bareIntegration = true; continue; }
69
+ const bad = values.map(valueProblem).find((p) => p !== null) ?? null;
70
+ if (bad !== null) { problem ??= bad; continue; }
71
+ return { ok: true, command: c, key, scope: scopeOf(values) };
72
+ }
73
+ const suffixed = new RegExp(`^${source} (.+)$`).exec(c);
74
+ if (suffixed) problem ??= `nothing may follow the pack's command: '${suffixed[suffixed.length - 1]}'`;
75
+ }
76
+ if (problem !== null) return refuse(problem);
77
+ return refuse(bareIntegration
78
+ ? "test_integration without a filter is a whole suite"
79
+ : "not one of the pack's test_class, test_project or test_integration commands");
80
+ }
81
+
82
+ function scopeOf(values: readonly string[]): string {
83
+ const named = values.join(", ");
84
+ return named === "" ? "as the pack names it" : named;
85
+ }
86
+
87
+ /** `\`<command>\` — exit <n>, scope <scope>, <count> tests` (SK:72); count "not counted" when unknown. */
88
+ export function validationLine(command: string, exit: number, scope: string, tests: number | null): string {
89
+ return `\`${command}\` — exit ${exit}, scope ${scope}, ${tests === null ? "not counted" : tests} tests`;
90
+ }
@@ -0,0 +1,33 @@
1
+ // The failed tests a test run's output names. Listed in the run_tests result, they tell a role which tests
2
+ // failed without a read of the log: the test author checks that the new tests are the red ones from the
3
+ // result alone. Pure.
4
+
5
+ const MAX_FAILED = 20;
6
+ const MAX_NAME = 120;
7
+
8
+ /** One failed test per line, in the formats the packs run: TAP (`not ok 3 - name`, node:test, tap, prove), pytest
9
+ * (`FAILED tests/test_a.py::test_mean - …`), dotnet (`Failed Ns.Class.Method [12 ms]`), go (`--- FAIL: TestName`),
10
+ * jest and vitest (`✕ name (2 ms)`). */
11
+ const FAILED_LINES: readonly RegExp[] = [
12
+ /^\s*not ok \d+(?: - | )(.+?)\s*(?:#.*)?$/u,
13
+ /^\s*FAILED\s+(\S+)/u,
14
+ /^\s*Failed\s+(\S+)\s*\[[^\]]*\]\s*$/u,
15
+ /^\s*--- FAIL: (\S+)/u,
16
+ /^\s*[✕✗×]\s+(.+?)\s*(?:\(\d+ ?m?s\))?$/u,
17
+ ];
18
+
19
+ /** The failed tests `output` names, each once, in order, at most 20 of 120 characters; empty when it names none. */
20
+ export function failedTests(output: string): string[] {
21
+ const out = new Set<string>();
22
+ for (const line of output.split(/\r?\n/u)) {
23
+ for (const re of FAILED_LINES) {
24
+ const m = re.exec(line);
25
+ if (m !== null) {
26
+ out.add(m[1].trim().slice(0, MAX_NAME));
27
+ break;
28
+ }
29
+ }
30
+ if (out.size >= MAX_FAILED) break;
31
+ }
32
+ return [...out];
33
+ }
@@ -0,0 +1,40 @@
1
+ // Which paths of a repository are its tests, by its pack: under `layout.tests`, or matching one pattern of
2
+ // `layout.test_files` (tests beside the code, `src/*.test.ts`; `*` spans folders, as the gate reads a pattern).
3
+ // dev-implement reads it to tell the test author's changes from the implementer's. Pure.
4
+ import { globMatches } from "../agent-policy/permission.ts";
5
+ import type { RepoPackLayout } from "./repo-pack.ts";
6
+ import { workspaceRelative } from "../vfs.ts";
7
+
8
+ /** A path relative to the project: no `/workspace/` or `./` in front, no `/` behind. */
9
+ export function relativePath(path: string): string {
10
+ let p = path.trim();
11
+ p = workspaceRelative(p);
12
+ while (p.startsWith("./")) p = p.slice(2);
13
+ return p.replace(/\/+$/, "");
14
+ }
15
+
16
+ /** Whether `path` lies under `folder` (a relative folder of the pack's layout). */
17
+ export function under(path: string, folder: string): boolean {
18
+ const f = folder.replace(/^\.\//, "").replace(/\/+$/, "");
19
+ return f === "" || f === "." || path === f || path.startsWith(`${f}/`);
20
+ }
21
+
22
+ export function matchesAny(path: string, patterns: readonly string[]): boolean {
23
+ const p = relativePath(path);
24
+ return patterns.some((raw) => {
25
+ const pattern = relativePath(raw);
26
+ return pattern !== "" && globMatches(pattern, p);
27
+ });
28
+ }
29
+
30
+ /** Whether the pack can tell a test file at all: a test folder or a test file pattern. */
31
+ export function hasTestLayout(layout: Pick<RepoPackLayout, "tests" | "testFiles">): boolean {
32
+ return (layout.tests?.trim() ?? "") !== "" || (layout.testFiles ?? []).some((p) => p.trim() !== "");
33
+ }
34
+
35
+ export function isTestPath(path: string, layout: Pick<RepoPackLayout, "tests" | "testFiles">): boolean {
36
+ const p = relativePath(path);
37
+ const folder = layout.tests?.trim() ?? "";
38
+ if (folder !== "" && under(p, relativePath(folder))) return true;
39
+ return matchesAny(p, layout.testFiles ?? []);
40
+ }