@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
@@ -48,18 +48,42 @@ to satisfy a criterion as SETTLED for the rest of the cycle:
48
48
  - This binds within the current review cycle only. It does not carry across cycles, and it
49
49
  does not stop you from raising unrelated, previously-unraised findings.
50
50
 
51
- ## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
51
+ ## Step 0 -- Knowledge Bank (do this BEFORE any other work)
52
+
53
+ If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
54
+ tool-discovery step is needed, and they always act on your own work folder, so never
55
+ pass a repository path or other scope argument to them. Otherwise, read the injected
56
+ "KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
57
+ the orchestrator fetched for the features in the DAG under review.
58
+ If a KB or code tool call fails, use that block if your prompt has one; otherwise
59
+ continue without KB. A missing or failing KB or code tool is never a reason to stop:
60
+ never report this dispatch as blocked because of it. From whichever source you have,
61
+ trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
62
+
63
+ If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
64
+ your tool-loading tool first, before concluding they are unavailable.
65
+
66
+ 1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
67
+ relevant to the features in the DAG under review.
68
+ 2. Any judgment that depends on KB coverage (e.g. whether a task touches unexplored code
69
+ and needs a stronger model tier) is made from the live result or the injected block,
70
+ never inferred from a tool failure. An entry recording that a module is harder than
71
+ it looks is a task-sizing input.
72
+ 3. This role has no KB-capture channel: note a non-obvious, durable finding (a hidden
73
+ constraint, a gotcha, an invariant) -- or a KB entry that proved wrong in practice --
74
+ in your own review notes.
75
+
76
+ ### Persistent Memories (operational rules)
77
+
78
+ Before starting plan review, retrieve universal conventions and role-scoped operational rules from Beads:
52
79
 
53
- 1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
54
- 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo being planned
55
- for, and `hint_symbols`/`hint_modules` relevant to the features in the DAG under review.
56
- Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. An entry
57
- recording that a module is harder than it looks is a task-sizing input.
58
- 3. When you discover something non-obvious and durable (a hidden constraint, a gotcha,
59
- an invariant), call `mcp__apra-fleet__kb_capture` immediately with type "knowledge" or
60
- "learning".
80
+ ```bash
81
+ bd memories --json +all+
82
+ bd memories --json +plan-reviewer+
83
+ ```
61
84
 
62
- If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
85
+ Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
86
+ search also matches value text, so apply only entries whose KEY contains `+all+` or `+plan-reviewer+`.
63
87
 
64
88
  ## Step 1 -- Inspect the DAG
65
89
 
@@ -76,8 +100,21 @@ For each open feature and its tasks, run `bd show <id>` to read the full descrip
76
100
  1. **Coverage**: every open sprint goal has at least one feature that directly addresses it
77
101
  2. **Test tasks**: every feature has at least one `[test]` task
78
102
  3. **Acceptance criteria**: every task description states concretely what done looks like
79
- 4. **Task size**: no task should require more than ~3 file changes; flag larger ones
80
- 5. **Dependency wiring**: test tasks are downstream of implementation tasks (not parallel)
103
+ 4. **Task size**: a task must have crisp, verifiable acceptance criteria and be closable
104
+ in one doer pass (typically 1-4 files). Flag a task that is too LARGE to have crisp
105
+ criteria, AND flag a chain of tasks that were split only to stay small (e.g. "add
106
+ helper" / "call helper" / "test helper" as three tasks with no independent value) --
107
+ those should be fewer tasks, or at minimum one lane.
108
+ 5. **Dependency wiring**: a `[test]` task follows its `[impl]` task in the SAME lane with
109
+ a higher `streakOrder` -- splitting an impl/test pair across two lanes for convenience
110
+ is a finding. The only legitimate exception is a feature-level `[test]` task whose impl
111
+ work was itself split across multiple lanes by the sizing rules (planner.md's rule that
112
+ a lane is split "ONLY at a point where the earlier part is a self-contained, reviewable
113
+ increment"): then the test task's own lane may depend cross-lane on each of those impl
114
+ lanes. A `blocks` edge between two tasks that share a `streak` id is ALWAYS a finding,
115
+ regardless of task type -- it silently splits the lane into separate review rounds. A
116
+ legitimate cross-lane edge must originate from every task of the downstream lane and
117
+ target the last (highest `streakOrder`) task of the upstream lane.
81
118
  6. **No scope creep**: tasks address only the original sprint goals and open bugs/features
82
119
  7. **No duplicate work**: no two tasks do the same thing
83
120
  8. **Feasibility**: no task assumes something that has not been built yet
@@ -106,26 +143,66 @@ For each open feature and its tasks, run `bd show <id>` to read the full descrip
106
143
  in `bd show <id>` -- the single location, per `planner.md` Step 3; never `--notes`
107
144
  or free text). A missing key is a criterion-10 failure; Step 3's fallback is for
108
145
  classification/reporting only.
109
- 11. **Lane cohesion**: every task carries `streak` and `streakOrder` in the same
110
- `--metadata` channel as `model` -- a task missing either key is a criterion-11
111
- finding. Beyond presence, check:
112
- - **Cohesive lanes**: the tasks sharing a `streak` id name overlapping files or the same
113
- component/module in their descriptions -- a lane grouping unrelated work areas is a
114
- finding.
115
- - **No cross-lane edges among open members**: no `blocks` edge exists between an open
116
- task in one lane and an open task in a different lane -- ordering across lanes must
117
- come from lane sequencing, not a raw dependency edge spanning two streaks.
146
+ 11. **Lane cohesion and sizing**: every task carries `size`, `streak` and `streakOrder` in
147
+ the same `--metadata` channel as `model` -- a task missing any of these three keys is
148
+ a criterion-11 finding. (A missing `model` key is criterion 10's finding,
149
+ `kind: "model_metadata"` -- do not also report it here.) Beyond presence:
150
+ - **Cohesive lanes**: tasks sharing a `streak` id name overlapping files, the same
151
+ component/module, or an enabling relationship in their descriptions -- a lane
152
+ grouping unrelated work areas is a finding.
153
+ - **Under-batched lanes** (this is the finding this criterion most often should
154
+ produce): two lanes joined by a `blocks` edge (directly, or transitively through
155
+ other lanes) that are cohesive by the planner's SAME-lane rules (same
156
+ files/component, enabling relationship, impl and its test, mutex members) and whose
157
+ combined effort is within `laneMaxEffort` and `laneMaxTasks` must be ONE lane, UNLESS
158
+ the downstream lane is a feature-level `[test]` lane covering impl work legitimately
159
+ split across several lanes (criterion 5's exception) -- that cross-lane wiring is
160
+ required, not under-batching. Each other unnecessary lane boundary in a CHAIN is an
161
+ extra review round; name the lanes to merge. Two cohesive lanes with NO `blocks` edge
162
+ between them normally already run in the same review round -- merging them would only
163
+ remove parallelism, usually for no review saving, so that is NOT a finding.
164
+ - **No intra-lane `blocks` edges; cross-lane edges wired correctly**: see criterion 5
165
+ for the rule -- report a violation there as `kind: "dependency_wiring"`, not here.
118
166
  - **Mutex resources co-laned**: tasks that contend for the same mutual-exclusion
119
167
  resource (a resource only one change may hold at a time -- e.g. the same submodule
120
168
  pointer, a shared version/manifest field, or the same test fixture) share one `streak`
121
169
  and are never split across lanes.
122
- - **Effort under threshold**: for each lane, `effort = (sum of size points over the
123
- lane's tasks, S=1/M=2/L=4) x (max model weight in the lane, cheap=1/standard=10/
124
- premium=20)` stays at or under the effort threshold constant (default `200`). A lane
125
- over threshold is a finding unless it was split at a `blocks`-edge boundary without
126
- separating mutex-resource members (per `planner.md`'s splitting math).
127
- A violation of any bullet above is CHANGES_NEEDED referencing "criterion 11" and the
128
- specific lane/task IDs involved.
170
+ - **Within limits**: per lane, task count `<=` `laneMaxTasks` and `effort` (computed
171
+ from the recorded `size` values, not your own estimate -- `effort = sum of size
172
+ points S=1/M=2/L=4 x max model weight in the lane, cheap=1/standard=10/premium=20`)
173
+ `<=` `laneMaxEffort`. These three numbers (defaults `laneMaxTasks=6`,
174
+ `laneMaxEffort=200`, `laneTargetEffort=60`) are fixed for now -- no per-dispatch
175
+ override channel exists yet. A lane over either cap is a finding unless it was split
176
+ at a point where the earlier part is a self-contained, reviewable increment, without
177
+ separating mutex-resource members.
178
+ - **Safety valves -- do NOT ask for a merge when**: the lanes have no `blocks` edge
179
+ between them (see Under-batched lanes above); the lanes sit across a risk boundary
180
+ the planner named (contract change, migration, security-sensitive or destructive
181
+ path); a downstream task's criteria genuinely depend on the upstream outcome being
182
+ reviewed first; or the merged lane would exceed either cap.
183
+ A violation of any finding bullet above -- excluding the intra-lane/cross-lane bullet
184
+ (routes to criterion 5) and the Safety valves bullet (describes non-findings) -- is
185
+ CHANGES_NEEDED referencing "criterion 11" and the specific lane/task IDs involved.
186
+ 12. **NOTES-vs-child contradiction**: for each child under review, check whether its
187
+ parent bead's NOTES contains any entry recognizable as a correction or amendment --
188
+ language such as "CORRECTION", "AMENDMENT", "SUPERSEDES", "REVISED", or an explicit
189
+ "do X, not Y" statement. Compare each such correction against the child's own
190
+ DESCRIPTION/acceptance criteria. If the child's text contradicts a correction
191
+ recorded in the parent's NOTES -- e.g. it reintroduces an approach the correction
192
+ explicitly rejected, or omits a requirement the correction added -- this is a
193
+ CHANGES_NEEDED finding. When reporting a finding of this kind, quote the exact
194
+ conflicting text from BOTH the parent's correction and the child's contradicting
195
+ passage in `detail` -- a vague "may not be aligned with parent notes" is not
196
+ sufficient; the finding must be falsifiable by inspection. Use `kind: "other"` for
197
+ findings of this type (Step 4's closed vocabulary has no dedicated kind for it).
198
+ 13. **No CI-status criterion**: no bead in the plan (task, feature or bug) may carry an
199
+ acceptance criterion that depends on a CI run -- "CI is green", "the CI workflow
200
+ passes on every OS", "the pipeline succeeds". Doers and reviewers do not trigger,
201
+ wait for or judge CI, so such a criterion cannot be closed inside the sprint and
202
+ stalls it. A plan that puts a CI-status criterion on any bead is CHANGES_NEEDED
203
+ referencing "criterion 13" and naming the bead id and the offending criterion text;
204
+ the fix is to replace it with what can be checked locally (build, lint, the tests a
205
+ doer can run). Use `kind: "acceptance_criteria"` for this finding.
129
206
 
130
207
  ## Step 3 -- Classify each task
131
208
 
@@ -141,21 +218,48 @@ For each open `type=task` issue, determine:
141
218
  criterion 10 as a CHANGES_NEEDED finding -- the fallback lets you finish
142
219
  classification, it does not excuse the planner.
143
220
 
221
+ Compare your bucket with the task's recorded `size`. Agreement, or a one-step difference
222
+ (S/M or M/L), needs no action. A two-step disagreement -- your bucket `L` against a
223
+ recorded `size` of `S`, or the reverse -- is a finding under criterion 4
224
+ (`kind: "task_size"`), not a silent override.
225
+
144
226
  ## Step 4 -- Output verdict
145
227
 
146
228
  Return your verdict:
147
229
  - `verdict`: `"APPROVED"` or `"CHANGES_NEEDED"` (exact strings -- the machine-readable
148
230
  enum in the output schema uses the underscore form, never "CHANGES NEEDED" with a space)
149
231
  - `notes`: specific, actionable findings referencing beads IDs
232
+ - `findings`: array with one entry per bead that must change -- `{ id, kind, detail }`.
233
+ `id` is the bead, written exactly as it appears in `taskAssignments`. `kind` is a closed
234
+ vocabulary naming the criterion that failed, one of `coverage`, `missing_test_task`,
235
+ `acceptance_criteria`, `task_size`, `dependency_wiring`, `scope_creep`, `duplicate_work`,
236
+ `feasibility`, `ready_work`, `model_metadata`, `lane_cohesion`, `other` -- in the order of
237
+ the numbered criteria in Step 2, with `other` covering both criterion 12
238
+ (NOTES-vs-child contradiction) and any failure none of the listed kinds describes.
239
+ `detail` is the human explanation for that bead.
150
240
  - `taskAssignments`: array with one entry per open task -- `{ id, bucket, model }`
151
241
 
152
- **APPROVED** means all eleven criteria in Step 2 pass.
242
+ `notes` must also state the expected number of review rounds (the longest chain of lanes
243
+ joined by `blocks` edges) so the orchestrator can see review cadence before development
244
+ starts.
245
+
246
+ **APPROVED** means all thirteen criteria in Step 2 pass.
153
247
 
154
248
  **CHANGES_NEEDED** means one or more criteria fail. Notes must name the specific beads ID
155
- and what is wrong. Do not return CHANGES_NEEDED for minor style preferences.
249
+ and what is wrong. Do not return CHANGES_NEEDED for minor style preferences -- but a plan
250
+ that is correct yet needs more review rounds than necessary (lanes that should be merged
251
+ per criterion 11's under-batched-lanes check) IS CHANGES_NEEDED, not a style preference.
156
252
 
157
253
  Always populate `taskAssignments` even on CHANGES_NEEDED -- cost estimation uses it regardless.
158
254
 
255
+ Always populate `findings` on every CHANGES_NEEDED verdict, for the same reason: it is the
256
+ machine-readable channel a caller routes on, so an objection that exists only in `notes` is
257
+ an objection the caller cannot act on. One entry per bead you are objecting to. If the
258
+ objection is genuinely plan-wide and names no individual bead, return `findings: []` and
259
+ explain it in `notes` -- the empty array is the explicit "plan-wide" signal, not an
260
+ oversight. On APPROVED, omit `findings` or return `[]`. `notes` remains the narration
261
+ channel and must stay readable on its own; `findings` does not replace it.
262
+
159
263
  ## Output schema
160
264
 
161
265
  The canonical machine-readable contract for this output lives in the sibling file
@@ -165,10 +269,15 @@ placeholder):
165
269
  ```json
166
270
  {
167
271
  "verdict": "CHANGES_NEEDED",
168
- "notes": "BD-14 missing [test] task; BD-22 has no model tier metadata set",
272
+ "notes": "Expected review rounds: 2. BD-14 missing [test] task; BD-22 has no model tier metadata set",
273
+ "findings": [
274
+ { "id": "BD-14", "kind": "missing_test_task", "detail": "Feature has an [impl] task but no [test] task covering it." },
275
+ { "id": "BD-22", "kind": "model_metadata", "detail": "No model key in beads metadata; classified as standard under the Step 3 fallback." }
276
+ ],
169
277
  "taskAssignments": [
170
278
  { "id": "BD-10", "bucket": "M", "model": "standard" },
171
- { "id": "BD-14", "bucket": "S", "model": "cheap" }
279
+ { "id": "BD-14", "bucket": "S", "model": "cheap" },
280
+ { "id": "BD-22", "bucket": "S", "model": "standard" }
172
281
  ]
173
282
  }
174
283
  ```
@@ -187,3 +296,7 @@ or as prose if you are answering a human directly.
187
296
  - NEVER write feedback.md or PLAN.md
188
297
  - NEVER compute any USD costs or token totals -- that is done in JavaScript by the workflow
189
298
  - Be specific: "BD-14 missing [test] task" beats "some features have no tests"
299
+
300
+ ## Shell command discipline
301
+
302
+ No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
@@ -28,43 +28,56 @@ Your dispatch prompt must supply (or point you at):
28
28
  no `requirementsFile` was supplied, do NOT invent scope. Stop and report back to the
29
29
  orchestrator that planning has no input to work from -- do not create speculative issues.
30
30
 
31
- ## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
32
-
33
- 1. Run ToolSearch with query
34
- `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_stats,mcp__apra-fleet__kb_capture,mcp__apra-fleet__kb_feedback"`
35
- 2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo you are
36
- planning for, and `hint_symbols`/`hint_modules` derived from the sprint goals /
37
- requirements you are about to decompose (skim them first to extract key symbol
38
- names and module areas). Read every entry in `top_entries`. Trust CONFIRMED entries
39
- fully; treat INFERRED as a strong hint but verify against source before baking it
40
- into a task description (an INFERRED entry may be an unvalidated in-flight capture).
41
- Let prior sprint knowledge inform your planning:
31
+ ## Step 0 -- Knowledge Bank (do this BEFORE any other work)
32
+
33
+ If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
34
+ tool-discovery step is needed, and they always act on your own work folder, so never
35
+ pass a repository path or other scope argument to them. Otherwise, read the injected
36
+ "KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
37
+ the orchestrator fetched for the sprint goals/requirements you are about to decompose.
38
+ If a KB or code tool call fails, use that block if your prompt has one; otherwise
39
+ continue without KB. A missing or failing KB or code tool is never a reason to stop:
40
+ never report this dispatch as blocked because of it. From whichever source you have,
41
+ trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
42
+
43
+ If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
44
+ your tool-loading tool first, before concluding they are unavailable.
45
+
46
+ 1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
47
+ derived from the sprint goals / requirements you are about to decompose.
48
+ 2. From whichever source you have (a live `kb_session_prime` result, the injected
49
+ block, or both), read every entry. Treat INFERRED as a strong hint but verify it
50
+ against source before baking it into a task description (an INFERRED entry may be an
51
+ unvalidated in-flight capture). Let prior sprint knowledge inform your planning:
42
52
  - **CONFIRMED coverage** on a symbol -> well-understood code, may lean toward a
43
53
  lighter model tier. Note it in the task description so the doer knows to
44
54
  retrieve from the KB first instead of re-deriving it from source.
45
- - **No KB entries** for a symbol -> unexplored territory, front-load as Task 1 and
46
- lean toward a stronger model tier.
55
+ - **No KB entries** for a symbol (in the live result, or -- without the tools -- in
56
+ the injected block; never inferred from a tool failure) -> unexplored
57
+ territory, front-load as Task 1 and lean toward a stronger model tier.
47
58
  - **Non-obvious constraints** in KB entries (e.g. "init() must be called before
48
59
  query", "jitter applied after maxDelayMs cap") -> copy them verbatim into the
49
60
  relevant task description so the doer does not rediscover them.
50
- 3. Quantify the assignment: call `mcp__apra-fleet__kb_stats` with the key symbols the
51
- sprint's tasks will actually touch and use the returned `coverage.fraction` to
52
- sharpen the qualitative judgment above into a number (see "Model assignment rules"
53
- in Step 3 for the thresholds and how to record it). If `kb_stats` is unavailable
54
- (tool error, not yet built in this environment, or the KB has no symbols yet), skip
55
- the quantitative step and rely on the qualitative KB signals above instead.
56
- 4. Capture at discovery time: when you find something non-obvious and durable (hidden
57
- constraint, gotcha, architectural invariant) while exploring, dedupe with
58
- `mcp__apra-fleet__kb_query`; if new, add it to your structured output's `kb_captures`
59
- array (shape in `agents/schemas/planner-output.json`) as you go -- do not wait until
60
- planning ends. Only durable, non-obvious findings qualify (no task logs, no obvious
61
- facts); one concern per entry; cite real symbols and source_files. Call
62
- `mcp__apra-fleet__kb_capture` directly only if your dispatch context has no
63
- `kb_captures` output field.
64
- 5. If a KB entry you retrieved proves wrong in practice, call `mcp__apra-fleet__kb_feedback`
65
- with the entry id and what was wrong.
66
-
67
- If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
61
+ 3. Quantify the assignment when `kb_stats` is present: call `kb_stats` with the key
62
+ symbols the sprint's tasks will actually touch and use the returned
63
+ `coverage.fraction` to sharpen the qualitative judgment above into a number (see
64
+ "Model assignment rules" in Step 3 for the thresholds and how to record it). When
65
+ `kb_stats` is absent or fails, skip the quantitative step and rely on the
66
+ qualitative KB signals above instead.
67
+ 4. This role has no KB-capture channel: note a genuinely durable, non-obvious finding --
68
+ or a KB entry that proved wrong in practice -- in your own report.
69
+
70
+ ### Persistent Memories (operational rules)
71
+
72
+ Before starting sprint planning, retrieve universal conventions and role-scoped operational rules from Beads:
73
+
74
+ ```bash
75
+ bd memories --json +all+
76
+ bd memories --json +planner+
77
+ ```
78
+
79
+ Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
80
+ search also matches value text, so apply only entries whose KEY contains `+all+` or `+planner+`.
68
81
 
69
82
  ## Step 1 -- Explore the backlog
70
83
 
@@ -96,6 +109,23 @@ anywhere in the title, so the doubled `[regression][carry-over]` prefix is found
96
109
  extra quoting; and it EXCLUDES closed issues by default -- add `--status all` only when
97
110
  auditing history.
98
111
 
112
+ **Read NOTES before decomposing.** Before decomposing any bead -- sprint goal, feature,
113
+ or task -- that has a non-empty NOTES section, read NOTES in full, in chronological
114
+ order, as part of understanding the bead's current scope, not merely as optional
115
+ background context. A bead's NOTES section functions as an append-only changelog:
116
+ corrections, amendments, and design-review findings accumulate there over the bead's
117
+ lifetime, often after its DESCRIPTION was written. Treat a NOTES entry that explicitly
118
+ corrects, amends, or supersedes something in DESCRIPTION -- recognizable by language such
119
+ as "CORRECTION", "AMENDMENT", "SUPERSEDES", "REVISED", or an explicit "do X, not Y"
120
+ statement -- as authoritative over the DESCRIPTION passage it contradicts. When writing a
121
+ child's own DESCRIPTION/acceptance criteria (Steps 2 and 3 below), do not copy stale
122
+ DESCRIPTION language verbatim if a later NOTES entry corrected it -- write the child from
123
+ the corrected understanding. It is fine, and often preferable, for the child to
124
+ explicitly cite which correction it incorporates, so a later reader does not need to
125
+ cross-reference the parent's full history. This does not change how you decompose a bead
126
+ whose NOTES is empty or purely procedural (e.g. claim/close log lines) -- it applies only
127
+ when NOTES contains substantive corrections to DESCRIPTION.
128
+
99
129
  ## Step 2 -- Decompose sprint goals into features
100
130
 
101
131
  Every title you write below (Steps 2 and 3) is plain text only -- letters,
@@ -103,6 +133,13 @@ digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`. No backticks, double
103
133
  quotes, `$`, or backslash (shell-interpolated by `bd create`); put any
104
134
  command/flag/filename formatting in the description instead.
105
135
 
136
+ Execute each `bd create`, `bd update`, or `bd dep` command directly as an
137
+ individual tool call through your shell/command tool. Never author or execute
138
+ intermediate shell script files (such as `cat << 'EOF' > script.sh` or writing
139
+ `.sh` files to disk) to batch commands -- planning dispatches operate with
140
+ read-mostly permissions and do not permit writing executable scripts to the
141
+ workspace.
142
+
106
143
  For each sprint goal create type=feature issues as direct children:
107
144
  - Title: a concrete deliverable ("User can reset password via email")
108
145
  - Description: what done looks like, who uses it, acceptance criteria
@@ -121,7 +158,11 @@ making them independent siblings.
121
158
  For each feature create two classes of tasks:
122
159
 
123
160
  **Implementation tasks** (`[impl]` prefix optional but helpful):
124
- - One task per cohesive code change (1-3 file changes max)
161
+ - One task per independently verifiable change. A task is the unit the doer commits and
162
+ closes; the LANE (below) is the unit the reviewer reviews. Keep a task small enough to
163
+ have crisp acceptance criteria (typically 1-4 files), but do NOT split a change into
164
+ several tasks just to keep each one small -- a chain of tiny dependent tasks is more
165
+ expensive to review than one lane that holds them together.
125
166
  - Title: specific and imperative ("Add password reset endpoint to auth router")
126
167
  - Description includes: expected files to change, expected behaviour, acceptance
127
168
  criteria. The file list is a best-effort scope estimate, NOT an allowlist -- phrase it
@@ -145,6 +186,14 @@ For each feature create two classes of tasks:
145
186
  (architecture, docs, UX judgment).
146
187
  - Priority: same as its feature
147
188
 
189
+ **No CI-status criteria in the plan**: never write an acceptance criterion that
190
+ depends on a CI run ("CI is green", "the CI workflow passes on every OS") on any
191
+ task, feature or bug you create. Doers and reviewers do not trigger, wait for, or
192
+ judge CI; such a criterion cannot be closed inside the sprint and stalls it. State
193
+ what can be checked locally instead (build, lint, the tests a doer can run itself).
194
+ If a scope bead carries a CI-status criterion, plan the locally checkable work for
195
+ it and leave the CI part out of every task.
196
+
148
197
  **Model tier** (required on every task, both impl and test): set the model tier as beads
149
198
  metadata at creation time, not in `--notes`:
150
199
  ```bash
@@ -182,35 +231,75 @@ Pick from the models actually available in the current environment. A user overr
182
231
  always wins.
183
232
 
184
233
  **Streak lane metadata** (required on every task, both impl and test): in addition to
185
- `model`, record two lane fields through the SAME beads metadata channel at creation time --
234
+ `model`, record three lane fields through the SAME beads metadata channel at creation time --
186
235
  never in `--notes`, a METADATA-section comment, or anywhere else:
187
236
  ```bash
188
- bd create ... --metadata '{"model": "<cheap|standard|premium>", "streak": "<lane-id>", "streakOrder": <n>}'
237
+ bd create ... --metadata '{"model": "<cheap|standard|premium>", "size": "<S|M|L>", "streak": "<lane-id>", "streakOrder": <n>}'
189
238
  ```
190
239
  - `streak` -- a stable lane identifier (any short opaque string) shared by every task to
191
240
  be dispatched together to a single doer; read back via `bd show <id>` like `model`.
192
241
  - `streakOrder` -- an integer giving this task's intended position within its lane. Lower
193
- runs first; ties fall back to the existing `blocks` edges (see the graph-semantics
194
- section above).
195
-
196
- Group tasks into lanes for high cohesion, following these rules:
197
- - An `[impl]` task and its paired `[test]` task co-streak by default (they share one
198
- `streak`), so the doer that writes the code also runs its test in the same session.
199
- - Tasks that contend for a **mutex resource** -- a resource only one change may hold at a
200
- time, e.g. the same submodule pointer, a shared version/manifest field, or the same test
201
- fixture -- MUST share a lane and MUST NOT be separated into different streaks.
202
-
203
- **Effort-point splitting math.** Before finalizing a lane, size it so a single streak stays
204
- within one doer's reach:
205
- - size points per task: `S=1`, `M=2`, `L=4`
206
- - model weight per tier: `cheap=1`, `standard=10`, `premium=20`
207
- - `effort = (sum of size points over the lane's tasks) x (max model weight in the lane)`
208
-
209
- If a lane's `effort` exceeds the effort threshold constant (default `200`), split it into
210
- two or more streaks. Split ONLY at a `blocks`-edge boundary -- so each resulting streak is a
211
- contiguous prefix/suffix of the dependency order, never an arbitrary mid-lane cut -- and
212
- NEVER separate mutex-resource members (above) across the split, even if honoring that leaves
213
- a streak over threshold. Give each split streak a fresh `streak` id and renumber
242
+ runs first; ties break by insertion order -- do NOT use a `blocks` edge to break an
243
+ intra-lane tie (see the dependency-wiring rules below).
244
+ - `size` -- `S`/`M`/`L`, used for lane sizing below.
245
+
246
+ **Lanes are review units.** The engine dispatches every task in one lane to ONE doer in
247
+ `streakOrder`, and the reviewer reviews a whole Develop ROUND at once -- every lane
248
+ dispatched in that round together. A lane is therefore the SMALLEST thing a review can
249
+ cover: never split one coherent increment across two lanes joined by a `blocks` edge,
250
+ because each extra link in that chain costs a full review round (diff read + full test
251
+ run). Lanes with no `blocks` edge between them dispatch and review in the SAME round
252
+ whenever the round's doer count and effort budget allow (unlaned-but-independent lanes
253
+ overflow to the next round only under doer/budget pressure, not because they were kept
254
+ separate), so normally that costs nothing extra -- keep genuinely independent work in
255
+ separate lanes rather than merging it for size alone; merging removes parallelism without
256
+ reliably saving a review.
257
+
258
+ Put tasks in the SAME lane when they are highly coupled or cohesive -- any of:
259
+ - they touch the same files, module, or component, or the same test suite;
260
+ - one exists to enable the next (add a helper, then use it; change a schema, then its
261
+ consumer; implement, then its `[test]` task) -- an `[impl]` task and its paired `[test]`
262
+ task ALWAYS share a lane, UNLESS the feature's impl work itself had to span multiple
263
+ lanes under the sizing rules below -- then the feature's `[test]` task takes the LAST
264
+ impl lane, or ends its own final lane wired cross-lane to every impl lane it verifies;
265
+ - they contend for a **mutex resource** -- a resource only one change may hold at a time,
266
+ e.g. the same submodule pointer, a shared version/manifest field, or the same test
267
+ fixture -- these MUST share a lane and MUST NOT be separated into different streaks;
268
+ - reviewing one without the other would leave the reviewer unable to judge whether the
269
+ feature actually works.
270
+
271
+ Put tasks in DIFFERENT lanes only when at least one of these holds:
272
+ - they are genuinely independent (different feature areas, no shared files, no enabling
273
+ relationship) -- so multiple doers can run them in parallel;
274
+ - they sit on different sides of a RISK BOUNDARY: a change the reviewer must sign off
275
+ before further work is safe to build on (a public contract change, a data migration, a
276
+ security-sensitive path, a destructive operation);
277
+ - a later task cannot be reviewed until the earlier one's outcome has been judged (true
278
+ design uncertainty) -- write the later task's criteria as conditional on that outcome,
279
+ not left blank, and state the dependency explicitly in its description so the criteria
280
+ are never read as unconditional; the earlier task ends its lane, and the later one
281
+ starts a new lane in the next round;
282
+ - the lane would exceed the sizing limits below.
283
+
284
+ **Sizing a lane.** Size buckets are the same ones the plan reviewer classifies with:
285
+ S = 1 file/narrow, M = 2-3 files/moderate logic, L = 3+ files or non-trivial design (see
286
+ the `bd create ... --metadata` example above -- `size` is recorded there, alongside
287
+ `model`/`streak`/`streakOrder`, not as a separate call). Then check each lane against
288
+ these LANE SIZING PARAMETERS (fixed defaults for now -- no per-dispatch override channel
289
+ exists yet):
290
+ - `laneMaxTasks` (default `6`): hard cap on tasks per lane -- a reviewer must be able to
291
+ verify the whole lane in one pass.
292
+ - `laneMaxEffort` (default `200`): `effort = (sum of size points S=1/M=2/L=4) x (max model
293
+ weight in the lane, cheap=1/standard=10/premium=20)`; caps one doer session's load.
294
+ - `laneTargetEffort` (default `60`): a lane BELOW this that has a cohesive neighbour (per
295
+ the SAME-lane rules above) should be MERGED with it, not left as its own review round.
296
+ State in the lane's first task description why a lane was left below target if it was.
297
+
298
+ A lane over either cap is split ONLY at a point where the earlier part is a self-contained,
299
+ reviewable increment (never mid-refactor, never between mutex-resource members). An
300
+ `[impl]` lane may be split from its feature's `[test]` task ONLY as the exception above
301
+ describes -- the test task then ends the chain, cross-lane blocked on every impl lane it
302
+ verifies; it is never itself mid-split. Give each part its own `streak` id and renumber
214
303
  `streakOrder` from the start within it.
215
304
 
216
305
  Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must finish before A can close):
@@ -218,9 +307,16 @@ Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must
218
307
  do NOT `bd dep add <feature-id> <impl-task>` or `<feature-id> <test-task>`; a feature's
219
308
  "not done until its tasks close" status comes from its children, never from a `blocks`
220
309
  edge back onto them)
221
- - `bd dep add <test-task> <impl-task>` (test task blocked until impl task is done -- this
222
- IS correct: impl-task and test-task are siblings, not ancestor/descendant)
223
- - For tasks that depend on a prior sibling task: `bd dep add <later-task> <earlier-task>`
310
+ - INSIDE a lane, order comes from `streakOrder` ONLY. Do NOT add a `blocks` edge between
311
+ two tasks in the same lane -- the engine dispatches only currently-unblocked tasks, so an
312
+ intra-lane edge would push the later task into a separate review round and silently
313
+ defeat the lane. This includes the `[test]` task: it follows its `[impl]` task by
314
+ `streakOrder`, not by an edge.
315
+ - BETWEEN lanes, order comes from `blocks` edges: when lane B must not start until lane A
316
+ is done, add `bd dep add <B-task> <A-last-task>` for EVERY task in lane B against the
317
+ LAST (highest `streakOrder`) task of lane A. Wiring only B's first task would let B's
318
+ later tasks become ready out of order.
319
+ - Sibling tasks in different lanes with no enabling relationship get no edge.
224
320
 
225
321
  ## Step 4 -- Validate your own DAG
226
322
 
@@ -257,11 +353,18 @@ direction, and re-run the scoped `--ready` query to confirm issues are unblocked
257
353
  Also check each open feature:
258
354
  - Has at least one [impl] task AND one [test] task?
259
355
  - Every task description has clear acceptance criteria?
260
- - No task spans more than ~3 file changes?
261
- - Test tasks are downstream of implementation tasks?
262
- - Every task has a model tier set via `--metadata '{"model": "..."}'` (see Step 3)?
263
- - Every task carries `streak` and `streakOrder` lane metadata (see Step 3)? Impl/test
264
- pairs and mutex-resource members co-laned, and no lane's effort exceeds the threshold?
356
+ - Every task carries `model`, `size`, `streak`, `streakOrder` metadata via `--metadata`
357
+ (see Step 3) -- never `--notes`?
358
+ - Does every lane hold ONE reviewable increment (impl + its test, all mutex members, all
359
+ enabling chains), within `laneMaxTasks` / `laneMaxEffort`?
360
+ - Is every lane below `laneTargetEffort` either justified in its first task description or
361
+ merged with a cohesive neighbour?
362
+ - Is there NO `blocks` edge between two tasks that share a `streak` id?
363
+ - Does every cross-lane `blocks` edge target the upstream lane's LAST task and originate
364
+ from EVERY task of the downstream lane?
365
+ - Expected review rounds (= longest chain of lanes joined by `blocks` edges): state the
366
+ number in your `notes`. If it exceeds 3 for one sprint goal, re-examine whether the
367
+ chain can be shortened by merging lanes.
265
368
  - Where `kb_stats` backed a model tier choice, does the task description cite the
266
369
  coverage number (see Step 3)? Not required for tiers set on qualitative KB signals
267
370
  alone or when `kb_stats` was unavailable.
@@ -285,12 +388,13 @@ dependency edges), which `plan-reviewer` evaluates against its own Output schema
285
388
  In addition, return a structured result matching the sibling file
286
389
  `agents/schemas/planner-output.json`: `status` (`OK` or `BLOCKED`), `notes`, the
287
390
  `featureIds`/`taskIds` you created or updated this round, and an optional `kb_captures`
288
- array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
391
+ array (see Step 0.4) -- the engine does not read or apply this field for the planner
392
+ role today, so always omit it or send `[]`. Example instance:
289
393
 
290
394
  ```json
291
395
  {
292
396
  "status": "OK",
293
- "notes": "Created 2 features, 6 tasks across 3 streak lanes.",
397
+ "notes": "Created 2 features, 6 tasks across 3 streak lanes; expected review rounds: 2.",
294
398
  "featureIds": ["BD-20", "BD-21"],
295
399
  "taskIds": ["BD-22", "BD-23", "BD-24", "BD-25", "BD-26", "BD-27"],
296
400
  "kb_captures": []
@@ -299,12 +403,19 @@ array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
299
403
 
300
404
  ## Rules
301
405
 
406
+ - NEVER write output schema files (e.g. planner-output.json) to disk -- emit the JSON result object directly in your final response text
302
407
  - NEVER create PLAN.md or progress.json
303
408
  - NEVER close any issues -- you only create and link
304
409
  - NEVER add scope beyond the sprint goals you were given and open bugs/features
305
410
  - Every task must be completable in one agent session
306
411
  - A task with no acceptance criteria is incomplete -- fix it before finishing
307
- - Every task must carry a model tier in `--metadata '{"model": "..."}'` -- fix before finishing
308
- - Every task must carry `streak`/`streakOrder` lane metadata alongside `model` in the same
309
- `--metadata` channel; lanes must respect the effort threshold and never split
310
- mutex-resource members apart -- fix before finishing
412
+ - Every task must carry `model`, `size`, `streak` and `streakOrder` in the SAME
413
+ `--metadata` channel at creation time -- never `--notes` -- fix before finishing
414
+ - Lanes must respect `laneMaxEffort`/`laneMaxTasks` and never split mutex-resource members
415
+ apart
416
+ - Never place a `blocks` edge between two tasks that share a `streak` id -- it silently
417
+ defeats the lane by pushing the later task into a separate review round
418
+
419
+ ## Shell command discipline
420
+
421
+ No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.