@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -121,6 +121,90 @@ function buildGitHubCommentCommand({ repo, issue_number: issueNumber, body, toke
121
121
  };
122
122
  }
123
123
 
124
+ /** Map one GitHub pull object (list or single) to the provider-neutral
125
+ * { id, title, body, url } shape the existing-PR update path reads. */
126
+ function mapGitHubPull(pr) {
127
+ const src = (pr && typeof pr === 'object') ? pr : {};
128
+ const id = typeof src.number === 'number' && Number.isFinite(src.number) ? src.number : null;
129
+ return {
130
+ id,
131
+ title: typeof src.title === 'string' ? src.title : '',
132
+ body: typeof src.body === 'string' ? src.body : '',
133
+ url: typeof src.html_url === 'string' ? src.html_url : null,
134
+ };
135
+ }
136
+
137
+ /** Build the GitHub REST "find the open pull request for head -> base" curl
138
+ * command, used on the already-exists path to learn the existing PR's
139
+ * number and current body (the create call's 422 carries neither).
140
+ * GET /repos/{owner}/{repo}/pulls?head={owner}:{branch}&base={base}&state=open
141
+ * -- see https://docs.github.com/en/rest/pulls/pulls#list-pull-requests
142
+ * The URL carries '&', so it is quoted like every other argument. */
143
+ function buildGitHubFindPrCommand({ repo, base, head, token, os, shell }) {
144
+ const safeRepo = assertRepo(repo);
145
+ const safeToken = assertToken(token);
146
+ if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a find-pull-request command.');
147
+ if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a find-pull-request command.');
148
+ const owner = safeRepo.split('/')[0];
149
+ const query = `head=${encodeURIComponent(`${owner}:${head}`)}&base=${encodeURIComponent(base)}&state=open&per_page=10`;
150
+ const url = `${GITHUB_API}/repos/${safeRepo}/pulls?${query}`;
151
+
152
+ const buildCurl = (authToken) => [
153
+ `${curlBinary(os)} -sS -X GET`,
154
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
155
+ `-H ${shQuote('Accept: application/vnd.github+json', os, shell)}`,
156
+ `-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os, shell)}`,
157
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
158
+ shQuote(url, os, shell),
159
+ ].join(' ');
160
+
161
+ return {
162
+ provider: 'github',
163
+ action: 'find-pull-request',
164
+ command: buildCurl(safeToken),
165
+ logSafeCommand: buildCurl(REDACTED),
166
+ interpret: { successStatusRange: [200, 299] },
167
+ /** 2xx body (an array of pulls) -> [{ id, title, body, url }]. */
168
+ mapResponse: (respBody) => (Array.isArray(respBody) ? respBody.map(mapGitHubPull).filter((p) => p.id !== null) : []),
169
+ };
170
+ }
171
+
172
+ /** Build the GitHub REST "update a pull request" curl command (title + body).
173
+ * PATCH /repos/{owner}/{repo}/pulls/{pull_number} -- see
174
+ * https://docs.github.com/en/rest/pulls/pulls#update-a-pull-request */
175
+ function buildGitHubUpdatePrCommand({ repo, pull_request_id: pullRequestId, title, body, token, os, shell }) {
176
+ const safeRepo = assertRepo(repo);
177
+ const safeToken = assertToken(token);
178
+ const id = String(pullRequestId ?? '').trim();
179
+ if (!/^\d+$/.test(id)) throw new Error('ERROR: VCSModule: a numeric "pull_request_id" is required to build an update-pull-request command.');
180
+ if (!title) throw new Error('ERROR: VCSModule: "title" is required to build an update-pull-request command.');
181
+
182
+ const payload = { title };
183
+ if (body !== undefined) payload.body = body;
184
+ const payloadJson = JSON.stringify(payload);
185
+ const url = `${GITHUB_API}/repos/${safeRepo}/pulls/${id}`;
186
+
187
+ const buildCurl = (authToken) => [
188
+ `${curlBinary(os)} -sS -X PATCH`,
189
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
190
+ `-H ${shQuote('Accept: application/vnd.github+json', os, shell)}`,
191
+ `-H ${shQuote('Content-Type: application/json', os, shell)}`,
192
+ `-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os, shell)}`,
193
+ `-d ${shQuoteJson(payloadJson, os, shell)}`,
194
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
195
+ url,
196
+ ].join(' ');
197
+
198
+ return {
199
+ provider: 'github',
200
+ action: 'update-pull-request',
201
+ command: buildCurl(safeToken),
202
+ logSafeCommand: buildCurl(REDACTED),
203
+ interpret: { successStatusRange: [200, 299] },
204
+ mapResponse: (respBody) => mapGitHubPull(respBody),
205
+ };
206
+ }
207
+
124
208
  // ---------------------------------------------------------------------------
125
209
  // Pull-request RESPONSE mapping (apra-fleet-lzfv.4)
126
210
  // ---------------------------------------------------------------------------
@@ -345,6 +429,141 @@ function capabilitiesForHost(_host) {
345
429
  return { canOpenPullRequest: true };
346
430
  }
347
431
 
432
+ // ---------------------------------------------------------------------------
433
+ // Engine CI gate axis (see ../ci-gate.mjs and ./index.mjs's `ciGate` contract)
434
+ // ---------------------------------------------------------------------------
435
+ //
436
+ // The orchestrator -- never a doer -- triggers and awaits the target repo's
437
+ // CI workflow on the sprint branch head, so "CI is green" becomes an
438
+ // engine-verified fact handed to the reviewer instead of an acceptance
439
+ // criterion a doer dispatch cannot satisfy (a doer's credential is refused
440
+ // workflow_dispatch with HTTP 403 "Resource not accessible by integration").
441
+ //
442
+ // Every GitHub REST literal the gate needs lives HERE; ../ci-gate.mjs only
443
+ // sequences the five actions below and reads their answers through the parse
444
+ // hooks, so it never learns a GitHub field name. All five are plain curl
445
+ // commands built the same way as the PR builders above (token placeholder
446
+ // substituted server-side by vcs_credential_exec, -w '\n%{http_code}' status
447
+ // trailer), so they run through the same credential handoff.
448
+ //
449
+ // REST endpoints:
450
+ // branch-head GET /repos/{r}/branches/{branch}
451
+ // find-runs GET /repos/{r}/actions/workflows/{wf}/runs?head_sha={sha}
452
+ // dispatch POST /repos/{r}/actions/workflows/{wf}/dispatches {ref}
453
+ // get-run GET /repos/{r}/actions/runs/{id}
454
+ // list-jobs GET /repos/{r}/actions/runs/{id}/jobs
455
+
456
+ const CI_WORKFLOW_RE = /^[A-Za-z0-9._-]+$/;
457
+ const CI_SHA_RE = /^[0-9a-f]{7,64}$/i;
458
+ const CI_BRANCH_RE = /^[A-Za-z0-9._/-]+$/;
459
+
460
+ function assertCiParam(value, re, label) {
461
+ const text = String(value ?? '');
462
+ if (!re.test(text)) {
463
+ throw new Error(`ERROR: VCSModule: invalid CI gate ${label} "${value}".`);
464
+ }
465
+ return text;
466
+ }
467
+
468
+ /** Build one CI-gate curl command. `action` is one of the five above. */
469
+ function buildGitHubCiCommand(action, { repo, workflow, branch, sha, runId, token, os, shell }) {
470
+ const safeRepo = assertRepo(repo);
471
+ const safeToken = assertToken(token);
472
+ const base = `${GITHUB_API}/repos/${safeRepo}`;
473
+ let method = 'GET';
474
+ let url;
475
+ let payloadJson = null;
476
+ switch (action) {
477
+ case 'branch-head':
478
+ url = `${base}/branches/${assertCiParam(branch, CI_BRANCH_RE, 'branch')}`;
479
+ break;
480
+ case 'find-runs':
481
+ url = `${base}/actions/workflows/${assertCiParam(workflow, CI_WORKFLOW_RE, 'workflow')}/runs?head_sha=${assertCiParam(sha, CI_SHA_RE, 'head sha')}&per_page=20`;
482
+ break;
483
+ case 'dispatch':
484
+ method = 'POST';
485
+ url = `${base}/actions/workflows/${assertCiParam(workflow, CI_WORKFLOW_RE, 'workflow')}/dispatches`;
486
+ payloadJson = JSON.stringify({ ref: assertCiParam(branch, CI_BRANCH_RE, 'branch') });
487
+ break;
488
+ case 'get-run':
489
+ url = `${base}/actions/runs/${assertCiParam(runId, /^\d+$/, 'run id')}`;
490
+ break;
491
+ case 'list-jobs':
492
+ url = `${base}/actions/runs/${assertCiParam(runId, /^\d+$/, 'run id')}/jobs?per_page=100`;
493
+ break;
494
+ default:
495
+ throw new Error(`ERROR: VCSModule: unknown CI gate action "${action}".`);
496
+ }
497
+ const buildCurl = (authToken) => [
498
+ `${curlBinary(os)} -sS -X ${method}`,
499
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
500
+ `-H ${shQuote('Accept: application/vnd.github+json', os, shell)}`,
501
+ `-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os, shell)}`,
502
+ ...(payloadJson !== null
503
+ ? [`-H ${shQuote('Content-Type: application/json', os, shell)}`, `-d ${shQuoteJson(payloadJson, os, shell)}`]
504
+ : []),
505
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
506
+ shQuote(url, os, shell),
507
+ ].join(' ');
508
+ return {
509
+ provider: 'github',
510
+ action: `ci-${action}`,
511
+ command: buildCurl(safeToken),
512
+ logSafeCommand: buildCurl(REDACTED),
513
+ };
514
+ }
515
+
516
+ function normalizeGitHubRun(run) {
517
+ if (!run || typeof run !== 'object') return null;
518
+ const id = typeof run.id === 'number' || (typeof run.id === 'string' && /^\d+$/.test(run.id)) ? String(run.id) : null;
519
+ if (!id) return null;
520
+ return {
521
+ id,
522
+ url: typeof run.html_url === 'string' ? run.html_url : null,
523
+ headSha: typeof run.head_sha === 'string' ? run.head_sha : null,
524
+ status: typeof run.status === 'string' ? run.status : null,
525
+ conclusion: typeof run.conclusion === 'string' ? run.conclusion : null,
526
+ createdAt: typeof run.created_at === 'string' ? run.created_at : null,
527
+ };
528
+ }
529
+
530
+ const githubCiGate = Object.freeze({
531
+ /** What an operator must grant for the gate to trigger a run. Quoted
532
+ * verbatim into the FAILED-TO-RUN log line. */
533
+ requiredPermission: "actions:write on the workflow (GitHub App 'Actions' repository permission: Read and write)",
534
+ build: buildGitHubCiCommand,
535
+ /** A trigger/read refusal that is a missing permission, not a transient
536
+ * failure: 403, or GitHub's integration-scope wording at any status. */
537
+ isPermissionRefusal(status, text) {
538
+ return status === 403 || /Resource not accessible by (integration|personal access token)/i.test(String(text || ''));
539
+ },
540
+ parseBranchHead(body) {
541
+ const sha = body && body.commit && typeof body.commit.sha === 'string' ? body.commit.sha : null;
542
+ return sha && CI_SHA_RE.test(sha) ? sha : null;
543
+ },
544
+ /** Newest run in a find-runs listing whose head sha is exactly `sha`. */
545
+ parseFindRuns(body, sha) {
546
+ const runs = body && Array.isArray(body.workflow_runs) ? body.workflow_runs : [];
547
+ const matching = runs.map(normalizeGitHubRun).filter((r) => r && r.headSha === sha);
548
+ matching.sort((a, b) => Number(b.id) - Number(a.id));
549
+ return matching[0] || null;
550
+ },
551
+ parseRun: normalizeGitHubRun,
552
+ isRunComplete(run) {
553
+ return !!run && run.status === 'completed';
554
+ },
555
+ isRunSuccess(run) {
556
+ return !!run && run.conclusion === 'success';
557
+ },
558
+ parseJobs(body) {
559
+ const jobs = body && Array.isArray(body.jobs) ? body.jobs : [];
560
+ return jobs.map((j) => ({
561
+ name: typeof j.name === 'string' ? j.name : '(unnamed job)',
562
+ conclusion: typeof j.conclusion === 'string' ? j.conclusion : (typeof j.status === 'string' ? j.status : 'unknown'),
563
+ }));
564
+ },
565
+ });
566
+
348
567
  export const GitHubVCS = Object.freeze({
349
568
  name: 'github',
350
569
  extends: 'generic-git',
@@ -374,9 +593,13 @@ export const GitHubVCS = Object.freeze({
374
593
  // apra-fleet-lzfv.4: GitHub's create-pull-request response dialect, stated
375
594
  // explicitly instead of left implicit in a caller (see above).
376
595
  pullRequestResponse,
596
+ // Engine CI gate axis (see above and ./index.mjs supportsCiGate()).
597
+ ciGate: githubCiGate,
377
598
  builders: Object.freeze({
378
599
  'create-pull-request': buildGitHubCreatePrCommand,
379
600
  comment: buildGitHubCommentCommand,
601
+ 'find-pull-request': buildGitHubFindPrCommand,
602
+ 'update-pull-request': buildGitHubUpdatePrCommand,
380
603
  }),
381
604
  });
382
605
 
@@ -81,7 +81,7 @@
81
81
  * // literal -- out of the shared
82
82
  * // callers. Only meaningful
83
83
  * // alongside parseRepoRef.
84
- * buildProvisionArgs: (ctx) => { args, note? }|{ error } // OPTIONAL;
84
+ * buildProvisionArgs: (ctx) => { args, note? }|{ skip: true, note? }|{ error } // OPTIONAL;
85
85
  * // provisioning axis. Build the
86
86
  * // provision_vcs_auth argument
87
87
  * // object for a member of this
@@ -112,6 +112,20 @@
112
112
  * // optional `note` string next to
113
113
  * // `args` is logged as an advisory,
114
114
  * // never treated as a failure.
115
+ * // A THIRD answer, `{ skip: true }`,
116
+ * // means "nothing to provision for
117
+ * // this request -- proceed on the
118
+ * // credential already deployed":
119
+ * // for a provider whose credential
120
+ * // is deployed out of band and has
121
+ * // no scope axis to widen, a
122
+ * // just-in-time re-provision is
123
+ * // both impossible and pointless,
124
+ * // and failing it would abort the
125
+ * // call it exists to enable (see
126
+ * // ./bitbucket.mjs). Pair it with a
127
+ * // `note` so the skip is never
128
+ * // silent.
115
129
  * defaultAuthMode: string|null // OPTIONAL, but declaring it (even
116
130
  * // as null) is what makes a provider
117
131
  * // part of resolveProvider()'s/
@@ -170,6 +184,62 @@
170
184
  * // not yet implemented" (fails
171
185
  * // closed with a typed ERROR:,
172
186
  * // never a silently wrong command)
187
+ * httpFailureHint: (statusOrCtx) => string|{ hint, remedy } // OPTIONAL;
188
+ * // REST failure explanation.
189
+ * // Called with a bare status
190
+ * // (legacy; returns a diagnosis
191
+ * // string, '' for none) or with
192
+ * // { status, body, headers,
193
+ * // availableSecrets, memberName,
194
+ * // repoRef, repo, local? } --
195
+ * // headers are the RESPONSE
196
+ * // headers (lowercased names) a
197
+ * // builder captured with curl
198
+ * // `-D -`; availableSecrets is
199
+ * // the credential-store name list
200
+ * // (null when unreadable). The
201
+ * // ctx form returns { hint,
202
+ * // remedy }: `hint` diagnoses the
203
+ * // failure from the response, and
204
+ * // a non-empty `remedy` REPLACES
205
+ * // authRemedy.hint for this one
206
+ * // failure (lead with the one-line
207
+ * // fix). Providers that ignore the
208
+ * // ctx keep working: a string
209
+ * // answer is used as the hint and
210
+ * // the generic remedy stays.
211
+ * credentialProbe: { // OPTIONAL; preflight credential
212
+ * build: (params) => { command, // probe axis, only consulted for
213
+ * logSafeCommand, interpret }, // a non-re-mintable provider
214
+ * expectedUsername?: string, // (authRemedy.serverSideReMintable
215
+ * remedy?: (ctx) => string // === false). With it, the VCS
216
+ * } // preflight (vcs-auth.mjs
217
+ * // createVcsAuthPreflightCallback)
218
+ * // runs git ls-remote AND `build`'s
219
+ * // REST command through
220
+ * // vcs_credential_exec with the
221
+ * // provider label (params: repoRef,
222
+ * // token = the {{vcs_token_inline}}
223
+ * // placeholder, os, shell) -- the
224
+ * // exact credential Publish PR
225
+ * // reads -- and, when
226
+ * // expectedUsername is set, checks
227
+ * // the helper's username= line
228
+ * // (read member-side, token line
229
+ * // never printed). ok only if all
230
+ * // pass. A REST refusal is worded
231
+ * // via httpFailureHint(ctx);
232
+ * // `remedy(ctx)` (ctx:
233
+ * // availableSecrets, memberName,
234
+ * // repoRef, local) words the fix
235
+ * // for every other failure. Omit it
236
+ * // and the preflight probes with
237
+ * // git ls-remote only, as before.
238
+ * findBeforeCreate: boolean, // OPTIONAL; create is not an upsert.
239
+ * // raiseVcsPrForMember runs
240
+ * // find-pull-request first and
241
+ * // updates a hit (PUT) instead of
242
+ * // POSTing a duplicate.
173
243
  * authRemedy: { // OPTIONAL; auth-self-heal axis
174
244
  * serverSideReMintable: boolean, // (apra-fleet-5co8.4.2). Whether
175
245
  * hint: string // the REACTIVE self-heal callback
@@ -251,6 +321,21 @@
251
321
  * // every AUTH_DENIED it produces
252
322
  * // keeps today's self-heal
253
323
  * // treatment.
324
+ * ciGate: { // OPTIONAL; engine CI gate axis
325
+ * requiredPermission: string, // (../ci-gate.mjs). Lets the
326
+ * build(action, params), // orchestrator trigger and await
327
+ * isPermissionRefusal(status, text),// a CI workflow run on the sprint
328
+ * parseBranchHead(body), // branch head. `build` returns a
329
+ * parseFindRuns(body, sha), // { command, logSafeCommand }
330
+ * parseRun(body), // curl for one of 'branch-head',
331
+ * isRunComplete(run), // 'find-runs', 'dispatch',
332
+ * isRunSuccess(run), // 'get-run', 'list-jobs'; the
333
+ * parseJobs(body), // parse hooks keep every REST
334
+ * } // field name in the provider.
335
+ * // Omitted = no CI support:
336
+ * // supportsCiGate() is false and
337
+ * // a configured gate fails loudly
338
+ * // naming the provider.
254
339
  * }
255
340
  *
256
341
  * The manifest is an explicit import list rather than a directory scan on
@@ -368,6 +453,24 @@ export function registerVcsProvider(impl) {
368
453
  throw new Error(`ERROR: VCSModule: provider "${impl.name}" has an \`authRemedy\` with no non-empty string \`hint\`.`); // shell-guard-allow: escaped backtick is markdown-style inline-code formatting in a thrown developer-facing Error message, never a shell command string -- shell-command-guard flags any literal backtick in any JS string, not just dispatched command-string arguments.
369
454
  }
370
455
  }
456
+ // The preflight credential-probe axis. OPTIONAL, validated up front for
457
+ // the same reason as the hooks above: a malformed probe must fail at
458
+ // registration, not inside a sprint preflight that never throws.
459
+ if (impl.httpFailureHint != null && typeof impl.httpFailureHint !== 'function') {
460
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a non-function httpFailureHint.`);
461
+ }
462
+ if (impl.credentialProbe != null) {
463
+ const probe = impl.credentialProbe;
464
+ if (typeof probe !== 'object' || typeof probe.build !== 'function') {
465
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a credentialProbe with no build function.`);
466
+ }
467
+ if (probe.expectedUsername != null && (typeof probe.expectedUsername !== 'string' || !probe.expectedUsername.trim())) {
468
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a credentialProbe with a non-string or empty expectedUsername.`);
469
+ }
470
+ if (probe.remedy != null && typeof probe.remedy !== 'function') {
471
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a credentialProbe with a non-function remedy.`);
472
+ }
473
+ }
371
474
  // The permission-scope axis. OPTIONAL (omitting it means "this provider
372
475
  // declares no permission-scope rules", i.e. today's behavior for every
373
476
  // AUTH_DENIED it produces), but validated up front for the same reason as
@@ -404,10 +507,44 @@ export function registerVcsProvider(impl) {
404
507
  }
405
508
  }
406
509
  }
510
+ if (impl.ciGate != null) {
511
+ if (typeof impl.ciGate !== 'object') {
512
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a non-object ciGate.`);
513
+ }
514
+ for (const hook of CI_GATE_HOOKS) {
515
+ if (typeof impl.ciGate[hook] !== 'function') {
516
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a ciGate with a non-function ${hook}.`);
517
+ }
518
+ }
519
+ if (typeof impl.ciGate.requiredPermission !== 'string' || !impl.ciGate.requiredPermission.trim()) {
520
+ throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a ciGate with no non-empty string requiredPermission.`);
521
+ }
522
+ }
407
523
  registry.set(impl.name, impl);
408
524
  return impl.name;
409
525
  }
410
526
 
527
+ /** Every function a provider's `ciGate` descriptor must declare (see the
528
+ * header's ciGate contract and ../ci-gate.mjs, its only consumer). */
529
+ const CI_GATE_HOOKS = Object.freeze([
530
+ 'build', 'isPermissionRefusal', 'parseBranchHead', 'parseFindRuns',
531
+ 'parseRun', 'isRunComplete', 'isRunSuccess', 'parseJobs',
532
+ ]);
533
+
534
+ /**
535
+ * The engine CI gate's provider capability flag: whether `impl` can trigger
536
+ * and await a CI workflow run on a branch head (its descriptor declares a
537
+ * `ciGate`). A provider without it (generic-git, bitbucket, azure-devops
538
+ * today) makes a configured gate FAIL LOUDLY naming the provider -- never a
539
+ * silent skip (see ../ci-gate.mjs).
540
+ *
541
+ * @param {object|undefined} impl
542
+ * @returns {boolean}
543
+ */
544
+ export function supportsCiGate(impl) {
545
+ return !!impl && !!impl.ciGate && typeof impl.ciGate === 'object';
546
+ }
547
+
411
548
  /** Remove a registered provider. Intended for tests that register a throwaway
412
549
  * provider and must not leak it into later cases. */
413
550
  export function unregisterVcsProvider(name) {
@@ -88,7 +88,7 @@ function usesPowerShellQuoting(os, shell) {
88
88
  * NOT toggle on it -- so for a value carrying BOTH whitespace and quotes
89
89
  * the two parsers disagree about whether that whitespace is "inside
90
90
  * quotes", the binder skips its wrapping, and the CRT splits the argument
91
- * at the whitespace (observed: a JSON title 'Auto-sprint [PASS]: x'
91
+ * at the whitespace (observed: a JSON title 'fleet-sprint [PASS]: x'
92
92
  * arrived as two argv entries). There is no escape sequence both parsers
93
93
  * read the same way, so a caller must keep such a value whitespace-free --
94
94
  * see shQuoteJson() below, which does exactly that for JSON payloads (the
@@ -112,8 +112,10 @@ function shQuote(value, os, shell) {
112
112
  // above (what the NATIVE child parses), then PowerShell's own
113
113
  // single-quoted-string escape (what PowerShell parses to get the
114
114
  // value it hands the binder) -- a lone `'` inside a `'...'` string
115
- // is written as `''`.
116
- return `'${escapeForWindowsArgv(value).replace(/'/g, "''")}'`;
115
+ // is written as `''`. PowerShell also ends a single-quoted string on
116
+ // U+2018..U+201B (common in LLM-written PR text), so each of those is
117
+ // doubled as itself too.
118
+ return `'${escapeForWindowsArgv(value).replace(/['\u2018-\u201B]/g, '$&$&')}'`;
117
119
  }
118
120
  return `'${String(value).replace(/'/g, `'\\''`)}'`;
119
121
  }
@@ -129,7 +131,9 @@ function shQuote(value, os, shell) {
129
131
  * exact JSON the caller built. Whitespace cannot appear outside a string
130
132
  * in JSON.stringify() output, so the rewrite is always inside a string. */
131
133
  function shQuoteJson(json, os, shell) {
132
- const text = String(json);
134
+ // A raw backtick can only occur inside a JSON string here; ` decodes
135
+ // back to it, and keeps backticks out of the dispatched command text.
136
+ const text = String(json).replace(/`/g, '\\u0060');
133
137
  if (!usesPowerShellQuoting(os, shell)) return shQuote(text, os, shell);
134
138
  const noWhitespace = text.replace(/\s/g, (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, '0')}`);
135
139
  return shQuote(noWhitespace, os, shell);
@@ -0,0 +1,152 @@
1
+ // =============================================================================
2
+ // VERIFY-BLOCK DEADLOCK DIAGNOSIS (GitHub #717).
3
+ //
4
+ // A verify-routed bead (classifyVerifySet in beads-scope.mjs: childful, every
5
+ // child closed, no unmet blocker) closes ONLY in the Integration Test phase,
6
+ // and that phase runs only when integ-test-playbook.md exists AND deploy.md
7
+ // exists AND the deploy succeeded this cycle. A bead whose only unmet `blocks`
8
+ // dependencies are verify-routed beads can therefore never become ready while
9
+ // the Integration Test phase cannot run -- the sprint used to loop, paying for
10
+ // cycles, until the stall net ended it FAIL with no diagnosis.
11
+ //
12
+ // This module is the pure half of the fix: the one integCanRun predicate, the
13
+ // shape detector and the diagnosis text (which names every blocked bead, its
14
+ // verify-routed blockers and the exact fix). runner.js owns the runbook
15
+ // probes, the pre-sprint stop and the mid-run exit; phases/final-review.mjs
16
+ // applies the verdict gate. Diagnose only: nothing here rewrites the DAG.
17
+ //
18
+ // GUARD COVERAGE: registered in guarded-modules.mjs. It carries no command()
19
+ // or agent() call site.
20
+ // =============================================================================
21
+
22
+ const NOT_DONE = new Set(['open', 'in_progress', 'blocked']);
23
+
24
+ /**
25
+ * Whether the Integration Test phase can run (and so close verify-routed
26
+ * beads): integ-test-playbook.md present AND deploy.md present AND the deploy
27
+ * either succeeded this cycle or has not been attempted yet.
28
+ * @param {{ hasPlaybook: boolean, hasDeploy: boolean, deployAttempted?: boolean, deployedThisCycle?: boolean }} s
29
+ */
30
+ export function integCanRun({ hasPlaybook, hasDeploy, deployAttempted = false, deployedThisCycle = false }) {
31
+ return Boolean(hasPlaybook) && Boolean(hasDeploy) && (!deployAttempted || Boolean(deployedThisCycle));
32
+ }
33
+
34
+ /**
35
+ * Why the Integration Test phase cannot run, in the precedence an operator
36
+ * has to fix it in; null when it can run.
37
+ * @returns {'no-playbook'|'no-deploy'|'deploy-failed'|null}
38
+ */
39
+ export function integBlockCause({ hasPlaybook, hasDeploy, deployAttempted = false, deployedThisCycle = false }) {
40
+ if (!hasPlaybook) return 'no-playbook';
41
+ if (!hasDeploy) return 'no-deploy';
42
+ if (deployAttempted && !deployedThisCycle) return 'deploy-failed';
43
+ return null;
44
+ }
45
+
46
+ /**
47
+ * Not-done beads whose unmet `blocks` dependencies are ALL verify-routed
48
+ * beads (and at least one exists). A dependency on a bead the snapshot does
49
+ * not know counts as unmet and NOT verify-routed, so it never produces a
50
+ * false diagnosis.
51
+ *
52
+ * @param {object[]} candidateBeads the beads to check (the sprint scope)
53
+ * @param {object[]} allBeads a full any-status snapshot for status lookup
54
+ * @param {string[]} verifyIds verify-routed bead ids
55
+ * @returns {{ id: string, title: string, priority: number|null, blockerIds: string[] }[]}
56
+ */
57
+ export function findVerifyBlockedBeads(candidateBeads, allBeads, verifyIds) {
58
+ const verify = new Set(verifyIds || []);
59
+ if (verify.size === 0) return [];
60
+ const statusById = new Map((allBeads || []).map((b) => [b.id, b.status]));
61
+ const out = [];
62
+ for (const bead of candidateBeads || []) {
63
+ if (!bead || verify.has(bead.id) || !NOT_DONE.has(bead.status)) continue;
64
+ const unmet = (bead.dependencies || [])
65
+ .filter((d) => d && d.type === 'blocks')
66
+ .map((d) => d.depends_on_id)
67
+ .filter((depId) => statusById.get(depId) !== 'closed');
68
+ if (unmet.length === 0 || !unmet.every((depId) => verify.has(depId))) continue;
69
+ out.push({
70
+ id: bead.id,
71
+ title: bead.title || '',
72
+ priority: Number.isInteger(bead.priority) ? bead.priority : null,
73
+ blockerIds: [...new Set(unmet)].sort(),
74
+ });
75
+ }
76
+ return out.sort((a, b) => a.id.localeCompare(b.id));
77
+ }
78
+
79
+ /**
80
+ * Split blocked beads into goal-priority (stop) and below-goal (warn only).
81
+ * `goalMax` is goalPriorityMax()'s 'Pn' token (a bare number is accepted
82
+ * too); a bead with no recorded priority counts as at-goal.
83
+ */
84
+ export function partitionByGoal(blocked, goalMax) {
85
+ const max = typeof goalMax === 'number' ? goalMax : Number(String(goalMax).replace(/^P/i, ''));
86
+ if (!Number.isFinite(max)) {
87
+ throw new TypeError(`partitionByGoal: goalMax must be a 'Pn' priority token or a number; got ${JSON.stringify(goalMax)}`);
88
+ }
89
+ const atGoal = [];
90
+ const belowGoal = [];
91
+ for (const b of blocked || []) {
92
+ if (b.priority === null || b.priority <= max) atGoal.push(b);
93
+ else belowGoal.push(b);
94
+ }
95
+ return { atGoal, belowGoal };
96
+ }
97
+
98
+ const CAUSE_TEXT = {
99
+ 'no-playbook': {
100
+ why: 'integ-test-playbook.md is missing, so the Integration Test phase never runs',
101
+ fix: 'add integ-test-playbook.md so the Integration Test phase can verify and close the verify-routed blocker(s)',
102
+ },
103
+ 'no-deploy': {
104
+ why: 'deploy.md is missing, so there is no deployed build and the Integration Test phase never runs',
105
+ fix: 'add deploy.md so the build can be deployed and the Integration Test phase can verify and close the verify-routed blocker(s)',
106
+ },
107
+ 'deploy-failed': {
108
+ why: 'the deploy failed this cycle, so the Integration Test phase did not run',
109
+ fix: 'fix the failing deploy (see the deploy notes) and re-run the sprint, so the Integration Test phase can verify and close the verify-routed blocker(s)',
110
+ },
111
+ };
112
+
113
+ /**
114
+ * The named diagnosis: every blocked bead, its verify-routed blockers, why the
115
+ * Integration Test phase cannot run, and the exact fix -- either make it able
116
+ * to run, or (when the ordering is not real) remove the dependency with the
117
+ * exact `bd dep remove <blocked> <blocker>` command.
118
+ * @param {{ blocked: object[], cause: string, deployNotes?: string|null }} opts
119
+ */
120
+ export function buildVerifyBlockDiagnosis({ blocked, cause, deployNotes = null }) {
121
+ const text = CAUSE_TEXT[cause] || CAUSE_TEXT['no-playbook'];
122
+ const list = blocked
123
+ .map((b) => `${b.id}${b.title ? ` (${b.title})` : ''} is blocked only by verify-routed bead(s) ${b.blockerIds.join(', ')}`)
124
+ .join('; ');
125
+ const depRemovals = blocked
126
+ .flatMap((b) => b.blockerIds.map((blocker) => `bd dep remove ${b.id} ${blocker}`))
127
+ .join('; ');
128
+ return (
129
+ `Verify-block deadlock: ${blocked.length} bead(s) can never become ready -- every unmet blocker is a ` +
130
+ 'verify-routed bead (all of its children closed), which only the Integration Test phase can close, and ' +
131
+ `${text.why}${cause === 'deploy-failed' && deployNotes ? ` (${deployNotes})` : ''}. ${list}. ` +
132
+ `Fix: ${text.fix}; or, if the ordering is not a real need, remove the dependency: ${depRemovals}.`
133
+ );
134
+ }
135
+
136
+ /**
137
+ * The verdict gate for a sprint that ended on a verify-block deadlock: never
138
+ * PASS. Mirrors the deploy-failure gate in phases/deploy.mjs -- the verdict
139
+ * becomes FAIL and the diagnosis leads the notes.
140
+ */
141
+ export function applyVerifyBlockVerdictGate(verdictResult, diagnosis) {
142
+ if (!diagnosis) return verdictResult;
143
+ const prior = verdictResult && typeof verdictResult.notes === 'string' ? verdictResult.notes : '';
144
+ const overridden = !verdictResult || verdictResult.verdict === 'PASS';
145
+ return {
146
+ ...(verdictResult || {}),
147
+ verdict: 'FAIL',
148
+ notes: diagnosis +
149
+ (overridden ? ' (Final Review returned PASS; the engine overrode it to FAIL.)' : '') +
150
+ (prior ? `\n\n${prior}` : ''),
151
+ };
152
+ }