@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -52,6 +52,7 @@
52
52
  // dispatchRole call sites for the streak-assignment and doer ladders.
53
53
  // =============================================================================
54
54
 
55
+ import { pathsFromText } from '../kb-hints.mjs';
55
56
  import { WorkflowError } from '@apralabs/apra-fleet-workflow';
56
57
 
57
58
  import { dispatchRole, TURN_BASES } from '../dispatch-role.mjs';
@@ -63,6 +64,7 @@ import {
63
64
  import { isPostDispatchSyncFailure } from '../errors.mjs';
64
65
  import { isPermissionScopePostDispatchSyncFailure } from '../dispatch-failure.mjs';
65
66
  import { policyFor } from '../role-policies.mjs';
67
+ import { CLAIMED_ELSEWHERE_REASON } from '../orphan-reclaim.mjs';
66
68
 
67
69
  /**
68
70
  * Runs ONE Develop round: streak grouping, per-doer worklist packing, and the
@@ -89,7 +91,7 @@ export async function runDevelopPhase({
89
91
  cycle,
90
92
  validated,
91
93
  args,
92
- orchestratorMember,
94
+ backlogMember,
93
95
  // Per-sprint resolved state (../sprint-state.mjs), the git/beads sync
94
96
  // brackets every doer dispatch and verification read goes through, and the
95
97
  // dashboard refresh each completed streak turn triggers.
@@ -98,6 +100,7 @@ export async function runDevelopPhase({
98
100
  updateDashboard,
99
101
  // The KB clients the doer prompt is primed from.
100
102
  kbPriming,
103
+ kbInjection,
101
104
  kbWork,
102
105
  // Per-round inputs. `devRounds` arrives already incremented (see header);
103
106
  // `perBeadFeedback` is read-only here.
@@ -312,6 +315,13 @@ export async function runDevelopPhase({
312
315
  try {
313
316
  let actualBeadIds = streak.map((b) => b.id); // May be reduced by claiming if assignee is set
314
317
  let hasClaimedBeads = false; // Track whether we've done claiming yet
318
+ // Set when the claim found every bead of this streak already held by
319
+ // another sprint. Carried onto the failed outcome as the STRUCTURED
320
+ // failureReason the in-run orphan reclaim (runner.js) keys on, so a
321
+ // claim another sprint holds is identified without reading message
322
+ // text -- and sticky, so a retried attempt refuses the same way
323
+ // instead of dispatching a doer on beads it does not own.
324
+ let claimedElsewhere = false;
315
325
 
316
326
  // The base turn budget the resume ladder escalates from. Read
317
327
  // out of the ENGINE's TURN_BASES (apra-fleet-3swo.5.7) rather
@@ -384,20 +394,23 @@ export async function runDevelopPhase({
384
394
  // multi-id --claim contract (non-atomic, JSON-array-only
385
395
  // success signal) this relies on.
386
396
  claimBeads: async () => {
397
+ const claimedElsewhereError = () => new WorkflowError(
398
+ `All beads already claimed by other sprints`,
399
+ { details: { beadIds: actualBeadIds, reason: CLAIMED_ELSEWHERE_REASON } }
400
+ );
401
+ if (claimedElsewhere) throw claimedElsewhereError();
387
402
  if (hasClaimedBeads) return;
388
403
  hasClaimedBeads = true;
389
404
  if (!validated.assignee) return;
390
405
  const { claimedBeadIds, skippedBeadIds } = await claimBeadsBatched({
391
- command, orchestratorMember, beadIds: actualBeadIds, log,
406
+ command, backlogMember, beadIds: actualBeadIds, log,
392
407
  });
393
408
  if (claimedBeadIds.length === 0) {
394
409
  // All beads in this streak are already claimed by
395
410
  // other sprints. Skip this streak entirely.
396
411
  log(`Doer streak: all beads ${streakScope()} are already claimed by other sprints -- skipping this streak.`);
397
- throw new WorkflowError(
398
- `All beads already claimed by other sprints`,
399
- { beadIds: actualBeadIds, reason: 'all-beads-already-claimed' }
400
- );
412
+ claimedElsewhere = true;
413
+ throw claimedElsewhereError();
401
414
  }
402
415
  if (skippedBeadIds.length > 0) {
403
416
  actualBeadIds = claimedBeadIds; // Only the successfully claimed ones
@@ -415,7 +428,7 @@ export async function runDevelopPhase({
415
428
  // (DoltSync.syncBefore) -- treat the whole call as one bracket.
416
429
  verifyStreakClosed: async (phase) => {
417
430
  const unclosed = await gitSync.withOpenSyncBracket(() => verifyDoerStreakClosed({
418
- command, orchestratorMember, beadIds: actualBeadIds, log, args, sprintState,
431
+ command, backlogMember, beadIds: actualBeadIds, log, args, sprintState,
419
432
  }));
420
433
  if (phase === 'preDispatch' && unclosed.length === 0) {
421
434
  log(
@@ -430,8 +443,12 @@ export async function runDevelopPhase({
430
443
  },
431
444
  // Built INSIDE the bracket, after the claim: the streak this
432
445
  // dispatch actually owns is only known once the claim has run.
433
- prepare: async ({ dispatch, resumeAttempt }) => {
434
- if (dispatch.kind === 'max-turns-resume') {
446
+ prepare: async ({ dispatch, resumeAttempt, freshSession }) => {
447
+ // freshSession: the engine has no explicit session id to resume
448
+ // (or the id was not found), so this secondary dispatch is a
449
+ // FRESH session and gets the FULL streak prompt below, with the
450
+ // worklist's warm-session resume suppressed.
451
+ if (dispatch.kind === 'max-turns-resume' && !freshSession) {
435
452
  const resumeTurns = BASE_DOER_MAX_TURNS * (2 ** resumeAttempt);
436
453
  log(
437
454
  `Doer streak ${streakScope()} on member '${doerMember}' exhausted its turn limit ` +
@@ -496,7 +513,7 @@ export async function runDevelopPhase({
496
513
  // fall back to a FRESH session carrying the FULL prompt --
497
514
  // never a delta prompt into a fresh session.
498
515
  let worklistResumeArg = false;
499
- if (worklistCtx && worklistCtx.sessionId) {
516
+ if (worklistCtx && worklistCtx.sessionId && !freshSession) {
500
517
  if (hasContextHeadroomForResume(worklistCtx.usage)) {
501
518
  worklistResumeArg = worklistCtx.sessionId;
502
519
  } else {
@@ -517,22 +534,30 @@ export async function runDevelopPhase({
517
534
  );
518
535
  }
519
536
 
520
- // The doer cannot read the KB itself (the member's
521
- // composed permission config disables the fleet MCP
522
- // server), so the entries primed for THIS member travel in
523
- // its prompt. Relevance-ranked read for THESE beads,
524
- // falling back to the sprint-start primed set when the
525
- // query returns nothing. The query terms are the bead ids
526
- // and titles the engine already holds; expand_related on
527
- // that call is what traverses the refines/contradiction_of
528
- // edges.
529
- const doerRepoPath = kbPriming.folderOf(doerMember);
530
- const doerKnowledge = await kbWork.relevantKnowledge(doerRepoPath, kbQueryTerms(streak, actualBeadIds));
537
+ // KNOWLEDGE BANK: injected unless this doer member's own fleet
538
+ // MCP was verified at sprint init (it then reads the KB
539
+ // itself); otherwise fetched from the repository's
540
+ // kb_maintainer, ranked by the bead titles and the files the
541
+ // lane touches (kb-injection.mjs).
542
+ const laneBeads = Array.isArray(streak) ? streak : [];
543
+ const doerKbBlock = kbInjection
544
+ ? await kbInjection.blockFor({
545
+ role: 'doer',
546
+ member: doerMember,
547
+ context: {
548
+ beadIds: actualBeadIds,
549
+ beadTitles: laneBeads,
550
+ laneFiles: pathsFromText(laneBeads.map((b) => b && `${b.description || ''}\n${b.acceptance_criteria || ''}\n${b.notes || ''}`)),
551
+ },
552
+ captureChannel: true,
553
+ })
554
+ : undefined;
531
555
  const basePrompt = buildDoerPrompt({
532
556
  beadIds: actualBeadIds,
533
557
  branch: validated.branch,
534
558
  feedback: feedbackForStreak || null,
535
- kbKnowledge: doerKnowledge.length > 0 ? doerKnowledge : kbPriming.knowledgeOf(doerMember),
559
+ kbKnowledge: kbInjection ? undefined : kbPriming.knowledgeOf(doerMember),
560
+ kbBlock: doerKbBlock,
536
561
  });
537
562
  let doerPrompt = basePrompt;
538
563
  if (batchStreaks) {
@@ -576,8 +601,8 @@ export async function runDevelopPhase({
576
601
  // NEXT streak starts from a FRESH session with the full
577
602
  // prompt, mirroring createRoundSessionRegistry's
578
603
  // clear-on-failure rule. (The max-turns ladder is unaffected:
579
- // it resumes the member's last session via `resume: true`,
580
- // not this id.)
604
+ // it resumes the failed dispatch's own explicit session id, or
605
+ // starts a fresh full-prompt session, never this worklist id.)
581
606
  if (worklistCtx) {
582
607
  worklistCtx.sessionId = null;
583
608
  worklistCtx.usage = null;
@@ -613,30 +638,40 @@ export async function runDevelopPhase({
613
638
  // (apra-fleet-p2to.4.1) verifyDoerStreakClosed() D-pulls internally
614
639
  // (DoltSync.syncBefore) -- treat the whole call as one sync bracket.
615
640
  const unclosedIds = await gitSync.withOpenSyncBracket(() => verifyDoerStreakClosed({
616
- command, orchestratorMember, beadIds: actualBeadIds, log, args, sprintState,
641
+ command, backlogMember, beadIds: actualBeadIds, log, args, sprintState,
617
642
  }));
618
643
  const closedIds = actualBeadIds.filter((id) => !unclosedIds.includes(id));
619
644
  log(`Doer streak attribution [${actualBeadIds.join(', ')}]: closed=[${closedIds.join(', ')}] failed=[${unclosedIds.join(', ')}] (dispatch error: ${dispatchError.message}).`);
620
- // NOTE ON `outcome` STAYING 'failed' HERE (never 'publish-blocked')
621
- // EVEN FOR THE PERMISSION-SCOPE CASE: review.mjs's ONLY read of
622
- // this field is `streakOutcomes.filter((o) => o.outcome !== 'failed')`
623
- // to build the round's REVIEW SCOPE, on the invariant that every
624
- // non-'failed' outcome's beads are ACTUALLY closed (this file's own
625
- // success path only ever records 'success'/'retried' when
626
- // unclosedIds is empty). A permission-scope failure's beads are
627
- // NOT closed in the shared beads DB (D-push was skipped -- see
628
- // member-sync.mjs's syncMemberAfterOrdered) even though the doer's
629
- // own local clone may show them closed, so feeding them to review.mjs
630
- // would violate that invariant: the reviewer would be asked to
631
- // evaluate acceptance criteria for beads with no evidence and no
632
- // report, which risks a self-contradictory CHANGES_NEEDED verdict
633
- // and dispatchReview()'s ReviewerContractViolationError -- a hard
634
- // sprint ABORT, i.e. turning "the sprint spins" into "the sprint
635
- // crashes". So `outcome` is kept 'failed' (review.mjs's existing,
636
- // CORRECT exclusion for not-actually-done work) and the
637
- // work-done/publish-blocked distinction is carried on the
638
- // additional `publishBlocked` flag below instead, which review.mjs
639
- // does not read.
645
+ // Structured failure facts for the in-run orphan reclaim
646
+ // (runner.js, ../orphan-reclaim.mjs): WHY the streak failed, read
647
+ // off the error's own fields (never its message text), and
648
+ // whether the turn COMPLETED with only its post-dispatch sync
649
+ // failing (work committed locally -- never re-laned).
650
+ const failureFacts = {
651
+ failureReason: claimedElsewhere
652
+ ? CLAIMED_ELSEWHERE_REASON
653
+ : ((dispatchError.details && dispatchError.details.reason) || 'dispatch-error'),
654
+ ...(isPostDispatchSyncFailure(dispatchError) ? { postDispatchSyncFailed: true } : {}),
655
+ };
656
+ // NOTE ON REVIEW SCOPE: review.mjs's reviewScopeBeadIds() builds the
657
+ // round's review scope from each outcome's `closedIds` -- this
658
+ // engine's own read-back of the shared beads DB just above, never the
659
+ // doer's claim -- so a failed or BLOCKED streak still contributes the
660
+ // beads it verifiably closed. Two flags carry "the close was not
661
+ // published" and make reviewScopeBeadIds skip the outcome: `publishBlocked`
662
+ // (permission-scope G-push refusal; the App/token cannot push, see
663
+ // member-sync.mjs's syncMemberAfterOrdered) and `postDispatchSyncFailed`
664
+ // (any other post-dispatch sync failure: a failed G-push skips the
665
+ // D-push, so the closes never reached the shared DB even though the
666
+ // doer's own clone shows them closed). Both are set on EVERY outcome
667
+ // of the dispatch, including sub-outcomes whose beads all closed.
668
+ // A single-streak dispatch error whose beads ALL verified closed is
669
+ // recorded as success/retried (the work stands); only still-open
670
+ // beads make an outcome 'failed' and eligible for re-laning.
671
+ const unpublishedFlags = {
672
+ ...(permissionScopeBlocked ? { publishBlocked: true } : {}),
673
+ ...(isPostDispatchSyncFailure(dispatchError) ? { postDispatchSyncFailed: true } : {}),
674
+ };
640
675
  if (batchStreaks) {
641
676
  // Mode (i): PER-STREAK attribution for a failed batch
642
677
  // dispatch -- a sub-streak whose beads all verifiably
@@ -654,18 +689,25 @@ export async function runDevelopPhase({
654
689
  streakOutcomes.push({
655
690
  beadIds: subIds, doerMember, wasRetried, report: null,
656
691
  unclosedIds: subUnclosed, closedIds: subClosed,
657
- outcome: subUnclosed.length > 0 ? 'failed' : 'success',
692
+ outcome: subUnclosed.length > 0 ? 'failed' : (wasRetried ? 'retried' : 'success'),
658
693
  ...(subUnclosed.length > 0 ? {
659
694
  error: dispatchError.message,
660
- ...(permissionScopeBlocked ? { publishBlocked: true } : {}),
695
+ ...failureFacts,
661
696
  } : {}),
697
+ ...unpublishedFlags,
662
698
  });
663
699
  }
664
700
  } else {
665
701
  streakOutcomes.push({
666
- beadIds: actualBeadIds, doerMember, outcome: 'failed', wasRetried,
667
- report: null, unclosedIds, closedIds, error: dispatchError.message,
668
- ...(permissionScopeBlocked ? { publishBlocked: true } : {}),
702
+ beadIds: actualBeadIds, doerMember, wasRetried,
703
+ // A claimed-elsewhere streak never ran, so its beads (possibly
704
+ // closed by another sprint) stay 'failed' here.
705
+ outcome: unclosedIds.length > 0 || claimedElsewhere ? 'failed' : (wasRetried ? 'retried' : 'success'),
706
+ report: null, unclosedIds,
707
+ closedIds: claimedElsewhere ? [] : closedIds,
708
+ error: dispatchError.message,
709
+ ...failureFacts,
710
+ ...unpublishedFlags,
669
711
  });
670
712
  }
671
713
  if (permissionScopeBlocked) {
@@ -727,6 +769,9 @@ export async function runDevelopPhase({
727
769
  // whatever already closed here).
728
770
  log(`Doer streak attribution [${actualBeadIds.join(', ')}]: closed=[${closedIds.join(', ')}] failed=[${unclosedIds.join(', ')}].`);
729
771
 
772
+ // The doer RETURNED (its session ended) but left bead(s) open: a
773
+ // BLOCKED report, or a success-looking report the bd read disproves.
774
+ const leftOpenReason = report && report.status === 'BLOCKED' ? 'blocked' : 'left-open';
730
775
  if (unclosedIds.length > 0) {
731
776
  log(`Doer streak [${actualBeadIds.join(', ')}] reported status '${report ? report.status : 'unknown'}' but bead(s) still open: ${unclosedIds.join(', ')} -- treating streak as FAILED.`);
732
777
  }
@@ -744,12 +789,14 @@ export async function runDevelopPhase({
744
789
  beadIds: subIds, doerMember, wasRetried, report,
745
790
  unclosedIds: subUnclosed, closedIds: subClosed,
746
791
  outcome: subUnclosed.length > 0 ? 'failed' : (wasRetried ? 'retried' : 'success'),
792
+ ...(subUnclosed.length > 0 ? { failureReason: leftOpenReason } : {}),
747
793
  });
748
794
  }
749
795
  } else {
750
796
  streakOutcomes.push({
751
797
  beadIds: actualBeadIds, doerMember, wasRetried, report, unclosedIds, closedIds,
752
798
  outcome: unclosedIds.length > 0 ? 'failed' : (wasRetried ? 'retried' : 'success'),
799
+ ...(unclosedIds.length > 0 ? { failureReason: leftOpenReason } : {}),
753
800
  });
754
801
  }
755
802
  await updateDashboard();
@@ -289,6 +289,7 @@ export async function runEnsureSprintBranchPhase({
289
289
  goal: validated.goal,
290
290
  maxCycles: validated.maxCycles,
291
291
  requirementsFile: validated.requirementsFile || null,
292
+ regression: validated.skipRegression ? 'skip' : 'run',
292
293
  });
293
294
  endGroup();
294
295
  }
@@ -89,6 +89,8 @@ import { buildSettleCallback } from '../dolt-settle.mjs';
89
89
  // reported the deferred bead as still open, and the evidence-based final
90
90
  // verdict would then FAIL a sprint the loop had just declared complete.
91
91
  import { partitionDeferredBeads } from '../beads-scope.mjs';
92
+ import { applyDeployFailureVerdictGate, formatDeployFailureReason } from './deploy.mjs';
93
+ import { applyVerifyBlockVerdictGate } from '../verify-block.mjs';
92
94
 
93
95
  /**
94
96
  * Runs the Final Review phase: the sprint's closing evidence-based verdict,
@@ -117,7 +119,7 @@ export async function runFinalReviewPhase({
117
119
  args,
118
120
  validated,
119
121
  targetIssues,
120
- orchestratorMember,
122
+ backlogMember,
121
123
  finalCycleLabel,
122
124
  sprintState,
123
125
  // The git/beads sync brackets this phase's pre-read D-pull and its
@@ -129,13 +131,29 @@ export async function runFinalReviewPhase({
129
131
  integFailures,
130
132
  rejectedNewTasks,
131
133
  verifyEverIds,
134
+ // The LAST cycle's deploy failure ({cycle, notes}), or null when that
135
+ // deploy succeeded or no deploy.md exists. Non-null forces a FAIL verdict
136
+ // (see the deploy-failure verdict gate in ./deploy.mjs).
137
+ lastDeployFailure = null,
138
+ // GitHub #715: bead ids a failed doer of this run left 'in_progress' that
139
+ // hit the in-run re-dispatch cap and were left as they are. Named in the
140
+ // verdict notes (never changes the verdict) so a human sees them.
141
+ reclaimCappedIds = [],
142
+ // GitHub #717: the named verify-block deadlock diagnosis the cycle loop
143
+ // exited on, or null. Non-null forces a FAIL verdict (never PASS).
144
+ verifyBlockDiagnosis = null,
132
145
  // runSprintCycle-scoped locals and runner-module-private values, injected
133
146
  // rather than imported (see header).
134
147
  bdListScoped,
135
148
  decomposedParentIds,
136
149
  goalMax,
150
+ // Bead ids this sprint has dispatched or closed: a below-goal reopen of
151
+ // one of them is applied, not deferred (see isDeferredScopeReopen).
152
+ workedOnIds,
137
153
  NOT_DONE_STATUSES,
138
154
  kbPriming,
155
+ kbInjection,
156
+ kbSprintContext,
139
157
  kbWork,
140
158
  getMemberForRole,
141
159
  childIdAllocator,
@@ -152,11 +170,11 @@ export async function runFinalReviewPhase({
152
170
  // the sprint's closing evidence (finalOpenAtGoal / finalClosedCount)
153
171
  // reflects every member's D-pushed beads state, not the orchestrator's
154
172
  // stale local copy.
155
- // Thread the orchestrator member's REGISTERED shell into dolt-settle,
173
+ // Thread the backlog member's REGISTERED shell into dolt-settle,
156
174
  // guarded on args.callTool the same way the pre-dispatch bracket is
157
175
  // (apra-fleet-7dir.24).
158
- const finalReviewSettleShell = await resolveSettleShell({ args, member: orchestratorMember, log, sprintState });
159
- await gitSync.syncBeadsBefore(orchestratorMember, { fatal: true, settle: buildSettleCallback(orchestratorMember, { command, log, shell: finalReviewSettleShell }) });
176
+ const finalReviewSettleShell = await resolveSettleShell({ args, member: backlogMember, log, sprintState });
177
+ await gitSync.syncBeadsBefore(backlogMember, { fatal: true, settle: buildSettleCallback(backlogMember, { command, log, shell: finalReviewSettleShell }) });
160
178
  const [finalOpenAtGoalRaw, finalOpenAtGoalParentIds, finalClosedBeads] = await Promise.all([
161
179
  bdListScoped(`--status=${NOT_DONE_STATUSES} --priority-max=${goalMax} --json`),
162
180
  decomposedParentIds(),
@@ -199,8 +217,10 @@ export async function runFinalReviewPhase({
199
217
  // per-round reviewer gets. Fetched once, before the dispatch, so the retry
200
218
  // and resume paths reuse the identical block rather than re-querying a
201
219
  // KB that its own earlier promotions may have already changed.
202
- const finalReviewRepoPath = kbPriming.folderOf(getMemberForRole('reviewer'));
203
- const finalKbCandidates = await kbWork.promotionCandidates(finalReviewRepoPath);
220
+ // Candidates are read from (and the confirmations later committed to the
221
+ // bible on) the reviewer's repository kb_maintainer, whose KB every write
222
+ // is routed to.
223
+ const finalKbCandidates = await kbWork.promotionCandidates(getMemberForRole('reviewer'));
204
224
  if (finalKbCandidates.length > 0) {
205
225
  log(`[kb-work] offering ${finalKbCandidates.length} INFERRED entr(ies) to the final reviewer for promotion.`);
206
226
  }
@@ -241,7 +261,15 @@ export async function runFinalReviewPhase({
241
261
  unclosedVerifyIds: finalUnclosedVerifyIds,
242
262
  deferredAtGoalIds: finalDeferredAtGoalIds,
243
263
  kbCandidates: finalKbCandidates,
244
- kbKnowledge: kbPriming.knowledgeOf(getMemberForRole('reviewer')),
264
+ kbKnowledge: kbInjection ? undefined : kbPriming.knowledgeOf(getMemberForRole('reviewer')),
265
+ kbBlock: kbInjection
266
+ ? await kbInjection.blockFor({
267
+ role: 'reviewer',
268
+ member: getMemberForRole('reviewer'),
269
+ context: { ...(kbSprintContext || {}) },
270
+ captureChannel: true,
271
+ })
272
+ : undefined,
245
273
  }),
246
274
  resumePrompt: 'Continue your final review exactly where you left off in this same session -- do not restart or re-read the diff from scratch. Weigh the remaining evidence and return your final PASS/FAIL verdict now (with newTasks findings if FAIL).',
247
275
  roleLabel: 'Final Review',
@@ -249,6 +277,27 @@ export async function runFinalReviewPhase({
249
277
  resumeLabel: `Final Review (resume, max_turns=${TURN_BASES.FINAL_REVIEW_MAX_TURNS * 2})`,
250
278
  });
251
279
  finalVerdictResult = finalReviewOutcome.value;
280
+ // apra-fleet-b4g.102.1: a sprint whose last cycle's deploy failed never
281
+ // reaches Integration Test against a deployed build, so it can never PASS
282
+ // -- enforced here by the orchestrator rather than trusted to the LLM.
283
+ // Applied BEFORE anything below reads the verdict, so Publish PR (title,
284
+ // body), the analysis doc and the run status all see the forced FAIL.
285
+ if (lastDeployFailure) {
286
+ const llmVerdict = finalVerdictResult && finalVerdictResult.verdict;
287
+ finalVerdictResult = applyDeployFailureVerdictGate(finalVerdictResult, lastDeployFailure);
288
+ log(`Final Review: sprint verdict forced to FAIL (Final Review returned ${llmVerdict ?? '(none)'}) -- ${formatDeployFailureReason(lastDeployFailure)}`);
289
+ }
290
+ if (verifyBlockDiagnosis) {
291
+ const llmVerdict = finalVerdictResult && finalVerdictResult.verdict;
292
+ finalVerdictResult = applyVerifyBlockVerdictGate(finalVerdictResult, verifyBlockDiagnosis);
293
+ log(`Final Review: sprint verdict forced to FAIL (Final Review returned ${llmVerdict ?? '(none)'}) -- ${verifyBlockDiagnosis}`);
294
+ }
295
+ if (finalVerdictResult && Array.isArray(reclaimCappedIds) && reclaimCappedIds.length > 0) {
296
+ const cappedNote = `${reclaimCappedIds.length} bead(s) were left 'in_progress' by failed doer streaks of this sprint more often than the re-dispatch cap allows and were NOT re-laned again -- needs human investigation: ${reclaimCappedIds.join(', ')}.`;
297
+ const prior = typeof finalVerdictResult.notes === 'string' ? finalVerdictResult.notes : '';
298
+ finalVerdictResult = { ...finalVerdictResult, notes: prior ? `${prior}\n\n${cappedNote}` : cappedNote };
299
+ log(`Final Review: ${cappedNote}`);
300
+ }
252
301
  // No duplicate log() dump -- see dispatchReview() for why.
253
302
  // `finalVerdictResult.verdict` also surfaces via the generic,
254
303
  // workflow-agnostic Result strip in the dashboard header (state.result --
@@ -265,11 +314,24 @@ export async function runFinalReviewPhase({
265
314
  // fabricated by the engine and carries no KB fields at all, so there is
266
315
  // nothing to apply.
267
316
 
268
- // Publish what this sprint confirmed. Immediately after the LAST promotion
269
- // of the run, so the bible carries every CONFIRMED entry including the ones
270
- // minted a line above. Without this the sprint's knowledge never left the
271
- // member's local sqlite store -- see createKbWorkClient.exportBible.
272
- await kbWork.exportBible(finalReviewRepoPath);
317
+ // Commit the final review round's confirmations to the bible on each
318
+ // repository's kb_maintainer (G-pull, kb_bible_commit, G-push) -- unless
319
+ // the verdict is FAIL: a FAIL sprint commits nothing further to the bible
320
+ // and its queued confirmations are not flushed. A degraded FAIL counts
321
+ // too: the engine fabricated it, so no reviewer stood behind it.
322
+ //
323
+ // Writes still queued behind a busy maintainer get one last attempt
324
+ // first (the commit itself applies them before committing); any that
325
+ // remain (an unreachable maintainer) are reported with a WARN, never
326
+ // dropped silently.
327
+ if (finalVerdictResult && finalVerdictResult.verdict === 'FAIL') {
328
+ if (typeof kbWork.seal === 'function') kbWork.seal('final review verdict FAIL');
329
+ } else if (typeof kbWork.commitRound === 'function') {
330
+ await kbWork.commitRound('final review');
331
+ } else if (typeof kbWork.flushAll === 'function') {
332
+ await kbWork.flushAll();
333
+ }
334
+ if (typeof kbWork.warnPending === 'function') kbWork.warnPending();
273
335
 
274
336
  // Persist the Final Review's actionable findings to BEADS -- the only
275
337
  // artifact the next sprint's planner reads (notes reach only the PR body
@@ -296,7 +358,7 @@ export async function runFinalReviewPhase({
296
358
  // degrades to the run log.
297
359
  try {
298
360
  await appendRejectedFindingToParentNotes({
299
- command, member: orchestratorMember, parentId: targetIssues[0],
361
+ command, member: backlogMember, parentId: targetIssues[0],
300
362
  newTask, reason: validation.reason, cycle: finalCycleLabel, log,
301
363
  });
302
364
  } catch (noteErr) {
@@ -306,12 +368,12 @@ export async function runFinalReviewPhase({
306
368
  }
307
369
  const { title, description, priority } = validation;
308
370
  const created = await persistNewTaskBestEffort({
309
- command, member: orchestratorMember, parentId: targetIssues[0],
371
+ command, member: backlogMember, parentId: targetIssues[0],
310
372
  newTask, cycle: finalCycleLabel, log, stage: 'final-review',
311
373
  createFn: async () => {
312
- const floor = await computeChildFloor({ command, member: orchestratorMember, parentId: targetIssues[0], log });
374
+ const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
313
375
  return createChildBeadWithAllocatedId({
314
- command, allocator: childIdAllocator, member: orchestratorMember,
376
+ command, allocator: childIdAllocator, member: backlogMember,
315
377
  title, description, priority, parentId: targetIssues[0],
316
378
  sprintId: sprintMutexId, floor, log,
317
379
  label: `Create follow-up task from Final Review findings: ${title}`,
@@ -349,7 +411,8 @@ export async function runFinalReviewPhase({
349
411
  const reopenedIds = await applyGuardedReopens({
350
412
  entries: finalReopenIds,
351
413
  bdListScoped, goalMax, goal: validated.goal, log, command,
352
- member: orchestratorMember,
414
+ member: backlogMember,
415
+ workedOnIds,
353
416
  logPrefix: 'Final Review reopenIds',
354
417
  parseEntry: parseIdWithReasonEntry,
355
418
  buildReopenCommand: ({ id, reason }) => {
@@ -389,7 +452,7 @@ export async function runFinalReviewPhase({
389
452
  // "safe to pause" while the Final Review findings were mid-push.
390
453
  // pushBeadsAfter() is the bracketed entry point -- there is no
391
454
  // unbracketed way to reach doltPushAfter() from this file any more.
392
- await gitSync.pushBeadsAfter(orchestratorMember, { pushBeads: true });
455
+ await gitSync.pushBeadsAfter(backlogMember, { pushBeads: true });
393
456
  }
394
457
 
395
458
  return {
@@ -19,7 +19,7 @@
19
19
  // summary is folded into docs/sprint-analysis-<slug>.md through
20
20
  // buildAnalysisText() -- harvesting first would publish an analysis document
21
21
  // with a hole where the regression section belongs. BEFORE Publish PR, because
22
- // the harvester is a code-writing role: the docs/changelog/sprint-analysis
22
+ // the harvester is a code-writing role: the docs/sprint-analysis
23
23
  // commits it makes must be pushed before Publish PR pushes the branch and
24
24
  // raises the PR a human will read. That ordering is structural here, not a
25
25
  // comment: ./publish-pr.mjs's call site sits below this one in runner.js and
@@ -46,9 +46,16 @@
46
46
  // import; dispatchRole/TURN_BASES and buildHarvesterPrompt live in real sibling
47
47
  // modules and are imported directly.
48
48
  //
49
+ // THE COST BLOCK IS ENGINE-RENDERED, NOT HARVESTER-WRITTEN. It is NOT part of
50
+ // analysisText (the harvester commits that text to the product branch, and
51
+ // spend data does not belong there); it is returned for ./publish-pr.mjs to
52
+ // render in the PR body. The harvester no
53
+ // longer writes a CHANGELOG entry: a shared, prepend-only file conflicted on
54
+ // every concurrent sprint PR merge.
55
+ //
49
56
  // GUARD COVERAGE: registered as 'phases/harvest.mjs' in ../guarded-modules.mjs.
50
57
  // It took NO member_name-bearing command() call site out of runner.js -- the
51
- // docs/changelog commits are made by the DISPATCHED harvester inside its own
58
+ // docs commits are made by the DISPATCHED harvester inside its own
52
59
  // repo, and its pushes are the policy row's bracket -- but it took ONE
53
60
  // dispatchRole() site (the harvester ladder), which is exactly what
54
61
  // dispatch-safety-guard and the phase 3 dispatch census read. Both baselines
@@ -62,13 +69,13 @@ import { buildHarvesterPrompt } from '../prompts.mjs';
62
69
  * Runs the Harvest phase: assemble the sprint-analysis inputs, dispatch the
63
70
  * harvester ladder, and log what it reported.
64
71
  *
65
- * Returns nothing. Everything this phase produces is either written to the
66
- * repo by the dispatched harvester itself (docs/, CHANGELOG, the deferred
67
- * beads) or already logged here -- no later phase reads a value from it, which
68
- * is why ./publish-pr.mjs's inputs are unchanged by its presence.
72
+ * Everything else this phase produces is written to the repo by the dispatched
73
+ * harvester itself (docs/, the deferred beads) or already logged here. The one
74
+ * value a later phase reads is the cost block, which ./publish-pr.mjs renders
75
+ * in the PR body.
69
76
  *
70
77
  * @param {object} state Explicit phase state; see this file's header.
71
- * @returns {Promise<void>}
78
+ * @returns {Promise<{ costAnalysis: string }>}
72
79
  */
73
80
  export async function runHarvestPhase({
74
81
  // Presentation + dispatch seams.
@@ -94,6 +101,11 @@ export async function runHarvestPhase({
94
101
  finalOpenAtGoalCount,
95
102
  finalDeferredAtGoalIds,
96
103
  regressionResult,
104
+ regressionSkippedBy = null,
105
+ // Sprint state's per-dispatch kb_* and code_* call records (dispatch-accounting.mjs).
106
+ dispatchToolCalls = null,
107
+ // The KB work client: the harvest round's bible commit runs through it.
108
+ kbWork = null,
97
109
  // Defined BY runner.js; injected to avoid a circular import (see header).
98
110
  computeBranchSlug,
99
111
  buildAnalysisText,
@@ -112,7 +124,7 @@ export async function runHarvestPhase({
112
124
  // this path if it exists.
113
125
  const branchSlug = computeBranchSlug(validated.branch);
114
126
  const analysisArtifactFile = `docs/sprint-analysis-${branchSlug}.md`;
115
- const analysisText = buildAnalysisText({
127
+ const reportText = buildAnalysisText({
116
128
  targetIssues,
117
129
  branch: validated.branch,
118
130
  baseBranch: validated.baseBranch,
@@ -127,18 +139,26 @@ export async function runHarvestPhase({
127
139
  finalOpenAtGoalCount,
128
140
  finalDeferredAtGoalIds,
129
141
  regressionResult,
142
+ regressionSkippedBy,
143
+ dispatchToolCalls,
144
+ // Confirmations the final review round's bible commit could not
145
+ // publish -- persisted here so the warning outlives the live log.
146
+ kbBibleUnpublished: kbWork && typeof kbWork.unpublishedBible === 'function' ? kbWork.unpublishedBible() : null,
130
147
  });
131
148
  const costAnalysis = buildCostAnalysis(budget, {
132
149
  spend: integTestRunnerSpend,
133
150
  dispatchCount: integTestRunnerDispatchCount,
134
151
  });
152
+ // The harvester commits analysisText to the product branch, so it carries
153
+ // the sprint report ONLY: spend data stays out of the repository. The cost
154
+ // block is returned below for Publish PR, which renders it in the PR body.
155
+ const analysisText = reportText;
135
156
  const harvesterPrompt = buildHarvesterPrompt({
136
157
  branch: validated.branch,
137
158
  baseBranch: validated.baseBranch,
138
159
  targetIssues,
139
160
  analysisArtifactFile,
140
161
  analysisText,
141
- costAnalysis,
142
162
  });
143
163
  // apra-fleet-3swo.5.7: the harvester ladder -- its dispatch, its
144
164
  // pushCode/pushBeads git-sync bracket, its max_turns-exhaustion resume at
@@ -149,14 +169,14 @@ export async function runHarvestPhase({
149
169
  // labels, and what the caller does with the report.
150
170
  //
151
171
  // The harvester is a code-writing role (pushCode: true) alongside the doer
152
- // -- G-pull before, G-push after so the docs/changelog/sprint-analysis
172
+ // -- G-pull before, G-push after so the docs/sprint-analysis
153
173
  // commits it makes are published before anything downstream (Publish PR,
154
174
  // below) reads the branch. It ALSO mutates beads (issue-defer of
155
175
  // low-priority items), so it D-pushes those mutations alongside its git
156
176
  // push. Both flags live in the policy row now.
157
177
  const harvestOutcome = await dispatchRole(dispatchCtx, 'harvester', {
158
178
  prompt: harvesterPrompt,
159
- resumePrompt: 'Continue your harvest exactly where you left off in this same session -- do not redo docs or changelog sections already written. Finish the remaining updates, commit them, and return your final report now.',
179
+ resumePrompt: 'Continue your harvest exactly where you left off in this same session -- do not redo docs sections already written. Finish the remaining updates, commit them, and return your final report now.',
160
180
  roleLabel: 'Harvester',
161
181
  resumeLabel: `Harvest (resume, max_turns=${TURN_BASES.HARVESTER_MAX_TURNS * 2})`,
162
182
  });
@@ -177,4 +197,16 @@ export async function runHarvestPhase({
177
197
  } else {
178
198
  log(`Harvester: wrote sprint analysis (including the Final Review verdict) to ${analysisArtifactFile}.`);
179
199
  }
200
+
201
+ // The harvest round's bible commit: confirmations still pending (a
202
+ // maintainer that was busy or whose push failed in an earlier round) go
203
+ // to the bible on each repository's kb_maintainer -- G-pull,
204
+ // kb_bible_commit, G-push. A no-op after a FAIL verdict or with nothing
205
+ // pending. Runs after the harvester's own G-push, so its commits are on
206
+ // the branch the bible commit lands on.
207
+ if (kbWork && typeof kbWork.commitRound === 'function') {
208
+ await kbWork.commitRound('harvest');
209
+ if (typeof kbWork.warnPending === 'function') kbWork.warnPending();
210
+ }
211
+ return { costAnalysis };
180
212
  }