@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -1,4 +1,4 @@
1
- // apra-fleet-unw.15 -- typed error(s) local to the auto-sprint runner.
1
+ // apra-fleet-unw.15 -- typed error(s) local to the fleet-sprint runner.
2
2
  //
3
3
  // SprintPlanRejectedError is sprint-specific (it is only ever thrown by
4
4
  // runner.js's Plan phase) so it lives here rather than in
@@ -50,6 +50,15 @@ import { WorkflowError } from '@apralabs/apra-fleet-workflow';
50
50
  // UNSUPPORTED_OPERATION The requested action is not implemented for this
51
51
  // provider. A programming/config error; retrying and
52
52
  // re-authenticating are both pointless.
53
+ // MISSING_TOOL The command's binary (bd, dolt, git, ...) could not
54
+ // be found on the member at all: PowerShell's "is not
55
+ // recognized as the name of a cmdlet", cmd.exe's "is
56
+ // not recognized as an internal or external command",
57
+ // POSIX "command not found" / ": not found", exit code
58
+ // 127, spawn ENOENT. Checked BEFORE every provider
59
+ // rule (GitHub #616). Never retried and never routed
60
+ // to the credential self-heal -- re-provisioning
61
+ // cannot install a binary or fix a PATH.
53
62
  // UNKNOWN Explicitly unrecognized. Never retried, never
54
63
  // self-healed -- an unmatched stderr must surface, not
55
64
  // be guessed at.
@@ -68,6 +77,7 @@ export const VCS_FAILURE_KINDS = Object.freeze({
68
77
  EMPTY_REMOTE: 'EMPTY_REMOTE',
69
78
  REMOTE_UNREACHABLE: 'REMOTE_UNREACHABLE',
70
79
  UNSUPPORTED_OPERATION: 'UNSUPPORTED_OPERATION',
80
+ MISSING_TOOL: 'MISSING_TOOL',
71
81
  UNKNOWN: 'UNKNOWN',
72
82
  });
73
83
 
@@ -346,6 +356,25 @@ export class DoltSyncError extends WorkflowError {
346
356
  }
347
357
  }
348
358
 
359
+ /**
360
+ * Thrown by preflightBeadsHealthGate() when the backlog member's beads clone
361
+ * holds local schema migrations bd auto-applied but never published (the
362
+ * pre-dispatch D-pull fails "local changes would be stomped by merge") AND the
363
+ * publish-and-retry heal could not recover. A DoltSyncError subtype, so every
364
+ * existing DoltSyncError handler still applies; the message names the cause
365
+ * and the exact fix commands.
366
+ */
367
+ export class UnpublishedSchemaMigrationsError extends DoltSyncError {
368
+ /**
369
+ * @param {string} message
370
+ * @param {{ member?: string|null, doltOutput?: string|null, details?: object, cause?: unknown }} [opts]
371
+ */
372
+ constructor(message, opts = {}) {
373
+ super(message, { ...opts, details: { kind: 'unpublished-schema-migrations', ...opts.details } });
374
+ this.name = 'UnpublishedSchemaMigrationsError';
375
+ }
376
+ }
377
+
349
378
  /**
350
379
  * apra-fleet dolt-settle redesign (see fleet-sprint/docs/dolt-sync-redesign.md
351
380
  * Part 5) -- thrown by settleDoltConflicts() when a member has no usable,
@@ -402,7 +431,7 @@ export class DoltBinaryUnavailableError extends WorkflowError {
402
431
  // AgentDispatchError -- checked FIRST below since it can't be fooled by
403
432
  // auth-like noise in an unrelated failure's message text; the regex remains
404
433
  // as a fallback for older/mocked errors that only ever set `.message`.
405
- const NON_RETRYABLE_DISPATCH_RE = /authentication failed|not logged in|workspace not trusted|has not been trusted/i;
434
+ const NON_RETRYABLE_DISPATCH_RE = /authentication failed|failed to authenticate|oauth session expired|could not be refreshed|not logged in|workspace not trusted|has not been trusted/i;
406
435
 
407
436
  /**
408
437
  * True when a dispatch error can NEVER be fixed by retrying (auth /
@@ -422,7 +451,7 @@ export function isNonRetryableDispatchError(err) {
422
451
  // LLM credential failure (as opposed to workspace-trust, which
423
452
  // provision_llm_auth cannot fix -- that needs an operator to run `claude
424
453
  // --dangerously-skip-permissions` or trust the folder interactively).
425
- const AUTH_DISPATCH_RE = /authentication failed|not logged in/i;
454
+ const AUTH_DISPATCH_RE = /authentication failed|failed to authenticate|oauth session expired|could not be refreshed|not logged in/i;
426
455
 
427
456
  /**
428
457
  * True when a dispatch error is specifically an LLM auth/credential failure
@@ -460,6 +489,20 @@ export function isAuthDispatchError(err) {
460
489
  // remote pid and aborted the in-flight dispatch
461
490
  // (apra-fleet-3c9.1). Like the others, no test
462
491
  // verdict was ever produced.
492
+ // - 'agent_never_started' -- the member's session log never appeared at
493
+ // its authoritative path within the inactivity
494
+ // threshold; the process was killed before it
495
+ // ever ran the task.
496
+ // - 'max_total_time' -- the dispatch ran out of max_total_s (measured
497
+ // from the call, setup included) and was
498
+ // stopped. Before this reason existed the same
499
+ // kill surfaced as 'dispatch_failed'.
500
+ // - 'transport_failure' -- the fleet tool call itself failed at the
501
+ // transport (e.g. the SSH channel to the member
502
+ // could not be opened) and the server reported
503
+ // it as a bare tool error, not a classified
504
+ // execute_prompt result (agent() in the
505
+ // workflow engine). No result envelope exists.
463
506
  //
464
507
  // For an integ-test-runner dispatch, all of these mean "no test verdict was
465
508
  // ever produced" -- the run never reported pass or fail. Treating them as a
@@ -468,7 +511,7 @@ export function isAuthDispatchError(err) {
468
511
  // check on an infra fault. Callers use this classifier to (a) retry once via a
469
512
  // session resume and (b) failing that, record the cycle as INCONCLUSIVE rather
470
513
  // than a test FAIL -- exactly as the part-2 stale-evidence path already does.
471
- const INFRA_DISPATCH_REASONS = new Set(['empty_response', 'dispatch_failed', 'orphan_recovery_timeout', 'stalled', 'preflight_offline']);
514
+ const INFRA_DISPATCH_REASONS = new Set(['empty_response', 'dispatch_failed', 'orphan_recovery_timeout', 'stalled', 'agent_never_started', 'max_total_time', 'preflight_offline', 'transport_failure']);
472
515
 
473
516
  /**
474
517
  * True when a dispatch error is an INFRASTRUCTURE failure (the member CLI never
@@ -786,12 +829,12 @@ export class ConcurrentSyncBracketError extends WorkflowError {
786
829
  // closed machine-readable vocabulary. Before this existed the block threw bare
787
830
  // `Error`s whose only discriminator was their prose, so a caller could not
788
831
  // tell "there is genuinely no ready work" (an operator-facing, often benign
789
- // outcome) from "this orchestrator's bd clone cannot see the target beads at
832
+ // outcome) from "this backlog member's bd clone cannot see the target beads at
790
833
  // all" (a sync fault) or "the scope is deadlocked" (a graph fault) without
791
834
  // substring-matching a human-readable sentence.
792
835
  //
793
836
  // TARGET_NOT_VISIBLE One or more target issue ids are not present in the
794
- // orchestrator member's own bd clone AT ALL. NOT the
837
+ // backlog member's own bd clone AT ALL. NOT the
795
838
  // same as those beads being closed: they are invisible
796
839
  // here, usually because they were created/mutated on a
797
840
  // different clone that was never dolt-pushed to the
@@ -819,6 +862,10 @@ export const PRE_SPRINT_REFUSAL_REASONS = Object.freeze({
819
862
  NOTHING_TO_DO: 'NOTHING_TO_DO',
820
863
  CYCLE_REPAIR_FAILED: 'CYCLE_REPAIR_FAILED',
821
864
  DEADLOCKED: 'DEADLOCKED',
865
+ // GitHub #717: a goal-priority bead is blocked only by verify-routed beads
866
+ // and the Integration Test phase cannot run (no integ-test-playbook.md or
867
+ // no deploy.md), so it can never become ready.
868
+ VERIFY_BLOCKED: 'VERIFY_BLOCKED',
822
869
  });
823
870
 
824
871
  /**
@@ -838,7 +885,7 @@ export const PRE_SPRINT_REFUSAL_REASONS = Object.freeze({
838
885
  * @property {string} reason - one of PRE_SPRINT_REFUSAL_REASONS
839
886
  * @property {string|null} scope - the sprint filter the refusal was raised for
840
887
  * @property {string[]} [invisibleTargets] - TARGET_NOT_VISIBLE: the ids missing
841
- * from the orchestrator member's clone
888
+ * from the backlog member's clone
842
889
  * @property {Array<{blockedIssue: string, blockedBy: string}>} [cyclePairs] -
843
890
  * CYCLE_REPAIR_FAILED: the parent-child + blocks edge pairs whose removal
844
891
  * was attempted
@@ -880,16 +927,29 @@ export class PreSprintValidationError extends WorkflowError {
880
927
 
881
928
  export const BEADS_IDENTITY_FAILURE_REASONS = Object.freeze({
882
929
  MISMATCH: 'MISMATCH',
930
+ // The member cannot run bd at all (not installed / not on PATH): every
931
+ // bd a role or the engine runs there would fail mid-sprint, so refuse up
932
+ // front.
933
+ MISSING_TOOL: 'MISSING_TOOL',
934
+ // A beads-reading member had no usable beads database (or no
935
+ // sync.remote) and the preflight could not set one up from the sprint's
936
+ // expected beads remote -- dispatching would hand the role a database
937
+ // that does not hold the sprint's issues, so refuse up front.
938
+ BEADS_SETUP_FAILED: 'BEADS_SETUP_FAILED',
883
939
  });
884
940
 
885
941
  /**
886
942
  * Thrown by verifyBeadsIdentity (beads-identity-check.mjs) BEFORE any
887
943
  * mutating bd command when a member's probed identity (`bd where` / `bd
888
944
  * config get sync.remote` / `git remote get-url origin`) DIFFERS from the
889
- * expected one (the supervisor's expectation, or the orchestrator member's
890
- * own identity) on a field that resolved on both sides. A probe that fails
891
- * or cannot be parsed is a logged warning, never this error: only a proven
892
- * mismatch is a data-corruption risk worth refusing the sprint for.
945
+ * expected one (the supervisor's expectation, or the backlog member's
946
+ * own identity) on a field that resolved on both sides (reason MISMATCH), or
947
+ * when a member cannot run bd at all -- a bd probe failed because bd is not
948
+ * installed or not on PATH (reason MISSING_TOOL), so every later bd command
949
+ * there would fail too, or (reason BEADS_SETUP_FAILED) when a beads-reading
950
+ * member had no database / no sync.remote and setting it up from the
951
+ * expected remote failed. Any other probe that fails or cannot be parsed is a
952
+ * logged warning, never this error.
893
953
  *
894
954
  * A WorkflowError so main()'s terminal record names the reason, but
895
955
  * deliberately NOT a typed abort: nothing has been dispatched or mutated, so
@@ -922,3 +982,142 @@ export class BeadsIdentityError extends WorkflowError {
922
982
  if (mismatches) this.mismatches = mismatches;
923
983
  }
924
984
  }
985
+
986
+ // ---------------------------------------------------------------------------
987
+ // Member permission config (the provider's composed per-folder config)
988
+ // ---------------------------------------------------------------------------
989
+
990
+ /**
991
+ * Thrown by the member permission-config preflight
992
+ * (member-provisioning.mjs createPermissionConfigPreflight) BEFORE any
993
+ * dispatch when a dispatch member's composed per-folder permission config
994
+ * (its provider's permissionConfigPaths(), as reported by member_detail) is
995
+ * missing from its work folder -- a re-clone, `git clean -xdf` or fresh
996
+ * worktree drops it -- and re-composing it with compose_permissions failed or
997
+ * did not bring it back, or it could not be probed at all. Dispatching would
998
+ * hand the role a session whose tool calls (e.g. bd) are refused as
999
+ * "requires approval".
1000
+ *
1001
+ * Like BeadsIdentityError, a WorkflowError but deliberately NOT a typed
1002
+ * abort: nothing has been dispatched, so there is no partial work to push.
1003
+ *
1004
+ * @property {string} member - the member whose config is missing
1005
+ * @property {string[]} files - the missing (or unprobeable) config file(s)
1006
+ * @property {string} role - the compose_permissions role the fix names
1007
+ */
1008
+ export class MemberPermissionConfigError extends WorkflowError {
1009
+ /**
1010
+ * @param {string} message
1011
+ * @param {{ member: string, files?: string[], role?: string, details?: object, cause?: unknown }} opts
1012
+ */
1013
+ constructor(message, opts = {}) {
1014
+ const { member, files = [], role, details, cause } = opts;
1015
+ super(message, {
1016
+ code: 'MEMBER_PERMISSION_CONFIG',
1017
+ details: { member, files, role, ...details },
1018
+ cause,
1019
+ });
1020
+ this.member = member;
1021
+ this.files = files;
1022
+ this.role = role;
1023
+ }
1024
+ }
1025
+
1026
+ // ---------------------------------------------------------------------------
1027
+ // Agent permission refusals during a dispatch (reason 'permission_denied')
1028
+ // ---------------------------------------------------------------------------
1029
+ //
1030
+ // execute_prompt reports a dispatch whose member CLI refused tool calls for
1031
+ // lack of a grant as a structured `reason: 'permission_denied'` with a
1032
+ // `permissionDenied` block ({ actions, denials, suggestedGrants, hint,
1033
+ // signals }); the workflow layer forwards both onto AgentDispatchError.details.
1034
+ // It is a MISSING-PERMISSION failure, healed by compose_permissions -- never a
1035
+ // role outcome. In particular the refusal text must never be fed to a caller
1036
+ // as a plan-review/review verdict. Keyed on the structured reason only, like
1037
+ // isUsageLimitDispatchError: never on the provider's prose.
1038
+ export const PERMISSION_DENIED_DISPATCH_REASON = 'permission_denied';
1039
+
1040
+ /**
1041
+ * True when a dispatch error is an agent permission refusal.
1042
+ * @param {unknown} err
1043
+ * @returns {boolean}
1044
+ */
1045
+ export function isPermissionDeniedDispatchError(err) {
1046
+ return err?.details?.reason === PERMISSION_DENIED_DISPATCH_REASON;
1047
+ }
1048
+
1049
+ /**
1050
+ * The permissionDenied block carried on a permission-refusal dispatch error,
1051
+ * normalised to `{ actions: string[], denials: {action, target?,
1052
+ * suggestedGrants?}[], suggestedGrants: string[], hint: string,
1053
+ * permissionMode?: string, healable?: boolean }`, or null when the error
1054
+ * carries none. `healable: false` means the session's permission mode (Claude
1055
+ * auto/bypass) makes the refusal a classifier or deny-rule decision that no
1056
+ * grant may ever override.
1057
+ * @param {unknown} err
1058
+ * @returns {{actions: string[], denials: Array<{action: string, target?: string, suggestedGrants?: string[]}>, suggestedGrants: string[], hint: string, permissionMode?: string, healable?: boolean}|null}
1059
+ */
1060
+ export function permissionDeniedOf(err) {
1061
+ const d = err?.details?.permissionDenied;
1062
+ if (!d || typeof d !== 'object') return null;
1063
+ const strings = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : []);
1064
+ const denials = Array.isArray(d.denials)
1065
+ ? d.denials.filter((x) => x && typeof x.action === 'string')
1066
+ .map((x) => ({
1067
+ action: x.action,
1068
+ ...(typeof x.target === 'string' ? { target: x.target } : {}),
1069
+ ...(Array.isArray(x.suggestedGrants) ? { suggestedGrants: strings(x.suggestedGrants) } : {}),
1070
+ }))
1071
+ : [];
1072
+ return {
1073
+ actions: strings(d.actions),
1074
+ denials,
1075
+ suggestedGrants: strings(d.suggestedGrants),
1076
+ hint: typeof d.hint === 'string' ? d.hint : '',
1077
+ ...(typeof d.permissionMode === 'string' ? { permissionMode: d.permissionMode } : {}),
1078
+ ...(typeof d.healable === 'boolean' ? { healable: d.healable } : {}),
1079
+ };
1080
+ }
1081
+
1082
+ /**
1083
+ * Thrown by the dispatch engine (dispatch-role.mjs) when a role's dispatch
1084
+ * was refused tool calls and the progressive heal (createPermissionDenialHeal:
1085
+ * grant within the member's composed policy, retry, repeat while each heal
1086
+ * adds a new grant) can make no further progress. Ends the sprint naming the
1087
+ * member, the denied actions and the fix; no plan-review or review round is
1088
+ * ever charged for it.
1089
+ *
1090
+ * A WorkflowError (so the run records a terminal reason) but deliberately
1091
+ * NOT a typed abort, like MemberPermissionConfigError: the fix is a member
1092
+ * grant, after which the sprint is simply re-run.
1093
+ *
1094
+ * @property {string} member - the member whose tool calls were refused
1095
+ * @property {string|null} role - the sprint role whose dispatch was refused
1096
+ * @property {string[]} actions - the denied actions (e.g. 'Bash "bd show x"')
1097
+ * @property {string[]} suggestedGrants - compose_permissions grants that would allow them
1098
+ * @property {string[]} rejectedGrants - suggested grants outside the role policy, never auto-added
1099
+ * @property {string} step - 'heal' (compose_permissions failed or no heal is wired),
1100
+ * 'not_healable' (auto/bypass-mode refusal: classifier or deny rule, never granted),
1101
+ * 'no_progress' (refused again after its grant, outside policy, NEVER_AUTO_GRANT, or no
1102
+ * grant maps to the call) or 'cap' (heal limit per member per sprint or per ladder reached)
1103
+ */
1104
+ export class MemberPermissionDeniedError extends WorkflowError {
1105
+ /**
1106
+ * @param {string} message
1107
+ * @param {{ member: string, role?: string|null, actions?: string[], suggestedGrants?: string[], rejectedGrants?: string[], step: string, details?: object, cause?: unknown }} opts
1108
+ */
1109
+ constructor(message, opts = {}) {
1110
+ const { member, role = null, actions = [], suggestedGrants = [], rejectedGrants = [], step, details, cause } = opts;
1111
+ super(message, {
1112
+ code: 'MEMBER_PERMISSION_DENIED',
1113
+ details: { member, role, actions, suggestedGrants, rejectedGrants, step, ...details },
1114
+ cause,
1115
+ });
1116
+ this.member = member;
1117
+ this.role = role;
1118
+ this.actions = actions;
1119
+ this.suggestedGrants = suggestedGrants;
1120
+ this.rejectedGrants = rejectedGrants;
1121
+ this.step = step;
1122
+ }
1123
+ }
@@ -16,10 +16,10 @@ import { explicitIdCreateModulePaths, EXPLICIT_ID_CREATE_EXEMPT } from './guarde
16
16
  // command (`bd create`, of ANY shape) unless it lives in beads-children.mjs
17
17
  // -- the single module that pairs an explicit-id create with the
18
18
  // probe-and-refuse seam (assertChildIdFree(), called from
19
- // createChildBeadWithAllocatedId) that guards against `bd create`'s silent
20
- // overwrite-on-collision behavior (apra-fleet-btj9). A second, unguarded
21
- // bead-creation site anywhere else in this directory is exactly how that
22
- // overwrite bug returns, so this is a mechanical scan -- same shape as the
19
+ // createChildBeadWithAllocatedId) that refuses an occupied id and keeps it
20
+ // out of the allocator's pool (apra-fleet-btj9). A second, unguarded
21
+ // bead-creation site anywhere else in this directory would bypass that
22
+ // id discipline, so this is a mechanical scan -- same shape as the
23
23
  // sibling guards -- rather than a call-graph proof that assertChildIdFree()
24
24
  // actually ran first.
25
25
  //
@@ -490,7 +490,23 @@ export async function withGitSync(ctx, member, pushCode, dispatchFn, { pushBeads
490
490
  export function createGitSync(deps = {}) {
491
491
  const brackets = deps.brackets ?? createSyncBrackets({ setPauseGuard: deps.setPauseGuard });
492
492
  const ctx = { ...deps, brackets };
493
- const { command, log, branch, doltPushMutex, sprintId, onAuthFailure, resolveMemberProvider, syncMemberAfter } = ctx;
493
+ const { command, log, branch, doltPushMutex, sprintId, onAuthFailure, resolveMemberProvider, syncMemberBefore, syncMemberAfter } = ctx;
494
+ /**
495
+ * A standalone bracketed G-push through runner.js's syncMemberAfter().
496
+ * This is what closes the Publish-PR git-push hole: that site used to
497
+ * call syncMemberAfter() bare, outside any bracket.
498
+ */
499
+ const pushGitAfter = (memberName, options = {}) => brackets.withOpenSyncBracket(
500
+ () => syncMemberAfter(memberName, { command, log, branch, onAuthFailure, resolveMemberProvider, ...options }),
501
+ );
502
+ // The beads-only helpers below (backlog member D-pull/D-push) bypass
503
+ // withGitSync, so they refresh the member's VCS credential themselves,
504
+ // through the same ensureVcsAuthFresh (same freshness cache) dispatch
505
+ // members use. Optional in a hand-built ctx; never throws.
506
+ const ensureBeadsMemberAuth = async (memberName) => {
507
+ if (typeof ctx.ensureVcsAuthFresh !== 'function') return;
508
+ try { await ctx.ensureVcsAuthFresh(memberName); } catch (err) { log(`[Sync] preflight: ensureVcsAuthFresh failed for beads member '${memberName}' (continuing): ${err && err.message}`); }
509
+ };
494
510
  return {
495
511
  brackets,
496
512
  /** Current number of open sync brackets -- read-only observability. */
@@ -511,14 +527,20 @@ export function createGitSync(deps = {}) {
511
527
  * passed through verbatim.
512
528
  */
513
529
  syncBeadsBefore: (memberName, options = {}) => brackets.withOpenSyncBracket(
514
- () => DoltSync.syncBefore(memberName, { command, log, ...options }),
530
+ async () => {
531
+ await ensureBeadsMemberAuth(memberName);
532
+ return DoltSync.syncBefore(memberName, { command, log, onAuthFailure, mutex: doltPushMutex, sprintId, ...options });
533
+ },
515
534
  ),
516
535
  /**
517
536
  * A standalone bracketed beads D-push. `command`/`log` and the
518
537
  * cross-member D-push mutex default to the bound sprint state.
519
538
  */
520
539
  syncBeadsAfter: (memberName, options = {}) => brackets.withOpenSyncBracket(
521
- () => DoltSync.syncAfter(memberName, { command, log, mutex: doltPushMutex, sprintId, ...options }),
540
+ async () => {
541
+ await ensureBeadsMemberAuth(memberName);
542
+ return DoltSync.syncAfter(memberName, { command, log, mutex: doltPushMutex, sprintId, onAuthFailure, ...options });
543
+ },
522
544
  ),
523
545
  /**
524
546
  * A standalone bracketed beads D-push, routed through
@@ -542,15 +564,184 @@ export function createGitSync(deps = {}) {
542
564
  * to opt back into the old throwing behavior at this call site.
543
565
  */
544
566
  pushBeadsAfter: (memberName, options = {}) => brackets.withOpenSyncBracket(
545
- () => DoltSync.syncAfter(memberName, { command, log, mutex: doltPushMutex, sprintId, ...options }),
567
+ async () => {
568
+ await ensureBeadsMemberAuth(memberName);
569
+ return DoltSync.syncAfter(memberName, { command, log, mutex: doltPushMutex, sprintId, onAuthFailure, ...options });
570
+ },
546
571
  ),
547
572
  /**
548
- * A standalone bracketed G-push through runner.js's syncMemberAfter().
549
- * This is what closes the Publish-PR git-push hole: that site used to
550
- * call syncMemberAfter() bare, outside any bracket.
573
+ * A standalone bracketed G-pull through runner.js's syncMemberBefore()
574
+ * -- the same pull every dispatch bracket opens with, for a caller
575
+ * that must freshen a member's checkout outside a dispatch (the KB
576
+ * write queue G-pulls the kb_maintainer before each batch).
551
577
  */
552
- pushGitAfter: (memberName, options = {}) => brackets.withOpenSyncBracket(
553
- () => syncMemberAfter(memberName, { command, log, branch, onAuthFailure, resolveMemberProvider, ...options }),
578
+ pullGitBefore: (memberName, options = {}) => brackets.withOpenSyncBracket(
579
+ () => syncMemberBefore(memberName, { command, log, branch, onAuthFailure, resolveMemberProvider, ...options }),
554
580
  ),
581
+ /** The standalone bracketed G-push (see pushGitAfter above). */
582
+ pushGitAfter,
583
+ /**
584
+ * The KB bible commit's G-push on the repository's kb_maintainer
585
+ * (kb.mjs commitRound): the same bracketed syncMemberAfter() as
586
+ * pushGitAfter(), under its own name so the sprint branch's
587
+ * Publish-PR push stays the only pushGitAfter() caller.
588
+ */
589
+ pushBibleCommit: (memberName) => pushGitAfter(memberName),
590
+ /**
591
+ * A bracketed `git rebase --abort` on a member, for a caller retrying
592
+ * after a rejected G-push (the KB bible commit). There is no portable
593
+ * probe for "a rebase is in progress" across member shells, so the
594
+ * abort itself is the probe: it fails harmlessly (failSoft) when no
595
+ * rebase is in progress. Resolves true when a rebase was aborted.
596
+ */
597
+ abortRebase: (memberName) => brackets.withOpenSyncBracket(async () => {
598
+ const res = await command('git rebase --abort', {
599
+ member_name: memberName, silent: true, failSoft: true,
600
+ label: `rebase --abort before the bible-commit retry on '${memberName}'`,
601
+ });
602
+ const aborted = !!(res && res.ok);
603
+ if (aborted) log(`[Sync] aborted an in-progress rebase on member '${memberName}' before retrying its bible commit.`);
604
+ return aborted;
605
+ }),
606
+ /**
607
+ * Whether a hard reset onto the remote tip would discard ONLY a local
608
+ * bible commit on this member's checkout: every local-only commit
609
+ * (origin/<branch>..HEAD) touches nothing but `bibleFile` and the
610
+ * working tree has no uncommitted tracked change. The kb_maintainer is
611
+ * usually also a doer, so unrelated unpushed work or edits must never
612
+ * be thrown away by the bible-commit retry. Git strings are built in JS
613
+ * (no shell expansion) so a PowerShell member works. Resolves
614
+ * { safe: true } or { safe: false, reason }; any git failure is unsafe.
615
+ */
616
+ canResetBibleCheckout: async (memberName, bibleFile) => {
617
+ const remoteTip = `origin/${branch}`;
618
+ const status = await command('git status --porcelain --untracked-files=no', {
619
+ member_name: memberName, silent: true, failSoft: true,
620
+ label: `check the working tree before the bible-commit reset on '${memberName}'`,
621
+ });
622
+ if (!status || !status.ok) return { safe: false, reason: 'could not read the working tree status' };
623
+ if (typeof status.output === 'string' && status.output.trim().length > 0) {
624
+ return { safe: false, reason: 'the working tree has uncommitted changes' };
625
+ }
626
+ const log_ = await command(`git log -m --name-only --pretty=format: ${remoteTip}..HEAD`, {
627
+ member_name: memberName, silent: true, failSoft: true,
628
+ label: `list local-only commits before the bible-commit reset on '${memberName}'`,
629
+ });
630
+ if (!log_ || !log_.ok) return { safe: false, reason: `could not list local-only commits against ${remoteTip}` };
631
+ const files = String(log_.output || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
632
+ const other = files.filter((f) => f !== bibleFile);
633
+ if (other.length > 0) return { safe: false, reason: `unpushed local commits touch ${[...new Set(other)].slice(0, 3).join(', ')}` };
634
+ const count = await command(`git rev-list --count ${remoteTip}..HEAD`, {
635
+ member_name: memberName, silent: true, failSoft: true,
636
+ label: `count local-only commits before the bible-commit reset on '${memberName}'`,
637
+ });
638
+ const n = count && count.ok ? parseInt(String(count.output || '').trim(), 10) : NaN;
639
+ if (!Number.isFinite(n)) return { safe: false, reason: 'could not count local-only commits' };
640
+ if (n > 0 && files.length === 0) return { safe: false, reason: 'unpushed local commits touch no recognizable file' };
641
+ return { safe: true };
642
+ },
643
+ /**
644
+ * Whether every local-only commit (origin/<branch>..HEAD) on the member's
645
+ * checkout touches nothing but `bibleFile`, i.e. a push would publish
646
+ * only bible commit(s). The kb_maintainer is usually also a doer, so a
647
+ * bible push must never carry an unpushed doer commit along. Resolves
648
+ * { onlyBible: true } or { onlyBible: false, reason }; any git failure
649
+ * is { onlyBible: false }. Git strings are built in JS (no shell
650
+ * expansion) so a PowerShell member works.
651
+ */
652
+ unpushedOnlyBible: async (memberName, bibleFile) => {
653
+ if (typeof branch !== 'string' || branch.length === 0) return { onlyBible: false, reason: 'no sprint branch is bound' };
654
+ const remoteTip = `origin/${branch}`;
655
+ const local = await command(`git log -m --name-only --pretty=format: ${remoteTip}..HEAD`, {
656
+ member_name: memberName, silent: true, failSoft: true,
657
+ label: `list local-only commits before the bible push on '${memberName}'`,
658
+ });
659
+ if (!local || !local.ok) return { onlyBible: false, reason: `could not list local-only commits against ${remoteTip}` };
660
+ const files = String(local.output || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
661
+ const other = files.filter((f) => f !== bibleFile);
662
+ if (other.length > 0) return { onlyBible: false, reason: `unpushed non-bible commits touch ${[...new Set(other)].slice(0, 3).join(', ')}` };
663
+ const count = await command(`git rev-list --count ${remoteTip}..HEAD`, {
664
+ member_name: memberName, silent: true, failSoft: true,
665
+ label: `count local-only commits before the bible push on '${memberName}'`,
666
+ });
667
+ const n = count && count.ok ? parseInt(String(count.output || '').trim(), 10) : NaN;
668
+ if (!Number.isFinite(n)) return { onlyBible: false, reason: 'could not count local-only commits' };
669
+ if (n > 0 && files.length === 0) return { onlyBible: false, reason: 'unpushed local commits touch no recognizable file' };
670
+ return { onlyBible: true };
671
+ },
672
+ /**
673
+ * Whether origin's sprint branch holds the member checkout's bible --
674
+ * asked when kb_bible_commit committed nothing, so a bible commit an
675
+ * earlier round could not push is not mistaken for a published one.
676
+ * Resolves { unpushed: true } when a local-only commit
677
+ * (origin/<branch>..HEAD) touches `bibleFile`, { unpushed: false }
678
+ * when no uncommitted bible change exists and the bible at HEAD equals
679
+ * origin's, and { unpushed: null, reason } otherwise (an uncommitted
680
+ * bible change, a HEAD whose bible differs from origin's with no
681
+ * local-only commit holding it, any git failure). Git strings are
682
+ * built in JS (no shell expansion) so a PowerShell member works.
683
+ */
684
+ bibleUnpushed: async (memberName, bibleFile) => {
685
+ if (typeof branch !== 'string' || branch.length === 0) return { unpushed: null, reason: 'no sprint branch is bound' };
686
+ const remoteTip = `origin/${branch}`;
687
+ const status = await command(`git status --porcelain --untracked-files=all -- ${bibleFile}`, {
688
+ member_name: memberName, silent: true, failSoft: true,
689
+ label: `check for an uncommitted bible change on '${memberName}'`,
690
+ });
691
+ if (!status || !status.ok) return { unpushed: null, reason: 'could not read the working tree status of the bible' };
692
+ if (typeof status.output === 'string' && status.output.trim().length > 0) {
693
+ return { unpushed: null, reason: `${bibleFile} has an uncommitted change that no commit holds` };
694
+ }
695
+ const local = await command(`git log -m --name-only --pretty=format: ${remoteTip}..HEAD`, {
696
+ member_name: memberName, silent: true, failSoft: true,
697
+ label: `list local-only commits for the bible publication check on '${memberName}'`,
698
+ });
699
+ if (!local || !local.ok) return { unpushed: null, reason: `could not list local-only commits against ${remoteTip}` };
700
+ const files = String(local.output || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
701
+ if (files.includes(bibleFile)) return { unpushed: true };
702
+ const diff = await command(`git diff --name-only ${remoteTip} HEAD -- ${bibleFile}`, {
703
+ member_name: memberName, silent: true, failSoft: true,
704
+ label: `compare the bible with ${remoteTip} on '${memberName}'`,
705
+ });
706
+ if (!diff || !diff.ok) return { unpushed: null, reason: `could not compare ${bibleFile} with ${remoteTip}` };
707
+ if (typeof diff.output === 'string' && diff.output.trim().length > 0) {
708
+ return { unpushed: null, reason: `${bibleFile} at HEAD differs from ${remoteTip} and no local-only commit holds it` };
709
+ }
710
+ return { unpushed: false };
711
+ },
712
+ /**
713
+ * The branch a member currently has checked out, next to the sprint
714
+ * branch it is expected to be on -- the KB bible commit's guard, so
715
+ * no G-pull, reset, commit or push ever runs on a maintainer that sits
716
+ * on some other branch. The git string is built in JS (no shell
717
+ * expansion) so a PowerShell member works. `branch` is null when it
718
+ * cannot be read; a detached HEAD reads as 'HEAD'.
719
+ * Resolves { branch: string|null, sprintBranch: string|null }.
720
+ */
721
+ checkedOutBranch: async (memberName) => {
722
+ const res = await command('git rev-parse --abbrev-ref HEAD', {
723
+ member_name: memberName, silent: true, failSoft: true,
724
+ label: `read the checked-out branch before the bible commit on '${memberName}'`,
725
+ });
726
+ const found = res && res.ok && typeof res.output === 'string' ? res.output.trim().split(/\r?\n/).pop().trim() : '';
727
+ return { branch: found || null, sprintBranch: typeof branch === 'string' && branch ? branch : null };
728
+ },
729
+ /**
730
+ * The base a KB bible commit records as provenance, resolved on the
731
+ * member's checkout: the sprint's TARGET BASE branch, and the commit
732
+ * the sprint branch forked from it (`git merge-base HEAD
733
+ * origin/<baseBranch>`) -- the base the confirmed entries were
734
+ * verified against. Resolves null when either cannot be determined.
735
+ */
736
+ resolveBibleBase: async (memberName) => {
737
+ const baseBranch = ctx.baseBranch;
738
+ if (typeof baseBranch !== 'string' || baseBranch.length === 0) return null;
739
+ const res = await command(`git merge-base HEAD origin/${baseBranch}`, {
740
+ member_name: memberName, silent: true, failSoft: true,
741
+ label: `resolve the base commit for the bible commit on '${memberName}'`,
742
+ });
743
+ const sha = res && res.ok && typeof res.output === 'string' ? res.output.trim().split(/\s+/)[0] : '';
744
+ return /^[0-9a-f]{7,64}$/i.test(sha) ? { baseBranch, baseCommit: sha } : null;
745
+ },
555
746
  };
556
747
  }