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,36 @@
1
+ // The cycles of a run: consecutive open steps whose `## Anchors` row names the same first test file are one
2
+ // behaviour, run as one cycle - every step's RED before any production line, then one GREEN and one Cost for
3
+ // them all (the harness groups the steps that share a test class; the file is what code can see). A step alone
4
+ // on its file is a cycle of one. Pure.
5
+ import type { ImplementStep } from "./step-section.ts";
6
+ import { testFileOf } from "./contracts.ts";
7
+ import { NO_TEST_FILE } from "./messages.ts";
8
+
9
+ export interface Cycle { steps: ImplementStep[]; testFile: string | null }
10
+
11
+ export function cyclesOf(open: readonly ImplementStep[]): Cycle[] {
12
+ const out: Cycle[] = [];
13
+ for (const step of open) {
14
+ const file = testFileOf(step);
15
+ const last = out[out.length - 1];
16
+ if (last !== undefined && file !== null && last.testFile === file && last.steps[last.steps.length - 1].number + 1 === step.number) {
17
+ last.steps.push(step);
18
+ } else {
19
+ out.push({ steps: [step], testFile: file });
20
+ }
21
+ }
22
+ return out;
23
+ }
24
+
25
+ /** `steps 1-2`, `step 3`, `steps 1, 3`. */
26
+ export function stepsLabel(steps: readonly ImplementStep[]): string {
27
+ if (steps.length === 1) return `step ${steps[0].number}`;
28
+ const numbers = steps.map((s) => s.number);
29
+ const run = numbers.every((n, i) => i === 0 || n === numbers[i - 1] + 1);
30
+ return run ? `steps ${numbers[0]}-${numbers[numbers.length - 1]}` : `steps ${numbers.join(", ")}`;
31
+ }
32
+
33
+ /** The line announcing the mapping, before the first RED. */
34
+ export function cyclesLine(cycles: readonly Cycle[]): string {
35
+ return cycles.map((c, i) => `cycle ${i + 1}/${cycles.length} — ${stepsLabel(c.steps)} (${c.testFile ?? NO_TEST_FILE})`).join("; ");
36
+ }
@@ -0,0 +1,29 @@
1
+ // The budget of one dev-implement run, sized to the steps it has to run (temp/02 G-29): each step
2
+ // is two acts and two test runs; the batch ends with the build and the whole suite, each bounded
3
+ // by SUITE_LIMIT_SECONDS. The close run (commit, push, pull request) gets a fixed budget. Pure.
4
+ import type { StepBudget } from "../../../shared/domain/dev/step-budget.ts";
5
+ import { IMPLEMENTER, TEST_AUTHOR } from "./roles.ts";
6
+
7
+ /** The longest a final build or suite may run before the batch stops, in seconds. */
8
+ export const SUITE_LIMIT_SECONDS = 3600;
9
+ /** The longest wait between two looks at a running suite, in seconds; the first waits are shorter. */
10
+ export const SLICE_SECONDS = 20;
11
+ export const DEFAULT_STEPS = 3;
12
+ export const MAX_STEPS = 12;
13
+
14
+ export const CLOSE_BUDGET: StepBudget = { toolCalls: 40, wallTime: 900, contextTokens: 50_000, delegationDepth: 0 };
15
+
16
+ /** The steps to size for: a whole number from 1 to MAX_STEPS; DEFAULT_STEPS when not given or not a number. */
17
+ export function stepsToSize(value: unknown): number {
18
+ const n = typeof value === "number" && Number.isFinite(value) ? Math.floor(value) : DEFAULT_STEPS;
19
+ return Math.max(1, Math.min(MAX_STEPS, n));
20
+ }
21
+
22
+ /** One step's tool calls: both roles' whole iterations, the Cost re-ask and code's own test runs. */
23
+ export const STEP_TOOL_CALLS = TEST_AUTHOR.maxIterations + IMPLEMENTER.maxIterations + 10;
24
+
25
+ export function implementBudget(input: { steps?: unknown; close?: unknown }): StepBudget {
26
+ if (input.close === true) return CLOSE_BUDGET;
27
+ const s = stepsToSize(input.steps);
28
+ return { toolCalls: STEP_TOOL_CALLS * s + 40, wallTime: 900 * s + 2 * SUITE_LIMIT_SECONDS, contextTokens: 150_000 * s, delegationDepth: 0 };
29
+ }
@@ -0,0 +1,23 @@
1
+ // The markers of /dev-implement: the headings, titles and lines a brief or a sheet edit writes and a parser of the
2
+ // crew reads back (ADR 0026).
3
+
4
+ /** The title of a correction step, `Correction C<k> — <finding>`, written by correction.ts and read by the briefs. */
5
+ export const CORRECTION_TITLE = /^Correction C(\d+) — (.*)$/;
6
+
7
+ /** The same title read by the briefs, its label (`C<k>`) whole. */
8
+ export const CORRECTION_LABEL = /^Correction (C\d+) — (.*)$/;
9
+
10
+ export const correctionTitle = (k: number, finding: string): string => `Correction C${k} — ${finding}`;
11
+
12
+ /** The first line of the stale block: what the review of the batch left open once its dependencies merged. */
13
+ export const STALE_HEADING = "Stale after the merged dependencies (the reviewer's open questions; settle each by the delivered value it names, or say why not):";
14
+
15
+ // ── The implementer's Cost line ─────────────────────────────────────────────
16
+
17
+ const PLACE = "(?:a |any |one )?(?:loops?|lambdas?|memory filters?)";
18
+ /** The one "where" that clears a line naming a loop, a lambda or a memory filter: none of them holds a port call. */
19
+ export const NONE_WHERE = new RegExp(
20
+ `^(?:none|nothing|no port call(?: (?:in|inside|within) ${PLACE}(?:,? (?:or |nor )?${PLACE})*)?)\\.?$`, "i");
21
+
22
+ /** The opening of every stop at a batch's close: the close writes it, /dev-batches reads it to tell a close stop. */
23
+ export const CLOSE_STOP = "BLOCKED — close:";
@@ -0,0 +1,58 @@
1
+ // The problems the domain of /dev-implement states: why a test command, a correction, a tick or a step check does
2
+ // not hold (ADR 0026).
3
+
4
+ // ── Test commands (contracts.ts) ────────────────────────────────────────────
5
+
6
+ export const stepNamesNoTestFile = (step: number): string => `step ${step} names no test file in ## Anchors`;
7
+ export const PACK_HAS_NO_CLASS_OR_PROJECT_TEST = "the pack has no commands.test_class or commands.test_project";
8
+ export const PACK_HAS_NO_TEST_PROJECT = "the pack has no commands.test_project";
9
+
10
+ // ── Corrections (correction.ts) ─────────────────────────────────────────────
11
+
12
+ export const CORRECTION_NAMES_NO_FINDING = "the correction names no finding: — correction: <finding>";
13
+ export const findingNamesUnknownIds = (ids: readonly string[]): string =>
14
+ `the finding names ${ids.join(", ")}, which the sheet does not carry: a new id changes the scope ` +
15
+ "(/dev-spec <code> <kind> for the change, then /dev-plan), never a correction";
16
+ export const NO_STEP_TO_CORRECT = "the sheet has no step with a test file to correct";
17
+ export const SHEET_LACKS_TDD_OR_ANCHORS = "the sheet lacks ## TDD sequence or ## Anchors";
18
+ export const ANCHORS_HAVE_NO_ROW = "the sheet's ## Anchors has no row";
19
+ export const correctsStep = (number: number, title: string): string => `Corrects step ${number} (${title}); its earlier evidence stays.`;
20
+ export const correctionTestRow = (k: number, level: string, project: string, ids: string): string =>
21
+ `| 1 | \`C${k}: the test the author names\` | ${level} | \`${project}\` | ${ids} |`;
22
+
23
+ // ── Cycles (cycles.ts) ──────────────────────────────────────────────────────
24
+
25
+ export const NO_TEST_FILE = "no test file";
26
+
27
+ // ── Ticks (sheet-ticks.ts) ──────────────────────────────────────────────────
28
+
29
+ export const sheetHasNoStep = (step: number): string => `the sheet has no step ${step}`;
30
+ export const stepHasNoTddLine = (step: number): string => `step ${step} has no TDD line`;
31
+ export const notTheTddLine = (line: number, step: number): string => `line ${line} is not step ${step}'s TDD line`;
32
+ export const tddLineHasNoBox = (step: number, box: string): string => `step ${step}'s TDD line has no ${box} box`;
33
+
34
+ // ── Step checks (step-checks.ts) ────────────────────────────────────────────
35
+
36
+ export const testsDidNotRun = (reason: string): string => `the step's tests did not run: ${reason}`;
37
+ export const TESTS_TIMED_OUT = "the step's tests timed out";
38
+ export const TEST_AUTHOR_CHANGED_NOTHING = "the test author changed no file";
39
+ export const productionChangedBeforeRed = (paths: readonly string[]): string =>
40
+ `a production path changed before a red test: ${paths.join(", ")}`;
41
+ export const onlyStubsChanged = (paths: readonly string[]): string =>
42
+ `the test author changed no test file, only stubs: ${paths.join(", ")}`;
43
+ export const NEW_TESTS_PASS_AT_ONCE = "the new tests pass at once: a test green before its code is never kept";
44
+ export const noFailureAdded = (before: number, after: number): string =>
45
+ `the new tests add no failure (failures ${before} → ${after}): a test green before its code is never kept`;
46
+ export const testFileChangedAtGreen = (paths: readonly string[]): string =>
47
+ `a test file changed while turning it green: ${paths.join(", ")}`;
48
+ export const testsStillFail = (exit: number): string => `the step's tests still fail (exit ${exit})`;
49
+ export const GREEN_BY_ITSELF =
50
+ "the implementer changed no file, yet the tests that failed before now pass: a test that turns green by itself is flaky";
51
+ export const NO_COST_LINE = "the implementer stated no Cost line";
52
+ export const portCallInLoop = (line: string): string =>
53
+ `a port call in a loop, a lambda or a memory filter: back to /dev-plan (${line})`;
54
+
55
+ // ── The sheet (step-section.ts) ─────────────────────────────────────────────
56
+
57
+ export const anchorsRowNamesMissingStep = (step: string): string => `an Anchors row names step ${step}, which the sheet lacks`;
58
+ export const tddLineWithoutTest = (step: number): string => `step ${step} has a TDD line and no test`;
@@ -0,0 +1,93 @@
1
+ // The prompts of /dev-implement: the system texts of its two roles and the prose of the RED and GREEN briefs that
2
+ // contracts.ts assembles from the sheet (ADR 0026).
3
+
4
+ // ── The roles (roles.ts) ────────────────────────────────────────────────────
5
+
6
+ export const TEST_AUTHOR_SYSTEM = [
7
+ "You are the test author of one step of a dev batch. You write the failing tests the brief names, in the test",
8
+ "file it names, and nothing else: no production line. The one exception is the signature stubs the brief allows",
9
+ "in production files still to create: declarations that throw \"not implemented\", no logic, so that the tests",
10
+ "compile. A test that fails on a missing symbol is red.",
11
+ ];
12
+
13
+ export const IMPLEMENTER_SYSTEM = [
14
+ "You are the implementer of one step of a dev batch. You write the least production code that turns the red",
15
+ "tests of the brief green, then refactor and delete what that orphaned. Test files are read-only to you.",
16
+ "You end your answer with the step's Cost line.",
17
+ ];
18
+
19
+ // ── The parts of a brief (contracts.ts) ─────────────────────────────────────
20
+
21
+ export const STUB_EXISTING = "existing: only a declaration the new tests import and it lacks";
22
+ export const STUB_OF_EARLIER_RED = "a stub an earlier RED of this cycle wrote";
23
+ export const THE_TEST_FILES = "the test files";
24
+ export const NONE_NAMED = "none named";
25
+ export const NO_ID = "no id";
26
+
27
+ export const ASSUMPTION_RULE = "A question that changes no scope, id or design decision is settled by you: say it as a line " +
28
+ "`Assumption: <what you assumed>`, only for a behaviour the plan leaves open (an error, a rounding, an edge), once. " +
29
+ "A test value, a stub's wording or a file's state is your choice or a fact, never an assumption. Never one the " +
30
+ "sheet's `## Assumptions` already holds, in any wording: the sheet is in your brief, and an assumption is recorded " +
31
+ "once per batch.";
32
+
33
+ export const memberRefLine = (at: string, member: string | undefined): string =>
34
+ `\`${at}\` — \`${member}\` (read that member with node_read, never the file whole)`;
35
+
36
+ export const TEST_FILE_IN_BRIEF = "its text is in this brief (node_outline for the anchor at most): add the tests with node_insert inside its suite, never rewrite it whole";
37
+ export const TEST_FILE_TO_CREATE = "create it with file_write; once it exists, add to it by node";
38
+ export const TEST_FILE_EXISTING = "read it by node (node_outline, then node_read), add the tests with node_insert inside its suite, never rewrite it whole";
39
+
40
+ export const UNIT_LEVEL_RULE = "- unit: no IO; the ports are the doubles the Anchors row names, the builders it names reused, never a new double of the same port.";
41
+ export const INTEGRATION_LEVEL_RULE = "- integration: the real adapter the test policy names, its fixture shared, nothing faked inside the adapter.";
42
+ export const ANY_LEVEL_RULE = "- the level the table names";
43
+
44
+ export const oneStep = (number: number, title: string): string => `step ${number}: ${title}`;
45
+ export const stepsOfOneBehaviour = (numbers: string, titles: string): string => `steps ${numbers} (one behaviour): ${titles}`;
46
+ export const briefTitle = (role: string, code: string, batch: string, what: string): string => `# ${role} — ${code} batch ${batch}, ${what}`;
47
+ export const sheetLine = (sheetPath: string, ids: string): string =>
48
+ `Sheet: \`${sheetPath}\` (do not edit it: code ticks its boxes). Ids: ${ids}.`;
49
+ export const testRow = (index: number, name: string, level: string, project: string, ids: string): string =>
50
+ `${index}. \`${name}\` — ${level}, project \`${project}\`, ${ids}`;
51
+
52
+ export const IN_THIS_BRIEF_HEADING = "## In this brief (do not open these files again)";
53
+
54
+ // ── The RED brief ───────────────────────────────────────────────────────────
55
+
56
+ export const TESTS_TO_WRITE_HEADING = "## The tests to write";
57
+ export const correctionOfFinding = (label: string, finding: string): string => `A correction (${label}) of an audit's finding: ${finding}`;
58
+ export const WRITE_FAILING_TESTS_FOR_FINDING = "Write the test (or tests) that fail on this finding today; the names are yours, in the style of the file.";
59
+ export const FILES_HEADING = "## Files";
60
+ export const testFileLine = (ref: string, rule: string): string => `- test file: ${ref} — ${rule}`;
61
+ export const doublesLine = (doubles: string): string => `- shared doubles and builders: ${doubles}`;
62
+ export const SIGNATURE_STUB_AT_MOST = "a signature stub at most";
63
+ export const READ_ONLY_NEVER_WRITE = "read only, never write";
64
+ export const productionLine = (access: string, ref: string): string => `- production it will drive (${access}): ${ref}`;
65
+ export const RULES_HEADING = "## Rules";
66
+ export const testFilesOnlyRule = (where: string): string =>
67
+ `- Write test files only (${where}): no production line; a test failing on a missing symbol is red.`;
68
+ export const stubsRule = (stubs: string): string =>
69
+ `- The one exception: signature stubs, declarations that throw "not implemented" and hold no logic, in ${stubs}.`;
70
+ export const STUB_IMPORT_RULE = "- A test whose import of a missing declaration fails the whole test file is not the red asked: stub the declaration, never work around the import.";
71
+ export const ONE_TEST_PER_ROW_RULE = "- One test per row of the table, its name as written; the passing path first, then the refusals.";
72
+ export const redRunRule = (command: string): string =>
73
+ `- Run \`${command}\` with run_tests once the tests are written: every new test must fail; the result lists the failed tests, so the log stays closed. Code runs it again after you.`;
74
+ export const RED_ANSWER = "Answer with the test names you wrote, the test file, and the reason each one fails.";
75
+
76
+ // ── The GREEN brief ─────────────────────────────────────────────────────────
77
+
78
+ export const STUBBED_AT_RED = "existing (stubbed at RED)";
79
+ export const inThisBrief = (line: string): string => `${line}, in this brief`;
80
+ export const RED_TESTS_HEADING = "## The red tests";
81
+ export const stepLabel = (number: number, title: string): string => `Step ${number} — ${title}:`;
82
+ export const lastRedRun = (inBrief: boolean, files: string, log: string | null): string =>
83
+ `Test file (read only${inBrief ? ", in this brief" : ""}): ${files}. Last red run${log === null ? "" : ` (whole output: \`${log}\`)`}:`;
84
+ export const PRODUCTION_HEADING = "## Production";
85
+ export const NONE_LISTED = "none listed";
86
+ export const CODE_ELEMENTS_LINE = "Code elements of the batch:";
87
+ export const appliedRulesLine = (rules: string, cost: string): string =>
88
+ `Applied rules: ${rules || NONE_NAMED}. Expected access cost: ${cost || "not stated"}.`;
89
+ export const neverWriteTestRule = (where: string): string => `- Never write a test file (${where}): the tests are read-only to you.`;
90
+ export const LEAST_CODE_RULE = "- The least code that turns these tests green; then refactor, and delete what that orphaned.";
91
+ export const greenRunRule = (command: string): string =>
92
+ `- Run \`${command}\` with run_tests until it passes; run_build when the build is in doubt. Code runs the tests again after you.`;
93
+ export const GREEN_ANSWER = "Answer with the files you changed and one line `Cost: <reads> reads, <writes> writes; <where a port call sits in a loop, a lambda or a memory filter, or none>`.";
@@ -0,0 +1,49 @@
1
+ // The two writing roles of a batch step, run as two acts of the crew's one agent (RT-04): each act
2
+ // is offered its own tools out of the agent's, and runs under its own role's deny rules
3
+ // (step-rules.ts ROLE_ROOTS): the test author writes no production file, the implementer no test
4
+ // file, and neither rewrites an existing source file whole (the rewrite rule): both read and edit by
5
+ // node. Neither gets shell_command: tests and builds go through run_tests and run_build. Pure.
6
+ import { BOUNDED_READ_RULE, KNOWN_TOOLS_RULE, NODE_EDIT_RULE, NODE_READ_RULE } from "../../../shared/domain/dev/reading-rule.ts";
7
+ import { IMPLEMENTER_SYSTEM, TEST_AUTHOR_SYSTEM } from "./prompts.ts";
8
+
9
+ export type RoleName = "test-author" | "implementer";
10
+
11
+ export interface RoleSpec {
12
+ name: RoleName;
13
+ system: string;
14
+ tools: readonly string[];
15
+ maxIterations: number;
16
+ }
17
+
18
+ const READ_TOOLS = ["file_read", "node_outline", "node_read", "glob", "grep"] as const;
19
+ const WRITE_TOOLS = ["file_write", "edit_file", "node_replace", "node_insert", "node_ensure", "edit_batch"] as const;
20
+
21
+ export const TEST_AUTHOR: RoleSpec = {
22
+ name: "test-author",
23
+ system: [
24
+ ...TEST_AUTHOR_SYSTEM,
25
+ NODE_READ_RULE,
26
+ BOUNDED_READ_RULE,
27
+ NODE_EDIT_RULE,
28
+ KNOWN_TOOLS_RULE,
29
+ ].join(" "),
30
+ tools: [...READ_TOOLS, ...WRITE_TOOLS, "run_tests", "memory_recall"],
31
+ maxIterations: 40,
32
+ };
33
+
34
+ export const IMPLEMENTER: RoleSpec = {
35
+ name: "implementer",
36
+ system: [
37
+ ...IMPLEMENTER_SYSTEM,
38
+ NODE_READ_RULE,
39
+ BOUNDED_READ_RULE,
40
+ NODE_EDIT_RULE,
41
+ KNOWN_TOOLS_RULE,
42
+ ].join(" "),
43
+ tools: [...READ_TOOLS, ...WRITE_TOOLS, "run_tests", "run_build", "memory_recall"],
44
+ maxIterations: 60,
45
+ };
46
+
47
+ /** Every tool the crew's agent holds: the union of the two roles' tools, the script tools apart
48
+ * (run_tests, run_build, memory_recall: attached, never named). */
49
+ export const CREW_TOOLS: readonly string[] = [...READ_TOOLS, ...WRITE_TOOLS];
@@ -0,0 +1,76 @@
1
+ // The other lines code writes into a batch sheet and its global plan, besides the TDD boxes: the assumptions a
2
+ // role settled mid-batch (rows `| H<n> | <text> | the user |` of `## Assumptions`), and at the close
3
+ // the done marks - the sheet's title ` — done (<date>)`, the plan's `### Batch F<n> — <Name> — done (<date>)` and
4
+ // its step boxes ticked. Each edit is idempotent. Pure, never throws.
5
+ import {
6
+ ASSUMPTIONS_SECTION, ASSUMPTIONS_TABLE_HEAD as TABLE_HEAD, DECISIONS_SECTION,
7
+ } from "../../../shared/domain/dev/markers.ts";
8
+ import { parseBatchSheet, unfencedLines } from "../../../shared/domain/dev/plan-format.ts";
9
+
10
+ /** An answer's way of saying it assumed nothing: `none`, `none needed — …`, `n/a`, `nothing`. */
11
+ const NO_ASSUMPTION = /^(?:none|n\/a|nothing)\b/i;
12
+
13
+ /** The `Assumption: <text>` lines of a role's answer, in order, once each; a line that assumes nothing is no row. */
14
+ export function assumptionsOf(answer: string): string[] {
15
+ const out: string[] = [];
16
+ for (const raw of answer.split("\n")) {
17
+ const m = /^\s*(?:[-*]\s*)?\**Assumption\**\s*:\s*(.+)$/i.exec(raw);
18
+ const text = m?.[1].replace(/\s+/g, " ").replace(/\|/g, "/").trim();
19
+ if (text && !NO_ASSUMPTION.test(text) && !out.includes(text)) out.push(text);
20
+ }
21
+ return out;
22
+ }
23
+
24
+ /** The sheet with each new assumption as an `H<n>` row of the `## Assumptions` table (`/dev-plan` renders it empty;
25
+ * the section created before `## Decisions`, else at the end), numbered after the rows it holds, the list lines of
26
+ * older sheets counted; an assumption already written is not written again. */
27
+ export function addAssumptions(text: string, assumptions: readonly string[]): { text: string; added: string[] } {
28
+ if (assumptions.length === 0) return { text, added: [] };
29
+ const held = parseBatchSheet(text).assumptions ?? [];
30
+ const known = new Set(held.map((a) => a.assumption));
31
+ let n = held.reduce((max, a) => Math.max(max, Number(a.id.slice(1))), 0);
32
+ const added = assumptions.filter((a) => !known.has(a));
33
+ if (added.length === 0) return { text, added: [] };
34
+ const rows = added.map((a) => `| H${++n} | ${a} | the user |`);
35
+ const raw = text.split("\n");
36
+ const lines = unfencedLines(text);
37
+ const at = lines.findIndex((l) => l.text.trim() === ASSUMPTIONS_SECTION);
38
+ if (at >= 0) {
39
+ const next = lines.slice(at + 1).find((l) => l.text.startsWith("## "));
40
+ let end = next === undefined ? raw.length : next.line - 1;
41
+ while (end > lines[at].line && raw[end - 1].trim() === "") end--;
42
+ const body = raw.slice(lines[at].line, end);
43
+ // A section without the table (or with list lines after it) gets a table of its own after what it holds.
44
+ const table = body.length > 0 && body.at(-1)!.trim().startsWith("|") && body.some((l) => l.trim() === TABLE_HEAD[0]);
45
+ raw.splice(end, 0, ...(table ? rows : [...(body.length > 0 ? [""] : []), ...TABLE_HEAD, ...rows]));
46
+ return { text: raw.join("\n"), added };
47
+ }
48
+ const decisions = lines.find((l) => l.text.trim() === DECISIONS_SECTION);
49
+ const block = [ASSUMPTIONS_SECTION, ...TABLE_HEAD, ...rows, ""];
50
+ if (decisions !== undefined) raw.splice(decisions.line - 1, 0, ...block);
51
+ else raw.push(...(raw[raw.length - 1]?.trim() === "" ? [] : [""]), ...block);
52
+ return { text: raw.join("\n"), added };
53
+ }
54
+
55
+ /** The sheet's title with ` — done (<date>)`; unchanged when it already says done. */
56
+ export function markSheetDone(text: string, date: string): string {
57
+ const lines = text.split("\n");
58
+ const at = lines.findIndex((l) => /^# \S+-PLAN-F\d+ — /.test(l));
59
+ if (at < 0 || / — done \(\d{4}-\d{2}-\d{2}\)$/.test(lines[at].trimEnd())) return text;
60
+ lines[at] = `${lines[at].trimEnd()} — done (${date})`;
61
+ return lines.join("\n");
62
+ }
63
+
64
+ /** The global plan with `### Batch <batch> — <Name> — open` made `— done (<date>)` and that batch's `- [ ]` boxes
65
+ * ticked; unchanged when the batch is not found or is done already. */
66
+ export function markPlanBatchDone(text: string, batch: string, date: string): string {
67
+ const lines = text.split("\n");
68
+ const head = new RegExp(`^### Batch ${batch} — (.+) — open$`);
69
+ const at = lines.findIndex((l) => head.test(l.trimEnd()));
70
+ if (at < 0) return text;
71
+ lines[at] = lines[at].trimEnd().replace(/ — open$/, ` — done (${date})`);
72
+ for (let i = at + 1; i < lines.length && !lines[i].startsWith("#"); i++) {
73
+ lines[i] = lines[i].replace(/^(\s*)- \[ \] /, "$1- [x] ");
74
+ }
75
+ return lines.join("\n");
76
+ }
@@ -0,0 +1,23 @@
1
+ // Ticking one box of one step's `TDD:` line, after code observed what the box stands for: the
2
+ // line of that step only, nothing else of the sheet. Idempotent: a box already ticked stays.
3
+ // Pure, never throws: what cannot be ticked comes back as a problem.
4
+ import { parseBatchSheet } from "../../../shared/domain/dev/plan-format.ts";
5
+ import { notTheTddLine, sheetHasNoStep, stepHasNoTddLine, tddLineHasNoBox } from "./messages.ts";
6
+
7
+ export type TddBox = "RED" | "GREEN" | "COST";
8
+
9
+ export type Ticked = { ok: true; text: string } | { ok: false; problem: string };
10
+
11
+ export function tickBox(sheet: string, step: number, box: TddBox): Ticked {
12
+ const found = parseBatchSheet(sheet).steps.find((s) => s.number === step);
13
+ if (found === undefined) return { ok: false, problem: sheetHasNoStep(step) };
14
+ if (found.tdd === null) return { ok: false, problem: stepHasNoTddLine(step) };
15
+ const lines = sheet.split("\n");
16
+ const at = found.tdd.line - 1;
17
+ const line = lines[at] ?? "";
18
+ if (!line.startsWith("TDD:")) return { ok: false, problem: notTheTddLine(found.tdd.line, step) };
19
+ const box_ = new RegExp(`${box} \\[[ xX]\\]`);
20
+ if (!box_.test(line)) return { ok: false, problem: tddLineHasNoBox(step, box) };
21
+ lines[at] = line.replace(new RegExp(`${box} \\[[ xX]\\]`), `${box} [x]`);
22
+ return { ok: true, text: lines.join("\n") };
23
+ }
@@ -0,0 +1,137 @@
1
+ // The hard checks between two acts of a step, on what code observed, never on a role's word: the
2
+ // paths the act changed (two snapshots of the tree), and the narrow test run code made after it.
3
+ // RED holds when only test files changed and the tests fail; GREEN when no test file changed and
4
+ // the tests pass. The implementer's Cost line is read here too. Pure.
5
+ import { NONE_WHERE } from "./markers.ts";
6
+ import {
7
+ GREEN_BY_ITSELF, NEW_TESTS_PASS_AT_ONCE, NO_COST_LINE, TEST_AUTHOR_CHANGED_NOTHING, TESTS_TIMED_OUT, noFailureAdded, onlyStubsChanged,
8
+ portCallInLoop, productionChangedBeforeRed, testFileChangedAtGreen, testsDidNotRun, testsStillFail,
9
+ } from "./messages.ts";
10
+
11
+ /** A tree snapshot: path → hash of its content; null when the content was not read. */
12
+ export type Snapshot = ReadonlyMap<string, string | null>;
13
+
14
+ /** What code's own test run gave: its exit, or why it did not run. */
15
+ export type ObservedRun = { ran: true; exit: number; timedOut: boolean; log: string | null } | { ran: false; reason: string };
16
+
17
+ /** Paths `git status --porcelain=v1` lists: both sides of a rename, quotes removed, `.orkeon/` left out. */
18
+ export function statusPaths(porcelain: string): string[] {
19
+ const out: string[] = [];
20
+ for (const raw of porcelain.split("\n")) {
21
+ if (raw.length < 4) continue;
22
+ for (const part of raw.slice(3).split(" -> ")) {
23
+ const path = unquote(part.trim());
24
+ if (path !== "" && !path.startsWith(".orkeon/") && !out.includes(path)) out.push(path);
25
+ }
26
+ }
27
+ return out;
28
+ }
29
+
30
+ function unquote(path: string): string {
31
+ if (!(path.startsWith('"') && path.endsWith('"'))) return path;
32
+ return path.slice(1, -1).replace(/\\(["\\])/g, "$1");
33
+ }
34
+
35
+ /** The paths whose presence or content differs between two snapshots, sorted. */
36
+ export function changedPaths(before: Snapshot, after: Snapshot): string[] {
37
+ const paths = new Set([...before.keys(), ...after.keys()]);
38
+ return [...paths].filter((p) => {
39
+ if (!before.has(p) || !after.has(p)) return true;
40
+ const a = before.get(p);
41
+ const b = after.get(p);
42
+ // Unread on both sides (too large, binary, or past the snapshot's cap): not a change code saw; a role's
43
+ // own write to it is still counted, from the paths its write tools named.
44
+ if (a === null && b === null) return false;
45
+ return a !== b;
46
+ }).sort();
47
+ }
48
+
49
+ export { under } from "../../../shared/domain/dev/test-paths.ts";
50
+
51
+ /** Tells a test file from a production one, by the pack (shared/domain/dev/test-paths.ts). */
52
+ export type IsTest = (path: string) => boolean;
53
+
54
+ function runProblem(run: ObservedRun): string | null {
55
+ if (!run.ran) return testsDidNotRun(run.reason);
56
+ if (run.timedOut) return TESTS_TIMED_OUT;
57
+ return null;
58
+ }
59
+
60
+ /** Why RED does not hold; null when it does. `stubs` are the production files the step marks `to create`, which
61
+ * the test author may write as signature stubs. */
62
+ export function redProblem(changed: readonly string[], isTest: IsTest, run: ObservedRun, stubs: readonly string[] = []): string | null {
63
+ if (changed.length === 0) return TEST_AUTHOR_CHANGED_NOTHING;
64
+ const outside = changed.filter((p) => !isTest(p) && !stubs.includes(p));
65
+ if (outside.length > 0) return productionChangedBeforeRed(outside);
66
+ if (!changed.some(isTest)) return onlyStubsChanged(changed);
67
+ const problem = runProblem(run);
68
+ if (problem !== null) return problem;
69
+ if (run.ran && run.exit === 0) return NEW_TESTS_PASS_AT_ONCE;
70
+ return null;
71
+ }
72
+
73
+ const FAILURE_COUNTS = [
74
+ /\b(\d+)\s+(?:failed|failing|failures?)\b/gi,
75
+ /\b(?:failed|failures?|fail)\s*[:=]?\s+(\d+)\b/gi,
76
+ ];
77
+
78
+ /** The failure count a test run's tail shows last (`2 failed`, `fail 2`, `Failed: 2`), or null when it shows none. */
79
+ export function failureCount(tail: string): number | null {
80
+ let last: { at: number; n: number } | null = null;
81
+ for (const re of FAILURE_COUNTS) {
82
+ for (const m of tail.matchAll(re)) {
83
+ if (last === null || (m.index ?? 0) >= last.at) last = { at: m.index ?? 0, n: Number(m[1]) };
84
+ }
85
+ }
86
+ return last === null ? null : last.n;
87
+ }
88
+
89
+ /** Whether a later RED step of a cycle added a failure: its file failed already (the earlier step's tests), so the
90
+ * exit code alone cannot tell a new test that passes at once. A problem when both counts are read and none was
91
+ * added; `unknown` when a count cannot be read. `beforeTail` is the earlier run's tail, or a count already read. */
92
+ export function addedFailure(beforeTail: string | number | null, afterTail: string): { problem: string } | "ok" | "unknown" {
93
+ const before = typeof beforeTail === "string" ? failureCount(beforeTail) : beforeTail;
94
+ const after = failureCount(afterTail);
95
+ if (before === null || after === null) return "unknown";
96
+ if (after > before) return "ok";
97
+ return { problem: noFailureAdded(before, after) };
98
+ }
99
+
100
+ /** Why GREEN does not hold; null when it does. `before` is code's run just before the act: tests that failed then
101
+ * and pass now with no file changed turned green by themselves (flaky), which is never kept. */
102
+ export function greenProblem(changed: readonly string[], isTest: IsTest, run: ObservedRun, before?: ObservedRun): string | null {
103
+ const tests = changed.filter(isTest);
104
+ if (tests.length > 0) return testFileChangedAtGreen(tests);
105
+ const problem = runProblem(run);
106
+ if (problem !== null) return problem;
107
+ if (run.ran && run.exit !== 0) return testsStillFail(run.exit);
108
+ if (changed.length === 0 && before?.ran === true && before.exit !== 0) {
109
+ return GREEN_BY_ITSELF;
110
+ }
111
+ return null;
112
+ }
113
+
114
+ export type CostRead = { ok: true; line: string } | { ok: false; problem: string; line?: string };
115
+
116
+ const BLOCKING_ACCESS = /\b(loops?|lambdas?|memory filters?)\b/i;
117
+ /** A none the model explains (`none — no port, no loop over a port call`): cleared unless the reason takes it back. */
118
+ const NONE_EXPLAINED = /^(?:none|nothing)\s*(?:[—–:(]|-\s|,\s)/i;
119
+ const TAKEN_BACK = /\b(?:but|except|however|apart from|save for)\b/i;
120
+ const clearsWhere = (where: string): boolean => NONE_WHERE.test(where) || (NONE_EXPLAINED.test(where) && !TAKEN_BACK.test(where));
121
+
122
+ /** The implementer's `Cost:` line; refused when absent, or when it names a loop, a lambda or a memory filter
123
+ * anywhere but in a "where" that says no port call sits in one (`…; none`, `…; none — <its reason>`, `…; no port call in a
124
+ * loop`). */
125
+ export function readCost(answer: string): CostRead {
126
+ const match = /^\s*\**Cost\**\s*:\s*(.+)$/im.exec(answer);
127
+ if (match === null) return { ok: false, problem: NO_COST_LINE };
128
+ const body = match[1].trim();
129
+ const line = `Cost: ${body}`;
130
+ const cut = body.indexOf(";");
131
+ const counts = cut < 0 ? body : body.slice(0, cut);
132
+ const where = cut < 0 ? "" : body.slice(cut + 1).trim();
133
+ if (BLOCKING_ACCESS.test(counts) || (BLOCKING_ACCESS.test(where) && !clearsWhere(where))) {
134
+ return { ok: false, problem: portCallInLoop(line), line };
135
+ }
136
+ return { ok: true, line };
137
+ }