@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -24,7 +24,7 @@ export const meta = {
24
24
  // suite + toy-sprint smoke test, sandbox setup/reset/teardown);
25
25
  // informational only, files parent-less [regression][carry-over] bugs
26
26
  // ci-watcher -- polls CI; creates beads task if not configured
27
- // harvester -- docs, CHANGELOG, token summary, PR
27
+ // harvester -- docs, token summary, PR
28
28
  //
29
29
  // Beads owns all work items and is the exit signal.
30
30
  // JS workflow owns all routing. No LLM ever decides whether to continue.
@@ -1277,6 +1277,123 @@ function worktreeNamesFor(sprintBranch, taskId, worktreeRoot) {
1277
1277
  };
1278
1278
  }
1279
1279
 
1280
+ // EXPORT SHRINK GUARD (my-beads-db-27m.12): replaces the unguarded
1281
+ // `git -C "${repo}" add .beads/issues.jsonl` step. Compares the id set of the freshly
1282
+ // written .beads/issues.jsonl against the ids committed at HEAD BEFORE staging it, so a
1283
+ // `bd export` run against a workspace whose Dolt DB has diverged from the repo's
1284
+ // committed export cannot silently clobber the committed id set (a line-count/size
1285
+ // check would miss this: the file can grow while still dropping most committed ids).
1286
+ // Mirrors the kb-export.ts shrink guard (src/tools/kb-export.ts, maybeAutoCommitBible):
1287
+ // written to disk but NOT staged/committed unless AUTO_SPRINT_ALLOW_EXPORT_SHRINK=1 is
1288
+ // set as an explicit operator opt-in.
1289
+ //
1290
+ // DUPLICATED (intentionally) from lib/export-shrink-guard.mjs's runExportShrinkGuard, so
1291
+ // this stays a single self-contained shell command -- the dispatched agent runs inside
1292
+ // an arbitrary target repo's checkout, not this monorepo, and cannot `require()` that
1293
+ // file. Keep both in sync when changing the algorithm (same convention as
1294
+ // lib/parse-sprint-args.mjs). Pure -- no I/O, just builds a command string -- so it lives
1295
+ // in this PURE_FUNCTIONS block and test/export-shrink-guard.test.mjs can extract and call
1296
+ // it the same way test/sprint-cost.test.mjs extracts computeSprintQuote.
1297
+ // repoPath is passed as a shell argument (process.argv[1]), NOT interpolated into the JS
1298
+ // source: node -e "code" runs inside an outer double-quoted shell string, and
1299
+ // JSON.stringify(repoPath) emits its own double quotes that terminate that string early,
1300
+ // leaving the shell to hand node a broken program (my-beads-db-27m.12 round-2 reopen).
1301
+ // Quoting the trailing "${repoPath}" argument matches every other `-C "${repo}"` call in
1302
+ // this file.
1303
+ //
1304
+ // DESIGN DECISION (predicate is "any dropped id", deliberately, not "loud warning" only):
1305
+ // the guard refuses to stage on ANY committed id missing from the fresh export, with no
1306
+ // narrower allowance for legitimate removals (compaction, deletion, an id moved out of
1307
+ // scope). A legitimate removal therefore looks identical to corruption from here and
1308
+ // stops the export from being committed on every later sprint until an operator notices
1309
+ // the EXPORT_GUARD_REFUSED line and either investigates or sets
1310
+ // AUTO_SPRINT_ALLOW_EXPORT_SHRINK=1. This is intentional: refusing (and requiring a human
1311
+ // to look) is judged safer than guessing which drops are legitimate, mirroring the
1312
+ // kb-export.ts shrink guard's same all-or-nothing predicate. The refusal is non-fatal to
1313
+ // the sprint, but it is NOT silent: both call sites pass their dispatch result through
1314
+ // detectExportGuardIssue() and log exportGuardLogLine() to the sprint log. If it ever
1315
+ // needs to be louder still (e.g. failing the sprint), change this predicate and its
1316
+ // counterpart in lib/export-shrink-guard.mjs together.
1317
+ //
1318
+ // FAIL CLOSED: the committed file is read with maxBuffer=256 MB (the 1 MB default threw
1319
+ // ENOBUFS on real backlogs and the old empty catch waved everything through). Whether
1320
+ // the export is tracked at HEAD is decided separately via `git ls-tree` (unborn HEAD ->
1321
+ // `rev-parse --verify -q HEAD` exits 1): only "not tracked" means an empty committed set.
1322
+ // Any other read failure prints EXPORT_GUARD_ERROR and stages nothing. git is invoked via
1323
+ // execFileSync argv arrays (no inner shell), so no extra quoting layer is involved.
1324
+ function buildExportShrinkGuardCmd(repoPath) {
1325
+ return `node -e "` +
1326
+ `const{execFileSync}=require('child_process');` +
1327
+ `const fs=require('fs');` +
1328
+ `const repo=process.argv[1];` +
1329
+ `const P='.beads/issues.jsonl';` +
1330
+ `function git(a,mb){return execFileSync('git',a,{cwd:repo,encoding:'utf8',stdio:['ignore','pipe','pipe'],maxBuffer:1048576*(mb||16)});}` +
1331
+ `function why(e){return String((e&&(e.stderr||e.code||e.message))||e).trim().split(/\\n/)[0];}` +
1332
+ `function fail(m){console.log('EXPORT_GUARD_ERROR: '+m+'. .beads/issues.jsonl NOT staged/committed (guard fails closed).');process.exit(0);}` +
1333
+ `function ids(t){const s=new Set();for(const l of String(t||'').split(/\\n/)){const x=l.trim();if(!x)continue;try{const o=JSON.parse(x);if(o&&o.id)s.add(o.id);}catch(e){}}return s;}` +
1334
+ `let tracked=false;` +
1335
+ `try{tracked=git(['ls-tree','--name-only','HEAD','--',P]).trim()!=='';}catch(e){let unborn=false;try{git(['rev-parse','--verify','-q','HEAD']);}catch(e2){unborn=!!e2&&e2.status===1;}if(!unborn)fail('cannot list HEAD tree: '+why(e));}` +
1336
+ `let before='';` +
1337
+ `if(tracked){try{before=git(['show','HEAD:'+P],256);}catch(e){fail('cannot read committed HEAD:'+P+': '+why(e));}}` +
1338
+ `const committed=ids(before);` +
1339
+ `let after='';try{after=fs.readFileSync(repo+'/'+P,'utf8');}catch(e){after='';}` +
1340
+ `const fresh=ids(after);` +
1341
+ `const dropped=[...committed].filter(id=>!fresh.has(id));` +
1342
+ `const allow=process.env.AUTO_SPRINT_ALLOW_EXPORT_SHRINK==='1';` +
1343
+ `if(dropped.length>0&&!allow){` +
1344
+ `console.log('EXPORT_GUARD_REFUSED: '+dropped.length+' committed id(s) missing from new export (e.g. '+dropped.slice(0,5).join(', ')+'). Written to disk but NOT staged/committed. Set AUTO_SPRINT_ALLOW_EXPORT_SHRINK=1 to override.');` +
1345
+ `process.exit(0);` +
1346
+ `}` +
1347
+ `try{git(['add',P]);}catch(e){fail('git add failed: '+why(e));}` +
1348
+ `console.log('EXPORT_GUARD_OK: staged .beads/issues.jsonl'+(dropped.length?' (override used, '+dropped.length+' dropped)':''));` +
1349
+ `" "${repoPath}"`;
1350
+ }
1351
+
1352
+ // Orchestrator-side detection of the guard's outcome in a dispatch result, so a refusal
1353
+ // or fail-closed error reaches the sprint log instead of dying in a Haiku transcript.
1354
+ // Accepts whatever dispatch()/dispatchShell() returned: a string, a {outputs:[...]}
1355
+ // shell result, or any object (nested strings are scanned). Returns
1356
+ // { kind: 'REFUSED'|'ERROR'|'OK', line } -- REFUSED/ERROR win over OK -- or null when no
1357
+ // EXPORT_GUARD_* marker is present. Pure.
1358
+ function detectExportGuardIssue(result) {
1359
+ const texts = [];
1360
+ const walk = (v, depth) => {
1361
+ if (v == null || depth > 6) return;
1362
+ if (typeof v === 'string') { texts.push(v); return; }
1363
+ if (Array.isArray(v)) { v.forEach(x => walk(x, depth + 1)); return; }
1364
+ if (typeof v === 'object') Object.keys(v).forEach(k => walk(v[k], depth + 1));
1365
+ };
1366
+ walk(result, 0);
1367
+ const text = texts.join('\n');
1368
+ const bad = text.match(/EXPORT_GUARD_(REFUSED|ERROR):[^\r\n]*/);
1369
+ if (bad) return { kind: bad[1], line: bad[0].trim() };
1370
+ const ok = text.match(/EXPORT_GUARD_OK:[^\r\n]*/);
1371
+ if (ok) return { kind: 'OK', line: ok[0].trim() };
1372
+ return null;
1373
+ }
1374
+
1375
+ // Operator-facing sprint-log line for a detectExportGuardIssue() result, or null when
1376
+ // nothing needs flagging (OK). stepLabel names the call site (e.g. "plan-commit-c2").
1377
+ // A missing marker is flagged too, since the guard's outcome is then unknown. Pure.
1378
+ function exportGuardLogLine(detected, stepLabel) {
1379
+ const where = stepLabel || 'beads export';
1380
+ if (!detected) {
1381
+ return `WARN: [export-guard] ${where}: no EXPORT_GUARD_* result seen -- cannot confirm ` +
1382
+ `.beads/issues.jsonl was committed; check that dispatch's transcript.`;
1383
+ }
1384
+ if (detected.kind === 'REFUSED') {
1385
+ return `WARNING: [export-guard] ${where}: beads export NOT committed -- ${detected.line} ` +
1386
+ `Every later sprint will keep refusing until resolved. If the dropped ids were removed ` +
1387
+ `on purpose (bd delete, compaction), rerun with AUTO_SPRINT_ALLOW_EXPORT_SHRINK=1 to ` +
1388
+ `commit the smaller export; otherwise investigate the beads DB divergence.`;
1389
+ }
1390
+ if (detected.kind === 'ERROR') {
1391
+ return `WARNING: [export-guard] ${where}: beads export NOT committed (guard failed closed) -- ` +
1392
+ `${detected.line}`;
1393
+ }
1394
+ return null;
1395
+ }
1396
+
1280
1397
  // PURE_FUNCTIONS_END
1281
1398
 
1282
1399
  // ROLE_SCHEMAS_GENERATED_BEGIN -- do not hand-edit; run `node scripts/gen-auto-sprint-schemas.mjs` to regenerate from agents/schemas/*.json
@@ -1328,6 +1445,10 @@ const REVIEW_SCHEMA = {
1328
1445
  "type": "string"
1329
1446
  }
1330
1447
  },
1448
+ "buildFailing": {
1449
+ "type": "boolean",
1450
+ "description": "Optional. true when the project's build or test suite FAILS on the branch under review. On a CHANGES_NEEDED verdict the orchestrator guarantees a fix is dispatched: if none of your reopenIds can be reopened and no in-goal newTask covers it, it files an in-goal fix task carrying your notes. Omit or false when the build and tests pass."
1451
+ },
1331
1452
  "newTasks": {
1332
1453
  "type": "array",
1333
1454
  "items": {
@@ -1340,7 +1461,7 @@ const REVIEW_SCHEMA = {
1340
1461
  "properties": {
1341
1462
  "title": {
1342
1463
  "type": "string",
1343
- "description": "Plain text only: letters, digits, space, and . , : ; ! ? ( ) ' _ / [ ] - -- nothing else. No backticks, double quotes, $, or backslash (the title is interpolated into a shell command downstream). Do NOT wrap a command/flag/filename in backticks here -- write it plain (e.g. \"Surface the Windows service registration mode in apra-fleet status\") or move the formatted detail into description instead, which has no such restriction. NOT enforced as a hard schema constraint here (deliberately no \"pattern\"): a single out-of-allowlist newTask title must never make ajv reject/retry the WHOLE structured verdict (verdict, notes, reopenIds, and the other newTasks) -- see validateNewTask() in fleet-sprint/runner.js, the actual (per-item, non-fatal) enforcement point, applied after parsing."
1464
+ "description": "Plain text only: letters, digits, space, and . , : ; ! ? ( ) ' _ / [ ] - -- nothing else. No backticks, double quotes, $, or backslash (the title is interpolated into a shell command downstream). Do NOT wrap a command/flag/filename in backticks here -- write it plain (e.g. \"Surface the service registration mode in the status output\") or move the formatted detail into description instead, which has no such restriction. NOT enforced as a hard schema constraint here (deliberately no \"pattern\"): a single out-of-allowlist newTask title must never make ajv reject/retry the WHOLE structured verdict (verdict, notes, reopenIds, and the other newTasks) -- see validateNewTask() in fleet-sprint/runner.js, the actual (per-item, non-fatal) enforcement point, applied after parsing."
1344
1465
  },
1345
1466
  "description": {
1346
1467
  "type": "string"
@@ -1374,6 +1495,29 @@ const REVIEW_SCHEMA = {
1374
1495
  }
1375
1496
  }
1376
1497
  },
1498
+ "kb_discards": {
1499
+ "type": "array",
1500
+ "description": "Promotion candidates this reviewer showed to be WRONG and is discarding (the entry drops out of every later read). Reviewer-only, with the same evidence bar as kb_promotions. An id may not appear in both kb_promotions and kb_discards -- the engine refuses both. The engine makes the discard calls.",
1501
+ "items": {
1502
+ "type": "object",
1503
+ "required": [
1504
+ "id",
1505
+ "reason"
1506
+ ],
1507
+ "properties": {
1508
+ "id": {
1509
+ "type": "string",
1510
+ "description": "The entry id, copied verbatim from the 'KNOWLEDGE BANK -- promotion candidates' block in your dispatch prompt. That block is the ONLY source of discardable ids -- do not call a kb_* tool to find one, and never invent one.",
1511
+ "minLength": 1
1512
+ },
1513
+ "reason": {
1514
+ "type": "string",
1515
+ "description": "The evidence that the entry is wrong -- what you actually checked that contradicts its claim.",
1516
+ "minLength": 20
1517
+ }
1518
+ }
1519
+ }
1520
+ },
1377
1521
  "kb_captures": {
1378
1522
  "type": "array",
1379
1523
  "description": "Durable knowledge this role verified during its run. The engine makes the kb_capture calls; the role only decides. Optional -- omit or send [] to capture nothing.",
@@ -1405,12 +1549,12 @@ const REVIEW_SCHEMA = {
1405
1549
  },
1406
1550
  "content": {
1407
1551
  "type": "string",
1408
- "description": "Full detail of the entry. REQUIRED -- kbCaptureSchema declares content as z.string().min(1), so a capture without it is rejected at the MCP boundary and persists nothing (apra-fleet-23c).",
1552
+ "description": "Full detail of the entry. REQUIRED -- a capture without it is rejected and persists nothing.",
1409
1553
  "minLength": 40
1410
1554
  },
1411
1555
  "source_files": {
1412
1556
  "type": "array",
1413
- "description": "Files that make this claim checkable. At least one is REQUIRED -- SqliteProvider.capture() rejects an entry with no basis, because the freshness sweep can never stale it.",
1557
+ "description": "Files that make this claim checkable. At least one is REQUIRED -- an entry with no basis is rejected, because the freshness sweep can never stale it.",
1414
1558
  "items": {
1415
1559
  "type": "string"
1416
1560
  },
@@ -1424,6 +1568,38 @@ const REVIEW_SCHEMA = {
1424
1568
  }
1425
1569
  }
1426
1570
  }
1571
+ },
1572
+ "toolUse": {
1573
+ "type": "object",
1574
+ "description": "How this run used the kb_* and code_* tools its role prompt expects (Step 0). Optional for backward compatibility, but expected: report \"unavailable\" or \"not_needed\" with a note rather than skipping the calls silently.",
1575
+ "required": [
1576
+ "kb",
1577
+ "code"
1578
+ ],
1579
+ "properties": {
1580
+ "kb": {
1581
+ "type": "string",
1582
+ "enum": [
1583
+ "used",
1584
+ "unavailable",
1585
+ "not_needed"
1586
+ ],
1587
+ "description": "used = kb_query was called (kb_session_prime alone is not used)."
1588
+ },
1589
+ "code": {
1590
+ "type": "string",
1591
+ "enum": [
1592
+ "used",
1593
+ "unavailable",
1594
+ "not_needed"
1595
+ ],
1596
+ "description": "used = code_impact, code_context or code_graph was called."
1597
+ },
1598
+ "note": {
1599
+ "type": "string",
1600
+ "description": "Why a value is not \"used\": which tool was missing or failed, or why no lookup was needed."
1601
+ }
1602
+ }
1427
1603
  }
1428
1604
  }
1429
1605
  };
@@ -1449,6 +1625,47 @@ const PLAN_REVIEW_SCHEMA = {
1449
1625
  "notes": {
1450
1626
  "type": "string"
1451
1627
  },
1628
+ "findings": {
1629
+ "type": "array",
1630
+ "description": "Machine-readable per-bead findings: one entry per bead that must change, so a caller can route a CHANGES_NEEDED verdict without parsing notes. Populate on every CHANGES_NEEDED verdict. Return an empty array when the objection is genuinely plan-wide and names no individual bead -- an empty array is the explicit 'plan-wide' signal. Omit or return an empty array on APPROVED. Optional, and deliberately absent-tolerant for one release: a verdict produced against the previous contract still validates, and a caller may fall back to reading notes. notes stays the narration channel.",
1631
+ "items": {
1632
+ "type": "object",
1633
+ "required": [
1634
+ "id",
1635
+ "kind",
1636
+ "detail"
1637
+ ],
1638
+ "properties": {
1639
+ "id": {
1640
+ "type": "string",
1641
+ "description": "The bead this finding concerns, written exactly as it appears in taskAssignments (e.g. BD-14)."
1642
+ },
1643
+ "kind": {
1644
+ "type": "string",
1645
+ "description": "Which quality criterion failed, as a closed vocabulary mirroring the numbered criteria in the prose contract's Step 2. Use other only when no listed kind fits, and explain it in detail.",
1646
+ "enum": [
1647
+ "coverage",
1648
+ "missing_test_task",
1649
+ "acceptance_criteria",
1650
+ "task_size",
1651
+ "dependency_wiring",
1652
+ "scope_creep",
1653
+ "duplicate_work",
1654
+ "feasibility",
1655
+ "ready_work",
1656
+ "model_metadata",
1657
+ "lane_cohesion",
1658
+ "other"
1659
+ ]
1660
+ },
1661
+ "detail": {
1662
+ "type": "string",
1663
+ "minLength": 1,
1664
+ "description": "The human explanation for this bead: what is wrong and what would make it pass."
1665
+ }
1666
+ }
1667
+ }
1668
+ },
1452
1669
  "taskAssignments": {
1453
1670
  "type": "array",
1454
1671
  "items": {
@@ -1556,6 +1773,38 @@ const DOER_STATUS_SCHEMA = {
1556
1773
  }
1557
1774
  }
1558
1775
  }
1776
+ },
1777
+ "toolUse": {
1778
+ "type": "object",
1779
+ "description": "How this run used the kb_* and code_* tools its role prompt expects (Step 0). Optional for backward compatibility, but expected: report \"unavailable\" or \"not_needed\" with a note rather than skipping the calls silently.",
1780
+ "required": [
1781
+ "kb",
1782
+ "code"
1783
+ ],
1784
+ "properties": {
1785
+ "kb": {
1786
+ "type": "string",
1787
+ "enum": [
1788
+ "used",
1789
+ "unavailable",
1790
+ "not_needed"
1791
+ ],
1792
+ "description": "used = kb_query was called (kb_session_prime alone is not used)."
1793
+ },
1794
+ "code": {
1795
+ "type": "string",
1796
+ "enum": [
1797
+ "used",
1798
+ "unavailable",
1799
+ "not_needed"
1800
+ ],
1801
+ "description": "used = code_impact, code_context or code_graph was called."
1802
+ },
1803
+ "note": {
1804
+ "type": "string",
1805
+ "description": "Why a value is not \"used\": which tool was missing or failed, or why no lookup was needed."
1806
+ }
1807
+ }
1559
1808
  }
1560
1809
  }
1561
1810
  };
@@ -1669,27 +1918,49 @@ const REGRESSION_RUN_SCHEMA = {
1669
1918
  "$schema": "http://json-schema.org/draft-07/schema#",
1670
1919
  "$id": "apra-pm/regression-test-runner-output@1",
1671
1920
  "title": "regression-test-runner output",
1672
- "description": "Canonical machine-readable output contract for the regression-test-runner role. See agents/regression-test-runner.md Step 4 for the prose contract this mirrors. This result is informational: it never gates the current sprint's PASS/FAIL verdict -- failures carry over to a future sprint as parent-less [regression][carry-over] beads.",
1921
+ "description": "Canonical machine-readable output contract for the regression-test-runner role. See agents/regression-test-runner.md Step 4 for the prose contract this mirrors. This result is informational: it never gates the current sprint's PASS/FAIL verdict -- failures carry over to a future sprint as parent-less [regression][carry-over] beads. The target repo's regression-test-playbook.md defines what the pass consists of; this contract does not assume any particular structure.",
1673
1922
  "type": "object",
1674
1923
  "required": [
1675
1924
  "passed",
1676
- "suitePassed",
1677
- "smokePassed",
1678
1925
  "bugsFiled",
1679
1926
  "summary"
1680
1927
  ],
1681
1928
  "properties": {
1682
1929
  "passed": {
1683
1930
  "type": "boolean",
1684
- "description": "True only if BOTH suitePassed and smokePassed are true AND no carry-over bug was filed this run."
1931
+ "description": "True only if every part of the pass the playbook defines passed AND no carry-over bug was filed this run."
1932
+ },
1933
+ "sections": {
1934
+ "type": "array",
1935
+ "items": {
1936
+ "type": "object",
1937
+ "required": [
1938
+ "name",
1939
+ "passed"
1940
+ ],
1941
+ "properties": {
1942
+ "name": {
1943
+ "type": "string",
1944
+ "description": "The part's name exactly as the playbook names it."
1945
+ },
1946
+ "passed": {
1947
+ "type": "boolean"
1948
+ },
1949
+ "detail": {
1950
+ "type": "string",
1951
+ "description": "Optional one-line result detail (counts, failing step)."
1952
+ }
1953
+ }
1954
+ },
1955
+ "description": "Per-part results, one entry per part the playbook defines (a playbook with a single part yields one entry). Omit only if the pass stopped before running any part."
1685
1956
  },
1686
1957
  "suitePassed": {
1687
1958
  "type": "boolean",
1688
- "description": "Result of playbook Part 1 -- the real-bd functional suite."
1959
+ "description": "Deprecated legacy field from the earlier two-part contract; still accepted, never required. Report per-part results in sections instead."
1689
1960
  },
1690
1961
  "smokePassed": {
1691
1962
  "type": "boolean",
1692
- "description": "Result of playbook Part 2 -- the sandbox smoke test."
1963
+ "description": "Deprecated legacy field from the earlier two-part contract; still accepted, never required. Report per-part results in sections instead."
1693
1964
  },
1694
1965
  "bugsFiled": {
1695
1966
  "type": "array",
@@ -1702,10 +1973,53 @@ const REGRESSION_RUN_SCHEMA = {
1702
1973
  "type": "string",
1703
1974
  "description": "One paragraph describing what was tested, what passed, what failed, and reiterating that the result is informational."
1704
1975
  },
1976
+ "verdict": {
1977
+ "type": "string",
1978
+ "enum": [
1979
+ "PASS",
1980
+ "FAIL",
1981
+ "INCONCLUSIVE"
1982
+ ],
1983
+ "description": "Optional. Present only when the playbook names a machine-written verdict file: copied from it verbatim, never authored by the runner. When present, passed must equal (verdict == \"PASS\"). INCONCLUSIVE means the pass could not prove anything either way; it is not a failure."
1984
+ },
1985
+ "testedSha": {
1986
+ "type": "string",
1987
+ "pattern": "^[0-9a-f]{40}$",
1988
+ "description": "Optional. The full commit sha the verdict file says was tested, copied verbatim from it."
1989
+ },
1990
+ "evidence": {
1991
+ "type": "object",
1992
+ "additionalProperties": true,
1993
+ "properties": {
1994
+ "verdictRef": {
1995
+ "type": "string",
1996
+ "description": "Where the verdict file lives (path or URL)."
1997
+ },
1998
+ "runUrl": {
1999
+ "type": "string",
2000
+ "description": "URL of the run that produced the verdict file."
2001
+ },
2002
+ "newFailures": {
2003
+ "type": "array",
2004
+ "items": {
2005
+ "type": "string"
2006
+ },
2007
+ "description": "New failure fingerprints, copied from the verdict file."
2008
+ },
2009
+ "inventoryMissing": {
2010
+ "type": "array",
2011
+ "items": {
2012
+ "type": "string"
2013
+ },
2014
+ "description": "Required coverage items the run did not cover, copied from the verdict file."
2015
+ }
2016
+ },
2017
+ "description": "Optional. Pointers to and key lists from the machine-written verdict file, copied verbatim from it."
2018
+ },
1705
2019
  "smokeEvidence": {
1706
2020
  "type": "object",
1707
2021
  "additionalProperties": true,
1708
- "description": "Optional structured evidence from Part 2 (the target repo's own smoke test), so the result is machine-checkable instead of self-reported prose. This schema does not define its shape -- the target repo's regression-test-playbook.md (Part 2 / smoke test section) does. Omit if that playbook defines no structured evidence."
2022
+ "description": "Optional structured evidence, so the result is machine-checkable instead of self-reported prose. This schema does not define its shape -- the target repo's regression-test-playbook.md does (the field name is kept for compatibility). Omit if that playbook defines no structured evidence."
1709
2023
  }
1710
2024
  }
1711
2025
  };
@@ -1845,7 +2159,7 @@ const PLANNER_SCHEMA = {
1845
2159
  },
1846
2160
  "kb_captures": {
1847
2161
  "type": "array",
1848
- "description": "Durable knowledge this role verified during its run. The engine makes the kb_capture calls; the role only decides. Optional -- omit or send [] to capture nothing.",
2162
+ "description": "IGNORED FOR THIS ROLE -- the planner has no apply path, so anything sent here is silently dropped rather than captured. Declared only for forward compatibility and shape-parity with the roles that do capture; always omit it or send []. Do not spend planning effort producing entries for it.",
1849
2163
  "items": {
1850
2164
  "type": "object",
1851
2165
  "required": [
@@ -2012,6 +2326,8 @@ const KB_PRIMER_SCHEMA = {
2012
2326
  title: { type: 'string' },
2013
2327
  summary: { type: 'string' },
2014
2328
  confidence: { type: 'string' },
2329
+ flagged_for_review: { type: 'boolean' },
2330
+ contradiction_of: { type: ['string', 'null'] },
2015
2331
  symbols: { type: 'array', items: { type: 'string' } },
2016
2332
  source_files: { type: 'array', items: { type: 'string' } },
2017
2333
  type: { type: 'string' },
@@ -2029,9 +2345,10 @@ async function primeKB(repoPath) {
2029
2345
  ` a. First check if "${repoPath}/.fleet/kb-canonical.json" exists (use Bash: test -f).\n` +
2030
2346
  ` b. If it does NOT exist, run: echo $APRA_FLEET_DATA_DIR (using Bash) to get the data dir.\n` +
2031
2347
  ` Then check if "$APRA_FLEET_DATA_DIR/kb-canonical.json" exists.\n` +
2032
- ` c. Call mcp__apra-fleet__kb_import with repo set to "${repoPath}".\n` +
2033
- ` If the bible was found at the data dir path (step b), also pass\n` +
2034
- ` path set to that full path (e.g. "/tmp/sprint-test/data-b/kb-canonical.json").\n` +
2348
+ ` c. Call mcp__apra-fleet__kb_import with path set to the full path of the bible\n` +
2349
+ ` file you found: "${repoPath}/.fleet/kb-canonical.json" (step a), or the\n` +
2350
+ ` data dir path (step b, e.g. "/tmp/sprint-test/data-b/kb-canonical.json").\n` +
2351
+ ` Pass no other scope argument -- kb tools always use your session's own KB.\n` +
2035
2352
  ` d. If neither path has the bible, or the tool is unavailable, set imported=false and continue.\n`;
2036
2353
  const stepNum = _kbImported ? 2 : 3;
2037
2354
  try {
@@ -2042,10 +2359,10 @@ async function primeKB(repoPath) {
2042
2359
  (_kbImported ? `"` : `,mcp__apra-fleet__kb_import"`) +
2043
2360
  ` to load the tool schema(s).\n` +
2044
2361
  importStep +
2045
- `Step ${stepNum}: Call mcp__apra-fleet__kb_session_prime with:\n` +
2046
- ` repo_path: "${repoPath}"\n` +
2362
+ `Step ${stepNum}: Call mcp__apra-fleet__kb_session_prime with no arguments ` +
2363
+ `(it always primes your session's own KB; it takes no repo/scope argument).\n` +
2047
2364
  `Step ${stepNum + 1}: Parse the JSON string result. Extract the top_entries array.\n` +
2048
- ` For each entry return: title, summary, confidence, symbols, source_files, type.\n` +
2365
+ ` For each entry return: title, summary, confidence, flagged_for_review, contradiction_of, symbols, source_files, type.\n` +
2049
2366
  ` Do NOT return the content field.\n` +
2050
2367
  ` Set sessionWarm from the result. Set imported to true if you ran kb_import successfully.\n\n` +
2051
2368
  `If ToolSearch returns no KB tools, return {entries:[], sessionWarm:false, imported:false}.\n` +
@@ -2161,6 +2478,13 @@ function vetKbWork(role, result) {
2161
2478
  }
2162
2479
  }
2163
2480
 
2481
+ // kb_discards is applied only by the fleet-sprint engine (maintainer-routed
2482
+ // kb_invalidate). This legacy workflow has no discard path, so refuse and log
2483
+ // rather than silently dropping a reviewer's DISCARD.
2484
+ if (result && Array.isArray(result.kb_discards) && result.kb_discards.length > 0) {
2485
+ rejected.push(`${role}: kb_discards refused -- not supported by this workflow (${result.kb_discards.length} dropped)`);
2486
+ }
2487
+
2164
2488
  return { captures, promotions, rejected };
2165
2489
  }
2166
2490
 
@@ -2186,10 +2510,11 @@ async function runKbWork(repoPath, role, result) {
2186
2510
  `Step 1: Call ToolSearch with query ` +
2187
2511
  `"select:mcp__apra-fleet__kb_capture,mcp__apra-fleet__kb_promote".\n` +
2188
2512
  `Step 2: For EACH object in captures below, call mcp__apra-fleet__kb_capture ` +
2189
- `with repo_path "${repoPath}" and that object's fields verbatim. Do not ` +
2190
- `reword, merge, split or invent entries.\n` +
2513
+ `with that object's fields verbatim (no repo/scope argument -- the tool ` +
2514
+ `always writes your session's own KB). Do not reword, merge, split or ` +
2515
+ `invent entries.\n` +
2191
2516
  `Step 3: For EACH object in promotions below, call mcp__apra-fleet__kb_promote ` +
2192
- `with repo_path "${repoPath}" and that object's id and reason verbatim.\n` +
2517
+ `with that object's id and reason verbatim.\n` +
2193
2518
  `Step 4: Return the counts. A call refused by the tool counts in failed, ` +
2194
2519
  `not captured/promoted -- report it, do not retry it with altered fields.\n\n` +
2195
2520
  `captures: ${JSON.stringify(captures)}\n` +
@@ -2211,15 +2536,30 @@ async function runKbWork(repoPath, role, result) {
2211
2536
 
2212
2537
  const KB_CHAR_BUDGET = 4000;
2213
2538
 
2539
+ // Only CONFIRMED entries outside any unresolved contradiction are injected --
2540
+ // the same rule as the fleet-sprint engine's KNOWLEDGE BANK block. INFERRED and
2541
+ // UNVERIFIED entries are unreviewed captures, and a flagged / contradiction_of
2542
+ // entry is one the KB itself marks as disputed. A missing tier is NOT treated as
2543
+ // CONFIRMED: the primer is an LLM relay, so an omitted field proves nothing.
2544
+ function isInjectableKbEntry(e) {
2545
+ return Boolean(e)
2546
+ && String(e.confidence || '').toUpperCase() === 'CONFIRMED'
2547
+ && !e.flagged_for_review
2548
+ && !e.contradiction_of;
2549
+ }
2550
+
2214
2551
  function buildKBContext(kbResult) {
2215
- if (!kbResult || !Array.isArray(kbResult.entries) || kbResult.entries.length === 0) {
2552
+ const entries = (kbResult && Array.isArray(kbResult.entries))
2553
+ ? kbResult.entries.filter(isInjectableKbEntry)
2554
+ : [];
2555
+ if (entries.length === 0) {
2216
2556
  return '';
2217
2557
  }
2218
- let block = `\n--- Project Knowledge Bank (${kbResult.entries.length} entries) ---\n` +
2219
- `Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts.\n\n`;
2558
+ let block = `\n--- Project Knowledge Bank (${entries.length} entries) ---\n` +
2559
+ `Only CONFIRMED entries are included. If one contradicts what you observe in the code now, the code wins.\n\n`;
2220
2560
  let len = block.length;
2221
- for (const e of kbResult.entries) {
2222
- const line = `- [${(e.confidence || 'CONFIRMED').toUpperCase()}] ${e.title}: ${e.summary}` +
2561
+ for (const e of entries) {
2562
+ const line = `- [CONFIRMED] ${e.title}: ${e.summary}` +
2223
2563
  (e.symbols && e.symbols.length ? ` (symbols: ${e.symbols.join(', ')})` : '') + '\n';
2224
2564
  if (len + line.length > KB_CHAR_BUDGET) break;
2225
2565
  block += line;
@@ -2982,14 +3322,18 @@ while (cycleCount < maxCycles) {
2982
3322
  `doer_tokens=${t.doerTokens} reviewer_tokens=${t.reviewerTokens} output_usd=${t.outputUsd.toFixed(4)}"`
2983
3323
  ),
2984
3324
  `bd export -o "${repo}/.beads/issues.jsonl"`,
2985
- `git -C "${repo}" add .beads/issues.jsonl`,
3325
+ buildExportShrinkGuardCmd(repo),
2986
3326
  `git -C "${repo}" -c user.name='pm' -c user.email='pm@pm.local' commit --allow-empty -m "plan: approve task DAG"`,
2987
3327
  `git -C "${repo}" push origin ${branch}`,
2988
3328
  ];
2989
- await dispatchShell(planCommitCmds, {
3329
+ const planCommitRes = await dispatchShell(planCommitCmds, {
2990
3330
  model: MODEL_HAIKU, label: `plan-commit-c${cycleCount}`, phase: 'Plan',
2991
3331
  maxTurns: planCommitCmds.length + 2,
2992
3332
  });
3333
+ // Surface an export-guard refusal/error in the sprint log (non-fatal).
3334
+ const planGuardLine = exportGuardLogLine(
3335
+ detectExportGuardIssue(planCommitRes?.outputs ?? planCommitRes), `plan-commit-c${cycleCount}`);
3336
+ if (planGuardLine) log(planGuardLine);
2993
3337
  } else {
2994
3338
  planFeedback = (planReview && planReview.notes) || '';
2995
3339
  log(`Plan needs changes: ${planFeedback.slice(0, 120)}`);
@@ -3599,7 +3943,7 @@ if (!approved(finalReview)) {
3599
3943
  // Placed deliberately AFTER the final-review verdict is decided (and after its early
3600
3944
  // return) and BEFORE harvest: the verdict is already computed, so a regression result
3601
3945
  // structurally CANNOT perturb the sprint's PASS/FAIL, and running it before harvest lets
3602
- // the harvester mention it in the CHANGELOG. This is the ONLY dispatch of this role in a
3946
+ // the harvester mention it in the sprint docs. This is the ONLY dispatch of this role in a
3603
3947
  // sprint -- the per-cycle Test phase does feature closure only.
3604
3948
  //
3605
3949
  // SOFT FAIL, ALWAYS: a null / failed / schema-invalid / thrown result is logged and
@@ -3615,12 +3959,10 @@ if (regressionTestEnabled) {
3615
3959
  `Repo: ${repo}\nBranch: ${branch}\nCycles completed: ${cycleCount}\n` +
3616
3960
  `Sprint goals: ${rootSummary}\n\n` +
3617
3961
  `Follow your runbook (agents/regression-test-runner.md) and regression-test-playbook.md.\n` +
3618
- `This is the ONCE-PER-SPRINT regression pass. Run BOTH parts:\n` +
3619
- ` Part 1: the full functional suite against the real bd CLI, at branch HEAD.\n` +
3620
- ` Part 2: the toy-sprint smoke test -- bring the sandbox up with the playbook's\n` +
3621
- ` ## Setup section, run its ## Test scenario, and ALWAYS run the playbook's\n` +
3622
- ` ## Teardown before returning, pass or fail.\n\n` +
3623
- `File EVERY failure from either part as a STANDALONE bead: "bd create" with NO\n` +
3962
+ `This is the ONCE-PER-SPRINT regression pass. Run every part the playbook defines,\n` +
3963
+ `in its order, at branch HEAD; if it defines a ## Teardown, ALWAYS run it before\n` +
3964
+ `returning, pass or fail.\n\n` +
3965
+ `File EVERY failure from any part as a STANDALONE bead: "bd create" with NO\n` +
3624
3966
  `--parent flag, and do NOT "bd dep add" it to sprint root ${rootIds[0]}, to any\n` +
3625
3967
  `feature, or to any other bead in this sprint. Title each one\n` +
3626
3968
  `"[regression][carry-over] <short description>". The parent-less shape is the point:\n` +
@@ -3630,9 +3972,9 @@ if (regressionTestEnabled) {
3630
3972
  `carry-over bug rather than filing a second one for the same failure.\n\n` +
3631
3973
  `This sprint's verdict is ALREADY DECIDED (final review: APPROVED). Your result is\n` +
3632
3974
  `INFORMATIONAL and does not gate it -- do not present it as a gate.\n\n` +
3633
- `Return the full contract: passed (boolean), suitePassed (boolean), smokePassed\n` +
3634
- `(boolean), bugsFiled (array of the parent-less carry-over bead ids, [] if none),\n` +
3635
- `summary (one paragraph).`,
3975
+ `Return the full contract: passed (boolean), sections (one {name, passed} per part\n` +
3976
+ `the playbook defines, named as the playbook names it), bugsFiled (array of the\n` +
3977
+ `parent-less carry-over bead ids, [] if none), summary (one paragraph).`,
3636
3978
  { model: MODEL_SONNET, label: 'regression-test-runner', phase: 'Harvest',
3637
3979
  schema: REGRESSION_RUN_SCHEMA, agentType: 'regression-test-runner' }
3638
3980
  );
@@ -3643,10 +3985,13 @@ if (regressionTestEnabled) {
3643
3985
  }
3644
3986
  if (regressionResult && typeof regressionResult.passed === 'boolean') {
3645
3987
  const _bugs = Array.isArray(regressionResult.bugsFiled) ? regressionResult.bugsFiled : [];
3646
- log(`Regression: suitePassed=${regressionResult.suitePassed}, smokePassed=${regressionResult.smokePassed}, passed=${regressionResult.passed}, carry-over bugs filed: ${_bugs.length}${_bugs.length ? ` [${_bugs.join(', ')}]` : ''}`);
3988
+ const _parts = Array.isArray(regressionResult.sections) && regressionResult.sections.length
3989
+ ? ` (${regressionResult.sections.map(s => `${s.name}: ${s.passed === true ? 'pass' : 'fail'}`).join(', ')})`
3990
+ : '';
3991
+ log(`Regression: passed=${regressionResult.passed}${_parts}, carry-over bugs filed: ${_bugs.length}${_bugs.length ? ` [${_bugs.join(', ')}]` : ''}`);
3647
3992
  log(`Regression summary: ${regressionResult.summary}`);
3648
3993
  regressionSummaryLine =
3649
- `passed=${regressionResult.passed} (suite=${regressionResult.suitePassed}, smoke=${regressionResult.smokePassed})` +
3994
+ `passed=${regressionResult.passed}${_parts}` +
3650
3995
  `${_bugs.length ? `; carry-over beads filed: ${_bugs.join(', ')}` : '; no carry-over beads filed'}`;
3651
3996
  } else {
3652
3997
  log('Regression pass returned no usable result -- ignored (informational only; the sprint is unaffected)');
@@ -3695,10 +4040,6 @@ const harvestResult = await dispatch(
3695
4040
  `to "${repo}/${analysisArtifactFile}" and commit it before doing anything else.\n\n` +
3696
4041
  `analysisText (write this verbatim to ${analysisArtifactFile}):\n` +
3697
4042
  sprintSummary.summaryText + `\n\n` +
3698
- `costAnalysis (insert this block verbatim into CHANGELOG.md after the summary paragraph):\n` +
3699
- `${sprintAnalysis.analysisText}\n` +
3700
- `Final review notes to include in CHANGELOG:\n` +
3701
- `${(finalReview && finalReview.notes) || '(none)'}\n\n` +
3702
4043
  `Regression pass (once-per-sprint, informational -- does not gate this sprint):\n` +
3703
4044
  `${regressionSummaryLine}\n\n` +
3704
4045
  `Return status "OK" if successful, "FAILED" with notes otherwise.`,
@@ -3734,11 +4075,6 @@ if (!harvestResult || harvestResult.status !== 'OK') {
3734
4075
  const updatedCalibration = computeUpdatedCalibration(calibration, sprintAnalysis, effectiveStartedAt, taskAssignments, logEntries);
3735
4076
  const calibrationJson = JSON.stringify(updatedCalibration, null, 2);
3736
4077
 
3737
- const tokenEstimates = {
3738
- averages: Object.values(updatedCalibration.historical?.tuple_averages || {})
3739
- };
3740
- const tokenEstimatesJson = JSON.stringify(tokenEstimates).replace(/"/g, '\\"');
3741
-
3742
4078
  await parallel([
3743
4079
  dispatch(
3744
4080
  `Write updated calibration file and commit.\n\n` +
@@ -3748,8 +4084,6 @@ await parallel([
3748
4084
  `Step 3: Commit the file:\n` +
3749
4085
  ` git -C "${repo}" add sprint-logs/calibration.json\n` +
3750
4086
  ` git -C "${repo}" commit -m "chore: update sprint calibration after ${cycleCount} cycle(s) on ${branch}"\n\n` +
3751
- `Step 4: Update token estimates memory:\n` +
3752
- ` bd remember "${tokenEstimatesJson}" --key token-estimates-json\n\n` +
3753
4087
  `If the file content is unchanged, the commit may be a no-op -- that is fine.\n` +
3754
4088
  `Return "OK" when done.`,
3755
4089
  { model: MODEL_HAIKU, label: 'calibration-update', phase: 'Harvest' }
@@ -3769,7 +4103,7 @@ await parallel([
3769
4103
  // Also remove sprint process files (requirements.md, feedback.md) from the PR net diff.
3770
4104
  // Step 1 stages any sprint-log entries written by fire-and-forget appendNewEntries
3771
4105
  // calls so the final cycle's JSONL lines are captured even when no later doer runs.
3772
- await dispatch(
4106
+ const exportCleanupRes = await dispatch(
3773
4107
  `Persist beads state and clean sprint scaffolding from the PR diff.\n\n` +
3774
4108
  `Step 1 -- Stage sprint-logs and evict scaffold files from the working tree (unconditional):\n` +
3775
4109
  ` git -C "${repo}" add sprint-logs/\n` +
@@ -3777,9 +4111,13 @@ await dispatch(
3777
4111
  ` rm -f "${repo}/feedback.md" "${repo}/requirements.md" 2>/dev/null || true\n\n` +
3778
4112
  `Step 2 -- Export beads state:\n` +
3779
4113
  ` bd export -o "${repo}/.beads/issues.jsonl"\n` +
3780
- ` git -C "${repo}" add .beads/issues.jsonl\n` +
4114
+ ` ${buildExportShrinkGuardCmd(repo)}\n` +
3781
4115
  ` git -C "${repo}" diff --cached --quiet || git -C "${repo}" -c user.name='pm' -c user.email='pm@pm.local' commit -m "chore: export beads state"\n` +
3782
- ` (The "diff --cached --quiet || commit" pattern only commits if something actually changed.)\n\n` +
4116
+ ` (The "diff --cached --quiet || commit" pattern only commits if something actually changed.\n` +
4117
+ ` The guard step above prints exactly one line starting with EXPORT_GUARD_OK,\n` +
4118
+ ` EXPORT_GUARD_REFUSED or EXPORT_GUARD_ERROR. On REFUSED/ERROR nothing is staged, so the\n` +
4119
+ ` commit is skipped; do not try to work around it -- continue with Step 3.\n` +
4120
+ ` You MUST copy that EXPORT_GUARD_* line verbatim into your final reply.)\n\n` +
3783
4121
  `Step 3 -- Check what process files are still in the PR diff:\n` +
3784
4122
  ` git -C "${repo}" diff --name-only ${base_branch}...${branch}\n\n` +
3785
4123
  `Step 4 -- For each of requirements.md, feedback.md that appears in the diff:\n` +
@@ -3796,9 +4134,12 @@ await dispatch(
3796
4134
  ` The output must NOT contain requirements.md or feedback.md. If it does, repeat Step 4.\n\n` +
3797
4135
  `Step 6 -- Push all local commits to remote:\n` +
3798
4136
  ` git -C "${repo}" push origin ${branch}\n\n` +
3799
- `Return "OK" when done.`,
4137
+ `Return "OK" when done, followed on its own line by the EXPORT_GUARD_* line from Step 2, verbatim.`,
3800
4138
  { model: MODEL_HAIKU, label: 'beads-export-cleanup', phase: 'Harvest' }
3801
4139
  );
4140
+ // Surface an export-guard refusal/error in the sprint log (non-fatal).
4141
+ const harvestGuardLine = exportGuardLogLine(detectExportGuardIssue(exportCleanupRes), 'beads-export-cleanup');
4142
+ if (harvestGuardLine) log(harvestGuardLine);
3802
4143
 
3803
4144
  // ------------------------------------------------------------------ DOLT PUSH
3804
4145
 
@@ -3834,7 +4175,7 @@ const harvestPr = await dispatch(
3834
4175
  ` - Cycles run: ${cycleCount}\n` +
3835
4176
  ` - Open items carried forward (if any): bd list --status=open and summarise\n` +
3836
4177
  ` - Final review notes: ${(finalReview && finalReview.notes) || '(none)'}\n` +
3837
- ` - Token cost summary from: bd recall token-estimates-json\n\n` +
4178
+ ` - Cost analysis (verbatim, in a fenced code block):\n${sprintAnalysis.analysisText}\n\n` +
3838
4179
  `After creating the PR, return its number as prNumber (integer).`,
3839
4180
  { model: MODEL_SONNET, label: 'harvest-pr', phase: 'Harvest',
3840
4181
  schema: { type: 'object', required: ['prNumber'], properties: { prNumber: { type: 'number' }, prUrl: { type: 'string' } } } }