@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  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 +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  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 +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -7,17 +7,20 @@ import { existsSync, realpathSync } from 'node:fs';
7
7
  import { FleetWorkflow } from '@apralabs/apra-fleet-workflow';
8
8
  import { WorkflowEngine } from '@apralabs/apra-fleet-workflow/engine';
9
9
  import { createDashboardViewer } from '@apralabs/apra-fleet-workflow/viewer';
10
- import { StreamableHttpTransport } from '@apralabs/apra-fleet-client/transport';
11
10
  import { McpClient } from '@apralabs/apra-fleet-client/client';
12
11
  import { ApraFleet } from '@apralabs/apra-fleet-client';
13
12
  import {
14
13
  resolveFleetServerCommand as sharedResolveFleetServerCommand,
15
14
  resolveFleetServerConnection as sharedResolveFleetServerConnection,
15
+ createFleetHttpTransport,
16
16
  getServerInfoPath,
17
17
  } from '@apralabs/apra-fleet-client/server-resolution';
18
- import { beadsExtension } from '../fleet-sprint/viewer-extensions.mjs';
19
- import { validateIssueId, validateBranchName, checkMemberTopology, createMemberReservationClient, resyncReacquiredMember, commandResultToSoftGit } from '../fleet-sprint/runner.js';
18
+ import { beadsExtension, kbCodeIntelExtension, decisionsExtension } from '../fleet-sprint/viewer-extensions.mjs';
19
+ import { DECISION_PAUSE_SOURCE } from '../fleet-sprint/decision-wait.mjs';
20
+ import { validateIssueId, validateBranchName, validateBranchPair, createMemberReservationClient, resyncReacquiredMember, commandResultToSoftGit } from '../fleet-sprint/runner.js';
20
21
  import { normalizeRole } from '../fleet-sprint/contracts.mjs';
22
+ import { prepareLaunchTopology, toAlignCommandResult } from '../fleet-sprint/member-align.mjs';
23
+ import { ROLE_BACKLOG, resolveBacklogRoleAlias, selectBacklogMember, formatBacklogSelection } from '../fleet-sprint/backlog-role.mjs';
21
24
  import { BEADS_IDENTITY_PROBES, parseBeadsIdentity, formatBeadsIdentity, parseExpectedIdentity } from '../fleet-sprint/beads-identity.mjs';
22
25
 
23
26
  const __filename = fileURLToPath(import.meta.url);
@@ -159,8 +162,11 @@ export function buildOptionsSpec() {
159
162
  // The beads identity (JSON, serializeExpectedIdentity output) every
160
163
  // member's bd must resolve to, injected by the supervisor's spawner;
161
164
  // env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted (direct launch):
162
- // the runner takes the expectation from the orchestrator member.
165
+ // the runner takes the expectation from the backlog member.
163
166
  'expect-beads': { type: 'string' },
167
+ // Operator-notification config for a pending decision (JSON; env
168
+ // fallback FLEET_SPRINT_DECISION_NOTIFY). See decision-notify.mjs.
169
+ 'decision-notify': { type: 'string' },
164
170
  budget: { type: 'string' },
165
171
  // Stabilization Issue 32: per-dispatch time budget in seconds
166
172
  // (timeout_s == max_total_s at every dispatch; integ ceiling 2x).
@@ -174,6 +180,18 @@ export function buildOptionsSpec() {
174
180
  // dolt-probe precondition, differing HEADs allowed). Omitted => legacy
175
181
  // shared-workspace mode (same-HEAD). Mode is never inferred silently.
176
182
  sync: { type: 'boolean' },
183
+ // Explicitly skip the once-per-sprint regression pass (forwarded as the
184
+ // runner's skip_regression arg; the supervisor sets it from the launch
185
+ // body's phases.regression:"skip"). Never silent: logged, and reported in
186
+ // the sprint analysis and the PR body.
187
+ 'skip-regression': { type: 'boolean' },
188
+ // Reviewer KB demotion loop switch: on (default) or off. Forwarded as the
189
+ // runner's kb_demotion_loop arg, which rejects any other value loudly.
190
+ 'kb-demotion-loop': { type: 'string' },
191
+ // --ci-gate is DELIBERATELY NOT WIRED (2026-10-01): the runner's
192
+ // ci_gate arg is disabled until the CI-as-quality-resource epic
193
+ // (apra-fleet-dv8i) designs the flow -- see fleet-sprint/sprint-args.mjs.
194
+ // 'ci-gate': { type: 'string' },
177
195
  help: { type: 'boolean', short: 'h' },
178
196
  };
179
197
  }
@@ -206,14 +224,21 @@ Options:
206
224
  --expect-beads <json> Beads identity every member must resolve to, as JSON
207
225
  ({"beadsDir","prefix","syncRemote","repoRemote"}). Normally injected by
208
226
  the supervisor; env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted: the
209
- orchestrator member's own 'bd where' becomes the expectation and every
227
+ backlog member's own 'bd where' becomes the expectation and every
210
228
  other member must match it. A mismatch aborts before any bd mutation.
229
+ --decision-notify <json> Where to notify the operator of a pending decision, as JSON
230
+ ({"message_member","email":{provider,from,to,host,port,user,secure},
231
+ "dashboard_url","timeout_s"}); env fallback FLEET_SPRINT_DECISION_NOTIFY.
232
+ Credentials stay in the fleet credential store. message_member
233
+ defaults to "orchestrator" (the operator's channel-capable
234
+ session); a channel with no target is logged once at launch.
211
235
  --budget <usd> USD ceiling for this run's total estimated spend. Optional;
212
236
  omitted (the default) means unlimited, identical to prior behavior.
213
- --dispatch-timeout-s <s> Per-dispatch time budget in seconds (default 3600). Applied as both
214
- the inactivity timeout and the hard ceiling on every agent dispatch
215
- (the integration-test dispatch ceiling is 2x). Lower it for small
216
- sprints so a hung dispatch costs minutes, not an hour. Minimum 60.
237
+ --dispatch-timeout-s <s> Per-dispatch time budget in seconds (default 9000). The hard ceiling
238
+ on every agent dispatch (integration-test ceiling 2x, regression-test
239
+ ceiling 3x); the inactivity timeout is this value capped at 1800.
240
+ Lower it for small sprints so a hung dispatch costs minutes, not
241
+ hours. Minimum 60.
217
242
  --usage-limit-max-wait-s <s> Total wall-clock seconds a dispatch may stay paused across all
218
243
  usage-limit reprobes before giving up (typed sprint abort). Optional;
219
244
  omitted uses the runner default. Minimum 60.
@@ -223,6 +248,12 @@ Options:
223
248
  members may sit on differing HEADs but must share the same
224
249
  origin URL and pass a 'bd dolt pull' probe. Omitted (default)
225
250
  uses legacy shared-workspace mode (all members on the same HEAD).
251
+ --skip-regression Skip the once-per-sprint regression pass. Logged, and stated in the
252
+ sprint analysis and the PR body. Integration tests still run.
253
+ --kb-demotion-loop <on|off>
254
+ Reviewer KB demotion loop (default: on). 'off' offers the reviewer no
255
+ demotion candidates and issues no kb_demote; the log says so. Any
256
+ other value is rejected.
226
257
  -h, --help Show this help message.
227
258
  `.trim();
228
259
 
@@ -254,7 +285,18 @@ export function parseCliArgs(argv) {
254
285
  * @returns {Promise<object|undefined>}
255
286
  */
256
287
  export async function resolveRoleMap(rawValue, deps = {}) {
257
- if (rawValue === undefined) return undefined;
288
+ return (await resolveRoleMapWithWarnings(rawValue, deps)).roleMap;
289
+ }
290
+
291
+ /**
292
+ * Same as resolveRoleMap() but also returns the backlog-alias deprecation
293
+ * warnings, so main() can print them and forward them to the runner (which
294
+ * logs them in the run log -- the rewritten roleMap no longer carries the
295
+ * deprecated key, so the runner could not detect it itself).
296
+ * @returns {Promise<{ roleMap: object|undefined, warnings: string[] }>}
297
+ */
298
+ export async function resolveRoleMapWithWarnings(rawValue, deps = {}) {
299
+ if (rawValue === undefined) return { roleMap: undefined, warnings: [] };
258
300
  const readFile = deps.readFile || fs.readFile;
259
301
 
260
302
  let jsonText = rawValue;
@@ -287,12 +329,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
287
329
  // contracts.normalizeRole() (trim + lowercase) HERE -- this is where
288
330
  // roleMap keys first enter the system from a user-supplied
289
331
  // `--role-map`/`@file.json` value, so callers of `resolveRoleMap()`
290
- // (including this CLI's own pre-transport `orchestratorMember` lookup
332
+ // (including this CLI's own pre-transport `backlogMember` lookup
291
333
  // below, and runner.js's `validateArgs()`, which normalizes again
292
334
  // defensively for callers that bypass the CLI and pass a raw roleMap
293
335
  // straight to `engine.executeFile()`) can rely on keys already being in
294
336
  // canonical lowercase form. This also covers the 'orchestrator'
295
- // application-level pseudo-role key (see runner.js's ROLE_ORCHESTRATOR
337
+ // application-level pseudo-role key (see runner.js's ROLE_BACKLOG
296
338
  // doc comment) -- it is not a vendored contracts.ROLES member but is
297
339
  // still just a plain string key here, so the same normalization applies.
298
340
  const normalized = {};
@@ -307,7 +349,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
307
349
  normalized[key] = members;
308
350
  }
309
351
 
310
- return normalized;
352
+ // Deprecated 'orchestrator' key -> 'backlog'; a conflict throws.
353
+ try {
354
+ return resolveBacklogRoleAlias(normalized);
355
+ } catch (err) {
356
+ throw new Error(`Error: --role-map ${err.message}`);
357
+ }
311
358
  }
312
359
 
313
360
  /**
@@ -323,7 +370,7 @@ export async function resolveRoleMap(rawValue, deps = {}) {
323
370
  * }} opts
324
371
  * @returns {object}
325
372
  */
326
- export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads }) {
373
+ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, roleMapWarnings, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads, skipRegression, kbDemotionLoop, ciGate, decisionNotify }) {
327
374
  const args = {
328
375
  target_issues: targetIssues,
329
376
  members,
@@ -334,6 +381,7 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
334
381
  };
335
382
  if (requirementsFile !== undefined) args.requirementsFile = requirementsFile;
336
383
  if (roleMap !== undefined) args.roleMap = roleMap;
384
+ if (Array.isArray(roleMapWarnings) && roleMapWarnings.length > 0) args.roleMapWarnings = roleMapWarnings;
337
385
  if (budget !== undefined) args.budget = budget;
338
386
  if (dispatchTimeoutS !== undefined) args.dispatch_timeout_s = dispatchTimeoutS;
339
387
  // apra-fleet-hzeb.4.2: the CLI-overridable usage-limit pause budgets,
@@ -352,9 +400,16 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
352
400
  // dispatch so deploy.md's active-sprints gate can recognize this sprint's
353
401
  // OWN reservation instead of stopping on it.
354
402
  if (runId !== undefined) args.run_id = runId;
403
+ // Only forwarded when set, so a default launch's runner args are unchanged.
404
+ if (skipRegression === true) args.skip_regression = true;
405
+ // Forwarded verbatim when set; validateArgs rejects anything but on/off.
406
+ if (kbDemotionLoop !== undefined) args.kb_demotion_loop = kbDemotionLoop;
355
407
  // The raw --expect-beads JSON, forwarded verbatim; runner.js's
356
408
  // validateArgs() parses it (validateExpectBeads) and rejects bad JSON.
357
409
  if (expectBeads !== undefined) args.expect_beads = expectBeads;
410
+ if (decisionNotify !== undefined) args.decision_notify = decisionNotify;
411
+ // --ci-gate is not wired (apra-fleet-dv8i); ci_gate is never forwarded.
412
+ // if (ciGate !== undefined) args.ci_gate = ciGate;
358
413
  return args;
359
414
  }
360
415
 
@@ -373,7 +428,7 @@ export function resolveExpectBeads(flagValue, env = process.env) {
373
428
  }
374
429
 
375
430
  /**
376
- * Runs `bd where --json` on the ORCHESTRATOR MEMBER (never locally -- the
431
+ * Runs `bd where --json` on the BACKLOG MEMBER (never locally -- the
377
432
  * sprint's bd commands run in that member's workFolder, see
378
433
  * checkIssuesExistOnMember below) so the startup banner can show which
379
434
  * .beads the sprint is about to mutate, and so a member with no beads
@@ -461,9 +516,9 @@ export function resolveMemberValidation({ rawMembers, registeredNames, allowMiss
461
516
  }
462
517
 
463
518
  /**
464
- * Verifies every target issue exists, run on the ORCHESTRATOR MEMBER via the
519
+ * Verifies every target issue exists, run on the BACKLOG MEMBER via the
465
520
  * fleet transport (`runBdShow`) -- NOT on the local machine. The sprint's own
466
- * `bd` commands run against the orchestrator member's beads DB (see
521
+ * `bd` commands run against the backlog member's beads DB (see
467
522
  * fleet-sprint/runner.js's SUPPORTED-TOPOLOGY NOTE), which can be a different
468
523
  * database than whatever is local to wherever this CLI process happens to
469
524
  * run. Checking locally could pass (or worse, resolve a same-named-but-
@@ -548,6 +603,37 @@ export function attachViewerErrorHandler(server, port, opts = {}) {
548
603
  // the failure -- and precisely which members block the resume -- is surfaced to
549
604
  // the operator instead of lost to a console.error line. Extracted and exported
550
605
  // so the rethrow-and-name behavior is unit-testable without a live engine.
606
+ // Launch ordering: launch alignment (prepareLaunchTopology) stashes WIP and
607
+ // switches branches on members, so it must never run on a member another
608
+ // sprint holds -- that sprint's in-flight work would be moved under it. Reserve
609
+ // first (reserveForLaunch reports members another sprint already holds and
610
+ // then hands back what it took), align only when nothing is held, and release
611
+ // every reservation again when alignment refuses or throws, so a refused
612
+ // launch leaves no reservation behind. Exported so the ordering is unit-
613
+ // testable without a live server.
614
+ export async function reserveThenAlign({ sprintReservation, align } = {}) {
615
+ const { held } = await sprintReservation.reserveForLaunch();
616
+ if (held.length > 0) {
617
+ return {
618
+ ok: false,
619
+ reserved: false,
620
+ message: `member(s) ${held.join(', ')} are reserved by another running sprint, so no member was aligned or changed. Wait for that sprint to finish or release its reservation (member_reservation), then launch again.`,
621
+ };
622
+ }
623
+ let topology;
624
+ try {
625
+ topology = await align();
626
+ } catch (err) {
627
+ await sprintReservation.releaseAll();
628
+ throw err;
629
+ }
630
+ if (!topology || !topology.ok) {
631
+ await sprintReservation.releaseAll();
632
+ return { ...(topology || { ok: false, message: 'launch alignment returned no result' }), reserved: false };
633
+ }
634
+ return { ...topology, reserved: true };
635
+ }
636
+
551
637
  export async function reReserveOnResume({ sprintReservation, resyncMember, requestPause, log = () => {} } = {}) {
552
638
  try {
553
639
  return await sprintReservation.reReserveForResume({ resyncMember });
@@ -566,6 +652,46 @@ export async function reReserveOnResume({ sprintReservation, resyncMember, reque
566
652
  }
567
653
  }
568
654
 
655
+ // Reservation handling across a cooperative pause/resume, by pause source.
656
+ // A pause hands every member reservation back (so another sprint may use the
657
+ // members while this one is parked) and the matching resume re-acquires them
658
+ // owner-checked and resyncs each one -- EXCEPT the paused-awaiting-decision
659
+ // pause (source 'needs_decision', fleet-sprint/decision-wait.mjs): that run is
660
+ // waiting on an operator, not on a member, and may wait hours, so it keeps
661
+ // every reservation (no other sprint can take a member meanwhile) and touches
662
+ // no member; its resume then has nothing to re-acquire or resync. The source
663
+ // comes from the 'pause:requested' payload ('paused' carries none). The
664
+ // re-reserve runs only for a pause whose 'paused' handler actually released.
665
+ // Exported so the per-source behaviour is unit-testable without a live engine.
666
+ export function wirePauseReservations({ workflow, releaseForPause, reReserve, log = () => {} }) {
667
+ let pauseSource = null;
668
+ let released = false;
669
+ workflow.on('pause:requested', (payload) => {
670
+ pauseSource = payload && payload.source ? payload.source : null;
671
+ });
672
+ workflow.on('paused', () => {
673
+ if (pauseSource === DECISION_PAUSE_SOURCE) {
674
+ log('[member-reservation] paused awaiting an operator decision: keeping every member reservation for the wait.');
675
+ return;
676
+ }
677
+ released = true;
678
+ // Started synchronously in the 'paused' event, as before; best-effort
679
+ // (a release hiccup must never fail a pause).
680
+ const failed = (err) => console.error('[member-reservation] release-on-pause failed:', err && err.message ? err.message : err);
681
+ try {
682
+ Promise.resolve(releaseForPause()).catch(failed);
683
+ } catch (err) {
684
+ failed(err);
685
+ }
686
+ });
687
+ workflow.setPreResumeHook(async (reason) => {
688
+ if (!released) return undefined;
689
+ const result = await reReserve(reason);
690
+ released = false;
691
+ return result;
692
+ });
693
+ }
694
+
569
695
  async function main() {
570
696
  const { values } = parseCliArgs(process.argv.slice(2));
571
697
 
@@ -623,11 +749,14 @@ async function main() {
623
749
  // is somehow bypassed -- both layers share the exact same validators
624
750
  // (imported from runner.js) so there is a single source of truth.
625
751
  let roleMap;
752
+ let roleMapWarnings = [];
626
753
  try {
627
754
  targetIssues.forEach(validateIssueId);
628
755
  validateBranchName(branchName, 'branch');
629
756
  validateBranchName(baseBranch, 'base');
630
- roleMap = await resolveRoleMap(values['role-map']);
757
+ validateBranchPair(branchName, baseBranch);
758
+ ({ roleMap, warnings: roleMapWarnings } = await resolveRoleMapWithWarnings(values['role-map']));
759
+ for (const w of roleMapWarnings) console.warn(`Warning: ${w}`);
631
760
  } catch (err) {
632
761
  console.error(`Error: ${err.message}`);
633
762
  process.exit(1);
@@ -677,7 +806,7 @@ async function main() {
677
806
  // 1. Attach to the fleet MCP transport FIRST, so member validation, the
678
807
  // "bd show" issue precondition (below), and the sprint itself all run
679
808
  // against the same live client/connection -- and so the issue
680
- // precondition can target the orchestrator MEMBER rather than the local
809
+ // precondition can target the backlog MEMBER rather than the local
681
810
  // machine (apra-fleet-unw2.16, N14 (d): the sprint's own `bd` commands
682
811
  // run on the member via the fleet transport, which can be a different
683
812
  // database than whatever is local to this CLI process).
@@ -691,7 +820,17 @@ async function main() {
691
820
  // fail fast with a typed error naming the missing connection config --
692
821
  // silently self-spawning a private stdio server here would defeat the
693
822
  // whole point of sharing one fleet-server connection across N children.
694
- const connection = await resolveFleetServerConnection();
823
+ let connection;
824
+ try {
825
+ connection = await resolveFleetServerConnection();
826
+ } catch (err) {
827
+ // e.g. the server was stopped with 'apra-fleet stop', or auto-start
828
+ // refused/failed: print the actionable message on stderr (the
829
+ // supervisor surfaces a launch's stderr tail), not a stack trace.
830
+ console.error(`Error: ${err && err.message ? err.message : err}`);
831
+ process.exit(1);
832
+ return;
833
+ }
695
834
  if (connection.mode !== 'http') {
696
835
  const err = new FleetServerUnreachableError(
697
836
  'No reachable apra-fleet HTTP singleton was found. cli.mjs no longer ' +
@@ -707,8 +846,14 @@ async function main() {
707
846
  process.exit(1);
708
847
  return;
709
848
  }
710
- const transport = new StreamableHttpTransport(connection.url);
849
+ // Reconnecting HTTP transport: if the shared server dies mid-run it is
850
+ // re-probed (and auto-started when gone) before the next request; a request
851
+ // is retried once only when it provably never reached the server.
852
+ const transport = createFleetHttpTransport(connection, { dirname: __dirname, exists: existsSync });
711
853
  await transport.start();
854
+ // Every exit below releases the server session first: stop() alone leaves
855
+ // it (and its McpServer) open on the fleet server until idle eviction.
856
+ const closeFleetTransport = () => transport.close().catch(() => { /* best effort */ });
712
857
  const mcpClient = new McpClient(transport);
713
858
 
714
859
  const fleetApi = new ApraFleet(mcpClient);
@@ -717,9 +862,9 @@ async function main() {
717
862
  let validMembers = [];
718
863
  // apra-fleet: names flagged unreservable in the SAME list_members read --
719
864
  // hoisted out of this try block so the topology filter below (item 4) can
720
- // key on the actual unreservable flag, not on roleMap.orchestrator
865
+ // key on the actual unreservable flag, not on roleMap.backlog
721
866
  // membership (which would also match a real, git-having dispatch member
722
- // that is ADDITIONALLY role-mapped as orchestrator, and wrongly skip its
867
+ // that is ADDITIONALLY role-mapped as backlog, and wrongly skip its
723
868
  // legitimate same-HEAD topology check).
724
869
  let unreservableNames = new Set();
725
870
  try {
@@ -731,29 +876,32 @@ async function main() {
731
876
  const result = resolveMemberValidation({ rawMembers, registeredNames, allowMissingMembers });
732
877
  if (!result.ok) {
733
878
  console.error(result.message);
734
- transport.stop();
879
+ await closeFleetTransport();
735
880
  process.exit(1);
736
881
  }
737
882
  if (result.message) console.warn(result.message);
738
883
  validMembers = result.validMembers;
739
884
  } catch (err) {
740
885
  console.error(`Error: Failed to list fleet members: ${err.message}`);
741
- transport.stop();
886
+ await closeFleetTransport();
742
887
  process.exit(1);
743
888
  }
744
889
 
745
- // 3. bd show issue precondition -- run on the orchestrator MEMBER via the
890
+ // 3. bd show issue precondition -- run on the backlog MEMBER via the
746
891
  // fleet transport (apra-fleet-unw2.16, N14 (d)), immediately after the
747
892
  // transport/initialize handshake above and before any sprint phase
748
- // begins. The orchestrator member mirrors fleet-sprint/runner.js's
749
- // `getMemberForRole(ROLE_ORCHESTRATOR)` resolution: roleMap.orchestrator[0]
893
+ // begins. The backlog member mirrors fleet-sprint/runner.js's
894
+ // `getMemberForRole(ROLE_BACKLOG)` resolution: roleMap.backlog[0]
750
895
  // if configured, else the first valid member. `roleMap` here is already
751
896
  // key-normalized by `resolveRoleMap()` above (N15, apra-fleet-unw2.11),
752
- // so the canonical lowercase 'orchestrator' key is the only one that can
897
+ // so the canonical lowercase 'backlog' key is the only one that can
753
898
  // be present -- this must NOT read a capitalized 'Orchestrator' key (the
754
899
  // N15 finding: that stray casing silently never matched a roleMap
755
900
  // author's natural lowercase key).
756
- const orchestratorMember = (roleMap && roleMap.orchestrator && roleMap.orchestrator[0]) || validMembers[0];
901
+ const backlogSelection = selectBacklogMember({ roleMap, members: validMembers });
902
+ const backlogMember = backlogSelection.member;
903
+ const backlogSelectionLine = formatBacklogSelection(backlogSelection);
904
+ if (backlogSelectionLine) console.log(backlogSelectionLine);
757
905
  const runProbe = async (cmd, member) => {
758
906
  const res = await fleetApi.executeCommand({ command: cmd, member_name: member });
759
907
  const text = res && res.content && res.content[0] ? res.content[0].text : '';
@@ -762,25 +910,25 @@ async function main() {
762
910
  if (exitCode !== 0) throw new Error(text || `exit code ${exitCode}`);
763
911
  return res && res.structuredContent && typeof res.structuredContent.stdout === 'string' ? res.structuredContent.stdout : text;
764
912
  };
765
- // Which .beads the orchestrator member's bd resolves to -- probed BEFORE
913
+ // Which .beads the backlog member's bd resolves to -- probed BEFORE
766
914
  // the `bd show` precondition below so a member with no beads database
767
915
  // is reported plainly (a warning with the fix) ahead of the bare bd
768
916
  // error that precondition would otherwise be the first to show, and
769
917
  // shown in the banner. A failed probe is a warning, not an exit: the
770
918
  // existing preconditions decide. The runner repeats this for every
771
919
  // member and hard-fails only a mismatch against --expect-beads.
772
- const beadsProbe = await probeBeadsIdentityOnMember({ member: orchestratorMember, runCommand: runProbe });
920
+ const beadsProbe = await probeBeadsIdentityOnMember({ member: backlogMember, runCommand: runProbe });
773
921
  if (!beadsProbe.ok) {
774
922
  console.warn(beadsProbe.message);
775
923
  }
776
924
  const issueCheck = await checkIssuesExistOnMember({
777
925
  targetIssues,
778
- member: orchestratorMember,
926
+ member: backlogMember,
779
927
  runBdShow: async (id, member) => fleetApi.executeCommand({ command: `bd show ${id}`, member_name: member }),
780
928
  });
781
929
  if (!issueCheck.ok) {
782
930
  console.error(issueCheck.message);
783
- transport.stop();
931
+ await closeFleetTransport();
784
932
  process.exit(1);
785
933
  }
786
934
 
@@ -788,7 +936,7 @@ async function main() {
788
936
  //
789
937
  // LEGACY mode (default): the runner's cross-member coherence relies on
790
938
  // every member sharing one workspace/DB -- every orchestrator-side `bd`
791
- // command runs against the orchestrator member's beads DB, and the sprint
939
+ // command runs against the backlog member's beads DB, and the sprint
792
940
  // git branch is only coherent if every member operates on the same working
793
941
  // state. Enforce that by comparing `git rev-parse HEAD` across members and
794
942
  // refusing to start on a mismatch.
@@ -814,16 +962,16 @@ async function main() {
814
962
  // fleet-sprint orchestrator, docs/design-orchestrator-worktree-model-v2.md)
815
963
  // may have no real checkout at all, and `git rev-parse HEAD` on one
816
964
  // hard-fails the launch (process.exit(1) just below). Deliberately keyed
817
- // on the `unreservable` FLAG, not on roleMap.orchestrator membership: a
965
+ // on the `unreservable` FLAG, not on roleMap.backlog membership: a
818
966
  // real, git-having dispatch member that is ADDITIONALLY role-mapped as
819
- // orchestrator (a supported topology, runner.js's branchEnsureMembers
967
+ // backlog (a supported topology, runner.js's branchEnsureMembers
820
968
  // dedupe comment) must still pass its legitimate same-HEAD check against
821
- // the other dispatch members -- filtering on roleMap.orchestrator alone
969
+ // the other dispatch members -- filtering on roleMap.backlog alone
822
970
  // would silently skip that check instead of just skipping a git-less
823
971
  // member. This only matters when an operator also lists a shared member
824
- // in --members (redundant with roleMap.orchestrator, and not required);
825
- // a normal launch that passes the shared orchestrator ONLY via
826
- // roleMap.orchestrator was never affected.
972
+ // in --members (redundant with roleMap.backlog, and not required);
973
+ // a normal launch that passes the shared backlog member ONLY via
974
+ // roleMap.backlog was never affected.
827
975
  const topologyMembersFiltered = validMembers.filter((m) => !unreservableNames.has(m));
828
976
  // Degrade back to the unfiltered list if excluding unreservable members
829
977
  // would empty it out entirely -- checkMemberTopology refuses to start on
@@ -832,29 +980,73 @@ async function main() {
832
980
  // the ORIGINAL single-member-trivial-pass behavior rather than a topology
833
981
  // error about having no members at all.
834
982
  const topologyMembers = topologyMembersFiltered.length > 0 ? topologyMembersFiltered : validMembers;
835
- const topology = await checkMemberTopology({
983
+ // apra-fleet-rsd9.1.1: in legacy mode, first ALIGN every topology member
984
+ // to the sprint base (fetch, preserve WIP in a named stash, check out the
985
+ // sprint branch -- see fleet-sprint/member-align.mjs), then run the
986
+ // topology check against the aligned state. Members that merely sat on
987
+ // other commits no longer refuse the launch; only what cannot be
988
+ // reconciled automatically (unreachable member, differing origin, base
989
+ // missing on origin, fetch auth failure, diverged sprint branch) does,
990
+ // and then before any member is moved. Synced mode is unchanged.
991
+ const runAlignGit = async (cmd, member) => {
992
+ try {
993
+ return toAlignCommandResult(await fleetApi.executeCommand({ command: cmd, member_name: member }));
994
+ } catch (err) {
995
+ return toAlignCommandResult(undefined, err);
996
+ }
997
+ };
998
+ // eft.26.1 reservation: a sprint launched directly through this CLI
999
+ // (never routed through the supervisor's POST /api/sprints) reserves its
1000
+ // members server-side, on the SAME opaque sprint id runner.js uses for the
1001
+ // dolt-mutex/allocator (the sprint branch name), so the supervisor's
1002
+ // overlap guard and execute_prompt's dispatch-time reservedBy check can see
1003
+ // it. It is taken BEFORE launch alignment (reserveThenAlign) and released
1004
+ // on EVERY exit path below: a refused alignment, a viewer port failure,
1005
+ // normal success, a caught failure/stall-abort, or SIGINT.
1006
+ const sprintReservation = createMemberReservationClient({
1007
+ callTool: (name, args) => mcpClient.callTool(name, args),
1008
+ members: validMembers,
1009
+ sprintId: branchName,
1010
+ log: (msg) => console.log(msg),
1011
+ });
1012
+ // Ctrl-C between the reserve and the sprint's own SIGINT handler (below)
1013
+ // must not leave the members reserved.
1014
+ const onLaunchSigint = () => {
1015
+ sprintReservation.releaseAll()
1016
+ .catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
1017
+ .finally(async () => {
1018
+ await closeFleetTransport();
1019
+ process.exit(130);
1020
+ });
1021
+ };
1022
+ process.once('SIGINT', onLaunchSigint);
1023
+ const topology = await reserveThenAlign({ sprintReservation, align: () => prepareLaunchTopology({
836
1024
  members: topologyMembers,
837
1025
  mode: syncedMode ? 'synced' : 'legacy',
1026
+ baseBranch,
1027
+ branch: branchName,
1028
+ runGit: runAlignGit,
1029
+ log: (msg) => console.log(msg),
838
1030
  getIdentity: (member) => runCommand('git rev-parse HEAD', member),
839
1031
  getOriginUrl: (member) => runCommand('git remote get-url origin', member),
840
1032
  doltProbe: (member) => runCommand('bd dolt pull', member),
841
- });
1033
+ }) });
842
1034
  if (!topology.ok) {
843
1035
  console.error(`Error: ${topology.message}`);
844
- transport.stop();
1036
+ await closeFleetTransport();
845
1037
  process.exit(1);
846
1038
  }
847
1039
  if (!topology.singleMember) {
848
1040
  console.log(topology.message);
849
1041
  }
850
1042
 
851
- console.log('Starting Auto-Sprint');
1043
+ console.log('Starting fleet-sprint');
852
1044
  console.log(`Target Issues: ${targetIssues.join(', ')}`);
853
1045
  console.log(`Sprint Branch: ${branchName} (Base: ${baseBranch})`);
854
1046
  console.log(`Goal Constraint: ${goal}`);
855
1047
  console.log(`Max Cycles: ${maxCycles}`);
856
1048
  console.log(`Active Members (${validMembers.length}): ${validMembers.join(', ')}`);
857
- console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `orchestrator '${orchestratorMember}'` })}`);
1049
+ console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `backlog '${backlogMember}'` })}`);
858
1050
  if (expectedBeads) {
859
1051
  console.log(`Beads: ${formatBeadsIdentity(expectedBeads, { label: 'expected (--expect-beads)' })}`);
860
1052
  }
@@ -865,7 +1057,9 @@ async function main() {
865
1057
  const server = createDashboardViewer(workflow, {
866
1058
  port: viewerPort,
867
1059
  name: 'Fleet-Sprint',
868
- dashboardExtensions: [beadsExtension],
1060
+ // kbCodeIntelExtension: its own tab (per-member, per-dispatch kb_* and
1061
+ // code_* call counts), separate from the Tasks tab.
1062
+ dashboardExtensions: [beadsExtension, kbCodeIntelExtension, decisionsExtension],
869
1063
  // apra-fleet-eft.37.1/37.2: the core viewer now speaks opts.runId
870
1064
  // (opts.sprintId is a deprecated BOUNDARY-COMPAT alias -- never use
871
1065
  // it from here).
@@ -884,7 +1078,7 @@ async function main() {
884
1078
  runId: effectiveRunId,
885
1079
  // BOUNDARY-COMPAT/user-facing convention (apra-fleet-eft.37.1): core's
886
1080
  // crash-net snapshot defaults are domain-neutral (workflow-logs/run_)
887
- // now that sprintId->runId is renamed; auto-sprint keeps its historical
1081
+ // now that sprintId->runId is renamed; fleet-sprint keeps its historical
888
1082
  // sprint-logs/sprint_<HHMMSS>.json convention by passing these
889
1083
  // explicitly rather than picking up the new core defaults.
890
1084
  stateSnapshotDir: 'sprint-logs',
@@ -907,14 +1101,18 @@ async function main() {
907
1101
  onError: (message) => {
908
1102
  viewerFailed = true;
909
1103
  console.error(`Error: ${message}`);
910
- transport.stop();
911
- process.exit(1);
1104
+ sprintReservation.releaseAll()
1105
+ .catch((err) => console.error('[member-reservation] release on viewer failure failed:', err && err.message ? err.message : err))
1106
+ .finally(async () => {
1107
+ await closeFleetTransport();
1108
+ process.exit(1);
1109
+ });
912
1110
  },
913
1111
  });
914
1112
 
915
- console.log(`Dashboard live at http://localhost:${viewerPort}`);
1113
+ console.log(`Dashboard live at http://127.0.0.1:${viewerPort}`);
916
1114
 
917
- if (viewerFailed) return; // process.exit already called synchronously above
1115
+ if (viewerFailed) return; // onError releases the reservations, then exits
918
1116
 
919
1117
  // apra-fleet-eft.26.1 (Reservation interop gap, Hole 1): a sprint
920
1118
  // launched directly through this CLI (never routed through the
@@ -926,13 +1124,7 @@ async function main() {
926
1124
  // for the dolt-mutex/allocator (the sprint branch name), and release on
927
1125
  // EVERY exit path below: normal success, a caught failure/stall-abort,
928
1126
  // or SIGINT.
929
- const sprintReservation = createMemberReservationClient({
930
- callTool: (name, args) => mcpClient.callTool(name, args),
931
- members: validMembers,
932
- sprintId: branchName,
933
- log: (msg) => console.log(msg),
934
- });
935
- await sprintReservation.reserveAll();
1127
+ // (The members were reserved above, before launch alignment.)
936
1128
 
937
1129
  // apra-fleet-p2to.4.2: reservation handling across a cooperative
938
1130
  // pause/resume (apra-fleet-p2to.1's engine primitive). On 'paused' hand
@@ -957,10 +1149,6 @@ async function main() {
957
1149
  const res = await fleetApi.executeCommand({ command: cmd, member_name: member });
958
1150
  return commandResultToSoftGit(res);
959
1151
  };
960
- workflow.on('paused', () => {
961
- sprintReservation.releaseForPause().catch((err) =>
962
- console.error('[member-reservation] release-on-pause failed:', err && err.message ? err.message : err));
963
- });
964
1152
  // (apra-fleet-p2to.1.3) The re-reserve + per-member resync is registered as
965
1153
  // an AWAITABLE pre-resume hook, not a fire-and-forget 'resumed' listener.
966
1154
  // requestResume() drains this hook as a hard barrier -- while the run is
@@ -978,19 +1166,25 @@ async function main() {
978
1166
  // sees exactly which members block the resume. requestPause() is still
979
1167
  // passed for the exported helper's standalone contract; here it is a no-op
980
1168
  // because the run has not yet been unpaused.
981
- workflow.setPreResumeHook(() => reReserveOnResume({
982
- sprintReservation,
983
- resyncMember: (member) => resyncReacquiredMember({
984
- member,
985
- branch: branchName,
986
- baseBranch,
987
- runGit: (cmd) => runGitSoft(cmd, member),
988
- doltPull: (m) => runCommand('bd dolt pull', m),
989
- log: (msg) => console.log(msg),
1169
+ // A decision pause keeps its reservations (see wirePauseReservations).
1170
+ wirePauseReservations({
1171
+ workflow,
1172
+ releaseForPause: () => sprintReservation.releaseForPause(),
1173
+ log: (msg) => console.log(msg),
1174
+ reReserve: () => reReserveOnResume({
1175
+ sprintReservation,
1176
+ resyncMember: (member) => resyncReacquiredMember({
1177
+ member,
1178
+ branch: branchName,
1179
+ baseBranch,
1180
+ runGit: (cmd) => runGitSoft(cmd, member),
1181
+ doltPull: (m) => runCommand('bd dolt pull', m),
1182
+ log: (msg) => console.log(msg),
1183
+ }),
1184
+ requestPause: (reason) => workflow.requestPause(reason),
1185
+ log: (msg) => console.error(msg),
990
1186
  }),
991
- requestPause: (reason) => workflow.requestPause(reason),
992
- log: (msg) => console.error(msg),
993
- }));
1187
+ });
994
1188
 
995
1189
  let reservationReleased = false;
996
1190
  const releaseReservationOnce = async () => {
@@ -1007,8 +1201,12 @@ async function main() {
1007
1201
  const onSigint = () => {
1008
1202
  releaseReservationOnce()
1009
1203
  .catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
1010
- .finally(() => process.exit(130));
1204
+ .finally(async () => {
1205
+ await closeFleetTransport();
1206
+ process.exit(130);
1207
+ });
1011
1208
  };
1209
+ process.removeListener('SIGINT', onLaunchSigint);
1012
1210
  process.once('SIGINT', onSigint);
1013
1211
 
1014
1212
  try {
@@ -1023,6 +1221,7 @@ async function main() {
1023
1221
  maxCycles,
1024
1222
  requirementsFile,
1025
1223
  roleMap,
1224
+ roleMapWarnings,
1026
1225
  budget,
1027
1226
  dispatchTimeoutS,
1028
1227
  usageLimitMaxWaitS,
@@ -1030,6 +1229,10 @@ async function main() {
1030
1229
  serviceUrl,
1031
1230
  runId: effectiveRunId,
1032
1231
  expectBeads,
1232
+ decisionNotify: (values['decision-notify'] || process.env.FLEET_SPRINT_DECISION_NOTIFY || '').trim() || undefined,
1233
+ skipRegression: Boolean(values['skip-regression']),
1234
+ kbDemotionLoop: values['kb-demotion-loop'],
1235
+ // ciGate: values['ci-gate'], -- not wired (apra-fleet-dv8i)
1033
1236
  }),
1034
1237
  // apra-fleet-eft.75.1: wires this already-connected mcpClient
1035
1238
  // through to runner.js's createMemberSessionGuard (see its doc
@@ -1044,7 +1247,7 @@ async function main() {
1044
1247
  await releaseReservationOnce();
1045
1248
  console.log('Sprint finished:', res);
1046
1249
  server.close();
1047
- transport.stop();
1250
+ await closeFleetTransport();
1048
1251
  process.exit(0);
1049
1252
  } catch (err) {
1050
1253
  process.removeListener('SIGINT', onSigint);
@@ -1064,7 +1267,7 @@ async function main() {
1064
1267
  const graceMs = Number(process.env.AUTO_SPRINT_FAILURE_GRACE_MS ?? 5 * 60 * 1000);
1065
1268
  if (graceMs > 0) {
1066
1269
  console.log(
1067
- `Sprint FAILED. Dashboard remains live at http://localhost:${viewerPort} for ` +
1270
+ `Sprint FAILED. Dashboard remains live at http://127.0.0.1:${viewerPort} for ` +
1068
1271
  `${Math.round(graceMs / 1000)}s so you can inspect the final state -- press Ctrl-C to exit sooner.`
1069
1272
  );
1070
1273
  await new Promise((resolve) => {
@@ -1077,7 +1280,7 @@ async function main() {
1077
1280
  });
1078
1281
  }
1079
1282
  server.close();
1080
- transport.stop();
1283
+ await closeFleetTransport();
1081
1284
  process.exit(process.exitCode || 1);
1082
1285
  }
1083
1286
  }