@apralabs/apra-fleet 0.4.3 → 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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  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/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -4,7 +4,8 @@ Reconcile a warm local KB against a merged bible after two or more branches
4
4
  land -- absorb the incoming knowledge, revive entries whose basis matches
5
5
  the merged worktree again, mechanically settle contradictions a file hash
6
6
  can decide, and dispatch a reconciler agent for the rest. Ends with the
7
- canonical bible re-exported so the merged branch's KB reflects merged truth.
7
+ canonical bible re-exported: confirmed entries whose cited files still match
8
+ their hash basis are added, so the merged branch's bible gains the merged truth.
8
9
 
9
10
  ## When to run
10
11
 
@@ -28,19 +29,26 @@ already-exposed `kb_promote` surface (which can walk any entry
28
29
  way -- a bible can never smuggle an active directive; activation stays
29
30
  CLI-only (`apra-fleet kb approve-directive`).
30
31
 
32
+ Run every step of this command from the operator's own session, not a fleet
33
+ member session: a member session without the engine's kb_maintainer grant is
34
+ refused an explicit `kb_import` path (`E-KB-MAINTAINER-REQUIRED`) and is not
35
+ served `kb_reconcile_prefilter`, `kb_resolve_contradiction` or `kb_export`.
36
+
31
37
  ## Steps
32
38
 
33
39
  ### Step 1: Import the merged bible
34
40
 
35
41
  ```
36
- kb_import({ repo: "<merged worktree path>" })
42
+ kb_import({ path: "<merged worktree path>/.fleet/kb-canonical.json" })
37
43
  ```
38
44
 
39
- or the CLI equivalent, `apra-fleet kb import --repo <path>`, for a human
40
- running this post-merge by hand. Omit `path` to resolve
41
- `<repo>/.fleet/kb-canonical.json` (the trusted channel); pass an explicit
42
- `path` only when importing a bible from somewhere else (caller-asserted
43
- trust, see above).
45
+ or the CLI equivalent, `apra-fleet kb import --path <file>`, for a human
46
+ running this post-merge by hand. `path` names the bible FILE only: kb tools
47
+ take no repo/scope argument and always write the calling session's own KB (a
48
+ member session uses its registered work folder; any other session the fleet
49
+ server's working folder). Omitting `path` resolves
50
+ `<own folder>/.fleet/kb-canonical.json` (the trusted channel); a bible from
51
+ anywhere else is caller-asserted trust (see above).
44
52
 
45
53
  Report: `{ imported, skipped, linked, flagged, sweep }`. `kb_import`
46
54
  already runs a freshness sweep internally at the end of its own run, scoped
@@ -92,11 +100,13 @@ Report: `{ pairs, resolved, left_for_agent, skipped_directive }`.
92
100
 
93
101
  If `left_for_agent` is non-empty, dispatch the `kb-reconciler` agent
94
102
  (`agents/kb-reconciler.md`, model tier cheap/standard)
95
- with that array. It reads the MERGED code via `code_context`/`code_impact`/
103
+ with that array, as a subagent of THIS session -- never on a fleet member: a
104
+ member session is not served `kb_resolve_contradiction` or `kb_export`, so the
105
+ agent would stop at its tool check. It reads the MERGED code via `code_context`/`code_impact`/
96
106
  `code_query` (never Glob/Grep) for each remaining pair, resolves what the
97
107
  code decides via `kb_resolve_contradiction`, falls back to a trust-tier
98
108
  tiebreak (`CONFIRMED > INFERRED > UNVERIFIED`) when the code is silent, and
99
- leaves genuinely undecidable pairs flagged for `/pm kb-review`. Active
109
+ leaves genuinely undecidable pairs flagged for `/pm kb-review`. Any `kb_query`/`kb_list` lookup of a pair's entries must pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list: the read tools default to CONFIRMED undisputed entries only, and a disputed or unpromoted side would otherwise be invisible (`kb_query({ flagged_only: true })` is exempt). Active
100
110
  user-directives are NEVER auto-retired. See `agents/kb-reconciler.md` for the
101
111
  full process and the single-write-path rule.
102
112
 
@@ -108,11 +118,16 @@ If `left_for_agent` is empty, skip straight to Step 5.
108
118
  kb_export()
109
119
  ```
110
120
 
111
- Writes every live `CONFIRMED` project entry -- which now includes every
112
- mechanical and agent-resolved winner -- to `.fleet/kb-canonical.json` and
113
- auto-commits it (pathspec-only, identity `pm-kb`, non-fatal on any git
114
- failure). This is existing `kb_export` machinery; no new commit step is
115
- needed here. Push is not automatic; it rides the normal sprint push cadence.
121
+ ADDS to `.fleet/kb-canonical.json` every live `CONFIRMED` project entry not
122
+ already in it whose cited files still match its recorded hash basis -- which
123
+ includes the mechanical and agent-resolved winners -- and auto-commits it
124
+ (pathspec-only, identity `pm-kb`, non-fatal on any git failure). This is
125
+ existing `kb_export` machinery; no new commit step is needed here. Push is
126
+ not automatic; it rides the normal sprint push cadence.
127
+
128
+ The export never removes or rewrites an entry already in the bible: a
129
+ superseded loser, or an entry later retired, stays there after re-export and
130
+ must be removed by hand.
116
131
 
117
132
  ## Report
118
133
 
@@ -21,6 +21,7 @@ Call `kb_query(flagged_only=true)`.
21
21
 
22
22
  - If the response says "No flagged contradictions found -- KB is clean.", report that to the user and stop.
23
23
  - Otherwise, collect all returned entries.
24
+ - `flagged_only` is exempt from the default CONFIRMED-only read filter, so it returns disputed entries of every tier. If you need to look up any other entry (for example a counterpart that is not in the flagged list), a plain `kb_query`/`kb_list` returns only CONFIRMED undisputed entries by default -- pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list to see the rest.
24
25
 
25
26
  ### Step 2: Group into contradiction pairs
26
27
 
@@ -14,7 +14,7 @@ setup -> requirements -> design ->
14
14
  Develop (doer-review loop: bd ready -> claim -> close, to a clean APPROVED)
15
15
  Test (deploy + integration tests, if deploy.md + playbook present)
16
16
  goal check -> exit | next cycle
17
- Harvest (CI watch -> final review -> docs/CHANGELOG -> complete -> PR)
17
+ Harvest (CI watch -> final review -> docs -> complete -> PR)
18
18
  ```
19
19
 
20
20
  State lives in **beads** (all task state -- the plan, what is open/in-progress/closed,
@@ -182,7 +182,7 @@ calling the sprint done.**
182
182
  MANDATORY CHECKLIST -- verify each before exiting:
183
183
  [ ] 1. CI watch dispatched
184
184
  [ ] 2. Final reviewer dispatched + APPROVED
185
- [ ] 3. Harvester dispatched (docs/ or CHANGELOG in branch diff)
185
+ [ ] 3. Harvester dispatched (docs/ in branch diff)
186
186
  [ ] 4. Cost analysis committed (or skipped if no Node.js)
187
187
  [ ] 5. Sprint root + delivered issues closed
188
188
  [ ] 6. bd export committed to branch (.beads/*.jsonl updated)
@@ -200,12 +200,12 @@ MANDATORY CHECKLIST -- verify each before exiting:
200
200
  and flag the user. `APPROVED` -> continue.
201
201
  3. **Documentation harvest** -- dispatch `harvester` to extract long-term knowledge
202
202
  from requirements.md, design.md, and the beads task tree (`bd list --tree
203
- <sprint-id>`, `bd show <id>`) into `docs/` and update `CHANGELOG`.
203
+ <sprint-id>`, `bd show <id>`) into `docs/` and update README.
204
204
  Structure inside `docs/` is content-driven (e.g. `docs/architecture.md`,
205
205
  `docs/features/<name>.md`). Extract: architecture decisions, feature design, key
206
206
  trade-offs, API contracts. Do NOT extract: task lists, code-line references, debug
207
- notes, implementation steps. The harvester commits the `docs/` and `CHANGELOG`
208
- output to the branch.
207
+ notes, implementation steps. The harvester commits the `docs/` output to the
208
+ branch.
209
209
  4. **Cost analysis and calibration update** (if Node.js available) -- run
210
210
  `computeSprintAnalysis`, `buildSprintSummary`, and `computeUpdatedCalibration`
211
211
  from `<skillDir>/cost.js` (the extracted module installed alongside this skill on
@@ -7,17 +7,19 @@ 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';
21
23
  import { BEADS_IDENTITY_PROBES, parseBeadsIdentity, formatBeadsIdentity, parseExpectedIdentity } from '../fleet-sprint/beads-identity.mjs';
22
24
 
23
25
  const __filename = fileURLToPath(import.meta.url);
@@ -159,7 +161,7 @@ export function buildOptionsSpec() {
159
161
  // The beads identity (JSON, serializeExpectedIdentity output) every
160
162
  // member's bd must resolve to, injected by the supervisor's spawner;
161
163
  // env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted (direct launch):
162
- // the runner takes the expectation from the orchestrator member.
164
+ // the runner takes the expectation from the backlog member.
163
165
  'expect-beads': { type: 'string' },
164
166
  budget: { type: 'string' },
165
167
  // Stabilization Issue 32: per-dispatch time budget in seconds
@@ -174,6 +176,15 @@ export function buildOptionsSpec() {
174
176
  // dolt-probe precondition, differing HEADs allowed). Omitted => legacy
175
177
  // shared-workspace mode (same-HEAD). Mode is never inferred silently.
176
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' },
177
188
  help: { type: 'boolean', short: 'h' },
178
189
  };
179
190
  }
@@ -206,14 +217,15 @@ Options:
206
217
  --expect-beads <json> Beads identity every member must resolve to, as JSON
207
218
  ({"beadsDir","prefix","syncRemote","repoRemote"}). Normally injected by
208
219
  the supervisor; env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted: the
209
- orchestrator member's own 'bd where' becomes the expectation and every
220
+ backlog member's own 'bd where' becomes the expectation and every
210
221
  other member must match it. A mismatch aborts before any bd mutation.
211
222
  --budget <usd> USD ceiling for this run's total estimated spend. Optional;
212
223
  omitted (the default) means unlimited, identical to prior behavior.
213
- --dispatch-timeout-s <s> Per-dispatch time budget in seconds (default 3600). Applied as both
214
- the inactivity timeout and the hard ceiling on every agent dispatch
215
- (the integration-test dispatch ceiling is 2x). Lower it for small
216
- sprints so a hung dispatch costs minutes, not an hour. Minimum 60.
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.
217
229
  --usage-limit-max-wait-s <s> Total wall-clock seconds a dispatch may stay paused across all
218
230
  usage-limit reprobes before giving up (typed sprint abort). Optional;
219
231
  omitted uses the runner default. Minimum 60.
@@ -223,6 +235,8 @@ Options:
223
235
  members may sit on differing HEADs but must share the same
224
236
  origin URL and pass a 'bd dolt pull' probe. Omitted (default)
225
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.
226
240
  -h, --help Show this help message.
227
241
  `.trim();
228
242
 
@@ -254,7 +268,18 @@ export function parseCliArgs(argv) {
254
268
  * @returns {Promise<object|undefined>}
255
269
  */
256
270
  export async function resolveRoleMap(rawValue, deps = {}) {
257
- 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: [] };
258
283
  const readFile = deps.readFile || fs.readFile;
259
284
 
260
285
  let jsonText = rawValue;
@@ -287,12 +312,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
287
312
  // contracts.normalizeRole() (trim + lowercase) HERE -- this is where
288
313
  // roleMap keys first enter the system from a user-supplied
289
314
  // `--role-map`/`@file.json` value, so callers of `resolveRoleMap()`
290
- // (including this CLI's own pre-transport `orchestratorMember` lookup
315
+ // (including this CLI's own pre-transport `backlogMember` lookup
291
316
  // below, and runner.js's `validateArgs()`, which normalizes again
292
317
  // defensively for callers that bypass the CLI and pass a raw roleMap
293
318
  // straight to `engine.executeFile()`) can rely on keys already being in
294
319
  // canonical lowercase form. This also covers the 'orchestrator'
295
- // application-level pseudo-role key (see runner.js's ROLE_ORCHESTRATOR
320
+ // application-level pseudo-role key (see runner.js's ROLE_BACKLOG
296
321
  // doc comment) -- it is not a vendored contracts.ROLES member but is
297
322
  // still just a plain string key here, so the same normalization applies.
298
323
  const normalized = {};
@@ -307,7 +332,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
307
332
  normalized[key] = members;
308
333
  }
309
334
 
310
- 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
+ }
311
341
  }
312
342
 
313
343
  /**
@@ -323,7 +353,7 @@ export async function resolveRoleMap(rawValue, deps = {}) {
323
353
  * }} opts
324
354
  * @returns {object}
325
355
  */
326
- export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads }) {
356
+ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, roleMapWarnings, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads, skipRegression, ciGate }) {
327
357
  const args = {
328
358
  target_issues: targetIssues,
329
359
  members,
@@ -334,6 +364,7 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
334
364
  };
335
365
  if (requirementsFile !== undefined) args.requirementsFile = requirementsFile;
336
366
  if (roleMap !== undefined) args.roleMap = roleMap;
367
+ if (Array.isArray(roleMapWarnings) && roleMapWarnings.length > 0) args.roleMapWarnings = roleMapWarnings;
337
368
  if (budget !== undefined) args.budget = budget;
338
369
  if (dispatchTimeoutS !== undefined) args.dispatch_timeout_s = dispatchTimeoutS;
339
370
  // apra-fleet-hzeb.4.2: the CLI-overridable usage-limit pause budgets,
@@ -352,9 +383,13 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
352
383
  // dispatch so deploy.md's active-sprints gate can recognize this sprint's
353
384
  // OWN reservation instead of stopping on it.
354
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;
355
388
  // The raw --expect-beads JSON, forwarded verbatim; runner.js's
356
389
  // validateArgs() parses it (validateExpectBeads) and rejects bad JSON.
357
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;
358
393
  return args;
359
394
  }
360
395
 
@@ -373,7 +408,7 @@ export function resolveExpectBeads(flagValue, env = process.env) {
373
408
  }
374
409
 
375
410
  /**
376
- * Runs `bd where --json` on the ORCHESTRATOR MEMBER (never locally -- the
411
+ * Runs `bd where --json` on the BACKLOG MEMBER (never locally -- the
377
412
  * sprint's bd commands run in that member's workFolder, see
378
413
  * checkIssuesExistOnMember below) so the startup banner can show which
379
414
  * .beads the sprint is about to mutate, and so a member with no beads
@@ -461,9 +496,9 @@ export function resolveMemberValidation({ rawMembers, registeredNames, allowMiss
461
496
  }
462
497
 
463
498
  /**
464
- * 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
465
500
  * fleet transport (`runBdShow`) -- NOT on the local machine. The sprint's own
466
- * `bd` commands run against the orchestrator member's beads DB (see
501
+ * `bd` commands run against the backlog member's beads DB (see
467
502
  * fleet-sprint/runner.js's SUPPORTED-TOPOLOGY NOTE), which can be a different
468
503
  * database than whatever is local to wherever this CLI process happens to
469
504
  * run. Checking locally could pass (or worse, resolve a same-named-but-
@@ -548,6 +583,37 @@ export function attachViewerErrorHandler(server, port, opts = {}) {
548
583
  // the failure -- and precisely which members block the resume -- is surfaced to
549
584
  // the operator instead of lost to a console.error line. Extracted and exported
550
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
+
551
617
  export async function reReserveOnResume({ sprintReservation, resyncMember, requestPause, log = () => {} } = {}) {
552
618
  try {
553
619
  return await sprintReservation.reReserveForResume({ resyncMember });
@@ -623,11 +689,14 @@ async function main() {
623
689
  // is somehow bypassed -- both layers share the exact same validators
624
690
  // (imported from runner.js) so there is a single source of truth.
625
691
  let roleMap;
692
+ let roleMapWarnings = [];
626
693
  try {
627
694
  targetIssues.forEach(validateIssueId);
628
695
  validateBranchName(branchName, 'branch');
629
696
  validateBranchName(baseBranch, 'base');
630
- 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}`);
631
700
  } catch (err) {
632
701
  console.error(`Error: ${err.message}`);
633
702
  process.exit(1);
@@ -677,7 +746,7 @@ async function main() {
677
746
  // 1. Attach to the fleet MCP transport FIRST, so member validation, the
678
747
  // "bd show" issue precondition (below), and the sprint itself all run
679
748
  // against the same live client/connection -- and so the issue
680
- // precondition can target the orchestrator MEMBER rather than the local
749
+ // precondition can target the backlog MEMBER rather than the local
681
750
  // machine (apra-fleet-unw2.16, N14 (d): the sprint's own `bd` commands
682
751
  // run on the member via the fleet transport, which can be a different
683
752
  // database than whatever is local to this CLI process).
@@ -691,7 +760,17 @@ async function main() {
691
760
  // fail fast with a typed error naming the missing connection config --
692
761
  // silently self-spawning a private stdio server here would defeat the
693
762
  // whole point of sharing one fleet-server connection across N children.
694
- 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
+ }
695
774
  if (connection.mode !== 'http') {
696
775
  const err = new FleetServerUnreachableError(
697
776
  'No reachable apra-fleet HTTP singleton was found. cli.mjs no longer ' +
@@ -707,7 +786,10 @@ async function main() {
707
786
  process.exit(1);
708
787
  return;
709
788
  }
710
- 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 });
711
793
  await transport.start();
712
794
  const mcpClient = new McpClient(transport);
713
795
 
@@ -717,9 +799,9 @@ async function main() {
717
799
  let validMembers = [];
718
800
  // apra-fleet: names flagged unreservable in the SAME list_members read --
719
801
  // hoisted out of this try block so the topology filter below (item 4) can
720
- // key on the actual unreservable flag, not on roleMap.orchestrator
802
+ // key on the actual unreservable flag, not on roleMap.backlog
721
803
  // membership (which would also match a real, git-having dispatch member
722
- // that is ADDITIONALLY role-mapped as orchestrator, and wrongly skip its
804
+ // that is ADDITIONALLY role-mapped as backlog, and wrongly skip its
723
805
  // legitimate same-HEAD topology check).
724
806
  let unreservableNames = new Set();
725
807
  try {
@@ -742,18 +824,21 @@ async function main() {
742
824
  process.exit(1);
743
825
  }
744
826
 
745
- // 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
746
828
  // fleet transport (apra-fleet-unw2.16, N14 (d)), immediately after the
747
829
  // transport/initialize handshake above and before any sprint phase
748
- // begins. The orchestrator member mirrors fleet-sprint/runner.js's
749
- // `getMemberForRole(ROLE_ORCHESTRATOR)` resolution: roleMap.orchestrator[0]
830
+ // begins. The backlog member mirrors fleet-sprint/runner.js's
831
+ // `getMemberForRole(ROLE_BACKLOG)` resolution: roleMap.backlog[0]
750
832
  // if configured, else the first valid member. `roleMap` here is already
751
833
  // key-normalized by `resolveRoleMap()` above (N15, apra-fleet-unw2.11),
752
- // 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
753
835
  // be present -- this must NOT read a capitalized 'Orchestrator' key (the
754
836
  // N15 finding: that stray casing silently never matched a roleMap
755
837
  // author's natural lowercase key).
756
- 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);
757
842
  const runProbe = async (cmd, member) => {
758
843
  const res = await fleetApi.executeCommand({ command: cmd, member_name: member });
759
844
  const text = res && res.content && res.content[0] ? res.content[0].text : '';
@@ -762,20 +847,20 @@ async function main() {
762
847
  if (exitCode !== 0) throw new Error(text || `exit code ${exitCode}`);
763
848
  return res && res.structuredContent && typeof res.structuredContent.stdout === 'string' ? res.structuredContent.stdout : text;
764
849
  };
765
- // Which .beads the orchestrator member's bd resolves to -- probed BEFORE
850
+ // Which .beads the backlog member's bd resolves to -- probed BEFORE
766
851
  // the `bd show` precondition below so a member with no beads database
767
852
  // is reported plainly (a warning with the fix) ahead of the bare bd
768
853
  // error that precondition would otherwise be the first to show, and
769
854
  // shown in the banner. A failed probe is a warning, not an exit: the
770
855
  // existing preconditions decide. The runner repeats this for every
771
856
  // member and hard-fails only a mismatch against --expect-beads.
772
- const beadsProbe = await probeBeadsIdentityOnMember({ member: orchestratorMember, runCommand: runProbe });
857
+ const beadsProbe = await probeBeadsIdentityOnMember({ member: backlogMember, runCommand: runProbe });
773
858
  if (!beadsProbe.ok) {
774
859
  console.warn(beadsProbe.message);
775
860
  }
776
861
  const issueCheck = await checkIssuesExistOnMember({
777
862
  targetIssues,
778
- member: orchestratorMember,
863
+ member: backlogMember,
779
864
  runBdShow: async (id, member) => fleetApi.executeCommand({ command: `bd show ${id}`, member_name: member }),
780
865
  });
781
866
  if (!issueCheck.ok) {
@@ -788,7 +873,7 @@ async function main() {
788
873
  //
789
874
  // LEGACY mode (default): the runner's cross-member coherence relies on
790
875
  // every member sharing one workspace/DB -- every orchestrator-side `bd`
791
- // 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
792
877
  // git branch is only coherent if every member operates on the same working
793
878
  // state. Enforce that by comparing `git rev-parse HEAD` across members and
794
879
  // refusing to start on a mismatch.
@@ -814,16 +899,16 @@ async function main() {
814
899
  // fleet-sprint orchestrator, docs/design-orchestrator-worktree-model-v2.md)
815
900
  // may have no real checkout at all, and `git rev-parse HEAD` on one
816
901
  // hard-fails the launch (process.exit(1) just below). Deliberately keyed
817
- // on the `unreservable` FLAG, not on roleMap.orchestrator membership: a
902
+ // on the `unreservable` FLAG, not on roleMap.backlog membership: a
818
903
  // real, git-having dispatch member that is ADDITIONALLY role-mapped as
819
- // orchestrator (a supported topology, runner.js's branchEnsureMembers
904
+ // backlog (a supported topology, runner.js's branchEnsureMembers
820
905
  // dedupe comment) must still pass its legitimate same-HEAD check against
821
- // the other dispatch members -- filtering on roleMap.orchestrator alone
906
+ // the other dispatch members -- filtering on roleMap.backlog alone
822
907
  // would silently skip that check instead of just skipping a git-less
823
908
  // member. This only matters when an operator also lists a shared member
824
- // in --members (redundant with roleMap.orchestrator, and not required);
825
- // a normal launch that passes the shared orchestrator ONLY via
826
- // roleMap.orchestrator was never affected.
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.
827
912
  const topologyMembersFiltered = validMembers.filter((m) => !unreservableNames.has(m));
828
913
  // Degrade back to the unfiltered list if excluding unreservable members
829
914
  // would empty it out entirely -- checkMemberTopology refuses to start on
@@ -832,13 +917,54 @@ async function main() {
832
917
  // the ORIGINAL single-member-trivial-pass behavior rather than a topology
833
918
  // error about having no members at all.
834
919
  const topologyMembers = topologyMembersFiltered.length > 0 ? topologyMembersFiltered : validMembers;
835
- 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({
836
958
  members: topologyMembers,
837
959
  mode: syncedMode ? 'synced' : 'legacy',
960
+ baseBranch,
961
+ branch: branchName,
962
+ runGit: runAlignGit,
963
+ log: (msg) => console.log(msg),
838
964
  getIdentity: (member) => runCommand('git rev-parse HEAD', member),
839
965
  getOriginUrl: (member) => runCommand('git remote get-url origin', member),
840
966
  doltProbe: (member) => runCommand('bd dolt pull', member),
841
- });
967
+ }) });
842
968
  if (!topology.ok) {
843
969
  console.error(`Error: ${topology.message}`);
844
970
  transport.stop();
@@ -848,13 +974,13 @@ async function main() {
848
974
  console.log(topology.message);
849
975
  }
850
976
 
851
- console.log('Starting Auto-Sprint');
977
+ console.log('Starting fleet-sprint');
852
978
  console.log(`Target Issues: ${targetIssues.join(', ')}`);
853
979
  console.log(`Sprint Branch: ${branchName} (Base: ${baseBranch})`);
854
980
  console.log(`Goal Constraint: ${goal}`);
855
981
  console.log(`Max Cycles: ${maxCycles}`);
856
982
  console.log(`Active Members (${validMembers.length}): ${validMembers.join(', ')}`);
857
- console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `orchestrator '${orchestratorMember}'` })}`);
983
+ console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `backlog '${backlogMember}'` })}`);
858
984
  if (expectedBeads) {
859
985
  console.log(`Beads: ${formatBeadsIdentity(expectedBeads, { label: 'expected (--expect-beads)' })}`);
860
986
  }
@@ -865,7 +991,9 @@ async function main() {
865
991
  const server = createDashboardViewer(workflow, {
866
992
  port: viewerPort,
867
993
  name: 'Fleet-Sprint',
868
- 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],
869
997
  // apra-fleet-eft.37.1/37.2: the core viewer now speaks opts.runId
870
998
  // (opts.sprintId is a deprecated BOUNDARY-COMPAT alias -- never use
871
999
  // it from here).
@@ -884,7 +1012,7 @@ async function main() {
884
1012
  runId: effectiveRunId,
885
1013
  // BOUNDARY-COMPAT/user-facing convention (apra-fleet-eft.37.1): core's
886
1014
  // crash-net snapshot defaults are domain-neutral (workflow-logs/run_)
887
- // now that sprintId->runId is renamed; auto-sprint keeps its historical
1015
+ // now that sprintId->runId is renamed; fleet-sprint keeps its historical
888
1016
  // sprint-logs/sprint_<HHMMSS>.json convention by passing these
889
1017
  // explicitly rather than picking up the new core defaults.
890
1018
  stateSnapshotDir: 'sprint-logs',
@@ -907,14 +1035,18 @@ async function main() {
907
1035
  onError: (message) => {
908
1036
  viewerFailed = true;
909
1037
  console.error(`Error: ${message}`);
910
- transport.stop();
911
- 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
+ });
912
1044
  },
913
1045
  });
914
1046
 
915
1047
  console.log(`Dashboard live at http://localhost:${viewerPort}`);
916
1048
 
917
- if (viewerFailed) return; // process.exit already called synchronously above
1049
+ if (viewerFailed) return; // onError releases the reservations, then exits
918
1050
 
919
1051
  // apra-fleet-eft.26.1 (Reservation interop gap, Hole 1): a sprint
920
1052
  // launched directly through this CLI (never routed through the
@@ -926,13 +1058,7 @@ async function main() {
926
1058
  // for the dolt-mutex/allocator (the sprint branch name), and release on
927
1059
  // EVERY exit path below: normal success, a caught failure/stall-abort,
928
1060
  // or SIGINT.
929
- const sprintReservation = createMemberReservationClient({
930
- callTool: (name, args) => mcpClient.callTool(name, args),
931
- members: validMembers,
932
- sprintId: branchName,
933
- log: (msg) => console.log(msg),
934
- });
935
- await sprintReservation.reserveAll();
1061
+ // (The members were reserved above, before launch alignment.)
936
1062
 
937
1063
  // apra-fleet-p2to.4.2: reservation handling across a cooperative
938
1064
  // pause/resume (apra-fleet-p2to.1's engine primitive). On 'paused' hand
@@ -1009,6 +1135,7 @@ async function main() {
1009
1135
  .catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
1010
1136
  .finally(() => process.exit(130));
1011
1137
  };
1138
+ process.removeListener('SIGINT', onLaunchSigint);
1012
1139
  process.once('SIGINT', onSigint);
1013
1140
 
1014
1141
  try {
@@ -1023,6 +1150,7 @@ async function main() {
1023
1150
  maxCycles,
1024
1151
  requirementsFile,
1025
1152
  roleMap,
1153
+ roleMapWarnings,
1026
1154
  budget,
1027
1155
  dispatchTimeoutS,
1028
1156
  usageLimitMaxWaitS,
@@ -1030,6 +1158,8 @@ async function main() {
1030
1158
  serviceUrl,
1031
1159
  runId: effectiveRunId,
1032
1160
  expectBeads,
1161
+ skipRegression: Boolean(values['skip-regression']),
1162
+ // ciGate: values['ci-gate'], -- not wired (apra-fleet-dv8i)
1033
1163
  }),
1034
1164
  // apra-fleet-eft.75.1: wires this already-connected mcpClient
1035
1165
  // through to runner.js's createMemberSessionGuard (see its doc