@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- 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 +42 -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 +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- 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/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- 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 +62 -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 +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -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 +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- 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/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- 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 +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -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 +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- 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 +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -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 +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -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 +115 -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 +352 -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 +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -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/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -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/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- 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 +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- 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/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- 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 +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -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 +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- 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 +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- 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 +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- 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 +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- 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 +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- 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/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- 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 +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- 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/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- 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 +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- 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 +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -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-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -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 +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- 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 +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- 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-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- 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 +1896 -305
- 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 +454 -1
- 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 +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- 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 +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -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 +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -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 +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- 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/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- 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 +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -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 +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -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 +499 -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 +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/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
|
@@ -15,10 +15,11 @@
|
|
|
15
15
|
"./viewer/run-state-paths": "./src/viewer/run-state-paths.mjs",
|
|
16
16
|
"./viewer/sprint-state-paths": "./src/viewer/sprint-state-paths.mjs",
|
|
17
17
|
"./viewer/debounced-writer": "./src/viewer/debounced-writer.mjs",
|
|
18
|
-
"./viewer/lean-state": "./src/viewer/lean-state.mjs"
|
|
18
|
+
"./viewer/lean-state": "./src/viewer/lean-state.mjs",
|
|
19
|
+
"./viewer/request-guard": "./src/viewer/request-guard.mjs"
|
|
19
20
|
},
|
|
20
21
|
"scripts": {
|
|
21
|
-
"test": "node --test --test-timeout=60000 test/*.test.mjs"
|
|
22
|
+
"test": "node ../../scripts/with-test-sandbox.mjs node --test --test-timeout=60000 test/*.test.mjs"
|
|
22
23
|
},
|
|
23
24
|
"type": "module",
|
|
24
25
|
"dependencies": {
|
|
@@ -8,6 +8,9 @@ import { getRunningRunStatePath, getTerminalRunStatePath } from './run-state-pat
|
|
|
8
8
|
import { buildListStatePayload, resolveStringRefs } from './lean-state.mjs';
|
|
9
9
|
import { capCommandActivityMeta, getFullOutput } from './command-output-cap.mjs';
|
|
10
10
|
import { buildRunTitle } from './run-title.mjs';
|
|
11
|
+
import { billedTokens } from '../workflow/pricing.mjs';
|
|
12
|
+
import { createRunSummary, refreshSummaryCore, applyExtensionSummary, backfillExtensionSummaries } from './run-summary.mjs';
|
|
13
|
+
import { checkMutatingRequest, checkRequestHost } from './request-guard.mjs';
|
|
11
14
|
|
|
12
15
|
// apra-fleet-eft.6.5: the SAME template serves both the live view and the
|
|
13
16
|
// process-free History view -- `opts.history` (true) feeds a FROZEN state
|
|
@@ -21,7 +24,7 @@ import { buildRunTitle } from './run-title.mjs';
|
|
|
21
24
|
const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
22
25
|
const isHistory = !!opts.history;
|
|
23
26
|
const frozenStateLiteral = isHistory
|
|
24
|
-
? JSON.stringify(opts.state ?? null).replace(/</g, '\\u003c')
|
|
27
|
+
? JSON.stringify(backfillExtensionSummaries(opts.state ?? null, dashboardExtensions) ?? null).replace(/</g, '\\u003c')
|
|
25
28
|
: 'null';
|
|
26
29
|
return `<!DOCTYPE html>
|
|
27
30
|
<html lang="en">
|
|
@@ -71,6 +74,9 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
71
74
|
/* (apra-fleet-p2to.2.1) 'paused since <ts>' badge + reason card,
|
|
72
75
|
generic to every workflow run -- no per-workflow-type styling. */
|
|
73
76
|
.pause-banner { background: rgba(245, 158, 11, 0.12); border-color: rgba(245, 158, 11, 0.4); color: var(--warning); }
|
|
77
|
+
/* Header-level extension banner slots (see the markup below the header). */
|
|
78
|
+
.extension-banners { flex-shrink: 0; }
|
|
79
|
+
.extension-banner { max-height: 45vh; overflow-y: auto; }
|
|
74
80
|
|
|
75
81
|
/* min-height: 0 on every rung of the flex chain: a flex item's default
|
|
76
82
|
min-height is content-sized, which lets a tall Activity list push the
|
|
@@ -223,6 +229,13 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
223
229
|
${isHistory ? '' : '<button class="btn btn-stop" onclick="stopWorkflow()">Stop</button>'}
|
|
224
230
|
</div>
|
|
225
231
|
</div>
|
|
232
|
+
<!-- Header-level banner slot per dashboard extension: OUTSIDE every tab
|
|
233
|
+
panel, so whatever an extension renders here stays visible whichever
|
|
234
|
+
tab is active (e.g. a run-wide notice that needs the operator's
|
|
235
|
+
attention). Core never fills or shows these; the extension's own js
|
|
236
|
+
does (document.getElementById('extension-banner-' + id)). Live view
|
|
237
|
+
only, like the pause banner: a finished run has nothing to act on. -->
|
|
238
|
+
${isHistory ? '' : `<div class="extension-banners" id="extension-banners">${dashboardExtensions.map(ext => `<div id="extension-banner-${ext.id}" class="extension-banner" style="display: none;"></div>`).join('')}</div>`}
|
|
226
239
|
${isHistory ? '' : `<div class="modal-overlay" id="stop-modal-overlay">
|
|
227
240
|
<div class="modal-box">
|
|
228
241
|
<p>Are you sure you want to forcibly stop the workflow?</p>
|
|
@@ -237,7 +250,7 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
237
250
|
<div class="content-area">
|
|
238
251
|
<div class="tab-bar" id="tab-bar">
|
|
239
252
|
<button class="tab-btn active" onclick="switchTab('core')">Activity Tree</button>
|
|
240
|
-
${dashboardExtensions.map(ext => `<button class="tab-btn" onclick="switchTab('${ext.id}')">${ext.title}</button>`).join('
|
|
253
|
+
${dashboardExtensions.map(ext => `<button class="tab-btn" onclick="switchTab('${ext.id}')">${ext.title}</button>`).join('\n')}
|
|
241
254
|
</div>
|
|
242
255
|
<div id="tab-core" class="tab-content active panel">
|
|
243
256
|
<div class="panel-header" style="display: flex; justify-content: space-between; align-items: center;">
|
|
@@ -254,10 +267,10 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
254
267
|
</div>
|
|
255
268
|
<div id="extension-${ext.id}" style="flex: 1; min-height: 0; padding: 12px; overflow-y: auto;"></div>
|
|
256
269
|
</div>
|
|
257
|
-
`).join('
|
|
270
|
+
`).join('\n')}
|
|
258
271
|
</div>
|
|
259
272
|
</div>
|
|
260
|
-
${dashboardExtensions.map(ext => `<script>\n${ext.js}\n</script>`).join('
|
|
273
|
+
${dashboardExtensions.map(ext => `<script>\n${ext.js}\n</script>`).join('\n')}
|
|
261
274
|
<script>
|
|
262
275
|
let globalState = null;
|
|
263
276
|
function switchTab(id) {
|
|
@@ -360,7 +373,7 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
360
373
|
|
|
361
374
|
async function confirmStopWorkflow() {
|
|
362
375
|
closeStopModal();
|
|
363
|
-
await fetch('/stop', { method: 'POST' });
|
|
376
|
+
await fetch('/stop', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}' });
|
|
364
377
|
showStopToast();
|
|
365
378
|
}
|
|
366
379
|
|
|
@@ -376,10 +389,10 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
376
389
|
// tick, below. That keeps the button truthful about what the engine has
|
|
377
390
|
// ACTUALLY done rather than what the browser merely asked for.
|
|
378
391
|
async function pauseWorkflow() {
|
|
379
|
-
await fetch('/pause', { method: 'POST' });
|
|
392
|
+
await fetch('/pause', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}' });
|
|
380
393
|
}
|
|
381
394
|
async function resumeWorkflow() {
|
|
382
|
-
await fetch('/resume', { method: 'POST' });
|
|
395
|
+
await fetch('/resume', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}' });
|
|
383
396
|
}
|
|
384
397
|
|
|
385
398
|
|
|
@@ -487,6 +500,8 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
487
500
|
source.onmessage = (e) => {
|
|
488
501
|
const ev = JSON.parse(e.data);
|
|
489
502
|
if (ev.type === 'state') {
|
|
503
|
+
// Summary first, then state (same order as renderState's hand-off).
|
|
504
|
+
document.dispatchEvent(new CustomEvent('workflow:summary:' + ev.payload.namespace, { detail: ev.payload.summary ?? null }));
|
|
490
505
|
const extEvent = new CustomEvent('workflow:state:' + ev.payload.namespace, { detail: ev.payload.data });
|
|
491
506
|
document.dispatchEvent(extEvent);
|
|
492
507
|
}
|
|
@@ -739,7 +754,7 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
739
754
|
// tier was never displayed at all. modelHtml surfaces
|
|
740
755
|
// act.model (e.g. "premium"/"standard", already
|
|
741
756
|
// present on every agent activity) explicitly.
|
|
742
|
-
let tokensHtml = act.usage ? \`<span style="color:var(--text-muted)">\${act.usage.total_tokens.toLocaleString()} tkns</span>\` : (act.type === 'agent' && !act.isRunning ? \`<span style="color:var(--text-muted)">n/a</span>\` : '');
|
|
757
|
+
let tokensHtml = act.usage ? \`<span style="color:var(--text-muted)">\${((act.usage.total_tokens || 0) + (act.usage.cache_read_input_tokens || 0) + (act.usage.cache_creation_input_tokens || 0)).toLocaleString()} tkns</span>\` : (act.type === 'agent' && !act.isRunning ? \`<span style="color:var(--text-muted)">n/a</span>\` : '');
|
|
743
758
|
const modelHtml = (act.type === 'agent' && act.model) ? \`<span style="color:var(--text-muted)">[\${escapeHtml(act.model)}]</span>\` : '';
|
|
744
759
|
const memberDisplay = act.member ? escapeHtml(act.member) : (act.type === 'transform' ? 'js' : '');
|
|
745
760
|
const memberHtml = memberDisplay ? \`<span class="muted">(\${memberDisplay})</span>\` : '';
|
|
@@ -892,6 +907,17 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
892
907
|
|
|
893
908
|
renderTreeIncremental(state.tree);
|
|
894
909
|
|
|
910
|
+
// Generic per-namespace summary hand-off (GET /state?summary=1's
|
|
911
|
+
// extensions map, computed server-side once per publish): dispatched
|
|
912
|
+
// BEFORE the matching workflow:state:NS event so an extension can
|
|
913
|
+
// cache it and render from it on that event. detail is null when
|
|
914
|
+
// the namespace has no summary yet.
|
|
915
|
+
const summaryExts = (state.summary && state.summary.extensions) || {};
|
|
916
|
+
const summaryNamespaces = new Set([...Object.keys(state.extensions || {}), ...Object.keys(summaryExts)]);
|
|
917
|
+
for (const ns of summaryNamespaces) {
|
|
918
|
+
document.dispatchEvent(new CustomEvent('workflow:summary:' + ns, { detail: summaryExts[ns] || null }));
|
|
919
|
+
}
|
|
920
|
+
|
|
895
921
|
if (state.extensions) {
|
|
896
922
|
for (const [ns, data] of Object.entries(state.extensions)) {
|
|
897
923
|
const extEvent = new CustomEvent('workflow:state:' + ns, { detail: data });
|
|
@@ -959,6 +985,20 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
|
|
|
959
985
|
// module). Reads from the LIVE, full-fidelity in-memory `state.tree` (never
|
|
960
986
|
// the leaned /state payload), which is where an uncapped activity's complete
|
|
961
987
|
// output/error text still lives.
|
|
988
|
+
// Upper bound on a POST /extensions/:extId/actions/:actionId request body.
|
|
989
|
+
const ACTION_BODY_MAX_BYTES = 64 * 1024;
|
|
990
|
+
|
|
991
|
+
// True for GET /state?summary=1 (any extra query params, e.g. a _t
|
|
992
|
+
// cache-buster, allowed); false for plain /state and /state?_t=....
|
|
993
|
+
function isSummaryRequest(url) {
|
|
994
|
+
try {
|
|
995
|
+
const u = new URL(url, 'http://localhost');
|
|
996
|
+
return u.pathname === '/state' && u.searchParams.get('summary') === '1';
|
|
997
|
+
} catch {
|
|
998
|
+
return false;
|
|
999
|
+
}
|
|
1000
|
+
}
|
|
1001
|
+
|
|
962
1002
|
function findActivityById(state, id) {
|
|
963
1003
|
for (const g of state.tree || []) {
|
|
964
1004
|
for (const p of g.phases || []) {
|
|
@@ -983,6 +1023,11 @@ export { HTML_TEMPLATE };
|
|
|
983
1023
|
* @param {import('../workflow/index.mjs').FleetWorkflow} workflow
|
|
984
1024
|
* @param {Object} opts - Options object
|
|
985
1025
|
* @param {number} [opts.port=8080] - HTTP server port
|
|
1026
|
+
* @param {string} [opts.host='127.0.0.1'] - Interface to bind. Loopback by default; pass '0.0.0.0' (or a
|
|
1027
|
+
* specific address) to expose the dashboard off-box -- an explicit opt-in.
|
|
1028
|
+
* @param {string[]|string} [opts.allowedHosts] - Extra Host header names this server answers to. Loopback
|
|
1029
|
+
* names, IP literals and `host` are always accepted; any other name is refused on every request
|
|
1030
|
+
* (DNS-rebinding defence, request-guard.mjs checkRequestHost()).
|
|
986
1031
|
* @param {string} [opts.runId] - Stable per-run identifier (generated if not provided)
|
|
987
1032
|
* @param {string} [opts.name] - Workflow display name
|
|
988
1033
|
* @param {string} [opts.debouncedStatePath] - Path to write state JSON (uses default if not provided)
|
|
@@ -997,6 +1042,7 @@ export { HTML_TEMPLATE };
|
|
|
997
1042
|
*/
|
|
998
1043
|
export function createDashboardViewer(workflow, opts = {}) {
|
|
999
1044
|
const port = (typeof opts.port === 'number') ? opts.port : 8080;
|
|
1045
|
+
const host = (typeof opts.host === 'string' && opts.host) ? opts.host : '127.0.0.1';
|
|
1000
1046
|
const dashboardExtensions = opts.dashboardExtensions || [];
|
|
1001
1047
|
|
|
1002
1048
|
// apra-fleet-eft.2.3 (renamed under eft.37.1): stable per-run id, NOT an
|
|
@@ -1085,7 +1131,11 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1085
1131
|
// any workflow -- no fleet-sprint-specific fields.
|
|
1086
1132
|
pause: { status: 'none', reason: null, since: null, phase: null, group: null, resumeAt: null },
|
|
1087
1133
|
tree: [],
|
|
1088
|
-
extensions: {}
|
|
1134
|
+
extensions: {},
|
|
1135
|
+
// Small, fixed-shape progress summary served at GET /state?summary=1
|
|
1136
|
+
// (run-summary.mjs). Core fields are refreshed on every broadcast;
|
|
1137
|
+
// extensions.<ns> is recomputed only when <ns> is published.
|
|
1138
|
+
summary: createRunSummary(runId)
|
|
1089
1139
|
};
|
|
1090
1140
|
|
|
1091
1141
|
// Note: group/phase tracking is single-run by design (single-tenant usage).
|
|
@@ -1102,6 +1152,8 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1102
1152
|
let currentPhase = { title: 'Initialization', phaseStartedAt: startedAtIso, phaseEndedAt: null, events: [] };
|
|
1103
1153
|
currentGroup.phases.push(currentPhase);
|
|
1104
1154
|
state.tree.push(currentGroup);
|
|
1155
|
+
const refreshSummary = () => refreshSummaryCore(state.summary, state, currentPhase ? currentPhase.title : null);
|
|
1156
|
+
refreshSummary();
|
|
1105
1157
|
|
|
1106
1158
|
const clients = new Set();
|
|
1107
1159
|
const broadcast = (data) => {
|
|
@@ -1113,6 +1165,10 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1113
1165
|
// mid-run read of the persisted file reflects in-progress state
|
|
1114
1166
|
// rather than only the terminal snapshot.
|
|
1115
1167
|
state.updatedAt = nowIso();
|
|
1168
|
+
// Every lifecycle change (end, pause events, phase, activity
|
|
1169
|
+
// stats) reaches here, so the summary's core fields stay current
|
|
1170
|
+
// without any extension hook being called.
|
|
1171
|
+
refreshSummary();
|
|
1116
1172
|
debouncedWriter.schedule();
|
|
1117
1173
|
};
|
|
1118
1174
|
|
|
@@ -1229,6 +1285,7 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1229
1285
|
}
|
|
1230
1286
|
state.endedAt = nowIso();
|
|
1231
1287
|
state.terminalReason = state.terminalReason || 'SIGINT';
|
|
1288
|
+
refreshSummary();
|
|
1232
1289
|
persistState();
|
|
1233
1290
|
// apra-fleet-eft.2.1: flush any coalesced-but-not-yet-written
|
|
1234
1291
|
// debounced state synchronously before the process actually exits,
|
|
@@ -1249,6 +1306,7 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1249
1306
|
}
|
|
1250
1307
|
state.endedAt = nowIso();
|
|
1251
1308
|
state.terminalReason = state.terminalReason || 'SIGTERM';
|
|
1309
|
+
refreshSummary();
|
|
1252
1310
|
persistState();
|
|
1253
1311
|
debouncedWriter.flushSync();
|
|
1254
1312
|
moveStateToOldRuns();
|
|
@@ -1306,7 +1364,9 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1306
1364
|
}
|
|
1307
1365
|
}
|
|
1308
1366
|
}
|
|
1309
|
-
|
|
1367
|
+
// Every billed token, including prompt-cache reads/writes (which
|
|
1368
|
+
// usage.total_tokens -- the context-admission figure -- excludes).
|
|
1369
|
+
if (meta.usage) state.stats.totalTokens += billedTokens(meta.usage);
|
|
1310
1370
|
// apra-fleet-unw.4: `cost` is only added to the running total when
|
|
1311
1371
|
// it's a known number. When agent() explicitly reported cost: null
|
|
1312
1372
|
// (fleet result had no usage, or the model wasn't in the pricing
|
|
@@ -1326,7 +1386,11 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1326
1386
|
|
|
1327
1387
|
workflow.on('state', (stateData) => {
|
|
1328
1388
|
state.extensions[stateData.namespace] = stateData.data;
|
|
1329
|
-
|
|
1389
|
+
// Once-per-publish: only the extension registered for THIS
|
|
1390
|
+
// namespace (if it opts in with summarize()) is asked to summarize;
|
|
1391
|
+
// a throwing hook is logged and its previous summary kept.
|
|
1392
|
+
applyExtensionSummary(state.summary, dashboardExtensions, stateData.namespace, stateData.data, nowIso());
|
|
1393
|
+
broadcast({ type: 'state', payload: { ...stateData, summary: state.summary.extensions[stateData.namespace] ?? null } });
|
|
1330
1394
|
});
|
|
1331
1395
|
|
|
1332
1396
|
// (apra-fleet-p2to.2.1) Generic pause lifecycle wiring, mirroring how
|
|
@@ -1407,6 +1471,21 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1407
1471
|
});
|
|
1408
1472
|
|
|
1409
1473
|
const server = http.createServer((req, res) => {
|
|
1474
|
+
// Cross-site request forgery guard (request-guard.mjs): this server
|
|
1475
|
+
// listens on a loopback port any visited web page could POST to, and
|
|
1476
|
+
// its POST routes stop/pause the run or record an operator answer. A
|
|
1477
|
+
// mutating request must be JSON and same-origin (no Origin: the
|
|
1478
|
+
// supervisor's proxy and HTTP clients; or this page's own origin).
|
|
1479
|
+
// The Host header is checked on EVERY request (GET /state included):
|
|
1480
|
+
// a DNS-rebound page controls Origin and Host alike.
|
|
1481
|
+
const hostOpts = { bindHost: host, allowedHosts: opts.allowedHosts };
|
|
1482
|
+
const refused = checkRequestHost(req, hostOpts) || checkMutatingRequest(req, hostOpts);
|
|
1483
|
+
if (refused) {
|
|
1484
|
+
if (typeof req.resume === 'function') req.resume();
|
|
1485
|
+
res.writeHead(refused.status, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' });
|
|
1486
|
+
res.end(JSON.stringify({ error: refused.error }));
|
|
1487
|
+
return;
|
|
1488
|
+
}
|
|
1410
1489
|
if (req.url === '/') {
|
|
1411
1490
|
res.writeHead(200, { 'Content-Type': 'text/html' });
|
|
1412
1491
|
res.end(HTML_TEMPLATE(dashboardExtensions));
|
|
@@ -1414,6 +1493,12 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1414
1493
|
res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Connection': 'keep-alive', 'Cache-Control': 'no-cache' });
|
|
1415
1494
|
clients.add(res);
|
|
1416
1495
|
req.on('close', () => clients.delete(res));
|
|
1496
|
+
} else if (req.url.startsWith('/state') && isSummaryRequest(req.url)) {
|
|
1497
|
+
// GET /state?summary=1: the small precomputed run summary only
|
|
1498
|
+
// (run-summary.mjs) -- no tree, no string table, no raw
|
|
1499
|
+
// extension data. Never calls any summarize() hook.
|
|
1500
|
+
res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store, no-cache, must-revalidate, proxy-revalidate' });
|
|
1501
|
+
res.end(JSON.stringify(state.summary));
|
|
1417
1502
|
} else if (req.url.startsWith('/state')) {
|
|
1418
1503
|
// apra-fleet-eft.27.1: GET /state is the RECURRING poll endpoint
|
|
1419
1504
|
// (every ~250ms-400ms while a run is live) -- it must never
|
|
@@ -1428,7 +1513,12 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1428
1513
|
// the configured snapshot dir and running/<runId>.json, and what
|
|
1429
1514
|
// the process-free History view embeds) is never mutated by this.
|
|
1430
1515
|
res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store, no-cache, must-revalidate, proxy-revalidate' });
|
|
1431
|
-
|
|
1516
|
+
// The small top-level `summary` is attached AFTER the
|
|
1517
|
+
// leanify/dedupe pass: it repeats short top-level strings
|
|
1518
|
+
// (runId, updatedAt, ...) and must not turn them into $ref
|
|
1519
|
+
// markers for consumers that read the plain payload unresolved.
|
|
1520
|
+
const { summary, ...rest } = state;
|
|
1521
|
+
res.end(JSON.stringify({ ...buildListStatePayload(rest), summary }));
|
|
1432
1522
|
} else if (req.method === 'GET' && /^\/extensions\/[^/]+\/detail\/[^/]+$/.test(req.url)) {
|
|
1433
1523
|
// apra-fleet-eft.37.4 (M3): the GENERIC on-demand-detail route.
|
|
1434
1524
|
// Any dashboard extension may register a `detailLookup(state, id)`
|
|
@@ -1457,6 +1547,50 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1457
1547
|
text: detail.text || '',
|
|
1458
1548
|
updatedAt: detail.updatedAt ?? null
|
|
1459
1549
|
}));
|
|
1550
|
+
} else if (req.method === 'POST' && /^\/extensions\/[^/]+\/actions\/[^/]+$/.test(req.url)) {
|
|
1551
|
+
// GENERIC extension action route (mirrors the detail route above):
|
|
1552
|
+
// an extension may register `actions: { <actionId>(ctx) }`, where
|
|
1553
|
+
// ctx = { body, state } with `body` the parsed JSON request body
|
|
1554
|
+
// (bounded to ACTION_BODY_MAX_BYTES). The action returns
|
|
1555
|
+
// { status?, body? } (sync or async). Core never names a specific
|
|
1556
|
+
// extension or action; an unknown extension/action is a 404, a
|
|
1557
|
+
// malformed or oversized body a 400, a throwing action a 500.
|
|
1558
|
+
const match = req.url.match(/^\/extensions\/([^/]+)\/actions\/([^/]+)$/);
|
|
1559
|
+
const extId = decodeURIComponent(match[1]);
|
|
1560
|
+
const actionId = decodeURIComponent(match[2]);
|
|
1561
|
+
const ext = dashboardExtensions.find((e) => e.id === extId);
|
|
1562
|
+
const action = ext && ext.actions && Object.prototype.hasOwnProperty.call(ext.actions, actionId) ? ext.actions[actionId] : null;
|
|
1563
|
+
const reply = (status, body) => {
|
|
1564
|
+
res.writeHead(status, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' });
|
|
1565
|
+
res.end(JSON.stringify(body));
|
|
1566
|
+
};
|
|
1567
|
+
if (typeof action !== 'function') {
|
|
1568
|
+
reply(404, { error: 'action not found', extension: extId, action: actionId });
|
|
1569
|
+
return;
|
|
1570
|
+
}
|
|
1571
|
+
const chunks = [];
|
|
1572
|
+
let size = 0;
|
|
1573
|
+
let tooBig = false;
|
|
1574
|
+
req.on('data', (c) => {
|
|
1575
|
+
size += c.length;
|
|
1576
|
+
if (size > ACTION_BODY_MAX_BYTES) { tooBig = true; return; }
|
|
1577
|
+
chunks.push(c);
|
|
1578
|
+
});
|
|
1579
|
+
req.on('end', async () => {
|
|
1580
|
+
if (tooBig) { reply(400, { error: 'request body too large' }); return; }
|
|
1581
|
+
let body = {};
|
|
1582
|
+
const raw = Buffer.concat(chunks).toString('utf-8');
|
|
1583
|
+
if (raw.trim()) {
|
|
1584
|
+
try { body = JSON.parse(raw); } catch { reply(400, { error: 'request body is not valid JSON' }); return; }
|
|
1585
|
+
}
|
|
1586
|
+
try {
|
|
1587
|
+
const out = (await action({ body, state })) || {};
|
|
1588
|
+
reply(Number.isInteger(out.status) ? out.status : 200, out.body === undefined ? {} : out.body);
|
|
1589
|
+
} catch (err) {
|
|
1590
|
+
console.error('[Viewer] extension action failed:', err && err.message ? err.message : err);
|
|
1591
|
+
reply(500, { error: 'action failed' });
|
|
1592
|
+
}
|
|
1593
|
+
});
|
|
1460
1594
|
} else if (req.method === 'GET' && /^\/beads\/[^/]+\/description$/.test(req.url)) {
|
|
1461
1595
|
// BOUNDARY-COMPAT (apra-fleet-eft.37.4, one release only, then
|
|
1462
1596
|
// dies per docs/workflow-core-boundary-refactoring.md M3): the
|
|
@@ -1594,8 +1728,10 @@ export function createDashboardViewer(workflow, opts = {}) {
|
|
|
1594
1728
|
}
|
|
1595
1729
|
});
|
|
1596
1730
|
|
|
1597
|
-
server.listen(port, () => {
|
|
1598
|
-
|
|
1731
|
+
server.listen(port, host, () => {
|
|
1732
|
+
const bound = server.address();
|
|
1733
|
+
const shown = (bound.address === '0.0.0.0' || bound.address === '::') ? '127.0.0.1' : bound.address;
|
|
1734
|
+
console.log(`[Viewer] Workflow Dashboard live at http://${shown}:${bound.port}`);
|
|
1599
1735
|
});
|
|
1600
1736
|
|
|
1601
1737
|
workflow.on('end', () => {
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Mutating-request guard (cross-site request forgery defence)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// Shared by the supervisor's route() dispatcher (apra-fleet-se
|
|
6
|
+
// src/supervisor/server.mjs) and the per-run dashboard viewer's own POST
|
|
7
|
+
// routes (./index.mjs). Both bind loopback HTTP servers whose POST routes
|
|
8
|
+
// change state (record an operator answer, launch/stop a run, shut down), so
|
|
9
|
+
// any web page the operator happens to visit could otherwise fire a plain HTML
|
|
10
|
+
// form POST at them.
|
|
11
|
+
//
|
|
12
|
+
// Every non-GET/HEAD/OPTIONS request must:
|
|
13
|
+
// (a) carry Content-Type application/json -- a browser can only send that
|
|
14
|
+
// cross-site after a CORS preflight, which these servers never approve,
|
|
15
|
+
// and an HTML form can never send it at all; and
|
|
16
|
+
// (b) be same-origin: no Origin header (a non-browser client: curl, the
|
|
17
|
+
// sprint child's HTTP clients, a server-side proxy) or an Origin whose
|
|
18
|
+
// host equals the request's own Host; a Sec-Fetch-Site of cross-site or
|
|
19
|
+
// same-site is refused too -- UNLESS it carries a valid token
|
|
20
|
+
// (`Authorization: Bearer <token>` or `X-Fleet-Token: <token>`) and a
|
|
21
|
+
// token is configured.
|
|
22
|
+
// A presented token that does not match is always refused, even when the
|
|
23
|
+
// request would otherwise pass the origin check.
|
|
24
|
+
//
|
|
25
|
+
// DNS rebinding: (b) compares the Origin with the request's Host header, and a
|
|
26
|
+
// rebound page (attacker.example re-resolved to 127.0.0.1) controls BOTH and
|
|
27
|
+
// makes them agree. So the Host header is validated first, on EVERY request
|
|
28
|
+
// (GET included -- a rebound page could otherwise read /api/sprints, /state):
|
|
29
|
+
// checkRequestHost() admits only a Host whose name is a loopback name
|
|
30
|
+
// (localhost, 127.0.0.1, [::1]), any IP literal (a page served from an IP
|
|
31
|
+
// literal is served by that IP, so it cannot rebind to us), the server's own
|
|
32
|
+
// configured bind host (unless a wildcard), or an explicitly allowed extra
|
|
33
|
+
// name. The port is not compared: a rebinding attacker cannot choose the NAME
|
|
34
|
+
// the browser puts in Host, and a same-machine port-forward/reverse proxy
|
|
35
|
+
// legitimately changes the port. A token does not waive the Host check (a
|
|
36
|
+
// non-browser token holder sends a real name anyway).
|
|
37
|
+
// =============================================================================
|
|
38
|
+
|
|
39
|
+
import crypto from 'node:crypto';
|
|
40
|
+
import net from 'node:net';
|
|
41
|
+
|
|
42
|
+
const SAFE_METHODS = new Set(['GET', 'HEAD', 'OPTIONS']);
|
|
43
|
+
|
|
44
|
+
/** Header a client may use instead of `Authorization: Bearer`. */
|
|
45
|
+
export const TOKEN_HEADER = 'x-fleet-token';
|
|
46
|
+
|
|
47
|
+
function headerValue(req, name) {
|
|
48
|
+
const v = req && req.headers ? req.headers[name] : undefined;
|
|
49
|
+
if (Array.isArray(v)) return v[0];
|
|
50
|
+
return typeof v === 'string' ? v : undefined;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function presentedToken(req) {
|
|
54
|
+
const auth = headerValue(req, 'authorization');
|
|
55
|
+
if (auth) {
|
|
56
|
+
// No regex: a prefix check cannot backtrack on a hostile header.
|
|
57
|
+
const a = auth.trim();
|
|
58
|
+
if (a.length > 7 && a.slice(0, 6).toLowerCase() === 'bearer' && /^\s$/.test(a[6])) {
|
|
59
|
+
const tok = a.slice(7).trim();
|
|
60
|
+
if (tok) return tok;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
const t = headerValue(req, TOKEN_HEADER);
|
|
64
|
+
return t ? t.trim() : undefined;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function tokensEqual(a, b) {
|
|
68
|
+
const ba = Buffer.from(String(a), 'utf-8');
|
|
69
|
+
const bb = Buffer.from(String(b), 'utf-8');
|
|
70
|
+
if (ba.length !== bb.length) return false;
|
|
71
|
+
return crypto.timingSafeEqual(ba, bb);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** True when the request's Content-Type media type is application/json. */
|
|
75
|
+
export function isJsonContentType(req) {
|
|
76
|
+
const ct = headerValue(req, 'content-type');
|
|
77
|
+
if (!ct) return false;
|
|
78
|
+
return ct.split(';')[0].trim().toLowerCase() === 'application/json';
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
const LOOPBACK_NAMES = new Set(['localhost', '127.0.0.1', '[::1]']);
|
|
82
|
+
const WILDCARD_BIND_HOSTS = new Set(['', '0.0.0.0', '::', '[::]']);
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Normalises a host name or `host[:port]` value to the lowercase hostname a
|
|
86
|
+
* WHATWG URL would report (IPv6 bracketed, trailing dot dropped), or null when
|
|
87
|
+
* it does not parse.
|
|
88
|
+
* @param {string} value
|
|
89
|
+
* @returns {string|null}
|
|
90
|
+
*/
|
|
91
|
+
export function normalizeHostName(value) {
|
|
92
|
+
let v = String(value ?? '').trim();
|
|
93
|
+
if (!v) return null;
|
|
94
|
+
// A bare IPv6 literal (bind host '::1') needs brackets to parse as a host.
|
|
95
|
+
if (!v.startsWith('[') && net.isIPv6(v)) v = `[${v}]`;
|
|
96
|
+
try {
|
|
97
|
+
const u = new URL(`http://${v}`);
|
|
98
|
+
if (u.username || u.password || (u.pathname && u.pathname !== '/') || u.search || u.hash) return null;
|
|
99
|
+
const name = u.hostname.toLowerCase().replace(/\.$/, '');
|
|
100
|
+
return name || null;
|
|
101
|
+
} catch {
|
|
102
|
+
return null;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Parses a comma/whitespace separated allowed-hosts list (an env var or CLI
|
|
108
|
+
* value) into normalised host names; unparseable entries are dropped.
|
|
109
|
+
* @param {string|string[]|null|undefined} value
|
|
110
|
+
* @returns {string[]}
|
|
111
|
+
*/
|
|
112
|
+
export function parseAllowedHosts(value) {
|
|
113
|
+
const parts = Array.isArray(value) ? value.flatMap((v) => String(v).split(/[\s,]+/)) : String(value ?? '').split(/[\s,]+/);
|
|
114
|
+
return parts.map(normalizeHostName).filter(Boolean);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function isIpLiteralHost(name) {
|
|
118
|
+
const bare = name.startsWith('[') && name.endsWith(']') ? name.slice(1, -1) : name;
|
|
119
|
+
return net.isIP(bare) !== 0;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Validates the request's Host header (DNS-rebinding defence). Applies to every
|
|
124
|
+
* method. A request with no Host header (HTTP/1.0, some raw clients) is
|
|
125
|
+
* admitted: a browser always sends one.
|
|
126
|
+
*
|
|
127
|
+
* @param {import('node:http').IncomingMessage} req
|
|
128
|
+
* @param {{ bindHost?: string|null, allowedHosts?: string[]|string|null, allowedHostsHint?: string }} [opts]
|
|
129
|
+
* `allowedHostsHint`: embedder-specific remedy text appended to the 403
|
|
130
|
+
* (e.g. the CLI flag or env var that sets `allowedHosts`); `bindHost`: the interface the server bound (admitted as a name unless it
|
|
131
|
+
* is a wildcard such as 0.0.0.0); `allowedHosts`: extra names to admit (for
|
|
132
|
+
* an off-box bind reached by DNS name).
|
|
133
|
+
* @returns {null | { status: number, error: string }}
|
|
134
|
+
*/
|
|
135
|
+
export function checkRequestHost(req, opts = {}) {
|
|
136
|
+
const raw = headerValue(req, 'host');
|
|
137
|
+
if (raw === undefined || raw.trim() === '') return null;
|
|
138
|
+
const name = normalizeHostName(raw);
|
|
139
|
+
if (name) {
|
|
140
|
+
if (LOOPBACK_NAMES.has(name) || isIpLiteralHost(name)) return null;
|
|
141
|
+
const bind = opts.bindHost ? String(opts.bindHost).trim().toLowerCase() : '';
|
|
142
|
+
if (!WILDCARD_BIND_HOSTS.has(bind) && normalizeHostName(bind) === name) return null;
|
|
143
|
+
if (parseAllowedHosts(opts.allowedHosts).includes(name)) return null;
|
|
144
|
+
}
|
|
145
|
+
return {
|
|
146
|
+
status: 403,
|
|
147
|
+
error: `request refused: Host '${raw}' is not a name this server answers to (possible DNS rebinding); add it to the server's allowed hosts if it is legitimate${opts.allowedHostsHint ? ` (${opts.allowedHostsHint})` : ''}`,
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Decides whether a request may reach a mutating route. Also runs
|
|
153
|
+
* checkRequestHost() first, so a rebound page whose Origin and Host agree on a
|
|
154
|
+
* foreign name is refused.
|
|
155
|
+
*
|
|
156
|
+
* @param {import('node:http').IncomingMessage} req
|
|
157
|
+
* @param {{ token?: string|null, bindHost?: string|null, allowedHosts?: string[]|string|null }} [opts] -
|
|
158
|
+
* `token`: the accepted token, or empty/absent when no token mechanism is
|
|
159
|
+
* configured (then only same-origin requests pass); `bindHost` and
|
|
160
|
+
* `allowedHosts`: see checkRequestHost().
|
|
161
|
+
* @returns {null | { status: number, error: string }} null when allowed, else
|
|
162
|
+
* the status and message to answer with.
|
|
163
|
+
*/
|
|
164
|
+
export function checkMutatingRequest(req, opts = {}) {
|
|
165
|
+
const method = String((req && req.method) || 'GET').toUpperCase();
|
|
166
|
+
if (SAFE_METHODS.has(method)) return null;
|
|
167
|
+
|
|
168
|
+
const badHost = checkRequestHost(req, opts);
|
|
169
|
+
if (badHost) return badHost;
|
|
170
|
+
|
|
171
|
+
if (!isJsonContentType(req)) {
|
|
172
|
+
return {
|
|
173
|
+
status: 415,
|
|
174
|
+
error: `${method} requests must send Content-Type: application/json (form, multipart and text/plain bodies are refused); set that header and send a JSON body`,
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
const configured = typeof opts.token === 'string' && opts.token.length > 0 ? opts.token : null;
|
|
179
|
+
const presented = presentedToken(req);
|
|
180
|
+
if (presented !== undefined) {
|
|
181
|
+
if (configured && tokensEqual(presented, configured)) return null;
|
|
182
|
+
if (!configured) {
|
|
183
|
+
// Never blame the token: this server simply has no token mechanism.
|
|
184
|
+
return {
|
|
185
|
+
status: 403,
|
|
186
|
+
error: 'this server accepts no token (it takes same-origin requests only, or requests forwarded by its parent proxy); drop the Authorization / X-Fleet-Token header and resend the request without it',
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
return { status: 403, error: 'invalid token' };
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
const fetchSite = (headerValue(req, 'sec-fetch-site') || '').trim().toLowerCase();
|
|
193
|
+
if (fetchSite === 'cross-site' || fetchSite === 'same-site') {
|
|
194
|
+
return { status: 403, error: `cross-site request refused (Sec-Fetch-Site: ${fetchSite})` };
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
const origin = headerValue(req, 'origin');
|
|
198
|
+
if (origin !== undefined) {
|
|
199
|
+
const host = (headerValue(req, 'host') || '').trim().toLowerCase();
|
|
200
|
+
let originHost = null;
|
|
201
|
+
try {
|
|
202
|
+
const u = new URL(origin);
|
|
203
|
+
if (u.protocol === 'http:' || u.protocol === 'https:') originHost = u.host.toLowerCase();
|
|
204
|
+
} catch { /* 'null' or malformed -- refused below */ }
|
|
205
|
+
if (!originHost || !host || originHost !== host) {
|
|
206
|
+
return { status: 403, error: `cross-site request refused (Origin ${origin} is not this server's origin)` };
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
return null;
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Header names a same-host proxy must drop when forwarding a request it has
|
|
214
|
+
* already admitted with checkMutatingRequest(): the browser's Origin and fetch
|
|
215
|
+
* metadata describe the PROXY's origin, which the upstream (a different port)
|
|
216
|
+
* would otherwise read as cross-site, and the proxy's own token means nothing
|
|
217
|
+
* upstream (a presented-but-unknown token is refused there).
|
|
218
|
+
*/
|
|
219
|
+
export const ADMITTED_REQUEST_STRIP_HEADERS = Object.freeze([
|
|
220
|
+
'origin', 'referer', 'sec-fetch-site', 'sec-fetch-mode', 'sec-fetch-dest', 'sec-fetch-user',
|
|
221
|
+
'authorization', TOKEN_HEADER,
|
|
222
|
+
]);
|