@apralabs/apra-fleet 0.3.5 → 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 (571) 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/secret.js +8 -2
  53. package/dist/cli/secret.js.map +1 -1
  54. package/dist/cli/spoke.d.ts +35 -0
  55. package/dist/cli/spoke.d.ts.map +1 -0
  56. package/dist/cli/spoke.js +212 -0
  57. package/dist/cli/spoke.js.map +1 -0
  58. package/dist/cli/start.d.ts +2 -0
  59. package/dist/cli/start.d.ts.map +1 -0
  60. package/dist/cli/start.js +92 -0
  61. package/dist/cli/start.js.map +1 -0
  62. package/dist/cli/status.d.ts +2 -0
  63. package/dist/cli/status.d.ts.map +1 -0
  64. package/dist/cli/status.js +83 -0
  65. package/dist/cli/status.js.map +1 -0
  66. package/dist/cli/stop.d.ts +2 -0
  67. package/dist/cli/stop.d.ts.map +1 -0
  68. package/dist/cli/stop.js +51 -0
  69. package/dist/cli/stop.js.map +1 -0
  70. package/dist/cli/uninstall.d.ts.map +1 -1
  71. package/dist/cli/uninstall.js +109 -9
  72. package/dist/cli/uninstall.js.map +1 -1
  73. package/dist/cli/update.d.ts.map +1 -1
  74. package/dist/cli/update.js +10 -1
  75. package/dist/cli/update.js.map +1 -1
  76. package/dist/cli/workflow-assets.d.ts +37 -0
  77. package/dist/cli/workflow-assets.d.ts.map +1 -0
  78. package/dist/cli/workflow-assets.js +144 -0
  79. package/dist/cli/workflow-assets.js.map +1 -0
  80. package/dist/cli/workflow.d.ts +75 -0
  81. package/dist/cli/workflow.d.ts.map +1 -0
  82. package/dist/cli/workflow.js +397 -0
  83. package/dist/cli/workflow.js.map +1 -0
  84. package/dist/hub-service/activity.d.ts +30 -0
  85. package/dist/hub-service/activity.d.ts.map +1 -0
  86. package/dist/hub-service/activity.js +20 -0
  87. package/dist/hub-service/activity.js.map +1 -0
  88. package/dist/hub-service/audit-log.d.ts +19 -0
  89. package/dist/hub-service/audit-log.d.ts.map +1 -0
  90. package/dist/hub-service/audit-log.js +13 -0
  91. package/dist/hub-service/audit-log.js.map +1 -0
  92. package/dist/hub-service/db/pool.d.ts +19 -0
  93. package/dist/hub-service/db/pool.d.ts.map +1 -0
  94. package/dist/hub-service/db/pool.js +53 -0
  95. package/dist/hub-service/db/pool.js.map +1 -0
  96. package/dist/hub-service/enrollment.d.ts +29 -0
  97. package/dist/hub-service/enrollment.d.ts.map +1 -0
  98. package/dist/hub-service/enrollment.js +48 -0
  99. package/dist/hub-service/enrollment.js.map +1 -0
  100. package/dist/hub-service/envelope-routes.d.ts +46 -0
  101. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  102. package/dist/hub-service/envelope-routes.js +94 -0
  103. package/dist/hub-service/envelope-routes.js.map +1 -0
  104. package/dist/hub-service/handlers/installers.d.ts +14 -0
  105. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  106. package/dist/hub-service/handlers/installers.js +8 -0
  107. package/dist/hub-service/handlers/installers.js.map +1 -0
  108. package/dist/hub-service/http-server.d.ts +31 -0
  109. package/dist/hub-service/http-server.d.ts.map +1 -0
  110. package/dist/hub-service/http-server.js +711 -0
  111. package/dist/hub-service/http-server.js.map +1 -0
  112. package/dist/hub-service/hub-jwt.d.ts +30 -0
  113. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  114. package/dist/hub-service/hub-jwt.js +105 -0
  115. package/dist/hub-service/hub-jwt.js.map +1 -0
  116. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  117. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  118. package/dist/hub-service/jwt-revocation.js +18 -0
  119. package/dist/hub-service/jwt-revocation.js.map +1 -0
  120. package/dist/hub-service/machines.d.ts +16 -0
  121. package/dist/hub-service/machines.d.ts.map +1 -0
  122. package/dist/hub-service/machines.js +14 -0
  123. package/dist/hub-service/machines.js.map +1 -0
  124. package/dist/hub-service/main.d.ts +3 -0
  125. package/dist/hub-service/main.d.ts.map +1 -0
  126. package/dist/hub-service/main.js +64 -0
  127. package/dist/hub-service/main.js.map +1 -0
  128. package/dist/hub-service/member-tokens.d.ts +11 -0
  129. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  130. package/dist/hub-service/member-tokens.js +49 -0
  131. package/dist/hub-service/member-tokens.js.map +1 -0
  132. package/dist/hub-service/member-view.d.ts +20 -0
  133. package/dist/hub-service/member-view.d.ts.map +1 -0
  134. package/dist/hub-service/member-view.js +76 -0
  135. package/dist/hub-service/member-view.js.map +1 -0
  136. package/dist/hub-service/members.d.ts +44 -0
  137. package/dist/hub-service/members.d.ts.map +1 -0
  138. package/dist/hub-service/members.js +25 -0
  139. package/dist/hub-service/members.js.map +1 -0
  140. package/dist/hub-service/presence.d.ts +40 -0
  141. package/dist/hub-service/presence.d.ts.map +1 -0
  142. package/dist/hub-service/presence.js +44 -0
  143. package/dist/hub-service/presence.js.map +1 -0
  144. package/dist/hub-service/project-view.d.ts +12 -0
  145. package/dist/hub-service/project-view.d.ts.map +1 -0
  146. package/dist/hub-service/project-view.js +34 -0
  147. package/dist/hub-service/project-view.js.map +1 -0
  148. package/dist/hub-service/projects.d.ts +48 -0
  149. package/dist/hub-service/projects.d.ts.map +1 -0
  150. package/dist/hub-service/projects.js +80 -0
  151. package/dist/hub-service/projects.js.map +1 -0
  152. package/dist/hub-service/relay-queue.d.ts +115 -0
  153. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  154. package/dist/hub-service/relay-queue.js +148 -0
  155. package/dist/hub-service/relay-queue.js.map +1 -0
  156. package/dist/hub-service/session-jwt.d.ts +10 -0
  157. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  158. package/dist/hub-service/session-jwt.js +69 -0
  159. package/dist/hub-service/session-jwt.js.map +1 -0
  160. package/dist/hub-service/usage.d.ts +40 -0
  161. package/dist/hub-service/usage.d.ts.map +1 -0
  162. package/dist/hub-service/usage.js +25 -0
  163. package/dist/hub-service/usage.js.map +1 -0
  164. package/dist/hub-service/users.d.ts +56 -0
  165. package/dist/hub-service/users.d.ts.map +1 -0
  166. package/dist/hub-service/users.js +72 -0
  167. package/dist/hub-service/users.js.map +1 -0
  168. package/dist/hub-service/workspaces.d.ts +20 -0
  169. package/dist/hub-service/workspaces.d.ts.map +1 -0
  170. package/dist/hub-service/workspaces.js +10 -0
  171. package/dist/hub-service/workspaces.js.map +1 -0
  172. package/dist/index.js +179 -132
  173. package/dist/index.js.map +1 -1
  174. package/dist/os/linux.d.ts +13 -0
  175. package/dist/os/linux.d.ts.map +1 -1
  176. package/dist/os/linux.js +62 -3
  177. package/dist/os/linux.js.map +1 -1
  178. package/dist/os/os-commands.d.ts +10 -0
  179. package/dist/os/os-commands.d.ts.map +1 -1
  180. package/dist/os/windows.d.ts +1 -0
  181. package/dist/os/windows.d.ts.map +1 -1
  182. package/dist/os/windows.js +21 -1
  183. package/dist/os/windows.js.map +1 -1
  184. package/dist/paths.d.ts +23 -0
  185. package/dist/paths.d.ts.map +1 -1
  186. package/dist/paths.js +29 -0
  187. package/dist/paths.js.map +1 -1
  188. package/dist/providers/agy.d.ts +9 -2
  189. package/dist/providers/agy.d.ts.map +1 -1
  190. package/dist/providers/agy.js +127 -14
  191. package/dist/providers/agy.js.map +1 -1
  192. package/dist/providers/claude.d.ts +6 -2
  193. package/dist/providers/claude.d.ts.map +1 -1
  194. package/dist/providers/claude.js +248 -9
  195. package/dist/providers/claude.js.map +1 -1
  196. package/dist/providers/codex.d.ts +3 -2
  197. package/dist/providers/codex.d.ts.map +1 -1
  198. package/dist/providers/codex.js +7 -0
  199. package/dist/providers/codex.js.map +1 -1
  200. package/dist/providers/copilot.d.ts +3 -2
  201. package/dist/providers/copilot.d.ts.map +1 -1
  202. package/dist/providers/copilot.js +8 -1
  203. package/dist/providers/copilot.js.map +1 -1
  204. package/dist/providers/gemini.d.ts +3 -2
  205. package/dist/providers/gemini.d.ts.map +1 -1
  206. package/dist/providers/gemini.js +11 -1
  207. package/dist/providers/gemini.js.map +1 -1
  208. package/dist/providers/index.d.ts +1 -0
  209. package/dist/providers/index.d.ts.map +1 -1
  210. package/dist/providers/index.js +3 -0
  211. package/dist/providers/index.js.map +1 -1
  212. package/dist/providers/none.d.ts +51 -0
  213. package/dist/providers/none.d.ts.map +1 -0
  214. package/dist/providers/none.js +103 -0
  215. package/dist/providers/none.js.map +1 -0
  216. package/dist/providers/opencode.d.ts +4 -2
  217. package/dist/providers/opencode.d.ts.map +1 -1
  218. package/dist/providers/opencode.js +49 -0
  219. package/dist/providers/opencode.js.map +1 -1
  220. package/dist/providers/provider.d.ts +79 -1
  221. package/dist/providers/provider.d.ts.map +1 -1
  222. package/dist/providers/provider.js +10 -0
  223. package/dist/providers/provider.js.map +1 -1
  224. package/dist/services/agent-provisioner.d.ts +3 -3
  225. package/dist/services/agent-provisioner.d.ts.map +1 -1
  226. package/dist/services/agent-provisioner.js +12 -5
  227. package/dist/services/agent-provisioner.js.map +1 -1
  228. package/dist/services/auth-socket.d.ts.map +1 -1
  229. package/dist/services/auth-socket.js +2 -0
  230. package/dist/services/auth-socket.js.map +1 -1
  231. package/dist/services/budget-awareness.d.ts +130 -0
  232. package/dist/services/budget-awareness.d.ts.map +1 -0
  233. package/dist/services/budget-awareness.js +129 -0
  234. package/dist/services/budget-awareness.js.map +1 -0
  235. package/dist/services/cloud-sync.d.ts +35 -0
  236. package/dist/services/cloud-sync.d.ts.map +1 -0
  237. package/dist/services/cloud-sync.js +90 -0
  238. package/dist/services/cloud-sync.js.map +1 -0
  239. package/dist/services/context-admission.d.ts +82 -0
  240. package/dist/services/context-admission.d.ts.map +1 -0
  241. package/dist/services/context-admission.js +136 -0
  242. package/dist/services/context-admission.js.map +1 -0
  243. package/dist/services/event-bus.d.ts +27 -0
  244. package/dist/services/event-bus.d.ts.map +1 -0
  245. package/dist/services/event-bus.js +20 -0
  246. package/dist/services/event-bus.js.map +1 -0
  247. package/dist/services/file-chunker.d.ts +38 -0
  248. package/dist/services/file-chunker.d.ts.map +1 -0
  249. package/dist/services/file-chunker.js +63 -0
  250. package/dist/services/file-chunker.js.map +1 -0
  251. package/dist/services/file-transfer-relay.d.ts +55 -0
  252. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  253. package/dist/services/file-transfer-relay.js +115 -0
  254. package/dist/services/file-transfer-relay.js.map +1 -0
  255. package/dist/services/github-app.d.ts.map +1 -1
  256. package/dist/services/github-app.js +1 -0
  257. package/dist/services/github-app.js.map +1 -1
  258. package/dist/services/http-transport.d.ts +25 -0
  259. package/dist/services/http-transport.d.ts.map +1 -0
  260. package/dist/services/http-transport.js +371 -0
  261. package/dist/services/http-transport.js.map +1 -0
  262. package/dist/services/hub-client.d.ts +69 -0
  263. package/dist/services/hub-client.d.ts.map +1 -0
  264. package/dist/services/hub-client.js +217 -0
  265. package/dist/services/hub-client.js.map +1 -0
  266. package/dist/services/jwt.d.ts +17 -0
  267. package/dist/services/jwt.d.ts.map +1 -0
  268. package/dist/services/jwt.js +70 -0
  269. package/dist/services/jwt.js.map +1 -0
  270. package/dist/services/known-sessions.d.ts +8 -0
  271. package/dist/services/known-sessions.d.ts.map +1 -0
  272. package/dist/services/known-sessions.js +40 -0
  273. package/dist/services/known-sessions.js.map +1 -0
  274. package/dist/services/model-pricing.d.ts +36 -0
  275. package/dist/services/model-pricing.d.ts.map +1 -0
  276. package/dist/services/model-pricing.js +108 -0
  277. package/dist/services/model-pricing.js.map +1 -0
  278. package/dist/services/orphan-recovery.d.ts +56 -0
  279. package/dist/services/orphan-recovery.d.ts.map +1 -0
  280. package/dist/services/orphan-recovery.js +111 -0
  281. package/dist/services/orphan-recovery.js.map +1 -0
  282. package/dist/services/pending-responses.d.ts +23 -0
  283. package/dist/services/pending-responses.d.ts.map +1 -0
  284. package/dist/services/pending-responses.js +52 -0
  285. package/dist/services/pending-responses.js.map +1 -0
  286. package/dist/services/registry.d.ts +4 -1
  287. package/dist/services/registry.d.ts.map +1 -1
  288. package/dist/services/registry.js +3 -0
  289. package/dist/services/registry.js.map +1 -1
  290. package/dist/services/relay-context.d.ts +23 -0
  291. package/dist/services/relay-context.d.ts.map +1 -0
  292. package/dist/services/relay-context.js +8 -0
  293. package/dist/services/relay-context.js.map +1 -0
  294. package/dist/services/relay-executor.d.ts +68 -0
  295. package/dist/services/relay-executor.d.ts.map +1 -0
  296. package/dist/services/relay-executor.js +70 -0
  297. package/dist/services/relay-executor.js.map +1 -0
  298. package/dist/services/relay-request.d.ts +65 -0
  299. package/dist/services/relay-request.d.ts.map +1 -0
  300. package/dist/services/relay-request.js +129 -0
  301. package/dist/services/relay-request.js.map +1 -0
  302. package/dist/services/relay-strategy.d.ts +19 -0
  303. package/dist/services/relay-strategy.d.ts.map +1 -0
  304. package/dist/services/relay-strategy.js +111 -0
  305. package/dist/services/relay-strategy.js.map +1 -0
  306. package/dist/services/service-manager/index.d.ts +5 -0
  307. package/dist/services/service-manager/index.d.ts.map +1 -0
  308. package/dist/services/service-manager/index.js +66 -0
  309. package/dist/services/service-manager/index.js.map +1 -0
  310. package/dist/services/service-manager/linux.d.ts +10 -0
  311. package/dist/services/service-manager/linux.d.ts.map +1 -0
  312. package/dist/services/service-manager/linux.js +97 -0
  313. package/dist/services/service-manager/linux.js.map +1 -0
  314. package/dist/services/service-manager/macos.d.ts +10 -0
  315. package/dist/services/service-manager/macos.d.ts.map +1 -0
  316. package/dist/services/service-manager/macos.js +94 -0
  317. package/dist/services/service-manager/macos.js.map +1 -0
  318. package/dist/services/service-manager/types.d.ts +18 -0
  319. package/dist/services/service-manager/types.d.ts.map +1 -0
  320. package/dist/services/service-manager/types.js +5 -0
  321. package/dist/services/service-manager/types.js.map +1 -0
  322. package/dist/services/service-manager/windows.d.ts +10 -0
  323. package/dist/services/service-manager/windows.d.ts.map +1 -0
  324. package/dist/services/service-manager/windows.js +73 -0
  325. package/dist/services/service-manager/windows.js.map +1 -0
  326. package/dist/services/session-registry.d.ts +70 -0
  327. package/dist/services/session-registry.d.ts.map +1 -0
  328. package/dist/services/session-registry.js +91 -0
  329. package/dist/services/session-registry.js.map +1 -0
  330. package/dist/services/singleton.d.ts +15 -0
  331. package/dist/services/singleton.d.ts.map +1 -0
  332. package/dist/services/singleton.js +98 -0
  333. package/dist/services/singleton.js.map +1 -0
  334. package/dist/services/sprint-coordination.d.ts +168 -0
  335. package/dist/services/sprint-coordination.d.ts.map +1 -0
  336. package/dist/services/sprint-coordination.js +564 -0
  337. package/dist/services/sprint-coordination.js.map +1 -0
  338. package/dist/services/ssh.d.ts.map +1 -1
  339. package/dist/services/ssh.js +70 -3
  340. package/dist/services/ssh.js.map +1 -1
  341. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  342. package/dist/services/stall/log-path-resolver.js +8 -1
  343. package/dist/services/stall/log-path-resolver.js.map +1 -1
  344. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  345. package/dist/services/stall/stall-detector.js +39 -7
  346. package/dist/services/stall/stall-detector.js.map +1 -1
  347. package/dist/services/stall/stall-poller.d.ts +16 -0
  348. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  349. package/dist/services/stall/stall-poller.js +136 -18
  350. package/dist/services/stall/stall-poller.js.map +1 -1
  351. package/dist/services/strategy.d.ts.map +1 -1
  352. package/dist/services/strategy.js +55 -5
  353. package/dist/services/strategy.js.map +1 -1
  354. package/dist/services/substitution-engine.d.ts +20 -0
  355. package/dist/services/substitution-engine.d.ts.map +1 -0
  356. package/dist/services/substitution-engine.js +92 -0
  357. package/dist/services/substitution-engine.js.map +1 -0
  358. package/dist/services/task-cleanup.d.ts.map +1 -1
  359. package/dist/services/task-cleanup.js +1 -9
  360. package/dist/services/task-cleanup.js.map +1 -1
  361. package/dist/services/token-issuer.d.ts +47 -0
  362. package/dist/services/token-issuer.d.ts.map +1 -0
  363. package/dist/services/token-issuer.js +63 -0
  364. package/dist/services/token-issuer.js.map +1 -0
  365. package/dist/services/tool-registry.d.ts +3 -0
  366. package/dist/services/tool-registry.d.ts.map +1 -0
  367. package/dist/services/tool-registry.js +139 -0
  368. package/dist/services/tool-registry.js.map +1 -0
  369. package/dist/services/user-config.d.ts +14 -0
  370. package/dist/services/user-config.d.ts.map +1 -1
  371. package/dist/services/user-config.js +55 -0
  372. package/dist/services/user-config.js.map +1 -1
  373. package/dist/services/vcs/types.d.ts +44 -0
  374. package/dist/services/vcs/types.d.ts.map +1 -1
  375. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  376. package/dist/skills/pm/cost.md +3 -0
  377. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  378. package/dist/tools/check-status.d.ts.map +1 -1
  379. package/dist/tools/check-status.js +8 -2
  380. package/dist/tools/check-status.js.map +1 -1
  381. package/dist/tools/child-id-allocator.d.ts +45 -0
  382. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  383. package/dist/tools/child-id-allocator.js +62 -0
  384. package/dist/tools/child-id-allocator.js.map +1 -0
  385. package/dist/tools/cloud-control.d.ts +2 -2
  386. package/dist/tools/compose-permissions.d.ts +12 -4
  387. package/dist/tools/compose-permissions.d.ts.map +1 -1
  388. package/dist/tools/compose-permissions.js +55 -4
  389. package/dist/tools/compose-permissions.js.map +1 -1
  390. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  391. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  392. package/dist/tools/dolt-push-mutex.js +83 -0
  393. package/dist/tools/dolt-push-mutex.js.map +1 -0
  394. package/dist/tools/execute-command.d.ts +11 -1
  395. package/dist/tools/execute-command.d.ts.map +1 -1
  396. package/dist/tools/execute-command.js +22 -5
  397. package/dist/tools/execute-command.js.map +1 -1
  398. package/dist/tools/execute-prompt.d.ts +72 -12
  399. package/dist/tools/execute-prompt.d.ts.map +1 -1
  400. package/dist/tools/execute-prompt.js +962 -71
  401. package/dist/tools/execute-prompt.js.map +1 -1
  402. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  403. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  404. package/dist/tools/get-member-model-pricing.js +29 -0
  405. package/dist/tools/get-member-model-pricing.js.map +1 -0
  406. package/dist/tools/list-members.d.ts.map +1 -1
  407. package/dist/tools/list-members.js +39 -7
  408. package/dist/tools/list-members.js.map +1 -1
  409. package/dist/tools/member-detail.d.ts +1 -1
  410. package/dist/tools/member-detail.d.ts.map +1 -1
  411. package/dist/tools/member-detail.js +8 -2
  412. package/dist/tools/member-detail.js.map +1 -1
  413. package/dist/tools/member-reservation.d.ts +29 -0
  414. package/dist/tools/member-reservation.d.ts.map +1 -0
  415. package/dist/tools/member-reservation.js +71 -0
  416. package/dist/tools/member-reservation.js.map +1 -0
  417. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  418. package/dist/tools/provision-vcs-auth.js +1 -1
  419. package/dist/tools/provision-vcs-auth.js.map +1 -1
  420. package/dist/tools/register-member.d.ts +17 -5
  421. package/dist/tools/register-member.d.ts.map +1 -1
  422. package/dist/tools/register-member.js +144 -5
  423. package/dist/tools/register-member.js.map +1 -1
  424. package/dist/tools/remove-member.d.ts +1 -1
  425. package/dist/tools/report-status.d.ts +33 -0
  426. package/dist/tools/report-status.d.ts.map +1 -0
  427. package/dist/tools/report-status.js +44 -0
  428. package/dist/tools/report-status.js.map +1 -0
  429. package/dist/tools/respond-to-message.d.ts +21 -0
  430. package/dist/tools/respond-to-message.d.ts.map +1 -0
  431. package/dist/tools/respond-to-message.js +23 -0
  432. package/dist/tools/respond-to-message.js.map +1 -0
  433. package/dist/tools/send-files.d.ts +3 -0
  434. package/dist/tools/send-files.d.ts.map +1 -1
  435. package/dist/tools/send-files.js +88 -8
  436. package/dist/tools/send-files.js.map +1 -1
  437. package/dist/tools/send-message.d.ts +27 -0
  438. package/dist/tools/send-message.d.ts.map +1 -0
  439. package/dist/tools/send-message.js +46 -0
  440. package/dist/tools/send-message.js.map +1 -0
  441. package/dist/tools/shutdown-server.d.ts +2 -0
  442. package/dist/tools/shutdown-server.d.ts.map +1 -1
  443. package/dist/tools/shutdown-server.js +19 -0
  444. package/dist/tools/shutdown-server.js.map +1 -1
  445. package/dist/tools/update-member.d.ts +8 -8
  446. package/dist/tools/update-member.d.ts.map +1 -1
  447. package/dist/tools/update-member.js +11 -1
  448. package/dist/tools/update-member.js.map +1 -1
  449. package/dist/types.d.ts +15 -3
  450. package/dist/types.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.d.ts +2 -1
  452. package/dist/utils/agent-helpers.d.ts.map +1 -1
  453. package/dist/utils/agent-helpers.js +7 -2
  454. package/dist/utils/agent-helpers.js.map +1 -1
  455. package/dist/utils/pid-helpers.d.ts +15 -0
  456. package/dist/utils/pid-helpers.d.ts.map +1 -1
  457. package/dist/utils/pid-helpers.js +23 -0
  458. package/dist/utils/pid-helpers.js.map +1 -1
  459. package/dist/utils/process-utils.d.ts +3 -0
  460. package/dist/utils/process-utils.d.ts.map +1 -0
  461. package/dist/utils/process-utils.js +42 -0
  462. package/dist/utils/process-utils.js.map +1 -0
  463. package/dist/utils/prompt-errors.d.ts +2 -1
  464. package/dist/utils/prompt-errors.d.ts.map +1 -1
  465. package/dist/utils/prompt-errors.js +13 -3
  466. package/dist/utils/prompt-errors.js.map +1 -1
  467. package/dist/utils/workspace-trust.d.ts +24 -0
  468. package/dist/utils/workspace-trust.d.ts.map +1 -0
  469. package/dist/utils/workspace-trust.js +35 -0
  470. package/dist/utils/workspace-trust.js.map +1 -0
  471. package/dist/workflows/auto-sprint.js +450 -87
  472. package/package.json +35 -7
  473. package/packages/apra-fleet-client/package.json +26 -0
  474. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  475. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  476. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  477. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  478. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  479. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  506. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  507. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  514. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  515. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  516. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  517. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  518. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  519. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  520. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  521. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  525. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  526. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  530. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  531. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  532. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  533. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  534. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  535. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  536. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  542. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  543. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  544. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  545. package/packages/apra-fleet-se/package.json +28 -0
  546. package/packages/apra-fleet-se/workflow.json +1 -0
  547. package/packages/apra-fleet-workflow/package.json +30 -0
  548. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  549. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  550. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  551. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  552. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  553. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  554. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  555. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  556. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  557. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  558. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  559. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  560. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  561. package/scripts/agy-transcript-reader.js +1 -0
  562. package/scripts/fleet-statusline.sh +17 -13
  563. package/skills/fleet/SKILL.md +37 -2
  564. package/skills/fleet/beads.md +14 -7
  565. package/skills/fleet/permissions.md +50 -0
  566. package/skills/fleet/profiles/base-dev.json +1 -0
  567. package/skills/fleet/profiles/base-reviewer.json +1 -0
  568. package/skills/fleet/profiles/node.json +2 -2
  569. package/version.json +1 -1
  570. package/scripts/agy-settings-merge.js +0 -27
  571. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,291 @@
1
+ import * as fs from 'fs/promises';
2
+ import * as path from 'path';
3
+ import { createHash } from 'crypto';
4
+
5
+ /**
6
+ * Execution journal (apra-fleet-unw.11, F6).
7
+ *
8
+ * Borrows the "resumable runs / journal caching" pattern from Claude CLI's
9
+ * dynamic-workflow model: an append-only JSONL log of the SAME
10
+ * `activity:start`/`activity:end`/`end` events `FleetWorkflow` already emits
11
+ * (see src/workflow/index.mjs), persisted verbatim by a plain event
12
+ * listener -- this module does NOT invent a second, parallel event format.
13
+ *
14
+ * OFF BY DEFAULT: none of this module's code runs unless a caller opts in
15
+ * via `WorkflowEngine.executeFile(script, args, { journal, resumeJournal })`.
16
+ * A normal `executeFile()` call with neither option produces zero directory/
17
+ * file I/O and zero change to the shape of emitted events (see the
18
+ * `journalEnabled` gating in engine.mjs / index.mjs).
19
+ */
20
+
21
+ export const DEFAULT_JOURNAL_DIR = '.fleet-workflow';
22
+
23
+ /**
24
+ * Hashes prompt/command text for journal storage. The journal never stores
25
+ * raw prompt/command text for `agent()` calls (which can be large and may
26
+ * contain sensitive content) -- only this hash, used to detect divergence on
27
+ * resume. (`command()`'s existing `activity:start`/`activity:end` events
28
+ * already include the raw, substituted command string as part of their
29
+ * established event contract -- see the `command` field in
30
+ * src/workflow/index.mjs -- so this hash is additional, not a replacement,
31
+ * for that field; it is still what replay matching keys off of.)
32
+ * @param {string|undefined|null} text
33
+ * @returns {string|null}
34
+ */
35
+ export function hashText(text) {
36
+ if (text === undefined || text === null) return null;
37
+ return createHash('sha256').update(String(text)).digest('hex');
38
+ }
39
+
40
+ /**
41
+ * Deterministic replay key for a single `agent()`/`command()` call: the
42
+ * call's sequence index within the run (assigned once per logical call, not
43
+ * per schema-repair attempt), its type, the target member, and a hash of the
44
+ * dispatched prompt/command text. First mismatch or first missing entry for
45
+ * this key during a resumed run stops replay and switches to live execution
46
+ * from that point onward (Claude-CLI style partial replay).
47
+ *
48
+ * REPLAY-KEY SEMANTICS AND LIMITATIONS (apra-fleet-unw2.14, N6)
49
+ * ------------------------------------------------------------
50
+ * `sequence` is the call's position in the run. Its shape depends on WHERE
51
+ * the call was made:
52
+ *
53
+ * - A call made in the run's top-level (sequential) flow gets a plain
54
+ * numeric sequence: `0`, `1`, `2`, ... in program order. (Stringified
55
+ * into the key, so `0` -> `"0:agent:..."`.) This is the original,
56
+ * pre-N6 shape and is preserved byte-for-byte, so a resumed run of a
57
+ * purely sequential script computes exactly the same keys it always did,
58
+ * and OLD-FORMAT journals (written before N6) still match for these
59
+ * top-level calls.
60
+ *
61
+ * - A call made INSIDE a `parallel()` branch gets a HIERARCHICAL,
62
+ * scheduler-INDEPENDENT sequence of the form
63
+ * `<parentPrefix><barrierIndex>:<branchIndex>:<localSeq>` -- e.g.
64
+ * `0:1:0` = the first parallel() barrier (barrierIndex 0) entered at
65
+ * this level, its branch at STATIC input-array index 1, that branch's
66
+ * first (localSeq 0) agent()/command() call. `branchIndex` is the
67
+ * branch's fixed position in the array passed to `parallel()`, NOT its
68
+ * completion/scheduling order, and `localSeq` counts only within that
69
+ * one branch. Nested `parallel()` calls extend the prefix further
70
+ * (`0:1:0:2:0` etc.).
71
+ *
72
+ * WHAT IS GUARANTEED: For a given logical call site, the key is IDENTICAL
73
+ * regardless of how the parallel branches actually interleave at runtime.
74
+ * Recording a journal under one interleaving and resuming it under a totally
75
+ * different interleaving therefore still hits the replay cache for every
76
+ * already-completed call across the barrier -- no live re-dispatch of doers
77
+ * whose work already happened. This is the whole point of N6: before it,
78
+ * `sequence` was a single shared counter incremented by whichever branch's
79
+ * agent()/command() happened to run next, so a resumed multi-streak run
80
+ * computed different sequence numbers, missed the cache, and re-executed
81
+ * everything live.
82
+ *
83
+ * WHAT IS NOT GUARANTEED: Determinism still requires the SAME logical
84
+ * script structure on replay -- same top-level call order, same number and
85
+ * static ordering of `parallel()` branches, same per-branch call order,
86
+ * same prompt/command text (the textHash). If the script itself is edited
87
+ * (calls added/removed/reordered, branches added, prompts changed) between
88
+ * the recording and the resume, keys legitimately diverge at the first
89
+ * changed call, exactly as intended -- that is real divergence, not a
90
+ * scheduling artifact. Non-determinism WITHIN a single branch (e.g. a
91
+ * branch that dispatches a different number of agent() calls depending on a
92
+ * coin flip) will also shift that branch's localSeq and diverge; branches
93
+ * must be internally deterministic for replay to be exact.
94
+ *
95
+ * OLD-FORMAT (pre-N6) journals degrade gracefully, never crash: their
96
+ * parallel-region records used the old shared global counter, so the new
97
+ * hierarchical keys won't match for calls inside a `parallel()` region --
98
+ * those calls simply diverge and re-run live (as they effectively did before
99
+ * N6 anyway), while top-level sequential calls still match and replay. The
100
+ * remedy is to regenerate the journal with a fresh run once the fix is
101
+ * deployed.
102
+ *
103
+ * @param {{ sequence: number|string, type: 'agent'|'command', member?: string, textHash: string|null }} parts
104
+ * @returns {string}
105
+ */
106
+ export function computeActivityKey({ sequence, type, member, textHash }) {
107
+ return `${sequence}:${type}:${member || ''}:${textHash || ''}`;
108
+ }
109
+
110
+ /**
111
+ * Resolves the journal file path an `executeFile()` call should write to
112
+ * (or `null` if journaling is not requested at all), from the same options
113
+ * object `executeFile()` accepts.
114
+ *
115
+ * - `opts.journal === true` -> default path `.fleet-workflow/journal-<runId>.jsonl`
116
+ * - `opts.journal === '<path>'` -> that path
117
+ * - `opts.journal === { path: '<path>' }` -> that path
118
+ * - `opts.journal === false` -> explicitly disabled (even if resumeJournal is set)
119
+ * - no `opts.journal`, but `opts.resumeJournal` set -> continue writing to the
120
+ * SAME file being resumed from (the journal for a resumed run continues the
121
+ * original run's journal rather than starting a fresh one)
122
+ * - neither set -> `null` (no journaling)
123
+ * @param {{journal?: boolean|string|{path:string}, resumeJournal?: string}} opts
124
+ * @param {string} runId
125
+ * @returns {string|null}
126
+ */
127
+ export function resolveJournalWritePath(opts, runId) {
128
+ if (opts.journal === false) return null;
129
+ if (opts.journal) {
130
+ if (typeof opts.journal === 'string') return path.resolve(opts.journal);
131
+ if (typeof opts.journal === 'object' && opts.journal.path) return path.resolve(opts.journal.path);
132
+ return path.resolve(DEFAULT_JOURNAL_DIR, `journal-${runId}.jsonl`);
133
+ }
134
+ if (opts.resumeJournal) return path.resolve(opts.resumeJournal);
135
+ return null;
136
+ }
137
+
138
+ /**
139
+ * Loads a journal file for resume/replay. Tolerant of a missing file (a
140
+ * `resumeJournal` path that doesn't exist yet is treated as an empty
141
+ * journal -- the whole run simply executes live, same as a fresh run) and of
142
+ * trailing/corrupt partial lines (a crash can leave a half-written final
143
+ * line; it is skipped rather than failing the whole load).
144
+ *
145
+ * @param {string} filePath
146
+ * @returns {Promise<{ completedByKey: Map<string, object>, ambiguous: object[] }>}
147
+ * `completedByKey` maps a replay key (see computeActivityKey) to the
148
+ * merged `activity:start` + `activity:end` record for the last time that
149
+ * key completed (successfully or not -- callers decide whether a
150
+ * non-success record counts as a replay hit).
151
+ *
152
+ * (apra-fleet-unw2.13, N5) For `command()` calls, this merged record
153
+ * carries a `failSoft` boolean (persisted verbatim from the
154
+ * `activity:start`/`activity:end` events -- see the `failSoft` field on
155
+ * `activityMeta` in `command()`, src/workflow/index.mjs) telling the
156
+ * replay path in `command()` whether the ORIGINAL call used
157
+ * `{ failSoft: true }` and therefore must be replayed as the shaped
158
+ * `{ ok, output, error }` object rather than the raw output string.
159
+ * OLD-FORMAT journal lines written before this field existed simply won't
160
+ * have it -- `rec.failSoft` is `undefined` for those, which the caller in
161
+ * `command()` treats as `false` (falls back to the pre-fix raw-string
162
+ * behavior) rather than crashing. That fallback is a known, documented
163
+ * limitation: a failSoft caller resuming from a pre-fix journal cannot be
164
+ * perfectly replayed and will see the same bare-string shape it saw
165
+ * before this fix, until the journal is regenerated by a fresh run.
166
+ * `ambiguous` lists every `activity:start` record with no matching
167
+ * `activity:end` in the file -- i.e. an activity that was dispatched but
168
+ * never recorded as finished, most likely because the run crashed
169
+ * mid-dispatch. These are surfaced (not resolved) by the caller as a
170
+ * possibly-double-dispatched warning; true idempotency requires
171
+ * fleet-server-side keys and is explicitly descoped (see plan.md).
172
+ */
173
+ export async function loadJournal(filePath) {
174
+ let raw;
175
+ try {
176
+ raw = await fs.readFile(filePath, 'utf-8');
177
+ } catch (err) {
178
+ if (err && err.code === 'ENOENT') {
179
+ return { completedByKey: new Map(), ambiguous: [] };
180
+ }
181
+ throw err;
182
+ }
183
+
184
+ const startsById = new Map();
185
+ const endsById = new Map();
186
+ const completedByKey = new Map();
187
+
188
+ for (const line of raw.split('\n')) {
189
+ const trimmed = line.trim();
190
+ if (!trimmed) continue;
191
+ let rec;
192
+ try {
193
+ rec = JSON.parse(trimmed);
194
+ } catch {
195
+ // Tolerate a corrupt/partial trailing line (e.g. the process was
196
+ // killed mid-write) -- skip it rather than failing the load.
197
+ continue;
198
+ }
199
+ if (rec.event === 'activity:start' && rec.id) {
200
+ startsById.set(rec.id, rec);
201
+ } else if (rec.event === 'activity:end' && rec.id) {
202
+ endsById.set(rec.id, rec);
203
+ const startRec = startsById.get(rec.id);
204
+ const replayKey = rec.replayKey || (startRec && startRec.replayKey);
205
+ if (replayKey) {
206
+ // Last one wins: if the same key was resumed/replayed more
207
+ // than once across multiple crash/resume cycles, the most
208
+ // recent completion is what should be trusted.
209
+ completedByKey.set(replayKey, { ...startRec, ...rec });
210
+ }
211
+ }
212
+ }
213
+
214
+ const ambiguous = [];
215
+ for (const [id, startRec] of startsById) {
216
+ if (!endsById.has(id)) {
217
+ ambiguous.push(startRec);
218
+ }
219
+ }
220
+
221
+ return { completedByKey, ambiguous };
222
+ }
223
+
224
+ /**
225
+ * Append-only JSONL journal writer. Attaches to a `FleetWorkflow` instance's
226
+ * existing `activity:start`/`activity:end`/`end` events (filtered to a
227
+ * single `runId`) and persists them verbatim, one JSON object per line, plus
228
+ * a synthetic `run:start` record written up front. Writes are serialized
229
+ * through an internal promise chain so concurrent event emissions (e.g. from
230
+ * `parallel()` branches of the same run) can never interleave/corrupt lines.
231
+ */
232
+ export class JournalWriter {
233
+ /**
234
+ * @param {import('./index.mjs').FleetWorkflow} fleetWorkflow
235
+ * @param {{ runId: string, filePath: string }} opts
236
+ */
237
+ constructor(fleetWorkflow, { runId, filePath }) {
238
+ this.wf = fleetWorkflow;
239
+ this.runId = runId;
240
+ this.filePath = filePath;
241
+ this._chain = Promise.resolve();
242
+
243
+ this._onActivityStart = (meta) => {
244
+ if (meta.runId === this.runId) this._enqueue({ event: 'activity:start', ...meta });
245
+ };
246
+ this._onActivityEnd = (meta) => {
247
+ if (meta.runId === this.runId) this._enqueue({ event: 'activity:end', ...meta });
248
+ };
249
+ this._onEnd = (meta) => {
250
+ if (meta.runId === this.runId) this._enqueue({ event: 'run:end', ...meta });
251
+ };
252
+ }
253
+
254
+ /** Creates the journal directory (if needed) and starts listening. */
255
+ async init() {
256
+ await fs.mkdir(path.dirname(this.filePath), { recursive: true });
257
+ this.wf.on('activity:start', this._onActivityStart);
258
+ this.wf.on('activity:end', this._onActivityEnd);
259
+ this.wf.on('end', this._onEnd);
260
+ }
261
+
262
+ /**
263
+ * Writes the run-start record. Best-effort: `args`/`scriptPath` are
264
+ * stringified defensively (non-serializable args must not crash the
265
+ * run).
266
+ * @param {{ scriptPath: string, args: any }} meta
267
+ */
268
+ async writeRunStart(meta) {
269
+ const record = { event: 'run:start', runId: this.runId, timestamp: Date.now(), scriptPath: meta.scriptPath };
270
+ try {
271
+ record.args = JSON.parse(JSON.stringify(meta.args ?? {}));
272
+ } catch {
273
+ record.args = undefined;
274
+ }
275
+ this._enqueue(record);
276
+ await this._chain;
277
+ }
278
+
279
+ _enqueue(record) {
280
+ this._chain = this._chain.then(() => fs.appendFile(this.filePath, JSON.stringify(record) + '\n', 'utf-8'));
281
+ return this._chain;
282
+ }
283
+
284
+ /** Detaches listeners and waits for all queued writes to flush. */
285
+ async close() {
286
+ this.wf.off('activity:start', this._onActivityStart);
287
+ this.wf.off('activity:end', this._onActivityEnd);
288
+ this.wf.off('end', this._onEnd);
289
+ await this._chain;
290
+ }
291
+ }
@@ -0,0 +1,99 @@
1
+ // Estimated per-1M-token prices (USD), prompt/completion split.
2
+ // These are point-in-time ESTIMATES, not a live pricing feed -- do not treat
3
+ // them as authoritative for billing. lastUpdated: 2024 (see apra-fleet-unw.4;
4
+ // no new prices were invented when this table was reviewed -- if a model you
5
+ // need isn't listed below, calculateCost() returns `null` rather than
6
+ // guessing at a price).
7
+ //
8
+ // apra-fleet-dv5.2: this table is now the FALLBACK layer only. Real
9
+ // per-member pricing (apra-fleet-dv5.5's get_member_model_pricing MCP tool,
10
+ // consumed client-side by apra-fleet-dv5.6) is the PRIMARY mechanism --
11
+ // these rows are the honest degrade-path used only when real pricing is
12
+ // unavailable for a given run/member (older fleet server, tool-call
13
+ // failure, or an unpriced provider/model).
14
+ //
15
+ // Two independent key families live in this table:
16
+ // - Tier bands ('cheap'/'standard'/'premium'): what runner.js's
17
+ // FIXED_ROLE_TIER and the planner's per-bead metadata convention emit by
18
+ // default (apra-fleet-dv5.1) -- provider-agnostic, resolved to a
19
+ // concrete model per member server-side. Seeded from the pre-existing
20
+ // haiku/sonnet/opus rows below (same relative ordering), NOT sourced
21
+ // from an official published price list.
22
+ // - Concrete model IDs ('fable'/'opus'/'sonnet'/'haiku' and the
23
+ // non-fleet rows further below): a fully legitimate, permanent
24
+ // alternative to a tier keyword -- not a deprecated/legacy convention --
25
+ // for a caller that already knows which concrete model a target member
26
+ // runs and wants to price against that specifically. Matched via
27
+ // substring-of-modelName (see calculateCost()), so a more specific real
28
+ // model id (e.g. 'claude-haiku-4.5-20260601') still matches 'haiku'.
29
+ export const MODEL_PRICING = {
30
+ // Standard models (price per 1M tokens)
31
+ 'gpt-4o': { prompt: 5.00, completion: 15.00 },
32
+ 'gpt-4-turbo': { prompt: 10.00, completion: 30.00 },
33
+ 'claude-3-5-sonnet-20240620': { prompt: 3.00, completion: 15.00 },
34
+ 'claude-3-opus-20240229': { prompt: 15.00, completion: 75.00 },
35
+ 'gemini-1.5-pro': { prompt: 3.50, completion: 10.50 },
36
+ 'gemini-1.5-flash': { prompt: 0.35, completion: 1.05 },
37
+
38
+ // Tier-band fallback rows (apra-fleet-dv5.2) -- used only when real
39
+ // per-member pricing is unavailable. Seeded from the haiku/sonnet/opus
40
+ // rows below; keep in sync if those are ever revised.
41
+ 'cheap': { prompt: 0.80, completion: 4.00 },
42
+ 'standard': { prompt: 3.00, completion: 15.00 },
43
+ 'premium': { prompt: 15.00, completion: 75.00 },
44
+
45
+ // Concrete fleet model IDs (N10, apra-fleet-unw2.8) -- ESTIMATES, see
46
+ // comment above. A legitimate, permanent input form (not legacy).
47
+ 'haiku': { prompt: 0.80, completion: 4.00 }, // Claude Haiku 4.5 (estimate) -- cheapest/fastest tier
48
+ 'sonnet': { prompt: 3.00, completion: 15.00 }, // Claude Sonnet 5 (estimate) -- mid tier, unchanged from the 2024 sonnet row
49
+ 'opus': { prompt: 15.00, completion: 75.00 }, // Claude Opus 4.8 (estimate) -- premium tier, unchanged from the 2024 opus row
50
+ 'fable': { prompt: 15.00, completion: 75.00 } // Claude Fable 5 (estimate) -- treated as premium tier, same order of magnitude as opus
51
+ };
52
+
53
+ // Tier-band keys are exact-match only (see calculateCost()) -- excluded
54
+ // from the substring scan so a near-miss string ('standard-tier') never
55
+ // silently matches a real tier keyword ('standard').
56
+ const TIER_BAND_KEYS = new Set(['cheap', 'standard', 'premium']);
57
+
58
+ /**
59
+ * @param {string} modelName
60
+ * @param {{ input_tokens?: number, output_tokens?: number }|null} usage
61
+ * @returns {number|null} the estimated cost in USD, or `null` when usage is
62
+ * missing/empty, or when `modelName` doesn't match any entry in
63
+ * MODEL_PRICING (unknown models are never silently priced with a default
64
+ * -- see apra-fleet-unw.4).
65
+ */
66
+ export function calculateCost(modelName, usage) {
67
+ if (!usage || (!usage.input_tokens && !usage.output_tokens)) return null;
68
+
69
+ let pricing = null;
70
+ if (modelName) {
71
+ const lower = modelName.toLowerCase();
72
+ // Exact match first (apra-fleet-dv5.2): a tier band ('cheap',
73
+ // 'standard', 'premium') only ever prices an EXACT tier keyword --
74
+ // it is deliberately excluded from the substring scan below, so a
75
+ // string like 'standard-tier' (a plausible typo/mismatch, not a
76
+ // real tier keyword) stays unpriced rather than silently matching
77
+ // 'standard'. Substring matching remains reserved for concrete
78
+ // model IDs (e.g. 'claude-haiku-4.5-20260601' still matches
79
+ // 'haiku'), where a caller legitimately passes a longer real model
80
+ // string that happens to contain a known short concrete-id key.
81
+ if (Object.prototype.hasOwnProperty.call(MODEL_PRICING, lower)) {
82
+ pricing = MODEL_PRICING[lower];
83
+ } else {
84
+ const key = Object.keys(MODEL_PRICING)
85
+ .filter((k) => !TIER_BAND_KEYS.has(k))
86
+ .find((k) => lower.includes(k));
87
+ if (key) pricing = MODEL_PRICING[key];
88
+ }
89
+ }
90
+ if (!pricing) return null;
91
+
92
+ const pTokens = usage.input_tokens || 0;
93
+ const cTokens = usage.output_tokens || 0;
94
+
95
+ const promptCost = (pTokens / 1000000) * pricing.prompt;
96
+ const compCost = (cTokens / 1000000) * pricing.completion;
97
+
98
+ return promptCost + compCost;
99
+ }
@@ -0,0 +1,111 @@
1
+ /**
2
+ * @typedef {Object} VettingResult
3
+ * @property {number} riskScore - 0 (safe) to 100 (critical risk)
4
+ * @property {string[]} warnings - List of identified risks or violations
5
+ */
6
+
7
+ /**
8
+ * Interface for a vetting analyzer.
9
+ * Other developers can implement this interface to add custom checks.
10
+ */
11
+ export class WorkflowAnalyzer {
12
+ /**
13
+ * @param {string} sourceCode
14
+ * @returns {Promise<VettingResult>}
15
+ */
16
+ async analyze(sourceCode) {
17
+ throw new Error("analyze() must be implemented");
18
+ }
19
+ }
20
+
21
+ /**
22
+ * A basic analyzer that scans for patterns worth a developer's attention --
23
+ * fs/child_process imports, process.env access, dynamic eval -- in a
24
+ * workflow script. This is a heuristic lint for code review purposes, not an
25
+ * enforcement mechanism: workflow scripts are trusted code that already runs
26
+ * with full Node.js privileges (see engine.mjs), so none of these patterns
27
+ * are actually "not allowed"; they're just worth a human glancing at before
28
+ * running an unfamiliar script.
29
+ */
30
+ export class BasicSecurityAnalyzer extends WorkflowAnalyzer {
31
+ async analyze(sourceCode) {
32
+ let riskScore = 0;
33
+ const warnings = [];
34
+
35
+ // In a real system, we'd use an AST parser (like Acorn or Babel) to inspect imports and globals.
36
+ // For this first implementation, we use simple heuristic regex matching.
37
+ // NOTE: as regex matching over source text, this is trivially bypassable (string
38
+ // concatenation, indirect references, etc.) -- it is not a security control, only a lint.
39
+
40
+ if (/(?:import|require)\s*\(\s*(?:'|")(?:fs|child_process|crypto|os|net|http)(?:'|")\s*\)/i.test(sourceCode) ||
41
+ /import\s+.*(?:'|")(?:fs|child_process|crypto|os|net|http)(?:'|")/i.test(sourceCode)) {
42
+ riskScore = Math.max(riskScore, 80);
43
+ warnings.push("Imports a core Node.js system module -- worth a review pass, but not blocked (workflow scripts are trusted code with full Node privileges).");
44
+ }
45
+
46
+ if (/process\.env/i.test(sourceCode)) {
47
+ riskScore = Math.max(riskScore, 50);
48
+ warnings.push("Accesses process environment variables directly.");
49
+ }
50
+
51
+ if (/eval\s*\(/i.test(sourceCode) || /new\s+Function\s*\(/i.test(sourceCode)) {
52
+ riskScore = Math.max(riskScore, 90);
53
+ warnings.push("Uses dynamic code evaluation (eval or new Function).");
54
+ }
55
+
56
+ return { riskScore, warnings };
57
+ }
58
+ }
59
+
60
+ /**
61
+ * The Vetting Engine runs workflow scripts through all registered analyzers
62
+ * to generate a cumulative risk assessment before execution.
63
+ *
64
+ * NOTE: this is an advisory lint, not a security boundary. Workflow scripts
65
+ * are TRUSTED code loaded as real ES modules with full Node.js privileges
66
+ * (see engine.mjs); a regex-based heuristic scan cannot meaningfully sandbox
67
+ * arbitrary JavaScript, and this class does not attempt to. Findings are
68
+ * logged as warnings; by default WorkflowEngine.executeFile() never blocks
69
+ * on them. Pass `{ strictVetting: true }` to executeFile() if you want
70
+ * high-risk scripts (riskScore > 50) to throw instead of just warn.
71
+ */
72
+ export class VettingEngine {
73
+ constructor() {
74
+ /** @type {WorkflowAnalyzer[]} */
75
+ this.analyzers = [
76
+ new BasicSecurityAnalyzer()
77
+ ];
78
+ }
79
+
80
+ /**
81
+ * @param {WorkflowAnalyzer} analyzer
82
+ */
83
+ registerAnalyzer(analyzer) {
84
+ this.analyzers.push(analyzer);
85
+ }
86
+
87
+ /**
88
+ * Assess the risk of a workflow script.
89
+ * @param {string} sourceCode
90
+ * @returns {Promise<VettingResult>}
91
+ */
92
+ async assessRisk(sourceCode) {
93
+ let maxRisk = 0;
94
+ const allWarnings = [];
95
+
96
+ for (const analyzer of this.analyzers) {
97
+ try {
98
+ const result = await analyzer.analyze(sourceCode);
99
+ maxRisk = Math.max(maxRisk, result.riskScore);
100
+ allWarnings.push(...result.warnings);
101
+ } catch (err) {
102
+ console.error(`[VettingEngine] Analyzer failed:`, err);
103
+ // Fail secure by flagging unanalyzable scripts
104
+ maxRisk = Math.max(maxRisk, 100);
105
+ allWarnings.push("An analyzer crashed while analyzing this script.");
106
+ }
107
+ }
108
+
109
+ return { riskScore: maxRisk, warnings: allWarnings };
110
+ }
111
+ }
@@ -24,6 +24,7 @@ try {
24
24
  id, '.system_generated', 'logs', 'transcript.jsonl'
25
25
  );
26
26
  if (fs.existsSync(tp)) {
27
+ console.log('FLEET_SESSION_ID:' + id);
27
28
  console.log('FLEET_TRANSCRIPT_START');
28
29
  console.log(fs.readFileSync(tp, 'utf8'));
29
30
  console.log('FLEET_TRANSCRIPT_END');
@@ -1,14 +1,18 @@
1
1
  #!/usr/bin/env bash
2
- # Fleet statusline script for Claude Code.
2
+ # Fleet statusline script for Claude Code and AGY.
3
3
  # Reads pre-rendered statusline.txt and appends a freshness indicator
4
- # based on file mtime — gradient from green to red:
4
+ # based on file mtime - gradient from green to red:
5
5
  #
6
- # Claude Code pipes JSON session data to stdin — we consume it to avoid
6
+ # Claude Code pipes JSON session data to stdin - we consume it to avoid
7
7
  # broken-pipe but don't need it; the fleet server writes the real state.
8
8
 
9
- cat > /dev/null # drain stdin
9
+ # Drain stdin with timeout if present to prevent hanging in AGY / interactive terminals
10
+ if [ ! -t 0 ]; then
11
+ timeout 0.2 cat > /dev/null 2>/dev/null || true
12
+ fi
10
13
 
11
- STATUSLINE_FILE="${APRA_FLEET_DATA_DIR:-$HOME/.apra-fleet/data}/statusline.txt"
14
+ HOME_DIR="${HOME:-$USERPROFILE}"
15
+ STATUSLINE_FILE="${APRA_FLEET_DATA_DIR:-${HOME_DIR}/.apra-fleet/data}/statusline.txt"
12
16
 
13
17
  if [ ! -f "$STATUSLINE_FILE" ]; then
14
18
  echo "Fleet: no status"
@@ -30,14 +34,14 @@ fi
30
34
  NOW=$(date +%s)
31
35
  AGE=$(( NOW - ${MTIME:-0} ))
32
36
 
33
- if [ "$AGE" -lt 10 ]; then FRESH="✅" # <10s fresh
34
- elif [ "$AGE" -lt 60 ]; then FRESH="☑️" # <1m recent
35
- elif [ "$AGE" -lt 300 ]; then FRESH="✔️" # <5m ok
36
- elif [ "$AGE" -lt 900 ]; then FRESH="⏳" # <15m getting stale
37
- elif [ "$AGE" -lt 1800 ]; then FRESH="⚠️" # <30m stale warning
38
- elif [ "$AGE" -lt 3600 ]; then FRESH="🟡" # <1h attention
39
- elif [ "$AGE" -lt 7200 ]; then FRESH="🟠" # <2h concern
40
- else FRESH="🔴" # >2h stale, possibly down
37
+ if [ "$AGE" -lt 10 ]; then FRESH="[OK]" # <10s fresh
38
+ elif [ "$AGE" -lt 60 ]; then FRESH="[OK]" # <1m recent
39
+ elif [ "$AGE" -lt 300 ]; then FRESH="[OK]" # <5m ok
40
+ elif [ "$AGE" -lt 900 ]; then FRESH="[WAIT]" # <15m getting stale
41
+ elif [ "$AGE" -lt 1800 ]; then FRESH="[WARN]" # <30m stale warning
42
+ elif [ "$AGE" -lt 3600 ]; then FRESH="[STALE]" # <1h attention
43
+ elif [ "$AGE" -lt 7200 ]; then FRESH="[STALE]" # <2h concern
44
+ else FRESH="[DOWN]" # >2h stale, possibly down
41
45
  fi
42
46
 
43
47
  echo "${LINE} ${FRESH}"
@@ -128,7 +128,7 @@ Do not dispatch to a busy member. If busy, wait or re-check `member_detail`.
128
128
 
129
129
  Both `send_files` and `receive_files` are batch operations - always transfer all files in a single call, never one file per call.
130
130
 
131
- - `send_files` - push any files to a member: context files, plans, scripts, binaries, configs, or any other content. Takes `local_paths` (array of local file paths) and optional `dest_subdir` (destination subdirectory relative to work_folder on member; defaults to work_folder root, equivalent to `"."`). Always try to batch multiple files in a single call.
131
+ - `send_files` - push any files to a member: context files, plans, scripts, binaries, configs, or any other content. Takes `local_paths` (array of local file paths) and optional `dest_subdir` (destination subdirectory relative to work_folder on member; defaults to work_folder root, equivalent to `"."`). Optional `substitutions: { name: value }` replaces every `{{name}}` token in each file before transfer - see Substitutions section below. Always try to batch multiple files in a single call.
132
132
  - `receive_files` - pull files back: results, logs, build artifacts, updated configs, etc. Takes `remote_paths` (array of file paths on the member) and `local_dest_dir` (local directory to write files into). Always try to batch multiple files in a single call.
133
133
 
134
134
  **Directories and globs:** `send_files` accepts individual file paths only - directories and glob patterns are not supported yet. To transfer an entire directory, tar it locally and extract on the member:
@@ -141,6 +141,37 @@ Both `send_files` and `receive_files` are batch operations - always transfer a
141
141
 
142
142
  **Cross-OS transfers:** Both `send_files` and `receive_files` work bidirectionally for Linux<->Windows transfers (fleet host on Linux, member on Windows, and vice versa).
143
143
 
144
+ ## Substitutions (send_files and execute_prompt)
145
+
146
+ Both `send_files` and `execute_prompt` accept an optional `substitutions: { "token_name": "value" }` parameter that replaces `{{token_name}}` placeholders in file content or prompt text before the content is delivered to the member.
147
+
148
+ **Usage:**
149
+ ```
150
+ send_files(
151
+ local_paths=["docs/sprint-briefing.md"],
152
+ substitutions={ branch: "feat/task-1", base_branch: "main", member_name: "Alice" }
153
+ )
154
+
155
+ execute_prompt(
156
+ member=...,
157
+ prompt="Continue Phase {{phase}}. Branch: {{branch}}.",
158
+ substitutions={ phase: "3", branch: "feat/task-1" }
159
+ )
160
+ ```
161
+
162
+ **Rules:**
163
+ - Token names must match `[A-Za-z_][A-Za-z0-9_]*` - no dots, hyphens, or other special characters.
164
+ - All tokens used in any file (or the prompt string) must have a corresponding key in `substitutions`. Missing tokens cause the call to fail with zero side effects (no files written, no CLI invoked).
165
+ - Extra keys are silently ignored - pass a superset map without error.
166
+ - No recursive substitution: values containing `{{...}}` are written verbatim.
167
+ - Source files on the fleet host are never modified; only the delivered copy is substituted.
168
+ - If `substitutions` is omitted and file/prompt content contains `{{token}}` patterns, a warning is returned (call still succeeds).
169
+
170
+ **[SECURE] Secrets boundary -- never use substitutions for secrets:**
171
+ - Substitution keys with dots (e.g. `secure.github_pat`) are rejected outright.
172
+ - `{{secure.NAME}}` patterns in file/prompt content pass through verbatim - they are resolved later only by `execute_command` via the credential store, not here.
173
+ - Substitution values are never logged. But callers must not put plaintext secrets in substitution values; use `{{secure.NAME}}` in `execute_command` for secrets.
174
+
144
175
  ## Permissions
145
176
 
146
177
  `compose_permissions` produces provider-native config automatically. See `permissions.md` for:
@@ -148,7 +179,11 @@ Both `send_files` and `receive_files` are batch operations - always transfer a
148
179
  - How to handle permission denials during execution
149
180
  - How to recompose when switching roles
150
181
 
151
- ## execute_prompt Timeout Parameters
182
+ ## execute_prompt Parameters
183
+
184
+ `execute_prompt` accepts `substitutions` (see Substitutions section above), `model`, `resume`, and timeout parameters.
185
+
186
+ ### Timeout Parameters
152
187
 
153
188
  `execute_prompt` accepts two independent timeout parameters:
154
189