@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,869 @@
1
+ // =============================================================================
2
+ // PHASE MODULE: Develop (apra-fleet-3swo.6.7).
3
+ //
4
+ // The FOURTH of runSprintCycle's twelve phase() boundaries -- one round of
5
+ // doer work: group this round's ready beads into streaks, pack the streaks
6
+ // into per-doer ordered worklists, and run every streak turn through the
7
+ // serialized doer barrier, recording a per-streak (and per-bead) outcome for
8
+ // each. Moved verbatim out of runner.js: every prompt, log line, dispatch
9
+ // option, sync bracket and outcome shape is byte-identical to the inline
10
+ // version, so the golden transcript is unchanged. Move-only, no behaviour
11
+ // change.
12
+ //
13
+ // WHERE THIS PHASE STARTS AND STOPS. It starts at its own phase() call and
14
+ // ends at the "streak outcomes" log line -- NOT at the next phase() call.
15
+ // Review runs in the SAME round loop iteration and consumes this phase's
16
+ // results, so the boundary is drawn where the doer work finishes rather than
17
+ // where the next label is emitted. Everything before the phase() call (the
18
+ // round loop's ready-set query, the scoped-replan branch -- now
19
+ // ./replan.mjs -- and the replan short-circuit that computes `currentReady`)
20
+ // stays in runner.js, because all three decide WHETHER this phase runs and
21
+ // two of them use loop control (`break`/`continue`) that cannot be expressed
22
+ // from inside a function.
23
+ //
24
+ // WHY devRounds IS PASSED IN ALREADY INCREMENTED. Same reason as ./replan.mjs:
25
+ // `devRounds` is the round loop's own counter, so the increment stays next to
26
+ // the loop and the incremented value arrives here only to build the
27
+ // `Develop C{cycle} R{devRounds}` label (and the two log lines that name the
28
+ // round).
29
+ //
30
+ // EXPLICIT STATE, NOT A CLOSURE. The inline version read roughly twenty
31
+ // runSprintCycle/round-loop locals off the enclosing scope. They arrive as
32
+ // one explicit state argument now, including `sprintState` -- the per-sprint
33
+ // resolved state from ../sprint-state.mjs, which the post-dispatch
34
+ // verifyDoerStreakClosed() read genuinely consumes -- and `parallel`, the
35
+ // workflow seam the per-worklist fan-out runs through. `perBeadFeedback` is a
36
+ // Map this phase only READS (the reviewer populates it); nothing here
37
+ // reassigns a caller binding, which is why the two values Review needs come
38
+ // back as an ordinary return value rather than being threaded.
39
+ //
40
+ // WHY THE RUNNER HELPERS ARE INJECTED RATHER THAN IMPORTED. claimBeadsBatched,
41
+ // verifyDoerStreakClosed, normalizeTierToken and kbQueryTerms are all exported
42
+ // BY runner.js. Importing them here would make phases/develop.mjs <->
43
+ // runner.js a circular pair for the sake of four helpers, so they come through
44
+ // the state argument instead -- the same rule phases/plan.mjs's header states.
45
+ // The dependencies that live in real sibling modules (dispatchRole/TURN_BASES,
46
+ // the prompt builders, the worklist/streak functions, policyFor, the error
47
+ // classes) are imported directly.
48
+ //
49
+ // GUARD COVERAGE: registered as 'phases/develop.mjs' in ../guarded-modules.mjs.
50
+ // It carries NO command() call site of its own -- every bd read/write it needs
51
+ // goes through an injected runner helper or a gitSync bracket -- plus the two
52
+ // dispatchRole call sites for the streak-assignment and doer ladders.
53
+ // =============================================================================
54
+
55
+ import { pathsFromText } from '../kb-hints.mjs';
56
+ import { WorkflowError } from '@apralabs/apra-fleet-workflow';
57
+
58
+ import { dispatchRole, TURN_BASES } from '../dispatch-role.mjs';
59
+ import { buildStreakAssignmentPrompt, buildDoerPrompt } from '../prompts.mjs';
60
+ import {
61
+ selectStreaks, groupStreaksFromLaneMetadata, streakRequiredTier,
62
+ resolveWorklistTierPolicy, hasContextHeadroomForResume, assignDoerWorklists,
63
+ } from '../worklists.mjs';
64
+ import { isPostDispatchSyncFailure } from '../errors.mjs';
65
+ import { isPermissionScopePostDispatchSyncFailure } from '../dispatch-failure.mjs';
66
+ import { policyFor } from '../role-policies.mjs';
67
+ import { CLAIMED_ELSEWHERE_REASON } from '../orphan-reclaim.mjs';
68
+
69
+ /**
70
+ * Runs ONE Develop round: streak grouping, per-doer worklist packing, and the
71
+ * serialized doer streak turns, with per-streak outcome attribution.
72
+ *
73
+ * @param {object} state Explicit phase state; see this file's header.
74
+ * @returns {Promise<{
75
+ * streakOutcomes: object[],
76
+ * readyTitleById: Map<string, string>,
77
+ * }>} `streakOutcomes` is this round's per-streak attribution (the Review
78
+ * phase filters its scope off it); `readyTitleById` is the stable
79
+ * (title, id) sort key Review's evidence command and reviewer prompt use so
80
+ * the non-deterministic completion order of parallel doer dispatches never
81
+ * leaks into a prompt.
82
+ */
83
+ export async function runDevelopPhase({
84
+ // Presentation + dispatch seams.
85
+ phase,
86
+ log,
87
+ command,
88
+ parallel,
89
+ dispatchCtx,
90
+ // Sprint identity/config.
91
+ cycle,
92
+ validated,
93
+ args,
94
+ backlogMember,
95
+ // Per-sprint resolved state (../sprint-state.mjs), the git/beads sync
96
+ // brackets every doer dispatch and verification read goes through, and the
97
+ // dashboard refresh each completed streak turn triggers.
98
+ sprintState,
99
+ gitSync,
100
+ updateDashboard,
101
+ // The KB clients the doer prompt is primed from.
102
+ kbPriming,
103
+ kbInjection,
104
+ kbWork,
105
+ // Per-round inputs. `devRounds` arrives already incremented (see header);
106
+ // `perBeadFeedback` is read-only here.
107
+ devRounds,
108
+ currentReady,
109
+ doerPool,
110
+ perBeadFeedback,
111
+ // Injected runner helpers -- see the header for why these are not imports.
112
+ claimBeadsBatched,
113
+ verifyDoerStreakClosed,
114
+ normalizeTierToken,
115
+ kbQueryTerms,
116
+ }) {
117
+ phase(`Develop C${cycle} R${devRounds}`);
118
+
119
+ // --- Permission-scope publish-blocked carry-over (apra-fleet-2wdc.4) ---
120
+ // A permission-scope post-dispatch sync failure (runStreakTurn's
121
+ // dispatchError handling below) can NEVER be fixed by re-dispatching: the
122
+ // App/token permission set that refused the push is the SAME set a fresh
123
+ // dispatch would push with, so a bead flagged here would otherwise be
124
+ // re-selected into `currentReady` every subsequent round -- and every
125
+ // subsequent CYCLE, since `sprintState` is created once per sprint and
126
+ // threaded unchanged through every phase call (see ../sprint-state.mjs) --
127
+ // spinning the sprint on a wall only an operator (granting the missing
128
+ // permission in the App's own settings) can clear. `permissionScopeBlockedBeads`
129
+ // is lazily attached to `sprintState` rather than passed as its own
130
+ // parameter, so this stays a develop.mjs-local concern with no change to
131
+ // sprint-state.mjs's documented shape or to runner.js's call site --
132
+ // consistent with review.mjs's own precedent of mutating a caller-held
133
+ // Map/Set in place (`replanIds`/`replannedThisCycle`) rather than
134
+ // threading a new return value through every round.
135
+ sprintState.permissionScopeBlockedBeads = sprintState.permissionScopeBlockedBeads || new Map();
136
+ const permissionScopeBlockedBeads = sprintState.permissionScopeBlockedBeads;
137
+ const carriedOverBlocked = currentReady.filter((b) => permissionScopeBlockedBeads.has(b.id));
138
+ if (carriedOverBlocked.length > 0) {
139
+ for (const b of carriedOverBlocked) {
140
+ log(`[Sync] PUBLISH BLOCKED (carried over from an earlier round this sprint): bead '${b.id}' -- ${permissionScopeBlockedBeads.get(b.id)}`);
141
+ }
142
+ log(
143
+ `Develop C${cycle} R${devRounds}: excluding ${carriedOverBlocked.length} bead(s) already publish-blocked by a ` +
144
+ `permission-scope sync failure (${carriedOverBlocked.map((b) => b.id).join(', ')}) from this round's streak ` +
145
+ 'assignment -- not re-dispatching for that reason alone until an operator grants the missing permission.'
146
+ );
147
+ currentReady = currentReady.filter((b) => !permissionScopeBlockedBeads.has(b.id));
148
+ }
149
+ if (currentReady.length === 0) {
150
+ log(`Develop C${cycle} R${devRounds}: every still-ready bead this round is publish-blocked -- skipping streak assignment and dispatch entirely.`);
151
+ return { streakOutcomes: [], readyTitleById: new Map() };
152
+ }
153
+
154
+ // --- Streak grouping ------------------------------------------
155
+ // PREFER deterministic grouping straight from the planner's lane
156
+ // metadata (`streak`/`streakOrder`, emitted per planner.md through
157
+ // the same `--metadata` channel as `model`), intersected with THIS
158
+ // round's ready set. When every ready bead carries a `streak` id the
159
+ // grouping is fully determined by the plan, so the runtime "Streak
160
+ // Assignment" LLM dispatch is skipped entirely -- deterministic,
161
+ // zero prompt drift, one fewer agent round-trip. The LLM path below
162
+ // is retained ONLY as a fallback for plans that lack lane metadata;
163
+ // see groupStreaksFromLaneMetadata() for the all-or-nothing rule.
164
+ let streaks, usedFallback, reason;
165
+ const laneGrouping = groupStreaksFromLaneMetadata(currentReady);
166
+ if (laneGrouping) {
167
+ ({ streaks, reason } = laneGrouping);
168
+ usedFallback = false;
169
+ log(
170
+ `Streak grouping: deterministic from lane metadata -- ${laneGrouping.streaks.length} streak(s), ` +
171
+ `no Streak Assignment dispatch (${laneGrouping.streaks.map((s) => `[${s.map((b) => b.id).join(', ')}]`).join(' ')}).`
172
+ );
173
+ } else {
174
+ // --- Streak assignment (FALLBACK) ---------------------------------
175
+ // Reached only when the plan lacks lane metadata (see above).
176
+ // Schema-validated {streaks: string[][]}; falls back to a
177
+ // deterministic one-bead-per-streak grouping whenever the candidate
178
+ // does not cover every ready bead id exactly once -- invalid output,
179
+ // or agent()'s own bounded schema-repair loop exhausted. See
180
+ // selectStreaks().
181
+ log('Streak grouping: no lane metadata on this round\'s ready beads -- falling back to LLM Streak Assignment dispatch (back-compat with pre-eft.76 plans).');
182
+ // apra-fleet-3swo.5.3: the 'streak-assignment' row of
183
+ // role-policies.mjs, executed by dispatchRole. That row owns the
184
+ // one variance nothing else in the table has -- NO git-sync
185
+ // bracket at all, because this is pure compute with no repo access
186
+ // -- plus the deliberate absence of an agentType (this call has no
187
+ // vendored persona of its own; see the streakAssignment schema
188
+ // comment in contracts.mjs, and activating the full `planner`
189
+ // persona on this narrow grouping task makes the model go
190
+ // exploring with its Bash/Read/Grep tools instead of answering
191
+ // from the prompt, which can run long enough to hit the transport
192
+ // timeout), the planner MEMBER borrowed purely for model-tier
193
+ // routing, its own cheap tier, and the transport-default budgets.
194
+ //
195
+ // The bounded semantic-repair re-ask is the row's
196
+ // `semanticRepairReAsks: 1` plus its `select-streaks-validate`
197
+ // postResult step: agent()'s own schema-repair only fixes
198
+ // JSON-shape problems, so a candidate can be schema-valid yet
199
+ // semantically invalid (e.g. bead ids returned with their prefix
200
+ // stripped). Dropping the whole grouping to the one-bead-per-streak
201
+ // fallback silently discards sequencing intent, which on a
202
+ // multi-doer fleet would PARALLELIZE beads the model said must run
203
+ // sequentially. The engine re-asks ONCE with the exact validation
204
+ // failure -- guarded, never looped -- and only then falls back.
205
+ //
206
+ // `validate` is that step: selectStreaks() is what decides whether
207
+ // the fallback is used, and the engine hands its result back as
208
+ // `validation` on BOTH the success path and the degrade path (a
209
+ // spent ladder validates a null candidate, which is exactly the
210
+ // deterministic one-bead-per-streak grouping the old ladder fell
211
+ // back to).
212
+ const streakPrompt = buildStreakAssignmentPrompt({ readyBeadIds: currentReady.map((b) => b.id) });
213
+ const streakOutcome = await dispatchRole(dispatchCtx, 'streak-assignment', {
214
+ prompt: streakPrompt,
215
+ label: 'Streak Assignment',
216
+ repairPrompt: (rejectionReason) => streakPrompt
217
+ + `\n\nYour previous answer was REJECTED: ${rejectionReason}. `
218
+ + 'Return the bead ids exactly as listed -- verbatim, full prefix included.',
219
+ repairLabel: 'Streak Assignment (semantic repair)',
220
+ roleLabel: 'Streak Assignment',
221
+ validate: (candidate) => {
222
+ const selected = selectStreaks(candidate, currentReady);
223
+ return { ok: !selected.usedFallback, reason: selected.reason, result: selected };
224
+ },
225
+ });
226
+ // No duplicate log() dump -- see dispatchReview() for why. The
227
+ // standard AGENT row (label 'Streak Assignment') already renders
228
+ // through the same generic path as every other dispatch.
229
+ ({ streaks, usedFallback, reason } = streakOutcome.validation);
230
+ if (usedFallback) {
231
+ log(`Streak Assignment: using one-bead-per-streak fallback (${reason}).`);
232
+ }
233
+ } // end LLM-fallback branch (no lane metadata)
234
+ // Title lookup for the assignedBeadIds sort below. Doer dispatches
235
+ // run in `parallel`, so the order their outcomes are recorded in is
236
+ // completion order -- correctly non-deterministic. The Review
237
+ // phase's `bd show` evidence command and reviewer prompt must not
238
+ // inherit that race as prompt drift; see the sort-by-title comment
239
+ // above for why `title` is the only stable key.
240
+ const readyTitleById = new Map(currentReady.map((b) => [b.id, b.title]));
241
+
242
+ // beadId -> declared model tier, read out of the SAME `bd list
243
+ // --ready --json` response already fetched to build `currentReady`:
244
+ // that response carries each bead's full record including metadata,
245
+ // so no extra `bd show` round-trip is needed to recover the `model`
246
+ // key the planner records via `--metadata`. See resolveDoerModel()
247
+ // for how a possibly-multi-bead streak's model is picked from this
248
+ // map. normalizeTierToken() guards this single read site -- see its
249
+ // doc comment.
250
+ const modelByBeadId = new Map(currentReady.map((b) => [b.id, normalizeTierToken(b.metadata && b.metadata.model)]));
251
+
252
+ // --- Doer barrier: serialized turns, isolated failures ---
253
+ // Streak turns are strictly serialized through `globalDoerTurn`: a
254
+ // promise chain each turn awaits before doing any work and releases
255
+ // in a `finally`, so at most one doer dispatch is ever in flight and
256
+ // a thrown streak can never deadlock the next one. Serialization is
257
+ // required because concurrent writers break the
258
+ // fast-forward-by-construction invariant the git/beads sync brackets
259
+ // depend on. parallel() with continueOnError is retained only for
260
+ // per-worklist failure isolation and outcome accounting.
261
+ let globalDoerTurn = Promise.resolve();
262
+ const streakOutcomes = [];
263
+
264
+ // --- Per-doer ORDERED WORKLISTS -----------------------------------
265
+ // When this round has more ready streaks than doers, pack them into
266
+ // per-doer ordered worklists (dependency order -> priority -> the
267
+ // existing tie-break, plus tier grouping and an effort budget -- see
268
+ // assignDoerWorklists) instead of feeding one streak per doer. Each
269
+ // doer then works its worklist back to back: mode 'resume' (the
270
+ // default) re-dispatches per streak, resuming the SAME doer session
271
+ // by explicit session id so warm context carries across streaks
272
+ // while every engine checkpoint (sync bracket, per-streak failure
273
+ // attribution) is kept BETWEEN streaks; mode 'batch' sends one
274
+ // dispatch carrying the whole ordered worklist. When streaks <=
275
+ // doers, assignDoerWorklists is a pass-through.
276
+ const worklistMode = validated.doerWorklistMode || 'resume';
277
+ const { tierHomogeneous } = resolveWorklistTierPolicy({
278
+ mode: worklistMode,
279
+ resumeModelSwitch: validated.resumeModelSwitch === true,
280
+ });
281
+ const worklistPacking = assignDoerWorklists(streaks, doerPool.length, {
282
+ effortBudget: validated.worklistEffortBudget,
283
+ tierHomogeneous,
284
+ });
285
+ if (worklistPacking.packed) {
286
+ const fmtStreak = (s) => `(${s.map((b) => b.id).join(', ')})`;
287
+ const fmtWorklist = (wl) => `[${wl.map(fmtStreak).join(' -> ')}]`;
288
+ log(
289
+ `Doer worklists: ${streaks.length} ready streak(s) > ${doerPool.length} doer(s) -- ` +
290
+ `packed into per-doer ordered worklists (mode: ${worklistMode}, ` +
291
+ `${tierHomogeneous ? 'tier-homogeneous' : 'mixed tiers allowed (resume_model_switch)'}): ` +
292
+ worklistPacking.worklists.map((wl, i) => `doer '${doerPool[i % doerPool.length]}': ${fmtWorklist(wl)}`).join('; ') +
293
+ (worklistPacking.overflow.length > 0
294
+ ? `; overflow queued to the next round (effort budget/tier grouping): ${worklistPacking.overflow.map(fmtStreak).join(' ')}`
295
+ : '')
296
+ );
297
+ }
298
+
299
+ // One streak's full dispatch turn (claim -> dispatch -> verify ->
300
+ // attribute), run once per streak of a worklist. Each call captures
301
+ // and replaces the global gate synchronously, before its first
302
+ // `await`, so the FIRST turn of each worklist enqueues in
303
+ // deterministic worklist order; subsequent turns of a worklist
304
+ // enqueue as their predecessors complete.
305
+ // `worklistCtx` carries the doer's session id + last reported usage
306
+ // across the streaks of ONE worklist (never across worklists/doers);
307
+ // `batchStreaks` (mode 'batch') is the ordered list of sub-streaks a
308
+ // single merged dispatch carries, for per-streak outcome
309
+ // attribution.
310
+ const runStreakTurn = async ({ streak, doerMember, worklistCtx, worklistPosition = 0, worklistLength = 1, packed = false, batchStreaks = null }) => {
311
+ const priorTurn = globalDoerTurn;
312
+ let releaseTurn;
313
+ globalDoerTurn = new Promise((resolve) => { releaseTurn = resolve; });
314
+ await priorTurn;
315
+ try {
316
+ let actualBeadIds = streak.map((b) => b.id); // May be reduced by claiming if assignee is set
317
+ let hasClaimedBeads = false; // Track whether we've done claiming yet
318
+ // Set when the claim found every bead of this streak already held by
319
+ // another sprint. Carried onto the failed outcome as the STRUCTURED
320
+ // failureReason the in-run orphan reclaim (runner.js) keys on, so a
321
+ // claim another sprint holds is identified without reading message
322
+ // text -- and sticky, so a retried attempt refuses the same way
323
+ // instead of dispatching a doer on beads it does not own.
324
+ let claimedElsewhere = false;
325
+
326
+ // The base turn budget the resume ladder escalates from. Read
327
+ // out of the ENGINE's TURN_BASES (apra-fleet-3swo.5.7) rather
328
+ // than re-declared here: the 'doer' policy row records its turn
329
+ // budget symbolically, by the NAME of this constant, and a
330
+ // second copy in runner.js is a second thing to drift.
331
+ const BASE_DOER_MAX_TURNS = TURN_BASES.BASE_DOER_MAX_TURNS;
332
+ // apra-fleet-3swo.5.7: the doer ladder -- its dispatch, its
333
+ // pushCode/pushBeads git-sync bracket, its bounded escalating
334
+ // max_turns resume ladder, its closed-streak short-circuit, its
335
+ // refusal to re-dispatch a streak whose post-dispatch sync
336
+ // failed, its auth self-heal plus bounded retry, its generic
337
+ // retry onto the streak branch's remote tip, and its per-bead
338
+ // attribution degrade -- is now the 'doer'/'doer-resume' rows of
339
+ // fleet-sprint/role-policies.mjs, executed by dispatchRole.
340
+ //
341
+ // THREE things make this ladder different from every other one,
342
+ // and all three are expressed as data:
343
+ //
344
+ // 1. The claim runs INSIDE the bracket. Per-bead claiming is
345
+ // only meaningful once the bracket's D-pull has brought in
346
+ // which beads other sprints already hold, so
347
+ // 'claim-beads-batched' is one of role-policies.mjs's
348
+ // PRE_DISPATCH_STEPS_IN_BRACKET. It can NARROW the streak,
349
+ // which is why the prompt, the label and the tier this
350
+ // dispatch is priced at are all built by `prepare` -- inside
351
+ // the bracket, after the claim -- rather than passed in.
352
+ //
353
+ // 2. The resume ladder ESCALATES and is bounded. The row records
354
+ // resumeAttempts: 2 and a 'runtime' turn budget; the bindings
355
+ // thunk below is handed the attempt number and doubles from
356
+ // the base each time. A resume that fails for any reason
357
+ // other than spending its turns again is not something more
358
+ // turns can fix, and the engine stops escalating there.
359
+ //
360
+ // 3. A turn-exhausted streak whose beads are ALL already closed
361
+ // is a SUCCESS, not a failure -- the doer merely ran past its
362
+ // VERIFY checkpoint. That is the 'verify-streak-closed'
363
+ // preDispatch step on the RESUME dispatch, recorded before
364
+ // 'kill-stale-session' precisely so the check happens before
365
+ // anything is killed or re-dispatched, and it short-circuits
366
+ // the resume entirely.
367
+ //
368
+ // The per-bead attribution below is what the CALLER does with a
369
+ // failed outcome, so it stays here: the row's degrade is
370
+ // 'per-bead-attribution' and fabricates nothing.
371
+ const streakScope = () => `[${actualBeadIds.join(', ')}]`;
372
+ const doerOutcome = await dispatchRole(dispatchCtx, 'doer', {
373
+ roleLabel: `Doer streak ${streakScope()}`,
374
+ // Never used: `prepare` builds both prompts, because both
375
+ // depend on the streak the claim actually secured.
376
+ prompt: null,
377
+ resumePrompt: null,
378
+ onSessionId: (id, meta) => {
379
+ if (!worklistCtx) return;
380
+ worklistCtx.sessionId = id;
381
+ worklistCtx.usage = meta && meta.usage ? meta.usage : null;
382
+ },
383
+ // The escalating resume ladder: BASE * 2^n, bounded by the
384
+ // row's resumeAttempts. resumeAttempt 0 is the main
385
+ // dispatch, which takes its budget from the row's constant.
386
+ bindings: ({ resumeAttempt }) => ({
387
+ doerMember,
388
+ maxTurns: BASE_DOER_MAX_TURNS * (2 ** Math.max(resumeAttempt, 1)),
389
+ }),
390
+ // Claim once per streak turn, after the D-pull. Batched into
391
+ // ONE bd update id-list --claim --json call
392
+ // (apra-fleet-7h6n.7) instead of one call per bead -- see the
393
+ // claimBeadsBatched doc comment above for the verified
394
+ // multi-id --claim contract (non-atomic, JSON-array-only
395
+ // success signal) this relies on.
396
+ claimBeads: async () => {
397
+ const claimedElsewhereError = () => new WorkflowError(
398
+ `All beads already claimed by other sprints`,
399
+ { details: { beadIds: actualBeadIds, reason: CLAIMED_ELSEWHERE_REASON } }
400
+ );
401
+ if (claimedElsewhere) throw claimedElsewhereError();
402
+ if (hasClaimedBeads) return;
403
+ hasClaimedBeads = true;
404
+ if (!validated.assignee) return;
405
+ const { claimedBeadIds, skippedBeadIds } = await claimBeadsBatched({
406
+ command, backlogMember, beadIds: actualBeadIds, log,
407
+ });
408
+ if (claimedBeadIds.length === 0) {
409
+ // All beads in this streak are already claimed by
410
+ // other sprints. Skip this streak entirely.
411
+ log(`Doer streak: all beads ${streakScope()} are already claimed by other sprints -- skipping this streak.`);
412
+ claimedElsewhere = true;
413
+ throw claimedElsewhereError();
414
+ }
415
+ if (skippedBeadIds.length > 0) {
416
+ actualBeadIds = claimedBeadIds; // Only the successfully claimed ones
417
+ }
418
+ },
419
+ // CRITICAL: never trust the doer's own success claim -- verify
420
+ // via `bd show` that the assigned bead ids are actually
421
+ // closed. verifyDoerStreakClosed() D-pulls the orchestrator's
422
+ // OWN beads clone BEFORE this read: the doer closed its beads
423
+ // in ITS clone and D-pushed them, so on a multi-member sprint
424
+ // the orchestrator's clone is a DIFFERENT clone and without
425
+ // that D-pull this read sees stale (still-open) status and
426
+ // EVERY remote doer streak is falsely marked FAILED.
427
+ // (apra-fleet-p2to.4.1) it D-pulls internally
428
+ // (DoltSync.syncBefore) -- treat the whole call as one bracket.
429
+ verifyStreakClosed: async (phase) => {
430
+ const unclosed = await gitSync.withOpenSyncBracket(() => verifyDoerStreakClosed({
431
+ command, backlogMember, beadIds: actualBeadIds, log, args, sprintState,
432
+ }));
433
+ if (phase === 'preDispatch' && unclosed.length === 0) {
434
+ log(
435
+ `Doer streak ${streakScope()} on member '${doerMember}' exhausted its turn limit ` +
436
+ '(max_turns), but all assigned bead id(s) are already closed -- WARNING: the doer ' +
437
+ 'missed the VERIFY checkpoint (kept running after its last bd close instead of ' +
438
+ 'stopping). Treating this streak as a successful completion, not a failure; ' +
439
+ 'issuing NO resume dispatch.'
440
+ );
441
+ }
442
+ return unclosed;
443
+ },
444
+ // Built INSIDE the bracket, after the claim: the streak this
445
+ // dispatch actually owns is only known once the claim has run.
446
+ prepare: async ({ dispatch, resumeAttempt, freshSession }) => {
447
+ // freshSession: the engine has no explicit session id to resume
448
+ // (or the id was not found), so this secondary dispatch is a
449
+ // FRESH session and gets the FULL streak prompt below, with the
450
+ // worklist's warm-session resume suppressed.
451
+ if (dispatch.kind === 'max-turns-resume' && !freshSession) {
452
+ const resumeTurns = BASE_DOER_MAX_TURNS * (2 ** resumeAttempt);
453
+ log(
454
+ `Doer streak ${streakScope()} on member '${doerMember}' exhausted its turn limit ` +
455
+ `(max_turns) -- resuming the same session with max_turns=${resumeTurns} ` +
456
+ `(attempt ${resumeAttempt}/${policyFor('doer').retry.resumeAttempts}) instead of ` +
457
+ 'giving up or regrouping.'
458
+ );
459
+ return {
460
+ // Restate the streak's scope: a resumed dispatch
461
+ // replaces the delivered prompt artifact, so a
462
+ // bare "continue" leaves the session with no
463
+ // record of what it was asked to do.
464
+ prompt:
465
+ 'Continue exactly where you left off from this same session -- do not restart, re-read from scratch, or re-plan. ' +
466
+ `Your scope, restated so a resumed dispatch never loses it: assigned bead id(s) ${actualBeadIds.join(', ')} on sprint branch ${validated.branch}. ` +
467
+ 'Pick up from your last action on those bead(s) and proceed to the VERIFY checkpoint.',
468
+ label: `Streak ${streakScope()} (resume, max_turns=${resumeTurns})`,
469
+ };
470
+ }
471
+
472
+ const feedbackForStreak = actualBeadIds
473
+ .map((id) => perBeadFeedback.get(id))
474
+ .filter(Boolean)
475
+ .join('\n\n');
476
+
477
+ // Resolve the model to price this dispatch against. Beads
478
+ // are normally streaked one-per-model, but when a streak
479
+ // DOES span beads with different declared models this
480
+ // deterministically picks the first (by bead-id order, not
481
+ // dispatch completion order) and logs the discrepancy
482
+ // rather than guessing a blended price. A bead with no
483
+ // `model` metadata resolves to `undefined`, which
484
+ // FleetWorkflow treats the same as never passing `model`
485
+ // -- the dispatch still runs, it is simply not priced
486
+ // (calculateCost() returns null; see pricing.mjs).
487
+ // CAVEAT: this is the model the PLANNER ASKED the doer to
488
+ // run on. The fleet does not echo back the model it
489
+ // actually resolved/ran with, so this -- and therefore
490
+ // budget._spent / BudgetExceededError -- is an ESTIMATE,
491
+ // not a verified actual.
492
+ const streakModels = [...new Set(actualBeadIds.map((id) => modelByBeadId.get(id)).filter(Boolean))];
493
+ let doerModel = streakModels[0];
494
+ // In a PACKED worklist round a streak must never dispatch
495
+ // below its REQUIRED tier (the max of its beads' declared
496
+ // models) -- override the first-bead pick with that tier.
497
+ // The non-packed (streaks <= doers) path keeps the
498
+ // first-bead behavior.
499
+ if (packed) {
500
+ const requiredTier = streakRequiredTier(streak);
501
+ if (requiredTier) doerModel = requiredTier;
502
+ }
503
+ if (streakModels.length > 1) {
504
+ log(`Doer streak ${streakScope()} spans beads with different declared models (${streakModels.join(', ')}) -- pricing this dispatch as '${doerModel}'.`);
505
+ }
506
+
507
+ // Mode (ii) RESUMED SEQUENCE: resume the doer's OWN
508
+ // prior-streak session by EXPLICIT session id when one was
509
+ // captured for this worklist and
510
+ // hasContextHeadroomForResume() passes. On refusal, or
511
+ // when no session id exists (first streak of the worklist,
512
+ // provider without resume support, prior streak failed),
513
+ // fall back to a FRESH session carrying the FULL prompt --
514
+ // never a delta prompt into a fresh session.
515
+ let worklistResumeArg = false;
516
+ if (worklistCtx && worklistCtx.sessionId && !freshSession) {
517
+ if (hasContextHeadroomForResume(worklistCtx.usage)) {
518
+ worklistResumeArg = worklistCtx.sessionId;
519
+ } else {
520
+ log(
521
+ `Doer worklist on '${doerMember}': context headroom insufficient to resume session ` +
522
+ `'${worklistCtx.sessionId}' for streak ${worklistPosition + 1}/${worklistLength} ` +
523
+ `${streakScope()} -- starting a FRESH session with the full prompt instead.`
524
+ );
525
+ worklistCtx.sessionId = null;
526
+ worklistCtx.usage = null;
527
+ }
528
+ }
529
+ if (worklistResumeArg) {
530
+ log(
531
+ `Doer worklist on '${doerMember}': dispatching streak ${worklistPosition + 1}/${worklistLength} ` +
532
+ `${streakScope()} as a RESUME of session '${worklistResumeArg}'` +
533
+ `${doerModel ? ` (model=${doerModel})` : ''} -- warm context carries over.`
534
+ );
535
+ }
536
+
537
+ // KNOWLEDGE BANK: injected unless this doer member's own fleet
538
+ // MCP was verified at sprint init (it then reads the KB
539
+ // itself); otherwise fetched from the repository's
540
+ // kb_maintainer, ranked by the bead titles and the files the
541
+ // lane touches (kb-injection.mjs).
542
+ const laneBeads = Array.isArray(streak) ? streak : [];
543
+ const doerKbBlock = kbInjection
544
+ ? await kbInjection.blockFor({
545
+ role: 'doer',
546
+ member: doerMember,
547
+ context: {
548
+ beadIds: actualBeadIds,
549
+ beadTitles: laneBeads,
550
+ laneFiles: pathsFromText(laneBeads.map((b) => b && `${b.description || ''}\n${b.acceptance_criteria || ''}\n${b.notes || ''}`)),
551
+ },
552
+ captureChannel: true,
553
+ })
554
+ : undefined;
555
+ const basePrompt = buildDoerPrompt({
556
+ beadIds: actualBeadIds,
557
+ branch: validated.branch,
558
+ feedback: feedbackForStreak || null,
559
+ kbKnowledge: kbInjection ? undefined : kbPriming.knowledgeOf(doerMember),
560
+ kbBlock: doerKbBlock,
561
+ });
562
+ let doerPrompt = basePrompt;
563
+ if (batchStreaks) {
564
+ // Mode (i) BATCH: one dispatch carries the whole
565
+ // ordered worklist. The prompt names each streak
566
+ // boundary and mandates strict in-order completion.
567
+ doerPrompt =
568
+ 'ORDERED MULTI-STREAK WORKLIST (single batched dispatch): your assigned beads below form ' +
569
+ `${batchStreaks.length} streak(s). Work them strictly in this order, fully completing each ` +
570
+ 'streak (implement, verify, `bd close` its beads) before starting the next: ' +
571
+ batchStreaks.map((s, i) => `streak ${i + 1}: [${s.map((b) => b.id).join(', ')}]`).join('; ') +
572
+ '.\n\n' + basePrompt;
573
+ } else if (worklistResumeArg) {
574
+ // A resumed dispatch restates its FULL scope (the
575
+ // entire buildDoerPrompt output), never a bare
576
+ // "continue" delta -- the preamble only tells the
577
+ // session it may reuse its warm context.
578
+ doerPrompt =
579
+ 'WORKLIST CONTINUATION: you are the same doer session that just completed the previous ' +
580
+ 'streak of your worklist. Your warm context (repository layout, conventions, files already ' +
581
+ 'read) carries over -- do not re-explore the repository from scratch. Your NEXT assigned ' +
582
+ 'streak follows, with its scope restated in full.\n\n' + basePrompt;
583
+ }
584
+ return {
585
+ prompt: doerPrompt,
586
+ label: `Streak ${streakScope()}`,
587
+ resumeArg: worklistResumeArg,
588
+ bindings: { doerMember, doerModel },
589
+ };
590
+ },
591
+ });
592
+ const report = doerOutcome.value;
593
+ const dispatchError = doerOutcome.error;
594
+ // A streak that needed a second dispatch of any kind -- a generic
595
+ // retry or a turn-exhaustion resume -- is recorded as retried.
596
+ const wasRetried = doerOutcome.attempts > 1 || doerOutcome.resumesIssued > 0;
597
+ if (dispatchError) {
598
+ // A dispatch-level failure means this worklist's captured
599
+ // session can no longer be trusted (the failed attempt may
600
+ // have run partial turns in it) -- clear it so the worklist's
601
+ // NEXT streak starts from a FRESH session with the full
602
+ // prompt, mirroring createRoundSessionRegistry's
603
+ // clear-on-failure rule. (The max-turns ladder is unaffected:
604
+ // it resumes the failed dispatch's own explicit session id, or
605
+ // starts a fresh full-prompt session, never this worklist id.)
606
+ if (worklistCtx) {
607
+ worklistCtx.sessionId = null;
608
+ worklistCtx.usage = null;
609
+ }
610
+ // (apra-fleet-2wdc.4) A permission-scope post-dispatch sync
611
+ // failure is a DISTINCT case from every other post-dispatch sync
612
+ // failure: it is not merely un-redispatchable THIS turn (every
613
+ // PostDispatchSyncError already gets that via dispatch-role.mjs's
614
+ // skipRedispatchOnPostDispatchSyncFailure) -- it can never be
615
+ // fixed by ANY future redispatch either, because the App/token
616
+ // permission set that refused the push is exactly what a fresh
617
+ // dispatch would push with again. Detected below and handled
618
+ // distinctly from the generic isPostDispatchSyncFailure branch.
619
+ if (isPermissionScopePostDispatchSyncFailure(dispatchError)) {
620
+ log(`[Sync] PUBLISH BLOCKED: doer streak ${streakScope()} on member '${doerMember}' COMPLETED and its work is committed locally, but the post-dispatch G-push was refused for a permission-scope reason that a redispatch cannot fix: ${dispatchError.message} Reporting this streak as work done/publish-blocked, NOT as a failed dispatch -- not re-dispatching these bead(s) again this sprint until an operator grants the missing permission.`);
621
+ } else if (isPostDispatchSyncFailure(dispatchError)) {
622
+ log(`Doer streak ${streakScope()} on member '${doerMember}' COMPLETED but its post-dispatch sync failed: ${dispatchError.message} Not re-dispatching -- the work is already committed locally.`);
623
+ } else if (doerOutcome.resumesIssued > 0) {
624
+ log(`Doer streak ${streakScope()} on member '${doerMember}' still failing after ${doerOutcome.resumesIssued} resume attempt(s) (last: ${dispatchError.message}) -- flagging as too-complex-for-one-streak.`);
625
+ }
626
+ }
627
+
628
+ if (dispatchError) {
629
+ const permissionScopeBlocked = isPermissionScopePostDispatchSyncFailure(dispatchError);
630
+ // Per-bead failure attribution: a dispatch-level throw
631
+ // (crash, transport error, exhausted resumes) does NOT mean
632
+ // none of this streak's beads closed -- a doer can close bead
633
+ // 1 of 2, then error out on bead 2. Verify via `bd show`
634
+ // (same D-pull-then-read as the happy path below) rather than
635
+ // assuming every bead in the streak is still open, so
636
+ // completed work is never discarded because a sibling in the
637
+ // same streak was never reached.
638
+ // (apra-fleet-p2to.4.1) verifyDoerStreakClosed() D-pulls internally
639
+ // (DoltSync.syncBefore) -- treat the whole call as one sync bracket.
640
+ const unclosedIds = await gitSync.withOpenSyncBracket(() => verifyDoerStreakClosed({
641
+ command, backlogMember, beadIds: actualBeadIds, log, args, sprintState,
642
+ }));
643
+ const closedIds = actualBeadIds.filter((id) => !unclosedIds.includes(id));
644
+ log(`Doer streak attribution [${actualBeadIds.join(', ')}]: closed=[${closedIds.join(', ')}] failed=[${unclosedIds.join(', ')}] (dispatch error: ${dispatchError.message}).`);
645
+ // Structured failure facts for the in-run orphan reclaim
646
+ // (runner.js, ../orphan-reclaim.mjs): WHY the streak failed, read
647
+ // off the error's own fields (never its message text), and
648
+ // whether the turn COMPLETED with only its post-dispatch sync
649
+ // failing (work committed locally -- never re-laned).
650
+ const failureFacts = {
651
+ failureReason: claimedElsewhere
652
+ ? CLAIMED_ELSEWHERE_REASON
653
+ : ((dispatchError.details && dispatchError.details.reason) || 'dispatch-error'),
654
+ ...(isPostDispatchSyncFailure(dispatchError) ? { postDispatchSyncFailed: true } : {}),
655
+ };
656
+ // NOTE ON REVIEW SCOPE: review.mjs's reviewScopeBeadIds() builds the
657
+ // round's review scope from each outcome's `closedIds` -- this
658
+ // engine's own read-back of the shared beads DB just above, never the
659
+ // doer's claim -- so a failed or BLOCKED streak still contributes the
660
+ // beads it verifiably closed. Two flags carry "the close was not
661
+ // published" and make reviewScopeBeadIds skip the outcome: `publishBlocked`
662
+ // (permission-scope G-push refusal; the App/token cannot push, see
663
+ // member-sync.mjs's syncMemberAfterOrdered) and `postDispatchSyncFailed`
664
+ // (any other post-dispatch sync failure: a failed G-push skips the
665
+ // D-push, so the closes never reached the shared DB even though the
666
+ // doer's own clone shows them closed). Both are set on EVERY outcome
667
+ // of the dispatch, including sub-outcomes whose beads all closed.
668
+ // A single-streak dispatch error whose beads ALL verified closed is
669
+ // recorded as success/retried (the work stands); only still-open
670
+ // beads make an outcome 'failed' and eligible for re-laning.
671
+ const unpublishedFlags = {
672
+ ...(permissionScopeBlocked ? { publishBlocked: true } : {}),
673
+ ...(isPostDispatchSyncFailure(dispatchError) ? { postDispatchSyncFailed: true } : {}),
674
+ };
675
+ if (batchStreaks) {
676
+ // Mode (i): PER-STREAK attribution for a failed batch
677
+ // dispatch -- a sub-streak whose beads all verifiably
678
+ // closed before the failure keeps its work (outcome
679
+ // 'success', its closes stand and go to review); only
680
+ // sub-streaks with still-open beads are 'failed' and
681
+ // re-lane next round (permission-scope ones are additionally
682
+ // recorded on `permissionScopeBlockedBeads` below so they are
683
+ // excluded from re-laning instead of actually retried).
684
+ for (const sub of batchStreaks) {
685
+ const subIds = sub.map((b) => b.id).filter((id) => actualBeadIds.includes(id));
686
+ if (subIds.length === 0) continue;
687
+ const subUnclosed = subIds.filter((id) => unclosedIds.includes(id));
688
+ const subClosed = subIds.filter((id) => !subUnclosed.includes(id));
689
+ streakOutcomes.push({
690
+ beadIds: subIds, doerMember, wasRetried, report: null,
691
+ unclosedIds: subUnclosed, closedIds: subClosed,
692
+ outcome: subUnclosed.length > 0 ? 'failed' : (wasRetried ? 'retried' : 'success'),
693
+ ...(subUnclosed.length > 0 ? {
694
+ error: dispatchError.message,
695
+ ...failureFacts,
696
+ } : {}),
697
+ ...unpublishedFlags,
698
+ });
699
+ }
700
+ } else {
701
+ streakOutcomes.push({
702
+ beadIds: actualBeadIds, doerMember, wasRetried,
703
+ // A claimed-elsewhere streak never ran, so its beads (possibly
704
+ // closed by another sprint) stay 'failed' here.
705
+ outcome: unclosedIds.length > 0 || claimedElsewhere ? 'failed' : (wasRetried ? 'retried' : 'success'),
706
+ report: null, unclosedIds,
707
+ closedIds: claimedElsewhere ? [] : closedIds,
708
+ error: dispatchError.message,
709
+ ...failureFacts,
710
+ ...unpublishedFlags,
711
+ });
712
+ }
713
+ if (permissionScopeBlocked) {
714
+ // Record every still-open bead id so future rounds AND
715
+ // future cycles this sprint skip them outright (see the
716
+ // carry-over filter at the top of this function) instead of
717
+ // re-selecting them into `currentReady` and reproducing the
718
+ // identical refusal. Beads this dispatch DID manage to close
719
+ // (closedIds) are deliberately excluded -- their work already
720
+ // stands and they are not "ready" again regardless.
721
+ for (const id of unclosedIds) {
722
+ permissionScopeBlockedBeads.set(id, dispatchError.message);
723
+ }
724
+ // Refresh the dashboard/terminal summary state so the
725
+ // publish-blocked outcome (and its operator referral) is
726
+ // visible there too, exactly as a normal completed turn
727
+ // does below -- not just in the log.
728
+ await updateDashboard();
729
+ // Deliberately NOT rethrown: this is a recognised, handled
730
+ // condition (work done, publish blocked), not a dispatch
731
+ // crash for parallel()'s continueOnError accounting to
732
+ // isolate. Every OTHER dispatchError class still rethrows
733
+ // below, unchanged.
734
+ return;
735
+ }
736
+ // Rethrow so parallel()'s continueOnError:true isolates
737
+ // this failure from sibling streaks (the outcome above
738
+ // is already recorded via closure, so no information is
739
+ // lost when parallel() substitutes `null` for this branch).
740
+ throw dispatchError;
741
+ }
742
+
743
+ // No duplicate log() dump of `report` here -- see dispatchReview()
744
+ // for why. The doer streak's own AGENT row already carries this
745
+ // verbatim as its `output`, and its label names the bead ids.
746
+
747
+ // CRITICAL: never trust the doer's own success claim -- verify
748
+ // via `bd show` that the assigned bead ids are actually closed. A
749
+ // doer that returns a success-looking report but leaves a bead
750
+ // open is treated as a FAILED streak regardless of what it said.
751
+ //
752
+ // apra-fleet-3swo.5.7: that verification is the 'doer' row's
753
+ // 'verify-streak-closed' postResult step, which the engine ran
754
+ // immediately after the successful dispatch -- read its answer
755
+ // back off the outcome rather than doing the (D-pulling) read a
756
+ // second time. The row's 'kb-apply' step ran right after it:
757
+ // the doer decides what to capture and the engine executes it
758
+ // against the repo THAT doer worked in.
759
+ const unclosedIds = doerOutcome.stepResults['verify-streak-closed'];
760
+ const closedIds = actualBeadIds.filter((id) => !unclosedIds.includes(id));
761
+
762
+ // apra-fleet-eft.76.4: per-bead failure attribution -- always
763
+ // emitted (not only when something failed) so every streak's
764
+ // report leaves an audit trail of exactly which beads closed
765
+ // vs which stayed open. Closed beads stay closed regardless
766
+ // of a sibling bead in the same streak being refused; only
767
+ // the still-open ones are eligible for re-laning next round
768
+ // (the next dev round's `currentReady` query naturally omits
769
+ // whatever already closed here).
770
+ log(`Doer streak attribution [${actualBeadIds.join(', ')}]: closed=[${closedIds.join(', ')}] failed=[${unclosedIds.join(', ')}].`);
771
+
772
+ // The doer RETURNED (its session ended) but left bead(s) open: a
773
+ // BLOCKED report, or a success-looking report the bd read disproves.
774
+ const leftOpenReason = report && report.status === 'BLOCKED' ? 'blocked' : 'left-open';
775
+ if (unclosedIds.length > 0) {
776
+ log(`Doer streak [${actualBeadIds.join(', ')}] reported status '${report ? report.status : 'unknown'}' but bead(s) still open: ${unclosedIds.join(', ')} -- treating streak as FAILED.`);
777
+ }
778
+
779
+ if (batchStreaks) {
780
+ // Mode (i): PER-STREAK outcome attribution for the batch
781
+ // dispatch -- one outcome per sub-streak, so review scope and
782
+ // re-laning stay per-streak exactly as in mode (ii).
783
+ for (const sub of batchStreaks) {
784
+ const subIds = sub.map((b) => b.id).filter((id) => actualBeadIds.includes(id));
785
+ if (subIds.length === 0) continue;
786
+ const subUnclosed = subIds.filter((id) => unclosedIds.includes(id));
787
+ const subClosed = subIds.filter((id) => !subUnclosed.includes(id));
788
+ streakOutcomes.push({
789
+ beadIds: subIds, doerMember, wasRetried, report,
790
+ unclosedIds: subUnclosed, closedIds: subClosed,
791
+ outcome: subUnclosed.length > 0 ? 'failed' : (wasRetried ? 'retried' : 'success'),
792
+ ...(subUnclosed.length > 0 ? { failureReason: leftOpenReason } : {}),
793
+ });
794
+ }
795
+ } else {
796
+ streakOutcomes.push({
797
+ beadIds: actualBeadIds, doerMember, wasRetried, report, unclosedIds, closedIds,
798
+ outcome: unclosedIds.length > 0 ? 'failed' : (wasRetried ? 'retried' : 'success'),
799
+ ...(unclosedIds.length > 0 ? { failureReason: leftOpenReason } : {}),
800
+ });
801
+ }
802
+ await updateDashboard();
803
+ } finally {
804
+ releaseTurn();
805
+ }
806
+ };
807
+
808
+ await parallel(worklistPacking.worklists, async (worklist, index) => {
809
+ if (!worklist || worklist.length === 0) return; // a packed round can leave a doer idle
810
+ const doerMember = doerPool[index % doerPool.length];
811
+ // Per-worklist session context: the doer's captured session id +
812
+ // last reported usage, carried across the streaks of THIS
813
+ // worklist only -- never across doers or rounds.
814
+ const worklistCtx = { sessionId: null, usage: null };
815
+
816
+ if (worklistMode === 'batch' && worklist.length > 1) {
817
+ // Mode (i) BATCH: one dispatch carries the whole ordered
818
+ // worklist (assignDoerWorklists guarantees it is
819
+ // tier-homogeneous). Per-streak outcomes are attributed
820
+ // after the fact via `batchStreaks`.
821
+ await runStreakTurn({
822
+ streak: worklist.flat(),
823
+ doerMember,
824
+ worklistCtx,
825
+ packed: worklistPacking.packed,
826
+ batchStreaks: worklist,
827
+ });
828
+ return;
829
+ }
830
+
831
+ // Mode (ii) RESUMED SEQUENCE (default): one dispatch per streak,
832
+ // in worklist order, each going through the SAME global FIFO
833
+ // gate (runStreakTurn acquires it per streak) and the same
834
+ // git/dolt sync brackets -- so every engine checkpoint is kept
835
+ // BETWEEN streaks. A failure in streak N is recorded and
836
+ // isolated: streaks 1..N-1's closes already stand (per-bead
837
+ // attribution), and N+1.. still dispatch (fresh session -- the
838
+ // catch clears the worklist session so a broken session is
839
+ // never resumed).
840
+ let firstError = null;
841
+ for (let wIdx = 0; wIdx < worklist.length; wIdx++) {
842
+ try {
843
+ await runStreakTurn({
844
+ streak: worklist[wIdx],
845
+ doerMember,
846
+ worklistCtx,
847
+ worklistPosition: wIdx,
848
+ worklistLength: worklist.length,
849
+ packed: worklistPacking.packed,
850
+ });
851
+ } catch (err) {
852
+ firstError = firstError || err;
853
+ worklistCtx.sessionId = null;
854
+ worklistCtx.usage = null;
855
+ }
856
+ }
857
+ // Rethrow (after ALL streaks ran) so parallel()'s
858
+ // continueOnError:true accounting records this worklist's
859
+ // failure.
860
+ if (firstError) throw firstError;
861
+ }, { continueOnError: true });
862
+
863
+ log(`Develop C${cycle} R${devRounds} streak outcomes: ${JSON.stringify(streakOutcomes.map((o) => ({ beadIds: o.beadIds, outcome: o.outcome })))}`);
864
+
865
+ // The two values the Review phase (still inline in runner.js, in this same
866
+ // round loop iteration) reads out of this round -- see the return shape in
867
+ // this function's doc comment.
868
+ return { streakOutcomes, readyTitleById };
869
+ }