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,102 @@
1
+ // The questions asked of the host's decision model and the answers read back from it. A decision model answers
2
+ // typed questions about a state with calibrated numbers: one option among described ones, a level on a scale, the
3
+ // probability of a yes. Which model answers (the host's settings name it) is no concern of this module.
4
+
5
+ /** One option among described ones: `criteria` maps each option to what it means. */
6
+ export interface ChoiceDecision {
7
+ type: "choice";
8
+ criteria: Readonly<Record<string, string>>;
9
+ instructions?: string;
10
+ }
11
+
12
+ /** A level on a scale: `criteria` lists the levels, lowest first. */
13
+ export interface ScoreDecision {
14
+ type: "score";
15
+ criteria: readonly string[];
16
+ instructions?: string;
17
+ }
18
+
19
+ /** A yes or a no: `criteria.true` says what yes means. */
20
+ export interface YesNoDecision {
21
+ type: "noul";
22
+ criteria: { readonly true: string };
23
+ instructions?: string;
24
+ }
25
+
26
+ export type DecisionQuestion = ChoiceDecision | ScoreDecision | YesNoDecision;
27
+
28
+ /** The questions of one request, by name. */
29
+ export type DecisionQuestions = Readonly<Record<string, DecisionQuestion>>;
30
+
31
+ export type DecisionAnswer =
32
+ | { type: "choice"; choice: string; confidence: number; probabilities: Record<string, number> }
33
+ | { type: "score"; score: number; confidence: number }
34
+ | { type: "noul"; probability: number };
35
+
36
+ /** The answers of one request, by the name of their question. */
37
+ export type DecisionAnswers = Record<string, DecisionAnswer>;
38
+
39
+ /** A yes/no question: what yes means, and what is judged when it needs saying. */
40
+ export function yesNo(yes: string, instructions?: string): YesNoDecision {
41
+ return instructions === undefined ? { type: "noul", criteria: { true: yes } } : { type: "noul", criteria: { true: yes }, instructions };
42
+ }
43
+
44
+ function record(value: unknown): Record<string, unknown> | null {
45
+ return typeof value === "object" && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : null;
46
+ }
47
+
48
+ /** A number of [0, 1], or null. */
49
+ function share(value: unknown): number | null {
50
+ return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1 ? value : null;
51
+ }
52
+
53
+ function shares(value: unknown): Record<string, number> {
54
+ const out: Record<string, number> = {};
55
+ for (const [option, raw] of Object.entries(record(value) ?? {})) {
56
+ const p = share(raw);
57
+ if (p !== null) out[option] = p;
58
+ }
59
+ return out;
60
+ }
61
+
62
+ function answerOf(question: DecisionQuestion, raw: unknown): DecisionAnswer | null {
63
+ const answer = record(raw);
64
+ if (answer === null) return null;
65
+ if (question.type === "noul") {
66
+ const probability = share(answer.noul);
67
+ return probability === null ? null : { type: "noul", probability };
68
+ }
69
+ const confidence = share(answer.confidence);
70
+ if (confidence === null) return null;
71
+ if (question.type === "score") {
72
+ return typeof answer.score === "number" && Number.isFinite(answer.score) ? { type: "score", score: answer.score, confidence } : null;
73
+ }
74
+ const choice = answer.choice;
75
+ if (typeof choice !== "string" || !Object.hasOwn(question.criteria, choice)) return null;
76
+ return { type: "choice", choice, confidence, probabilities: shares(answer.probabilities) };
77
+ }
78
+
79
+ /**
80
+ * The answers of a decision model to `questions`, read from what it returned (an object by question name, or its
81
+ * JSON). Null unless every question has an answer of its own kind: a choice among the options asked, a score, a
82
+ * probability of [0, 1]. A caller that gets null does what it did without a decision model.
83
+ */
84
+ export function parseDecisionAnswers(questions: DecisionQuestions, raw: unknown): DecisionAnswers | null {
85
+ let value = raw;
86
+ if (typeof raw === "string") {
87
+ try {
88
+ value = JSON.parse(raw);
89
+ } catch {
90
+ return null;
91
+ }
92
+ }
93
+ const given = record(value);
94
+ if (given === null) return null;
95
+ const answers: DecisionAnswers = {};
96
+ for (const [name, question] of Object.entries(questions)) {
97
+ const answer = answerOf(question, given[name]);
98
+ if (answer === null) return null;
99
+ answers[name] = answer;
100
+ }
101
+ return answers;
102
+ }
@@ -0,0 +1,230 @@
1
+ // The access cost of a batch, measured by the runtime's `access_cost` over the code index: the
2
+ // reader of its report, the added lines of a diff, the mapping to `exit 0|2`, the flagged calls,
3
+ // the `Cost` line of the harness's access-cost.py, and the text of the capture's `cost` section.
4
+ // A port call, or an in-memory filter, inside a loop or a lambda blocks only on an added line, as
5
+ // `access-cost.py --diff` does. Pure.
6
+ import { WORKSPACE, workspaceRelative } from "../vfs.ts";
7
+ import {
8
+ backToDesign, CODE_INDEX_EMPTY, codeIndexHolds, costLine, costNotComputed, cutAtLines, MEMORY_FILTER_ON_AWAITED,
9
+ NO_CODE_INDEX_WIRED, NO_MEMBER_INDEXED, noChangedFile, noneAwaitsAPort, notIndexedReason, PORTS_IN_A_LAMBDA,
10
+ PORTS_IN_A_LOOP, PORTS_OUTSIDE_LOOPS,
11
+ } from "./messages.ts";
12
+
13
+ export type AccessCost =
14
+ | { state: "not-computed"; reason: string }
15
+ | { state: "measured"; exit: 0 | 2; flagged: string[]; costLine: string; detail: string };
16
+
17
+ export interface PortCall { receiver: string; method: string; line: number; inLoop: boolean; inLambda: boolean }
18
+ export interface MemoryFilter { line: number; method: string }
19
+ export interface CostTotals { reads: number; writes: number; loops: number; lambdas: number; memoryFilters: number }
20
+ export interface MemberCost { member: string; portCalls: PortCall[]; memoryFilters: MemoryFilter[]; cost: CostTotals }
21
+ export interface AccessCostReport { members: MemberCost[]; cost: CostTotals }
22
+
23
+ /** A root is a test root when its lower-case path holds "test" (AC:92,324). */
24
+ export function isTestRoot(root: string): boolean {
25
+ return root.toLowerCase().includes("test");
26
+ }
27
+
28
+ /** Under a test root, or a path that says test (AC:326-331). */
29
+ export function isTestFile(path: string, testRoots: readonly string[]): boolean {
30
+ for (const r of testRoots) if (path.startsWith(`${r.replace(/\/+$/, "")}/`)) return true;
31
+ return path.toLowerCase().includes("test");
32
+ }
33
+
34
+ /** The cost when the crew wires no code index. */
35
+ export const COST_NOT_WIRED: AccessCost = {
36
+ state: "not-computed",
37
+ reason: NO_CODE_INDEX_WIRED,
38
+ };
39
+
40
+ export function notComputed(reason: string): AccessCost {
41
+ return { state: "not-computed", reason };
42
+ }
43
+
44
+ /** No `/workspace` root in the index: the use case says so itself, the tool would answer an empty report. */
45
+ export function notIndexed(roots: readonly string[]): AccessCost {
46
+ const holds = roots.length === 0 ? CODE_INDEX_EMPTY : codeIndexHolds(roots, WORKSPACE);
47
+ return notComputed(notIndexedReason(holds));
48
+ }
49
+
50
+ /**
51
+ * The runtime's default receivers (AccessCostService.cs:13-17), which a `receivers` argument replaces. Kept
52
+ * here so that the pack's regex adds to it, as access-cost.py reads `tools.access_cost.receivers`.
53
+ */
54
+ export const DEFAULT_RECEIVERS =
55
+ "repositor|service|wrapper|client|provider|unitofwork|dbcontext|dbset|gateway|store|" +
56
+ "publisher|bus|mediator|cache|queue|adapter|channel|hub|sandbox|filesystem|" +
57
+ "^(this\\.)?_?(db|context|fs)$";
58
+
59
+ /** The `receivers` argument: none without the pack's regex, else the default or the pack's, case-insensitive. */
60
+ export function receiversArgument(pack: string | undefined): string | undefined {
61
+ if (pack === undefined || pack.trim() === "") return undefined;
62
+ return `(?i)(?:${DEFAULT_RECEIVERS})|(?:${pack.trim()})`;
63
+ }
64
+
65
+ /** The changed files the cost reads: under one of `roots` (all of them when `roots` is empty). */
66
+ export function underRoots(files: readonly string[], roots: readonly string[]): string[] {
67
+ const kept = roots.map((r) => r.trim().replace(/^\.\//, "").replace(/\/+$/, ""));
68
+ if (kept.length === 0 || kept.some((r) => r === "" || r === ".")) return [...files];
69
+ return files.filter((f) => kept.some((r) => f === r || f.startsWith(`${r}/`)));
70
+ }
71
+
72
+ /** The 1-based line numbers a unified diff adds to the new file; null when the text holds no hunk. */
73
+ export function addedLines(diff: string): Set<number> | null {
74
+ const added = new Set<number>();
75
+ let line = 0;
76
+ let inHunk = false;
77
+ let hunks = 0;
78
+ for (const text of diff.split("\n")) {
79
+ const hunk = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(text);
80
+ if (hunk !== null) { line = Number(hunk[1]); inHunk = true; hunks++; continue; }
81
+ if (!inHunk) continue;
82
+ if (text.startsWith("diff --git ")) { inHunk = false; continue; }
83
+ if (text.startsWith("+")) { added.add(line); line++; }
84
+ else if (text.startsWith(" ")) line++;
85
+ }
86
+ return hunks === 0 ? null : added;
87
+ }
88
+
89
+ function num(v: unknown): number | null {
90
+ return typeof v === "number" && Number.isFinite(v) ? v : null;
91
+ }
92
+
93
+ function totals(raw: unknown): CostTotals | null {
94
+ if (raw === null || typeof raw !== "object") return null;
95
+ const r = raw as Record<string, unknown>;
96
+ const reads = num(r.reads), writes = num(r.writes), loops = num(r.loops), lambdas = num(r.lambdas);
97
+ const memoryFilters = num(r.memory_filters);
98
+ if (reads === null || writes === null || loops === null || lambdas === null || memoryFilters === null) return null;
99
+ return { reads, writes, loops, lambdas, memoryFilters };
100
+ }
101
+
102
+ /** The `report` of `access_cost` (AccessCostDtos.cs, snake_case); null when a field is missing or mistyped. */
103
+ export function readAccessCostReport(raw: unknown): AccessCostReport | null {
104
+ if (raw === null || typeof raw !== "object") return null;
105
+ const r = raw as Record<string, unknown>;
106
+ const cost = totals(r.cost);
107
+ if (cost === null || !Array.isArray(r.members)) return null;
108
+ const members: MemberCost[] = [];
109
+ for (const m of r.members as unknown[]) {
110
+ if (m === null || typeof m !== "object") return null;
111
+ const o = m as Record<string, unknown>;
112
+ const memberCost = totals(o.cost);
113
+ if (typeof o.member !== "string" || memberCost === null || !Array.isArray(o.port_calls) || !Array.isArray(o.in_memory_filters)) return null;
114
+ const portCalls: PortCall[] = [];
115
+ for (const c of o.port_calls as unknown[]) {
116
+ const p = (c ?? {}) as Record<string, unknown>;
117
+ const line = num(p.line);
118
+ if (typeof p.receiver !== "string" || typeof p.method !== "string" || line === null) return null;
119
+ portCalls.push({ receiver: p.receiver, method: p.method, line, inLoop: p.in_loop === true, inLambda: p.in_lambda === true });
120
+ }
121
+ const memoryFilters: MemoryFilter[] = [];
122
+ for (const f of o.in_memory_filters as unknown[]) {
123
+ const p = (f ?? {}) as Record<string, unknown>;
124
+ const line = num(p.line);
125
+ if (typeof p.method !== "string" || line === null) return null;
126
+ memoryFilters.push({ line, method: p.method });
127
+ }
128
+ members.push({ member: o.member, portCalls, memoryFilters, cost: memberCost });
129
+ }
130
+ return { members, cost };
131
+ }
132
+
133
+ const LIST_MAX = 12;
134
+
135
+ function plural(n: number, word: string): string {
136
+ return `${n} ${word}${n === 1 ? "" : "s"}`;
137
+ }
138
+
139
+ /** The member as the capture shows it: its path relative to the checkout. */
140
+ function shownMember(fqn: string): string {
141
+ return workspaceRelative(fqn);
142
+ }
143
+
144
+ /** The file of a member: its FQN up to the first `::` (UniversalSemanticMapper.cs:371). */
145
+ function fileOf(fqn: string): string {
146
+ const at = fqn.indexOf("::");
147
+ return at < 0 ? fqn : fqn.slice(0, at);
148
+ }
149
+
150
+ /** The `Cost` line of access-cost.py:261. */
151
+ export function costLineOf(reads: number, writes: number, blocking: number): string {
152
+ const verdict = blocking === 0 ? "none" : backToDesign(blocking);
153
+ return costLine(plural(reads, "read"), plural(writes, "write"), verdict);
154
+ }
155
+
156
+ /**
157
+ * The measured cost of `report`. `added` maps a member's file (its virtual path) to the lines its diff adds;
158
+ * a file absent from it, or mapped to null, has unknown lines, which count as added.
159
+ */
160
+ export function measuredCost(report: AccessCostReport, added: ReadonlyMap<string, Set<number> | null>): AccessCost {
161
+ const detail: string[] = [];
162
+ const flagged: string[] = [];
163
+ const isAdded = (fqn: string, line: number): boolean => {
164
+ const lines = added.get(fileOf(fqn));
165
+ return lines === undefined || lines === null || lines.has(line);
166
+ };
167
+ const show = (title: string, items: string[]): void => {
168
+ if (items.length === 0) return;
169
+ const more = items.length > LIST_MAX ? ` / … +${items.length - LIST_MAX}` : "";
170
+ detail.push(`${title} (${items.length}): ${items.slice(0, LIST_MAX).join(" / ")}${more}`);
171
+ };
172
+ for (const m of report.members) {
173
+ if (m.portCalls.length === 0 && m.memoryFilters.length === 0) continue;
174
+ const member = shownMember(m.member);
175
+ const flat: string[] = [], loop: string[] = [], lambda: string[] = [], filters: string[] = [];
176
+ for (const c of m.portCalls) {
177
+ const label = `${c.receiver}.${c.method} L${c.line}`;
178
+ if (!c.inLoop && !c.inLambda) { flat.push(label); continue; }
179
+ const where = c.inLoop ? "in a loop" : "in a lambda";
180
+ const blocks = isAdded(m.member, c.line);
181
+ (c.inLoop ? loop : lambda).push(blocks ? label : `${label} (pre-existing)`);
182
+ if (blocks) flagged.push(`${member} L${c.line} ${c.receiver}.${c.method} ${where}`);
183
+ }
184
+ for (const f of m.memoryFilters) {
185
+ const blocks = isAdded(m.member, f.line);
186
+ filters.push(blocks ? `L${f.line} ${f.method}` : `L${f.line} ${f.method} (pre-existing)`);
187
+ if (blocks) flagged.push(`${member} L${f.line} ${f.method} memory filter`);
188
+ }
189
+ detail.push(`[${member}]`);
190
+ show(PORTS_OUTSIDE_LOOPS, flat);
191
+ show(PORTS_IN_A_LOOP, loop);
192
+ show(PORTS_IN_A_LAMBDA, lambda);
193
+ show(MEMORY_FILTER_ON_AWAITED, filters);
194
+ }
195
+ if (detail.length === 0) {
196
+ detail.push(report.members.length === 0
197
+ ? NO_MEMBER_INDEXED
198
+ : noneAwaitsAPort(plural(report.members.length, "member")));
199
+ }
200
+ return {
201
+ state: "measured",
202
+ exit: flagged.length > 0 ? 2 : 0,
203
+ flagged,
204
+ costLine: costLineOf(report.cost.reads, report.cost.writes, flagged.length),
205
+ detail: `${detail.join("\n")}\n`,
206
+ };
207
+ }
208
+
209
+ /** A batch that changes no file under the cost roots: nothing to measure, nothing blocks. */
210
+ export function nothingChanged(roots: readonly string[]): AccessCost {
211
+ const where = roots.length === 0 ? "" : ` under ${roots.join(" ")}`;
212
+ return { state: "measured", exit: 0, flagged: [], costLine: costLineOf(0, 0, 0), detail: noChangedFile(where) };
213
+ }
214
+
215
+ /** The line the command prints under the gate's green line. */
216
+ export function costSummary(cost: AccessCost): string {
217
+ return cost.state === "measured" ? cost.costLine : costNotComputed(cost.reason);
218
+ }
219
+
220
+ const DETAIL_LINES = 60;
221
+
222
+ export function costSection(cost: AccessCost): string {
223
+ if (cost.state === "not-computed") return `not computed: ${cost.reason}\n`;
224
+ const detail = cost.detail.split("\n");
225
+ if (detail.length > 0 && detail[detail.length - 1] === "") detail.pop();
226
+ const out = [`exit: ${cost.exit}`, ...detail.slice(0, DETAIL_LINES)];
227
+ if (detail.length > DETAIL_LINES) out.push(cutAtLines(DETAIL_LINES));
228
+ out.push(cost.costLine);
229
+ return `${out.join("\n")}\n`;
230
+ }
@@ -0,0 +1,50 @@
1
+ // Dev workflow artefacts: what a file of a work folder is, read from its name alone.
2
+ // Pure, no IO. The prefix group follows the harness's own `[A-Za-z0-9][\w.-]*`.
3
+
4
+ export type ArtefactKind = "spec" | "change" | "plan" | "sheet" | "verdict" | "batches-state";
5
+ export interface ArtefactName { kind: ArtefactKind; name: string; prefix: string; batch?: string }
6
+
7
+ /** A work code: a plain folder name, never a path. */
8
+ export const CODE_PATTERN: RegExp = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
9
+
10
+ export function isCode(value: string): boolean {
11
+ return CODE_PATTERN.test(value) && !value.includes("..");
12
+ }
13
+
14
+ const PREFIX = "([A-Za-z0-9][\\w.-]*)";
15
+
16
+ // Order matters: a sheet (`-PLAN-F1.md`) is tried before a plan so it never reads as one.
17
+ const PATTERNS: Array<{ kind: ArtefactKind; re: RegExp; batch: boolean }> = [
18
+ { kind: "spec", re: /^SPEC-(.+)\.md$/, batch: false },
19
+ { kind: "change", re: /^CHANGE-(.+)\.md$/, batch: false },
20
+ { kind: "sheet", re: new RegExp(`^${PREFIX}-PLAN-(F\\d+)\\.md$`), batch: true },
21
+ { kind: "plan", re: new RegExp(`^${PREFIX}-PLAN\\.md$`), batch: false },
22
+ { kind: "verdict", re: new RegExp(`^${PREFIX}-VERIFY-(F\\d+)\\.md$`), batch: true },
23
+ { kind: "batches-state", re: new RegExp(`^${PREFIX}-BATCHES-STATE\\.md$`), batch: false },
24
+ ];
25
+
26
+ export function classifyArtefact(fileName: string): ArtefactName | null {
27
+ for (const p of PATTERNS) {
28
+ const m = p.re.exec(fileName);
29
+ if (!m) continue;
30
+ const out: ArtefactName = { kind: p.kind, name: fileName, prefix: m[1] };
31
+ if (p.batch) out.batch = m[2];
32
+ return out;
33
+ }
34
+ return null;
35
+ }
36
+
37
+ const BATCH_ID = /^F(\d+)$/;
38
+
39
+ /** F2 before F10; non-F ids last, by text. */
40
+ export function compareBatchIds(a: string, b: string): number {
41
+ const ma = BATCH_ID.exec(a);
42
+ const mb = BATCH_ID.exec(b);
43
+ if (ma && mb) {
44
+ const d = Number(ma[1]) - Number(mb[1]);
45
+ return d !== 0 ? d : a < b ? -1 : a > b ? 1 : 0;
46
+ }
47
+ if (ma) return -1;
48
+ if (mb) return 1;
49
+ return a < b ? -1 : a > b ? 1 : 0;
50
+ }
@@ -0,0 +1,35 @@
1
+ // How many batches /dev-batches runs at once: 1 unless asked, a whole number from 1 to 4 (the crew's default child
2
+ // gate, and four suites at once on one machine). Above 1, each batch runs under its own worktree as a working
3
+ // root (crews/dev-batches/application/run-wave.ts), and only in a session mode that never asks before a shell
4
+ // command: two batches asking at once could not both be answered. That is bypassPermissions alone: acceptEdits still
5
+ // asks for shell_command, and dontAsk is read-only here (mode-policy.ts), which /dev-batches refuses at any
6
+ // concurrency. Read by the command's arguments and by the crew's input. Pure.
7
+ import { concurrencyAtMost, concurrencyGitFails, concurrencyModeAsks, concurrencyNotWhole } from "./messages.ts";
8
+
9
+ export const MAX_CONCURRENCY = 4;
10
+
11
+ /** The writing modes in which no shell command is asked about (call-guard.ts: acceptEdits still asks for shell_command). */
12
+ const SILENT_MODES: readonly string[] = ["bypassPermissions"];
13
+
14
+ export type Concurrency = { ok: true; value: number } | { ok: false; line: string };
15
+
16
+ /** `concurrency` as given (absent, a number or a digit string): 1 to 4, or the one line refusing it. */
17
+ export function checkConcurrency(raw: unknown): Concurrency {
18
+ if (raw === undefined || raw === null) return { ok: true, value: 1 };
19
+ const n = typeof raw === "number" ? raw : typeof raw === "string" && /^\s*\d+\s*$/.test(raw) ? Number(raw.trim()) : NaN;
20
+ if (!Number.isSafeInteger(n) || n < 1) return { ok: false, line: concurrencyNotWhole(String(raw)) };
21
+ if (n > MAX_CONCURRENCY) return { ok: false, line: concurrencyAtMost(n, MAX_CONCURRENCY) };
22
+ return { ok: true, value: n };
23
+ }
24
+
25
+ /** Above 1, the line refusing a session mode that asks before shell commands; null when the mode lets it run. */
26
+ export function concurrencyModeRefusal(n: number, mode: string): string | null {
27
+ if (n <= 1 || SILENT_MODES.includes(mode.trim())) return null;
28
+ return concurrencyModeAsks(n, mode.trim() || "default");
29
+ }
30
+
31
+ /** The line refusing a parallel run when git fails in a batch's worktree: a runtime older than the one binding a
32
+ * linked worktree's git dir under its shell confinement. */
33
+ export function concurrencyGitRefusal(n: number): string {
34
+ return concurrencyGitFails(n);
35
+ }
@@ -0,0 +1,49 @@
1
+ // The log of a `/dev-batches` run, `<CODE>-BATCHES-STATE.md`, read only. Pure, no IO.
2
+ // A batch is open when its last entry is `launched`, `relaunched` or `stall` and no
3
+ // `closed` line follows it; any other line (a table, prose) is ignored.
4
+ import { WORKSPACE } from "../vfs.ts";
5
+
6
+ /** The record of the /dev-batches run in progress (its `code`), cleared when the run closes. A close of one of its
7
+ * batches, typed or chained, commits without pushing: the run's close pushes the plan's branch once. */
8
+ export const BATCHES_ACTIVE_RECORD = `${WORKSPACE}/.orkeon/dev/batches-active.json`;
9
+
10
+ /** The code the record names, or null (no record, unreadable). Pure: the record's text. */
11
+ export function batchesRunCode(text: string): string | null {
12
+ try {
13
+ const code = (JSON.parse(text) as { code?: unknown } | null)?.code;
14
+ return typeof code === "string" && code !== "" ? code : null;
15
+ } catch {
16
+ return null;
17
+ }
18
+ }
19
+
20
+ export interface BatchesLogEntry { date: string; time: string; batch?: string; event: string; detail: string; line: number }
21
+ export interface BatchesState { entries: BatchesLogEntry[]; closed: boolean; open: string[] }
22
+
23
+ const EVENT = /^- (\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}) (F\d+) (launched|relaunched|returned|merged|stopped|stall)( .*)?$/;
24
+ const CLOSE = /^- (\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}) closed$/;
25
+ const OPENING: ReadonlySet<string> = new Set(["launched", "relaunched", "stall"]);
26
+
27
+ export function parseBatchesState(text: string): BatchesState {
28
+ const entries: BatchesLogEntry[] = [];
29
+ text.split(/\r?\n/).forEach((raw, i) => {
30
+ const t = raw.trimEnd();
31
+ const e = EVENT.exec(t);
32
+ if (e) {
33
+ entries.push({ date: e[1], time: e[2], batch: e[3], event: e[4], detail: (e[5] ?? "").trim(), line: i + 1 });
34
+ return;
35
+ }
36
+ const c = CLOSE.exec(t);
37
+ if (c) entries.push({ date: c[1], time: c[2], event: "closed", detail: "", line: i + 1 });
38
+ });
39
+ const last = new Map<string, number>();
40
+ let lastClose = -1;
41
+ entries.forEach((e, i) => {
42
+ if (e.batch === undefined) lastClose = i;
43
+ else last.set(e.batch, i);
44
+ });
45
+ const open: string[] = [];
46
+ for (const [batch, i] of last) if (OPENING.has(entries[i].event) && i > lastClose) open.push(batch);
47
+ const closed = entries.length > 0 && entries[entries.length - 1].event === "closed";
48
+ return { entries, closed, open };
49
+ }
@@ -0,0 +1,45 @@
1
+ // The build run_build may run, and the one case it restores: pure. The pack's commands carry the
2
+ // restore rule themselves (`build: … --no-restore`, `build_test: … --no-restore`; repo.yaml): the
3
+ // tool runs them as written, never a restore of its own, but once, when a red build says the tree
4
+ // was never restored (a cold checkout or worktree), where the flag cannot succeed.
5
+ import type { RepoPackCommands } from "./repo-pack.ts";
6
+ import { PLACEHOLDER, plainWords, valueProblem } from "./test-commands.ts";
7
+ import { buildTestPlaceholders, PACK_HAS_NO_BUILD, PACK_HAS_NO_BUILD_TEST, SHELL_OPERATOR_OUTSIDE_QUOTES } from "./messages.ts";
8
+
9
+ export type BuildCommand = { ok: true; command: string; key: "commands.build" | "commands.build_test" } | { ok: false; reason: string };
10
+
11
+ /** `commands.build` without a project; `commands.build_test` with its one placeholder filled by `project`. */
12
+ export function buildCommandFor(commands: RepoPackCommands, project?: string): BuildCommand {
13
+ if (project === undefined) {
14
+ const build = commands.build?.trim();
15
+ return build ? { ok: true, command: build, key: "commands.build" } : { ok: false, reason: PACK_HAS_NO_BUILD };
16
+ }
17
+ const template = commands.buildTest?.trim();
18
+ if (!template) return { ok: false, reason: PACK_HAS_NO_BUILD_TEST };
19
+ const holes = template.match(PLACEHOLDER) ?? [];
20
+ if (holes.length !== 1) {
21
+ return { ok: false, reason: buildTestPlaceholders(holes.length, template) };
22
+ }
23
+ const problem = valueProblem(project);
24
+ if (problem !== null) return { ok: false, reason: problem };
25
+ const command = template.replace(PLACEHOLDER, project);
26
+ return plainWords(command)
27
+ ? { ok: true, command, key: "commands.build_test" }
28
+ : { ok: false, reason: SHELL_OPERATOR_OUTSIDE_QUOTES };
29
+ }
30
+
31
+ /** Whether `command` is the pack's restore, or a restore by its verb (`dotnet restore`, `npm ci`, `npm install`). */
32
+ export function isRestore(command: string, commands: RepoPackCommands): boolean {
33
+ const c = command.trim();
34
+ const restore = commands.restore?.trim();
35
+ if (restore && c === restore) return true;
36
+ return /(^|\s)(dotnet\s+restore|npm\s+(ci|install)|pnpm\s+install|yarn\s+install)(\s|$)/.test(c);
37
+ }
38
+
39
+ /** What a red build prints when its project was never restored: .NET's NETSDK1004 and its assets file. */
40
+ const COLD_TREE = [/NETSDK1004/, /project\.assets\.json'? not found/i, /run a NuGet package restore/i];
41
+
42
+ /** Whether a red build's output says the tree was never restored. */
43
+ export function coldTree(output: string): boolean {
44
+ return COLD_TREE.some((pattern) => pattern.test(output));
45
+ }