@apralabs/apra-fleet 0.4.2 → 0.4.3

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 (370) hide show
  1. package/README.md +38 -5
  2. package/dist/agents/backlog-groomer.md +25 -0
  3. package/dist/agents/ci-watcher.md +11 -0
  4. package/dist/agents/deployer.md +37 -2
  5. package/dist/agents/doer.md +36 -12
  6. package/dist/agents/harvester.md +11 -0
  7. package/dist/agents/integ-test-runner.md +11 -0
  8. package/dist/agents/kb-reconciler.md +9 -0
  9. package/dist/agents/plan-reviewer.md +110 -22
  10. package/dist/agents/planner.md +125 -37
  11. package/dist/agents/regression-test-runner.md +11 -0
  12. package/dist/agents/reviewer.md +13 -2
  13. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  14. package/dist/cli/agent-transform.d.ts +83 -2
  15. package/dist/cli/agent-transform.d.ts.map +1 -1
  16. package/dist/cli/agent-transform.js +266 -21
  17. package/dist/cli/agent-transform.js.map +1 -1
  18. package/dist/cli/auth.d.ts.map +1 -1
  19. package/dist/cli/auth.js +28 -9
  20. package/dist/cli/auth.js.map +1 -1
  21. package/dist/cli/config.d.ts +7 -5
  22. package/dist/cli/config.d.ts.map +1 -1
  23. package/dist/cli/config.js +44 -34
  24. package/dist/cli/config.js.map +1 -1
  25. package/dist/cli/install.d.ts +33 -0
  26. package/dist/cli/install.d.ts.map +1 -1
  27. package/dist/cli/install.js +290 -23
  28. package/dist/cli/install.js.map +1 -1
  29. package/dist/cli/kb-directives.d.ts.map +1 -1
  30. package/dist/cli/kb-directives.js +2 -1
  31. package/dist/cli/kb-directives.js.map +1 -1
  32. package/dist/cli/register-member.d.ts.map +1 -1
  33. package/dist/cli/register-member.js +6 -2
  34. package/dist/cli/register-member.js.map +1 -1
  35. package/dist/commands/kb-server.d.ts +3 -0
  36. package/dist/commands/kb-server.d.ts.map +1 -1
  37. package/dist/commands/kb-server.js +43 -3
  38. package/dist/commands/kb-server.js.map +1 -1
  39. package/dist/index.js +3 -3
  40. package/dist/os/linux.d.ts +6 -0
  41. package/dist/os/linux.d.ts.map +1 -1
  42. package/dist/os/linux.js +35 -2
  43. package/dist/os/linux.js.map +1 -1
  44. package/dist/os/os-commands.d.ts +61 -2
  45. package/dist/os/os-commands.d.ts.map +1 -1
  46. package/dist/os/windows-gitbash.d.ts +5 -0
  47. package/dist/os/windows-gitbash.d.ts.map +1 -1
  48. package/dist/os/windows-gitbash.js +15 -0
  49. package/dist/os/windows-gitbash.js.map +1 -1
  50. package/dist/os/windows.d.ts +6 -0
  51. package/dist/os/windows.d.ts.map +1 -1
  52. package/dist/os/windows.js +46 -3
  53. package/dist/os/windows.js.map +1 -1
  54. package/dist/providers/agy.d.ts +115 -6
  55. package/dist/providers/agy.d.ts.map +1 -1
  56. package/dist/providers/agy.js +569 -53
  57. package/dist/providers/agy.js.map +1 -1
  58. package/dist/providers/claude.d.ts +81 -3
  59. package/dist/providers/claude.d.ts.map +1 -1
  60. package/dist/providers/claude.js +344 -10
  61. package/dist/providers/claude.js.map +1 -1
  62. package/dist/providers/codex.d.ts +4 -2
  63. package/dist/providers/codex.d.ts.map +1 -1
  64. package/dist/providers/codex.js +19 -2
  65. package/dist/providers/codex.js.map +1 -1
  66. package/dist/providers/copilot.d.ts +4 -2
  67. package/dist/providers/copilot.d.ts.map +1 -1
  68. package/dist/providers/copilot.js +20 -2
  69. package/dist/providers/copilot.js.map +1 -1
  70. package/dist/providers/none.d.ts +4 -2
  71. package/dist/providers/none.d.ts.map +1 -1
  72. package/dist/providers/none.js +17 -2
  73. package/dist/providers/none.js.map +1 -1
  74. package/dist/providers/opencode.d.ts +3 -1
  75. package/dist/providers/opencode.d.ts.map +1 -1
  76. package/dist/providers/opencode.js +22 -2
  77. package/dist/providers/opencode.js.map +1 -1
  78. package/dist/providers/provider.d.ts +201 -6
  79. package/dist/providers/provider.d.ts.map +1 -1
  80. package/dist/providers/provider.js +56 -0
  81. package/dist/providers/provider.js.map +1 -1
  82. package/dist/services/agy-project.d.ts +102 -0
  83. package/dist/services/agy-project.d.ts.map +1 -0
  84. package/dist/services/agy-project.js +356 -0
  85. package/dist/services/agy-project.js.map +1 -0
  86. package/dist/services/auth-socket.js +4 -4
  87. package/dist/services/auth-web.js +1 -1
  88. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  89. package/dist/services/cloud/lifecycle.js +33 -4
  90. package/dist/services/cloud/lifecycle.js.map +1 -1
  91. package/dist/services/credential-cleanup.d.ts.map +1 -1
  92. package/dist/services/credential-cleanup.js +35 -17
  93. package/dist/services/credential-cleanup.js.map +1 -1
  94. package/dist/services/exit-drain.d.ts +44 -0
  95. package/dist/services/exit-drain.d.ts.map +1 -0
  96. package/dist/services/exit-drain.js +52 -0
  97. package/dist/services/exit-drain.js.map +1 -0
  98. package/dist/services/github-app.d.ts.map +1 -1
  99. package/dist/services/github-app.js +32 -4
  100. package/dist/services/github-app.js.map +1 -1
  101. package/dist/services/http-transport.d.ts +1 -0
  102. package/dist/services/http-transport.d.ts.map +1 -1
  103. package/dist/services/http-transport.js +48 -1
  104. package/dist/services/http-transport.js.map +1 -1
  105. package/dist/services/knowledge/kb-config.d.ts +42 -0
  106. package/dist/services/knowledge/kb-config.d.ts.map +1 -0
  107. package/dist/services/knowledge/kb-config.js +54 -0
  108. package/dist/services/knowledge/kb-config.js.map +1 -0
  109. package/dist/services/knowledge/kb-providers.d.ts +7 -1
  110. package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
  111. package/dist/services/knowledge/kb-providers.js +191 -17
  112. package/dist/services/knowledge/kb-providers.js.map +1 -1
  113. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  114. package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
  115. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  116. package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
  117. package/dist/services/model-pricing.d.ts.map +1 -1
  118. package/dist/services/model-pricing.js +7 -3
  119. package/dist/services/model-pricing.js.map +1 -1
  120. package/dist/services/secret-token.d.ts +38 -0
  121. package/dist/services/secret-token.d.ts.map +1 -0
  122. package/dist/services/secret-token.js +51 -0
  123. package/dist/services/secret-token.js.map +1 -0
  124. package/dist/services/service-manager/types.d.ts +3 -1
  125. package/dist/services/service-manager/types.d.ts.map +1 -1
  126. package/dist/services/service-manager/windows.d.ts +14 -2
  127. package/dist/services/service-manager/windows.d.ts.map +1 -1
  128. package/dist/services/service-manager/windows.js +65 -7
  129. package/dist/services/service-manager/windows.js.map +1 -1
  130. package/dist/services/ssh.d.ts.map +1 -1
  131. package/dist/services/ssh.js +58 -2
  132. package/dist/services/ssh.js.map +1 -1
  133. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  134. package/dist/services/stall/read-log-tail.js +20 -10
  135. package/dist/services/stall/read-log-tail.js.map +1 -1
  136. package/dist/services/stall/stall-detector.d.ts +53 -4
  137. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  138. package/dist/services/stall/stall-detector.js +212 -34
  139. package/dist/services/stall/stall-detector.js.map +1 -1
  140. package/dist/services/strategy.d.ts.map +1 -1
  141. package/dist/services/strategy.js +79 -2
  142. package/dist/services/strategy.js.map +1 -1
  143. package/dist/services/substitution-engine.js +2 -2
  144. package/dist/services/substitution-engine.js.map +1 -1
  145. package/dist/services/tool-registry.d.ts.map +1 -1
  146. package/dist/services/tool-registry.js +5 -3
  147. package/dist/services/tool-registry.js.map +1 -1
  148. package/dist/services/vcs/azure-devops.d.ts +66 -1
  149. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  150. package/dist/services/vcs/azure-devops.js +192 -21
  151. package/dist/services/vcs/azure-devops.js.map +1 -1
  152. package/dist/services/vcs/types.d.ts +1 -1
  153. package/dist/skills/fleet-sprint-cli/SKILL.md +18 -0
  154. package/dist/skills/pm/SKILL.md +1 -1
  155. package/dist/skills/pm/cost.md +0 -3
  156. package/dist/skills/pm/fleet-addendum.md +2 -2
  157. package/dist/tools/check-status.d.ts +7 -4
  158. package/dist/tools/check-status.d.ts.map +1 -1
  159. package/dist/tools/check-status.js +2 -0
  160. package/dist/tools/check-status.js.map +1 -1
  161. package/dist/tools/compose-permissions.d.ts +6 -0
  162. package/dist/tools/compose-permissions.d.ts.map +1 -1
  163. package/dist/tools/compose-permissions.js +182 -34
  164. package/dist/tools/compose-permissions.js.map +1 -1
  165. package/dist/tools/credential-store-set.js +1 -1
  166. package/dist/tools/execute-command.d.ts.map +1 -1
  167. package/dist/tools/execute-command.js +31 -20
  168. package/dist/tools/execute-command.js.map +1 -1
  169. package/dist/tools/execute-prompt.d.ts +15 -2
  170. package/dist/tools/execute-prompt.d.ts.map +1 -1
  171. package/dist/tools/execute-prompt.js +1196 -892
  172. package/dist/tools/execute-prompt.js.map +1 -1
  173. package/dist/tools/kb-capture.d.ts +2 -2
  174. package/dist/tools/kb-capture.d.ts.map +1 -1
  175. package/dist/tools/kb-capture.js +29 -5
  176. package/dist/tools/kb-capture.js.map +1 -1
  177. package/dist/tools/kb-export.d.ts +2 -2
  178. package/dist/tools/kb-export.d.ts.map +1 -1
  179. package/dist/tools/kb-export.js +3 -28
  180. package/dist/tools/kb-export.js.map +1 -1
  181. package/dist/tools/kb-feedback.d.ts.map +1 -1
  182. package/dist/tools/kb-feedback.js +3 -1
  183. package/dist/tools/kb-feedback.js.map +1 -1
  184. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
  185. package/dist/tools/kb-freshness-sweep.js +3 -1
  186. package/dist/tools/kb-freshness-sweep.js.map +1 -1
  187. package/dist/tools/kb-import.d.ts.map +1 -1
  188. package/dist/tools/kb-import.js +2 -1
  189. package/dist/tools/kb-import.js.map +1 -1
  190. package/dist/tools/kb-list.d.ts.map +1 -1
  191. package/dist/tools/kb-list.js +3 -1
  192. package/dist/tools/kb-list.js.map +1 -1
  193. package/dist/tools/kb-query.d.ts +2 -2
  194. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
  195. package/dist/tools/kb-reconcile-prefilter.js +3 -1
  196. package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
  197. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
  198. package/dist/tools/kb-resolve-contradiction.js +3 -1
  199. package/dist/tools/kb-resolve-contradiction.js.map +1 -1
  200. package/dist/tools/kb-setup.d.ts.map +1 -1
  201. package/dist/tools/kb-setup.js +125 -20
  202. package/dist/tools/kb-setup.js.map +1 -1
  203. package/dist/tools/kb-stats.d.ts.map +1 -1
  204. package/dist/tools/kb-stats.js +64 -43
  205. package/dist/tools/kb-stats.js.map +1 -1
  206. package/dist/tools/list-members.d.ts +2 -2
  207. package/dist/tools/list-members.d.ts.map +1 -1
  208. package/dist/tools/list-members.js +1 -0
  209. package/dist/tools/list-members.js.map +1 -1
  210. package/dist/tools/member-detail.d.ts +2 -2
  211. package/dist/tools/member-detail.d.ts.map +1 -1
  212. package/dist/tools/member-detail.js +17 -0
  213. package/dist/tools/member-detail.js.map +1 -1
  214. package/dist/tools/member-reservation.d.ts +58 -1
  215. package/dist/tools/member-reservation.d.ts.map +1 -1
  216. package/dist/tools/member-reservation.js +61 -20
  217. package/dist/tools/member-reservation.js.map +1 -1
  218. package/dist/tools/provision-auth.d.ts +80 -1
  219. package/dist/tools/provision-auth.d.ts.map +1 -1
  220. package/dist/tools/provision-auth.js +142 -54
  221. package/dist/tools/provision-auth.js.map +1 -1
  222. package/dist/tools/provision-vcs-auth.d.ts +91 -1
  223. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  224. package/dist/tools/provision-vcs-auth.js +209 -49
  225. package/dist/tools/provision-vcs-auth.js.map +1 -1
  226. package/dist/tools/register-member.d.ts +12 -9
  227. package/dist/tools/register-member.d.ts.map +1 -1
  228. package/dist/tools/register-member.js +99 -12
  229. package/dist/tools/register-member.js.map +1 -1
  230. package/dist/tools/remove-member.d.ts.map +1 -1
  231. package/dist/tools/remove-member.js +27 -2
  232. package/dist/tools/remove-member.js.map +1 -1
  233. package/dist/tools/send-email.d.ts +2 -2
  234. package/dist/tools/setup-git-app.d.ts.map +1 -1
  235. package/dist/tools/setup-git-app.js +11 -7
  236. package/dist/tools/setup-git-app.js.map +1 -1
  237. package/dist/tools/shutdown-server.d.ts +2 -0
  238. package/dist/tools/shutdown-server.d.ts.map +1 -1
  239. package/dist/tools/shutdown-server.js +23 -1
  240. package/dist/tools/shutdown-server.js.map +1 -1
  241. package/dist/tools/update-member.d.ts +12 -9
  242. package/dist/tools/update-member.d.ts.map +1 -1
  243. package/dist/tools/update-member.js +43 -11
  244. package/dist/tools/update-member.js.map +1 -1
  245. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  246. package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
  247. package/dist/tools/vcs-credential-exec.js +197 -0
  248. package/dist/tools/vcs-credential-exec.js.map +1 -0
  249. package/dist/types.d.ts +13 -0
  250. package/dist/types.d.ts.map +1 -1
  251. package/dist/utils/log-helpers.d.ts.map +1 -1
  252. package/dist/utils/log-helpers.js +2 -2
  253. package/dist/utils/log-helpers.js.map +1 -1
  254. package/dist/utils/prompt-errors.d.ts.map +1 -1
  255. package/dist/utils/prompt-errors.js +7 -1
  256. package/dist/utils/prompt-errors.js.map +1 -1
  257. package/dist/utils/shell-escape.d.ts +16 -0
  258. package/dist/utils/shell-escape.d.ts.map +1 -1
  259. package/dist/utils/shell-escape.js +22 -2
  260. package/dist/utils/shell-escape.js.map +1 -1
  261. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  262. package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
  263. package/dist/utils/vcs-provider-detect.js +109 -0
  264. package/dist/utils/vcs-provider-detect.js.map +1 -0
  265. package/dist/utils/workspace-trust.d.ts +20 -17
  266. package/dist/utils/workspace-trust.d.ts.map +1 -1
  267. package/dist/utils/workspace-trust.js +87 -1
  268. package/dist/utils/workspace-trust.js.map +1 -1
  269. package/dist/workflows/auto-sprint.js +176 -15
  270. package/package.json +6 -4
  271. package/packages/apra-fleet-client/src/client/api.mjs +319 -17
  272. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  273. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  274. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +25 -0
  275. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +11 -0
  276. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -2
  277. package/packages/apra-fleet-se/apra-pm/agents/doer.md +36 -12
  278. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +11 -0
  279. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +11 -0
  280. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +9 -0
  281. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +110 -22
  282. package/packages/apra-fleet-se/apra-pm/agents/planner.md +125 -37
  283. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +11 -0
  284. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +13 -2
  285. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  286. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -1
  287. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  288. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  289. package/packages/apra-fleet-se/bin/cli.mjs +149 -1
  290. package/packages/apra-fleet-se/bin/serve.mjs +78 -4
  291. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
  292. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
  293. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
  294. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
  295. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
  296. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
  297. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  298. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
  299. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +61 -14
  300. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
  301. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
  302. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
  303. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  304. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +1 -1
  305. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +276 -0
  306. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  307. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  308. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  309. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +996 -32
  310. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +267 -0
  311. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  312. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  313. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  314. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
  315. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
  316. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
  317. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  318. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
  319. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  320. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
  321. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
  322. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  323. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  324. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  325. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
  326. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
  327. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
  328. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
  329. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
  330. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  331. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
  332. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
  333. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
  334. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
  335. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
  336. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
  337. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
  338. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
  339. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  340. package/packages/apra-fleet-se/fleet-sprint/runner.js +1467 -9798
  341. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +17 -12
  342. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
  343. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +18 -0
  344. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
  345. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
  346. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
  347. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
  348. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  349. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
  350. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
  351. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +153 -19
  352. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +71 -21
  353. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  354. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +131 -0
  355. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +140 -16
  356. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +1 -0
  357. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +77 -2
  358. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  359. package/packages/apra-fleet-se/package.json +1 -1
  360. package/packages/apra-fleet-workflow/src/viewer/index.mjs +17 -6
  361. package/packages/apra-fleet-workflow/src/workflow/index.mjs +49 -7
  362. package/skills/fleet/SKILL.md +8 -8
  363. package/skills/fleet/auth-azdevops.md +14 -3
  364. package/skills/fleet/auth-bitbucket.md +2 -2
  365. package/skills/fleet/auth-github.md +5 -4
  366. package/skills/fleet/onboarding.md +3 -3
  367. package/skills/fleet/permissions.md +5 -1
  368. package/skills/fleet/profiles/node.json +1 -1
  369. package/skills/fleet/troubleshooting.md +3 -3
  370. package/version.json +1 -1
@@ -0,0 +1,75 @@
1
+ // =============================================================================
2
+ // Shared MCP result-text helpers (apra-fleet-3swo.2.4).
3
+ //
4
+ // Extracted move-only from fleet-sprint/runner.js, which defined `resultText`
5
+ // TWICE as identical inner functions (inside createMemberReservationClient and
6
+ // createMemberSessionGuard) plus a separate module-level `toolErrorText`. This
7
+ // module is now the single owner of both; runner.js imports and re-exports
8
+ // them so its existing facade (67 direct importers) stays intact.
9
+ //
10
+ // Behavior is unchanged, including how an empty or missing MCP `content`
11
+ // array is handled: `resultText` returns '' in that case, which several
12
+ // runner.js call sites log with a `|| '(no detail)'` fallback that appears
13
+ // verbatim in golden transcripts -- do not change this without checking those
14
+ // fixtures.
15
+ //
16
+ // content[0] is NOT reliably the tool result: src/services/tool-registry.ts
17
+ // wrapTool() may prepend a user-audience onboarding/welcome-back display
18
+ // banner ahead of the real result (and append a nudge suffix banner after
19
+ // it). resultText skips any content entry that is such a banner --
20
+ // identified by annotations.audience containing 'user', or by its text
21
+ // containing an <apra-fleet-display> open tag as a belt-and-braces fallback
22
+ // -- and returns the first entry that is not one.
23
+ // =============================================================================
24
+
25
+ /**
26
+ * True when a content entry is a user-audience display banner (onboarding
27
+ * preamble or nudge suffix) rather than actual tool output.
28
+ * @param {any} entry
29
+ * @returns {boolean}
30
+ */
31
+ function isDisplayBanner(entry) {
32
+ if (!entry) return false;
33
+ if (entry.annotations && Array.isArray(entry.annotations.audience) && entry.annotations.audience.includes('user')) {
34
+ return true;
35
+ }
36
+ return typeof entry.text === 'string' && /<apra-fleet-display[^>]*>/i.test(entry.text);
37
+ }
38
+
39
+ /**
40
+ * Best-effort human-readable text out of an MCP tool result's content array.
41
+ * Accepts a raw string result too (some callers pass one through directly).
42
+ * @param {any} result
43
+ * @returns {string}
44
+ */
45
+ export function resultText(result) {
46
+ if (typeof result === 'string') return result;
47
+ if (result && Array.isArray(result.content)) {
48
+ for (const entry of result.content) {
49
+ if (entry && typeof entry.text === 'string' && !isDisplayBanner(entry)) {
50
+ return entry.text;
51
+ }
52
+ }
53
+ }
54
+ return '';
55
+ }
56
+
57
+ /**
58
+ * Best-effort human-readable text out of an MCP error result, for logging.
59
+ * Skips any display banner the same way resultText() does (apra-fleet-3swo.63):
60
+ * content[0] is not reliably the tool's error text -- wrapTool() may prepend a
61
+ * user-audience onboarding/welcome-back banner ahead of it -- so an unfiltered
62
+ * `res.content[0]` read can log the banner text as if it were the error.
63
+ * @param {any} res
64
+ * @returns {string}
65
+ */
66
+ export function toolErrorText(res) {
67
+ if (res && Array.isArray(res.content)) {
68
+ for (const entry of res.content) {
69
+ if (entry && typeof entry.text === 'string' && entry.text && !isDisplayBanner(entry)) {
70
+ return entry.text;
71
+ }
72
+ }
73
+ }
74
+ return 'no error text returned';
75
+ }
@@ -0,0 +1,252 @@
1
+ // Member-provisioning helpers -- extracted move-only out of runner.js
2
+ // (apra-fleet-3swo.6.12). This module owns:
3
+ //
4
+ // 1. createMemberSessionGuard -- the pre-resume `stop_prompt` guard that
5
+ // kills a prior, presumed-dead-or-timed-out session on a member before a
6
+ // resume re-dispatch, so two live sessions never duplicate one logical
7
+ // dispatch's side effects.
8
+ // 2. createUnattendedAutoProvisioner -- best-effort sets a member's
9
+ // `unattended: 'auto'` registration before it is dispatched as deployer/
10
+ // integ-test-runner/regression-test-runner, cached per member for the
11
+ // lifetime of the returned function.
12
+ // 3. createDeployPermissionsProvisioner -- best-effort self-heal that reads
13
+ // deploy.md's own `## Permissions` section off the first target member
14
+ // it provisions and proactively grants every listed prefix via
15
+ // compose_permissions, so a runbook permissions change does not have to
16
+ // wait for a dispatch to fail before anyone notices.
17
+ // 4. stageCommandBodyMemberSide -- stages free-text content to a fresh,
18
+ // member-LOCAL temp file via a shell-agnostic `node -e` one-liner (base64
19
+ // argv, no `$`-expansion/backticks/template literals), so a `bd
20
+ // --body-file` read always finds its file on the same filesystem the
21
+ // subsequent `bd` command runs on.
22
+ //
23
+ // WHAT DID NOT MOVE -- resolveSettleShell. It sat in the middle of this group
24
+ // in runner.js and is module-private wiring: it resolves a member's settle
25
+ // shell from the per-sprint sprintState that sprint-state.mjs introduced,
26
+ // which is composition-root wiring rather than an implementation helper.
27
+ // test/sprint-state.test.mjs also anchors it to runner.js by symbol. It stays
28
+ // defined and exported from runner.js; nothing here imports it back, since
29
+ // none of the four moved symbols call it.
30
+ //
31
+ // runner.js re-exports every symbol it previously exported from this region,
32
+ // so existing importers of fleet-sprint/runner.js resolve unchanged.
33
+ //
34
+ // GUARD REGISTRATION: this module is registered in ./guarded-modules.mjs as
35
+ // part of this extraction (see that file's STANDING RULE). It carries the two
36
+ // member_name-bearing command() call sites this extraction took out of
37
+ // runner.js: createDeployPermissionsProvisioner's `node -e ...` read of
38
+ // deploy.md's Permissions section, and stageCommandBodyMemberSide's `node -e
39
+ // ...` member-side temp-file write. Both already avoid shell-level variable
40
+ // expansion (base64-encoded argv, no `$`/backtick/template-literal
41
+ // interpolation), which is exactly the invariant shell-command-guard.mjs
42
+ // enforces and reads GUARDED_MODULES to find.
43
+
44
+ import { ApraFleet } from '@apralabs/apra-fleet-client';
45
+ import { resultText } from './mcp-result.mjs';
46
+
47
+ /**
48
+ * Guards every "resume" re-dispatch below against spawning a second
49
+ * concurrent session on a member whose PRIOR process for that same logical
50
+ * dispatch is presumed dead or timed out but may still be alive -- two live
51
+ * sessions for one dispatch duplicate whatever side effects the orphaned one
52
+ * performs.
53
+ *
54
+ * Before firing a resume, call the fleet's own `stop_prompt` tool
55
+ * (src/tools/stop-prompt.ts) for that member: it kills whatever process is
56
+ * still on record and is a no-op when nothing is running, so pid liveness is
57
+ * never reimplemented here.
58
+ *
59
+ * `callTool` is injected (the caller's MCP client), so this stays
60
+ * transport-agnostic and unit-testable without a live fleet server. When it
61
+ * is omitted, `killIfAlive()` is a no-op -- there is no live fleet connection
62
+ * to guard against, matching every other best-effort client in this file when
63
+ * its transport is absent.
64
+ *
65
+ * Best-effort by design: a `stop_prompt` failure is logged and swallowed
66
+ * rather than blocking the resume -- the resume is what the sprint needs to
67
+ * make progress, and this guard REDUCES rather than gates the chance of a
68
+ * duplicate concurrent session.
69
+ *
70
+ * @param {{ callTool?: (name: string, args: object) => Promise<any>, log?: Function }} opts
71
+ * @returns {{ killIfAlive: (member: string) => Promise<void> }}
72
+ */
73
+ export function createMemberSessionGuard(opts = {}) {
74
+ const { callTool, log = () => {} } = opts;
75
+ const active = typeof callTool === 'function';
76
+
77
+ return {
78
+ async killIfAlive(member) {
79
+ if (!active || !member) return;
80
+ try {
81
+ const result = await callTool('stop_prompt', { member_name: member });
82
+ log(`[member-session-guard] pre-resume stop_prompt for '${member}': ${resultText(result) || '(no detail)'}`);
83
+ } catch (err) {
84
+ log(`[member-session-guard] pre-resume stop_prompt for '${member}' failed (non-fatal; resume proceeds): ${err.message}`);
85
+ }
86
+ },
87
+ };
88
+ }
89
+
90
+ /**
91
+ * Best-effort provisions a member for unattended execution (`unattended:
92
+ * 'auto'`) before dispatching it as deployer, integ-test-runner, or
93
+ * regression-test-runner -- roles that run real deploy commands and test
94
+ * suites via a runbook and must never stall on an interactive permission
95
+ * prompt. Provisioning is a one-way member-registration change and is
96
+ * deliberately NOT reverted after the dispatch: `unattended` lives on the
97
+ * member (update_member), not on the dispatch, so there is nothing to revert
98
+ * to without also clobbering whatever the user set intentionally. In a
99
+ * single-member sprint the same member also plays doer/reviewer/etc, so it
100
+ * ends up unattended='auto' too -- accepted, not a bug.
101
+ *
102
+ * Cached per member for the lifetime of the returned function, so a sprint
103
+ * with many deploy/integ/regression dispatches across cycles calls
104
+ * update_member at most once per member. A failure (fleet unreachable,
105
+ * member not found) is logged and swallowed -- exactly like
106
+ * createMemberVcsProviderResolver above -- so a provisioning hiccup degrades
107
+ * to whatever permission mode the member already had, rather than aborting
108
+ * the phase.
109
+ *
110
+ * `callTool` is injected (the caller's MCP client), so this stays
111
+ * transport-agnostic and unit-testable without a live fleet server.
112
+ *
113
+ * @param {{ callTool: (name: string, args: object) => Promise<any>, log?: Function }} opts
114
+ * @returns {(member: string) => Promise<void>}
115
+ */
116
+ export function createUnattendedAutoProvisioner(opts = {}) {
117
+ const { callTool, log = () => {} } = opts;
118
+ const fleetApi = new ApraFleet({ callTool });
119
+ /** @type {Set<string>} members already confirmed unattended='auto' this run. */
120
+ const provisioned = new Set();
121
+
122
+ return async function ensureUnattendedAuto(member) {
123
+ if (provisioned.has(member)) return;
124
+ try {
125
+ await fleetApi.updateMember({ member_name: member, unattended: 'auto' });
126
+ provisioned.add(member);
127
+ log(`[unattended] member '${member}' set to unattended='auto' for this dispatch.`);
128
+ } catch (err) {
129
+ log(`[unattended] could not set unattended='auto' on member '${member}' (continuing with its existing permission mode): ${err.message}`);
130
+ }
131
+ };
132
+ }
133
+
134
+ /**
135
+ * Best-effort, self-heals the "Missing permission" class of deploy/integ/
136
+ * regression-test failure BEFORE it happens: reads deploy.md's own
137
+ * `## Permissions` section -- the exact list the deployer/integ-test-runner/
138
+ * regression-test-runner agent prompts already cross-check at their own
139
+ * Step 0a/0 -- and proactively grants every listed prefix to the target
140
+ * member via compose_permissions. Without this, a runbook permissions
141
+ * change (e.g. the `apra-fleet start` -> `apra-fleet run` swap, #395) only
142
+ * gets noticed when a dispatch fails, and only gets fixed once an operator
143
+ * greps deploy.md by hand and runs compose_permissions manually -- exactly
144
+ * the failure mode this closes the loop on.
145
+ *
146
+ * Reads deploy.md via `command()` against the FIRST target member it is asked
147
+ * to provision (that member is about to be dispatched as deployer/
148
+ * integ-test-runner/regression-test-runner, so its own checkout is the source
149
+ * of truth for what it is about to run) and caches the parsed prefix list for
150
+ * the lifetime of the returned function -- one read per sprint run, since
151
+ * deploy.md does not change mid-run on a healthy pipeline. Also caches per
152
+ * TARGET member, like createUnattendedAutoProvisioner above, so repeat cycles
153
+ * don't re-grant. Deliberately does NOT read via a separate orchestrator
154
+ * member: the orchestrator role may be shared/unreservable across concurrent
155
+ * sprints and carries no git checkout of its own to read from.
156
+ *
157
+ * Failure at any step (probe fails, deploy.md missing/unparseable,
158
+ * compose_permissions unreachable, a listed prefix hitting the
159
+ * NEVER_AUTO_GRANT denylist) is logged and swallowed. This is pure
160
+ * best-effort acceleration -- the deployer's own Step 0a check remains the
161
+ * authoritative, fail-closed backstop regardless of whether this succeeds.
162
+ *
163
+ * @param {{ callTool: (name: string, args: object) => Promise<any>, command: Function, log?: Function }} opts
164
+ * @returns {(member: string) => Promise<void>}
165
+ */
166
+ export function createDeployPermissionsProvisioner(opts = {}) {
167
+ const { callTool, command, log = () => {} } = opts;
168
+ const fleetApi = new ApraFleet({ callTool });
169
+ /** @type {Set<string>} members already granted deploy.md's permissions this run. */
170
+ const provisioned = new Set();
171
+ /** @type {string[] | null | undefined} undefined = not yet attempted. */
172
+ let cachedPrefixes;
173
+
174
+ async function loadRequiredPrefixes(targetMember) {
175
+ if (cachedPrefixes !== undefined) return cachedPrefixes;
176
+ try {
177
+ const res = await command(
178
+ `node -e "const fs=require('fs'); if(fs.existsSync('deploy.md')) process.stdout.write(fs.readFileSync('deploy.md','utf8'))"`,
179
+ { member_name: targetMember, silent: true, label: `Read deploy.md permissions`, failSoft: true },
180
+ );
181
+ if (!res.ok || !res.output) {
182
+ cachedPrefixes = null;
183
+ } else {
184
+ const section = res.output.split(/^## Permissions/m)[1]?.split(/^## /m)[0] ?? '';
185
+ const prefixes = [...section.matchAll(/^-\s*`([^`]+)`/gm)].map(m => m[1]);
186
+ cachedPrefixes = prefixes.length ? prefixes : null;
187
+ }
188
+ } catch (err) {
189
+ log(`[deploy-permissions] could not read deploy.md's Permissions section (continuing without auto-provisioning): ${err.message}`);
190
+ cachedPrefixes = null;
191
+ }
192
+ return cachedPrefixes;
193
+ }
194
+
195
+ return async function ensureDeployPermissions(member) {
196
+ if (!member || provisioned.has(member)) return;
197
+ const prefixes = await loadRequiredPrefixes(member);
198
+ if (!prefixes) return;
199
+ try {
200
+ const result = await fleetApi.composePermissions({
201
+ member_name: member,
202
+ role: 'doer',
203
+ grant: prefixes,
204
+ grant_reason: "deploy.md's declared Permissions section, auto-provisioned before dispatch",
205
+ });
206
+ provisioned.add(member);
207
+ log(`[deploy-permissions] ensured deploy.md's required permissions on '${member}': ${result}`);
208
+ } catch (err) {
209
+ log(`[deploy-permissions] could not auto-provision deploy.md permissions on '${member}' (continuing -- the deployer's own Step 0a check remains the backstop): ${err.message}`);
210
+ }
211
+ };
212
+ }
213
+
214
+ /**
215
+ * Stage `content` to a fresh temp file ON THE MEMBER that will run the
216
+ * subsequent `bd` command, and return that MEMBER-LOCAL absolute path.
217
+ * `command()` may dispatch `bd` to a different machine than the workflow
218
+ * engine runs on, so a body file written to the engine host's own tmpdir
219
+ * would not exist where `bd --body-file` reads it. Staging via `command()`
220
+ * (member_name: member) guarantees the file lands on the SAME filesystem.
221
+ *
222
+ * The write is performed by a member-side `node` one-liner -- `node` is
223
+ * present on every fleet member -- and the recipe is shell-agnostic: it
224
+ * contains no `$`-expansion, backticks, template literals, or `%`-vars, so it
225
+ * is inert as syntax in POSIX shells, PowerShell, and cmd.exe alike.
226
+ * `content` is base64-encoded and passed as a SINGLE argv token whose
227
+ * alphabet (A-Za-z0-9+/=) is likewise inert in all of those shells, and node
228
+ * decodes it back to the exact literal bytes. This is the injection-safety
229
+ * property: caller-supplied free text is NEVER interpolated into the shell
230
+ * command string. The staged file is a member-side OS temp file the member's
231
+ * OS reaps on its own.
232
+ * @param {{ command: Function, member: string, content: string, label?: string }} opts
233
+ * @returns {Promise<string>} the MEMBER-LOCAL temp file path
234
+ */
235
+ export async function stageCommandBodyMemberSide({ command, member, content, label }) {
236
+ const b64 = Buffer.from(content, 'utf-8').toString('base64');
237
+ // No backticks / no `$` / no template literals: inert across POSIX,
238
+ // PowerShell, and cmd.exe. Reads the base64 body from argv[1] (the first
239
+ // arg after the `-e` script), decodes it to raw bytes, writes them to a
240
+ // fresh member-local temp file, and prints ONLY that path to stdout.
241
+ const stageScript =
242
+ "const os=require('os'),p=require('path'),fs=require('fs');" +
243
+ "const f=p.join(os.tmpdir(),'fleet-sprint-body-'+process.pid+'-'+Date.now()+'-'+Math.random().toString(36).slice(2)+'.txt');" +
244
+ "fs.writeFileSync(f,Buffer.from(process.argv[1],'base64'));process.stdout.write(f)";
245
+ const out = await command(
246
+ `node -e "${stageScript}" "${b64}"`,
247
+ { member_name: member, silent: true, label: label ?? 'Stage bd body file member-side' }
248
+ );
249
+ const staged = String(out ?? '').trim();
250
+ if (!staged) throw new Error('member-side body staging returned an empty path');
251
+ return staged;
252
+ }