@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  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 +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  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 +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -47,7 +47,7 @@
47
47
  // =============================================================================
48
48
 
49
49
  import { GitDivergedError, GitSyncError } from './errors.mjs';
50
- import { runGitStep, resolveGitProviderForClassification } from './git-topology.mjs';
50
+ import { runGitStep, resolveGitProviderForClassification, isMissingRemoteRefError } from './git-topology.mjs';
51
51
  import { parseUnmergedPaths, detectAndAbortRebaseConflict, dispatchConflictResolutionAgent } from './conflict-ladder.mjs';
52
52
  import { DoltSync } from './dolt-sync.mjs';
53
53
  import { buildSettleCallback } from './dolt-settle.mjs';
@@ -83,22 +83,10 @@ import { resolveSettleShell } from './runner.js';
83
83
  // each dispatch. `command` is dependency-injected so unit tests can drive these
84
84
  // helpers with a mock command() and no live fleet.
85
85
 
86
- /**
87
- * True when `error` is git's exact "the named ref does not exist on the
88
- * remote" message (`fatal: couldn't find remote ref <branch>`), as opposed to
89
- * any other fetch/pull/rebase failure. This is the ONE place that text is
90
- * matched (apra-fleet-ta3.3): syncMemberBefore's pre-dispatch fetch and
91
- * syncMemberAfter's post-push pull-rebase both hit this exact message for the
92
- * identical underlying reason -- a brand-new local branch that has never been
93
- * pushed to `remote` yet, so there is nothing there to fetch/rebase against --
94
- * and both treat it as a benign no-op / retry-directly signal via this shared
95
- * predicate rather than each carrying its own copy of the regex.
96
- * @param {string} error - the raw git stderr/stdout of a failed command
97
- * @returns {boolean}
98
- */
99
- export function isMissingRemoteRefError(error) {
100
- return /couldn't find remote ref/i.test(error || '');
101
- }
86
+ // isMissingRemoteRefError() moved to ./git-topology.mjs so runGitStep can skip
87
+ // the auth self-heal for a missing remote ref (apra-fleet-ta3); re-exported
88
+ // here for existing importers.
89
+ export { isMissingRemoteRefError };
102
90
 
103
91
  /**
104
92
  * G-pull: bring `member` up to the shared branch tip before it does any work --
@@ -121,7 +109,9 @@ export function isMissingRemoteRefError(error) {
121
109
  * re-committing over) a divergence its own prior attempt left behind. It must
122
110
  * only be set on a retry that may have mutated state (withGitSync's
123
111
  * resumeOntoRemoteTip); omitting it keeps the ff-only-merge behaviour for every
124
- * first attempt.
112
+ * first attempt. Before the reset, any unpublished local commits and
113
+ * uncommitted tracked changes are pinned on a local fleet-salvage/ side ref
114
+ * (see salvageBeforeReset); if that fails, no reset happens.
125
115
  *
126
116
  * apra-fleet-417.7: an optional injected `resolveMemberProvider` (see
127
117
  * createMemberVcsProviderResolver) is resolved ONCE at the top of this call
@@ -171,25 +161,33 @@ export async function syncMemberBefore(member, opts = {}) {
171
161
  // because every subsequent push/merge fails non-fast-forward. Hard-resetting
172
162
  // onto the freshly fetched remote tip makes the retry resume ON TOP of
173
163
  // already-published work instead of re-committing it. Only the code checkout
174
- // is touched (beads live in a separate Dolt clone); a local commit that was
175
- // never published is intentionally dropped and simply re-done by the retry,
176
- // which is what prevents the divergent duplicate commit. A concrete branch
177
- // is required to name a remote tip; without one this falls through to the
164
+ // is touched (beads live in a separate Dolt clone). A concrete branch is
165
+ // required to name a remote tip; without one this falls through to the
178
166
  // ff-only merge below.
167
+ //
168
+ // SALVAGE FIRST (GitHub #716). The reset must never be the only copy of
169
+ // the prior attempt's work: a stall kill or a transport drop can leave real
170
+ // unpublished commits and uncommitted tracked edits behind. Before every
171
+ // reset, salvageBeforeReset() pins them on a LOCAL side ref
172
+ // (fleet-salvage/<branch-slug>/<short-sha>) without moving the sprint
173
+ // branch, staging anything, or touching untracked files. If the salvage
174
+ // cannot be completed the reset does not run (fail closed).
179
175
  if (resetToRemoteTip && branch) {
180
176
  const resetTarget = `${remote}/${branch}`;
177
+ const salvage = await salvageBeforeReset(member, { command, log, remote, branch });
181
178
  const reset = await runGitStep({
182
179
  command, member, cmd: `git reset --hard ${resetTarget}`,
183
180
  label: `G-pull reset-to-remote-tip for '${member}'`, log, maxTransientRetries, onAuthFailure, provider,
184
181
  });
185
182
  if (!reset.ok) {
183
+ const salvageNote = salvage ? ` The prior work is also saved on local ref '${salvage.ref}'.` : '';
186
184
  throw new GitSyncError(
187
- `[Sync] G-pull reset-to-remote-tip failed for member '${member}': ${reset.error}`,
188
- { member, gitOutput: reset.error },
185
+ `[Sync] G-pull reset-to-remote-tip failed for member '${member}'; the local branch was left at its prior tip.${salvageNote} ${reset.error}`,
186
+ { member, gitOutput: reset.error, details: salvage ? { salvageRef: salvage.ref } : undefined },
189
187
  );
190
188
  }
191
189
  log(`[Sync] G-pull for member '${member}': hard-reset local branch onto '${resetTarget}' so a retried dispatch resumes on the published tip instead of re-committing.`);
192
- return { ok: true, member };
190
+ return salvage ? { ok: true, member, salvageRef: salvage.ref } : { ok: true, member };
193
191
  }
194
192
 
195
193
  const mergeCmd = branch ? `git merge --ff-only ${remote}/${branch}` : 'git merge --ff-only';
@@ -213,6 +211,212 @@ export async function syncMemberBefore(member, opts = {}) {
213
211
  return { ok: true, member };
214
212
  }
215
213
 
214
+ // G-push landed check. `git push` exiting 0 is not proof the shared branch
215
+ // now carries this member's work (a push reported as success by a transport
216
+ // that never delivered it was read as landed). After a push reports success,
217
+ // confirm the remote branch CONTAINS the local HEAD: equal tips, or -- when
218
+ // another writer pushed on top of ours in the meantime -- a remote tip that
219
+ // has our HEAD as an ancestor. Only positive evidence that the branch lacks
220
+ // our HEAD fails the push; an inconclusive read (unparseable output, a failed
221
+ // fetch, no branch name) keeps the pre-check behavior and is logged.
222
+
223
+ /** Refs/remotes safe to place in a command string on any member shell. */
224
+ const SAFE_GIT_NAME_RE = /^[A-Za-z0-9._/-]+$/;
225
+ const GIT_SHA_RE = /^[0-9a-f]{40,64}$/i;
226
+
227
+ function outputOf(res) {
228
+ if (!res || res.ok === false) return null;
229
+ return String((typeof res === 'object' ? res.output : res) ?? '');
230
+ }
231
+
232
+ // ---------------------------------------------------------------------------
233
+ // Retry salvage (GitHub #716)
234
+ // ---------------------------------------------------------------------------
235
+ //
236
+ // syncMemberBefore's resetToRemoteTip mode runs `git reset --hard` on a member
237
+ // checkout whose prior attempt may have been killed mid-work. That reset must
238
+ // never destroy work that exists nowhere else, so salvageBeforeReset() first
239
+ // pins it on a LOCAL side ref:
240
+ //
241
+ // - `git rev-parse HEAD <remote>/<branch>` and `git rev-list --count` decide
242
+ // whether the local branch has commits the remote tip lacks;
243
+ // - `git stash create` snapshots uncommitted TRACKED changes as a dangling
244
+ // commit WITHOUT touching the index, the work tree or the stash reflog
245
+ // (untracked files -- .env, build output, provider permission files the
246
+ // fleet writes into the work folder -- are excluded by design and are not
247
+ // deleted by `reset --hard` either). The stash commit's first parent is
248
+ // HEAD, so one ref on it reaches both the WIP and every local commit;
249
+ // - `git branch -f fleet-salvage/<branch-slug>/<short-sha> <sha>` creates
250
+ // the ref. The sprint branch itself is never moved, nothing is staged and
251
+ // nothing is committed on it, and the ref is never pushed (every push in
252
+ // this module names the sprint branch explicitly).
253
+ //
254
+ // Every command is a plain token list: no shell expansion, no revision
255
+ // operators beyond `--not`, and every output is parsed here in JavaScript, so
256
+ // the same strings run unchanged in a POSIX shell or PowerShell. These local
257
+ // commands deliberately do not go through runGitStep: a failure here is never
258
+ // a credential problem, so the auth self-heal and transient retries do not
259
+ // apply. Any failure or unparseable output throws GitSyncError and the caller
260
+ // does not reset (fail closed).
261
+
262
+ const SALVAGE_REF_PREFIX = 'fleet-salvage';
263
+ // Identity for `git stash create` only (it writes a commit object, which needs
264
+ // a committer even on a member with no git identity configured). Plain tokens:
265
+ // no spaces, no angle brackets, no '@'.
266
+ const SALVAGE_IDENTITY_ARGS = '-c user.name=fleet-salvage -c user.email=fleet-salvage.invalid';
267
+ const FULL_SHA_LINE_RE = /^[0-9a-f]{40,64}$/i;
268
+
269
+ /** Lines of a command's output, trimmed, blanks dropped. */
270
+ function outputLines(text) {
271
+ return String(text || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
272
+ }
273
+
274
+ /** A single-component ref slug for `branch`: anything outside [A-Za-z0-9_-] becomes '-'. */
275
+ export function salvageBranchSlug(branch) {
276
+ const slug = String(branch || '').replace(/[^A-Za-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '');
277
+ return slug || 'branch';
278
+ }
279
+
280
+ /**
281
+ * Pin a member's unpublished commits and uncommitted tracked changes on a
282
+ * local fleet-salvage/ ref before a reset onto `<remote>/<branch>`. Resolves
283
+ * null when there is nothing to save; throws GitSyncError when the salvage
284
+ * could not be completed (the caller must then not reset).
285
+ *
286
+ * @param {string} member
287
+ * @param {{ command: Function, log?: Function, remote: string, branch: string }} opts
288
+ * @returns {Promise<null|{ ref: string, target: string, headSha: string, remoteTipSha: string, ahead: number, stashSha: string|null }>}
289
+ */
290
+ export async function salvageBeforeReset(member, { command, log = () => {}, remote, branch }) {
291
+ const remoteRef = `${remote}/${branch}`;
292
+ const fail = (what, output) => {
293
+ throw new GitSyncError(
294
+ `[Sync] Retry salvage for member '${member}' failed (${what}); NOT resetting onto '${remoteRef}', so the local branch and its uncommitted changes are left exactly as they were.${output ? ` Output: ${output}` : ''}`,
295
+ { member, gitOutput: output || null, details: { kind: 'retry-salvage-failed' } },
296
+ );
297
+ };
298
+ const run = async (cmd, label) => {
299
+ let res;
300
+ try {
301
+ res = await command(cmd, { member_name: member, silent: true, failSoft: true, label: `${label} for '${member}'` });
302
+ } catch (err) {
303
+ res = { ok: false, error: (err && err.message) || String(err) };
304
+ }
305
+ return res || { ok: false, error: 'no result' };
306
+ };
307
+
308
+ // 1. Local HEAD and the freshly fetched remote tip, in one read.
309
+ const revs = await run(`git rev-parse HEAD ${remoteRef}`, 'Retry salvage: HEAD and remote tip read');
310
+ const revOut = outputOf(revs);
311
+ if (revOut === null) fail(`could not read HEAD and ${remoteRef}`, revs.error);
312
+ const shas = outputLines(revOut).filter((l) => FULL_SHA_LINE_RE.test(l)).map((l) => l.toLowerCase());
313
+ if (shas.length !== 2) fail(`unrecognized output reading HEAD and ${remoteRef}`, revOut.trim());
314
+ const [headSha, remoteTipSha] = shas;
315
+
316
+ // 2. Commits on the local branch that the remote tip lacks.
317
+ let ahead = 0;
318
+ if (headSha !== remoteTipSha) {
319
+ const countRes = await run(`git rev-list --count ${headSha} --not ${remoteTipSha}`, 'Retry salvage: unpublished commit count');
320
+ const countOut = outputOf(countRes);
321
+ if (countOut === null) fail('could not count unpublished local commits', countRes.error);
322
+ const countLines = outputLines(countOut).filter((l) => /^\d+$/.test(l));
323
+ if (countLines.length !== 1) fail('unrecognized output counting unpublished local commits', countOut.trim());
324
+ ahead = Number(countLines[0]);
325
+ }
326
+
327
+ // 3. Uncommitted tracked changes, as a dangling commit (empty = clean).
328
+ const stashRes = await run(`git ${SALVAGE_IDENTITY_ARGS} stash create`, 'Retry salvage: snapshot of uncommitted tracked changes');
329
+ const stashOut = outputOf(stashRes);
330
+ if (stashOut === null) fail('could not snapshot uncommitted tracked changes', stashRes.error);
331
+ const stashLines = outputLines(stashOut);
332
+ let stashSha = null;
333
+ if (stashLines.length > 0) {
334
+ const found = stashLines.filter((l) => FULL_SHA_LINE_RE.test(l));
335
+ if (found.length !== 1) fail('unrecognized output snapshotting uncommitted tracked changes', stashOut.trim());
336
+ stashSha = found[0].toLowerCase();
337
+ }
338
+
339
+ if (ahead === 0 && !stashSha) {
340
+ log(`[Sync] Retry salvage for member '${member}': nothing unpublished to save (no local commits ahead of '${remoteRef}', no uncommitted tracked changes); no side ref created.`);
341
+ return null;
342
+ }
343
+
344
+ // 4. The side ref. The sprint branch is not touched.
345
+ const target = stashSha || headSha;
346
+ const slug = salvageBranchSlug(branch);
347
+ const ref = `${SALVAGE_REF_PREFIX}/${slug}/${target.slice(0, 12)}`;
348
+ const branchRes = await run(`git branch -f ${ref} ${target}`, 'Retry salvage: create side ref');
349
+ if (outputOf(branchRes) === null) {
350
+ const text = String(branchRes.error || branchRes.output || '');
351
+ const conflict = text.match(/'refs\/heads\/([^']+)' exists;\s*cannot create/i);
352
+ if (conflict || /cannot lock ref/i.test(text)) {
353
+ const blocking = conflict ? conflict[1] : `${SALVAGE_REF_PREFIX}/${slug}`;
354
+ throw new GitSyncError(
355
+ `[Sync] Retry salvage for member '${member}' could not create side ref '${ref}': an existing ref '${blocking}' blocks that name (a ref cannot be both a branch and a directory of branches). ` +
356
+ `NOT resetting onto '${remoteRef}'; the local branch is unchanged. Inspect it with 'git log ${blocking}', then delete it with 'git branch -D ${blocking}' in that member's work folder and re-run. Output: ${text.trim()}`,
357
+ { member, gitOutput: text || null, details: { kind: 'retry-salvage-ref-conflict', ref, conflictingRef: blocking } },
358
+ );
359
+ }
360
+ fail(`could not create side ref '${ref}'`, text.trim());
361
+ }
362
+
363
+ const recovery = [`git log ${ref}`];
364
+ if (ahead > 0) recovery.push(`git cherry-pick ${remoteTipSha}..${headSha}`);
365
+ if (stashSha) recovery.push(`git stash apply ${stashSha}`);
366
+ log(
367
+ `[Sync] Retry salvage for member '${member}': saved ${ahead} unpublished local commit(s)` +
368
+ `${stashSha ? ' and the uncommitted tracked changes' : ''} on local side ref '${ref}' before resetting onto '${remoteRef}'. ` +
369
+ `Recover with: ${recovery.join(' ; ')}. Untracked files are left in place. The side ref is local only and is never pushed.`
370
+ );
371
+ return { ref, target, headSha, remoteTipSha, ahead, stashSha };
372
+ }
373
+
374
+ /**
375
+ * Does `remote`/`branch` contain `member`'s local HEAD? Never throws.
376
+ *
377
+ * @param {string} member
378
+ * @param {{ command: Function, remote: string, branch?: string }} opts
379
+ * @returns {Promise<{ status: 'contained'|'not-contained'|'unverified', why?: string, localHead?: string, remoteTip?: string }>}
380
+ */
381
+ export async function checkGitPushLanded(member, { command, remote, branch }) {
382
+ if (!branch) return { status: 'unverified', why: 'no branch name to check the push against' };
383
+ if (!SAFE_GIT_NAME_RE.test(branch) || !SAFE_GIT_NAME_RE.test(remote)) return { status: 'unverified', why: 'remote or branch name is outside the safe character set' };
384
+ const run = async (cmd, label) => {
385
+ try {
386
+ return await command(cmd, { member_name: member, silent: true, failSoft: true, label: `${label} for '${member}'` });
387
+ } catch (err) {
388
+ return { ok: false, error: (err && err.message) || String(err) };
389
+ }
390
+ };
391
+
392
+ const headOut = outputOf(await run('git rev-parse HEAD', 'G-push landed check: local HEAD read'));
393
+ const localHead = headOut === null ? null : headOut.trim().split(/\r?\n/)[0].trim();
394
+ if (!localHead || !GIT_SHA_RE.test(localHead)) return { status: 'unverified', why: 'could not read the local HEAD' };
395
+
396
+ const lsOut = outputOf(await run(`git ls-remote ${remote} refs/heads/${branch}`, 'G-push landed check: remote branch read'));
397
+ if (lsOut === null) return { status: 'unverified', why: `could not read ${remote}/${branch}` };
398
+ let remoteTip = null;
399
+ for (const line of lsOut.split(/\r?\n/)) {
400
+ const m = line.match(/^([0-9a-f]{40,64})\s+(\S+)\s*$/i);
401
+ if (m && m[2] === `refs/heads/${branch}`) { remoteTip = m[1].toLowerCase(); break; }
402
+ }
403
+ if (!remoteTip) {
404
+ if (lsOut.trim() === '') return { status: 'not-contained', localHead, why: `branch '${branch}' does not exist on '${remote}'` };
405
+ return { status: 'unverified', localHead, why: `unrecognized ls-remote output for ${remote}/${branch}` };
406
+ }
407
+ if (remoteTip === localHead.toLowerCase()) return { status: 'contained', localHead, remoteTip };
408
+
409
+ // The remote moved past (or away from) our HEAD. Fetch it, then count
410
+ // commits in our HEAD that the remote tip lacks: 0 means contained.
411
+ const fetchRes = await run(`git fetch ${remote} ${branch}`, 'G-push landed check: remote branch fetch');
412
+ if (outputOf(fetchRes) === null) return { status: 'unverified', localHead, remoteTip, why: `could not fetch ${remote}/${branch}: ${fetchRes && fetchRes.error}` };
413
+ const countOut = outputOf(await run(`git rev-list --count ${localHead} --not ${remoteTip}`, 'G-push landed check: containment count'));
414
+ const count = countOut === null ? NaN : Number(countOut.trim());
415
+ if (!Number.isInteger(count)) return { status: 'unverified', localHead, remoteTip, why: 'could not compare the local HEAD with the remote tip' };
416
+ if (count === 0) return { status: 'contained', localHead, remoteTip };
417
+ return { status: 'not-contained', localHead, remoteTip, why: `${remote}/${branch} is at ${remoteTip}, which lacks ${count} commit(s) of the local HEAD ${localHead}` };
418
+ }
419
+
216
420
  /**
217
421
  * G-push: publish `member`'s committed work to the shared branch after a
218
422
  * dispatch -- `git push` with ONE bounded pull-rebase retry. If the
@@ -278,12 +482,28 @@ export async function syncMemberAfter(member, opts = {}) {
278
482
  // `git push <remote> <branch>` spelling below.
279
483
  const pushCmd = branch ? `git push${setUpstream ? ' -u' : ''} ${remote} ${branch}` : 'git push';
280
484
 
485
+ // A push step reported success: only return success when the remote
486
+ // branch provably carries our HEAD, or the check is inconclusive.
487
+ const confirmLanded = async (result, label) => {
488
+ const verdict = await checkGitPushLanded(member, { command, remote, branch });
489
+ if (verdict.status === 'not-contained') {
490
+ throw new GitSyncError(
491
+ `[Sync] ${label} reported success but the push did NOT land: ${verdict.why}. The member's commits have NOT reached the shared branch.`,
492
+ { member, gitOutput: verdict.why, details: { kind: 'push-not-landed', operation: 'push', localHead: verdict.localHead, remoteTip: verdict.remoteTip } },
493
+ );
494
+ }
495
+ if (verdict.status === 'unverified' && branch) {
496
+ log(`[Sync] ${label} reported success, but whether it landed could not be verified: ${verdict.why}`);
497
+ }
498
+ return result;
499
+ };
500
+
281
501
  let push = await runGitStep({
282
502
  command, member, cmd: pushCmd,
283
503
  label: `G-push for '${member}'`, log, maxTransientRetries, onAuthFailure, provider,
284
504
  });
285
505
  if (push.ok) {
286
- return { ok: true, member, pushed: true, rebased: false };
506
+ return await confirmLanded({ ok: true, member, pushed: true, rebased: false }, `G-push for member '${member}'`);
287
507
  }
288
508
 
289
509
  if (push.kind !== 'diverged') {
@@ -326,7 +546,7 @@ export async function syncMemberAfter(member, opts = {}) {
326
546
  label: `G-push retry (create missing remote branch) for '${member}'`, log, maxTransientRetries, onAuthFailure, provider,
327
547
  });
328
548
  if (createPush.ok) {
329
- return { ok: true, member, pushed: true, rebased: false };
549
+ return await confirmLanded({ ok: true, member, pushed: true, rebased: false }, `G-push retry (create missing remote branch) for member '${member}'`);
330
550
  }
331
551
  if (createPush.kind === 'diverged') {
332
552
  // The branch now exists on the remote -- a concurrent writer
@@ -375,8 +595,9 @@ export async function syncMemberAfter(member, opts = {}) {
375
595
  label: `G-push after Tier 2 conflict resolution for '${member}'`, log, maxTransientRetries, onAuthFailure, provider,
376
596
  });
377
597
  if (rePush.ok) {
598
+ const landed = await confirmLanded({ ok: true, member, pushed: true, rebased: true, tier2Resolved: true }, `G-push after Tier 2 conflict resolution for member '${member}'`);
378
599
  log(`[Sync] Tier 2 conflict resolution for member '${member}' succeeded -- working tree clean and the resolved code was pushed.`);
379
- return { ok: true, member, pushed: true, rebased: true, tier2Resolved: true };
600
+ return landed;
380
601
  }
381
602
  log(`[Sync] Tier 2 conflict resolution for member '${member}' left a clean tree but the re-push still failed: ${rePush.error}`);
382
603
  } else {
@@ -402,7 +623,7 @@ export async function syncMemberAfter(member, opts = {}) {
402
623
  label: `G-push re-push after rebase for '${member}'`, log, maxTransientRetries, onAuthFailure, provider,
403
624
  });
404
625
  if (push.ok) {
405
- return { ok: true, member, pushed: true, rebased: true };
626
+ return await confirmLanded({ ok: true, member, pushed: true, rebased: true }, `G-push re-push after rebase for member '${member}'`);
406
627
  }
407
628
 
408
629
  // Still rejected after the one bounded rebase -- diverged, never retried further.
@@ -0,0 +1,153 @@
1
+ // =============================================================================
2
+ // IN-RUN ORPHANED-CLAIM TRACKING (GitHub #715).
3
+ //
4
+ // A doer of THIS sprint claims its beads (`bd update --claim`, by the engine
5
+ // and/or the doer itself), so a doer that then dies, exhausts its resumes or
6
+ // returns BLOCKED leaves the bead 'in_progress'. `bd ready` never offers an
7
+ // in_progress bead, so the bead -- and every bead its `blocks` chain hides --
8
+ // is stuck for the rest of the sprint. reclaimStaleInProgress in runner.js
9
+ // cannot help: it only reclaims claims that PREDATE the sprint launch.
10
+ //
11
+ // This module is the pure bookkeeping half of the fix. It records, per bead
12
+ // id, the latest streak outcome a doer dispatch of THIS run produced, and
13
+ // answers "which of those beads is an orphan candidate right now". It issues
14
+ // no command of its own: runner.js owns the fresh read, the session stop and
15
+ // the write, so every bd/fleet call stays inside the guarded runner surface.
16
+ //
17
+ // RULES (each one is a reason a bead is NOT a candidate):
18
+ // - its latest outcome closed it, or it was never failed -> nothing to do;
19
+ // - its streak failed because every bead was already claimed by ANOTHER
20
+ // sprint (structured reason CLAIMED_ELSEWHERE_REASON, carried on the
21
+ // outcome, never matched from message text) -> that claim belongs to the
22
+ // other sprint and is never touched;
23
+ // - its streak COMPLETED but the post-dispatch sync failed (including the
24
+ // permission-scope publish-blocked case) -> the work is committed on the
25
+ // doer's clone and the engine has already decided not to re-dispatch it;
26
+ // - the cached snapshot does not show it in_progress -> nothing to reclaim.
27
+ // The snapshot is only a PRE-FILTER that saves a fresh read on the common
28
+ // path; it never authorizes a write (runner.js re-reads before writing);
29
+ // - it has already been reclaimed ORPHAN_RECLAIM_LIMIT times -> capped and
30
+ // surfaced instead of bounced again.
31
+ //
32
+ // A reclaimed id is DROPPED from the tracker (forget/markReclaimed): it is
33
+ // only re-added when a doer of this run is dispatched on it again, so a later
34
+ // claim of the same bead by another actor is never reset at a cycle top.
35
+ //
36
+ // GUARD COVERAGE: registered in guarded-modules.mjs. It carries no command()
37
+ // or agent() call site.
38
+ // =============================================================================
39
+
40
+ /** Re-dispatch bound per bead, across the whole sprint. */
41
+ export const ORPHAN_RECLAIM_LIMIT = 2;
42
+
43
+ /**
44
+ * The structured `reason` develop.mjs carries on a streak outcome whose
45
+ * claim found every bead already held by another sprint.
46
+ */
47
+ export const CLAIMED_ELSEWHERE_REASON = 'all-beads-already-claimed';
48
+
49
+ /**
50
+ * @param {{ limit?: number }} [opts]
51
+ */
52
+ export function createOrphanClaimTracker(opts = {}) {
53
+ const limit = Number.isInteger(opts.limit) && opts.limit > 0 ? opts.limit : ORPHAN_RECLAIM_LIMIT;
54
+ // id -> { doerMember, failureReason, workCompleted }
55
+ const failedById = new Map();
56
+ const reclaimCounts = new Map();
57
+ const cappedIds = new Set();
58
+
59
+ return {
60
+ /**
61
+ * Fold one Develop round's streak outcomes in. Every bead a doer of
62
+ * this run was dispatched on is recorded by its LATEST outcome: a
63
+ * closed bead is dropped, a still-open bead of a failed streak is
64
+ * recorded as failed with the streak's structured failure reason.
65
+ * @param {object[]} streakOutcomes develop.mjs's per-streak outcomes
66
+ */
67
+ recordOutcomes(streakOutcomes) {
68
+ for (const o of streakOutcomes || []) {
69
+ const unclosed = new Set(o.unclosedIds || []);
70
+ for (const id of o.beadIds || []) {
71
+ if (o.outcome !== 'failed' || !unclosed.has(id)) {
72
+ failedById.delete(id);
73
+ continue;
74
+ }
75
+ failedById.set(id, {
76
+ doerMember: o.doerMember || null,
77
+ failureReason: o.failureReason || null,
78
+ workCompleted: o.publishBlocked === true || o.postDispatchSyncFailed === true,
79
+ });
80
+ }
81
+ }
82
+ },
83
+
84
+ /** True when at least one tracked bead's latest streak failed. */
85
+ hasFailed() {
86
+ return failedById.size > 0;
87
+ },
88
+
89
+ /**
90
+ * Orphan candidates against a (possibly stale) beads snapshot. The
91
+ * snapshot only narrows the set; the caller must confirm each
92
+ * candidate with a fresh read before writing.
93
+ * @param {object[]} snapshotBeads full or scoped `bd list` records
94
+ * @returns {{ candidates: { id: string, doerMember: string|null }[], newlyCappedIds: string[] }}
95
+ */
96
+ candidates(snapshotBeads) {
97
+ const statusById = new Map((snapshotBeads || []).map((b) => [b.id, b.status]));
98
+ const candidates = [];
99
+ const newlyCappedIds = [];
100
+ for (const [id, rec] of [...failedById.entries()]) {
101
+ if (rec.failureReason === CLAIMED_ELSEWHERE_REASON || rec.workCompleted) {
102
+ failedById.delete(id);
103
+ continue;
104
+ }
105
+ const status = statusById.get(id);
106
+ if (status === 'closed') {
107
+ failedById.delete(id);
108
+ continue;
109
+ }
110
+ if (status !== 'in_progress') continue;
111
+ if ((reclaimCounts.get(id) ?? 0) >= limit) {
112
+ failedById.delete(id);
113
+ if (!cappedIds.has(id)) {
114
+ cappedIds.add(id);
115
+ newlyCappedIds.push(id);
116
+ }
117
+ continue;
118
+ }
119
+ candidates.push({ id, doerMember: rec.doerMember });
120
+ }
121
+ return { candidates, newlyCappedIds };
122
+ },
123
+
124
+ /** Drop an id without counting a reclaim (e.g. a fresh read found it closed). */
125
+ forget(id) {
126
+ failedById.delete(id);
127
+ },
128
+
129
+ /**
130
+ * Record a successful reclaim: the id leaves the tracker (re-added
131
+ * only on re-dispatch) and its per-bead count grows.
132
+ * @returns {number} the attempt number just used (1-based)
133
+ */
134
+ markReclaimed(id) {
135
+ failedById.delete(id);
136
+ const n = (reclaimCounts.get(id) ?? 0) + 1;
137
+ reclaimCounts.set(id, n);
138
+ return n;
139
+ },
140
+
141
+ /** Ids that hit the per-bead cap this sprint, in the order they hit it. */
142
+ cappedIds() {
143
+ return [...cappedIds];
144
+ },
145
+
146
+ /** Whether `id` is currently tracked as a failed dispatch of this run. */
147
+ isTracked(id) {
148
+ return failedById.has(id);
149
+ },
150
+
151
+ limit,
152
+ };
153
+ }
@@ -43,6 +43,121 @@
43
43
 
44
44
  import { dispatchRole, TURN_BASES } from '../dispatch-role.mjs';
45
45
 
46
+ // =============================================================================
47
+ // DEPLOY-FAILURE VERDICT GATE (apra-fleet-b4g.102.1).
48
+ //
49
+ // A cycle whose deploy FAILED skipped Integration Test, so nothing this cycle
50
+ // ever exercised the deployed build. Cycle Evaluation used to exit as
51
+ // "satisfied" on 0 open beads + an APPROVED review regardless, and the Final
52
+ // Review's LLM verdict was the only thing standing between that and a [PASS]
53
+ // PR. The rule is now enforced by the orchestrator, not left to the LLM:
54
+ //
55
+ // * Cycle Evaluation never exits as satisfied (goal-priority exit OR the
56
+ // root/target-already-closed exit) while the LATEST cycle's deploy failed.
57
+ // It re-attempts the deploy in another cycle while the cycle budget
58
+ // (maxCycles) and DEPLOY_RETRY_CYCLE_LIMIT both allow.
59
+ // * When that budget is exhausted, the loop ends and the sprint verdict is
60
+ // forced to FAIL (deliberately FAIL, not INCONCLUSIVE: Publish PR's title
61
+ // and the run status are PASS/FAIL only, and an unverified build is a
62
+ // failed gate, not an undecided one). The reason names the cycle and the
63
+ // deployer's notes, and is prepended to the verdict notes so it reaches
64
+ // the PR title ([FAIL]), the PR body and the sprint analysis doc.
65
+ //
66
+ // A sprint with no deploy.md never records a deploy outcome
67
+ // (lastDeployFailure stays null), so none of this changes its behaviour.
68
+ // =============================================================================
69
+
70
+ /**
71
+ * Consecutive cycles that may each end "otherwise satisfied but the deploy
72
+ * failed" before Cycle Evaluation stops re-attempting the deploy and exits to
73
+ * the finish phases with a forced FAIL. Bounded by maxCycles as well.
74
+ */
75
+ export const DEPLOY_RETRY_CYCLE_LIMIT = 3;
76
+
77
+ /**
78
+ * The latest cycle's deploy outcome, as the gate reads it.
79
+ *
80
+ * @param {{ hasDeploy: boolean, deployedThisCycle: boolean, cycle: number,
81
+ * deployFailures: Array<{cycle: number, notes: string}> }} opts
82
+ * @returns {{cycle: number, notes: string} | null} The failure record when a
83
+ * deploy.md exists and this cycle's deploy failed; null when it succeeded or
84
+ * no deploy was attempted (no deploy.md).
85
+ */
86
+ export function latestDeployFailure({ hasDeploy, deployedThisCycle, cycle, deployFailures, deploySetAside = null }) {
87
+ if (!hasDeploy || deployedThisCycle) return null;
88
+ const rec = [...deployFailures].reverse().find((f) => f && f.cycle === cycle);
89
+ if (rec) return { cycle, notes: rec.notes != null ? String(rec.notes) : '(deployer returned no notes)' };
90
+ // No deployer ran this cycle because deploy is set aside for the run (see
91
+ // DEPLOY SET-ASIDE below): the failure is still the set-aside one.
92
+ if (deploySetAside) return { cycle, notes: formatDeploySetAsideNotes(deploySetAside) };
93
+ return { cycle, notes: '(deployer returned no notes)' };
94
+ }
95
+
96
+ // =============================================================================
97
+ // DEPLOY SET-ASIDE.
98
+ //
99
+ // A deploy that fails at the deploy.md Permissions check (deployer Step 0a: no
100
+ // deploy command ran) fails identically every cycle until an operator grants
101
+ // the missing permission, so re-dispatching the deployer only burns a turn.
102
+ // The deployer marks that stop with the structured `failedStep: 'permissions'`
103
+ // field (never inferred from its notes); runDeployPhase then records
104
+ // `sprintState.deploySetAside` = { reason, notes, cycle } (cycle = first seen)
105
+ // and the cycle loop does not dispatch the deployer again this run. The
106
+ // failure itself still goes onto deployFailures, so the verdict gate above
107
+ // keeps working; later cycles report it through latestDeployFailure's
108
+ // `deploySetAside` fallback. Any other failure (field absent, or a deploy
109
+ // command ran) keeps the normal per-cycle retry.
110
+ // =============================================================================
111
+
112
+ /** The structured deployer failedStep value that sets deploy aside for the run. */
113
+ export const DEPLOY_PERMISSIONS_FAILED_STEP = 'permissions';
114
+
115
+ /**
116
+ * Notes for a cycle whose deploy was not dispatched because it is set aside.
117
+ *
118
+ * @param {{ reason: string, cycle: number }} setAside
119
+ * @returns {string}
120
+ */
121
+ export function formatDeploySetAsideNotes(setAside) {
122
+ return `deploy not dispatched -- set aside for this run since C${setAside.cycle}: ${setAside.reason}`;
123
+ }
124
+
125
+ /**
126
+ * One-line reason naming the deploy failure; used in the cycle-loop log, the
127
+ * forced verdict notes and therefore the PR body.
128
+ *
129
+ * @param {{cycle: number, notes: string}} failure
130
+ * @returns {string}
131
+ */
132
+ export function formatDeployFailureReason(failure) {
133
+ return `Deploy FAILED in the last cycle (C${failure.cycle}), so Integration Test never ran against the ` +
134
+ `deployed build and this sprint cannot PASS. Deployer notes: ${failure.notes}`;
135
+ }
136
+
137
+ /**
138
+ * Applies the gate to the Final Review verdict. Returns a NEW verdict object
139
+ * (never mutates the dispatch result). With no failure, returns the input
140
+ * unchanged. With a failure, the verdict is FAIL and the notes start with the
141
+ * reason; an LLM PASS is overridden, an LLM FAIL keeps its own notes after it.
142
+ *
143
+ * @param {object} verdictResult Final Review verdict ({verdict, notes, ...}).
144
+ * @param {{cycle: number, notes: string} | null} failure
145
+ * @returns {object}
146
+ */
147
+ export function applyDeployFailureVerdictGate(verdictResult, failure) {
148
+ if (!failure) return verdictResult;
149
+ const reason = formatDeployFailureReason(failure);
150
+ const prior = verdictResult && typeof verdictResult.notes === 'string' ? verdictResult.notes : '';
151
+ const overridden = !verdictResult || verdictResult.verdict === 'PASS';
152
+ return {
153
+ ...(verdictResult || {}),
154
+ verdict: 'FAIL',
155
+ notes: `${reason}` +
156
+ (overridden ? ' (Final Review returned PASS; the orchestrator overrode it to FAIL.)' : '') +
157
+ (prior ? `\n\n${prior}` : ''),
158
+ };
159
+ }
160
+
46
161
  /**
47
162
  * Runs the per-cycle Deploy phase.
48
163
  *
@@ -64,6 +179,9 @@ export async function runDeployPhase({
64
179
  getMemberForRole,
65
180
  ensureUnattendedAuto,
66
181
  ensureDeployPermissions,
182
+ // Per-sprint state; `deploySetAside` is recorded on it (see DEPLOY
183
+ // SET-ASIDE above).
184
+ sprintState,
67
185
  // Mutated in place; reassigned and returned, respectively (see header).
68
186
  deployFailures,
69
187
  deployedThisCycle,
@@ -130,6 +248,17 @@ export async function runDeployPhase({
130
248
  if (!deployedThisCycle) {
131
249
  deployFailures.push({ cycle, notes: deployResult.notes });
132
250
  log(`Deploy FAILED this cycle (C${cycle}): ${deployResult.notes}. Skipping Integration Test phase.`);
251
+ if (deployResult.failedStep === DEPLOY_PERMISSIONS_FAILED_STEP && sprintState && !sprintState.deploySetAside) {
252
+ sprintState.deploySetAside = {
253
+ reason: 'deployer stopped at the deploy.md Permissions check before running any deploy command',
254
+ notes: deployResult.notes,
255
+ cycle,
256
+ };
257
+ log(
258
+ `Deploy SET ASIDE for the rest of this run (first seen C${cycle}): ${sprintState.deploySetAside.reason}. ` +
259
+ 'Not dispatching the deployer again this run -- grant the missing permission(s) and re-trigger the sprint.'
260
+ );
261
+ }
133
262
  }
134
263
 
135
264
  return { deployedThisCycle };