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,237 @@
1
+ // /dev-spec's use case: checks the inputs and the checkout, finds the code's folder (a change brief there refuses:
2
+ // one source per code), inventories the code by the index, asks the model for the spec as JSON (once more on a
3
+ // refused answer), renders, self-checks and writes SPEC-<code>.md, then asks the person its open questions one at a
4
+ // time through human_input - each answer written to the file before the next question. Unless a question went
5
+ // unanswered, the read-only reviewer questions the spec once; its Blocking rows are asked too. One fold then ends
6
+ // the run: the model rewrites the body with every decision of the run. With nobody to answer (an unattended run), the questions stay in the file and the run ends BLOCKED:
7
+ // nothing is decided on anyone's behalf. On an existing spec it revises: the person's edits and decisions are kept.
8
+ import type { CodeIndex, Files, HumanInput, Llm, Logger, Shell } from "../../../shared/application/ports.ts";
9
+ import type { ActRoute } from "../../../shared/application/agents/route-agent.ts";
10
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
11
+ import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
12
+ import { briefInventory, briefInventoryLine, briefPhrases, renderBriefInventory } from "../../../shared/application/dev/brief-inventory.ts";
13
+ import { foldDecisions, questionRound } from "../../../shared/application/dev/question-round.ts";
14
+ import type { Folded, RoundState } from "../../../shared/application/dev/question-round.ts";
15
+ import { reviewLine, reviewSource } from "../../../shared/application/dev/source-review.ts";
16
+ import { PhaseTimer } from "../../../shared/application/dev/phase-timer.ts";
17
+ import type { SourceReviewOutcome } from "../../../shared/application/dev/source-review.ts";
18
+ import {
19
+ codeFolder, dateOf, firstLine, inputCode, inputText, openLine, plural, problemLines, readRequest, sourceSelfCheck,
20
+ SourceWriteFailure, sourceWriter, toplevelRefusal, warningLines,
21
+ } from "../../../shared/application/dev/source-step.ts";
22
+ import { numberQuestions, parseDecisions, parseOpenQuestions } from "../../../shared/domain/dev/questions.ts";
23
+ import type { Decision, Question } from "../../../shared/domain/dev/questions.ts";
24
+ import { errorText } from "../../../shared/domain/error-text.ts";
25
+ import { parsePlanSource } from "../../../shared/domain/dev/spec-format.ts";
26
+ import { SPEC_ANSWER_SCHEMA, checkSpecAnswer, ruleId, useCaseId } from "../domain/spec-answer.ts";
27
+ import type { SpecAnswer } from "../domain/spec-answer.ts";
28
+ import { renderSpec, specFileName } from "../domain/spec-render.ts";
29
+ import { SPEC_DECISIONS_SECTION, SPEC_QUESTIONS_SECTION } from "../domain/markers.ts";
30
+ import { noPrecedents, precedentsLine, recallQuery } from "../../../shared/application/dev/step-precedents.ts";
31
+ import type { StepPrecedents } from "../../../shared/application/dev/step-precedents.ts";
32
+ import { buildSpecPrompt } from "./spec-material.ts";
33
+ import type { SpecPromptInput } from "./spec-material.ts";
34
+ import { DEV_SPEC_NEXT, answerThem, blockedUnanswered, cannotBeReadNothingWritten, changeBriefExists, specNotWrittenAnswersKept, decisionsThisRun, newSpecNeedsBrief, refusedTwice, rendererDefect, stillBlocking } from "./messages.ts";
35
+ import { PERMISSION_GATE_OFF } from "../../../shared/application/dev/messages.ts";
36
+ import { answerAskedAgain, answerDidNotParse } from "../../../shared/application/agents/messages.ts";
37
+
38
+ export interface DevSpecInputs { code?: unknown; request?: unknown }
39
+ export interface DevSpecDeps {
40
+ files: Files; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">; index: CodeIndex;
41
+ llm: Pick<Llm, "extract" | "act" | "permissionGateEnabled">; human: HumanInput; log: Logger; clock: () => Date;
42
+ /** The shared memory's code-triggered recall (T1); absent, nothing is recalled. */
43
+ precedents?: StepPrecedents;
44
+ /** The route of the spec reviewer's act to a cheaper or stronger profile (shared/application/agents/route-agent.ts actRoute);
45
+ * absent, the act runs on the crew's profile. */
46
+ route?: ActRoute;
47
+ }
48
+
49
+ const STEP = "dev-spec";
50
+ const HEADINGS = { questions: SPEC_QUESTIONS_SECTION, decisions: SPEC_DECISIONS_SECTION };
51
+
52
+ interface Drafted { answer: SpecAnswer; text: string; open: Question[] }
53
+
54
+ /** One extract, re-asked once with the problems; the text is rendered and read back before it is accepted. Each
55
+ * extract is timed as a "draft" attempt when `timer` is given (the fold is timed whole by its caller). */
56
+ async function askSpec(
57
+ deps: DevSpecDeps, prompt: SpecPromptInput, open: (a: SpecAnswer) => Question[], decisions: readonly Decision[],
58
+ timer: PhaseTimer | null,
59
+ ): Promise<{ ok: true; drafted: Drafted } | { ok: false; problems: string[] }> {
60
+ let problems: string[] = [];
61
+ for (let attempt = 1; attempt <= 2; attempt++) {
62
+ let value: unknown;
63
+ try {
64
+ const ask = () => deps.llm.extract(buildSpecPrompt(prompt, problems), SPEC_ANSWER_SCHEMA);
65
+ value = await (timer === null ? ask() : timer.time("draft", ask));
66
+ } catch (e) {
67
+ problems = [answerDidNotParse(errorText(e))];
68
+ deps.log.info(answerAskedAgain(STEP, problems));
69
+ continue;
70
+ }
71
+ const checked = checkSpecAnswer(value);
72
+ if (!checked.ok) {
73
+ problems = checked.problems;
74
+ deps.log.info(answerAskedAgain(STEP, problems));
75
+ continue;
76
+ }
77
+ const answer = checked.value;
78
+ const questions = open(answer);
79
+ const text = renderSpec({ code: prompt.code, answer, open: questions, decisions });
80
+ const ids = [...answer.useCases.map((_, i) => useCaseId(i)), ...answer.rules.map((_, i) => ruleId(i))];
81
+ const self = sourceSelfCheck(text, "spec", { code: prompt.code, ids, open: questions, decisions });
82
+ if (self.length > 0) {
83
+ deps.log.warn(rendererDefect(STEP, self[0]));
84
+ problems = self;
85
+ continue;
86
+ }
87
+ return { ok: true, drafted: { answer, text, open: questions } };
88
+ }
89
+ return { ok: false, problems };
90
+ }
91
+
92
+ export async function runDevSpec(input: DevSpecInputs, deps: DevSpecDeps): Promise<string> {
93
+ // 1. Inputs and checkout.
94
+ const code = inputCode(STEP, input.code);
95
+ if (typeof code !== "string") return code.refused;
96
+ const typed = inputText(STEP, "request", input.request);
97
+ if (typeof typed !== "string") return typed.refused;
98
+ const top = await toplevelRefusal(STEP, deps.shell);
99
+ if (top !== null) return top;
100
+ const ctx = await loadDevContext(deps);
101
+ const folder = await codeFolder(STEP, deps.files, ctx.work, code);
102
+ if ("refused" in folder) return folder.refused;
103
+
104
+ // 2. One source per code; an existing spec is revised.
105
+ if (folder.names.includes(`CHANGE-${code}.md`)) {
106
+ return changeBriefExists(STEP, folder.shown, code);
107
+ }
108
+ const spec = folder.file(specFileName(code));
109
+ let existing: string | null = null;
110
+ if (folder.names.includes(specFileName(code))) {
111
+ try {
112
+ existing = await deps.files.read(spec.vfs);
113
+ } catch (e) {
114
+ return cannotBeReadNothingWritten(STEP, spec.shown, firstLine(e));
115
+ }
116
+ }
117
+ const request = await readRequest(STEP, deps.files, typed);
118
+ if ("refused" in request) return request.refused;
119
+ if (existing === null && request.text === "") {
120
+ return newSpecNeedsBrief(STEP, code);
121
+ }
122
+
123
+ // 3. Inventory by code.
124
+ const timer = new PhaseTimer(deps.clock);
125
+ const shownPhrase = existing === null ? request.text : `${parsePlanSource(existing, "spec").name ?? ""}\n${request.text}`;
126
+ const inventory = await timer.time("inventory", () => briefInventory(deps.index, {
127
+ phrases: briefPhrases(code, shownPhrase),
128
+ excluded: [ctx.work.folder, ...(ctx.pack?.pack.layout.buildOutputs ?? [])],
129
+ }));
130
+ const inventoryText = renderBriefInventory(inventory);
131
+ const warnings = [...ctx.warnings, ...inventory.warnings];
132
+ // T1: the decisions and methods of earlier work on the same topic, before the draft; the same block in every ask.
133
+ const recalled = await (deps.precedents ?? noPrecedents)("T1", recallQuery([code, shownPhrase]));
134
+
135
+ const write = sourceWriter(deps.files, spec.vfs);
136
+ const today = dateOf(deps.clock());
137
+ const decisions0 = existing === null ? [] : parseDecisions(existing);
138
+ const open0 = existing === null ? [] : parseOpenQuestions(existing, decisions0.map((d) => d.id));
139
+
140
+ // 4. Draft or revision: rendered, read back, written.
141
+ let state: RoundState;
142
+ let verb: string;
143
+ try {
144
+ if (existing !== null && request.text === "") {
145
+ state = { text: existing, open: open0, decisions: decisions0 };
146
+ verb = "read";
147
+ } else {
148
+ const drafted = await askSpec(deps, {
149
+ mode: existing === null ? "draft" : "revision", code, request: request.text, current: existing ?? "",
150
+ decisions: decisions0, fresh: [], inventory: inventoryText, precedents: recalled.block,
151
+ }, (a) => numberQuestions(a.questions, decisions0, open0), decisions0, timer);
152
+ if (!drafted.ok) {
153
+ return [refusedTwice(STEP), ...problemLines(drafted.problems)].join("\n");
154
+ }
155
+ state = { text: drafted.drafted.text, open: drafted.drafted.open, decisions: decisions0 };
156
+ await write(state.text);
157
+ verb = existing === null ? "written" : "revised";
158
+ deps.log.info(`${STEP}: ${spec.shown} ${verb}`);
159
+ }
160
+
161
+ // 5. The questions, Blocking first, each answer written before the next one. No rewrite per round: the answers
162
+ // stay in the decisions section, which the reviewer reads, and one fold ends the run (step 7).
163
+ // The person's time is the "questions" phase, the model's fold its own.
164
+ const fold = (st: RoundState, fresh: readonly Decision[]): Promise<Folded> => timer.time("fold", async () => {
165
+ const r = await askSpec(deps, {
166
+ mode: "fold", code, request: "", current: st.text, decisions: st.decisions, fresh, inventory: inventoryText,
167
+ precedents: recalled.block,
168
+ }, (a) => numberQuestions(a.questions, st.decisions, st.open), st.decisions, null);
169
+ return r.ok ? { ok: true, text: r.drafted.text, open: r.drafted.open } : { ok: false, problems: r.problems };
170
+ });
171
+ const round = { human: deps.human, today, label: `${STEP} ${code}`, headings: HEADINGS, write };
172
+ const first = await timer.time("questions", () => questionRound(state, round), "round");
173
+ state = first.state;
174
+ warnings.push(...first.warnings);
175
+ const made = [...first.made];
176
+ let blocked = first.blocked;
177
+
178
+ // 6. The review, once, unless a question went unanswered; its Blocking rows are asked.
179
+ let review: SourceReviewOutcome | null = null;
180
+ if (!blocked) {
181
+ const ids = parsePlanSource(state.text, "spec").ids.map((i) => i.id);
182
+ review = await timer.time("review", () => reviewSource(timer.timedExtract(deps.llm, "review extract"), state, {
183
+ mode: "spec", whole: "spec", folder: folder.shown, fileShown: spec.shown, origin: request.from,
184
+ inventory: inventoryText, ids, headings: HEADINGS,
185
+ }, write, deps.route, deps.log));
186
+ if (deps.llm.permissionGateEnabled() === false) warnings.push(PERMISSION_GATE_OFF);
187
+ if (review.ran && review.added.length > 0) {
188
+ state = review.state;
189
+ const added = new Set(review.added);
190
+ const which = (q: Question): boolean => added.has(q.id) && q.severity === "Blocking";
191
+ const second = await timer.time("questions", () => questionRound(state, round, which), "round");
192
+ state = second.state;
193
+ warnings.push(...second.warnings);
194
+ made.push(...second.made);
195
+ blocked = second.blocked;
196
+ }
197
+ }
198
+
199
+ // 7. One fold: the body rewritten with every decision of the run.
200
+ const folded = await foldDecisions(state, made, fold, write);
201
+ state = folded.state;
202
+ warnings.push(...folded.warnings);
203
+
204
+ // 8. The end message.
205
+ const parsed = parsePlanSource(state.text, "spec");
206
+ const ids = parsed.ids.map((i) => i.id);
207
+ const lines = [
208
+ `${STEP}: ${spec.shown} ${verb} — ${plural(ids.length, "id", "ids")} (${ids.join(", ") || "none"})`,
209
+ decisionsThisRun(made.length === 0 ? "none" : made.map((d) => `${d.id} → ${d.answer}`).join("; ")),
210
+ `open questions: ${openLine(state.open)}`,
211
+ ...(review === null ? [] : [reviewLine(review)]),
212
+ briefInventoryLine(inventory),
213
+ ...[precedentsLine([recalled])].filter((l) => l !== ""),
214
+ ...warningLines(warnings),
215
+ ];
216
+ const blockingLeft = state.open.filter((q) => q.severity === "Blocking");
217
+ if (blocked) {
218
+ lines.push(
219
+ blockedUnanswered(STEP, spec.shown),
220
+ answerThem(code),
221
+ );
222
+ } else if (blockingLeft.length > 0) {
223
+ lines.push(stillBlocking(blockingLeft.map((q) => q.id).join(", "), code));
224
+ } else {
225
+ lines.push(DEV_SPEC_NEXT.replace("{code}", code));
226
+ }
227
+ const timing = timer.line();
228
+ if (timing !== "") {
229
+ deps.log.info(timing);
230
+ lines.push(timing);
231
+ }
232
+ return lines.join("\n");
233
+ } catch (e) {
234
+ if (!(e instanceof SourceWriteFailure)) throw e;
235
+ return specNotWrittenAnswersKept(STEP, spec.shown, e.message);
236
+ }
237
+ }
@@ -0,0 +1,42 @@
1
+ // The spec writer's prompt, assembled for one extract call: the head (instructions, mode, problems, decisions), then
2
+ // the material cut to the room the cap leaves - past the cap the current file is cut first, then the request, then
3
+ // the inventory. The text is ./prompts.ts's.
4
+ import type { Decision } from "../../../shared/domain/dev/questions.ts";
5
+ import { NO_INVENTORY, cutByCode, specPromptHead, specPromptMaterial } from "./prompts.ts";
6
+ import type { SpecPromptMode } from "./prompts.ts";
7
+
8
+ export interface SpecPromptInput {
9
+ mode: SpecPromptMode;
10
+ code: string;
11
+ /** The brief of a new spec, or the request typed after the code on a revision; "" when none. */
12
+ request: string;
13
+ /** The spec as it is on disk (revision) or as just written (fold); "" for a draft. */
14
+ current: string;
15
+ decisions: readonly Decision[];
16
+ /** The decisions of this run, which a fold writes into the body. */
17
+ fresh: readonly Decision[];
18
+ inventory: string;
19
+ /** The "## Precedents" block the step recalled (T1), "" or absent when none: material, placed last. */
20
+ precedents?: string;
21
+ }
22
+
23
+ const MAX_SPEC_PROMPT_CHARS = 60_000;
24
+ const MIN_PART = 2_000;
25
+
26
+ function cut(text: string, max: number): string {
27
+ if (text.length <= max) return text;
28
+ return cutByCode(text.slice(0, Math.max(0, max - 20)));
29
+ }
30
+
31
+ export function buildSpecPrompt(input: SpecPromptInput, problems: readonly string[]): string {
32
+ const head = specPromptHead(input.code, input.mode, problems, input.decisions, input.fresh);
33
+ const precedents = (input.precedents ?? "").trimEnd();
34
+ const fixed = head.join("\n").length + precedents.length + 400;
35
+ let room = MAX_SPEC_PROMPT_CHARS - fixed;
36
+ const inventory = cut(input.inventory.trimEnd() || NO_INVENTORY, Math.max(MIN_PART, Math.floor(room / 4)));
37
+ room -= inventory.length;
38
+ const request = cut(input.request.trim(), Math.max(MIN_PART, Math.floor(room / 3)));
39
+ room -= request.length;
40
+ const current = cut(input.current.trimEnd(), Math.max(MIN_PART, room));
41
+ return [...head, ...specPromptMaterial(input.mode, current, request, inventory, precedents)].join("\n");
42
+ }
@@ -0,0 +1,110 @@
1
+ // @orkeon-script 1.0
2
+ /// <reference path="../.orkeon/orkeon.d.ts" />
3
+ //
4
+ // DevSpec crew (/dev-spec). Composition root: it builds one agent from the reviewer's charter (read tools only)
5
+ // and wires application/run-dev-spec, which inventories the code by the index, asks the model for the business
6
+ // spec as JSON (once more on a refused answer), writes <work>/<code>/SPEC-<code>.md, asks its open questions one at
7
+ // a time through human_input (each answer written before the next question), folds the answers into the body, then
8
+ // has the read-only reviewer question the spec once. Unattended, the questions stay in the file: BLOCKED.
9
+ // The reviewer's act runs in a background child, `dev-reviewer` (its charter: read tools only, plan mode), which
10
+ // /tasks lists and stops while it runs, as /dev-plan's (A-3, approach A2).
11
+ //
12
+ // Input (globalThis.inputs): { code: string, request?: string (the brief, a path to it, or a revision request),
13
+ // hooks?: the /hooks registry, effort?: "low" | "medium" | "high" | "xhigh" | "max" | null,
14
+ // memoryRecall?: false (a session rule denies it: the agent gets none),
15
+ // concurrency?: number, maxInstances?: number }
16
+ // Run standalone: orkeon run src/crews/dev-spec/crew.ork.ts --inputs '{"code":"prune","request":"…"}'
17
+ //
18
+ // Budget (STEP_BUDGETS["dev-spec"]): about 50 index calls for the inventory, about 20 file and git calls, at most
19
+ // seven extract calls (draft, folds, re-asks) and one review of 20 iterations (about 3 tool calls each): well under
20
+ // 200 tool calls. The reviewer runs as a child (delegationDepth 1): the runtime gives it what the parent has left
21
+ // at its spawn, so its 60 calls are an estimate, not a cap. The wall time counts the person's answers: one hour.
22
+
23
+ import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infrastructure/globals.ts";
24
+ import {
25
+ orkeonActRoute, orkeonPrunedLlm,
26
+ orkeonAgent,
27
+ orkeonClock,
28
+ orkeonCodeIndex,
29
+ orkeonConfigStore,
30
+ orkeonFiles,
31
+ orkeonHumanInput,
32
+ orkeonMemoryToolPorts,
33
+ orkeonSessionIo,
34
+ orkeonSharedMemory,
35
+ orkeonShell,
36
+ } from "../../shared/infrastructure/orkeon/wiring.ts";
37
+ import { memoryReadTools, memoryRecallOn, memoryRecallTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
38
+ import { agentLlm } from "../../shared/infrastructure/orkeon/llm.ts";
39
+ import { providerEffort } from "../../shared/domain/agent-policy/behavior-flags.ts";
40
+ import { memoryDirOf } from "../../shared/application/shared-memory/memory-settings.ts";
41
+ import { devToolCallbacks } from "../../shared/application/dev/tool-callbacks.ts";
42
+ import { childAgentBody, openChildAct } from "../../shared/infrastructure/orkeon/child-agents.ts";
43
+ import { charterCatalogue } from "../../shared/domain/agents/charter.ts";
44
+ import { instanceLimits } from "../../shared/domain/agents/instances.ts";
45
+ import { REVIEWER_CHARTER } from "../../shared/domain/dev/reviewer-charter.ts";
46
+ import { reviewerCallbacks } from "../../shared/application/dev/spend.ts";
47
+ import { STEP_BUDGETS } from "../../shared/domain/dev/step-budget.ts";
48
+ import { stepPrecedents } from "../../shared/application/dev/step-precedents.ts";
49
+ import { runDevSpec } from "./application/run-dev-spec.ts";
50
+ import { SPEC_REVIEW_TASK, SPEC_WRITER_GOAL } from "./application/messages.ts";
51
+
52
+ const ports = { shell: orkeonShell(), files: orkeonFiles(), config: orkeonConfigStore(), index: orkeonCodeIndex(), human: orkeonHumanInput() };
53
+ // memory_recall is attached unless a session rule denies every call of it (the command says so).
54
+ const memoryOn = memoryRecallOn(inputs());
55
+ const effort = providerEffort(inputs().effort);
56
+ const session = orkeonSessionIo();
57
+ const limits = instanceLimits(inputs());
58
+ // These callbacks, then the host's gate on the input they return (Orkeon #303): the step's rule sets again and the /hooks the command passed.
59
+ const callbacksFor = (ctx: any) => devToolCallbacks(
60
+ { step: "dev-spec", hooks: inputs().hooks, readTools: memoryReadTools(memoryOn) }, { shell: ports.shell, log: ctx.log, memoryDir: memoryDirOf(ports.config) },
61
+ );
62
+
63
+ /** The reviewer, added to the crew by its first act (a sequential crew would run an agent it holds from the start). */
64
+ const reviewer = () => {
65
+ const builder = orkeonAgent()
66
+ .name(REVIEWER_CHARTER.name)
67
+ .role(REVIEWER_CHARTER.role)
68
+ .goal(REVIEWER_CHARTER.goal)
69
+ .tools(charterCatalogue(REVIEWER_CHARTER))
70
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
71
+ .maxIterations(REVIEWER_CHARTER.maxIterations)
72
+ .body(childAgentBody((ctx: any) => reviewerCallbacks(callbacksFor(ctx)), (llm, ctx) => orkeonPrunedLlm(llm, ctx.log, ctx.tools)));
73
+ return effort === undefined ? builder : builder.effort(effort);
74
+ };
75
+
76
+ const builder = orkeonAgent()
77
+ .name("dev-spec-writer")
78
+ .role("Business analyst")
79
+ .goal(SPEC_WRITER_GOAL)
80
+ // The catalogue is the reviewer's: read tools only. The spec itself is an extract call, which offers none.
81
+ .tools(charterCatalogue(REVIEWER_CHARTER))
82
+ .withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
83
+ .maxIterations(REVIEWER_CHARTER.maxIterations)
84
+ .body(async (_input: any, ctx: any) => {
85
+ const clock = orkeonClock();
86
+ const child = openChildAct(
87
+ agentLlm(ctx, callbacksFor(ctx), { effort }), ctx, crew, { state: session, clock, log: ctx.log, effort },
88
+ { crew: "dev-spec", step: "dev-spec" },
89
+ { agent: REVIEWER_CHARTER.name, charter: REVIEWER_CHARTER.name, task: SPEC_REVIEW_TASK, builder: reviewer },
90
+ );
91
+ try {
92
+ // T1: the shared memory's precedents in the draft's prompt, unless memory_recall is denied.
93
+ const precedents = stepPrecedents({ ...ports, memory: orkeonSharedMemory(), log: ctx.log }, { on: memoryOn });
94
+ return await runDevSpec(inputs(), { ...ports, llm: child.llm, log: ctx.log, clock, precedents, route: orkeonActRoute(ctx.log) });
95
+ } finally {
96
+ await child.close();
97
+ }
98
+ });
99
+ const writer = (effort === undefined ? builder : builder.effort(effort)).build();
100
+
101
+ const crew = CrewBuilder()
102
+ .name("dev-spec")
103
+ .process("sequential")
104
+ .budget(STEP_BUDGETS["dev-spec"])
105
+ .concurrency(limits.concurrency)
106
+ .maxInstances(limits.maxInstances)
107
+ .withAgent(writer)
108
+ .build();
109
+
110
+ publishCrew(crew);
@@ -0,0 +1,30 @@
1
+ // The markers of a spec file: the headings and table headers the renderer writes and /dev-plan, the review and the
2
+ // question round read back by their number (ADR 0026).
3
+
4
+ export const SPEC_DECISIONS_SECTION = "## 13. Decisions";
5
+ export const SPEC_QUESTIONS_SECTION = "## 12. Open questions";
6
+
7
+ /** The template's sections, numbered as /dev-plan expects them. */
8
+ export const SPEC_SECTIONS = {
9
+ context: "## 1. Context",
10
+ vocabulary: "## 2. Vocabulary",
11
+ overview: "## 3. Overview",
12
+ useCases: "## 4. Use cases",
13
+ rules: "## 5. Business rules",
14
+ data: "## 6. Data",
15
+ states: "## 7. States and transitions",
16
+ crossCutting: "## 8. Cross-cutting behaviours",
17
+ relations: "## 9. Relations",
18
+ outOfScope: "## 10. Out of scope",
19
+ assumptions: "## 11. Assumptions",
20
+ } as const;
21
+
22
+ /** The column headers of the template's tables. */
23
+ export const SPEC_COLUMNS = {
24
+ vocabulary: ["Term", "Definition"],
25
+ data: ["Datum", "Description", "Source", "Importance"],
26
+ states: ["State", "Event", "Next state", "Condition"],
27
+ relations: ["Upstream", "Downstream"],
28
+ outOfScope: ["Exclusion", "Reason"],
29
+ assumptions: ["#", "Assumption", "To be validated by"],
30
+ } as const;
@@ -0,0 +1,39 @@
1
+ // The messages of dev-spec's domain: the problems the check of a spec answer reports, which the model reads back on
2
+ // a re-ask and the person in the refusal (ADR 0026).
3
+
4
+ /** Words of a technical document, never of a business spec (the template's business purity), each with what it is. */
5
+ export const TECHNICAL: ReadonlyArray<[RegExp, string]> = [
6
+ [/`/, "a code mark (`)"],
7
+ [/\b[A-Za-z_][A-Za-z0-9_]*\(\)/, "a call such as name()"],
8
+ [/\b[\w-]+\.(ts|tsx|js|mjs|cs|py|java|go|rs|rb|php|json|ya?ml|sql|xml|csproj)\b/i, "a file name"],
9
+ [/\bHTTP\b|\b[1-5]\d\d (OK|Not Found|Bad Request|Unauthorized|Forbidden)\b/, "an HTTP status"],
10
+ [/\bexit code\b/i, "an exit code"],
11
+ [/\bstack trace\b/i, "a stack trace"],
12
+ [/\bendpoints?\b/i, "an endpoint"],
13
+ [/\b(class|interface|enum|DTO|repository pattern|framework)\b/, "a type or a framework"],
14
+ ];
15
+
16
+ // ── The problems of a spec answer ───────────────────────────────────────
17
+
18
+ export const cellSpansLines = (name: string, row: number, key: string): string => `${name} ${row}: ${key} is one line, no '|'`;
19
+ export const NO_SUMMARY = "summary: two or three sentences: what, for whom, why";
20
+ export const NO_CONTEXT = "context: the problem, for whom, the cost of doing nothing";
21
+ export const NO_USE_CASE = "useCases: at least one use case";
22
+ export const tooManyUseCases = (max: number): string => `useCases: at most ${max}`;
23
+ export const noActor = (id: string): string => `${id}: no actor`;
24
+ export const noIntent = (id: string): string => `${id}: no intent`;
25
+ export const noWhere = (id: string): string => `${id}: no Where: the surface and the moment the actor meets it`;
26
+ export const scenarioSteps = (id: string, max: number): string => `${id}: the nominal scenario has 1 to ${max} steps`;
27
+ export const fieldSpansLines = (id: string): string => `${id}: a field or a step spans lines`;
28
+ export const tooManyRules = (max: number): string => `rules: at most ${max}`;
29
+ export const noOrigin = (id: string): string =>
30
+ `${id}: no origin (regulation, standard, practice, product choice, existing behaviour)`;
31
+ export const severityIs = (id: string): string => `${id}: severity is blocking, warning or informational`;
32
+ export const appliesToNamesIds = (id: string): string => `${id}: appliesTo names UC-nn ids or cross-cutting`;
33
+ export const appliesToUnknown = (id: string, target: string): string => `${id}: appliesTo '${target}' is no use case of the answer`;
34
+ export const dataSourceIs = (datum: string, sources: string): string => `data '${datum}': source is ${sources}`;
35
+ export const dataImportanceIs = (datum: string, importance: string): string => `data '${datum}': importance is ${importance}`;
36
+ export const tooManyRows = (name: string, max: number): string => `${name}: at most ${max} rows`;
37
+ export const OVERVIEW_IS_FLOWCHART = "overview: the lines of one mermaid flowchart, without the fence, or \"\"";
38
+ export const termUsedNowhere = (term: string): string => `vocabulary: '${term}' is used nowhere else`;
39
+ export const businessPurity = (what: string, hit: string): string => `business purity: ${what} in "${hit}"; say it in business words`;