@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
package/README.md CHANGED
@@ -1,4 +1,17 @@
1
- # Apra Fleet
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="assets/marketing/hero-banner-dark.svg">
5
+ <img src="assets/marketing/hero-banner-light.svg" alt="apra-fleet: run a fleet of AI agents across your devices, your providers, your workflows." width="100%">
6
+ </picture>
7
+
8
+ # apra-fleet
9
+
10
+ **Run a fleet of AI agents across your devices, your providers, your workflows.**
11
+
12
+ What Kubernetes did for containers, apra-fleet does for AI agents:
13
+ scheduling, credentials, isolation, and observability for an agentic
14
+ workforce -- on any machine, anywhere, using every LLM provider at once.
2
15
 
3
16
  [![CI](https://github.com/Apra-Labs/apra-fleet/actions/workflows/ci.yml/badge.svg)](https://github.com/Apra-Labs/apra-fleet/actions/workflows/ci.yml)
4
17
  [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -6,316 +19,401 @@
6
19
  [![MCP](https://img.shields.io/badge/MCP-compatible-8A2BE2.svg)](https://modelcontextprotocol.io)
7
20
  [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Apra-Labs/apra-fleet)
8
21
 
9
- ### One goal. A team of AI agents that plan, execute, and review each other's work, and run across every machine you own.
10
-
11
- Apra Fleet is an open-source **MCP server** that turns AI agents (Claude
12
- Code, Antigravity, Codex, Copilot, Gemini, OpenCode) into a coordinated team instead of a lone
13
- assistant. Any job that needs more than one agent -- software sprints,
14
- customer-support triage, cost and operations-efficiency analysis,
15
- infrastructure surveys -- becomes a fleet you direct in plain conversation.
16
- Need more horsepower? Fleet reaches across every machine on your network
17
- over SSH -- no dashboards, no orchestration YAML.
18
-
19
- **The agents need not share a vendor.** A Claude agent and an Antigravity agent can
20
- work the same sprint -- one writes, the other reviews -- so a different model,
21
- with different blind spots, checks every change. Cross-provider collaboration is
22
- a built-in quality mechanism, not an afterthought.
22
+ [Quick Start](#quick-start-5-minutes) - [Live Demo](#watch-a-fleet-work) - [How It Works](#how-it-works) - [fleet-sprint Getting Started Guide](docs/fleet-sprint-getting-started.md) - [Website](https://apra-labs.github.io/apra-fleet)
23
23
 
24
- > A *member* is one working folder plus one LLM CLI -- local or remote.
25
- > A fleet is however many of those you register, working in concert.
24
+ </div>
26
25
 
27
- ### Watch a real run (3 min)
26
+ ---
28
27
 
29
- [![Apra Fleet -- a doer-reviewer sprint, start to finish](https://img.youtube.com/vi/SGdHvIkSbY8/hqdefault.jpg)](https://youtu.be/SGdHvIkSbY8)
28
+ <img src="assets/marketing/dashboard-demo.gif" alt="apra-fleet fleet-sprint dashboard, real recording: the sprint's own integration tester finds two real bugs, files them against itself, then a second cycle plans, fixes, and closes them -- captions burned in." width="100%">
30
29
 
31
- Two agents ship a feature end to end: one plans and writes, the other reviews,
32
- findings loop back, and a clean diff lands -- driven by the **PM skill**. That is
33
- *one* of the workflows Fleet makes possible; the rest are below.
30
+ > **This repository is built by the product you are looking at.** An
31
+ > autonomous apra-fleet workflow plans, codes, reviews, tests, and ships
32
+ > this codebase in multi-hour sprints -- filing bugs against itself and
33
+ > fixing them. The recording above is a real run, not a mockup.
34
34
 
35
35
  ---
36
36
 
37
- ## See it in one example
37
+ ## Why a fleet?
38
+
39
+ Running one AI agent is a demo. Running fifty -- across a MacBook in the
40
+ office, a GPU box in the lab, three cloud VMs, and your CI -- is an
41
+ operations problem nobody else has solved:
42
+
43
+ - **Which machine runs which agent?** Real devices, not throwaway sandboxes:
44
+ registered, credentialed, health-checked members you already own.
45
+ - **Which model does which job?** Claude for review, a cheap tier for
46
+ mechanical edits, a local vLLM model for private data -- all in one fleet,
47
+ routed by cost tier, switchable per task.
48
+ - **Who watches the agents?** Durable workflows with supervisors, watchdogs,
49
+ reservations, and live dashboards. Agents that die get detected. Work that
50
+ stalls gets resumed. Nothing runs silently.
51
+ - **Who holds the keys?** Secrets entered out-of-band, never visible to any
52
+ model. Per-provider permission composition. Network egress policy per
53
+ credential.
54
+
55
+ One control plane. Any device. Any model. Any workflow. Any domain.
56
+
57
+ ## What you get
58
+
59
+ | Pillar | Concretely |
60
+ |---|---|
61
+ | **Any device** | Register any Windows / macOS / Linux machine (local or over SSH) as a fleet member in one command. Cloud members auto-start on demand. Windows members are fully supported for dispatch, command execution, and background long-running tasks (launched detached via WMI). |
62
+ | **Any model** | Claude, Codex, Gemini, Copilot, Antigravity, local models (any OpenAI-compatible endpoint via OpenCode) -- mixed freely. Tier-based routing (cheap / standard / premium) keeps cost governance built in. Cross-provider review is a quality mechanism: a different model, with different blind spots, checks every change. |
63
+ | **Any workflow** | Workflows are durable programs, not prompt chains: multi-hour, resumable, observable, with member reservations and atomic state. Write your own; ship it to the fleet. |
64
+ | **Any domain** | Not just software development. The pattern fits wherever work decomposes into agent-sized pieces that need orchestration and an audit trail: nightly retail replenishment (reconcile inventory deltas, draft purchase orders for sign-off), logistics exception handling (triage a delayed shipment, re-book, notify), healthcare intake (summarize referrals, check completeness, route), back-office runs (invoice matching, compliance evidence collection). Software engineering is the vertical running today -- your domain is a workflow away. |
65
+
66
+ <picture>
67
+ <source media="(prefers-color-scheme: dark)" srcset="assets/marketing/fleet-topology-dark.svg">
68
+ <img src="assets/marketing/fleet-topology-light.svg" alt="apra-fleet topology: one control plane dispatching to six heterogeneous member devices across providers and operating systems" width="100%">
69
+ </picture>
70
+
71
+ ## Watch a fleet work
72
+
73
+ Our flagship workflow, **fleet-sprint**, develops software autonomously:
74
+ plan -> develop -> review -> deploy -> integration-test -> harvest, in
75
+ cycles, until the goal is met or the evidence says stop.
76
+
77
+ It is not a toy. It builds apra-fleet itself:
78
+
79
+ - Multi-cycle sprints running for hours, unattended
80
+ - 2,300+ unit tests and an 81-file integration suite against real backends
81
+ - Files bugs against itself, decomposes them, fixes them, and blocks its
82
+ own release until quality gates pass
83
+ - Every dispatch, verdict, and dollar visible live on the dashboard
84
+ - Every sprint's raw child stdout/stderr is captured to a per-sprint log
85
+ and linked from the dashboard, so a run's output is traceable even if it
86
+ crashes before reporting anything back
87
+
88
+ A fleet that has run in production:
38
89
 
39
90
  ```
40
- /pm add 2 local members at c:\projects cloned from <git-url> -- a developer and a reviewer -- and pair them
41
- /pm init project_icarus
42
- /pm plan ./feature.md
43
- /pm start the implementation sprint
44
- /pm status
91
+ pm-1 Opus (premium) orchestrator
92
+ doer-1 Sonnet (standard) feature work
93
+ doer-2 Antigravity large-context tasks
94
+ reviewer Opus (premium) final review
45
95
  ```
46
96
 
47
- You describe the goal, approve the plan once, and Fleet runs the doer-reviewer loop to a reviewed PR.
97
+ The engine does not know what a "sprint" is; it knows how to run your
98
+ workflow reliably across your fleet (see **Any domain** above).
48
99
 
49
- ## Quick start
100
+ ## Quick start (5 minutes)
50
101
 
51
- ### Option A -- npm (all platforms, requires Node.js 22+)
102
+ **1. Install** -- one command via npm (Node.js 22+), or grab the
103
+ standalone installer binary for your platform from
104
+ [Releases](https://github.com/Apra-Labs/apra-fleet/releases) and
105
+ double-click it (installation is the default action):
52
106
 
53
107
  ```bash
54
108
  npm install -g @apralabs/apra-fleet
55
- apra-fleet # Claude Code (default) -- install is the default action
56
- apra-fleet --llm agy # Google Antigravity CLI
57
- apra-fleet --llm gemini # Gemini CLI
58
- apra-fleet --llm codex # OpenAI Codex CLI
59
- apra-fleet --llm opencode # OpenCode (local/self-hosted models)
109
+ apra-fleet # installs for Claude Code (default)
110
+ apra-fleet --llm agy # or OpenCode/Codex/Copilot/Gemini
111
+ cd ~/.apra-fleet/bin && apra-fleet start # start the apra-fleet
60
112
  ```
61
113
 
62
- Run once per provider you want to support. After install, load the
63
- server in Claude Code using `/mcp`, or restart your CLI for other providers.
114
+ **2. Connect your agent.** Load the fleet server in Claude Code with
115
+ `/mcp` (or restart your provider CLI). Your agent now has a fleet.
64
116
 
65
- ### Option B -- standalone binary (no Node.js required)
117
+ **3. Register members -- in plain language.** apra-fleet is driven
118
+ conversationally through any MCP-capable agent:
66
119
 
67
- Download the installer for your platform from
68
- [GitHub Releases](https://github.com/Apra-Labs/apra-fleet/releases) and
69
- **double-click it** (or run it from the terminal) -- installation is the default action.
120
+ > "Register a local member called `doer`. Register another called
121
+ > `reviewer`. Pair them."
70
122
 
71
- **macOS (Apple Silicon)**
72
- ```bash
73
- curl -fsSL https://github.com/Apra-Labs/apra-fleet/releases/latest/download/apra-fleet-installer-darwin-arm64 -o apra-fleet-installer && chmod +x apra-fleet-installer && ./apra-fleet-installer
74
- ```
123
+ > "Register 192.168.1.10 as `build-server`. Username akhil, work folder
124
+ > `/home/akhil/projects/myapp`."
125
+
126
+ Remote passwords are collected out-of-band -- typed into a separate
127
+ terminal, never the chat -- used once to set up SSH keys, then forgotten.
128
+
129
+ **4. Run your first workflow:**
75
130
 
76
- **Linux (x64)**
77
131
  ```bash
78
- curl -fsSL https://github.com/Apra-Labs/apra-fleet/releases/latest/download/apra-fleet-installer-linux-x64 -o apra-fleet-installer && chmod +x apra-fleet-installer && ./apra-fleet-installer
132
+ apra-fleet workflow hello-world
79
133
  ```
80
134
 
81
- **Windows (x64)** -- download `apra-fleet-installer-win-x64.exe` and double-click, or run in PowerShell:
82
- ```powershell
83
- Invoke-WebRequest -Uri https://github.com/Apra-Labs/apra-fleet/releases/latest/download/apra-fleet-installer-win-x64.exe -OutFile apra-fleet-installer.exe; .\apra-fleet-installer.exe
84
- ```
135
+ Then point the fleet at real work:
85
136
 
86
- > Installing for **Antigravity**, Codex, Copilot, Gemini, or **OpenCode** instead of
87
- > Claude? Add the `--llm` flag -- see
88
- > [Install for other providers](docs/install.md#install-for-other-providers-antigravity-codex-copilot-gemini).
137
+ ```bash
138
+ apra-fleet workflow fleet-sprint \
139
+ --issue my-project-epic --members doer \
140
+ --branch fleet-sprint/first-run --base main
141
+ ```
89
142
 
90
- Then load it in your favorite LLM CLI (claude, agy, gemini, ...) using `/mcp`.
143
+ Open the dashboard, watch your fleet PLAN->BUILD->REVIEW->TEST->SHIP in a loop till closure
91
144
 
92
- Now register your first members:
145
+ > **New to fleet-sprint?** Read the
146
+ > [fleet-sprint Getting Started Guide](https://apra-labs.github.io/apra-fleet/fleet-sprint-getting-started.html)
147
+ > ([Markdown](docs/fleet-sprint-getting-started.md) if you're reading this on
148
+ > GitHub -- [PDF](docs/fleet-sprint-getting-started.pdf)) -- a plain-English walkthrough
149
+ > of what it does, what you need to prepare (beads backlog, `deploy.md`,
150
+ > test playbooks, member registration), how to launch and monitor a sprint,
151
+ > and what's automated versus what's still your call.
93
152
 
94
- > "Register a local member called `doer`. Register another called `reviewer`.
95
- > Pair them."
153
+ **Running fleet-sprint after npm install:** the `apra-fleet workflow
154
+ fleet-sprint ...` command above is the same one command for everyone --
155
+ whether you installed via `npm install -g @apralabs/apra-fleet`, the
156
+ standalone binary, or a git-clone dev checkout. There is no separate
157
+ `fleet-sprint` command to install or remember. See
158
+ [the full flag reference](packages/apra-fleet-se/fleet-sprint/docs/README.md)
159
+ for every option.
96
160
 
97
- Verify it worked:
161
+ ## How it works
98
162
 
99
- > "Show me fleet status."
163
+ ### Layered Architecture
100
164
 
101
- You should see both members listed with status online or idle, grouped by
102
- category if any have been assigned one. Members carry keyword `tags` (up to 10,
103
- 64 chars each) used for filtering in `list_members`, driving tag-aware permission
104
- profile composition in `compose_permissions`, and skill-matrix matching during
105
- onboarding. See [docs/features/member-tags.md](docs/features/member-tags.md).
165
+ <picture>
166
+ <source media="(prefers-color-scheme: dark)" srcset="assets/marketing/fleet-stack-dark.svg">
167
+ <img src="assets/marketing/fleet-stack-light.svg" alt="apra-fleet layered architecture stack: dependencies from OS primitives up to autonomous engineering orchestrators" width="100%">
168
+ </picture>
106
169
 
107
- Add remote machines whenever you are ready:
170
+ **Component Docs:** [fleet-sprint](packages/apra-fleet-se/fleet-sprint/docs/README.md) | [auto-sprint.js](packages/apra-fleet-se/apra-pm/docs/sprint-workflow.md) | [apra-fleet-client](packages/apra-fleet-client/docs/overview.md) | [apra-pm](packages/apra-fleet-se/apra-pm/README.md) | [apra-fleet-mcp](docs/mcp-tools.md) | [Agent Roles](packages/apra-fleet-se/docs/role-contracts.md)
108
171
 
109
- > "Register 192.168.1.10 as `build-server`. Username akhil, work folder
110
- > `/home/akhil/projects/myapp`."
172
+ ### Fleet Dispatch Topology
111
173
 
112
- Fleet securely collects the machine's password out-of-band -- you type it into a
113
- separate terminal, never the chat -- uses it once to set up SSH key-based auth,
114
- then forgets it. Every connection after that is key-based.
174
+ ```mermaid
175
+ flowchart LR
176
+ CP["Control Plane<br/>(Server, Engine, Supervisor)"] -->|Dispatch & Sync| M1["MacBook<br/>(Claude)"] & M2["Linux GPU<br/>(vLLM)"] & M3["Cloud VM<br/>(AGY)"] & M4["Windows<br/>(OpenCode)"]
177
+ ```
115
178
 
116
- Intel Mac users: build from source -- see [Development](#development).
117
- Install details (what it writes, the `--skill` flag, uninstall) are in
118
- [docs/install.md](docs/install.md).
179
+ - **Fleet server**: the control plane. Registers members, dispatches commands and prompts, moves files, brokers credentials. Speaks MCP, so any MCP-capable agent can drive a fleet.
180
+ - **Members**: real machines running provider CLIs. Composes provider-native permissions before every dispatch; unattended modes are scoped, never blanket.
181
+ - **Workflow engine**: runs workflow programs with phases, retries, turn budgets, resumable sessions, and per-activity persistent state.
182
+ - **Supervisor**: always-on layer -- launch & stop sprints over HTTP, member reservation ledger, crash watchdog, run history.
119
183
 
120
- **Staying current is one command.** `apra-fleet update` checks GitHub for the
121
- latest release and installs it in place -- or tells you that you are already up
122
- to date. See [keeping Fleet updated](docs/features/update.md).
184
+ ## Knowledge Layer
123
185
 
124
- ## How it works
186
+ Every agent session starts by calling `kb_session_prime`. The KB checks which
187
+ files have changed since last read and returns exactly those. Unchanged files
188
+ are served from cached summaries -- no re-read, no wasted tokens.
125
189
 
126
- ```mermaid
127
- sequenceDiagram
128
- actor You
129
- participant PM as PM (orchestrator)
130
- participant Doer
131
- participant Reviewer
132
- You->>PM: "Add a note sharing system, have it reviewed"
133
- loop Plan: revise until the reviewer signs off
134
- PM->>Doer: draft / revise the plan
135
- Doer-->>PM: plan
136
- PM->>Reviewer: review the plan
137
- Reviewer-->>PM: rejected with fixes, or signed off
138
- end
139
- PM-->>You: plan for approval
140
- You-->>PM: approved
141
- loop Build: revise until the review is clean
142
- PM->>Doer: execute / fix the task
143
- Doer->>Doer: write code, commit, reach checkpoint
144
- PM->>Reviewer: review the changes
145
- Reviewer-->>PM: findings, or signed off
146
- end
147
- PM-->>You: reviewed code + PR
190
+ ```
191
+ Cold session: kb_session_prime returns stale_files=[a.ts, b.ts, c.ts]
192
+ Agent reads all three, calls kb_capture for each.
193
+ Warm session: kb_session_prime returns stale_files=[], session_warm=true
194
+ Agent works from KB summaries. Zero file reads.
148
195
  ```
149
196
 
150
- A sprint runs in two reviewed phases: the **plan** is drafted, reviewed, and
151
- approved by you before any code is written; then the **build** is executed and
152
- every phase of development is reviewed against all the project documents
153
- (requirements, plan, design, etc.). The PM orchestrator talks to members through Fleet's MCP
154
- tools; Fleet carries the work to each member -- locally as a child process, or
155
- remotely over SSH. Agents sync state through git (`PLAN.md`, `progress.json`,
156
- `feedback.md`), so progress survives restarts.
157
-
158
- ## What you can build on top
159
-
160
- Fleet is a coordination layer. The **PM skill** is its reference workflow library
161
- and ships today; the rest are recipes you assemble with the same tools.
162
-
163
- | Workflow | What it does | Status |
164
- |----------|--------------|--------|
165
- | **Doer / Reviewer** | Two agents pair: one writes, one reviews against a quality bar. | Ships (PM skill) |
166
- | **Plan / execute / verify** | Break work into steps, approve the plan, agents pause at checkpoints. | Ships (PM skill) |
167
- | **Pipeline** | Agent A extracts, B transforms, C ships -- handoff by file. | Recipe |
168
- | **Specialist routing** | Route Python work to a py-agent, Rust to a rust-agent. | Recipe |
169
- | **Parallel exploration** | Three agents try three approaches; you merge the winner. | Recipe |
170
- | **Cross-machine** | Build on Linux, test on Windows, deploy from a Mac. | Recipe |
171
-
172
- To write your own skill, see [docs/writing-skills.md](docs/writing-skills.md).
173
-
174
- ## Use cases
175
-
176
- - Run your test suite on a Linux box while you develop on macOS.
177
- - Have one agent build the frontend, another the backend, a third running tests
178
- -- all in parallel.
179
- - Use a beefy cloud VM for compilation while coding from your laptop.
180
- - Spin up isolated workspaces on one machine without them stepping on each other.
181
- - Customer-support triage: agents classify, draft replies, and escalate
182
- tickets in parallel.
183
- - Cost and operations-efficiency analysis: fan out data gathering across
184
- sources, consolidate findings.
185
- - Infrastructure surveys, log triage, and patch fan-out across many
186
- machines.
187
-
188
- ## Cost
189
-
190
- Multi-agent tooling raises one question first: does coordinating several agents
191
- burn more tokens? In practice Fleet works to keep usage down -- and the core
192
- idea is the one Fleet was built on: **match the model to the task.**
193
-
194
- A plan is a list of tasks of widely varying difficulty. Running every one of
195
- them on a single premium model is the waste. Instead, Fleet assigns each task a
196
- model tier commensurate with its complexity:
197
-
198
- - **cheap** -- boilerplate, status checks, running tests, deploys
199
- - **standard** -- routine feature work, code, configuration
200
- - **premium** -- planning, review, hard architectural reasoning
201
-
202
- Only the work that genuinely needs a frontier model gets one; everything else
203
- runs on a lighter, cheaper tier. Two more mechanisms compound the savings:
204
-
205
- - **Shell over prompts** -- routine steps run through `execute_command` as plain
206
- shell commands, which cost zero LLM tokens.
207
- - **Smart sessions** -- Fleet decides whether to resume an existing session
208
- (reusing cached context) or start fresh, rather than re-sending history.
209
-
210
- **Token spend is measured, not estimated.** Fleet records token usage per
211
- member and per role -- PM, doer, reviewer -- so a team can see and analyze
212
- where their spend actually goes. Fleet's end-to-end CI suite exercises this
213
- in full: a complete reviewed sprint -- discover issues, plan, doer-reviewer
214
- loop, PR raised with green CI -- emits a per-role token breakdown (in one
215
- such run: PM ~6K, doer ~191K, reviewer ~19K, ~215K total). Those toy-repo
216
- figures are not a benchmark -- they show the measurement method works end
217
- to end. The point is the instrument: Fleet makes token cost something you
218
- can attribute and reason about, not guess at.
219
-
220
- Setup is a one-time cost; the recurring cost is the work itself. See the
221
- [FAQ](docs/FAQ.md) for the full breakdown.
197
+ MCP tools that ship with the KB:
198
+
199
+ | Tool | What it does |
200
+ |------|--------------|
201
+ | `kb_session_prime` | Prime a session: stale files, fresh summaries, GitNexus call list |
202
+ | `kb_capture` | Store a learning, context-cache, runbook, or knowledge entry |
203
+ | `kb_query` | Two-level FTS retrieval (L1: title+summary, L2: full content) |
204
+ | `kb_list` | Audit-list entries by confidence/type/module/symbol (read-only, no use_count bump) |
205
+ | `kb_context` | Batch file freshness check (single git call for N files) |
206
+ | `kb_invalidate` | Mark files stale immediately (also called by the git hook) |
207
+ | `kb_promote` | Advance confidence: UNVERIFIED -> INFERRED -> CONFIRMED |
208
+ | `kb_harvest` | Extract learnings from a session transcript (auto-fires after execute_prompt) |
209
+ | `kb_export` | Write live CONFIRMED entries to `.fleet/kb-canonical.json` -- the git-shareable team bible |
210
+ | `kb_setup` | Install git hook, write provider config, store remote token encrypted |
211
+
212
+ Every KB tool call is scoped to the repo it is about -- a fleet server
213
+ handling many members across many repos never lets one repo's learnings land
214
+ in another repo's KB. Scope is normally derived from the caller's repo path;
215
+ tools also accept an explicit `repo_remote_url` so a remote member (whose
216
+ work folder is a path on another host, unreachable from the fleet server's
217
+ filesystem) resolves to the same project KB as a local clone of that repo
218
+ instead of a shared fallback database. The automatic post-prompt harvest and
219
+ the `code_context` KB enrichment path both forward this URL too, and an
220
+ unreachable work-folder path is never silently swapped for the fleet
221
+ server's own working directory -- see
222
+ [Per-repo KB isolation](docs/knowledge-layer.md#per-repo-kb-isolation) for
223
+ the full anchor and cache-keying rules.
224
+
225
+ The backend is swappable: start with local SQLite, add a central HTTP server for
226
+ a team, or plug in Postgres later -- all via a one-line config change.
227
+
228
+ See [docs/knowledge-layer.md](docs/knowledge-layer.md) for the full guide.
229
+
230
+ ## Explore with agents. Operate with programs.
231
+
232
+ There are two ways to orchestrate agents, and apra-fleet is built on the
233
+ observation that you need both -- at different stages of a workflow's life:
234
+
235
+ - **Exploration mode.** While a workflow is still being discovered, let an
236
+ LLM orchestrate: flexible, adaptive, and token-hungry -- every step is a
237
+ decision, and every decision costs thinking.
238
+ - **Operation mode.** Once you know what must happen, the control flow
239
+ becomes a deterministic workflow program. Shell, git, and file steps run
240
+ through `execute_command` -- zero tokens. The model is invoked only at
241
+ the corners that genuinely require judgment (`execute_prompt`): review
242
+ this diff, plan this backlog, decide this exception.
243
+
244
+ <picture>
245
+ <source media="(prefers-color-scheme: dark)" srcset="assets/marketing/cost-collapse-dark.svg">
246
+ <img src="assets/marketing/cost-collapse-light.svg" alt="Cost per apra-fleet e2e run: four real LLM-driven runs ranging $0.46-$3.05, then ~$0.00 / run forever after switching to a deterministic workflow." width="100%">
247
+ </picture>
248
+
249
+ That is not a projection -- it is this repository's own e2e setup+teardown
250
+ step, before and after we hardened it. Development tokens are not
251
+ operating tokens: pay once to discover the workflow, then run it free.
252
+
253
+ | | LLM-orchestrated (explore) | Workflow-orchestrated (operate) |
254
+ |---|---|---|
255
+ | Control flow | the model decides each step (tokens) | deterministic program (free) |
256
+ | Shell / git / file steps | narrated through the model | `execute_command`, zero tokens |
257
+ | Where the model runs | everywhere | judgment nodes only (`execute_prompt`) |
258
+ | Cost curve | scales with every step | scales with thinking only |
259
+ | Failure mode | drift and silent retries | typed errors, resumable state |
260
+
261
+ The collapse is two-dimensional. As a workflow hardens, control flow moves
262
+ from model to program -- and the judgment nodes that remain move from
263
+ frontier models to cheaper ones, because a well-specified task no longer
264
+ needs discovery-grade reasoning. **Develop a workflow with Claude;
265
+ operationalize it on OpenCode against a local or OpenRouter model.** Same
266
+ fleet, same workflow -- swap the members. Tier routing makes it a
267
+ registration change, not a rewrite.
268
+
269
+ Only a fleet makes that trade possible. Single-provider tools cannot leave
270
+ their vendor; in-process frameworks cannot move orchestration out of the
271
+ token path. Because apra-fleet's unit of execution is the member -- a
272
+ machine plus a provider, swappable at registration -- the same hardened
273
+ workflow runs on frontier models the day you design it and on commodity
274
+ models every day after.
275
+
276
+ fleet-sprint is this principle, lived: it began as LLM-orchestrated
277
+ exploration; each discovered pattern was hardened into the deterministic
278
+ engine; today the engine drives hour-long autonomous runs in which models
279
+ are consulted only as planner, doer, reviewer, tester, and harvester.
222
280
 
223
281
  ## Compare to alternatives
224
282
 
225
- | Tool | Overlap | Where Fleet differs |
226
- |------|---------|---------------------|
227
- | Single-agent coding assistants | AI writes code | Fleet adds a second agent that reviews before you do. |
228
- | CI self-hosted runners | Runs work on other machines | Fleet is conversational and stateful, not pipeline-triggered. |
229
- | SkyPilot / dstack | Multi-machine compute | Fleet coordinates *agents and their context*, not just jobs. |
230
- | Google A2A | Agent-to-agent messaging | Fleet is an opinionated workflow layer, not just a transport. |
283
+ | Tool | Overlap | Where apra-fleet differs |
284
+ |------|---------|--------------------------|
285
+ | Single-agent coding assistants | AI writes code | A fleet adds agents that review, test, and deploy each other's work -- across vendors. |
286
+ | CI self-hosted runners | Runs work on other machines | Conversational and stateful, not pipeline-triggered; agents carry context between phases. |
287
+ | SkyPilot / dstack | Multi-machine compute | Coordinates agents and their context, credentials, and permissions -- not just jobs. |
288
+ | Google A2A | Agent-to-agent messaging | An opinionated orchestration and operations layer, not just a transport. |
289
+ | Agent frameworks (LangGraph, CrewAI, ...) | Multi-agent logic | Those compose agents inside one process; apra-fleet operates agents across real machines, providers, and days-long workflows. |
231
290
 
232
- When *not* to use Fleet: a one-off single-file change needs no second agent.
291
+ When NOT to use it: a one-off single-file change needs no fleet.
233
292
 
234
- ## Mix providers in one fleet
293
+ ## Security model, in one paragraph
235
294
 
236
- Every member runs its own LLM backend, and they collaborate across vendors. Put
237
- a Claude doer with an Antigravity reviewer, or the reverse - the reviewer's model
238
- disagrees with the doer's by construction, so it catches issues a same-model
239
- review would wave through. Mix by role:
295
+ Secrets are entered out-of-band into a credential store and referenced as
296
+ `{{secure.NAME}}` -- resolved server-side at execution, never visible to
297
+ any LLM or log. Credentials scope to members, expire on TTL, and can carry
298
+ a network egress policy (allow / deny / confirm). Every member runs with
299
+ composed, provider-native permission files -- allow-listed tools, not
300
+ god-mode. VCS access is provisioned and revocable per member. Permission
301
+ composition verifies its own delivery: a grant is read back off the target
302
+ member and structurally compared against what was intended before it is
303
+ reported as applied, so a failed or partial write is surfaced as an
304
+ explicit failure rather than a false success.
240
305
 
241
- | Role | Recommended | Why |
242
- |------|-------------|-----|
243
- | PM (orchestrator) | Claude Code or Antigravity (agy) | Both plan and orchestrate well - both support planning, background tasks, and premium models (e.g., Opus / premium-tier). |
244
- | Doer | Any provider | Sonnet, Antigravity, Codex, Copilot, Gemini, OpenCode - mix freely. |
245
- | Reviewer | Premium-tier models | Catches subtle issues smaller models miss. |
306
+ ## Email Configuration
246
307
 
247
- A fleet that has run in production:
308
+ The fleet `send_email` tool sends email via **SendGrid** or **SMTP**. Secrets
309
+ are stored in the fleet credential store. Non-secret config (provider, host,
310
+ port, from address) is passed by the workflow in each call.
311
+
312
+ ### Storing secrets (one-time setup)
313
+
314
+ Store email secrets via the CLI:
315
+
316
+ ```bash
317
+ # SendGrid API key
318
+ apra-fleet secret --set sendgrid_api_key --persist
248
319
 
320
+ # SMTP password
321
+ apra-fleet secret --set smtp_password --persist
249
322
  ```
250
- pm-1 Opus 4.7 orchestrator
251
- doer-1 Sonnet 4.6 feature work
252
- doer-2 Antigravity large-context tasks
253
- reviewer Opus 4.7 final review
323
+
324
+ Or via the MCP tool (the path an LLM agent uses):
325
+
326
+ ```json
327
+ { "name": "sendgrid_api_key", "prompt": "Enter your SendGrid API key", "persist": true }
254
328
  ```
255
329
 
256
- **OpenCode and local models.** OpenCode works with any OpenAI-compatible
257
- endpoint (Ollama, vLLM, etc.), so it is the provider for self-hosted models.
258
- The model endpoint is the user's responsibility -- Fleet installs the CLI and
259
- agents but does not provision or manage the inference server. Configure the
260
- provider and base URL in `opencode.json`; see
261
- [docs/opencode-exploration.md](docs/opencode-exploration.md) for details.
262
-
263
- Because OpenCode members can run any model, model tiers (cheap / standard /
264
- premium) are set per member at registration via `model_tiers` in
265
- `register_member`. A single-model entry fills all three tiers.
266
-
267
- Provider strengths, role recommendations, and gotchas:
268
- [docs/provider-guide.md](docs/provider-guide.md).
269
-
270
- ## The PM skill
271
-
272
- The **PM skill** is Fleet's reference workflow for **software development**
273
- -- it ships today, fully built out. It is one skill on a general
274
- substrate: the same primitives -- members, tasks, git/SSH transport,
275
- doer-reviewer pairing -- coordinate agents for support triage, cost
276
- analysis, ops surveys, or any multi-agent job. PM is the worked example;
277
- the platform is the point.
278
-
279
- The Project Manager skill is installed by default and drives structured,
280
- multi-step work: planning with your approval, doer-reviewer loops, verification
281
- checkpoints, and git-synced progress. Task state persists across sessions via
282
- [**Beads**](docs/beads.md), the bundled open-source issue tracker (`bd` CLI, installed alongside Fleet) -- run `bd ready` any time to see
283
- what is in flight.
284
-
285
- | Command | Does |
286
- |---------|------|
287
- | `/pm init <project>` | Initialize a project folder and templates. |
288
- | `/pm pair <member> <member>` | Pair a doer with a reviewer. |
289
- | `/pm plan <requirement>` | Draft a plan for your approval. |
290
- | `/pm start <member>` | Begin execution; dispatches doer with plan and task harness. |
291
- | `/pm status <member>` | Check in-flight tasks, progress, and git log. |
292
- | `/pm resume <member>` | Resume after a verification checkpoint. |
293
- | `/pm deploy <member>` | Execute the project deployment runbook. |
294
- | `/pm recover <project>` | Re-orient after a PM restart; reads in-flight tasks and member state. |
295
- | `/pm cleanup <project>` | Finish the sprint, close tasks, and raise a PR. |
296
- | `/pm backlog` | Query and manage deferred items via Beads. |
297
- | `/pm tasks` | Show the current sprint task tree. |
298
- | `/auto-sprint` | Run a fully automated sprint loop with cost accounting. |
299
-
300
- See [skills/pm/SKILL.md](skills/pm/SKILL.md) for the full command reference.
301
-
302
- **Cost accounting.** When PM is installed, the installer also writes `cost.js`
303
- to the PM skill directory for every provider. `cost.js` exports the seven pure
304
- cost-computation functions (`computeSprintQuote`, `computeSprintAnalysis`,
305
- `buildSprintSummary`, etc.) extracted from the `auto-sprint.js` workflow. For
306
- Claude, the full `auto-sprint.js` is also copied to `~/.claude/workflows/` and
307
- `Skill(auto-sprint)` / `Workflow(auto-sprint)` are added to the allow-list
308
- automatically. See [docs/features/auto-sprint-install.md](docs/features/auto-sprint-install.md).
309
-
310
- Want to build your own skill on top of Fleet? See [docs/writing-skills.md](docs/writing-skills.md).
330
+ Secrets are encrypted in the fleet credential store. They never appear in
331
+ workflow code, config files, or environment variables.
332
+
333
+ ### Sending email from a workflow
334
+
335
+ The workflow passes non-secret config inline and calls `send_email`. Load
336
+ your config however you prefer (JSON file, hardcoded, etc.):
337
+
338
+ ```javascript
339
+ import { parseToolJson } from '@apralabs/apra-fleet-client';
340
+ import { connectFleet } from '@apralabs/apra-fleet-client/server-resolution';
341
+
342
+ const { fleetApi } = await connectFleet({ env: process.env });
343
+
344
+ // fleetApi wrappers return the raw MCP tool result ({ content: [...] });
345
+ // parseToolJson extracts the JSON payload.
346
+ const result = parseToolJson(await fleetApi.sendEmail({
347
+ provider: 'smtp',
348
+ host: 'smtp.example.com',
349
+ port: 587,
350
+ user: 'notifications@example.com',
351
+ from: 'noreply@example.com',
352
+ to: 'team@example.com',
353
+ subject: 'Sprint Report',
354
+ body: 'All tasks completed.'
355
+ }));
356
+ console.log(`Sent: ${result.messageId}`);
357
+ ```
358
+
359
+ The SMTP password resolves from the credential store automatically. It never
360
+ appears in the workflow. See `examples/workflows/email-notify/` for a
361
+ complete runnable example and `docs/email-workflow-guide.md` for the full
362
+ walkthrough.
363
+
364
+ ### send_email Tool Reference
365
+
366
+ | Parameter | Type | Required | Description |
367
+ |---|---|---|---|
368
+ | `provider` | `"sendgrid"` or `"smtp"` | no (default: `"sendgrid"`) | Email provider |
369
+ | `from` | string | yes | Sender email address |
370
+ | `host` | string | SMTP only | SMTP server hostname |
371
+ | `port` | number | no (default: 587, or 465 when `secure` is true) | SMTP server port |
372
+ | `user` | string | SMTP only | SMTP username |
373
+ | `secure` | boolean | no (default: false) | Implicit TLS (port 465). When false, STARTTLS is required. |
374
+ | `to` | string or string[] | yes | Recipient email address(es) |
375
+ | `subject` | string | yes | Email subject line |
376
+ | `body` | string | yes | Plain-text email body |
377
+ | `html` | string | no | HTML email body |
378
+ | `cc` | string[] | no | CC recipient addresses |
379
+ | `bcc` | string[] | no | BCC recipient addresses |
380
+ | `attachments` | attachment[] | no | File attachments (base64-encoded) |
381
+
382
+ Each attachment: `filename` (string), `content` (string, base64), `contentType` (string, optional).
383
+
384
+ Secrets are resolved from the credential store by name:
385
+ - **SendGrid:** `sendgrid_api_key`
386
+ - **SMTP:** `smtp_password`
387
+
388
+ Returns: `{ ok: true, messageId }` on success, `{ ok: false, error }` on failure.
389
+
390
+ ## The packages
391
+
392
+ | Package | What it is |
393
+ |---|---|
394
+ | `apra-fleet` | The fleet platform: server, CLI, member management, credentials, workflows runtime |
395
+ | `packages/apra-fleet-se` | The software-engineering vertical: fleet-sprint engine, agent contracts, integration suites |
396
+ | `packages/apra-fleet-workflow` | Workflow authoring runtime: state, viewer, checkpointing |
397
+ | `packages/fleet-api-contract` | Typed API contract shared by server and clients |
398
+
399
+ ## Status and roadmap
400
+
401
+ apra-fleet is under active development -- by its own fleet. Current focus:
402
+ hardening autonomous sprint execution (the toughest workflow we know of),
403
+ supervisor-orchestrated multi-sprint operation, and the workflow SDK for
404
+ third-party verticals.
311
405
 
312
406
  ## Documentation
313
407
 
314
408
  | Topic | Link |
315
409
  |-------|------|
410
+ | **fleet-sprint Getting Started Guide (start here, plain English)** | [Website](https://apra-labs.github.io/apra-fleet/fleet-sprint-getting-started.html) - [Markdown](docs/fleet-sprint-getting-started.md) - [PDF](docs/fleet-sprint-getting-started.pdf) |
316
411
  | Codebase wiki (architecture, internals, AI Q&A) | [DeepWiki](https://deepwiki.com/Apra-Labs/apra-fleet) |
317
412
  | Install, uninstall, the `--llm` flag | [docs/install.md](docs/install.md) |
318
- | Choosing a provider | [docs/provider-guide.md](docs/provider-guide.md) |
413
+ | Choosing a provider (roles, gotchas, mixing providers, OpenCode/local models) | [docs/provider-guide.md](docs/provider-guide.md) |
414
+ | Transport, service mode, and supported interfaces | [docs/transport-and-service-mode.md](docs/transport-and-service-mode.md) |
415
+ | Cost model (tiering, shell-over-prompts, measured token spend) | [docs/cost-model.md](docs/cost-model.md) |
416
+ | The PM skill (doer-reviewer sprints, `/pm` commands) | [docs/pm-skill-overview.md](docs/pm-skill-overview.md) |
319
417
  | FAQ | [docs/FAQ.md](docs/FAQ.md) |
320
418
  | Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |
321
419
  | Keeping Fleet updated (`apra-fleet update`) | [docs/features/update.md](docs/features/update.md) |
@@ -326,6 +424,25 @@ Want to build your own skill on top of Fleet? See [docs/writing-skills.md](docs/
326
424
  | Git authentication | [docs/design-git-auth.md](docs/design-git-auth.md) |
327
425
  | Cloud compute | [docs/cloud-compute.md](docs/cloud-compute.md) |
328
426
  | Architecture | [docs/architecture.md](docs/architecture.md) |
427
+ | Knowledge Layer (setup, usage, provider swap) | [docs/knowledge-layer.md](docs/knowledge-layer.md) |
428
+ | Code intelligence provider abstraction | [docs/code-intelligence-providers.md](docs/code-intelligence-providers.md) |
429
+ | Hub-spoke cloud migration plan (historical; see tier-3 ownership ADR) | [docs/hub-spoke-master-plan.md](docs/hub-spoke-master-plan.md) |
430
+ | Tier-3 ownership decision (fleet-dashboard vs `src/hub-service/`) | [docs/adr-tier3-ownership.md](docs/adr-tier3-ownership.md) |
431
+ | Shared hub/dashboard API contract package | [packages/fleet-api-contract/README.md](packages/fleet-api-contract/README.md) |
432
+ | Workflow engine internals (`agent()`/`parallel()`/`pipeline()`, journal, budget) | [packages/apra-fleet-workflow/docs/apra-fleet-workflow-architecture.md](packages/apra-fleet-workflow/docs/apra-fleet-workflow-architecture.md) |
433
+ | Writing and running workflow scripts | [packages/apra-fleet-workflow/docs/workflow-guide.md](packages/apra-fleet-workflow/docs/workflow-guide.md) |
434
+ | Authoring a SEA-embedded `apra-fleet workflow` (manifest, entry contract, launcher env vars) | [docs/authoring-workflows.md](docs/authoring-workflows.md) |
435
+ | Workflow launcher fleet-server resolution order (HTTP singleton vs. stdio) | [docs/adr-workflow-server-resolution.md](docs/adr-workflow-server-resolution.md) |
436
+ | Running fleet-sprint (full flag reference; identical for npm-install, standalone binary, and git-clone dev checkout) | [packages/apra-fleet-se/fleet-sprint/docs/README.md](packages/apra-fleet-se/fleet-sprint/docs/README.md) |
437
+ | Auto-sprint overview (autonomous plan-develop-review-publish loop) | [packages/apra-fleet-se/docs/overview.md](packages/apra-fleet-se/docs/overview.md) |
438
+ | Auto-sprint CLI reference | [packages/apra-fleet-se/docs/cli-reference.md](packages/apra-fleet-se/docs/cli-reference.md) |
439
+ | Auto-sprint internals (cycle loop, stall detection, budget, topology) | [packages/apra-fleet-se/docs/architecture.md](packages/apra-fleet-se/docs/architecture.md) |
440
+ | Auto-sprint agent role contracts | [packages/apra-fleet-se/docs/role-contracts.md](packages/apra-fleet-se/docs/role-contracts.md) |
441
+ | fleet-supervisor skill (start/stop/restart/auto-start-on-boot, sprint launch via HTTP API) | [packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md](packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md) |
442
+ | fleet-supervisor packaging self-containment audit | [packages/apra-fleet-se/docs/supervisor-selfcontainment-audit.md](packages/apra-fleet-se/docs/supervisor-selfcontainment-audit.md) |
443
+ | MCP client SDK overview (transports, `ApraFleet` API) | [packages/apra-fleet-client/docs/overview.md](packages/apra-fleet-client/docs/overview.md) |
444
+ | MCP client SDK API reference | [packages/apra-fleet-client/docs/api-reference.md](packages/apra-fleet-client/docs/api-reference.md) |
445
+ | MCP client SDK getting started | [packages/apra-fleet-client/docs/getting-started.md](packages/apra-fleet-client/docs/getting-started.md) |
329
446
 
330
447
  ## Community
331
448
 
@@ -344,7 +461,6 @@ Build from source (also the path for Intel Macs):
344
461
 
345
462
  ```bash
346
463
  git clone https://github.com/Apra-Labs/apra-fleet && cd apra-fleet
347
- git submodule update --init
348
464
  npm install && npm run build && npm test
349
465
  ```
350
466
 
@@ -353,3 +469,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) to contribute.
353
469
  ## License
354
470
 
355
471
  Apache 2.0 -- see [LICENSE](LICENSE).
472
+
473
+ ---
474
+
475
+ <div align="center">
476
+
477
+ **Stop babysitting agents. Start operating fleets.**
478
+
479
+ [Quick Start](#quick-start-5-minutes) - [GitHub Issues](https://github.com/Apra-Labs/apra-fleet/issues) - [Apra Labs](https://apralabs.com)
480
+
481
+ </div>