@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,395 @@
1
+ #!/usr/bin/env node
2
+ // =============================================================================
3
+ // `fleet-se serve` -- always-on fleet-sprint supervisor entry point
4
+ // =============================================================================
5
+ //
6
+ // Boots the supervisor HTTP API (see ../src/supervisor/server.mjs) and keeps
7
+ // the process alive INDEFINITELY. The process exits ONLY when:
8
+ // * a client POSTs /api/shutdown, or
9
+ // * the operator sends SIGINT / SIGTERM.
10
+ // It never exits because a sprint finished or a child crashed (process model B:
11
+ // sprints run as detached, IPC-less children of bin/cli.mjs, spawned later by
12
+ // the eft.4.2 spawner seam).
13
+ //
14
+ // Every module seam (ledger, spawner, watchdog, dashboard/backlog/launch-form,
15
+ // the eft.4.4 sprint/member/backlog API, the id allocator, and the dolt push
16
+ // mutex) is wired to its REAL implementation below -- none of them are the
17
+ // inert server.mjs stubs anymore (eft.4.8.1).
18
+ // =============================================================================
19
+
20
+ import { parseArgs } from 'node:util';
21
+ import { pathToFileURL } from 'node:url';
22
+ import { createSupervisor, DEFAULT_SERVICE_PORT, readJsonBody, sendJson } from '../src/supervisor/server.mjs';
23
+ import { createLedger } from '../src/supervisor/ledger.mjs';
24
+ import { createHistory, HISTORY_EVENTS } from '../src/supervisor/history.mjs';
25
+ import { createSpawner } from '../src/supervisor/spawner.mjs';
26
+ import { createReconciler, registerReservationRoutes, killPid } from '../src/supervisor/reconcile.mjs';
27
+ import { createReadopter } from '../src/supervisor/readopt.mjs';
28
+ import { createLiveProxy, registerLiveRoutes } from '../src/supervisor/proxy.mjs';
29
+ import { createHistoryView, registerHistoryViewRoutes } from '../src/supervisor/history-view.mjs';
30
+ import { createLogView, registerLogViewRoutes } from '../src/supervisor/log-view.mjs';
31
+ import { installSelfLogTee, createSelfLogView, registerSelfLogRoutes } from '../src/supervisor/self-log.mjs';
32
+ import { createIdAllocator, registerIdAllocatorRoutes } from '../src/supervisor/id-allocator.mjs';
33
+ import { createDoltMutex, registerDoltMutexRoutes } from '../src/supervisor/dolt-mutex.mjs';
34
+ // eft.4.8.1: the operator-facing surface -- PID-liveness watchdog (eft.4.3),
35
+ // dashboard/backlog/launch-form (eft.6.*), and the six sprint/member/backlog
36
+ // operator endpoints (eft.4.4). These were fully implemented and unit-tested
37
+ // but never imported/registered here -- this is that wiring.
38
+ import { createWatchdog } from '../src/supervisor/watchdog.mjs';
39
+ import { createBacklog, registerBacklogRoutes } from '../src/supervisor/backlog.mjs';
40
+ // launch-form.mjs (renderLaunchFormHtml/buildLaunchRequestBody) has no
41
+ // register*Routes()/create*() seam of its own -- dashboard.mjs's
42
+ // renderIndexPageHtml() already imports it directly and falls back to
43
+ // renderLaunchFormHtml() whenever no launchFormHtml override is supplied, so
44
+ // constructing the real dashboard below (instead of the inert stub) is what
45
+ // actually wires the Launch Sprint form onto the page.
46
+ import { createDashboard, registerDashboardRoutes } from '../src/supervisor/dashboard.mjs';
47
+ import { createSprintController, registerSprintRoutes, defaultMemberOverlapGuard, ApiError } from '../src/supervisor/api.mjs';
48
+ import { createScopeGuard, formatScopeConflict } from '../src/supervisor/scope-overlap.mjs';
49
+ import { listFleetMembers, executeFleetCommand } from '../src/supervisor/fleet-members.mjs';
50
+ import { createDoltOrphanSweep } from '../src/supervisor/dolt-orphan-sweep.mjs';
51
+ import { resolveFleetServerConnection } from './cli.mjs';
52
+
53
+ const SERVE_USAGE = `
54
+ Usage: fleet-se serve [options]
55
+
56
+ Starts the always-on fleet-sprint supervisor. Runs until POST /api/shutdown or a
57
+ termination signal (Ctrl-C / SIGTERM).
58
+
59
+ Options:
60
+ --port <port> HTTP service port for the supervisor API. Default: ${DEFAULT_SERVICE_PORT}.
61
+ -h, --help Show this help message.
62
+ `.trim();
63
+
64
+ /**
65
+ * apra-fleet-k06.1: compose BOTH launch-time overlap guards api.mjs's own
66
+ * header comment (eft.5.2/eft.5.3) already describes as meant to run
67
+ * together, as a standalone/exported factory so the composition itself --
68
+ * not just each guard in isolation -- is directly unit-testable without
69
+ * booting the real supervisor process (serveMain constructs its real
70
+ * defaultMemberOverlapGuard/createScopeGuard collaborators and passes them
71
+ * here; a test can inject fakes/stubs of the SAME shape instead).
72
+ *
73
+ * Member axis runs FIRST, preserving its exact pre-existing
74
+ * behavior/message/status (409, field 'members') for every case it already
75
+ * covered. The issue-scope axis runs second, over the SAME ledger; a
76
+ * conflict throws the same ApiError(409, ...) shape the member guard uses
77
+ * (field 'issue', a formatScopeConflict() message naming the conflicting
78
+ * sprint(s) and overlapping bead ids) rather than an unhandled 500 --
79
+ * registerSprintRoutes' onApiError only translates ApiError instances into a
80
+ * clean JSON error response. Either guard failing rejects the whole launch; a
81
+ * launch overlapping on neither axis still succeeds.
82
+ *
83
+ * @param {{
84
+ * memberOverlapGuard: (ctx: { members: string[], issueRoots: string[] }) => Promise<void>|void,
85
+ * scopeGuard: { checkLaunch: (issueRoots: string[]) => Promise<{ ok: boolean, conflicts: Array<{sprintId: string, overlappingIds: string[]}> }> },
86
+ * }} deps
87
+ * @returns {(ctx: { members: string[], issueRoots: string[] }) => Promise<void>}
88
+ */
89
+ export function composeBeforeLaunch({ memberOverlapGuard, scopeGuard }) {
90
+ return async ({ members, issueRoots }) => {
91
+ await memberOverlapGuard({ members, issueRoots });
92
+ const scopeResult = await scopeGuard.checkLaunch(issueRoots);
93
+ if (!scopeResult.ok) {
94
+ throw new ApiError(409, formatScopeConflict(scopeResult.conflicts), 'issue');
95
+ }
96
+ };
97
+ }
98
+
99
+ export function parseServeArgs(argv) {
100
+ try {
101
+ return parseArgs({
102
+ args: argv,
103
+ options: {
104
+ port: { type: 'string' },
105
+ help: { type: 'boolean', short: 'h' },
106
+ },
107
+ strict: true,
108
+ allowPositionals: false,
109
+ });
110
+ } catch (err) {
111
+ throw new Error(`Invalid command-line arguments: ${err.message}\n\n${SERVE_USAGE}`);
112
+ }
113
+ }
114
+
115
+ export async function serveMain(argv = process.argv.slice(2)) {
116
+ const { values } = parseServeArgs(argv);
117
+
118
+ if (values.help) {
119
+ console.log(SERVE_USAGE);
120
+ return { exitCode: 0 };
121
+ }
122
+
123
+ // Installed before anything else logs: every console.log/warn/error from
124
+ // this point on (including the seam-construction comments' own
125
+ // console.error calls below) is timestamped (local time, not UTC) and
126
+ // teed to <dataDir>/logs/supervisor.log, in addition to still reaching
127
+ // the original console (an interactive run or a shell redirect is
128
+ // unaffected). This is the supervisor's own equivalent of spawner.mjs's
129
+ // per-sprint-child raw log; a dashboard link to GET /supervisor/log is
130
+ // registered further down, once `supervisor` exists.
131
+ const selfLog = installSelfLogTee();
132
+ process.once('exit', () => selfLog.stop());
133
+
134
+ let port = DEFAULT_SERVICE_PORT;
135
+ if (values.port !== undefined) {
136
+ port = Number(values.port);
137
+ if (!Number.isInteger(port) || port < 1 || port > 65535) {
138
+ console.error(`Error: --port must be a valid TCP port number, got "${values.port}".`);
139
+ return { exitCode: 1 };
140
+ }
141
+ }
142
+
143
+ // The durable reservation ledger (eft.5.1) and its terminal-event history
144
+ // (eft.5.4) are the restart-surviving source of truth. Wire them as real
145
+ // collaborators so a restarted supervisor reconciles against on-disk state.
146
+ const ledger = createLedger();
147
+ const history = createHistory();
148
+ // apra-fleet-f34.1: pass this supervisor's OWN listening address so every
149
+ // spawned sprint child's cli.mjs receives --service-url and threads it
150
+ // into runner.js's HTTP-backed dolt-mutex/id-allocator clients (see
151
+ // spawner.mjs's buildSprintArgv/createSpawner doc comments).
152
+ //
153
+ // apra-fleet-k7b.3: onChildExit is this SAME-INSTANCE spawner's own
154
+ // 'exit' listener notification (Node's own exit code/signal, keyed by
155
+ // the launch's runId -- the SAME sprintId createSprintController claims
156
+ // in the ledger BEFORE spawning, apra-fleet-k7b.1). Persist it two
157
+ // places: (1) history records a CHILD_EXITED audit event so the exit is
158
+ // still visible after the reservation is eventually released; (2)
159
+ // ledger.recordExit() annotates the still-held reservation in place (does
160
+ // not release it) so the watchdog/dashboard can report e.g. "exited 1 at
161
+ // ..." instead of a bare "pid gone". Both are independently best-effort --
162
+ // a missing/already-released reservation (e.g. a force-release raced the
163
+ // child's own exit) must never crash this listener.
164
+ //
165
+ // apra-fleet-xuo.6.1 -- ORDER IS LOAD-BEARING, history FIRST, ledger
166
+ // SECOND. Both ledger.mjs and history.mjs commit their in-memory view only
167
+ // after their atomic persist (tmp write + rename), and every observer (the
168
+ // dashboard/log-view, and the ou7.3/k7b.7 integration tests) polls the
169
+ // LEDGER's exitCode as the "this child has exited" readiness signal and
170
+ // then immediately reads history. Recording the ledger first opened a
171
+ // window one whole history-persist wide in which the ledger already showed
172
+ // an exitCode while history still had zero CHILD_EXITED events for that
173
+ // sprint -- the ledger/history mismatch of apra-fleet-xuo.6. Writing
174
+ // history first makes "the ledger shows an exitCode" imply "history
175
+ // already carries CHILD_EXITED" for every reader. Do not swap these back.
176
+ //
177
+ // apra-fleet-ou7.1: onChildExit also carries logPath (spawner.mjs's own
178
+ // per-sprint raw stdout/stderr log file) through into the CHILD_EXITED
179
+ // history event -- the ledger already has it (recorded at claim() time,
180
+ // see createSprintController's launch()), but history's own copy stays
181
+ // discoverable even after the reservation is eventually released.
182
+ const spawner = createSpawner({
183
+ serviceUrl: `http://localhost:${port}`,
184
+ onChildExit: async ({ runId, exitCode, signal, at, logPath }) => {
185
+ if (!runId) return;
186
+ try {
187
+ await history.record({ sprintId: runId, event: HISTORY_EVENTS.CHILD_EXITED, exitCode, signal, at, logPath });
188
+ } catch (err) {
189
+ console.error(`[spawner] history.record(CHILD_EXITED) failed for '${runId}':`, err);
190
+ }
191
+ try {
192
+ await ledger.recordExit(runId, { exitCode, signal, at });
193
+ } catch (err) {
194
+ console.error(`[spawner] ledger.recordExit failed for '${runId}':`, err);
195
+ }
196
+ },
197
+ });
198
+ // apra-fleet-3i3.1: the real kill-signal implementation is only wired in
199
+ // HERE -- createReconciler()'s own default is a safe no-op (see
200
+ // reconcile.mjs's module doc) so nothing outside this production entry
201
+ // point can accidentally send a real signal to an arbitrary pid.
202
+ const reconciler = createReconciler({ ledger, history, killPid });
203
+ // eft.4.5: re-adopts still-live children by PID at startup (see below),
204
+ // registering their recovered --viewer-port with the spawner seam so
205
+ // they are tracked/watchdog-monitored/HTTP-proxyable exactly like a
206
+ // freshly-spawned child.
207
+ const readopter = createReadopter({ ledger, spawner, reconciler });
208
+
209
+ // eft.9.3: the supervisor-owned global child-id allocator. Its start()/stop()
210
+ // (load persisted high-water marks + the abandoned-reservation sweep) is
211
+ // driven by the seam machinery; its HTTP routes let detached sprint children
212
+ // mint collision-free child ids under a shared parent (constraint C.4).
213
+ const idAllocator = createIdAllocator();
214
+
215
+ // eft.9.2: the supervisor-owned global dolt push mutex -- a LOAD-BEARING v1
216
+ // requirement (PoC constraints C.2/C.3). Every cross-sprint `bd dolt push`
217
+ // serializes through this ONE instance so two sprints never push at the same
218
+ // time; its lease-sweep start()/stop() is driven by the seam machinery, and
219
+ // its HTTP routes let independent detached sprint children acquire/release
220
+ // over the supervisor port. Without this wiring a child's acquire() would
221
+ // POST to an unregistered route (404) and wedge the D-push bracket.
222
+ const doltMutex = createDoltMutex();
223
+
224
+ // eft.4.3: PID-liveness watchdog + four-status classifier. Its
225
+ // resolvePort collaborator maps a sprintId -> the live --viewer-port the
226
+ // spawner allocated for that sprint's still-tracked child pid (undefined
227
+ // once the pid bookkeeping is gone -- classifySprint() already treats an
228
+ // unresolvable port as "cannot verify via HTTP", never as a false
229
+ // "crashed"). This is the one small wiring helper this task needed: every
230
+ // other seam below is a direct construct-and-register of an
231
+ // already-implemented module.
232
+ const resolveSprintPort = (sprintId) => {
233
+ const entry = ledger.get(sprintId);
234
+ if (!entry || entry.childPid == null) return undefined;
235
+ return spawner.getLiveEntry ? spawner.getLiveEntry(entry.childPid)?.port : undefined;
236
+ };
237
+ // apra-fleet-k7b.2: `history` lets the watchdog append a durable
238
+ // FINISHED event (terminalReason/verdict) to sprint-history.json the
239
+ // first time it observes a PID-gone sprint's persisted terminal state,
240
+ // the same collaborator the spawner's CHILD_EXITED wiring above uses.
241
+ const watchdog = createWatchdog({ ledger, resolvePort: resolveSprintPort, history });
242
+
243
+ // eft.6.2: the Backlog-last tree (full tracker minus every active
244
+ // sprint's live-expanded scope). Reused both as the dashboard page's
245
+ // Backlog section (below) AND as GET /api/backlog's real listing (see the
246
+ // sprint controller wiring below), so there is exactly one "what does the
247
+ // tracker minus claimed scope look like right now" implementation.
248
+ const backlog = createBacklog({ ledger, watchdog });
249
+
250
+ // eft.6.1/6.3: the single-page operator dashboard -- Sprint Stack, then
251
+ // Backlog, then the Launch Sprint form (launch-form.mjs attaches itself
252
+ // via dashboard.mjs's renderIndexPageHtml default; see the import comment
253
+ // above for why no separate launch-form seam is constructed here).
254
+ const dashboard = createDashboard({ ledger, watchdog, backlog });
255
+
256
+ // docs/dolt-sync-redesign.md Part 3.3: kill any orphaned ephemeral
257
+ // `dolt sql-server` a mid-settle orchestrator death left behind on a
258
+ // member (settle's own finally covers every other path). Both
259
+ // collaborators use the same short-lived-MCP-connection pattern as
260
+ // listFleetMembers -- the supervisor never holds a standing fleet
261
+ // transport.
262
+ const doltOrphanSweep = createDoltOrphanSweep({
263
+ listMembers: () => listFleetMembers({ resolveConnection: resolveFleetServerConnection }),
264
+ execCommand: ({ member, command }) => executeFleetCommand({ member, command, resolveConnection: resolveFleetServerConnection }),
265
+ });
266
+
267
+ const supervisor = createSupervisor({ port, ledger, spawner, watchdog, dashboard, idAllocator, doltMutex, doltOrphanSweep });
268
+ registerIdAllocatorRoutes(supervisor, idAllocator, { readJsonBody, sendJson });
269
+ registerDoltMutexRoutes(supervisor, doltMutex, { readJsonBody, sendJson });
270
+
271
+ // eft.6.1: GET / -- the Sprint Stack + Backlog + Launch Sprint page.
272
+ registerDashboardRoutes(supervisor, dashboard);
273
+
274
+ // supervisor-viewer-parity: GET /api/backlog/tasks -- the flat,
275
+ // filterable data source the dashboard's Backlog tab re-fetches from
276
+ // client-side on every filter change (see backlog.mjs's
277
+ // backlogPanelClientScript()). Additive to GET /api/backlog below (the
278
+ // sprint controller's older nested-tree shape), not a replacement.
279
+ registerBacklogRoutes(supervisor, backlog);
280
+
281
+ // eft.4.4: the six operator-facing sprint/member/backlog endpoints.
282
+ // listMembers is fleet-backed (fleet-members.mjs opens a short-lived MCP
283
+ // connection per call -- see its module doc for why the supervisor never
284
+ // holds a standing fleet connection); getBacklog reuses the SAME backlog
285
+ // seam constructed above rather than re-deriving "tracker minus claimed
286
+ // scope" a second way. ledger/spawner/history are the same collaborators
287
+ // every other seam in this file shares.
288
+ const listMembersForLaunch = () => listFleetMembers({ resolveConnection: resolveFleetServerConnection });
289
+
290
+ // apra-fleet-k06.1: compose BOTH launch-time overlap guards api.mjs's own
291
+ // header comment (eft.5.2/eft.5.3) already describes as meant to run
292
+ // together. Before this, createSprintController() below was constructed
293
+ // with no `beforeLaunch` override, so it silently fell back to
294
+ // defaultMemberOverlapGuard ALONE -- the issue-scope guard
295
+ // (createScopeGuard, live-expanded subtree overlap) was exercised only by
296
+ // its own unit tests, never wired into the real POST /api/sprints path.
297
+ // Two sprints with disjoint member sets but overlapping/nested issue
298
+ // scopes (e.g. one targets an epic, another one of that epic's children)
299
+ // could both launch and dispatch against the same beads concurrently.
300
+ // See composeBeforeLaunch() above for the composition itself (ordering,
301
+ // error shape) -- extracted as its own export so the composition is
302
+ // directly unit-testable without booting this whole process.
303
+ const memberOverlapGuard = defaultMemberOverlapGuard(ledger, listMembersForLaunch);
304
+ const scopeGuard = createScopeGuard({ ledger });
305
+ const beforeLaunch = composeBeforeLaunch({ memberOverlapGuard, scopeGuard });
306
+
307
+ const sprintController = createSprintController({
308
+ ledger,
309
+ spawner,
310
+ history,
311
+ listMembers: listMembersForLaunch,
312
+ getBacklog: async () => ({ tree: await backlog.buildTree() }),
313
+ beforeLaunch,
314
+ });
315
+ registerSprintRoutes(supervisor, sprintController);
316
+
317
+ // eft.5.4: operator force-release of a wedged reservation.
318
+ registerReservationRoutes(supervisor, reconciler);
319
+
320
+ // eft.6.5: process-free History view. Always renders a finished sprint's
321
+ // persisted old_runs/<sprintId>.json (falling back to the legacy
322
+ // old_sprints/<sprintId>.json, apra-fleet-eft.37.1) through the SAME HTML
323
+ // template the live viewer serves, fed a frozen state object -- no live process, no
324
+ // /state or /events polling, Save/Stop hidden. Constructed before the live
325
+ // proxy below so its renderForSprint() can be wired in as that proxy's
326
+ // history-fallthrough renderer too (see next block).
327
+ const historyView = createHistoryView();
328
+
329
+ // eft.6.4: live-detail reverse proxy at /sprints/:id/live. Resolves each
330
+ // sprint's child --viewer-port from the ledger's childPid + the spawner's
331
+ // live pid->port bookkeeping, proxies HTTP + SSE through the supervisor
332
+ // port, and falls through to the historical view (eft.6.5's full
333
+ // template-based renderer, not just a minimal placeholder) once a sprint
334
+ // finishes -- so the SAME template serves live and history at the SAME
335
+ // URL. A dedicated /sprints/:id/history link (registered below) reaches
336
+ // the identical rendering regardless of whether the sprint is still live.
337
+ const liveProxy = createLiveProxy({ ledger, spawner, renderHistory: (sprintId) => historyView.renderForSprint(sprintId) });
338
+ registerLiveRoutes(supervisor, liveProxy);
339
+ registerHistoryViewRoutes(supervisor, historyView);
340
+
341
+ // apra-fleet-ou7.2: raw per-sprint stdout/stderr log, present for a live
342
+ // sprint AND for an ended one (finished/crashed) -- exactly where the
343
+ // live SSE viewer above is gone. Looks the sprint's recorded logPath up
344
+ // by id (ledger first, then history for a released reservation); never
345
+ // builds a path from the request's :id itself.
346
+ const logView = createLogView({ ledger, history });
347
+ registerLogViewRoutes(supervisor, logView);
348
+
349
+ // GET /supervisor/log -- the supervisor's OWN stdout/stderr (see
350
+ // installSelfLogTee() above), linked from the dashboard header.
351
+ const selfLogView = createSelfLogView({ logPath: selfLog.logPath });
352
+ registerSelfLogRoutes(supervisor, selfLogView);
353
+
354
+ // Explicit signals are the out-of-band way to stop cleanly, complementing
355
+ // the in-band POST /api/shutdown route.
356
+ const onSignal = (sig) => {
357
+ console.log(`[supervisor] received ${sig}`);
358
+ supervisor.stop(`signal:${sig}`).catch((err) => console.error(err));
359
+ };
360
+ process.once('SIGINT', () => onSignal('SIGINT'));
361
+ process.once('SIGTERM', () => onSignal('SIGTERM'));
362
+
363
+ await supervisor.start();
364
+
365
+ // Restart reconciliation (eft.5.4) + re-adoption (eft.4.5): the ledger
366
+ // seam has now loaded from disk. Start the history log, then PID-probe
367
+ // every reloaded entry -- dead children release both axes and are marked
368
+ // aborted-by-restart; live children are retained AND re-adopted (their
369
+ // --viewer-port recovered from the live process's own command line and
370
+ // registered with the spawner seam) so they resume being tracked,
371
+ // watchdog-monitored, and HTTP-reachable exactly like a freshly-spawned
372
+ // child.
373
+ await history.start();
374
+ await readopter.readopt();
375
+
376
+ // Keep the process alive until an explicit shutdown resolves. Awaiting this
377
+ // is what makes `fleet-se serve` "always-on" -- nothing else drives exit.
378
+ await supervisor.shutdownRequested;
379
+ return { exitCode: 0 };
380
+ }
381
+
382
+ function isMainModule() {
383
+ try {
384
+ return process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
385
+ } catch {
386
+ return false;
387
+ }
388
+ }
389
+
390
+ if (isMainModule()) {
391
+ serveMain().then(
392
+ ({ exitCode }) => process.exit(exitCode),
393
+ (err) => { console.error(err); process.exit(1); },
394
+ );
395
+ }
@@ -0,0 +1,178 @@
1
+ // apra-fleet-eft.8.12 (Plan 3.4 git conflict ladder, script-first posture).
2
+ //
3
+ // Tier 0 prevention (exclusive per-sprint branch ownership + rebase-before-
4
+ // push + globally sequential doer streaks, apra-fleet-eft.8.3/8.4) already
5
+ // keeps real content conflicts rare. This module is what runs on the rare
6
+ // occasions Tier 0 does not prevent one:
7
+ //
8
+ // Tier 1 (SCRIPTED, apra-fleet-eft.8.6): confirm from git's OWN
9
+ // `git status --porcelain` output (never inferred from a failing
10
+ // command's exit code/message alone) whether a failed `git pull --rebase`
11
+ // actually left unmerged paths, and if so restore a clean working tree via
12
+ // `git rebase --abort`. Script-only -- no agent is ever dispatched here.
13
+ //
14
+ // Tier 2 (agent-with-runbook, apra-fleet-eft.8.12): a git merge/rebase
15
+ // conflict is BY CONSTRUCTION a same-line (or same-hunk) overlap -- git's
16
+ // own three-way merge already auto-resolves every non-overlapping change
17
+ // silently; conflict markers only ever appear for the overlapping
18
+ // remainder a fixed, mechanical ours/theirs policy cannot arbitrate
19
+ // (blindly preferring one side always risks silently discarding the
20
+ // other's real work). So Tier 1 finding `unmergedPaths.length > 0` IS the
21
+ // single, documented Tier 1 -> Tier 2 escalation point: dispatch an
22
+ // agent, armed with an explicit runbook describing exactly which files are
23
+ // conflicted, to re-attempt the rebase and resolve those files with actual
24
+ // judgment. The agent's own claim is never trusted -- see
25
+ // runner.js's syncMemberAfter Tier 2 call site for the mechanical
26
+ // re-verification (clean porcelain + a real successful re-push) that
27
+ // decides whether Tier 2 actually succeeded.
28
+
29
+ /**
30
+ * Two-letter `git status --porcelain` XY codes git reserves EXCLUSIVELY for
31
+ * an unresolved merge/rebase conflict (see `git status` docs). Used by
32
+ * parseUnmergedPaths() below to prove an ACTUAL conflict from git's own
33
+ * working-tree state, never inferred from a failing command's exit
34
+ * code/message alone.
35
+ */
36
+ const UNMERGED_STATUS_CODES = new Set(['DD', 'AU', 'UD', 'UA', 'DU', 'AA', 'UU']);
37
+
38
+ /**
39
+ * Parses `git status --porcelain` output and returns the paths whose XY
40
+ * status code marks them as unmerged (conflicted). Any other status
41
+ * (staged/modified/untracked/etc.) is deliberately ignored -- only these
42
+ * codes are unambiguous proof of an in-progress conflict.
43
+ *
44
+ * @param {string} porcelainOutput
45
+ * @returns {string[]}
46
+ */
47
+ export function parseUnmergedPaths(porcelainOutput) {
48
+ const text = String(porcelainOutput == null ? '' : porcelainOutput);
49
+ const paths = [];
50
+ for (const line of text.split('\n')) {
51
+ if (!line) continue;
52
+ const code = line.slice(0, 2);
53
+ if (UNMERGED_STATUS_CODES.has(code)) {
54
+ paths.push(line.slice(3).trim());
55
+ }
56
+ }
57
+ return paths;
58
+ }
59
+
60
+ /**
61
+ * Tier 1 SCRIPTED conflict detection + clean-state restore. Called only
62
+ * after a `git pull --rebase` command has already failed (its exit code is
63
+ * why we're here at all). Never trusts that failing command's own exit
64
+ * code/message classification alone to decide whether a rebase is actually
65
+ * mid-conflict -- confirms via git's OWN porcelain status first (a rebase
66
+ * that failed for some other, non-conflict reason before ever touching the
67
+ * tree has nothing to abort). If unmerged paths ARE found, runs
68
+ * `git rebase --abort` to restore a clean working tree, then re-checks
69
+ * porcelain to confirm the abort actually worked (a loud log warning, never
70
+ * a second thrown error, if it somehow did not). Script-only: no agent is
71
+ * ever dispatched here -- the caller decides whether to escalate to Tier 2
72
+ * based on the returned unmerged paths.
73
+ *
74
+ * `runGitStep` is dependency-injected (rather than duplicated here) so this
75
+ * module stays git-primitive-only and shares runner.js's single transient-
76
+ * retry/classification implementation.
77
+ *
78
+ * @param {{
79
+ * command: Function, member: string, log: Function,
80
+ * maxTransientRetries: number, runGitStep: Function,
81
+ * }} opts
82
+ * @returns {Promise<string[]>} unmerged paths found (empty array if none)
83
+ */
84
+ export async function detectAndAbortRebaseConflict({ command, member, log, maxTransientRetries, runGitStep }) {
85
+ const statusBefore = await runGitStep({
86
+ command, member, cmd: 'git status --porcelain',
87
+ label: `rebase-conflict status check for '${member}'`, log, maxTransientRetries,
88
+ });
89
+ const unmergedPaths = parseUnmergedPaths(statusBefore.output);
90
+ if (unmergedPaths.length === 0) {
91
+ return unmergedPaths;
92
+ }
93
+
94
+ log(`[Sync] G-push pull-rebase for member '${member}' left unmerged path(s) (${unmergedPaths.join(', ')}) -- running 'git rebase --abort' to restore a clean working tree (Tier 1, script-only; no agent dispatched).`);
95
+ await command('git rebase --abort', { member_name: member, silent: true, failSoft: true, label: `G-push rebase --abort for '${member}'` });
96
+
97
+ const statusAfter = await command('git status --porcelain', { member_name: member, silent: true, failSoft: true, label: `post-abort clean-state check for '${member}'` });
98
+ const remaining = statusAfter && statusAfter.output ? String(statusAfter.output).trim() : '';
99
+ if (remaining !== '') {
100
+ log(`[Sync] WARNING: 'git rebase --abort' for member '${member}' did not fully restore a clean working tree -- porcelain still shows: ${remaining}`);
101
+ }
102
+
103
+ return unmergedPaths;
104
+ }
105
+
106
+ /**
107
+ * Builds the self-contained Tier 2 runbook prompt: exactly which files are
108
+ * conflicted, and a fixed sequence of steps to resolve them with real
109
+ * judgment rather than a blind ours/theirs rule. ASCII-only per project
110
+ * convention.
111
+ *
112
+ * @param {{ member: string, branch: string, unmergedPaths: string[], remote?: string }} opts
113
+ * @returns {string}
114
+ */
115
+ export function buildConflictResolutionRunbookPrompt({ member, branch, unmergedPaths, remote = 'origin' }) {
116
+ const fileList = unmergedPaths.map((p) => ` - ${p}`).join('\n');
117
+ return [
118
+ 'GIT CONFLICT RESOLUTION RUNBOOK (Tier 2 of the git conflict ladder).',
119
+ '',
120
+ `A scripted 'git pull --rebase ${remote} ${branch}' on member '${member}' left the ` +
121
+ 'following file(s) with real, same-line/same-hunk merge conflicts that a fixed ' +
122
+ 'mechanical ours/theirs policy cannot arbitrate (git already auto-merges every ' +
123
+ 'non-overlapping change -- these are what is left over):',
124
+ fileList,
125
+ '',
126
+ 'Follow these steps exactly, in order:',
127
+ `1. Run 'git status' to confirm you are mid-rebase with the conflicted file(s) above.`,
128
+ ' If the working tree is already clean (no conflict markers), the conflict was',
129
+ ' already resolved by a prior attempt -- skip to step 5.',
130
+ '2. Open each conflicted file and resolve the <<<<<<< / ======= / >>>>>>> markers by',
131
+ ' understanding BOTH sides of the change and combining them correctly -- never',
132
+ ' blindly delete one side. Preserve the intent of both changes wherever they are',
133
+ ' not truly mutually exclusive; when they are mutually exclusive, prefer the',
134
+ ' version that keeps the codebase buildable and consistent with its surrounding',
135
+ ' code, and note your reasoning.',
136
+ `3. Stage the resolved file(s) with 'git add' and run 'git rebase --continue' ` +
137
+ '(repeat if the rebase has more than one commit to replay).',
138
+ '4. Run the project build/lint/unit tests for the affected area and fix any breakage',
139
+ ' your resolution introduced before proceeding.',
140
+ `5. Run 'git push ${remote} ${branch}' to publish the resolved, clean tree.`,
141
+ '',
142
+ 'Do not run any `bd` command and do not touch beads in any way -- this is a pure git',
143
+ 'conflict-resolution dispatch, not a development streak.',
144
+ ].join('\n');
145
+ }
146
+
147
+ /**
148
+ * Tier 2: dispatches an agent, armed with the runbook above, to resolve a
149
+ * real (same-line/same-hunk) merge conflict Tier 1 could not mechanically
150
+ * arbitrate. This function only DISPATCHES -- it deliberately does not
151
+ * itself decide whether the attempt succeeded; the caller (runner.js's
152
+ * syncMemberAfter) re-verifies success mechanically afterwards (clean
153
+ * porcelain + an actual successful re-push), exactly like Tier 1 never
154
+ * trusts a failing command's own message alone. Bounded: exactly one Tier 2
155
+ * attempt per conflict -- a genuinely unresolvable conflict still fails
156
+ * after this, rather than looping indefinitely (script-first posture: no
157
+ * unbounded agent escalation).
158
+ *
159
+ * @param {{
160
+ * agent: Function, member: string, branch: string, unmergedPaths: string[],
161
+ * log?: Function, model?: string, remote?: string,
162
+ * }} opts
163
+ * @returns {Promise<unknown>} whatever the injected agent() call resolves to
164
+ */
165
+ export async function dispatchConflictResolutionAgent({ agent, member, branch, unmergedPaths, log = () => {}, model, remote = 'origin' }) {
166
+ if (typeof agent !== 'function') {
167
+ throw new Error('dispatchConflictResolutionAgent requires an injected agent() in opts');
168
+ }
169
+ log(`[Sync] Tier 2: dispatching a conflict-resolution runbook to member '${member}' for unmerged path(s) [${unmergedPaths.join(', ')}] -- the one documented ladder step above scripted ours/theirs.`);
170
+ const prompt = buildConflictResolutionRunbookPrompt({ member, branch, unmergedPaths, remote });
171
+ return agent(prompt, {
172
+ member_name: member,
173
+ label: `Tier 2 conflict resolution [${unmergedPaths.join(', ')}]`,
174
+ model,
175
+ timeout_s: 1800,
176
+ max_total_s: 1800,
177
+ });
178
+ }