@apralabs/apra-fleet 0.4.3 → 0.4.4

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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -4,24 +4,38 @@
4
4
  *
5
5
  * Binding design doc: docs/adr-workflow-server-resolution.md (apra-fleet-7pm.6).
6
6
  * Consumers: src/cli/workflow.ts (the `apra-fleet workflow` launcher) and
7
- * packages/apra-fleet-se/bin/cli.mjs (auto-sprint). Neither duplicates this logic.
7
+ * packages/apra-fleet-se/bin/cli.mjs (fleet-sprint). Neither duplicates this logic.
8
8
  *
9
9
  * Resolution order (ADR Decision 1):
10
10
  * 1. APRA_FLEET_TRANSPORT override ('http' | 'stdio').
11
11
  * - 'stdio' -> stdio self-spawn, no probe.
12
12
  * - APRA_FLEET_SERVER_CMD/_BIN set (and transport is not forced 'http')
13
13
  * -> explicit stdio request, no probe.
14
- * - 'http' -> probe only; NEVER falls back to stdio.
15
- * - unset -> http is the product default: probe, then fall back.
14
+ * - 'http' -> probe only; never starts a server, never stdio.
15
+ * - unset -> http is the product default: probe, then step 3.
16
16
  * 2. HTTP singleton probe -- checkRunningInstance(): ~/.apra-fleet/data/server.json
17
17
  * {pid, url}, pid-alive check + GET <url with /mcp -> /health> (2s timeout),
18
- * self-healing (deletes a stale server.json). On success: attach over
18
+ * self-healing (deletes server.json only for a dead pid or a refused port;
19
+ * a live-but-unresponsive server keeps it). On success: attach over
19
20
  * StreamableHttpTransport, spawn nothing.
20
- * 3. stdio self-spawn fallback -- the existing four command tiers
21
- * (APRA_FLEET_SERVER_CMD, APRA_FLEET_SERVER_BIN, bundled sibling index.js,
22
- * dev-monorepo dist/index.js), fed to StdioTransport.
21
+ * 3. The singleton is verifiably GONE (no server.json, dead pid, or refused
22
+ * port): start the SHARED HTTP server exactly as `apra-fleet start` does
23
+ * (auto-start.mjs -- detached, user-level, outlives this client; a lock
24
+ * serialises racing clients; capped at N starts per M minutes), wait for
25
+ * /health, then attach over HTTP. An UNRESPONSIVE singleton (alive, not
26
+ * answering) is never replaced: actionable error. (GitHub #585 recovery;
27
+ * this replaced the old private stdio self-spawn, which is now only
28
+ * reachable via APRA_FLEET_TRANSPORT=stdio or APRA_FLEET_SERVER_CMD/_BIN.)
23
29
  *
24
- * Scope guard (ADR): the launcher/auto-sprint client and the MCP server are ALWAYS
30
+ * Long-lived HTTP clients get a ReconnectingHttpTransport (connectFleet /
31
+ * createFleetHttpTransport): on a refused connection it re-probes, auto-starts
32
+ * a gone server and retries a request ONCE only when it provably never reached
33
+ * the server -- never an in-flight execute_prompt/execute_command.
34
+ *
35
+ * Claude Code and other MCP hosts connect by URL and never use this module;
36
+ * they are covered by the OS user-level service (install), not by this.
37
+ *
38
+ * Scope guard (ADR): the launcher/fleet-sprint client and the MCP server are ALWAYS
25
39
  * separate processes. This module decides only the transport, never merges them.
26
40
  *
27
41
  * Every branch is unit-testable: all filesystem/env/network access goes through the
@@ -29,12 +43,22 @@
29
43
  */
30
44
  import fs from 'node:fs';
31
45
  import http from 'node:http';
46
+ import net from 'node:net';
32
47
  import path from 'node:path';
33
48
  import os from 'node:os';
34
49
  import { fileURLToPath } from 'node:url';
35
50
  import { StdioTransport, StreamableHttpTransport } from './transport.mjs';
36
51
  import { McpClient } from './client.mjs';
37
52
  import { ApraFleet } from './api.mjs';
53
+ import { autoStartFleetServer, readStoppedByUser, stoppedByUserError } from './auto-start.mjs';
54
+ import { ReconnectingHttpTransport } from './reconnecting-transport.mjs';
55
+
56
+ export {
57
+ autoStartFleetServer, resolveFleetStartCommand, lastServerLog, FleetAutoStartError,
58
+ readStoppedByUser, stoppedByUserError, STOPPED_BY_USER_FILE,
59
+ AUTOSTART_MAX_STARTS, AUTOSTART_WINDOW_MS, AUTOSTART_TIMEOUT_MS,
60
+ } from './auto-start.mjs';
61
+ export { ReconnectingHttpTransport, isNeverDeliveredError } from './reconnecting-transport.mjs';
38
62
 
39
63
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
40
64
 
@@ -66,29 +90,60 @@ function isPidAlive(pid) {
66
90
  /**
67
91
  * GET <url with a trailing /mcp replaced by /health>, 2s timeout.
68
92
  * @param {string} url
69
- * @returns {Promise<boolean>}
93
+ * @returns {Promise<boolean|'foreign'>} 'foreign' when something answered with a non-200
94
+ * (a blocked fleet server cannot answer at all, so the port belongs to someone else)
70
95
  */
71
96
  function checkHealthEndpoint(url) {
72
97
  const healthUrl = url.replace(/\/mcp$/, '/health');
73
98
  return new Promise((resolve) => {
74
99
  const req = http.get(healthUrl, { timeout: 2000 }, (res) => {
75
100
  res.resume();
76
- resolve(res.statusCode === 200);
101
+ resolve(res.statusCode === 200 ? true : 'foreign');
77
102
  });
78
103
  req.on('error', () => resolve(false));
79
104
  req.on('timeout', () => { req.destroy(); resolve(false); });
80
105
  });
81
106
  }
82
107
 
108
+ /**
109
+ * Plain TCP connect probe (mirrors src/services/singleton.ts probeTcpPort).
110
+ * @param {number} port
111
+ * @param {string} host
112
+ * @returns {Promise<'open'|'refused'|'timeout'|'error'>}
113
+ */
114
+ function probeTcpPort(port, host) {
115
+ return new Promise((resolve) => {
116
+ let settled = false;
117
+ const sock = net.connect({ port, host });
118
+ const finish = (r) => {
119
+ if (settled) return;
120
+ settled = true;
121
+ try { sock.destroy(); } catch { /* ignore */ }
122
+ resolve(r);
123
+ };
124
+ sock.setTimeout(3000); // Windows takes ~2s to report a refused loopback connect
125
+ sock.once('connect', () => finish('open'));
126
+ sock.once('timeout', () => finish('timeout'));
127
+ sock.once('error', (err) => finish(err && err.code === 'ECONNREFUSED' ? 'refused' : 'error'));
128
+ });
129
+ }
130
+
83
131
  /**
84
132
  * The HTTP-singleton probe. Same semantics as src/services/singleton.ts's
85
- * checkRunningInstance() (pid + /health + self-heal), so the launcher's probe and
86
- * the server's own startup-dedup can never disagree.
133
+ * checkRunningInstance() (pid + /health + tri-state self-heal), so the launcher's
134
+ * probe and the server's own startup-dedup can never disagree.
135
+ *
136
+ * Tri-state: running (pid alive + /health 200), unresponsive (pid alive, /health
137
+ * silent, recorded port still accepts TCP -- server.json is KEPT), gone (no
138
+ * server.json, dead pid, or the recorded port refuses TCP -- server.json removed).
87
139
  *
88
140
  * @param {{ env?: Record<string, string|undefined>, readFile?: (p: string) => string,
89
141
  * unlink?: (p: string) => void, pidAlive?: (pid: number) => boolean,
90
- * health?: (url: string) => Promise<boolean> }} [deps]
91
- * @returns {Promise<{running: true, url: string, pid: number} | {running: false}>}
142
+ * health?: (url: string) => Promise<boolean>,
143
+ * tcpProbe?: (port: number, host: string) => Promise<'open'|'refused'|'timeout'|'error'> }} [deps]
144
+ * @returns {Promise<{running: true, state: 'running', url: string, pid: number}
145
+ * | {running: false, state: 'unresponsive', url: string, pid: number, port?: number}
146
+ * | {running: false, state: 'gone'}>}
92
147
  */
93
148
  export async function checkRunningInstance(deps = {}) {
94
149
  const env = deps.env || process.env;
@@ -96,6 +151,7 @@ export async function checkRunningInstance(deps = {}) {
96
151
  const unlink = deps.unlink || ((p) => { try { fs.unlinkSync(p); } catch { /* already gone */ } });
97
152
  const pidAlive = deps.pidAlive || isPidAlive;
98
153
  const health = deps.health || checkHealthEndpoint;
154
+ const tcpProbe = deps.tcpProbe || probeTcpPort;
99
155
 
100
156
  const serverInfoPath = getServerInfoPath(env);
101
157
 
@@ -103,22 +159,37 @@ export async function checkRunningInstance(deps = {}) {
103
159
  try {
104
160
  info = JSON.parse(readFile(serverInfoPath));
105
161
  } catch {
106
- return { running: false };
162
+ return { running: false, state: 'gone' };
107
163
  }
108
164
 
109
- if (!info || !info.pid || !info.url) return { running: false };
165
+ if (!info || !info.pid || !info.url) return { running: false, state: 'gone' };
110
166
 
111
167
  if (!pidAlive(info.pid)) {
112
168
  unlink(serverInfoPath);
113
- return { running: false };
169
+ return { running: false, state: 'gone' };
114
170
  }
115
171
 
116
- if (!(await health(info.url))) {
172
+ const healthResult = await health(info.url);
173
+ if (healthResult === 'foreign') {
117
174
  unlink(serverInfoPath);
118
- return { running: false };
175
+ return { running: false, state: 'gone' };
176
+ }
177
+ if (healthResult !== true) {
178
+ let port;
179
+ let host = '127.0.0.1';
180
+ try {
181
+ const u = new URL(info.url);
182
+ port = Number(info.port) > 0 ? Number(info.port) : (Number(u.port) > 0 ? Number(u.port) : undefined);
183
+ host = u.hostname || host;
184
+ } catch { /* keep defaults */ }
185
+ if (port !== undefined && (await tcpProbe(port, host)) === 'refused') {
186
+ unlink(serverInfoPath);
187
+ return { running: false, state: 'gone' };
188
+ }
189
+ return { running: false, state: 'unresponsive', url: info.url, pid: info.pid, port };
119
190
  }
120
191
 
121
- return { running: true, url: info.url, pid: info.pid };
192
+ return { running: true, state: 'running', url: info.url, pid: info.pid };
122
193
  }
123
194
 
124
195
  /**
@@ -169,12 +240,15 @@ export function resolveFleetServerCommand(deps = {}) {
169
240
  }
170
241
 
171
242
  /**
172
- * The ADR's resolution order, as a pure descriptor (nothing is spawned or connected).
243
+ * The ADR's resolution order. Returns a connection descriptor; nothing is
244
+ * connected. The only side effect: when the shared HTTP server is verifiably
245
+ * gone, it is started (step 3) -- inject `autoStartFleetServer` to fake that.
173
246
  *
174
247
  * @param {{ env?: Record<string, string|undefined>, dirname?: string,
175
248
  * exists?: (candidate: string) => boolean,
176
- * checkRunningInstance?: (deps?: object) => Promise<object> }} [deps]
177
- * @returns {Promise<{mode: 'http', url: string, pid: number, reason: string}
249
+ * checkRunningInstance?: (deps?: object) => Promise<object>,
250
+ * autoStartFleetServer?: (deps: object) => Promise<{url: string, pid: number, started?: boolean}> }} [deps]
251
+ * @returns {Promise<{mode: 'http', url: string, pid: number, reason: string, started?: boolean}
178
252
  * | {mode: 'stdio', command: string, args: string[], reason: string}>}
179
253
  */
180
254
  export async function resolveFleetServerConnection(deps = {}) {
@@ -219,19 +293,71 @@ export async function resolveFleetServerConnection(deps = {}) {
219
293
  'APRA_FLEET_TRANSPORT=http was requested, but no healthy apra-fleet HTTP singleton was found.\n' +
220
294
  ` Checked: ${getServerInfoPath(env)} (pid alive + GET /health)\n` +
221
295
  " Start one with 'apra-fleet start' (or 'apra-fleet install'), or unset " +
222
- 'APRA_FLEET_TRANSPORT to allow the stdio self-spawn fallback.',
296
+ 'APRA_FLEET_TRANSPORT to let the client start the shared server itself.',
297
+ );
298
+ }
299
+
300
+ // A live-but-unresponsive HTTP singleton still owns this data dir: a
301
+ // self-spawned stdio server beside it would split the fleet (GitHub #584).
302
+ if (instance && instance.state === 'unresponsive') {
303
+ throw new Error(
304
+ `The apra-fleet HTTP server (pid ${instance.pid} at ${instance.url}) is alive but not answering /health.\n` +
305
+ ' Refusing to start a second server on the same data dir.\n' +
306
+ " Run 'apra-fleet stop' and retry, or set APRA_FLEET_TRANSPORT=stdio to force a private stdio server.",
223
307
  );
224
308
  }
225
309
 
226
- // Step 3 -- stdio self-spawn fallback.
227
- const cmd = resolveFleetServerCommand(deps);
310
+ // Step 3 -- the shared server is gone: start it the way 'apra-fleet start'
311
+ // does and attach over HTTP.
312
+ // A server the user stopped with 'apra-fleet stop' stays stopped: fail
313
+ // with the actionable error instead of starting it (also on a mid-run
314
+ // reconnect, which re-runs this resolution).
315
+ const stopped = readStoppedByUser(getFleetDataDir(env));
316
+ if (stopped) throw stoppedByUserError(stopped);
317
+ const autoStart = deps.autoStartFleetServer || autoStartFleetServer;
318
+ const started = await autoStart({ ...deps, env, checkRunningInstance: probe });
228
319
  return {
229
- mode: 'stdio',
230
- ...cmd,
231
- reason: `no healthy fleet singleton found; self-spawning stdio server via ${cmd.command} ${cmd.args.join(' ')}`,
320
+ mode: 'http',
321
+ url: started.url,
322
+ pid: started.pid,
323
+ started: started.started !== false,
324
+ reason: started.started === false
325
+ ? `attached to HTTP singleton at ${started.url} (pid ${started.pid}), started by another client`
326
+ : `the shared HTTP server was not running; started it and attached at ${started.url} (pid ${started.pid})`,
232
327
  };
233
328
  }
234
329
 
330
+ /**
331
+ * A ReconnectingHttpTransport for an http-mode resolution: on a refused
332
+ * connection or a lost session it re-runs the resolution (re-probe; auto-start
333
+ * a gone server unless APRA_FLEET_TRANSPORT=http) and reconnects.
334
+ *
335
+ * @param {{url: string}} connection an http-mode result of resolveFleetServerConnection
336
+ * @param {object} [deps] same bag as resolveFleetServerConnection, plus `options`
337
+ * (transport options) and `createTransport` (tests).
338
+ * @returns {ReconnectingHttpTransport}
339
+ */
340
+ export function createFleetHttpTransport(connection, deps = {}) {
341
+ const env = deps.env || process.env;
342
+ // Every /mcp session needs the install's access secret (a FULL session as
343
+ // much as a ?member= one); read from the data dir the server was resolved from.
344
+ const authedOptions = withFleetAccessSecret(deps.options || {}, env);
345
+ const forcedHttp = (env.APRA_FLEET_TRANSPORT || '').trim().toLowerCase() === 'http';
346
+ // Reconnecting must stay on HTTP: never let the resolver pick stdio here.
347
+ const relocateEnv = { ...env };
348
+ delete relocateEnv.APRA_FLEET_SERVER_CMD;
349
+ delete relocateEnv.APRA_FLEET_SERVER_BIN;
350
+ if (!forcedHttp) delete relocateEnv.APRA_FLEET_TRANSPORT;
351
+ return new ReconnectingHttpTransport(connection.url, {
352
+ options: authedOptions,
353
+ createTransport: deps.createTransport,
354
+ relocate: async () => {
355
+ const r = await resolveFleetServerConnection({ ...deps, env: relocateEnv });
356
+ return r.url;
357
+ },
358
+ });
359
+ }
360
+
235
361
  /**
236
362
  * Resolve + connect, returning a live MCP client bound to whichever transport the
237
363
  * ADR order selected.
@@ -245,7 +371,7 @@ export async function connectFleet(deps = {}) {
245
371
  const options = deps.options || {};
246
372
 
247
373
  const transport = resolution.mode === 'http'
248
- ? new StreamableHttpTransport(resolution.url, options)
374
+ ? createFleetHttpTransport(resolution, { ...deps, options })
249
375
  : new StdioTransport(resolution.command, resolution.args, options);
250
376
 
251
377
  await transport.start();
@@ -263,3 +389,114 @@ export async function connectFleet(deps = {}) {
263
389
 
264
390
  return { transport, mcpClient, fleetApi: new ApraFleet(mcpClient), mode: resolution.mode };
265
391
  }
392
+
393
+ /** Header a `?member=` request carries the install's member access secret in
394
+ * (mirrors MEMBER_SECRET_HEADER in src/services/member-access-secret.ts). */
395
+ export const MEMBER_SECRET_HEADER = 'X-Apra-Fleet-Member-Secret';
396
+
397
+ /**
398
+ * The member access secret of the install whose data dir `env` names
399
+ * (<data dir>/member-access.key, owner-only), or null when there is none
400
+ * (an install older than the secret, whose server does not check it).
401
+ * @param {NodeJS.ProcessEnv} [env]
402
+ * @returns {string|null}
403
+ */
404
+ export function readMemberAccessSecret(env = process.env) {
405
+ try {
406
+ const v = fs.readFileSync(path.join(getFleetDataDir(env), 'member-access.key'), 'utf8').trim();
407
+ return /^[0-9a-f]{64}$/.test(v) ? v : null;
408
+ } catch {
409
+ return null;
410
+ }
411
+ }
412
+
413
+ /**
414
+ * `options` with the install's access secret added as a request header (an
415
+ * explicit header already in `options` wins). Every http connection to the
416
+ * local server needs it -- the server refuses a /mcp session without a member
417
+ * JWT or this secret with HTTP 401. A missing secret file leaves `options`
418
+ * unchanged (the server then answers 401 with its own clear message).
419
+ * @param {object} [options] StreamableHttpTransport options
420
+ * @param {NodeJS.ProcessEnv} [env]
421
+ * @returns {object}
422
+ */
423
+ export function withFleetAccessSecret(options = {}, env = process.env) {
424
+ const secret = readMemberAccessSecret(env);
425
+ if (!secret) return options;
426
+ return { ...options, headers: { [MEMBER_SECRET_HEADER]: secret, ...(options.headers || {}) } };
427
+ }
428
+
429
+ /**
430
+ * Resolve + connect a MEMBER session: the local HTTP singleton with
431
+ * `?member=<uuid>` appended, so the server scopes the session's tools to the
432
+ * member allowlist. A member session needs the HTTP singleton (the identity
433
+ * rides on the URL); a stdio self-spawn cannot carry one, so it is refused.
434
+ * An unregistered uuid is refused by the server with HTTP 403 at initialize;
435
+ * the rejection carries `.status === 403` and `.code === 'HTTP_403'`.
436
+ *
437
+ * `deps.origin === 'engine'` adds `origin=engine` to the URL: the session is
438
+ * the ENGINE acting as the member (memberCall, `apra-fleet call`), and the
439
+ * server excludes its kb_/code_ calls from the member's session_stats counts.
440
+ * Only those engine paths set it; any other origin value is refused.
441
+ *
442
+ * The server accepts a `?member=` session only with its install's member
443
+ * access secret: it is read from the same data dir the server was resolved
444
+ * from (readMemberAccessSecret) and sent in the MEMBER_SECRET_HEADER header
445
+ * on every request. Without it the server answers HTTP 401.
446
+ *
447
+ * `deps.kbMaintainer === true` (requires `origin: 'engine'`) adds
448
+ * `kb_maintainer=1`: the engine's kb_maintainer grant. The server then also
449
+ * serves kb_promote, kb_resolve_contradiction and kb_reconcile_prefilter to
450
+ * this member session (they mint CONFIRMED; no other member session sees
451
+ * them), and accepts kb_import with an explicit `path` (refused with
452
+ * E-KB-MAINTAINER-REQUIRED in a member session without the grant; kb_import
453
+ * without `path` works in every member session, but without the grant it reads
454
+ * the bible as committed at HEAD only), and lets kb_invalidate and kb_capture
455
+ * `supersedes` retire CONFIRMED entries (without the grant they are left live
456
+ * and listed in the response's `refused`). memberCall sets it only for
457
+ * the member it chose as a repository's kb_maintainer.
458
+ *
459
+ * @param {string} memberId registered member uuid
460
+ * @param {object} [deps] same bag as resolveFleetServerConnection, plus `options`
461
+ * forwarded to the transport and optional
462
+ * `origin: 'engine'`, and optional `kbMaintainer: true`.
463
+ * @returns {Promise<{transport: object, mcpClient: McpClient, mode: 'http', url: string, close: () => Promise<void>}>}
464
+ * Always `await close()` when done: it DELETEs the server session so no
465
+ * McpServer or registry entry is leaked (`transport.stop()` does not).
466
+ */
467
+ export async function connectFleetMember(memberId, deps = {}) {
468
+ if (!memberId) throw new Error('connectFleetMember requires a member id.');
469
+ if (deps.origin !== undefined && deps.origin !== 'engine') {
470
+ throw new Error(`connectFleetMember: unsupported origin '${deps.origin}' (only 'engine' is accepted).`);
471
+ }
472
+ if (deps.kbMaintainer !== undefined && typeof deps.kbMaintainer !== 'boolean') {
473
+ throw new Error('connectFleetMember: kbMaintainer must be a boolean.');
474
+ }
475
+ if (deps.kbMaintainer === true && deps.origin !== 'engine') {
476
+ throw new Error("connectFleetMember: kbMaintainer requires origin 'engine' (the kb_maintainer grant is engine-only).");
477
+ }
478
+ const resolution = await resolveFleetServerConnection(deps);
479
+ if (resolution.mode !== 'http') {
480
+ throw new Error(
481
+ 'A member session requires the local apra-fleet HTTP server, but none was resolved ' +
482
+ `(${resolution.reason}). Start it with 'apra-fleet start'.`,
483
+ );
484
+ }
485
+ const url = new URL(resolution.url);
486
+ url.searchParams.set('member', memberId);
487
+ if (deps.origin === 'engine') url.searchParams.set('origin', 'engine');
488
+ if (deps.kbMaintainer === true) url.searchParams.set('kb_maintainer', '1');
489
+ const options = { ...(deps.options || {}) };
490
+ const secret = readMemberAccessSecret(deps.env || process.env);
491
+ if (secret) options.headers = { ...(options.headers || {}), [MEMBER_SECRET_HEADER]: secret };
492
+ const transport = new StreamableHttpTransport(url.toString(), options);
493
+ await transport.start();
494
+ return {
495
+ transport,
496
+ mcpClient: new McpClient(transport),
497
+ mode: 'http',
498
+ url: url.toString(),
499
+ /** Release the server-side member session (HTTP DELETE) and stop the transport. */
500
+ close: () => transport.close(),
501
+ };
502
+ }
@@ -50,7 +50,7 @@ export class StdioTransport extends EventEmitter {
50
50
  }
51
51
 
52
52
  start() {
53
- this.process = spawn(this.command, this.args, this.options);
53
+ this.process = spawn(this.command, this.args, { windowsHide: true, ...this.options });
54
54
 
55
55
  this.process.stdout.on('data', (chunk) => {
56
56
  this.buffer += chunk.toString();
@@ -142,7 +142,11 @@ export class StreamableHttpTransport extends EventEmitter {
142
142
  });
143
143
 
144
144
  if (!postResponse.ok) {
145
- throw new Error(`Init POST error! status: ${postResponse.status}`);
145
+ const initErr = new Error(`Init POST error! status: ${postResponse.status}`);
146
+ // Typed so callers can tell a refused member identity (403) from a network failure.
147
+ initErr.status = postResponse.status;
148
+ initErr.code = `HTTP_${postResponse.status}`;
149
+ throw initErr;
146
150
  }
147
151
 
148
152
  this.sessionId = postResponse.headers.get('mcp-session-id');
@@ -307,7 +311,13 @@ export class StreamableHttpTransport extends EventEmitter {
307
311
  }
308
312
 
309
313
  if (!response.ok) {
310
- throw new Error(`Failed to send message: HTTP ${response.status}`);
314
+ // .status lets callers classify the failure (404 = unknown
315
+ // session, rejected before any tool ran -- see
316
+ // reconnecting-transport.mjs) without parsing the message.
317
+ const httpErr = new Error(`Failed to send message: HTTP ${response.status}`);
318
+ httpErr.status = response.status;
319
+ try { await response.body?.cancel(); } catch { /* ignore */ }
320
+ throw httpErr;
311
321
  }
312
322
 
313
323
  // The server sends the JSON-RPC response over an SSE stream in the POST response
@@ -318,6 +328,30 @@ export class StreamableHttpTransport extends EventEmitter {
318
328
  });
319
329
  }
320
330
 
331
+ /**
332
+ * Release the server-side session (HTTP DELETE with the session id, best
333
+ * effort and short-bounded), then stop(). stop() alone only aborts the
334
+ * local streams and leaves the server's session, McpServer and any member
335
+ * registry entry alive; short-lived callers (apra-fleet call, memberCall)
336
+ * must use close().
337
+ */
338
+ async close() {
339
+ const sid = this.sessionId;
340
+ if (sid) {
341
+ try {
342
+ const res = await undiciFetch(this.url, {
343
+ method: 'DELETE',
344
+ headers: { 'mcp-session-id': sid, ...(this.options.headers || {}) },
345
+ signal: AbortSignal.timeout(5000),
346
+ dispatcher: sseDispatcher,
347
+ });
348
+ if (res && res.body) await res.body.cancel().catch(() => {});
349
+ } catch { /* best effort: the server may already be gone */ }
350
+ this.sessionId = null;
351
+ }
352
+ this.stop();
353
+ }
354
+
321
355
  stop() {
322
356
  if (this.controller) {
323
357
  this.controller.abort();
@@ -10,30 +10,62 @@ You groom ONE operator's slice of the open beads backlog: what to pick up next,
10
10
  to sprint together, what's a duplicate, what needs fixing before it's actionable. You
11
11
  analyze AND mutate beads directly -- but you never touch code beyond reading it.
12
12
 
13
- ## Step 0 -- Knowledge Bank (required -- do this BEFORE any grooming decision)
14
-
15
- <!-- if-tool: ToolSearch -->
16
- 1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
17
- <!-- else-tool: ToolSearch -->
18
- 1. No tool-discovery step is needed on this provider: every step below names the KB
19
- tool it wants directly. Confirm your environment exposes those tools, then call
20
- them as written.
21
- <!-- end-tool: ToolSearch -->
22
- 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo whose backlog
23
- you are grooming, and `hint_modules` naming the subsystems the assigned beads touch.
24
- Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. This matters
25
- most for duplicate detection and sprint-set grouping.
26
- 3. When grooming turns up a durable backlog fact -- two ids that are genuinely the same
27
- work, a dependency between beads that their text does not state, or a recurring reason
28
- items land unactionable -- call `mcp__apra-fleet__kb_capture` with type "knowledge".
29
- Do not capture per-sprint churn; capture what stays true.
30
-
31
- <!-- if-tool: ToolSearch -->
32
- If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
33
- <!-- else-tool: ToolSearch -->
34
- If those KB tools are not available in your environment (MCP server not running), skip
35
- these steps and proceed.
36
- <!-- end-tool: ToolSearch -->
13
+ ## Step 0 -- Knowledge Bank (do this BEFORE any grooming decision)
14
+
15
+ If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
16
+ tool-discovery step is needed, and they always act on your own work folder, so never
17
+ pass a repository path or other scope argument to them. Otherwise, read the injected
18
+ "KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
19
+ the orchestrator fetched for the backlog you are grooming.
20
+ If a KB or code tool call fails, use that block if your prompt has one; otherwise
21
+ continue without KB. A missing or failing KB or code tool is never a reason to stop:
22
+ never report this dispatch as blocked because of it. From whichever source you have,
23
+ trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
24
+
25
+ If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
26
+ your tool-loading tool first, before concluding they are unavailable.
27
+
28
+ 1. When the tools are present, call `kb_session_prime` with `hint_modules` naming the
29
+ subsystems the assigned beads touch. KB knowledge matters most for duplicate
30
+ detection and sprint-set grouping.
31
+ 2. This role has no KB-capture channel: when grooming turns up a durable backlog fact --
32
+ two ids that are genuinely the same work, a dependency between beads that their text
33
+ does not state, or a recurring reason items land unactionable -- note it in your own
34
+ report. Record what stays true, not per-sprint churn.
35
+
36
+ ### Persistent Memories (operational rules)
37
+
38
+ Before beginning grooming decisions, retrieve universal conventions and role-scoped operational rules from Beads:
39
+
40
+ ```bash
41
+ bd memories --json +all+
42
+ bd memories --json +groomer+
43
+ ```
44
+
45
+ Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
46
+ search also matches value text, so apply only entries whose KEY contains `+all+` or `+groomer+`.
47
+
48
+ **One-time key migration** (older groomer versions saved heuristics as
49
+ `groomer-heuristic-<slug>`, which the `+groomer+` query never returns). Run
50
+ `bd memories --json groomer-heuristic-` only to list keys (its JSON escapes quotes and
51
+ `&`, `<`, `>`, so never copy values from it); for each KEY starting with `groomer-heuristic-`:
52
+
53
+ 1. Read the value with `bd recall <old key>` (raw text).
54
+ 2. If `+groomer+:<slug>` already exists with a different value, leave both keys and
55
+ report the conflict in `notes`.
56
+ 3. Otherwise `bd remember --key "+groomer+:<slug>" -- "<value>"`, quoted for your shell so
57
+ `$`, backticks and `&&` survive. If the value contains double quotes or other characters
58
+ the current shell cannot pass verbatim (e.g. Windows PowerShell 5.1 strips embedded
59
+ double quotes), do not migrate that key; report it in `notes` instead.
60
+ 4. `bd forget <old key>` ONLY if `bd recall <old key>` and `bd recall "+groomer+:<slug>"`
61
+ print identical text; otherwise keep both keys and report the mismatch in `notes`.
62
+
63
+ Steps 3-4 write, so they follow the same gate as bead mutations: only with `dry-run: false`
64
+ and not in report-only "What needs grooming" mode. Otherwise run no `bd remember`/`bd forget`;
65
+ list each key you would migrate (old -> new) with its exact proposed `bd` commands in `notes`.
66
+ Report each key actually migrated in `heuristicsRecorded` (new key + value) and count them
67
+ in `notes`. Nothing to do when the query returns no `groomer-heuristic-` keys. Either way,
68
+ apply those entries in this session too.
37
69
 
38
70
  ## Usage modes
39
71
 
@@ -309,16 +341,32 @@ use), report the same fields in this JSON shape for an orchestrator caller, or a
309
341
  You have no conversation memory between invocations; beads does, per-database, which is
310
342
  the right scope since most of what you learn is calibrated to one repo's backlog.
311
343
 
312
- At session start: `bd memories groomer` -- read and apply what past sessions recorded.
344
+ At session start: retrieve operational memories -- read and apply what past sessions recorded:
345
+
346
+ ```bash
347
+ bd memories --json +all+
348
+ bd memories --json +groomer+
349
+ ```
350
+
351
+ Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
352
+ search also matches value text, so apply only entries whose KEY contains `+all+` or `+groomer+`.
313
353
 
314
354
  At session end, if you found a durable, non-obvious pattern specific to THIS repo's
315
355
  backlog (not a one-off, not already in this file):
316
356
 
317
357
  ```bash
318
- bd remember --key groomer-heuristic-<short-slug> "<one or two sentences>"
358
+ bd remember --key "+groomer+:<short-slug>" "<one or two sentences>"
319
359
  ```
320
360
 
321
- Always use the `groomer-heuristic-` prefix (`bd memories groomer`, `bd forget <key>`).
361
+ Key scheme: wrap every role token in `+` on both sides, then `:<slug>`. Use
362
+ `+groomer+:<slug>` for a groomer-only rule, `+groomer+planner+:<slug>` when other roles
363
+ need it too, `+all+:<slug>` when every role does. `bd memories` is a plain substring
364
+ search over keys and values, so a bare or one-sided prefix (`groomer:`, `reviewer:`)
365
+ also matches other roles' keys; never write one. Remove stale entries with `bd forget <key>`.
322
366
  Record calibration ("P1 bugs older than 30 days with no repro steps are almost always
323
367
  stale duplicates in this repo"), not repo-agnostic procedure (belongs in this file) or
324
368
  transient facts. If nothing durable turned up, write nothing and say so.
369
+
370
+ ## Shell command discipline
371
+
372
+ No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.