@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -15,12 +15,20 @@ Check first: `curl -s -m 5 http://localhost:8787/api/sprints`. Connection
15
15
  refused/timeout = not running. `{"sprints": [...]}` = already up, skip this.
16
16
 
17
17
  Start it detached (it runs indefinitely -- exits only on `POST
18
- /api/shutdown` or SIGINT/SIGTERM, never on its own):
18
+ /api/shutdown` or SIGINT/SIGTERM, never on its own). `apra-fleet install`
19
+ puts it under the user's home (needs Node.js 22.16+):
19
20
 
20
21
  ```bash
21
- node packages/apra-fleet-se/bin/serve.mjs # background/detached, from repo root
22
+ node ~/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs # macOS / Linux
22
23
  ```
23
24
 
25
+ ```powershell
26
+ node "$HOME\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs" # Windows PowerShell
27
+ ```
28
+
29
+ (From a source checkout of apra-fleet the same file is
30
+ `packages/apra-fleet-se/bin/serve.mjs`.)
31
+
24
32
  Start it from INSIDE the target project (any folder under it): the
25
33
  supervisor resolves the project's `.beads` by walking up from its cwd,
26
34
  exactly like `bd`. Starting from elsewhere: pass `--beads-dir <project
@@ -31,20 +39,33 @@ top of the dashboard, and every sprint it launches is told to verify its
31
39
  members against it. If NO `.beads` is found (or its probe fails) it still
32
40
  starts, but logs `[supervisor] WARNING: no beads database found walking up
33
41
  from <cwd> ... To fix: ...`, reports `beads: null` plus `beadsWarning` on
34
- `/api/health`, shows an amber `Beads: NOT RESOLVED -- ...` header on the
35
- dashboard, and launches sprints WITHOUT `--expect-beads` (they then verify
36
- members against the orchestrator member's own beads). Treat that as
37
- "restart from the right folder / with `--beads-dir`", or fix the
38
- environment and hit `GET /api/health?refresh=1` to recover without a
39
- restart. `--port <n>` overrides the default (8787). Self-logs to
42
+ `/api/health`, and shows an amber `Beads: NOT RESOLVED -- ...` header on the
43
+ dashboard. With NO `.beads` found it also has no backlog member, so every
44
+ launch answers `503` until you restart it from the right folder or with
45
+ `--beads-dir`. With a `.beads` found but a failed probe, launches still
46
+ work (without `--expect-beads`); fix the environment and hit
47
+ `GET /api/health?refresh=1` to recover without a restart. `--port <n>`
48
+ overrides the default (8787). Self-logs to
40
49
  `<dataDir>/logs/supervisor.log` in addition to stdout.
41
50
 
51
+ **Backlog member.** At startup the supervisor ensures its own backlog
52
+ member: a local member with no LLM whose work folder is the project folder.
53
+ It adopts an LLM-less local member already registered for that folder (name
54
+ kept; adds the `backlog` tag and `unreservable` when missing), or registers
55
+ `backlog-<camelCaseFolderName>`. It logs `[supervisor] backlog member:
56
+ '<name>' (ready)`; `GET /api/health` reports `backlogMember: {status, name,
57
+ reason}`. It refuses to start (exit 1) if that name is taken by a member
58
+ for another folder. Fleet unreachable at startup is not fatal: status is
59
+ `degraded`, launches answer `503`, and a background retry fixes it.
60
+
42
61
  Smoke test (a few seconds after launch -- give it time to bind):
43
62
  ```bash
44
63
  curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
45
64
  curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
46
- curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker
65
+ curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker, `backlogMember.status` is "ready"
47
66
  ```
67
+ (Windows PowerShell 5.1: `curl` is an alias of `Invoke-WebRequest`; use
68
+ `curl.exe` with the same arguments, or `Invoke-RestMethod <url>`.)
48
69
  Both must succeed before treating the supervisor as up -- a bound port with
49
70
  a 500 on `/api/members` still means something is broken. A wrong
50
71
  `beads.prefix` means it was started from the wrong folder: stop it and
@@ -146,15 +167,24 @@ restart command exists:
146
167
  run its smoke test (`GET /api/sprints`, `GET /api/members`) to confirm the
147
168
  new process is actually serving before treating the restart as done.
148
169
 
170
+ **Upgrading apra-fleet.** A running supervisor keeps the code it started
171
+ with. Before upgrading, let running sprints finish (or stop them) and stop
172
+ the supervisor; start it again afterwards. A
173
+ supervisor started under 0.4.3 does not send the install's access secret, so
174
+ a 0.4.4 fleet server refuses its requests with HTTP 401. If a sprint was
175
+ still running during the upgrade, the first launch may 409 on its stale
176
+ member reservations -- see "Common launch-time crashes" below.
177
+
149
178
  ## Auto-start on login/boot
150
179
 
151
- Instead of a human running `node bin/serve.mjs` by hand each session, the
180
+ Instead of a human running `serve.mjs` by hand each session, the
152
181
  supervisor can be registered with the OS to start automatically on
153
182
  login/boot. Resolve commands per the target member's own OS (`agent.os`) --
154
183
  do not assume the orchestrator's shell; some members run PowerShell, not
155
- POSIX. Every example below assumes the repo root is
156
- `/path/to/apra-fleet` (POSIX) or `C:\path\to\apra-fleet` (Windows) --
157
- substitute the real path on the target member. After registering (any OS),
184
+ POSIX. A service manager does not start in your project folder, so every
185
+ example passes `--beads-dir`. Substitute the real paths: the user's home
186
+ (`/Users/<user>`, `/home/<user>` or `C:\Users\<user>`) and the target
187
+ project folder (`/path/to/project` or `C:\path\to\project`). After registering (any OS),
158
188
  run the same-process smoke test from section 0 above (`GET /api/sprints`,
159
189
  `GET /api/members`) against the newly auto-started instance to confirm it is
160
190
  actually serving, not just that the OS accepted the registration.
@@ -166,7 +196,7 @@ user's own session):
166
196
 
167
197
  Register:
168
198
  ```cmd
169
- schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\path\to\apra-fleet\packages\apra-fleet-se\bin\serve.mjs" /SC ONLOGON /RL LIMITED
199
+ schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\Users\<user>\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs --beads-dir C:\path\to\project" /SC ONLOGON /RL LIMITED
170
200
  ```
171
201
  De-register:
172
202
  ```cmd
@@ -182,8 +212,8 @@ in; requires NSSM installed and on PATH):
182
212
 
183
213
  Register:
184
214
  ```cmd
185
- nssm install ApraFleetSupervisor node "C:\path\to\apra-fleet\packages\apra-fleet-se\bin\serve.mjs"
186
- nssm set ApraFleetSupervisor AppDirectory "C:\path\to\apra-fleet"
215
+ nssm install ApraFleetSupervisor node "C:\Users\<user>\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs" --beads-dir "C:\path\to\project"
216
+ nssm set ApraFleetSupervisor AppDirectory "C:\path\to\project"
187
217
  nssm start ApraFleetSupervisor
188
218
  ```
189
219
  De-register:
@@ -206,7 +236,9 @@ Create `~/Library/LaunchAgents/com.apra-fleet.supervisor.plist`:
206
236
  <key>ProgramArguments</key>
207
237
  <array>
208
238
  <string>/usr/local/bin/node</string>
209
- <string>/path/to/apra-fleet/packages/apra-fleet-se/bin/serve.mjs</string>
239
+ <string>/Users/<user>/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs</string>
240
+ <string>--beads-dir</string>
241
+ <string>/path/to/project</string>
210
242
  </array>
211
243
  <key>RunAtLoad</key>
212
244
  <true/>
@@ -246,9 +278,9 @@ Create `~/.config/systemd/user/apra-fleet-supervisor.service`:
246
278
  Description=Apra Fleet supervisor
247
279
 
248
280
  [Service]
249
- ExecStart=/usr/bin/node /path/to/apra-fleet/packages/apra-fleet-se/bin/serve.mjs
281
+ ExecStart=/usr/bin/node /home/<user>/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs --beads-dir /path/to/project
250
282
  Restart=no
251
- WorkingDirectory=/path/to/apra-fleet
283
+ WorkingDirectory=/path/to/project
252
284
 
253
285
  [Install]
254
286
  WantedBy=default.target
@@ -279,9 +311,13 @@ start with no login (`loginctl enable-linger <username>`).
279
311
  `bd dolt commit` then `bd dolt push`. Members pull their own copy; a
280
312
  sprint launched before the push works from stale scope.
281
313
  2. Check no conflicting sprint is already running: `GET /api/sprints`.
282
- 3. Multi-member sprints need all members on the SAME git HEAD, or the
283
- launch crashes immediately with a topology error. If unsure, use ONE
284
- member. Don't guess a member list -- ask, or default to one.
314
+ 3. Multi-member sprints align their members to the sprint base
315
+ automatically at launch (WIP preserved in a named stash, one `[Align]`
316
+ line per member) -- do not align members by hand. The launch refuses only
317
+ for an unreachable member, differing origin URLs, a base missing on
318
+ origin, a fetch auth failure or a diverged sprint branch, naming the
319
+ member, cause and fix. Don't guess a member list -- ask, or default to
320
+ one.
285
321
 
286
322
  ## 2. Start a sprint
287
323
 
@@ -302,18 +338,24 @@ Field names, exactly as the API expects them:
302
338
  | Field | Required | Notes |
303
339
  |---|---|---|
304
340
  | `issue` | yes | comma-separated bead root IDs (parent/epic OR a standalone leaf bead). Alias: `target_issue`. |
305
- | `branch` | yes | created from `base` if it doesn't exist yet. |
341
+ | `branch` | yes | created from `base` if it doesn't exist yet. Must differ from `base` (an equal pair is a 400; case and `origin/`/`refs/heads/` prefixes are ignored). |
306
342
  | `base` | yes | alias: `base_branch`. This is what the sprint branches FROM -- pass the branch you actually want, not always `main`. |
307
343
  | `members` | yes | array of registered member names. One member = safest default. |
308
344
  | `goal` | no | `P1`, `P1/P2` (default), or `P1/P2/P3`. |
309
345
  | `maxCycles` | no | default 5. |
310
346
  | `allowMissingMembers` | no | bool. |
311
- | `requirementsFile` | no | path. |
312
- | `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. |
347
+ | `requirementsFile` | no | path on the supervisor's machine; a relative path resolves against the supervisor's project folder. Not found = a run-log warning only, so prefer an absolute path. |
348
+ | `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. Leave out `backlog`: the supervisor injects its own backlog member; naming any other member there is a 400. `orchestrator` is the deprecated alias of `backlog` (removed in v0.5). |
313
349
  | `budget` | no | USD cap. |
350
+ | `phases` | no | `{"regression": "skip"}` skips the regression pass (`"run"` is the default). Any other key or value is a 400. |
314
351
  | `overrideRelaunchGate` | no | bool. See below. |
315
352
 
316
- Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath`.
353
+ Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath`, and
354
+ `warnings` (e.g. the deprecation notice when `roleMap.orchestrator` was
355
+ used). A `503` means nothing was launched: the backlog member is not ready,
356
+ the fleet member list could not be read, the fleet server was stopped by its
357
+ user (`apra-fleet stop`), or the beads could not be verified fresh -- the
358
+ `error` says which.
317
359
  **A 201 response does NOT mean the sprint is alive** -- it can crash in the
318
360
  first few seconds (bad topology, bad member, etc). Always verify (step 3)
319
361
  a few seconds after launch.
@@ -350,13 +392,25 @@ only use it once you know why the prior run died.
350
392
 
351
393
  ## Common launch-time crashes
352
394
 
353
- - **Topology mismatch**: members are on different git commits. Fix: use one
354
- member, or align them first (`git fetch && git checkout <branch>` on
355
- each), or pass whatever sync option the engine currently exposes -- check
356
- `docs/architecture.md` "Multi-member topology" section, don't guess.
395
+ - **Topology refusal**: members are aligned automatically (section 1), so
396
+ this names what could not be reconciled -- an unreachable member,
397
+ differing origin URLs, a base missing on origin, a fetch auth failure or
398
+ a diverged sprint branch. Fix what it names and relaunch; do not align
399
+ members by hand.
400
+ - **Beads identity** (`BeadsIdentityError`, before any dispatch): `bd`
401
+ missing on a member, a member resolving to a different beads project, or
402
+ a failed automatic beads set-up on a beads-reading member. The message
403
+ names the member and the fix.
357
404
  - **Unregistered member**: `GET /api/members` to see valid names.
358
405
  - **Stale LLM auth**: dispatch fails with `empty_response`. Re-run
359
406
  `provision_llm_auth` for that member.
407
+ - **Stale member reservation** (`409 member overlap rejects launch: sprint
408
+ '<id or branch>' already claims [...]` while `GET /api/sprints` shows no
409
+ such sprint): a sprint died uncleanly (crash, or an upgrade with
410
+ `--ignore-running-sprints`) and left its members reserved on the fleet
411
+ server. Clear each listed member with the fleet MCP tool
412
+ `member_reservation {member_name: "<member>", action: "force_release"}`
413
+ (no supervisor HTTP route does this), then relaunch.
360
414
 
361
415
  ## Member layout: isolate deploy/test roles from dev roles
362
416
 
@@ -6,7 +6,9 @@
6
6
  // unchanged. This is a move-only extraction: behaviour, validation order and
7
7
  // error message text are all deliberately unchanged from the pre-move code.
8
8
  import { normalizeRole, validateCredentialStoreName } from './contracts.mjs';
9
+ import { ROLE_KB_MAINTAINER } from './kb-maintainer.mjs';
9
10
  import { parseExpectedIdentity } from './beads-identity.mjs';
11
+ import { resolveBacklogRoleAlias } from './backlog-role.mjs';
10
12
 
11
13
  // ---------------------------------------------------------------------------
12
14
  // CLI -> runner argument contract
@@ -33,7 +35,7 @@ const GOAL_PATTERN = /^P[1-3](\/P[1-3]){0,2}$/;
33
35
 
34
36
  const KNOWN_ARG_KEYS = new Set([
35
37
  'target_issues', 'target_issue', 'members', 'branch', 'base_branch',
36
- 'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'budget',
38
+ 'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'roleMapWarnings', 'budget',
37
39
  // Per-dispatch time budget (timeout_s == max_total_s at every dispatch
38
40
  // site; integ ceiling = 2x), bounding the cost of a hung dispatch.
39
41
  'dispatch_timeout_s',
@@ -91,6 +93,11 @@ const KNOWN_ARG_KEYS = new Set([
91
93
  // itself -- see docs/fleet-sprint-cli-contract.md's "Dormant argument
92
94
  // audit" section for the full record.
93
95
  'assignee',
96
+ // Explicitly skip the once-per-sprint regression pass (launch option:
97
+ // the CLI's --skip-regression, the supervisor's phases.regression:"skip").
98
+ // Never silent: the engine logs it and the sprint report and PR body say
99
+ // "skipped by launch option". The integration-test phase is unaffected.
100
+ 'skip_regression',
94
101
  // Multi-streak worklist dispatch mode when a develop round has more ready
95
102
  // streaks than doers. 'resume' (default): per-streak dispatches that resume
96
103
  // the SAME doer session by explicit session id (warm-context carryover,
@@ -126,6 +133,15 @@ const KNOWN_ARG_KEYS = new Set([
126
133
  // formula units). Default DEFAULT_EFFORT_THRESHOLD.
127
134
  // No CLI flag sets this today; only test/programmatic callers pass it.
128
135
  'worklist_effort_budget',
136
+ // Engine CI gate arg -- DELIBERATELY NOT WIRED (2026-10-01). ci-gate.mjs
137
+ // runs CI per reviewer dispatch and hands the result to the reviewer; the
138
+ // agreed direction is the opposite (CI never blocks or reaches doer/
139
+ // reviewer loops; the integ-test phase owns CI via one reopenable bead;
140
+ // per-push vs end-of-cycle triggering per project). Until the "fleet-sprint
141
+ // must also utilize CI as a resource for quality" epic (apra-fleet-dv8i)
142
+ // designs that flow, ci_gate is not a known arg, so passing it fails loudly
143
+ // as an unknown arg. The gate module stays in place, unconfigured.
144
+ // 'ci_gate',
129
145
  // An optional live `(name, args) => Promise<any>` MCP tool-call function,
130
146
  // wired by bin/cli.mjs from its already-connected `mcpClient.callTool`.
131
147
  // Consumed by createMemberSessionGuard() to call the fleet's own
@@ -144,7 +160,7 @@ const KNOWN_ARG_KEYS = new Set([
144
160
  // `--expect-beads`, env fallback FLEET_SPRINT_EXPECT_BEADS, or an already
145
161
  // parsed record from a programmatic caller). Consumed by the
146
162
  // verifyBeadsIdentity precondition (beads-identity-check.mjs); absent, the
147
- // orchestrator member's own probed identity becomes the expectation.
163
+ // backlog member's own probed identity becomes the expectation.
148
164
  'expect_beads',
149
165
  ]);
150
166
 
@@ -170,6 +186,47 @@ export function validateExpectBeads(raw) {
170
186
  return parsed;
171
187
  }
172
188
 
189
+ /** Default CI gate timeout (seconds) when ci_gate omits timeout_s. */
190
+ export const DEFAULT_CI_GATE_TIMEOUT_S = 3600;
191
+ // A workflow file name ("ci.yml") or numeric workflow id -- interpolated into
192
+ // a provider REST path, so restrictive by design.
193
+ const CI_GATE_WORKFLOW_PATTERN = /^[A-Za-z0-9._-]+$/;
194
+
195
+ /**
196
+ * Validates the optional ci_gate arg: { workflow: string, timeout_s?: positive
197
+ * integer (default 3600) }. Accepts the object, or its JSON string form (the
198
+ * CLI forwards --ci-gate verbatim). Absent -> undefined (gate not configured).
199
+ * @param {unknown} raw
200
+ * @returns {{ workflow: string, timeoutS: number }|undefined}
201
+ */
202
+ export function validateCiGate(raw) {
203
+ if (raw === undefined || raw === null || raw === '') return undefined;
204
+ let value = raw;
205
+ if (typeof raw === 'string') {
206
+ try {
207
+ value = JSON.parse(raw);
208
+ } catch {
209
+ throw new Error(`[Arg Contract] Invalid ci_gate: not valid JSON (${JSON.stringify(raw).slice(0, 200)}). Expected {"workflow": "<workflow file name or id>", "timeout_s": <positive integer>}.`);
210
+ }
211
+ }
212
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
213
+ throw new Error('[Arg Contract] Invalid ci_gate: must be an object {"workflow": "<workflow file name or id>", "timeout_s": <positive integer, default 3600>}.');
214
+ }
215
+ const unknown = Object.keys(value).filter((k) => k !== 'workflow' && k !== 'timeout_s');
216
+ if (unknown.length > 0) {
217
+ throw new Error(`[Arg Contract] Invalid ci_gate: unknown key(s) ${unknown.join(', ')}. Known keys: workflow, timeout_s.`);
218
+ }
219
+ const workflow = value.workflow;
220
+ if (typeof workflow !== 'string' || workflow.length === 0 || !CI_GATE_WORKFLOW_PATTERN.test(workflow)) {
221
+ throw new Error(`[Arg Contract] Invalid ci_gate.workflow "${workflow}": required; must be a workflow file name or numeric id matching ${CI_GATE_WORKFLOW_PATTERN}.`);
222
+ }
223
+ const timeoutS = value.timeout_s === undefined ? DEFAULT_CI_GATE_TIMEOUT_S : value.timeout_s;
224
+ if (typeof timeoutS !== 'number' || !Number.isInteger(timeoutS) || timeoutS <= 0) {
225
+ throw new Error(`[Arg Contract] Invalid ci_gate.timeout_s "${timeoutS}": must be a positive integer (seconds).`);
226
+ }
227
+ return { workflow, timeoutS };
228
+ }
229
+
173
230
  /**
174
231
  * Validates a single issue id against the shell-injection-safe pattern.
175
232
  * Throws with a clear message on rejection.
@@ -198,6 +255,36 @@ export function validateBranchName(name, label) {
198
255
  return name;
199
256
  }
200
257
 
258
+ // Strip the ref prefixes a caller may legitimately pass for the same branch
259
+ // (refs/heads/<b>, origin/<b>, refs/remotes/origin/<b>) so "main",
260
+ // "origin/main" and "refs/heads/main" all compare equal. Compared
261
+ // case-insensitively: a pair differing only in case is never a legitimate
262
+ // sprint (case-insensitive filesystems and hosts treat them as one branch).
263
+ function normalizeBranchForCompare(name) {
264
+ let n = String(name).toLowerCase();
265
+ for (const prefix of ['refs/remotes/origin/', 'refs/heads/', 'origin/']) {
266
+ if (n.startsWith(prefix)) { n = n.slice(prefix.length); break; }
267
+ }
268
+ return n;
269
+ }
270
+
271
+ /**
272
+ * Rejects a sprint whose working branch is its base branch (GitHub #613):
273
+ * the review range base..branch would be empty, doer commits would land
274
+ * directly on the base, and the closing PR could never be opened (head ==
275
+ * base). Shared by validateArgs, bin/cli.mjs and the supervisor launch API so
276
+ * every entry point refuses the same pairs with the same message.
277
+ *
278
+ * @param {string} branch
279
+ * @param {string} base
280
+ */
281
+ export function validateBranchPair(branch, base) {
282
+ if (typeof branch !== 'string' || typeof base !== 'string') return;
283
+ if (normalizeBranchForCompare(branch) === normalizeBranchForCompare(base)) {
284
+ throw new Error(`[Arg Contract] Invalid branch "${branch}": must differ from base_branch "${base}" (the sprint works on its own branch and opens a PR into the base).`);
285
+ }
286
+ }
287
+
201
288
  /**
202
289
  * Validates and normalizes the args object passed into main(context).
203
290
  * Rejects unknown keys and missing/malformed required keys loudly.
@@ -254,6 +341,7 @@ export function validateArgs(args) {
254
341
  throw new Error('[Arg Contract] Missing required arg: base_branch (branch the sprint branch is created from and the PR targets).');
255
342
  }
256
343
  validateBranchName(args.base_branch, 'base_branch');
344
+ validateBranchPair(args.branch, args.base_branch);
257
345
 
258
346
  // --- goal (optional, default 'P1/P2'; the priority band this sprint aims
259
347
  // to clear, consumed by the exit-condition logic) ---
@@ -297,6 +385,41 @@ export function validateArgs(args) {
297
385
  }
298
386
  normalizedRoleMap[key] = value;
299
387
  }
388
+ // kb_maintainer is an accepted roleMap key but NOT a dispatched role:
389
+ // it names the member(s) that receive every KB write for their own
390
+ // repository (kb-maintainer.mjs). Its members must be sprint members,
391
+ // since selection probes them through the sprint's member access.
392
+ if (Object.prototype.hasOwnProperty.call(normalizedRoleMap, ROLE_KB_MAINTAINER)) {
393
+ const list = normalizedRoleMap[ROLE_KB_MAINTAINER];
394
+ if (!Array.isArray(list) || list.some((m) => typeof m !== 'string' || m.length === 0)) {
395
+ throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: must be an array of non-empty member names.`);
396
+ }
397
+ const stray = list.filter((m) => !args.members.includes(m));
398
+ if (stray.length > 0) {
399
+ const quoted = stray.map((m) => '"' + m + '"').join(', ');
400
+ throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: ${quoted} not in members.`);
401
+ }
402
+ }
403
+ }
404
+ // Backlog-role alias: the deprecated 'orchestrator' key is folded into
405
+ // 'backlog' here (downstream readers only ever see 'backlog'); a conflict
406
+ // is an arg-contract error. Warnings -- plus any the CLI already collected
407
+ // (args.roleMapWarnings, since the CLI rewrites the key before the runner
408
+ // sees it) -- are surfaced on the validated object for the runner to log.
409
+ const roleMapWarnings = [];
410
+ if (normalizedRoleMap !== undefined) {
411
+ try {
412
+ const resolved = resolveBacklogRoleAlias(normalizedRoleMap);
413
+ normalizedRoleMap = resolved.roleMap;
414
+ roleMapWarnings.push(...resolved.warnings);
415
+ } catch (err) {
416
+ throw new Error(`[Arg Contract] Invalid roleMap: ${err.message}`);
417
+ }
418
+ }
419
+ if (Array.isArray(args.roleMapWarnings)) {
420
+ for (const w of args.roleMapWarnings) {
421
+ if (typeof w === 'string' && !roleMapWarnings.includes(w)) roleMapWarnings.push(w);
422
+ }
300
423
  }
301
424
 
302
425
  // --- budget (optional) -----------------------------------------------
@@ -379,6 +502,12 @@ export function validateArgs(args) {
379
502
  throw new Error(`[Arg Contract] Invalid doer_worklist_mode "${doerWorklistMode}": must be 'resume' (default) or 'batch'.`);
380
503
  }
381
504
 
505
+ // --- skip_regression (optional, default false) -------------------------
506
+ const skipRegression = args.skip_regression === undefined ? false : args.skip_regression;
507
+ if (typeof skipRegression !== 'boolean') {
508
+ throw new Error(`[Arg Contract] Invalid skip_regression "${skipRegression}": must be a boolean.`);
509
+ }
510
+
382
511
  // --- resume_model_switch (optional, default false) ---------------------
383
512
  const resumeModelSwitch = args.resume_model_switch === undefined ? false : args.resume_model_switch;
384
513
  if (typeof resumeModelSwitch !== 'boolean') {
@@ -429,6 +558,10 @@ export function validateArgs(args) {
429
558
  // --- expect_beads (optional) ------------------------------------------
430
559
  const expectBeads = validateExpectBeads(args.expect_beads);
431
560
 
561
+ // --- ci_gate: NOT WIRED (see the KNOWN_ARG_KEYS note; apra-fleet-dv8i) ---
562
+ // const ciGate = validateCiGate(args.ci_gate);
563
+ const ciGate = undefined;
564
+
432
565
  return {
433
566
  targetIssues,
434
567
  members: args.members,
@@ -438,6 +571,7 @@ export function validateArgs(args) {
438
571
  maxCycles,
439
572
  requirementsFile: args.requirementsFile,
440
573
  roleMap: normalizedRoleMap,
574
+ roleMapWarnings,
441
575
  budget: args.budget,
442
576
  serviceUrl: args.serviceUrl,
443
577
  runId: args.run_id,
@@ -446,9 +580,11 @@ export function validateArgs(args) {
446
580
  azdevopsPatSecretName: args.azdevops_pat_secret_name,
447
581
  doerWorklistMode,
448
582
  resumeModelSwitch,
583
+ skipRegression,
449
584
  worklistEffortBudget: args.worklist_effort_budget,
450
585
  usageLimitMaxWaitS: args.usage_limit_max_wait_s,
451
586
  usageLimitMaxReprobes: args.usage_limit_max_reprobes,
452
587
  expectBeads,
588
+ ciGate,
453
589
  };
454
590
  }
@@ -11,8 +11,9 @@
11
11
  // builder (module-private -- it is the body builder buildCostAnalysis
12
12
  // and the PR text path share, so it moves with them rather than staying
13
13
  // behind).
14
- // - buildCostAnalysis: the Harvester dispatch's `costAnalysis` block
15
- // builder, reporting budget/spend honestly from the live `budget` object.
14
+ // - buildCostAnalysis: the sprint cost block (appended to analysisText and
15
+ // rendered in the PR body), reporting budget/spend honestly from the live
16
+ // `budget` object.
16
17
  // - computeBranchSlug: the collision-resistant filesystem slug for
17
18
  // `docs/sprint-analysis-<slug>.md`.
18
19
  //
@@ -22,6 +23,7 @@
22
23
 
23
24
  import { createHash } from 'crypto';
24
25
  import { SAFE_TEXT_RE } from './newtask-text.mjs';
26
+ import { formatDispatchToolCalls } from './dispatch-accounting.mjs';
25
27
 
26
28
  // ---------------------------------------------------------------------------
27
29
  // PR body/title text sanitization. The final reviewer's verdict notes are LLM
@@ -64,6 +66,61 @@ export function sanitizePrText(text) {
64
66
  // Finalization prompt builders
65
67
  // ---------------------------------------------------------------------------
66
68
 
69
+ /**
70
+ * " (<part>: pass, <part>: fail)" from the playbook-defined `sections`, or
71
+ * from the deprecated two-part fields when an older runner returned those;
72
+ * '' when neither is present. The part names are the target playbook's own.
73
+ * @param {object} r regression-test-runner result
74
+ * @returns {string}
75
+ */
76
+ export function formatRegressionParts(r) {
77
+ const pf = (v) => (v === true ? 'pass' : 'fail');
78
+ let parts = [];
79
+ if (Array.isArray(r.sections) && r.sections.length > 0) {
80
+ parts = r.sections.map((s) => `${s.name}: ${pf(s.passed)}`);
81
+ } else {
82
+ if (typeof r.suitePassed === 'boolean') parts.push(`part 1: ${pf(r.suitePassed)}`);
83
+ if (typeof r.smokePassed === 'boolean') parts.push(`part 2: ${pf(r.smokePassed)}`);
84
+ }
85
+ return parts.length ? ` (${parts.join(', ')})` : '';
86
+ }
87
+
88
+ const REGRESSION_VERDICTS = ['PASS', 'FAIL', 'INCONCLUSIVE'];
89
+
90
+ /**
91
+ * The regression verdict, or null when the runner reported none. A verdict
92
+ * is copied verbatim from a machine-written verdict file (see
93
+ * agents/regression-test-runner.md), so it outranks the boolean `passed`:
94
+ * INCONCLUSIVE must never be rendered as a failure.
95
+ * @param {object} r regression-test-runner result
96
+ * @returns {'PASS'|'FAIL'|'INCONCLUSIVE'|null}
97
+ */
98
+ export function regressionVerdictOf(r) {
99
+ return r && REGRESSION_VERDICTS.includes(r.verdict) ? r.verdict : null;
100
+ }
101
+
102
+ /**
103
+ * One-line headline for a regression result: "Regression: <VERDICT> @ <sha12>
104
+ * (parts) [evidence counts] <runUrl>" when a verdict is present, else the legacy
105
+ * "Regression pass: PASSED|FAILED (parts)". No trailing period.
106
+ * @param {object} r regression-test-runner result
107
+ * @returns {string}
108
+ */
109
+ export function formatRegressionHeadline(r) {
110
+ const verdict = regressionVerdictOf(r);
111
+ if (verdict) {
112
+ const sha = typeof r.testedSha === 'string' && r.testedSha ? ` @ ${r.testedSha.slice(0, 12)}` : '';
113
+ const ev = r.evidence && typeof r.evidence === 'object' ? r.evidence : {};
114
+ const counts = [];
115
+ if (Array.isArray(ev.newFailures)) counts.push(`${ev.newFailures.length} new failure(s)`);
116
+ if (Array.isArray(ev.inventoryMissing)) counts.push(`${ev.inventoryMissing.length} inventory missing`);
117
+ const evText = counts.length ? ` [${counts.join(', ')}]` : '';
118
+ const url = typeof ev.runUrl === 'string' && ev.runUrl ? ` ${ev.runUrl}` : '';
119
+ return `Regression: ${verdict}${sha}${formatRegressionParts(r)}${evText}${url}`;
120
+ }
121
+ return `Regression pass: ${r.passed === true ? 'PASSED' : 'FAILED'}${formatRegressionParts(r)}`;
122
+ }
123
+
67
124
  /**
68
125
  * Assembles the `analysisText` block for the Harvester dispatch from this
69
126
  * run's in-memory tracking state: cycle-by-cycle closed-bead progress,
@@ -85,17 +142,28 @@ export function buildAnalysisText({
85
142
  // as "nothing was skipped".
86
143
  finalDeferredAtGoalIds = [],
87
144
  regressionResult = null,
145
+ // Set when the pass was deliberately skipped (e.g. 'launch option'), so the
146
+ // report says so instead of the misleading "no playbook" line.
147
+ regressionSkippedBy = null,
148
+ // Per-dispatch kb_* and code_* call records (sprint state's dispatchToolCalls,
149
+ // from session_stats snapshots). Omitted -> no section; an unknown count
150
+ // is printed as unknown, never 0.
151
+ dispatchToolCalls = null,
152
+ // The KB work client's unpublishedBible(): per repository, confirmations
153
+ // still not in a pushed bible commit. Rendered as a loud section only
154
+ // when any are, so a sprint whose bible was published reads as before.
155
+ kbBibleUnpublished = null,
88
156
  }) {
89
157
  // The once-per-sprint Regression Test phase runs after the final verdict
90
158
  // and never gates it. Its failures are filed as parent-less carry-over
91
159
  // beads, so they never appear in the open-at-goal count and are reported
92
160
  // separately here.
93
- const regressionLines = regressionResult === null
161
+ const regressionLines = regressionSkippedBy
162
+ ? [`Regression pass: skipped by ${regressionSkippedBy} -- not run this sprint.`]
163
+ : regressionResult === null
94
164
  ? ['Regression pass: not run this sprint (no regression-test-playbook.md, or the probe failed).']
95
165
  : [
96
- `Regression pass: ${regressionResult.passed === true ? 'PASSED' : 'FAILED'} `
97
- + `(real-bd suite: ${regressionResult.suitePassed === true ? 'pass' : 'fail'}, `
98
- + `smoke test: ${regressionResult.smokePassed === true ? 'pass' : 'fail'}).`,
166
+ `${formatRegressionHeadline(regressionResult)}.`,
99
167
  `Carry-over beads filed: ${(regressionResult.bugsFiled || []).join(', ') || 'none'}.`,
100
168
  `Summary: ${regressionResult.summary || '(none reported)'}`,
101
169
  'Informational only -- this pass ran after the final verdict and did not gate it; any bead '
@@ -141,16 +209,48 @@ export function buildAnalysisText({
141
209
  '## Regression pass (once per sprint, informational)',
142
210
  '',
143
211
  ...regressionLines,
212
+ ...kbBibleLines(kbBibleUnpublished),
144
213
  ];
214
+ if (Array.isArray(dispatchToolCalls)) {
215
+ lines.push(
216
+ '',
217
+ '## KB and code tool calls per member per dispatch',
218
+ '',
219
+ "Counted by each member's own fleet server (session_stats before/after each dispatch; the engine's own reads are excluded). 'unknown' means the count could not be read -- it is not zero.",
220
+ '',
221
+ ...formatDispatchToolCalls(dispatchToolCalls),
222
+ );
223
+ }
145
224
  return lines.join('\n');
146
225
  }
147
226
 
148
227
  /**
149
- * Builds the `costAnalysis` block for the Harvester dispatch from the live
150
- * `budget` object. Reports only what is known: an unset ceiling, an absent
151
- * spent() and an unpriced-model spend gap are each stated as such rather than
152
- * backfilled with a fabricated number, since harvester.md inserts this block
153
- * verbatim and never recomputes it. The remaining budget is derived from
228
+ * The analysis section for KB confirmations that never reached a pushed bible
229
+ * commit (the push kept failing, the maintainer stayed busy or unreachable, or
230
+ * bible commits were sealed). Empty when every confirmation was published.
231
+ * @param {{ repos?: Array<{ repo: string, count: number }>, sealedReason?: string|null }|null} unpublished
232
+ * @returns {string[]}
233
+ */
234
+ function kbBibleLines(unpublished) {
235
+ const repos = unpublished && Array.isArray(unpublished.repos) ? unpublished.repos.filter((r) => r && r.count > 0) : [];
236
+ if (repos.length === 0) return [];
237
+ return [
238
+ '',
239
+ '## KB bible',
240
+ '',
241
+ 'WARNING: bible not published -- these KB confirmations are not in a pushed bible commit on the sprint branch'
242
+ + ' as of this analysis (the harvest round retries once more after it is written):',
243
+ ...repos.map((r) => `- ${r.repo}: ${r.count} unpublished confirmation(s).`),
244
+ ...(unpublished.sealedReason ? [`Bible commits were sealed: ${unpublished.sealedReason}.`] : []),
245
+ ];
246
+ }
247
+
248
+ /**
249
+ * Builds the sprint cost block (appended to the analysis document and rendered
250
+ * in the PR body) from the live `budget` object. Reports only what is known:
251
+ * an unset ceiling, an absent spent() and an unpriced-model spend gap are each
252
+ * stated as such rather than backfilled with a fabricated number, since the
253
+ * block is published verbatim and never recomputed. The remaining budget is derived from
154
254
  * `total` and `spent()`, not read from the budget object.
155
255
  * @param {{ total: number|null, spent?: () => number, pricingSummary?: () => { real: number, fallback: number } }} budget
156
256
  * @param {{ spend?: number, dispatchCount?: number }} [integTestRunnerStats] -- apra-fleet-nwh.1:
@@ -137,7 +137,20 @@ export async function resolveSettleShellWith({ fleetApi, member, log = () => {}
137
137
  * fleetApi: object|null,
138
138
  * resolveMemberProvider: ((member: string) => Promise<string|undefined>)|undefined,
139
139
  * resolveSettleShell: (opts: { member: string, log?: Function }) => Promise<string>,
140
+ * dispatchToolCalls: object[],
141
+ * memberInit: object[],
142
+ * startedAtMs: number,
140
143
  * }}
144
+ *
145
+ * `dispatchToolCalls` is the sprint's per-dispatch kb_* and code_* call record
146
+ * list (dispatch-accounting.mjs appends one entry per member dispatch, from
147
+ * session_stats snapshots taken before and after it). The sprint summary and
148
+ * the viewer read it from here.
149
+ *
150
+ * `memberInit` holds one record per member from the sprint-init probe
151
+ * (member-init-probe.mjs MemberInitRecord): verified status, fleetMcp, tool
152
+ * presence, CONFIRMED count and code index state. Filled once at sprint init
153
+ * and read by the KNOWLEDGE BANK injection and the viewer.
141
154
  */
142
155
  export function createSprintState({ callTool, log = () => {}, createFleetApi } = {}) {
143
156
  const active = typeof callTool === 'function';
@@ -152,12 +165,21 @@ export function createSprintState({ callTool, log = () => {}, createFleetApi } =
152
165
  // createMemberVcsProviderResolver and is unchanged by the relocation.
153
166
  const resolveMemberProvider = active ? createMemberVcsProviderResolver({ callTool, log }) : undefined;
154
167
 
168
+ // The sprint's ONE start stamp, taken when the state is built at the top
169
+ // of runSprintCycle. Every "since this sprint started" decision reads it
170
+ // (the stale in_progress reclaim, the KB promotion-candidate window)
171
+ // rather than taking its own Date.now().
172
+ const startedAtMs = Date.now();
173
+
155
174
  return {
175
+ startedAtMs,
156
176
  callTool: active ? callTool : undefined,
157
177
  fleetApi,
158
178
  resolveMemberProvider,
159
179
  resolveSettleShell({ member, log: callLog = log } = {}) {
160
180
  return resolveSettleShellWith({ fleetApi, member, log: callLog });
161
181
  },
182
+ dispatchToolCalls: [],
183
+ memberInit: [],
162
184
  };
163
185
  }