@apralabs/apra-fleet 0.3.6 → 0.4.0

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 (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,402 @@
1
+ ---
2
+ name: pm
3
+ description: Project Manager skill. One orchestrator session drives eight subagent roles -- planner, plan-reviewer, doer, reviewer, deployer, integ-test-runner, ci-watcher, harvester -- through cycles of Plan, Develop, Test, and Harvest across one or more parallel tracks in isolated git worktrees, running each task on a complexity-matched model tier and looping to a reviewer-APPROVED verdict and a PR. Sprint state lives in a beads task DB (the single source of truth) and git. Use to drive a single project's multi-step development end to end.
4
+ ---
5
+
6
+ # pm -- Project Manager
7
+
8
+ You are the orchestrator. From one session you drive a project's development by
9
+ dispatching subagents across sprint-core and lifecycle-support roles, running
10
+ **cycles** of four **phases** -- Plan, Develop, Test, Harvest -- until the work is
11
+ APPROVED and a PR is raised. You never write code yourself -- you dispatch, read
12
+ verdicts, manage git and the task DB, and drive the loop.
13
+
14
+ One orchestrator manages exactly **one project**. Within that project, work may be
15
+ split into independent **tracks** that run in parallel, each in its own git
16
+ worktree (see Tracks and parallelism).
17
+
18
+ ## State lives in two places
19
+
20
+ All sprint state is held in:
21
+
22
+ - **beads (`bd`), the task DB -- the single source of truth and the message bus:**
23
+ sprint root, tasks, dependencies, assignees, acceptance criteria, model-tier assignment,
24
+ review findings, backlog, PR link. The planner writes tasks here; the orchestrator
25
+ reads `bd ready` and hands the doer explicit bead ids, which the doer claims/closes
26
+ (the doer never discovers work via bare `bd ready` -- see `agents/doer.md` Step 1);
27
+ the reviewer reads acceptance criteria with
28
+ `bd show` and returns `reopenIds` for the orchestrator to reopen -- the reviewer never
29
+ mutates beads directly. There is no PLAN.md and no progress.json --
30
+ beads holds all task state. See `beads.md`.
31
+ - **git, on each track's branch:** the code, the branch history, and the narrative
32
+ files `requirements.md` and `design.md`. The `reviewer`'s verdict is returned as
33
+ structured output directly to the orchestrator (`verdict`/`notes`/`reopenIds`/
34
+ `newTasks`), not written to a `feedback.md` file. git carries intent and the
35
+ committed work; beads carries the plan and progress.
36
+
37
+ On every dispatch completion and after any restart, re-derive position from beads and
38
+ git -- they are the single source of truth.
39
+
40
+ ## Cycles and phases
41
+
42
+ A sprint runs as one or more **cycles**. Each cycle moves through three phases in
43
+ order; a fourth phase runs once at sprint close.
44
+
45
+ - **Plan** -- dispatch `planner` to write the task DAG into beads (titles,
46
+ acceptance criteria, model-tier metadata, priorities, dependencies), loop
47
+ `plan-reviewer` to APPROVED. Skip the loop if planning is already complete (sprint root
48
+ has features and every open feature's tasks carry acceptance criteria); just reset
49
+ any task orphaned `in_progress` from a crashed dispatch back to open.
50
+ - **Develop** -- run the doer-review loop. Read `bd ready`, dispatch `doer` per ready
51
+ model streak (each doer claims and closes its tasks in beads), then one `reviewer`
52
+ over the worked tasks. Repeat until `bd ready` is empty, no open task remains at
53
+ the goal priority, and the last review verdict is APPROVED.
54
+ - **Test** -- only when both `deploy.md` and `integ-test-playbook.md` are present:
55
+ `deployer` deploys per `deploy.md` (deploy + smoke test), then
56
+ `integ-test-runner` runs `integ-test-playbook.md` end to end -- the real
57
+ functional suite, then the smoke-test sprint in a sandbox it brings up and
58
+ tears down itself -- plus each feature's tests (closes passing features,
59
+ files bugs for failures). Skip the whole phase if either file is absent.
60
+ - **Harvest** -- runs once after the cycle loop exits (goal met or cycle ceiling
61
+ hit): poll CI via `ci-watcher`, run a final reviewer pass, then `harvester`
62
+ extracts durable knowledge into `docs/` and `CHANGELOG`, and raise the PR.
63
+
64
+ At the end of each cycle, check the **goal**: the sprint is done when no open
65
+ beads issue in the sprint-root subtree sits at or above the goal priority (default
66
+ P1/P2). If the goal is met, exit the cycle loop and run Harvest. Otherwise start
67
+ the next cycle, capped by a cycle ceiling (default 5). Abort early if a cycle
68
+ resolves none of the previous cycle's open issues -- two cycles with no progress
69
+ is a signal to stop and flag the user, not loop forever.
70
+
71
+ ### Develop exit condition
72
+
73
+ The Develop phase exits when `bd ready` returns nothing, `bd list --status=open` at
74
+ the goal priority is empty, **and** the last `reviewer` verdict was APPROVED. A
75
+ single APPROVED is sufficient -- beads tracks discrete tasks, so once every task is
76
+ closed and the final review passes there is nothing left to converge on. Any CHANGES
77
+ NEEDED reopens the failing tasks (they return to `bd ready`), so the loop simply
78
+ continues until they are cleared and a clean APPROVED lands on an empty queue. This
79
+ gate guards the transition from Develop into Test (or, on the final cycle, into
80
+ Harvest): never deploy or harvest with open tasks at the goal priority.
81
+
82
+ ## Role taxonomy
83
+
84
+ Eight subagent roles carry the work, split into two groups.
85
+
86
+ **Sprint-core** roles run every cycle, one of: `planner`, `plan-reviewer`,
87
+ `doer`, `reviewer`.
88
+
89
+ **Lifecycle-support** roles run only when their phase or condition fires, one of:
90
+ `deployer`, `integ-test-runner`, `ci-watcher`, `harvester`.
91
+
92
+ Roles coordinate through beads (the task state and message bus) and the committed
93
+ code and narrative files (`requirements.md`, `design.md`) on the
94
+ track's branch.
95
+
96
+ ### Sprint-core roles
97
+
98
+ - `planner` -- reads `requirements.md` (and `design.md` if present), writes the task
99
+ DAG into beads: one task per item with title/description, `--acceptance="..."`, a
100
+ model tier in `--metadata '{"model": "..."}'`, a priority, and dependencies
101
+ (`bd dep add`). Writes no PLAN.md.
102
+ - `plan-reviewer` -- inspects the beads DAG (`bd graph`, `bd ready`, `bd show`),
103
+ returns structured output ONLY (`verdict`: `APPROVED` / `CHANGES_NEEDED`, `notes`,
104
+ `taskAssignments`); never writes `feedback.md` or `PLAN.md`.
105
+ - `doer` -- works the explicit bead ids the orchestrator hands it (never bare
106
+ `bd ready` discovery), reads each task's acceptance + model tier with
107
+ `bd show`, claims it (`bd update --claim`), implements one task at a time, commits
108
+ after each, closes it (`bd close`), STOPS at every VERIFY checkpoint.
109
+ - `reviewer` -- reads each worked task's acceptance criteria (`bd show`) + the diff,
110
+ returns structured output ONLY (`verdict`: `APPROVED` / `CHANGES_NEEDED`, `notes`,
111
+ `reopenIds`, `newTasks`); never writes `feedback.md` and never touches beads directly.
112
+ The orchestrator reads that structured output and runs `bd update --status=open` /
113
+ `bd create` itself.
114
+
115
+ ### Lifecycle-support roles
116
+
117
+ Dispatch these only when their condition holds:
118
+
119
+ - `deployer` -- in the Test phase, once the Develop exit condition is met (no open
120
+ tasks at the goal priority, last review APPROVED) and `deploy.md` is present;
121
+ follows `deploy.md` to deploy the build and run its smoke test. It does not
122
+ run `integ-test-playbook.md`.
123
+ - `integ-test-runner` -- in the Test phase, after a successful deploy, when
124
+ `integ-test-playbook.md` is present; owns that playbook end to end (real
125
+ functional suite, then sandbox Setup/Reset, smoke scenario, feature tests,
126
+ Teardown always), closing passing features and filing bugs for failures.
127
+ - `ci-watcher` -- in Harvest, to poll CI for the sprint HEAD SHA (green / red /
128
+ not configured / pending). [Fleet mode] PM may run `gh` CLI directly instead of
129
+ dispatching (R13).
130
+ - `harvester` -- in Harvest, at sprint close, to extract durable knowledge into
131
+ `docs/` and update `CHANGELOG`.
132
+
133
+ ## Tracks and parallelism
134
+
135
+ A **track** is one independent unit of work: one branch, one worktree, and its own
136
+ full pipeline (`planner` -> `plan-reviewer` -> `doer` -> `reviewer`). A project may
137
+ run a single track, or several tracks at once.
138
+
139
+ - **A single track** is the common case: one branch, the pipeline runs end to end.
140
+ - **Multiple tracks** run when the work splits into independent, low-coupling units.
141
+ Each track gets its own worktree and branch and its own full pipeline, and the
142
+ tracks run **concurrently** -- nothing forces one track's planner to wait on
143
+ another track's doer. The orchestrator fans out, drives each track's loop
144
+ independently, and integrates at the end.
145
+
146
+ Within one track the pipeline is sequential (the doer stops before the reviewer
147
+ runs). Across tracks everything is parallel. Worktrees give each track its own
148
+ files, so concurrent tracks never collide. See `worktrees.md` for topology and
149
+ `sprint.md` for the parallel integration flow.
150
+
151
+ ## Dispatch
152
+
153
+ Each dispatch is one inline subagent call. It carries everything the agent
154
+ needs in the prompt, since agents share the filesystem:
155
+
156
+ - **Role** -- one of the roles listed in the taxonomy above.
157
+ - **Prompt** -- pins the track's worktree (absolute path + branch) and states the
158
+ task. Per-role templates are in `doer-reviewer-loop.md`.
159
+ - **Inline** -- dispatch a subagent and receive its result in the same turn, then
160
+ act on it; run the loop sequentially this way. For parallel tracks, dispatch
161
+ several at once and poll them to completion within the turn. Keep the turn alive
162
+ until the results are in -- do not end it expecting to be re-invoked.
163
+ - **Model** -- the exact model the planner assigned to this task (see Model
164
+ assignment); the orchestrator passes it through verbatim.
165
+
166
+ ## Model assignment
167
+
168
+ Matching model power to task complexity is a headline capability of this skill, not
169
+ an option. Models fall into three tiers, strongest to cheapest: **premium-tier**,
170
+ **standard-tier**, **cheap-tier**. **The planner decides the tier each work task runs
171
+ on** and records it as beads metadata (`--metadata '{"model": "<tier>"}'`) -- this is the
172
+ single canonical location the tier lives in; it is never written to `--notes`. At
173
+ dispatch time the orchestrator reads it back with `bd show <id>` (the `model` metadata
174
+ key) and dispatches each doer on that tier. `plan-reviewer` (criterion 10 / Step 3) reads
175
+ the tier from this same metadata key, so a planner that sets it here can never fail
176
+ plan-reviewer's model-metadata check -- the two are aligned by construction.
177
+
178
+ How the planner chooses the doer tier (mirrors the criteria owned by `agents/planner.md`
179
+ itself -- keep the two in sync if either changes):
180
+
181
+ - **cheap-tier** -- mechanical work: rename, move, config tweak, simple wiring,
182
+ boilerplate.
183
+ - **standard-tier** -- standard implementation: a new function, an API endpoint, a
184
+ test suite, a focused refactor.
185
+ - **premium-tier** -- hard work: architecture, multi-file design, high-ambiguity or
186
+ cross-cutting reasoning.
187
+
188
+ It picks from the models actually available in the current environment.
189
+
190
+ Fixed rules:
191
+
192
+ - The `doer` runs on the tier the planner assigned to the task it will execute,
193
+ read from the task's beads metadata (`bd show <id>`, `model` key) at dispatch time.
194
+ - `planner` runs premium-tier; `plan-reviewer` runs standard-tier. The `reviewer` runs
195
+ standard-tier by default but escalates to premium-tier whenever any doer streak in the
196
+ iteration ran premium-tier -- review must never be weaker than the work it judges.
197
+ Planning and review are the quality gates and must not be under-powered.
198
+ - Cheap, bounded state-check dispatches (read-only `bd`/`git` queries such as
199
+ `bd ready` / `bd show`, log appends, feedback commits) run cheap-tier.
200
+ - A user override always wins.
201
+
202
+ ## Sprint selection
203
+
204
+ Before starting, choose the shape that fits:
205
+
206
+ | Condition | Sprint type | Reference |
207
+ |-----------|-------------|-----------|
208
+ | 1-3 tasks, one sitting, low risk, no phasing | Lightweight | `simple-sprint.md` |
209
+ | Work splits into independent, low-coupling units | Parallel tracks | `sprint.md` Parallel tracks |
210
+ | Default | Single track, full lifecycle | `sprint.md` |
211
+
212
+ If tracks are tightly coupled or share significant upfront dependencies, use
213
+ single track -- splitting tightly coupled work creates more coordination overhead
214
+ than it saves.
215
+
216
+ ## Command reference
217
+
218
+ | Command | Action | Details |
219
+ |---------|--------|---------|
220
+ | `/pm plan <requirement>` | Write requirements, dispatch planner, loop plan-reviewer to APPROVED | `sprint.md` |
221
+ | `/pm start` | Run the doer-review loop for the next pending phase | `doer-reviewer-loop.md` |
222
+ | `/pm status` | Report position from beads + git | -- |
223
+ | `/pm resume` / `/pm recover` | Reconstruct state from beads + git and continue | `sprint.md` Recovery |
224
+ | `/pm deploy` | Run the project's deploy.md runbook | `sprint.md` Test |
225
+ | `/pm backlog` / `/pm tasks` | Manage deferred items and view the task tree via beads | `beads.md` |
226
+ | `/pm cleanup` | Close sprint root, drop scaffolding, raise PR, remove worktrees | `sprint.md` Completion |
227
+ | `/pm init <project>` | Set up project folder, beads sprint root, worktree | `sprint.md` Setup |
228
+ | `/pm pair <doer> <reviewer>` | Assign doer-reviewer pair (fleet mode) | `fleet-addendum.md` |
229
+
230
+ ## Core rules
231
+
232
+ R1. NEVER read code to diagnose, fix, or write it. You dispatch agents, read
233
+ verdicts, and drive the loop. The only code you touch is git plumbing
234
+ (`git worktree add/list/remove`, `git merge`, `git diff <base>...<branch>`),
235
+ beads commands, and PR commands.
236
+ R2. **Project sandboxing** -- every narrative artifact (requirements.md, design.md,
237
+ and in fleet mode status.md) lives inside the track's worktree and nowhere else,
238
+ and task state lives in the project's single beads DB. Never write project files
239
+ outside a track's worktree or in the skill folder.
240
+ R3. On session start: re-derive position from beads and git -- they are the
241
+ single source of truth; there is no status file to consult in local mode
242
+ (see `sprint.md` Recovery). **[Fleet mode]** additionally keep status.md
243
+ current whenever a dispatch completes or a member reports back (mode and
244
+ pairing records -- see `fleet-addendum.md`). Never rely on memory across
245
+ sessions.
246
+ R4. **[Fleet mode]** Before dispatch: verify member has required tools via
247
+ `execute_command -> which <tool>` or `<tool> --version`.
248
+ R5. **[Fleet mode]** If a member can finish in one session (1-3 steps), use
249
+ ad-hoc `execute_prompt`. Otherwise use the task harness.
250
+ R6. NEVER let agents sit idle -- after planning, immediately start execution.
251
+ At VERIFY checkpoints, immediately dispatch reviews.
252
+ R7. During execution: keep going until stuck or done -- do not wait for the
253
+ user. At checkpoints, filter questions: resolve what you can, only escalate
254
+ genuine ambiguities. During planning: escalate tough calls (ambiguous
255
+ requirements, risky trade-offs, architectural decisions).
256
+ R8. **[Fleet mode]** When executing a sequence of fleet calls (send_files,
257
+ execute_command, execute_prompt, receive_files), club them into a single
258
+ background Agent rather than issuing individual calls.
259
+ R9. **[Fleet mode]** For unattended execution, use `update_member(unattended=
260
+ 'auto')` for safer auto-approval or `update_member(unattended='dangerous')`
261
+ for full permission bypass. Always compose and deliver permissions via
262
+ `compose_permissions` before dispatch, selecting members by tags (tags: ['doer'] /
263
+ tags: ['reviewer']). Never select members by role name or naming convention --
264
+ use tag queries exclusively (see Member selection below).
265
+ See `fleet-addendum.md`.
266
+ R10. During a sprint, every doer turn updates beads (claim/close) and commits its
267
+ code to the branch; every reviewer turn returns structured output (`verdict`/
268
+ `notes`/`reopenIds`/`newTasks`) and the orchestrator applies the resulting
269
+ reopen -- these carry the living state of the sprint. Only the agent context
270
+ file stays uncommitted.
271
+ R11. Definition of done includes security audit and documentation -- ensure
272
+ both are covered when adding tools/features.
273
+ R12. At sprint completion: raise a PR, verify CI is green -- do NOT merge.
274
+ Merge is the user's decision.
275
+ R13. **[Fleet mode]** PM runs `gh` CLI commands directly via Bash -- never
276
+ delegate to fleet members. PM owns PR lifecycle and CI file commits.
277
+ R14. Always read referenced sub-documents before executing PM commands.
278
+
279
+ Rules marked **[Fleet mode]** apply only when running with fleet members. In
280
+ local subagent mode they are skipped or adapted (see `fleet-addendum.md` for
281
+ the fleet-specific execution model).
282
+
283
+ ## Member selection (fleet mode)
284
+
285
+ Always select fleet members by tag query -- never by role name, display name, or
286
+ any naming convention. The `list_members` tool accepts a `tags` filter that
287
+ returns only members carrying all of the listed tags.
288
+
289
+ ### Basic tag queries
290
+
291
+ ```
292
+ list_members(tags: ['doer']) # all members tagged doer
293
+ list_members(tags: ['reviewer']) # all members tagged reviewer
294
+ ```
295
+
296
+ Pick the first available result (or the preferred one if multiple match), then
297
+ dispatch to it. Rerun the query when switching from doer to reviewer roles -- do
298
+ not cache results across tag switches.
299
+
300
+ ### Multi-tag queries for capability-based dispatch
301
+
302
+ When a task requires a specific capability (e.g. a particular VCS platform,
303
+ language, or environment), narrow the query with additional tags:
304
+
305
+ ```
306
+ list_members(tags: ['reviewer', 'bitbucket']) # reviewer with Bitbucket access
307
+ list_members(tags: ['doer', 'python']) # doer with Python capability
308
+ list_members(tags: ['doer', 'rust']) # doer with Rust capability
309
+ ```
310
+
311
+ Multi-tag queries return members that carry ALL listed tags. If no member
312
+ matches a narrow query, fall back to the single-tag query (`tags: ['doer']` /
313
+ `tags: ['reviewer']`) and note the missing capability in the dispatch prompt.
314
+
315
+ ### compose_permissions and permissions delivery
316
+
317
+ After selecting a member with `list_members`, compose and deliver permissions
318
+ via `compose_permissions` using the same tag set before every dispatch. See
319
+ `fleet-addendum.md` for the full permissions workflow.
320
+
321
+ ## Secrets and credentials (fleet mode)
322
+
323
+ When running via fleet, never pass raw secrets in `execute_prompt` prompts --
324
+ reference the credential by name only (e.g. "authenticate using credential
325
+ github_pat"). The member then uses `{{secure.github_pat}}` in its own
326
+ `execute_command` calls. See `fleet-addendum.md` for the full reference.
327
+
328
+ ## Provider awareness (fleet mode)
329
+
330
+ When dispatching to fleet members, the orchestrator must account for
331
+ provider-specific behaviors. The most important is the agent context file
332
+ filename -- each provider expects a different name:
333
+
334
+ | Provider | Context file |
335
+ |----------|-------------|
336
+ | Claude | CLAUDE.md |
337
+ | Antigravity (agy) | AGY.md |
338
+ | Gemini | GEMINI.md |
339
+ | Codex | AGENTS.md |
340
+ | Copilot | COPILOT.md |
341
+ | OpenCode | OPENCODE.md |
342
+
343
+ In local subagent mode, context is passed inline via the dispatch prompt --
344
+ the filename table does not apply.
345
+
346
+ ## Lifecycle
347
+
348
+ A sprint runs as cycles of phases. Within a cycle, do not skip or stall between
349
+ phases.
350
+
351
+ ```
352
+ per cycle: Plan (planner writes beads tasks -> plan-reviewer loop) -> Develop
353
+ (doer-review loop: bd ready -> claim -> close, to a clean APPROVED)
354
+ -> Test (deploy + integ tests, if applicable)
355
+ -> goal check -> next cycle | exit
356
+ at close: Harvest (CI watch -> final review -> docs/CHANGELOG -> PR)
357
+ ```
358
+
359
+ For small, low-risk work (1-3 tasks, no phasing) use the lightweight path instead
360
+ of the full harness. See `sprint.md` Sprint selection.
361
+
362
+ ## Commands
363
+
364
+ The orchestrator performs these operations. Each reads and writes state through beads
365
+ and git.
366
+
367
+ - **plan** `<requirement>` -- write `requirements.md` (+ `design.md` when warranted),
368
+ dispatch `planner` to create tasks in beads under the sprint root (acceptance criteria, model
369
+ tier, priorities, dependencies), loop `plan-reviewer` to APPROVED. See `sprint.md`.
370
+ - **start** -- run the doer-review loop for the next pending phase. See
371
+ `doer-reviewer-loop.md`.
372
+ - **status** -- report position from `bd` queries (`bd list --status=open`,
373
+ `bd ready`, `bd list --tree`) plus `git log` and the latest reviewer/plan-reviewer
374
+ structured verdicts.
375
+ - **resume** / **recover** -- reconstruct in-flight state from beads + git and
376
+ continue. See `sprint.md` Recovery.
377
+ - **deploy** -- run the project's `deploy.md` runbook (execute / verify / rollback).
378
+ See `sprint.md` Test.
379
+ - **backlog** / **tasks** -- manage deferred items and view the task tree via beads.
380
+ See `beads.md`.
381
+ - **cleanup** -- close the beads sprint root and the delivered source issues, drop the
382
+ sprint scaffolding files (so the PR's net diff is product only), raise the PR, and
383
+ remove the track worktrees. See `sprint.md` Completion.
384
+
385
+ ## Sub-documents
386
+
387
+ - `sprint.md` -- full lifecycle: the cycle loop, requirements, design, Plan,
388
+ Develop, Test, Harvest, goal and exit gates, sprint selection, parallel-track
389
+ integration, and recovery.
390
+ - `simple-sprint.md` -- lightweight 1-3 task flow (beads + git only, like every
391
+ sprint).
392
+ - `doer-reviewer-loop.md` -- the dispatch loop: per-role prompt templates,
393
+ inline dispatch, continuity between dispatches, and safeguards.
394
+ - `worktrees.md` -- worktree topology, parallel-track layout, lifecycle, transport.
395
+ - `beads.md` -- the task-DB backbone and single source of truth: sprint-root/task
396
+ lifecycle, acceptance criteria, model tiers, findings-as-tasks, backlog, recovery,
397
+ PR linking.
398
+ - `fleet-addendum.md` -- fleet-only execution: permissions, compose_permissions,
399
+ stop_prompt, unattended modes, context-file delivery.
400
+ - `cost.md` -- cost quoting and calibration: Node.js check, the extracted
401
+ `cost.js` module installed alongside the skill, quote after plan APPROVED,
402
+ sprint log format, harvest analysis and calibration update.
@@ -0,0 +1,142 @@
1
+ # Beads -- the single source of truth
2
+
3
+ beads (`bd`) is pm's task store and message bus. It holds what is in flight, what
4
+ is blocked, what was deferred, what each task must satisfy, and what each review
5
+ found. There is no PLAN.md and no progress.json: the planner writes tasks into
6
+ beads, the orchestrator reads `bd ready` and hands the doer explicit bead ids to
7
+ claim/close, and the reviewer reads each task's acceptance criteria with `bd show`. git holds only the code, the branch
8
+ history, and the requirements/design narrative; **beads holds all task state.**
9
+
10
+ ## One project, one DB
11
+
12
+ An orchestrator manages one project, so there is one beads DB for that project and
13
+ one **sprint root** per sprint. The DB is a local `.beads/` at the **base checkout** (the
14
+ orchestrator's repo root) -- not inside any track worktree. The orchestrator runs
15
+ every `bd` command from there. Doers run `bd show` / `bd update --claim` /
16
+ `bd close` against that same DB; reviewers run `bd show` only -- they never write to
17
+ beads. On CHANGES NEEDED the reviewer returns `reopenIds` and `newTasks` as structured
18
+ output (it never writes feedback.md); the orchestrator reads that output and runs the
19
+ beads updates.
20
+ The DB persists on disk across sessions, so it survives without being committed.
21
+ Committing it is optional and only shares issue history across machines; if you do,
22
+ commit it on the base or integration branch -- keeping it off the track feature
23
+ branches so parallel tracks share one DB. Tasks reference their track via assignee
24
+ or label.
25
+
26
+ ## Lifecycle hooks (not optional)
27
+
28
+ `bd` is called at these points. The planner, doer, and reviewer run their own `bd`
29
+ commands; the orchestrator runs setup, completion, and recovery queries.
30
+
31
+ **Sprint setup** (orchestrator) -- create the sprint root, reusing an existing one if present:
32
+ ```
33
+ bd search "sprint: <name>" --status all # reuse the id if found
34
+ bd create "sprint: <name>" -p 1 # else create -> <sprint-id>
35
+ ```
36
+
37
+ **Plan phase** (planner) -- one task per plan item, each carrying its acceptance
38
+ criteria, assigned model tier, priority, and track; dependencies wired. The planner
39
+ writes these directly into beads -- there is no PLAN.md:
40
+ ```
41
+ bd create "T1.1: <title>" -p 1 --parent <sprint-id> --assignee <track> \
42
+ --acceptance="<what must be true for this task to be done>" \
43
+ --metadata '{"model": "standard-tier"}' # -> task-id
44
+ bd create "T1.2: <title>" -p 2 --parent <sprint-id> --assignee <track> \
45
+ --acceptance="..." --metadata '{"model": "cheap-tier"}'
46
+ bd dep add <T1.2-id> <T1.1-id> # T1.2 blocked until T1.1 done
47
+ ```
48
+ The acceptance criteria are the reviewer's contract; the model tier in metadata is the
49
+ doer's dispatch tier. Both live on the task -- nothing is written to a plan file.
50
+
51
+ **Doer dispatch** (doer) -- read the task, claim it, implement, close it:
52
+ ```
53
+ bd show <task-id> # read description + acceptance + model tier metadata
54
+ bd update <task-id> --claim # claim (open -> in_progress, assigns self)
55
+ bd close <task-id> # when the work is complete
56
+ ```
57
+ The ORCHESTRATOR finds ready work (`bd ready` -- tasks with no open blockers, scoped to
58
+ the sprint root) and hands the doer an explicit list of bead ids in the dispatch prompt.
59
+ The doer works exactly that list and never runs bare `bd ready` to discover work itself
60
+ (it would see other sprints' concurrent tasks with no way to tell which are its own --
61
+ see `agents/doer.md` Step 1). Never steal a task already `in_progress`.
62
+
63
+ **Reviewer returns CHANGES NEEDED** (orchestrator, after reading the reviewer's
64
+ structured output) -- the reviewer returns its verdict, human notes, and the
65
+ machine-readable `reopenIds` / `newTasks` arrays as structured output (see
66
+ `doer-reviewer-loop.md` reviewer template); it never writes feedback.md. The
67
+ orchestrator reads those fields and runs:
68
+ ```
69
+ # for each id in reopenIds:
70
+ bd update <task-id> --status=open --notes="review: <finding from notes section>"
71
+
72
+ # for each entry in newTasks ({title, description, priority}):
73
+ bd create "<title>" -p <priority> --parent <sprint-id> --assignee <track> --description="<description>"
74
+ ```
75
+ Reopened tasks return to `bd ready` as work for the next iteration. On APPROVED
76
+ neither command is needed -- tasks stay closed.
77
+
78
+ **At completion** -- close the sprint root, close the delivered source issues, persist the
79
+ state, link the PR:
80
+ ```
81
+ bd close <sprint-id> <source-issue-id> [<source-issue-id> ...]
82
+ bd export -o <track-worktree>/.beads/issues.jsonl # refresh the tracked file from the db
83
+ bd note <sprint-id> "PR: <url>"
84
+ ```
85
+ The source issues are the ready backlog items the sprint's requirement was drawn
86
+ from. Closing the sprint root alone leaves them open, so the backlog never reflects the
87
+ delivered work -- close them here too. With a db backend (dolt) `bd close` does NOT
88
+ update `issues.jsonl`; `bd export -o <file>` rewrites it (a bare `bd export` prints to
89
+ stdout). Commit the refreshed `.beads/issues.jsonl` on the branch so the closures are
90
+ durable and visible in the PR.
91
+
92
+ ## Findings are never lost
93
+
94
+ A review finding against the reviewed task goes into `reopenIds` in the reviewer's
95
+ structured output; the orchestrator runs `bd update --status=open` so the doer picks it
96
+ up next loop. A finding outside the reviewed scope goes into `newTasks`; the
97
+ orchestrator creates it.
98
+ MEDIUM/LOW findings and any scope deferred mid-sprint become low-priority backlog
99
+ tasks. Every finding either gets fixed (`bd close`) or is explicitly carried as
100
+ backlog -- it is never dropped silently.
101
+
102
+ ## Backlog
103
+
104
+ Deferred work lives as low-priority tasks under the sprint root, with enough detail to act
105
+ on later without re-investigation:
106
+ ```
107
+ bd create "<headline>" -p 3 --parent <sprint-id> --description "Impact / Source / Detail / Cost of not doing it"
108
+ ```
109
+ Manage it:
110
+ ```
111
+ bd list --status open --pretty # review
112
+ bd update <id> -p 1 # promote
113
+ bd close <id> --reason "<why>" # retire as stale/superseded
114
+ bd dep add <id> <blocker-id> # gate behind another item
115
+ ```
116
+
117
+ ## Status and recovery via beads
118
+
119
+ State re-derives entirely from beads + git -- no PLAN.md, no progress.json. To see
120
+ position at any time:
121
+ ```
122
+ bd list --status=open # work still to do
123
+ bd list --status=in_progress # tasks claimed by an interrupted dispatch
124
+ bd ready # everything unblocked right now, across tracks
125
+ bd list --tree <sprint-id> # full sprint tree: tasks, status, assignee
126
+ bd show <task-id> # full context: description, acceptance, model tier metadata, notes
127
+ ```
128
+ beads reflects claim/close actions, not on-disk completion -- always confirm against
129
+ `git log <base>..<branch>` and `git status` before acting. A task marked
130
+ `in_progress` with no matching commits is an orphaned claim from a crashed dispatch;
131
+ reset it with `bd update <id> --status=open`. See `sprint.md` Recovery.
132
+
133
+ ## Rules
134
+
135
+ - **Check before create** (sprint root and task) -- `bd search ... --status all`; reuse if
136
+ found, never duplicate.
137
+ - **Check before claim** -- dispatch only if the task is `open`.
138
+ - `bd close` is idempotent and safe to re-run.
139
+ - **Never re-run `bd init`** on a repo that already has `.beads/` -- it pulls from remote, recreates the Dolt database, and overwrites local issue state. If the database is missing, prefer `bd export` + restore over `bd init`.
140
+ - Premature close -> `bd reopen <id>`.
141
+ - Never use `bd edit` -- it opens an interactive editor and blocks. Use
142
+ `bd update --status/--assignee/--notes` inline.