@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
|
@@ -6,9 +6,11 @@ import { FLEET_DIR } from '../paths.js';
|
|
|
6
6
|
import { createKbProviders } from '../services/knowledge/kb-providers.js';
|
|
7
7
|
import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
8
8
|
import { HttpKbProvider } from '../services/knowledge/http-provider.js';
|
|
9
|
-
import { validateFilePaths } from '../services/knowledge/path-validation.js';
|
|
9
|
+
import { validateFilePaths, isAbsoluteOrTraversing } from '../services/knowledge/path-validation.js';
|
|
10
10
|
import { encryptPassword, decryptPassword } from '../utils/crypto.js';
|
|
11
|
+
import { validateAuthor } from '../tools/kb-feedback.js';
|
|
11
12
|
import { KbCaptureRejected } from '../services/knowledge/types.js';
|
|
13
|
+
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
12
14
|
// my-beads-db-0cd.15 (reopened): startKbServer is an exported library function
|
|
13
15
|
// that tests/knowledge/kb-server.test.ts imports and calls IN-PROCESS. The
|
|
14
16
|
// http-provider refusal used to call process.exit(1) directly, which would
|
|
@@ -25,6 +27,22 @@ export class KbServerHttpProviderRefusedError extends Error {
|
|
|
25
27
|
}
|
|
26
28
|
}
|
|
27
29
|
const MAX_BODY_SIZE = 1_048_576; // 1MB
|
|
30
|
+
/** Header every HttpKbProvider request carries: the project slug it is for. */
|
|
31
|
+
export const KB_PROJECT_HEADER = 'x-kb-project';
|
|
32
|
+
/** What GET /api/kb/capabilities answers: every contract route (the server always serves a local SQLite KB). */
|
|
33
|
+
export const KB_SERVER_CAPABILITIES = Object.freeze({
|
|
34
|
+
contract: 'v1',
|
|
35
|
+
routes: Object.freeze(['capture', 'query', 'promote', 'context', 'prime', 'invalidate', 'feedback', 'list', 'demote']),
|
|
36
|
+
branch_aware: false,
|
|
37
|
+
});
|
|
38
|
+
/** A demote refusal's taxonomy code at the start of SqliteProvider.demote's message (answered 422). */
|
|
39
|
+
const DEMOTE_REFUSAL_CODE = /^(E-DEMOTE-[A-Z-]+):/;
|
|
40
|
+
/**
|
|
41
|
+
* How SqliteProvider.promote's refusals of the promote ladder begin
|
|
42
|
+
* (superseded, user-directive, unresolved basis; trivial reason). Only these
|
|
43
|
+
* are 422 PROMOTE_REFUSED; any other promote error is a server fault (500).
|
|
44
|
+
*/
|
|
45
|
+
const PROMOTE_REFUSAL_PREFIXES = ['Cannot promote ', 'kb_promote requires a reason'];
|
|
28
46
|
const RATE_LIMIT_WINDOW_MS = 60_000;
|
|
29
47
|
const RATE_LIMIT_MAX = 100;
|
|
30
48
|
const TOKEN_DIR = path.join(FLEET_DIR, 'knowledge');
|
|
@@ -87,15 +105,55 @@ function readBody(req) {
|
|
|
87
105
|
req.on('error', reject);
|
|
88
106
|
});
|
|
89
107
|
}
|
|
108
|
+
/**
|
|
109
|
+
* A query parameter carrying a JSON array of strings: undefined when absent,
|
|
110
|
+
* null when present but not such an array (the caller answers 400).
|
|
111
|
+
*/
|
|
112
|
+
function stringArrayParam(url, name) {
|
|
113
|
+
const raw = url.searchParams.get(name);
|
|
114
|
+
if (!raw)
|
|
115
|
+
return undefined;
|
|
116
|
+
let parsed;
|
|
117
|
+
try {
|
|
118
|
+
parsed = JSON.parse(raw);
|
|
119
|
+
}
|
|
120
|
+
catch {
|
|
121
|
+
return null;
|
|
122
|
+
}
|
|
123
|
+
return Array.isArray(parsed) && parsed.every(t => typeof t === 'string') ? parsed : null;
|
|
124
|
+
}
|
|
90
125
|
function getClientIp(req) {
|
|
91
126
|
return req.socket.remoteAddress || '0.0.0.0';
|
|
92
127
|
}
|
|
93
|
-
|
|
128
|
+
const TOKEN_FILE_POLL_MS = 250;
|
|
129
|
+
function readTokenFile(tokenFile) {
|
|
130
|
+
let raw;
|
|
131
|
+
try {
|
|
132
|
+
raw = fs.readFileSync(tokenFile, 'utf-8');
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
throw new Error(`cannot read token file ${tokenFile}`);
|
|
136
|
+
}
|
|
137
|
+
const token = raw.trim();
|
|
138
|
+
if (!token)
|
|
139
|
+
throw new Error(`token file ${tokenFile} is empty`);
|
|
140
|
+
return token;
|
|
141
|
+
}
|
|
142
|
+
export async function startKbServer(port, generateToken, dbPath, tokenFile) {
|
|
143
|
+
if (tokenFile && generateToken) {
|
|
144
|
+
throw new Error('--generate-token cannot be combined with --token-file: the token comes from the file');
|
|
145
|
+
}
|
|
146
|
+
// Fail before any side effect when the token file is unusable.
|
|
147
|
+
let serverToken;
|
|
148
|
+
if (tokenFile) {
|
|
149
|
+
serverToken = readTokenFile(tokenFile);
|
|
150
|
+
}
|
|
94
151
|
if (generateToken) {
|
|
95
152
|
const token = generateNewToken();
|
|
96
153
|
process.stderr.write(`KB server token: ${token}\n`);
|
|
97
154
|
}
|
|
98
|
-
|
|
155
|
+
if (!tokenFile)
|
|
156
|
+
serverToken = getOrCreateToken();
|
|
99
157
|
const providers = await createKbProviders();
|
|
100
158
|
// KB server is a server, not a client: it must never silently become a
|
|
101
159
|
// self-proxying HttpKbProvider just because the local KB config selects
|
|
@@ -107,9 +165,8 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
107
165
|
// and never self-proxies -- the hazard this refusal exists for cannot arise.
|
|
108
166
|
// The check therefore reads the CONFIG-selected provider, before the --db
|
|
109
167
|
// override replaces it, and only refuses when there is no --db. Either way
|
|
110
|
-
// the HttpKbProvider createKbProviders() already built is disposed first
|
|
111
|
-
//
|
|
112
|
-
// dispose() removes, so dropping it undisposed would leak one per start.
|
|
168
|
+
// the HttpKbProvider createKbProviders() already built is disposed first, as
|
|
169
|
+
// every retired provider is.
|
|
113
170
|
if (providers.project instanceof HttpKbProvider) {
|
|
114
171
|
providers.project.dispose();
|
|
115
172
|
if (!dbPath) {
|
|
@@ -120,6 +177,15 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
120
177
|
`explicit local database.`);
|
|
121
178
|
}
|
|
122
179
|
}
|
|
180
|
+
// The --db override is built here, not taken from the shared provider cache,
|
|
181
|
+
// so this server owns it and must close it on shutdown: an open sqlite
|
|
182
|
+
// handle keeps the file locked (Windows refuses to delete it).
|
|
183
|
+
let ownedProvider;
|
|
184
|
+
const releaseOwnedProvider = () => {
|
|
185
|
+
const p = ownedProvider;
|
|
186
|
+
ownedProvider = undefined;
|
|
187
|
+
p?.close();
|
|
188
|
+
};
|
|
123
189
|
if (dbPath) {
|
|
124
190
|
const { SqliteProvider } = await import('../services/knowledge/sqlite-provider.js');
|
|
125
191
|
// Anchor capture basis checks at process.cwd(), the same repo root
|
|
@@ -128,9 +194,14 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
128
194
|
const overrideProvider = new SqliteProvider(dbPath, process.cwd());
|
|
129
195
|
await overrideProvider.init();
|
|
130
196
|
providers.project = overrideProvider;
|
|
197
|
+
ownedProvider = overrideProvider;
|
|
131
198
|
}
|
|
132
|
-
|
|
133
|
-
|
|
199
|
+
// Always a SqliteProvider here: an http config is refused above unless --db
|
|
200
|
+
// replaced it, and the project provider is otherwise SQLite.
|
|
201
|
+
const provider = requireSqliteProject(providers.project, 'kb serve');
|
|
202
|
+
const serverProject = providers.projectSlug;
|
|
203
|
+
process.stderr.write('[kb-server] project=' + serverProject + '\n');
|
|
204
|
+
let lastTokenWarning;
|
|
134
205
|
const server = http.createServer(async (req, res) => {
|
|
135
206
|
const ip = getClientIp(req);
|
|
136
207
|
const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
|
|
@@ -154,6 +225,25 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
154
225
|
if (token !== serverToken) {
|
|
155
226
|
return jsonResponse(res, 401, { error: 'Invalid token', code: 'UNAUTHORIZED' });
|
|
156
227
|
}
|
|
228
|
+
// One server serves one project. A request for another project (or one
|
|
229
|
+
// that names none) is refused on every route, so a client pointed at the
|
|
230
|
+
// wrong server never reads or writes another repo's KB.
|
|
231
|
+
const clientProject = req.headers[KB_PROJECT_HEADER];
|
|
232
|
+
if (clientProject !== serverProject) {
|
|
233
|
+
const named = typeof clientProject === 'string' ? clientProject : '(none)';
|
|
234
|
+
return jsonResponse(res, 409, {
|
|
235
|
+
error: `KB project mismatch: this server serves "${serverProject}", the request is for "${named}"`,
|
|
236
|
+
code: 'PROJECT_MISMATCH',
|
|
237
|
+
server_project: serverProject,
|
|
238
|
+
client_project: named,
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
// GET /api/kb/capabilities -- same auth and project check as every route.
|
|
242
|
+
// Lists every contract route, and keeps one KB per project
|
|
243
|
+
// with no per-branch truth (X-Repository-Branch is not used).
|
|
244
|
+
if (pathname === '/api/kb/capabilities' && method === 'GET') {
|
|
245
|
+
return jsonResponse(res, 200, KB_SERVER_CAPABILITIES);
|
|
246
|
+
}
|
|
157
247
|
try {
|
|
158
248
|
// POST /api/kb/capture
|
|
159
249
|
if (pathname === '/api/kb/capture' && method === 'POST') {
|
|
@@ -170,9 +260,132 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
170
260
|
const type = url.searchParams.get('type') || undefined;
|
|
171
261
|
const limit = url.searchParams.has('limit') ? parseInt(url.searchParams.get('limit'), 10) : undefined;
|
|
172
262
|
const l1_only = url.searchParams.get('l1_only') === 'true';
|
|
173
|
-
const
|
|
263
|
+
const confidence = url.searchParams.get('confidence')
|
|
264
|
+
?.split(',')
|
|
265
|
+
.filter((c) => c === 'CONFIRMED' || c === 'INFERRED' || c === 'UNVERIFIED');
|
|
266
|
+
const exclude_disputed = url.searchParams.get('exclude_disputed') === 'true';
|
|
267
|
+
// tag: exact-match tag filter (HttpKbProvider uses it for the member
|
|
268
|
+
// own-scope lookup, tag=member:<uuid>); a tag alone lists every entry
|
|
269
|
+
// carrying it. include_stale / include_superseded as in kb_query.
|
|
270
|
+
const tag = url.searchParams.get('tag') || undefined;
|
|
271
|
+
const include_stale = url.searchParams.get('include_stale') === 'true';
|
|
272
|
+
const include_superseded = url.searchParams.get('include_superseded') === 'true';
|
|
273
|
+
// flagged_only: list only contradiction-flagged entries (the
|
|
274
|
+
// kb_query flagged_only branch); the trust filters are ignored then.
|
|
275
|
+
const flagged_only = url.searchParams.get('flagged_only') === 'true';
|
|
276
|
+
// fts_terms: JSON array of discrete terms, OR-joined as an FTS match
|
|
277
|
+
// (the kb_session_prime neighbour query sends only these).
|
|
278
|
+
const fts_terms = stringArrayParam(url, 'fts_terms');
|
|
279
|
+
// ids: JSON array of entry ids, an exact-id lookup (kb_query's L2 fetch).
|
|
280
|
+
const ids = stringArrayParam(url, 'ids');
|
|
281
|
+
if (fts_terms === null || ids === null) {
|
|
282
|
+
const name = fts_terms === null ? 'fts_terms' : 'ids';
|
|
283
|
+
return jsonResponse(res, 400, { error: `${name} must be a JSON array of strings`, code: 'BAD_REQUEST' });
|
|
284
|
+
}
|
|
285
|
+
const result = await provider.query({
|
|
286
|
+
query, type, tag, limit, l1_only, confidence, exclude_disputed, include_stale, include_superseded,
|
|
287
|
+
flagged_only, fts_terms, ids,
|
|
288
|
+
});
|
|
174
289
|
return jsonResponse(res, 200, result);
|
|
175
290
|
}
|
|
291
|
+
// GET /api/kb/list -- the no-bump read (provider.list): use_count and
|
|
292
|
+
// last_accessed are left alone. HttpKbProvider's member own-scope lookup
|
|
293
|
+
// uses it, so checking ownership is not counted as a retrieval.
|
|
294
|
+
if (pathname === '/api/kb/list' && method === 'GET') {
|
|
295
|
+
const confidence = url.searchParams.get('confidence')
|
|
296
|
+
?.split(',')
|
|
297
|
+
.filter((c) => c === 'CONFIRMED' || c === 'INFERRED' || c === 'UNVERIFIED');
|
|
298
|
+
// type/module/symbol/exclude_disputed: the kb_list filters, so a
|
|
299
|
+
// MEMBER kb_list's own half (HttpKbProvider.list) is filtered here.
|
|
300
|
+
const results = await provider.list({
|
|
301
|
+
tag: url.searchParams.get('tag') || undefined,
|
|
302
|
+
confidence,
|
|
303
|
+
type: (url.searchParams.get('type') || undefined),
|
|
304
|
+
module: url.searchParams.get('module') || undefined,
|
|
305
|
+
symbol: url.searchParams.get('symbol') || undefined,
|
|
306
|
+
exclude_disputed: url.searchParams.get('exclude_disputed') === 'true',
|
|
307
|
+
limit: url.searchParams.has('limit') ? parseInt(url.searchParams.get('limit'), 10) : undefined,
|
|
308
|
+
include_stale: url.searchParams.get('include_stale') === 'true',
|
|
309
|
+
});
|
|
310
|
+
return jsonResponse(res, 200, { results, total: results.length });
|
|
311
|
+
}
|
|
312
|
+
// POST /api/kb/promote {id, reason} -> {id, previous_confidence, new_confidence}
|
|
313
|
+
// Same reply shape as the kb_promote tool. An unknown id is 404
|
|
314
|
+
// ENTRY_NOT_FOUND (the code an optional id route such as demote needs
|
|
315
|
+
// for "entry unknown" rather than "route not served"); any
|
|
316
|
+
// other refusal of the promote ladder (reason, superseded, directive,
|
|
317
|
+
// unresolved basis) is 422 with the provider's message.
|
|
318
|
+
if (pathname === '/api/kb/promote' && method === 'POST') {
|
|
319
|
+
const { id, reason } = JSON.parse(await readBody(req));
|
|
320
|
+
if (typeof id !== 'string' || id.length === 0) {
|
|
321
|
+
return jsonResponse(res, 400, { error: 'id must be a non-empty string', code: 'BAD_REQUEST' });
|
|
322
|
+
}
|
|
323
|
+
if (reason !== undefined && typeof reason !== 'string') {
|
|
324
|
+
return jsonResponse(res, 400, { error: 'reason must be a string', code: 'BAD_REQUEST' });
|
|
325
|
+
}
|
|
326
|
+
try {
|
|
327
|
+
const result = await provider.promote(id, reason);
|
|
328
|
+
return jsonResponse(res, 200, {
|
|
329
|
+
id: result.id,
|
|
330
|
+
previous_confidence: result.confidence_before,
|
|
331
|
+
new_confidence: result.confidence_after,
|
|
332
|
+
});
|
|
333
|
+
}
|
|
334
|
+
catch (err) {
|
|
335
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
336
|
+
if (message.startsWith('Entry not found')) {
|
|
337
|
+
return jsonResponse(res, 404, { error: message, code: 'ENTRY_NOT_FOUND' });
|
|
338
|
+
}
|
|
339
|
+
if (PROMOTE_REFUSAL_PREFIXES.some(prefix => message.startsWith(prefix))) {
|
|
340
|
+
return jsonResponse(res, 422, { error: message, code: 'PROMOTE_REFUSED' });
|
|
341
|
+
}
|
|
342
|
+
// Not a refusal (e.g. a database failure): the generic 500 below.
|
|
343
|
+
throw err;
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
// POST /api/kb/demote {id, reason, evidence_files} -> {id, previous_confidence, new_confidence}
|
|
347
|
+
// Backed by SqliteProvider.demote. evidence_files are untrusted:
|
|
348
|
+
// repo-relative to the repository this server serves (spec 2.9.1). An
|
|
349
|
+
// absolute or '..' path is refused first, before the id is looked up,
|
|
350
|
+
// whatever the platform's own path rules; the rest resolve against the
|
|
351
|
+
// served checkout. An unknown id is 404 ENTRY_NOT_FOUND; every demote
|
|
352
|
+
// refusal is 422 with its E-DEMOTE-* code; anything else is a 500.
|
|
353
|
+
if (pathname === '/api/kb/demote' && method === 'POST') {
|
|
354
|
+
const { id, reason, evidence_files: evidence } = JSON.parse(await readBody(req));
|
|
355
|
+
if (typeof id !== 'string' || id.length === 0 || typeof reason !== 'string'
|
|
356
|
+
|| !Array.isArray(evidence) || !evidence.every((f) => typeof f === 'string')) {
|
|
357
|
+
return jsonResponse(res, 400, {
|
|
358
|
+
error: 'id must be a non-empty string, reason a string and evidence_files an array of strings',
|
|
359
|
+
code: 'BAD_REQUEST',
|
|
360
|
+
});
|
|
361
|
+
}
|
|
362
|
+
const outside = evidence.filter(isAbsoluteOrTraversing);
|
|
363
|
+
if (outside.length > 0) {
|
|
364
|
+
return jsonResponse(res, 422, {
|
|
365
|
+
error: `E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote evidence is absolute or contains a '..' segment: ${outside.join(', ')}. Entry: ${id}`,
|
|
366
|
+
code: 'E-DEMOTE-EVIDENCE-UNRESOLVED',
|
|
367
|
+
});
|
|
368
|
+
}
|
|
369
|
+
try {
|
|
370
|
+
const result = await provider.demote(id, reason, evidence);
|
|
371
|
+
return jsonResponse(res, 200, {
|
|
372
|
+
id: result.id,
|
|
373
|
+
previous_confidence: result.confidence_before,
|
|
374
|
+
new_confidence: result.confidence_after,
|
|
375
|
+
});
|
|
376
|
+
}
|
|
377
|
+
catch (err) {
|
|
378
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
379
|
+
if (message.startsWith('Entry not found')) {
|
|
380
|
+
return jsonResponse(res, 404, { error: message, code: 'ENTRY_NOT_FOUND' });
|
|
381
|
+
}
|
|
382
|
+
const refusal = DEMOTE_REFUSAL_CODE.exec(message);
|
|
383
|
+
if (refusal)
|
|
384
|
+
return jsonResponse(res, 422, { error: message, code: refusal[1] });
|
|
385
|
+
// Not a refusal (e.g. a database failure): the generic 500 below.
|
|
386
|
+
throw err;
|
|
387
|
+
}
|
|
388
|
+
}
|
|
176
389
|
// POST /api/kb/invalidate
|
|
177
390
|
if (pathname === '/api/kb/invalidate' && method === 'POST') {
|
|
178
391
|
const body = await readBody(req);
|
|
@@ -192,7 +405,12 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
192
405
|
}
|
|
193
406
|
const files = filesParam.split(',');
|
|
194
407
|
validateFilePaths(files);
|
|
195
|
-
const
|
|
408
|
+
const ctxConfidence = url.searchParams.get('confidence')
|
|
409
|
+
?.split(',')
|
|
410
|
+
.filter((c) => c === 'CONFIRMED' || c === 'INFERRED' || c === 'UNVERIFIED');
|
|
411
|
+
// tag: MEMBER own-scope (HttpKbProvider sends the owner tag), so each
|
|
412
|
+
// file's newest entry is chosen among that member's own.
|
|
413
|
+
const result = await provider.context(files, ctxConfidence, url.searchParams.get('exclude_disputed') === 'true', url.searchParams.get('tag') || undefined);
|
|
196
414
|
return jsonResponse(res, 200, { results: result });
|
|
197
415
|
}
|
|
198
416
|
// POST /api/kb/prime
|
|
@@ -204,6 +422,33 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
204
422
|
const result = await provider.prime(opts);
|
|
205
423
|
return jsonResponse(res, 200, result);
|
|
206
424
|
}
|
|
425
|
+
// POST /api/kb/feedback -- same author validation and response shape as
|
|
426
|
+
// the kb_feedback tool; confidence is never changed.
|
|
427
|
+
if (pathname === '/api/kb/feedback' && method === 'POST') {
|
|
428
|
+
const body = await readBody(req);
|
|
429
|
+
const input = JSON.parse(body);
|
|
430
|
+
if (typeof input.id !== 'string' || input.id.length === 0 ||
|
|
431
|
+
typeof input.reason !== 'string' || input.reason.length === 0) {
|
|
432
|
+
return jsonResponse(res, 400, { error: 'id and reason must be non-empty strings', code: 'BAD_REQUEST' });
|
|
433
|
+
}
|
|
434
|
+
const author = validateAuthor(typeof input.role === 'string' ? input.role : undefined);
|
|
435
|
+
let entry;
|
|
436
|
+
try {
|
|
437
|
+
entry = await provider.feedback(input.id, input.reason, author);
|
|
438
|
+
}
|
|
439
|
+
catch (err) {
|
|
440
|
+
if (err instanceof Error && err.message.startsWith('Entry not found')) {
|
|
441
|
+
return jsonResponse(res, 404, { error: err.message, code: 'ENTRY_NOT_FOUND' });
|
|
442
|
+
}
|
|
443
|
+
throw err;
|
|
444
|
+
}
|
|
445
|
+
return jsonResponse(res, 200, {
|
|
446
|
+
id: entry.id,
|
|
447
|
+
stale: entry.stale,
|
|
448
|
+
flagged_for_review: entry.flagged_for_review,
|
|
449
|
+
confidence: entry.confidence,
|
|
450
|
+
});
|
|
451
|
+
}
|
|
207
452
|
return jsonResponse(res, 404, { error: 'Not found', code: 'NOT_FOUND' });
|
|
208
453
|
}
|
|
209
454
|
catch (err) {
|
|
@@ -214,6 +459,10 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
214
459
|
if (err instanceof KbCaptureRejected) {
|
|
215
460
|
return jsonResponse(res, 400, { error: err.message, code: 'CAPTURE_REJECTED', reason: err.reason });
|
|
216
461
|
}
|
|
462
|
+
// A request body that is not JSON is the caller's fault, on every route.
|
|
463
|
+
if (err instanceof SyntaxError) {
|
|
464
|
+
return jsonResponse(res, 400, { error: 'Request body is not valid JSON', code: 'BAD_REQUEST' });
|
|
465
|
+
}
|
|
217
466
|
if (err instanceof Error) {
|
|
218
467
|
if (err.message === 'BODY_TOO_LARGE') {
|
|
219
468
|
return jsonResponse(res, 413, { error: 'Request body too large (max 1MB)', code: 'PAYLOAD_TOO_LARGE' });
|
|
@@ -225,12 +474,39 @@ export async function startKbServer(port, generateToken, dbPath) {
|
|
|
225
474
|
return jsonResponse(res, 500, { error: 'Internal server error', code: 'INTERNAL_ERROR' });
|
|
226
475
|
}
|
|
227
476
|
});
|
|
477
|
+
server.on('close', releaseOwnedProvider);
|
|
478
|
+
// Poll the token file by path (stat-free content compare) so in-place writes
|
|
479
|
+
// and rename-replacement are both picked up. A bad re-read keeps the last
|
|
480
|
+
// good token; the token value is never logged.
|
|
481
|
+
let tokenTimer;
|
|
482
|
+
if (tokenFile) {
|
|
483
|
+
tokenTimer = setInterval(() => {
|
|
484
|
+
try {
|
|
485
|
+
serverToken = readTokenFile(tokenFile);
|
|
486
|
+
}
|
|
487
|
+
catch (err) {
|
|
488
|
+
const msg = err.message;
|
|
489
|
+
if (msg !== lastTokenWarning) {
|
|
490
|
+
lastTokenWarning = msg;
|
|
491
|
+
process.stderr.write(`[kb-server] warning: ${msg}; keeping the last good token\n`);
|
|
492
|
+
}
|
|
493
|
+
return;
|
|
494
|
+
}
|
|
495
|
+
lastTokenWarning = undefined;
|
|
496
|
+
}, TOKEN_FILE_POLL_MS);
|
|
497
|
+
tokenTimer.unref();
|
|
498
|
+
server.on('close', () => { if (tokenTimer)
|
|
499
|
+
clearInterval(tokenTimer); });
|
|
500
|
+
}
|
|
228
501
|
return new Promise((resolve, reject) => {
|
|
229
502
|
server.on('error', (err) => {
|
|
230
503
|
if (err.code === 'EADDRINUSE') {
|
|
231
504
|
process.stderr.write(`KB server failed to start: port ${port} is already in use. Try --port ${port + 1}\n`);
|
|
232
505
|
process.exit(1);
|
|
233
506
|
}
|
|
507
|
+
releaseOwnedProvider();
|
|
508
|
+
if (tokenTimer)
|
|
509
|
+
clearInterval(tokenTimer);
|
|
234
510
|
reject(err);
|
|
235
511
|
});
|
|
236
512
|
server.listen(port, () => {
|
|
@@ -243,6 +519,7 @@ export function parseKbServerArgs(argv) {
|
|
|
243
519
|
let port = 7878;
|
|
244
520
|
let generateToken = false;
|
|
245
521
|
let dbPath;
|
|
522
|
+
let tokenFile;
|
|
246
523
|
for (let i = 0; i < argv.length; i++) {
|
|
247
524
|
if (argv[i] === '--port' && argv[i + 1]) {
|
|
248
525
|
port = parseInt(argv[i + 1], 10);
|
|
@@ -255,7 +532,11 @@ export function parseKbServerArgs(argv) {
|
|
|
255
532
|
dbPath = argv[i + 1];
|
|
256
533
|
i++;
|
|
257
534
|
}
|
|
535
|
+
if (argv[i] === '--token-file' && argv[i + 1]) {
|
|
536
|
+
tokenFile = argv[i + 1];
|
|
537
|
+
i++;
|
|
538
|
+
}
|
|
258
539
|
}
|
|
259
|
-
return { port, generateToken, dbPath };
|
|
540
|
+
return { port, generateToken, dbPath, tokenFile };
|
|
260
541
|
}
|
|
261
542
|
//# sourceMappingURL=kb-server.js.map
|
|
@@ -26,6 +26,10 @@ export interface HttpServerHandle {
|
|
|
26
26
|
port: number;
|
|
27
27
|
close(): Promise<void>;
|
|
28
28
|
}
|
|
29
|
-
export
|
|
29
|
+
export interface HttpServerOptions {
|
|
30
|
+
/** Max time close() waits for in-flight request handlers (default 5000ms). */
|
|
31
|
+
drainTimeoutMs?: number;
|
|
32
|
+
}
|
|
33
|
+
export declare function createHttpServer(options?: HttpServerOptions): HttpServerHandle;
|
|
30
34
|
export declare function listen(handle: HttpServerHandle, port: number, host?: string): Promise<number>;
|
|
31
35
|
//# sourceMappingURL=http-server.d.ts.map
|
|
@@ -93,6 +93,12 @@ function sendJson(res, status, body) {
|
|
|
93
93
|
}
|
|
94
94
|
function parseBody(req) {
|
|
95
95
|
return new Promise((resolve, reject) => {
|
|
96
|
+
// Handler resumed after the socket was already destroyed (e.g. server
|
|
97
|
+
// close): 'end'/'error'/'close' have fired or never will -- settle now.
|
|
98
|
+
if (req.destroyed) {
|
|
99
|
+
reject(new Error('request closed before body was read'));
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
96
102
|
const chunks = [];
|
|
97
103
|
req.on('data', (chunk) => chunks.push(chunk));
|
|
98
104
|
req.on('end', () => {
|
|
@@ -105,6 +111,10 @@ function parseBody(req) {
|
|
|
105
111
|
}
|
|
106
112
|
});
|
|
107
113
|
req.on('error', reject);
|
|
114
|
+
// A socket destroyed mid-body may emit neither 'end' nor 'error';
|
|
115
|
+
// 'close' after a completed body is a no-op (already resolved).
|
|
116
|
+
req.on('close', () => { if (!req.complete)
|
|
117
|
+
reject(new Error('request closed before body was complete')); });
|
|
108
118
|
});
|
|
109
119
|
}
|
|
110
120
|
function extractBearer(req) {
|
|
@@ -113,8 +123,28 @@ function extractBearer(req) {
|
|
|
113
123
|
return null;
|
|
114
124
|
return auth.slice(7);
|
|
115
125
|
}
|
|
116
|
-
|
|
117
|
-
|
|
126
|
+
const DEFAULT_DRAIN_TIMEOUT_MS = 5000;
|
|
127
|
+
export function createHttpServer(options = {}) {
|
|
128
|
+
const drainTimeoutMs = options.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS;
|
|
129
|
+
// Request handlers are async and node:http never awaits them: a throw
|
|
130
|
+
// after any await (DB error, pool torn down mid-request) would otherwise
|
|
131
|
+
// surface as a process-level unhandled rejection. Every handler runs
|
|
132
|
+
// inside this boundary (500 + stderr log), and in-flight handlers are
|
|
133
|
+
// tracked so close() waits (up to drainTimeoutMs) for them to settle --
|
|
134
|
+
// callers can safely release shared resources (the pool) after close().
|
|
135
|
+
const inFlight = new Set();
|
|
136
|
+
const server = http.createServer((req, res) => {
|
|
137
|
+
const p = handleRequest(req, res)
|
|
138
|
+
.catch((err) => {
|
|
139
|
+
process.stderr.write(`[hub-service] ${req.method} ${req.url} failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
140
|
+
if (!res.headersSent && !res.destroyed && !res.writableEnded) {
|
|
141
|
+
sendJson(res, 500, { error: 'internal server error' });
|
|
142
|
+
}
|
|
143
|
+
})
|
|
144
|
+
.finally(() => { inFlight.delete(p); });
|
|
145
|
+
inFlight.add(p);
|
|
146
|
+
});
|
|
147
|
+
async function handleRequest(req, res) {
|
|
118
148
|
const url = new URL(req.url ?? '/', 'http://localhost');
|
|
119
149
|
const segments = url.pathname.split('/').filter(Boolean);
|
|
120
150
|
if (url.pathname === '/health' && req.method === 'GET') {
|
|
@@ -683,15 +713,15 @@ export function createHttpServer() {
|
|
|
683
713
|
return;
|
|
684
714
|
}
|
|
685
715
|
sendJson(res, 404, { error: 'not found' });
|
|
686
|
-
}
|
|
716
|
+
}
|
|
687
717
|
return {
|
|
688
718
|
server,
|
|
689
719
|
get port() {
|
|
690
720
|
const addr = server.address();
|
|
691
721
|
return typeof addr === 'object' && addr ? addr.port : 0;
|
|
692
722
|
},
|
|
693
|
-
close() {
|
|
694
|
-
|
|
723
|
+
async close() {
|
|
724
|
+
await new Promise((resolve, reject) => {
|
|
695
725
|
server.close((err) => (err ? reject(err) : resolve()));
|
|
696
726
|
// /ws/:id/stream holds a long-lived keep-alive SSE socket open
|
|
697
727
|
// indefinitely; without force-closing live connections here, a
|
|
@@ -699,6 +729,26 @@ export function createHttpServer() {
|
|
|
699
729
|
// for streams that never end on their own.
|
|
700
730
|
server.closeAllConnections();
|
|
701
731
|
});
|
|
732
|
+
// Destroying a socket does not stop its handler: one parked on an
|
|
733
|
+
// await (e.g. /ack between authorize and ackRelay) resumes later. Wait
|
|
734
|
+
// for all of them so nothing touches the pool after close() returns.
|
|
735
|
+
// Bounded: a stuck DB query must not hang shutdown. Handlers still
|
|
736
|
+
// running after the bound stay contained by the error boundary above.
|
|
737
|
+
let timer;
|
|
738
|
+
const timedOut = new Promise((resolve) => {
|
|
739
|
+
timer = setTimeout(() => resolve(true), drainTimeoutMs);
|
|
740
|
+
timer.unref();
|
|
741
|
+
});
|
|
742
|
+
const drained = (async () => {
|
|
743
|
+
while (inFlight.size > 0)
|
|
744
|
+
await Promise.allSettled([...inFlight]);
|
|
745
|
+
return false;
|
|
746
|
+
})();
|
|
747
|
+
const expired = await Promise.race([drained, timedOut]);
|
|
748
|
+
clearTimeout(timer);
|
|
749
|
+
if (expired && inFlight.size > 0) {
|
|
750
|
+
process.stderr.write(`[hub-service] close: ${inFlight.size} request handler(s) still in flight after ${drainTimeoutMs}ms; proceeding with shutdown\n`);
|
|
751
|
+
}
|
|
702
752
|
},
|
|
703
753
|
};
|
|
704
754
|
}
|