@apralabs/apra-fleet 0.3.6 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (826) hide show
  1. package/README.md +378 -252
  2. package/dist/agents/backlog-groomer.md +303 -0
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +66 -13
  5. package/dist/agents/doer.md +67 -8
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +166 -60
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +88 -18
  10. package/dist/agents/planner.md +182 -19
  11. package/dist/agents/regression-test-runner.md +234 -0
  12. package/dist/agents/reviewer.md +125 -9
  13. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  14. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  15. package/dist/agents/schemas/doer-output.json +63 -3
  16. package/dist/agents/schemas/harvester-output.json +59 -2
  17. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  18. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  19. package/dist/agents/schemas/planner-output.json +65 -0
  20. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  21. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  22. package/dist/agents/schemas/reviewer-output.json +108 -7
  23. package/dist/cli/agent-transform.d.ts +1 -0
  24. package/dist/cli/agent-transform.d.ts.map +1 -1
  25. package/dist/cli/agent-transform.js +77 -0
  26. package/dist/cli/agent-transform.js.map +1 -1
  27. package/dist/cli/auth.d.ts +3 -0
  28. package/dist/cli/auth.d.ts.map +1 -1
  29. package/dist/cli/auth.js +181 -5
  30. package/dist/cli/auth.js.map +1 -1
  31. package/dist/cli/config.d.ts +5 -1
  32. package/dist/cli/config.d.ts.map +1 -1
  33. package/dist/cli/config.js +7 -1
  34. package/dist/cli/config.js.map +1 -1
  35. package/dist/cli/dolt-install.d.ts +91 -0
  36. package/dist/cli/dolt-install.d.ts.map +1 -0
  37. package/dist/cli/dolt-install.js +334 -0
  38. package/dist/cli/dolt-install.js.map +1 -0
  39. package/dist/cli/install-guard.d.ts +29 -0
  40. package/dist/cli/install-guard.d.ts.map +1 -0
  41. package/dist/cli/install-guard.js +153 -0
  42. package/dist/cli/install-guard.js.map +1 -0
  43. package/dist/cli/install.d.ts +45 -3
  44. package/dist/cli/install.d.ts.map +1 -1
  45. package/dist/cli/install.js +736 -109
  46. package/dist/cli/install.js.map +1 -1
  47. package/dist/cli/join.d.ts +12 -0
  48. package/dist/cli/join.d.ts.map +1 -0
  49. package/dist/cli/join.js +87 -0
  50. package/dist/cli/join.js.map +1 -0
  51. package/dist/cli/kb-commit.d.ts +12 -0
  52. package/dist/cli/kb-commit.d.ts.map +1 -0
  53. package/dist/cli/kb-commit.js +53 -0
  54. package/dist/cli/kb-commit.js.map +1 -0
  55. package/dist/cli/kb-directives.d.ts +17 -0
  56. package/dist/cli/kb-directives.d.ts.map +1 -0
  57. package/dist/cli/kb-directives.js +146 -0
  58. package/dist/cli/kb-directives.js.map +1 -0
  59. package/dist/cli/kb-import.d.ts +13 -0
  60. package/dist/cli/kb-import.d.ts.map +1 -0
  61. package/dist/cli/kb-import.js +56 -0
  62. package/dist/cli/kb-import.js.map +1 -0
  63. package/dist/cli/register-member.d.ts +2 -0
  64. package/dist/cli/register-member.d.ts.map +1 -0
  65. package/dist/cli/register-member.js +193 -0
  66. package/dist/cli/register-member.js.map +1 -0
  67. package/dist/cli/restart.d.ts +2 -0
  68. package/dist/cli/restart.d.ts.map +1 -0
  69. package/dist/cli/restart.js +7 -0
  70. package/dist/cli/restart.js.map +1 -0
  71. package/dist/cli/spoke.d.ts +35 -0
  72. package/dist/cli/spoke.d.ts.map +1 -0
  73. package/dist/cli/spoke.js +212 -0
  74. package/dist/cli/spoke.js.map +1 -0
  75. package/dist/cli/start.d.ts +2 -0
  76. package/dist/cli/start.d.ts.map +1 -0
  77. package/dist/cli/start.js +92 -0
  78. package/dist/cli/start.js.map +1 -0
  79. package/dist/cli/status.d.ts +2 -0
  80. package/dist/cli/status.d.ts.map +1 -0
  81. package/dist/cli/status.js +83 -0
  82. package/dist/cli/status.js.map +1 -0
  83. package/dist/cli/stop.d.ts +2 -0
  84. package/dist/cli/stop.d.ts.map +1 -0
  85. package/dist/cli/stop.js +51 -0
  86. package/dist/cli/stop.js.map +1 -0
  87. package/dist/cli/uninstall.d.ts.map +1 -1
  88. package/dist/cli/uninstall.js +120 -9
  89. package/dist/cli/uninstall.js.map +1 -1
  90. package/dist/cli/update.d.ts.map +1 -1
  91. package/dist/cli/update.js +10 -1
  92. package/dist/cli/update.js.map +1 -1
  93. package/dist/cli/watch.d.ts +53 -4
  94. package/dist/cli/watch.d.ts.map +1 -1
  95. package/dist/cli/watch.js +118 -17
  96. package/dist/cli/watch.js.map +1 -1
  97. package/dist/cli/workflow-assets.d.ts +37 -0
  98. package/dist/cli/workflow-assets.d.ts.map +1 -0
  99. package/dist/cli/workflow-assets.js +144 -0
  100. package/dist/cli/workflow-assets.js.map +1 -0
  101. package/dist/cli/workflow.d.ts +75 -0
  102. package/dist/cli/workflow.d.ts.map +1 -0
  103. package/dist/cli/workflow.js +397 -0
  104. package/dist/cli/workflow.js.map +1 -0
  105. package/dist/commands/kb-server.d.ts +8 -0
  106. package/dist/commands/kb-server.d.ts.map +1 -0
  107. package/dist/commands/kb-server.js +221 -0
  108. package/dist/commands/kb-server.js.map +1 -0
  109. package/dist/hub-service/activity.d.ts +30 -0
  110. package/dist/hub-service/activity.d.ts.map +1 -0
  111. package/dist/hub-service/activity.js +20 -0
  112. package/dist/hub-service/activity.js.map +1 -0
  113. package/dist/hub-service/audit-log.d.ts +19 -0
  114. package/dist/hub-service/audit-log.d.ts.map +1 -0
  115. package/dist/hub-service/audit-log.js +13 -0
  116. package/dist/hub-service/audit-log.js.map +1 -0
  117. package/dist/hub-service/db/pool.d.ts +19 -0
  118. package/dist/hub-service/db/pool.d.ts.map +1 -0
  119. package/dist/hub-service/db/pool.js +53 -0
  120. package/dist/hub-service/db/pool.js.map +1 -0
  121. package/dist/hub-service/enrollment.d.ts +29 -0
  122. package/dist/hub-service/enrollment.d.ts.map +1 -0
  123. package/dist/hub-service/enrollment.js +48 -0
  124. package/dist/hub-service/enrollment.js.map +1 -0
  125. package/dist/hub-service/envelope-routes.d.ts +46 -0
  126. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  127. package/dist/hub-service/envelope-routes.js +94 -0
  128. package/dist/hub-service/envelope-routes.js.map +1 -0
  129. package/dist/hub-service/handlers/installers.d.ts +14 -0
  130. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  131. package/dist/hub-service/handlers/installers.js +8 -0
  132. package/dist/hub-service/handlers/installers.js.map +1 -0
  133. package/dist/hub-service/http-server.d.ts +31 -0
  134. package/dist/hub-service/http-server.d.ts.map +1 -0
  135. package/dist/hub-service/http-server.js +711 -0
  136. package/dist/hub-service/http-server.js.map +1 -0
  137. package/dist/hub-service/hub-jwt.d.ts +30 -0
  138. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  139. package/dist/hub-service/hub-jwt.js +105 -0
  140. package/dist/hub-service/hub-jwt.js.map +1 -0
  141. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  142. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  143. package/dist/hub-service/jwt-revocation.js +18 -0
  144. package/dist/hub-service/jwt-revocation.js.map +1 -0
  145. package/dist/hub-service/machines.d.ts +16 -0
  146. package/dist/hub-service/machines.d.ts.map +1 -0
  147. package/dist/hub-service/machines.js +14 -0
  148. package/dist/hub-service/machines.js.map +1 -0
  149. package/dist/hub-service/main.d.ts +3 -0
  150. package/dist/hub-service/main.d.ts.map +1 -0
  151. package/dist/hub-service/main.js +64 -0
  152. package/dist/hub-service/main.js.map +1 -0
  153. package/dist/hub-service/member-tokens.d.ts +11 -0
  154. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  155. package/dist/hub-service/member-tokens.js +49 -0
  156. package/dist/hub-service/member-tokens.js.map +1 -0
  157. package/dist/hub-service/member-view.d.ts +20 -0
  158. package/dist/hub-service/member-view.d.ts.map +1 -0
  159. package/dist/hub-service/member-view.js +76 -0
  160. package/dist/hub-service/member-view.js.map +1 -0
  161. package/dist/hub-service/members.d.ts +44 -0
  162. package/dist/hub-service/members.d.ts.map +1 -0
  163. package/dist/hub-service/members.js +25 -0
  164. package/dist/hub-service/members.js.map +1 -0
  165. package/dist/hub-service/presence.d.ts +40 -0
  166. package/dist/hub-service/presence.d.ts.map +1 -0
  167. package/dist/hub-service/presence.js +44 -0
  168. package/dist/hub-service/presence.js.map +1 -0
  169. package/dist/hub-service/project-view.d.ts +12 -0
  170. package/dist/hub-service/project-view.d.ts.map +1 -0
  171. package/dist/hub-service/project-view.js +34 -0
  172. package/dist/hub-service/project-view.js.map +1 -0
  173. package/dist/hub-service/projects.d.ts +48 -0
  174. package/dist/hub-service/projects.d.ts.map +1 -0
  175. package/dist/hub-service/projects.js +80 -0
  176. package/dist/hub-service/projects.js.map +1 -0
  177. package/dist/hub-service/relay-queue.d.ts +115 -0
  178. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  179. package/dist/hub-service/relay-queue.js +148 -0
  180. package/dist/hub-service/relay-queue.js.map +1 -0
  181. package/dist/hub-service/session-jwt.d.ts +10 -0
  182. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  183. package/dist/hub-service/session-jwt.js +69 -0
  184. package/dist/hub-service/session-jwt.js.map +1 -0
  185. package/dist/hub-service/usage.d.ts +40 -0
  186. package/dist/hub-service/usage.d.ts.map +1 -0
  187. package/dist/hub-service/usage.js +25 -0
  188. package/dist/hub-service/usage.js.map +1 -0
  189. package/dist/hub-service/users.d.ts +56 -0
  190. package/dist/hub-service/users.d.ts.map +1 -0
  191. package/dist/hub-service/users.js +72 -0
  192. package/dist/hub-service/users.js.map +1 -0
  193. package/dist/hub-service/workspaces.d.ts +20 -0
  194. package/dist/hub-service/workspaces.d.ts.map +1 -0
  195. package/dist/hub-service/workspaces.js +10 -0
  196. package/dist/hub-service/workspaces.js.map +1 -0
  197. package/dist/index.js +254 -132
  198. package/dist/index.js.map +1 -1
  199. package/dist/os/linux.d.ts +14 -0
  200. package/dist/os/linux.d.ts.map +1 -1
  201. package/dist/os/linux.js +80 -4
  202. package/dist/os/linux.js.map +1 -1
  203. package/dist/os/os-commands.d.ts +15 -0
  204. package/dist/os/os-commands.d.ts.map +1 -1
  205. package/dist/os/windows.d.ts +36 -0
  206. package/dist/os/windows.d.ts.map +1 -1
  207. package/dist/os/windows.js +74 -18
  208. package/dist/os/windows.js.map +1 -1
  209. package/dist/paths.d.ts +23 -0
  210. package/dist/paths.d.ts.map +1 -1
  211. package/dist/paths.js +29 -0
  212. package/dist/paths.js.map +1 -1
  213. package/dist/providers/agy.d.ts +20 -2
  214. package/dist/providers/agy.d.ts.map +1 -1
  215. package/dist/providers/agy.js +259 -21
  216. package/dist/providers/agy.js.map +1 -1
  217. package/dist/providers/claude.d.ts +16 -2
  218. package/dist/providers/claude.d.ts.map +1 -1
  219. package/dist/providers/claude.js +283 -16
  220. package/dist/providers/claude.js.map +1 -1
  221. package/dist/providers/codex.d.ts +13 -2
  222. package/dist/providers/codex.d.ts.map +1 -1
  223. package/dist/providers/codex.js +36 -6
  224. package/dist/providers/codex.js.map +1 -1
  225. package/dist/providers/copilot.d.ts +13 -2
  226. package/dist/providers/copilot.d.ts.map +1 -1
  227. package/dist/providers/copilot.js +34 -7
  228. package/dist/providers/copilot.js.map +1 -1
  229. package/dist/providers/email/headers.d.ts +15 -0
  230. package/dist/providers/email/headers.d.ts.map +1 -0
  231. package/dist/providers/email/headers.js +42 -0
  232. package/dist/providers/email/headers.js.map +1 -0
  233. package/dist/providers/email/index.d.ts +18 -0
  234. package/dist/providers/email/index.d.ts.map +1 -0
  235. package/dist/providers/email/index.js +60 -0
  236. package/dist/providers/email/index.js.map +1 -0
  237. package/dist/providers/email/provider.d.ts +49 -0
  238. package/dist/providers/email/provider.d.ts.map +1 -0
  239. package/dist/providers/email/provider.js +2 -0
  240. package/dist/providers/email/provider.js.map +1 -0
  241. package/dist/providers/email/sendgrid.d.ts +12 -0
  242. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  243. package/dist/providers/email/sendgrid.js +67 -0
  244. package/dist/providers/email/sendgrid.js.map +1 -0
  245. package/dist/providers/email/smtp.d.ts +65 -0
  246. package/dist/providers/email/smtp.d.ts.map +1 -0
  247. package/dist/providers/email/smtp.js +373 -0
  248. package/dist/providers/email/smtp.js.map +1 -0
  249. package/dist/providers/gemini.d.ts +13 -2
  250. package/dist/providers/gemini.d.ts.map +1 -1
  251. package/dist/providers/gemini.js +49 -5
  252. package/dist/providers/gemini.js.map +1 -1
  253. package/dist/providers/index.d.ts +1 -0
  254. package/dist/providers/index.d.ts.map +1 -1
  255. package/dist/providers/index.js +3 -0
  256. package/dist/providers/index.js.map +1 -1
  257. package/dist/providers/none.d.ts +61 -0
  258. package/dist/providers/none.d.ts.map +1 -0
  259. package/dist/providers/none.js +124 -0
  260. package/dist/providers/none.js.map +1 -0
  261. package/dist/providers/opencode.d.ts +14 -2
  262. package/dist/providers/opencode.d.ts.map +1 -1
  263. package/dist/providers/opencode.js +104 -4
  264. package/dist/providers/opencode.js.map +1 -1
  265. package/dist/providers/provider.d.ts +156 -1
  266. package/dist/providers/provider.d.ts.map +1 -1
  267. package/dist/providers/provider.js +54 -0
  268. package/dist/providers/provider.js.map +1 -1
  269. package/dist/services/agent-provisioner.d.ts +3 -3
  270. package/dist/services/agent-provisioner.d.ts.map +1 -1
  271. package/dist/services/agent-provisioner.js +11 -7
  272. package/dist/services/agent-provisioner.js.map +1 -1
  273. package/dist/services/auth-socket.d.ts.map +1 -1
  274. package/dist/services/auth-socket.js +2 -0
  275. package/dist/services/auth-socket.js.map +1 -1
  276. package/dist/services/budget-awareness.d.ts +130 -0
  277. package/dist/services/budget-awareness.d.ts.map +1 -0
  278. package/dist/services/budget-awareness.js +129 -0
  279. package/dist/services/budget-awareness.js.map +1 -0
  280. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  281. package/dist/services/cloud/lifecycle.js +3 -0
  282. package/dist/services/cloud/lifecycle.js.map +1 -1
  283. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  284. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  285. package/dist/services/cloud/task-wrapper.js +157 -0
  286. package/dist/services/cloud/task-wrapper.js.map +1 -1
  287. package/dist/services/cloud-sync.d.ts +35 -0
  288. package/dist/services/cloud-sync.d.ts.map +1 -0
  289. package/dist/services/cloud-sync.js +90 -0
  290. package/dist/services/cloud-sync.js.map +1 -0
  291. package/dist/services/context-admission.d.ts +82 -0
  292. package/dist/services/context-admission.d.ts.map +1 -0
  293. package/dist/services/context-admission.js +136 -0
  294. package/dist/services/context-admission.js.map +1 -0
  295. package/dist/services/event-bus.d.ts +27 -0
  296. package/dist/services/event-bus.d.ts.map +1 -0
  297. package/dist/services/event-bus.js +20 -0
  298. package/dist/services/event-bus.js.map +1 -0
  299. package/dist/services/file-chunker.d.ts +38 -0
  300. package/dist/services/file-chunker.d.ts.map +1 -0
  301. package/dist/services/file-chunker.js +63 -0
  302. package/dist/services/file-chunker.js.map +1 -0
  303. package/dist/services/file-transfer-relay.d.ts +55 -0
  304. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  305. package/dist/services/file-transfer-relay.js +115 -0
  306. package/dist/services/file-transfer-relay.js.map +1 -0
  307. package/dist/services/github-app.d.ts.map +1 -1
  308. package/dist/services/github-app.js +12 -2
  309. package/dist/services/github-app.js.map +1 -1
  310. package/dist/services/http-transport.d.ts +25 -0
  311. package/dist/services/http-transport.d.ts.map +1 -0
  312. package/dist/services/http-transport.js +371 -0
  313. package/dist/services/http-transport.js.map +1 -0
  314. package/dist/services/hub-client.d.ts +69 -0
  315. package/dist/services/hub-client.d.ts.map +1 -0
  316. package/dist/services/hub-client.js +217 -0
  317. package/dist/services/hub-client.js.map +1 -0
  318. package/dist/services/jwt.d.ts +17 -0
  319. package/dist/services/jwt.d.ts.map +1 -0
  320. package/dist/services/jwt.js +70 -0
  321. package/dist/services/jwt.js.map +1 -0
  322. package/dist/services/knowledge/audn.d.ts +37 -0
  323. package/dist/services/knowledge/audn.d.ts.map +1 -0
  324. package/dist/services/knowledge/audn.js +219 -0
  325. package/dist/services/knowledge/audn.js.map +1 -0
  326. package/dist/services/knowledge/file-hash.d.ts +11 -0
  327. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  328. package/dist/services/knowledge/file-hash.js +123 -0
  329. package/dist/services/knowledge/file-hash.js.map +1 -0
  330. package/dist/services/knowledge/http-provider.d.ts +46 -0
  331. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  332. package/dist/services/knowledge/http-provider.js +254 -0
  333. package/dist/services/knowledge/http-provider.js.map +1 -0
  334. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  335. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  336. package/dist/services/knowledge/kb-providers.js +92 -0
  337. package/dist/services/knowledge/kb-providers.js.map +1 -0
  338. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  339. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  340. package/dist/services/knowledge/kb-scope-input.js +11 -0
  341. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  342. package/dist/services/knowledge/kb-service.d.ts +3 -0
  343. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  344. package/dist/services/knowledge/kb-service.js +2 -0
  345. package/dist/services/knowledge/kb-service.js.map +1 -0
  346. package/dist/services/knowledge/path-validation.d.ts +2 -0
  347. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  348. package/dist/services/knowledge/path-validation.js +13 -0
  349. package/dist/services/knowledge/path-validation.js.map +1 -0
  350. package/dist/services/knowledge/pre-init.d.ts +14 -0
  351. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  352. package/dist/services/knowledge/pre-init.js +147 -0
  353. package/dist/services/knowledge/pre-init.js.map +1 -0
  354. package/dist/services/knowledge/project-slug.d.ts +2 -0
  355. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  356. package/dist/services/knowledge/project-slug.js +49 -0
  357. package/dist/services/knowledge/project-slug.js.map +1 -0
  358. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  359. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  360. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  361. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  362. package/dist/services/knowledge/types.d.ts +163 -0
  363. package/dist/services/knowledge/types.d.ts.map +1 -0
  364. package/dist/services/knowledge/types.js +9 -0
  365. package/dist/services/knowledge/types.js.map +1 -0
  366. package/dist/services/known-sessions.d.ts +8 -0
  367. package/dist/services/known-sessions.d.ts.map +1 -0
  368. package/dist/services/known-sessions.js +40 -0
  369. package/dist/services/known-sessions.js.map +1 -0
  370. package/dist/services/member-home.d.ts +89 -0
  371. package/dist/services/member-home.d.ts.map +1 -0
  372. package/dist/services/member-home.js +256 -0
  373. package/dist/services/member-home.js.map +1 -0
  374. package/dist/services/member-remote-url.d.ts +34 -0
  375. package/dist/services/member-remote-url.d.ts.map +1 -0
  376. package/dist/services/member-remote-url.js +39 -0
  377. package/dist/services/member-remote-url.js.map +1 -0
  378. package/dist/services/model-pricing.d.ts +36 -0
  379. package/dist/services/model-pricing.d.ts.map +1 -0
  380. package/dist/services/model-pricing.js +108 -0
  381. package/dist/services/model-pricing.js.map +1 -0
  382. package/dist/services/orphan-recovery.d.ts +59 -0
  383. package/dist/services/orphan-recovery.d.ts.map +1 -0
  384. package/dist/services/orphan-recovery.js +122 -0
  385. package/dist/services/orphan-recovery.js.map +1 -0
  386. package/dist/services/pending-responses.d.ts +23 -0
  387. package/dist/services/pending-responses.d.ts.map +1 -0
  388. package/dist/services/pending-responses.js +52 -0
  389. package/dist/services/pending-responses.js.map +1 -0
  390. package/dist/services/preflight-check.d.ts +56 -0
  391. package/dist/services/preflight-check.d.ts.map +1 -0
  392. package/dist/services/preflight-check.js +277 -0
  393. package/dist/services/preflight-check.js.map +1 -0
  394. package/dist/services/registry.d.ts +4 -1
  395. package/dist/services/registry.d.ts.map +1 -1
  396. package/dist/services/registry.js +3 -0
  397. package/dist/services/registry.js.map +1 -1
  398. package/dist/services/relay-context.d.ts +23 -0
  399. package/dist/services/relay-context.d.ts.map +1 -0
  400. package/dist/services/relay-context.js +8 -0
  401. package/dist/services/relay-context.js.map +1 -0
  402. package/dist/services/relay-executor.d.ts +68 -0
  403. package/dist/services/relay-executor.d.ts.map +1 -0
  404. package/dist/services/relay-executor.js +70 -0
  405. package/dist/services/relay-executor.js.map +1 -0
  406. package/dist/services/relay-request.d.ts +65 -0
  407. package/dist/services/relay-request.d.ts.map +1 -0
  408. package/dist/services/relay-request.js +129 -0
  409. package/dist/services/relay-request.js.map +1 -0
  410. package/dist/services/relay-strategy.d.ts +19 -0
  411. package/dist/services/relay-strategy.d.ts.map +1 -0
  412. package/dist/services/relay-strategy.js +111 -0
  413. package/dist/services/relay-strategy.js.map +1 -0
  414. package/dist/services/service-manager/index.d.ts +5 -0
  415. package/dist/services/service-manager/index.d.ts.map +1 -0
  416. package/dist/services/service-manager/index.js +66 -0
  417. package/dist/services/service-manager/index.js.map +1 -0
  418. package/dist/services/service-manager/linux.d.ts +10 -0
  419. package/dist/services/service-manager/linux.d.ts.map +1 -0
  420. package/dist/services/service-manager/linux.js +97 -0
  421. package/dist/services/service-manager/linux.js.map +1 -0
  422. package/dist/services/service-manager/macos.d.ts +10 -0
  423. package/dist/services/service-manager/macos.d.ts.map +1 -0
  424. package/dist/services/service-manager/macos.js +94 -0
  425. package/dist/services/service-manager/macos.js.map +1 -0
  426. package/dist/services/service-manager/types.d.ts +18 -0
  427. package/dist/services/service-manager/types.d.ts.map +1 -0
  428. package/dist/services/service-manager/types.js +5 -0
  429. package/dist/services/service-manager/types.js.map +1 -0
  430. package/dist/services/service-manager/windows.d.ts +10 -0
  431. package/dist/services/service-manager/windows.d.ts.map +1 -0
  432. package/dist/services/service-manager/windows.js +73 -0
  433. package/dist/services/service-manager/windows.js.map +1 -0
  434. package/dist/services/session-registry.d.ts +70 -0
  435. package/dist/services/session-registry.d.ts.map +1 -0
  436. package/dist/services/session-registry.js +91 -0
  437. package/dist/services/session-registry.js.map +1 -0
  438. package/dist/services/singleton.d.ts +15 -0
  439. package/dist/services/singleton.d.ts.map +1 -0
  440. package/dist/services/singleton.js +98 -0
  441. package/dist/services/singleton.js.map +1 -0
  442. package/dist/services/sprint-coordination.d.ts +168 -0
  443. package/dist/services/sprint-coordination.d.ts.map +1 -0
  444. package/dist/services/sprint-coordination.js +564 -0
  445. package/dist/services/sprint-coordination.js.map +1 -0
  446. package/dist/services/ssh.d.ts.map +1 -1
  447. package/dist/services/ssh.js +70 -3
  448. package/dist/services/ssh.js.map +1 -1
  449. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  450. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  451. package/dist/services/stall/log-path-resolver.js +17 -33
  452. package/dist/services/stall/log-path-resolver.js.map +1 -1
  453. package/dist/services/stall/stall-detector.d.ts +32 -0
  454. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  455. package/dist/services/stall/stall-detector.js +187 -12
  456. package/dist/services/stall/stall-detector.js.map +1 -1
  457. package/dist/services/stall/stall-poller.d.ts +50 -0
  458. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  459. package/dist/services/stall/stall-poller.js +268 -18
  460. package/dist/services/stall/stall-poller.js.map +1 -1
  461. package/dist/services/strategy.d.ts.map +1 -1
  462. package/dist/services/strategy.js +57 -7
  463. package/dist/services/strategy.js.map +1 -1
  464. package/dist/services/substitution-engine.d.ts +20 -0
  465. package/dist/services/substitution-engine.d.ts.map +1 -0
  466. package/dist/services/substitution-engine.js +92 -0
  467. package/dist/services/substitution-engine.js.map +1 -0
  468. package/dist/services/task-cleanup.d.ts.map +1 -1
  469. package/dist/services/task-cleanup.js +1 -9
  470. package/dist/services/task-cleanup.js.map +1 -1
  471. package/dist/services/token-issuer.d.ts +47 -0
  472. package/dist/services/token-issuer.d.ts.map +1 -0
  473. package/dist/services/token-issuer.js +63 -0
  474. package/dist/services/token-issuer.js.map +1 -0
  475. package/dist/services/tool-registry.d.ts +3 -0
  476. package/dist/services/tool-registry.d.ts.map +1 -0
  477. package/dist/services/tool-registry.js +225 -0
  478. package/dist/services/tool-registry.js.map +1 -0
  479. package/dist/services/user-config.d.ts +14 -0
  480. package/dist/services/user-config.d.ts.map +1 -1
  481. package/dist/services/user-config.js +55 -0
  482. package/dist/services/user-config.js.map +1 -1
  483. package/dist/services/vcs/github.d.ts.map +1 -1
  484. package/dist/services/vcs/github.js +32 -1
  485. package/dist/services/vcs/github.js.map +1 -1
  486. package/dist/services/vcs/types.d.ts +44 -0
  487. package/dist/services/vcs/types.d.ts.map +1 -1
  488. package/dist/services/version-check.d.ts +22 -0
  489. package/dist/services/version-check.d.ts.map +1 -0
  490. package/dist/services/version-check.js +103 -0
  491. package/dist/services/version-check.js.map +1 -0
  492. package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
  493. package/dist/skills/pm/beads.md +6 -0
  494. package/dist/skills/pm/cost.md +3 -0
  495. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  496. package/dist/skills/pm/fleet-addendum.md +6 -0
  497. package/dist/skills/pm/index.md +56 -0
  498. package/dist/skills/pm/kb-reconcile.md +132 -0
  499. package/dist/skills/pm/kb-review.md +109 -0
  500. package/dist/tools/check-status.d.ts +47 -0
  501. package/dist/tools/check-status.d.ts.map +1 -1
  502. package/dist/tools/check-status.js +250 -2
  503. package/dist/tools/check-status.js.map +1 -1
  504. package/dist/tools/child-id-allocator.d.ts +45 -0
  505. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  506. package/dist/tools/child-id-allocator.js +62 -0
  507. package/dist/tools/child-id-allocator.js.map +1 -0
  508. package/dist/tools/cloud-control.d.ts +2 -2
  509. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  510. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  511. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  512. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  513. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  514. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  515. package/dist/tools/code-intelligence-freshness.js +26 -0
  516. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  517. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  518. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  519. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  520. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  521. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  522. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  523. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  524. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  525. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  526. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  527. package/dist/tools/code-intelligence-reindex.js +106 -0
  528. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  529. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  530. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  531. package/dist/tools/code-intelligence-telemetry.js +52 -0
  532. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  533. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  534. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  535. package/dist/tools/code-intelligence-tests.js +24 -0
  536. package/dist/tools/code-intelligence-tests.js.map +1 -0
  537. package/dist/tools/code-intelligence.d.ts +114 -0
  538. package/dist/tools/code-intelligence.d.ts.map +1 -0
  539. package/dist/tools/code-intelligence.js +124 -0
  540. package/dist/tools/code-intelligence.js.map +1 -0
  541. package/dist/tools/compose-permissions.d.ts +38 -4
  542. package/dist/tools/compose-permissions.d.ts.map +1 -1
  543. package/dist/tools/compose-permissions.js +295 -33
  544. package/dist/tools/compose-permissions.js.map +1 -1
  545. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  546. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  547. package/dist/tools/dolt-push-mutex.js +83 -0
  548. package/dist/tools/dolt-push-mutex.js.map +1 -0
  549. package/dist/tools/execute-command.d.ts +13 -1
  550. package/dist/tools/execute-command.d.ts.map +1 -1
  551. package/dist/tools/execute-command.js +108 -21
  552. package/dist/tools/execute-command.js.map +1 -1
  553. package/dist/tools/execute-prompt.d.ts +84 -12
  554. package/dist/tools/execute-prompt.d.ts.map +1 -1
  555. package/dist/tools/execute-prompt.js +1191 -88
  556. package/dist/tools/execute-prompt.js.map +1 -1
  557. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  558. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  559. package/dist/tools/get-member-model-pricing.js +29 -0
  560. package/dist/tools/get-member-model-pricing.js.map +1 -0
  561. package/dist/tools/kb-capture.d.ts +53 -0
  562. package/dist/tools/kb-capture.d.ts.map +1 -0
  563. package/dist/tools/kb-capture.js +130 -0
  564. package/dist/tools/kb-capture.js.map +1 -0
  565. package/dist/tools/kb-context.d.ts +17 -0
  566. package/dist/tools/kb-context.d.ts.map +1 -0
  567. package/dist/tools/kb-context.js +29 -0
  568. package/dist/tools/kb-context.js.map +1 -0
  569. package/dist/tools/kb-export.d.ts +19 -0
  570. package/dist/tools/kb-export.d.ts.map +1 -0
  571. package/dist/tools/kb-export.js +344 -0
  572. package/dist/tools/kb-export.js.map +1 -0
  573. package/dist/tools/kb-feedback.d.ts +23 -0
  574. package/dist/tools/kb-feedback.d.ts.map +1 -0
  575. package/dist/tools/kb-feedback.js +43 -0
  576. package/dist/tools/kb-feedback.js.map +1 -0
  577. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  578. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  579. package/dist/tools/kb-freshness-sweep.js +29 -0
  580. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  581. package/dist/tools/kb-harvest.d.ts +20 -0
  582. package/dist/tools/kb-harvest.d.ts.map +1 -0
  583. package/dist/tools/kb-harvest.js +143 -0
  584. package/dist/tools/kb-harvest.js.map +1 -0
  585. package/dist/tools/kb-import.d.ts +44 -0
  586. package/dist/tools/kb-import.d.ts.map +1 -0
  587. package/dist/tools/kb-import.js +239 -0
  588. package/dist/tools/kb-import.js.map +1 -0
  589. package/dist/tools/kb-invalidate.d.ts +19 -0
  590. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  591. package/dist/tools/kb-invalidate.js +34 -0
  592. package/dist/tools/kb-invalidate.js.map +1 -0
  593. package/dist/tools/kb-list.d.ts +32 -0
  594. package/dist/tools/kb-list.d.ts.map +1 -0
  595. package/dist/tools/kb-list.js +43 -0
  596. package/dist/tools/kb-list.js.map +1 -0
  597. package/dist/tools/kb-promote.d.ts +20 -0
  598. package/dist/tools/kb-promote.d.ts.map +1 -0
  599. package/dist/tools/kb-promote.js +20 -0
  600. package/dist/tools/kb-promote.js.map +1 -0
  601. package/dist/tools/kb-query.d.ts +35 -0
  602. package/dist/tools/kb-query.d.ts.map +1 -0
  603. package/dist/tools/kb-query.js +111 -0
  604. package/dist/tools/kb-query.js.map +1 -0
  605. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  606. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  607. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  608. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  609. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  610. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  611. package/dist/tools/kb-resolve-contradiction.js +37 -0
  612. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  613. package/dist/tools/kb-session-prime.d.ts +26 -0
  614. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  615. package/dist/tools/kb-session-prime.js +392 -0
  616. package/dist/tools/kb-session-prime.js.map +1 -0
  617. package/dist/tools/kb-setup.d.ts +20 -0
  618. package/dist/tools/kb-setup.d.ts.map +1 -0
  619. package/dist/tools/kb-setup.js +49 -0
  620. package/dist/tools/kb-setup.js.map +1 -0
  621. package/dist/tools/kb-stats.d.ts +20 -0
  622. package/dist/tools/kb-stats.d.ts.map +1 -0
  623. package/dist/tools/kb-stats.js +115 -0
  624. package/dist/tools/kb-stats.js.map +1 -0
  625. package/dist/tools/list-members.d.ts.map +1 -1
  626. package/dist/tools/list-members.js +39 -7
  627. package/dist/tools/list-members.js.map +1 -1
  628. package/dist/tools/member-detail.d.ts +1 -1
  629. package/dist/tools/member-detail.d.ts.map +1 -1
  630. package/dist/tools/member-detail.js +16 -2
  631. package/dist/tools/member-detail.js.map +1 -1
  632. package/dist/tools/member-reservation.d.ts +29 -0
  633. package/dist/tools/member-reservation.d.ts.map +1 -0
  634. package/dist/tools/member-reservation.js +71 -0
  635. package/dist/tools/member-reservation.js.map +1 -0
  636. package/dist/tools/monitor-task.d.ts.map +1 -1
  637. package/dist/tools/monitor-task.js +21 -3
  638. package/dist/tools/monitor-task.js.map +1 -1
  639. package/dist/tools/provision-auth.d.ts.map +1 -1
  640. package/dist/tools/provision-auth.js +10 -3
  641. package/dist/tools/provision-auth.js.map +1 -1
  642. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  643. package/dist/tools/provision-vcs-auth.js +1 -1
  644. package/dist/tools/provision-vcs-auth.js.map +1 -1
  645. package/dist/tools/register-member.d.ts +20 -5
  646. package/dist/tools/register-member.d.ts.map +1 -1
  647. package/dist/tools/register-member.js +174 -6
  648. package/dist/tools/register-member.js.map +1 -1
  649. package/dist/tools/remove-member.d.ts +1 -1
  650. package/dist/tools/remove-member.d.ts.map +1 -1
  651. package/dist/tools/remove-member.js +17 -3
  652. package/dist/tools/remove-member.js.map +1 -1
  653. package/dist/tools/report-status.d.ts +33 -0
  654. package/dist/tools/report-status.d.ts.map +1 -0
  655. package/dist/tools/report-status.js +45 -0
  656. package/dist/tools/report-status.js.map +1 -0
  657. package/dist/tools/respond-to-message.d.ts +21 -0
  658. package/dist/tools/respond-to-message.d.ts.map +1 -0
  659. package/dist/tools/respond-to-message.js +23 -0
  660. package/dist/tools/respond-to-message.js.map +1 -0
  661. package/dist/tools/send-email.d.ts +69 -0
  662. package/dist/tools/send-email.d.ts.map +1 -0
  663. package/dist/tools/send-email.js +177 -0
  664. package/dist/tools/send-email.js.map +1 -0
  665. package/dist/tools/send-files.d.ts +3 -0
  666. package/dist/tools/send-files.d.ts.map +1 -1
  667. package/dist/tools/send-files.js +88 -8
  668. package/dist/tools/send-files.js.map +1 -1
  669. package/dist/tools/send-message.d.ts +27 -0
  670. package/dist/tools/send-message.d.ts.map +1 -0
  671. package/dist/tools/send-message.js +46 -0
  672. package/dist/tools/send-message.js.map +1 -0
  673. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  674. package/dist/tools/setup-ssh-key.js +2 -0
  675. package/dist/tools/setup-ssh-key.js.map +1 -1
  676. package/dist/tools/shutdown-server.d.ts +2 -0
  677. package/dist/tools/shutdown-server.d.ts.map +1 -1
  678. package/dist/tools/shutdown-server.js +19 -0
  679. package/dist/tools/shutdown-server.js.map +1 -1
  680. package/dist/tools/update-member.d.ts +11 -8
  681. package/dist/tools/update-member.d.ts.map +1 -1
  682. package/dist/tools/update-member.js +36 -2
  683. package/dist/tools/update-member.js.map +1 -1
  684. package/dist/types.d.ts +16 -3
  685. package/dist/types.d.ts.map +1 -1
  686. package/dist/utils/agent-helpers.d.ts +2 -1
  687. package/dist/utils/agent-helpers.d.ts.map +1 -1
  688. package/dist/utils/agent-helpers.js +7 -2
  689. package/dist/utils/agent-helpers.js.map +1 -1
  690. package/dist/utils/pid-helpers.d.ts +15 -0
  691. package/dist/utils/pid-helpers.d.ts.map +1 -1
  692. package/dist/utils/pid-helpers.js +23 -0
  693. package/dist/utils/pid-helpers.js.map +1 -1
  694. package/dist/utils/process-utils.d.ts +3 -0
  695. package/dist/utils/process-utils.d.ts.map +1 -0
  696. package/dist/utils/process-utils.js +42 -0
  697. package/dist/utils/process-utils.js.map +1 -0
  698. package/dist/utils/prompt-errors.d.ts +2 -1
  699. package/dist/utils/prompt-errors.d.ts.map +1 -1
  700. package/dist/utils/prompt-errors.js +13 -3
  701. package/dist/utils/prompt-errors.js.map +1 -1
  702. package/dist/utils/session-caller.d.ts +28 -0
  703. package/dist/utils/session-caller.d.ts.map +1 -0
  704. package/dist/utils/session-caller.js +24 -0
  705. package/dist/utils/session-caller.js.map +1 -0
  706. package/dist/utils/work-folder-validation.d.ts +39 -0
  707. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  708. package/dist/utils/work-folder-validation.js +60 -0
  709. package/dist/utils/work-folder-validation.js.map +1 -0
  710. package/dist/utils/workspace-trust.d.ts +24 -0
  711. package/dist/utils/workspace-trust.d.ts.map +1 -0
  712. package/dist/utils/workspace-trust.js +35 -0
  713. package/dist/utils/workspace-trust.js.map +1 -0
  714. package/dist/workflows/auto-sprint.js +994 -91
  715. package/package.json +40 -9
  716. package/packages/apra-fleet-client/package.json +26 -0
  717. package/packages/apra-fleet-client/src/client/api.mjs +510 -0
  718. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  719. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  720. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  721. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  722. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  723. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
  724. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
  725. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
  726. package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
  727. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
  728. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
  729. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  730. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
  731. package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
  732. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
  733. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
  734. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  735. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  736. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  737. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  738. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  739. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  740. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  741. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
  742. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  743. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
  744. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  745. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  746. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  747. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  748. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  749. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  750. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  751. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  752. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  753. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
  754. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  755. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
  756. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  757. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  758. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
  759. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  760. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  761. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  762. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  763. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  764. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  765. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  766. package/packages/apra-fleet-se/bin/cli.mjs +864 -0
  767. package/packages/apra-fleet-se/bin/serve.mjs +395 -0
  768. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  769. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
  770. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  771. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  772. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
  773. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  774. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  775. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  776. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  777. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  778. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  779. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  780. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  781. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
  782. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
  783. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  784. package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
  785. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
  786. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  787. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  788. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  789. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  790. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  791. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  792. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  793. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  794. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
  795. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  796. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
  797. package/packages/apra-fleet-se/package.json +29 -0
  798. package/packages/apra-fleet-se/workflow.json +1 -0
  799. package/packages/apra-fleet-workflow/package.json +30 -0
  800. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  801. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  802. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  803. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
  804. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  805. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  806. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  807. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  808. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  809. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  810. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
  811. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  812. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  813. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  814. package/scripts/agy-transcript-reader.js +1 -0
  815. package/scripts/fleet-statusline.sh +17 -13
  816. package/skills/fleet/SKILL.md +37 -2
  817. package/skills/fleet/beads.md +14 -7
  818. package/skills/fleet/knowledge-agent.md +66 -0
  819. package/skills/fleet/permissions.md +76 -2
  820. package/skills/fleet/profiles/base-dev.json +11 -1
  821. package/skills/fleet/profiles/base-reviewer.json +9 -1
  822. package/skills/fleet/profiles/node.json +2 -2
  823. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  824. package/version.json +1 -1
  825. package/scripts/agy-settings-merge.js +0 -27
  826. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,114 @@
1
+ ---
2
+ name: fleet-sprint-cli
3
+ description: How to launch and supervise apra-fleet's autonomous sprint workflow from the CLI (`apra-fleet workflow fleet-sprint`) -- the --issue/--members/--branch/--base flag contract, the preconditions to check first, how to launch it as a detached process, and how to watch it via its dashboard. Trigger before running `apra-fleet workflow fleet-sprint`.
4
+ ---
5
+
6
+ # fleet-sprint
7
+
8
+ `fleet-sprint` is apra-fleet's autonomous sprint engine. It drives a full
9
+ plan -> develop -> review -> deploy -> integ-test -> harvest cycle across one
10
+ or more registered fleet members, working a set of beads issues on a branch
11
+ and opening a PR at the end.
12
+
13
+ ## The command
14
+
15
+ ```
16
+ apra-fleet workflow fleet-sprint \
17
+ --issue <id[,id2,...]> \
18
+ --members <name[,name2,...]> \
19
+ --branch <branch-name> \
20
+ --base <base-branch> \
21
+ [--goal P1|P1/P2|P1/P2/P3] # default P1/P2
22
+ [--max-cycles N] # default 5
23
+ [--allow-missing-members]
24
+ [--requirements-file <path>]
25
+ [--role-map <json|@file>] # {"doer":["m1","m2"], ...}
26
+ [--viewer-port <port>] # default 8080
27
+ [--budget <usd>] # default unlimited
28
+ [--dispatch-timeout-s <s>] # default 9000
29
+ [--sync] # synced-topology mode
30
+ ```
31
+
32
+ `--issue`, `--members`, `--branch`, and `--base` are required. Verify the
33
+ live flag set with `apra-fleet workflow fleet-sprint --help` before relying
34
+ on this list -- flags evolve and this skill can drift.
35
+
36
+ ## Flag notes
37
+
38
+ - `--issue` takes comma-separated **beads parent/epic IDs**. Scope is
39
+ resolved internally via `bd list --parent <id>`, so it only ever
40
+ understands the parent-child hierarchy. A `blocked-by`-only manifest bead
41
+ is invisible to the scope filter no matter what you pass -- only true
42
+ children are picked up. See the epics/manifest-bead guidance in
43
+ `packages/apra-fleet-se/fleet-sprint/docs/README.md`.
44
+ - `--branch` is created from `--base` if it does not already exist. If it
45
+ does exist (e.g. you are resuming), it is reused as-is.
46
+ - **`--base` is resolved against the remote, not your local checkout.** A new
47
+ sprint branch is cut from `origin/<base>`, so any local commit on `<base>`
48
+ that you have not pushed is invisible to the run. Push `<base>` first --
49
+ otherwise the sprint silently starts from an older tree, and work that
50
+ depends on those commits (a `.beads/config.yaml` from `bd init`, a new
51
+ package.json script) fails in ways that look unrelated.
52
+ - `--role-map` assigns specific members to specific roles, e.g.
53
+ `--role-map '{"doer":["m1","m2"],"reviewer":["m3"]}'`. Accepts inline JSON
54
+ or `@path/to/file.json`.
55
+ - `--goal` controls which bead priorities are in scope for the run.
56
+ - `--budget` caps total spend in USD; the run aborts when it is exhausted.
57
+
58
+ ## Preconditions to check first
59
+
60
+ 1. Every `--issue` target exists and is open: `bd show <id>`, **and already has
61
+ children**: `bd list --parent <id>` must return at least one open bead.
62
+ Pre-sprint validation runs BEFORE the planner, so a childless epic aborts
63
+ the run ("No open/in-progress/blocked/deferred beads found for scope ...")
64
+ rather than being decomposed. The planner refines an existing DAG; it does
65
+ not create the first level of it.
66
+ 2. Every `--members` name is registered with the fleet (`list_members` /
67
+ `mcp__apra-fleet__list_members`). An unregistered member aborts the
68
+ sprint unless `--allow-missing-members` is passed.
69
+ 3. Multi-member sprints require all members to share the same git topology
70
+ unless `--sync` is passed. Stick to single-member unless that is
71
+ verified -- see `fleet-sprint-diagram.md` in the package docs.
72
+ 4. If a member's LLM session is stale or unauthenticated (dispatch fails
73
+ with `empty_response`, or "member CLI likely died"), re-run
74
+ `provision_llm_auth` for that member before retrying.
75
+
76
+ ## Launching it
77
+
78
+ Run this on your own orchestrating machine, not on a `--members` target --
79
+ members are dispatch destinations, not where this command runs.
80
+
81
+ Use the delivered `apra-fleet` binary (on PATH after `npm run build:binary`),
82
+ and start it as a genuinely detached OS process. A harness-owned background
83
+ task can be silently killed when its owning tool call's process group ends,
84
+ which orphans the sprint mid-run.
85
+
86
+ Windows:
87
+
88
+ ```powershell
89
+ Start-Process -FilePath "apra-fleet" -ArgumentList "workflow","fleet-sprint", `
90
+ "--issue","<id>","--members","<name>","--branch","<branch>","--base","<base>" `
91
+ -RedirectStandardOutput "<log>.log" -RedirectStandardError "<log>.err.log" `
92
+ -WindowStyle Hidden -PassThru
93
+ ```
94
+
95
+ POSIX:
96
+
97
+ ```bash
98
+ nohup apra-fleet workflow fleet-sprint \
99
+ --issue <id> --members <name> --branch <branch> --base <base> \
100
+ > sprint.log 2>&1 &
101
+ disown
102
+ ```
103
+
104
+ From a source checkout you can run the same engine directly with
105
+ `node packages/apra-fleet-se/bin/cli.mjs <same flags>`. That form runs the
106
+ working tree instead of the installed copy -- use it when developing the
107
+ engine itself, and the packaged binary otherwise.
108
+
109
+ ## Watching it
110
+
111
+ On start, the run prints a dashboard URL (`http://localhost:<viewer-port>`,
112
+ default port 8080). Watch progress there rather than tailing raw stdout --
113
+ the dashboard shows per-role activity, the bead DAG, live cost, and the
114
+ final verdict and PR link.
@@ -0,0 +1,350 @@
1
+ ---
2
+ name: fleet-supervisor
3
+ description: How to start/smoke-test the supervisor process itself, and start, check, and kill fleet-sprints via its HTTP API only (POST /api/sprints on localhost:8787). Never call the fleet-sprint CLI directly. Trigger whenever asked to start/launch/check/stop/kill the supervisor or a sprint.
4
+ ---
5
+
6
+ # fleet-supervisor (supervisor API)
7
+
8
+ Sprints are started, checked, and killed through the supervisor's HTTP API.
9
+ Default port: **8787**. Never invoke `apra-fleet workflow fleet-sprint` or
10
+ `bin/cli.mjs` directly -- always go through this API.
11
+
12
+ ## 0. Start the supervisor (if not already running)
13
+
14
+ Check first: `curl -s -m 5 http://localhost:8787/api/sprints`. Connection
15
+ refused/timeout = not running. `{"sprints": [...]}` = already up, skip this.
16
+
17
+ Start it detached (it runs indefinitely -- exits only on `POST
18
+ /api/shutdown` or SIGINT/SIGTERM, never on its own):
19
+
20
+ ```bash
21
+ node packages/apra-fleet-se/bin/serve.mjs # background/detached, from repo root
22
+ ```
23
+
24
+ `--port <n>` overrides the default (8787). Self-logs to
25
+ `<dataDir>/logs/supervisor.log` in addition to stdout.
26
+
27
+ Smoke test (a few seconds after launch -- give it time to bind):
28
+ ```bash
29
+ curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
30
+ curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
31
+ ```
32
+ Both must succeed before treating the supervisor as up -- a bound port with
33
+ a 500 on `/api/members` still means something is broken.
34
+
35
+ ## Stop the supervisor
36
+
37
+ Two paths: **graceful** (preferred -- lets in-flight requests finish and every
38
+ seam tear down cleanly) and **hard-stop** (only when the API itself is
39
+ unresponsive, e.g. a hung event loop). Resolve commands per the target
40
+ member's own OS (`agent.os`) -- do not assume the orchestrator's shell; some
41
+ members run PowerShell, not POSIX.
42
+
43
+ ### Graceful (preferred)
44
+
45
+ ```bash
46
+ curl -s -X POST http://localhost:8787/api/shutdown
47
+ ```
48
+ Returns `{"status":"shutting-down"}` immediately; the process then finishes
49
+ tearing down every seam (ledger, watchdog, dashboard, etc) and exits on its
50
+ own a moment later. Confirm it is actually gone:
51
+ ```bash
52
+ curl -s -m 5 http://localhost:8787/api/sprints # expect connection refused
53
+ ```
54
+ If that still connects after a few seconds, fall through to hard-stop below.
55
+
56
+ ### Find the supervisor's PID/port (when the API is unresponsive)
57
+
58
+ `GET /api/health` normally reports the running `pid` directly (`curl -s -m 5
59
+ http://localhost:8787/api/health`), but if the API itself is unresponsive
60
+ that call will hang or refuse -- fall back to an OS-level lookup by port
61
+ (default **8787**) or process name (`serve.mjs`):
62
+
63
+ **macOS / Linux:**
64
+ ```bash
65
+ lsof -i :8787 # shows the PID (COMMAND, PID columns) bound to the port
66
+ lsof -ti:8787 # PID only, convenient for command substitution
67
+ # or, by process name if the port lookup finds nothing (already unbound but
68
+ # the process is still alive/hung):
69
+ pgrep -f 'bin/serve.mjs'
70
+ ```
71
+
72
+ **Windows (PowerShell):**
73
+ ```powershell
74
+ Get-NetTCPConnection -LocalPort 8787 | Select-Object OwningProcess
75
+ Get-Process -Id <pid> # confirm it is the supervisor before killing it
76
+ # or, by process name:
77
+ Get-Process | Where-Object { $_.Path -like '*serve.mjs*' -or $_.CommandLine -like '*serve.mjs*' }
78
+ ```
79
+
80
+ **Windows (cmd.exe, if PowerShell is unavailable):**
81
+ ```cmd
82
+ netstat -ano | findstr :8787
83
+ tasklist /FI "PID eq <pid>"
84
+ ```
85
+
86
+ ### Hard-stop (PID-based kill)
87
+
88
+ Only once you have confirmed the PID above is actually the supervisor
89
+ process. Try a graceful signal first, then force:
90
+
91
+ **macOS / Linux:**
92
+ ```bash
93
+ kill <pid> # SIGTERM -- gives it a chance to exit cleanly
94
+ sleep 2
95
+ kill -0 <pid> 2>/dev/null && kill -9 <pid> # still alive? force it
96
+ ```
97
+
98
+ **Windows (PowerShell):**
99
+ ```powershell
100
+ Stop-Process -Id <pid> # graceful-ish first attempt
101
+ Stop-Process -Id <pid> -Force # still running? force-kill
102
+ ```
103
+
104
+ **Windows (cmd.exe):**
105
+ ```cmd
106
+ taskkill /PID <pid>
107
+ taskkill /PID <pid> /F
108
+ ```
109
+
110
+ After either path, verify the port is free before restarting:
111
+ `curl -s -m 5 http://localhost:8787/api/sprints` must refuse the connection
112
+ (macOS/Linux), or the port-lookup command above must return nothing
113
+ (Windows).
114
+
115
+ ## Restart the supervisor
116
+
117
+ A discrete stop-then-start procedure -- use this instead of assuming a bare
118
+ restart command exists:
119
+
120
+ 1. **Stop** it: graceful shutdown above; if that does not actually stop it
121
+ (still answering after a few seconds), fall back to the hard-stop path
122
+ above.
123
+ 2. **Confirm it is down**: `curl -s -m 5 http://localhost:8787/api/sprints`
124
+ must refuse the connection (or the per-OS port lookup above returns
125
+ nothing).
126
+ 3. **Start** it again: see section 0 ("Start the supervisor") above, then
127
+ run its smoke test (`GET /api/sprints`, `GET /api/members`) to confirm the
128
+ new process is actually serving before treating the restart as done.
129
+
130
+ ## Auto-start on login/boot
131
+
132
+ Instead of a human running `node bin/serve.mjs` by hand each session, the
133
+ supervisor can be registered with the OS to start automatically on
134
+ login/boot. Resolve commands per the target member's own OS (`agent.os`) --
135
+ do not assume the orchestrator's shell; some members run PowerShell, not
136
+ POSIX. Every example below assumes the repo root is
137
+ `/path/to/apra-fleet` (POSIX) or `C:\path\to\apra-fleet` (Windows) --
138
+ substitute the real path on the target member. After registering (any OS),
139
+ run the same-process smoke test from section 0 above (`GET /api/sprints`,
140
+ `GET /api/members`) against the newly auto-started instance to confirm it is
141
+ actually serving, not just that the OS accepted the registration.
142
+
143
+ ### Windows
144
+
145
+ **Option A -- Task Scheduler, "At log on" trigger** (simplest; runs in the
146
+ user's own session):
147
+
148
+ Register:
149
+ ```cmd
150
+ schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\path\to\apra-fleet\packages\apra-fleet-se\bin\serve.mjs" /SC ONLOGON /RL LIMITED
151
+ ```
152
+ De-register:
153
+ ```cmd
154
+ schtasks /Delete /TN "ApraFleetSupervisor" /F
155
+ ```
156
+ Confirm it registered:
157
+ ```cmd
158
+ schtasks /Query /TN "ApraFleetSupervisor"
159
+ ```
160
+
161
+ **Option B -- a Windows service via NSSM** (runs even with nobody logged
162
+ in; requires NSSM installed and on PATH):
163
+
164
+ Register:
165
+ ```cmd
166
+ nssm install ApraFleetSupervisor node "C:\path\to\apra-fleet\packages\apra-fleet-se\bin\serve.mjs"
167
+ nssm set ApraFleetSupervisor AppDirectory "C:\path\to\apra-fleet"
168
+ nssm start ApraFleetSupervisor
169
+ ```
170
+ De-register:
171
+ ```cmd
172
+ nssm stop ApraFleetSupervisor
173
+ nssm remove ApraFleetSupervisor confirm
174
+ ```
175
+
176
+ ### macOS (launchd user LaunchAgent)
177
+
178
+ Create `~/Library/LaunchAgents/com.apra-fleet.supervisor.plist`:
179
+ ```xml
180
+ <?xml version="1.0" encoding="UTF-8"?>
181
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
182
+ "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
183
+ <plist version="1.0">
184
+ <dict>
185
+ <key>Label</key>
186
+ <string>com.apra-fleet.supervisor</string>
187
+ <key>ProgramArguments</key>
188
+ <array>
189
+ <string>/usr/local/bin/node</string>
190
+ <string>/path/to/apra-fleet/packages/apra-fleet-se/bin/serve.mjs</string>
191
+ </array>
192
+ <key>RunAtLoad</key>
193
+ <true/>
194
+ <key>KeepAlive</key>
195
+ <false/>
196
+ <key>StandardOutPath</key>
197
+ <string>/tmp/apra-fleet-supervisor.log</string>
198
+ <key>StandardErrorPath</key>
199
+ <string>/tmp/apra-fleet-supervisor.log</string>
200
+ </dict>
201
+ </plist>
202
+ ```
203
+ `RunAtLoad` starts it at login; `KeepAlive` is deliberately `false` -- the
204
+ supervisor already runs indefinitely on its own (see section 0), so it does
205
+ not need launchd to respawn it on exit (an explicit `POST /api/shutdown`
206
+ should stay stopped, not bounce back up). launchd runs with a minimal PATH
207
+ (`/usr/bin:/bin:/usr/sbin:/sbin`), so a bare `node` command will not resolve
208
+ if node is installed via Homebrew or a version manager. Use the real path to
209
+ `node` on your system (`which node`) if it differs from `/usr/local/bin/node`.
210
+
211
+ Register (load) and start now:
212
+ ```bash
213
+ launchctl load ~/Library/LaunchAgents/com.apra-fleet.supervisor.plist
214
+ launchctl start com.apra-fleet.supervisor
215
+ ```
216
+ De-register (stop and unload, so it no longer starts at login):
217
+ ```bash
218
+ launchctl stop com.apra-fleet.supervisor
219
+ launchctl unload ~/Library/LaunchAgents/com.apra-fleet.supervisor.plist
220
+ ```
221
+
222
+ ### Linux (systemd --user unit)
223
+
224
+ Create `~/.config/systemd/user/apra-fleet-supervisor.service`:
225
+ ```ini
226
+ [Unit]
227
+ Description=Apra Fleet supervisor
228
+
229
+ [Service]
230
+ ExecStart=/usr/bin/node /path/to/apra-fleet/packages/apra-fleet-se/bin/serve.mjs
231
+ Restart=no
232
+ WorkingDirectory=/path/to/apra-fleet
233
+
234
+ [Install]
235
+ WantedBy=default.target
236
+ ```
237
+ `Restart=no` matches the launchd `KeepAlive=false` choice above: the
238
+ supervisor is already self-persistent (section 0), and an explicit `POST
239
+ /api/shutdown` should stay stopped rather than being auto-respawned by the
240
+ unit. Use the real path to `node` on the target member (`which node`) if it
241
+ differs from `/usr/bin/node`.
242
+
243
+ Register and start:
244
+ ```bash
245
+ systemctl --user daemon-reload
246
+ systemctl --user enable apra-fleet-supervisor.service
247
+ systemctl --user start apra-fleet-supervisor.service
248
+ ```
249
+ De-register (stop and disable, so it no longer starts at login/boot):
250
+ ```bash
251
+ systemctl --user stop apra-fleet-supervisor.service
252
+ systemctl --user disable apra-fleet-supervisor.service
253
+ ```
254
+ A user unit only starts at login unless lingering is enabled for boot-time
255
+ start with no login (`loginctl enable-linger <username>`).
256
+
257
+ ## 1. Before you launch a sprint
258
+
259
+ 1. If you just created/edited beads locally, push them first:
260
+ `bd dolt commit` then `bd dolt push`. Members pull their own copy; a
261
+ sprint launched before the push works from stale scope.
262
+ 2. Check no conflicting sprint is already running: `GET /api/sprints`.
263
+ 3. Multi-member sprints need all members on the SAME git HEAD, or the
264
+ launch crashes immediately with a topology error. If unsure, use ONE
265
+ member. Don't guess a member list -- ask, or default to one.
266
+
267
+ ## 2. Start a sprint
268
+
269
+ ```bash
270
+ curl -s -X POST http://localhost:8787/api/sprints \
271
+ -H "Content-Type: application/json" \
272
+ -d '{
273
+ "issue": "<id[,id2,...]>",
274
+ "branch": "<new-or-existing-branch>",
275
+ "base": "<base-branch>",
276
+ "members": ["<member-name>"],
277
+ "goal": "P1/P2"
278
+ }'
279
+ ```
280
+
281
+ Field names, exactly as the API expects them:
282
+
283
+ | Field | Required | Notes |
284
+ |---|---|---|
285
+ | `issue` | yes | comma-separated bead root IDs (parent/epic OR a standalone leaf bead). Alias: `target_issue`. |
286
+ | `branch` | yes | created from `base` if it doesn't exist yet. |
287
+ | `base` | yes | alias: `base_branch`. This is what the sprint branches FROM -- pass the branch you actually want, not always `main`. |
288
+ | `members` | yes | array of registered member names. One member = safest default. |
289
+ | `goal` | no | `P1`, `P1/P2` (default), or `P1/P2/P3`. |
290
+ | `maxCycles` | no | default 5. |
291
+ | `allowMissingMembers` | no | bool. |
292
+ | `requirementsFile` | no | path. |
293
+ | `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. |
294
+ | `budget` | no | USD cap. |
295
+ | `overrideRelaunchGate` | no | bool. See below. |
296
+
297
+ Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath`.
298
+ **A 201 response does NOT mean the sprint is alive** -- it can crash in the
299
+ first few seconds (bad topology, bad member, etc). Always verify (step 3)
300
+ a few seconds after launch.
301
+
302
+ ## 3. Check status
303
+
304
+ All live sprints:
305
+ ```bash
306
+ curl -s http://localhost:8787/api/sprints
307
+ ```
308
+ Empty `sprints: []` after a launch = it already died. Check its `logPath`.
309
+
310
+ One sprint (live state, or its terminal record if it finished/crashed):
311
+ ```bash
312
+ curl -s http://localhost:8787/api/sprints/<sprintId>
313
+ ```
314
+
315
+ Sprint-scoped dashboard (per-role activity, bead DAG, cost, PR link):
316
+ `http://localhost:<port>` (the `port` from the launch response).
317
+
318
+ ## 4. Kill a sprint
319
+
320
+ ```bash
321
+ curl -s -X POST http://localhost:8787/api/sprints/<sprintId>/stop
322
+ ```
323
+
324
+ ## Relaunch gate
325
+
326
+ If a prior run of the SAME issue root ended in a deterministic, unaddressed
327
+ failure (crash, sync conflict, etc), a relaunch is refused with a 409. Once
328
+ you understand and have actually fixed the cause, retry with
329
+ `"overrideRelaunchGate": true` in the body. This is not a silent bypass --
330
+ only use it once you know why the prior run died.
331
+
332
+ ## Common launch-time crashes
333
+
334
+ - **Topology mismatch**: members are on different git commits. Fix: use one
335
+ member, or align them first (`git fetch && git checkout <branch>` on
336
+ each), or pass whatever sync option the engine currently exposes -- check
337
+ `docs/architecture.md` "Multi-member topology" section, don't guess.
338
+ - **Unregistered member**: `GET /api/members` to see valid names.
339
+ - **Stale LLM auth**: dispatch fails with `empty_response`. Re-run
340
+ `provision_llm_auth` for that member.
341
+
342
+ ## Member layout: isolate deploy/test roles from dev roles
343
+
344
+ For projects where the deployed software runs and is verified LOCALLY on the
345
+ member, give `deployer`, `integ-test-runner`, and `regression-test-runner` a
346
+ dedicated member with its own independent git clone (not a worktree),
347
+ separate from `planner`/`plan-reviewer`/`doer`/`reviewer`, via `roleMap`:
348
+ `{"deployer": ["<deploy-member>"], "integ-test-runner": ["<deploy-member>"],
349
+ "regression-test-runner": ["<deploy-member>"], "doer": ["<dev-member>"], ...}`.
350
+ Dev roles can all safely share one generic member.
@@ -0,0 +1,140 @@
1
+ // apra-fleet-eft.75.2 -- a machine-local pidfile mutex keyed on
2
+ // (branch, members), guarding against a duplicate concurrent `fleet-sprint`
3
+ // engine launch for the SAME sprint.
4
+ //
5
+ // Root incident (apra-fleet-eft.75): a duplicate concurrent runner.js engine
6
+ // dispatched against the same shared git branch/beads DB while the first was
7
+ // still alive (both alive 50+ minutes, a duplicate smoke-test sprint
8
+ // launched by the orphaned first session was itself duplicated by the
9
+ // second). The ONLY thing that had stopped a duplicate concurrent runner
10
+ // before this was an ACCIDENTAL viewer-port-8080 collision -- itself
11
+ // trivially avoided by passing a different --viewer-port, so it was never a
12
+ // real guard. This module is the explicit, always-on mutex that replaces
13
+ // that accident with a deliberate, named lock.
14
+ //
15
+ // One pidfile per (branch, sorted-members) combination lives under
16
+ // `lockDir` (default: a fixed subdirectory of the OS tmpdir; override via
17
+ // APRA_FLEET_SPRINT_LOCK_DIR for test isolation / a non-default host
18
+ // layout). Its content is just the acquiring process's pid as plain text.
19
+ // A conflicting acquire attempt:
20
+ // - if the recorded pid is verifiably alive: refuses with the distinct,
21
+ // named SprintLockHeldError (never falls through to a generic error a
22
+ // caller could accidentally swallow/retry).
23
+ // - if the recorded pid is dead (crashed process that never released
24
+ // cleanly), or the pidfile is unreadable/corrupt: reclaims the stale
25
+ // pidfile and proceeds, exactly once per acquire() call, without a
26
+ // false block.
27
+
28
+ import fs from 'node:fs';
29
+ import path from 'node:path';
30
+ import os from 'node:os';
31
+ import { SprintLockHeldError } from './errors.mjs';
32
+
33
+ export { SprintLockHeldError };
34
+
35
+ function defaultLockDir() {
36
+ return process.env.APRA_FLEET_SPRINT_LOCK_DIR
37
+ || path.join(os.tmpdir(), 'apra-fleet-sprint-locks');
38
+ }
39
+
40
+ /**
41
+ * Filename-safe key for a (branch, members) pair -- deterministic
42
+ * regardless of `members` input ORDER or duplicate entries, so the SAME
43
+ * sprint (same branch, same member set) always maps to the SAME lock file
44
+ * no matter which order/repetition --members were listed in on either
45
+ * launch.
46
+ * @param {string} branch
47
+ * @param {string[]} members
48
+ * @returns {string}
49
+ */
50
+ export function sprintLockKey(branch, members) {
51
+ const memberPart = Array.from(new Set((members || []).map(String))).sort().join('+');
52
+ const raw = `${branch}::${memberPart}`;
53
+ return raw.replace(/[^a-zA-Z0-9._+-]/g, '_');
54
+ }
55
+
56
+ /**
57
+ * True when `pid` is a currently-running process on this machine. Mirrors
58
+ * the fleet server's own isPidAlive (src/utils/pid-helpers.ts) but is
59
+ * reimplemented locally -- this package never imports server TS source
60
+ * directly. EPERM (process exists, owned by a different user) is treated as
61
+ * alive: we could signal it but that does not mean it is dead.
62
+ * @param {number} pid
63
+ * @returns {boolean}
64
+ */
65
+ function isPidAlive(pid) {
66
+ if (typeof pid !== 'number' || !Number.isInteger(pid) || pid <= 0) return false;
67
+ try {
68
+ process.kill(pid, 0);
69
+ return true;
70
+ } catch (err) {
71
+ return err && err.code === 'EPERM';
72
+ }
73
+ }
74
+
75
+ /**
76
+ * Acquire the sprint lock for (branch, members). Synchronous (pidfile
77
+ * open/write/read are all cheap local-disk ops and every existing call site
78
+ * in this package -- sprint launch, once, before any dispatch -- has no need
79
+ * to await anything else concurrently).
80
+ *
81
+ * @param {{ branch: string, members: string[], lockDir?: string, pid?: number }} opts
82
+ * @returns {{ path: string, release: () => void }}
83
+ * @throws {SprintLockHeldError} when a live process already holds the lock
84
+ * for this exact (branch, members) key, or a concurrent process wins the
85
+ * reclaim race.
86
+ */
87
+ export function acquireSprintLock({ branch, members, lockDir = defaultLockDir(), pid = process.pid }) {
88
+ fs.mkdirSync(lockDir, { recursive: true });
89
+ const key = sprintLockKey(branch, members);
90
+ const lockPath = path.join(lockDir, `${key}.lock`);
91
+
92
+ function tryAcquire(allowReclaim) {
93
+ try {
94
+ const fd = fs.openSync(lockPath, 'wx');
95
+ fs.writeSync(fd, String(pid));
96
+ fs.closeSync(fd);
97
+ return {
98
+ path: lockPath,
99
+ release: () => { try { fs.unlinkSync(lockPath); } catch { /* already gone -- fine */ } },
100
+ };
101
+ } catch (err) {
102
+ if (!err || err.code !== 'EEXIST') throw err;
103
+
104
+ let existingPid = null;
105
+ try {
106
+ existingPid = parseInt(fs.readFileSync(lockPath, 'utf8').trim(), 10);
107
+ } catch {
108
+ // File vanished (or became unreadable) between our openSync
109
+ // failing and this read -- treat as reclaimable below.
110
+ }
111
+
112
+ if (Number.isInteger(existingPid) && isPidAlive(existingPid)) {
113
+ throw new SprintLockHeldError(
114
+ `[Sprint Lock] Sprint branch "${branch}" (members: ${(members || []).join(', ')}) is already ` +
115
+ `running under pid ${existingPid}. Refusing to start a second concurrent engine against the ` +
116
+ `same sprint -- wait for it to finish, or stop it first.`,
117
+ { branch, members, existingPid },
118
+ );
119
+ }
120
+
121
+ if (!allowReclaim) {
122
+ // We already reclaimed once in this call and STILL hit
123
+ // EEXIST -- a concurrent acquire won the race between our
124
+ // unlink and this retry.
125
+ throw new SprintLockHeldError(
126
+ `[Sprint Lock] Sprint branch "${branch}" (members: ${(members || []).join(', ')}) lock could ` +
127
+ `not be acquired -- a concurrent process claimed it during stale-pidfile reclaim.`,
128
+ { branch, members },
129
+ );
130
+ }
131
+
132
+ // Stale pidfile (dead pid, or unreadable/corrupt content) --
133
+ // reclaim it and retry exactly once, never a false block.
134
+ try { fs.unlinkSync(lockPath); } catch { /* already gone -- fine */ }
135
+ return tryAcquire(false);
136
+ }
137
+ }
138
+
139
+ return tryAcquire(true);
140
+ }