@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,617 @@
1
+ // The seven dispatch prompt builders for fleet-sprint's Plan/Develop/Review/
2
+ // Finalize phases (apra-fleet-3swo.3.4). Moved verbatim out of runner.js --
3
+ // runner.js re-exports the five builders it previously exported
4
+ // (buildPlannerPrompt, buildDoerPrompt, buildReviewerPrompt,
5
+ // buildFinalVerdictPrompt, buildHarvesterPrompt) and imports the other two
6
+ // (buildPlanReviewerPrompt, buildStreakAssignmentPrompt, previously
7
+ // module-private) for its own in-runner call sites, so behaviour is
8
+ // unchanged either way. This is a move-only extraction: every prompt string
9
+ // is byte-identical to the pre-move code.
10
+ //
11
+ // buildRejectedNewTaskResurfaceLines, kbKnowledgeBlock and kbPromotionBlock
12
+ // stay in runner.js (out of this bead's scope) and are imported back here;
13
+ // the resulting runner.js <-> prompts.mjs cycle is safe because every use is
14
+ // inside a function body, never at module-evaluation time.
15
+ import { wrapUntrustedBlock } from './contracts.mjs';
16
+ import { PR_DESCRIPTION_MAX_LENGTH } from './vcs-module.mjs';
17
+ import { formatStalenessBlock } from './parent-notes-staleness.mjs';
18
+ import { buildRejectedNewTaskResurfaceLines, kbKnowledgeBlock, kbPromotionBlock } from './runner.js';
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
+
47
+ /**
48
+ * @param {{
49
+ * isDeltaCycle: boolean,
50
+ * targetIssues: string[],
51
+ * goal: string,
52
+ * requirementsFile: string|undefined,
53
+ * requirementsContent: string|null,
54
+ * feedback: string|null,
55
+ * replanScope?: string[]|null,
56
+ * replanFindings?: string|null,
57
+ * rejectedNewTasksToResubmit?: Array<{title: string, description: string, reason: string, cycle: number|string}>,
58
+ * verifyExcluded?: string[],
59
+ * stalenessNotes?: string[],
60
+ * }} opts
61
+ * @returns {string}
62
+ */
63
+ export function buildPlannerPrompt({ isDeltaCycle, targetIssues, goal, requirementsFile, requirementsContent, feedback, replanScope = null, replanFindings = null, rejectedNewTasksToResubmit = [], verifyExcluded = [], stalenessNotes = [] }) {
64
+ const lines = [];
65
+
66
+ // SCOPED in-cycle replan clause: present ONLY when a reviewer flagged
67
+ // beads whose acceptance criteria are themselves defective, and absent
68
+ // from every ordinary full-plan/re-plan dispatch. It narrows the planner to
69
+ // amending just those beads' criteria/decomposition.
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;
80
+ if (hasReplanScope) {
81
+ lines.push(
82
+ 'SCOPED IN-CYCLE REPLAN -- this is a NARROW, targeted re-planning pass, not a full ' +
83
+ 'sprint plan. A reviewer flagged the following already-created bead(s) as having ' +
84
+ 'DEFECTIVE ACCEPTANCE CRITERIA that cannot be satisfied by re-development as written: ' +
85
+ `${replanScope.join(', ')}. Re-scope ONLY these bead(s): read each one\'s current ` +
86
+ 'description' + (hasReplanFindings ? ' and the code reviewer findings below' : '') +
87
+ ', then correct its acceptance criteria in ' +
88
+ 'place (via `bd update`), or -- if it is genuinely too large -- decompose it into ' +
89
+ 'task-type children with clear acceptance criteria and model metadata. Do NOT touch, ' +
90
+ 'reword, re-decompose, close, or create any bead OUTSIDE this flagged set, and do NOT ' +
91
+ 'add scope beyond the original sprint goal. Keep the goalposts fixed: you are fixing a ' +
92
+ 'defect in these specific beads, not re-planning the sprint.'
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
+ }
101
+ }
102
+
103
+ if (isDeltaCycle) {
104
+ lines.push(
105
+ 'This is a RE-PLANNING pass: a prior planning pass for this sprint was already ' +
106
+ 'approved and at least one develop/review cycle has since run. Per the ' +
107
+ '"Re-planning behaviour" section of your agent contract: address GAPS ONLY. ' +
108
+ 'Do NOT re-plan or recreate issues that are already closed. Do NOT add scope ' +
109
+ 'beyond the original sprint goals and any open bugs/enhancements already in beads. ' +
110
+ // Mirrors buildPlanReviewerPrompt's matching guard.
111
+ 'A feature whose children are ALL closed is pending feature-closure ' +
112
+ '(the integration-test phase closes verified features): leave it exactly as it ' +
113
+ 'is -- do not decompose it again and do not create tasks duplicating its closed ' +
114
+ 'children, even if review feedback appears to ask for decomposition of such a ' +
115
+ 'feature (verify with bd list --parent <feature> --all first).'
116
+ );
117
+ // The pending-closure rule needs a REGRESSION exception for bugs, or a
118
+ // regressed bug becomes unreachable by every role: the planner refuses
119
+ // to re-decompose it, doers refuse non-task beads, and the integ runner
120
+ // may only verify-and-close.
121
+ lines.push(
122
+ 'REGRESSION EXCEPTION -- the leave-it-alone rule above does NOT apply to a ' +
123
+ 'regressed bug. An OPEN bug-type bead whose task children are all closed but ' +
124
+ 'whose own notes record the defect still reproducing AFTER those children ' +
125
+ 'closed (e.g. fresh evidence from a later integration-test run: "recurred", ' +
126
+ '"still reproduces", "fix did not hold") is a REGRESSION, not pending-closure ' +
127
+ 'housekeeping. For each such bug: read its latest evidence with bd show, then ' +
128
+ 'create NEW task children under it (a fix task targeting the residual ' +
129
+ 'mechanism the fresh evidence names -- not a duplicate of the closed fix -- ' +
130
+ 'plus a [test] task pinning it), with acceptance criteria and model metadata ' +
131
+ 'as for any task. Leave the bug bead itself open as the parent.'
132
+ );
133
+ } else {
134
+ lines.push('Analyze the sprint scope below and build a features+tasks DAG in beads, per your agent contract.');
135
+ }
136
+
137
+ lines.push(`Sprint root issue id(s) (--parent scope for this sprint): ${targetIssues.join(', ')}.`);
138
+
139
+ // apra-fleet-fsxg: tooling-computed parent-NOTES staleness signal, injected
140
+ // prominently near the top so a flagged bead is the first thing the planner
141
+ // reconciles. Advisory only -- absent (the common case) leaves the prompt
142
+ // unchanged; present, it names specific beads whose NOTES post-date their
143
+ // decomposition, which the companion role-prompt guidance then tells the
144
+ // planner to treat as authoritative over any stale child.
145
+ const plannerStalenessBlock = formatStalenessBlock(stalenessNotes);
146
+ if (plannerStalenessBlock) {
147
+ lines.push(plannerStalenessBlock);
148
+ }
149
+
150
+ // apra-fleet-jfo: authoritative, data-driven verify-route exclusion. This
151
+ // supersedes the generic "pending feature-closure" prose above with an
152
+ // exact id list from classifyVerifySet(), on EVERY cycle (not just delta
153
+ // re-planning passes) and for any issue_type, not just features/bugs.
154
+ if (Array.isArray(verifyExcluded) && verifyExcluded.length > 0) {
155
+ lines.push(
156
+ `VERIFY-ROUTE EXCLUSION -- these bead(s) are implementation-complete (every child ` +
157
+ `closed) and are routed to integration-test verification this cycle, not planning: ` +
158
+ `${verifyExcluded.join(', ')}. Do NOT create tasks for them, do NOT re-decompose them, ` +
159
+ `do NOT treat them as unplanned or unaddressed work, and do NOT let plan-review gates ` +
160
+ `bind over them -- they are out of scope for this planning pass entirely. Only the ` +
161
+ `integration-test phase may close them (or reopen work under them if verification finds ` +
162
+ `a real gap).`
163
+ );
164
+ }
165
+ lines.push(`Goal priority for this sprint: ${goal}.`);
166
+ lines.push(
167
+ // Mirrors buildPlanReviewerPrompt's matching criterion. Doers may only
168
+ // claim issue_type=task, so a bug left as a childless leaf would be
169
+ // assigned directly and skipped every round.
170
+ 'Doers can only claim issue_type=task beads. Any OPEN bug-type bead in scope ' +
171
+ 'that has no task-type children yet must be decomposed during planning into ' +
172
+ 'one or more task-type children (with acceptance criteria and model metadata, ' +
173
+ 'including a [test] task where the fix is testable) -- the bug bead itself is ' +
174
+ 'never dispatched directly and stays open as the parent until its children ' +
175
+ 'are done and verified.'
176
+ );
177
+ // Only the affirmative instruction belongs here: '-tier'-suffixed
178
+ // spellings are normalized deterministically in code (normalizeTierToken),
179
+ // so the prompt does not need to warn against them.
180
+ lines.push(
181
+ 'For every task: set clear acceptance criteria in its description, and set its ' +
182
+ 'model tier as beads metadata at creation time via ' +
183
+ '`bd create ... --metadata \'{"model": "<tier>"}\'` (tier: cheap, standard, or ' +
184
+ 'premium) -- this is the ONLY location the model tier is recorded: do not ' +
185
+ 'additionally record it via bd\'s freeform notes field or a METADATA-section ' +
186
+ 'comment, per planner.md Step 3.'
187
+ );
188
+
189
+ if (requirementsFile && requirementsContent) {
190
+ lines.push(`Requirements file (${requirementsFile}) content, for reference:`);
191
+ lines.push(requirementsContent);
192
+ } else if (requirementsFile && !requirementsContent) {
193
+ lines.push(`Note: a requirementsFile ('${requirementsFile}') was configured for this sprint but could not be read; proceed without it.`);
194
+ }
195
+
196
+ // Reviewer-proposed newTasks rejected by validateNewTask() in an earlier
197
+ // cycle resurface here, in the next planning dispatch, rather than
198
+ // dead-ending in root-bead notes (which are still written, for
199
+ // auditability).
200
+ const resurfaceLines = buildRejectedNewTaskResurfaceLines(rejectedNewTasksToResubmit);
201
+ if (resurfaceLines.length > 0) {
202
+ lines.push(resurfaceLines.join('\n\n'));
203
+ }
204
+
205
+ if (feedback) {
206
+ lines.push('Feedback from the previous plan-review round -- address every point raised:');
207
+ lines.push(wrapUntrustedBlock('plan-reviewer.notes', feedback));
208
+ }
209
+
210
+ return lines.join('\n\n');
211
+ }
212
+
213
+ // ---------------------------------------------------------------------------
214
+ //
215
+ // Builds the self-contained plan-reviewer dispatch prompt. The vendored
216
+ // agents/plan-reviewer.md requires one dispatch input, the sprint root/scope
217
+ // to review (its schema declares `required: ["scope"]`, and an unscoped
218
+ // dispatch must return verdict CHANGES_NEEDED), plus an OPTIONAL second input:
219
+ // prior-round verdicts for the current review cycle, supplied on round N>1 of
220
+ // the planner<->plan-reviewer loop so the no-goalpost-moving rule has
221
+ // something to bind against. The plan-reviewer has no memory of this
222
+ // conversation (dispatches default to `resume: false`), so the sprint root
223
+ // issue id(s) and goal priority defining the subtree under review are spelled
224
+ // out here; everything else (the DAG, task metadata) it reads from beads.
225
+ /**
226
+ * @param {{
227
+ * targetIssues: string[],
228
+ * goal: string,
229
+ * priorRoundVerdicts?: Array<{ round: number, verdict: string, notes: string|null }>,
230
+ * replanScope?: string[]|null,
231
+ * stalenessNotes?: string[],
232
+ * }} opts
233
+ * @returns {string}
234
+ */
235
+ export function buildPlanReviewerPrompt({ targetIssues, goal, priorRoundVerdicts = [], replanScope = null, verifyExcluded = [], stalenessNotes = [] }) {
236
+ const hasReplanScope = Array.isArray(replanScope) && replanScope.length > 0;
237
+ const lines = [
238
+ 'Review the beads DAG created by the planner for this sprint, per your agent contract.',
239
+ `Sprint root / scope to review (the open beads subtree this review pass covers): ` +
240
+ `sprint root issue id(s) ${targetIssues.join(', ')}, goal priority ${goal}. ` +
241
+ 'Review only the features and tasks under this scope.',
242
+ ];
243
+
244
+ // apra-fleet-fsxg: same tooling-computed parent-NOTES staleness signal the
245
+ // planner receives, surfaced here so the plan-reviewer independently knows
246
+ // which bead(s) had NOTES updated after their decomposition and can check
247
+ // the existing children against those later corrections. Advisory only.
248
+ const reviewerStalenessBlock = formatStalenessBlock(stalenessNotes);
249
+ if (reviewerStalenessBlock) {
250
+ lines.push(reviewerStalenessBlock);
251
+ }
252
+
253
+ // apra-fleet-jfo: same authoritative, data-driven verify-route exclusion
254
+ // as buildPlannerPrompt -- the plan-reviewer must not fail the plan for
255
+ // "not decomposing" or "not covering" a bead that is routed to
256
+ // integration-test verification, not planning.
257
+ if (Array.isArray(verifyExcluded) && verifyExcluded.length > 0) {
258
+ lines.push(
259
+ `VERIFY-ROUTE EXCLUSION -- these bead(s) are implementation-complete (every child ` +
260
+ `closed) and routed to integration-test verification this cycle: ${verifyExcluded.join(', ')}. ` +
261
+ `Do not withhold approval on the grounds that they are undecomposed, uncovered, or ` +
262
+ `missing model metadata -- they are out of scope for this plan review entirely.`
263
+ );
264
+ }
265
+
266
+ // Present only on a scoped in-cycle replan; an ordinary plan-review
267
+ // dispatch carries no such clause.
268
+ if (hasReplanScope) {
269
+ lines.push(
270
+ 'SCOPED IN-CYCLE REPLAN REVIEW -- this pass follows a NARROW, targeted re-plan of ' +
271
+ `specifically flagged bead(s) ${replanScope.join(', ')} whose acceptance criteria a ` +
272
+ 'reviewer judged defective. Focus your verdict on whether the planner has now given ' +
273
+ 'those bead(s) clear, satisfiable acceptance criteria (and decomposed them into ' +
274
+ 'task-type children if they were too large). Approve if the flagged bead(s) are now ' +
275
+ 'well-formed; do not withhold approval over unrelated, previously-accepted parts of ' +
276
+ 'the DAG, and do not demand new scope beyond fixing the flagged defect.'
277
+ );
278
+ }
279
+
280
+ lines.push(
281
+ 'IMPORTANT -- pending-closure features: before flagging any feature as ' +
282
+ 'undecomposed (no child tasks / no [test] task) or as missing model metadata, ' +
283
+ 'check its CLOSED children too (bd list --parent <feature> --all). A feature ' +
284
+ 'whose children are all closed is PENDING FEATURE-CLOSURE housekeeping (the ' +
285
+ 'integration-test phase closes verified features) -- it is NOT undecomposed, ' +
286
+ 'must NOT fail coverage/decomposition/test-task/model-metadata criteria, and ' +
287
+ 'must NOT be re-decomposed. Mention such features as non-blocking notes only. ' +
288
+ 'Never ask the planner to create tasks that duplicate closed work.',
289
+ 'DISPATCHABILITY -- doers can only claim issue_type=task beads. If any OPEN ' +
290
+ 'bug-type bead in scope is a childless leaf (no task-type children, so it ' +
291
+ 'would be dispatched to a doer directly), the plan is NOT approvable: return ' +
292
+ 'CHANGES_NEEDED asking the planner to decompose that bug into task-type ' +
293
+ 'children. This does not apply to features covered by the pending-closure ' +
294
+ 'rule above.',
295
+ // Mirrors buildPlannerPrompt's REGRESSION EXCEPTION clause; the two
296
+ // must state the same rule or planner and plan-reviewer disagree.
297
+ 'REGRESSION EXCEPTION to the pending-closure rule -- for OPEN BUG-type beads ' +
298
+ 'only: if a bug\'s task children are all closed but its own notes record the ' +
299
+ 'defect still reproducing AFTER those children closed (fresh evidence from a ' +
300
+ 'later integration/test run: "recurred", "still reproduces", "fix did not ' +
301
+ 'hold"), it is a REGRESSION, not pending-closure housekeeping. Such a bug with ' +
302
+ 'no NEW open task children addressing the fresh evidence makes the plan NOT ' +
303
+ 'approvable: return CHANGES_NEEDED asking the planner to add a new fix task ' +
304
+ '(targeting the residual mechanism the latest evidence names, never ' +
305
+ 'duplicating the closed fix) plus a [test] task. A bug whose notes show no ' +
306
+ 'post-closure recurrence stays under the pending-closure rule as before.',
307
+ );
308
+
309
+ // Rounds after the first carry every earlier round's verdict for this same
310
+ // scope/cycle so the plan-reviewer can honor plan-reviewer.md's
311
+ // no-goalpost-moving rule. Absent on round 1. Each verdict's notes are the
312
+ // plan-reviewer's own free text, so they are wrapped as untrusted content.
313
+ if (priorRoundVerdicts.length > 0) {
314
+ lines.push(
315
+ 'Prior-round verdicts for THIS SAME review cycle (most recent last) -- per the ' +
316
+ 'no-goalpost-moving rule in your agent contract, a resolution an earlier round ' +
317
+ 'explicitly named acceptable is SETTLED: accept it again this round unless you ' +
318
+ 'can name specific NEW evidence, and never re-litigate it with a different ' +
319
+ 'demanded resolution.'
320
+ );
321
+ for (const { round, verdict, notes } of priorRoundVerdicts) {
322
+ lines.push(wrapUntrustedBlock(
323
+ `plan-reviewer.round-${round}-verdict`,
324
+ `round ${round} verdict: ${verdict}\nnotes: ${notes || '(no notes)'}`
325
+ ));
326
+ }
327
+ }
328
+
329
+ return lines.join('\n\n');
330
+ }
331
+
332
+ /**
333
+ * Builds the self-contained "group ready beads into streaks" prompt.
334
+ * @param {{ readyBeadIds: string[] }} opts
335
+ * @returns {string}
336
+ */
337
+ export function buildStreakAssignmentPrompt({ readyBeadIds }) {
338
+ return [
339
+ 'Group the following ready beads into logical development streaks ' +
340
+ '(beads that must be worked sequentially by the SAME streak; ' +
341
+ 'independent beads should be their own streak so they can be worked ' +
342
+ 'in parallel by different doers).',
343
+ `Ready bead ids: ${readyBeadIds.join(', ')}`,
344
+ 'Every ready bead id listed above must appear in exactly one streak -- ' +
345
+ 'no bead id may be omitted, duplicated, or invented.',
346
+ 'Return every bead id EXACTLY as listed above, character for character, ' +
347
+ 'including its full prefix. Never shorten, abbreviate, or strip a ' +
348
+ 'common-looking prefix: ids from different scopes do not necessarily ' +
349
+ 'share one, and any id that does not match the list verbatim is rejected.',
350
+ 'This is the complete input. Do not run bd, git, or any other command, ' +
351
+ 'and do not read any files to investigate further -- respond immediately ' +
352
+ 'using only the schema, based solely on the bead ids given above.',
353
+ ].join('\n\n');
354
+ }
355
+
356
+ /**
357
+ * Builds the self-contained doer dispatch prompt for one streak. `feedback`
358
+ * carries only the bead(s) this streak owns -- never a blanket broadcast of
359
+ * the whole reviewer verdict to every doer -- and is wrapped as untrusted
360
+ * inter-agent content (contracts.mjs `wrapUntrustedBlock`). `branch` is the
361
+ * sprint track branch and is always spelled out: doer.md requires it, and a
362
+ * doer dispatched without one must return "BLOCKED" rather than guess whatever
363
+ * branch happens to be checked out.
364
+ * `kbKnowledge` carries the entries kb_session_prime returned for this member
365
+ * (see kbKnowledgeBlock): the doer cannot read the KB itself on a member
366
+ * dispatch, so this prompt is its only route to prior knowledge.
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
370
+ * @returns {string}
371
+ */
372
+ export function buildDoerPrompt({ beadIds, branch, feedback, kbKnowledge, kbBlock }) {
373
+ const lines = [
374
+ `Sprint track branch to work on: ${branch}. Work on this branch only; do not push to the base branch.`,
375
+ `Assigned bead ids (comma-separated): ${beadIds.join(', ')}`,
376
+ 'Work each assigned bead per your agent contract: read `bd show <id>` for its ' +
377
+ 'full acceptance criteria, implement and verify the change, then `bd close <id>` ' +
378
+ 'once it is done. Return your report strictly as the required JSON schema ' +
379
+ '(status, closedIds, notes).',
380
+ // Stated in the dispatch prompt so CLAUDE.md's permission-block policy
381
+ // travels with every doer regardless of what its agent file says.
382
+ 'PERMISSION BLOCKS MUST BE SURFACED, NOT ROUTED AROUND: if any tool or git ' +
383
+ 'invocation (e.g. Edit/Write, git push) is blocked by the permission layer, STOP ' +
384
+ 'and report the block in your notes with status "BLOCKED" -- do NOT substitute a ' +
385
+ 'Bash heredoc/`cat > file`, a wrapper script, an alternate binary, or any other ' +
386
+ 'workaround whose purpose is to bypass the block, even for a brand-new file and ' +
387
+ 'even if you judge the underlying operation safe. This matches this repo\'s ' +
388
+ 'CLAUDE.md permission-block policy.',
389
+ ...(Array.isArray(kbBlock) ? kbBlock : kbKnowledgeBlock(kbKnowledge)),
390
+ ];
391
+ if (feedback) {
392
+ lines.push(
393
+ 'Feedback from the previous review round for these specific bead(s) -- ' +
394
+ 'address every point before closing again:'
395
+ );
396
+ lines.push(wrapUntrustedBlock('reviewer.notes', feedback));
397
+ }
398
+ return lines.join('\n\n');
399
+ }
400
+
401
+ export function buildReviewerPrompt({ beadIds, acceptanceCriteriaJson, baseBranch, branch, goal, kbCandidates, kbKnowledge, kbBlock }) {
402
+ const ids = Array.isArray(beadIds) ? beadIds : [];
403
+ const scopeWide = ids.length === 0;
404
+ // Scope-wide re-reviews are fed `bd list --json` (the whole remaining
405
+ // scope); per-bead reviews are fed `bd show --json`. Label the untrusted
406
+ // block with the command that actually produced it.
407
+ const scopeCommand = scopeWide ? 'bd list --json' : 'bd show --json';
408
+ return [
409
+ scopeWide
410
+ ? 'Re-review the CURRENT state of the entire sprint scope. No bead ids are named '
411
+ + 'because no goal-priority beads remain open -- that is precisely the question you '
412
+ + 'are being asked to settle: judge the delivered work as a whole and decide whether '
413
+ + 'this sprint is genuinely complete.'
414
+ : `Review the work just done for the following bead id(s): ${ids.join(', ')}.`,
415
+ scopeWide
416
+ ? 'The full sprint scope, from `bd list --json`:'
417
+ : 'Full task detail (including acceptance criteria), from `bd show --json`:',
418
+ wrapUntrustedBlock(scopeCommand, acceptanceCriteriaJson),
419
+ `Diff range to review: ${baseBranch}..${branch} (base_branch..branch).`,
420
+ // Without an explicit scope clause a reviewer can withhold APPROVED
421
+ // over below-goal work the sprint deliberately defers, which starves
422
+ // the completion gate (zero open goal beads AND an APPROVED verdict).
423
+ ...(goal ? [
424
+ `SPRINT SCOPE: this sprint's goal priority is ${goal}. Judge your verdict ` +
425
+ (scopeWide
426
+ ? `ONLY against work at or above that goal priority. `
427
+ : `ONLY against the named bead id(s) above and other work at or above that `
428
+ + `goal priority. `) +
429
+ `Features/beads BELOW the goal priority (e.g. P3 when the ` +
430
+ `goal is P1/P2) are DEFERRED BY DESIGN to a later sprint: their absence ` +
431
+ `from the diff is correct, must not block APPROVED, must not appear in ` +
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.`),
437
+ ] : []),
438
+ // apra-fleet-0ef: the reviewer is the ONLY role permitted to mint
439
+ // CONFIRMED, but a KB entry id can only come from the KB, and the
440
+ // reviewer subagent has no apra-fleet MCP tools to look one up. Without
441
+ // this block it could never name an id, so `kb_promotions` came back
442
+ // empty on every round and nothing was ever promoted. The engine reads
443
+ // the candidates and executes; the judgment stays with the reviewer.
444
+ // Prior knowledge FIRST, then the promotion candidates: the reviewer
445
+ // judges the work against what the repo already knows before it decides
446
+ // which of this sprint's captures earned CONFIRMED.
447
+ ...(Array.isArray(kbBlock) ? kbBlock : kbKnowledgeBlock(kbKnowledge)),
448
+ ...kbPromotionBlock(kbCandidates),
449
+ 'Do NOT run any `bd` command yourself and do NOT mutate beads directly in any way ' +
450
+ '(no bd update, bd close, bd create, etc.) -- the orchestrator applies your ' +
451
+ '`reopenIds` via `bd update <id> --status=open` and creates your `newTasks` via ' +
452
+ '`bd create`. Optionally include `replanIds`: a SUBSET of the ids you also named in ' +
453
+ '`reopenIds` above whose acceptance criteria are themselves defective (not fixable by ' +
454
+ 're-development) and need a planner pass before the next dispatch, scoped to this ' +
455
+ 'cycle. An id you did not also name in `reopenIds` is dropped and never reaches the ' +
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. ' +
460
+ 'Return ONLY your structured verdict (verdict, notes, reopenIds, replanIds, ' +
461
+ 'buildFailing, newTasks) strictly as the required JSON schema; never touch beads yourself.',
462
+ ].join('\n\n');
463
+ }
464
+
465
+ /**
466
+ * Builds the self-contained Final Review prompt (finalVerdict schema),
467
+ * embedding the evidence the orchestrator gathered over the run -- sprint
468
+ * scope, branch and base branch so the reviewer can diff for itself, and the
469
+ * bead-count / deploy / integ-test outcomes -- so a returned PASS rests on
470
+ * something concrete instead of being a rubber stamp.
471
+ * @param {{
472
+ * targetIssues: string[], branch: string, baseBranch: string, goal: string,
473
+ * cyclesRun: number, closedCount: number, openAtGoalCount: number,
474
+ * deployFailures: Array<{cycle: number, notes: string}>,
475
+ * integFailures: Array<{cycle: number, notes: string, bugsFiled: string[]}>,
476
+ * rejectedNewTasks: Array<{cycle: number, reason: string, raw: object}>,
477
+ * unclosedVerifyIds?: string[],
478
+ * deferredAtGoalIds?: string[],
479
+ * }} opts
480
+ * @returns {string}
481
+ */
482
+ export function buildFinalVerdictPrompt({ targetIssues, branch, baseBranch, goal, cyclesRun, closedCount, openAtGoalCount, deployFailures, integFailures, rejectedNewTasks = [], unclosedVerifyIds = [], deferredAtGoalIds = [], kbCandidates, kbKnowledge, kbBlock }) {
483
+ const lines = [
484
+ `Final review for sprint scope issue id(s): ${targetIssues.join(', ')}.`,
485
+ `Branch: ${branch} (base: ${baseBranch}). Goal priority: ${goal}. The sprint ran ${cyclesRun} cycle(s).`,
486
+ `Evidence: ${closedCount} bead(s) closed in scope; ${openAtGoalCount} bead(s) still open at or above goal priority ${goal}.`,
487
+ `The evidence above (bead counts, deploy/integ outcomes) is a summary, not proof -- it reflects what the sprint claims, not what the code does. You MUST review the actual net diff yourself before returning PASS; a PASS grounded only in bead-closure counts is not acceptable. Diff range: ${baseBranch}..${branch} (base_branch..branch). Review it as a whole against what closed -- net changes vs. the beads claimed done, not a commit-by-commit walk.`,
488
+ ];
489
+ if (deployFailures.length > 0) {
490
+ lines.push(
491
+ `Deploy phase FAILED in ${deployFailures.length} cycle(s): ` +
492
+ deployFailures.map((d) => `C${d.cycle}: ${d.notes}`).join(' | ')
493
+ );
494
+ }
495
+ if (integFailures.length > 0) {
496
+ lines.push(
497
+ `Integration tests FAILED in ${integFailures.length} cycle(s): ` +
498
+ integFailures.map((d) => `C${d.cycle} (bugsFiled: ${d.bugsFiled.join(', ') || 'none'}): ${d.notes}`).join(' | ')
499
+ );
500
+ }
501
+ if (rejectedNewTasks.length > 0) {
502
+ // newTasks rejected by validateNewTask are non-fatal to the sprint but
503
+ // must still reach a human, so they are surfaced in the same evidence
504
+ // block the final reviewer reads.
505
+ lines.push(
506
+ `${rejectedNewTasks.length} reviewer-proposed newTask(s) were REJECTED (not created via bd create) for failing input validation: ` +
507
+ rejectedNewTasks.map((r) => `C${r.cycle}: ${r.reason}`).join(' | ')
508
+ );
509
+ }
510
+ if (unclosedVerifyIds.length > 0) {
511
+ // apra-fleet-jfo.2: verify-routed beads (implementation-complete,
512
+ // all children closed, awaiting real integration-test
513
+ // re-verification) are decomposed parents, so they are excluded
514
+ // from `openAtGoalCount` above no matter their status -- do not let
515
+ // their absence from that count read as "done".
516
+ lines.push(
517
+ `${unclosedVerifyIds.length} verify-routed bead(s) are STILL OPEN and were never confirmed working ` +
518
+ `against the deployed build this sprint (most likely because Deploy failed before IntegTest could ` +
519
+ `attempt them): ${unclosedVerifyIds.join(', ')}. These do NOT count toward openAtGoalCount above ` +
520
+ `(decomposed-parent beads are excluded from that count), so do not treat 0 open-at-goal as ` +
521
+ `evidence these are done -- treat each one as an open, unverified target when deciding PASS/FAIL.`
522
+ );
523
+ }
524
+ if (deferredAtGoalIds.length > 0) {
525
+ // apra-fleet-rp7a.1: deferred beads at/above goal priority are excluded
526
+ // from `openAtGoalCount` above, because the Develop loop dispatches from
527
+ // `bd --ready`, which never offers a deferred bead -- so no cycle could
528
+ // have advanced them and counting them as open made completion
529
+ // unreachable. They are still a DECISION a human made about this
530
+ // sprint's scope, so state them rather than letting them vanish behind
531
+ // a count of zero.
532
+ lines.push(
533
+ `${deferredAtGoalIds.length} bead(s) at/above goal priority ${goal} are DEFERRED and were treated as out of ` +
534
+ `scope for this sprint: ${deferredAtGoalIds.join(', ')}. These do NOT count toward openAtGoalCount above ` +
535
+ `(a deferred bead is never dispatchable, so the sprint could not have worked it). Judge PASS/FAIL on what was ` +
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.`
537
+ );
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
+ );
545
+ lines.push(
546
+ 'Return a PASS/FAIL verdict per your agent contract, grounded in the evidence above -- ' +
547
+ 'never rubber-stamp PASS regardless of open goal-priority beads or deploy/integration failures.'
548
+ );
549
+ lines.push(
550
+ // Single-quoted (not a template literal) on purpose: the `notes`
551
+ // markdown code spans below are agent-prompt PROSE, never a dispatched
552
+ // command string, and spelling them as escaped backticks inside a
553
+ // template literal is exactly the construct shell-command-guard.mjs
554
+ // flags. Plain concatenation keeps the emitted text byte-identical.
555
+ 'Keep `notes` concise: it is embedded verbatim into the pull request description this ' +
556
+ 'sprint raises, which has a hard cap of ' + PR_DESCRIPTION_MAX_LENGTH + ' characters -- a pull ' +
557
+ 'request whose description exceeds that many characters can be rejected outright by the ' +
558
+ 'hosting provider. A too-long `notes` value is truncated before the pull request is raised, ' +
559
+ 'so anything past the limit is silently lost; stay well within it so your findings actually reach the reviewer.'
560
+ );
561
+ lines.push(
562
+ 'Return any actionable findings as `newTasks` (title, description, priority each) so they ' +
563
+ 'persist in beads for the next sprint -- notes alone do not reach the backlog. This applies ' +
564
+ 'on BOTH verdicts, not just FAIL: a PASS can still have real secondary findings (a defect that ' +
565
+ 'does not block this epic\'s own acceptance criteria, a missing test, a follow-up worth tracking) ' +
566
+ 'that would otherwise be lost prose with no way for a future sprint to act on them. One task per ' +
567
+ 'distinct finding; reference concrete files/tests in each description. Omit newTasks or return ' +
568
+ '[] only when you have nothing further to flag.'
569
+ );
570
+ lines.push(
571
+ 'If any ALREADY-CLOSED bead should be reopened -- e.g. it was closed on insufficient evidence, ' +
572
+ 'or a defect remains in work already marked done -- return it in `reopenIds` as ' +
573
+ '`{ id, reason }`. Every entry needs its OWN specific reason (not a shared blanket note): the ' +
574
+ 'orchestrator appends `reason` verbatim as a durable note on that exact bead, so a vague or ' +
575
+ 'missing reason is useless to whoever reads it later. Do not use reopenIds for beads that were ' +
576
+ 'never closed -- that is what `newTasks` is for.'
577
+ );
578
+ lines.push(
579
+ 'NEVER touch beads yourself (no bd create/update/reopen) -- the orchestrator applies your ' +
580
+ 'newTasks and reopenIds.'
581
+ );
582
+ // apra-fleet-nx7: the Final Review is the best-positioned promoter in the
583
+ // whole run -- it has read the entire diff, run the full suite and judged the
584
+ // sprint as a whole, which is exactly the evidence standard reviewer.md
585
+ // demands before minting CONFIRMED. It used to receive no candidate block at
586
+ // all (0ef wired kbCandidates through buildReviewerPrompt only), so anything
587
+ // captured in a sprint's LAST round reached this reviewer and nobody else,
588
+ // and was stranded at INFERRED forever.
589
+ lines.push(...(Array.isArray(kbBlock) ? kbBlock : kbKnowledgeBlock(kbKnowledge)));
590
+ lines.push(...kbPromotionBlock(kbCandidates));
591
+ return lines.join('\n\n');
592
+ }
593
+
594
+ /**
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
601
+ * @returns {string}
602
+ */
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.
608
+ const fence = (content) => '`'.repeat(Math.max(3, (content.match(/`+/g) || []).reduce((m, r) => Math.max(m, r.length), 0) + 1));
609
+ const analysisFence = fence(analysisText);
610
+ return [
611
+ `Harvest durable knowledge for sprint scope issue id(s): ${targetIssues.join(', ')}.`,
612
+ `Branch: ${branch} (base: ${baseBranch}).`,
613
+ 'Update docs/ and README, and defer low-priority issues, per your agent contract.',
614
+ `analysisArtifactFile: ${analysisArtifactFile}`,
615
+ `analysisText (pre-computed by the orchestrator -- write verbatim to analysisArtifactFile, per Step 1 of your contract):\n${analysisFence}\n${analysisText}\n${analysisFence}`,
616
+ ].join('\n\n');
617
+ }