@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,19 @@
1
+ /** The claude user-scope config file: $CLAUDE_CONFIG_DIR/.claude.json when set, else ~/.claude.json. */
2
+ export declare function claudeUserConfigPath(): string;
3
+ /**
4
+ * True when `url` is exactly this install's no-member /mcp endpoint
5
+ * (`fleetUrl`; a trailing slash and the loopback spellings localhost /
6
+ * 127.0.0.1 / [::1] are equivalent). A `?member=` URL is NOT matched:
7
+ * compose_permissions owns those entries.
8
+ */
9
+ export declare function isThisInstallMcpUrl(url: unknown, fleetUrl: string): boolean;
10
+ /**
11
+ * Rewrites every local-scope http entry for this install (exact `fleetUrl`)
12
+ * whose access-secret header is missing or differs: the header is merged in,
13
+ * every other field and header of the entry is kept. stdio entries, bearer-authenticated entries, `?member=` entries and
14
+ * other URLs are left alone; no entry is created. Writes owner-only, and only
15
+ * when something changed. Returns the rewritten projects[] keys. Throws when
16
+ * the file exists but is not valid JSON.
17
+ */
18
+ export declare function refreshClaudeLocalScopeEntries(configFile: string, fleetUrl: string, headers: Record<string, string>): string[];
19
+ //# sourceMappingURL=claude-local-scope-mcp.d.ts.map
@@ -0,0 +1,91 @@
1
+ // Claude LOCAL-scope apra-fleet entries that shadow the user-scope one.
2
+ //
3
+ // Claude Code resolves a server name local scope first (~/.claude.json
4
+ // projects[<path>].mcpServers), before user scope (~/.claude.json
5
+ // mcpServers). install writes the access-secret header into the user-scope
6
+ // entry; a header-less local-scope entry for the same URL (a hand-run
7
+ // `claude mcp add apra-fleet` without --scope) would still win, get 401, and
8
+ // Claude Code would report "Dynamic Client Registration rejected (HTTP 404)".
9
+ // install rewrites those entries too (apra-fleet-d22x).
10
+ import fs from 'node:fs';
11
+ import os from 'node:os';
12
+ import path from 'node:path';
13
+ import { MEMBER_SECRET_HEADER } from './member-access-secret.js';
14
+ import { writeOwnerOnlyFileAtomic } from '../cli/config.js';
15
+ /** The claude user-scope config file: $CLAUDE_CONFIG_DIR/.claude.json when set, else ~/.claude.json. */
16
+ export function claudeUserConfigPath() {
17
+ const dir = process.env.CLAUDE_CONFIG_DIR;
18
+ return dir ? path.join(dir, '.claude.json') : path.join(os.homedir(), '.claude.json');
19
+ }
20
+ const isRecord = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
21
+ /**
22
+ * True when `url` is exactly this install's no-member /mcp endpoint
23
+ * (`fleetUrl`; a trailing slash and the loopback spellings localhost /
24
+ * 127.0.0.1 / [::1] are equivalent). A `?member=` URL is NOT matched:
25
+ * compose_permissions owns those entries.
26
+ */
27
+ export function isThisInstallMcpUrl(url, fleetUrl) {
28
+ if (typeof url !== 'string')
29
+ return false;
30
+ let a;
31
+ let b;
32
+ try {
33
+ a = new URL(url);
34
+ b = new URL(fleetUrl);
35
+ }
36
+ catch {
37
+ return false;
38
+ }
39
+ const loop = (h) => (h === 'localhost' || h === '127.0.0.1' || h === '[::1]' ? 'loopback' : h);
40
+ const strip = (p) => p.replace(/\/+$/, '');
41
+ return a.protocol === b.protocol && loop(a.hostname) === loop(b.hostname)
42
+ && (a.port || '80') === (b.port || '80') && strip(a.pathname) === strip(b.pathname)
43
+ && a.search === '' && a.hash === '';
44
+ }
45
+ /**
46
+ * Rewrites every local-scope http entry for this install (exact `fleetUrl`)
47
+ * whose access-secret header is missing or differs: the header is merged in,
48
+ * every other field and header of the entry is kept. stdio entries, bearer-authenticated entries, `?member=` entries and
49
+ * other URLs are left alone; no entry is created. Writes owner-only, and only
50
+ * when something changed. Returns the rewritten projects[] keys. Throws when
51
+ * the file exists but is not valid JSON.
52
+ */
53
+ export function refreshClaudeLocalScopeEntries(configFile, fleetUrl, headers) {
54
+ if (!fs.existsSync(configFile))
55
+ return [];
56
+ const raw = String(fs.readFileSync(configFile, 'utf-8') ?? '').trim();
57
+ if (!raw)
58
+ return [];
59
+ let json;
60
+ try {
61
+ json = JSON.parse(raw);
62
+ }
63
+ catch {
64
+ throw new Error(`${configFile} is not valid JSON; fix or remove it, then re-run 'apra-fleet install'`);
65
+ }
66
+ if (!isRecord(json) || !isRecord(json.projects))
67
+ return [];
68
+ const want = MEMBER_SECRET_HEADER.toLowerCase();
69
+ const rewritten = [];
70
+ for (const [project, p] of Object.entries(json.projects)) {
71
+ if (!isRecord(p) || !isRecord(p.mcpServers))
72
+ continue;
73
+ for (const [name, e] of Object.entries(p.mcpServers)) {
74
+ if (!isRecord(e) || !isThisInstallMcpUrl(e.url, fleetUrl))
75
+ continue;
76
+ const h = isRecord(e.headers) ? e.headers : {};
77
+ if (Object.keys(h).some(k => k.toLowerCase() === 'authorization'))
78
+ continue;
79
+ const k = Object.keys(h).find(x => x.toLowerCase() === want);
80
+ if (k !== undefined && h[k] === headers[MEMBER_SECRET_HEADER])
81
+ continue;
82
+ const kept = Object.fromEntries(Object.entries(h).filter(([x]) => x.toLowerCase() !== want));
83
+ p.mcpServers[name] = { ...e, headers: { ...kept, ...headers } };
84
+ rewritten.push(project);
85
+ }
86
+ }
87
+ if (rewritten.length)
88
+ writeOwnerOnlyFileAtomic(configFile, JSON.stringify(json, null, 2) + '\n');
89
+ return rewritten;
90
+ }
91
+ //# sourceMappingURL=claude-local-scope-mcp.js.map
@@ -28,7 +28,8 @@ export class AwsCloudProvider {
28
28
  cliChecked = false;
29
29
  cliAvailable = false;
30
30
  constructor(execFn) {
31
- this.run = execFn ?? promisify(exec);
31
+ const execAsync = promisify(exec);
32
+ this.run = execFn ?? ((cmd, opts) => execAsync(cmd, { windowsHide: true, ...opts }));
32
33
  }
33
34
  async ensureCli() {
34
35
  if (this.cliChecked) {
@@ -27,12 +27,41 @@ async function waitForSsh(host, port) {
27
27
  ' after ' + SSH_POLL_ATTEMPTS + ' attempts (' +
28
28
  (SSH_POLL_ATTEMPTS * SSH_POLL_DELAY_MS / 1000) + 's)');
29
29
  }
30
+ /**
31
+ * Decide whether a provisioning call failed, from its structured half when
32
+ * present and its prose only as a fallback.
33
+ *
34
+ * Both tools return `{ text, structuredContent }` and `structuredContent.ok`
35
+ * is the field to branch on -- it survives any future wording change. The
36
+ * guard mirrors provisionOutcome() in
37
+ * packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs: a result that carries no
38
+ * structuredContent at all (a stale test double, or an older client shape)
39
+ * must fall back to the ASCII `[FAIL]` prose marker rather than throw a
40
+ * TypeError -- reProvisionAuth is best-effort, so a throw here would be
41
+ * swallowed by the catch below and silently report every provision as a
42
+ * hard failure.
43
+ */
44
+ function provisionFailed(result) {
45
+ const structured = result?.structuredContent;
46
+ if (structured && typeof structured.ok === 'boolean')
47
+ return !structured.ok;
48
+ return /^\[FAIL\]/.test(provisionSummary(result));
49
+ }
50
+ /** First line of a provisioning result's prose, tolerant of a missing `text`. */
51
+ function provisionSummary(result) {
52
+ const text = result?.text;
53
+ return (typeof text === 'string' ? text : '').split('\n')[0].trim();
54
+ }
30
55
  async function reProvisionAuth(agent) {
31
56
  // F5: Re-provision Claude OAuth credentials from PM machine (best-effort)
32
57
  try {
58
+ // apra-fleet-3swo.7.2: branch on the structured ok discriminator instead
59
+ // of testing whether the summary text starts with the success emoji --
60
+ // the tools no longer emit emoji at all, and `ok` is the field that
61
+ // survives any future wording change.
33
62
  const result = await provisionAuth({ member_id: agent.id });
34
- if (!result.startsWith('\u2705')) {
35
- log('provision_llm_auth warning for ' + agent.friendlyName + ': ' + result.split('\n')[0]);
63
+ if (provisionFailed(result)) {
64
+ log('provision_llm_auth warning for ' + agent.friendlyName + ': ' + provisionSummary(result));
36
65
  }
37
66
  }
38
67
  catch (e) {
@@ -50,8 +79,8 @@ async function reProvisionAuth(agent) {
50
79
  git_access: agent.gitAccess,
51
80
  repos: agent.gitRepos,
52
81
  });
53
- if (!result.startsWith('\u2705')) {
54
- log('provision_vcs_auth warning for ' + agent.friendlyName + ': ' + result.split('\n')[0]);
82
+ if (provisionFailed(result)) {
83
+ log('provision_vcs_auth warning for ' + agent.friendlyName + ': ' + provisionSummary(result));
55
84
  }
56
85
  }
57
86
  catch (e) {
@@ -61,6 +90,8 @@ async function reProvisionAuth(agent) {
61
90
  }
62
91
  }
63
92
  }
93
+ /** In-flight ensureCloudReady per member id; cleared when it settles. */
94
+ const cloudReadyInFlight = new Map();
64
95
  /**
65
96
  * Ensures a cloud member's instance is running and SSH-ready before a tool
66
97
  * call proceeds. Returns the (possibly updated) agent from the registry.
@@ -72,9 +103,24 @@ async function reProvisionAuth(agent) {
72
103
  * Pending: wait for running, then update IP, poll SSH, re-provision auth.
73
104
  * Terminated/shutting-down: throw — instance cannot be used.
74
105
  */
75
- export async function ensureCloudReady(agent) {
106
+ export function ensureCloudReady(agent) {
76
107
  if (!agent.cloud)
77
- return agent;
108
+ return Promise.resolve(agent);
109
+ // GitHub #584 review: one in-flight bring-up per member. execute_prompt
110
+ // races this against its max_total_s budget and returns while the start
111
+ // keeps running in the background; a retry must join that start, not issue
112
+ // a second startInstance/SSH poll/auth re-provision that races it.
113
+ const pending = cloudReadyInFlight.get(agent.id);
114
+ if (pending)
115
+ return pending;
116
+ const p = ensureCloudReadyOnce(agent).finally(() => {
117
+ if (cloudReadyInFlight.get(agent.id) === p)
118
+ cloudReadyInFlight.delete(agent.id);
119
+ });
120
+ cloudReadyInFlight.set(agent.id, p);
121
+ return p;
122
+ }
123
+ async function ensureCloudReadyOnce(agent) {
78
124
  const config = agent.cloud;
79
125
  const state = await awsProvider.getInstanceState(config);
80
126
  if (state === 'terminated' || state === 'shutting-down') {
@@ -1,12 +1,3 @@
1
- /**
2
- * Task wrapper script generator for long-running background commands.
3
- *
4
- * Features:
5
- * F1: restart_command used on retry runs (e.g. checkpoint resume)
6
- * F3: background activity loop touches ~/.fleet-tasks/<taskId>/activity every
7
- * activityIntervalSec while the main PID is alive — keeps idle manager from
8
- * stopping the instance during active work.
9
- */
10
1
  export interface TaskConfig {
11
2
  taskId: string;
12
3
  command: string;
@@ -7,6 +7,7 @@
7
7
  * activityIntervalSec while the main PID is alive — keeps idle manager from
8
8
  * stopping the instance during active work.
9
9
  */
10
+ import { escapePowerShellArgInner } from '../../utils/shell-escape.js';
10
11
  /**
11
12
  * Generate a self-contained bash wrapper script for a long-running task.
12
13
  * Commands are base64-encoded to avoid shell escaping issues.
@@ -36,11 +37,19 @@ export function generateTaskWrapper(config) {
36
37
  'MAX_RETRIES=' + config.maxRetries,
37
38
  'ACTIVITY_INTERVAL=' + config.activityIntervalSec,
38
39
  '',
40
+ '# Owner-only: the task files may hold resolved credential values',
41
+ 'umask 077',
39
42
  'mkdir -p "' + D + 'TASK_DIR"',
40
43
  '',
41
- '# Decode commands from base64 to avoid shell escaping issues',
44
+ '# Decode commands from base64 to avoid shell escaping issues. They run',
45
+ '# from owner-only files, never as a bash argument: a resolved secret in',
46
+ '# the command text would otherwise sit in that bash\'s argv (readable via',
47
+ '# ps) for the whole task.',
42
48
  'MAIN_CMD=$(printf \'%s\' \'' + cmdB64 + '\' | base64 -d)',
43
49
  'RESTART_CMD=$(printf \'%s\' \'' + restartB64 + '\' | base64 -d)',
50
+ 'printf \'%s\\n\' "' + D + 'MAIN_CMD" > "' + D + 'TASK_DIR/main.cmd"',
51
+ 'printf \'%s\\n\' "' + D + 'RESTART_CMD" > "' + D + 'TASK_DIR/restart.cmd"',
52
+ 'unset MAIN_CMD RESTART_CMD',
44
53
  '',
45
54
  '# Write / update status.json',
46
55
  'write_status() {',
@@ -86,7 +95,7 @@ export function generateTaskWrapper(config) {
86
95
  'EXIT_CODE=0',
87
96
  '',
88
97
  '# First run: use MAIN_CMD',
89
- 'bash -c "' + D + 'MAIN_CMD" >> "' + D + 'TASK_DIR/task.log" 2>&1 || EXIT_CODE=' + D + '?',
98
+ 'bash "' + D + 'TASK_DIR/main.cmd" >> "' + D + 'TASK_DIR/task.log" 2>&1 || EXIT_CODE=' + D + '?',
90
99
  '',
91
100
  'while [ ' + D + 'EXIT_CODE -ne 0 ] && [ ' + D + 'RETRIES -lt ' + D + 'MAX_RETRIES ]; do',
92
101
  ' RETRIES=$((' + D + 'RETRIES + 1))',
@@ -94,14 +103,14 @@ export function generateTaskWrapper(config) {
94
103
  ' echo "[fleet-task] retry ' + D + 'RETRIES/' + D + 'MAX_RETRIES at $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "' + D + 'TASK_DIR/task.log"',
95
104
  ' EXIT_CODE=0',
96
105
  ' # F1: use restart command on retries',
97
- ' bash -c "' + D + 'RESTART_CMD" >> "' + D + 'TASK_DIR/task.log" 2>&1 || EXIT_CODE=' + D + '?',
106
+ ' bash "' + D + 'TASK_DIR/restart.cmd" >> "' + D + 'TASK_DIR/task.log" 2>&1 || EXIT_CODE=' + D + '?',
98
107
  'done',
99
108
  '',
100
109
  '# Kill activity loop',
101
110
  'kill ' + D + 'ACTIVITY_PID 2>/dev/null || true',
102
111
  '',
103
- '# Remove PID file',
104
- 'rm -f "' + D + 'TASK_DIR/task.pid"',
112
+ '# Remove PID file and the command files',
113
+ 'rm -f "' + D + 'TASK_DIR/task.pid" "' + D + 'TASK_DIR/main.cmd" "' + D + 'TASK_DIR/restart.cmd"',
105
114
  '',
106
115
  'if [ ' + D + 'EXIT_CODE -eq 0 ]; then',
107
116
  ' update_status "completed" 0 ' + D + 'RETRIES',
@@ -133,7 +142,7 @@ export function generateTaskWrapper(config) {
133
142
  export function generateTaskWrapperWindows(config) {
134
143
  const cmdB64 = Buffer.from(config.command, 'utf-8').toString('base64');
135
144
  const restartB64 = Buffer.from(config.restartCommand ?? config.command, 'utf-8').toString('base64');
136
- const taskId = config.taskId.replace(/'/g, "''");
145
+ const taskId = escapePowerShellArgInner(config.taskId);
137
146
  const lines = [
138
147
  "$ErrorActionPreference = 'Continue'",
139
148
  `$TaskId = '${taskId}'`,
@@ -5,7 +5,6 @@ import { getAgentOS, getAgentShell } from '../utils/agent-helpers.js';
5
5
  import { githubProvider } from './vcs/github.js';
6
6
  import { bitbucketProvider } from './vcs/bitbucket.js';
7
7
  import { azureDevOpsProvider } from './vcs/azure-devops.js';
8
- const DEFAULT_TTL_MS = 55 * 60 * 1000; // 55 minutes
9
8
  // apra-fleet-5co8.5.1: setTimeout's delay is a signed 32-bit int internally;
10
9
  // Node (and browsers) SILENTLY CLAMP an overflowing delay to ~1ms rather than
11
10
  // running it after the full requested duration (see Node's lib/timers.js
@@ -24,22 +23,37 @@ const providers = {
24
23
  };
25
24
  export function scheduleCredentialCleanup(agentId, expiresAt) {
26
25
  cancelCredentialCleanup(agentId);
27
- let delayMs = DEFAULT_TTL_MS;
28
- if (expiresAt) {
29
- const expiresMs = new Date(expiresAt).getTime();
30
- if (!isNaN(expiresMs)) {
31
- const untilExpiry = expiresMs - Date.now();
32
- if (untilExpiry > MAX_TIMEOUT_MS) {
33
- // Beyond setTimeout's ceiling: do not schedule an auto-revoke that
34
- // would silently fire near-immediately instead of at the real
35
- // expiry. checkVcsTokenExpiry's day-scale warning (fired on the next
36
- // provision/preflight check) and reactive AUTH_EXPIRED
37
- // classification are the backstop for this horizon instead.
38
- return;
39
- }
40
- delayMs = Math.max(0, untilExpiry);
41
- }
26
+ // No known real expiry: do NOT fall back to a blind default-TTL
27
+ // self-destruct (a prior version used a hardcoded 55-minute
28
+ // DEFAULT_TTL_MS here, unrelated to the deployed credential's actual
29
+ // lifetime -- every PAT-mode deploy scheduled its own near-arbitrary
30
+ // self-revoke and looked like "tokens keep expiring too fast"). Skipping
31
+ // scheduling entirely trades that for a real tradeoff of its own: a
32
+ // credential deployed with no derivable expiry now lives on disk/in git
33
+ // config until something explicit revokes it (revoke_vcs_auth, or a later
34
+ // provision_vcs_auth call that supersedes it -- see the supersession-revoke
35
+ // in provision-vcs-auth.ts) -- it is NOT auto-revoked at all, and unlike the
36
+ // beyond-setTimeout-ceiling case below, checkVcsTokenExpiry has no warning
37
+ // to offer either: it is only called (provision-vcs-auth.ts) when an
38
+ // expiresAt actually exists, so a no-expiry credential gets no reactive
39
+ // backstop of any kind. This is a deliberate, real security-posture
40
+ // tradeoff (an indefinitely-live unrevoked credential vs. a blind
41
+ // self-destruct at an arbitrary time), not a resolved one.
42
+ if (!expiresAt)
43
+ return;
44
+ const expiresMs = new Date(expiresAt).getTime();
45
+ if (isNaN(expiresMs))
46
+ return;
47
+ const untilExpiry = expiresMs - Date.now();
48
+ if (untilExpiry > MAX_TIMEOUT_MS) {
49
+ // Beyond setTimeout's ceiling: do not schedule an auto-revoke that
50
+ // would silently fire near-immediately instead of at the real
51
+ // expiry. checkVcsTokenExpiry's day-scale warning (fired on the next
52
+ // provision/preflight check) and reactive AUTH_EXPIRED
53
+ // classification are the backstop for this horizon instead.
54
+ return;
42
55
  }
56
+ const delayMs = Math.max(0, untilExpiry);
43
57
  const timer = setTimeout(async () => {
44
58
  cleanupTimers.delete(agentId);
45
59
  try {
@@ -59,7 +73,11 @@ export function scheduleCredentialCleanup(agentId, expiresAt) {
59
73
  const result = await strategy.execCommand(cmd, 15000);
60
74
  return result.stdout;
61
75
  };
62
- await service.revoke(agent, cmds, exec);
76
+ // Revoke the SAME label/scopeUrl this deploy actually used (persisted
77
+ // by provision-vcs-auth.ts at deploy time) -- not an unlabeled/
78
+ // default-host guess, which can unset a different, still-valid
79
+ // credential's git-config entry and/or delete the wrong on-disk file.
80
+ await service.revoke(agent, cmds, exec, agent.vcsCredentialLabel, agent.vcsCredentialScopeUrl);
63
81
  }
64
82
  catch { /* silent — best-effort cleanup */ }
65
83
  }, delayMs);
@@ -0,0 +1,32 @@
1
+ export interface WatchdogOptions {
2
+ /** Absolute path the worker appends event_loop_blocked lines to. */
3
+ logFile: string | null;
4
+ tickMs?: number;
5
+ /** Main-thread drift beyond which event_loop_lag is logged. */
6
+ lagThresholdMs?: number;
7
+ /** Heartbeat age beyond which the worker reports event_loop_blocked. */
8
+ blockedThresholdMs?: number;
9
+ /** Re-report interval while still blocked. */
10
+ blockedRepeatMs?: number;
11
+ }
12
+ export interface WorkerTickState {
13
+ prevTick: number;
14
+ lastBeatSeen: number;
15
+ suspendedBeat: number | null;
16
+ lastReportAt: number | null;
17
+ }
18
+ /**
19
+ * Pure worker decision for one tick. Runs inside the worker (serialized via
20
+ * toString -- keep it self-contained) and in unit tests.
21
+ * Returns the blocked duration to report, or null.
22
+ */
23
+ export declare function evaluateWatchdogTick(state: WorkerTickState, now: number, beat: number, cfg: {
24
+ tickMs: number;
25
+ blockedThresholdMs: number;
26
+ blockedRepeatMs: number;
27
+ }): number | null;
28
+ export interface EventLoopWatchdog {
29
+ stop(): Promise<void>;
30
+ }
31
+ export declare function startEventLoopWatchdog(opts: WatchdogOptions): EventLoopWatchdog;
32
+ //# sourceMappingURL=event-loop-watchdog.d.ts.map
@@ -0,0 +1,140 @@
1
+ /**
2
+ * Event-loop stall watchdog (GitHub #562).
3
+ *
4
+ * A frozen event loop (a blocking sync call, a console stuck in QuickEdit, an
5
+ * undrained stderr pipe) or a suspended process/host used to leave no trace.
6
+ * Two cheap signals:
7
+ *
8
+ * 1. Main thread, every 1s: if the timer fired more than 2s late, log
9
+ * `event_loop_lag ms=<monotonic drift> wall_ms=<wall-clock gap>` -- AFTER
10
+ * the fact. A host suspend shows up here too (wall_ms >> interval).
11
+ * 2. Worker thread heartbeat: the main thread stamps a shared timestamp on
12
+ * every tick; a worker checks it every second and, while the main loop is
13
+ * stalled, appends `event_loop_blocked ms=<n>` straight to the log file
14
+ * (appendFileSync -- the main thread cannot write) -- DURING the stall,
15
+ * first after the stall threshold and then every 30s. If the worker itself
16
+ * did not get to run on time, the whole process/host was suspended, not
17
+ * the main loop blocked: that tick is skipped, so a suspend shows only the
18
+ * lag line after resume.
19
+ *
20
+ * The worker is unref'd (never keeps the process alive) and stop() clears the
21
+ * interval and terminates the worker.
22
+ */
23
+ import { Worker } from 'node:worker_threads';
24
+ import { performance } from 'node:perf_hooks';
25
+ import { logWarn } from '../utils/log-helpers.js';
26
+ /**
27
+ * Pure worker decision for one tick. Runs inside the worker (serialized via
28
+ * toString -- keep it self-contained) and in unit tests.
29
+ * Returns the blocked duration to report, or null.
30
+ */
31
+ export function evaluateWatchdogTick(state, now, beat, cfg) {
32
+ const selfGap = now - state.prevTick;
33
+ state.prevTick = now;
34
+ if (beat !== state.lastBeatSeen) {
35
+ // The main loop is alive (a new heartbeat): clear any stall state.
36
+ state.lastBeatSeen = beat;
37
+ state.suspendedBeat = null;
38
+ state.lastReportAt = null;
39
+ return null;
40
+ }
41
+ // The worker itself ran late: the whole process/host was suspended. Do not
42
+ // read the stale heartbeat as a blocked main loop until it beats again.
43
+ // (Where the monotonic clock excludes suspend time, the stale-beat age
44
+ // below stays small instead -- either way a suspend is not reported here.)
45
+ if (selfGap > cfg.tickMs * 2 + 1000) {
46
+ state.suspendedBeat = beat;
47
+ return null;
48
+ }
49
+ if (state.suspendedBeat === beat)
50
+ return null;
51
+ const blocked = now - beat;
52
+ if (blocked < cfg.blockedThresholdMs)
53
+ return null;
54
+ if (state.lastReportAt !== null && now - state.lastReportAt < cfg.blockedRepeatMs)
55
+ return null;
56
+ state.lastReportAt = now;
57
+ return Math.round(blocked);
58
+ }
59
+ function nowAbs() {
60
+ return performance.timeOrigin + performance.now();
61
+ }
62
+ const WORKER_SOURCE = (evaluate) => `
63
+ const { workerData } = require('node:worker_threads');
64
+ const fs = require('node:fs');
65
+ const { performance } = require('node:perf_hooks');
66
+ const evaluate = (${evaluate});
67
+ const beats = new Float64Array(workerData.sab);
68
+ const cfg = workerData.cfg;
69
+ const nowAbs = () => performance.timeOrigin + performance.now();
70
+ const state = { prevTick: nowAbs(), lastBeatSeen: beats[0], suspendedBeat: null, lastReportAt: null };
71
+ function localTs() {
72
+ const now = new Date();
73
+ const off = -now.getTimezoneOffset();
74
+ const sign = off >= 0 ? '+' : '-';
75
+ const a = Math.abs(off);
76
+ const h = String(Math.floor(a / 60)).padStart(2, '0');
77
+ const m = String(a % 60).padStart(2, '0');
78
+ return new Date(now.getTime() + off * 60000).toISOString().slice(0, -1) + sign + h + ':' + m;
79
+ }
80
+ setInterval(() => {
81
+ const blocked = evaluate(state, nowAbs(), beats[0], cfg);
82
+ if (blocked === null || !workerData.logFile) return;
83
+ try {
84
+ fs.appendFileSync(workerData.logFile, JSON.stringify({ ts: localTs(), level: 'warn', tag: 'event_loop_blocked', msg: 'ms=' + blocked }) + '\\n');
85
+ } catch {}
86
+ }, cfg.tickMs);
87
+ `;
88
+ export function startEventLoopWatchdog(opts) {
89
+ const tickMs = opts.tickMs ?? 1000;
90
+ const lagThresholdMs = opts.lagThresholdMs ?? 2000;
91
+ const cfg = {
92
+ tickMs,
93
+ blockedThresholdMs: opts.blockedThresholdMs ?? 3000,
94
+ blockedRepeatMs: opts.blockedRepeatMs ?? 30_000,
95
+ };
96
+ const sab = new SharedArrayBuffer(8);
97
+ const beats = new Float64Array(sab);
98
+ beats[0] = nowAbs();
99
+ let worker = null;
100
+ try {
101
+ worker = new Worker(WORKER_SOURCE(evaluateWatchdogTick.toString()), {
102
+ eval: true,
103
+ workerData: { sab, cfg, logFile: opts.logFile },
104
+ });
105
+ worker.unref();
106
+ worker.on('error', () => { });
107
+ }
108
+ catch {
109
+ worker = null;
110
+ }
111
+ let lastMono = performance.now();
112
+ let lastWall = Date.now();
113
+ const interval = setInterval(() => {
114
+ const mono = performance.now();
115
+ const wall = Date.now();
116
+ beats[0] = nowAbs();
117
+ const drift = mono - lastMono - tickMs;
118
+ const wallGap = wall - lastWall;
119
+ if (drift > lagThresholdMs || wallGap - tickMs > lagThresholdMs) {
120
+ logWarn('event_loop_lag', `ms=${Math.round(Math.max(drift, 0))} wall_ms=${wallGap}`);
121
+ }
122
+ lastMono = mono;
123
+ lastWall = wall;
124
+ }, tickMs);
125
+ interval.unref();
126
+ return {
127
+ async stop() {
128
+ clearInterval(interval);
129
+ if (worker) {
130
+ const w = worker;
131
+ worker = null;
132
+ try {
133
+ await w.terminate();
134
+ }
135
+ catch { /* ignore */ }
136
+ }
137
+ },
138
+ };
139
+ }
140
+ //# sourceMappingURL=event-loop-watchdog.js.map
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Windows dispatch completion: process exit, not pipe EOF.
3
+ *
4
+ * On Windows a grandchild started by the dispatched CLI (a sandbox server the
5
+ * deployer launched, a runaway `find.exe`, a test runner) inherits the
6
+ * dispatch's stdout/stderr handles. Those handles stay open for as long as the
7
+ * grandchild lives, so the exec side never sees EOF on the pipe even though
8
+ * the process we actually dispatched (claude.exe and its PowerShell wrapper)
9
+ * exited minutes ago. Node's `child.on('close')` and ssh2's channel `close`
10
+ * both wait for that EOF, which is why a deploy dispatch could sit "in flight"
11
+ * for 25-70 minutes after the LLM had finished.
12
+ *
13
+ * The chosen strategy is BOTH sides, documented at each change site:
14
+ * - spawn side: scripts/sandbox-deploy.mjs already starts the sandbox pair
15
+ * with `detached: true` and its own log-file fds (never the inherited
16
+ * pipe), so long-lived servers we start ourselves no longer pin it;
17
+ * - read side (this module): treat the dispatched process's EXIT as the
18
+ * completion signal on Windows, drain whatever the pipe already produced
19
+ * for a short grace window, then settle -- instead of waiting for an EOF
20
+ * that an arbitrary grandchild can withhold indefinitely. The grandchild
21
+ * is deliberately left running: the integ phase expects the sandbox pair
22
+ * to survive the dispatch that started it.
23
+ *
24
+ * The grace window exists so output still buffered in the pipe at exit time is
25
+ * collected before the promise settles (transcript / last-assistant-turn
26
+ * capture depends on it). POSIX is unchanged: there the `nohup`/subshell path
27
+ * already reaches EOF when the process exits, and `close` is the correct,
28
+ * strictly-more-complete signal.
29
+ */
30
+ /** Grace window (ms) between the dispatched process exiting and settling. */
31
+ export declare const DEFAULT_EXIT_DRAIN_MS = 2000;
32
+ /**
33
+ * Resolved grace window. `FLEET_EXIT_DRAIN_MS` exists so tests (and an
34
+ * operator debugging a slow member) can shorten or lengthen the window; a
35
+ * missing or non-numeric value falls back to the default.
36
+ */
37
+ export declare function exitDrainMs(): number;
38
+ /**
39
+ * Whether the exec side should complete on process exit rather than pipe EOF.
40
+ * Windows only -- this is a Windows handle-inheritance problem, and on POSIX
41
+ * settling early would be a behaviour change with no bug behind it.
42
+ */
43
+ export declare function completesOnProcessExit(agentOs: string | undefined): boolean;
44
+ //# sourceMappingURL=exit-drain.d.ts.map
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Windows dispatch completion: process exit, not pipe EOF.
3
+ *
4
+ * On Windows a grandchild started by the dispatched CLI (a sandbox server the
5
+ * deployer launched, a runaway `find.exe`, a test runner) inherits the
6
+ * dispatch's stdout/stderr handles. Those handles stay open for as long as the
7
+ * grandchild lives, so the exec side never sees EOF on the pipe even though
8
+ * the process we actually dispatched (claude.exe and its PowerShell wrapper)
9
+ * exited minutes ago. Node's `child.on('close')` and ssh2's channel `close`
10
+ * both wait for that EOF, which is why a deploy dispatch could sit "in flight"
11
+ * for 25-70 minutes after the LLM had finished.
12
+ *
13
+ * The chosen strategy is BOTH sides, documented at each change site:
14
+ * - spawn side: scripts/sandbox-deploy.mjs already starts the sandbox pair
15
+ * with `detached: true` and its own log-file fds (never the inherited
16
+ * pipe), so long-lived servers we start ourselves no longer pin it;
17
+ * - read side (this module): treat the dispatched process's EXIT as the
18
+ * completion signal on Windows, drain whatever the pipe already produced
19
+ * for a short grace window, then settle -- instead of waiting for an EOF
20
+ * that an arbitrary grandchild can withhold indefinitely. The grandchild
21
+ * is deliberately left running: the integ phase expects the sandbox pair
22
+ * to survive the dispatch that started it.
23
+ *
24
+ * The grace window exists so output still buffered in the pipe at exit time is
25
+ * collected before the promise settles (transcript / last-assistant-turn
26
+ * capture depends on it). POSIX is unchanged: there the `nohup`/subshell path
27
+ * already reaches EOF when the process exits, and `close` is the correct,
28
+ * strictly-more-complete signal.
29
+ */
30
+ /** Grace window (ms) between the dispatched process exiting and settling. */
31
+ export const DEFAULT_EXIT_DRAIN_MS = 2000;
32
+ /**
33
+ * Resolved grace window. `FLEET_EXIT_DRAIN_MS` exists so tests (and an
34
+ * operator debugging a slow member) can shorten or lengthen the window; a
35
+ * missing or non-numeric value falls back to the default.
36
+ */
37
+ export function exitDrainMs() {
38
+ const raw = process.env.FLEET_EXIT_DRAIN_MS;
39
+ if (raw === undefined || raw.trim() === '')
40
+ return DEFAULT_EXIT_DRAIN_MS;
41
+ const n = Number(raw);
42
+ return Number.isFinite(n) && n >= 0 ? n : DEFAULT_EXIT_DRAIN_MS;
43
+ }
44
+ /**
45
+ * Whether the exec side should complete on process exit rather than pipe EOF.
46
+ * Windows only -- this is a Windows handle-inheritance problem, and on POSIX
47
+ * settling early would be a behaviour change with no bug behind it.
48
+ */
49
+ export function completesOnProcessExit(agentOs) {
50
+ return (agentOs ?? '').toLowerCase() === 'windows';
51
+ }
52
+ //# sourceMappingURL=exit-drain.js.map