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,100 @@
1
+ // The design rules of the dev workflow: the 17 ids a plan classifies as applied or not
2
+ // applicable, and what each one asks, in this project's own words. The gate checks the
3
+ // ids; the planner's prompt reads the wording. Pure.
4
+
5
+ /** The 17 design-rule ids of the dev workflow, in order: DDD-01..DDD-11, APP-01..APP-05, PERF-01. */
6
+ export const DESIGN_RULE_IDS: readonly string[] = [
7
+ "DDD-01", "DDD-02", "DDD-03", "DDD-04", "DDD-05", "DDD-06", "DDD-07", "DDD-08", "DDD-09", "DDD-10", "DDD-11",
8
+ "APP-01", "APP-02", "APP-03", "APP-04", "APP-05", "PERF-01",
9
+ ];
10
+
11
+ const KNOWN: ReadonlySet<string> = new Set(DESIGN_RULE_IDS);
12
+
13
+ export function isDesignRuleId(id: string): boolean {
14
+ return KNOWN.has(id);
15
+ }
16
+
17
+ export type DesignRuleFamily = "DDD" | "APP" | "PERF";
18
+ export interface DesignRule {
19
+ id: string; // one of DESIGN_RULE_IDS
20
+ family: DesignRuleFamily;
21
+ behaviour: string; // what the plan's code must do, one sentence
22
+ appliesWhen: string; // the situation that makes the id applicable
23
+ notApplicableWhen: string; // the usual valid N/A reason, or "" when the id applies to every change it names
24
+ }
25
+
26
+ const rule = (
27
+ id: string, family: DesignRuleFamily, behaviour: string, appliesWhen: string, notApplicableWhen: string,
28
+ ): DesignRule => ({ id, family, behaviour, appliesWhen, notApplicableWhen });
29
+
30
+ /** The 17 rules in DESIGN_RULE_IDS order. */
31
+ export const DESIGN_RULES: readonly DesignRule[] = [
32
+ rule("DDD-01", "DDD",
33
+ "Code and tests speak the business: someone who knows the domain recognises every type, method and test name, and a purely mechanical name is not accepted",
34
+ "something is added or renamed in the domain or application layer",
35
+ ""),
36
+ rule("DDD-02", "DDD",
37
+ "Each business rule has one guardian type, the one holding the data the rule is about; no other code can produce a state that breaks the rule",
38
+ "a command alters business state",
39
+ "no business state is altered"),
40
+ rule("DDD-03", "DDD",
41
+ "State moves only through methods named after what happens in the business; callers never write a field of the guardian",
42
+ "a guardian's state moves",
43
+ "no guardian's state moves"),
44
+ rule("DDD-04", "DDD",
45
+ "A value with constraints (an amount, an address, a range) is its own immutable type, built valid or not at all, and equal to any other with the same content",
46
+ "a value carries a constraint of its own",
47
+ "the value is a plain primitive with no constraint"),
48
+ rule("DDD-05", "DDD",
49
+ "Guardians refer to one another through keys; one never carries another inside it",
50
+ "one guardian has to point at another",
51
+ "no guardian points at another"),
52
+ rule("DDD-06", "DDD",
53
+ "Bringing something new into existence enforces its rules and may note the event; reloading stored data rebuilds it without judging it again",
54
+ "an object is born, or reloaded from storage",
55
+ "nothing is born or reloaded"),
56
+ rule("DDD-07", "DDD",
57
+ "What other parts are told is a named fact that already happened, carrying the data they need",
58
+ "other parts are notified of a change",
59
+ "nobody is notified"),
60
+ rule("DDD-08", "DDD",
61
+ "A command persists the changes of one guardian; anything else it touches is only read, as narrowly as it can be",
62
+ "something is persisted",
63
+ "nothing is persisted"),
64
+ rule("DDD-09", "DDD",
65
+ "An operation lives where its data lives; a stand-alone service is the last resort, when no type can host it",
66
+ "an operation has no obvious home, or a static helper looks easier",
67
+ "the operation already has an obvious home"),
68
+ rule("DDD-10", "DDD",
69
+ "Domain code depends on nothing technical; storage, transport and frameworks are reached from outside it",
70
+ "a domain file changes",
71
+ "no domain file changes"),
72
+ rule("DDD-11", "DDD",
73
+ "Something that may be missing is modelled as such — an empty collection, a dedicated \"none\" value, an optional business field — never by a stray null",
74
+ "a domain or application input, field or result may be missing",
75
+ "nothing can be missing"),
76
+ rule("APP-01", "APP",
77
+ "A use case coordinates — fetch, hand over to the domain, persist, answer — and decides nothing itself",
78
+ "a use case or application service is added or changed",
79
+ "the use case only fetches and answers"),
80
+ rule("APP-02", "APP",
81
+ "Each input or output need is an interface defined next to the code that consumes it; adapters plug into it from outside",
82
+ "a new input or output need appears",
83
+ "no new input or output need appears"),
84
+ rule("APP-03", "APP",
85
+ "A store handles one guardian type and converts its storage errors into errors the domain knows",
86
+ "how a guardian is stored changes",
87
+ "storage is not touched"),
88
+ rule("APP-04", "APP",
89
+ "Commands, endpoints and adapters translate formats and pass on; no business decision is taken there",
90
+ "an entry point or an adapter changes",
91
+ "no entry point or adapter changes"),
92
+ rule("APP-05", "APP",
93
+ "Every limit (a size, a rate, a count, an unbounded read) has one defining place and is reused from there",
94
+ "a limit or an unbounded read is involved",
95
+ "no limit is involved"),
96
+ rule("PERF-01", "PERF",
97
+ "A behaviour's input and output calls are a known constant, not proportional to its input; no such call sits in a loop over input items",
98
+ "a use case or an adapter changes",
99
+ "the plan states and justifies an unbounded cost"),
100
+ ];
@@ -0,0 +1,175 @@
1
+ // The model of one /dev-learn run: what the crew proposes per axis, kept in
2
+ // `<work>/learn-<date>/proposals.json` for --accept and --refuse to read, and the lines
3
+ // those print. A decision applies nothing: it prints the change to make. Pure, no IO.
4
+ import { sha1Hex } from "../sha1.ts";
5
+
6
+ export const LEARN_FOLDER_PATTERN: RegExp = /^learn-\d{4}-\d{2}-\d{2}$/;
7
+ export function learnFolderName(date: string): string {
8
+ return `learn-${date}`;
9
+ }
10
+ export const PROPOSALS_JSON = "proposals.json";
11
+ export const PROPOSALS_MD = "PROPOSALS.md";
12
+
13
+ export type OwnerKind = "repository" | "harness";
14
+ export type CheckKind = "test" | "analyzer" | "architecture-test" | "gate" | "rule";
15
+ /** removes: the motif takes a wrong line out of its owner and adds none. */
16
+ export type MotifStatus = "new" | "refines" | "replaces" | "removes";
17
+ export interface Motif {
18
+ id: string; // motifId(axis, rows): 8 hex digits; 10 for both on a collision in one file (L3-Q09)
19
+ title: string; topic: string; rows: string[]; batches: string[];
20
+ preventiveLine: string; owner: { kind: OwnerKind; path: string };
21
+ check: CheckKind; status: MotifStatus;
22
+ linesRemoved: string[]; linesAdded: string[];
23
+ novelty: string; keyTerm: string;
24
+ /** What code found in the owner file (§ 2.4). */
25
+ reconcile: string;
26
+ }
27
+ export interface DroppedMotif { title: string; filter: "recurrence" | "prevention" | "novelty"; reason: string }
28
+ export interface AxisProposal {
29
+ axis: string; batches: number; gaps: number;
30
+ shownRows: string[]; // the row ids handed to the model, in order
31
+ hiddenRows: number; // rows over the cap, not shown
32
+ outcome: "proposed" | "no-motif" | "no-proposal" | "unchanged";
33
+ reason?: string; // no-proposal: the first problem; unchanged: the earlier folder
34
+ motifs: Motif[]; dropped: DroppedMotif[];
35
+ }
36
+ export interface ProposalsFile {
37
+ version: 1; date: string; work: string;
38
+ read: { files: number; gaps: number; batches: number; treatedOrkeon: number; treatedHarness: number; refused: number };
39
+ axes: AxisProposal[];
40
+ }
41
+
42
+ export function motifId(axis: string, rows: readonly string[]): string {
43
+ return sha1Hex(`${axis}|${[...rows].sort().join(",")}`).slice(0, 8);
44
+ }
45
+
46
+ // ---- parsing: every field is checked, the first wrong one is named ----
47
+
48
+ type Obj = Record<string, unknown>;
49
+ class Shape extends Error {}
50
+ const fieldPath = (at: string, key: string): string => (at === "" ? key : `${at}.${key}`);
51
+
52
+ const OWNER_KINDS: readonly string[] = ["repository", "harness"];
53
+ const CHECK_KINDS: readonly string[] = ["test", "analyzer", "architecture-test", "gate", "rule"];
54
+ const STATUSES: readonly string[] = ["new", "refines", "replaces", "removes"];
55
+ const FILTERS: readonly string[] = ["recurrence", "prevention", "novelty"];
56
+ const OUTCOMES: readonly string[] = ["proposed", "no-motif", "no-proposal", "unchanged"];
57
+ const MOTIF_ID = /^[0-9a-f]{8}([0-9a-f]{2})?$/;
58
+ const READ_KEYS = ["files", "gaps", "batches", "treatedOrkeon", "treatedHarness", "refused"] as const;
59
+
60
+ function obj(v: unknown, at: string): Obj {
61
+ if (typeof v !== "object" || v === null || Array.isArray(v)) throw new Shape(at);
62
+ return v as Obj;
63
+ }
64
+ function str(o: Obj, key: string, at: string): string {
65
+ const v = o[key];
66
+ if (typeof v !== "string") throw new Shape(fieldPath(at, key));
67
+ return v;
68
+ }
69
+ function count(o: Obj, key: string, at: string): number {
70
+ const v = o[key];
71
+ if (typeof v !== "number" || !Number.isInteger(v) || v < 0) throw new Shape(fieldPath(at, key));
72
+ return v;
73
+ }
74
+ function strings(o: Obj, key: string, at: string): string[] {
75
+ const v = o[key];
76
+ if (!Array.isArray(v) || !v.every((x) => typeof x === "string")) throw new Shape(fieldPath(at, key));
77
+ return [...v];
78
+ }
79
+ function oneOf<T extends string>(o: Obj, key: string, values: readonly string[], at: string): T {
80
+ const v = str(o, key, at);
81
+ if (!values.includes(v)) throw new Shape(fieldPath(at, key));
82
+ return v as T;
83
+ }
84
+ function list<T>(o: Obj, key: string, at: string, item: (v: unknown, at: string) => T): T[] {
85
+ const v = o[key];
86
+ if (!Array.isArray(v)) throw new Shape(fieldPath(at, key));
87
+ return v.map((x, i) => item(x, `${fieldPath(at, key)}[${i}]`));
88
+ }
89
+
90
+ function motifOf(v: unknown, at: string): Motif {
91
+ const o = obj(v, at);
92
+ const id = str(o, "id", at);
93
+ if (!MOTIF_ID.test(id)) throw new Shape(`${at}.id`);
94
+ const owner = obj(o.owner, `${at}.owner`);
95
+ return {
96
+ id, title: str(o, "title", at), topic: str(o, "topic", at),
97
+ rows: strings(o, "rows", at), batches: strings(o, "batches", at),
98
+ preventiveLine: str(o, "preventiveLine", at),
99
+ owner: { kind: oneOf<OwnerKind>(owner, "kind", OWNER_KINDS, `${at}.owner`), path: str(owner, "path", `${at}.owner`) },
100
+ check: oneOf<CheckKind>(o, "check", CHECK_KINDS, at), status: oneOf<MotifStatus>(o, "status", STATUSES, at),
101
+ linesRemoved: strings(o, "linesRemoved", at), linesAdded: strings(o, "linesAdded", at),
102
+ novelty: str(o, "novelty", at), keyTerm: str(o, "keyTerm", at), reconcile: str(o, "reconcile", at),
103
+ };
104
+ }
105
+
106
+ function droppedOf(v: unknown, at: string): DroppedMotif {
107
+ const o = obj(v, at);
108
+ return { title: str(o, "title", at), filter: oneOf<DroppedMotif["filter"]>(o, "filter", FILTERS, at), reason: str(o, "reason", at) };
109
+ }
110
+
111
+ function axisOf(v: unknown, at: string): AxisProposal {
112
+ const o = obj(v, at);
113
+ const axis: AxisProposal = {
114
+ axis: str(o, "axis", at), batches: count(o, "batches", at), gaps: count(o, "gaps", at),
115
+ shownRows: strings(o, "shownRows", at), hiddenRows: count(o, "hiddenRows", at),
116
+ outcome: oneOf<AxisProposal["outcome"]>(o, "outcome", OUTCOMES, at),
117
+ motifs: list(o, "motifs", at, motifOf), dropped: list(o, "dropped", at, droppedOf),
118
+ };
119
+ if (o.reason !== undefined) axis.reason = str(o, "reason", at);
120
+ return axis;
121
+ }
122
+
123
+ export function parseProposalsFile(text: string): { ok: true; file: ProposalsFile } | { ok: false; problem: string } {
124
+ let raw: unknown;
125
+ try {
126
+ raw = JSON.parse(text);
127
+ } catch (e) {
128
+ return { ok: false, problem: `not JSON (${(e instanceof Error ? e.message : String(e)).split("\n")[0]})` };
129
+ }
130
+ try {
131
+ const o = obj(raw, "the top level");
132
+ if (o.version !== 1) throw new Shape("version");
133
+ const read = obj(o.read, "read");
134
+ const counts = Object.fromEntries(READ_KEYS.map((k) => [k, count(read, k, "read")])) as ProposalsFile["read"];
135
+ const file: ProposalsFile = {
136
+ version: 1, date: str(o, "date", ""), work: str(o, "work", ""),
137
+ read: counts, axes: list(o, "axes", "", axisOf),
138
+ };
139
+ return { ok: true, file };
140
+ } catch (e) {
141
+ if (e instanceof Shape) return { ok: false, problem: `${e.message} has the wrong shape` };
142
+ throw e;
143
+ }
144
+ }
145
+
146
+ export function serializeProposalsFile(file: ProposalsFile): string {
147
+ return JSON.stringify(file, null, 1) + "\n";
148
+ }
149
+
150
+ // ---- the lines a decision prints ----
151
+
152
+ const HARNESS_SOURCE = /^\.devcontainer\/harness\/packs\/[^/]+\/claude\/(.+)$/;
153
+
154
+ /** The harness owner's file in the orkeon-workshop repository → its deployed copy in the checkout, or null. */
155
+ export function deployedHarnessPath(path: string): string | null {
156
+ const m = HARNESS_SOURCE.exec(path);
157
+ if (!m || m[1].split("/").some((s) => s === "" || s === "." || s === "..")) return null;
158
+ return `.claude/${m[1]}`;
159
+ }
160
+
161
+ export function patchLines(motif: Motif): string[] {
162
+ return [
163
+ `file: ${motif.owner.path}`,
164
+ ...motif.linesRemoved.map((l) => `- ${l}`),
165
+ ...motif.linesAdded.map((l) => `+ ${l}`),
166
+ ];
167
+ }
168
+
169
+ /** The lines printed for a motif: the patch for a harness owner, the change to make for a repository owner. */
170
+ export function acceptLines(motif: Motif): string[] {
171
+ const head = motif.owner.kind === "harness"
172
+ ? `accepted ${motif.id} — ${motif.title}: a harness file is never edited here; apply this in the orkeon-workshop repository:`
173
+ : `accepted ${motif.id} — ${motif.title}: ${motif.owner.path} is not edited by /dev-learn; make the change in a batch (/dev-spec <code> refactor, or by hand):`;
174
+ return [head, ...patchLines(motif).map((l) => ` ${l}`)];
175
+ }
@@ -0,0 +1,93 @@
1
+ // The /dev-learn state: the verdict rows already treated and the decision taken on each
2
+ // motif. Orkeon Code keeps its own file; the harness's file is only read, so a row the
3
+ // harness treated is not proposed again here. Pure, no IO.
4
+
5
+ /** Orkeon Code's own /dev-learn state, relative to /workspace (temp/04:172-175). */
6
+ export const LEARN_STATE_FILE = ".orkeon/dev-learn-state.json";
7
+ /** The harness's state (LC:11-12,82): read, never written. */
8
+ export const HARNESS_LEARN_STATE_FILE = ".claude/local/dev-learn-state.json";
9
+
10
+ export type Decision = "accepted" | "refused";
11
+ export interface DecisionRecord { motif: string; decision: Decision; date: string; axis: string; title: string }
12
+ export interface LearnState { version: 1; treated: string[]; decisions: DecisionRecord[] }
13
+ export interface HarnessLearnState { treated: string[]; refused: string[] }
14
+ export type StateRead<T> = { ok: true; state: T } | { ok: false; problem: string };
15
+
16
+ const RECORD_KEYS = ["motif", "date", "axis", "title"] as const;
17
+
18
+ export function emptyLearnState(): LearnState {
19
+ return { version: 1, treated: [], decisions: [] };
20
+ }
21
+
22
+ function isRecord(v: unknown): v is Record<string, unknown> {
23
+ return typeof v === "object" && v !== null && !Array.isArray(v);
24
+ }
25
+
26
+ function isStringList(v: unknown): v is string[] {
27
+ return Array.isArray(v) && v.every((x) => typeof x === "string");
28
+ }
29
+
30
+ function firstLine(e: unknown): string {
31
+ return (e instanceof Error ? e.message : String(e)).split("\n")[0];
32
+ }
33
+
34
+ function decisionRecord(v: unknown): DecisionRecord | null {
35
+ if (!isRecord(v)) return null;
36
+ if (v.decision !== "accepted" && v.decision !== "refused") return null;
37
+ if (!RECORD_KEYS.every((k) => typeof v[k] === "string")) return null;
38
+ return { motif: v.motif as string, decision: v.decision, date: v.date as string, axis: v.axis as string, title: v.title as string };
39
+ }
40
+
41
+ /** null text (absent file) → empty state. Invalid JSON or shape → a problem (never silently emptied). */
42
+ export function parseLearnState(text: string | null): StateRead<LearnState> {
43
+ if (text === null) return { ok: true, state: emptyLearnState() };
44
+ const wrong = (field: string): StateRead<LearnState> =>
45
+ ({ ok: false, problem: `${LEARN_STATE_FILE}: ${field} has the wrong shape` });
46
+ let raw: unknown;
47
+ try {
48
+ raw = JSON.parse(text);
49
+ } catch (e) {
50
+ return { ok: false, problem: `${LEARN_STATE_FILE} is not JSON (${firstLine(e)})` };
51
+ }
52
+ if (!isRecord(raw)) return wrong("the top level");
53
+ if (raw.version !== 1) return wrong("version");
54
+ if (!isStringList(raw.treated)) return wrong("treated");
55
+ if (!Array.isArray(raw.decisions)) return wrong("decisions");
56
+ const decisions: DecisionRecord[] = [];
57
+ for (const [i, d] of raw.decisions.entries()) {
58
+ const record = decisionRecord(d);
59
+ if (record === null) return wrong(`decisions[${i}]`);
60
+ decisions.push(record);
61
+ }
62
+ return { ok: true, state: { version: 1, treated: [...raw.treated], decisions } };
63
+ }
64
+
65
+ export function serializeLearnState(state: LearnState): string {
66
+ return JSON.stringify(state, null, 1) + "\n";
67
+ }
68
+
69
+ /** As LC:95-106: anything unreadable or of the wrong shape counts as empty lists; non-string items are dropped. */
70
+ export function parseHarnessLearnState(text: string | null): HarnessLearnState {
71
+ let raw: unknown = {};
72
+ if (text !== null) {
73
+ try {
74
+ raw = JSON.parse(text);
75
+ } catch {
76
+ raw = {};
77
+ }
78
+ }
79
+ const obj = isRecord(raw) ? raw : {};
80
+ const list = (v: unknown): string[] => (Array.isArray(v) ? v.filter((x): x is string => typeof x === "string") : []);
81
+ return { treated: list(obj.treated), refused: list(obj.refused) };
82
+ }
83
+
84
+ /** The state with the decision recorded (replacing an earlier one on the same motif) and rows treated. */
85
+ export function withDecision(state: LearnState, record: DecisionRecord, rows: readonly string[]): LearnState {
86
+ const treated = [...new Set([...state.treated, ...rows])].sort();
87
+ const decisions = [...state.decisions.filter((d) => d.motif !== record.motif), { ...record }];
88
+ return { version: 1, treated, decisions };
89
+ }
90
+
91
+ export function decisionOf(state: LearnState, motif: string): DecisionRecord | undefined {
92
+ return state.decisions.find((d) => d.motif === motif);
93
+ }
@@ -0,0 +1,42 @@
1
+ // A relative path a dev agent hands a tool, resolved under the project before the tool runs. The runtime resolves
2
+ // one too since Orkeon #206 (against the agent's root, else /workspace); the resolution here is for Orkeon Code's
3
+ // own guard and hooks, which judge the call before the runtime sees it and must see one absolute form. The base is
4
+ // the checkout, `/workspace`, or a batch's working root. The guard judges the resolved path, in the same form it
5
+ // always matched a relative one in (call-guard's pathForms). Pure.
6
+ import { sameToolName } from "../agent-policy/permission.ts";
7
+ import { OPERATIONS_TOOL, PATH_READ_TOOLS, PATH_WRITE_TOOLS } from "../agent-policy/rule-sets.ts";
8
+ import { WORKSPACE } from "../vfs.ts";
9
+ import { normalisePath } from "./call-guard.ts";
10
+
11
+ /** The tools whose `path` names one file or folder. */
12
+ const PATH_TOOLS: readonly string[] = [...PATH_READ_TOOLS, ...PATH_WRITE_TOOLS];
13
+
14
+ /** `path` under `base` when relative, normalised as the guard matches it (a leading `..` climbs out of the base, and the
15
+ * runtime refuses what no mount holds); an absolute path as it is. */
16
+ export function resolvedPath(path: string, base: string = WORKSPACE): string {
17
+ return path.startsWith("/") ? path : normalisePath(`${base}/${path}`);
18
+ }
19
+
20
+ const relative = (path: unknown): path is string => typeof path === "string" && path !== "" && !path.startsWith("/");
21
+
22
+ /** The call's input with every relative `path` resolved under `base` (an edit_batch: each operation's), or null
23
+ * when the call names no relative path: the input then goes to the tool as it is. */
24
+ export function resolvePathInput(tool: string, input: unknown, base: string = WORKSPACE): unknown | null {
25
+ if (input === null || typeof input !== "object" || Array.isArray(input)) return null;
26
+ const args = input as Readonly<Record<string, unknown>>;
27
+ if (PATH_TOOLS.some((name) => sameToolName(tool, name))) {
28
+ return relative(args.path) ? { ...args, path: resolvedPath(args.path, base) } : null;
29
+ }
30
+ if (sameToolName(tool, OPERATIONS_TOOL) && Array.isArray(args.operations)) {
31
+ let changed = false;
32
+ const operations = args.operations.map((op: unknown) => {
33
+ if (op === null || typeof op !== "object") return op;
34
+ const path = (op as { path?: unknown }).path;
35
+ if (!relative(path)) return op;
36
+ changed = true;
37
+ return { ...(op as Record<string, unknown>), path: resolvedPath(path, base) };
38
+ });
39
+ return changed ? { ...args, operations } : null;
40
+ }
41
+ return null;
42
+ }
@@ -0,0 +1,93 @@
1
+ // A batch of a parallel /dev-batches runs under its worktree, `/workspace/.orkeon/worktrees/<name>` (its working
2
+ // root), while the dev crews' code names the checkout `/workspace` everywhere: `/workspace` stays the logical
3
+ // checkout, and these functions map it at each boundary of the batch - onto the root on the way to the runtime
4
+ // and the model, back to `/workspace` on the way in. A path already under the root, a relative path and another
5
+ // mount (`/output`, `/tmp`) are kept; without a root every function is the identity. Pure.
6
+ import { WORKSPACE } from "../vfs.ts";
7
+
8
+ type Root = string | null | undefined;
9
+
10
+ /** A character that continues a path segment: `/workspace` followed by one is another name (`/workspaces`). */
11
+ const SEGMENT = /[\w.-]/;
12
+
13
+ /** True when the path ends at `at`: nothing that continues its name, or a dot that ends a sentence. */
14
+ const ends = (text: string, at: number): boolean =>
15
+ at >= text.length || !SEGMENT.test(text[at]) || (text[at] === "." && (at + 1 >= text.length || /[\s"'`)\]]/.test(text[at + 1])));
16
+
17
+ /** `path` with its leading `/workspace` on the root; anything else as it is. */
18
+ export function toRoot(path: string, root?: Root): string {
19
+ if (!root || isUnder(path, root) || !isUnder(path, WORKSPACE)) return path;
20
+ return root + path.slice(WORKSPACE.length);
21
+ }
22
+
23
+ /** `path` with its leading root back on `/workspace`; anything else as it is. */
24
+ export function fromRoot(path: string, root?: Root): string {
25
+ if (!root || !isUnder(path, root)) return path;
26
+ return WORKSPACE + path.slice(root.length);
27
+ }
28
+
29
+ function isUnder(path: string, folder: string): boolean {
30
+ return path.startsWith(folder) && (path.length === folder.length || path[folder.length] === "/");
31
+ }
32
+
33
+ /** Every `/workspace` path of a text (a command, a tool's result) on the root, but one already under it. */
34
+ export function textToRoot(text: string, root?: Root): string {
35
+ if (!root || !text.includes(WORKSPACE)) return text;
36
+ return rebase(text, root, false);
37
+ }
38
+
39
+ /**
40
+ * A brief (a prompt, a system text) with the paths it names on the root, as textToRoot, but for what it quotes of
41
+ * the files: a `/workspace` right after a quote (a constant of the code, `"/workspace"`) and everything inside a
42
+ * fenced block (``` or ~~~: code, a diff) are kept as the files hold them.
43
+ */
44
+ export function briefToRoot(text: string, root?: Root): string {
45
+ if (!root || !text.includes(WORKSPACE)) return text;
46
+ let fence: string | null = null;
47
+ return text.split("\n").map((line) => {
48
+ const mark = /^\s*(```|~~~)/.exec(line)?.[1];
49
+ if (mark !== undefined) {
50
+ if (fence === null) fence = mark;
51
+ else if (fence === mark) fence = null;
52
+ return line;
53
+ }
54
+ return fence !== null || !line.includes(WORKSPACE) ? line : rebase(line, root, true);
55
+ }).join("\n");
56
+ }
57
+
58
+ function rebase(text: string, root: string, keepQuoted: boolean): string {
59
+ let out = "";
60
+ let from = 0;
61
+ for (let at = text.indexOf(WORKSPACE); at >= 0; at = text.indexOf(WORKSPACE, at + 1)) {
62
+ const starts = at === 0 || !/[\w./-]/.test(text[at - 1]);
63
+ if (!starts || !ends(text, at + WORKSPACE.length)) continue;
64
+ if (keepQuoted && at > 0 && (text[at - 1] === '"' || text[at - 1] === "'")) continue;
65
+ if (text.startsWith(root, at) && ends(text, at + root.length)) continue;
66
+ out += text.slice(from, at) + root;
67
+ from = at + WORKSPACE.length;
68
+ }
69
+ return out + text.slice(from);
70
+ }
71
+
72
+ /** Every path under the root of a text (a command's output, a call the model made) back on `/workspace`. */
73
+ export function textFromRoot(text: string, root?: Root): string {
74
+ if (!root || !text.includes(root)) return text;
75
+ let out = "";
76
+ let from = 0;
77
+ for (let at = text.indexOf(root); at >= 0; at = text.indexOf(root, at + 1)) {
78
+ if (!ends(text, at + root.length) || (at > 0 && /[\w./-]/.test(text[at - 1]))) continue;
79
+ out += text.slice(from, at) + WORKSPACE;
80
+ from = at + root.length;
81
+ }
82
+ return out + text.slice(from);
83
+ }
84
+
85
+ /** `value` with `map` applied to each string it holds, at any depth; keys and other values kept. */
86
+ export function mapStrings<T>(value: T, map: (text: string) => string): T {
87
+ if (typeof value === "string") return map(value) as T;
88
+ if (Array.isArray(value)) return value.map((v) => mapStrings(v, map)) as T;
89
+ if (value === null || typeof value !== "object") return value;
90
+ const out: Record<string, unknown> = {};
91
+ for (const [k, v] of Object.entries(value as Record<string, unknown>)) out[k] = mapStrings(v, map);
92
+ return out as T;
93
+ }