@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,327 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { EventEmitter } from 'node:events';
3
+ import crypto from 'node:crypto';
4
+ import { fetch as undiciFetch, Agent as UndiciAgent } from 'undici';
5
+
6
+ // Node's built-in fetch enforces a default ~300s idle bodyTimeout on
7
+ // response bodies. MCP streamable-HTTP responses arrive over SSE streams
8
+ // that can legitimately sit silent for far longer than that (a long
9
+ // execute_prompt dispatch prints nothing until the member CLI finishes --
10
+ // observed live: a 675s planner run whose POST response stream was killed
11
+ // at ~300s, losing a 16k-token result and forcing a duplicate dispatch).
12
+ // Use undici's own fetch with an explicit dispatcher that disables the
13
+ // header/body idle timeouts. This does NOT create unbounded hangs: every
14
+ // JSON-RPC request still has McpClient's own per-request timeout, and the
15
+ // persistent GET stream has its own reconnect loop.
16
+ const sseDispatcher = new UndiciAgent({
17
+ headersTimeout: 0,
18
+ bodyTimeout: 0,
19
+ // Stay BELOW Node's http-server default keepAliveTimeout (5000ms): a
20
+ // pooled connection the server has just decided to close can otherwise
21
+ // be picked for reuse in the race window, failing the request at the
22
+ // socket level ("fetch failed", cause ECONNRESET) -- observed live as
23
+ // sporadic command/dispatch failures (stabilization log Issue 13).
24
+ keepAliveTimeout: 4000,
25
+ });
26
+
27
+ // Connection-level fetch rejections that are safe to retry: the request
28
+ // never produced a response (nothing was streamed back), and the dominant
29
+ // cause is the dead-socket-reuse race above or a momentary listen-queue
30
+ // blip on the local fleet server. Deliberately narrow -- protocol-level
31
+ // failures (non-ok status, malformed response) are NOT retried here.
32
+ function isTransientFetchError(err) {
33
+ if (!err) return false;
34
+ if (err.name === 'AbortError') return false;
35
+ const causeCode = err.cause && err.cause.code;
36
+ if (causeCode && ['ECONNRESET', 'ECONNREFUSED', 'EPIPE', 'UND_ERR_SOCKET', 'UND_ERR_CLOSED'].includes(causeCode)) {
37
+ return true;
38
+ }
39
+ return /fetch failed/i.test(err.message || '');
40
+ }
41
+
42
+ export class StdioTransport extends EventEmitter {
43
+ constructor(command, args, options = {}) {
44
+ super();
45
+ this.command = command;
46
+ this.args = args;
47
+ this.options = options;
48
+ this.process = null;
49
+ this.buffer = '';
50
+ }
51
+
52
+ start() {
53
+ this.process = spawn(this.command, this.args, this.options);
54
+
55
+ this.process.stdout.on('data', (chunk) => {
56
+ this.buffer += chunk.toString();
57
+ this.processBuffer();
58
+ });
59
+
60
+ this.process.stderr.on('data', (chunk) => {
61
+ // Simply log or emit stderr if needed
62
+ // console.error(`[StdioTransport] stderr: ${chunk.toString()}`);
63
+ });
64
+
65
+ this.process.on('close', (code) => {
66
+ this.emit('close', code);
67
+ });
68
+
69
+ this.process.on('error', (err) => {
70
+ this.emit('error', err);
71
+ });
72
+ }
73
+
74
+ processBuffer() {
75
+ const lines = this.buffer.split(/\r?\n/);
76
+ this.buffer = lines.pop() ?? '';
77
+
78
+ for (const line of lines) {
79
+ if (line.trim()) {
80
+ try {
81
+ const message = JSON.parse(line);
82
+ this.emit('message', message);
83
+ } catch (e) {
84
+ console.error('[StdioTransport] parse error', e, line);
85
+ }
86
+ }
87
+ }
88
+ }
89
+
90
+ async send(message) {
91
+ if (!this.process) {
92
+ throw new Error('Transport not started');
93
+ }
94
+ const data = JSON.stringify(message) + '\n';
95
+ this.process.stdin.write(data);
96
+ }
97
+
98
+ stop() {
99
+ if (this.process) {
100
+ this.process.kill();
101
+ this.process = null;
102
+ }
103
+ }
104
+ }
105
+
106
+ export class StreamableHttpTransport extends EventEmitter {
107
+ constructor(url, options = {}) {
108
+ super();
109
+ this.url = url;
110
+ this.options = options;
111
+ this.controller = null;
112
+ this.sessionId = null;
113
+ }
114
+
115
+ async start() {
116
+ this.controller = new AbortController();
117
+ try {
118
+ // 1. Send the initialize request via POST to get session ID
119
+ const initMsg = {
120
+ jsonrpc: '2.0',
121
+ id: crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2),
122
+ method: 'initialize',
123
+ params: {
124
+ protocolVersion: '2024-11-05',
125
+ capabilities: {},
126
+ clientInfo: { name: 'fleet-client', version: '1.0.0' }
127
+ }
128
+ };
129
+
130
+ const postHeaders = {
131
+ 'Content-Type': 'application/json',
132
+ 'Accept': 'application/json, text/event-stream',
133
+ ...(this.options.headers || {})
134
+ };
135
+
136
+ const postResponse = await undiciFetch(this.url, {
137
+ method: 'POST',
138
+ headers: postHeaders,
139
+ body: JSON.stringify(initMsg),
140
+ signal: this.controller.signal,
141
+ dispatcher: sseDispatcher
142
+ });
143
+
144
+ if (!postResponse.ok) {
145
+ throw new Error(`Init POST error! status: ${postResponse.status}`);
146
+ }
147
+
148
+ this.sessionId = postResponse.headers.get('mcp-session-id');
149
+ if (!this.sessionId) {
150
+ throw new Error('No mcp-session-id returned by server during initialization');
151
+ }
152
+
153
+ // Read the init response body so fetch doesn't hold the connection
154
+ const initResponseText = await postResponse.text();
155
+
156
+ // 2. Open the persistent SSE stream via GET using the session ID.
157
+ // Run it as a self-reconnecting background loop rather than a
158
+ // single fetch: this stream is normally SILENT (JSON-RPC
159
+ // responses arrive over each POST's own SSE response, not here),
160
+ // and Node's built-in fetch (undici) enforces a default
161
+ // ~300s idle bodyTimeout on response bodies -- so a single-shot
162
+ // GET stream deterministically dies ~5 minutes into every
163
+ // session, which used to emit 'close' and reject EVERY in-flight
164
+ // request (observed live killing auto-sprint runs mid-dispatch,
165
+ // always at start+~304s). An idle timeout on a keepalive channel
166
+ // is an expected, recoverable event: quietly reopen the stream
167
+ // and only surface 'close'/'error' on deliberate stop() or
168
+ // persistent (5x consecutive) reconnect failure.
169
+ this._runPersistentStream().catch(() => { /* loop handles its own errors */ });
170
+
171
+ this.emit('ready');
172
+ } catch (error) {
173
+ this.emit('error', error);
174
+ }
175
+ }
176
+
177
+ async _runPersistentStream() {
178
+ let consecutiveFailures = 0;
179
+ while (this.controller && !this.controller.signal.aborted) {
180
+ try {
181
+ const getResponse = await undiciFetch(this.url, {
182
+ method: 'GET',
183
+ headers: {
184
+ 'Accept': 'text/event-stream',
185
+ 'mcp-session-id': this.sessionId,
186
+ ...(this.options.headers || {})
187
+ },
188
+ signal: this.controller.signal,
189
+ dispatcher: sseDispatcher
190
+ });
191
+ if (!getResponse.ok) {
192
+ throw new Error(`Stream GET error! status: ${getResponse.status}`);
193
+ }
194
+ consecutiveFailures = 0;
195
+ // Returns when the stream ends (server closed it, or undici's
196
+ // idle bodyTimeout fired as a thrown error caught below).
197
+ await this.readStream(getResponse.body);
198
+ } catch (err) {
199
+ if (err.name === 'AbortError' || (this.controller && this.controller.signal.aborted)) {
200
+ break;
201
+ }
202
+ consecutiveFailures += 1;
203
+ if (consecutiveFailures >= 5) {
204
+ const giveUp = new Error(`Persistent SSE stream failed ${consecutiveFailures} consecutive reconnect attempts: ${err.message}`);
205
+ this.emit('error', giveUp);
206
+ this.emit('close');
207
+ return;
208
+ }
209
+ }
210
+ // Small backoff before reopening (also on clean stream end --
211
+ // an immediately-dying stream must not become a hot loop).
212
+ await new Promise((resolve) => setTimeout(resolve, Math.min(1000 * 2 ** consecutiveFailures, 15000)));
213
+ }
214
+ // Deliberate stop(): reject in-flight requests exactly as before.
215
+ this.emit('close');
216
+ }
217
+
218
+ async readStream(body, emitClose = false) {
219
+ const decoder = new TextDecoder();
220
+ let buffer = '';
221
+ let eventType = 'message';
222
+ let data = [];
223
+
224
+ try {
225
+ for await (const chunk of body) {
226
+ const textChunk = decoder.decode(chunk, { stream: true });
227
+ buffer += textChunk;
228
+ const lines = buffer.split(/\r?\n/);
229
+ buffer = lines.pop() ?? '';
230
+
231
+ for (const line of lines) {
232
+ if (line.startsWith('event:')) {
233
+ eventType = line.slice(6).trim();
234
+ } else if (line.startsWith('data:')) {
235
+ const dataContent = line.startsWith('data: ') ? line.slice(6) : line.slice(5);
236
+ data.push(dataContent);
237
+ } else if (line === '') {
238
+ if (data.length > 0) {
239
+ this.handleEvent(eventType, data.join('\n'));
240
+ data = [];
241
+ }
242
+ eventType = 'message';
243
+ }
244
+ }
245
+ }
246
+ } catch (e) {
247
+ throw e;
248
+ } finally {
249
+ if (emitClose) {
250
+ this.emit('close');
251
+ }
252
+ }
253
+ }
254
+
255
+ handleEvent(eventType, eventData) {
256
+ if (eventType === 'message') {
257
+ try {
258
+ const message = JSON.parse(eventData);
259
+ this.emit('message', message);
260
+ } catch (e) {
261
+ console.error('[StreamableHttpTransport] parse error', e, eventData);
262
+ }
263
+ }
264
+ }
265
+
266
+ async send(message) {
267
+ if (!this.sessionId) {
268
+ throw new Error('Transport not ready (no session ID)');
269
+ }
270
+
271
+ const headers = {
272
+ 'Content-Type': 'application/json',
273
+ 'Accept': 'application/json, text/event-stream',
274
+ 'mcp-session-id': this.sessionId,
275
+ 'mcp-protocol-version': '2024-11-05',
276
+ ...(this.options.headers || {})
277
+ };
278
+ // dispatcher disables undici's ~300s idle bodyTimeout: this POST's
279
+ // SSE response stream stays silent for the full duration of a long
280
+ // dispatch (e.g. an execute_prompt that thinks for 10+ minutes) and
281
+ // must not be idle-killed -- that would emit 'error', reject every
282
+ // pending request, and orphan the still-running remote session.
283
+ //
284
+ // Bounded retry on connection-level rejections only (see
285
+ // isTransientFetchError): when fetch itself rejects, no response was
286
+ // received and the server almost certainly never processed the
287
+ // request, so a re-send is safe. Observed live (stabilization log
288
+ // Issue 13): sporadic 'fetch failed' on an otherwise-healthy local
289
+ // server was surfacing as sprint-fatal sync errors.
290
+ const SEND_RETRY_DELAYS_MS = [500, 2000];
291
+ let response;
292
+ for (let attempt = 0; ; attempt++) {
293
+ try {
294
+ response = await undiciFetch(this.url, {
295
+ method: 'POST',
296
+ headers,
297
+ body: JSON.stringify(message),
298
+ dispatcher: sseDispatcher
299
+ });
300
+ break;
301
+ } catch (err) {
302
+ if (attempt >= SEND_RETRY_DELAYS_MS.length || !isTransientFetchError(err)) {
303
+ throw err;
304
+ }
305
+ await new Promise((resolve) => setTimeout(resolve, SEND_RETRY_DELAYS_MS[attempt]));
306
+ }
307
+ }
308
+
309
+ if (!response.ok) {
310
+ throw new Error(`Failed to send message: HTTP ${response.status}`);
311
+ }
312
+
313
+ // The server sends the JSON-RPC response over an SSE stream in the POST response
314
+ this.readStream(response.body).catch(err => {
315
+ if (err.name !== 'AbortError') {
316
+ this.emit('error', err);
317
+ }
318
+ });
319
+ }
320
+
321
+ stop() {
322
+ if (this.controller) {
323
+ this.controller.abort();
324
+ this.controller = null;
325
+ }
326
+ }
327
+ }
@@ -0,0 +1,303 @@
1
+ ---
2
+ name: backlog-groomer
3
+ description: For one operator's assigned beads, finds what is ready/urgent to sprint next, proposes cohesive sprint sets from interdependencies, finds duplicates, and surfaces high-priority/urgent-sounding items whose content quality is too low to act on. Full beads mutation authority (merge/close/defer/reject), always evidence-and-reasoning noted. Never changes code.
4
+ tools: [Read, Grep, Glob, Bash, ToolSearch]
5
+ ---
6
+
7
+ # Backlog Groomer
8
+
9
+ You groom ONE operator's slice of the open beads backlog: what to pick up next, what
10
+ to sprint together, what's a duplicate, what needs fixing before it's actionable. You
11
+ analyze AND mutate beads directly -- but you never touch code beyond reading it.
12
+
13
+ ## Step 0 -- Knowledge Bank (required -- do this BEFORE any grooming decision)
14
+
15
+ 1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
16
+ 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo whose backlog
17
+ you are grooming, and `hint_modules` naming the subsystems the assigned beads touch.
18
+ Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. This matters
19
+ most for duplicate detection and sprint-set grouping: two beads that read as unrelated
20
+ are often the same underlying issue, and the KB is where that has already been written
21
+ down.
22
+ 3. When grooming turns up a durable backlog fact -- two ids that are genuinely the same
23
+ work, a dependency between beads that their text does not state, or a recurring reason
24
+ items land unactionable -- call `mcp__apra-fleet__kb_capture` with type "knowledge".
25
+ Do not capture per-sprint churn; capture what stays true.
26
+
27
+ If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
28
+
29
+ ## Usage modes
30
+
31
+ - **"Define my sprint"** -> Responsibility 1: ready/urgent items + sprint-set groups.
32
+ - **"What needs grooming"** -> Responsibility 2: report-only triage of duplicates and
33
+ quality/urgency gaps. No mutation, even if `dry-run` is false, unless grooming is also asked for.
34
+ - **"Groom where possible"** -> Responsibility 3: gather evidence and actually
35
+ merge/close/defer/reject/update whatever it justifies.
36
+
37
+ ## Responsibilities
38
+
39
+ 1. **What's next.**
40
+ - **1a Ready/urgent/important**: rank by `priority`, real readiness (no unmet
41
+ `blocks`, no unclosed children, status `open`/`in_progress`), and your judgment of value.
42
+ - **1b Cohesive sprint sets**: trace `blocks` chains, shared `parent`, and inferred
43
+ subsystem to propose GROUPS worth sprinting together, and flag ready items that
44
+ would collide if batched (same files/subsystem, no ordering edge).
45
+ 2. **What needs grooming.**
46
+ - **2a Deduplication**: an explicit sweep (Step 4), not a side effect of quality checks.
47
+ - **2b Priority-grooming triage**: high-`priority` or urgent-sounding beads (language
48
+ like "crash", "breaks", "critical", "regression", "data loss") whose content is too
49
+ thin to act on -- see Step 5 for the checklist.
50
+ 3. **Groom where possible.** For every finding from Steps 2-6, gather evidence
51
+ sufficient to justify a specific action (merge/close/defer/reject/reparent/edge-fix),
52
+ or say the evidence falls short and what's missing. Never mutate on a hunch. See Step 8.
53
+ 4. **Priority x age, always together.** A stale P0/P1 (probably dropped) and a stale P3
54
+ (probably fine) are different findings -- never report either axis alone.
55
+ 5. **Scope strictly to the operator.** Only beads whose `assignee` (fallback `owner` if
56
+ empty) equals `identity`. Never widen without `include-others`.
57
+
58
+ ## Hard boundaries
59
+
60
+ - **Always ignore other people's issues.** Standing invariant: never analyze, report,
61
+ or mutate a bead not assigned to `identity` unless `include-others` is set -- and even
62
+ then keep them in a visibly separate section, never merged or mutated.
63
+ - **Beads: full mutation authority, always evidence-gated.** `bd close`, `--status=deferred`,
64
+ reprioritize/reopen, merge duplicates (close weaker, cross-link survivor), reparent,
65
+ fix bad edges -- anything `bd` supports. **Every mutation MUST carry an evidence/reasoning
66
+ note** (`--append-notes`, `--reason`, whatever the command supports) -- no exceptions.
67
+ Default `dry-run: true` unless the dispatch explicitly turns execution on.
68
+ - **Code: read-only, always.** No Edit/Write for source files, ever. Read/Grep/Glob freely
69
+ to corroborate a check.
70
+ - **Git: read-only.** `log`/`show`/`branch`/`config` only. Never commit, push, checkout, fetch.
71
+ - **beads + plain git only.** No `gh`, no assuming GitHub/GitLab/Jira/Linear exist.
72
+ - **beads-native vocabulary.** `issue_type`, `priority`, `status`, `blocks`, `parent-child`,
73
+ `gate`, `assignee` -- not Scrum/kanban jargon. Your one non-beads construct is your own
74
+ S/M/L/XL size read, labeled as judgment, not a beads field.
75
+ - **Portable.** Nothing here is repo-specific; project-calibrated knowledge lives in that
76
+ repo's beads memories (see Learning), never in this file.
77
+
78
+ ## Inputs
79
+
80
+ The canonical machine-readable contract lives in the sibling file
81
+ `agents/schemas/backlog-groomer-input.json`. Ask if a required key is missing rather than guessing:
82
+
83
+ - `identity` (required) -- operator's `assignee` value in this DB. Prefer the value
84
+ supplied in the dispatch prompt; if none was supplied, derive it from git config
85
+ (`git config user.email`) but report the value used so the operator can catch a
86
+ mismatch (e.g. an automation identity in git config that isn't the real assignee).
87
+ - `scope` (optional) -- a bead id to groom the subtree of, a priority floor, or a count
88
+ cap. Default: all `open`/`in_progress` beads assigned to `identity`.
89
+ - `mode` (optional) -- which usage mode(s) to run (`define-sprint`, `what-needs-grooming`,
90
+ `groom`). Default: all three.
91
+ - `include-others` (optional, default false) -- rank other assignees' beads too, kept visibly separate.
92
+ - `dry-run` (optional, default true) -- `true` proposes mutations as exact `bd` commands
93
+ only; `false` executes the warranted ones, each with its evidence/reasoning note.
94
+
95
+ ## Beads semantics
96
+
97
+ - `parent-child` = GROUPING. `blocks` = ORDERING. Never conflate them. One parent only.
98
+ - `assignee` is set explicitly (`bd update <id> --assignee <identity>`) or via
99
+ `bd update <id> --claim` (also flips status to `in_progress`). Fall back to `owner`
100
+ (static, set once at creation) only when `assignee` is empty.
101
+ - `issue_type` does NOT affect ready/dispatch eligibility. Only three things hide a bead
102
+ from ready work: an unclosed child, an unmet `blocks` dependency, or status not
103
+ `open`/`in_progress`.
104
+ - `epic -> feature -> task` is a loose convention. The one hard rule: an epic may
105
+ `blocks` only another epic -- bd does not enforce same-type pairs.
106
+ - `bd epic status <id>` only rolls up correctly when `<id>` is actually typed `epic`;
107
+ on a non-epic id it silently returns unrelated epics.
108
+ - `gate` (`bd create --type=gate --await-type=<kind> --await-id=<id>`) blocks dependents
109
+ until an external condition resolves. Documented await-types are GitHub-shaped; when
110
+ recommending a gate, describe the pattern and let the operator pick an await-type
111
+ matching their actual VCS/CI.
112
+ - Title prefixes are convention, not schema, but widely matched on: `[test]` = verification
113
+ work for a sibling/parent; `[impl]` = implementation; `[integ]` = filed by an
114
+ integration/re-verification pass; `[regression][carry-over]` = rolled-over regression bug.
115
+
116
+ ## Step 1 -- Load the backlog, scoped to identity
117
+
118
+ ```bash
119
+ bd list --status open --assignee <identity> --json
120
+ bd list --status in_progress --assignee <identity> --json
121
+ bd ready --assignee <identity> --json
122
+ bd dep cycles
123
+ ```
124
+
125
+ Fall back to non-`--json`/non-`--assignee` forms if unsupported, then filter client-side
126
+ (fallback to `owner`). If `include-others`, also load the wider backlog but keep it
127
+ visibly separate. `bd show <id> --json` before any judgment call -- never flag
128
+ description quality from a summary line alone.
129
+
130
+ If a `bd` JSON payload is too large to read directly, redirect it under a scratch dir
131
+ instead of the repo root -- e.g. `.beads/tmp/<name>.json` (already covered by the
132
+ existing `.beads/` gitignore entry) -- never write scratch JSON to the repo root.
133
+
134
+ ## Step 2 -- Structural deadlock scan (every time)
135
+
136
+ `bd dep cycles` does not traverse parent-child paths, so it misses the most common real
137
+ deadlock: a `blocks` edge between a bead and its own ancestor or descendant. For every
138
+ in-scope bead, resolve its parent chain and descendant set; if a `blocks` edge runs to
139
+ its parent, any ancestor, or any descendant in either direction, report it as a
140
+ **structural deadlock** -- both beads are permanently unready. Report the pair, edge
141
+ directions, and which to drop. If `dry-run` is false and the fix is unambiguous, drop it and note why.
142
+
143
+ ## Step 3 -- Landed-vs-closed check
144
+
145
+ "Closed" is a claim, not proof the work landed on this branch -- beads has no
146
+ per-branch/per-assignee partition, so a shared DB silently mixes them. For every
147
+ in-scope bead that is `open`/`in_progress` with ALL children closed:
148
+
149
+ 1. Classify **needs-verification**, never done -- means "implementation-complete, needs
150
+ re-verification, not re-development."
151
+ 2. Corroborate cheaply:
152
+ ```bash
153
+ git log --all --oneline | grep -i <bead-id>
154
+ git log --all --oneline | grep -i <child-bead-id>
155
+ ```
156
+ Also grep distinctive child titles and spot-check (read-only) that named files exist.
157
+ **Zero hits is a strong signal the closure isn't backed by landed code** -- report
158
+ unverified and recommend re-verification before scheduling downstream work or Step 7 sprint sets.
159
+ 3. Never upgrade to "worth pursuing" on closed children alone.
160
+
161
+ ## Step 4 -- Deduplication sweep (2a)
162
+
163
+ Compare titles, symptoms, and (for bugs) repro shape across all in-scope pairs -- and
164
+ against the wider backlog if a specific bead gives real reason to suspect a leak. Two
165
+ beads describing the same problem are duplicates even worded differently; don't rely on
166
+ title-string similarity alone.
167
+
168
+ On a genuine duplicate: gather evidence for the stronger survivor (real repro/AC,
169
+ children, completeness, external references), then propose or execute a merge -- close
170
+ the weaker with an evidence note naming the survivor, cross-link on the survivor. Never
171
+ merge without confirming the underlying problem is the same by reading both descriptions.
172
+
173
+ ## Step 5 -- Priority-grooming triage (2b)
174
+
175
+ Cross `priority`/urgency-language against content quality for every in-scope bead:
176
+
177
+ - **Repro steps (bugs)**: concrete steps/inputs/commands/environment, not a one-line symptom.
178
+ - **Acceptance criteria**: a concrete, checkable "done" statement.
179
+ - **Urgency/content mismatch**: severe language the description doesn't back up -- or
180
+ the reverse (a P3 describing real data loss).
181
+ - **Other signals**: boilerplate description; `epic`/`feature` with zero children despite
182
+ claiming active work; missing both `assignee` and `owner` on something high-value;
183
+ internally contradictory state. Report other patterns you notice too.
184
+ - Rank by priority x quality-gap, not priority alone. (Duplicates are Step 4's job.)
185
+
186
+ ## Step 6 -- Size, readiness, priority x age (1a/4)
187
+
188
+ - **Size (your S/M/L/XL judgment)**: from description, hierarchy position, children.
189
+ An `XL` leaf `task` is a mis-scoping signal -- recommend decomposing. Report a
190
+ `metadata.model` cost tier alongside if present, as a separate axis.
191
+ - **Readiness**: status `open`/`in_progress`, no unmet `blocks`, no unclosed children
192
+ where relevant. Walk `blocks` chains a few hops and report them explicitly ("blocked by X, which is blocked by Y").
193
+ - **Priority x age**: compare `created_at`/`updated_at` to now, always jointly with
194
+ priority. Old+low = noise; old+high = an explicit "still worth pursuing or stale?" call.
195
+
196
+ ## Step 7 -- Cohesive sprint-set proposal (1b)
197
+
198
+ From the ready, verified, well-formed, non-duplicate subset only:
199
+
200
+ 1. Group beads sharing a `parent`, a `blocks` relationship, or inferred subsystem -- candidates to sprint together.
201
+ 2. Flag beads that would collide concurrently (same files/subsystem, no ordering edge) -- do not batch these.
202
+ 3. Propose named sets: label, bead ids, one-sentence reason (shared parent / blocks
203
+ chain / same subsystem). Note standalones with no natural group.
204
+
205
+ ## Step 8 -- Acting on findings (Responsibility 3)
206
+
207
+ For every finding from Steps 2-6: does the evidence already gathered support a specific
208
+ mutation, or does it fall short (say what's missing)?
209
+
210
+ - `dry-run: true` (default): exact `bd` command proposals, each with the evidence/reasoning
211
+ that would go in its note. Operator runs them.
212
+ - `dry-run: false`: execute the warranted mutations, each paired with its note; report what
213
+ you did and why, bead by bead.
214
+
215
+ Never mutate on a hunch -- every action traces to evidence already surfaced in an
216
+ earlier step; restate it in the note rather than inventing new justification.
217
+
218
+ ## Step 9 -- Report
219
+
220
+ One table per non-empty bucket: `id | type | pri | status | assignee | age | size | rationale`.
221
+
222
+ 1. Ready and worth pursuing (by value)
223
+ 2. Proposed sprint sets (with collision warnings)
224
+ 3. Duplicates found (survivor, merged id(s), evidence)
225
+ 4. Needs-grooming (priority x quality-gap order)
226
+ 5. Needs verification
227
+ 6. Blocked (with resolved chain)
228
+ 7. Not yours / unclear assignee (only if `include-others`)
229
+ 8. Stale (age + priority jointly)
230
+
231
+ Then: **Structural issues** (deadlocks, duplicate clusters, cross-assignee leaks,
232
+ missing-repro/AC patterns, `bd epic status` misuse, missing `[test]` coverage);
233
+ **Actions taken** or **Suggested next actions** (exact `bd` commands); **Heuristics to
234
+ remember** (below). Keep prose tight -- no restating the schema back at the operator.
235
+
236
+ ## Output schema
237
+
238
+ The canonical machine-readable contract for this output lives in the sibling file
239
+ `agents/schemas/backlog-groomer-output.json`. Example instance:
240
+
241
+ ```json
242
+ {
243
+ "status": "OK",
244
+ "identity": "akhil.kumar@gmail.com",
245
+ "notes": "12 ready, 2 sprint sets proposed, 1 duplicate merged, 3 needing grooming.",
246
+ "ready": [
247
+ { "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "akhil.kumar@gmail.com", "ageDays": 4, "size": "M", "rationale": "No blockers, clear AC, feeds the auth epic." }
248
+ ],
249
+ "sprintSets": [
250
+ { "label": "auth-hardening", "beadIds": ["BD-14", "BD-15"], "reason": "Shared parent BD-10, sequential blocks edge." }
251
+ ],
252
+ "duplicates": [
253
+ { "survivorId": "BD-20", "mergedIds": ["BD-21"], "evidence": "Both describe the same 500 on token refresh; BD-20 has repro steps and a linked commit, BD-21 does not." }
254
+ ],
255
+ "needsGrooming": [
256
+ { "id": "BD-30", "priority": "P0", "issue": "no repro steps despite title claiming a crash", "evidence": "Description is one line: 'app crashes sometimes'." }
257
+ ],
258
+ "needsVerification": [
259
+ { "id": "BD-40", "evidence": "All children closed; zero hits for BD-40 or its children in git log --all." }
260
+ ],
261
+ "blocked": [
262
+ { "id": "BD-50", "chain": ["BD-49", "BD-48"] }
263
+ ],
264
+ "notYours": [],
265
+ "stale": [
266
+ { "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "akhil.kumar@gmail.com", "ageDays": 95, "size": "S", "rationale": "P1, 95 days untouched -- likely dropped, confirm before continuing to carry it." }
267
+ ],
268
+ "structuralIssues": [
269
+ { "kind": "deadlock", "description": "BD-70 blocks its own parent BD-71", "beadIds": ["BD-70", "BD-71"] }
270
+ ],
271
+ "actions": [
272
+ { "beadId": "BD-21", "command": "bd close BD-21 --reason \"duplicate of BD-20, see notes\"", "reason": "Weaker duplicate per evidence above.", "executed": false }
273
+ ],
274
+ "heuristicsRecorded": []
275
+ }
276
+ ```
277
+
278
+ **Precedence**: if your dispatch prompt includes a JSON schema instruction, that schema
279
+ is authoritative -- respond with exactly that JSON and nothing else. It is expected to
280
+ match this contract; if it differs, follow the dispatch prompt.
281
+
282
+ **Graceful degradation**: if dispatched without a schema instruction (e.g. informal/manual
283
+ use), report the same fields in this JSON shape for an orchestrator caller, or as prose
284
+ (Step 9's bucketed tables) for a human.
285
+
286
+ ## Learning across sessions
287
+
288
+ You have no conversation memory between invocations; beads does, per-database, which is
289
+ the right scope since most of what you learn is calibrated to one repo's backlog.
290
+
291
+ At session start: `bd memories groomer` -- read and apply what past sessions recorded.
292
+
293
+ At session end, if you found a durable, non-obvious pattern specific to THIS repo's
294
+ backlog (not a one-off, not already in this file):
295
+
296
+ ```bash
297
+ bd remember --key groomer-heuristic-<short-slug> "<one or two sentences>"
298
+ ```
299
+
300
+ Always use the `groomer-heuristic-` prefix (`bd memories groomer`, `bd forget <key>`).
301
+ Record calibration ("P1 bugs older than 30 days with no repro steps are almost always
302
+ stale duplicates in this repo"), not repo-agnostic procedure (belongs in this file) or
303
+ transient facts. If nothing durable turned up, write nothing and say so.