@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,94 @@
1
+ # Auto-Sprint Workflow Architecture
2
+
3
+ This diagram illustrates the complex, multi-agent lifecycle of a single sprint. It highlights the outer iterative cycle (Sprint Cycles) and the inner tight feedback loops (Planning Loop, Development Loop).
4
+
5
+ ```mermaid
6
+ stateDiagram-v2
7
+ direction TB
8
+
9
+ %% Sprint Initialization
10
+ [*] --> StartCycle : Initialize Sprint
11
+
12
+ state "Sprint Cycle (Max 5)" as SprintCycle {
13
+ direction TB
14
+
15
+ %% Planning Loop
16
+ state "Planning Phase" as PlanningPhase {
17
+ direction LR
18
+ Planner: Planner Agent\n(Builds DAG / Adds Beads)
19
+ PlanReviewer: Plan Reviewer Agent\n(Approves/Rejects)
20
+
21
+ Planner --> PlanReviewer: Proposes Plan
22
+ PlanReviewer --> Planner: Changes Needed (Text Feedback)
23
+ PlanReviewer --> Approved: Approved
24
+ }
25
+
26
+ StartCycle --> PlanningPhase
27
+
28
+ %% Development Loop
29
+ state "Development Phase" as DevelopmentPhase {
30
+ direction TB
31
+ StreakAssignment: Streak Assignment Agent\n(Divides work into sequential/parallel tracks)
32
+ Doers: Parallel Doer Agents\n(Closes assigned beads & fix feedback)
33
+ Reviewer: Reviewer Agent\n(Verifies work, gives text feedback)
34
+
35
+ StreakAssignment --> Doers: Dispatch Streaks
36
+ Doers --> Reviewer: Code Review
37
+ Reviewer --> Doers: Reopens beads (Text Feedback)
38
+ Reviewer --> CodeApproved: All closed
39
+ }
40
+
41
+ PlanningPhase --> DevelopmentPhase
42
+
43
+ %% Integration Loop (Conditional on Runbooks)
44
+ state "Integration Phase" as IntegPhase {
45
+ direction TB
46
+ Deployer: Deployer Agent\n(Deploys to test env)
47
+ IntegTest: Integration Test Runner\n(Tests features, adds bugs)
48
+
49
+ Deployer --> IntegTest: (If deploy.md exists)
50
+ }
51
+
52
+ DevelopmentPhase --> IntegPhase: (If playbooks exist)
53
+ }
54
+
55
+ %% Cycle Evaluation
56
+ CheckRemaining: Check Open Beads
57
+ IntegPhase --> CheckRemaining
58
+
59
+ CheckRemaining --> StartCycle: Open beads exist\n(Cycle count < 5)
60
+
61
+ %% Sprint Finalization
62
+ FinalReview: Final Reviewer Agent\n(Sprint Pass/Fail Verdict)
63
+ Harvester: Harvester Agent\n(Updates Memory & Retrospective)
64
+
65
+ CheckRemaining --> FinalReview: All beads closed\nOR Max cycles reached
66
+ FinalReview --> Harvester
67
+ Harvester --> [*]: End Sprint
68
+ ```
69
+
70
+ ## Supported multi-member topology
71
+
72
+ The runner spreads roles across members: the orchestrator issues every `bd` command and the git push/PR, doers round-robin across the doer pool, and the reviewer runs from the reviewer pool.
73
+
74
+ Two topology modes are supported, selected explicitly at sprint start:
75
+
76
+ - **`legacy` mode** -- no cross-member sync layer. Orchestrator `bd` commands
77
+ hit the orchestrator member's beads DB; a doer's `bd close` hits its own
78
+ member's DB; the sprint git branch is only coherent if all members share
79
+ the same working state. This coheres for **single-member** sprints (one
80
+ member does everything) or a **verified shared-workspace fleet** (all
81
+ configured members resolve to the same checkout/beads DB). Independent
82
+ per-member checkouts are **not supported** in this mode (their `bd close`
83
+ calls and commits would silently diverge from the orchestrator's view).
84
+ - **`synced` mode** -- orchestrator-bracketed git+Dolt sync brackets wrap
85
+ every dispatch, reconciling each member's git and beads state explicitly
86
+ instead of assuming it is already shared. This is what makes genuinely
87
+ independent per-member checkouts safe.
88
+
89
+ Guards enforcing whichever mode is selected:
90
+
91
+ 1. **Branch-ensure everywhere** (both modes) -- before the first doer round the runner git-ensures the sprint branch (`git fetch` + `git checkout -B`) on every member in the union of the orchestrator/doer/reviewer pools (not just the orchestrator), then non-destructively re-checks-out the branch at the start of later cycles (never resetting committed work back to base).
92
+ 2. **Topology precondition** (`checkMemberTopology`, called from `bin/cli.mjs`) -- in `legacy` mode, compares `git rev-parse HEAD` across the configured members and refuses to start on a mismatch; in `synced` mode, HEADs are allowed to differ but every member must share the same git remote origin and pass a live `bd dolt pull` probe. Single-member sprints trivially pass either check.
93
+
94
+ See `packages/apra-fleet-se/docs/architecture.md` -> "Multi-member topology", "Orchestrator-bracketed git sync", and "Dolt sync discipline" for the full rationale.
@@ -0,0 +1,399 @@
1
+ # Design: Pinned Shared Orchestrator (supervisor-held orchestrator-role pin)
2
+
3
+ Status: DESIGN PROPOSAL (no beads filed yet; matured from the 2026-08 stale-beads incidents)
4
+ Author: design session, 2026-08-11
5
+ Source doc path: `packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md`
6
+
7
+ ## Problem recap
8
+
9
+ Every fleet-sprint launch resolves an `orchestrator` pseudo-role (runner.js:73
10
+ `ROLE_ORCHESTRATOR`, runner.js:4938 `orchestratorMember = getMemberForRole(ROLE_ORCHESTRATOR)`)
11
+ whose beads clone is the sprint's ground truth for all scope reads and bd mutations. Absent an
12
+ explicit `--role-map '{"orchestrator":[...]}'`, this silently defaults to
13
+ `unmappedRoleFallbackPool[0]` (runner.js:4915-4920) -- for a single-member sprint, the dispatch
14
+ member itself. Two production incidents followed: beads created on the interactive operator
15
+ machine's clone were invisible to sprints whose accidental orchestrator was a different,
16
+ never-synced member.
17
+
18
+ The naive fix (role-map a hub member as orchestrator on every launch) deadlocks concurrency:
19
+ the launch overlap guard unions `--members` with every roleMap value INCLUDING orchestrator
20
+ (api.mjs:103-117 `memberUnion`, api.mjs:133-141), so a shared orchestrator member would 409
21
+ every second concurrent launch (api.mjs:202-207). The operator's proposal: the supervisor holds
22
+ a standing, shared, orchestrator-role-only reservation on one designated member and injects it
23
+ as the default orchestrator into every launch.
24
+
25
+ ---
26
+
27
+ ## Part A -- Research findings (evidence, not assumption)
28
+
29
+ ### A1. The concurrency-safety premise is PARTLY FALSE: the orchestrator role DOES mutate git working-tree state
30
+
31
+ The working assumption ("orchestrator commands are dolt/bd-only and never touch git
32
+ branch/working-tree state") does not survive a read of runner.js. The orchestrator-role command
33
+ sites split into two classes:
34
+
35
+ **Beads/dolt-only sites (the majority, as assumed).** `bd list/show/update/close/dep/defer`
36
+ against `member_name: orchestratorMember` -- e.g. runner.js:5123 (all-beads read), 5210
37
+ (scope filter), 5315 (status reopen), 7036 (claim), 7511 (bd show), 7577/8284/8677 (reopen per
38
+ verdict), 8073-8083 (bug triage), 9066 (target close), 5925 (bd dep remove), 2247-2249
39
+ (verifyDoerStreakClosed). Plus the D-pull/D-push brackets: `DoltSync.syncBefore(orchestratorMember, ...)`
40
+ at runner.js:2247, 5545 (readinessGate), 5836, 8124; `DoltSync.syncAfter(orchestratorMember, ...)`
41
+ at 6502, 6769, 7689, 8345, 9078 and `doltPushAfter` at 8691. All of these are `bd`/`bd dolt`
42
+ commands routed through dolt-sync.mjs (the single `bd dolt` chokepoint, dolt-sync.mjs:6-8;
43
+ actual commands are `bd dolt pull` at dolt-sync.mjs:365/675 and `bd dolt push` at 620/695).
44
+ None of these touch the git working tree.
45
+
46
+ **Git working-tree sites (the premise-breakers), with file:line evidence:**
47
+
48
+ 1. **Branch ensure includes the orchestrator.** `branchEnsureMembers` is explicitly the union
49
+ of `orchestratorMember` + doer pool + reviewer pool (runner.js:5517-5521). The ensure loop
50
+ (runner.js:5557-5726) runs, on the orchestrator's clone: `git fetch origin <base>` (5566),
51
+ `git fetch origin <branch>` (5582), local-branch probe (5598), two `git merge-base
52
+ --is-ancestor` checks (5616, 5625), then a **`git checkout <branch>` or `git checkout -B
53
+ <branch> <startPoint>`** (5689, decision built by `decideEnsureBranchAction`,
54
+ runner.js:4553-4634), with a **`git stash push -u`** fallback on a dirty tree (5709-5716).
55
+ 2. **Per-cycle re-ensure.** `reEnsureBranchOnMembers()` re-runs `git checkout <branch>` on
56
+ every branchEnsureMembers entry -- orchestrator included -- each cycle (runner.js:5745-5756).
57
+ 3. **Requirements-file probe reads the orchestrator's working tree.** `probeFileExists()`
58
+ dispatches a `node -e fs.existsSync(...)` to `orchestratorMember` (runner.js:5819-5829);
59
+ what it sees depends on which branch that clone has checked out.
60
+ 4. **Publish PR pushes from the orchestrator's clone.** `git push -u origin <branch>` with
61
+ `member_name: orchestratorMember` (runner.js:9000-9008), `git remote get-url origin`
62
+ (9046-9051), and the VCSModule create-PR curl dispatched on the orchestrator (9132-9142).
63
+ The push publishes the orchestrator's LOCAL `refs/heads/<branch>` -- it assumes that clone's
64
+ branch ref is current (true today only because orchestrator == doer in single-member
65
+ practice; already latent-fragile for true multi-member synced-mode sprints).
66
+ 5. **Abort finalization does git on the orchestrator.** `finalizeAbort()` runs `git fetch`,
67
+ `git rev-list --count origin/<base>..<branch>` (against the LOCAL branch ref) and `git push
68
+ -u origin <branch>` on the member resolved at runner.js:9392-9394 -- i.e. the orchestrator
69
+ (finalizeAbort body: runner.js:4358-4398).
70
+
71
+ **Consequence:** N concurrent sprints sharing ONE pinned orchestrator member would fight over a
72
+ single working tree: each sprint's ensure/re-ensure flips HEAD to its own branch, the
73
+ requirements probe can read another sprint's branch content, a stash from sprint A can be
74
+ popped into confusion, and publish/abort pushes read local refs whose state interleaves with
75
+ other sprints' checkouts. **The pin is NOT safe as-is.** It becomes safe only after the
76
+ orchestrator role is made genuinely beads-only (see D0 below) -- a bounded, well-localized
77
+ refactor, because every git site above is either relocatable to a dispatch member or
78
+ unnecessary for a non-dispatch orchestrator.
79
+
80
+ ### A2. The dolt push mutex: what it does and does not already cover
81
+
82
+ The supervisor owns ONE global mutex serializing every cross-sprint `bd dolt push`
83
+ (dolt-mutex.mjs:6-18, motivated by PoC constraints C.2 "any concurrent write to the same row
84
+ hard-conflicts" and C.3 "one unresolved conflict wedges the entire clone"). It is FIFO, leased,
85
+ pid-probed, and exposed over HTTP to the detached children (dolt-mutex.mjs:267-331). runner.js
86
+ threads it plus a per-sprint id into every D-push: `mutex: doltPushMutex, sprintId:
87
+ sprintMutexId` at runner.js:6502/6769/7689/8345/9078/8691 (fatal-path variant at 1143), where
88
+ `sprintMutexId` is the sprint branch (runner.js:4674-4676). Holder identity is logged on grant,
89
+ reclaim, and release (dolt-mutex.mjs:139, 181).
90
+
91
+ So: **cross-sprint push windows are already serialized today, for any pair of clones.** The
92
+ mutex was designed for pushes from DIFFERENT clones racing at the shared dolt remote -- exactly
93
+ the accidental-shared-orchestrator case the prompt describes. To that extent, reservation
94
+ exclusivity was never what protected orchestrator-role dolt writes; the mutex was.
95
+
96
+ **What the mutex does NOT cover, and the pin makes load-bearing:**
97
+
98
+ - `DoltSync.syncBefore` (D-pull) is never mutex-guarded -- no `mutex:` at runner.js:2247,
99
+ 5026, 5545, 5836, 8124. Two sprints pulling different clones concurrently is fine; two
100
+ sprints concurrently running `bd dolt pull` against the SAME pinned clone is a new, untested
101
+ interleaving (including pull racing an in-flight push-reconcile, dolt-sync.mjs:675).
102
+ - Plain local bd mutations (`bd update/close/dep/defer/create`) are not serialized at all.
103
+ Today each sprint mutates its own orchestrator clone; under the pin, three sprints issue
104
+ concurrent bd writes against ONE embedded-dolt clone (`.beads/embeddeddolt`). Whether bd
105
+ 1.1.x embedded mode tolerates concurrent same-clone processes (vs. erroring "database
106
+ locked" or corrupting) is **empirically unknown in this repo** -- nothing in
107
+ dolt-sync.mjs/dolt-mutex.mjs speaks to same-clone process concurrency. This must be spiked,
108
+ and the safe default design is to serialize (D3 below).
109
+ - `execute_command` (the transport under every orchestrator `command()`) enforces neither
110
+ reservations nor per-member mutual exclusion -- src/tools/execute-command.ts only marks the
111
+ statusline busy (execute-command.ts:238, 264-265); the `reservedBy` dispatch rejection
112
+ exists only in execute_prompt (execute-prompt.ts:536-543). So nothing at the transport layer
113
+ will accidentally serialize (or reject) the shared traffic either.
114
+
115
+ ### A3. Reservation model today (ledger + server-side reservedBy)
116
+
117
+ - **Supervisor ledger** (src/supervisor/ledger.mjs): per-sprint entries
118
+ `{ members, issueRoots, childPid, reservedAt, branch, base, goal, exit*, logPath }`
119
+ (ledger.mjs:65-108), claimed and released in exact lockstep with the sprint lifecycle
120
+ (ledger.mjs:21-29, claim at 461-477, release at 485-499), atomically persisted, PID-probe
121
+ reconciled on restart. Everything about it is sprint-lifecycle-scoped.
122
+ - **Launch overlap guard** (api.mjs:162-209): all-or-nothing 409 on any member of the incoming
123
+ union (members + every roleMap value, orchestrator included) overlapping any live ledger
124
+ entry, merged with the fleet server's own per-member `reservedBy` record via `listMembers`
125
+ (api.mjs:185-200).
126
+ - **Server-side reservation authority**: `member_reservation` (src/tools/member-reservation.ts)
127
+ sets `agent.reservedBy`; reserve fails if held by a different id (member-reservation.ts:42-44),
128
+ refresh by the same id succeeds (49-51), release is owner-checked (61-63), force_release is
129
+ unconditional (71-79). `sprint_id` is an opaque string -- nothing requires it to be a real
130
+ sprint. Enforcement is at execute_prompt only (execute-prompt.ts:536-543), keyed on per-call
131
+ `sprint_id` falling back to `APRA_FLEET_SPRINT_ID` (execute-prompt.ts:106-114, 254-259).
132
+ - **Who actually reserves**: supervisor-spawned children run bin/cli.mjs, which reserves
133
+ `validMembers` only -- roleMap values are NOT in its reserveAll set (cli.mjs:723-729). The
134
+ supervisor ledger union DOES fold roleMap values in (api.mjs:442). So today a role-mapped
135
+ orchestrator outside `--members` is overlap-guarded at the supervisor but never server-side
136
+ reserved by the child -- an existing asymmetry the pin design can exploit cleanly (the pinned
137
+ member simply never enters either per-sprint set).
138
+
139
+ ### A4. Interaction with in-flight work (pause/resume `apra-fleet-p2to`, sprint-doctor `apra-fleet-iiny`)
140
+
141
+ Pause/resume's reservation logic (escalate-to-llm-design.md:520-533) releases each member via
142
+ owner-checked `member_reservation release` on pause and re-reserves on resume, failing resume
143
+ cleanly when a member was taken. This operates on the sprint's OWN per-sprint reservation set.
144
+ Under this design the pinned member is deliberately NOT in that set (D1), so pause/resume never
145
+ touches it -- and even a buggy release attempt would be refused by the owner check
146
+ (member-reservation.ts:61-63), because the pin's owner is a supervisor sentinel, not the sprint
147
+ id. So the mechanisms are structurally orthogonal, **with two real (non-hand-waved) contact
148
+ points**:
149
+
150
+ 1. **Sprint-doctor's wedged-reservation remedy is NOT orthogonal.** The doctor's remedy table
151
+ allows `member_reservation force_release` when a member is "reserved by a sprint id whose
152
+ pid/ledger entry is dead" (escalate-to-llm-design.md:679). The pin sentinel has no pid and
153
+ no ledger entry -- to that heuristic it looks exactly like a wedged dead reservation, and a
154
+ doctor run would strip the pin. The doctor rule must learn: a reservation whose owner
155
+ matches the supervisor pin sentinel prefix is never force-releasable (and the supervisor
156
+ should self-heal the pin regardless -- D2).
157
+ 2. **Explicit orchestrator override** (D4's escape hatch) puts the overriding member back in
158
+ the per-sprint reservation set, where pause/resume handles it under existing semantics --
159
+ intentionally unchanged.
160
+
161
+ ---
162
+
163
+ ## Part B -- Design
164
+
165
+ ### D0 (prerequisite). Make the orchestrator role beads-only
166
+
167
+ Because of A1, the pin requires relocating the orchestrator's git surface first. All four
168
+ sites are bounded:
169
+
170
+ - **Branch ensure / re-ensure**: drop `orchestratorMember` from `branchEnsureMembers`
171
+ (runner.js:5517-5521) whenever the orchestrator is not also a dispatch member (compute:
172
+ member appears in doer/reviewer pools). A beads-only orchestrator has no need for the sprint
173
+ branch; its clone's git checkout becomes irrelevant to the sprint.
174
+ - **Requirements probe/read** (runner.js:5819-5829 and the up-front read near 5523): dispatch
175
+ to `getMemberForRole('planner')` -- the planner is the consumer of the requirements content
176
+ and its member is already branch-ensured.
177
+ - **Publish PR** (runner.js:9000-9152): run the branch push, origin-URL probe, and PR curl on a
178
+ dispatch member -- recommend `getMemberForRole('harvester')` (the last code-writing role;
179
+ its clone G-pushed most recently, so its local ref is current -- runner.js:8913-8923). This
180
+ also fixes the latent multi-member staleness noted in A1 point 4.
181
+ - **finalizeAbort** (runner.js:9390-9400 member resolution): resolve the same dispatch member
182
+ instead of the orchestrator.
183
+
184
+ After D0, the orchestrator's entire command surface is `bd`/`bd dolt` via execute_command, and
185
+ "sharing" reduces to the beads-clone concurrency question handled in D3.
186
+
187
+ ### D1. Data model: a supervisor "pinned roles" config + server-side sentinel -- NOT a ledger reservation type
188
+
189
+ **Recommended:** model the pin as supervisor configuration plus a standing server-side
190
+ `reservedBy` sentinel, with the ledger kept completely ignorant of it:
191
+
192
+ - Supervisor config: `pinnedRoles: { orchestrator: ["<member>", ...] }` (ordered fallback
193
+ list, D5). Product-generic -- no member name in code.
194
+ - At startup (and on a periodic self-heal sweep), the supervisor reserves the active pinned
195
+ member server-side via the EXISTING `member_reservation` tool with a sentinel owner id, e.g.
196
+ `sprint_id: "supervisor-pin:orchestrator"`. No tool/schema change: `sprint_id` is already an
197
+ opaque string (member-reservation.ts:24-27), refresh-by-same-owner already succeeds
198
+ (member-reservation.ts:49-51), and `list_members`/dashboards already display `reservedBy`
199
+ (api.mjs:399-426).
200
+ - Per-sprint reservations EXCLUDE the pinned member: the injected orchestrator roleMap entry is
201
+ subtracted before `memberUnion` feeds the overlap guard and `ledger.claim` (api.mjs:442,
202
+ 487, 539), and the child's `reserveAll` set (cli.mjs:723-729) already never contained roleMap
203
+ values, so no child-side change is needed for the supervisor path.
204
+
205
+ **Why not a shared/`exclusive:false` reservation TYPE in the ledger:** every ledger invariant
206
+ is sprint-lifecycle-shaped -- claim/release in lockstep with one sprint's launch/terminal
207
+ events (ledger.mjs:21-29), a `childPid` for restart PID-probe reconciliation (ledger.mjs:70-71),
208
+ release driven by watchdog/reconcile/Stop (`POST /api/reservations/:sprintId/force-release`,
209
+ dashboard.mjs:279-282 per escalate-to-llm-design.md:521). A permanent, sprint-less, shared
210
+ entry violates all of it: it has no pid to probe, must survive every reconciliation pass, must
211
+ be skipped by the overlap guard, and must never be force-released by the Stop path. That is
212
+ not a reservation with a flag -- it is a different object with a different lifecycle, and
213
+ encoding it as a ledger row means special-casing every ledger consumer (watchdog, reconcile,
214
+ readopt, dashboard, overlap guard, history). Config + sentinel touches exactly two seams
215
+ instead: launch-time injection/validation (api.mjs) and the server-side `reservedBy` record
216
+ that execute_prompt already enforces. The sentinel also gives cross-process reach the ledger
217
+ cannot: it protects against dispatches from CLI-launched sprints and manual sessions that never
218
+ consult this supervisor's ledger at all (the eft.26.1 hole, api.mjs:143-153).
219
+
220
+ ### D2. Enforcement: how the pinned member is kept out of other roles
221
+
222
+ Three layers, cheapest first:
223
+
224
+ 1. **Launch-time validation (authoritative, clear message).** In `launch()` (api.mjs:436),
225
+ after `roleMapResolver` (api.mjs:441): reject 400 if the pinned member appears in the
226
+ request's `members` list or in any roleMap value other than `orchestrator`, with an error
227
+ naming the member, the pin, and the fix ("member '<m>' is pinned as the shared orchestrator
228
+ and cannot be used as doer/reviewer/...; remove it from members/roleMap or change the pin").
229
+ This runs before `beforeLaunch`/`ledger.claim`, preserving the no-partial-claim contract
230
+ (api.mjs:35-36).
231
+ 2. **Dispatch-time, for free.** The sentinel `reservedBy` makes execute_prompt reject ANY agent
232
+ dispatch to the pinned member from any sprint (owner `supervisor-pin:orchestrator` never
233
+ equals a caller `sprint_id`, execute-prompt.ts:536-543) -- while execute_command (the
234
+ orchestrator's entire post-D0 traffic) is unaffected because it performs no reservedBy check
235
+ (A2). This is exactly the asymmetry the proposal needs, and it already exists.
236
+ 3. **Self-heal + doctor guard.** The supervisor periodically re-asserts the sentinel
237
+ (idempotent refresh, member-reservation.ts:49-51) so an accidental/manual force_release
238
+ cannot silently de-protect the member; the sprint-doctor remedy table gains the rule from
239
+ A4.1 (sentinel-prefixed owners are never force-releasable).
240
+
241
+ ### D3. Serializing the shared beads clone (the genuinely new mechanism)
242
+
243
+ Generalize the supervisor's global dolt-push mutex into keyed mutexes: key = member name (the
244
+ current global push mutex becomes, or wraps, key `"<dolt-remote>"` -- unchanged behavior), and
245
+ a new per-member clone lock for the pinned orchestrator. The runner acquires the clone lock
246
+ around (a) `DoltSync.syncBefore(orchestratorMember, ...)` and (b) each orchestrator bd-mutation
247
+ bracket, whenever the orchestrator member is supervisor-pinned (the child knows via a flag the
248
+ supervisor injects alongside the roleMap, or simply: whenever `--service-url` is present it
249
+ asks). The existing lease/pid-reclaim/FIFO machinery (dolt-mutex.mjs:31-42) is reused verbatim;
250
+ only the keying changes. Pure reads (`bd list/show`) can stay unlocked initially -- reads
251
+ racing a writer are the same exposure the operator's interactive session already creates today
252
+ against its own clone.
253
+
254
+ Precondition spike: empirically test bd embedded-dolt behavior under concurrent same-clone
255
+ processes (two parallel `bd update`, `bd dolt pull` racing `bd update`). If bd's own locking
256
+ proves robust, the clone lock can be narrowed to the pull/push brackets only.
257
+
258
+ ### D4. Auto-injection and the override question
259
+
260
+ Injection point: `launch()` in api.mjs, server-side, after `roleMapResolver` (api.mjs:441) and
261
+ before `memberUnion`/`beforeLaunch`/`spawnSprint` -- if the resolved roleMap has no
262
+ `orchestrator` key, inject `roleMap.orchestrator = [activePinnedMember]`; the spawner already
263
+ forwards roleMap into child argv untouched (spawner.mjs:223-225), and runner.js resolution
264
+ (4915-4920) then never falls back to `unmappedRoleFallbackPool[0]`. Because the pinned member
265
+ arrives only via roleMap (never `--members`), it is also structurally excluded from the
266
+ doer/reviewer fallback pools (runner.js:4910-4913 builds those from `physicalMembers`).
267
+
268
+ **Recommendation: soft pin -- an explicit `roleMap.orchestrator` from the caller WINS,** loudly
269
+ logged and echoed in the launch response (e.g. `orchestratorPinOverridden: true`). Reasons:
270
+ the incidents were caused by a silent implicit default, not by explicit choices -- injection
271
+ plus validation eliminates the silent path entirely; a hard pin would leave no way to launch
272
+ sprints during maintenance of the pinned member (defeating D6's fallback story); and an
273
+ explicitly-mapped override member flows into the NORMAL exclusive reservation path (union +
274
+ ledger + reserveAll), so it is safe under existing rules with zero new semantics. The escape
275
+ hatch is an explicit, logged, per-launch act -- precisely the property the implicit default
276
+ lacked.
277
+
278
+ CLI-direct launches (bin/cli.mjs without the supervisor) keep today's behavior; when
279
+ `--service-url` is provided the CLI SHOULD fetch the pin (D5's GET endpoint) and apply the same
280
+ default+validation. This deployment's practice is supervisor-API-only launches, so the CLI gap
281
+ is a documented follow-up, not a blocker.
282
+
283
+ ### D5. Configuration surface (product-generic)
284
+
285
+ - **File**: `pinnedRoles` object in a supervisor config file in the existing data dir
286
+ (`FLEET_SE_DATA_DIR`, default `~/.apra-fleet-se`, ledger.mjs:177-181), e.g.
287
+ `supervisor-config.json`: `{ "pinnedRoles": { "orchestrator": ["memberA", "memberB"] } }`.
288
+ Generic shape (role -> ordered member list); only `orchestrator` is honored initially.
289
+ - **Flag**: `fleet-se serve --pin-orchestrator <member[,member...]>` overriding the file
290
+ (serve.mjs currently takes only `--port`, serve.mjs:52-62 -- room to grow).
291
+ - **API**: `GET /api/config/pinned-roles` (consumed by dashboard, launch form, and the CLI
292
+ follow-up) and `PUT` for runtime changes (re-runs sentinel reserve/release accordingly).
293
+ Dashboard shows the pin and its health.
294
+ - No member name appears anywhere in code; `fleet-dev` is purely this deployment's config value.
295
+
296
+ ### D6. Single point of failure -- honest assessment and mitigation
297
+
298
+ Real regression risk: today, sprints accidentally spread orchestrator duty across their own
299
+ first members, so no single dead machine blocks ALL launches; a pin concentrates every launch
300
+ AND every in-flight sprint's bd reads/writes on one member. Mitigations, in order:
301
+
302
+ 1. **Ordered fallback list** (D5): at launch, the supervisor health-probes the first pinned
303
+ member (cheap `execute_command` echo plus optionally a `bd dolt pull` probe, the same probe
304
+ shape `checkMemberTopology`'s synced mode already uses, cli.mjs:645) with a short timeout;
305
+ on failure it advances to the next configured member, re-pointing the sentinel. All
306
+ candidates failing => the launch is rejected 503 with an explicit message naming every
307
+ probed member and failure -- **fail loud at launch, never a silent mid-sprint hang**.
308
+ 2. **In-flight sprints**: a pin dying mid-sprint is the same failure mode as any member dying
309
+ mid-sprint today (orchestrator included) -- not made worse, but concentrated. The
310
+ supervisor watchdog/dashboard should surface pin health continuously so the operator learns
311
+ about it from the dashboard, not from three simultaneously wedged sprints. Fits naturally
312
+ into sprint-doctor's diagnosis table later.
313
+ 3. Accept the residual coupling consciously: the accidental-spread status quo bought
314
+ "availability" at the price of the exact correctness incidents that motivated this design.
315
+ Note the deployment guidance: pin the hub/local member (the machine the supervisor itself
316
+ runs on), which removes most network/SSH failure modes from the orchestrator path.
317
+
318
+ ### D7. Audit/attribution
319
+
320
+ Push attribution already exists and survives: every D-push acquires the supervisor mutex with a
321
+ per-sprint id (runner.js:6502 et al., `sprintId: sprintMutexId` = the sprint branch,
322
+ runner.js:4674-4676), and the mutex logs holder identity on grant/reclaim/release
323
+ (dolt-mutex.mjs:139, 181). Each sprint's own log labels every orchestrator command it issued.
324
+ What IS lost: today, concurrent sprints' bd mutations land on different clones, so dolt-level
325
+ history is separable by machine; under the pin, one clone's dolt history interleaves all
326
+ sprints. The D3 clone lock plus per-sprint runner logs (every mutation is issued and logged by
327
+ exactly one sprint process) is sufficient traceability for v1 -- no new mechanism proposed. If
328
+ finer attribution is ever needed, it belongs in bd (an actor/annotation flag), not here.
329
+
330
+ ### D8. Would this have prevented today's two incidents?
331
+
332
+ Both incidents (fleet-mac/k4sc, fleet-win-dev1/ot2z) had the same shape: single-member sprint,
333
+ orchestrator collapsed onto the dispatch target, and beads created/updated on the interactive
334
+ operator machine's clone were invisible because the resolved orchestrator's clone had never
335
+ pulled them -- and could not, since the operator clone had also never pushed them.
336
+
337
+ - **With the pin set to the member whose clone the interactive orchestrator session itself
338
+ uses** (this deployment: the hub/local member): both incidents are prevented at the source --
339
+ the sprint's scope reads run against the very clone where the beads were created; no push or
340
+ pull needs to have happened. This is the honest core of the fix for THIS deployment.
341
+ - **Product-generically, the gap relocates rather than vanishes**: if the operator's
342
+ interactive clone is NOT the pinned member, unpushed operator mutations are exactly as
343
+ invisible as before -- `DoltSync.syncBefore(pin)` at launch (runner.js:5545, readinessGate)
344
+ pulls the pin's clone, but a pull cannot fetch what was never pushed. So the previously
345
+ discussed launch-time pre-sync/freshness gate (verify the pin's clone is current against the
346
+ dolt remote, and surface staleness loudly) remains **complementary, not superseded** -- it is
347
+ the guard for the "discipline burden" now concentrated on one well-known member, which is
348
+ itself an improvement: one clone to keep honest instead of N accidental ones.
349
+ - **Dispatch-member sync is unaffected**: doers/reviewers keep their own per-dispatch D-pull
350
+ (runner.js:5026 inside the withGitSync bracket) and D-push; nothing in this design touches
351
+ the dispatch-side sync lattice.
352
+
353
+ ---
354
+
355
+ ## Recommendation
356
+
357
+ The idea is **sound in intent and correctly identifies that reservation exclusivity was never
358
+ the real safety mechanism for orchestrator-role dolt writes (the supervisor dolt-push mutex
359
+ was)** -- but it is **not implementable as stated**, for one hard reason found in the code: the
360
+ orchestrator role is not beads-only today. Branch-ensure checks the orchestrator's clone onto
361
+ the sprint branch every cycle, the requirements probe reads its working tree, and publish/abort
362
+ push from its local refs (A1). A shared pinned orchestrator without D0 would corrupt exactly
363
+ the cross-sprint isolation the reservation system exists to protect. With three modifications
364
+ the design is solid:
365
+
366
+ 1. D0: make the orchestrator role beads-only (relocate the four git sites).
367
+ 2. D1/D2: model the pin as supervisor config + `member_reservation` sentinel (no ledger type,
368
+ no MCP schema change), enforce at launch validation + the existing execute_prompt check.
369
+ 3. D3: serialize shared-clone bd access via a per-member generalization of the existing
370
+ supervisor mutex, after a concurrency spike on bd embedded-dolt behavior.
371
+
372
+ Soft pin (explicit roleMap.orchestrator overrides, loudly) is recommended over hard pin. The
373
+ launch-time pre-sync/freshness gate stays on the roadmap as a complementary guard (D8).
374
+
375
+ ### Bead sketches (NOT filed -- for operator decision)
376
+
377
+ 1. **`refactor(fleet-sprint): make the orchestrator role beads-only`** -- Drop the orchestrator
378
+ from `branchEnsureMembers` when it is not also a dispatch member; relocate the
379
+ requirements-file probe/read to the planner member and the Publish-PR push/origin-probe/PR
380
+ call plus finalizeAbort git steps to a dispatch member (harvester/doer). Prerequisite for
381
+ any shared-orchestrator work; independently fixes the latent stale-local-ref publish push
382
+ for multi-member sprints.
383
+ 2. **`spike(beads): embedded-dolt same-clone concurrency behavior`** -- Empirically establish
384
+ what bd 1.1.x embedded mode does under concurrent same-clone processes (parallel `bd
385
+ update`, `bd dolt pull` racing a write): clean lock-wait, transient error, or corruption.
386
+ Output decides whether bead 4's clone lock wraps all mutations or only the pull/push
387
+ brackets.
388
+ 3. **`feat(supervisor): pinned-orchestrator config, sentinel reservation, and launch
389
+ injection`** -- `pinnedRoles` config file + `--pin-orchestrator` serve flag + GET/PUT API;
390
+ sentinel reserve via `member_reservation` with self-heal refresh; launch-time injection of
391
+ the default `roleMap.orchestrator` with health-probed fallback list and 503-on-all-dead;
392
+ 400-validation rejecting the pinned member in any non-orchestrator role; pin excluded from
393
+ memberUnion/ledger claim; dashboard surfacing. Soft-pin override semantics per D4.
394
+ 4. **`feat(supervisor+runner): per-member beads-clone lock for the shared orchestrator`** --
395
+ Generalize the dolt-push mutex to keyed (per-member) locks over the same lease/FIFO/pid
396
+ machinery; runner acquires the clone lock around orchestrator syncBefore and bd-mutation
397
+ brackets when the orchestrator is supervisor-pinned. Scope narrowed or widened by bead 2's
398
+ findings. Includes the sprint-doctor rule change: sentinel-owned reservations are never
399
+ force-releasable.