@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
@@ -123,6 +123,15 @@ export function parseBeadsIdentity({ where, syncRemote, repoRemote }) {
123
123
  };
124
124
  }
125
125
 
126
+ // Whether the identity describes an actual beads DATABASE. `bd where` also
127
+ // answers a path -- and, when the tracked .beads/config.yaml carries an
128
+ // issue-prefix, a prefix too -- for a workspace with NO database behind it
129
+ // (a fresh clone of a repo that commits its beads config). Only
130
+ // database_path proves a database exists.
131
+ export function hasBeadsDatabase(id) {
132
+ return !!(id && id.databasePath);
133
+ }
134
+
126
135
  export function isCompleteIdentity(id) {
127
136
  return !!(id && id.beadsDir && id.prefix && id.syncRemote && id.repoRemote);
128
137
  }
@@ -0,0 +1,201 @@
1
+ // =============================================================================
2
+ // Beads memory hygiene: remove token-usage memories from the beads DB at
3
+ // sprint start, before any dispatch.
4
+ //
5
+ // `bd prime` injects EVERY stored memory into EVERY agent session. A member
6
+ // running stale role prompts can write per-dispatch token-usage records as
7
+ // memories (`<label> [role] <model> tokens: input=<N> output=<N>`); left in
8
+ // the shared DB they grow without bound and bloat every session's context.
9
+ // This module is the engine-side defence: it lists the memories once on the
10
+ // backlog member and forgets
11
+ // - every value that matches TOKEN_MEMORY_RE (anchored to the WHOLE value),
12
+ // - every key in RETIRED_MEMORY_KEYS (exact key, value ignored),
13
+ // then pushes the beads DB once through the injected pushBeads().
14
+ //
15
+ // Deliberate policy:
16
+ // - a NEAR-MISS (a value that mentions `tokens: input=` but does not match
17
+ // the anchored rule) is warned about, never deleted;
18
+ // - a key outside SAFE_MEMORY_KEY_RE is skipped and warned about, never
19
+ // interpolated into a command;
20
+ // - no cap on the number of forgets;
21
+ // - the sweep NEVER throws: list/parse/forget/push failures are warnings
22
+ // and the sprint continues.
23
+ //
24
+ // Every command() call here names its member explicitly (dispatch-safety
25
+ // guard) and is issued failSoft + silent, like the other read-only probes in
26
+ // this package. pushBeads is injected so this module never imports the sync
27
+ // modules itself.
28
+ // =============================================================================
29
+
30
+ const LABEL = 'beads-hygiene';
31
+ export const BEADS_HYGIENE_WARNING_PREFIX = '[beads-hygiene] WARNING: ';
32
+
33
+ /** A whole memory value that is a token-usage record: label [+ role] + model, then real numbers. */
34
+ export const TOKEN_MEMORY_RE = /^\s*(?:\S+\s+){0,2}\S+\s+tokens:\s*input=~?\d[\d,]*\s+output=~?\d[\d,]*\s*$/i;
35
+
36
+ /** Keys forgotten by exact name regardless of value. */
37
+ export const RETIRED_MEMORY_KEYS = Object.freeze(['token-estimates-json']);
38
+
39
+ /** Keys are interpolated bare into a forget command; anything else is skipped. */
40
+ export const SAFE_MEMORY_KEY_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
41
+
42
+ const NEAR_MISS_RE = /tokens:\s*input=/i;
43
+ const MAX_LISTED_KEYS = 20;
44
+
45
+ /**
46
+ * @param {string} key
47
+ * @param {unknown} value
48
+ * @returns {'token'|'retired'|'near-miss'|'keep'}
49
+ */
50
+ export function classifyMemory(key, value) {
51
+ if (RETIRED_MEMORY_KEYS.includes(key)) return 'retired';
52
+ if (typeof value !== 'string') return 'keep';
53
+ if (TOKEN_MEMORY_RE.test(value)) return 'token';
54
+ if (NEAR_MISS_RE.test(value)) return 'near-miss';
55
+ return 'keep';
56
+ }
57
+
58
+ function outputOf(res) {
59
+ if (res && typeof res === 'object') return typeof res.output === 'string' ? res.output : '';
60
+ return typeof res === 'string' ? res : '';
61
+ }
62
+
63
+ function failureOf(res) {
64
+ if (res && typeof res === 'object' && res.ok === false) return String(res.error || 'command failed');
65
+ return null;
66
+ }
67
+
68
+ function errText(err) {
69
+ return err && err.message ? err.message : String(err);
70
+ }
71
+
72
+ function summarize(text) {
73
+ const t = String(text || '').replace(/\s+/g, ' ').trim();
74
+ if (!t) return '(no output)';
75
+ return t.length > 200 ? `${t.slice(0, 200)}...` : t;
76
+ }
77
+
78
+ function listKeys(keys) {
79
+ if (keys.length <= MAX_LISTED_KEYS) return keys.join(', ');
80
+ return `${keys.slice(0, MAX_LISTED_KEYS).join(', ')} (+${keys.length - MAX_LISTED_KEYS} more)`;
81
+ }
82
+
83
+ // `bd memories --json` answers a flat { key: value } object; non-string
84
+ // values (e.g. a schema_version field) are not memories.
85
+ function parseMemories(text) {
86
+ const trimmed = String(text || '').trim();
87
+ if (!trimmed) return {};
88
+ const parsed = JSON.parse(trimmed);
89
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
90
+ throw new Error('expected a JSON object of key -> value');
91
+ }
92
+ return parsed;
93
+ }
94
+
95
+ /**
96
+ * Lists the member's memories, forgets token-usage records and retired keys,
97
+ * pushes once when anything was forgotten, and logs one WARNING line
98
+ * summarizing it all. Never throws.
99
+ *
100
+ * @param {{ command: Function, log?: Function, member: string, pushBeads?: Function }} opts
101
+ * @returns {Promise<{ removed: string[], nearMisses: string[], skipped: string[], failed: string[], warnings: string[], pushed: boolean }>}
102
+ */
103
+ export async function sweepTokenMemories({ command, log = () => {}, member, pushBeads }) {
104
+ const result = { removed: [], nearMisses: [], skipped: [], failed: [], warnings: [], pushed: false };
105
+ const warnLine = (text) => {
106
+ result.warnings.push(text);
107
+ log(`${BEADS_HYGIENE_WARNING_PREFIX}${text}`);
108
+ };
109
+ try {
110
+ if (typeof command !== 'function' || typeof member !== 'string' || !member) {
111
+ warnLine('memory sweep skipped: no command function or member was supplied.');
112
+ return result;
113
+ }
114
+
115
+ let res;
116
+ try {
117
+ res = await command('bd memories --json', { member_name: member, silent: true, failSoft: true, label: LABEL });
118
+ } catch (err) {
119
+ res = { ok: false, output: '', error: errText(err) };
120
+ }
121
+ const listFailure = failureOf(res);
122
+ if (listFailure !== null) {
123
+ warnLine(`could not list beads memories on '${member}' (${summarize(listFailure)}); memory sweep skipped, the sprint continues.`);
124
+ return result;
125
+ }
126
+ let memories;
127
+ try {
128
+ memories = parseMemories(outputOf(res));
129
+ } catch (err) {
130
+ warnLine(`could not parse the beads memory list on '${member}' (${summarize(errText(err))}); memory sweep skipped, the sprint continues.`);
131
+ return result;
132
+ }
133
+
134
+ const toForget = [];
135
+ for (const [key, value] of Object.entries(memories)) {
136
+ const kind = classifyMemory(key, value);
137
+ if (kind === 'keep') continue;
138
+ if (kind === 'near-miss') {
139
+ result.nearMisses.push(key);
140
+ continue;
141
+ }
142
+ if (!SAFE_MEMORY_KEY_RE.test(key)) {
143
+ result.skipped.push(key);
144
+ continue;
145
+ }
146
+ toForget.push(key);
147
+ }
148
+
149
+ for (const key of toForget) {
150
+ let fres;
151
+ try {
152
+ fres = await command(`bd forget ${key}`, { member_name: member, silent: true, failSoft: true, label: LABEL });
153
+ } catch (err) {
154
+ fres = { ok: false, output: '', error: errText(err) };
155
+ }
156
+ if (failureOf(fres) !== null) result.failed.push(key);
157
+ else result.removed.push(key);
158
+ }
159
+
160
+ let pushError = null;
161
+ if (result.removed.length > 0 && typeof pushBeads === 'function') {
162
+ try {
163
+ // The real push (gitSync.syncBeadsAfter) is non-fatal: it
164
+ // returns a structured outcome { ok, degraded, degradedKind,
165
+ // detail } instead of throwing, so inspect it. A non-object
166
+ // return is treated as success.
167
+ const outcome = await pushBeads();
168
+ if (outcome && typeof outcome === 'object' && (outcome.degraded || outcome.ok === false)) {
169
+ pushError = [outcome.degradedKind, outcome.detail ?? outcome.kind].filter(Boolean).map(String).join(': ') || 'push degraded';
170
+ } else {
171
+ result.pushed = true;
172
+ }
173
+ } catch (err) {
174
+ pushError = errText(err);
175
+ }
176
+ }
177
+
178
+ if (result.removed.length || result.nearMisses.length || result.skipped.length || result.failed.length || pushError) {
179
+ const parts = [];
180
+ if (result.removed.length) {
181
+ parts.push(`removed ${result.removed.length} token-usage memor${result.removed.length === 1 ? 'y' : 'ies'} from the beads DB: ${listKeys(result.removed)}`);
182
+ }
183
+ if (result.failed.length) parts.push(`could not forget ${result.failed.length}: ${listKeys(result.failed)}`);
184
+ if (pushError) parts.push(`the beads push after the sweep failed (${summarize(pushError)}); the next beads push retries it`);
185
+ if (result.nearMisses.length) {
186
+ parts.push(`left ${result.nearMisses.length} memor${result.nearMisses.length === 1 ? 'y' : 'ies'} that mention token usage but do not match the rule (not deleted, review by hand): ${listKeys(result.nearMisses)}`);
187
+ }
188
+ if (result.skipped.length) {
189
+ parts.push(`skipped ${result.skipped.length} matching memor${result.skipped.length === 1 ? 'y' : 'ies'} with an unsafe key (remove by hand): ${listKeys(result.skipped.map((k) => JSON.stringify(k)))}`);
190
+ }
191
+ parts.push('a member may be running stale role prompts that store token usage as beads memories');
192
+ warnLine(`${parts.join('; ')}.`);
193
+ } else {
194
+ log('[beads-hygiene] no token-usage memories in the beads DB.');
195
+ }
196
+ } catch (err) {
197
+ // Belt and braces: the sweep must never abort a sprint.
198
+ warnLine(`memory sweep failed unexpectedly (${summarize(errText(err))}); the sprint continues.`);
199
+ }
200
+ return result;
201
+ }
@@ -312,6 +312,113 @@ export function partitionByGoalMembership(tasks, goal) {
312
312
  return { sprintTasks, backlogTasks };
313
313
  }
314
314
 
315
+ // ---------------------------------------------------------------------------
316
+ // Below-goal beads are not DISPATCHED unless they serve in-goal work
317
+ // ---------------------------------------------------------------------------
318
+ //
319
+ // The develop loop used to dispatch every ready leaf in scope, ordering by
320
+ // priority but never excluding: a P3 streak could run in round 1 of a P1/P2
321
+ // sprint, ahead of P1/P2 work. Exclusion uses the same "below goal" test as
322
+ // partitionByGoalMembership (a FINITE numeric priority strictly worse than the
323
+ // goal max -- a bead with no numeric priority is never excluded) and the same
324
+ // blocks-edge idea, made transitive: a below-goal bead stays dispatchable when
325
+ //
326
+ // - it (transitively, over 'blocks' edges) blocks an open in-goal bead --
327
+ // in-goal work cannot finish without it; or
328
+ // - this sprint already dispatched it (e.g. a reviewer reopen the
329
+ // worked-on exemption let through) -- the sprint is repairing its own
330
+ // work.
331
+ //
332
+ // Deliberately NO parent-chain exemption: a sprint's target root is normally
333
+ // an open in-goal epic, so "has an open in-goal ancestor" would keep every
334
+ // below-goal task in scope and make this filter inert.
335
+ //
336
+ // Consistent with the completion gate: that gate counts only beads at or above
337
+ // goal priority (`--priority-max=goalMax`), so an excluded below-goal bead
338
+ // never holds the sprint open.
339
+
340
+ /** A bead's `blocks` prerequisites (ids it depends on), across bd's two dependency shapes. */
341
+ function blocksPrereqIds(bead) {
342
+ const deps = bead && Array.isArray(bead.dependencies) ? bead.dependencies : [];
343
+ const out = [];
344
+ for (const d of deps) {
345
+ if (typeof d === 'string') { if (d) out.push(d); continue; }
346
+ if (!d || typeof d !== 'object') continue;
347
+ const type = d.type ?? d.dependency_type;
348
+ if (type !== undefined && type !== 'blocks') continue;
349
+ const id = d.depends_on_id ?? d.id;
350
+ if (id !== undefined && id !== null && id !== '') out.push(String(id));
351
+ }
352
+ return out;
353
+ }
354
+
355
+ /**
356
+ * Split ready leaf beads into those the develop loop may dispatch and the
357
+ * below-goal ones it must not (see the block comment above).
358
+ *
359
+ * @param {Array<object>} ready - ready leaf beads (bd list --ready shape)
360
+ * @param {Array<object>} scopeBeads - every in-scope bead, any status, with `dependencies` and `parent`
361
+ * @param {string} goal - sprint goal band, e.g. 'P1/P2'
362
+ * @param {{ workedOnIds?: Set<string>|Iterable<string> }} [opts]
363
+ * @returns {{ dispatchable: object[], excluded: Array<{ id: string, priority: number }> }}
364
+ */
365
+ export function partitionReadyByGoal(ready, scopeBeads, goal, opts = {}) {
366
+ const list = Array.isArray(ready) ? ready : [];
367
+ const scope = Array.isArray(scopeBeads) ? scopeBeads : [];
368
+ const goalMaxNum = Number(goalPriorityMax(goal).slice(1));
369
+ const workedOn = opts.workedOnIds instanceof Set ? opts.workedOnIds : new Set(opts.workedOnIds || []);
370
+ const isBelowGoal = (b) =>
371
+ b && typeof b.priority === 'number' && Number.isFinite(b.priority) && b.priority > goalMaxNum;
372
+ const isOpen = (b) => b && b.status !== 'closed';
373
+
374
+ const byId = new Map();
375
+ for (const b of [...scope, ...list]) {
376
+ if (b && b.id !== undefined && b.id !== null && !byId.has(String(b.id))) byId.set(String(b.id), b);
377
+ }
378
+
379
+ // Every bead that (transitively) blocks an open in-goal bead: walk the
380
+ // blocks prerequisites backwards from each open in-goal bead.
381
+ const servesInGoal = new Set();
382
+ const queue = [];
383
+ for (const b of byId.values()) {
384
+ if (isOpen(b) && !isBelowGoal(b)) queue.push(String(b.id));
385
+ }
386
+ const visited = new Set(queue);
387
+ while (queue.length > 0) {
388
+ const id = queue.shift();
389
+ for (const pre of blocksPrereqIds(byId.get(id))) {
390
+ servesInGoal.add(pre);
391
+ if (!visited.has(pre)) { visited.add(pre); queue.push(pre); }
392
+ }
393
+ }
394
+
395
+ const dispatchable = [];
396
+ const excluded = [];
397
+ for (const b of list) {
398
+ if (!b) continue;
399
+ const id = String(b.id);
400
+ if (!isBelowGoal(b) || workedOn.has(id) || servesInGoal.has(id)) {
401
+ dispatchable.push(b);
402
+ } else {
403
+ excluded.push({ id, priority: b.priority });
404
+ }
405
+ }
406
+ return { dispatchable, excluded };
407
+ }
408
+
409
+ /**
410
+ * The run-log line for beads partitionReadyByGoal excluded from dispatch.
411
+ *
412
+ * @param {Array<{ id: string, priority: number }>} excluded
413
+ * @param {string} goal
414
+ * @returns {string}
415
+ */
416
+ export function formatBelowGoalExclusionLog(excluded, goal) {
417
+ const named = excluded.map((e) => e.id + ' (P' + e.priority + ')').join(', ');
418
+ return `Develop dispatch: EXCLUDED ${named} -- below this sprint's goal ${goal}, not blocking any open ` +
419
+ 'in-goal bead, and not yet worked on by this sprint -- excluded as below goal, not dispatched.';
420
+ }
421
+
315
422
  /**
316
423
  * Build the id->bead and parent->children indexes every scope walk needs.
317
424
  *
@@ -470,7 +577,7 @@ export function classifyVerifySet(allBeads, targetIssues) {
470
577
  * or `phase`, so every direct call -- and every helper that receives
471
578
  * `command` via an options object -- transparently goes through them.
472
579
  *
473
- * `getOrchestratorMember` is a getter, not a value, because the orchestrator
580
+ * `getBacklogMember` is a getter, not a value, because the orchestrator
474
581
  * member is resolved from the role->member mapping well after this client is
475
582
  * constructed (the snapshot must exist before the `command` wrapper does,
476
583
  * and the wrapper must exist before anything can resolve members). No fetch
@@ -481,18 +588,18 @@ export function classifyVerifySet(allBeads, targetIssues) {
481
588
  * @param {string[]} opts.targetIssues - the sprint's target issue root id(s)
482
589
  * @param {string|null} [opts.assignee] - `--assignee` narrowing for filtered queries
483
590
  * @param {(raw: string, label: string) => any} opts.parseBdJson - bd JSON parser (injected to avoid an import cycle back into runner.js)
484
- * @param {() => string} opts.getOrchestratorMember - resolves the member every read is dispatched to
591
+ * @param {() => string} opts.getBacklogMember - resolves the member every read is dispatched to
485
592
  */
486
593
  export function createBeadsScope(opts = {}) {
487
594
  const targetIssues = opts.targetIssues || [];
488
595
  const assignee = opts.assignee || null;
489
596
  const parseBdJson = opts.parseBdJson;
490
- const getOrchestratorMember = opts.getOrchestratorMember;
597
+ const getBacklogMember = opts.getBacklogMember;
491
598
  if (typeof parseBdJson !== 'function') {
492
599
  throw new TypeError('createBeadsScope({ parseBdJson }): parseBdJson must be a function');
493
600
  }
494
- if (typeof getOrchestratorMember !== 'function') {
495
- throw new TypeError('createBeadsScope({ getOrchestratorMember }): getOrchestratorMember must be a function');
601
+ if (typeof getBacklogMember !== 'function') {
602
+ throw new TypeError('createBeadsScope({ getBacklogMember }): getBacklogMember must be a function');
496
603
  }
497
604
 
498
605
  let allBeadsSnapshot = null; // { beads } -- cleared by invalidateAllBeadsCache()
@@ -575,7 +682,7 @@ export function createBeadsScope(opts = {}) {
575
682
  }
576
683
  if (!allBeadsInFlight) {
577
684
  const allLabel = 'bd list --all --limit 0 --json';
578
- allBeadsInFlight = command(allLabel, { member_name: getOrchestratorMember(), silent: true })
685
+ allBeadsInFlight = command(allLabel, { member_name: getBacklogMember(), silent: true })
579
686
  .then((raw) => parseBdJson(raw, allLabel))
580
687
  .then((beads) => {
581
688
  allBeadsSnapshot = { beads };
@@ -623,7 +730,7 @@ export function createBeadsScope(opts = {}) {
623
730
  filterArgs = `${rest} --assignee ${assignee}`;
624
731
  }
625
732
  const filterLabel = `bd list ${filterArgs} --limit 0`;
626
- const filterRaw = await command(filterLabel, { member_name: getOrchestratorMember(), silent: true });
733
+ const filterRaw = await command(filterLabel, { member_name: getBacklogMember(), silent: true });
627
734
  return parseBdJson(filterRaw, filterLabel).filter((b) => b && scopeIds.has(b.id));
628
735
  }
629
736
 
@@ -57,7 +57,125 @@ export function isReviewerContractViolation(verdict) {
57
57
  return verdict.verdict === 'CHANGES_NEEDED'
58
58
  && (!verdict.reopenIds || verdict.reopenIds.length === 0)
59
59
  && (!verdict.newTasks || verdict.newTasks.length === 0)
60
- && (!verdict.replanIds || verdict.replanIds.length === 0);
60
+ && (!verdict.replanIds || verdict.replanIds.length === 0)
61
+ // A verdict reporting a red build/test run is actionable on its own:
62
+ // the orchestrator files an in-goal fix task for it (see
63
+ // needsRedBranchFixTask below), so it is not self-contradictory.
64
+ && verdict.buildFailing !== true;
65
+ }
66
+
67
+ // =============================================================================
68
+ // RED BRANCH -> ALWAYS A FIX DISPATCH.
69
+ //
70
+ // A CHANGES_NEEDED verdict reporting a failing build or test run must always
71
+ // leave dispatchable work behind. Before this, a reviewer naming only
72
+ // below-goal reopenIds (all skipped by the goal-scope guard) -- or none at all
73
+ // -- left the develop loop with zero open work on a red branch: it idled or
74
+ // exited, and nothing ever fixed the tests. When nothing actionable survived,
75
+ // the orchestrator files ONE in-goal fix task carrying the reviewer's notes.
76
+ // =============================================================================
77
+
78
+ /** Fixed title of the orchestrator-filed red-branch fix task (also its dedupe key). */
79
+ export const RED_BRANCH_FIX_TITLE = 'Fix the failing build or tests on the sprint branch';
80
+
81
+ /**
82
+ * Does this verdict need an orchestrator-filed red-branch fix task?
83
+ *
84
+ * @param {object} o
85
+ * @param {{ verdict: string, buildFailing?: boolean }} o.verdict
86
+ * @param {number} o.reopenedCount - reopens that survived the goal-scope guard
87
+ * @param {number} o.inGoalNewTaskCount - newTasks persisted at an in-goal priority
88
+ * @returns {boolean}
89
+ */
90
+ export function needsRedBranchFixTask({ verdict, reopenedCount, inGoalNewTaskCount }) {
91
+ return Boolean(verdict)
92
+ && verdict.verdict === 'CHANGES_NEEDED'
93
+ && verdict.buildFailing === true
94
+ && reopenedCount === 0
95
+ && inGoalNewTaskCount === 0;
96
+ }
97
+
98
+ /**
99
+ * Is a newTask priority string ('P2') inside the sprint's goal band?
100
+ *
101
+ * @param {string} priority
102
+ * @param {number|string} goalMax
103
+ * @returns {boolean}
104
+ */
105
+ export function isInGoalPriority(priority, goalMax) {
106
+ const p = normalizeGoalMax(String(priority));
107
+ const max = normalizeGoalMax(goalMax);
108
+ return Number.isFinite(p) && Number.isFinite(max) && p <= max;
109
+ }
110
+
111
+ /**
112
+ * Build the red-branch fix task: highest tier named in the goal, a fixed
113
+ * title, and the reviewer's notes (non-printable/non-ASCII characters
114
+ * replaced so newTask validation cannot reject it).
115
+ *
116
+ * @param {object} o
117
+ * @param {string} o.goal - e.g. 'P1/P2'
118
+ * @param {string} o.notes - the reviewer's notes
119
+ * @param {string} o.site - site label for the description, e.g. 'Review C1 R2'
120
+ * @param {string[]} [o.skippedReopenIds] - reopenIds the guard filtered out
121
+ * @returns {{ title: string, description: string, priority: string }}
122
+ */
123
+ export function buildRedBranchFixTask({ goal, notes, site, skippedReopenIds = [] }) {
124
+ const tiers = String(goal || '').split('/').map((p) => Number(p.trim().replace(/^[Pp]/, ''))).filter(Number.isFinite);
125
+ const best = tiers.length > 0 ? Math.min(...tiers) : 1;
126
+ const safeNotes = String(notes || '(no reviewer notes)').replace(/[^\t\n\r\x20-\x7E]/g, '?');
127
+ const skipped = skippedReopenIds.length > 0
128
+ ? `\n\nThe reviewer named these beads for rework, but none could be reopened in this sprint: ${skippedReopenIds.join(', ')}.`
129
+ : '';
130
+ return {
131
+ title: RED_BRANCH_FIX_TITLE,
132
+ priority: `P${best}`,
133
+ description:
134
+ `The reviewer (${site}) reported that the build or tests FAIL on the sprint branch, and no reopened ` +
135
+ `or newly filed in-goal task covers the fix. Make the project's build and full test suite pass again ` +
136
+ `without weakening any test, then close this task.${skipped}\n\nReviewer notes:\n${safeNotes}`,
137
+ };
138
+ }
139
+
140
+ /**
141
+ * File the red-branch fix task when the verdict needs one, unless an earlier
142
+ * one is still not closed (one open fix task at a time, never one per round).
143
+ *
144
+ * @param {object} o
145
+ * @param {object} o.verdict - the reviewer verdict
146
+ * @param {number} o.reopenedCount
147
+ * @param {number} o.inGoalNewTaskCount
148
+ * @param {string[]} [o.skippedReopenIds]
149
+ * @param {string} o.goal
150
+ * @param {string} o.site - log/description label, e.g. 'Review C1 R2'
151
+ * @param {(rest: string) => Promise<Array<object>>} o.bdListScoped
152
+ * @param {(task: {title: string, description: string, priority: string}) => Promise<any>} o.createTask - creates the bead; truthy on success
153
+ * @param {(msg: string) => void} o.log
154
+ * @returns {Promise<'not-needed'|'exists'|'created'|'failed'>}
155
+ */
156
+ export async function ensureRedBranchFixTask(o) {
157
+ const { verdict, reopenedCount, inGoalNewTaskCount, skippedReopenIds = [], goal, site, bdListScoped, createTask, log } = o;
158
+ if (!needsRedBranchFixTask({ verdict, reopenedCount, inGoalNewTaskCount })) return 'not-needed';
159
+ let existing = null;
160
+ try {
161
+ const scope = await bdListScoped('');
162
+ existing = scope.find((b) => b && b.title === RED_BRANCH_FIX_TITLE && b.status !== 'closed') || null;
163
+ } catch {
164
+ existing = null; // lookup failed -- file the task rather than risk leaving a red branch with no work
165
+ }
166
+ if (existing) {
167
+ log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- red-branch fix task ${existing.id} is still open, not filing another.`);
168
+ return 'exists';
169
+ }
170
+ const task = buildRedBranchFixTask({ goal, notes: verdict.notes, site, skippedReopenIds });
171
+ const created = await createTask(task);
172
+ if (created) {
173
+ const idText = created && typeof created === 'object' && created.childId ? ` ${created.childId}` : '';
174
+ log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- filed in-goal red-branch fix task${idText} ("${task.title}", ${task.priority}) so the branch is never left red with zero open work.`);
175
+ return 'created';
176
+ }
177
+ log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- filing the red-branch fix task FAILED; see the newTask persistence log above.`);
178
+ return 'failed';
61
179
  }
62
180
 
63
181
  /**
@@ -130,18 +248,41 @@ export function normalizeGoalMax(goalMax) {
130
248
  * because comparing against the raw 'P2' string is what made this guard inert
131
249
  * (see normalizeGoalMax).
132
250
  *
251
+ * WORKED-ON EXEMPTION. A below-goal bead THIS SPRINT already dispatched or
252
+ * closed is never deferred: the sprint's own commits for it are on the branch
253
+ * under review, so a reviewer reopening it is asking the sprint to repair its
254
+ * own work (typically a red build or test run) -- not to pull deferred scope
255
+ * back in. Skipping that reopen left a red branch with nothing dispatched to
256
+ * fix it. `belowGoal` is still reported so the caller can log WHY the bead
257
+ * was kept.
258
+ *
133
259
  * @param {Map<string, object>|null} allowlist
134
260
  * @param {string} id
135
261
  * @param {number|string} goalMax - numeric ceiling, or the 'Pn' string form
136
- * @returns {{ deferred: boolean, priority: number|null }}
262
+ * @param {Set<string>|Iterable<string>|null} [workedOnIds] - bead ids this sprint dispatched or closed
263
+ * @returns {{ deferred: boolean, priority: number|null, belowGoal: boolean, workedOn: boolean }}
137
264
  */
138
- export function isDeferredScopeReopen(allowlist, id, goalMax) {
265
+ export function isDeferredScopeReopen(allowlist, id, goalMax, workedOnIds = null) {
139
266
  const bead = allowlist ? allowlist.get(id) : null;
140
267
  const max = normalizeGoalMax(goalMax);
141
- if (allowlist && bead && typeof bead.priority === 'number' && bead.priority > max) {
142
- return { deferred: true, priority: bead.priority };
143
- }
144
- return { deferred: false, priority: bead && typeof bead.priority === 'number' ? bead.priority : null };
268
+ const priority = bead && typeof bead.priority === 'number' ? bead.priority : null;
269
+ const belowGoal = Boolean(allowlist && bead && priority !== null && priority > max);
270
+ const workedOn = toIdSet(workedOnIds).has(id);
271
+ return { deferred: belowGoal && !workedOn, priority, belowGoal, workedOn };
272
+ }
273
+
274
+ /**
275
+ * Normalise an optional worked-on id collection (Set, array, any iterable, or
276
+ * absent) to a Set. Absent means "the sprint has worked on nothing yet", which
277
+ * keeps the guard's historical behaviour exactly.
278
+ *
279
+ * @param {Set<string>|Iterable<string>|null|undefined} ids
280
+ * @returns {Set<string>}
281
+ */
282
+ function toIdSet(ids) {
283
+ if (ids instanceof Set) return ids;
284
+ if (ids && typeof ids[Symbol.iterator] === 'function' && typeof ids !== 'string') return new Set(ids);
285
+ return new Set();
145
286
  }
146
287
 
147
288
  /**
@@ -197,12 +338,14 @@ export function parseIdWithReasonEntry(entry) {
197
338
  * @param {(e: {id: string, reason: string}) => {cmd: string, label: string}|null} o.buildReopenCommand
198
339
  * @param {(e: {id: string, reason: string}) => void} [o.onReopened] - per-bead side effects (thrash counters, feedback routing)
199
340
  * @param {(e: {id: string, reason: string}, err: Error) => void} [o.onEntryError] - when present, a throwing entry is non-fatal and reported here
341
+ * @param {Set<string>|Iterable<string>} [o.workedOnIds] - bead ids this sprint dispatched or closed; a below-goal reopen of one of these is APPLIED (see isDeferredScopeReopen)
200
342
  * @returns {Promise<string[]>} the ids ACTUALLY reopened (survived the guard)
201
343
  */
202
344
  export async function applyGuardedReopens(o) {
203
345
  const {
204
346
  entries, bdListScoped, goalMax, goal, logPrefix, log, command, member,
205
347
  parseEntry = parseBareIdEntry, buildReopenCommand, onReopened, onEntryError,
348
+ workedOnIds = null,
206
349
  } = o;
207
350
 
208
351
  const list = Array.isArray(entries) ? entries : [];
@@ -221,11 +364,14 @@ export async function applyGuardedReopens(o) {
221
364
  continue;
222
365
  }
223
366
 
224
- const { deferred, priority } = isDeferredScopeReopen(allowlist, parsed.id, goalMax);
367
+ const { deferred, priority, belowGoal } = isDeferredScopeReopen(allowlist, parsed.id, goalMax, workedOnIds);
225
368
  if (deferred) {
226
369
  log(`${logPrefix}: SKIPPED '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal} -- deferred scope, not reopened).`);
227
370
  continue;
228
371
  }
372
+ if (belowGoal) {
373
+ log(`${logPrefix}: KEPT '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal}, but this sprint already dispatched or closed it -- reopening so the sprint repairs its own work).`);
374
+ }
229
375
 
230
376
  try {
231
377
  const built = buildReopenCommand(parsed);