@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  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 +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  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 +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. 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);
@@ -1,3 +1,19 @@
1
+ /** True when a process with this pid exists (EPERM = exists, not ours). */
2
+ export declare function isPidAlive(pid: number): boolean;
3
+ /**
4
+ * True when the persisted status for `agentId` is busy but the server process
5
+ * that wrote it is known to be dead -- a busy no live process can ever clear.
6
+ * A busy with no recorded owner (written before owners were tracked) is not
7
+ * judged here; startup reconciliation handles it.
8
+ */
9
+ export declare function isOrphanedBusy(agentId: string): boolean;
10
+ /**
11
+ * Startup reconciliation: a fresh server holds no in-flight work, so any
12
+ * persisted busy whose owner is missing, dead, or this very pid (reuse) was
13
+ * left by a server that died mid-task. Reset those to idle. Busy entries
14
+ * owned by another live server process are kept. Returns the reset ids.
15
+ */
16
+ export declare function reconcileStaleBusy(): string[];
1
17
  /** Return the last-known status for an agent (defaults to 'idle'). */
2
18
  export declare function readMemberStatus(agentId: string): string;
3
19
  /**
@@ -5,6 +21,11 @@ export declare function readMemberStatus(agentId: string): string;
5
21
  * - Overrides are merged into the persisted state (not a full reset).
6
22
  * - Agents not in overrides keep their last-known state.
7
23
  * - New agents default to 'idle'.
24
+ *
25
+ * Called with NO overrides it only RE-RENDERS (registry changes: names, icons,
26
+ * added/removed members). It never clears a member's busy -- to end a busy
27
+ * period pass an explicit status, or use markBusy() (member-busy.ts), whose
28
+ * release always writes one.
8
29
  */
9
30
  export declare function writeStatusline(overrides?: Map<string, string>): void;
10
31
  //# sourceMappingURL=statusline.d.ts.map
@@ -6,6 +6,11 @@ import { DEFAULT_ICON } from './icons.js';
6
6
  import { groupByCategory } from '../utils/agent-helpers.js';
7
7
  const STATUSLINE_PATH = path.join(FLEET_DIR, 'statusline.txt');
8
8
  const STATE_PATH = path.join(FLEET_DIR, 'statusline-state.json');
9
+ // Sidecar: agentId -> pid of the server process that last wrote a busy status
10
+ // for it. Lets a reader tell a live busy from one persisted by a server that
11
+ // has since died (crash/restart mid-task). Kept separate so the state file's
12
+ // Record<string, string> shape is unchanged for its readers.
13
+ const OWNERS_PATH = path.join(FLEET_DIR, 'statusline-owners.json');
9
14
  // Status display emoji — keyed on base status (without parenthetical suffix)
10
15
  const STATUS_EMOJI = {
11
16
  busy: '⚡', idle: '💤', offline: '❌', unknown: '❓',
@@ -31,6 +36,69 @@ function loadState() {
31
36
  function saveState(state) {
32
37
  fs.writeFileSync(STATE_PATH, JSON.stringify(state), { mode: 0o600 });
33
38
  }
39
+ function loadOwners() {
40
+ try {
41
+ if (fs.existsSync(OWNERS_PATH)) {
42
+ return JSON.parse(fs.readFileSync(OWNERS_PATH, 'utf-8'));
43
+ }
44
+ }
45
+ catch { /* corrupted file, start fresh */ }
46
+ return {};
47
+ }
48
+ function saveOwners(owners) {
49
+ fs.writeFileSync(OWNERS_PATH, JSON.stringify(owners), { mode: 0o600 });
50
+ }
51
+ function isBusyStatus(status) {
52
+ return status !== undefined && baseStatus(status) === 'busy';
53
+ }
54
+ /** True when a process with this pid exists (EPERM = exists, not ours). */
55
+ export function isPidAlive(pid) {
56
+ if (!Number.isInteger(pid) || pid <= 0)
57
+ return false;
58
+ try {
59
+ process.kill(pid, 0);
60
+ return true;
61
+ }
62
+ catch (err) {
63
+ return err?.code === 'EPERM';
64
+ }
65
+ }
66
+ /**
67
+ * True when the persisted status for `agentId` is busy but the server process
68
+ * that wrote it is known to be dead -- a busy no live process can ever clear.
69
+ * A busy with no recorded owner (written before owners were tracked) is not
70
+ * judged here; startup reconciliation handles it.
71
+ */
72
+ export function isOrphanedBusy(agentId) {
73
+ if (!isBusyStatus(loadState()[agentId]))
74
+ return false;
75
+ const owner = loadOwners()[agentId];
76
+ return owner !== undefined && !isPidAlive(owner);
77
+ }
78
+ /**
79
+ * Startup reconciliation: a fresh server holds no in-flight work, so any
80
+ * persisted busy whose owner is missing, dead, or this very pid (reuse) was
81
+ * left by a server that died mid-task. Reset those to idle. Busy entries
82
+ * owned by another live server process are kept. Returns the reset ids.
83
+ */
84
+ export function reconcileStaleBusy() {
85
+ try {
86
+ const state = loadState();
87
+ const owners = loadOwners();
88
+ const stale = Object.keys(state).filter(id => {
89
+ if (!isBusyStatus(state[id]))
90
+ return false;
91
+ const owner = owners[id];
92
+ return owner === undefined || owner === process.pid || !isPidAlive(owner);
93
+ });
94
+ if (stale.length > 0)
95
+ writeStatusline(new Map(stale.map(id => [id, 'idle'])));
96
+ return stale;
97
+ }
98
+ catch {
99
+ return [];
100
+ }
101
+ }
34
102
  /** Return the last-known status for an agent (defaults to 'idle'). */
35
103
  export function readMemberStatus(agentId) {
36
104
  return loadState()[agentId] ?? 'idle';
@@ -40,6 +108,11 @@ export function readMemberStatus(agentId) {
40
108
  * - Overrides are merged into the persisted state (not a full reset).
41
109
  * - Agents not in overrides keep their last-known state.
42
110
  * - New agents default to 'idle'.
111
+ *
112
+ * Called with NO overrides it only RE-RENDERS (registry changes: names, icons,
113
+ * added/removed members). It never clears a member's busy -- to end a busy
114
+ * period pass an explicit status, or use markBusy() (member-busy.ts), whose
115
+ * release always writes one.
43
116
  */
44
117
  export function writeStatusline(overrides) {
45
118
  try {
@@ -53,13 +126,28 @@ export function writeStatusline(overrides) {
53
126
  if (fs.existsSync(STATE_PATH)) {
54
127
  fs.writeFileSync(STATE_PATH, '{}', { mode: 0o600 });
55
128
  }
129
+ if (fs.existsSync(OWNERS_PATH))
130
+ saveOwners({});
56
131
  return;
57
132
  }
58
133
  const saved = loadState();
59
- // Merge overrides into saved state
134
+ const owners = loadOwners();
135
+ let ownersChanged = false;
136
+ // Merge overrides into saved state; a busy write records this process as
137
+ // its owner, any other status drops the owner.
60
138
  if (overrides) {
61
139
  for (const [id, status] of overrides) {
62
140
  saved[id] = status;
141
+ if (isBusyStatus(status)) {
142
+ if (owners[id] !== process.pid) {
143
+ owners[id] = process.pid;
144
+ ownersChanged = true;
145
+ }
146
+ }
147
+ else if (id in owners) {
148
+ delete owners[id];
149
+ ownersChanged = true;
150
+ }
63
151
  }
64
152
  }
65
153
  // Prune agents no longer in registry
@@ -68,6 +156,12 @@ export function writeStatusline(overrides) {
68
156
  if (!agentIds.has(id))
69
157
  delete saved[id];
70
158
  }
159
+ for (const id of Object.keys(owners)) {
160
+ if (!agentIds.has(id)) {
161
+ delete owners[id];
162
+ ownersChanged = true;
163
+ }
164
+ }
71
165
  const states = agents.map(a => ({
72
166
  icon: a.icon ?? DEFAULT_ICON,
73
167
  name: a.friendlyName,
@@ -89,6 +183,8 @@ export function writeStatusline(overrides) {
89
183
  }
90
184
  const line = categoryParts.join(' | ');
91
185
  saveState(saved);
186
+ if (ownersChanged)
187
+ saveOwners(owners);
92
188
  fs.writeFileSync(STATUSLINE_PATH, line + '\n', { mode: 0o600 });
93
189
  }
94
190
  catch { /* best-effort, never break tool execution */ }