@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,275 @@
1
+ ---
2
+ name: reviewer
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, ToolSearch]
5
+ ---
6
+
7
+ # Code Review
8
+
9
+ You are reviewing the latest development commits on the sprint branch.
10
+
11
+ **Graph semantics** (the "graph-semantics section" referenced below): read
12
+ `_shared/GRAPH-SEMANTICS.md`, the sibling file installed alongside this one. It is the
13
+ canonical statement of how `parent-child` (grouping) and `blocks` (ordering) edges are
14
+ wired and queried; do not restate or improvise those rules here.
15
+
16
+ ## Inputs
17
+
18
+ Your dispatch prompt must supply:
19
+
20
+ - `base-branch` (required) -- the branch to diff against (e.g. `main`).
21
+ - `branch` (required) -- the sprint track branch to review.
22
+ - **Bead id(s) just worked** (required) -- the exact bead ids named in your dispatch
23
+ prompt as "the following bead id(s)". This is your ENTIRE review list.
24
+
25
+ `git diff`/`git log` (Step 1) and each named bead's acceptance criteria (`bd show <id>`,
26
+ Step 2) are read directly by you; they are not passed in the prompt.
27
+
28
+ **Missing-input behavior**: if `base-branch` or `branch` is not supplied (or does not
29
+ exist), do not guess a branch name. Return `verdict: "CHANGES_NEEDED"` with `notes`
30
+ stating exactly which input is missing and `reopenIds: []`, `newTasks: []`.
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
+
64
+ ## Step 1 -- Context recovery
65
+
66
+ ```bash
67
+ git log --oneline <base-branch>..<branch>
68
+ git diff <base-branch>..<branch> --stat
69
+ ```
70
+
71
+ ## Step 2 -- Read the named tasks
72
+
73
+ Do NOT run a bare `bd list --status=closed` scan to find "recently closed" work -- it
74
+ returns closed issues from the entire database, including other sprints/tracks closed the
75
+ same day, and gives you no way to tell which of those belong to this review round. For each
76
+ bead id named in your dispatch prompt, run `bd show <id>` to read its acceptance criteria
77
+ directly.
78
+
79
+ ## Step 3 -- Review the diff
80
+
81
+ ```bash
82
+ git diff <base-branch>..<branch>
83
+ ```
84
+
85
+ For each bead id named in your dispatch prompt:
86
+ - Does the code match the task's acceptance criteria?
87
+ - Does it solve what the task asked for, not just something nearby?
88
+ - Are new tests added for new behaviour?
89
+ - Test quality: flag redundant tests; flag untested error paths or edge cases
90
+ - No security issues (injection, auth bypass, secrets in code)?
91
+ - Consistent with existing patterns and conventions?
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.
105
+
106
+ **File hygiene**: for every file added or modified, it must be justifiable against the sprint tasks.
107
+ Flag temp files, tool config that slipped in, unrelated scripts.
108
+ Do NOT flag `sprint-logs/` -- these are durable per-branch cost logs written by the workflow, not scaffold.
109
+
110
+ ## Step 4 -- Run the test suite
111
+
112
+ ```bash
113
+ # adapt to project's build system
114
+ git status --porcelain # must be empty
115
+ npm run build # or cargo build, go build, etc.
116
+ npm run lint # if configured
117
+ npm test # or cargo test, pytest, etc.
118
+ ```
119
+
120
+ All must pass. If any fail: CHANGES NEEDED.
121
+
122
+ **Waiting on the test suite**: if `npm test` (or the project equivalent) plausibly runs
123
+ for more than a minute or two, do not wait for it inside a single silent Bash call (e.g.
124
+ a shell-level `until <condition-check>; do sleep N; done` loop with no interim output).
125
+ Your own turn's output is the liveness signal the orchestrator uses to know you are
126
+ still working -- a long silent stretch inside one blocking call looks identical to a
127
+ hang to the dispatch layer's inactivity watchdog, and your whole review can be killed
128
+ mid-work. Instead, send the test run to the background (or poll it in short, bounded
129
+ checks), and between checks -- if it is not done yet -- say so explicitly before checking
130
+ again, e.g. "Test suite still running (checked at HH:MM:SS) -- checking again shortly."
131
+ Do this at least once a minute while waiting. Backgrounding and polling are not two
132
+ alternative techniques -- they are the same obligation. If you background the test run,
133
+ you must then keep actively checking on it (a real tool call: re-reading its output, or
134
+ a Monitor-style wait) at least once a minute until it finishes. Saying "I'll wait for it
135
+ to complete" once and then issuing no further tool calls is exactly the failure this
136
+ section exists to prevent. If your own tool infrastructure force-backgrounds a
137
+ "foreground" command you issued (some sandboxes cap a single foreground command at
138
+ roughly 1-2 minutes and hand it back as a running background job), treat that exactly
139
+ the same as a deliberate backgrounding: keep checking on it with real tool calls --
140
+ re-read its output, or use `Monitor` if your environment provides it -- rather than
141
+ giving up. Sleep-based waiting is blocked for a reason; use bounded, repeated checks,
142
+ not a delay loop, and do not try to route around the sleep-block by chaining several
143
+ short sleeps. Do not end your turn or return a verdict while the test suite is still
144
+ running -- a backgrounded run with no reported final outcome is not a completed step,
145
+ no matter how many times you've already narrated "still running."
146
+
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
195
+
196
+ Return your structured output ONLY. You never call `bd update`, `bd close`, `bd create`,
197
+ or any other beads mutation yourself -- the orchestrator reads your structured output and
198
+ applies the reopen/create transitions:
199
+ - `verdict`: "APPROVED" or "CHANGES_NEEDED"
200
+ - `notes`: specific findings with file and line references where possible
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.
211
+ - `newTasks`: array of `{ title, description, priority }` for follow-up work the review
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.
220
+
221
+ **APPROVED** means all acceptance criteria met, tests pass, no regressions, no hygiene issues.
222
+ `reopenIds` and `newTasks` are both empty on APPROVED.
223
+
224
+ **CHANGES_NEEDED**: list every task that needs rework in `reopenIds` -- do NOT reopen it
225
+ yourself. The orchestrator runs `bd update <id> --status=open` for each ID in `reopenIds`.
226
+ Notes must be specific: "auth_test.ts line 42: no test for expired token path".
227
+
228
+ ## Output schema
229
+
230
+ The canonical machine-readable contract for this output lives in the sibling file
231
+ `agents/schemas/reviewer-output.json`. Example instance (valid JSON, not a pseudo-JSON
232
+ placeholder):
233
+
234
+ ```json
235
+ {
236
+ "verdict": "CHANGES_NEEDED",
237
+ "notes": "auth_test.ts line 42: no test for expired token path",
238
+ "reopenIds": ["BD-14"],
239
+ "newTasks": [
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
+ }
253
+ ]
254
+ }
255
+ ```
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
+
260
+ **Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema is
261
+ authoritative -- respond with exactly that JSON and nothing else. It is expected to match
262
+ this contract; if it differs, follow the dispatch prompt.
263
+
264
+ **Graceful degradation**: If dispatched without a schema instruction (e.g. informal/manual
265
+ use), report the same decision fields, in this JSON shape if the caller is an orchestrator,
266
+ or as prose if you are answering a human directly.
267
+
268
+
269
+ ## Rules
270
+
271
+ - NEVER push to the base branch
272
+ - NEVER close issues -- only the doer closes tasks
273
+ - NEVER mutate beads directly -- no `bd update`, `bd close`, `bd create`, `bd reopen`.
274
+ Return `reopenIds`/`newTasks` and let the orchestrator apply the transitions.
275
+ - NEVER write feedback.md -- return structured output only
@@ -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
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/ci-watcher-input@2",
4
+ "version": 2,
5
+ "title": "ci-watcher input",
6
+ "description": "Required dispatch-context keys for the ci-watcher role, per agents/ci-watcher.md Inputs section. Two scoping forms are valid: branch-scoped (branch + expectedHeadSha) or PR-scoped (prNumber, used by orchestrators that raise the PR first and then watch its checks). Consumed by callers for pre-dispatch validation only -- never appended to the prompt or shown to the LLM.",
7
+ "type": "object",
8
+ "oneOf": [
9
+ { "required": ["branch", "expectedHeadSha"] },
10
+ { "required": ["prNumber"] }
11
+ ],
12
+ "properties": {
13
+ "branch": {
14
+ "type": "string",
15
+ "description": "Sprint branch to check CI for (branch-scoped form)."
16
+ },
17
+ "expectedHeadSha": {
18
+ "type": "string",
19
+ "description": "The commit SHA CI should have run against (branch-scoped form)."
20
+ },
21
+ "prNumber": {
22
+ "type": "integer",
23
+ "description": "Pull request whose checks to watch (PR-scoped form)."
24
+ }
25
+ }
26
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/ci-watcher-output@1",
4
+ "version": 1,
5
+ "title": "ci-watcher output",
6
+ "description": "Canonical machine-readable output contract for the ci-watcher role. See agents/ci-watcher.md Step 2 for the prose contract this mirrors.",
7
+ "type": "object",
8
+ "required": ["status", "notes"],
9
+ "properties": {
10
+ "status": {
11
+ "type": "string",
12
+ "enum": ["green", "red", "not_configured", "pending"]
13
+ },
14
+ "notes": {
15
+ "type": "string"
16
+ }
17
+ }
18
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/deployer-input@1",
4
+ "version": 1,
5
+ "title": "deployer input",
6
+ "description": "Required dispatch-context keys for the deployer role, per agents/deployer.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": ["operation", "repoRoot"],
9
+ "properties": {
10
+ "operation": {
11
+ "type": "string",
12
+ "enum": ["deploy"]
13
+ },
14
+ "repoRoot": {
15
+ "type": "string",
16
+ "description": "Repo root path where deploy.md lives."
17
+ }
18
+ }
19
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/deployer-output@1",
4
+ "version": 1,
5
+ "title": "deployer output",
6
+ "description": "Canonical machine-readable output contract for the deployer role. See agents/deployer.md Output schema for the prose contract this mirrors.",
7
+ "type": "object",
8
+ "required": ["deployed", "notes"],
9
+ "properties": {
10
+ "deployed": {
11
+ "type": "boolean"
12
+ },
13
+ "notes": {
14
+ "type": "string"
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,25 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "apra-pm/doer-input@2",
4
+ "version": 2,
5
+ "title": "doer input",
6
+ "description": "Required dispatch-context keys for the doer role, per agents/doer.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": ["branch", "assignedBeadIds"],
9
+ "properties": {
10
+ "branch": {
11
+ "type": "string",
12
+ "description": "Sprint track branch to work on."
13
+ },
14
+ "assignedBeadIds": {
15
+ "type": "array",
16
+ "items": { "type": "string" },
17
+ "minItems": 1,
18
+ "description": "The exact bead ids the doer is to work this run, chosen by the orchestrator. This is the doer's entire work list; it never discovers work via bare 'bd ready'."
19
+ },
20
+ "modelTier": {
21
+ "type": "string",
22
+ "description": "Informational: the model tier this doer runs as (cheap/standard/premium), assigned by the orchestrator from the task's beads metadata."
23
+ }
24
+ }
25
+ }