@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -6,13 +6,19 @@ import { collectOobPassword } from '../services/auth-socket.js';
6
6
  import { credentialResolve } from '../services/credential-store.js';
7
7
  import { isValidIcon, resolveIcon, DEFAULT_ICON } from '../services/icons.js';
8
8
  import { writeStatusline } from '../services/statusline.js';
9
- import { logLine } from '../utils/log-helpers.js';
9
+ import { logLine, logWarn } from '../utils/log-helpers.js';
10
+ import { findSecretTokens, legacyTokenWarning } from '../services/secret-token.js';
10
11
  import { invalidatePreflightCache } from '../services/preflight-check.js';
11
12
  import { CURATED_CHEAP_MODELS, CURATED_STANDARD_MODELS, CURATED_PREMIUM_MODELS } from '../cli/config.js';
12
13
  import { validateOpenCodeModelTiers } from '../utils/opencode-model-validation.js';
13
14
  import { provisionAgents, remoteAgentsDir } from '../services/agent-provisioner.js';
15
+ import { recheckProjectAgentShadows, invalidateProjectAgentShadowCache } from '../services/agent-shadow.js';
14
16
  import { getStrategy } from '../services/strategy.js';
15
17
  import { seedWorkspaceTrust } from '../utils/workspace-trust.js';
18
+ import { ensureAgyProject } from '../services/agy-project.js';
19
+ import { beadsStatusNote, refreshMemberFleetMcp, getMemberFleetMcpDeps, fleetInstallWarning } from '../services/member-fleet-install.js';
20
+ import { composePermissions, removeComposedMemberConfig, missingClaudeAllowRules } from './compose-permissions.js';
21
+ import { memberMcpAllowRules } from '../services/member-config-io.js';
16
22
  import { isFullyQualifiedPath, workFolderNotAbsoluteError } from '../utils/work-folder-validation.js';
17
23
  export const updateMemberSchema = z.object({
18
24
  ...memberIdentifier,
@@ -28,14 +34,14 @@ export const updateMemberSchema = z.object({
28
34
  port: z.number().optional().describe('New SSH port (remote members only)'),
29
35
  username: z.string().optional().describe('New SSH username (remote members only)'),
30
36
  auth_type: z.enum(['password', 'key']).optional().describe('New auth method (remote members only)'),
31
- password: z.string().optional().describe('New SSH password. Omit for secure out-of-band entry — a password prompt will open in a separate terminal window. Supports {{secure.NAME}} token — value is resolved from the credential store before use.'),
32
- rotate_password: z.boolean().optional().describe('Trigger secure out-of-band password re-entry for a member already using password auth. '
37
+ password: z.string().optional().describe('New SSH password. Omit for out-of-band entry — a password prompt will open in a separate terminal window. Supports {{secret.NAME}} token — value is resolved from the credential store before use.'),
38
+ rotate_password: z.boolean().optional().describe('Trigger out-of-band password re-entry for a member already using password auth. '
33
39
  + 'A password prompt will open in a separate terminal window. Ignored if auth_type is not password.'),
34
40
  key_path: z.string().optional().describe('Path to SSH private key. Used for both regular SSH connections and cloud instance lifecycle.'),
35
41
  work_folder: z.string()
36
42
  .regex(/^[^<>\n\r]+$/, 'work_folder must not contain angle brackets or newlines')
37
43
  .optional()
38
- .describe('New working directory on target machine. For non-local (remote/relay) members, must be a fully-qualified/absolute path (e.g. "/home/bella/repo" or "C:\\Users\\bella\\repo") -- "~" and relative paths are rejected, since they are never resolved for a non-local member.'),
44
+ .describe('New working directory on target machine. For non-local (remote/relay) members, must be a fully-qualified/absolute path (e.g. "/home/bella/repo" or "C:\\Users\\bella\\repo") -- "~" and relative paths are rejected, since they are never resolved for a non-local member. A folder may hold at most one LLM member and one LLM-less (llm_provider none) member.'),
39
45
  git_access: z.enum(['read', 'push', 'admin', 'issues', 'full']).optional().describe('Git access level for this member'),
40
46
  git_repos: z.array(z.string()).optional().describe('Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])'),
41
47
  icon: z.string().optional().describe('Override the auto-assigned emoji icon. Use named aliases: blue-circle, green-square, red-circle, etc. (8 colors × 2 shapes: circle, square). Or pass raw emoji.'),
@@ -53,15 +59,17 @@ export const updateMemberSchema = z.object({
53
59
  standard: z.string().optional(),
54
60
  premium: z.string().optional(),
55
61
  }).optional().describe('Per-member model tier map with free-form model IDs (e.g. "ollama/qwen3-coder:30b"). A single model fills all tiers. At least one model required.'),
56
- unattended: z.preprocess((v) => v === false ? 'false' : v, z.enum(['false', 'auto', 'dangerous'])).optional().describe('Permission mode for unattended execution. Pass "false" to reset to interactive prompts; "auto" = auto-approve safe operations; "dangerous" = skip all permission checks.'),
62
+ unattended: z.preprocess((v) => v === false ? 'false' : v, z.enum(['false', 'auto', 'dangerous'])).optional().describe('Permission mode for unattended execution. Pass "false" to reset to interactive prompts; "auto" = auto-approve safe operations (Claude: --permission-mode auto; on a model without auto-mode support, such as Haiku, the dispatch runs acceptEdits instead); "dangerous" = skip all permission checks.'),
57
63
  category: z.string().max(64).optional().describe('Group label for this member (e.g. "doers", "reviewers"). Pass empty string to clear.'),
58
64
  tags: z.array(z.string().max(64, 'Each tag must be 64 characters or fewer'))
59
65
  .max(10, 'At most 10 tags are allowed')
60
66
  .optional()
61
67
  .describe('Free-form labels for this member (max 10 tags, each max 64 chars). Empty array clears all tags; non-empty array replaces existing tags.'),
62
68
  code_intel_provider: z.enum(['codebase-memory', 'gitnexus', 'none']).optional().describe('Change the code-intelligence provider for this member.'),
63
- unreservable: z.boolean().optional().describe('Mark this member as never exclusively reservable, so it can be shared by more than one sprint at once (e.g. a member filling fleet-sprint\'s shared "orchestrator" role). reserve/release/force_release become no-op successes and overlap guards skip it.'),
69
+ unreservable: z.boolean().optional().describe('Mark this member as never exclusively reservable, so it can be shared by more than one sprint at once (e.g. a member filling fleet-sprint\'s shared "backlog" role). reserve/release/force_release become no-op successes and overlap guards skip it.'),
64
70
  shell: z.enum(['gitbash', 'pwsh7', 'powershell5']).optional().describe('Override the probed Windows shell for this member (gitbash, pwsh7, or powershell5). Windows members only -- ignored for non-windows members.'),
71
+ vcs_provider: z.enum(['github', 'bitbucket', 'azure-devops', 'none']).optional().describe('Directly set (override) this member\'s VCS provider -- an explicit operator value, never auto-detected. Use this to correct a wrong auto-detect from register_member, or to set the provider for a member with no credentials to provision (so provision_vcs_auth is not required just to record it). Pass "none" to clear it, declaring the member deliberately has no VCS provider.'),
72
+ fleet_install: z.enum(['auto', 'skip', 'replace-full']).optional().describe('Upgrade or skip the member\'s own apra-fleet install. "auto": for a remote member, probe it and install/upgrade apra-fleet when it is missing or older than this orchestrator (build-aware), self-register, write its per-folder apra-fleet MCP entry and verify a MEMBER session, even when nothing else changed; an install/upgrade that ran (or an install that only now became available) also adds the member apra-fleet tool rules to a claude member\'s permission allow-list through compose_permissions grant mode, keeping its role and grants (a NOTICE says so; a failure is a WARNING); local members only get the MEMBER-session probe. An install without the member-install marker (a full install) is never touched by "auto". "replace-full": everything "auto" does, plus an explicit opt-in to REPLACE such a full install with a member install (back up data and fleet.key to a timestamped dir, uninstall with the installed binary, stop the linux fleet-supervisor unit, move data aside, run the current installer in member mode, self-register); refused with no destructive command when the marker probe fails. "skip": no install (a refresh triggered by another change runs with install off). Omit to keep the default: install only on a provider change. The result reports the recoverable fleetMcp status (re-probe with member_detail refresh:true). A requested install/upgrade that cannot happen (no release for this build, checksum or download failure, unsupported platform, full install present, ...) never fails the update: it adds a WARNING naming the consequence, the exact reason and OS-correct manual install steps (also in fleetMcp.manualInstall).'),
65
73
  });
66
74
  export async function updateMember(input) {
67
75
  const existingOrError = resolveMember(input.member_id, input.member_name);
@@ -95,16 +103,20 @@ export async function updateMember(input) {
95
103
  if (resultingUnreservable && resultingLlmProvider !== 'none') {
96
104
  return '❌ "unreservable" requires llm_provider: "none" -- it is reserved for plain command-executor members that never receive an agent dispatch. Member was NOT updated.';
97
105
  }
106
+ // A change of LLM kind can create a same-kind clash in an unchanged folder,
107
+ // since a folder may hold one LLM member and one LLM-less member.
108
+ const llmKindChanged = ((existing.llmProvider ?? 'claude') === 'none') !== (resultingLlmProvider === 'none');
98
109
  const needsUniquenessCheck = existing.agentType === 'remote'
99
- ? (hostChanged || portChanged || folderChanged)
100
- : folderChanged;
110
+ ? (hostChanged || portChanged || folderChanged || llmKindChanged)
111
+ : (folderChanged || llmKindChanged);
101
112
  if (needsUniquenessCheck) {
102
113
  const newHost = input.host ?? existing.host;
103
114
  const newPort = input.port ?? existing.port;
104
115
  const newFolder = input.work_folder ?? existing.workFolder;
105
- if (hasDuplicateFolder(existing.agentType, newFolder, newHost, newPort, existing.id)) {
116
+ if (hasDuplicateFolder(existing.agentType, newFolder, newHost, newPort, existing.id, resultingLlmProvider)) {
106
117
  const scope = existing.agentType === 'local' ? 'this machine' : `host ${newHost}:${newPort}`;
107
- return `❌ Another member already uses folder "${newFolder}" on ${scope}. Update rejected.`;
118
+ const kind = resultingLlmProvider === 'none' ? 'LLM-less' : 'LLM';
119
+ return `❌ Another ${kind} member already uses folder "${newFolder}" on ${scope} (a folder may hold one LLM member and one LLM-less member). Update rejected.`;
108
120
  }
109
121
  }
110
122
  // Resolve named alias (e.g. "blue-circle" → "🔵") before validation
@@ -113,16 +125,14 @@ export async function updateMember(input) {
113
125
  if (resolvedIcon !== undefined && !isValidIcon(resolvedIcon)) {
114
126
  return `❌ Invalid icon "${input.icon}". Use a named alias (e.g., blue-circle, red-square, green-square) or a valid emoji.`;
115
127
  }
116
- // Resolve {{secure.NAME}} tokens in password field
128
+ // Resolve {{secret.NAME}} / legacy {{secure.NAME}} tokens in password field
117
129
  let resolvedPassword = input.password;
130
+ let passwordLegacyNames = [];
118
131
  if (resolvedPassword) {
119
- const TOKEN_RE = /\{\{secure\.([a-zA-Z0-9_-]{1,64})\}\}/g;
120
- let match;
132
+ const tokens = findSecretTokens(resolvedPassword);
121
133
  let resolved = resolvedPassword;
122
- const tokenNames = new Set();
123
- while ((match = TOKEN_RE.exec(resolvedPassword)) !== null) {
124
- tokenNames.add(match[1]);
125
- }
134
+ const tokenNames = new Set(tokens.map((t) => t.name));
135
+ passwordLegacyNames = tokens.filter((t) => t.legacy).map((t) => t.name);
126
136
  for (const name of tokenNames) {
127
137
  const entry = credentialResolve(name, existing.friendlyName);
128
138
  if (!entry)
@@ -131,9 +141,13 @@ export async function updateMember(input) {
131
141
  return `❌ ${entry.denied} Member was NOT updated.`;
132
142
  if ('expired' in entry)
133
143
  return `❌ ${entry.expired} Member was NOT updated.`;
134
- resolved = resolved.replaceAll(`{{secure.${name}}}`, entry.plaintext);
144
+ resolved = resolved.replaceAll(`{{secret.${name}}}`, entry.plaintext);
145
+ resolved = resolved.replaceAll(`{{secure.${name}}}`, entry.plaintext); // legacy spelling
135
146
  }
136
147
  resolvedPassword = resolved;
148
+ if (passwordLegacyNames.length > 0) {
149
+ logWarn('update_member', legacyTokenWarning(passwordLegacyNames), { id: existing.id, friendlyName: existing.friendlyName });
150
+ }
137
151
  }
138
152
  // Out-of-band password collection:
139
153
  // - switchingToPassword: changing from key → password auth without inline password
@@ -149,6 +163,8 @@ export async function updateMember(input) {
149
163
  }
150
164
  const updates = {};
151
165
  const warnings = [];
166
+ if (passwordLegacyNames.length > 0)
167
+ warnings.push(legacyTokenWarning(passwordLegacyNames));
152
168
  // --- model_tiers normalization ---
153
169
  if (input.model_tiers !== undefined) {
154
170
  const values = Object.values(input.model_tiers).filter(Boolean);
@@ -195,6 +211,12 @@ export async function updateMember(input) {
195
211
  updates.unreservable = input.unreservable;
196
212
  if (input.shell !== undefined)
197
213
  updates.shell = input.shell;
214
+ // Explicit operator override -- never auto-detected (that only happens in
215
+ // register_member). 'none' clears vcsProvider, matching how register_member
216
+ // records it (Agent.vcsProvider has no 'none' member -- see src/types.ts).
217
+ if (input.vcs_provider !== undefined) {
218
+ updates.vcsProvider = input.vcs_provider === 'none' ? undefined : input.vcs_provider;
219
+ }
198
220
  if (input.model_cheap !== undefined)
199
221
  updates.modelCheap = input.model_cheap;
200
222
  if (input.model_standard !== undefined)
@@ -246,6 +268,19 @@ export async function updateMember(input) {
246
268
  warnings.push(`Warning: cloud fields (${passedCloudFields.join(', ')}) are ignored for non-cloud members.`);
247
269
  }
248
270
  }
271
+ // Switching a member TO agy: create (or re-verify) its own agy project
272
+ // before recording the switch, so an agy member always has a bindable
273
+ // --project id. Evaluated on the resulting member (new host/folder/shell).
274
+ if (input.llm_provider === 'agy' && (existing.llmProvider ?? 'claude') !== 'agy') {
275
+ const preview = { ...existing, ...updates };
276
+ try {
277
+ const ensured = await ensureAgyProject(preview, { persist: false });
278
+ updates.agyProjectId = ensured.projectId;
279
+ }
280
+ catch (e) {
281
+ return `ERROR: could not create the agy project for "${existing.friendlyName}": ${e?.message ?? String(e)}\nMember was NOT updated.`;
282
+ }
283
+ }
249
284
  const updated = updateInRegistry(existing.id, updates);
250
285
  if (!updated) {
251
286
  return `Failed to update member "${existing.id}".`;
@@ -288,6 +323,126 @@ export async function updateMember(input) {
288
323
  // Local members have no connectivity concept -- always attempt (best-effort/non-fatal).
289
324
  await seedWorkspaceTrust(updated, undefined, 'update_member');
290
325
  }
326
+ // Provider switch OR work-folder move: remove exactly what
327
+ // compose_permissions wrote for the member as it was BEFORE this update (old
328
+ // provider, old folder/host -- its permission files, its per-folder
329
+ // apra-fleet MCP entry and the exclude lines), then re-compose for the
330
+ // member as it is now, so the new folder gets its ?member= entry at once
331
+ // (until then a session there would see the FULL user-scope entry) and the
332
+ // old folder is left with no stale member entry. Skipped entirely when
333
+ // neither the provider nor the work folder changed.
334
+ const oldProvider = existing.llmProvider ?? 'claude';
335
+ const newProvider = updated.llmProvider ?? 'claude';
336
+ const providerChanged = oldProvider !== newProvider;
337
+ const workFolderMoved = updated.workFolder !== existing.workFolder;
338
+ if (providerChanged || workFolderMoved) {
339
+ const why = providerChanged
340
+ ? `Provider switch ${oldProvider} -> ${newProvider}`
341
+ : `Work folder move ${existing.workFolder} -> ${updated.workFolder}`;
342
+ const oldWhat = providerChanged ? `the old ${oldProvider} config` : `the config in the old work folder`;
343
+ try {
344
+ const removed = await removeComposedMemberConfig(existing);
345
+ logLine('update_member', `${why}: removed old config (${removed.join('; ') || 'nothing to remove'})`, updated);
346
+ }
347
+ catch (e) {
348
+ warnings.push(`${why}: could not remove ${oldWhat}: ${e?.message ?? String(e)}`);
349
+ }
350
+ let composeResult;
351
+ try {
352
+ composeResult = await composePermissions({ member_id: updated.id, role: 'doer', tags: updated.tags });
353
+ }
354
+ catch (e) {
355
+ composeResult = `compose_permissions threw: ${e?.message ?? String(e)}`;
356
+ }
357
+ if (!composeResult.startsWith('\u2705')) {
358
+ const asciiDetail = composeResult.replace(/^[^\x00-\x7F]+\s*/, '');
359
+ warnings.push(providerChanged
360
+ ? `ERROR: provider switched to ${newProvider} but compose_permissions failed -- the member has no ${newProvider} permission/MCP config: ${asciiDetail}`
361
+ : `ERROR: work folder moved to ${updated.workFolder} but compose_permissions failed -- the new folder has no member permission/MCP config: ${asciiDetail}`);
362
+ }
363
+ }
364
+ // fleetMcp: a provider change re-runs the member install with --llm <new
365
+ // provider>; a name or work-folder change re-runs `register-member --id` on
366
+ // the member's own install. Best-effort: the update itself already succeeded
367
+ // and the outcome is a recorded, recoverable status (apra-fleet-b4g.56).
368
+ const nameChanged = updated.friendlyName !== existing.friendlyName;
369
+ let fleetMcpLine;
370
+ // "replace-full" is "auto" plus the opt-in full-install replacement.
371
+ const fleetInstallAuto = input.fleet_install === 'auto' || input.fleet_install === 'replace-full';
372
+ if (providerChanged || nameChanged || workFolderMoved || fleetInstallAuto) {
373
+ try {
374
+ // 'skip' disables the install; 'auto' installs a remote member (upgrading
375
+ // only when missing/older); omitted keeps the provider-change-only default.
376
+ const install = input.fleet_install === 'skip'
377
+ ? false
378
+ : (providerChanged || fleetInstallAuto) && updated.agentType !== 'local';
379
+ const status = await refreshMemberFleetMcp(updated, getMemberFleetMcpDeps(), {
380
+ install,
381
+ forceInstall: providerChanged && input.fleet_install !== 'skip',
382
+ // An install also (re)writes the per-folder MCP entry before it is
383
+ // checked, so one fleet_install:"auto" call ends at fleetMcp=available.
384
+ writeMcpEntry: install,
385
+ replaceFull: install && input.fleet_install === 'replace-full',
386
+ });
387
+ fleetMcpLine = status.state === 'available'
388
+ ? `available${status.version ? ` (apra-fleet ${status.version})` : ''}${(status.installFailure || status.replacedFullInstall) && status.detail ? ` -- ${status.installFailure ? 'warning: ' : ''}${status.detail}` : ''}`
389
+ : `unavailable (${status.reason ?? 'unknown'})${status.detail ? ` -- ${status.detail}` : ''}`;
390
+ fleetMcpLine += beadsStatusNote(status);
391
+ // A requested install that did not happen never fails the update: it is
392
+ // a prominent WARNING with the consequence, reason and manual steps.
393
+ const installWarning = fleetInstallWarning(updated.friendlyName, status);
394
+ if (installWarning) {
395
+ fleetMcpLine += installWarning.startsWith('NOTICE') ? ' (see NOTICE below)' : ' (see WARNING below)';
396
+ warnings.unshift(installWarning);
397
+ }
398
+ // A fresh install/upgrade/replace -- or an install that only now became
399
+ // usable (e.g. a failed autostart fixed by `apra-fleet start`) -- can
400
+ // serve member tools a claude member's allow list does not grant yet
401
+ // (opencode keeps no client-side tool list; agy/codex/copilot get no
402
+ // member install here). Grant mode ADDS the member tool rules to the
403
+ // existing allow list, so the member's role and reactive grants are kept.
404
+ // Skipped when the provider or folder block above already composed.
405
+ // Also runs whenever the install is available, not only on a recorded
406
+ // transition: a member_detail refresh between `apra-fleet start` and
407
+ // this update already recorded available. The grant is skipped (no
408
+ // NOTICE, no file rewrite) when the allow list already has every rule.
409
+ const mayNeedMemberRules = status.fleetInstalledAt !== existing.fleetMcp?.fleetInstalledAt
410
+ || !!status.replacedFullInstall
411
+ || status.state === 'available';
412
+ if (install && mayNeedMemberRules && !providerChanged && !workFolderMoved && (updated.llmProvider ?? 'claude') === 'claude'
413
+ && (await missingClaudeAllowRules(updated, memberMcpAllowRules())).length > 0) {
414
+ let recompose;
415
+ try {
416
+ recompose = await composePermissions({ member_id: updated.id, role: 'doer', tags: updated.tags, grant: memberMcpAllowRules() });
417
+ }
418
+ catch (e) {
419
+ recompose = `compose_permissions threw: ${e?.message ?? String(e)}`;
420
+ }
421
+ if (!recompose.startsWith('\u2705')) {
422
+ const asciiDetail = recompose.replace(/^[^\x00-\x7F]+\s*/, '');
423
+ warnings.push(`WARNING: apra-fleet was installed/upgraded on the member but compose_permissions failed -- its permission allow-list was not refreshed, so its LLM may refuse fleet tools the new install serves. Retry with compose_permissions {member_id, role}: ${asciiDetail}`);
424
+ }
425
+ else {
426
+ warnings.push('NOTICE: the member apra-fleet tool rules were added to its permission allow-list (existing rules and grants kept).');
427
+ }
428
+ }
429
+ }
430
+ catch (e) {
431
+ fleetMcpLine = `unavailable (probe-failed) -- ${e?.message ?? String(e)}`;
432
+ }
433
+ }
434
+ // Re-check project-level agent files that would shadow the managed role set
435
+ // (the work folder or provider may have changed). The dispatch-time cache is
436
+ // always invalidated; the check itself runs only when the member is reachable
437
+ // (local members always). Never throws.
438
+ invalidateProjectAgentShadowCache(updated.id);
439
+ const shadowReachable = updated.agentType !== 'remote' || agentProvisionResult !== undefined
440
+ || remoteAgentsDir(updated.llmProvider ?? 'claude') === null;
441
+ if (shadowReachable) {
442
+ const shadowWarning = await recheckProjectAgentShadows(updated);
443
+ if (shadowWarning)
444
+ warnings.push(shadowWarning);
445
+ }
291
446
  let result = `✅ Member "${updated.friendlyName}" updated.\n\n`;
292
447
  result += ` Icon: ${updated.icon ?? DEFAULT_ICON}\n`;
293
448
  result += ` ID: ${updated.id}\n`;
@@ -301,6 +456,12 @@ export async function updateMember(input) {
301
456
  result += ` Auth: ${updated.authType}\n`;
302
457
  }
303
458
  result += ` Provider: ${updated.llmProvider ?? 'claude'}\n`;
459
+ if (updated.llmProvider === 'agy' && updated.agyProjectId) {
460
+ result += ` AGY project: ${updated.agyProjectId}\n`;
461
+ }
462
+ if (input.vcs_provider !== undefined) {
463
+ result += ` VCS Provider: ${updated.vcsProvider ?? 'none'}\n`;
464
+ }
304
465
  if (updated.modelCheap)
305
466
  result += ` Model Cheap: ${updated.modelCheap}\n`;
306
467
  if (updated.modelStandard)
@@ -322,6 +483,8 @@ export async function updateMember(input) {
322
483
  const mt = updated.modelTiers;
323
484
  result += ` Model Tiers: cheap=${mt.cheap ?? '-'} standard=${mt.standard ?? '-'} premium=${mt.premium ?? '-'}\n`;
324
485
  }
486
+ if (fleetMcpLine)
487
+ result += ` fleetMcp: ${fleetMcpLine}\n`;
325
488
  if (warnings.length > 0) {
326
489
  result += '\n';
327
490
  for (const w of warnings) {
@@ -0,0 +1,127 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Server-side VCS credential handoff (apra-fleet-3swo.7.3).
4
+ *
5
+ * BEFORE: the only way an orchestrator-side caller could run a
6
+ * credential-requiring git/VCS command was to first LEARN the token --
7
+ * fleet-sprint's readMemberVcsCredentialToken dispatches the deployed
8
+ * git-credential-helper as a member command and parses `password=<token>` out
9
+ * of the captured stdout. Even dispatched with silent:true, the plaintext
10
+ * still round-trips through a command result the orchestrator reads.
11
+ *
12
+ * NOW: the caller sends the command it already builds (VCSModule's
13
+ * buildCreatePrCommand and friends) with a literal placeholder where the
14
+ * token belongs -- `{{vcs_token}}` for a bare reference or
15
+ * `{{vcs_token_inline}}` for one sitting inside the caller's own single
16
+ * quotes (apra-fleet-3swo.7.16; see VCS_TOKEN_INLINE_PLACEHOLDER below) --
17
+ * and the SERVER performs the whole handoff inside this one call:
18
+ *
19
+ * 1. runs the member's deployed credential helper through
20
+ * strategy.execCommand -- that output is consumed in-process and is
21
+ * NEVER part of this tool's result;
22
+ * 2. substitutes whichever placeholder(s) are present with the token,
23
+ * escaped for the member's OWN shell (the same isPosixShell branch
24
+ * execute_command uses for {{secret.NAME}}) -- `{{vcs_token}}` gets the
25
+ * fully-quoted form, `{{vcs_token_inline}}` gets the bare interior
26
+ * escaping with no quotes of its own;
27
+ * 3. dispatches the substituted command;
28
+ * 4. redacts any occurrence of the token from stdout/stderr before
29
+ * returning, the same defence execute-command.ts's redactOutput applies.
30
+ *
31
+ * The plaintext token therefore appears in no field of any result an
32
+ * orchestrator-side caller can read. readMemberVcsCredentialToken is
33
+ * deliberately left in place; retiring it is a separate task.
34
+ */
35
+ /**
36
+ * Reference this one BARE (never inside your own quotes): the substituted
37
+ * value arrives ALREADY shell-escaped for the member's shell (quotes
38
+ * included), exactly like execute_command's {{secret.NAME}} tokens --
39
+ * wrapping it in the caller's own quotes double-escapes it and surfaces as a
40
+ * false 401 / invalid-token error.
41
+ */
42
+ export declare const VCS_TOKEN_PLACEHOLDER = "{{vcs_token}}";
43
+ /**
44
+ * Reference this one INSIDE your own single quotes (e.g.
45
+ * `'Authorization: Bearer {{vcs_token_inline}}'`): the substituted value is
46
+ * escaped for the INTERIOR of a single-quoted string in the member's shell
47
+ * dialect and carries no quotes of its own, for callers (like VCSModule's
48
+ * provider command builders) that must interpolate the token into a larger
49
+ * already-quoted value rather than reference it as a free-standing word.
50
+ * Using `{{vcs_token}}` in that position double-escapes it the same way
51
+ * wrapping it in extra quotes would; use this placeholder there instead.
52
+ *
53
+ * Whether a given occurrence really sits inside the caller's open quotes is
54
+ * not reliably decidable from the command string alone, so this tool does
55
+ * not attempt to validate placement -- a heuristic here would produce false
56
+ * refusals. The contract is documented, not enforced (apra-fleet-3swo.7.16).
57
+ */
58
+ export declare const VCS_TOKEN_INLINE_PLACEHOLDER = "{{vcs_token_inline}}";
59
+ export declare const vcsCredentialExecSchema: z.ZodObject<{
60
+ command: z.ZodString;
61
+ label: z.ZodOptional<z.ZodString>;
62
+ timeout_s: z.ZodOptional<z.ZodNumber>;
63
+ member_id: z.ZodOptional<z.ZodString>;
64
+ member_name: z.ZodOptional<z.ZodString>;
65
+ }, "strip", z.ZodTypeAny, {
66
+ command: string;
67
+ member_id?: string | undefined;
68
+ member_name?: string | undefined;
69
+ label?: string | undefined;
70
+ timeout_s?: number | undefined;
71
+ }, {
72
+ command: string;
73
+ member_id?: string | undefined;
74
+ member_name?: string | undefined;
75
+ label?: string | undefined;
76
+ timeout_s?: number | undefined;
77
+ }>;
78
+ export type VcsCredentialExecInput = z.infer<typeof vcsCredentialExecSchema>;
79
+ export type VcsCredentialExecReason =
80
+ /** The command ran (inspect exitCode for its own success). */
81
+ 'ok'
82
+ /** No member matched member_id/member_name. */
83
+ | 'member_not_found'
84
+ /** `command` contained neither {{vcs_token}} nor {{vcs_token_inline}}. */
85
+ | 'placeholder_missing'
86
+ /** This member's OS/shell has no credential-read implementation. */
87
+ | 'unsupported_member_os'
88
+ /** Running the credential helper on the member failed. */
89
+ | 'credential_read_failed'
90
+ /** The helper ran but printed no usable password= line. */
91
+ | 'credential_empty'
92
+ /** Dispatching the credential-requiring command threw. */
93
+ | 'dispatch_failed';
94
+ interface VcsCredentialExecFields {
95
+ /** True when the credential-requiring command was dispatched. Read exitCode for its outcome. */
96
+ ok: boolean;
97
+ /** Machine-readable outcome code. Branch on this, never on `text`. */
98
+ reason: VcsCredentialExecReason;
99
+ /** Exit code of the dispatched command, or null when it never ran. */
100
+ exitCode: number | null;
101
+ /** Command stdout with every occurrence of the credential redacted. */
102
+ stdout: string;
103
+ /** Command stderr with every occurrence of the credential redacted. */
104
+ stderr: string;
105
+ /**
106
+ * How many times the credential had to be redacted out of stdout+stderr.
107
+ * Normally 0; a nonzero count means the dispatched command echoed its own
108
+ * credential back and the redaction earned its keep.
109
+ */
110
+ tokenRedactions: number;
111
+ /** Credential label used, or null for the unlabelled helper. */
112
+ credentialLabel: string | null;
113
+ /** Registry id of the resolved member, or null. */
114
+ memberId: string | null;
115
+ /** Friendly name of the resolved member, or null. */
116
+ memberName: string | null;
117
+ }
118
+ export interface VcsCredentialExecStructured extends VcsCredentialExecFields {
119
+ [key: string]: unknown;
120
+ }
121
+ export interface VcsCredentialExecResult {
122
+ text: string;
123
+ structuredContent: VcsCredentialExecStructured;
124
+ }
125
+ export declare function vcsCredentialExec(input: VcsCredentialExecInput): Promise<VcsCredentialExecResult>;
126
+ export {};
127
+ //# sourceMappingURL=vcs-credential-exec.d.ts.map
@@ -0,0 +1,203 @@
1
+ import { z } from 'zod';
2
+ import { getStrategy } from '../services/strategy.js';
3
+ import { getOsCommands } from '../os/index.js';
4
+ import { getAgentOS, getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
5
+ import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
6
+ import { escapeShellArg, escapePowerShellArg, escapeShellArgInner, escapePowerShellArgInner } from '../utils/shell-escape.js';
7
+ import { logLine } from '../utils/log-helpers.js';
8
+ /**
9
+ * Server-side VCS credential handoff (apra-fleet-3swo.7.3).
10
+ *
11
+ * BEFORE: the only way an orchestrator-side caller could run a
12
+ * credential-requiring git/VCS command was to first LEARN the token --
13
+ * fleet-sprint's readMemberVcsCredentialToken dispatches the deployed
14
+ * git-credential-helper as a member command and parses `password=<token>` out
15
+ * of the captured stdout. Even dispatched with silent:true, the plaintext
16
+ * still round-trips through a command result the orchestrator reads.
17
+ *
18
+ * NOW: the caller sends the command it already builds (VCSModule's
19
+ * buildCreatePrCommand and friends) with a literal placeholder where the
20
+ * token belongs -- `{{vcs_token}}` for a bare reference or
21
+ * `{{vcs_token_inline}}` for one sitting inside the caller's own single
22
+ * quotes (apra-fleet-3swo.7.16; see VCS_TOKEN_INLINE_PLACEHOLDER below) --
23
+ * and the SERVER performs the whole handoff inside this one call:
24
+ *
25
+ * 1. runs the member's deployed credential helper through
26
+ * strategy.execCommand -- that output is consumed in-process and is
27
+ * NEVER part of this tool's result;
28
+ * 2. substitutes whichever placeholder(s) are present with the token,
29
+ * escaped for the member's OWN shell (the same isPosixShell branch
30
+ * execute_command uses for {{secret.NAME}}) -- `{{vcs_token}}` gets the
31
+ * fully-quoted form, `{{vcs_token_inline}}` gets the bare interior
32
+ * escaping with no quotes of its own;
33
+ * 3. dispatches the substituted command;
34
+ * 4. redacts any occurrence of the token from stdout/stderr before
35
+ * returning, the same defence execute-command.ts's redactOutput applies.
36
+ *
37
+ * The plaintext token therefore appears in no field of any result an
38
+ * orchestrator-side caller can read. readMemberVcsCredentialToken is
39
+ * deliberately left in place; retiring it is a separate task.
40
+ */
41
+ /**
42
+ * Reference this one BARE (never inside your own quotes): the substituted
43
+ * value arrives ALREADY shell-escaped for the member's shell (quotes
44
+ * included), exactly like execute_command's {{secret.NAME}} tokens --
45
+ * wrapping it in the caller's own quotes double-escapes it and surfaces as a
46
+ * false 401 / invalid-token error.
47
+ */
48
+ export const VCS_TOKEN_PLACEHOLDER = '{{vcs_token}}';
49
+ /**
50
+ * Reference this one INSIDE your own single quotes (e.g.
51
+ * `'Authorization: Bearer {{vcs_token_inline}}'`): the substituted value is
52
+ * escaped for the INTERIOR of a single-quoted string in the member's shell
53
+ * dialect and carries no quotes of its own, for callers (like VCSModule's
54
+ * provider command builders) that must interpolate the token into a larger
55
+ * already-quoted value rather than reference it as a free-standing word.
56
+ * Using `{{vcs_token}}` in that position double-escapes it the same way
57
+ * wrapping it in extra quotes would; use this placeholder there instead.
58
+ *
59
+ * Whether a given occurrence really sits inside the caller's open quotes is
60
+ * not reliably decidable from the command string alone, so this tool does
61
+ * not attempt to validate placement -- a heuristic here would produce false
62
+ * refusals. The contract is documented, not enforced (apra-fleet-3swo.7.16).
63
+ */
64
+ export const VCS_TOKEN_INLINE_PLACEHOLDER = '{{vcs_token_inline}}';
65
+ export const vcsCredentialExecSchema = z.object({
66
+ ...memberIdentifier,
67
+ command: z.string().min(1).describe('The credential-requiring command to run on the member. MUST contain at least one of two '
68
+ + 'placeholders where the credential belongs: {{vcs_token}}, referenced BARE (never inside your '
69
+ + 'own quotes) -- the server substitutes it with the value already escaped AND quoted for the '
70
+ + 'member\'s shell; or {{vcs_token_inline}}, referenced INSIDE your own single quotes -- the '
71
+ + 'server substitutes it with the value escaped for the interior of a single-quoted string, with '
72
+ + 'no quotes of its own (use this one when the token must be interpolated into a larger quoted '
73
+ + 'value, e.g. an Authorization header). Both may appear in the same command. '
74
+ + 'The plaintext credential never leaves the server and never appears in this tool\'s result.'),
75
+ label: z.string().regex(/^[a-zA-Z0-9._-]{1,64}$/).optional().describe('Credential label the helper was deployed under by provision_vcs_auth (defaults to the '
76
+ + 'provider name there, e.g. "github" or "azure-devops"). Omit to use the unlabelled helper.'),
77
+ timeout_s: z.number().int().positive().max(600).optional().describe('Inactivity timeout in seconds for the credential-requiring command (default: 120). '
78
+ + 'On expiry the command\'s remote process tree is killed and the result is reason dispatch_failed '
79
+ + 'with a "Command timed out" message.'),
80
+ });
81
+ const REDACTION = '[REDACTED:vcs_token]';
82
+ function execResult(text, fields) {
83
+ return {
84
+ text,
85
+ structuredContent: {
86
+ ok: fields.ok ?? fields.reason === 'ok',
87
+ reason: fields.reason,
88
+ exitCode: fields.exitCode ?? null,
89
+ stdout: fields.stdout ?? '',
90
+ stderr: fields.stderr ?? '',
91
+ tokenRedactions: fields.tokenRedactions ?? 0,
92
+ credentialLabel: fields.credentialLabel ?? null,
93
+ memberId: fields.memberId ?? null,
94
+ memberName: fields.memberName ?? null,
95
+ },
96
+ };
97
+ }
98
+ /** Replace every occurrence of `secret` in `output`, and report how many. */
99
+ function redactToken(output, secret) {
100
+ if (!secret)
101
+ return { text: output, count: 0 };
102
+ const parts = output.split(secret);
103
+ return { text: parts.join(REDACTION), count: parts.length - 1 };
104
+ }
105
+ export async function vcsCredentialExec(input) {
106
+ const agentOrError = resolveMember(input.member_id, input.member_name);
107
+ if (typeof agentOrError === 'string') {
108
+ return execResult(agentOrError, {
109
+ reason: 'member_not_found',
110
+ memberId: input.member_id ?? null,
111
+ memberName: input.member_name ?? null,
112
+ });
113
+ }
114
+ const agent = agentOrError;
115
+ const who = { memberId: agent.id, memberName: agent.friendlyName, credentialLabel: input.label ?? null };
116
+ // Refusing a command with neither placeholder is what keeps this tool a
117
+ // credential handoff rather than a second, unguarded execute_command.
118
+ const hasBare = input.command.includes(VCS_TOKEN_PLACEHOLDER);
119
+ const hasInline = input.command.includes(VCS_TOKEN_INLINE_PLACEHOLDER);
120
+ if (!hasBare && !hasInline) {
121
+ return execResult(`[FAIL] command must contain ${VCS_TOKEN_PLACEHOLDER} or ${VCS_TOKEN_INLINE_PLACEHOLDER} -- use execute_command for a command that needs no credential.`, { ...who, reason: 'placeholder_missing' });
122
+ }
123
+ const agentOs = getAgentOS(agent);
124
+ const agentShell = getAgentShell(agent);
125
+ const cmds = getOsCommands(agentOs, agentShell);
126
+ const strategy = getStrategy(agent);
127
+ // A member OS/shell with no credential-read implementation is a HARD
128
+ // failure with a surfaced error, never an advisory warning that lets the
129
+ // caller proceed credential-less.
130
+ let read;
131
+ try {
132
+ read = cmds.gitCredentialHelperRead(input.label);
133
+ }
134
+ catch (err) {
135
+ return execResult(`[FAIL] Cannot read a VCS credential on "${agent.friendlyName}" (os=${agentOs} shell=${agentShell ?? 'default'}): ${err.message}`, { ...who, reason: 'unsupported_member_os' });
136
+ }
137
+ // STEP 1 -- read the credential SERVER-SIDE. This result is consumed
138
+ // in-process and is never placed in the payload returned below.
139
+ let token = '';
140
+ try {
141
+ const readRes = await strategy.execCommand(read.command, 15000);
142
+ if (readRes.code !== 0) {
143
+ return execResult(`[FAIL] Failed to read the VCS credential for "${agent.friendlyName}" from '${read.path}' (exit ${readRes.code}).`, { ...who, reason: 'credential_read_failed', exitCode: readRes.code });
144
+ }
145
+ const m = /^password=(.*)$/m.exec(readRes.stdout || '');
146
+ token = m ? m[1].trim() : '';
147
+ }
148
+ catch (err) {
149
+ return execResult(`[FAIL] Failed to read the VCS credential for "${agent.friendlyName}" from '${read.path}': ${err.message}`, { ...who, reason: 'credential_read_failed' });
150
+ }
151
+ if (!token) {
152
+ return execResult(`[FAIL] The VCS credential for "${agent.friendlyName}" was empty or unreadable (expected a 'password=' line from '${read.path}'). Re-run provision_vcs_auth.`, { ...who, reason: 'credential_empty' });
153
+ }
154
+ // STEP 2 -- substitute, escaped for the member's OWN shell. A Windows
155
+ // member registered with shell=gitbash runs bash, so it needs POSIX
156
+ // escaping even though its OS is windows; isPosixShell owns that decision
157
+ // for every consumer. The bare placeholder gets the fully-quoted form; the
158
+ // inline placeholder gets the SAME dialect's interior-only escaping, with
159
+ // no wrapping quotes of its own, so it composes inside the caller's
160
+ // already-open single quotes instead of double-escaping.
161
+ const posix = isPosixShell(agentOs, agentShell);
162
+ const escaped = posix ? escapeShellArg(token) : escapePowerShellArg(token);
163
+ const escapedInline = posix ? escapeShellArgInner(token) : escapePowerShellArgInner(token);
164
+ const finalCommand = input.command
165
+ .replaceAll(VCS_TOKEN_PLACEHOLDER, escaped)
166
+ .replaceAll(VCS_TOKEN_INLINE_PLACEHOLDER, escapedInline);
167
+ // STEP 3 -- dispatch. Only the log-safe form (placeholder still in place) is
168
+ // ever logged; `finalCommand` is never written anywhere.
169
+ logLine('vcs_credential_exec', `label=${input.label ?? '(default)'} command=${input.command.slice(0, 120)}`, agent);
170
+ let code;
171
+ let stdout;
172
+ let stderr;
173
+ try {
174
+ // Run under the FLEET_PID wrapper, as execute_command does: on timeout,
175
+ // execCommand kills the remote process tree explicitly and the caller
176
+ // gets "Command timed out ..." (reason dispatch_failed) -- a git push or
177
+ // clone is never left running, or cut mid-operation, unreported.
178
+ const res = await strategy.execCommand(cmds.wrapPidCapture(finalCommand), (input.timeout_s ?? 120) * 1000);
179
+ code = res.code;
180
+ stdout = res.stdout ?? '';
181
+ stderr = res.stderr ?? '';
182
+ }
183
+ catch (err) {
184
+ // The thrown message can quote the command that failed, so it is redacted
185
+ // on the same footing as stdout/stderr.
186
+ const redactedErr = redactToken(String(err?.message ?? err), token);
187
+ return execResult(`[FAIL] Command dispatch failed on "${agent.friendlyName}": ${redactedErr.text}`, { ...who, reason: 'dispatch_failed', stderr: redactedErr.text, tokenRedactions: redactedErr.count });
188
+ }
189
+ // STEP 4 -- defence in depth: the command itself may echo the credential
190
+ // back (a curl -v, a git error quoting the remote URL), so scrub both
191
+ // streams before anything is returned.
192
+ const outRedacted = redactToken(stdout, token);
193
+ const errRedacted = redactToken(stderr, token);
194
+ return execResult(`[OK] Ran credential-requiring command on "${agent.friendlyName}" (exit ${code}).`, {
195
+ ...who,
196
+ reason: 'ok',
197
+ exitCode: code,
198
+ stdout: outRedacted.text,
199
+ stderr: errRedacted.text,
200
+ tokenRedactions: outRedacted.count + errRedacted.count,
201
+ });
202
+ }
203
+ //# sourceMappingURL=vcs-credential-exec.js.map