@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,256 @@
1
+ /**
2
+ * apra-fleet issue #390 -- the MEMBER's home directory, not the hub's.
3
+ *
4
+ * Every provider's `resolveSessionLogPath` / `resolveSessionLogDir` builds a
5
+ * path under a home directory that must exist ON THE MEMBER'S MACHINE. Before
6
+ * this module, no caller ever supplied one, so the providers fell back to
7
+ * `os.homedir()` -- the HUB process's home. For any remote member that is the
8
+ * wrong user (hub `alice` vs member `bella`), and the resulting path can never
9
+ * exist on the member:
10
+ *
11
+ * - Claude / Gemini: the stall poller reads a path that is never created, so
12
+ * `lastTimestamp` is always null, which the detector treats as "log not
13
+ * written yet -- do not count a stall cycle". Stall detection silently goes
14
+ * inert for that member.
15
+ * - AGY / OpenCode: those dispatches are provisional and rely on directory
16
+ * mtime polling. A wrong directory yields no signal at all, and the
17
+ * provisional baseline-timeout check then KILLS a healthy dispatch after
18
+ * the stall threshold -- a live false-positive.
19
+ *
20
+ * This module resolves the member's real home directory once per member and
21
+ * caches it in memory (a home directory does not move for the lifetime of a
22
+ * registration; the cache can be cleared explicitly if a member is re-registered).
23
+ * Local members never probe -- they run as this process's own OS user, so
24
+ * `os.homedir()` is already exactly right and their behavior is unchanged.
25
+ */
26
+ import os from 'node:os';
27
+ import { getStrategy } from './strategy.js';
28
+ import { getAgentOS } from '../utils/agent-helpers.js';
29
+ import { logWarn } from '../utils/log-helpers.js';
30
+ import { getProvider } from '../providers/index.js';
31
+ import { wrapPowerShellEncoded } from '../os/windows.js';
32
+ /** memberId -> resolved home directory. Successful probes only. */
33
+ const homeDirCache = new Map();
34
+ /** memberId -> in-flight probe, so N concurrent pollers cause ONE remote exec. */
35
+ const inFlightProbes = new Map();
36
+ const PROBE_TIMEOUT_MS = 10_000;
37
+ /**
38
+ * Probe command choice (judgment call, issue #390):
39
+ * - Windows: `%USERPROFILE%` is the canonical Windows home and is what the
40
+ * codebase already uses member-side for exactly this purpose -- see
41
+ * ClaudeProvider.ensureWorkspaceTrusted (`$env:USERPROFILE\.claude.json`) and
42
+ * AgyProvider's SCRIPTS_WIN. Delivered via `wrapPowerShellEncoded` (same as
43
+ * every other Windows-targeting PowerShell invocation in this codebase) --
44
+ * a raw inline `powershell -c "..."` string is NOT safe here: if the
45
+ * member's default exec shell is itself PowerShell, that outer shell
46
+ * expands `$env:USERPROFILE` inside the double quotes before the inner
47
+ * `powershell -c` ever sees it, leaving an unquoted path literal that is a
48
+ * syntax error (same defect class as apra-fleet-ot2z). Base64-encoding
49
+ * sidesteps re-tokenization by whatever shell sits in between.
50
+ * - POSIX: `printf '%s'` rather than `echo` -- no trailing newline, no shell
51
+ * builtin escape-interpretation differences between sh/bash/dash.
52
+ */
53
+ function probeCommandFor(targetOs) {
54
+ return targetOs === 'windows'
55
+ ? wrapPowerShellEncoded('[Console]::Out.Write($env:USERPROFILE)')
56
+ : 'printf \'%s\' "$HOME"';
57
+ }
58
+ /** Absolute POSIX path, Windows drive path, or UNC share. Anything else is
59
+ * shell noise (banner text, an error message), not a home directory. */
60
+ function looksAbsolute(candidate, targetOs) {
61
+ if (targetOs === 'windows')
62
+ return /^([A-Za-z]:[\\/]|\\\\)/.test(candidate);
63
+ return candidate.startsWith('/');
64
+ }
65
+ async function probeHomeDir(agent) {
66
+ const targetOs = getAgentOS(agent);
67
+ try {
68
+ const result = await getStrategy(agent).execCommand(probeCommandFor(targetOs), PROBE_TIMEOUT_MS);
69
+ if (result.code !== 0) {
70
+ logWarn('member_home_probe', `home dir probe failed for ${agent.friendlyName}: code=${result.code} stderr=${result.stderr.trim()}`);
71
+ return null;
72
+ }
73
+ // Take the LAST non-empty line: a login shell / PowerShell banner is
74
+ // emitted BEFORE the command's own output, never after it.
75
+ const candidate = result.stdout
76
+ .split(/\r?\n/)
77
+ .map(l => l.trim())
78
+ .filter(Boolean)
79
+ .pop();
80
+ if (!candidate || !looksAbsolute(candidate, targetOs)) {
81
+ logWarn('member_home_probe', `home dir probe for ${agent.friendlyName} returned a non-path value; ignoring`);
82
+ return null;
83
+ }
84
+ homeDirCache.set(agent.id, candidate);
85
+ return candidate;
86
+ }
87
+ catch (err) {
88
+ const msg = err instanceof Error ? err.message : String(err);
89
+ logWarn('member_home_probe', `home dir probe errored for ${agent.friendlyName}: ${msg}`);
90
+ return null;
91
+ }
92
+ }
93
+ /**
94
+ * LAST-RESORT fallback only: the default home directory implied by the member's
95
+ * known login username. `agent.username` is the account fleet actually connects
96
+ * as, so its home is normally the standard per-OS location.
97
+ *
98
+ * This is a CONVENTION, not ground truth -- a member can have a relocated home,
99
+ * a domain-suffixed Windows profile (C:\Users\bella.CORP), an admin-created
100
+ * /export/home, and so on. It is therefore NEVER preferred over a probe result,
101
+ * and a path built from it is never by itself treated as trustworthy evidence
102
+ * that a dispatch has stalled (see pollDirectoryActivity: a guessed directory
103
+ * only counts as a real signal once it actually yields one).
104
+ */
105
+ export function homeDirFromUsername(username, targetOs) {
106
+ if (!username)
107
+ return null;
108
+ if (targetOs === 'windows')
109
+ return `C:\\Users\\${username}`;
110
+ if (targetOs === 'macos')
111
+ return username === 'root' ? '/var/root' : `/Users/${username}`;
112
+ return username === 'root' ? '/root' : `/home/${username}`;
113
+ }
114
+ /**
115
+ * The member's own home directory, PROBED (authoritative).
116
+ * - local members: `os.homedir()`, immediately, with NO remote probe (they are
117
+ * this process's own OS user -- unchanged behavior).
118
+ * - remote/relay members: cached probe result, or `null` when the probe fails.
119
+ * Never throws; `null` means "unknown", and callers must degrade to "no
120
+ * signal" rather than substituting the hub's home directory.
121
+ */
122
+ export async function getMemberHomeDir(agent) {
123
+ if (agent.agentType === 'local')
124
+ return os.homedir();
125
+ const cached = homeDirCache.get(agent.id);
126
+ if (cached)
127
+ return cached;
128
+ const existing = inFlightProbes.get(agent.id);
129
+ if (existing)
130
+ return existing;
131
+ // Failures are deliberately NOT cached: a member that was briefly unreachable
132
+ // must be able to recover on the next poll without a server restart.
133
+ const probe = probeHomeDir(agent).finally(() => inFlightProbes.delete(agent.id));
134
+ inFlightProbes.set(agent.id, probe);
135
+ return probe;
136
+ }
137
+ /**
138
+ * Everything a provider needs to build a member-side path correctly: the
139
+ * member's home directory AND the path-join convention of the member's OS.
140
+ *
141
+ * `targetOs` is deliberately `undefined` for local members so their paths keep
142
+ * using this process's host `path.join` -- byte-identical to the pre-#390
143
+ * behavior, which is already correct for them.
144
+ */
145
+ export async function getMemberPathContext(agent) {
146
+ if (agent.agentType === 'local') {
147
+ return { homeDir: os.homedir(), targetOs: undefined, source: 'local' };
148
+ }
149
+ const targetOs = getAgentOS(agent);
150
+ const probed = await getMemberHomeDir(agent);
151
+ if (probed)
152
+ return { homeDir: probed, targetOs, source: 'probe' };
153
+ // LAST RESORT (see homeDirFromUsername): the probe failed, so fall back to the
154
+ // username's conventional home rather than giving up entirely. `source` marks
155
+ // it as a guess so the stall detector will not treat a barren guessed
156
+ // directory as proof of a stall.
157
+ const guess = homeDirFromUsername(agent.username, targetOs);
158
+ return guess
159
+ ? { homeDir: guess, targetOs, source: 'username-fallback' }
160
+ : { homeDir: null, targetOs, source: 'unknown' };
161
+ }
162
+ /**
163
+ * SYNCHRONOUS path context -- never issues a member-side command.
164
+ *
165
+ * Used on the execute_prompt dispatch path, which must not pay a remote round
166
+ * trip (nor reorder the commands a dispatch sends) just to name a log file.
167
+ * Resolution order:
168
+ * 1. local member -> os.homedir()
169
+ * 2. cached probe result -> ground truth from an earlier stall poll
170
+ * 3. username fallback -> LAST RESORT (see homeDirFromUsername). Harmless
171
+ * here: if the guess is wrong the resolved transcript path simply never
172
+ * exists, which the stall detector already treats as "no timestamp yet"
173
+ * and NEVER as a stall. If the guess is right, the dispatch gets precise
174
+ * per-session transcript tracking from its very first turn.
175
+ * 4. null -> no path is built at all (never, ever the hub's home).
176
+ */
177
+ export function getCachedMemberPathContext(agent) {
178
+ if (agent.agentType === 'local') {
179
+ return { homeDir: os.homedir(), targetOs: undefined, source: 'local' };
180
+ }
181
+ const targetOs = getAgentOS(agent);
182
+ const cached = homeDirCache.get(agent.id);
183
+ if (cached)
184
+ return { homeDir: cached, targetOs, source: 'probe' };
185
+ const guess = homeDirFromUsername(agent.username, targetOs);
186
+ return guess
187
+ ? { homeDir: guess, targetOs, source: 'username-fallback' }
188
+ : { homeDir: null, targetOs, source: 'unknown' };
189
+ }
190
+ /** Throwaway home dir used only to ask "does this provider build a member-side
191
+ * log path at all?" -- never used to build a path that is actually read. */
192
+ const HOME_CAPABILITY_SENTINEL = '/__fleet_capability_probe__';
193
+ /**
194
+ * SF-18: warm the home-dir cache for every remote member that needs one.
195
+ *
196
+ * Before this, `getMemberPathContext` (the only probing resolver) had exactly
197
+ * ONE caller: `pollDirectoryActivity`, which runs solely for provisional
198
+ * dispatches with a null logFilePath -- i.e. AGY/OpenCode fresh turns. Claude
199
+ * and Gemini sessions are caller-minted, so their stall entries always carry a
200
+ * logFilePath and never reach it. Their cache therefore stayed empty forever,
201
+ * and the synchronous dispatch-path resolver (`getCachedMemberPathContext`,
202
+ * used by execute_prompt to name the transcript file) permanently fell back to
203
+ * the username-convention GUESS. On a member with a relocated or
204
+ * domain-suffixed home that guess is wrong, the named transcript never exists,
205
+ * and stall detection for that member silently goes inert.
206
+ *
207
+ * Called at server startup, which is the one place that covers members
208
+ * registered in an EARLIER process (the cache is per-process). register_member
209
+ * fires its own probe for newly added members so their very first dispatch is
210
+ * already warm.
211
+ *
212
+ * Deliberately fire-and-forget and deliberately NOT on the dispatch path: an
213
+ * awaited probe there inserts a remote round trip ahead of the dispatch's own
214
+ * commands, reordering the exact sequence #390 was careful to preserve. Every
215
+ * failure mode is silent -- the username guess remains the fallback, exactly as
216
+ * before.
217
+ */
218
+ export function warmMemberHomeDirs(agents) {
219
+ for (const agent of agents) {
220
+ // Local members never probe (os.homedir() is already exactly right).
221
+ if (agent.agentType === 'local')
222
+ continue;
223
+ if (homeDirCache.has(agent.id))
224
+ continue;
225
+ // Providers with no member-side log path at all (codex/copilot/none) have
226
+ // no use for a home dir -- spending a remote exec on them is pure waste.
227
+ const targetOs = getAgentOS(agent);
228
+ let hasLogDir;
229
+ try {
230
+ hasLogDir = getProvider(agent.llmProvider ?? 'claude')
231
+ .resolveSessionLogDir(agent.workFolder, HOME_CAPABILITY_SENTINEL, targetOs) !== null;
232
+ }
233
+ catch {
234
+ continue;
235
+ }
236
+ if (!hasLogDir)
237
+ continue;
238
+ void getMemberHomeDir(agent).catch(() => { });
239
+ }
240
+ }
241
+ /** Drop cached home dirs (a specific member, or all). Used when a member is
242
+ * re-registered/removed, and by tests. */
243
+ export function clearMemberHomeDirCache(memberId) {
244
+ if (memberId === undefined) {
245
+ homeDirCache.clear();
246
+ inFlightProbes.clear();
247
+ return;
248
+ }
249
+ homeDirCache.delete(memberId);
250
+ inFlightProbes.delete(memberId);
251
+ }
252
+ /** Seed the cache directly (tests, or a caller that already knows the value). */
253
+ export function primeMemberHomeDir(memberId, homeDir) {
254
+ homeDirCache.set(memberId, homeDir);
255
+ }
256
+ //# sourceMappingURL=member-home.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"member-home.js","sourceRoot":"","sources":["../../src/services/member-home.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import type { Agent } from '../types.js';
2
+ /**
3
+ * apra-fleet-b4g.6: the only place a genuine origin URL for a member can
4
+ * already be known server-side is the member's own registration record
5
+ * (gitRepos) -- and only when it already IS a URL. In practice gitRepos entries
6
+ * are almost always a bare "owner/repo" access identifier (see
7
+ * src/services/vcs/github.ts's own https://github.com/${repo}.git construction,
8
+ * used for a narrower purpose -- connectivity testing), so this intentionally
9
+ * does not build a URL out of one: an incorrect derived URL would route KB
10
+ * reads and writes into a slug that does not match the repo's real local-clone
11
+ * slug, worse than the honest 'default' fallback. Returns undefined when
12
+ * nothing already known qualifies.
13
+ *
14
+ * apra-fleet-b4g.14: gitRepos is an ACCESS LIST (src/tools/register-member.ts
15
+ * documents git_repos as "Git repositories this member can access"), not an
16
+ * origin field -- so index 0 is not guaranteed to be the repo the member's
17
+ * work_folder is actually a clone of. Only forward the URL when gitRepos has
18
+ * EXACTLY one entry: that is the one case where "index 0" and "the member's
19
+ * own repo" are provably the same thing, since there is nothing else the
20
+ * single entry could mean. A multi-entry gitRepos whose first element happens
21
+ * to look like a URL is ambiguous -- it could equally be an access grant to a
22
+ * DIFFERENT repo than the one being scoped -- so it is deliberately left
23
+ * unforwarded rather than guessed, matching the no-guessing rule this function
24
+ * already applies to bare "owner/repo" entries above.
25
+ * src/services/watch/project-resolver.ts's own gitRepos[0] use is display-only
26
+ * grouping, is unaffected by this narrowing, and is deliberately left unchanged.
27
+ *
28
+ * Lives here rather than in execute-prompt.ts (its first caller) because
29
+ * member_detail needs the same rule to report the URL to the fleet-sprint
30
+ * engine, and importing the dispatch module for one pure helper would pull the
31
+ * whole prompt-dispatch stack into a read-only status tool.
32
+ */
33
+ export declare function knownRepoRemoteUrl(agent: Agent): string | undefined;
34
+ //# sourceMappingURL=member-remote-url.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"member-remote-url.d.ts","sourceRoot":"","sources":["../../src/services/member-remote-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAKnE"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * apra-fleet-b4g.6: the only place a genuine origin URL for a member can
3
+ * already be known server-side is the member's own registration record
4
+ * (gitRepos) -- and only when it already IS a URL. In practice gitRepos entries
5
+ * are almost always a bare "owner/repo" access identifier (see
6
+ * src/services/vcs/github.ts's own https://github.com/${repo}.git construction,
7
+ * used for a narrower purpose -- connectivity testing), so this intentionally
8
+ * does not build a URL out of one: an incorrect derived URL would route KB
9
+ * reads and writes into a slug that does not match the repo's real local-clone
10
+ * slug, worse than the honest 'default' fallback. Returns undefined when
11
+ * nothing already known qualifies.
12
+ *
13
+ * apra-fleet-b4g.14: gitRepos is an ACCESS LIST (src/tools/register-member.ts
14
+ * documents git_repos as "Git repositories this member can access"), not an
15
+ * origin field -- so index 0 is not guaranteed to be the repo the member's
16
+ * work_folder is actually a clone of. Only forward the URL when gitRepos has
17
+ * EXACTLY one entry: that is the one case where "index 0" and "the member's
18
+ * own repo" are provably the same thing, since there is nothing else the
19
+ * single entry could mean. A multi-entry gitRepos whose first element happens
20
+ * to look like a URL is ambiguous -- it could equally be an access grant to a
21
+ * DIFFERENT repo than the one being scoped -- so it is deliberately left
22
+ * unforwarded rather than guessed, matching the no-guessing rule this function
23
+ * already applies to bare "owner/repo" entries above.
24
+ * src/services/watch/project-resolver.ts's own gitRepos[0] use is display-only
25
+ * grouping, is unaffected by this narrowing, and is deliberately left unchanged.
26
+ *
27
+ * Lives here rather than in execute-prompt.ts (its first caller) because
28
+ * member_detail needs the same rule to report the URL to the fleet-sprint
29
+ * engine, and importing the dispatch module for one pure helper would pull the
30
+ * whole prompt-dispatch stack into a read-only status tool.
31
+ */
32
+ export function knownRepoRemoteUrl(agent) {
33
+ const repos = agent.gitRepos;
34
+ if (!repos || repos.length !== 1)
35
+ return undefined;
36
+ const first = repos[0];
37
+ return first.includes('://') || first.startsWith('git@') ? first : undefined;
38
+ }
39
+ //# sourceMappingURL=member-remote-url.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"member-remote-url.js","sourceRoot":"","sources":["../../src/services/member-remote-url.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * apra-fleet-dv5.5: per-member, per-tier LLM token pricing.
3
+ *
4
+ * Deterministic tier -> concrete-model resolution (resolveModelForTier() in
5
+ * execute-prompt.ts / each provider's modelTiers()) is config-driven and
6
+ * known ahead of any dispatch -- it does not require a per-dispatch
7
+ * echo-back to know what "member X's premium tier" resolves to. This module
8
+ * resolves each of a member's three tiers to a concrete model (mirroring
9
+ * resolveModelForTier's own resolution order: the member's own
10
+ * `modelTiers` override first, then the provider's default) and looks up
11
+ * that model's $/1M-token price.
12
+ *
13
+ * Same "unknown model returns null, never fabricate a price" discipline as
14
+ * apra-fleet-workflow's pricing.mjs -- these are point-in-time ESTIMATES,
15
+ * not a live pricing feed.
16
+ */
17
+ import type { Agent } from '../types.js';
18
+ import type { ProviderAdapter } from '../providers/provider.js';
19
+ export interface ModelPrice {
20
+ model: string;
21
+ promptPrice: number;
22
+ completionPrice: number;
23
+ }
24
+ export type MemberModelPricing = {
25
+ cheap: ModelPrice | null;
26
+ standard: ModelPrice | null;
27
+ premium: ModelPrice | null;
28
+ };
29
+ /**
30
+ * @param agent the member to resolve pricing for
31
+ * @param provider the ProviderAdapter for agent.llmProvider (getProvider(agent.llmProvider))
32
+ * @returns per-tier pricing; a tier is `null` when its resolved model has no
33
+ * known price (unlisted model, or a provider with no pricing table).
34
+ */
35
+ export declare function getMemberModelPricing(agent: Agent, provider: ProviderAdapter): MemberModelPricing;
36
+ //# sourceMappingURL=model-pricing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../src/services/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B,CAAC;AA+FF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CAQjG"}
@@ -0,0 +1,108 @@
1
+ import { getModelOverride } from './user-config.js';
2
+ /**
3
+ * provider -> concrete model id -> $/1M-token {prompt, completion}.
4
+ *
5
+ * Seeded from each provider adapter's own modelTiers() default (see
6
+ * src/providers/*.ts) -- these are the models actually dispatched against
7
+ * absent a per-member modelTiers override. An unlisted model (whether from
8
+ * an override or a future provider default change) returns null rather
9
+ * than a fabricated/guessed price.
10
+ */
11
+ const PROVIDER_MODEL_PRICING = {
12
+ claude: {
13
+ haiku: { prompt: 0.80, completion: 4.00 },
14
+ sonnet: { prompt: 3.00, completion: 15.00 },
15
+ opus: { prompt: 15.00, completion: 75.00 },
16
+ },
17
+ agy: {
18
+ 'gemini-3.5-flash-lite': { prompt: 0.10, completion: 0.40 },
19
+ 'gemini-3.5-flash': { prompt: 0.35, completion: 1.05 },
20
+ 'claude-sonnet-4.6': { prompt: 3.00, completion: 15.00 },
21
+ },
22
+ gemini: {
23
+ 'gemini-3.5-flash-lite': { prompt: 0.10, completion: 0.40 },
24
+ 'gemini-3.5-flash': { prompt: 0.35, completion: 1.05 },
25
+ 'gemini-3.1-pro-preview': { prompt: 3.50, completion: 10.50 },
26
+ },
27
+ codex: {
28
+ 'gpt-5.4-mini': { prompt: 0.25, completion: 2.00 },
29
+ 'gpt-5.4': { prompt: 5.00, completion: 15.00 },
30
+ },
31
+ copilot: {
32
+ 'claude-haiku-4-5': { prompt: 0.80, completion: 4.00 },
33
+ 'claude-sonnet-4-5': { prompt: 3.00, completion: 15.00 },
34
+ 'claude-opus-4-5': { prompt: 15.00, completion: 75.00 },
35
+ },
36
+ // OpenCode's default tier models are all free-tier ($0) -- a real,
37
+ // known price, not an "unknown model" null.
38
+ opencode: {
39
+ 'opencode/north-mini-code-free': { prompt: 0, completion: 0 },
40
+ 'opencode/deepseek-v4-flash-free': { prompt: 0, completion: 0 },
41
+ 'opencode/nemotron-3-ultra-free': { prompt: 0, completion: 0 },
42
+ },
43
+ // 'none' is a compute-only, non-LLM provider (see member-detail.ts's
44
+ // `tokenUsage = 'compute only'` handling) -- it has no models to price.
45
+ none: {},
46
+ };
47
+ /**
48
+ * Resolves a member's three tiers to concrete models using the SAME
49
+ * precedence chain execute-prompt.ts actually dispatches with (see its
50
+ * per-tier `if (resolvedModel === 'cheap') ... else if (... === 'standard')
51
+ * ...` block, ~line 293-313), not just resolveModelForTier() in isolation
52
+ * (that helper is itself only reached when `agent.modelTiers` is set --
53
+ * dead code otherwise in the real dispatch path). Per tier, in order:
54
+ * 1. `agent.modelTiers` (the whole-object override, e.g. from a planner
55
+ * or admin setting all three tiers at once) -- if set, wins for ALL
56
+ * three tiers and nothing below is consulted, mirroring
57
+ * resolveModelForTier()'s own cheap/standard/premium-then-first-
58
+ * defined fallback when a specific tier is absent from the object.
59
+ * 2. `agent.model<Tier>` (the single-tier per-member override set via
60
+ * `update_member --model-cheap/standard/premium`, docs/install.md
61
+ * "Customizing model tier mapping").
62
+ * 3. The global user-config override (`~/.apra-fleet/data/config.json`,
63
+ * getModelOverride()).
64
+ * 4. The provider's own hardcoded default (provider.modelTiers()).
65
+ */
66
+ function resolveMemberTierModels(agent, provider) {
67
+ const memberTiers = agent.modelTiers;
68
+ if (memberTiers) {
69
+ const fallback = memberTiers.standard ?? memberTiers.cheap ?? Object.values(memberTiers).filter(Boolean)[0];
70
+ return {
71
+ cheap: memberTiers.cheap ?? fallback,
72
+ standard: memberTiers.standard ?? fallback,
73
+ premium: memberTiers.premium ?? fallback,
74
+ };
75
+ }
76
+ const providerName = agent.llmProvider ?? 'claude';
77
+ const defaults = provider.modelTiers();
78
+ return {
79
+ cheap: agent.modelCheap || getModelOverride(providerName, 'cheap') || defaults.cheap,
80
+ standard: agent.modelStandard || getModelOverride(providerName, 'standard') || defaults.standard,
81
+ premium: agent.modelPremium || getModelOverride(providerName, 'premium') || defaults.premium,
82
+ };
83
+ }
84
+ function priceModel(providerName, model) {
85
+ const table = PROVIDER_MODEL_PRICING[providerName];
86
+ if (!table)
87
+ return null;
88
+ const price = table[model];
89
+ if (!price)
90
+ return null;
91
+ return { model, promptPrice: price.prompt, completionPrice: price.completion };
92
+ }
93
+ /**
94
+ * @param agent the member to resolve pricing for
95
+ * @param provider the ProviderAdapter for agent.llmProvider (getProvider(agent.llmProvider))
96
+ * @returns per-tier pricing; a tier is `null` when its resolved model has no
97
+ * known price (unlisted model, or a provider with no pricing table).
98
+ */
99
+ export function getMemberModelPricing(agent, provider) {
100
+ const providerName = agent.llmProvider ?? 'claude';
101
+ const tierModels = resolveMemberTierModels(agent, provider);
102
+ return {
103
+ cheap: priceModel(providerName, tierModels.cheap),
104
+ standard: priceModel(providerName, tierModels.standard),
105
+ premium: priceModel(providerName, tierModels.premium),
106
+ };
107
+ }
108
+ //# sourceMappingURL=model-pricing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-pricing.js","sourceRoot":"","sources":["../../src/services/model-pricing.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ import type { AgentStrategy } from './strategy.js';
2
+ import type { OsCommands } from '../os/os-commands.js';
3
+ import type { LogScope } from '../utils/log-helpers.js';
4
+ import type { RemoteOS } from '../utils/platform.js';
5
+ export type OrphanRecoveryStatus =
6
+ /** The durable output file carried a real result -- `stdout` is populated. */
7
+ 'recovered'
8
+ /** The pid is confirmed dead (or there was nothing to check) -- caller keeps
9
+ * its pre-existing empty_response behavior, unchanged. */
10
+ | 'dead'
11
+ /** Process exited but the durable file was missing/empty -- a REAL empty
12
+ * response, same terminal handling as 'dead'. */
13
+ | 'empty'
14
+ /** Still alive when the wait cap was hit; the pid has been killed. Must be
15
+ * surfaced as its own terminal reason, never as empty_response. */
16
+ | 'timeout'
17
+ /** Recovery does not apply (no captured pid, no durable file path, or a
18
+ * platform without the durable-tee companion change). */
19
+ | 'unsupported';
20
+ export interface OrphanRecoveryResult {
21
+ status: OrphanRecoveryStatus;
22
+ stdout?: string;
23
+ /** How long the recovery path waited on the live pid, in ms. */
24
+ waitedMs?: number;
25
+ }
26
+ export interface OrphanRecoveryOptions {
27
+ strategy: AgentStrategy;
28
+ cmds: OsCommands;
29
+ /** PID captured from the FLEET_PID marker via onPidCaptured. */
30
+ pid?: number;
31
+ /** Remote path the dispatch teed its stdout to. */
32
+ durablePath?: string;
33
+ /** True for members whose remote OS has no durable-tee companion support. */
34
+ unsupported?: boolean;
35
+ /** Remote member's OS, for building an OS-appropriate probe command. Defaults to 'linux'. */
36
+ os?: RemoteOS;
37
+ /** Upper bound on the wait; defaults to the remaining max_total_s, else a ceiling. */
38
+ maxWaitMs?: number;
39
+ pollIntervalMs?: number;
40
+ scope?: Pick<LogScope, 'info'>;
41
+ /** Injectable sleep so tests do not depend on wall-clock or fake timers. */
42
+ sleep?: (ms: number) => Promise<void>;
43
+ }
44
+ /**
45
+ * Probe remote PID liveness over a FRESH short exec -- deliberately NOT the
46
+ * channel that just resolved, which is exactly the thing whose verdict is in
47
+ * doubt. Conservative on ambiguity, like isPidAlive(): only an explicit DEAD
48
+ * marker counts as dead; a failed/garbled probe is reported as alive so the
49
+ * caller waits rather than declaring a false failure.
50
+ */
51
+ export declare function isRemoteProcessAlive(strategy: AgentStrategy, pid: number, os?: RemoteOS): Promise<boolean>;
52
+ /** Read the durable per-invocation output file back over a fresh exec. */
53
+ export declare function readDurableOutput(strategy: AgentStrategy, durablePath: string, os?: RemoteOS): Promise<string | null>;
54
+ /**
55
+ * Lease-of-life gate. Returns 'dead' whenever the pre-existing empty_response
56
+ * behavior should apply verbatim, so the caller's fallback path is unchanged.
57
+ */
58
+ export declare function recoverOrphanedDispatch(opts: OrphanRecoveryOptions): Promise<OrphanRecoveryResult>;
59
+ //# sourceMappingURL=orphan-recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orphan-recovery.d.ts","sourceRoot":"","sources":["../../src/services/orphan-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AA8BrD,MAAM,MAAM,oBAAoB;AAC9B,8EAA8E;AAC5E,WAAW;AACb;2DAC2D;GACzD,MAAM;AACR;kDACkD;GAChD,OAAO;AACT;oEACoE;GAClE,SAAS;AACX;0DAC0D;GACxD,aAAa,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6FAA6F;IAC7F,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAWD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,EACX,EAAE,GAAE,QAAkB,GACrB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,0EAA0E;AAC1E,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,EACnB,EAAE,GAAE,QAAkB,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuCxG"}