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,85 @@
1
+ // Session IO shared by commands and crews: the conversation buffer, the state
2
+ // bag and the token budget of the SessionStore port, plus the permission mode a
3
+ // session runs in, which reads the state bag and the layered /config.
4
+ //
5
+ // Built over ports (createSessionIo); the instance wired to the runtime is
6
+ // orkeonSessionIo() in shared/infrastructure/orkeon/. The dependency runs one
7
+ // way: this module reads the config store, the config store reads only the
8
+ // session's state bag (the port), never this module.
9
+
10
+ import type { SessionStore } from "./ports.ts";
11
+ import type { ConfigStore } from "./config-store.ts";
12
+ import { PERMISSION_FALLBACK_CONFIG_KEY, isPermissionMode, resolveFallbackMode } from "../domain/permission-modes.ts";
13
+ import type { FallbackResolution } from "../domain/permission-modes.ts";
14
+ import { DEFAULT_MODE_STATE_KEY } from "../domain/session-keys.ts";
15
+ import { SESSION_DEFAULT_VIA_MODE } from "./messages.ts";
16
+
17
+ export interface SessionIo extends SessionStore {
18
+ /** The session-default permission mode set by /mode, or null when unset/invalid
19
+ * (never throws — callers fall back to "default"). */
20
+ readDefaultPermissionMode(): Promise<string | null>;
21
+ /**
22
+ * Resolves the session fallback permission mode from the `permissions.fallback`
23
+ * config key.
24
+ *
25
+ * Reads the LAYERED value (settings file, overridden by the session bag) since
26
+ * B-6. Going through the layered read is not optional: a value persisted in the
27
+ * file and ignored here would be a setting that reports itself as effective and
28
+ * changes nothing — the failure mode B-6 exists to remove.
29
+ *
30
+ * Anything unreadable yields the built-in fallback: a config store that cannot be
31
+ * read must never be able to LOOSEN the policy. The decision itself is pure
32
+ * (`resolveFallbackMode`); this only fetches its input.
33
+ */
34
+ resolveSessionFallbackMode(): Promise<FallbackResolution>;
35
+ /**
36
+ * The mode a prompt runs in when it carries no explicit "mode:" prefix: the
37
+ * /mode session default if set, otherwise the resolved fallback.
38
+ */
39
+ resolveEffectiveSessionMode(): Promise<{ mode: string; via: string }>;
40
+ }
41
+
42
+ export function createSessionIo(deps: {
43
+ store: SessionStore;
44
+ config: Pick<ConfigStore, "readValue">;
45
+ }): SessionIo {
46
+ const { store, config } = deps;
47
+
48
+ async function readDefaultPermissionMode(): Promise<string | null> {
49
+ try {
50
+ const v = await store.readState(DEFAULT_MODE_STATE_KEY);
51
+ if (v != null && isPermissionMode(v)) return v;
52
+ } catch { /* session store optional */ }
53
+ return null;
54
+ }
55
+
56
+ async function resolveSessionFallbackMode(): Promise<FallbackResolution> {
57
+ let configured: unknown;
58
+ try {
59
+ configured = (await config.readValue(PERMISSION_FALLBACK_CONFIG_KEY)).value;
60
+ } catch { /* absent, malformed or unavailable → built-in */ }
61
+ return resolveFallbackMode(configured);
62
+ }
63
+
64
+ return {
65
+ readMessages: () => store.readMessages(),
66
+ writeMessages: (messages) => store.writeMessages(messages),
67
+ reset: () => store.reset(),
68
+ snip: (retain) => store.snip(retain),
69
+ setTitle: (title) => store.setTitle(title),
70
+ readState: (key) => store.readState(key),
71
+ readStates: (keys) => store.readStates(keys),
72
+ writeState: (key, value) => store.writeState(key, value),
73
+ readBudget: () => store.readBudget(),
74
+ // Throws when the session store cannot write; best-effort callers catch.
75
+ appendMessage: (role, content) => store.appendMessage(role, content),
76
+ readDefaultPermissionMode,
77
+ resolveSessionFallbackMode,
78
+ async resolveEffectiveSessionMode() {
79
+ const sessionDefault = await readDefaultPermissionMode();
80
+ if (sessionDefault) return { mode: sessionDefault, via: SESSION_DEFAULT_VIA_MODE };
81
+ const fallback = await resolveSessionFallbackMode();
82
+ return { mode: fallback.mode, via: fallback.explanation };
83
+ },
84
+ };
85
+ }
@@ -0,0 +1,36 @@
1
+ // JSON values of the session's state bag, over the SessionStore port. The bag
2
+ // holds strings, so a list or a map is stored as JSON; every reader of one goes
3
+ // through here so that they all agree on what an unusable value reads as.
4
+
5
+ import type { SessionStore } from "./ports.ts";
6
+
7
+ /** The parsed value of `key`; undefined when unset, malformed, or when the
8
+ * session store is unavailable (a host without the session tools). */
9
+ async function readJson(session: Pick<SessionStore, "readState">, key: string): Promise<unknown> {
10
+ try {
11
+ const raw = await session.readState(key);
12
+ return raw ? JSON.parse(raw) : undefined;
13
+ } catch {
14
+ return undefined;
15
+ }
16
+ }
17
+
18
+ /** A JSON-array state value; unset, malformed, not an array or unreadable → []. */
19
+ export async function readJsonArray(session: Pick<SessionStore, "readState">, key: string): Promise<unknown[]> {
20
+ const value = await readJson(session, key);
21
+ return Array.isArray(value) ? value : [];
22
+ }
23
+
24
+ /** A JSON-object state value; unset, malformed, not an object or unreadable → {}. */
25
+ export async function readJsonObject(
26
+ session: Pick<SessionStore, "readState">,
27
+ key: string,
28
+ ): Promise<Record<string, unknown>> {
29
+ const value = await readJson(session, key);
30
+ return value && typeof value === "object" && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
31
+ }
32
+
33
+ /** Persist a JSON state value. */
34
+ export async function writeJson(session: Pick<SessionStore, "writeState">, key: string, value: unknown): Promise<void> {
35
+ await session.writeState(key, JSON.stringify(value));
36
+ }
@@ -0,0 +1,179 @@
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
+ import { CANDIDATE_CHANGED, NOTHING_TO_APPLY, NO_CANDIDATE_FILE, candidateUnreadable, fileHoldsId, indexStale, notACandidateAnyMore, notMarkedSuperseded, refusedNotWritten, statusNotCandidate, stillReadsAsCandidate, supersedesNoAdmitted, topicWasRefused } from "./messages.ts";
20
+ import { prefixedCannotBeRead as refusedFileUnreadable } from "../messages.ts";
21
+
22
+ export const DEFAULT_REFUSAL_MOTIF = "refused by /memory-admit";
23
+
24
+ /** One confirmed admission: the candidate's id and the sha1 of the file text the operator was shown. */
25
+ export interface Confirmed { id: string; sha1: string }
26
+
27
+ export interface AdmitDecisions {
28
+ admit: Confirmed[];
29
+ refuse: Array<{ id: string; motif?: string }>;
30
+ }
31
+
32
+ /** The crew's input read: the `{id, sha1}` items of `admit` with a kebab-case id and a sha1, nothing else. */
33
+ export function admittedCandidates(input: unknown): Confirmed[] {
34
+ const admit = (input as { admit?: unknown } | null)?.admit;
35
+ if (!Array.isArray(admit)) return [];
36
+ const seen = new Set<string>();
37
+ return admit.flatMap((item): Confirmed[] => {
38
+ const { id, sha1 } = (item ?? {}) as { id?: unknown; sha1?: unknown };
39
+ if (typeof id !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(id) || typeof sha1 !== "string" || !/^[0-9a-f]{40}$/.test(sha1)) return [];
40
+ if (seen.has(id)) return [];
41
+ seen.add(id);
42
+ return [{ id, sha1 }];
43
+ });
44
+ }
45
+
46
+ export interface AdmitDeps {
47
+ files: Pick<Files, "read" | "write" | "list">;
48
+ memory: Pick<SharedMemory, "ingest">;
49
+ clock: () => Date;
50
+ }
51
+
52
+ export interface AdmitOutcome {
53
+ admitted: string[];
54
+ refused: string[];
55
+ /** One line per id not applied, with the reason. */
56
+ failed: string[];
57
+ /** What went wrong without undoing a decision: a superseded id not found, a list not refreshed, a stale index. */
58
+ warnings: string[];
59
+ }
60
+
61
+ const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
62
+
63
+ /** The pending candidate `id`, or why it cannot be decided. */
64
+ async function candidate(
65
+ files: Pick<Files, "read">, layout: MemoryLayout, id: string, sha1?: string,
66
+ ): Promise<MemoryEntry | string> {
67
+ let text: string | null;
68
+ try {
69
+ text = await readOrNull(files, candidatePath(layout, id));
70
+ } catch (error) {
71
+ return candidateUnreadable(firstLine(error));
72
+ }
73
+ if (text === null) return NO_CANDIDATE_FILE;
74
+ if (sha1 !== undefined && sha1Hex(text) !== sha1) return CANDIDATE_CHANGED;
75
+ const parsed = parseEntry(text);
76
+ if (!parsed.ok) return notACandidateAnyMore(parsed.problems[0] ?? "decided already");
77
+ if (parsed.entry.status !== "candidate") return statusNotCandidate(parsed.entry.status);
78
+ if (parsed.entry.id !== id) return fileHoldsId(parsed.entry.id);
79
+ return parsed.entry;
80
+ }
81
+
82
+ async function admitOne(
83
+ deps: AdmitDeps, layout: MemoryLayout, confirmed: Confirmed, today: string, outcome: AdmitOutcome,
84
+ ): Promise<boolean> {
85
+ const id = confirmed.id;
86
+ const found = await candidate(deps.files, layout, id, confirmed.sha1);
87
+ if (typeof found === "string") { outcome.failed.push(`${id}: ${found}`); return false; }
88
+ let refused: Set<string>;
89
+ try {
90
+ refused = await refusedTopics(deps.files, layout);
91
+ } catch (error) {
92
+ outcome.failed.push(refusedFileUnreadable(id, layout.refused, firstLine(error)));
93
+ return false;
94
+ }
95
+ if (refused.has(found.topic)) { outcome.failed.push(topicWasRefused(id, found.topic)); return false; }
96
+ const entry: MemoryEntry = { ...found, status: "admitted" };
97
+ const problems = [...entryProblems(entry), ...[admissionProblem(entry)].filter((p): p is string => p !== undefined)];
98
+ if (problems.length > 0) { outcome.failed.push(`${id}: not admitted, ${problems.join("; ")}`); return false; }
99
+ const target = entryPath(layout, entry.type, id);
100
+ try {
101
+ if ((await readOrNull(deps.files, target)) !== null) { outcome.failed.push(`${id}: ${target} exists already`); return false; }
102
+ await deps.files.write(target, serializeEntry(entry));
103
+ } catch (error) {
104
+ outcome.failed.push(`${id}: ${target} not written (${firstLine(error)})`);
105
+ return false;
106
+ }
107
+ outcome.admitted.push(id);
108
+ if (entry.supersedes.length > 0) {
109
+ const stored = await storedEntries(deps.files, layout);
110
+ for (const old of entry.supersedes) {
111
+ const hit = stored.find((s) => s.entry.id === old && s.entry.status === "admitted");
112
+ if (hit === undefined) { outcome.warnings.push(supersedesNoAdmitted(id, old)); continue; }
113
+ try {
114
+ await deps.files.write(hit.path, serializeEntry({ ...hit.entry, status: "superseded", supersededBy: id }));
115
+ } catch (error) {
116
+ outcome.warnings.push(notMarkedSuperseded(old, id, firstLine(error)));
117
+ }
118
+ }
119
+ }
120
+ await pointer(deps.files, layout, id, decidedPointer("admitted", today, target), outcome);
121
+ return true;
122
+ }
123
+
124
+ async function refuseOne(
125
+ deps: AdmitDeps, layout: MemoryLayout, decision: { id: string; motif?: string }, today: string, outcome: AdmitOutcome,
126
+ ): Promise<void> {
127
+ const found = await candidate(deps.files, layout, decision.id);
128
+ if (typeof found === "string") { outcome.failed.push(`${decision.id}: ${found}`); return; }
129
+ try {
130
+ const previous = await readOrNull(deps.files, layout.refused);
131
+ const motif = decision.motif?.trim() || DEFAULT_REFUSAL_MOTIF;
132
+ await deps.files.write(layout.refused, appendRefused(previous, { topic: found.topic, project: found.project, date: today, motif }));
133
+ } catch (error) {
134
+ outcome.failed.push(refusedNotWritten(decision.id, layout.refused, firstLine(error)));
135
+ return;
136
+ }
137
+ outcome.refused.push(decision.id);
138
+ await pointer(deps.files, layout, decision.id, decidedPointer("refused", today), outcome);
139
+ }
140
+
141
+ async function pointer(files: Pick<Files, "write">, layout: MemoryLayout, id: string, text: string, outcome: AdmitOutcome): Promise<void> {
142
+ try {
143
+ await files.write(candidatePath(layout, id), text);
144
+ } catch (error) {
145
+ outcome.warnings.push(stillReadsAsCandidate(candidatePath(layout, id), firstLine(error)));
146
+ }
147
+ }
148
+
149
+ export async function admitEntries(
150
+ deps: AdmitDeps, memory: { layout: MemoryLayout; collection: string }, decisions: AdmitDecisions,
151
+ ): Promise<AdmitOutcome> {
152
+ const outcome: AdmitOutcome = { admitted: [], refused: [], failed: [], warnings: [] };
153
+ const today = deps.clock().toISOString().slice(0, 10);
154
+ for (const decision of decisions.refuse) await refuseOne(deps, memory.layout, decision, today, outcome);
155
+ for (const confirmed of decisions.admit) await admitOne(deps, memory.layout, confirmed, today, outcome);
156
+ if (outcome.admitted.length + outcome.refused.length === 0) return outcome;
157
+ for (const line of [await refreshCandidatesList(deps.files, memory.layout), await refreshIndexFile(deps.files, memory.layout)]) {
158
+ if (line !== null) outcome.warnings.push(line);
159
+ }
160
+ if (outcome.admitted.length > 0) {
161
+ try {
162
+ const report = await deps.memory.ingest(memory.collection, [memory.layout.entriesGlob], { prune: true });
163
+ for (const error of report.errors) outcome.warnings.push(`index: ${error}`);
164
+ } catch (error) {
165
+ outcome.warnings.push(indexStale(memory.collection, firstLine(error)));
166
+ }
167
+ }
168
+ return outcome;
169
+ }
170
+
171
+ /** The outcome as the crew's answer: one line per decision, then the warnings. */
172
+ export function admitReport(outcome: AdmitOutcome): string {
173
+ return [
174
+ ...outcome.admitted.map((id) => `admitted ${id}`),
175
+ ...outcome.refused.map((id) => `refused ${id}`),
176
+ ...outcome.failed.map((line) => `not applied: ${line}`),
177
+ ...outcome.warnings.map((line) => `warning: ${line}`),
178
+ ].join("\n") || NOTHING_TO_APPLY;
179
+ }
@@ -0,0 +1,69 @@
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
+ import { UNTREATED_GAP, UNTREATED_GAPS, harvestFailed, harvestSkipped, learnNudgeLine, mistakesHarvested } from "./messages.ts";
21
+
22
+ export interface AfterGapsDeps {
23
+ files: Pick<Files, "read" | "write" | "list">;
24
+ shell: Pick<Shell, "run">;
25
+ config: Pick<ConfigStore, "readValue">;
26
+ clock: () => Date;
27
+ log: Pick<Logger, "warn">;
28
+ }
29
+
30
+ const firstLine = (e: unknown): string => String((e as Error)?.message ?? e).split("\n")[0];
31
+ const plural = (n: number, one: string, many: string): string => `${n} ${n === 1 ? one : many}`;
32
+
33
+ /** The rows /dev-learn has not treated, by either learning state (an unreadable state treats nothing). */
34
+ async function untreatedRows(files: Pick<Files, "read">, rows: readonly LearnRow[]): Promise<LearnRow[]> {
35
+ const own = parseLearnState(await readOrNull(files, `${WORKSPACE}/${LEARN_STATE_FILE}`).catch(() => null));
36
+ const harness = parseHarnessLearnState(await readOrNull(files, `${WORKSPACE}/${HARNESS_LEARN_STATE_FILE}`).catch(() => null));
37
+ return untreated(rows, new Set([...(own.ok ? own.state.treated : []), ...harness.treated]));
38
+ }
39
+
40
+ /** The nudge line, "" below NUDGE_BATCHES distinct batches. */
41
+ export function learnNudge(rows: readonly LearnRow[]): string {
42
+ const batches = new Set(rows.map((r) => r.batch)).size;
43
+ if (batches < NUDGE_BATCHES) return "";
44
+ return learnNudgeLine(plural(rows.length, UNTREATED_GAP, UNTREATED_GAPS), batches);
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(harvestSkipped(s));
59
+ if (harvest.written.length > 0) {
60
+ lines.push(mistakesHarvested(plural(harvest.written.length, "mistake candidate", "mistake candidates"), harvest.written.join(", ")));
61
+ }
62
+ const nudge = learnNudge(await untreatedRows(deps.files, rows));
63
+ if (nudge !== "") lines.push(nudge);
64
+ return lines;
65
+ } catch (error) {
66
+ deps.log.warn(harvestFailed(firstLine(error)));
67
+ return [];
68
+ }
69
+ }
@@ -0,0 +1,45 @@
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
+ import { mistakeAlreadyHeld, refusedUnreadableNothingHarvested } from "./messages.ts";
12
+
13
+ export interface HarvestOutcome {
14
+ written: string[];
15
+ /** One line per topic left out, with the reason. */
16
+ skipped: string[];
17
+ }
18
+
19
+ export async function harvestMistakes(
20
+ deps: PushDeps, memory: { layout: MemoryLayout; project: string }, rows: readonly LearnRow[],
21
+ ): Promise<HarvestOutcome> {
22
+ const outcome: HarvestOutcome = { written: [], skipped: [] };
23
+ let refused: Set<string>;
24
+ try {
25
+ refused = await refusedTopics(deps.files, memory.layout);
26
+ } catch (error) {
27
+ outcome.skipped.push(refusedUnreadableNothingHarvested(String((error as Error)?.message ?? error).split("\n")[0]));
28
+ return outcome;
29
+ }
30
+ const date = deps.clock().toISOString().slice(0, 10);
31
+ const plan = mistakeCandidates(rows, { project: memory.project, date, refusedTopics: refused });
32
+ for (const topic of plan.refused) outcome.skipped.push(`${topic}: refused (refused.md)`);
33
+ const held = new Set([...await pendingCandidates(deps.files, memory.layout), ...await storedEntries(deps.files, memory.layout)]
34
+ .filter((s) => s.entry.type === "mistake").map((s) => s.entry.topic));
35
+ for (const candidate of plan.candidates) {
36
+ if (held.has(candidate.topic)) {
37
+ outcome.skipped.push(mistakeAlreadyHeld(candidate.topic));
38
+ continue;
39
+ }
40
+ const pushed = await writeCandidate(deps, memory, candidate);
41
+ if (pushed.ok) outcome.written.push(pushed.path);
42
+ else outcome.skipped.push(`${candidate.topic}: ${pushed.refused}`);
43
+ }
44
+ return outcome;
45
+ }
@@ -0,0 +1,119 @@
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
+ import { DECIDE_WITH_MEMORY_ADMIT, NO_CANDIDATE_WRITTEN, duplicatesSkipped, itemLooksLikeSecret, noAgentMemory, noteUnreadable } from "./messages.ts";
19
+ import { cannotBeRead } from "../messages.ts";
20
+
21
+ export const HARNESS_AGENT_MEMORY_ROOT = `${WORKSPACE}/${HARNESS_AGENT_MEMORY_DIR}`;
22
+
23
+ export interface ImportOutcome {
24
+ /** The agents whose MEMORY.md was read, with their entry count. */
25
+ agents: Array<{ agent: string; entries: number }>;
26
+ written: Array<{ id: string; path: string }>;
27
+ duplicates: Array<{ agent: string; line: number; topic: string }>;
28
+ refused: Array<{ agent: string; line: number; reason: string }>;
29
+ warnings: string[];
30
+ }
31
+
32
+ export interface ImportDeps {
33
+ files: Pick<Files, "read" | "write" | "list">;
34
+ clock: () => Date;
35
+ }
36
+
37
+ const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
38
+
39
+ /** Reads every agent's MEMORY.md under `root` and writes a candidate per entry not already held. */
40
+ export async function importAgentMemory(
41
+ deps: ImportDeps, memory: { layout: MemoryLayout; project: string }, root: string = HARNESS_AGENT_MEMORY_ROOT,
42
+ ): Promise<ImportOutcome> {
43
+ const outcome: ImportOutcome = { agents: [], written: [], duplicates: [], refused: [], warnings: [] };
44
+ let agents: string[];
45
+ try {
46
+ agents = (await deps.files.list(root, MAX_LISTED)).map((n) => n.replace(/\/+$/, "").split("/").pop() ?? n)
47
+ .filter((n) => n !== "" && !n.startsWith(".") && n !== AGENT_MEMORY_INDEX).sort();
48
+ } catch {
49
+ return outcome;
50
+ }
51
+ const held = new Set<string>();
52
+ for (const stored of [...await pendingCandidates(deps.files, memory.layout), ...await storedEntries(deps.files, memory.layout)]) {
53
+ // Its topic, and the one its title gives (a pushed candidate names its own topic).
54
+ held.add(stored.entry.topic).add(topicOf(stored.entry.title));
55
+ }
56
+ const date = deps.clock().toISOString().slice(0, 10);
57
+ for (const agent of [...new Set(agents)]) {
58
+ const folder = `${root}/${agent}`;
59
+ let index: string | null;
60
+ try {
61
+ index = await readOrNull(deps.files, `${folder}/${AGENT_MEMORY_INDEX}`);
62
+ } catch (error) {
63
+ outcome.warnings.push(cannotBeRead(`${folder}/${AGENT_MEMORY_INDEX}`, firstLine(error)));
64
+ continue;
65
+ }
66
+ if (index === null) continue;
67
+ const items = parseAgentMemoryIndex(index);
68
+ outcome.agents.push({ agent, entries: items.length });
69
+ for (const item of items) {
70
+ let note: AgentNote | null = null;
71
+ let uncut = `${item.title}\n${item.hook}`;
72
+ if (item.note !== undefined) {
73
+ try {
74
+ const text = await readOrNull(deps.files, `${folder}/${item.note}`);
75
+ note = text === null ? null : parseAgentNote(text.slice(0, MAX_NOTE_CHARS));
76
+ if (text !== null) uncut += `\n${text}`;
77
+ } catch (error) {
78
+ outcome.warnings.push(noteUnreadable(`${folder}/${item.note}`, firstLine(error)));
79
+ }
80
+ }
81
+ // The entry cuts the note and the line: a secret cut at the boundary would slip past entryProblems,
82
+ // so the uncut text is scanned first.
83
+ const secrets = secretPatternsIn(uncut);
84
+ if (secrets.length > 0) {
85
+ outcome.refused.push({ agent, line: item.line, reason: itemLooksLikeSecret(secrets.join(", ")) });
86
+ continue;
87
+ }
88
+ const entry = importedEntry(item, note, { agent, project: memory.project, date });
89
+ if (held.has(entry.topic)) {
90
+ outcome.duplicates.push({ agent, line: item.line, topic: entry.topic });
91
+ continue;
92
+ }
93
+ const written = await writeCandidate(deps, memory, entry);
94
+ if (!written.ok) {
95
+ outcome.refused.push({ agent, line: item.line, reason: written.refused });
96
+ continue;
97
+ }
98
+ held.add(entry.topic);
99
+ outcome.written.push({ id: written.id, path: written.path });
100
+ for (const warning of written.warnings) if (!outcome.warnings.includes(warning)) outcome.warnings.push(warning);
101
+ }
102
+ }
103
+ return outcome;
104
+ }
105
+
106
+ /** The lines the operator reads after an import. */
107
+ export function importReport(outcome: ImportOutcome, root: string = HARNESS_AGENT_MEMORY_ROOT): string {
108
+ if (outcome.agents.length === 0) return noAgentMemory(root, AGENT_MEMORY_INDEX);
109
+ const lines = outcome.agents.map((a) => `${root}/${a.agent}/${AGENT_MEMORY_INDEX}: ${a.entries} entr${a.entries === 1 ? "y" : "ies"}`);
110
+ lines.push(outcome.written.length === 0 ? NO_CANDIDATE_WRITTEN
111
+ : `${outcome.written.length} candidate(s) written: ${outcome.written.map((w) => w.id).join(", ")}`);
112
+ if (outcome.duplicates.length > 0) {
113
+ lines.push(duplicatesSkipped(outcome.duplicates.length, outcome.duplicates.map((d) => `${d.agent}:${d.line} ${d.topic}`).join(", ")));
114
+ }
115
+ for (const r of outcome.refused) lines.push(`✗ ${r.agent}/${AGENT_MEMORY_INDEX}:${r.line}: ${r.reason}`);
116
+ for (const w of outcome.warnings) lines.push(`warning: ${w}`);
117
+ if (outcome.written.length > 0) lines.push(DECIDE_WITH_MEMORY_ADMIT);
118
+ return lines.join("\n");
119
+ }
@@ -0,0 +1,111 @@
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
+ import { notRefreshed } from "./messages.ts";
14
+
15
+ /** How many files of one folder are read at most. */
16
+ export const MAX_LISTED = 1_000;
17
+
18
+ export interface StoredEntry {
19
+ entry: MemoryEntry;
20
+ path: string;
21
+ /** The file's text as read: its sha1 is what an admission confirms. */
22
+ text: string;
23
+ }
24
+
25
+ /** The file's text, or null when it does not exist; an unreadable file throws. */
26
+ export async function readOrNull(files: Pick<Files, "read">, path: string): Promise<string | null> {
27
+ try {
28
+ return await files.read(path);
29
+ } catch (error) {
30
+ if (/not found|does not exist|no such file|could not find/i.test(String((error as Error)?.message ?? error))) return null;
31
+ throw error;
32
+ }
33
+ }
34
+
35
+ async function namesIn(files: Pick<Files, "list">, folder: string): Promise<string[]> {
36
+ try {
37
+ return (await files.list(folder, MAX_LISTED)).map((name) => name.split("/").pop() ?? name).filter((n) => n.endsWith(".md"));
38
+ } catch {
39
+ return [];
40
+ }
41
+ }
42
+
43
+ /** The entries of `folder` whose file parses, with `status` among `statuses`. */
44
+ async function entriesIn(files: Pick<Files, "list" | "read">, folder: string, statuses: readonly string[]): Promise<StoredEntry[]> {
45
+ const found: StoredEntry[] = [];
46
+ for (const name of (await namesIn(files, folder)).sort()) {
47
+ const path = `${folder}/${name}`;
48
+ let text: string | null;
49
+ try {
50
+ text = await readOrNull(files, path);
51
+ } catch {
52
+ continue;
53
+ }
54
+ const parsed = text === null ? null : parseEntry(text);
55
+ if (text !== null && parsed?.ok && statuses.includes(parsed.entry.status)) found.push({ entry: parsed.entry, path, text });
56
+ }
57
+ return found;
58
+ }
59
+
60
+ /** The pending candidates: the files of candidates/ that parse as an entry of status candidate. */
61
+ export async function pendingCandidates(files: Pick<Files, "list" | "read">, layout: MemoryLayout): Promise<StoredEntry[]> {
62
+ return entriesIn(files, layout.candidates, ["candidate"]);
63
+ }
64
+
65
+ /** Every entry of entries/<type>/, admitted or superseded. */
66
+ export async function storedEntries(files: Pick<Files, "list" | "read">, layout: MemoryLayout): Promise<StoredEntry[]> {
67
+ const all: StoredEntry[] = [];
68
+ for (const type of ENTRY_TYPES) all.push(...await entriesIn(files, `${layout.entries}/${type}`, ["admitted", "superseded"]));
69
+ return all;
70
+ }
71
+
72
+ /** The refused topics; none when refused.md does not exist. Throws when it cannot be read. */
73
+ export async function refusedTopics(files: Pick<Files, "read">, layout: MemoryLayout): Promise<Set<string>> {
74
+ const text = await readOrNull(files, layout.refused);
75
+ return new Set(text === null ? [] : parseRefused(text).motifs.map((m) => m.topic));
76
+ }
77
+
78
+ /** Writes the candidate's file; its path. */
79
+ export async function writeCandidateFile(files: Pick<Files, "write">, layout: MemoryLayout, entry: MemoryEntry): Promise<string> {
80
+ const path = candidatePath(layout, entry.id);
81
+ await files.write(path, serializeEntry({ ...entry, status: "candidate" }));
82
+ return path;
83
+ }
84
+
85
+ /** Writes a generated list, unless the file exists and is not one (memory.dir pointed at a folder of the project). */
86
+ async function writeGenerated(files: Pick<Files, "read" | "write">, path: string, title: string, text: string): Promise<string | null> {
87
+ const previous = await readOrNull(files, path);
88
+ if (previous !== null && previous.trim() !== "" && !previous.startsWith(title)) {
89
+ return notRefreshed(path, title);
90
+ }
91
+ await files.write(path, text);
92
+ return null;
93
+ }
94
+
95
+ /** Rewrites CANDIDATES.md from the pending candidates; a failure is a line, never a throw. */
96
+ export async function refreshCandidatesList(files: Pick<Files, "list" | "read" | "write">, layout: MemoryLayout): Promise<string | null> {
97
+ try {
98
+ return await writeGenerated(files, layout.candidatesList, CANDIDATES_TITLE, candidatesList((await pendingCandidates(files, layout)).map((c) => c.entry)));
99
+ } catch (error) {
100
+ return `${layout.candidatesList} not refreshed (${String((error as Error)?.message ?? error).split("\n")[0]})`;
101
+ }
102
+ }
103
+
104
+ /** Rewrites INDEX.md from the entries; a failure is a line, never a throw. */
105
+ export async function refreshIndexFile(files: Pick<Files, "list" | "read" | "write">, layout: MemoryLayout): Promise<string | null> {
106
+ try {
107
+ return await writeGenerated(files, layout.index, INDEX_TITLE, entriesIndex((await storedEntries(files, layout)).map((e) => e.entry)));
108
+ } catch (error) {
109
+ return `${layout.index} not refreshed (${String((error as Error)?.message ?? error).split("\n")[0]})`;
110
+ }
111
+ }