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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,303 @@
1
+ // The capture of a batch whose gate is green: one file per section under
2
+ // <planDir>/capture-<F>/ - status, changed files and their diffs, build, cost, traits,
3
+ // the last test run, the test classes - then the mechanical table and the index. Each
4
+ // file stays readable whole by the auditor. A section the shell cannot produce says so;
5
+ // only a failed write stops the capture.
6
+ import type { CostIndex, Files, Shell } from "../../../shared/application/ports.ts";
7
+ import { firstLine, stdoutLines } from "../domain/text.ts";
8
+ import { runtimeCut } from "../domain/runtime-cut.ts";
9
+ import { addedLines, costSection } from "../../../shared/domain/dev/access-cost.ts";
10
+ import type { AccessCost } from "../../../shared/domain/dev/access-cost.ts";
11
+ import { measureAccessCost } from "../../../shared/application/dev/measure-access-cost.ts";
12
+ import type { DevVerifyTarget, GateRun } from "./run-gate.ts";
13
+ import { TREE_CODE_EXTENSIONS, extensionOf } from "../../../shared/domain/search-routing.ts";
14
+ import type { BuildState, TableRow } from "../domain/mechanical-table.ts";
15
+ import { CHECK_METHODS, mechanicalRows, renderTable } from "../domain/mechanical-table.ts";
16
+ import {
17
+ MAX_CLASS_FILES, MAX_DIFF_FILES, TEST_TAIL_LINES, buildFailure, buildLogProblem, classesIn, diffBase, isTestFile,
18
+ isTestRoot, splitSection, tailLines, testClassesLine, testRunSummary, traitsSection, typeNameOf,
19
+ } from "../domain/capture-sections.ts";
20
+ import type { TestRunSummary } from "../domain/capture-sections.ts";
21
+ import {
22
+ UNQUOTABLE_SCOPE, findNewer, gitDiffTracked, gitDiffUntracked, gitMethodGrep, gitStatusShort, gitTestFilesNaming,
23
+ } from "../domain/commands.ts";
24
+ import { WORKSPACE } from "../../../shared/domain/vfs.ts";
25
+
26
+ export const BUILD_TIMEOUT_SECONDS = 900;
27
+
28
+ export interface Capture {
29
+ folder: string; // VFS "/workspace/<planDir>/capture-<F>"
30
+ folderShown: string; // "<planDir>/capture-<F>"
31
+ files: string[]; // VFS paths written, index.txt first, table.md last
32
+ texts: Array<{ path: string; text: string }>; // each section file's text, in the order written; table.md aside
33
+ rows: TableRow[];
34
+ table: string; // table.md content
35
+ build: BuildState;
36
+ cost: AccessCost;
37
+ testRoots: string[];
38
+ }
39
+
40
+ type Deps = { files: Pick<Files, "read" | "write" | "list">; shell: Pick<Shell, "run">; costIndex?: CostIndex };
41
+
42
+ /** A source file: the code index's languages (the Tree-sitter adapters), and F# and VB. */
43
+ const SOURCE_EXTENSIONS = new Set([...TREE_CODE_EXTENSIONS, ".fs", ".vb"]);
44
+ const TEST_FILES_SHOWN = 5;
45
+
46
+ function errorLine(error: unknown): string {
47
+ return firstLine(error instanceof Error ? error.message : String(error));
48
+ }
49
+
50
+ function notCaptured(command: string, error: unknown): string {
51
+ return `not captured: '${command}' failed (${errorLine(error)})`;
52
+ }
53
+
54
+
55
+ function lineCount(text: string): number {
56
+ if (text === "") return 0;
57
+ const n = text.split("\n").length;
58
+ return text.endsWith("\n") ? n - 1 : n;
59
+ }
60
+
61
+ function text(lines: readonly string[]): string {
62
+ return `${lines.join("\n")}\n`;
63
+ }
64
+
65
+ function basename(path: string): string {
66
+ return path.slice(path.lastIndexOf("/") + 1);
67
+ }
68
+
69
+ /** The capture's writer: every file of a section, and what the index lists. */
70
+ class Writer {
71
+ readonly written: Array<{ name: string; chars: number; path: string; text: string }> = [];
72
+ private readonly files: Pick<Files, "write">;
73
+ private readonly folder: string;
74
+ constructor(files: Pick<Files, "write">, folder: string) {
75
+ this.files = files;
76
+ this.folder = folder;
77
+ }
78
+
79
+ async section(base: string, content: string): Promise<void> {
80
+ for (const part of splitSection(base, content)) await this.file(part.name, part.content);
81
+ }
82
+
83
+ async file(name: string, content: string): Promise<void> {
84
+ const path = `${this.folder}/${name}`;
85
+ await this.files.write(path, content);
86
+ this.written.push({ name, chars: content.length, path, text: content });
87
+ }
88
+ }
89
+
90
+ async function readOrNull(files: Pick<Files, "read">, path: string): Promise<string | null> {
91
+ try {
92
+ return await files.read(path);
93
+ } catch {
94
+ return null;
95
+ }
96
+ }
97
+
98
+ /** `added`: the lines the diff adds, null when the diff was not captured whole. */
99
+ interface DiffEntry { path: string; line: string; base?: string; content?: string; added: Set<number> | null }
100
+
101
+ /** One entry per changed file outside `<planDir>/`: the capture, the verdict and the logs live there. */
102
+ async function diffs(deps: Deps, target: DevVerifyTarget, gate: GateRun): Promise<DiffEntry[]> {
103
+ const entries: DiffEntry[] = [];
104
+ const changed = gate.changedFiles.filter((f) => !f.startsWith(`${target.planDirShown}/`));
105
+ for (const [i, path] of changed.entries()) {
106
+ if (i >= MAX_DIFF_FILES) { entries.push({ path, line: `${path} → no diff captured (beyond the first ${MAX_DIFF_FILES} files)`, added: null }); continue; }
107
+ const command = gate.untrackedFiles.includes(path) ? gitDiffUntracked(path) : gitDiffTracked(path);
108
+ if (command === null) { entries.push({ path, line: `${path} → no diff captured (a quote in the path)`, added: null }); continue; }
109
+ let raw: string;
110
+ try {
111
+ raw = (await deps.shell.run(command)).stdout;
112
+ } catch (error) {
113
+ entries.push({ path, line: `${path} → no diff captured ('${command}' failed (${errorLine(error)}))`, added: null });
114
+ continue;
115
+ }
116
+ const { kept: stdout, omitted } = runtimeCut(raw);
117
+ const base = diffBase(i + 1);
118
+ const lines = lineCount(stdout);
119
+ const doubt = omitted > 0 ? ` (cut by the runtime, ${omitted} characters omitted)` : "";
120
+ entries.push({
121
+ path, base,
122
+ line: `${path} → ${base}.txt (${lines} lines)${doubt}`,
123
+ content: `# diff ${path} (${lines} lines)\n${stdout}`,
124
+ // An empty diff adds nothing; a diff without a hunk (a colour or an external diff) is not known.
125
+ added: omitted > 0 ? null : stdout.trim() === "" ? new Set<number>() : addedLines(stdout),
126
+ });
127
+ }
128
+ return entries;
129
+ }
130
+
131
+ async function reuseProblem(deps: Deps, target: DevVerifyTarget, gate: GateRun, logShown: string): Promise<string | null> {
132
+ const log = await readOrNull(deps.files, `${WORKSPACE}/${logShown}`);
133
+ if (log === null || log === "") return `log missing or empty: ${logShown}`;
134
+ if (buildLogProblem(log) !== null) return "the log holds an error";
135
+ const paths = gate.changedFiles.filter((f) => !f.startsWith(`${target.planDirShown}/`));
136
+ if (paths.length === 0) return null;
137
+ const command = findNewer(paths, logShown);
138
+ if (command === null) return "the shell cannot compare dates: more than 200 files, or a path the shell cannot quote";
139
+ let newer: string[];
140
+ try {
141
+ newer = stdoutLines((await deps.shell.run(command)).stdout);
142
+ } catch (error) {
143
+ return `the shell cannot compare dates: ${errorLine(error)}`;
144
+ }
145
+ return newer.length === 0 ? null : `changed after it:${newer.map((p) => ` ${p.replace(/^\.\//, "")}`).join("")}`;
146
+ }
147
+
148
+ async function buildSection(deps: Deps, target: DevVerifyTarget, gate: GateRun): Promise<{ content: string; state: BuildState }> {
149
+ const build = target.pack?.commands.build;
150
+ if (build === undefined || build.trim() === "") {
151
+ return { content: text(["not run — the pack has no commands.build"]), state: { state: "none" } };
152
+ }
153
+ const logShown = `${target.planDirShown}/logs/${target.batch}-build.txt`;
154
+ const why = await reuseProblem(deps, target, gate, logShown);
155
+ if (why === null) {
156
+ return {
157
+ content: text([`command: ${build}`, `exit: 0 (reused ${logShown}: ends green, no changed file newer — one build per batch)`]),
158
+ state: { state: "reused", log: logShown },
159
+ };
160
+ }
161
+ const head = [`log not reused (${why}): built again`, `command: ${build}`];
162
+ try {
163
+ const result = await deps.shell.run(build, { timeoutSeconds: BUILD_TIMEOUT_SECONDS });
164
+ if (result.timedOut === true) {
165
+ return {
166
+ content: text([...head, `exit: none — timed out after ${BUILD_TIMEOUT_SECONDS} s`]),
167
+ state: { state: "timeout", seconds: BUILD_TIMEOUT_SECONDS },
168
+ };
169
+ }
170
+ if (result.exitCode === 0) return { content: text([...head, "exit: 0"]), state: { state: "run", exit: 0, why: "" } };
171
+ const output = result.stdout !== "" && !result.stdout.endsWith("\n") && result.stderr !== ""
172
+ ? `${result.stdout}\n${result.stderr}` : `${result.stdout}${result.stderr}`;
173
+ const failure = buildFailure(output);
174
+ return {
175
+ content: text([...head, `exit: ${result.exitCode}`, ...failure.lines]),
176
+ state: { state: "run", exit: result.exitCode, why: failure.why },
177
+ };
178
+ } catch (error) {
179
+ const message = errorLine(error);
180
+ return { content: text([...head, `not run — the shell refused it: ${message}`]), state: { state: "refused", message } };
181
+ }
182
+ }
183
+
184
+ async function testTail(deps: Deps, target: DevVerifyTarget): Promise<{ content: string; log: { name: string; summary: TestRunSummary } | null }> {
185
+ const logs = `${target.planDirShown}/logs`;
186
+ const candidates = [`${logs}/${target.batch}-test-affected.txt`, `${logs}/${target.batch}-test.txt`];
187
+ let empty: string | null = null;
188
+ for (const shown of candidates) {
189
+ const content = await readOrNull(deps.files, `${WORKSPACE}/${shown}`);
190
+ if (content === null) continue;
191
+ if (content.trim() === "") { empty ??= shown; continue; }
192
+ const tail = tailLines(content, TEST_TAIL_LINES);
193
+ return { content: text([`file: ${shown}`, ...tail]), log: { name: basename(shown), summary: testRunSummary(tail) } };
194
+ }
195
+ if (empty !== null) return { content: text([`missing or empty: ${empty}`]), log: null };
196
+ return { content: text([`no test log: neither ${candidates[0]} nor ${candidates[1]}`]), log: null };
197
+ }
198
+
199
+ async function testClasses(deps: Deps, target: DevVerifyTarget, gate: GateRun, testRoots: readonly string[]): Promise<string> {
200
+ const out: string[] = [];
201
+ let counted = 0;
202
+ for (const path of gate.changedFiles) {
203
+ if (!SOURCE_EXTENSIONS.has(extensionOf(path)) || path.startsWith(`${target.planDirShown}/`)) continue;
204
+ const test = isTestFile(path, testRoots);
205
+ const source = await readOrNull(deps.files, `${WORKSPACE}/${path}`);
206
+ if (source === null) continue;
207
+ if (test) {
208
+ out.push(testClassesLine(path, classesIn(source), null));
209
+ } else if (testRoots.length === 0) {
210
+ out.push(testClassesLine(path, null, null, "no test root given"));
211
+ } else {
212
+ const ext = path.slice(path.lastIndexOf(".") + 1);
213
+ const command = gitTestFilesNaming(typeNameOf(path), testRoots, ext, gate.excludes);
214
+ if (command === null) {
215
+ out.push(testClassesLine(path, null, null, "not searched (the name is not a plain word)"));
216
+ } else {
217
+ try {
218
+ out.push(testClassesLine(path, null, stdoutLines((await deps.shell.run(command)).stdout).slice(0, TEST_FILES_SHOWN)));
219
+ } catch (error) {
220
+ out.push(notCaptured(command, error));
221
+ }
222
+ }
223
+ }
224
+ counted++;
225
+ if (counted >= MAX_CLASS_FILES) { out.push(`[cut at ${MAX_CLASS_FILES} files]`); break; }
226
+ }
227
+ if (counted === 0) out.push("no changed source file");
228
+ return text(out);
229
+ }
230
+
231
+ async function methodHits(
232
+ deps: Deps, gate: GateRun, testRoots: readonly string[],
233
+ ): Promise<{ hits: string[] | null; failure: string | null }> {
234
+ if (gate.facts.methods.length === 0 || testRoots.length === 0) return { hits: null, failure: null };
235
+ const command = gitMethodGrep(gate.facts.methods, testRoots, gate.excludes);
236
+ if (command === null) return { hits: null, failure: UNQUOTABLE_SCOPE };
237
+ try {
238
+ return { hits: stdoutLines((await deps.shell.run(command)).stdout), failure: null };
239
+ } catch (error) {
240
+ return { hits: null, failure: notCaptured(command, error) };
241
+ }
242
+ }
243
+
244
+ export async function writeCapture(deps: Deps, target: DevVerifyTarget, gate: GateRun, when: string): Promise<Capture> {
245
+ const folderShown = `${target.planDirShown}/capture-${target.batch}`;
246
+ const folder = `${WORKSPACE}/${folderShown}`;
247
+ const writer = new Writer(deps.files, folder);
248
+ const testRoots = gate.roots.filter(isTestRoot);
249
+
250
+ const status = gitStatusShort(gate.excludes);
251
+ let statusText: string;
252
+ try {
253
+ statusText = (await deps.shell.run(status)).stdout;
254
+ } catch (error) {
255
+ statusText = text([notCaptured(status, error)]);
256
+ }
257
+ await writer.section("status", statusText);
258
+
259
+ const entries = await diffs(deps, target, gate);
260
+ await writer.section("changed-files", entries.length === 0 ? text(["no changed file"]) : text(entries.map((e) => e.line)));
261
+ for (const e of entries) if (e.base !== undefined && e.content !== undefined) await writer.section(e.base, e.content);
262
+
263
+ const build = await buildSection(deps, target, gate);
264
+ await writer.section("build", build.content);
265
+ const cost = await measureAccessCost(deps.costIndex, target.pack, gate.roots, entries.map((e) => ({ path: e.path, added: e.added })));
266
+ await writer.section("cost", costSection(cost));
267
+ await writer.section("traits", traitsSection(gate.trait?.shown ?? null, gate.facts.ids, gate.traitHits));
268
+ const tail = await testTail(deps, target);
269
+ await writer.section("test-tail", tail.content);
270
+ await writer.section("test-classes", await testClasses(deps, target, gate, testRoots));
271
+
272
+ const methods = await methodHits(deps, gate, testRoots);
273
+ const rows = mechanicalRows({
274
+ build: build.state,
275
+ trait: gate.trait, ids: gate.facts.ids,
276
+ methods: gate.facts.methods, testRoots, methodHits: methods.hits,
277
+ testLog: tail.log, testLogLooked: `${target.planDirShown}/logs/`,
278
+ roots: gate.roots,
279
+ cost,
280
+ tickedLines: gate.facts.tickedLines, planDirName: basename(target.planDirShown),
281
+ appliedRulesRow: gate.facts.appliedRulesRow, appliedIds: gate.facts.appliedIds,
282
+ }).map((r) => (methods.failure !== null && r.check === CHECK_METHODS ? { ...r, result: "not checked" as const, evidence: methods.failure } : r));
283
+ const table = renderTable(target.batch, rows);
284
+ await writer.file("table.md", table);
285
+
286
+ // Files has no delete: a file of an earlier run may stay in the folder; the manifest names
287
+ // this run's files, and the brief cites only them.
288
+ const manifest = text(["index.txt", "manifest.txt", ...writer.written.map((w) => w.name)]);
289
+ await deps.files.write(`${folder}/manifest.txt`, manifest);
290
+ const index = text([
291
+ `# Audit capture — batch ${target.batch}`,
292
+ `sheet: ${target.sheetShown}`,
293
+ `generated: ${when}`,
294
+ "gate: green",
295
+ "files:",
296
+ ...writer.written.map((w) => `- ${w.name} (${w.chars} chars)`),
297
+ ]);
298
+ const listed = writer.written.map((w) => w.path);
299
+ await deps.files.write(`${folder}/index.txt`, index);
300
+
301
+ const texts = writer.written.filter((w) => w.name !== "table.md").map((w) => ({ path: w.path, text: w.text }));
302
+ return { folder, folderShown, files: [`${folder}/index.txt`, `${folder}/manifest.txt`, ...listed], texts, rows, table, build: build.state, cost, testRoots };
303
+ }