@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,745 @@
1
+ // Beads scope discovery + the shared full-DB snapshot for fleet-sprint
2
+ // (apra-fleet-3swo.4.6). Extracted out of runner.js; runner.js re-exports
3
+ // every symbol it previously exported from this region, so existing importers
4
+ // of fleet-sprint/runner.js resolve unchanged.
5
+ //
6
+ // This module owns TWO things that used to be spread across runner.js:
7
+ //
8
+ // 1. ONE BFS scope-discovery implementation (discoverScope below). Before
9
+ // the extraction there were two byte-independent copies of the same
10
+ // rule -- one inside bdListScoped()'s closure and one inside
11
+ // classifyVerifySet() -- kept apart only because classifyVerifySet had
12
+ // to stay pure and testable while bdListScoped lived inside
13
+ // runSprintCycle()'s closure. discoverScope() is pure, so both callers
14
+ // now share it and the two copies cannot drift apart again.
15
+ //
16
+ // 2. The shared full-DB beads snapshot (createBeadsScope below): the single
17
+ // `bd list --all --limit 0 --json` fetch per phase, its in-flight
18
+ // coalescing, and -- critically -- the choke points that invalidate it.
19
+ //
20
+ // -----------------------------------------------------------------------------
21
+ // SNAPSHOT INVALIDATION CONTRACT (this is what the code ACTUALLY does; earlier
22
+ // planning text claiming the snapshot "is only invalidated at planner
23
+ // boundaries" was wrong)
24
+ // -----------------------------------------------------------------------------
25
+ //
26
+ // The snapshot lives AT MOST ONE PHASE. It is dropped on ALL of:
27
+ //
28
+ // (a) EVERY phase boundary. wrapPhase() invalidates unconditionally on every
29
+ // phase() call, so a new step can never inherit the previous step's
30
+ // view. This is the dominant invalidation in practice -- a snapshot
31
+ // almost never survives more than one phase step.
32
+ // (b) EVERY beads-mutating command issued through the wrapCommand() wrapper.
33
+ // `bd list|show|ready|config` are known reads (BD_READ_ONLY_RE) and keep
34
+ // the snapshot; update/create/close/note/dep/dolt-pull and ANY
35
+ // unrecognized `bd` subcommand are conservatively treated as mutations
36
+ // and drop it. The failure mode is a redundant full fetch, never
37
+ // silently stale data. Non-`bd` commands (git, node probes) never touch
38
+ // beads state.
39
+ // (c) EVERY planner dispatch that returns successfully -- runner.js calls
40
+ // invalidateAllBeadsCache() explicitly right after dispatchPlanner() in
41
+ // both the main Planning Loop and the in-cycle scoped replan. The
42
+ // planner mutates beads on ITS OWN clone via its own `bd create` tool
43
+ // calls, never through this wrapper, so (b) cannot see it; and
44
+ // Execution Prep runs later in the SAME "Plan C{cycle} R{round}" phase
45
+ // (no intervening phase() call), so (a) cannot see it either. Without
46
+ // (c) the planner's freshly created tasks are invisible to the very next
47
+ // Execution Prep step, whose parent-feature filter then finds nothing
48
+ // ready and silently skips Develop for the whole cycle. Deliberately
49
+ // scoped to the PLANNER only: an unconditional per-dispatch
50
+ // invalidation was tried and reverted, because it defeats the
51
+ // "one full-DB fetch per phase" cost control that
52
+ // full-db-fetch-tripwire.test.mjs pins, for every other role
53
+ // (doer/reviewer/deployer/...) that has no same-phase reader depending
54
+ // on its bead mutations.
55
+ //
56
+ // WHAT THE CONTRACT DOES *NOT* COVER, and the deliberate bypass sites that
57
+ // exist because of it: a bead mutation performed INSIDE an agent() dispatch
58
+ // (a doer's or the integ runner's own `bd close`) never passes through
59
+ // wrapCommand(), so (b) cannot see it. In a topology with no dolt sync remote
60
+ // nothing else forces a refresh either (doltPullBefore/After are benign
61
+ // no-ops there), so the snapshot can be stale by a full cycle. Three read
62
+ // sites in runner.js therefore deliberately BYPASS the snapshot by calling
63
+ // bdListScoped() with a non-empty filter -- which always issues a real,
64
+ // freshly-scoped `bd list` command (see bdListScoped below) -- instead of
65
+ // reading fetchAllBeadsShared():
66
+ //
67
+ // 1. the per-cycle stall-detection closed-list read (`closedBeadsNow`, the
68
+ // `--status=closed --json` read feeding closedCountHistory),
69
+ // 2. the per-cycle verify-set exit check (`closedIdsForExitCheck`), which
70
+ // runs after the Re-Review block may have pushed further mutations this
71
+ // cycle, and
72
+ // 3. Final Review's `finalClosedBeads` read, which backs both
73
+ // finalClosedCount and finalUnclosedVerifyIds.
74
+ //
75
+ // All three are counting/gating reads whose whole job is to observe closures
76
+ // an agent made; serving them from the snapshot would let a sprint exit (or
77
+ // declare a stall) on a stale count. Do not "optimize" them onto
78
+ // fetchAllBeadsShared().
79
+ // =============================================================================
80
+
81
+ /**
82
+ * `bd` subcommands that can never change beads state, so they must not drop a
83
+ * cached full-DB snapshot. Anything else starting with `bd` is conservatively
84
+ * treated as a mutation. Mirrored (deliberately, as an independent copy) by
85
+ * full-db-fetch-guard.mjs, which judges the same rule from a command log.
86
+ */
87
+ export const BD_READ_ONLY_RE = /^bd\s+(list|show|ready|config)\b/i;
88
+
89
+ /**
90
+ * True iff `cmdStr` is a `bd` command that must invalidate the shared full-DB
91
+ * snapshot -- see clause (b) of the invalidation contract above.
92
+ *
93
+ * @param {string} cmdStr - a command string, already trimmed or not
94
+ * @returns {boolean}
95
+ */
96
+ export function isBeadsMutatingCommand(cmdStr) {
97
+ if (typeof cmdStr !== 'string') return false;
98
+ const trimmed = cmdStr.trim();
99
+ return /^bd\b/i.test(trimmed) && !BD_READ_ONLY_RE.test(trimmed);
100
+ }
101
+
102
+ // ---------------------------------------------------------------------------
103
+ // bd JSON-parse helper
104
+ // ---------------------------------------------------------------------------
105
+ //
106
+ // All `bd ... --json` output must be parsed through this rather than a bare
107
+ // JSON.parse: non-JSON noise on stdout (a warning or deprecation line) would
108
+ // otherwise raise an anonymous SyntaxError deep inside a multi-cycle run. This
109
+ // names the offending command and includes a snippet of the raw output.
110
+ //
111
+ // apra-fleet-3swo.6.13: moved verbatim out of runner.js -- it belongs with
112
+ // this module's other bd-output consumers (buildBeadGraph, discoverScope,
113
+ // classifyVerifySet, createBeadsScope's bdListScoped/fetchAllBeadsShared).
114
+ // runner.js re-exports it unchanged so no importer is edited by the move.
115
+ /**
116
+ * @param {string} raw - the raw text returned by `command()`
117
+ * @param {string} commandLabel - the `bd` command that produced `raw`, for diagnostics
118
+ * @returns {any}
119
+ */
120
+ export function parseBdJson(raw, commandLabel) {
121
+ const text = raw === undefined || raw === null || raw === '' ? '[]' : raw;
122
+ try {
123
+ return JSON.parse(text);
124
+ } catch (err) {
125
+ const snippet = text.length > 500 ? `${text.slice(0, 500)}... (truncated, ${text.length} chars total)` : text;
126
+ throw new Error(
127
+ `[bd JSON Parse Error] Failed to parse JSON output from '${commandLabel}': ${err.message}. ` +
128
+ `Raw output snippet: ${JSON.stringify(snippet)}`
129
+ );
130
+ }
131
+ }
132
+
133
+ // ---------------------------------------------------------------------------
134
+ // Goal-priority helpers
135
+ // ---------------------------------------------------------------------------
136
+ //
137
+ // `validated.goal` is a slash-separated priority list (e.g. 'P1', 'P1/P2'),
138
+ // already validated against GOAL_PATTERN above. The sprint's exit condition
139
+ // (distinct from "is there work dispatchable right now", which `--ready`
140
+ // answers) is: are there any NOT-YET-CLOSED beads in scope at or above
141
+ // (numerically <=) the worst priority named in the goal? `bd list
142
+ // --priority-max=Pn` is inclusive of Pn, so the worst (highest numeric)
143
+ // priority in the goal is exactly the right `--priority-max` value.
144
+ //
145
+ // apra-fleet-3swo.6.13: moved verbatim out of runner.js, together with
146
+ // partitionByGoalMembership below, which calls it. runner.js re-exports both
147
+ // unchanged so no importer is edited by the move.
148
+ /**
149
+ * @param {string} goal - e.g. 'P1', 'P1/P2', 'P1/P2/P3'
150
+ * @returns {string} the lowest-priority (highest 'Pn' number) tier named in `goal`, e.g. 'P2'
151
+ */
152
+ export function goalPriorityMax(goal) {
153
+ const tiers = goal.split('/').map((p) => Number(p.slice(1)));
154
+ const worst = Math.max(...tiers);
155
+ return `P${worst}`;
156
+ }
157
+
158
+ // ---------------------------------------------------------------------------
159
+ // Deferred beads are DISPATCH-INELIGIBLE, so they are not "open work"
160
+ // (apra-fleet-rp7a.1)
161
+ // ---------------------------------------------------------------------------
162
+ //
163
+ // 'deferred' is a member of runner.js's NOT_DONE_STATUSES because it is
164
+ // genuinely not CLOSED -- but the Develop loop dispatches from `bd --ready`,
165
+ // which never offers a deferred bead, so nothing in a sprint can ever move one
166
+ // forward. Counting it as still-open at goal priority therefore makes the
167
+ // completion check unsatisfiable AND pins the closed-bead high-water mark,
168
+ // which is how a sprint whose real scope was finished still aborted as
169
+ // SPRINT_STALLED after STALL_CYCLE_LIMIT cycles.
170
+ //
171
+ // This is the ONE status whose meaning changes. 'blocked' and 'in_progress'
172
+ // deliberately KEEP counting as open (they are exactly the states `bd --ready`
173
+ // hides but a human still owes work on -- see NOT_DONE_STATUSES's own comment
174
+ // on why an empty `--ready` list must never be read as "the sprint is done").
175
+ //
176
+ // The deferred ids are RETURNED, not merely dropped, because a bead silently
177
+ // vanishing from the completion math is precisely the failure mode this
178
+ // function exists to fix: every caller is expected to name them in whatever
179
+ // text it emits, so a human can see what was skipped and why the sprint was
180
+ // allowed to finish.
181
+ //
182
+ // Lives here rather than in runner.js so the per-cycle Cycle Evaluation count
183
+ // and the Final Review's closing count cannot drift apart -- two consumers,
184
+ // one rule.
185
+ export const DEFERRED_BEAD_STATUS = 'deferred';
186
+
187
+ /**
188
+ * Split a not-done bead list into the beads that still count as open work and
189
+ * the ids of the deferred ones (dispatch-ineligible, treated as out of scope).
190
+ *
191
+ * Tolerant of a missing/odd `status` on purpose: an entry whose status cannot
192
+ * be read as 'deferred' stays in `active`. Under-matching here leaves today's
193
+ * behavior (the bead keeps counting as open); over-matching would let real
194
+ * work disappear from the completion check.
195
+ *
196
+ * @param {Array<{id?: (string|number), status?: string}>} beads
197
+ * @returns {{ active: object[], deferredIds: string[] }}
198
+ */
199
+ export function partitionDeferredBeads(beads) {
200
+ const list = Array.isArray(beads) ? beads : [];
201
+ const active = [];
202
+ const deferredIds = [];
203
+ for (const bead of list) {
204
+ const status = bead && typeof bead.status === 'string' ? bead.status.trim().toLowerCase() : '';
205
+ if (status === DEFERRED_BEAD_STATUS) deferredIds.push(String(bead.id));
206
+ else active.push(bead);
207
+ }
208
+ return { active, deferredIds };
209
+ }
210
+
211
+ // apra-fleet-eft.52.1.3: server-side goal-membership placement for the
212
+ // fleet-sprint dashboard's Sprint vs Backlog split. The viewer must NOT
213
+ // decide this itself (no CSS display:none hiding in the browser, no
214
+ // priority-only guess): goal membership is graph knowledge -- it needs the
215
+ // full dependency edge set to honor the blocks-edge exception below -- so it
216
+ // is computed here, in the state payload, and every task is returned tagged
217
+ // with a `placement` field ('sprint' | 'backlog') the viewer consumes
218
+ // verbatim.
219
+ //
220
+ // Rules, applied to TOP-LEVEL items only (an item whose `parent` points at no
221
+ // other item in the dataset -- same "only an in-dataset parent nests" rule
222
+ // the viewer's containment tree uses; descendants inherit their root's
223
+ // placement):
224
+ //
225
+ // - A top-level item is a SPRINT item unless it is DEFINITIVELY below the
226
+ // sprint's goal band -- i.e. it has a finite numeric priority strictly
227
+ // greater (numerically) than goalPriorityMax(goal). An item with no /
228
+ // non-numeric priority is NOT demoted (it is in-scope sprint work of
229
+ // unknown rank, not deliberately-deferred backlog).
230
+ // - EXCEPTION (visual continuity): a below-goal top-level item connected to
231
+ // an in-goal top-level item by a 'blocks'-type dependency edge (in either
232
+ // direction) stays a SPRINT item, so it renders alongside the sprint
233
+ // subtree it blocks / is blocked by rather than being split off into the
234
+ // Backlog section.
235
+ //
236
+ // Descendants of a top-level item always inherit that item's placement, so a
237
+ // whole subtree lands in one section.
238
+ /**
239
+ * @param {Array<{id: (string|number), parent?: (string|number), priority?: number, dependencies?: Array<{depends_on_id: (string|number), type: string}>}>} tasks - scoped bead objects
240
+ * @param {string} goal - sprint goal band, e.g. 'P1/P2'
241
+ * @returns {{ sprintTasks: object[], backlogTasks: object[] }} the same tasks, each tagged with a `placement` field, partitioned by section
242
+ */
243
+ export function partitionByGoalMembership(tasks, goal) {
244
+ const list = Array.isArray(tasks) ? tasks : [];
245
+ const byId = new Map();
246
+ list.forEach((t) => {
247
+ if (t && t.id !== undefined && t.id !== null) byId.set(String(t.id), t);
248
+ });
249
+
250
+ const hasInDatasetParent = (t) => {
251
+ const p = t && t.parent;
252
+ return p !== undefined && p !== null && byId.has(String(p));
253
+ };
254
+
255
+ // Walk `parent` up to the top-level in-dataset ancestor (cycle-guarded).
256
+ const rootOf = (t) => {
257
+ let cur = t;
258
+ const seen = new Set();
259
+ while (hasInDatasetParent(cur) && !seen.has(String(cur.id))) {
260
+ seen.add(String(cur.id));
261
+ cur = byId.get(String(cur.parent));
262
+ }
263
+ return cur;
264
+ };
265
+
266
+ const goalMaxNum = Number(goalPriorityMax(goal).slice(1));
267
+ const isBelowGoal = (t) =>
268
+ typeof t.priority === 'number' && Number.isFinite(t.priority) && t.priority > goalMaxNum;
269
+
270
+ const topLevel = list.filter((t) => t && !hasInDatasetParent(t));
271
+ // In-goal top-level items: everything not definitively below the goal band.
272
+ const inGoalTopIds = new Set(
273
+ topLevel.filter((t) => !isBelowGoal(t)).map((t) => String(t.id))
274
+ );
275
+
276
+ // Sprint set starts as the in-goal top-levels, then absorbs below-goal
277
+ // top-levels connected to an in-goal top-level by a 'blocks' edge, in
278
+ // either direction.
279
+ const sprintTopIds = new Set(inGoalTopIds);
280
+ topLevel.forEach((t) => {
281
+ const id = String(t.id);
282
+ if (sprintTopIds.has(id)) return;
283
+ // Outgoing: this below-goal top-level depends_on (is blocked by) an
284
+ // in-goal top-level -> keep it in Sprint.
285
+ const deps = Array.isArray(t.dependencies) ? t.dependencies : [];
286
+ if (deps.some((d) => d && d.type === 'blocks' && inGoalTopIds.has(String(d.depends_on_id)))) {
287
+ sprintTopIds.add(id);
288
+ }
289
+ });
290
+ // Incoming: an in-goal top-level depends_on (is blocked by) a below-goal
291
+ // top-level -> keep that below-goal item in Sprint too.
292
+ topLevel.forEach((t) => {
293
+ if (!inGoalTopIds.has(String(t.id))) return;
294
+ const deps = Array.isArray(t.dependencies) ? t.dependencies : [];
295
+ deps.forEach((d) => {
296
+ if (!d || d.type !== 'blocks') return;
297
+ const other = byId.get(String(d.depends_on_id));
298
+ if (other && !hasInDatasetParent(other)) sprintTopIds.add(String(other.id));
299
+ });
300
+ });
301
+
302
+ const sprintTasks = [];
303
+ const backlogTasks = [];
304
+ list.forEach((t) => {
305
+ if (!t) return;
306
+ const root = rootOf(t);
307
+ const placement = sprintTopIds.has(String(root.id)) ? 'sprint' : 'backlog';
308
+ const tagged = { ...t, placement };
309
+ if (placement === 'backlog') backlogTasks.push(tagged);
310
+ else sprintTasks.push(tagged);
311
+ });
312
+ return { sprintTasks, backlogTasks };
313
+ }
314
+
315
+ // ---------------------------------------------------------------------------
316
+ // Below-goal beads are not DISPATCHED unless they serve in-goal work
317
+ // ---------------------------------------------------------------------------
318
+ //
319
+ // The develop loop used to dispatch every ready leaf in scope, ordering by
320
+ // priority but never excluding: a P3 streak could run in round 1 of a P1/P2
321
+ // sprint, ahead of P1/P2 work. Exclusion uses the same "below goal" test as
322
+ // partitionByGoalMembership (a FINITE numeric priority strictly worse than the
323
+ // goal max -- a bead with no numeric priority is never excluded) and the same
324
+ // blocks-edge idea, made transitive: a below-goal bead stays dispatchable when
325
+ //
326
+ // - it (transitively, over 'blocks' edges) blocks an open in-goal bead --
327
+ // in-goal work cannot finish without it; or
328
+ // - this sprint already dispatched it (e.g. a reviewer reopen the
329
+ // worked-on exemption let through) -- the sprint is repairing its own
330
+ // work.
331
+ //
332
+ // Deliberately NO parent-chain exemption: a sprint's target root is normally
333
+ // an open in-goal epic, so "has an open in-goal ancestor" would keep every
334
+ // below-goal task in scope and make this filter inert.
335
+ //
336
+ // Consistent with the completion gate: that gate counts only beads at or above
337
+ // goal priority (`--priority-max=goalMax`), so an excluded below-goal bead
338
+ // never holds the sprint open.
339
+
340
+ /** A bead's `blocks` prerequisites (ids it depends on), across bd's two dependency shapes. */
341
+ function blocksPrereqIds(bead) {
342
+ const deps = bead && Array.isArray(bead.dependencies) ? bead.dependencies : [];
343
+ const out = [];
344
+ for (const d of deps) {
345
+ if (typeof d === 'string') { if (d) out.push(d); continue; }
346
+ if (!d || typeof d !== 'object') continue;
347
+ const type = d.type ?? d.dependency_type;
348
+ if (type !== undefined && type !== 'blocks') continue;
349
+ const id = d.depends_on_id ?? d.id;
350
+ if (id !== undefined && id !== null && id !== '') out.push(String(id));
351
+ }
352
+ return out;
353
+ }
354
+
355
+ /**
356
+ * Split ready leaf beads into those the develop loop may dispatch and the
357
+ * below-goal ones it must not (see the block comment above).
358
+ *
359
+ * @param {Array<object>} ready - ready leaf beads (bd list --ready shape)
360
+ * @param {Array<object>} scopeBeads - every in-scope bead, any status, with `dependencies` and `parent`
361
+ * @param {string} goal - sprint goal band, e.g. 'P1/P2'
362
+ * @param {{ workedOnIds?: Set<string>|Iterable<string> }} [opts]
363
+ * @returns {{ dispatchable: object[], excluded: Array<{ id: string, priority: number }> }}
364
+ */
365
+ export function partitionReadyByGoal(ready, scopeBeads, goal, opts = {}) {
366
+ const list = Array.isArray(ready) ? ready : [];
367
+ const scope = Array.isArray(scopeBeads) ? scopeBeads : [];
368
+ const goalMaxNum = Number(goalPriorityMax(goal).slice(1));
369
+ const workedOn = opts.workedOnIds instanceof Set ? opts.workedOnIds : new Set(opts.workedOnIds || []);
370
+ const isBelowGoal = (b) =>
371
+ b && typeof b.priority === 'number' && Number.isFinite(b.priority) && b.priority > goalMaxNum;
372
+ const isOpen = (b) => b && b.status !== 'closed';
373
+
374
+ const byId = new Map();
375
+ for (const b of [...scope, ...list]) {
376
+ if (b && b.id !== undefined && b.id !== null && !byId.has(String(b.id))) byId.set(String(b.id), b);
377
+ }
378
+
379
+ // Every bead that (transitively) blocks an open in-goal bead: walk the
380
+ // blocks prerequisites backwards from each open in-goal bead.
381
+ const servesInGoal = new Set();
382
+ const queue = [];
383
+ for (const b of byId.values()) {
384
+ if (isOpen(b) && !isBelowGoal(b)) queue.push(String(b.id));
385
+ }
386
+ const visited = new Set(queue);
387
+ while (queue.length > 0) {
388
+ const id = queue.shift();
389
+ for (const pre of blocksPrereqIds(byId.get(id))) {
390
+ servesInGoal.add(pre);
391
+ if (!visited.has(pre)) { visited.add(pre); queue.push(pre); }
392
+ }
393
+ }
394
+
395
+ const dispatchable = [];
396
+ const excluded = [];
397
+ for (const b of list) {
398
+ if (!b) continue;
399
+ const id = String(b.id);
400
+ if (!isBelowGoal(b) || workedOn.has(id) || servesInGoal.has(id)) {
401
+ dispatchable.push(b);
402
+ } else {
403
+ excluded.push({ id, priority: b.priority });
404
+ }
405
+ }
406
+ return { dispatchable, excluded };
407
+ }
408
+
409
+ /**
410
+ * The run-log line for beads partitionReadyByGoal excluded from dispatch.
411
+ *
412
+ * @param {Array<{ id: string, priority: number }>} excluded
413
+ * @param {string} goal
414
+ * @returns {string}
415
+ */
416
+ export function formatBelowGoalExclusionLog(excluded, goal) {
417
+ const named = excluded.map((e) => e.id + ' (P' + e.priority + ')').join(', ');
418
+ return `Develop dispatch: EXCLUDED ${named} -- below this sprint's goal ${goal}, not blocking any open ` +
419
+ 'in-goal bead, and not yet worked on by this sprint -- excluded as below goal, not dispatched.';
420
+ }
421
+
422
+ /**
423
+ * Build the id->bead and parent->children indexes every scope walk needs.
424
+ *
425
+ * A bead is a child iff its `parent` field is a non-empty id: `undefined`,
426
+ * `null` and `''` all mean "no parent" and must never create a `Map` entry
427
+ * keyed on an empty string (which would then look like a real parent id to
428
+ * the BFS).
429
+ *
430
+ * @param {Array<object>} allBeads - the FULL, unfiltered project bead list
431
+ * @returns {{ byId: Map<string, object>, childrenOf: Map<string, object[]> }}
432
+ */
433
+ export function buildBeadGraph(allBeads) {
434
+ const beads = allBeads || [];
435
+ const byId = new Map();
436
+ const childrenOf = new Map();
437
+ for (const b of beads) {
438
+ if (!b) continue;
439
+ if (b.id !== undefined && b.id !== null) byId.set(b.id, b);
440
+ if (b.parent !== undefined && b.parent !== null && b.parent !== '') {
441
+ if (!childrenOf.has(b.parent)) childrenOf.set(b.parent, []);
442
+ childrenOf.get(b.parent).push(b);
443
+ }
444
+ }
445
+ return { byId, childrenOf };
446
+ }
447
+
448
+ /**
449
+ * THE scope-discovery rule -- the single implementation both former call
450
+ * sites (bdListScoped and classifyVerifySet) now share.
451
+ *
452
+ * Scope cannot be built on `bd list --parent`: that flag accepts exactly one
453
+ * id per invocation (a comma-joined list is treated as one nonexistent id and
454
+ * returns `[]`) and is single-level only -- direct children, never
455
+ * grandchildren -- so a level-3+ descendant would be invisible to the
456
+ * dispatch scope, not just the dashboard tree. Instead this is an IN-MEMORY
457
+ * BFS over the full project bead list: build a parent->children map, then
458
+ * walk outward from every target issue to find every descendant at any depth,
459
+ * regardless of status. That subsumes the multi-target union case without a
460
+ * separate code path.
461
+ *
462
+ * Every target issue's OWN id is seeded into the result UNCONDITIONALLY. The
463
+ * BFS only ever adds descendants, so without the seed a childless leaf
464
+ * target's scope would be empty and every query would short-circuit to `[]`.
465
+ * The seed used to be conditional on the target having no children, on the
466
+ * theory that a target WITH children is a pure grouping node whose own status
467
+ * never matters -- that is false: a target with pre-existing children (a
468
+ * verify-routed parent) can itself transition open->closed, and
469
+ * status-counting queries need to see that transition. Excluding it silently
470
+ * dropped such a parent's own closure from the stall-detection progress
471
+ * score.
472
+ *
473
+ * A childful target is STILL excluded from dispatch (readyLeafBeads()) and
474
+ * from the exit-gate open-at-goal counts, via a separate structural
475
+ * "is this someone's .parent" check that is independent of scope membership
476
+ * -- so seeding here does not let a still-open childful target masquerade as
477
+ * done, nor block dispatch as if it were a leaf.
478
+ *
479
+ * @param {Array<object>} allBeads - the FULL, unfiltered project bead list
480
+ * @param {string[]} targetIssues - the sprint's target issue root id(s)
481
+ * @returns {{ byId: Map<string, object>, childrenOf: Map<string, object[]>, scopeIds: Set<string> }}
482
+ */
483
+ export function discoverScope(allBeads, targetIssues) {
484
+ const { byId, childrenOf } = buildBeadGraph(allBeads);
485
+ const targets = targetIssues || [];
486
+
487
+ const scopeIds = new Set();
488
+ const frontier = [...targets];
489
+ while (frontier.length > 0) {
490
+ const id = frontier.shift();
491
+ for (const child of (childrenOf.get(id) || [])) {
492
+ if (!scopeIds.has(child.id)) {
493
+ scopeIds.add(child.id);
494
+ frontier.push(child.id);
495
+ }
496
+ }
497
+ }
498
+ for (const id of targets) scopeIds.add(id);
499
+
500
+ return { byId, childrenOf, scopeIds };
501
+ }
502
+
503
+ /**
504
+ * Classify beads whose every child is closed as ready for the `verify` route:
505
+ * implementation-complete parents that must be excluded from
506
+ * Plan/Develop/Review and verified against the live deployed product, never
507
+ * administratively closed on child-closure alone -- see
508
+ * docs/fleet-sprint-phase-routing-design.md for the design.
509
+ *
510
+ * Pure: derives the verify set fresh from `allBeads` on every call. There is
511
+ * no persisted list -- callers re-invoke this at each classification point
512
+ * (pre-sprint validation, cycle top, IntegTest dispatch) rather than caching,
513
+ * so a crash-restart re-derives it for free and nothing can drift out of sync
514
+ * with the beads DB.
515
+ *
516
+ * Eligibility (a bead qualifies iff ALL of):
517
+ * 1. in scope: is itself one of `targetIssues`, or is a BFS descendant of
518
+ * one -- via discoverScope() above, the same rule bdListScoped uses.
519
+ * 2. status is 'open' or 'in_progress' (not already closed/deferred).
520
+ * 3. has at least one child. Childless beads are leaves -- they route
521
+ * through the normal Plan/Develop pipeline, never verify. A parent with
522
+ * NO children is never eligible, regardless of anything else.
523
+ * 4. EVERY child (any issue_type) has status 'closed', checked against the
524
+ * FULL unfiltered `allBeads` list, not a scope-filtered subset -- an
525
+ * out-of-scope open child must still block eligibility. Partial closure
526
+ * never qualifies.
527
+ * 5. no unmet 'blocks' dependency: a parent whose blocker is still being
528
+ * implemented in this same run must not be verified against today's
529
+ * incomplete state.
530
+ *
531
+ * @param {Array<object>} allBeads - the FULL, unfiltered project bead list.
532
+ * @param {string[]} targetIssues - the sprint's target issue root id(s).
533
+ * @returns {{ verifyIds: string[], ineligible: Array<{id: string, reason: string}> }}
534
+ */
535
+ export function classifyVerifySet(allBeads, targetIssues) {
536
+ const { byId, childrenOf, scopeIds } = discoverScope(allBeads, targetIssues);
537
+
538
+ const verifyIds = [];
539
+ const ineligible = [];
540
+ for (const id of scopeIds) {
541
+ const bead = byId.get(id);
542
+ if (!bead) continue;
543
+ if (bead.status !== 'open' && bead.status !== 'in_progress') continue;
544
+
545
+ const kids = childrenOf.get(id) || [];
546
+ if (kids.length === 0) continue; // leaf -- normal pipeline, not eligible
547
+
548
+ if (!kids.every((k) => k.status === 'closed')) continue; // partial closure never qualifies
549
+
550
+ const unmetBlockerIds = (bead.dependencies || [])
551
+ .filter((d) => d.type === 'blocks')
552
+ .map((d) => d.depends_on_id)
553
+ .filter((depId) => {
554
+ const dep = byId.get(depId);
555
+ return dep && dep.status !== 'closed';
556
+ });
557
+ if (unmetBlockerIds.length > 0) {
558
+ ineligible.push({ id, reason: `unmet blocker(s): ${unmetBlockerIds.join(', ')}` });
559
+ continue;
560
+ }
561
+
562
+ verifyIds.push(id);
563
+ }
564
+
565
+ return { verifyIds, ineligible };
566
+ }
567
+
568
+ /**
569
+ * The per-sprint beads scope client: the shared full-DB snapshot, the two
570
+ * invalidation choke points that keep it correct (wrapCommand/wrapPhase), and
571
+ * the scoped query helper every caller reads beads through.
572
+ *
573
+ * The wrappers are returned rather than applied by the caller so the
574
+ * invalidation contract documented at the top of this file is implemented
575
+ * HERE, in one place, instead of being re-derived at each call site. runner.js
576
+ * installs both before any other statement in runSprintCycle() uses `command`
577
+ * or `phase`, so every direct call -- and every helper that receives
578
+ * `command` via an options object -- transparently goes through them.
579
+ *
580
+ * `getBacklogMember` is a getter, not a value, because the orchestrator
581
+ * member is resolved from the role->member mapping well after this client is
582
+ * constructed (the snapshot must exist before the `command` wrapper does,
583
+ * and the wrapper must exist before anything can resolve members). No fetch
584
+ * can happen before that point, so the getter is always called on a resolved
585
+ * value.
586
+ *
587
+ * @param {object} opts
588
+ * @param {string[]} opts.targetIssues - the sprint's target issue root id(s)
589
+ * @param {string|null} [opts.assignee] - `--assignee` narrowing for filtered queries
590
+ * @param {(raw: string, label: string) => any} opts.parseBdJson - bd JSON parser (injected to avoid an import cycle back into runner.js)
591
+ * @param {() => string} opts.getBacklogMember - resolves the member every read is dispatched to
592
+ */
593
+ export function createBeadsScope(opts = {}) {
594
+ const targetIssues = opts.targetIssues || [];
595
+ const assignee = opts.assignee || null;
596
+ const parseBdJson = opts.parseBdJson;
597
+ const getBacklogMember = opts.getBacklogMember;
598
+ if (typeof parseBdJson !== 'function') {
599
+ throw new TypeError('createBeadsScope({ parseBdJson }): parseBdJson must be a function');
600
+ }
601
+ if (typeof getBacklogMember !== 'function') {
602
+ throw new TypeError('createBeadsScope({ getBacklogMember }): getBacklogMember must be a function');
603
+ }
604
+
605
+ let allBeadsSnapshot = null; // { beads } -- cleared by invalidateAllBeadsCache()
606
+ let allBeadsInFlight = null;
607
+ let command = null; // installed by wrapCommand(); see fetchAllBeadsShared
608
+
609
+ /** Drop the shared snapshot. Cheap and idempotent. */
610
+ function invalidateAllBeadsCache() { allBeadsSnapshot = null; }
611
+
612
+ /** Whether a snapshot is currently cached -- diagnostics/tests only. */
613
+ function hasCachedSnapshot() { return allBeadsSnapshot !== null; }
614
+
615
+ /**
616
+ * Wrap the raw `command()` seam so clause (b) of the invalidation
617
+ * contract holds for every orchestrator-side command, and remember the
618
+ * wrapped function as the one this module issues its own reads through
619
+ * (so a scope read can never sneak past its own invalidation seam).
620
+ *
621
+ * `onCommand(trimmedCmd, opts)` is an optional post-command hook for
622
+ * concerns that are NOT beads-snapshot related but need the same single
623
+ * choke point (runner.js uses it for DoltSync's per-member sync.remote
624
+ * memo invalidation). It runs after the invalidation decision, matching
625
+ * the pre-extraction ordering.
626
+ */
627
+ function wrapCommand(rawCommand, wrapOpts = {}) {
628
+ if (typeof rawCommand !== 'function') {
629
+ throw new TypeError('beadsScope.wrapCommand(rawCommand): rawCommand must be a function');
630
+ }
631
+ const onCommand = typeof wrapOpts.onCommand === 'function' ? wrapOpts.onCommand : null;
632
+ const wrapped = async (cmdStr, cmdOpts) => {
633
+ const result = await rawCommand(cmdStr, cmdOpts);
634
+ if (typeof cmdStr === 'string') {
635
+ const trimmed = cmdStr.trim();
636
+ if (isBeadsMutatingCommand(trimmed)) {
637
+ invalidateAllBeadsCache();
638
+ }
639
+ if (onCommand) onCommand(trimmed, cmdOpts);
640
+ }
641
+ return result;
642
+ };
643
+ command = wrapped;
644
+ return wrapped;
645
+ }
646
+
647
+ /**
648
+ * Wrap the raw `phase()` seam so clause (a) of the invalidation contract
649
+ * holds: a new step never inherits the previous step's snapshot.
650
+ */
651
+ function wrapPhase(rawPhase) {
652
+ if (typeof rawPhase !== 'function') {
653
+ throw new TypeError('beadsScope.wrapPhase(rawPhase): rawPhase must be a function');
654
+ }
655
+ return (title) => {
656
+ invalidateAllBeadsCache();
657
+ return rawPhase(title);
658
+ };
659
+ }
660
+
661
+ /**
662
+ * The one full-DB fetch. Serves from the snapshot whenever one is still
663
+ * valid -- the snapshot survives across separate, non-overlapping calls
664
+ * (see the invalidation contract at the top of this file for what drops
665
+ * it) -- and otherwise coalesces concurrent callers onto a single
666
+ * in-flight request.
667
+ *
668
+ * Coalescing matters beyond saving a round trip: the command text is
669
+ * identical for every caller, and the bd-replay test shim matches
670
+ * recorded responses FIFO per exact command string, so N indistinguishable
671
+ * concurrent commands have no reliable replay order.
672
+ *
673
+ * `--all` because `bd list` excludes closed issues by default, which would
674
+ * drop a closed node's parent link and orphan its whole subtree from
675
+ * discovery; `--limit 0` because the default row cap could silently
676
+ * truncate a larger scope.
677
+ */
678
+ async function fetchAllBeadsShared() {
679
+ if (allBeadsSnapshot) return allBeadsSnapshot.beads;
680
+ if (!command) {
681
+ throw new Error('beadsScope.fetchAllBeadsShared(): wrapCommand() must be installed before any beads read');
682
+ }
683
+ if (!allBeadsInFlight) {
684
+ const allLabel = 'bd list --all --limit 0 --json';
685
+ allBeadsInFlight = command(allLabel, { member_name: getBacklogMember(), silent: true })
686
+ .then((raw) => parseBdJson(raw, allLabel))
687
+ .then((beads) => {
688
+ allBeadsSnapshot = { beads };
689
+ return beads;
690
+ })
691
+ .finally(() => { allBeadsInFlight = null; });
692
+ }
693
+ return allBeadsInFlight;
694
+ }
695
+
696
+ /**
697
+ * Scope-filtered `bd list`. With no extra args this is the pure in-memory
698
+ * path (the already-fetched project-wide any-status dump filtered to
699
+ * scope, no new command issued).
700
+ *
701
+ * With extra args it ALWAYS issues a real, fresh `bd list` -- the caller's
702
+ * filter flags (--ready/--status/--type/--priority-max/etc) express
703
+ * bd-side computed properties, readiness in particular, that a plain
704
+ * in-memory filter over the snapshot cannot reliably replicate. That
705
+ * freshness is also exactly why the three deliberate cache-bypass sites
706
+ * documented at the top of this file call this with a filter instead of
707
+ * reading fetchAllBeadsShared(). When an assignee is configured,
708
+ * `--assignee` narrows that query to this sprint's claimed beads so two
709
+ * sprints never select the same one.
710
+ *
711
+ * Note the asymmetry, which is deliberate: the SCOPE always comes from
712
+ * the (possibly cached) snapshot, while the FILTER result is always
713
+ * fresh. Scope membership is structural and changes only when beads are
714
+ * created/reparented; status is what moves under the sprint's feet.
715
+ */
716
+ async function bdListScoped(restArgs) {
717
+ const rest = restArgs ? restArgs.trim() : '';
718
+
719
+ const allBeads = await fetchAllBeadsShared();
720
+ const { scopeIds } = discoverScope(allBeads, targetIssues);
721
+
722
+ if (scopeIds.size === 0) return [];
723
+
724
+ if (!rest) {
725
+ return allBeads.filter((b) => b && scopeIds.has(b.id));
726
+ }
727
+
728
+ let filterArgs = rest;
729
+ if (assignee) {
730
+ filterArgs = `${rest} --assignee ${assignee}`;
731
+ }
732
+ const filterLabel = `bd list ${filterArgs} --limit 0`;
733
+ const filterRaw = await command(filterLabel, { member_name: getBacklogMember(), silent: true });
734
+ return parseBdJson(filterRaw, filterLabel).filter((b) => b && scopeIds.has(b.id));
735
+ }
736
+
737
+ return {
738
+ invalidateAllBeadsCache,
739
+ hasCachedSnapshot,
740
+ wrapCommand,
741
+ wrapPhase,
742
+ fetchAllBeadsShared,
743
+ bdListScoped,
744
+ };
745
+ }