@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,177 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+
4
+ // =============================================================================
5
+ // apra-fleet-eft.3.3 -- dispatch-safety guard checker, extracted so it is
6
+ // exported/parameterizable by path.
7
+ //
8
+ // This module holds the bracket-aware `command(`/`agent(` call-site parser
9
+ // originally written inline in dispatch-safety-guard.test.mjs
10
+ // (apra-fleet-eft.3.1). It is factored out here so the checker can be
11
+ // pointed at an arbitrary source file -- in particular a test fixture that
12
+ // deliberately violates the invariant -- WITHOUT mutating
13
+ // packages/apra-fleet-se/fleet-sprint/runner.js itself to manufacture a
14
+ // failure case. dispatch-safety-guard.test.mjs imports this module both for
15
+ // its real runner.js baseline assertion and for fixture-driven tests that
16
+ // prove the checker actually detects a violation rather than passing
17
+ // vacuously.
18
+ //
19
+ // Invariant under test (unchanged from eft.3.1): EVERY `command(` / `agent(`
20
+ // call site in a scanned source file must supply an explicit `member_name`
21
+ // (or `member_id`) in its options object.
22
+ // =============================================================================
23
+
24
+ /**
25
+ * Returns true if `col` (0-based index into `lineText`) sits inside an open
26
+ * `"..."` or `'...'` string that started earlier on the SAME line -- i.e. an
27
+ * odd number of unescaped quote characters of the currently-open type
28
+ * precede it. Deliberately scoped to a single line (not a whole-file quote
29
+ * scan): a whole-file scan misfires on stray apostrophes in prose comments
30
+ * (e.g. "doesn't", "it's"), which would otherwise be misread as opening a
31
+ * string and swallow everything up to the next quote -- including real
32
+ * command()/agent() call sites many lines later. Backticks are deliberately
33
+ * NOT tracked here: template literals legitimately span multiple lines (git
34
+ * command strings) and are not a source of the false positive this guards
35
+ * against (a real call site's own leading backtick is never itself inside a
36
+ * string).
37
+ */
38
+ export function isInsideSameLineString(lineText, col) {
39
+ let quote = null;
40
+ for (let i = 0; i < col; i++) {
41
+ const ch = lineText[i];
42
+ if (ch === '\\') { i++; continue; }
43
+ if (quote) {
44
+ if (ch === quote) quote = null;
45
+ } else if (ch === '"' || ch === "'") {
46
+ quote = ch;
47
+ }
48
+ }
49
+ return quote !== null;
50
+ }
51
+
52
+ /** Returns the index of the closing quote char matching the one at `start`. */
53
+ export function skipStringLiteral(src, start, quoteChar) {
54
+ let i = start + 1;
55
+ for (; i < src.length; i++) {
56
+ const ch = src[i];
57
+ if (ch === '\\') {
58
+ i++; // skip escaped char
59
+ continue;
60
+ }
61
+ if (ch === quoteChar) return i;
62
+ }
63
+ return i;
64
+ }
65
+
66
+ /**
67
+ * Given the index of an opening '(' in `src`, returns the full call-site
68
+ * text from that '(' through its matching ')', tracking paren depth and
69
+ * skipping over string/template-literal contents (so parens embedded in
70
+ * string/template content, e.g. `bd show ${ids.join(' ')}`, never disturb
71
+ * the depth count).
72
+ */
73
+ export function extractBalancedCall(src, openParenIdx) {
74
+ let depth = 0;
75
+ let i = openParenIdx;
76
+ for (; i < src.length; i++) {
77
+ const ch = src[i];
78
+ if (ch === '(') {
79
+ depth++;
80
+ } else if (ch === ')') {
81
+ depth--;
82
+ if (depth === 0) {
83
+ return src.slice(openParenIdx, i + 1);
84
+ }
85
+ } else if (ch === '"' || ch === "'" || ch === '`') {
86
+ i = skipStringLiteral(src, i, ch);
87
+ }
88
+ }
89
+ // Unbalanced -- should never happen against real, syntactically-valid
90
+ // source; return what we found so the caller's member_name check still
91
+ // has something to inspect rather than throwing mid-scan.
92
+ return src.slice(openParenIdx, i);
93
+ }
94
+
95
+ /**
96
+ * Scans `src` for `command(`/`agent(` call sites, skipping call-site tokens
97
+ * that only appear inside a full-line comment. Returns an array of
98
+ * { fnName, line, callText } for every real call site found.
99
+ */
100
+ export function findCallSites(src) {
101
+ const lines = src.split('\n');
102
+ // Byte offset of the start of each line, so a regex match index into
103
+ // the whole-file string can be mapped back to a 1-based line number.
104
+ const lineStarts = [];
105
+ let offset = 0;
106
+ for (const line of lines) {
107
+ lineStarts.push(offset);
108
+ offset += line.length + 1; // +1 for the '\n' stripped by split()
109
+ }
110
+ function lineNumberForIndex(idx) {
111
+ // Binary search would be overkill for a single source file; linear
112
+ // scan is fine here.
113
+ let ln = 0;
114
+ for (let i = 0; i < lineStarts.length; i++) {
115
+ if (lineStarts[i] > idx) break;
116
+ ln = i;
117
+ }
118
+ return ln + 1; // 1-based
119
+ }
120
+ function isCommentLine(ln) {
121
+ const text = lines[ln - 1] ? lines[ln - 1].trim() : '';
122
+ return text.startsWith('//') || text.startsWith('*') || text.startsWith('/*');
123
+ }
124
+
125
+ // Matches `command(` / `agent(` NOT preceded by a `.` or word character
126
+ // (so e.g. `dispatchCommand(` or `.command(` -- neither of which occurs
127
+ // for the fleet dispatch primitives, but this guards against false
128
+ // positives from unrelated identifiers ending in the same substring).
129
+ const callRe = /(?<![.\w])(command|agent)\(/g;
130
+ const sites = [];
131
+ let m;
132
+ while ((m = callRe.exec(src)) !== null) {
133
+ const fnName = m[1];
134
+ const openParenIdx = m.index + m[0].length - 1; // index of the '(' itself
135
+ const line = lineNumberForIndex(m.index);
136
+ if (isCommentLine(line)) continue;
137
+ // Reject matches where the literal text "command(" / "agent(" sits
138
+ // inside a same-line quoted string (e.g. a `throw new Error("...
139
+ // command() ...")` message) -- not a real dispatch call site.
140
+ const lineText = lines[line - 1] || '';
141
+ const col = m.index - lineStarts[line - 1];
142
+ if (isInsideSameLineString(lineText, col)) continue;
143
+ const callText = extractBalancedCall(src, openParenIdx);
144
+ sites.push({ fnName, line, callText });
145
+ }
146
+ return sites;
147
+ }
148
+
149
+ const MEMBER_RE = /\b(member_name|member_id)\b/;
150
+
151
+ /**
152
+ * Given an array of call sites (as returned by findCallSites), returns the
153
+ * subset lacking an explicit member_name/member_id, each formatted as a
154
+ * human-readable violation string naming `fileLabel` and the offending
155
+ * line -- e.g. "fixture.mjs:4 (command()) is missing member_name/member_id".
156
+ */
157
+ export function findViolations(sites, fileLabel) {
158
+ return sites
159
+ .filter((s) => !MEMBER_RE.test(s.callText))
160
+ .map((s) => `${fileLabel}:${s.line} (${s.fnName}()) is missing member_name/member_id`);
161
+ }
162
+
163
+ /**
164
+ * Reads and scans the source file at `filePath` for command()/agent() call
165
+ * sites, returning { sites, violations }. This is the checker's main
166
+ * path-parameterized entry point: callers -- real runner.js baseline
167
+ * assertions, or fixture-driven tests exercising a deliberately
168
+ * non-compliant call site -- pass whatever file path they want scanned,
169
+ * without needing to mutate runner.js to manufacture a failing case.
170
+ */
171
+ export function checkPath(filePath) {
172
+ const src = fs.readFileSync(filePath, 'utf8');
173
+ const sites = findCallSites(src);
174
+ const fileLabel = path.basename(filePath);
175
+ const violations = findViolations(sites, fileLabel);
176
+ return { sites, violations };
177
+ }
@@ -0,0 +1,191 @@
1
+ # Running fleet-sprint
2
+
3
+ `fleet-sprint` is this package's autonomous sprint engine. It drives a full
4
+ plan -> develop -> review -> deploy -> integ-test -> harvest cycle across one
5
+ or more registered fleet members, working a set of beads issues on a branch
6
+ and opening a PR at the end.
7
+
8
+ This doc covers the two ways to invoke it, the full argument contract, the
9
+ preconditions to check first, and the beads hierarchy rules that determine
10
+ what a sprint actually picks up as its scope.
11
+
12
+ ## Two ways to invoke it
13
+
14
+ Both forms run the exact same engine
15
+ (`packages/apra-fleet-se/fleet-sprint/runner.js`) with the same flags. They
16
+ differ only in how the entry point is resolved.
17
+
18
+ ### 1. Installed binary (normal use)
19
+
20
+ ```bash
21
+ apra-fleet workflow fleet-sprint \
22
+ --issue apra-fleet-eft \
23
+ --members fleet-rev \
24
+ --branch sprint/eft-service-fixes \
25
+ --base main \
26
+ --viewer-port 18300
27
+ ```
28
+
29
+ This is the ONE command for every install method -- git-clone dev checkout,
30
+ `npm install -g @apralabs/apra-fleet`, and the pre-built standalone binary
31
+ all resolve it identically; there is no separate npm-only invocation to
32
+ learn. The launcher resolves the workflow from
33
+ `~/.apra-fleet/workflows/fleet-sprint` (installed by `apra-fleet install`,
34
+ self-healed on demand). Everything after the workflow name is passed
35
+ through verbatim, so `apra-fleet workflow fleet-sprint --help` prints the
36
+ engine's own help.
37
+
38
+ ### 2. Directly from a source checkout (development only)
39
+
40
+ ```bash
41
+ node packages/apra-fleet-se/bin/cli.mjs \
42
+ --issue apra-fleet-eft \
43
+ --members fleet-rev \
44
+ --branch sprint/eft-service-fixes \
45
+ --base main \
46
+ --viewer-port 18300
47
+ ```
48
+
49
+ A development-only shortcut for when you are actively changing the engine
50
+ itself and want to run the working tree directly rather than the installed
51
+ copy. Not needed, and not documented as a supported path, for any other use
52
+ -- use mode 1 above.
53
+
54
+ ### Backgrounding
55
+
56
+ A sprint is a long-running process. Start it genuinely detached, not as a
57
+ child of a short-lived tool call whose process group can be killed out from
58
+ under it:
59
+
60
+ ```bash
61
+ # POSIX
62
+ nohup apra-fleet workflow fleet-sprint --issue <id> --members <m> \
63
+ --branch <branch> --base <base> > sprint.log 2>&1 &
64
+ disown
65
+ ```
66
+
67
+ ```powershell
68
+ # Windows
69
+ Start-Process -FilePath "apra-fleet" -ArgumentList "workflow","fleet-sprint", `
70
+ "--issue","<id>","--members","<m>","--branch","<branch>","--base","<base>" `
71
+ -RedirectStandardOutput "sprint.log" -RedirectStandardError "sprint.err.log" `
72
+ -WindowStyle Hidden -PassThru
73
+ ```
74
+
75
+ On start it prints the dashboard URL (`http://localhost:<viewer-port>`).
76
+ Watch progress there rather than tailing raw stdout.
77
+
78
+ ## Arguments
79
+
80
+ | Flag | Short | Required | Default | Description |
81
+ |---|---|---|---|---|
82
+ | `--issue <ids>` | `-i` | yes | -- | Target issue ID(s), comma separated (e.g. `epic-1,epic-2`). Scope resolves via `bd list --parent <id>` -- see the epics section below. |
83
+ | `--members <ids>` | `-m` | yes | -- | Member IDs/names to use, comma separated. Members act as repo targets for parallelism. |
84
+ | `--branch <name>` | `-b` | yes | -- | Sprint branch to develop on. Created from `--base` if it does not exist; reused as-is if it does. |
85
+ | `--base <name>` | `-B` | yes | -- | Base branch the sprint branch is created from, and the branch the eventual PR targets. |
86
+ | `--goal <goal>` | `-g` | no | `P1/P2` | Sprint goal constraint. One of `P1`, `P1/P2`, `P1/P2/P3`. |
87
+ | `--max-cycles <n>` | `-c` | no | `5` | Max plan/develop/review cycles. |
88
+ | `--allow-missing-members` | | no | off | Warn and continue if some `--members` are not registered with the fleet. Without it, any missing member aborts the sprint. |
89
+ | `--requirements-file <path>` | | no | -- | Path to a requirements file threaded into the planner's prompt. |
90
+ | `--role-map <json\|@file>` | | no | -- | JSON object mapping role -> member[], e.g. `'{"doer":["m1","m2"]}'`. Inline JSON or `@path/to/file.json`. |
91
+ | `--viewer-port <port>` | | no | `8080` | Port for the local dashboard viewer. |
92
+ | `--budget <usd>` | | no | unlimited | USD ceiling for this run's total estimated spend. |
93
+ | `--dispatch-timeout-s <s>` | | no | `9000` | Per-dispatch time budget in seconds, applied as both the inactivity timeout and the hard ceiling on every agent dispatch (integ-test dispatch ceiling is 2x, regression-test ceiling is 3x). Minimum 60. Lower it for small sprints so a hung dispatch costs minutes, not 2.5 hours. |
94
+ | `--sync` | | no | off | Synced topology mode (orchestrator-bracketed git sync): members may sit on differing HEADs but must share the same origin URL and pass a `bd dolt pull` probe. Omitted uses shared-workspace mode (all members on the same HEAD). |
95
+ | `--help` | `-h` | | | Show the engine's help. |
96
+
97
+ Unrecognized flags fail loudly rather than being silently ignored, so a typo
98
+ like `--max-cycle` aborts instead of quietly applying the default.
99
+
100
+ ## Preconditions worth checking first
101
+
102
+ - The target issue (e.g. `apra-fleet-7pm`) must exist and be open:
103
+ `bd show <issue>`.
104
+ - Every `--members` name must be registered with the fleet
105
+ (`list_members`); an unregistered member aborts the sprint unless
106
+ `--allow-missing-members` is passed.
107
+ - Multi-member sprints require all configured members to share the same
108
+ git HEAD (`checkMemberTopology`) unless `--sync` is passed -- see
109
+ `fleet-sprint-diagram.md` for the supported-topology notes. Stick to
110
+ single-member unless that is verified.
111
+ - If a member's LLM session is stale or unauthenticated (dispatch fails with
112
+ `empty_response`, or "member CLI likely died"), re-run `provision_llm_auth`
113
+ for that member before retrying.
114
+
115
+ ## How to make one bead represent a whole set (epics / manifest beads)
116
+
117
+ If you want a single bead to stand in for a group of other beads (an epic,
118
+ a "next sprint scope" manifest, etc.), the group members MUST be linked as
119
+ **parent-child**, not as **blocked-by**:
120
+
121
+ - Add each item as a child of the umbrella bead:
122
+ `bd create ... --parent <umbrella-id>` (new beads), or
123
+ `bd update <id> --parent <umbrella-id>` (existing beads).
124
+ - The umbrella bead itself must have **zero** blocking dependencies of its
125
+ own -- do not also add `blocks` edges from the umbrella bead to its own
126
+ children. It should only ever be the *target* of parent-child edges
127
+ (children point at it), never the source of a `blocks` edge pointing at
128
+ them.
129
+ - "All done" tracking (closing the umbrella bead once every child is
130
+ closed) is a manual/observational step based on child status
131
+ (`dependent_count`), not something enforced by a `blocks` edge.
132
+
133
+ Why this matters: `bd`'s ready-work engine treats a `blocks` edge as a real
134
+ blocker. If the umbrella bead both (a) is `blocked-by` its children (so it
135
+ can't close until they do) AND (b) is their `parent` (so they belong to it),
136
+ that is a 2-node cycle on every pair -- and `bd` marks every bead caught in
137
+ a cycle as **not ready**, deadlocking the umbrella bead and all of its
138
+ children simultaneously. This is exactly what "blocked-by" gets you wrong
139
+ and "parent-child" gets right: a successful epic (e.g. `apra-fleet-7pm`)
140
+ has `dependency_count: 0` (it depends on / is blocked by nothing) and a
141
+ nonzero `dependent_count` (its children point at it). A broken manifest
142
+ bead that used `blocks` instead had `dependency_count: 5` and, once
143
+ children were also parented under it, deadlocked completely.
144
+
145
+ This also matters for launching a sprint: `fleet-sprint`'s `--issue <id>`
146
+ flag resolves the sprint's scope via `bd list --parent <id>` internally --
147
+ it only ever understands the `parent-child` hierarchy. A `blocked-by`-only
148
+ manifest bead is invisible to fleet-sprint's scope filter no matter what you
149
+ pass to `--issue`; only true children are picked up.
150
+
151
+ ## Recovering a wedged member reservation (launched via the supervisor)
152
+
153
+ If a sprint was launched through the supervisor (`fleet-se serve`, `POST
154
+ /api/sprints`) and its child process crashes or is killed, the supervisor's
155
+ reservation ledger does **not** release that sprint's claim on its own during
156
+ normal runtime -- only a supervisor restart, or an explicit operator call,
157
+ clears it. Symptom: relaunching against the same member(s) is rejected with
158
+
159
+ ```
160
+ 409 member overlap rejects launch: sprint '<old-sprint-id>' already claims [<member>]
161
+ ```
162
+
163
+ and `POST /api/sprints/:id/stop` against that same old sprint id also fails
164
+ (`409 ... no reachable child (port unknown)`) because the child is already
165
+ dead -- there is nothing left to proxy a stop to.
166
+
167
+ Clear it directly, with no supervisor restart required:
168
+
169
+ ```bash
170
+ curl -X POST http://localhost:8787/api/reservations/<old-sprint-id>/force-release \
171
+ -H "Content-Type: application/json" \
172
+ -d '{"by": "<your name/reason>", "reason": "sprint child crashed, pid confirmed dead"}'
173
+ ```
174
+
175
+ This releases both of the supervisor ledger's axes (member set + issue-scope
176
+ root) for that sprint id in one call and records an auditable
177
+ `force-released` event in the supervisor's event history. It does **not**
178
+ restart anything and does not affect any other live sprint.
179
+
180
+ This is a *different* mechanism from the fleet server's own per-member
181
+ `reservedBy` field (enforced at dispatch time, independent of the
182
+ supervisor). If a relaunch still 409s after force-releasing the ledger side,
183
+ also clear that axis:
184
+
185
+ ```
186
+ mcp__apra-fleet__member_reservation action: "force_release" member_name: "<member>"
187
+ ```
188
+
189
+ A crashed sprint can leave either axis wedged independently of the other --
190
+ check both. See `packages/apra-fleet-se/docs/architecture.md` ("Supervisor:
191
+ process model" / "Manual force-release") for the full mechanism.
@@ -0,0 +1,23 @@
1
+ # Coach Role (superseded -- see escalate-to-llm-design.md)
2
+
3
+ Status: SUPERSEDED 2026-08-10 by the sprint-doctor design in
4
+ [`escalate-to-llm-design.md`](escalate-to-llm-design.md). Kept as a pointer so
5
+ links and history resolve; the full original text is in git history
6
+ (this file, prior to this commit).
7
+
8
+ The coach idea (2026-07-20): an in-workflow LLM role for error classes the
9
+ deterministic engine did not foresee -- invoked strictly after typed
10
+ handlers/ladders, single-shot, capped per error class, filing a sanitized
11
+ bug report for every intervention, failing loudly when it cannot fix.
12
+
13
+ sprint-doctor is that idea carried forward under a new name, with a stricter
14
+ decision/action split (zero-tool consult; the runner executes a bounded
15
+ action enum), an explicit environment-vs-engine-vs-task-shape triage, a
16
+ data-driven symptom/remedy registry, stagnation triggers on top of coach's
17
+ red-state events, and a generic engine-level pause/resume for human
18
+ hand-off. Every load-bearing coach idea was folded in and is credited
19
+ inline in the doctor doc: the three-layer error-handling hierarchy and
20
+ red-state taxonomy (its section 1), same-class-twice fingerprint cap,
21
+ no-recursion, interventions-as-review-evidence and deterministic test
22
+ stubbing (section 6), rescue-WIP-to-branch salvage (section 2.5), and the
23
+ consent-gated sanitized telemetry flow (section 4.4).
@@ -0,0 +1,256 @@
1
+ # Dolt manual recovery runbook (verified 2026-08-12, all steps live-tested on fleet-win-dev1)
2
+
3
+ This is the ground-truth procedure for standing up an ephemeral `dolt sql-server`
4
+ against a wedged embedded Dolt clone, querying/repairing it, and tearing it back
5
+ down -- verified end to end against a real clone on a real member, not written
6
+ from docs.
7
+
8
+ STATUS: this procedure is now AUTOMATED end to end by `settleDoltConflicts()`
9
+ (`packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs`), which is the
10
+ executable form of this document and runs at both sync divergence terminals --
11
+ fleet members self-heal without a human or an LLM. The old Path A / Path B /
12
+ Tier 2 ladder and its LLM runbook (`dolt-tier2-runbook.md`) were retired and
13
+ deleted; see `dolt-sync-redesign.md`.
14
+
15
+ This document remains the SPECIFICATION that code encodes, and the human
16
+ copy-paste fallback for driving a clone by hand. Every step here was
17
+ independently rediscovered by trial and error at least once already (see
18
+ apra-fleet-ga61, apra-fleet-5mqg) -- which is exactly why it is written down
19
+ and encoded once.
20
+
21
+ ## 0. Precondition: find the REAL data directory. Never hardcode it.
22
+
23
+ ```
24
+ bd dolt status
25
+ ```
26
+
27
+ Read the `Data:` line from the output (also mirrored in `.beads/metadata.json`'s
28
+ `dolt_mode` field). This is bd's own live, authoritative answer for THIS clone,
29
+ right now. Do not assume `.beads/embeddeddolt` -- that happens to be bd's
30
+ convention today, but a script that hardcodes it and finds a second/different
31
+ directory should treat that as orphaned residue from a prior failed recovery
32
+ (see apra-fleet-5mqg) and refuse to proceed blind, not silently pick one.
33
+
34
+ If `bd dolt status` reports `embedded (in-process, no server)`, there is no
35
+ live server to route through -- an ephemeral one must be started (step 2). If
36
+ it already reports a live server (host:port), skip straight to step 3 and
37
+ target that existing server/port instead of starting a second one.
38
+
39
+ ## 1. Ensure the PINNED `dolt` binary is present (never a package manager)
40
+
41
+ The embedded `bd` binary does NOT ship enough of the Dolt CLI to drive a
42
+ merge-conflict resolution over SQL -- that requires the real `dolt` binary and
43
+ a real `dolt sql-server` process, temporarily, against the SAME data directory.
44
+
45
+ CORRECTED 2026-08-13 (`dolt-sync-redesign.md` Part 5, Precondition V2). This
46
+ step previously said `winget install --id DoltHub.Dolt` on Windows, plus
47
+ `apt`/`brew` on POSIX. That was a genuine mistake and must not be repeated:
48
+ winget delivered a STALE 1.86.3 build while this repo carries its own version
49
+ pin, so an OS package manager is a second, unpinned version channel -- banned
50
+ from every code path and runbook this design owns. It also created a PATH
51
+ problem of its own: a winget-installed binary is invisible to processes that
52
+ started before the install, which is every SSH-dispatched session.
53
+
54
+ The fleet's ONE pinned channel is the same GitHub release asset
55
+ `src/cli/dolt-install.ts` uses (`DOLT_VERSION`, currently `v2.2.0`), landed at
56
+ the fleet-managed path -- always referenced as an absolute path, never system
57
+ PATH, and needing no admin rights:
58
+
59
+ - Windows: `%USERPROFILE%\.apra-fleet\bin\dolt.exe`
60
+ - POSIX: `$HOME/.apra-fleet/bin/dolt`
61
+
62
+ Probe it first -- existence is not enough, it must actually RUN and report the
63
+ pinned version:
64
+
65
+ ```bash
66
+ "$HOME/.apra-fleet/bin/dolt" version # POSIX
67
+ ```
68
+ ```powershell
69
+ & "$env:USERPROFILE\.apra-fleet\bin\dolt.exe" version # Windows
70
+ ```
71
+
72
+ If it is missing, broken, or the wrong version, install it from the pinned
73
+ asset. `settleDoltConflicts()` does exactly this itself (`ensurePinnedDolt()`
74
+ in `dolt-settle.mjs`, design doc Part 5.3) -- members never run
75
+ `apra-fleet install`, so nothing else on a member ever puts a pinned dolt
76
+ there. By hand, the same sequence is:
77
+
78
+ **Windows:**
79
+ ```powershell
80
+ New-Item -ItemType Directory -Force "$env:USERPROFILE\.apra-fleet\bin" | Out-Null
81
+ Invoke-WebRequest -Uri https://github.com/dolthub/dolt/releases/download/v2.2.0/dolt-windows-amd64.zip -OutFile "$env:TEMP\dolt-settle.zip" -TimeoutSec 300
82
+ Expand-Archive -Force "$env:TEMP\dolt-settle.zip" "$env:TEMP\dolt-settle"
83
+ Get-ChildItem -Recurse -Filter dolt.exe "$env:TEMP\dolt-settle" | Select-Object -First 1 |
84
+ Copy-Item -Force -Destination "$env:USERPROFILE\.apra-fleet\bin\dolt.exe"
85
+ ```
86
+
87
+ **Linux / macOS** (swap the asset for `dolt-linux-amd64.tar.gz`,
88
+ `dolt-darwin-amd64.tar.gz` or `dolt-darwin-arm64.tar.gz` to match the member):
89
+ ```bash
90
+ mkdir -p "$HOME/.apra-fleet/bin"
91
+ curl -fL --max-time 300 https://github.com/dolthub/dolt/releases/download/v2.2.0/dolt-linux-amd64.tar.gz -o /tmp/dolt-settle.tgz
92
+ mkdir -p /tmp/dolt-settle && tar -xzf /tmp/dolt-settle.tgz -C /tmp/dolt-settle
93
+ install -m 0755 "$(find /tmp/dolt-settle -type f -name dolt | head -1)" "$HOME/.apra-fleet/bin/dolt"
94
+ ```
95
+
96
+ Then re-probe: the freshly installed binary must report the pinned version
97
+ before you continue. On Windows a replace can fail because a stray `dolt`
98
+ process holds the file -- kill any process whose executable path IS this
99
+ fleet-managed path (nothing else ever launches a binary there) and retry once.
100
+
101
+ Every `dolt ...` invocation below means that absolute pinned path, not a bare
102
+ `dolt` from PATH.
103
+
104
+ ## 2. Start the ephemeral sql-server -- GENUINELY DETACHED
105
+
106
+ This is the step with real cross-platform divergence, and where most of the
107
+ danger lives (an interrupted/never-torn-down server is exactly what
108
+ apra-fleet-5mqg is about).
109
+
110
+ **Windows -- do NOT use `Start-Process` or `schtasks`:**
111
+
112
+ - `Start-Process -WindowStyle Hidden` looked detached but is NOT: it is still a
113
+ child of the invoking SSH/job-object session. Verified live: the sql-server
114
+ process (and its listening port) died the instant the launching
115
+ `execute_command` call's session ended, even with `-RedirectStandardOutput`/
116
+ `-RedirectStandardError` set and `-PassThru`.
117
+ - `schtasks`/`Register-ScheduledTask` + `Start-ScheduledTask` also failed:
118
+ verified live, `Get-ScheduledTaskInfo` reported `LastTaskResult 267011`
119
+ (`SCHED_S_TASK_QUEUED`) -- the task was queued but never actually ran,
120
+ because this is a non-interactive SSH session with no interactive logon
121
+ (the exact apra-fleet-i8qj failure mode, reproduced here independently).
122
+ - **What actually works, verified live:** spawn via WMI, which creates the
123
+ process under the WMI provider host's own session (session 0), fully
124
+ independent of the SSH session's job object:
125
+
126
+ ```powershell
127
+ $result = Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{
128
+ CommandLine = '"C:\Users\<you>\.apra-fleet\bin\dolt.exe" sql-server --host 127.0.0.1 --port 13399 --data-dir .beads/embeddeddolt'
129
+ CurrentDirectory = 'C:\akhil\git\apra-fleet'
130
+ }
131
+ $result.ProcessId # <-- record this PID for teardown (step 5)
132
+ ```
133
+ Verify it is actually up before proceeding: `Get-Process -Id <pid>` should
134
+ show it running under `SI` (session ID) `0`, and
135
+ `Test-NetConnection -ComputerName 127.0.0.1 -Port 13399` should report
136
+ `TcpTestSucceeded: True`.
137
+
138
+ **Linux / macOS (POSIX):** the SSH-session-job-object problem does not exist on
139
+ POSIX in the same way; the existing `nohup ... & disown` pattern (as used by
140
+ `task-wrapper.ts`'s bash wrapper for `long_running` commands elsewhere in this
141
+ codebase) is sufficient:
142
+
143
+ ```bash
144
+ nohup dolt sql-server --host 127.0.0.1 --port 13399 --data-dir .beads/embeddeddolt \
145
+ > /tmp/dolt-recovery.log 2>&1 &
146
+ echo "PID:$!"
147
+ disown
148
+ ```
149
+
150
+ ## 3. Connect and query -- the exact working flag set (verified live)
151
+
152
+ ```
153
+ dolt --no-tls --host=127.0.0.1 --port=13399 sql -q "USE beads; SELECT ...;"
154
+ ```
155
+
156
+ Two specific, non-obvious landmines, both reproduced live on this run:
157
+
158
+ 1. **`--no-tls` must come BEFORE `--host`/`--port`.** With `--host`/`--port`
159
+ given first and `--no-tls` after, the client still requested TLS and failed
160
+ with `TLS requested but server does not support TLS` -- Dolt's global-flag
161
+ parser is order-sensitive here. Always lead with `--no-tls`.
162
+ 2. **Do NOT pass `--user=root` or `--password` at all**, even though root with
163
+ an empty password is the documented default. Explicitly passing `--user=root`
164
+ switches the client into a credential-resolution path that issues an
165
+ interactive `Enter password:` prompt and then fails non-interactively with
166
+ `Failed to parse credentials: The handle is invalid` -- this is the EXACT
167
+ apra-fleet-ga61 symptom, reproduced live and now root-caused precisely: it
168
+ is triggered by explicitly specifying `--user`/`--password`, not by network
169
+ mode itself. Omitting both flags entirely lets the client silently
170
+ authenticate as root with the empty-password default with zero prompt.
171
+ (Separately, on Windows/PowerShell specifically: an empty-string argument
172
+ like `--password ''` can be silently dropped by PowerShell's native-argument
173
+ passing, shifting the NEXT flag into becoming its value -- another reason to
174
+ just omit the flag rather than try to pass an explicit empty value.)
175
+
176
+ Use `USE beads;` as the first statement of every query -- the target database
177
+ name is not implied by `--data-dir` alone once connected over SQL.
178
+
179
+ The actual recovery SQL (identical across all three OSes -- this part has no
180
+ platform variance):
181
+
182
+ ```sql
183
+ SET @@dolt_allow_commit_conflicts = 1;
184
+ CALL DOLT_MERGE('origin/main');
185
+ SELECT `table` FROM dolt_conflicts; -- enumerate EVERY conflicted table
186
+ CALL DOLT_CONFLICTS_RESOLVE('--theirs', 'issues'); -- table name is REQUIRED
187
+ CALL DOLT_COMMIT('-m', 'manual recovery: resolve conflict');
188
+ SELECT COUNT(*) FROM dolt_conflicts; -- MUST be 0 before you republish
189
+ ```
190
+ A bare `--theirs` is only correct when discarding our side's version of those
191
+ rows is genuinely acceptable. `settleDoltConflicts()` applies the full rulebook
192
+ instead -- per-field last-writer-wins by `updated_at` for `issues` and
193
+ `dependencies`, a real set-union INSERT for `labels`, generic
194
+ LWW-or-theirs for anything else (design doc Part 3.2 step 4). Resolving by hand
195
+ with real content on both sides, follow the same rules rather than clobbering
196
+ one side.
197
+
198
+ Then, outside the SQL session -- and ONLY AFTER the teardown in step 5 --
199
+ `bd dolt pull` (verify), `bd dolt push` (republish). The order matters; see
200
+ step 5.
201
+
202
+ ## 4. Verify before teardown
203
+
204
+ ```
205
+ dolt --no-tls --host=127.0.0.1 --port=13399 sql -q "USE beads; SELECT * FROM dolt_status;"
206
+ ```
207
+ Confirm no residual uncommitted/conflicted state before tearing the server down.
208
+
209
+ ## 5. Teardown -- ALWAYS, every path, even on failure, and BEFORE republishing
210
+
211
+ Ordering, corrected (design doc Part 7.2): tear the ephemeral server down
212
+ FIRST, then run `bd dolt pull` / `bd dolt push`. Embedded-mode `bd` must open
213
+ the same data dir the server still holds under Dolt's per-directory exclusive
214
+ lock, so republishing while the server is still up fails or falls back
215
+ read-only.
216
+
217
+ **Windows:**
218
+ ```powershell
219
+ Stop-Process -Id <pid> -Force -ErrorAction SilentlyContinue
220
+ ```
221
+ **POSIX:**
222
+ ```bash
223
+ kill <pid>
224
+ ```
225
+
226
+ Then, on every OS:
227
+ - Verify the port is actually closed (`Test-NetConnection` / `nc -z` /
228
+ `lsof -i:<port>`).
229
+ - Verify `bd dolt status` reports `embedded (in-process, no server)` again and
230
+ `.beads/metadata.json`'s `dolt_mode` is `"embedded"` -- if this recovery
231
+ procedure ever explicitly flips `dolt_mode` to `"server"` as part of routing
232
+ bd itself through the ephemeral server (this manual run did NOT do that --
233
+ it talked to the raw `dolt` CLI directly, bypassing bd entirely -- and
234
+ `settleDoltConflicts()` deliberately does the same, which is what makes its
235
+ teardown unconditionally safe), flipping it back is
236
+ MANDATORY and must happen in a `finally`/guaranteed-cleanup block, not as
237
+ the last step of a list that can be abandoned mid-way (exactly what went
238
+ wrong in the incident apra-fleet-5mqg documents).
239
+ - Remove any temp log files created for the ephemeral server's stdout/stderr.
240
+
241
+ ## Why this matters for the code fix (apra-fleet-5mqg, apra-fleet-ga61)
242
+
243
+ Every numbered landmine above (`--no-tls` ordering, omitting `--user`/
244
+ `--password`, WMI vs `Start-Process`/`schtasks` for real detachment on Windows,
245
+ never hardcoding the data directory) was independently rediscovered by trial
246
+ and error here, and was ALSO independently rediscovered by trial and error by
247
+ the Tier-2 LLM dispatch whose transcript motivated apra-fleet-5mqg. That was
248
+ strong evidence this entire procedure is mechanical and fully scriptable --
249
+ there was no judgment call anywhere in this runbook, only flag/ordering
250
+ trivia a fixed script encodes once and never has to rediscover again. That
251
+ script now exists: `fleet-sprint/dolt-settle.mjs`.
252
+
253
+ CAVEAT on the evidence: every landmine above was verified live against a
254
+ winget-installed dolt **1.86.3**, not against the pinned **v2.2.0** the fleet
255
+ now installs. Re-verifying them on the pinned binary, per OS, is Precondition
256
+ V0 of the design doc's Part 4 verification pass.