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,342 @@
1
+ // What a dev crew's onToolCall checks before the host's gate judges a call, and the /hooks declarations it runs
2
+ // around the call — pure, no IO. The host gate runs next, on the input it returns, and keeps the session's rules; this guard can only
3
+ // refuse: the step's rule sets again (the only check of them under `orkeon run`, which keeps no session rules), the
4
+ // role's roots and its rewrite rule, the whole input of the folder readers, each operation of an edit_batch as the
5
+ // editor it stands for, and the act's mode when the host has no gate. The callbacks
6
+ // themselves, and the hooks' shell commands, are shared/application/dev/tool-callbacks.ts's.
7
+ import { ACT_TOOLS, READ_TOOLS, formatRule, matchesRule, sameToolName, shellCommandForms } from "../agent-policy/permission.ts";
8
+ import type { PermissionRule } from "../agent-policy/permission.ts";
9
+ import { declaredAccess } from "../agent-policy/tool-access.ts";
10
+ import {
11
+ GIT_CONFIG_SET_RULE, OPERATION_TOOLS, OPERATIONS_TOOL, PATH_WRITE_TOOLS, RULE_SETS, UNSCOPED_WRITE_TOOLS, gitConfigSets,
12
+ } from "../agent-policy/rule-sets.ts";
13
+ import type { RuleSetId } from "../agent-policy/rule-sets.ts";
14
+ import { STEP_RULE_SETS, roleRules, stepCommand } from "./step-rules.ts";
15
+ import type { DevRole, DevStep, LayoutRootKey } from "./step-rules.ts";
16
+ import type { RepoPackLayout } from "./repo-pack.ts";
17
+ import { matchesAny, relativePath } from "./test-paths.ts";
18
+ import { EDIT_BATCH_SHAPE } from "./reading-rule.ts";
19
+ import { WORKSPACE } from "../vfs.ts";
20
+ import {
21
+ editBatchRefused, NO_LIST_OF_OPERATIONS, notRunInMode, operationNamesNoPath, operationUnknownKind, packGivesNo,
22
+ refusedByRule, rewriteRuleOrigin, rootsOrigin, ruleSetOrigin, validateNotRun, whichPathCanReach, whichPathReaches,
23
+ } from "./messages.ts";
24
+ import {
25
+ CHANGE_EXISTING_SOURCE_BY_NODE, opensNoSourceOrTest, refusedDuringStep, USE_READ_TOOLS, USE_READ_TOOLS_AND_EDITORS,
26
+ USE_VALIDATE_PARSE, writesOutsideRootsOnly,
27
+ } from "./prompts.ts";
28
+
29
+ /** One /hooks declaration the callbacks run; `n` is its number in /hooks list. */
30
+ export interface ToolHook { n: number; event: "pre-tool" | "post-tool"; command: string }
31
+
32
+ /** What a crew builds its guard from: its step, and for a role of a batch the role and the pack's roots. */
33
+ export interface CallGuardSpec {
34
+ step: DevStep;
35
+ role?: DevRole;
36
+ layout?: Pick<RepoPackLayout, LayoutRootKey | "testFiles">;
37
+ /** Exact paths the test author's own root denies leave writable (the signature stubs a RED step names): no
38
+ * pattern, no other role, never a rule set's deny, never the host's gate: nothing widens. */
39
+ writable?: readonly string[];
40
+ /** The crew's `hooks` input: the /hooks registry as the command read it. */
41
+ hooks?: unknown;
42
+ /** Tools beyond READ_TOOLS that only read (a crew's autonomous tools declared `read`): let through by every
43
+ * mode when the host has no gate. */
44
+ readTools?: readonly string[];
45
+ }
46
+
47
+ /** A deny rule of the guard and where it comes from: a step's set, a role's roots, or a writing role's rewrite rule
48
+ * (no whole write of an existing source file, step-rules.ts roleRules). */
49
+ export interface GuardRule {
50
+ rule: PermissionRule;
51
+ origin: { kind: "set"; id: RuleSetId } | { kind: "role"; role: DevRole; access: "read" | "write" } | { kind: "rewrite"; role: DevRole };
52
+ }
53
+
54
+ export interface CallGuard {
55
+ step: DevStep;
56
+ role?: DevRole;
57
+ rules: GuardRule[];
58
+ /** Why a root of the role got no rule, and the pack keys it lacks. */
59
+ problems: string[];
60
+ hooks: ToolHook[];
61
+ readTools: readonly string[];
62
+ /** What the role's write denies leave open: the pack's test file patterns, for the test author only. */
63
+ writable: readonly string[];
64
+ /** The exact paths the test author's write denies leave open: its stubs, compared as paths, never as patterns. */
65
+ stubs: readonly string[];
66
+ }
67
+
68
+ export type CallVerdict = { allow: true } | { allow: false; reason: string; context: string };
69
+
70
+ const ALLOW: CallVerdict = { allow: true };
71
+
72
+ export function buildCallGuard(spec: CallGuardSpec): CallGuard {
73
+ const rules: GuardRule[] = [];
74
+ for (const id of STEP_RULE_SETS[spec.step]) {
75
+ for (const rule of RULE_SETS[id].rules) {
76
+ if (rule.effect === "deny") rules.push({ rule, origin: { kind: "set", id } });
77
+ }
78
+ }
79
+ const problems: string[] = [];
80
+ const writable: string[] = [];
81
+ const stubs: string[] = [];
82
+ if (spec.role !== undefined) {
83
+ const role = spec.role;
84
+ const access = role === "pilot" ? "read" : "write";
85
+ const own = roleRules(role, spec.layout ?? {});
86
+ for (const rule of own.rules) rules.push({ rule, origin: { kind: "role", role, access } });
87
+ for (const rule of own.rewrite) rules.push({ rule, origin: { kind: "rewrite", role } });
88
+ problems.push(...own.problems, ...own.missing.map(packGivesNo));
89
+ if (access === "write") writable.push(...own.writable);
90
+ if (role === "test-author") stubs.push(...(spec.writable ?? []).map(relativePath).filter((p) => p !== ""));
91
+ }
92
+ return {
93
+ step: spec.step, role: spec.role, rules, problems, hooks: toolHooks(spec.hooks), readTools: spec.readTools ?? [], writable, stubs,
94
+ };
95
+ }
96
+
97
+ /** The pre-tool and post-tool declarations of a raw registry, numbered by their place in it; a malformed entry,
98
+ * another event or an empty command is skipped (it keeps its number). */
99
+ export function toolHooks(raw: unknown): ToolHook[] {
100
+ if (!Array.isArray(raw)) return [];
101
+ const out: ToolHook[] = [];
102
+ raw.forEach((entry, i) => {
103
+ const event = (entry as { event?: unknown } | null)?.event;
104
+ const command = (entry as { command?: unknown } | null)?.command;
105
+ if ((event === "pre-tool" || event === "post-tool") && typeof command === "string" && command.trim() !== "") {
106
+ out.push({ n: i + 1, event, command: command.trim() });
107
+ }
108
+ });
109
+ return out;
110
+ }
111
+
112
+ /** The operators the host's shell tool refuses in a command (ShellCommandTool's forbidden list): a hook is one
113
+ * program and its arguments. */
114
+ export const SHELL_OPERATORS: readonly string[] = [";", "&&", "||", "|", "$(", "`", "\n", "\r", "&", "<", ">>", ">"];
115
+
116
+ /** The first operator of `command` the shell tool would refuse, or undefined. */
117
+ export function shellOperatorIn(command: string): string | undefined {
118
+ return SHELL_OPERATORS.find((op) => command.includes(op));
119
+ }
120
+
121
+ /** A path the hook may receive as one word: letters, digits and `._/@+=,:-`. */
122
+ const PLAIN = /^[A-Za-z0-9._/@+=,:-]+$/;
123
+
124
+ /** The hook's command with `{tool}`, `{event}` and `{path}` replaced: `{path}` is the input's `path` when it is
125
+ * plain and does not start with `-` (never read as an option by the hook), else `-`. */
126
+ export function hookCommand(hook: ToolHook, tool: string, input: unknown): string {
127
+ const raw = (input as { path?: unknown } | null)?.path;
128
+ const path = typeof raw === "string" && PLAIN.test(raw) && !raw.startsWith("-") ? raw : "-";
129
+ const name = PLAIN.test(tool) ? tool : "-";
130
+ return hook.command.replaceAll("{tool}", name).replaceAll("{event}", hook.event).replaceAll("{path}", path);
131
+ }
132
+
133
+ /** The tools `acceptEdits` runs without asking beside the reads: the file editors, rag_ingest, rag_eval (an edit
134
+ * since Orkeon #223) and spawn_agent. A `github` write (`create_pr`, `create_issue`) and an `http_api` write
135
+ * (`POST`…) declare an execute (Orkeon #219): the host asks them there too. */
136
+ const ACCEPT_EDITS_TOOLS: readonly string[] = [...PATH_WRITE_TOOLS, OPERATIONS_TOOL, ...UNSCOPED_WRITE_TOOLS, "rag_ingest", "rag_eval", ...ACT_TOOLS];
137
+
138
+ /** What the act's mode lets through when the host has no gate, by the gate's own reading of the classes. A call
139
+ * that declares a read per call (a `github` read action, an `http_api` GET without a body nor a method-override
140
+ * header: agent-policy/tool-access.ts, Orkeon #219 and #223) runs in `default` and `acceptEdits` as the gate would
141
+ * run it; `rag_eval` declares an edit, asked about in `default`. `plan` and `dontAsk` stay stricter,
142
+ * the local reads alone: their catalogue withholds `github` and `http_api` whatever the call, since an outbound
143
+ * request is observable elsewhere (mode-policy.ts), and a fallback must not widen what the catalogue promised. */
144
+ function modeVerdict(guard: CallGuard, tool: string, input: unknown, mode: string): CallVerdict {
145
+ if (mode === "bypassPermissions") return ALLOW;
146
+ const reads = [...READ_TOOLS, ...guard.readTools];
147
+ const allowed = mode === "acceptEdits" ? [...reads, ...ACCEPT_EDITS_TOOLS] : reads;
148
+ if (allowed.includes(tool)) return ALLOW;
149
+ if ((mode === "default" || mode === "acceptEdits") && declaredAccess(tool, input) === "read") return ALLOW;
150
+ const known = ["default", "acceptEdits", "plan", "dontAsk"].includes(mode) ? mode : "default";
151
+ return {
152
+ allow: false,
153
+ reason: notRunInMode(guard.step, tool, known),
154
+ context: known === "acceptEdits" ? USE_READ_TOOLS_AND_EDITORS : USE_READ_TOOLS,
155
+ };
156
+ }
157
+
158
+ function plainText(value: unknown): string | undefined {
159
+ return typeof value === "string" && value !== "" ? value : undefined;
160
+ }
161
+
162
+ /** A path with its `//` collapsed and its `.` and `..` segments resolved by their text: `/workspace/./src//x`
163
+ * and `/workspace/tests/../src/x` read `/workspace/src/x`, `./src/x` reads `src/x`. A `..` that climbs above the
164
+ * path's start is kept. */
165
+ export function normalisePath(path: string): string {
166
+ const absolute = path.startsWith("/");
167
+ const out: string[] = [];
168
+ for (const part of path.split("/")) {
169
+ if (part === "" || part === ".") continue;
170
+ if (part === ".." && out.length > 0 && out[out.length - 1] !== "..") out.pop();
171
+ else if (part === ".." && absolute) continue;
172
+ else out.push(part);
173
+ }
174
+ const text = out.join("/");
175
+ return absolute ? `/${text}` : text === "" ? "." : text;
176
+ }
177
+
178
+ /** The forms a path is matched in: as written, normalised, and for a relative path the absolute one the host
179
+ * resolves it to under the project, where a leading `..` cannot climb above the root
180
+ * (`../workspace/tests/a.test.ts` reads `/workspace/tests/a.test.ts`). Each form once. */
181
+ function pathForms(path: string): string[] {
182
+ const forms = [path, normalisePath(path)];
183
+ if (!path.startsWith("/")) forms.push(normalisePath(`${WORKSPACE}/${path}`));
184
+ return [...new Set(forms)];
185
+ }
186
+
187
+ function joinPath(base: string | undefined, tail: string): string {
188
+ if (base === undefined) return tail;
189
+ const head = base.endsWith("/") ? base.slice(0, -1) : base;
190
+ return tail.startsWith("/") ? tail : `${head}/${tail}`;
191
+ }
192
+
193
+ /** The paths a folder reader reaches beyond its `path`: glob's pattern under it, grep's glob under it (or the
194
+ * whole folder), count_pattern's and directory_search's whole folder. */
195
+ export function reachedPaths(tool: string, input: Readonly<Record<string, unknown>>): string[] {
196
+ const base = plainText(input.path);
197
+ if (tool === "glob") {
198
+ const pattern = plainText(input.pattern);
199
+ return pattern === undefined ? [] : [joinPath(base, pattern)];
200
+ }
201
+ if (tool === "grep") return [joinPath(base, plainText(input.glob) ?? "**")];
202
+ if (tool === "count_pattern" || tool === "directory_search") return [joinPath(base, "**")];
203
+ return [];
204
+ }
205
+
206
+ /** The text of `path` up to its first wildcard of a glob (`*`, `?`, `[`, `{`). */
207
+ function literalHead(path: string): string {
208
+ const at = path.search(/[*?[{]/);
209
+ return at < 0 ? path : path.slice(0, at);
210
+ }
211
+
212
+ /** Whether a joined path with a wildcard whose literal head starts the rule's folder can reach below it
213
+ * (`/workspace/**` and `/workspace/s*` reach `/workspace/src/*`). The rule's pattern is `<root>/*`. */
214
+ function reachesBelow(rule: PermissionRule, joined: string): boolean {
215
+ const pattern = rule.pattern ?? "";
216
+ if (!pattern.endsWith("/*") || pattern.slice(0, -2).includes("*")) return false;
217
+ const folder = pattern.slice(0, -1);
218
+ const head = literalHead(joined);
219
+ return head !== joined && folder.startsWith(head);
220
+ }
221
+
222
+ function originText(origin: GuardRule["origin"]): string {
223
+ if (origin.kind === "set") return ruleSetOrigin(origin.id);
224
+ return origin.kind === "rewrite" ? rewriteRuleOrigin(origin.role) : rootsOrigin(origin.role);
225
+ }
226
+
227
+ function contextOf(guard: CallGuard, origin: GuardRule["origin"]): string {
228
+ if (origin.kind === "set") return refusedDuringStep(RULE_SETS[origin.id].title, stepCommand(guard.step));
229
+ if (origin.kind === "rewrite") return CHANGE_EXISTING_SOURCE_BY_NODE;
230
+ return origin.access === "read"
231
+ ? opensNoSourceOrTest(origin.role)
232
+ : writesOutsideRootsOnly(origin.role, origin.role === "implementer");
233
+ }
234
+
235
+ function ruleVerdict(guard: CallGuard, entry: GuardRule, how: string): CallVerdict {
236
+ return {
237
+ allow: false,
238
+ reason: refusedByRule(guard.step, formatRule(entry.rule), originText(entry.origin), how),
239
+ context: contextOf(guard, entry.origin),
240
+ };
241
+ }
242
+
243
+ /**
244
+ * One call, before the host's gate judges it: refused when the host has no gate and the act's mode does not let
245
+ * it through, when a deny rule of the guard covers its input, or when it reaches below a covered folder through
246
+ * a pattern of a folder reader; otherwise allowed. Allow rules are never read: the guard cannot widen the gate.
247
+ * The hooks are not run here (the callbacks run them after an allow).
248
+ */
249
+ export function checkToolCall(
250
+ guard: CallGuard, tool: string, input: unknown, act: ActFacts,
251
+ ): CallVerdict {
252
+ if (act.gateEnabled === false) {
253
+ const verdict = modeVerdict(guard, tool, input, act.mode);
254
+ if (!verdict.allow) return verdict;
255
+ }
256
+ const args = input !== null && typeof input === "object" && !Array.isArray(input)
257
+ ? input as Readonly<Record<string, unknown>>
258
+ : {};
259
+ const given = typeof args.path === "string" ? pathForms(args.path) : [undefined];
260
+ for (const path of given) {
261
+ const asked = path === undefined || path === args.path ? args : { ...args, path };
262
+ for (const entry of guard.rules) {
263
+ if (leftWritable(guard, entry, path) || (entry.origin.kind === "rewrite" && act.newFile === true)) continue;
264
+ if (matchesRule(entry.rule, tool, asked)) return ruleVerdict(guard, entry, path === args.path ? "" : `, which '${path}' is`);
265
+ }
266
+ }
267
+ // The command as the program receives it: a pattern on the raw text misses `git "push"` or `python3 -Ic`.
268
+ const command = sameToolName(tool, "shell_command") && typeof args.command === "string" ? args.command : undefined;
269
+ for (const form of command === undefined ? [] : shellCommandForms(command).slice(1)) {
270
+ for (const entry of guard.rules) {
271
+ if (matchesRule(entry.rule, tool, { ...args, command: form })) return ruleVerdict(guard, entry, `, which '${form}' runs`);
272
+ }
273
+ }
274
+ // A git config that sets a value, which no glob of git-readonly can tell from a read (rule-sets gitConfigSets).
275
+ if (command !== undefined && gitConfigSets(command)) {
276
+ const held = guard.rules.find((e) => e.origin.kind === "set" && e.origin.id === "git-readonly");
277
+ if (held !== undefined) return ruleVerdict(guard, { rule: GIT_CONFIG_SET_RULE, origin: held.origin }, "");
278
+ }
279
+ const reached = reachedPaths(tool, args).flatMap(pathForms);
280
+ for (const joined of reached) {
281
+ for (const entry of guard.rules) {
282
+ if (entry.rule.argument !== "path" || leftWritable(guard, entry, joined)) continue;
283
+ if (matchesRule(entry.rule, tool, { ...args, path: joined })) {
284
+ return ruleVerdict(guard, entry, whichPathReaches(joined));
285
+ }
286
+ if (entry.origin.kind === "role" && entry.origin.access === "read" && sameToolName(entry.rule.tool, tool)
287
+ && reachesBelow(entry.rule, joined)) {
288
+ return ruleVerdict(guard, entry, whichPathCanReach(joined));
289
+ }
290
+ }
291
+ }
292
+ return sameToolName(tool, OPERATIONS_TOOL) ? checkOperations(guard, args, act) : ALLOW;
293
+ }
294
+
295
+ /** What the act's callbacks tell the guard of one call: the act's mode, the host's gate, and for a file_write
296
+ * whether its path names no file yet (read by the callbacks; undefined when not known, and the rewrite rule holds). */
297
+ export interface ActFacts { mode: string; gateEnabled: boolean | undefined; newFile?: boolean }
298
+
299
+ const BATCH_SHAPE = `Give ${EDIT_BATCH_SHAPE}.`;
300
+
301
+ function batchRefusal(guard: CallGuard, why: string, context = BATCH_SHAPE): CallVerdict {
302
+ return { allow: false, reason: editBatchRefused(guard.step, why), context };
303
+ }
304
+
305
+ /** An edit_batch, operation by operation: each is checked as the editor its `kind` stands for (OPERATION_TOOLS), with
306
+ * its own path and text, so every rule of the guard holds on it; the first refusal refuses the whole batch. A batch
307
+ * whose operations cannot be read is refused, and so is `validate: "build"`, the tool's own build rather than the
308
+ * pack's (run_build). An operation never creates a file: the rewrite rule's lift does not apply. */
309
+ function checkOperations(guard: CallGuard, args: Readonly<Record<string, unknown>>, act: ActFacts): CallVerdict {
310
+ const validate = args.validate;
311
+ if (validate !== undefined && validate !== null && String(validate).trim().toLowerCase() !== "parse") {
312
+ return batchRefusal(guard, validateNotRun(String(validate)), USE_VALIDATE_PARSE);
313
+ }
314
+ const operations = args.operations;
315
+ if (!Array.isArray(operations) || operations.length === 0) return batchRefusal(guard, NO_LIST_OF_OPERATIONS);
316
+ for (const [i, raw] of operations.entries()) {
317
+ const op = raw !== null && typeof raw === "object" && !Array.isArray(raw) ? raw as Readonly<Record<string, unknown>> : null;
318
+ const kind = typeof op?.kind === "string" ? op.kind.trim() : "";
319
+ const editor = Object.entries(OPERATION_TOOLS).find(([k]) => sameToolName(k, kind))?.[1];
320
+ if (op === null || typeof op.path !== "string" || op.path.trim() === "") {
321
+ return batchRefusal(guard, operationNamesNoPath(i + 1));
322
+ }
323
+ if (editor === undefined) return batchRefusal(guard, operationUnknownKind(i + 1, kind));
324
+ const verdict = checkToolCall(guard, editor, op, { mode: act.mode, gateEnabled: act.gateEnabled });
325
+ if (!verdict.allow) {
326
+ return { allow: false, reason: `${verdict.reason} (edit_batch operation ${i + 1}, ${kind} on '${op.path}')`, context: verdict.context };
327
+ }
328
+ }
329
+ return ALLOW;
330
+ }
331
+
332
+ /** A role's own write deny does not hold on a path its guard leaves writable. */
333
+ function leftWritable(guard: CallGuard, entry: GuardRule, path: string | undefined): boolean {
334
+ return path !== undefined && entry.origin.kind === "role" && entry.origin.access === "write"
335
+ && entry.rule.argument === "path"
336
+ && (matchesAny(path, guard.writable) || guard.stubs.includes(relativePath(path)));
337
+ }
338
+
339
+ /** The refusal the model reads: the reason, then the line saying what to do instead. */
340
+ export function denyText(verdict: Extract<CallVerdict, { allow: false }>): string {
341
+ return `${verdict.reason}\n${verdict.context}`;
342
+ }
@@ -0,0 +1,47 @@
1
+ // A text a brief carries so that the agent opens no file for it: a sheet, a test file, a diff.
2
+ // Each one goes under its title in a fenced block; past the room given, a text is cut and says
3
+ // so, the ones after it are left out and named, so the agent knows what it did not get. Pure.
4
+ import { cutLine, notCarried } from "./prompts/brief-blocks.ts";
5
+
6
+ export interface CarriedText {
7
+ /** What the text is: a path, or a sentence ("what F1 changed (git show ab700a7)"). */
8
+ title: string;
9
+ text: string;
10
+ /** The file the text is, when it is one: what `Carried.whole` names. */
11
+ path?: string;
12
+ }
13
+
14
+ /** The blocks a brief carries, and the files among them it carries whole (neither cut nor left out). */
15
+ export interface Carried {
16
+ blocks: string[];
17
+ whole: ReadonlySet<string>;
18
+ }
19
+
20
+ /** The fenced blocks of `texts`, in order, within `room` characters in all: a text past the room is cut with a
21
+ * note, the ones after it are listed as not carried. Empty when nothing fits. */
22
+ export function carriedBlocks(texts: readonly CarriedText[], room: number): string[] {
23
+ return carry(texts, room).blocks;
24
+ }
25
+
26
+ /** `carriedBlocks`, with the paths of the texts carried whole: a brief says a file is in it only when it is whole. */
27
+ export function carry(texts: readonly CarriedText[], room: number): Carried {
28
+ const out: string[] = [];
29
+ const skipped: string[] = [];
30
+ const whole = new Set<string>();
31
+ let left = room;
32
+ for (const { title, text, path } of texts) {
33
+ const body = text.replace(/\s+$/u, "");
34
+ const frame = `### ${title}\n\`\`\`text\n\n\`\`\``.length + 1;
35
+ if (left - frame < 200) {
36
+ skipped.push(title);
37
+ continue;
38
+ }
39
+ const fits = body.length <= left - frame;
40
+ if (fits && path !== undefined) whole.add(path);
41
+ const kept = fits ? body : `${body.slice(0, left - frame - 40)}\n${cutLine(body.length - (left - frame - 40))}`;
42
+ out.push(`### ${title}\n\`\`\`text\n${kept}\n\`\`\``);
43
+ left -= frame + kept.length;
44
+ }
45
+ if (skipped.length > 0) out.push(notCarried(skipped.join(", ")));
46
+ return { blocks: out, whole };
47
+ }
@@ -0,0 +1,100 @@
1
+ // The design rules of the dev workflow: the 17 ids a plan classifies as applied or not
2
+ // applicable, and what each one asks, in this project's own words. The gate checks the
3
+ // ids; the planner's prompt reads the wording. Pure.
4
+
5
+ /** The 17 design-rule ids of the dev workflow, in order: DDD-01..DDD-11, APP-01..APP-05, PERF-01. */
6
+ export const DESIGN_RULE_IDS: readonly string[] = [
7
+ "DDD-01", "DDD-02", "DDD-03", "DDD-04", "DDD-05", "DDD-06", "DDD-07", "DDD-08", "DDD-09", "DDD-10", "DDD-11",
8
+ "APP-01", "APP-02", "APP-03", "APP-04", "APP-05", "PERF-01",
9
+ ];
10
+
11
+ const KNOWN: ReadonlySet<string> = new Set(DESIGN_RULE_IDS);
12
+
13
+ export function isDesignRuleId(id: string): boolean {
14
+ return KNOWN.has(id);
15
+ }
16
+
17
+ export type DesignRuleFamily = "DDD" | "APP" | "PERF";
18
+ export interface DesignRule {
19
+ id: string; // one of DESIGN_RULE_IDS
20
+ family: DesignRuleFamily;
21
+ behaviour: string; // what the plan's code must do, one sentence
22
+ appliesWhen: string; // the situation that makes the id applicable
23
+ notApplicableWhen: string; // the usual valid N/A reason, or "" when the id applies to every change it names
24
+ }
25
+
26
+ const rule = (
27
+ id: string, family: DesignRuleFamily, behaviour: string, appliesWhen: string, notApplicableWhen: string,
28
+ ): DesignRule => ({ id, family, behaviour, appliesWhen, notApplicableWhen });
29
+
30
+ /** The 17 rules in DESIGN_RULE_IDS order. */
31
+ export const DESIGN_RULES: readonly DesignRule[] = [
32
+ rule("DDD-01", "DDD",
33
+ "Code and tests speak the business: someone who knows the domain recognises every type, method and test name, and a purely mechanical name is not accepted",
34
+ "something is added or renamed in the domain or application layer",
35
+ ""),
36
+ rule("DDD-02", "DDD",
37
+ "Each business rule has one guardian type, the one holding the data the rule is about; no other code can produce a state that breaks the rule",
38
+ "a command alters business state",
39
+ "no business state is altered"),
40
+ rule("DDD-03", "DDD",
41
+ "State moves only through methods named after what happens in the business; callers never write a field of the guardian",
42
+ "a guardian's state moves",
43
+ "no guardian's state moves"),
44
+ rule("DDD-04", "DDD",
45
+ "A value with constraints (an amount, an address, a range) is its own immutable type, built valid or not at all, and equal to any other with the same content",
46
+ "a value carries a constraint of its own",
47
+ "the value is a plain primitive with no constraint"),
48
+ rule("DDD-05", "DDD",
49
+ "Guardians refer to one another through keys; one never carries another inside it",
50
+ "one guardian has to point at another",
51
+ "no guardian points at another"),
52
+ rule("DDD-06", "DDD",
53
+ "Bringing something new into existence enforces its rules and may note the event; reloading stored data rebuilds it without judging it again",
54
+ "an object is born, or reloaded from storage",
55
+ "nothing is born or reloaded"),
56
+ rule("DDD-07", "DDD",
57
+ "What other parts are told is a named fact that already happened, carrying the data they need",
58
+ "other parts are notified of a change",
59
+ "nobody is notified"),
60
+ rule("DDD-08", "DDD",
61
+ "A command persists the changes of one guardian; anything else it touches is only read, as narrowly as it can be",
62
+ "something is persisted",
63
+ "nothing is persisted"),
64
+ rule("DDD-09", "DDD",
65
+ "An operation lives where its data lives; a stand-alone service is the last resort, when no type can host it",
66
+ "an operation has no obvious home, or a static helper looks easier",
67
+ "the operation already has an obvious home"),
68
+ rule("DDD-10", "DDD",
69
+ "Domain code depends on nothing technical; storage, transport and frameworks are reached from outside it",
70
+ "a domain file changes",
71
+ "no domain file changes"),
72
+ rule("DDD-11", "DDD",
73
+ "Something that may be missing is modelled as such — an empty collection, a dedicated \"none\" value, an optional business field — never by a stray null",
74
+ "a domain or application input, field or result may be missing",
75
+ "nothing can be missing"),
76
+ rule("APP-01", "APP",
77
+ "A use case coordinates — fetch, hand over to the domain, persist, answer — and decides nothing itself",
78
+ "a use case or application service is added or changed",
79
+ "the use case only fetches and answers"),
80
+ rule("APP-02", "APP",
81
+ "Each input or output need is an interface defined next to the code that consumes it; adapters plug into it from outside",
82
+ "a new input or output need appears",
83
+ "no new input or output need appears"),
84
+ rule("APP-03", "APP",
85
+ "A store handles one guardian type and converts its storage errors into errors the domain knows",
86
+ "how a guardian is stored changes",
87
+ "storage is not touched"),
88
+ rule("APP-04", "APP",
89
+ "Commands, endpoints and adapters translate formats and pass on; no business decision is taken there",
90
+ "an entry point or an adapter changes",
91
+ "no entry point or adapter changes"),
92
+ rule("APP-05", "APP",
93
+ "Every limit (a size, a rate, a count, an unbounded read) has one defining place and is reused from there",
94
+ "a limit or an unbounded read is involved",
95
+ "no limit is involved"),
96
+ rule("PERF-01", "PERF",
97
+ "A behaviour's input and output calls are a known constant, not proportional to its input; no such call sits in a loop over input items",
98
+ "a use case or an adapter changes",
99
+ "the plan states and justifies an unbounded cost"),
100
+ ];
@@ -0,0 +1,176 @@
1
+ // The model of one /dev-learn run: what the crew proposes per axis, kept in
2
+ // `<work>/learn-<date>/proposals.json` for --accept and --refuse to read, and the lines
3
+ // those print. A decision applies nothing: it prints the change to make. Pure, no IO.
4
+ import { sha1Hex } from "../sha1.ts";
5
+ import { acceptedHarness, acceptedRepository, hasTheWrongShape, THE_TOP_LEVEL } from "./messages.ts";
6
+
7
+ export const LEARN_FOLDER_PATTERN: RegExp = /^learn-\d{4}-\d{2}-\d{2}$/;
8
+ export function learnFolderName(date: string): string {
9
+ return `learn-${date}`;
10
+ }
11
+ export const PROPOSALS_JSON = "proposals.json";
12
+ export const PROPOSALS_MD = "PROPOSALS.md";
13
+
14
+ export type OwnerKind = "repository" | "harness";
15
+ export type CheckKind = "test" | "analyzer" | "architecture-test" | "gate" | "rule";
16
+ /** removes: the motif takes a wrong line out of its owner and adds none. */
17
+ export type MotifStatus = "new" | "refines" | "replaces" | "removes";
18
+ export interface Motif {
19
+ id: string; // motifId(axis, rows): 8 hex digits; 10 for both on a collision in one file (L3-Q09)
20
+ title: string; topic: string; rows: string[]; batches: string[];
21
+ preventiveLine: string; owner: { kind: OwnerKind; path: string };
22
+ check: CheckKind; status: MotifStatus;
23
+ linesRemoved: string[]; linesAdded: string[];
24
+ novelty: string; keyTerm: string;
25
+ /** What code found in the owner file (§ 2.4). */
26
+ reconcile: string;
27
+ }
28
+ export interface DroppedMotif { title: string; filter: "recurrence" | "prevention" | "novelty"; reason: string }
29
+ export interface AxisProposal {
30
+ axis: string; batches: number; gaps: number;
31
+ shownRows: string[]; // the row ids handed to the model, in order
32
+ hiddenRows: number; // rows over the cap, not shown
33
+ outcome: "proposed" | "no-motif" | "no-proposal" | "unchanged";
34
+ reason?: string; // no-proposal: the first problem; unchanged: the earlier folder
35
+ motifs: Motif[]; dropped: DroppedMotif[];
36
+ }
37
+ export interface ProposalsFile {
38
+ version: 1; date: string; work: string;
39
+ read: { files: number; gaps: number; batches: number; treatedOrkeon: number; treatedHarness: number; refused: number };
40
+ axes: AxisProposal[];
41
+ }
42
+
43
+ export function motifId(axis: string, rows: readonly string[]): string {
44
+ return sha1Hex(`${axis}|${[...rows].sort().join(",")}`).slice(0, 8);
45
+ }
46
+
47
+ // ---- parsing: every field is checked, the first wrong one is named ----
48
+
49
+ type Obj = Record<string, unknown>;
50
+ class Shape extends Error {}
51
+ const fieldPath = (at: string, key: string): string => (at === "" ? key : `${at}.${key}`);
52
+
53
+ const OWNER_KINDS: readonly string[] = ["repository", "harness"];
54
+ const CHECK_KINDS: readonly string[] = ["test", "analyzer", "architecture-test", "gate", "rule"];
55
+ const STATUSES: readonly string[] = ["new", "refines", "replaces", "removes"];
56
+ const FILTERS: readonly string[] = ["recurrence", "prevention", "novelty"];
57
+ const OUTCOMES: readonly string[] = ["proposed", "no-motif", "no-proposal", "unchanged"];
58
+ const MOTIF_ID = /^[0-9a-f]{8}([0-9a-f]{2})?$/;
59
+ const READ_KEYS = ["files", "gaps", "batches", "treatedOrkeon", "treatedHarness", "refused"] as const;
60
+
61
+ function obj(v: unknown, at: string): Obj {
62
+ if (typeof v !== "object" || v === null || Array.isArray(v)) throw new Shape(at);
63
+ return v as Obj;
64
+ }
65
+ function str(o: Obj, key: string, at: string): string {
66
+ const v = o[key];
67
+ if (typeof v !== "string") throw new Shape(fieldPath(at, key));
68
+ return v;
69
+ }
70
+ function count(o: Obj, key: string, at: string): number {
71
+ const v = o[key];
72
+ if (typeof v !== "number" || !Number.isInteger(v) || v < 0) throw new Shape(fieldPath(at, key));
73
+ return v;
74
+ }
75
+ function strings(o: Obj, key: string, at: string): string[] {
76
+ const v = o[key];
77
+ if (!Array.isArray(v) || !v.every((x) => typeof x === "string")) throw new Shape(fieldPath(at, key));
78
+ return [...v];
79
+ }
80
+ function oneOf<T extends string>(o: Obj, key: string, values: readonly string[], at: string): T {
81
+ const v = str(o, key, at);
82
+ if (!values.includes(v)) throw new Shape(fieldPath(at, key));
83
+ return v as T;
84
+ }
85
+ function list<T>(o: Obj, key: string, at: string, item: (v: unknown, at: string) => T): T[] {
86
+ const v = o[key];
87
+ if (!Array.isArray(v)) throw new Shape(fieldPath(at, key));
88
+ return v.map((x, i) => item(x, `${fieldPath(at, key)}[${i}]`));
89
+ }
90
+
91
+ function motifOf(v: unknown, at: string): Motif {
92
+ const o = obj(v, at);
93
+ const id = str(o, "id", at);
94
+ if (!MOTIF_ID.test(id)) throw new Shape(`${at}.id`);
95
+ const owner = obj(o.owner, `${at}.owner`);
96
+ return {
97
+ id, title: str(o, "title", at), topic: str(o, "topic", at),
98
+ rows: strings(o, "rows", at), batches: strings(o, "batches", at),
99
+ preventiveLine: str(o, "preventiveLine", at),
100
+ owner: { kind: oneOf<OwnerKind>(owner, "kind", OWNER_KINDS, `${at}.owner`), path: str(owner, "path", `${at}.owner`) },
101
+ check: oneOf<CheckKind>(o, "check", CHECK_KINDS, at), status: oneOf<MotifStatus>(o, "status", STATUSES, at),
102
+ linesRemoved: strings(o, "linesRemoved", at), linesAdded: strings(o, "linesAdded", at),
103
+ novelty: str(o, "novelty", at), keyTerm: str(o, "keyTerm", at), reconcile: str(o, "reconcile", at),
104
+ };
105
+ }
106
+
107
+ function droppedOf(v: unknown, at: string): DroppedMotif {
108
+ const o = obj(v, at);
109
+ return { title: str(o, "title", at), filter: oneOf<DroppedMotif["filter"]>(o, "filter", FILTERS, at), reason: str(o, "reason", at) };
110
+ }
111
+
112
+ function axisOf(v: unknown, at: string): AxisProposal {
113
+ const o = obj(v, at);
114
+ const axis: AxisProposal = {
115
+ axis: str(o, "axis", at), batches: count(o, "batches", at), gaps: count(o, "gaps", at),
116
+ shownRows: strings(o, "shownRows", at), hiddenRows: count(o, "hiddenRows", at),
117
+ outcome: oneOf<AxisProposal["outcome"]>(o, "outcome", OUTCOMES, at),
118
+ motifs: list(o, "motifs", at, motifOf), dropped: list(o, "dropped", at, droppedOf),
119
+ };
120
+ if (o.reason !== undefined) axis.reason = str(o, "reason", at);
121
+ return axis;
122
+ }
123
+
124
+ export function parseProposalsFile(text: string): { ok: true; file: ProposalsFile } | { ok: false; problem: string } {
125
+ let raw: unknown;
126
+ try {
127
+ raw = JSON.parse(text);
128
+ } catch (e) {
129
+ return { ok: false, problem: `not JSON (${(e instanceof Error ? e.message : String(e)).split("\n")[0]})` };
130
+ }
131
+ try {
132
+ const o = obj(raw, THE_TOP_LEVEL);
133
+ if (o.version !== 1) throw new Shape("version");
134
+ const read = obj(o.read, "read");
135
+ const counts = Object.fromEntries(READ_KEYS.map((k) => [k, count(read, k, "read")])) as ProposalsFile["read"];
136
+ const file: ProposalsFile = {
137
+ version: 1, date: str(o, "date", ""), work: str(o, "work", ""),
138
+ read: counts, axes: list(o, "axes", "", axisOf),
139
+ };
140
+ return { ok: true, file };
141
+ } catch (e) {
142
+ if (e instanceof Shape) return { ok: false, problem: hasTheWrongShape(e.message) };
143
+ throw e;
144
+ }
145
+ }
146
+
147
+ export function serializeProposalsFile(file: ProposalsFile): string {
148
+ return JSON.stringify(file, null, 1) + "\n";
149
+ }
150
+
151
+ // ---- the lines a decision prints ----
152
+
153
+ const HARNESS_SOURCE = /^\.devcontainer\/harness\/packs\/[^/]+\/claude\/(.+)$/;
154
+
155
+ /** The harness owner's file in the orkeon-workshop repository → its deployed copy in the checkout, or null. */
156
+ export function deployedHarnessPath(path: string): string | null {
157
+ const m = HARNESS_SOURCE.exec(path);
158
+ if (!m || m[1].split("/").some((s) => s === "" || s === "." || s === "..")) return null;
159
+ return `.claude/${m[1]}`;
160
+ }
161
+
162
+ export function patchLines(motif: Motif): string[] {
163
+ return [
164
+ `file: ${motif.owner.path}`,
165
+ ...motif.linesRemoved.map((l) => `- ${l}`),
166
+ ...motif.linesAdded.map((l) => `+ ${l}`),
167
+ ];
168
+ }
169
+
170
+ /** The lines printed for a motif: the patch for a harness owner, the change to make for a repository owner. */
171
+ export function acceptLines(motif: Motif): string[] {
172
+ const head = motif.owner.kind === "harness"
173
+ ? acceptedHarness(motif.id, motif.title)
174
+ : acceptedRepository(motif.id, motif.title, motif.owner.path);
175
+ return [head, ...patchLines(motif).map((l) => ` ${l}`)];
176
+ }