@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- 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/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 +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- 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 +24 -1
- package/dist/cli/config.js +69 -2
- 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 +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- 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.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- 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 +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- 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 +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- 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 +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- 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 +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- 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-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- 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/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 +54 -8
- 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/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 +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- 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 +229 -38
- 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 +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- 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 +86 -17
- 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 +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- 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 +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- 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 +53 -5
- package/dist/tools/check-status.js +210 -53
- 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 +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- 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 +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- 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 +169 -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 +30 -10
- 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 +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- 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 +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- 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/shutdown-server.js +5 -0
- 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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -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 +106 -20
- 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 +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- 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/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/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- 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/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 +3 -3
- 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 +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- 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 +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -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 +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- 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 +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- 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/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.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/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.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-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.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/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.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/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.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/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.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/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.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
|
@@ -4,14 +4,21 @@ import { getAgent } from '../registry.js';
|
|
|
4
4
|
import { getStrategy } from '../strategy.js';
|
|
5
5
|
import { getAgentOS, getAgentShell, isPosixShell } from '../../utils/agent-helpers.js';
|
|
6
6
|
import { logLine, logWarn } from '../../utils/log-helpers.js';
|
|
7
|
+
import { wrapStallPowerShell, psQuote } from './read-log-tail.js';
|
|
7
8
|
const RETRY_INTERVAL_MS = 10_000;
|
|
8
9
|
const MAX_ATTEMPTS = 4; // initial + 3 retries = 30s total
|
|
9
10
|
const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
|
|
10
11
|
function toFindNewermt(t0) {
|
|
11
12
|
return new Date(t0).toISOString().slice(0, 19).replace('T', ' ');
|
|
12
13
|
}
|
|
13
|
-
|
|
14
|
-
|
|
14
|
+
/**
|
|
15
|
+
* apra-fleet-uob4: a PowerShell expression for the UTC instant t0, compared
|
|
16
|
+
* against LastWriteTimeUtc. The old Z-less ISO string was parsed as LOCAL
|
|
17
|
+
* time and compared with local LastWriteTime, skewing the cutoff by the
|
|
18
|
+
* host's UTC offset.
|
|
19
|
+
*/
|
|
20
|
+
function toPsUtcDateTime(t0) {
|
|
21
|
+
return `[DateTimeOffset]::Parse('${new Date(t0).toISOString().slice(0, 19)}Z', [Globalization.CultureInfo]::InvariantCulture).UtcDateTime`;
|
|
15
22
|
}
|
|
16
23
|
// --- Local helpers ---
|
|
17
24
|
function findLocalMtimeCandidates(dir, t0) {
|
|
@@ -87,7 +94,7 @@ async function findRemoteMtimeCandidates(agent, dir, t0) {
|
|
|
87
94
|
const shell = getAgentShell(agent);
|
|
88
95
|
const cmd = isPosixShell(os, shell)
|
|
89
96
|
? `find "${dir}" -maxdepth 1 -name "*.jsonl" -newermt "${toFindNewermt(t0)}" 2>/dev/null`
|
|
90
|
-
: `
|
|
97
|
+
: wrapStallPowerShell(`Get-ChildItem -Path '${psQuote(dir)}' -Filter '*.jsonl' -ErrorAction SilentlyContinue | Where-Object { $_.LastWriteTimeUtc -gt ${toPsUtcDateTime(t0)} } | ForEach-Object { $_.FullName }`);
|
|
91
98
|
const lines = await execLines(agent, cmd, 10_000);
|
|
92
99
|
return lines.filter(l => l.endsWith('.jsonl'));
|
|
93
100
|
}
|
|
@@ -96,7 +103,7 @@ async function checkRemoteInvToken(agent, candidates, inv) {
|
|
|
96
103
|
const shell = getAgentShell(agent);
|
|
97
104
|
const cmd = isPosixShell(os, shell)
|
|
98
105
|
? `grep -l "\\[${inv}\\]" ${candidates.map(c => `"${c}"`).join(' ')} 2>/dev/null`
|
|
99
|
-
: `
|
|
106
|
+
: wrapStallPowerShell(`Select-String -Pattern '\\[${psQuote(inv)}\\]' -Path @(${candidates.map(c => `'${psQuote(c)}'`).join(',')}) -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Path -Unique`);
|
|
100
107
|
const lines = await execLines(agent, cmd, 5_000);
|
|
101
108
|
return lines.length > 0 ? lines[0] : null;
|
|
102
109
|
}
|
|
@@ -122,7 +129,7 @@ async function tryFindRemote(memberId, agent, t0, inv, logDir, sessionId, provid
|
|
|
122
129
|
const directPath = `${logDir}${sep}${sessionId}.jsonl`;
|
|
123
130
|
const cmd = posix
|
|
124
131
|
? `find "${directPath}" -newermt "${toFindNewermt(t0)}" 2>/dev/null`
|
|
125
|
-
: `
|
|
132
|
+
: wrapStallPowerShell(`Get-Item -Path '${psQuote(directPath)}' -ErrorAction SilentlyContinue | Where-Object { $_.LastWriteTimeUtc -gt ${toPsUtcDateTime(t0)} } | ForEach-Object { $_.FullName }`);
|
|
126
133
|
const lines = await execLines(agent, cmd, 5_000);
|
|
127
134
|
return lines.length > 0 ? lines[0] : null;
|
|
128
135
|
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { getStallDetector, StallDetector, type StallEntry } from './stall-detector.js';
|
|
1
|
+
export { getStallDetector, StallDetector, type StallEntry, type StallReason } from './stall-detector.js';
|
|
2
2
|
export { resolveSessionLogPath, resolveSessionLogDir } from './log-path-resolver.js';
|
|
3
3
|
export { readLogTail, type ReadLogResult } from './read-log-tail.js';
|
|
4
4
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1,3 +1,26 @@
|
|
|
1
|
+
import { escapePowerShellArgInner } from '../../utils/shell-escape.js';
|
|
2
|
+
/**
|
|
3
|
+
* apra-fleet-uob4: every Windows (non-POSIX) stall command goes through
|
|
4
|
+
* -EncodedCommand. A raw `powershell -c "..."` is re-parsed by the member's
|
|
5
|
+
* outer shell: under powershell.exe (local members, PowerShell-default sshd)
|
|
6
|
+
* `$c`/`$_` were expanded to empty before the inner PowerShell ever ran,
|
|
7
|
+
* turning the script into a parse error. Progress output is silenced so an
|
|
8
|
+
* encoded run does not also emit a `#< CLIXML` progress record on stderr.
|
|
9
|
+
*/
|
|
10
|
+
export declare function wrapStallPowerShell(psScript: string): string;
|
|
11
|
+
/** Interior of a PowerShell single-quoted literal: `'` doubled to `''`. */
|
|
12
|
+
export declare const psQuote: typeof escapePowerShellArgInner;
|
|
13
|
+
/**
|
|
14
|
+
* True when a failed tail read's stderr means "the log file does not exist
|
|
15
|
+
* yet" (benign). A PowerShell parse / command-not-found error is never that,
|
|
16
|
+
* even if its text happens to mention a missing item -- it is a broken
|
|
17
|
+
* command and must surface as a read failure (apra-fleet-uob4).
|
|
18
|
+
*
|
|
19
|
+
* An -EncodedCommand run reports errors as `#< CLIXML` with the message
|
|
20
|
+
* wrapped mid-phrase ("does not _x000D__x000A_</S><S S="Error">exist"), so
|
|
21
|
+
* the XML/line-break markup is flattened to plain spaces before matching.
|
|
22
|
+
*/
|
|
23
|
+
export declare function isLogNotYetCreatedStderr(stderr: string): boolean;
|
|
1
24
|
export interface ReadLogResult {
|
|
2
25
|
lastTimestamp: string | null;
|
|
3
26
|
error?: string;
|
|
@@ -2,6 +2,37 @@ import { getAgent } from '../registry.js';
|
|
|
2
2
|
import { getStrategy } from '../strategy.js';
|
|
3
3
|
import { getAgentOS, getAgentShell, isPosixShell } from '../../utils/agent-helpers.js';
|
|
4
4
|
import { logLine, logWarn } from '../../utils/log-helpers.js';
|
|
5
|
+
import { wrapPowerShellEncoded } from '../../os/windows.js';
|
|
6
|
+
import { escapePowerShellArgInner } from '../../utils/shell-escape.js';
|
|
7
|
+
/**
|
|
8
|
+
* apra-fleet-uob4: every Windows (non-POSIX) stall command goes through
|
|
9
|
+
* -EncodedCommand. A raw `powershell -c "..."` is re-parsed by the member's
|
|
10
|
+
* outer shell: under powershell.exe (local members, PowerShell-default sshd)
|
|
11
|
+
* `$c`/`$_` were expanded to empty before the inner PowerShell ever ran,
|
|
12
|
+
* turning the script into a parse error. Progress output is silenced so an
|
|
13
|
+
* encoded run does not also emit a `#< CLIXML` progress record on stderr.
|
|
14
|
+
*/
|
|
15
|
+
export function wrapStallPowerShell(psScript) {
|
|
16
|
+
return wrapPowerShellEncoded(`$ProgressPreference = 'SilentlyContinue'; ${psScript}`);
|
|
17
|
+
}
|
|
18
|
+
/** Interior of a PowerShell single-quoted literal: `'` doubled to `''`. */
|
|
19
|
+
export const psQuote = escapePowerShellArgInner;
|
|
20
|
+
/**
|
|
21
|
+
* True when a failed tail read's stderr means "the log file does not exist
|
|
22
|
+
* yet" (benign). A PowerShell parse / command-not-found error is never that,
|
|
23
|
+
* even if its text happens to mention a missing item -- it is a broken
|
|
24
|
+
* command and must surface as a read failure (apra-fleet-uob4).
|
|
25
|
+
*
|
|
26
|
+
* An -EncodedCommand run reports errors as `#< CLIXML` with the message
|
|
27
|
+
* wrapped mid-phrase ("does not _x000D__x000A_</S><S S="Error">exist"), so
|
|
28
|
+
* the XML/line-break markup is flattened to plain spaces before matching.
|
|
29
|
+
*/
|
|
30
|
+
export function isLogNotYetCreatedStderr(stderr) {
|
|
31
|
+
const text = stderr.replace(/_x000D__x000A_/g, ' ').replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ');
|
|
32
|
+
if (/ParserError|CommandNotFoundException|is not recognized as/i.test(text))
|
|
33
|
+
return false;
|
|
34
|
+
return /No such file|cannot access|does not exist|ItemNotFoundException/i.test(text);
|
|
35
|
+
}
|
|
5
36
|
export async function readLogTail(memberId, logFilePath) {
|
|
6
37
|
const agent = getAgent(memberId);
|
|
7
38
|
if (!agent) {
|
|
@@ -12,7 +43,7 @@ export async function readLogTail(memberId, logFilePath) {
|
|
|
12
43
|
const shell = getAgentShell(agent);
|
|
13
44
|
const cmd = isPosixShell(os, shell)
|
|
14
45
|
? `tail -c 512 "${logFilePath}"`
|
|
15
|
-
: `
|
|
46
|
+
: wrapStallPowerShell(`Get-Content -Tail 5 -Path '${psQuote(logFilePath)}'`);
|
|
16
47
|
try {
|
|
17
48
|
const strategy = getStrategy(agent);
|
|
18
49
|
const result = await strategy.execCommand(cmd, 5000);
|
|
@@ -41,7 +72,7 @@ export async function readLogTail(memberId, logFilePath) {
|
|
|
41
72
|
return { lastTimestamp: null };
|
|
42
73
|
}
|
|
43
74
|
// File not yet created — not an error per resilience decision
|
|
44
|
-
if (
|
|
75
|
+
if (isLogNotYetCreatedStderr(result.stderr)) {
|
|
45
76
|
return { lastTimestamp: null };
|
|
46
77
|
}
|
|
47
78
|
logWarn('stall_log_read', `readLogTail failed for ${memberId}: code=${result.code} stderr=${result.stderr}`);
|
|
@@ -88,8 +88,23 @@ export interface StallEntry {
|
|
|
88
88
|
* once a real signal became available again.
|
|
89
89
|
*/
|
|
90
90
|
noSignalReported?: boolean;
|
|
91
|
-
|
|
91
|
+
/**
|
|
92
|
+
* GitHub #562: true when `logFilePath` was built from an AUTHORITATIVE home
|
|
93
|
+
* directory (local member, or a probed remote home) rather than a guessed
|
|
94
|
+
* one. Only then does "the session log never appeared within the threshold"
|
|
95
|
+
* prove the agent never started; for a guessed path it stays a warning.
|
|
96
|
+
*/
|
|
97
|
+
logPathAuthoritative?: boolean;
|
|
98
|
+
/** Set once the session log has been seen to exist (mtime or content). */
|
|
99
|
+
logFileSeen?: boolean;
|
|
100
|
+
/** When the never-started second signal (a projects-root scan) last came
|
|
101
|
+
* back unconfirmed; the next scan waits a full threshold after it. */
|
|
102
|
+
neverStartedCheckedAt?: number;
|
|
103
|
+
/** stall_never_started_unconfirmed is logged once per dispatch. */
|
|
104
|
+
neverStartedUnconfirmedLogged?: boolean;
|
|
105
|
+
onStall?: (reason?: StallReason) => void;
|
|
92
106
|
}
|
|
107
|
+
export type StallReason = 'stalled' | 'agent_never_started';
|
|
93
108
|
export declare class StallDetector {
|
|
94
109
|
readonly stallCheckList: Map<string, StallEntry>;
|
|
95
110
|
private pollInterval;
|
|
@@ -98,6 +113,15 @@ export declare class StallDetector {
|
|
|
98
113
|
update(memberId: string, partial: Partial<StallEntry>): void;
|
|
99
114
|
remove(memberId: string): void;
|
|
100
115
|
getEntry(memberId: string): StallEntry | undefined;
|
|
116
|
+
/**
|
|
117
|
+
* GitHub #585: a poll awaits a (possibly remote) probe; meanwhile the entry
|
|
118
|
+
* can be removed (dispatch finished) or replaced (a new dispatch, or an
|
|
119
|
+
* update() that swapped the object). Its result then describes something
|
|
120
|
+
* that no longer exists -- applying it warned "Cannot update non-existent
|
|
121
|
+
* entry" or merged stale state (even stallReported) into a NEW dispatch's
|
|
122
|
+
* entry. Callers drop the result when this returns true.
|
|
123
|
+
*/
|
|
124
|
+
private isStale;
|
|
101
125
|
start(): void;
|
|
102
126
|
stop(): void;
|
|
103
127
|
_poll(): Promise<void>;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { updateAgent } from '../registry.js';
|
|
2
2
|
import { logLine, logWarn, LogScope } from '../../utils/log-helpers.js';
|
|
3
|
-
import { pollLogFile, pollDirectoryActivity } from './stall-poller.js';
|
|
3
|
+
import { pollLogFile, pollDirectoryActivity, pollRecentProjectTranscript } from './stall-poller.js';
|
|
4
4
|
import { toLocalISOString, fmtElapsed } from './time-utils.js';
|
|
5
5
|
import { writeStatusline } from '../statusline.js';
|
|
6
6
|
const DEFAULT_POLL_INTERVAL_MS = 30_000;
|
|
@@ -143,6 +143,17 @@ export class StallDetector {
|
|
|
143
143
|
getEntry(memberId) {
|
|
144
144
|
return this.stallCheckList.get(memberId);
|
|
145
145
|
}
|
|
146
|
+
/**
|
|
147
|
+
* GitHub #585: a poll awaits a (possibly remote) probe; meanwhile the entry
|
|
148
|
+
* can be removed (dispatch finished) or replaced (a new dispatch, or an
|
|
149
|
+
* update() that swapped the object). Its result then describes something
|
|
150
|
+
* that no longer exists -- applying it warned "Cannot update non-existent
|
|
151
|
+
* entry" or merged stale state (even stallReported) into a NEW dispatch's
|
|
152
|
+
* entry. Callers drop the result when this returns true.
|
|
153
|
+
*/
|
|
154
|
+
isStale(memberId, entry) {
|
|
155
|
+
return this.stallCheckList.get(memberId) !== entry;
|
|
156
|
+
}
|
|
146
157
|
start() {
|
|
147
158
|
if (this.pollInterval !== null) {
|
|
148
159
|
logWarn('stall_detector', 'Already started');
|
|
@@ -266,6 +277,8 @@ export class StallDetector {
|
|
|
266
277
|
if (entry.logFilePath) {
|
|
267
278
|
try {
|
|
268
279
|
const pollResult = await pollLogFile(memberId, entry.logFilePath);
|
|
280
|
+
if (this.isStale(memberId, entry))
|
|
281
|
+
continue;
|
|
269
282
|
provisionalPendingToolTimeoutMs = pollResult.pendingToolTimeoutMs;
|
|
270
283
|
if (pollResult.mtimeMs && pollResult.mtimeMs > entry.lastActivityAt) {
|
|
271
284
|
entry.lastActivityAt = pollResult.mtimeMs;
|
|
@@ -283,6 +296,8 @@ export class StallDetector {
|
|
|
283
296
|
// this entry out of the baseline-timeout kill below.
|
|
284
297
|
try {
|
|
285
298
|
const activity = await pollDirectoryActivity(memberId);
|
|
299
|
+
if (this.isStale(memberId, entry))
|
|
300
|
+
continue;
|
|
286
301
|
signalAvailable = activity?.signalAvailable !== false;
|
|
287
302
|
if (activity?.mtimeMs && activity.mtimeMs > entry.lastActivityAt) {
|
|
288
303
|
entry.lastActivityAt = activity.mtimeMs;
|
|
@@ -337,7 +352,7 @@ export class StallDetector {
|
|
|
337
352
|
}));
|
|
338
353
|
writeStatusline(new Map([[memberId, 'unknown']]));
|
|
339
354
|
this.update(memberId, { stallReported: true });
|
|
340
|
-
entry.onStall?.();
|
|
355
|
+
entry.onStall?.('stalled');
|
|
341
356
|
}
|
|
342
357
|
else if (!entry.stallReported) {
|
|
343
358
|
writeStatusline(new Map([[memberId, `busy(${fmtElapsed(now - entry.lastActivityAt)})`]]));
|
|
@@ -352,7 +367,9 @@ export class StallDetector {
|
|
|
352
367
|
logPath: entry.logFilePath,
|
|
353
368
|
lastActivityAt: entry.lastActivityAt,
|
|
354
369
|
}));
|
|
355
|
-
const { lastTimestamp, mtimeMs, error, pendingToolTimeoutMs } = await pollLogFile(memberId, entry.logFilePath);
|
|
370
|
+
const { lastTimestamp, mtimeMs, error, pendingToolTimeoutMs, contentSeen } = await pollLogFile(memberId, entry.logFilePath);
|
|
371
|
+
if (this.isStale(memberId, entry))
|
|
372
|
+
continue;
|
|
356
373
|
// apra-fleet: a pending tool_use's own declared timeout, when present,
|
|
357
374
|
// overrides the generic idle threshold for THIS tick's stall check --
|
|
358
375
|
// it is a hard, model-declared budget for a call already known to be
|
|
@@ -381,6 +398,11 @@ export class StallDetector {
|
|
|
381
398
|
// pollLogFile without it, so this is a pure superset of the prior
|
|
382
399
|
// behavior -- it can only turn a would-be false stall into recognized
|
|
383
400
|
// activity, never the reverse.
|
|
401
|
+
// A non-empty tail read also proves the file exists, even when the mtime
|
|
402
|
+
// probe failed and no timestamp parsed.
|
|
403
|
+
if (!entry.logFileSeen && ((mtimeMs !== undefined && mtimeMs !== null) || lastTimestamp !== null || contentSeen === true)) {
|
|
404
|
+
this.update(memberId, { logFileSeen: true });
|
|
405
|
+
}
|
|
384
406
|
const mtimeAdvancedTo = (mtimeMs !== undefined && mtimeMs !== null && mtimeMs > entry.lastActivityAt)
|
|
385
407
|
? mtimeMs
|
|
386
408
|
: null;
|
|
@@ -401,6 +423,63 @@ export class StallDetector {
|
|
|
401
423
|
continue;
|
|
402
424
|
}
|
|
403
425
|
if (mtimeMs === undefined || mtimeMs === null) {
|
|
426
|
+
// GitHub #562: at an AUTHORITATIVE path, a session log that has
|
|
427
|
+
// never appeared for the whole inactivity threshold means the agent
|
|
428
|
+
// never started -- kill with a distinct reason instead of logging
|
|
429
|
+
// stall_no_signal on every tick forever. A guessed path (or a file
|
|
430
|
+
// that existed earlier in this dispatch) keeps the old behavior.
|
|
431
|
+
//
|
|
432
|
+
// The path alone is not proof (the CLI's own project-dir naming,
|
|
433
|
+
// a symlinked cwd or a relocated config dir can put the transcript
|
|
434
|
+
// elsewhere), so a kill also needs a second, independent signal:
|
|
435
|
+
// no *.jsonl under the provider's projects root changed since the
|
|
436
|
+
// dispatch started. If that cannot be established, warn only --
|
|
437
|
+
// once per dispatch -- and rescan the root at most once per
|
|
438
|
+
// threshold rather than on every tick.
|
|
439
|
+
let neverStarted = false;
|
|
440
|
+
if (entry.logPathAuthoritative && !entry.logFileSeen && contentSeen !== true
|
|
441
|
+
&& now - entry.lastActivityAt > stallThresholdMs && !entry.stallReported
|
|
442
|
+
&& (entry.neverStartedCheckedAt === undefined || now - entry.neverStartedCheckedAt >= stallThresholdMs)) {
|
|
443
|
+
let recent = null;
|
|
444
|
+
try {
|
|
445
|
+
recent = await pollRecentProjectTranscript(memberId, entry.lastActivityAt);
|
|
446
|
+
}
|
|
447
|
+
catch {
|
|
448
|
+
recent = null;
|
|
449
|
+
}
|
|
450
|
+
if (this.isStale(memberId, entry))
|
|
451
|
+
continue;
|
|
452
|
+
neverStarted = recent === false;
|
|
453
|
+
if (!neverStarted) {
|
|
454
|
+
const alreadyLogged = entry.neverStartedUnconfirmedLogged === true;
|
|
455
|
+
this.update(memberId, { neverStartedCheckedAt: now, neverStartedUnconfirmedLogged: true });
|
|
456
|
+
if (!alreadyLogged)
|
|
457
|
+
logLine('stall_never_started_unconfirmed', JSON.stringify({
|
|
458
|
+
memberId,
|
|
459
|
+
memberName: entry.memberName,
|
|
460
|
+
logPath: entry.logFilePath,
|
|
461
|
+
recentTranscriptElsewhere: recent,
|
|
462
|
+
note: recent === true
|
|
463
|
+
? 'session log absent at its expected path but a transcript changed elsewhere under the projects root -- not killing'
|
|
464
|
+
: 'session log absent but the second signal could not be established -- not killing',
|
|
465
|
+
}));
|
|
466
|
+
}
|
|
467
|
+
}
|
|
468
|
+
if (neverStarted) {
|
|
469
|
+
scope.warn(JSON.stringify({
|
|
470
|
+
event: 'agent_never_started',
|
|
471
|
+
memberId,
|
|
472
|
+
memberName: entry.memberName,
|
|
473
|
+
idleSecs: Math.floor((now - entry.lastActivityAt) / 1000),
|
|
474
|
+
logPath: entry.logFilePath,
|
|
475
|
+
thresholdMs: stallThresholdMs,
|
|
476
|
+
note: 'session log never appeared at its authoritative path within the inactivity threshold',
|
|
477
|
+
}));
|
|
478
|
+
writeStatusline(new Map([[memberId, 'unknown']]));
|
|
479
|
+
this.update(memberId, { stallReported: true });
|
|
480
|
+
entry.onStall?.('agent_never_started');
|
|
481
|
+
continue;
|
|
482
|
+
}
|
|
404
483
|
// apra-fleet-qe83.2.2: the file genuinely has no OS mtime either --
|
|
405
484
|
// it has not been created yet (or is otherwise unreadable). This IS
|
|
406
485
|
// the absence of evidence, not evidence of a stall: do NOT count it
|
|
@@ -438,7 +517,7 @@ export class StallDetector {
|
|
|
438
517
|
const ts = new Date(lastTimestamp).getTime();
|
|
439
518
|
const contentAdvancedTo = (!isNaN(ts) && ts > entry.lastActivityAt) ? ts : null;
|
|
440
519
|
if (contentAdvancedTo !== null || mtimeAdvancedTo !== null) {
|
|
441
|
-
// Activity advanced
|
|
520
|
+
// Activity advanced -- update and reset counters, then reflect fresh elapsed in statusline
|
|
442
521
|
const advancedTo = Math.max(contentAdvancedTo ?? 0, mtimeAdvancedTo ?? 0);
|
|
443
522
|
this.update(memberId, {
|
|
444
523
|
lastActivityAt: advancedTo,
|
|
@@ -453,7 +532,7 @@ export class StallDetector {
|
|
|
453
532
|
continue;
|
|
454
533
|
}
|
|
455
534
|
}
|
|
456
|
-
// No new activity per EITHER signal
|
|
535
|
+
// No new activity per EITHER signal -- increment idle cycle counter and
|
|
457
536
|
// check stall threshold. Requiring both the content scan and the
|
|
458
537
|
// filesystem's own mtime to agree the transcript is frozen is what
|
|
459
538
|
// makes this threshold check genuinely mtime-corroborated, not just a
|
|
@@ -478,7 +557,7 @@ export class StallDetector {
|
|
|
478
557
|
}));
|
|
479
558
|
writeStatusline(new Map([[memberId, 'unknown']]));
|
|
480
559
|
this.update(memberId, { stallReported: true });
|
|
481
|
-
entry.onStall?.();
|
|
560
|
+
entry.onStall?.('stalled');
|
|
482
561
|
}
|
|
483
562
|
else if (!entry.stallReported) {
|
|
484
563
|
// Show steadily increasing elapsed time so PM can gauge staleness
|
|
@@ -30,7 +30,23 @@ export interface PollResult {
|
|
|
30
30
|
* only -- see extractPendingToolTimeoutMs.
|
|
31
31
|
*/
|
|
32
32
|
pendingToolTimeoutMs?: number | null;
|
|
33
|
+
/** True when the tail read returned any content at all -- the file exists,
|
|
34
|
+
* even if no timestamp parsed and the mtime probe failed. */
|
|
35
|
+
contentSeen?: boolean;
|
|
33
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* GitHub #562 review: the second, independent signal required before a
|
|
39
|
+
* dispatch is declared agent_never_started. Looks for ANY *.jsonl transcript
|
|
40
|
+
* modified since `sinceMs` under the provider's projects root (the parent of
|
|
41
|
+
* this member's session-log directory) -- if the CLI did start but wrote its
|
|
42
|
+
* transcript under a differently-encoded project dir (CLI-side path rules,
|
|
43
|
+
* a symlinked cwd, a relocated config dir), it shows up here.
|
|
44
|
+
* - true: a recent transcript exists -> the agent started somewhere; do not kill.
|
|
45
|
+
* - false: the projects root exists and holds no recent transcript.
|
|
46
|
+
* - null: unknown (provider without a log dir, unresolved home, missing
|
|
47
|
+
* root, probe failure) -> callers must not kill.
|
|
48
|
+
*/
|
|
49
|
+
export declare function pollRecentProjectTranscript(memberId: string, sinceMs: number): Promise<boolean | null>;
|
|
34
50
|
export interface DirectoryActivity {
|
|
35
51
|
/** Newest file mtime under the provider's log dir, or null when nothing could
|
|
36
52
|
* be read (directory absent, empty, or command failed). */
|
|
@@ -5,6 +5,50 @@ import { logLine, logWarn } from '../../utils/log-helpers.js';
|
|
|
5
5
|
import { getProvider } from '../../providers/index.js';
|
|
6
6
|
import { getMemberPathContext } from '../member-home.js';
|
|
7
7
|
import { escapeDoubleQuoted } from '../../os/os-commands.js';
|
|
8
|
+
import { wrapStallPowerShell, psQuote, isLogNotYetCreatedStderr } from './read-log-tail.js';
|
|
9
|
+
/**
|
|
10
|
+
* GitHub #562 review: the second, independent signal required before a
|
|
11
|
+
* dispatch is declared agent_never_started. Looks for ANY *.jsonl transcript
|
|
12
|
+
* modified since `sinceMs` under the provider's projects root (the parent of
|
|
13
|
+
* this member's session-log directory) -- if the CLI did start but wrote its
|
|
14
|
+
* transcript under a differently-encoded project dir (CLI-side path rules,
|
|
15
|
+
* a symlinked cwd, a relocated config dir), it shows up here.
|
|
16
|
+
* - true: a recent transcript exists -> the agent started somewhere; do not kill.
|
|
17
|
+
* - false: the projects root exists and holds no recent transcript.
|
|
18
|
+
* - null: unknown (provider without a log dir, unresolved home, missing
|
|
19
|
+
* root, probe failure) -> callers must not kill.
|
|
20
|
+
*/
|
|
21
|
+
export async function pollRecentProjectTranscript(memberId, sinceMs) {
|
|
22
|
+
const agent = getAgent(memberId);
|
|
23
|
+
if (!agent)
|
|
24
|
+
return null;
|
|
25
|
+
const adapter = getProvider(agent.llmProvider ?? 'claude');
|
|
26
|
+
const os = getAgentOS(agent);
|
|
27
|
+
const posix = isPosixShell(os, getAgentShell(agent));
|
|
28
|
+
try {
|
|
29
|
+
const { homeDir, targetOs, source } = await getMemberPathContext(agent);
|
|
30
|
+
if (source !== 'local' && source !== 'probe')
|
|
31
|
+
return null;
|
|
32
|
+
const logDir = adapter.resolveSessionLogDir(agent.workFolder, homeDir, targetOs);
|
|
33
|
+
if (!logDir)
|
|
34
|
+
return null;
|
|
35
|
+
const root = logDir.replace(/[\\/]+$/, '').replace(/[\\/][^\\/]*$/, '');
|
|
36
|
+
if (!root)
|
|
37
|
+
return null;
|
|
38
|
+
const minutes = Math.max(1, Math.ceil((Date.now() - sinceMs) / 60_000) + 1);
|
|
39
|
+
const cmd = posix
|
|
40
|
+
? `if [ -d "${escapeDoubleQuoted(root)}" ]; then find "${escapeDoubleQuoted(root)}" -maxdepth 2 -name '*.jsonl' -mmin -${minutes} 2>/dev/null | head -n 1; echo FLEET_ROOT_OK; fi`
|
|
41
|
+
: wrapStallPowerShell(`if (Test-Path -LiteralPath '${psQuote(root)}') { Get-ChildItem -LiteralPath '${psQuote(root)}' -Filter *.jsonl -Recurse -Depth 1 -File -ErrorAction SilentlyContinue | Where-Object LastWriteTimeUtc -gt ([DateTime]::UtcNow.AddMinutes(-${minutes})) | Select-Object -First 1 -ExpandProperty FullName; 'FLEET_ROOT_OK' }`);
|
|
42
|
+
const result = await getStrategy(agent).execCommand(cmd, 10_000);
|
|
43
|
+
const lines = result.stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
|
|
44
|
+
if (!lines.includes('FLEET_ROOT_OK'))
|
|
45
|
+
return null;
|
|
46
|
+
return lines.some((l) => l !== 'FLEET_ROOT_OK');
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
8
52
|
const NO_SIGNAL = { mtimeMs: null, signalAvailable: false };
|
|
9
53
|
/** Throwaway home dir used only to ask "does this provider build a log dir at
|
|
10
54
|
* all?" without doing a member-side home-dir probe first. Never used to build
|
|
@@ -55,7 +99,7 @@ export async function pollDirectoryActivity(memberId) {
|
|
|
55
99
|
// result and thereby license a kill.
|
|
56
100
|
const authoritative = source === 'local' || source === 'probe';
|
|
57
101
|
const strategy = getStrategy(agent);
|
|
58
|
-
const escapedWinDir = logDir
|
|
102
|
+
const escapedWinDir = psQuote(logDir);
|
|
59
103
|
const escapedPosixDir = escapeDoubleQuoted(logDir);
|
|
60
104
|
// apra-fleet: avoid any intermediate `$variable` in this one-liner -- on at
|
|
61
105
|
// least one Windows member (fleet-win-dev1), the SSH exec path silently
|
|
@@ -80,7 +124,7 @@ export async function pollDirectoryActivity(memberId) {
|
|
|
80
124
|
// call) means a zero-object pipeline just produces no output, no error.
|
|
81
125
|
const cmd = posix
|
|
82
126
|
? `find "${escapedPosixDir}" -maxdepth 5 -type f -exec stat -c %Y {} + 2>/dev/null | sort -nr | head -n1`
|
|
83
|
-
: `
|
|
127
|
+
: wrapStallPowerShell(`if (Test-Path -Path '${escapedWinDir}') { Get-ChildItem -Path '${escapedWinDir}' -Depth 5 -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTimeUtc -Descending | Select-Object -First 1 -ExpandProperty LastWriteTimeUtc | Get-Date -Format o }`);
|
|
84
128
|
try {
|
|
85
129
|
const result = await strategy.execCommand(cmd, 5000);
|
|
86
130
|
const trimmed = result.stdout.trim();
|
|
@@ -112,7 +156,7 @@ async function fetchMtimeMs(strategy, logFilePath, posix) {
|
|
|
112
156
|
const cmd = posix
|
|
113
157
|
// GNU stat (`-c %Y`) first; BSD/macOS stat (`-f %m`) as a fallback -- both report whole seconds.
|
|
114
158
|
? `stat -c %Y "${logFilePath}" 2>/dev/null || stat -f %m "${logFilePath}" 2>/dev/null`
|
|
115
|
-
: `
|
|
159
|
+
: wrapStallPowerShell(`[DateTimeOffset]::new((Get-Item -LiteralPath '${psQuote(logFilePath)}' -ErrorAction SilentlyContinue).LastWriteTimeUtc, [TimeSpan]::Zero).ToUnixTimeMilliseconds()`);
|
|
116
160
|
try {
|
|
117
161
|
const result = await strategy.execCommand(cmd, 5000);
|
|
118
162
|
const trimmed = result.stdout.trim();
|
|
@@ -169,7 +213,7 @@ export async function pollLogFile(memberId, logFilePath) {
|
|
|
169
213
|
// guarantee the module doc comment above already assumes for everyone.
|
|
170
214
|
const cmd = posix
|
|
171
215
|
? `tail -n ${TAIL_LINES} "${logFilePath}" | tail -c ${TAIL_BYTES}`
|
|
172
|
-
:
|
|
216
|
+
: wrapStallPowerShell(`$c = (Get-Content -Tail ${TAIL_LINES} -Path '${psQuote(logFilePath)}') -join [Environment]::NewLine; if ($c.Length -gt ${TAIL_BYTES}) { $c.Substring($c.Length - ${TAIL_BYTES}) } else { $c }`);
|
|
173
217
|
try {
|
|
174
218
|
const strategy = getStrategy(agent);
|
|
175
219
|
// apra-fleet-iuc.2: fetch the file's own mtime independently of the
|
|
@@ -179,7 +223,7 @@ export async function pollLogFile(memberId, logFilePath) {
|
|
|
179
223
|
const mtimeMs = await fetchMtimeMs(strategy, logFilePath, posix);
|
|
180
224
|
const result = await strategy.execCommand(cmd, 5000);
|
|
181
225
|
if (result.code !== 0) {
|
|
182
|
-
if (
|
|
226
|
+
if (isLogNotYetCreatedStderr(result.stderr)) {
|
|
183
227
|
return { lastTimestamp: null, mtimeMs };
|
|
184
228
|
}
|
|
185
229
|
logWarn('stall_log_read', `pollLogFile failed for ${memberId}: code=${result.code} stderr=${result.stderr}`);
|
|
@@ -190,7 +234,7 @@ export async function pollLogFile(memberId, logFilePath) {
|
|
|
190
234
|
? extractAgyTimestamp(memberId, lines, result.stdout)
|
|
191
235
|
: extractClaudeTimestamp(memberId, lines, result.stdout);
|
|
192
236
|
const pendingToolTimeoutMs = extractPendingToolTimeoutMs(provider, lines);
|
|
193
|
-
return { ...extracted, mtimeMs, pendingToolTimeoutMs };
|
|
237
|
+
return { ...extracted, mtimeMs, pendingToolTimeoutMs, contentSeen: result.stdout.trim().length > 0 };
|
|
194
238
|
}
|
|
195
239
|
catch (err) {
|
|
196
240
|
const msg = err instanceof Error ? err.message : String(err);
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export declare const STOPPED_BY_USER_FILE = "stopped-by-user.json";
|
|
2
|
+
export declare const STOPPED_MARKER_PATH: string;
|
|
3
|
+
export interface StoppedMarker {
|
|
4
|
+
stoppedAt: string;
|
|
5
|
+
/** The command that stopped it, e.g. "apra-fleet stop". */
|
|
6
|
+
by: string;
|
|
7
|
+
user: string;
|
|
8
|
+
host: string;
|
|
9
|
+
pid: number;
|
|
10
|
+
}
|
|
11
|
+
export declare function writeStoppedMarker(by?: string, file?: string, now?: Date): StoppedMarker;
|
|
12
|
+
export declare function readStoppedMarker(file?: string): StoppedMarker | null;
|
|
13
|
+
export declare function clearStoppedMarker(file?: string): void;
|
|
14
|
+
/** One-line description for status output. */
|
|
15
|
+
export declare function describeStoppedMarker(m: StoppedMarker): string;
|
|
16
|
+
//# sourceMappingURL=stopped-marker.d.ts.map
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* "Stopped by user" marker (GitHub #585 recovery). `apra-fleet stop` writes
|
|
3
|
+
* <data dir>/stopped-by-user.json; ONLY `apra-fleet start` and `apra-fleet
|
|
4
|
+
* install` clear it. While it is present a service-manager launch (launchd
|
|
5
|
+
* RunAtLoad, systemd at boot, the Windows HKCU Run fallback or task) exits 0
|
|
6
|
+
* without starting (src/index.ts startHttpServer), and clients
|
|
7
|
+
* (packages/apra-fleet-client auto-start, including a reconnecting
|
|
8
|
+
* long-lived client) do NOT start the server: they fail with an actionable
|
|
9
|
+
* error instead, so a deliberate stop is never silently undone. The client
|
|
10
|
+
* reads the same file name and fields -- keep them in sync with
|
|
11
|
+
* packages/apra-fleet-client/src/client/auto-start.mjs.
|
|
12
|
+
*/
|
|
13
|
+
import fs from 'node:fs';
|
|
14
|
+
import os from 'node:os';
|
|
15
|
+
import path from 'node:path';
|
|
16
|
+
import { FLEET_DIR } from '../paths.js';
|
|
17
|
+
export const STOPPED_BY_USER_FILE = 'stopped-by-user.json';
|
|
18
|
+
export const STOPPED_MARKER_PATH = path.join(FLEET_DIR, STOPPED_BY_USER_FILE);
|
|
19
|
+
function currentUser() {
|
|
20
|
+
try {
|
|
21
|
+
return os.userInfo().username;
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
return process.env.USERNAME || process.env.USER || 'unknown';
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
export function writeStoppedMarker(by = 'apra-fleet stop', file = STOPPED_MARKER_PATH, now = new Date()) {
|
|
28
|
+
const marker = { stoppedAt: now.toISOString(), by, user: currentUser(), host: os.hostname(), pid: process.pid };
|
|
29
|
+
try {
|
|
30
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
31
|
+
fs.writeFileSync(file, JSON.stringify(marker, null, 2));
|
|
32
|
+
}
|
|
33
|
+
catch { /* best-effort: never fail a stop on the marker */ }
|
|
34
|
+
return marker;
|
|
35
|
+
}
|
|
36
|
+
export function readStoppedMarker(file = STOPPED_MARKER_PATH) {
|
|
37
|
+
try {
|
|
38
|
+
const m = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
39
|
+
return m && typeof m.stoppedAt === 'string' ? m : null;
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
return null;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
export function clearStoppedMarker(file = STOPPED_MARKER_PATH) {
|
|
46
|
+
try {
|
|
47
|
+
fs.unlinkSync(file);
|
|
48
|
+
}
|
|
49
|
+
catch { /* absent */ }
|
|
50
|
+
}
|
|
51
|
+
/** One-line description for status output. */
|
|
52
|
+
export function describeStoppedMarker(m) {
|
|
53
|
+
return `stopped by ${m.user} at ${m.stoppedAt} via '${m.by}' -- run 'apra-fleet start'`;
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=stopped-marker.js.map
|
|
@@ -8,12 +8,41 @@ import type { Agent, SSHExecResult, TransferResult } from '../types.js';
|
|
|
8
8
|
* Remove-Item with -Force -ErrorAction SilentlyContinue, same
|
|
9
9
|
* wrapPowerShellEncoded wrapping as the pre-refactor inline version. */
|
|
10
10
|
export declare function buildWindowsDeleteFilesScript(folder: string, relativePaths: string[]): string;
|
|
11
|
+
/** Upper bound for the synchronous local tree-kill. It runs on the server's
|
|
12
|
+
* event loop, so an unbounded call (a slow/hung PowerShell profile, a stuck
|
|
13
|
+
* taskkill) would freeze every other request (GitHub #562). */
|
|
14
|
+
export declare const KILL_TREE_TIMEOUT_MS = 10000;
|
|
15
|
+
/**
|
|
16
|
+
* Synchronously kill a LOCAL process tree, bounded by KILL_TREE_TIMEOUT_MS.
|
|
17
|
+
*
|
|
18
|
+
* Synchronous on purpose: callers run it BEFORE child.kill() because taskkill
|
|
19
|
+
* needs the wrapper's PID alive to recurse from it (an async exec loses that
|
|
20
|
+
* race and leaves descendants running).
|
|
21
|
+
*
|
|
22
|
+
* On a Windows host taskkill.exe is invoked directly via execFileSync -- no
|
|
23
|
+
* shell at all, so no PowerShell profile load and no cmd.exe/bash parsing of
|
|
24
|
+
* the kill string (that parsing was the apra-fleet-7dir.4 gitbash bug; the
|
|
25
|
+
* shell-free call sidesteps it for every Windows shell flavour). Elsewhere the
|
|
26
|
+
* member's own killPid string runs through the shell cleanExec resolved.
|
|
27
|
+
* Best-effort: errors, including the timeout, are swallowed.
|
|
28
|
+
*/
|
|
29
|
+
export declare function killLocalProcessTree(pid: number, posixKillCommand: string, shell?: string): void;
|
|
11
30
|
export interface AgentStrategy {
|
|
12
31
|
execCommand(command: string, timeoutMs?: number, maxTotalMs?: number, onPidCaptured?: (pid: number) => void, abortSignal?: AbortSignal): Promise<SSHExecResult>;
|
|
13
32
|
transferFiles(localPaths: string[], destinationPath?: string, abortSignal?: AbortSignal): Promise<TransferResult>;
|
|
14
33
|
receiveFiles(remotePaths: string[], localDestination: string, abortSignal?: AbortSignal): Promise<TransferResult>;
|
|
15
|
-
/** Delete files relative to the agent's workFolder. Best-effort
|
|
34
|
+
/** Delete files relative to the agent's workFolder. Best-effort -- errors are silently ignored. */
|
|
16
35
|
deleteFiles(relativePaths: string[]): Promise<void>;
|
|
36
|
+
/**
|
|
37
|
+
* Write a secret-bearing file (owner-only) on the member WITHOUT any
|
|
38
|
+
* command line carrying its content -- SFTP for remote members, fs for
|
|
39
|
+
* local ones. `fileName` must not contain any part of the secret. Returns
|
|
40
|
+
* the absolute path in the form the member's shell accepts. Strategies with
|
|
41
|
+
* no such channel (relay) throw.
|
|
42
|
+
*/
|
|
43
|
+
writeSecretFile(fileName: string, content: string): Promise<string>;
|
|
44
|
+
/** Best-effort removal of a file written by writeSecretFile. */
|
|
45
|
+
removeSecretFile(filePath: string): Promise<void>;
|
|
17
46
|
testConnection(): Promise<{
|
|
18
47
|
ok: boolean;
|
|
19
48
|
latencyMs: number;
|
|
@@ -21,5 +50,8 @@ export interface AgentStrategy {
|
|
|
21
50
|
}>;
|
|
22
51
|
close(): void;
|
|
23
52
|
}
|
|
53
|
+
/** Per-user 0700 directory for local members' staged secret files. Throws if
|
|
54
|
+
* an existing path is not a private directory owned by this user. */
|
|
55
|
+
export declare function privateSecretDir(base?: string): string;
|
|
24
56
|
export declare function getStrategy(agent: Agent): AgentStrategy;
|
|
25
57
|
//# sourceMappingURL=strategy.d.ts.map
|