smol-symphony 0.1.0 → 0.3.0

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 (627) hide show
  1. package/AGENTS.md +125 -39
  2. package/DESIGN.md +494 -273
  3. package/PRODUCT.md +2 -1
  4. package/README.md +259 -110
  5. package/SPEC.md +565 -1928
  6. package/WORKFLOW.minimal.yaml +34 -0
  7. package/WORKFLOW.template.yaml +1100 -0
  8. package/WORKFLOW.yaml +487 -0
  9. package/assets/skills/symphony-issues/SKILL.md +136 -0
  10. package/assets/symphony-mise.system.toml +68 -0
  11. package/dist/src/bin/symphony.js +30 -0
  12. package/dist/src/bin/symphony.js.map +1 -0
  13. package/dist/src/core/actions/context.js +109 -0
  14. package/dist/src/core/actions/context.js.map +1 -0
  15. package/dist/src/core/actions/parse.js +192 -0
  16. package/dist/src/core/actions/parse.js.map +1 -0
  17. package/dist/src/core/actions/plan.js +197 -0
  18. package/dist/src/core/actions/plan.js.map +1 -0
  19. package/dist/src/core/actions/predicates.js +111 -0
  20. package/dist/src/core/actions/predicates.js.map +1 -0
  21. package/dist/src/core/actions/run-fold.js +248 -0
  22. package/dist/src/core/actions/run-fold.js.map +1 -0
  23. package/dist/src/core/actions/template.js +118 -0
  24. package/dist/src/core/actions/template.js.map +1 -0
  25. package/dist/src/core/cli/args.js +116 -0
  26. package/dist/src/core/cli/args.js.map +1 -0
  27. package/dist/src/core/coerce.js +75 -0
  28. package/dist/src/core/coerce.js.map +1 -0
  29. package/dist/src/core/credential/account-id.js +20 -0
  30. package/dist/src/core/credential/account-id.js.map +1 -0
  31. package/dist/src/core/credential/adapter-config.js +136 -0
  32. package/dist/src/core/credential/adapter-config.js.map +1 -0
  33. package/dist/src/core/credential/availability.js +98 -0
  34. package/dist/src/core/credential/availability.js.map +1 -0
  35. package/dist/src/core/credential/extract.js +228 -0
  36. package/dist/src/core/credential/extract.js.map +1 -0
  37. package/dist/src/core/credential/fake-creds.js +171 -0
  38. package/dist/src/core/credential/fake-creds.js.map +1 -0
  39. package/dist/src/core/credential/identity.js +125 -0
  40. package/dist/src/core/credential/identity.js.map +1 -0
  41. package/dist/src/core/credential/shape.js +230 -0
  42. package/dist/src/core/credential/shape.js.map +1 -0
  43. package/dist/src/core/credential/strings.js +15 -0
  44. package/dist/src/core/credential/strings.js.map +1 -0
  45. package/dist/src/core/doctor/checks.js +303 -0
  46. package/dist/src/core/doctor/checks.js.map +1 -0
  47. package/dist/src/core/git/result.js +107 -0
  48. package/dist/src/core/git/result.js.map +1 -0
  49. package/dist/src/core/http/decisions.js +225 -0
  50. package/dist/src/core/http/decisions.js.map +1 -0
  51. package/dist/src/core/http/render.js +1635 -0
  52. package/dist/src/core/http/render.js.map +1 -0
  53. package/dist/src/core/http/routes.js +145 -0
  54. package/dist/src/core/http/routes.js.map +1 -0
  55. package/dist/src/core/http/views.js +181 -0
  56. package/dist/src/core/http/views.js.map +1 -0
  57. package/dist/src/core/image/managed-image.js +95 -0
  58. package/dist/src/core/image/managed-image.js.map +1 -0
  59. package/dist/src/core/issue/file.js +149 -0
  60. package/dist/src/core/issue/file.js.map +1 -0
  61. package/dist/src/core/issue/parse.js +210 -0
  62. package/dist/src/core/issue/parse.js.map +1 -0
  63. package/dist/src/core/mcp/dispatch.js +239 -0
  64. package/dist/src/core/mcp/dispatch.js.map +1 -0
  65. package/dist/src/core/mcp/post-move.js +92 -0
  66. package/dist/src/core/mcp/post-move.js.map +1 -0
  67. package/dist/src/core/mcp/protocol.js +293 -0
  68. package/dist/src/core/mcp/protocol.js.map +1 -0
  69. package/dist/src/core/mcp/url.js +162 -0
  70. package/dist/src/core/mcp/url.js.map +1 -0
  71. package/dist/src/core/path.js +63 -0
  72. package/dist/src/core/path.js.map +1 -0
  73. package/dist/src/core/reconcile/image-decide.js +48 -0
  74. package/dist/src/core/reconcile/image-decide.js.map +1 -0
  75. package/dist/src/core/reconcile/ledger.js +142 -0
  76. package/dist/src/core/reconcile/ledger.js.map +1 -0
  77. package/dist/src/core/reconcile/pr-classify.js +62 -0
  78. package/dist/src/core/reconcile/pr-classify.js.map +1 -0
  79. package/dist/src/core/reconcile/pr-decide.js +180 -0
  80. package/dist/src/core/reconcile/pr-decide.js.map +1 -0
  81. package/dist/src/core/reconcile/pr-loop.js +161 -0
  82. package/dist/src/core/reconcile/pr-loop.js.map +1 -0
  83. package/dist/src/core/reconcile/pr-notes.js +35 -0
  84. package/dist/src/core/reconcile/pr-notes.js.map +1 -0
  85. package/dist/src/core/reconcile/vm-decide.js +70 -0
  86. package/dist/src/core/reconcile/vm-decide.js.map +1 -0
  87. package/dist/src/core/reconcile/vm-reap.js +207 -0
  88. package/dist/src/core/reconcile/vm-reap.js.map +1 -0
  89. package/dist/src/core/reconcile/workspace-decide.js +162 -0
  90. package/dist/src/core/reconcile/workspace-decide.js.map +1 -0
  91. package/dist/src/core/runlog/summary.js +231 -0
  92. package/dist/src/core/runlog/summary.js.map +1 -0
  93. package/dist/src/core/runner/dispatch-config.js +95 -0
  94. package/dist/src/core/runner/dispatch-config.js.map +1 -0
  95. package/dist/src/core/runner/injection.js +61 -0
  96. package/dist/src/core/runner/injection.js.map +1 -0
  97. package/dist/src/core/runner/mise.js +210 -0
  98. package/dist/src/core/runner/mise.js.map +1 -0
  99. package/dist/src/core/runner/prompt.js +720 -0
  100. package/dist/src/core/runner/prompt.js.map +1 -0
  101. package/dist/src/core/runner/turn.js +242 -0
  102. package/dist/src/core/runner/turn.js.map +1 -0
  103. package/dist/src/core/runner/vm-plan.js +390 -0
  104. package/dist/src/core/runner/vm-plan.js.map +1 -0
  105. package/dist/src/core/schedule/admission.js +123 -0
  106. package/dist/src/core/schedule/admission.js.map +1 -0
  107. package/dist/src/core/schedule/circuit-breaker.js +111 -0
  108. package/dist/src/core/schedule/circuit-breaker.js.map +1 -0
  109. package/dist/src/core/schedule/eligibility.js +83 -0
  110. package/dist/src/core/schedule/eligibility.js.map +1 -0
  111. package/dist/src/core/schedule/reconcile-issue.js +82 -0
  112. package/dist/src/core/schedule/reconcile-issue.js.map +1 -0
  113. package/dist/src/core/schedule/retry.js +96 -0
  114. package/dist/src/core/schedule/retry.js.map +1 -0
  115. package/dist/src/core/schedule/sleep-cycle.js +133 -0
  116. package/dist/src/core/schedule/sleep-cycle.js.map +1 -0
  117. package/dist/src/core/schedule/slots.js +124 -0
  118. package/dist/src/core/schedule/slots.js.map +1 -0
  119. package/dist/src/core/schedule/tick.js +553 -0
  120. package/dist/src/core/schedule/tick.js.map +1 -0
  121. package/dist/src/core/schedule/token-fold.js +181 -0
  122. package/dist/src/core/schedule/token-fold.js.map +1 -0
  123. package/dist/src/core/state-resolve.js +86 -0
  124. package/dist/src/core/state-resolve.js.map +1 -0
  125. package/dist/src/core/vm-guards.js +278 -0
  126. package/dist/src/core/vm-guards.js.map +1 -0
  127. package/dist/src/core/workflow/derive.js +107 -0
  128. package/dist/src/core/workflow/derive.js.map +1 -0
  129. package/dist/src/core/workflow/parse.js +687 -0
  130. package/dist/src/core/workflow/parse.js.map +1 -0
  131. package/dist/src/core/workflow/prompt-probe.js +78 -0
  132. package/dist/src/core/workflow/prompt-probe.js.map +1 -0
  133. package/dist/src/core/workflow/validate.js +189 -0
  134. package/dist/src/core/workflow/validate.js.map +1 -0
  135. package/dist/src/core/workspace-key.js +19 -0
  136. package/dist/src/core/workspace-key.js.map +1 -0
  137. package/dist/src/shell/actions-runner.js +356 -0
  138. package/dist/src/shell/actions-runner.js.map +1 -0
  139. package/dist/src/shell/adapter/adapter-registry.js +45 -0
  140. package/dist/src/shell/adapter/adapter-registry.js.map +1 -0
  141. package/dist/src/shell/adapter/clock-random.js +96 -0
  142. package/dist/src/shell/adapter/clock-random.js.map +1 -0
  143. package/dist/src/shell/adapter/gondolin-dispatch-helpers.js +158 -0
  144. package/dist/src/shell/adapter/gondolin-dispatch-helpers.js.map +1 -0
  145. package/dist/src/shell/adapter/gondolin-dispatch.js +385 -0
  146. package/dist/src/shell/adapter/gondolin-dispatch.js.map +1 -0
  147. package/dist/src/shell/adapter/gondolin-image-converter.js +233 -0
  148. package/dist/src/shell/adapter/gondolin-image-converter.js.map +1 -0
  149. package/dist/src/shell/adapter/gondolin-image-fetch.js +180 -0
  150. package/dist/src/shell/adapter/gondolin-image-fetch.js.map +1 -0
  151. package/dist/src/shell/adapter/launcher-asset.js +57 -0
  152. package/dist/src/shell/adapter/launcher-asset.js.map +1 -0
  153. package/dist/src/shell/adapter/mise-config-asset.js +65 -0
  154. package/dist/src/shell/adapter/mise-config-asset.js.map +1 -0
  155. package/dist/src/shell/adapter/workflow-loader.js +304 -0
  156. package/dist/src/shell/adapter/workflow-loader.js.map +1 -0
  157. package/dist/src/shell/cli/doctor.js +268 -0
  158. package/dist/src/shell/cli/doctor.js.map +1 -0
  159. package/dist/src/shell/effect-interpreter-families.js +314 -0
  160. package/dist/src/shell/effect-interpreter-families.js.map +1 -0
  161. package/dist/src/shell/effect-interpreter.js +29 -0
  162. package/dist/src/shell/effect-interpreter.js.map +1 -0
  163. package/dist/src/shell/interp/acp-frame.js +137 -0
  164. package/dist/src/shell/interp/acp-frame.js.map +1 -0
  165. package/dist/src/shell/interp/acp-ws-conn.js +320 -0
  166. package/dist/src/shell/interp/acp-ws-conn.js.map +1 -0
  167. package/dist/src/shell/interp/acp-ws-frames.js +159 -0
  168. package/dist/src/shell/interp/acp-ws-frames.js.map +1 -0
  169. package/dist/src/shell/interp/acp-ws.js +197 -0
  170. package/dist/src/shell/interp/acp-ws.js.map +1 -0
  171. package/dist/src/shell/interp/acp.js +319 -0
  172. package/dist/src/shell/interp/acp.js.map +1 -0
  173. package/dist/src/shell/interp/credential-defaults.js +128 -0
  174. package/dist/src/shell/interp/credential-defaults.js.map +1 -0
  175. package/dist/src/shell/interp/credential-hooks.js +149 -0
  176. package/dist/src/shell/interp/credential-hooks.js.map +1 -0
  177. package/dist/src/shell/interp/credential-registry.js +226 -0
  178. package/dist/src/shell/interp/credential-registry.js.map +1 -0
  179. package/dist/src/shell/interp/credential.js +103 -0
  180. package/dist/src/shell/interp/credential.js.map +1 -0
  181. package/dist/src/shell/interp/gh.js +163 -0
  182. package/dist/src/shell/interp/gh.js.map +1 -0
  183. package/dist/src/shell/interp/git.js +28 -0
  184. package/dist/src/shell/interp/git.js.map +1 -0
  185. package/dist/src/shell/interp/log.js +213 -0
  186. package/dist/src/shell/interp/log.js.map +1 -0
  187. package/dist/src/shell/interp/process.js +178 -0
  188. package/dist/src/shell/interp/process.js.map +1 -0
  189. package/dist/src/shell/interp/runlog.js +193 -0
  190. package/dist/src/shell/interp/runlog.js.map +1 -0
  191. package/dist/src/shell/interp/timer.js +64 -0
  192. package/dist/src/shell/interp/timer.js.map +1 -0
  193. package/dist/src/shell/interp/tracker-disk.js +99 -0
  194. package/dist/src/shell/interp/tracker-disk.js.map +1 -0
  195. package/dist/src/shell/interp/tracker-parse.js +71 -0
  196. package/dist/src/shell/interp/tracker-parse.js.map +1 -0
  197. package/dist/src/shell/interp/tracker-scan.js +238 -0
  198. package/dist/src/shell/interp/tracker-scan.js.map +1 -0
  199. package/dist/src/shell/interp/tracker-write.js +91 -0
  200. package/dist/src/shell/interp/tracker-write.js.map +1 -0
  201. package/dist/src/shell/interp/tracker.js +41 -0
  202. package/dist/src/shell/interp/tracker.js.map +1 -0
  203. package/dist/src/shell/interp/tty.js +48 -0
  204. package/dist/src/shell/interp/tty.js.map +1 -0
  205. package/dist/src/shell/interp/vm.js +199 -0
  206. package/dist/src/shell/interp/vm.js.map +1 -0
  207. package/dist/src/shell/interp/workspace.js +310 -0
  208. package/dist/src/shell/interp/workspace.js.map +1 -0
  209. package/dist/src/shell/main-acp.js +78 -0
  210. package/dist/src/shell/main-acp.js.map +1 -0
  211. package/dist/src/shell/main-adapters.js +222 -0
  212. package/dist/src/shell/main-adapters.js.map +1 -0
  213. package/dist/src/shell/main-credential.js +122 -0
  214. package/dist/src/shell/main-credential.js.map +1 -0
  215. package/dist/src/shell/main-doctor.js +22 -0
  216. package/dist/src/shell/main-doctor.js.map +1 -0
  217. package/dist/src/shell/main-entry.js +46 -0
  218. package/dist/src/shell/main-entry.js.map +1 -0
  219. package/dist/src/shell/main-http-csrf.js +45 -0
  220. package/dist/src/shell/main-http-csrf.js.map +1 -0
  221. package/dist/src/shell/main-http-handler.js +389 -0
  222. package/dist/src/shell/main-http-handler.js.map +1 -0
  223. package/dist/src/shell/main-http-mcp.js +122 -0
  224. package/dist/src/shell/main-http-mcp.js.map +1 -0
  225. package/dist/src/shell/main-http-views.js +253 -0
  226. package/dist/src/shell/main-http-views.js.map +1 -0
  227. package/dist/src/shell/main-http.js +76 -0
  228. package/dist/src/shell/main-http.js.map +1 -0
  229. package/dist/src/shell/main-loops.js +130 -0
  230. package/dist/src/shell/main-loops.js.map +1 -0
  231. package/dist/src/shell/main-mcp.js +129 -0
  232. package/dist/src/shell/main-mcp.js.map +1 -0
  233. package/dist/src/shell/main-orchestrator.js +120 -0
  234. package/dist/src/shell/main-orchestrator.js.map +1 -0
  235. package/dist/src/shell/main-preflight.js +43 -0
  236. package/dist/src/shell/main-preflight.js.map +1 -0
  237. package/dist/src/shell/main-reconcilers-helpers.js +244 -0
  238. package/dist/src/shell/main-reconcilers-helpers.js.map +1 -0
  239. package/dist/src/shell/main-reconcilers-pr.js +148 -0
  240. package/dist/src/shell/main-reconcilers-pr.js.map +1 -0
  241. package/dist/src/shell/main-reconcilers.js +225 -0
  242. package/dist/src/shell/main-reconcilers.js.map +1 -0
  243. package/dist/src/shell/main-runner.js +355 -0
  244. package/dist/src/shell/main-runner.js.map +1 -0
  245. package/dist/src/shell/main-scaffold.js +116 -0
  246. package/dist/src/shell/main-scaffold.js.map +1 -0
  247. package/dist/src/shell/main-shutdown.js +115 -0
  248. package/dist/src/shell/main-shutdown.js.map +1 -0
  249. package/dist/src/shell/main-startup.js +48 -0
  250. package/dist/src/shell/main-startup.js.map +1 -0
  251. package/dist/src/shell/main-substrates.js +43 -0
  252. package/dist/src/shell/main-substrates.js.map +1 -0
  253. package/dist/src/shell/main.js +385 -0
  254. package/dist/src/shell/main.js.map +1 -0
  255. package/dist/src/shell/orchestrator-feedback.js +69 -0
  256. package/dist/src/shell/orchestrator-feedback.js.map +1 -0
  257. package/dist/src/shell/orchestrator-image.js +167 -0
  258. package/dist/src/shell/orchestrator-image.js.map +1 -0
  259. package/dist/src/shell/orchestrator-loop.js +468 -0
  260. package/dist/src/shell/orchestrator-loop.js.map +1 -0
  261. package/dist/src/shell/orchestrator-reconcile.js +36 -0
  262. package/dist/src/shell/orchestrator-reconcile.js.map +1 -0
  263. package/dist/src/shell/reconciler-loop.js +228 -0
  264. package/dist/src/shell/reconciler-loop.js.map +1 -0
  265. package/dist/src/shell/runner-loop-turn.js +301 -0
  266. package/dist/src/shell/runner-loop-turn.js.map +1 -0
  267. package/dist/src/shell/runner-loop.js +338 -0
  268. package/dist/src/shell/runner-loop.js.map +1 -0
  269. package/dist/src/shell/server/http.js +208 -0
  270. package/dist/src/shell/server/http.js.map +1 -0
  271. package/dist/src/shell/server/mcp-runtime-effects.js +237 -0
  272. package/dist/src/shell/server/mcp-runtime-effects.js.map +1 -0
  273. package/dist/src/shell/server/mcp-runtime.js +99 -0
  274. package/dist/src/shell/server/mcp-runtime.js.map +1 -0
  275. package/dist/src/shell/workspace-key.js +14 -0
  276. package/dist/src/shell/workspace-key.js.map +1 -0
  277. package/dist/src/types/acp.js +8 -0
  278. package/dist/src/types/acp.js.map +1 -0
  279. package/dist/src/types/actions/plan.js +6 -0
  280. package/dist/src/types/actions/plan.js.map +1 -0
  281. package/dist/src/types/actions/predicates.js +6 -0
  282. package/dist/src/types/actions/predicates.js.map +1 -0
  283. package/dist/src/types/actions/run-fold.js +8 -0
  284. package/dist/src/types/actions/run-fold.js.map +1 -0
  285. package/dist/src/types/actions.js +7 -0
  286. package/dist/src/types/actions.js.map +1 -0
  287. package/dist/src/types/adapter/clock-random.js +4 -0
  288. package/dist/src/types/adapter/clock-random.js.map +1 -0
  289. package/dist/src/types/adapter/gondolin-image-converter.js +5 -0
  290. package/dist/src/types/adapter/gondolin-image-converter.js.map +1 -0
  291. package/dist/src/types/adapter/gondolin-image-fetch.js +5 -0
  292. package/dist/src/types/adapter/gondolin-image-fetch.js.map +1 -0
  293. package/dist/src/types/adapter/workflow-loader.js +4 -0
  294. package/dist/src/types/adapter/workflow-loader.js.map +1 -0
  295. package/dist/src/types/cli/args.js +8 -0
  296. package/dist/src/types/cli/args.js.map +1 -0
  297. package/dist/src/types/config.js +8 -0
  298. package/dist/src/types/config.js.map +1 -0
  299. package/dist/src/types/credential-interp.js +6 -0
  300. package/dist/src/types/credential-interp.js.map +1 -0
  301. package/dist/src/types/credentials.js +10 -0
  302. package/dist/src/types/credentials.js.map +1 -0
  303. package/dist/src/types/doctor.js +7 -0
  304. package/dist/src/types/doctor.js.map +1 -0
  305. package/dist/src/types/domain.js +7 -0
  306. package/dist/src/types/domain.js.map +1 -0
  307. package/dist/src/types/effect.js +15 -0
  308. package/dist/src/types/effect.js.map +1 -0
  309. package/dist/src/types/errors.js +39 -0
  310. package/dist/src/types/errors.js.map +1 -0
  311. package/dist/src/types/http/decisions.js +6 -0
  312. package/dist/src/types/http/decisions.js.map +1 -0
  313. package/dist/src/types/http/render.js +10 -0
  314. package/dist/src/types/http/render.js.map +1 -0
  315. package/dist/src/types/http/views.js +6 -0
  316. package/dist/src/types/http/views.js.map +1 -0
  317. package/dist/src/types/http.js +9 -0
  318. package/dist/src/types/http.js.map +1 -0
  319. package/dist/src/types/image/managed-image.js +7 -0
  320. package/dist/src/types/image/managed-image.js.map +1 -0
  321. package/dist/src/types/interp/effect-interpreter.js +8 -0
  322. package/dist/src/types/interp/effect-interpreter.js.map +1 -0
  323. package/dist/src/types/interp/tracker.js +7 -0
  324. package/dist/src/types/interp/tracker.js.map +1 -0
  325. package/dist/src/types/issue/file.js +6 -0
  326. package/dist/src/types/issue/file.js.map +1 -0
  327. package/dist/src/types/issue/parse.js +8 -0
  328. package/dist/src/types/issue/parse.js.map +1 -0
  329. package/dist/src/types/main-acp.js +13 -0
  330. package/dist/src/types/main-acp.js.map +1 -0
  331. package/dist/src/types/main-adapters.js +5 -0
  332. package/dist/src/types/main-adapters.js.map +1 -0
  333. package/dist/src/types/main-credential.js +21 -0
  334. package/dist/src/types/main-credential.js.map +1 -0
  335. package/dist/src/types/main-doctor.js +6 -0
  336. package/dist/src/types/main-doctor.js.map +1 -0
  337. package/dist/src/types/main-http-handler.js +12 -0
  338. package/dist/src/types/main-http-handler.js.map +1 -0
  339. package/dist/src/types/main-http.js +5 -0
  340. package/dist/src/types/main-http.js.map +1 -0
  341. package/dist/src/types/main-loops.js +5 -0
  342. package/dist/src/types/main-loops.js.map +1 -0
  343. package/dist/src/types/main-mcp.js +12 -0
  344. package/dist/src/types/main-mcp.js.map +1 -0
  345. package/dist/src/types/main-orchestrator.js +5 -0
  346. package/dist/src/types/main-orchestrator.js.map +1 -0
  347. package/dist/src/types/main-reconcilers.js +11 -0
  348. package/dist/src/types/main-reconcilers.js.map +1 -0
  349. package/dist/src/types/main-runner.js +13 -0
  350. package/dist/src/types/main-runner.js.map +1 -0
  351. package/dist/src/types/main-startup.js +5 -0
  352. package/dist/src/types/main-startup.js.map +1 -0
  353. package/dist/src/types/main-substrates.js +5 -0
  354. package/dist/src/types/main-substrates.js.map +1 -0
  355. package/dist/src/types/mcp/dispatch.js +4 -0
  356. package/dist/src/types/mcp/dispatch.js.map +1 -0
  357. package/dist/src/types/mcp/post-move.js +7 -0
  358. package/dist/src/types/mcp/post-move.js.map +1 -0
  359. package/dist/src/types/mcp.js +9 -0
  360. package/dist/src/types/mcp.js.map +1 -0
  361. package/dist/src/types/ports.js +12 -0
  362. package/dist/src/types/ports.js.map +1 -0
  363. package/dist/src/types/reconcile/image-decide.js +5 -0
  364. package/dist/src/types/reconcile/image-decide.js.map +1 -0
  365. package/dist/src/types/reconcile/ledger.js +7 -0
  366. package/dist/src/types/reconcile/ledger.js.map +1 -0
  367. package/dist/src/types/reconcile/pr-loop.js +8 -0
  368. package/dist/src/types/reconcile/pr-loop.js.map +1 -0
  369. package/dist/src/types/reconcile/vm-reap.js +8 -0
  370. package/dist/src/types/reconcile/vm-reap.js.map +1 -0
  371. package/dist/src/types/reconcile/workspace-decide.js +7 -0
  372. package/dist/src/types/reconcile/workspace-decide.js.map +1 -0
  373. package/dist/src/types/reconcile.js +9 -0
  374. package/dist/src/types/reconcile.js.map +1 -0
  375. package/dist/src/types/runlog.js +7 -0
  376. package/dist/src/types/runlog.js.map +1 -0
  377. package/dist/src/types/runner/actions-runner.js +12 -0
  378. package/dist/src/types/runner/actions-runner.js.map +1 -0
  379. package/dist/src/types/runner/gondolin-dispatch.js +5 -0
  380. package/dist/src/types/runner/gondolin-dispatch.js.map +1 -0
  381. package/dist/src/types/runner/injection.js +6 -0
  382. package/dist/src/types/runner/injection.js.map +1 -0
  383. package/dist/src/types/runner/runner-loop.js +5 -0
  384. package/dist/src/types/runner/runner-loop.js.map +1 -0
  385. package/dist/src/types/runner/turn.js +4 -0
  386. package/dist/src/types/runner/turn.js.map +1 -0
  387. package/dist/src/types/runner/vm-plan.js +4 -0
  388. package/dist/src/types/runner/vm-plan.js.map +1 -0
  389. package/dist/src/types/runtime.js +9 -0
  390. package/dist/src/types/runtime.js.map +1 -0
  391. package/dist/src/types/schedule/admission.js +7 -0
  392. package/dist/src/types/schedule/admission.js.map +1 -0
  393. package/dist/src/types/schedule/circuit-breaker.js +2 -0
  394. package/dist/src/types/schedule/circuit-breaker.js.map +1 -0
  395. package/dist/src/types/schedule/eligibility.js +9 -0
  396. package/dist/src/types/schedule/eligibility.js.map +1 -0
  397. package/dist/src/types/schedule/orchestrator-loop.js +10 -0
  398. package/dist/src/types/schedule/orchestrator-loop.js.map +1 -0
  399. package/dist/src/types/schedule/sleep-cycle.js +4 -0
  400. package/dist/src/types/schedule/sleep-cycle.js.map +1 -0
  401. package/dist/src/types/schedule/slots.js +8 -0
  402. package/dist/src/types/schedule/slots.js.map +1 -0
  403. package/dist/src/types/schedule/tick.js +9 -0
  404. package/dist/src/types/schedule/tick.js.map +1 -0
  405. package/dist/src/types/server/mcp-runtime.js +8 -0
  406. package/dist/src/types/server/mcp-runtime.js.map +1 -0
  407. package/dist/src/types/workflow/parse.js +4 -0
  408. package/dist/src/types/workflow/parse.js.map +1 -0
  409. package/dist/tests/core/account-id.test.js +35 -0
  410. package/dist/tests/core/account-id.test.js.map +1 -0
  411. package/dist/tests/core/actions-parse.test.js +176 -0
  412. package/dist/tests/core/actions-parse.test.js.map +1 -0
  413. package/dist/tests/core/adapter-config.test.js +133 -0
  414. package/dist/tests/core/adapter-config.test.js.map +1 -0
  415. package/dist/tests/core/admission.test.js +215 -0
  416. package/dist/tests/core/admission.test.js.map +1 -0
  417. package/dist/tests/core/args.test.js +132 -0
  418. package/dist/tests/core/args.test.js.map +1 -0
  419. package/dist/tests/core/availability.test.js +62 -0
  420. package/dist/tests/core/availability.test.js.map +1 -0
  421. package/dist/tests/core/checks.test.js +395 -0
  422. package/dist/tests/core/checks.test.js.map +1 -0
  423. package/dist/tests/core/circuit-breaker.test.js +172 -0
  424. package/dist/tests/core/circuit-breaker.test.js.map +1 -0
  425. package/dist/tests/core/coerce.test.js +87 -0
  426. package/dist/tests/core/coerce.test.js.map +1 -0
  427. package/dist/tests/core/context.test.js +228 -0
  428. package/dist/tests/core/context.test.js.map +1 -0
  429. package/dist/tests/core/decisions.test.js +310 -0
  430. package/dist/tests/core/decisions.test.js.map +1 -0
  431. package/dist/tests/core/derive.test.js +205 -0
  432. package/dist/tests/core/derive.test.js.map +1 -0
  433. package/dist/tests/core/dispatch-config.test.js +164 -0
  434. package/dist/tests/core/dispatch-config.test.js.map +1 -0
  435. package/dist/tests/core/dispatch.test.js +302 -0
  436. package/dist/tests/core/dispatch.test.js.map +1 -0
  437. package/dist/tests/core/eligibility.test.js +163 -0
  438. package/dist/tests/core/eligibility.test.js.map +1 -0
  439. package/dist/tests/core/extract.test.js +139 -0
  440. package/dist/tests/core/extract.test.js.map +1 -0
  441. package/dist/tests/core/fake-creds.test.js +134 -0
  442. package/dist/tests/core/fake-creds.test.js.map +1 -0
  443. package/dist/tests/core/file.test.js +197 -0
  444. package/dist/tests/core/file.test.js.map +1 -0
  445. package/dist/tests/core/git-result.test.js +113 -0
  446. package/dist/tests/core/git-result.test.js.map +1 -0
  447. package/dist/tests/core/identity.test.js +180 -0
  448. package/dist/tests/core/identity.test.js.map +1 -0
  449. package/dist/tests/core/image-decide.test.js +59 -0
  450. package/dist/tests/core/image-decide.test.js.map +1 -0
  451. package/dist/tests/core/injection.test.js +163 -0
  452. package/dist/tests/core/injection.test.js.map +1 -0
  453. package/dist/tests/core/ledger.test.js +218 -0
  454. package/dist/tests/core/ledger.test.js.map +1 -0
  455. package/dist/tests/core/managed-image.test.js +68 -0
  456. package/dist/tests/core/managed-image.test.js.map +1 -0
  457. package/dist/tests/core/mise.test.js +138 -0
  458. package/dist/tests/core/mise.test.js.map +1 -0
  459. package/dist/tests/core/parse.test.js +174 -0
  460. package/dist/tests/core/parse.test.js.map +1 -0
  461. package/dist/tests/core/path.test.js +50 -0
  462. package/dist/tests/core/path.test.js.map +1 -0
  463. package/dist/tests/core/plan.test.js +218 -0
  464. package/dist/tests/core/plan.test.js.map +1 -0
  465. package/dist/tests/core/post-move.test.js +162 -0
  466. package/dist/tests/core/post-move.test.js.map +1 -0
  467. package/dist/tests/core/pr-classify.test.js +117 -0
  468. package/dist/tests/core/pr-classify.test.js.map +1 -0
  469. package/dist/tests/core/pr-decide.test.js +298 -0
  470. package/dist/tests/core/pr-decide.test.js.map +1 -0
  471. package/dist/tests/core/pr-loop.test.js +301 -0
  472. package/dist/tests/core/pr-loop.test.js.map +1 -0
  473. package/dist/tests/core/pr-notes.test.js +165 -0
  474. package/dist/tests/core/pr-notes.test.js.map +1 -0
  475. package/dist/tests/core/predicates.test.js +154 -0
  476. package/dist/tests/core/predicates.test.js.map +1 -0
  477. package/dist/tests/core/prompt.test.js +189 -0
  478. package/dist/tests/core/prompt.test.js.map +1 -0
  479. package/dist/tests/core/protocol.test.js +195 -0
  480. package/dist/tests/core/protocol.test.js.map +1 -0
  481. package/dist/tests/core/reconcile-issue.test.js +116 -0
  482. package/dist/tests/core/reconcile-issue.test.js.map +1 -0
  483. package/dist/tests/core/render.test.js +549 -0
  484. package/dist/tests/core/render.test.js.map +1 -0
  485. package/dist/tests/core/retry.test.js +186 -0
  486. package/dist/tests/core/retry.test.js.map +1 -0
  487. package/dist/tests/core/routes.test.js +247 -0
  488. package/dist/tests/core/routes.test.js.map +1 -0
  489. package/dist/tests/core/run-fold.test.js +299 -0
  490. package/dist/tests/core/run-fold.test.js.map +1 -0
  491. package/dist/tests/core/shape.test.js +185 -0
  492. package/dist/tests/core/shape.test.js.map +1 -0
  493. package/dist/tests/core/sleep-cycle.test.js +150 -0
  494. package/dist/tests/core/sleep-cycle.test.js.map +1 -0
  495. package/dist/tests/core/slots.test.js +201 -0
  496. package/dist/tests/core/slots.test.js.map +1 -0
  497. package/dist/tests/core/state-resolve.test.js +80 -0
  498. package/dist/tests/core/state-resolve.test.js.map +1 -0
  499. package/dist/tests/core/summary.test.js +200 -0
  500. package/dist/tests/core/summary.test.js.map +1 -0
  501. package/dist/tests/core/template.test.js +116 -0
  502. package/dist/tests/core/template.test.js.map +1 -0
  503. package/dist/tests/core/tick.test.js +558 -0
  504. package/dist/tests/core/tick.test.js.map +1 -0
  505. package/dist/tests/core/token-fold.test.js +176 -0
  506. package/dist/tests/core/token-fold.test.js.map +1 -0
  507. package/dist/tests/core/turn.test.js +388 -0
  508. package/dist/tests/core/turn.test.js.map +1 -0
  509. package/dist/tests/core/url.test.js +118 -0
  510. package/dist/tests/core/url.test.js.map +1 -0
  511. package/dist/tests/core/validate.test.js +247 -0
  512. package/dist/tests/core/validate.test.js.map +1 -0
  513. package/dist/tests/core/views.test.js +252 -0
  514. package/dist/tests/core/views.test.js.map +1 -0
  515. package/dist/tests/core/vm-decide.test.js +110 -0
  516. package/dist/tests/core/vm-decide.test.js.map +1 -0
  517. package/dist/tests/core/vm-guards.test.js +153 -0
  518. package/dist/tests/core/vm-guards.test.js.map +1 -0
  519. package/dist/tests/core/vm-plan.test.js +332 -0
  520. package/dist/tests/core/vm-plan.test.js.map +1 -0
  521. package/dist/tests/core/vm-reap.test.js +196 -0
  522. package/dist/tests/core/vm-reap.test.js.map +1 -0
  523. package/dist/tests/core/workflow-parse.test.js +493 -0
  524. package/dist/tests/core/workflow-parse.test.js.map +1 -0
  525. package/dist/tests/core/workspace-decide.test.js +236 -0
  526. package/dist/tests/core/workspace-decide.test.js.map +1 -0
  527. package/dist/tests/helpers/fixtures.js +167 -0
  528. package/dist/tests/helpers/fixtures.js.map +1 -0
  529. package/dist/tests/shell/acp-substrate.test.js +101 -0
  530. package/dist/tests/shell/acp-substrate.test.js.map +1 -0
  531. package/dist/tests/shell/actions-runner-push.test.js +203 -0
  532. package/dist/tests/shell/actions-runner-push.test.js.map +1 -0
  533. package/dist/tests/shell/credential-hooks.test.js +36 -0
  534. package/dist/tests/shell/credential-hooks.test.js.map +1 -0
  535. package/dist/tests/shell/credential-registry.test.js +165 -0
  536. package/dist/tests/shell/credential-registry.test.js.map +1 -0
  537. package/dist/tests/shell/credential-substrate.test.js +179 -0
  538. package/dist/tests/shell/credential-substrate.test.js.map +1 -0
  539. package/dist/tests/shell/dockerfile-mise-pin.test.js +51 -0
  540. package/dist/tests/shell/dockerfile-mise-pin.test.js.map +1 -0
  541. package/dist/tests/shell/doctor.test.js +101 -0
  542. package/dist/tests/shell/doctor.test.js.map +1 -0
  543. package/dist/tests/shell/effect-vm-create.test.js +52 -0
  544. package/dist/tests/shell/effect-vm-create.test.js.map +1 -0
  545. package/dist/tests/shell/gh-port.test.js +63 -0
  546. package/dist/tests/shell/gh-port.test.js.map +1 -0
  547. package/dist/tests/shell/gondolin-dispatch-guard.test.js +144 -0
  548. package/dist/tests/shell/gondolin-dispatch-guard.test.js.map +1 -0
  549. package/dist/tests/shell/gondolin-dispatch-shquote.test.js +168 -0
  550. package/dist/tests/shell/gondolin-dispatch-shquote.test.js.map +1 -0
  551. package/dist/tests/shell/gondolin-image-converter.test.js +208 -0
  552. package/dist/tests/shell/gondolin-image-converter.test.js.map +1 -0
  553. package/dist/tests/shell/gondolin-image-fetch.test.js +93 -0
  554. package/dist/tests/shell/gondolin-image-fetch.test.js.map +1 -0
  555. package/dist/tests/shell/http-handler.test.js +608 -0
  556. package/dist/tests/shell/http-handler.test.js.map +1 -0
  557. package/dist/tests/shell/http-server.test.js +53 -0
  558. package/dist/tests/shell/http-server.test.js.map +1 -0
  559. package/dist/tests/shell/mcp-runtime.test.js +366 -0
  560. package/dist/tests/shell/mcp-runtime.test.js.map +1 -0
  561. package/dist/tests/shell/mise-config-asset.test.js +87 -0
  562. package/dist/tests/shell/mise-config-asset.test.js.map +1 -0
  563. package/dist/tests/shell/orchestrator-loop.test.js +583 -0
  564. package/dist/tests/shell/orchestrator-loop.test.js.map +1 -0
  565. package/dist/tests/shell/reconciler-passes.test.js +314 -0
  566. package/dist/tests/shell/reconciler-passes.test.js.map +1 -0
  567. package/dist/tests/shell/runner-loop-turn.test.js +97 -0
  568. package/dist/tests/shell/runner-loop-turn.test.js.map +1 -0
  569. package/dist/tests/shell/runner-slice.test.js +536 -0
  570. package/dist/tests/shell/runner-slice.test.js.map +1 -0
  571. package/dist/tests/shell/scaffold.test.js +65 -0
  572. package/dist/tests/shell/scaffold.test.js.map +1 -0
  573. package/dist/tests/shell/tick-config.test.js +83 -0
  574. package/dist/tests/shell/tick-config.test.js.map +1 -0
  575. package/dist/tests/shell/tracker-parse-dates.test.js +44 -0
  576. package/dist/tests/shell/tracker-parse-dates.test.js.map +1 -0
  577. package/dist/tests/shell/tracker-write-issue.test.js +154 -0
  578. package/dist/tests/shell/tracker-write-issue.test.js.map +1 -0
  579. package/dist/tests/shell/workflow-prompt-split.test.js +208 -0
  580. package/dist/tests/shell/workflow-prompt-split.test.js.map +1 -0
  581. package/dist/tests/shell/workspace-live-config.test.js +140 -0
  582. package/dist/tests/shell/workspace-live-config.test.js.map +1 -0
  583. package/package.json +31 -11
  584. package/patches/@earendil-works+gondolin+0.12.0.patch +173 -0
  585. package/prompts/Reflect.md +91 -0
  586. package/prompts/Review.md +97 -0
  587. package/prompts/Todo.md +96 -0
  588. package/prompts/_footer.md +41 -0
  589. package/prompts/_preamble.md +42 -0
  590. package/prompts-minimal/Todo.md +26 -0
  591. package/scripts/postinstall.mjs +63 -0
  592. package/scripts/vm-agent.mjs +433 -0
  593. package/WORKFLOW.md +0 -269
  594. package/WORKFLOW.template.md +0 -307
  595. package/dist/agent/acp.js +0 -304
  596. package/dist/agent/acp.js.map +0 -1
  597. package/dist/agent/adapters.js +0 -275
  598. package/dist/agent/adapters.js.map +0 -1
  599. package/dist/agent/codex.js +0 -439
  600. package/dist/agent/codex.js.map +0 -1
  601. package/dist/agent/runner.js +0 -394
  602. package/dist/agent/runner.js.map +0 -1
  603. package/dist/agent/smolvm.js +0 -174
  604. package/dist/agent/smolvm.js.map +0 -1
  605. package/dist/bin/symphony.js +0 -205
  606. package/dist/bin/symphony.js.map +0 -1
  607. package/dist/http.js +0 -1189
  608. package/dist/http.js.map +0 -1
  609. package/dist/logging.js +0 -45
  610. package/dist/logging.js.map +0 -1
  611. package/dist/mcp.js +0 -478
  612. package/dist/mcp.js.map +0 -1
  613. package/dist/orchestrator.js +0 -683
  614. package/dist/orchestrator.js.map +0 -1
  615. package/dist/prompt.js +0 -65
  616. package/dist/prompt.js.map +0 -1
  617. package/dist/trackers/local.js +0 -344
  618. package/dist/trackers/local.js.map +0 -1
  619. package/dist/trackers/types.js +0 -10
  620. package/dist/trackers/types.js.map +0 -1
  621. package/dist/types.js +0 -3
  622. package/dist/types.js.map +0 -1
  623. package/dist/workflow.js +0 -385
  624. package/dist/workflow.js.map +0 -1
  625. package/dist/workspace.js +0 -196
  626. package/dist/workspace.js.map +0 -1
  627. package/scripts/build-vm.sh +0 -67
@@ -1,683 +0,0 @@
1
- // Orchestrator (SPEC §7, §8, §14, §16). Owns the single-authority runtime state and
2
- // drives the poll-and-dispatch tick, retries, reconciliation, and worker exit handling.
3
- import { validateDispatch, WorkflowError } from './workflow.js';
4
- import { ADAPTERS, assertHostCredentialReadable, isKnownAdapter } from './agent/adapters.js';
5
- import { pickTerminalTarget } from './mcp.js';
6
- import { withIssue, log } from './logging.js';
7
- const CONTINUATION_DELAY_MS = 1_000;
8
- const FAILURE_BASE_MS = 10_000;
9
- export class Orchestrator {
10
- cfg;
11
- workflowDef;
12
- workflowSrc;
13
- tracker;
14
- workspaces;
15
- runner;
16
- running = new Map();
17
- claimed = new Set();
18
- retryAttempts = new Map();
19
- completed = new Set();
20
- codexTotals = {
21
- input_tokens: 0,
22
- output_tokens: 0,
23
- total_tokens: 0,
24
- seconds_running: 0,
25
- };
26
- codexRateLimits = null;
27
- tickTimer = null;
28
- stopped = false;
29
- refreshRequested = false;
30
- // Latest dispatch validation error, if any (operator-visible).
31
- lastValidationError = null;
32
- // Optional callback used to propagate reloaded config to components that hold their own
33
- // tracker/runner/workspace state (so prompt body, hooks, smolvm config, etc., take effect
34
- // on the next dispatch — see §6.2).
35
- onConfigReloaded;
36
- constructor(cfg, workflowDef, workflowSrc, tracker, workspaces, runner) {
37
- this.cfg = cfg;
38
- this.workflowDef = workflowDef;
39
- this.workflowSrc = workflowSrc;
40
- this.tracker = tracker;
41
- this.workspaces = workspaces;
42
- this.runner = runner;
43
- workflowSrc.onChange((next) => {
44
- if ('error' in next) {
45
- this.lastValidationError = next.error.message;
46
- log.warn('workflow reload error', { error: next.error.message });
47
- return;
48
- }
49
- this.cfg = next.config;
50
- this.workflowDef = next.definition;
51
- this.lastValidationError = null;
52
- this.onConfigReloaded?.(next.config, next.definition);
53
- log.info('runtime config reloaded', {
54
- poll_interval_ms: next.config.polling.interval_ms,
55
- max_concurrent_agents: next.config.agent.max_concurrent_agents,
56
- });
57
- });
58
- }
59
- /** Register a callback invoked after every successful workflow reload. */
60
- setOnConfigReloaded(cb) {
61
- this.onConfigReloaded = cb;
62
- }
63
- async start() {
64
- const validation = validateDispatch(this.cfg);
65
- if (validation) {
66
- log.error('startup validation failed', { error: validation });
67
- throw new WorkflowError('workflow_parse_error', validation);
68
- }
69
- // Fail fast when symphony will auto-stage credentials but the host file the
70
- // adapter needs is missing. Operators who set acp.command explicitly own their
71
- // own credential plumbing, so skip the check in that branch.
72
- if (this.cfg.acp.command === null && isKnownAdapter(this.cfg.acp.adapter)) {
73
- const profile = ADAPTERS[this.cfg.acp.adapter];
74
- try {
75
- await assertHostCredentialReadable(profile);
76
- }
77
- catch (err) {
78
- log.error('startup credential check failed', { error: err.message });
79
- throw new WorkflowError('missing_host_credential', err.message);
80
- }
81
- }
82
- await this.startupTerminalCleanup();
83
- this.scheduleTick(0);
84
- }
85
- async stop() {
86
- this.stopped = true;
87
- if (this.tickTimer) {
88
- clearTimeout(this.tickTimer);
89
- this.tickTimer = null;
90
- }
91
- for (const e of this.retryAttempts.values())
92
- clearTimeout(e.timer_handle);
93
- this.retryAttempts.clear();
94
- // Signal cancel on all running entries.
95
- for (const e of this.running.values())
96
- e.cancel();
97
- this.running.clear();
98
- this.claimed.clear();
99
- }
100
- /** Operator trigger for an immediate poll cycle (§13.7 /refresh). */
101
- triggerRefresh() {
102
- if (this.refreshRequested)
103
- return { queued: true, coalesced: true };
104
- this.refreshRequested = true;
105
- if (this.tickTimer)
106
- clearTimeout(this.tickTimer);
107
- this.tickTimer = setTimeout(() => void this.tick(), 0);
108
- return { queued: true, coalesced: false };
109
- }
110
- scheduleTick(delayMs) {
111
- if (this.stopped)
112
- return;
113
- if (this.tickTimer)
114
- clearTimeout(this.tickTimer);
115
- this.tickTimer = setTimeout(() => void this.tick(), delayMs);
116
- }
117
- async tick() {
118
- if (this.stopped)
119
- return;
120
- this.refreshRequested = false;
121
- try {
122
- await this.reconcile();
123
- }
124
- catch (err) {
125
- log.warn('reconcile error', { error: err.message });
126
- }
127
- const validation = validateDispatch(this.cfg);
128
- if (validation) {
129
- this.lastValidationError = validation;
130
- log.warn('dispatch validation failed; skipping dispatch', { error: validation });
131
- this.scheduleTick(this.cfg.polling.interval_ms);
132
- return;
133
- }
134
- this.lastValidationError = null;
135
- let candidates;
136
- let snapshotTrackerRoot;
137
- let snapshotTerminalTarget;
138
- try {
139
- // Atomic fetch: the tracker returns the issues AND the root/terminal_states
140
- // it used during the scan. That's the snapshot we pin onto each RunningEntry,
141
- // so a workflow reload that races the dispatch loop can't cause `mark_done`
142
- // to operate against a different tracker config than where the issue lives.
143
- const result = await this.tracker.fetchCandidateIssues();
144
- candidates = result.issues;
145
- snapshotTrackerRoot = result.root;
146
- snapshotTerminalTarget = pickTerminalTarget(result.terminalStates);
147
- }
148
- catch (err) {
149
- log.warn('candidate fetch failed', { error: err.message });
150
- this.scheduleTick(this.cfg.polling.interval_ms);
151
- return;
152
- }
153
- const sorted = this.sortForDispatch(candidates);
154
- for (const issue of sorted) {
155
- if (this.availableGlobalSlots() <= 0)
156
- break;
157
- if (!this.isEligible(issue))
158
- continue;
159
- void this.dispatchIssue(issue, null, {
160
- trackerRoot: snapshotTrackerRoot,
161
- terminalTarget: snapshotTerminalTarget,
162
- });
163
- }
164
- this.scheduleTick(this.cfg.polling.interval_ms);
165
- }
166
- /** §8.5: stall detection + tracker state refresh for running issues. */
167
- async reconcile() {
168
- // Part A: stall detection.
169
- if (this.cfg.acp.stall_timeout_ms > 0) {
170
- const now = Date.now();
171
- for (const [issueId, entry] of this.running) {
172
- // Skip stall detection for issues awaiting human steering: the agent is
173
- // intentionally paused while the human composes a reply, and the wait can
174
- // legitimately exceed stall_timeout_ms. The cancel signal still applies
175
- // (the runner's awaitSteeringReply respects it) for non-stall reasons like
176
- // terminal-state transitions or operator-initiated cancels.
177
- if (entry.steering_requested)
178
- continue;
179
- const ref = entry.last_codex_timestamp ?? entry.started_at;
180
- const elapsed = now - Date.parse(ref);
181
- if (Number.isFinite(elapsed) && elapsed > this.cfg.acp.stall_timeout_ms) {
182
- log.warn('stall detected', {
183
- issue_id: issueId,
184
- issue_identifier: entry.identifier,
185
- elapsed_ms: elapsed,
186
- });
187
- this.terminateRunning(issueId, false, `stalled after ${elapsed}ms`);
188
- }
189
- }
190
- }
191
- // Part B: tracker state refresh.
192
- const ids = [...this.running.keys()];
193
- if (ids.length === 0)
194
- return;
195
- let refreshed;
196
- try {
197
- refreshed = await this.tracker.fetchIssueStatesByIds(ids);
198
- }
199
- catch (err) {
200
- log.debug('state refresh failed; keep workers running', { error: err.message });
201
- return;
202
- }
203
- const byId = new Map(refreshed.map((i) => [i.id, i]));
204
- const terminal = new Set(this.cfg.tracker.terminal_states.map((s) => s.toLowerCase()));
205
- const active = new Set(this.cfg.tracker.active_states.map((s) => s.toLowerCase()));
206
- for (const id of ids) {
207
- const fresh = byId.get(id);
208
- if (!fresh) {
209
- // Missing from tracker — non-active, no cleanup (§8.5 part B "neither" branch).
210
- this.terminateRunning(id, false, 'tracker_state_missing');
211
- continue;
212
- }
213
- const s = fresh.state.toLowerCase();
214
- if (terminal.has(s)) {
215
- this.terminateRunning(id, true, 'tracker_state_terminal');
216
- }
217
- else if (active.has(s)) {
218
- const entry = this.running.get(id);
219
- if (entry)
220
- entry.issue = fresh;
221
- }
222
- else {
223
- this.terminateRunning(id, false, 'tracker_state_non_active');
224
- }
225
- }
226
- }
227
- terminateRunning(issueId, cleanupWorkspace, reason) {
228
- const entry = this.running.get(issueId);
229
- if (!entry)
230
- return;
231
- if (cleanupWorkspace)
232
- entry.cleanup_workspace_on_exit = true;
233
- entry.cancel();
234
- log.info('reconciliation terminating run', {
235
- issue_id: issueId,
236
- issue_identifier: entry.identifier,
237
- reason,
238
- cleanup_workspace: cleanupWorkspace,
239
- });
240
- }
241
- /** §8.2 candidate eligibility. */
242
- isEligible(issue) {
243
- return this.eligibilityReason(issue, /*ignoreOwnClaim*/ false) === null;
244
- }
245
- // Returns null when eligible, otherwise a short reason string. The `ignoreOwnClaim`
246
- // form is used by the retry path so the issue's own claim/retry entry does not block
247
- // its own redispatch.
248
- eligibilityReason(issue, ignoreOwnClaim) {
249
- if (!issue.id || !issue.identifier || !issue.title || !issue.state) {
250
- return 'missing required issue fields';
251
- }
252
- const state = issue.state.toLowerCase();
253
- const active = new Set(this.cfg.tracker.active_states.map((s) => s.toLowerCase()));
254
- const terminal = new Set(this.cfg.tracker.terminal_states.map((s) => s.toLowerCase()));
255
- if (!active.has(state) || terminal.has(state))
256
- return 'state not active';
257
- if (this.running.has(issue.id))
258
- return 'already running';
259
- if (!ignoreOwnClaim && this.claimed.has(issue.id))
260
- return 'already claimed';
261
- if (!this.hasPerStateSlot(issue.state))
262
- return 'no per-state slot';
263
- if (state === 'todo' && this.hasNonTerminalBlocker(issue))
264
- return 'has non-terminal blocker';
265
- return null;
266
- }
267
- hasNonTerminalBlocker(issue) {
268
- const terminal = new Set(this.cfg.tracker.terminal_states.map((s) => s.toLowerCase()));
269
- for (const b of issue.blocked_by) {
270
- if (!b.state)
271
- return true;
272
- if (!terminal.has(b.state.toLowerCase()))
273
- return true;
274
- }
275
- return false;
276
- }
277
- availableGlobalSlots() {
278
- return Math.max(0, this.cfg.agent.max_concurrent_agents - this.running.size);
279
- }
280
- /** §8.3: per-state slot accounting using current running entries. */
281
- hasPerStateSlot(stateName) {
282
- const cap = this.cfg.agent.max_concurrent_agents_by_state[stateName.toLowerCase()];
283
- if (!cap)
284
- return this.availableGlobalSlots() > 0;
285
- let inState = 0;
286
- for (const e of this.running.values()) {
287
- if (e.issue.state.toLowerCase() === stateName.toLowerCase())
288
- inState++;
289
- }
290
- return inState < cap && this.availableGlobalSlots() > 0;
291
- }
292
- /** §8.2 sort: priority ASC (null last), then created_at ASC, then identifier. */
293
- sortForDispatch(issues) {
294
- return [...issues].sort((a, b) => {
295
- const pa = a.priority ?? Number.POSITIVE_INFINITY;
296
- const pb = b.priority ?? Number.POSITIVE_INFINITY;
297
- if (pa !== pb)
298
- return pa - pb;
299
- const ca = a.created_at ? Date.parse(a.created_at) : Number.POSITIVE_INFINITY;
300
- const cb = b.created_at ? Date.parse(b.created_at) : Number.POSITIVE_INFINITY;
301
- if (Number.isFinite(ca) && Number.isFinite(cb) && ca !== cb)
302
- return ca - cb;
303
- return a.identifier.localeCompare(b.identifier);
304
- });
305
- }
306
- /** §16.4 dispatch_issue */
307
- async dispatchIssue(issue, attempt, snapshot) {
308
- if (this.running.has(issue.id))
309
- return;
310
- this.claimed.add(issue.id);
311
- this.retryAttempts.delete(issue.id);
312
- const cancel = { cancelled: false };
313
- const startedAt = new Date().toISOString();
314
- const workspacePath = this.workspaces.workspacePathFor(issue.identifier);
315
- // Snapshot tracker.root and the terminal target BEFORE workspace setup,
316
- // before_run, or smolvm bring-up. A WORKFLOW.md reload during that window
317
- // (or even between fetchCandidateIssues returning and this iteration of
318
- // the dispatch loop) can mutate the live tracker config; pinning here closes
319
- // that window. When the caller supplies a snapshot (the tick/retry path
320
- // does — it captured at the fetch atomically), prefer those values; the
321
- // optional fallback reads the live config for completeness.
322
- const trackerRootAtDispatch = snapshot?.trackerRoot ?? (this.tracker.currentRoot ? this.tracker.currentRoot() : null);
323
- const terminalTargetAtDispatch = snapshot?.terminalTarget ?? pickTerminalTarget(this.cfg.tracker.terminal_states);
324
- const entry = {
325
- issue_id: issue.id,
326
- identifier: issue.identifier,
327
- issue,
328
- session_id: null,
329
- thread_id: null,
330
- turn_id: null,
331
- codex_app_server_pid: null,
332
- last_codex_event: null,
333
- last_codex_timestamp: null,
334
- last_codex_message: null,
335
- codex_input_tokens: 0,
336
- codex_output_tokens: 0,
337
- codex_total_tokens: 0,
338
- last_reported_input_tokens: 0,
339
- last_reported_output_tokens: 0,
340
- last_reported_total_tokens: 0,
341
- turn_count: 0,
342
- retry_attempt: attempt,
343
- started_at: startedAt,
344
- workspace_path: workspacePath,
345
- cancel: () => {
346
- cancel.cancelled = true;
347
- },
348
- recent_events: [],
349
- last_error: null,
350
- cleanup_workspace_on_exit: false,
351
- mcp_token: null,
352
- tracker_root_at_dispatch: trackerRootAtDispatch,
353
- terminal_target_at_dispatch: terminalTargetAtDispatch,
354
- marked_done: false,
355
- steering_requested: false,
356
- steering_question: null,
357
- steering_context: null,
358
- };
359
- this.running.set(issue.id, entry);
360
- const logger = withIssue({ issue_id: issue.id, issue_identifier: issue.identifier });
361
- logger.info('agent attempt started', { attempt });
362
- void this.runWorker(issue, attempt, entry, cancel);
363
- }
364
- async runWorker(issue, attempt, entry, cancelSignal) {
365
- const logger = withIssue({ issue_id: issue.id, issue_identifier: issue.identifier });
366
- let ok = false;
367
- let reason = 'unknown';
368
- try {
369
- const result = await this.runner.runAttempt(issue, attempt, cancelSignal, entry);
370
- ok = result.ok;
371
- reason = result.reason;
372
- if (result.threadId)
373
- entry.thread_id = result.threadId;
374
- entry.turn_count = result.turnsCompleted;
375
- }
376
- catch (err) {
377
- ok = false;
378
- reason = err.message;
379
- logger.error('worker threw', { error: reason });
380
- }
381
- this.onWorkerExit(issue.id, ok, reason, entry);
382
- }
383
- /** §16.6 on_worker_exit */
384
- onWorkerExit(issueId, normal, reason, entry) {
385
- this.running.delete(issueId);
386
- const elapsedMs = Date.now() - Date.parse(entry.started_at);
387
- if (Number.isFinite(elapsedMs)) {
388
- this.codexTotals.seconds_running += elapsedMs / 1000;
389
- }
390
- const identifier = entry.identifier;
391
- const logger = withIssue({ issue_id: issueId, issue_identifier: identifier });
392
- if (entry.cleanup_workspace_on_exit) {
393
- // Workspace removal is deferred until the worker has fully unwound (including
394
- // after_run hook execution) so we never delete the dir while the agent is still
395
- // inside it.
396
- this.workspaces
397
- .remove(entry.identifier, this.cfg.hooks)
398
- .catch((err) => logger.warn('workspace removal failed', { error: err.message }));
399
- }
400
- // §14.2: if the service was stopped while this worker was unwinding, do not schedule
401
- // a new retry — that would leave a live timer behind even though stop() was called.
402
- if (this.stopped) {
403
- this.claimed.delete(issueId);
404
- return;
405
- }
406
- if (normal) {
407
- this.completed.add(issueId);
408
- logger.info('worker exited (normal)', { reason });
409
- this.scheduleRetry(issueId, {
410
- identifier,
411
- attempt: 1,
412
- delayMs: CONTINUATION_DELAY_MS,
413
- error: null,
414
- });
415
- }
416
- else {
417
- const nextAttempt = entry.retry_attempt !== null && entry.retry_attempt !== undefined ? entry.retry_attempt + 1 : 1;
418
- const delayMs = Math.min(FAILURE_BASE_MS * Math.pow(2, nextAttempt - 1), this.cfg.agent.max_retry_backoff_ms);
419
- logger.warn('worker exited (abnormal)', { reason, next_attempt: nextAttempt, delay_ms: delayMs });
420
- this.scheduleRetry(issueId, {
421
- identifier,
422
- attempt: nextAttempt,
423
- delayMs,
424
- error: reason,
425
- });
426
- }
427
- }
428
- /** §8.4 retry queue. */
429
- scheduleRetry(issueId, sched) {
430
- if (this.stopped)
431
- return;
432
- const existing = this.retryAttempts.get(issueId);
433
- if (existing)
434
- clearTimeout(existing.timer_handle);
435
- const dueAt = Date.now() + sched.delayMs;
436
- const handle = setTimeout(() => void this.onRetryTimer(issueId), sched.delayMs);
437
- this.retryAttempts.set(issueId, {
438
- issue_id: issueId,
439
- identifier: sched.identifier,
440
- attempt: sched.attempt,
441
- due_at_ms: dueAt,
442
- timer_handle: handle,
443
- error: sched.error,
444
- });
445
- this.claimed.add(issueId);
446
- }
447
- /** §16.6 on_retry_timer */
448
- async onRetryTimer(issueId) {
449
- if (this.stopped)
450
- return;
451
- const entry = this.retryAttempts.get(issueId);
452
- if (!entry)
453
- return;
454
- this.retryAttempts.delete(issueId);
455
- let candidates;
456
- let snapshotTrackerRoot;
457
- let snapshotTerminalTarget;
458
- try {
459
- const result = await this.tracker.fetchCandidateIssues();
460
- candidates = result.issues;
461
- snapshotTrackerRoot = result.root;
462
- snapshotTerminalTarget = pickTerminalTarget(result.terminalStates);
463
- }
464
- catch (err) {
465
- log.debug('retry poll failed', {
466
- issue_id: issueId,
467
- issue_identifier: entry.identifier,
468
- error: err.message,
469
- });
470
- this.scheduleRetry(issueId, {
471
- identifier: entry.identifier,
472
- attempt: entry.attempt + 1,
473
- delayMs: Math.min(FAILURE_BASE_MS * Math.pow(2, entry.attempt), this.cfg.agent.max_retry_backoff_ms),
474
- error: 'retry poll failed',
475
- });
476
- return;
477
- }
478
- const issue = candidates.find((i) => i.id === issueId);
479
- if (!issue) {
480
- this.claimed.delete(issueId);
481
- log.info('retry releasing claim (not in candidates)', {
482
- issue_id: issueId,
483
- issue_identifier: entry.identifier,
484
- });
485
- return;
486
- }
487
- // Re-apply full candidate eligibility, ignoring this issue's own claim. This catches
488
- // late-breaking issues like a new non-terminal blocker on a Todo or a state change to
489
- // an inactive value that slipped past the candidate filter on edge tracker shapes.
490
- const reason = this.eligibilityReason(issue, true);
491
- if (reason !== null) {
492
- if (reason === 'no per-state slot') {
493
- this.scheduleRetry(issueId, {
494
- identifier: issue.identifier,
495
- attempt: entry.attempt + 1,
496
- delayMs: Math.min(FAILURE_BASE_MS * Math.pow(2, entry.attempt), this.cfg.agent.max_retry_backoff_ms),
497
- error: 'no available orchestrator slots',
498
- });
499
- return;
500
- }
501
- // For non-slot reasons (blocker, missing fields, non-active state), the right action
502
- // is to release the claim rather than spin on it.
503
- this.claimed.delete(issueId);
504
- log.info('retry releasing claim (ineligible)', {
505
- issue_id: issueId,
506
- issue_identifier: entry.identifier,
507
- reason,
508
- });
509
- return;
510
- }
511
- void this.dispatchIssue(issue, entry.attempt, {
512
- trackerRoot: snapshotTrackerRoot,
513
- terminalTarget: snapshotTerminalTarget,
514
- });
515
- }
516
- /** §8.6 startup terminal workspace cleanup. */
517
- async startupTerminalCleanup() {
518
- try {
519
- const terminals = await this.tracker.fetchIssuesByStates(this.cfg.tracker.terminal_states);
520
- for (const issue of terminals) {
521
- try {
522
- await this.workspaces.remove(issue.identifier, this.cfg.hooks);
523
- }
524
- catch (err) {
525
- log.warn('terminal cleanup failed for issue', {
526
- issue_identifier: issue.identifier,
527
- error: err.message,
528
- });
529
- }
530
- }
531
- }
532
- catch (err) {
533
- log.warn('startup terminal cleanup fetch failed', { error: err.message });
534
- }
535
- }
536
- // Public hooks the runner uses to feed events back.
537
- reportTokenUsage(issueId, usage) {
538
- const e = this.running.get(issueId);
539
- if (!e)
540
- return;
541
- // §13.5: prefer absolute totals; track deltas to avoid double-counting.
542
- const dIn = Math.max(0, usage.input_tokens - e.last_reported_input_tokens);
543
- const dOut = Math.max(0, usage.output_tokens - e.last_reported_output_tokens);
544
- const dTot = Math.max(0, usage.total_tokens - e.last_reported_total_tokens);
545
- e.codex_input_tokens = usage.input_tokens;
546
- e.codex_output_tokens = usage.output_tokens;
547
- e.codex_total_tokens = usage.total_tokens;
548
- e.last_reported_input_tokens = usage.input_tokens;
549
- e.last_reported_output_tokens = usage.output_tokens;
550
- e.last_reported_total_tokens = usage.total_tokens;
551
- this.codexTotals.input_tokens += dIn;
552
- this.codexTotals.output_tokens += dOut;
553
- this.codexTotals.total_tokens += dTot;
554
- }
555
- reportRateLimits(_issueId, snapshot) {
556
- this.codexRateLimits = snapshot;
557
- }
558
- reportRuntimeEvent(issueId, ev) {
559
- const e = this.running.get(issueId);
560
- if (!e)
561
- return;
562
- e.last_codex_event = ev.event;
563
- e.last_codex_timestamp = ev.at;
564
- e.last_codex_message = ev.message;
565
- e.recent_events.push(ev);
566
- if (e.recent_events.length > 50)
567
- e.recent_events.shift();
568
- }
569
- reportSessionStarted(issueId, info) {
570
- const e = this.running.get(issueId);
571
- if (!e)
572
- return;
573
- e.session_id = info.sessionId;
574
- e.thread_id = info.threadId;
575
- e.codex_app_server_pid = info.pid;
576
- }
577
- reportTurnStarted(issueId, turnNumber) {
578
- const e = this.running.get(issueId);
579
- if (!e)
580
- return;
581
- e.turn_count = turnNumber;
582
- }
583
- /** §13.3 snapshot. */
584
- snapshot() {
585
- const generatedAt = new Date().toISOString();
586
- const liveExtraSeconds = [...this.running.values()]
587
- .map((e) => (Date.now() - Date.parse(e.started_at)) / 1000)
588
- .reduce((a, b) => a + b, 0);
589
- return {
590
- generated_at: generatedAt,
591
- counts: { running: this.running.size, retrying: this.retryAttempts.size },
592
- running: [...this.running.values()].map((e) => ({
593
- issue_id: e.issue_id,
594
- issue_identifier: e.identifier,
595
- issue_title: e.issue.title ?? '',
596
- issue_body: e.issue.description ?? '',
597
- state: e.issue.state,
598
- session_id: e.session_id,
599
- turn_count: e.turn_count,
600
- last_event: e.last_codex_event,
601
- last_message: e.last_codex_message,
602
- started_at: e.started_at,
603
- last_event_at: e.last_codex_timestamp,
604
- tokens: {
605
- input_tokens: e.codex_input_tokens,
606
- output_tokens: e.codex_output_tokens,
607
- total_tokens: e.codex_total_tokens,
608
- },
609
- steering_requested: e.steering_requested,
610
- steering_question: e.steering_question,
611
- steering_context: e.steering_context,
612
- marked_done: e.marked_done,
613
- })),
614
- retrying: [...this.retryAttempts.values()].map((r) => ({
615
- issue_id: r.issue_id,
616
- issue_identifier: r.identifier,
617
- attempt: r.attempt,
618
- due_at: new Date(r.due_at_ms).toISOString(),
619
- error: r.error,
620
- })),
621
- codex_totals: {
622
- ...this.codexTotals,
623
- seconds_running: this.codexTotals.seconds_running + liveExtraSeconds,
624
- },
625
- rate_limits: this.codexRateLimits,
626
- };
627
- }
628
- /** Issue-detail view used by the HTTP /api/v1/<identifier> endpoint. */
629
- detailByIdentifier(identifier) {
630
- let entry = null;
631
- for (const e of this.running.values()) {
632
- if (e.identifier === identifier) {
633
- entry = e;
634
- break;
635
- }
636
- }
637
- let retry = null;
638
- for (const r of this.retryAttempts.values()) {
639
- if (r.identifier === identifier) {
640
- retry = r;
641
- break;
642
- }
643
- }
644
- if (!entry && !retry)
645
- return null;
646
- return {
647
- issue_identifier: identifier,
648
- issue_id: entry?.issue_id ?? retry?.issue_id ?? null,
649
- status: entry ? 'running' : 'retrying',
650
- workspace: entry ? { path: entry.workspace_path } : null,
651
- attempts: {
652
- current_retry_attempt: retry?.attempt ?? null,
653
- },
654
- running: entry
655
- ? {
656
- session_id: entry.session_id,
657
- turn_count: entry.turn_count,
658
- state: entry.issue.state,
659
- started_at: entry.started_at,
660
- last_event: entry.last_codex_event,
661
- last_message: entry.last_codex_message,
662
- last_event_at: entry.last_codex_timestamp,
663
- tokens: {
664
- input_tokens: entry.codex_input_tokens,
665
- output_tokens: entry.codex_output_tokens,
666
- total_tokens: entry.codex_total_tokens,
667
- },
668
- }
669
- : null,
670
- retry: retry
671
- ? {
672
- attempt: retry.attempt,
673
- due_at: new Date(retry.due_at_ms).toISOString(),
674
- error: retry.error,
675
- }
676
- : null,
677
- recent_events: entry?.recent_events ?? [],
678
- last_error: entry?.last_error ?? retry?.error ?? null,
679
- tracked: {},
680
- };
681
- }
682
- }
683
- //# sourceMappingURL=orchestrator.js.map