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,177 @@
1
+ // admitEntries: what /memory-admit decided, applied by the crew shared-memory-admit. Per admitted
2
+ // id: the candidate re-read and re-checked (it may have been edited since it was shown), written
3
+ // to entries/<type>/<id>.md as admitted, each entry it supersedes rewritten, its candidate file
4
+ // turned into a pointer. Per refused id: its topic appended to refused.md, the pointer. Then the
5
+ // two lists and one ingestion of entries/ (prune: a superseded entry stays indexed, recall drops it
6
+ // by its status). A failed ingestion leaves the files as decided and says the index is stale.
7
+
8
+ import type { Files, SharedMemory } from "../ports.ts";
9
+ import type { MemoryEntry } from "../../domain/shared-memory/entry.ts";
10
+ import { entryProblems } from "../../domain/shared-memory/entry.ts";
11
+ import { parseEntry, serializeEntry } from "../../domain/shared-memory/front-matter.ts";
12
+ import { appendRefused } from "../../domain/shared-memory/refused.ts";
13
+ import { admissionProblem } from "../../domain/shared-memory/gate.ts";
14
+ import { decidedPointer } from "../../domain/shared-memory/candidates.ts";
15
+ import { candidatePath, entryPath } from "../../domain/shared-memory/layout.ts";
16
+ import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
17
+ import { readOrNull, refreshCandidatesList, refreshIndexFile, refusedTopics, storedEntries } from "./memory-files.ts";
18
+ import { sha1Hex } from "../../domain/sha1.ts";
19
+
20
+ export const DEFAULT_REFUSAL_MOTIF = "refused by /memory-admit";
21
+
22
+ /** One confirmed admission: the candidate's id and the sha1 of the file text the operator was shown. */
23
+ export interface Confirmed { id: string; sha1: string }
24
+
25
+ export interface AdmitDecisions {
26
+ admit: Confirmed[];
27
+ refuse: Array<{ id: string; motif?: string }>;
28
+ }
29
+
30
+ /** The crew's input read: the `{id, sha1}` items of `admit` with a kebab-case id and a sha1, nothing else. */
31
+ export function admittedCandidates(input: unknown): Confirmed[] {
32
+ const admit = (input as { admit?: unknown } | null)?.admit;
33
+ if (!Array.isArray(admit)) return [];
34
+ const seen = new Set<string>();
35
+ return admit.flatMap((item): Confirmed[] => {
36
+ const { id, sha1 } = (item ?? {}) as { id?: unknown; sha1?: unknown };
37
+ if (typeof id !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(id) || typeof sha1 !== "string" || !/^[0-9a-f]{40}$/.test(sha1)) return [];
38
+ if (seen.has(id)) return [];
39
+ seen.add(id);
40
+ return [{ id, sha1 }];
41
+ });
42
+ }
43
+
44
+ export interface AdmitDeps {
45
+ files: Pick<Files, "read" | "write" | "list">;
46
+ memory: Pick<SharedMemory, "ingest">;
47
+ clock: () => Date;
48
+ }
49
+
50
+ export interface AdmitOutcome {
51
+ admitted: string[];
52
+ refused: string[];
53
+ /** One line per id not applied, with the reason. */
54
+ failed: string[];
55
+ /** What went wrong without undoing a decision: a superseded id not found, a list not refreshed, a stale index. */
56
+ warnings: string[];
57
+ }
58
+
59
+ const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
60
+
61
+ /** The pending candidate `id`, or why it cannot be decided. */
62
+ async function candidate(
63
+ files: Pick<Files, "read">, layout: MemoryLayout, id: string, sha1?: string,
64
+ ): Promise<MemoryEntry | string> {
65
+ let text: string | null;
66
+ try {
67
+ text = await readOrNull(files, candidatePath(layout, id));
68
+ } catch (error) {
69
+ return `its candidate file cannot be read (${firstLine(error)})`;
70
+ }
71
+ if (text === null) return "no candidate file";
72
+ if (sha1 !== undefined && sha1Hex(text) !== sha1) return "its file changed since it was confirmed: run /memory-admit again";
73
+ const parsed = parseEntry(text);
74
+ if (!parsed.ok) return `its file is not a candidate entry any more (${parsed.problems[0] ?? "decided already"})`;
75
+ if (parsed.entry.status !== "candidate") return `its status is ${parsed.entry.status}, not candidate`;
76
+ if (parsed.entry.id !== id) return `its file holds the id ${parsed.entry.id}`;
77
+ return parsed.entry;
78
+ }
79
+
80
+ async function admitOne(
81
+ deps: AdmitDeps, layout: MemoryLayout, confirmed: Confirmed, today: string, outcome: AdmitOutcome,
82
+ ): Promise<boolean> {
83
+ const id = confirmed.id;
84
+ const found = await candidate(deps.files, layout, id, confirmed.sha1);
85
+ if (typeof found === "string") { outcome.failed.push(`${id}: ${found}`); return false; }
86
+ let refused: Set<string>;
87
+ try {
88
+ refused = await refusedTopics(deps.files, layout);
89
+ } catch (error) {
90
+ outcome.failed.push(`${id}: ${layout.refused} cannot be read (${firstLine(error)})`);
91
+ return false;
92
+ }
93
+ if (refused.has(found.topic)) { outcome.failed.push(`${id}: its topic '${found.topic}' was refused (refused.md)`); return false; }
94
+ const entry: MemoryEntry = { ...found, status: "admitted" };
95
+ const problems = [...entryProblems(entry), ...[admissionProblem(entry)].filter((p): p is string => p !== undefined)];
96
+ if (problems.length > 0) { outcome.failed.push(`${id}: not admitted, ${problems.join("; ")}`); return false; }
97
+ const target = entryPath(layout, entry.type, id);
98
+ try {
99
+ if ((await readOrNull(deps.files, target)) !== null) { outcome.failed.push(`${id}: ${target} exists already`); return false; }
100
+ await deps.files.write(target, serializeEntry(entry));
101
+ } catch (error) {
102
+ outcome.failed.push(`${id}: ${target} not written (${firstLine(error)})`);
103
+ return false;
104
+ }
105
+ outcome.admitted.push(id);
106
+ if (entry.supersedes.length > 0) {
107
+ const stored = await storedEntries(deps.files, layout);
108
+ for (const old of entry.supersedes) {
109
+ const hit = stored.find((s) => s.entry.id === old && s.entry.status === "admitted");
110
+ if (hit === undefined) { outcome.warnings.push(`${id} supersedes ${old}, which is no admitted entry: left as it is`); continue; }
111
+ try {
112
+ await deps.files.write(hit.path, serializeEntry({ ...hit.entry, status: "superseded", supersededBy: id }));
113
+ } catch (error) {
114
+ outcome.warnings.push(`${old} not marked superseded by ${id} (${firstLine(error)})`);
115
+ }
116
+ }
117
+ }
118
+ await pointer(deps.files, layout, id, decidedPointer("admitted", today, target), outcome);
119
+ return true;
120
+ }
121
+
122
+ async function refuseOne(
123
+ deps: AdmitDeps, layout: MemoryLayout, decision: { id: string; motif?: string }, today: string, outcome: AdmitOutcome,
124
+ ): Promise<void> {
125
+ const found = await candidate(deps.files, layout, decision.id);
126
+ if (typeof found === "string") { outcome.failed.push(`${decision.id}: ${found}`); return; }
127
+ try {
128
+ const previous = await readOrNull(deps.files, layout.refused);
129
+ const motif = decision.motif?.trim() || DEFAULT_REFUSAL_MOTIF;
130
+ await deps.files.write(layout.refused, appendRefused(previous, { topic: found.topic, project: found.project, date: today, motif }));
131
+ } catch (error) {
132
+ outcome.failed.push(`${decision.id}: ${layout.refused} not written (${firstLine(error)}), the candidate stays`);
133
+ return;
134
+ }
135
+ outcome.refused.push(decision.id);
136
+ await pointer(deps.files, layout, decision.id, decidedPointer("refused", today), outcome);
137
+ }
138
+
139
+ async function pointer(files: Pick<Files, "write">, layout: MemoryLayout, id: string, text: string, outcome: AdmitOutcome): Promise<void> {
140
+ try {
141
+ await files.write(candidatePath(layout, id), text);
142
+ } catch (error) {
143
+ outcome.warnings.push(`${candidatePath(layout, id)} still reads as a candidate (${firstLine(error)}): /memory-admit will say it is decided`);
144
+ }
145
+ }
146
+
147
+ export async function admitEntries(
148
+ deps: AdmitDeps, memory: { layout: MemoryLayout; collection: string }, decisions: AdmitDecisions,
149
+ ): Promise<AdmitOutcome> {
150
+ const outcome: AdmitOutcome = { admitted: [], refused: [], failed: [], warnings: [] };
151
+ const today = deps.clock().toISOString().slice(0, 10);
152
+ for (const decision of decisions.refuse) await refuseOne(deps, memory.layout, decision, today, outcome);
153
+ for (const confirmed of decisions.admit) await admitOne(deps, memory.layout, confirmed, today, outcome);
154
+ if (outcome.admitted.length + outcome.refused.length === 0) return outcome;
155
+ for (const line of [await refreshCandidatesList(deps.files, memory.layout), await refreshIndexFile(deps.files, memory.layout)]) {
156
+ if (line !== null) outcome.warnings.push(line);
157
+ }
158
+ if (outcome.admitted.length > 0) {
159
+ try {
160
+ const report = await deps.memory.ingest(memory.collection, [memory.layout.entriesGlob], { prune: true });
161
+ for (const error of report.errors) outcome.warnings.push(`index: ${error}`);
162
+ } catch (error) {
163
+ outcome.warnings.push(`the index of ${memory.collection} is stale (${firstLine(error)}): the next admission re-ingests entries/`);
164
+ }
165
+ }
166
+ return outcome;
167
+ }
168
+
169
+ /** The outcome as the crew's answer: one line per decision, then the warnings. */
170
+ export function admitReport(outcome: AdmitOutcome): string {
171
+ return [
172
+ ...outcome.admitted.map((id) => `admitted ${id}`),
173
+ ...outcome.refused.map((id) => `refused ${id}`),
174
+ ...outcome.failed.map((line) => `not applied: ${line}`),
175
+ ...outcome.warnings.map((line) => `warning: ${line}`),
176
+ ].join("\n") || "nothing to apply";
177
+ }
@@ -0,0 +1,72 @@
1
+ // After a GAPS verdict (lot M-7, temp/05 § 8 row M-7): every verdict file of the work folder is read again, the
2
+ // mistakes that recur in three batches become candidates under memory.dir (harvestMistakes: refused topics and
3
+ // topics a candidate or an entry holds are left out), and when untreated gaps span two batches or more the step
4
+ // says /dev-learn is due, as the harness's learning script nudges (--count). Candidates only: nothing is admitted
5
+ // without /memory-admit. Best effort: a failure costs the lines, never the verdict already written.
6
+
7
+ import type { ConfigStore } from "../config-store.ts";
8
+ import type { Files, Logger, Shell } from "../ports.ts";
9
+ import type { WorkFolder } from "../dev/resolve-work-folder.ts";
10
+ import { readVerdictSources } from "../dev/verdict-sources.ts";
11
+ import {
12
+ HARNESS_LEARN_STATE_FILE, LEARN_STATE_FILE, parseHarnessLearnState, parseLearnState,
13
+ } from "../../domain/dev/learn-state.ts";
14
+ import { NUDGE_BATCHES, collectLearnRows, untreated } from "../../domain/shared-memory/verdict-rows.ts";
15
+ import type { LearnRow } from "../../domain/shared-memory/verdict-rows.ts";
16
+ import { harvestMistakes } from "./harvest-mistakes.ts";
17
+ import { readMemorySettings } from "./memory-settings.ts";
18
+ import { readOrNull } from "./memory-files.ts";
19
+ import { WORKSPACE } from "../../domain/vfs.ts";
20
+
21
+ export interface AfterGapsDeps {
22
+ files: Pick<Files, "read" | "write" | "list">;
23
+ shell: Pick<Shell, "run">;
24
+ config: Pick<ConfigStore, "readValue">;
25
+ clock: () => Date;
26
+ log: Pick<Logger, "warn">;
27
+ }
28
+
29
+ const firstLine = (e: unknown): string => String((e as Error)?.message ?? e).split("\n")[0];
30
+ const plural = (n: number, one: string, many: string): string => `${n} ${n === 1 ? one : many}`;
31
+
32
+ /** The rows /dev-learn has not treated, by either learning state (an unreadable state treats nothing). */
33
+ async function untreatedRows(files: Pick<Files, "read">, rows: readonly LearnRow[]): Promise<LearnRow[]> {
34
+ const own = parseLearnState(await readOrNull(files, `${WORKSPACE}/${LEARN_STATE_FILE}`).catch(() => null));
35
+ const harness = parseHarnessLearnState(await readOrNull(files, `${WORKSPACE}/${HARNESS_LEARN_STATE_FILE}`).catch(() => null));
36
+ return untreated(rows, new Set([...(own.ok ? own.state.treated : []), ...harness.treated]));
37
+ }
38
+
39
+ /** The nudge line, "" below NUDGE_BATCHES distinct batches. */
40
+ export function learnNudge(rows: readonly LearnRow[]): string {
41
+ const batches = new Set(rows.map((r) => r.batch)).size;
42
+ if (batches < NUDGE_BATCHES) return "";
43
+ return `→ ${plural(rows.length, "untreated verdict gap", "untreated verdict gaps")} across ${batches} batches: /dev-learn ` +
44
+ "turns those that recur into rules (in a fresh session).";
45
+ }
46
+
47
+ /** The lines the verdict's end message adds: the candidates harvested, the nudge; none when there is nothing to say. */
48
+ export async function harvestAfterGaps(deps: AfterGapsDeps, work: Pick<WorkFolder, "folder" | "vfsPath">): Promise<string[]> {
49
+ try {
50
+ const read = await readVerdictSources(deps.files, work);
51
+ for (const w of read.warnings) deps.log.warn(`shared memory: ${w}`);
52
+ const rows = collectLearnRows(read.sources);
53
+ if (rows.length === 0) return [];
54
+ const lines: string[] = [];
55
+ const settings = await readMemorySettings(deps);
56
+ for (const w of settings.warnings) deps.log.warn(`shared memory: ${w}`);
57
+ const harvest = await harvestMistakes(deps, settings, rows);
58
+ for (const s of harvest.skipped) deps.log.warn(`shared memory: harvest: ${s}`);
59
+ if (harvest.written.length > 0) {
60
+ lines.push(
61
+ `shared memory: ${plural(harvest.written.length, "mistake candidate", "mistake candidates")} harvested from the audits ` +
62
+ `(${harvest.written.join(", ")}) → /memory-admit decides each one.`,
63
+ );
64
+ }
65
+ const nudge = learnNudge(await untreatedRows(deps.files, rows));
66
+ if (nudge !== "") lines.push(nudge);
67
+ return lines;
68
+ } catch (error) {
69
+ deps.log.warn(`shared memory: harvest after the verdict failed (${firstLine(error)})`);
70
+ return [];
71
+ }
72
+ }
@@ -0,0 +1,44 @@
1
+ // harvestMistakes: the mistake candidates the audit rows of a work folder justify (domain
2
+ // harvest.ts), each written through writeCandidate, unless a candidate or an entry already holds
3
+ // its topic. Called after a GAPS verdict (lot M-7 wires it into dev-verify).
4
+
5
+ import { mistakeCandidates } from "../../domain/shared-memory/harvest.ts";
6
+ import type { LearnRow } from "../../domain/shared-memory/verdict-rows.ts";
7
+ import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
8
+ import { pendingCandidates, refusedTopics, storedEntries } from "./memory-files.ts";
9
+ import { writeCandidate } from "./push-candidate.ts";
10
+ import type { PushDeps } from "./push-candidate.ts";
11
+
12
+ export interface HarvestOutcome {
13
+ written: string[];
14
+ /** One line per topic left out, with the reason. */
15
+ skipped: string[];
16
+ }
17
+
18
+ export async function harvestMistakes(
19
+ deps: PushDeps, memory: { layout: MemoryLayout; project: string }, rows: readonly LearnRow[],
20
+ ): Promise<HarvestOutcome> {
21
+ const outcome: HarvestOutcome = { written: [], skipped: [] };
22
+ let refused: Set<string>;
23
+ try {
24
+ refused = await refusedTopics(deps.files, memory.layout);
25
+ } catch (error) {
26
+ outcome.skipped.push(`refused.md cannot be read (${String((error as Error)?.message ?? error).split("\n")[0]}): nothing harvested`);
27
+ return outcome;
28
+ }
29
+ const date = deps.clock().toISOString().slice(0, 10);
30
+ const plan = mistakeCandidates(rows, { project: memory.project, date, refusedTopics: refused });
31
+ for (const topic of plan.refused) outcome.skipped.push(`${topic}: refused (refused.md)`);
32
+ const held = new Set([...await pendingCandidates(deps.files, memory.layout), ...await storedEntries(deps.files, memory.layout)]
33
+ .filter((s) => s.entry.type === "mistake").map((s) => s.entry.topic));
34
+ for (const candidate of plan.candidates) {
35
+ if (held.has(candidate.topic)) {
36
+ outcome.skipped.push(`${candidate.topic}: a mistake candidate or entry already holds it`);
37
+ continue;
38
+ }
39
+ const pushed = await writeCandidate(deps, memory, candidate);
40
+ if (pushed.ok) outcome.written.push(pushed.path);
41
+ else outcome.skipped.push(`${candidate.topic}: ${pushed.refused}`);
42
+ }
43
+ return outcome;
44
+ }
@@ -0,0 +1,117 @@
1
+ // importAgentMemory: the harness's agent memory (.claude/agent-memory/<agent>/MEMORY.md, read only)
2
+ // lifted into shared-memory candidates, one per entry (lot M-9, temp/05 § 8.2). Never an admission:
3
+ // /memory-admit decides each candidate. An entry whose topic a pending candidate, a stored entry or an
4
+ // earlier entry of the same import already holds is a duplicate and writes nothing; a refused topic
5
+ // or an invalid entry is reported by writeCandidate's own checks.
6
+
7
+ import type { Files } from "../ports.ts";
8
+ import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
9
+ import {
10
+ AGENT_MEMORY_INDEX, HARNESS_AGENT_MEMORY_DIR, MAX_NOTE_CHARS, importedEntry, parseAgentMemoryIndex, parseAgentNote,
11
+ } from "../../domain/shared-memory/agent-memory-import.ts";
12
+ import type { AgentNote } from "../../domain/shared-memory/agent-memory-import.ts";
13
+ import { MAX_LISTED, pendingCandidates, readOrNull, storedEntries } from "./memory-files.ts";
14
+ import { writeCandidate } from "./push-candidate.ts";
15
+ import { topicOf } from "../../domain/shared-memory/refused.ts";
16
+ import { secretPatternsIn } from "../../domain/secret-patterns.ts";
17
+ import { WORKSPACE } from "../../domain/vfs.ts";
18
+
19
+ export const HARNESS_AGENT_MEMORY_ROOT = `${WORKSPACE}/${HARNESS_AGENT_MEMORY_DIR}`;
20
+
21
+ export interface ImportOutcome {
22
+ /** The agents whose MEMORY.md was read, with their entry count. */
23
+ agents: Array<{ agent: string; entries: number }>;
24
+ written: Array<{ id: string; path: string }>;
25
+ duplicates: Array<{ agent: string; line: number; topic: string }>;
26
+ refused: Array<{ agent: string; line: number; reason: string }>;
27
+ warnings: string[];
28
+ }
29
+
30
+ export interface ImportDeps {
31
+ files: Pick<Files, "read" | "write" | "list">;
32
+ clock: () => Date;
33
+ }
34
+
35
+ const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
36
+
37
+ /** Reads every agent's MEMORY.md under `root` and writes a candidate per entry not already held. */
38
+ export async function importAgentMemory(
39
+ deps: ImportDeps, memory: { layout: MemoryLayout; project: string }, root: string = HARNESS_AGENT_MEMORY_ROOT,
40
+ ): Promise<ImportOutcome> {
41
+ const outcome: ImportOutcome = { agents: [], written: [], duplicates: [], refused: [], warnings: [] };
42
+ let agents: string[];
43
+ try {
44
+ agents = (await deps.files.list(root, MAX_LISTED)).map((n) => n.replace(/\/+$/, "").split("/").pop() ?? n)
45
+ .filter((n) => n !== "" && !n.startsWith(".") && n !== AGENT_MEMORY_INDEX).sort();
46
+ } catch {
47
+ return outcome;
48
+ }
49
+ const held = new Set<string>();
50
+ for (const stored of [...await pendingCandidates(deps.files, memory.layout), ...await storedEntries(deps.files, memory.layout)]) {
51
+ // Its topic, and the one its title gives (a pushed candidate names its own topic).
52
+ held.add(stored.entry.topic).add(topicOf(stored.entry.title));
53
+ }
54
+ const date = deps.clock().toISOString().slice(0, 10);
55
+ for (const agent of [...new Set(agents)]) {
56
+ const folder = `${root}/${agent}`;
57
+ let index: string | null;
58
+ try {
59
+ index = await readOrNull(deps.files, `${folder}/${AGENT_MEMORY_INDEX}`);
60
+ } catch (error) {
61
+ outcome.warnings.push(`${folder}/${AGENT_MEMORY_INDEX} cannot be read (${firstLine(error)})`);
62
+ continue;
63
+ }
64
+ if (index === null) continue;
65
+ const items = parseAgentMemoryIndex(index);
66
+ outcome.agents.push({ agent, entries: items.length });
67
+ for (const item of items) {
68
+ let note: AgentNote | null = null;
69
+ let uncut = `${item.title}\n${item.hook}`;
70
+ if (item.note !== undefined) {
71
+ try {
72
+ const text = await readOrNull(deps.files, `${folder}/${item.note}`);
73
+ note = text === null ? null : parseAgentNote(text.slice(0, MAX_NOTE_CHARS));
74
+ if (text !== null) uncut += `\n${text}`;
75
+ } catch (error) {
76
+ outcome.warnings.push(`${folder}/${item.note} cannot be read (${firstLine(error)}): the line alone is imported`);
77
+ }
78
+ }
79
+ // The entry cuts the note and the line: a secret cut at the boundary would slip past entryProblems,
80
+ // so the uncut text is scanned first.
81
+ const secrets = secretPatternsIn(uncut);
82
+ if (secrets.length > 0) {
83
+ outcome.refused.push({ agent, line: item.line, reason: `the item looks like it holds a secret (${secrets.join(", ")})` });
84
+ continue;
85
+ }
86
+ const entry = importedEntry(item, note, { agent, project: memory.project, date });
87
+ if (held.has(entry.topic)) {
88
+ outcome.duplicates.push({ agent, line: item.line, topic: entry.topic });
89
+ continue;
90
+ }
91
+ const written = await writeCandidate(deps, memory, entry);
92
+ if (!written.ok) {
93
+ outcome.refused.push({ agent, line: item.line, reason: written.refused });
94
+ continue;
95
+ }
96
+ held.add(entry.topic);
97
+ outcome.written.push({ id: written.id, path: written.path });
98
+ for (const warning of written.warnings) if (!outcome.warnings.includes(warning)) outcome.warnings.push(warning);
99
+ }
100
+ }
101
+ return outcome;
102
+ }
103
+
104
+ /** The lines the operator reads after an import. */
105
+ export function importReport(outcome: ImportOutcome, root: string = HARNESS_AGENT_MEMORY_ROOT): string {
106
+ if (outcome.agents.length === 0) return `No harness agent memory in ${root} (no <agent>/${AGENT_MEMORY_INDEX}).`;
107
+ const lines = outcome.agents.map((a) => `${root}/${a.agent}/${AGENT_MEMORY_INDEX}: ${a.entries} entr${a.entries === 1 ? "y" : "ies"}`);
108
+ lines.push(outcome.written.length === 0 ? "No candidate written."
109
+ : `${outcome.written.length} candidate(s) written: ${outcome.written.map((w) => w.id).join(", ")}`);
110
+ if (outcome.duplicates.length > 0) {
111
+ lines.push(`${outcome.duplicates.length} duplicate(s) skipped (topic already held): ${outcome.duplicates.map((d) => `${d.agent}:${d.line} ${d.topic}`).join(", ")}`);
112
+ }
113
+ for (const r of outcome.refused) lines.push(`✗ ${r.agent}/${AGENT_MEMORY_INDEX}:${r.line}: ${r.reason}`);
114
+ for (const w of outcome.warnings) lines.push(`warning: ${w}`);
115
+ if (outcome.written.length > 0) lines.push("Decide them with /memory-admit (each one is asked).");
116
+ return lines.join("\n");
117
+ }
@@ -0,0 +1,110 @@
1
+ // The shared memory's files as the use cases read and write them, through Files: the pending
2
+ // candidates, the entries, the refused topics, the two generated lists. A folder that does not
3
+ // exist yet reads as empty; the first file_write creates it.
4
+
5
+ import type { Files } from "../ports.ts";
6
+ import { ENTRY_TYPES } from "../../domain/shared-memory/entry.ts";
7
+ import type { MemoryEntry } from "../../domain/shared-memory/entry.ts";
8
+ import { parseEntry, serializeEntry } from "../../domain/shared-memory/front-matter.ts";
9
+ import { parseRefused } from "../../domain/shared-memory/refused.ts";
10
+ import { CANDIDATES_TITLE, INDEX_TITLE, candidatesList, entriesIndex } from "../../domain/shared-memory/candidates.ts";
11
+ import { candidatePath } from "../../domain/shared-memory/layout.ts";
12
+ import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
13
+
14
+ /** How many files of one folder are read at most. */
15
+ export const MAX_LISTED = 1_000;
16
+
17
+ export interface StoredEntry {
18
+ entry: MemoryEntry;
19
+ path: string;
20
+ /** The file's text as read: its sha1 is what an admission confirms. */
21
+ text: string;
22
+ }
23
+
24
+ /** The file's text, or null when it does not exist; an unreadable file throws. */
25
+ export async function readOrNull(files: Pick<Files, "read">, path: string): Promise<string | null> {
26
+ try {
27
+ return await files.read(path);
28
+ } catch (error) {
29
+ if (/not found|does not exist|no such file|could not find/i.test(String((error as Error)?.message ?? error))) return null;
30
+ throw error;
31
+ }
32
+ }
33
+
34
+ async function namesIn(files: Pick<Files, "list">, folder: string): Promise<string[]> {
35
+ try {
36
+ return (await files.list(folder, MAX_LISTED)).map((name) => name.split("/").pop() ?? name).filter((n) => n.endsWith(".md"));
37
+ } catch {
38
+ return [];
39
+ }
40
+ }
41
+
42
+ /** The entries of `folder` whose file parses, with `status` among `statuses`. */
43
+ async function entriesIn(files: Pick<Files, "list" | "read">, folder: string, statuses: readonly string[]): Promise<StoredEntry[]> {
44
+ const found: StoredEntry[] = [];
45
+ for (const name of (await namesIn(files, folder)).sort()) {
46
+ const path = `${folder}/${name}`;
47
+ let text: string | null;
48
+ try {
49
+ text = await readOrNull(files, path);
50
+ } catch {
51
+ continue;
52
+ }
53
+ const parsed = text === null ? null : parseEntry(text);
54
+ if (text !== null && parsed?.ok && statuses.includes(parsed.entry.status)) found.push({ entry: parsed.entry, path, text });
55
+ }
56
+ return found;
57
+ }
58
+
59
+ /** The pending candidates: the files of candidates/ that parse as an entry of status candidate. */
60
+ export async function pendingCandidates(files: Pick<Files, "list" | "read">, layout: MemoryLayout): Promise<StoredEntry[]> {
61
+ return entriesIn(files, layout.candidates, ["candidate"]);
62
+ }
63
+
64
+ /** Every entry of entries/<type>/, admitted or superseded. */
65
+ export async function storedEntries(files: Pick<Files, "list" | "read">, layout: MemoryLayout): Promise<StoredEntry[]> {
66
+ const all: StoredEntry[] = [];
67
+ for (const type of ENTRY_TYPES) all.push(...await entriesIn(files, `${layout.entries}/${type}`, ["admitted", "superseded"]));
68
+ return all;
69
+ }
70
+
71
+ /** The refused topics; none when refused.md does not exist. Throws when it cannot be read. */
72
+ export async function refusedTopics(files: Pick<Files, "read">, layout: MemoryLayout): Promise<Set<string>> {
73
+ const text = await readOrNull(files, layout.refused);
74
+ return new Set(text === null ? [] : parseRefused(text).motifs.map((m) => m.topic));
75
+ }
76
+
77
+ /** Writes the candidate's file; its path. */
78
+ export async function writeCandidateFile(files: Pick<Files, "write">, layout: MemoryLayout, entry: MemoryEntry): Promise<string> {
79
+ const path = candidatePath(layout, entry.id);
80
+ await files.write(path, serializeEntry({ ...entry, status: "candidate" }));
81
+ return path;
82
+ }
83
+
84
+ /** Writes a generated list, unless the file exists and is not one (memory.dir pointed at a folder of the project). */
85
+ async function writeGenerated(files: Pick<Files, "read" | "write">, path: string, title: string, text: string): Promise<string | null> {
86
+ const previous = await readOrNull(files, path);
87
+ if (previous !== null && previous.trim() !== "" && !previous.startsWith(title)) {
88
+ return `${path} not refreshed: it exists and is not the memory's (it does not start with '${title}')`;
89
+ }
90
+ await files.write(path, text);
91
+ return null;
92
+ }
93
+
94
+ /** Rewrites CANDIDATES.md from the pending candidates; a failure is a line, never a throw. */
95
+ export async function refreshCandidatesList(files: Pick<Files, "list" | "read" | "write">, layout: MemoryLayout): Promise<string | null> {
96
+ try {
97
+ return await writeGenerated(files, layout.candidatesList, CANDIDATES_TITLE, candidatesList((await pendingCandidates(files, layout)).map((c) => c.entry)));
98
+ } catch (error) {
99
+ return `${layout.candidatesList} not refreshed (${String((error as Error)?.message ?? error).split("\n")[0]})`;
100
+ }
101
+ }
102
+
103
+ /** Rewrites INDEX.md from the entries; a failure is a line, never a throw. */
104
+ export async function refreshIndexFile(files: Pick<Files, "list" | "read" | "write">, layout: MemoryLayout): Promise<string | null> {
105
+ try {
106
+ return await writeGenerated(files, layout.index, INDEX_TITLE, entriesIndex((await storedEntries(files, layout)).map((e) => e.entry)));
107
+ } catch (error) {
108
+ return `${layout.index} not refreshed (${String((error as Error)?.message ?? error).split("\n")[0]})`;
109
+ }
110
+ }
@@ -0,0 +1,93 @@
1
+ // The shared memory's settings as they apply to a run: the folder (memory.dir), the project
2
+ // (memory.project, else the origin remote's name, else "local", as /dev-learn names it) and
3
+ // whether an audited candidate is admitted without asking (memory.autoAdmitAudited). A stored
4
+ // value is checked again here, since the config store hands back what the file holds: an invalid
5
+ // one falls back to the default with a warning, it never stops the caller.
6
+
7
+ import type { ConfigStore } from "../config-store.ts";
8
+ import type { Shell } from "../ports.ts";
9
+ import { projectFromRemote } from "../../domain/shared-memory/refused.ts";
10
+ import {
11
+ DEFAULT_MEMORY_DIR, MEMORY_AUTO_ADMIT_CONFIG_KEY, MEMORY_DIR_CONFIG_KEY, MEMORY_PROJECT_CONFIG_KEY, checkMemoryDir,
12
+ memoryCollection, memoryLayout, memoryProjectProblem,
13
+ } from "../../domain/shared-memory/layout.ts";
14
+ import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
15
+
16
+ export const GIT_REMOTE_ORIGIN = "git remote get-url origin";
17
+ export const LOCAL_PROJECT = "local";
18
+
19
+ export interface MemorySettings {
20
+ /** memory.dir, relative to the project. */
21
+ dir: string;
22
+ layout: MemoryLayout;
23
+ project: string;
24
+ collection: string;
25
+ autoAdmitAudited: boolean;
26
+ /** What was set aside, one line each. */
27
+ warnings: string[];
28
+ }
29
+
30
+ async function stdoutOf(shell: Pick<Shell, "run">, command: string): Promise<string | null> {
31
+ try {
32
+ const result = await shell.run(command);
33
+ return result.exitCode === 0 ? result.stdout.trim() : null;
34
+ } catch {
35
+ return null;
36
+ }
37
+ }
38
+
39
+ async function valueOf(config: Pick<ConfigStore, "readValue">, key: string): Promise<string | undefined> {
40
+ try {
41
+ return (await config.readValue(key)).value;
42
+ } catch {
43
+ return undefined;
44
+ }
45
+ }
46
+
47
+ const validProject = (name: string | null): string | null =>
48
+ name !== null && memoryProjectProblem(name) === undefined ? name : null;
49
+
50
+ /** The project name when memory.project is unset: the origin remote's, else "local". Not the checkout's
51
+ * folder: in the container it is always /workspace. */
52
+ export async function defaultProject(shell: Pick<Shell, "run">): Promise<string> {
53
+ const remote = await stdoutOf(shell, GIT_REMOTE_ORIGIN);
54
+ return validProject(remote === null || remote === "" ? null : projectFromRemote(remote)) ?? LOCAL_PROJECT;
55
+ }
56
+
57
+ /** memory.dir as it applies, relative to the project, and the line saying a stored value was set aside. */
58
+ export async function readMemoryDir(config: Pick<ConfigStore, "readValue">): Promise<{ dir: string; warning?: string }> {
59
+ const raw = await valueOf(config, MEMORY_DIR_CONFIG_KEY);
60
+ if (raw === undefined) return { dir: DEFAULT_MEMORY_DIR };
61
+ const check = checkMemoryDir(raw);
62
+ return check.ok ? { dir: check.dir } : { dir: DEFAULT_MEMORY_DIR, warning: `${MEMORY_DIR_CONFIG_KEY} '${raw}' set aside (${check.reason}): ${DEFAULT_MEMORY_DIR} applies` };
63
+ }
64
+
65
+ /** memory.dir as the guards read it: the folder alone, the warning left to the commands that print it. */
66
+ export function memoryDirOf(config: Pick<ConfigStore, "readValue">): () => Promise<string> {
67
+ return async () => (await readMemoryDir(config)).dir;
68
+ }
69
+
70
+ /** The refused motifs' file of the shared memory, relative to the project: refused.md under memory.dir. */
71
+ export async function readRefusedFile(config: Pick<ConfigStore, "readValue">): Promise<string> {
72
+ return `${(await readMemoryDir(config)).dir}/refused.md`;
73
+ }
74
+
75
+ export async function readMemorySettings(
76
+ deps: { config: Pick<ConfigStore, "readValue">; shell: Pick<Shell, "run"> },
77
+ ): Promise<MemorySettings> {
78
+ const read = await readMemoryDir(deps.config);
79
+ const warnings: string[] = read.warning === undefined ? [] : [read.warning];
80
+ const dir = read.dir;
81
+ const rawProject = await valueOf(deps.config, MEMORY_PROJECT_CONFIG_KEY);
82
+ let project: string | null = null;
83
+ if (rawProject !== undefined) {
84
+ project = validProject(rawProject);
85
+ if (project === null) warnings.push(`${MEMORY_PROJECT_CONFIG_KEY} '${rawProject}' set aside (${memoryProjectProblem(rawProject)})`);
86
+ }
87
+ project ??= await defaultProject(deps.shell);
88
+ const auto = await valueOf(deps.config, MEMORY_AUTO_ADMIT_CONFIG_KEY);
89
+ return {
90
+ dir, layout: memoryLayout(dir), project, collection: memoryCollection(project),
91
+ autoAdmitAudited: auto === "true", warnings,
92
+ };
93
+ }