@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
@@ -5,6 +5,50 @@ import { logLine, logWarn } from '../../utils/log-helpers.js';
5
5
  import { getProvider } from '../../providers/index.js';
6
6
  import { getMemberPathContext } from '../member-home.js';
7
7
  import { escapeDoubleQuoted } from '../../os/os-commands.js';
8
+ import { wrapStallPowerShell, psQuote, isLogNotYetCreatedStderr } from './read-log-tail.js';
9
+ /**
10
+ * GitHub #562 review: the second, independent signal required before a
11
+ * dispatch is declared agent_never_started. Looks for ANY *.jsonl transcript
12
+ * modified since `sinceMs` under the provider's projects root (the parent of
13
+ * this member's session-log directory) -- if the CLI did start but wrote its
14
+ * transcript under a differently-encoded project dir (CLI-side path rules,
15
+ * a symlinked cwd, a relocated config dir), it shows up here.
16
+ * - true: a recent transcript exists -> the agent started somewhere; do not kill.
17
+ * - false: the projects root exists and holds no recent transcript.
18
+ * - null: unknown (provider without a log dir, unresolved home, missing
19
+ * root, probe failure) -> callers must not kill.
20
+ */
21
+ export async function pollRecentProjectTranscript(memberId, sinceMs) {
22
+ const agent = getAgent(memberId);
23
+ if (!agent)
24
+ return null;
25
+ const adapter = getProvider(agent.llmProvider ?? 'claude');
26
+ const os = getAgentOS(agent);
27
+ const posix = isPosixShell(os, getAgentShell(agent));
28
+ try {
29
+ const { homeDir, targetOs, source } = await getMemberPathContext(agent);
30
+ if (source !== 'local' && source !== 'probe')
31
+ return null;
32
+ const logDir = adapter.resolveSessionLogDir(agent.workFolder, homeDir, targetOs);
33
+ if (!logDir)
34
+ return null;
35
+ const root = logDir.replace(/[\\/]+$/, '').replace(/[\\/][^\\/]*$/, '');
36
+ if (!root)
37
+ return null;
38
+ const minutes = Math.max(1, Math.ceil((Date.now() - sinceMs) / 60_000) + 1);
39
+ const cmd = posix
40
+ ? `if [ -d "${escapeDoubleQuoted(root)}" ]; then find "${escapeDoubleQuoted(root)}" -maxdepth 2 -name '*.jsonl' -mmin -${minutes} 2>/dev/null | head -n 1; echo FLEET_ROOT_OK; fi`
41
+ : wrapStallPowerShell(`if (Test-Path -LiteralPath '${psQuote(root)}') { Get-ChildItem -LiteralPath '${psQuote(root)}' -Filter *.jsonl -Recurse -Depth 1 -File -ErrorAction SilentlyContinue | Where-Object LastWriteTimeUtc -gt ([DateTime]::UtcNow.AddMinutes(-${minutes})) | Select-Object -First 1 -ExpandProperty FullName; 'FLEET_ROOT_OK' }`);
42
+ const result = await getStrategy(agent).execCommand(cmd, 10_000);
43
+ const lines = result.stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
44
+ if (!lines.includes('FLEET_ROOT_OK'))
45
+ return null;
46
+ return lines.some((l) => l !== 'FLEET_ROOT_OK');
47
+ }
48
+ catch {
49
+ return null;
50
+ }
51
+ }
8
52
  const NO_SIGNAL = { mtimeMs: null, signalAvailable: false };
9
53
  /** Throwaway home dir used only to ask "does this provider build a log dir at
10
54
  * all?" without doing a member-side home-dir probe first. Never used to build
@@ -55,7 +99,7 @@ export async function pollDirectoryActivity(memberId) {
55
99
  // result and thereby license a kill.
56
100
  const authoritative = source === 'local' || source === 'probe';
57
101
  const strategy = getStrategy(agent);
58
- const escapedWinDir = logDir.replace(/'/g, "''");
102
+ const escapedWinDir = psQuote(logDir);
59
103
  const escapedPosixDir = escapeDoubleQuoted(logDir);
60
104
  // apra-fleet: avoid any intermediate `$variable` in this one-liner -- on at
61
105
  // least one Windows member (fleet-win-dev1), the SSH exec path silently
@@ -80,7 +124,7 @@ export async function pollDirectoryActivity(memberId) {
80
124
  // call) means a zero-object pipeline just produces no output, no error.
81
125
  const cmd = posix
82
126
  ? `find "${escapedPosixDir}" -maxdepth 5 -type f -exec stat -c %Y {} + 2>/dev/null | sort -nr | head -n1`
83
- : `powershell -c "if (Test-Path -Path '${escapedWinDir}') { Get-ChildItem -Path '${escapedWinDir}' -Depth 5 -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTimeUtc -Descending | Select-Object -First 1 -ExpandProperty LastWriteTimeUtc | Get-Date -Format o }"`;
127
+ : wrapStallPowerShell(`if (Test-Path -Path '${escapedWinDir}') { Get-ChildItem -Path '${escapedWinDir}' -Depth 5 -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTimeUtc -Descending | Select-Object -First 1 -ExpandProperty LastWriteTimeUtc | Get-Date -Format o }`);
84
128
  try {
85
129
  const result = await strategy.execCommand(cmd, 5000);
86
130
  const trimmed = result.stdout.trim();
@@ -112,7 +156,7 @@ async function fetchMtimeMs(strategy, logFilePath, posix) {
112
156
  const cmd = posix
113
157
  // GNU stat (`-c %Y`) first; BSD/macOS stat (`-f %m`) as a fallback -- both report whole seconds.
114
158
  ? `stat -c %Y "${logFilePath}" 2>/dev/null || stat -f %m "${logFilePath}" 2>/dev/null`
115
- : `powershell -c "[DateTimeOffset]::new((Get-Item -LiteralPath '${logFilePath}' -ErrorAction SilentlyContinue).LastWriteTimeUtc, [TimeSpan]::Zero).ToUnixTimeMilliseconds()"`;
159
+ : wrapStallPowerShell(`[DateTimeOffset]::new((Get-Item -LiteralPath '${psQuote(logFilePath)}' -ErrorAction SilentlyContinue).LastWriteTimeUtc, [TimeSpan]::Zero).ToUnixTimeMilliseconds()`);
116
160
  try {
117
161
  const result = await strategy.execCommand(cmd, 5000);
118
162
  const trimmed = result.stdout.trim();
@@ -169,7 +213,7 @@ export async function pollLogFile(memberId, logFilePath) {
169
213
  // guarantee the module doc comment above already assumes for everyone.
170
214
  const cmd = posix
171
215
  ? `tail -n ${TAIL_LINES} "${logFilePath}" | tail -c ${TAIL_BYTES}`
172
- : `powershell -c "$c = (Get-Content -Tail ${TAIL_LINES} -Path '${logFilePath}') -join [Environment]::NewLine; if ($c.Length -gt ${TAIL_BYTES}) { $c.Substring($c.Length - ${TAIL_BYTES}) } else { $c }"`;
216
+ : wrapStallPowerShell(`$c = (Get-Content -Tail ${TAIL_LINES} -Path '${psQuote(logFilePath)}') -join [Environment]::NewLine; if ($c.Length -gt ${TAIL_BYTES}) { $c.Substring($c.Length - ${TAIL_BYTES}) } else { $c }`);
173
217
  try {
174
218
  const strategy = getStrategy(agent);
175
219
  // apra-fleet-iuc.2: fetch the file's own mtime independently of the
@@ -179,7 +223,7 @@ export async function pollLogFile(memberId, logFilePath) {
179
223
  const mtimeMs = await fetchMtimeMs(strategy, logFilePath, posix);
180
224
  const result = await strategy.execCommand(cmd, 5000);
181
225
  if (result.code !== 0) {
182
- if (/No such file|cannot access|not recognized|does not exist|ItemNotFoundException/i.test(result.stderr)) {
226
+ if (isLogNotYetCreatedStderr(result.stderr)) {
183
227
  return { lastTimestamp: null, mtimeMs };
184
228
  }
185
229
  logWarn('stall_log_read', `pollLogFile failed for ${memberId}: code=${result.code} stderr=${result.stderr}`);
@@ -190,7 +234,7 @@ export async function pollLogFile(memberId, logFilePath) {
190
234
  ? extractAgyTimestamp(memberId, lines, result.stdout)
191
235
  : extractClaudeTimestamp(memberId, lines, result.stdout);
192
236
  const pendingToolTimeoutMs = extractPendingToolTimeoutMs(provider, lines);
193
- return { ...extracted, mtimeMs, pendingToolTimeoutMs };
237
+ return { ...extracted, mtimeMs, pendingToolTimeoutMs, contentSeen: result.stdout.trim().length > 0 };
194
238
  }
195
239
  catch (err) {
196
240
  const msg = err instanceof Error ? err.message : String(err);
@@ -0,0 +1,16 @@
1
+ export declare const STOPPED_BY_USER_FILE = "stopped-by-user.json";
2
+ export declare const STOPPED_MARKER_PATH: string;
3
+ export interface StoppedMarker {
4
+ stoppedAt: string;
5
+ /** The command that stopped it, e.g. "apra-fleet stop". */
6
+ by: string;
7
+ user: string;
8
+ host: string;
9
+ pid: number;
10
+ }
11
+ export declare function writeStoppedMarker(by?: string, file?: string, now?: Date): StoppedMarker;
12
+ export declare function readStoppedMarker(file?: string): StoppedMarker | null;
13
+ export declare function clearStoppedMarker(file?: string): void;
14
+ /** One-line description for status output. */
15
+ export declare function describeStoppedMarker(m: StoppedMarker): string;
16
+ //# sourceMappingURL=stopped-marker.d.ts.map
@@ -0,0 +1,55 @@
1
+ /**
2
+ * "Stopped by user" marker (GitHub #585 recovery). `apra-fleet stop` writes
3
+ * <data dir>/stopped-by-user.json; ONLY `apra-fleet start` and `apra-fleet
4
+ * install` clear it. While it is present a service-manager launch (launchd
5
+ * RunAtLoad, systemd at boot, the Windows HKCU Run fallback or task) exits 0
6
+ * without starting (src/index.ts startHttpServer), and clients
7
+ * (packages/apra-fleet-client auto-start, including a reconnecting
8
+ * long-lived client) do NOT start the server: they fail with an actionable
9
+ * error instead, so a deliberate stop is never silently undone. The client
10
+ * reads the same file name and fields -- keep them in sync with
11
+ * packages/apra-fleet-client/src/client/auto-start.mjs.
12
+ */
13
+ import fs from 'node:fs';
14
+ import os from 'node:os';
15
+ import path from 'node:path';
16
+ import { FLEET_DIR } from '../paths.js';
17
+ export const STOPPED_BY_USER_FILE = 'stopped-by-user.json';
18
+ export const STOPPED_MARKER_PATH = path.join(FLEET_DIR, STOPPED_BY_USER_FILE);
19
+ function currentUser() {
20
+ try {
21
+ return os.userInfo().username;
22
+ }
23
+ catch {
24
+ return process.env.USERNAME || process.env.USER || 'unknown';
25
+ }
26
+ }
27
+ export function writeStoppedMarker(by = 'apra-fleet stop', file = STOPPED_MARKER_PATH, now = new Date()) {
28
+ const marker = { stoppedAt: now.toISOString(), by, user: currentUser(), host: os.hostname(), pid: process.pid };
29
+ try {
30
+ fs.mkdirSync(path.dirname(file), { recursive: true });
31
+ fs.writeFileSync(file, JSON.stringify(marker, null, 2));
32
+ }
33
+ catch { /* best-effort: never fail a stop on the marker */ }
34
+ return marker;
35
+ }
36
+ export function readStoppedMarker(file = STOPPED_MARKER_PATH) {
37
+ try {
38
+ const m = JSON.parse(fs.readFileSync(file, 'utf8'));
39
+ return m && typeof m.stoppedAt === 'string' ? m : null;
40
+ }
41
+ catch {
42
+ return null;
43
+ }
44
+ }
45
+ export function clearStoppedMarker(file = STOPPED_MARKER_PATH) {
46
+ try {
47
+ fs.unlinkSync(file);
48
+ }
49
+ catch { /* absent */ }
50
+ }
51
+ /** One-line description for status output. */
52
+ export function describeStoppedMarker(m) {
53
+ return `stopped by ${m.user} at ${m.stoppedAt} via '${m.by}' -- run 'apra-fleet start'`;
54
+ }
55
+ //# sourceMappingURL=stopped-marker.js.map
@@ -8,12 +8,41 @@ import type { Agent, SSHExecResult, TransferResult } from '../types.js';
8
8
  * Remove-Item with -Force -ErrorAction SilentlyContinue, same
9
9
  * wrapPowerShellEncoded wrapping as the pre-refactor inline version. */
10
10
  export declare function buildWindowsDeleteFilesScript(folder: string, relativePaths: string[]): string;
11
+ /** Upper bound for the synchronous local tree-kill. It runs on the server's
12
+ * event loop, so an unbounded call (a slow/hung PowerShell profile, a stuck
13
+ * taskkill) would freeze every other request (GitHub #562). */
14
+ export declare const KILL_TREE_TIMEOUT_MS = 10000;
15
+ /**
16
+ * Synchronously kill a LOCAL process tree, bounded by KILL_TREE_TIMEOUT_MS.
17
+ *
18
+ * Synchronous on purpose: callers run it BEFORE child.kill() because taskkill
19
+ * needs the wrapper's PID alive to recurse from it (an async exec loses that
20
+ * race and leaves descendants running).
21
+ *
22
+ * On a Windows host taskkill.exe is invoked directly via execFileSync -- no
23
+ * shell at all, so no PowerShell profile load and no cmd.exe/bash parsing of
24
+ * the kill string (that parsing was the apra-fleet-7dir.4 gitbash bug; the
25
+ * shell-free call sidesteps it for every Windows shell flavour). Elsewhere the
26
+ * member's own killPid string runs through the shell cleanExec resolved.
27
+ * Best-effort: errors, including the timeout, are swallowed.
28
+ */
29
+ export declare function killLocalProcessTree(pid: number, posixKillCommand: string, shell?: string): void;
11
30
  export interface AgentStrategy {
12
31
  execCommand(command: string, timeoutMs?: number, maxTotalMs?: number, onPidCaptured?: (pid: number) => void, abortSignal?: AbortSignal): Promise<SSHExecResult>;
13
32
  transferFiles(localPaths: string[], destinationPath?: string, abortSignal?: AbortSignal): Promise<TransferResult>;
14
33
  receiveFiles(remotePaths: string[], localDestination: string, abortSignal?: AbortSignal): Promise<TransferResult>;
15
- /** Delete files relative to the agent's workFolder. Best-effort — errors are silently ignored. */
34
+ /** Delete files relative to the agent's workFolder. Best-effort -- errors are silently ignored. */
16
35
  deleteFiles(relativePaths: string[]): Promise<void>;
36
+ /**
37
+ * Write a secret-bearing file (owner-only) on the member WITHOUT any
38
+ * command line carrying its content -- SFTP for remote members, fs for
39
+ * local ones. `fileName` must not contain any part of the secret. Returns
40
+ * the absolute path in the form the member's shell accepts. Strategies with
41
+ * no such channel (relay) throw.
42
+ */
43
+ writeSecretFile(fileName: string, content: string): Promise<string>;
44
+ /** Best-effort removal of a file written by writeSecretFile. */
45
+ removeSecretFile(filePath: string): Promise<void>;
17
46
  testConnection(): Promise<{
18
47
  ok: boolean;
19
48
  latencyMs: number;
@@ -21,5 +50,8 @@ export interface AgentStrategy {
21
50
  }>;
22
51
  close(): void;
23
52
  }
53
+ /** Per-user 0700 directory for local members' staged secret files. Throws if
54
+ * an existing path is not a private directory owned by this user. */
55
+ export declare function privateSecretDir(base?: string): string;
24
56
  export declare function getStrategy(agent: Agent): AgentStrategy;
25
57
  //# sourceMappingURL=strategy.d.ts.map
@@ -1,4 +1,4 @@
1
- import { spawn, execSync } from 'node:child_process';
1
+ import { spawn, execSync, execFileSync } from 'node:child_process';
2
2
  import fs from 'node:fs';
3
3
  import os from 'node:os';
4
4
  import path from 'node:path';
@@ -8,9 +8,11 @@ import { getOsCommands } from '../os/index.js';
8
8
  import { getAgentOS, getAgentShell, setStoredPid, clearStoredPid } from '../utils/agent-helpers.js';
9
9
  import { escapeDoubleQuoted, escapeWindowsArg } from '../utils/shell-escape.js';
10
10
  import { wrapPowerShellEncoded } from '../os/windows.js';
11
+ import { completesOnProcessExit, exitDrainMs } from './exit-drain.js';
11
12
  const MAX_OUTPUT_BYTES = 10 * 1024 * 1024; // 10 MB
12
13
  import { execCommand as sshExecCommand, testConnection as sshTestConnection, closeConnection as sshCloseConnection } from './ssh.js';
13
14
  import { uploadFiles, downloadFiles } from './file-transfer.js';
15
+ import { writeSecretFileInHome, removeSecretFile as sftpRemoveSecretFile } from './sftp.js';
14
16
  import { RelayStrategy } from './relay-strategy.js';
15
17
  /** Build the wrapped `powershell -EncodedCommand ...` string RemoteStrategy.
16
18
  * deleteFiles sends on a Windows agent -- extracted as a pure, exported
@@ -25,6 +27,39 @@ export function buildWindowsDeleteFilesScript(folder, relativePaths) {
25
27
  const psScript = `Set-Location "${escapeWindowsArg(folder)}"; Remove-Item ${files} -Force -ErrorAction SilentlyContinue`;
26
28
  return wrapPowerShellEncoded(psScript);
27
29
  }
30
+ /** Upper bound for the synchronous local tree-kill. It runs on the server's
31
+ * event loop, so an unbounded call (a slow/hung PowerShell profile, a stuck
32
+ * taskkill) would freeze every other request (GitHub #562). */
33
+ export const KILL_TREE_TIMEOUT_MS = 10_000;
34
+ /**
35
+ * Synchronously kill a LOCAL process tree, bounded by KILL_TREE_TIMEOUT_MS.
36
+ *
37
+ * Synchronous on purpose: callers run it BEFORE child.kill() because taskkill
38
+ * needs the wrapper's PID alive to recurse from it (an async exec loses that
39
+ * race and leaves descendants running).
40
+ *
41
+ * On a Windows host taskkill.exe is invoked directly via execFileSync -- no
42
+ * shell at all, so no PowerShell profile load and no cmd.exe/bash parsing of
43
+ * the kill string (that parsing was the apra-fleet-7dir.4 gitbash bug; the
44
+ * shell-free call sidesteps it for every Windows shell flavour). Elsewhere the
45
+ * member's own killPid string runs through the shell cleanExec resolved.
46
+ * Best-effort: errors, including the timeout, are swallowed.
47
+ */
48
+ export function killLocalProcessTree(pid, posixKillCommand, shell) {
49
+ try {
50
+ if (process.platform === 'win32') {
51
+ execFileSync('taskkill.exe', ['/F', '/T', '/PID', String(pid)], {
52
+ stdio: 'ignore', windowsHide: true, timeout: KILL_TREE_TIMEOUT_MS,
53
+ });
54
+ }
55
+ else {
56
+ execSync(posixKillCommand, {
57
+ stdio: 'ignore', windowsHide: true, timeout: KILL_TREE_TIMEOUT_MS, ...(shell ? { shell } : {}),
58
+ });
59
+ }
60
+ }
61
+ catch { /* best-effort; process may already be dead, or the kill timed out */ }
62
+ }
28
63
  class RemoteStrategy {
29
64
  agent;
30
65
  constructor(agent) {
@@ -70,7 +105,13 @@ class RemoteStrategy {
70
105
  await this.execCommand(`cd "${escapeDoubleQuoted(folder)}" && rm -f ${files}`, 10000);
71
106
  }
72
107
  }
73
- catch { /* ignore — best-effort cleanup */ }
108
+ catch { /* ignore -- best-effort cleanup */ }
109
+ }
110
+ async writeSecretFile(fileName, content) {
111
+ return writeSecretFileInHome(this.agent, fileName, content);
112
+ }
113
+ async removeSecretFile(filePath) {
114
+ await sftpRemoveSecretFile(this.agent, filePath);
74
115
  }
75
116
  async testConnection() {
76
117
  return sshTestConnection(this.agent);
@@ -79,6 +120,26 @@ class RemoteStrategy {
79
120
  sshCloseConnection(this.agent);
80
121
  }
81
122
  }
123
+ /** Per-user 0700 directory for local members' staged secret files. Throws if
124
+ * an existing path is not a private directory owned by this user. */
125
+ export function privateSecretDir(base = os.tmpdir()) {
126
+ const uid = typeof process.getuid === 'function' ? process.getuid() : undefined;
127
+ const dir = path.join(base, `apra-fleet-secrets-${uid ?? os.userInfo().username}`);
128
+ try {
129
+ fs.mkdirSync(dir, { mode: 0o700 });
130
+ }
131
+ catch (err) {
132
+ if (err?.code !== 'EEXIST')
133
+ throw err;
134
+ }
135
+ if (uid !== undefined) {
136
+ const st = fs.lstatSync(dir);
137
+ if (!st.isDirectory() || st.isSymbolicLink() || st.uid !== uid || (st.mode & 0o077) !== 0) {
138
+ throw new Error(`Refusing to stage a secret in ${dir}: not a private (0700) directory owned by this user`);
139
+ }
140
+ }
141
+ return dir;
142
+ }
82
143
  class LocalStrategy {
83
144
  agent;
84
145
  constructor(agent) {
@@ -107,18 +168,10 @@ class LocalStrategy {
107
168
  // gets around to running taskkill, child.kill('SIGKILL') has often
108
169
  // already terminated the wrapper, and taskkill can't traverse from
109
170
  // an already-dead PID, silently leaving descendants running.
110
- try {
111
- // Must run through the same shell cleanExec resolved (e.g. Git
112
- // Bash's bash.exe for a gitbash member) -- execSync with no
113
- // `shell` option falls back to cmd.exe on Windows, which cannot
114
- // parse a gitbash-flavoured kill string like
115
- // `taskkill //F //T //PID <n> >/dev/null 2>&1; true`
116
- // (apra-fleet-7dir.4).
117
- execSync(cmds.killPid(child.pid), shell ? { stdio: 'ignore', shell } : { stdio: 'ignore' });
118
- }
119
- catch { /* best-effort; process may already be dead */ }
171
+ killLocalProcessTree(child.pid, cmds.killPid(child.pid), shell);
120
172
  }
121
173
  let settled = false;
174
+ let exitDrainTimer;
122
175
  function settle(fn) {
123
176
  if (settled)
124
177
  return;
@@ -126,9 +179,11 @@ class LocalStrategy {
126
179
  clearTimeout(inactivityTimer);
127
180
  if (maxTotalTimer)
128
181
  clearTimeout(maxTotalTimer);
182
+ if (exitDrainTimer)
183
+ clearTimeout(exitDrainTimer);
129
184
  fn();
130
185
  }
131
- // Rolling inactivity timer — resets on each stdout/stderr data event
186
+ // Rolling inactivity timer -- resets on each stdout/stderr data event
132
187
  let inactivityTimer;
133
188
  function resetInactivityTimer() {
134
189
  clearTimeout(inactivityTimer);
@@ -140,7 +195,7 @@ class LocalStrategy {
140
195
  inactivityTimer.unref();
141
196
  }
142
197
  resetInactivityTimer();
143
- // Hard ceiling — never reset regardless of activity
198
+ // Hard ceiling -- never reset regardless of activity
144
199
  let maxTotalTimer;
145
200
  if (maxTotalMs !== undefined) {
146
201
  maxTotalTimer = setTimeout(() => {
@@ -159,7 +214,7 @@ class LocalStrategy {
159
214
  let stdoutSpillPath = null;
160
215
  let stderrSpillPath = null;
161
216
  // StringDecoder buffers a trailing incomplete multi-byte UTF-8 sequence
162
- // across chunks instead of substituting U+FFFD for it — a naive
217
+ // across chunks instead of substituting U+FFFD for it -- a naive
163
218
  // per-chunk `.toString()` corrupts any multi-byte character that
164
219
  // happens to straddle a stream chunk boundary (apra-fleet-grq).
165
220
  const stdoutDecoder = new StringDecoder('utf8');
@@ -205,7 +260,7 @@ class LocalStrategy {
205
260
  stderrSpillStream.write(data);
206
261
  }
207
262
  });
208
- child.on('close', (code) => {
263
+ const finalize = (code) => {
209
264
  clearStoredPid(this.agent.id);
210
265
  const stdoutTail = stdoutDecoder.end();
211
266
  const stderrTail = stderrDecoder.end();
@@ -226,13 +281,86 @@ class LocalStrategy {
226
281
  if (stderrSpillStream)
227
282
  stderrSpillStream.end();
228
283
  if (stdoutSpillPath) {
229
- stdout = `[OUTPUT TRUNCATED — full stdout saved to ${stdoutSpillPath}]\n${stdout}`;
284
+ stdout = `[OUTPUT TRUNCATED -- full stdout saved to ${stdoutSpillPath}]\n${stdout}`;
230
285
  }
231
286
  if (stderrSpillPath) {
232
- stderr = `[OUTPUT TRUNCATED — full stderr saved to ${stderrSpillPath}]\n${stderr}`;
287
+ stderr = `[OUTPUT TRUNCATED -- full stderr saved to ${stderrSpillPath}]\n${stderr}`;
233
288
  }
234
289
  settle(() => resolve({ stdout, stderr, code: code ?? 0 }));
235
- });
290
+ };
291
+ child.on('close', (code) => finalize(code));
292
+ // apra-fleet-qe83.1.2 (READ SIDE of the fix; see src/services/exit-drain.ts
293
+ // for the full rationale and the spawn-side half). `close` only fires once
294
+ // EVERY holder of the child's stdio handles is gone -- on Windows a
295
+ // grandchild that inherited them (sandbox server, orphaned find.exe) keeps
296
+ // the pipe open long after the dispatched process itself exited, pinning the
297
+ // dispatch for as long as the grandchild lives. `exit` fires on the process
298
+ // exit itself, so on Windows we take that as completion, allow a short drain
299
+ // window for output still buffered in the pipe, then settle. The grandchild
300
+ // is deliberately NOT killed: the deploy phase's sandbox pair must outlive
301
+ // the dispatch that started it. POSIX keeps the strictly-more-complete
302
+ // `close` signal (the nohup path reaches EOF on its own).
303
+ if (completesOnProcessExit(getAgentOS(this.agent))) {
304
+ child.on('exit', (code) => {
305
+ if (settled || exitDrainTimer)
306
+ return;
307
+ exitDrainTimer = setTimeout(() => {
308
+ if (settled)
309
+ return;
310
+ // Invariant: settle the result before releasing the read ends.
311
+ // finalize() must run first so any output already buffered in the
312
+ // pipe (and captured by the data listeners above) is included in
313
+ // the resolved result; destroying/unref-ing the handles below is
314
+ // pure cleanup and must never race ahead of settling the promise.
315
+ finalize(code);
316
+ // Release OUR ends of the pipes so the still-open handles held by a
317
+ // surviving grandchild do not keep this process's event loop and fds
318
+ // alive. Destroying a read end cannot affect the grandchild.
319
+ try {
320
+ child.stdout?.destroy();
321
+ }
322
+ catch { /* best-effort */ }
323
+ try {
324
+ child.stderr?.destroy();
325
+ }
326
+ catch { /* best-effort */ }
327
+ try {
328
+ child.unref();
329
+ }
330
+ catch { /* best-effort */ }
331
+ }, exitDrainMs());
332
+ // apra-fleet-qe83.6 (VERIFIED: this unref-ed timer can NOT be the
333
+ // last live handle, so unref-ing it cannot strand the promise).
334
+ // An unref-ed timer does not hold the event loop open, so if it were
335
+ // ever the only live handle the process would exit before finalize()
336
+ // ran and this promise would never settle. It never is:
337
+ // - drain actually needed (a grandchild still holds the inherited
338
+ // stdio): child.stdout/child.stderr are open, flowing read
339
+ // handles -- they are exactly why the drain exists -- and each is
340
+ // a ref-ed handle. Measured standalone (not under a test runner,
341
+ // whose own handles would mask this) with stdout redirected to a
342
+ // file so the probe process had NO ref-ed stdio of its own:
343
+ // getActiveResourcesInfo() at arm time = [PipeWrap, PipeWrap,
344
+ // ProcessWrap]; the promise settled at 2638 ms.
345
+ // - drain not needed (nothing inherited the pipes): the pipes have
346
+ // already EOF-ed, so 'close' is queued and finalize() runs
347
+ // without this timer. Measured the same way: arm-time resources =
348
+ // [ProcessWrap] (ref-ed until 'close'), settled at 599 ms, well
349
+ // inside the 2000 ms window -- i.e. via 'close', not the timer.
350
+ // Caller paths enumerated by grepping every execCommand() call site
351
+ // (src/tools/*, src/providers/claude.ts, src/services/* incl.
352
+ // stall/*, orphan-recovery, preflight-check, relay-executor): all run
353
+ // inside the long-lived MCP server, and the one CLI caller
354
+ // (src/cli/watch.ts) holds a ref-ed setInterval for its watch loop --
355
+ // so every caller has additional live handles anyway.
356
+ // Residual risk: this rests on Node keeping child stdio read handles
357
+ // ref-ed while flowing. If a future caller ever spawns with
358
+ // stdio 'ignore'/'inherit' (no child.stdout/child.stderr objects) AND
359
+ // the process exit races 'close', the drain callback could be skipped
360
+ // -- the fix then is to re-ref for the window, not to widen it.
361
+ exitDrainTimer.unref();
362
+ });
363
+ }
236
364
  child.on('error', (err) => {
237
365
  clearStoredPid(this.agent.id);
238
366
  settle(() => reject(err));
@@ -303,6 +431,24 @@ class LocalStrategy {
303
431
  catch { /* ignore */ }
304
432
  }
305
433
  }
434
+ async writeSecretFile(fileName, content) {
435
+ if (!/^[A-Za-z0-9._-]+$/.test(fileName))
436
+ throw new Error(`Unsafe secret file name: ${fileName}`);
437
+ // A private 0700 dir (verified: ours, not a symlink, no group/other bits),
438
+ // so even a misconfigured shared TMPDIR without the sticky bit cannot let
439
+ // another user swap the file between create and source. 'wx' =
440
+ // O_CREAT|O_EXCL on top. Windows: %TEMP% is per-user.
441
+ const p = path.join(privateSecretDir(), fileName);
442
+ fs.writeFileSync(p, content, { encoding: 'utf-8', mode: 0o600, flag: 'wx' });
443
+ // Git Bash on a Windows host wants forward slashes.
444
+ return process.platform === 'win32' && getAgentShell(this.agent) === 'gitbash' ? p.replace(/\\/g, '/') : p;
445
+ }
446
+ async removeSecretFile(filePath) {
447
+ try {
448
+ fs.rmSync(filePath, { force: true });
449
+ }
450
+ catch { /* best-effort */ }
451
+ }
306
452
  async testConnection() {
307
453
  if (!fs.existsSync(this.agent.workFolder)) {
308
454
  return { ok: false, latencyMs: 0, error: `work_folder missing: ${this.agent.workFolder}` };
@@ -1,5 +1,5 @@
1
1
  // Token grammar: {{ optional_ws name optional_ws }}
2
- // name must match [A-Za-z_][A-Za-z0-9_]* (no dots, so {{secure.NAME}} is never a token)
2
+ // name must match [A-Za-z_][A-Za-z0-9_]* (no dots, so {{secret.NAME}} / legacy {{secure.NAME}} are never tokens here)
3
3
  const TOKEN_RE = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
4
4
  // Key grammar enforced on substitutions map keys
5
5
  const KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -78,7 +78,7 @@ function buildKeyRejectionError(callerName, badKeys) {
78
78
  msg += `Reserved or malformed keys (must match [A-Za-z_][A-Za-z0-9_]*):\n`;
79
79
  for (const k of badKeys)
80
80
  msg += ` - ${k}\n`;
81
- msg += `\nSecrets must use {{secure.NAME}} in execute_command -- never substitutions.`;
81
+ msg += `\nSecrets must use {{secret.NAME}} in execute_command -- never substitutions.`;
82
82
  return msg;
83
83
  }
84
84
  function buildUnresolvedError(callerName, missing) {
@@ -0,0 +1,52 @@
1
+ export declare const SUPERVISOR_LINUX_UNIT_NAMES: readonly ["fleet-supervisor.service", "apra-fleet-supervisor.service"];
2
+ export declare const SUPERVISOR_MACOS_LABEL = "com.apra-fleet.supervisor";
3
+ export declare const SUPERVISOR_WINDOWS_TASK_NAME = "ApraFleetSupervisor";
4
+ export declare const SUPERVISOR_WINDOWS_WRAPPER_FILE = "apra-fleet-supervisor-service.bat";
5
+ export type SupervisorPlatform = 'linux' | 'darwin' | 'win32';
6
+ export interface SupervisorRegistration {
7
+ platform: SupervisorPlatform;
8
+ /** Unit / launchd label / scheduled task name. */
9
+ name: string;
10
+ /** The unit file or plist path (absent for a Windows scheduled task). */
11
+ definitionPath?: string;
12
+ /** The command the registration runs, or null when it could not be read. */
13
+ target: string | null;
14
+ /** True only when target references the installed tree (see module doc). */
15
+ installedByFleet: boolean;
16
+ }
17
+ /** Whether a registration target references the INSTALLED apra-fleet tree. */
18
+ export declare function targetIsInstalledTree(target: string | null, platform: SupervisorPlatform): boolean;
19
+ /** ExecStart of a systemd unit, with systemd's exec prefixes stripped. */
20
+ export declare function parseUnitExecStart(unitText: string): string | null;
21
+ /** The ProgramArguments of a launchd plist joined with spaces, or null. */
22
+ export declare function parsePlistProgramArguments(plistText: string): string | null;
23
+ /** The Exec action (Command + Arguments) of a task XML definition, or null. */
24
+ export declare function parseTaskXmlAction(xml: string): string | null;
25
+ /**
26
+ * Every known-name supervisor registration present on this OS. Read-only:
27
+ * file reads, and on Windows one `schtasks /Query /XML` (no mutating command).
28
+ */
29
+ export declare function findSupervisorRegistrations(): SupervisorRegistration[];
30
+ /**
31
+ * Stop, disable and remove one registration. Throws an Error naming every
32
+ * step that failed (after attempting all of them).
33
+ */
34
+ export declare function removeSupervisorRegistration(reg: SupervisorRegistration): void;
35
+ export interface SupervisorCleanupResult {
36
+ /** Registrations removed (or, under dry-run, that would be removed). */
37
+ removed: SupervisorRegistration[];
38
+ /** Known-name registrations left in place because they are not ours. */
39
+ kept: SupervisorRegistration[];
40
+ /** Registrations whose removal failed, with the error text. */
41
+ failed: {
42
+ reg: SupervisorRegistration;
43
+ error: string;
44
+ }[];
45
+ }
46
+ /**
47
+ * Find and remove every installed-tree supervisor registration on this OS,
48
+ * printing one line per registration. Under dryRun prints the same plan and
49
+ * runs no mutating command.
50
+ */
51
+ export declare function cleanupSupervisorService(dryRun: boolean): SupervisorCleanupResult;
52
+ //# sourceMappingURL=supervisor-service-cleanup.d.ts.map