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

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 (552) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -0
  3. package/LICENSE.md +21 -0
  4. package/NOTICE.md +17 -0
  5. package/README.fr.md +163 -0
  6. package/README.md +156 -2
  7. package/config/appsettings.anthropic.example.json +77 -0
  8. package/config/appsettings.example.json +71 -0
  9. package/config/appsettings.jev.example.json +131 -0
  10. package/config/appsettings.kev.example.json +133 -0
  11. package/config/appsettings.liquid.example.json +132 -0
  12. package/config/appsettings.ollama-whisper.example.json +93 -0
  13. package/config/appsettings.ollama.example.json +70 -0
  14. package/config/appsettings.whisper.example.json +32 -0
  15. package/mcp/whisper/README.md +294 -0
  16. package/mcp/whisper/pyproject.toml +32 -0
  17. package/mcp/whisper/uv.lock +1641 -0
  18. package/mcp/whisper/whisper_mcp.py +1053 -0
  19. package/orkeon-code +1092 -0
  20. package/orkeon-code.mjs +71 -0
  21. package/orkeon-code.ps1 +939 -0
  22. package/package.json +58 -4
  23. package/scripts/install.ps1 +156 -0
  24. package/scripts/install.sh +148 -0
  25. package/scripts/session-start.ork.ts +90 -0
  26. package/scripts/session-start.sh +74 -0
  27. package/scripts/setup-fixture.sh +88 -0
  28. package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
  29. package/src/commands/_lib/args.ts +194 -0
  30. package/src/commands/_lib/dev/dev-batches.ts +366 -0
  31. package/src/commands/_lib/dev/dev-implement.ts +185 -0
  32. package/src/commands/_lib/dev/dev-source.ts +61 -0
  33. package/src/commands/_lib/dev/dev.ts +341 -0
  34. package/src/commands/_lib/dev/markers.ts +7 -0
  35. package/src/commands/_lib/dev/messages.ts +112 -0
  36. package/src/commands/_lib/dev-step.ts +145 -0
  37. package/src/commands/_lib/dispatch.ts +254 -0
  38. package/src/commands/_lib/effort.ts +15 -0
  39. package/src/commands/_lib/git/branch.ts +94 -0
  40. package/src/commands/_lib/git/commit.ts +90 -0
  41. package/src/commands/_lib/git/diff.ts +107 -0
  42. package/src/commands/_lib/git/messages.ts +54 -0
  43. package/src/commands/_lib/git/review.ts +108 -0
  44. package/src/commands/_lib/memory/memory-admit.ts +148 -0
  45. package/src/commands/_lib/memory/memory.ts +52 -0
  46. package/src/commands/_lib/memory/messages.ts +32 -0
  47. package/src/commands/_lib/messages.ts +48 -0
  48. package/src/commands/_lib/pr-context.ts +32 -0
  49. package/src/commands/_lib/project/analyze.ts +24 -0
  50. package/src/commands/_lib/project/messages.ts +8 -0
  51. package/src/commands/_lib/session/export.ts +105 -0
  52. package/src/commands/_lib/session/messages.ts +87 -0
  53. package/src/commands/_lib/session/prompts.ts +4 -0
  54. package/src/commands/_lib/session/resume.ts +151 -0
  55. package/src/commands/_lib/session/tasks.ts +181 -0
  56. package/src/commands/_lib/settings/advisor.ts +75 -0
  57. package/src/commands/_lib/settings/agents.ts +137 -0
  58. package/src/commands/_lib/settings/choices.ts +8 -0
  59. package/src/commands/_lib/settings/config.ts +141 -0
  60. package/src/commands/_lib/settings/effort.ts +147 -0
  61. package/src/commands/_lib/settings/hooks.ts +50 -0
  62. package/src/commands/_lib/settings/messages.ts +408 -0
  63. package/src/commands/_lib/settings/mode.ts +100 -0
  64. package/src/commands/_lib/settings/model.ts +181 -0
  65. package/src/commands/_lib/settings/output-style.ts +39 -0
  66. package/src/commands/_lib/settings/permissions.ts +287 -0
  67. package/src/commands/_lib/settings/route.ts +63 -0
  68. package/src/commands/_lib/settings/session-config.ts +49 -0
  69. package/src/commands/_lib/settings/skills.ts +93 -0
  70. package/src/commands/_lib/settings/theme.ts +42 -0
  71. package/src/commands/_lib/speech/messages.ts +58 -0
  72. package/src/commands/_lib/speech/prompts.ts +4 -0
  73. package/src/commands/_lib/speech/say.ts +95 -0
  74. package/src/commands/_lib/speech/transcribe.ts +121 -0
  75. package/src/commands/_lib/speech/voice.ts +142 -0
  76. package/src/commands/_lib/status/cache.ts +31 -0
  77. package/src/commands/_lib/status/context.ts +57 -0
  78. package/src/commands/_lib/status/doctor.ts +205 -0
  79. package/src/commands/_lib/status/messages.ts +100 -0
  80. package/src/commands/_lib/status/meta.ts +24 -0
  81. package/src/commands/_lib/status/status.ts +128 -0
  82. package/src/commands/_lib/status/usage-tools.ts +48 -0
  83. package/src/commands/_lib/status/usage.ts +128 -0
  84. package/src/commands/_lib/view.ts +34 -0
  85. package/src/commands/dev/dev-batches.cmd.ts +109 -0
  86. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  87. package/src/commands/dev/dev-plan.cmd.ts +51 -0
  88. package/src/commands/dev/dev-spec.cmd.ts +54 -0
  89. package/src/commands/dev/dev-status.cmd.ts +16 -0
  90. package/src/commands/git/branch.cmd.ts +27 -0
  91. package/src/commands/git/commit.cmd.ts +48 -0
  92. package/src/commands/git/diff.cmd.ts +26 -0
  93. package/src/commands/git/review.cmd.ts +36 -0
  94. package/src/commands/memory/memory.cmd.ts +48 -0
  95. package/src/commands/project/analyze.cmd.ts +32 -0
  96. package/src/commands/project/debug-tool-call.cmd.ts +62 -0
  97. package/src/commands/project/files.cmd.ts +22 -0
  98. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  99. package/src/commands/project/init.cmd.ts +14 -0
  100. package/src/commands/project/verify.cmd.ts +27 -0
  101. package/src/commands/session/assistant.cmd.ts +40 -0
  102. package/src/commands/session/btw.cmd.ts +18 -0
  103. package/src/commands/session/clear.cmd.ts +19 -0
  104. package/src/commands/session/compact.cmd.ts +16 -0
  105. package/src/commands/session/copy.cmd.ts +45 -0
  106. package/src/commands/session/exit.cmd.ts +9 -0
  107. package/src/commands/session/export.cmd.ts +28 -0
  108. package/src/commands/session/rename.cmd.ts +18 -0
  109. package/src/commands/session/resume.cmd.ts +19 -0
  110. package/src/commands/session/rewind.cmd.ts +25 -0
  111. package/src/commands/session/summary.cmd.ts +27 -0
  112. package/src/commands/session/tasks.cmd.ts +46 -0
  113. package/src/commands/settings/advisor.cmd.ts +38 -0
  114. package/src/commands/settings/agents.cmd.ts +19 -0
  115. package/src/commands/settings/config.cmd.ts +19 -0
  116. package/src/commands/settings/effort.cmd.ts +19 -0
  117. package/src/commands/settings/fast.cmd.ts +18 -0
  118. package/src/commands/settings/hooks.cmd.ts +17 -0
  119. package/src/commands/settings/mode.cmd.ts +20 -0
  120. package/src/commands/settings/model.cmd.ts +21 -0
  121. package/src/commands/settings/output-style.cmd.ts +19 -0
  122. package/src/commands/settings/permissions.cmd.ts +25 -0
  123. package/src/commands/settings/proactive.cmd.ts +16 -0
  124. package/src/commands/settings/route.cmd.ts +16 -0
  125. package/src/commands/settings/skills.cmd.ts +17 -0
  126. package/src/commands/settings/theme.cmd.ts +14 -0
  127. package/src/commands/speech/say.cmd.ts +24 -0
  128. package/src/commands/speech/transcribe.cmd.ts +29 -0
  129. package/src/commands/speech/voice.cmd.ts +30 -0
  130. package/src/commands/status/context.cmd.ts +18 -0
  131. package/src/commands/status/doctor.cmd.ts +27 -0
  132. package/src/commands/status/release-notes.cmd.ts +9 -0
  133. package/src/commands/status/status.cmd.ts +25 -0
  134. package/src/commands/status/usage.cmd.ts +21 -0
  135. package/src/crews/.orkeon/orkeon.d.ts +4391 -0
  136. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  137. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
  138. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  139. package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
  140. package/src/crews/advisor/application/messages.ts +4 -0
  141. package/src/crews/advisor/application/prompts.ts +4 -0
  142. package/src/crews/advisor/application/run-advisor.ts +41 -0
  143. package/src/crews/advisor/crew.ork.ts +44 -0
  144. package/src/crews/advisor/domain/advice.ts +119 -0
  145. package/src/crews/advisor/domain/messages.ts +8 -0
  146. package/src/crews/advisor/domain/prompts.ts +26 -0
  147. package/src/crews/agent-run/application/messages.ts +18 -0
  148. package/src/crews/agent-run/application/run-agent-run.ts +43 -0
  149. package/src/crews/agent-run/crew.ork.ts +67 -0
  150. package/src/crews/analyze/application/messages.ts +27 -0
  151. package/src/crews/analyze/application/prompts.ts +4 -0
  152. package/src/crews/analyze/application/run-analyze.ts +120 -0
  153. package/src/crews/analyze/crew.ork.ts +41 -0
  154. package/src/crews/analyze/domain/harvest.ts +269 -0
  155. package/src/crews/analyze/domain/prompts.ts +86 -0
  156. package/src/crews/code-review/application/lens-material.ts +24 -0
  157. package/src/crews/code-review/application/messages.ts +17 -0
  158. package/src/crews/code-review/application/prompts.ts +126 -0
  159. package/src/crews/code-review/application/review.ts +74 -0
  160. package/src/crews/code-review/application/run-code-review.ts +121 -0
  161. package/src/crews/code-review/crew.ork.ts +52 -0
  162. package/src/crews/code-review/domain/lenses.ts +154 -0
  163. package/src/crews/code-review/domain/messages.ts +25 -0
  164. package/src/crews/code-review/domain/prompts.ts +58 -0
  165. package/src/crews/code-review/domain/report.ts +58 -0
  166. package/src/crews/code-review/domain/scope.ts +106 -0
  167. package/src/crews/dev-batches/application/messages.ts +127 -0
  168. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  169. package/src/crews/dev-batches/application/prompts.ts +10 -0
  170. package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
  171. package/src/crews/dev-batches/application/run-wave.ts +452 -0
  172. package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
  173. package/src/crews/dev-batches/crew.ork.ts +146 -0
  174. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  175. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  176. package/src/crews/dev-batches/domain/batches-log.ts +52 -0
  177. package/src/crews/dev-batches/domain/markers.ts +5 -0
  178. package/src/crews/dev-batches/domain/messages.ts +6 -0
  179. package/src/crews/dev-batches/domain/wave-order.ts +44 -0
  180. package/src/crews/dev-change/application/change-material.ts +44 -0
  181. package/src/crews/dev-change/application/evidence.ts +172 -0
  182. package/src/crews/dev-change/application/messages.ts +81 -0
  183. package/src/crews/dev-change/application/prompts.ts +101 -0
  184. package/src/crews/dev-change/application/run-dev-change.ts +324 -0
  185. package/src/crews/dev-change/crew.ork.ts +114 -0
  186. package/src/crews/dev-change/domain/change-answer.ts +163 -0
  187. package/src/crews/dev-change/domain/change-render.ts +77 -0
  188. package/src/crews/dev-change/domain/markers.ts +28 -0
  189. package/src/crews/dev-change/domain/messages.ts +16 -0
  190. package/src/crews/dev-implement/application/close.ts +186 -0
  191. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  192. package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
  193. package/src/crews/dev-implement/application/messages.ts +161 -0
  194. package/src/crews/dev-implement/application/observe.ts +52 -0
  195. package/src/crews/dev-implement/application/prompts.ts +9 -0
  196. package/src/crews/dev-implement/application/report-writes.ts +46 -0
  197. package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
  198. package/src/crews/dev-implement/application/run-role.ts +27 -0
  199. package/src/crews/dev-implement/application/suite-job.ts +122 -0
  200. package/src/crews/dev-implement/application/touched.ts +74 -0
  201. package/src/crews/dev-implement/crew.ork.ts +69 -0
  202. package/src/crews/dev-implement/domain/contracts.ts +255 -0
  203. package/src/crews/dev-implement/domain/correction.ts +103 -0
  204. package/src/crews/dev-implement/domain/cycles.ts +36 -0
  205. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  206. package/src/crews/dev-implement/domain/markers.ts +23 -0
  207. package/src/crews/dev-implement/domain/messages.ts +58 -0
  208. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  209. package/src/crews/dev-implement/domain/roles.ts +49 -0
  210. package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
  211. package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
  212. package/src/crews/dev-implement/domain/step-checks.ts +137 -0
  213. package/src/crews/dev-implement/domain/step-section.ts +129 -0
  214. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  215. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  216. package/src/crews/dev-learn/application/messages.ts +51 -0
  217. package/src/crews/dev-learn/application/prompts.ts +99 -0
  218. package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
  219. package/src/crews/dev-learn/crew.ork.ts +53 -0
  220. package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
  221. package/src/crews/dev-learn/domain/messages.ts +65 -0
  222. package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
  223. package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
  224. package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
  225. package/src/crews/dev-plan/application/inventory.ts +174 -0
  226. package/src/crews/dev-plan/application/messages.ts +88 -0
  227. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  228. package/src/crews/dev-plan/application/prompts.ts +141 -0
  229. package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
  230. package/src/crews/dev-plan/crew.ork.ts +112 -0
  231. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  232. package/src/crews/dev-plan/domain/markers.ts +18 -0
  233. package/src/crews/dev-plan/domain/messages.ts +118 -0
  234. package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
  235. package/src/crews/dev-plan/domain/plan-render.ts +306 -0
  236. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  237. package/src/crews/dev-spec/application/messages.ts +30 -0
  238. package/src/crews/dev-spec/application/prompts.ts +93 -0
  239. package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
  240. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  241. package/src/crews/dev-spec/crew.ork.ts +110 -0
  242. package/src/crews/dev-spec/domain/markers.ts +30 -0
  243. package/src/crews/dev-spec/domain/messages.ts +39 -0
  244. package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
  245. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  246. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  247. package/src/crews/dev-verify/application/audit.ts +267 -0
  248. package/src/crews/dev-verify/application/capture.ts +311 -0
  249. package/src/crews/dev-verify/application/messages.ts +119 -0
  250. package/src/crews/dev-verify/application/prompts.ts +209 -0
  251. package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
  252. package/src/crews/dev-verify/application/run-gate.ts +204 -0
  253. package/src/crews/dev-verify/crew.ork.ts +103 -0
  254. package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
  255. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  256. package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
  257. package/src/crews/dev-verify/domain/commands.ts +103 -0
  258. package/src/crews/dev-verify/domain/gate.ts +131 -0
  259. package/src/crews/dev-verify/domain/markers.ts +16 -0
  260. package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
  261. package/src/crews/dev-verify/domain/messages.ts +92 -0
  262. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  263. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  264. package/src/crews/dev-verify/domain/text.ts +20 -0
  265. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  266. package/src/crews/git-commit/application/draft.ts +133 -0
  267. package/src/crews/git-commit/application/messages.ts +15 -0
  268. package/src/crews/git-commit/application/prompts.ts +47 -0
  269. package/src/crews/git-commit/application/run-git-commit.ts +117 -0
  270. package/src/crews/git-commit/crew.ork.ts +53 -0
  271. package/src/crews/git-commit/domain/commit.ts +200 -0
  272. package/src/crews/git-commit/domain/markers.ts +4 -0
  273. package/src/crews/git-commit/domain/messages.ts +48 -0
  274. package/src/crews/init-verifiers/application/authoring.ts +90 -0
  275. package/src/crews/init-verifiers/application/messages.ts +13 -0
  276. package/src/crews/init-verifiers/application/prompts.ts +107 -0
  277. package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
  278. package/src/crews/init-verifiers/crew.ork.ts +35 -0
  279. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  280. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  281. package/src/crews/main-loop/application/auto-compact.ts +78 -0
  282. package/src/crews/main-loop/application/context-gather.ts +133 -0
  283. package/src/crews/main-loop/application/messages.ts +81 -0
  284. package/src/crews/main-loop/application/prompts.ts +12 -0
  285. package/src/crews/main-loop/application/run-main-loop.ts +383 -0
  286. package/src/crews/main-loop/application/turn-context.ts +111 -0
  287. package/src/crews/main-loop/crew.ork.ts +124 -0
  288. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  289. package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
  290. package/src/crews/main-loop/domain/prompts.ts +336 -0
  291. package/src/crews/main-loop/domain/turn-chains.ts +130 -0
  292. package/src/crews/project-init/application/detect.ts +123 -0
  293. package/src/crews/project-init/application/messages.ts +15 -0
  294. package/src/crews/project-init/application/prompts.ts +105 -0
  295. package/src/crews/project-init/application/run-project-init.ts +31 -0
  296. package/src/crews/project-init/crew.ork.ts +36 -0
  297. package/src/crews/project-init/domain/conventions.ts +36 -0
  298. package/src/crews/project-init/domain/existing-files.ts +65 -0
  299. package/src/crews/project-init/domain/messages.ts +13 -0
  300. package/src/crews/project-init/domain/package-map.ts +73 -0
  301. package/src/crews/project-init/domain/prompts.ts +10 -0
  302. package/src/crews/session-compact/application/prompts.ts +5 -0
  303. package/src/crews/session-compact/crew.ork.ts +56 -0
  304. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  305. package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
  306. package/src/crews/speech/application/messages.ts +3 -0
  307. package/src/crews/speech/application/prompts.ts +3 -0
  308. package/src/crews/speech/application/run-speech.ts +26 -0
  309. package/src/crews/speech/crew.ork.ts +38 -0
  310. package/src/shared/application/agents/child-agent.ts +259 -0
  311. package/src/shared/application/agents/messages.ts +35 -0
  312. package/src/shared/application/agents/route-agent.ts +115 -0
  313. package/src/shared/application/agents/run-sub-agent.ts +119 -0
  314. package/src/shared/application/answer-language.ts +14 -0
  315. package/src/shared/application/attached-skills.ts +36 -0
  316. package/src/shared/application/compaction/compact-session.ts +242 -0
  317. package/src/shared/application/compaction/extract-memories.ts +38 -0
  318. package/src/shared/application/compaction/messages.ts +20 -0
  319. package/src/shared/application/compaction/prune-context.ts +94 -0
  320. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  321. package/src/shared/application/compaction/restore-context.ts +78 -0
  322. package/src/shared/application/config-store.ts +123 -0
  323. package/src/shared/application/dev/brief-inventory.ts +115 -0
  324. package/src/shared/application/dev/close-batch.ts +85 -0
  325. package/src/shared/application/dev/find-repo-pack.ts +78 -0
  326. package/src/shared/application/dev/learn-decision.ts +254 -0
  327. package/src/shared/application/dev/load-dev-context.ts +265 -0
  328. package/src/shared/application/dev/measure-access-cost.ts +69 -0
  329. package/src/shared/application/dev/messages.ts +132 -0
  330. package/src/shared/application/dev/phase-timer.ts +54 -0
  331. package/src/shared/application/dev/plan-source.ts +116 -0
  332. package/src/shared/application/dev/preflight.ts +71 -0
  333. package/src/shared/application/dev/project-files.ts +17 -0
  334. package/src/shared/application/dev/prompts.ts +34 -0
  335. package/src/shared/application/dev/question-round.ts +60 -0
  336. package/src/shared/application/dev/resolve-work-folder.ts +134 -0
  337. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  338. package/src/shared/application/dev/settle-questions.ts +57 -0
  339. package/src/shared/application/dev/source-review.ts +67 -0
  340. package/src/shared/application/dev/source-step.ts +152 -0
  341. package/src/shared/application/dev/spend.ts +55 -0
  342. package/src/shared/application/dev/step-precedents.ts +90 -0
  343. package/src/shared/application/dev/tool-call-policy.ts +87 -0
  344. package/src/shared/application/dev/tool-callbacks.ts +262 -0
  345. package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
  346. package/src/shared/application/dev/verdict-sources.ts +50 -0
  347. package/src/shared/application/dev/wrapped-tools.ts +147 -0
  348. package/src/shared/application/extra-tools.ts +71 -0
  349. package/src/shared/application/git/batch-worktree.ts +102 -0
  350. package/src/shared/application/git/commit-files.ts +191 -0
  351. package/src/shared/application/git/merge-batch.ts +67 -0
  352. package/src/shared/application/git/messages.ts +75 -0
  353. package/src/shared/application/git/open-pull-request.ts +52 -0
  354. package/src/shared/application/host-context.ts +59 -0
  355. package/src/shared/application/host-layout-store.ts +45 -0
  356. package/src/shared/application/instructions-file.ts +19 -0
  357. package/src/shared/application/json-file.ts +34 -0
  358. package/src/shared/application/llm-profile.ts +36 -0
  359. package/src/shared/application/messages.ts +14 -0
  360. package/src/shared/application/permission-rules.ts +169 -0
  361. package/src/shared/application/ports/approvals.ts +20 -0
  362. package/src/shared/application/ports/clock.ts +5 -0
  363. package/src/shared/application/ports/code-index.ts +93 -0
  364. package/src/shared/application/ports/crew.ts +60 -0
  365. package/src/shared/application/ports/decision.ts +14 -0
  366. package/src/shared/application/ports/files.ts +21 -0
  367. package/src/shared/application/ports/human.ts +38 -0
  368. package/src/shared/application/ports/llm.ts +83 -0
  369. package/src/shared/application/ports/memory.ts +30 -0
  370. package/src/shared/application/ports/progress.ts +23 -0
  371. package/src/shared/application/ports/runtime.ts +15 -0
  372. package/src/shared/application/ports/session.ts +74 -0
  373. package/src/shared/application/ports/shared-memory.ts +26 -0
  374. package/src/shared/application/ports/shell.ts +40 -0
  375. package/src/shared/application/ports/telemetry.ts +45 -0
  376. package/src/shared/application/ports/theme.ts +11 -0
  377. package/src/shared/application/ports/tools.ts +46 -0
  378. package/src/shared/application/ports/usage.ts +45 -0
  379. package/src/shared/application/ports.ts +29 -0
  380. package/src/shared/application/project-manifests.ts +106 -0
  381. package/src/shared/application/session-io.ts +85 -0
  382. package/src/shared/application/session-state.ts +36 -0
  383. package/src/shared/application/shared-memory/admit-entries.ts +179 -0
  384. package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
  385. package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
  386. package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
  387. package/src/shared/application/shared-memory/memory-files.ts +111 -0
  388. package/src/shared/application/shared-memory/memory-settings.ts +94 -0
  389. package/src/shared/application/shared-memory/messages.ts +63 -0
  390. package/src/shared/application/shared-memory/push-candidate.ts +149 -0
  391. package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
  392. package/src/shared/application/skills/messages.ts +4 -0
  393. package/src/shared/application/skills/suggest-skills.ts +102 -0
  394. package/src/shared/application/state-snapshot.ts +38 -0
  395. package/src/shared/application/workflow/messages.ts +8 -0
  396. package/src/shared/application/workflow/workflow-state.ts +136 -0
  397. package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
  398. package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
  399. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  400. package/src/shared/domain/agent-policy/messages.ts +66 -0
  401. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  402. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  403. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  404. package/src/shared/domain/agent-policy/permission.ts +625 -0
  405. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  406. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  407. package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
  408. package/src/shared/domain/agent-policy/tool-access.ts +91 -0
  409. package/src/shared/domain/agent-registry.ts +143 -0
  410. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  411. package/src/shared/domain/agents/chain.ts +30 -0
  412. package/src/shared/domain/agents/charter.ts +64 -0
  413. package/src/shared/domain/agents/exclusive.ts +25 -0
  414. package/src/shared/domain/agents/instances.ts +252 -0
  415. package/src/shared/domain/agents/messages.ts +39 -0
  416. package/src/shared/domain/agents/model-route.ts +199 -0
  417. package/src/shared/domain/agents/prompts.ts +20 -0
  418. package/src/shared/domain/code-intel-contract.ts +357 -0
  419. package/src/shared/domain/code-intel-routing.ts +60 -0
  420. package/src/shared/domain/compact-outcome.ts +46 -0
  421. package/src/shared/domain/compaction-thresholds.ts +162 -0
  422. package/src/shared/domain/compaction.ts +288 -0
  423. package/src/shared/domain/config-schema.ts +434 -0
  424. package/src/shared/domain/context-prune.ts +176 -0
  425. package/src/shared/domain/decision/questions.ts +102 -0
  426. package/src/shared/domain/dev/access-cost.ts +230 -0
  427. package/src/shared/domain/dev/artefacts.ts +50 -0
  428. package/src/shared/domain/dev/batches-concurrency.ts +35 -0
  429. package/src/shared/domain/dev/batches-state.ts +49 -0
  430. package/src/shared/domain/dev/build-commands.ts +45 -0
  431. package/src/shared/domain/dev/call-guard.ts +342 -0
  432. package/src/shared/domain/dev/carried-text.ts +47 -0
  433. package/src/shared/domain/dev/design-rules.ts +100 -0
  434. package/src/shared/domain/dev/learn-proposals.ts +176 -0
  435. package/src/shared/domain/dev/learn-state.ts +94 -0
  436. package/src/shared/domain/dev/markers.ts +107 -0
  437. package/src/shared/domain/dev/messages.ts +259 -0
  438. package/src/shared/domain/dev/path-args.ts +42 -0
  439. package/src/shared/domain/dev/path-rebase.ts +93 -0
  440. package/src/shared/domain/dev/phase-timing.ts +50 -0
  441. package/src/shared/domain/dev/plan-checks.ts +191 -0
  442. package/src/shared/domain/dev/plan-format.ts +170 -0
  443. package/src/shared/domain/dev/project-files.ts +29 -0
  444. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  445. package/src/shared/domain/dev/prompts.ts +251 -0
  446. package/src/shared/domain/dev/questions.ts +267 -0
  447. package/src/shared/domain/dev/reading-rule.ts +41 -0
  448. package/src/shared/domain/dev/repo-pack.ts +240 -0
  449. package/src/shared/domain/dev/review-answer.ts +173 -0
  450. package/src/shared/domain/dev/review-brief.ts +54 -0
  451. package/src/shared/domain/dev/reviewer-charter.ts +35 -0
  452. package/src/shared/domain/dev/sheet-facts.ts +81 -0
  453. package/src/shared/domain/dev/spec-format.ts +182 -0
  454. package/src/shared/domain/dev/step-budget.ts +74 -0
  455. package/src/shared/domain/dev/step-rules.ts +109 -0
  456. package/src/shared/domain/dev/test-commands.ts +94 -0
  457. package/src/shared/domain/dev/test-output.ts +33 -0
  458. package/src/shared/domain/dev/test-paths.ts +40 -0
  459. package/src/shared/domain/dev/tool-guards.ts +65 -0
  460. package/src/shared/domain/dev/trait-pattern.ts +87 -0
  461. package/src/shared/domain/dev/verdict-format.ts +162 -0
  462. package/src/shared/domain/dev/whitespace.ts +35 -0
  463. package/src/shared/domain/dev/work-folder.ts +68 -0
  464. package/src/shared/domain/dev/yaml-subset.ts +385 -0
  465. package/src/shared/domain/error-text.ts +13 -0
  466. package/src/shared/domain/git/close.ts +274 -0
  467. package/src/shared/domain/git/messages.ts +20 -0
  468. package/src/shared/domain/git/pull-request.ts +96 -0
  469. package/src/shared/domain/git/worktree.ts +46 -0
  470. package/src/shared/domain/host-layout.ts +147 -0
  471. package/src/shared/domain/host-paths.ts +399 -0
  472. package/src/shared/domain/index-languages.ts +16 -0
  473. package/src/shared/domain/instructions-file.ts +18 -0
  474. package/src/shared/domain/iso-day.ts +4 -0
  475. package/src/shared/domain/llm-failure.ts +134 -0
  476. package/src/shared/domain/llm-profile.ts +44 -0
  477. package/src/shared/domain/marked-message.ts +29 -0
  478. package/src/shared/domain/markers.ts +30 -0
  479. package/src/shared/domain/messages.ts +291 -0
  480. package/src/shared/domain/model-catalog.ts +79 -0
  481. package/src/shared/domain/permission-modes.ts +99 -0
  482. package/src/shared/domain/prelude.ts +92 -0
  483. package/src/shared/domain/project-manifests.ts +84 -0
  484. package/src/shared/domain/prompts.ts +233 -0
  485. package/src/shared/domain/search-routing.ts +77 -0
  486. package/src/shared/domain/secret-patterns.ts +46 -0
  487. package/src/shared/domain/session-keys.ts +92 -0
  488. package/src/shared/domain/session-start.ts +61 -0
  489. package/src/shared/domain/severity.ts +72 -0
  490. package/src/shared/domain/sha1.ts +61 -0
  491. package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
  492. package/src/shared/domain/shared-memory/candidates.ts +40 -0
  493. package/src/shared/domain/shared-memory/entry.ts +151 -0
  494. package/src/shared/domain/shared-memory/front-matter.ts +187 -0
  495. package/src/shared/domain/shared-memory/gate.ts +45 -0
  496. package/src/shared/domain/shared-memory/harvest.ts +64 -0
  497. package/src/shared/domain/shared-memory/layout.ts +190 -0
  498. package/src/shared/domain/shared-memory/markers.ts +9 -0
  499. package/src/shared/domain/shared-memory/messages.ts +66 -0
  500. package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
  501. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  502. package/src/shared/domain/shared-memory/refused.ts +84 -0
  503. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  504. package/src/shared/domain/skills/prompts.ts +4 -0
  505. package/src/shared/domain/skills/shortlist.ts +149 -0
  506. package/src/shared/domain/snip-turns.ts +33 -0
  507. package/src/shared/domain/speech.ts +21 -0
  508. package/src/shared/domain/strip.ts +88 -0
  509. package/src/shared/domain/tool-trace.ts +120 -0
  510. package/src/shared/domain/types.ts +67 -0
  511. package/src/shared/domain/verifiers.ts +33 -0
  512. package/src/shared/domain/vfs.ts +16 -0
  513. package/src/shared/domain/workflow/prompts.ts +15 -0
  514. package/src/shared/domain/workflow/state-file.ts +142 -0
  515. package/src/shared/infrastructure/globals.ts +57 -0
  516. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  517. package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
  518. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  519. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  520. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  521. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  522. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  523. package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
  524. package/src/shared/infrastructure/orkeon/files.ts +58 -0
  525. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
  526. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  527. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  528. package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
  529. package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
  530. package/src/shared/infrastructure/orkeon/llm.ts +164 -0
  531. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  532. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  533. package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
  534. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  535. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  536. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  537. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  538. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  539. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  540. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  541. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  542. package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
  543. package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
  544. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  545. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  546. package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
  547. package/src/shared/infrastructure/orkeon/shell.ts +39 -0
  548. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  549. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
  550. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  551. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  552. package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
@@ -0,0 +1,55 @@
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
+ import { REVIEWER_LOOKUPS } from "../../domain/dev/reviewer-charter.ts";
5
+ import { budgetSpent, lookupsSpent } from "./prompts.ts";
6
+
7
+ /** A batch's tool calls: counted, and refused once `limit` is reached. A call to a tool the act does not offer is
8
+ * refused by the runtime before `onToolCall` (Orkeon #193): it costs nothing here, the act's `maxIterations` bounds it.
9
+ * A call the host's gate refuses is counted: the gate judges after `onToolCall` (Orkeon #303). */
10
+ export interface Spend {
11
+ readonly limit: number;
12
+ calls(): number;
13
+ /** True once a call was refused: a batch that used exactly its `limit`, none refused, is not stopped. */
14
+ exhausted(): boolean;
15
+ /** Counts one call; false, and nothing counted, once the limit is reached. */
16
+ take(): boolean;
17
+ }
18
+
19
+ export function createSpend(limit: number): Spend {
20
+ let calls = 0;
21
+ let denied = 0;
22
+ return {
23
+ limit,
24
+ calls: () => calls,
25
+ exhausted: () => denied > 0,
26
+ take: () => (calls >= limit ? (denied++, false) : (calls++, true)),
27
+ };
28
+ }
29
+
30
+ /** `callbacks` denying every call past the spend's limit with what `spent` says of it (a batch's budget when not
31
+ * given); `callbacks` themselves without a spend. */
32
+ export function spendGuard<C extends Pick<ToolCallbacks, "forAct">>(
33
+ callbacks: C, spend: Spend | undefined, spent: (limit: number) => string = budgetSpent,
34
+ ): C {
35
+ if (spend === undefined) return callbacks;
36
+ return {
37
+ ...callbacks,
38
+ forAct(mode: string, gateEnabled: boolean | undefined) {
39
+ const inner = callbacks.forAct(mode, gateEnabled);
40
+ return {
41
+ ...inner,
42
+ onToolCall: async (call) => (spend.take()
43
+ ? inner.onToolCall(call)
44
+ : { deny: spent(spend.limit) }),
45
+ };
46
+ },
47
+ };
48
+ }
49
+
50
+ /** The callbacks of one act of the reviewer of a plan, a spec or a brief: `callbacks` under a fresh spend of
51
+ * REVIEWER_LOOKUPS calls, a call past it refused with the order to write the findings. One spend per act: call it
52
+ * once for each. */
53
+ export function reviewerCallbacks<C extends Pick<ToolCallbacks, "forAct">>(callbacks: C): C {
54
+ return spendGuard(callbacks, createSpend(REVIEWER_LOOKUPS), lookupsSpent);
55
+ }
@@ -0,0 +1,90 @@
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
+ import { namedRecallFailed } from "./messages.ts";
15
+
16
+ /** T1 spec or change start, T2 plan start, T3 before a batch's red tests, T4 before the audit, T5 a correction. */
17
+ export type RecallTrigger = "T1" | "T2" | "T3" | "T4" | "T5";
18
+
19
+ export const TRIGGER_TYPES: Readonly<Record<RecallTrigger, readonly EntryType[]>> = {
20
+ T1: ["decision", "method"],
21
+ T2: ["decision", "code-structure"],
22
+ T3: ["code-structure", "mistake"],
23
+ T4: ["mistake"],
24
+ T5: ["mistake"],
25
+ };
26
+
27
+ /** A query is a few hundred characters: the index embeds it, a longer one only dilutes it. */
28
+ export const MAX_RECALL_QUERY_CHARS = 400;
29
+
30
+ export interface Recalled {
31
+ /** The "## Precedents" block, or "" when nothing was recalled. */
32
+ block: string;
33
+ /** The ids recalled (a bound may leave some out of the block, which counts them): the step's end message names them. */
34
+ ids: string[];
35
+ }
36
+
37
+ export const NOTHING_RECALLED: Recalled = { block: "", ids: [] };
38
+
39
+ /** What a dev step calls: the precedents of one trigger for one query. Never throws. */
40
+ export type StepPrecedents = (trigger: RecallTrigger, query: string) => Promise<Recalled>;
41
+
42
+ /** The step that recalls nothing: a test's default, and the crew's when memory_recall is denied. */
43
+ export const noPrecedents: StepPrecedents = async () => NOTHING_RECALLED;
44
+
45
+ /** The query of a trigger: the parts in order, each line's spaces collapsed, blank ones dropped, cut at the bound. */
46
+ export function recallQuery(parts: readonly string[]): string {
47
+ const text = parts.map((p) => p.replace(/\s+/g, " ").trim()).filter((p) => p !== "").join(" — ");
48
+ return text.length <= MAX_RECALL_QUERY_CHARS ? text : text.slice(0, MAX_RECALL_QUERY_CHARS).trimEnd();
49
+ }
50
+
51
+ /** A sheet's or a plan's title: its first "# " heading, "" when none. */
52
+ export function sheetTitle(text: string): string {
53
+ const line = text.split("\n").find((l) => l.startsWith("# "));
54
+ return line === undefined ? "" : line.slice(2).trim();
55
+ }
56
+
57
+ export interface StepPrecedentsDeps {
58
+ memory: Pick<SharedMemory, "search">;
59
+ files: Pick<Files, "read">;
60
+ config: Pick<ConfigStore, "readValue">;
61
+ shell: Pick<Shell, "run">;
62
+ log: Pick<Logger, "warn">;
63
+ }
64
+
65
+ const firstLine = (e: unknown): string => String((e as Error)?.message ?? e).split("\n")[0];
66
+
67
+ /** The recall of one run of a step; `on: false` (a session rule denies memory_recall) recalls nothing. */
68
+ export function stepPrecedents(deps: StepPrecedentsDeps, options: { on: boolean }): StepPrecedents {
69
+ if (!options.on) return noPrecedents;
70
+ let settings: Promise<MemorySettings> | null = null;
71
+ return async (trigger, query) => {
72
+ try {
73
+ settings ??= readMemorySettings(deps);
74
+ const memory = await settings;
75
+ const recall = await recallEntries(deps, { memory, query, types: TRIGGER_TYPES[trigger] });
76
+ const block = buildPrecedentsBlock(recall.precedents);
77
+ return block === "" ? NOTHING_RECALLED : { block, ids: recall.precedents.map((p) => p.entry.id) };
78
+ } catch (error) {
79
+ settings = null; // a failed read is tried again at the next trigger, not kept for the run
80
+ deps.log.warn(namedRecallFailed(trigger, firstLine(error)));
81
+ return NOTHING_RECALLED;
82
+ }
83
+ };
84
+ }
85
+
86
+ /** The end-message line of a step that recalled: "" when nothing was. */
87
+ export function precedentsLine(recalled: readonly Recalled[]): string {
88
+ const ids = [...new Set(recalled.flatMap((r) => r.ids))];
89
+ return ids.length === 0 ? "" : `precedents recalled: ${ids.join(", ")}`;
90
+ }
@@ -0,0 +1,87 @@
1
+ // What a dev crew's onToolCall decides for one call, before the host's gate judges it, 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
+ import { MEMORY_CONTEXT, MEMORY_GUARD, callbackFailed, hookMountCheckDeny, hookRefusedDeny } from "./prompts.ts";
13
+ import { mountCheckRefusedPreHook, preHookRefused, relativePathResolved } from "./messages.ts";
14
+
15
+ /** The runtime's verdict and result callbacks, as ActOptions types them (the subset the callbacks return): allow,
16
+ * deny, or allow with the call's input rewritten (a relative path resolved). */
17
+ export type ToolCallVerdict = "allow" | { deny: string } | { input: unknown };
18
+
19
+ /** What stopped a hook: the hook itself (its exit, its time, its start), or the runtime's mount check, which refuses a
20
+ * command line naming a mount path the shell may not hand to its program, before the hook runs. */
21
+ export interface HookFailure { by: "hook" | "mount-check"; text: string }
22
+
23
+ /** What the decision asks of the world, one call at a time. */
24
+ export interface CallProbes {
25
+ /** The shared memory's folder (memory.dir); null: the memory is not guarded here. */
26
+ memoryDir(): Promise<string | null>;
27
+ /** True when `path` names no file yet, false when it names one; undefined when it cannot be told. */
28
+ newFile(path: string): Promise<boolean | undefined>;
29
+ /** Runs one pre-tool hook on the call; undefined when it passed, else what stopped it. */
30
+ runHook(hook: ToolHook, tool: string, input: unknown): Promise<HookFailure | undefined>;
31
+ }
32
+
33
+ /** The verdict, and the lines the callbacks log for it (at info). */
34
+ export interface CallJudgement { verdict: ToolCallVerdict; notes: string[] }
35
+
36
+ /** The refusal of a write into the shared memory, `why` its reason (memoryWriteRefusal), without a step's name. */
37
+ export function memoryDenyText(why: string): string {
38
+ return `${MEMORY_GUARD}: ${why}\n${MEMORY_CONTEXT}`;
39
+ }
40
+
41
+ /** The refusal of a call a pre-tool hook stopped, led by the step's name. */
42
+ function hookDenyText(step: string, failure: HookFailure): string {
43
+ return failure.by === "mount-check"
44
+ ? hookMountCheckDeny(step, failure.text)
45
+ : hookRefusedDeny(step, failure.text);
46
+ }
47
+
48
+ export async function judgeToolCall(
49
+ guard: CallGuard, call: { name: string; input: unknown }, act: Omit<ActFacts, "newFile">, probes: CallProbes,
50
+ ): Promise<CallJudgement> {
51
+ const notes: string[] = [];
52
+ const judged = (verdict: ToolCallVerdict): CallJudgement => ({ verdict, notes });
53
+ // A throw would deny too, with the bare message: the catch keeps the step's name in front.
54
+ try {
55
+ // A relative path is resolved under the checkout first: the guard, the hooks and the tool see the resolved one
56
+ // (the runtime would resolve it too, after the guard: too late for the rules and the hooks).
57
+ const resolved = resolvePathInput(call.name, call.input);
58
+ const input = resolved ?? call.input;
59
+ if (resolved !== null) notes.push(relativePathResolved(guard.step, call.name));
60
+ const dir = await probes.memoryDir();
61
+ const memory = dir === null ? null : memoryWriteRefusal(dir, call.name, input);
62
+ if (memory !== null) {
63
+ notes.push(`${guard.step}: callback refused ${call.name}: ${memory}`);
64
+ return judged({ deny: `${guard.step}: ${memoryDenyText(memory)}` });
65
+ }
66
+ const path = (input as { path?: unknown } | null)?.path;
67
+ const rewrite = sameToolName(call.name, REWRITE_TOOL) && typeof path === "string"
68
+ && guard.rules.some((r) => r.origin.kind === "rewrite");
69
+ const newFile = rewrite ? await probes.newFile(path as string) : undefined;
70
+ const verdict = checkToolCall(guard, call.name, input, { ...act, ...(newFile === undefined ? {} : { newFile }) });
71
+ if (!verdict.allow) {
72
+ notes.push(`${guard.step}: callback refused ${call.name}: ${verdict.reason}`);
73
+ return judged({ deny: denyText(verdict) });
74
+ }
75
+ for (const hook of guard.hooks.filter((h) => h.event === "pre-tool")) {
76
+ const failed = await probes.runHook(hook, call.name, input);
77
+ if (failed === undefined) continue;
78
+ notes.push(failed.by === "mount-check"
79
+ ? mountCheckRefusedPreHook(guard.step, hook.n, call.name)
80
+ : preHookRefused(guard.step, hook.n, call.name));
81
+ return judged({ deny: hookDenyText(guard.step, failed) });
82
+ }
83
+ return judged(resolved === null ? "allow" : { input: resolved });
84
+ } catch (e) {
85
+ return judged({ deny: callbackFailed(guard.step, String((e as Error)?.message ?? e)) });
86
+ }
87
+ }
@@ -0,0 +1,262 @@
1
+ // The dev crews' onToolCall and onToolResult (RT-04), built from a crew's inputs and handed to every act through
2
+ // agentLlm(ctx, callbacks). The callback runs before the host's gate, which judges the input it returns (Orkeon #303): 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 { callToVirtual, textToVirtual } from "../../domain/host-paths.ts";
17
+ import { pathListRefusal } from "../../domain/agent-policy/path-rules.ts";
18
+ import { isIdentityContext } from "../host-context.ts";
19
+ import type { HostContext } from "../host-context.ts";
20
+ import type { CallGuard, CallGuardSpec, ToolHook } from "../../domain/dev/call-guard.ts";
21
+ import { WORKSPACE } from "../../domain/vfs.ts";
22
+ import { judgeToolCall, memoryDenyText } from "./tool-call-policy.ts";
23
+ import type { CallProbes, HookFailure, ToolCallVerdict } from "./tool-call-policy.ts";
24
+
25
+ export type { HookFailure, ToolCallVerdict } from "./tool-call-policy.ts";
26
+ import { memoryGuardFailed, mountCheckRefusedHook } from "./prompts.ts";
27
+ import { couldNotRun as hookCouldNotRun } from "../messages.ts";
28
+ import { postHooksFailed } from "./messages.ts";
29
+
30
+ /** A hook is stopped after this many seconds, and refuses (pre) or is reported (post). */
31
+ export const HOOK_TIMEOUT_SECONDS = 60;
32
+
33
+ /** The runtime's verdict and result callbacks, as ActOptions types them (the subset this module returns). */
34
+ export interface ActCallbacks {
35
+ onToolCall: (call: { name: string; input: unknown }) => Promise<ToolCallVerdict>;
36
+ onToolResult: (call: { name: string; input: unknown }, result: unknown) => Promise<void | { context: string }>;
37
+ }
38
+
39
+ /** What createLlm asks for each act: the callbacks for the act's mode and what the host says of its gate. */
40
+ export interface ToolCallbacks {
41
+ guard: CallGuard;
42
+ forAct(mode: string, gateEnabled: boolean | undefined): ActCallbacks;
43
+ }
44
+
45
+ export interface ToolCallbackDeps {
46
+ shell: Pick<Shell, "run">;
47
+ log?: Pick<Logger, "info" | "warn">;
48
+ /** Reads a file_write's path under a rewrite rule; none: the rule holds on every path. */
49
+ files?: Pick<Files, "read">;
50
+ /** The shared memory's folder (memory.dir): the callback denies a write under its candidates or entries the gate
51
+ * cannot see (memoryWriteRefusal). None: not checked here. */
52
+ memoryDir?: () => Promise<string>;
53
+ }
54
+
55
+ /** A reader of the memory folder that asks once: every call of an act needs it, the setting does not move. */
56
+ export function onceMemoryDir(read: () => Promise<string>): () => Promise<string> {
57
+ let dir: Promise<string> | null = null;
58
+ return () => (dir ??= read());
59
+ }
60
+
61
+ /** The callbacks of an act that runs no dev step (the main loop): the shared memory's guard alone, no hook. */
62
+ export function memoryGuardCallbacks(memoryDir: () => Promise<string>): Pick<ToolCallbacks, "forAct"> {
63
+ const dir = onceMemoryDir(memoryDir);
64
+ return {
65
+ forAct() {
66
+ return {
67
+ async onToolCall(call) {
68
+ try {
69
+ const why = memoryWriteRefusal(await dir(), call.name, call.input);
70
+ return why === null ? "allow" : { deny: memoryDenyText(why) };
71
+ } catch (e) {
72
+ return { deny: memoryGuardFailed(String((e as Error)?.message ?? e)) };
73
+ }
74
+ },
75
+ async onToolResult() { return undefined; },
76
+ };
77
+ },
78
+ };
79
+ }
80
+
81
+ /** True when the runtime says `path` names no file (its "not found"), false when it reads; undefined otherwise. */
82
+ export async function isNewFile(files: Pick<Files, "read">, path: string): Promise<boolean | undefined> {
83
+ const trimmed = path.trim();
84
+ if (trimmed === "") return undefined;
85
+ const virtual = trimmed.startsWith("/") ? trimmed : `${WORKSPACE}/${trimmed.replace(/^(\.\/)+/, "")}`;
86
+ try {
87
+ await files.read(virtual, 1);
88
+ return false;
89
+ } catch (e) {
90
+ return /not found|no such file|does not exist/i.test(String((e as Error)?.message ?? e)) ? true : undefined;
91
+ }
92
+ }
93
+
94
+ /** The first line of what a hook printed, its error output first, at most 200 characters. */
95
+ function firstLine(stderr: string, stdout: string): string {
96
+ const line = (stderr.trim() || stdout.trim()).split("\n")[0] ?? "";
97
+ return line.length > 200 ? `${line.slice(0, 200)}…` : line;
98
+ }
99
+
100
+ /** The inputs a hook sees for one call: the call's own, or one `{ path }` per operation of an edit_batch, so a
101
+ * per-file hook hears every file the batch writes. */
102
+ export function hookInputs(tool: string, input: unknown): unknown[] {
103
+ const ops = (input as { operations?: unknown } | null)?.operations;
104
+ if (!sameToolName(tool, OPERATIONS_TOOL) || !Array.isArray(ops) || ops.length === 0) return [input];
105
+ return ops.map((op: unknown) => ({ path: (op as { path?: unknown } | null)?.path }));
106
+ }
107
+
108
+ /** The runtime shell's refusal of a command line by its mount check (ShellCommandTool), else null. */
109
+ const MOUNT_DENIAL = /^(?:Command argument denied by file system|Argument denied):/;
110
+
111
+ function mountDenial(text: string): string | null {
112
+ const line = text.trim().split("\n")[0] ?? "";
113
+ return MOUNT_DENIAL.test(line) ? line : null;
114
+ }
115
+
116
+ async function runHooks(deps: ToolCallbackDeps, hook: ToolHook, tool: string, input: unknown): Promise<HookFailure | undefined> {
117
+ for (const one of hookInputs(tool, input)) {
118
+ const failed = await runHook(deps, hook, tool, one);
119
+ if (failed !== undefined) return failed;
120
+ }
121
+ return undefined;
122
+ }
123
+
124
+ /** Runs one hook; undefined when it exited 0, else what went wrong in one line and who stopped it. */
125
+ async function runHook(deps: ToolCallbackDeps, hook: ToolHook, tool: string, input: unknown): Promise<HookFailure | undefined> {
126
+ const command = hookCommand(hook, tool, input);
127
+ const label = `${hook.event} hook #${hook.n} (${command})`;
128
+ const refused = (denial: string): HookFailure =>
129
+ ({ by: "mount-check", text: mountCheckRefusedHook(label, denial) });
130
+ try {
131
+ const r = await deps.shell.run(command, { timeoutSeconds: HOOK_TIMEOUT_SECONDS });
132
+ // A refused command line comes back not completed: read as a timeout, it would hide the refusal.
133
+ const denial = r.exitCode === 0 ? null : mountDenial(r.stderr);
134
+ if (denial !== null) return refused(denial);
135
+ if (r.timedOut) return { by: "hook", text: `${label} stopped after ${HOOK_TIMEOUT_SECONDS} s` };
136
+ if (r.exitCode === 0) return undefined;
137
+ const said = firstLine(r.stderr, r.stdout);
138
+ return { by: "hook", text: `${label} exited ${r.exitCode}${said ? `: ${said}` : ""}` };
139
+ } catch (e) {
140
+ const message = String((e as Error)?.message ?? e);
141
+ const denial = mountDenial(message);
142
+ if (denial !== null) return refused(denial);
143
+ return { by: "hook", text: hookCouldNotRun(label, message.split("\n")[0]) };
144
+ }
145
+ }
146
+
147
+ /** The text the model was shown for a result, as the runtime passes it: a string as is, else its JSON. */
148
+ function shownText(result: unknown): string {
149
+ if (typeof result === "string") return result;
150
+ try {
151
+ return JSON.stringify(result) ?? String(result);
152
+ } catch {
153
+ return String(result);
154
+ }
155
+ }
156
+
157
+ export function createToolCallbacks(guard: CallGuard, deps: ToolCallbackDeps): ToolCallbacks {
158
+ const memoryDir = deps.memoryDir === undefined ? undefined : onceMemoryDir(deps.memoryDir);
159
+ const files = deps.files;
160
+ const probes: CallProbes = {
161
+ memoryDir: memoryDir ?? (async () => null),
162
+ newFile: files === undefined ? async () => undefined : (path) => isNewFile(files, path),
163
+ runHook: (hook, tool, input) => runHooks(deps, hook, tool, input),
164
+ };
165
+ const post = guard.hooks.filter((h) => h.event === "post-tool");
166
+ return {
167
+ guard,
168
+ forAct(mode, gateEnabled) {
169
+ return {
170
+ async onToolCall(call): Promise<ToolCallVerdict> {
171
+ const { verdict, notes } = await judgeToolCall(guard, call, { mode, gateEnabled }, probes);
172
+ for (const note of notes) deps.log?.info(note);
173
+ return verdict;
174
+ },
175
+ async onToolResult(call, result) {
176
+ if (post.length === 0) return undefined;
177
+ const notes: string[] = [];
178
+ for (const hook of post) {
179
+ const failed = await runHooks(deps, hook, call.name, call.input);
180
+ if (failed !== undefined) notes.push(`[${failed.text}]`);
181
+ }
182
+ if (notes.length === 0) return undefined;
183
+ deps.log?.warn(postHooksFailed(guard.step, notes.length, call.name));
184
+ return { context: [shownText(result), ...notes].join("\n") };
185
+ },
186
+ };
187
+ },
188
+ };
189
+ }
190
+
191
+ /** The callbacks of a dev crew from its spec (its step, role, roots and `hooks` input). */
192
+ export function devToolCallbacks(spec: CallGuardSpec, deps: ToolCallbackDeps): ToolCallbacks {
193
+ const guard = buildCallGuard(spec);
194
+ for (const problem of guard.problems) deps.log?.warn(`${spec.step}: ${problem}`);
195
+ return createToolCallbacks(guard, deps);
196
+ }
197
+
198
+ /**
199
+ * The callbacks of a batch run under its working root (a parallel /dev-batches): every string of a call's input
200
+ * comes back from the root to `/workspace` before `callbacks` see it, so the rule sets, the rewrite rule, the hooks
201
+ * and the writes a role reports name the logical checkout; a relative path is resolved under the root first, and
202
+ * the tool receives it resolved. Without a root, `callbacks` themselves.
203
+ */
204
+ export function rootedCallbacks<C extends Pick<ToolCallbacks, "forAct">>(callbacks: C, root: string | undefined): C {
205
+ if (root === undefined || root === "") return callbacks;
206
+ const logical = (call: { name: string; input: unknown }) => ({ name: call.name, input: mapStrings(call.input, (t) => textFromRoot(t, root)) });
207
+ return {
208
+ ...callbacks,
209
+ forAct(mode: string, gateEnabled: boolean | undefined) {
210
+ const inner = callbacks.forAct(mode, gateEnabled);
211
+ return {
212
+ ...inner,
213
+ onToolCall: async (call) => {
214
+ const resolved = resolvePathInput(call.name, call.input, root);
215
+ const verdict = await inner.onToolCall(logical(resolved === null ? call : { name: call.name, input: resolved }));
216
+ return verdict === "allow" && resolved !== null ? { input: resolved } : verdict;
217
+ },
218
+ onToolResult: (call, result) => inner.onToolResult(logical(call), result),
219
+ };
220
+ },
221
+ };
222
+ }
223
+
224
+ /**
225
+ * The outermost layer of every act's callbacks (createLlm wraps each act in it): the host's spellings and the
226
+ * user's path lists. Before the call, its path fields and its command are brought back to the canonical virtual
227
+ * spelling (host-paths.ts callToVirtual), the lists judge that spelling (path-rules.ts pathListRefusal), then
228
+ * `inner` sees the canonical call: an inner refusal stands; an inner `{ input }` is kept, canonicalised once more;
229
+ * an inner allow becomes `{ input }` when the spelling changed, so the runtime gates and runs the canonical call.
230
+ * After the call, every string of the result is read with its physical spellings canonicalised (textToVirtual)
231
+ * before `inner` sees it; an inner `{ context }` is canonicalised too; a result the spellings changed replaces
232
+ * what the model reads. The identity context (a posix host without mounts, no list) leaves `inner` as it is.
233
+ */
234
+ export function hostCallbacks(inner: ActCallbacks | undefined, host: HostContext): ActCallbacks | undefined {
235
+ if (isIdentityContext(host)) return inner;
236
+ const { layout, lists } = host;
237
+ const canonicalInput = (name: string, input: unknown): unknown => callToVirtual(name, input, layout) ?? input;
238
+ return {
239
+ async onToolCall(call): Promise<ToolCallVerdict> {
240
+ const input = canonicalInput(call.name, call.input);
241
+ const why = pathListRefusal(lists, layout, call.name, input);
242
+ if (why !== null) return { deny: why };
243
+ const changed = input !== call.input;
244
+ if (inner === undefined) return changed ? { input } : "allow";
245
+ const verdict = await inner.onToolCall({ name: call.name, input });
246
+ if (typeof verdict === "object" && "deny" in verdict) return verdict;
247
+ if (typeof verdict === "object" && "input" in verdict) return { input: canonicalInput(call.name, verdict.input) };
248
+ return changed ? { input } : verdict;
249
+ },
250
+ async onToolResult(call, result) {
251
+ const mapped = mapStrings(result, (text) => textToVirtual(text, layout));
252
+ const shown = shownText(mapped);
253
+ const changed = shown !== shownText(result);
254
+ if (inner === undefined) return changed ? { context: shown } : undefined;
255
+ const answer = await inner.onToolResult({ name: call.name, input: canonicalInput(call.name, call.input) }, mapped);
256
+ if (answer !== undefined && answer !== null && typeof answer === "object" && typeof answer.context === "string") {
257
+ return { context: textToVirtual(answer.context, layout) };
258
+ }
259
+ return changed ? { context: shown } : undefined;
260
+ },
261
+ };
262
+ }
@@ -0,0 +1,46 @@
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 after `onToolCall` (Orkeon #303) comes back as a `DENIED:` result through the
26
+ * host's invocation pipeline, recorded like any other; one the callback denies gets no result. */
27
+ export function tracedCallbacks(inner: Pick<ToolCallbacks, "forAct">, trace: Pick<ToolTrace, "record">): Pick<ToolCallbacks, "forAct"> {
28
+ return {
29
+ forAct(mode, gateEnabled) {
30
+ const callbacks = inner.forAct(mode, gateEnabled);
31
+ return {
32
+ async onToolCall(call) {
33
+ const verdict = await callbacks.onToolCall(call);
34
+ if (typeof verdict === "object" && verdict !== null && "deny" in verdict) {
35
+ try { trace.record(call.name, call.input, { error: `denied: ${verdict.deny}` }); } catch { /* the trace is best-effort */ }
36
+ }
37
+ return verdict;
38
+ },
39
+ async onToolResult(call, result) {
40
+ try { trace.record(call.name, call.input, result); } catch { /* the trace is best-effort */ }
41
+ return callbacks.onToolResult(call, result);
42
+ },
43
+ };
44
+ },
45
+ };
46
+ }
@@ -0,0 +1,50 @@
1
+ // Every verdict file of the work folder (one listing per code folder, hidden folders skipped as the harness's
2
+ // learning script skips them), read as VerdictSource for collectLearnRows: what /dev-learn's backlog and the
3
+ // shared memory's harvest after a GAPS verdict both read. It reads only; a file that cannot be read becomes a
4
+ // warning, never a failure.
5
+ import type { Files } from "../ports.ts";
6
+ import type { WorkFolder } from "./resolve-work-folder.ts";
7
+ import { LEARN_FILE } from "../../domain/shared-memory/verdict-rows.ts";
8
+ import type { VerdictSource } from "../../domain/shared-memory/verdict-rows.ts";
9
+ import { folderListsTooMany, workListsTooMany } from "./messages.ts";
10
+ import { cannotBeRead } from "../messages.ts";
11
+
12
+ export const WORK_LIST_CAP = 1000;
13
+ export const FOLDER_LIST_CAP = 500;
14
+
15
+ const firstLine = (e: unknown): string => (e instanceof Error ? e.message : String(e)).split("\n")[0];
16
+ const bare = (entry: string): string => entry.replace(/\/+$/, "");
17
+
18
+ async function listOrEmpty(files: Pick<Files, "list">, path: string, cap: number): Promise<string[]> {
19
+ try {
20
+ return await files.list(path, cap);
21
+ } catch {
22
+ return [];
23
+ }
24
+ }
25
+
26
+ export async function readVerdictSources(
27
+ files: Pick<Files, "read" | "list">, work: Pick<WorkFolder, "folder" | "vfsPath">,
28
+ ): Promise<{ sources: VerdictSource[]; warnings: string[] }> {
29
+ const warnings: string[] = [];
30
+ const sources: VerdictSource[] = [];
31
+ if (work.vfsPath === null) return { sources, warnings };
32
+ const entries = await listOrEmpty(files, work.vfsPath, WORK_LIST_CAP);
33
+ for (const code of entries.map(bare).filter((e) => e !== "" && !e.startsWith("."))) {
34
+ const names = (await listOrEmpty(files, `${work.vfsPath}/${code}`, FOLDER_LIST_CAP)).map(bare);
35
+ if (names.length >= FOLDER_LIST_CAP) {
36
+ warnings.push(folderListsTooMany(`${work.folder}/${code}`, FOLDER_LIST_CAP));
37
+ }
38
+ for (const name of names.filter((n) => LEARN_FILE.test(n))) {
39
+ try {
40
+ sources.push({ code, name, text: await files.read(`${work.vfsPath}/${code}/${name}`) });
41
+ } catch (error) {
42
+ warnings.push(cannotBeRead(`${work.folder}/${code}/${name}`, firstLine(error)));
43
+ }
44
+ }
45
+ }
46
+ if (entries.length >= WORK_LIST_CAP) {
47
+ warnings.push(workListsTooMany(work.folder, WORK_LIST_CAP));
48
+ }
49
+ return { sources, warnings };
50
+ }