@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.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,22 +1,53 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
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
|
|
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
|
|
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
|
-
/**
|
|
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
|
-
|
|
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
|
-
*
|
|
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
|
|
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
|
|
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
|
|
52
|
-
// is deliberately NOT `(pendingToolTimeoutMs ?? 0) + GRACE`: that
|
|
53
|
-
// silently raise the threshold to the grace period alone
|
|
54
|
-
// baseline is configured below it, changing behavior for the
|
|
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
|
|
70
|
+
return base;
|
|
58
71
|
}
|
|
59
|
-
|
|
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
|
-
/**
|
|
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
|
-
|
|
68
|
-
|
|
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
|
-
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
|
|
267
|
-
|
|
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
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
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
|
|
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). */
|