@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- 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 +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- 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 +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- 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 +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -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 +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -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 +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- 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 +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -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 +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -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 +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- 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/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- 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 +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -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 +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.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/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/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-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/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/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/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/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,8 +1,12 @@
|
|
|
1
1
|
import path from 'path';
|
|
2
2
|
import fs from 'fs';
|
|
3
|
+
import crypto from 'crypto';
|
|
3
4
|
import { SqliteProvider } from './sqlite-provider.js';
|
|
5
|
+
import { HttpKbProvider } from './http-provider.js';
|
|
6
|
+
import { readKbConfigFromDisk, KB_CONFIG_PATH } from './kb-config.js';
|
|
4
7
|
import { resolveProjectSlug } from './project-slug.js';
|
|
5
8
|
import { FLEET_DIR } from '../../paths.js';
|
|
9
|
+
import { logWarn } from '../../utils/log-helpers.js';
|
|
6
10
|
export async function createKbProviders(cwd, remoteUrl) {
|
|
7
11
|
return createKbProvidersForSlug(slugFor(cwd, remoteUrl), cwd ?? process.cwd());
|
|
8
12
|
}
|
|
@@ -11,6 +15,10 @@ export async function createKbProviders(cwd, remoteUrl) {
|
|
|
11
15
|
// open a separate connection to the same file for every repo the process
|
|
12
16
|
// touches -- so it gets its own single-slot cache.
|
|
13
17
|
let _globalProvider = null;
|
|
18
|
+
/** The single shared global KB provider. */
|
|
19
|
+
export function getGlobalKbProvider() {
|
|
20
|
+
return getGlobalProvider();
|
|
21
|
+
}
|
|
14
22
|
function getGlobalProvider() {
|
|
15
23
|
if (!_globalProvider) {
|
|
16
24
|
_globalProvider = (async () => {
|
|
@@ -27,13 +35,107 @@ function getGlobalProvider() {
|
|
|
27
35
|
// (the Phase 1 capture basis check and the basis hashes both use it). The global
|
|
28
36
|
// provider gets none on purpose: one shared KB spans every repo, so no single
|
|
29
37
|
// root is correct for it.
|
|
30
|
-
async function
|
|
38
|
+
async function createBaseProvidersForSlug(slug, repoPath) {
|
|
31
39
|
const projectDir = path.join(FLEET_DIR, 'knowledge', slug);
|
|
32
40
|
fs.mkdirSync(projectDir, { recursive: true });
|
|
33
|
-
const
|
|
34
|
-
await
|
|
35
|
-
const
|
|
36
|
-
return {
|
|
41
|
+
const projectSqlite = new SqliteProvider(path.join(projectDir, 'kb.sqlite'), repoPath);
|
|
42
|
+
await projectSqlite.init();
|
|
43
|
+
const global = await getGlobalProvider();
|
|
44
|
+
return { projectSqlite, global };
|
|
45
|
+
}
|
|
46
|
+
async function createKbProvidersForSlug(slug, repoPath) {
|
|
47
|
+
return withSelectedProject(await createBaseProvidersForSlug(slug, repoPath), slug, kbConfigFingerprint());
|
|
48
|
+
}
|
|
49
|
+
async function withSelectedProject(base, slug, configFingerprint) {
|
|
50
|
+
return {
|
|
51
|
+
project: await selectProjectProvider(base.projectSqlite, configFingerprint),
|
|
52
|
+
global: base.global,
|
|
53
|
+
projectSlug: slug,
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
// Every HttpKbProvider this module builds, so resetKbProviders can dispose them.
|
|
57
|
+
// SqliteProvider has no dispose() (it has close()), so disposal must be narrowed
|
|
58
|
+
// to HTTP providers -- and _selections holds unresolved Promises, which a sync
|
|
59
|
+
// resetKbProviders cannot read .project off of. Hence a side-list.
|
|
60
|
+
const _httpProviders = [];
|
|
61
|
+
// my-beads-db-0cd.12: parent bead .0cd criterion 1 requires getKbProviders to
|
|
62
|
+
// return SqliteProvider unchanged "in every other case, including
|
|
63
|
+
// missing/malformed config" -- but readKbConfigFromDisk (bead .1) throws by
|
|
64
|
+
// design on malformed JSON, provider "http" without a url/token_encrypted, or
|
|
65
|
+
// an undecryptable token. Resolving the conflict per bead .12's decision:
|
|
66
|
+
// readKbConfigFromDisk keeps throwing (bead .1's contract is unchanged), and
|
|
67
|
+
// THIS call site catches it, degrades to the already-built SqliteProvider, and
|
|
68
|
+
// logs a loud warning -- never a silent downgrade, never a hard failure of
|
|
69
|
+
// every kb_* tool over one bad config file.
|
|
70
|
+
//
|
|
71
|
+
// my-beads-db-u00.5: the warning is suppressed per FAILURE, not per process.
|
|
72
|
+
// A module-level boolean meant a long-lived fleet server warned once for the
|
|
73
|
+
// first bad config it ever saw and then stayed silent for the life of the
|
|
74
|
+
// process, even after the file was edited and broke differently. The key is
|
|
75
|
+
// the config path plus a hash of its content, so the same broken file warns
|
|
76
|
+
// once (no spam on every provider build), while a changed-but-still-broken
|
|
77
|
+
// file warns again.
|
|
78
|
+
const _warnedKbConfigFailures = new Set();
|
|
79
|
+
// Path plus a hash of the config file's content: the one fingerprint used both
|
|
80
|
+
// to suppress repeat warnings for the same broken file and, in getKbProviders,
|
|
81
|
+
// to notice that the config changed and the selection must be redone.
|
|
82
|
+
function kbConfigFingerprint() {
|
|
83
|
+
let contentHash;
|
|
84
|
+
try {
|
|
85
|
+
contentHash = crypto.createHash('sha256').update(fs.readFileSync(KB_CONFIG_PATH)).digest('hex');
|
|
86
|
+
}
|
|
87
|
+
catch (err) {
|
|
88
|
+
// Absent file, or a read that raced a delete/rename; key on why.
|
|
89
|
+
contentHash = `unreadable:${err.message}`;
|
|
90
|
+
}
|
|
91
|
+
return `${KB_CONFIG_PATH}\0${contentHash}`;
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Return the project provider the KB config selects. Stock path (no config file,
|
|
95
|
+
* or provider "sqlite") returns the already-built SqliteProvider untouched.
|
|
96
|
+
* A config file that fails to read (malformed JSON, http-without-url,
|
|
97
|
+
* http-without-token, undecryptable token) degrades to the same SqliteProvider,
|
|
98
|
+
* after a warning, once per distinct config content -- see the note above
|
|
99
|
+
* _warnedKbConfigFailures.
|
|
100
|
+
*
|
|
101
|
+
* The HTTP branch passes that same SqliteProvider as the explicit fallback:
|
|
102
|
+
* HttpKbProvider's default is a NO-ARG `new SqliteProvider()`, which resolves its
|
|
103
|
+
* database from process.cwd() rather than this repo's path.
|
|
104
|
+
*/
|
|
105
|
+
async function selectProjectProvider(projectProvider, configFingerprint) {
|
|
106
|
+
let config;
|
|
107
|
+
try {
|
|
108
|
+
config = readKbConfigFromDisk();
|
|
109
|
+
}
|
|
110
|
+
catch (err) {
|
|
111
|
+
if (!_warnedKbConfigFailures.has(configFingerprint)) {
|
|
112
|
+
_warnedKbConfigFailures.add(configFingerprint);
|
|
113
|
+
logWarn('kb-providers', `KB config error, falling back to SqliteProvider: ${err.message}`);
|
|
114
|
+
}
|
|
115
|
+
return projectProvider;
|
|
116
|
+
}
|
|
117
|
+
if (config.provider !== 'http') {
|
|
118
|
+
return projectProvider;
|
|
119
|
+
}
|
|
120
|
+
// my-beads-db-u00.4: the HTTP provider is init'd like any other provider,
|
|
121
|
+
// rather than relying on HttpKbProvider.init() doing nothing beyond
|
|
122
|
+
// re-init'ing its fallback. That fallback is the already-init'd
|
|
123
|
+
// projectProvider, and SqliteProvider.init() returns early once its db is
|
|
124
|
+
// open, so the double init is harmless (pinned in
|
|
125
|
+
// tests/knowledge/kb-providers-http-selection.test.ts) -- and any setup
|
|
126
|
+
// HttpKbProvider.init() grows later runs here instead of being skipped.
|
|
127
|
+
// readKbConfigFromDisk throws on http-without-url/token, so both are present here.
|
|
128
|
+
const httpProvider = new HttpKbProvider(config.url, config.token, projectProvider);
|
|
129
|
+
try {
|
|
130
|
+
await httpProvider.init();
|
|
131
|
+
}
|
|
132
|
+
catch (err) {
|
|
133
|
+
// Not yet tracked in _httpProviders, so release its beforeExit listener here.
|
|
134
|
+
httpProvider.dispose();
|
|
135
|
+
throw err;
|
|
136
|
+
}
|
|
137
|
+
_httpProviders.push(httpProvider);
|
|
138
|
+
return httpProvider;
|
|
37
139
|
}
|
|
38
140
|
// Keyed by (slug, repoPath), NOT slug alone and NOT a single slot. The fleet
|
|
39
141
|
// server is a long-lived process serving many members across many repos; a
|
|
@@ -43,10 +145,68 @@ async function createKbProvidersForSlug(slug, repoPath) {
|
|
|
43
145
|
// capture basis check and freshness sweep) for every later caller resolving
|
|
44
146
|
// to that same slug. Joined with NUL, which cannot appear in either
|
|
45
147
|
// component, so distinct pairs cannot collide into one key.
|
|
46
|
-
const
|
|
148
|
+
const _baseProviders = new Map();
|
|
149
|
+
const _selections = new Map();
|
|
47
150
|
function providerKey(slug, repoPath) {
|
|
48
151
|
return `${slug}\0${repoPath}`;
|
|
49
152
|
}
|
|
153
|
+
// my-beads-db-0cd.12: do NOT cache a rejected promise. Without this, one
|
|
154
|
+
// failed build (e.g. a disk error, not the config-read case above which no
|
|
155
|
+
// longer throws) permanently poisons this cache key: every later call for
|
|
156
|
+
// the same (slug, repoPath) gets the same rejected promise back, and
|
|
157
|
+
// fixing whatever caused the failure never recovers without a full
|
|
158
|
+
// resetKbProviders() or process restart. This .catch() is attached purely
|
|
159
|
+
// for cleanup -- it does not consume the rejection for the cached promise
|
|
160
|
+
// itself, so every awaiter still observes the rejection normally.
|
|
161
|
+
function evictOnReject(cache, key, entry, pending) {
|
|
162
|
+
pending.catch(() => {
|
|
163
|
+
if (cache.get(key) === entry) {
|
|
164
|
+
cache.delete(key);
|
|
165
|
+
}
|
|
166
|
+
});
|
|
167
|
+
}
|
|
168
|
+
function getBaseProviders(slug, repoPath, key) {
|
|
169
|
+
let pending = _baseProviders.get(key);
|
|
170
|
+
if (!pending) {
|
|
171
|
+
// Store the promise, not the resolved value, so concurrent callers for the
|
|
172
|
+
// same (slug, repoPath) pair share one provider instead of racing to build
|
|
173
|
+
// two. Two different repoPaths sharing a slug get two SqliteProvider
|
|
174
|
+
// handles on the same kb.sqlite file -- safe, since SqliteProvider.init
|
|
175
|
+
// sets WAL + busy_timeout=5000.
|
|
176
|
+
pending = createBaseProvidersForSlug(slug, repoPath);
|
|
177
|
+
_baseProviders.set(key, pending);
|
|
178
|
+
evictOnReject(_baseProviders, key, pending, pending);
|
|
179
|
+
}
|
|
180
|
+
return pending;
|
|
181
|
+
}
|
|
182
|
+
function disposeIfHttp(provider) {
|
|
183
|
+
if (!(provider instanceof HttpKbProvider))
|
|
184
|
+
return;
|
|
185
|
+
// dispose() removes the beforeExit hook that would have reported unsent
|
|
186
|
+
// captures at exit, so report them now instead of dropping them silently.
|
|
187
|
+
if (provider.offlineQueue.length > 0) {
|
|
188
|
+
logWarn('kb-providers', `KB config changed: the replaced remote KB provider still had ${provider.offlineQueue.length} ` +
|
|
189
|
+
'unsent captures in its offline queue. Run kb_harvest on the session transcript to recover them.');
|
|
190
|
+
}
|
|
191
|
+
provider.dispose();
|
|
192
|
+
const index = _httpProviders.indexOf(provider);
|
|
193
|
+
if (index !== -1)
|
|
194
|
+
_httpProviders.splice(index, 1);
|
|
195
|
+
}
|
|
196
|
+
// A superseded selection's HttpKbProvider is disposed so its beforeExit
|
|
197
|
+
// listener does not outlive it (the leak my-beads-db-u00.2 fixed in kb-server).
|
|
198
|
+
// dispose() only removes that listener, so a caller still holding the old
|
|
199
|
+
// provider mid-call keeps a working provider.
|
|
200
|
+
function retireSelection(selection) {
|
|
201
|
+
selection.providers.then(providers => disposeIfHttp(providers.project), () => {
|
|
202
|
+
// Nothing to dispose: every awaiter of this build already received its
|
|
203
|
+
// rejection, and selectProjectProvider disposes an HttpKbProvider whose
|
|
204
|
+
// init fails before rethrowing.
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
async function selectProviders(slug, repoPath, key, configFingerprint) {
|
|
208
|
+
return withSelectedProject(await getBaseProviders(slug, repoPath, key), slug, configFingerprint);
|
|
209
|
+
}
|
|
50
210
|
// resolveProjectSlug shells out to git, so cache per (cwd, remoteUrl) pair --
|
|
51
211
|
// keying by cwd alone would let the first call for a directory pin its slug,
|
|
52
212
|
// leaving a later call that does supply a remote URL stuck with the stale
|
|
@@ -63,30 +223,52 @@ function slugFor(cwd, remoteUrl) {
|
|
|
63
223
|
}
|
|
64
224
|
return slug;
|
|
65
225
|
}
|
|
226
|
+
/** The project slug (KB identity) for a repo folder, cached like getKbProviders'. */
|
|
227
|
+
export function getProjectSlug(cwd, remoteUrl) {
|
|
228
|
+
return slugFor(cwd, remoteUrl);
|
|
229
|
+
}
|
|
66
230
|
/**
|
|
67
231
|
* Resolve the KB providers for a repo. `cwd` should be the repo the call is
|
|
68
232
|
* about -- omitting it falls back to the calling process's cwd, which is only
|
|
69
233
|
* correct for single-repo CLI invocations, never for server-handled tool calls.
|
|
234
|
+
*
|
|
235
|
+
* Returns the identical object for repeated calls on the same (slug, repoPath)
|
|
236
|
+
* while the KB config is unchanged. Once the config content changes, the next
|
|
237
|
+
* call selects the project provider afresh; the SqliteProviders underneath are
|
|
238
|
+
* reused, never reopened.
|
|
70
239
|
*/
|
|
71
240
|
export async function getKbProviders(cwd, remoteUrl) {
|
|
72
241
|
const slug = slugFor(cwd, remoteUrl);
|
|
73
242
|
const repoPath = cwd ?? process.cwd();
|
|
74
243
|
const key = providerKey(slug, repoPath);
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
// two. Two different repoPaths sharing a slug get two SqliteProvider
|
|
80
|
-
// handles on the same kb.sqlite file -- safe, since SqliteProvider.init
|
|
81
|
-
// sets WAL + busy_timeout=5000.
|
|
82
|
-
pending = createKbProvidersForSlug(slug, repoPath);
|
|
83
|
-
_providers.set(key, pending);
|
|
244
|
+
const configFingerprint = kbConfigFingerprint();
|
|
245
|
+
const current = _selections.get(key);
|
|
246
|
+
if (current && current.configFingerprint === configFingerprint) {
|
|
247
|
+
return current.providers;
|
|
84
248
|
}
|
|
85
|
-
|
|
249
|
+
if (current) {
|
|
250
|
+
retireSelection(current);
|
|
251
|
+
}
|
|
252
|
+
const selection = {
|
|
253
|
+
configFingerprint,
|
|
254
|
+
providers: selectProviders(slug, repoPath, key, configFingerprint),
|
|
255
|
+
};
|
|
256
|
+
_selections.set(key, selection);
|
|
257
|
+
evictOnReject(_selections, key, selection, selection.providers);
|
|
258
|
+
return selection.providers;
|
|
86
259
|
}
|
|
87
260
|
export function resetKbProviders() {
|
|
88
|
-
|
|
261
|
+
// HttpKbProvider registers a process 'beforeExit' listener in its constructor;
|
|
262
|
+
// clearing the maps alone leaks one listener per reset, and a suite that resets
|
|
263
|
+
// repeatedly hits MaxListenersExceededWarning.
|
|
264
|
+
for (const httpProvider of _httpProviders) {
|
|
265
|
+
httpProvider.dispose();
|
|
266
|
+
}
|
|
267
|
+
_httpProviders.length = 0;
|
|
268
|
+
_baseProviders.clear();
|
|
269
|
+
_selections.clear();
|
|
89
270
|
_slugCache.clear();
|
|
90
271
|
_globalProvider = null;
|
|
272
|
+
_warnedKbConfigFailures.clear();
|
|
91
273
|
}
|
|
92
274
|
//# sourceMappingURL=kb-providers.js.map
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export type KbRemovedScopeKey = 'repo_path' | 'repo' | 'repo_remote_url';
|
|
3
|
+
/** What replaces each removed key, phrased as the caller's fix. */
|
|
4
|
+
export declare const KB_REMOVED_SCOPE_KEY_REPLACEMENTS: Readonly<Record<KbRemovedScopeKey, string>>;
|
|
5
|
+
export declare const KB_REMOVED_SCOPE_KEYS: KbRemovedScopeKey[];
|
|
6
|
+
/**
|
|
7
|
+
* Spread into every kb_* input schema (last, after the tool's own keys) so a
|
|
8
|
+
* removed key reaches the wrapper instead of being stripped by the MCP layer.
|
|
9
|
+
* Typed `unknown` on purpose: any value, even a well-formed path, is refused.
|
|
10
|
+
*/
|
|
11
|
+
export declare const KB_REMOVED_SCOPE_KEYS_SHAPE: {
|
|
12
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
13
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
14
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
15
|
+
};
|
|
16
|
+
export declare class KbScopeKeyRemovedError extends Error {
|
|
17
|
+
readonly code: "E-SCOPE-KEY-REMOVED";
|
|
18
|
+
readonly keys: KbRemovedScopeKey[];
|
|
19
|
+
constructor(tool: string, keys: KbRemovedScopeKey[]);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Refuse a kb_* call that carries any removed scope key. A key that is present
|
|
23
|
+
* with value undefined is treated as absent (some clients serialise optional
|
|
24
|
+
* fields that way); any other value -- including null or '' -- is refused,
|
|
25
|
+
* because the caller evidently meant to scope the call.
|
|
26
|
+
*/
|
|
27
|
+
export declare function assertNoRemovedKbScopeKeys(tool: string, input: unknown): void;
|
|
28
|
+
//# sourceMappingURL=kb-removed-scope-keys.d.ts.map
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
// Removed kb_* scope keys: repo_path, repo, repo_remote_url.
|
|
2
|
+
//
|
|
3
|
+
// Before the KB redesign every kb_* tool took repo_path and repo_remote_url
|
|
4
|
+
// (kb_stats and kb_import also took repo) to say which repository's KB a call
|
|
5
|
+
// was about. The redesign removed them: a kb_* call now always acts on the
|
|
6
|
+
// CALLING SESSION's own KB (kb-self.ts). An MCP server built from a zod raw
|
|
7
|
+
// shape strips undeclared keys before the handler runs, so an existing caller
|
|
8
|
+
// still passing one would have been silently re-pointed at a different KB.
|
|
9
|
+
//
|
|
10
|
+
// So the keys stay DECLARED on every kb_* input schema (KB_REMOVED_SCOPE_KEYS_
|
|
11
|
+
// SHAPE, described as removed) purely so they reach the tool wrapper, and the
|
|
12
|
+
// wrapper refuses any call carrying one (assertNoRemovedKbScopeKeys) with a
|
|
13
|
+
// typed E-SCOPE-KEY-REMOVED error naming the key and what replaces it. The
|
|
14
|
+
// call is refused before any KB is resolved or opened, so nothing changes.
|
|
15
|
+
import { z } from 'zod';
|
|
16
|
+
/** What replaces each removed key, phrased as the caller's fix. */
|
|
17
|
+
export const KB_REMOVED_SCOPE_KEY_REPLACEMENTS = Object.freeze({
|
|
18
|
+
repo_path: "nothing -- drop it: every kb_* call acts on the calling session's own KB (a member session's registered work folder; a FULL session's fleet server working folder). To act on another repository, call from a member session registered on that folder.",
|
|
19
|
+
repo: "nothing -- drop it: same as repo_path, the KB (and kb_stats' bible drift check) is the calling session's own repository. kb_import names a bible file with path, which is unchanged.",
|
|
20
|
+
repo_remote_url: "nothing -- drop it: a remote member's KB identity is its registered origin remote (record it with update_member git_repos) and is resolved from the calling member session.",
|
|
21
|
+
});
|
|
22
|
+
export const KB_REMOVED_SCOPE_KEYS = Object.keys(KB_REMOVED_SCOPE_KEY_REPLACEMENTS);
|
|
23
|
+
const removedDescription = 'REMOVED -- do not pass. A call carrying it fails with E-SCOPE-KEY-REMOVED; the KB is always the calling session\'s own.';
|
|
24
|
+
/**
|
|
25
|
+
* Spread into every kb_* input schema (last, after the tool's own keys) so a
|
|
26
|
+
* removed key reaches the wrapper instead of being stripped by the MCP layer.
|
|
27
|
+
* Typed `unknown` on purpose: any value, even a well-formed path, is refused.
|
|
28
|
+
*/
|
|
29
|
+
export const KB_REMOVED_SCOPE_KEYS_SHAPE = {
|
|
30
|
+
repo_path: z.unknown().optional().describe(removedDescription),
|
|
31
|
+
repo: z.unknown().optional().describe(removedDescription),
|
|
32
|
+
repo_remote_url: z.unknown().optional().describe(removedDescription),
|
|
33
|
+
};
|
|
34
|
+
export class KbScopeKeyRemovedError extends Error {
|
|
35
|
+
code = 'E-SCOPE-KEY-REMOVED';
|
|
36
|
+
keys;
|
|
37
|
+
constructor(tool, keys) {
|
|
38
|
+
const named = keys.map(k => `'${k}'`).join(', ');
|
|
39
|
+
const fixes = keys.map(k => `${k}: ${KB_REMOVED_SCOPE_KEY_REPLACEMENTS[k]}`).join(' ');
|
|
40
|
+
super(`E-SCOPE-KEY-REMOVED: ${tool} no longer accepts ${named} (removed in the KB redesign); the call was not run and no KB was changed. ` +
|
|
41
|
+
`Remediation: ${fixes}`);
|
|
42
|
+
this.name = 'KbScopeKeyRemovedError';
|
|
43
|
+
this.keys = keys;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Refuse a kb_* call that carries any removed scope key. A key that is present
|
|
48
|
+
* with value undefined is treated as absent (some clients serialise optional
|
|
49
|
+
* fields that way); any other value -- including null or '' -- is refused,
|
|
50
|
+
* because the caller evidently meant to scope the call.
|
|
51
|
+
*/
|
|
52
|
+
export function assertNoRemovedKbScopeKeys(tool, input) {
|
|
53
|
+
if (!input || typeof input !== 'object')
|
|
54
|
+
return;
|
|
55
|
+
const present = KB_REMOVED_SCOPE_KEYS.filter(k => input[k] !== undefined);
|
|
56
|
+
if (present.length > 0)
|
|
57
|
+
throw new KbScopeKeyRemovedError(tool, present);
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=kb-removed-scope-keys.js.map
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export declare const GLOBAL_KB_SCOPE = "global";
|
|
2
|
+
export declare const DEFAULT_KB_SCOPE = "default";
|
|
3
|
+
export interface KbScopeLocation {
|
|
4
|
+
slug: string;
|
|
5
|
+
dbPath: string;
|
|
6
|
+
}
|
|
7
|
+
export declare function knowledgeRootDir(): string;
|
|
8
|
+
/**
|
|
9
|
+
* List every scope directory under `knowledgeDir` that holds a kb.sqlite,
|
|
10
|
+
* sorted by slug. Never throws: an absent or unreadable knowledge dir yields
|
|
11
|
+
* an empty list. Read-only -- never creates a directory or database.
|
|
12
|
+
*/
|
|
13
|
+
export declare function listKbScopes(knowledgeDir?: string): KbScopeLocation[];
|
|
14
|
+
//# sourceMappingURL=kb-scopes.d.ts.map
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import { FLEET_DIR } from '../../paths.js';
|
|
4
|
+
// Enumerates the KB scopes that exist on disk under FLEET_DIR/knowledge/.
|
|
5
|
+
//
|
|
6
|
+
// The fleet server is ONE long-lived process serving every project a user
|
|
7
|
+
// works on, so anything that reports on "the KB" server-side must look at
|
|
8
|
+
// every scope rather than derive one from the server's own process.cwd()
|
|
9
|
+
// (which is arbitrary -- e.g. C:\Windows\System32 for a detached launch).
|
|
10
|
+
// Each scope is a directory named by its project slug (see project-slug.ts)
|
|
11
|
+
// holding a kb.sqlite; `global` is the single shared cross-project KB, and
|
|
12
|
+
// `default` is where captures from non-git directories land. Other entries in
|
|
13
|
+
// the knowledge dir (config.json, kb-server token files) are not scopes and
|
|
14
|
+
// are ignored: only a directory containing kb.sqlite counts.
|
|
15
|
+
export const GLOBAL_KB_SCOPE = 'global';
|
|
16
|
+
export const DEFAULT_KB_SCOPE = 'default';
|
|
17
|
+
export function knowledgeRootDir() {
|
|
18
|
+
return path.join(FLEET_DIR, 'knowledge');
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* List every scope directory under `knowledgeDir` that holds a kb.sqlite,
|
|
22
|
+
* sorted by slug. Never throws: an absent or unreadable knowledge dir yields
|
|
23
|
+
* an empty list. Read-only -- never creates a directory or database.
|
|
24
|
+
*/
|
|
25
|
+
export function listKbScopes(knowledgeDir = knowledgeRootDir()) {
|
|
26
|
+
let names;
|
|
27
|
+
try {
|
|
28
|
+
names = fs.readdirSync(knowledgeDir);
|
|
29
|
+
}
|
|
30
|
+
catch {
|
|
31
|
+
return [];
|
|
32
|
+
}
|
|
33
|
+
const scopes = [];
|
|
34
|
+
for (const name of names) {
|
|
35
|
+
const dbPath = path.join(knowledgeDir, name, 'kb.sqlite');
|
|
36
|
+
try {
|
|
37
|
+
if (fs.statSync(path.join(knowledgeDir, name)).isDirectory() && fs.statSync(dbPath).isFile()) {
|
|
38
|
+
scopes.push({ slug: name, dbPath });
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
// Not a scope (plain file, missing kb.sqlite, or unreadable) -- skip.
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return scopes.sort((a, b) => a.slug.localeCompare(b.slug));
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=kb-scopes.js.map
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import type { Agent } from '../../types.js';
|
|
2
|
+
import { type KbProviders } from './kb-providers.js';
|
|
3
|
+
/** Explicit KB anchor for in-process callers. Not exposed on any tool schema. */
|
|
4
|
+
export interface KbAnchor {
|
|
5
|
+
/** Repo root the KB is about (anchors relative source_files). */
|
|
6
|
+
folder: string;
|
|
7
|
+
/** Origin remote URL, when the folder lives on another host. */
|
|
8
|
+
remoteUrl?: string;
|
|
9
|
+
/** Registered member whose host the folder lives on (set with remoteUrl). */
|
|
10
|
+
memberId?: string;
|
|
11
|
+
}
|
|
12
|
+
export type KbSelfErrorCode = 'E-SELF-NO-WORKFOLDER' | 'E-SELF-NOT-A-REPO' | 'E-SELF-NO-REMOTE';
|
|
13
|
+
export declare class KbSelfError extends Error {
|
|
14
|
+
readonly code: KbSelfErrorCode;
|
|
15
|
+
readonly folder: string;
|
|
16
|
+
readonly remediation: string;
|
|
17
|
+
constructor(code: KbSelfErrorCode, folder: string, problem: string, remediation: string);
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Validate a local folder as a (self) repo: it exists and is a git repository.
|
|
21
|
+
* Shared by kb (self) and code (self) resolution -- code tools need no origin
|
|
22
|
+
* remote (an index is keyed by folder, not by KB identity), kb tools add the
|
|
23
|
+
* remote check on top (validateSelfFolder).
|
|
24
|
+
*/
|
|
25
|
+
export declare function validateSelfRepoFolder(folder: string, memberLabel?: string): void;
|
|
26
|
+
/** Validate a local folder as a KB anchor: exists, is a git repo, has an origin remote. */
|
|
27
|
+
export declare function validateSelfFolder(folder: string, memberLabel?: string): KbAnchor;
|
|
28
|
+
/** The calling session's (self) folder before any repo validation. */
|
|
29
|
+
export interface SelfSession {
|
|
30
|
+
/** Member id of a MEMBER session; undefined for a FULL session. */
|
|
31
|
+
memberId?: string;
|
|
32
|
+
/** Member friendly name (or id) used in error text; undefined for FULL. */
|
|
33
|
+
memberLabel?: string;
|
|
34
|
+
/** The member's registered work folder, or the server working folder. */
|
|
35
|
+
folder: string;
|
|
36
|
+
/** The registered member (MEMBER session only). */
|
|
37
|
+
agent?: Agent;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Resolve WHICH folder the calling session means by (self): a MEMBER session's
|
|
41
|
+
* registered work folder, a FULL session's server working folder. A MEMBER
|
|
42
|
+
* session whose member is unregistered or has no work folder is refused with
|
|
43
|
+
* E-SELF-NO-WORKFOLDER -- it never falls back to the server folder.
|
|
44
|
+
*/
|
|
45
|
+
export declare function resolveSelfSession(): SelfSession;
|
|
46
|
+
/**
|
|
47
|
+
* Resolve the calling session's own KB anchor (see header). Throws KbSelfError
|
|
48
|
+
* when the resolved folder cannot carry a KB identity.
|
|
49
|
+
*/
|
|
50
|
+
export declare function resolveSelfAnchor(): KbAnchor;
|
|
51
|
+
/** The anchor a kb_* handler uses: the explicit in-process anchor, else (self). */
|
|
52
|
+
export declare function resolveKbAnchor(anchor?: KbAnchor): KbAnchor;
|
|
53
|
+
/** KB providers for a kb_* handler call. */
|
|
54
|
+
export declare function getSelfKbProviders(anchor?: KbAnchor): Promise<KbProviders>;
|
|
55
|
+
/**
|
|
56
|
+
* The own-scope tag of the calling MEMBER session, 'member:<uuid>', or
|
|
57
|
+
* undefined for a FULL session or an in-process caller passing an explicit
|
|
58
|
+
* KbAnchor (same predicate getSelfReadKb uses to pick the bible view).
|
|
59
|
+
* MEMBER captures carry this tag, and MEMBER INFERRED/UNVERIFIED reads,
|
|
60
|
+
* kb_promote and kb_invalidate act only on entries carrying it.
|
|
61
|
+
*/
|
|
62
|
+
export declare function memberOwnerTag(anchor?: KbAnchor): string | undefined;
|
|
63
|
+
/** KB providers for a read-only kb_* call, plus the anchor they were resolved from. */
|
|
64
|
+
export interface SelfReadKb {
|
|
65
|
+
providers: KbProviders;
|
|
66
|
+
anchor: KbAnchor;
|
|
67
|
+
/** True when `providers.project` is the member's in-memory bible view. */
|
|
68
|
+
memberView: boolean;
|
|
69
|
+
/**
|
|
70
|
+
* Set when a MEMBER session explicitly asked for INFERRED/UNVERIFIED: the
|
|
71
|
+
* request is answered from the per-repo DB and every read must return only
|
|
72
|
+
* entries carrying this tag (member:<uuid>), so a member never sees another
|
|
73
|
+
* member's unconfirmed captures even when they share a machine.
|
|
74
|
+
*/
|
|
75
|
+
ownerTag?: string;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Providers for the read tools (kb_query, kb_session_prime, kb_list,
|
|
79
|
+
* kb_context, kb_stats). A MEMBER session (no explicit anchor) reads its own
|
|
80
|
+
* checkout bible through the in-memory view (member-bible-view.ts); the
|
|
81
|
+
* per-repo DB is shared by every member of the repo, whichever branch each is
|
|
82
|
+
* on. Everything else keeps the per-repo DB: FULL sessions, in-process callers
|
|
83
|
+
* passing an explicit KbAnchor, and a MEMBER request that explicitly names the
|
|
84
|
+
* INFERRED or UNVERIFIED tier (a bible carries the CONFIRMED set, so those
|
|
85
|
+
* tiers are not the view's to answer). The global KB is unchanged either way.
|
|
86
|
+
* That last MEMBER case carries `ownerTag`: it sees only its own captures.
|
|
87
|
+
*/
|
|
88
|
+
export declare function getSelfReadKb(anchor?: KbAnchor, confidence?: readonly string[]): Promise<SelfReadKb>;
|
|
89
|
+
/** Appended to every kb_* tool description so callers know there is no scope argument. */
|
|
90
|
+
export declare const KB_SELF_NOTE = " Scope: always the calling session's own KB -- a member session uses its registered work folder, any other session the fleet server's working folder; there is no repo/path scope argument (the removed repo_path, repo and repo_remote_url keys fail with E-SCOPE-KEY-REMOVED). Fails with E-SELF-NO-WORKFOLDER, E-SELF-NOT-A-REPO or E-SELF-NO-REMOTE (each with a one-line remediation) when that folder cannot carry a KB identity (it must be a git repository with an origin remote).";
|
|
91
|
+
//# sourceMappingURL=kb-self.d.ts.map
|