@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,365 @@
1
+ // =============================================================================
2
+ // PHASE MODULE: Review (apra-fleet-3swo.6.5).
3
+ //
4
+ // The FIFTH of runSprintCycle's twelve phase() boundaries -- the per-round
5
+ // REVIEW of the work the Develop phase just produced: gather the round's
6
+ // acceptance criteria, dispatch the reviewer, and then have the ORCHESTRATOR
7
+ // (never the LLM) apply every structured transition the verdict asks for --
8
+ // guarded reopens, the in-cycle replan fold-in, and validated newTask
9
+ // creation -- before D-pushing the beads it just mutated. Moved verbatim out
10
+ // of runner.js: every prompt, log line, dispatch option, validation branch and
11
+ // sync call is byte-identical to the inline version, so the golden transcript
12
+ // is unchanged. Move-only, no behaviour change.
13
+ //
14
+ // WHERE THIS PHASE STARTS AND STOPS. It starts at its own phase() call and
15
+ // ends at the post-mutation `gitSync.syncBeadsAfter(...)` that closes the
16
+ // `assignedBeadIds.length > 0` branch. The `await updateDashboard()` and the
17
+ // `readyLeafBeads()` still-open check that follow it in runner.js are NOT part
18
+ // of this phase: they are the round loop's own continue/break decision (the
19
+ // second one `break`s, which cannot be expressed from inside a function), and
20
+ // they run identically whether or not a review was dispatched this round.
21
+ //
22
+ // WHY devRounds IS PASSED IN ALREADY INCREMENTED. Same reason as
23
+ // ./replan.mjs and ./develop.mjs: `devRounds` is the round loop's own counter,
24
+ // so the increment stays next to the loop and the incremented value arrives
25
+ // here only to build the `Review C{cycle} R{devRounds}` label.
26
+ //
27
+ // EXPLICIT STATE, NOT A CLOSURE -- AND WHY THREE VALUES COME BACK. The inline
28
+ // version read its inputs off the enclosing runSprintCycle/round-loop scope.
29
+ // They arrive as one explicit state argument now. Most of what this phase
30
+ // writes is MUTATED IN PLACE on objects the caller still holds -- `replanIds`
31
+ // and `replannedThisCycle` (Sets), `perBeadFeedback` (a Map, written through
32
+ // applyGuardedReopens' onReopened hook) and `rejectedNewTasks` (an array) --
33
+ // which is exactly equivalent to the closure it replaces, because runner.js
34
+ // never reassigns those bindings either.
35
+ //
36
+ // Three values are genuinely REASSIGNED rather than mutated, so they cannot
37
+ // travel that way and are returned instead: `lastReviewVerdict` and
38
+ // `reviewedThisCycle`, which the Cycle Evaluation section reads to decide
39
+ // whether a real review happened this cycle and what it concluded, and
40
+ // `pendingRejectedNewTasks`, which trackRejectedNewTaskForResurfacing()/
41
+ // clearResubmittedNewTask() return a NEW list from every time. They are also
42
+ // passed IN, so the round where the empty-guard skips the review dispatch
43
+ // returns them unchanged and the caller's single destructuring assignment is
44
+ // a no-op -- which is what keeps the call site free of an `if`.
45
+ //
46
+ // WHY SOME HELPERS ARE INJECTED RATHER THAN IMPORTED. dispatchReview,
47
+ // bdListScoped, goalMax, recordReopen, childIdAllocator and sprintMutexId are
48
+ // runSprintCycle-scoped locals, so there is nothing to import. computeChildFloor,
49
+ // createChildBeadWithAllocatedId, trackRejectedNewTaskForResurfacing and
50
+ // clearResubmittedNewTask are exported BY runner.js; importing them here would
51
+ // make phases/review.mjs <-> runner.js a circular pair for the sake of four
52
+ // helpers, so they come through the state argument instead -- the same rule
53
+ // phases/plan.mjs's and phases/develop.mjs's headers state. The dependencies
54
+ // that live in real sibling modules (applyGuardedReopens/foldReplanIds from
55
+ // ../beads-transitions.mjs, validateNewTask/appendRejectedFindingToParentNotes/
56
+ // persistNewTaskBestEffort from ../abort.mjs) are imported directly.
57
+ //
58
+ // GUARD COVERAGE: registered as 'phases/review.mjs' in ../guarded-modules.mjs.
59
+ // It took ONE member_name-bearing command() call site out of runner.js (the
60
+ // `bd show <ids> --json` acceptance-criteria read); the reopen and newTask
61
+ // writes reach bd through injected helpers that issue their own command()
62
+ // calls in the modules that already own them, and its only push is the shared
63
+ // gitSync bracket at the end. It carries NO dispatchRole() call site of its
64
+ // own: the reviewer ladder runs through runner.js's dispatchReview() helper,
65
+ // which stays there because the Re-Review and Final Review phases call it too.
66
+ // =============================================================================
67
+
68
+ import { applyGuardedReopens, foldReplanIds, ensureRedBranchFixTask, isInGoalPriority } from '../beads-transitions.mjs';
69
+ import {
70
+ validateNewTask, appendRejectedFindingToParentNotes, persistNewTaskBestEffort,
71
+ } from '../abort.mjs';
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
+
96
+ /**
97
+ * Runs ONE Review round: reviewer dispatch plus the orchestrator-applied
98
+ * transitions its verdict asks for.
99
+ *
100
+ * @param {object} state Explicit phase state; see this file's header.
101
+ * @returns {Promise<{
102
+ * lastReviewVerdict: string|undefined,
103
+ * reviewedThisCycle: boolean,
104
+ * pendingRejectedNewTasks: object[],
105
+ * }>} The three REASSIGNED values described in the header. Every other output
106
+ * of this phase is an in-place mutation of a Set/Map/array the caller still
107
+ * holds. On the empty-scope round (every streak failed) all three come back
108
+ * exactly as they were passed in.
109
+ */
110
+ export async function runReviewPhase({
111
+ // Presentation + dispatch seams.
112
+ phase,
113
+ log,
114
+ command,
115
+ // Sprint identity/config.
116
+ cycle,
117
+ validated,
118
+ targetIssues,
119
+ backlogMember,
120
+ // The git/beads sync bracket this phase's post-mutation D-push goes
121
+ // through.
122
+ gitSync,
123
+ // Per-cycle state. `replanIds`, `replannedThisCycle`, `perBeadFeedback` and
124
+ // `rejectedNewTasks` are mutated in place (see header).
125
+ replanIds,
126
+ replannedThisCycle,
127
+ perBeadFeedback,
128
+ rejectedNewTasks,
129
+ // Per-round inputs. `devRounds` arrives already incremented (see header);
130
+ // the other two are this round's Develop phase output.
131
+ devRounds,
132
+ streakOutcomes,
133
+ readyTitleById,
134
+ // Reassigned, so passed in and returned (see header).
135
+ lastReviewVerdict,
136
+ reviewedThisCycle,
137
+ pendingRejectedNewTasks,
138
+ // runSprintCycle-scoped locals and runner.js-exported helpers, injected
139
+ // rather than imported (see header).
140
+ dispatchReview,
141
+ bdListScoped,
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,
146
+ recordReopen,
147
+ childIdAllocator,
148
+ sprintMutexId,
149
+ computeChildFloor,
150
+ createChildBeadWithAllocatedId,
151
+ trackRejectedNewTaskForResurfacing,
152
+ clearResubmittedNewTask,
153
+ }) {
154
+ // --- Review: self-contained, schema-validated, orchestrator-applied ---
155
+ phase(`Review C${cycle} R${devRounds}`);
156
+ // Sort by (title, id) -- not raw outcome-recording order -- so this
157
+ // evidence-gathering step is deterministic. See the readyTitleById
158
+ // comment just above.
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)
163
+ .slice().sort((a, b) => {
164
+ const ta = readyTitleById.get(a) || a;
165
+ const tb = readyTitleById.get(b) || b;
166
+ return ta.localeCompare(tb) || a.localeCompare(b);
167
+ });
168
+ const acceptanceCriteriaJson = assignedBeadIds.length > 0
169
+ ? await command(`bd show ${assignedBeadIds.join(' ')} --json`, { member_name: backlogMember, silent: true })
170
+ : '[]';
171
+
172
+ // Empty-guard: when EVERY streak this round failed, assignedBeadIds
173
+ // is [] and there is nothing for the Reviewer to look at. Skip the
174
+ // dispatch entirely rather than sending an empty-scope review: an
175
+ // empty review is prone to returning CHANGES_NEEDED with empty
176
+ // reopenIds+newTasks, which trips the contract-violation check below
177
+ // and, after the retry-once path, throws
178
+ // ReviewerContractViolationError -- a hard sprint abort over a round
179
+ // where no work happened at all. The `stillOpen` check just below
180
+ // still runs, so the loop correctly continues instead of prematurely
181
+ // treating the cycle as organically complete.
182
+ if (assignedBeadIds.length === 0) {
183
+ log(`Develop C${cycle} R${devRounds}: all streaks this round failed with no beadIds assigned -- skipping Review dispatch (nothing to review). Failed-streak beads remain ready for the next Develop round.`);
184
+ } else {
185
+ // dispatchReview() applies the shared contract-violation
186
+ // retry-once-then-throw rule (see its own doc comment and
187
+ // ReviewerContractViolationError) -- a CHANGES_NEEDED verdict with
188
+ // both reopenIds and newTasks empty is self-contradictory and must
189
+ // never be treated as an ordinary "more work needed" round.
190
+ const verdict = await dispatchReview({ beadIds: assignedBeadIds, acceptanceCriteriaJson });
191
+ // KB trust pipeline Phase 2: the reviewer decides, the engine
192
+ // executes. Reviewer is the ONLY role whose kb_promotions are
193
+ // honoured. apra-fleet-3swo.5.7: performed by the 'reviewer' row's
194
+ // 'kb-apply' postResult step inside dispatchReview, so BOTH of its
195
+ // call sites get it and a degraded round (which fabricates a
196
+ // verdict carrying no KB fields) does not.
197
+ // A5: the last reviewer verdict seen THIS cycle feeds the Cycle
198
+ // Evaluation section's completion check below -- goal-priority
199
+ // completion requires this to be exactly 'APPROVED', not just
200
+ // an empty ready-bead list.
201
+ lastReviewVerdict = verdict.verdict;
202
+ // A review genuinely ran THIS cycle -- the Cycle Evaluation section
203
+ // below only trusts `lastReviewVerdict` when this is true (see the
204
+ // `reviewedThisCycle` reset at the top of the cycle loop and the
205
+ // re-review dispatch it guards).
206
+ reviewedThisCycle = true;
207
+
208
+ // Orchestrator (this code) -- NOT the LLM -- applies every
209
+ // structured transition: reopenIds via `bd update --status=open`,
210
+ // newTasks via `bd create`. The reviewer's dispatch prompt above
211
+ // explicitly forbade it from mutating beads itself; this is the
212
+ // enforcement side of that contract (SKILL.md).
213
+ // Deterministic goal-scope guard on reopenIds: the prompt-side
214
+ // instruction (buildReviewerPrompt) asks the reviewer not to reopen
215
+ // below-goal beads, but the orchestrator enforces it -- reopening a
216
+ // DEFERRED P3 feature in a P1/P2 sprint injects out-of-scope work and
217
+ // pins the verdict at CHANGES_NEEDED forever.
218
+ // Ids actually reopened this round (survived the goal-scope
219
+ // allowlist) -- gates which `replanIds` entries below are trusted,
220
+ // so a reviewer naming a replanIds id that was never really
221
+ // reopened (out of scope, or simply absent from reopenIds) can
222
+ // never short-circuit the loop.
223
+ const reopenedIds = new Set(await applyGuardedReopens({
224
+ entries: verdict.reopenIds,
225
+ bdListScoped, goalMax, goal: validated.goal, log, command,
226
+ member: backlogMember,
227
+ workedOnIds,
228
+ logPrefix: 'Reviewer reopenIds',
229
+ buildReopenCommand: ({ id }) => ({
230
+ cmd: `bd update ${id} --status=open`,
231
+ label: `Reopen ${id} per reviewer verdict`,
232
+ }),
233
+ onReopened: ({ id }) => {
234
+ // Track per-bead reopen counts for reopen-thrash detection.
235
+ recordReopen(id);
236
+ // Per-bead feedback routing: only beads named in reopenIds
237
+ // carry this round's feedback into the next round's doer
238
+ // prompt -- never a blanket broadcast.
239
+ perBeadFeedback.set(id, verdict.notes);
240
+ },
241
+ }));
242
+ // Fold this round's reviewer `replanIds` (absent/undefined on
243
+ // verdicts that do not use it, so a no-op then) into the cycle's
244
+ // running union, consulted at the top of the next iteration's
245
+ // currentReady computation above. Only ids that were ACTUALLY
246
+ // reopened this round are tracked -- an id the reviewer named in
247
+ // replanIds without ALSO naming it in reopenIds (contrary to the
248
+ // buildReviewerPrompt instruction above) is dropped rather than
249
+ // silently ignored: logged here so the drop is visible in the run
250
+ // log instead of vanishing with no trace.
251
+ // This is the replan loop guard's single enforcement point. A bead
252
+ // that has ALREADY been through one in-cycle scoped replan this cycle
253
+ // (replannedThisCycle) is refused a SECOND: it stays reopened (real
254
+ // dev feedback still applies) but is NOT re-added to replanIds, so
255
+ // the develop loop above never dispatches a second scoped planner
256
+ // pass for it -- it is handed to the next cycle's planner instead.
257
+ // This is what makes "max one scoped replan per bead per cycle" hold
258
+ // regardless of the round budget.
259
+ for (const id of foldReplanIds({
260
+ replanIds: verdict.replanIds, reopenedIds, replannedThisCycle, cycle, log,
261
+ })) {
262
+ replanIds.add(id);
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;
268
+ for (const newTask of verdict.newTasks) {
269
+ // Validate BEFORE interpolation -- see validateNewTask() above
270
+ // for why this is an allowlist, not escaping. A rejection is
271
+ // logged, recorded for the final-review evidence summary, and
272
+ // skipped; it must never abort the sprint over one bad newTask.
273
+ const validation = validateNewTask(newTask);
274
+ if (!validation.ok) {
275
+ log(`Reviewer newTasks: REJECTED (not sent to bd create) -- ${validation.reason}`);
276
+ rejectedNewTasks.push({ cycle, reason: validation.reason, raw: newTask });
277
+ // Track it for resurfacing into the NEXT planning-phase
278
+ // dispatch too -- see trackRejectedNewTaskForResurfacing()'s
279
+ // doc comment.
280
+ pendingRejectedNewTasks = trackRejectedNewTaskForResurfacing(pendingRejectedNewTasks, {
281
+ title: newTask && newTask.title, description: newTask && newTask.description,
282
+ reason: validation.reason, cycle,
283
+ });
284
+ // A rejected finding must never simply vanish -- persist it
285
+ // verbatim to the parent bead's notes as a fallback (itself
286
+ // non-fatal: a notes write failure degrades to the run log,
287
+ // never an abort).
288
+ try {
289
+ await appendRejectedFindingToParentNotes({
290
+ command, member: backlogMember, parentId: targetIssues[0],
291
+ newTask, reason: validation.reason, cycle, log,
292
+ });
293
+ } catch (noteErr) {
294
+ log(`[fleet-sprint] rejected-finding notes fallback FAILED (non-fatal): ${noteErr.message}; finding preserved VERBATIM in this run log: ${JSON.stringify(newTask)}`);
295
+ }
296
+ continue;
297
+ }
298
+ const { title, description, priority } = validation;
299
+ // A bead can only have one parent -- see the matching
300
+ // comment on the re-review newTasks site below.
301
+ //
302
+ // Mint the child id through the supervisor-owned allocator so two
303
+ // concurrent sprints creating follow-up work under the SAME
304
+ // parent never derive the same child id. Under the null client
305
+ // (lone sprint) childId is null and bd derives the id as before.
306
+ const persisted = await persistNewTaskBestEffort({
307
+ command, member: backlogMember, parentId: targetIssues[0],
308
+ newTask, cycle, log, stage: 'develop-review',
309
+ createFn: async () => {
310
+ const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
311
+ await createChildBeadWithAllocatedId({
312
+ command, allocator: childIdAllocator, member: backlogMember,
313
+ title, description, priority, parentId: targetIssues[0],
314
+ sprintId: sprintMutexId, floor, log,
315
+ label: `Create follow-up task from reviewer newTasks: ${title}`,
316
+ });
317
+ },
318
+ });
319
+ // This title just landed as a real bead -- if it was a
320
+ // resubmission of an earlier rejected item, drop it from the
321
+ // pending resurface list so it stops reappearing in future
322
+ // planning prompts. Pass title+description (not just title) so a
323
+ // resubmission that also corrected its title still clears via its
324
+ // unchanged description.
325
+ if (persisted) {
326
+ pendingRejectedNewTasks = clearResubmittedNewTask(pendingRejectedNewTasks, { title, description });
327
+ if (isInGoalPriority(priority, goalMax)) inGoalNewTaskCount += 1;
328
+ }
329
+ }
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
+
358
+ // The orchestrator just MUTATED beads (reopens + newTask creates) in
359
+ // its own clone -- D-push so members observe them on their next
360
+ // dispatch's D-pull.
361
+ await gitSync.syncBeadsAfter(backlogMember, { pushBeads: true });
362
+ } // end assignedBeadIds.length > 0 (Review dispatch + orchestrator-applied transitions)
363
+
364
+ return { lastReviewVerdict, reviewedThisCycle, pendingRejectedNewTasks };
365
+ }
@@ -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
+ }