@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,699 @@
1
+ // Member-provisioning helpers -- extracted move-only out of runner.js
2
+ // (apra-fleet-3swo.6.12). This module owns:
3
+ //
4
+ // 1. createMemberSessionGuard -- the pre-resume `stop_prompt` guard that
5
+ // kills a prior, presumed-dead-or-timed-out session on a member before a
6
+ // resume re-dispatch, so two live sessions never duplicate one logical
7
+ // dispatch's side effects.
8
+ // 2. createUnattendedAutoProvisioner -- best-effort sets a member's
9
+ // `unattended: 'auto'` registration before it is dispatched as deployer/
10
+ // integ-test-runner/regression-test-runner, cached per member for the
11
+ // lifetime of the returned function.
12
+ // 3. createDeployPermissionsProvisioner -- best-effort self-heal that reads
13
+ // deploy.md's own `## Permissions` section off the first target member
14
+ // it provisions and proactively grants every listed prefix via
15
+ // compose_permissions, so a runbook permissions change does not have to
16
+ // wait for a dispatch to fail before anyone notices.
17
+ // 4. stageCommandBodyMemberSide -- stages free-text content to a fresh,
18
+ // member-LOCAL temp file via a shell-agnostic `node -e` one-liner (base64
19
+ // argv, no `$`-expansion/backticks/template literals), so a `bd
20
+ // --body-file` read always finds its file on the same filesystem the
21
+ // subsequent `bd` command runs on.
22
+ //
23
+ // WHAT DID NOT MOVE -- resolveSettleShell. It sat in the middle of this group
24
+ // in runner.js and is module-private wiring: it resolves a member's settle
25
+ // shell from the per-sprint sprintState that sprint-state.mjs introduced,
26
+ // which is composition-root wiring rather than an implementation helper.
27
+ // test/sprint-state.test.mjs also anchors it to runner.js by symbol. It stays
28
+ // defined and exported from runner.js; nothing here imports it back, since
29
+ // none of the four moved symbols call it.
30
+ //
31
+ // runner.js re-exports every symbol it previously exported from this region,
32
+ // so existing importers of fleet-sprint/runner.js resolve unchanged.
33
+ //
34
+ // GUARD REGISTRATION: this module is registered in ./guarded-modules.mjs as
35
+ // part of this extraction (see that file's STANDING RULE). It carries the two
36
+ // member_name-bearing command() call sites this extraction took out of
37
+ // runner.js: createDeployPermissionsProvisioner's `node -e ...` read of
38
+ // deploy.md's Permissions section, and stageCommandBodyMemberSide's `node -e
39
+ // ...` member-side temp-file write. Both already avoid shell-level variable
40
+ // expansion (base64-encoded argv, no `$`/backtick/template-literal
41
+ // interpolation), which is exactly the invariant shell-command-guard.mjs
42
+ // enforces and reads GUARDED_MODULES to find.
43
+ // A third command() site was added later: createPermissionConfigPreflight's
44
+ // file-exists probe, built per member OS/shell by SeOsCommands.fileExistsProbe
45
+ // from a validated literal work-folder-relative path (no environment reads).
46
+
47
+ import os from 'node:os';
48
+ import { createHash } from 'node:crypto';
49
+ import path from 'node:path';
50
+ import { ApraFleet } from '@apralabs/apra-fleet-client';
51
+ import { resultText } from './mcp-result.mjs';
52
+ import { MemberPermissionConfigError } from './errors.mjs';
53
+ import { FILE_PROBE_PRESENT, FILE_PROBE_ABSENT } from './se-posix.mjs';
54
+
55
+ /**
56
+ * Guards every "resume" re-dispatch below against spawning a second
57
+ * concurrent session on a member whose PRIOR process for that same logical
58
+ * dispatch is presumed dead or timed out but may still be alive -- two live
59
+ * sessions for one dispatch duplicate whatever side effects the orphaned one
60
+ * performs.
61
+ *
62
+ * Before firing a resume, call the fleet's own `stop_prompt` tool
63
+ * (src/tools/stop-prompt.ts) for that member: it kills whatever process is
64
+ * still on record and is a no-op when nothing is running, so pid liveness is
65
+ * never reimplemented here.
66
+ *
67
+ * `callTool` is injected (the caller's MCP client), so this stays
68
+ * transport-agnostic and unit-testable without a live fleet server. When it
69
+ * is omitted, `killIfAlive()` is a no-op -- there is no live fleet connection
70
+ * to guard against, matching every other best-effort client in this file when
71
+ * its transport is absent.
72
+ *
73
+ * Best-effort by design: a `stop_prompt` failure is logged and swallowed
74
+ * rather than blocking the resume -- the resume is what the sprint needs to
75
+ * make progress, and this guard REDUCES rather than gates the chance of a
76
+ * duplicate concurrent session.
77
+ *
78
+ * @param {{ callTool?: (name: string, args: object) => Promise<any>, log?: Function }} opts
79
+ * @returns {{ killIfAlive: (member: string) => Promise<void> }}
80
+ */
81
+ export function createMemberSessionGuard(opts = {}) {
82
+ const { callTool, log = () => {} } = opts;
83
+ const active = typeof callTool === 'function';
84
+
85
+ return {
86
+ async killIfAlive(member) {
87
+ if (!active || !member) return;
88
+ try {
89
+ const result = await callTool('stop_prompt', { member_name: member });
90
+ log(`[member-session-guard] pre-resume stop_prompt for '${member}': ${resultText(result) || '(no detail)'}`);
91
+ } catch (err) {
92
+ log(`[member-session-guard] pre-resume stop_prompt for '${member}' failed (non-fatal; resume proceeds): ${err.message}`);
93
+ }
94
+ },
95
+ };
96
+ }
97
+
98
+ /**
99
+ * Best-effort provisions a member for unattended execution (`unattended:
100
+ * 'auto'`) before dispatching it as deployer, integ-test-runner, or
101
+ * regression-test-runner -- roles that run real deploy commands and test
102
+ * suites via a runbook and must never stall on an interactive permission
103
+ * prompt. Provisioning is a one-way member-registration change and is
104
+ * deliberately NOT reverted after the dispatch: `unattended` lives on the
105
+ * member (update_member), not on the dispatch, so there is nothing to revert
106
+ * to without also clobbering whatever the user set intentionally. In a
107
+ * single-member sprint the same member also plays doer/reviewer/etc, so it
108
+ * ends up unattended='auto' too -- accepted, not a bug.
109
+ *
110
+ * Cached per member for the lifetime of the returned function, so a sprint
111
+ * with many deploy/integ/regression dispatches across cycles calls
112
+ * update_member at most once per member. A failure (fleet unreachable,
113
+ * member not found) is logged and swallowed -- exactly like
114
+ * createMemberVcsProviderResolver above -- so a provisioning hiccup degrades
115
+ * to whatever permission mode the member already had, rather than aborting
116
+ * the phase.
117
+ *
118
+ * `callTool` is injected (the caller's MCP client), so this stays
119
+ * transport-agnostic and unit-testable without a live fleet server.
120
+ *
121
+ * @param {{ callTool: (name: string, args: object) => Promise<any>, log?: Function }} opts
122
+ * @returns {(member: string) => Promise<void>}
123
+ */
124
+ export function createUnattendedAutoProvisioner(opts = {}) {
125
+ const { callTool, log = () => {} } = opts;
126
+ const fleetApi = new ApraFleet({ callTool });
127
+ /** @type {Set<string>} members already confirmed unattended='auto' this run. */
128
+ const provisioned = new Set();
129
+
130
+ return async function ensureUnattendedAuto(member) {
131
+ if (provisioned.has(member)) return;
132
+ try {
133
+ await fleetApi.updateMember({ member_name: member, unattended: 'auto' });
134
+ provisioned.add(member);
135
+ log(`[unattended] member '${member}' set to unattended='auto' for this dispatch.`);
136
+ } catch (err) {
137
+ log(`[unattended] could not set unattended='auto' on member '${member}' (continuing with its existing permission mode): ${err.message}`);
138
+ }
139
+ };
140
+ }
141
+
142
+ /**
143
+ * Best-effort, self-heals the "Missing permission" class of deploy/integ/
144
+ * regression-test failure BEFORE it happens: reads deploy.md's own
145
+ * `## Permissions` section -- the exact list the deployer/integ-test-runner/
146
+ * regression-test-runner agent prompts already cross-check at their own
147
+ * Step 0a/0 -- and proactively grants every listed prefix to the target
148
+ * member via compose_permissions. Without this, a runbook permissions
149
+ * change (e.g. the `apra-fleet start` -> `apra-fleet run` swap, #395) only
150
+ * gets noticed when a dispatch fails, and only gets fixed once an operator
151
+ * greps deploy.md by hand and runs compose_permissions manually -- exactly
152
+ * the failure mode this closes the loop on.
153
+ *
154
+ * Reads deploy.md via `command()` against the FIRST target member it is asked
155
+ * to provision (that member is about to be dispatched as deployer/
156
+ * integ-test-runner/regression-test-runner, so its own checkout is the source
157
+ * of truth for what it is about to run) and caches the parsed prefix list for
158
+ * the lifetime of the returned function -- one read per sprint run, since
159
+ * deploy.md does not change mid-run on a healthy pipeline. Also caches per
160
+ * TARGET member, like createUnattendedAutoProvisioner above, so repeat cycles
161
+ * don't re-grant. Deliberately does NOT read via a separate orchestrator
162
+ * member: the orchestrator role may be shared/unreservable across concurrent
163
+ * sprints and carries no git checkout of its own to read from.
164
+ *
165
+ * Failure at any step (probe fails, deploy.md missing/unparseable,
166
+ * compose_permissions unreachable, a listed prefix hitting the
167
+ * NEVER_AUTO_GRANT denylist) is logged and swallowed. This is pure
168
+ * best-effort acceleration -- the deployer's own Step 0a check remains the
169
+ * authoritative, fail-closed backstop regardless of whether this succeeds.
170
+ *
171
+ * @param {{ callTool: (name: string, args: object) => Promise<any>, command: Function, log?: Function }} opts
172
+ * @returns {(member: string) => Promise<void>}
173
+ */
174
+ export function createDeployPermissionsProvisioner(opts = {}) {
175
+ const { callTool, command, log = () => {} } = opts;
176
+ const fleetApi = new ApraFleet({ callTool });
177
+ /** @type {Set<string>} members already granted deploy.md's permissions this run. */
178
+ const provisioned = new Set();
179
+ /** @type {string[] | null | undefined} undefined = not yet attempted. */
180
+ let cachedPrefixes;
181
+
182
+ async function loadRequiredPrefixes(targetMember) {
183
+ if (cachedPrefixes !== undefined) return cachedPrefixes;
184
+ try {
185
+ const res = await command(
186
+ `node -e "const fs=require('fs'); if(fs.existsSync('deploy.md')) process.stdout.write(fs.readFileSync('deploy.md','utf8'))"`,
187
+ { member_name: targetMember, silent: true, label: `Read deploy.md permissions`, failSoft: true },
188
+ );
189
+ if (!res.ok || !res.output) {
190
+ cachedPrefixes = null;
191
+ } else {
192
+ const section = res.output.split(/^## Permissions/m)[1]?.split(/^## /m)[0] ?? '';
193
+ const prefixes = [...section.matchAll(/^-\s*`([^`]+)`/gm)].map(m => m[1]);
194
+ cachedPrefixes = prefixes.length ? prefixes : null;
195
+ }
196
+ } catch (err) {
197
+ log(`[deploy-permissions] could not read deploy.md's Permissions section (continuing without auto-provisioning): ${err.message}`);
198
+ cachedPrefixes = null;
199
+ }
200
+ return cachedPrefixes;
201
+ }
202
+
203
+ return async function ensureDeployPermissions(member) {
204
+ if (!member || provisioned.has(member)) return;
205
+ const prefixes = await loadRequiredPrefixes(member);
206
+ if (!prefixes) return;
207
+ try {
208
+ const result = await fleetApi.composePermissions({
209
+ member_name: member,
210
+ role: 'doer',
211
+ grant: prefixes,
212
+ grant_reason: "deploy.md's declared Permissions section, auto-provisioned before dispatch",
213
+ });
214
+ provisioned.add(member);
215
+ log(`[deploy-permissions] ensured deploy.md's required permissions on '${member}': ${result}`);
216
+ } catch (err) {
217
+ log(`[deploy-permissions] could not auto-provision deploy.md permissions on '${member}' (continuing -- the deployer's own Step 0a check remains the backstop): ${err.message}`);
218
+ }
219
+ };
220
+ }
221
+
222
+ /**
223
+ * Sprint roles whose members get compose_permissions' read-mostly 'reviewer'
224
+ * profile. A member serving ANY other role (or a mix) gets 'doer', the
225
+ * superset, so re-composing never narrows what one of its roles needs.
226
+ */
227
+ export const PERMISSION_CONFIG_REVIEWER_ROLES = Object.freeze(['reviewer', 'plan-reviewer', 'ci-watcher']);
228
+ const REVIEWER_ROLE_SET = new Set(PERMISSION_CONFIG_REVIEWER_ROLES);
229
+
230
+ /**
231
+ * compose_permissions role for a member serving `roles`.
232
+ * @param {string[]} roles
233
+ * @returns {'doer'|'reviewer'}
234
+ */
235
+ export function composeRoleForRoles(roles) {
236
+ const list = (roles || []).filter(Boolean);
237
+ return list.length > 0 && list.every((r) => REVIEWER_ROLE_SET.has(r)) ? 'reviewer' : 'doer';
238
+ }
239
+
240
+ const PERMISSION_PROBE_TIMEOUT_S = 60;
241
+
242
+ function memberDetailJson(res) {
243
+ const text = resultText(res);
244
+ return JSON.parse(text);
245
+ }
246
+
247
+ // A compose_permissions result that reports failure in its text (the tool
248
+ // returns its refusals/delivery failures as a text result, not a throw).
249
+ function composeFailureText(res) {
250
+ if (res && typeof res === 'object' && res.isError) return resultText(res) || 'compose_permissions reported an error';
251
+ const text = resultText(res).trim();
252
+ if (/^(\u274c|\[FAIL\])/.test(text)) return text;
253
+ return null;
254
+ }
255
+
256
+ /**
257
+ * Member-init check for every dispatch member's composed per-folder
258
+ * permission config (a re-cloned work folder, `git clean -xdf` or a fresh
259
+ * worktree loses it, and the member's role then has its tool calls -- bd
260
+ * included -- refused as "requires approval" while member init still reports
261
+ * OK). For each member, BEFORE any dispatch:
262
+ *
263
+ * 1. read the provider's permission config file(s) from member_detail
264
+ * (`permissionConfigPaths`, straight from the member's ProviderAdapter --
265
+ * never assumed to be Claude's);
266
+ * 2. probe each work-folder-relative one with a per-OS/shell command
267
+ * (memberShell(member).fileExistsProbe -- never shell-level expansion);
268
+ * 3. if any is missing, call compose_permissions ONCE for the member's
269
+ * role (composeRoleForRoles) and re-probe;
270
+ * 4. still missing, compose failing, or a probe that cannot answer ->
271
+ * MemberPermissionConfigError naming member, file(s) and the fix.
272
+ *
273
+ * Present configs are left untouched (no compose call). Home-anchored paths
274
+ * ("~/...", agy) are not work-folder files: they are logged and left to
275
+ * compose_permissions/execute_prompt, which provision them. A server too old
276
+ * to report permissionConfigPaths is logged and that member is not checked.
277
+ *
278
+ * `ledgerFolderFor(member)` (optional) names the member's compose_permissions
279
+ * ledger folder; a re-compose passes it as project_folder so grants an
280
+ * earlier sprint's permission heal recorded there are restored too.
281
+ *
282
+ * @param {{ callTool: Function, command: Function, memberShell: (member: string) => Promise<{ fileExistsProbe: (relPath: string) => string }>, ledgerFolderFor?: (member: string) => string|undefined, log?: Function }} opts
283
+ * @returns {(memberRoles: Map<string, string[]>) => Promise<{ composed: string[] }>}
284
+ */
285
+ export function createPermissionConfigPreflight(opts = {}) {
286
+ const { callTool, command, memberShell, ledgerFolderFor = () => undefined, log = () => {} } = opts;
287
+ if (typeof callTool !== 'function') throw new TypeError('createPermissionConfigPreflight: callTool is required');
288
+ if (typeof command !== 'function') throw new TypeError('createPermissionConfigPreflight: command is required');
289
+ if (typeof memberShell !== 'function') throw new TypeError('createPermissionConfigPreflight: memberShell is required');
290
+ const fleetApi = new ApraFleet({ callTool });
291
+
292
+ const quoted = (files) => files.map((f) => "'" + f + "'").join(', ');
293
+ const fixFor = (member, role, files) =>
294
+ 'run compose_permissions for ' + member + ' with role ' + role + ', check ' + quoted(files) +
295
+ " exists in that member's workFolder, then rerun the sprint";
296
+
297
+ const fail = (member, role, files, cause, details) => new MemberPermissionConfigError(
298
+ "Member preflight failed: member '" + member + "' is missing its composed permission config " + quoted(files) + ' (' + cause + '). ' +
299
+ 'A role dispatched there would have its tool calls refused as requiring approval, so the sprint stops before any dispatch. ' +
300
+ `To fix: ${fixFor(member, role, files)}.`,
301
+ { member, files, role, details }
302
+ );
303
+
304
+ async function probe(member, role, shell, file) {
305
+ let cmd;
306
+ try {
307
+ cmd = shell.fileExistsProbe(file);
308
+ } catch (err) {
309
+ throw fail(member, role, [file], `no probe could be built for it: ${err.message}`, { step: 'probe' });
310
+ }
311
+ let res;
312
+ try {
313
+ res = await command(cmd, { member_name: member, silent: true, failSoft: true, timeout_s: PERMISSION_PROBE_TIMEOUT_S, label: `Probe permission config ${file}` });
314
+ } catch (err) {
315
+ res = { ok: false, error: err && err.message ? err.message : String(err) };
316
+ }
317
+ if (res && typeof res === 'object' && res.ok === false) {
318
+ throw fail(member, role, [file], `its probe failed: ${String(res.error || 'command failed').replace(/\s+/g, ' ').slice(0, 300)}`, { step: 'probe' });
319
+ }
320
+ const out = (res && typeof res === 'object') ? String(res.output ?? '') : String(res ?? '');
321
+ const last = out.replace(/\r\n/g, '\n').split('\n').map((l) => l.trim()).filter(Boolean).pop() || '';
322
+ if (last === FILE_PROBE_PRESENT) return true;
323
+ if (last === FILE_PROBE_ABSENT) return false;
324
+ throw fail(member, role, [file], `its probe answered '${last.slice(0, 120)}', not '${FILE_PROBE_PRESENT}'/'${FILE_PROBE_ABSENT}'`, { step: 'probe' });
325
+ }
326
+
327
+ return async function verifyPermissionConfigs(memberRoles) {
328
+ const composed = [];
329
+ for (const [member, roles] of memberRoles) {
330
+ const role = composeRoleForRoles(roles);
331
+ // Which files to check comes only from member_detail. When it
332
+ // cannot say (unreachable, unparseable, or an older server without
333
+ // the field) there is nothing to probe: that is a loud WARNING, and
334
+ // an unreachable member then fails at its own first dispatch.
335
+ let detail = null;
336
+ let detailError = null;
337
+ try {
338
+ detail = memberDetailJson(await fleetApi.memberDetail({ member_name: member, format: 'json' }));
339
+ } catch (err) {
340
+ detailError = err && err.message ? err.message : String(err);
341
+ }
342
+ const reported = detail && typeof detail === 'object' ? detail.permissionConfigPaths : undefined;
343
+ if (!Array.isArray(reported)) {
344
+ const why = detailError
345
+ ? 'member_detail could not be read (' + detailError.replace(/\s+/g, ' ').slice(0, 200) + ')'
346
+ : 'member_detail does not report permissionConfigPaths (older fleet server)';
347
+ log('[permission-config] WARNING: ' + why + " for member '" + member + "'; its composed permission config is not verified this sprint.");
348
+ continue;
349
+ }
350
+ const files = [];
351
+ for (const p of reported) {
352
+ const f = String(p || '');
353
+ if (!f) continue;
354
+ if (f.startsWith('~')) {
355
+ log(`[permission-config] member '${member}': '${f}' is home-anchored, not a workFolder file; left to compose_permissions/execute_prompt to provision.`);
356
+ continue;
357
+ }
358
+ files.push(f);
359
+ }
360
+ if (files.length === 0) continue;
361
+ const shell = await memberShell(member);
362
+ const missing = [];
363
+ for (const f of files) if (!(await probe(member, role, shell, f))) missing.push(f);
364
+ if (missing.length === 0) {
365
+ log(`[permission-config] member '${member}': composed permission config present (${files.join(', ')}).`);
366
+ continue;
367
+ }
368
+ log(`[permission-config] member '${member}' is missing its composed permission config (${missing.join(', ')}); re-composing it with compose_permissions role '${role}'.`);
369
+ let res;
370
+ try {
371
+ const ledger = ledgerFolderFor(member);
372
+ res = await fleetApi.composePermissions({ member_name: member, role, ...(ledger ? { project_folder: ledger } : {}) });
373
+ } catch (err) {
374
+ throw fail(member, role, missing, `compose_permissions failed: ${err && err.message ? err.message : err}`, { step: 'compose' });
375
+ }
376
+ const composeErr = composeFailureText(res);
377
+ if (composeErr) throw fail(member, role, missing, `compose_permissions failed: ${composeErr.replace(/\s+/g, ' ').slice(0, 300)}`, { step: 'compose' });
378
+ const still = [];
379
+ for (const f of missing) if (!(await probe(member, role, shell, f))) still.push(f);
380
+ if (still.length > 0) throw fail(member, role, still, 'it is still missing after compose_permissions', { step: 'verify' });
381
+ composed.push(member);
382
+ log(`[permission-config] member '${member}': permission config re-composed (${missing.join(', ')}).`);
383
+ }
384
+ return { composed };
385
+ };
386
+ }
387
+
388
+ // ---------------------------------------------------------------------------
389
+ // Mid-sprint permission-refusal heal (dispatch reason 'permission_denied')
390
+ // ---------------------------------------------------------------------------
391
+
392
+ /**
393
+ * The compose_permissions ledger folder (project_folder) for one member: a
394
+ * per-member folder under `baseDir` when given, else under the fleet server's
395
+ * data directory (APRA_FLEET_DATA_DIR, default ~/.apra-fleet/data) -- the
396
+ * same machine, since the server resolves project_folder on its own
397
+ * filesystem and the sprint engine runs beside it. compose_permissions
398
+ * creates the folder on its first grant. One folder per member keeps grants
399
+ * scoped to that member.
400
+ * @param {string} member
401
+ * @param {string} [baseDir]
402
+ * @returns {string|undefined}
403
+ */
404
+ export function permissionLedgerFolder(member, baseDir) {
405
+ if (!member) return undefined;
406
+ const root = baseDir || path.join(process.env.APRA_FLEET_DATA_DIR || path.join(os.homedir(), '.apra-fleet', 'data'), 'permission-ledgers');
407
+ // Member names may contain dots, even be all dots ('..'). The folder name
408
+ // therefore keeps only [A-Za-z0-9_-] -- no dot, no separator, so it can
409
+ // never traverse out of `root` -- plus a hash of the raw name, so two
410
+ // names that sanitize alike still get distinct folders.
411
+ const raw = String(member);
412
+ const safe = raw.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 64);
413
+ const hash = createHash('sha256').update(raw).digest('hex').slice(0, 12);
414
+ return path.join(root, `${safe}-${hash}`);
415
+ }
416
+
417
+ /** Heals per member per sprint. Each heal re-runs a whole role dispatch, and
418
+ * real denial sets name one or two distinct tools, so three progressive
419
+ * grants (A, then B, then C) cover the observed cases while bounding the
420
+ * re-dispatch cost of a member that keeps reaching for new tools. */
421
+ export const PERMISSION_HEAL_MEMBER_CAP = 3;
422
+ /** Heals within one dispatch ladder (one role dispatch and its retries): a
423
+ * single dispatch that needs a third new tool after two grants is more likely
424
+ * wandering than blocked, and the member cap still allows a later dispatch
425
+ * to heal. */
426
+ export const PERMISSION_HEAL_LADDER_CAP = 2;
427
+
428
+ // A grant payload with any of these can chain or substitute another command,
429
+ // so it is never in policy whatever the composed list says (compose_permissions
430
+ // refuses the same set as NEVER_AUTO_GRANT).
431
+ const GRANT_CHAIN_RE = /[|;&`<>]|\$\(/;
432
+
433
+ /** Splits `Tool(payload)`; a bare tool name has payload null. */
434
+ function splitRule(rule) {
435
+ const s = String(rule || '').trim();
436
+ const m = /^([A-Za-z_][\w.-]*)\((.*)\)$/s.exec(s);
437
+ return m ? { tool: m[1], payload: m[2].trim().replace(/\s+/g, ' ') } : { tool: s, payload: null };
438
+ }
439
+
440
+ /** The literal prefix a wildcard payload matches (`x:*` and `x *` both mean
441
+ * "x, then anything"; `x*` is a raw prefix), or null for an exact payload. */
442
+ function wildcardBase(payload) {
443
+ if (payload.endsWith(':*')) return { base: payload.slice(0, -2), word: true };
444
+ if (payload.endsWith(' *')) return { base: payload.slice(0, -2), word: true };
445
+ if (payload.endsWith('*')) return { base: payload.slice(0, -1), word: false };
446
+ return null;
447
+ }
448
+
449
+ /** True when payload rule `rule` allows the literal command line `cmd`. */
450
+ function bashRuleAllows(rule, cmd) {
451
+ const w = wildcardBase(rule);
452
+ if (!w) return rule === cmd;
453
+ return w.word ? (cmd === w.base || cmd.startsWith(w.base + ' ')) : cmd.startsWith(w.base);
454
+ }
455
+
456
+ /** True when payload rule `rule` allows everything payload `wanted` allows. */
457
+ function bashRuleCovers(rule, wanted) {
458
+ if (rule === wanted) return true;
459
+ const ww = wildcardBase(wanted);
460
+ if (!ww) return bashRuleAllows(rule, wanted);
461
+ const rw = wildcardBase(rule);
462
+ if (!rw) return false;
463
+ return rw.word ? (ww.base === rw.base || ww.base.startsWith(rw.base + ' ')) : ww.base.startsWith(rw.base);
464
+ }
465
+
466
+ /**
467
+ * True when the composed allow list `policy` already covers `grant` -- the
468
+ * code-level guard that keeps a heal inside what the user's role profile
469
+ * (plus detected stacks) grants. A bare tool name in the policy covers any
470
+ * scoped form of that tool; a Bash rule covers a grant only if it allows
471
+ * everything the grant would.
472
+ * @param {string} grant
473
+ * @param {string[]} policy
474
+ */
475
+ export function grantWithinPolicy(grant, policy) {
476
+ const g = splitRule(grant);
477
+ if (g.payload !== null && GRANT_CHAIN_RE.test(g.payload)) return false;
478
+ for (const raw of policy || []) {
479
+ const r = splitRule(raw);
480
+ if (r.tool !== g.tool) continue;
481
+ if (r.payload === null) return true;
482
+ if (g.payload === null) continue;
483
+ if (r.tool === 'Bash' ? bashRuleCovers(r.payload, g.payload) : r.payload === g.payload) return true;
484
+ }
485
+ return false;
486
+ }
487
+
488
+ /** True when an already-landed grant should have allowed this refused call. */
489
+ function grantAllowsCall(grant, item) {
490
+ const g = splitRule(grant);
491
+ // agy names a refused shell command 'command' or 'unsandboxed'; its
492
+ // grant is a Bash rule like Claude's.
493
+ const action = item.action === 'command' || item.action === 'unsandboxed' ? 'Bash' : item.action;
494
+ if (g.tool !== action) return false;
495
+ if (g.payload === null) return true;
496
+ if (typeof item.target !== 'string') return false;
497
+ const call = item.target.trim().replace(/\s+/g, ' ');
498
+ return g.tool === 'Bash' ? bashRuleAllows(g.payload, call) : g.payload === call;
499
+ }
500
+
501
+ const describeCall = (d) => (d.target ? `${d.action} "${d.target}"` : d.action);
502
+
503
+ /**
504
+ * Builds the dispatch engine's `onPermissionDenied` hook: a PROGRESSIVE heal
505
+ * of a member whose dispatch was refused tool calls for lack of a grant.
506
+ * Denied tool A -> grant A, retry; tool B denied next -> grant B, retry; it
507
+ * keeps going while each heal adds a grant that was not there before, and
508
+ * stops (healed: false, with a `step`) only when no progress is possible:
509
+ *
510
+ * not_healable the session ran in an auto/bypass permission mode: the
511
+ * refusal is the safety classifier or a deny rule, which no
512
+ * grant may override (only acceptEdits-mode sessions -- e.g.
513
+ * a model without auto support -- are healed), or the
514
+ * provider marked the denial cause 'policy_deny' (a tool the
515
+ * member's own config denies on purpose), in any mode;
516
+ * no_progress a call was refused again although a landed grant covers
517
+ * it (the grant did not take: something overrides it), a
518
+ * call maps to no grant, or a needed grant is outside the
519
+ * member's composed policy;
520
+ * cap PERMISSION_HEAL_MEMBER_CAP heals for this member this
521
+ * sprint, or PERMISSION_HEAL_LADDER_CAP in this ladder;
522
+ * heal compose_permissions failed or refused the grant (its
523
+ * NEVER_AUTO_GRANT floor); the grants are named.
524
+ *
525
+ * Security model: the member never grants itself anything -- the
526
+ * orchestrator grants on need, only grants the member's own composed policy
527
+ * already contains (compose_permissions dry_run for its role + stacks, not a
528
+ * hand-kept copy), and compose_permissions' NEVER_AUTO_GRANT floor still
529
+ * applies on the server.
530
+ *
531
+ * State is per sprint (this hook's lifetime) and per member: the grants that
532
+ * landed and the heal count. Only the member's FIRST heal re-composes its
533
+ * config from the role profile (restoring a config a re-clone dropped); later
534
+ * heals only ADD grants, because a proactive compose rewrites the allow list
535
+ * and would wipe the grants of earlier heals. Every grant is recorded in the
536
+ * member's ledger folder (`ledgerFolderFor`, passed as project_folder), so a
537
+ * later sprint's compose of that member keeps it.
538
+ *
539
+ * Resolves `{ healed, step?, composeRole, grants, rejectedGrants, reason }`;
540
+ * never throws. healed is true only when at least one new grant landed.
541
+ *
542
+ * @param {{ callTool: Function, memberRoles?: (member: string) => string[], ledgerFolderFor?: (member: string) => string|undefined, log?: Function }} opts
543
+ */
544
+ export function createPermissionDenialHeal(opts = {}) {
545
+ const { callTool, memberRoles = () => [], ledgerFolderFor = () => undefined, log = () => {} } = opts;
546
+ if (typeof callTool !== 'function') throw new TypeError('createPermissionDenialHeal: callTool is required');
547
+ const fleetApi = new ApraFleet({ callTool });
548
+
549
+ /** @type {Map<string, { granted: string[], healCount: number, recomposed: boolean, policy: Map<string, string[]> }>} */
550
+ const state = new Map();
551
+ const stateFor = (member) => {
552
+ if (!state.has(member)) state.set(member, { granted: [], healCount: 0, recomposed: false, policy: new Map() });
553
+ return state.get(member);
554
+ };
555
+
556
+ const compose = async (args) => {
557
+ let res;
558
+ try {
559
+ res = await fleetApi.composePermissions(args);
560
+ } catch (err) {
561
+ return { error: `compose_permissions failed: ${err && err.message ? err.message : err}`, res: null };
562
+ }
563
+ const failure = composeFailureText(res);
564
+ return failure
565
+ ? { error: `compose_permissions failed: ${failure.replace(/\s+/g, ' ').slice(0, 300)}`, res }
566
+ : { error: null, res };
567
+ };
568
+
569
+ const policyFor = async (member, st, composeRole) => {
570
+ if (st.policy.has(composeRole)) return { allow: st.policy.get(composeRole) };
571
+ const { error, res } = await compose({ member_name: member, role: composeRole, dry_run: true });
572
+ if (error) return { error };
573
+ let parsed = null;
574
+ try { parsed = JSON.parse(resultText(res)); } catch { /* checked below */ }
575
+ if (!parsed || parsed.dry_run !== true || !Array.isArray(parsed.allow)) {
576
+ return { error: 'compose_permissions dry_run did not return the composed allow list (fleet server too old?)' };
577
+ }
578
+ const allow = parsed.allow.filter((p) => typeof p === 'string');
579
+ st.policy.set(composeRole, allow);
580
+ return { allow };
581
+ };
582
+
583
+ return async function onPermissionDenied({ member, role, denial, ladderHeals = 0 }) {
584
+ const roles = [...new Set([...(memberRoles(member) || []), role].filter(Boolean))];
585
+ const composeRole = composeRoleForRoles(roles);
586
+ const st = stateFor(member);
587
+ const stop = (step, reason, rejectedGrants = []) => {
588
+ log(`[permission-heal] member '${member}' (${role}): not healed (${step}) -- ${reason}`);
589
+ return { healed: false, step, composeRole, grants: [], rejectedGrants, reason };
590
+ };
591
+
592
+ const items = denial && Array.isArray(denial.denials) ? denial.denials : [];
593
+ const what = items.length ? items.map(describeCall).join(', ') : ((denial && denial.actions.join(', ')) || 'unknown actions');
594
+
595
+ if (denial && denial.cause === 'policy_deny') {
596
+ return stop('not_healable', `${what} was refused by a deny rule the member's own permission config carries on purpose (a tool outside the member's allowlist); no grant is ever added for that.`);
597
+ }
598
+ if (denial && (denial.healable === false || denial.permissionMode === 'auto' || denial.permissionMode === 'bypassPermissions')) {
599
+ return stop('not_healable', `the session ran in ${denial.permissionMode || 'a non-healable'} permission mode, where ${what} was refused by the safety classifier or a deny rule; no grant is ever added for that.`);
600
+ }
601
+ if (st.healCount >= PERMISSION_HEAL_MEMBER_CAP) {
602
+ return stop('cap', `${st.healCount} permission heals already ran for this member this sprint (limit ${PERMISSION_HEAL_MEMBER_CAP}).`);
603
+ }
604
+ if (ladderHeals >= PERMISSION_HEAL_LADDER_CAP) {
605
+ return stop('cap', `${ladderHeals} permission heals already ran for this dispatch (limit ${PERMISSION_HEAL_LADDER_CAP}).`);
606
+ }
607
+ if (items.length === 0) return stop('no_progress', 'the refusal named no tool call to grant.');
608
+
609
+ // Refused again although a landed grant covers the call: the grant
610
+ // did not take (a deny rule or managed setting overrides it).
611
+ for (const item of items) {
612
+ const landed = st.granted.find((g) => grantAllowsCall(g, item));
613
+ if (landed) return stop('no_progress', `${describeCall(item)} was refused again after ${landed} was granted, so granting cannot fix it (a deny rule or managed setting likely overrides the grant).`);
614
+ }
615
+
616
+ const policy = await policyFor(member, st, composeRole);
617
+ if (policy.error) return stop('heal', policy.error);
618
+
619
+ const picked = new Set();
620
+ const alreadyGranted = new Set(st.granted);
621
+ const rejected = [];
622
+ for (const item of items) {
623
+ const options = Array.isArray(item.suggestedGrants) ? item.suggestedGrants : (denial.suggestedGrants || []);
624
+ if (options.length === 0) return stop('no_progress', `no compose_permissions grant maps to ${describeCall(item)} (e.g. a chained shell command).`);
625
+ const pick = options.find((g) => grantWithinPolicy(g, policy.allow));
626
+ if (!pick) { rejected.push(...options); continue; }
627
+ if (!alreadyGranted.has(pick)) picked.add(pick);
628
+ }
629
+ const newGrants = [...picked];
630
+ if (rejected.length) {
631
+ return stop('no_progress', `${[...new Set(rejected)].join(', ')} is outside the '${composeRole}' composed policy for this member; an operator must grant it deliberately.`, [...new Set(rejected)]);
632
+ }
633
+ if (newGrants.length === 0) return stop('no_progress', `every grant for ${what} is already in place.`);
634
+
635
+ const ledger = ledgerFolderFor(member);
636
+ const ledgerArg = ledger ? { project_folder: ledger } : {};
637
+ if (!st.recomposed) {
638
+ log(`[permission-heal] member '${member}' (${role}) was refused ${what}; re-composing its permissions with role '${composeRole}' (first heal this sprint).`);
639
+ const re = await compose({ member_name: member, role: composeRole, ...ledgerArg });
640
+ if (re.error) return stop('heal', re.error);
641
+ st.recomposed = true;
642
+ }
643
+ const granted = await compose({
644
+ member_name: member,
645
+ role: composeRole,
646
+ grant: newGrants,
647
+ grant_reason: `sprint ${role} dispatch was refused these tool calls`,
648
+ ...ledgerArg,
649
+ });
650
+ // A refused grant call (compose_permissions' NEVER_AUTO_GRANT floor,
651
+ // or a delivery failure -- its own message says which) lands nothing:
652
+ // stop and name the grants for an operator.
653
+ if (granted.error) return stop('heal', granted.error, newGrants);
654
+ st.granted.push(...newGrants);
655
+ st.healCount += 1;
656
+ log(`[permission-heal] member '${member}': granted ${newGrants.join(', ')} (heal ${st.healCount}/${PERMISSION_HEAL_MEMBER_CAP} this sprint).`);
657
+ return { healed: true, composeRole, grants: newGrants, rejectedGrants: [], reason: null };
658
+ };
659
+ }
660
+
661
+ /**
662
+ * Stage `content` to a fresh temp file ON THE MEMBER that will run the
663
+ * subsequent `bd` command, and return that MEMBER-LOCAL absolute path.
664
+ * `command()` may dispatch `bd` to a different machine than the workflow
665
+ * engine runs on, so a body file written to the engine host's own tmpdir
666
+ * would not exist where `bd --body-file` reads it. Staging via `command()`
667
+ * (member_name: member) guarantees the file lands on the SAME filesystem.
668
+ *
669
+ * The write is performed by a member-side `node` one-liner -- `node` is
670
+ * present on every fleet member -- and the recipe is shell-agnostic: it
671
+ * contains no `$`-expansion, backticks, template literals, or `%`-vars, so it
672
+ * is inert as syntax in POSIX shells, PowerShell, and cmd.exe alike.
673
+ * `content` is base64-encoded and passed as a SINGLE argv token whose
674
+ * alphabet (A-Za-z0-9+/=) is likewise inert in all of those shells, and node
675
+ * decodes it back to the exact literal bytes. This is the injection-safety
676
+ * property: caller-supplied free text is NEVER interpolated into the shell
677
+ * command string. The staged file is a member-side OS temp file the member's
678
+ * OS reaps on its own.
679
+ * @param {{ command: Function, member: string, content: string, label?: string }} opts
680
+ * @returns {Promise<string>} the MEMBER-LOCAL temp file path
681
+ */
682
+ export async function stageCommandBodyMemberSide({ command, member, content, label }) {
683
+ const b64 = Buffer.from(content, 'utf-8').toString('base64');
684
+ // No backticks / no `$` / no template literals: inert across POSIX,
685
+ // PowerShell, and cmd.exe. Reads the base64 body from argv[1] (the first
686
+ // arg after the `-e` script), decodes it to raw bytes, writes them to a
687
+ // fresh member-local temp file, and prints ONLY that path to stdout.
688
+ const stageScript =
689
+ "const os=require('os'),p=require('path'),fs=require('fs');" +
690
+ "const f=p.join(os.tmpdir(),'fleet-sprint-body-'+process.pid+'-'+Date.now()+'-'+Math.random().toString(36).slice(2)+'.txt');" +
691
+ "fs.writeFileSync(f,Buffer.from(process.argv[1],'base64'));process.stdout.write(f)";
692
+ const out = await command(
693
+ `node -e "${stageScript}" "${b64}"`,
694
+ { member_name: member, silent: true, label: label ?? 'Stage bd body file member-side' }
695
+ );
696
+ const staged = String(out ?? '').trim();
697
+ if (!staged) throw new Error('member-side body staging returned an empty path');
698
+ return staged;
699
+ }