@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -0,0 +1,982 @@
1
+ // =============================================================================
2
+ // fleet-sprint supervisor -- Backlog-last tree with partial-claim annotations
3
+ // (apra-fleet-eft.6.2, Plan Part 2.3)
4
+ // =============================================================================
5
+ //
6
+ // The index page (GET /, dashboard.mjs) renders one section per running sprint
7
+ // FIRST, then -- ALWAYS LAST -- the Backlog. The Backlog is the full issue
8
+ // tracker MINUS the union of every active sprint's LIVE-expanded issue scope,
9
+ // rendered as a TREE (parent-child hierarchy), not a flat list, with per-node
10
+ // claim status.
11
+ //
12
+ // WHY "minus the live-expanded union", not "minus a launch-time snapshot": a
13
+ // sprint's subtree grows mid-run (planners/reviewers add tasks under an
14
+ // already-claimed root). So the claimed set is recomputed AT RENDER TIME by
15
+ // re-expanding each active sprint's roots -- the exact same live-subtree
16
+ // question eft.5.3's expandScope() (./scope-overlap.mjs) answers for the
17
+ // launch-time overlap guard, but computed here IN-MEMORY (apra-fleet-c4s) via
18
+ // expandScopeInMemory(), walking a child-index built off the single bulk
19
+ // `bd list --json --limit 0` fetch this module already does per render,
20
+ // instead of one `bd list --parent <id>` subprocess call per discovered node.
21
+ // A bead created after launch, under a claimed root, is claimed the instant
22
+ // it exists and never leaks into the Backlog.
23
+ //
24
+ // NO DUPLICATION across the page (acceptance criterion): a claimed bead appears
25
+ // ONLY under its owning sprint's section, NEVER in the Backlog, and NEVER
26
+ // twice. Because a claimed scope is a full subtree, claiming a node claims all
27
+ // its descendants -- so a claimed node is dropped from the Backlog wholesale.
28
+ //
29
+ // PARTIAL-CLAIM PARENTS (the subtle case): a sprint can be rooted at SOME of an
30
+ // epic's children (not the epic itself). Then the epic is still FREE (unclaimed)
31
+ // but a strict subset of its children are claimed. The epic stays visible in the
32
+ // Backlog, showing ONLY its free children, and carries a partial-claim
33
+ // annotation naming the owning sprint(s) and the claimed/free counts -- e.g.
34
+ // "2 of 5 children claimed by sprint-abc123; 3 free" -- steering the operator to
35
+ // multi-select exactly the free children. This is UI STEERING ONLY: the server's
36
+ // exact-overlap launch policy (createScopeGuard in ./scope-overlap.mjs) is
37
+ // unchanged and still rejects any overlapping multi-select. The annotation just
38
+ // helps the operator pick a non-overlapping set in the first place.
39
+ // =============================================================================
40
+
41
+ import { escapeHtml } from '@apralabs/apra-fleet-workflow/viewer/html-utils';
42
+ import { WATCHDOG_STATUS } from './watchdog.mjs';
43
+ import { renderBeadsHtml } from '../../fleet-sprint/viewer-extensions.mjs';
44
+ import { sendJson } from './server.mjs';
45
+ import { execBdAsync } from './lib/exec-bd.mjs';
46
+
47
+ /**
48
+ * Extract a bead's parent id from a raw `bd list --json` row. The parent-child
49
+ * grouping edge is a dependency whose `type` is `parent-child` and whose
50
+ * `issue_id` is the bead itself; `depends_on_id` is the PARENT (grouping edges
51
+ * point child -> parent). Returns null when the bead is a tracker root.
52
+ * @param {object} raw
53
+ * @returns {string|null}
54
+ */
55
+ export function parentIdOf(raw) {
56
+ if (!raw || typeof raw !== 'object') return null;
57
+ if (typeof raw.parentId === 'string' && raw.parentId.length > 0) return raw.parentId;
58
+ if (typeof raw.parent === 'string' && raw.parent.length > 0) return raw.parent;
59
+ const deps = Array.isArray(raw.dependencies) ? raw.dependencies : [];
60
+ for (const d of deps) {
61
+ if (d && d.type === 'parent-child' && d.issue_id === raw.id && typeof d.depends_on_id === 'string') {
62
+ return d.depends_on_id;
63
+ }
64
+ }
65
+ return null;
66
+ }
67
+
68
+ /**
69
+ * Normalize a raw `bd list --json` row (or an already-normalized object) into
70
+ * the minimal shape the tree builder/renderer needs.
71
+ *
72
+ * `priority` is preserved (not dropped) because downstream consumers filter
73
+ * on it: apra-fleet-x8r.4's computeSprintProgress() gates a bead's inclusion
74
+ * in the sprint-required set on `typeof b.priority === 'number'`, and the
75
+ * supervisor dashboard's default listAllBeads source (bdListAllBeads() below)
76
+ * is this function applied to every raw row. Dropping `priority` here made
77
+ * that goalMax filtering silently inert in production while still appearing
78
+ * to work in tests that hand-built already-normalized-shaped fixtures instead
79
+ * of routing raw rows through this function (apra-fleet-x8r.7). Preserved as
80
+ * `null` (never a numeric default like 0) when absent/non-numeric, so
81
+ * "no priority filtering for this bead" stays unambiguous downstream.
82
+ * @param {object} raw
83
+ * @returns {{ id: string, title: string, issueType: string, status: string, parentId: string|null, priority: number|null }}
84
+ */
85
+ export function normalizeBead(raw) {
86
+ const b = raw || {};
87
+ const rawPriority = b.priority;
88
+ const normalized = {
89
+ id: typeof b.id === 'string' ? b.id : '',
90
+ title: typeof b.title === 'string' ? b.title : '',
91
+ issueType: b.issueType ?? b.issue_type ?? 'task',
92
+ status: b.status ?? 'open',
93
+ parentId: parentIdOf(b),
94
+ priority: typeof rawPriority === 'number' && Number.isFinite(rawPriority) ? rawPriority : null,
95
+ };
96
+ // A server-computed `placement` ('sprint' | 'backlog', runner.js's
97
+ // partitionByGoalMembership) is passed through when present: sprint-
98
+ // progress.mjs's computeSprintProgress() branches on it BEFORE the numeric
99
+ // priority filter, so dropping it here would silently change a
100
+ // placement-carrying row's membership. Raw `bd list` rows never carry it.
101
+ if (typeof b.placement === 'string') normalized.placement = b.placement;
102
+ return normalized;
103
+ }
104
+
105
+ /**
106
+ * Default full-tracker source: `bd list --json --limit 0`, normalized. One call
107
+ * returns every bead with its dependency edges (from which parentIdOf() derives
108
+ * the grouping hierarchy), so no per-node querying is needed to reconstruct the
109
+ * tree here.
110
+ * @returns {Promise<Array<ReturnType<typeof normalizeBead>>>}
111
+ */
112
+ async function fetchAllBeadsRaw() {
113
+ // Routed through the shared execBdAsync() helper (apra-fleet-xuo.2) --
114
+ // on Windows it resolves the `bd.cmd` shim directly (no `shell: true`),
115
+ // avoiding both the ENOENT spawn issue a bare `execFileAsync('bd', ...)`
116
+ // would hit AND the metacharacter-injection risk `shell: true` carries.
117
+ // Every argument here is a static literal anyway (none caller-controlled),
118
+ // but the shared helper keeps this call consistent with scope-overlap.mjs's.
119
+ const { stdout } = await execBdAsync(['list', '--json', '--limit', '0']);
120
+ const text = stdout && stdout.trim() ? stdout : '[]';
121
+ let rows;
122
+ try {
123
+ rows = JSON.parse(text);
124
+ } catch (err) {
125
+ throw new Error(`[backlog] failed to parse 'bd list --json': ${err.message}`);
126
+ }
127
+ if (!Array.isArray(rows)) return [];
128
+ return rows.filter((b) => b && typeof b.id === 'string' && b.id.length > 0);
129
+ }
130
+
131
+ /**
132
+ * Raw `bd list --json --limit 0` rows, UNNORMALIZED -- every field `bd` emits
133
+ * (dependencies, priority, issue_type, metadata, description, parent, ...) is
134
+ * preserved. `bdListAllBeads()` below builds its minimal tree-node shape from
135
+ * this; `createBacklog().buildBacklogTasks()` uses the SAME call (one `bd`
136
+ * invocation per page render, not two) because it needs the fuller shape to
137
+ * feed fleet-sprint's `renderBeadsHtml()` (type/status/priority/model badges,
138
+ * `blocks`-edge nesting, full descriptions) unchanged.
139
+ * @returns {Promise<Array<object>>}
140
+ */
141
+ export async function bdListAllBeadsRaw() {
142
+ return fetchAllBeadsRaw();
143
+ }
144
+
145
+ export async function bdListAllBeads() {
146
+ const rows = await fetchAllBeadsRaw();
147
+ return rows.map(normalizeBead).filter((b) => b.id.length > 0);
148
+ }
149
+
150
+ /**
151
+ * Build a parent-id -> direct-child-ids index off an already-fetched, already-
152
+ * normalized beads list. This is the SAME technique `buildBacklogTree()`
153
+ * (below, `allChildrenOf`) and `computePartialClaimByBead()` already use to
154
+ * derive containment structure from one bulk `bd list` fetch, factored out
155
+ * here so `expandScopeInMemory()` can share it.
156
+ * @param {Array<{ id: string, parentId: string|null }>} beads - normalizeBead() shape
157
+ * @returns {Map<string, string[]>}
158
+ */
159
+ export function buildChildIndex(beads) {
160
+ const idx = new Map();
161
+ for (const b of Array.isArray(beads) ? beads : []) {
162
+ const pid = b && b.parentId;
163
+ if (!pid) continue;
164
+ if (!idx.has(pid)) idx.set(pid, []);
165
+ idx.get(pid).push(b.id);
166
+ }
167
+ return idx;
168
+ }
169
+
170
+ /**
171
+ * In-memory equivalent of `expandScope()` (./scope-overlap.mjs): expands a set
172
+ * of root issue ids into the full parent-child subtree they span (roots
173
+ * INCLUDED), via the identical breadth-first-walk logic -- but walking a
174
+ * `buildChildIndex()` Map built off an already-fetched flat beads list
175
+ * instead of issuing one `bd list --parent <id>` subprocess call per
176
+ * discovered node. Same roots + same beads list -> IDENTICAL result to the
177
+ * subprocess-based `expandScope()` (apra-fleet-c4s).
178
+ * @param {Iterable<string>} roots
179
+ * @param {Map<string, string[]>} childIndex - from buildChildIndex()
180
+ * @returns {Set<string>} every bead id in the subtree, roots included
181
+ */
182
+ export function expandScopeInMemory(roots, childIndex) {
183
+ const idx = childIndex instanceof Map ? childIndex : new Map();
184
+ const scope = new Set();
185
+ const frontier = [];
186
+ for (const r of roots ?? []) {
187
+ if (typeof r === 'string' && r.length > 0 && !scope.has(r)) {
188
+ scope.add(r);
189
+ frontier.push(r);
190
+ }
191
+ }
192
+ while (frontier.length > 0) {
193
+ const id = frontier.shift();
194
+ const children = idx.get(id) ?? [];
195
+ for (const child of children) {
196
+ if (typeof child === 'string' && child.length > 0 && !scope.has(child)) {
197
+ scope.add(child);
198
+ frontier.push(child);
199
+ }
200
+ }
201
+ }
202
+ return scope;
203
+ }
204
+
205
+ /** Normalize a claimedBy value (single owner string) into an array of sprint ids. */
206
+ function ownersOf(value) {
207
+ if (Array.isArray(value)) return value.filter((v) => typeof v === 'string' && v.length > 0);
208
+ if (typeof value === 'string' && value.length > 0) return [value];
209
+ return [];
210
+ }
211
+
212
+ /**
213
+ * Build the Backlog forest: the full tracker with every CLAIMED subtree pruned,
214
+ * preserving parent-child hierarchy. A partial-claim parent (free itself, but
215
+ * with a strict subset of claimed children) stays in the forest with only its
216
+ * free children and a `partialClaim` annotation.
217
+ *
218
+ * @param {Array<{ id: string, title: string, issueType: string, status: string, parentId: string|null }>} beads
219
+ * @param {Map<string, string|string[]>} claimedBy - claimed bead id -> owning sprint id(s)
220
+ * @returns {Array<BacklogNode>} root nodes of the free forest
221
+ */
222
+ export function buildBacklogTree(beads, claimedBy) {
223
+ const list = Array.isArray(beads) ? beads : [];
224
+ const claims = claimedBy instanceof Map ? claimedBy : new Map();
225
+ const byId = new Map(list.map((b) => [b.id, b]));
226
+ const isClaimed = (id) => claims.has(id);
227
+
228
+ // Full-tracker child index (INCLUDING claimed children) -- buildNode()
229
+ // below needs the complete direct-child set to split into free/claimed,
230
+ // not just the free ones.
231
+ const allChildrenOf = new Map();
232
+ for (const b of list) {
233
+ const pid = b.parentId;
234
+ if (pid && byId.has(pid)) {
235
+ if (!allChildrenOf.has(pid)) allChildrenOf.set(pid, []);
236
+ allChildrenOf.get(pid).push(b);
237
+ }
238
+ }
239
+
240
+ // The partial-claim annotation itself (counts + owning sprints) is the
241
+ // SAME computation the flat beads-tree view needs (buildBacklogTasks()
242
+ // below) -- computePartialClaimByBead() is the one place that logic
243
+ // lives; this function only adds tree STRUCTURE (nesting, pruning
244
+ // claimed subtrees) on top of it.
245
+ const partialClaimById = computePartialClaimByBead(list, claims);
246
+
247
+ function buildNode(bead) {
248
+ const kids = allChildrenOf.get(bead.id) ?? [];
249
+ const freeKids = kids.filter((c) => !isClaimed(c.id));
250
+ return {
251
+ id: bead.id,
252
+ title: bead.title,
253
+ issueType: bead.issueType,
254
+ status: bead.status,
255
+ partialClaim: partialClaimById.get(bead.id) ?? null,
256
+ children: freeKids.map(buildNode),
257
+ };
258
+ }
259
+
260
+ // A free bead roots the Backlog forest when it has no parent, or its parent
261
+ // is claimed / absent from the tracker (defensive re-rooting: in a valid
262
+ // full-subtree claim a free node's parent is always free too, but never
263
+ // silently drop a free node whose ancestor chain is broken).
264
+ const roots = list.filter((b) => {
265
+ if (isClaimed(b.id)) return false;
266
+ const pid = b.parentId;
267
+ return !(pid && byId.has(pid) && !isClaimed(pid));
268
+ });
269
+ return roots.map(buildNode);
270
+ }
271
+
272
+ /**
273
+ * Per-bead partial-claim lookup: `Map<freeBeadId, PartialClaim|null>`, keyed
274
+ * off each free bead's OWN direct children. Shared by `buildBacklogTree()`
275
+ * above (which attaches each entry to its tree node) and
276
+ * `createBacklog().buildBacklogTasks()` below (which has no containment tree
277
+ * to hang the annotation off -- its beads-tree view nests by `blocks` edges,
278
+ * not `parent` containment -- so it reads this map directly and renders the
279
+ * annotation inline on the flat row instead).
280
+ * @param {Array<{ id: string, parentId: string|null }>} beads - normalizeBead() shape
281
+ * @param {Map<string, string|string[]>} claimedBy
282
+ * @returns {Map<string, { totalCount: number, claimedCount: number, freeCount: number, sprints: Array<{ sprintId: string, count: number }> }|null>}
283
+ */
284
+ export function computePartialClaimByBead(beads, claimedBy) {
285
+ const list = Array.isArray(beads) ? beads : [];
286
+ const claims = claimedBy instanceof Map ? claimedBy : new Map();
287
+ const byId = new Map(list.map((b) => [b.id, b]));
288
+ const isClaimed = (id) => claims.has(id);
289
+
290
+ const allChildrenOf = new Map();
291
+ for (const b of list) {
292
+ const pid = b.parentId;
293
+ if (pid && byId.has(pid)) {
294
+ if (!allChildrenOf.has(pid)) allChildrenOf.set(pid, []);
295
+ allChildrenOf.get(pid).push(b);
296
+ }
297
+ }
298
+
299
+ const result = new Map();
300
+ for (const b of list) {
301
+ if (isClaimed(b.id)) continue;
302
+ const kids = allChildrenOf.get(b.id) ?? [];
303
+ const claimedKids = kids.filter((c) => isClaimed(c.id));
304
+ if (claimedKids.length === 0) {
305
+ result.set(b.id, null);
306
+ continue;
307
+ }
308
+ const sprintCounts = new Map();
309
+ for (const c of claimedKids) {
310
+ for (const owner of ownersOf(claims.get(c.id))) {
311
+ sprintCounts.set(owner, (sprintCounts.get(owner) ?? 0) + 1);
312
+ }
313
+ }
314
+ result.set(b.id, {
315
+ totalCount: kids.length,
316
+ claimedCount: claimedKids.length,
317
+ freeCount: kids.length - claimedKids.length,
318
+ sprints: [...sprintCounts.entries()].map(([sprintId, count]) => ({ sprintId, count })),
319
+ });
320
+ }
321
+ return result;
322
+ }
323
+
324
+ /**
325
+ * Human-readable partial-claim annotation, e.g.
326
+ * "2 of 5 children claimed by sprint-abc123; 3 free".
327
+ * @param {{ totalCount: number, claimedCount: number, freeCount: number, sprints: Array<{ sprintId: string, count: number }> }} pc
328
+ * @returns {string}
329
+ */
330
+ export function formatPartialClaim(pc) {
331
+ const sprintLabel = pc.sprints.length === 0
332
+ ? 'an active sprint'
333
+ : pc.sprints.map((s) => (pc.sprints.length > 1 ? `${s.sprintId} (${s.count})` : s.sprintId)).join(', ');
334
+ return `${pc.claimedCount} of ${pc.totalCount} children claimed by ${sprintLabel}; ${pc.freeCount} free`;
335
+ }
336
+
337
+ /** Renders one Backlog tree node (and its free descendants) as a nested <li>. */
338
+ function renderBacklogNode(node) {
339
+ const id = escapeHtml(node.id);
340
+ const title = escapeHtml(node.title || '(untitled)');
341
+ const type = escapeHtml(node.issueType || 'task');
342
+ const status = escapeHtml(node.status || 'open');
343
+ const annotation = node.partialClaim
344
+ ? ' <span data-partial-claim="true" style="color:#f59e0b; font-size: 12px; font-style: italic;">(' +
345
+ escapeHtml(formatPartialClaim(node.partialClaim)) + ')</span>'
346
+ : '';
347
+ const childrenHtml = node.children && node.children.length > 0
348
+ ? '<ul style="list-style: none; margin: 2px 0 2px 16px; padding: 0;">' +
349
+ node.children.map(renderBacklogNode).join('') + '</ul>'
350
+ : '';
351
+ return (
352
+ '<li data-bead-id="' + id + '" style="margin: 2px 0;">' +
353
+ '<span style="font-family: monospace; color:#a1a1aa;">' + id + '</span> ' +
354
+ '<span>' + title + '</span> ' +
355
+ '<span style="color:#71717a; font-size: 11px;">[' + type + ' - ' + status + ']</span>' +
356
+ annotation +
357
+ childrenHtml +
358
+ '</li>'
359
+ );
360
+ }
361
+
362
+ /**
363
+ * Render the full Backlog tree. An empty forest renders an explicit empty-state
364
+ * message (never a blank/throw). The hierarchy is nested <ul>/<li>, never a flat
365
+ * list (acceptance criterion).
366
+ * @param {BacklogNode[]} [tree]
367
+ * @returns {string}
368
+ */
369
+ export function renderBacklogTreeHtml(tree) {
370
+ const roots = Array.isArray(tree) ? tree : [];
371
+ if (roots.length === 0) {
372
+ return '<p style="color:#71717a; font-style: italic;">No unclaimed work in the backlog.</p>';
373
+ }
374
+ return '<ul style="list-style: none; margin: 0; padding: 0;">' +
375
+ roots.map(renderBacklogNode).join('') + '</ul>';
376
+ }
377
+
378
+ /**
379
+ * @typedef {object} BacklogNode
380
+ * @property {string} id
381
+ * @property {string} title
382
+ * @property {string} issueType
383
+ * @property {string} status
384
+ * @property {{ totalCount: number, claimedCount: number, freeCount: number, sprints: Array<{ sprintId: string, count: number }> }|null} partialClaim
385
+ * @property {BacklogNode[]} children
386
+ */
387
+
388
+ /**
389
+ * apra-fleet-7xk-style server-side narrowing: filters a flat raw-bead-row
390
+ * array (the same shape `bdListAllBeadsRaw()` returns, plus this module's
391
+ * `partialClaim` field) down to the rows matching every supplied criterion,
392
+ * AND reports which distinct values are actually present (so a caller can
393
+ * populate Type/Status/Priority/Model filter controls from real data, not a
394
+ * guessed enum). Pure/synchronous -- narrows the SET before it is ever handed
395
+ * to a renderer, not a client-side hide/show pass over an already-fetched
396
+ * full set (that distinction is the acceptance criterion this mirrors).
397
+ * After the type/status/priority/model/q narrowing, `filters.sort` (only
398
+ * `'created_at'` is supported today) orders the resulting rows by each row's
399
+ * `created_at` timestamp; `filters.dir` picks `'asc'` or `'desc'` (default
400
+ * `'desc'`). `created_at` is parsed defensively -- rows come straight from
401
+ * `bd list --json`, where it is an ISO string like `'2026-08-21T04:36:29Z'` --
402
+ * so a missing/unparseable value NEVER throws and always sorts last,
403
+ * regardless of direction. The sort is stable relative to incoming order for
404
+ * equal (or equally-invalid) timestamps. Omitting `filters.sort` leaves row
405
+ * order exactly as `bd`/the type/status/priority/model/q narrowing produced
406
+ * it -- no reordering is imposed.
407
+ * @param {Array<object>} rows
408
+ * @param {{ type?: string, status?: string, priority?: string|number, model?: string, q?: string, sort?: string, dir?: string }} [filters]
409
+ * @returns {{ tasks: object[], total: number, filterOptions: { type: string[], status: string[], priority: number[], model: string[] } }}
410
+ */
411
+ export function applyBeadFilters(rows, filters) {
412
+ const list = Array.isArray(rows) ? rows : [];
413
+ const typeOf = (r) => (r.issue_type ?? r.issueType ?? '').toString();
414
+ const modelOf = (r) => (r.metadata && r.metadata.model) || '';
415
+
416
+ const filterOptions = {
417
+ type: [...new Set(list.map(typeOf).filter((v) => v.length > 0))].sort(),
418
+ status: [...new Set(list.map((r) => (r.status ?? '').toString()).filter((v) => v.length > 0))].sort(),
419
+ priority: [...new Set(list.map((r) => r.priority).filter((p) => typeof p === 'number' && Number.isFinite(p)))].sort((a, b) => a - b),
420
+ model: [...new Set(list.map(modelOf).filter((v) => v.length > 0))].sort(),
421
+ };
422
+
423
+ const f = filters || {};
424
+ const norm = (v) => (typeof v === 'string' && v.length > 0 ? v.trim().toLowerCase() : undefined);
425
+ const type = norm(f.type);
426
+ const status = norm(f.status);
427
+ const model = norm(f.model);
428
+ const q = norm(f.q);
429
+ const priority = f.priority !== undefined && f.priority !== null && f.priority !== ''
430
+ ? Number(f.priority)
431
+ : undefined;
432
+ const hasPriorityFilter = priority !== undefined && Number.isFinite(priority);
433
+
434
+ const tasks = list.filter((r) => {
435
+ if (type && typeOf(r).toLowerCase() !== type) return false;
436
+ if (status && (r.status ?? '').toString().toLowerCase() !== status) return false;
437
+ if (hasPriorityFilter && r.priority !== priority) return false;
438
+ if (model && modelOf(r).toLowerCase() !== model) return false;
439
+ if (q) {
440
+ const haystack = (String(r.id) + ' ' + String(r.title ?? '')).toLowerCase();
441
+ if (!haystack.includes(q)) return false;
442
+ }
443
+ return true;
444
+ });
445
+
446
+ const sortField = norm(f.sort);
447
+ if (sortField === 'created_at') {
448
+ const dir = norm(f.dir) === 'asc' ? 'asc' : 'desc';
449
+ return { tasks: sortByCreatedAt(tasks, dir), total: list.length, filterOptions };
450
+ }
451
+
452
+ return { tasks, total: list.length, filterOptions };
453
+ }
454
+
455
+ /**
456
+ * Parse a `bd list --json` row's `created_at` into epoch millis, or `null`
457
+ * when the field is missing/unparseable. Never throws.
458
+ * @param {object} r
459
+ * @returns {number|null}
460
+ */
461
+ function parseCreatedAt(r) {
462
+ const raw = r && r.created_at;
463
+ if (typeof raw !== 'string' || raw.length === 0) return null;
464
+ const ms = Date.parse(raw);
465
+ return Number.isFinite(ms) ? ms : null;
466
+ }
467
+
468
+ /**
469
+ * Stable sort of `tasks` by `created_at`, direction `'asc'|'desc'`. Rows with
470
+ * a missing/unparseable `created_at` always sort last regardless of
471
+ * direction, and this never throws on malformed input. Stable relative to
472
+ * incoming order for equal (or equally-invalid) timestamps -- achieved via a
473
+ * decorate-sort-undecorate over the original index, since `Array#sort` is not
474
+ * guaranteed stable across every engine this code may run on.
475
+ * @param {object[]} tasks
476
+ * @param {'asc'|'desc'} dir
477
+ * @returns {object[]}
478
+ */
479
+ function sortByCreatedAt(tasks, dir) {
480
+ const decorated = tasks.map((r, i) => ({ r, i, ms: parseCreatedAt(r) }));
481
+ decorated.sort((a, b) => {
482
+ if (a.ms === null && b.ms === null) return a.i - b.i;
483
+ if (a.ms === null) return 1;
484
+ if (b.ms === null) return -1;
485
+ if (a.ms === b.ms) return a.i - b.i;
486
+ const cmp = a.ms - b.ms;
487
+ return dir === 'asc' ? cmp : -cmp;
488
+ });
489
+ return decorated.map((d) => d.r);
490
+ }
491
+
492
+ /**
493
+ * Injects an interactive select/search control into each of the 6 static
494
+ * `<th>` cells `renderBeadsHtml()` emits (ID/Title/Type/Status/Pri/Model), so
495
+ * the Backlog tab's filter controls live IN the column headers themselves
496
+ * instead of a separate filter bar above the table -- ID's header carries the
497
+ * free-text search (matches id OR title, same as `applyBeadFilters()`'s `q`),
498
+ * Title stays a plain label (search already covers title text), and Type/
499
+ * Status/Pri/Model become `<select>`s seeded from `filterOptions`'s REAL
500
+ * observed values. `currentFilters` re-selects/re-fills each control so a
501
+ * table re-render (collapse toggle, a fresh filtered fetch) never resets what
502
+ * the operator had chosen -- this function is called fresh on every
503
+ * `renderTable()` pass client-side, not just once at page load.
504
+ *
505
+ * A 7th header cell (apra-fleet-qoxd.2) carries the Created-at sort control:
506
+ * a single `<select data-sort-field="created_at">` offering a neutral
507
+ * 'Unsorted' option plus 'Created (newest)' (value `desc`) / 'Created
508
+ * (oldest)' (value `asc`), pre-selected from `currentFilters.sort`/
509
+ * `currentFilters.dir` so a client re-render preserves the chosen sort --
510
+ * same pattern the Type/Status/Pri/Model `<select>`s already follow. It is a
511
+ * distinct `data-sort-field` attribute (not `data-filter-field`) because this
512
+ * one control drives TWO `currentFilters` keys (`sort` and `dir`) at once;
513
+ * wiring lives in `backlogPanelClientScript()`'s `wireHeaderControls()`.
514
+ * @param {{ type: string[], status: string[], priority: number[], model: string[] }} filterOptions
515
+ * @param {{ type?: string, status?: string, priority?: string|number, model?: string, q?: string, sort?: string, dir?: string }} [currentFilters]
516
+ * @returns {string}
517
+ */
518
+ function buildFilterHeaderRowHtml(filterOptions, currentFilters) {
519
+ const opts = filterOptions || { type: [], status: [], priority: [], model: [] };
520
+ const f = currentFilters || {};
521
+ const CTRL_STYLE = 'width: 100%; background: rgba(255,255,255,0.06); color: inherit; border: 1px solid var(--border, rgba(255,255,255,0.1)); border-radius: 4px; padding: 3px 6px; font-size: 12px;';
522
+
523
+ function selectHtml(field, allLabel, values, current, labelFn) {
524
+ const currentStr = current !== undefined && current !== null ? String(current) : '';
525
+ const optionsHtml = ['<option value="">' + escapeHtml(allLabel) + '</option>']
526
+ .concat((values || []).map((v) => {
527
+ const val = escapeHtml(String(v));
528
+ const label = escapeHtml(labelFn ? String(labelFn(v)) : String(v));
529
+ const selected = String(v) === currentStr ? ' selected' : '';
530
+ return '<option value="' + val + '"' + selected + '>' + label + '</option>';
531
+ }));
532
+ return '<select data-filter-field="' + field + '" style="' + CTRL_STYLE + '">' + optionsHtml.join('') + '</select>';
533
+ }
534
+
535
+ function sortSelectHtml(currentSort, currentDir) {
536
+ const isCreatedAtSort = currentSort === 'created_at';
537
+ const dir = isCreatedAtSort ? (currentDir === 'asc' ? 'asc' : 'desc') : '';
538
+ const optionsHtml = [
539
+ '<option value=""' + (dir === '' ? ' selected' : '') + '>Unsorted</option>',
540
+ '<option value="desc"' + (dir === 'desc' ? ' selected' : '') + '>Created (newest)</option>',
541
+ '<option value="asc"' + (dir === 'asc' ? ' selected' : '') + '>Created (oldest)</option>',
542
+ ];
543
+ return '<select data-sort-field="created_at" style="' + CTRL_STYLE + '">' + optionsHtml.join('') + '</select>';
544
+ }
545
+
546
+ const qVal = escapeHtml(f.q || '');
547
+ return '<tr style="border-bottom: 1px solid rgba(255,255,255,0.1);">' +
548
+ '<th style="padding: 8px; width: 110px;">ID</th>' +
549
+ '<th style="padding: 8px;"><input type="text" data-filter-field="q" placeholder="Search ID or Title..." value="' + qVal + '" style="' + CTRL_STYLE + '"/></th>' +
550
+ '<th style="padding: 8px; width: 90px;">' + selectHtml('type', 'Type', opts.type, f.type) + '</th>' +
551
+ '<th style="padding: 8px; width: 100px;">' + selectHtml('status', 'Status', opts.status, f.status) + '</th>' +
552
+ '<th style="padding: 8px; width: 50px;">' + selectHtml('priority', 'Pri', opts.priority, f.priority, (p) => 'P' + p) + '</th>' +
553
+ '<th style="padding: 8px; width: 80px;">' + selectHtml('model', 'Model', opts.model, f.model) + '</th>' +
554
+ '<th style="padding: 8px; width: 130px;">' + sortSelectHtml(f.sort, f.dir) + '</th>' +
555
+ '</tr>';
556
+ }
557
+
558
+ /**
559
+ * Splices `headerRowHtml` in place of the static plain-label header row
560
+ * `renderBeadsHtml()` always emits (`<th>ID</th><th>Title</th>...`), WITHOUT
561
+ * modifying the shared function itself -- fleet-sprint's own live viewer
562
+ * calls `renderBeadsHtml()` too and must keep its plain, non-interactive
563
+ * header untouched. First-match-only string replace: the header row renders
564
+ * exactly once, at the top of the `<table>`.
565
+ * @param {string} tableHtml
566
+ * @param {string} headerRowHtml
567
+ * @returns {string}
568
+ */
569
+ function injectFilterHeader(tableHtml, headerRowHtml) {
570
+ return tableHtml.replace(/<tr[^>]*>\s*(?:<th[^>]*>[\s\S]*?<\/th>\s*){6}<\/tr>/, headerRowHtml);
571
+ }
572
+
573
+ /**
574
+ * Injects a select-checkbox into every data row's leading ID cell (right
575
+ * after that cell's opening `<td>`, before the tree-toggle/id text) --
576
+ * again via string splice on `renderBeadsHtml()`'s OUTPUT, never by touching
577
+ * the shared renderer, so fleet-sprint's own viewer (which never calls this)
578
+ * is unaffected. `launch-form.mjs`'s client script drives selection off
579
+ * these checkboxes (see its 'change' listener), including cascading a
580
+ * parent's check state onto its visible children by walking sibling rows'
581
+ * indentation depth.
582
+ * @param {string} tableHtml
583
+ * @returns {string}
584
+ */
585
+ function injectRowCheckboxes(tableHtml) {
586
+ return tableHtml.replace(/(<tr data-bead-id="([^"]*)"[^>]*>\s*<td[^>]*>)/g, function (match, trAndTd, id) {
587
+ return trAndTd + '<input type="checkbox" class="bead-select-checkbox" data-bead-id="' + id + '" style="margin-right:6px; vertical-align:middle;"/>';
588
+ });
589
+ }
590
+
591
+ /**
592
+ * The Backlog tab's client-side behavior: re-renders `#backlog-table` from
593
+ * `renderBeadsHtml()` on every collapse/expand toggle (mirrors
594
+ * fleet-sprint's beadsExtension client script, minus its live SSE-poll/detail-
595
+ * fetch machinery -- this page has no running workflow to poll and every
596
+ * bead's full `description` is already inlined server-side, so there is
597
+ * nothing to lazy-fetch), and re-fetches `GET /api/backlog/tasks` -- a real
598
+ * network round trip that narrows the row SET server-side (apra-fleet-7xk's
599
+ * "not just UI" requirement) -- whenever a filter control changes.
600
+ * @returns {string}
601
+ */
602
+ function backlogPanelClientScript() {
603
+ return `
604
+ (function () {
605
+ var container = document.getElementById('backlog-table');
606
+ var indicator = document.getElementById('backlog-active-filters');
607
+ var totalCountEl = document.getElementById('backlog-total-count');
608
+ var clearBtn = document.getElementById('backlog-filter-clear');
609
+ if (!container) return;
610
+
611
+ // apra-fleet-eft.90: keep the persistent total-item count in sync with
612
+ // whatever lastTasks currently is -- called once up front (server-
613
+ // rendered value may already match, but this stays the single source of
614
+ // truth) and again every time lastTasks is reassigned below.
615
+ function updateTotalCount() {
616
+ if (totalCountEl) totalCountEl.textContent = lastTasks.length + ' bead(s)';
617
+ }
618
+
619
+ var collapsedBeadIds = new Set();
620
+ var lastTasks = window.__backlogTasks || [];
621
+ var filterOptions = window.__backlogFilterOptions || { type: [], status: [], priority: [], model: [] };
622
+ var currentFilters = {};
623
+ // apra-fleet-siqi.2.1: the server-embedded window.__backlogTasks above
624
+ // counts as this tab's initial "fetch" (a real bd query, just already
625
+ // resolved server-side rather than over the network) -- seeded to page-
626
+ // load time so a Backlog-tab activation immediately after opening the
627
+ // page does not force a redundant re-fetch; see applyFilters() and
628
+ // window.__fleetSeBacklog.refreshIfStale() below.
629
+ var lastBacklogFetchAt = Date.now();
630
+
631
+ ${escapeHtml.toString()}
632
+ ${renderBeadsHtml.toString()}
633
+ ${injectRowCheckboxes.toString()}
634
+ ${buildFilterHeaderRowHtml.toString()}
635
+ ${injectFilterHeader.toString()}
636
+
637
+ function wireHeaderControls() {
638
+ container.querySelectorAll('[data-filter-field]').forEach(function (el) {
639
+ var field = el.getAttribute('data-filter-field');
640
+ var evt = el.tagName === 'SELECT' ? 'change' : 'change';
641
+ el.addEventListener(evt, function () {
642
+ currentFilters[field] = el.value;
643
+ applyFilters();
644
+ });
645
+ });
646
+ // apra-fleet-qoxd.2: the Created-at sort control drives TWO
647
+ // currentFilters keys (sort/dir) off one <select>'s single value, so
648
+ // it cannot use the generic data-filter-field wiring above (which
649
+ // only ever sets one key). An empty value ('Unsorted') clears both
650
+ // keys back out of currentFilters entirely, matching the neutral
651
+ // (no sort param sent) state applyBeadFilters() expects.
652
+ container.querySelectorAll('[data-sort-field]').forEach(function (el) {
653
+ el.addEventListener('change', function () {
654
+ if (el.value) {
655
+ currentFilters.sort = el.getAttribute('data-sort-field');
656
+ currentFilters.dir = el.value;
657
+ } else {
658
+ delete currentFilters.sort;
659
+ delete currentFilters.dir;
660
+ }
661
+ applyFilters();
662
+ });
663
+ });
664
+ }
665
+
666
+ function renderTable() {
667
+ var raw = renderBeadsHtml([], lastTasks, collapsedBeadIds);
668
+ var headerRow = buildFilterHeaderRowHtml(filterOptions, currentFilters);
669
+ container.innerHTML = injectRowCheckboxes(injectFilterHeader(raw, headerRow));
670
+ wireHeaderControls();
671
+ // Re-apply any launch-form checkbox selection (see launch-form.mjs)
672
+ // that a fresh innerHTML would otherwise wipe -- the two scripts
673
+ // cooperate via this one small window-scoped hook rather than
674
+ // sharing a closure.
675
+ if (window.__fleetSeLaunch && typeof window.__fleetSeLaunch.isSelected === 'function') {
676
+ container.querySelectorAll('input.bead-select-checkbox').forEach(function (cb) {
677
+ if (window.__fleetSeLaunch.isSelected(cb.getAttribute('data-bead-id'))) {
678
+ cb.checked = true;
679
+ var tr = cb.closest('tr');
680
+ if (tr) tr.classList.add('bead-row-selected');
681
+ }
682
+ });
683
+ }
684
+ }
685
+
686
+ container.addEventListener('click', function (e) {
687
+ var toggle = e.target && e.target.closest ? e.target.closest('.tree-toggle') : null;
688
+ if (!toggle) return;
689
+ var id = toggle.dataset.toggleId;
690
+ if (!id) return;
691
+ if (collapsedBeadIds.has(id)) collapsedBeadIds.delete(id);
692
+ else collapsedBeadIds.add(id);
693
+ renderTable();
694
+ });
695
+
696
+ function applyFilters() {
697
+ lastBacklogFetchAt = Date.now();
698
+ var params = new URLSearchParams();
699
+ Object.keys(currentFilters).forEach(function (k) {
700
+ var v = currentFilters[k];
701
+ if (v) params.set(k, v);
702
+ });
703
+ fetch('/api/backlog/tasks?' + params.toString())
704
+ .then(function (r) { return r.json(); })
705
+ .then(function (data) {
706
+ lastTasks = (data && Array.isArray(data.tasks)) ? data.tasks : [];
707
+ window.__backlogTasks = lastTasks;
708
+ if (data && data.filterOptions) filterOptions = data.filterOptions;
709
+ collapsedBeadIds.clear();
710
+ renderTable();
711
+ updateTotalCount();
712
+ var entries = Object.keys(currentFilters)
713
+ .filter(function (k) { return currentFilters[k]; })
714
+ .map(function (k) { return k + ': ' + currentFilters[k]; });
715
+ if (indicator) indicator.textContent = entries.length ? ('Filtering by ' + entries.join(', ') + ' -- ' + lastTasks.length + ' of ' + (data.total || lastTasks.length) + ' shown') : '';
716
+ })
717
+ .catch(function () { /* leave the last-known-good table in place */ });
718
+ }
719
+
720
+ if (clearBtn) {
721
+ clearBtn.addEventListener('click', function () {
722
+ currentFilters = {};
723
+ applyFilters();
724
+ });
725
+ }
726
+
727
+ // apra-fleet-siqi.2.1: the Backlog-tab-activation refresh hook
728
+ // (dashboard.mjs's DASHBOARD_TAB_SCRIPT switchTab()) reaches this SAME
729
+ // applyFilters()/GET /api/backlog/tasks plumbing through here -- with
730
+ // whatever currentFilters are already active -- never a separate
731
+ // one-off fetch, and only when the last fetch is stale.
732
+ window.__fleetSeBacklog = {
733
+ refreshIfStale: function (maxAgeMs) {
734
+ if (Date.now() - lastBacklogFetchAt >= maxAgeMs) applyFilters();
735
+ },
736
+ };
737
+
738
+ wireHeaderControls();
739
+ updateTotalCount();
740
+ })();
741
+ `;
742
+ }
743
+
744
+ /**
745
+ * Renders the Backlog tab's full content: the beads table itself, server-
746
+ * rendered via fleet-sprint's `renderBeadsHtml()` with an empty `sprintTasks`
747
+ * (the supervisor has no single sprint's containment tree to show here --
748
+ * only the cross-sprint free set), then two supervisor-only post-processing
749
+ * passes over that same markup: `injectFilterHeader()` swaps the plain ID/
750
+ * Title/Type/Status/Pri/Model header row for one carrying live filter
751
+ * controls (search folded into the ID column, Type/Status/Pri/Model as
752
+ * `<select>`s seeded from `filterOptions`'s real observed values -- apra-
753
+ * fleet-7xk), and `injectRowCheckboxes()` adds a select-checkbox to every row
754
+ * (driven by launch-form.mjs's selection/cascade logic). Neither pass touches
755
+ * the shared `renderBeadsHtml()` itself, so fleet-sprint's own live viewer
756
+ * (which also calls it) is unaffected.
757
+ * @param {object[]} tasks
758
+ * @param {{ type: string[], status: string[], priority: number[], model: string[] }} filterOptions
759
+ * @returns {string}
760
+ */
761
+ export function renderBacklogPanelHtml(tasks, filterOptions) {
762
+ const opts = filterOptions || { type: [], status: [], priority: [], model: [] };
763
+ const rawTable = renderBeadsHtml([], tasks, new Set());
764
+ const headerRow = buildFilterHeaderRowHtml(opts, {});
765
+ const tableHtml = injectRowCheckboxes(injectFilterHeader(rawTable, headerRow));
766
+ const tasksJson = JSON.stringify(Array.isArray(tasks) ? tasks : []).replace(/</g, '\\u003c');
767
+ const filterOptionsJson = JSON.stringify(opts).replace(/</g, '\\u003c');
768
+ // apra-fleet-eft.90: a persistent total-item count, always visible at
769
+ // the top of the tab -- INDEPENDENT of #backlog-active-filters (which
770
+ // stays empty with no filter active, per that indicator's own
771
+ // long-standing contract). Server-rendered from `tasks` (the already-
772
+ // narrowed set this render actually shows, whether a filter is active or
773
+ // not) and kept in sync client-side by backlogPanelClientScript()'s
774
+ // renderTable()/applyFilters() whenever `lastTasks` changes -- so a
775
+ // filter change updates this number too, not just the '...shown' text
776
+ // inside #backlog-active-filters.
777
+ const totalTaskCount = Array.isArray(tasks) ? tasks.length : 0;
778
+ return (
779
+ '<div style="display:flex; justify-content:space-between; align-items:center; gap:8px; margin-bottom: 6px;">' +
780
+ '<span id="backlog-total-count" style="font-size: 12px; color: #a1a1aa;">' + totalTaskCount + ' bead(s)</span>' +
781
+ '<div style="display:flex; align-items:center; gap:8px;">' +
782
+ '<span id="backlog-active-filters" style="font-size: 12px; color: var(--accent, #3b82f6);"></span>' +
783
+ '<button type="button" id="backlog-filter-clear" class="btn btn-secondary" style="padding: 3px 10px; font-size: 12px;">Clear filters</button>' +
784
+ '</div>' +
785
+ '</div>' +
786
+ '<div id="backlog-table">' + tableHtml + '</div>' +
787
+ '<script>window.__backlogTasks = ' + tasksJson + '; window.__backlogFilterOptions = ' + filterOptionsJson + ';</script>' +
788
+ '<script>' + backlogPanelClientScript() + '</script>'
789
+ );
790
+ }
791
+
792
+ /**
793
+ * Registers `GET /api/backlog/tasks` -- the flat, filterable beads-tree data
794
+ * source for the Backlog tab's client-side filter re-fetch (see
795
+ * backlogPanelClientScript() above). Deliberately separate from the existing
796
+ * `GET /api/backlog` (api.mjs, the nested BacklogNode[] shape other callers
797
+ * may already depend on) -- this is an additive endpoint, not a replacement.
798
+ * @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
799
+ * @param {ReturnType<typeof createBacklog>} backlog
800
+ */
801
+ export function registerBacklogRoutes(supervisor, backlog) {
802
+ supervisor.route('GET', '/api/backlog/tasks', async (req, res) => {
803
+ try {
804
+ const url = new URL(req.url, 'http://localhost');
805
+ const filters = {
806
+ type: url.searchParams.get('type') || undefined,
807
+ status: url.searchParams.get('status') || undefined,
808
+ priority: url.searchParams.get('priority') || undefined,
809
+ model: url.searchParams.get('model') || undefined,
810
+ q: url.searchParams.get('q') || undefined,
811
+ sort: url.searchParams.get('sort') || undefined,
812
+ dir: url.searchParams.get('dir') || undefined,
813
+ };
814
+ const result = await backlog.buildBacklogTasks(filters);
815
+ sendJson(res, 200, result);
816
+ } catch (err) {
817
+ sendJson(res, 500, { error: 'failed to build backlog tasks' });
818
+ }
819
+ });
820
+ }
821
+
822
+ /**
823
+ * Create the Backlog seam. Collaborators injected for unit testing without a
824
+ * real `bd` / live sprints.
825
+ *
826
+ * @param {{
827
+ * ledger: { list: () => Array<{ sprintId: string, issueRoots: string[] }> },
828
+ * listAllBeads?: () => Promise<Array<object>>|Array<object>,
829
+ * expandScope?: (roots: string[]) => Promise<Set<string>>|Set<string>,
830
+ * watchdog?: { classifySprint: (entry: object) => Promise<{ status: string }> },
831
+ * logger?: { log?: Function, error?: Function },
832
+ * }} deps
833
+ *
834
+ * `expandScope`, if supplied, fully overrides claimed-scope computation (used
835
+ * by tests to stub scope expansion deterministically without a real `bd` /
836
+ * beads fixture). When omitted (the production default -- apra-fleet-c4s),
837
+ * claimed scope is computed IN-MEMORY via `expandScopeInMemory()`, walking a
838
+ * `buildChildIndex()` built off the SAME `listAllBeads()` result `buildTree()`
839
+ * / `buildBacklogTasks()` already fetch in the same render pass -- zero extra
840
+ * `bd` subprocess calls, never the old per-node `expandScope()` (./scope-
841
+ * overlap.mjs) subprocess walker.
842
+ */
843
+ export function createBacklog(deps = {}) {
844
+ const ledger = deps.ledger;
845
+ if (!ledger || typeof ledger.list !== 'function') {
846
+ throw new TypeError('createBacklog requires a ledger with a list() method');
847
+ }
848
+ const logger = deps.logger ?? console;
849
+ const logError = (...a) => (logger.error ?? logger.log)?.(...a);
850
+ // Only used when a caller (test) explicitly overrides claimed-scope
851
+ // computation wholesale -- the production default path below never calls
852
+ // this (apra-fleet-c4s: no per-node `bd` subprocess walk on every render).
853
+ const explicitExpand = deps.expandScope ?? null;
854
+ // Raw rows by default -- buildTree() below normalizes whatever this
855
+ // returns itself (normalizeBead() is idempotent on already-normalized
856
+ // input), and buildBacklogTasks() needs the FULLER raw shape (priority,
857
+ // dependencies, metadata, description) that a normalized row drops. One
858
+ // `bd` call per render either way -- never two.
859
+ const listAllBeads = deps.listAllBeads ?? bdListAllBeadsRaw;
860
+ const watchdog = deps.watchdog ?? null;
861
+
862
+ /**
863
+ * The active (non-finished) reservations whose scopes are subtracted from
864
+ * the Backlog. When a watchdog is injected, sprints it classifies `finished`
865
+ * are dropped -- their beads belong back in the Backlog (their section is
866
+ * gone from the live stack too). A classifier error keeps the reservation
867
+ * (fail safe: do not surface an in-flight sprint's beads as free).
868
+ * @returns {Promise<Array<{ sprintId: string, issueRoots: string[] }>>}
869
+ */
870
+ async function activeReservations() {
871
+ const entries = ledger.list();
872
+ if (!watchdog || typeof watchdog.classifySprint !== 'function') return entries;
873
+ const kept = [];
874
+ await Promise.all(entries.map(async (entry) => {
875
+ try {
876
+ const c = await watchdog.classifySprint(entry);
877
+ if (c.status !== WATCHDOG_STATUS.FINISHED) kept.push(entry);
878
+ } catch (err) {
879
+ logError(`[backlog] classifySprint failed for sprint '${entry.sprintId}':`, err);
880
+ kept.push(entry);
881
+ }
882
+ }));
883
+ return kept;
884
+ }
885
+
886
+ /**
887
+ * Build the claimed-id -> owning-sprint map by expanding every active
888
+ * sprint's roots to their live full subtree. First writer wins per id
889
+ * (exact-overlap policy guarantees no two active sprints share a bead
890
+ * anyway). A per-sprint expansion failure is isolated -- that one sprint
891
+ * contributes no claims rather than taking the whole Backlog down.
892
+ *
893
+ * Production default (no `deps.expandScope` override, apra-fleet-c4s):
894
+ * computed purely IN-MEMORY via `expandScopeInMemory()` off a
895
+ * `buildChildIndex()` built from `rawBeadsArg` if the caller already
896
+ * fetched it this render (buildTree()/buildBacklogTasks() below always
897
+ * do), or from one `listAllBeads()` call otherwise -- never a per-node
898
+ * `bd` subprocess walk.
899
+ * @param {Array<object>} [rawBeadsArg] - already-fetched `listAllBeads()`
900
+ * result, reused to avoid a second bulk fetch in the same render.
901
+ * @returns {Promise<Map<string, string>>}
902
+ */
903
+ async function buildClaimedBy(rawBeadsArg) {
904
+ const claimedBy = new Map();
905
+ const reservations = await activeReservations();
906
+ if (reservations.length === 0) return claimedBy;
907
+
908
+ let childIndex = null;
909
+ if (!explicitExpand) {
910
+ const rawBeads = rawBeadsArg ?? await listAllBeads();
911
+ const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
912
+ childIndex = buildChildIndex(beads);
913
+ }
914
+
915
+ await Promise.all(reservations.map(async (r) => {
916
+ try {
917
+ const roots = r.issueRoots ?? [];
918
+ const scope = explicitExpand ? await explicitExpand(roots) : expandScopeInMemory(roots, childIndex);
919
+ for (const id of scope) {
920
+ if (!claimedBy.has(id)) claimedBy.set(id, r.sprintId);
921
+ }
922
+ } catch (err) {
923
+ logError(`[backlog] scope expansion failed for sprint '${r.sprintId}':`, err);
924
+ }
925
+ }));
926
+ return claimedBy;
927
+ }
928
+
929
+ /** Build the Backlog forest (full tracker minus live-claimed subtrees). */
930
+ async function buildTree() {
931
+ const rawBeads = await listAllBeads();
932
+ const claimedBy = await buildClaimedBy(rawBeads);
933
+ const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
934
+ return buildBacklogTree(beads, claimedBy);
935
+ }
936
+
937
+ /** Render the Backlog section HTML (never throws -- degrades to empty state). */
938
+ async function renderHtml() {
939
+ try {
940
+ return renderBacklogTreeHtml(await buildTree());
941
+ } catch (err) {
942
+ logError('[backlog] render failed:', err);
943
+ return renderBacklogTreeHtml([]);
944
+ }
945
+ }
946
+
947
+ /**
948
+ * The flat, unclaimed bead set -- fleet-sprint's `renderBeadsHtml()` shape
949
+ * (raw `bd list --json` rows, plus a `partialClaim` field this module adds
950
+ * so the epic-with-some-children-claimed case, eft.6.2's original point,
951
+ * still surfaces even though this view has no containment tree of its own
952
+ * to hang the annotation off). `filters` narrows the SET ITSELF (not just
953
+ * what gets rendered from an already-fetched set) -- see applyBeadFilters().
954
+ * @param {{ type?: string, status?: string, priority?: string|number, model?: string, q?: string }} [filters]
955
+ * @returns {Promise<{ tasks: object[], total: number, filterOptions: object }>}
956
+ */
957
+ async function buildBacklogTasks(filters) {
958
+ const rawBeads = await listAllBeads();
959
+ const claimedBy = await buildClaimedBy(rawBeads);
960
+ const rows = (Array.isArray(rawBeads) ? rawBeads : [])
961
+ .filter((b) => b && typeof b.id === 'string' && b.id.length > 0);
962
+ const normalized = rows.map(normalizeBead);
963
+ const partialClaimById = computePartialClaimByBead(normalized, claimedBy);
964
+ // apra-fleet: stamp `parent` (the parent-child grouping edge,
965
+ // per parentIdOf's doc comment above) onto every row -- without it,
966
+ // renderBeadsHtml()'s Backlog branch has no containment info to nest
967
+ // by and every parent-child-only bead (no `blocks` edge) renders as
968
+ // a flat root sibling of its own epic, however deep its real nesting.
969
+ const free = rows
970
+ .filter((b) => !claimedBy.has(b.id))
971
+ .map((b) => ({ ...b, parent: parentIdOf(b), partialClaim: partialClaimById.get(b.id) ?? null }));
972
+ return applyBeadFilters(free, filters);
973
+ }
974
+
975
+ return {
976
+ name: 'backlog',
977
+ buildClaimedBy,
978
+ buildTree,
979
+ buildBacklogTasks,
980
+ renderHtml,
981
+ };
982
+ }