@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -49,6 +49,21 @@ export type KBEntryInput = Omit<KBEntry, 'id' | 'stale' | 'created_at' | 'supers
49
49
  export interface CaptureOpts {
50
50
  importMode?: boolean;
51
51
  preferredId?: string;
52
+ verbatim?: boolean;
53
+ carriedBasis?: Record<string, string> | null;
54
+ keepConfirmed?: boolean;
55
+ }
56
+ /** SqliteProvider.capture() result. */
57
+ export interface CaptureResult {
58
+ id: string;
59
+ audn_decision: AudnDecision;
60
+ /** CONFIRMED supersede targets left live (keepConfirmed); present only when non-empty. */
61
+ refused?: string[];
62
+ }
63
+ export interface EntryTrustFilter {
64
+ confidence?: Confidence[];
65
+ exclude_disputed?: boolean;
66
+ owner_tag?: string;
52
67
  }
53
68
  export interface QueryOptions {
54
69
  query?: string;
@@ -61,6 +76,9 @@ export interface QueryOptions {
61
76
  include_stale?: boolean;
62
77
  include_superseded?: boolean;
63
78
  flagged_only?: boolean;
79
+ confidence?: Confidence[];
80
+ exclude_disputed?: boolean;
81
+ owner_tag?: string;
64
82
  l1_only?: boolean;
65
83
  limit?: number;
66
84
  ids?: string[];
@@ -83,6 +101,9 @@ export interface PrimeOptions {
83
101
  hint_symbols?: string[];
84
102
  hint_modules?: string[];
85
103
  decay_after_days?: number;
104
+ confidence?: Confidence[];
105
+ exclude_disputed?: boolean;
106
+ owner_tag?: string;
86
107
  }
87
108
  export interface PrimedContext {
88
109
  session_warm: boolean;
@@ -135,6 +156,27 @@ export interface ProviderConfig {
135
156
  url?: string;
136
157
  dbPath?: string;
137
158
  }
159
+ export interface DiscardResult {
160
+ discarded: string[];
161
+ not_found: string[];
162
+ already_discarded: string[];
163
+ /**
164
+ * Live CONFIRMED ids left untouched because the call asked to keep CONFIRMED
165
+ * entries (keepConfirmed: a member session without the kb_maintainer grant).
166
+ * Present only when keepConfirmed was set.
167
+ */
168
+ refused?: string[];
169
+ }
170
+ /** Options for id-level discard / file invalidation. */
171
+ export interface RetireOptions {
172
+ /** MEMBER own-scope: act only on entries carrying this tag. */
173
+ ownerTag?: string;
174
+ /**
175
+ * Leave CONFIRMED entries untouched and report them as refused (a member
176
+ * session without the kb_maintainer grant may not retire CONFIRMED).
177
+ */
178
+ keepConfirmed?: boolean;
179
+ }
138
180
  export interface MemoryProvider {
139
181
  init(): Promise<void>;
140
182
  capture(input: KBEntryInput): Promise<{
@@ -142,10 +184,11 @@ export interface MemoryProvider {
142
184
  audn_decision: AudnDecision;
143
185
  }>;
144
186
  query(opts: QueryOptions): Promise<KBResult>;
145
- context(files: string[]): Promise<FileContextResult[]>;
187
+ context(files: string[], confidence?: Confidence[], excludeDisputed?: boolean): Promise<FileContextResult[]>;
146
188
  invalidate(files: string[]): Promise<{
147
189
  invalidated: number;
148
190
  }>;
191
+ discard(ids: string[], opts?: RetireOptions): Promise<DiscardResult>;
149
192
  getLinked(id: string): Promise<KBEntry[]>;
150
193
  prime(opts: PrimeOptions): Promise<PrimedContext>;
151
194
  promote(id: string, reason?: string): Promise<{
@@ -158,6 +201,6 @@ export interface MemoryProvider {
158
201
  symbols?: string[];
159
202
  }): Promise<ProviderStats>;
160
203
  touch(ids: string[]): Promise<number>;
161
- relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
204
+ relatedClaims(ids: string[], limit?: number, filter?: EntryTrustFilter): Promise<KBEntry[]>;
162
205
  }
163
206
  //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,70 @@
1
+ import type { Agent } from '../types.js';
2
+ import { type MemberExecFn } from './member-config-io.js';
3
+ /** File name of the secret inside an install's data dir. */
4
+ export declare const MEMBER_ACCESS_SECRET_FILE = "member-access.key";
5
+ /** The HTTP header a `?member=` request carries the secret in. A dedicated
6
+ * header (not Authorization) so it never meets the member-JWT bearer check. */
7
+ export declare const MEMBER_SECRET_HEADER = "X-Apra-Fleet-Member-Secret";
8
+ /** True for a well-formed secret (64 lowercase hex chars). */
9
+ export declare function isValidMemberAccessSecret(v: unknown): v is string;
10
+ /** A fresh random secret. */
11
+ export declare function generateMemberAccessSecret(): string;
12
+ /** Absolute path of the secret file in `dataDir` (default: this process's data dir). */
13
+ export declare function memberAccessSecretPath(dataDir?: string): string;
14
+ /** The secret stored at `filePath`, or null when missing, unreadable or malformed. */
15
+ export declare function readMemberAccessSecret(filePath?: string): string | null;
16
+ /**
17
+ * The secret at `filePath`, created (owner-only, 0600) when missing or
18
+ * malformed. Creation is exclusive (`wx`): two processes racing to create it
19
+ * agree on whichever landed first. Windows ignores the mode; the file then
20
+ * inherits the user profile's ACL, as fleet.key does.
21
+ */
22
+ export declare function getOrCreateMemberAccessSecret(filePath?: string): string;
23
+ /** Constant-time comparison of a presented header value with the expected secret. */
24
+ export declare function memberAccessSecretMatches(presented: string | string[] | undefined, expected: string | null): boolean;
25
+ /**
26
+ * The secret a session for `agent` must present to the member's own server:
27
+ * this install's own secret for a local member (it shares this server), the
28
+ * stored copy of the member install's secret for a remote one (null until a
29
+ * fleetMcp probe read it -- an install older than the secret does not check it).
30
+ */
31
+ export declare function memberMcpSecret(agent: Pick<Agent, 'agentType' | 'encryptedMemberMcpSecret'>): string | null;
32
+ /** The headers a member MCP entry/config carries for `agent` (undefined when no secret is known). */
33
+ export declare function memberMcpHeaders(agent: Pick<Agent, 'agentType' | 'encryptedMemberMcpSecret'>): Record<string, string> | undefined;
34
+ /** <home>/.apra-fleet/data/member-access.key on the member (the member-install marker's dir). */
35
+ export declare function memberAccessSecretPathFor(home: string, agent: Agent): string;
36
+ export { moveStagedFileCommand } from './member-config-io.js';
37
+ /** Stages content in a fresh owner-only file on the member; returns its path. */
38
+ export type StageSecretFileFn = (agent: Agent, content: string) => Promise<string>;
39
+ /**
40
+ * Writes `content` to the member-side `target` WITHOUT it ever appearing in a
41
+ * command string: staged through the owner-only secret-file channel, then
42
+ * moved into place by a content-free command. A failed move removes the
43
+ * staged file (best effort, via `removeStaged`). Throws on failure.
44
+ */
45
+ export declare function deliverMemberFileViaSecretChannel(agent: Agent, exec: MemberExecFn, target: string, content: string, stage: StageSecretFileFn, removeStaged?: (agent: Agent, filePath: string) => Promise<void>): Promise<void>;
46
+ export type RemoteMemberSecretResult = {
47
+ kind: 'found';
48
+ secret: string;
49
+ } | {
50
+ kind: 'created';
51
+ secret: string;
52
+ } | {
53
+ kind: 'absent';
54
+ detail: string;
55
+ } | {
56
+ kind: 'failed';
57
+ detail: string;
58
+ };
59
+ /**
60
+ * Reads the member install's secret; when it has none (an install older than
61
+ * the secret) and `create` is set (an install was requested: fleet_install
62
+ * "auto"), creates one there through the secret-file channel and verifies it
63
+ * landed. Never throws.
64
+ */
65
+ export declare function ensureRemoteMemberAccessSecret(agent: Agent, home: string, deps: {
66
+ exec: MemberExecFn;
67
+ stage?: StageSecretFileFn;
68
+ removeStaged?: (agent: Agent, filePath: string) => Promise<void>;
69
+ }, create: boolean): Promise<RemoteMemberSecretResult>;
70
+ //# sourceMappingURL=member-access-secret.d.ts.map
@@ -0,0 +1,195 @@
1
+ // Per-install member access secret (apra-fleet-b4g.122.4).
2
+ //
3
+ // Every apra-fleet install keeps one random secret in an owner-only file in
4
+ // its OWN data dir (<data dir>/member-access.key, mode 0600). Its server
5
+ // accepts a `?member=<uuid>` MCP session only when the request presents that
6
+ // secret in the MEMBER_SECRET_HEADER header (src/services/http-transport.ts).
7
+ // The server binds loopback, so without this any local user's session could
8
+ // reach any member install on the host; with it, only a reader of the
9
+ // install's data dir -- its own user -- can open a member session there.
10
+ //
11
+ // Who presents it:
12
+ // - the client's connectFleetMember (packages/apra-fleet-client), which reads
13
+ // the secret from the same data dir it resolves the server from -- so the
14
+ // `apra-fleet call` verb on a member and the engine's memberCall work;
15
+ // - Claude sessions execute_prompt starts: the per-session MCP config carries
16
+ // it as an http header (session-mcp-config.ts);
17
+ // - the per-folder member MCP entry compose_permissions writes (claude local
18
+ // scope in ~/.claude.json, opencode's opencode.json, agy's mcp_config.json).
19
+ //
20
+ // For a LOCAL member the orchestrator's own secret is used (it shares this
21
+ // server). For a REMOTE member the orchestrator reads its install's secret on
22
+ // the member during the fleetMcp probe -- and creates it there when an older
23
+ // install has none and an install was requested (fleet_install "auto") -- and
24
+ // keeps it encrypted in the registry (Agent.encryptedMemberMcpSecret).
25
+ //
26
+ // The secret NEVER appears in a member-bound command string: it is created on
27
+ // the member through the owner-only secret-file channel (SFTP / private temp
28
+ // file) and moved into place with a content-free command, and every config
29
+ // file carrying it is delivered the same way. Reading it back uses `cat` /
30
+ // Get-Content, whose command names only the path.
31
+ import fs from 'node:fs';
32
+ import path from 'node:path';
33
+ import crypto from 'node:crypto';
34
+ import { FLEET_DIR } from '../paths.js';
35
+ import { getAgentOS, getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
36
+ import { decryptPassword } from '../utils/crypto.js';
37
+ import { joinMemberPath, moveStagedFileCommand, readMemberFile } from './member-config-io.js';
38
+ /** File name of the secret inside an install's data dir. */
39
+ export const MEMBER_ACCESS_SECRET_FILE = 'member-access.key';
40
+ /** The HTTP header a `?member=` request carries the secret in. A dedicated
41
+ * header (not Authorization) so it never meets the member-JWT bearer check. */
42
+ export const MEMBER_SECRET_HEADER = 'X-Apra-Fleet-Member-Secret';
43
+ const SECRET_RE = /^[0-9a-f]{64}$/;
44
+ /** True for a well-formed secret (64 lowercase hex chars). */
45
+ export function isValidMemberAccessSecret(v) {
46
+ return typeof v === 'string' && SECRET_RE.test(v);
47
+ }
48
+ /** A fresh random secret. */
49
+ export function generateMemberAccessSecret() {
50
+ return crypto.randomBytes(32).toString('hex');
51
+ }
52
+ /** Absolute path of the secret file in `dataDir` (default: this process's data dir). */
53
+ export function memberAccessSecretPath(dataDir = FLEET_DIR) {
54
+ return path.join(dataDir, MEMBER_ACCESS_SECRET_FILE);
55
+ }
56
+ /** The secret stored at `filePath`, or null when missing, unreadable or malformed. */
57
+ export function readMemberAccessSecret(filePath = memberAccessSecretPath()) {
58
+ try {
59
+ const v = fs.readFileSync(filePath, 'utf8').trim();
60
+ return isValidMemberAccessSecret(v) ? v : null;
61
+ }
62
+ catch {
63
+ return null;
64
+ }
65
+ }
66
+ /**
67
+ * The secret at `filePath`, created (owner-only, 0600) when missing or
68
+ * malformed. Creation is exclusive (`wx`): two processes racing to create it
69
+ * agree on whichever landed first. Windows ignores the mode; the file then
70
+ * inherits the user profile's ACL, as fleet.key does.
71
+ */
72
+ export function getOrCreateMemberAccessSecret(filePath = memberAccessSecretPath()) {
73
+ const existing = readMemberAccessSecret(filePath);
74
+ if (existing)
75
+ return existing;
76
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
77
+ const secret = generateMemberAccessSecret();
78
+ try {
79
+ fs.writeFileSync(filePath, secret + '\n', { encoding: 'utf8', mode: 0o600, flag: 'wx' });
80
+ return secret;
81
+ }
82
+ catch (err) {
83
+ if (err.code !== 'EEXIST')
84
+ throw err;
85
+ }
86
+ // Present but malformed (EEXIST): another writer won the race, or a corrupt
87
+ // file sits there. Use a valid one; replace a corrupt one.
88
+ const raced = readMemberAccessSecret(filePath);
89
+ if (raced)
90
+ return raced;
91
+ fs.writeFileSync(filePath, secret + '\n', { encoding: 'utf8', mode: 0o600 });
92
+ try {
93
+ fs.chmodSync(filePath, 0o600);
94
+ }
95
+ catch { /* Windows */ }
96
+ return secret;
97
+ }
98
+ /** Constant-time comparison of a presented header value with the expected secret. */
99
+ export function memberAccessSecretMatches(presented, expected) {
100
+ if (!expected || typeof presented !== 'string')
101
+ return false;
102
+ const a = Buffer.from(presented.trim(), 'utf8');
103
+ const b = Buffer.from(expected, 'utf8');
104
+ return a.length === b.length && crypto.timingSafeEqual(a, b);
105
+ }
106
+ /**
107
+ * The secret a session for `agent` must present to the member's own server:
108
+ * this install's own secret for a local member (it shares this server), the
109
+ * stored copy of the member install's secret for a remote one (null until a
110
+ * fleetMcp probe read it -- an install older than the secret does not check it).
111
+ */
112
+ export function memberMcpSecret(agent) {
113
+ if (agent.agentType === 'local') {
114
+ try {
115
+ return getOrCreateMemberAccessSecret();
116
+ }
117
+ catch {
118
+ return null;
119
+ }
120
+ }
121
+ if (!agent.encryptedMemberMcpSecret)
122
+ return null;
123
+ try {
124
+ const v = decryptPassword(agent.encryptedMemberMcpSecret);
125
+ return isValidMemberAccessSecret(v) ? v : null;
126
+ }
127
+ catch {
128
+ return null;
129
+ }
130
+ }
131
+ /** The headers a member MCP entry/config carries for `agent` (undefined when no secret is known). */
132
+ export function memberMcpHeaders(agent) {
133
+ const secret = memberMcpSecret(agent);
134
+ return secret ? { [MEMBER_SECRET_HEADER]: secret } : undefined;
135
+ }
136
+ // ---------------------------------------------------------------------------
137
+ // Remote members: the secret in the member install's data dir
138
+ // ---------------------------------------------------------------------------
139
+ /** <home>/.apra-fleet/data/member-access.key on the member (the member-install marker's dir). */
140
+ export function memberAccessSecretPathFor(home, agent) {
141
+ return joinMemberPath(home, `.apra-fleet/data/${MEMBER_ACCESS_SECRET_FILE}`, getAgentOS(agent) === 'windows', getAgentShell(agent));
142
+ }
143
+ export { moveStagedFileCommand } from './member-config-io.js';
144
+ /**
145
+ * Writes `content` to the member-side `target` WITHOUT it ever appearing in a
146
+ * command string: staged through the owner-only secret-file channel, then
147
+ * moved into place by a content-free command. A failed move removes the
148
+ * staged file (best effort, via `removeStaged`). Throws on failure.
149
+ */
150
+ export async function deliverMemberFileViaSecretChannel(agent, exec, target, content, stage, removeStaged) {
151
+ const posix = isPosixShell(getAgentOS(agent), getAgentShell(agent));
152
+ const staged = await stage(agent, content);
153
+ const r = await exec(moveStagedFileCommand(staged, target, posix), 15000);
154
+ if (r.code !== 0) {
155
+ if (removeStaged) {
156
+ try {
157
+ await removeStaged(agent, staged);
158
+ }
159
+ catch { /* best effort */ }
160
+ }
161
+ throw new Error(`moving the staged file into ${target} failed (exit ${r.code}): ${(r.stderr || r.stdout || '').trim().slice(0, 300)}`);
162
+ }
163
+ }
164
+ /**
165
+ * Reads the member install's secret; when it has none (an install older than
166
+ * the secret) and `create` is set (an install was requested: fleet_install
167
+ * "auto"), creates one there through the secret-file channel and verifies it
168
+ * landed. Never throws.
169
+ */
170
+ export async function ensureRemoteMemberAccessSecret(agent, home, deps, create) {
171
+ const posix = isPosixShell(getAgentOS(agent), getAgentShell(agent));
172
+ const target = memberAccessSecretPathFor(home, agent);
173
+ const read = async () => {
174
+ const v = (await readMemberFile(deps.exec, target, posix)).trim();
175
+ return isValidMemberAccessSecret(v) ? v : null;
176
+ };
177
+ try {
178
+ const existing = await read();
179
+ if (existing)
180
+ return { kind: 'found', secret: existing };
181
+ if (!create || !deps.stage) {
182
+ return { kind: 'absent', detail: `the member install has no member access secret at ${target} (an install older than the secret, whose server does not check it); run update_member with fleet_install "auto" to create it` };
183
+ }
184
+ const secret = generateMemberAccessSecret();
185
+ await deliverMemberFileViaSecretChannel(agent, deps.exec, target, secret + '\n', deps.stage, deps.removeStaged);
186
+ const back = await read();
187
+ if (back !== secret)
188
+ return { kind: 'failed', detail: `the member access secret written to ${target} did not read back` };
189
+ return { kind: 'created', secret };
190
+ }
191
+ catch (err) {
192
+ return { kind: 'failed', detail: `the member access secret at ${target} could not be read or created: ${err instanceof Error ? err.message : String(err)}` };
193
+ }
194
+ }
195
+ //# sourceMappingURL=member-access-secret.js.map
@@ -0,0 +1,24 @@
1
+ /** Tool-name prefixes whose calls are counted. */
2
+ export declare const COUNTED_TOOL_PREFIXES: readonly string[];
3
+ export interface MemberCallStats {
4
+ member_id: string;
5
+ /** ISO time the counters started (server process start or last reset). */
6
+ since: string;
7
+ kb: number;
8
+ code: number;
9
+ total: number;
10
+ /** Per-tool counts (only tools called at least once). */
11
+ tools: Record<string, number>;
12
+ }
13
+ /** True when a call to `toolName` is a counted kb_ / code_ call. */
14
+ export declare function isCountedTool(toolName: string): boolean;
15
+ /**
16
+ * Record one tool call from a member session. A no-op for an uncounted tool,
17
+ * a missing member id, or an engine-origin session.
18
+ */
19
+ export declare function recordMemberToolCall(memberId: string | undefined, toolName: string, engineOrigin: boolean): void;
20
+ /** The aggregated counts for one member (zeros when it made no counted call). */
21
+ export declare function getMemberCallStats(memberId: string): MemberCallStats;
22
+ /** Test-only: clear every counter and restart `since`. */
23
+ export declare function resetMemberCallCounts(): void;
24
+ //# sourceMappingURL=member-call-counts.d.ts.map
@@ -0,0 +1,58 @@
1
+ // Per-member kb_* / code_* tool call counts (in memory, this server process).
2
+ //
3
+ // Every kb_* and code_* call made from a MEMBER session (a session identified
4
+ // as a registered member by a member JWT or ?member=<uuid>) is counted against
5
+ // that member's uuid, aggregated across all of the member's sessions on this
6
+ // server. Calls from an ENGINE-ORIGIN session (one opened with origin=engine on
7
+ // the MCP URL -- only the engine's memberCall local adapter and the
8
+ // `apra-fleet call` verb set it) are NOT counted: those are the engine's own
9
+ // reads (including the session_stats snapshots themselves), not the member's
10
+ // agent using the tools. FULL (non-member) sessions are never counted.
11
+ //
12
+ // The counts are cumulative since COUNTS_SINCE (process start, or the last
13
+ // test reset). A reader takes before/after snapshots and diffs them; a change
14
+ // in `since` between two snapshots means the server restarted and the delta
15
+ // is not meaningful.
16
+ /** Tool-name prefixes whose calls are counted. */
17
+ export const COUNTED_TOOL_PREFIXES = Object.freeze(['kb_', 'code_']);
18
+ const counts = new Map();
19
+ let since = new Date().toISOString();
20
+ /** True when a call to `toolName` is a counted kb_ / code_ call. */
21
+ export function isCountedTool(toolName) {
22
+ return COUNTED_TOOL_PREFIXES.some(p => toolName.startsWith(p));
23
+ }
24
+ /**
25
+ * Record one tool call from a member session. A no-op for an uncounted tool,
26
+ * a missing member id, or an engine-origin session.
27
+ */
28
+ export function recordMemberToolCall(memberId, toolName, engineOrigin) {
29
+ if (!memberId || engineOrigin || !isCountedTool(toolName))
30
+ return;
31
+ let c = counts.get(memberId);
32
+ if (!c) {
33
+ c = { kb: 0, code: 0, tools: new Map() };
34
+ counts.set(memberId, c);
35
+ }
36
+ if (toolName.startsWith('kb_'))
37
+ c.kb++;
38
+ else
39
+ c.code++;
40
+ c.tools.set(toolName, (c.tools.get(toolName) ?? 0) + 1);
41
+ }
42
+ /** The aggregated counts for one member (zeros when it made no counted call). */
43
+ export function getMemberCallStats(memberId) {
44
+ const c = counts.get(memberId);
45
+ const tools = {};
46
+ if (c)
47
+ for (const [k, v] of [...c.tools.entries()].sort(([a], [b]) => a.localeCompare(b)))
48
+ tools[k] = v;
49
+ const kb = c?.kb ?? 0;
50
+ const code = c?.code ?? 0;
51
+ return { member_id: memberId, since, kb, code, total: kb + code, tools };
52
+ }
53
+ /** Test-only: clear every counter and restart `since`. */
54
+ export function resetMemberCallCounts() {
55
+ counts.clear();
56
+ since = new Date().toISOString();
57
+ }
58
+ //# sourceMappingURL=member-call-counts.js.map
@@ -0,0 +1,192 @@
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 this process's port (honoring
14
+ * an APRA_FLEET_PORT sandbox); a remote member talks to its OWN install, on
15
+ * the port that install records in its member-install marker
16
+ * (agent.memberMcpPort, resolved on the member by the fleetMcp probe), or the
17
+ * built-in default when it recorded none (the probe reports that in fleetMcp
18
+ * detail). Two member installs on one host (one per Unix user) therefore each
19
+ * get their own server, never the other user's.
20
+ */
21
+ export declare function memberMcpUrl(agent: Pick<Agent, 'id' | 'agentType' | 'memberMcpPort'>): string;
22
+ /** Claude permission deny rules: every registered fleet tool outside the member
23
+ * allowlist, on the member's apra-fleet server. Derived, never hand-listed. */
24
+ export declare function claudeMemberDenyRules(): string[];
25
+ /** Allow rules, in Claude's mcp__<server>__<tool> form, for every fleet tool in
26
+ * the member allowlist (kb_*, code_* and the self-reporting tools) -- never a
27
+ * maintainer-only or never-served tool. compose_permissions adds them to every
28
+ * composed profile so an acceptEdits session (a model without auto support)
29
+ * is not refused a member tool for lack of an allow rule. Derived, never
30
+ * hand-listed; agy maps the same tokens to mcp(<server>/<tool>). */
31
+ export declare function memberMcpAllowRules(): string[];
32
+ /** agy permission deny rules: same complement, in agy's mcp(<server>/<tool>) form. */
33
+ export declare function agyMemberDenyRules(): string[];
34
+ /**
35
+ * Removes the legacy/superseded fleet MCP entries from a parsed config object,
36
+ * in place, and reports whether anything changed:
37
+ * - mcpServers['apra-fleet-member'] and mcp['apra-fleet-member'] (the retired
38
+ * url+bearer registration);
39
+ * - mcpServers['apra-fleet'] when it is the old blanket `{disabled: true}`
40
+ * switch compose used to write.
41
+ * Any other entry (deepwiki, user-added servers) is never touched. A map this
42
+ * prune empties is removed so no `mcpServers: {}` residue is left behind.
43
+ */
44
+ export declare function pruneLegacyMcpEntries(obj: Record<string, unknown>): boolean;
45
+ /** Joins `relPath` (forward-slash separated) onto an absolute member-side base
46
+ * directory, OS- and shell-appropriately. PowerShell members get backslashes;
47
+ * a Git-for-Windows (gitbash) member gets the C:/... form bash understands. */
48
+ export declare function joinMemberPath(base: string, relPath: string, isWindows: boolean, shell?: MemberShell): string;
49
+ /**
50
+ * Quotes a resolved member-side path for a POSIX shell (bash/sh/zsh, including
51
+ * Git-for-Windows bash). Wrapped in double quotes with every character that
52
+ * stays special inside them -- $ (expansion), backtick (command substitution),
53
+ * " (ends the string), and backslash (the escape character) -- backslash-escaped,
54
+ * so the member's shell receives the path verbatim. Single quotes are literal
55
+ * inside double quotes and need nothing. A path with no metacharacter yields
56
+ * exactly `"<path>"`, the shape these commands have always carried.
57
+ */
58
+ export declare function quotePosixPath(p: string): string;
59
+ /**
60
+ * Quotes a resolved member-side path for PowerShell (5.1 and 7). Wrapped in
61
+ * double quotes with every character that stays special inside them -- $
62
+ * (expansion), backtick (the escape character), and the double-quote forms
63
+ * PowerShell recognises (ASCII " and U+201C..U+201E) -- backtick-escaped.
64
+ * Single quotes are literal inside double quotes and need nothing. A path with
65
+ * no metacharacter yields exactly `"<path>"`.
66
+ */
67
+ export declare function quotePwshPath(p: string): string;
68
+ /**
69
+ * Command string that moves `staged` to `target`, making any missing parent
70
+ * directory along the way. Target directory permissions follow the member's
71
+ * default; only the staged file itself carries owner-only permissions
72
+ * (creating its directory). POSIX also forces 0600 on the result; the staged
73
+ * file is owner-only already. Carries resolved, quoted paths only.
74
+ */
75
+ export declare function moveStagedFileCommand(staged: string, target: string, posix: boolean): string;
76
+ /**
77
+ * A member-side config file the apra-fleet MCP sync cannot safely touch
78
+ * (unreadable, not strict JSON, git-tracked, ...). compose_permissions treats it
79
+ * as a RECOVERABLE condition: nothing is written to that file, the member's
80
+ * fleetMcp status is recorded unavailable with `reason`, and the rest of
81
+ * compose carries on.
82
+ */
83
+ export declare class MemberConfigError extends Error {
84
+ readonly code: string;
85
+ /** Machine-readable fleetMcp unavailable reason recorded by compose. */
86
+ readonly reason: string;
87
+ readonly filePath: string;
88
+ constructor(code: string,
89
+ /** Machine-readable fleetMcp unavailable reason recorded by compose. */
90
+ reason: string, filePath: string, message: string);
91
+ }
92
+ /** The file exists but could not be read (EACCES, sharing violation, ...). */
93
+ export declare class MemberConfigUnreadableError extends MemberConfigError {
94
+ constructor(filePath: string, detail?: string);
95
+ }
96
+ /** The file exists and was read, but is not a strict JSON object (e.g. JSONC). */
97
+ export declare class MemberConfigNotJsonError extends MemberConfigError {
98
+ constructor(filePath: string, detail: string, reason?: string);
99
+ }
100
+ /**
101
+ * The read command for a member-side file. The existence test is built here in
102
+ * JavaScript per shell (never shell-variable expansion): a MISSING file yields
103
+ * empty output and exit 0, an EXISTING file that cannot be read yields a
104
+ * non-zero exit -- the exit code is never swallowed.
105
+ */
106
+ export declare function readMemberFileCommand(absPath: string, posix: boolean): string;
107
+ /** Read a member-side text file. A missing file reads as ''; an existing file
108
+ * that cannot be read THROWS MemberConfigUnreadableError (never reads as ''). */
109
+ export declare function readMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<string>;
110
+ /** PowerShell regular-file probe whose exit code reflects the result (a bare
111
+ * Test-Path prints True/False and exits 0 either way). `-PathType Leaf`
112
+ * excludes directories. Single-quoted literal (no expansion at all). */
113
+ export declare function memberFileExistsPwshCommand(absPath: string): string;
114
+ /** POSIX regular-file probe: `test -f` (a directory, or a missing path, exits 1). */
115
+ export declare function memberFileExistsPosixCommand(absPath: string): string;
116
+ /**
117
+ * True when a regular file exists at the member-side `absPath`. A directory at
118
+ * that path reads as false (POSIX `test -f`, PowerShell `-PathType Leaf`), as
119
+ * does a missing path or any other non-zero exit. The command carries a
120
+ * resolved, quoted path only (no expansion).
121
+ */
122
+ export declare function memberFileExists(exec: MemberExecFn, absPath: string, posix: boolean): Promise<boolean>;
123
+ /**
124
+ * True when git tracks `relPath` in the member work folder
125
+ * (`git ls-files --error-unmatch`). Not a repo / git missing / untracked all
126
+ * read as false. The command carries a resolved path only (no expansion), with
127
+ * the path form the member's shell expects.
128
+ */
129
+ export declare function isGitTracked(exec: MemberExecFn, workFolder: string, relPath: string, isWindows: boolean, posix: boolean): Promise<boolean>;
130
+ /**
131
+ * The command that prints the git repository root of `workFolder` on the
132
+ * member. Resolved path, quoted per shell (quotePosixPath / quotePwshPath), no
133
+ * $VAR, ~ or backtick expansion for the member shell to perform.
134
+ */
135
+ export declare function memberRepoRootCommand(workFolder: string, isWindows: boolean, posix: boolean): string;
136
+ /** Forward-slash, no trailing slash: the form Claude's project keys take. */
137
+ export declare function normalizeProjectKey(p: string): string;
138
+ /**
139
+ * The key Claude Code files a work folder's LOCAL-scope MCP servers under in
140
+ * its config file (projects[<key>].mcpServers): the git repository root of the
141
+ * folder, or the exact folder outside a git repo (git missing, not a repo, an
142
+ * unusable answer). The ONE resolver for both the writer (syncMemberMcpEntry)
143
+ * and the fleetMcp probe, so they can never disagree on the key.
144
+ */
145
+ export declare function resolveClaudeProjectKey(exec: MemberExecFn, workFolder: string, isWindows: boolean, posix: boolean): Promise<string>;
146
+ /** Reads and parses a member-side JSON file. Returns {} for a missing/empty
147
+ * file; THROWS a typed MemberConfigError for an unreadable file or a non-empty
148
+ * file that is not a JSON object, so a caller can never clobber a file it
149
+ * could not understand. */
150
+ export declare function readMemberJson(exec: MemberExecFn, absPath: string, posix: boolean): Promise<Record<string, unknown>>;
151
+ /**
152
+ * Writes `content` to a member-side file (creating its parent directory), then
153
+ * reads it back and confirms it landed. Throws on a nonzero exit or a
154
+ * read-back mismatch -- a write that did not land is never reported as done.
155
+ */
156
+ export declare function writeMemberFile(exec: MemberExecFn, absPath: string, content: string, posix: boolean): Promise<void>;
157
+ /** Writes a JSON object to a member-side file (pretty-printed), verified. */
158
+ export declare function writeMemberJson(exec: MemberExecFn, absPath: string, obj: Record<string, unknown>, posix: boolean): Promise<void>;
159
+ /**
160
+ * Writes a config file that carries a member access secret WITHOUT the
161
+ * content ever appearing in a command string: staged in an owner-only file
162
+ * through the secret-file channel, then moved into place by a content-free
163
+ * command (the file stays owner-only, 0600 on POSIX). No channel -> throws loudly;
164
+ * there is no inline fallback.
165
+ */
166
+ export declare function writeSecretBearingConfig(ctx: MemberMcpSyncContext, file: string, content: string, posix: boolean): Promise<void>;
167
+ /** Deletes a member-side file (no error when it is already gone). */
168
+ export declare function deleteMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<void>;
169
+ /**
170
+ * Resolves the member work folder's git exclude file (`.git/info/exclude`, or
171
+ * the common git dir's for a worktree). Returns null when the work folder is
172
+ * not a git repository -- there is nothing to keep clean then.
173
+ */
174
+ export declare function resolveGitExcludePath(exec: MemberExecFn, workFolder: string, isWindows: boolean, shell?: MemberShell): Promise<string | null>;
175
+ /** Exclude-file line for a work-folder-relative path: anchored to the repo root. */
176
+ export declare function excludeLineFor(relPath: string): string;
177
+ /**
178
+ * Adds each work-folder-relative path to the work folder's git exclude file so
179
+ * files fleet writes into a member clone never show the clone as dirty. Never
180
+ * touches a tracked file (.gitignore) -- info/exclude is local-only.
181
+ */
182
+ export declare function ensureGitExcluded(exec: MemberExecFn, workFolder: string, relPaths: string[], isWindows: boolean, shell?: MemberShell): Promise<void>;
183
+ /** Removes the exclude lines ensureGitExcluded added for `relPaths`. */
184
+ export declare function removeGitExcluded(exec: MemberExecFn, workFolder: string, relPaths: string[], isWindows: boolean, shell?: MemberShell): Promise<void>;
185
+ /**
186
+ * Prunes the legacy fleet MCP entries (pruneLegacyMcpEntries) from an EXISTING
187
+ * member-side JSON config file. A missing/empty file is left alone (never
188
+ * created); the file is rewritten only when something was actually removed.
189
+ * Returns whether it changed the file.
190
+ */
191
+ export declare function pruneLegacyMcpInMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<boolean>;
192
+ //# sourceMappingURL=member-config-io.d.ts.map