@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
@@ -4,14 +4,21 @@ import { getAgent } from '../registry.js';
4
4
  import { getStrategy } from '../strategy.js';
5
5
  import { getAgentOS, getAgentShell, isPosixShell } from '../../utils/agent-helpers.js';
6
6
  import { logLine, logWarn } from '../../utils/log-helpers.js';
7
+ import { wrapStallPowerShell, psQuote } from './read-log-tail.js';
7
8
  const RETRY_INTERVAL_MS = 10_000;
8
9
  const MAX_ATTEMPTS = 4; // initial + 3 retries = 30s total
9
10
  const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
10
11
  function toFindNewermt(t0) {
11
12
  return new Date(t0).toISOString().slice(0, 19).replace('T', ' ');
12
13
  }
13
- function toPsDateTime(t0) {
14
- return new Date(t0).toISOString().slice(0, 19);
14
+ /**
15
+ * apra-fleet-uob4: a PowerShell expression for the UTC instant t0, compared
16
+ * against LastWriteTimeUtc. The old Z-less ISO string was parsed as LOCAL
17
+ * time and compared with local LastWriteTime, skewing the cutoff by the
18
+ * host's UTC offset.
19
+ */
20
+ function toPsUtcDateTime(t0) {
21
+ return `[DateTimeOffset]::Parse('${new Date(t0).toISOString().slice(0, 19)}Z', [Globalization.CultureInfo]::InvariantCulture).UtcDateTime`;
15
22
  }
16
23
  // --- Local helpers ---
17
24
  function findLocalMtimeCandidates(dir, t0) {
@@ -87,7 +94,7 @@ async function findRemoteMtimeCandidates(agent, dir, t0) {
87
94
  const shell = getAgentShell(agent);
88
95
  const cmd = isPosixShell(os, shell)
89
96
  ? `find "${dir}" -maxdepth 1 -name "*.jsonl" -newermt "${toFindNewermt(t0)}" 2>/dev/null`
90
- : `powershell -c "Get-ChildItem -Path '${dir}' -Filter '*.jsonl' -ErrorAction SilentlyContinue | Where-Object { $_.LastWriteTime -gt [DateTime]::Parse('${toPsDateTime(t0)}') } | ForEach-Object { $_.FullName }"`;
97
+ : wrapStallPowerShell(`Get-ChildItem -Path '${psQuote(dir)}' -Filter '*.jsonl' -ErrorAction SilentlyContinue | Where-Object { $_.LastWriteTimeUtc -gt ${toPsUtcDateTime(t0)} } | ForEach-Object { $_.FullName }`);
91
98
  const lines = await execLines(agent, cmd, 10_000);
92
99
  return lines.filter(l => l.endsWith('.jsonl'));
93
100
  }
@@ -96,7 +103,7 @@ async function checkRemoteInvToken(agent, candidates, inv) {
96
103
  const shell = getAgentShell(agent);
97
104
  const cmd = isPosixShell(os, shell)
98
105
  ? `grep -l "\\[${inv}\\]" ${candidates.map(c => `"${c}"`).join(' ')} 2>/dev/null`
99
- : `powershell -c "Select-String -Pattern '\\[${inv}\\]' -Path @(${candidates.map(c => `'${c}'`).join(',')}) -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Path -Unique"`;
106
+ : wrapStallPowerShell(`Select-String -Pattern '\\[${psQuote(inv)}\\]' -Path @(${candidates.map(c => `'${psQuote(c)}'`).join(',')}) -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Path -Unique`);
100
107
  const lines = await execLines(agent, cmd, 5_000);
101
108
  return lines.length > 0 ? lines[0] : null;
102
109
  }
@@ -122,7 +129,7 @@ async function tryFindRemote(memberId, agent, t0, inv, logDir, sessionId, provid
122
129
  const directPath = `${logDir}${sep}${sessionId}.jsonl`;
123
130
  const cmd = posix
124
131
  ? `find "${directPath}" -newermt "${toFindNewermt(t0)}" 2>/dev/null`
125
- : `powershell -c "Get-Item -Path '${directPath}' -ErrorAction SilentlyContinue | Where-Object { $_.LastWriteTime -gt [DateTime]::Parse('${toPsDateTime(t0)}') } | ForEach-Object { $_.FullName }"`;
132
+ : wrapStallPowerShell(`Get-Item -Path '${psQuote(directPath)}' -ErrorAction SilentlyContinue | Where-Object { $_.LastWriteTimeUtc -gt ${toPsUtcDateTime(t0)} } | ForEach-Object { $_.FullName }`);
126
133
  const lines = await execLines(agent, cmd, 5_000);
127
134
  return lines.length > 0 ? lines[0] : null;
128
135
  }
@@ -1,4 +1,4 @@
1
- export { getStallDetector, StallDetector, type StallEntry } from './stall-detector.js';
1
+ export { getStallDetector, StallDetector, type StallEntry, type StallReason } from './stall-detector.js';
2
2
  export { resolveSessionLogPath, resolveSessionLogDir } from './log-path-resolver.js';
3
3
  export { readLogTail, type ReadLogResult } from './read-log-tail.js';
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1,3 +1,26 @@
1
+ import { escapePowerShellArgInner } from '../../utils/shell-escape.js';
2
+ /**
3
+ * apra-fleet-uob4: every Windows (non-POSIX) stall command goes through
4
+ * -EncodedCommand. A raw `powershell -c "..."` is re-parsed by the member's
5
+ * outer shell: under powershell.exe (local members, PowerShell-default sshd)
6
+ * `$c`/`$_` were expanded to empty before the inner PowerShell ever ran,
7
+ * turning the script into a parse error. Progress output is silenced so an
8
+ * encoded run does not also emit a `#< CLIXML` progress record on stderr.
9
+ */
10
+ export declare function wrapStallPowerShell(psScript: string): string;
11
+ /** Interior of a PowerShell single-quoted literal: `'` doubled to `''`. */
12
+ export declare const psQuote: typeof escapePowerShellArgInner;
13
+ /**
14
+ * True when a failed tail read's stderr means "the log file does not exist
15
+ * yet" (benign). A PowerShell parse / command-not-found error is never that,
16
+ * even if its text happens to mention a missing item -- it is a broken
17
+ * command and must surface as a read failure (apra-fleet-uob4).
18
+ *
19
+ * An -EncodedCommand run reports errors as `#< CLIXML` with the message
20
+ * wrapped mid-phrase ("does not _x000D__x000A_</S><S S="Error">exist"), so
21
+ * the XML/line-break markup is flattened to plain spaces before matching.
22
+ */
23
+ export declare function isLogNotYetCreatedStderr(stderr: string): boolean;
1
24
  export interface ReadLogResult {
2
25
  lastTimestamp: string | null;
3
26
  error?: string;
@@ -2,6 +2,37 @@ import { getAgent } from '../registry.js';
2
2
  import { getStrategy } from '../strategy.js';
3
3
  import { getAgentOS, getAgentShell, isPosixShell } from '../../utils/agent-helpers.js';
4
4
  import { logLine, logWarn } from '../../utils/log-helpers.js';
5
+ import { wrapPowerShellEncoded } from '../../os/windows.js';
6
+ import { escapePowerShellArgInner } from '../../utils/shell-escape.js';
7
+ /**
8
+ * apra-fleet-uob4: every Windows (non-POSIX) stall command goes through
9
+ * -EncodedCommand. A raw `powershell -c "..."` is re-parsed by the member's
10
+ * outer shell: under powershell.exe (local members, PowerShell-default sshd)
11
+ * `$c`/`$_` were expanded to empty before the inner PowerShell ever ran,
12
+ * turning the script into a parse error. Progress output is silenced so an
13
+ * encoded run does not also emit a `#< CLIXML` progress record on stderr.
14
+ */
15
+ export function wrapStallPowerShell(psScript) {
16
+ return wrapPowerShellEncoded(`$ProgressPreference = 'SilentlyContinue'; ${psScript}`);
17
+ }
18
+ /** Interior of a PowerShell single-quoted literal: `'` doubled to `''`. */
19
+ export const psQuote = escapePowerShellArgInner;
20
+ /**
21
+ * True when a failed tail read's stderr means "the log file does not exist
22
+ * yet" (benign). A PowerShell parse / command-not-found error is never that,
23
+ * even if its text happens to mention a missing item -- it is a broken
24
+ * command and must surface as a read failure (apra-fleet-uob4).
25
+ *
26
+ * An -EncodedCommand run reports errors as `#< CLIXML` with the message
27
+ * wrapped mid-phrase ("does not _x000D__x000A_</S><S S="Error">exist"), so
28
+ * the XML/line-break markup is flattened to plain spaces before matching.
29
+ */
30
+ export function isLogNotYetCreatedStderr(stderr) {
31
+ const text = stderr.replace(/_x000D__x000A_/g, ' ').replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ');
32
+ if (/ParserError|CommandNotFoundException|is not recognized as/i.test(text))
33
+ return false;
34
+ return /No such file|cannot access|does not exist|ItemNotFoundException/i.test(text);
35
+ }
5
36
  export async function readLogTail(memberId, logFilePath) {
6
37
  const agent = getAgent(memberId);
7
38
  if (!agent) {
@@ -12,7 +43,7 @@ export async function readLogTail(memberId, logFilePath) {
12
43
  const shell = getAgentShell(agent);
13
44
  const cmd = isPosixShell(os, shell)
14
45
  ? `tail -c 512 "${logFilePath}"`
15
- : `powershell -c "Get-Content -Tail 5 -Path '${logFilePath}'"`;
46
+ : wrapStallPowerShell(`Get-Content -Tail 5 -Path '${psQuote(logFilePath)}'`);
16
47
  try {
17
48
  const strategy = getStrategy(agent);
18
49
  const result = await strategy.execCommand(cmd, 5000);
@@ -41,7 +72,7 @@ export async function readLogTail(memberId, logFilePath) {
41
72
  return { lastTimestamp: null };
42
73
  }
43
74
  // File not yet created — not an error per resilience decision
44
- if (/No such file|cannot access|not recognized|does not exist|ItemNotFoundException/i.test(result.stderr)) {
75
+ if (isLogNotYetCreatedStderr(result.stderr)) {
45
76
  return { lastTimestamp: null };
46
77
  }
47
78
  logWarn('stall_log_read', `readLogTail failed for ${memberId}: code=${result.code} stderr=${result.stderr}`);
@@ -88,8 +88,23 @@ export interface StallEntry {
88
88
  * once a real signal became available again.
89
89
  */
90
90
  noSignalReported?: boolean;
91
- onStall?: () => void;
91
+ /**
92
+ * GitHub #562: true when `logFilePath` was built from an AUTHORITATIVE home
93
+ * directory (local member, or a probed remote home) rather than a guessed
94
+ * one. Only then does "the session log never appeared within the threshold"
95
+ * prove the agent never started; for a guessed path it stays a warning.
96
+ */
97
+ logPathAuthoritative?: boolean;
98
+ /** Set once the session log has been seen to exist (mtime or content). */
99
+ logFileSeen?: boolean;
100
+ /** When the never-started second signal (a projects-root scan) last came
101
+ * back unconfirmed; the next scan waits a full threshold after it. */
102
+ neverStartedCheckedAt?: number;
103
+ /** stall_never_started_unconfirmed is logged once per dispatch. */
104
+ neverStartedUnconfirmedLogged?: boolean;
105
+ onStall?: (reason?: StallReason) => void;
92
106
  }
107
+ export type StallReason = 'stalled' | 'agent_never_started';
93
108
  export declare class StallDetector {
94
109
  readonly stallCheckList: Map<string, StallEntry>;
95
110
  private pollInterval;
@@ -98,6 +113,15 @@ export declare class StallDetector {
98
113
  update(memberId: string, partial: Partial<StallEntry>): void;
99
114
  remove(memberId: string): void;
100
115
  getEntry(memberId: string): StallEntry | undefined;
116
+ /**
117
+ * GitHub #585: a poll awaits a (possibly remote) probe; meanwhile the entry
118
+ * can be removed (dispatch finished) or replaced (a new dispatch, or an
119
+ * update() that swapped the object). Its result then describes something
120
+ * that no longer exists -- applying it warned "Cannot update non-existent
121
+ * entry" or merged stale state (even stallReported) into a NEW dispatch's
122
+ * entry. Callers drop the result when this returns true.
123
+ */
124
+ private isStale;
101
125
  start(): void;
102
126
  stop(): void;
103
127
  _poll(): Promise<void>;
@@ -1,6 +1,6 @@
1
1
  import { updateAgent } from '../registry.js';
2
2
  import { logLine, logWarn, LogScope } from '../../utils/log-helpers.js';
3
- import { pollLogFile, pollDirectoryActivity } from './stall-poller.js';
3
+ import { pollLogFile, pollDirectoryActivity, pollRecentProjectTranscript } from './stall-poller.js';
4
4
  import { toLocalISOString, fmtElapsed } from './time-utils.js';
5
5
  import { writeStatusline } from '../statusline.js';
6
6
  const DEFAULT_POLL_INTERVAL_MS = 30_000;
@@ -143,6 +143,17 @@ export class StallDetector {
143
143
  getEntry(memberId) {
144
144
  return this.stallCheckList.get(memberId);
145
145
  }
146
+ /**
147
+ * GitHub #585: a poll awaits a (possibly remote) probe; meanwhile the entry
148
+ * can be removed (dispatch finished) or replaced (a new dispatch, or an
149
+ * update() that swapped the object). Its result then describes something
150
+ * that no longer exists -- applying it warned "Cannot update non-existent
151
+ * entry" or merged stale state (even stallReported) into a NEW dispatch's
152
+ * entry. Callers drop the result when this returns true.
153
+ */
154
+ isStale(memberId, entry) {
155
+ return this.stallCheckList.get(memberId) !== entry;
156
+ }
146
157
  start() {
147
158
  if (this.pollInterval !== null) {
148
159
  logWarn('stall_detector', 'Already started');
@@ -266,6 +277,8 @@ export class StallDetector {
266
277
  if (entry.logFilePath) {
267
278
  try {
268
279
  const pollResult = await pollLogFile(memberId, entry.logFilePath);
280
+ if (this.isStale(memberId, entry))
281
+ continue;
269
282
  provisionalPendingToolTimeoutMs = pollResult.pendingToolTimeoutMs;
270
283
  if (pollResult.mtimeMs && pollResult.mtimeMs > entry.lastActivityAt) {
271
284
  entry.lastActivityAt = pollResult.mtimeMs;
@@ -283,6 +296,8 @@ export class StallDetector {
283
296
  // this entry out of the baseline-timeout kill below.
284
297
  try {
285
298
  const activity = await pollDirectoryActivity(memberId);
299
+ if (this.isStale(memberId, entry))
300
+ continue;
286
301
  signalAvailable = activity?.signalAvailable !== false;
287
302
  if (activity?.mtimeMs && activity.mtimeMs > entry.lastActivityAt) {
288
303
  entry.lastActivityAt = activity.mtimeMs;
@@ -337,7 +352,7 @@ export class StallDetector {
337
352
  }));
338
353
  writeStatusline(new Map([[memberId, 'unknown']]));
339
354
  this.update(memberId, { stallReported: true });
340
- entry.onStall?.();
355
+ entry.onStall?.('stalled');
341
356
  }
342
357
  else if (!entry.stallReported) {
343
358
  writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - entry.lastActivityAt)})`]]));
@@ -352,7 +367,9 @@ export class StallDetector {
352
367
  logPath: entry.logFilePath,
353
368
  lastActivityAt: entry.lastActivityAt,
354
369
  }));
355
- const { lastTimestamp, mtimeMs, error, pendingToolTimeoutMs } = await pollLogFile(memberId, entry.logFilePath);
370
+ const { lastTimestamp, mtimeMs, error, pendingToolTimeoutMs, contentSeen } = await pollLogFile(memberId, entry.logFilePath);
371
+ if (this.isStale(memberId, entry))
372
+ continue;
356
373
  // apra-fleet: a pending tool_use's own declared timeout, when present,
357
374
  // overrides the generic idle threshold for THIS tick's stall check --
358
375
  // it is a hard, model-declared budget for a call already known to be
@@ -381,6 +398,11 @@ export class StallDetector {
381
398
  // pollLogFile without it, so this is a pure superset of the prior
382
399
  // behavior -- it can only turn a would-be false stall into recognized
383
400
  // activity, never the reverse.
401
+ // A non-empty tail read also proves the file exists, even when the mtime
402
+ // probe failed and no timestamp parsed.
403
+ if (!entry.logFileSeen && ((mtimeMs !== undefined && mtimeMs !== null) || lastTimestamp !== null || contentSeen === true)) {
404
+ this.update(memberId, { logFileSeen: true });
405
+ }
384
406
  const mtimeAdvancedTo = (mtimeMs !== undefined && mtimeMs !== null && mtimeMs > entry.lastActivityAt)
385
407
  ? mtimeMs
386
408
  : null;
@@ -401,6 +423,63 @@ export class StallDetector {
401
423
  continue;
402
424
  }
403
425
  if (mtimeMs === undefined || mtimeMs === null) {
426
+ // GitHub #562: at an AUTHORITATIVE path, a session log that has
427
+ // never appeared for the whole inactivity threshold means the agent
428
+ // never started -- kill with a distinct reason instead of logging
429
+ // stall_no_signal on every tick forever. A guessed path (or a file
430
+ // that existed earlier in this dispatch) keeps the old behavior.
431
+ //
432
+ // The path alone is not proof (the CLI's own project-dir naming,
433
+ // a symlinked cwd or a relocated config dir can put the transcript
434
+ // elsewhere), so a kill also needs a second, independent signal:
435
+ // no *.jsonl under the provider's projects root changed since the
436
+ // dispatch started. If that cannot be established, warn only --
437
+ // once per dispatch -- and rescan the root at most once per
438
+ // threshold rather than on every tick.
439
+ let neverStarted = false;
440
+ if (entry.logPathAuthoritative && !entry.logFileSeen && contentSeen !== true
441
+ && now - entry.lastActivityAt > stallThresholdMs && !entry.stallReported
442
+ && (entry.neverStartedCheckedAt === undefined || now - entry.neverStartedCheckedAt >= stallThresholdMs)) {
443
+ let recent = null;
444
+ try {
445
+ recent = await pollRecentProjectTranscript(memberId, entry.lastActivityAt);
446
+ }
447
+ catch {
448
+ recent = null;
449
+ }
450
+ if (this.isStale(memberId, entry))
451
+ continue;
452
+ neverStarted = recent === false;
453
+ if (!neverStarted) {
454
+ const alreadyLogged = entry.neverStartedUnconfirmedLogged === true;
455
+ this.update(memberId, { neverStartedCheckedAt: now, neverStartedUnconfirmedLogged: true });
456
+ if (!alreadyLogged)
457
+ logLine('stall_never_started_unconfirmed', JSON.stringify({
458
+ memberId,
459
+ memberName: entry.memberName,
460
+ logPath: entry.logFilePath,
461
+ recentTranscriptElsewhere: recent,
462
+ note: recent === true
463
+ ? 'session log absent at its expected path but a transcript changed elsewhere under the projects root -- not killing'
464
+ : 'session log absent but the second signal could not be established -- not killing',
465
+ }));
466
+ }
467
+ }
468
+ if (neverStarted) {
469
+ scope.warn(JSON.stringify({
470
+ event: 'agent_never_started',
471
+ memberId,
472
+ memberName: entry.memberName,
473
+ idleSecs: Math.floor((now - entry.lastActivityAt) / 1000),
474
+ logPath: entry.logFilePath,
475
+ thresholdMs: stallThresholdMs,
476
+ note: 'session log never appeared at its authoritative path within the inactivity threshold',
477
+ }));
478
+ writeStatusline(new Map([[memberId, 'unknown']]));
479
+ this.update(memberId, { stallReported: true });
480
+ entry.onStall?.('agent_never_started');
481
+ continue;
482
+ }
404
483
  // apra-fleet-qe83.2.2: the file genuinely has no OS mtime either --
405
484
  // it has not been created yet (or is otherwise unreadable). This IS
406
485
  // the absence of evidence, not evidence of a stall: do NOT count it
@@ -438,7 +517,7 @@ export class StallDetector {
438
517
  const ts = new Date(lastTimestamp).getTime();
439
518
  const contentAdvancedTo = (!isNaN(ts) && ts > entry.lastActivityAt) ? ts : null;
440
519
  if (contentAdvancedTo !== null || mtimeAdvancedTo !== null) {
441
- // Activity advanced — update and reset counters, then reflect fresh elapsed in statusline
520
+ // Activity advanced -- update and reset counters, then reflect fresh elapsed in statusline
442
521
  const advancedTo = Math.max(contentAdvancedTo ?? 0, mtimeAdvancedTo ?? 0);
443
522
  this.update(memberId, {
444
523
  lastActivityAt: advancedTo,
@@ -453,7 +532,7 @@ export class StallDetector {
453
532
  continue;
454
533
  }
455
534
  }
456
- // No new activity per EITHER signal — increment idle cycle counter and
535
+ // No new activity per EITHER signal -- increment idle cycle counter and
457
536
  // check stall threshold. Requiring both the content scan and the
458
537
  // filesystem's own mtime to agree the transcript is frozen is what
459
538
  // makes this threshold check genuinely mtime-corroborated, not just a
@@ -478,7 +557,7 @@ export class StallDetector {
478
557
  }));
479
558
  writeStatusline(new Map([[memberId, 'unknown']]));
480
559
  this.update(memberId, { stallReported: true });
481
- entry.onStall?.();
560
+ entry.onStall?.('stalled');
482
561
  }
483
562
  else if (!entry.stallReported) {
484
563
  // Show steadily increasing elapsed time so PM can gauge staleness
@@ -30,7 +30,23 @@ export interface PollResult {
30
30
  * only -- see extractPendingToolTimeoutMs.
31
31
  */
32
32
  pendingToolTimeoutMs?: number | null;
33
+ /** True when the tail read returned any content at all -- the file exists,
34
+ * even if no timestamp parsed and the mtime probe failed. */
35
+ contentSeen?: boolean;
33
36
  }
37
+ /**
38
+ * GitHub #562 review: the second, independent signal required before a
39
+ * dispatch is declared agent_never_started. Looks for ANY *.jsonl transcript
40
+ * modified since `sinceMs` under the provider's projects root (the parent of
41
+ * this member's session-log directory) -- if the CLI did start but wrote its
42
+ * transcript under a differently-encoded project dir (CLI-side path rules,
43
+ * a symlinked cwd, a relocated config dir), it shows up here.
44
+ * - true: a recent transcript exists -> the agent started somewhere; do not kill.
45
+ * - false: the projects root exists and holds no recent transcript.
46
+ * - null: unknown (provider without a log dir, unresolved home, missing
47
+ * root, probe failure) -> callers must not kill.
48
+ */
49
+ export declare function pollRecentProjectTranscript(memberId: string, sinceMs: number): Promise<boolean | null>;
34
50
  export interface DirectoryActivity {
35
51
  /** Newest file mtime under the provider's log dir, or null when nothing could
36
52
  * be read (directory absent, empty, or command failed). */
@@ -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