@apralabs/apra-fleet 0.4.2 → 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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  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/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,825 @@
1
+ // =============================================================================
2
+ // Beads identity precondition: prove which .beads every member will mutate
3
+ // BEFORE the sprint issues its first mutating bd command.
4
+ //
5
+ // fleet-sprint never runs bd itself -- every bd goes to a member and runs in
6
+ // that member's workFolder, so bd's own cwd discovery decides which database
7
+ // a sprint mutates. Nothing else in the engine verifies that the database a
8
+ // member resolves to is the project the supervisor launched the sprint for.
9
+ // This module runs the three read-only probes from beads-identity.mjs on the
10
+ // backlog member first and then on every other distinct member, and
11
+ // compares each answer against the expected identity. The expected identity
12
+ // is either the supervisor's (`--expect-beads`, args.expectBeads) or, absent
13
+ // that, the backlog member's own probed identity -- in which case only
14
+ // the OTHER members are compared and the log says so.
15
+ //
16
+ // Severity model (deliberate):
17
+ // - MISMATCH is FATAL: a field that resolved on BOTH sides and differs
18
+ // means the member's bd points at a different project. Throws
19
+ // BeadsIdentityError (reason MISMATCH) before any bd mutation.
20
+ // - bd MISSING is FATAL: a bd probe whose failure classifies as a
21
+ // missing-tool failure for bd itself (not installed / not on PATH) throws
22
+ // BeadsIdentityError (reason MISSING_TOOL) before any dispatch, naming
23
+ // the member and the fix -- every bd there would fail mid-sprint.
24
+ // - a beads-reading member with NO beads database, or with a database but
25
+ // no sync.remote while the expectation names one, is SET UP before any
26
+ // dispatch (setupMemberBeads below): `bd config set sync.remote
27
+ // <expected>` + `bd bootstrap`, which clones the database from that
28
+ // remote non-destructively (an existing database is never replaced). The
29
+ // member is then re-probed and must match. When that cannot be done the
30
+ // preflight throws BEADS_SETUP_FAILED naming the member, the cause and
31
+ // the fix -- never a warning followed by dispatches whose `bd show`
32
+ // cannot find the sprint's issues.
33
+ // - any other UNRESOLVED probe is a WARNING: a probe that failed, or answered
34
+ // something unparseable/empty, leaves that field out of the comparison.
35
+ // The warning names the member, the field, the probe, the error and the
36
+ // fix, so the operator can repair it; the first real bd on that member
37
+ // surfaces a genuinely broken member exactly as it does today. Every
38
+ // warning is logged with the `[beads-identity] WARNING:` prefix, and
39
+ // collected into the published `beadsIdentity` state (`warnings`, plus
40
+ // a per-member `unresolved` field list) so the viewer can show it.
41
+ //
42
+ // Every command() call here names its member explicitly (dispatch-safety
43
+ // guard) and is issued failSoft + silent, like every other read-only probe in
44
+ // this package. Each member is probed at most once per run.
45
+ // =============================================================================
46
+
47
+ import {
48
+ BEADS_IDENTITY_PROBES,
49
+ COMPARED_FIELDS,
50
+ parseBeadsIdentity,
51
+ compareIdentity,
52
+ formatBeadsIdentity,
53
+ normalizeRemoteUrl,
54
+ hasBeadsDatabase,
55
+ } from './beads-identity.mjs';
56
+ import { BeadsIdentityError, BEADS_IDENTITY_FAILURE_REASONS, VCS_FAILURE_KINDS } from './errors.mjs';
57
+ import { syncBefore as doltSyncBefore } from './dolt-sync.mjs';
58
+ import { classifyFailure, commandBinary } from './vcs-module.mjs';
59
+
60
+ // Short: three cheap local reads per member. A member that cannot answer
61
+ // `bd where` inside a minute is not a member this sprint should mutate.
62
+ export const BEADS_IDENTITY_PROBE_TIMEOUT_S = 60;
63
+
64
+ const LABEL = 'beads-identity';
65
+ export const BEADS_IDENTITY_WARNING_PREFIX = '[beads-identity] WARNING: ';
66
+
67
+ // Which probe each compared field comes from, and the operator-facing fix
68
+ // when that field could not be resolved on a member. Generic on purpose: no
69
+ // product paths, no host-specific text.
70
+ const FIELD_PROBE = Object.freeze({
71
+ prefix: 'where',
72
+ syncRemote: 'syncRemote',
73
+ repoRemote: 'repoRemote',
74
+ });
75
+
76
+ export const BEADS_IDENTITY_FIELD_FIX = Object.freeze({
77
+ prefix: "run 'bd where' in the member's workFolder; ensure bd is installed there and the folder contains the project's .beads",
78
+ syncRemote: "set it on that member with 'bd config set sync.remote <url>' in its workFolder",
79
+ repoRemote: "the member's workFolder is not a git clone with an 'origin' remote; re-register the member with a real clone or add the remote",
80
+ });
81
+
82
+ function outputOf(res) {
83
+ if (res && typeof res === 'object') return typeof res.output === 'string' ? res.output : '';
84
+ return typeof res === 'string' ? res : '';
85
+ }
86
+
87
+ function failureOf(res) {
88
+ if (res && typeof res === 'object' && res.ok === false) return String(res.error || 'command failed');
89
+ return null;
90
+ }
91
+
92
+ // One line (a warning is one log line), capped.
93
+ function summarizeRaw(text) {
94
+ const t = String(text || '').replace(/\s+/g, ' ').trim();
95
+ if (!t) return '(no output)';
96
+ return t.length > 400 ? `${t.slice(0, 400)}...` : t;
97
+ }
98
+
99
+ /**
100
+ * A per-run prober: runs the three identity probes on a member through the
101
+ * injected command() and memoizes the result so a member is probed once.
102
+ *
103
+ * @param {{ command: Function, timeoutS?: number }} opts
104
+ * @returns {{ probe: (member: string) => Promise<{ identity: object, raw: object, failures: Array<{probe: string, key: string, error: string}> }> }}
105
+ */
106
+ export function createBeadsIdentityProber({ command, timeoutS = BEADS_IDENTITY_PROBE_TIMEOUT_S }) {
107
+ if (typeof command !== 'function') {
108
+ throw new TypeError('createBeadsIdentityProber({ command }): command must be a function');
109
+ }
110
+ const cache = new Map();
111
+
112
+ async function runProbes(member) {
113
+ const raw = {};
114
+ const failures = [];
115
+ for (const [key, cmd] of Object.entries(BEADS_IDENTITY_PROBES)) {
116
+ let res;
117
+ try {
118
+ res = await command(cmd, { member_name: member, silent: true, failSoft: true, label: LABEL, timeout_s: timeoutS });
119
+ } catch (err) {
120
+ res = { ok: false, output: '', error: err && err.message ? err.message : String(err) };
121
+ }
122
+ const failed = failureOf(res);
123
+ raw[key] = outputOf(res);
124
+ if (failed !== null) failures.push({ probe: cmd, key, error: failed });
125
+ }
126
+ return { identity: parseBeadsIdentity(raw), raw, failures };
127
+ }
128
+
129
+ return {
130
+ probe(member) {
131
+ let pending = cache.get(member);
132
+ if (!pending) {
133
+ pending = runProbes(member);
134
+ cache.set(member, pending);
135
+ }
136
+ return pending;
137
+ },
138
+ // Drops the memoized answer so the next probe() re-runs the probes --
139
+ // used after the preflight itself changed the member's beads setup.
140
+ forget(member) {
141
+ cache.delete(member);
142
+ },
143
+ };
144
+ }
145
+
146
+ // Why a probe key resolved to nothing on this member: its recorded failure,
147
+ // else the (unparseable or empty) output it did return.
148
+ function probeDetail(probed, key) {
149
+ const failure = probed.failures.find((f) => f.key === key);
150
+ if (failure) return summarizeRaw(failure.error);
151
+ const out = String(probed.raw[key] || '').trim();
152
+ if (!out) return 'empty output';
153
+ // `bd config get` answers an unset key with exit 0 and value "": the
154
+ // probe worked, the value is simply not configured.
155
+ if (key === 'syncRemote') return 'sync.remote is unset';
156
+ return `unparseable output: ${summarizeRaw(out)}`;
157
+ }
158
+
159
+ // The member's `bd where` produced no database path: nothing to compare.
160
+ function noDatabaseWarning(member, probed) {
161
+ return `member '${member}' reports no beads database in its workFolder ` +
162
+ `('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(probed, 'where')}); nothing to compare, the first bd command on it will surface the problem. ` +
163
+ `To fix: ${BEADS_IDENTITY_FIELD_FIX.prefix}.`;
164
+ }
165
+
166
+ // One compared field is empty on the member's side.
167
+ function unresolvedFieldWarning(member, field, probed) {
168
+ const key = FIELD_PROBE[field];
169
+ return `member '${member}' could not report ${field} ('${BEADS_IDENTITY_PROBES[key]}' -> ${probeDetail(probed, key)}); not compared. ` +
170
+ `To fix: ${BEADS_IDENTITY_FIELD_FIX[field]}.`;
171
+ }
172
+
173
+ // One compared field is empty on the EXPECTED side (the supplied
174
+ // --expect-beads carries no value for it, or the orchestrator it was derived
175
+ // from could not report it), so no member can be checked on it.
176
+ function unresolvedExpectedWarning(field, expectedFrom, backlogMember) {
177
+ const source = expectedFrom === 'backlog'
178
+ ? `the backlog member '${backlogMember}' it was derived from could not report ${field}`
179
+ : `the supplied expected beads identity carries no ${field}`;
180
+ return `${source}; ${field} is not compared on any member this sprint. ` +
181
+ `To fix: ${BEADS_IDENTITY_FIELD_FIX[field]}${expectedFrom === 'backlog' ? ' (on the backlog member), or launch via the supervisor so --expect-beads is supplied' : ''}.`;
182
+ }
183
+
184
+ function noExpectationWarning(backlogMember, probed) {
185
+ return `no expected beads identity was supplied and the backlog member '${backlogMember}' could not report its beads database ` +
186
+ `('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(probed, 'where')}); no cross-member beads identity check will happen this sprint. ` +
187
+ `To restore it: fix the backlog member's beads (${BEADS_IDENTITY_FIELD_FIX.prefix}), or launch via the supervisor so --expect-beads is supplied.`;
188
+ }
189
+
190
+ export const BD_MISSING_FIX =
191
+ "install bd on that member (or fix that member's PATH) so 'bd --version' works in its workFolder shell " +
192
+ '(re-running the member fleet install places it in the member fleet bin dir), then relaunch';
193
+
194
+ // The one probe outcome that is fatal besides a mismatch -- the member cannot
195
+ // run bd AT ALL (not installed / not on PATH). Every later bd command on it
196
+ // would fail, and neither the sync self-heal nor the beads set-up below can
197
+ // fix a missing binary, so the sprint stops here with the fix named. Only a
198
+ // failure of a bd probe that classifies as missing-tool FOR bd counts (the
199
+ // shared VCS failure classifier); every other probe failure (no database,
200
+ // unset field, unrelated profile noise) stays a warning.
201
+ export function assertBdPresent(member, probed) {
202
+ for (const f of probed.failures) {
203
+ const tool = commandBinary(f.probe);
204
+ if (tool !== 'bd') continue;
205
+ const c = classifyFailure(f.error, { tool });
206
+ if (c.kind !== VCS_FAILURE_KINDS.MISSING_TOOL) continue;
207
+ throw new BeadsIdentityError(
208
+ `Beads identity check failed: 'bd' is not installed or not on PATH on member '${member}' ` +
209
+ `('${f.probe}' -> ${summarizeRaw(f.error)}). Every sprint role on it runs bd, so the sprint stops before any dispatch; ` +
210
+ 're-provisioning credentials cannot fix a missing binary. To fix: ' + BD_MISSING_FIX + '.',
211
+ { reason: BEADS_IDENTITY_FAILURE_REASONS.MISSING_TOOL, member, details: { tool: 'bd', probe: f.probe, error: f.error } }
212
+ );
213
+ }
214
+ }
215
+
216
+ // ---------------------------------------------------------------------------
217
+ // Member beads set-up (the one self-heal this preflight performs).
218
+ //
219
+ // A role that reads beads on a member (`bd show <root>`, `bd ready`, ...)
220
+ // reads the database bd resolves in THAT member's workFolder. A fresh clone
221
+ // with bd installed but no beads database -- or with a database whose
222
+ // sync.remote is unset, so no D-pull ever freshens it -- answers "not found"
223
+ // for every sprint issue. So before any dispatch the preflight sets the
224
+ // member up from the sprint's EXPECTED beads remote (verified against bd
225
+ // 1.3 on POSIX and PowerShell):
226
+ //
227
+ // both cases: git ls-files (modified / untracked beads paths, BEFORE any write)
228
+ // <ensure .beads/config.yaml exists> (bd config set refuses to write
229
+ // without a workspace; per-shell,
230
+ // never truncates)
231
+ // <ensure line 'sync.remote: "<expected>"' in .beads/config.local.yaml>
232
+ // (bd's untracked local layer: the
233
+ // durable record, see "target repo")
234
+ // bd config set sync.remote <expected>
235
+ // no database: bd bootstrap --dry-run --json (must plan a clone FROM <expected>;
236
+ // any other plan -- JSONL import,
237
+ // fresh database -- would yield a
238
+ // database with an unrelated history)
239
+ // bd bootstrap --yes (clones and wires the dolt remote
240
+ // 'origin'; never deletes data)
241
+ // database but
242
+ // no sync.remote: bd dolt remote list --json (bootstrap does NOT wire 'origin' on an
243
+ // existing database; an 'origin' pointing
244
+ // elsewhere is refused, never rewired)
245
+ // bd dolt remote add origin <expected> (only when 'origin' is absent)
246
+ // pull via DoltSync.syncBefore (proves the existing database is a
247
+ // clone of <expected> and brings it current)
248
+ // finally (success or failure):
249
+ // git checkout -- <each tracked beads file the set-up changed>
250
+ // <git info/exclude each beads path the set-up left untracked>
251
+ //
252
+ // Target repo: the member's work folder is a clone of the sprint's TARGET
253
+ // repository, and a doer's `git add -A` there must never carry the set-up
254
+ // into the target PR. bd rewrites tracked beads files during set-up (it
255
+ // reflows config.yaml and adds a sync block that would switch sync on for
256
+ // every user of the repo, appends to .gitignore, rewrites metadata.json) and
257
+ // leaves untracked ones (.beads.gate.lock at the root, config.local.yaml, a
258
+ // whole .beads/ when the repo tracks only issues.jsonl). So the tracked files
259
+ // it changed are restored from git -- bd keeps working: it reads sync.remote
260
+ // from config.local.yaml and the database is untouched -- and the new
261
+ // untracked paths go into the member's git info/exclude. Verified with real
262
+ // bd 1.3 on a fresh clone of a repo that commits its beads config: `git
263
+ // status --porcelain` is empty afterwards, `git add -A` stages nothing, and
264
+ // a later checkout/merge of an upstream change to config.yaml still works.
265
+ //
266
+ // Every step goes through the injected command() with the member named, so
267
+ // the runner's command() wrapper (DoltSync.noteMemberCommand) sees the
268
+ // `bd config set` / `bd bootstrap` / `bd dolt remote` and drops that member's
269
+ // sync.remote memo. The member's VCS credential is ensured first (the clone
270
+ // may need auth). The bd command strings are plain `bd ...` with the remote
271
+ // passed as one bare word: execute_command establishes the cwd per member
272
+ // OS/shell, and the remote is refused unless it is made only of characters
273
+ // every supported shell (POSIX, PowerShell, cmd) passes through verbatim --
274
+ // no quoting, no shell expansion.
275
+ //
276
+ // Older-schema remote: bd may auto-apply pending schema migrations to a
277
+ // freshly cloned database and leave them uncommitted in the working set, and
278
+ // the next D-pull then dies on "local changes would be stomped". A dispatch
279
+ // member must not publish a shared-schema migration on its own, so when any
280
+ // set-up output (or the re-probe after it) reports that, the preflight stops
281
+ // with BEADS_SETUP_FAILED naming the cause and the fix (publish the
282
+ // migration once, from the backlog member) instead of leaving the trap for
283
+ // the first dispatch.
284
+ // ---------------------------------------------------------------------------
285
+
286
+ // The roles whose contracts run bd on their member. deployer and ci-watcher
287
+ // do not; a member mapped ONLY to those is not set up (a missing database
288
+ // there stays the warning it was).
289
+ export const BEADS_READING_ROLES = Object.freeze([
290
+ 'planner',
291
+ 'plan-reviewer',
292
+ 'doer',
293
+ 'reviewer',
294
+ 'integ-test-runner',
295
+ 'regression-test-runner',
296
+ 'harvester',
297
+ ]);
298
+
299
+ // A bootstrap clones the whole beads history: allow it far longer than a probe.
300
+ export const BEADS_SETUP_TIMEOUT_S = 600;
301
+ const SETUP_LABEL = 'beads-setup';
302
+
303
+ // The work-folder-relative file whose presence makes the folder a beads
304
+ // workspace `bd config set` can write to.
305
+ export const BEADS_WORKSPACE_CONFIG_FILE = '.beads/config.yaml';
306
+ // bd's untracked, machine-local config layer (read over config.yaml). The
307
+ // sync remote is recorded HERE, because bd rewrites the (often tracked)
308
+ // config.yaml during set-up and the preflight restores that file afterwards.
309
+ export const BEADS_LOCAL_CONFIG_FILE = '.beads/config.local.yaml';
310
+ export const beadsLocalSyncRemoteLine = (url) => `sync.remote: "${url}"`;
311
+
312
+ export const BEADS_SETUP_COMMANDS = Object.freeze({
313
+ setSyncRemote: (url) => `bd config set sync.remote ${url}`,
314
+ plan: 'bd bootstrap --dry-run --json',
315
+ bootstrap: 'bd bootstrap --yes',
316
+ remoteList: 'bd dolt remote list --json',
317
+ addOrigin: (url) => `bd dolt remote add origin ${url}`,
318
+ // The pull itself is NOT a command here: every dolt pull/push goes
319
+ // through ./dolt-sync.mjs (DoltSync.syncBefore), which also brings its
320
+ // transient-retry ladder and the reactive VCS-auth self-heal.
321
+ });
322
+
323
+ // Characters a bare word keeps verbatim in POSIX shells, PowerShell and cmd
324
+ // (no $, %, backtick, quotes, spaces, ;, &, |, commas, parens, backslashes).
325
+ const SHELL_SAFE_REMOTE_RE = /^[A-Za-z0-9][A-Za-z0-9._~:/@+=-]*$/;
326
+
327
+ // bd's report that it migrated a database's schema locally, or that the
328
+ // remote is behind the local bd's schema. Matched against bd's own format
329
+ // strings (bd 1.3 source):
330
+ // "Smart gate (%s): auto-applying %d pending deterministic schema %s to a
331
+ // remote-backed database (...). Run `bd dolt push` after."
332
+ // "The database cloned from %s needs %d schema %s (v%d -> v%d)." ...
333
+ // "Re-running `%s` will NOT fix this -- the remote itself is behind."
334
+ // (the first reproduced verbatim by a live sprint; neither reproducible here
335
+ // without an older-schema remote).
336
+ const SCHEMA_MIGRATION_RE = /auto-applying\b[^\n]*\bschema migrations?|schema migrations?[^\n]*\bbd dolt push\b|\bneeds \d+ schema migrations?\b|remote itself is behind|remote[^\n]*\b(?:behind|older)\b[^\n]*\bschema|schema[^\n]*\bremote[^\n]*\b(?:behind|older)\b/i;
337
+
338
+ export function hasSchemaMigrationReport(text) {
339
+ return SCHEMA_MIGRATION_RE.test(String(text || ''));
340
+ }
341
+
342
+ function setupFix(url) {
343
+ return `in that member's workFolder create an empty '${BEADS_WORKSPACE_CONFIG_FILE}' if there is none, run 'bd config set sync.remote ${url || '<beads remote>'}' ` +
344
+ "then 'bd bootstrap --yes' (the member needs a VCS credential that can read that remote), check 'bd where' reports the project, then rerun the sprint";
345
+ }
346
+
347
+ const SCHEMA_FIX =
348
+ "the shared beads remote is at an older bd schema than the member's bd. Publish the migration once, from the backlog member: " +
349
+ 'push its beads database to the beads remote from its workFolder (with a VCS credential that can push that remote), then rerun the sprint';
350
+
351
+ function setupFailed(member, cause, fix, details) {
352
+ return new BeadsIdentityError(
353
+ `Beads preflight failed: member '${member}' ${cause}. A beads-reading role dispatched there would read a database ` +
354
+ `without this sprint's issues, so the sprint stops before any dispatch. To fix: ${fix}.`,
355
+ { reason: BEADS_IDENTITY_FAILURE_REASONS.BEADS_SETUP_FAILED, member, details }
356
+ );
357
+ }
358
+
359
+ function parseFirstJson(text, open = '{') {
360
+ const t = String(text || '');
361
+ const start = t.indexOf(open);
362
+ if (start < 0) return null;
363
+ try {
364
+ return JSON.parse(t.slice(start));
365
+ } catch {
366
+ return null;
367
+ }
368
+ }
369
+
370
+ // Paths the set-up can create or rewrite in the member's work tree, relative
371
+ // to it: `.beads/...` (bd reflows a tracked config.yaml, appends to a tracked
372
+ // .gitignore, rewrites metadata.json) and the `.beads.gate.lock` bd leaves at
373
+ // the work-folder root. Only lines of git output matching this are acted on.
374
+ const BEADS_TREE_PATH_RE = /^\.beads(?:\/[A-Za-z0-9._/-]*)?$|^\.beads\.gate\.lock$/;
375
+
376
+ export const BEADS_TREE_COMMANDS = Object.freeze({
377
+ // Tracked beads files with work-tree changes.
378
+ modified: 'git ls-files -m -- .beads',
379
+ // Untracked, not ignored; a wholly untracked directory collapses to one entry.
380
+ untracked: 'git ls-files --others --exclude-standard --directory -- .beads .beads.gate.lock',
381
+ restore: (relPath) => `git checkout -- ${relPath}`,
382
+ // The work folder's path below the repository root ('' at the root).
383
+ prefix: 'git rev-parse --show-prefix',
384
+ });
385
+
386
+ function beadsTreePaths(text) {
387
+ return String(text || '').split(/\r?\n/).map((l) => l.trim()).filter((l) => BEADS_TREE_PATH_RE.test(l) && !l.split('/').includes('..'));
388
+ }
389
+
390
+ /**
391
+ * Sets up one member's beads from `url` (see the section comment). Throws
392
+ * BeadsIdentityError(BEADS_SETUP_FAILED) on any step that fails; resolves
393
+ * when every step succeeded. Verifying the result is the caller's job (a
394
+ * fresh identity probe).
395
+ *
396
+ * The target repository must never receive the set-up's side effects through
397
+ * a later commit on the member (a doer's `git add -A`): bd rewrites tracked
398
+ * beads files (config.yaml gains the sync remote, .gitignore and
399
+ * metadata.json change) and adds untracked ones. So the beads paths that are
400
+ * modified/untracked are recorded BEFORE the first write, and afterwards --
401
+ * on success AND on failure, since a failed set-up may already have written
402
+ * -- every tracked file the set-up changed is restored (`git checkout --`;
403
+ * the sync remote survives in the untracked config.local.yaml) and every new
404
+ * untracked path is added to the member's git info/exclude
405
+ * (memberShell().ensureGitExcluded). The member's work tree then reports
406
+ * clean and `git add -A` stages nothing from the set-up.
407
+ *
408
+ * @param {{ command: Function, member: string, url: string, hasDb: boolean,
409
+ * memberShell?: (member: string) => Promise<{ ensureFile: (relPath: string) => string, ensureLine: (relPath: string, line: string) => string, ensureGitExcluded: (entry: string) => string }>,
410
+ * ensureVcsAuth?: (member: string) => Promise<void>, onAuthFailure?: Function,
411
+ * pullBeads?: Function, log?: Function, timeoutS?: number }} opts
412
+ * `memberShell` returns the member's OS/shell command builder (the SE
413
+ * command primitives); required. `onAuthFailure` is DoltSync's reactive
414
+ * VCS-auth self-heal for the pull; `pullBeads` replaces
415
+ * DoltSync.syncBefore (test seam).
416
+ * @returns {Promise<string[]>} the commands issued, in order
417
+ */
418
+ export async function setupMemberBeads({ command, member, url, hasDb, memberShell, ensureVcsAuth, onAuthFailure, pullBeads, log = () => {}, timeoutS = BEADS_SETUP_TIMEOUT_S }) {
419
+ if (!SHELL_SAFE_REMOTE_RE.test(url)) {
420
+ throw setupFailed(member,
421
+ `needs its beads set up from the expected beads remote '${url}', which contains characters that cannot be passed verbatim to every member shell`,
422
+ setupFix(url), { step: 'validate', url });
423
+ }
424
+ const issued = [];
425
+ const run = async (cmd) => {
426
+ issued.push(cmd);
427
+ let res;
428
+ try {
429
+ res = await command(cmd, { member_name: member, silent: true, failSoft: true, label: SETUP_LABEL, timeout_s: timeoutS });
430
+ } catch (err) {
431
+ res = { ok: false, output: '', error: err && err.message ? err.message : String(err) };
432
+ }
433
+ const error = failureOf(res);
434
+ return { ok: error === null, output: outputOf(res), error };
435
+ };
436
+ const assertNoMigration = (step, r) => {
437
+ const text = `${r.output}\n${r.error || ''}`;
438
+ if (hasSchemaMigrationReport(text)) {
439
+ throw setupFailed(member,
440
+ `had its beads set up from '${url}', but bd reports a schema migration against that remote ('${step}' -> ${summarizeRaw(text)})`,
441
+ SCHEMA_FIX, { step, url, cause: 'schema-migration' });
442
+ }
443
+ };
444
+
445
+ let shell = null;
446
+ try {
447
+ shell = typeof memberShell === 'function' ? await memberShell(member) : null;
448
+ } catch (err) {
449
+ log(`[beads-identity] could not resolve the shell of member '${member}': ${err && err.message ? err.message : err}`);
450
+ }
451
+ if (!shell || typeof shell.ensureFile !== 'function' || typeof shell.ensureLine !== 'function' || typeof shell.ensureGitExcluded !== 'function') {
452
+ throw setupFailed(member, 'needs its beads set up, but no command could be built for its shell', setupFix(url), { step: 'shell', url });
453
+ }
454
+
455
+ // What git already reports for the beads paths, before any write.
456
+ const listTree = async () => {
457
+ const modified = await run(BEADS_TREE_COMMANDS.modified);
458
+ const untracked = await run(BEADS_TREE_COMMANDS.untracked);
459
+ if (!modified.ok || !untracked.ok) {
460
+ const bad = !modified.ok ? modified : untracked;
461
+ throw setupFailed(member,
462
+ `needs its beads set up, but its workFolder's git state cannot be read to keep the set-up out of commits (${summarizeRaw(bad.error || bad.output)})`,
463
+ `make sure the member's workFolder is a git clone with git on PATH, or ${setupFix(url)}`, { step: 'tree', url });
464
+ }
465
+ return { modified: new Set(beadsTreePaths(modified.output)), untracked: new Set(beadsTreePaths(untracked.output)) };
466
+ };
467
+ const before = await listTree();
468
+ if (before.modified.size) {
469
+ log(`${BEADS_IDENTITY_WARNING_PREFIX}member '${member}' already has local changes to ${[...before.modified].join(', ')}; ` +
470
+ 'the beads set-up may add to them and will not restore them -- review those files before anything on that member is committed.');
471
+ }
472
+ // info/exclude patterns are relative to the repository root, git ls-files
473
+ // paths to the work folder: a work folder below the root needs its prefix.
474
+ const prefixRes = await run(BEADS_TREE_COMMANDS.prefix);
475
+ const rootPrefix = prefixRes.ok ? String(prefixRes.output || '').split(/\r?\n/).map((l) => l.trim()).find((l) => /^[A-Za-z0-9._/-]*\/$/.test(l) && !l.split('/').includes('..')) || '' : null;
476
+ if (rootPrefix === null) {
477
+ throw setupFailed(member,
478
+ `needs its beads set up, but its workFolder's position in its git clone cannot be read (${summarizeRaw(prefixRes.error || prefixRes.output)})`,
479
+ `make sure the member's workFolder is a git clone with git on PATH, or ${setupFix(url)}`, { step: 'tree', url });
480
+ }
481
+
482
+ log(`[beads-identity] member '${member}' ${hasDb ? 'has a beads database with no sync.remote' : 'has no beads database in its workFolder'}; setting it up from the expected beads remote ${url}.`);
483
+ if (typeof ensureVcsAuth === 'function') {
484
+ try {
485
+ await ensureVcsAuth(member);
486
+ } catch (err) {
487
+ log(`[beads-identity] could not refresh the VCS credential for member '${member}' before its beads set-up (continuing): ${err && err.message ? err.message : err}`);
488
+ }
489
+ }
490
+
491
+ const apply = async () => {
492
+ const runShell = async (build, what) => {
493
+ let cmd = '';
494
+ try {
495
+ cmd = String(build() || '');
496
+ } catch (err) {
497
+ log(`[beads-identity] could not build the command to ${what} for member '${member}': ${err && err.message ? err.message : err}`);
498
+ }
499
+ const r = cmd ? await run(cmd) : { ok: false, error: 'no command for this shell' };
500
+ if (!r.ok) {
501
+ throw setupFailed(member, `could not ${what} in its workFolder (${summarizeRaw(r.error || r.output)})`, setupFix(url), { step: 'workspace', url });
502
+ }
503
+ };
504
+ // bd refuses `config set` without a workspace config file.
505
+ await runShell(() => shell.ensureFile(BEADS_WORKSPACE_CONFIG_FILE), `create '${BEADS_WORKSPACE_CONFIG_FILE}'`);
506
+ // The durable record of the sync remote, in the untracked local layer.
507
+ await runShell(() => shell.ensureLine(BEADS_LOCAL_CONFIG_FILE, beadsLocalSyncRemoteLine(url)), `record the sync remote in '${BEADS_LOCAL_CONFIG_FILE}'`);
508
+
509
+ const setCmd = BEADS_SETUP_COMMANDS.setSyncRemote(url);
510
+ const set = await run(setCmd);
511
+ if (!set.ok) {
512
+ throw setupFailed(member, `could not set its sync.remote ('${setCmd}' -> ${summarizeRaw(set.error || set.output)})`, setupFix(url), { step: 'set-sync-remote', url });
513
+ }
514
+
515
+ if (!hasDb) {
516
+ const plan = await run(BEADS_SETUP_COMMANDS.plan);
517
+ const planObj = plan.ok ? parseFirstJson(plan.output) : null;
518
+ const planned = planObj && typeof planObj.action === 'string' ? planObj.action : '';
519
+ const plannedRemote = planObj && typeof planObj.sync_remote === 'string' ? planObj.sync_remote : '';
520
+ if (!plan.ok || planned !== 'sync' || normalizeRemoteUrl(plannedRemote) !== normalizeRemoteUrl(url)) {
521
+ const why = !plan.ok
522
+ ? summarizeRaw(plan.error || plan.output)
523
+ : "planned action '" + (planned || '(none)') + "'"
524
+ + (planObj && planObj.reason ? ' (' + summarizeRaw(planObj.reason) + ')' : '')
525
+ + (plannedRemote ? " from '" + plannedRemote + "'" : '');
526
+ throw setupFailed(member,
527
+ `has no beads database and 'bd bootstrap' would not clone it from the expected beads remote '${url}' ('${BEADS_SETUP_COMMANDS.plan}' -> ${why}); ` +
528
+ 'any other bootstrap would create a database with an unrelated history',
529
+ `make sure '${url}' holds the project's beads data and the member's VCS credential can read it, then ${setupFix(url)}`,
530
+ { step: 'plan', url, plan: planObj });
531
+ }
532
+
533
+ const boot = await run(BEADS_SETUP_COMMANDS.bootstrap);
534
+ assertNoMigration(BEADS_SETUP_COMMANDS.bootstrap, boot);
535
+ if (!boot.ok) {
536
+ throw setupFailed(member, `could not bootstrap its beads from '${url}' ('${BEADS_SETUP_COMMANDS.bootstrap}' -> ${summarizeRaw(boot.error || boot.output)})`, setupFix(url), { step: 'bootstrap', url });
537
+ }
538
+ return issued;
539
+ }
540
+
541
+ // An existing database: make sure its dolt 'origin' is the expected
542
+ // remote (adding it when absent, refusing a different one), then pull.
543
+ const list = await run(BEADS_SETUP_COMMANDS.remoteList);
544
+ const remotes = list.ok ? parseFirstJson(list.output, '[') : null;
545
+ if (!Array.isArray(remotes)) {
546
+ throw setupFailed(member, `could not list its beads dolt remotes ('${BEADS_SETUP_COMMANDS.remoteList}' -> ${summarizeRaw(list.error || list.output)})`,
547
+ setupFix(url), { step: 'remote-list', url });
548
+ }
549
+ const origin = remotes.find((r) => r && r.name === 'origin');
550
+ if (origin && normalizeRemoteUrl(String(origin.url || '')) !== normalizeRemoteUrl(url)) {
551
+ throw setupFailed(member,
552
+ `has an existing beads database whose dolt remote 'origin' is '${origin.url}', not the expected beads remote '${url}'; it is not rewired automatically`,
553
+ `check which beads project that member's database belongs to; if it is this project, run 'bd dolt remote add origin ${url}' in its workFolder, otherwise move that database aside, then rerun the sprint`,
554
+ { step: 'remote-list', url, origin: origin.url });
555
+ }
556
+ if (!origin) {
557
+ const addCmd = BEADS_SETUP_COMMANDS.addOrigin(url);
558
+ const add = await run(addCmd);
559
+ if (!add.ok) {
560
+ throw setupFailed(member, `could not add the dolt remote 'origin' ('${addCmd}' -> ${summarizeRaw(add.error || add.output)})`, setupFix(url), { step: 'remote-add', url });
561
+ }
562
+ }
563
+ // The pull goes through DoltSync (the single dolt pull/push surface):
564
+ // its retry ladder and reactive VCS-auth self-heal apply. The
565
+ // remote was configured just above, so its pre-gate is answered
566
+ // directly, and the tip fingerprint is skipped -- this first pull
567
+ // must be real.
568
+ let pulled = null;
569
+ let pullError = '';
570
+ try {
571
+ pulled = await (pullBeads || doltSyncBefore)(member, {
572
+ // DoltSync names the member on every command it issues.
573
+ command,
574
+ log,
575
+ fatal: true,
576
+ onAuthFailure,
577
+ checkSyncRemoteConfigured: async () => true,
578
+ remoteTipFingerprint: false,
579
+ });
580
+ } catch (err) {
581
+ pullError = [err && err.message, err && err.doltOutput].filter(Boolean).join('\n') || String(err);
582
+ }
583
+ if (pullError) assertNoMigration('beads pull', { output: '', error: pullError });
584
+ const pullOk = !pullError && pulled && pulled.ok !== false && !pulled.skipped && !pulled.degraded;
585
+ if (!pullOk) {
586
+ const why = pullError || `pull did not run (${summarizeRaw(JSON.stringify(pulled))})`;
587
+ throw setupFailed(member,
588
+ `has an existing beads database that cannot pull from the expected beads remote '${url}' (${summarizeRaw(why)}); ` +
589
+ 'it is most likely not a clone of that remote',
590
+ "move that member's existing beads database aside (it is never deleted automatically) so the next sprint clones it from the remote, " +
591
+ `or ${setupFix(url)}`,
592
+ { step: 'pull', url });
593
+ }
594
+ };
595
+
596
+ // Keep the set-up's work-tree changes out of every later commit on the
597
+ // member -- after success AND failure (a failed set-up may have written).
598
+ const protect = async () => {
599
+ const after = await listTree();
600
+ const changed = [...after.modified].filter((p) => !before.modified.has(p));
601
+ const added = [...after.untracked].filter((p) => !before.untracked.has(p));
602
+ for (const p of changed) {
603
+ const r = await run(BEADS_TREE_COMMANDS.restore(p));
604
+ if (!r.ok) {
605
+ throw setupFailed(member, `could not restore tracked '${p}' after its beads set-up rewrote it (${summarizeRaw(r.error || r.output)})`,
606
+ `in that member's workFolder run 'git checkout -- ${p}', then rerun the sprint`, { step: 'protect', url });
607
+ }
608
+ }
609
+ for (const p of added) {
610
+ const entry = `${rootPrefix}${p}`;
611
+ const r = await run(shell.ensureGitExcluded(entry));
612
+ if (!r.ok) {
613
+ throw setupFailed(member, `could not keep its set-up's untracked '${p}' out of commits (${summarizeRaw(r.error || r.output)})`,
614
+ `add '${entry}' to that member's git info/exclude, then rerun the sprint`, { step: 'protect', url });
615
+ }
616
+ }
617
+ if (changed.length || added.length) {
618
+ log(`[beads-identity] member '${member}': kept the beads set-up out of commits (restored: ${changed.join(', ') || 'none'}; excluded: ${added.join(', ') || 'none'}).`);
619
+ }
620
+ };
621
+
622
+ let failure = null;
623
+ try {
624
+ await apply();
625
+ } catch (err) {
626
+ failure = err;
627
+ }
628
+ try {
629
+ await protect();
630
+ } catch (err) {
631
+ if (!failure) failure = err;
632
+ else log(`[beads-identity] member '${member}': ${err && err.message ? err.message : err}`);
633
+ }
634
+ if (failure) throw failure;
635
+ return issued;
636
+ }
637
+
638
+ function assertMatches(member, expected, actual, cmp) {
639
+ if (cmp.ok) return;
640
+ const lines = cmp.mismatches.map((m) => `${m.field}: expected '${m.expected || '(unset)'}', actual '${m.actual || '(unset)'}'`);
641
+ throw new BeadsIdentityError(
642
+ `Beads identity check failed: member '${member}' resolves to a different beads database than expected ` +
643
+ `(${actual.beadsDir}) -- ${lines.join('; ')}. Refusing to mutate beads on it.`,
644
+ { reason: BEADS_IDENTITY_FAILURE_REASONS.MISMATCH, member, mismatches: cmp.mismatches, details: { actual, expected } }
645
+ );
646
+ }
647
+
648
+ /**
649
+ * The precondition itself. Probes the backlog member, then every other
650
+ * distinct member. Throws BeadsIdentityError (reason MISMATCH) before
651
+ * returning when a field that resolved on both sides differs, and (reason
652
+ * MISSING_TOOL) when a member cannot run bd at all; every other probe that
653
+ * could not resolve a field is a logged + published warning instead.
654
+ * A beads-reading member with no database (or no sync.remote while the
655
+ * expectation names one) is set up first and re-verified; failing that it
656
+ * throws BEADS_SETUP_FAILED.
657
+ *
658
+ * @param {{
659
+ * command: Function, log?: Function, publishState?: Function,
660
+ * backlogMember: string, members: string[],
661
+ * expected?: object|null, prober?: object, timeoutS?: number,
662
+ * setupMembers?: string[], ensureVcsAuth?: (member: string) => Promise<void>,
663
+ * memberShell?: (member: string) => Promise<object>,
664
+ * onAuthFailure?: Function, pullBeads?: Function,
665
+ * setupTimeoutS?: number,
666
+ * }} opts
667
+ * `setupMembers` names the beads-reading members the preflight may set
668
+ * up (omitted: every member); `ensureVcsAuth` refreshes a member's VCS
669
+ * credential before its set-up; `memberShell` resolves the member's
670
+ * OS/shell command primitives (see setupMemberBeads).
671
+ * @returns {Promise<{
672
+ * expected: object|null, expectedFrom: 'args'|'backlog'|'none',
673
+ * members: Record<string, object>, warnings: string[], setUp: string[],
674
+ * }>}
675
+ * `members[name]` is that member's probed identity record plus
676
+ * `unresolved: string[]` (the compared fields it could not report). A
677
+ * member with no beads database at all has NO entry -- only a warning.
678
+ */
679
+ export async function verifyBeadsIdentity({ command, log = () => {}, publishState, backlogMember, members, expected = null, prober, timeoutS, setupMembers, memberShell, ensureVcsAuth, onAuthFailure, pullBeads, setupTimeoutS }) {
680
+ if (typeof backlogMember !== 'string' || !backlogMember) {
681
+ throw new TypeError('verifyBeadsIdentity: backlogMember must be a non-empty string');
682
+ }
683
+ const p = prober || createBeadsIdentityProber({ command, timeoutS });
684
+ const ordered = [backlogMember, ...(Array.isArray(members) ? members : [])]
685
+ .filter((m, i, arr) => typeof m === 'string' && m && arr.indexOf(m) === i);
686
+
687
+ const warnings = [];
688
+ const warn = (text) => {
689
+ warnings.push(text);
690
+ log(`${BEADS_IDENTITY_WARNING_PREFIX}${text}`);
691
+ };
692
+ const result = { expected: null, expectedFrom: 'args', members: {}, warnings, setUp: [] };
693
+ // Members whose beads the preflight may set up; omitted = every member.
694
+ const setupSet = setupMembers == null ? null : new Set(setupMembers);
695
+
696
+ let backlogProbe = await p.probe(backlogMember);
697
+ assertBdPresent(backlogMember, backlogProbe);
698
+ const backlogHasDb = !!backlogProbe.identity.beadsDir;
699
+
700
+ let expectedIdentity = expected;
701
+ if (!expectedIdentity) {
702
+ if (backlogHasDb) {
703
+ result.expectedFrom = 'backlog';
704
+ expectedIdentity = { ...backlogProbe.identity };
705
+ log(`[beads-identity] no expected beads identity was supplied; taking the expectation from the backlog member '${backlogMember}'.`);
706
+ } else {
707
+ result.expectedFrom = 'none';
708
+ warn(noExpectationWarning(backlogMember, backlogProbe));
709
+ }
710
+ }
711
+ result.expected = expectedIdentity;
712
+
713
+ // Fields the expectation itself lacks: warned once, up front, so the
714
+ // per-member loop below never repeats them for every member.
715
+ const expectedUnresolved = new Set();
716
+ if (expectedIdentity) {
717
+ for (const field of COMPARED_FIELDS) {
718
+ if (!String(expectedIdentity[field] ?? '').trim()) {
719
+ expectedUnresolved.add(field);
720
+ warn(unresolvedExpectedWarning(field, result.expectedFrom, backlogMember));
721
+ }
722
+ }
723
+ }
724
+
725
+ // Checks one probed member: warns for what it could not report, throws
726
+ // on a genuine mismatch, records the identity (or nothing at all when
727
+ // it has no database). `compare` is false for the orchestrator when the
728
+ // expectation was taken from it.
729
+ function settle(member, probed, compare) {
730
+ if (!probed.identity.beadsDir) {
731
+ warn(noDatabaseWarning(member, probed));
732
+ return;
733
+ }
734
+ const cmp = expectedIdentity
735
+ ? compareIdentity(expectedIdentity, probed.identity, { skipUnresolved: true })
736
+ : { ok: true, mismatches: [], unresolved: [] };
737
+ const unresolved = [];
738
+ for (const field of COMPARED_FIELDS) {
739
+ if (String(probed.identity[field] ?? '').trim()) continue;
740
+ unresolved.push(field);
741
+ // The orchestrator's own gaps were already reported above as the
742
+ // expectation's gaps when the expectation came from it.
743
+ if (compare || !expectedUnresolved.has(field)) warn(unresolvedFieldWarning(member, field, probed));
744
+ }
745
+ if (compare) assertMatches(member, expectedIdentity, probed.identity, cmp);
746
+ result.members[member] = { ...probed.identity, unresolved };
747
+ log(formatBeadsIdentity(probed.identity, { label: `beads ok: ${member}` }));
748
+ }
749
+
750
+ // Sets up a beads-reading member that has no database, or a database
751
+ // with no sync.remote while the expectation names one (see
752
+ // setupMemberBeads), then re-probes it and returns the fresh probe. A
753
+ // member that needs nothing -- or is not a beads reader -- is returned
754
+ // untouched, with no command issued.
755
+ async function ensureSetUp(member, probed) {
756
+ if (setupSet && !setupSet.has(member)) return probed;
757
+ const url = String((expectedIdentity && expectedIdentity.syncRemote) || '').trim();
758
+ const hasDb = hasBeadsDatabase(probed.identity);
759
+ if (hasDb && (String(probed.identity.syncRemote || '').trim() || !url)) return probed;
760
+ // A member that already resolves to a DIFFERENT project (prefix,
761
+ // sync.remote or origin that resolved and differs) is a MISMATCH,
762
+ // exactly as before: nothing is written to it.
763
+ if (expectedIdentity) {
764
+ assertMatches(member, expectedIdentity, probed.identity, compareIdentity(expectedIdentity, probed.identity, { skipUnresolved: true }));
765
+ }
766
+ if (!url) {
767
+ const state = probed.identity.beadsDir
768
+ ? `has a beads workspace but no beads database (${probed.identity.beadsDir})`
769
+ : `reports no beads database in its workFolder ('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(probed, 'where')})`;
770
+ throw setupFailed(member,
771
+ `${state} and the sprint has no expected beads remote to set one up from`,
772
+ `launch via the supervisor so --expect-beads carries the beads sync remote (or set sync.remote on the backlog member), or ${setupFix('')}`,
773
+ { step: 'no-remote' });
774
+ }
775
+ await setupMemberBeads({ command, member, url, hasDb, memberShell, ensureVcsAuth, onAuthFailure, pullBeads, log, timeoutS: setupTimeoutS });
776
+ p.forget(member);
777
+ const again = await p.probe(member);
778
+ assertBdPresent(member, again);
779
+ const reprobeText = [...Object.values(again.raw), ...again.failures.map((f) => f.error)].join('\n');
780
+ if (hasSchemaMigrationReport(reprobeText)) {
781
+ throw setupFailed(member, `had its beads set up from '${url}', but bd reports a schema migration against that remote (${summarizeRaw(reprobeText)})`,
782
+ SCHEMA_FIX, { step: 'verify', url, cause: 'schema-migration' });
783
+ }
784
+ if (!hasBeadsDatabase(again.identity)) {
785
+ throw setupFailed(member, `still reports no beads database after its set-up from '${url}' ('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(again, 'where')})`,
786
+ setupFix(url), { step: 'verify', url });
787
+ }
788
+ if (normalizeRemoteUrl(again.identity.syncRemote) !== normalizeRemoteUrl(url)) {
789
+ throw setupFailed(member, `reports sync.remote '${again.identity.syncRemote || '(unset)'}' after its set-up, not the expected '${url}'`,
790
+ setupFix(url), { step: 'verify', url });
791
+ }
792
+ const wantPrefix = String(expectedIdentity.prefix || '').trim();
793
+ if (wantPrefix && !String(again.identity.prefix || '').trim()) {
794
+ throw setupFailed(member, `cannot report its beads prefix after its set-up from '${url}' ('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(again, 'where')})`,
795
+ setupFix(url), { step: 'verify', url });
796
+ }
797
+ result.setUp.push(member);
798
+ log(`[beads-identity] member '${member}' beads set up from ${url}; re-verifying its identity.`);
799
+ return again;
800
+ }
801
+
802
+ // The backlog member is only set up against a SUPPLIED expectation: when
803
+ // the expectation is derived from it there is nothing to set it up from.
804
+ if (expected) backlogProbe = await ensureSetUp(backlogMember, backlogProbe);
805
+ settle(backlogMember, backlogProbe, !!expected);
806
+
807
+ for (const member of ordered) {
808
+ if (member === backlogMember) continue;
809
+ let probed = await p.probe(member);
810
+ assertBdPresent(member, probed);
811
+ if (expectedIdentity || !probed.identity.beadsDir) probed = await ensureSetUp(member, probed);
812
+ settle(member, probed, !!expectedIdentity);
813
+ }
814
+
815
+ if (typeof publishState === 'function') {
816
+ publishState('beadsIdentity', {
817
+ expected: result.expected,
818
+ expectedFrom: result.expectedFrom,
819
+ members: result.members,
820
+ warnings: [...warnings],
821
+ setUp: [...result.setUp],
822
+ });
823
+ }
824
+ return result;
825
+ }