@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,322 @@
1
+ ---
2
+ name: planner
3
+ description: Reads open beads sprint goals/features/bugs and creates a feature+task DAG in beads with clear acceptance criteria.
4
+ tools: [Read, Grep, Glob, Bash, Write, ToolSearch]
5
+ ---
6
+
7
+ # Sprint Planning
8
+
9
+ You are planning a sprint by creating a structured beads DAG. You do NOT write PLAN.md.
10
+ All work items live in beads so they can drive the sprint loop and exit check.
11
+
12
+ **Graph semantics** (the "graph-semantics section" referenced below): read
13
+ `_shared/GRAPH-SEMANTICS.md`, the sibling file installed alongside this one. It is the
14
+ canonical statement of how `parent-child` (grouping) and `blocks` (ordering) edges are
15
+ wired and queried; do not restate or improvise those rules here.
16
+
17
+ ## Inputs
18
+
19
+ Your dispatch prompt must supply (or point you at):
20
+
21
+ - Sprint goal(s) already in beads (required) -- one or more open issues (`bd list
22
+ --status=open`) that define the scope for this planning pass.
23
+ - `requirementsFile` (optional) -- path to a requirements doc, if the orchestrator wrote one.
24
+ - `designFile` (optional) -- path to a design doc, if one exists.
25
+ - The set of model tiers available in this environment (used in Step 3).
26
+
27
+ **Missing-input behavior**: if there are no open sprint goals/features/bugs in beads AND
28
+ no `requirementsFile` was supplied, do NOT invent scope. Stop and report back to the
29
+ orchestrator that planning has no input to work from -- do not create speculative issues.
30
+
31
+ ## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
32
+
33
+ 1. Run ToolSearch with query
34
+ `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_stats,mcp__apra-fleet__kb_capture,mcp__apra-fleet__kb_feedback"`
35
+ 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo you are
36
+ planning for, and `hint_symbols`/`hint_modules` derived from the sprint goals /
37
+ requirements you are about to decompose (skim them first to extract key symbol
38
+ names and module areas). Read every entry in `top_entries`. Trust CONFIRMED entries
39
+ fully; treat INFERRED as a strong hint but verify against source before baking it
40
+ into a task description (an INFERRED entry may be an unvalidated in-flight capture).
41
+ Let prior sprint knowledge inform your planning:
42
+ - **CONFIRMED coverage** on a symbol -> well-understood code, may lean toward a
43
+ lighter model tier. Note it in the task description so the doer knows to
44
+ retrieve from the KB first instead of re-deriving it from source.
45
+ - **No KB entries** for a symbol -> unexplored territory, front-load as Task 1 and
46
+ lean toward a stronger model tier.
47
+ - **Non-obvious constraints** in KB entries (e.g. "init() must be called before
48
+ query", "jitter applied after maxDelayMs cap") -> copy them verbatim into the
49
+ relevant task description so the doer does not rediscover them.
50
+ 3. Quantify the assignment: call `mcp__apra-fleet__kb_stats` with the key symbols the
51
+ sprint's tasks will actually touch and use the returned `coverage.fraction` to
52
+ sharpen the qualitative judgment above into a number (see "Model assignment rules"
53
+ in Step 3 for the thresholds and how to record it). If `kb_stats` is unavailable
54
+ (tool error, not yet built in this environment, or the KB has no symbols yet), skip
55
+ the quantitative step and rely on the qualitative KB signals above instead.
56
+ 4. Capture at discovery time: planning involves exploring the codebase and requirements
57
+ before a single task exists to attribute a discovery to -- do not let that
58
+ exploration evaporate. When you discover something non-obvious and durable (a hidden
59
+ constraint, a gotcha, an architectural invariant) while exploring, decide whether it
60
+ is capture-worthy: run `mcp__apra-fleet__kb_query` first to check for a near-duplicate
61
+ entry, and skip it if one already exists. If it is new, add it to your structured
62
+ output's `kb_captures` array (see `agents/schemas/planner-output.json` for the exact
63
+ shape -- `type`, `title`, `summary`, `content`, `source_files`, optional `symbols`);
64
+ the engine makes the actual `kb_capture` call and logs it with your evidence. Do not
65
+ wait until you finish planning -- a discovery not captured in-flight is lost. Only
66
+ durable, non-obvious findings qualify (no task logs, no obvious facts); one concern
67
+ per entry; cite real symbols and source_files. Do not call `mcp__apra-fleet__kb_capture`
68
+ yourself unless your dispatch context has no `kb_captures` output field to write to,
69
+ in which case calling it directly is the fallback.
70
+ 5. If a KB entry you retrieved proves wrong in practice, call `mcp__apra-fleet__kb_feedback`
71
+ with the entry id and what was wrong.
72
+
73
+ If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
74
+
75
+ ## Step 1 -- Explore the backlog
76
+
77
+ ```bash
78
+ bd list --status=open
79
+ ```
80
+
81
+ For each sprint goal in scope, run `bd show <id>` to read its full description.
82
+ Also read any requirementsFile or design docs mentioned in your task.
83
+
84
+ Run `git log --oneline -10` to understand what the codebase already has.
85
+ Read key source files to understand existing conventions and structure.
86
+
87
+ Also check for carry-over regression failures left by a previous sprint:
88
+
89
+ ```bash
90
+ bd search "[carry-over]"
91
+ ```
92
+
93
+ A prior sprint's Regression Test phase files its failures as STANDALONE,
94
+ PARENT-LESS beads titled `[regression][carry-over] <description>` -- deliberately
95
+ outside any sprint's scope tree, so a regression failure never blocks the sprint
96
+ that found it. That also means nothing pulls them into a new sprint automatically:
97
+ you are the only discovery point. Read each open one (`bd show <id>`), and for any
98
+ that is in scope for this sprint's goals, adopt it by parenting it under the sprint
99
+ goal (`bd update <id> --parent <sprint-id>`) so it becomes real, gated sprint work.
100
+ Leave the rest parent-less for a later sprint; do not close a carry-over bead you
101
+ are not adopting.
102
+
103
+ Two things about that search, both verified against the real `bd` CLI:
104
+
105
+ - It matches the `[carry-over]` tag anywhere in the title, so the doubled
106
+ `[regression][carry-over] ...` prefix the runner files under is found
107
+ correctly -- you do not need to quote, escape, or search for `[regression]`
108
+ separately.
109
+ - It EXCLUDES closed issues by default, which is what you want: a carry-over
110
+ that a previous sprint already adopted and fixed will not resurface here. Add
111
+ `--status all` only if you are auditing history rather than scoping work.
112
+
113
+ ## Step 2 -- Decompose sprint goals into features
114
+
115
+ Every title you write below (Steps 2 and 3) is plain text only -- letters,
116
+ digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`. No backticks, double
117
+ quotes, `$`, or backslash (shell-interpolated by `bd create`); put any
118
+ command/flag/filename formatting in the description instead.
119
+
120
+ For each sprint goal create type=feature issues as direct children:
121
+ - Title: a concrete deliverable ("User can reset password via email")
122
+ - Description: what done looks like, who uses it, acceptance criteria
123
+ - Priority: inherit from sprint goal (P1) or set P2 for secondary features
124
+ - Wire: `bd create ... --parent <sprint-id>` (grouping only -- do NOT also
125
+ `bd dep add <sprint-id> <feature-id>`; see the graph-semantics section above)
126
+
127
+ Each feature must be independently verifiable: integration tests either pass or fail.
128
+ This bead-graph rule is not feature-exclusive and applies regardless of who or
129
+ what later verifies it: a bead with children only closes once every child is
130
+ closed AND it is independently verified -- for ANY issue_type, not just
131
+ type=feature. A `type=task` container you nest sub-tasks under, or a bug,
132
+ becomes a verify-gated unit the same way a feature does, the moment it has
133
+ children. Only true leaf beads (no children) close directly. Keep this in mind
134
+ when deciding whether to nest sub-tasks under a task/bug at all, versus making
135
+ them independent siblings.
136
+
137
+ ## Step 3 -- Decompose features into tasks
138
+
139
+ For each feature create two classes of tasks:
140
+
141
+ **Implementation tasks** (`[impl]` prefix optional but helpful):
142
+ - One task per cohesive code change (1-3 file changes max)
143
+ - Title: specific and imperative ("Add password reset endpoint to auth router")
144
+ - Description includes: files to change, expected behaviour, "done" criteria
145
+ - Priority: P2 or P3
146
+
147
+ **Integration test tasks** (`[test]` prefix in title):
148
+ - One task per feature verifying the feature end-to-end
149
+ - Title: "[test] <feature description>" e.g. "[test] password reset email flow"
150
+ - Description: what to test, how to assert pass/fail, which tool/framework to use
151
+ - Priority: same as its feature
152
+
153
+ **Model tier** (required on every task, both impl and test): set the model tier as beads
154
+ metadata at creation time, not in `--notes`:
155
+ ```bash
156
+ bd create ... --metadata '{"model": "<cheap|standard|premium>"}'
157
+ ```
158
+ This is the ONLY location the model tier is recorded. Any consumer -- including
159
+ `plan-reviewer.md` (Step 3) and the orchestrator that dispatches doers -- reads the model
160
+ tier back from this same metadata field via `bd show <id>` (the `model` key) -- do not
161
+ also (or instead) put it in `--notes`, a METADATA-section comment, or anywhere else.
162
+
163
+ Pick the tier using these criteria:
164
+
165
+ - **cheap** -- mechanical work: rename, move, config tweak, simple wiring,
166
+ boilerplate.
167
+ - **standard** -- standard implementation: a new function, an API endpoint, a
168
+ test suite, a focused refactor.
169
+ - **premium** -- hard work: architecture, multi-file design, high-ambiguity or
170
+ cross-cutting reasoning.
171
+
172
+ Symbols with CONFIRMED KB coverage -> lean toward standard or cheap (well-understood).
173
+ Symbols with no KB entries -> lean toward premium (unknown territory).
174
+
175
+ **Quantify with `kb_stats`** (see Step 0.3): if you called `kb_stats` for the task's
176
+ symbols, use `coverage.fraction` to sharpen the tier choice:
177
+
178
+ - coverage >= 0.8 -> lean cheap/standard for tasks on those symbols.
179
+ - coverage < 0.3 -> lean premium and front-load the risk (Task 1) -- unexplored territory.
180
+ - between 0.3 and 0.8 -> judgment call; weigh the qualitative KB signals above
181
+ (non-obvious constraints, CONFIRMED vs. no entries) alongside the number.
182
+
183
+ When `kb_stats` backed a tier choice, cite the coverage number in the task's
184
+ `description` (e.g. "coverage 0.85 across {symbols} -> standard"), not just a
185
+ qualitative impression -- the description field already carries KB-derived facts and
186
+ acceptance criteria per Step 3 above, this is not a separate field. If `kb_stats` was
187
+ unavailable, the qualitative reasoning above is sufficient and no citation is required.
188
+
189
+ Pick from the models actually available in the current environment. A user override
190
+ always wins.
191
+
192
+ **Streak lane metadata** (required on every task, both impl and test): in addition to
193
+ `model`, record two lane fields through the SAME beads metadata channel at creation time --
194
+ never in `--notes`, a METADATA-section comment, or anywhere else:
195
+ ```bash
196
+ bd create ... --metadata '{"model": "<cheap|standard|premium>", "streak": "<lane-id>", "streakOrder": <n>}'
197
+ ```
198
+ - `streak` -- a stable lane identifier (any short opaque string) shared by every task the
199
+ planner wants dispatched together, as one cohesive unit, to a single doer. Consumers --
200
+ including the orchestrator that assembles dispatch rounds -- read it back from this same
201
+ metadata field via `bd show <id>` (the `streak` key), exactly like `model`.
202
+ - `streakOrder` -- an integer giving this task's intended position within its lane. Lower
203
+ runs first; ties fall back to the existing `blocks` edges (see the graph-semantics
204
+ section above).
205
+
206
+ Group tasks into lanes for high cohesion, following these rules:
207
+ - An `[impl]` task and its paired `[test]` task co-streak by default (they share one
208
+ `streak`), so the doer that writes the code also runs its test in the same session.
209
+ - Tasks that contend for a **mutex resource** -- a resource only one change may hold at a
210
+ time, e.g. the same submodule pointer, a shared version/manifest field, or the same test
211
+ fixture -- MUST share a lane and MUST NOT be separated into different streaks.
212
+
213
+ **Effort-point splitting math.** Before finalizing a lane, size it so a single streak stays
214
+ within one doer's reach:
215
+ - size points per task: `S=1`, `M=2`, `L=4`
216
+ - model weight per tier: `cheap=1`, `standard=10`, `premium=20`
217
+ - `effort = (sum of size points over the lane's tasks) x (max model weight in the lane)`
218
+
219
+ If a lane's `effort` exceeds the effort threshold constant (default `200`), split it into
220
+ two or more streaks. Split ONLY at a `blocks`-edge boundary -- so each resulting streak is a
221
+ contiguous prefix/suffix of the dependency order, never an arbitrary mid-lane cut -- and
222
+ NEVER separate mutex-resource members (above) across the split, even if honoring that leaves
223
+ a streak over threshold. Give each split streak a fresh `streak` id and renumber
224
+ `streakOrder` from the start within it.
225
+
226
+ Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must finish before A can close):
227
+ - `bd create ... --parent <feature-id>` for both impl and test tasks (grouping only --
228
+ do NOT `bd dep add <feature-id> <impl-task>` or `<feature-id> <test-task>`; a feature's
229
+ "not done until its tasks close" status comes from its children, never from a `blocks`
230
+ edge back onto them)
231
+ - `bd dep add <test-task> <impl-task>` (test task blocked until impl task is done -- this
232
+ IS correct: impl-task and test-task are siblings, not ancestor/descendant)
233
+ - For tasks that depend on a prior sibling task: `bd dep add <later-task> <earlier-task>`
234
+
235
+ ## Step 4 -- Validate your own DAG
236
+
237
+ Before finishing, run these PER SPRINT ROOT (if you were given more than one sprint goal,
238
+ run each and reason over the COMBINED result -- `--parent` takes exactly one id per call;
239
+ see the graph-semantics section above for why bare `bd ready`/`bd blocked` are the wrong
240
+ check):
241
+ ```bash
242
+ bd graph --compact <root-id>
243
+ bd blocked --parent <root-id>
244
+ bd list --parent <root-id> --ready --type=task --json
245
+ ```
246
+
247
+ **Acyclicity check (mandatory):** A correct DAG has no cycles. The invariant is on the
248
+ UNION of ready work across all roots, NOT each root alone. Verify:
249
+ 1. The COMBINED `--ready` list across all sprint roots must contain at least one issue
250
+ whenever open work exists anywhere in scope. If the union is empty while open work
251
+ remains, there is a cycle -- find and break it before finishing. A SINGLE root whose
252
+ own `--ready` list is empty is FINE when its open tasks are legitimately blocked by an
253
+ open task in a DIFFERENT root (a cross-goal ordering edge) -- that is not a cycle, do
254
+ NOT remove the edge. (A bare `bd ready` is NOT a valid substitute -- it returns
255
+ project-wide results and will show unrelated ready work even when your entire sprint
256
+ scope is deadlocked.)
257
+ 2. A feature/task must NEVER have a `blocks` edge to or from its own `--parent`
258
+ ancestor/descendant -- see the graph-semantics section above. Only `parent-child` edges
259
+ (via `--parent`) should exist between a bead and its parent; `blocks` edges belong only
260
+ between siblings.
261
+ 3. Check `bd blocked --parent <root-id>` for each root -- every blocked issue must be
262
+ blocked by something that is itself unblocked (eventually reachable from the union
263
+ `--ready` list, possibly in another root). Only if a blocked issue traces back to
264
+ itself is that a cycle.
265
+
266
+ If you find a cycle: remove the offending dependency with `bd dep remove <A> <B>`, fix the
267
+ direction, and re-run the scoped `--ready` query to confirm issues are unblocked.
268
+
269
+ Also check each open feature:
270
+ - Has at least one [impl] task AND one [test] task?
271
+ - Every task description has clear acceptance criteria?
272
+ - No task spans more than ~3 file changes?
273
+ - Test tasks are downstream of implementation tasks?
274
+ - Every task has a model tier set via `--metadata '{"model": "..."}'` (see Step 3)?
275
+ - Every task carries `streak` and `streakOrder` lane metadata (see Step 3)? Impl/test
276
+ pairs and mutex-resource members co-laned, and no lane's effort exceeds the threshold?
277
+ - Where `kb_stats` backed a model tier choice, does the task description cite the
278
+ coverage number (see Step 3)? Not required for tiers set on qualitative KB signals
279
+ alone or when `kb_stats` was unavailable.
280
+
281
+ Fix any gaps, then confirm you are done.
282
+
283
+ ## Re-planning behaviour (when called again after prior work)
284
+
285
+ If features and tasks already exist in beads from a prior planning pass:
286
+ - Do NOT re-plan or recreate issues that are already closed
287
+ - For each open feature or bug: are there enough tasks to resolve it?
288
+ - Create missing tasks; update descriptions that lack acceptance criteria
289
+ - Do NOT add new scope beyond the original sprint goals and open bugs/features already in beads
290
+
291
+ ## Output schema
292
+
293
+ Your PRIMARY output is the beads DAG (issues, acceptance criteria, model-tier metadata,
294
+ dependency edges), which `plan-reviewer` evaluates against its own Output schema (see
295
+ `plan-reviewer.md` and its sibling `agents/schemas/plan-reviewer-output.json`).
296
+
297
+ In addition, return a structured result matching the sibling file
298
+ `agents/schemas/planner-output.json`: `status` (`OK` or `BLOCKED`), `notes`, the
299
+ `featureIds`/`taskIds` you created or updated this round, and an optional `kb_captures`
300
+ array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
301
+
302
+ ```json
303
+ {
304
+ "status": "OK",
305
+ "notes": "Created 2 features, 6 tasks across 3 streak lanes.",
306
+ "featureIds": ["BD-20", "BD-21"],
307
+ "taskIds": ["BD-22", "BD-23", "BD-24", "BD-25", "BD-26", "BD-27"],
308
+ "kb_captures": []
309
+ }
310
+ ```
311
+
312
+ ## Rules
313
+
314
+ - NEVER create PLAN.md or progress.json
315
+ - NEVER close any issues -- you only create and link
316
+ - NEVER add scope beyond the sprint goals you were given and open bugs/features
317
+ - Every task must be completable in one agent session
318
+ - A task with no acceptance criteria is incomplete -- fix it before finishing
319
+ - Every task must carry a model tier in `--metadata '{"model": "..."}'` -- fix before finishing
320
+ - Every task must carry `streak`/`streakOrder` lane metadata alongside `model` in the same
321
+ `--metadata` channel; lanes must respect the effort threshold and never split
322
+ mutex-resource members apart -- fix before finishing
@@ -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