@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -1,22 +1,53 @@
1
1
  /**
2
- * Clamp the per-tick stall threshold into [baselineMs, MAX_STALL_THRESHOLD_MS].
2
+ * Resolve the per-tick effective stall threshold.
3
+ *
4
+ * `baselineMs` is orchestrator-authored (timeout_s / the generic
5
+ * STALL_THRESHOLD_MS default) and is TRUSTED: it must never be capped by
6
+ * MAX_STALL_THRESHOLD_MS, however large it is configured.
3
7
  *
4
8
  * A pending tool_use's own declared `input.timeout` is a useful hint that a
5
- * long-running call is legitimately in flight, but it is model-authored and
9
+ * long-running call is legitimately in flight, but it is model-authored --
10
+ * read straight out of the transcript's own tool_use.input.timeout -- and
6
11
  * must not be trusted as a raw control parameter:
7
12
  *
8
13
  * - FLOOR: a small (or seconds-denominated -- `timeout: 30`) value would
9
- * otherwise push the effective threshold BELOW the generic baseline and
14
+ * otherwise push the effective threshold BELOW the trusted baseline and
10
15
  * make the watchdog fire earlier than it does with no declaration at all.
11
16
  * The floor also neutralizes the seconds-vs-milliseconds unit ambiguity in
12
17
  * `extractPendingToolTimeoutMs`.
13
18
  * - CEILING: an enormous value would otherwise disable detection entirely.
19
+ * The ceiling bounds ONLY the untrusted pending-tool-timeout contribution,
20
+ * never the trusted baseline.
14
21
  *
15
22
  * Non-finite / NaN / negative / null / undefined inputs all degrade to the
16
23
  * baseline, which is the safe answer for an uninterpretable declaration.
17
24
  */
18
25
  export declare function computeEffectiveThresholdMs(baselineMs: number, pendingToolTimeoutMs: number | null | undefined): number;
19
- /** Which clamp (if any) was applied, for observability in the stall_detected log. */
26
+ /**
27
+ * Which clamp (if any) actually determined the effective threshold, for
28
+ * observability in the stall_detected log.
29
+ *
30
+ * Mirrors computeEffectiveThresholdMs's shape --
31
+ * effective = max(base, min(raw, ceiling)) -- so it must report which term of
32
+ * that max() won, not merely compare the final result against the raw
33
+ * (uncapped) pending contribution. Comparing against raw alone is what made
34
+ * the pre-fix version lie: once the trusted baseline can exceed the ceiling,
35
+ * `effective < raw` no longer implies the ceiling determined the result --
36
+ * the baseline can still be the one that won, even though the ceiling
37
+ * capped the untrusted contribution internally along the way.
38
+ *
39
+ * - 'floor': the trusted baseline is >= the (possibly ceiling-capped)
40
+ * pending contribution, so the baseline determined effectiveThresholdMs.
41
+ * This holds even at the knife-edge where the baseline happens to equal
42
+ * the raw (uncapped) pending value -- the ceiling still capped the
43
+ * pending contribution internally; it merely didn't end up mattering.
44
+ * - 'ceiling': the ceiling genuinely capped the pending contribution
45
+ * (min(raw, ceiling) < raw) AND that capped value still exceeds the
46
+ * baseline, so the ceiling determined effectiveThresholdMs.
47
+ * - null: no usable declaration, or the pending contribution passed
48
+ * through unclamped and still exceeded the baseline (effective === raw)
49
+ * -- neither clamp changed the outcome.
50
+ */
20
51
  export declare function describeClamp(baselineMs: number, pendingToolTimeoutMs: number | null | undefined, effectiveThresholdMs: number): 'floor' | 'ceiling' | null;
21
52
  export interface StallEntry {
22
53
  sessionId: string | null;
@@ -27,6 +58,23 @@ export interface StallEntry {
27
58
  memberId: string;
28
59
  memberName: string;
29
60
  provisional: boolean;
61
+ /**
62
+ * apra-fleet-25yl.1: per-dispatch trusted baseline threshold (typically
63
+ * derived from the orchestrator's own timeout_s), overriding the
64
+ * process-wide STALL_THRESHOLD_MS default for this entry only. When unset,
65
+ * falls back to the env/default baseline -- behaviour for callers that set
66
+ * nothing is unchanged.
67
+ */
68
+ thresholdMs?: number;
69
+ /**
70
+ * apra-fleet-25yl.3: wall-clock time (Date.now()) of the last tick on
71
+ * which a LIVE probe (pollLogFile / pollDirectoryActivity) was actually
72
+ * issued for this entry, as opposed to a tick that was gated out by the
73
+ * adaptive cadence check in _poll(). `undefined` means "never probed
74
+ * yet" -- the gate always treats that as due, so a freshly added entry is
75
+ * probed on its very first tick regardless of its threshold.
76
+ */
77
+ lastPolledAt?: number;
30
78
  /** A genuine stall has been detected AND reported/killed -- suppresses
31
79
  * re-reporting and re-killing. Reset when activity resumes. */
32
80
  stallReported: boolean;
@@ -40,15 +88,40 @@ export interface StallEntry {
40
88
  * once a real signal became available again.
41
89
  */
42
90
  noSignalReported?: boolean;
43
- 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;
44
106
  }
107
+ export type StallReason = 'stalled' | 'agent_never_started';
45
108
  export declare class StallDetector {
46
109
  readonly stallCheckList: Map<string, StallEntry>;
47
110
  private pollInterval;
111
+ private malformedStallThresholdEnvWarned;
48
112
  add(memberId: string, entry: StallEntry): void;
49
113
  update(memberId: string, partial: Partial<StallEntry>): void;
50
114
  remove(memberId: string): void;
51
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;
52
125
  start(): void;
53
126
  stop(): void;
54
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;
@@ -27,19 +27,32 @@ const TOOL_TIMEOUT_GRACE_MS = 60_000;
27
27
  // comfortably above the largest real case that motivated the feature
28
28
  // (900_000ms + grace = 960_000ms). Override with STALL_MAX_THRESHOLD_MS.
29
29
  const MAX_STALL_THRESHOLD_MS = 1_800_000;
30
+ // apra-fleet-25yl.3: ceiling for the per-entry ADAPTIVE PROBE cadence (see
31
+ // the gate in _poll()). Without a ceiling, the 9000s production default
32
+ // threshold yields a 30-minute probe gap and a busy status up to 30 minutes
33
+ // stale. This bounds ONLY the live probe interval -- the shared setInterval
34
+ // loop's own cadence is unchanged by this feature.
35
+ const MAX_STALL_PROBE_INTERVAL_MS = 300_000;
30
36
  /**
31
- * Clamp the per-tick stall threshold into [baselineMs, MAX_STALL_THRESHOLD_MS].
37
+ * Resolve the per-tick effective stall threshold.
38
+ *
39
+ * `baselineMs` is orchestrator-authored (timeout_s / the generic
40
+ * STALL_THRESHOLD_MS default) and is TRUSTED: it must never be capped by
41
+ * MAX_STALL_THRESHOLD_MS, however large it is configured.
32
42
  *
33
43
  * A pending tool_use's own declared `input.timeout` is a useful hint that a
34
- * long-running call is legitimately in flight, but it is model-authored and
44
+ * long-running call is legitimately in flight, but it is model-authored --
45
+ * read straight out of the transcript's own tool_use.input.timeout -- and
35
46
  * must not be trusted as a raw control parameter:
36
47
  *
37
48
  * - FLOOR: a small (or seconds-denominated -- `timeout: 30`) value would
38
- * otherwise push the effective threshold BELOW the generic baseline and
49
+ * otherwise push the effective threshold BELOW the trusted baseline and
39
50
  * make the watchdog fire earlier than it does with no declaration at all.
40
51
  * The floor also neutralizes the seconds-vs-milliseconds unit ambiguity in
41
52
  * `extractPendingToolTimeoutMs`.
42
53
  * - CEILING: an enormous value would otherwise disable detection entirely.
54
+ * The ceiling bounds ONLY the untrusted pending-tool-timeout contribution,
55
+ * never the trusted baseline.
43
56
  *
44
57
  * Non-finite / NaN / negative / null / undefined inputs all degrade to the
45
58
  * baseline, which is the safe answer for an uninterpretable declaration.
@@ -48,31 +61,66 @@ export function computeEffectiveThresholdMs(baselineMs, pendingToolTimeoutMs) {
48
61
  const maxMs = parseInt(process.env['STALL_MAX_THRESHOLD_MS'] ?? String(MAX_STALL_THRESHOLD_MS));
49
62
  const ceilingMs = Number.isFinite(maxMs) ? maxMs : MAX_STALL_THRESHOLD_MS;
50
63
  const base = Number.isFinite(baselineMs) ? baselineMs : DEFAULT_STALL_THRESHOLD_MS;
51
- // No usable declaration -> the generic baseline stands untouched. (Note this
52
- // is deliberately NOT `(pendingToolTimeoutMs ?? 0) + GRACE`: that form would
53
- // silently raise the threshold to the grace period alone whenever the
54
- // baseline is configured below it, changing behavior for the very common
55
- // "no declared timeout" case.)
64
+ // No usable declaration -> the trusted baseline stands untouched, uncapped.
65
+ // (Note this is deliberately NOT `(pendingToolTimeoutMs ?? 0) + GRACE`: that
66
+ // form would silently raise the threshold to the grace period alone
67
+ // whenever the baseline is configured below it, changing behavior for the
68
+ // very common "no declared timeout" case.)
56
69
  if (typeof pendingToolTimeoutMs !== 'number' || !Number.isFinite(pendingToolTimeoutMs)) {
57
- return Math.min(base, ceilingMs);
70
+ return base;
58
71
  }
59
- return Math.min(Math.max(base, pendingToolTimeoutMs + TOOL_TIMEOUT_GRACE_MS), ceilingMs);
72
+ // The untrusted pending-tool-timeout contribution is clamped into
73
+ // [0, ceilingMs] BEFORE competing against the trusted baseline, so the
74
+ // ceiling can never suppress a baseline that legitimately sits at or above
75
+ // it.
76
+ return Math.max(base, Math.min(pendingToolTimeoutMs + TOOL_TIMEOUT_GRACE_MS, ceilingMs));
60
77
  }
61
- /** Which clamp (if any) was applied, for observability in the stall_detected log. */
78
+ /**
79
+ * Which clamp (if any) actually determined the effective threshold, for
80
+ * observability in the stall_detected log.
81
+ *
82
+ * Mirrors computeEffectiveThresholdMs's shape --
83
+ * effective = max(base, min(raw, ceiling)) -- so it must report which term of
84
+ * that max() won, not merely compare the final result against the raw
85
+ * (uncapped) pending contribution. Comparing against raw alone is what made
86
+ * the pre-fix version lie: once the trusted baseline can exceed the ceiling,
87
+ * `effective < raw` no longer implies the ceiling determined the result --
88
+ * the baseline can still be the one that won, even though the ceiling
89
+ * capped the untrusted contribution internally along the way.
90
+ *
91
+ * - 'floor': the trusted baseline is >= the (possibly ceiling-capped)
92
+ * pending contribution, so the baseline determined effectiveThresholdMs.
93
+ * This holds even at the knife-edge where the baseline happens to equal
94
+ * the raw (uncapped) pending value -- the ceiling still capped the
95
+ * pending contribution internally; it merely didn't end up mattering.
96
+ * - 'ceiling': the ceiling genuinely capped the pending contribution
97
+ * (min(raw, ceiling) < raw) AND that capped value still exceeds the
98
+ * baseline, so the ceiling determined effectiveThresholdMs.
99
+ * - null: no usable declaration, or the pending contribution passed
100
+ * through unclamped and still exceeded the baseline (effective === raw)
101
+ * -- neither clamp changed the outcome.
102
+ */
62
103
  export function describeClamp(baselineMs, pendingToolTimeoutMs, effectiveThresholdMs) {
63
104
  // No usable declaration -> the baseline was used as-is; nothing was clamped.
64
105
  if (typeof pendingToolTimeoutMs !== 'number' || !Number.isFinite(pendingToolTimeoutMs))
65
106
  return null;
107
+ const maxMs = parseInt(process.env['STALL_MAX_THRESHOLD_MS'] ?? String(MAX_STALL_THRESHOLD_MS));
108
+ const ceilingMs = Number.isFinite(maxMs) ? maxMs : MAX_STALL_THRESHOLD_MS;
109
+ const base = Number.isFinite(baselineMs) ? baselineMs : DEFAULT_STALL_THRESHOLD_MS;
66
110
  const raw = pendingToolTimeoutMs + TOOL_TIMEOUT_GRACE_MS;
67
- if (effectiveThresholdMs < raw)
68
- return 'ceiling';
69
- if (effectiveThresholdMs > raw)
111
+ const cappedPending = Math.min(raw, ceilingMs);
112
+ if (base >= cappedPending)
70
113
  return 'floor';
114
+ if (cappedPending < raw)
115
+ return 'ceiling';
71
116
  return null;
72
117
  }
73
118
  export class StallDetector {
74
119
  stallCheckList = new Map();
75
120
  pollInterval = null;
121
+ // apra-fleet-25yl.6: latches the malformed-STALL_THRESHOLD_MS warning so a
122
+ // sustained typo logs once, not once per tick for the life of the process.
123
+ malformedStallThresholdEnvWarned = false;
76
124
  add(memberId, entry) {
77
125
  if (this.stallCheckList.has(memberId)) {
78
126
  logWarn('stall_detector', `Overwriting existing entry for member ${memberId}`);
@@ -95,6 +143,17 @@ export class StallDetector {
95
143
  getEntry(memberId) {
96
144
  return this.stallCheckList.get(memberId);
97
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
+ }
98
157
  start() {
99
158
  if (this.pollInterval !== null) {
100
159
  logWarn('stall_detector', 'Already started');
@@ -122,8 +181,90 @@ export class StallDetector {
122
181
  members: [...this.stallCheckList.values()].map(e => e.memberName),
123
182
  }));
124
183
  const now = Date.now();
125
- const stallThresholdMs = parseInt(process.env['STALL_THRESHOLD_MS'] ?? String(DEFAULT_STALL_THRESHOLD_MS));
184
+ // apra-fleet-25yl.1: env/default baseline is now only the FALLBACK for
185
+ // entries that carry no per-dispatch thresholdMs of their own -- resolved
186
+ // per entry below, not once per tick.
187
+ //
188
+ // apra-fleet-25yl.6: guarded exactly like tickIntervalMs below -- a
189
+ // non-numeric STALL_THRESHOLD_MS must not silently become NaN. An
190
+ // unguarded NaN here makes every entry without its own thresholdMs
191
+ // resolve a NaN probeIntervalMs, which makes the adaptive-cadence gate's
192
+ // `>= probeIntervalMs` comparison false forever: the entry is probed once
193
+ // (on its first, lastPolledAt===undefined tick) and never again, silently
194
+ // disabling stall detection for it for the life of the process.
195
+ const parsedFallbackThresholdMs = parseInt(process.env['STALL_THRESHOLD_MS'] ?? String(DEFAULT_STALL_THRESHOLD_MS));
196
+ if (!Number.isFinite(parsedFallbackThresholdMs) && !this.malformedStallThresholdEnvWarned) {
197
+ this.malformedStallThresholdEnvWarned = true;
198
+ logWarn('stall_threshold_env_invalid', JSON.stringify({
199
+ value: process.env['STALL_THRESHOLD_MS'],
200
+ note: 'STALL_THRESHOLD_MS is not a valid number; falling back to the default stall threshold for entries with no per-dispatch thresholdMs.',
201
+ }));
202
+ }
203
+ const fallbackThresholdMs = Number.isFinite(parsedFallbackThresholdMs)
204
+ ? parsedFallbackThresholdMs
205
+ : DEFAULT_STALL_THRESHOLD_MS;
206
+ // apra-fleet-25yl.3 AMENDMENT: the adaptive probe cadence's FLOOR is the
207
+ // loop's own tick interval -- the same resolved value start()'s
208
+ // setInterval uses (STALL_POLL_INTERVAL_MS ?? DEFAULT_POLL_INTERVAL_MS) --
209
+ // not an independent constant. A separate, smaller floor would make
210
+ // short-threshold entries poll MORE often than today's fixed cadence,
211
+ // the opposite of this feature's goal. Resolved once per tick, mirroring
212
+ // the other STALL_* env overrides above, so an env override of the tick
213
+ // interval moves the floor with it.
214
+ const parsedTickIntervalMs = parseInt(process.env['STALL_POLL_INTERVAL_MS'] ?? String(DEFAULT_POLL_INTERVAL_MS));
215
+ const tickIntervalMs = Number.isFinite(parsedTickIntervalMs) ? parsedTickIntervalMs : DEFAULT_POLL_INTERVAL_MS;
216
+ // apra-fleet-25yl.3.3: counters for observability: track per-entry probe
217
+ // intervals and whether each entry's probe was issued or skipped by the
218
+ // adaptive cadence gate. These are emitted once per tick at scope.ok().
219
+ let probesIssued = 0;
220
+ let probesSkipped = 0;
221
+ const entryProbeIntervals = [];
126
222
  for (const [memberId, entry] of this.stallCheckList.entries()) {
223
+ const stallThresholdMs = entry.thresholdMs ?? fallbackThresholdMs;
224
+ // apra-fleet-25yl.3: adaptive per-entry probe cadence. An entry with a
225
+ // large effective threshold (e.g. a long timeout_s dispatch) does not
226
+ // need a LIVE probe on every tick; gate the live probe call itself
227
+ // (pollLogFile / pollDirectoryActivity, issued just below in each
228
+ // branch) on clamp(tickIntervalMs, stallThresholdMs/5, 300_000ms):
229
+ // never less often than the loop's own tick (the floor), and never
230
+ // more than 5 minutes apart even for the largest trusted threshold
231
+ // (the ceiling). This gates ONLY the live probe -- the shared
232
+ // setInterval loop and its cadence/unref behaviour are untouched. A
233
+ // skipped tick is simply not evidence in either direction: it must
234
+ // never increment consecutiveIdleCycles/consecutiveReadFailures, and
235
+ // must never itself be read as activity or as a stall. Detection stays
236
+ // bounded to roughly one probe interval past the entry's threshold
237
+ // because the stall check further down only runs on ticks that DO
238
+ // probe -- it is never evaluated against stale data on a skipped tick.
239
+ //
240
+ // apra-fleet-25yl.4: the floor (tickIntervalMs) MUST win over the
241
+ // ceiling (MAX_STALL_PROBE_INTERVAL_MS) -- the invariant that the probe
242
+ // interval never falls below the loop's own tick interval is
243
+ // non-negotiable, since a value below it would make the gate fire on
244
+ // every tick, defeating the point of the cadence. Clamping
245
+ // stallThresholdMs/5 to the ceiling FIRST, then flooring the result at
246
+ // tickIntervalMs, gives exactly that precedence: when
247
+ // STALL_POLL_INTERVAL_MS is overridden above the 300_000ms ceiling, the
248
+ // tick interval still wins. (The old min(ceiling, max(tick, s/5)) order
249
+ // let the ceiling win instead, yielding a probe interval BELOW the tick
250
+ // interval whenever the tick interval itself exceeded the ceiling.)
251
+ // Behaviourally identical to the old formula whenever tickIntervalMs
252
+ // <= MAX_STALL_PROBE_INTERVAL_MS (the normal case).
253
+ const probeIntervalMs = Math.max(tickIntervalMs, Math.min(MAX_STALL_PROBE_INTERVAL_MS, stallThresholdMs / 5));
254
+ // apra-fleet-25yl.3.3: track probe intervals for observability.
255
+ entryProbeIntervals.push({ memberName: entry.memberName, probeIntervalMs });
256
+ const dueForProbe = entry.lastPolledAt === undefined || (now - entry.lastPolledAt) >= probeIntervalMs;
257
+ if (!dueForProbe) {
258
+ // apra-fleet-25yl.3.3: count this probe as skipped by the adaptive gate.
259
+ probesSkipped++;
260
+ if (!entry.stallReported) {
261
+ writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - entry.lastActivityAt)})`]]));
262
+ }
263
+ continue;
264
+ }
265
+ // apra-fleet-25yl.3.3: count this probe as issued.
266
+ probesIssued++;
267
+ entry.lastPolledAt = now;
127
268
  if (entry.provisional) {
128
269
  // Provisional: if logFilePath is available, check mtime; if logFilePath is null, poll directory activity
129
270
  let signalAvailable = true;
@@ -136,6 +277,8 @@ export class StallDetector {
136
277
  if (entry.logFilePath) {
137
278
  try {
138
279
  const pollResult = await pollLogFile(memberId, entry.logFilePath);
280
+ if (this.isStale(memberId, entry))
281
+ continue;
139
282
  provisionalPendingToolTimeoutMs = pollResult.pendingToolTimeoutMs;
140
283
  if (pollResult.mtimeMs && pollResult.mtimeMs > entry.lastActivityAt) {
141
284
  entry.lastActivityAt = pollResult.mtimeMs;
@@ -153,6 +296,8 @@ export class StallDetector {
153
296
  // this entry out of the baseline-timeout kill below.
154
297
  try {
155
298
  const activity = await pollDirectoryActivity(memberId);
299
+ if (this.isStale(memberId, entry))
300
+ continue;
156
301
  signalAvailable = activity?.signalAvailable !== false;
157
302
  if (activity?.mtimeMs && activity.mtimeMs > entry.lastActivityAt) {
158
303
  entry.lastActivityAt = activity.mtimeMs;
@@ -189,7 +334,8 @@ export class StallDetector {
189
334
  // the non-provisional path: a pending tool_use's own declared
190
335
  // timeout, when present, replaces the generic baseline threshold for
191
336
  // this tick's stall check.
192
- // Clamped into [baseline, ceiling] -- see computeEffectiveThresholdMs.
337
+ // Uncapped trusted floor, untrusted contribution capped into
338
+ // [0, ceiling] -- see computeEffectiveThresholdMs.
193
339
  const provisionalEffectiveThresholdMs = computeEffectiveThresholdMs(stallThresholdMs, provisionalPendingToolTimeoutMs);
194
340
  if (now - entry.lastActivityAt > provisionalEffectiveThresholdMs && !entry.stallReported) {
195
341
  const idleSecs = Math.floor((now - entry.lastActivityAt) / 1000);
@@ -206,7 +352,7 @@ export class StallDetector {
206
352
  }));
207
353
  writeStatusline(new Map([[memberId, 'unknown']]));
208
354
  this.update(memberId, { stallReported: true });
209
- entry.onStall?.();
355
+ entry.onStall?.('stalled');
210
356
  }
211
357
  else if (!entry.stallReported) {
212
358
  writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - entry.lastActivityAt)})`]]));
@@ -221,17 +367,24 @@ export class StallDetector {
221
367
  logPath: entry.logFilePath,
222
368
  lastActivityAt: entry.lastActivityAt,
223
369
  }));
224
- 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;
225
373
  // apra-fleet: a pending tool_use's own declared timeout, when present,
226
374
  // overrides the generic idle threshold for THIS tick's stall check --
227
375
  // it is a hard, model-declared budget for a call already known to be
228
376
  // long-running (900000ms in one confirmed stall, 600000ms in another),
229
377
  // and the fleet watchdog must not fire before that budget elapses.
230
- // Clamped into [baseline, ceiling] -- see computeEffectiveThresholdMs.
378
+ // Uncapped trusted floor, untrusted contribution capped into
379
+ // [0, ceiling] -- see computeEffectiveThresholdMs.
231
380
  const effectiveThresholdMs = computeEffectiveThresholdMs(stallThresholdMs, pendingToolTimeoutMs);
232
381
  if (error) {
233
382
  const newFailures = entry.consecutiveReadFailures + 1;
234
383
  this.update(memberId, { consecutiveReadFailures: newFailures });
384
+ // apra-fleet-qe83.2.2: log every error-return path, not only once the
385
+ // 3-consecutive-failures warning threshold is crossed, so a single
386
+ // occurrence is still diagnosable from fleet.log alone.
387
+ logLine('stall_log_read', JSON.stringify({ memberId, memberName: entry.memberName, error, consecutiveReadFailures: newFailures }));
235
388
  if (newFailures >= 3) {
236
389
  logWarn('stall_read_failures', JSON.stringify({ memberId, error, consecutiveReadFailures: newFailures }));
237
390
  }
@@ -245,6 +398,11 @@ export class StallDetector {
245
398
  // pollLogFile without it, so this is a pure superset of the prior
246
399
  // behavior -- it can only turn a would-be false stall into recognized
247
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
+ }
248
406
  const mtimeAdvancedTo = (mtimeMs !== undefined && mtimeMs !== null && mtimeMs > entry.lastActivityAt)
249
407
  ? mtimeMs
250
408
  : null;
@@ -262,28 +420,119 @@ export class StallDetector {
262
420
  stallReported: false,
263
421
  });
264
422
  writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - mtimeAdvancedTo)})`]]));
423
+ continue;
265
424
  }
266
- // Otherwise: file not yet created / no signal at all — do NOT count as stall cycle
267
- continue;
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
+ }
483
+ // apra-fleet-qe83.2.2: the file genuinely has no OS mtime either --
484
+ // it has not been created yet (or is otherwise unreadable). This IS
485
+ // the absence of evidence, not evidence of a stall: do NOT count it
486
+ // as a stall cycle, but log it so a sustained "never created" case
487
+ // is still diagnosable from fleet.log alone.
488
+ logLine('stall_no_signal', JSON.stringify({
489
+ memberId,
490
+ memberName: entry.memberName,
491
+ note: 'no content timestamp and no file mtime available yet -- treating as absence of evidence, not a stall',
492
+ }));
493
+ continue;
494
+ }
495
+ // apra-fleet-qe83.2.2: the recorded missed-stall shape. The file DOES
496
+ // exist (mtimeMs is known) and has NOT advanced past lastActivityAt,
497
+ // but content parsing found no usable timestamp at all -- e.g. the
498
+ // byte-capped tail read truncated the last dated entry and every
499
+ // trailing entry (an attachment, a last-prompt record) carries no
500
+ // timestamp field of its own. Before this fix that fell through the
501
+ // silent `continue` above with no log line and no threshold check
502
+ // ever running, hiding a genuine 57-minute stall. The file's own
503
+ // mtime is exactly the kind of corroborating signal
504
+ // apra-fleet-iuc.2 already trusts elsewhere in this function, so
505
+ // fall through to the same idle-cycle/threshold evaluation used for
506
+ // a stale CONTENT timestamp below, anchored on the entry's existing
507
+ // lastActivityAt (last dated entry decides staleness).
508
+ logLine('stall_tail_truncated', JSON.stringify({
509
+ memberId,
510
+ memberName: entry.memberName,
511
+ mtimeMs,
512
+ lastActivityAt: entry.lastActivityAt,
513
+ note: 'tail read found no parseable timestamp but file mtime has not advanced; evaluating staleness against last known activity',
514
+ }));
268
515
  }
269
- const ts = new Date(lastTimestamp).getTime();
270
- const contentAdvancedTo = (!isNaN(ts) && ts > entry.lastActivityAt) ? ts : null;
271
- if (contentAdvancedTo !== null || mtimeAdvancedTo !== null) {
272
- // Activity advanced — update and reset counters, then reflect fresh elapsed in statusline
273
- const advancedTo = Math.max(contentAdvancedTo ?? 0, mtimeAdvancedTo ?? 0);
274
- this.update(memberId, {
275
- lastActivityAt: advancedTo,
276
- consecutiveIdleCycles: 0,
277
- consecutiveReadFailures: 0,
278
- stallReported: false,
279
- });
280
- if (contentAdvancedTo !== null) {
281
- updateAgent(memberId, { lastLlmActivityAt: lastTimestamp });
516
+ else {
517
+ const ts = new Date(lastTimestamp).getTime();
518
+ const contentAdvancedTo = (!isNaN(ts) && ts > entry.lastActivityAt) ? ts : null;
519
+ if (contentAdvancedTo !== null || mtimeAdvancedTo !== null) {
520
+ // Activity advanced -- update and reset counters, then reflect fresh elapsed in statusline
521
+ const advancedTo = Math.max(contentAdvancedTo ?? 0, mtimeAdvancedTo ?? 0);
522
+ this.update(memberId, {
523
+ lastActivityAt: advancedTo,
524
+ consecutiveIdleCycles: 0,
525
+ consecutiveReadFailures: 0,
526
+ stallReported: false,
527
+ });
528
+ if (contentAdvancedTo !== null) {
529
+ updateAgent(memberId, { lastLlmActivityAt: lastTimestamp });
530
+ }
531
+ writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - advancedTo)})`]]));
532
+ continue;
282
533
  }
283
- writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - advancedTo)})`]]));
284
- continue;
285
534
  }
286
- // No new activity per EITHER signal — increment idle cycle counter and
535
+ // No new activity per EITHER signal -- increment idle cycle counter and
287
536
  // check stall threshold. Requiring both the content scan and the
288
537
  // filesystem's own mtime to agree the transcript is frozen is what
289
538
  // makes this threshold check genuinely mtime-corroborated, not just a
@@ -308,13 +557,21 @@ export class StallDetector {
308
557
  }));
309
558
  writeStatusline(new Map([[memberId, 'unknown']]));
310
559
  this.update(memberId, { stallReported: true });
311
- entry.onStall?.();
560
+ entry.onStall?.('stalled');
312
561
  }
313
562
  else if (!entry.stallReported) {
314
563
  // Show steadily increasing elapsed time so PM can gauge staleness
315
564
  writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - entry.lastActivityAt)})`]]));
316
565
  }
317
566
  }
567
+ // apra-fleet-25yl.3.3: emit tick-level summary with probe counts and
568
+ // per-entry probe intervals. This single-line close at scope.ok() keeps
569
+ // log volume constant (one line per tick, not per entry).
570
+ scope.ok(JSON.stringify({
571
+ probesIssued,
572
+ probesSkipped,
573
+ entryProbeIntervals,
574
+ }));
318
575
  }
319
576
  }
320
577
  // Singleton instance
@@ -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). */