@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -0,0 +1,193 @@
1
+ import type { Agent, SSHExecResult } from '../types.js';
2
+ import type { MemberShell } from '../os/os-commands.js';
3
+ import type { MemberMcpSyncContext } from '../providers/provider.js';
4
+ export type MemberExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
5
+ /** Name of the per-folder member MCP entry every provider writes. */
6
+ export declare const MEMBER_MCP_SERVER_NAME = "apra-fleet";
7
+ /** Name of the retired url+bearer member entry; pruned wherever compose finds it. */
8
+ export declare const LEGACY_MEMBER_MCP_SERVER_NAME = "apra-fleet-member";
9
+ /**
10
+ * The URL a member session uses to reach the fleet MCP server on its OWN
11
+ * machine. `?member=<uuid>` identifies the session as that member, which is
12
+ * what reduces the served tool list to the member allowlist. A local member
13
+ * shares this process's server, so it follows the port that server binds
14
+ * (resolveServerPort: an APRA_FLEET_PORT sandbox, else the recorded install
15
+ * port); a remote member talks to its OWN install, on
16
+ * the port that install records in its member-install marker
17
+ * (agent.memberMcpPort, resolved on the member by the fleetMcp probe), or the
18
+ * built-in default when it recorded none (the probe reports that in fleetMcp
19
+ * detail). Two member installs on one host (one per Unix user) therefore each
20
+ * get their own server, never the other user's.
21
+ */
22
+ export declare function memberMcpUrl(agent: Pick<Agent, 'id' | 'agentType' | 'memberMcpPort'>): string;
23
+ /** Claude permission deny rules: every registered fleet tool outside the member
24
+ * allowlist, on the member's apra-fleet server. Derived, never hand-listed. */
25
+ export declare function claudeMemberDenyRules(): string[];
26
+ /** Allow rules, in Claude's mcp__<server>__<tool> form, for every fleet tool in
27
+ * the member allowlist (kb_*, code_* and the self-reporting tools) -- never a
28
+ * maintainer-only or never-served tool. compose_permissions adds them to every
29
+ * composed profile so an acceptEdits session (a model without auto support)
30
+ * is not refused a member tool for lack of an allow rule. Derived, never
31
+ * hand-listed; agy maps the same tokens to mcp(<server>/<tool>). */
32
+ export declare function memberMcpAllowRules(): string[];
33
+ /** agy permission deny rules: same complement, in agy's mcp(<server>/<tool>) form. */
34
+ export declare function agyMemberDenyRules(): string[];
35
+ /**
36
+ * Removes the legacy/superseded fleet MCP entries from a parsed config object,
37
+ * in place, and reports whether anything changed:
38
+ * - mcpServers['apra-fleet-member'] and mcp['apra-fleet-member'] (the retired
39
+ * url+bearer registration);
40
+ * - mcpServers['apra-fleet'] when it is the old blanket `{disabled: true}`
41
+ * switch compose used to write.
42
+ * Any other entry (deepwiki, user-added servers) is never touched. A map this
43
+ * prune empties is removed so no `mcpServers: {}` residue is left behind.
44
+ */
45
+ export declare function pruneLegacyMcpEntries(obj: Record<string, unknown>): boolean;
46
+ /** Joins `relPath` (forward-slash separated) onto an absolute member-side base
47
+ * directory, OS- and shell-appropriately. PowerShell members get backslashes;
48
+ * a Git-for-Windows (gitbash) member gets the C:/... form bash understands. */
49
+ export declare function joinMemberPath(base: string, relPath: string, isWindows: boolean, shell?: MemberShell): string;
50
+ /**
51
+ * Quotes a resolved member-side path for a POSIX shell (bash/sh/zsh, including
52
+ * Git-for-Windows bash). Wrapped in double quotes with every character that
53
+ * stays special inside them -- $ (expansion), backtick (command substitution),
54
+ * " (ends the string), and backslash (the escape character) -- backslash-escaped,
55
+ * so the member's shell receives the path verbatim. Single quotes are literal
56
+ * inside double quotes and need nothing. A path with no metacharacter yields
57
+ * exactly `"<path>"`, the shape these commands have always carried.
58
+ */
59
+ export declare function quotePosixPath(p: string): string;
60
+ /**
61
+ * Quotes a resolved member-side path for PowerShell (5.1 and 7). Wrapped in
62
+ * double quotes with every character that stays special inside them -- $
63
+ * (expansion), backtick (the escape character), and the double-quote forms
64
+ * PowerShell recognises (ASCII " and U+201C..U+201E) -- backtick-escaped.
65
+ * Single quotes are literal inside double quotes and need nothing. A path with
66
+ * no metacharacter yields exactly `"<path>"`.
67
+ */
68
+ export declare function quotePwshPath(p: string): string;
69
+ /**
70
+ * Command string that moves `staged` to `target`, making any missing parent
71
+ * directory along the way. Target directory permissions follow the member's
72
+ * default; only the staged file itself carries owner-only permissions
73
+ * (creating its directory). POSIX also forces 0600 on the result; the staged
74
+ * file is owner-only already. Carries resolved, quoted paths only.
75
+ */
76
+ export declare function moveStagedFileCommand(staged: string, target: string, posix: boolean): string;
77
+ /**
78
+ * A member-side config file the apra-fleet MCP sync cannot safely touch
79
+ * (unreadable, not strict JSON, git-tracked, ...). compose_permissions treats it
80
+ * as a RECOVERABLE condition: nothing is written to that file, the member's
81
+ * fleetMcp status is recorded unavailable with `reason`, and the rest of
82
+ * compose carries on.
83
+ */
84
+ export declare class MemberConfigError extends Error {
85
+ readonly code: string;
86
+ /** Machine-readable fleetMcp unavailable reason recorded by compose. */
87
+ readonly reason: string;
88
+ readonly filePath: string;
89
+ constructor(code: string,
90
+ /** Machine-readable fleetMcp unavailable reason recorded by compose. */
91
+ reason: string, filePath: string, message: string);
92
+ }
93
+ /** The file exists but could not be read (EACCES, sharing violation, ...). */
94
+ export declare class MemberConfigUnreadableError extends MemberConfigError {
95
+ constructor(filePath: string, detail?: string);
96
+ }
97
+ /** The file exists and was read, but is not a strict JSON object (e.g. JSONC). */
98
+ export declare class MemberConfigNotJsonError extends MemberConfigError {
99
+ constructor(filePath: string, detail: string, reason?: string);
100
+ }
101
+ /**
102
+ * The read command for a member-side file. The existence test is built here in
103
+ * JavaScript per shell (never shell-variable expansion): a MISSING file yields
104
+ * empty output and exit 0, an EXISTING file that cannot be read yields a
105
+ * non-zero exit -- the exit code is never swallowed.
106
+ */
107
+ export declare function readMemberFileCommand(absPath: string, posix: boolean): string;
108
+ /** Read a member-side text file. A missing file reads as ''; an existing file
109
+ * that cannot be read THROWS MemberConfigUnreadableError (never reads as ''). */
110
+ export declare function readMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<string>;
111
+ /** PowerShell regular-file probe whose exit code reflects the result (a bare
112
+ * Test-Path prints True/False and exits 0 either way). `-PathType Leaf`
113
+ * excludes directories. Single-quoted literal (no expansion at all). */
114
+ export declare function memberFileExistsPwshCommand(absPath: string): string;
115
+ /** POSIX regular-file probe: `test -f` (a directory, or a missing path, exits 1). */
116
+ export declare function memberFileExistsPosixCommand(absPath: string): string;
117
+ /**
118
+ * True when a regular file exists at the member-side `absPath`. A directory at
119
+ * that path reads as false (POSIX `test -f`, PowerShell `-PathType Leaf`), as
120
+ * does a missing path or any other non-zero exit. The command carries a
121
+ * resolved, quoted path only (no expansion).
122
+ */
123
+ export declare function memberFileExists(exec: MemberExecFn, absPath: string, posix: boolean): Promise<boolean>;
124
+ /**
125
+ * True when git tracks `relPath` in the member work folder
126
+ * (`git ls-files --error-unmatch`). Not a repo / git missing / untracked all
127
+ * read as false. The command carries a resolved path only (no expansion), with
128
+ * the path form the member's shell expects.
129
+ */
130
+ export declare function isGitTracked(exec: MemberExecFn, workFolder: string, relPath: string, isWindows: boolean, posix: boolean): Promise<boolean>;
131
+ /**
132
+ * The command that prints the git repository root of `workFolder` on the
133
+ * member. Resolved path, quoted per shell (quotePosixPath / quotePwshPath), no
134
+ * $VAR, ~ or backtick expansion for the member shell to perform.
135
+ */
136
+ export declare function memberRepoRootCommand(workFolder: string, isWindows: boolean, posix: boolean): string;
137
+ /** Forward-slash, no trailing slash: the form Claude's project keys take. */
138
+ export declare function normalizeProjectKey(p: string): string;
139
+ /**
140
+ * The key Claude Code files a work folder's LOCAL-scope MCP servers under in
141
+ * its config file (projects[<key>].mcpServers): the git repository root of the
142
+ * folder, or the exact folder outside a git repo (git missing, not a repo, an
143
+ * unusable answer). The ONE resolver for both the writer (syncMemberMcpEntry)
144
+ * and the fleetMcp probe, so they can never disagree on the key.
145
+ */
146
+ export declare function resolveClaudeProjectKey(exec: MemberExecFn, workFolder: string, isWindows: boolean, posix: boolean): Promise<string>;
147
+ /** Reads and parses a member-side JSON file. Returns {} for a missing/empty
148
+ * file; THROWS a typed MemberConfigError for an unreadable file or a non-empty
149
+ * file that is not a JSON object, so a caller can never clobber a file it
150
+ * could not understand. */
151
+ export declare function readMemberJson(exec: MemberExecFn, absPath: string, posix: boolean): Promise<Record<string, unknown>>;
152
+ /**
153
+ * Writes `content` to a member-side file (creating its parent directory), then
154
+ * reads it back and confirms it landed. Throws on a nonzero exit or a
155
+ * read-back mismatch -- a write that did not land is never reported as done.
156
+ */
157
+ export declare function writeMemberFile(exec: MemberExecFn, absPath: string, content: string, posix: boolean): Promise<void>;
158
+ /** Writes a JSON object to a member-side file (pretty-printed), verified. */
159
+ export declare function writeMemberJson(exec: MemberExecFn, absPath: string, obj: Record<string, unknown>, posix: boolean): Promise<void>;
160
+ /**
161
+ * Writes a config file that carries a member access secret WITHOUT the
162
+ * content ever appearing in a command string: staged in an owner-only file
163
+ * through the secret-file channel, then moved into place by a content-free
164
+ * command (the file stays owner-only, 0600 on POSIX). No channel -> throws loudly;
165
+ * there is no inline fallback.
166
+ */
167
+ export declare function writeSecretBearingConfig(ctx: MemberMcpSyncContext, file: string, content: string, posix: boolean): Promise<void>;
168
+ /** Deletes a member-side file (no error when it is already gone). */
169
+ export declare function deleteMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<void>;
170
+ /**
171
+ * Resolves the member work folder's git exclude file (`.git/info/exclude`, or
172
+ * the common git dir's for a worktree). Returns null when the work folder is
173
+ * not a git repository -- there is nothing to keep clean then.
174
+ */
175
+ export declare function resolveGitExcludePath(exec: MemberExecFn, workFolder: string, isWindows: boolean, shell?: MemberShell): Promise<string | null>;
176
+ /** Exclude-file line for a work-folder-relative path: anchored to the repo root. */
177
+ export declare function excludeLineFor(relPath: string): string;
178
+ /**
179
+ * Adds each work-folder-relative path to the work folder's git exclude file so
180
+ * files fleet writes into a member clone never show the clone as dirty. Never
181
+ * touches a tracked file (.gitignore) -- info/exclude is local-only.
182
+ */
183
+ export declare function ensureGitExcluded(exec: MemberExecFn, workFolder: string, relPaths: string[], isWindows: boolean, shell?: MemberShell): Promise<void>;
184
+ /** Removes the exclude lines ensureGitExcluded added for `relPaths`. */
185
+ export declare function removeGitExcluded(exec: MemberExecFn, workFolder: string, relPaths: string[], isWindows: boolean, shell?: MemberShell): Promise<void>;
186
+ /**
187
+ * Prunes the legacy fleet MCP entries (pruneLegacyMcpEntries) from an EXISTING
188
+ * member-side JSON config file. A missing/empty file is left alone (never
189
+ * created); the file is rewritten only when something was actually removed.
190
+ * Returns whether it changed the file.
191
+ */
192
+ export declare function pruneLegacyMcpInMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<boolean>;
193
+ //# sourceMappingURL=member-config-io.d.ts.map
@@ -0,0 +1,446 @@
1
+ // Member-side config file I/O shared by compose_permissions and the provider
2
+ // adapters' per-folder member MCP wiring (syncMemberMcpEntry).
3
+ //
4
+ // Every command built here carries fully resolved paths -- never $HOME, ~/,
5
+ // $env:..., or backticks for the member's shell to expand -- because that
6
+ // shell may be PowerShell, not POSIX. The caller resolves the member's home
7
+ // in JavaScript (getMemberHomeDir) before handing paths in, and every path is
8
+ // quoted per shell (quotePosixPath / quotePwshPath) so a $, backtick or quote
9
+ // that is part of a real path name is passed through verbatim, never
10
+ // interpolated.
11
+ //
12
+ // The read/write command shapes are deliberately identical to the ones
13
+ // compose_permissions' deliverConfigFile has always issued (cat / heredoc
14
+ // FLEET_PERMS_EOF on POSIX, Get-Content / WriteAllText on PowerShell), so a
15
+ // single member-filesystem test double serves both.
16
+ import { isPosixShell } from '../utils/agent-helpers.js';
17
+ import { escapePowerShellArgInner } from '../utils/shell-escape.js';
18
+ import { BUILTIN_DEFAULT_PORT, resolveServerPort } from '../paths.js';
19
+ import { MEMBER_ALLOWED_TOOLS, MEMBER_DENIED_TOOLS } from './member-tool-allowlist.js';
20
+ /** Name of the per-folder member MCP entry every provider writes. */
21
+ export const MEMBER_MCP_SERVER_NAME = 'apra-fleet';
22
+ /** Name of the retired url+bearer member entry; pruned wherever compose finds it. */
23
+ export const LEGACY_MEMBER_MCP_SERVER_NAME = 'apra-fleet-member';
24
+ const FS_OP_TIMEOUT_MS = 15000;
25
+ /**
26
+ * The URL a member session uses to reach the fleet MCP server on its OWN
27
+ * machine. `?member=<uuid>` identifies the session as that member, which is
28
+ * what reduces the served tool list to the member allowlist. A local member
29
+ * shares this process's server, so it follows the port that server binds
30
+ * (resolveServerPort: an APRA_FLEET_PORT sandbox, else the recorded install
31
+ * port); a remote member talks to its OWN install, on
32
+ * the port that install records in its member-install marker
33
+ * (agent.memberMcpPort, resolved on the member by the fleetMcp probe), or the
34
+ * built-in default when it recorded none (the probe reports that in fleetMcp
35
+ * detail). Two member installs on one host (one per Unix user) therefore each
36
+ * get their own server, never the other user's.
37
+ */
38
+ export function memberMcpUrl(agent) {
39
+ // Local: the port this server binds (env, else the recorded member/full
40
+ // install port, else the default) -- the same source http-transport uses.
41
+ const port = agent.agentType === 'local' ? resolveServerPort() : (agent.memberMcpPort ?? BUILTIN_DEFAULT_PORT);
42
+ return `http://localhost:${port}/mcp?member=${encodeURIComponent(agent.id)}`;
43
+ }
44
+ /** Claude permission deny rules: every registered fleet tool outside the member
45
+ * allowlist, on the member's apra-fleet server. Derived, never hand-listed. */
46
+ export function claudeMemberDenyRules() {
47
+ return MEMBER_DENIED_TOOLS.map(tool => `mcp__${MEMBER_MCP_SERVER_NAME}__${tool}`);
48
+ }
49
+ /** Allow rules, in Claude's mcp__<server>__<tool> form, for every fleet tool in
50
+ * the member allowlist (kb_*, code_* and the self-reporting tools) -- never a
51
+ * maintainer-only or never-served tool. compose_permissions adds them to every
52
+ * composed profile so an acceptEdits session (a model without auto support)
53
+ * is not refused a member tool for lack of an allow rule. Derived, never
54
+ * hand-listed; agy maps the same tokens to mcp(<server>/<tool>). */
55
+ export function memberMcpAllowRules() {
56
+ return MEMBER_ALLOWED_TOOLS.map(tool => `mcp__${MEMBER_MCP_SERVER_NAME}__${tool}`);
57
+ }
58
+ /** agy permission deny rules: same complement, in agy's mcp(<server>/<tool>) form. */
59
+ export function agyMemberDenyRules() {
60
+ return MEMBER_DENIED_TOOLS.map(tool => `mcp(${MEMBER_MCP_SERVER_NAME}/${tool})`);
61
+ }
62
+ function isPlainObject(v) {
63
+ return typeof v === 'object' && v !== null && !Array.isArray(v);
64
+ }
65
+ /**
66
+ * Removes the legacy/superseded fleet MCP entries from a parsed config object,
67
+ * in place, and reports whether anything changed:
68
+ * - mcpServers['apra-fleet-member'] and mcp['apra-fleet-member'] (the retired
69
+ * url+bearer registration);
70
+ * - mcpServers['apra-fleet'] when it is the old blanket `{disabled: true}`
71
+ * switch compose used to write.
72
+ * Any other entry (deepwiki, user-added servers) is never touched. A map this
73
+ * prune empties is removed so no `mcpServers: {}` residue is left behind.
74
+ */
75
+ export function pruneLegacyMcpEntries(obj) {
76
+ let changed = false;
77
+ for (const mapKey of ['mcpServers', 'mcp']) {
78
+ const map = obj[mapKey];
79
+ if (!isPlainObject(map))
80
+ continue;
81
+ let touched = false;
82
+ if (LEGACY_MEMBER_MCP_SERVER_NAME in map) {
83
+ delete map[LEGACY_MEMBER_MCP_SERVER_NAME];
84
+ touched = true;
85
+ }
86
+ const fleet = map[MEMBER_MCP_SERVER_NAME];
87
+ if (isPlainObject(fleet) && fleet.disabled === true) {
88
+ delete map[MEMBER_MCP_SERVER_NAME];
89
+ touched = true;
90
+ }
91
+ if (touched) {
92
+ changed = true;
93
+ if (Object.keys(map).length === 0)
94
+ delete obj[mapKey];
95
+ }
96
+ }
97
+ return changed;
98
+ }
99
+ /** Joins `relPath` (forward-slash separated) onto an absolute member-side base
100
+ * directory, OS- and shell-appropriately. PowerShell members get backslashes;
101
+ * a Git-for-Windows (gitbash) member gets the C:/... form bash understands. */
102
+ export function joinMemberPath(base, relPath, isWindows, shell) {
103
+ if (isWindows) {
104
+ const b = base.replace(/[\\/]+$/, '').replace(/\//g, '\\');
105
+ const winPath = `${b}\\${relPath.replace(/\//g, '\\')}`;
106
+ if (isPosixShell(isWindows, shell))
107
+ return winPath.replace(/\\/g, '/');
108
+ return winPath;
109
+ }
110
+ return `${base.replace(/\/+$/, '')}/${relPath}`;
111
+ }
112
+ /**
113
+ * Quotes a resolved member-side path for a POSIX shell (bash/sh/zsh, including
114
+ * Git-for-Windows bash). Wrapped in double quotes with every character that
115
+ * stays special inside them -- $ (expansion), backtick (command substitution),
116
+ * " (ends the string), and backslash (the escape character) -- backslash-escaped,
117
+ * so the member's shell receives the path verbatim. Single quotes are literal
118
+ * inside double quotes and need nothing. A path with no metacharacter yields
119
+ * exactly `"<path>"`, the shape these commands have always carried.
120
+ */
121
+ export function quotePosixPath(p) {
122
+ return `"${p.replace(/[\\"$`]/g, '\\$&')}"`;
123
+ }
124
+ /**
125
+ * Quotes a resolved member-side path for PowerShell (5.1 and 7). Wrapped in
126
+ * double quotes with every character that stays special inside them -- $
127
+ * (expansion), backtick (the escape character), and the double-quote forms
128
+ * PowerShell recognises (ASCII " and U+201C..U+201E) -- backtick-escaped.
129
+ * Single quotes are literal inside double quotes and need nothing. A path with
130
+ * no metacharacter yields exactly `"<path>"`.
131
+ */
132
+ export function quotePwshPath(p) {
133
+ return `"${p.replace(/[`$"\u201C-\u201E]/g, '`$&')}"`;
134
+ }
135
+ /** quotePosixPath or quotePwshPath (with Windows backslashes) per shell. */
136
+ function quotePath(absPath, posix) {
137
+ return posix ? quotePosixPath(absPath) : quotePwshPath(absPath.replace(/\//g, '\\'));
138
+ }
139
+ function dirOf(absPath, posix) {
140
+ return posix
141
+ ? absPath.split('/').slice(0, -1).join('/')
142
+ : absPath.replace(/\//g, '\\').split('\\').slice(0, -1).join('\\');
143
+ }
144
+ /**
145
+ * Command string that moves `staged` to `target`, making any missing parent
146
+ * directory along the way. Target directory permissions follow the member's
147
+ * default; only the staged file itself carries owner-only permissions
148
+ * (creating its directory). POSIX also forces 0600 on the result; the staged
149
+ * file is owner-only already. Carries resolved, quoted paths only.
150
+ */
151
+ export function moveStagedFileCommand(staged, target, posix) {
152
+ if (posix) {
153
+ const dir = target.split('/').slice(0, -1).join('/');
154
+ return `mkdir -p ${quotePosixPath(dir)} && mv -f ${quotePosixPath(staged)} ${quotePosixPath(target)} && chmod 600 ${quotePosixPath(target)}`;
155
+ }
156
+ const t = target.replace(/\//g, '\\');
157
+ const dir = t.split('\\').slice(0, -1).join('\\');
158
+ return `New-Item -ItemType Directory -Force -Path ${quotePwshPath(dir)} | Out-Null; Move-Item -Force -LiteralPath ${quotePwshPath(staged.replace(/\//g, '\\'))} -Destination ${quotePwshPath(t)}`;
159
+ }
160
+ /**
161
+ * A member-side config file the apra-fleet MCP sync cannot safely touch
162
+ * (unreadable, not strict JSON, git-tracked, ...). compose_permissions treats it
163
+ * as a RECOVERABLE condition: nothing is written to that file, the member's
164
+ * fleetMcp status is recorded unavailable with `reason`, and the rest of
165
+ * compose carries on.
166
+ */
167
+ export class MemberConfigError extends Error {
168
+ code;
169
+ reason;
170
+ filePath;
171
+ constructor(code,
172
+ /** Machine-readable fleetMcp unavailable reason recorded by compose. */
173
+ reason, filePath, message) {
174
+ super(message);
175
+ this.code = code;
176
+ this.reason = reason;
177
+ this.filePath = filePath;
178
+ this.name = 'MemberConfigError';
179
+ }
180
+ }
181
+ /** The file exists but could not be read (EACCES, sharing violation, ...). */
182
+ export class MemberConfigUnreadableError extends MemberConfigError {
183
+ constructor(filePath, detail) {
184
+ super('E-MEMBER-CONFIG-UNREADABLE', 'member-config-unreadable', filePath, `E-MEMBER-CONFIG-UNREADABLE: ${filePath} exists but could not be read${detail ? ` (${detail})` : ''}; refusing to treat it as empty or rewrite it`);
185
+ this.name = 'MemberConfigUnreadableError';
186
+ }
187
+ }
188
+ /** The file exists and was read, but is not a strict JSON object (e.g. JSONC). */
189
+ export class MemberConfigNotJsonError extends MemberConfigError {
190
+ constructor(filePath, detail, reason = 'member-config-unparseable') {
191
+ super('E-MEMBER-CONFIG-NOT-JSON', reason, filePath, `E-MEMBER-CONFIG-NOT-JSON: ${filePath} ${detail}; refusing to rewrite it`);
192
+ this.name = 'MemberConfigNotJsonError';
193
+ }
194
+ }
195
+ /**
196
+ * The read command for a member-side file. The existence test is built here in
197
+ * JavaScript per shell (never shell-variable expansion): a MISSING file yields
198
+ * empty output and exit 0, an EXISTING file that cannot be read yields a
199
+ * non-zero exit -- the exit code is never swallowed.
200
+ */
201
+ export function readMemberFileCommand(absPath, posix) {
202
+ const q = quotePath(absPath, posix);
203
+ if (posix)
204
+ return `if test -e ${q}; then cat ${q}; fi`;
205
+ return `if (Test-Path -LiteralPath ${q}) { Get-Content -Raw -LiteralPath ${q} -ErrorAction Stop }`;
206
+ }
207
+ /** Read a member-side text file. A missing file reads as ''; an existing file
208
+ * that cannot be read THROWS MemberConfigUnreadableError (never reads as ''). */
209
+ export async function readMemberFile(exec, absPath, posix) {
210
+ const r = await exec(readMemberFileCommand(absPath, posix), FS_OP_TIMEOUT_MS);
211
+ if (typeof r.code === 'number' && r.code !== 0) {
212
+ throw new MemberConfigUnreadableError(absPath, `exit ${r.code}${stderrExcerpt(r)}`);
213
+ }
214
+ return r.stdout ?? '';
215
+ }
216
+ /** PowerShell regular-file probe whose exit code reflects the result (a bare
217
+ * Test-Path prints True/False and exits 0 either way). `-PathType Leaf`
218
+ * excludes directories. Single-quoted literal (no expansion at all). */
219
+ export function memberFileExistsPwshCommand(absPath) {
220
+ const p = escapePowerShellArgInner(absPath.replace(/\//g, '\\'));
221
+ return `if (Test-Path -LiteralPath '${p}' -PathType Leaf) { exit 0 } else { exit 1 }`;
222
+ }
223
+ /** POSIX regular-file probe: `test -f` (a directory, or a missing path, exits 1). */
224
+ export function memberFileExistsPosixCommand(absPath) {
225
+ return `test -f ${quotePosixPath(absPath)}`;
226
+ }
227
+ /**
228
+ * True when a regular file exists at the member-side `absPath`. A directory at
229
+ * that path reads as false (POSIX `test -f`, PowerShell `-PathType Leaf`), as
230
+ * does a missing path or any other non-zero exit. The command carries a
231
+ * resolved, quoted path only (no expansion).
232
+ */
233
+ export async function memberFileExists(exec, absPath, posix) {
234
+ const cmd = posix ? memberFileExistsPosixCommand(absPath) : memberFileExistsPwshCommand(absPath);
235
+ const r = await exec(cmd, FS_OP_TIMEOUT_MS);
236
+ return r.code === 0;
237
+ }
238
+ /**
239
+ * True when git tracks `relPath` in the member work folder
240
+ * (`git ls-files --error-unmatch`). Not a repo / git missing / untracked all
241
+ * read as false. The command carries a resolved path only (no expansion), with
242
+ * the path form the member's shell expects.
243
+ */
244
+ export async function isGitTracked(exec, workFolder, relPath, isWindows, posix) {
245
+ const wf = isWindows && !posix ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
246
+ const q = posix ? quotePosixPath : quotePwshPath;
247
+ const r = await exec(`git -C ${q(wf)} ls-files --error-unmatch -- ${q(relPath)}`, FS_OP_TIMEOUT_MS);
248
+ return r.code === 0;
249
+ }
250
+ /**
251
+ * The command that prints the git repository root of `workFolder` on the
252
+ * member. Resolved path, quoted per shell (quotePosixPath / quotePwshPath), no
253
+ * $VAR, ~ or backtick expansion for the member shell to perform.
254
+ */
255
+ export function memberRepoRootCommand(workFolder, isWindows, posix) {
256
+ const wf = isWindows && !posix ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
257
+ const q = posix ? quotePosixPath : quotePwshPath;
258
+ return `git -C ${q(wf)} rev-parse --show-toplevel`;
259
+ }
260
+ /** Forward-slash, no trailing slash: the form Claude's project keys take. */
261
+ export function normalizeProjectKey(p) {
262
+ return p.trim().replace(/\\/g, '/').replace(/\/+$/, '');
263
+ }
264
+ /**
265
+ * The key Claude Code files a work folder's LOCAL-scope MCP servers under in
266
+ * its config file (projects[<key>].mcpServers): the git repository root of the
267
+ * folder, or the exact folder outside a git repo (git missing, not a repo, an
268
+ * unusable answer). The ONE resolver for both the writer (syncMemberMcpEntry)
269
+ * and the fleetMcp probe, so they can never disagree on the key.
270
+ */
271
+ export async function resolveClaudeProjectKey(exec, workFolder, isWindows, posix) {
272
+ const fallback = normalizeProjectKey(workFolder);
273
+ try {
274
+ const r = await exec(memberRepoRootCommand(workFolder, isWindows, posix), FS_OP_TIMEOUT_MS);
275
+ if (r.code !== 0)
276
+ return fallback;
277
+ const root = (r.stdout ?? '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean).pop();
278
+ if (!root)
279
+ return fallback;
280
+ const absolute = root.startsWith('/') || /^[A-Za-z]:[\\/]/.test(root);
281
+ return absolute ? normalizeProjectKey(root) : fallback;
282
+ }
283
+ catch {
284
+ return fallback;
285
+ }
286
+ }
287
+ /** Reads and parses a member-side JSON file. Returns {} for a missing/empty
288
+ * file; THROWS a typed MemberConfigError for an unreadable file or a non-empty
289
+ * file that is not a JSON object, so a caller can never clobber a file it
290
+ * could not understand. */
291
+ export async function readMemberJson(exec, absPath, posix) {
292
+ const raw = (await readMemberFile(exec, absPath, posix)).trim();
293
+ if (!raw)
294
+ return {};
295
+ let parsed;
296
+ try {
297
+ parsed = JSON.parse(raw);
298
+ }
299
+ catch {
300
+ throw new MemberConfigNotJsonError(absPath, 'exists but is not valid JSON');
301
+ }
302
+ if (!isPlainObject(parsed))
303
+ throw new MemberConfigNotJsonError(absPath, 'is not a JSON object');
304
+ return parsed;
305
+ }
306
+ function stderrExcerpt(r) {
307
+ const s = (r.stderr ?? '').replace(/\s+/g, ' ').trim();
308
+ return s ? `: ${s.slice(0, 300)}` : '';
309
+ }
310
+ /**
311
+ * Writes `content` to a member-side file (creating its parent directory), then
312
+ * reads it back and confirms it landed. Throws on a nonzero exit or a
313
+ * read-back mismatch -- a write that did not land is never reported as done.
314
+ */
315
+ export async function writeMemberFile(exec, absPath, content, posix) {
316
+ const dir = dirOf(absPath, posix);
317
+ const qPath = quotePath(absPath, posix);
318
+ const qDir = quotePath(dir, posix);
319
+ const mkdirCmd = posix ? `mkdir -p ${qDir}` : `New-Item -ItemType Directory -Force ${qDir}`;
320
+ const mk = await exec(mkdirCmd, FS_OP_TIMEOUT_MS);
321
+ if (mk.code !== 0)
322
+ throw new Error(`could not create "${dir}" (exit ${mk.code})${stderrExcerpt(mk)}`);
323
+ const body = content.replace(/\n+$/, '');
324
+ const writeCmd = posix
325
+ ? `cat > ${qPath} << 'FLEET_PERMS_EOF'\n${body}\nFLEET_PERMS_EOF`
326
+ : `[System.IO.File]::WriteAllText(${qPath}, '${escapePowerShellArgInner(body + '\n')}', (New-Object System.Text.UTF8Encoding($false)))`;
327
+ const w = await exec(writeCmd, FS_OP_TIMEOUT_MS);
328
+ if (w.code !== 0)
329
+ throw new Error(`write of ${absPath} failed (exit ${w.code})${stderrExcerpt(w)}`);
330
+ if (!body.trim())
331
+ return; // an intentionally empty file has nothing to read back
332
+ const back = (await readMemberFile(exec, absPath, posix)).trim();
333
+ if (!back || !back.replace(/\r\n/g, '\n').includes(body.trim())) {
334
+ throw new Error(`read-back of ${absPath} did not match what was written`);
335
+ }
336
+ }
337
+ /** Writes a JSON object to a member-side file (pretty-printed), verified. */
338
+ export async function writeMemberJson(exec, absPath, obj, posix) {
339
+ await writeMemberFile(exec, absPath, JSON.stringify(obj, null, 2), posix);
340
+ }
341
+ /**
342
+ * Writes a config file that carries a member access secret WITHOUT the
343
+ * content ever appearing in a command string: staged in an owner-only file
344
+ * through the secret-file channel, then moved into place by a content-free
345
+ * command (the file stays owner-only, 0600 on POSIX). No channel -> throws loudly;
346
+ * there is no inline fallback.
347
+ */
348
+ export async function writeSecretBearingConfig(ctx, file, content, posix) {
349
+ if (!ctx.secretChannel) {
350
+ throw new Error(`E-MEMBER-CONFIG-NO-FILE-CHANNEL: cannot write ${file} on the member without putting the member access secret on a command line; no secret-file channel is available for this member. Enable the SFTP subsystem on the member's sshd, or use a member type with a file channel.`);
351
+ }
352
+ const staged = await ctx.secretChannel.write(content);
353
+ const r = await ctx.execCommand(moveStagedFileCommand(staged, file, posix), FS_OP_TIMEOUT_MS);
354
+ if (r.code !== 0) {
355
+ try {
356
+ await ctx.secretChannel.remove(staged);
357
+ }
358
+ catch { /* best effort */ }
359
+ throw new Error(`moving the staged config into ${file} failed (exit ${r.code}): ${(r.stderr || r.stdout || '').trim().slice(0, 300)}`);
360
+ }
361
+ }
362
+ /** Deletes a member-side file (no error when it is already gone). */
363
+ export async function deleteMemberFile(exec, absPath, posix) {
364
+ const cmd = posix
365
+ ? `rm -f ${quotePosixPath(absPath)}`
366
+ : `Remove-Item -Force -ErrorAction SilentlyContinue -LiteralPath ${quotePath(absPath, false)}`;
367
+ const r = await exec(cmd, FS_OP_TIMEOUT_MS);
368
+ if (r.code !== 0)
369
+ throw new Error(`delete of ${absPath} failed (exit ${r.code})${stderrExcerpt(r)}`);
370
+ }
371
+ /**
372
+ * Resolves the member work folder's git exclude file (`.git/info/exclude`, or
373
+ * the common git dir's for a worktree). Returns null when the work folder is
374
+ * not a git repository -- there is nothing to keep clean then.
375
+ */
376
+ export async function resolveGitExcludePath(exec, workFolder, isWindows, shell) {
377
+ const posix = isPosixShell(isWindows, shell);
378
+ const wf = isWindows && !posix ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
379
+ const r = await exec(`git -C ${posix ? quotePosixPath(wf) : quotePwshPath(wf)} rev-parse --git-path info/exclude`, FS_OP_TIMEOUT_MS);
380
+ const out = (r.stdout ?? '').trim().split(/\r?\n/)[0]?.trim() ?? '';
381
+ if (r.code !== 0 || !out)
382
+ return null;
383
+ const isAbs = out.startsWith('/') || /^[A-Za-z]:[\\/]/.test(out);
384
+ if (isAbs)
385
+ return isWindows && !posix ? out.replace(/\//g, '\\') : out;
386
+ return joinMemberPath(workFolder, out.replace(/\\/g, '/'), isWindows, shell);
387
+ }
388
+ /** Exclude-file line for a work-folder-relative path: anchored to the repo root. */
389
+ export function excludeLineFor(relPath) {
390
+ return `/${relPath.replace(/\\/g, '/').replace(/^\/+/, '')}`;
391
+ }
392
+ /**
393
+ * Adds each work-folder-relative path to the work folder's git exclude file so
394
+ * files fleet writes into a member clone never show the clone as dirty. Never
395
+ * touches a tracked file (.gitignore) -- info/exclude is local-only.
396
+ */
397
+ export async function ensureGitExcluded(exec, workFolder, relPaths, isWindows, shell) {
398
+ if (relPaths.length === 0)
399
+ return;
400
+ const excludePath = await resolveGitExcludePath(exec, workFolder, isWindows, shell);
401
+ if (!excludePath)
402
+ return;
403
+ const posix = isPosixShell(isWindows, shell);
404
+ const current = (await readMemberFile(exec, excludePath, posix)).replace(/\r\n/g, '\n');
405
+ const lines = current.split('\n').map(l => l.trim());
406
+ const missing = [...new Set(relPaths.map(excludeLineFor))].filter(l => !lines.includes(l));
407
+ if (missing.length === 0)
408
+ return;
409
+ const base = current.replace(/\n+$/, '');
410
+ const next = (base ? `${base}\n` : '') + missing.join('\n');
411
+ await writeMemberFile(exec, excludePath, next, posix);
412
+ }
413
+ /** Removes the exclude lines ensureGitExcluded added for `relPaths`. */
414
+ export async function removeGitExcluded(exec, workFolder, relPaths, isWindows, shell) {
415
+ if (relPaths.length === 0)
416
+ return;
417
+ const excludePath = await resolveGitExcludePath(exec, workFolder, isWindows, shell);
418
+ if (!excludePath)
419
+ return;
420
+ const posix = isPosixShell(isWindows, shell);
421
+ const current = (await readMemberFile(exec, excludePath, posix)).replace(/\r\n/g, '\n');
422
+ if (!current.trim())
423
+ return;
424
+ const drop = new Set(relPaths.map(excludeLineFor));
425
+ const kept = current.replace(/\n+$/, '').split('\n').filter(l => !drop.has(l.trim()));
426
+ const next = kept.join('\n');
427
+ if (next === current.replace(/\n+$/, ''))
428
+ return;
429
+ await writeMemberFile(exec, excludePath, next, posix);
430
+ }
431
+ /**
432
+ * Prunes the legacy fleet MCP entries (pruneLegacyMcpEntries) from an EXISTING
433
+ * member-side JSON config file. A missing/empty file is left alone (never
434
+ * created); the file is rewritten only when something was actually removed.
435
+ * Returns whether it changed the file.
436
+ */
437
+ export async function pruneLegacyMcpInMemberFile(exec, absPath, posix) {
438
+ const config = await readMemberJson(exec, absPath, posix);
439
+ if (Object.keys(config).length === 0)
440
+ return false;
441
+ if (!pruneLegacyMcpEntries(config))
442
+ return false;
443
+ await writeMemberJson(exec, absPath, config, posix);
444
+ return true;
445
+ }
446
+ //# sourceMappingURL=member-config-io.js.map