@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -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,10 +10,14 @@ 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';
14
18
  import { ensureAgyProject } from '../services/agy-project.js';
15
19
  import { getMemberHomeDir } from '../services/member-home.js';
20
+ import { recordFleetMcpStatus, getAgent, updateAgent } from '../services/registry.js';
16
21
  import { getProviderInstallConfig, INSTALLABLE_LLM_PROVIDERS, readInstallConfig } from '../cli/config.js';
17
22
  export const composePermissionsSchema = z.object({
18
23
  ...memberIdentifier,
@@ -21,6 +26,7 @@ export const composePermissionsSchema = z.object({
21
26
  project_folder: z.string().optional().describe('Local project folder containing permissions.json ledger. Omit to skip ledger merge.'),
22
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.'),
23
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.'),
24
30
  });
25
31
  // my-beads-db-27m.27: these are quick local filesystem probes (mkdir/cat/echo/
26
32
  // PowerShell one-liners) that normally complete in milliseconds under
@@ -219,39 +225,99 @@ function loadLedger(projectFolder) {
219
225
  return { stacks: [], granted: [] };
220
226
  }
221
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 });
222
231
  const ledgerPath = path.join(projectFolder, 'permissions.json');
223
232
  fs.writeFileSync(ledgerPath, JSON.stringify(ledger, null, 2) + '\n');
224
233
  }
225
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
+ }
226
265
  const strategy = getStrategy(agent);
227
266
  const markers = Object.keys(STACK_MAP).join(' ');
228
267
  // Resolve the directory to check on the member: prefer <workFolder>/<projectSubdir>,
229
268
  // fall back to workFolder root. Using an absolute cd ensures remote (SSH) members
230
269
  // check the right directory instead of defaulting to their home directory.
270
+ const rootDir = agent.workFolder.replace(/\\/g, '/');
231
271
  const checkDir = projectSubdir
232
272
  ? `${agent.workFolder}/${projectSubdir}`.replace(/\\/g, '/')
233
- : agent.workFolder.replace(/\\/g, '/');
234
- // TODO: unbranched POSIX && / || / 2>/dev/null -- same defect class as
235
- // orphan-recovery.ts's pid-alive/file-read commands (apra-fleet review,
236
- // fix/cross-shell-home-var). Not yet OS-branched for Windows members.
237
- const result = await strategy.execCommand(`cd "${checkDir}" 2>/dev/null && ls ${markers} 2>/dev/null || true`, 10000);
238
- const found = new Set();
239
- for (const line of result.stdout.split('\n')) {
240
- const file = line.trim();
241
- if (STACK_MAP[file])
242
- found.add(STACK_MAP[file]);
243
- }
244
- // .sln/.csproj need glob - check separately
245
- // TODO: same unbranched-POSIX defect class as above -- not yet OS-branched.
246
- const dotnetCheck = await strategy.execCommand(`cd "${checkDir}" 2>/dev/null && ls *.sln *.csproj 2>/dev/null || true`, LOCAL_FS_OP_TIMEOUT_MS);
247
- if (dotnetCheck.stdout.trim())
248
- 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
+ }
249
312
  return [...found];
250
313
  }
251
314
  function compose(profilesDir, role, stacks, ledger) {
252
315
  const baseName = role === 'doer' ? 'base-dev' : 'base-reviewer';
253
316
  const base = loadProfile(profilesDir, baseName);
254
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);
255
321
  const roleKey = role === 'doer' ? 'dev' : 'reviewer';
256
322
  for (const stack of stacks) {
257
323
  const profile = loadProfile(profilesDir, stack);
@@ -287,6 +353,9 @@ function composeFromTags(profilesDir, mode, tags, stacks, ledger) {
287
353
  const baseName = mode === 'doer' ? 'base-dev' : 'base-reviewer';
288
354
  const base = loadProfile(profilesDir, baseName);
289
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);
290
359
  const profileKey = mode === 'doer' ? 'dev' : 'reviewer';
291
360
  // Stack profiles (detected from the project), keyed by mode
292
361
  for (const stack of stacks) {
@@ -360,6 +429,49 @@ export function deepMergeUnion(target, source) {
360
429
  }
361
430
  return result;
362
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
+ }
363
475
  /** Raised by deliverConfigFile when a config write does not verifiably land on
364
476
  * the member (nonzero mkdir/write exit, or a read-back that does not match the
365
477
  * intended content). Carries the target path so the caller can surface exactly
@@ -456,16 +568,19 @@ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, conten
456
568
  const dir = posix
457
569
  ? absPath.split('/').slice(0, -1).join('/')
458
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);
459
574
  const mkdirCmd = posix
460
- ? `mkdir -p "${dir}"`
461
- : `New-Item -ItemType Directory -Force "${dir}"`;
575
+ ? `mkdir -p ${quotePosixPath(dir)}`
576
+ : `New-Item -ItemType Directory -Force ${quotePwshPath(dir)}`;
462
577
  const mkdirResult = await strategy.execCommand(mkdirCmd, LOCAL_FS_OP_TIMEOUT_MS);
463
578
  if (mkdirResult.code !== 0) {
464
579
  throw new ConfigDeliveryError(absPath, `could not create parent directory "${dir}" (exit ${mkdirResult.code})${stderrExcerpt(mkdirResult.stderr)}`);
465
580
  }
466
581
  const readCmd = posix
467
- ? `cat "${absPath}" 2>/dev/null || true`
468
- : `Get-Content -Raw "${winPath}" -ErrorAction SilentlyContinue`;
582
+ ? `cat ${qPath} 2>/dev/null || true`
583
+ : `Get-Content -Raw ${qPath} -ErrorAction SilentlyContinue`;
469
584
  let mergedContent = content;
470
585
  if (isPlainObject(content)) {
471
586
  const readResult = await strategy.execCommand(readCmd, LOCAL_FS_OP_TIMEOUT_MS);
@@ -478,14 +593,19 @@ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, conten
478
593
  catch {
479
594
  // file missing, empty, or not JSON -- start from an empty object
480
595
  }
481
- mergedContent = opts.unionArrays ? deepMergeUnion(existing, content) : 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);
482
602
  }
483
603
  const contentStr = typeof mergedContent === 'string'
484
604
  ? mergedContent
485
605
  : JSON.stringify(mergedContent, null, 2);
486
606
  const writeCmd = posix
487
- ? `cat > "${absPath}" << 'FLEET_PERMS_EOF'\n${contentStr}\nFLEET_PERMS_EOF`
488
- : `[System.IO.File]::WriteAllText("${winPath}", '${contentStr.replace(/'/g, "''")}', (New-Object System.Text.UTF8Encoding($false)))`;
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)))`;
489
609
  const writeResult = await strategy.execCommand(writeCmd, LOCAL_FS_OP_TIMEOUT_MS);
490
610
  if (writeResult.code !== 0) {
491
611
  throw new ConfigDeliveryError(absPath, `write command failed (exit ${writeResult.code})${stderrExcerpt(writeResult.stderr)}`);
@@ -517,6 +637,320 @@ async function deliverConfigFile(strategy, agentOs, workFolder, filePath, conten
517
637
  }
518
638
  }
519
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
+ }
520
954
  export async function composePermissions(input) {
521
955
  const agentOrError = resolveMember(input.member_id, input.member_name);
522
956
  if (typeof agentOrError === 'string')
@@ -530,6 +964,19 @@ export async function composePermissions(input) {
530
964
  const mode = resolvePrimaryMode(input.role, input.tags);
531
965
  const provider = getProvider(agent.llmProvider);
532
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
+ }
533
980
  // Reactive grant mode -- validate dangerous grants FIRST before any member probe or command
534
981
  if (input.grant?.length) {
535
982
  const blocked = input.grant.filter(p => isNeverAutoGrant(p));
@@ -581,28 +1028,21 @@ export async function composePermissions(input) {
581
1028
  // wholesale (see deepMerge doc comment), so an `allow` computed from the
582
1029
  // wrong file here would silently discard every pre-existing grant in the
583
1030
  // real settings.local.json once the write lands at the correct path.
584
- const isWindowsAgent = (agent.os ?? 'linux') === 'windows';
585
- const absSettingsPath = resolveRemotePath(agent.workFolder, '.claude/settings.local.json', isWindowsAgent, agentShell);
586
- // Branched on the member's SHELL, not just its OS: a gitbash Windows
587
- // member cannot run Get-Content (apra-fleet-7dir.1.3).
588
- const readResult = isPosixShell(isWindowsAgent, agentShell)
589
- ? await strategy.execCommand(`cat "${absSettingsPath}" 2>/dev/null || echo "{}"`, LOCAL_FS_OP_TIMEOUT_MS)
590
- : await strategy.execCommand(`Get-Content -Raw "${absSettingsPath.replace(/\//g, '\\')}" -ErrorAction SilentlyContinue`, LOCAL_FS_OP_TIMEOUT_MS);
591
- let current;
592
- try {
593
- current = JSON.parse(readResult.stdout.trim());
594
- }
595
- catch {
596
- current = { permissions: { allow: [] } };
597
- }
1031
+ const current = await readClaudeSettingsLocal(agent, strategy, agentShell);
598
1032
  const existingAllow = new Set(current?.permissions?.allow ?? []);
599
1033
  for (const p of expanded)
600
1034
  existingAllow.add(p);
601
1035
  allow = [...existingAllow];
602
1036
  }
603
1037
  else {
604
- // Non-Claude: pass grants directly; provider incorporates into role-based config
605
- 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];
606
1046
  }
607
1047
  let deliveryWarnings = [];
608
1048
  if (provider.preparePermissionsDelivery) {
@@ -633,7 +1073,11 @@ export async function composePermissions(input) {
633
1073
  }
634
1074
  throw e;
635
1075
  }
636
- // 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).
637
1081
  if (input.project_folder) {
638
1082
  const reason = input.grant_reason ?? 'granted mid-sprint';
639
1083
  const date = new Date().toISOString().slice(0, 10);
@@ -644,12 +1088,16 @@ export async function composePermissions(input) {
644
1088
  }
645
1089
  saveLedger(input.project_folder, ledger);
646
1090
  }
1091
+ const memberMcp = await syncMemberMcpConfig(agent, provider, strategy, paths, memberHomeDir);
1092
+ if (memberMcp.failure)
1093
+ return memberMcpFailureResult(memberMcp.failure, input.project_folder);
647
1094
  // apra-fleet-eft.40.2: self-healing -- repair workspace trust on EVERY
648
1095
  // compose_permissions run (a member registered before this fix, or one whose
649
1096
  // trust was never seeded, gets fixed the next time permissions are composed).
650
1097
  await seedWorkspaceTrust(agent, strategy, 'compose_permissions');
651
1098
  const warningsBlock = deliveryWarnings.length > 0 ? `\n Warnings:\n ${deliveryWarnings.join('\n ')}` : '';
652
- return `✅ Granted ${[...expanded].length} permissions on "${agent.friendlyName}" (${provider.name}):\n ${[...expanded].join('\n ')}${agyNote}${warningsBlock}`;
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}`;
653
1101
  }
654
1102
  // Proactive compose mode
655
1103
  const projectSubdir = input.project_folder ? path.basename(input.project_folder) : undefined;
@@ -681,11 +1129,15 @@ export async function composePermissions(input) {
681
1129
  }
682
1130
  throw e;
683
1131
  }
684
- // 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).
685
1134
  if (input.project_folder) {
686
1135
  ledger.stacks = stacks;
687
1136
  saveLedger(input.project_folder, ledger);
688
1137
  }
1138
+ const memberMcp = await syncMemberMcpConfig(agent, provider, strategy, paths, memberHomeDir);
1139
+ if (memberMcp.failure)
1140
+ return memberMcpFailureResult(memberMcp.failure, input.project_folder);
689
1141
  // apra-fleet-eft.40.2: self-healing -- repair workspace trust on EVERY
690
1142
  // compose_permissions run (a member registered before this fix, or one whose
691
1143
  // trust was never seeded, gets fixed the next time permissions are composed).
@@ -693,6 +1145,7 @@ export async function composePermissions(input) {
693
1145
  const customTags = (input.tags ?? []).filter(t => t !== 'doer' && t !== 'reviewer');
694
1146
  const tagsLine = customTags.length ? `\n Tags: ${customTags.join(', ')}` : '';
695
1147
  const warningsBlock = deliveryWarnings.length > 0 ? `\n Warnings:\n ${deliveryWarnings.join('\n ')}` : '';
696
- 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}${warningsBlock}`;
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}`;
697
1150
  }
698
1151
  //# sourceMappingURL=compose-permissions.js.map