@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
@@ -7,6 +7,7 @@ import { spawn, execSync } from 'node:child_process';
7
7
  import { FLEET_DIR } from '../paths.js';
8
8
  import { encryptPassword } from '../utils/crypto.js';
9
9
  import { logError } from '../utils/log-helpers.js';
10
+ import { escapeShellArg, escapeAppleScriptString, quoteWindowsArgv } from '../utils/shell-escape.js';
10
11
  import { OOB_TIMEOUT_MS } from '../utils/oob-timeout.js';
11
12
  import { launchAuthWeb } from './auth-web.js';
12
13
  import { fleetEvents } from './event-bus.js';
@@ -33,7 +34,7 @@ function killProcess(pid) {
33
34
  return;
34
35
  try {
35
36
  if (process.platform === 'win32') {
36
- execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore' });
37
+ execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', windowsHide: true });
37
38
  }
38
39
  else {
39
40
  process.kill(pid, 'SIGTERM');
@@ -346,7 +347,7 @@ async function collectOobInput(mode, memberName, toolName, _opts) {
346
347
  });
347
348
  const raceResult = await Promise.race([passwordPromise, cancellationPromise]);
348
349
  if (raceResult === null) {
349
- // The terminal exited with code 0 (Windows `start /wait` always exits 0, even
350
+ // The terminal exited with code 0 (some terminal launchers exit 0 even
350
351
  // on user-close). Wait briefly for any in-flight socket message — if the user
351
352
  // genuinely submitted, the password arrives within milliseconds of process exit.
352
353
  // If nothing arrives in 500 ms, treat it as a user cancellation.
@@ -528,7 +529,7 @@ function findLinuxTerminal() {
528
529
  if (termProg && termProgramMap[termProg]) {
529
530
  const entry = termProgramMap[termProg];
530
531
  try {
531
- execSync(`which ${entry.bin}`, { stdio: 'ignore' });
532
+ execSync(`which ${entry.bin}`, { stdio: 'ignore', windowsHide: true });
532
533
  return entry;
533
534
  }
534
535
  catch { /* not in PATH, fall through */ }
@@ -556,13 +557,69 @@ function findLinuxTerminal() {
556
557
  ];
557
558
  for (const entry of candidates) {
558
559
  try {
559
- execSync(`which ${entry.bin}`, { stdio: 'ignore' });
560
+ execSync(`which ${entry.bin}`, { stdio: 'ignore', windowsHide: true });
560
561
  return entry;
561
562
  }
562
563
  catch { /* not found */ }
563
564
  }
564
565
  return null;
565
566
  }
567
+ /**
568
+ * Build the AppleScript that opens a macOS Terminal window, runs the auth
569
+ * command in it, and waits for it to finish. Terminal's `do script` hands the
570
+ * string to the user's login shell, so every argv element is POSIX
571
+ * single-quoted (member names and the --prompt text can carry spaces and
572
+ * caller-supplied host/username values), and the whole command is then escaped
573
+ * for the AppleScript string literal (backslash first, then double quote).
574
+ * The command writes its own exit code to `tmpFile` so the caller can read it.
575
+ * Exported for tests.
576
+ */
577
+ export function buildMacTerminalAppleScript(fullArgs, tmpFile) {
578
+ const command = [...fullArgs.map(escapeShellArg), `; echo $? > ${escapeShellArg(tmpFile)}`].join(' ');
579
+ return `
580
+ tell application "Terminal"
581
+ activate
582
+ set w to do script "${escapeAppleScriptString(command)}"
583
+ delay 1
584
+ repeat while busy of w
585
+ delay 0.5
586
+ end repeat
587
+ end tell
588
+ `;
589
+ }
590
+ /** Title of the Windows credential-entry console window (set by the child). */
591
+ export const WINDOWS_AUTH_WINDOW_TITLE = 'Fleet Password Entry';
592
+ /** Env var the `secret` CLI reads to title its console window on Windows. */
593
+ export const OOB_WINDOW_TITLE_ENV = 'APRA_FLEET_OOB_WINDOW_TITLE';
594
+ // Fixed launcher script: the executable and its argument line arrive via env
595
+ // vars, so no caller-influenced text is ever parsed by cmd.exe or PowerShell.
596
+ // Start-Process passes the argument line verbatim to CreateProcess, where the
597
+ // child's CRT splits it (see quoteWindowsArgv).
598
+ const WINDOWS_AUTH_LAUNCHER_PS = [
599
+ "$ErrorActionPreference = 'Stop'",
600
+ '$exe = $env:APRA_FLEET_OOB_EXE',
601
+ '$argLine = $env:APRA_FLEET_OOB_ARGS',
602
+ 'Remove-Item Env:APRA_FLEET_OOB_EXE, Env:APRA_FLEET_OOB_ARGS -ErrorAction SilentlyContinue',
603
+ '$p = Start-Process -FilePath $exe -ArgumentList $argLine -Wait -PassThru',
604
+ 'exit $p.ExitCode',
605
+ ].join('; ');
606
+ /**
607
+ * Build the spawn() call that opens the Windows credential-entry console.
608
+ * Returns the file/argv for a hidden PowerShell launcher plus the env vars it
609
+ * reads. Exported for tests.
610
+ */
611
+ export function buildWindowsAuthLaunch(fullArgs) {
612
+ const [exe, ...rest] = fullArgs;
613
+ return {
614
+ file: 'powershell',
615
+ args: ['-NoProfile', '-NonInteractive', '-EncodedCommand', Buffer.from(WINDOWS_AUTH_LAUNCHER_PS, 'utf16le').toString('base64')],
616
+ env: {
617
+ APRA_FLEET_OOB_EXE: exe,
618
+ APRA_FLEET_OOB_ARGS: rest.map(quoteWindowsArgv).join(' '),
619
+ [OOB_WINDOW_TITLE_ENV]: WINDOWS_AUTH_WINDOW_TITLE,
620
+ },
621
+ };
622
+ }
566
623
  /**
567
624
  * Launch a new terminal window running `apra-fleet secret --set <memberName>` or `apra-fleet auth <memberName>`.
568
625
  * Records the spawned PID in the pending request so it can be killed when credential is received.
@@ -598,20 +655,7 @@ export function launchAuthTerminal(memberName, extraArgs, onExit) {
598
655
  let exitCode = 1; // Default to cancellation
599
656
  const tmpFile = path.join(os.tmpdir(), `fleet-auth-exit-${Date.now()}`);
600
657
  try {
601
- // The command to run in the terminal. It must be a single string.
602
- // It writes its own exit code to a temp file so we can read it later.
603
- const command = [...fullArgs, `; echo $? > "${tmpFile}"`].join(' ');
604
- // AppleScript to launch terminal, run command, and wait for it to be "not busy".
605
- const appleScript = `
606
- tell application "Terminal"
607
- activate
608
- set w to do script "${command.replace(/"/g, '\\"')}"
609
- delay 1
610
- repeat while busy of w
611
- delay 0.5
612
- end repeat
613
- end tell
614
- `;
658
+ const appleScript = buildMacTerminalAppleScript(fullArgs, tmpFile);
615
659
  const child = spawn('osascript', ['-']);
616
660
  child.stdin.write(appleScript);
617
661
  child.stdin.end();
@@ -647,11 +691,12 @@ export function launchAuthTerminal(memberName, extraArgs, onExit) {
647
691
  return 'launched';
648
692
  }
649
693
  else if (platform === 'win32') {
650
- // Windows: start /wait ensures that the parent cmd.exe process waits for the new
651
- // terminal window to be closed. This allows us to capture the exit event.
652
- // The title argument to start is required.
653
- const spawnArgs = ['/c', 'start', 'Fleet Password Entry', '/wait', ...fullArgs];
654
- child = spawn('cmd', spawnArgs, { stdio: 'ignore' });
694
+ // Windows: a hidden PowerShell launcher opens the new console window with
695
+ // Start-Process -Wait, so the exit event fires when that window closes.
696
+ // cmd.exe is deliberately not involved (it expands % and treats & | ^ as
697
+ // operators inside the --prompt text); see buildWindowsAuthLaunch.
698
+ const launch = buildWindowsAuthLaunch(fullArgs);
699
+ child = spawn(launch.file, launch.args, { stdio: 'ignore', windowsHide: true, env: { ...process.env, ...launch.env } });
655
700
  if (child.pid) {
656
701
  const pending = pendingRequests.get(memberName);
657
702
  if (pending)
@@ -30,7 +30,7 @@ function findBrowserOpener() {
30
30
  if (!process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
31
31
  return null;
32
32
  try {
33
- execSync('which xdg-open', { stdio: 'ignore' });
33
+ execSync('which xdg-open', { stdio: 'ignore', windowsHide: true });
34
34
  return { cmd: 'xdg-open', args: [] };
35
35
  }
36
36
  catch {
@@ -1,5 +1,5 @@
1
1
  import type { Agent } from '../types.js';
2
- import type { ProviderAdapter } from '../providers/provider.js';
2
+ import type { ProviderAdapter, TokenUsage } from '../providers/provider.js';
3
3
  /**
4
4
  * Usage/budget awareness for execute_prompt (apra-fleet-eft.80.2).
5
5
  *
@@ -89,16 +89,19 @@ export declare function estimatedSpendFor(scope: string): number;
89
89
  export declare function _resetBudgetState(): void;
90
90
  /**
91
91
  * Spend that a single dispatch's token usage represents, in the budget's unit.
92
- * For a token budget this is just input+output tokens. For a dollar budget it
93
- * is priced via getMemberModelPricing() for the resolved tier; an unpriceable
92
+ * A token budget counts input + output only -- the meaning it had before
93
+ * cache tokens were parsed. Cache reads re-count the whole cached prefix on
94
+ * every turn (one real session: 58,653 input+output tokens vs 17,966,362 with
95
+ * cache), so adding them would make an existing token budget bind hundreds of
96
+ * times sooner for an upgrading user. Cache cost is carried by dollar budgets.
97
+ * For a dollar budget the provider's own reported cost (usage.cost_usd) is
98
+ * used as-is when present; otherwise each count is priced at its own rate via
99
+ * getMemberModelPricing() for the resolved tier; an unpriceable
94
100
  * tier (unknown model, subscription-plan member with no meter) contributes 0
95
101
  * rather than a fabricated cost -- the same "never invent a price" discipline
96
102
  * model-pricing.ts already follows.
97
103
  */
98
- export declare function estimateDispatchCost(agent: Agent, provider: ProviderAdapter, tier: 'cheap' | 'standard' | 'premium' | undefined, usage: {
99
- input_tokens: number;
100
- output_tokens: number;
101
- }, unit: BudgetUnit): number;
104
+ export declare function estimateDispatchCost(agent: Agent, provider: ProviderAdapter, tier: 'cheap' | 'standard' | 'premium' | undefined, usage: TokenUsage, unit: BudgetUnit): number;
102
105
  /**
103
106
  * Current budget state for a scope, or undefined when the scope has no
104
107
  * configured budget (callers must treat undefined as "no budget awareness --
@@ -122,9 +125,6 @@ export declare function recordAndEvaluate(opts: {
122
125
  agent: Agent;
123
126
  provider: ProviderAdapter;
124
127
  tier: 'cheap' | 'standard' | 'premium' | undefined;
125
- usage: {
126
- input_tokens: number;
127
- output_tokens: number;
128
- };
128
+ usage: TokenUsage;
129
129
  }): Promise<BudgetState | undefined>;
130
130
  //# sourceMappingURL=budget-awareness.d.ts.map
@@ -48,8 +48,14 @@ export function _resetBudgetState() {
48
48
  }
49
49
  /**
50
50
  * Spend that a single dispatch's token usage represents, in the budget's unit.
51
- * For a token budget this is just input+output tokens. For a dollar budget it
52
- * is priced via getMemberModelPricing() for the resolved tier; an unpriceable
51
+ * A token budget counts input + output only -- the meaning it had before
52
+ * cache tokens were parsed. Cache reads re-count the whole cached prefix on
53
+ * every turn (one real session: 58,653 input+output tokens vs 17,966,362 with
54
+ * cache), so adding them would make an existing token budget bind hundreds of
55
+ * times sooner for an upgrading user. Cache cost is carried by dollar budgets.
56
+ * For a dollar budget the provider's own reported cost (usage.cost_usd) is
57
+ * used as-is when present; otherwise each count is priced at its own rate via
58
+ * getMemberModelPricing() for the resolved tier; an unpriceable
53
59
  * tier (unknown model, subscription-plan member with no meter) contributes 0
54
60
  * rather than a fabricated cost -- the same "never invent a price" discipline
55
61
  * model-pricing.ts already follows.
@@ -57,12 +63,18 @@ export function _resetBudgetState() {
57
63
  export function estimateDispatchCost(agent, provider, tier, usage, unit) {
58
64
  if (unit === 'tokens')
59
65
  return usage.input_tokens + usage.output_tokens;
66
+ if (typeof usage.cost_usd === 'number' && Number.isFinite(usage.cost_usd))
67
+ return usage.cost_usd;
68
+ const cacheRead = usage.cache_read_input_tokens ?? 0;
69
+ const cacheWrite = usage.cache_creation_input_tokens ?? 0;
60
70
  const pricing = getMemberModelPricing(agent, provider);
61
71
  const price = pricing[tier ?? 'standard'];
62
72
  if (!price)
63
73
  return 0;
64
74
  return (usage.input_tokens / 1_000_000) * price.promptPrice
65
- + (usage.output_tokens / 1_000_000) * price.completionPrice;
75
+ + (usage.output_tokens / 1_000_000) * price.completionPrice
76
+ + (cacheRead / 1_000_000) * price.cacheReadPrice
77
+ + (cacheWrite / 1_000_000) * price.cacheWritePrice;
66
78
  }
67
79
  /**
68
80
  * Current budget state for a scope, or undefined when the scope has no
@@ -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) {
@@ -90,6 +90,8 @@ async function reProvisionAuth(agent) {
90
90
  }
91
91
  }
92
92
  }
93
+ /** In-flight ensureCloudReady per member id; cleared when it settles. */
94
+ const cloudReadyInFlight = new Map();
93
95
  /**
94
96
  * Ensures a cloud member's instance is running and SSH-ready before a tool
95
97
  * call proceeds. Returns the (possibly updated) agent from the registry.
@@ -101,9 +103,24 @@ async function reProvisionAuth(agent) {
101
103
  * Pending: wait for running, then update IP, poll SSH, re-provision auth.
102
104
  * Terminated/shutting-down: throw — instance cannot be used.
103
105
  */
104
- export async function ensureCloudReady(agent) {
106
+ export function ensureCloudReady(agent) {
105
107
  if (!agent.cloud)
106
- 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) {
107
124
  const config = agent.cloud;
108
125
  const state = await awsProvider.getInstanceState(config);
109
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}'`,
@@ -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