@apralabs/apra-fleet 0.3.6 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,711 @@
1
+ /**
2
+ * Hub HTTP server (apra-fleet-us9.4): wires the already-tested data layer
3
+ * (members.ts, machines.ts, workspaces.ts, projects.ts, member-view.ts,
4
+ * project-view.ts) into the routes from packages/fleet-api-contract's
5
+ * Endpoints map that don't require human-user OAuth (apra-fleet-us9.16,
6
+ * not yet built) -- currently GET/POST /ws/:id/members, GET/POST
7
+ * /ws/:id/projects, PATCH/DELETE /ws/:id/projects/:pid, POST
8
+ * /ws/:id/projects/:pid/members, and GET /installers.
9
+ *
10
+ * Auth: a Bearer JWT (hub-jwt.ts -- an MVP stopgap; apra-fleet-us9.5 owns
11
+ * the real cloud-issuance design) whose `workspace_id` claim must match the
12
+ * `:id` path param. This is the same "iron wall" pattern used throughout
13
+ * the local server (session-registry.ts, jwt.ts): a token for workspace A
14
+ * can never act on workspace B's resources, and a mismatch is
15
+ * indistinguishable from "not authorized" -- it never leaks whether the
16
+ * target workspace exists.
17
+ *
18
+ * GET member/project list endpoints return the full dashboard-facing
19
+ * view-models (member-view.ts/project-view.ts, contract-validated); POST
20
+ * returns the raw created row (creation doesn't need the joined view --
21
+ * there's no presence/other-relation state to join yet for a brand-new row).
22
+ */
23
+ import http from 'node:http';
24
+ import crypto from 'node:crypto';
25
+ import { RoleSchema } from '@apralabs/fleet-api-contract';
26
+ import { verify as verifyHubJwt, sign as signHubJwt } from './hub-jwt.js';
27
+ import { createMember, listMembers } from './members.js';
28
+ import { listMemberViews, getMemberView } from './member-view.js';
29
+ import { createProject, updateProject, deleteProject, addProjectMember, listProjects } from './projects.js';
30
+ import { listProjectViews } from './project-view.js';
31
+ import { getCostResponse } from './usage.js';
32
+ import { getActivityFeed } from './activity.js';
33
+ import { issueMemberToken, rotateMemberToken } from './member-tokens.js';
34
+ import { isRevoked } from './jwt-revocation.js';
35
+ import { getInstallersHandler } from './handlers/installers.js';
36
+ import { signSession, verifySession } from './session-jwt.js';
37
+ import { findOrCreateUser, getUser, listUsers, approveUser, updateUserRole, deleteUser, listUserWorkspaceIds, hasWorkspaceAccess, } from './users.js';
38
+ import { getWorkspace } from './workspaces.js';
39
+ import { generateEnrollmentToken, exchangeEnrollmentToken } from './enrollment.js';
40
+ import { submitEnvelope } from './envelope-routes.js';
41
+ import { ack as ackRelay, fetchDeliverable } from './relay-queue.js';
42
+ import { listForMachine } from './presence.js';
43
+ import { getPool } from './db/pool.js';
44
+ /** apra-fleet-b55: how often the SSE stream route polls relay_queue for
45
+ * anything newly deliverable to a member on this machine. */
46
+ const STREAM_POLL_INTERVAL_MS = 1000;
47
+ /** Verifies the bearer token, its workspace match, AND that its jti hasn't
48
+ * been revoked (apra-fleet-us9.5: rotation revokes the prior token's jti,
49
+ * so a caller still holding it must be rejected immediately, not just
50
+ * once it naturally expires). */
51
+ async function authorize(req, workspaceId) {
52
+ const token = extractBearer(req);
53
+ const claims = token ? verifyHubJwt(token) : null;
54
+ if (!claims || claims.ws !== workspaceId)
55
+ return null;
56
+ if (await isRevoked(claims.jti))
57
+ return null;
58
+ return claims;
59
+ }
60
+ /** Verifies a dashboard OAuth session token (apra-fleet-us9.16) and its
61
+ * revocation status. Identity-only -- no workspace_id, see session-jwt.ts. */
62
+ async function authorizeSession(req) {
63
+ const token = extractBearer(req);
64
+ const claims = token ? verifySession(token) : null;
65
+ if (!claims)
66
+ return null;
67
+ if (await isRevoked(claims.jti))
68
+ return null;
69
+ return claims;
70
+ }
71
+ /**
72
+ * A session token's user must be status='approved' AND is_platform_admin
73
+ * to reach /admin/users/* -- both checked here, not just token validity.
74
+ * A pending/rejected user must never reach a real route just because a
75
+ * session token exists (docs/dashboard-oauth-rbac-design.md section 3).
76
+ */
77
+ async function requirePlatformAdmin(req) {
78
+ const session = await authorizeSession(req);
79
+ if (!session)
80
+ return null;
81
+ const user = await getUser(session.sub);
82
+ if (!user || user.status !== 'approved' || !user.is_platform_admin)
83
+ return null;
84
+ return user;
85
+ }
86
+ function secondsSince(iso) {
87
+ return Math.max(0, Math.floor((Date.now() - new Date(iso).getTime()) / 1000));
88
+ }
89
+ function sendJson(res, status, body) {
90
+ const text = JSON.stringify(body);
91
+ res.writeHead(status, { 'Content-Type': 'application/json' });
92
+ res.end(text);
93
+ }
94
+ function parseBody(req) {
95
+ return new Promise((resolve, reject) => {
96
+ const chunks = [];
97
+ req.on('data', (chunk) => chunks.push(chunk));
98
+ req.on('end', () => {
99
+ try {
100
+ const text = Buffer.concat(chunks).toString('utf8');
101
+ resolve(text ? JSON.parse(text) : undefined);
102
+ }
103
+ catch (err) {
104
+ reject(err);
105
+ }
106
+ });
107
+ req.on('error', reject);
108
+ });
109
+ }
110
+ function extractBearer(req) {
111
+ const auth = req.headers.authorization;
112
+ if (!auth?.startsWith('Bearer '))
113
+ return null;
114
+ return auth.slice(7);
115
+ }
116
+ export function createHttpServer() {
117
+ const server = http.createServer(async (req, res) => {
118
+ const url = new URL(req.url ?? '/', 'http://localhost');
119
+ const segments = url.pathname.split('/').filter(Boolean);
120
+ if (url.pathname === '/health' && req.method === 'GET') {
121
+ sendJson(res, 200, { status: 'ok' });
122
+ return;
123
+ }
124
+ if (url.pathname === '/installers' && req.method === 'GET') {
125
+ sendJson(res, 200, getInstallersHandler());
126
+ return;
127
+ }
128
+ // /ws/:id/members
129
+ if (segments[0] === 'ws' && segments[2] === 'members' && segments.length === 3) {
130
+ const workspaceId = segments[1];
131
+ if (!(await authorize(req, workspaceId))) {
132
+ sendJson(res, 401, { error: 'unauthorized' });
133
+ return;
134
+ }
135
+ if (req.method === 'GET') {
136
+ const members = await listMemberViews(workspaceId);
137
+ sendJson(res, 200, members);
138
+ return;
139
+ }
140
+ if (req.method === 'POST') {
141
+ let body;
142
+ try {
143
+ body = await parseBody(req);
144
+ }
145
+ catch {
146
+ sendJson(res, 400, { error: 'invalid JSON body' });
147
+ return;
148
+ }
149
+ const input = body;
150
+ if (typeof input?.name !== 'string' || typeof input?.provider !== 'string') {
151
+ sendJson(res, 400, { error: 'name and provider are required' });
152
+ return;
153
+ }
154
+ const created = await createMember(crypto.randomUUID(), workspaceId, {
155
+ name: input.name,
156
+ provider: input.provider,
157
+ workFolder: typeof input.folder === 'string' ? input.folder : null,
158
+ });
159
+ // Matches MemberTokenResponseSchema: {member, jwt} -- the jwt is
160
+ // shown exactly once at issuance, never re-returned by any GET.
161
+ const jwt = await issueMemberToken(workspaceId, created.id);
162
+ const memberView = await getMemberView(workspaceId, created.id);
163
+ sendJson(res, 201, { member: memberView, jwt });
164
+ return;
165
+ }
166
+ }
167
+ // /ws/:id/members/:mid/rotate
168
+ if (segments[0] === 'ws' && segments[2] === 'members' && segments[4] === 'rotate' && segments.length === 5 && req.method === 'POST') {
169
+ const workspaceId = segments[1];
170
+ const memberId = segments[3];
171
+ if (!(await authorize(req, workspaceId))) {
172
+ sendJson(res, 401, { error: 'unauthorized' });
173
+ return;
174
+ }
175
+ const jwt = await rotateMemberToken(workspaceId, memberId);
176
+ if (!jwt) {
177
+ sendJson(res, 404, { error: 'member not found' });
178
+ return;
179
+ }
180
+ const memberView = await getMemberView(workspaceId, memberId);
181
+ sendJson(res, 200, { member: memberView, jwt });
182
+ return;
183
+ }
184
+ // /ws/:id/stream (apra-fleet-b55: hub -> spoke SSE delivery push,
185
+ // docs/hub-spoke-wire-protocol.md section 5 step 4). One stream per
186
+ // machine JWT; polls every POLL_INTERVAL_MS for anything deliverable to
187
+ // any member currently announced (presence.ts) on this machine.
188
+ if (segments[0] === 'ws' && segments[2] === 'stream' && segments.length === 3 && req.method === 'GET') {
189
+ const workspaceId = segments[1];
190
+ const claims = await authorize(req, workspaceId);
191
+ if (!claims) {
192
+ sendJson(res, 401, { error: 'unauthorized' });
193
+ return;
194
+ }
195
+ const machineId = claims.sub;
196
+ res.writeHead(200, {
197
+ 'Content-Type': 'text/event-stream',
198
+ 'Cache-Control': 'no-cache',
199
+ Connection: 'keep-alive',
200
+ });
201
+ // Flush the 200 + SSE headers to the client on connect, before any event
202
+ // exists to deliver -- otherwise Node buffers the headers until the first
203
+ // res.write(), so a client (or reverse proxy) cannot confirm the stream
204
+ // actually opened for a member that currently has nothing queued.
205
+ res.flushHeaders();
206
+ const pool = getPool();
207
+ let closed = false;
208
+ const poll = async () => {
209
+ if (closed)
210
+ return;
211
+ const members = await listForMachine(machineId, pool);
212
+ for (const m of members) {
213
+ // Iron wall (apra-fleet-us9.11): scope the deliverable read by the
214
+ // JWT-verified workspaceId, NOT by presence membership alone -- a
215
+ // spoke can announce an arbitrary member_id, so presence is not a
216
+ // trust boundary. fetchDeliverable's workspace_id filter guarantees
217
+ // a spoke authenticated for workspace A can never drain another
218
+ // tenant's queue even if it injects a foreign member_id.
219
+ const deliverable = await fetchDeliverable(workspaceId, m.member_id, pool);
220
+ for (const envelope of deliverable) {
221
+ if (closed)
222
+ return;
223
+ res.write(`data: ${JSON.stringify(envelope)}\n\n`);
224
+ }
225
+ }
226
+ };
227
+ const timer = setInterval(() => { poll().catch(() => { }); }, STREAM_POLL_INTERVAL_MS);
228
+ req.on('close', () => {
229
+ closed = true;
230
+ clearInterval(timer);
231
+ });
232
+ await poll();
233
+ return;
234
+ }
235
+ // /ws/:id/envelopes (apra-fleet-us9.6 slice 1: wire-protocol envelope
236
+ // submission -- docs/hub-spoke-wire-protocol.md section 2/5).
237
+ if (segments[0] === 'ws' && segments[2] === 'envelopes' && segments.length === 3 && req.method === 'POST') {
238
+ const workspaceId = segments[1];
239
+ const claims = await authorize(req, workspaceId);
240
+ if (!claims) {
241
+ sendJson(res, 401, { error: 'unauthorized' });
242
+ return;
243
+ }
244
+ let body;
245
+ try {
246
+ body = await parseBody(req);
247
+ }
248
+ catch {
249
+ sendJson(res, 400, { error: 'invalid JSON body' });
250
+ return;
251
+ }
252
+ const env = body;
253
+ if (typeof env?.envelope_id !== 'string' || typeof env?.workspace_id !== 'string' || typeof env?.kind !== 'string') {
254
+ sendJson(res, 400, { error: 'envelope_id, workspace_id, and kind are required' });
255
+ return;
256
+ }
257
+ const result = await submitEnvelope(claims, env, getPool());
258
+ sendJson(res, result.status, result.body);
259
+ return;
260
+ }
261
+ // /ws/:id/ack (docs/hub-spoke-wire-protocol.md section 5 step 4 --
262
+ // a plain ack, not itself an envelope subject to its own delivery
263
+ // guarantees).
264
+ if (segments[0] === 'ws' && segments[2] === 'ack' && segments.length === 3 && req.method === 'POST') {
265
+ const workspaceId = segments[1];
266
+ const claims = await authorize(req, workspaceId);
267
+ if (!claims) {
268
+ sendJson(res, 401, { error: 'unauthorized' });
269
+ return;
270
+ }
271
+ let body;
272
+ try {
273
+ body = await parseBody(req);
274
+ }
275
+ catch {
276
+ sendJson(res, 400, { error: 'invalid JSON body' });
277
+ return;
278
+ }
279
+ // member_id is required explicitly: the JWT is per-machine, not
280
+ // per-member (wire-protocol.md section 2 -- "one long-lived channel
281
+ // per spoke... multiplexed by member_id inside the envelope"), so the
282
+ // machine's own claims.sub is not necessarily the envelope's
283
+ // target member.
284
+ const { envelope_id: envelopeId, member_id: memberId } = body ?? {};
285
+ if (typeof envelopeId !== 'string' || typeof memberId !== 'string') {
286
+ sendJson(res, 400, { error: 'envelope_id and member_id are required' });
287
+ return;
288
+ }
289
+ // apra-fleet-us9.11.1: verify memberId is actually hosted on the
290
+ // CALLING machine before acking -- otherwise a spoke could retire
291
+ // (suppress delivery of) an envelope addressed to a different
292
+ // member in the same workspace, one it doesn't host, by just
293
+ // guessing/knowing that member's id.
294
+ const hostedMembers = await listForMachine(claims.sub, getPool());
295
+ if (!hostedMembers.some((m) => m.member_id === memberId)) {
296
+ sendJson(res, 403, { error: 'member_id is not hosted on the calling machine' });
297
+ return;
298
+ }
299
+ await ackRelay(workspaceId, memberId, envelopeId, getPool());
300
+ sendJson(res, 200, { acked: true });
301
+ return;
302
+ }
303
+ // /ws/:id/projects
304
+ if (segments[0] === 'ws' && segments[2] === 'projects' && segments.length === 3) {
305
+ const workspaceId = segments[1];
306
+ if (!(await authorize(req, workspaceId))) {
307
+ sendJson(res, 401, { error: 'unauthorized' });
308
+ return;
309
+ }
310
+ if (req.method === 'GET') {
311
+ sendJson(res, 200, await listProjectViews(workspaceId));
312
+ return;
313
+ }
314
+ if (req.method === 'POST') {
315
+ let body;
316
+ try {
317
+ body = await parseBody(req);
318
+ }
319
+ catch {
320
+ sendJson(res, 400, { error: 'invalid JSON body' });
321
+ return;
322
+ }
323
+ const input = body;
324
+ if (typeof input?.name !== 'string') {
325
+ sendJson(res, 400, { error: 'name is required' });
326
+ return;
327
+ }
328
+ const created = await createProject(crypto.randomUUID(), workspaceId, {
329
+ name: input.name,
330
+ description: typeof input.desc === 'string' ? input.desc : undefined,
331
+ memberIds: Array.isArray(input.members) ? input.members.filter((m) => typeof m === 'string') : undefined,
332
+ });
333
+ sendJson(res, 201, created);
334
+ return;
335
+ }
336
+ }
337
+ // /ws/:id/projects/:pid
338
+ if (segments[0] === 'ws' && segments[2] === 'projects' && segments.length === 4) {
339
+ const workspaceId = segments[1];
340
+ const projectId = segments[3];
341
+ if (!(await authorize(req, workspaceId))) {
342
+ sendJson(res, 401, { error: 'unauthorized' });
343
+ return;
344
+ }
345
+ if (req.method === 'PATCH') {
346
+ let body;
347
+ try {
348
+ body = await parseBody(req);
349
+ }
350
+ catch {
351
+ sendJson(res, 400, { error: 'invalid JSON body' });
352
+ return;
353
+ }
354
+ const input = body;
355
+ const updated = await updateProject(workspaceId, projectId, {
356
+ name: typeof input?.name === 'string' ? input.name : undefined,
357
+ description: typeof input?.desc === 'string' ? input.desc : undefined,
358
+ status: input?.status === 'active' || input?.status === 'paused' ? input.status : undefined,
359
+ });
360
+ if (!updated) {
361
+ sendJson(res, 404, { error: 'project not found' });
362
+ return;
363
+ }
364
+ sendJson(res, 200, updated);
365
+ return;
366
+ }
367
+ if (req.method === 'DELETE') {
368
+ const deleted = await deleteProject(workspaceId, projectId);
369
+ if (!deleted) {
370
+ sendJson(res, 404, { error: 'project not found' });
371
+ return;
372
+ }
373
+ sendJson(res, 200, { ok: true });
374
+ return;
375
+ }
376
+ }
377
+ // /ws/:id/projects/:pid/members
378
+ if (segments[0] === 'ws' && segments[2] === 'projects' && segments[4] === 'members' && segments.length === 5 && req.method === 'POST') {
379
+ const workspaceId = segments[1];
380
+ const projectId = segments[3];
381
+ if (!(await authorize(req, workspaceId))) {
382
+ sendJson(res, 401, { error: 'unauthorized' });
383
+ return;
384
+ }
385
+ let body;
386
+ try {
387
+ body = await parseBody(req);
388
+ }
389
+ catch {
390
+ sendJson(res, 400, { error: 'invalid JSON body' });
391
+ return;
392
+ }
393
+ const input = body;
394
+ if (typeof input?.memberId !== 'string') {
395
+ sendJson(res, 400, { error: 'memberId is required' });
396
+ return;
397
+ }
398
+ const added = await addProjectMember(workspaceId, projectId, input.memberId);
399
+ if (!added) {
400
+ sendJson(res, 404, { error: 'project not found' });
401
+ return;
402
+ }
403
+ const view = await listProjectViews(workspaceId);
404
+ sendJson(res, 200, view.find(p => p.id === projectId));
405
+ return;
406
+ }
407
+ // /ws/:id/cost
408
+ if (segments[0] === 'ws' && segments[2] === 'cost' && segments.length === 3 && req.method === 'GET') {
409
+ const workspaceId = segments[1];
410
+ if (!(await authorize(req, workspaceId))) {
411
+ sendJson(res, 401, { error: 'unauthorized' });
412
+ return;
413
+ }
414
+ sendJson(res, 200, await getCostResponse(workspaceId));
415
+ return;
416
+ }
417
+ // /ws/:id/activity
418
+ if (segments[0] === 'ws' && segments[2] === 'activity' && segments.length === 3 && req.method === 'GET') {
419
+ const workspaceId = segments[1];
420
+ if (!(await authorize(req, workspaceId))) {
421
+ sendJson(res, 401, { error: 'unauthorized' });
422
+ return;
423
+ }
424
+ sendJson(res, 200, await getActivityFeed(workspaceId));
425
+ return;
426
+ }
427
+ // POST /auth/oauth/:provider (apra-fleet-us9.16)
428
+ // Stub identity resolution: the actual Google/Microsoft OAuth token
429
+ // exchange (redirect handling, CSRF/state, library choice) is
430
+ // deliberately out of scope here -- see
431
+ // docs/dashboard-oauth-rbac-design.md section 5 ("well-trodden ground").
432
+ // The body is treated as an ALREADY-VERIFIED identity from that
433
+ // exchange ({oauthSubject, email, name}); wiring in a real OAuth
434
+ // library replaces only this body-parsing step, not the RBAC state
435
+ // machine below it.
436
+ if (segments[0] === 'auth' && segments[1] === 'oauth' && segments.length === 3 && req.method === 'POST') {
437
+ const provider = segments[2];
438
+ if (provider !== 'google' && provider !== 'microsoft') {
439
+ sendJson(res, 400, { error: 'unsupported provider' });
440
+ return;
441
+ }
442
+ let body;
443
+ try {
444
+ body = await parseBody(req);
445
+ }
446
+ catch {
447
+ sendJson(res, 400, { error: 'invalid JSON body' });
448
+ return;
449
+ }
450
+ const input = body;
451
+ if (typeof input?.oauthSubject !== 'string' || typeof input?.email !== 'string' || typeof input?.name !== 'string') {
452
+ sendJson(res, 400, { error: 'oauthSubject, email, and name are required' });
453
+ return;
454
+ }
455
+ const user = await findOrCreateUser(crypto.randomUUID(), provider, input.oauthSubject, input.email, input.name);
456
+ const { token } = signSession(user.id);
457
+ sendJson(res, 200, { jwt: token });
458
+ return;
459
+ }
460
+ // GET /workspaces (apra-fleet-us9.16): session token only, no :id --
461
+ // lists every workspace this user has access to. A pending/unassigned
462
+ // user gets an empty array, not an error (a legitimate, non-error
463
+ // state per the design doc).
464
+ if (segments[0] === 'workspaces' && segments.length === 1 && req.method === 'GET') {
465
+ const session = await authorizeSession(req);
466
+ if (!session) {
467
+ sendJson(res, 401, { error: 'unauthorized' });
468
+ return;
469
+ }
470
+ const user = await getUser(session.sub);
471
+ if (!user || user.status !== 'approved') {
472
+ sendJson(res, 200, []);
473
+ return;
474
+ }
475
+ const workspaceIds = await listUserWorkspaceIds(user.id);
476
+ const result = [];
477
+ for (const id of workspaceIds) {
478
+ const ws = await getWorkspace(id);
479
+ if (!ws)
480
+ continue;
481
+ const [members, projects] = await Promise.all([listMembers(id), listProjects(id)]);
482
+ result.push({ id: ws.id, name: ws.name, role: user.role, members: members.length, projects: projects.length });
483
+ }
484
+ sendJson(res, 200, result);
485
+ return;
486
+ }
487
+ // POST /workspaces/:id/select (apra-fleet-us9.16 addition, not in the
488
+ // strict Endpoints contract map -- a pragmatic bridge the design doc's
489
+ // flow needed but the contract didn't name): exchanges a session token
490
+ // + workspace access for a workspace-scoped token that authenticates
491
+ // every /ws/:id/... route already built. Reuses hub-jwt.ts's now-
492
+ // reconciled claim shape (sub/ws/role, matching JWTClaimsSchema
493
+ // field-for-field -- see hub-jwt.ts's header comment). This is the ONE
494
+ // hub-jwt sign() call site whose `role` value is actually a dashboard
495
+ // RBAC role (apra-fleet-y2f): `user.role` is typed `UserRole`
496
+ // ('member'|'admin'|'superadmin', identical to the contract's
497
+ // RoleSchema), so it's already contract-valid by construction, but the
498
+ // explicit RoleSchema.parse below is defense-in-depth against that
499
+ // constraint ever loosening silently -- member-tokens.ts's 'doer' and
500
+ // enrollment.ts's 'spoke' are a DIFFERENT, deliberately-not-contract-
501
+ // bound vocabulary for agent/machine tokens, not a drift bug.
502
+ if (segments[0] === 'workspaces' && segments.length === 3 && segments[2] === 'select' && req.method === 'POST') {
503
+ const workspaceId = segments[1];
504
+ const session = await authorizeSession(req);
505
+ if (!session) {
506
+ sendJson(res, 401, { error: 'unauthorized' });
507
+ return;
508
+ }
509
+ const user = await getUser(session.sub);
510
+ if (!user || user.status !== 'approved' || !user.role) {
511
+ sendJson(res, 401, { error: 'unauthorized' });
512
+ return;
513
+ }
514
+ if (!(await hasWorkspaceAccess(user.id, workspaceId))) {
515
+ // Same non-leaking shape as every other auth mismatch in this file:
516
+ // "not assigned to this workspace" is indistinguishable from
517
+ // "workspace doesn't exist" or "wrong token".
518
+ sendJson(res, 401, { error: 'unauthorized' });
519
+ return;
520
+ }
521
+ const roleCheck = RoleSchema.safeParse(user.role);
522
+ if (!roleCheck.success) {
523
+ sendJson(res, 500, { error: 'user role does not match the published contract' });
524
+ return;
525
+ }
526
+ const { token } = signHubJwt({ sub: user.id, ws: workspaceId, role: roleCheck.data });
527
+ sendJson(res, 200, { jwt: token });
528
+ return;
529
+ }
530
+ // /admin/users (apra-fleet-us9.16): platform-admin only. A non-
531
+ // platform-admin (including a superadmin of just one workspace) gets
532
+ // the exact same 401 as an invalid token -- never leaks that the
533
+ // route exists or that other users do.
534
+ if (segments[0] === 'admin' && segments[1] === 'users' && segments.length === 2 && req.method === 'GET') {
535
+ if (!(await requirePlatformAdmin(req))) {
536
+ sendJson(res, 401, { error: 'unauthorized' });
537
+ return;
538
+ }
539
+ const users = await listUsers();
540
+ const result = await Promise.all(users.map(async (u) => ({
541
+ id: u.id,
542
+ name: u.name,
543
+ email: u.email,
544
+ provider: u.oauth_provider,
545
+ status: u.status,
546
+ role: u.role ?? undefined,
547
+ workspaces: await listUserWorkspaceIds(u.id),
548
+ signedUpAt: secondsSince(u.created_at),
549
+ lastLoginAt: u.last_login_at ? secondsSince(u.last_login_at) : null,
550
+ })));
551
+ sendJson(res, 200, result);
552
+ return;
553
+ }
554
+ // PUT /admin/users/:id/approve
555
+ if (segments[0] === 'admin' && segments[1] === 'users' && segments[3] === 'approve' && segments.length === 4 && req.method === 'PUT') {
556
+ if (!(await requirePlatformAdmin(req))) {
557
+ sendJson(res, 401, { error: 'unauthorized' });
558
+ return;
559
+ }
560
+ const targetUserId = segments[2];
561
+ let body;
562
+ try {
563
+ body = await parseBody(req);
564
+ }
565
+ catch {
566
+ sendJson(res, 400, { error: 'invalid JSON body' });
567
+ return;
568
+ }
569
+ const input = body;
570
+ if (input?.role !== 'member' && input?.role !== 'admin' && input?.role !== 'superadmin') {
571
+ sendJson(res, 400, { error: 'role must be one of member, admin, superadmin' });
572
+ return;
573
+ }
574
+ const workspaceIds = Array.isArray(input.workspaces) ? input.workspaces.filter((w) => typeof w === 'string') : [];
575
+ const updated = await approveUser(targetUserId, input.role, workspaceIds);
576
+ if (!updated) {
577
+ sendJson(res, 404, { error: 'user not found' });
578
+ return;
579
+ }
580
+ sendJson(res, 200, {
581
+ id: updated.id, name: updated.name, email: updated.email, provider: updated.oauth_provider,
582
+ status: updated.status, role: updated.role, workspaces: await listUserWorkspaceIds(updated.id),
583
+ signedUpAt: secondsSince(updated.created_at), lastLoginAt: updated.last_login_at ? secondsSince(updated.last_login_at) : null,
584
+ });
585
+ return;
586
+ }
587
+ // PUT /admin/users/:id/role -- a platform-admin gate independent of any
588
+ // per-workspace role (a member-role user cannot reach this route at
589
+ // all, regardless of what role they hold anywhere).
590
+ if (segments[0] === 'admin' && segments[1] === 'users' && segments[3] === 'role' && segments.length === 4 && req.method === 'PUT') {
591
+ if (!(await requirePlatformAdmin(req))) {
592
+ sendJson(res, 401, { error: 'unauthorized' });
593
+ return;
594
+ }
595
+ const targetUserId = segments[2];
596
+ let body;
597
+ try {
598
+ body = await parseBody(req);
599
+ }
600
+ catch {
601
+ sendJson(res, 400, { error: 'invalid JSON body' });
602
+ return;
603
+ }
604
+ const input = body;
605
+ if (input?.role !== 'member' && input?.role !== 'admin' && input?.role !== 'superadmin') {
606
+ sendJson(res, 400, { error: 'role must be one of member, admin, superadmin' });
607
+ return;
608
+ }
609
+ const updated = await updateUserRole(targetUserId, input.role);
610
+ if (!updated) {
611
+ sendJson(res, 404, { error: 'user not found' });
612
+ return;
613
+ }
614
+ sendJson(res, 200, {
615
+ id: updated.id, name: updated.name, email: updated.email, provider: updated.oauth_provider,
616
+ status: updated.status, role: updated.role, workspaces: await listUserWorkspaceIds(updated.id),
617
+ signedUpAt: secondsSince(updated.created_at), lastLoginAt: updated.last_login_at ? secondsSince(updated.last_login_at) : null,
618
+ });
619
+ return;
620
+ }
621
+ // DELETE /admin/users/:id
622
+ if (segments[0] === 'admin' && segments[1] === 'users' && segments.length === 3 && req.method === 'DELETE') {
623
+ if (!(await requirePlatformAdmin(req))) {
624
+ sendJson(res, 401, { error: 'unauthorized' });
625
+ return;
626
+ }
627
+ const targetUserId = segments[2];
628
+ const deleted = await deleteUser(targetUserId);
629
+ if (!deleted) {
630
+ sendJson(res, 404, { error: 'user not found' });
631
+ return;
632
+ }
633
+ sendJson(res, 200, { ok: true });
634
+ return;
635
+ }
636
+ // POST /ws/:id/enrollment-tokens (apra-fleet-us9.5/fnz.4, re-scoped per
637
+ // docs/hub-spoke-master-plan.md section 4): a dashboard user assigned to
638
+ // this workspace generates a short-lived, single-use token for a new
639
+ // machine's `apra-fleet join <token>`. Not in the strict Endpoints
640
+ // contract map (a pragmatic addition, same as /workspaces/:id/select).
641
+ if (segments[0] === 'ws' && segments[2] === 'enrollment-tokens' && segments.length === 3 && req.method === 'POST') {
642
+ const workspaceId = segments[1];
643
+ const session = await authorizeSession(req);
644
+ if (!session) {
645
+ sendJson(res, 401, { error: 'unauthorized' });
646
+ return;
647
+ }
648
+ const user = await getUser(session.sub);
649
+ if (!user || user.status !== 'approved' || !(await hasWorkspaceAccess(user.id, workspaceId))) {
650
+ sendJson(res, 401, { error: 'unauthorized' });
651
+ return;
652
+ }
653
+ const { token, expiresAt } = await generateEnrollmentToken(workspaceId);
654
+ sendJson(res, 201, { token, expiresAt });
655
+ return;
656
+ }
657
+ // POST /join/exchange (apra-fleet-us9.5/fnz.4): the hub-mediated half of
658
+ // `apra-fleet join <token>` -- called OUTBOUND by the new machine, no
659
+ // inbound exposure required on any existing spoke. The token itself is
660
+ // the credential (short-lived, single-use, atomically claimed) --
661
+ // no Bearer auth on this route, by design; that's what would make
662
+ // enrollment circular (a new machine has no token yet to present).
663
+ if (segments[0] === 'join' && segments[1] === 'exchange' && segments.length === 2 && req.method === 'POST') {
664
+ let body;
665
+ try {
666
+ body = await parseBody(req);
667
+ }
668
+ catch {
669
+ sendJson(res, 400, { error: 'invalid JSON body' });
670
+ return;
671
+ }
672
+ const input = body;
673
+ if (typeof input?.token !== 'string' || typeof input?.hostname !== 'string') {
674
+ sendJson(res, 400, { error: 'token and hostname are required' });
675
+ return;
676
+ }
677
+ const result = await exchangeEnrollmentToken(input.token, input.hostname);
678
+ if (!result) {
679
+ sendJson(res, 401, { error: 'invalid, expired, or already-used token' });
680
+ return;
681
+ }
682
+ sendJson(res, 200, { machineId: result.machineId, workspaceId: result.workspaceId, jwt: result.jwt });
683
+ return;
684
+ }
685
+ sendJson(res, 404, { error: 'not found' });
686
+ });
687
+ return {
688
+ server,
689
+ get port() {
690
+ const addr = server.address();
691
+ return typeof addr === 'object' && addr ? addr.port : 0;
692
+ },
693
+ close() {
694
+ return new Promise((resolve, reject) => {
695
+ server.close((err) => (err ? reject(err) : resolve()));
696
+ // /ws/:id/stream holds a long-lived keep-alive SSE socket open
697
+ // indefinitely; without force-closing live connections here, a
698
+ // graceful shutdown (or a test teardown) would hang forever waiting
699
+ // for streams that never end on their own.
700
+ server.closeAllConnections();
701
+ });
702
+ },
703
+ };
704
+ }
705
+ export function listen(handle, port, host = '0.0.0.0') {
706
+ return new Promise((resolve, reject) => {
707
+ handle.server.listen(port, host, () => resolve(handle.port));
708
+ handle.server.once('error', reject);
709
+ });
710
+ }
711
+ //# sourceMappingURL=http-server.js.map