@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
@@ -65,11 +65,34 @@
65
65
  // which stays there because the Re-Review and Final Review phases call it too.
66
66
  // =============================================================================
67
67
 
68
- import { applyGuardedReopens, foldReplanIds } from '../beads-transitions.mjs';
68
+ import { applyGuardedReopens, foldReplanIds, ensureRedBranchFixTask, isInGoalPriority } from '../beads-transitions.mjs';
69
69
  import {
70
70
  validateNewTask, appendRejectedFindingToParentNotes, persistNewTaskBestEffort,
71
71
  } from '../abort.mjs';
72
72
 
73
+ /**
74
+ * The bead ids a round's Review covers: the union of every streak outcome's
75
+ * `closedIds` (the ENGINE's read-back of the shared beads DB -- the
76
+ * verify-streak-closed step on success, verifyDoerStreakClosed on the error
77
+ * path; never the doer's own claim), de-duplicated, minus outcomes whose
78
+ * closes were not published (`publishBlocked` for a permission-scope G-push
79
+ * refusal, `postDispatchSyncFailed` for any other post-dispatch sync failure:
80
+ * a failed G-push skips the D-push, so those closes never reached the shared
81
+ * DB). A failed or BLOCKED streak therefore still contributes the beads it
82
+ * verifiably closed; one that closed nothing contributes nothing.
83
+ *
84
+ * @param {object[]} streakOutcomes
85
+ * @returns {string[]} de-duplicated bead ids, in first-seen order
86
+ */
87
+ export function reviewScopeBeadIds(streakOutcomes) {
88
+ const seen = new Set();
89
+ for (const o of streakOutcomes || []) {
90
+ if (!o || o.publishBlocked || o.postDispatchSyncFailed) continue;
91
+ for (const id of Array.isArray(o.closedIds) ? o.closedIds : []) seen.add(id);
92
+ }
93
+ return [...seen];
94
+ }
95
+
73
96
  /**
74
97
  * Runs ONE Review round: reviewer dispatch plus the orchestrator-applied
75
98
  * transitions its verdict asks for.
@@ -93,7 +116,7 @@ export async function runReviewPhase({
93
116
  cycle,
94
117
  validated,
95
118
  targetIssues,
96
- orchestratorMember,
119
+ backlogMember,
97
120
  // The git/beads sync bracket this phase's post-mutation D-push goes
98
121
  // through.
99
122
  gitSync,
@@ -117,6 +140,9 @@ export async function runReviewPhase({
117
140
  dispatchReview,
118
141
  bdListScoped,
119
142
  goalMax,
143
+ // Bead ids this sprint has dispatched or closed: a below-goal reopen of
144
+ // one of them is applied, not deferred (see isDeferredScopeReopen).
145
+ workedOnIds,
120
146
  recordReopen,
121
147
  childIdAllocator,
122
148
  sprintMutexId,
@@ -130,16 +156,17 @@ export async function runReviewPhase({
130
156
  // Sort by (title, id) -- not raw outcome-recording order -- so this
131
157
  // evidence-gathering step is deterministic. See the readyTitleById
132
158
  // comment just above.
133
- // Failed streaks' beadIds are excluded from this round's review
134
- // scope.
135
- const assignedBeadIds = streakOutcomes.filter((o) => o.outcome !== 'failed').flatMap((o) => o.beadIds)
159
+ // Review scope = every bead the engine's own read-back confirmed
160
+ // closed AND published (see reviewScopeBeadIds), including beads a
161
+ // failed or BLOCKED streak closed before it stopped.
162
+ const assignedBeadIds = reviewScopeBeadIds(streakOutcomes)
136
163
  .slice().sort((a, b) => {
137
164
  const ta = readyTitleById.get(a) || a;
138
165
  const tb = readyTitleById.get(b) || b;
139
166
  return ta.localeCompare(tb) || a.localeCompare(b);
140
167
  });
141
168
  const acceptanceCriteriaJson = assignedBeadIds.length > 0
142
- ? await command(`bd show ${assignedBeadIds.join(' ')} --json`, { member_name: orchestratorMember, silent: true })
169
+ ? await command(`bd show ${assignedBeadIds.join(' ')} --json`, { member_name: backlogMember, silent: true })
143
170
  : '[]';
144
171
 
145
172
  // Empty-guard: when EVERY streak this round failed, assignedBeadIds
@@ -196,7 +223,8 @@ export async function runReviewPhase({
196
223
  const reopenedIds = new Set(await applyGuardedReopens({
197
224
  entries: verdict.reopenIds,
198
225
  bdListScoped, goalMax, goal: validated.goal, log, command,
199
- member: orchestratorMember,
226
+ member: backlogMember,
227
+ workedOnIds,
200
228
  logPrefix: 'Reviewer reopenIds',
201
229
  buildReopenCommand: ({ id }) => ({
202
230
  cmd: `bd update ${id} --status=open`,
@@ -233,6 +261,10 @@ export async function runReviewPhase({
233
261
  })) {
234
262
  replanIds.add(id);
235
263
  }
264
+ // newTasks that landed at an in-goal priority -- one of these (or a
265
+ // surviving reopen) is what keeps a red branch from being left with no
266
+ // dispatchable work (see ensureRedBranchFixTask below).
267
+ let inGoalNewTaskCount = 0;
236
268
  for (const newTask of verdict.newTasks) {
237
269
  // Validate BEFORE interpolation -- see validateNewTask() above
238
270
  // for why this is an allowlist, not escaping. A rejection is
@@ -255,7 +287,7 @@ export async function runReviewPhase({
255
287
  // never an abort).
256
288
  try {
257
289
  await appendRejectedFindingToParentNotes({
258
- command, member: orchestratorMember, parentId: targetIssues[0],
290
+ command, member: backlogMember, parentId: targetIssues[0],
259
291
  newTask, reason: validation.reason, cycle, log,
260
292
  });
261
293
  } catch (noteErr) {
@@ -272,12 +304,12 @@ export async function runReviewPhase({
272
304
  // parent never derive the same child id. Under the null client
273
305
  // (lone sprint) childId is null and bd derives the id as before.
274
306
  const persisted = await persistNewTaskBestEffort({
275
- command, member: orchestratorMember, parentId: targetIssues[0],
307
+ command, member: backlogMember, parentId: targetIssues[0],
276
308
  newTask, cycle, log, stage: 'develop-review',
277
309
  createFn: async () => {
278
- const floor = await computeChildFloor({ command, member: orchestratorMember, parentId: targetIssues[0], log });
310
+ const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
279
311
  await createChildBeadWithAllocatedId({
280
- command, allocator: childIdAllocator, member: orchestratorMember,
312
+ command, allocator: childIdAllocator, member: backlogMember,
281
313
  title, description, priority, parentId: targetIssues[0],
282
314
  sprintId: sprintMutexId, floor, log,
283
315
  label: `Create follow-up task from reviewer newTasks: ${title}`,
@@ -292,13 +324,41 @@ export async function runReviewPhase({
292
324
  // unchanged description.
293
325
  if (persisted) {
294
326
  pendingRejectedNewTasks = clearResubmittedNewTask(pendingRejectedNewTasks, { title, description });
327
+ if (isInGoalPriority(priority, goalMax)) inGoalNewTaskCount += 1;
295
328
  }
296
329
  }
297
330
 
331
+ // A red branch must never be left with zero open work: when the verdict
332
+ // reports failing build/tests and no reopen or in-goal newTask survived
333
+ // (all filtered by the goal-scope guard, or none named), file one in-goal
334
+ // fix task carrying the reviewer's notes.
335
+ await ensureRedBranchFixTask({
336
+ verdict,
337
+ reopenedCount: reopenedIds.size,
338
+ inGoalNewTaskCount,
339
+ skippedReopenIds: (verdict.reopenIds || []).filter((id) => typeof id === 'string' && !reopenedIds.has(id)),
340
+ goal: validated.goal,
341
+ site: `Review C${cycle} R${devRounds}`,
342
+ bdListScoped, log,
343
+ createTask: (task) => persistNewTaskBestEffort({
344
+ command, member: backlogMember, parentId: targetIssues[0],
345
+ newTask: task, cycle, log, stage: 'develop-review-red-branch',
346
+ createFn: async () => {
347
+ const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
348
+ return createChildBeadWithAllocatedId({
349
+ command, allocator: childIdAllocator, member: backlogMember,
350
+ title: task.title, description: task.description, priority: task.priority,
351
+ parentId: targetIssues[0], sprintId: sprintMutexId, floor, log,
352
+ label: `Create red-branch fix task: ${task.title}`,
353
+ });
354
+ },
355
+ }),
356
+ });
357
+
298
358
  // The orchestrator just MUTATED beads (reopens + newTask creates) in
299
359
  // its own clone -- D-push so members observe them on their next
300
360
  // dispatch's D-pull.
301
- await gitSync.syncBeadsAfter(orchestratorMember, { pushBeads: true });
361
+ await gitSync.syncBeadsAfter(backlogMember, { pushBeads: true });
302
362
  } // end assignedBeadIds.length > 0 (Review dispatch + orchestrator-applied transitions)
303
363
 
304
364
  return { lastReviewVerdict, reviewedThisCycle, pendingRejectedNewTasks };
@@ -0,0 +1,259 @@
1
+ // Sprint pull-request title/body builder for the Publish PR step and the
2
+ // [ABORTED] PR path (abort.mjs). Pure: no I/O, no clock reads unless the
3
+ // caller omits `now`.
4
+ //
5
+ // WHY THIS EXISTS. The PR body used to embed the final reviewer's notes
6
+ // through sanitizePrText() (sprint-report.mjs), a single-line shell-argument
7
+ // sanitizer that maps every newline to a space and collapses all whitespace
8
+ // -- so a reviewer's paragraphs and bullet list reached the PR as one
9
+ // unreadable paragraph. The body never needed that: every provider's
10
+ // create/update-pull-request builder JSON-encodes the body (newlines become
11
+ // the two characters `\n`) and quotes the JSON per member shell
12
+ // (vcs-providers/shell-helpers.mjs shQuoteJson), so a multi-line body is
13
+ // already transport-safe. What untrusted text DOES still need is
14
+ // markdown/transport hygiene, which sanitizePrMarkdown() below provides while
15
+ // keeping line structure.
16
+ //
17
+ // RUN HISTORY. Each sprint end rewrites the PR title/body with its own
18
+ // verdict; earlier runs are carried forward compactly in a hidden,
19
+ // engine-written HTML comment block (RUN_HISTORY_MARKER) that the next run
20
+ // parses back. A body without the block (a PR created before this format, or
21
+ // hand-edited) simply starts a fresh history.
22
+ //
23
+ // ASCII only.
24
+
25
+ import { PR_DESCRIPTION_MAX_LENGTH } from './vcs-module.mjs';
26
+
27
+ /** Opening token of the hidden run-history block. Versioned so a future
28
+ * format change can tell its own blocks from this one. */
29
+ export const RUN_HISTORY_MARKER = 'fleet-sprint:run-history v1';
30
+
31
+ /** Total runs (current + previous) kept in the history block. */
32
+ export const RUN_HISTORY_MAX_ENTRIES = 8;
33
+
34
+ /** Upper bound on the reviewer-notes section before the whole-body budget
35
+ * (PR_DESCRIPTION_MAX_LENGTH) is even considered. */
36
+ export const PR_NOTES_MAX_LENGTH = 2000;
37
+
38
+ const VERDICTS = new Set(['PASS', 'FAIL', 'ABORTED']);
39
+ const RUN_ID_UNSAFE_RE = /[^A-Za-z0-9._:/-]/g;
40
+ const RUN_ID_MAX = 64;
41
+ const DATE_RE = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}Z)?$/;
42
+ const HUMAN_REVIEW_LINE = 'Do NOT auto-merge -- see pm skill R12; a human must review and merge this PR.';
43
+
44
+ // Common typographic code points LLM text carries, mapped to ASCII so the
45
+ // body stays ASCII end to end (PowerShell 5.1 argv and some REST stacks do
46
+ // not round-trip arbitrary UTF-8 reliably). Anything else non-ASCII becomes
47
+ // '?'.
48
+ const ASCII_MAP = new Map([
49
+ [0x2018, "'"], [0x2019, "'"], [0x201A, "'"], [0x201B, "'"],
50
+ [0x201C, '"'], [0x201D, '"'], [0x201E, '"'], [0x201F, '"'],
51
+ [0x2010, '-'], [0x2011, '-'], [0x2012, '-'], [0x2013, '-'], [0x2014, '--'], [0x2015, '--'],
52
+ [0x2026, '...'], [0x2022, '-'], [0x00B7, '-'], [0x00A0, ' '], [0x2009, ' '], [0x202F, ' '],
53
+ [0x2192, '->'], [0x2190, '<-'], [0x21D2, '=>'], [0x2264, '<='], [0x2265, '>='], [0x2260, '!='],
54
+ [0x2713, '[OK]'], [0x2714, '[OK]'], [0x2705, '[OK]'], [0x2717, '[X]'], [0x2718, '[X]'], [0x274C, '[X]'],
55
+ [0x00D7, 'x'],
56
+ ].map(([cp, ascii]) => [String.fromCodePoint(cp), ascii]));
57
+
58
+ /**
59
+ * Makes untrusted (LLM-authored) text safe to place inside the PR body while
60
+ * PRESERVING its paragraphs, bullet lists and line breaks:
61
+ * - CRLF/CR -> LF; tabs -> two spaces; other control characters dropped;
62
+ * - non-ASCII mapped to ASCII (see ASCII_MAP) or '?';
63
+ * - '<' -> '&lt;' so no raw HTML, HTML comment (which could swallow the rest
64
+ * of the body or forge the run-history block) or autolink passes through;
65
+ * - '{{' / '}}' broken apart: the server-side credential handoff substitutes
66
+ * '{{...}}' placeholders anywhere in the dispatched command, so a note
67
+ * must never be able to spell one;
68
+ * - ATX headings ('# x') and setext '===' underlines escaped so the notes
69
+ * cannot outrank the body's own section headings;
70
+ * - runs of 3+ blank lines collapsed to one blank line.
71
+ * Code fences are balanced separately (closeOpenFences) AFTER any truncation.
72
+ * @param {unknown} text
73
+ * @returns {string}
74
+ */
75
+ export function sanitizePrMarkdown(text) {
76
+ let s = String(text ?? '').replace(/\r\n?/g, '\n').replace(/\t/g, ' ');
77
+ let out = '';
78
+ for (const ch of s) {
79
+ const code = ch.codePointAt(0);
80
+ if (ch === '\n') out += ch;
81
+ else if (code < 0x20 || code === 0x7f) continue;
82
+ else if (code < 0x7f) out += ch;
83
+ else out += ASCII_MAP.has(ch) ? ASCII_MAP.get(ch) : '?';
84
+ }
85
+ s = out.replace(/</g, '&lt;');
86
+ while (/\{\{|\}\}/.test(s)) s = s.replace(/\{\{/g, '{ {').replace(/\}\}/g, '} }');
87
+ s = s.split('\n').map((line) => line
88
+ .replace(/[ ]+$/, '')
89
+ .replace(/^( {0,3})(#{1,6})(?=\s|$)/, (_m, indent, marks) => indent + '\\' + marks)
90
+ .replace(/^( {0,3})(=+)$/, (_m, indent, marks) => indent + '\\' + marks))
91
+ .join('\n');
92
+ return s.replace(/\n{3,}/g, '\n\n').trim();
93
+ }
94
+
95
+ /** Appends a closing fence when `text` leaves a ``` / ~~~ code fence open, so
96
+ * untrusted notes can never swallow the sections that follow them. */
97
+ export function closeOpenFences(text) {
98
+ let open = null;
99
+ for (const line of String(text).split('\n')) {
100
+ const m = /^ {0,3}(`{3,}|~{3,})/.exec(line);
101
+ if (!m) continue;
102
+ if (!open) {
103
+ open = m[1];
104
+ } else if (m[1][0] === open[0] && m[1].length >= open.length && /^ {0,3}(`{3,}|~{3,})\s*$/.test(line)) {
105
+ open = null;
106
+ }
107
+ }
108
+ return open ? `${text}\n${open}` : text;
109
+ }
110
+
111
+ /** Caps already-sanitized notes at `max` characters, cutting at a line
112
+ * boundary when one is reasonably close, with a visible marker. */
113
+ export function capNotes(text, max) {
114
+ const total = text.length;
115
+ if (total <= max) return closeOpenFences(text);
116
+ let cut = text.slice(0, Math.max(0, max));
117
+ const nl = cut.lastIndexOf('\n');
118
+ if (nl > max * 0.5) cut = cut.slice(0, nl);
119
+ cut = closeOpenFences(cut.replace(/\s+$/, ''));
120
+ return `${cut}\n\n*[... reviewer notes truncated: ${cut.length} of ${total} characters shown ...]*`;
121
+ }
122
+
123
+ /** Normalizes a run id to the history-safe charset. */
124
+ export function normalizeRunId(runId) {
125
+ const v = String(runId ?? '').trim().replace(RUN_ID_UNSAFE_RE, '-').slice(0, RUN_ID_MAX);
126
+ return v || 'unnamed-run';
127
+ }
128
+
129
+ /** UTC minute stamp, e.g. 2026-10-01T09:30Z. */
130
+ export function runStamp(now = new Date()) {
131
+ return `${now.toISOString().slice(0, 16)}Z`;
132
+ }
133
+
134
+ /**
135
+ * Reads the run-history block back out of an existing PR body. Returns [] for
136
+ * a body with no block, a malformed block, or no valid entries -- never
137
+ * throws. Every entry is re-validated (the body is editable by anyone with
138
+ * PR write access), so only well-formed { run, date, verdict } survive.
139
+ * @param {unknown} body
140
+ * @returns {Array<{ run: string, date: string, verdict: string }>}
141
+ */
142
+ export function parseRunHistory(body) {
143
+ const text = String(body ?? '');
144
+ // \r?\n: a body saved from a web editor (GitHub's PR edit box) comes back
145
+ // with CRLF line endings; that must not silently reset the history.
146
+ const re = /<!-- fleet-sprint:run-history v1\r?\n([\s\S]*?)\r?\n-->/g;
147
+ let last = null;
148
+ for (const m of text.matchAll(re)) last = m[1];
149
+ if (last === null) return [];
150
+ let parsed;
151
+ try {
152
+ parsed = JSON.parse(last);
153
+ } catch {
154
+ return [];
155
+ }
156
+ if (!Array.isArray(parsed)) return [];
157
+ const out = [];
158
+ for (const e of parsed) {
159
+ if (!e || typeof e !== 'object') continue;
160
+ const run = typeof e.run === 'string' ? normalizeRunId(e.run) : null;
161
+ const date = typeof e.date === 'string' && DATE_RE.test(e.date) ? e.date : null;
162
+ const verdict = typeof e.verdict === 'string' && VERDICTS.has(e.verdict) ? e.verdict : null;
163
+ if (run && date && verdict) out.push({ run, date, verdict });
164
+ if (out.length >= RUN_HISTORY_MAX_ENTRIES) break;
165
+ }
166
+ return out;
167
+ }
168
+
169
+ /** `fleet-sprint [<VERDICT>]: <branch>`. PRs opened before the rename carry the
170
+ * older `Auto-sprint [<VERDICT>]: <branch>` form; nothing in-repo matches on the
171
+ * title (an existing PR is found by head branch), so both forms coexist safely. */
172
+ export function buildSprintPrTitle({ verdict, branch }) {
173
+ return `fleet-sprint [${verdict}]: ${branch}`;
174
+ }
175
+
176
+ /** Markdown inline code span. Only ever applied to engine-validated tokens
177
+ * (branch names, normalized run ids), which cannot contain a backtick. */
178
+ function codeSpan(text) {
179
+ // shell-guard-allow: markdown inline-code backticks in PR body text (JSON-encoded into a curl -d payload by the VCS builders), never a command string evaluated by a shell.
180
+ return '`' + text + '`';
181
+ }
182
+
183
+ function inline(text) {
184
+ return sanitizePrMarkdown(text).replace(/\s*\n\s*/g, ' ');
185
+ }
186
+
187
+ /**
188
+ * Builds the sprint PR body as markdown.
189
+ *
190
+ * @param {object} opts
191
+ * @param {'PASS'|'FAIL'|'ABORTED'} opts.verdict
192
+ * @param {string} [opts.goal]
193
+ * @param {string} opts.branch
194
+ * @param {string} [opts.baseBranch]
195
+ * @param {string} [opts.runId]
196
+ * @param {Date} [opts.now]
197
+ * @param {string} [opts.notes] untrusted free text (reviewer notes / abort detail)
198
+ * @param {string} [opts.notesHeading]
199
+ * @param {string[]} [opts.details] engine-authored detail lines, rendered as list items
200
+ * @param {string} [opts.costAnalysis] engine-computed cost block, rendered in a fenced Cost section
201
+ * @param {string} [opts.previousBody] the existing PR's body, for history carry-forward
202
+ * @param {number} [opts.maxLength]
203
+ * @returns {string}
204
+ */
205
+ export function buildSprintPrBody({
206
+ verdict, goal, branch, baseBranch, runId, now = new Date(),
207
+ notes, notesHeading = 'Reviewer notes', details = [], costAnalysis = '', previousBody = '',
208
+ maxLength = PR_DESCRIPTION_MAX_LENGTH,
209
+ }) {
210
+ const v = VERDICTS.has(verdict) ? verdict : 'FAIL';
211
+ const run = normalizeRunId(runId);
212
+ const stamp = runStamp(now);
213
+ const history = [{ run, date: stamp, verdict: v }];
214
+ for (const e of parseRunHistory(previousBody)) {
215
+ if (history.length >= RUN_HISTORY_MAX_ENTRIES) break;
216
+ history.push(e);
217
+ }
218
+ const previous = history.slice(1);
219
+
220
+ const head = [
221
+ `## Sprint verdict: ${v}`,
222
+ '',
223
+ goal ? `- **Goal:** ${inline(goal)}` : null,
224
+ `- **Branch:** ${codeSpan(inline(branch))}${baseBranch ? ` -> ${codeSpan(inline(baseBranch))}` : ''}`,
225
+ `- **Run:** ${codeSpan(run)} (${stamp})`,
226
+ '',
227
+ `### ${notesHeading}`,
228
+ '',
229
+ ].filter((l) => l !== null).join('\n');
230
+
231
+ const detailLines = (details || []).filter(Boolean).map((d) => `- ${inline(d)}`);
232
+ // The cost block replaces the per-sprint CHANGELOG entry the harvester used
233
+ // to write (a shared prepend-only file that conflicted on every merge).
234
+ const cost = sanitizePrMarkdown(costAnalysis);
235
+ const costFence = '`'.repeat(Math.max(3, ...(cost.match(/`+/g) || []).map((r) => r.length + 1)));
236
+ const tail = [
237
+ '',
238
+ detailLines.length ? '### Details\n' : null,
239
+ detailLines.length ? detailLines.join('\n') : null,
240
+ detailLines.length ? '' : null,
241
+ cost ? `### Cost\n\n${costFence}\n${cost}\n${costFence}\n` : null,
242
+ '---',
243
+ '',
244
+ HUMAN_REVIEW_LINE,
245
+ previous.length ? '\n### Previous runs\n' : null,
246
+ previous.length ? previous.map((e) => `- ${codeSpan(e.run)} (${e.date}): ${e.verdict}`).join('\n') : null,
247
+ '',
248
+ `<!-- ${RUN_HISTORY_MARKER}`,
249
+ JSON.stringify(history),
250
+ '-->',
251
+ ].filter((l) => l !== null).join('\n');
252
+
253
+ const cleanNotes = sanitizePrMarkdown(notes);
254
+ const budget = Math.min(PR_NOTES_MAX_LENGTH, maxLength - head.length - tail.length - 120);
255
+ const notesBlock = cleanNotes ? capNotes(cleanNotes, Math.max(200, budget)) : '*No notes were provided.*';
256
+ // Blank lines around the notes keep them their own block: notes ending in
257
+ // a paragraph directly above '---' would otherwise turn into a heading.
258
+ return `${head}\n${notesBlock}\n${tail}`;
259
+ }
@@ -17,6 +17,33 @@ import { PR_DESCRIPTION_MAX_LENGTH } from './vcs-module.mjs';
17
17
  import { formatStalenessBlock } from './parent-notes-staleness.mjs';
18
18
  import { buildRejectedNewTaskResurfaceLines, kbKnowledgeBlock, kbPromotionBlock } from './runner.js';
19
19
 
20
+ /**
21
+ * Deterministic hard cap on the code-reviewer findings text threaded into a
22
+ * scoped in-cycle replan planner prompt (apra-fleet-i4ku): the findings come
23
+ * from a reviewer's free-text verdict.notes, which is not size-bounded at
24
+ * its source, so a named constant -- not prompt-only guidance the model can
25
+ * ignore -- caps the prompt. Mirrors the PR_DESCRIPTION_MAX_LENGTH pattern in
26
+ * vcs-module.mjs: a single exported constant, deterministic truncation to
27
+ * exactly its first N characters, plus a visible marker (boundReplanFindings
28
+ * below) so a truncation is never silent.
29
+ * @type {number}
30
+ */
31
+ export const REPLAN_FINDINGS_MAX_LENGTH = 4000;
32
+
33
+ /**
34
+ * Bounds `text` to REPLAN_FINDINGS_MAX_LENGTH characters, appending a
35
+ * visible truncation marker naming the original length and the cap when
36
+ * truncation occurs. Returns `text` unchanged when already within the cap.
37
+ * @param {string} text
38
+ * @returns {string}
39
+ */
40
+ function boundReplanFindings(text) {
41
+ if (text.length <= REPLAN_FINDINGS_MAX_LENGTH) return text;
42
+ const originalLength = text.length;
43
+ return `${text.slice(0, REPLAN_FINDINGS_MAX_LENGTH)}\n\n` +
44
+ `[TRUNCATED: original length ${originalLength} characters, cap ${REPLAN_FINDINGS_MAX_LENGTH} characters]`;
45
+ }
46
+
20
47
  /**
21
48
  * @param {{
22
49
  * isDeltaCycle: boolean,
@@ -26,13 +53,14 @@ import { buildRejectedNewTaskResurfaceLines, kbKnowledgeBlock, kbPromotionBlock
26
53
  * requirementsContent: string|null,
27
54
  * feedback: string|null,
28
55
  * replanScope?: string[]|null,
56
+ * replanFindings?: string|null,
29
57
  * rejectedNewTasksToResubmit?: Array<{title: string, description: string, reason: string, cycle: number|string}>,
30
58
  * verifyExcluded?: string[],
31
59
  * stalenessNotes?: string[],
32
60
  * }} opts
33
61
  * @returns {string}
34
62
  */
35
- export function buildPlannerPrompt({ isDeltaCycle, targetIssues, goal, requirementsFile, requirementsContent, feedback, replanScope = null, rejectedNewTasksToResubmit = [], verifyExcluded = [], stalenessNotes = [] }) {
63
+ export function buildPlannerPrompt({ isDeltaCycle, targetIssues, goal, requirementsFile, requirementsContent, feedback, replanScope = null, replanFindings = null, rejectedNewTasksToResubmit = [], verifyExcluded = [], stalenessNotes = [] }) {
36
64
  const lines = [];
37
65
 
38
66
  // SCOPED in-cycle replan clause: present ONLY when a reviewer flagged
@@ -40,19 +68,36 @@ export function buildPlannerPrompt({ isDeltaCycle, targetIssues, goal, requireme
40
68
  // from every ordinary full-plan/re-plan dispatch. It narrows the planner to
41
69
  // amending just those beads' criteria/decomposition.
42
70
  const hasReplanScope = Array.isArray(replanScope) && replanScope.length > 0;
71
+ // The findings that TRIGGERED this scoped replan (the code reviewer's
72
+ // verdict.notes for the flagged bead(s), threaded via replan.mjs from
73
+ // perBeadFeedback). Distinct from `feedback` below, which carries
74
+ // plan-reviewer verdicts from a PRIOR planning round -- these are
75
+ // code-reviewer findings from the develop/review loop, so they get their
76
+ // own heading and source label rather than reusing that block. Absent
77
+ // (typeof !== 'string', or blank after trim) in the genuinely
78
+ // findings-free case: no instruction to read them, and no empty block.
79
+ const hasReplanFindings = hasReplanScope && typeof replanFindings === 'string' && replanFindings.trim().length > 0;
43
80
  if (hasReplanScope) {
44
81
  lines.push(
45
82
  'SCOPED IN-CYCLE REPLAN -- this is a NARROW, targeted re-planning pass, not a full ' +
46
83
  'sprint plan. A reviewer flagged the following already-created bead(s) as having ' +
47
84
  'DEFECTIVE ACCEPTANCE CRITERIA that cannot be satisfied by re-development as written: ' +
48
85
  `${replanScope.join(', ')}. Re-scope ONLY these bead(s): read each one\'s current ` +
49
- 'description and the reviewer feedback below, then correct its acceptance criteria in ' +
86
+ 'description' + (hasReplanFindings ? ' and the code reviewer findings below' : '') +
87
+ ', then correct its acceptance criteria in ' +
50
88
  'place (via `bd update`), or -- if it is genuinely too large -- decompose it into ' +
51
89
  'task-type children with clear acceptance criteria and model metadata. Do NOT touch, ' +
52
90
  'reword, re-decompose, close, or create any bead OUTSIDE this flagged set, and do NOT ' +
53
91
  'add scope beyond the original sprint goal. Keep the goalposts fixed: you are fixing a ' +
54
92
  'defect in these specific beads, not re-planning the sprint.'
55
93
  );
94
+ if (hasReplanFindings) {
95
+ lines.push(
96
+ 'Findings from the code reviewer that reopened the flagged bead(s) above and ' +
97
+ 'triggered this scoped re-plan -- address every point raised:'
98
+ );
99
+ lines.push(wrapUntrustedBlock('code-reviewer.findings', boundReplanFindings(replanFindings)));
100
+ }
56
101
  }
57
102
 
58
103
  if (isDeltaCycle) {
@@ -319,10 +364,12 @@ export function buildStreakAssignmentPrompt({ readyBeadIds }) {
319
364
  * `kbKnowledge` carries the entries kb_session_prime returned for this member
320
365
  * (see kbKnowledgeBlock): the doer cannot read the KB itself on a member
321
366
  * dispatch, so this prompt is its only route to prior knowledge.
322
- * @param {{ beadIds: string[], branch: string, feedback: string|null, kbKnowledge?: object[] }} opts
367
+ * `kbBlock`, when an array, is the engine-gated KNOWLEDGE BANK block
368
+ * (kb-injection.mjs) and replaces `kbKnowledge`: [] means none is injected.
369
+ * @param {{ beadIds: string[], branch: string, feedback: string|null, kbKnowledge?: object[], kbBlock?: string[] }} opts
323
370
  * @returns {string}
324
371
  */
325
- export function buildDoerPrompt({ beadIds, branch, feedback, kbKnowledge }) {
372
+ export function buildDoerPrompt({ beadIds, branch, feedback, kbKnowledge, kbBlock }) {
326
373
  const lines = [
327
374
  `Sprint track branch to work on: ${branch}. Work on this branch only; do not push to the base branch.`,
328
375
  `Assigned bead ids (comma-separated): ${beadIds.join(', ')}`,
@@ -339,7 +386,7 @@ export function buildDoerPrompt({ beadIds, branch, feedback, kbKnowledge }) {
339
386
  'workaround whose purpose is to bypass the block, even for a brand-new file and ' +
340
387
  'even if you judge the underlying operation safe. This matches this repo\'s ' +
341
388
  'CLAUDE.md permission-block policy.',
342
- ...kbKnowledgeBlock(kbKnowledge),
389
+ ...(Array.isArray(kbBlock) ? kbBlock : kbKnowledgeBlock(kbKnowledge)),
343
390
  ];
344
391
  if (feedback) {
345
392
  lines.push(
@@ -351,7 +398,7 @@ export function buildDoerPrompt({ beadIds, branch, feedback, kbKnowledge }) {
351
398
  return lines.join('\n\n');
352
399
  }
353
400
 
354
- export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranch, branch, goal, kbCandidates, kbKnowledge }) {
401
+ export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranch, branch, goal, kbCandidates, kbKnowledge, kbBlock }) {
355
402
  const ids = Array.isArray(beadIds) ? beadIds : [];
356
403
  const scopeWide = ids.length === 0;
357
404
  // Scope-wide re-reviews are fed `bd list --json` (the whole remaining
@@ -382,7 +429,11 @@ export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranc
382
429
  `Features/beads BELOW the goal priority (e.g. P3 when the ` +
383
430
  `goal is P1/P2) are DEFERRED BY DESIGN to a later sprint: their absence ` +
384
431
  `from the diff is correct, must not block APPROVED, must not appear in ` +
385
- `reopenIds, and may be mentioned in notes only.`,
432
+ `reopenIds, and may be mentioned in notes only.` +
433
+ (scopeWide
434
+ ? ''
435
+ : ` EXCEPTION: a below-goal bead id named above is this sprint's OWN work -- if it ` +
436
+ `needs rework (for example it broke the build or tests), name it in reopenIds.`),
386
437
  ] : []),
387
438
  // apra-fleet-0ef: the reviewer is the ONLY role permitted to mint
388
439
  // CONFIRMED, but a KB entry id can only come from the KB, and the
@@ -393,7 +444,7 @@ export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranc
393
444
  // Prior knowledge FIRST, then the promotion candidates: the reviewer
394
445
  // judges the work against what the repo already knows before it decides
395
446
  // which of this sprint's captures earned CONFIRMED.
396
- ...kbKnowledgeBlock(kbKnowledge),
447
+ ...(Array.isArray(kbBlock) ? kbBlock : kbKnowledgeBlock(kbKnowledge)),
397
448
  ...kbPromotionBlock(kbCandidates),
398
449
  'Do NOT run any `bd` command yourself and do NOT mutate beads directly in any way ' +
399
450
  '(no bd update, bd close, bd create, etc.) -- the orchestrator applies your ' +
@@ -403,8 +454,11 @@ export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranc
403
454
  're-development) and need a planner pass before the next dispatch, scoped to this ' +
404
455
  'cycle. An id you did not also name in `reopenIds` is dropped and never reaches the ' +
405
456
  'scoped-replan machinery, so only list ids you are reopening. ' +
457
+ 'Set `buildFailing: true` when the build or test suite fails on the branch under review ' +
458
+ '(omit it or set false when they pass): on CHANGES_NEEDED the orchestrator then guarantees ' +
459
+ 'a fix is dispatched even if none of your reopenIds can be reopened. ' +
406
460
  'Return ONLY your structured verdict (verdict, notes, reopenIds, replanIds, ' +
407
- 'newTasks) strictly as the required JSON schema; never touch beads yourself.',
461
+ 'buildFailing, newTasks) strictly as the required JSON schema; never touch beads yourself.',
408
462
  ].join('\n\n');
409
463
  }
410
464
 
@@ -425,7 +479,7 @@ export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranc
425
479
  * }} opts
426
480
  * @returns {string}
427
481
  */
428
- export function buildFinalVerdictPrompt({ targetIssues, branch, baseBranch, goal, cyclesRun, closedCount, openAtGoalCount, deployFailures, integFailures, rejectedNewTasks = [], unclosedVerifyIds = [], deferredAtGoalIds = [], kbCandidates, kbKnowledge }) {
482
+ export function buildFinalVerdictPrompt({ targetIssues, branch, baseBranch, goal, cyclesRun, closedCount, openAtGoalCount, deployFailures, integFailures, rejectedNewTasks = [], unclosedVerifyIds = [], deferredAtGoalIds = [], kbCandidates, kbKnowledge, kbBlock }) {
429
483
  const lines = [
430
484
  `Final review for sprint scope issue id(s): ${targetIssues.join(', ')}.`,
431
485
  `Branch: ${branch} (base: ${baseBranch}). Goal priority: ${goal}. The sprint ran ${cyclesRun} cycle(s).`,
@@ -482,6 +536,12 @@ export function buildFinalVerdictPrompt({ targetIssues, branch, baseBranch, goal
482
536
  `actually in scope, but say so in your notes if deferring any of these means the sprint's stated goal was not really met.`
483
537
  );
484
538
  }
539
+ lines.push(
540
+ 'CI is out of scope for this verdict: if the only criterion still unmet on a bead (including a ' +
541
+ 'verify-routed bead listed above) is a CI-status criterion (for example "CI is green"), that is NOT ' +
542
+ 'a reason to FAIL. Nothing in this sprint triggers, waits for or judges CI. Judge only what the ' +
543
+ 'diff, the tests the sprint ran and the beads evidence show.'
544
+ );
485
545
  lines.push(
486
546
  'Return a PASS/FAIL verdict per your agent contract, grounded in the evidence above -- ' +
487
547
  'never rubber-stamp PASS regardless of open goal-priority beads or deploy/integration failures.'
@@ -526,34 +586,32 @@ export function buildFinalVerdictPrompt({ targetIssues, branch, baseBranch, goal
526
586
  // all (0ef wired kbCandidates through buildReviewerPrompt only), so anything
527
587
  // captured in a sprint's LAST round reached this reviewer and nobody else,
528
588
  // and was stranded at INFERRED forever.
529
- lines.push(...kbKnowledgeBlock(kbKnowledge));
589
+ lines.push(...(Array.isArray(kbBlock) ? kbBlock : kbKnowledgeBlock(kbKnowledge)));
530
590
  lines.push(...kbPromotionBlock(kbCandidates));
531
591
  return lines.join('\n\n');
532
592
  }
533
593
 
534
594
  /**
535
- * Builds the self-contained Harvester dispatch prompt, wiring the five inputs
536
- * harvester.md requires -- analysisArtifactFile, analysisText, costAnalysis,
537
- * baseBranch and branch -- with real, runner-computed values. The vendored
538
- * input schema is deliberately not loosened to accommodate missing values;
539
- * supplying them is the caller's job.
540
- * @param {{ branch: string, baseBranch: string, targetIssues: string[], analysisArtifactFile: string, analysisText: string, costAnalysis: string }} opts
595
+ * Builds the self-contained Harvester dispatch prompt, wiring the four inputs
596
+ * harvester.md requires -- analysisArtifactFile, analysisText, baseBranch and
597
+ * branch -- with real, runner-computed values. The vendored input schema is
598
+ * deliberately not loosened to accommodate missing values; supplying them is
599
+ * the caller's job.
600
+ * @param {{ branch: string, baseBranch: string, targetIssues: string[], analysisArtifactFile: string, analysisText: string }} opts
541
601
  * @returns {string}
542
602
  */
543
- export function buildHarvesterPrompt({ branch, baseBranch, targetIssues, analysisArtifactFile, analysisText, costAnalysis }) {
544
- // analysisText/costAnalysis are orchestrator-computed, not another agent's
545
- // output, so wrapUntrustedBlock does not apply. Each still gets its own
546
- // fence sized past the longest backtick run in that block, so a literal
547
- // fence line inside the content cannot terminate it early.
603
+ export function buildHarvesterPrompt({ branch, baseBranch, targetIssues, analysisArtifactFile, analysisText }) {
604
+ // analysisText is orchestrator-computed, not another agent's output, so
605
+ // wrapUntrustedBlock does not apply. It still gets a fence sized past the
606
+ // longest backtick run in it, so a literal fence line inside the content
607
+ // (the cost block is itself fenced) cannot terminate it early.
548
608
  const fence = (content) => '`'.repeat(Math.max(3, (content.match(/`+/g) || []).reduce((m, r) => Math.max(m, r.length), 0) + 1));
549
609
  const analysisFence = fence(analysisText);
550
- const costFence = fence(costAnalysis);
551
610
  return [
552
611
  `Harvest durable knowledge for sprint scope issue id(s): ${targetIssues.join(', ')}.`,
553
612
  `Branch: ${branch} (base: ${baseBranch}).`,
554
- 'Update docs/, README/CHANGELOG (including a cost-analysis block), and defer low-priority issues, per your agent contract.',
613
+ 'Update docs/ and README, and defer low-priority issues, per your agent contract.',
555
614
  `analysisArtifactFile: ${analysisArtifactFile}`,
556
615
  `analysisText (pre-computed by the orchestrator -- write verbatim to analysisArtifactFile, per Step 1 of your contract):\n${analysisFence}\n${analysisText}\n${analysisFence}`,
557
- `costAnalysis (pre-computed by the orchestrator -- insert verbatim into the CHANGELOG entry, per Step 4 of your contract):\n${costFence}\n${costAnalysis}\n${costFence}`,
558
616
  ].join('\n\n');
559
617
  }