@apralabs/apra-fleet 0.4.1 → 0.4.3

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 (476) hide show
  1. package/README.md +53 -12
  2. package/dist/agents/backlog-groomer.md +42 -21
  3. package/dist/agents/ci-watcher.md +14 -0
  4. package/dist/agents/deployer.md +59 -46
  5. package/dist/agents/doer.md +157 -134
  6. package/dist/agents/harvester.md +31 -32
  7. package/dist/agents/integ-test-runner.md +92 -113
  8. package/dist/agents/kb-reconciler.md +40 -42
  9. package/dist/agents/plan-reviewer.md +139 -63
  10. package/dist/agents/planner.md +176 -100
  11. package/dist/agents/regression-test-runner.md +77 -81
  12. package/dist/agents/reviewer.md +69 -85
  13. package/dist/agents/schemas/integ-test-runner-output.json +1 -1
  14. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  15. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  16. package/dist/cli/agent-transform.d.ts +83 -2
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +266 -21
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts.map +1 -1
  21. package/dist/cli/auth.js +29 -11
  22. package/dist/cli/auth.js.map +1 -1
  23. package/dist/cli/config.d.ts +7 -5
  24. package/dist/cli/config.d.ts.map +1 -1
  25. package/dist/cli/config.js +44 -43
  26. package/dist/cli/config.js.map +1 -1
  27. package/dist/cli/install.d.ts +33 -0
  28. package/dist/cli/install.d.ts.map +1 -1
  29. package/dist/cli/install.js +294 -61
  30. package/dist/cli/install.js.map +1 -1
  31. package/dist/cli/kb-directives.d.ts.map +1 -1
  32. package/dist/cli/kb-directives.js +2 -1
  33. package/dist/cli/kb-directives.js.map +1 -1
  34. package/dist/cli/register-member.d.ts.map +1 -1
  35. package/dist/cli/register-member.js +7 -3
  36. package/dist/cli/register-member.js.map +1 -1
  37. package/dist/cli/start.d.ts.map +1 -1
  38. package/dist/cli/start.js +7 -0
  39. package/dist/cli/start.js.map +1 -1
  40. package/dist/cli/uninstall.d.ts.map +1 -1
  41. package/dist/cli/uninstall.js +5 -3
  42. package/dist/cli/uninstall.js.map +1 -1
  43. package/dist/cli/watch.d.ts +26 -3
  44. package/dist/cli/watch.d.ts.map +1 -1
  45. package/dist/cli/watch.js +41 -9
  46. package/dist/cli/watch.js.map +1 -1
  47. package/dist/commands/kb-server.d.ts +3 -0
  48. package/dist/commands/kb-server.d.ts.map +1 -1
  49. package/dist/commands/kb-server.js +43 -3
  50. package/dist/commands/kb-server.js.map +1 -1
  51. package/dist/index.js +3 -3
  52. package/dist/os/git-bash-candidates.d.ts +35 -0
  53. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  54. package/dist/os/git-bash-candidates.js +46 -0
  55. package/dist/os/git-bash-candidates.js.map +1 -0
  56. package/dist/os/index.d.ts +13 -4
  57. package/dist/os/index.d.ts.map +1 -1
  58. package/dist/os/index.js +17 -2
  59. package/dist/os/index.js.map +1 -1
  60. package/dist/os/linux.d.ts +6 -0
  61. package/dist/os/linux.d.ts.map +1 -1
  62. package/dist/os/linux.js +36 -3
  63. package/dist/os/linux.js.map +1 -1
  64. package/dist/os/os-commands.d.ts +68 -2
  65. package/dist/os/os-commands.d.ts.map +1 -1
  66. package/dist/os/os-commands.js.map +1 -1
  67. package/dist/os/windows-gitbash.d.ts +98 -0
  68. package/dist/os/windows-gitbash.d.ts.map +1 -0
  69. package/dist/os/windows-gitbash.js +259 -0
  70. package/dist/os/windows-gitbash.js.map +1 -0
  71. package/dist/os/windows.d.ts +6 -0
  72. package/dist/os/windows.d.ts.map +1 -1
  73. package/dist/os/windows.js +73 -8
  74. package/dist/os/windows.js.map +1 -1
  75. package/dist/providers/agy.d.ts +118 -8
  76. package/dist/providers/agy.d.ts.map +1 -1
  77. package/dist/providers/agy.js +580 -55
  78. package/dist/providers/agy.js.map +1 -1
  79. package/dist/providers/claude.d.ts +83 -4
  80. package/dist/providers/claude.d.ts.map +1 -1
  81. package/dist/providers/claude.js +365 -12
  82. package/dist/providers/claude.js.map +1 -1
  83. package/dist/providers/codex.d.ts +7 -4
  84. package/dist/providers/codex.d.ts.map +1 -1
  85. package/dist/providers/codex.js +24 -4
  86. package/dist/providers/codex.js.map +1 -1
  87. package/dist/providers/copilot.d.ts +7 -4
  88. package/dist/providers/copilot.d.ts.map +1 -1
  89. package/dist/providers/copilot.js +27 -4
  90. package/dist/providers/copilot.js.map +1 -1
  91. package/dist/providers/index.d.ts +0 -1
  92. package/dist/providers/index.d.ts.map +1 -1
  93. package/dist/providers/index.js +0 -3
  94. package/dist/providers/index.js.map +1 -1
  95. package/dist/providers/none.d.ts +7 -4
  96. package/dist/providers/none.d.ts.map +1 -1
  97. package/dist/providers/none.js +22 -4
  98. package/dist/providers/none.js.map +1 -1
  99. package/dist/providers/opencode.d.ts +6 -3
  100. package/dist/providers/opencode.d.ts.map +1 -1
  101. package/dist/providers/opencode.js +27 -4
  102. package/dist/providers/opencode.js.map +1 -1
  103. package/dist/providers/provider.d.ts +215 -11
  104. package/dist/providers/provider.d.ts.map +1 -1
  105. package/dist/providers/provider.js +58 -2
  106. package/dist/providers/provider.js.map +1 -1
  107. package/dist/services/agent-provisioner.js +2 -2
  108. package/dist/services/agent-provisioner.js.map +1 -1
  109. package/dist/services/agy-project.d.ts +102 -0
  110. package/dist/services/agy-project.d.ts.map +1 -0
  111. package/dist/services/agy-project.js +356 -0
  112. package/dist/services/agy-project.js.map +1 -0
  113. package/dist/services/auth-socket.js +4 -4
  114. package/dist/services/auth-web.js +1 -1
  115. package/dist/services/cloud/activity.js +2 -2
  116. package/dist/services/cloud/activity.js.map +1 -1
  117. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  118. package/dist/services/cloud/lifecycle.js +33 -4
  119. package/dist/services/cloud/lifecycle.js.map +1 -1
  120. package/dist/services/context-admission.d.ts.map +1 -1
  121. package/dist/services/context-admission.js +9 -7
  122. package/dist/services/context-admission.js.map +1 -1
  123. package/dist/services/credential-cleanup.d.ts.map +1 -1
  124. package/dist/services/credential-cleanup.js +47 -10
  125. package/dist/services/credential-cleanup.js.map +1 -1
  126. package/dist/services/exit-drain.d.ts +44 -0
  127. package/dist/services/exit-drain.d.ts.map +1 -0
  128. package/dist/services/exit-drain.js +52 -0
  129. package/dist/services/exit-drain.js.map +1 -0
  130. package/dist/services/github-app.d.ts.map +1 -1
  131. package/dist/services/github-app.js +32 -4
  132. package/dist/services/github-app.js.map +1 -1
  133. package/dist/services/http-transport.d.ts +1 -0
  134. package/dist/services/http-transport.d.ts.map +1 -1
  135. package/dist/services/http-transport.js +48 -1
  136. package/dist/services/http-transport.js.map +1 -1
  137. package/dist/services/knowledge/kb-config.d.ts +42 -0
  138. package/dist/services/knowledge/kb-config.d.ts.map +1 -0
  139. package/dist/services/knowledge/kb-config.js +54 -0
  140. package/dist/services/knowledge/kb-config.js.map +1 -0
  141. package/dist/services/knowledge/kb-providers.d.ts +7 -1
  142. package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
  143. package/dist/services/knowledge/kb-providers.js +191 -17
  144. package/dist/services/knowledge/kb-providers.js.map +1 -1
  145. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  146. package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
  149. package/dist/services/member-home.d.ts +1 -1
  150. package/dist/services/member-home.d.ts.map +1 -1
  151. package/dist/services/member-home.js +15 -12
  152. package/dist/services/member-home.js.map +1 -1
  153. package/dist/services/model-pricing.d.ts.map +1 -1
  154. package/dist/services/model-pricing.js +7 -8
  155. package/dist/services/model-pricing.js.map +1 -1
  156. package/dist/services/orphan-recovery.d.ts +6 -3
  157. package/dist/services/orphan-recovery.d.ts.map +1 -1
  158. package/dist/services/orphan-recovery.js +17 -14
  159. package/dist/services/orphan-recovery.js.map +1 -1
  160. package/dist/services/preflight-check.js +2 -2
  161. package/dist/services/preflight-check.js.map +1 -1
  162. package/dist/services/secret-token.d.ts +38 -0
  163. package/dist/services/secret-token.d.ts.map +1 -0
  164. package/dist/services/secret-token.js +51 -0
  165. package/dist/services/secret-token.js.map +1 -0
  166. package/dist/services/service-manager/types.d.ts +3 -1
  167. package/dist/services/service-manager/types.d.ts.map +1 -1
  168. package/dist/services/service-manager/windows.d.ts +14 -2
  169. package/dist/services/service-manager/windows.d.ts.map +1 -1
  170. package/dist/services/service-manager/windows.js +65 -7
  171. package/dist/services/service-manager/windows.js.map +1 -1
  172. package/dist/services/shell-probe.d.ts +131 -0
  173. package/dist/services/shell-probe.d.ts.map +1 -0
  174. package/dist/services/shell-probe.js +210 -0
  175. package/dist/services/shell-probe.js.map +1 -0
  176. package/dist/services/singleton.d.ts +2 -0
  177. package/dist/services/singleton.d.ts.map +1 -1
  178. package/dist/services/singleton.js +1 -1
  179. package/dist/services/singleton.js.map +1 -1
  180. package/dist/services/ssh.d.ts.map +1 -1
  181. package/dist/services/ssh.js +60 -4
  182. package/dist/services/ssh.js.map +1 -1
  183. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  184. package/dist/services/stall/find-log-file.js +22 -16
  185. package/dist/services/stall/find-log-file.js.map +1 -1
  186. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  187. package/dist/services/stall/read-log-tail.js +26 -15
  188. package/dist/services/stall/read-log-tail.js.map +1 -1
  189. package/dist/services/stall/stall-detector.d.ts +53 -4
  190. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  191. package/dist/services/stall/stall-detector.js +212 -34
  192. package/dist/services/stall/stall-detector.js.map +1 -1
  193. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  194. package/dist/services/stall/stall-poller.js +35 -42
  195. package/dist/services/stall/stall-poller.js.map +1 -1
  196. package/dist/services/strategy.d.ts +9 -0
  197. package/dist/services/strategy.d.ts.map +1 -1
  198. package/dist/services/strategy.js +119 -8
  199. package/dist/services/strategy.js.map +1 -1
  200. package/dist/services/substitution-engine.js +2 -2
  201. package/dist/services/substitution-engine.js.map +1 -1
  202. package/dist/services/tool-registry.d.ts.map +1 -1
  203. package/dist/services/tool-registry.js +5 -3
  204. package/dist/services/tool-registry.js.map +1 -1
  205. package/dist/services/user-config.js +1 -1
  206. package/dist/services/user-config.js.map +1 -1
  207. package/dist/services/vcs/azure-devops.d.ts +67 -2
  208. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  209. package/dist/services/vcs/azure-devops.js +281 -15
  210. package/dist/services/vcs/azure-devops.js.map +1 -1
  211. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  212. package/dist/services/vcs/bitbucket.js +16 -0
  213. package/dist/services/vcs/bitbucket.js.map +1 -1
  214. package/dist/services/vcs/github.d.ts.map +1 -1
  215. package/dist/services/vcs/github.js +24 -0
  216. package/dist/services/vcs/github.js.map +1 -1
  217. package/dist/services/vcs/types.d.ts +123 -2
  218. package/dist/services/vcs/types.d.ts.map +1 -1
  219. package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
  220. package/dist/skills/pm/SKILL.md +1 -2
  221. package/dist/skills/pm/cost.md +0 -4
  222. package/dist/skills/pm/fleet-addendum.md +2 -3
  223. package/dist/tools/check-status.d.ts +7 -4
  224. package/dist/tools/check-status.d.ts.map +1 -1
  225. package/dist/tools/check-status.js +5 -3
  226. package/dist/tools/check-status.js.map +1 -1
  227. package/dist/tools/cloud-control.js +2 -2
  228. package/dist/tools/cloud-control.js.map +1 -1
  229. package/dist/tools/compose-permissions.d.ts +6 -0
  230. package/dist/tools/compose-permissions.d.ts.map +1 -1
  231. package/dist/tools/compose-permissions.js +211 -50
  232. package/dist/tools/compose-permissions.js.map +1 -1
  233. package/dist/tools/credential-store-set.js +1 -1
  234. package/dist/tools/execute-command.d.ts.map +1 -1
  235. package/dist/tools/execute-command.js +56 -29
  236. package/dist/tools/execute-command.js.map +1 -1
  237. package/dist/tools/execute-prompt.d.ts +15 -2
  238. package/dist/tools/execute-prompt.d.ts.map +1 -1
  239. package/dist/tools/execute-prompt.js +1214 -873
  240. package/dist/tools/execute-prompt.js.map +1 -1
  241. package/dist/tools/kb-capture.d.ts +2 -2
  242. package/dist/tools/kb-capture.d.ts.map +1 -1
  243. package/dist/tools/kb-capture.js +29 -5
  244. package/dist/tools/kb-capture.js.map +1 -1
  245. package/dist/tools/kb-export.d.ts +2 -2
  246. package/dist/tools/kb-export.d.ts.map +1 -1
  247. package/dist/tools/kb-export.js +3 -28
  248. package/dist/tools/kb-export.js.map +1 -1
  249. package/dist/tools/kb-feedback.d.ts.map +1 -1
  250. package/dist/tools/kb-feedback.js +3 -1
  251. package/dist/tools/kb-feedback.js.map +1 -1
  252. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
  253. package/dist/tools/kb-freshness-sweep.js +3 -1
  254. package/dist/tools/kb-freshness-sweep.js.map +1 -1
  255. package/dist/tools/kb-import.d.ts.map +1 -1
  256. package/dist/tools/kb-import.js +2 -1
  257. package/dist/tools/kb-import.js.map +1 -1
  258. package/dist/tools/kb-list.d.ts.map +1 -1
  259. package/dist/tools/kb-list.js +3 -1
  260. package/dist/tools/kb-list.js.map +1 -1
  261. package/dist/tools/kb-query.d.ts +2 -2
  262. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
  263. package/dist/tools/kb-reconcile-prefilter.js +3 -1
  264. package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
  265. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
  266. package/dist/tools/kb-resolve-contradiction.js +3 -1
  267. package/dist/tools/kb-resolve-contradiction.js.map +1 -1
  268. package/dist/tools/kb-setup.d.ts.map +1 -1
  269. package/dist/tools/kb-setup.js +125 -20
  270. package/dist/tools/kb-setup.js.map +1 -1
  271. package/dist/tools/kb-stats.d.ts.map +1 -1
  272. package/dist/tools/kb-stats.js +64 -43
  273. package/dist/tools/kb-stats.js.map +1 -1
  274. package/dist/tools/list-members.d.ts +2 -2
  275. package/dist/tools/list-members.d.ts.map +1 -1
  276. package/dist/tools/list-members.js +7 -2
  277. package/dist/tools/list-members.js.map +1 -1
  278. package/dist/tools/member-detail.d.ts +2 -2
  279. package/dist/tools/member-detail.d.ts.map +1 -1
  280. package/dist/tools/member-detail.js +22 -3
  281. package/dist/tools/member-detail.js.map +1 -1
  282. package/dist/tools/member-reservation.d.ts +58 -1
  283. package/dist/tools/member-reservation.d.ts.map +1 -1
  284. package/dist/tools/member-reservation.js +71 -18
  285. package/dist/tools/member-reservation.js.map +1 -1
  286. package/dist/tools/monitor-task.d.ts.map +1 -1
  287. package/dist/tools/monitor-task.js +17 -2
  288. package/dist/tools/monitor-task.js.map +1 -1
  289. package/dist/tools/provision-auth.d.ts +80 -1
  290. package/dist/tools/provision-auth.d.ts.map +1 -1
  291. package/dist/tools/provision-auth.js +147 -59
  292. package/dist/tools/provision-auth.js.map +1 -1
  293. package/dist/tools/provision-vcs-auth.d.ts +96 -3
  294. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  295. package/dist/tools/provision-vcs-auth.js +254 -88
  296. package/dist/tools/provision-vcs-auth.js.map +1 -1
  297. package/dist/tools/register-member.d.ts +21 -12
  298. package/dist/tools/register-member.d.ts.map +1 -1
  299. package/dist/tools/register-member.js +141 -16
  300. package/dist/tools/register-member.js.map +1 -1
  301. package/dist/tools/remove-member.d.ts.map +1 -1
  302. package/dist/tools/remove-member.js +29 -4
  303. package/dist/tools/remove-member.js.map +1 -1
  304. package/dist/tools/revoke-vcs-auth.js +2 -2
  305. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  306. package/dist/tools/send-email.d.ts +2 -2
  307. package/dist/tools/setup-git-app.d.ts.map +1 -1
  308. package/dist/tools/setup-git-app.js +11 -7
  309. package/dist/tools/setup-git-app.js.map +1 -1
  310. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  311. package/dist/tools/setup-ssh-key.js +2 -1
  312. package/dist/tools/setup-ssh-key.js.map +1 -1
  313. package/dist/tools/shutdown-server.d.ts +2 -0
  314. package/dist/tools/shutdown-server.d.ts.map +1 -1
  315. package/dist/tools/shutdown-server.js +23 -1
  316. package/dist/tools/shutdown-server.js.map +1 -1
  317. package/dist/tools/stop-prompt.js +2 -2
  318. package/dist/tools/stop-prompt.js.map +1 -1
  319. package/dist/tools/update-agent-cli.js +2 -2
  320. package/dist/tools/update-agent-cli.js.map +1 -1
  321. package/dist/tools/update-member.d.ts +21 -12
  322. package/dist/tools/update-member.d.ts.map +1 -1
  323. package/dist/tools/update-member.js +61 -12
  324. package/dist/tools/update-member.js.map +1 -1
  325. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  326. package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
  327. package/dist/tools/vcs-credential-exec.js +197 -0
  328. package/dist/tools/vcs-credential-exec.js.map +1 -0
  329. package/dist/types.d.ts +24 -1
  330. package/dist/types.d.ts.map +1 -1
  331. package/dist/utils/agent-helpers.d.ts +36 -0
  332. package/dist/utils/agent-helpers.d.ts.map +1 -1
  333. package/dist/utils/agent-helpers.js +39 -1
  334. package/dist/utils/agent-helpers.js.map +1 -1
  335. package/dist/utils/log-helpers.d.ts.map +1 -1
  336. package/dist/utils/log-helpers.js +2 -2
  337. package/dist/utils/log-helpers.js.map +1 -1
  338. package/dist/utils/platform.d.ts +7 -0
  339. package/dist/utils/platform.d.ts.map +1 -1
  340. package/dist/utils/platform.js +11 -1
  341. package/dist/utils/platform.js.map +1 -1
  342. package/dist/utils/prompt-errors.d.ts.map +1 -1
  343. package/dist/utils/prompt-errors.js +7 -1
  344. package/dist/utils/prompt-errors.js.map +1 -1
  345. package/dist/utils/shell-escape.d.ts +16 -0
  346. package/dist/utils/shell-escape.d.ts.map +1 -1
  347. package/dist/utils/shell-escape.js +22 -2
  348. package/dist/utils/shell-escape.js.map +1 -1
  349. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  350. package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
  351. package/dist/utils/vcs-provider-detect.js +109 -0
  352. package/dist/utils/vcs-provider-detect.js.map +1 -0
  353. package/dist/utils/workspace-trust.d.ts +20 -17
  354. package/dist/utils/workspace-trust.d.ts.map +1 -1
  355. package/dist/utils/workspace-trust.js +91 -1
  356. package/dist/utils/workspace-trust.js.map +1 -1
  357. package/dist/workflows/auto-sprint.js +180 -32
  358. package/package.json +7 -5
  359. package/packages/apra-fleet-client/src/client/api.mjs +403 -12
  360. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  361. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  362. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
  363. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
  364. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
  365. package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
  366. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
  367. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
  368. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
  369. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
  370. package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
  371. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
  372. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
  376. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
  377. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
  379. package/packages/apra-fleet-se/bin/cli.mjs +280 -3
  380. package/packages/apra-fleet-se/bin/serve.mjs +114 -5
  381. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
  382. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
  383. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
  384. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
  385. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
  386. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
  387. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  388. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
  389. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
  390. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
  391. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
  392. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
  393. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  394. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
  395. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
  396. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
  397. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
  398. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  399. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
  400. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  401. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  402. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
  403. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
  404. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
  405. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  406. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  407. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  408. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
  409. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
  410. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
  411. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  412. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
  413. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  414. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
  415. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
  416. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  417. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  418. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  419. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
  420. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
  421. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
  422. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
  423. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
  424. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  425. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
  426. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
  427. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
  428. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
  429. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
  430. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
  431. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
  432. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
  433. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  434. package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
  435. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  436. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
  437. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  438. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  439. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
  440. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
  441. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
  442. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
  443. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
  444. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
  445. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  446. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
  447. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
  448. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
  449. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
  450. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  451. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  452. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
  453. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
  454. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
  455. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
  456. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  457. package/packages/apra-fleet-se/package.json +1 -1
  458. package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
  459. package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
  460. package/skills/fleet/SKILL.md +27 -16
  461. package/skills/fleet/auth-azdevops.md +57 -7
  462. package/skills/fleet/auth-bitbucket.md +5 -5
  463. package/skills/fleet/auth-github.md +7 -6
  464. package/skills/fleet/beads-conflict-resolution.md +141 -0
  465. package/skills/fleet/beads.md +16 -12
  466. package/skills/fleet/onboarding.md +6 -6
  467. package/skills/fleet/permissions.md +11 -7
  468. package/skills/fleet/profiles/node.json +1 -1
  469. package/skills/fleet/skill-matrix.md +1 -1
  470. package/skills/fleet/troubleshooting.md +4 -3
  471. package/version.json +1 -1
  472. package/dist/providers/gemini.d.ts +0 -52
  473. package/dist/providers/gemini.d.ts.map +0 -1
  474. package/dist/providers/gemini.js +0 -236
  475. package/dist/providers/gemini.js.map +0 -1
  476. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
@@ -9,7 +9,22 @@ import { computeSprintProgress } from './sprint-progress.mjs';
9
9
  * itself -- and renders a horizontal bar that fills left-to-right by
10
10
  * `fraction`, plus the numeric 'M/N' text. Styled with the viewer's existing
11
11
  * `--bg`/`--bg-glass`/`--accent` CSS variables. `required === 0` renders a
12
- * flat, empty bar and '0/0' text rather than dividing by zero or throwing.
12
+ * flat, empty bar and 'Required: 0/0' text rather than dividing by zero or
13
+ * throwing.
14
+ *
15
+ * apra-fleet-vk0a.1: the 'M/N' text carries an explicit `Required: ` label
16
+ * (closed/required, goal+decomposedParentIds-filtered per
17
+ * computeSprintProgress()) -- this widget is reused as-is by BOTH the
18
+ * fleet-sprint per-sprint viewer's Tasks tab (renderBeadsPanel() below --
19
+ * apra-fleet-vk0a.2 pins it into the FIXED panel-header row, next to the
20
+ * 'Tasks' label, rather than the top of the scrollable tree below, so it
21
+ * never scrolls out of view alongside renderBeadsHtml()'s OWN,
22
+ * differently-scoped 'All tasks (incl. backlog)' count -- see that widget's
23
+ * doc comment) AND the supervisor dashboard's Sprint Stack card
24
+ * (dashboard.mjs's renderSprintProgressHtml(), next to its OWN
25
+ * differently-scoped 'N total in scope' count -- apra-fleet-vk0a.3).
26
+ * Labeling it once, here, keeps both pairings unambiguous without a second
27
+ * implementation.
13
28
  *
14
29
  * @param {{ closed: number, required: number, fraction: number }} progress
15
30
  * @returns {string}
@@ -25,7 +40,7 @@ export function renderProgressBarHtml(progress) {
25
40
  '<div style="flex: 1; height: 8px; background: var(--bg); border: 1px solid var(--bg-glass); border-radius: 4px; overflow: hidden;">' +
26
41
  '<div style="width: ' + pct + '%; height: 100%; background: var(--accent);"></div>' +
27
42
  '</div>' +
28
- '<div style="color: #a1a1aa; white-space: nowrap;">' + closed + '/' + required + '</div>' +
43
+ '<div style="color: #a1a1aa; white-space: nowrap;">Required: ' + closed + '/' + required + '</div>' +
29
44
  '</div>'
30
45
  );
31
46
  }
@@ -89,20 +104,21 @@ export function renderProgressBarHtml(progress) {
89
104
  * header row and outer `<table>` wrapper always render regardless of which
90
105
  * (if either) section has content.
91
106
  *
92
- * apra-fleet-k7s: unlike Sprint (nested by `parent` containment), Backlog
93
- * has no shared parent/epic to nest under -- what it DOES sometimes have is
94
- * `blocks`-type dependency edges BETWEEN backlog items themselves (e.g. two
95
- * unplanned beads under the same stale epic, one blocking the other). When
96
- * present, those edges now drive nesting the same way `renderNode` nests
97
- * Sprint rows: the blocker renders as the parent row, the blocked item
98
- * nests as its child, using the identical indent/prefix/cycle-guard
99
- * mechanics. A backlog item with no blocks-edge to another IN-SET backlog
100
- * item (the common case -- most backlog beads are unrelated to each other)
101
- * remains a flat, top-level row, same as before -- nesting is only ever
102
- * drawn when a real edge justifies it, never implied. Root rows (including
103
- * every item with no in-set blocker) are still sorted priority-then-id for
104
- * scannability; a blocked item's DEPTH in the tree is what shows structure,
105
- * not its position in that sort.
107
+ * apra-fleet-k7s: Backlog nests the same way Sprint does -- by `parent`
108
+ * containment FIRST (an in-set parent-child edge, e.g. an epic's children
109
+ * that never made it into a sprint run) -- falling back to `blocks`-type
110
+ * dependency edges BETWEEN backlog items only for a genuinely parent-less
111
+ * item (e.g. two unplanned beads under the same stale epic, one blocking
112
+ * the other, with the epic itself out of this dataset). When a blocks-edge
113
+ * fallback fires, it drives nesting the same way `renderNode` nests Sprint
114
+ * rows: the blocker renders as the parent row, the blocked item nests as
115
+ * its child, using the identical indent/prefix/cycle-guard mechanics. A
116
+ * backlog item with neither an in-set parent nor a blocks-edge to another
117
+ * IN-SET backlog item remains a flat, top-level row -- nesting is only
118
+ * ever drawn when a real edge justifies it, never implied. Root rows
119
+ * (including every item with no in-set parent/blocker) are still sorted
120
+ * priority-then-id for scannability; a nested item's DEPTH in the tree is
121
+ * what shows structure, not its position in that sort.
106
122
  *
107
123
  * Every rendering decision here (status/type badges, tree placement) is
108
124
  * defensive by construction: unrecognized/missing status, type, model, or
@@ -475,15 +491,14 @@ export function renderBeadsHtml(sprintTasks, backlogTasks, collapsedIds) {
475
491
  return html;
476
492
  }
477
493
 
478
- // apra-fleet-k7s: Backlog is built into a tree from `blocks`-type
479
- // dependency edges BETWEEN backlog items (mirrors the doc-comment above
480
- // and reuses renderNode's own indent/prefix/cycle-guard mechanics, just
481
- // keyed off a separate `backlogMap`/`backlogChildrenOf` built from
482
- // blocks-edges instead of Sprint's `map`/`childrenOf` built from
483
- // `parent`). A blocker outside the backlog set (e.g. it's actually in
484
- // this run's Sprint, or not part of this dataset at all) does not
485
- // count -- same "only an in-dataset edge nests" rule Sprint applies to
486
- // `parent`.
494
+ // apra-fleet-k7s: Backlog is built into a tree from `parent` containment
495
+ // FIRST, `blocks`-type dependency edges BETWEEN backlog items SECOND
496
+ // (mirrors the doc-comment above and reuses renderNode's own indent/
497
+ // prefix/cycle-guard mechanics, just keyed off a separate `backlogMap`/
498
+ // `backlogChildrenOf` rather than Sprint's `map`/`childrenOf`). A parent
499
+ // or blocker outside the backlog set (e.g. it's actually in this run's
500
+ // Sprint, or not part of this dataset at all) does not count -- same
501
+ // "only an in-dataset edge nests" rule Sprint applies to `parent`.
487
502
  const backlogMap = {};
488
503
  backlogTasks.forEach((t) => { backlogMap[t.id] = { ...t, blockedBy: [] }; });
489
504
 
@@ -496,7 +511,20 @@ export function renderBeadsHtml(sprintTasks, backlogTasks, collapsedIds) {
496
511
  .filter((d) => d && d.type === 'blocks' && backlogMap[d.depends_on_id])
497
512
  .map((d) => d.depends_on_id);
498
513
  backlogMap[t.id].blockedBy = blockerIds;
499
- if (blockerIds.length > 0) {
514
+
515
+ // apra-fleet: containment (`parent`, in-set) nests FIRST, mirroring
516
+ // Sprint's `map`/`childrenOf` above -- most backlog beads have a real
517
+ // parent-child edge (an epic's children that never made it into a
518
+ // sprint run), and nesting those under a `blocks` edge instead left
519
+ // every parent-child-only bead rendering as a flat root alongside
520
+ // its own epic. `blocks`-edge nesting is now the FALLBACK, used only
521
+ // for a genuinely parent-less backlog item that still blocks/is
522
+ // blocked by another in-set item.
523
+ const parentId = t.parent;
524
+ if (parentId !== undefined && parentId !== null && backlogMap[parentId]) {
525
+ (backlogChildrenOf[parentId] = backlogChildrenOf[parentId] || []).push(t.id);
526
+ nestedBacklogIds.add(t.id);
527
+ } else if (blockerIds.length > 0) {
500
528
  // A node renders exactly once (cycle-guard below), so with
501
529
  // multiple in-set blockers only one can be the tree-parent --
502
530
  // the lowest-sorted blocker id wins, for deterministic output.
@@ -565,20 +593,31 @@ export function renderBeadsHtml(sprintTasks, backlogTasks, collapsedIds) {
565
593
  return html;
566
594
  }
567
595
 
568
- // apra-fleet-eft.90: a persistent 'M/N' item count at the top of the
569
- // panel -- N = every rendered bead across BOTH sections (Sprint +
570
- // Backlog), M = how many of those are not closed (open, in_progress,
571
- // blocked, etc). Parent and child beads each count as their own item
572
- // toward both numbers -- these are flat counts over the input arrays
573
- // themselves, never deduped/collapsed by tree hierarchy (a bead present
574
- // in `sprintTasks`/`backlogTasks` counts exactly once regardless of how
596
+ // apra-fleet-eft.90: a persistent item count at the top of the panel --
597
+ // N = every rendered bead across BOTH sections (Sprint + Backlog), M =
598
+ // how many of those are not closed (open, in_progress, blocked, etc).
599
+ // Parent and child beads each count as their own item toward both
600
+ // numbers -- these are flat counts over the input arrays themselves,
601
+ // never deduped/collapsed by tree hierarchy (a bead present in
602
+ // `sprintTasks`/`backlogTasks` counts exactly once regardless of how
575
603
  // many descendants it has). An empty panel (both lists empty) renders
576
- // '0/0', never NaN/throwing.
604
+ // 'All tasks (incl. backlog): 0 open / 0 total', never NaN/throwing.
605
+ //
606
+ // apra-fleet-vk0a.1: labeled 'All tasks (incl. backlog)' -- explicitly
607
+ // distinct from the DIFFERENT scope/definition of renderProgressBarHtml()'s
608
+ // 'Required: M/N' widget (goal+decomposedParentIds-filtered, sprintTasks
609
+ // only), which apra-fleet-vk0a.2 pins into the Tasks tab's FIXED
610
+ // panel-header row (renderBeadsPanel() below) rather than rendering it
611
+ // here at the top of this scrollable panel. Before the vk0a.1 label, the
612
+ // two counts read as a bug (same-looking 'M/N' pair, different
613
+ // denominators AND inverted numerator polarity -- this one is
614
+ // open-count, that one is closed-count) rather than two intentionally
615
+ // different, both-useful numbers.
577
616
  const countedTasks = sprintTasks.concat(backlogTasks);
578
617
  const totalBeadCount = countedTasks.length;
579
618
  const openBeadCount = countedTasks.filter((t) => t && (t.status || '').toString().toLowerCase() !== 'closed').length;
580
619
  const countHtml = '<div class="beads-count" style="padding: 4px 8px; font-size: 12px; color: #a1a1aa;">' +
581
- openBeadCount + '/' + totalBeadCount + '</div>';
620
+ 'All tasks (incl. backlog): ' + openBeadCount + ' open / ' + totalBeadCount + ' total</div>';
582
621
 
583
622
  let html = countHtml + '<table style="width: 100%; border-collapse: collapse; text-align: left; font-size: 13px;">';
584
623
  html += '<tr style="border-bottom: 1px solid rgba(255,255,255,0.1);">' +
@@ -714,6 +753,69 @@ export function renderResultExtrasHtml(result) {
714
753
  return verdictHtml + prHtml;
715
754
  }
716
755
 
756
+ /**
757
+ * Pure HTML-string builder for the "Beads database" block: which .beads
758
+ * (dir | prefix | remote) every member's bd resolved to at sprint start, as
759
+ * published by the runner's beads identity precondition under the
760
+ * `beadsIdentity` state namespace ({ expected, expectedFrom, members: {
761
+ * name: { beadsDir, prefix, syncRemote, repoRemote, unresolved?: string[] }
762
+ * }, warnings?: string[] }). A field named in a member's `unresolved` list
763
+ * renders as an amber "?" cell (the probe could not report it, so it was
764
+ * not compared); every published warning renders as one amber row under
765
+ * the table. Returns '' when nothing has been published yet so the caller
766
+ * can omit the block. Same embed rules as renderBeadsHtml: concatenation
767
+ * only, every value through escapeHtml.
768
+ *
769
+ * @param {{ expected?: object|null, expectedFrom?: string, members?: Record<string, object>, warnings?: string[] }|null|undefined} identity
770
+ * @returns {string}
771
+ */
772
+ export function renderBeadsIdentityHtml(identity) {
773
+ if (!identity || typeof identity !== 'object') return '';
774
+ const members = identity.members && typeof identity.members === 'object' ? identity.members : {};
775
+ const names = Object.keys(members);
776
+ const warnings = Array.isArray(identity.warnings) ? identity.warnings : [];
777
+ if (names.length === 0 && !identity.expected && warnings.length === 0) return '';
778
+
779
+ function cell(value, unresolved) {
780
+ if (unresolved) {
781
+ return '<td data-unresolved="true" title="not reported by this member; not compared" style="padding: 2px 8px; font-size: 11px; font-family: monospace; color: #f59e0b; white-space: nowrap;">?</td>';
782
+ }
783
+ return '<td style="padding: 2px 8px; font-size: 11px; font-family: monospace; white-space: nowrap;">' + escapeHtml(String(value || '')) + '</td>';
784
+ }
785
+ function row(label, id) {
786
+ const rec = id && typeof id === 'object' ? id : {};
787
+ const unresolved = new Set(Array.isArray(rec.unresolved) ? rec.unresolved : []);
788
+ return '<tr>' +
789
+ '<td style="padding: 2px 8px; font-size: 11px; color: #a1a1aa; white-space: nowrap;">' + escapeHtml(String(label)) + '</td>' +
790
+ cell(rec.beadsDir || '(no .beads)', false) +
791
+ cell(rec.prefix || '?', unresolved.has('prefix')) +
792
+ cell(rec.syncRemote || '(unset)', unresolved.has('syncRemote')) +
793
+ '</tr>';
794
+ }
795
+
796
+ let rows = '';
797
+ if (identity.expected) {
798
+ const from = identity.expectedFrom === 'orchestrator' ? 'expected (from orchestrator)' : 'expected';
799
+ rows += row(from, identity.expected);
800
+ }
801
+ for (const name of names) rows += row(name, members[name]);
802
+
803
+ let warningsHtml = '';
804
+ for (const w of warnings) {
805
+ warningsHtml += '<div data-beads-identity-warning="true" style="font-size: 11px; color: #f59e0b; padding: 2px 8px;">WARNING: ' + escapeHtml(String(w)) + '</div>';
806
+ }
807
+
808
+ return '<div data-beads-identity="true" style="margin: 4px 0 8px 0;">' +
809
+ '<div style="font-size: 11px; font-weight: 600; color: #a1a1aa; padding: 2px 8px;">Beads database</div>' +
810
+ '<table style="border-collapse: collapse;">' +
811
+ '<tr>' +
812
+ '<th style="padding: 2px 8px; font-size: 10px; color: #71717a; text-align: left;">member</th>' +
813
+ '<th style="padding: 2px 8px; font-size: 10px; color: #71717a; text-align: left;">dir</th>' +
814
+ '<th style="padding: 2px 8px; font-size: 10px; color: #71717a; text-align: left;">prefix</th>' +
815
+ '<th style="padding: 2px 8px; font-size: 10px; color: #71717a; text-align: left;">remote</th>' +
816
+ '</tr>' + rows + '</table>' + warningsHtml + '</div>';
817
+ }
818
+
717
819
  // apra-fleet-eft.37.4 (M3, docs/workflow-core-boundary-refactoring.md):
718
820
  // relocated verbatim from packages/apra-fleet-workflow/src/viewer/index.mjs's
719
821
  // former findBeadById() -- that was the one place core reached into
@@ -760,6 +862,7 @@ export const beadsExtension = {
760
862
  ${escapeHtml.toString()}
761
863
  ${renderBeadsHtml.toString()}
762
864
  ${renderResultExtrasHtml.toString()}
865
+ ${renderBeadsIdentityHtml.toString()}
763
866
  ${computeSprintProgress.toString()}
764
867
  ${renderProgressBarHtml.toString()}
765
868
 
@@ -884,6 +987,10 @@ export const beadsExtension = {
884
987
  // without waiting on (or synthesizing) a new server payload.
885
988
  const collapsedBeadIds = new Set();
886
989
  let lastBeadsData = { sprintTasks: [], backlogTasks: [] };
990
+ // The runner's beads identity precondition publishes under its own
991
+ // 'beadsIdentity' namespace (workflow:state:beadsIdentity); cached
992
+ // here and rendered at the top of the Tasks panel on every rebuild.
993
+ let lastBeadsIdentity = null;
887
994
 
888
995
  function renderBeadsPanel() {
889
996
  const container = document.getElementById('extension-beads');
@@ -900,10 +1007,33 @@ export const beadsExtension = {
900
1007
  goalMax: lastBeadsData.goalMax,
901
1008
  decomposedParentIds: lastBeadsData.decomposedParentIds,
902
1009
  });
903
- container.innerHTML = renderProgressBarHtml(progress)
904
- + renderBeadsHtml(lastBeadsData.sprintTasks || [], lastBeadsData.backlogTasks || [], collapsedBeadIds);
1010
+ const progressHtml = renderProgressBarHtml(progress);
1011
+ // apra-fleet-vk0a.2: pinned into the FIXED panel-header row (a
1012
+ // sibling of the 'Tasks' label, core's generic per-extension
1013
+ // header hook -- \`id="panel-header-\${ext.id}-extra"\`, see
1014
+ // viewer/index.mjs) instead of re-rendered at the top of the
1015
+ // SCROLLABLE #extension-beads container on every poll -- so it
1016
+ // stays visible regardless of scroll position in a long task
1017
+ // list. Falls back to the pre-vk0a.2 inline placement when the
1018
+ // hook is absent (an older/mismatched core template), rather
1019
+ // than silently dropping the widget.
1020
+ const headerExtra = document.getElementById('panel-header-beads-extra');
1021
+ const identityHtml = renderBeadsIdentityHtml(lastBeadsIdentity);
1022
+ if (headerExtra) {
1023
+ headerExtra.innerHTML = progressHtml;
1024
+ container.innerHTML = identityHtml
1025
+ + renderBeadsHtml(lastBeadsData.sprintTasks || [], lastBeadsData.backlogTasks || [], collapsedBeadIds);
1026
+ } else {
1027
+ container.innerHTML = progressHtml + identityHtml
1028
+ + renderBeadsHtml(lastBeadsData.sprintTasks || [], lastBeadsData.backlogTasks || [], collapsedBeadIds);
1029
+ }
905
1030
  }
906
1031
 
1032
+ document.addEventListener('workflow:state:beadsIdentity', (e) => {
1033
+ lastBeadsIdentity = e.detail || null;
1034
+ renderBeadsPanel();
1035
+ });
1036
+
907
1037
  // Single document-level click-delegation listener (same rationale
908
1038
  // as the capture-phase 'toggle' listener above) catches every
909
1039
  // \`.tree-toggle\` click, including toggles on rows recreated by the