@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
@@ -0,0 +1,263 @@
1
+ // =============================================================================
2
+ // fleet-sprint supervisor -- restart reconciliation + force-release endpoint
3
+ // (apra-fleet-eft.5.4, Plan Part 2.2)
4
+ // =============================================================================
5
+ //
6
+ // Two flows that turn a reservation into a durable terminal event:
7
+ //
8
+ // 1. Restart reconciliation (pairs with eft.4.5 re-adoption). On supervisor
9
+ // restart the ledger is reloaded from disk, but the children it recorded
10
+ // may or may not still be alive. We PID-probe each entry:
11
+ // * a DEAD child releases BOTH axes in ONE atomic write (ledger.release
12
+ // deletes the whole entry -- members AND issueRoots together, never a
13
+ // torn half-release) and its sprint is marked `aborted-by-restart` in
14
+ // the history log;
15
+ // * a LIVE child keeps both axes reserved -- eft.4.5 re-adopts it.
16
+ // An entry with no recorded childPid cannot be probed and so is treated as
17
+ // not-alive: there is no live process to re-adopt, so holding its
18
+ // reservation forever would wedge the scope.
19
+ //
20
+ // 2. Force-release (POST /api/reservations/:sprintId/force-release) for a
21
+ // wedged reservation an operator needs to tear down by hand. It releases
22
+ // BOTH axes and records who/why in history. An unknown sprint id 404s.
23
+ //
24
+ // Both flows go through the SAME ledger.release() (one atomic both-axis write)
25
+ // and the SAME history log, so the audit trail is uniform.
26
+ //
27
+ // apra-fleet-3i3.1: force-release now ALSO kills the reservation's still-live
28
+ // child (if any) via the injected `killPid` collaborator, in the SAME action
29
+ // -- previously an operator had to separately hunt down and kill a wedged
30
+ // child by hand after force-releasing its reservation. `killPid` defaults to
31
+ // a SAFE NO-OP (kills nothing, always returns false): sending a real
32
+ // destructive signal to an arbitrary pid must never be something a caller
33
+ // gets by omission. Only bin/serve.mjs's production wiring injects the real
34
+ // `killPid` export below (`process.kill(pid, 'SIGKILL')`, guarded), scoped to
35
+ // pids the eft.4.2 spawner actually tracks. Every existing/other test that
36
+ // constructs createReconciler({ ledger, history }) without injecting killPid
37
+ // therefore never sends a real signal, even when a seeded reservation happens
38
+ // to carry a low/system-adjacent childPid.
39
+ //
40
+ // apra-fleet-3i3.3: forceRelease()'s return now ALSO echoes the released
41
+ // entry's branch/base/goal (in addition to the members/issueRoots history.
42
+ // record() already echoed) -- release() deletes the whole ledger entry, so
43
+ // this is the last point they are readable. The Sprint Stack's new Restart
44
+ // control (dashboard.mjs) is a client-side, two-step flow: it calls THIS
45
+ // same force-release route first, then POSTs the SAME branch/base/goal/
46
+ // members/issueRoots straight back to POST /api/sprints to relaunch, without
47
+ // a dedicated server-side "restart" endpoint or any new plumbing here. Purely
48
+ // additive to forceRelease()'s existing return shape -- every pre-existing
49
+ // caller that ignores the new fields is unaffected.
50
+ // =============================================================================
51
+
52
+ import { readJsonBody, sendJson } from './server.mjs';
53
+ import { HISTORY_EVENTS } from './history.mjs';
54
+ import { withTimestamps } from './log-timestamp.mjs';
55
+
56
+ /**
57
+ * Default liveness probe: signal 0 tests for the process's existence without
58
+ * actually delivering a signal. ESRCH => the pid is gone (dead). EPERM => the
59
+ * process exists but we may not signal it (still ALIVE). Any other error is
60
+ * treated conservatively as not-alive.
61
+ * @param {number} pid
62
+ * @returns {boolean}
63
+ */
64
+ export function isPidAlive(pid) {
65
+ if (!Number.isInteger(pid) || pid <= 0) return false;
66
+ try {
67
+ process.kill(pid, 0);
68
+ return true;
69
+ } catch (err) {
70
+ if (err && err.code === 'EPERM') return true;
71
+ return false;
72
+ }
73
+ }
74
+
75
+ /**
76
+ * Real kill-signal implementation: sends `signal` (default SIGKILL, an
77
+ * immediate hard kill -- distinct from the existing cooperative
78
+ * POST /api/sprints/:id/stop proxy, which asks the child's own /stop
79
+ * endpoint to shut down gracefully) to `pid`. ESRCH (already gone) is
80
+ * treated as success -- the goal ("make sure this pid is not running") is
81
+ * already satisfied. Any other failure (e.g. EPERM) returns false rather
82
+ * than throwing, so a kill failure never blocks the reservation release
83
+ * that follows it in forceRelease() below.
84
+ *
85
+ * NOT wired as createReconciler()'s default -- see the module doc above for
86
+ * why an accidental real kill must never happen by omission. Only
87
+ * bin/serve.mjs's production wiring imports and injects this explicitly.
88
+ * @param {number} pid
89
+ * @param {NodeJS.Signals} [signal]
90
+ * @returns {boolean}
91
+ */
92
+ export function killPid(pid, signal = 'SIGKILL') {
93
+ if (!Number.isInteger(pid) || pid <= 0) return false;
94
+ try {
95
+ process.kill(pid, signal);
96
+ return true;
97
+ } catch (err) {
98
+ if (err && err.code === 'ESRCH') return true;
99
+ return false;
100
+ }
101
+ }
102
+
103
+ /** Error thrown when a force-release targets a sprint with no live reservation. */
104
+ export class SprintNotFoundError extends Error {
105
+ constructor(sprintId) {
106
+ super(`no live reservation for sprint '${sprintId}'`);
107
+ this.name = 'SprintNotFoundError';
108
+ this.code = 'SPRINT_NOT_FOUND';
109
+ this.sprintId = sprintId;
110
+ }
111
+ }
112
+
113
+ /**
114
+ * Create the restart-reconciler / force-release controller.
115
+ *
116
+ * @param {{
117
+ * ledger: {
118
+ * list: () => Array<{ sprintId: string, members: string[], issueRoots: string[], childPid: number|null }>,
119
+ * get: (sprintId: string) => object|undefined,
120
+ * release: (sprintId: string) => Promise<boolean>,
121
+ * },
122
+ * history: { record: (entry: object) => Promise<object> },
123
+ * isPidAlive?: (pid: number) => boolean,
124
+ * killPid?: (pid: number) => boolean,
125
+ * now?: () => string,
126
+ * logger?: { log?: Function, error?: Function },
127
+ * }} deps
128
+ */
129
+ export function createReconciler(deps = {}) {
130
+ const ledger = deps.ledger;
131
+ const history = deps.history;
132
+ if (!ledger || typeof ledger.list !== 'function' || typeof ledger.release !== 'function') {
133
+ throw new TypeError('createReconciler requires a ledger with list()/get()/release()');
134
+ }
135
+ if (!history || typeof history.record !== 'function') {
136
+ throw new TypeError('createReconciler requires a history with record()');
137
+ }
138
+ const probe = deps.isPidAlive ?? isPidAlive;
139
+ // apra-fleet-3i3.1: safe no-op default -- see killPid()'s and the module
140
+ // doc's explanation of why a real kill must be an explicit opt-in, never
141
+ // an accidental default.
142
+ const kill = deps.killPid ?? (() => false);
143
+ const now = deps.now ?? (() => new Date().toISOString());
144
+ // apra-fleet-k7b.2: ISO-timestamp-prefix every log line from this module.
145
+ const logger = withTimestamps(deps.logger ?? console);
146
+ const log = (...a) => logger.log?.(...a);
147
+
148
+ /**
149
+ * PID-probe every reloaded ledger entry once, at supervisor restart. Dead
150
+ * children release both axes and are marked aborted-by-restart; live
151
+ * children are retained for eft.4.5 re-adoption.
152
+ * @returns {Promise<{ released: string[], retained: string[] }>}
153
+ */
154
+ async function reconcile() {
155
+ // Snapshot first: ledger.list() returns clones, so releasing during the
156
+ // loop cannot disturb iteration.
157
+ const entries = ledger.list();
158
+ const released = [];
159
+ const retained = [];
160
+ for (const entry of entries) {
161
+ const alive = entry.childPid != null && probe(entry.childPid);
162
+ if (alive) {
163
+ retained.push(entry.sprintId);
164
+ continue;
165
+ }
166
+ // Dead (or unprobeable) child: release BOTH axes in one atomic write.
167
+ // eslint-disable-next-line no-await-in-loop -- releases must be serialized through the ledger's single-writer transaction chain.
168
+ await ledger.release(entry.sprintId);
169
+ // eslint-disable-next-line no-await-in-loop
170
+ await history.record({
171
+ sprintId: entry.sprintId,
172
+ event: HISTORY_EVENTS.ABORTED_BY_RESTART,
173
+ reason: entry.childPid == null
174
+ ? 'no recorded child pid at supervisor restart'
175
+ : `child pid ${entry.childPid} not alive at supervisor restart`,
176
+ members: entry.members,
177
+ issueRoots: entry.issueRoots,
178
+ at: now(),
179
+ });
180
+ released.push(entry.sprintId);
181
+ }
182
+ log(`[reconcile] restart: released ${released.length} dead, retained ${retained.length} live`);
183
+ return { released, retained };
184
+ }
185
+
186
+ /**
187
+ * Operator force-release of a wedged reservation. apra-fleet-3i3.1: ALSO
188
+ * kills the reservation's still-live child (if any, via the injected
189
+ * `killPid`) in the SAME action, before releasing both axes and
190
+ * recording an audit reason -- a kill failure (or no recorded childPid at
191
+ * all) never blocks the release that follows it. Throws
192
+ * SprintNotFoundError for an unknown sprint.
193
+ * @param {string} sprintId
194
+ * @param {{ by?: string, reason?: string }} [audit]
195
+ * @returns {Promise<object>} the recorded history event, plus `childPid`,
196
+ * `killed` (whether the kill signal was believed to land; null when
197
+ * there was no recorded childPid to kill), and (apra-fleet-3i3.3) the
198
+ * released entry's `branch`/`base`/`goal` (each `null` when the entry
199
+ * never persisted it -- a pre-3i3.2 legacy entry, or an omitted `goal`)
200
+ */
201
+ async function forceRelease(sprintId, audit = {}) {
202
+ if (typeof sprintId !== 'string' || sprintId.length === 0) {
203
+ throw new TypeError('forceRelease requires a non-empty sprintId');
204
+ }
205
+ const entry = ledger.get(sprintId);
206
+ if (!entry) {
207
+ throw new SprintNotFoundError(sprintId);
208
+ }
209
+ const childPid = entry.childPid ?? null;
210
+ const killed = childPid != null ? kill(childPid) : null;
211
+ // apra-fleet-3i3.3: capture BEFORE release() below deletes the whole
212
+ // entry -- this is the last point these are readable from the ledger.
213
+ const branch = entry.branch ?? null;
214
+ const base = entry.base ?? null;
215
+ const goal = entry.goal ?? null;
216
+ await ledger.release(sprintId);
217
+ const recorded = await history.record({
218
+ sprintId,
219
+ event: HISTORY_EVENTS.FORCE_RELEASED,
220
+ reason: audit.reason ?? 'force-released by operator',
221
+ by: audit.by ?? null,
222
+ members: entry.members,
223
+ issueRoots: entry.issueRoots,
224
+ at: now(),
225
+ });
226
+ return { ...recorded, childPid, killed, branch, base, goal };
227
+ }
228
+
229
+ return {
230
+ name: 'reconciler',
231
+ reconcile,
232
+ forceRelease,
233
+ };
234
+ }
235
+
236
+ /**
237
+ * Register the force-release HTTP route against a supervisor (server.mjs).
238
+ * The path carries the sprint id as a `:sprintId` param, matched by the
239
+ * supervisor's pattern-route support.
240
+ *
241
+ * @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
242
+ * @param {{ forceRelease: (sprintId: string, audit: object) => Promise<object> }} reconciler
243
+ */
244
+ export function registerReservationRoutes(supervisor, reconciler) {
245
+ supervisor.route('POST', '/api/reservations/:sprintId/force-release', async (req, res, ctx) => {
246
+ const sprintId = ctx?.params?.sprintId;
247
+ if (!sprintId) {
248
+ sendJson(res, 400, { error: 'missing sprintId in path' });
249
+ return;
250
+ }
251
+ const body = (await readJsonBody(req)) ?? {};
252
+ try {
253
+ const audit = await reconciler.forceRelease(sprintId, { by: body.by, reason: body.reason });
254
+ sendJson(res, 200, { status: 'force-released', sprintId, audit });
255
+ } catch (err) {
256
+ if (err && err.code === 'SPRINT_NOT_FOUND') {
257
+ sendJson(res, 404, { error: err.message });
258
+ return;
259
+ }
260
+ throw err;
261
+ }
262
+ });
263
+ }
@@ -0,0 +1,87 @@
1
+ // =============================================================================
2
+ // fleet-sprint supervisor -- bounded EPERM/EBUSY retry around an atomic
3
+ // tmp-write-then-rename replace (apra-fleet-ed4.1)
4
+ // =============================================================================
5
+ //
6
+ // history.mjs's and ledger.mjs's persist() both write to a `.tmp` file then
7
+ // fs.rename() it over the real file -- the same atomic-replace primitive, so
8
+ // a torn/partial write is never visible to a concurrent reader. On Windows,
9
+ // that fs.rename() step can fail with EPERM/EBUSY when the destination file
10
+ // is momentarily locked/open by another process (e.g. an AV scanner, a
11
+ // concurrent reader mid-open) -- a TRANSIENT, self-clearing condition, not a
12
+ // real failure. Without a retry this silently drops whatever persist() was
13
+ // writing (observed live 2026-08-01 on a watchdog history.record(
14
+ // AUTO_RELEASED) -- a durable audit event vanished with no error surfaced
15
+ // anywhere).
16
+ //
17
+ // This module is the single shared retry loop both persist() call sites use,
18
+ // so the bounded-retry discipline (and its "what counts as retryable" rule)
19
+ // lives in exactly one place instead of being duplicated.
20
+ // =============================================================================
21
+
22
+ /** Default max attempts (the first try, plus up to this many-1 retries). */
23
+ export const RENAME_RETRY_DEFAULT_MAX_ATTEMPTS = 5;
24
+
25
+ /** Default base backoff (ms) -- escalates linearly per attempt (attempt * base). */
26
+ export const RENAME_RETRY_DEFAULT_BASE_DELAY_MS = 10;
27
+
28
+ function defaultSleep(ms) {
29
+ return new Promise((resolve) => { setTimeout(resolve, ms); });
30
+ }
31
+
32
+ /**
33
+ * Bounded EPERM/EBUSY retry around `fs.rename(tmpPath, destPath)`.
34
+ *
35
+ * Retries ONLY when `err.code === 'EPERM' || err.code === 'EBUSY'` (the
36
+ * transient Windows-locking symptom) -- any other error (e.g. ENOENT, a
37
+ * permanent EACCES) re-throws immediately on the FIRST attempt, since a
38
+ * bounded retry loop must never mask a genuinely different failure as "just
39
+ * needs another try".
40
+ *
41
+ * Bounded: after `maxAttempts` total attempts (default 5, escalating ~10ms
42
+ * backoff per attempt) a still-failing rename re-throws the LAST error it
43
+ * saw, so a genuinely stuck rename still surfaces -- this never retries
44
+ * forever.
45
+ *
46
+ * On POSIX, or on any platform where the very first `fs.rename()` call
47
+ * succeeds, this makes EXACTLY ONE rename call -- byte-identical behavior to
48
+ * a bare `await fs.rename(tmpPath, destPath)`, so callers that never hit
49
+ * EPERM/EBUSY see no change at all.
50
+ *
51
+ * @param {{ rename: (src: string, dst: string) => Promise<void> }} fs an
52
+ * injectable fs-like collaborator (matching history.mjs's/ledger.mjs's own
53
+ * injected `deps.fs` convention) exposing an async `rename()`.
54
+ * @param {string} tmpPath
55
+ * @param {string} destPath
56
+ * @param {{
57
+ * maxAttempts?: number,
58
+ * baseDelayMs?: number,
59
+ * sleep?: (ms: number) => Promise<void>,
60
+ * }} [opts] Injectable so a test can drive a fake clock/sleep with no real
61
+ * timers -- `sleep` defaults to a real `setTimeout`-backed delay.
62
+ * @returns {Promise<void>}
63
+ */
64
+ export async function renameWithRetry(fs, tmpPath, destPath, opts = {}) {
65
+ const maxAttempts = Number.isInteger(opts.maxAttempts) && opts.maxAttempts > 0
66
+ ? opts.maxAttempts
67
+ : RENAME_RETRY_DEFAULT_MAX_ATTEMPTS;
68
+ const baseDelayMs = Number.isInteger(opts.baseDelayMs) && opts.baseDelayMs >= 0
69
+ ? opts.baseDelayMs
70
+ : RENAME_RETRY_DEFAULT_BASE_DELAY_MS;
71
+ const sleep = typeof opts.sleep === 'function' ? opts.sleep : defaultSleep;
72
+
73
+ let attempt = 0;
74
+ for (;;) {
75
+ attempt += 1;
76
+ try {
77
+ // eslint-disable-next-line no-await-in-loop
78
+ await fs.rename(tmpPath, destPath);
79
+ return;
80
+ } catch (err) {
81
+ const retryable = Boolean(err) && (err.code === 'EPERM' || err.code === 'EBUSY');
82
+ if (!retryable || attempt >= maxAttempts) throw err;
83
+ // eslint-disable-next-line no-await-in-loop
84
+ await sleep(baseDelayMs * attempt);
85
+ }
86
+ }
87
+ }
@@ -0,0 +1,327 @@
1
+ // =============================================================================
2
+ // fleet-sprint supervisor -- issue-scope overlap guard via live-expanded subtree
3
+ // recomputation (apra-fleet-eft.5.3, Plan Part 2.2)
4
+ // =============================================================================
5
+ //
6
+ // The reservation ledger (src/supervisor/ledger.mjs) stores each live sprint's
7
+ // issue-scope IDENTITY: the root issue id(s) it launched with (`issueRoots`).
8
+ // It deliberately does NOT store a frozen list of every descendant, because
9
+ // planners and reviewers GROW a sprint's subtree mid-run (they add tasks/tests
10
+ // under an already-claimed root). A launch-time snapshot of "everything under
11
+ // root R" would therefore go stale the instant a new child is created, letting
12
+ // a second sprint claim that brand-new child without detecting the overlap.
13
+ //
14
+ // So overlap is checked by RE-EXPANDING subtrees LIVE at every launch attempt:
15
+ //
16
+ // * For the incoming request, expand its root(s) to the full live subtree.
17
+ // * For every active sprint in the ledger, expand ITS root(s) to the full
18
+ // live subtree, right now -- never a launch-time snapshot.
19
+ // * Intersect. Any nonzero intersection rejects the ENTIRE launch, naming the
20
+ // conflicting sprint and the overlapping bead ids.
21
+ //
22
+ // There is deliberately NO partial-launch / carve-out path: we do not launch a
23
+ // sprint over "its scope minus the already-claimed beads". That would require
24
+ // an exclude-set threaded through the runner core loop and is explicitly
25
+ // deferred. Overlap is all-or-nothing: any conflict fails the whole launch.
26
+ //
27
+ // Subtree expansion historically reused the runner.js `bdListScoped`
28
+ // discipline (fleet-sprint/runner.js ~1360): `bd list --parent <id>` accepts
29
+ // EXACTLY ONE id per invocation (a comma-joined `--parent a,b` is silently
30
+ // treated as one nonexistent id and returns []), and is ALSO single-level
31
+ // only (it returns direct children, never grandchildren). That meant one `bd`
32
+ // subprocess spawn PER DISCOVERED NODE in every checkLaunch() call -- N
33
+ // spawns for an N-bead ledger+request tree, every launch attempt.
34
+ //
35
+ // apra-fleet-72o0: the production path now does ONE bulk fetch per
36
+ // checkLaunch() call (`bd list --all --limit 0 --json`, see
37
+ // `bdListAllBeadsWithClosed()` below) and builds the parent-child index / BFS
38
+ // expansion IN-MEMORY off that single result, reusing backlog.mjs's
39
+ // `buildChildIndex()` / `expandScopeInMemory()` (apra-fleet-c4s) -- the SAME
40
+ // technique the dashboard Backlog tab already uses to avoid a per-node `bd`
41
+ // subprocess walk on every render. `--all` matters here specifically: `bd
42
+ // list` hides closed issues by default, so a CLOSED intermediate parent would
43
+ // silently orphan its OPEN subtree from this check without it -- two sprints
44
+ // with genuinely overlapping open work could otherwise both launch. This is a
45
+ // correctness fix, not just a speed one (backlog.mjs's own
46
+ // `bdListAllBeadsRaw()` omits `--all`; that is a separate, already-known bug
47
+ // there, deliberately NOT touched by this change).
48
+ //
49
+ // The old per-node async `expandScope()`/`bdListChildren()` pair is KEPT as
50
+ // the test seam: `createScopeGuard({ listChildren })` still drives the exact
51
+ // same per-root, single-id-per-call `bd list --parent <id>` BFS when a caller
52
+ // explicitly injects `listChildren` (existing tests and callers that want a
53
+ // stubbed child-lister without a bulk-fetch fixture) -- never a comma-joined
54
+ // `--parent`, never a single call expected to return a whole subtree.
55
+ //
56
+ // KNOWN HOLE (surfaced, not hidden): a `blocks` edge that crosses two disjoint
57
+ // claimed scopes is NOT detected here. This guard reasons purely about the
58
+ // parent-child grouping subtree of each root; cross-scope ordering edges are
59
+ // out of scope for this reservation check.
60
+ // =============================================================================
61
+
62
+ import { validateIssueId } from '../../fleet-sprint/runner.js';
63
+ import { execBdAsync } from './lib/exec-bd.mjs';
64
+ import { normalizeBead, buildChildIndex, expandScopeInMemory } from './backlog.mjs';
65
+
66
+ /**
67
+ * Default `listChildren`: return the DIRECT child bead ids of a single parent
68
+ * id via `bd list --parent <id> --json`. One id per call -- never a
69
+ * comma-joined multi-parent query (bd silently treats that as one nonexistent
70
+ * id and returns []). Single-level only by design; the BFS in expandScope()
71
+ * walks it to full depth.
72
+ * @param {string} parentId
73
+ * @returns {Promise<string[]>}
74
+ */
75
+ export async function bdListChildren(parentId) {
76
+ // Routed through the shared execBdAsync() helper (apra-fleet-xuo.2), which
77
+ // resolves the platform `bd` command directly (`bd.cmd` on win32) instead
78
+ // of shelling out via `{ shell: true }` -- so no shell is invoked at all,
79
+ // and no shell metacharacter in `parentId` can reach one. validateIssueId()
80
+ // below is kept as defense in depth (letters/digits/'.'/'_'/'-' -only
81
+ // charset, same as the launch API boundary's runner.js ISSUE_ID_PATTERN)
82
+ // in case some future caller forgets to validate upstream.
83
+ validateIssueId(parentId);
84
+ const { stdout } = await execBdAsync(['list', '--parent', parentId, '--json', '--limit', '0']);
85
+ const text = stdout && stdout.trim() ? stdout : '[]';
86
+ let rows;
87
+ try {
88
+ rows = JSON.parse(text);
89
+ } catch (err) {
90
+ throw new Error(`[scope-overlap] failed to parse 'bd list --parent ${parentId} --json': ${err.message}`);
91
+ }
92
+ if (!Array.isArray(rows)) return [];
93
+ return rows
94
+ .map((b) => (b && typeof b.id === 'string' ? b.id : null))
95
+ .filter((id) => id !== null);
96
+ }
97
+
98
+ /**
99
+ * Expand a set of root issue ids into the full live parent-child subtree they
100
+ * span (roots INCLUDED). Each node is queried at most once via `listChildren`,
101
+ * one id per call, and the frontier is walked breadth-first so grandchildren
102
+ * (and deeper) are reached even though `bd list --parent` is single-level.
103
+ *
104
+ * The roots themselves are part of the scope: two sprints launched with the
105
+ * same root, or a request rooted at a bead already inside an active scope, must
106
+ * both surface that shared id.
107
+ *
108
+ * @param {Iterable<string>} roots
109
+ * @param {(parentId: string) => Promise<string[]>} listChildren
110
+ * @returns {Promise<Set<string>>} every bead id in the live subtree, roots included
111
+ */
112
+ export async function expandScope(roots, listChildren) {
113
+ const scope = new Set();
114
+ const frontier = [];
115
+ for (const r of roots) {
116
+ if (typeof r === 'string' && r.length > 0 && !scope.has(r)) {
117
+ scope.add(r);
118
+ frontier.push(r);
119
+ }
120
+ }
121
+ while (frontier.length > 0) {
122
+ const id = frontier.shift();
123
+ // eslint-disable-next-line no-await-in-loop -- BFS must query each node one --parent id at a time (bd rejects comma-joined multi-parent).
124
+ const children = await listChildren(id);
125
+ for (const child of children) {
126
+ if (typeof child === 'string' && child.length > 0 && !scope.has(child)) {
127
+ scope.add(child);
128
+ frontier.push(child);
129
+ }
130
+ }
131
+ }
132
+ return scope;
133
+ }
134
+
135
+ /**
136
+ * Default `listAllBeads` for the bulk path (apra-fleet-72o0): every bead,
137
+ * OPEN AND CLOSED, in one call -- `bd list --all --limit 0 --json`.
138
+ * Deliberately its own small fetcher (not a reuse of backlog.mjs's
139
+ * `bdListAllBeadsRaw()`) because that helper omits `--all` -- a separate,
140
+ * already-known bug there this change must not copy or silently "fix" as a
141
+ * side effect. `--all` is required HERE: a CLOSED intermediate parent must
142
+ * still surface its OPEN descendants to the overlap check, or that subtree
143
+ * silently falls out of both the request's and an active sprint's live scope.
144
+ * @returns {Promise<object[]>} raw `bd list` rows, unnormalized
145
+ */
146
+ export async function bdListAllBeadsWithClosed(options = {}) {
147
+ // Routed through the shared execBdAsync() helper (apra-fleet-xuo.2), same
148
+ // as bdListChildren() below and backlog.mjs's fetchAllBeadsRaw() -- no
149
+ // shell metacharacter risk, consistent cross-platform `bd` resolution.
150
+ // `options.cwd` (optional) pins WHICH .beads is listed; omitted, bd
151
+ // resolves from process.cwd() exactly as before. The supervisor's cached
152
+ // beads view passes its repoRoot so the list provably reads the same
153
+ // clone its backlog member pulls.
154
+ const execOptions = options && typeof options.cwd === 'string' && options.cwd.length > 0 ? { cwd: options.cwd } : {};
155
+ const { stdout } = await execBdAsync(['list', '--all', '--limit', '0', '--json'], execOptions);
156
+ const text = stdout && stdout.trim() ? stdout : '[]';
157
+ let rows;
158
+ try {
159
+ rows = JSON.parse(text);
160
+ } catch (err) {
161
+ throw new Error(`[scope-overlap] failed to parse 'bd list --all --json': ${err.message}`);
162
+ }
163
+ if (!Array.isArray(rows)) return [];
164
+ return rows.filter((b) => b && typeof b.id === 'string' && b.id.length > 0);
165
+ }
166
+
167
+ /**
168
+ * Human-readable rejection message naming every conflicting sprint and the
169
+ * overlapping bead ids, for surfacing to the launch caller / API response.
170
+ * @param {Array<{ sprintId: string, overlappingIds: string[] }>} conflicts
171
+ * @returns {string}
172
+ */
173
+ export function formatScopeConflict(conflicts) {
174
+ const parts = conflicts.map(
175
+ (c) => `sprint '${c.sprintId}' already claims [${c.overlappingIds.join(', ')}]`,
176
+ );
177
+ return `issue-scope overlap rejects launch: ${parts.join('; ')}`;
178
+ }
179
+
180
+ /**
181
+ * Create the issue-scope overlap guard. Collaborators are injected so tests can
182
+ * drive an in-memory ledger and a stub child-lister without a real `bd`.
183
+ *
184
+ * Two expansion paths, chosen once at construction (apra-fleet-72o0):
185
+ * - `deps.listChildren` supplied (explicit test seam): every expansion goes
186
+ * through the OLD per-node async BFS (`expandScope()` above) -- one
187
+ * `bd list --parent <id>`-shaped call per discovered node, exactly the
188
+ * pre-existing behavior existing tests/callers already rely on.
189
+ * - `deps.listChildren` omitted (the production default): `checkLaunch()`
190
+ * does ONE bulk `deps.listAllBeads()` fetch (default
191
+ * `bdListAllBeadsWithClosed()`, i.e. `bd list --all --limit 0 --json`) up
192
+ * front, builds a `buildChildIndex()` off it ONCE, and expands BOTH the
193
+ * request's roots and every ledger sprint's `issueRoots` from that same
194
+ * in-memory index via `expandScopeInMemory()` -- zero additional `bd`
195
+ * subprocess spawns per node. Mirrors backlog.mjs's `createBacklog()`
196
+ * `explicitExpand` seam (same shape, same reasoning: an injected
197
+ * collaborator overrides wholesale, the production default never calls
198
+ * the injected-only path).
199
+ *
200
+ * @param {{
201
+ * ledger: { list: () => Array<{ sprintId: string, issueRoots: string[] }> },
202
+ * listChildren?: (parentId: string) => Promise<string[]>,
203
+ * listAllBeads?: () => Promise<object[]>,
204
+ * logger?: { log?: Function, error?: Function },
205
+ * }} deps
206
+ */
207
+ export function createScopeGuard(deps = {}) {
208
+ const ledger = deps.ledger;
209
+ if (!ledger || typeof ledger.list !== 'function') {
210
+ throw new TypeError('createScopeGuard requires a ledger with a list() method');
211
+ }
212
+ // Only set when a caller (test, or a future explicit-stub consumer)
213
+ // injects a child-lister wholesale -- the production default path below
214
+ // never calls it (apra-fleet-72o0: no per-node `bd` subprocess walk on
215
+ // every checkLaunch()).
216
+ const explicitListChildren = deps.listChildren ?? null;
217
+ const listAllBeads = deps.listAllBeads ?? bdListAllBeadsWithClosed;
218
+
219
+ /**
220
+ * Expand `roots` under the currently-selected path: the injected
221
+ * per-node lister if one was supplied at construction, else a fresh bulk
222
+ * fetch + in-memory BFS. Used by the guard's standalone `expandScope()`
223
+ * export below (called outside a `checkLaunch()` batch, so it cannot
224
+ * reuse a shared child index).
225
+ * @param {Iterable<string>} roots
226
+ * @returns {Promise<Set<string>>}
227
+ */
228
+ async function expandScopeStandalone(roots) {
229
+ if (explicitListChildren) return expandScope(roots, explicitListChildren);
230
+ const rawBeads = await listAllBeads();
231
+ const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
232
+ return expandScopeInMemory(roots, buildChildIndex(beads));
233
+ }
234
+
235
+ /**
236
+ * Check whether launching a sprint with `requestRoots` would overlap any
237
+ * currently-active sprint's live-expanded issue subtree. Re-expands BOTH
238
+ * the request's and every active sprint's roots AT CALL TIME -- never a
239
+ * frozen snapshot -- so a bead created after an earlier launch, under an
240
+ * already-claimed root, is still detected.
241
+ *
242
+ * Any nonzero intersection with ANY active sprint rejects the ENTIRE
243
+ * launch (no partial/carve-out path). `conflicts` lists every offending
244
+ * sprint and the overlapping bead ids.
245
+ *
246
+ * @param {string[]} requestRoots - the incoming sprint's root issue id(s)
247
+ * @param {{ excludeSprintId?: string }} [opts] - ignore one sprint (e.g. a
248
+ * re-adoption / self-check that should not conflict with itself)
249
+ * @returns {Promise<{ ok: boolean, requestScope: string[], conflicts: Array<{ sprintId: string, overlappingIds: string[] }> }>}
250
+ */
251
+ async function checkLaunch(requestRoots, opts = {}) {
252
+ const roots = Array.isArray(requestRoots) ? requestRoots : [];
253
+ if (roots.length === 0) {
254
+ throw new TypeError('checkLaunch requires a non-empty array of request root issue ids');
255
+ }
256
+ const excludeSprintId = opts.excludeSprintId;
257
+
258
+ // Validate the REQUEST's root ids before they are used (dolt sync
259
+ // budget review round 2, item 6). The old per-node path validated
260
+ // every root inside bdListChildren(); the bulk in-memory path never
261
+ // calls it, so a malformed root id silently expanded to just itself
262
+ // and was then reported as non-overlapping -- an invalid launch
263
+ // request accepted rather than rejected. This is a correctness/UX
264
+ // restoration, not an injection guard (the bulk fetch passes no root
265
+ // id to `bd` at all). Only the request's own roots are validated:
266
+ // ledger roots were validated when their sprint launched, and
267
+ // re-rejecting them here would turn one bad historical record into a
268
+ // hard failure of every subsequent launch.
269
+ if (!explicitListChildren) {
270
+ for (const root of roots) validateIssueId(root);
271
+ }
272
+
273
+ // Build the child index ONCE per checkLaunch() call (bulk path only)
274
+ // -- one `bd` subprocess spawn total, however many roots/ledger
275
+ // sprints there are to expand. The explicit-listChildren seam has no
276
+ // shared index; each expansion issues its own per-node calls, same
277
+ // as before apra-fleet-72o0.
278
+ let childIndex = null;
279
+ if (!explicitListChildren) {
280
+ const rawBeads = await listAllBeads();
281
+ const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
282
+ childIndex = buildChildIndex(beads);
283
+ }
284
+
285
+ const expand = (rs) => (explicitListChildren
286
+ ? expandScope(rs, explicitListChildren)
287
+ : Promise.resolve(expandScopeInMemory(rs, childIndex)));
288
+
289
+ // Live-expand the incoming request's scope once.
290
+ const requestScope = await expand(roots);
291
+
292
+ const conflicts = [];
293
+ for (const reservation of ledger.list()) {
294
+ if (excludeSprintId !== undefined && reservation.sprintId === excludeSprintId) continue;
295
+ const resRoots = Array.isArray(reservation.issueRoots) ? reservation.issueRoots : [];
296
+ if (resRoots.length === 0) continue;
297
+ // Live-expand THIS active sprint's subtree right now, never a
298
+ // launch-time snapshot -- so mid-run subtree growth is seen. In
299
+ // the bulk path this reuses the SAME childIndex built above (no
300
+ // extra `bd` call); in the explicit-listChildren seam it issues
301
+ // its own per-node BFS, same as before.
302
+ // eslint-disable-next-line no-await-in-loop -- explicit-listChildren seam expands each active sprint's subtree independently; ledger sets are small. (Bulk path resolves synchronously, so this never actually awaits a pending promise.)
303
+ const activeScope = await expand(resRoots);
304
+ const overlappingIds = [];
305
+ for (const id of requestScope) {
306
+ if (activeScope.has(id)) overlappingIds.push(id);
307
+ }
308
+ if (overlappingIds.length > 0) {
309
+ overlappingIds.sort();
310
+ conflicts.push({ sprintId: reservation.sprintId, overlappingIds });
311
+ }
312
+ }
313
+
314
+ return {
315
+ ok: conflicts.length === 0,
316
+ requestScope: [...requestScope].sort(),
317
+ conflicts,
318
+ };
319
+ }
320
+
321
+ return {
322
+ name: 'scope-guard',
323
+ expandScope: (roots) => expandScopeStandalone(roots),
324
+ checkLaunch,
325
+ formatScopeConflict,
326
+ };
327
+ }