@apralabs/apra-fleet 0.3.6 → 0.4.1

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 (826) hide show
  1. package/README.md +378 -252
  2. package/dist/agents/backlog-groomer.md +303 -0
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +66 -13
  5. package/dist/agents/doer.md +67 -8
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +166 -60
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +88 -18
  10. package/dist/agents/planner.md +182 -19
  11. package/dist/agents/regression-test-runner.md +234 -0
  12. package/dist/agents/reviewer.md +125 -9
  13. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  14. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  15. package/dist/agents/schemas/doer-output.json +63 -3
  16. package/dist/agents/schemas/harvester-output.json +59 -2
  17. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  18. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  19. package/dist/agents/schemas/planner-output.json +65 -0
  20. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  21. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  22. package/dist/agents/schemas/reviewer-output.json +108 -7
  23. package/dist/cli/agent-transform.d.ts +1 -0
  24. package/dist/cli/agent-transform.d.ts.map +1 -1
  25. package/dist/cli/agent-transform.js +77 -0
  26. package/dist/cli/agent-transform.js.map +1 -1
  27. package/dist/cli/auth.d.ts +3 -0
  28. package/dist/cli/auth.d.ts.map +1 -1
  29. package/dist/cli/auth.js +181 -5
  30. package/dist/cli/auth.js.map +1 -1
  31. package/dist/cli/config.d.ts +5 -1
  32. package/dist/cli/config.d.ts.map +1 -1
  33. package/dist/cli/config.js +7 -1
  34. package/dist/cli/config.js.map +1 -1
  35. package/dist/cli/dolt-install.d.ts +91 -0
  36. package/dist/cli/dolt-install.d.ts.map +1 -0
  37. package/dist/cli/dolt-install.js +334 -0
  38. package/dist/cli/dolt-install.js.map +1 -0
  39. package/dist/cli/install-guard.d.ts +29 -0
  40. package/dist/cli/install-guard.d.ts.map +1 -0
  41. package/dist/cli/install-guard.js +153 -0
  42. package/dist/cli/install-guard.js.map +1 -0
  43. package/dist/cli/install.d.ts +45 -3
  44. package/dist/cli/install.d.ts.map +1 -1
  45. package/dist/cli/install.js +736 -109
  46. package/dist/cli/install.js.map +1 -1
  47. package/dist/cli/join.d.ts +12 -0
  48. package/dist/cli/join.d.ts.map +1 -0
  49. package/dist/cli/join.js +87 -0
  50. package/dist/cli/join.js.map +1 -0
  51. package/dist/cli/kb-commit.d.ts +12 -0
  52. package/dist/cli/kb-commit.d.ts.map +1 -0
  53. package/dist/cli/kb-commit.js +53 -0
  54. package/dist/cli/kb-commit.js.map +1 -0
  55. package/dist/cli/kb-directives.d.ts +17 -0
  56. package/dist/cli/kb-directives.d.ts.map +1 -0
  57. package/dist/cli/kb-directives.js +146 -0
  58. package/dist/cli/kb-directives.js.map +1 -0
  59. package/dist/cli/kb-import.d.ts +13 -0
  60. package/dist/cli/kb-import.d.ts.map +1 -0
  61. package/dist/cli/kb-import.js +56 -0
  62. package/dist/cli/kb-import.js.map +1 -0
  63. package/dist/cli/register-member.d.ts +2 -0
  64. package/dist/cli/register-member.d.ts.map +1 -0
  65. package/dist/cli/register-member.js +193 -0
  66. package/dist/cli/register-member.js.map +1 -0
  67. package/dist/cli/restart.d.ts +2 -0
  68. package/dist/cli/restart.d.ts.map +1 -0
  69. package/dist/cli/restart.js +7 -0
  70. package/dist/cli/restart.js.map +1 -0
  71. package/dist/cli/spoke.d.ts +35 -0
  72. package/dist/cli/spoke.d.ts.map +1 -0
  73. package/dist/cli/spoke.js +212 -0
  74. package/dist/cli/spoke.js.map +1 -0
  75. package/dist/cli/start.d.ts +2 -0
  76. package/dist/cli/start.d.ts.map +1 -0
  77. package/dist/cli/start.js +92 -0
  78. package/dist/cli/start.js.map +1 -0
  79. package/dist/cli/status.d.ts +2 -0
  80. package/dist/cli/status.d.ts.map +1 -0
  81. package/dist/cli/status.js +83 -0
  82. package/dist/cli/status.js.map +1 -0
  83. package/dist/cli/stop.d.ts +2 -0
  84. package/dist/cli/stop.d.ts.map +1 -0
  85. package/dist/cli/stop.js +51 -0
  86. package/dist/cli/stop.js.map +1 -0
  87. package/dist/cli/uninstall.d.ts.map +1 -1
  88. package/dist/cli/uninstall.js +120 -9
  89. package/dist/cli/uninstall.js.map +1 -1
  90. package/dist/cli/update.d.ts.map +1 -1
  91. package/dist/cli/update.js +10 -1
  92. package/dist/cli/update.js.map +1 -1
  93. package/dist/cli/watch.d.ts +53 -4
  94. package/dist/cli/watch.d.ts.map +1 -1
  95. package/dist/cli/watch.js +118 -17
  96. package/dist/cli/watch.js.map +1 -1
  97. package/dist/cli/workflow-assets.d.ts +37 -0
  98. package/dist/cli/workflow-assets.d.ts.map +1 -0
  99. package/dist/cli/workflow-assets.js +144 -0
  100. package/dist/cli/workflow-assets.js.map +1 -0
  101. package/dist/cli/workflow.d.ts +75 -0
  102. package/dist/cli/workflow.d.ts.map +1 -0
  103. package/dist/cli/workflow.js +397 -0
  104. package/dist/cli/workflow.js.map +1 -0
  105. package/dist/commands/kb-server.d.ts +8 -0
  106. package/dist/commands/kb-server.d.ts.map +1 -0
  107. package/dist/commands/kb-server.js +221 -0
  108. package/dist/commands/kb-server.js.map +1 -0
  109. package/dist/hub-service/activity.d.ts +30 -0
  110. package/dist/hub-service/activity.d.ts.map +1 -0
  111. package/dist/hub-service/activity.js +20 -0
  112. package/dist/hub-service/activity.js.map +1 -0
  113. package/dist/hub-service/audit-log.d.ts +19 -0
  114. package/dist/hub-service/audit-log.d.ts.map +1 -0
  115. package/dist/hub-service/audit-log.js +13 -0
  116. package/dist/hub-service/audit-log.js.map +1 -0
  117. package/dist/hub-service/db/pool.d.ts +19 -0
  118. package/dist/hub-service/db/pool.d.ts.map +1 -0
  119. package/dist/hub-service/db/pool.js +53 -0
  120. package/dist/hub-service/db/pool.js.map +1 -0
  121. package/dist/hub-service/enrollment.d.ts +29 -0
  122. package/dist/hub-service/enrollment.d.ts.map +1 -0
  123. package/dist/hub-service/enrollment.js +48 -0
  124. package/dist/hub-service/enrollment.js.map +1 -0
  125. package/dist/hub-service/envelope-routes.d.ts +46 -0
  126. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  127. package/dist/hub-service/envelope-routes.js +94 -0
  128. package/dist/hub-service/envelope-routes.js.map +1 -0
  129. package/dist/hub-service/handlers/installers.d.ts +14 -0
  130. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  131. package/dist/hub-service/handlers/installers.js +8 -0
  132. package/dist/hub-service/handlers/installers.js.map +1 -0
  133. package/dist/hub-service/http-server.d.ts +31 -0
  134. package/dist/hub-service/http-server.d.ts.map +1 -0
  135. package/dist/hub-service/http-server.js +711 -0
  136. package/dist/hub-service/http-server.js.map +1 -0
  137. package/dist/hub-service/hub-jwt.d.ts +30 -0
  138. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  139. package/dist/hub-service/hub-jwt.js +105 -0
  140. package/dist/hub-service/hub-jwt.js.map +1 -0
  141. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  142. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  143. package/dist/hub-service/jwt-revocation.js +18 -0
  144. package/dist/hub-service/jwt-revocation.js.map +1 -0
  145. package/dist/hub-service/machines.d.ts +16 -0
  146. package/dist/hub-service/machines.d.ts.map +1 -0
  147. package/dist/hub-service/machines.js +14 -0
  148. package/dist/hub-service/machines.js.map +1 -0
  149. package/dist/hub-service/main.d.ts +3 -0
  150. package/dist/hub-service/main.d.ts.map +1 -0
  151. package/dist/hub-service/main.js +64 -0
  152. package/dist/hub-service/main.js.map +1 -0
  153. package/dist/hub-service/member-tokens.d.ts +11 -0
  154. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  155. package/dist/hub-service/member-tokens.js +49 -0
  156. package/dist/hub-service/member-tokens.js.map +1 -0
  157. package/dist/hub-service/member-view.d.ts +20 -0
  158. package/dist/hub-service/member-view.d.ts.map +1 -0
  159. package/dist/hub-service/member-view.js +76 -0
  160. package/dist/hub-service/member-view.js.map +1 -0
  161. package/dist/hub-service/members.d.ts +44 -0
  162. package/dist/hub-service/members.d.ts.map +1 -0
  163. package/dist/hub-service/members.js +25 -0
  164. package/dist/hub-service/members.js.map +1 -0
  165. package/dist/hub-service/presence.d.ts +40 -0
  166. package/dist/hub-service/presence.d.ts.map +1 -0
  167. package/dist/hub-service/presence.js +44 -0
  168. package/dist/hub-service/presence.js.map +1 -0
  169. package/dist/hub-service/project-view.d.ts +12 -0
  170. package/dist/hub-service/project-view.d.ts.map +1 -0
  171. package/dist/hub-service/project-view.js +34 -0
  172. package/dist/hub-service/project-view.js.map +1 -0
  173. package/dist/hub-service/projects.d.ts +48 -0
  174. package/dist/hub-service/projects.d.ts.map +1 -0
  175. package/dist/hub-service/projects.js +80 -0
  176. package/dist/hub-service/projects.js.map +1 -0
  177. package/dist/hub-service/relay-queue.d.ts +115 -0
  178. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  179. package/dist/hub-service/relay-queue.js +148 -0
  180. package/dist/hub-service/relay-queue.js.map +1 -0
  181. package/dist/hub-service/session-jwt.d.ts +10 -0
  182. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  183. package/dist/hub-service/session-jwt.js +69 -0
  184. package/dist/hub-service/session-jwt.js.map +1 -0
  185. package/dist/hub-service/usage.d.ts +40 -0
  186. package/dist/hub-service/usage.d.ts.map +1 -0
  187. package/dist/hub-service/usage.js +25 -0
  188. package/dist/hub-service/usage.js.map +1 -0
  189. package/dist/hub-service/users.d.ts +56 -0
  190. package/dist/hub-service/users.d.ts.map +1 -0
  191. package/dist/hub-service/users.js +72 -0
  192. package/dist/hub-service/users.js.map +1 -0
  193. package/dist/hub-service/workspaces.d.ts +20 -0
  194. package/dist/hub-service/workspaces.d.ts.map +1 -0
  195. package/dist/hub-service/workspaces.js +10 -0
  196. package/dist/hub-service/workspaces.js.map +1 -0
  197. package/dist/index.js +254 -132
  198. package/dist/index.js.map +1 -1
  199. package/dist/os/linux.d.ts +14 -0
  200. package/dist/os/linux.d.ts.map +1 -1
  201. package/dist/os/linux.js +80 -4
  202. package/dist/os/linux.js.map +1 -1
  203. package/dist/os/os-commands.d.ts +15 -0
  204. package/dist/os/os-commands.d.ts.map +1 -1
  205. package/dist/os/windows.d.ts +36 -0
  206. package/dist/os/windows.d.ts.map +1 -1
  207. package/dist/os/windows.js +74 -18
  208. package/dist/os/windows.js.map +1 -1
  209. package/dist/paths.d.ts +23 -0
  210. package/dist/paths.d.ts.map +1 -1
  211. package/dist/paths.js +29 -0
  212. package/dist/paths.js.map +1 -1
  213. package/dist/providers/agy.d.ts +20 -2
  214. package/dist/providers/agy.d.ts.map +1 -1
  215. package/dist/providers/agy.js +259 -21
  216. package/dist/providers/agy.js.map +1 -1
  217. package/dist/providers/claude.d.ts +16 -2
  218. package/dist/providers/claude.d.ts.map +1 -1
  219. package/dist/providers/claude.js +283 -16
  220. package/dist/providers/claude.js.map +1 -1
  221. package/dist/providers/codex.d.ts +13 -2
  222. package/dist/providers/codex.d.ts.map +1 -1
  223. package/dist/providers/codex.js +36 -6
  224. package/dist/providers/codex.js.map +1 -1
  225. package/dist/providers/copilot.d.ts +13 -2
  226. package/dist/providers/copilot.d.ts.map +1 -1
  227. package/dist/providers/copilot.js +34 -7
  228. package/dist/providers/copilot.js.map +1 -1
  229. package/dist/providers/email/headers.d.ts +15 -0
  230. package/dist/providers/email/headers.d.ts.map +1 -0
  231. package/dist/providers/email/headers.js +42 -0
  232. package/dist/providers/email/headers.js.map +1 -0
  233. package/dist/providers/email/index.d.ts +18 -0
  234. package/dist/providers/email/index.d.ts.map +1 -0
  235. package/dist/providers/email/index.js +60 -0
  236. package/dist/providers/email/index.js.map +1 -0
  237. package/dist/providers/email/provider.d.ts +49 -0
  238. package/dist/providers/email/provider.d.ts.map +1 -0
  239. package/dist/providers/email/provider.js +2 -0
  240. package/dist/providers/email/provider.js.map +1 -0
  241. package/dist/providers/email/sendgrid.d.ts +12 -0
  242. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  243. package/dist/providers/email/sendgrid.js +67 -0
  244. package/dist/providers/email/sendgrid.js.map +1 -0
  245. package/dist/providers/email/smtp.d.ts +65 -0
  246. package/dist/providers/email/smtp.d.ts.map +1 -0
  247. package/dist/providers/email/smtp.js +373 -0
  248. package/dist/providers/email/smtp.js.map +1 -0
  249. package/dist/providers/gemini.d.ts +13 -2
  250. package/dist/providers/gemini.d.ts.map +1 -1
  251. package/dist/providers/gemini.js +49 -5
  252. package/dist/providers/gemini.js.map +1 -1
  253. package/dist/providers/index.d.ts +1 -0
  254. package/dist/providers/index.d.ts.map +1 -1
  255. package/dist/providers/index.js +3 -0
  256. package/dist/providers/index.js.map +1 -1
  257. package/dist/providers/none.d.ts +61 -0
  258. package/dist/providers/none.d.ts.map +1 -0
  259. package/dist/providers/none.js +124 -0
  260. package/dist/providers/none.js.map +1 -0
  261. package/dist/providers/opencode.d.ts +14 -2
  262. package/dist/providers/opencode.d.ts.map +1 -1
  263. package/dist/providers/opencode.js +104 -4
  264. package/dist/providers/opencode.js.map +1 -1
  265. package/dist/providers/provider.d.ts +156 -1
  266. package/dist/providers/provider.d.ts.map +1 -1
  267. package/dist/providers/provider.js +54 -0
  268. package/dist/providers/provider.js.map +1 -1
  269. package/dist/services/agent-provisioner.d.ts +3 -3
  270. package/dist/services/agent-provisioner.d.ts.map +1 -1
  271. package/dist/services/agent-provisioner.js +11 -7
  272. package/dist/services/agent-provisioner.js.map +1 -1
  273. package/dist/services/auth-socket.d.ts.map +1 -1
  274. package/dist/services/auth-socket.js +2 -0
  275. package/dist/services/auth-socket.js.map +1 -1
  276. package/dist/services/budget-awareness.d.ts +130 -0
  277. package/dist/services/budget-awareness.d.ts.map +1 -0
  278. package/dist/services/budget-awareness.js +129 -0
  279. package/dist/services/budget-awareness.js.map +1 -0
  280. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  281. package/dist/services/cloud/lifecycle.js +3 -0
  282. package/dist/services/cloud/lifecycle.js.map +1 -1
  283. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  284. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  285. package/dist/services/cloud/task-wrapper.js +157 -0
  286. package/dist/services/cloud/task-wrapper.js.map +1 -1
  287. package/dist/services/cloud-sync.d.ts +35 -0
  288. package/dist/services/cloud-sync.d.ts.map +1 -0
  289. package/dist/services/cloud-sync.js +90 -0
  290. package/dist/services/cloud-sync.js.map +1 -0
  291. package/dist/services/context-admission.d.ts +82 -0
  292. package/dist/services/context-admission.d.ts.map +1 -0
  293. package/dist/services/context-admission.js +136 -0
  294. package/dist/services/context-admission.js.map +1 -0
  295. package/dist/services/event-bus.d.ts +27 -0
  296. package/dist/services/event-bus.d.ts.map +1 -0
  297. package/dist/services/event-bus.js +20 -0
  298. package/dist/services/event-bus.js.map +1 -0
  299. package/dist/services/file-chunker.d.ts +38 -0
  300. package/dist/services/file-chunker.d.ts.map +1 -0
  301. package/dist/services/file-chunker.js +63 -0
  302. package/dist/services/file-chunker.js.map +1 -0
  303. package/dist/services/file-transfer-relay.d.ts +55 -0
  304. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  305. package/dist/services/file-transfer-relay.js +115 -0
  306. package/dist/services/file-transfer-relay.js.map +1 -0
  307. package/dist/services/github-app.d.ts.map +1 -1
  308. package/dist/services/github-app.js +12 -2
  309. package/dist/services/github-app.js.map +1 -1
  310. package/dist/services/http-transport.d.ts +25 -0
  311. package/dist/services/http-transport.d.ts.map +1 -0
  312. package/dist/services/http-transport.js +371 -0
  313. package/dist/services/http-transport.js.map +1 -0
  314. package/dist/services/hub-client.d.ts +69 -0
  315. package/dist/services/hub-client.d.ts.map +1 -0
  316. package/dist/services/hub-client.js +217 -0
  317. package/dist/services/hub-client.js.map +1 -0
  318. package/dist/services/jwt.d.ts +17 -0
  319. package/dist/services/jwt.d.ts.map +1 -0
  320. package/dist/services/jwt.js +70 -0
  321. package/dist/services/jwt.js.map +1 -0
  322. package/dist/services/knowledge/audn.d.ts +37 -0
  323. package/dist/services/knowledge/audn.d.ts.map +1 -0
  324. package/dist/services/knowledge/audn.js +219 -0
  325. package/dist/services/knowledge/audn.js.map +1 -0
  326. package/dist/services/knowledge/file-hash.d.ts +11 -0
  327. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  328. package/dist/services/knowledge/file-hash.js +123 -0
  329. package/dist/services/knowledge/file-hash.js.map +1 -0
  330. package/dist/services/knowledge/http-provider.d.ts +46 -0
  331. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  332. package/dist/services/knowledge/http-provider.js +254 -0
  333. package/dist/services/knowledge/http-provider.js.map +1 -0
  334. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  335. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  336. package/dist/services/knowledge/kb-providers.js +92 -0
  337. package/dist/services/knowledge/kb-providers.js.map +1 -0
  338. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  339. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  340. package/dist/services/knowledge/kb-scope-input.js +11 -0
  341. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  342. package/dist/services/knowledge/kb-service.d.ts +3 -0
  343. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  344. package/dist/services/knowledge/kb-service.js +2 -0
  345. package/dist/services/knowledge/kb-service.js.map +1 -0
  346. package/dist/services/knowledge/path-validation.d.ts +2 -0
  347. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  348. package/dist/services/knowledge/path-validation.js +13 -0
  349. package/dist/services/knowledge/path-validation.js.map +1 -0
  350. package/dist/services/knowledge/pre-init.d.ts +14 -0
  351. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  352. package/dist/services/knowledge/pre-init.js +147 -0
  353. package/dist/services/knowledge/pre-init.js.map +1 -0
  354. package/dist/services/knowledge/project-slug.d.ts +2 -0
  355. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  356. package/dist/services/knowledge/project-slug.js +49 -0
  357. package/dist/services/knowledge/project-slug.js.map +1 -0
  358. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  359. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  360. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  361. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  362. package/dist/services/knowledge/types.d.ts +163 -0
  363. package/dist/services/knowledge/types.d.ts.map +1 -0
  364. package/dist/services/knowledge/types.js +9 -0
  365. package/dist/services/knowledge/types.js.map +1 -0
  366. package/dist/services/known-sessions.d.ts +8 -0
  367. package/dist/services/known-sessions.d.ts.map +1 -0
  368. package/dist/services/known-sessions.js +40 -0
  369. package/dist/services/known-sessions.js.map +1 -0
  370. package/dist/services/member-home.d.ts +89 -0
  371. package/dist/services/member-home.d.ts.map +1 -0
  372. package/dist/services/member-home.js +256 -0
  373. package/dist/services/member-home.js.map +1 -0
  374. package/dist/services/member-remote-url.d.ts +34 -0
  375. package/dist/services/member-remote-url.d.ts.map +1 -0
  376. package/dist/services/member-remote-url.js +39 -0
  377. package/dist/services/member-remote-url.js.map +1 -0
  378. package/dist/services/model-pricing.d.ts +36 -0
  379. package/dist/services/model-pricing.d.ts.map +1 -0
  380. package/dist/services/model-pricing.js +108 -0
  381. package/dist/services/model-pricing.js.map +1 -0
  382. package/dist/services/orphan-recovery.d.ts +59 -0
  383. package/dist/services/orphan-recovery.d.ts.map +1 -0
  384. package/dist/services/orphan-recovery.js +122 -0
  385. package/dist/services/orphan-recovery.js.map +1 -0
  386. package/dist/services/pending-responses.d.ts +23 -0
  387. package/dist/services/pending-responses.d.ts.map +1 -0
  388. package/dist/services/pending-responses.js +52 -0
  389. package/dist/services/pending-responses.js.map +1 -0
  390. package/dist/services/preflight-check.d.ts +56 -0
  391. package/dist/services/preflight-check.d.ts.map +1 -0
  392. package/dist/services/preflight-check.js +277 -0
  393. package/dist/services/preflight-check.js.map +1 -0
  394. package/dist/services/registry.d.ts +4 -1
  395. package/dist/services/registry.d.ts.map +1 -1
  396. package/dist/services/registry.js +3 -0
  397. package/dist/services/registry.js.map +1 -1
  398. package/dist/services/relay-context.d.ts +23 -0
  399. package/dist/services/relay-context.d.ts.map +1 -0
  400. package/dist/services/relay-context.js +8 -0
  401. package/dist/services/relay-context.js.map +1 -0
  402. package/dist/services/relay-executor.d.ts +68 -0
  403. package/dist/services/relay-executor.d.ts.map +1 -0
  404. package/dist/services/relay-executor.js +70 -0
  405. package/dist/services/relay-executor.js.map +1 -0
  406. package/dist/services/relay-request.d.ts +65 -0
  407. package/dist/services/relay-request.d.ts.map +1 -0
  408. package/dist/services/relay-request.js +129 -0
  409. package/dist/services/relay-request.js.map +1 -0
  410. package/dist/services/relay-strategy.d.ts +19 -0
  411. package/dist/services/relay-strategy.d.ts.map +1 -0
  412. package/dist/services/relay-strategy.js +111 -0
  413. package/dist/services/relay-strategy.js.map +1 -0
  414. package/dist/services/service-manager/index.d.ts +5 -0
  415. package/dist/services/service-manager/index.d.ts.map +1 -0
  416. package/dist/services/service-manager/index.js +66 -0
  417. package/dist/services/service-manager/index.js.map +1 -0
  418. package/dist/services/service-manager/linux.d.ts +10 -0
  419. package/dist/services/service-manager/linux.d.ts.map +1 -0
  420. package/dist/services/service-manager/linux.js +97 -0
  421. package/dist/services/service-manager/linux.js.map +1 -0
  422. package/dist/services/service-manager/macos.d.ts +10 -0
  423. package/dist/services/service-manager/macos.d.ts.map +1 -0
  424. package/dist/services/service-manager/macos.js +94 -0
  425. package/dist/services/service-manager/macos.js.map +1 -0
  426. package/dist/services/service-manager/types.d.ts +18 -0
  427. package/dist/services/service-manager/types.d.ts.map +1 -0
  428. package/dist/services/service-manager/types.js +5 -0
  429. package/dist/services/service-manager/types.js.map +1 -0
  430. package/dist/services/service-manager/windows.d.ts +10 -0
  431. package/dist/services/service-manager/windows.d.ts.map +1 -0
  432. package/dist/services/service-manager/windows.js +73 -0
  433. package/dist/services/service-manager/windows.js.map +1 -0
  434. package/dist/services/session-registry.d.ts +70 -0
  435. package/dist/services/session-registry.d.ts.map +1 -0
  436. package/dist/services/session-registry.js +91 -0
  437. package/dist/services/session-registry.js.map +1 -0
  438. package/dist/services/singleton.d.ts +15 -0
  439. package/dist/services/singleton.d.ts.map +1 -0
  440. package/dist/services/singleton.js +98 -0
  441. package/dist/services/singleton.js.map +1 -0
  442. package/dist/services/sprint-coordination.d.ts +168 -0
  443. package/dist/services/sprint-coordination.d.ts.map +1 -0
  444. package/dist/services/sprint-coordination.js +564 -0
  445. package/dist/services/sprint-coordination.js.map +1 -0
  446. package/dist/services/ssh.d.ts.map +1 -1
  447. package/dist/services/ssh.js +70 -3
  448. package/dist/services/ssh.js.map +1 -1
  449. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  450. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  451. package/dist/services/stall/log-path-resolver.js +17 -33
  452. package/dist/services/stall/log-path-resolver.js.map +1 -1
  453. package/dist/services/stall/stall-detector.d.ts +32 -0
  454. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  455. package/dist/services/stall/stall-detector.js +187 -12
  456. package/dist/services/stall/stall-detector.js.map +1 -1
  457. package/dist/services/stall/stall-poller.d.ts +50 -0
  458. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  459. package/dist/services/stall/stall-poller.js +268 -18
  460. package/dist/services/stall/stall-poller.js.map +1 -1
  461. package/dist/services/strategy.d.ts.map +1 -1
  462. package/dist/services/strategy.js +57 -7
  463. package/dist/services/strategy.js.map +1 -1
  464. package/dist/services/substitution-engine.d.ts +20 -0
  465. package/dist/services/substitution-engine.d.ts.map +1 -0
  466. package/dist/services/substitution-engine.js +92 -0
  467. package/dist/services/substitution-engine.js.map +1 -0
  468. package/dist/services/task-cleanup.d.ts.map +1 -1
  469. package/dist/services/task-cleanup.js +1 -9
  470. package/dist/services/task-cleanup.js.map +1 -1
  471. package/dist/services/token-issuer.d.ts +47 -0
  472. package/dist/services/token-issuer.d.ts.map +1 -0
  473. package/dist/services/token-issuer.js +63 -0
  474. package/dist/services/token-issuer.js.map +1 -0
  475. package/dist/services/tool-registry.d.ts +3 -0
  476. package/dist/services/tool-registry.d.ts.map +1 -0
  477. package/dist/services/tool-registry.js +225 -0
  478. package/dist/services/tool-registry.js.map +1 -0
  479. package/dist/services/user-config.d.ts +14 -0
  480. package/dist/services/user-config.d.ts.map +1 -1
  481. package/dist/services/user-config.js +55 -0
  482. package/dist/services/user-config.js.map +1 -1
  483. package/dist/services/vcs/github.d.ts.map +1 -1
  484. package/dist/services/vcs/github.js +32 -1
  485. package/dist/services/vcs/github.js.map +1 -1
  486. package/dist/services/vcs/types.d.ts +44 -0
  487. package/dist/services/vcs/types.d.ts.map +1 -1
  488. package/dist/services/version-check.d.ts +22 -0
  489. package/dist/services/version-check.d.ts.map +1 -0
  490. package/dist/services/version-check.js +103 -0
  491. package/dist/services/version-check.js.map +1 -0
  492. package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
  493. package/dist/skills/pm/beads.md +6 -0
  494. package/dist/skills/pm/cost.md +3 -0
  495. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  496. package/dist/skills/pm/fleet-addendum.md +6 -0
  497. package/dist/skills/pm/index.md +56 -0
  498. package/dist/skills/pm/kb-reconcile.md +132 -0
  499. package/dist/skills/pm/kb-review.md +109 -0
  500. package/dist/tools/check-status.d.ts +47 -0
  501. package/dist/tools/check-status.d.ts.map +1 -1
  502. package/dist/tools/check-status.js +250 -2
  503. package/dist/tools/check-status.js.map +1 -1
  504. package/dist/tools/child-id-allocator.d.ts +45 -0
  505. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  506. package/dist/tools/child-id-allocator.js +62 -0
  507. package/dist/tools/child-id-allocator.js.map +1 -0
  508. package/dist/tools/cloud-control.d.ts +2 -2
  509. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  510. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  511. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  512. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  513. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  514. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  515. package/dist/tools/code-intelligence-freshness.js +26 -0
  516. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  517. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  518. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  519. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  520. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  521. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  522. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  523. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  524. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  525. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  526. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  527. package/dist/tools/code-intelligence-reindex.js +106 -0
  528. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  529. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  530. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  531. package/dist/tools/code-intelligence-telemetry.js +52 -0
  532. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  533. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  534. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  535. package/dist/tools/code-intelligence-tests.js +24 -0
  536. package/dist/tools/code-intelligence-tests.js.map +1 -0
  537. package/dist/tools/code-intelligence.d.ts +114 -0
  538. package/dist/tools/code-intelligence.d.ts.map +1 -0
  539. package/dist/tools/code-intelligence.js +124 -0
  540. package/dist/tools/code-intelligence.js.map +1 -0
  541. package/dist/tools/compose-permissions.d.ts +38 -4
  542. package/dist/tools/compose-permissions.d.ts.map +1 -1
  543. package/dist/tools/compose-permissions.js +295 -33
  544. package/dist/tools/compose-permissions.js.map +1 -1
  545. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  546. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  547. package/dist/tools/dolt-push-mutex.js +83 -0
  548. package/dist/tools/dolt-push-mutex.js.map +1 -0
  549. package/dist/tools/execute-command.d.ts +13 -1
  550. package/dist/tools/execute-command.d.ts.map +1 -1
  551. package/dist/tools/execute-command.js +108 -21
  552. package/dist/tools/execute-command.js.map +1 -1
  553. package/dist/tools/execute-prompt.d.ts +84 -12
  554. package/dist/tools/execute-prompt.d.ts.map +1 -1
  555. package/dist/tools/execute-prompt.js +1191 -88
  556. package/dist/tools/execute-prompt.js.map +1 -1
  557. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  558. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  559. package/dist/tools/get-member-model-pricing.js +29 -0
  560. package/dist/tools/get-member-model-pricing.js.map +1 -0
  561. package/dist/tools/kb-capture.d.ts +53 -0
  562. package/dist/tools/kb-capture.d.ts.map +1 -0
  563. package/dist/tools/kb-capture.js +130 -0
  564. package/dist/tools/kb-capture.js.map +1 -0
  565. package/dist/tools/kb-context.d.ts +17 -0
  566. package/dist/tools/kb-context.d.ts.map +1 -0
  567. package/dist/tools/kb-context.js +29 -0
  568. package/dist/tools/kb-context.js.map +1 -0
  569. package/dist/tools/kb-export.d.ts +19 -0
  570. package/dist/tools/kb-export.d.ts.map +1 -0
  571. package/dist/tools/kb-export.js +344 -0
  572. package/dist/tools/kb-export.js.map +1 -0
  573. package/dist/tools/kb-feedback.d.ts +23 -0
  574. package/dist/tools/kb-feedback.d.ts.map +1 -0
  575. package/dist/tools/kb-feedback.js +43 -0
  576. package/dist/tools/kb-feedback.js.map +1 -0
  577. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  578. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  579. package/dist/tools/kb-freshness-sweep.js +29 -0
  580. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  581. package/dist/tools/kb-harvest.d.ts +20 -0
  582. package/dist/tools/kb-harvest.d.ts.map +1 -0
  583. package/dist/tools/kb-harvest.js +143 -0
  584. package/dist/tools/kb-harvest.js.map +1 -0
  585. package/dist/tools/kb-import.d.ts +44 -0
  586. package/dist/tools/kb-import.d.ts.map +1 -0
  587. package/dist/tools/kb-import.js +239 -0
  588. package/dist/tools/kb-import.js.map +1 -0
  589. package/dist/tools/kb-invalidate.d.ts +19 -0
  590. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  591. package/dist/tools/kb-invalidate.js +34 -0
  592. package/dist/tools/kb-invalidate.js.map +1 -0
  593. package/dist/tools/kb-list.d.ts +32 -0
  594. package/dist/tools/kb-list.d.ts.map +1 -0
  595. package/dist/tools/kb-list.js +43 -0
  596. package/dist/tools/kb-list.js.map +1 -0
  597. package/dist/tools/kb-promote.d.ts +20 -0
  598. package/dist/tools/kb-promote.d.ts.map +1 -0
  599. package/dist/tools/kb-promote.js +20 -0
  600. package/dist/tools/kb-promote.js.map +1 -0
  601. package/dist/tools/kb-query.d.ts +35 -0
  602. package/dist/tools/kb-query.d.ts.map +1 -0
  603. package/dist/tools/kb-query.js +111 -0
  604. package/dist/tools/kb-query.js.map +1 -0
  605. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  606. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  607. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  608. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  609. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  610. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  611. package/dist/tools/kb-resolve-contradiction.js +37 -0
  612. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  613. package/dist/tools/kb-session-prime.d.ts +26 -0
  614. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  615. package/dist/tools/kb-session-prime.js +392 -0
  616. package/dist/tools/kb-session-prime.js.map +1 -0
  617. package/dist/tools/kb-setup.d.ts +20 -0
  618. package/dist/tools/kb-setup.d.ts.map +1 -0
  619. package/dist/tools/kb-setup.js +49 -0
  620. package/dist/tools/kb-setup.js.map +1 -0
  621. package/dist/tools/kb-stats.d.ts +20 -0
  622. package/dist/tools/kb-stats.d.ts.map +1 -0
  623. package/dist/tools/kb-stats.js +115 -0
  624. package/dist/tools/kb-stats.js.map +1 -0
  625. package/dist/tools/list-members.d.ts.map +1 -1
  626. package/dist/tools/list-members.js +39 -7
  627. package/dist/tools/list-members.js.map +1 -1
  628. package/dist/tools/member-detail.d.ts +1 -1
  629. package/dist/tools/member-detail.d.ts.map +1 -1
  630. package/dist/tools/member-detail.js +16 -2
  631. package/dist/tools/member-detail.js.map +1 -1
  632. package/dist/tools/member-reservation.d.ts +29 -0
  633. package/dist/tools/member-reservation.d.ts.map +1 -0
  634. package/dist/tools/member-reservation.js +71 -0
  635. package/dist/tools/member-reservation.js.map +1 -0
  636. package/dist/tools/monitor-task.d.ts.map +1 -1
  637. package/dist/tools/monitor-task.js +21 -3
  638. package/dist/tools/monitor-task.js.map +1 -1
  639. package/dist/tools/provision-auth.d.ts.map +1 -1
  640. package/dist/tools/provision-auth.js +10 -3
  641. package/dist/tools/provision-auth.js.map +1 -1
  642. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  643. package/dist/tools/provision-vcs-auth.js +1 -1
  644. package/dist/tools/provision-vcs-auth.js.map +1 -1
  645. package/dist/tools/register-member.d.ts +20 -5
  646. package/dist/tools/register-member.d.ts.map +1 -1
  647. package/dist/tools/register-member.js +174 -6
  648. package/dist/tools/register-member.js.map +1 -1
  649. package/dist/tools/remove-member.d.ts +1 -1
  650. package/dist/tools/remove-member.d.ts.map +1 -1
  651. package/dist/tools/remove-member.js +17 -3
  652. package/dist/tools/remove-member.js.map +1 -1
  653. package/dist/tools/report-status.d.ts +33 -0
  654. package/dist/tools/report-status.d.ts.map +1 -0
  655. package/dist/tools/report-status.js +45 -0
  656. package/dist/tools/report-status.js.map +1 -0
  657. package/dist/tools/respond-to-message.d.ts +21 -0
  658. package/dist/tools/respond-to-message.d.ts.map +1 -0
  659. package/dist/tools/respond-to-message.js +23 -0
  660. package/dist/tools/respond-to-message.js.map +1 -0
  661. package/dist/tools/send-email.d.ts +69 -0
  662. package/dist/tools/send-email.d.ts.map +1 -0
  663. package/dist/tools/send-email.js +177 -0
  664. package/dist/tools/send-email.js.map +1 -0
  665. package/dist/tools/send-files.d.ts +3 -0
  666. package/dist/tools/send-files.d.ts.map +1 -1
  667. package/dist/tools/send-files.js +88 -8
  668. package/dist/tools/send-files.js.map +1 -1
  669. package/dist/tools/send-message.d.ts +27 -0
  670. package/dist/tools/send-message.d.ts.map +1 -0
  671. package/dist/tools/send-message.js +46 -0
  672. package/dist/tools/send-message.js.map +1 -0
  673. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  674. package/dist/tools/setup-ssh-key.js +2 -0
  675. package/dist/tools/setup-ssh-key.js.map +1 -1
  676. package/dist/tools/shutdown-server.d.ts +2 -0
  677. package/dist/tools/shutdown-server.d.ts.map +1 -1
  678. package/dist/tools/shutdown-server.js +19 -0
  679. package/dist/tools/shutdown-server.js.map +1 -1
  680. package/dist/tools/update-member.d.ts +11 -8
  681. package/dist/tools/update-member.d.ts.map +1 -1
  682. package/dist/tools/update-member.js +36 -2
  683. package/dist/tools/update-member.js.map +1 -1
  684. package/dist/types.d.ts +16 -3
  685. package/dist/types.d.ts.map +1 -1
  686. package/dist/utils/agent-helpers.d.ts +2 -1
  687. package/dist/utils/agent-helpers.d.ts.map +1 -1
  688. package/dist/utils/agent-helpers.js +7 -2
  689. package/dist/utils/agent-helpers.js.map +1 -1
  690. package/dist/utils/pid-helpers.d.ts +15 -0
  691. package/dist/utils/pid-helpers.d.ts.map +1 -1
  692. package/dist/utils/pid-helpers.js +23 -0
  693. package/dist/utils/pid-helpers.js.map +1 -1
  694. package/dist/utils/process-utils.d.ts +3 -0
  695. package/dist/utils/process-utils.d.ts.map +1 -0
  696. package/dist/utils/process-utils.js +42 -0
  697. package/dist/utils/process-utils.js.map +1 -0
  698. package/dist/utils/prompt-errors.d.ts +2 -1
  699. package/dist/utils/prompt-errors.d.ts.map +1 -1
  700. package/dist/utils/prompt-errors.js +13 -3
  701. package/dist/utils/prompt-errors.js.map +1 -1
  702. package/dist/utils/session-caller.d.ts +28 -0
  703. package/dist/utils/session-caller.d.ts.map +1 -0
  704. package/dist/utils/session-caller.js +24 -0
  705. package/dist/utils/session-caller.js.map +1 -0
  706. package/dist/utils/work-folder-validation.d.ts +39 -0
  707. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  708. package/dist/utils/work-folder-validation.js +60 -0
  709. package/dist/utils/work-folder-validation.js.map +1 -0
  710. package/dist/utils/workspace-trust.d.ts +24 -0
  711. package/dist/utils/workspace-trust.d.ts.map +1 -0
  712. package/dist/utils/workspace-trust.js +35 -0
  713. package/dist/utils/workspace-trust.js.map +1 -0
  714. package/dist/workflows/auto-sprint.js +994 -91
  715. package/package.json +40 -9
  716. package/packages/apra-fleet-client/package.json +26 -0
  717. package/packages/apra-fleet-client/src/client/api.mjs +510 -0
  718. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  719. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  720. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  721. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  722. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  723. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
  724. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
  725. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
  726. package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
  727. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
  728. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
  729. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  730. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
  731. package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
  732. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
  733. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
  734. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  735. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  736. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  737. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  738. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  739. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  740. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  741. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
  742. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  743. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
  744. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  745. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  746. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  747. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  748. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  749. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  750. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  751. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  752. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  753. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
  754. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  755. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
  756. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  757. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  758. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
  759. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  760. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  761. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  762. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  763. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  764. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  765. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  766. package/packages/apra-fleet-se/bin/cli.mjs +864 -0
  767. package/packages/apra-fleet-se/bin/serve.mjs +395 -0
  768. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  769. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
  770. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  771. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  772. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
  773. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  774. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  775. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  776. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  777. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  778. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  779. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  780. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  781. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
  782. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
  783. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  784. package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
  785. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
  786. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  787. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  788. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  789. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  790. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  791. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  792. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  793. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  794. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
  795. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  796. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
  797. package/packages/apra-fleet-se/package.json +29 -0
  798. package/packages/apra-fleet-se/workflow.json +1 -0
  799. package/packages/apra-fleet-workflow/package.json +30 -0
  800. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  801. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  802. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  803. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
  804. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  805. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  806. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  807. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  808. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  809. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  810. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
  811. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  812. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  813. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  814. package/scripts/agy-transcript-reader.js +1 -0
  815. package/scripts/fleet-statusline.sh +17 -13
  816. package/skills/fleet/SKILL.md +37 -2
  817. package/skills/fleet/beads.md +14 -7
  818. package/skills/fleet/knowledge-agent.md +66 -0
  819. package/skills/fleet/permissions.md +76 -2
  820. package/skills/fleet/profiles/base-dev.json +11 -1
  821. package/skills/fleet/profiles/base-reviewer.json +9 -1
  822. package/skills/fleet/profiles/node.json +2 -2
  823. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  824. package/version.json +1 -1
  825. package/scripts/agy-settings-merge.js +0 -27
  826. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,942 @@
1
+ import { escapeHtml } from '@apralabs/apra-fleet-workflow/viewer/html-utils';
2
+ import { computeSprintProgress } from './sprint-progress.mjs';
3
+
4
+ /**
5
+ * apra-fleet-x8r.1: pure HTML-string builder for the beads-closed/required
6
+ * progress-bar widget in the single-sprint viewer's extension area. Takes
7
+ * the ALREADY-COMPUTED `{ closed, required, fraction }` shape
8
+ * `computeSprintProgress()` returns -- never re-derives scope or counts
9
+ * itself -- and renders a horizontal bar that fills left-to-right by
10
+ * `fraction`, plus the numeric 'M/N' text. Styled with the viewer's existing
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.
13
+ *
14
+ * @param {{ closed: number, required: number, fraction: number }} progress
15
+ * @returns {string}
16
+ */
17
+ export function renderProgressBarHtml(progress) {
18
+ const p = progress || { closed: 0, required: 0, fraction: 0 };
19
+ const closed = typeof p.closed === 'number' && Number.isFinite(p.closed) ? p.closed : 0;
20
+ const required = typeof p.required === 'number' && Number.isFinite(p.required) ? p.required : 0;
21
+ const fraction = typeof p.fraction === 'number' && Number.isFinite(p.fraction) ? p.fraction : 0;
22
+ const pct = Math.max(0, Math.min(1, fraction)) * 100;
23
+ return (
24
+ '<div class="sprint-progress" style="display: flex; align-items: center; gap: 8px; padding: 8px; font-size: 12px;">' +
25
+ '<div style="flex: 1; height: 8px; background: var(--bg); border: 1px solid var(--bg-glass); border-radius: 4px; overflow: hidden;">' +
26
+ '<div style="width: ' + pct + '%; height: 100%; background: var(--accent);"></div>' +
27
+ '</div>' +
28
+ '<div style="color: #a1a1aa; white-space: nowrap;">' + closed + '/' + required + '</div>' +
29
+ '</div>'
30
+ );
31
+ }
32
+
33
+ /**
34
+ * Pure HTML-string builder for the beads task tree (apra-fleet-unw.10,
35
+ * F9/A7-viewer).
36
+ *
37
+ * Bead `id`/`title`/`description`/`status` are LLM-authored (or otherwise
38
+ * untrusted) and were previously interpolated into `innerHTML` unescaped --
39
+ * an XSS risk, since the same dashboard page also exposes the `/stop`
40
+ * capability. Every bead-derived field is now run through the shared
41
+ * `escapeHtml()` (packages/apra-fleet-workflow/src/viewer/html-utils.mjs)
42
+ * before being placed into the returned HTML string.
43
+ *
44
+ * This function only builds and returns a string via concatenation -- it
45
+ * never touches `document` -- so it can be (and is, see
46
+ * test/viewer-extensions.test.mjs) unit-tested directly under Node without a
47
+ * browser/DOM/jsdom dependency.
48
+ *
49
+ * The identical implementation also has to run in the browser, inside the
50
+ * extension's plain (non-module) `<script>` tag, which cannot `import` this
51
+ * file at runtime. Rather than hand-duplicating the logic, its source text
52
+ * is embedded into that `<script>` tag via `.toString()` (see `js` below),
53
+ * the same pattern `escapeHtml` itself uses -- one implementation, not two
54
+ * kept in sync by hand. All helper functions (badge builders, tree
55
+ * construction) are nested INSIDE renderBeadsHtml rather than module-level,
56
+ * so that single `.toString()` embed captures everything -- no second
57
+ * function needs its own embed.
58
+ *
59
+ * Tree is built from each task's `parent` field (bd's real parent-child
60
+ * containment, e.g. a `[test]` task nested under its owning bug/feature),
61
+ * not from `blocks`-type dependency edges -- the user-facing goal is "show
62
+ * me epic->task nesting" (containment), not "show me what unblocks what"
63
+ * (ordering). A task with no in-dataset parent is a root. `blocks`-type
64
+ * edges are a real DAG (a task can have multiple blockers) with no bearing
65
+ * on tree placement; every blocker is instead listed inline as a compact
66
+ * "blocked by" badge on the row, so no dependency/ordering information is
67
+ * lost even though it is no longer used for nesting. Multiple top-level
68
+ * roots (tasks with no in-dataset parent) render as multiple top-level
69
+ * rows -- this is expected, not an error, whenever a sprint targets more
70
+ * than one independent top-level item at once. apra-fleet-eft.52.1.2: those
71
+ * TOP-LEVEL roots are ordered by status urgency first (In-progress -> Open
72
+ * -> Blocked -> Closed, priority-then-id breaking ties within a status);
73
+ * this is non-recursive -- each root's own children keep their existing
74
+ * natural DAG order (see `childrenOf[nodeId].slice().sort()` in
75
+ * `renderNode`), unaffected by their parent's status.
76
+ *
77
+ * The panel shows up to two top-level sections: "Sprint" (the containment
78
+ * tree above, built from `sprintTasks`) and "Backlog" (`backlogTasks` --
79
+ * open/deferred beads the sprint is certainly NOT addressing this run,
80
+ * which may belong to an entirely different epic or never have gone
81
+ * through a planning phase at all). Each section (header + body) is
82
+ * rendered ONLY when that section has at least one task (apra-fleet-eft.89):
83
+ * an empty `sprintTasks`/`backlogTasks` array skips its section entirely
84
+ * rather than showing a header with a "No sprint tasks."/"No backlog
85
+ * items." placeholder row. This lets a caller that only ever supplies one
86
+ * of the two lists (e.g. the supervisor's viewer, which always calls
87
+ * `renderBeadsHtml([], tasks, ...)`) render a single, focused section with
88
+ * no always-empty sibling section cluttering the panel. The 6-column
89
+ * header row and outer `<table>` wrapper always render regardless of which
90
+ * (if either) section has content.
91
+ *
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.
106
+ *
107
+ * Every rendering decision here (status/type badges, tree placement) is
108
+ * defensive by construction: unrecognized/missing status, type, model, or
109
+ * priority values fall back to a generic, still-visible label rather than
110
+ * throwing or rendering blank, and a cycle-guard plus an end-of-pass sweep
111
+ * for any task that never got attached to the tree (should not happen with
112
+ * well-formed bd data, but is not assumed) guarantees every task in the
113
+ * input is rendered exactly once, never silently dropped.
114
+ *
115
+ * apra-fleet-4p5: every tree node that has children (and either top-level
116
+ * "Sprint"/"Backlog" section header that is actually rendered, per the
117
+ * conditional-section rule above) renders a `[-]`/`[+]` toggle (a
118
+ * `.tree-toggle` span carrying a `data-toggle-id`,
119
+ * same round-trip-through-the-DOM pattern the `bead-desc` `data-bead-id`
120
+ * attribute already uses) so a user can fold away a subtree. A node id in
121
+ * `collapsedIds` is rendered collapsed: its own row still shows (with the
122
+ * `[+]` toggle), but none of its descendants' rows are emitted at all --
123
+ * they are still walked (so the cycle-guard/`rendered` bookkeeping stays
124
+ * correct and the end-of-pass safety-net sweep does not re-attach a hidden
125
+ * descendant as a spurious extra root), just not concatenated into the
126
+ * returned HTML. The two sections use the synthetic ids `'section:sprint'`
127
+ * / `'section:backlog'` in the same `collapsedIds` set, since neither can
128
+ * ever collide with a real bd id. This function stays a pure, synchronous
129
+ * string builder either way -- collapse is a rendering decision driven
130
+ * entirely by the `collapsedIds` input, not by any DOM/document access.
131
+ *
132
+ * @param {Array<{id: string|number, title?: string, description?: string, status?: string, issue_type?: string, ready?: boolean, priority?: number, metadata?: {model?: string}, dependencies?: Array<{depends_on_id: string|number, type: string}>}>} sprintTasks
133
+ * @param {Array<{id: string|number, title?: string, description?: string, status?: string, issue_type?: string, priority?: number, metadata?: {model?: string}}>} [backlogTasks]
134
+ * @param {Set<string>|string[]} [collapsedIds] ids (real bead ids, or the synthetic 'section:sprint'/'section:backlog') currently collapsed
135
+ * @returns {string}
136
+ */
137
+ export function renderBeadsHtml(sprintTasks, backlogTasks, collapsedIds) {
138
+ sprintTasks = sprintTasks || [];
139
+ backlogTasks = backlogTasks || [];
140
+
141
+ // apra-fleet-eft.52.1.3: a server-computed `placement` flag ('sprint' |
142
+ // 'backlog') on a task is AUTHORITATIVE for which section it renders in --
143
+ // runner.js decides Sprint vs Backlog by goal membership (goal-priority
144
+ // band + a blocks-edge exception), not this browser-side view, and never
145
+ // by hiding a row with CSS. When any task carries `placement`, re-derive
146
+ // both section lists from the flag so a below-goal top-level item lands in
147
+ // the Backlog container even if it arrived in the sprintTasks array (and
148
+ // vice versa). Tasks with no `placement` (every pre-existing caller and
149
+ // fixture) are left in whichever array the caller passed them -- this
150
+ // normalization is a no-op for them, so behavior is unchanged.
151
+ const anyPlacement = sprintTasks.some((t) => t && t.placement) || backlogTasks.some((t) => t && t.placement);
152
+ if (anyPlacement) {
153
+ const all = sprintTasks.concat(backlogTasks);
154
+ // A flag-less item defaults to Sprint (in-scope work of unknown rank
155
+ // is sprint work, mirroring runner.js's server-side default).
156
+ sprintTasks = all.filter((t) => t && t.placement !== 'backlog');
157
+ backlogTasks = all.filter((t) => t && t.placement === 'backlog');
158
+ }
159
+
160
+ // Accept a Set (the browser-side embed's long-lived collapse state) or
161
+ // a plain array (e.g. a future caller reconstructing it from
162
+ // persisted/serialized state) -- never throws on either shape.
163
+ collapsedIds = collapsedIds instanceof Set ? collapsedIds : new Set(Array.isArray(collapsedIds) ? collapsedIds : []);
164
+
165
+ // ASCII-only badges throughout (project convention) -- bracketed text
166
+ // tags with inline color, not unicode glyphs/emoji.
167
+ // Color signals "needs attention", not "good/bad": closed work is done
168
+ // and should recede (grey), not celebrate (green); open work hasn't
169
+ // been started and should draw the eye (red), same urgency register as
170
+ // blocked.
171
+ const STATUS_BADGES = {
172
+ open: { label: 'OPEN', color: 'var(--danger)' },
173
+ in_progress: { label: 'IN PROGRESS', color: 'var(--accent)' },
174
+ closed: { label: 'CLOSED', color: '#71717a' },
175
+ blocked: { label: 'BLOCKED', color: 'var(--danger)' },
176
+ deferred: { label: 'DEFERRED', color: '#71717a' },
177
+ };
178
+ // Keys serve double duty: some are real bd `issue_type` values (bug,
179
+ // chore, epic, decision), checked first below; others are only
180
+ // title-prefix conventions (test, impl, feat, fix, doc, design, spike,
181
+ // ci) that carry no `issue_type` of their own -- `task`/`feature` beads
182
+ // commonly use these prefixes to say what KIND of task/feature work this
183
+ // is, which is more informative than the bare issue_type, so those two
184
+ // real types are deliberately left OUT of this map: leaving them out is
185
+ // what lets the title-prefix fallback below run for them instead of
186
+ // being short-circuited to a bare TASK/FEATURE badge.
187
+ const TYPE_BADGES = {
188
+ bug: { label: 'BUG', color: 'var(--danger)' },
189
+ test: { label: 'TEST', color: '#22d3ee' },
190
+ impl: { label: 'IMPL', color: 'var(--accent)' },
191
+ feat: { label: 'FEAT', color: 'var(--accent)' },
192
+ fix: { label: 'FIX', color: 'var(--danger)' },
193
+ doc: { label: 'DOC', color: '#a78bfa' },
194
+ docs: { label: 'DOC', color: '#a78bfa' },
195
+ design: { label: 'DESIGN', color: '#a78bfa' },
196
+ spike: { label: 'SPIKE', color: '#f59e0b' },
197
+ ci: { label: 'CI', color: '#71717a' },
198
+ chore: { label: 'CHORE', color: '#71717a' },
199
+ epic: { label: 'EPIC', color: '#e4e4e7' },
200
+ decision: { label: 'DECISION', color: '#a78bfa' },
201
+ };
202
+
203
+ // Never throws: an unrecognized or missing status/type always resolves
204
+ // to a visible, styled fallback rather than a blank cell or an
205
+ // exception that would take the whole panel down with it.
206
+ function statusBadge(status) {
207
+ const key = (status || '').toString().toLowerCase();
208
+ const known = STATUS_BADGES[key];
209
+ const label = known ? known.label : (status ? escapeHtml(status.toString().toUpperCase()) : 'UNKNOWN');
210
+ const color = known ? known.color : '#a1a1aa';
211
+ return '<span style="color: ' + color + '; font-weight: bold; font-size: 10px; border: 1px solid ' + color + '; border-radius: 3px; padding: 1px 5px; white-space: nowrap;">' + label + '</span>';
212
+ }
213
+
214
+ // Reads the authoritative `issue_type` first (bd's real, stored field);
215
+ // only falls back to guessing from a `[prefix]` title convention when
216
+ // issue_type is absent or isn't one of the types with its own dedicated
217
+ // badge above (this is the common case for `task`/`feature` beads,
218
+ // which rely on the title prefix to say what kind of task/feature this
219
+ // is -- see the comment on TYPE_BADGES).
220
+ function typeBadge(issueType, title) {
221
+ const typeKey = (issueType || '').toString().toLowerCase();
222
+ const knownType = TYPE_BADGES[typeKey];
223
+ if (knownType) {
224
+ return '<span style="color: ' + knownType.color + '; font-size: 10px; border: 1px solid ' + knownType.color + '; border-radius: 3px; padding: 1px 5px; white-space: nowrap;">' + knownType.label + '</span>';
225
+ }
226
+ const match = /^\[([A-Za-z0-9_-]+)\]/.exec(title || '');
227
+ const prefixKey = match ? match[1].toLowerCase() : '';
228
+ const knownPrefix = TYPE_BADGES[prefixKey];
229
+ const label = knownPrefix ? knownPrefix.label : (match ? escapeHtml(match[1]).toUpperCase() : 'MISC');
230
+ const color = knownPrefix ? knownPrefix.color : '#71717a';
231
+ return '<span style="color: ' + color + '; font-size: 10px; border: 1px solid ' + color + '; border-radius: 3px; padding: 1px 5px; white-space: nowrap;">' + label + '</span>';
232
+ }
233
+
234
+ // apra-fleet-xbu.C6: a bead with stored status 'open' that is NOT in
235
+ // this update's `--ready` set (see updateDashboard() in runner.js,
236
+ // which now threads a per-bead `ready` boolean computed from the same
237
+ // `--ready` query dispatch decisions are already based on) is blocked,
238
+ // not merely unstarted -- render it distinctly instead of conflating it
239
+ // with genuinely-ready OPEN work. Beads with no `ready` field at all
240
+ // (e.g. backlog rows, or an older caller that hasn't been updated)
241
+ // fall back to the plain stored-status badge, unchanged.
242
+ function statusBadgeForNode(node) {
243
+ const status = (node.status || '').toString().toLowerCase();
244
+ if (status === 'open' && node.ready === false) {
245
+ return statusBadge('blocked');
246
+ }
247
+ return statusBadge(node.status);
248
+ }
249
+
250
+ // apra-fleet-eft.52.1.2: rank used to order Sprint's TOP-LEVEL roots only
251
+ // (see sprintRootSort below) -- in-progress work surfaces first, closed
252
+ // work sinks to the bottom. Mirrors statusBadgeForNode's 'open' +
253
+ // ready===false ==> effectively-blocked distinction above, so a root
254
+ // row's rank always agrees with its own rendered status badge. Anything
255
+ // outside these four (e.g. 'deferred', or a future/unrecognized status)
256
+ // ranks after 'closed' rather than throwing or being treated as one of
257
+ // the four.
258
+ const STATUS_ORDER = { in_progress: 0, open: 1, blocked: 2, closed: 3 };
259
+ function statusRank(node) {
260
+ const status = (node.status || '').toString().toLowerCase();
261
+ const effective = (status === 'open' && node.ready === false) ? 'blocked' : status;
262
+ const rank = STATUS_ORDER[effective];
263
+ return typeof rank === 'number' ? rank : STATUS_ORDER.closed + 1;
264
+ }
265
+
266
+ function priorityBadge(priority) {
267
+ const label = (typeof priority === 'number' && Number.isFinite(priority)) ? 'P' + priority : 'P?';
268
+ return '<span style="color: #a1a1aa; font-size: 10px;">' + label + '</span>';
269
+ }
270
+
271
+ // Closed items' titles are dimmed so completed work visually recedes
272
+ // rather than competing for attention with what's still open/blocked.
273
+ function titleColor(status) {
274
+ return (status || '').toString().toLowerCase() === 'closed' ? '#71717a' : '#e4e4e7';
275
+ }
276
+
277
+ function modelBadge(metadata) {
278
+ const model = metadata && metadata.model;
279
+ return '<span style="color: #a1a1aa; font-size: 10px;">' + (model ? escapeHtml(model) : 'n/a') + '</span>';
280
+ }
281
+
282
+ // apra-fleet supervisor's Backlog view (src/supervisor/backlog.mjs) has no
283
+ // containment tree of its own to hang a partial-claim annotation off (its
284
+ // beads-tree nests by `blocks` edges, not `parent`), so it attaches the
285
+ // annotation directly onto the flat row object it hands this renderer as
286
+ // `node.partialClaim`. Every fleet-sprint caller leaves this field
287
+ // undefined, so this is a no-op there -- same "defensive, never throws on
288
+ // an absent/unrecognized field" rule the badge builders above already
289
+ // follow.
290
+ function partialClaimAnnotationHtml(partialClaim) {
291
+ if (!partialClaim) return '';
292
+ const sprintLabel = partialClaim.sprints.length === 0
293
+ ? 'an active sprint'
294
+ : partialClaim.sprints.map((s) => (partialClaim.sprints.length > 1 ? s.sprintId + ' (' + s.count + ')' : s.sprintId)).join(', ');
295
+ const text = partialClaim.claimedCount + ' of ' + partialClaim.totalCount + ' children claimed by ' + sprintLabel + '; ' + partialClaim.freeCount + ' free';
296
+ return '<div data-partial-claim="true" style="margin-top: 4px; font-size: 10px; color: #f59e0b; font-style: italic;">' + escapeHtml(text) + '</div>';
297
+ }
298
+
299
+ // apra-fleet-eft.27.2: descriptions are no longer inlined into the
300
+ // dashboard's recurring poll payload -- apra-fleet-eft.27.1's lean
301
+ // list-state transform (src/viewer/lean-state.mjs) strips every bead's
302
+ // full `description` down to a short `summary` before GET /state ever
303
+ // serves it, so the real running dashboard only ever has `summary`
304
+ // here. The full text is instead fetched on demand, exactly once per
305
+ // (bead id, updatedAt) pair, the moment a user expands the row -- see
306
+ // GET /extensions/beads/detail/:itemId (src/viewer/index.mjs, generic
307
+ // route delegating to this module's `beadsExtension.detailLookup`,
308
+ // apra-fleet-eft.37.4) and the fetch + localStorage-cache logic wired up
309
+ // below in `js`.
310
+ //
311
+ // A caller that already has the full `description` inline (this
312
+ // module's own unit tests, a History-view's frozen/unleaned snapshot,
313
+ // or any future non-leaned data source) still gets it rendered
314
+ // immediately with no fetch at all -- `data-loaded="true"` marks that
315
+ // case so the client-side expand handler never re-fetches something it
316
+ // was already given. `summary` is only used as the short initial
317
+ // preview when the full field isn't present.
318
+ function descriptionDetailsHtml(task, safeId, safeTitle) {
319
+ const preview = task.description || task.summary;
320
+ if (!preview) return safeTitle;
321
+ const safePreview = escapeHtml(preview);
322
+ const safeUpdatedAt = escapeHtml(task.updated_at || task.updatedAt || '');
323
+ const hasFull = task.description ? 'true' : 'false';
324
+ return '<details class="bead-desc" data-bead-id="' + safeId + '" data-updated-at="' + safeUpdatedAt + '">' +
325
+ '<summary style="cursor: pointer; outline: none; list-style-position: inside;">' + safeTitle + '</summary>' +
326
+ '<div class="bead-desc-body" data-loaded="' + hasFull + '" style="margin-top: 6px; padding: 8px; background: rgba(0,0,0,0.15); border-left: 2px solid var(--accent); font-size: 11px; border-radius: 0 4px 4px 0; color: #a1a1aa; white-space: pre-wrap; font-family: monospace;">' +
327
+ safePreview +
328
+ '</div></details>';
329
+ }
330
+
331
+ // A childless node/section gets an invisible same-width spacer instead
332
+ // of a toggle, so id/label columns still line up whether or not a
333
+ // given row happens to have anything to fold away. `id` is the raw
334
+ // (unescaped) node id or synthetic section key -- escaped here, once,
335
+ // for the `data-toggle-id` attribute; the browser round-trips it back
336
+ // to the original string when read via `.dataset.toggleId` (HTML
337
+ // entity decoding), exactly like the existing `data-bead-id` attribute
338
+ // on `.bead-desc` already relies on.
339
+ function treeToggleHtml(id, hasChildren, collapsed) {
340
+ if (!hasChildren) {
341
+ return '<span style="display: inline-block; width: 16px;"></span>';
342
+ }
343
+ const safeToggleId = escapeHtml(id);
344
+ const label = collapsed ? '[+]' : '[-]';
345
+ const title = collapsed ? 'Expand' : 'Collapse';
346
+ return '<span class="tree-toggle" data-toggle-id="' + safeToggleId + '" title="' + title + '" ' +
347
+ 'style="cursor: pointer; display: inline-block; width: 16px; user-select: none; color: #a1a1aa;">' + label + '</span>';
348
+ }
349
+
350
+ // apra-fleet-eft.52.1.1: `variant` distinguishes the Backlog header from
351
+ // the Sprint header, both in DOM (a stable `backlog-header`/
352
+ // `backlog-section` class not present on Sprint) and visually (a muted
353
+ // band + more prominent header), so the two regions are no longer
354
+ // rendered via an identical, indistinguishable code path.
355
+ function sectionHeaderRow(label, sectionKey, collapsed, variant) {
356
+ const isBacklog = variant === 'backlog';
357
+ const rowClass = isBacklog ? 'section-header backlog-section' : 'section-header';
358
+ const cellStyle = isBacklog
359
+ ? 'padding: 10px 8px; font-size: 12px; font-weight: bold; letter-spacing: 0.5px; text-transform: uppercase; color: #e4e4e7; background: rgba(161,161,170,0.12); border-top: 1px solid rgba(255,255,255,0.15); border-bottom: 1px solid rgba(255,255,255,0.15);'
360
+ : 'padding: 10px 8px 4px; font-size: 11px; font-weight: bold; letter-spacing: 0.5px; color: #a1a1aa; border-bottom: 1px solid rgba(255,255,255,0.1);';
361
+ const headerClass = isBacklog ? ' backlog-header' : '';
362
+ return '<tr class="' + rowClass + '"><td colspan="6" class="section-header-cell' + headerClass + '" style="' + cellStyle + '">' +
363
+ treeToggleHtml(sectionKey, true, collapsed) + ' ' + escapeHtml(label) + '</td></tr>';
364
+ }
365
+
366
+ function emptySectionRow(message) {
367
+ return '<tr><td colspan="6" style="padding: 8px; font-size: 12px; color: #71717a; font-style: italic;">' + escapeHtml(message) + '</td></tr>';
368
+ }
369
+
370
+ // --- Build a containment tree from each task's `parent` field, not
371
+ // from `blocks`-type dependency edges (see module doc-comment above) ---
372
+ const map = {};
373
+ sprintTasks.forEach((t) => { map[t.id] = { ...t, children: [], blockedBy: [] }; });
374
+
375
+ const childrenOf = {}; // parentId -> [taskId, ...] (parent-containment, not blocking)
376
+ sprintTasks.forEach((t) => {
377
+ // 'blocks'-type dependency edges are still captured here -- they no
378
+ // longer decide tree placement, but every blocker is preserved and
379
+ // rendered as an inline annotation below so no dependency
380
+ // information is lost.
381
+ const deps = Array.isArray(t.dependencies) ? t.dependencies : [];
382
+ const blockerIds = deps
383
+ .filter((d) => d && d.type === 'blocks' && map[d.depends_on_id])
384
+ .map((d) => d.depends_on_id);
385
+ map[t.id].blockedBy = blockerIds;
386
+
387
+ // Only an in-dataset parent contributes to nesting -- a `parent`
388
+ // value pointing outside sprintTasks (e.g. an epic not itself part
389
+ // of this sprint run) leaves the task a root, same as having no
390
+ // parent at all.
391
+ const parentId = t.parent;
392
+ if (parentId !== undefined && parentId !== null && map[parentId]) {
393
+ (childrenOf[parentId] = childrenOf[parentId] || []).push(t.id);
394
+ }
395
+ });
396
+
397
+ // apra-fleet-eft.52.1.2: TOP-LEVEL Sprint roots only are primarily
398
+ // ordered by status urgency (statusRank above) -- In-progress -> Open ->
399
+ // Blocked -> Closed -- falling back to the existing priority-then-id
400
+ // ordering only to break ties within the same status. This is
401
+ // deliberately NOT applied recursively: `childrenOf[nodeId]` in
402
+ // renderNode below keeps its own unrelated (natural DAG / id) order, so
403
+ // a subtree's hierarchy stays legible rather than being scrambled by
404
+ // status.
405
+ function sprintRootSort(aId, bId) {
406
+ const a = map[aId];
407
+ const b = map[bId];
408
+ const ra = statusRank(a);
409
+ const rb = statusRank(b);
410
+ if (ra !== rb) return ra - rb;
411
+ const pa = (typeof a.priority === 'number' && Number.isFinite(a.priority)) ? a.priority : 99;
412
+ const pb = (typeof b.priority === 'number' && Number.isFinite(b.priority)) ? b.priority : 99;
413
+ if (pa !== pb) return pa - pb;
414
+ return String(aId).localeCompare(String(bId));
415
+ }
416
+
417
+ const roots = sprintTasks
418
+ .filter((t) => !(t.parent !== undefined && t.parent !== null && map[t.parent]))
419
+ .map((t) => t.id)
420
+ .sort(sprintRootSort);
421
+
422
+ function renderNode(nodeId, depth, rendered) {
423
+ if (rendered.has(nodeId)) return ''; // cycle-guard: never render twice
424
+ rendered.add(nodeId);
425
+ const node = map[nodeId];
426
+
427
+ const indent = depth * 20;
428
+ const prefix = depth > 0 ? String.fromCharCode(0x2514, 0x2500) + ' ' : '';
429
+
430
+ // Every bead-derived field is escaped before interpolation -- these
431
+ // are the exact fields the original (vulnerable) implementation
432
+ // injected raw.
433
+ const safeId = escapeHtml(node.id);
434
+ const safeTitle = escapeHtml(node.title);
435
+
436
+ const titleHtml = descriptionDetailsHtml(node, safeId, safeTitle);
437
+
438
+ // 'blocks'-type dependency edges no longer decide tree placement
439
+ // (nesting now comes from `parent`), so every blocker -- not just
440
+ // ones beyond a former "primary" -- must be listed here or the
441
+ // information would be lost.
442
+ let extraBlockedByHtml = '';
443
+ if (node.blockedBy.length > 0) {
444
+ const blockers = node.blockedBy.slice().sort().map((id) => '#' + escapeHtml(id)).join(', ');
445
+ extraBlockedByHtml = '<div style="margin-top: 4px; font-size: 10px; color: #71717a;">blocked by: ' + blockers + '</div>';
446
+ }
447
+ extraBlockedByHtml += partialClaimAnnotationHtml(node.partialClaim);
448
+
449
+ const children = (childrenOf[nodeId] || []).slice().sort();
450
+ const isCollapsed = children.length > 0 && collapsedIds.has(String(nodeId));
451
+ const toggleHtml = treeToggleHtml(nodeId, children.length > 0, isCollapsed);
452
+
453
+ // data-bead-id round-trips the raw (unescaped) id back via HTML entity
454
+ // decoding, same convention as .bead-desc's data-bead-id / .tree-toggle's
455
+ // data-toggle-id above -- lets a host page (e.g. the supervisor's Launch
456
+ // Sprint form) wire row click-to-select without parsing rendered text.
457
+ let html = '<tr data-bead-id="' + safeId + '" style="border-bottom: 1px solid rgba(255,255,255,0.05);">' +
458
+ '<td style="padding: 8px; padding-left: ' + (8 + indent) + 'px; vertical-align: top; width: 110px; color: ' + titleColor(node.status) + ';">' + toggleHtml + prefix + '#' + safeId + '</td>' +
459
+ '<td style="padding: 8px; vertical-align: top; color: ' + titleColor(node.status) + ';">' + titleHtml + extraBlockedByHtml + '</td>' +
460
+ '<td style="padding: 8px; vertical-align: top; width: 90px;">' + typeBadge(node.issue_type, node.title) + '</td>' +
461
+ '<td style="padding: 8px; vertical-align: top; width: 100px;">' + statusBadgeForNode(node) + '</td>' +
462
+ '<td style="padding: 8px; vertical-align: top; width: 50px;">' + priorityBadge(node.priority) + '</td>' +
463
+ '<td style="padding: 8px; vertical-align: top; width: 80px;">' + modelBadge(node.metadata) + '</td>' +
464
+ '</tr>';
465
+
466
+ // Always recurse (even when collapsed) so every descendant still
467
+ // gets added to `rendered` -- otherwise the end-of-pass safety-net
468
+ // sweep below would mistake a hidden-but-known descendant for an
469
+ // orphan and re-attach it as a spurious extra root. Only the
470
+ // concatenation into the returned HTML is conditional on collapse.
471
+ const childrenHtml = children.map((childId) => renderNode(childId, depth + 1, rendered)).join('');
472
+ if (!isCollapsed) {
473
+ html += childrenHtml;
474
+ }
475
+ return html;
476
+ }
477
+
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`.
487
+ const backlogMap = {};
488
+ backlogTasks.forEach((t) => { backlogMap[t.id] = { ...t, blockedBy: [] }; });
489
+
490
+ const backlogChildrenOf = {}; // blockerId -> [taskId, ...] (blocks-edge, not containment)
491
+ const nestedBacklogIds = new Set(); // ids nested under a blocker -- excluded from the root list
492
+
493
+ backlogTasks.forEach((t) => {
494
+ const deps = Array.isArray(t.dependencies) ? t.dependencies : [];
495
+ const blockerIds = deps
496
+ .filter((d) => d && d.type === 'blocks' && backlogMap[d.depends_on_id])
497
+ .map((d) => d.depends_on_id);
498
+ backlogMap[t.id].blockedBy = blockerIds;
499
+ if (blockerIds.length > 0) {
500
+ // A node renders exactly once (cycle-guard below), so with
501
+ // multiple in-set blockers only one can be the tree-parent --
502
+ // the lowest-sorted blocker id wins, for deterministic output.
503
+ // Every blocker (not just the nesting one) still appears in the
504
+ // inline "blocked by" annotation, so no edge is silently lost.
505
+ const primaryBlockerId = blockerIds.slice().sort()[0];
506
+ (backlogChildrenOf[primaryBlockerId] = backlogChildrenOf[primaryBlockerId] || []).push(t.id);
507
+ nestedBacklogIds.add(t.id);
508
+ }
509
+ });
510
+
511
+ function priorityThenId(aId, bId) {
512
+ const a = backlogMap[aId];
513
+ const b = backlogMap[bId];
514
+ const pa = (typeof a.priority === 'number' && Number.isFinite(a.priority)) ? a.priority : 99;
515
+ const pb = (typeof b.priority === 'number' && Number.isFinite(b.priority)) ? b.priority : 99;
516
+ if (pa !== pb) return pa - pb;
517
+ return String(aId).localeCompare(String(bId));
518
+ }
519
+
520
+ const backlogRoots = backlogTasks
521
+ .map((t) => t.id)
522
+ .filter((id) => !nestedBacklogIds.has(id))
523
+ .sort(priorityThenId);
524
+
525
+ function renderBacklogNode(nodeId, depth, rendered) {
526
+ if (rendered.has(nodeId)) return ''; // cycle-guard: never render twice
527
+ rendered.add(nodeId);
528
+ const node = backlogMap[nodeId];
529
+
530
+ const indent = depth * 20;
531
+ const prefix = depth > 0 ? String.fromCharCode(0x2514, 0x2500) + ' ' : '';
532
+
533
+ const safeId = escapeHtml(node.id);
534
+ const safeTitle = escapeHtml(node.title);
535
+
536
+ const titleHtml = descriptionDetailsHtml(node, safeId, safeTitle);
537
+
538
+ let extraBlockedByHtml = '';
539
+ if (node.blockedBy.length > 0) {
540
+ const blockers = node.blockedBy.slice().sort().map((id) => '#' + escapeHtml(id)).join(', ');
541
+ extraBlockedByHtml = '<div style="margin-top: 4px; font-size: 10px; color: #71717a;">blocked by: ' + blockers + '</div>';
542
+ }
543
+ extraBlockedByHtml += partialClaimAnnotationHtml(node.partialClaim);
544
+
545
+ const children = (backlogChildrenOf[nodeId] || []).slice().sort(priorityThenId);
546
+ const isCollapsed = children.length > 0 && collapsedIds.has(String(nodeId));
547
+ const toggleHtml = treeToggleHtml(nodeId, children.length > 0, isCollapsed);
548
+
549
+ let html = '<tr data-bead-id="' + safeId + '" style="border-bottom: 1px solid rgba(255,255,255,0.05);">' +
550
+ '<td style="padding: 8px; padding-left: ' + (8 + indent) + 'px; vertical-align: top; width: 110px; color: ' + titleColor(node.status) + ';">' + toggleHtml + prefix + '#' + safeId + '</td>' +
551
+ '<td style="padding: 8px; vertical-align: top; color: ' + titleColor(node.status) + ';">' + titleHtml + extraBlockedByHtml + '</td>' +
552
+ '<td style="padding: 8px; vertical-align: top; width: 90px;">' + typeBadge(node.issue_type, node.title) + '</td>' +
553
+ '<td style="padding: 8px; vertical-align: top; width: 100px;">' + statusBadgeForNode(node) + '</td>' +
554
+ '<td style="padding: 8px; vertical-align: top; width: 50px;">' + priorityBadge(node.priority) + '</td>' +
555
+ '<td style="padding: 8px; vertical-align: top; width: 80px;">' + modelBadge(node.metadata) + '</td>' +
556
+ '</tr>';
557
+
558
+ // Same "always recurse, conditionally concatenate" rule as
559
+ // renderNode above -- keeps the safety-net sweep below from
560
+ // re-attaching a hidden-but-known descendant as a spurious root.
561
+ const childrenHtml = children.map((childId) => renderBacklogNode(childId, depth + 1, rendered)).join('');
562
+ if (!isCollapsed) {
563
+ html += childrenHtml;
564
+ }
565
+ return html;
566
+ }
567
+
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
575
+ // many descendants it has). An empty panel (both lists empty) renders
576
+ // '0/0', never NaN/throwing.
577
+ const countedTasks = sprintTasks.concat(backlogTasks);
578
+ const totalBeadCount = countedTasks.length;
579
+ const openBeadCount = countedTasks.filter((t) => t && (t.status || '').toString().toLowerCase() !== 'closed').length;
580
+ const countHtml = '<div class="beads-count" style="padding: 4px 8px; font-size: 12px; color: #a1a1aa;">' +
581
+ openBeadCount + '/' + totalBeadCount + '</div>';
582
+
583
+ let html = countHtml + '<table style="width: 100%; border-collapse: collapse; text-align: left; font-size: 13px;">';
584
+ html += '<tr style="border-bottom: 1px solid rgba(255,255,255,0.1);">' +
585
+ '<th style="padding: 8px;">ID</th><th style="padding: 8px;">Title</th><th style="padding: 8px;">Type</th>' +
586
+ '<th style="padding: 8px;">Status</th><th style="padding: 8px;">Pri</th><th style="padding: 8px;">Model</th></tr>';
587
+
588
+ // The two top-level section headers are themselves collapsible via the
589
+ // same synthetic-id convention as any other .tree-toggle: folding a
590
+ // section hides its ENTIRE body (all root rows and their subtrees),
591
+ // not just direct children -- there is no safety-net concern here
592
+ // (unlike node-level collapse) since a section's rows have nowhere
593
+ // else in the output they could spuriously reappear.
594
+ //
595
+ // apra-fleet-eft.89: a section (header + body) is only emitted when it
596
+ // has at least one task -- an empty sprintTasks/backlogTasks list skips
597
+ // that entire section (no header, no "No sprint tasks."/"No backlog
598
+ // items." placeholder row), rather than always rendering both. This
599
+ // keeps a caller that only ever supplies one of the two lists (e.g. the
600
+ // supervisor's renderBeadsHtml([], tasks, ...)) from showing an
601
+ // always-empty sibling section.
602
+ const sprintCollapsed = collapsedIds.has('section:sprint');
603
+ if (sprintTasks.length > 0) {
604
+ html += sectionHeaderRow('Sprint', 'section:sprint', sprintCollapsed);
605
+ if (!sprintCollapsed) {
606
+ const rendered = new Set();
607
+ roots.forEach((rootId) => {
608
+ html += renderNode(rootId, 0, rendered);
609
+ });
610
+ // Safety net: any task that never got attached (should not
611
+ // happen with well-formed data, but is not assumed) still
612
+ // renders, as its own root, rather than being silently dropped.
613
+ sprintTasks.forEach((t) => {
614
+ if (!rendered.has(t.id)) {
615
+ html += renderNode(t.id, 0, rendered);
616
+ }
617
+ });
618
+ }
619
+ }
620
+
621
+ const backlogCollapsed = collapsedIds.has('section:backlog');
622
+ if (backlogTasks.length > 0) {
623
+ html += sectionHeaderRow('Backlog', 'section:backlog', backlogCollapsed, 'backlog');
624
+ if (!backlogCollapsed) {
625
+ // Roots (items with no in-set blocker, or whose blocker isn't
626
+ // part of this backlog dataset) are sorted priority-then-id for
627
+ // stable, scannable ordering; any item nested under a blocker
628
+ // (see `backlogChildrenOf` above) renders under that blocker
629
+ // instead, not flattened into this top-level sort.
630
+ const renderedBacklog = new Set();
631
+ backlogRoots.forEach((rootId) => {
632
+ html += renderBacklogNode(rootId, 0, renderedBacklog);
633
+ });
634
+ // Safety net: any backlog task never attached (e.g. a
635
+ // blocks-cycle among backlog items -- should not happen with
636
+ // well-formed bd data, but is not assumed) still renders, as
637
+ // its own root, rather than being silently dropped.
638
+ backlogTasks.forEach((t) => {
639
+ if (!renderedBacklog.has(t.id)) {
640
+ html += renderBacklogNode(t.id, 0, renderedBacklog);
641
+ }
642
+ });
643
+ }
644
+ }
645
+
646
+ // Both lists empty: neither section rendered above, so the table would
647
+ // otherwise be just the 6-column header row with no body at all. That
648
+ // is well-formed on its own, but a single graceful placeholder row
649
+ // reads better than a header with nothing under it.
650
+ if (sprintTasks.length === 0 && backlogTasks.length === 0) {
651
+ html += emptySectionRow('No tasks to display.');
652
+ }
653
+
654
+ html += '</table>';
655
+ return html;
656
+ }
657
+
658
+ /**
659
+ * apra-fleet-eft.37.3: pure HTML-string builder for the auto-sprint verdict
660
+ * badge + PR link, moved OUT of the generic workflow core (which used to
661
+ * mint `state.verdict`/`state.prUrl` by name -- see
662
+ * docs/workflow-core-boundary-refactoring.md M2) and into this se-owned
663
+ * extension. Core now only stores the workflow script's own return value
664
+ * WHOLESALE and opaquely as `state.result`, and renders its top-level
665
+ * SCALAR fields as a generic, unstyled key/value strip (src/viewer/
666
+ * index.mjs's `#result-strip`). This function reads the SAME
667
+ * `state.result` object, but knows the two keys that are meaningful for an
668
+ * auto-sprint run specifically -- `verdict` (colored by outcome) and
669
+ * `prUrl` (link-ified) -- exactly the se-domain knowledge that has no
670
+ * business living in the generic engine.
671
+ *
672
+ * Returns '' when `result` carries neither key (e.g. a non-auto-sprint
673
+ * workflow, or a run that hasn't finished yet), so the caller can hide its
674
+ * container entirely rather than show an empty badge strip.
675
+ *
676
+ * @param {{ verdict?: string|null, prUrl?: string|null }|null|undefined} result
677
+ * @returns {string}
678
+ */
679
+ export function renderResultExtrasHtml(result) {
680
+ const verdict = result && typeof result === 'object' ? result.verdict : undefined;
681
+ const prUrl = result && typeof result === 'object' ? result.prUrl : undefined;
682
+ // Nothing se-meaningful to show (non-auto-sprint workflow, or a run that
683
+ // hasn't finished yet) -- let the caller hide its container entirely.
684
+ if (verdict == null && prUrl == null) return '';
685
+
686
+ // Color signals outcome, same register as the beads status badges above:
687
+ // a clean PASS/MERGED/APPROVED recedes to green, anything that means
688
+ // "this needs a human's attention" (FAIL/CHANGES_NEEDED/ABORTED) draws
689
+ // the eye in red; an unrecognized verdict string still renders, just in
690
+ // a neutral grey, rather than being silently dropped.
691
+ const VERDICT_COLORS = {
692
+ PASS: 'var(--success)',
693
+ MERGED: 'var(--success)',
694
+ APPROVED: 'var(--success)',
695
+ FAIL: 'var(--danger)',
696
+ CHANGES_NEEDED: 'var(--danger)',
697
+ ABORTED: 'var(--danger)',
698
+ };
699
+ let verdictHtml = '';
700
+ if (verdict != null) {
701
+ const key = String(verdict).toUpperCase();
702
+ const color = VERDICT_COLORS[key] || '#a1a1aa';
703
+ verdictHtml = '<span style="color: ' + color + '; font-weight: 700; font-size: 11px; ' +
704
+ 'border: 1px solid ' + color + '; border-radius: 4px; padding: 2px 6px; white-space: nowrap;">' +
705
+ escapeHtml(String(verdict)) + '</span>';
706
+ }
707
+
708
+ let prHtml = '';
709
+ if (typeof prUrl === 'string' && prUrl.length > 0) {
710
+ prHtml = '<a href="' + escapeHtml(prUrl) + '" target="_blank" rel="noopener noreferrer" ' +
711
+ 'style="color: var(--accent); font-size: 11px; text-decoration: none; white-space: nowrap;">PR -&gt;</a>';
712
+ }
713
+
714
+ return verdictHtml + prHtml;
715
+ }
716
+
717
+ // apra-fleet-eft.37.4 (M3, docs/workflow-core-boundary-refactoring.md):
718
+ // relocated verbatim from packages/apra-fleet-workflow/src/viewer/index.mjs's
719
+ // former findBeadById() -- that was the one place core reached into
720
+ // `state.extensions.beads.sprintTasks/backlogTasks` by name, a deliberate
721
+ // domain leak the eft.27.2 comment it replaced called out explicitly. Core
722
+ // now only knows the generic `detailLookup(state, id)` hook shape (see
723
+ // `beadsExtension.detailLookup` below); this function is the se-owned
724
+ // knowledge of the beads extension's own data shape.
725
+ //
726
+ // Runs server-side (Node), invoked by core's GET
727
+ // /extensions/beads/detail/:itemId route -- never embedded into the
728
+ // browser-side `js` string below, unlike renderBeadsHtml/renderResultExtrasHtml.
729
+ function findBeadById(state, id) {
730
+ const beadsExt = state.extensions && state.extensions.beads;
731
+ if (!beadsExt) return null;
732
+ const pools = [beadsExt.sprintTasks, beadsExt.backlogTasks];
733
+ for (const pool of pools) {
734
+ if (!Array.isArray(pool)) continue;
735
+ const match = pool.find((t) => t && String(t.id) === String(id));
736
+ if (match) return match;
737
+ }
738
+ return null;
739
+ }
740
+
741
+ export const beadsExtension = {
742
+ id: 'beads',
743
+ title: 'Tasks',
744
+ // apra-fleet-eft.37.4 (M3): the beads extension's detailLookup hook,
745
+ // called by core's generic GET /extensions/beads/detail/:itemId route
746
+ // (packages/apra-fleet-workflow/src/viewer/index.mjs) against the LIVE,
747
+ // full-fidelity `state` object. Returns the shape the hook contract
748
+ // requires -- `{text, updatedAt} | null` -- never the raw bead object,
749
+ // so core stays ignorant of bd's own field names (`description`,
750
+ // `updated_at`).
751
+ detailLookup(state, id) {
752
+ const bead = findBeadById(state, id);
753
+ if (!bead) return null;
754
+ return {
755
+ text: bead.description || '',
756
+ updatedAt: bead.updated_at || bead.updatedAt || null
757
+ };
758
+ },
759
+ js: `
760
+ ${escapeHtml.toString()}
761
+ ${renderBeadsHtml.toString()}
762
+ ${renderResultExtrasHtml.toString()}
763
+ ${computeSprintProgress.toString()}
764
+ ${renderProgressBarHtml.toString()}
765
+
766
+ // apra-fleet-eft.37.3: mounts the auto-sprint verdict badge + PR
767
+ // link into the header, next to core's generic (unstyled)
768
+ // #result-strip -- see viewer/index.mjs's 'workflow:result'
769
+ // CustomEvent, dispatched on every renderState() with
770
+ // state.result (core's opaque, workflow-declared result) as its
771
+ // detail. The container is created lazily on first non-empty
772
+ // render and removed again whenever there is nothing se-specific
773
+ // to show (e.g. before a run has finished).
774
+ function renderResultExtras(result) {
775
+ const html = renderResultExtrasHtml(result);
776
+ let el = document.getElementById('se-result-extras');
777
+ if (!html) {
778
+ if (el) el.remove();
779
+ return;
780
+ }
781
+ if (!el) {
782
+ const headerActions = document.querySelector('.header-actions');
783
+ if (!headerActions) return;
784
+ el = document.createElement('div');
785
+ el.id = 'se-result-extras';
786
+ el.style.display = 'flex';
787
+ el.style.gap = '8px';
788
+ el.style.alignItems = 'center';
789
+ headerActions.insertBefore(el, headerActions.firstChild);
790
+ }
791
+ el.innerHTML = html;
792
+ }
793
+
794
+ // apra-fleet-eft.27.2 / apra-fleet-eft.37.4 (M3): on-demand
795
+ // bead-description fetch + browser localStorage cache. GET /state
796
+ // now serves only a short \`summary\` per bead (apra-fleet-eft.27.1)
797
+ // -- the full text is fetched here, from the GENERIC
798
+ // GET /extensions/beads/detail/:itemId route (src/viewer/index.mjs,
799
+ // delegating to this extension's own \`detailLookup\` above -- the
800
+ // old sprint-named /beads/:id/description route is now core's
801
+ // one-release BOUNDARY-COMPAT alias, no longer called from here),
802
+ // the moment a user actually expands a row, and cached under the
803
+ // bead's id. Each cache entry also carries the \`updatedAt\` it was
804
+ // fetched against, so a later lean-state poll reporting a NEW
805
+ // updatedAt for that bead transparently invalidates the cache and
806
+ // triggers a refetch instead of ever serving stale text.
807
+ const BEAD_DESC_CACHE_PREFIX = 'apra-fleet-bead-desc:';
808
+
809
+ function beadDescCacheKey(id) { return BEAD_DESC_CACHE_PREFIX + id; }
810
+
811
+ function readBeadDescCache(id, updatedAt) {
812
+ try {
813
+ const raw = localStorage.getItem(beadDescCacheKey(id));
814
+ if (!raw) return null;
815
+ const parsed = JSON.parse(raw);
816
+ if (parsed && parsed.updatedAt === updatedAt) return parsed.description;
817
+ } catch (e) {
818
+ // Corrupt or unavailable cache entry -- treat as a miss,
819
+ // never let a caching problem break the expand action.
820
+ }
821
+ return null;
822
+ }
823
+
824
+ function writeBeadDescCache(id, updatedAt, description) {
825
+ try {
826
+ localStorage.setItem(beadDescCacheKey(id), JSON.stringify({ updatedAt: updatedAt, description: description }));
827
+ } catch (e) {
828
+ // localStorage full/unavailable (quota, private browsing) --
829
+ // non-fatal: the fetch itself already succeeded and rendered.
830
+ }
831
+ }
832
+
833
+ async function loadBeadDescription(detailsEl) {
834
+ const bodyEl = detailsEl.querySelector('.bead-desc-body');
835
+ // Already showing the full text (either a prior fetch/cache hit,
836
+ // or a caller that inlined the full description up front) --
837
+ // no network request on a repeat expand.
838
+ if (!bodyEl || bodyEl.dataset.loaded === 'true') return;
839
+
840
+ const id = detailsEl.dataset.beadId;
841
+ const updatedAt = detailsEl.dataset.updatedAt || '';
842
+
843
+ const cached = readBeadDescCache(id, updatedAt);
844
+ if (cached !== null) {
845
+ bodyEl.textContent = cached;
846
+ bodyEl.dataset.loaded = 'true';
847
+ return;
848
+ }
849
+
850
+ bodyEl.textContent = 'Loading...';
851
+ try {
852
+ const res = await fetch('/extensions/beads/detail/' + encodeURIComponent(id));
853
+ if (!res.ok) { bodyEl.textContent = '(description unavailable)'; return; }
854
+ const data = await res.json();
855
+ const description = data.text || '(no description)';
856
+ bodyEl.textContent = description;
857
+ bodyEl.dataset.loaded = 'true';
858
+ writeBeadDescCache(id, updatedAt, description);
859
+ } catch (e) {
860
+ bodyEl.textContent = '(failed to load description)';
861
+ }
862
+ }
863
+
864
+ // The 'toggle' event does not bubble in every browser, but it IS
865
+ // still observable during the capture phase regardless of bubbling
866
+ // -- a single document-level capture listener therefore catches
867
+ // every <details class="bead-desc"> toggle, including rows
868
+ // recreated by the full innerHTML rebuild below on each poll, with
869
+ // no per-row listener wiring or cleanup needed.
870
+ document.addEventListener('toggle', function (e) {
871
+ const el = e.target;
872
+ if (el && el.tagName === 'DETAILS' && el.classList && el.classList.contains('bead-desc') && el.open) {
873
+ loadBeadDescription(el);
874
+ }
875
+ }, true);
876
+
877
+ // apra-fleet-4p5: collapse state lives here, in this closure -- not
878
+ // on any DOM node -- so it survives the full innerHTML rebuild each
879
+ // 'workflow:state:beads' tick performs (the exact same rebuild that
880
+ // would otherwise silently reset every DETAILS element's \`open\`
881
+ // attribute, if bead descriptions relied on that instead of the
882
+ // cache above). \`lastBeadsData\` caches the most recent poll's
883
+ // payload so a pure collapse/expand click can re-render immediately
884
+ // without waiting on (or synthesizing) a new server payload.
885
+ const collapsedBeadIds = new Set();
886
+ let lastBeadsData = { sprintTasks: [], backlogTasks: [] };
887
+
888
+ function renderBeadsPanel() {
889
+ const container = document.getElementById('extension-beads');
890
+ if (!container) return;
891
+ // apra-fleet-x8r.1: the progress bar reflects THIS sprint's own
892
+ // scope (sprintTasks -- already the bdListScoped('') scope walk
893
+ // threaded through by runner.js/dashboard.mjs, never re-derived
894
+ // here), not the Backlog list alongside it.
895
+ // apra-fleet-x8r.4: goalMax/decomposedParentIds are runner.js-
896
+ // computed (updateDashboard()'s payload -- the SAME two axes its
897
+ // own completion gate filters on) and threaded through verbatim,
898
+ // never re-derived client-side.
899
+ const progress = computeSprintProgress(lastBeadsData.sprintTasks || [], {
900
+ goalMax: lastBeadsData.goalMax,
901
+ decomposedParentIds: lastBeadsData.decomposedParentIds,
902
+ });
903
+ container.innerHTML = renderProgressBarHtml(progress)
904
+ + renderBeadsHtml(lastBeadsData.sprintTasks || [], lastBeadsData.backlogTasks || [], collapsedBeadIds);
905
+ }
906
+
907
+ // Single document-level click-delegation listener (same rationale
908
+ // as the capture-phase 'toggle' listener above) catches every
909
+ // \`.tree-toggle\` click, including toggles on rows recreated by the
910
+ // innerHTML rebuild on each poll -- no per-row listener wiring or
911
+ // cleanup needed. \`data-toggle-id\` round-trips back to the original
912
+ // (unescaped) bead id or synthetic section key via HTML entity
913
+ // decoding, the same way \`data-bead-id\` already does above.
914
+ document.addEventListener('click', function (e) {
915
+ const toggle = e.target && e.target.closest ? e.target.closest('.tree-toggle') : null;
916
+ if (!toggle) return;
917
+ const id = toggle.dataset.toggleId;
918
+ if (!id) return;
919
+ if (collapsedBeadIds.has(id)) {
920
+ collapsedBeadIds.delete(id);
921
+ } else {
922
+ collapsedBeadIds.add(id);
923
+ }
924
+ renderBeadsPanel();
925
+ });
926
+
927
+ document.addEventListener('workflow:state:beads', (e) => {
928
+ lastBeadsData = e.detail || {};
929
+ renderBeadsPanel();
930
+ });
931
+
932
+ // apra-fleet-eft.37.3: mounts the auto-sprint verdict badge + PR
933
+ // link into the header, next to core's generic (unstyled)
934
+ // #result-strip -- see viewer/index.mjs's 'workflow:result'
935
+ // CustomEvent, dispatched on every renderState() with
936
+ // state.result (core's opaque, workflow-declared result) as its
937
+ // detail.
938
+ document.addEventListener('workflow:result', (e) => {
939
+ renderResultExtras(e.detail);
940
+ });
941
+ `
942
+ };