@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
@@ -657,12 +657,37 @@ export class FleetWorkflow extends EventEmitter {
657
657
  * guard is set, that guard returning truthy. Calling it while already
658
658
  * paused or pause-requested is a no-op.
659
659
  *
660
+ * (apra-fleet-hzeb.3) Also exposed on the script context (see
661
+ * _bindPrimitives), so a running workflow script can initiate a pause
662
+ * for a condition only IT can detect (e.g. a provider usage/rate limit
663
+ * signal) -- not just the dashboard/operator via requestStop()'s sibling
664
+ * instance-level API. A script-initiated pause is indistinguishable from
665
+ * an operator-initiated one downstream: it fires the exact same
666
+ * 'pause:requested'/'paused'/'resumed' events, so any existing listener
667
+ * (the dashboard viewer's state.pause wiring, fleet-sprint's
668
+ * cli.mjs `on('paused', releaseForPause)` /
669
+ * `setPreResumeHook(reReserveForResume)`) engages for it unchanged.
670
+ *
660
671
  * @param {string} [reason]
672
+ * @param {{ resumeAt?: string, source?: string }} [opts] - Optional
673
+ * metadata carried on the 'pause:requested' payload (apra-fleet-hzeb.3):
674
+ * `resumeAt` is an ISO-8601 timestamp (or any caller-defined string) the
675
+ * caller expects the condition to clear by -- e.g. a provider's
676
+ * usage-limit reset time -- surfaced by the dashboard viewer in the
677
+ * paused banner. `source` identifies what requested the pause (e.g.
678
+ * `'usage_limit'`) for the same display purpose. Both are purely
679
+ * informational to the engine, which does not interpret or act on
680
+ * them. Omitting `opts` is fully backwards compatible with existing
681
+ * single-arg callers.
661
682
  */
662
- requestPause(reason = 'Workflow run paused via requestPause()') {
683
+ requestPause(reason = 'Workflow run paused via requestPause()', opts = {}) {
663
684
  if (this._paused || this._pauseRequested) return;
664
685
  this._pauseRequested = true;
665
- this.emit('pause:requested', this._pauseEventPayload({ reason }));
686
+ this.emit('pause:requested', this._pauseEventPayload({
687
+ reason,
688
+ resumeAt: opts.resumeAt ?? null,
689
+ source: opts.source ?? null
690
+ }));
666
691
  // If we're already quiescent (nothing in flight, guard permits), the
667
692
  // pause engages right now; otherwise it engages later as in-flight
668
693
  // work drains (_exitActivity) or the guard opens (setPauseGuard).
@@ -1257,7 +1282,15 @@ export class FleetWorkflow extends EventEmitter {
1257
1282
  // result.usage is null and cost is null -- the viewer then
1258
1283
  // tallies it as an unknown-cost activity rather than fiction.
1259
1284
  this.emit('activity:end', { ...activityMeta, error: text, duration, usage: result.usage, cost, success: false });
1260
- throw new AgentDispatchError(`[Workflow Error] Agent dispatch failed (${structured.reason || 'unknown'}): ${text}`, { details: { text, reason: structured.reason, member: opts.member_name || opts.member_id } });
1285
+ // apra-fleet-hzeb.2: pure pass-through, no policy decisions here --
1286
+ // when execute_prompt relayed a provider usage-limit signal
1287
+ // (reason: 'usage_limit'), forward its usageLimit block and the
1288
+ // in-flight sessionId onto AgentDispatchError.details unchanged, so
1289
+ // the fleet-sprint pause/resume policy can read
1290
+ // err.details.usageLimit.resumeAt / err.details.sessionId directly
1291
+ // instead of re-parsing the failure text. A permission_denied
1292
+ // result forwards its permissionDenied block the same way.
1293
+ throw new AgentDispatchError(`[Workflow Error] Agent dispatch failed (${structured.reason || 'unknown'}): ${text}`, { details: { text, reason: structured.reason, member: opts.member_name || opts.member_id, ...(structured.usageLimit ? { usageLimit: structured.usageLimit } : {}), ...(structured.permissionDenied ? { permissionDenied: structured.permissionDenied } : {}), ...(structured.sessionId ? { sessionId: structured.sessionId } : {}) } });
1261
1294
  }
1262
1295
 
1263
1296
  // apra-fleet-eft.78.3: surface the resumable session id
@@ -1988,10 +2021,19 @@ export class FleetWorkflow extends EventEmitter {
1988
2021
  endGroup: this.endGroup.bind(this),
1989
2022
  // (apra-fleet-p2to.1) Script-facing: lets the workflow declare
1990
2023
  // where a clean-state boundary is so a deferred pause engages
1991
- // there. requestPause()/requestResume()/requestStop() stay
1992
- // instance-only (driven by the viewer/orchestrator, like
1993
- // requestStop() already is), not part of the script context.
1994
- setPauseGuard: this.setPauseGuard.bind(this)
2024
+ // there.
2025
+ setPauseGuard: this.setPauseGuard.bind(this),
2026
+ // (apra-fleet-hzeb.3) Script-facing pause/resume: a running
2027
+ // script may PARK ITSELF on a condition only it can detect (a
2028
+ // provider usage/rate limit, an external gate) by calling these
2029
+ // directly -- they are the exact same requestPause()/
2030
+ // requestResume() the dashboard/operator use, so a
2031
+ // script-initiated pause fires the identical 'pause:requested'/
2032
+ // 'paused'/'resumed' lifecycle events as an operator-initiated
2033
+ // one. requestStop() remains instance-only/operator-only -- a
2034
+ // script has no business tearing down its own run.
2035
+ requestPause: this.requestPause.bind(this),
2036
+ requestResume: this.requestResume.bind(this)
1995
2037
  };
1996
2038
  }
1997
2039
 
@@ -55,13 +55,13 @@ Beads (`bd` CLI) is installed automatically by `apra-fleet install`. It gives fl
55
55
 
56
56
  See `beads.md` for the full command reference and workflow examples.
57
57
 
58
- ## Secure Credentials
58
+ ## Secret variables
59
59
 
60
- The `{{secure.NAME}}` pattern lets you reference stored secrets in any command without ever exposing plaintext to the LLM or logs.
60
+ The `{{secret.NAME}}` pattern lets you reference stored secrets in any command without ever exposing plaintext to the LLM or logs.
61
61
 
62
62
  **How it works:**
63
63
  1. Store a secret with `credential_store_set` - Fleet opens an OOB terminal prompt, so the value never appears in chat
64
- 2. Reference it as `{{secure.NAME}}` anywhere in a command string passed to `execute_command`, `register_member`, `update_member`, `provision_vcs_auth`, `provision_llm_auth`, or `setup_git_app`
64
+ 2. Reference it as `{{secret.NAME}}` anywhere in a command string passed to `execute_command`, `register_member`, `update_member`, `provision_vcs_auth`, `provision_llm_auth`, or `setup_git_app`
65
65
  3. Fleet resolves the token server-side before execution; LLM does not see the secret.
66
66
 
67
67
  **When to use:**
@@ -69,7 +69,7 @@ The `{{secure.NAME}}` pattern lets you reference stored secrets in any command w
69
69
  - Rotating credentials: `credential_store_delete` then `credential_store_set` - no re-provisioning required
70
70
  - Pre-loading secrets before a dispatch so members can authenticate in commands autonomously
71
71
 
72
- NOTE: **`{{secure.NAME}}` only resolves in specific credential fields** (listed above). Using it in any other parameter (e.g. a prompt, a path field in a non-credential tool, or any other unsupported parameter) will pass the token string through literally - the secret will NOT be injected, and the raw handle name will be visible in logs. Only use `{{secure.NAME}}` in the fields documented above.
72
+ NOTE: **`{{secret.NAME}}` only resolves in specific credential fields** (listed above). Using it in any other parameter (e.g. a prompt, a path field in a non-credential tool, or any other unsupported parameter) will pass the token string through literally - the secret will NOT be injected, and the raw handle name will be visible in logs. Only use `{{secret.NAME}}` in the fields documented above.
73
73
 
74
74
  **Access control (scoping):** Credentials can be scoped to specific members.
75
75
  - `members="*"` (default) - all members can access the credential
@@ -169,9 +169,9 @@ execute_prompt(
169
169
  - If `substitutions` is omitted and file/prompt content contains `{{token}}` patterns, a warning is returned (call still succeeds).
170
170
 
171
171
  **[SECURE] Secrets boundary -- never use substitutions for secrets:**
172
- - Substitution keys with dots (e.g. `secure.github_pat`) are rejected outright.
173
- - `{{secure.NAME}}` patterns in file/prompt content pass through verbatim - they are resolved later only by `execute_command` via the credential store, not here.
174
- - Substitution values are never logged. But callers must not put plaintext secrets in substitution values; use `{{secure.NAME}}` in `execute_command` for secrets.
172
+ - Substitution keys with dots (e.g. `secret.github_pat`) are rejected outright.
173
+ - `{{secret.NAME}}` patterns in file/prompt content pass through verbatim - they are resolved later only by `execute_command` via the credential store, not here.
174
+ - Substitution values are never logged. But callers must not put plaintext secrets in substitution values; use `{{secret.NAME}}` in `execute_command` for secrets.
175
175
 
176
176
  ## Permissions
177
177
 
@@ -253,7 +253,7 @@ Per-provider flag behaviour:
253
253
  | Provider | `'auto'` flag | `'dangerous'` flag |
254
254
  |----------|--------------|-------------------|
255
255
  | Claude | `--permission-mode auto` | `--dangerously-skip-permissions` |
256
- | Antigravity (agy) | None (config-file only via `compose_permissions`) | `--dangerously-skip-permissions` |
256
+ | Antigravity (agy) | `--mode accept-edits` (same as default; grants come from `compose_permissions`) | `--dangerously-skip-permissions` |
257
257
  | OpenCode | `--auto` | `--dangerously-skip-permissions` |
258
258
  | Codex | `--ask-for-approval auto-edit` | `--sandbox danger-full-access --ask-for-approval never` |
259
259
  | Copilot | Not supported - warns and runs interactively | Not supported |
@@ -39,7 +39,7 @@ The credential is entered via the out-of-band prompt during `provision_vcs_auth`
39
39
 
40
40
  ```
41
41
  credential_store_set name=azdevops_pat
42
- execute_command command="curl -sf -u :{{secure.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
42
+ execute_command command="curl -sf -u :{{secret.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
43
43
  ```
44
44
 
45
45
  **Per-sprint override:** To use a different credential name for a specific sprint (for example, when working with a different Azure DevOps organization or test repo), pass the `azdevops_pat_secret_name` argument to the sprint invocation (threaded through `packages/apra-fleet-se/fleet-sprint/runner.js`). It must name a credential already stored via `credential_store_set`; the runner validates it as a credential-store name at contract-validation time and uses it instead of the default `azdevops_pat` entry for provisioning, self-heal, and preflight checks on that sprint.
@@ -63,11 +63,22 @@ curl -sf -u :pat "https://dev.azure.com/{org}/_apis/projects?api-version=7.1&\$t
63
63
  git ls-remote https://dev.azure.com/{org}/{project}/_git/{repo} HEAD
64
64
  ```
65
65
 
66
+ ## Legacy `<org>.visualstudio.com` remotes
67
+
68
+ git looks credentials up by the remote's own hostname, so a PAT bound to
69
+ `dev.azure.com` is never offered for a push to `https://<org>.visualstudio.com/...`.
70
+ Pass `scope_url="https://<org>.visualstudio.com"` to `provision_vcs_auth`
71
+ (fleet-sprint does this automatically from the member's remote). `org_url`
72
+ stays `https://dev.azure.com/<org>` -- the REST API serves every org there.
73
+ An ssh remote (`vs-ssh.visualstudio.com` / `ssh.dev.azure.com`) cannot take a
74
+ PAT at all: push uses the member's SSH key; the PAT serves only REST calls.
75
+
66
76
  ## Troubleshooting
67
77
 
68
78
  | Symptom | Fix |
69
79
  |---------|-----|
70
80
  | 401 Unauthorized | Create new PAT and re-deploy |
81
+ | push to `<org>.visualstudio.com` prompts / 401 while REST works | Re-provision with `scope_url="https://<org>.visualstudio.com"` |
71
82
  | 403 Forbidden | Create PAT with broader scopes |
72
83
  | TF400813: Resource not available | Verify org URL matches `https://dev.azure.com/{org}` |
73
84
  | Clone prompts for password | Re-run `provision_vcs_auth` |
@@ -97,8 +108,8 @@ credential_store_set name=azdevops_pat
97
108
  **Use it in a command on a member:**
98
109
 
99
110
  ```
100
- execute_command command="curl -sf -u :{{secure.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
101
- execute_command command="git remote set-url origin https://token:{{secure.azdevops_pat}}@dev.azure.com/{org}/{project}/_git/{repo}"
111
+ execute_command command="curl -sf -u :{{secret.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
112
+ execute_command command="git remote set-url origin https://token:{{secret.azdevops_pat}}@dev.azure.com/{org}/{project}/_git/{repo}"
102
113
  ```
103
114
 
104
115
  The token is resolved server-side and redacted in output (`[REDACTED:azdevops_pat]`) - it never appears in the LLM conversation or command logs.
@@ -49,8 +49,8 @@ credential_store_set name=bitbucket_token
49
49
  **Use it in a command on a member:**
50
50
 
51
51
  ```
52
- execute_command command="curl -sf -u me@example.com:{{secure.bitbucket_token}} https://api.bitbucket.org/2.0/user"
53
- execute_command command="git remote set-url origin https://me@example.com:{{secure.bitbucket_token}}@bitbucket.org/workspace/repo.git"
52
+ execute_command command="curl -sf -u me@example.com:{{secret.bitbucket_token}} https://api.bitbucket.org/2.0/user"
53
+ execute_command command="git remote set-url origin https://me@example.com:{{secret.bitbucket_token}}@bitbucket.org/workspace/repo.git"
54
54
  ```
55
55
 
56
56
  The token is resolved server-side and redacted in output (`[REDACTED:bitbucket_token]`) - it never appears in the LLM conversation or command logs.
@@ -10,14 +10,14 @@ When to use: Org repos where you have admin access to install a GitHub App.
10
10
 
11
11
  Setup:
12
12
  1. Create GitHub App at `https://github.com/organizations/{org}/settings/apps`
13
- 2. Grant permissions (Contents, Pull Requests, Actions, etc.)
13
+ 2. Grant the Repository permissions every `git_access` level you will use needs -- exact table in `docs/github-app-setup.md` (fleet-sprint minimum = `push+pr`: Metadata R, Contents RW, Workflows RW, Pull requests RW, Actions RW). Missing any -> mint fails (no downgrade); after changing them an org owner must accept the new permissions on the installation.
14
14
  3. Install on your organization
15
15
  4. Download private key (.pem file)
16
16
  5. Run `setup_git_app` with App ID, private key path, installation ID
17
17
 
18
18
  Deploy:
19
19
  ```
20
- provision_vcs_auth(member_id, provider: 'github')
20
+ provision_vcs_auth(member_id, provider: 'github') # needs git_access + git_repos on the member
21
21
  provision_vcs_auth(member_id, provider: 'github', git_access: 'push', repos: ['Org/Repo'])
22
22
  ```
23
23
 
@@ -70,8 +70,8 @@ credential_store_set name=github_pat
70
70
  **Use it in a command on a member:**
71
71
 
72
72
  ```
73
- execute_command command="curl -H 'Authorization: Bearer {{secure.github_pat}}' https://api.github.com/user"
74
- execute_command command="git remote set-url origin https://token:{{secure.github_pat}}@github.com/Org/Repo.git"
73
+ execute_command command="curl -H 'Authorization: Bearer {{secret.github_pat}}' https://api.github.com/user"
74
+ execute_command command="git remote set-url origin https://token:{{secret.github_pat}}@github.com/Org/Repo.git"
75
75
  ```
76
76
 
77
77
  The token is resolved server-side and redacted in output (`[REDACTED:github_pat]`) - it never appears in the LLM conversation or command logs.
@@ -81,6 +81,7 @@ The token is resolved server-side and redacted in output (`[REDACTED:github_pat]
81
81
  | Symptom | Fix |
82
82
  |---------|-----|
83
83
  | 401 Bad credentials | Re-mint via `provision_vcs_auth` |
84
+ | `is not granted one or more of the requested permissions` | App lacks a permission for that level; re-minting won't fix it. Add it + accept on the installation -- see `docs/github-app-setup.md` |
84
85
  | 403 Resource not accessible | Check App permissions or PAT scopes |
85
86
  | Repository not found | Add repo to GitHub App installation |
86
87
  | gh: command not found | Install via `brew install gh` or `apt install gh` |
@@ -75,8 +75,8 @@ If the task you are about to dispatch requires an API key, token, or password (e
75
75
 
76
76
  **Steps:**
77
77
  1. Call `credential_store_set` with a descriptive name (e.g., `github_pat`, `npm_token`, `openai_key`) - Fleet opens an OOB terminal prompt for the value
78
- 2. Reference the credential by NAME only in the task prompt (e.g. `"authenticate using credential github_pat"`) - never paste the raw `sec://NAME` handle into a prompt or command; `execute_command` rejects any command containing one. The secret value is only injected server-side when `{{secure.NAME}}` appears in an `execute_command` call - never in AI prompt text.
79
- 3. The member uses `{{secure.NAME}}` in `execute_command` - Fleet resolves the value server-side and redacts it from output before the LLM sees it
78
+ 2. Reference the credential by NAME only in the task prompt (e.g. `"authenticate using credential github_pat"`) - never paste the raw `sec://NAME` handle into a prompt or command; `execute_command` rejects any command containing one. The secret value is only injected server-side when `{{secret.NAME}}` appears in an `execute_command` call - never in AI prompt text.
79
+ 3. The member uses `{{secret.NAME}}` in `execute_command` - Fleet resolves the value server-side and redacts it from output before the LLM sees it
80
80
 
81
81
  **Example - dispatching a member that needs to push code to GitHub:**
82
82
 
@@ -88,5 +88,5 @@ credential_store_set name=github_pat
88
88
  "When pushing code to GitHub, authenticate using credential github_pat."
89
89
 
90
90
  # Member uses it in a command transparently
91
- execute_command command="git remote set-url origin https://token:{{secure.github_pat}}@github.com/Org/Repo.git"
91
+ execute_command command="git remote set-url origin https://token:{{secret.github_pat}}@github.com/Org/Repo.git"
92
92
  ```
@@ -67,6 +67,9 @@ When `execute_prompt` output contains a permission denial, call `compose_permiss
67
67
 
68
68
  > "Grant Bash(docker:*) to build-server, reason: integration tests, project folder ./my-project"
69
69
 
70
+ For an agy member the failure is structured: `reason: "permission_denied"` with
71
+ `permissionDenied.suggestedGrants` (primary grant first) - review them and pass them as `grant`.
72
+
70
73
  The tool validates (wildcard-matched denylist -- blocks sudo/env, `bash -c`, catch-alls and shell chaining; see [Never auto-granted](#never-auto-granted)), expands co-occurrences (docker -> docker-compose), delivers the updated config, and appends to the project ledger for future use.
71
74
 
72
75
  ## Role switch
@@ -142,7 +145,8 @@ same channel `compose_permissions` already uses, so it works uniformly for local
142
145
  remote (SSH) members. It logs distinctly whether it just seeded trust or found it
143
146
  already present. Other providers no-op: OpenCode has its own trust gate
144
147
  but already bypasses it per-dispatch (`--dangerously-skip-permissions`);
145
- AGY has no per-project trust concept (machine-global config); Codex/Copilot have no
148
+ AGY needs no trust seeding (its grants bind through the member's own agy project,
149
+ `--project` on every dispatch); Codex/Copilot have no
146
150
  known equivalent gate.
147
151
 
148
152
  If `execute_prompt` fails with a `workspace_not_trusted` structured error, the CLI's own
@@ -1,4 +1,4 @@
1
1
  {
2
2
  "dev": ["Bash(npm:*)", "Bash(npx:*)", "Bash(node:*)", "Bash(yarn:*)", "Bash(pnpm:*)", "Bash(tsx:*)", "Bash(npm test*)", "Bash(npm run *)", "Bash(npx vitest *)"],
3
- "reviewer": ["Bash(npm test:*)", "Bash(npm run test:*)", "Bash(npm run lint:*)", "Bash(npx:*)", "Bash(npm test*)", "Bash(npm run *)", "Bash(npx vitest *)"]
3
+ "reviewer": ["Bash(npm test:*)", "Bash(npm run test:*)", "Bash(npm run lint:*)", "Bash(npx:*)", "Bash(node:*)", "Bash(npm test*)", "Bash(npm run *)", "Bash(npx vitest *)"]
4
4
  }
@@ -5,10 +5,10 @@
5
5
  | Empty response | Check auth token expiry -> re-provision via `provision_vcs_auth` |
6
6
  | Timeout (inactivity) | `timeout_s`: fires when no stdout/stderr output arrives for N seconds (default 300s / 5 min). Applies to all members and all providers - transport-level, not provider-specific. Common cause: test runners and build tools that buffer output (npm test, vitest, cargo build) producing no output for long stretches even while active. Fix: increase `timeout_s` to 600-1200 for build/test dispatches. |
7
7
  | Timeout (total) | `max_total_s`: fires after N seconds of total elapsed time regardless of output activity. Provider-agnostic. Use for hard ceilings on long-running jobs. Set alongside `timeout_s` when you need both a silence guard and a wall-clock cap. |
8
- | Permission denied | Run `compose_permissions` for the member - it produces provider-native config. Claude: check `.claude/settings.local.json`. Agy: check `.gemini/antigravity-cli/settings.json` in the work folder. Codex: check `.codex/config.toml` approval mode. Copilot: check `.github/copilot/settings.local.json`. |
8
+ | Permission denied | Run `compose_permissions` for the member - it produces provider-native config. Claude: check `.claude/settings.local.json`. Agy: `execute_prompt` returns `reason: "permission_denied"` with `permissionDenied.suggestedGrants` - pass them to `compose_permissions` `grant`; grants live in `~/.gemini/config/projects/<agyProjectId>.json` on the member (`agyProjectId` from `member_detail`). Codex: check `.codex/config.toml` approval mode. Copilot: check `.github/copilot/settings.local.json`. |
9
9
  | Stuck after reset | Escalate model (cheap->standard->premium). Still stuck? Flag to user |
10
10
  | Auth error (401/403) | GitHub App: re-mint via `provision_vcs_auth`. Bitbucket/Azure DevOps: ask user for fresh token, provision, retry. See auth-*.md |
11
- | Token/password appears in command output | Use `credential_store_set` to store the secret, then reference it as `{{secure.NAME}}` in `execute_command` - Fleet redacts it to `[REDACTED:NAME]` before the LLM sees the output |
12
- | Need to rotate a credential without re-provisioning | Run `credential_store_delete name=<NAME>` then `credential_store_set name=<NAME>` - the new value is picked up immediately on the next `execute_command` that references `{{secure.NAME}}` |
11
+ | Token/password appears in command output | Use `credential_store_set` to store the secret, then reference it as `{{secret.NAME}}` in `execute_command` - Fleet redacts it to `[REDACTED:NAME]` before the LLM sees the output |
12
+ | Need to rotate a credential without re-provisioning | Run `credential_store_delete name=<NAME>` then `credential_store_set name=<NAME>` - the new value is picked up immediately on the next `execute_command` that references `{{secret.NAME}}` |
13
13
  | Tool execution issue (unexpected behavior, missing output, silent failure) | Check `APRA_FLEET_DATA_DIR/logs/fleet-<pid>.log` for detailed execution traces. Filter by member with `jq 'select(.member_id == "<uuid>")'` or by tool with `jq 'select(.tag == "<tool>")'`. See the **Fleet Logs** section in SKILL.md for full field reference and `jq` examples. |
14
14
  | `bd dolt pull`/`push` fails with "merge conflicts in issues require operator resolution" | Real divergence, not corruption -- do NOT `bd init`/`bd init --from-jsonl`/delete `.beads/`. See `beads-conflict-resolution.md` for the manual dolt SQL recovery playbook. |
package/version.json CHANGED
@@ -1,3 +1,3 @@
1
1
  {
2
- "version": "0.4.2"
2
+ "version": "0.4.3"
3
3
  }