@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
|
@@ -1,11 +1,76 @@
|
|
|
1
|
-
import { execFileSync } from 'node:child_process';
|
|
1
|
+
import { execFileSync, spawn } from 'node:child_process';
|
|
2
2
|
import fs from 'node:fs';
|
|
3
3
|
import path from 'node:path';
|
|
4
|
-
import { WINDOWS_TASK_NAME } from './types.js';
|
|
4
|
+
import { WINDOWS_TASK_NAME, SERVICE_ENV_MARKER } from './types.js';
|
|
5
5
|
import { gracefulStopByServerJson } from './index.js';
|
|
6
|
+
import { clearServiceStartFailures } from '../service-start-guard.js';
|
|
7
|
+
import { readStoppedMarker } from '../stopped-marker.js';
|
|
8
|
+
import { SERVICE_NOTICE_PATH, writeServiceNotice, clearServiceNotice } from '../service-notice.js';
|
|
6
9
|
import { BIN_DIR } from '../../cli/config.js';
|
|
10
|
+
import { selfInvocationLines } from '../../cli/install-guard.js';
|
|
11
|
+
import { currentWindowsUser } from '../../utils/owner-only-fs.js';
|
|
7
12
|
const WRAPPER_PATH = path.join(BIN_DIR, 'apra-fleet-service.bat');
|
|
8
|
-
|
|
13
|
+
/** HKCU Run key used ONLY as the last-resort fallback (logon autostart, no restart). */
|
|
14
|
+
export const RUN_KEY = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run';
|
|
15
|
+
export const RUN_VALUE = WINDOWS_TASK_NAME;
|
|
16
|
+
/** Default repeat interval of the task's revive trigger. */
|
|
17
|
+
export const DEFAULT_REPEAT_MINUTES = 5;
|
|
18
|
+
/**
|
|
19
|
+
* Test-only override of the revive-trigger interval in minutes (1..1440), so a
|
|
20
|
+
* manual non-admin verification does not have to wait 5 minutes per cycle.
|
|
21
|
+
* Read once at register() time; not a supported user setting.
|
|
22
|
+
*/
|
|
23
|
+
export const REPEAT_MINUTES_ENV = 'APRA_FLEET_TASK_REPEAT_MINUTES';
|
|
24
|
+
// GitHub #585: every schtasks/taskkill/reg call pipes ALL stdio (stderr too)
|
|
25
|
+
// and hides its console window. Inherited stderr printed schtasks' localized
|
|
26
|
+
// "ERROR: The system cannot find the file specified." above apra-fleet status
|
|
27
|
+
// whenever no task was registered.
|
|
28
|
+
const QUIET = { stdio: 'pipe', windowsHide: true, timeout: 30_000 };
|
|
29
|
+
function quietExec(cmd, args) {
|
|
30
|
+
return execFileSync(cmd, args, QUIET);
|
|
31
|
+
}
|
|
32
|
+
const defaultSchtasksRunner = (args) => quietExec('schtasks', args);
|
|
33
|
+
const defaultRegRunner = (args) => quietExec('reg', args);
|
|
34
|
+
/**
|
|
35
|
+
* The schtasks error text of a failed run, without execFileSync's
|
|
36
|
+
* "Command failed: <command line>" prefix, on one line.
|
|
37
|
+
*/
|
|
38
|
+
export function schtasksErrorReason(msg) {
|
|
39
|
+
const lines = msg.split(/\r?\n/).map(l => l.trim()).filter(l => l && !/^Command failed:/i.test(l));
|
|
40
|
+
return lines.join(' ') || msg.trim() || '(no error text)';
|
|
41
|
+
}
|
|
42
|
+
/** Append a timestamped install message to the service log (best-effort). */
|
|
43
|
+
function appendServiceLog(logPath, text) {
|
|
44
|
+
try {
|
|
45
|
+
fs.appendFileSync(logPath, `[${new Date().toISOString()}] apra-fleet install: ${text.replace(/\n/g, '\r\n')}\r\n`);
|
|
46
|
+
}
|
|
47
|
+
catch { /* best-effort */ }
|
|
48
|
+
}
|
|
49
|
+
function indent(text, by = ' ') {
|
|
50
|
+
return text.split('\n').map(l => by + l).join('\n');
|
|
51
|
+
}
|
|
52
|
+
function defaultSpawnDetached(cmd, args, verbatim = false) {
|
|
53
|
+
const child = spawn(cmd, args, { detached: true, stdio: 'ignore', windowsHide: true, windowsVerbatimArguments: verbatim });
|
|
54
|
+
child.unref();
|
|
55
|
+
}
|
|
56
|
+
/** Decode schtasks output (UTF-16 with BOM, or a single-byte codepage). */
|
|
57
|
+
function decodeSchtasks(raw) {
|
|
58
|
+
const text = typeof raw === 'string' ? raw
|
|
59
|
+
: raw.toString(raw[0] === 0xff && raw[1] === 0xfe ? 'utf16le' : 'utf8');
|
|
60
|
+
return text.replace(/\u0000/g, '');
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Whether a task's XML definition is enabled. Task Scheduler's
|
|
64
|
+
* <Settings><Enabled> defaults to true when absent; XML tag names are not
|
|
65
|
+
* localized (unlike the CSV/LIST status text).
|
|
66
|
+
*/
|
|
67
|
+
export function taskXmlEnabled(raw) {
|
|
68
|
+
const settings = /<Settings>([\s\S]*?)<\/Settings>/i.exec(decodeSchtasks(raw));
|
|
69
|
+
if (!settings)
|
|
70
|
+
return true;
|
|
71
|
+
const m = /<Enabled>\s*(true|false)\s*<\/Enabled>/i.exec(settings[1]);
|
|
72
|
+
return m ? m[1].toLowerCase() === 'true' : true;
|
|
73
|
+
}
|
|
9
74
|
function normalizeTaskPath(p) {
|
|
10
75
|
return p.replace(/"/g, '').replace(/\//g, '\\').trim().toLowerCase();
|
|
11
76
|
}
|
|
@@ -15,69 +80,555 @@ function normalizeTaskPath(p) {
|
|
|
15
80
|
* not localized, unlike schtasks' human-readable output.
|
|
16
81
|
*/
|
|
17
82
|
export function taskXmlCommand(raw) {
|
|
18
|
-
const
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
83
|
+
const m = /<Command>([\s\S]*?)<\/Command>/i.exec(decodeSchtasks(raw));
|
|
84
|
+
return m ? xmlUnescape(m[1].trim()) : null;
|
|
85
|
+
}
|
|
86
|
+
/** Escape a value for an XML text node (every interpolated value goes through this). */
|
|
87
|
+
export function xmlEscape(s) {
|
|
88
|
+
return s.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>')
|
|
89
|
+
.replace(/"/g, '"').replace(/'/g, ''');
|
|
90
|
+
}
|
|
91
|
+
function xmlUnescape(s) {
|
|
92
|
+
return s.replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"')
|
|
93
|
+
.replace(/'/g, "'").replace(/&/g, '&');
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* DOMAIN\user of the current account, read from the process token (whoami),
|
|
97
|
+
* never from env USERDOMAIN (WORKGROUP under Win32-OpenSSH on a workgroup
|
|
98
|
+
* machine) and never by shell expansion. A standard user may only register a
|
|
99
|
+
* logon trigger scoped to THEIR OWN account -- an unscoped LogonTrigger means
|
|
100
|
+
* "any user" and needs elevation (verified in a Windows Sandbox spike, Win10 19041).
|
|
101
|
+
*/
|
|
102
|
+
export function resolveTaskUserId(whoami = () => decodeSchtasks(quietExec('whoami', []))) {
|
|
103
|
+
return currentWindowsUser(whoami);
|
|
104
|
+
}
|
|
105
|
+
/** Local wall-clock time as Task Scheduler's StartBoundary (no zone = local). */
|
|
106
|
+
export function localStartBoundary(d) {
|
|
107
|
+
const p = (n) => String(n).padStart(2, '0');
|
|
108
|
+
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}T${p(d.getHours())}:${p(d.getMinutes())}:00`;
|
|
109
|
+
}
|
|
110
|
+
export function repeatMinutesFrom(env) {
|
|
111
|
+
const n = parseInt(env[REPEAT_MINUTES_ENV] ?? '', 10);
|
|
112
|
+
return Number.isFinite(n) && n >= 1 && n <= 1440 ? n : DEFAULT_REPEAT_MINUTES;
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* The service wrapper (.bat): sets the service-launch marker, makes sure the
|
|
116
|
+
* log dir exists (a deleted data dir must not make every revive fail the
|
|
117
|
+
* `>>` redirect before the server even starts), then runs the server with
|
|
118
|
+
* output appended to the log. Its exit code is the server's.
|
|
119
|
+
*/
|
|
120
|
+
export function buildWrapperBat(binaryPath, args, logPath) {
|
|
121
|
+
const logDir = path.win32.dirname(logPath);
|
|
122
|
+
const quotedArgs = args.map(a => `"${a}"`).join(' ');
|
|
123
|
+
return [
|
|
124
|
+
'@echo off',
|
|
125
|
+
// The file is UTF-8; cmd reads each following line in the active code
|
|
126
|
+
// page, so switch to UTF-8 first -- otherwise a non-ASCII profile path
|
|
127
|
+
// (C:\Users\Jos<e-acute>) is garbled and the server never starts.
|
|
128
|
+
'chcp 65001>nul',
|
|
129
|
+
`set ${SERVICE_ENV_MARKER}=1`,
|
|
130
|
+
`if not exist "${logDir}\\" mkdir "${logDir}"`,
|
|
131
|
+
`"${binaryPath}" ${quotedArgs} >> "${logPath}" 2>&1`,
|
|
132
|
+
].join('\r\n');
|
|
133
|
+
}
|
|
134
|
+
/** The hidden launcher script that sits next to the wrapper. */
|
|
135
|
+
export function launcherPathFor(wrapperPath) {
|
|
136
|
+
// A Windows-style wrapper path (drive letter, UNC or backslashes) keeps win32
|
|
137
|
+
// semantics; a POSIX absolute path must stay POSIX or path.win32 turns it
|
|
138
|
+
// into a cwd-relative '\\tmp\\...' string.
|
|
139
|
+
const flavor = /^[A-Za-z]:|^\\\\|\\/.test(wrapperPath) ? path.win32 : path.posix;
|
|
140
|
+
return flavor.join(flavor.dirname(wrapperPath), 'apra-fleet-service.js');
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* JScript launcher run by wscript.exe: starts the wrapper with window style 0
|
|
144
|
+
* (no console on the user's desktop -- an InteractiveToken task running the
|
|
145
|
+
* .bat directly opens a visible cmd window on every start/revive, and closing
|
|
146
|
+
* it kills the server), waits for it, and returns its exit code so Task
|
|
147
|
+
* Scheduler's Last Result stays meaningful. The path is embedded as a JSON
|
|
148
|
+
* string literal (valid JScript: backslashes and quotes escaped).
|
|
149
|
+
*/
|
|
150
|
+
export function buildLauncherJs(wrapperPath) {
|
|
151
|
+
return [
|
|
152
|
+
'// apra-fleet service launcher (generated by apra-fleet install): runs the',
|
|
153
|
+
'// service wrapper hidden and returns its exit code to Task Scheduler.',
|
|
154
|
+
"var shell = new ActiveXObject('WScript.Shell');",
|
|
155
|
+
`var wrapper = ${asciiJsString(wrapperPath)};`,
|
|
156
|
+
"WScript.Quit(shell.Run('\"' + wrapper + '\"', 0, true));",
|
|
157
|
+
'',
|
|
158
|
+
].join('\r\n');
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* A JScript string literal that is pure ASCII: JSON escaping plus \uXXXX for
|
|
162
|
+
* every non-ASCII char. WSH decodes a .js file in the ANSI code page, so a
|
|
163
|
+
* UTF-8 path (C:\Users\Jos<e-acute>) made the launcher silently exit 0
|
|
164
|
+
* without running the wrapper; an ASCII file reads identically in every code
|
|
165
|
+
* page (chosen over UTF-16LE+BOM: no encoding dependency at all).
|
|
166
|
+
*/
|
|
167
|
+
export function asciiJsString(s) {
|
|
168
|
+
return JSON.stringify(s).replace(/[\u007f-\uffff]/g, (c) => '\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Whether Windows Script Host runs here (it can be disabled by policy): runs a
|
|
172
|
+
* one-line probe script that must exit 42. Any other outcome -> no WSH.
|
|
173
|
+
*/
|
|
174
|
+
export function defaultProbeWsh(env, dir) {
|
|
175
|
+
const probe = path.join(dir, 'apra-fleet-wsh-probe.js');
|
|
176
|
+
try {
|
|
177
|
+
fs.writeFileSync(probe, 'WScript.Quit(42);\r\n');
|
|
178
|
+
execFileSync(wscriptPath(env), ['//B', '//Nologo', '//E:JScript', probe], { stdio: 'pipe', windowsHide: true, timeout: 15_000 });
|
|
179
|
+
return false;
|
|
180
|
+
}
|
|
181
|
+
catch (err) {
|
|
182
|
+
return err.status === 42;
|
|
183
|
+
}
|
|
184
|
+
finally {
|
|
185
|
+
try {
|
|
186
|
+
fs.unlinkSync(probe);
|
|
187
|
+
}
|
|
188
|
+
catch { /* best-effort */ }
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
/** wscript.exe, resolved in JS from SystemRoot (no shell expansion). */
|
|
192
|
+
export function wscriptPath(env = process.env) {
|
|
193
|
+
return path.win32.join(env.SystemRoot || env.SYSTEMROOT || 'C:\\Windows', 'System32', 'wscript.exe');
|
|
194
|
+
}
|
|
195
|
+
/** wscript arguments for the launcher: batch mode, no logo, forced JScript engine. */
|
|
196
|
+
export function launcherArguments(launcherPath) {
|
|
197
|
+
return `//B //Nologo //E:JScript "${launcherPath}"`;
|
|
198
|
+
}
|
|
199
|
+
/** The <Arguments> of an existing task's XML definition, or null. */
|
|
200
|
+
export function taskXmlArguments(raw) {
|
|
201
|
+
const m = /<Arguments>([\s\S]*?)<\/Arguments>/i.exec(decodeSchtasks(raw));
|
|
202
|
+
return m ? xmlUnescape(m[1].trim()) : null;
|
|
203
|
+
}
|
|
204
|
+
/** Whether a task action is wscript.exe running `launcherPath` (our hidden launcher). */
|
|
205
|
+
function runsOurLauncher(command, args, launcherPath) {
|
|
206
|
+
return command !== null && /wscript\.exe"?$/i.test(command.trim()) && args !== null
|
|
207
|
+
&& normalizeTaskPath(args).includes(normalizeTaskPath(launcherPath));
|
|
208
|
+
}
|
|
209
|
+
/** Whether the action is `wrapperPath` split at a space into Command + Arguments. */
|
|
210
|
+
export function runsSplitWrapper(command, args, wrapperPath) {
|
|
211
|
+
if (command === null || args === null || !args.trim())
|
|
212
|
+
return false;
|
|
213
|
+
return normalizeTaskPath(`${command} ${args}`) === normalizeTaskPath(wrapperPath)
|
|
214
|
+
&& normalizeTaskPath(command) !== normalizeTaskPath(wrapperPath);
|
|
215
|
+
}
|
|
216
|
+
export function legacyTaskProblems(raw, opts) {
|
|
217
|
+
const xml = decodeSchtasks(raw);
|
|
218
|
+
const problems = [];
|
|
219
|
+
// No <Triggers> section (truncated/unreadable output): no claim, so a
|
|
220
|
+
// parse problem never produces upgrade guidance.
|
|
221
|
+
const triggersMatch = /<Triggers>([\s\S]*?)<\/Triggers>/i.exec(xml);
|
|
222
|
+
if (!triggersMatch)
|
|
223
|
+
return problems;
|
|
224
|
+
const triggers = triggersMatch[1];
|
|
225
|
+
const repeating = [...triggers.matchAll(/<(TimeTrigger|CalendarTrigger)\b[^>]*>([\s\S]*?)<\/\1>/gi)]
|
|
226
|
+
.some(m => /<Repetition>[\s\S]*?<Interval>\s*P[^<]*<\/Interval>/i.test(m[2]));
|
|
227
|
+
if (!repeating)
|
|
228
|
+
problems.push('no-revive');
|
|
229
|
+
const command = taskXmlCommand(xml);
|
|
230
|
+
const args = taskXmlArguments(xml);
|
|
231
|
+
const split = !!opts.wrapperPath && runsSplitWrapper(command, args, opts.wrapperPath);
|
|
232
|
+
// A split task never starts the server, so it has no console to speak of.
|
|
233
|
+
if (!split && opts.launcherExpected && !runsOurLauncher(command, args, opts.launcherPath)) {
|
|
234
|
+
problems.push('visible-console');
|
|
235
|
+
}
|
|
236
|
+
if (split)
|
|
237
|
+
problems.push('split-path');
|
|
238
|
+
const logonTriggers = [...triggers.matchAll(/<LogonTrigger\b[^>]*>([\s\S]*?)<\/LogonTrigger>|<LogonTrigger\b[^>]*\/>/gi)];
|
|
239
|
+
if (logonTriggers.some(m => !/<UserId>\s*\S[\s\S]*?<\/UserId>/i.test(m[1] ?? '')))
|
|
240
|
+
problems.push('elevated');
|
|
241
|
+
return problems;
|
|
242
|
+
}
|
|
243
|
+
const LEGACY_PROBLEM_TEXT = {
|
|
244
|
+
'no-revive': 'no automatic revive after a crash',
|
|
245
|
+
'visible-console': 'the server runs in a visible console window',
|
|
246
|
+
'split-path': 'the task command is split at a space in the install path, so the server does not start',
|
|
247
|
+
'elevated': "'apra-fleet stop' cannot disable the task",
|
|
248
|
+
};
|
|
249
|
+
/** Short form for apra-fleet status: "legacy task (upgrade needed: ...)". */
|
|
250
|
+
export function legacyTaskDetail(problems) {
|
|
251
|
+
return `legacy task (upgrade needed: ${problems.map(p => LEGACY_PROBLEM_TEXT[p]).join('; ')})`;
|
|
252
|
+
}
|
|
253
|
+
/**
|
|
254
|
+
* The exact manual fix, shared by install, status and stop. The elevated
|
|
255
|
+
* delete is only needed for an elevated-owned task ('elevated'); a user-owned
|
|
256
|
+
* old-form task is replaced by a plain re-install. apra-fleet never runs
|
|
257
|
+
* anything elevated itself and never needs an elevated install. --force: the
|
|
258
|
+
* server the old task started is normally still running, and install refuses
|
|
259
|
+
* to replace a running server without it.
|
|
260
|
+
*/
|
|
261
|
+
export function legacyTaskFix(problems, execPath = process.execPath) {
|
|
262
|
+
const install = upgradeCommandLines(execPath).map(l => ` ${l}`);
|
|
263
|
+
if (!problems.includes('elevated')) {
|
|
264
|
+
return ['To upgrade it, run from a normal prompt:', ...install].join('\n');
|
|
265
|
+
}
|
|
266
|
+
return [
|
|
267
|
+
'To upgrade it, run once from an elevated prompt (Run as administrator):',
|
|
268
|
+
` schtasks /delete /tn ${WINDOWS_TASK_NAME} /f`,
|
|
269
|
+
'then, from a normal prompt (do not run the install itself elevated):',
|
|
270
|
+
...install,
|
|
271
|
+
].join('\n');
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* `install --force` as a command that works where this runs. A standalone
|
|
275
|
+
* install does not put apra-fleet on PATH: the running installer names its
|
|
276
|
+
* own path (like the running-server refusal); the installed binary (status,
|
|
277
|
+
* stop) points at the downloaded installer; node (npm global/dev) has
|
|
278
|
+
* apra-fleet on PATH.
|
|
279
|
+
*/
|
|
280
|
+
export function upgradeCommandLines(execPath) {
|
|
281
|
+
const base = path.win32.basename(execPath).toLowerCase();
|
|
282
|
+
if (base === 'node.exe' || base === 'node')
|
|
283
|
+
return ['apra-fleet install --force'];
|
|
284
|
+
if (path.win32.resolve(execPath).toLowerCase() === path.win32.resolve(BIN_DIR, 'apra-fleet.exe').toLowerCase()) {
|
|
285
|
+
return ['<the apra-fleet installer .exe you downloaded> install --force'];
|
|
286
|
+
}
|
|
287
|
+
return selfInvocationLines({ platform: 'win32', execPath, sea: true, args: ['install', '--force'] });
|
|
288
|
+
}
|
|
289
|
+
/** Full actionable guidance: what is missing and the exact fix. */
|
|
290
|
+
export function legacyTaskGuidance(problems) {
|
|
291
|
+
const intro = problems.includes('elevated')
|
|
292
|
+
? [`The ${WINDOWS_TASK_NAME} scheduled task was registered by an older apra-fleet from an elevated prompt,`,
|
|
293
|
+
'so it cannot be replaced from a normal shell and is still in use. Missing:']
|
|
294
|
+
: [`The ${WINDOWS_TASK_NAME} scheduled task was registered by an older apra-fleet and is still in use. Missing:`];
|
|
295
|
+
return [
|
|
296
|
+
...intro,
|
|
297
|
+
...problems.map(p => ` - ${LEGACY_PROBLEM_TEXT[p]}`),
|
|
298
|
+
legacyTaskFix(problems),
|
|
299
|
+
].join('\n');
|
|
300
|
+
}
|
|
301
|
+
/**
|
|
302
|
+
* The ApraFleet task definition (GitHub #585 recovery). User-level only:
|
|
303
|
+
* - LogonTrigger scoped to the current user (the only form a standard user
|
|
304
|
+
* may register);
|
|
305
|
+
* - a TimeTrigger repeating every N minutes, indefinitely, which revives a
|
|
306
|
+
* server that was killed or crashed. Task Scheduler's RestartOnFailure is
|
|
307
|
+
* deliberately NOT used: it never fires for a non-zero exit or a killed
|
|
308
|
+
* process (only for launch failures);
|
|
309
|
+
* - MultipleInstancesPolicy IgnoreNew makes the trigger a no-op while the
|
|
310
|
+
* server runs; ExecutionTimeLimit PT0S = no time limit;
|
|
311
|
+
* - InteractiveToken + LeastPrivilege: runs as the logged-on user, never
|
|
312
|
+
* elevated, never as a system account.
|
|
313
|
+
*/
|
|
314
|
+
export function buildTaskXml(p) {
|
|
315
|
+
const user = xmlEscape(p.userId);
|
|
316
|
+
return [
|
|
317
|
+
'<?xml version="1.0" encoding="UTF-16"?>',
|
|
318
|
+
'<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">',
|
|
319
|
+
' <RegistrationInfo>',
|
|
320
|
+
' <Description>Apra Fleet MCP server (per-user). Managed by apra-fleet install/start/stop/uninstall.</Description>',
|
|
321
|
+
' </RegistrationInfo>',
|
|
322
|
+
' <Triggers>',
|
|
323
|
+
' <LogonTrigger>',
|
|
324
|
+
' <Enabled>true</Enabled>',
|
|
325
|
+
` <UserId>${user}</UserId>`,
|
|
326
|
+
' </LogonTrigger>',
|
|
327
|
+
' <TimeTrigger>',
|
|
328
|
+
' <Repetition>',
|
|
329
|
+
` <Interval>PT${p.repeatMinutes}M</Interval>`,
|
|
330
|
+
' <StopAtDurationEnd>false</StopAtDurationEnd>',
|
|
331
|
+
' </Repetition>',
|
|
332
|
+
` <StartBoundary>${xmlEscape(p.startBoundary)}</StartBoundary>`,
|
|
333
|
+
' <Enabled>true</Enabled>',
|
|
334
|
+
' </TimeTrigger>',
|
|
335
|
+
' </Triggers>',
|
|
336
|
+
' <Principals>',
|
|
337
|
+
' <Principal id="Author">',
|
|
338
|
+
` <UserId>${user}</UserId>`,
|
|
339
|
+
' <LogonType>InteractiveToken</LogonType>',
|
|
340
|
+
' <RunLevel>LeastPrivilege</RunLevel>',
|
|
341
|
+
' </Principal>',
|
|
342
|
+
' </Principals>',
|
|
343
|
+
' <Settings>',
|
|
344
|
+
' <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>',
|
|
345
|
+
' <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>',
|
|
346
|
+
' <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>',
|
|
347
|
+
' <AllowHardTerminate>true</AllowHardTerminate>',
|
|
348
|
+
' <StartWhenAvailable>true</StartWhenAvailable>',
|
|
349
|
+
' <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>',
|
|
350
|
+
' <IdleSettings>',
|
|
351
|
+
' <StopOnIdleEnd>false</StopOnIdleEnd>',
|
|
352
|
+
' <RestartOnIdle>false</RestartOnIdle>',
|
|
353
|
+
' </IdleSettings>',
|
|
354
|
+
' <AllowStartOnDemand>true</AllowStartOnDemand>',
|
|
355
|
+
' <Enabled>true</Enabled>',
|
|
356
|
+
' <Hidden>false</Hidden>',
|
|
357
|
+
' <RunOnlyIfIdle>false</RunOnlyIfIdle>',
|
|
358
|
+
' <WakeToRun>false</WakeToRun>',
|
|
359
|
+
' <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>',
|
|
360
|
+
' <Priority>7</Priority>',
|
|
361
|
+
' </Settings>',
|
|
362
|
+
' <Actions Context="Author">',
|
|
363
|
+
' <Exec>',
|
|
364
|
+
` <Command>${xmlEscape(p.command)}</Command>`,
|
|
365
|
+
...(p.arguments ? [` <Arguments>${xmlEscape(p.arguments)}</Arguments>`] : []),
|
|
366
|
+
' </Exec>',
|
|
367
|
+
' </Actions>',
|
|
368
|
+
'</Task>',
|
|
369
|
+
'',
|
|
370
|
+
].join('\r\n');
|
|
371
|
+
}
|
|
372
|
+
/** UTF-16LE with BOM -- what schtasks /xml expects for a UTF-16 declaration. */
|
|
373
|
+
export function encodeTaskXml(xml) {
|
|
374
|
+
return Buffer.concat([Buffer.from([0xff, 0xfe]), Buffer.from(xml, 'utf16le')]);
|
|
23
375
|
}
|
|
24
376
|
export class WindowsServiceManager {
|
|
25
377
|
runSchtasks;
|
|
26
378
|
wrapperPath;
|
|
27
379
|
reusedExistingTask = false;
|
|
28
|
-
|
|
380
|
+
runReg;
|
|
381
|
+
env;
|
|
382
|
+
now;
|
|
383
|
+
whoami;
|
|
384
|
+
spawnDetached;
|
|
385
|
+
probeWsh;
|
|
386
|
+
stoppedByUser;
|
|
387
|
+
interactive;
|
|
388
|
+
noticePath;
|
|
389
|
+
constructor(runSchtasks = defaultSchtasksRunner, wrapperPath = WRAPPER_PATH, opts = {}) {
|
|
29
390
|
this.runSchtasks = runSchtasks;
|
|
30
391
|
this.wrapperPath = wrapperPath;
|
|
392
|
+
this.runReg = opts.runReg ?? defaultRegRunner;
|
|
393
|
+
this.env = opts.env ?? process.env;
|
|
394
|
+
this.now = opts.now ?? (() => new Date());
|
|
395
|
+
this.whoami = opts.whoami;
|
|
396
|
+
this.spawnDetached = opts.spawnDetached ?? defaultSpawnDetached;
|
|
397
|
+
this.probeWsh = opts.probeWsh ?? defaultProbeWsh;
|
|
398
|
+
this.stoppedByUser = opts.stoppedByUser ?? (() => readStoppedMarker() !== null);
|
|
399
|
+
this.interactive = opts.interactive ?? (() => !!process.stdout.isTTY);
|
|
400
|
+
this.noticePath = opts.noticePath ?? SERVICE_NOTICE_PATH;
|
|
31
401
|
}
|
|
32
402
|
async register(binaryPath, args, logPath) {
|
|
33
403
|
this.reusedExistingTask = false;
|
|
34
404
|
// The wrapper is rewritten BEFORE /create so that a reused task (below)
|
|
35
405
|
// also launches the new binary.
|
|
36
406
|
fs.mkdirSync(path.dirname(this.wrapperPath), { recursive: true });
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
fs.writeFileSync(this.wrapperPath, lines.join('\r\n'), 'utf8');
|
|
407
|
+
// The wrapper's >> redirect fails (exit 1, nothing logged) when the log
|
|
408
|
+
// dir is missing; create it now -- the wrapper also re-creates it.
|
|
40
409
|
try {
|
|
41
|
-
|
|
42
|
-
'/create', '/tn', WINDOWS_TASK_NAME,
|
|
43
|
-
'/tr', this.wrapperPath,
|
|
44
|
-
'/sc', 'onlogon', '/rl', 'limited', '/f',
|
|
45
|
-
]);
|
|
46
|
-
return 'created';
|
|
410
|
+
fs.mkdirSync(path.dirname(logPath), { recursive: true });
|
|
47
411
|
}
|
|
48
|
-
catch
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
412
|
+
catch { /* the wrapper retries */ }
|
|
413
|
+
fs.writeFileSync(this.wrapperPath, buildWrapperBat(binaryPath, args, logPath), 'utf8');
|
|
414
|
+
const launcherPath = launcherPathFor(this.wrapperPath);
|
|
415
|
+
fs.writeFileSync(launcherPath, buildLauncherJs(this.wrapperPath), 'utf8');
|
|
416
|
+
// S4: Windows Script Host can be disabled by policy; then the hidden
|
|
417
|
+
// launcher never runs. Fall back to running the .bat directly (a visible
|
|
418
|
+
// console window) and say so.
|
|
419
|
+
const hidden = this.probeWsh(this.env, path.dirname(this.wrapperPath));
|
|
420
|
+
// Applied only once we know what will launch the server: a task/Run entry
|
|
421
|
+
// registered for the .bat must leave no launcher behind (start() in
|
|
422
|
+
// Run-entry mode prefers it), but a reused task that already runs wscript +
|
|
423
|
+
// our launcher keeps it -- the probe can give a false negative (timeout
|
|
424
|
+
// under slow AV, failed probe-file write).
|
|
425
|
+
const visibleFallback = () => {
|
|
426
|
+
try {
|
|
427
|
+
fs.unlinkSync(launcherPath);
|
|
428
|
+
}
|
|
429
|
+
catch { /* absent */ }
|
|
430
|
+
console.warn(' Windows Script Host is unavailable, so the server cannot be launched hidden: it will run in a ' +
|
|
431
|
+
'visible console window. Do not close that window (closing it stops the server).');
|
|
432
|
+
};
|
|
433
|
+
const runValue = hidden ? `"${wscriptPath(this.env)}" ${launcherArguments(launcherPath)}` : `"${this.wrapperPath}"`;
|
|
434
|
+
const xmlPath = path.join(path.dirname(this.wrapperPath), 'apra-fleet-task.xml');
|
|
435
|
+
const xml = buildTaskXml({
|
|
436
|
+
command: hidden ? wscriptPath(this.env) : this.wrapperPath,
|
|
437
|
+
arguments: hidden ? launcherArguments(launcherPath) : undefined,
|
|
438
|
+
userId: resolveTaskUserId(this.whoami),
|
|
439
|
+
startBoundary: localStartBoundary(this.now()),
|
|
440
|
+
repeatMinutes: repeatMinutesFrom(this.env),
|
|
441
|
+
});
|
|
442
|
+
/** Registers the task from the XML; null on success, else the error message. */
|
|
443
|
+
const tryCreate = () => {
|
|
54
444
|
try {
|
|
55
|
-
|
|
445
|
+
fs.writeFileSync(xmlPath, encodeTaskXml(xml));
|
|
446
|
+
this.runSchtasks(['/create', '/tn', WINDOWS_TASK_NAME, '/xml', xmlPath, '/f']);
|
|
447
|
+
return null;
|
|
448
|
+
}
|
|
449
|
+
catch (createErr) {
|
|
450
|
+
return createErr.message;
|
|
451
|
+
}
|
|
452
|
+
finally {
|
|
453
|
+
try {
|
|
454
|
+
fs.unlinkSync(xmlPath);
|
|
455
|
+
}
|
|
456
|
+
catch { /* best-effort */ }
|
|
56
457
|
}
|
|
57
|
-
|
|
58
|
-
|
|
458
|
+
};
|
|
459
|
+
const created = () => {
|
|
460
|
+
// A task now covers logon autostart: drop a Run-key fallback left by an
|
|
461
|
+
// earlier install so the server is not launched twice at logon.
|
|
462
|
+
this.deleteRunKey();
|
|
463
|
+
clearServiceNotice(this.noticePath);
|
|
464
|
+
if (!hidden)
|
|
465
|
+
visibleFallback();
|
|
466
|
+
return 'created';
|
|
467
|
+
};
|
|
468
|
+
const createMsg = tryCreate();
|
|
469
|
+
if (createMsg === null)
|
|
470
|
+
return created();
|
|
471
|
+
// /create failed (typically "Access is denied" -- localized, so not
|
|
472
|
+
// matched -- when the existing task was created elevated): reuse the
|
|
473
|
+
// existing task only if it already runs our wrapper.
|
|
474
|
+
let command = null;
|
|
475
|
+
let taskArgs = null;
|
|
476
|
+
let existing = '';
|
|
477
|
+
let taskFound = false;
|
|
478
|
+
try {
|
|
479
|
+
existing = this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']);
|
|
480
|
+
command = taskXmlCommand(existing);
|
|
481
|
+
taskArgs = taskXmlArguments(existing);
|
|
482
|
+
taskFound = true;
|
|
483
|
+
}
|
|
484
|
+
catch { /* no task */ }
|
|
485
|
+
// Ours: the wrapper itself (tasks from earlier installs), the wrapper split
|
|
486
|
+
// at a space by 0.4.3's unquoted /tr (broken, so legacy), or wscript
|
|
487
|
+
// running our hidden launcher.
|
|
488
|
+
const runsWrapper = command !== null && normalizeTaskPath(command) === normalizeTaskPath(this.wrapperPath);
|
|
489
|
+
const runsSplit = runsSplitWrapper(command, taskArgs, this.wrapperPath);
|
|
490
|
+
const runsLauncher = runsOurLauncher(command, taskArgs, launcherPath);
|
|
491
|
+
/** Prints the manual fix for a legacy task /create could not replace, and persists it. */
|
|
492
|
+
const reportLegacy = (problems) => {
|
|
493
|
+
// /create was just refused, so this task cannot be disabled either.
|
|
494
|
+
// apra-fleet never elevates: the user gets the exact manual fix.
|
|
495
|
+
if (!problems.includes('elevated'))
|
|
496
|
+
problems.push('elevated');
|
|
497
|
+
const guidance = legacyTaskGuidance(problems);
|
|
498
|
+
console.warn(indent(guidance));
|
|
499
|
+
// A detached install (apra-fleet update) has no console: persist it
|
|
500
|
+
// for the next service verb (already shown when this one is
|
|
501
|
+
// interactive), and leave it in the service log.
|
|
502
|
+
writeServiceNotice(guidance, this.noticePath, new Date(), this.interactive());
|
|
503
|
+
appendServiceLog(logPath, guidance);
|
|
504
|
+
};
|
|
505
|
+
// A split task runs "C:\Users\John" and never starts the server: reusing
|
|
506
|
+
// it would leave no autostart. Report it and fall through to the HKCU Run
|
|
507
|
+
// entry below until the user replaces the task.
|
|
508
|
+
const splitTask = taskFound && runsSplit;
|
|
509
|
+
if (splitTask) {
|
|
510
|
+
const problems = legacyTaskProblems(existing, { launcherPath, launcherExpected: hidden, wrapperPath: this.wrapperPath });
|
|
511
|
+
if (!problems.includes('split-path'))
|
|
512
|
+
problems.push('split-path');
|
|
513
|
+
reportLegacy(problems);
|
|
514
|
+
}
|
|
515
|
+
else if (taskFound && (runsWrapper || runsLauncher)) {
|
|
516
|
+
const problems = legacyTaskProblems(existing, { launcherPath, launcherExpected: hidden, wrapperPath: this.wrapperPath });
|
|
517
|
+
if (problems.length > 0) {
|
|
518
|
+
reportLegacy(problems);
|
|
59
519
|
}
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
`not ${this.wrapperPath}: ${createMsg}`);
|
|
520
|
+
else {
|
|
521
|
+
clearServiceNotice(this.noticePath);
|
|
63
522
|
}
|
|
64
523
|
this.reusedExistingTask = true;
|
|
524
|
+
// A reused launcher task needs the launcher (written above); a reused
|
|
525
|
+
// .bat task runs visibly whatever the probe said.
|
|
526
|
+
if (runsWrapper && !hidden)
|
|
527
|
+
visibleFallback();
|
|
65
528
|
return 'reused';
|
|
66
529
|
}
|
|
530
|
+
if (taskFound && !splitTask) {
|
|
531
|
+
throw new Error(`schtasks /create failed and the existing ${WINDOWS_TASK_NAME} task runs ${command ?? '(unknown)'}, ` +
|
|
532
|
+
`not ${this.wrapperPath}: ${createMsg}`);
|
|
533
|
+
}
|
|
534
|
+
// Last resort: a per-user HKCU Run entry. Logon autostart only -- nothing
|
|
535
|
+
// revives a server that dies mid-session. Say WHY the task was refused:
|
|
536
|
+
// without it the fallback is undiagnosable.
|
|
537
|
+
console.warn(` schtasks /create failed: ${schtasksErrorReason(createMsg)}`);
|
|
538
|
+
if (!hidden)
|
|
539
|
+
visibleFallback();
|
|
540
|
+
if (!splitTask)
|
|
541
|
+
clearServiceNotice(this.noticePath);
|
|
542
|
+
try {
|
|
543
|
+
this.runReg(['add', RUN_KEY, '/v', RUN_VALUE, '/t', 'REG_SZ', '/d', runValue, '/f']);
|
|
544
|
+
}
|
|
545
|
+
catch (regErr) {
|
|
546
|
+
throw new Error(`schtasks /create failed and ${splitTask ? `the existing ${WINDOWS_TASK_NAME} task cannot start the server`
|
|
547
|
+
: `no existing ${WINDOWS_TASK_NAME} task was found`}: ${createMsg}; ` +
|
|
548
|
+
`the HKCU Run fallback also failed: ${regErr.message}`);
|
|
549
|
+
}
|
|
550
|
+
return 'run-key';
|
|
551
|
+
}
|
|
552
|
+
/** Problems of the installed task when it is a legacy one (empty: current or unreadable). */
|
|
553
|
+
installedLegacyProblems() {
|
|
554
|
+
try {
|
|
555
|
+
const raw = this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']);
|
|
556
|
+
return this.legacyProblemsOf(raw);
|
|
557
|
+
}
|
|
558
|
+
catch {
|
|
559
|
+
return [];
|
|
560
|
+
}
|
|
561
|
+
}
|
|
562
|
+
legacyProblemsOf(raw) {
|
|
563
|
+
const launcherPath = launcherPathFor(this.wrapperPath);
|
|
564
|
+
// Only OUR task (wrapper, split wrapper, or wscript + our launcher) gets
|
|
565
|
+
// upgrade advice: a foreign task named ApraFleet must not be told to
|
|
566
|
+
// delete itself.
|
|
567
|
+
const command = taskXmlCommand(raw);
|
|
568
|
+
const args = taskXmlArguments(raw);
|
|
569
|
+
const ours = (command !== null && normalizeTaskPath(command) === normalizeTaskPath(this.wrapperPath))
|
|
570
|
+
|| runsSplitWrapper(command, args, this.wrapperPath)
|
|
571
|
+
|| runsOurLauncher(command, args, launcherPath);
|
|
572
|
+
if (!ours)
|
|
573
|
+
return [];
|
|
574
|
+
// install keeps the launcher only when the task should use it (WSH works).
|
|
575
|
+
let launcherExpected = false;
|
|
576
|
+
try {
|
|
577
|
+
launcherExpected = fs.existsSync(launcherPath);
|
|
578
|
+
}
|
|
579
|
+
catch { /* treat as absent */ }
|
|
580
|
+
return legacyTaskProblems(raw, { launcherPath, launcherExpected, wrapperPath: this.wrapperPath });
|
|
67
581
|
}
|
|
68
582
|
async unregister() {
|
|
69
583
|
try {
|
|
70
|
-
|
|
584
|
+
this.runSchtasks(['/delete', '/tn', WINDOWS_TASK_NAME, '/f']);
|
|
71
585
|
}
|
|
72
586
|
catch {
|
|
73
587
|
// Tolerate task-not-found
|
|
74
588
|
}
|
|
589
|
+
this.deleteRunKey();
|
|
590
|
+
clearServiceNotice(this.noticePath);
|
|
591
|
+
try {
|
|
592
|
+
fs.unlinkSync(this.wrapperPath);
|
|
593
|
+
}
|
|
594
|
+
catch { }
|
|
75
595
|
try {
|
|
76
|
-
fs.unlinkSync(
|
|
596
|
+
fs.unlinkSync(launcherPathFor(this.wrapperPath));
|
|
77
597
|
}
|
|
78
598
|
catch { }
|
|
79
599
|
}
|
|
80
600
|
async start() {
|
|
601
|
+
// An explicit start is never skipped by the failed-start backoff.
|
|
602
|
+
clearServiceStartFailures();
|
|
603
|
+
const task = this.taskExists();
|
|
604
|
+
// A 0.4.3 task split at a space never starts the server: install then
|
|
605
|
+
// added the Run entry, which start must use instead of the task. (A task
|
|
606
|
+
// this install just reused is never a split one.)
|
|
607
|
+
if (!task || (!this.reusedExistingTask && this.runKeyExists()
|
|
608
|
+
&& this.installedLegacyProblems().includes('split-path'))) {
|
|
609
|
+
if (this.runKeyExists()) {
|
|
610
|
+
// HKCU Run fallback: no task to run -- launch the way the Run entry
|
|
611
|
+
// does: the hidden launcher, or (no launcher) cmd with the wrapper
|
|
612
|
+
// quoted verbatim so a path with & or spaces stays one argument.
|
|
613
|
+
const launcher = launcherPathFor(this.wrapperPath);
|
|
614
|
+
if (fs.existsSync(launcher)) {
|
|
615
|
+
this.spawnDetached(wscriptPath(this.env), ['//B', '//Nologo', '//E:JScript', launcher]);
|
|
616
|
+
}
|
|
617
|
+
else {
|
|
618
|
+
this.spawnDetached('cmd.exe', ['/d', '/s', '/c', `""${this.wrapperPath}""`], true);
|
|
619
|
+
}
|
|
620
|
+
return;
|
|
621
|
+
}
|
|
622
|
+
throw new Error(`no ${WINDOWS_TASK_NAME} task or HKCU Run entry is registered -- run apra-fleet install`);
|
|
623
|
+
}
|
|
624
|
+
// A user stop disabled the task (so its revive trigger cannot undo the
|
|
625
|
+
// stop); starting re-enables it. A disabled task also refuses /run.
|
|
626
|
+
// Best-effort: a reused (elevated) task may refuse /change, and /run
|
|
627
|
+
// below then surfaces the real failure.
|
|
628
|
+
try {
|
|
629
|
+
this.runSchtasks(['/change', '/tn', WINDOWS_TASK_NAME, '/enable']);
|
|
630
|
+
}
|
|
631
|
+
catch { /* see above */ }
|
|
81
632
|
if (this.reusedExistingTask) {
|
|
82
633
|
// Reused task: run synchronously so a failure is surfaced, not swallowed.
|
|
83
634
|
try {
|
|
@@ -88,44 +639,110 @@ export class WindowsServiceManager {
|
|
|
88
639
|
}
|
|
89
640
|
return;
|
|
90
641
|
}
|
|
91
|
-
//
|
|
92
|
-
//
|
|
93
|
-
|
|
94
|
-
const { spawn } = await import('node:child_process');
|
|
95
|
-
const child = spawn('schtasks', ['/run', '/tn', WINDOWS_TASK_NAME], {
|
|
96
|
-
detached: true, stdio: 'ignore',
|
|
97
|
-
});
|
|
98
|
-
child.unref();
|
|
642
|
+
// Detached so schtasks /run does not block the installer (on some Windows
|
|
643
|
+
// versions it waits for the launched process).
|
|
644
|
+
this.spawnDetached('schtasks', ['/run', '/tn', WINDOWS_TASK_NAME]);
|
|
99
645
|
}
|
|
100
646
|
async stop() {
|
|
101
|
-
|
|
647
|
+
// Disable FIRST: the task's repeating trigger would otherwise relaunch the
|
|
648
|
+
// server within one interval, undoing a deliberate stop. start/install
|
|
649
|
+
// re-enable it.
|
|
650
|
+
if (this.taskExists()) {
|
|
102
651
|
try {
|
|
103
|
-
|
|
652
|
+
this.runSchtasks(['/change', '/tn', WINDOWS_TASK_NAME, '/disable']);
|
|
653
|
+
}
|
|
654
|
+
catch (err) {
|
|
655
|
+
console.warn(`Could not disable the ${WINDOWS_TASK_NAME} task (${err.message.trim()}).`);
|
|
656
|
+
const problems = this.installedLegacyProblems();
|
|
657
|
+
if (problems.length > 0) {
|
|
658
|
+
// Disabling was just refused, whatever the XML says.
|
|
659
|
+
if (!problems.includes('elevated'))
|
|
660
|
+
problems.push('elevated');
|
|
661
|
+
console.warn(legacyTaskGuidance(problems));
|
|
662
|
+
}
|
|
663
|
+
// The stopped-by-user marker (written by apra-fleet stop) makes every
|
|
664
|
+
// service launch exit without starting the server.
|
|
665
|
+
console.warn("A stop made with 'apra-fleet stop' still holds: until 'apra-fleet start', every launch of the task " +
|
|
666
|
+
'exits without starting the server.');
|
|
667
|
+
}
|
|
668
|
+
}
|
|
669
|
+
return gracefulStopByServerJson((pid) => {
|
|
670
|
+
try {
|
|
671
|
+
quietExec('taskkill', ['/F', '/PID', String(pid)]);
|
|
104
672
|
}
|
|
105
673
|
catch { }
|
|
106
674
|
});
|
|
107
675
|
}
|
|
108
676
|
async query() {
|
|
677
|
+
let out;
|
|
109
678
|
try {
|
|
110
|
-
|
|
111
|
-
// CSV line: "TaskName","Next Run Time","Status"
|
|
112
|
-
const line = out.trim().split(/\r?\n/)[0] ?? '';
|
|
113
|
-
const cols = line.split('","');
|
|
114
|
-
const status = (cols[2] ?? '').replace(/"/g, '').trim();
|
|
115
|
-
return { installed: true, running: status === 'Running' };
|
|
679
|
+
out = decodeSchtasks(this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/fo', 'csv', '/nh']));
|
|
116
680
|
}
|
|
117
681
|
catch {
|
|
682
|
+
if (this.runKeyExists()) {
|
|
683
|
+
return {
|
|
684
|
+
installed: true, running: false, enabled: true,
|
|
685
|
+
detail: 'logon autostart via HKCU Run -- no automatic restart; re-run apra-fleet install to retry the task',
|
|
686
|
+
};
|
|
687
|
+
}
|
|
118
688
|
return { installed: false, running: false };
|
|
119
689
|
}
|
|
690
|
+
// CSV line: "TaskName","Next Run Time","Status"
|
|
691
|
+
const line = out.trim().split(/\r?\n/)[0] ?? '';
|
|
692
|
+
const cols = line.split('","');
|
|
693
|
+
const status = (cols[2] ?? '').replace(/"/g, '').trim();
|
|
694
|
+
// GitHub #585: report enabled, so status no longer shows every installed
|
|
695
|
+
// task as "installed (disabled)". If the XML query itself fails the task
|
|
696
|
+
// still exists (the CSV query just answered), so default to enabled.
|
|
697
|
+
let enabled = true;
|
|
698
|
+
let legacy = [];
|
|
699
|
+
try {
|
|
700
|
+
const raw = this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME, '/xml']);
|
|
701
|
+
enabled = taskXmlEnabled(raw);
|
|
702
|
+
legacy = this.legacyProblemsOf(raw);
|
|
703
|
+
}
|
|
704
|
+
catch { /* keep defaults */ }
|
|
705
|
+
const result = { installed: true, running: status === 'Running', enabled };
|
|
706
|
+
const details = [];
|
|
707
|
+
if (!enabled) {
|
|
708
|
+
details.push(this.stoppedByUser()
|
|
709
|
+
? "stopped by user -- 'apra-fleet start' re-enables it"
|
|
710
|
+
: "task disabled outside apra-fleet -- 'apra-fleet start' re-enables it");
|
|
711
|
+
}
|
|
712
|
+
if (legacy.length > 0) {
|
|
713
|
+
details.push(legacyTaskDetail(legacy));
|
|
714
|
+
result.notice = legacyTaskFix(legacy);
|
|
715
|
+
}
|
|
716
|
+
if (details.length > 0)
|
|
717
|
+
result.detail = details.join('; ');
|
|
718
|
+
return result;
|
|
120
719
|
}
|
|
121
720
|
async isInstalled() {
|
|
721
|
+
return this.taskExists() || this.runKeyExists();
|
|
722
|
+
}
|
|
723
|
+
taskExists() {
|
|
724
|
+
try {
|
|
725
|
+
this.runSchtasks(['/query', '/tn', WINDOWS_TASK_NAME]);
|
|
726
|
+
return true;
|
|
727
|
+
}
|
|
728
|
+
catch {
|
|
729
|
+
return false;
|
|
730
|
+
}
|
|
731
|
+
}
|
|
732
|
+
runKeyExists() {
|
|
122
733
|
try {
|
|
123
|
-
|
|
734
|
+
this.runReg(['query', RUN_KEY, '/v', RUN_VALUE]);
|
|
124
735
|
return true;
|
|
125
736
|
}
|
|
126
737
|
catch {
|
|
127
738
|
return false;
|
|
128
739
|
}
|
|
129
740
|
}
|
|
741
|
+
deleteRunKey() {
|
|
742
|
+
try {
|
|
743
|
+
this.runReg(['delete', RUN_KEY, '/v', RUN_VALUE, '/f']);
|
|
744
|
+
}
|
|
745
|
+
catch { /* absent */ }
|
|
746
|
+
}
|
|
130
747
|
}
|
|
131
748
|
//# sourceMappingURL=windows.js.map
|