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,150 @@
1
+ // What /dev-spec and dev-change share before and after their own draft: the inputs' code, the checkout check,
2
+ // the code's folder under the work folder, a request given as a path read whole, the self-check of a written
3
+ // source against the parser /dev-plan uses, and the end-message pieces. No model call here.
4
+ import type { Files, Shell } from "../ports.ts";
5
+ import { GIT_TOPLEVEL } from "./resolve-work-folder.ts";
6
+ import type { WorkFolder } from "./resolve-work-folder.ts";
7
+ import { isCode } from "../../domain/dev/artefacts.ts";
8
+ import { parseDecisions } from "../../domain/dev/questions.ts";
9
+ import type { Decision, Question } from "../../domain/dev/questions.ts";
10
+ import { parsePlanSource } from "../../domain/dev/spec-format.ts";
11
+ import type { SourceKind } from "../../domain/dev/spec-format.ts";
12
+ import { WORKSPACE } from "../../domain/vfs.ts";
13
+
14
+ export const MAX_CODE_CHARS = 64;
15
+ export const MAX_REQUEST_CHARS = 20_000;
16
+ const MAX_WARNINGS = 5;
17
+ const MAX_PROBLEM_LINES = 12;
18
+ const LIST_CAP = 1000;
19
+ const PATH_TOKEN = /^[A-Za-z0-9._\-/]+\.(md|txt)$/;
20
+
21
+ export const firstLine = (e: unknown): string => (e instanceof Error ? e.message : String(e)).split("\n")[0];
22
+ const pad2 = (n: number): string => String(n).padStart(2, "0");
23
+ /** A write of the source file that failed: the one failure the step reports as "could not be written"; any other
24
+ * (a question cancelled, a model call that failed) goes up as it is. */
25
+ export class SourceWriteFailure extends Error {
26
+ constructor(cause: unknown) {
27
+ super(firstLine(cause));
28
+ }
29
+ }
30
+
31
+ /** The write of a source file, its failure a SourceWriteFailure. */
32
+ export const sourceWriter = (files: Pick<Files, "write">, vfs: string) => async (text: string): Promise<void> => {
33
+ try {
34
+ await files.write(vfs, text);
35
+ } catch (e) {
36
+ throw new SourceWriteFailure(e);
37
+ }
38
+ };
39
+
40
+ export const dateOf = (d: Date): string => `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
41
+ export const plural = (n: number, one: string, many: string): string => `${n} ${n === 1 ? one : many}`;
42
+
43
+ export function warningLines(warnings: readonly string[]): string[] {
44
+ const lines = warnings.slice(0, MAX_WARNINGS).map((w) => `warning: ${w}`);
45
+ if (warnings.length > MAX_WARNINGS) lines.push(` … ${warnings.length - MAX_WARNINGS} more warnings`);
46
+ return lines;
47
+ }
48
+
49
+ export function problemLines(problems: readonly string[]): string[] {
50
+ const lines = problems.slice(0, MAX_PROBLEM_LINES).map((p) => ` ${p}`);
51
+ if (problems.length > MAX_PROBLEM_LINES) lines.push(` … ${problems.length - MAX_PROBLEM_LINES} more`);
52
+ return lines;
53
+ }
54
+
55
+ /** The code of the inputs, or the refusal. */
56
+ export function inputCode(step: string, value: unknown): string | { refused: string } {
57
+ if (typeof value !== "string" || value.length > MAX_CODE_CHARS || !isCode(value)) return { refused: `${step}: invalid crew input: code` };
58
+ return value;
59
+ }
60
+
61
+ /** A free text input: "" when absent, the refusal when it is not a string or too long. */
62
+ export function inputText(step: string, name: string, value: unknown): string | { refused: string } {
63
+ if (value === undefined || value === null) return "";
64
+ if (typeof value !== "string" || value.length > MAX_REQUEST_CHARS) return { refused: `${step}: invalid crew input: ${name}` };
65
+ return value.trim();
66
+ }
67
+
68
+ export async function toplevelRefusal(step: string, shell: Pick<Shell, "run">): Promise<string | null> {
69
+ let top: string;
70
+ try {
71
+ const r = await shell.run(GIT_TOPLEVEL);
72
+ top = r.exitCode === 0 ? r.stdout.trim() : "";
73
+ } catch {
74
+ top = "";
75
+ }
76
+ if (top === WORKSPACE) return null;
77
+ return `${step}: run from the checkout at ${WORKSPACE} (git reports ${top === "" ? "no work tree" : top})`;
78
+ }
79
+
80
+ export interface CodeFolder {
81
+ /** "/workspace/workbench/prune". */
82
+ vfs: string;
83
+ /** "workbench/prune". */
84
+ shown: string;
85
+ names: string[];
86
+ file: (name: string) => { vfs: string; shown: string };
87
+ }
88
+
89
+ /** The code's folder under the work folder and the names it holds ([] when it does not exist yet). */
90
+ export async function codeFolder(step: string, files: Pick<Files, "list">, work: WorkFolder, code: string): Promise<CodeFolder | { refused: string }> {
91
+ if (work.vfsPath === null) {
92
+ return { refused: `${step}: the work folder ${work.folder} is outside the checkout's mounts: run from the main worktree` };
93
+ }
94
+ const vfs = `${work.vfsPath}/${code}`;
95
+ const shown = `${work.folder}/${code}`;
96
+ let names: string[];
97
+ try {
98
+ names = (await files.list(vfs, LIST_CAP)).map((n) => n.replace(/\/+$/, ""));
99
+ } catch {
100
+ names = [];
101
+ }
102
+ return { vfs, shown, names, file: (name) => ({ vfs: `${vfs}/${name}`, shown: `${shown}/${name}` }) };
103
+ }
104
+
105
+ /**
106
+ * A request given as one token naming a .md or .txt file of the checkout is read whole; anything else is the text
107
+ * itself. A path out of the checkout is refused.
108
+ */
109
+ export async function readRequest(step: string, files: Pick<Files, "read">, request: string): Promise<{ text: string; from: string } | { refused: string }> {
110
+ if (!PATH_TOKEN.test(request)) return { text: request, from: "" };
111
+ const relative = request.startsWith(`${WORKSPACE}/`) ? request.slice(WORKSPACE.length + 1) : request.replace(/^\.\//, "");
112
+ if (relative.startsWith("/") || relative.split("/").includes("..")) {
113
+ return { refused: `${step}: ${request} is outside the checkout: give a path under ${WORKSPACE}` };
114
+ }
115
+ try {
116
+ const text = await files.read(`${WORKSPACE}/${relative}`, MAX_REQUEST_CHARS);
117
+ if (text.trim() === "") return { refused: `${step}: ${relative} is empty` };
118
+ return { text, from: relative };
119
+ } catch (e) {
120
+ return { refused: `${step}: ${relative} cannot be read (${firstLine(e)})` };
121
+ }
122
+ }
123
+
124
+ /**
125
+ * The written file read back by /dev-plan's parser: the title's code, every id the answer gave, as many open
126
+ * questions and decisions as rendered, no format problem. [] when the file reads as written.
127
+ */
128
+ export function sourceSelfCheck(
129
+ text: string, kind: SourceKind, expect: { code: string; ids: readonly string[]; open: readonly Question[]; decisions: readonly Decision[] },
130
+ ): string[] {
131
+ const parsed = parsePlanSource(text, kind);
132
+ const problems = parsed.problems.map((p) => `line ${p.line}: ${p.message}`);
133
+ if (parsed.code !== expect.code) problems.push(`the title does not read the code ${expect.code}`);
134
+ const read = parsed.ids.map((i) => i.id).join(",");
135
+ if (read !== expect.ids.join(",")) {
136
+ problems.push(`the ids read back are ${read || "none"}, not ${expect.ids.join(",")}`);
137
+ }
138
+ if (parsed.openQuestions.length !== expect.open.length) {
139
+ problems.push(`${parsed.openQuestions.length} open questions read back, ${expect.open.length} written`);
140
+ }
141
+ if (parseDecisions(text).length !== expect.decisions.length) problems.push("the decisions do not read back");
142
+ return problems;
143
+ }
144
+
145
+ /** "2 Blocking, 1 Major" for the open questions, "none" when there is none. */
146
+ export function openLine(open: readonly Question[]): string {
147
+ if (open.length === 0) return "none";
148
+ const blocking = open.filter((q) => q.severity === "Blocking").length;
149
+ return `${blocking} Blocking, ${open.length - blocking} Major (${open.map((q) => q.id).join(", ")})`;
150
+ }
@@ -0,0 +1,42 @@
1
+ // A batch's budget of tool calls: the runtime gives a delegated agent no budget (L8P-D12), so a parallel
2
+ // /dev-batches' batch agent counts its own calls and its callbacks refuse every call past the bound.
3
+ import type { ToolCallbacks } from "./tool-callbacks.ts";
4
+
5
+ /** A batch's tool calls: counted, and refused once `limit` is reached. A call to a tool the act does not offer is
6
+ * refused by the runtime before `onToolCall` (Orkeon #193): it costs nothing here, the act's `maxIterations` bounds it. */
7
+ export interface Spend {
8
+ readonly limit: number;
9
+ calls(): number;
10
+ /** True once a call was refused: a batch that used exactly its `limit`, none refused, is not stopped. */
11
+ exhausted(): boolean;
12
+ /** Counts one call; false, and nothing counted, once the limit is reached. */
13
+ take(): boolean;
14
+ }
15
+
16
+ export function createSpend(limit: number): Spend {
17
+ let calls = 0;
18
+ let denied = 0;
19
+ return {
20
+ limit,
21
+ calls: () => calls,
22
+ exhausted: () => denied > 0,
23
+ take: () => (calls >= limit ? (denied++, false) : (calls++, true)),
24
+ };
25
+ }
26
+
27
+ /** `callbacks` denying every call past the spend's limit; `callbacks` themselves without a spend. */
28
+ export function spendGuard<C extends Pick<ToolCallbacks, "forAct">>(callbacks: C, spend: Spend | undefined): C {
29
+ if (spend === undefined) return callbacks;
30
+ return {
31
+ ...callbacks,
32
+ forAct(mode: string, gateEnabled: boolean | undefined) {
33
+ const inner = callbacks.forAct(mode, gateEnabled);
34
+ return {
35
+ ...inner,
36
+ onToolCall: async (call) => (spend.take()
37
+ ? inner.onToolCall(call)
38
+ : { deny: `budget: this batch has spent its ${spend.limit} tool calls; end the act and say what is left` }),
39
+ };
40
+ },
41
+ };
42
+ }
@@ -0,0 +1,89 @@
1
+ // Code-triggered recall (lot M-6, temp/05 § 4.1): a dev step asks the shared memory for precedents at a fixed
2
+ // point of its own code - never a tool the model may forget - and puts the "## Precedents" block in the prompt it
3
+ // builds. Each trigger asks for the types its moment needs, with a query built from what the step already holds.
4
+ // Best effort: a recall that cannot run (no index, unreadable settings, a session rule that denies memory_recall)
5
+ // costs the block, never the step. The settings are read once per run, at the first recall.
6
+
7
+ import type { ConfigStore } from "../config-store.ts";
8
+ import type { Files, Logger, SharedMemory, Shell } from "../ports.ts";
9
+ import type { EntryType } from "../../domain/shared-memory/entry.ts";
10
+ import { buildPrecedentsBlock } from "../../domain/shared-memory/precedents-block.ts";
11
+ import { recallEntries } from "../shared-memory/recall-precedents.ts";
12
+ import { readMemorySettings } from "../shared-memory/memory-settings.ts";
13
+ import type { MemorySettings } from "../shared-memory/memory-settings.ts";
14
+
15
+ /** T1 spec or change start, T2 plan start, T3 before a batch's red tests, T4 before the audit, T5 a correction. */
16
+ export type RecallTrigger = "T1" | "T2" | "T3" | "T4" | "T5";
17
+
18
+ export const TRIGGER_TYPES: Readonly<Record<RecallTrigger, readonly EntryType[]>> = {
19
+ T1: ["decision", "method"],
20
+ T2: ["decision", "code-structure"],
21
+ T3: ["code-structure", "mistake"],
22
+ T4: ["mistake"],
23
+ T5: ["mistake"],
24
+ };
25
+
26
+ /** A query is a few hundred characters: the index embeds it, a longer one only dilutes it. */
27
+ export const MAX_RECALL_QUERY_CHARS = 400;
28
+
29
+ export interface Recalled {
30
+ /** The "## Precedents" block, or "" when nothing was recalled. */
31
+ block: string;
32
+ /** The ids recalled (a bound may leave some out of the block, which counts them): the step's end message names them. */
33
+ ids: string[];
34
+ }
35
+
36
+ export const NOTHING_RECALLED: Recalled = { block: "", ids: [] };
37
+
38
+ /** What a dev step calls: the precedents of one trigger for one query. Never throws. */
39
+ export type StepPrecedents = (trigger: RecallTrigger, query: string) => Promise<Recalled>;
40
+
41
+ /** The step that recalls nothing: a test's default, and the crew's when memory_recall is denied. */
42
+ export const noPrecedents: StepPrecedents = async () => NOTHING_RECALLED;
43
+
44
+ /** The query of a trigger: the parts in order, each line's spaces collapsed, blank ones dropped, cut at the bound. */
45
+ export function recallQuery(parts: readonly string[]): string {
46
+ const text = parts.map((p) => p.replace(/\s+/g, " ").trim()).filter((p) => p !== "").join(" — ");
47
+ return text.length <= MAX_RECALL_QUERY_CHARS ? text : text.slice(0, MAX_RECALL_QUERY_CHARS).trimEnd();
48
+ }
49
+
50
+ /** A sheet's or a plan's title: its first "# " heading, "" when none. */
51
+ export function sheetTitle(text: string): string {
52
+ const line = text.split("\n").find((l) => l.startsWith("# "));
53
+ return line === undefined ? "" : line.slice(2).trim();
54
+ }
55
+
56
+ export interface StepPrecedentsDeps {
57
+ memory: Pick<SharedMemory, "search">;
58
+ files: Pick<Files, "read">;
59
+ config: Pick<ConfigStore, "readValue">;
60
+ shell: Pick<Shell, "run">;
61
+ log: Pick<Logger, "warn">;
62
+ }
63
+
64
+ const firstLine = (e: unknown): string => String((e as Error)?.message ?? e).split("\n")[0];
65
+
66
+ /** The recall of one run of a step; `on: false` (a session rule denies memory_recall) recalls nothing. */
67
+ export function stepPrecedents(deps: StepPrecedentsDeps, options: { on: boolean }): StepPrecedents {
68
+ if (!options.on) return noPrecedents;
69
+ let settings: Promise<MemorySettings> | null = null;
70
+ return async (trigger, query) => {
71
+ try {
72
+ settings ??= readMemorySettings(deps);
73
+ const memory = await settings;
74
+ const recall = await recallEntries(deps, { memory, query, types: TRIGGER_TYPES[trigger] });
75
+ const block = buildPrecedentsBlock(recall.precedents);
76
+ return block === "" ? NOTHING_RECALLED : { block, ids: recall.precedents.map((p) => p.entry.id) };
77
+ } catch (error) {
78
+ settings = null; // a failed read is tried again at the next trigger, not kept for the run
79
+ deps.log.warn(`shared memory: recall ${trigger} failed, no precedents (${firstLine(error)})`);
80
+ return NOTHING_RECALLED;
81
+ }
82
+ };
83
+ }
84
+
85
+ /** The end-message line of a step that recalled: "" when nothing was. */
86
+ export function precedentsLine(recalled: readonly Recalled[]): string {
87
+ const ids = [...new Set(recalled.flatMap((r) => r.ids))];
88
+ return ids.length === 0 ? "" : `precedents recalled: ${ids.join(", ")}`;
89
+ }
@@ -0,0 +1,89 @@
1
+ // What a dev crew's onToolCall decides for one call the host's gate allowed, over probes the callbacks build
2
+ // (tool-callbacks.ts): the path resolved under the checkout first, then the shared memory's guard, then the crew's
3
+ // guard (shared/domain/dev/call-guard.ts) told whether a file_write under a rewrite rule names a new file, then the
4
+ // pre-tool hooks, stopped at the first that fails. It holds the order and the refusals' texts; what the probes read
5
+ // (the memory folder, the file, the hook's shell) is the callbacks'. No port: the probes are plain functions.
6
+ import { checkToolCall, denyText } from "../../domain/dev/call-guard.ts";
7
+ import type { ActFacts, CallGuard, ToolHook } from "../../domain/dev/call-guard.ts";
8
+ import { resolvePathInput } from "../../domain/dev/path-args.ts";
9
+ import { REWRITE_TOOL } from "../../domain/agent-policy/rule-sets.ts";
10
+ import { sameToolName } from "../../domain/agent-policy/permission.ts";
11
+ import { memoryWriteRefusal } from "../../domain/shared-memory/layout.ts";
12
+
13
+ /** The runtime's verdict and result callbacks, as ActOptions types them (the subset the callbacks return): allow,
14
+ * deny, or allow with the call's input rewritten (a relative path resolved). */
15
+ export type ToolCallVerdict = "allow" | { deny: string } | { input: unknown };
16
+
17
+ /** What stopped a hook: the hook itself (its exit, its time, its start), or the runtime's mount check, which refuses a
18
+ * command line naming a mount path the shell may not hand to its program, before the hook runs. */
19
+ export interface HookFailure { by: "hook" | "mount-check"; text: string }
20
+
21
+ /** What the decision asks of the world, one call at a time. */
22
+ export interface CallProbes {
23
+ /** The shared memory's folder (memory.dir); null: the memory is not guarded here. */
24
+ memoryDir(): Promise<string | null>;
25
+ /** True when `path` names no file yet, false when it names one; undefined when it cannot be told. */
26
+ newFile(path: string): Promise<boolean | undefined>;
27
+ /** Runs one pre-tool hook on the call; undefined when it passed, else what stopped it. */
28
+ runHook(hook: ToolHook, tool: string, input: unknown): Promise<HookFailure | undefined>;
29
+ }
30
+
31
+ /** The verdict, and the lines the callbacks log for it (at info). */
32
+ export interface CallJudgement { verdict: ToolCallVerdict; notes: string[] }
33
+
34
+ const MEMORY_GUARD = "refused by the shared memory's guard";
35
+ const MEMORY_CONTEXT = "The shared memory's candidates and entries are written by memory_push and /memory-admit only: do without this call.";
36
+
37
+ /** The refusal of a write into the shared memory, `why` its reason (memoryWriteRefusal), without a step's name. */
38
+ export function memoryDenyText(why: string): string {
39
+ return `${MEMORY_GUARD}: ${why}\n${MEMORY_CONTEXT}`;
40
+ }
41
+
42
+ /** The refusal of a call a pre-tool hook stopped, led by the step's name. */
43
+ function hookDenyText(step: string, failure: HookFailure): string {
44
+ return failure.by === "mount-check"
45
+ ? `${step}: ${failure.text}\nThe call did not run: a hook's command line may name no path its ` +
46
+ "program may not write; ask the user to change the hook."
47
+ : `${step}: refused by ${failure.text}\nThe call did not run: change it, or ask the user to fix the hook.`;
48
+ }
49
+
50
+ export async function judgeToolCall(
51
+ guard: CallGuard, call: { name: string; input: unknown }, act: Omit<ActFacts, "newFile">, probes: CallProbes,
52
+ ): Promise<CallJudgement> {
53
+ const notes: string[] = [];
54
+ const judged = (verdict: ToolCallVerdict): CallJudgement => ({ verdict, notes });
55
+ // A throw would deny too, with the bare message: the catch keeps the step's name in front.
56
+ try {
57
+ // A relative path is resolved under the checkout first: the guard, the hooks and the tool see the resolved one
58
+ // (the runtime would resolve it too, after the guard: too late for the rules and the hooks).
59
+ const resolved = resolvePathInput(call.name, call.input);
60
+ const input = resolved ?? call.input;
61
+ if (resolved !== null) notes.push(`${guard.step}: ${call.name}: a relative path resolved under the checkout`);
62
+ const dir = await probes.memoryDir();
63
+ const memory = dir === null ? null : memoryWriteRefusal(dir, call.name, input);
64
+ if (memory !== null) {
65
+ notes.push(`${guard.step}: callback refused ${call.name}: ${memory}`);
66
+ return judged({ deny: `${guard.step}: ${memoryDenyText(memory)}` });
67
+ }
68
+ const path = (input as { path?: unknown } | null)?.path;
69
+ const rewrite = sameToolName(call.name, REWRITE_TOOL) && typeof path === "string"
70
+ && guard.rules.some((r) => r.origin.kind === "rewrite");
71
+ const newFile = rewrite ? await probes.newFile(path as string) : undefined;
72
+ const verdict = checkToolCall(guard, call.name, input, { ...act, ...(newFile === undefined ? {} : { newFile }) });
73
+ if (!verdict.allow) {
74
+ notes.push(`${guard.step}: callback refused ${call.name}: ${verdict.reason}`);
75
+ return judged({ deny: denyText(verdict) });
76
+ }
77
+ for (const hook of guard.hooks.filter((h) => h.event === "pre-tool")) {
78
+ const failed = await probes.runHook(hook, call.name, input);
79
+ if (failed === undefined) continue;
80
+ notes.push(failed.by === "mount-check"
81
+ ? `${guard.step}: the runtime's mount check refused pre-tool hook #${hook.n} for ${call.name}`
82
+ : `${guard.step}: pre-tool hook #${hook.n} refused ${call.name}`);
83
+ return judged({ deny: hookDenyText(guard.step, failed) });
84
+ }
85
+ return judged(resolved === null ? "allow" : { input: resolved });
86
+ } catch (e) {
87
+ return judged({ deny: `${guard.step}: the callback failed: ${String((e as Error)?.message ?? e)}` });
88
+ }
89
+ }
@@ -0,0 +1,215 @@
1
+ // The dev crews' onToolCall and onToolResult (RT-04), built from a crew's inputs and handed to every act through
2
+ // createLlm(ctx.llm, callbacks). The host's gate runs first and the callback sees only the calls it allowed: the
3
+ // callback hands the call to the decision (tool-call-policy.ts) over probes built here: the memory folder read
4
+ // once, the path a file_write under a rewrite rule names read once (a file the runtime says is not found is a new
5
+ // one, which file_write may create), and the hooks run in the shell; it logs the decision's notes. After the call,
6
+ // the post-tool hooks. It answers "allow", { deny } or the input with its path resolved: no "ask" (an approval
7
+ // asked in the middle of a crew's turn may not be answered by the REPL). Each crew that imports this module bundles
8
+ // its own copy; nothing is shared between runs.
9
+ import type { Files, Logger, Shell } from "../ports.ts";
10
+ import { buildCallGuard, hookCommand } from "../../domain/dev/call-guard.ts";
11
+ import { resolvePathInput } from "../../domain/dev/path-args.ts";
12
+ import { OPERATIONS_TOOL } from "../../domain/agent-policy/rule-sets.ts";
13
+ import { sameToolName } from "../../domain/agent-policy/permission.ts";
14
+ import { memoryWriteRefusal } from "../../domain/shared-memory/layout.ts";
15
+ import { mapStrings, textFromRoot } from "../../domain/dev/path-rebase.ts";
16
+ import type { CallGuard, CallGuardSpec, ToolHook } from "../../domain/dev/call-guard.ts";
17
+ import { WORKSPACE } from "../../domain/vfs.ts";
18
+ import { judgeToolCall, memoryDenyText } from "./tool-call-policy.ts";
19
+ import type { CallProbes, HookFailure, ToolCallVerdict } from "./tool-call-policy.ts";
20
+
21
+ export type { HookFailure, ToolCallVerdict } from "./tool-call-policy.ts";
22
+
23
+ /** A hook is stopped after this many seconds, and refuses (pre) or is reported (post). */
24
+ export const HOOK_TIMEOUT_SECONDS = 60;
25
+
26
+ /** The runtime's verdict and result callbacks, as ActOptions types them (the subset this module returns). */
27
+ export interface ActCallbacks {
28
+ onToolCall: (call: { name: string; input: unknown }) => Promise<ToolCallVerdict>;
29
+ onToolResult: (call: { name: string; input: unknown }, result: unknown) => Promise<void | { context: string }>;
30
+ }
31
+
32
+ /** What createLlm asks for each act: the callbacks for the act's mode and what the host says of its gate. */
33
+ export interface ToolCallbacks {
34
+ guard: CallGuard;
35
+ forAct(mode: string, gateEnabled: boolean | undefined): ActCallbacks;
36
+ }
37
+
38
+ export interface ToolCallbackDeps {
39
+ shell: Pick<Shell, "run">;
40
+ log?: Pick<Logger, "info" | "warn">;
41
+ /** Reads a file_write's path under a rewrite rule; none: the rule holds on every path. */
42
+ files?: Pick<Files, "read">;
43
+ /** The shared memory's folder (memory.dir): the callback denies a write under its candidates or entries the gate
44
+ * cannot see (memoryWriteRefusal). None: not checked here. */
45
+ memoryDir?: () => Promise<string>;
46
+ }
47
+
48
+ /** A reader of the memory folder that asks once: every call of an act needs it, the setting does not move. */
49
+ export function onceMemoryDir(read: () => Promise<string>): () => Promise<string> {
50
+ let dir: Promise<string> | null = null;
51
+ return () => (dir ??= read());
52
+ }
53
+
54
+ /** The callbacks of an act that runs no dev step (the main loop): the shared memory's guard alone, no hook. */
55
+ export function memoryGuardCallbacks(memoryDir: () => Promise<string>): Pick<ToolCallbacks, "forAct"> {
56
+ const dir = onceMemoryDir(memoryDir);
57
+ return {
58
+ forAct() {
59
+ return {
60
+ async onToolCall(call) {
61
+ try {
62
+ const why = memoryWriteRefusal(await dir(), call.name, call.input);
63
+ return why === null ? "allow" : { deny: memoryDenyText(why) };
64
+ } catch (e) {
65
+ return { deny: `the shared memory's guard failed: ${String((e as Error)?.message ?? e)}` };
66
+ }
67
+ },
68
+ async onToolResult() { return undefined; },
69
+ };
70
+ },
71
+ };
72
+ }
73
+
74
+ /** True when the runtime says `path` names no file (its "not found"), false when it reads; undefined otherwise. */
75
+ export async function isNewFile(files: Pick<Files, "read">, path: string): Promise<boolean | undefined> {
76
+ const trimmed = path.trim();
77
+ if (trimmed === "") return undefined;
78
+ const virtual = trimmed.startsWith("/") ? trimmed : `${WORKSPACE}/${trimmed.replace(/^(\.\/)+/, "")}`;
79
+ try {
80
+ await files.read(virtual, 1);
81
+ return false;
82
+ } catch (e) {
83
+ return /not found|no such file|does not exist/i.test(String((e as Error)?.message ?? e)) ? true : undefined;
84
+ }
85
+ }
86
+
87
+ /** The first line of what a hook printed, its error output first, at most 200 characters. */
88
+ function firstLine(stderr: string, stdout: string): string {
89
+ const line = (stderr.trim() || stdout.trim()).split("\n")[0] ?? "";
90
+ return line.length > 200 ? `${line.slice(0, 200)}…` : line;
91
+ }
92
+
93
+ /** The inputs a hook sees for one call: the call's own, or one `{ path }` per operation of an edit_batch, so a
94
+ * per-file hook hears every file the batch writes. */
95
+ export function hookInputs(tool: string, input: unknown): unknown[] {
96
+ const ops = (input as { operations?: unknown } | null)?.operations;
97
+ if (!sameToolName(tool, OPERATIONS_TOOL) || !Array.isArray(ops) || ops.length === 0) return [input];
98
+ return ops.map((op: unknown) => ({ path: (op as { path?: unknown } | null)?.path }));
99
+ }
100
+
101
+ /** The runtime shell's refusal of a command line by its mount check (ShellCommandTool), else null. */
102
+ const MOUNT_DENIAL = /^(?:Command argument denied by file system|Argument denied):/;
103
+
104
+ function mountDenial(text: string): string | null {
105
+ const line = text.trim().split("\n")[0] ?? "";
106
+ return MOUNT_DENIAL.test(line) ? line : null;
107
+ }
108
+
109
+ async function runHooks(deps: ToolCallbackDeps, hook: ToolHook, tool: string, input: unknown): Promise<HookFailure | undefined> {
110
+ for (const one of hookInputs(tool, input)) {
111
+ const failed = await runHook(deps, hook, tool, one);
112
+ if (failed !== undefined) return failed;
113
+ }
114
+ return undefined;
115
+ }
116
+
117
+ /** Runs one hook; undefined when it exited 0, else what went wrong in one line and who stopped it. */
118
+ async function runHook(deps: ToolCallbackDeps, hook: ToolHook, tool: string, input: unknown): Promise<HookFailure | undefined> {
119
+ const command = hookCommand(hook, tool, input);
120
+ const label = `${hook.event} hook #${hook.n} (${command})`;
121
+ const refused = (denial: string): HookFailure =>
122
+ ({ by: "mount-check", text: `the runtime's mount check refused the command line of ${label}, which did not run: ${denial}` });
123
+ try {
124
+ const r = await deps.shell.run(command, { timeoutSeconds: HOOK_TIMEOUT_SECONDS });
125
+ // A refused command line comes back not completed: read as a timeout, it would hide the refusal.
126
+ const denial = r.exitCode === 0 ? null : mountDenial(r.stderr);
127
+ if (denial !== null) return refused(denial);
128
+ if (r.timedOut) return { by: "hook", text: `${label} stopped after ${HOOK_TIMEOUT_SECONDS} s` };
129
+ if (r.exitCode === 0) return undefined;
130
+ const said = firstLine(r.stderr, r.stdout);
131
+ return { by: "hook", text: `${label} exited ${r.exitCode}${said ? `: ${said}` : ""}` };
132
+ } catch (e) {
133
+ const message = String((e as Error)?.message ?? e);
134
+ const denial = mountDenial(message);
135
+ if (denial !== null) return refused(denial);
136
+ return { by: "hook", text: `${label} could not run: ${message.split("\n")[0]}` };
137
+ }
138
+ }
139
+
140
+ /** The text the model was shown for a result, as the runtime passes it: a string as is, else its JSON. */
141
+ function shownText(result: unknown): string {
142
+ if (typeof result === "string") return result;
143
+ try {
144
+ return JSON.stringify(result) ?? String(result);
145
+ } catch {
146
+ return String(result);
147
+ }
148
+ }
149
+
150
+ export function createToolCallbacks(guard: CallGuard, deps: ToolCallbackDeps): ToolCallbacks {
151
+ const memoryDir = deps.memoryDir === undefined ? undefined : onceMemoryDir(deps.memoryDir);
152
+ const files = deps.files;
153
+ const probes: CallProbes = {
154
+ memoryDir: memoryDir ?? (async () => null),
155
+ newFile: files === undefined ? async () => undefined : (path) => isNewFile(files, path),
156
+ runHook: (hook, tool, input) => runHooks(deps, hook, tool, input),
157
+ };
158
+ const post = guard.hooks.filter((h) => h.event === "post-tool");
159
+ return {
160
+ guard,
161
+ forAct(mode, gateEnabled) {
162
+ return {
163
+ async onToolCall(call): Promise<ToolCallVerdict> {
164
+ const { verdict, notes } = await judgeToolCall(guard, call, { mode, gateEnabled }, probes);
165
+ for (const note of notes) deps.log?.info(note);
166
+ return verdict;
167
+ },
168
+ async onToolResult(call, result) {
169
+ if (post.length === 0) return undefined;
170
+ const notes: string[] = [];
171
+ for (const hook of post) {
172
+ const failed = await runHooks(deps, hook, call.name, call.input);
173
+ if (failed !== undefined) notes.push(`[${failed.text}]`);
174
+ }
175
+ if (notes.length === 0) return undefined;
176
+ deps.log?.warn(`${guard.step}: ${notes.length} post-tool hook(s) failed after ${call.name}`);
177
+ return { context: [shownText(result), ...notes].join("\n") };
178
+ },
179
+ };
180
+ },
181
+ };
182
+ }
183
+
184
+ /** The callbacks of a dev crew from its spec (its step, role, roots and `hooks` input). */
185
+ export function devToolCallbacks(spec: CallGuardSpec, deps: ToolCallbackDeps): ToolCallbacks {
186
+ const guard = buildCallGuard(spec);
187
+ for (const problem of guard.problems) deps.log?.warn(`${spec.step}: ${problem}`);
188
+ return createToolCallbacks(guard, deps);
189
+ }
190
+
191
+ /**
192
+ * The callbacks of a batch run under its working root (a parallel /dev-batches): every string of a call's input
193
+ * comes back from the root to `/workspace` before `callbacks` see it, so the rule sets, the rewrite rule, the hooks
194
+ * and the writes a role reports name the logical checkout; a relative path is resolved under the root first, and
195
+ * the tool receives it resolved. Without a root, `callbacks` themselves.
196
+ */
197
+ export function rootedCallbacks<C extends Pick<ToolCallbacks, "forAct">>(callbacks: C, root: string | undefined): C {
198
+ if (root === undefined || root === "") return callbacks;
199
+ const logical = (call: { name: string; input: unknown }) => ({ name: call.name, input: mapStrings(call.input, (t) => textFromRoot(t, root)) });
200
+ return {
201
+ ...callbacks,
202
+ forAct(mode: string, gateEnabled: boolean | undefined) {
203
+ const inner = callbacks.forAct(mode, gateEnabled);
204
+ return {
205
+ ...inner,
206
+ onToolCall: async (call) => {
207
+ const resolved = resolvePathInput(call.name, call.input, root);
208
+ const verdict = await inner.onToolCall(logical(resolved === null ? call : { name: call.name, input: resolved }));
209
+ return verdict === "allow" && resolved !== null ? { input: resolved } : verdict;
210
+ },
211
+ onToolResult: (call, result) => inner.onToolResult(logical(call), result),
212
+ };
213
+ },
214
+ };
215
+ }
@@ -0,0 +1,45 @@
1
+ // The recorder of a turn's tool calls: it rides on the act's onToolResult, beside the callbacks a crew already
2
+ // hands createLlm (the shared memory's guard), and gives the turn's [tools] message (shared/domain/tool-trace.ts).
3
+ import { formatToolTrace, traceCall, type ToolCallTrace } from "../../domain/tool-trace.ts";
4
+ import type { ToolCallbacks } from "./tool-callbacks.ts";
5
+
6
+ export interface ToolTrace {
7
+ record(tool: string, input: unknown, result: unknown): void;
8
+ /** The message of the calls recorded since the last take, which forgets them; null when there were none. */
9
+ take(): string | null;
10
+ }
11
+
12
+ export function createToolTrace(): ToolTrace {
13
+ let calls: ToolCallTrace[] = [];
14
+ return {
15
+ record(tool, input, result) { calls.push(traceCall(tool, input, result)); },
16
+ take() {
17
+ const message = formatToolTrace(calls);
18
+ calls = [];
19
+ return message;
20
+ },
21
+ };
22
+ }
23
+
24
+ /** The callbacks given, each result recorded first, and each call they deny, which gets no result: their verdicts
25
+ * and their context stand unchanged. A call the host's gate refuses reaches neither callback, and is not recorded. */
26
+ export function tracedCallbacks(inner: Pick<ToolCallbacks, "forAct">, trace: Pick<ToolTrace, "record">): Pick<ToolCallbacks, "forAct"> {
27
+ return {
28
+ forAct(mode, gateEnabled) {
29
+ const callbacks = inner.forAct(mode, gateEnabled);
30
+ return {
31
+ async onToolCall(call) {
32
+ const verdict = await callbacks.onToolCall(call);
33
+ if (typeof verdict === "object" && verdict !== null && "deny" in verdict) {
34
+ try { trace.record(call.name, call.input, { error: `denied: ${verdict.deny}` }); } catch { /* the trace is best-effort */ }
35
+ }
36
+ return verdict;
37
+ },
38
+ async onToolResult(call, result) {
39
+ try { trace.record(call.name, call.input, result); } catch { /* the trace is best-effort */ }
40
+ return callbacks.onToolResult(call, result);
41
+ },
42
+ };
43
+ },
44
+ };
45
+ }