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,252 @@
1
+ // The model's spec as JSON: the schema it is extracted into, and the check that turns the extraction into a
2
+ // SpecAnswer or the list of what is wrong with it. The self-check of the harness's spec template, as code: a use
3
+ // case has an actor, an intent, a `Where` and a short scenario; a rule is one testable line with an origin and a
4
+ // severity, applied to use cases that exist; every vocabulary term is used; a TBD has its open question; nothing
5
+ // technical is named; every cell fits its table. Ids are code's: UC-nn and BR-nn by position. Pure, no IO.
6
+ import type { Checked } from "../../../shared/domain/agents/charter.ts";
7
+ import { MAX_QUESTIONS, QUESTION_SCHEMA, breaksCell, draftQuestionProblems, tidyOptions } from "../../../shared/domain/dev/questions.ts";
8
+ import type { DraftQuestion } from "../../../shared/domain/dev/questions.ts";
9
+ import { NO_CONTEXT, NO_SUMMARY, NO_USE_CASE, OVERVIEW_IS_FLOWCHART, TECHNICAL, appliesToNamesIds, appliesToUnknown, businessPurity, cellSpansLines, dataImportanceIs, dataSourceIs, fieldSpansLines, noActor, noIntent, noOrigin, noWhere, scenarioSteps, severityIs, termUsedNowhere, tooManyRows, tooManyRules, tooManyUseCases } from "./messages.ts";
10
+ import {
11
+ ANSWER_NOT_AN_OBJECT as NOT_AN_OBJECT, idNameOneLine, nameOneLine, rowIsEmpty, statementOneLine, TBD_WITHOUT_QUESTION, tooManyQuestions,
12
+ } from "../../../shared/domain/dev/messages.ts";
13
+
14
+ export interface SpecUseCase {
15
+ name: string; actor: string; intent: string; frequency: string; where: string;
16
+ scenario: string[]; variants: string; errors: string; outcome: string;
17
+ }
18
+ export type RuleSeverity = "blocking" | "warning" | "informational";
19
+ export interface SpecRule { name: string; statement: string; origin: string; severity: RuleSeverity; appliesTo: string[]; example: string }
20
+ export type SpecDatum = { datum: string; description: string; source: string; importance: string };
21
+ export type SpecTransition = { state: string; event: string; next: string; condition: string };
22
+ export interface SpecAnswer {
23
+ name: string; summary: string; context: string;
24
+ vocabulary: Array<{ term: string; definition: string }>;
25
+ /** The lines of a mermaid flowchart, without the fence; "" when the feature has no branch nor lifecycle. */
26
+ overview: string;
27
+ useCases: SpecUseCase[]; rules: SpecRule[]; data: SpecDatum[]; states: SpecTransition[];
28
+ crossCutting: string[];
29
+ relations: Array<{ upstream: string; downstream: string }>;
30
+ outOfScope: Array<{ exclusion: string; reason: string }>;
31
+ assumptions: Array<{ assumption: string; validatedBy: string }>;
32
+ questions: DraftQuestion[];
33
+ }
34
+
35
+ const RULE_SEVERITIES: readonly RuleSeverity[] = ["blocking", "warning", "informational"];
36
+ const DATA_SOURCES = ["entered", "computed", "imported", "catalogue"] as const;
37
+ const DATA_IMPORTANCE = ["essential", "secondary", "expert"] as const;
38
+ export const MAX_USE_CASES = 12;
39
+ export const MAX_RULES = 24;
40
+ export const MAX_SCENARIO_STEPS = 7;
41
+ const MAX_NAME_CHARS = 80;
42
+ const MAX_STATEMENT_CHARS = 200;
43
+ const MAX_LIST = 20;
44
+
45
+ const str = { type: "string" };
46
+ const strings = { type: "array", items: str };
47
+ const table = (keys: readonly string[]): object => ({
48
+ type: "array",
49
+ items: { type: "object", properties: Object.fromEntries(keys.map((k) => [k, str])), required: [...keys] },
50
+ });
51
+
52
+ export const SPEC_ANSWER_SCHEMA: object = {
53
+ type: "object",
54
+ properties: {
55
+ name: str, summary: str, context: str,
56
+ vocabulary: table(["term", "definition"]),
57
+ overview: str,
58
+ useCases: {
59
+ type: "array",
60
+ items: {
61
+ type: "object",
62
+ properties: {
63
+ name: str, actor: str, intent: str, frequency: str, where: str, scenario: strings,
64
+ variants: str, errors: str, outcome: str,
65
+ },
66
+ required: ["name", "actor", "intent", "frequency", "where", "scenario", "variants", "errors", "outcome"],
67
+ },
68
+ },
69
+ rules: {
70
+ type: "array",
71
+ items: {
72
+ type: "object",
73
+ properties: {
74
+ name: str, statement: str, origin: str, severity: { type: "string", enum: [...RULE_SEVERITIES] },
75
+ appliesTo: strings, example: str,
76
+ },
77
+ required: ["name", "statement", "origin", "severity", "appliesTo", "example"],
78
+ },
79
+ },
80
+ data: table(["datum", "description", "source", "importance"]),
81
+ states: table(["state", "event", "next", "condition"]),
82
+ crossCutting: strings,
83
+ relations: table(["upstream", "downstream"]),
84
+ outOfScope: table(["exclusion", "reason"]),
85
+ assumptions: table(["assumption", "validatedBy"]),
86
+ questions: { type: "array", items: QUESTION_SCHEMA },
87
+ },
88
+ required: [
89
+ "name", "summary", "context", "vocabulary", "overview", "useCases", "rules", "data", "states", "crossCutting",
90
+ "relations", "outOfScope", "assumptions", "questions",
91
+ ],
92
+ };
93
+
94
+ const isObject = (v: unknown): v is Record<string, unknown> => typeof v === "object" && v !== null && !Array.isArray(v);
95
+ const text = (v: unknown): string => (typeof v === "string" ? v.trim() : "");
96
+ const list = (v: unknown): unknown[] => (Array.isArray(v) ? v : []);
97
+ const textList = (v: unknown): string[] => list(v).map(text).filter((t) => t !== "");
98
+
99
+ function rows<K extends string>(v: unknown, keys: readonly K[]): Array<Record<K, string>> {
100
+ return list(v).map((item) => {
101
+ const o = isObject(item) ? item : {};
102
+ return Object.fromEntries(keys.map((k) => [k, text(o[k])])) as Record<K, string>;
103
+ });
104
+ }
105
+
106
+ /** `value` in lower case when it is one of `allowed`, none otherwise: a column the model filled with a word of its own
107
+ * is left empty, which the template allows, instead of costing a second call. */
108
+ const oneOf = (value: string, allowed: readonly string[]): string => (allowed.includes(value.toLowerCase()) ? value.toLowerCase() : "");
109
+
110
+ /** The value read leniently: every field present, strings trimmed, missing lists empty. */
111
+ function readSpecAnswer(value: unknown): SpecAnswer {
112
+ const o = isObject(value) ? value : {};
113
+ return {
114
+ name: text(o.name).replace(/\s*—\s*/g, " - "), summary: text(o.summary), context: text(o.context),
115
+ vocabulary: rows(o.vocabulary, ["term", "definition"]),
116
+ overview: typeof o.overview === "string" ? o.overview.trim() : "",
117
+ useCases: list(o.useCases).map((u) => {
118
+ const x = isObject(u) ? u : {};
119
+ return {
120
+ name: text(x.name), actor: text(x.actor), intent: text(x.intent), frequency: text(x.frequency),
121
+ where: text(x.where), scenario: textList(x.scenario), variants: text(x.variants), errors: text(x.errors),
122
+ outcome: text(x.outcome),
123
+ };
124
+ }),
125
+ rules: list(o.rules).map((r) => {
126
+ const x = isObject(r) ? r : {};
127
+ return {
128
+ name: text(x.name), statement: text(x.statement), origin: text(x.origin),
129
+ severity: text(x.severity).toLowerCase() as RuleSeverity, appliesTo: textList(x.appliesTo), example: text(x.example),
130
+ };
131
+ }),
132
+ data: rows(o.data, ["datum", "description", "source", "importance"]).map((d) => ({
133
+ ...d, source: oneOf(d.source, DATA_SOURCES), importance: oneOf(d.importance, DATA_IMPORTANCE),
134
+ })),
135
+ states: rows(o.states, ["state", "event", "next", "condition"]),
136
+ crossCutting: textList(o.crossCutting),
137
+ relations: rows(o.relations, ["upstream", "downstream"]),
138
+ outOfScope: rows(o.outOfScope, ["exclusion", "reason"]),
139
+ assumptions: rows(o.assumptions, ["assumption", "validatedBy"]),
140
+ questions: list(o.questions).map((q) => {
141
+ const x = isObject(q) ? q : {};
142
+ return { severity: text(x.severity), question: text(x.question), impact: text(x.impact), options: tidyOptions(textList(x.options)) };
143
+ }),
144
+ };
145
+ }
146
+
147
+ const oneLine = (t: string): boolean => !/[\r\n]/.test(t);
148
+ export const useCaseId = (k: number): string => `UC-${String(k + 1).padStart(2, "0")}`;
149
+ export const ruleId = (k: number): string => `BR-${String(k + 1).padStart(2, "0")}`;
150
+
151
+ /** Every text of the answer's body, but the overview (a flowchart's syntax) and the vocabulary. The questions are
152
+ * left out: a question is asked to a person, not specified, it may name what it is about, and the fold lists the
153
+ * ones the reviewer wrote, which no purity rule held. */
154
+ function bodyTexts(a: SpecAnswer): string[] {
155
+ return [
156
+ a.name, a.summary, a.context,
157
+ ...a.useCases.flatMap((u) => [u.name, u.actor, u.intent, u.frequency, u.where, ...u.scenario, u.variants, u.errors, u.outcome]),
158
+ ...a.rules.flatMap((r) => [r.name, r.statement, r.origin, r.example]),
159
+ ...a.data.flatMap((d) => [d.datum, d.description]),
160
+ ...a.states.flatMap((s) => [s.state, s.event, s.next, s.condition]),
161
+ ...a.crossCutting,
162
+ ...a.relations.flatMap((r) => [r.upstream, r.downstream]),
163
+ ...a.outOfScope.flatMap((r) => [r.exclusion, r.reason]),
164
+ ...a.assumptions.flatMap((r) => [r.assumption, r.validatedBy]),
165
+ ];
166
+ }
167
+
168
+ function cellProblems(name: string, items: ReadonlyArray<Record<string, string>>, problems: string[]): void {
169
+ items.forEach((row, i) => {
170
+ for (const [key, value] of Object.entries(row)) {
171
+ if (breaksCell(value)) { problems.push(cellSpansLines(name, i + 1, key)); return; }
172
+ }
173
+ if (Object.values(row).every((v) => v === "")) problems.push(rowIsEmpty(name, i + 1));
174
+ });
175
+ }
176
+
177
+ export function checkSpecAnswer(value: unknown): Checked<SpecAnswer> {
178
+ if (!isObject(value)) return { ok: false, problems: [NOT_AN_OBJECT] };
179
+ const a = readSpecAnswer(value);
180
+ const problems: string[] = [];
181
+
182
+ if (a.name === "" || !oneLine(a.name) || a.name.length > MAX_NAME_CHARS || a.name.includes("—")) {
183
+ problems.push(nameOneLine(MAX_NAME_CHARS));
184
+ }
185
+ if (a.summary === "") problems.push(NO_SUMMARY);
186
+ if (a.context === "") problems.push(NO_CONTEXT);
187
+
188
+ if (a.useCases.length === 0) problems.push(NO_USE_CASE);
189
+ if (a.useCases.length > MAX_USE_CASES) problems.push(tooManyUseCases(MAX_USE_CASES));
190
+ a.useCases.forEach((u, i) => {
191
+ const id = useCaseId(i);
192
+ if (u.name === "" || !oneLine(u.name) || u.name.length > MAX_NAME_CHARS) problems.push(idNameOneLine(id, MAX_NAME_CHARS));
193
+ if (u.actor === "") problems.push(noActor(id));
194
+ if (u.intent === "") problems.push(noIntent(id));
195
+ if (u.where === "") problems.push(noWhere(id));
196
+ if (u.scenario.length === 0 || u.scenario.length > MAX_SCENARIO_STEPS) {
197
+ problems.push(scenarioSteps(id, MAX_SCENARIO_STEPS));
198
+ }
199
+ if ([u.actor, u.intent, u.frequency, u.where, ...u.scenario].some((t) => !oneLine(t))) problems.push(fieldSpansLines(id));
200
+ });
201
+
202
+ const ucIds = new Set(a.useCases.map((_, i) => useCaseId(i)));
203
+ if (a.rules.length > MAX_RULES) problems.push(tooManyRules(MAX_RULES));
204
+ a.rules.forEach((r, i) => {
205
+ const id = ruleId(i);
206
+ if (r.name === "" || !oneLine(r.name) || r.name.length > MAX_NAME_CHARS) problems.push(idNameOneLine(id, MAX_NAME_CHARS));
207
+ if (r.statement === "" || !oneLine(r.statement) || r.statement.length > MAX_STATEMENT_CHARS || r.statement.includes(" · ")) {
208
+ problems.push(statementOneLine(id, MAX_STATEMENT_CHARS));
209
+ }
210
+ if (r.origin === "") problems.push(noOrigin(id));
211
+ if (!RULE_SEVERITIES.includes(r.severity)) problems.push(severityIs(id));
212
+ if (r.appliesTo.length === 0) problems.push(appliesToNamesIds(id));
213
+ for (const t of r.appliesTo) {
214
+ if (t !== "cross-cutting" && !ucIds.has(t)) problems.push(appliesToUnknown(id, t));
215
+ }
216
+ });
217
+
218
+ cellProblems("vocabulary", a.vocabulary, problems);
219
+ cellProblems("data", a.data, problems);
220
+ cellProblems("states", a.states, problems);
221
+ cellProblems("relations", a.relations, problems);
222
+ cellProblems("outOfScope", a.outOfScope, problems);
223
+ cellProblems("assumptions", a.assumptions, problems);
224
+ for (const d of a.data) {
225
+ if (d.source !== "" && !(DATA_SOURCES as readonly string[]).includes(d.source)) problems.push(dataSourceIs(d.datum, DATA_SOURCES.join(", ")));
226
+ if (d.importance !== "" && !(DATA_IMPORTANCE as readonly string[]).includes(d.importance)) {
227
+ problems.push(dataImportanceIs(d.datum, DATA_IMPORTANCE.join(", ")));
228
+ }
229
+ }
230
+ for (const [name, n] of [["crossCutting", a.crossCutting.length], ["vocabulary", a.vocabulary.length], ["data", a.data.length]] as const) {
231
+ if (n > MAX_LIST) problems.push(tooManyRows(name, MAX_LIST));
232
+ }
233
+ if (a.overview !== "" && (a.overview.includes("```") || !/^(flowchart|graph|stateDiagram)/.test(a.overview))) {
234
+ problems.push(OVERVIEW_IS_FLOWCHART);
235
+ }
236
+
237
+ const body = bodyTexts(a).join("\n");
238
+ const lower = body.toLowerCase();
239
+ for (const v of a.vocabulary) {
240
+ if (v.term !== "" && !lower.includes(v.term.toLowerCase())) problems.push(termUsedNowhere(v.term));
241
+ }
242
+ if (/\bTBD\b/.test(body) && a.questions.length === 0) problems.push(TBD_WITHOUT_QUESTION);
243
+ for (const [pattern, what] of TECHNICAL) {
244
+ const hit = bodyTexts(a).find((t) => pattern.test(t));
245
+ if (hit !== undefined) problems.push(businessPurity(what, hit.slice(0, 60)));
246
+ }
247
+
248
+ if (a.questions.length > MAX_QUESTIONS) problems.push(tooManyQuestions(MAX_QUESTIONS));
249
+ a.questions.forEach((q, i) => problems.push(...draftQuestionProblems(q, i + 1)));
250
+
251
+ return problems.length > 0 ? { ok: false, problems } : { ok: true, value: a };
252
+ }
@@ -0,0 +1,76 @@
1
+ // The spec file as code writes it from a checked SpecAnswer, its open questions and its decisions: the harness's
2
+ // template (sections 1 to 12) with a section 13 of decisions, a section left out when it has nothing to say (the
3
+ // numbers stay the template's, so a reader and /dev-plan find each section where they expect it). A use case and a
4
+ // rule carry a `- **Statement**:` line first, which spec-format.ts reads for /dev-plan. Pure, no IO.
5
+ import { STATEMENT } from "../../../shared/domain/dev/markers.ts";
6
+ import { decisionTable, questionTable } from "../../../shared/domain/dev/questions.ts";
7
+ import type { Decision, Question } from "../../../shared/domain/dev/questions.ts";
8
+ import { ruleId, useCaseId } from "./spec-answer.ts";
9
+ import type { SpecAnswer } from "./spec-answer.ts";
10
+ import { SPEC_COLUMNS, SPEC_DECISIONS_SECTION, SPEC_QUESTIONS_SECTION, SPEC_SECTIONS } from "./markers.ts";
11
+
12
+ export const specFileName = (code: string): string => `SPEC-${code}.md`;
13
+
14
+ export interface SpecRenderInput { code: string; answer: SpecAnswer; open: readonly Question[]; decisions: readonly Decision[] }
15
+
16
+ const section = (heading: string, body: readonly string[]): string[] => (body.length === 0 ? [] : [heading, "", ...body, ""]);
17
+ const table = (header: readonly string[], rows: ReadonlyArray<readonly string[]>): string[] =>
18
+ rows.length === 0 ? [] : [
19
+ `| ${header.join(" | ")} |`, `|${header.map(() => "---").join("|")}|`,
20
+ ...rows.map((r) => `| ${r.map((c) => c || "—").join(" | ")} |`),
21
+ ];
22
+ const sentence = (t: string): string => (t === "" || /[.!?]$/.test(t) ? t : `${t}.`);
23
+
24
+ function useCaseBlock(a: SpecAnswer): string[] {
25
+ return a.useCases.flatMap((u, i) => {
26
+ const head = [`${STATEMENT}: ${u.intent}`, `**Actor**: ${u.actor}`];
27
+ if (u.frequency !== "") head.push(`**Frequency**: ${u.frequency}`);
28
+ const lines = [`### ${useCaseId(i)} — ${u.name}`, `- ${head.join(" · ")}`, `- **Where**: ${u.where}`, "- **Nominal scenario**:"];
29
+ u.scenario.forEach((s, k) => lines.push(` ${k + 1}. ${s}`));
30
+ if (u.variants !== "") lines.push(`- **Variants**: ${u.variants}`);
31
+ if (u.errors !== "") lines.push(`- **Errors**: ${u.errors}`);
32
+ if (u.outcome !== "") lines.push(`- **Expected outcome**: ${u.outcome}`);
33
+ lines.push("");
34
+ return lines;
35
+ });
36
+ }
37
+
38
+ function ruleBlock(a: SpecAnswer): string[] {
39
+ return a.rules.flatMap((r, i) => {
40
+ const applies = r.appliesTo.join(", ");
41
+ const lines = [
42
+ `### ${ruleId(i)} — ${r.name}`,
43
+ `- ${STATEMENT}: ${r.statement} · **Origin**: ${r.origin} · **Severity**: ${r.severity}`,
44
+ `- **Applies to**: ${applies}`,
45
+ ];
46
+ if (r.example !== "") lines.push(`- **Example**: ${r.example}`);
47
+ lines.push("");
48
+ return lines;
49
+ });
50
+ }
51
+
52
+ export function renderSpec(input: SpecRenderInput): string {
53
+ const a = input.answer;
54
+ const lines: string[] = [`# ${input.code} — ${a.name}`, ""];
55
+ if (a.summary !== "") lines.push(...a.summary.split(/\r?\n/).map((l) => `> ${l}`.trimEnd()), "");
56
+ lines.push(...section(SPEC_SECTIONS.context, [a.context]));
57
+ lines.push(...section(SPEC_SECTIONS.vocabulary, table(SPEC_COLUMNS.vocabulary, a.vocabulary.map((v) => [v.term, v.definition]))));
58
+ lines.push(...section(SPEC_SECTIONS.overview, a.overview === "" ? [] : ["```mermaid", a.overview, "```"]));
59
+ lines.push(SPEC_SECTIONS.useCases, "", ...useCaseBlock(a));
60
+ if (a.rules.length > 0) lines.push(SPEC_SECTIONS.rules, "", ...ruleBlock(a));
61
+ lines.push(...section(SPEC_SECTIONS.data, table(
62
+ SPEC_COLUMNS.data, a.data.map((d) => [d.datum, d.description, d.source, d.importance]),
63
+ )));
64
+ lines.push(...section(SPEC_SECTIONS.states, table(
65
+ SPEC_COLUMNS.states, a.states.map((s) => [s.state, s.event, s.next, s.condition]),
66
+ )));
67
+ lines.push(...section(SPEC_SECTIONS.crossCutting, a.crossCutting.map((c) => `- ${sentence(c)}`)));
68
+ lines.push(...section(SPEC_SECTIONS.relations, table(SPEC_COLUMNS.relations, a.relations.map((r) => [r.upstream, r.downstream]))));
69
+ lines.push(...section(SPEC_SECTIONS.outOfScope, table(SPEC_COLUMNS.outOfScope, a.outOfScope.map((r) => [r.exclusion, r.reason]))));
70
+ lines.push(...section(SPEC_SECTIONS.assumptions, table(
71
+ SPEC_COLUMNS.assumptions, a.assumptions.map((r, i) => [`A${i + 1}`, r.assumption, r.validatedBy]),
72
+ )));
73
+ lines.push(...section(SPEC_QUESTIONS_SECTION, questionTable(input.open)));
74
+ lines.push(...section(SPEC_DECISIONS_SECTION, decisionTable(input.decisions)));
75
+ return `${lines.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
76
+ }
@@ -0,0 +1,187 @@
1
+ // The auditor's brief, follow-up and answer prompt, assembled: the sheet and the capture carried while they fit
2
+ // MAX_BRIEF_CHARS, the rows of the first answer fitted to the follow-up, the reply cut keeping its end. The wording
3
+ // is in ./prompts.ts.
4
+
5
+ import type { AuditAnswer, AuditRow } from "../domain/audit-answer.ts";
6
+ import { cut } from "../domain/text.ts";
7
+ import { MAX_BRIEF_CHARS } from "../../../shared/domain/agents/charter.ts";
8
+ import { projectFileLines } from "../../../shared/domain/dev/project-files.ts";
9
+ import { earlierTextCut } from "../../../shared/domain/dev/prompts.ts";
10
+ import {
11
+ NO_ROWS_LINE, THE_CAPTURE_FOLDER, auditAnswerPrompt, auditRowLine, auditScopeLines, captureFilesToReadLines,
12
+ captureInBriefLines, captureLeftToReadLines, captureTextBlock, fastSuiteLines, firstAnswerLines, mechanicalTableLines,
13
+ previousGapsLines, rowsLeftOutLine, sheetInBriefLines, undecidedLine, validationCommandLines, validationReportSection,
14
+ validationReportsLines, validationsNamedLine,
15
+ } from "./prompts.ts";
16
+
17
+ /** One capture file and its text. */
18
+ export interface CaptureText {
19
+ path: string;
20
+ text: string;
21
+ }
22
+
23
+ /** The most capture text the brief carries; a file past it stays to read. */
24
+ export const INLINE_CAPTURE_CHARS = 12_000;
25
+
26
+ /** The most sheet text the brief carries; a longer sheet stays to read. */
27
+ export const INLINE_SHEET_CHARS = 6_000;
28
+ /** What the brief keeps free under MAX_BRIEF_CHARS once the capture is in. */
29
+ const BRIEF_MARGIN = 200;
30
+ /** The capture files the brief stands for once every other one is in it: the index, the manifest, the table. */
31
+ const CAPTURE_FRAME = /\/(?:index\.txt|manifest\.txt|table\.md)$/;
32
+
33
+ export interface AuditBriefInput {
34
+ mode: "fast" | "full" | "resume";
35
+ batch: string;
36
+ sheetPath: string;
37
+ /** The sheet's text, carried in the brief while it fits INLINE_SHEET_CHARS; absent or longer: read from sheetPath. */
38
+ sheetText?: string;
39
+ captureFiles: readonly string[];
40
+ /** The project's files (tracked and untracked, the work folder left out), listed so that the auditor guesses no
41
+ * name; absent or empty: no list. */
42
+ projectFiles?: readonly string[];
43
+ /** The capture files' texts, table.md aside (the brief carries the table): each goes in the brief while it has
44
+ * room, the rest stay to read. Absent: every capture file is to read. */
45
+ captureTexts?: readonly CaptureText[];
46
+ table: string;
47
+ appliedRules: string;
48
+ commands: { testClass?: string; testProject?: string; testIntegration?: string };
49
+ previousGaps: readonly AuditRow[] | null;
50
+ /** Under full: the whole fast suite as code ran it, before the audit. */
51
+ suite?: { command: string; outcome: string; tail: string };
52
+ /** The "## Precedents" block the step recalled (T4: mistakes whose signal to check), "" or absent when none. */
53
+ precedents?: string;
54
+ }
55
+
56
+ const scopeLines = (input: AuditBriefInput): string[] =>
57
+ auditScopeLines(input.batch, input.mode, input.sheetPath, input.appliedRules);
58
+
59
+ function projectLines({ projectFiles }: AuditBriefInput): string[] {
60
+ const lines = projectFileLines(projectFiles ?? []);
61
+ return lines.length === 0 ? [] : ["", ...lines];
62
+ }
63
+
64
+ const suiteLines = ({ suite }: AuditBriefInput): string[] => (suite === undefined ? [] : fastSuiteLines(suite));
65
+
66
+ function previousLines(input: AuditBriefInput, line: (row: AuditRow) => string): string[] {
67
+ if (input.mode !== "resume") return [];
68
+ return previousGapsLines((input.previousGaps ?? []).map(line));
69
+ }
70
+
71
+ function precedentLines({ precedents }: AuditBriefInput): string[] {
72
+ const block = (precedents ?? "").trimEnd();
73
+ return block === "" ? [] : ["", block];
74
+ }
75
+
76
+ /** The capture as the brief carries it: each text while there is room, then the files left to read. */
77
+ function captureLines(input: AuditBriefInput, room: number): string[] {
78
+ if (input.captureTexts === undefined) return captureFilesToReadLines(input.captureFiles);
79
+ const blocks: string[] = [];
80
+ const carried = new Set<string>();
81
+ let left = Math.min(INLINE_CAPTURE_CHARS, room);
82
+ for (const { path, text } of input.captureTexts) {
83
+ const block = captureTextBlock(path.slice(path.lastIndexOf("/") + 1), text);
84
+ if (block.length + 1 > left) continue;
85
+ blocks.push(block);
86
+ carried.add(path);
87
+ left -= block.length + 1;
88
+ }
89
+ const toRead = input.captureFiles.filter((path) => !carried.has(path));
90
+ const lines = blocks.length > 0 ? captureInBriefLines(blocks) : [];
91
+ if (toRead.some((path) => !CAPTURE_FRAME.test(path))) {
92
+ lines.push(...(lines.length > 0 ? [""] : []), ...captureLeftToReadLines(toRead));
93
+ }
94
+ return lines;
95
+ }
96
+
97
+ /** The sheet as the brief carries it, or nothing (left to read from its path). */
98
+ function sheetLines(input: AuditBriefInput, room: number): string[] {
99
+ const text = input.sheetText?.trimEnd() ?? "";
100
+ if (text === "" || text.length > Math.min(INLINE_SHEET_CHARS, room)) return [];
101
+ return sheetInBriefLines(text);
102
+ }
103
+
104
+ export function buildAuditBrief(input: AuditBriefInput): string {
105
+ const rest = [
106
+ "",
107
+ ...validationCommandLines(input.commands),
108
+ ...suiteLines(input),
109
+ ...previousLines(input, auditRowLine),
110
+ ...precedentLines(input),
111
+ ...mechanicalTableLines(input.table.trimEnd()),
112
+ ];
113
+ const head = [...scopeLines(input), ...projectLines(input)];
114
+ const sheet = sheetLines(input, MAX_BRIEF_CHARS - BRIEF_MARGIN - [...head, "", ...rest].join("\n").length);
115
+ const room = MAX_BRIEF_CHARS - BRIEF_MARGIN - [...head, "", ...sheet, ...rest].join("\n").length;
116
+ return [...head, "", ...sheet, ...captureLines(input, room), ...rest].join("\n");
117
+ }
118
+
119
+ export interface ValidationReport {
120
+ command: string;
121
+ /** "exit 0", "exit 1", "timed out after 300 s", "refused: <reason>", "not run: <reason>". */
122
+ outcome: string;
123
+ /** At most 15 lines and 1 500 characters of the output, stderr after stdout. */
124
+ tail: string;
125
+ }
126
+
127
+ /** The follow-up's caps: one row of the first answer, one report's tail, room kept for the closing lines. */
128
+ const FOLLOW_UP_ROW_CHARS = 240;
129
+ const FOLLOW_UP_TAIL_CHARS = 800;
130
+ const FOLLOW_UP_MARGIN = 200;
131
+
132
+ function folderOf(path: string): string {
133
+ const slash = path.lastIndexOf("/");
134
+ return slash > 0 ? path.slice(0, slash) : ".";
135
+ }
136
+
137
+ /** A report's output, cut to its last FOLLOW_UP_TAIL_CHARS characters. */
138
+ function cutTail(tail: string): string {
139
+ const text = tail.trimEnd();
140
+ return text.length > FOLLOW_UP_TAIL_CHARS ? `…${text.slice(1 - FOLLOW_UP_TAIL_CHARS)}` : text;
141
+ }
142
+
143
+ /**
144
+ * The second brief: the first one without the capture index and the table (named by their
145
+ * folder), the first answer with each row cut, and each report with its tail cut. Rows that
146
+ * would take it past MAX_BRIEF_CHARS are left out and counted.
147
+ */
148
+ export function buildValidationFollowUp(input: AuditBriefInput, first: AuditAnswer, reports: readonly ValidationReport[]): string {
149
+ const capped = (row: AuditRow): string => cut(auditRowLine(row), FOLLOW_UP_ROW_CHARS);
150
+ const folder = input.captureFiles.length > 0 ? folderOf(input.captureFiles[0]) : THE_CAPTURE_FOLDER;
151
+ const head = [
152
+ ...scopeLines(input),
153
+ "",
154
+ ...validationCommandLines(input.commands),
155
+ ...suiteLines(input),
156
+ ...previousLines(input, capped),
157
+ ...firstAnswerLines(folder, first.verdict),
158
+ ];
159
+ const sections = reports.map((r) => validationReportSection(r.command, r.outcome, cutTail(r.tail)));
160
+ const tail = [
161
+ validationsNamedLine(first.validations.map((v) => cut(v, FOLLOW_UP_ROW_CHARS))),
162
+ ...first.undecided.map((u) => cut(undecidedLine(u.check, u.reason), FOLLOW_UP_ROW_CHARS)),
163
+ ...validationReportsLines(sections),
164
+ ];
165
+ let room = MAX_BRIEF_CHARS - FOLLOW_UP_MARGIN - head.join("\n").length - tail.join("\n").length;
166
+ const rows: string[] = [];
167
+ for (const [i, row] of first.rows.entries()) {
168
+ const line = ` ${capped(row)}`;
169
+ if (line.length + 1 > room) {
170
+ rows.push(rowsLeftOutLine(first.rows.length - i));
171
+ break;
172
+ }
173
+ rows.push(line);
174
+ room -= line.length + 1;
175
+ }
176
+ if (first.rows.length === 0) rows.push(NO_ROWS_LINE);
177
+ return [...head, ...rows, ...tail].join("\n");
178
+ }
179
+
180
+ const MAX_REPLY_CHARS_IN_ANSWER_PROMPT = 12_000;
181
+
182
+ export function buildAnswerPrompt(reply: string, problems: readonly string[]): string {
183
+ const text = reply.length > MAX_REPLY_CHARS_IN_ANSWER_PROMPT
184
+ ? earlierTextCut(reply.slice(-MAX_REPLY_CHARS_IN_ANSWER_PROMPT))
185
+ : reply;
186
+ return auditAnswerPrompt(text, problems);
187
+ }