@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
@@ -32,6 +32,7 @@ import {
32
32
  import { ApraFleet } from '@apralabs/apra-fleet-client';
33
33
  import { resolveProvider, capabilities as vcsCapabilities } from './vcs-module.mjs';
34
34
  import { raiseVcsPrForMember, PR_SKIPPED_NO_MCP_CLIENT } from './vcs-auth.mjs';
35
+ import { buildSprintPrBody } from './pr-body.mjs';
35
36
  import {
36
37
  findDoltDivergedCause, runGitStep, sanitizePrText, stageCommandBodyMemberSide, SAFE_TEXT_RE,
37
38
  } from './runner.js';
@@ -50,11 +51,15 @@ export async function persistNewTaskBestEffort({ createFn, command, member, pare
50
51
  const result = await createFn();
51
52
  return result ?? true;
52
53
  } catch (err) {
53
- log(`[fleet-sprint] newTask bd create FAILED (non-fatal, ${stage}): ${err.message} -- falling back to parent-bead notes.`);
54
+ // Child ids the failed attempts consumed (never re-pooled), so the
55
+ // notes fallback names them alongside the finding.
56
+ const consumed = Array.isArray(err && err.consumedIds) ? err.consumedIds.filter(Boolean) : [];
57
+ const consumedNote = consumed.length > 0 ? ` [consumed child ids: ${consumed.join(', ')}]` : '';
58
+ log(`[fleet-sprint] newTask bd create FAILED (non-fatal, ${stage}): ${err.message}${consumedNote} -- falling back to parent-bead notes.`);
54
59
  try {
55
60
  await appendRejectedFindingToParentNotes({
56
61
  command, member, parentId, newTask,
57
- reason: `bd create failed (${stage}): ${err.message}`, cycle, log,
62
+ reason: `bd create failed (${stage}): ${err.message}${consumedNote}`, cycle, log,
58
63
  });
59
64
  } catch (err2) {
60
65
  log(`[fleet-sprint] newTask persistence FAILED at every level (non-fatal, ${stage}); finding preserved VERBATIM in this run log: ${JSON.stringify(newTask)} -- last error: ${err2.message}`);
@@ -66,35 +71,120 @@ export async function persistNewTaskBestEffort({ createFn, command, member, pare
66
71
  const SAFE_DESCRIPTION_RE = /^[\t\n\r\x20-\x7E]+$/;
67
72
  const SAFE_PRIORITY_RE = /^P[0-4]$/;
68
73
 
74
+ // Unicode arrow code points the newTask sanitisers recognise (kept as \u
75
+ // escapes so this source stays ASCII-only):
76
+ // right: U+2192, U+27F6, U+21A6, U+2794, U+279C, U+27A1, U+2B62, U+21E8
77
+ // double right: U+21D2, U+27F9
78
+ // left: U+2190, U+27F5 double left: U+21D0, U+27F8
79
+ // both: U+2194, U+27F7 double both: U+21D4, U+27FA
80
+ const UNICODE_RIGHT_ARROW_RE = /[\u2192\u27F6\u21A6\u2794\u279C\u27A1\u2B62\u21E8]/g;
81
+ const UNICODE_DOUBLE_RIGHT_ARROW_RE = /[\u21D2\u27F9]/g;
82
+ const UNICODE_LEFT_ARROW_RE = /[\u2190\u27F5]/g;
83
+ const UNICODE_DOUBLE_LEFT_ARROW_RE = /[\u21D0\u27F8]/g;
84
+ const UNICODE_BOTH_ARROW_RE = /[\u2194\u27F7]/g;
85
+ const UNICODE_DOUBLE_BOTH_ARROW_RE = /[\u21D4\u27FA]/g;
86
+
87
+ /**
88
+ * Fixed substitution table for newTask DESCRIPTIONS. Description only has to
89
+ * pass SAFE_DESCRIPTION_RE (printable ASCII), so every entry maps to its
90
+ * plain-ASCII spelling: Unicode arrows become `->` / `=>` / `<-` / `<=` /
91
+ * `<->` / `<=>`, Unicode comparison signs become `>=` / `<=` / `!=`.
92
+ */
93
+ const DESCRIPTION_SUBSTITUTIONS = [
94
+ [/[\u2014\u2013]/g, '--'], // em dash (\u2014), en dash (\u2013)
95
+ [/[\u2018\u2019]/g, "'"], // curly single quotes (\u2018 \u2019)
96
+ [/[\u201C\u201D]/g, '"'], // curly double quotes (\u201C \u201D)
97
+ [/\u2026/g, '...'], // horizontal ellipsis (\u2026)
98
+ [UNICODE_DOUBLE_BOTH_ARROW_RE, '<=>'],
99
+ [UNICODE_BOTH_ARROW_RE, '<->'],
100
+ [UNICODE_DOUBLE_RIGHT_ARROW_RE, '=>'],
101
+ [UNICODE_RIGHT_ARROW_RE, '->'],
102
+ [UNICODE_DOUBLE_LEFT_ARROW_RE, '<='],
103
+ [UNICODE_LEFT_ARROW_RE, '<-'],
104
+ [/\u2265/g, '>='], // greater-than or equal (\u2265)
105
+ [/\u2264/g, '<='], // less-than or equal (\u2264)
106
+ [/\u2260/g, '!='], // not equal (\u2260)
107
+ ];
108
+
109
+ /**
110
+ * Fixed substitution table for newTask TITLES. Title must pass SAFE_TEXT_RE,
111
+ * which admits none of `>`, `<`, `=`, `&`, so arrows and comparison operators
112
+ * are spelled out as words. ORDER MATTERS: multi-character tokens come before
113
+ * the single characters they contain (`<=>` before `<=` before `<`, `->`
114
+ * before a lone `>`, `>=` before `=`), and the Unicode dash rewrite runs
115
+ * first so an em-dash arrow (U+2014 followed by `>`) is caught by the `->`
116
+ * entry. Every replacement is space-padded; sanitizeNewTaskTitle() collapses
117
+ * runs of spaces and trims afterwards.
118
+ */
119
+ const TITLE_SUBSTITUTIONS = [
120
+ [/[\u2014\u2013]/g, '--'], // em dash (\u2014), en dash (\u2013)
121
+ [/[\u2018\u2019]/g, "'"], // curly single quotes (\u2018 \u2019)
122
+ [/[\u201C\u201D]/g, "'"], // curly double quotes -> single quote (a literal `"` stays disallowed in title, unlike description)
123
+ [/\u2026/g, '...'], // horizontal ellipsis (\u2026)
124
+ [/`/g, "'"], // backtick (Markdown inline-code marker) -> single quote
125
+ // Bidirectional arrows first (they contain both `<` and `>`).
126
+ [UNICODE_DOUBLE_BOTH_ARROW_RE, ' to/from '],
127
+ [UNICODE_BOTH_ARROW_RE, ' to/from '],
128
+ [/<=+>|<-+>/g, ' to/from '],
129
+ // Right arrows.
130
+ [UNICODE_DOUBLE_RIGHT_ARROW_RE, ' to '],
131
+ [UNICODE_RIGHT_ARROW_RE, ' to '],
132
+ [/-+>|=+>/g, ' to '],
133
+ // Unicode left arrows. An ASCII `<-` is deliberately NOT treated as an
134
+ // arrow (`x<-1` is more often a comparison), so it falls through to ` lt `.
135
+ [UNICODE_DOUBLE_LEFT_ARROW_RE, ' from '],
136
+ [UNICODE_LEFT_ARROW_RE, ' from '],
137
+ // Comparison operators, multi-character before single.
138
+ [/\u2265/g, ' at least '], // greater-than or equal (\u2265)
139
+ [/\u2264/g, ' at most '], // less-than or equal (\u2264)
140
+ [/\u2260/g, ' ne '], // not equal (\u2260)
141
+ [/>=/g, ' at least '],
142
+ [/<=/g, ' at most '],
143
+ [/!=/g, ' ne '],
144
+ [/==+/g, ' eq '],
145
+ [/&&/g, ' and '],
146
+ [/>/g, ' gt '],
147
+ [/</g, ' lt '],
148
+ [/=/g, ' eq '],
149
+ [/&/g, ' and '],
150
+ ];
151
+
152
+ function applySubstitutions(text, table) {
153
+ let out = text;
154
+ for (const [re, replacement] of table) out = out.replace(re, replacement);
155
+ return out;
156
+ }
157
+
69
158
  /**
70
- * Rewrites the handful of common non-ASCII punctuation characters LLM
71
- * reviewers routinely emit in newTask descriptions -- em/en dashes, curly
72
- * quotes, ellipsis -- to ASCII equivalents before SAFE_DESCRIPTION_RE
73
- * validation, so a description is not rejected wholesale over characters that
74
- * lose no meaning when normalized. This is a fixed substitution table, not a
75
- * general Unicode stripper: anything still outside the allowlist afterwards is
76
- * still a hard rejection. See sanitizeNewTaskTitle() below for title's own,
77
- * stricter table.
159
+ * Rewrites common non-ASCII punctuation LLM reviewers routinely emit in
160
+ * newTask descriptions -- em/en dashes, curly quotes, ellipsis, Unicode
161
+ * arrows and comparison signs -- to ASCII equivalents before
162
+ * SAFE_DESCRIPTION_RE validation, so a description is not rejected wholesale
163
+ * over characters that lose no meaning when normalized. This is a FIXED
164
+ * substitution table (DESCRIPTION_SUBSTITUTIONS), not a general Unicode
165
+ * stripper: anything still outside the allowlist afterwards is still a hard
166
+ * rejection. See sanitizeNewTaskTitle() below for title's own, stricter table.
78
167
  * @param {string} description
79
168
  * @returns {string}
80
169
  */
81
170
  export function sanitizeNewTaskDescription(description) {
82
- return String(description ?? '')
83
- .replace(/[\u2014\u2013]/g, '--') // em dash (\u2014), en dash (\u2013)
84
- .replace(/[\u2018\u2019]/g, "'") // curly single quotes (\u2018 \u2019)
85
- .replace(/[\u201C\u201D]/g, '"') // curly double quotes (\u201C \u201D)
86
- .replace(/\u2026/g, '...'); // horizontal ellipsis (\u2026)
171
+ return applySubstitutions(String(description ?? ''), DESCRIPTION_SUBSTITUTIONS);
87
172
  }
88
173
 
89
174
  /**
90
175
  * Same idea as sanitizeNewTaskDescription() above, for title -- but with a
91
- * STRICTER substitution table, since title still has to pass the tighter
92
- * SAFE_TEXT_RE shell-safety allowlist afterwards (it is interpolated inline
93
- * into a `bd create "..."` command; description is not). Every substitution
94
- * here maps to a character SAFE_TEXT_RE already admits, so this never
95
- * reopens the injection surface that allowlist exists to close -- it only
96
- * rescues titles that would otherwise be needlessly rejected over benign,
97
- * common LLM punctuation choices. Observed live (apra-fleet-vk0a's sibling
176
+ * STRICTER substitution table (TITLE_SUBSTITUTIONS), since title still has
177
+ * to pass the tighter SAFE_TEXT_RE shell-safety allowlist afterwards (it is
178
+ * interpolated inline into a `bd create "..."` command; description is not).
179
+ * Every substitution here maps to characters SAFE_TEXT_RE already admits, so
180
+ * this never reopens the injection surface that allowlist exists to close --
181
+ * it only rescues titles that would otherwise be needlessly rejected over
182
+ * benign, common LLM punctuation choices:
183
+ * - arrows (`->`, `=>`, Unicode right arrows) -> " to ", Unicode left
184
+ * arrows -> " from ", bidirectional arrows -> " to/from ";
185
+ * - `>=` / `<=` -> " at least " / " at most ", `!=` -> " ne ", lone `>` /
186
+ * `<` -> " gt " / " lt ", `=` -> " eq ", `&` -> " and ";
187
+ * then runs of spaces are collapsed and the result is trimmed. Observed live (apra-fleet-vk0a's sibling
98
188
  * finding): a reviewer wrote a title referencing a CLI command in backticks
99
189
  * (`` `apra-fleet status` ``, ordinary Markdown inline-code style), which
100
190
  * SAFE_TEXT_RE rejects outright (backtick is excluded as a POSIX
@@ -110,12 +200,64 @@ export function sanitizeNewTaskDescription(description) {
110
200
  * @returns {string}
111
201
  */
112
202
  export function sanitizeNewTaskTitle(title) {
113
- return String(title ?? '')
114
- .replace(/[\u2014\u2013]/g, '--') // em dash (\u2014), en dash (\u2013)
115
- .replace(/[\u2018\u2019]/g, "'") // curly single quotes (\u2018 \u2019)
116
- .replace(/[\u201C\u201D]/g, "'") // curly double quotes -> single quote (a literal `"` stays disallowed in title, unlike description)
117
- .replace(/\u2026/g, '...') // horizontal ellipsis (\u2026)
118
- .replace(/`/g, "'"); // backtick (Markdown inline-code marker) -> single quote
203
+ return applySubstitutions(String(title ?? ''), TITLE_SUBSTITUTIONS)
204
+ .replace(/ {2,}/g, ' ')
205
+ .trim();
206
+ }
207
+
208
+ /**
209
+ * Escapes a value to pure printable ASCII: JSON.stringify (quotes, control
210
+ * characters, backslashes) plus \uXXXX for every remaining non-ASCII UTF-16
211
+ * code unit. The result always passes SAFE_DESCRIPTION_RE and JSON.parse
212
+ * decodes it back to the original string.
213
+ * @param {unknown} value
214
+ * @returns {string}
215
+ */
216
+ export function escapeToAsciiJson(value) {
217
+ return JSON.stringify(String(value ?? '')).replace(
218
+ /[^\x20-\x7E]/g,
219
+ (ch) => `\\u${ch.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')}`,
220
+ );
221
+ }
222
+
223
+ const FALLBACK_TITLE_PLACEHOLDER = 'Follow-up finding (original title not shell-safe)';
224
+
225
+ // Prefix of the description line that preserves a reviewer's original title
226
+ // whenever the filed title differs from it (mapped, dash-stripped, or a
227
+ // fallback). Shared by validateNewTask() and buildFallbackNewTask().
228
+ const ORIGINAL_TITLE_LABEL = 'Original title (JSON-escaped, non-ASCII as \\uXXXX): ';
229
+
230
+ /**
231
+ * Builds a filable variant of a newTask whose TITLE still fails
232
+ * validateNewTask() after sanitizeNewTaskTitle(). The catch-all strip applies
233
+ * ONLY here, to this fallback title: every character SAFE_TEXT_RE does not
234
+ * admit becomes a space (spaces collapsed, trimmed; a fixed placeholder when
235
+ * nothing survives). The ORIGINAL title is preserved at the top of the
236
+ * description, escaped by escapeToAsciiJson() so SAFE_DESCRIPTION_RE passes.
237
+ * The result is re-validated through validateNewTask(); a priority or
238
+ * description failure is NOT rescued -- null is returned and the caller keeps
239
+ * its normal rejection path.
240
+ * @param {{ title: unknown, description: unknown, priority: unknown }} newTask
241
+ * @returns {{ ok: true, title: string, description: string, priority: string } | null}
242
+ */
243
+ export function buildFallbackNewTask(newTask) {
244
+ // Only a TITLE failure is rescued: priority and description must already
245
+ // pass on their own (checked with a known-safe stand-in title).
246
+ if (!validateNewTask({ ...(newTask || {}), title: FALLBACK_TITLE_PLACEHOLDER }).ok) return null;
247
+ const originalTitle = newTask && newTask.title;
248
+ const stripped = sanitizeNewTaskTitle(originalTitle)
249
+ .replace(/[^A-Za-z0-9 .,:;!?()'_/+[\]-]/g, ' ')
250
+ .replace(/ {2,}/g, ' ')
251
+ .trim()
252
+ // Strip leading dashes here too, so validateNewTask() receives a
253
+ // title it will not change and does not prepend a second
254
+ // original-title line quoting this intermediate fallback title.
255
+ .replace(/^[-\s]+/, '');
256
+ const fallbackTitle = stripped && SAFE_TEXT_RE.test(stripped) ? stripped : FALLBACK_TITLE_PLACEHOLDER;
257
+ const originalDescription = String((newTask && newTask.description) ?? '');
258
+ const description = `${ORIGINAL_TITLE_LABEL}${escapeToAsciiJson(originalTitle)}\n\n${originalDescription}`;
259
+ const result = validateNewTask({ title: fallbackTitle, description, priority: newTask && newTask.priority });
260
+ return result.ok ? result : null;
119
261
  }
120
262
 
121
263
  /**
@@ -135,11 +277,31 @@ export function validateNewTask(newTask) {
135
277
  if (!SAFE_PRIORITY_RE.test(priority)) {
136
278
  return { ok: false, reason: `priority '${priority}' does not match required pattern ${SAFE_PRIORITY_RE}` };
137
279
  }
138
- const title = sanitizeNewTaskTitle(newTask && newTask.title);
139
- if (!title || !SAFE_TEXT_RE.test(title)) {
140
- return { ok: false, reason: `title fails safe-character allowlist ${SAFE_TEXT_RE} (or is empty): ${JSON.stringify(title)}` };
280
+ const sanitizedTitle = sanitizeNewTaskTitle(newTask && newTask.title);
281
+ if (!sanitizedTitle || !SAFE_TEXT_RE.test(sanitizedTitle)) {
282
+ return { ok: false, reason: `title fails safe-character allowlist ${SAFE_TEXT_RE} (or is empty): ${JSON.stringify(sanitizedTitle)}` };
283
+ }
284
+ // The title is the first positional argument of `bd create`, so a leading
285
+ // '-' would be parsed as a flag. Strip leading dashes (and the whitespace
286
+ // after them) shell-independently. A title that is only dashes becomes
287
+ // empty and is rejected below, falling through to the parent-notes
288
+ // fallback.
289
+ const title = sanitizedTitle.replace(/^[-\s]+/, '');
290
+ if (!title) {
291
+ return { ok: false, reason: `title is empty after removing leading dashes: ${JSON.stringify(sanitizedTitle)}` };
292
+ }
293
+ // Whenever the filed title differs from the reviewer's original -- mapped
294
+ // by sanitizeNewTaskTitle() (`Map<K, V>` -> `Map lt K, V gt`,
295
+ // `--flag=value` -> `--flag eq value`) or dash-stripped above -- keep the
296
+ // ORIGINAL title, escaped to ASCII by escapeToAsciiJson(), at the top of
297
+ // the description so nothing is lost. Whitespace-only differences
298
+ // (trimming, collapsed runs of spaces) lose no information and do not
299
+ // count as a change.
300
+ const rawTitle = String((newTask && newTask.title) ?? '');
301
+ let description = sanitizeNewTaskDescription(newTask && newTask.description);
302
+ if (description && title !== rawTitle.replace(/ {2,}/g, ' ').trim()) {
303
+ description = `${ORIGINAL_TITLE_LABEL}${escapeToAsciiJson(rawTitle)}\n\n${description}`;
141
304
  }
142
- const description = sanitizeNewTaskDescription(newTask && newTask.description);
143
305
  if (!description || !SAFE_DESCRIPTION_RE.test(description)) {
144
306
  return { ok: false, reason: `description fails ASCII-printable validation ${SAFE_DESCRIPTION_RE} (or is empty): ${JSON.stringify(description)}` };
145
307
  }
@@ -265,7 +427,7 @@ export function isTypedAbortError(err) {
265
427
  // 1. counts commits on the sprint branch beyond base, which decides whether
266
428
  // there is anything for a human to look at;
267
429
  // 2. with >=1 commit, pushes the branch and raises an idempotent
268
- // 'Auto-sprint [ABORTED]: <branch>' PR whose body carries the error's
430
+ // 'fleet-sprint [ABORTED]: <branch>' PR whose body carries the error's
269
431
  // code/message/details, sanitized by sanitizePrText for the same reason
270
432
  // the PASS/FAIL step sanitizes reviewer notes;
271
433
  // 3. with 0 commits, raises no PR -- there is no diff, so the PR would be
@@ -282,12 +444,12 @@ export function isTypedAbortError(err) {
282
444
  * member: string,
283
445
  * command: (cmd: string, opts: object) => Promise<any>,
284
446
  * log?: (msg: string) => void,
285
- * onAuthFailure?: (info: { member: string, label: string, cmd?: string, error: string, kind: 'git'|'dolt' }) => Promise<void>,
447
+ * onAuthFailure?: (info: { member: string, label: string, cmd?: string, error: string, source: 'git'|'dolt', failureKind: string }) => Promise<void>,
286
448
  * callTool?: (name: string, args: object) => Promise<any>,
287
449
  * }} opts
288
450
  * @returns {Promise<{ prUrl: string|null, reason: string, pushed: boolean, commitCount: number }>}
289
451
  */
290
- export async function finalizeAbort({ error, branch, baseBranch, member, command, log = () => {}, onAuthFailure, callTool }) {
452
+ export async function finalizeAbort({ error, branch, baseBranch, member, command, log = () => {}, onAuthFailure, callTool, runId }) {
291
453
  // Built up-front (not just at the PR-creation step further down) so the
292
454
  // SAME ApraFleet client can also resolve `member`'s VCS provider
293
455
  // (apra-fleet-417.7) for the runGitStep calls below -- avoids
@@ -396,7 +558,7 @@ export async function finalizeAbort({ error, branch, baseBranch, member, command
396
558
  return { prUrl: null, reason: 'non-hosted-remote', pushed: true, commitCount };
397
559
  }
398
560
 
399
- const prTitle = `Auto-sprint [ABORTED]: ${branch}`;
561
+ const prTitle = `fleet-sprint [ABORTED]: ${branch}`;
400
562
  // The error's code/message/details can originate from agent output, and
401
563
  // this text is embedded in a VCSModule-built PR body -- same sanitization
402
564
  // rationale as the PASS/FAIL Publish PR step.
@@ -405,15 +567,31 @@ export async function finalizeAbort({ error, branch, baseBranch, member, command
405
567
  const safeDetails = sanitizePrText(
406
568
  error && error.details !== undefined ? JSON.stringify(error.details) : ''
407
569
  );
408
- const prBody = [
409
- `Automated apra-fleet-se sprint ABORTED before reaching a final PASS/FAIL verdict.`,
410
- '',
411
- safeCode ? `Error code: ${safeCode}` : null,
412
- safeMessage ? `Error message: ${safeMessage}` : null,
413
- safeDetails ? `Error details: ${safeDetails}` : null,
414
- '',
415
- 'Do NOT auto-merge -- see pm skill R12; a human must review and merge this PR.',
416
- ].filter((line) => line !== null).join('\n');
570
+ // Same markdown body builder as the PASS/FAIL Publish PR step
571
+ // (pr-body.mjs), so an abort after an earlier PASS/FAIL run also rewrites
572
+ // the existing PR and carries that run forward in its history.
573
+ const abortNow = new Date();
574
+ const buildAbortBody = (previousBody = '') => buildSprintPrBody({
575
+ verdict: 'ABORTED',
576
+ branch,
577
+ baseBranch,
578
+ runId,
579
+ now: abortNow,
580
+ notesHeading: 'Abort details',
581
+ notes: [
582
+ 'The sprint ABORTED before reaching a final PASS/FAIL verdict.',
583
+ '',
584
+ safeCode ? `- Error code: ${safeCode}` : null,
585
+ safeMessage ? `- Error message: ${safeMessage}` : null,
586
+ safeDetails ? `- Error details: ${safeDetails}` : null,
587
+ ].filter((line) => line !== null).join('\n'),
588
+ // A set-aside stall (StalledSprintError) carries the run's set-aside
589
+ // records; rendered as the "Set aside this run" section.
590
+ setAside: error && Array.isArray(error.setAside) ? error.setAside : [],
591
+ waited: error && Array.isArray(error.waited) ? error.waited : [],
592
+ previousBody,
593
+ });
594
+ const prBody = buildAbortBody();
417
595
 
418
596
  // The reverted gh-based PR creation is gone (apra-fleet-tfx.8): raise the [ABORTED] PR via
419
597
  // VCSModule's orchestrator-built curl command, dispatched to `member`
@@ -447,12 +625,17 @@ export async function finalizeAbort({ error, branch, baseBranch, member, command
447
625
  logPrefix: '[Publish Abort PR]',
448
626
  // Already resolved just above (the origin-remote PR-capability gate)
449
627
  // via a real git-capable member -- skip re-deriving it a second time
450
- // by shelling out to `member`, which may be orchestratorMember and
628
+ // by shelling out to `member`, which may be backlogMember and
451
629
  // have no git checkout of its own to read a remote from.
452
630
  remoteUrlOverride: originUrl,
631
+ updateExisting: ({ body: oldBody }) => ({ title: prTitle, body: buildAbortBody(oldBody) }),
453
632
  });
454
633
 
455
634
  if (!prResult.ok) {
635
+ if (prResult.credentialAbsent) {
636
+ log(`finalizeAbort: [Publish Abort PR] NO [ABORTED] pull request was opened for branch '${branch}' -> '${baseBranch}': no PR credential is deployed (branch is pushed). Deploy a credential to get PRs: ${prResult.error}`);
637
+ return { prUrl: null, reason: 'pr-auth-failed', pushed: true, commitCount };
638
+ }
456
639
  if (prResult.authFailure) {
457
640
  // apra-fleet-647.1.1.1: a PR auth failure survives the reactive
458
641
  // one-shot self-heal+retry inside raiseVcsPrForMember (i.e. the
@@ -474,6 +657,11 @@ export async function finalizeAbort({ error, branch, baseBranch, member, command
474
657
  // Idempotent: the desired end state -- a PR open for this branch --
475
658
  // already holds, so this is swallowed rather than thrown.
476
659
  log(`finalizeAbort: an [ABORTED] PR for branch '${branch}' already exists -- treating as idempotent success.`);
660
+ if (prResult.updated) {
661
+ log(`finalizeAbort: updated the existing PR for branch '${branch}' to this run's verdict (ABORTED)${prResult.prUrl ? `: ${prResult.prUrl}` : ''}.`);
662
+ } else {
663
+ log(`finalizeAbort: WARNING: could NOT update the existing PR for branch '${branch}' to this run's verdict (ABORTED) -- its title/body may still show an earlier run's verdict; update it by hand. Cause: ${prResult.updateError || '(unknown)'}`);
664
+ }
477
665
  return { prUrl: prResult.prUrl, reason: 'already-exists', pushed: true, commitCount };
478
666
  }
479
667
 
@@ -0,0 +1,93 @@
1
+ /**
2
+ * The backlog-role alias layer.
3
+ *
4
+ * `backlog` is the application-level pseudo-role naming the member whose beads
5
+ * clone the sprint runner issues its own `bd`/`git` commands against. Before
6
+ * 0.4.4 that role was spelled `orchestrator`; the old spelling is a deprecated
7
+ * alias, accepted in 0.4.4 and removed in v0.5. This module is the ONE place
8
+ * that knows the old spelling: callers pass an already key-normalized
9
+ * (trim + lowercase) roleMap and get back a roleMap carrying only `backlog`.
10
+ */
11
+
12
+ export const ROLE_BACKLOG = 'backlog';
13
+ export const ROLE_BACKLOG_ALIAS = 'orchestrator';
14
+
15
+ export const BACKLOG_ALIAS_WARNING =
16
+ 'Deprecated: roleMap.orchestrator is a deprecated alias of roleMap.backlog; ' +
17
+ 'use roleMap.backlog instead. The orchestrator alias will be removed in v0.5.';
18
+
19
+ /**
20
+ * @param {object|undefined} normalizedRoleMap - keys already normalized
21
+ * @returns {{ roleMap: object|undefined, warnings: string[] }}
22
+ * @throws {Error} when both keys are present with different member lists
23
+ */
24
+ export function resolveBacklogRoleAlias(normalizedRoleMap) {
25
+ if (normalizedRoleMap === undefined) return { roleMap: undefined, warnings: [] };
26
+ const has = (k) => Object.prototype.hasOwnProperty.call(normalizedRoleMap, k);
27
+ if (!has(ROLE_BACKLOG_ALIAS)) return { roleMap: normalizedRoleMap, warnings: [] };
28
+
29
+ const aliasValue = normalizedRoleMap[ROLE_BACKLOG_ALIAS];
30
+ const roleMap = { ...normalizedRoleMap };
31
+ delete roleMap[ROLE_BACKLOG_ALIAS];
32
+ if (has(ROLE_BACKLOG)) {
33
+ const a = JSON.stringify(normalizedRoleMap[ROLE_BACKLOG]);
34
+ const b = JSON.stringify(aliasValue);
35
+ if (a !== b) {
36
+ throw new Error(
37
+ `roleMap has both "${ROLE_BACKLOG}" (${a}) and its deprecated alias "${ROLE_BACKLOG_ALIAS}" (${b}) ` +
38
+ `with different member lists. Use roleMap.${ROLE_BACKLOG} only.`
39
+ );
40
+ }
41
+ } else {
42
+ roleMap[ROLE_BACKLOG] = aliasValue;
43
+ }
44
+ return { roleMap, warnings: [BACKLOG_ALIAS_WARNING] };
45
+ }
46
+
47
+ /**
48
+ * The ONE backlog-member selector shared by every direct launch (runner.js and
49
+ * bin/cli.mjs). Never throws on an unmapped backlog: it auto-selects and says
50
+ * why, so the caller can report the choice loudly.
51
+ *
52
+ * Order (roleMap already key-normalized and alias-resolved):
53
+ * 1. roleMap.backlog non-empty -> its first entry (explicit).
54
+ * 2. the first member (members order) named in no roleMap value
55
+ * (no roleMap -> the first member).
56
+ * 3. the first member mapped to doer.
57
+ * 4. the first member.
58
+ *
59
+ * @param {{ roleMap?: object, members: string[] }} input
60
+ * @returns {{ member: string|undefined, explicit: boolean, reason: string }}
61
+ */
62
+ export function selectBacklogMember({ roleMap, members } = {}) {
63
+ const list = Array.isArray(members) ? members : [];
64
+ const explicitList = roleMap && Array.isArray(roleMap[ROLE_BACKLOG]) ? roleMap[ROLE_BACKLOG] : [];
65
+ if (explicitList.length > 0) {
66
+ return { member: explicitList[0], explicit: true, reason: 'roleMap.backlog' };
67
+ }
68
+ const mapped = new Set();
69
+ if (roleMap) {
70
+ for (const v of Object.values(roleMap)) {
71
+ if (Array.isArray(v)) for (const m of v) mapped.add(m);
72
+ }
73
+ }
74
+ if (!roleMap || mapped.size === 0) {
75
+ return { member: list[0], explicit: false, reason: 'no roleMap, first member' };
76
+ }
77
+ const generalist = list.find((m) => !mapped.has(m));
78
+ if (generalist !== undefined) {
79
+ return { member: generalist, explicit: false, reason: 'first member not mapped to any role' };
80
+ }
81
+ const doers = Array.isArray(roleMap.doer) ? roleMap.doer : [];
82
+ const doer = list.find((m) => doers.includes(m));
83
+ if (doer !== undefined) {
84
+ return { member: doer, explicit: false, reason: 'every member is role-mapped; first doer-mapped member' };
85
+ }
86
+ return { member: list[0], explicit: false, reason: 'every member is role-mapped and none is a doer; first member' };
87
+ }
88
+
89
+ /** The loud one-line report for an auto-selected backlog member (null when explicit). */
90
+ export function formatBacklogSelection(sel) {
91
+ if (!sel || sel.explicit) return null;
92
+ return `backlog: ${sel.member} (auto-selected: ${sel.reason})`;
93
+ }
@@ -0,0 +1,69 @@
1
+ // bd-sync-command.mjs -- the member-bound command string for a `bd dolt pull`
2
+ // / `bd dolt push`, built per member OS/shell.
3
+ //
4
+ // WHY: on a Windows member, bd's embedded Dolt starts one git.exe per remote
5
+ // chunk concurrently (bounded only by GOMAXPROCS), and Windows refuses the
6
+ // burst with CreateProcess ERROR_NOT_ENOUGH_MEMORY (upstream:
7
+ // https://github.com/gastownhall/beads/issues/7082). Running bd with
8
+ // GOMAXPROCS=1 serializes those spawns -- 1 is the value evidenced on the
9
+ // failing members (precedent: scripts/rekey-beads-memories.mjs defaults
10
+ // GOMAXPROCS to 1).
11
+ //
12
+ // The value is FIXED, never read from the member's environment: honoring an
13
+ // operator-set value would need shell variable expansion in a member-bound
14
+ // command, which is forbidden (the member's shell may be PowerShell or bash
15
+ // and the string is built here, in JS). The assignment is scoped to the one
16
+ // command string: execute_command starts a fresh shell process per call, and
17
+ // on bash the `NAME=value cmd` form scopes it to that single process.
18
+ //
19
+ // POSIX (linux/macOS) members are left byte-identical: they have no
20
+ // per-process spawn limit of this kind.
21
+ //
22
+ // Kept in its own module (not dolt-sync.mjs) because dolt-settle.mjs issues
23
+ // its own post-resolve `bd dolt pull`/`bd dolt push` and is imported BY
24
+ // dolt-sync.mjs -- importing dolt-sync.mjs back would be circular.
25
+ //
26
+ // ASCII only.
27
+
28
+ /** GOMAXPROCS for a bd sync process on a Windows member. */
29
+ export const WINDOWS_BD_GOMAXPROCS = '1';
30
+
31
+ /** The POSIX target an unresolved member degrades to (pre-existing behavior). */
32
+ export const POSIX_MEMBER_TARGET = Object.freeze({ os: 'linux', shell: '' });
33
+
34
+ /**
35
+ * Normalize a member target to { os, shell }. Accepts the member_detail shape
36
+ * ({ os, shell }) or a bare OS / Node platform string ('win32' is folded into
37
+ * 'windows' so dolt-settle's platform strings work unchanged).
38
+ *
39
+ * @param {{ os?: string, shell?: string }|string|null|undefined} target
40
+ * @returns {{ os: string, shell: string }}
41
+ */
42
+ export function normalizeMemberTarget(target) {
43
+ const raw = typeof target === 'string' ? { os: target, shell: '' } : (target || {});
44
+ let os = String(raw.os || '').trim().toLowerCase();
45
+ if (os === 'win32') os = 'windows';
46
+ const shell = String(raw.shell || '').trim().toLowerCase();
47
+ return { os, shell };
48
+ }
49
+
50
+ /**
51
+ * The command string to issue for a bd sync command on a member.
52
+ *
53
+ * linux / macOS / unresolved -> `cmd`, unchanged
54
+ * windows + gitbash -> `GOMAXPROCS=1 cmd`
55
+ * windows + PowerShell (any other) -> `$env:GOMAXPROCS='1'; cmd`
56
+ *
57
+ * The PowerShell form is an ASSIGNMENT statement, not an expansion: nothing is
58
+ * read from the member's environment.
59
+ *
60
+ * @param {string} cmd - the logical command, e.g. 'bd dolt pull'
61
+ * @param {{ os?: string, shell?: string }|string|null|undefined} target
62
+ * @returns {string}
63
+ */
64
+ export function bdSyncCommandFor(cmd, target) {
65
+ const { os, shell } = normalizeMemberTarget(target);
66
+ if (os !== 'windows') return cmd;
67
+ if (shell === 'gitbash') return `GOMAXPROCS=${WINDOWS_BD_GOMAXPROCS} ${cmd}`;
68
+ return `$env:GOMAXPROCS='${WINDOWS_BD_GOMAXPROCS}'; ${cmd}`;
69
+ }