@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
@@ -70,18 +70,23 @@ export class SePosixCommands {
70
70
  * Invoke an executable at `path` with `args`.
71
71
  *
72
72
  * QUOTING CONTRACT (differs per implementation on purpose -- pass `path`
73
- * UNQUOTED): POSIX emits the path token verbatim, adding no quoting, because
74
- * the historical credential-read command is a bare unquoted `$HOME/...`
75
- * string that must stay byte-identical. The PowerShell implementation adds
76
- * both the call operator and double quotes, without which PowerShell merely
77
- * echoes the path back as a string and the failure looks like success.
78
- * @param {string} path unquoted; POSIX callers needing quotes add them
73
+ * UNQUOTED; this method adds its own quoting): POSIX double-quotes the path
74
+ * token so a member whose HOME contains whitespace (or other word-splitting
75
+ * characters) still resolves correctly -- `$HOME` still expands inside
76
+ * double quotes, it just no longer gets split on the result (apra-fleet-
77
+ * j918.12; the bare, unquoted form was a real production defect, pinned by
78
+ * apra-fleet-j918.6.3's round-trip harness before this fix). The PowerShell
79
+ * implementation adds both the call operator and double quotes, without
80
+ * which PowerShell merely echoes the path back as a string and the failure
81
+ * looks like success.
82
+ * @param {string} path unquoted; this method adds double quotes
79
83
  * @param {string} [args]
80
84
  * @returns {string}
81
85
  */
82
86
  invoke(path, args = '') {
83
87
  const suffix = String(args || '').trim();
84
- return suffix ? `${path} ${suffix}` : String(path);
88
+ const quoted = `"${path}"`;
89
+ return suffix ? `${quoted} ${suffix}` : quoted;
85
90
  }
86
91
 
87
92
  /**
@@ -101,11 +106,11 @@ export class SePosixCommands {
101
106
  * -- on the PowerShell side the command itself is an opaque base64 blob, so
102
107
  * the descriptor has to carry the readable path.
103
108
  *
104
- * NOTE: the POSIX label is intentionally NOT validated. The historical
105
- * string is a bare, unquoted `$HOME/...` path and must stay byte-identical
106
- * for every non-Windows member; adding validation here would change
107
- * behaviour for callers that have worked for a long time. The PowerShell
108
- * implementation, which is newer, does validate.
109
+ * NOTE: the POSIX label is intentionally NOT validated, unlike the
110
+ * PowerShell implementation (which is newer and does validate). The path
111
+ * itself is now double-quoted by `invoke()` (apra-fleet-j918.12) so a
112
+ * member whose HOME contains whitespace still resolves; that quoting
113
+ * change does not extend to validating the label.
109
114
  * @param {string} label
110
115
  * @returns {{ command: string, descriptor: string }}
111
116
  */
@@ -0,0 +1,304 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+
4
+ // =============================================================================
5
+ // shell-command guard checker -- fourth mechanical guard in this directory,
6
+ // modelled on dispatch-safety-guard.mjs, dolt-literal-guard.mjs and
7
+ // full-db-fetch-guard.mjs (same shape: a line scanner exported and
8
+ // parameterizable by path, with explicit carve-outs for full-line comments
9
+ // and import/require lines, so it can be pointed at BOTH the real guarded
10
+ // modules and a throwaway fixture that deliberately violates the invariant).
11
+ //
12
+ // INVARIANT UNDER TEST: a member-bound command string must NEVER rely on
13
+ // shell-level expansion performed in the orchestrator process's idea of a
14
+ // shell. The target member's shell may be PowerShell (or cmd.exe, or
15
+ // Git-for-Windows bash), not POSIX sh -- so none of the following may appear
16
+ // in a string this repo hands to command()/execute_command:
17
+ //
18
+ // - variable expansion, bare (`$HOME`, `$env:USERPROFILE`) or braced
19
+ // (a literal `${VAR}` reaching the member, i.e. one written inside a
20
+ // single/double-quoted JS string or escaped as `\${VAR}` in a template
21
+ // literal);
22
+ // - a leading tilde path (`~/...`) -- PowerShell and cmd.exe do not expand
23
+ // it the way POSIX sh does;
24
+ // - backtick command substitution (a literal backtick reaching the member),
25
+ // or its `$( ... )` POSIX equivalent.
26
+ //
27
+ // Paths must instead be resolved in JavaScript BEFORE the command string is
28
+ // built -- via probeCommandFor(targetOs, shell) in src/services/member-home.ts,
29
+ // or by branching on isPosixShell(agentOs, shell) in src/providers/claude.ts
30
+ // (see also fleet-sprint/se-os-commands.mjs's per-shell command classes,
31
+ // which are how this package does that branching).
32
+ //
33
+ // WHAT IS DELIBERATELY NOT FLAGGED
34
+ //
35
+ // 1. JS template interpolation. A bare `${expr}` inside a backtick template
36
+ // literal is resolved IN JAVASCRIPT before the string is ever dispatched;
37
+ // that is the prescribed fix, not the violation. Only a `${...}` that
38
+ // survives into the emitted text -- one inside a '...'/"..." string, or
39
+ // written `\${...}` inside a template -- is a violation.
40
+ // 2. Backticks used as JS template-literal delimiters. Only an ESCAPED
41
+ // backtick (`\`` -- a literal backtick surviving into the emitted
42
+ // string) is a violation. An UNescaped backtick inside a '...'/"..."
43
+ // JS string is DELIBERATELY NOT flagged, even though it sits inside a
44
+ // quoted string -- it is overwhelmingly a markdown code span in
45
+ // agent-prompt prose (runner.js has ~24 of them) or a JS fence-builder,
46
+ // not a dispatched shell substitution, so flagging those would make
47
+ // this guard pure noise. A reader should take away that a backtick-
48
+ // wrapped substitution written inside ordinary '...'/"..." quotes in a
49
+ // member-bound command string is UNGUARDED by this rule.
50
+ // 3. Secret token references. execute_command replaces each secret.NAME
51
+ // (or legacy secure.NAME) token with a value that has ALREADY been quoted for the target
52
+ // member's shell (escapePowerShellArg for windows members,
53
+ // escapeShellArg otherwise -- src/tools/execute-command.ts). Those
54
+ // tokens carry no `$`, `~/` or backtick, so they never match a rule
55
+ // here; a bare token reference is correct and must stay bare (wrapping
56
+ // one in extra quotes double-escapes the value and surfaces as a false
57
+ // 401 / invalid-token error). This guard must never push a caller toward
58
+ // adding those quotes.
59
+ //
60
+ // CARVE-OUTS (mirroring the sibling guards):
61
+ // - full-line comments (trimmed text starting with `//`, `*` or `/*`) --
62
+ // prose that merely DISCUSSES `$HOME`/`~/`/backticks is not a dispatch;
63
+ // runner.js's own RUNNER-WIDE POSIX-EXPANSION SWEEP note is exactly this;
64
+ // - `import`/`require` lines;
65
+ // - an explicit, documented per-line allow directive: a trailing
66
+ // `// shell-guard-allow: <reason>` comment on the offending line (or on
67
+ // the line immediately above it) suppresses that line, and the reason
68
+ // text is REQUIRED -- an allow with no reason is itself reported. This
69
+ // exists for the handful of genuinely deliberate cases where the member's
70
+ // own shell must do the expansion because the WRITE side used the same
71
+ // token (fleet-sprint/se-posix.mjs's `$HOME/...` credential-helper path
72
+ // is the canonical example: it must stay byte-identical to what
73
+ // src/os/linux.ts wrote).
74
+ // =============================================================================
75
+
76
+ /** Trailing/standalone directive that suppresses one line, with a required reason. */
77
+ const ALLOW_RE = /shell-guard-allow:\s*(\S.*)$/;
78
+ /** An allow directive with no reason text after the colon. */
79
+ const ALLOW_NO_REASON_RE = /shell-guard-allow:\s*$/;
80
+
81
+ function isCommentLine(text) {
82
+ const trimmed = text.trim();
83
+ return trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*');
84
+ }
85
+
86
+ function isImportLine(text) {
87
+ return /^\s*(import\b|export\b.*\bfrom\b|(const|let|var)\s.*\brequire\s*\()/.test(text);
88
+ }
89
+
90
+ /**
91
+ * Splits `text` into segments tagged with the JS quoting context they sit in,
92
+ * scanning a single line left to right. Returns an array of
93
+ * { kind, start, end } where kind is one of 'code', 'single', 'double',
94
+ * 'template'. Deliberately single-line (like dispatch-safety-guard.mjs's
95
+ * isInsideSameLineString): a whole-file quote scan misfires on apostrophes in
96
+ * prose. A template literal that opens on this line and does not close is
97
+ * treated as running to end of line, which is the conservative choice -- the
98
+ * bytes on THIS line are what we classify.
99
+ */
100
+ export function segmentLine(text) {
101
+ const segments = [];
102
+ let kind = 'code';
103
+ let start = 0;
104
+ for (let i = 0; i < text.length; i++) {
105
+ const ch = text[i];
106
+ if (ch === '\\') { i++; continue; }
107
+ if (kind === 'code') {
108
+ if (ch === "'" || ch === '"' || ch === '`') {
109
+ segments.push({ kind: 'code', start, end: i });
110
+ kind = ch === "'" ? 'single' : ch === '"' ? 'double' : 'template';
111
+ start = i + 1;
112
+ }
113
+ } else {
114
+ const closer = kind === 'single' ? "'" : kind === 'double' ? '"' : '`';
115
+ if (ch === closer) {
116
+ segments.push({ kind, start, end: i });
117
+ kind = 'code';
118
+ start = i + 1;
119
+ }
120
+ }
121
+ }
122
+ segments.push({ kind, start, end: text.length });
123
+ return segments.filter((s) => s.end > s.start);
124
+ }
125
+
126
+ /** True when `col` sits inside a JS template literal opened earlier on the same line. */
127
+ function segmentKindAt(segments, col) {
128
+ for (const s of segments) {
129
+ if (col >= s.start && col < s.end) return s.kind;
130
+ }
131
+ return 'code';
132
+ }
133
+
134
+ // A shell variable expansion with no braces: `$HOME`, `$env:USERPROFILE`,
135
+ // `$pid`. Not preceded by a `$` (so `$$` is not double-counted) and not
136
+ // followed by `{`.
137
+ const BARE_VAR_RE = /(?<!\$)\$([A-Za-z_][A-Za-z0-9_:]*)/g;
138
+ // A brace expansion written so it SURVIVES into the emitted string.
139
+ const BRACED_VAR_RE = /\$\{/g;
140
+ // POSIX command substitution.
141
+ const CMD_SUBST_RE = /\$\(/g;
142
+ // A leading tilde path.
143
+ const TILDE_RE = /(^|[\s'"`=(,:])~\//g;
144
+
145
+ /**
146
+ * Scans one line of source and returns an array of { column, reason } for
147
+ * every shell-expansion construct that would survive into a dispatched
148
+ * command string. Exported for direct unit testing.
149
+ */
150
+ export function findLineViolations(text) {
151
+ const segments = segmentLine(text);
152
+ const found = [];
153
+ const inString = (col) => segmentKindAt(segments, col) !== 'code';
154
+
155
+ let m;
156
+ BARE_VAR_RE.lastIndex = 0;
157
+ while ((m = BARE_VAR_RE.exec(text)) !== null) {
158
+ if (!inString(m.index)) continue;
159
+ found.push({
160
+ column: m.index + 1,
161
+ reason:
162
+ `bare shell variable expansion "$${m[1]}" in a command string -- the target member's shell may be ` +
163
+ `PowerShell, not POSIX; resolve the value in JavaScript first (probeCommandFor(targetOs, shell) in ` +
164
+ `src/services/member-home.ts, or branch on isPosixShell(agentOs, shell))`,
165
+ });
166
+ }
167
+
168
+ CMD_SUBST_RE.lastIndex = 0;
169
+ while ((m = CMD_SUBST_RE.exec(text)) !== null) {
170
+ if (!inString(m.index)) continue;
171
+ found.push({
172
+ column: m.index + 1,
173
+ reason:
174
+ 'POSIX command substitution "$(" in a command string -- run the probe as its own dispatch and ' + // shell-guard-allow: this guard's own violation-message text names the "$(" construct it detects; it is never dispatched as a command string.
175
+ 'interpolate the result in JavaScript instead',
176
+ });
177
+ }
178
+
179
+ BRACED_VAR_RE.lastIndex = 0;
180
+ while ((m = BRACED_VAR_RE.exec(text)) !== null) {
181
+ const kind = segmentKindAt(segments, m.index);
182
+ const escaped = m.index > 0 && text[m.index - 1] === '\\';
183
+ // A bare `${...}` inside a template literal is JS interpolation --
184
+ // resolved before dispatch, which is the prescribed fix. Only a
185
+ // braced expansion that survives into the emitted text counts.
186
+ if (kind === 'template' && !escaped) continue;
187
+ if (kind === 'code') continue;
188
+ found.push({
189
+ column: m.index + 1,
190
+ reason:
191
+ 'braced shell variable expansion "${...}" survives into the dispatched command string -- ' + // shell-guard-allow: this guard's own violation-message text names the "${...}" construct it detects; it is never dispatched as a command string.
192
+ 'interpolate the value in JavaScript instead of leaving it for the member shell to expand',
193
+ });
194
+ }
195
+
196
+ TILDE_RE.lastIndex = 0;
197
+ while ((m = TILDE_RE.exec(text)) !== null) {
198
+ const col = m.index + m[1].length;
199
+ if (!inString(col)) continue;
200
+ found.push({
201
+ column: col + 1,
202
+ reason:
203
+ 'leading tilde path "~/" in a command string -- PowerShell and cmd.exe do not expand it; resolve ' + // shell-guard-allow: this guard's own violation-message text names the "~/" construct it detects; it is never dispatched as a command string.
204
+ "the member's home directory in JavaScript (probeCommandFor(targetOs, shell))",
205
+ });
206
+ }
207
+
208
+ // Backticks: only an ESCAPED backtick counts -- see the rule note in this
209
+ // file's header. An UNescaped backtick inside a '...'/"..." JS string is
210
+ // overwhelmingly a markdown code span in agent-prompt prose (runner.js has
211
+ // ~24 of them) or a JS fence-builder, not a dispatched shell substitution,
212
+ // so flagging those makes the guard pure noise. `\`` in a template literal
213
+ // is the deliberate "emit a literal backtick into this command string"
214
+ // spelling, which is the construct this rule exists to catch.
215
+ for (let i = 0; i < text.length; i++) {
216
+ if (text[i] !== '`') continue;
217
+ const escaped = i > 0 && text[i - 1] === '\\';
218
+ if (!escaped) continue;
219
+ found.push({
220
+ column: i + 1,
221
+ reason:
222
+ 'backtick command substitution in a command string -- run the probe as its own dispatch and ' +
223
+ 'interpolate the result in JavaScript instead',
224
+ });
225
+ break; // one report per line is enough; a pair of backticks is one construct
226
+ }
227
+
228
+ return found.sort((a, b) => a.column - b.column);
229
+ }
230
+
231
+ /**
232
+ * Scans whole-file source `src`, applying the carve-outs, and returns an
233
+ * array of { line, column, reason, text } violations.
234
+ */
235
+ export function findShellCommandViolations(src) {
236
+ const lines = src.split('\n');
237
+ const violations = [];
238
+ for (let i = 0; i < lines.length; i++) {
239
+ const text = lines[i];
240
+ const prev = i > 0 ? lines[i - 1] : '';
241
+ if (isCommentLine(text)) {
242
+ // A standalone allow directive with no reason is still reported,
243
+ // so a suppression can never be added without saying why.
244
+ if (ALLOW_NO_REASON_RE.test(text)) {
245
+ violations.push({
246
+ line: i + 1,
247
+ column: text.indexOf('shell-guard-allow') + 1,
248
+ reason: 'shell-guard-allow directive has no reason text -- state why the member shell must do the expansion',
249
+ text: text.trim(),
250
+ });
251
+ }
252
+ continue;
253
+ }
254
+ if (isImportLine(text)) continue;
255
+ const lineFindings = findLineViolations(text);
256
+ if (lineFindings.length === 0) continue;
257
+ if (ALLOW_NO_REASON_RE.test(text) || ALLOW_NO_REASON_RE.test(prev)) {
258
+ violations.push({
259
+ line: i + 1,
260
+ column: 1,
261
+ reason: 'shell-guard-allow directive has no reason text -- state why the member shell must do the expansion',
262
+ text: text.trim(),
263
+ });
264
+ continue;
265
+ }
266
+ if (ALLOW_RE.test(text) || ALLOW_RE.test(prev)) continue;
267
+ for (const f of lineFindings) {
268
+ violations.push({ line: i + 1, column: f.column, reason: f.reason, text: text.trim() });
269
+ }
270
+ }
271
+ return violations;
272
+ }
273
+
274
+ /**
275
+ * Reads and scans the source file at `filePath`, returning
276
+ * { violations } where each violation is { file, line, column, reason, text }
277
+ * -- `file` is the basename, matching how the sibling guards label a
278
+ * violation, so an aggregate run over several modules attributes each finding
279
+ * to the module it came from.
280
+ */
281
+ export function checkShellCommandPath(filePath) {
282
+ const src = fs.readFileSync(filePath, 'utf8');
283
+ const file = path.basename(filePath);
284
+ const violations = findShellCommandViolations(src).map((v) => ({ file, ...v }));
285
+ return { violations };
286
+ }
287
+
288
+ /**
289
+ * Aggregate entry point: scans EVERY path in `paths` (e.g. the shared guarded
290
+ * module list) and returns { violations, files } with each violation carrying
291
+ * the file it came from. Takes an explicit array so this module stays
292
+ * independent of any one registry.
293
+ */
294
+ export function checkShellCommandPaths(paths) {
295
+ if (!Array.isArray(paths)) throw new TypeError('checkShellCommandPaths(paths): paths must be an array of file paths');
296
+ const violations = [];
297
+ for (const p of paths) violations.push(...checkShellCommandPath(p).violations);
298
+ return { violations, files: paths.map((p) => path.basename(p)) };
299
+ }
300
+
301
+ /** Human-readable rendering of one violation, for assertion messages and logs. */
302
+ export function formatShellCommandViolation(v) {
303
+ return `${v.file || '<unknown>'}:${v.line}:${v.column} ${v.reason}`;
304
+ }
@@ -26,6 +26,8 @@ apra-fleet workflow fleet-sprint \
26
26
  [--viewer-port <port>] # default 8080
27
27
  [--budget <usd>] # default unlimited
28
28
  [--dispatch-timeout-s <s>] # default 9000
29
+ [--usage-limit-max-wait-s <s>] # usage-limit pause budget; default from role-policies
30
+ [--usage-limit-max-reprobes <n>]# usage-limit reprobe cap; default from role-policies
29
31
  [--sync] # synced-topology mode
30
32
  ```
31
33
 
@@ -55,6 +57,11 @@ on this list -- flags evolve and this skill can drift.
55
57
  or `@path/to/file.json`.
56
58
  - `--goal` controls which bead priorities are in scope for the run.
57
59
  - `--budget` caps total spend in USD; the run aborts when it is exhausted.
60
+ - `--usage-limit-max-wait-s` / `--usage-limit-max-reprobes` bound how long a
61
+ dispatch that hit a provider usage/rate limit is paused (and re-probed on a
62
+ backoff ladder) before the run gives up with a typed abort. Both are
63
+ optional; omitted, the engine uses its own defaults. A resumed member
64
+ re-dispatches without consuming a retry attempt.
58
65
 
59
66
  ## Preconditions to check first
60
67
 
@@ -73,6 +80,17 @@ on this list -- flags evolve and this skill can drift.
73
80
  4. If a member's LLM session is stale or unauthenticated (dispatch fails
74
81
  with `empty_response`, or "member CLI likely died"), re-run
75
82
  `provision_llm_auth` for that member before retrying.
83
+ 5. Beads identity: before any `bd` mutation, the sprint probes every
84
+ member's `bd where`/`sync.remote`/git origin and prints a `Beads:`
85
+ banner plus one `beads ok: <member> ...` line per member. A MISMATCH
86
+ (a field that resolved on both sides and differs) aborts with
87
+ `BeadsIdentityError` naming the member and field before anything is
88
+ mutated; fix by correcting that member's `workFolder` (wrong `.beads`)
89
+ or its `sync.remote` -- there is no bypass flag. A probe that fails or
90
+ resolves nothing is only a `[beads-identity] WARNING:` line (naming the
91
+ member, field, probe, error and the fix): that field is not compared and
92
+ the sprint proceeds -- read the warning and fix the member, but do not
93
+ treat it as an abort.
76
94
 
77
95
  ## Launching it
78
96
 
@@ -21,16 +21,35 @@ Start it detached (it runs indefinitely -- exits only on `POST
21
21
  node packages/apra-fleet-se/bin/serve.mjs # background/detached, from repo root
22
22
  ```
23
23
 
24
- `--port <n>` overrides the default (8787). Self-logs to
24
+ Start it from INSIDE the target project (any folder under it): the
25
+ supervisor resolves the project's `.beads` by walking up from its cwd,
26
+ exactly like `bd`. Starting from elsewhere: pass `--beads-dir <project
27
+ folder or its .beads>` (a path that does not exist is a startup error). It
28
+ logs one `supervisor beads: <dir> | prefix=<p> | remote=<sync.remote>` line
29
+ at startup; the same identity is on `GET /api/health` (`beads`) and at the
30
+ top of the dashboard, and every sprint it launches is told to verify its
31
+ members against it. If NO `.beads` is found (or its probe fails) it still
32
+ starts, but logs `[supervisor] WARNING: no beads database found walking up
33
+ from <cwd> ... To fix: ...`, reports `beads: null` plus `beadsWarning` on
34
+ `/api/health`, shows an amber `Beads: NOT RESOLVED -- ...` header on the
35
+ dashboard, and launches sprints WITHOUT `--expect-beads` (they then verify
36
+ members against the orchestrator member's own beads). Treat that as
37
+ "restart from the right folder / with `--beads-dir`", or fix the
38
+ environment and hit `GET /api/health?refresh=1` to recover without a
39
+ restart. `--port <n>` overrides the default (8787). Self-logs to
25
40
  `<dataDir>/logs/supervisor.log` in addition to stdout.
26
41
 
27
42
  Smoke test (a few seconds after launch -- give it time to bind):
28
43
  ```bash
29
44
  curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
30
45
  curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
46
+ curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker
31
47
  ```
32
48
  Both must succeed before treating the supervisor as up -- a bound port with
33
- a 500 on `/api/members` still means something is broken.
49
+ a 500 on `/api/members` still means something is broken. A wrong
50
+ `beads.prefix` means it was started from the wrong folder: stop it and
51
+ restart with `--beads-dir`. `beads: null` with a `beadsWarning` means no
52
+ tracker was resolved at all: the warning text says what to do.
34
53
 
35
54
  ## Stop the supervisor
36
55