@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,3 +1,8 @@
|
|
|
1
|
+
import { type KbToolProfile } from '../kb-tool-profile.js';
|
|
2
|
+
/** Bounds and default for request_timeout_ms, shared by kb_setup (write) and the reader. */
|
|
3
|
+
export declare const MIN_REQUEST_TIMEOUT_MS = 1000;
|
|
4
|
+
export declare const MAX_REQUEST_TIMEOUT_MS = 120000;
|
|
5
|
+
export declare const DEFAULT_REQUEST_TIMEOUT_MS = 5000;
|
|
1
6
|
/**
|
|
2
7
|
* Result of reading FLEET_DIR/knowledge/config.json (the file src/tools/kb-setup.ts
|
|
3
8
|
* writes). Deliberately a standalone shape, NOT ProviderConfig from ./types.js --
|
|
@@ -6,7 +11,15 @@
|
|
|
6
11
|
export interface KbConfigResult {
|
|
7
12
|
provider: 'sqlite' | 'http';
|
|
8
13
|
url?: string;
|
|
14
|
+
/** Literal token (decrypted token_encrypted). Absent when tokenSecretName is set. */
|
|
9
15
|
token?: string;
|
|
16
|
+
/**
|
|
17
|
+
* Name of the fleet secret the token is read from on each request (from the
|
|
18
|
+
* token_ref placeholder). Absent for a literal-token config.
|
|
19
|
+
*/
|
|
20
|
+
tokenSecretName?: string;
|
|
21
|
+
/** Socket idle timeout per request for the http provider; absent means the provider default. */
|
|
22
|
+
requestTimeoutMs?: number;
|
|
10
23
|
}
|
|
11
24
|
/**
|
|
12
25
|
* On-disk shape of FLEET_DIR/knowledge/config.json. One file, several owners:
|
|
@@ -18,20 +31,71 @@ export interface KbConfigFile {
|
|
|
18
31
|
provider?: 'sqlite' | 'http';
|
|
19
32
|
url?: string;
|
|
20
33
|
token_encrypted?: string;
|
|
34
|
+
/** Canonical {{secret.NAME}} placeholder written by kb_setup instead of token_encrypted. */
|
|
35
|
+
token_ref?: string;
|
|
36
|
+
request_timeout_ms?: number;
|
|
21
37
|
bible?: {
|
|
22
38
|
autoCommit?: boolean;
|
|
23
39
|
};
|
|
40
|
+
/**
|
|
41
|
+
* Install-wide KB tool profile for FULL sessions (src/services/kb-tool-profile.ts):
|
|
42
|
+
* "full" (default when absent), "developer", or "custom" with the kb_* names
|
|
43
|
+
* in tool_profile_tools. Read by readKbToolProfileFromDisk.
|
|
44
|
+
*/
|
|
45
|
+
tool_profile?: 'full' | 'developer' | 'custom';
|
|
46
|
+
/** The kb_* tool names a "custom" tool_profile serves; ignored otherwise. */
|
|
47
|
+
tool_profile_tools?: string[];
|
|
24
48
|
[key: string]: unknown;
|
|
25
49
|
}
|
|
26
50
|
export declare const KB_CONFIG_PATH: string;
|
|
51
|
+
/**
|
|
52
|
+
* The KB config file cannot be read or parsed, as opposed to holding a bad
|
|
53
|
+
* value. The way out is a hand edit: anything that rewrites the file would
|
|
54
|
+
* lose what it holds (url, token_ref, ...). The message never quotes the file:
|
|
55
|
+
* a JSON parser's message can repeat part of it, including the encrypted token.
|
|
56
|
+
*/
|
|
57
|
+
export declare class KbConfigUnreadableError extends Error {
|
|
58
|
+
constructor(problem: string);
|
|
59
|
+
}
|
|
60
|
+
/** What to do about a KbConfigUnreadableError. */
|
|
61
|
+
export declare const KB_CONFIG_HAND_FIX = "Fix that file by hand (other settings in it, such as the remote url and token, are still there).";
|
|
62
|
+
/**
|
|
63
|
+
* The KB config as an object to merge into and write back: {} when absent.
|
|
64
|
+
* Throws KbConfigUnreadableError when the file cannot be read, is not valid
|
|
65
|
+
* JSON or is not a JSON object, so a writer never overwrites what it could not
|
|
66
|
+
* parse.
|
|
67
|
+
*/
|
|
68
|
+
export declare function readKbConfigForMerge(): KbConfigFile;
|
|
69
|
+
/**
|
|
70
|
+
* Read the install-wide KB tool profile from the KB config.
|
|
71
|
+
*
|
|
72
|
+
* - Absent file, or no tool_profile key -> full, silently (the stock path is
|
|
73
|
+
* never broken by this reader; it does not look at provider/token keys).
|
|
74
|
+
* - A known profile -> that profile; "custom" validates tool_profile_tools
|
|
75
|
+
* against the registered kb_* tool names.
|
|
76
|
+
* - An unreadable or malformed file throws KbConfigUnreadableError; an unknown
|
|
77
|
+
* profile name or an invalid custom list throws an Error naming this config
|
|
78
|
+
* path and the problem (for a custom list: the unknown names and the valid
|
|
79
|
+
* ones).
|
|
80
|
+
*/
|
|
81
|
+
export declare function readKbToolProfileFromDisk(): KbToolProfile;
|
|
82
|
+
/**
|
|
83
|
+
* The line fleet_status shows when the configured KB tool profile is invalid,
|
|
84
|
+
* or undefined when it is fine. An invalid profile never stops anything: FULL
|
|
85
|
+
* sessions fall back to every kb_* tool (tool-registry.ts), and this line is
|
|
86
|
+
* how a user or agent learns the setting they made is not applied. Never throws.
|
|
87
|
+
*/
|
|
88
|
+
export declare function kbToolProfileWarning(): string | undefined;
|
|
27
89
|
/**
|
|
28
90
|
* Read the KB provider config kb_setup wrote (provider/url/token_encrypted). Nothing
|
|
29
91
|
* currently reads this file back -- this restores that capability as a pure reader with
|
|
30
|
-
* no side effects, so a later task can wire it into getKbProviders.
|
|
92
|
+
* no side effects other than a logged warning (see readRequestTimeout), so a later task can wire it into getKbProviders.
|
|
31
93
|
*
|
|
32
94
|
* - Absent file, or provider missing/"sqlite" -> { provider: 'sqlite' }, silently,
|
|
33
95
|
* without ever touching token_encrypted (a corrupt token must never break the
|
|
34
96
|
* stock sqlite path).
|
|
97
|
+
* - provider "http" with token_ref ({{secret.NAME}}) -> { provider: 'http', url, tokenSecretName }.
|
|
98
|
+
* The secret itself is NOT read here: HttpKbProvider looks it up per request.
|
|
35
99
|
* - provider "http" -> decrypts token_encrypted and returns { provider: 'http', url, token }.
|
|
36
100
|
* Missing url, missing token_encrypted, or a decryption failure all throw a
|
|
37
101
|
* descriptive Error naming this config path and the failing key -- never a silent
|
|
@@ -2,15 +2,115 @@ import fs from 'node:fs';
|
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
import { FLEET_DIR } from '../../paths.js';
|
|
4
4
|
import { decryptPassword } from '../../utils/crypto.js';
|
|
5
|
+
import { logWarn } from '../../utils/log-helpers.js';
|
|
6
|
+
import { findSecretTokens } from '../secret-token.js';
|
|
7
|
+
import { FULL_KB_TOOL_PROFILE, makeKbToolProfile } from '../kb-tool-profile.js';
|
|
8
|
+
/** Bounds and default for request_timeout_ms, shared by kb_setup (write) and the reader. */
|
|
9
|
+
export const MIN_REQUEST_TIMEOUT_MS = 1000;
|
|
10
|
+
export const MAX_REQUEST_TIMEOUT_MS = 120000;
|
|
11
|
+
export const DEFAULT_REQUEST_TIMEOUT_MS = 5000;
|
|
5
12
|
export const KB_CONFIG_PATH = path.join(FLEET_DIR, 'knowledge', 'config.json');
|
|
13
|
+
/**
|
|
14
|
+
* The KB config file cannot be read or parsed, as opposed to holding a bad
|
|
15
|
+
* value. The way out is a hand edit: anything that rewrites the file would
|
|
16
|
+
* lose what it holds (url, token_ref, ...). The message never quotes the file:
|
|
17
|
+
* a JSON parser's message can repeat part of it, including the encrypted token.
|
|
18
|
+
*/
|
|
19
|
+
export class KbConfigUnreadableError extends Error {
|
|
20
|
+
constructor(problem) {
|
|
21
|
+
super(`KB config at ${KB_CONFIG_PATH} ${problem}`);
|
|
22
|
+
this.name = 'KbConfigUnreadableError';
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
/** What to do about a KbConfigUnreadableError. */
|
|
26
|
+
export const KB_CONFIG_HAND_FIX = 'Fix that file by hand (other settings in it, such as the remote url and token, are still there).';
|
|
27
|
+
/** Parse the KB config, or throw KbConfigUnreadableError. Undefined when the file is absent. */
|
|
28
|
+
function parseKbConfigFile() {
|
|
29
|
+
if (!fs.existsSync(KB_CONFIG_PATH))
|
|
30
|
+
return undefined;
|
|
31
|
+
let raw;
|
|
32
|
+
try {
|
|
33
|
+
raw = fs.readFileSync(KB_CONFIG_PATH, 'utf-8');
|
|
34
|
+
}
|
|
35
|
+
catch (err) {
|
|
36
|
+
throw new KbConfigUnreadableError(`cannot be read (${err.code ?? 'unknown error'})`);
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
return JSON.parse(raw);
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
throw new KbConfigUnreadableError('is not valid JSON');
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* The KB config as an object to merge into and write back: {} when absent.
|
|
47
|
+
* Throws KbConfigUnreadableError when the file cannot be read, is not valid
|
|
48
|
+
* JSON or is not a JSON object, so a writer never overwrites what it could not
|
|
49
|
+
* parse.
|
|
50
|
+
*/
|
|
51
|
+
export function readKbConfigForMerge() {
|
|
52
|
+
const parsed = parseKbConfigFile();
|
|
53
|
+
if (parsed === undefined)
|
|
54
|
+
return {};
|
|
55
|
+
if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
56
|
+
throw new KbConfigUnreadableError('is not a JSON object');
|
|
57
|
+
}
|
|
58
|
+
return parsed;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Read the install-wide KB tool profile from the KB config.
|
|
62
|
+
*
|
|
63
|
+
* - Absent file, or no tool_profile key -> full, silently (the stock path is
|
|
64
|
+
* never broken by this reader; it does not look at provider/token keys).
|
|
65
|
+
* - A known profile -> that profile; "custom" validates tool_profile_tools
|
|
66
|
+
* against the registered kb_* tool names.
|
|
67
|
+
* - An unreadable or malformed file throws KbConfigUnreadableError; an unknown
|
|
68
|
+
* profile name or an invalid custom list throws an Error naming this config
|
|
69
|
+
* path and the problem (for a custom list: the unknown names and the valid
|
|
70
|
+
* ones).
|
|
71
|
+
*/
|
|
72
|
+
export function readKbToolProfileFromDisk() {
|
|
73
|
+
const parsed = parseKbConfigFile();
|
|
74
|
+
if (parsed === undefined || parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
|
|
75
|
+
return FULL_KB_TOOL_PROFILE;
|
|
76
|
+
const config = parsed;
|
|
77
|
+
if (config.tool_profile === undefined)
|
|
78
|
+
return FULL_KB_TOOL_PROFILE;
|
|
79
|
+
try {
|
|
80
|
+
return makeKbToolProfile(config.tool_profile, config.tool_profile_tools);
|
|
81
|
+
}
|
|
82
|
+
catch (err) {
|
|
83
|
+
throw new Error(`KB config at ${KB_CONFIG_PATH}: ${err.message}`);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* The line fleet_status shows when the configured KB tool profile is invalid,
|
|
88
|
+
* or undefined when it is fine. An invalid profile never stops anything: FULL
|
|
89
|
+
* sessions fall back to every kb_* tool (tool-registry.ts), and this line is
|
|
90
|
+
* how a user or agent learns the setting they made is not applied. Never throws.
|
|
91
|
+
*/
|
|
92
|
+
export function kbToolProfileWarning() {
|
|
93
|
+
try {
|
|
94
|
+
readKbToolProfileFromDisk();
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
catch (err) {
|
|
98
|
+
const fix = err instanceof KbConfigUnreadableError
|
|
99
|
+
? KB_CONFIG_HAND_FIX
|
|
100
|
+
: 'Set a valid one with: apra-fleet kb profile <full | developer | custom tool1,tool2>.';
|
|
101
|
+
return `KB tool profile not applied, serving every kb_* tool. ${err.message}. ${fix} Reconnect to pick up the change.`;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
6
104
|
/**
|
|
7
105
|
* Read the KB provider config kb_setup wrote (provider/url/token_encrypted). Nothing
|
|
8
106
|
* currently reads this file back -- this restores that capability as a pure reader with
|
|
9
|
-
* no side effects, so a later task can wire it into getKbProviders.
|
|
107
|
+
* no side effects other than a logged warning (see readRequestTimeout), so a later task can wire it into getKbProviders.
|
|
10
108
|
*
|
|
11
109
|
* - Absent file, or provider missing/"sqlite" -> { provider: 'sqlite' }, silently,
|
|
12
110
|
* without ever touching token_encrypted (a corrupt token must never break the
|
|
13
111
|
* stock sqlite path).
|
|
112
|
+
* - provider "http" with token_ref ({{secret.NAME}}) -> { provider: 'http', url, tokenSecretName }.
|
|
113
|
+
* The secret itself is NOT read here: HttpKbProvider looks it up per request.
|
|
14
114
|
* - provider "http" -> decrypts token_encrypted and returns { provider: 'http', url, token }.
|
|
15
115
|
* Missing url, missing token_encrypted, or a decryption failure all throw a
|
|
16
116
|
* descriptive Error naming this config path and the failing key -- never a silent
|
|
@@ -38,9 +138,18 @@ export function readKbConfigFromDisk() {
|
|
|
38
138
|
if (!url) {
|
|
39
139
|
throw new Error(`KB config at ${KB_CONFIG_PATH} selects provider "http" but is missing required key "url"`);
|
|
40
140
|
}
|
|
141
|
+
const requestTimeoutField = 'request_timeout_ms' in parsed
|
|
142
|
+
? { requestTimeoutMs: readRequestTimeout(parsed.request_timeout_ms) }
|
|
143
|
+
: {};
|
|
144
|
+
// token_ref (a {{secret.NAME}} placeholder kb_setup stored instead of the
|
|
145
|
+
// value) wins over token_encrypted: kb_setup never writes both, and the
|
|
146
|
+
// reference is what the operator asked for most recently if a hand edit did.
|
|
147
|
+
if (typeof parsed.token_ref === 'string') {
|
|
148
|
+
return { provider: 'http', url, tokenSecretName: readTokenRef(parsed.token_ref), ...requestTimeoutField };
|
|
149
|
+
}
|
|
41
150
|
const tokenEncrypted = typeof parsed.token_encrypted === 'string' ? parsed.token_encrypted : undefined;
|
|
42
151
|
if (!tokenEncrypted) {
|
|
43
|
-
throw new Error(`KB config at ${KB_CONFIG_PATH} selects provider "http" but is missing required key "token_encrypted"`);
|
|
152
|
+
throw new Error(`KB config at ${KB_CONFIG_PATH} selects provider "http" but is missing required key "token_encrypted" (or "token_ref")`);
|
|
44
153
|
}
|
|
45
154
|
let token;
|
|
46
155
|
try {
|
|
@@ -49,6 +158,37 @@ export function readKbConfigFromDisk() {
|
|
|
49
158
|
catch (err) {
|
|
50
159
|
throw new Error(`KB config at ${KB_CONFIG_PATH} has an undecryptable "token_encrypted": ${err.message}`);
|
|
51
160
|
}
|
|
52
|
-
return { provider: 'http', url, token };
|
|
161
|
+
return { provider: 'http', url, token, ...requestTimeoutField };
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* The secret name inside a token_ref value. It must be exactly one placeholder
|
|
165
|
+
* ({{secret.NAME}}, or the legacy {{secure.NAME}}) and nothing else -- the
|
|
166
|
+
* same rule kb_setup applies on write, re-checked here for hand edits.
|
|
167
|
+
*/
|
|
168
|
+
function readTokenRef(value) {
|
|
169
|
+
const matches = findSecretTokens(value);
|
|
170
|
+
if (matches.length !== 1 || matches[0].raw !== value) {
|
|
171
|
+
throw new Error(`KB config at ${KB_CONFIG_PATH} has a "token_ref" that is not exactly one secret placeholder of the form {{secret.NAME}}`);
|
|
172
|
+
}
|
|
173
|
+
return matches[0].name;
|
|
174
|
+
}
|
|
175
|
+
/** True when value is an integer within the request_timeout_ms bounds. */
|
|
176
|
+
function isValidRequestTimeout(value) {
|
|
177
|
+
return Number.isInteger(value)
|
|
178
|
+
&& value >= MIN_REQUEST_TIMEOUT_MS
|
|
179
|
+
&& value <= MAX_REQUEST_TIMEOUT_MS;
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* kb_setup refuses an out-of-range value on write, but the file can be edited
|
|
183
|
+
* by hand. Applying the same bounds on read keeps a value like 3e9 from
|
|
184
|
+
* effectively disabling the timeout; falling back (instead of throwing) keeps
|
|
185
|
+
* an existing config working.
|
|
186
|
+
*/
|
|
187
|
+
function readRequestTimeout(value) {
|
|
188
|
+
if (isValidRequestTimeout(value))
|
|
189
|
+
return value;
|
|
190
|
+
logWarn('kb_config', `KB config at ${KB_CONFIG_PATH} has request_timeout_ms ${JSON.stringify(value)}, not an integer between ` +
|
|
191
|
+
`${MIN_REQUEST_TIMEOUT_MS} and ${MAX_REQUEST_TIMEOUT_MS}; using the default ${DEFAULT_REQUEST_TIMEOUT_MS}`);
|
|
192
|
+
return DEFAULT_REQUEST_TIMEOUT_MS;
|
|
53
193
|
}
|
|
54
194
|
//# sourceMappingURL=kb-config.js.map
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-remote-KB auth signals, recorded by HttpKbProvider and read by
|
|
3
|
+
* fleet_status (src/tools/check-status.ts): when this process last had a KB
|
|
4
|
+
* call accepted by the remote server, and when one was last rejected for auth
|
|
5
|
+
* (HTTP 401). Process memory only -- a restart starts with "never" for both,
|
|
6
|
+
* which is what fleet_status shows until the first call.
|
|
7
|
+
*
|
|
8
|
+
* Keyed by the remote KB URL (trailing slash dropped), not by provider object:
|
|
9
|
+
* a config change replaces the HttpKbProvider instance, but fleet_status only
|
|
10
|
+
* knows the URL from the config file. Nothing here ever holds a token.
|
|
11
|
+
*/
|
|
12
|
+
export interface KbHttpAuthState {
|
|
13
|
+
/** ISO time of the last request the remote KB server answered with a success (status below 400). */
|
|
14
|
+
lastSuccessAt?: string;
|
|
15
|
+
/** ISO time of the last request the remote KB server rejected with HTTP 401. */
|
|
16
|
+
lastRejectedAt?: string;
|
|
17
|
+
}
|
|
18
|
+
/** The key a remote KB URL is recorded under. */
|
|
19
|
+
export declare function kbHttpAuthStateKey(url: string): string;
|
|
20
|
+
export declare function recordKbHttpSuccess(url: string, at?: Date): void;
|
|
21
|
+
export declare function recordKbHttpRejected(url: string, at?: Date): void;
|
|
22
|
+
/** A copy of the recorded signals for a remote KB URL; empty when none yet. */
|
|
23
|
+
export declare function getKbHttpAuthState(url: string): KbHttpAuthState;
|
|
24
|
+
/** Test helper: forget every recorded signal. */
|
|
25
|
+
export declare function resetKbHttpAuthState(): void;
|
|
26
|
+
//# sourceMappingURL=kb-http-auth-state.d.ts.map
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-remote-KB auth signals, recorded by HttpKbProvider and read by
|
|
3
|
+
* fleet_status (src/tools/check-status.ts): when this process last had a KB
|
|
4
|
+
* call accepted by the remote server, and when one was last rejected for auth
|
|
5
|
+
* (HTTP 401). Process memory only -- a restart starts with "never" for both,
|
|
6
|
+
* which is what fleet_status shows until the first call.
|
|
7
|
+
*
|
|
8
|
+
* Keyed by the remote KB URL (trailing slash dropped), not by provider object:
|
|
9
|
+
* a config change replaces the HttpKbProvider instance, but fleet_status only
|
|
10
|
+
* knows the URL from the config file. Nothing here ever holds a token.
|
|
11
|
+
*/
|
|
12
|
+
const _states = new Map();
|
|
13
|
+
/** The key a remote KB URL is recorded under. */
|
|
14
|
+
export function kbHttpAuthStateKey(url) {
|
|
15
|
+
return url.replace(/\/+$/, '');
|
|
16
|
+
}
|
|
17
|
+
function slot(url) {
|
|
18
|
+
const key = kbHttpAuthStateKey(url);
|
|
19
|
+
let state = _states.get(key);
|
|
20
|
+
if (!state) {
|
|
21
|
+
state = {};
|
|
22
|
+
_states.set(key, state);
|
|
23
|
+
}
|
|
24
|
+
return state;
|
|
25
|
+
}
|
|
26
|
+
export function recordKbHttpSuccess(url, at = new Date()) {
|
|
27
|
+
slot(url).lastSuccessAt = at.toISOString();
|
|
28
|
+
}
|
|
29
|
+
export function recordKbHttpRejected(url, at = new Date()) {
|
|
30
|
+
slot(url).lastRejectedAt = at.toISOString();
|
|
31
|
+
}
|
|
32
|
+
/** A copy of the recorded signals for a remote KB URL; empty when none yet. */
|
|
33
|
+
export function getKbHttpAuthState(url) {
|
|
34
|
+
return { ..._states.get(kbHttpAuthStateKey(url)) };
|
|
35
|
+
}
|
|
36
|
+
/** Test helper: forget every recorded signal. */
|
|
37
|
+
export function resetKbHttpAuthState() {
|
|
38
|
+
_states.clear();
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=kb-http-auth-state.js.map
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { KbAnchor } from './kb-self.js';
|
|
2
|
+
export type KbMaintainerGrantErrorCode = 'E-KB-MAINTAINER-REQUIRED';
|
|
3
|
+
export declare class KbMaintainerGrantError extends Error {
|
|
4
|
+
readonly code: KbMaintainerGrantErrorCode;
|
|
5
|
+
readonly remediation: string;
|
|
6
|
+
constructor(problem: string, remediation: string);
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* True when the executing tool call comes from a MEMBER session that does NOT
|
|
10
|
+
* carry the kb_maintainer grant. False for a FULL session, for an in-process
|
|
11
|
+
* caller passing an explicit KbAnchor (same predicate as memberOwnerTag), and
|
|
12
|
+
* for the kb_maintainer member session.
|
|
13
|
+
*/
|
|
14
|
+
export declare function memberLacksKbMaintainer(anchor?: KbAnchor): boolean;
|
|
15
|
+
//# sourceMappingURL=kb-maintainer-grant.d.ts.map
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
// The kb_maintainer grant, as seen from inside a kb_* tool handler.
|
|
2
|
+
//
|
|
3
|
+
// A MEMBER session carries the grant only when the engine opened it as a
|
|
4
|
+
// repository's kb_maintainer (origin=engine&kb_maintainer=1, see
|
|
5
|
+
// src/services/tool-scope.ts). Tool exposure (member-tool-allowlist.ts) keeps
|
|
6
|
+
// the CONFIRMED-minting tools off every other member session; this module is
|
|
7
|
+
// for the tools every member session IS served but whose particular input can
|
|
8
|
+
// mint or retire CONFIRMED (kb_import with an explicit path, kb_invalidate of a
|
|
9
|
+
// CONFIRMED entry). Like the grant itself it is a routing guard that keeps agent
|
|
10
|
+
// sessions off those paths, not a security boundary against a local process
|
|
11
|
+
// (which can open a FULL session).
|
|
12
|
+
import { getSessionKbMaintainer, getSessionMemberId } from '../tool-scope.js';
|
|
13
|
+
export class KbMaintainerGrantError extends Error {
|
|
14
|
+
code;
|
|
15
|
+
remediation;
|
|
16
|
+
constructor(problem, remediation) {
|
|
17
|
+
super(`E-KB-MAINTAINER-REQUIRED: ${problem} Remediation: ${remediation}`);
|
|
18
|
+
this.name = 'KbMaintainerGrantError';
|
|
19
|
+
this.code = 'E-KB-MAINTAINER-REQUIRED';
|
|
20
|
+
this.remediation = remediation;
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* True when the executing tool call comes from a MEMBER session that does NOT
|
|
25
|
+
* carry the kb_maintainer grant. False for a FULL session, for an in-process
|
|
26
|
+
* caller passing an explicit KbAnchor (same predicate as memberOwnerTag), and
|
|
27
|
+
* for the kb_maintainer member session.
|
|
28
|
+
*/
|
|
29
|
+
export function memberLacksKbMaintainer(anchor) {
|
|
30
|
+
if (anchor !== undefined)
|
|
31
|
+
return false;
|
|
32
|
+
return getSessionMemberId() !== undefined && !getSessionKbMaintainer();
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=kb-maintainer-grant.js.map
|
|
@@ -6,13 +6,24 @@ export interface KbProviders {
|
|
|
6
6
|
projectSlug: string;
|
|
7
7
|
}
|
|
8
8
|
export declare function createKbProviders(cwd?: string, remoteUrl?: string): Promise<KbProviders>;
|
|
9
|
+
/** The single shared global KB provider. */
|
|
10
|
+
export declare function getGlobalKbProvider(): Promise<SqliteProvider>;
|
|
11
|
+
/**
|
|
12
|
+
* True when the KB config selects the http project provider, decided from the
|
|
13
|
+
* config file alone: no provider is built and no per-repo kb.sqlite is opened.
|
|
14
|
+
* A config that fails to read gives false, the same SQLite decision
|
|
15
|
+
* selectProjectProvider makes for it (and warns about on the next provider build).
|
|
16
|
+
*/
|
|
17
|
+
export declare function kbConfigSelectsHttp(): boolean;
|
|
18
|
+
/** The project slug (KB identity) for a repo folder, cached like getKbProviders'. */
|
|
19
|
+
export declare function getProjectSlug(cwd?: string, remoteUrl?: string): string;
|
|
9
20
|
/**
|
|
10
21
|
* Resolve the KB providers for a repo. `cwd` should be the repo the call is
|
|
11
22
|
* about -- omitting it falls back to the calling process's cwd, which is only
|
|
12
23
|
* correct for single-repo CLI invocations, never for server-handled tool calls.
|
|
13
24
|
*
|
|
14
|
-
* Returns the identical object for repeated calls on the same (slug, repoPath
|
|
15
|
-
* while the KB config is unchanged. Once the config content changes, the next
|
|
25
|
+
* Returns the identical object for repeated calls on the same (slug, repoPath,
|
|
26
|
+
* remoteUrl) while the KB config is unchanged. Once the config content changes, the next
|
|
16
27
|
* call selects the project provider afresh; the SqliteProviders underneath are
|
|
17
28
|
* reused, never reopened.
|
|
18
29
|
*/
|
|
@@ -5,16 +5,21 @@ import { SqliteProvider } from './sqlite-provider.js';
|
|
|
5
5
|
import { HttpKbProvider } from './http-provider.js';
|
|
6
6
|
import { readKbConfigFromDisk, KB_CONFIG_PATH } from './kb-config.js';
|
|
7
7
|
import { resolveProjectSlug } from './project-slug.js';
|
|
8
|
+
import { resolveRepositoryIdentity } from './repository-header.js';
|
|
8
9
|
import { FLEET_DIR } from '../../paths.js';
|
|
9
10
|
import { logWarn } from '../../utils/log-helpers.js';
|
|
10
11
|
export async function createKbProviders(cwd, remoteUrl) {
|
|
11
|
-
return createKbProvidersForSlug(slugFor(cwd, remoteUrl), cwd ?? process.cwd());
|
|
12
|
+
return createKbProvidersForSlug(slugFor(cwd, remoteUrl), cwd ?? process.cwd(), remoteUrl);
|
|
12
13
|
}
|
|
13
14
|
// There is exactly ONE global KB, shared by every project. Now that providers
|
|
14
15
|
// are cached per project slug, building it inside the per-slug factory would
|
|
15
16
|
// open a separate connection to the same file for every repo the process
|
|
16
17
|
// touches -- so it gets its own single-slot cache.
|
|
17
18
|
let _globalProvider = null;
|
|
19
|
+
/** The single shared global KB provider. */
|
|
20
|
+
export function getGlobalKbProvider() {
|
|
21
|
+
return getGlobalProvider();
|
|
22
|
+
}
|
|
18
23
|
function getGlobalProvider() {
|
|
19
24
|
if (!_globalProvider) {
|
|
20
25
|
_globalProvider = (async () => {
|
|
@@ -39,12 +44,12 @@ async function createBaseProvidersForSlug(slug, repoPath) {
|
|
|
39
44
|
const global = await getGlobalProvider();
|
|
40
45
|
return { projectSqlite, global };
|
|
41
46
|
}
|
|
42
|
-
async function createKbProvidersForSlug(slug, repoPath) {
|
|
43
|
-
return withSelectedProject(await createBaseProvidersForSlug(slug, repoPath), slug, kbConfigFingerprint());
|
|
47
|
+
async function createKbProvidersForSlug(slug, repoPath, remoteUrl) {
|
|
48
|
+
return withSelectedProject(await createBaseProvidersForSlug(slug, repoPath), slug, repoPath, remoteUrl, kbConfigFingerprint());
|
|
44
49
|
}
|
|
45
|
-
async function withSelectedProject(base, slug, configFingerprint) {
|
|
50
|
+
async function withSelectedProject(base, slug, repoPath, remoteUrl, configFingerprint) {
|
|
46
51
|
return {
|
|
47
|
-
project: await selectProjectProvider(base.projectSqlite, configFingerprint),
|
|
52
|
+
project: await selectProjectProvider(base.projectSqlite, repoPath, remoteUrl, configFingerprint, slug),
|
|
48
53
|
global: base.global,
|
|
49
54
|
projectSlug: slug,
|
|
50
55
|
};
|
|
@@ -94,11 +99,14 @@ function kbConfigFingerprint() {
|
|
|
94
99
|
* after a warning, once per distinct config content -- see the note above
|
|
95
100
|
* _warnedKbConfigFailures.
|
|
96
101
|
*
|
|
97
|
-
* The HTTP branch
|
|
98
|
-
*
|
|
99
|
-
*
|
|
102
|
+
* The HTTP branch gives HttpKbProvider no local store: over http the KB
|
|
103
|
+
* server is the only source of truth. It passes the resolved repository (repoPath's origin remote and HEAD,
|
|
104
|
+
* or the remote member's remoteUrl), which HttpKbProvider sends as the
|
|
105
|
+
* X-Repository / X-Repository-Commit / X-Repository-Branch headers (commit and
|
|
106
|
+
* branch only for a local folder) so a shared remote KB can keep
|
|
107
|
+
* repositories apart. It comes only from the resolved anchor, never tool input.
|
|
100
108
|
*/
|
|
101
|
-
async function selectProjectProvider(projectProvider, configFingerprint) {
|
|
109
|
+
async function selectProjectProvider(projectProvider, repoPath, remoteUrl, configFingerprint, slug) {
|
|
102
110
|
let config;
|
|
103
111
|
try {
|
|
104
112
|
config = readKbConfigFromDisk();
|
|
@@ -114,25 +122,49 @@ async function selectProjectProvider(projectProvider, configFingerprint) {
|
|
|
114
122
|
return projectProvider;
|
|
115
123
|
}
|
|
116
124
|
// my-beads-db-u00.4: the HTTP provider is init'd like any other provider,
|
|
117
|
-
//
|
|
118
|
-
//
|
|
119
|
-
//
|
|
120
|
-
//
|
|
121
|
-
//
|
|
122
|
-
//
|
|
123
|
-
//
|
|
124
|
-
const
|
|
125
|
+
// so any setup HttpKbProvider.init() grows later runs here instead of being
|
|
126
|
+
// skipped.
|
|
127
|
+
// readKbConfigFromDisk throws on http-without-url/token, so the url and one
|
|
128
|
+
// token source are present here. A token_ref config hands the provider the
|
|
129
|
+
// secret NAME, never a value: the provider looks it up on every request, so a
|
|
130
|
+
// secret update (which does not change config.json, hence never re-selects
|
|
131
|
+
// here) still takes effect on the next call.
|
|
132
|
+
const tokenSource = config.tokenSecretName !== undefined
|
|
133
|
+
? { secretName: config.tokenSecretName }
|
|
134
|
+
: config.token;
|
|
135
|
+
const repository = resolveRepositoryIdentity(repoPath, remoteUrl);
|
|
136
|
+
// The slug goes on every request (X-KB-Project) so a server for another
|
|
137
|
+
// project refuses it instead of answering with that project's KB.
|
|
138
|
+
const httpProvider = new HttpKbProvider(config.url, tokenSource, {
|
|
139
|
+
requestTimeoutMs: config.requestTimeoutMs,
|
|
140
|
+
projectSlug: slug,
|
|
141
|
+
...(repository ? { repository } : {}),
|
|
142
|
+
});
|
|
125
143
|
try {
|
|
126
144
|
await httpProvider.init();
|
|
127
145
|
}
|
|
128
146
|
catch (err) {
|
|
129
|
-
// Not yet tracked in _httpProviders, so
|
|
147
|
+
// Not yet tracked in _httpProviders, so dispose it here.
|
|
130
148
|
httpProvider.dispose();
|
|
131
149
|
throw err;
|
|
132
150
|
}
|
|
133
151
|
_httpProviders.push(httpProvider);
|
|
134
152
|
return httpProvider;
|
|
135
153
|
}
|
|
154
|
+
/**
|
|
155
|
+
* True when the KB config selects the http project provider, decided from the
|
|
156
|
+
* config file alone: no provider is built and no per-repo kb.sqlite is opened.
|
|
157
|
+
* A config that fails to read gives false, the same SQLite decision
|
|
158
|
+
* selectProjectProvider makes for it (and warns about on the next provider build).
|
|
159
|
+
*/
|
|
160
|
+
export function kbConfigSelectsHttp() {
|
|
161
|
+
try {
|
|
162
|
+
return readKbConfigFromDisk().provider === 'http';
|
|
163
|
+
}
|
|
164
|
+
catch {
|
|
165
|
+
return false;
|
|
166
|
+
}
|
|
167
|
+
}
|
|
136
168
|
// Keyed by (slug, repoPath), NOT slug alone and NOT a single slot. The fleet
|
|
137
169
|
// server is a long-lived process serving many members across many repos; a
|
|
138
170
|
// single memoised provider meant the first kb_* call bound every later call
|
|
@@ -146,6 +178,15 @@ const _selections = new Map();
|
|
|
146
178
|
function providerKey(slug, repoPath) {
|
|
147
179
|
return `${slug}\0${repoPath}`;
|
|
148
180
|
}
|
|
181
|
+
// A selection also carries the repository the HTTP provider sends, which is a
|
|
182
|
+
// function of (repoPath, remoteUrl): slugs are lossy, so two remotes can share
|
|
183
|
+
// a slug, and a remoteUrl means the folder is on another host (no commit). The
|
|
184
|
+
// remoteUrl is therefore part of the selection key, so a cached selection can
|
|
185
|
+
// never hand out a provider sending another repository. The base SqliteProviders
|
|
186
|
+
// stay keyed by (slug, repoPath) and are shared.
|
|
187
|
+
function selectionKey(slug, repoPath, remoteUrl) {
|
|
188
|
+
return `${providerKey(slug, repoPath)}\0${remoteUrl?.trim() ?? ''}`;
|
|
189
|
+
}
|
|
149
190
|
// my-beads-db-0cd.12: do NOT cache a rejected promise. Without this, one
|
|
150
191
|
// failed build (e.g. a disk error, not the config-read case above which no
|
|
151
192
|
// longer throws) permanently poisons this cache key: every later call for
|
|
@@ -178,21 +219,14 @@ function getBaseProviders(slug, repoPath, key) {
|
|
|
178
219
|
function disposeIfHttp(provider) {
|
|
179
220
|
if (!(provider instanceof HttpKbProvider))
|
|
180
221
|
return;
|
|
181
|
-
// dispose() removes the beforeExit hook that would have reported unsent
|
|
182
|
-
// captures at exit, so report them now instead of dropping them silently.
|
|
183
|
-
if (provider.offlineQueue.length > 0) {
|
|
184
|
-
logWarn('kb-providers', `KB config changed: the replaced remote KB provider still had ${provider.offlineQueue.length} ` +
|
|
185
|
-
'unsent captures in its offline queue. Run kb_harvest on the session transcript to recover them.');
|
|
186
|
-
}
|
|
187
222
|
provider.dispose();
|
|
188
223
|
const index = _httpProviders.indexOf(provider);
|
|
189
224
|
if (index !== -1)
|
|
190
225
|
_httpProviders.splice(index, 1);
|
|
191
226
|
}
|
|
192
|
-
// A superseded selection's HttpKbProvider is disposed
|
|
193
|
-
//
|
|
194
|
-
//
|
|
195
|
-
// provider mid-call keeps a working provider.
|
|
227
|
+
// A superseded selection's HttpKbProvider is disposed. dispose() releases
|
|
228
|
+
// nothing today (the provider holds no queue, listener or handle), so a caller
|
|
229
|
+
// still holding the old provider mid-call keeps a working provider.
|
|
196
230
|
function retireSelection(selection) {
|
|
197
231
|
selection.providers.then(providers => disposeIfHttp(providers.project), () => {
|
|
198
232
|
// Nothing to dispose: every awaiter of this build already received its
|
|
@@ -200,8 +234,9 @@ function retireSelection(selection) {
|
|
|
200
234
|
// init fails before rethrowing.
|
|
201
235
|
});
|
|
202
236
|
}
|
|
203
|
-
async function selectProviders(slug, repoPath,
|
|
204
|
-
|
|
237
|
+
async function selectProviders(slug, repoPath, remoteUrl, configFingerprint) {
|
|
238
|
+
const base = await getBaseProviders(slug, repoPath, providerKey(slug, repoPath));
|
|
239
|
+
return withSelectedProject(base, slug, repoPath, remoteUrl, configFingerprint);
|
|
205
240
|
}
|
|
206
241
|
// resolveProjectSlug shells out to git, so cache per (cwd, remoteUrl) pair --
|
|
207
242
|
// keying by cwd alone would let the first call for a directory pin its slug,
|
|
@@ -219,20 +254,24 @@ function slugFor(cwd, remoteUrl) {
|
|
|
219
254
|
}
|
|
220
255
|
return slug;
|
|
221
256
|
}
|
|
257
|
+
/** The project slug (KB identity) for a repo folder, cached like getKbProviders'. */
|
|
258
|
+
export function getProjectSlug(cwd, remoteUrl) {
|
|
259
|
+
return slugFor(cwd, remoteUrl);
|
|
260
|
+
}
|
|
222
261
|
/**
|
|
223
262
|
* Resolve the KB providers for a repo. `cwd` should be the repo the call is
|
|
224
263
|
* about -- omitting it falls back to the calling process's cwd, which is only
|
|
225
264
|
* correct for single-repo CLI invocations, never for server-handled tool calls.
|
|
226
265
|
*
|
|
227
|
-
* Returns the identical object for repeated calls on the same (slug, repoPath
|
|
228
|
-
* while the KB config is unchanged. Once the config content changes, the next
|
|
266
|
+
* Returns the identical object for repeated calls on the same (slug, repoPath,
|
|
267
|
+
* remoteUrl) while the KB config is unchanged. Once the config content changes, the next
|
|
229
268
|
* call selects the project provider afresh; the SqliteProviders underneath are
|
|
230
269
|
* reused, never reopened.
|
|
231
270
|
*/
|
|
232
271
|
export async function getKbProviders(cwd, remoteUrl) {
|
|
233
272
|
const slug = slugFor(cwd, remoteUrl);
|
|
234
273
|
const repoPath = cwd ?? process.cwd();
|
|
235
|
-
const key =
|
|
274
|
+
const key = selectionKey(slug, repoPath, remoteUrl);
|
|
236
275
|
const configFingerprint = kbConfigFingerprint();
|
|
237
276
|
const current = _selections.get(key);
|
|
238
277
|
if (current && current.configFingerprint === configFingerprint) {
|
|
@@ -243,16 +282,15 @@ export async function getKbProviders(cwd, remoteUrl) {
|
|
|
243
282
|
}
|
|
244
283
|
const selection = {
|
|
245
284
|
configFingerprint,
|
|
246
|
-
providers: selectProviders(slug, repoPath,
|
|
285
|
+
providers: selectProviders(slug, repoPath, remoteUrl, configFingerprint),
|
|
247
286
|
};
|
|
248
287
|
_selections.set(key, selection);
|
|
249
288
|
evictOnReject(_selections, key, selection, selection.providers);
|
|
250
289
|
return selection.providers;
|
|
251
290
|
}
|
|
252
291
|
export function resetKbProviders() {
|
|
253
|
-
// HttpKbProvider
|
|
254
|
-
//
|
|
255
|
-
// repeatedly hits MaxListenersExceededWarning.
|
|
292
|
+
// Every tracked HttpKbProvider is disposed before the maps are cleared, so a
|
|
293
|
+
// provider that ever holds a resource releases it on reset.
|
|
256
294
|
for (const httpProvider of _httpProviders) {
|
|
257
295
|
httpProvider.dispose();
|
|
258
296
|
}
|