@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -0,0 +1,270 @@
1
+ // =============================================================================
2
+ // Per-dispatch kb_* / code_* tool call accounting from session_stats snapshots.
3
+ //
4
+ // The member's agent makes its kb_* and code_* calls against the fleet server
5
+ // its own MCP config points at -- for a remote member that is the member's OWN
6
+ // server, which the engine cannot observe. That server counts those calls per
7
+ // member (session_stats). So the engine reads session_stats AS the member
8
+ // (memberCall: a local in-process member session, or `apra-fleet call` on a
9
+ // remote member -- both are engine-origin sessions, whose own calls the server
10
+ // does not count) immediately before and immediately after each dispatch, and
11
+ // records the difference as that dispatch's calls.
12
+ //
13
+ // HONESTY RULE: a count is either a number read from two good snapshots or the
14
+ // string 'unknown' -- never a fabricated 0. Any of these yields 'unknown' for
15
+ // the dispatch (with a reason): no member session available, no member record
16
+ // for the dispatched member name, a failed or unparseable read, a changed
17
+ // `since` between the two snapshots (the member's server restarted mid-
18
+ // dispatch, so the counters were reset), or a negative difference.
19
+ //
20
+ // Accounting is best-effort and never fails or delays a dispatch beyond the
21
+ // bounded snapshot reads: every error is logged and recorded as 'unknown'.
22
+ //
23
+ // Records are appended to a caller-supplied array (the sprint state's
24
+ // dispatchToolCalls list) and optionally published to the viewer under
25
+ // DISPATCH_TOOL_CALLS_STATE_NAMESPACE.
26
+ // =============================================================================
27
+
28
+ /** The value recorded for a count the engine could not establish. */
29
+ export const UNKNOWN_COUNT = 'unknown';
30
+
31
+ /** publishState namespace for the per-dispatch records (viewer tab). */
32
+ export const DISPATCH_TOOL_CALLS_STATE_NAMESPACE = 'dispatch-tool-calls';
33
+
34
+ /** Default bound on one session_stats read. */
35
+ export const SNAPSHOT_READ_TIMEOUT_MS = 60_000;
36
+
37
+ function isCount(n) {
38
+ return typeof n === 'number' && Number.isInteger(n) && n >= 0;
39
+ }
40
+
41
+ /**
42
+ * Extract a session_stats snapshot { since, kb, code } from a tool result
43
+ * (MCP { content: [{ text }] } or an already-parsed object). Returns null for
44
+ * anything that is not a well-formed snapshot.
45
+ */
46
+ export function parseSessionStats(result) {
47
+ let obj = result;
48
+ if (obj && Array.isArray(obj.content)) {
49
+ if (obj.isError) return null;
50
+ const text = obj.content.map((c) => (c && typeof c.text === 'string' ? c.text : '')).join('');
51
+ try { obj = JSON.parse(text); } catch { return null; }
52
+ }
53
+ if (!obj || typeof obj !== 'object') return null;
54
+ if (typeof obj.since !== 'string' || !isCount(obj.kb) || !isCount(obj.code)) return null;
55
+ return { since: obj.since, kb: obj.kb, code: obj.code };
56
+ }
57
+
58
+ /**
59
+ * The per-dispatch counts from a before/after pair of parsed snapshots (either
60
+ * may be null). Returns { kb, code, reason } where kb/code are numbers or
61
+ * UNKNOWN_COUNT and reason explains an unknown (null otherwise).
62
+ */
63
+ export function snapshotDelta(before, after) {
64
+ if (!before || !after) {
65
+ return { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: !before ? 'before-snapshot read failed' : 'after-snapshot read failed' };
66
+ }
67
+ if (before.since !== after.since) {
68
+ return { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: 'member server restarted during the dispatch (counters reset)' };
69
+ }
70
+ const kb = after.kb - before.kb;
71
+ const code = after.code - before.code;
72
+ if (kb < 0 || code < 0) {
73
+ return { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: 'counters went backwards' };
74
+ }
75
+ return { kb, code, reason: null };
76
+ }
77
+
78
+ /**
79
+ * The reason text for a count that is unknown because the member's own tools
80
+ * were unavailable at sprint init: "member tools unavailable: <reason>" plus
81
+ * the short cause the init record carries (problem detail), when known.
82
+ * Returns null when the init record is absent or the member was verified.
83
+ *
84
+ * @param {{verified?: boolean, reason?: string|null, problems?: Array<{reason?: string, detail?: string}>}|null|undefined} init
85
+ * @returns {string|null}
86
+ */
87
+ export function memberToolsReason(init) {
88
+ if (!init || typeof init !== 'object' || init.verified === true) return null;
89
+ const reason = init.reason ? String(init.reason) : 'unverified';
90
+ const p = Array.isArray(init.problems) ? init.problems.find((x) => x && x.reason === init.reason && x.detail) : null;
91
+ const cause = p ? String(p.detail).replace(/\s+/g, ' ').trim().slice(0, 120) : '';
92
+ return `member tools unavailable: ${reason}${cause ? ` -- ${cause}` : ''}`;
93
+ }
94
+
95
+ /** Format one count for text output: a number, or the literal 'unknown'. */
96
+ export function formatCount(n) {
97
+ return isCount(n) ? String(n) : UNKNOWN_COUNT;
98
+ }
99
+
100
+ /**
101
+ * Per-member totals over a list of dispatch records. A member's total for a
102
+ * kind is a number only when every one of its dispatches has a number for
103
+ * that kind; otherwise it is UNKNOWN_COUNT (with the unknown dispatch count).
104
+ */
105
+ export function memberTotals(records) {
106
+ const out = [];
107
+ const byMember = new Map();
108
+ for (const r of Array.isArray(records) ? records : []) {
109
+ if (!r || typeof r !== 'object') continue;
110
+ const name = String(r.member || '(unknown member)');
111
+ let t = byMember.get(name);
112
+ if (!t) {
113
+ t = { member: name, dispatches: 0, kb: 0, code: 0, unknownDispatches: 0, unknownReason: null };
114
+ byMember.set(name, t);
115
+ out.push(t);
116
+ }
117
+ t.dispatches++;
118
+ if (!isCount(r.kb) || !isCount(r.code)) {
119
+ t.unknownDispatches++;
120
+ if (!t.unknownReason && r.reason) t.unknownReason = String(r.reason);
121
+ }
122
+ t.kb = isCount(t.kb) && isCount(r.kb) ? t.kb + r.kb : UNKNOWN_COUNT;
123
+ t.code = isCount(t.code) && isCount(r.code) ? t.code + r.code : UNKNOWN_COUNT;
124
+ }
125
+ return out;
126
+ }
127
+
128
+ /**
129
+ * Create the accounting helper.
130
+ *
131
+ * @param {object} deps
132
+ * @param {(member: object, tool: string, args: object) => Promise<object>} [deps.memberCall]
133
+ * the engine's memberCall (MEMBER-scoped, engine-origin); absent means
134
+ * every dispatch records 'unknown'.
135
+ * @param {(memberName: string) => object|null} [deps.getMemberInit]
136
+ * the member-init record for a member NAME (verified, reason, problems);
137
+ * an unknown count caused by a failed snapshot read or a missing member
138
+ * session then carries the member-tools reason instead of the bare read
139
+ * failure. Other unknowns (restart, counters backwards) keep their own.
140
+ * @param {(memberName: string) => object|null} [deps.memberOf]
141
+ * resolves a dispatched member NAME to its member record ({id, name, type}).
142
+ * @param {object[]} [deps.store] array records are appended to (sprint state).
143
+ * @param {(ns: string, payload: object) => void} [deps.publishState]
144
+ * @param {Function} [deps.log]
145
+ * @param {number} [deps.readTimeoutMs]
146
+ * @param {() => string} [deps.now] ISO timestamp source (tests).
147
+ */
148
+ export function createDispatchAccounting(deps = {}) {
149
+ const {
150
+ memberCall,
151
+ memberOf,
152
+ getMemberInit,
153
+ publishState,
154
+ log = () => {},
155
+ readTimeoutMs = SNAPSHOT_READ_TIMEOUT_MS,
156
+ now = () => new Date().toISOString(),
157
+ } = deps;
158
+ const store = Array.isArray(deps.store) ? deps.store : [];
159
+ let seq = 0;
160
+
161
+ function publish() {
162
+ if (typeof publishState !== 'function') return;
163
+ try {
164
+ publishState(DISPATCH_TOOL_CALLS_STATE_NAMESPACE, { dispatches: store.slice() });
165
+ } catch (err) {
166
+ log(`[dispatch-accounting] could not publish dispatch tool-call records (non-fatal): ${err && err.message || err}`);
167
+ }
168
+ }
169
+
170
+ function withTimeout(promise) {
171
+ let timer;
172
+ return Promise.race([
173
+ promise,
174
+ new Promise((_, reject) => {
175
+ timer = setTimeout(() => reject(new Error(`session_stats read timed out after ${readTimeoutMs}ms`)), readTimeoutMs);
176
+ }),
177
+ ]).finally(() => clearTimeout(timer));
178
+ }
179
+
180
+ /** One snapshot read; null on any failure (logged). */
181
+ async function readSnapshot(record, memberName, which) {
182
+ try {
183
+ const res = await withTimeout(Promise.resolve().then(() => memberCall(record, 'session_stats', {})));
184
+ const snap = parseSessionStats(res);
185
+ if (!snap) log(`[dispatch-accounting] ${which} session_stats for member '${memberName}' was unparseable; counts for this dispatch are unknown.`);
186
+ return snap;
187
+ } catch (err) {
188
+ log(`[dispatch-accounting] ${which} session_stats read for member '${memberName}' failed (counts for this dispatch are unknown): ${err && err.message || err}`);
189
+ return null;
190
+ }
191
+ }
192
+
193
+ function resolveRecord(memberName) {
194
+ try {
195
+ return typeof memberOf === 'function' ? memberOf(memberName) : null;
196
+ } catch {
197
+ return null;
198
+ }
199
+ }
200
+
201
+ return {
202
+ /** The records so far (a copy). */
203
+ records() {
204
+ return store.slice();
205
+ },
206
+ /**
207
+ * Run `fn` (one dispatch to `memberName`) between two session_stats
208
+ * snapshots and record the per-dispatch counts. `fn`'s result or
209
+ * error passes through unchanged.
210
+ */
211
+ async around({ memberName, role, label } = {}, fn) {
212
+ const index = ++seq;
213
+ const startedAt = now();
214
+ const record = memberName ? resolveRecord(memberName) : null;
215
+ let skipReason = null;
216
+ if (!memberName) skipReason = 'dispatch named no member';
217
+ else if (typeof memberCall !== 'function') skipReason = 'no member session available to read session_stats';
218
+ else if (!record || !(record.id || record.member_id)) skipReason = `no member record for '${memberName}'`;
219
+ const before = skipReason ? null : await readSnapshot(record, memberName, 'before');
220
+ try {
221
+ return await fn();
222
+ } finally {
223
+ const after = skipReason ? null : await readSnapshot(record, memberName, 'after');
224
+ const delta = skipReason
225
+ ? { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: skipReason }
226
+ : snapshotDelta(before, after);
227
+ if (delta.reason && (skipReason || /snapshot read failed$/.test(delta.reason)) && memberName && typeof getMemberInit === 'function') {
228
+ let toolsReason = null;
229
+ try { toolsReason = memberToolsReason(getMemberInit(memberName)); } catch { /* informational only */ }
230
+ if (toolsReason) delta.reason = toolsReason;
231
+ }
232
+ store.push({
233
+ index,
234
+ member: memberName ? String(memberName) : '(unknown member)',
235
+ role: role ? String(role) : null,
236
+ label: label ? String(label) : null,
237
+ startedAt,
238
+ endedAt: now(),
239
+ kb: delta.kb,
240
+ code: delta.code,
241
+ reason: delta.reason,
242
+ });
243
+ publish();
244
+ }
245
+ },
246
+ };
247
+ }
248
+
249
+ /**
250
+ * Text lines for the sprint summary: calls per member per dispatch, then
251
+ * per-member totals. Pure. 'unknown' is printed as unknown, never 0.
252
+ */
253
+ export function formatDispatchToolCalls(records) {
254
+ const list = (Array.isArray(records) ? records : []).filter((r) => r && typeof r === 'object');
255
+ if (list.length === 0) return ['No member dispatch was recorded this sprint.'];
256
+ const lines = [];
257
+ for (const r of list) {
258
+ const who = r.role ? `${r.role} on member '${r.member}'` : `member '${r.member}'`;
259
+ const label = r.label ? ` [${r.label}]` : '';
260
+ const why = (!isCount(r.kb) || !isCount(r.code)) && r.reason ? ` (unknown: ${r.reason})` : '';
261
+ lines.push(`- Dispatch ${r.index}: ${who}${label} -- kb_* calls: ${formatCount(r.kb)}, code_* calls: ${formatCount(r.code)}${why}.`);
262
+ }
263
+ lines.push('');
264
+ lines.push('Per-member totals:');
265
+ for (const t of memberTotals(list)) {
266
+ const unknown = t.unknownDispatches > 0 ? ` (${t.unknownDispatches} dispatch(es) with unknown counts)${t.unknownReason ? ` (unknown: ${t.unknownReason})` : ''}` : '';
267
+ lines.push(`- member '${t.member}': ${t.dispatches} dispatch(es), kb_* calls: ${formatCount(t.kb)}, code_* calls: ${formatCount(t.code)}${unknown}.`);
268
+ }
269
+ return lines;
270
+ }
@@ -57,7 +57,21 @@ export function isTerminalSprintFailure(err) {
57
57
  // alive-but-silent, so the turn may have run to completion (a stalled
58
58
  // planner can have created the whole DAG) with only the RESULT lost. The
59
59
  // watchdog abandons the dispatch promise, not the member's work.
60
- const AGENT_RAN_DISPATCH_REASONS = new Set(['max_turns_exhausted', 'watchdog_timeout']);
60
+ // - 'max_total_time': the server stopped a dispatch that had been running
61
+ // until its max_total_s ceiling -- the prompt was delivered and the agent
62
+ // worked for the whole budget, so partial work may exist. EXCEPT when the
63
+ // server marked it dispatched:false (details.dispatched === false): the
64
+ // budget ran out during setup, before anything was sent, so nothing ran.
65
+ // - 'permission_denied': the agent ran its turn and some of its tool calls
66
+ // were refused for lack of a grant (the dispatch engine heals it via
67
+ // compose_permissions). Calls it WAS allowed may have committed work.
68
+ // ('agent_never_started' is deliberately NOT here: the member process never
69
+ // produced a session, so nothing ran and nothing was mutated.)
70
+ const AGENT_RAN_DISPATCH_REASONS = new Set(['max_turns_exhausted', 'watchdog_timeout', 'max_total_time', 'permission_denied']);
71
+
72
+ function agentRan(details) {
73
+ return AGENT_RAN_DISPATCH_REASONS.has(details.reason) && details.dispatched !== false;
74
+ }
61
75
 
62
76
  // True when a thrown dispatch error means the dispatch delivered no usable
63
77
  // result and therefore produced no code/beads mutation to publish: a failed
@@ -85,10 +99,16 @@ const AGENT_RAN_DISPATCH_REASONS = new Set(['max_turns_exhausted', 'watchdog_tim
85
99
  // command() throw it from inside the dispatch closure BEFORE any dispatch
86
100
  // is issued (packages/apra-fleet-workflow/src/workflow/errors.mjs), so it
87
101
  // alone provably mutated nothing.
102
+ //
103
+ // NOT a guarantee the member checkout is untouched: a transport drop can sever
104
+ // the channel while the member keeps working. The doer retry ladder therefore
105
+ // does not trust this predicate for its reset-onto-remote-tip decision; that
106
+ // reset salvages local work to a fleet-salvage/ side ref first (see the comment
107
+ // at retryFollowsPossibleMutation in dispatch-role.mjs).
88
108
  export function isNoMutationDispatchFailure(err) {
89
109
  if (!err) return false;
90
110
  if (err instanceof AgentOutputError) return false;
91
- if (err instanceof AgentDispatchError && err.details && AGENT_RAN_DISPATCH_REASONS.has(err.details.reason)) {
111
+ if (err instanceof AgentDispatchError && err.details && agentRan(err.details)) {
92
112
  return false;
93
113
  }
94
114
  return err instanceof AgentDispatchError || err instanceof FleetTransportError || err instanceof BudgetExceededError;
@@ -6,6 +6,9 @@ import {
6
6
  isInfraDispatchFailure,
7
7
  isUsageLimitDispatchError,
8
8
  usageLimitOf,
9
+ isPermissionDeniedDispatchError,
10
+ permissionDeniedOf,
11
+ MemberPermissionDeniedError,
9
12
  } from './errors.mjs';
10
13
  import { AgentOutputError, AgentDispatchError, FleetTransportError, WorkflowError } from '@apralabs/apra-fleet-workflow';
11
14
 
@@ -71,14 +74,14 @@ const PLAN_REVIEWER_MAX_TURNS = 500;
71
74
  const SCOPED_REPLAN_PLANNER_MAX_TURNS = 500;
72
75
  /** Scoped replan plan-reviewer turn base. */
73
76
  const SCOPED_REPLAN_REVIEWER_MAX_TURNS = 500;
74
- /** Harvester turn base: it writes docs/changelog across the whole epic. */
77
+ /** Harvester turn base: it writes docs across the whole epic. */
75
78
  const HARVESTER_MAX_TURNS = 500;
76
79
  /** Deployer turn base: it runs real deploy commands per a runbook. */
77
80
  const DEPLOYER_MAX_TURNS = 500;
78
81
  /**
79
- * Regression turn base: the real functional suite alone spends roughly one
80
- * turn per liveness poll for the better part of an hour, and this single
81
- * dispatch carries both it and the sandbox smoke sprint.
82
+ * Regression turn base: one dispatch runs the target's whole regression
83
+ * playbook, which can poll a long-running suite (roughly one turn per
84
+ * liveness poll) for the better part of an hour.
82
85
  */
83
86
  const REGRESSION_TEST_MAX_TURNS = 500;
84
87
  /**
@@ -223,9 +226,21 @@ function turnBaseValue(name) {
223
226
  return base;
224
227
  }
225
228
 
229
+ /** The session id a failed dispatch's error reports, or null. */
230
+ function sessionIdOfError(err) {
231
+ const id = err && err.details && err.details.sessionId;
232
+ return typeof id === 'string' && id ? id : null;
233
+ }
234
+
226
235
  /**
227
236
  * The resume argument, resolved from `policy.resumeArg`:
228
- * 'same-session' -- true (an in-dispatch continuation of the session just run)
237
+ * 'same-session' -- opts.resumeSessionId, the EXPLICIT id of the session just
238
+ * run (the failed dispatch's err.details.sessionId). NEVER
239
+ * `true`: the server resolves `true` to the member's last
240
+ * SUCCESSFUL session, which on a member shared by several
241
+ * roles can be a reviewer's or planner's session. With no id
242
+ * it yields false (the caller starts a fresh full-prompt
243
+ * session instead of resuming)
229
244
  * 'fresh-session' -- false (a self-contained one-off instruction)
230
245
  * 'round-session' -- opts.resumeArg, the runner's per-round session lookup
231
246
  * 'worklist' -- opts.resumeArg, the doer's per-worklist resume argument
@@ -244,7 +259,9 @@ function turnBaseValue(name) {
244
259
  */
245
260
  export function resolveResumeArg(resumeArg, opts) {
246
261
  if (!resumeArg) return false;
247
- if (resumeArg.kind === 'same-session') return true;
262
+ if (resumeArg.kind === 'same-session') {
263
+ return typeof opts.resumeSessionId === 'string' && opts.resumeSessionId ? opts.resumeSessionId : false;
264
+ }
248
265
  if (resumeArg.kind === 'fresh-session') return false;
249
266
  // A runner-supplied argument: already `false` or an explicit session id at
250
267
  // every call site today. `?? false` keeps the never-undefined guarantee if
@@ -556,9 +573,16 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
556
573
  // In-bracket pre-dispatch steps, then the caller's own preparation.
557
574
  const inBracket = await runPreDispatchSteps(ctx, dispatch, member, opts, extra, 'in-bracket');
558
575
  if (inBracket) return inBracket.value;
559
- const prepared = opts.prepare ? await opts.prepare({ dispatch, ...extra }) : {};
576
+ const prepared = opts.prepare ? { ...(await opts.prepare({ dispatch, ...extra })) } : {};
577
+ // A fresh-session fallback (no explicit session id to resume) must
578
+ // never carry a resume argument, whatever prepare offered.
579
+ if (extra.freshSession) prepared.resumeArg = false;
560
580
  const localBindings = { ...bindingsFor(extra.resumeAttempt || 0), ...(prepared.bindings || {}) };
561
- const localOpts = prepared.resumeArg !== undefined ? { ...opts, resumeArg: prepared.resumeArg } : opts;
581
+ const localOpts = {
582
+ ...opts,
583
+ ...(prepared.resumeArg !== undefined ? { resumeArg: prepared.resumeArg } : {}),
584
+ resumeSessionId: extra.resumeSessionId || null,
585
+ };
562
586
  const options = {
563
587
  agentType: dispatch.agentType ?? undefined,
564
588
  model: resolveModelTier(ctx, dispatch.model, localBindings),
@@ -569,6 +593,11 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
569
593
  resume: resolveResumeArg(dispatch.resumeArg, localOpts),
570
594
  onSessionId: opts.onSessionId,
571
595
  label: prepared.label ?? defaultLabel,
596
+ // Strict permission handling: a refused tool call fails the
597
+ // dispatch (permission_denied) so no role trusts a result made
598
+ // without the refused tool's output, and the progressive heal
599
+ // (onPermissionDenied) can grant the missing permission.
600
+ fail_on_permission_denial: true,
572
601
  };
573
602
  for (const key of Object.keys(options)) {
574
603
  if (options[key] === undefined) delete options[key];
@@ -633,8 +662,15 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
633
662
  // turns can fix, so the escalation stops there.
634
663
  let resumeAttempt = 0;
635
664
  let lastResumeErr = err;
665
+ // The EXPLICIT id of the session the failed dispatch ran in. A
666
+ // resume targets exactly this id; with none, the resume becomes a
667
+ // fresh session carrying the FULL role prompt (never resume: true,
668
+ // which could reattach another role's session on a shared member).
669
+ let resumeSessionId = sessionIdOfError(err);
670
+ let sessionLostOnce = false;
636
671
  while (resumeAttempt < Math.max(retry.resumeAttempts, resumesOnInfra ? 1 : 0)) {
637
672
  resumeAttempt += 1;
673
+ const freshFallback = !resumeSessionId;
638
674
  // A resume follows an agent that DID run (max_turns_exhausted is
639
675
  // a resumable partial-work case, not a no-mutation failure), so
640
676
  // it always runs the full pre-dispatch sync -- no attemptOpts.
@@ -667,14 +703,45 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
667
703
  `(attempt ${resumeAttempt}/${retry.resumeAttempts}).`
668
704
  );
669
705
  }
706
+ if (freshFallback) {
707
+ ctx.log(
708
+ `${roleLabel}: starting a FRESH session with the full role prompt instead of resuming -- ` +
709
+ (sessionLostOnce
710
+ ? 'the session to resume was not found on the member.'
711
+ : 'the failed dispatch reported no session id, so there is no explicit session to resume.')
712
+ );
713
+ } else {
714
+ ctx.log(`${roleLabel}: resuming explicit session '${resumeSessionId}'.`);
715
+ }
670
716
  resumesIssued += 1;
671
717
  try {
672
- return await runDispatch(secondary, opts.resumePrompt, opts.resumeLabel, undefined, { resumeAttempt });
718
+ return await runDispatch(
719
+ secondary,
720
+ freshFallback ? opts.prompt : opts.resumePrompt,
721
+ freshFallback ? opts.label : opts.resumeLabel,
722
+ undefined,
723
+ { resumeAttempt, resumeSessionId, freshSession: freshFallback },
724
+ );
673
725
  } catch (resumeErr) {
674
726
  lastResumeErr = resumeErr;
675
727
  const exhaustedAgain = resumeErr instanceof AgentDispatchError
676
728
  && resumeErr.details && resumeErr.details.reason === 'max_turns_exhausted';
677
- if (retry.maxTurnsResume && exhaustedAgain) continue;
729
+ // The explicit session is gone: fall back to a fresh
730
+ // full-prompt session, without charging the ladder.
731
+ const sessionNotFound = resumeErr instanceof AgentDispatchError
732
+ && resumeErr.details && resumeErr.details.reason === 'session_not_found';
733
+ if (sessionNotFound && !freshFallback) {
734
+ sessionLostOnce = true;
735
+ resumeSessionId = null;
736
+ resumeAttempt -= 1;
737
+ continue;
738
+ }
739
+ if (retry.maxTurnsResume && exhaustedAgain) {
740
+ // A re-exhaustion moves the resume target to the NEW
741
+ // session's id (none -> a fresh full-prompt session).
742
+ resumeSessionId = sessionIdOfError(resumeErr);
743
+ continue;
744
+ }
678
745
  throw resumeErr;
679
746
  }
680
747
  }
@@ -695,11 +762,12 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
695
762
  // fresh one. Only reached when the failing attempt reported a sessionId and
696
763
  // the role actually has a max-turns resume secondary; otherwise the caller
697
764
  // re-runs runAttempt fresh.
698
- const redispatchViaUsageLimitResume = async (attemptOpts) => {
765
+ const redispatchViaUsageLimitResume = async (attemptOpts, sessionId) => {
699
766
  const secondary = policy.secondary;
700
767
  const shortCircuit = await runPreDispatchSteps(ctx, secondary, member, opts, { resumeAttempt: 1 });
701
768
  if (shortCircuit) return shortCircuit.value;
702
- return runDispatch(secondary, opts.resumePrompt ?? opts.prompt, opts.resumeLabel ?? opts.label, attemptOpts, { resumeAttempt: 1 });
769
+ // Resumes the session the limit hit, by its explicit id.
770
+ return runDispatch(secondary, opts.resumePrompt ?? opts.prompt, opts.resumeLabel ?? opts.label, attemptOpts, { resumeAttempt: 1, resumeSessionId: sessionId });
703
771
  };
704
772
 
705
773
  let lastErr = null;
@@ -725,9 +793,88 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
725
793
  // resume ladder. A usage-limit re-dispatch does NOT consume a ladder
726
794
  // attempt (see the hook below), so it also skips the retry backoff.
727
795
  let usageLimitRedispatch = null;
796
+ // The explicit id of the session the usage limit hit (for the resume above).
797
+ let usageLimitSessionId = null;
798
+ // A permission-refusal heal is PROGRESSIVE: each refusal is handed to
799
+ // ctx.onPermissionDenied, which grants what the member is missing (within
800
+ // its composed policy) and reports healed:true only when a new grant
801
+ // landed; the attempt is then re-run without charging the ladder (and
802
+ // without the backoff). The hook owns every stop rule (auto-mode refusal,
803
+ // no progress, per-member and per-ladder caps); this ladder only counts
804
+ // its own heals for the per-ladder cap.
805
+ let permissionHeals = 0;
806
+ let permissionHealRedispatch = false;
807
+ // Resolves null when the heal succeeded (re-run the attempt), else the
808
+ // MemberPermissionDeniedError that ends the sprint.
809
+ const healPermissionDenial = async (err) => {
810
+ const denial = permissionDeniedOf(err);
811
+ const actions = denial && denial.denials.length
812
+ ? denial.denials.map((d) => (d.target ? `${d.action} "${d.target}"` : d.action))
813
+ : ((denial && denial.actions) || []);
814
+ const actionText = actions.length ? actions.join(', ') : 'unknown actions';
815
+ const suggested = (denial && denial.suggestedGrants) || [];
816
+ const fail = (step, why, heal) => {
817
+ const composeRole = (heal && heal.composeRole) || 'the role of its sprint roles';
818
+ const rejected = (heal && heal.rejectedGrants) || [];
819
+ const grantFix = rejected.length
820
+ ? ` and grant ${JSON.stringify(rejected)} if that role should have them (they are outside the role policy, so the sprint never auto-grants them)`
821
+ : (suggested.length ? ` (suggested grants: ${JSON.stringify(suggested)})` : '');
822
+ if (step === 'not_healable') {
823
+ return new MemberPermissionDeniedError(
824
+ `${roleLabel} dispatch on member '${member}' was refused tool calls by its permission mode's safety checks: ${actionText}. ` +
825
+ `${why} The reply was not complete, so this is not a ${roleLabel} result. ` +
826
+ 'No grant is added for a classifier or deny-rule refusal. To fix: review the refused calls; if the action is really intended, ' +
827
+ `grant it on member '${member}' by hand (compose_permissions grant) or change the role's task, then rerun the sprint.`,
828
+ {
829
+ member, role: policy.role, actions, suggestedGrants: [], rejectedGrants: [], step,
830
+ details: { hint: denial ? denial.hint : '' }, cause: err,
831
+ },
832
+ );
833
+ }
834
+ return new MemberPermissionDeniedError(
835
+ `${roleLabel} dispatch on member '${member}' was refused tool calls for lack of a permission grant: ${actionText}. ` +
836
+ `${why} This is a missing-permission failure, not a ${roleLabel} result. ` +
837
+ `To fix: run compose_permissions for member '${member}' with role ${composeRole}${grantFix}, then rerun the sprint.`,
838
+ {
839
+ member,
840
+ role: policy.role,
841
+ actions,
842
+ suggestedGrants: suggested,
843
+ rejectedGrants: rejected,
844
+ step,
845
+ details: { hint: denial ? denial.hint : '' },
846
+ cause: err,
847
+ },
848
+ );
849
+ };
850
+ if (typeof ctx.onPermissionDenied !== 'function') {
851
+ return fail('heal', 'No permission heal is wired for this run, so nothing re-composed the member.', null);
852
+ }
853
+ let heal;
854
+ try {
855
+ heal = await ctx.onPermissionDenied({ member, role: policy.role, roleLabel, denial, ladderHeals: permissionHeals });
856
+ } catch (healErr) {
857
+ heal = { healed: false, reason: healErr && healErr.message ? healErr.message : String(healErr) };
858
+ }
859
+ if (!heal || !heal.healed) {
860
+ const step = (heal && heal.step) || 'heal';
861
+ const why = step === 'heal'
862
+ ? `The permission heal failed: ${(heal && heal.reason) || 'no result'}.`
863
+ : `The permission heal can make no further progress: ${(heal && heal.reason) || step}.`;
864
+ return fail(step, why, heal);
865
+ }
866
+ permissionHeals += 1;
867
+ ctx.log(
868
+ `${roleLabel} dispatch: member '${member}' was refused ${actionText}; granted ` +
869
+ `${(heal.grants || []).join(', ') || 'its missing permissions'} -- retrying (heal ${permissionHeals} of this dispatch, not charged to the ladder).`
870
+ );
871
+ return null;
872
+ };
728
873
 
729
874
  for (let attempt = 1; attempt <= attempts; attempt++) {
730
- if (!usageLimitRedispatch && backoffMs && backoffMs[attempt - 1] > 0) {
875
+ const skipBackoff = Boolean(usageLimitRedispatch) || permissionHealRedispatch;
876
+ permissionHealRedispatch = false;
877
+ if (!skipBackoff && backoffMs && backoffMs[attempt - 1] > 0) {
731
878
  ctx.log(
732
879
  `${roleLabel} dispatch: waiting ${backoffMs[attempt - 1] / 1000}s before retry attempt ` +
733
880
  `${attempt}/${backoffMs.length}...`
@@ -745,6 +892,19 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
745
892
  // never fast-forward. Only after a failure that may have committed:
746
893
  // an auth/trust failure provably ran nothing, so its retry keeps
747
894
  // plain ff-only pre-dispatch sync.
895
+ //
896
+ // This is deliberately BROADER than isNoMutationDispatchFailure
897
+ // (dispatch-failure.mjs): a stall kill or a transport drop is
898
+ // classed no-mutation there (so the post-dispatch push is skipped),
899
+ // yet the member may still have committed or edited files before
900
+ // the channel died. The two are reconciled by making the reset
901
+ // itself non-destructive rather than by re-classifying those
902
+ // failures: syncMemberBefore's resetToRemoteTip mode always pins
903
+ // unpublished commits and uncommitted tracked changes on a local
904
+ // fleet-salvage/ side ref first and refuses to reset if it cannot
905
+ // (salvageBeforeReset in member-sync.mjs). Treating a failure as
906
+ // possibly-mutating here is therefore always safe, and nothing a
907
+ // killed attempt left behind is lost to the retry.
748
908
  const retryFollowsPossibleMutation = attempt > 1 && lastErr
749
909
  && !isNonRetryableDispatchError(lastErr);
750
910
  const attemptOpts = {
@@ -763,7 +923,7 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
763
923
  const redispatchMode = usageLimitRedispatch;
764
924
  usageLimitRedispatch = null;
765
925
  value = redispatchMode === 'resume'
766
- ? await redispatchViaUsageLimitResume(attemptOpts)
926
+ ? await redispatchViaUsageLimitResume(attemptOpts, usageLimitSessionId)
767
927
  : await runAttempt(attemptOpts);
768
928
  if (opts.afterAttempt) await opts.afterAttempt(value);
769
929
  // A postResult step may REJECT the result (the reviewer's
@@ -825,6 +985,28 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
825
985
  skipPreDispatchSyncNext = ctx.isNoMutationDispatchFailure(err);
826
986
  }
827
987
 
988
+ // An agent permission refusal (reason 'permission_denied': the
989
+ // member CLI refused tool calls for lack of a grant) is a
990
+ // MISSING-PERMISSION failure, for every role -- never a role
991
+ // outcome. It is never degraded (a plan-reviewer's refusal text
992
+ // must not become a CHANGES_NEEDED verdict and charge a planning
993
+ // round), never retried blindly (the same config refuses the same
994
+ // call), and healed progressively: ctx.onPermissionDenied grants
995
+ // the missing permission within the member's composed policy, then
996
+ // the attempt is re-run without charging the ladder; a refusal of
997
+ // a different tool next time is healed the same way. When the hook
998
+ // can make no further progress (auto-mode refusal, refused again
999
+ // after its grant, outside policy, cap reached) or no hook is
1000
+ // wired, the sprint ends with MemberPermissionDeniedError naming
1001
+ // member, the denied actions and the fix.
1002
+ if (!completedButSyncFailed && isPermissionDeniedDispatchError(err)) {
1003
+ const healError = await healPermissionDenial(err);
1004
+ if (healError) throw healError;
1005
+ permissionHealRedispatch = true;
1006
+ attempt -= 1;
1007
+ continue;
1008
+ }
1009
+
828
1010
  // Usage-limit pause/resume (apra-fleet-hzeb.4.2). A provider
829
1011
  // rate/usage limit is neither a failure of this role nor something a
830
1012
  // retry ladder can out-wait on its own budget -- it needs a real
@@ -863,6 +1045,7 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
863
1045
  const canResumeSession = Boolean(failedSessionId) && retry.resumeAttempts > 0
864
1046
  && policy.secondary && policy.secondary.kind === 'max-turns-resume';
865
1047
  usageLimitRedispatch = canResumeSession ? 'resume' : 'fresh';
1048
+ usageLimitSessionId = canResumeSession ? failedSessionId : null;
866
1049
  attempt -= 1;
867
1050
  continue;
868
1051
  }
@@ -899,12 +1082,18 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
899
1082
  }
900
1083
  ctx.log(
901
1084
  `${roleLabel} dispatch threw a non-retryable error (auth/trust): ${err.message}. Aborting ` +
902
- "retries -- fix the member's credentials/trust and re-run."
1085
+ `retries -- fix member '${member}' credentials/trust and re-run (for an LLM auth failure: re-login on the source machine with /login, then provision_llm_auth; or provision an API key).`
903
1086
  );
904
1087
  // A ladder whose own failure legitimately fails the whole
905
1088
  // sprint propagates instead of degrading: with the dispatch
906
1089
  // channel walled off there is no judgement to fabricate.
907
- if (retry.rethrowsUnhealedNonRetryable) throw err;
1090
+ if (retry.rethrowsUnhealedNonRetryable) {
1091
+ if (isAuthDispatchError(err) && err && typeof err.message === 'string'
1092
+ && !err.message.includes('provision_llm_auth')) {
1093
+ err.message += ` [LLM auth heal failed for member '${member}': re-login on the source machine with /login, then provision_llm_auth; or provision an API key]`;
1094
+ }
1095
+ throw err;
1096
+ }
908
1097
  break;
909
1098
  }
910
1099