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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (552) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -0
  3. package/LICENSE.md +21 -0
  4. package/NOTICE.md +17 -0
  5. package/README.fr.md +163 -0
  6. package/README.md +156 -2
  7. package/config/appsettings.anthropic.example.json +77 -0
  8. package/config/appsettings.example.json +71 -0
  9. package/config/appsettings.jev.example.json +131 -0
  10. package/config/appsettings.kev.example.json +133 -0
  11. package/config/appsettings.liquid.example.json +132 -0
  12. package/config/appsettings.ollama-whisper.example.json +93 -0
  13. package/config/appsettings.ollama.example.json +70 -0
  14. package/config/appsettings.whisper.example.json +32 -0
  15. package/mcp/whisper/README.md +294 -0
  16. package/mcp/whisper/pyproject.toml +32 -0
  17. package/mcp/whisper/uv.lock +1641 -0
  18. package/mcp/whisper/whisper_mcp.py +1053 -0
  19. package/orkeon-code +1092 -0
  20. package/orkeon-code.mjs +71 -0
  21. package/orkeon-code.ps1 +939 -0
  22. package/package.json +58 -4
  23. package/scripts/install.ps1 +156 -0
  24. package/scripts/install.sh +148 -0
  25. package/scripts/session-start.ork.ts +90 -0
  26. package/scripts/session-start.sh +74 -0
  27. package/scripts/setup-fixture.sh +88 -0
  28. package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
  29. package/src/commands/_lib/args.ts +194 -0
  30. package/src/commands/_lib/dev/dev-batches.ts +366 -0
  31. package/src/commands/_lib/dev/dev-implement.ts +185 -0
  32. package/src/commands/_lib/dev/dev-source.ts +61 -0
  33. package/src/commands/_lib/dev/dev.ts +341 -0
  34. package/src/commands/_lib/dev/markers.ts +7 -0
  35. package/src/commands/_lib/dev/messages.ts +112 -0
  36. package/src/commands/_lib/dev-step.ts +145 -0
  37. package/src/commands/_lib/dispatch.ts +254 -0
  38. package/src/commands/_lib/effort.ts +15 -0
  39. package/src/commands/_lib/git/branch.ts +94 -0
  40. package/src/commands/_lib/git/commit.ts +90 -0
  41. package/src/commands/_lib/git/diff.ts +107 -0
  42. package/src/commands/_lib/git/messages.ts +54 -0
  43. package/src/commands/_lib/git/review.ts +108 -0
  44. package/src/commands/_lib/memory/memory-admit.ts +148 -0
  45. package/src/commands/_lib/memory/memory.ts +52 -0
  46. package/src/commands/_lib/memory/messages.ts +32 -0
  47. package/src/commands/_lib/messages.ts +48 -0
  48. package/src/commands/_lib/pr-context.ts +32 -0
  49. package/src/commands/_lib/project/analyze.ts +24 -0
  50. package/src/commands/_lib/project/messages.ts +8 -0
  51. package/src/commands/_lib/session/export.ts +105 -0
  52. package/src/commands/_lib/session/messages.ts +87 -0
  53. package/src/commands/_lib/session/prompts.ts +4 -0
  54. package/src/commands/_lib/session/resume.ts +151 -0
  55. package/src/commands/_lib/session/tasks.ts +181 -0
  56. package/src/commands/_lib/settings/advisor.ts +75 -0
  57. package/src/commands/_lib/settings/agents.ts +137 -0
  58. package/src/commands/_lib/settings/choices.ts +8 -0
  59. package/src/commands/_lib/settings/config.ts +141 -0
  60. package/src/commands/_lib/settings/effort.ts +147 -0
  61. package/src/commands/_lib/settings/hooks.ts +50 -0
  62. package/src/commands/_lib/settings/messages.ts +408 -0
  63. package/src/commands/_lib/settings/mode.ts +100 -0
  64. package/src/commands/_lib/settings/model.ts +181 -0
  65. package/src/commands/_lib/settings/output-style.ts +39 -0
  66. package/src/commands/_lib/settings/permissions.ts +287 -0
  67. package/src/commands/_lib/settings/route.ts +63 -0
  68. package/src/commands/_lib/settings/session-config.ts +49 -0
  69. package/src/commands/_lib/settings/skills.ts +93 -0
  70. package/src/commands/_lib/settings/theme.ts +42 -0
  71. package/src/commands/_lib/speech/messages.ts +58 -0
  72. package/src/commands/_lib/speech/prompts.ts +4 -0
  73. package/src/commands/_lib/speech/say.ts +95 -0
  74. package/src/commands/_lib/speech/transcribe.ts +121 -0
  75. package/src/commands/_lib/speech/voice.ts +142 -0
  76. package/src/commands/_lib/status/cache.ts +31 -0
  77. package/src/commands/_lib/status/context.ts +57 -0
  78. package/src/commands/_lib/status/doctor.ts +205 -0
  79. package/src/commands/_lib/status/messages.ts +100 -0
  80. package/src/commands/_lib/status/meta.ts +24 -0
  81. package/src/commands/_lib/status/status.ts +128 -0
  82. package/src/commands/_lib/status/usage-tools.ts +48 -0
  83. package/src/commands/_lib/status/usage.ts +128 -0
  84. package/src/commands/_lib/view.ts +34 -0
  85. package/src/commands/dev/dev-batches.cmd.ts +109 -0
  86. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  87. package/src/commands/dev/dev-plan.cmd.ts +51 -0
  88. package/src/commands/dev/dev-spec.cmd.ts +54 -0
  89. package/src/commands/dev/dev-status.cmd.ts +16 -0
  90. package/src/commands/git/branch.cmd.ts +27 -0
  91. package/src/commands/git/commit.cmd.ts +48 -0
  92. package/src/commands/git/diff.cmd.ts +26 -0
  93. package/src/commands/git/review.cmd.ts +36 -0
  94. package/src/commands/memory/memory.cmd.ts +48 -0
  95. package/src/commands/project/analyze.cmd.ts +32 -0
  96. package/src/commands/project/debug-tool-call.cmd.ts +62 -0
  97. package/src/commands/project/files.cmd.ts +22 -0
  98. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  99. package/src/commands/project/init.cmd.ts +14 -0
  100. package/src/commands/project/verify.cmd.ts +27 -0
  101. package/src/commands/session/assistant.cmd.ts +40 -0
  102. package/src/commands/session/btw.cmd.ts +18 -0
  103. package/src/commands/session/clear.cmd.ts +19 -0
  104. package/src/commands/session/compact.cmd.ts +16 -0
  105. package/src/commands/session/copy.cmd.ts +45 -0
  106. package/src/commands/session/exit.cmd.ts +9 -0
  107. package/src/commands/session/export.cmd.ts +28 -0
  108. package/src/commands/session/rename.cmd.ts +18 -0
  109. package/src/commands/session/resume.cmd.ts +19 -0
  110. package/src/commands/session/rewind.cmd.ts +25 -0
  111. package/src/commands/session/summary.cmd.ts +27 -0
  112. package/src/commands/session/tasks.cmd.ts +46 -0
  113. package/src/commands/settings/advisor.cmd.ts +38 -0
  114. package/src/commands/settings/agents.cmd.ts +19 -0
  115. package/src/commands/settings/config.cmd.ts +19 -0
  116. package/src/commands/settings/effort.cmd.ts +19 -0
  117. package/src/commands/settings/fast.cmd.ts +18 -0
  118. package/src/commands/settings/hooks.cmd.ts +17 -0
  119. package/src/commands/settings/mode.cmd.ts +20 -0
  120. package/src/commands/settings/model.cmd.ts +21 -0
  121. package/src/commands/settings/output-style.cmd.ts +19 -0
  122. package/src/commands/settings/permissions.cmd.ts +25 -0
  123. package/src/commands/settings/proactive.cmd.ts +16 -0
  124. package/src/commands/settings/route.cmd.ts +16 -0
  125. package/src/commands/settings/skills.cmd.ts +17 -0
  126. package/src/commands/settings/theme.cmd.ts +14 -0
  127. package/src/commands/speech/say.cmd.ts +24 -0
  128. package/src/commands/speech/transcribe.cmd.ts +29 -0
  129. package/src/commands/speech/voice.cmd.ts +30 -0
  130. package/src/commands/status/context.cmd.ts +18 -0
  131. package/src/commands/status/doctor.cmd.ts +27 -0
  132. package/src/commands/status/release-notes.cmd.ts +9 -0
  133. package/src/commands/status/status.cmd.ts +25 -0
  134. package/src/commands/status/usage.cmd.ts +21 -0
  135. package/src/crews/.orkeon/orkeon.d.ts +4391 -0
  136. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  137. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
  138. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  139. package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
  140. package/src/crews/advisor/application/messages.ts +4 -0
  141. package/src/crews/advisor/application/prompts.ts +4 -0
  142. package/src/crews/advisor/application/run-advisor.ts +41 -0
  143. package/src/crews/advisor/crew.ork.ts +44 -0
  144. package/src/crews/advisor/domain/advice.ts +119 -0
  145. package/src/crews/advisor/domain/messages.ts +8 -0
  146. package/src/crews/advisor/domain/prompts.ts +26 -0
  147. package/src/crews/agent-run/application/messages.ts +18 -0
  148. package/src/crews/agent-run/application/run-agent-run.ts +43 -0
  149. package/src/crews/agent-run/crew.ork.ts +67 -0
  150. package/src/crews/analyze/application/messages.ts +27 -0
  151. package/src/crews/analyze/application/prompts.ts +4 -0
  152. package/src/crews/analyze/application/run-analyze.ts +120 -0
  153. package/src/crews/analyze/crew.ork.ts +41 -0
  154. package/src/crews/analyze/domain/harvest.ts +269 -0
  155. package/src/crews/analyze/domain/prompts.ts +86 -0
  156. package/src/crews/code-review/application/lens-material.ts +24 -0
  157. package/src/crews/code-review/application/messages.ts +17 -0
  158. package/src/crews/code-review/application/prompts.ts +126 -0
  159. package/src/crews/code-review/application/review.ts +74 -0
  160. package/src/crews/code-review/application/run-code-review.ts +121 -0
  161. package/src/crews/code-review/crew.ork.ts +52 -0
  162. package/src/crews/code-review/domain/lenses.ts +154 -0
  163. package/src/crews/code-review/domain/messages.ts +25 -0
  164. package/src/crews/code-review/domain/prompts.ts +58 -0
  165. package/src/crews/code-review/domain/report.ts +58 -0
  166. package/src/crews/code-review/domain/scope.ts +106 -0
  167. package/src/crews/dev-batches/application/messages.ts +127 -0
  168. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  169. package/src/crews/dev-batches/application/prompts.ts +10 -0
  170. package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
  171. package/src/crews/dev-batches/application/run-wave.ts +452 -0
  172. package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
  173. package/src/crews/dev-batches/crew.ork.ts +146 -0
  174. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  175. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  176. package/src/crews/dev-batches/domain/batches-log.ts +52 -0
  177. package/src/crews/dev-batches/domain/markers.ts +5 -0
  178. package/src/crews/dev-batches/domain/messages.ts +6 -0
  179. package/src/crews/dev-batches/domain/wave-order.ts +44 -0
  180. package/src/crews/dev-change/application/change-material.ts +44 -0
  181. package/src/crews/dev-change/application/evidence.ts +172 -0
  182. package/src/crews/dev-change/application/messages.ts +81 -0
  183. package/src/crews/dev-change/application/prompts.ts +101 -0
  184. package/src/crews/dev-change/application/run-dev-change.ts +324 -0
  185. package/src/crews/dev-change/crew.ork.ts +114 -0
  186. package/src/crews/dev-change/domain/change-answer.ts +163 -0
  187. package/src/crews/dev-change/domain/change-render.ts +77 -0
  188. package/src/crews/dev-change/domain/markers.ts +28 -0
  189. package/src/crews/dev-change/domain/messages.ts +16 -0
  190. package/src/crews/dev-implement/application/close.ts +186 -0
  191. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  192. package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
  193. package/src/crews/dev-implement/application/messages.ts +161 -0
  194. package/src/crews/dev-implement/application/observe.ts +52 -0
  195. package/src/crews/dev-implement/application/prompts.ts +9 -0
  196. package/src/crews/dev-implement/application/report-writes.ts +46 -0
  197. package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
  198. package/src/crews/dev-implement/application/run-role.ts +27 -0
  199. package/src/crews/dev-implement/application/suite-job.ts +122 -0
  200. package/src/crews/dev-implement/application/touched.ts +74 -0
  201. package/src/crews/dev-implement/crew.ork.ts +69 -0
  202. package/src/crews/dev-implement/domain/contracts.ts +255 -0
  203. package/src/crews/dev-implement/domain/correction.ts +103 -0
  204. package/src/crews/dev-implement/domain/cycles.ts +36 -0
  205. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  206. package/src/crews/dev-implement/domain/markers.ts +23 -0
  207. package/src/crews/dev-implement/domain/messages.ts +58 -0
  208. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  209. package/src/crews/dev-implement/domain/roles.ts +49 -0
  210. package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
  211. package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
  212. package/src/crews/dev-implement/domain/step-checks.ts +137 -0
  213. package/src/crews/dev-implement/domain/step-section.ts +129 -0
  214. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  215. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  216. package/src/crews/dev-learn/application/messages.ts +51 -0
  217. package/src/crews/dev-learn/application/prompts.ts +99 -0
  218. package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
  219. package/src/crews/dev-learn/crew.ork.ts +53 -0
  220. package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
  221. package/src/crews/dev-learn/domain/messages.ts +65 -0
  222. package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
  223. package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
  224. package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
  225. package/src/crews/dev-plan/application/inventory.ts +174 -0
  226. package/src/crews/dev-plan/application/messages.ts +88 -0
  227. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  228. package/src/crews/dev-plan/application/prompts.ts +141 -0
  229. package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
  230. package/src/crews/dev-plan/crew.ork.ts +112 -0
  231. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  232. package/src/crews/dev-plan/domain/markers.ts +18 -0
  233. package/src/crews/dev-plan/domain/messages.ts +118 -0
  234. package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
  235. package/src/crews/dev-plan/domain/plan-render.ts +306 -0
  236. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  237. package/src/crews/dev-spec/application/messages.ts +30 -0
  238. package/src/crews/dev-spec/application/prompts.ts +93 -0
  239. package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
  240. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  241. package/src/crews/dev-spec/crew.ork.ts +110 -0
  242. package/src/crews/dev-spec/domain/markers.ts +30 -0
  243. package/src/crews/dev-spec/domain/messages.ts +39 -0
  244. package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
  245. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  246. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  247. package/src/crews/dev-verify/application/audit.ts +267 -0
  248. package/src/crews/dev-verify/application/capture.ts +311 -0
  249. package/src/crews/dev-verify/application/messages.ts +119 -0
  250. package/src/crews/dev-verify/application/prompts.ts +209 -0
  251. package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
  252. package/src/crews/dev-verify/application/run-gate.ts +204 -0
  253. package/src/crews/dev-verify/crew.ork.ts +103 -0
  254. package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
  255. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  256. package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
  257. package/src/crews/dev-verify/domain/commands.ts +103 -0
  258. package/src/crews/dev-verify/domain/gate.ts +131 -0
  259. package/src/crews/dev-verify/domain/markers.ts +16 -0
  260. package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
  261. package/src/crews/dev-verify/domain/messages.ts +92 -0
  262. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  263. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  264. package/src/crews/dev-verify/domain/text.ts +20 -0
  265. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  266. package/src/crews/git-commit/application/draft.ts +133 -0
  267. package/src/crews/git-commit/application/messages.ts +15 -0
  268. package/src/crews/git-commit/application/prompts.ts +47 -0
  269. package/src/crews/git-commit/application/run-git-commit.ts +117 -0
  270. package/src/crews/git-commit/crew.ork.ts +53 -0
  271. package/src/crews/git-commit/domain/commit.ts +200 -0
  272. package/src/crews/git-commit/domain/markers.ts +4 -0
  273. package/src/crews/git-commit/domain/messages.ts +48 -0
  274. package/src/crews/init-verifiers/application/authoring.ts +90 -0
  275. package/src/crews/init-verifiers/application/messages.ts +13 -0
  276. package/src/crews/init-verifiers/application/prompts.ts +107 -0
  277. package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
  278. package/src/crews/init-verifiers/crew.ork.ts +35 -0
  279. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  280. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  281. package/src/crews/main-loop/application/auto-compact.ts +78 -0
  282. package/src/crews/main-loop/application/context-gather.ts +133 -0
  283. package/src/crews/main-loop/application/messages.ts +81 -0
  284. package/src/crews/main-loop/application/prompts.ts +12 -0
  285. package/src/crews/main-loop/application/run-main-loop.ts +383 -0
  286. package/src/crews/main-loop/application/turn-context.ts +111 -0
  287. package/src/crews/main-loop/crew.ork.ts +124 -0
  288. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  289. package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
  290. package/src/crews/main-loop/domain/prompts.ts +336 -0
  291. package/src/crews/main-loop/domain/turn-chains.ts +130 -0
  292. package/src/crews/project-init/application/detect.ts +123 -0
  293. package/src/crews/project-init/application/messages.ts +15 -0
  294. package/src/crews/project-init/application/prompts.ts +105 -0
  295. package/src/crews/project-init/application/run-project-init.ts +31 -0
  296. package/src/crews/project-init/crew.ork.ts +36 -0
  297. package/src/crews/project-init/domain/conventions.ts +36 -0
  298. package/src/crews/project-init/domain/existing-files.ts +65 -0
  299. package/src/crews/project-init/domain/messages.ts +13 -0
  300. package/src/crews/project-init/domain/package-map.ts +73 -0
  301. package/src/crews/project-init/domain/prompts.ts +10 -0
  302. package/src/crews/session-compact/application/prompts.ts +5 -0
  303. package/src/crews/session-compact/crew.ork.ts +56 -0
  304. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  305. package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
  306. package/src/crews/speech/application/messages.ts +3 -0
  307. package/src/crews/speech/application/prompts.ts +3 -0
  308. package/src/crews/speech/application/run-speech.ts +26 -0
  309. package/src/crews/speech/crew.ork.ts +38 -0
  310. package/src/shared/application/agents/child-agent.ts +259 -0
  311. package/src/shared/application/agents/messages.ts +35 -0
  312. package/src/shared/application/agents/route-agent.ts +115 -0
  313. package/src/shared/application/agents/run-sub-agent.ts +119 -0
  314. package/src/shared/application/answer-language.ts +14 -0
  315. package/src/shared/application/attached-skills.ts +36 -0
  316. package/src/shared/application/compaction/compact-session.ts +242 -0
  317. package/src/shared/application/compaction/extract-memories.ts +38 -0
  318. package/src/shared/application/compaction/messages.ts +20 -0
  319. package/src/shared/application/compaction/prune-context.ts +94 -0
  320. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  321. package/src/shared/application/compaction/restore-context.ts +78 -0
  322. package/src/shared/application/config-store.ts +123 -0
  323. package/src/shared/application/dev/brief-inventory.ts +115 -0
  324. package/src/shared/application/dev/close-batch.ts +85 -0
  325. package/src/shared/application/dev/find-repo-pack.ts +78 -0
  326. package/src/shared/application/dev/learn-decision.ts +254 -0
  327. package/src/shared/application/dev/load-dev-context.ts +265 -0
  328. package/src/shared/application/dev/measure-access-cost.ts +69 -0
  329. package/src/shared/application/dev/messages.ts +132 -0
  330. package/src/shared/application/dev/phase-timer.ts +54 -0
  331. package/src/shared/application/dev/plan-source.ts +116 -0
  332. package/src/shared/application/dev/preflight.ts +71 -0
  333. package/src/shared/application/dev/project-files.ts +17 -0
  334. package/src/shared/application/dev/prompts.ts +34 -0
  335. package/src/shared/application/dev/question-round.ts +60 -0
  336. package/src/shared/application/dev/resolve-work-folder.ts +134 -0
  337. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  338. package/src/shared/application/dev/settle-questions.ts +57 -0
  339. package/src/shared/application/dev/source-review.ts +67 -0
  340. package/src/shared/application/dev/source-step.ts +152 -0
  341. package/src/shared/application/dev/spend.ts +55 -0
  342. package/src/shared/application/dev/step-precedents.ts +90 -0
  343. package/src/shared/application/dev/tool-call-policy.ts +87 -0
  344. package/src/shared/application/dev/tool-callbacks.ts +262 -0
  345. package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
  346. package/src/shared/application/dev/verdict-sources.ts +50 -0
  347. package/src/shared/application/dev/wrapped-tools.ts +147 -0
  348. package/src/shared/application/extra-tools.ts +71 -0
  349. package/src/shared/application/git/batch-worktree.ts +102 -0
  350. package/src/shared/application/git/commit-files.ts +191 -0
  351. package/src/shared/application/git/merge-batch.ts +67 -0
  352. package/src/shared/application/git/messages.ts +75 -0
  353. package/src/shared/application/git/open-pull-request.ts +52 -0
  354. package/src/shared/application/host-context.ts +59 -0
  355. package/src/shared/application/host-layout-store.ts +45 -0
  356. package/src/shared/application/instructions-file.ts +19 -0
  357. package/src/shared/application/json-file.ts +34 -0
  358. package/src/shared/application/llm-profile.ts +36 -0
  359. package/src/shared/application/messages.ts +14 -0
  360. package/src/shared/application/permission-rules.ts +169 -0
  361. package/src/shared/application/ports/approvals.ts +20 -0
  362. package/src/shared/application/ports/clock.ts +5 -0
  363. package/src/shared/application/ports/code-index.ts +93 -0
  364. package/src/shared/application/ports/crew.ts +60 -0
  365. package/src/shared/application/ports/decision.ts +14 -0
  366. package/src/shared/application/ports/files.ts +21 -0
  367. package/src/shared/application/ports/human.ts +38 -0
  368. package/src/shared/application/ports/llm.ts +83 -0
  369. package/src/shared/application/ports/memory.ts +30 -0
  370. package/src/shared/application/ports/progress.ts +23 -0
  371. package/src/shared/application/ports/runtime.ts +15 -0
  372. package/src/shared/application/ports/session.ts +74 -0
  373. package/src/shared/application/ports/shared-memory.ts +26 -0
  374. package/src/shared/application/ports/shell.ts +40 -0
  375. package/src/shared/application/ports/telemetry.ts +45 -0
  376. package/src/shared/application/ports/theme.ts +11 -0
  377. package/src/shared/application/ports/tools.ts +46 -0
  378. package/src/shared/application/ports/usage.ts +45 -0
  379. package/src/shared/application/ports.ts +29 -0
  380. package/src/shared/application/project-manifests.ts +106 -0
  381. package/src/shared/application/session-io.ts +85 -0
  382. package/src/shared/application/session-state.ts +36 -0
  383. package/src/shared/application/shared-memory/admit-entries.ts +179 -0
  384. package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
  385. package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
  386. package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
  387. package/src/shared/application/shared-memory/memory-files.ts +111 -0
  388. package/src/shared/application/shared-memory/memory-settings.ts +94 -0
  389. package/src/shared/application/shared-memory/messages.ts +63 -0
  390. package/src/shared/application/shared-memory/push-candidate.ts +149 -0
  391. package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
  392. package/src/shared/application/skills/messages.ts +4 -0
  393. package/src/shared/application/skills/suggest-skills.ts +102 -0
  394. package/src/shared/application/state-snapshot.ts +38 -0
  395. package/src/shared/application/workflow/messages.ts +8 -0
  396. package/src/shared/application/workflow/workflow-state.ts +136 -0
  397. package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
  398. package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
  399. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  400. package/src/shared/domain/agent-policy/messages.ts +66 -0
  401. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  402. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  403. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  404. package/src/shared/domain/agent-policy/permission.ts +625 -0
  405. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  406. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  407. package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
  408. package/src/shared/domain/agent-policy/tool-access.ts +91 -0
  409. package/src/shared/domain/agent-registry.ts +143 -0
  410. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  411. package/src/shared/domain/agents/chain.ts +30 -0
  412. package/src/shared/domain/agents/charter.ts +64 -0
  413. package/src/shared/domain/agents/exclusive.ts +25 -0
  414. package/src/shared/domain/agents/instances.ts +252 -0
  415. package/src/shared/domain/agents/messages.ts +39 -0
  416. package/src/shared/domain/agents/model-route.ts +199 -0
  417. package/src/shared/domain/agents/prompts.ts +20 -0
  418. package/src/shared/domain/code-intel-contract.ts +357 -0
  419. package/src/shared/domain/code-intel-routing.ts +60 -0
  420. package/src/shared/domain/compact-outcome.ts +46 -0
  421. package/src/shared/domain/compaction-thresholds.ts +162 -0
  422. package/src/shared/domain/compaction.ts +288 -0
  423. package/src/shared/domain/config-schema.ts +434 -0
  424. package/src/shared/domain/context-prune.ts +176 -0
  425. package/src/shared/domain/decision/questions.ts +102 -0
  426. package/src/shared/domain/dev/access-cost.ts +230 -0
  427. package/src/shared/domain/dev/artefacts.ts +50 -0
  428. package/src/shared/domain/dev/batches-concurrency.ts +35 -0
  429. package/src/shared/domain/dev/batches-state.ts +49 -0
  430. package/src/shared/domain/dev/build-commands.ts +45 -0
  431. package/src/shared/domain/dev/call-guard.ts +342 -0
  432. package/src/shared/domain/dev/carried-text.ts +47 -0
  433. package/src/shared/domain/dev/design-rules.ts +100 -0
  434. package/src/shared/domain/dev/learn-proposals.ts +176 -0
  435. package/src/shared/domain/dev/learn-state.ts +94 -0
  436. package/src/shared/domain/dev/markers.ts +107 -0
  437. package/src/shared/domain/dev/messages.ts +259 -0
  438. package/src/shared/domain/dev/path-args.ts +42 -0
  439. package/src/shared/domain/dev/path-rebase.ts +93 -0
  440. package/src/shared/domain/dev/phase-timing.ts +50 -0
  441. package/src/shared/domain/dev/plan-checks.ts +191 -0
  442. package/src/shared/domain/dev/plan-format.ts +170 -0
  443. package/src/shared/domain/dev/project-files.ts +29 -0
  444. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  445. package/src/shared/domain/dev/prompts.ts +251 -0
  446. package/src/shared/domain/dev/questions.ts +267 -0
  447. package/src/shared/domain/dev/reading-rule.ts +41 -0
  448. package/src/shared/domain/dev/repo-pack.ts +240 -0
  449. package/src/shared/domain/dev/review-answer.ts +173 -0
  450. package/src/shared/domain/dev/review-brief.ts +54 -0
  451. package/src/shared/domain/dev/reviewer-charter.ts +35 -0
  452. package/src/shared/domain/dev/sheet-facts.ts +81 -0
  453. package/src/shared/domain/dev/spec-format.ts +182 -0
  454. package/src/shared/domain/dev/step-budget.ts +74 -0
  455. package/src/shared/domain/dev/step-rules.ts +109 -0
  456. package/src/shared/domain/dev/test-commands.ts +94 -0
  457. package/src/shared/domain/dev/test-output.ts +33 -0
  458. package/src/shared/domain/dev/test-paths.ts +40 -0
  459. package/src/shared/domain/dev/tool-guards.ts +65 -0
  460. package/src/shared/domain/dev/trait-pattern.ts +87 -0
  461. package/src/shared/domain/dev/verdict-format.ts +162 -0
  462. package/src/shared/domain/dev/whitespace.ts +35 -0
  463. package/src/shared/domain/dev/work-folder.ts +68 -0
  464. package/src/shared/domain/dev/yaml-subset.ts +385 -0
  465. package/src/shared/domain/error-text.ts +13 -0
  466. package/src/shared/domain/git/close.ts +274 -0
  467. package/src/shared/domain/git/messages.ts +20 -0
  468. package/src/shared/domain/git/pull-request.ts +96 -0
  469. package/src/shared/domain/git/worktree.ts +46 -0
  470. package/src/shared/domain/host-layout.ts +147 -0
  471. package/src/shared/domain/host-paths.ts +399 -0
  472. package/src/shared/domain/index-languages.ts +16 -0
  473. package/src/shared/domain/instructions-file.ts +18 -0
  474. package/src/shared/domain/iso-day.ts +4 -0
  475. package/src/shared/domain/llm-failure.ts +134 -0
  476. package/src/shared/domain/llm-profile.ts +44 -0
  477. package/src/shared/domain/marked-message.ts +29 -0
  478. package/src/shared/domain/markers.ts +30 -0
  479. package/src/shared/domain/messages.ts +291 -0
  480. package/src/shared/domain/model-catalog.ts +79 -0
  481. package/src/shared/domain/permission-modes.ts +99 -0
  482. package/src/shared/domain/prelude.ts +92 -0
  483. package/src/shared/domain/project-manifests.ts +84 -0
  484. package/src/shared/domain/prompts.ts +233 -0
  485. package/src/shared/domain/search-routing.ts +77 -0
  486. package/src/shared/domain/secret-patterns.ts +46 -0
  487. package/src/shared/domain/session-keys.ts +92 -0
  488. package/src/shared/domain/session-start.ts +61 -0
  489. package/src/shared/domain/severity.ts +72 -0
  490. package/src/shared/domain/sha1.ts +61 -0
  491. package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
  492. package/src/shared/domain/shared-memory/candidates.ts +40 -0
  493. package/src/shared/domain/shared-memory/entry.ts +151 -0
  494. package/src/shared/domain/shared-memory/front-matter.ts +187 -0
  495. package/src/shared/domain/shared-memory/gate.ts +45 -0
  496. package/src/shared/domain/shared-memory/harvest.ts +64 -0
  497. package/src/shared/domain/shared-memory/layout.ts +190 -0
  498. package/src/shared/domain/shared-memory/markers.ts +9 -0
  499. package/src/shared/domain/shared-memory/messages.ts +66 -0
  500. package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
  501. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  502. package/src/shared/domain/shared-memory/refused.ts +84 -0
  503. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  504. package/src/shared/domain/skills/prompts.ts +4 -0
  505. package/src/shared/domain/skills/shortlist.ts +149 -0
  506. package/src/shared/domain/snip-turns.ts +33 -0
  507. package/src/shared/domain/speech.ts +21 -0
  508. package/src/shared/domain/strip.ts +88 -0
  509. package/src/shared/domain/tool-trace.ts +120 -0
  510. package/src/shared/domain/types.ts +67 -0
  511. package/src/shared/domain/verifiers.ts +33 -0
  512. package/src/shared/domain/vfs.ts +16 -0
  513. package/src/shared/domain/workflow/prompts.ts +15 -0
  514. package/src/shared/domain/workflow/state-file.ts +142 -0
  515. package/src/shared/infrastructure/globals.ts +57 -0
  516. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  517. package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
  518. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  519. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  520. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  521. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  522. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  523. package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
  524. package/src/shared/infrastructure/orkeon/files.ts +58 -0
  525. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
  526. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  527. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  528. package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
  529. package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
  530. package/src/shared/infrastructure/orkeon/llm.ts +164 -0
  531. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  532. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  533. package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
  534. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  535. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  536. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  537. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  538. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  539. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  540. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  541. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  542. package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
  543. package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
  544. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  545. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  546. package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
  547. package/src/shared/infrastructure/orkeon/shell.ts +39 -0
  548. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  549. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
  550. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  551. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  552. package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
@@ -0,0 +1,558 @@
1
+ // /dev-learn's use case: checks the inputs and the checkout, reads every verdict file
2
+ // of the work folder with both learning states and the refused motifs, then either
3
+ // lists the untreated gaps per axis (--list: no model call, no write) or, for each
4
+ // axis whose untreated gaps span three batches or more (three axes at most), asks the
5
+ // model once - once more on a wrong answer, or with the owner lines its motifs need -
6
+ // to group them into motifs, filters the motifs by code, reconciles them with their
7
+ // owner file and writes proposals.json and
8
+ // PROPOSALS.md under <work>/learn-<date>/. Then, when a person answers, it takes the
9
+ // decisions in the same run: one multi-select per axis with motifs, the selected motifs
10
+ // accepted and the others refused, as /dev-learn --accept and --refuse would (Orkeon
11
+ // Code's state, refused.md). Unanswered, nothing is decided and the end message names
12
+ // both commands. It never writes a harness file or an owner file.
13
+ import type { Files, HumanInput, Llm, Logger, Shell } from "../../../shared/application/ports.ts";
14
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
15
+ import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
16
+ import { decideMotifs } from "../../../shared/application/dev/learn-decision.ts";
17
+ import { readMemoryDir } from "../../../shared/application/shared-memory/memory-settings.ts";
18
+ import { GIT_TOPLEVEL, workFolderLabel } from "../../../shared/application/dev/resolve-work-folder.ts";
19
+ import type { WorkFolder } from "../../../shared/application/dev/resolve-work-folder.ts";
20
+ import {
21
+ MIN_MOTIF_BATCHES, axisListing, backlogByAxis, canonicalAxis, foldText,
22
+ } from "../../../shared/domain/shared-memory/verdict-rows.ts";
23
+ import type { AxisBacklog, LearnRow } from "../../../shared/domain/shared-memory/verdict-rows.ts";
24
+ import { topicOf } from "../../../shared/domain/shared-memory/refused.ts";
25
+ import {
26
+ LEARN_FOLDER_PATTERN, PROPOSALS_JSON, PROPOSALS_MD, deployedHarnessPath, learnFolderName, motifId,
27
+ parseProposalsFile, serializeProposalsFile,
28
+ } from "../../../shared/domain/dev/learn-proposals.ts";
29
+ import type { AxisProposal, DroppedMotif, Motif, ProposalsFile } from "../../../shared/domain/dev/learn-proposals.ts";
30
+ import { sha1Hex } from "../../../shared/domain/sha1.ts";
31
+ import { LEARN_ANSWER_SCHEMA, checkLearnAnswer, motifLabel } from "../domain/learn-answer.ts";
32
+ import type { AnswerMotif, LearnAnswer } from "../domain/learn-answer.ts";
33
+ import { matchOwner, reviewOwner } from "../domain/owner-lines.ts";
34
+ import type { OwnerLinesBlock, OwnerReview } from "../domain/owner-lines.ts";
35
+ import { renderProposals } from "../domain/proposals-render.ts";
36
+ import { MAX_LEARN_PROMPT_CHARS, buildLearnPrompt } from "./learn-prompt-fit.ts";
37
+ import type { LearnPromptInput } from "./learn-prompt-fit.ts";
38
+ import { readBacklog } from "./learn-backlog.ts";
39
+ import type { Backlog } from "./learn-backlog.ts";
40
+ import { AXIS_TABLE_HEADER, BAD_INPUT_AXIS, BAD_INPUT_LIST, NOTHING_TO_DECIDE_UNTIL_NEW_GAPS, NOTHING_UNTREATED, LEARN_NOT_IN_WORK_TREE, REFUSED_IN_HARNESS, REFUSE_EACH, REMOVED_LINE_KEPT, axisUnchanged, decideQuestion, learnHead, motifsProposed, noAxisEligible, noMotifKept, noProposalOnAxis, notAtTop, nothingUntreatedOnAxis, proposalsWritten, underThreeBatches } from "./messages.ts";
41
+ import { answerDidNotParse } from "../../../shared/application/agents/messages.ts";
42
+ import { errorText } from "../../../shared/domain/error-text.ts";
43
+ import {
44
+ learnBlockedNotWritten as blockedCannotWrite, learnNoWorkFolder as noWorkFolder, learnOutsideMounts as workFolderOutsideMounts,
45
+ } from "../../../shared/application/dev/messages.ts";
46
+ import { WORKSPACE, workspaceRelative } from "../../../shared/domain/vfs.ts";
47
+
48
+ export interface DevLearnInputs { axis?: unknown; list?: unknown }
49
+ export interface DevLearnDeps {
50
+ files: Files; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">;
51
+ llm: Pick<Llm, "extract">; log: Logger; clock: () => Date;
52
+ /** Asks the person to decide on the motifs; absent, nothing is decided in the run. */
53
+ human?: Pick<HumanInput, "multi">;
54
+ }
55
+ export const MAX_AXES_PER_RUN = 3;
56
+ export const MAX_ROWS_PER_AXIS = 40;
57
+
58
+ const MAX_WARNINGS = 5;
59
+ const MAX_AXES_NAMED = 5;
60
+ const MAX_OWNERS = 12;
61
+ const LIST_CAP = 1000;
62
+ const TESTS_LIST_CAP = 500;
63
+ const OWNER_READ_CHARS = 400_000;
64
+ const MAX_OPTION_CHARS = 150;
65
+ /** Repository guidance files offered to the model as owners, when the checkout holds them. */
66
+ const OWNER_CANDIDATES: readonly string[] = [
67
+ "CONTRIBUTING.md", "AGENTS.md", "CLAUDE.md", "docs/architecture.md", "docs/CONTRIBUTING.md", ".editorconfig",
68
+ ".orkeon/repo.yaml",
69
+ ];
70
+ const KEEP = /^keep:\s*/i;
71
+
72
+ interface Checked { axis: string | null; list: boolean }
73
+
74
+ const reasonOf = (error: unknown): string => (error instanceof Error ? error.message : String(error)).split("\n")[0];
75
+ const bare = (entry: string): string => entry.replace(/\/+$/, "");
76
+ const pad2 = (n: number): string => String(n).padStart(2, "0");
77
+ const dateOf = (d: Date): string => `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
78
+ const cut = (text: string, n: number): string => {
79
+ const chars = Array.from(text);
80
+ return chars.length <= n ? text : chars.slice(0, n - 1).join("") + "…";
81
+ };
82
+
83
+ /** A write that fails names its path, so the BLOCKED line can say which. */
84
+ class WriteFailure extends Error {
85
+ readonly path: string;
86
+ constructor(path: string, cause: unknown) {
87
+ super(reasonOf(cause));
88
+ this.path = path;
89
+ }
90
+ }
91
+
92
+ function checkInputs(input: DevLearnInputs): Checked | string {
93
+ const { axis, list } = input;
94
+ let checkedAxis: string | null = null;
95
+ if (axis !== undefined && axis !== null) {
96
+ if (typeof axis !== "string" || axis.length < 1 || axis.length > 40 || /[|\r\n]/.test(axis)) {
97
+ return BAD_INPUT_AXIS;
98
+ }
99
+ checkedAxis = axis;
100
+ }
101
+ if (list !== undefined && typeof list !== "boolean") return BAD_INPUT_LIST;
102
+ return { axis: checkedAxis, list: list === true };
103
+ }
104
+
105
+ async function toplevelRefusal(shell: Pick<Shell, "run">): Promise<string | null> {
106
+ let top: string;
107
+ try {
108
+ const r = await shell.run(GIT_TOPLEVEL);
109
+ if (r.exitCode !== 0) return LEARN_NOT_IN_WORK_TREE;
110
+ top = r.stdout.trim();
111
+ } catch {
112
+ return LEARN_NOT_IN_WORK_TREE;
113
+ }
114
+ if (top === "") return LEARN_NOT_IN_WORK_TREE;
115
+ return top === WORKSPACE
116
+ ? null
117
+ : notAtTop(top, WORKSPACE);
118
+ }
119
+
120
+ function warningLines(warnings: readonly string[]): string[] {
121
+ const lines = warnings.slice(0, MAX_WARNINGS).map((w) => `warning: ${w}`);
122
+ if (warnings.length > MAX_WARNINGS) lines.push(`… ${warnings.length - MAX_WARNINGS} more warnings`);
123
+ return lines;
124
+ }
125
+
126
+ function refusedCount(backlog: Backlog): number {
127
+ return backlog.refused.length + backlog.harness.refused.length;
128
+ }
129
+
130
+ function batchesOf(rows: readonly LearnRow[]): string[] {
131
+ return [...new Set(rows.map((r) => r.batch))];
132
+ }
133
+
134
+ function headLine(work: WorkFolder, packShown: string | null, backlog: Backlog): string {
135
+ return learnHead(
136
+ workFolderLabel(work, packShown), backlog.untreated.length, batchesOf(backlog.untreated).length, backlog.files,
137
+ backlog.orkeon.treated.length, backlog.harness.treated.length, refusedCount(backlog),
138
+ );
139
+ }
140
+
141
+ // ---- --list ----
142
+
143
+ function axisTableLine(a: AxisBacklog): string {
144
+ const name = Array.from(a.axis).slice(0, 16).join("").padEnd(16);
145
+ return `${name} ${String(a.rows.length).padStart(4)} ${String(a.batches.length).padStart(7)} ${String(a.blocking).padStart(8)}`;
146
+ }
147
+
148
+ function listLines(backlog: Backlog, axes: readonly AxisBacklog[], axis: string | null): string[] {
149
+ if (axis !== null) {
150
+ const rows = axes.flatMap((a) => a.rows);
151
+ return rows.length === 0 ? [nothingUntreatedOnAxis(axis)] : axisListing(rows);
152
+ }
153
+ const out = axes.length === 0
154
+ ? [NOTHING_UNTREATED]
155
+ : ["", AXIS_TABLE_HEADER, ...axes.map(axisTableLine)];
156
+ const refused = [
157
+ ...backlog.refused.map((m) => `- ${m.topic} — ${m.motif}`),
158
+ ...backlog.harness.refused.map((t) => `- ${t} (harness)`),
159
+ ];
160
+ if (refused.length > 0) out.push("", "refused motifs:", ...refused);
161
+ return out;
162
+ }
163
+
164
+ // ---- the material ----
165
+
166
+ /** The repository's guidance files that exist, then the architecture tests of the pack's tests folder (12 at most). */
167
+ async function ownerFiles(files: Pick<Files, "list">, testsFolder: string | undefined): Promise<string[]> {
168
+ const listings = new Map<string, string[]>();
169
+ const listing = async (dir: string, cap: number): Promise<string[]> => {
170
+ const known = listings.get(dir);
171
+ if (known) return known;
172
+ let entries: string[];
173
+ try {
174
+ entries = (await files.list(dir, cap)).map(bare);
175
+ } catch {
176
+ entries = [];
177
+ }
178
+ listings.set(dir, entries);
179
+ return entries;
180
+ };
181
+ const out: string[] = [];
182
+ for (const path of OWNER_CANDIDATES) {
183
+ const slash = path.lastIndexOf("/");
184
+ const dir = slash < 0 ? WORKSPACE : `${WORKSPACE}/${path.slice(0, slash)}`;
185
+ if ((await listing(dir, LIST_CAP)).includes(path.slice(slash + 1))) out.push(path);
186
+ }
187
+ const tests = testsFolder?.trim().replace(/^\.\//, "").replace(/\/+$/, "");
188
+ if (tests && !tests.startsWith("/") && !tests.split("/").includes("..")) {
189
+ const names = (await listing(`${WORKSPACE}/${tests}`, TESTS_LIST_CAP)).filter((n) => n.includes("architecture")).sort();
190
+ out.push(...names.map((n) => `${tests}/${n}`));
191
+ }
192
+ return out.slice(0, MAX_OWNERS);
193
+ }
194
+
195
+ /** Each refused motif under the slug code matches it by: its topic, or for a harness refusal the slug of its text
196
+ * (topicOf); a line the harness keeps is listed as it is. */
197
+ function refusedForPrompt(backlog: Backlog): string[] {
198
+ return [...new Set([
199
+ ...backlog.refused.map((m) => `${m.topic} — ${m.motif}`),
200
+ ...backlog.harness.refused.map((t) => (KEEP.test(t) ? t : `${topicOf(t)} — ${t}`)),
201
+ ])];
202
+ }
203
+
204
+ /** The rows shown (40 at most, then fewer until the prompt fits its budget) and how many are hidden. */
205
+ function shownRows(entry: AxisBacklog, base: Omit<LearnPromptInput, "rows">): { shown: LearnRow[]; hidden: number } {
206
+ const shown = entry.rows.slice(0, MAX_ROWS_PER_AXIS);
207
+ while (shown.length > 0 && buildLearnPrompt({ ...base, rows: shown }, []).length > MAX_LEARN_PROMPT_CHARS) shown.pop();
208
+ return { shown, hidden: entry.rows.length - shown.length };
209
+ }
210
+
211
+ // ---- the earlier run ----
212
+
213
+ async function earlierProposals(files: Files, work: WorkFolder, today: string): Promise<ProposalsFile | null> {
214
+ if (work.vfsPath === null) return null;
215
+ let entries: string[];
216
+ try {
217
+ entries = (await files.list(work.vfsPath, LIST_CAP)).map(bare);
218
+ } catch {
219
+ return null;
220
+ }
221
+ const folders = entries.filter((e) => LEARN_FOLDER_PATTERN.test(e) && e < today).sort().reverse();
222
+ for (const folder of folders) {
223
+ let text: string;
224
+ try {
225
+ text = await files.read(`${work.vfsPath}/${folder}/${PROPOSALS_JSON}`);
226
+ } catch {
227
+ continue;
228
+ }
229
+ const parsed = parseProposalsFile(text);
230
+ if (parsed.ok) return { ...parsed.file, date: folder };
231
+ }
232
+ return null;
233
+ }
234
+
235
+ /** The earlier folder when the axis was asked there on the same rows and kept no motif; else null. */
236
+ function unchangedSince(previous: ProposalsFile | null, axis: string, shown: readonly string[]): string | null {
237
+ if (previous === null) return null;
238
+ const before = previous.axes.find((a) => a.axis === axis);
239
+ if (!before || (before.outcome !== "no-motif" && before.outcome !== "unchanged")) return null;
240
+ const same = before.shownRows.length === shown.length && [...before.shownRows].sort().join(",") === [...shown].sort().join(",");
241
+ if (!same) return null;
242
+ return before.outcome === "unchanged" && before.reason ? before.reason : previous.date;
243
+ }
244
+
245
+ // ---- the model call ----
246
+
247
+ /** What the owner files say against a checked answer: the problems of a re-ask and the owner lines shown with them. */
248
+ interface OwnerFindings { problems: string[]; blocks: OwnerLinesBlock[] }
249
+
250
+ /** Two attempts. A first answer refused on shape spends the second on its problems, as before; when its only fault
251
+ * is a status other than new, given before any owner line was shown, the second attempt also shows the owner
252
+ * lines of its motifs. A first answer that passes is reviewed against its owners; when they raise problems, the
253
+ * second attempt shows them with the owner lines, and a second answer that fails its check leaves the first one
254
+ * standing. */
255
+ async function ask(
256
+ llm: Pick<Llm, "extract">, input: LearnPromptInput, shownIds: ReadonlySet<string>,
257
+ review: (answer: LearnAnswer) => Promise<OwnerFindings>,
258
+ ): Promise<{ ok: true; answer: LearnAnswer } | { ok: false; problem: string }> {
259
+ let problems: string[] = [];
260
+ let blocks: OwnerLinesBlock[] = [];
261
+ let first: LearnAnswer | null = null;
262
+ for (let attempt = 0; attempt < 2; attempt++) {
263
+ let value: unknown;
264
+ try {
265
+ value = await llm.extract(buildLearnPrompt(input, problems, blocks), LEARN_ANSWER_SCHEMA);
266
+ } catch (error) {
267
+ if (first !== null) return { ok: true, answer: first };
268
+ problems = [answerDidNotParse(errorText(error))];
269
+ continue;
270
+ }
271
+ const checked = checkLearnAnswer(value, shownIds, blocks.some((b) => b.lines.length > 0));
272
+ if (!checked.ok) {
273
+ if (first !== null) return { ok: true, answer: first };
274
+ problems = checked.problems;
275
+ const seen = attempt === 0 ? checkLearnAnswer(value, shownIds, true) : null;
276
+ if (seen?.ok) {
277
+ const findings = await review(seen.value);
278
+ problems = [...problems, ...findings.problems];
279
+ blocks = findings.blocks;
280
+ }
281
+ continue;
282
+ }
283
+ if (attempt > 0) return { ok: true, answer: checked.value };
284
+ const findings = await review(checked.value);
285
+ if (findings.problems.length === 0) return { ok: true, answer: checked.value };
286
+ first = checked.value;
287
+ problems = findings.problems;
288
+ blocks = findings.blocks;
289
+ }
290
+ return first !== null ? { ok: true, answer: first } : { ok: false, problem: problems[0] ?? "no answer" };
291
+ }
292
+
293
+ // ---- the code filters ----
294
+
295
+ /** k: the motif's place in the answer, from 1, as the problems number it. */
296
+ interface Kept { motif: AnswerMotif; batches: string[]; k: number }
297
+
298
+ function filterMotifs(
299
+ answer: LearnAnswer, rowsById: ReadonlyMap<string, LearnRow>, backlog: Backlog,
300
+ ): { kept: Kept[]; dropped: DroppedMotif[] } {
301
+ const dropped: DroppedMotif[] = [];
302
+ const harnessTexts = backlog.harness.refused.filter((t) => !KEEP.test(t));
303
+ const keptLines = backlog.harness.refused.filter((t) => KEEP.test(t)).map((t) => foldText(t.replace(KEEP, "").trim()));
304
+ const kept: Kept[] = [];
305
+ for (let i = 0; i < answer.motifs.length; i++) {
306
+ const motif = answer.motifs[i];
307
+ const batches = batchesOf(motif.rows.map((id) => rowsById.get(id)).filter((r): r is LearnRow => r !== undefined));
308
+ if (batches.length < MIN_MOTIF_BATCHES) {
309
+ dropped.push({ title: motif.title, filter: "recurrence", reason: `${batches.length} batches (${batches.join(", ")})` });
310
+ continue;
311
+ }
312
+ const refused = backlog.refused.find((r) => r.topic === motif.topic);
313
+ if (refused) {
314
+ dropped.push({ title: motif.title, filter: "novelty", reason: `refused on ${refused.date} (${backlog.refusedFile})` });
315
+ continue;
316
+ }
317
+ if (harnessTexts.some((t) => foldText(t.trim()) === foldText(motif.title) || topicOf(t) === motif.topic)) {
318
+ dropped.push({ title: motif.title, filter: "novelty", reason: REFUSED_IN_HARNESS });
319
+ continue;
320
+ }
321
+ const linesRemoved = motif.linesRemoved.filter((l) => !keptLines.includes(foldText(l.trim())));
322
+ if (motif.status !== "new" && linesRemoved.length === 0) {
323
+ dropped.push({ title: motif.title, filter: "novelty", reason: REMOVED_LINE_KEPT });
324
+ continue;
325
+ }
326
+ kept.push({ motif: { ...motif, linesRemoved }, batches, k: i + 1 });
327
+ }
328
+ return { kept, dropped: [...dropped, ...answer.dropped] };
329
+ }
330
+
331
+ // ---- reconcile ----
332
+
333
+ /** Reads a motif's owner file in the checkout (a harness owner through its deployed copy), each path once a run;
334
+ * path: the file read. */
335
+ function ownerReader(files: Pick<Files, "read">): (motif: AnswerMotif) => Promise<{ path: string; text: string | null }> {
336
+ const texts = new Map<string, string | null>();
337
+ return async (motif) => {
338
+ const path = motif.owner.kind === "harness" ? deployedHarnessPath(motif.owner.path) : motif.owner.path;
339
+ if (path === null) return { path: motif.owner.path, text: null };
340
+ if (!texts.has(path)) {
341
+ let text: string | null;
342
+ try {
343
+ text = await files.read(`${WORKSPACE}/${path}`, OWNER_READ_CHARS);
344
+ } catch {
345
+ text = null;
346
+ }
347
+ texts.set(path, text);
348
+ }
349
+ return { path, text: texts.get(path) ?? null };
350
+ };
351
+ }
352
+
353
+ type OwnerRead = ReturnType<typeof ownerReader>;
354
+
355
+ /** A kept motif against its owner: an absent owner (the file read) is only said in the summary; what the owner
356
+ * holds is named under the owner's own path, a harness owner's in the orkeon-workshop repository. */
357
+ async function reconcile(read: OwnerRead, { motif, k }: Kept): Promise<OwnerReview> {
358
+ const { path, text } = await read(motif);
359
+ if (text === null) return { summary: `owner absent: ${path}`, problems: [], block: null };
360
+ return reviewOwner(motifLabel(k, motif.title), motif, motif.owner.path, matchOwner(text, motif.keyTerm, motif.linesRemoved));
361
+ }
362
+
363
+ async function ownerFindings(read: OwnerRead, kept: readonly Kept[]): Promise<OwnerFindings> {
364
+ const findings: OwnerFindings = { problems: [], blocks: [] };
365
+ for (const one of kept) {
366
+ const review = await reconcile(read, one);
367
+ findings.problems.push(...review.problems);
368
+ if (review.block !== null) findings.blocks.push(review.block);
369
+ }
370
+ return findings;
371
+ }
372
+
373
+ /** 8 hex digits per motif; 10 for every motif whose 8 collide with another's in the file (L3-Q09). */
374
+ function settleIds(axes: AxisProposal[]): void {
375
+ const count = new Map<string, number>();
376
+ for (const m of axes.flatMap((a) => a.motifs)) count.set(m.id, (count.get(m.id) ?? 0) + 1);
377
+ for (const a of axes) {
378
+ for (const m of a.motifs) {
379
+ if ((count.get(m.id) ?? 0) > 1) m.id = sha1Hex(`${a.axis}|${[...m.rows].sort().join(",")}`).slice(0, 10);
380
+ }
381
+ }
382
+ }
383
+
384
+ function axisOutcomeLine(a: AxisProposal): string {
385
+ if (a.outcome === "unchanged") return axisUnchanged(a.axis, a.reason);
386
+ const head = `axis ${a.axis} — ${a.batches} batches: `;
387
+ if (a.outcome === "proposed") {
388
+ return motifsProposed(head, a.motifs.length, a.motifs.map((m) => m.id).join(", "), a.dropped.length);
389
+ }
390
+ if (a.outcome === "no-motif") return noMotifKept(head, a.dropped.length);
391
+ return `${head}no proposal (${a.reason ?? "no answer"})`;
392
+ }
393
+
394
+ /** One line per motif: `<id> — <title> (<n> batches, <status>, <owner>)`. */
395
+ function motifOption(m: Motif): string {
396
+ return cut(`${m.id} — ${m.title.replace(/\s+/g, " ")} (${m.batches.length} batches, ${m.status}, ${m.owner.path})`, MAX_OPTION_CHARS);
397
+ }
398
+
399
+ interface Decided { accept: string[]; refuse: string[]; ids: Set<string> }
400
+
401
+ /** One multi-select per axis with motifs: the selected ones accepted and the others refused. The human_input
402
+ * adapter offers "Decide later" first and reads it, or an empty selection, as no answer (an unattended provider
403
+ * must refuse nothing on the person's behalf): an axis left so decides nothing. */
404
+ async function askDecisions(
405
+ human: Pick<HumanInput, "multi"> | undefined, proposals: readonly AxisProposal[], shown: string,
406
+ ): Promise<Decided> {
407
+ const decided: Decided = { accept: [], refuse: [], ids: new Set() };
408
+ if (human === undefined) return decided;
409
+ for (const axis of proposals) {
410
+ if (axis.motifs.length === 0) continue;
411
+ const byOption = new Map(axis.motifs.map((m) => [motifOption(m), m.id]));
412
+ const answer = await human.multi(
413
+ decideQuestion(axis.axis, shown),
414
+ [...byOption.keys()],
415
+ );
416
+ if (!answer.answered) continue;
417
+ const picked = new Set(answer.values.map((v) => byOption.get(v)).filter((id): id is string => id !== undefined));
418
+ if (picked.size === 0) continue;
419
+ for (const m of axis.motifs) {
420
+ (picked.has(m.id) ? decided.accept : decided.refuse).push(m.id);
421
+ decided.ids.add(m.id);
422
+ }
423
+ }
424
+ return decided;
425
+ }
426
+
427
+ export async function runDevLearn(input: DevLearnInputs, deps: DevLearnDeps): Promise<string> {
428
+ const args = checkInputs(input);
429
+ if (typeof args === "string") return args;
430
+ const top = await toplevelRefusal(deps.shell);
431
+ if (top !== null) return top;
432
+
433
+ const ctx = await loadDevContext(deps);
434
+ const work = ctx.work;
435
+ if (work.vfsPath === null) {
436
+ return [...warningLines(ctx.warnings),
437
+ workFolderOutsideMounts(work.folder),
438
+ ].join("\n");
439
+ }
440
+ if (!work.exists) {
441
+ return [...warningLines(ctx.warnings), noWorkFolder(work.folder)].join("\n");
442
+ }
443
+
444
+ // refused.md under memory.dir, as /memory-admit and memory_push read it; a value set aside is said.
445
+ const memoryDir = await readMemoryDir(deps.config);
446
+ const backlog = await readBacklog(deps.files, work, `${memoryDir.dir}/refused.md`);
447
+ const memoryWarnings = memoryDir.warning === undefined ? [] : [memoryDir.warning];
448
+ const out = [...warningLines([...ctx.warnings, ...memoryWarnings, ...backlog.warnings]), headLine(work, ctx.pack?.shown ?? null, backlog)];
449
+ const done = (...lines: string[]): string => [...out, ...lines].join("\n");
450
+
451
+ const wanted = args.axis === null ? null : canonicalAxis(args.axis);
452
+ const axes = backlogByAxis(backlog.untreated).filter((a) => wanted === null || a.axis === wanted);
453
+ if (args.list) return done(...listLines(backlog, axes, args.axis));
454
+
455
+ const eligible = axes.filter((a) => a.batches.length >= MIN_MOTIF_BATCHES);
456
+ if (args.axis !== null && eligible.length === 0) {
457
+ const b = axes[0]?.batches.length ?? 0;
458
+ return done(underThreeBatches(`${axes[0]?.axis ?? wanted}`, b));
459
+ }
460
+ if (eligible.length === 0) {
461
+ const named = axes.slice(0, MAX_AXES_NAMED).map((a) => `${a.axis} ${a.batches.length}`).join(", ");
462
+ return done(noAxisEligible(named === "" ? "none" : named));
463
+ }
464
+
465
+ const handled = eligible.slice(0, MAX_AXES_PER_RUN);
466
+ const left = eligible.slice(MAX_AXES_PER_RUN);
467
+ const date = dateOf(deps.clock());
468
+ const folder = learnFolderName(date);
469
+ const previous = await earlierProposals(deps.files, work, folder);
470
+ const owners = await ownerFiles(deps.files, ctx.pack?.pack.layout.tests);
471
+ const refused = refusedForPrompt(backlog);
472
+ const readOwner = ownerReader(deps.files);
473
+
474
+ const proposals: AxisProposal[] = [];
475
+ for (const entry of handled) {
476
+ const base = { axis: entry.axis, refused, owners };
477
+ const { shown, hidden } = shownRows(entry, base);
478
+ const proposal: AxisProposal = {
479
+ axis: entry.axis, batches: entry.batches.length, gaps: entry.rows.length,
480
+ shownRows: shown.map((r) => r.id), hiddenRows: hidden, outcome: "no-motif", motifs: [], dropped: [],
481
+ };
482
+ proposals.push(proposal);
483
+ const since = unchangedSince(previous, entry.axis, proposal.shownRows);
484
+ if (since !== null) {
485
+ proposal.outcome = "unchanged";
486
+ proposal.reason = since;
487
+ continue;
488
+ }
489
+ const rowsById = new Map(shown.map((r) => [r.id, r]));
490
+ const asked = await ask(deps.llm, { ...base, rows: shown }, new Set(proposal.shownRows),
491
+ (answer) => ownerFindings(readOwner, filterMotifs(answer, rowsById, backlog).kept));
492
+ if (!asked.ok) {
493
+ proposal.outcome = "no-proposal";
494
+ proposal.reason = asked.problem;
495
+ deps.log.warn(noProposalOnAxis(entry.axis, asked.problem));
496
+ continue;
497
+ }
498
+ const { kept, dropped } = filterMotifs(asked.answer, rowsById, backlog);
499
+ proposal.dropped = dropped;
500
+ for (const one of kept) {
501
+ const { motif, batches } = one;
502
+ const m: Motif = {
503
+ id: motifId(entry.axis, motif.rows), title: motif.title, topic: motif.topic, rows: motif.rows, batches,
504
+ preventiveLine: motif.preventiveLine, owner: motif.owner, check: motif.check, status: motif.status,
505
+ linesRemoved: motif.linesRemoved, linesAdded: motif.linesAdded, novelty: motif.novelty, keyTerm: motif.keyTerm,
506
+ reconcile: (await reconcile(readOwner, one)).summary,
507
+ };
508
+ proposal.motifs.push(m);
509
+ }
510
+ if (proposal.motifs.length > 0) proposal.outcome = "proposed";
511
+ }
512
+ settleIds(proposals);
513
+
514
+ const file: ProposalsFile = {
515
+ version: 1, date, work: work.folder,
516
+ read: {
517
+ files: backlog.files, gaps: backlog.untreated.length, batches: batchesOf(backlog.untreated).length,
518
+ treatedOrkeon: backlog.orkeon.treated.length, treatedHarness: backlog.harness.treated.length,
519
+ refused: refusedCount(backlog),
520
+ },
521
+ axes: proposals,
522
+ };
523
+ const dir = `${work.vfsPath}/${folder}`;
524
+ try {
525
+ for (const [name, content] of [[PROPOSALS_JSON, serializeProposalsFile(file)], [PROPOSALS_MD, renderProposals(file)]]) {
526
+ const path = `${dir}/${name}`;
527
+ try {
528
+ await deps.files.write(path, content);
529
+ } catch (error) {
530
+ throw new WriteFailure(path, error);
531
+ }
532
+ }
533
+ } catch (error) {
534
+ if (!(error instanceof WriteFailure)) throw error;
535
+ const shown = workspaceRelative(error.path);
536
+ return done(blockedCannotWrite(shown, error.message));
537
+ }
538
+ deps.log.info(proposalsWritten(`${work.folder}/${folder}`));
539
+
540
+ const lines = proposals.map(axisOutcomeLine);
541
+ if (left.length > 0) lines.push(`next run: ${left.map((a) => a.axis).join(", ")}`);
542
+ lines.push(`written: ${work.folder}/${folder}/${PROPOSALS_MD}`);
543
+ const decided = await askDecisions(deps.human, proposals, `${work.folder}/${folder}/${PROPOSALS_MD}`);
544
+ if (decided.accept.length + decided.refuse.length > 0) {
545
+ const lookup = { files: [{ folder, file }], warnings: [] };
546
+ lines.push(...await decideMotifs(decided.accept, decided.refuse, lookup, work, deps));
547
+ }
548
+ const ids = proposals.flatMap((a) => a.motifs.map((m) => m.id)).filter((id) => !decided.ids.has(id));
549
+ if (ids.length > 0) {
550
+ lines.push(
551
+ `→ /dev-learn --accept ${ids.join(",")}`,
552
+ REFUSE_EACH,
553
+ );
554
+ } else if (decided.ids.size === 0) {
555
+ lines.push(NOTHING_TO_DECIDE_UNTIL_NEW_GAPS);
556
+ }
557
+ return done(...lines);
558
+ }
@@ -0,0 +1,53 @@
1
+ // @orkeon-script 1.0
2
+ /// <reference path="../.orkeon/orkeon.d.ts" />
3
+ //
4
+ // DevLearn crew (/dev-learn). Composition root: it wires application/run-dev-learn,
5
+ // which reads every verdict file of the work folder, groups the untreated Blocking and
6
+ // Major gaps by axis, and for each axis whose gaps span three batches or more asks the
7
+ // model once (once more on a wrong answer) to name the motifs behind them. Code filters
8
+ // the motifs, checks their owner file and writes <work>/learn-<date>/PROPOSALS.md and
9
+ // proposals.json, then asks the person, one multi-select per axis with motifs, which to
10
+ // accept: the selected ones are accepted and the others refused, as /dev-learn --accept
11
+ // and --refuse would; "Decide later", nothing selected, or no answer decides nothing. With list, it prints
12
+ // the backlog per axis: no model call, no question, no write.
13
+ //
14
+ // Input (globalThis.inputs): { axis?: string | null, list?: boolean }
15
+ // Run standalone: bash scripts/run-crew.sh src/crews/dev-learn/crew.ork.ts --inputs '{"list":true}'
16
+ //
17
+ // No tool callbacks (shared/application/dev/tool-callbacks.ts): the learner has no tool and makes no act
18
+ // call, so there is no tool call to guard; the question goes through the human_input port (orkeonHumanInput),
19
+ // called by code. No budget, as analyze: the calls are code's, and at most six extract calls run
20
+ // (three axes, one re-ask each).
21
+
22
+ import { CrewBuilder, publishCrew, inputs } from "../../shared/infrastructure/globals.ts";
23
+ import {
24
+ orkeonAgent,
25
+ orkeonClock,
26
+ orkeonConfigStore,
27
+ orkeonFiles,
28
+ orkeonHumanInput,
29
+ orkeonShell,
30
+ } from "../../shared/infrastructure/orkeon/wiring.ts";
31
+ import { agentLlm } from "../../shared/infrastructure/orkeon/llm.ts";
32
+ import { runDevLearn } from "./application/run-dev-learn.ts";
33
+ import { LEARNER_GOAL } from "./application/messages.ts";
34
+
35
+ const ports = { shell: orkeonShell(), files: orkeonFiles(), config: orkeonConfigStore(), human: orkeonHumanInput() };
36
+
37
+ const learner = orkeonAgent()
38
+ .name("dev-learner")
39
+ .role("Recurring-gap analyst")
40
+ // NO tools on purpose: one extract per axis, and every row it judges is in the prompt.
41
+ .tools([])
42
+ .goal(LEARNER_GOAL)
43
+ .body(async (_input: any, ctx: any) =>
44
+ await runDevLearn(inputs(), { ...ports, llm: agentLlm(ctx), log: ctx.log, clock: orkeonClock() }))
45
+ .build();
46
+
47
+ publishCrew(
48
+ CrewBuilder()
49
+ .name("dev-learn")
50
+ .process("sequential")
51
+ .withAgent(learner)
52
+ .build(),
53
+ );