@apralabs/apra-fleet 0.3.6 → 0.4.0

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 (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /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,267 @@
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.
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) - [Docs](https://apra-labs.github.io/apra-fleet)
18
23
 
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.
24
+ </div>
23
25
 
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.
26
-
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. |
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
- ```
75
-
76
- **Linux (x64)**
77
- ```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
79
- ```
80
-
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
- ```
123
+ > "Register 192.168.1.10 as `build-server`. Username akhil, work folder
124
+ > `/home/akhil/projects/myapp`."
85
125
 
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).
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.
89
128
 
90
- Then load it in your favorite LLM CLI (claude, agy, gemini, ...) using `/mcp`.
129
+ **4. Run your first workflow:**
91
130
 
92
- Now register your first members:
131
+ ```bash
132
+ apra-fleet workflow hello-world
133
+ ```
93
134
 
94
- > "Register a local member called `doer`. Register another called `reviewer`.
95
- > Pair them."
135
+ Then point the fleet at real work:
96
136
 
97
- Verify it worked:
137
+ ```bash
138
+ apra-fleet workflow fleet-sprint \
139
+ --issue my-project-epic --members doer \
140
+ --branch fleet-sprint/first-run --base main
141
+ ```
98
142
 
99
- > "Show me fleet status."
143
+ Open the dashboard, watch your fleet PLAN->BUILD->REVIEW->TEST->SHIP in a loop till closure
100
144
 
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).
145
+ > **New to fleet-sprint?** Read the
146
+ > [fleet-sprint Getting Started Guide](docs/fleet-sprint-getting-started.md)
147
+ > ([HTML](docs/fleet-sprint-getting-started.html) -
148
+ > [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.
106
152
 
107
- Add remote machines whenever you are ready:
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.
108
160
 
109
- > "Register 192.168.1.10 as `build-server`. Username akhil, work folder
110
- > `/home/akhil/projects/myapp`."
161
+ ## How it works
111
162
 
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.
163
+ ### Layered Architecture
115
164
 
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).
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>
119
169
 
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).
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)
123
171
 
124
- ## How it works
172
+ ### Fleet Dispatch Topology
125
173
 
126
174
  ```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
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)"]
148
177
  ```
149
178
 
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.
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.
183
+
184
+ ## Explore with agents. Operate with programs.
185
+
186
+ There are two ways to orchestrate agents, and apra-fleet is built on the
187
+ observation that you need both -- at different stages of a workflow's life:
188
+
189
+ - **Exploration mode.** While a workflow is still being discovered, let an
190
+ LLM orchestrate: flexible, adaptive, and token-hungry -- every step is a
191
+ decision, and every decision costs thinking.
192
+ - **Operation mode.** Once you know what must happen, the control flow
193
+ becomes a deterministic workflow program. Shell, git, and file steps run
194
+ through `execute_command` -- zero tokens. The model is invoked only at
195
+ the corners that genuinely require judgment (`execute_prompt`): review
196
+ this diff, plan this backlog, decide this exception.
197
+
198
+ <picture>
199
+ <source media="(prefers-color-scheme: dark)" srcset="assets/marketing/cost-collapse-dark.svg">
200
+ <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%">
201
+ </picture>
202
+
203
+ That is not a projection -- it is this repository's own e2e setup+teardown
204
+ step, before and after we hardened it. Development tokens are not
205
+ operating tokens: pay once to discover the workflow, then run it free.
206
+
207
+ | | LLM-orchestrated (explore) | Workflow-orchestrated (operate) |
208
+ |---|---|---|
209
+ | Control flow | the model decides each step (tokens) | deterministic program (free) |
210
+ | Shell / git / file steps | narrated through the model | `execute_command`, zero tokens |
211
+ | Where the model runs | everywhere | judgment nodes only (`execute_prompt`) |
212
+ | Cost curve | scales with every step | scales with thinking only |
213
+ | Failure mode | drift and silent retries | typed errors, resumable state |
214
+
215
+ The collapse is two-dimensional. As a workflow hardens, control flow moves
216
+ from model to program -- and the judgment nodes that remain move from
217
+ frontier models to cheaper ones, because a well-specified task no longer
218
+ needs discovery-grade reasoning. **Develop a workflow with Claude;
219
+ operationalize it on OpenCode against a local or OpenRouter model.** Same
220
+ fleet, same workflow -- swap the members. Tier routing makes it a
221
+ registration change, not a rewrite.
222
+
223
+ Only a fleet makes that trade possible. Single-provider tools cannot leave
224
+ their vendor; in-process frameworks cannot move orchestration out of the
225
+ token path. Because apra-fleet's unit of execution is the member -- a
226
+ machine plus a provider, swappable at registration -- the same hardened
227
+ workflow runs on frontier models the day you design it and on commodity
228
+ models every day after.
229
+
230
+ fleet-sprint is this principle, lived: it began as LLM-orchestrated
231
+ exploration; each discovered pattern was hardened into the deterministic
232
+ engine; today the engine drives hour-long autonomous runs in which models
233
+ are consulted only as planner, doer, reviewer, tester, and harvester.
222
234
 
223
235
  ## Compare to alternatives
224
236
 
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. |
237
+ | Tool | Overlap | Where apra-fleet differs |
238
+ |------|---------|--------------------------|
239
+ | Single-agent coding assistants | AI writes code | A fleet adds agents that review, test, and deploy each other's work -- across vendors. |
240
+ | CI self-hosted runners | Runs work on other machines | Conversational and stateful, not pipeline-triggered; agents carry context between phases. |
241
+ | SkyPilot / dstack | Multi-machine compute | Coordinates agents and their context, credentials, and permissions -- not just jobs. |
242
+ | Google A2A | Agent-to-agent messaging | An opinionated orchestration and operations layer, not just a transport. |
243
+ | 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
244
 
232
- When *not* to use Fleet: a one-off single-file change needs no second agent.
245
+ When NOT to use it: a one-off single-file change needs no fleet.
233
246
 
234
- ## Mix providers in one fleet
247
+ ## Security model, in one paragraph
235
248
 
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:
249
+ Secrets are entered out-of-band into a credential store and referenced as
250
+ `{{secure.NAME}}` -- resolved server-side at execution, never visible to
251
+ any LLM or log. Credentials scope to members, expire on TTL, and can carry
252
+ a network egress policy (allow / deny / confirm). Every member runs with
253
+ composed, provider-native permission files -- allow-listed tools, not
254
+ god-mode. VCS access is provisioned and revocable per member.
240
255
 
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. |
256
+ ## The packages
246
257
 
247
- A fleet that has run in production:
258
+ | Package | What it is |
259
+ |---|---|
260
+ | `apra-fleet` | The fleet platform: server, CLI, member management, credentials, workflows runtime |
261
+ | `packages/apra-fleet-se` | The software-engineering vertical: fleet-sprint engine, agent contracts, integration suites |
262
+ | `packages/apra-fleet-workflow` | Workflow authoring runtime: state, viewer, checkpointing |
263
+ | `packages/fleet-api-contract` | Typed API contract shared by server and clients |
248
264
 
249
- ```
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
254
- ```
265
+ ## Status and roadmap
255
266
 
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).
267
+ apra-fleet is under active development -- by its own fleet. Current focus:
268
+ hardening autonomous sprint execution (the toughest workflow we know of),
269
+ supervisor-orchestrated multi-sprint operation, and the workflow SDK for
270
+ third-party verticals.
311
271
 
312
272
  ## Documentation
313
273
 
314
274
  | Topic | Link |
315
275
  |-------|------|
276
+ | **fleet-sprint Getting Started Guide (start here, plain English)** | [Markdown](docs/fleet-sprint-getting-started.md) - [HTML](docs/fleet-sprint-getting-started.html) - [PDF](docs/fleet-sprint-getting-started.pdf) |
316
277
  | Codebase wiki (architecture, internals, AI Q&A) | [DeepWiki](https://deepwiki.com/Apra-Labs/apra-fleet) |
317
278
  | Install, uninstall, the `--llm` flag | [docs/install.md](docs/install.md) |
318
- | Choosing a provider | [docs/provider-guide.md](docs/provider-guide.md) |
279
+ | Choosing a provider (roles, gotchas, mixing providers, OpenCode/local models) | [docs/provider-guide.md](docs/provider-guide.md) |
280
+ | Transport, service mode, and supported interfaces | [docs/transport-and-service-mode.md](docs/transport-and-service-mode.md) |
281
+ | Cost model (tiering, shell-over-prompts, measured token spend) | [docs/cost-model.md](docs/cost-model.md) |
282
+ | The PM skill (doer-reviewer sprints, `/pm` commands) | [docs/pm-skill-overview.md](docs/pm-skill-overview.md) |
319
283
  | FAQ | [docs/FAQ.md](docs/FAQ.md) |
320
284
  | Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |
321
285
  | Keeping Fleet updated (`apra-fleet update`) | [docs/features/update.md](docs/features/update.md) |
@@ -326,6 +290,21 @@ Want to build your own skill on top of Fleet? See [docs/writing-skills.md](docs/
326
290
  | Git authentication | [docs/design-git-auth.md](docs/design-git-auth.md) |
327
291
  | Cloud compute | [docs/cloud-compute.md](docs/cloud-compute.md) |
328
292
  | Architecture | [docs/architecture.md](docs/architecture.md) |
293
+ | Hub-spoke cloud migration plan (historical; see tier-3 ownership ADR) | [docs/hub-spoke-master-plan.md](docs/hub-spoke-master-plan.md) |
294
+ | Tier-3 ownership decision (fleet-dashboard vs `src/hub-service/`) | [docs/adr-tier3-ownership.md](docs/adr-tier3-ownership.md) |
295
+ | Shared hub/dashboard API contract package | [packages/fleet-api-contract/README.md](packages/fleet-api-contract/README.md) |
296
+ | 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) |
297
+ | Writing and running workflow scripts | [packages/apra-fleet-workflow/docs/workflow-guide.md](packages/apra-fleet-workflow/docs/workflow-guide.md) |
298
+ | Authoring a SEA-embedded `apra-fleet workflow` (manifest, entry contract, launcher env vars) | [docs/authoring-workflows.md](docs/authoring-workflows.md) |
299
+ | Workflow launcher fleet-server resolution order (HTTP singleton vs. stdio) | [docs/adr-workflow-server-resolution.md](docs/adr-workflow-server-resolution.md) |
300
+ | 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) |
301
+ | Auto-sprint overview (autonomous plan-develop-review-publish loop) | [packages/apra-fleet-se/docs/overview.md](packages/apra-fleet-se/docs/overview.md) |
302
+ | Auto-sprint CLI reference | [packages/apra-fleet-se/docs/cli-reference.md](packages/apra-fleet-se/docs/cli-reference.md) |
303
+ | Auto-sprint internals (cycle loop, stall detection, budget, topology) | [packages/apra-fleet-se/docs/architecture.md](packages/apra-fleet-se/docs/architecture.md) |
304
+ | Auto-sprint agent role contracts | [packages/apra-fleet-se/docs/role-contracts.md](packages/apra-fleet-se/docs/role-contracts.md) |
305
+ | MCP client SDK overview (transports, `ApraFleet` API) | [packages/apra-fleet-client/docs/overview.md](packages/apra-fleet-client/docs/overview.md) |
306
+ | MCP client SDK API reference | [packages/apra-fleet-client/docs/api-reference.md](packages/apra-fleet-client/docs/api-reference.md) |
307
+ | MCP client SDK getting started | [packages/apra-fleet-client/docs/getting-started.md](packages/apra-fleet-client/docs/getting-started.md) |
329
308
 
330
309
  ## Community
331
310
 
@@ -344,7 +323,6 @@ Build from source (also the path for Intel Macs):
344
323
 
345
324
  ```bash
346
325
  git clone https://github.com/Apra-Labs/apra-fleet && cd apra-fleet
347
- git submodule update --init
348
326
  npm install && npm run build && npm test
349
327
  ```
350
328
 
@@ -353,3 +331,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) to contribute.
353
331
  ## License
354
332
 
355
333
  Apache 2.0 -- see [LICENSE](LICENSE).
334
+
335
+ ---
336
+
337
+ <div align="center">
338
+
339
+ **Stop babysitting agents. Start operating fleets.**
340
+
341
+ [Quick Start](#quick-start-5-minutes) - [GitHub Issues](https://github.com/Apra-Labs/apra-fleet/issues) - [Apra Labs](https://apralabs.com)
342
+
343
+ </div>