@apralabs/apra-fleet 0.4.2 → 0.4.4

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