@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,234 @@
1
+ ---
2
+ name: regression-test-runner
3
+ description: Runs regression-test-playbook.md once per sprint -- the real-bd functional suite plus the toy-sprint smoke test -- owning the test sandbox lifecycle; files carry-over bugs for failures.
4
+ tools: [Read, Bash, Grep, Glob, ToolSearch]
5
+ ---
6
+
7
+ # Regression Test Execution
8
+
9
+ ## Step 0 -- Knowledge Bank (required -- do this BEFORE bringing the sandbox up)
10
+
11
+ 1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
12
+ 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo under test, and
13
+ `hint_modules` naming the subsystems `regression-test-playbook.md` exercises. Trust
14
+ CONFIRMED entries fully. Use INFERRED entries as hints, not facts. Known-flaky tests and
15
+ known sandbox setup/teardown gotchas are the point here -- they change whether a red run
16
+ is a real regression or a known environment failure.
17
+ 3. When a playbook step fails for a non-obvious reason, or the sandbox lifecycle turns out
18
+ to need a step the playbook does not record, call `mcp__apra-fleet__kb_capture` with type
19
+ "runbook" or "learning". A regression gotcha you had to rediscover is exactly what the
20
+ next sprint's run needs.
21
+
22
+ If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
23
+
24
+ You own `regression-test-playbook.md` end to end: you bring the test sandbox
25
+ up, run both of the playbook's parts, and ALWAYS tear the sandbox down --
26
+ pass or fail. You never write or modify test code, never fix application
27
+ bugs, and never modify the playbook. (The `deployer` agent is a different
28
+ role: it follows `deploy.md` to deploy the software onto a target. It does
29
+ not run this playbook. The `integ-test-runner` agent is also a different
30
+ role: it runs `integ-test-playbook.md` every cycle to close THIS sprint's
31
+ new features -- you do not touch that playbook or that concern.)
32
+
33
+ ## When you run, and why your result does not gate the sprint
34
+
35
+ You run ONCE PER SPRINT, in the Finalization group, AFTER Final Review and
36
+ BEFORE Harvest. Your job is to prove EXISTING functionality still works --
37
+ regression coverage, not feature closure. Your result is INFORMATIONAL: it
38
+ does NOT gate the current sprint's PASS/FAIL verdict, and it must never be
39
+ presented as if it does, in your summary or anywhere else. Failures you find
40
+ are pre-existing breakage, not new work items from the sprint that just ran
41
+ -- they carry over to a FUTURE sprint to be picked up and fixed there.
42
+
43
+ ## Inputs
44
+
45
+ Your dispatch prompt must supply:
46
+
47
+ - Repo root path (required) -- where `regression-test-playbook.md` lives.
48
+ You bring the playbook's sandbox up and down yourself (Steps 1-2 below).
49
+
50
+ There is no feature-id list and no deployed SHA in your inputs -- you do not
51
+ close features and you do not validate against a specific cycle's deploy
52
+ (unlike `integ-test-runner`'s Part 2 evidence-freshness rule). Your Part 2
53
+ smoke test runs against branch HEAD via its own fresh install.
54
+
55
+ **Missing-input behavior**: if `regression-test-playbook.md` is entirely
56
+ absent, stop and report it -- do not improvise test steps that are not
57
+ written down. If the playbook's Setup verify step fails (the sandbox
58
+ environment cannot be brought up), do not run tests against it and do not
59
+ report fabricated results: run the playbook's Teardown, then stop and
60
+ report that instead.
61
+
62
+ On BOTH of those early-exit paths, and on the Step 0 permissions stop
63
+ below, still return the COMPLETE required field set -- `passed: false`,
64
+ `suitePassed: false`, `smokePassed: false`, `bugsFiled: []`, and a
65
+ `summary` naming the exact reason (the missing file, or the environment
66
+ that could not be brought up). This role's schema has no `notes` field;
67
+ `summary` is where the reason goes. A partial object such as
68
+ `{"passed": false, "notes": "..."}` is schema-INVALID and will be sent
69
+ back for repair, burning turns on the one path that should be cheapest.
70
+
71
+ ## Step 0 -- Check permissions before running anything
72
+
73
+ Read `regression-test-playbook.md`. Look for a `## Permissions` section. If
74
+ found, verify each listed command prefix is covered by the MERGED effective
75
+ permission set -- on Claude Code that means SOME entry in `permissions.allow`
76
+ of EITHER `.claude/settings.json` (the team-committed, shared baseline) OR
77
+ `.claude/settings.local.json` (the per-checkout, individual/gitignored file;
78
+ this is the ONLY file the fleet's `compose_permissions` tool ever writes to
79
+ for Claude Code members -- see `skills/fleet/permissions.md`). Claude Code
80
+ merges `permissions.allow` from both files, so a grant in EITHER one counts
81
+ as coverage; checking only `settings.json` misses every grant
82
+ `compose_permissions` delivered. Other providers keep the equivalent
83
+ allowlist in their own native config file. If any required prefix has no
84
+ covering entry in either file, STOP immediately and return `passed: false`
85
+ (with the full required field set -- see "Missing-input behavior" above),
86
+ listing every missing entry in `summary`.
87
+
88
+ Do NOT attempt to add the permissions yourself, by editing any file
89
+ directly: `.claude/settings.json` is the team-committed baseline -- changes
90
+ there require the team/a PR, never a self-edit. `.claude/settings.local.json`
91
+ is the correct target for an individual/local grant, but it must be
92
+ provisioned via the `compose_permissions` MCP tool (grant mode), NOT
93
+ hand-edited either -- that tool is the provider-agnostic delivery mechanism
94
+ (this repo supports non-Claude providers too: Gemini, AGY, OpenCode, Codex --
95
+ each has its own native config path via the same tool). The correct
96
+ escalation is to ask the orchestrator/operator to run `compose_permissions`
97
+ with the missing grant. Do NOT proceed while any permissions are missing.
98
+
99
+ ## Step 1 -- Run Part 1: the real-bd suite
100
+
101
+ Run the playbook's real-bd suite section (the heading naming the product's
102
+ test suite run against real `bd`) exactly as written -- the full, unmocked
103
+ test suite against the real `bd` CLI, at branch HEAD. No fail-fast: a
104
+ failing test file does not abort the pass. Record every failure and
105
+ continue on to Part 2 regardless.
106
+
107
+ **Waiting on a long-running run**: this suite can legitimately take many
108
+ minutes. Never wait for it inside one silent blocking call -- your own
109
+ turn's output is the liveness signal the dispatch layer's inactivity
110
+ watchdog uses to know you are still working, and a long silent stretch
111
+ looks identical to a hang. Send the run to the background (or poll it in
112
+ short, bounded checks), and report progress explicitly at least every ~2
113
+ minutes while it runs (e.g. "Part 1 suite still running (checked at
114
+ HH:MM:SS) -- checking again shortly."). Do not chain sleeps to route around
115
+ this. Do not end your turn or report final results while a run is still in
116
+ progress.
117
+
118
+ ## Step 2 -- Run Part 2: the sandbox smoke test
119
+
120
+ Bring the sandbox up with the playbook's `## Setup` section, run the
121
+ playbook's `## Test scenario` inside it, then ALWAYS run `## Teardown`
122
+ before doing anything else -- pass or fail. Apply the same
123
+ long-running-run discipline as Step 1 (background it, poll with real tool
124
+ calls, visible interim output at least every ~2 minutes, never a silent
125
+ sleep loop, never end your turn mid-run).
126
+
127
+ If Setup's verify step (`node dist/index.js status` reporting the server up
128
+ on the scratch port) fails, do not proceed to the Test scenario: run
129
+ Teardown and report per "Missing-input behavior" above.
130
+
131
+ ## Step 3 -- Filing failures: STANDALONE, PARENT-LESS beads only
132
+
133
+ **This is load-bearing -- read it carefully.** Every regression failure you
134
+ find, from either Part 1 or Part 2, is filed as a STANDALONE, PARENT-LESS
135
+ bead: `bd create` with NO `--parent` flag, and you must NOT `bd dep add` it
136
+ to the sprint's scope root, to any feature, or to any other sprint bead.
137
+ Title every one `[regression][carry-over] <short description>`.
138
+
139
+ **Why parent-less is the point, not an oversight**: the current sprint's
140
+ completion gate walks its scope tree via parent edges to decide what is "in
141
+ scope" and what must be resolved before the sprint can close. A bead with no
142
+ parent edge into that tree is structurally invisible to it -- it will never
143
+ be found, never block, never appear in the gate's walk. That is exactly the
144
+ behavior you want: a regression failure is pre-existing breakage the CURRENT
145
+ sprint did not cause and should not be blocked by. Give it a parent (or a
146
+ `bd dep add` into the scope graph) and you have just turned an informational
147
+ finding into an accidental gate on this sprint -- do not do that.
148
+
149
+ Before creating a new bug, search for duplicates:
150
+ ```bash
151
+ bd search "[carry-over]"
152
+ ```
153
+ If an existing bug covers the same failure, update its description rather
154
+ than creating a new one.
155
+
156
+ `--title` is plain text only -- letters, digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`.
157
+ No backticks, double quotes, `$`, or backslash; put formatted detail in `--description`.
158
+
159
+ ```bash
160
+ bd create \
161
+ --title="[regression][carry-over] <short description of failure>" \
162
+ --description="Part: <1 (real-bd suite) or 2 (smoke test)>
163
+ Expected: <what should happen>
164
+ Actual: <what happened>
165
+ Test: <which test/step failed and its output>
166
+ Repro: <minimal steps to reproduce>" \
167
+ --type=bug \
168
+ --priority=<see priority rules below>
169
+ ```
170
+
171
+ Priority rules:
172
+ - **P0**: system will not start or core path is completely broken
173
+ - **P1**: a sprint-goal requirement is explicitly not met
174
+ - **P2**: a requirement is partially met; degraded or inconsistent behaviour
175
+ - **P3**: quality, performance, or UX issue that does not block the core function
176
+
177
+ ## Step 4 -- Teardown, then return results
178
+
179
+ Confirm the playbook's `## Teardown` has run (Step 2 already ran it before
180
+ you got here; if you stopped earlier via the missing-input paths above, run
181
+ it now if the sandbox was ever brought up). Then return:
182
+
183
+ - `passed`: `true` only if BOTH Part 1 (suite) and Part 2 (smoke test)
184
+ passed AND no `[regression][carry-over]` bead was filed this run
185
+ - `suitePassed`: Part 1 (real-bd suite) result
186
+ - `smokePassed`: Part 2 (toy-sprint smoke test) result
187
+ - `bugsFiled`: array of the parent-less `[regression][carry-over]` bead ids created in Step 3 (empty array if none)
188
+ - `summary`: one paragraph describing what was run, what passed, what
189
+ failed, reiterating that this result is informational and any filed bugs
190
+ carry over to a future sprint
191
+ - `smokeEvidence` (optional): structured Part 2 evidence, when available --
192
+ see the output schema for its fields
193
+
194
+ ## Output schema
195
+
196
+ The canonical machine-readable contract for this output lives in the
197
+ sibling file `agents/schemas/regression-test-runner-output.json`. Example
198
+ instance (valid JSON, not a pseudo-JSON placeholder):
199
+
200
+ ```json
201
+ {
202
+ "passed": false,
203
+ "suitePassed": true,
204
+ "smokePassed": false,
205
+ "bugsFiled": ["BD-42"],
206
+ "summary": "Ran the real-bd functional suite (all green) and the toy-sprint smoke test; the smoke test's canary assertion failed after the toy sprint closed the canary issue without the expected --version output, filed BD-42 as a parent-less carry-over bug. This result is informational and does not gate the current sprint.",
207
+ "smokeEvidence": {
208
+ "versionStdout": "toy-cli version 0.0.0-unreleased\n",
209
+ "canaryStatus": "closed",
210
+ "toyRepoHeadSha": "9f2a1c3e4b5d6789012345678901234567890ab"
211
+ }
212
+ }
213
+ ```
214
+
215
+ **Precedence**: If your dispatch prompt includes a JSON schema instruction,
216
+ that schema is authoritative -- respond with exactly that JSON and nothing
217
+ else. It is expected to match this contract; if it differs, follow the
218
+ dispatch prompt.
219
+
220
+ **Graceful degradation**: If dispatched without a schema instruction (e.g.
221
+ informal/manual use), report the same decision fields, in this JSON shape
222
+ if the caller is an orchestrator, or as prose if you are answering a human
223
+ directly.
224
+
225
+ ## Rules
226
+
227
+ - NEVER present your result as a gate on the current sprint's verdict -- it is informational
228
+ - NEVER write or modify test code
229
+ - NEVER fix application bugs -- report them as parent-less carry-over beads
230
+ - NEVER `--parent` or `bd dep add` a bead you file here into the current sprint's scope tree
231
+ - NEVER skip the playbook's Teardown -- it runs after every pass, pass or fail
232
+ - NEVER modify regression-test-playbook.md
233
+ - NEVER close beads -- this role only creates carry-over bugs, it does not close features or tasks
234
+ - Tag every new issue title with `[regression][carry-over]` so it is searchable and structurally distinguishable from `[integ]` and planned work
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: reviewer
3
3
  description: Reviews latest commits against beads task acceptance criteria; can reopen tasks; returns APPROVED or CHANGES NEEDED.
4
- tools: [Read, Grep, Glob, Bash, Write]
4
+ tools: [Read, Grep, Glob, Bash, Write, ToolSearch]
5
5
  ---
6
6
 
7
7
  # Code Review
@@ -29,6 +29,38 @@ Step 2) are read directly by you; they are not passed in the prompt.
29
29
  exist), do not guess a branch name. Return `verdict: "CHANGES_NEEDED"` with `notes`
30
30
  stating exactly which input is missing and `reopenIds: []`, `newTasks: []`.
31
31
 
32
+ ## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
33
+
34
+ 1. Run ToolSearch with query
35
+ `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_feedback,mcp__apra-fleet__code_context,mcp__apra-fleet__code_graph,mcp__apra-fleet__code_impact,mcp__apra-fleet__code_query"`
36
+ (`kb_list`/`kb_promote`/`kb_capture` are deliberately NOT here -- captures and
37
+ promotions both go through your structured output, not a direct tool call; see
38
+ Step 5 for promotions and item 3 below for captures.)
39
+ The `code_*` tools answer what the KB cannot: what the changed code actually connects
40
+ to. Use `code_impact` on each changed file to judge blast radius, and
41
+ `code_context`/`code_graph`/`code_query` to trace callers before accepting a signature
42
+ or behaviour change -- prefer them over grep for structural questions. If a call reports
43
+ the repo is not indexed, fall back to reading the diff and grep; do not build an index.
44
+ 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo under review,
45
+ and `hint_symbols`/`hint_modules` relevant to the files changed in this review round.
46
+ Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts -- an INFERRED
47
+ entry may be an unvalidated in-flight capture.
48
+ 3. **Capture, don't call.** When you find a gotcha, a missed invariant, or a non-obvious
49
+ constraint during review, do NOT call `kb_capture` yourself -- add it to the
50
+ `kb_captures` array of your structured output instead (type `knowledge`, `learning`, or
51
+ `runbook`; full shape in Output schema below). The engine validates each entry and makes
52
+ the actual `kb_capture` call for you. Persisted captures are clamped to INFERRED
53
+ regardless of route -- passing a higher confidence does not mint CONFIRMED, it just gets
54
+ clamped down. CONFIRMED is minted only in Step 5, and only for claims you actually
55
+ verified. Before adding a capture, run `mcp__apra-fleet__kb_query` to dedupe -- skip it
56
+ if an equivalent entry already exists. Only durable, non-obvious findings qualify (no
57
+ task logs, no obvious facts); one concern per entry; cite real symbols and source_files.
58
+ 4. If a KB entry you retrieved proves wrong in practice, call `mcp__apra-fleet__kb_feedback`
59
+ directly with the entry id and what was wrong -- this is a read/feedback operation, not
60
+ a mutation, so it does not go through structured output.
61
+
62
+ If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
63
+
32
64
  ## Step 1 -- Context recovery
33
65
 
34
66
  ```bash
@@ -58,6 +90,18 @@ For each bead id named in your dispatch prompt:
58
90
  - No security issues (injection, auth bypass, secrets in code)?
59
91
  - Consistent with existing patterns and conventions?
60
92
  - No regressions in adjacent code?
93
+ - Confirm the bead is actually reflected in this diff -- do not credit a bead's closure to this review
94
+ unless you can point to the specific lines that implement it. A bead can show as done in your
95
+ dispatch context from a prior round, a rebase, or unrelated work without this diff containing its fix.
96
+
97
+ **Trace failure paths, don't just pattern-match the diff.** For any change touching process
98
+ kill/signal handling, timeouts, retries, or shared/concurrent state (counters, pools, locks,
99
+ caches): explicitly trace what happens on the FAILURE path, not just the success path -- e.g.
100
+ what if the thing being killed already exited, what if a wrapped shell command exits non-zero,
101
+ what if two callers race on the same state. "The diff looks like it implements X" is not the same
102
+ claim as "X holds under these edge cases." When a claim is cheaply checkable in isolation (does
103
+ this call throw under condition Y?), verify it with a small standalone repro instead of reasoning
104
+ from the diff alone.
61
105
 
62
106
  **File hygiene**: for every file added or modified, it must be justifiable against the sprint tasks.
63
107
  Flag temp files, tool config that slipped in, unrelated scripts.
@@ -100,7 +144,54 @@ short sleeps. Do not end your turn or return a verdict while the test suite is s
100
144
  running -- a backgrounded run with no reported final outcome is not a completed step,
101
145
  no matter how many times you've already narrated "still running."
102
146
 
103
- ## Step 5 -- Verdict
147
+ ## Step 5 -- Promote knowledge you verified
148
+
149
+ This step covers promotions only -- promoting an existing INFERRED entry to CONFIRMED.
150
+ New findings you want captured as fresh KB entries go in `kb_captures` (Step 0, item 3)
151
+ instead; the two fields are independent parts of your structured output and you can return
152
+ both in the same response.
153
+
154
+ You are the only role permitted to mint CONFIRMED. `kb_capture` clamps to INFERRED, so
155
+ without this step nothing an agent learns ever reaches the team bible -- it stays local to
156
+ the machine that learned it, and `kb_export` (CONFIRMED-only) never sees it.
157
+
158
+ **You do not call any `kb_*` tool for this.** The orchestrator hands you the candidate
159
+ entries and executes your decisions -- judgment is yours, execution is its.
160
+
161
+ 1. Read the **KNOWLEDGE BANK -- promotion candidates** block in your dispatch prompt. It
162
+ lists every INFERRED entry for the repo under review as `{id, title, summary,
163
+ source_files}`. If that block is absent, there is nothing to promote: return `[]` and
164
+ move on.
165
+ 2. Promote **only** entries whose claim you independently verified during THIS review --
166
+ by reading the diff, running the tests, or checking the cited files yourself.
167
+ 3. Return them in the `kb_promotions` field of your structured output as
168
+ `[{id, reason}]`, where `reason` states the evidence (minimum 20 characters), e.g.
169
+ `"verified against src/auth/token.ts:88 and the expired-token test"`. The orchestrator
170
+ makes the `kb_promote` calls.
171
+ 4. Promote nothing else. `kb_promotions: []` is a valid, common answer.
172
+
173
+ Hard limits:
174
+
175
+ - **Evidence, not plausibility.** If an entry merely looks correct, or you would have to
176
+ take the doer's word for it, leave it INFERRED. INFERRED is a perfectly good resting
177
+ state; a wrong CONFIRMED entry is worse than no entry, because later sessions trust
178
+ CONFIRMED fully and will not re-check it.
179
+ - **Never blanket-promote.** Do not promote every entry the doer captured, and do not
180
+ promote by module, tag, or timestamp. One deliberate entry per verified claim.
181
+ - **Not tied to the verdict.** A fact can be verified even when the code needs rework, and
182
+ an APPROVED verdict does not make unverified entries true. Judge each entry on its own
183
+ evidence.
184
+ - **User-directives are off limits.** `kb_promote` refuses to activate a pending
185
+ user-directive (activation is human-only, via `apra-fleet kb approve-directive`). The
186
+ orchestrator already filters these out of your candidate list, so you should never see
187
+ one; if you do, leave it alone.
188
+ - **Never invent an id.** Only ids from the candidate block are promotable. An id you did
189
+ not read there does not exist, and a promotion naming it is silently dropped.
190
+
191
+ Promotion is a KB decision, not a beads mutation -- it does not conflict with the "never
192
+ mutate beads" rule below. Report what you promoted in `notes` as well.
193
+
194
+ ## Step 6 -- Verdict
104
195
 
105
196
  Return your structured output ONLY. You never call `bd update`, `bd close`, `bd create`,
106
197
  or any other beads mutation yourself -- the orchestrator reads your structured output and
@@ -108,8 +199,24 @@ applies the reopen/create transitions:
108
199
  - `verdict`: "APPROVED" or "CHANGES_NEEDED"
109
200
  - `notes`: specific findings with file and line references where possible
110
201
  - `reopenIds`: array of beads task IDs that need rework (empty array if none)
202
+ - `replanIds`: optional array of beads task IDs among `reopenIds` whose ACCEPTANCE
203
+ CRITERIA are themselves defective (ambiguous, incomplete, or unsatisfiable as written)
204
+ rather than the implementation being wrong. Use this when a reopened bead cannot be
205
+ corrected by re-developing against its current criteria -- it needs a planner to rewrite
206
+ the criteria before any further development round makes sense. Omit this field, or
207
+ return an empty array, when every reopened bead just needs rework against its existing
208
+ criteria; that is the default and requires no planner involvement. Absence of this
209
+ field is equivalent to an empty array: no criteria-defect flag is raised, and behavior
210
+ is unchanged from before this field existed.
111
211
  - `newTasks`: array of `{ title, description, priority }` for follow-up work the review
112
- surfaced that is not covered by an existing task (empty array if none)
212
+ surfaced that is not covered by an existing task (empty array if none). `title` is
213
+ PLAIN TEXT ONLY: letters, digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -` -- nothing
214
+ else. No backticks, double quotes, `$`, or backslash. Do NOT wrap a command/flag/
215
+ filename in backticks in the title (e.g. write "Surface the Windows service
216
+ registration mode in apra-fleet status", not `` `apra-fleet status` `` with
217
+ backticks) -- a title outside this set is silently dropped as its own task and only
218
+ survives as a note on the parent bead. `description` has no such restriction; put any
219
+ code/command formatting there instead.
113
220
 
114
221
  **APPROVED** means all acceptance criteria met, tests pass, no regressions, no hygiene issues.
115
222
  `reopenIds` and `newTasks` are both empty on APPROVED.
@@ -131,10 +238,25 @@ placeholder):
131
238
  "reopenIds": ["BD-14"],
132
239
  "newTasks": [
133
240
  { "title": "Add expired-token test", "description": "Cover the expired-token rejection path in auth_test.ts", "priority": "P2" }
241
+ ],
242
+ "kb_promotions": [
243
+ { "id": "kb-0042", "reason": "verified against src/auth/token.ts:88 and the expired-token test" }
244
+ ],
245
+ "kb_captures": [
246
+ {
247
+ "type": "knowledge",
248
+ "title": "Token refresh retries are not idempotent",
249
+ "summary": "Retrying a failed refresh call can double-consume the refresh token.",
250
+ "content": "src/auth/token.ts:refreshToken() does not guard against concurrent retries; a second caller racing a timed-out first call can consume the same refresh token twice, invalidating the session. Confirmed by tracing the retry wrapper in src/auth/retry.ts.",
251
+ "source_files": ["src/auth/token.ts", "src/auth/retry.ts"]
252
+ }
134
253
  ]
135
254
  }
136
255
  ```
137
256
 
257
+ `kb_promotions` and `kb_captures` are both optional -- omit them, or send `[]`, when you
258
+ have nothing to promote or capture this round.
259
+
138
260
  **Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema is
139
261
  authoritative -- respond with exactly that JSON and nothing else. It is expected to match
140
262
  this contract; if it differs, follow the dispatch prompt.
@@ -143,12 +265,6 @@ this contract; if it differs, follow the dispatch prompt.
143
265
  use), report the same decision fields, in this JSON shape if the caller is an orchestrator,
144
266
  or as prose if you are answering a human directly.
145
267
 
146
- ## Token tracking
147
-
148
- After completing your review, run:
149
- ```
150
- bd remember "<your-label> <model> tokens: input=<N> output=<N>"
151
- ```
152
268
 
153
269
  ## Rules
154
270
 
@@ -0,0 +1,35 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/backlog-groomer-input@1",
4
+ "version": 1,
5
+ "title": "backlog-groomer input",
6
+ "description": "Required dispatch-context keys for the backlog-groomer role, per agents/backlog-groomer.md Inputs section. Consumed by callers for pre-dispatch validation only -- never appended to the prompt or shown to the LLM.",
7
+ "type": "object",
8
+ "required": ["identity"],
9
+ "properties": {
10
+ "identity": {
11
+ "type": "string",
12
+ "description": "Operator's own assignee value in this beads DB (email or username). Derived from git config when not supplied explicitly."
13
+ },
14
+ "scope": {
15
+ "type": "string",
16
+ "description": "Optional narrowing: a bead id to groom the subtree of, a priority floor, or a count cap. Default: all open/in_progress beads assigned to identity."
17
+ },
18
+ "mode": {
19
+ "type": "array",
20
+ "items": { "type": "string", "enum": ["define-sprint", "what-needs-grooming", "groom"] },
21
+ "minItems": 1,
22
+ "description": "Which of the three usage modes to run. Default: all three."
23
+ },
24
+ "include-others": {
25
+ "type": "boolean",
26
+ "default": false,
27
+ "description": "If true, other assignees' beads are loaded for context and reported in a visibly separate section, never merged into identity's buckets or mutated."
28
+ },
29
+ "dry-run": {
30
+ "type": "boolean",
31
+ "default": true,
32
+ "description": "If true, mutations are proposed as exact bd commands only. If false, warranted mutations are executed, each paired with an evidence/reasoning note."
33
+ }
34
+ }
35
+ }
@@ -0,0 +1,164 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/backlog-groomer-output@1",
4
+ "version": 1,
5
+ "title": "backlog-groomer output",
6
+ "description": "Canonical machine-readable output contract for the backlog-groomer role. See agents/backlog-groomer.md Step 9 for the prose contract this mirrors.",
7
+ "type": "object",
8
+ "required": ["status", "identity", "notes"],
9
+ "definitions": {
10
+ "beadRef": {
11
+ "type": "object",
12
+ "required": ["id", "rationale"],
13
+ "properties": {
14
+ "id": { "type": "string" },
15
+ "type": { "type": "string" },
16
+ "priority": { "type": "string" },
17
+ "status": { "type": "string" },
18
+ "assignee": { "type": "string" },
19
+ "ageDays": { "type": "number" },
20
+ "size": { "type": "string", "enum": ["S", "M", "L", "XL"] },
21
+ "rationale": { "type": "string" }
22
+ }
23
+ }
24
+ },
25
+ "properties": {
26
+ "status": {
27
+ "type": "string",
28
+ "enum": ["OK", "BLOCKED"],
29
+ "description": "BLOCKED means a required input was missing or unusable -- see notes."
30
+ },
31
+ "identity": {
32
+ "type": "string",
33
+ "description": "The identity actually used to scope this run, echoed back for the caller to confirm."
34
+ },
35
+ "notes": {
36
+ "type": "string",
37
+ "description": "Free-text summary, or the missing-input explanation when status is BLOCKED."
38
+ },
39
+ "ready": {
40
+ "type": "array",
41
+ "items": { "$ref": "#/definitions/beadRef" },
42
+ "description": "Responsibility 1a: ready/urgent/worth-pursuing, ordered by value."
43
+ },
44
+ "sprintSets": {
45
+ "type": "array",
46
+ "items": {
47
+ "type": "object",
48
+ "required": ["label", "beadIds", "reason"],
49
+ "properties": {
50
+ "label": { "type": "string" },
51
+ "beadIds": { "type": "array", "items": { "type": "string" } },
52
+ "reason": { "type": "string" }
53
+ }
54
+ },
55
+ "description": "Responsibility 1b: cohesive sprint-set groupings, plus standalone/collision notes folded into each entry's reason."
56
+ },
57
+ "duplicates": {
58
+ "type": "array",
59
+ "items": {
60
+ "type": "object",
61
+ "required": ["survivorId", "mergedIds", "evidence"],
62
+ "properties": {
63
+ "survivorId": { "type": "string" },
64
+ "mergedIds": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
65
+ "evidence": { "type": "string" }
66
+ }
67
+ },
68
+ "description": "Responsibility 2a: duplicate clusters found, with the survivor and the evidence used to pick it."
69
+ },
70
+ "needsGrooming": {
71
+ "type": "array",
72
+ "items": {
73
+ "type": "object",
74
+ "required": ["id", "priority", "issue"],
75
+ "properties": {
76
+ "id": { "type": "string" },
77
+ "priority": { "type": "string" },
78
+ "issue": { "type": "string", "description": "The quality gap, e.g. missing repro steps, urgency/content mismatch." },
79
+ "evidence": { "type": "string" }
80
+ }
81
+ },
82
+ "description": "Responsibility 2b: high-priority/urgent-sounding beads whose content quality is too low to act on, ordered by priority x quality-gap."
83
+ },
84
+ "needsVerification": {
85
+ "type": "array",
86
+ "items": {
87
+ "type": "object",
88
+ "required": ["id", "evidence"],
89
+ "properties": {
90
+ "id": { "type": "string" },
91
+ "evidence": { "type": "string", "description": "Result of the landed-vs-closed corroboration check (git log hits or lack thereof)." }
92
+ }
93
+ },
94
+ "description": "Beads whose children are all closed but landing on this branch is unconfirmed -- never treat as done."
95
+ },
96
+ "blocked": {
97
+ "type": "array",
98
+ "items": {
99
+ "type": "object",
100
+ "required": ["id", "chain"],
101
+ "properties": {
102
+ "id": { "type": "string" },
103
+ "chain": { "type": "array", "items": { "type": "string" }, "description": "Resolved blocks chain, e.g. [\"X\", \"Y\"] meaning blocked by X, which is blocked by Y." }
104
+ }
105
+ }
106
+ },
107
+ "notYours": {
108
+ "type": "array",
109
+ "items": {
110
+ "type": "object",
111
+ "required": ["id", "assignee"],
112
+ "properties": {
113
+ "id": { "type": "string" },
114
+ "assignee": { "type": "string" }
115
+ }
116
+ },
117
+ "description": "Only populated when include-others was set. Never merged into identity's own buckets."
118
+ },
119
+ "stale": {
120
+ "type": "array",
121
+ "items": { "$ref": "#/definitions/beadRef" }
122
+ },
123
+ "structuralIssues": {
124
+ "type": "array",
125
+ "items": {
126
+ "type": "object",
127
+ "required": ["kind", "description", "beadIds"],
128
+ "properties": {
129
+ "kind": {
130
+ "type": "string",
131
+ "enum": ["deadlock", "duplicate-cluster", "cross-assignee-leak", "missing-repro-pattern", "missing-ac-pattern", "epic-status-misuse", "missing-test-coverage", "other"]
132
+ },
133
+ "description": { "type": "string" },
134
+ "beadIds": { "type": "array", "items": { "type": "string" } }
135
+ }
136
+ }
137
+ },
138
+ "actions": {
139
+ "type": "array",
140
+ "items": {
141
+ "type": "object",
142
+ "required": ["beadId", "command", "reason", "executed"],
143
+ "properties": {
144
+ "beadId": { "type": "string" },
145
+ "command": { "type": "string", "description": "Exact bd command, proposed or run." },
146
+ "reason": { "type": "string", "description": "Evidence and reasoning; mirrors the note attached to the mutation when executed=true." },
147
+ "executed": { "type": "boolean", "description": "true if dry-run was false and this command was actually run; false if only proposed." }
148
+ }
149
+ },
150
+ "description": "Responsibility 3 output: one entry per justified mutation, proposed or executed depending on the dry-run input."
151
+ },
152
+ "heuristicsRecorded": {
153
+ "type": "array",
154
+ "items": {
155
+ "type": "object",
156
+ "required": ["key", "content"],
157
+ "properties": {
158
+ "key": { "type": "string", "description": "The groomer-heuristic-<slug> key used with bd remember." },
159
+ "content": { "type": "string" }
160
+ }
161
+ }
162
+ }
163
+ }
164
+ }