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,267 @@
1
+ // The open questions of a spec or a change brief and the decisions a person made on them: the rows of the two
2
+ // tables, written and read back, and the checks of a question as a model gives it. An open row keeps the
3
+ // template's columns (`| # | Severity | Question | Impact | Options |`), so spec-format.ts and the harness read
4
+ // its severity as before; a decision row (`| # | Question | Answer | Date |`) records what was settled, in a section
5
+ // of its own. Pure, no IO.
6
+ import {
7
+ DECISIONS_HEADER, DECISIONS_HEADING, LEAVE_OPEN, OPEN_QUESTIONS_HEADER, OPEN_QUESTIONS_HEADING, RECOMMENDED_MARK,
8
+ } from "./markers.ts";
9
+ import {
10
+ impactOneLine, notAnOptionToList, optionCount, optionOneLine, questionOneLine, severityMustBe, twoOptionsSame,
11
+ } from "./messages.ts";
12
+
13
+ export type QuestionSeverity = "Blocking" | "Major";
14
+ export const QUESTION_SEVERITIES: readonly QuestionSeverity[] = ["Blocking", "Major"];
15
+
16
+ /** One open question; `options[0]` is the recommended answer, `[]` when the question names none. */
17
+ export interface Question { id: string; severity: QuestionSeverity; question: string; impact: string; options: string[] }
18
+ /** One settled question: the question as it was asked, the answer the person gave, the day. */
19
+ export interface Decision { id: string; question: string; answer: string; date: string }
20
+
21
+ export const MAX_QUESTIONS = 12;
22
+ export const MAX_OPTIONS = 4;
23
+ const MAX_QUESTION_CHARS = 300;
24
+ const MAX_OPTION_CHARS = 120;
25
+ const MAX_CELL_CHARS = 300;
26
+ const QUESTION_ID = /^Q(\d+)$/;
27
+ const SEPARATOR_ROW = /^\|?[-: |]+$/;
28
+
29
+ /** A cell breaks its table when it holds a `|` or a line break. */
30
+ export const breaksCell = (text: string): boolean => /[|\r\n]/.test(text);
31
+
32
+ /** Two questions ask the same thing when they read the same, case and spaces aside. */
33
+ export const foldQuestion = (text: string): string => text.toLowerCase().replace(/[\s?]+/g, " ").trim();
34
+
35
+ export function optionsCell(options: readonly string[]): string {
36
+ if (options.length === 0) return "—";
37
+ return options.map((o, i) => `${i + 1}. ${o}${i === 0 ? RECOMMENDED_MARK : ""}`).join("; ");
38
+ }
39
+
40
+ /** The options of a cell written by optionsCell, or [] when the cell does not read as such a list. */
41
+ export function parseOptionsCell(cell: string): string[] {
42
+ const text = cell.trim();
43
+ if (text === "" || text === "—" || text === "-") return [];
44
+ const parts = text.split(/;\s*/).map((p) => p.trim()).filter((p) => p !== "");
45
+ const out: string[] = [];
46
+ for (const [i, part] of parts.entries()) {
47
+ const m = /^(\d+)\.\s+(.+)$/.exec(part);
48
+ if (m === null || Number(m[1]) !== i + 1) return [];
49
+ out.push(m[2].replace(/\s*\(recommended\)\s*$/i, "").trim());
50
+ }
51
+ return out.length >= 2 ? out : [];
52
+ }
53
+
54
+ export function questionRow(q: Question): string {
55
+ return `| ${q.id} | ${q.severity} | ${q.question} | ${q.impact || "—"} | ${optionsCell(q.options)} |`;
56
+ }
57
+
58
+ export function decisionRow(d: Decision): string {
59
+ return `| ${d.id} | ${d.question} | ${d.answer} | ${d.date} |`;
60
+ }
61
+
62
+ /** The table lines of a section, [] when there is no row: the section is then left out. */
63
+ export function questionTable(questions: readonly Question[]): string[] {
64
+ return questions.length === 0 ? [] : [...OPEN_QUESTIONS_HEADER, ...questions.map(questionRow)];
65
+ }
66
+
67
+ export function decisionTable(decisions: readonly Decision[]): string[] {
68
+ return decisions.length === 0 ? [] : [...DECISIONS_HEADER, ...decisions.map(decisionRow)];
69
+ }
70
+
71
+ const cellsOf = (row: string): string[] =>
72
+ row.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
73
+
74
+ /** The data rows of the tables under each `## ` heading matching `heading`, with their header cells. */
75
+ function rowsUnder(text: string, heading: RegExp): Array<{ header: string[]; cells: string[] }> {
76
+ const out: Array<{ header: string[]; cells: string[] }> = [];
77
+ let inside = false;
78
+ let header: string[] | null = null;
79
+ for (const line of text.split(/\r?\n/)) {
80
+ if (line.startsWith("## ")) { inside = heading.test(line); header = null; continue; }
81
+ if (!inside) continue;
82
+ if (!line.includes("|")) { header = null; continue; }
83
+ if (SEPARATOR_ROW.test(line.trim())) continue;
84
+ const cells = cellsOf(line);
85
+ if (header === null) { header = cells; continue; }
86
+ out.push({ header, cells });
87
+ }
88
+ return out;
89
+ }
90
+
91
+ const cell = (row: { header: string[]; cells: string[] }, name: string): string => {
92
+ const i = row.header.findIndex((h) => h.replace(/[*_`]/g, "").trim().toLowerCase() === name.toLowerCase());
93
+ return i < 0 ? "" : (row.cells[i] ?? "").trim();
94
+ };
95
+
96
+ /** The highest Q<n> of the ids, 0 when none. */
97
+ function highest(ids: Iterable<string>): number {
98
+ let max = 0;
99
+ for (const id of ids) {
100
+ const m = QUESTION_ID.exec(id);
101
+ if (m) max = Math.max(max, Number(m[1]));
102
+ }
103
+ return max;
104
+ }
105
+
106
+ /** The open questions of a file, as written by questionRow or by hand: a row without a Q<n> id gets the next free
107
+ * one, a severity other than Blocking reads Major, a row without a question is skipped. */
108
+ export function parseOpenQuestions(text: string, taken: Iterable<string> = []): Question[] {
109
+ const rows = rowsUnder(text, OPEN_QUESTIONS_HEADING);
110
+ let next = Math.max(highest(taken), highest(rows.map((r) => cell(r, "#")))) + 1;
111
+ const out: Question[] = [];
112
+ for (const r of rows) {
113
+ const question = cell(r, "Question");
114
+ if (question === "") continue;
115
+ const own = cell(r, "#");
116
+ const id = QUESTION_ID.test(own) ? own : `Q${next++}`;
117
+ const severity: QuestionSeverity = cell(r, "Severity").replace(/[*_`]/g, "").trim().toLowerCase() === "blocking"
118
+ ? "Blocking" : "Major";
119
+ const impact = cell(r, "Impact");
120
+ out.push({ id, severity, question, impact: impact === "—" ? "" : impact, options: parseOptionsCell(cell(r, "Options")) });
121
+ }
122
+ return out;
123
+ }
124
+
125
+ export function parseDecisions(text: string): Decision[] {
126
+ return rowsUnder(text, DECISIONS_HEADING)
127
+ .map((r) => ({ id: cell(r, "#"), question: cell(r, "Question"), answer: cell(r, "Answer"), date: cell(r, "Date") }))
128
+ .filter((d) => d.question !== "" && d.answer !== "");
129
+ }
130
+
131
+ /** A question as a model gives it, before it has an id. */
132
+ export interface DraftQuestion { severity: string; question: string; impact: string; options: string[] }
133
+
134
+ export const QUESTION_SCHEMA: object = {
135
+ type: "object",
136
+ properties: {
137
+ severity: { type: "string", enum: [...QUESTION_SEVERITIES] },
138
+ question: { type: "string" },
139
+ impact: { type: "string" },
140
+ options: { type: "array", items: { type: "string" } },
141
+ },
142
+ required: ["severity", "question", "impact", "options"],
143
+ };
144
+
145
+ /**
146
+ * The options of a question as a model gave them, made to fit a row without a second call: each on one line, its
147
+ * ';' and '|' (the separators of the row) turned into commas, the empty ones, the repeats and LEAVE_OPEN (code adds
148
+ * it) dropped, MAX_OPTIONS kept. A question left with one option, or with one longer than a row holds, has none: it
149
+ * is asked as free text.
150
+ */
151
+ export function tidyOptions(options: readonly string[]): string[] {
152
+ const seen = new Set<string>();
153
+ const kept: string[] = [];
154
+ for (const raw of options) {
155
+ const option = raw.replace(/\s*[;|]\s*/g, ", ").replace(/\s+/g, " ").trim();
156
+ const key = option.toLowerCase();
157
+ if (option === "" || key === LEAVE_OPEN.toLowerCase() || seen.has(key)) continue;
158
+ seen.add(key);
159
+ kept.push(option);
160
+ }
161
+ if (kept.length < 2 || kept.some((o) => o.length > MAX_OPTION_CHARS)) return [];
162
+ return kept.slice(0, MAX_OPTIONS);
163
+ }
164
+
165
+ /** What is wrong with question `k` of an answer: [] when it is one closed question fitting a row. */
166
+ export function draftQuestionProblems(q: DraftQuestion, k: number): string[] {
167
+ const problems: string[] = [];
168
+ if (!QUESTION_SEVERITIES.includes(q.severity as QuestionSeverity)) problems.push(severityMustBe(k));
169
+ const text = q.question.trim();
170
+ if (text === "" || breaksCell(text) || text.length > MAX_QUESTION_CHARS || !text.endsWith("?")) {
171
+ problems.push(questionOneLine(k, MAX_QUESTION_CHARS));
172
+ }
173
+ if (breaksCell(q.impact) || q.impact.length > MAX_CELL_CHARS) problems.push(impactOneLine(k));
174
+ if (q.options.length === 1 || q.options.length > MAX_OPTIONS) {
175
+ problems.push(optionCount(k, MAX_OPTIONS));
176
+ }
177
+ const seen = new Set<string>();
178
+ for (const o of q.options) {
179
+ const t = o.trim();
180
+ if (t === "" || breaksCell(t) || t.includes(";") || t.length > MAX_OPTION_CHARS) {
181
+ problems.push(optionOneLine(k, MAX_OPTION_CHARS));
182
+ break;
183
+ }
184
+ if (t.toLowerCase() === LEAVE_OPEN.toLowerCase()) { problems.push(notAnOptionToList(k, LEAVE_OPEN)); break; }
185
+ if (seen.has(t.toLowerCase())) { problems.push(twoOptionsSame(k)); break; }
186
+ seen.add(t.toLowerCase());
187
+ }
188
+ return problems;
189
+ }
190
+
191
+ /**
192
+ * The open questions after a draft: the model's, each numbered after every id already used (open or decided), a
193
+ * question that asks what a decision settled dropped, as is one asked twice.
194
+ */
195
+ export function numberQuestions(
196
+ drafts: readonly DraftQuestion[], decisions: readonly Decision[], kept: readonly Question[] = [],
197
+ ): Question[] {
198
+ const settled = new Set(decisions.map((d) => foldQuestion(d.question)));
199
+ const out: Question[] = [...kept];
200
+ const seen = new Set(out.map((q) => foldQuestion(q.question)));
201
+ let next = highest([...decisions.map((d) => d.id), ...kept.map((q) => q.id)]) + 1;
202
+ for (const d of drafts) {
203
+ const key = foldQuestion(d.question);
204
+ if (settled.has(key) || seen.has(key)) continue;
205
+ seen.add(key);
206
+ out.push({
207
+ id: `Q${next++}`, severity: d.severity === "Blocking" ? "Blocking" : "Major", question: d.question.trim(),
208
+ impact: d.impact.trim(), options: d.options.map((o) => o.trim()),
209
+ });
210
+ }
211
+ return out;
212
+ }
213
+
214
+ /** Blocking first, then Major, each in its order. */
215
+ export function askingOrder(questions: readonly Question[]): Question[] {
216
+ return [...questions.filter((q) => q.severity === "Blocking"), ...questions.filter((q) => q.severity !== "Blocking")];
217
+ }
218
+
219
+ /** The decision a person made, its answer fitting a cell. */
220
+ export function decide(q: Question, answer: string, date: string): Decision {
221
+ const flat = answer.replace(/\s*[\r\n]+\s*/g, " ").replace(/\|/g, "/").trim();
222
+ return { id: q.id, question: q.question, answer: flat.length > MAX_CELL_CHARS ? `${flat.slice(0, MAX_CELL_CHARS)}…` : flat, date };
223
+ }
224
+
225
+ /** The text a person reads before answering. */
226
+ export function questionPrompt(label: string, q: Question): string {
227
+ const impact = q.impact === "" ? [] : [`Impact: ${q.impact}`];
228
+ return [`${label} — ${q.id} (${q.severity}): ${q.question}`, ...impact].join("\n");
229
+ }
230
+
231
+ /**
232
+ * The text with its open-questions and decisions sections replaced by these tables: both old sections are taken
233
+ * out and the new ones written where the first of them stood (at the end when there was none). An empty table
234
+ * leaves its section out.
235
+ */
236
+ export function withQuestionSections(
237
+ text: string, open: readonly Question[], decisions: readonly Decision[], headings: { questions: string; decisions: string },
238
+ ): string {
239
+ const lines = text.replace(/\s+$/, "").split(/\r?\n/);
240
+ const kept: string[] = [];
241
+ let at = -1;
242
+ let skipping = false;
243
+ for (const line of lines) {
244
+ if (line.startsWith("## ")) {
245
+ skipping = OPEN_QUESTIONS_HEADING.test(line) || DECISIONS_HEADING.test(line);
246
+ if (skipping && at < 0) at = kept.length;
247
+ }
248
+ if (!skipping) kept.push(line);
249
+ }
250
+ const block = (heading: string, table: string[]): string[] => (table.length === 0 ? [] : [heading, "", ...table, ""]);
251
+ const inserted = [...block(headings.questions, questionTable(open)), ...block(headings.decisions, decisionTable(decisions))];
252
+ const where = at < 0 ? kept.length : at;
253
+ const head = kept.slice(0, where);
254
+ if (inserted.length > 0 && head.length > 0 && head[head.length - 1].trim() !== "") head.push("");
255
+ const out = [...head, ...inserted, ...kept.slice(where)];
256
+ return `${out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
257
+ }
258
+
259
+ /** The rows of a review as questions to add: no options (asked as text), the evidence as the impact. */
260
+ export function reviewDrafts(rows: ReadonlyArray<{ severity: string; question: string; evidence: string; target: string }>, whole: string): DraftQuestion[] {
261
+ return rows.map((r) => ({
262
+ severity: r.severity,
263
+ question: (r.target === whole ? r.question : `${r.target}: ${r.question}`).replace(/[|\r\n]+/g, " ").trim(),
264
+ impact: `review, ${r.evidence}`.replace(/[|\r\n]+/g, " ").trim(),
265
+ options: [],
266
+ }));
267
+ }
@@ -0,0 +1,41 @@
1
+ // How a dev agent reads and edits files: one rule, shared by the dev prompts. A file_read result is
2
+ // cut at 32 000 characters and node_read's at 256 000 (Orkeon:Tools:ResultLimits); a read by
3
+ // range returns the lines asked for and says whether more follow (file_read's start_line, end_line
4
+ // and has_more, Orkeon #180), so a range never hits the cut. Pure.
5
+
6
+ /** The longest range one read asks for, in lines (the harness's read bound). */
7
+ export const MAX_READ_LINES = 120;
8
+
9
+ /** The reading rule, for an agent that reads files. */
10
+ export const BOUNDED_READ_RULE =
11
+ `Read a file by range: file_read with offset and limit, ${MAX_READ_LINES} lines at most per read, and the next range ` +
12
+ "only while has_more says more follows and you need it; node_read for one symbol or one heading. Never read a whole " +
13
+ "file for its own sake. When you know several reads, ask for them in one turn: the runtime runs them together. The " +
14
+ "project is mounted on /workspace: a path shown relative (src/…, workbench/…) is read under /workspace, or the " +
15
+ "batch's working root; hand it to a tool as shown or as /workspace/<path>.";
16
+
17
+ /** The reading rule of a source file, for an agent that holds the node readers: by node first. */
18
+ export const NODE_READ_RULE =
19
+ "Read a source file by node: node_outline for its members and headings, then node_read for the one you need (its " +
20
+ "text, its range and its sha256); file_read by range only for what no node covers.";
21
+
22
+ /** The shape of an edit_batch call, spelt out so that the rule and the guard's refusal of a batch without
23
+ * operations say the same thing (the runtime publishes the schema of the node tools too, since Orkeon #210). */
24
+ export const EDIT_BATCH_SHAPE =
25
+ "`operations`, a list of {kind, path, selector, text} (expected_hash on node_replace, position on node_insert), with " +
26
+ "validate \"parse\"";
27
+
28
+ /** The editing rule, for an agent that holds the node editors (dev-implement's roles). */
29
+ export const NODE_EDIT_RULE =
30
+ "Change an existing file by node: node_replace with the selector and the sha256 node_read gave (when it is refused as " +
31
+ "stale, read the node again), node_insert to add a member, a test or a section before, after or inside an anchor, " +
32
+ "node_ensure for an import, a field or a section that may already be there; edit_file for a change too small for a " +
33
+ `node. A change over several places or files is one edit_batch (${EDIT_BATCH_SHAPE}): all of it applies or none, ` +
34
+ "and each node_replace of the batch carries the sha256 node_read gave for that very node: read every node you " +
35
+ "replace first, never guess a hash. file_write only creates a new file: writing an existing source file whole is refused.";
36
+
37
+ /** The tool names, for every dev agent: a name it was not given is refused by the runtime without a question (Orkeon #193). */
38
+ export const KNOWN_TOOLS_RULE =
39
+ "Only the tools you are given exist: a call to any other name (read, write, bash, …) is refused with \"ERROR: tool " +
40
+ "'<name>' is not available to this agent.\". On that error, call one of your tools instead (file_read or node_read " +
41
+ "to read); never call that name again.";
@@ -0,0 +1,240 @@
1
+ // The repository pack: the values a repository gives the dev workflow (its layout, its
2
+ // commands, its test trait, the ports the access cost counts, its contribution rules),
3
+ // read from a `repo.yaml` written in the YAML subset of yaml-subset.ts. Snake-case keys
4
+ // map to camel-case fields; a key of another type is reported, never guessed, and the
5
+ // whole document stays available for the keys typed nowhere here. Pure.
6
+ import { parseYamlSubset } from "./yaml-subset.ts";
7
+ import type { YamlError, YamlMap, YamlValue } from "./yaml-subset.ts";
8
+ import { ruleTraitProblem, traitPatternProblem } from "./trait-pattern.ts";
9
+ import {
10
+ expectedMapping, expectedString, LIST_FOUND_MAPPING, listHolding, noRepositoryPack, PACK_NOT_A_MAPPING, packHasNo,
11
+ testsAlsoSourceRoot,
12
+ } from "./messages.ts";
13
+
14
+ export interface RepoPackLayout {
15
+ domain?: string; application?: string; infrastructure?: string; tests?: string; work?: string;
16
+ shared: string[]; buildOutputs: string[];
17
+ /** Test files a folder cannot name (`x.test.ts` beside `x.ts`): gate patterns, `*` spanning folders. */
18
+ testFiles?: string[];
19
+ }
20
+ export interface RepoPackCommands {
21
+ restore?: string; build?: string; buildTest?: string; testClass?: string; test?: string;
22
+ testProject?: string; testIntegration?: string; cli?: string;
23
+ }
24
+ export interface RepoPackTests { ruleTrait?: string; traitPattern?: string }
25
+ export interface RepoPackAccessCost { receivers?: string; roots: string[] }
26
+ export interface RepoPackContrib { branch?: string; commit?: string; prTemplate?: string }
27
+ export interface RepoPack {
28
+ layout: RepoPackLayout; commands: RepoPackCommands; tests: RepoPackTests;
29
+ accessCost: RepoPackAccessCost; contrib: RepoPackContrib;
30
+ /** The whole parsed document, for keys L-1 does not type. */
31
+ document: YamlMap;
32
+ }
33
+ export interface RepoPackIssue { key: string; message: string }
34
+ export type RepoPackParse =
35
+ | { ok: true; pack: RepoPack; issues: RepoPackIssue[] }
36
+ | { ok: false; error: YamlError };
37
+
38
+ /** The dotted YAML keys of temp/04 § 6, in this order. */
39
+ export const REPO_PACK_KEYS: readonly string[] = [
40
+ "layout.domain", "layout.application", "layout.infrastructure", "layout.tests", "layout.work",
41
+ "layout.build_outputs", "layout.shared", "layout.test_files",
42
+ "commands.restore", "commands.build", "commands.build_test", "commands.test_class", "commands.test",
43
+ "commands.test_project", "commands.test_integration", "commands.cli",
44
+ "tests.rule_trait", "tests.trait_pattern",
45
+ "tools.access_cost.receivers", "tools.access_cost.roots",
46
+ "contrib.branch", "contrib.commit", "contrib.pr_template",
47
+ ];
48
+
49
+ const LIST_KEYS = new Set(["layout.build_outputs", "layout.shared", "layout.test_files", "tools.access_cost.roots"]);
50
+
51
+ function isMap(v: YamlValue | undefined): v is YamlMap {
52
+ return typeof v === "object" && v !== null && !Array.isArray(v);
53
+ }
54
+
55
+ function kindOf(v: YamlValue): string {
56
+ if (Array.isArray(v)) return "list";
57
+ if (isMap(v)) return "mapping";
58
+ return v === null ? "null" : typeof v === "string" ? "string" : typeof v === "number" ? "number" : "boolean";
59
+ }
60
+
61
+ /** The raw value at a dotted key, undefined when a step is absent or not a mapping. */
62
+ function lookup(document: YamlMap, key: string): YamlValue | undefined {
63
+ let cur: YamlValue | undefined = document;
64
+ for (const part of key.split(".")) {
65
+ if (!isMap(cur) || !Object.hasOwn(cur, part)) return undefined;
66
+ cur = cur[part];
67
+ }
68
+ return cur;
69
+ }
70
+
71
+ class Reader {
72
+ readonly issues: RepoPackIssue[] = [];
73
+ private readonly reported = new Set<string>();
74
+ private readonly document: YamlMap;
75
+
76
+ constructor(document: YamlMap) {
77
+ this.document = document;
78
+ }
79
+
80
+ /** Reports a section (layout, tools.access_cost…) that is set but is not a mapping. */
81
+ private sections(key: string): boolean {
82
+ const parts = key.split(".");
83
+ for (let n = 1; n < parts.length; n++) {
84
+ const section = parts.slice(0, n).join(".");
85
+ const v = lookup(this.document, section);
86
+ if (v === undefined || v === null) return false;
87
+ if (!isMap(v)) {
88
+ if (!this.reported.has(section)) {
89
+ this.reported.add(section);
90
+ this.issues.push({ key: section, message: expectedMapping(kindOf(v)) });
91
+ }
92
+ return false;
93
+ }
94
+ }
95
+ return true;
96
+ }
97
+
98
+ text(key: string): string | undefined {
99
+ if (!this.sections(key)) return undefined;
100
+ const v = lookup(this.document, key);
101
+ if (v === undefined || v === null) return undefined;
102
+ if (Array.isArray(v) || isMap(v)) {
103
+ this.issues.push({ key, message: expectedString(kindOf(v)) });
104
+ return undefined;
105
+ }
106
+ return String(v);
107
+ }
108
+
109
+ list(key: string): string[] {
110
+ if (!this.sections(key)) return [];
111
+ const v = lookup(this.document, key);
112
+ if (v === undefined || v === null) return [];
113
+ if (isMap(v)) {
114
+ this.issues.push({ key, message: LIST_FOUND_MAPPING });
115
+ return [];
116
+ }
117
+ if (!Array.isArray(v)) return [String(v)];
118
+ const bad = v.find((item) => item === null || typeof item === "object");
119
+ if (bad !== undefined) {
120
+ this.issues.push({ key, message: listHolding(kindOf(bad)) });
121
+ return [];
122
+ }
123
+ return v.map((item) => String(item));
124
+ }
125
+ }
126
+
127
+ /** tests.rule_trait and tests.trait_pattern, each left unset (and reported) when it is not usable. */
128
+ function checkedTests(r: Reader): RepoPackTests {
129
+ let ruleTrait = r.text("tests.rule_trait");
130
+ let traitPattern = r.text("tests.trait_pattern");
131
+ if (ruleTrait !== undefined) {
132
+ const message = ruleTraitProblem(ruleTrait);
133
+ if (message !== undefined) { r.issues.push({ key: "tests.rule_trait", message }); ruleTrait = undefined; }
134
+ }
135
+ if (traitPattern !== undefined) {
136
+ const message = traitPatternProblem(traitPattern);
137
+ if (message !== undefined) { r.issues.push({ key: "tests.trait_pattern", message }); traitPattern = undefined; }
138
+ }
139
+ if (traitPattern !== undefined && traitPattern.includes("<name>") && ruleTrait === undefined) {
140
+ r.issues.push({ key: "tests.trait_pattern", message: "<name> needs tests.rule_trait" });
141
+ traitPattern = undefined;
142
+ }
143
+ return { ruleTrait, traitPattern };
144
+ }
145
+
146
+ /** A `layout.tests` folder that is also a source root, reported and kept: the test author's write deny on the source
147
+ * roots and the implementer's on the tests would both cover it, so neither could write there. */
148
+ function checkTestsRoot(r: Reader, layout: RepoPackLayout): void {
149
+ const folder = (v: string | undefined): string => (v ?? "").trim().replace(/^(\.\/)+/, "").replace(/\/+$/, "");
150
+ const tests = folder(layout.tests);
151
+ if (tests === "") return;
152
+ const key = (["domain", "application", "infrastructure"] as const).find((k) => folder(layout[k]) === tests);
153
+ if (key === undefined) return;
154
+ r.issues.push({
155
+ key: "layout.tests",
156
+ message: testsAlsoSourceRoot(tests, key),
157
+ });
158
+ }
159
+
160
+ export function parseRepoPack(text: string): RepoPackParse {
161
+ const parsed = parseYamlSubset(text);
162
+ if (!parsed.ok) return parsed;
163
+ const document = parsed.value;
164
+ if (!isMap(document)) return { ok: false, error: { line: 1, message: PACK_NOT_A_MAPPING } };
165
+ const r = new Reader(document);
166
+ const pack: RepoPack = {
167
+ layout: {
168
+ domain: r.text("layout.domain"),
169
+ application: r.text("layout.application"),
170
+ infrastructure: r.text("layout.infrastructure"),
171
+ tests: r.text("layout.tests"),
172
+ work: r.text("layout.work"),
173
+ buildOutputs: r.list("layout.build_outputs"),
174
+ shared: r.list("layout.shared"),
175
+ testFiles: r.list("layout.test_files"),
176
+ },
177
+ commands: {
178
+ restore: r.text("commands.restore"),
179
+ build: r.text("commands.build"),
180
+ buildTest: r.text("commands.build_test"),
181
+ testClass: r.text("commands.test_class"),
182
+ test: r.text("commands.test"),
183
+ testProject: r.text("commands.test_project"),
184
+ testIntegration: r.text("commands.test_integration"),
185
+ cli: r.text("commands.cli"),
186
+ },
187
+ tests: checkedTests(r),
188
+ accessCost: { receivers: r.text("tools.access_cost.receivers"), roots: r.list("tools.access_cost.roots") },
189
+ contrib: {
190
+ branch: r.text("contrib.branch"),
191
+ commit: r.text("contrib.commit"),
192
+ prTemplate: r.text("contrib.pr_template"),
193
+ },
194
+ document,
195
+ };
196
+ checkTestsRoot(r, pack.layout);
197
+ return { ok: true, pack, issues: r.issues };
198
+ }
199
+
200
+ const FIELDS: Record<string, (p: RepoPack) => string | string[] | undefined> = {
201
+ "layout.domain": (p) => p.layout.domain,
202
+ "layout.application": (p) => p.layout.application,
203
+ "layout.infrastructure": (p) => p.layout.infrastructure,
204
+ "layout.tests": (p) => p.layout.tests,
205
+ "layout.work": (p) => p.layout.work,
206
+ "layout.build_outputs": (p) => p.layout.buildOutputs,
207
+ "layout.shared": (p) => p.layout.shared,
208
+ "layout.test_files": (p) => p.layout.testFiles,
209
+ "commands.restore": (p) => p.commands.restore,
210
+ "commands.build": (p) => p.commands.build,
211
+ "commands.build_test": (p) => p.commands.buildTest,
212
+ "commands.test_class": (p) => p.commands.testClass,
213
+ "commands.test": (p) => p.commands.test,
214
+ "commands.test_project": (p) => p.commands.testProject,
215
+ "commands.test_integration": (p) => p.commands.testIntegration,
216
+ "commands.cli": (p) => p.commands.cli,
217
+ "tests.rule_trait": (p) => p.tests.ruleTrait,
218
+ "tests.trait_pattern": (p) => p.tests.traitPattern,
219
+ "tools.access_cost.receivers": (p) => p.accessCost.receivers,
220
+ "tools.access_cost.roots": (p) => p.accessCost.roots,
221
+ "contrib.branch": (p) => p.contrib.branch,
222
+ "contrib.commit": (p) => p.contrib.commit,
223
+ "contrib.pr_template": (p) => p.contrib.prTemplate,
224
+ };
225
+
226
+ /** The value of one dotted key of REPO_PACK_KEYS (e.g. "commands.test_class"); undefined when absent. */
227
+ export function packValue(pack: RepoPack, key: string): string | readonly string[] | undefined {
228
+ const field = Object.hasOwn(FIELDS, key) ? FIELDS[key] : undefined;
229
+ if (!field) return undefined;
230
+ const value = field(pack);
231
+ if (!LIST_KEYS.has(key) || (Array.isArray(value) && value.length > 0)) return value;
232
+ // An empty list field is a value only when the document writes `[]` there.
233
+ return Array.isArray(lookup(pack.document, key)) ? value : undefined;
234
+ }
235
+
236
+ export function missingPackKeyLine(key: string, packShown: string | null): string {
237
+ return packShown === null
238
+ ? noRepositoryPack(key)
239
+ : packHasNo(packShown, key);
240
+ }