@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
@@ -1,3 +1,4 @@
1
+ import { escapePowerShellArgInner } from '../utils/shell-escape.js';
1
2
  import { z } from 'zod';
2
3
  import fs from 'node:fs';
3
4
  import path from 'node:path';
@@ -9,8 +10,15 @@ const __dirname = dirname(__filename);
9
10
  import { getStrategy } from '../services/strategy.js';
10
11
  import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
11
12
  import { getProvider } from '../providers/index.js';
12
- import { seedWorkspaceTrust } from '../utils/workspace-trust.js';
13
+ import { seedWorkspaceTrust, workspaceTrustTransportFor, memberSecretFileChannelFor } from '../utils/workspace-trust.js';
14
+ import { perFolderMcpEntryNeeded, REMOTE_SESSION_MCP_FILE } from '../services/session-mcp-config.js';
15
+ import { memberMcpHeaders } from '../services/member-access-secret.js';
16
+ import { deleteMemberFile, ensureGitExcluded, memberMcpUrl, pruneLegacyMcpEntries, readMemberFile, quotePosixPath, quotePwshPath, MemberConfigError, MEMBER_MCP_SERVER_NAME, memberMcpAllowRules, readMemberJson, removeGitExcluded, writeMemberJson, } from '../services/member-config-io.js';
13
17
  import { getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
18
+ import { ensureAgyProject } from '../services/agy-project.js';
19
+ import { getMemberHomeDir } from '../services/member-home.js';
20
+ import { recordFleetMcpStatus, getAgent, updateAgent } from '../services/registry.js';
21
+ import { getProviderInstallConfig, INSTALLABLE_LLM_PROVIDERS, readInstallConfig } from '../cli/config.js';
14
22
  export const composePermissionsSchema = z.object({
15
23
  ...memberIdentifier,
16
24
  role: z.enum(['doer', 'reviewer']).optional().describe('Role determines base profile (doer = broad build/test, reviewer = read + feedback + test). The hard-rejected NEVER_AUTO_GRANT patterns are wildcard-matched (not exact-matched) against a normalized form of each request and cover sudo/su/doas, `bash -c`/`sh -c`/eval, env/printenv, nc/nmap, `chmod 777`, any catch-all such as Bash(*), and any payload containing a shell-chaining metacharacter (| ; && backtick $(). Provide at least one of role or tags.'),
@@ -18,7 +26,20 @@ export const composePermissionsSchema = z.object({
18
26
  project_folder: z.string().optional().describe('Local project folder containing permissions.json ledger. Omit to skip ledger merge.'),
19
27
  grant: z.array(z.string()).optional().describe('Reactive mode: additional permissions to grant (e.g. ["Bash(docker:*)", "Bash(docker-compose:*)"]). Appended to current permissions and re-delivered.'),
20
28
  grant_reason: z.string().optional().describe('Reason for the grant (stored in ledger)'),
29
+ dry_run: z.boolean().optional().describe('Compose only: return the allow list the role/tags (plus detected stacks, plus the ledger when project_folder is given) would deliver, as JSON text {"dry_run":true,"mode","stacks","allow"}, without writing anything to the member. Ignored with grant. Use it to check whether a grant is within the member\'s composed policy.'),
21
30
  });
31
+ // my-beads-db-27m.27: these are quick local filesystem probes (mkdir/cat/echo/
32
+ // PowerShell one-liners) that normally complete in milliseconds under
33
+ // LocalStrategy, but under full-suite parallel test load the host can be too
34
+ // contended to even schedule the spawned shell for several seconds -- and
35
+ // since none of these commands stream progress output, that whole stall
36
+ // counts as "inactivity" against strategy.ts's rolling inactivity timer
37
+ // (LocalStrategy.execCommand's resetInactivityTimer/settle). The old 5000ms
38
+ // value fired spuriously under that contention (register-member.test.ts AC3);
39
+ // 15000ms leaves real headroom for host contention while still being a hard,
40
+ // killable ceiling -- not a bump to vitest's own per-test timeout, and not a
41
+ // removal of the inactivity ceiling itself.
42
+ const LOCAL_FS_OP_TIMEOUT_MS = 15000;
22
43
  // Stack marker files -> profile keys
23
44
  const STACK_MAP = {
24
45
  'package.json': 'node',
@@ -82,6 +103,11 @@ function matchesDenyPattern(pattern, permission) {
82
103
  const regex = new RegExp(`^${pattern.split('*').map(escapeRegExpExceptStar).join('.*')}$`);
83
104
  return regex.test(permission);
84
105
  }
106
+ /** True for a config path anchored at the MEMBER's home directory rather than
107
+ * at its work folder (see resolveRemotePath). */
108
+ function isHomeAnchored(configPath) {
109
+ return configPath.startsWith('~/') || configPath.startsWith('~\\');
110
+ }
85
111
  /** Splits `Tool(payload)` into its parts; returns null for a bare tool name. */
86
112
  function splitPermission(permission) {
87
113
  const m = /^([A-Za-z_][A-Za-z0-9_-]*)\((.*)\)$/.exec(permission.trim());
@@ -124,27 +150,65 @@ export function isNeverAutoGrant(permission) {
124
150
  // 3. Explicit deny patterns (wildcard-aware).
125
151
  return NEVER_AUTO_GRANT_PATTERNS.some(pattern => matchesDenyPattern(pattern, normalized));
126
152
  }
127
- function findProfilesDir() {
128
- // Installed: ~/.claude/skills/fleet/profiles/ (new location after skill split)
129
- const installedFleet = path.join(os.homedir(), '.claude', 'skills', 'fleet', 'profiles');
130
- if (fs.existsSync(installedFleet))
131
- return installedFleet;
153
+ function isCompleteProfilesDir(profilesDir) {
154
+ try {
155
+ return ['base-dev.json', 'base-reviewer.json']
156
+ .every(file => fs.statSync(path.join(profilesDir, file)).isFile());
157
+ }
158
+ catch {
159
+ return false;
160
+ }
161
+ }
162
+ export function findProfilesDir(homeDir = os.homedir(), startDir = __dirname) {
163
+ const searched = [];
164
+ const installConfig = readInstallConfig(path.join(homeDir, '.apra-fleet', 'data', 'install-config.json'));
165
+ const providerIndex = new Map(INSTALLABLE_LLM_PROVIDERS.map((provider, index) => [provider, index]));
166
+ const installedProviders = Object.entries(installConfig.providers)
167
+ .filter(([provider, config]) => providerIndex.has(provider) && config !== null && typeof config === 'object')
168
+ .map(([provider, config]) => ({
169
+ provider: provider,
170
+ installedAt: typeof config.installedAt === 'string' ? Date.parse(config.installedAt) : NaN,
171
+ }))
172
+ .sort((a, b) => {
173
+ const aValid = !Number.isNaN(a.installedAt);
174
+ const bValid = !Number.isNaN(b.installedAt);
175
+ if (aValid !== bValid)
176
+ return aValid ? -1 : 1;
177
+ if (aValid && a.installedAt !== b.installedAt)
178
+ return b.installedAt - a.installedAt;
179
+ return providerIndex.get(a.provider) - providerIndex.get(b.provider);
180
+ })
181
+ .map(({ provider }) => provider);
182
+ const installedSet = new Set(installedProviders);
183
+ const providers = [
184
+ ...installedProviders,
185
+ ...INSTALLABLE_LLM_PROVIDERS.filter(provider => !installedSet.has(provider)),
186
+ ];
187
+ for (const provider of providers) {
188
+ const candidate = path.join(getProviderInstallConfig(provider, homeDir).fleetSkillsDir, 'profiles');
189
+ searched.push(candidate);
190
+ if (isCompleteProfilesDir(candidate))
191
+ return candidate;
192
+ }
132
193
  // Installed (legacy): ~/.claude/skills/pm/profiles/
133
- const installedPm = path.join(os.homedir(), '.claude', 'skills', 'pm', 'profiles');
134
- if (fs.existsSync(installedPm))
194
+ const installedPm = path.join(homeDir, '.claude', 'skills', 'pm', 'profiles');
195
+ searched.push(installedPm);
196
+ if (isCompleteProfilesDir(installedPm))
135
197
  return installedPm;
136
198
  // Dev: walk up from __dirname looking for skills/fleet/profiles/
137
- let dir = __dirname;
199
+ let dir = startDir;
138
200
  for (let i = 0; i < 6; i++) {
139
201
  const candidateFleet = path.join(dir, 'skills', 'fleet', 'profiles');
140
- if (fs.existsSync(candidateFleet))
202
+ searched.push(candidateFleet);
203
+ if (isCompleteProfilesDir(candidateFleet))
141
204
  return candidateFleet;
142
205
  const candidatePm = path.join(dir, 'skills', 'pm', 'profiles');
143
- if (fs.existsSync(candidatePm))
206
+ searched.push(candidatePm);
207
+ if (isCompleteProfilesDir(candidatePm))
144
208
  return candidatePm;
145
209
  dir = path.dirname(dir);
146
210
  }
147
- throw new Error('Cannot find profiles directory');
211
+ throw new Error(`No complete profiles directory (base-dev.json + base-reviewer.json) found. Searched: ${searched.join(', ')}`);
148
212
  }
149
213
  function loadProfile(profilesDir, name) {
150
214
  const filePath = path.join(profilesDir, `${name}.json`);
@@ -161,39 +225,99 @@ function loadLedger(projectFolder) {
161
225
  return { stacks: [], granted: [] };
162
226
  }
163
227
  function saveLedger(projectFolder, ledger) {
228
+ // A caller may name a ledger folder that does not exist yet (fleet-sprint
229
+ // keeps one per member so grants survive into the next sprint).
230
+ fs.mkdirSync(projectFolder, { recursive: true });
164
231
  const ledgerPath = path.join(projectFolder, 'permissions.json');
165
232
  fs.writeFileSync(ledgerPath, JSON.stringify(ledger, null, 2) + '\n');
166
233
  }
167
234
  async function detectStacks(agent, projectSubdir) {
235
+ const found = new Set();
236
+ if (agent.agentType === 'local') {
237
+ let localDir = agent.workFolder;
238
+ if (projectSubdir) {
239
+ const subDir = path.join(agent.workFolder, projectSubdir);
240
+ if (fs.existsSync(subDir)) {
241
+ localDir = subDir;
242
+ }
243
+ }
244
+ try {
245
+ if (fs.existsSync(localDir)) {
246
+ for (const [marker, stack] of Object.entries(STACK_MAP)) {
247
+ if (fs.existsSync(path.join(localDir, marker))) {
248
+ found.add(stack);
249
+ }
250
+ }
251
+ const entries = fs.readdirSync(localDir);
252
+ for (const entry of entries) {
253
+ if (entry.endsWith('.sln') || entry.endsWith('.csproj')) {
254
+ found.add('dotnet');
255
+ break;
256
+ }
257
+ }
258
+ }
259
+ }
260
+ catch {
261
+ // directory missing or unreadable
262
+ }
263
+ return [...found];
264
+ }
168
265
  const strategy = getStrategy(agent);
169
266
  const markers = Object.keys(STACK_MAP).join(' ');
170
267
  // Resolve the directory to check on the member: prefer <workFolder>/<projectSubdir>,
171
268
  // fall back to workFolder root. Using an absolute cd ensures remote (SSH) members
172
269
  // check the right directory instead of defaulting to their home directory.
270
+ const rootDir = agent.workFolder.replace(/\\/g, '/');
173
271
  const checkDir = projectSubdir
174
272
  ? `${agent.workFolder}/${projectSubdir}`.replace(/\\/g, '/')
175
- : agent.workFolder.replace(/\\/g, '/');
176
- // TODO: unbranched POSIX && / || / 2>/dev/null -- same defect class as
177
- // orphan-recovery.ts's pid-alive/file-read commands (apra-fleet review,
178
- // fix/cross-shell-home-var). Not yet OS-branched for Windows members.
179
- const result = await strategy.execCommand(`cd "${checkDir}" 2>/dev/null && ls ${markers} 2>/dev/null || true`, 10000);
180
- const found = new Set();
181
- for (const line of result.stdout.split('\n')) {
182
- const file = line.trim();
183
- if (STACK_MAP[file])
184
- found.add(STACK_MAP[file]);
185
- }
186
- // .sln/.csproj need glob - check separately
187
- // TODO: same unbranched-POSIX defect class as above -- not yet OS-branched.
188
- const dotnetCheck = await strategy.execCommand(`cd "${checkDir}" 2>/dev/null && ls *.sln *.csproj 2>/dev/null || true`, 5000);
189
- if (dotnetCheck.stdout.trim())
190
- found.add('dotnet');
273
+ : rootDir;
274
+ // The fallback to the work folder root is real: `cd <sub> || cd <root>`.
275
+ // A project_folder whose basename is not a subfolder of the work folder
276
+ // (e.g. a ledger folder kept elsewhere) used to detect NO stacks at all and
277
+ // silently drop the stack grants (npm/node/...) from the composed config.
278
+ const cdCmd = checkDir === rootDir
279
+ ? `cd "${rootDir}" 2>/dev/null`
280
+ : `{ cd "${checkDir}" 2>/dev/null || cd "${rootDir}" 2>/dev/null; }`;
281
+ const isWindows = agent.os === 'windows';
282
+ const shell = getAgentShell(agent);
283
+ const posix = isPosixShell(isWindows, shell);
284
+ if (posix) {
285
+ const result = await strategy.execCommand(`${cdCmd} && ls ${markers} 2>/dev/null || true`, 10000);
286
+ for (const line of result.stdout.split('\n')) {
287
+ const file = line.trim();
288
+ if (STACK_MAP[file])
289
+ found.add(STACK_MAP[file]);
290
+ }
291
+ const dotnetCheck = await strategy.execCommand(`${cdCmd} && ls *.sln *.csproj 2>/dev/null || true`, LOCAL_FS_OP_TIMEOUT_MS);
292
+ if (dotnetCheck.stdout.trim())
293
+ found.add('dotnet');
294
+ }
295
+ else {
296
+ // Windows PowerShell remote member: Get-ChildItem to enumerate files
297
+ const winDir = checkDir.replace(/\//g, '\\');
298
+ const winRootDir = rootDir.replace(/\//g, '\\');
299
+ const pathsToCheck = checkDir === rootDir
300
+ ? `'${escapePowerShellArgInner(winRootDir)}'`
301
+ : `'${escapePowerShellArgInner(winDir)}', '${escapePowerShellArgInner(winRootDir)}'`;
302
+ const psCmd = `Get-ChildItem -LiteralPath @(${pathsToCheck}) -File -ErrorAction SilentlyContinue | ForEach-Object { $_.Name }`;
303
+ const result = await strategy.execCommand(psCmd, 10000);
304
+ for (const line of result.stdout.split(/\r?\n/)) {
305
+ const file = line.trim();
306
+ if (STACK_MAP[file])
307
+ found.add(STACK_MAP[file]);
308
+ if (file.endsWith('.sln') || file.endsWith('.csproj'))
309
+ found.add('dotnet');
310
+ }
311
+ }
191
312
  return [...found];
192
313
  }
193
314
  function compose(profilesDir, role, stacks, ledger) {
194
315
  const baseName = role === 'doer' ? 'base-dev' : 'base-reviewer';
195
316
  const base = loadProfile(profilesDir, baseName);
196
317
  const perms = new Set(base?.permissions?.allow ?? []);
318
+ // Every member-allowlisted fleet tool (kb_*, code_*, ...): see memberMcpAllowRules.
319
+ for (const rule of memberMcpAllowRules())
320
+ perms.add(rule);
197
321
  const roleKey = role === 'doer' ? 'dev' : 'reviewer';
198
322
  for (const stack of stacks) {
199
323
  const profile = loadProfile(profilesDir, stack);
@@ -229,6 +353,9 @@ function composeFromTags(profilesDir, mode, tags, stacks, ledger) {
229
353
  const baseName = mode === 'doer' ? 'base-dev' : 'base-reviewer';
230
354
  const base = loadProfile(profilesDir, baseName);
231
355
  const perms = new Set(base?.permissions?.allow ?? []);
356
+ // Every member-allowlisted fleet tool (kb_*, code_*, ...): see memberMcpAllowRules.
357
+ for (const rule of memberMcpAllowRules())
358
+ perms.add(rule);
232
359
  const profileKey = mode === 'doer' ? 'dev' : 'reviewer';
233
360
  // Stack profiles (detected from the project), keyed by mode
234
361
  for (const stack of stacks) {
@@ -277,6 +404,74 @@ export function deepMerge(target, source) {
277
404
  }
278
405
  return result;
279
406
  }
407
+ /** deepMerge, except that an array present on both sides becomes the union of
408
+ * the two (existing entries first, then new ones not already present). Used
409
+ * for agy's reactive grant, which must add rules to the project file's allow
410
+ * list without discarding the ones compose_permissions wrote before. */
411
+ export function deepMergeUnion(target, source) {
412
+ const result = { ...target };
413
+ for (const [key, value] of Object.entries(source)) {
414
+ const current = result[key];
415
+ if (isPlainObject(value) && isPlainObject(current)) {
416
+ result[key] = deepMergeUnion(current, value);
417
+ }
418
+ else if (Array.isArray(value) && Array.isArray(current)) {
419
+ const merged = [...current];
420
+ for (const v of value) {
421
+ if (!merged.some(m => stableStringify(m) === stableStringify(v)))
422
+ merged.push(v);
423
+ }
424
+ result[key] = merged;
425
+ }
426
+ else {
427
+ result[key] = value;
428
+ }
429
+ }
430
+ return result;
431
+ }
432
+ /** A deny rule fleet derives for the member's own apra-fleet server (claude's
433
+ * mcp__apra-fleet__<tool>, agy's mcp(apra-fleet/<tool>)). Only these may be
434
+ * dropped from an existing deny list, and only when compose no longer derives
435
+ * them (the tool joined the member allowlist) -- they are fleet's to retire. */
436
+ function isFleetDerivedDenyRule(rule) {
437
+ return typeof rule === 'string'
438
+ && (rule.startsWith(`mcp__${MEMBER_MCP_SERVER_NAME}__`) || rule.startsWith(`mcp(${MEMBER_MCP_SERVER_NAME}/`));
439
+ }
440
+ /** Union of an existing deny list and the one compose derives: every existing
441
+ * rule is kept in its order (a user-authored rule is never dropped), new
442
+ * rules are appended, and the only rules removed are fleet-derived ones
443
+ * compose no longer derives (isFleetDerivedDenyRule). */
444
+ export function mergeDenyRules(existing, composed) {
445
+ const composedKeys = new Set(composed.map(r => stableStringify(r)));
446
+ const kept = existing.filter(r => !isFleetDerivedDenyRule(r) || composedKeys.has(stableStringify(r)));
447
+ const merged = [...kept];
448
+ for (const r of composed) {
449
+ if (!merged.some(m => stableStringify(m) === stableStringify(r)))
450
+ merged.push(r);
451
+ }
452
+ return merged;
453
+ }
454
+ /** deepMerge (arrays replace) for every key except a `deny` array present on
455
+ * both sides, which is merged with mergeDenyRules -- so a proactive compose,
456
+ * which resets `allow` to the composed profile, never discards a deny rule
457
+ * the user added to the same file (claude permissions.deny, agy
458
+ * permissionGrants.deny, copilot tools.deny). */
459
+ export function deepMergeKeepDeny(target, source) {
460
+ const result = { ...target };
461
+ for (const [key, value] of Object.entries(source)) {
462
+ const current = result[key];
463
+ if (isPlainObject(value) && isPlainObject(current)) {
464
+ result[key] = deepMergeKeepDeny(current, value);
465
+ }
466
+ else if (key === 'deny' && Array.isArray(value) && Array.isArray(current)) {
467
+ result[key] = mergeDenyRules(current, value);
468
+ }
469
+ else {
470
+ result[key] = value;
471
+ }
472
+ }
473
+ return result;
474
+ }
280
475
  /** Raised by deliverConfigFile when a config write does not verifiably land on
281
476
  * the member (nonzero mkdir/write exit, or a read-back that does not match the
282
477
  * intended content). Carries the target path so the caller can surface exactly
@@ -336,7 +531,20 @@ function stableStringify(value) {
336
531
  * <workFolder>/.claude/settings.local.json -- the read-back verification
337
532
  * passed because it re-read the same (wrong) relative path it had just
338
533
  * written, so the mismatch was invisible to that check alone. */
339
- function resolveRemotePath(workFolder, relPath, isWindows, shell) {
534
+ function resolveRemotePath(workFolder, relPath, isWindows, shell, homeDir) {
535
+ // A "~/"-prefixed config path is HOME-anchored on the MEMBER, not relative to
536
+ // its work folder. AGY needs this: the member's project file lives at
537
+ // ~/.gemini/config/projects/<agyProjectId>.json, not under the work folder
538
+ // (see AgyProvider.permissionConfigPaths).
539
+ // `homeDir` is resolved in JavaScript by the caller via getMemberHomeDir --
540
+ // never emitted as a literal "~/" or "$HOME" for the member's shell to
541
+ // expand, because that member's shell may be PowerShell.
542
+ if (relPath.startsWith('~/') || relPath.startsWith('~\\')) {
543
+ if (!homeDir) {
544
+ throw new ConfigDeliveryError(relPath, 'config path is home-anchored but the member\'s home directory could not be resolved');
545
+ }
546
+ return resolveRemotePath(homeDir, relPath.slice(2), isWindows, shell);
547
+ }
340
548
  if (isWindows) {
341
549
  const base = workFolder.replace(/[\\/]+$/, '').replace(/\//g, '\\');
342
550
  const winPath = `${base}\\${relPath.replace(/\//g, '\\')}`;
@@ -352,27 +560,30 @@ function resolveRemotePath(workFolder, relPath, isWindows, shell) {
352
560
  const base = workFolder.replace(/\/+$/, '');
353
561
  return `${base}/${relPath}`;
354
562
  }
355
- async function deliverConfigFile(strategy, agentOs, workFolder, filePath, content, shell) {
563
+ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, content, shell, homeDir, opts = {}) {
356
564
  const isWindows = agentOs === 'windows';
357
565
  const posix = isPosixShell(isWindows, shell);
358
- const absPath = resolveRemotePath(workFolder, filePath, isWindows, shell);
566
+ const absPath = resolveRemotePath(workFolder, filePath, isWindows, shell, homeDir);
359
567
  const winPath = absPath.replace(/\//g, '\\');
360
568
  const dir = posix
361
569
  ? absPath.split('/').slice(0, -1).join('/')
362
570
  : winPath.split('\\').slice(0, -1).join('\\');
571
+ // Paths are quoted per shell so a $, backtick or quote in a real path name is
572
+ // passed through verbatim, never interpolated by the member's shell.
573
+ const qPath = posix ? quotePosixPath(absPath) : quotePwshPath(winPath);
363
574
  const mkdirCmd = posix
364
- ? `mkdir -p "${dir}"`
365
- : `New-Item -ItemType Directory -Force "${dir}"`;
366
- const mkdirResult = await strategy.execCommand(mkdirCmd, 5000);
575
+ ? `mkdir -p ${quotePosixPath(dir)}`
576
+ : `New-Item -ItemType Directory -Force ${quotePwshPath(dir)}`;
577
+ const mkdirResult = await strategy.execCommand(mkdirCmd, LOCAL_FS_OP_TIMEOUT_MS);
367
578
  if (mkdirResult.code !== 0) {
368
579
  throw new ConfigDeliveryError(absPath, `could not create parent directory "${dir}" (exit ${mkdirResult.code})${stderrExcerpt(mkdirResult.stderr)}`);
369
580
  }
370
581
  const readCmd = posix
371
- ? `cat "${absPath}" 2>/dev/null || true`
372
- : `Get-Content -Raw "${winPath}" -ErrorAction SilentlyContinue`;
582
+ ? `cat ${qPath} 2>/dev/null || true`
583
+ : `Get-Content -Raw ${qPath} -ErrorAction SilentlyContinue`;
373
584
  let mergedContent = content;
374
585
  if (isPlainObject(content)) {
375
- const readResult = await strategy.execCommand(readCmd, 5000);
586
+ const readResult = await strategy.execCommand(readCmd, LOCAL_FS_OP_TIMEOUT_MS);
376
587
  let existing = {};
377
588
  try {
378
589
  const parsed = JSON.parse(readResult.stdout.trim());
@@ -382,15 +593,20 @@ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, conten
382
593
  catch {
383
594
  // file missing, empty, or not JSON -- start from an empty object
384
595
  }
385
- mergedContent = deepMerge(existing, content);
596
+ // Drop the superseded fleet MCP entries (the old blanket
597
+ // mcpServers['apra-fleet'] {disabled:true} switch and the retired
598
+ // apra-fleet-member url+bearer entry) before merging -- deepMerge alone
599
+ // would preserve them forever.
600
+ pruneLegacyMcpEntries(existing);
601
+ mergedContent = opts.unionArrays ? deepMergeUnion(existing, content) : deepMergeKeepDeny(existing, content);
386
602
  }
387
603
  const contentStr = typeof mergedContent === 'string'
388
604
  ? mergedContent
389
605
  : JSON.stringify(mergedContent, null, 2);
390
606
  const writeCmd = posix
391
- ? `cat > "${absPath}" << 'FLEET_PERMS_EOF'\n${contentStr}\nFLEET_PERMS_EOF`
392
- : `[System.IO.File]::WriteAllText("${winPath}", '${contentStr.replace(/'/g, "''")}', (New-Object System.Text.UTF8Encoding($false)))`;
393
- const writeResult = await strategy.execCommand(writeCmd, 5000);
607
+ ? `cat > ${qPath} << 'FLEET_PERMS_EOF'\n${contentStr}\nFLEET_PERMS_EOF`
608
+ : `[System.IO.File]::WriteAllText(${qPath}, '${escapePowerShellArgInner(contentStr)}', (New-Object System.Text.UTF8Encoding($false)))`;
609
+ const writeResult = await strategy.execCommand(writeCmd, LOCAL_FS_OP_TIMEOUT_MS);
394
610
  if (writeResult.code !== 0) {
395
611
  throw new ConfigDeliveryError(absPath, `write command failed (exit ${writeResult.code})${stderrExcerpt(writeResult.stderr)}`);
396
612
  }
@@ -398,7 +614,7 @@ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, conten
398
614
  // catches the silent no-op class of failure that a nonzero exit code alone
399
615
  // would miss (e.g. a write that "succeeds" but resolves to the wrong path, or
400
616
  // a PowerShell quoting fault that writes nothing).
401
- const verifyResult = await strategy.execCommand(readCmd, 5000);
617
+ const verifyResult = await strategy.execCommand(readCmd, LOCAL_FS_OP_TIMEOUT_MS);
402
618
  const readBack = verifyResult.stdout.trim();
403
619
  if (!readBack) {
404
620
  throw new ConfigDeliveryError(absPath, `read-back verification failed: file is empty or missing after a write that reported success`);
@@ -421,6 +637,320 @@ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, conten
421
637
  }
422
638
  }
423
639
  }
640
+ /** fleetMcp unavailable reasons that only describe the per-folder member MCP
641
+ * entry compose writes -- a later successful compose has fixed exactly that,
642
+ * so it clears them. Install/session reasons are left for a real re-probe. */
643
+ const COMPOSE_OWNED_FLEET_MCP_REASONS = new Set([
644
+ 'member-config-unreadable',
645
+ 'member-config-unparseable',
646
+ 'opencode-config-tracked',
647
+ 'opencode-config-unparseable',
648
+ 'mcp-entry-missing',
649
+ ]);
650
+ /** Plain-words cause for a MemberConfigError reason (compose output). */
651
+ function memberConfigWhy(reason) {
652
+ if (reason.endsWith('-tracked'))
653
+ return 'tracked by git';
654
+ if (reason.endsWith('-unparseable'))
655
+ return 'not strict JSON';
656
+ if (reason.endsWith('-unreadable'))
657
+ return 'unreadable';
658
+ return reason;
659
+ }
660
+ /**
661
+ * Writes the member's per-folder apra-fleet MCP entry (?member=<uuid>) through
662
+ * the provider's own mechanism, prunes legacy entries, and keeps every
663
+ * work-folder file compose wrote out of the clone's `git status` via
664
+ * .git/info/exclude (never a tracked file such as .gitignore or .mcp.json).
665
+ * - a member config it cannot safely edit (tracked, unparseable, unreadable)
666
+ * is RECOVERABLE: nothing is written to it, the member's fleetMcp status is
667
+ * recorded unavailable with the reason, and `note` says why;
668
+ * - on success, a previously recorded fleetMcp unavailable status that only
669
+ * described this entry (COMPOSE_OWNED_FLEET_MCP_REASONS) is cleared.
670
+ */
671
+ async function syncMemberMcpConfig(agent, provider, strategy, permissionPaths, memberHomeDir) {
672
+ const agentOs = (agent.os ?? 'linux');
673
+ const shell = getAgentShell(agent);
674
+ const exec = (cmd, t) => strategy.execCommand(cmd, t);
675
+ const workFolderFiles = permissionPaths.filter(p => !isHomeAnchored(p));
676
+ // A remote member's per-dispatch session MCP config lives in the work
677
+ // folder while a session runs: keep it out of `git status` (and out of a
678
+ // role's `git add -A`). Listed before the sync so the recoverable
679
+ // member-config error path below excludes it too.
680
+ if (agent.agentType !== 'local' && provider.mcpConfigFlag)
681
+ workFolderFiles.push(REMOTE_SESSION_MCP_FILE);
682
+ let noMemberInstall = false;
683
+ try {
684
+ // A local claude member gets the member config per dispatch session
685
+ // (--mcp-config), so no folder entry is written for it: the sync runs in
686
+ // remove mode instead, pruning legacy entries and a folder entry an older
687
+ // compose wrote for THIS member (so the human's own sessions in that
688
+ // clone get their user-scope server back), and nothing else.
689
+ let perFolder = perFolderMcpEntryNeeded(agent);
690
+ if (provider.syncMemberMcpEntry) {
691
+ // The member MCP wiring touches home-anchored files too (~/.claude.json,
692
+ // agy/opencode global MCP configs), so resolve the home here when the
693
+ // permission paths did not already need it.
694
+ const homeDir = memberHomeDir ?? await getMemberHomeDir(agent);
695
+ // A remote member with no apra-fleet MEMBER install (fleet_install
696
+ // "skip", a full install, or none at all) has no server that would
697
+ // accept ?member=<uuid>: write no entry there, and remove one an earlier
698
+ // compose wrote for this member (any other apra-fleet entry, e.g. the
699
+ // owner's full install, is left alone). The marker probe is built for
700
+ // the member's own OS/shell. A failed probe keeps the previous behaviour.
701
+ if (perFolder && agent.agentType !== 'local' && homeDir) {
702
+ const { probeMemberInstallMarker } = await import('../services/member-fleet-install.js');
703
+ const marker = await probeMemberInstallMarker(agent, homeDir, { exec: (_a, cmd, t) => exec(cmd, t) });
704
+ if (marker.kind === 'absent') {
705
+ perFolder = false;
706
+ noMemberInstall = true;
707
+ }
708
+ }
709
+ const result = await provider.syncMemberMcpEntry({
710
+ agent,
711
+ execCommand: exec,
712
+ memberHomeDir: homeDir,
713
+ agentOs,
714
+ shell,
715
+ transport: workspaceTrustTransportFor(agent, strategy),
716
+ secretChannel: memberSecretFileChannelFor(agent),
717
+ url: perFolder ? memberMcpUrl(agent) : null,
718
+ // The member install's access secret: its server refuses a ?member=
719
+ // session without it. Written only through file channels.
720
+ ...(perFolder ? memberHeadersField(agent) : { removeOnlyOwnEntry: true }),
721
+ });
722
+ workFolderFiles.push(...result.workFolderFiles);
723
+ }
724
+ await ensureGitExcluded(exec, agent.workFolder, workFolderFiles, agentOs === 'windows', shell);
725
+ }
726
+ catch (e) {
727
+ if (e instanceof MemberConfigError) {
728
+ // Recoverable: the sync wrote NOTHING to the file it could not safely
729
+ // edit. Record why on the member and let the rest of compose succeed.
730
+ // Files compose DID write (permission configs) still stay out of `git status`.
731
+ try {
732
+ await ensureGitExcluded(exec, agent.workFolder, workFolderFiles, agentOs === 'windows', shell);
733
+ }
734
+ catch { /* best effort */ }
735
+ recordFleetMcpStatus(agent.id, {
736
+ state: 'unavailable',
737
+ reason: e.reason,
738
+ checkedAt: new Date().toISOString(),
739
+ detail: e.message,
740
+ });
741
+ return {
742
+ notEditedReason: e.reason,
743
+ note: `Member MCP config NOT edited: ${e.filePath} is ${memberConfigWhy(e.reason)} (fleetMcp unavailable: ${e.reason}) -- ${e.message}`,
744
+ };
745
+ }
746
+ return { failure: `[FAIL] Failed to write the apra-fleet member MCP entry on "${agent.friendlyName}" (${provider.name}): ${e?.message ?? String(e)}` };
747
+ }
748
+ if (noMemberInstall) {
749
+ // register_member/update_member run compose BEFORE their fleet_install
750
+ // step and do not show this note; their install step writes the entry once
751
+ // the member install exists. So this only states the current state.
752
+ return { note: 'Member MCP entry not written yet: the member has no apra-fleet member install now; the fleet_install "auto" step of register_member/update_member installs one and then writes the entry. Any entry an earlier compose wrote for this member was removed.' };
753
+ }
754
+ // Read the CURRENT record (the caller's agent object may predate it).
755
+ const recorded = getAgent(agent.id)?.fleetMcp;
756
+ if (recorded?.state === 'unavailable' && recorded.reason && COMPOSE_OWNED_FLEET_MCP_REASONS.has(recorded.reason)) {
757
+ if (recorded.fleetInstalledAt) {
758
+ // Keep the install stamp (the only "this fleet installed it" signal): record a
759
+ // minimal, explicitly unverified, non-unavailable status carrying it.
760
+ recordFleetMcpStatus(agent.id, {
761
+ state: 'available',
762
+ checkedAt: new Date().toISOString(),
763
+ unverified: true,
764
+ detail: 'stale compose status cleared; not yet re-probed',
765
+ fleetInstalledAt: recorded.fleetInstalledAt,
766
+ });
767
+ }
768
+ else {
769
+ updateAgent(agent.id, { fleetMcp: undefined });
770
+ }
771
+ return {
772
+ note: `fleetMcp: cleared the stale unavailable status (${recorded.reason}) -- the member MCP entry is now written; re-probe with member_detail refresh:true`,
773
+ };
774
+ }
775
+ return {};
776
+ }
777
+ /** `{ headers }` for a member whose access secret is known, else nothing. */
778
+ function memberHeadersField(agent) {
779
+ const headers = memberMcpHeaders(agent);
780
+ return headers ? { headers } : {};
781
+ }
782
+ /**
783
+ * Write ONLY the member's per-folder apra-fleet MCP entry (?member=<uuid>) --
784
+ * the same writer compose_permissions uses, without recomposing the permission
785
+ * config files (a recompose would replace mid-sprint grants). Used by the
786
+ * fleetMcp probe of register_member/update_member with fleet_install, so one
787
+ * call ends with the entry in place before it is checked.
788
+ * - ok: the entry was written (or already up to date);
789
+ * - not ok, `reason` set: a member config it cannot safely edit (tracked,
790
+ * unparseable, unreadable) -- nothing was written to it;
791
+ * - not ok, no `reason`: a hard write failure.
792
+ * Providers without a per-folder entry (no syncMemberMcpEntry) report ok and
793
+ * write nothing. Never throws.
794
+ */
795
+ export async function writeMemberMcpEntry(agent) {
796
+ try {
797
+ const provider = getProvider(agent.llmProvider);
798
+ if (!provider.syncMemberMcpEntry)
799
+ return { ok: true };
800
+ const strategy = getStrategy(agent);
801
+ const outcome = await syncMemberMcpConfig(agent, provider, strategy, [], null);
802
+ if (outcome.failure)
803
+ return { ok: false, detail: outcome.failure };
804
+ if (outcome.notEditedReason)
805
+ return { ok: false, reason: outcome.notEditedReason, detail: outcome.note ?? outcome.notEditedReason };
806
+ return { ok: true };
807
+ }
808
+ catch (e) {
809
+ return { ok: false, detail: `could not write the apra-fleet member MCP entry: ${e?.message ?? String(e)}` };
810
+ }
811
+ }
812
+ /**
813
+ * Removes exactly what compose_permissions wrote for `agent` under its CURRENT
814
+ * (soon to be previous) provider -- the inverse of a compose, used by
815
+ * update_member when a member switches provider:
816
+ * - the per-folder apra-fleet MCP entry (provider.syncMemberMcpEntry with
817
+ * url null), deepwiki and every other server untouched;
818
+ * - the top-level keys compose writes into each permission config file; a
819
+ * work-folder file left empty is deleted, a home-anchored file (e.g. agy's
820
+ * own project file) is only rewritten;
821
+ * - the .git/info/exclude lines compose added for its work-folder files.
822
+ * Returns human-readable detail lines; throws on a failure so the caller can
823
+ * surface it.
824
+ */
825
+ export async function removeComposedMemberConfig(agent) {
826
+ const provider = getProvider(agent.llmProvider);
827
+ const strategy = getStrategy(agent);
828
+ const agentOs = (agent.os ?? 'linux');
829
+ const isWindows = agentOs === 'windows';
830
+ const shell = getAgentShell(agent);
831
+ const posix = isPosixShell(isWindows, shell);
832
+ const exec = (cmd, t) => strategy.execCommand(cmd, t);
833
+ const details = [];
834
+ let paths = [];
835
+ try {
836
+ paths = provider.permissionConfigPaths(agent);
837
+ }
838
+ catch {
839
+ // e.g. an agy member that never got a project id: compose never wrote one.
840
+ paths = [];
841
+ }
842
+ const memberHomeDir = (paths.some(isHomeAnchored) || provider.syncMemberMcpEntry)
843
+ ? await getMemberHomeDir(agent)
844
+ : null;
845
+ // The keys compose writes, per file: union over both roles, with a non-empty
846
+ // allow list so optional keys (e.g. copilot's tools) are included.
847
+ const keysPerPath = paths.map(() => new Set());
848
+ for (const role of ['doer', 'reviewer']) {
849
+ const configs = provider.composePermissionConfig(role, ['Read'], agent, { memberHomeDir, warnings: [] });
850
+ configs.forEach((cfg, i) => {
851
+ if (isPlainObject(cfg)) {
852
+ for (const k of Object.keys(cfg))
853
+ keysPerPath[i]?.add(k);
854
+ }
855
+ else {
856
+ keysPerPath[i] = null; // whole-file (e.g. TOML) content
857
+ }
858
+ });
859
+ }
860
+ const workFolderFiles = [];
861
+ for (let i = 0; i < paths.length; i++) {
862
+ const rel = paths[i];
863
+ const homeAnchored = isHomeAnchored(rel);
864
+ if (!homeAnchored)
865
+ workFolderFiles.push(rel);
866
+ const absPath = resolveRemotePath(agent.workFolder, rel, isWindows, shell, memberHomeDir);
867
+ const keys = keysPerPath[i];
868
+ if (keys === null) {
869
+ if (!homeAnchored && (await readMemberFile(exec, absPath, posix)).trim()) {
870
+ await deleteMemberFile(exec, absPath, posix);
871
+ details.push(`removed ${absPath}`);
872
+ }
873
+ continue;
874
+ }
875
+ const current = await readMemberJson(exec, absPath, posix);
876
+ if (Object.keys(current).length === 0)
877
+ continue;
878
+ let changed = pruneLegacyMcpEntries(current);
879
+ for (const k of keys ?? []) {
880
+ if (k in current) {
881
+ delete current[k];
882
+ changed = true;
883
+ }
884
+ }
885
+ if (!changed)
886
+ continue;
887
+ if (Object.keys(current).length === 0 && !homeAnchored) {
888
+ await deleteMemberFile(exec, absPath, posix);
889
+ details.push(`removed ${absPath}`);
890
+ }
891
+ else {
892
+ await writeMemberJson(exec, absPath, current, posix);
893
+ details.push(`removed fleet permission keys from ${absPath}`);
894
+ }
895
+ }
896
+ if (provider.syncMemberMcpEntry) {
897
+ const result = await provider.syncMemberMcpEntry({
898
+ agent,
899
+ execCommand: exec,
900
+ memberHomeDir,
901
+ agentOs,
902
+ shell,
903
+ transport: workspaceTrustTransportFor(agent, strategy),
904
+ secretChannel: memberSecretFileChannelFor(agent),
905
+ url: null,
906
+ // Only the entry fleet wrote for THIS member (?member=<uuid>): a human's
907
+ // own apra-fleet entry for that folder is never removed.
908
+ removeOnlyOwnEntry: true,
909
+ });
910
+ workFolderFiles.push(...result.workFolderFiles);
911
+ details.push(result.detail);
912
+ }
913
+ await removeGitExcluded(exec, agent.workFolder, workFolderFiles, isWindows, shell);
914
+ return details;
915
+ }
916
+ /** The hard member-MCP failure result: the permission files landed (and the
917
+ * ledger records them); only the member MCP entry is missing. */
918
+ function memberMcpFailureResult(failure, projectFolder) {
919
+ return `${failure}\n The permission config files were written${projectFolder ? ' and recorded in the ledger' : ''}; the apra-fleet member MCP entry was NOT written.`;
920
+ }
921
+ /** Reads a claude member's <workFolder>/.claude/settings.local.json -- the
922
+ * file the grant path merges into. Missing or non-JSON content reads as an
923
+ * empty allow list. */
924
+ async function readClaudeSettingsLocal(agent, strategy, agentShell) {
925
+ const isWindowsAgent = (agent.os ?? 'linux') === 'windows';
926
+ const absSettingsPath = resolveRemotePath(agent.workFolder, '.claude/settings.local.json', isWindowsAgent, agentShell);
927
+ // Branched on the member's SHELL, not just its OS: a gitbash Windows
928
+ // member cannot run Get-Content (apra-fleet-7dir.1.3).
929
+ const readResult = isPosixShell(isWindowsAgent, agentShell)
930
+ ? await strategy.execCommand(`cat ${quotePosixPath(absSettingsPath)} 2>/dev/null || echo "{}"`, LOCAL_FS_OP_TIMEOUT_MS)
931
+ : await strategy.execCommand(`Get-Content -Raw ${quotePwshPath(absSettingsPath.replace(/\//g, '\\'))} -ErrorAction SilentlyContinue`, LOCAL_FS_OP_TIMEOUT_MS);
932
+ try {
933
+ return JSON.parse(readResult.stdout.trim());
934
+ }
935
+ catch {
936
+ return { permissions: { allow: [] } };
937
+ }
938
+ }
939
+ /** The given rules a claude member's settings.local.json allow list does not
940
+ * hold yet. Any read failure returns every rule (the caller then grants,
941
+ * which is additive); never throws. Lets a caller skip a grant that would
942
+ * only rewrite the file -- a grant also resets the deny list to the
943
+ * composed one. */
944
+ export async function missingClaudeAllowRules(agent, rules) {
945
+ try {
946
+ const current = await readClaudeSettingsLocal(agent, getStrategy(agent), getAgentShell(agent));
947
+ const allow = new Set(Array.isArray(current?.permissions?.allow) ? current.permissions.allow : []);
948
+ return rules.filter(r => !allow.has(r));
949
+ }
950
+ catch {
951
+ return [...rules];
952
+ }
953
+ }
424
954
  export async function composePermissions(input) {
425
955
  const agentOrError = resolveMember(input.member_id, input.member_name);
426
956
  if (typeof agentOrError === 'string')
@@ -434,17 +964,57 @@ export async function composePermissions(input) {
434
964
  const mode = resolvePrimaryMode(input.role, input.tags);
435
965
  const provider = getProvider(agent.llmProvider);
436
966
  const strategy = getStrategy(agent);
967
+ // Dry run: the allow list a proactive compose would deliver (role/tags +
968
+ // detected stacks + ledger when project_folder is given), with nothing
969
+ // written to the member or the ledger. Callers derive their grant policy
970
+ // from it (fleet-sprint's permission heal) instead of a hand-kept copy.
971
+ if (input.dry_run && !input.grant?.length) {
972
+ const profilesDirDry = findProfilesDir();
973
+ const ledgerDry = input.project_folder ? loadLedger(input.project_folder) : { stacks: [], granted: [] };
974
+ const stacksDry = await detectStacks(agent, input.project_folder ? path.basename(input.project_folder) : undefined);
975
+ const allowDry = input.tags?.length
976
+ ? composeFromTags(profilesDirDry, mode, input.tags, stacksDry, ledgerDry)
977
+ : compose(profilesDirDry, mode, stacksDry, ledgerDry);
978
+ return JSON.stringify({ dry_run: true, mode, stacks: stacksDry, allow: allowDry });
979
+ }
980
+ // Reactive grant mode -- validate dangerous grants FIRST before any member probe or command
981
+ if (input.grant?.length) {
982
+ const blocked = input.grant.filter(p => isNeverAutoGrant(p));
983
+ if (blocked.length) {
984
+ return `❌ Cannot auto-grant dangerous permissions: ${blocked.join(', ')}. Escalate to user.`;
985
+ }
986
+ }
987
+ // AGY: grants live in the member's own agy project file, which only exists
988
+ // once the member has a verified project id. Provision it here when missing
989
+ // (upgrade path for members registered before project binding) or when the
990
+ // file is gone/corrupt -- never write grants anywhere else.
991
+ let agyNote = '';
992
+ if (provider.name === 'agy') {
993
+ try {
994
+ const ensured = await ensureAgyProject(agent);
995
+ if (ensured.provisioned) {
996
+ agyNote = `\n AGY project: ${ensured.projectId} (created: ${ensured.provisioned.replace(/_/g, ' ')})`;
997
+ }
998
+ }
999
+ catch (e) {
1000
+ return `[FAIL] Failed to provision the agy project for "${agent.friendlyName}": ${e?.message ?? String(e)}. No permissions were written.`;
1001
+ }
1002
+ }
437
1003
  // The member's registered shell decides POSIX vs PowerShell command strings
438
1004
  // for every config write below (apra-fleet-7dir.1.3).
439
1005
  const agentShell = getAgentShell(agent);
1006
+ // Resolved once per call, in JavaScript, for any provider whose
1007
+ // permissionConfigPaths() are home-anchored ("~/..."). Cached per member by
1008
+ // getMemberHomeDir, and null for a member whose probe fails -- in which case
1009
+ // resolveRemotePath raises a ConfigDeliveryError rather than silently writing
1010
+ // a home-anchored file to the wrong place.
1011
+ const memberHomeDir = provider.permissionConfigPaths(agent).some(isHomeAnchored)
1012
+ ? await getMemberHomeDir(agent)
1013
+ : null;
440
1014
  const profilesDir = findProfilesDir();
441
1015
  const ledger = input.project_folder ? loadLedger(input.project_folder) : { stacks: [], granted: [] };
442
1016
  // Reactive grant mode
443
1017
  if (input.grant?.length) {
444
- const blocked = input.grant.filter(p => isNeverAutoGrant(p));
445
- if (blocked.length) {
446
- return `❌ Cannot auto-grant dangerous permissions: ${blocked.join(', ')}. Escalate to user.`;
447
- }
448
1018
  // Expand co-occurrences
449
1019
  const expanded = new Set(input.grant);
450
1020
  for (const p of input.grant) {
@@ -458,34 +1028,41 @@ export async function composePermissions(input) {
458
1028
  // wholesale (see deepMerge doc comment), so an `allow` computed from the
459
1029
  // wrong file here would silently discard every pre-existing grant in the
460
1030
  // real settings.local.json once the write lands at the correct path.
461
- const isWindowsAgent = (agent.os ?? 'linux') === 'windows';
462
- const absSettingsPath = resolveRemotePath(agent.workFolder, '.claude/settings.local.json', isWindowsAgent, agentShell);
463
- // Branched on the member's SHELL, not just its OS: a gitbash Windows
464
- // member cannot run Get-Content (apra-fleet-7dir.1.3).
465
- const readResult = isPosixShell(isWindowsAgent, agentShell)
466
- ? await strategy.execCommand(`cat "${absSettingsPath}" 2>/dev/null || echo "{}"`, 5000)
467
- : await strategy.execCommand(`Get-Content -Raw "${absSettingsPath.replace(/\//g, '\\')}" -ErrorAction SilentlyContinue`, 5000);
468
- let current;
469
- try {
470
- current = JSON.parse(readResult.stdout.trim());
471
- }
472
- catch {
473
- current = { permissions: { allow: [] } };
474
- }
1031
+ const current = await readClaudeSettingsLocal(agent, strategy, agentShell);
475
1032
  const existingAllow = new Set(current?.permissions?.allow ?? []);
476
1033
  for (const p of expanded)
477
1034
  existingAllow.add(p);
478
1035
  allow = [...existingAllow];
479
1036
  }
480
1037
  else {
481
- // Non-Claude: pass grants directly; provider incorporates into role-based config
482
- allow = [...expanded];
1038
+ // Non-Claude: include the role's base profile so reactive grants never strip
1039
+ // baseline developer or reviewer permissions.
1040
+ const baseName = mode === 'doer' ? 'base-dev' : 'base-reviewer';
1041
+ const base = loadProfile(profilesDir, baseName);
1042
+ const basePerms = new Set(base?.permissions?.allow ?? []);
1043
+ for (const p of expanded)
1044
+ basePerms.add(p);
1045
+ allow = [...basePerms];
483
1046
  }
484
- const configs = provider.composePermissionConfig(mode, allow);
485
- const paths = provider.permissionConfigPaths();
1047
+ let deliveryWarnings = [];
1048
+ if (provider.preparePermissionsDelivery) {
1049
+ const warns = await provider.preparePermissionsDelivery(agent, (cmd, t) => strategy.execCommand(cmd, t), memberHomeDir, agent.os ?? 'linux', agentShell);
1050
+ if (Array.isArray(warns) && warns.length > 0) {
1051
+ deliveryWarnings = warns;
1052
+ }
1053
+ }
1054
+ const composeWarnings = [];
1055
+ const configs = provider.composePermissionConfig(mode, allow, agent, { memberHomeDir, warnings: composeWarnings });
1056
+ deliveryWarnings = [...deliveryWarnings, ...composeWarnings];
1057
+ const paths = provider.permissionConfigPaths(agent);
1058
+ // A grant ADDS to what the member already has. Claude's allow list was
1059
+ // merged above; agy's rules are unioned into the project file's existing
1060
+ // allow/deny arrays instead of replacing them (a plain deepMerge would
1061
+ // overwrite the arrays with just the granted rules).
1062
+ const unionArrays = provider.name === 'agy';
486
1063
  try {
487
1064
  for (let i = 0; i < paths.length; i++) {
488
- await deliverConfigFile(strategy, agent.os ?? 'linux', agent.workFolder, paths[i], configs[i], agentShell);
1065
+ await deliverConfigFile(strategy, agent.os ?? 'linux', agent.workFolder, paths[i], configs[i], agentShell, memberHomeDir, { unionArrays });
489
1066
  }
490
1067
  }
491
1068
  catch (e) {
@@ -496,7 +1073,11 @@ export async function composePermissions(input) {
496
1073
  }
497
1074
  throw e;
498
1075
  }
499
- // Update ledger (only reached when every config file verifiably landed)
1076
+ // Update the ledger with exactly what was written: reached only when every
1077
+ // permission config file verifiably landed, and BEFORE the member MCP
1078
+ // sync, so a sync failure can neither drop a grant that is already on disk
1079
+ // from the ledger nor make the ledger claim anything the sync did not write
1080
+ // (the ledger records permission grants only, never the MCP entry).
500
1081
  if (input.project_folder) {
501
1082
  const reason = input.grant_reason ?? 'granted mid-sprint';
502
1083
  const date = new Date().toISOString().slice(0, 10);
@@ -507,11 +1088,16 @@ export async function composePermissions(input) {
507
1088
  }
508
1089
  saveLedger(input.project_folder, ledger);
509
1090
  }
1091
+ const memberMcp = await syncMemberMcpConfig(agent, provider, strategy, paths, memberHomeDir);
1092
+ if (memberMcp.failure)
1093
+ return memberMcpFailureResult(memberMcp.failure, input.project_folder);
510
1094
  // apra-fleet-eft.40.2: self-healing -- repair workspace trust on EVERY
511
1095
  // compose_permissions run (a member registered before this fix, or one whose
512
1096
  // trust was never seeded, gets fixed the next time permissions are composed).
513
1097
  await seedWorkspaceTrust(agent, strategy, 'compose_permissions');
514
- return `✅ Granted ${[...expanded].length} permissions on "${agent.friendlyName}" (${provider.name}):\n ${[...expanded].join('\n ')}`;
1098
+ const warningsBlock = deliveryWarnings.length > 0 ? `\n Warnings:\n ${deliveryWarnings.join('\n ')}` : '';
1099
+ const memberMcpLine = memberMcp.note ? `\n ${memberMcp.note}` : '';
1100
+ return `✅ Granted ${[...expanded].length} permissions on "${agent.friendlyName}" (${provider.name}):\n ${[...expanded].join('\n ')}${agyNote}${memberMcpLine}${warningsBlock}`;
515
1101
  }
516
1102
  // Proactive compose mode
517
1103
  const projectSubdir = input.project_folder ? path.basename(input.project_folder) : undefined;
@@ -519,11 +1105,20 @@ export async function composePermissions(input) {
519
1105
  const allow = input.tags?.length
520
1106
  ? composeFromTags(profilesDir, mode, input.tags, stacks, ledger)
521
1107
  : compose(profilesDir, mode, stacks, ledger);
522
- const configs = provider.composePermissionConfig(mode, allow);
523
- const paths = provider.permissionConfigPaths();
1108
+ let deliveryWarnings = [];
1109
+ if (provider.preparePermissionsDelivery) {
1110
+ const warns = await provider.preparePermissionsDelivery(agent, (cmd, t) => strategy.execCommand(cmd, t), memberHomeDir, agent.os ?? 'linux', agentShell);
1111
+ if (Array.isArray(warns) && warns.length > 0) {
1112
+ deliveryWarnings = warns;
1113
+ }
1114
+ }
1115
+ const composeWarnings = [];
1116
+ const configs = provider.composePermissionConfig(mode, allow, agent, { memberHomeDir, warnings: composeWarnings });
1117
+ deliveryWarnings = [...deliveryWarnings, ...composeWarnings];
1118
+ const paths = provider.permissionConfigPaths(agent);
524
1119
  try {
525
1120
  for (let i = 0; i < paths.length; i++) {
526
- await deliverConfigFile(strategy, agent.os ?? 'linux', agent.workFolder, paths[i], configs[i], agentShell);
1121
+ await deliverConfigFile(strategy, agent.os ?? 'linux', agent.workFolder, paths[i], configs[i], agentShell, memberHomeDir);
527
1122
  }
528
1123
  }
529
1124
  catch (e) {
@@ -534,17 +1129,23 @@ export async function composePermissions(input) {
534
1129
  }
535
1130
  throw e;
536
1131
  }
537
- // Update ledger stacks (only reached when every config file verifiably landed)
1132
+ // Update ledger stacks: only reached when every permission config file
1133
+ // verifiably landed, and before the member MCP sync (see the grant path).
538
1134
  if (input.project_folder) {
539
1135
  ledger.stacks = stacks;
540
1136
  saveLedger(input.project_folder, ledger);
541
1137
  }
1138
+ const memberMcp = await syncMemberMcpConfig(agent, provider, strategy, paths, memberHomeDir);
1139
+ if (memberMcp.failure)
1140
+ return memberMcpFailureResult(memberMcp.failure, input.project_folder);
542
1141
  // apra-fleet-eft.40.2: self-healing -- repair workspace trust on EVERY
543
1142
  // compose_permissions run (a member registered before this fix, or one whose
544
1143
  // trust was never seeded, gets fixed the next time permissions are composed).
545
1144
  await seedWorkspaceTrust(agent, strategy, 'compose_permissions');
546
1145
  const customTags = (input.tags ?? []).filter(t => t !== 'doer' && t !== 'reviewer');
547
1146
  const tagsLine = customTags.length ? `\n Tags: ${customTags.join(', ')}` : '';
548
- return `✅ Permissions composed for "${agent.friendlyName}" (${mode}, ${provider.name}):\n Stacks: ${stacks.join(', ') || 'none detected'}${tagsLine}\n Config: ${paths.join(', ')}\n Ledger grants: ${ledger.granted.length}`;
1147
+ const warningsBlock = deliveryWarnings.length > 0 ? `\n Warnings:\n ${deliveryWarnings.join('\n ')}` : '';
1148
+ const memberMcpLine = memberMcp.note ? `\n ${memberMcp.note}` : '';
1149
+ return `✅ Permissions composed for "${agent.friendlyName}" (${mode}, ${provider.name}):\n Stacks: ${stacks.join(', ') || 'none detected'}${tagsLine}\n Config: ${paths.join(', ')}\n Ledger grants: ${ledger.granted.length}${agyNote}${memberMcpLine}${warningsBlock}`;
549
1150
  }
550
1151
  //# sourceMappingURL=compose-permissions.js.map