@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
|
@@ -1,9 +1,63 @@
|
|
|
1
1
|
import http from 'node:http';
|
|
2
2
|
import https from 'node:https';
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
import { DEFAULT_REQUEST_TIMEOUT_MS } from './kb-config.js';
|
|
4
|
+
import { isAbsoluteOrTraversing } from './path-validation.js';
|
|
5
|
+
import { lookupServerSecret } from '../credential-store.js';
|
|
6
|
+
import { recordKbHttpSuccess, recordKbHttpRejected } from './kb-http-auth-state.js';
|
|
7
|
+
import { REPOSITORY_HEADER, REPOSITORY_COMMIT_HEADER, REPOSITORY_BRANCH_HEADER, COMMIT_SHA, isValidRepositoryValue, isValidBranchValue, } from './repository-header.js';
|
|
8
|
+
export { DEFAULT_REQUEST_TIMEOUT_MS };
|
|
9
|
+
// Most entries one owner-tag lookup reads back. An owned entry beyond it is
|
|
10
|
+
// reported not-found (a refusal, never a wrong promote).
|
|
11
|
+
const OWNED_LOOKUP_LIMIT = 1000;
|
|
12
|
+
/**
|
|
13
|
+
* E-KB-HTTP-AUTH: the remote KB's token comes from a named fleet secret and
|
|
14
|
+
* that secret is missing, expired, unreadable, or was rejected by the server
|
|
15
|
+
* (HTTP 401) on the request and on one retry after re-reading it. The message
|
|
16
|
+
* names the secret and the reason, never the value. Nothing is queued: the
|
|
17
|
+
* caller decides whether to repeat the operation once the secret is fixed.
|
|
18
|
+
*/
|
|
19
|
+
export class KbHttpAuthError extends Error {
|
|
20
|
+
code = 'E-KB-HTTP-AUTH';
|
|
21
|
+
secretName;
|
|
22
|
+
reason;
|
|
23
|
+
remediation;
|
|
24
|
+
/** The problem sentence, without the code prefix and remediation. */
|
|
25
|
+
problem;
|
|
26
|
+
constructor(secretName, reason, problem) {
|
|
27
|
+
const remediation = `apra-fleet secret --set ${secretName} --persist -y (the next KB call uses the new value; no restart needed)`;
|
|
28
|
+
super(`E-KB-HTTP-AUTH: ${problem} Remediation: ${remediation}`);
|
|
29
|
+
this.name = 'KbHttpAuthError';
|
|
30
|
+
this.secretName = secretName;
|
|
31
|
+
this.reason = reason;
|
|
32
|
+
this.remediation = remediation;
|
|
33
|
+
this.problem = problem;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* A 5xx or 429: the server (or a gateway in front of it) answered, but could
|
|
38
|
+
* not serve the request now.
|
|
39
|
+
*/
|
|
40
|
+
function isServerUnavailable(err) {
|
|
41
|
+
const code = err instanceof Error ? err.code : undefined;
|
|
42
|
+
return typeof code === 'string' && (code === 'HTTP_429' || /^HTTP_5\d\d$/.test(code));
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* A 429 or 503: the server (or a gateway in front of it) refused the request
|
|
46
|
+
* before handling it -- rate limiting, a restarting server, a gateway with no
|
|
47
|
+
* backend -- so the identical request is safe to repeat. Every other 5xx may
|
|
48
|
+
* follow a handled request.
|
|
49
|
+
*/
|
|
50
|
+
function isRetryableStatus(err) {
|
|
51
|
+
const code = err instanceof Error ? err.code : undefined;
|
|
52
|
+
return code === 'HTTP_429' || code === 'HTTP_503';
|
|
53
|
+
}
|
|
54
|
+
function isHttp401(err) {
|
|
55
|
+
return err instanceof Error && err.code === 'HTTP_401';
|
|
56
|
+
}
|
|
57
|
+
/** Defensive: a server that echoes the Authorization header must not leak the token into an error. */
|
|
58
|
+
function redactToken(text, token) {
|
|
59
|
+
return token ? text.split(token).join('[REDACTED]') : text;
|
|
60
|
+
}
|
|
7
61
|
function isConnectionError(err) {
|
|
8
62
|
if (!(err instanceof Error))
|
|
9
63
|
return false;
|
|
@@ -16,35 +70,333 @@ function isConnectionError(err) {
|
|
|
16
70
|
err.message.includes('ETIMEDOUT') ||
|
|
17
71
|
err.message.includes('socket hang up'));
|
|
18
72
|
}
|
|
73
|
+
/** Longest server error text carried into a tool result. */
|
|
74
|
+
export const MAX_ERROR_TEXT_CHARS = 300;
|
|
75
|
+
/**
|
|
76
|
+
* Server error text made safe for a tool result: markup stripped, whitespace
|
|
77
|
+
* collapsed, and capped at MAX_ERROR_TEXT_CHARS (a proxy or a crashed server
|
|
78
|
+
* can answer with a whole HTML page).
|
|
79
|
+
*/
|
|
80
|
+
export function boundErrorText(text) {
|
|
81
|
+
const plain = text.replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ').trim();
|
|
82
|
+
if (plain.length === 0)
|
|
83
|
+
return '(empty response body)';
|
|
84
|
+
if (plain.length <= MAX_ERROR_TEXT_CHARS)
|
|
85
|
+
return plain;
|
|
86
|
+
return `${plain.slice(0, MAX_ERROR_TEXT_CHARS)}... (truncated, ${plain.length} chars)`;
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Human-readable text for an error-status response body. Handles
|
|
90
|
+
* problem+json (title/detail/code), the plain {error} shape, and bodies
|
|
91
|
+
* that are not JSON at all (never a parse failure). Always bounded.
|
|
92
|
+
*/
|
|
93
|
+
function describeErrorBody(data) {
|
|
94
|
+
let parsed;
|
|
95
|
+
try {
|
|
96
|
+
parsed = JSON.parse(data);
|
|
97
|
+
}
|
|
98
|
+
catch {
|
|
99
|
+
return boundErrorText(data);
|
|
100
|
+
}
|
|
101
|
+
if (parsed === null || typeof parsed !== 'object')
|
|
102
|
+
return boundErrorText(data);
|
|
103
|
+
const body = parsed;
|
|
104
|
+
if (typeof body.error === 'string') {
|
|
105
|
+
// A problem+json body that also carries a flat `error` string (a server
|
|
106
|
+
// may send both) keeps its taxonomy `code` in the text too.
|
|
107
|
+
const code = typeof body.code === 'string' && body.code.length > 0 && !body.error.includes(body.code)
|
|
108
|
+
? ` [${body.code}]` : '';
|
|
109
|
+
return boundErrorText(body.error + code);
|
|
110
|
+
}
|
|
111
|
+
const parts = [body.title, body.code, body.detail]
|
|
112
|
+
.filter((v) => typeof v === 'string' && v.length > 0);
|
|
113
|
+
return boundErrorText(parts.length > 0 ? parts.join(' - ') : data);
|
|
114
|
+
}
|
|
115
|
+
/** The string `code` of a JSON error body, or undefined. */
|
|
116
|
+
function bodyCodeOf(data) {
|
|
117
|
+
try {
|
|
118
|
+
const body = JSON.parse(data);
|
|
119
|
+
if (body !== null && typeof body === 'object' && typeof body.code === 'string') {
|
|
120
|
+
return body.code;
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
// not JSON: no code
|
|
125
|
+
}
|
|
126
|
+
return undefined;
|
|
127
|
+
}
|
|
128
|
+
/** True when `text` parses as JSON. */
|
|
129
|
+
function isJsonText(text) {
|
|
130
|
+
try {
|
|
131
|
+
JSON.parse(text);
|
|
132
|
+
return true;
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
return false;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
/** `url` with any user:password removed, for error text. */
|
|
139
|
+
export function redactUrlUserinfo(url) {
|
|
140
|
+
try {
|
|
141
|
+
const parsed = new URL(url);
|
|
142
|
+
if (parsed.username === '' && parsed.password === '')
|
|
143
|
+
return url;
|
|
144
|
+
parsed.username = '';
|
|
145
|
+
parsed.password = '';
|
|
146
|
+
return parsed.toString().replace(/\/$/, '');
|
|
147
|
+
}
|
|
148
|
+
catch {
|
|
149
|
+
return url.replace(/\/\/[^/@]*@/, '//');
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* The two project slugs of a kb-server 409 PROJECT_MISMATCH body, or null for
|
|
154
|
+
* any other 409 (which is then reported as a plain HTTP error).
|
|
155
|
+
*/
|
|
156
|
+
function projectMismatchOf(data) {
|
|
157
|
+
try {
|
|
158
|
+
const body = JSON.parse(data);
|
|
159
|
+
if (body.code !== 'PROJECT_MISMATCH')
|
|
160
|
+
return null;
|
|
161
|
+
return { server: String(body.server_project), client: String(body.client_project) };
|
|
162
|
+
}
|
|
163
|
+
catch {
|
|
164
|
+
return null;
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* A promote the server answered 404: the same "Entry not found: <id>" the
|
|
169
|
+
* SQLite provider throws, followed by the server's own answer (whose text
|
|
170
|
+
* already carries the status and the problem+json title/code/detail). The
|
|
171
|
+
* HTTP_404 code is kept.
|
|
172
|
+
*/
|
|
173
|
+
function entryNotFoundOnServer(id, err) {
|
|
174
|
+
const notFound = new Error(`Entry not found: ${id} (the KB server answered ${err.message})`);
|
|
175
|
+
notFound.code = err.code;
|
|
176
|
+
return notFound;
|
|
177
|
+
}
|
|
178
|
+
/** True when the entry carries `tag`; an entry without a tags array is never owned. */
|
|
179
|
+
function hasTag(entry, tag) {
|
|
180
|
+
return Array.isArray(entry.tags) && entry.tags.includes(tag);
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* E-KB-HTTP-UNREACHABLE: the KB server could not be reached (connection
|
|
184
|
+
* refused, DNS failure, timeout, reset), its capabilities read answered a
|
|
185
|
+
* 5xx or 429 (so the request itself was never sent), or the request itself
|
|
186
|
+
* was answered 429 or 503 (refused before it was handled). Over http the server is
|
|
187
|
+
* the only source of truth, so nothing is answered from a local store or the
|
|
188
|
+
* checkout bible instead. Nothing is queued: the error is retryable, and the
|
|
189
|
+
* caller decides whether to repeat the call (the sprint engine keeps its own
|
|
190
|
+
* KB write queued and repeats it on its next flush).
|
|
191
|
+
*/
|
|
192
|
+
export class KbHttpUnreachableError extends Error {
|
|
193
|
+
code = 'E-KB-HTTP-UNREACHABLE';
|
|
194
|
+
/** The connection error text (e.g. "connect ECONNREFUSED ..."). */
|
|
195
|
+
causeText;
|
|
196
|
+
constructor(serverUrl, operation, causeText) {
|
|
197
|
+
super(`E-KB-HTTP-UNREACHABLE: ${operation}: the KB server at ${serverUrl} is unreachable (${causeText}); `
|
|
198
|
+
+ 'nothing was read or written, and no local store or bible is used instead. '
|
|
199
|
+
+ 'Remediation: start the KB server or restore the network path to it, then repeat the call; or use a local SQLite KB (kb_setup provider sqlite).');
|
|
200
|
+
this.name = 'KbHttpUnreachableError';
|
|
201
|
+
this.causeText = causeText;
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* E-KB-HTTP-SERVER-ERROR: the KB server (or a gateway in front of it) answered
|
|
206
|
+
* a request itself with a 5xx other than 503. For a write the request reached
|
|
207
|
+
* the server, so whether the write took effect is unknown (a 502 or 504 can
|
|
208
|
+
* follow a stored write). It is not retried and nothing is queued: repeating
|
|
209
|
+
* it blindly could apply it twice, and a server that always answers 500 would
|
|
210
|
+
* be retried forever. For a read nothing was read, and no local store or
|
|
211
|
+
* bible answers instead.
|
|
212
|
+
*/
|
|
213
|
+
export class KbHttpServerError extends Error {
|
|
214
|
+
code = 'E-KB-HTTP-SERVER-ERROR';
|
|
215
|
+
constructor(serverUrl, operation, answer, kind = 'write') {
|
|
216
|
+
super(`E-KB-HTTP-SERVER-ERROR: ${operation}: the KB server at ${serverUrl} answered ${answer}; `
|
|
217
|
+
+ (kind === 'write'
|
|
218
|
+
? 'whether the write took effect is unknown, so it was not retried or queued. '
|
|
219
|
+
+ 'Remediation: check the KB server (or the gateway in front of it); once it answers normally, read the entry back (kb_query) before repeating the write.'
|
|
220
|
+
: 'nothing was read, and no local store or bible is used instead. '
|
|
221
|
+
+ 'Remediation: check the KB server (or the gateway in front of it), then repeat the call.'));
|
|
222
|
+
this.name = 'KbHttpServerError';
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* Typed refusal for an operation the http KB provider does not support (and
|
|
227
|
+
* deliberately does not emulate through a local store).
|
|
228
|
+
*/
|
|
229
|
+
export class KbHttpUnsupportedError extends Error {
|
|
230
|
+
code = 'E-KB-HTTP-UNSUPPORTED';
|
|
231
|
+
constructor(operation, outcome = 'nothing was discarded', remediation = 'run it against a local SQLite KB (kb_setup provider sqlite), or use kb_invalidate with files.') {
|
|
232
|
+
super(`E-KB-HTTP-UNSUPPORTED: ${operation} is not supported by the http KB provider; ${outcome}. `
|
|
233
|
+
+ `Remediation: ${remediation}`);
|
|
234
|
+
this.name = 'KbHttpUnsupportedError';
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* Typed refusal for a KB server that serves a different project than the one
|
|
239
|
+
* the request is for (HTTP 409). Never answered from a local store: the
|
|
240
|
+
* server is reachable, it is just the wrong one.
|
|
241
|
+
*/
|
|
242
|
+
export class KbHttpProjectMismatchError extends Error {
|
|
243
|
+
code = 'E-KB-HTTP-PROJECT-MISMATCH';
|
|
244
|
+
constructor(serverUrl, serverProject, clientProject) {
|
|
245
|
+
super(`E-KB-HTTP-PROJECT-MISMATCH: the KB server at ${serverUrl} serves project "${serverProject}", `
|
|
246
|
+
+ `not "${clientProject}"; nothing was read or written. `
|
|
247
|
+
+ 'Remediation: point this repo at the KB server for its own project (kb_setup provider http), '
|
|
248
|
+
+ 'or use a local SQLite KB (kb_setup provider sqlite).');
|
|
249
|
+
this.name = 'KbHttpProjectMismatchError';
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
/** Routes every contract KB server serves. */
|
|
253
|
+
export const KB_REQUIRED_ROUTES = ['capture', 'query', 'promote'];
|
|
254
|
+
/** Routes a contract KB server may leave out; it lists the ones it serves in its capabilities. */
|
|
255
|
+
export const KB_OPTIONAL_ROUTES = ['context', 'prime', 'invalidate', 'feedback', 'list', 'demote'];
|
|
256
|
+
const KNOWN_ROUTES = [...KB_REQUIRED_ROUTES, ...KB_OPTIONAL_ROUTES];
|
|
257
|
+
/**
|
|
258
|
+
* Assumed for a server that does not serve GET /api/kb/capabilities (404 or
|
|
259
|
+
* 501): the route set servers had before capabilities existed. demote is not
|
|
260
|
+
* in it.
|
|
261
|
+
*/
|
|
262
|
+
export const KB_DEFAULT_CAPABILITIES = Object.freeze({
|
|
263
|
+
contract: 'v1',
|
|
264
|
+
routes: ['capture', 'query', 'promote', 'context', 'prime', 'invalidate', 'feedback', 'list'],
|
|
265
|
+
branch_aware: false,
|
|
266
|
+
});
|
|
267
|
+
function defaultCapabilities() {
|
|
268
|
+
return { ...KB_DEFAULT_CAPABILITIES, routes: [...KB_DEFAULT_CAPABILITIES.routes] };
|
|
269
|
+
}
|
|
270
|
+
/** Body codes meaning "no entry with that id" on a 404 from an id route. */
|
|
271
|
+
const ENTRY_NOT_FOUND_CODES = new Set(['ENTRY_NOT_FOUND', 'E-ENTRY-NOT-FOUND']);
|
|
272
|
+
/** The `code` field of an HTTP error's server body, when it had one. */
|
|
273
|
+
function serverCodeOf(err) {
|
|
274
|
+
return err.serverCode;
|
|
275
|
+
}
|
|
276
|
+
/** Header carrying the project slug on every request (checked by kb-server). */
|
|
277
|
+
export const KB_PROJECT_HEADER = 'X-KB-Project';
|
|
19
278
|
export class HttpKbProvider {
|
|
20
279
|
baseUrl;
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
280
|
+
/** baseUrl with any user:password removed: the only form put in error text. */
|
|
281
|
+
displayUrl;
|
|
282
|
+
tokenSource;
|
|
283
|
+
projectSlug;
|
|
284
|
+
requestTimeoutMs;
|
|
285
|
+
repository;
|
|
286
|
+
/**
|
|
287
|
+
* The server's capabilities, read once per connection: cleared when a
|
|
288
|
+
* request finds the server unreachable, so the first request after a
|
|
289
|
+
* reconnect reads them again.
|
|
290
|
+
*/
|
|
291
|
+
capabilitiesRead;
|
|
292
|
+
// The KB server is the only source of truth: no local store or checkout
|
|
293
|
+
// bible answers for it, online or offline.
|
|
294
|
+
constructor(url, token, options = {}) {
|
|
295
|
+
this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
|
|
296
|
+
this.repository = options.repository && isValidRepositoryValue(options.repository.remote)
|
|
297
|
+
? options.repository
|
|
298
|
+
: undefined;
|
|
26
299
|
this.baseUrl = url.replace(/\/$/, '');
|
|
27
|
-
this.
|
|
28
|
-
this.
|
|
29
|
-
this.
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
300
|
+
this.displayUrl = redactUrlUserinfo(this.baseUrl);
|
|
301
|
+
this.tokenSource = token;
|
|
302
|
+
this.projectSlug = options.projectSlug;
|
|
303
|
+
}
|
|
304
|
+
// Nothing to release: the provider holds no queue, listener or handle.
|
|
305
|
+
// Kept so callers that retire a provider need not know its type.
|
|
306
|
+
dispose() { }
|
|
307
|
+
// The repository headers for one request. The commit and branch are best
|
|
308
|
+
// effort: an unreadable, throwing or malformed value omits that header and
|
|
309
|
+
// never fails the request.
|
|
310
|
+
repositoryHeaders() {
|
|
311
|
+
if (!this.repository)
|
|
312
|
+
return {};
|
|
313
|
+
const headers = { [REPOSITORY_HEADER]: this.repository.remote };
|
|
314
|
+
let commit;
|
|
315
|
+
try {
|
|
316
|
+
commit = this.repository.commitOf?.();
|
|
317
|
+
}
|
|
318
|
+
catch {
|
|
319
|
+
commit = undefined;
|
|
320
|
+
}
|
|
321
|
+
if (commit && COMMIT_SHA.test(commit))
|
|
322
|
+
headers[REPOSITORY_COMMIT_HEADER] = commit;
|
|
323
|
+
let branch;
|
|
324
|
+
try {
|
|
325
|
+
branch = this.repository.branchOf?.();
|
|
326
|
+
}
|
|
327
|
+
catch {
|
|
328
|
+
branch = undefined;
|
|
329
|
+
}
|
|
330
|
+
if (typeof branch === 'string' && isValidBranchValue(branch))
|
|
331
|
+
headers[REPOSITORY_BRANCH_HEADER] = branch;
|
|
332
|
+
return headers;
|
|
36
333
|
}
|
|
37
|
-
|
|
38
|
-
|
|
334
|
+
/**
|
|
335
|
+
* The token to send now. A literal is returned as is. A secret name is
|
|
336
|
+
* looked up (server-side lookup: allowedMembers does not apply, an expired
|
|
337
|
+
* record is reported and kept) and a missing/expired/unreadable secret
|
|
338
|
+
* raises E-KB-HTTP-AUTH before any request is sent.
|
|
339
|
+
*/
|
|
340
|
+
resolveToken() {
|
|
341
|
+
const source = this.tokenSource;
|
|
342
|
+
if (typeof source === 'string')
|
|
343
|
+
return source;
|
|
344
|
+
const name = source.secretName;
|
|
345
|
+
let found;
|
|
346
|
+
try {
|
|
347
|
+
found = lookupServerSecret(name);
|
|
348
|
+
}
|
|
349
|
+
catch {
|
|
350
|
+
// Fixed text: the underlying parser/decrypt error can quote ciphertext.
|
|
351
|
+
throw new KbHttpAuthError(name, 'unreadable', `the KB server token comes from fleet secret "${name}", which could not be read (credential store unreadable or value could not be decrypted).`);
|
|
352
|
+
}
|
|
353
|
+
if (found.status === 'missing') {
|
|
354
|
+
throw new KbHttpAuthError(name, 'missing', `the KB server token comes from fleet secret "${name}", which does not exist.`);
|
|
355
|
+
}
|
|
356
|
+
if (found.status === 'expired') {
|
|
357
|
+
throw new KbHttpAuthError(name, 'expired', `the KB server token comes from fleet secret "${name}", which expired at ${found.expiresAt}.`);
|
|
358
|
+
}
|
|
359
|
+
return found.value;
|
|
39
360
|
}
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
361
|
+
/**
|
|
362
|
+
* One authenticated request. Literal token: exactly the old behaviour (a
|
|
363
|
+
* 401 is thrown as the plain HTTP_401 error, no retry). Secret name: the
|
|
364
|
+
* secret is looked up for this request; on 401 it is looked up once more
|
|
365
|
+
* and the request retried once; a second 401 raises E-KB-HTTP-AUTH.
|
|
366
|
+
* Records the last success / last 401 for fleet_status either way.
|
|
367
|
+
*/
|
|
368
|
+
async request(method, pathname, body, queryParams) {
|
|
369
|
+
const secretName = typeof this.tokenSource === 'string' ? undefined : this.tokenSource.secretName;
|
|
370
|
+
const attempts = secretName === undefined ? 1 : 2;
|
|
371
|
+
// Computed once, after the first secret lookup succeeds: a missing secret
|
|
372
|
+
// fails before the commit and branch are read, and the 401 retry sends the
|
|
373
|
+
// same commit and branch.
|
|
374
|
+
let repoHeaders;
|
|
375
|
+
for (let attempt = 1;; attempt++) {
|
|
376
|
+
const token = this.resolveToken();
|
|
377
|
+
repoHeaders ??= this.repositoryHeaders();
|
|
378
|
+
try {
|
|
379
|
+
const result = await this.rawRequest(token, method, pathname, body, queryParams, secretName !== undefined, repoHeaders);
|
|
380
|
+
recordKbHttpSuccess(this.baseUrl);
|
|
381
|
+
return result;
|
|
382
|
+
}
|
|
383
|
+
catch (err) {
|
|
384
|
+
if (isConnectionError(err)) {
|
|
385
|
+
this.capabilitiesRead = undefined;
|
|
386
|
+
throw new KbHttpUnreachableError(this.displayUrl, `${method} ${pathname}`, err.message);
|
|
387
|
+
}
|
|
388
|
+
if (!isHttp401(err))
|
|
389
|
+
throw err;
|
|
390
|
+
recordKbHttpRejected(this.baseUrl);
|
|
391
|
+
if (secretName === undefined)
|
|
392
|
+
throw err;
|
|
393
|
+
if (attempt >= attempts) {
|
|
394
|
+
throw new KbHttpAuthError(secretName, 'rejected', `the KB server rejected the token from fleet secret "${secretName}" (HTTP 401), also on one retry after re-reading the secret.`);
|
|
395
|
+
}
|
|
396
|
+
}
|
|
44
397
|
}
|
|
45
|
-
this.offlineQueue.push(op);
|
|
46
398
|
}
|
|
47
|
-
rawRequest(method, pathname, body, queryParams) {
|
|
399
|
+
rawRequest(token, method, pathname, body, queryParams, nonJson401IsAuth = false, extraHeaders = {}) {
|
|
48
400
|
return new Promise((resolve, reject) => {
|
|
49
401
|
const parsedUrl = new URL(this.baseUrl);
|
|
50
402
|
let reqPath = parsedUrl.pathname.replace(/\/$/, '') + pathname;
|
|
@@ -54,8 +406,12 @@ export class HttpKbProvider {
|
|
|
54
406
|
const bodyStr = body !== undefined ? JSON.stringify(body) : undefined;
|
|
55
407
|
const headers = {
|
|
56
408
|
'Content-Type': 'application/json',
|
|
57
|
-
|
|
409
|
+
...extraHeaders,
|
|
410
|
+
// Set last so no extra header can replace the bearer token.
|
|
411
|
+
'Authorization': `Bearer ${token}`,
|
|
58
412
|
};
|
|
413
|
+
if (this.projectSlug !== undefined)
|
|
414
|
+
headers[KB_PROJECT_HEADER] = this.projectSlug;
|
|
59
415
|
if (bodyStr)
|
|
60
416
|
headers['Content-Length'] = Buffer.byteLength(bodyStr).toString();
|
|
61
417
|
const options = {
|
|
@@ -72,25 +428,40 @@ export class HttpKbProvider {
|
|
|
72
428
|
let data = '';
|
|
73
429
|
res.on('data', (chunk) => { data += chunk.toString(); });
|
|
74
430
|
res.on('end', () => {
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
}
|
|
82
|
-
else {
|
|
83
|
-
resolve(parsed);
|
|
431
|
+
const status = res.statusCode;
|
|
432
|
+
if (status === 409) {
|
|
433
|
+
const mismatch = projectMismatchOf(data);
|
|
434
|
+
if (mismatch) {
|
|
435
|
+
reject(new KbHttpProjectMismatchError(this.displayUrl, mismatch.server, mismatch.client));
|
|
436
|
+
return;
|
|
84
437
|
}
|
|
85
438
|
}
|
|
439
|
+
if (status !== undefined && status >= 400) {
|
|
440
|
+
// An auth proxy in front of the KB answers 401 with
|
|
441
|
+
// an empty or HTML body. For a named-secret token the message is
|
|
442
|
+
// fixed text, so the proxy's page never reaches the tool result.
|
|
443
|
+
const text = nonJson401IsAuth && status === 401 && !isJsonText(data)
|
|
444
|
+
? 'KB server rejected the token'
|
|
445
|
+
: describeErrorBody(data);
|
|
446
|
+
const httpErr = new Error(redactToken(`HTTP ${status}: ${text}`, token));
|
|
447
|
+
httpErr.code = `HTTP_${status}`;
|
|
448
|
+
const serverCode = bodyCodeOf(data);
|
|
449
|
+
if (serverCode !== undefined)
|
|
450
|
+
httpErr.serverCode = serverCode;
|
|
451
|
+
reject(httpErr);
|
|
452
|
+
return;
|
|
453
|
+
}
|
|
454
|
+
try {
|
|
455
|
+
resolve(JSON.parse(data));
|
|
456
|
+
}
|
|
86
457
|
catch {
|
|
87
458
|
reject(new Error(`Invalid JSON response from KB server`));
|
|
88
459
|
}
|
|
89
460
|
});
|
|
90
461
|
res.on('error', reject);
|
|
91
462
|
});
|
|
92
|
-
req.setTimeout(
|
|
93
|
-
const err = new Error(
|
|
463
|
+
req.setTimeout(this.requestTimeoutMs, () => {
|
|
464
|
+
const err = new Error(`ETIMEDOUT: KB server request timed out after ${this.requestTimeoutMs} ms`);
|
|
94
465
|
err.code = 'ETIMEDOUT';
|
|
95
466
|
req.destroy(err);
|
|
96
467
|
});
|
|
@@ -100,44 +471,170 @@ export class HttpKbProvider {
|
|
|
100
471
|
req.end();
|
|
101
472
|
});
|
|
102
473
|
}
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
}
|
|
474
|
+
/**
|
|
475
|
+
* GET /api/kb/capabilities, read once per connection (again after a
|
|
476
|
+
* reconnect). A server without the route is assumed to serve
|
|
477
|
+
* KB_DEFAULT_CAPABILITIES: it answers 404 or 501, or (a catch-all handler)
|
|
478
|
+
* a body carrying none of contract/routes/branch_aware. Auth,
|
|
479
|
+
* project-mismatch and connection errors are thrown as they are for any
|
|
480
|
+
* route; a body that carries some of those fields but not all, well typed,
|
|
481
|
+
* is E-KB-HTTP-UNSUPPORTED.
|
|
482
|
+
*/
|
|
483
|
+
async capabilities() {
|
|
484
|
+
this.capabilitiesRead ??= this.readCapabilities();
|
|
485
|
+
try {
|
|
486
|
+
return await this.capabilitiesRead;
|
|
487
|
+
}
|
|
488
|
+
catch (err) {
|
|
489
|
+
this.capabilitiesRead = undefined;
|
|
490
|
+
throw err;
|
|
121
491
|
}
|
|
122
492
|
}
|
|
123
|
-
async
|
|
124
|
-
|
|
493
|
+
async readCapabilities() {
|
|
494
|
+
let body;
|
|
495
|
+
try {
|
|
496
|
+
body = await this.request('GET', '/api/kb/capabilities');
|
|
497
|
+
}
|
|
498
|
+
catch (err) {
|
|
499
|
+
const code = err.code;
|
|
500
|
+
if (code === 'HTTP_404' || code === 'HTTP_501')
|
|
501
|
+
return defaultCapabilities();
|
|
502
|
+
throw this.capabilitiesHttpError(err);
|
|
503
|
+
}
|
|
504
|
+
const caps = body;
|
|
505
|
+
const isObject = caps !== null && typeof caps === 'object' && !Array.isArray(caps);
|
|
506
|
+
if (!isObject || !('contract' in caps || 'routes' in caps || 'branch_aware' in caps))
|
|
507
|
+
return defaultCapabilities();
|
|
508
|
+
if (typeof caps.contract !== 'string'
|
|
509
|
+
|| !Array.isArray(caps.routes) || !caps.routes.every(r => typeof r === 'string')
|
|
510
|
+
|| typeof caps.branch_aware !== 'boolean') {
|
|
511
|
+
throw new KbHttpUnsupportedError(`GET /api/kb/capabilities (the KB server at ${this.displayUrl} answered without {contract, routes, branch_aware})`, 'nothing was sent', 'fix the KB server so its capabilities answer carries contract (string), routes (array of route names) and branch_aware (boolean).');
|
|
512
|
+
}
|
|
513
|
+
// Unknown route names are ignored: a newer server may list routes this client does not call.
|
|
514
|
+
const routes = caps.routes.filter((r) => KNOWN_ROUTES.includes(r));
|
|
515
|
+
return { contract: caps.contract, routes, branch_aware: caps.branch_aware };
|
|
125
516
|
}
|
|
126
|
-
|
|
127
|
-
|
|
517
|
+
/**
|
|
518
|
+
* A failed capabilities read as the typed error callers see. A 401 (literal
|
|
519
|
+
* token) and the already-typed errors pass through as on any route. Any
|
|
520
|
+
* other HTTP status is never a raw HTTP error: a 5xx or 429 (a restarting or
|
|
521
|
+
* rate-limiting server, a gateway with no backend) is E-KB-HTTP-UNREACHABLE
|
|
522
|
+
* naming the status (the caller's own request was never sent, so it is safe
|
|
523
|
+
* to retry); any other status (403/405 from a gateway) is
|
|
524
|
+
* E-KB-HTTP-UNSUPPORTED naming the capabilities read.
|
|
525
|
+
*/
|
|
526
|
+
capabilitiesHttpError(err) {
|
|
527
|
+
const code = err.code;
|
|
528
|
+
if (typeof code !== 'string' || !code.startsWith('HTTP_') || code === 'HTTP_401')
|
|
529
|
+
return err;
|
|
530
|
+
const status = Number(code.slice(5));
|
|
531
|
+
if (isServerUnavailable(err))
|
|
532
|
+
return this.serverUnavailableError('GET /api/kb/capabilities', err);
|
|
533
|
+
return new KbHttpUnsupportedError(`GET /api/kb/capabilities (the KB server at ${this.displayUrl} answered HTTP ${status})`, 'nothing was sent', 'fix the KB server (or the gateway in front of it) so GET /api/kb/capabilities answers {contract, routes, branch_aware}, or 404/501 when it has no such route.');
|
|
534
|
+
}
|
|
535
|
+
/**
|
|
536
|
+
* E-KB-HTTP-UNREACHABLE for a 5xx or 429 answer to the capabilities read,
|
|
537
|
+
* or a 429 or 503 answer to `operation` itself: the server's state
|
|
538
|
+
* (restarting, rate limiting, a gateway with no backend), never the fault
|
|
539
|
+
* of the request.
|
|
540
|
+
*/
|
|
541
|
+
serverUnavailableError(operation, err) {
|
|
542
|
+
return new KbHttpUnreachableError(this.displayUrl, operation, `${operation} answered ${err.message}`);
|
|
543
|
+
}
|
|
544
|
+
/** E-KB-HTTP-UNSUPPORTED naming `route`: the server does not serve it. */
|
|
545
|
+
routeUnsupported(route, why) {
|
|
546
|
+
return new KbHttpUnsupportedError(`the ${route} route (the KB server at ${this.displayUrl} ${why})`, 'nothing was sent', `use a KB server that serves the ${route} route, or a local SQLite KB (kb_setup provider sqlite).`);
|
|
547
|
+
}
|
|
548
|
+
/** Throws E-KB-HTTP-UNSUPPORTED naming `route` unless the server's capabilities list it. */
|
|
549
|
+
async requireRoute(route) {
|
|
550
|
+
const caps = await this.capabilities();
|
|
551
|
+
if (!caps.routes.includes(route))
|
|
552
|
+
throw this.routeUnsupported(route, 'does not list it in GET /api/kb/capabilities');
|
|
553
|
+
}
|
|
554
|
+
/** True when the server's capabilities list `route`. */
|
|
555
|
+
async servesRoute(route) {
|
|
556
|
+
return (await this.capabilities()).routes.includes(route);
|
|
557
|
+
}
|
|
558
|
+
/**
|
|
559
|
+
* One request to a route: refused before sending when the server's
|
|
560
|
+
* capabilities do not list it. For an optional route a 404 or 501 also means
|
|
561
|
+
* "not served" and becomes E-KB-HTTP-UNSUPPORTED, never a raw HTTP error --
|
|
562
|
+
* except a 404 whose body code says the ENTRY is unknown (ENTRY_NOT_FOUND /
|
|
563
|
+
* E-ENTRY-NOT-FOUND), which is passed on for the caller to report.
|
|
564
|
+
*/
|
|
565
|
+
async routeRequest(route, method, pathname, body, queryParams) {
|
|
566
|
+
try {
|
|
567
|
+
await this.requireRoute(route);
|
|
568
|
+
}
|
|
569
|
+
catch (err) {
|
|
570
|
+
// Name the operation the caller asked for, not the capabilities read.
|
|
571
|
+
if (err instanceof KbHttpUnreachableError) {
|
|
572
|
+
throw new KbHttpUnreachableError(this.displayUrl, `${method} ${pathname}`, err.causeText);
|
|
573
|
+
}
|
|
574
|
+
throw err;
|
|
575
|
+
}
|
|
128
576
|
try {
|
|
129
|
-
return await this.
|
|
577
|
+
return await this.request(method, pathname, body, queryParams);
|
|
130
578
|
}
|
|
131
579
|
catch (err) {
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
580
|
+
const code = err.code;
|
|
581
|
+
const optional = KB_OPTIONAL_ROUTES.includes(route);
|
|
582
|
+
const entryNotFound = code === 'HTTP_404' && ENTRY_NOT_FOUND_CODES.has(serverCodeOf(err) ?? '');
|
|
583
|
+
if (optional && !entryNotFound && (code === 'HTTP_404' || code === 'HTTP_501')) {
|
|
584
|
+
throw this.routeUnsupported(route, `answered ${method} ${pathname} with HTTP ${code.slice(5)}`);
|
|
135
585
|
}
|
|
136
586
|
throw err;
|
|
137
587
|
}
|
|
138
588
|
}
|
|
589
|
+
// Nothing to open locally: every operation is a request to the server.
|
|
590
|
+
async init() { }
|
|
591
|
+
/**
|
|
592
|
+
* One write request (capture, invalidate with files, feedback, promote,
|
|
593
|
+
* demote). Nothing is queued. Never a raw HTTP error:
|
|
594
|
+
* - a 429 or 503 answering the write is E-KB-HTTP-UNREACHABLE naming the
|
|
595
|
+
* status: the server refused it before handling it, so the caller may
|
|
596
|
+
* repeat it;
|
|
597
|
+
* - any other 5xx is E-KB-HTTP-SERVER-ERROR: the request reached the
|
|
598
|
+
* server, so whether it took effect is unknown and it must not be
|
|
599
|
+
* retried blindly;
|
|
600
|
+
* - a server that cannot be reached (or whose capabilities read answers
|
|
601
|
+
* 5xx/429, so the write is never sent) is E-KB-HTTP-UNREACHABLE, thrown
|
|
602
|
+
* as is for the caller to retry.
|
|
603
|
+
*/
|
|
604
|
+
async writeRequest(route, pathname, body) {
|
|
605
|
+
try {
|
|
606
|
+
return await this.routeRequest(route, 'POST', pathname, body);
|
|
607
|
+
}
|
|
608
|
+
catch (err) {
|
|
609
|
+
throw this.answeredError(err, `POST ${pathname}`, 'write');
|
|
610
|
+
}
|
|
611
|
+
}
|
|
612
|
+
/**
|
|
613
|
+
* One read request (query, context, prime, list). A 5xx or 429 answering it
|
|
614
|
+
* is never a raw HTTP error: 429 and 503 are E-KB-HTTP-UNREACHABLE naming
|
|
615
|
+
* the status, any other 5xx is E-KB-HTTP-SERVER-ERROR naming the status.
|
|
616
|
+
* Nothing is answered from a local store or the bible instead.
|
|
617
|
+
*/
|
|
618
|
+
async readRequest(route, method, pathname, body, queryParams) {
|
|
619
|
+
try {
|
|
620
|
+
return await this.routeRequest(route, method, pathname, body, queryParams);
|
|
621
|
+
}
|
|
622
|
+
catch (err) {
|
|
623
|
+
throw this.answeredError(err, `${method} ${pathname}`, 'read');
|
|
624
|
+
}
|
|
625
|
+
}
|
|
626
|
+
/** A 5xx or 429 answering `operation` as its typed error; any other error as is. */
|
|
627
|
+
answeredError(err, operation, kind) {
|
|
628
|
+
if (isRetryableStatus(err))
|
|
629
|
+
return this.serverUnavailableError(operation, err);
|
|
630
|
+
if (isServerUnavailable(err))
|
|
631
|
+
return new KbHttpServerError(this.displayUrl, operation, err.message, kind);
|
|
632
|
+
return err;
|
|
633
|
+
}
|
|
634
|
+
async capture(input) {
|
|
635
|
+
return this.writeRequest('capture', '/api/kb/capture', input);
|
|
636
|
+
}
|
|
139
637
|
async query(opts) {
|
|
140
|
-
await this.tryFlushQueue();
|
|
141
638
|
const params = {};
|
|
142
639
|
if (opts.query)
|
|
143
640
|
params.query = opts.query;
|
|
@@ -151,81 +648,266 @@ export class HttpKbProvider {
|
|
|
151
648
|
params.include_stale = 'true';
|
|
152
649
|
if (opts.include_superseded)
|
|
153
650
|
params.include_superseded = 'true';
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
651
|
+
if (opts.confidence?.length)
|
|
652
|
+
params.confidence = opts.confidence.join(',');
|
|
653
|
+
if (opts.exclude_disputed)
|
|
654
|
+
params.exclude_disputed = 'true';
|
|
655
|
+
if (opts.flagged_only)
|
|
656
|
+
params.flagged_only = 'true';
|
|
657
|
+
// Discrete FTS terms travel as a JSON array (a term may contain a comma).
|
|
658
|
+
if (opts.fts_terms?.length)
|
|
659
|
+
params.fts_terms = JSON.stringify(opts.fts_terms);
|
|
660
|
+
// Exact-id lookup (kb_query's L2 fetch), also a JSON array.
|
|
661
|
+
if (opts.ids?.length)
|
|
662
|
+
params.ids = JSON.stringify(opts.ids);
|
|
663
|
+
// MEMBER own-scope: the server narrows on the owner tag when the caller
|
|
664
|
+
// set no tag of its own; the result is re-filtered below either way, at
|
|
665
|
+
// every tier. A MEMBER mixed-tier read gets the other members' CONFIRMED
|
|
666
|
+
// entries from its CONFIRMED half (kb-self.ts getMemberSplitRead), never
|
|
667
|
+
// from an owner-tagged read.
|
|
668
|
+
const tag = opts.tag ?? opts.owner_tag;
|
|
669
|
+
if (tag)
|
|
670
|
+
params.tag = tag;
|
|
671
|
+
const result = await this.readRequest('query', 'GET', '/api/kb/query', undefined, params);
|
|
672
|
+
return opts.owner_tag ? this.keepOwned(result, opts.owner_tag, opts.tag) : result;
|
|
163
673
|
}
|
|
164
|
-
async context(files) {
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
674
|
+
async context(files, confidence, excludeDisputed, ownerTag) {
|
|
675
|
+
const ctxParams = { files: files.join(',') };
|
|
676
|
+
if (confidence?.length)
|
|
677
|
+
ctxParams.confidence = confidence.join(',');
|
|
678
|
+
if (excludeDisputed)
|
|
679
|
+
ctxParams.exclude_disputed = 'true';
|
|
680
|
+
// MEMBER own-scope: the server picks each file's newest entry among the
|
|
681
|
+
// caller's own (as the SQLite provider does in SQL), so another member's
|
|
682
|
+
// newer entry cannot hide it; ownership is re-checked below.
|
|
683
|
+
if (ownerTag)
|
|
684
|
+
ctxParams.tag = ownerTag;
|
|
685
|
+
const result = await this.readRequest('context', 'GET', '/api/kb/context', undefined, ctxParams);
|
|
686
|
+
if (!ownerTag)
|
|
168
687
|
return result.results;
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
}
|
|
174
|
-
throw err;
|
|
175
|
-
}
|
|
688
|
+
return this.keepOwnedSummaries(result.results, await this.ownedIds(ownerTag));
|
|
689
|
+
}
|
|
690
|
+
async discard(_ids, _opts) {
|
|
691
|
+
throw new KbHttpUnsupportedError('kb_invalidate {ids} (id-level discard)');
|
|
176
692
|
}
|
|
177
693
|
async invalidate(files) {
|
|
178
|
-
|
|
694
|
+
return this.writeRequest('invalidate', '/api/kb/invalidate', { files });
|
|
695
|
+
}
|
|
696
|
+
/**
|
|
697
|
+
* kb_feedback over the remote KB: POST /api/kb/feedback with the
|
|
698
|
+
* memory-contract v1 kb_feedback request body {id, reason, role} (role
|
|
699
|
+
* carries the already-validated author). The server owns the entry, so the
|
|
700
|
+
* server decides stale/flagged; this method returns its response as is and
|
|
701
|
+
* never writes or invents confidence, and never touches a local store.
|
|
702
|
+
* Nothing is queued: an unreachable server or a 429/503 answer
|
|
703
|
+
* (E-KB-HTTP-UNREACHABLE), any other 5xx answer (E-KB-HTTP-SERVER-ERROR)
|
|
704
|
+
* or a refused token
|
|
705
|
+
* (E-KB-HTTP-AUTH) is thrown for the caller to handle.
|
|
706
|
+
*/
|
|
707
|
+
async feedback(id, reason, author) {
|
|
708
|
+
return this.writeRequest('feedback', '/api/kb/feedback', { id, reason, role: author });
|
|
709
|
+
}
|
|
710
|
+
// No remote route for the entry graph, and no local store stands in for the
|
|
711
|
+
// server: an entry's links are not known here.
|
|
712
|
+
async getLinked(_id) {
|
|
713
|
+
return [];
|
|
714
|
+
}
|
|
715
|
+
// Delivery telemetry has no remote route. Nothing is written locally: the
|
|
716
|
+
// per-repo DB is not this KB.
|
|
717
|
+
async touch(_ids) {
|
|
718
|
+
return 0;
|
|
719
|
+
}
|
|
720
|
+
// "Is the row I hold still live CONFIRMED" is a question about a local
|
|
721
|
+
// store; over http there is none. The prime cold seed (the only caller)
|
|
722
|
+
// never runs under an http provider, so reaching this is a bug: refuse
|
|
723
|
+
// rather than answer from a local store.
|
|
724
|
+
getLiveConfirmedState(_ids) {
|
|
725
|
+
throw new KbHttpUnsupportedError('the bible liveness check', 'nothing was read', 'this is an internal call that must not run under the http KB provider; report it.');
|
|
726
|
+
}
|
|
727
|
+
// No remote route for related claims: degrade to "no related claims"
|
|
728
|
+
// rather than reading a local store.
|
|
729
|
+
async relatedClaims(_ids, _limit, _filter) {
|
|
730
|
+
return [];
|
|
731
|
+
}
|
|
732
|
+
async prime(opts) {
|
|
733
|
+
// owner_tag is internal (never part of the contract body); it is applied
|
|
734
|
+
// to the server's answer here instead.
|
|
735
|
+
const { owner_tag: ownerTag, ...body } = opts;
|
|
736
|
+
const primed = await this.readRequest('prime', 'POST', '/api/kb/prime', body);
|
|
737
|
+
if (!ownerTag)
|
|
738
|
+
return primed;
|
|
739
|
+
const owned = await this.ownedIds(ownerTag);
|
|
740
|
+
return {
|
|
741
|
+
...primed,
|
|
742
|
+
top_entries: (primed.top_entries ?? []).filter(e => hasTag(e, ownerTag)),
|
|
743
|
+
fresh_summaries: this.keepOwnedSummaries(primed.fresh_summaries ?? [], owned),
|
|
744
|
+
};
|
|
745
|
+
}
|
|
746
|
+
// Remote-only: the id exists on the server, so a connection error is
|
|
747
|
+
// surfaced instead of falling back to the local store.
|
|
748
|
+
// Promote by id, with no list lookup first: the server refuses an unknown,
|
|
749
|
+
// superseded or out-of-scope id itself, and that refusal is surfaced (a 404
|
|
750
|
+
// as the same "Entry not found: <id>" the SQLite provider throws, any other
|
|
751
|
+
// status with the server's own title/code/detail). opts.ownerTag (MEMBER
|
|
752
|
+
// own-scope) is not checked here: which entries a caller may promote is the
|
|
753
|
+
// server's scope decision, not a fleet-side tag check.
|
|
754
|
+
async promote(id, reason, opts) {
|
|
755
|
+
const body = { id };
|
|
756
|
+
if (reason !== undefined)
|
|
757
|
+
body.reason = reason;
|
|
758
|
+
let result;
|
|
179
759
|
try {
|
|
180
|
-
|
|
760
|
+
result = await this.writeRequest('promote', '/api/kb/promote', body);
|
|
181
761
|
}
|
|
182
762
|
catch (err) {
|
|
183
|
-
if (
|
|
184
|
-
|
|
185
|
-
|
|
763
|
+
if (err.code === 'HTTP_404') {
|
|
764
|
+
if (ENTRY_NOT_FOUND_CODES.has(serverCodeOf(err) ?? '')) {
|
|
765
|
+
throw entryNotFoundOnServer(id, err);
|
|
766
|
+
}
|
|
767
|
+
// Spec 2.9.1: an unknown entry is 404 with body code ENTRY_NOT_FOUND.
|
|
768
|
+
// Any other 404 is the route itself missing (a server older than
|
|
769
|
+
// the capabilities route that never served promote), not the entry.
|
|
770
|
+
throw new KbHttpUnsupportedError(`the promote route (the KB server at ${this.displayUrl} answered POST /api/kb/promote with ${err.message}, without body code ENTRY_NOT_FOUND)`, 'nothing was promoted', 'upgrade the KB server to one that serves POST /api/kb/promote and answers an unknown entry 404 with body code ENTRY_NOT_FOUND (memory-contract v1 spec 2.9.1).');
|
|
186
771
|
}
|
|
187
772
|
throw err;
|
|
188
773
|
}
|
|
774
|
+
const before = result?.previous_confidence;
|
|
775
|
+
const after = result?.new_confidence;
|
|
776
|
+
if (typeof before !== 'string' || typeof after !== 'string') {
|
|
777
|
+
throw new Error(`kb_promote: KB server at ${this.displayUrl} returned a promote response without `
|
|
778
|
+
+ `previous_confidence/new_confidence: ${JSON.stringify(result)}`);
|
|
779
|
+
}
|
|
780
|
+
return {
|
|
781
|
+
id: typeof result.id === 'string' ? result.id : id,
|
|
782
|
+
confidence_before: before,
|
|
783
|
+
confidence_after: after,
|
|
784
|
+
};
|
|
189
785
|
}
|
|
190
|
-
|
|
191
|
-
|
|
786
|
+
/**
|
|
787
|
+
* GET /api/kb/list, an optional route: a server that does not list it, or
|
|
788
|
+
* answers it 404/501, is E-KB-HTTP-UNSUPPORTED rather than a bare HTTP error.
|
|
789
|
+
*/
|
|
790
|
+
async listRequest(params) {
|
|
791
|
+
return this.readRequest('list', 'GET', '/api/kb/list', undefined, params);
|
|
192
792
|
}
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
793
|
+
/**
|
|
794
|
+
* Every live entry the server holds with `ownerTag`, any tier. Reads the
|
|
795
|
+
* no-bump list route, so an ownership check is not counted as a retrieval.
|
|
796
|
+
* Asks the server to narrow on the tag and re-checks each entry, so a server
|
|
797
|
+
* that ignores the tag parameter cannot widen the result. Throws
|
|
798
|
+
* KbHttpUnsupportedError when the server returns entries without a tags
|
|
799
|
+
* array: ownership cannot be decided then.
|
|
800
|
+
*/
|
|
801
|
+
async ownedEntries(ownerTag) {
|
|
802
|
+
const result = await this.listRequest({
|
|
803
|
+
tag: ownerTag,
|
|
804
|
+
confidence: 'CONFIRMED,INFERRED,UNVERIFIED',
|
|
805
|
+
include_stale: 'true',
|
|
806
|
+
limit: String(OWNED_LOOKUP_LIMIT),
|
|
807
|
+
});
|
|
808
|
+
const entries = result.results ?? [];
|
|
809
|
+
if (entries.some(e => !Array.isArray(e.tags))) {
|
|
810
|
+
throw new KbHttpUnsupportedError('member own-scope (the server returned entries without tags)', 'nothing was read', 'use a KB server that returns entry tags, or a local SQLite KB (kb_setup provider sqlite).');
|
|
202
811
|
}
|
|
812
|
+
return entries.filter(e => hasTag(e, ownerTag));
|
|
203
813
|
}
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
// must degrade to "no related claims", not fail a prime.
|
|
207
|
-
async relatedClaims(ids, limit) {
|
|
208
|
-
try {
|
|
209
|
-
return await this.fallback.relatedClaims(ids, limit);
|
|
210
|
-
}
|
|
211
|
-
catch {
|
|
212
|
-
return [];
|
|
213
|
-
}
|
|
814
|
+
async ownedIds(ownerTag) {
|
|
815
|
+
return new Set((await this.ownedEntries(ownerTag)).map(e => e.id));
|
|
214
816
|
}
|
|
215
|
-
|
|
216
|
-
|
|
817
|
+
/**
|
|
818
|
+
* kb_list over the server's no-bump GET /api/kb/list route, with the same
|
|
819
|
+
* options as SqliteProvider.list. A MEMBER own-scope read (owner_tag) asks
|
|
820
|
+
* the server to narrow on that tag when the caller set no tag of its own,
|
|
821
|
+
* and is re-filtered on the entries' tags either way. Remote-only: the
|
|
822
|
+
* listing is not answered from a local store when the server is down.
|
|
823
|
+
*/
|
|
824
|
+
async list(opts) {
|
|
825
|
+
const params = {};
|
|
826
|
+
if (opts.confidence?.length)
|
|
827
|
+
params.confidence = opts.confidence.join(',');
|
|
828
|
+
if (opts.type)
|
|
829
|
+
params.type = opts.type;
|
|
830
|
+
if (opts.module)
|
|
831
|
+
params.module = opts.module;
|
|
832
|
+
if (opts.symbol)
|
|
833
|
+
params.symbol = opts.symbol;
|
|
834
|
+
if (opts.exclude_disputed)
|
|
835
|
+
params.exclude_disputed = 'true';
|
|
836
|
+
if (opts.include_stale)
|
|
837
|
+
params.include_stale = 'true';
|
|
838
|
+
const tag = opts.tag ?? opts.owner_tag;
|
|
839
|
+
if (tag)
|
|
840
|
+
params.tag = tag;
|
|
841
|
+
// A limit is only exact when the server applied every filter itself: with
|
|
842
|
+
// both a caller tag and an owner tag, the owner filter runs here, after.
|
|
843
|
+
const filteredHere = opts.owner_tag !== undefined && opts.tag !== undefined;
|
|
844
|
+
if (opts.limit !== undefined && !filteredHere)
|
|
845
|
+
params.limit = String(opts.limit);
|
|
846
|
+
const result = await this.listRequest(params);
|
|
847
|
+
const entries = result.results ?? [];
|
|
848
|
+
if (opts.owner_tag === undefined)
|
|
849
|
+
return entries;
|
|
850
|
+
const owned = entries.filter(e => hasTag(e, opts.owner_tag) && (opts.tag === undefined || hasTag(e, opts.tag)));
|
|
851
|
+
return opts.limit !== undefined ? owned.slice(0, opts.limit) : owned;
|
|
852
|
+
}
|
|
853
|
+
/**
|
|
854
|
+
* Query results restricted to entries carrying ownerTag (and the caller's
|
|
855
|
+
* own tag filter, when it set one). Filtering happens after the server's
|
|
856
|
+
* limit, so a member can get fewer results than it asked for.
|
|
857
|
+
*/
|
|
858
|
+
keepOwned(result, ownerTag, tag) {
|
|
859
|
+
const results = (result.results ?? [])
|
|
860
|
+
.filter(e => hasTag(e, ownerTag) && (tag === undefined || hasTag(e, tag)));
|
|
861
|
+
return { ...result, results, total: results.length };
|
|
862
|
+
}
|
|
863
|
+
/**
|
|
864
|
+
* Context summaries carry only an entry id, so ownership is decided against
|
|
865
|
+
* the caller's own entry ids. A summary from another member's entry, or one
|
|
866
|
+
* with no entry id (ownership unknown), is reported as missing for that
|
|
867
|
+
* file, as the SQLite provider does when the caller has no entry for it.
|
|
868
|
+
*/
|
|
869
|
+
keepOwnedSummaries(results, owned) {
|
|
870
|
+
return results.map(r => r.entry_id === undefined || !owned.has(r.entry_id) ? { file: r.file, status: 'missing' } : r);
|
|
871
|
+
}
|
|
872
|
+
/**
|
|
873
|
+
* POST /api/kb/demote {id, reason, evidence_files}: an OPTIONAL route. Only
|
|
874
|
+
* sent when the server's capabilities list demote; otherwise (or on a 404 /
|
|
875
|
+
* 501 from the route) E-KB-HTTP-UNSUPPORTED naming the route, and nothing
|
|
876
|
+
* is changed. Like promote(), sent by id with no fleet-side tag check: the
|
|
877
|
+
* server enforces which ids the caller may demote (opts.ownerTag is not
|
|
878
|
+
* sent). An entry the server does not know is "Entry not found".
|
|
879
|
+
* The server validates evidence_files (spec 2.9.1); fleet checks first that
|
|
880
|
+
* each is repo-relative with no '..' segment and sends nothing otherwise.
|
|
881
|
+
*/
|
|
882
|
+
async demote(id, reason, evidenceFiles, _opts) {
|
|
883
|
+
const outside = evidenceFiles.filter(isAbsoluteOrTraversing);
|
|
884
|
+
if (outside.length > 0) {
|
|
885
|
+
throw new Error(`E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote evidence is absolute or contains a '..' segment: ${outside.join(', ')}. `
|
|
886
|
+
+ `Evidence paths are repo-relative; nothing was sent to the KB server. Entry: ${id}`);
|
|
887
|
+
}
|
|
888
|
+
let result;
|
|
217
889
|
try {
|
|
218
|
-
|
|
890
|
+
result = await this.writeRequest('demote', '/api/kb/demote', {
|
|
891
|
+
id, reason, evidence_files: evidenceFiles,
|
|
892
|
+
});
|
|
219
893
|
}
|
|
220
894
|
catch (err) {
|
|
221
|
-
if (
|
|
222
|
-
|
|
895
|
+
if (err.code === 'HTTP_404') {
|
|
896
|
+
throw entryNotFoundOnServer(id, err);
|
|
223
897
|
}
|
|
224
898
|
throw err;
|
|
225
899
|
}
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
900
|
+
const before = result?.previous_confidence;
|
|
901
|
+
const after = result?.new_confidence;
|
|
902
|
+
if (typeof before !== 'string' || typeof after !== 'string') {
|
|
903
|
+
throw new Error(`kb_demote: KB server at ${this.displayUrl} returned a demote response without `
|
|
904
|
+
+ `previous_confidence/new_confidence: ${JSON.stringify(result)}`);
|
|
905
|
+
}
|
|
906
|
+
return {
|
|
907
|
+
id: typeof result.id === 'string' ? result.id : id,
|
|
908
|
+
confidence_before: before,
|
|
909
|
+
confidence_after: after,
|
|
910
|
+
};
|
|
229
911
|
}
|
|
230
912
|
async sync(_opts) {
|
|
231
913
|
return { synced: false, reason: 'local-only provider' };
|