@apralabs/apra-fleet 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -0,0 +1,27 @@
1
+ import { z } from 'zod';
2
+ import { getMemberCallStats } from '../services/member-call-counts.js';
3
+ import { getSessionMemberId } from '../services/tool-scope.js';
4
+ export const sessionStatsSchema = z.object({
5
+ member_id: z.string().optional().describe('Member uuid to read. Omit on a member session (the calling member is used). Required on a non-member session.'),
6
+ });
7
+ /**
8
+ * session_stats -- the calling member's aggregated kb_* / code_* call counts on
9
+ * this server (see src/services/member-call-counts.ts). Returns JSON:
10
+ * { member_id, since, kb, code, total, tools }. A member session may only read
11
+ * its own counts; a violation throws (an isError tool result).
12
+ */
13
+ export async function sessionStats(input) {
14
+ const sessionMember = getSessionMemberId();
15
+ const requested = input.member_id;
16
+ if (sessionMember) {
17
+ if (requested && requested !== sessionMember) {
18
+ throw new Error('E-FORBIDDEN: a member session may only read its own session_stats');
19
+ }
20
+ return JSON.stringify(getMemberCallStats(sessionMember));
21
+ }
22
+ if (!requested) {
23
+ throw new Error('E-USAGE: member_id is required on a non-member session');
24
+ }
25
+ return JSON.stringify(getMemberCallStats(requested));
26
+ }
27
+ //# sourceMappingURL=session-stats.js.map
@@ -2,6 +2,7 @@ import { z } from 'zod';
2
2
  import fs from 'node:fs';
3
3
  import { closeAllConnections } from '../services/ssh.js';
4
4
  import { SERVER_INFO_PATH } from '../paths.js';
5
+ import { recordShutdown } from '../services/server-lifecycle.js';
5
6
  export const shutdownServerSchema = z.object({});
6
7
  let httpHandle = null;
7
8
  // Tracked so a test (or any other caller that needs to tear down cleanly
@@ -44,6 +45,10 @@ export async function shutdownServer() {
44
45
  catch { }
45
46
  }
46
47
  closeAllConnections();
48
+ // GitHub #585: one synchronous shutdown record before the deferred exit --
49
+ // written only once close() succeeded, so a failed close (the process stays
50
+ // up) never leaves a false first reason behind.
51
+ recordShutdown('shutdown_server');
47
52
  scheduleProcessExit();
48
53
  return 'Server shutting down. Run /mcp to start a fresh instance.';
49
54
  }
@@ -1,4 +1,23 @@
1
1
  import { z } from 'zod';
2
+ /**
3
+ * Budgets for the CLI install/update command. Both run under the FLEET_PID
4
+ * wrapper (cmds.wrapPidCapture), so when a budget binds, execCommand kills
5
+ * the remote process tree explicitly (ssh.ts killRemoteTree / the local
6
+ * tree-kill) and the result says it was a timeout kill and how long the
7
+ * step ran -- never a silent cut mid-install. The inactivity budget catches
8
+ * a hung installer; the ceiling bounds one that keeps printing but never
9
+ * finishes.
10
+ *
11
+ * Both inactivity windows are 600s: since the PID wrapper a timed-out
12
+ * install is really killed (the previous release let it run on and usually
13
+ * finish in the background), and real installers -- the agy and Claude
14
+ * installers on a slow link -- can stay silent for minutes while
15
+ * downloading. A long quiet window is cheaper than a killed, half-written
16
+ * install; the 15-minute ceiling still bounds a runaway.
17
+ */
18
+ export declare const INSTALL_INACTIVITY_TIMEOUT_MS = 600000;
19
+ export declare const UPDATE_INACTIVITY_TIMEOUT_MS = 600000;
20
+ export declare const INSTALL_MAX_TOTAL_MS: number;
2
21
  export declare const updateAgentCliSchema: z.ZodObject<{
3
22
  install_if_missing: z.ZodDefault<z.ZodBoolean>;
4
23
  member_id: z.ZodOptional<z.ZodString>;
@@ -5,10 +5,59 @@ import { getOsCommands } from '../os/index.js';
5
5
  import { getProvider } from '../providers/index.js';
6
6
  import { getAgentOS, getAgentShell } from '../utils/agent-helpers.js';
7
7
  import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
8
+ /**
9
+ * Budgets for the CLI install/update command. Both run under the FLEET_PID
10
+ * wrapper (cmds.wrapPidCapture), so when a budget binds, execCommand kills
11
+ * the remote process tree explicitly (ssh.ts killRemoteTree / the local
12
+ * tree-kill) and the result says it was a timeout kill and how long the
13
+ * step ran -- never a silent cut mid-install. The inactivity budget catches
14
+ * a hung installer; the ceiling bounds one that keeps printing but never
15
+ * finishes.
16
+ *
17
+ * Both inactivity windows are 600s: since the PID wrapper a timed-out
18
+ * install is really killed (the previous release let it run on and usually
19
+ * finish in the background), and real installers -- the agy and Claude
20
+ * installers on a slow link -- can stay silent for minutes while
21
+ * downloading. A long quiet window is cheaper than a killed, half-written
22
+ * install; the 15-minute ceiling still bounds a runaway.
23
+ */
24
+ export const INSTALL_INACTIVITY_TIMEOUT_MS = 600_000;
25
+ export const UPDATE_INACTIVITY_TIMEOUT_MS = 600_000;
26
+ export const INSTALL_MAX_TOTAL_MS = 15 * 60_000;
8
27
  export const updateAgentCliSchema = z.object({
9
28
  ...memberIdentifier,
10
29
  install_if_missing: z.boolean().default(false).describe('Install the LLM agent CLI on the member if not already installed (default: false)'),
11
30
  });
31
+ const TIMEOUT_RE = /^Command (timed out after \d+ms of inactivity|exceeded max total time of \d+ms)/;
32
+ /**
33
+ * Run an install/update step under the FLEET_PID wrapper. Resolves with the
34
+ * command result, or with `{ timeoutError }` when a budget killed it: a
35
+ * message naming the step, how long it ran, which budget bound, and the
36
+ * remote PID whose tree was killed.
37
+ */
38
+ async function runCliStep(strategy, cmds, step, command, inactivityMs, maxTotalMs) {
39
+ const started = Date.now();
40
+ let pid;
41
+ try {
42
+ return await strategy.execCommand(cmds.wrapPidCapture(command), inactivityMs, maxTotalMs, (p) => { pid = p; });
43
+ }
44
+ catch (err) {
45
+ const msg = String(err?.message ?? err);
46
+ if (!TIMEOUT_RE.test(msg))
47
+ throw err;
48
+ const ranS = Math.round((Date.now() - started) / 1000);
49
+ const why = msg.includes('max total time')
50
+ ? `hit its ${Math.round(maxTotalMs / 1000)}s ceiling`
51
+ : `produced no output for ${Math.round(inactivityMs / 1000)}s`;
52
+ const killed = pid !== undefined
53
+ ? `its remote process tree (PID ${pid}) was killed`
54
+ : 'its SSH channel was closed (no PID was reported, so the remote process may still be running)';
55
+ return {
56
+ timeoutError: `CLI ${step} killed on timeout after running ${ranS}s: it ${why}; ${killed}. ` +
57
+ `The CLI may be partially ${step === 'install' ? 'installed' : 'updated'} -- check the member and re-run update_llm_cli.`,
58
+ };
59
+ }
60
+ }
12
61
  async function updateSingleAgent(agent, installIfMissing) {
13
62
  const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
14
63
  const provider = getProvider(agent.llmProvider);
@@ -29,7 +78,11 @@ async function updateSingleAgent(agent, installIfMissing) {
29
78
  return result;
30
79
  }
31
80
  if (!cliFound && installIfMissing) {
32
- const installResult = await strategy.execCommand(cmds.installAgent(provider), 180000);
81
+ const installResult = await runCliStep(strategy, cmds, 'install', cmds.installAgent(provider), INSTALL_INACTIVITY_TIMEOUT_MS, INSTALL_MAX_TOTAL_MS);
82
+ if ('timeoutError' in installResult) {
83
+ result.error = installResult.timeoutError;
84
+ return result;
85
+ }
33
86
  if (installResult.code !== 0) {
34
87
  result.error = installResult.stderr || 'Install command failed';
35
88
  return result;
@@ -37,7 +90,11 @@ async function updateSingleAgent(agent, installIfMissing) {
37
90
  result.installed = true;
38
91
  }
39
92
  else {
40
- const updateResult = await strategy.execCommand(cmds.updateAgent(provider), 120000);
93
+ const updateResult = await runCliStep(strategy, cmds, 'update', cmds.updateAgent(provider), UPDATE_INACTIVITY_TIMEOUT_MS, INSTALL_MAX_TOTAL_MS);
94
+ if ('timeoutError' in updateResult) {
95
+ result.error = updateResult.timeoutError;
96
+ return result;
97
+ }
41
98
  if (updateResult.code !== 0) {
42
99
  result.error = updateResult.stderr || 'Update command failed';
43
100
  }
@@ -40,21 +40,22 @@ export declare const updateMemberSchema: z.ZodObject<{
40
40
  unreservable: z.ZodOptional<z.ZodBoolean>;
41
41
  shell: z.ZodOptional<z.ZodEnum<["gitbash", "pwsh7", "powershell5"]>>;
42
42
  vcs_provider: z.ZodOptional<z.ZodEnum<["github", "bitbucket", "azure-devops", "none"]>>;
43
+ fleet_install: z.ZodOptional<z.ZodEnum<["auto", "skip", "replace-full"]>>;
43
44
  member_id: z.ZodOptional<z.ZodString>;
44
45
  member_name: z.ZodOptional<z.ZodString>;
45
46
  }, "strip", z.ZodTypeAny, {
46
47
  password?: string | undefined;
47
- member_id?: string | undefined;
48
- work_folder?: string | undefined;
48
+ shell?: "gitbash" | "pwsh7" | "powershell5" | undefined;
49
49
  host?: string | undefined;
50
50
  port?: number | undefined;
51
51
  username?: string | undefined;
52
- shell?: "gitbash" | "pwsh7" | "powershell5" | undefined;
53
- unattended?: "auto" | "dangerous" | "false" | undefined;
54
52
  icon?: string | undefined;
53
+ unattended?: "auto" | "dangerous" | "false" | undefined;
55
54
  category?: string | undefined;
56
55
  tags?: string[] | undefined;
57
56
  unreservable?: boolean | undefined;
57
+ member_id?: string | undefined;
58
+ work_folder?: string | undefined;
58
59
  member_name?: string | undefined;
59
60
  friendly_name?: string | undefined;
60
61
  auth_type?: "password" | "key" | undefined;
@@ -67,7 +68,7 @@ export declare const updateMemberSchema: z.ZodObject<{
67
68
  cloud_idle_timeout_min?: number | undefined;
68
69
  cloud_activity_command?: string | undefined;
69
70
  llm_provider?: "claude" | "codex" | "copilot" | "agy" | "opencode" | undefined;
70
- model_cheap?: "gpt-oss-120b" | "gpt-120" | "gemini-3.8-flash-low" | "haiku" | "gpt-5.4-mini" | undefined;
71
+ model_cheap?: "haiku" | "gpt-oss-120b" | "gpt-120" | "gemini-3.8-flash-low" | "gpt-5.4-mini" | undefined;
71
72
  model_standard?: "gpt-oss-120b" | "gpt-120" | "gemini-3.8-flash-high" | "gemini-3.8-flash-medium" | "gemini-3.1-pro-low" | "sonnet" | "gpt-5.4" | undefined;
72
73
  model_premium?: "gpt-oss-120b" | "sonnet" | "opus" | "gemini-3.1-pro-high" | "claude-opus-4-6-thinking" | undefined;
73
74
  model_tiers?: {
@@ -76,20 +77,21 @@ export declare const updateMemberSchema: z.ZodObject<{
76
77
  premium?: string | undefined;
77
78
  } | undefined;
78
79
  code_intel_provider?: "none" | "codebase-memory" | "gitnexus" | undefined;
80
+ fleet_install?: "auto" | "replace-full" | "skip" | undefined;
79
81
  rotate_password?: boolean | undefined;
80
82
  }, {
81
83
  password?: string | undefined;
82
- member_id?: string | undefined;
83
- work_folder?: string | undefined;
84
+ shell?: "gitbash" | "pwsh7" | "powershell5" | undefined;
84
85
  host?: string | undefined;
85
86
  port?: number | undefined;
86
87
  username?: string | undefined;
87
- shell?: "gitbash" | "pwsh7" | "powershell5" | undefined;
88
- unattended?: unknown;
89
88
  icon?: string | undefined;
89
+ unattended?: unknown;
90
90
  category?: string | undefined;
91
91
  tags?: string[] | undefined;
92
92
  unreservable?: boolean | undefined;
93
+ member_id?: string | undefined;
94
+ work_folder?: string | undefined;
93
95
  member_name?: string | undefined;
94
96
  friendly_name?: string | undefined;
95
97
  auth_type?: "password" | "key" | undefined;
@@ -102,7 +104,7 @@ export declare const updateMemberSchema: z.ZodObject<{
102
104
  cloud_idle_timeout_min?: number | undefined;
103
105
  cloud_activity_command?: string | undefined;
104
106
  llm_provider?: "claude" | "codex" | "copilot" | "agy" | "opencode" | undefined;
105
- model_cheap?: "gpt-oss-120b" | "gpt-120" | "gemini-3.8-flash-low" | "haiku" | "gpt-5.4-mini" | undefined;
107
+ model_cheap?: "haiku" | "gpt-oss-120b" | "gpt-120" | "gemini-3.8-flash-low" | "gpt-5.4-mini" | undefined;
106
108
  model_standard?: "gpt-oss-120b" | "gpt-120" | "gemini-3.8-flash-high" | "gemini-3.8-flash-medium" | "gemini-3.1-pro-low" | "sonnet" | "gpt-5.4" | undefined;
107
109
  model_premium?: "gpt-oss-120b" | "sonnet" | "opus" | "gemini-3.1-pro-high" | "claude-opus-4-6-thinking" | undefined;
108
110
  model_tiers?: {
@@ -111,6 +113,7 @@ export declare const updateMemberSchema: z.ZodObject<{
111
113
  premium?: string | undefined;
112
114
  } | undefined;
113
115
  code_intel_provider?: "none" | "codebase-memory" | "gitnexus" | undefined;
116
+ fleet_install?: "auto" | "replace-full" | "skip" | undefined;
114
117
  rotate_password?: boolean | undefined;
115
118
  }>;
116
119
  export type UpdateMemberInput = z.infer<typeof updateMemberSchema>;
@@ -12,9 +12,13 @@ import { invalidatePreflightCache } from '../services/preflight-check.js';
12
12
  import { CURATED_CHEAP_MODELS, CURATED_STANDARD_MODELS, CURATED_PREMIUM_MODELS } from '../cli/config.js';
13
13
  import { validateOpenCodeModelTiers } from '../utils/opencode-model-validation.js';
14
14
  import { provisionAgents, remoteAgentsDir } from '../services/agent-provisioner.js';
15
+ import { recheckProjectAgentShadows, invalidateProjectAgentShadowCache } from '../services/agent-shadow.js';
15
16
  import { getStrategy } from '../services/strategy.js';
16
17
  import { seedWorkspaceTrust } from '../utils/workspace-trust.js';
17
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';
18
22
  import { isFullyQualifiedPath, workFolderNotAbsoluteError } from '../utils/work-folder-validation.js';
19
23
  export const updateMemberSchema = z.object({
20
24
  ...memberIdentifier,
@@ -37,7 +41,7 @@ export const updateMemberSchema = z.object({
37
41
  work_folder: z.string()
38
42
  .regex(/^[^<>\n\r]+$/, 'work_folder must not contain angle brackets or newlines')
39
43
  .optional()
40
- .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.'),
41
45
  git_access: z.enum(['read', 'push', 'admin', 'issues', 'full']).optional().describe('Git access level for this member'),
42
46
  git_repos: z.array(z.string()).optional().describe('Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])'),
43
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.'),
@@ -55,16 +59,17 @@ export const updateMemberSchema = z.object({
55
59
  standard: z.string().optional(),
56
60
  premium: z.string().optional(),
57
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.'),
58
- 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.'),
59
63
  category: z.string().max(64).optional().describe('Group label for this member (e.g. "doers", "reviewers"). Pass empty string to clear.'),
60
64
  tags: z.array(z.string().max(64, 'Each tag must be 64 characters or fewer'))
61
65
  .max(10, 'At most 10 tags are allowed')
62
66
  .optional()
63
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.'),
64
68
  code_intel_provider: z.enum(['codebase-memory', 'gitnexus', 'none']).optional().describe('Change the code-intelligence provider for this member.'),
65
- 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.'),
66
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.'),
67
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).'),
68
73
  });
69
74
  export async function updateMember(input) {
70
75
  const existingOrError = resolveMember(input.member_id, input.member_name);
@@ -98,16 +103,20 @@ export async function updateMember(input) {
98
103
  if (resultingUnreservable && resultingLlmProvider !== 'none') {
99
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.';
100
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');
101
109
  const needsUniquenessCheck = existing.agentType === 'remote'
102
- ? (hostChanged || portChanged || folderChanged)
103
- : folderChanged;
110
+ ? (hostChanged || portChanged || folderChanged || llmKindChanged)
111
+ : (folderChanged || llmKindChanged);
104
112
  if (needsUniquenessCheck) {
105
113
  const newHost = input.host ?? existing.host;
106
114
  const newPort = input.port ?? existing.port;
107
115
  const newFolder = input.work_folder ?? existing.workFolder;
108
- if (hasDuplicateFolder(existing.agentType, newFolder, newHost, newPort, existing.id)) {
116
+ if (hasDuplicateFolder(existing.agentType, newFolder, newHost, newPort, existing.id, resultingLlmProvider)) {
109
117
  const scope = existing.agentType === 'local' ? 'this machine' : `host ${newHost}:${newPort}`;
110
- 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.`;
111
120
  }
112
121
  }
113
122
  // Resolve named alias (e.g. "blue-circle" → "🔵") before validation
@@ -314,6 +323,126 @@ export async function updateMember(input) {
314
323
  // Local members have no connectivity concept -- always attempt (best-effort/non-fatal).
315
324
  await seedWorkspaceTrust(updated, undefined, 'update_member');
316
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
+ }
317
446
  let result = `✅ Member "${updated.friendlyName}" updated.\n\n`;
318
447
  result += ` Icon: ${updated.icon ?? DEFAULT_ICON}\n`;
319
448
  result += ` ID: ${updated.id}\n`;
@@ -354,6 +483,8 @@ export async function updateMember(input) {
354
483
  const mt = updated.modelTiers;
355
484
  result += ` Model Tiers: cheap=${mt.cheap ?? '-'} standard=${mt.standard ?? '-'} premium=${mt.premium ?? '-'}\n`;
356
485
  }
486
+ if (fleetMcpLine)
487
+ result += ` fleetMcp: ${fleetMcpLine}\n`;
357
488
  if (warnings.length > 0) {
358
489
  result += '\n';
359
490
  for (const w of warnings) {
@@ -74,7 +74,9 @@ export const vcsCredentialExecSchema = z.object({
74
74
  + 'The plaintext credential never leaves the server and never appears in this tool\'s result.'),
75
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
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('Timeout in seconds for the credential-requiring command (default: 120).'),
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.'),
78
80
  });
79
81
  const REDACTION = '[REDACTED:vcs_token]';
80
82
  function execResult(text, fields) {
@@ -169,7 +171,11 @@ export async function vcsCredentialExec(input) {
169
171
  let stdout;
170
172
  let stderr;
171
173
  try {
172
- const res = await strategy.execCommand(finalCommand, (input.timeout_s ?? 120) * 1000);
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);
173
179
  code = res.code;
174
180
  stdout = res.stdout ?? '';
175
181
  stderr = res.stderr ?? '';
package/dist/types.d.ts CHANGED
@@ -20,6 +20,11 @@ export interface Agent {
20
20
  keyPath?: string;
21
21
  workFolder: string;
22
22
  sessionId?: string;
23
+ /** Server build (serverVersion) that recorded sessionId. A default resume
24
+ * (resume=true) of a session recorded under another build -- or with no
25
+ * stamp, i.e. before this field existed -- starts fresh instead: the old
26
+ * session's transcript lists tools/MCP config that build no longer serves. */
27
+ sessionServerVersion?: string;
23
28
  os?: 'windows' | 'macos' | 'linux';
24
29
  /** Windows shell this member's OS commands should target. Only meaningful
25
30
  * when os is 'windows' -- non-windows members leave this unset. Set by
@@ -72,11 +77,103 @@ export interface Agent {
72
77
  * service-local supervisor ledger. Set/enforced by later eft.10.x tasks;
73
78
  * this field only introduces and persists the value. */
74
79
  reservedBy?: string | null;
75
- /** This member fills a role (e.g. fleet-sprint's `orchestrator`) that is
80
+ /** This member fills a role (e.g. fleet-sprint's `backlog`) that is
76
81
  * designed to be shared by more than one sprint at once, so it can never
77
82
  * be exclusively reserved: reserve/release/force_release are no-op
78
83
  * successes and overlap guards skip it. Defaults to false/absent. */
79
84
  unreservable?: boolean;
85
+ /** Last OBSERVED state of this member's own apra-fleet MCP server (install,
86
+ * self-registration, per-folder MCP entry, MEMBER session). Never sticky:
87
+ * every probe overwrites it, so a manual fix flips unavailable -> available
88
+ * on the next probe with no restart (src/services/member-fleet-install.ts). */
89
+ fleetMcp?: FleetMcpStatus;
90
+ /** Remote members: the port the member's OWN apra-fleet install records in
91
+ * its member-install marker, i.e. where its server listens. memberMcpUrl
92
+ * builds the member's MCP URL from it; absent means the install recorded
93
+ * no port (the built-in default is used, and fleetMcp detail says so).
94
+ * Set by the fleetMcp probe (recordFleetMcpStatus) and kept separate from
95
+ * fleetMcp so a later status overwrite never silently drops it. */
96
+ memberMcpPort?: number;
97
+ /** Remote members: the member install's member access secret
98
+ * (<data dir>/member-access.key there), encrypted like encryptedPassword.
99
+ * Its server accepts a `?member=` session only with this secret in the
100
+ * X-Apra-Fleet-Member-Secret header (src/services/member-access-secret.ts).
101
+ * Set by the fleetMcp probe; absent until it read the secret. */
102
+ encryptedMemberMcpSecret?: string;
103
+ }
104
+ /** Observation of a member's apra-fleet MCP server (see Agent.fleetMcp). */
105
+ export interface FleetMcpStatus {
106
+ state: 'available' | 'unavailable';
107
+ /** Machine-readable cause when unavailable (e.g. install-too-old,
108
+ * E-FOLDER-TAKEN, mcp-entry-missing, no-per-project-mcp). */
109
+ reason?: string;
110
+ /** apra-fleet version the member's own install reports, when known. */
111
+ version?: string;
112
+ /** ISO 8601 time of the probe that produced this observation. */
113
+ checkedAt: string;
114
+ /** Human-readable diagnostic for the reason. Never required. */
115
+ detail?: string;
116
+ /** True when the member's KB/code tools could not be verified (e.g. agy),
117
+ * so callers must treat it as unverified (it gets the injected KB block). */
118
+ unverified?: boolean;
119
+ /** ISO 8601 time this fleet last SUCCESSFULLY installed apra-fleet on the
120
+ * member (ensureOnce returned installed:true). Written only by a successful
121
+ * fleet install and carried across later probes; never set by a refusal or
122
+ * an observation-only probe. An observation only: it is NOT an ownership
123
+ * signal (a human full install over a fleet install clears the marker but
124
+ * leaves this set); the member-install marker alone is (see
125
+ * memberHasInstallMarker), and the fleet never sends --force-stop-full-install. */
126
+ fleetInstalledAt?: string;
127
+ /** A requested apra-fleet upgrade that failed before the member was touched
128
+ * (no arch/source, download, checksum or transfer failure) while the older
129
+ * install stayed in use. Present on available and unavailable statuses so a
130
+ * later step can never hide it; `detail` names it too. */
131
+ installFailure?: {
132
+ reason: string;
133
+ detail?: string;
134
+ };
135
+ /** Present only when the beads CLI (bd) is NOT usable on a remote member
136
+ * (neither on its PATH nor in <home>/.apra-fleet/bin): sprint roles there
137
+ * cannot run bd. Independent of `state` (the KB/code tools may still work);
138
+ * absent when bd works or could not be probed. */
139
+ beads?: {
140
+ state: 'missing' | 'broken';
141
+ detail: string;
142
+ fix: string;
143
+ };
144
+ /** Remote members: the port the member's MCP URL uses, as resolved by this
145
+ * probe from the member's own install. Absent when the probe did not get
146
+ * that far (the previously recorded port is kept then). */
147
+ port?: number;
148
+ /** Where `port` came from: the member-install marker, or the built-in
149
+ * default because the marker records no port (detail says so). */
150
+ portSource?: 'marker' | 'default';
151
+ /** Set by the probe that replaced an unmarked (full) install with a member
152
+ * install (fleet_install "replace-full"): the replaced version, what was
153
+ * removed or moved, and the timestamped backup directory on the member.
154
+ * An observation of that probe only; not carried to later probes. */
155
+ replacedFullInstall?: {
156
+ previousVersion: string;
157
+ removed: string[];
158
+ backupPath: string;
159
+ };
160
+ /** Set when a requested apra-fleet install/upgrade on the member did not
161
+ * happen (any install reason, on available and unavailable statuses): the
162
+ * exact manual steps, built for the member's OS/shell, to install this
163
+ * orchestrator's build there by hand (anonymous download URL, SHA-256
164
+ * check, member-mode install, then update_member). register_member /
165
+ * update_member print it in a WARNING; the call itself still succeeds. */
166
+ manualInstall?: string;
167
+ /** Set by the probe that installed the signed stable release of the
168
+ * orchestrator's core (`tag`, e.g. v0.4.4) because no release carries the
169
+ * exact build (`wantedBuild`); only when the member had no apra-fleet or an
170
+ * older core. `why` says what was tried. register_member / update_member
171
+ * print it as a NOTICE. */
172
+ sameCoreFallback?: {
173
+ tag: string;
174
+ wantedBuild: string;
175
+ why: string;
176
+ };
80
177
  }
81
178
  export interface GitHubAppConfig {
82
179
  appId: string;
@@ -1,4 +1,5 @@
1
1
  import { getAgent, findAgentByName, updateAgent } from '../services/registry.js';
2
+ import { serverVersion } from '../version.js';
2
3
  /**
3
4
  * Look up an agent by ID or return a formatted error string.
4
5
  * Eliminates the repeated pattern of getAgent() + "not found" check in every tool.
@@ -141,6 +142,7 @@ export function touchAgent(agentId, sessionId) {
141
142
  const updates = { lastUsed: new Date().toISOString() };
142
143
  if (sessionId !== undefined) {
143
144
  updates.sessionId = sessionId;
145
+ updates.sessionServerVersion = serverVersion;
144
146
  }
145
147
  updateAgent(agentId, updates);
146
148
  idleTouchHook?.(agentId); // T7: notify idle manager to reset idle timer
@@ -1,8 +1,19 @@
1
1
  import type { Agent } from '../types.js';
2
- import type { RemoteOS } from './platform.js';
2
+ /** Decrypted stored auth env vars for the member ({} when none). */
3
+ export declare function decryptAuthEnvVars(agent: Agent): Record<string, string>;
3
4
  /**
4
- * Build a platform-correct inline export prefix for all stored auth env vars.
5
- * Returns empty string if the agent has no stored env vars.
5
+ * File content for the member's shell.
6
+ * - POSIX: `export NAME='value'` lines (single-quoted: fully literal, safe for
7
+ * any byte including newlines), loaded with `.`.
8
+ * - PowerShell: `NAME=<base64(utf8 value)>` lines, parsed (never executed --
9
+ * no execution-policy or quoting exposure).
6
10
  */
7
- export declare function buildAuthEnvPrefix(agent: Agent, os: RemoteOS): string;
11
+ export declare function buildAuthEnvFileContent(vars: Record<string, string>, posix: boolean): string;
12
+ /**
13
+ * Command prefix that loads the staged file into the current shell's
14
+ * environment and deletes it. Carries only the file path, never a value.
15
+ * POSIX: a missing/unreadable file short-circuits the `&&` chain (no
16
+ * unauthenticated run). PowerShell: fails loudly with exit 1.
17
+ */
18
+ export declare function buildAuthEnvSourcePrefix(filePath: string, posix: boolean): string;
8
19
  //# sourceMappingURL=auth-env.d.ts.map