@apralabs/apra-fleet 0.4.3 → 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 +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- 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/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 +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -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 +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- 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 +77 -21
- package/dist/cli/install.js +610 -152
- 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/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 +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.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- 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 +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -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 +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- 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/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- 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-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- 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/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 +54 -8
- 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/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 +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- 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 +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/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 +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- 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 +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- 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 +53 -5
- package/dist/tools/check-status.js +210 -53
- 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 +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 +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- 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 +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- 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 +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -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 +30 -10
- 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 +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 +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- 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 +2 -2
- package/dist/tools/receive-files.js +3 -1
- 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 +6 -4
- 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/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.js +8 -2
- 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 +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- 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/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- 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 +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/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- 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/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 +3 -3
- 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 +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -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-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -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 +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- 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 +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- 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-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- 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 +1257 -301
- 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 +447 -0
- 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 +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- 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 +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -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 +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -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 +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- 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/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- 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 +235 -21
- 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 +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- 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,7 +1,8 @@
|
|
|
1
|
-
import { execFile } from 'node:child_process';
|
|
1
|
+
import { execFile, spawn } from 'node:child_process';
|
|
2
2
|
import { createHash } from 'node:crypto';
|
|
3
3
|
import fs from 'node:fs';
|
|
4
4
|
import path from 'node:path';
|
|
5
|
+
import { logWarn } from '../../utils/log-helpers.js';
|
|
5
6
|
// T3.1 (D4 fold-in, Phase 2 review MEDIUM yashr-d8b): computeFileHashBatch
|
|
6
7
|
// gains an optional { cwd } anchor so a caller resolving a bible/basis against
|
|
7
8
|
// a DIFFERENT repo root (e.g. kb_import's --repo) never needs to mutate the
|
|
@@ -14,7 +15,7 @@ import path from 'node:path';
|
|
|
14
15
|
// (implicit process.cwd() resolution via fs/execFile defaults).
|
|
15
16
|
function execFileAsync(cmd, args, opts) {
|
|
16
17
|
return new Promise((resolve, reject) => {
|
|
17
|
-
execFile(cmd, args, opts
|
|
18
|
+
execFile(cmd, args, { ...opts, windowsHide: true }, (err, stdout, stderr) => {
|
|
18
19
|
if (err)
|
|
19
20
|
reject(err);
|
|
20
21
|
else
|
|
@@ -57,35 +58,65 @@ export async function computeFileHashBatch(filePaths, opts) {
|
|
|
57
58
|
}
|
|
58
59
|
if (existing.length === 0)
|
|
59
60
|
return result;
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
61
|
+
// One `git hash-object` per chunk, each kept under HASH_ARGV_CHAR_BUDGET:
|
|
62
|
+
// a single argv holding every path overflowed the Windows command-line limit
|
|
63
|
+
// (32767 chars) for large bibles / long checkout paths, git failed, and the
|
|
64
|
+
// sha256 fallback below then never matched the stored git-type basis -- so
|
|
65
|
+
// freshnessSweep silently staled EVERY entry.
|
|
66
|
+
for (const chunk of chunkByArgvLength(existing, resolvePath)) {
|
|
67
|
+
let gitSucceeded = false;
|
|
68
|
+
try {
|
|
69
|
+
const { stdout } = await execFileAsync('git', ['hash-object', ...chunk.map(resolvePath)], root ? { cwd: root } : undefined);
|
|
70
|
+
const lines = stdout.trim().split('\n');
|
|
71
|
+
if (lines.length === chunk.length) {
|
|
72
|
+
for (let i = 0; i < chunk.length; i++) {
|
|
73
|
+
const hash = lines[i].trim();
|
|
74
|
+
if (hash.length > 0) {
|
|
75
|
+
result[chunk[i]] = { hash, type: 'git' };
|
|
76
|
+
}
|
|
77
|
+
else {
|
|
78
|
+
result[chunk[i]] = { hash: sha256File(resolvePath(chunk[i])), type: 'sha256' };
|
|
79
|
+
}
|
|
72
80
|
}
|
|
81
|
+
gitSucceeded = true;
|
|
73
82
|
}
|
|
74
|
-
gitSucceeded = true;
|
|
75
83
|
}
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
result[p]
|
|
84
|
+
catch (err) {
|
|
85
|
+
// Not silent: a sha256 fallback cannot match a git-type basis, so every
|
|
86
|
+
// entry citing these files will look stale until git hashing works again.
|
|
87
|
+
logWarn('kb_hash', `git hash-object failed for ${chunk.length} file(s); falling back to sha256, so freshness checks against git-type bases will report them stale: ${err?.message ?? String(err)}`);
|
|
88
|
+
}
|
|
89
|
+
if (!gitSucceeded) {
|
|
90
|
+
for (const p of chunk) {
|
|
91
|
+
if (!result[p]) {
|
|
92
|
+
result[p] = { hash: sha256File(resolvePath(p)), type: 'sha256' };
|
|
93
|
+
}
|
|
84
94
|
}
|
|
85
95
|
}
|
|
86
96
|
}
|
|
87
97
|
return result;
|
|
88
98
|
}
|
|
99
|
+
// Well under the Windows 32767-char command-line limit (and POSIX ARG_MAX),
|
|
100
|
+
// leaving room for the executable path and quoting overhead.
|
|
101
|
+
const HASH_ARGV_CHAR_BUDGET = 8000;
|
|
102
|
+
function chunkByArgvLength(paths, resolvePath) {
|
|
103
|
+
const chunks = [];
|
|
104
|
+
let current = [];
|
|
105
|
+
let length = 0;
|
|
106
|
+
for (const p of paths) {
|
|
107
|
+
const cost = resolvePath(p).length + 3; // separator + possible quotes
|
|
108
|
+
if (current.length > 0 && length + cost > HASH_ARGV_CHAR_BUDGET) {
|
|
109
|
+
chunks.push(current);
|
|
110
|
+
current = [];
|
|
111
|
+
length = 0;
|
|
112
|
+
}
|
|
113
|
+
current.push(p);
|
|
114
|
+
length += cost;
|
|
115
|
+
}
|
|
116
|
+
if (current.length > 0)
|
|
117
|
+
chunks.push(current);
|
|
118
|
+
return chunks;
|
|
119
|
+
}
|
|
89
120
|
export async function checkStaleness(entry) {
|
|
90
121
|
if (entry.type !== 'context-cache')
|
|
91
122
|
return { stale: false };
|
|
@@ -120,4 +151,103 @@ export async function checkStaleness(entry) {
|
|
|
120
151
|
throw err;
|
|
121
152
|
}
|
|
122
153
|
}
|
|
154
|
+
/**
|
|
155
|
+
* The repo folder a HEAD-anchored hash was asked for is not inside a git work
|
|
156
|
+
* tree. Thrown instead of silently falling back to hashing files on disk:
|
|
157
|
+
* a disk hash is a working-tree hash, not a branch-HEAD hash.
|
|
158
|
+
*/
|
|
159
|
+
export class KbHeadHashError extends Error {
|
|
160
|
+
code = 'E-BIBLE-BASIS-NOT-GIT';
|
|
161
|
+
folder;
|
|
162
|
+
remediation;
|
|
163
|
+
constructor(folder, detail) {
|
|
164
|
+
const remediation = `Run this from a git checkout ('git init' or clone the repository into '${folder}').`;
|
|
165
|
+
super(`E-BIBLE-BASIS-NOT-GIT: '${folder}' is not inside a git work tree, so file content at HEAD cannot be read (${detail}). Remediation: ${remediation}`);
|
|
166
|
+
this.name = 'KbHeadHashError';
|
|
167
|
+
this.folder = folder;
|
|
168
|
+
this.remediation = remediation;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
function gitWithStdin(args, cwd, input) {
|
|
172
|
+
return new Promise((resolve, reject) => {
|
|
173
|
+
const child = spawn('git', args, { cwd, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
|
|
174
|
+
const out = [];
|
|
175
|
+
const err = [];
|
|
176
|
+
child.stdout.on('data', (d) => out.push(d));
|
|
177
|
+
child.stderr.on('data', (d) => err.push(d));
|
|
178
|
+
child.on('error', reject);
|
|
179
|
+
child.on('close', code => {
|
|
180
|
+
if (code === 0)
|
|
181
|
+
resolve(Buffer.concat(out).toString('utf-8'));
|
|
182
|
+
else
|
|
183
|
+
reject(new Error(`git ${args.join(' ')} exited ${code}: ${Buffer.concat(err).toString('utf-8').trim()}`));
|
|
184
|
+
});
|
|
185
|
+
child.stdin.end(input);
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Hash each file's content AT THE WORK TREE'S HEAD COMMIT (not the file on
|
|
190
|
+
* disk), keyed by the original path strings. Relative paths resolve against
|
|
191
|
+
* `cwd`, exactly as computeFileHashBatch({ cwd }) resolves them.
|
|
192
|
+
*
|
|
193
|
+
* Digest: the git blob id of HEAD:<path>. That is the same digest the stored
|
|
194
|
+
* basis carries -- computeFileHashBatch runs `git hash-object <file>`, which
|
|
195
|
+
* applies the same clean filters as `git add`, so a file whose on-disk content
|
|
196
|
+
* equals its HEAD content hashes to the HEAD blob id. Uncommitted edits
|
|
197
|
+
* therefore never change the result.
|
|
198
|
+
*
|
|
199
|
+
* A file absent at HEAD (untracked, deleted, a directory, a submodule) maps to
|
|
200
|
+
* null. An unborn HEAD (no commit yet) maps every file to null. A `cwd` that is
|
|
201
|
+
* not inside a git work tree throws KbHeadHashError -- never a disk fallback.
|
|
202
|
+
* Absolute paths are not supported (they map to null): HEAD content is only
|
|
203
|
+
* addressable repo-relatively.
|
|
204
|
+
*/
|
|
205
|
+
export async function computeHeadFileHashBatch(filePaths, opts) {
|
|
206
|
+
const result = {};
|
|
207
|
+
const cwd = opts.cwd;
|
|
208
|
+
// The git check runs even for an empty list, so a caller in a non-git
|
|
209
|
+
// folder always fails loud rather than quietly admitting nothing.
|
|
210
|
+
let prefix;
|
|
211
|
+
try {
|
|
212
|
+
const { stdout } = await execFileAsync('git', ['rev-parse', '--is-inside-work-tree', '--show-prefix'], { cwd });
|
|
213
|
+
const lines = stdout.split('\n');
|
|
214
|
+
if (lines[0].trim() !== 'true')
|
|
215
|
+
throw new Error('not inside a work tree');
|
|
216
|
+
prefix = (lines[1] ?? '').trim();
|
|
217
|
+
}
|
|
218
|
+
catch (err) {
|
|
219
|
+
throw new KbHeadHashError(cwd, err?.message ?? String(err));
|
|
220
|
+
}
|
|
221
|
+
if (filePaths.length === 0)
|
|
222
|
+
return result;
|
|
223
|
+
for (const p of filePaths)
|
|
224
|
+
result[p] = null;
|
|
225
|
+
try {
|
|
226
|
+
await execFileAsync('git', ['rev-parse', '--verify', '--quiet', 'HEAD^{commit}'], { cwd });
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
return result; // unborn HEAD: nothing is committed, so nothing matches
|
|
230
|
+
}
|
|
231
|
+
const queried = [];
|
|
232
|
+
const lines = [];
|
|
233
|
+
for (const p of filePaths) {
|
|
234
|
+
if (typeof p !== 'string' || p.length === 0 || /[\r\n]/.test(p) || path.isAbsolute(p) || path.win32.isAbsolute(p))
|
|
235
|
+
continue;
|
|
236
|
+
const rel = path.posix.normalize(prefix + p.replace(/\\/g, '/'));
|
|
237
|
+
if (rel.startsWith('../') || rel === '..' || rel === '.')
|
|
238
|
+
continue;
|
|
239
|
+
queried.push(p);
|
|
240
|
+
lines.push('HEAD:' + rel);
|
|
241
|
+
}
|
|
242
|
+
if (queried.length === 0)
|
|
243
|
+
return result;
|
|
244
|
+
const stdout = await gitWithStdin(['cat-file', '--batch-check=%(objectname) %(objecttype)'], cwd, lines.join('\n') + '\n');
|
|
245
|
+
const outLines = stdout.split('\n');
|
|
246
|
+
for (let i = 0; i < queried.length; i++) {
|
|
247
|
+
const [oid, type] = (outLines[i] ?? '').trim().split(' ');
|
|
248
|
+
if (type === 'blob' && /^[0-9a-f]{40,64}$/.test(oid))
|
|
249
|
+
result[queried[i]] = { hash: oid, type: 'git' };
|
|
250
|
+
}
|
|
251
|
+
return result;
|
|
252
|
+
}
|
|
123
253
|
//# sourceMappingURL=file-hash.js.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { SqliteProvider } from './sqlite-provider.js';
|
|
2
|
-
import type { MemoryProvider, KBEntry, KBEntryInput, QueryOptions, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, AudnDecision, Confidence, ProviderStats } from './types.js';
|
|
2
|
+
import type { MemoryProvider, KBEntry, KBEntryInput, QueryOptions, EntryTrustFilter, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, AudnDecision, Confidence, ProviderStats, DiscardResult, RetireOptions } from './types.js';
|
|
3
3
|
type QueuedOperation = {
|
|
4
4
|
op: 'capture';
|
|
5
5
|
input: KBEntryInput;
|
|
@@ -24,13 +24,14 @@ export declare class HttpKbProvider implements MemoryProvider {
|
|
|
24
24
|
audn_decision: AudnDecision;
|
|
25
25
|
}>;
|
|
26
26
|
query(opts: QueryOptions): Promise<KBResult>;
|
|
27
|
-
context(files: string[]): Promise<FileContextResult[]>;
|
|
27
|
+
context(files: string[], confidence?: Confidence[], excludeDisputed?: boolean): Promise<FileContextResult[]>;
|
|
28
|
+
discard(_ids: string[], _opts?: RetireOptions): Promise<DiscardResult>;
|
|
28
29
|
invalidate(files: string[]): Promise<{
|
|
29
30
|
invalidated: number;
|
|
30
31
|
}>;
|
|
31
32
|
getLinked(id: string): Promise<KBEntry[]>;
|
|
32
33
|
touch(ids: string[]): Promise<number>;
|
|
33
|
-
relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
|
|
34
|
+
relatedClaims(ids: string[], limit?: number, filter?: EntryTrustFilter): Promise<KBEntry[]>;
|
|
34
35
|
prime(opts: PrimeOptions): Promise<PrimedContext>;
|
|
35
36
|
promote(id: string, reason?: string): Promise<{
|
|
36
37
|
id: string;
|
|
@@ -151,6 +151,10 @@ export class HttpKbProvider {
|
|
|
151
151
|
params.include_stale = 'true';
|
|
152
152
|
if (opts.include_superseded)
|
|
153
153
|
params.include_superseded = 'true';
|
|
154
|
+
if (opts.confidence?.length)
|
|
155
|
+
params.confidence = opts.confidence.join(',');
|
|
156
|
+
if (opts.exclude_disputed)
|
|
157
|
+
params.exclude_disputed = 'true';
|
|
154
158
|
try {
|
|
155
159
|
return await this.rawRequest('GET', '/api/kb/query', undefined, params);
|
|
156
160
|
}
|
|
@@ -161,19 +165,27 @@ export class HttpKbProvider {
|
|
|
161
165
|
throw err;
|
|
162
166
|
}
|
|
163
167
|
}
|
|
164
|
-
async context(files) {
|
|
168
|
+
async context(files, confidence, excludeDisputed) {
|
|
165
169
|
await this.tryFlushQueue();
|
|
166
170
|
try {
|
|
167
|
-
const
|
|
171
|
+
const ctxParams = { files: files.join(',') };
|
|
172
|
+
if (confidence?.length)
|
|
173
|
+
ctxParams.confidence = confidence.join(',');
|
|
174
|
+
if (excludeDisputed)
|
|
175
|
+
ctxParams.exclude_disputed = 'true';
|
|
176
|
+
const result = await this.rawRequest('GET', '/api/kb/context', undefined, ctxParams);
|
|
168
177
|
return result.results;
|
|
169
178
|
}
|
|
170
179
|
catch (err) {
|
|
171
180
|
if (isConnectionError(err)) {
|
|
172
|
-
return this.fallback.context(files);
|
|
181
|
+
return this.fallback.context(files, confidence, excludeDisputed);
|
|
173
182
|
}
|
|
174
183
|
throw err;
|
|
175
184
|
}
|
|
176
185
|
}
|
|
186
|
+
async discard(_ids, _opts) {
|
|
187
|
+
throw new Error('kb_invalidate {ids} (id-level discard) is not supported by the HTTP KB provider');
|
|
188
|
+
}
|
|
177
189
|
async invalidate(files) {
|
|
178
190
|
await this.tryFlushQueue();
|
|
179
191
|
try {
|
|
@@ -204,9 +216,9 @@ export class HttpKbProvider {
|
|
|
204
216
|
// Delegated to the local store like getLinked: the graph lives alongside the
|
|
205
217
|
// entries, and there is no remote route for it. Never throws -- a graph miss
|
|
206
218
|
// must degrade to "no related claims", not fail a prime.
|
|
207
|
-
async relatedClaims(ids, limit) {
|
|
219
|
+
async relatedClaims(ids, limit, filter) {
|
|
208
220
|
try {
|
|
209
|
-
return await this.fallback.relatedClaims(ids, limit);
|
|
221
|
+
return await this.fallback.relatedClaims(ids, limit, filter);
|
|
210
222
|
}
|
|
211
223
|
catch {
|
|
212
224
|
return [];
|
|
@@ -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,6 +6,10 @@ 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
|
+
/** The project slug (KB identity) for a repo folder, cached like getKbProviders'. */
|
|
12
|
+
export declare function getProjectSlug(cwd?: string, remoteUrl?: string): string;
|
|
9
13
|
/**
|
|
10
14
|
* Resolve the KB providers for a repo. `cwd` should be the repo the call is
|
|
11
15
|
* about -- omitting it falls back to the calling process's cwd, which is only
|
|
@@ -15,6 +15,10 @@ export async function createKbProviders(cwd, remoteUrl) {
|
|
|
15
15
|
// open a separate connection to the same file for every repo the process
|
|
16
16
|
// touches -- so it gets its own single-slot cache.
|
|
17
17
|
let _globalProvider = null;
|
|
18
|
+
/** The single shared global KB provider. */
|
|
19
|
+
export function getGlobalKbProvider() {
|
|
20
|
+
return getGlobalProvider();
|
|
21
|
+
}
|
|
18
22
|
function getGlobalProvider() {
|
|
19
23
|
if (!_globalProvider) {
|
|
20
24
|
_globalProvider = (async () => {
|
|
@@ -219,6 +223,10 @@ function slugFor(cwd, remoteUrl) {
|
|
|
219
223
|
}
|
|
220
224
|
return slug;
|
|
221
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
|
+
}
|
|
222
230
|
/**
|
|
223
231
|
* Resolve the KB providers for a repo. `cwd` should be the repo the call is
|
|
224
232
|
* about -- omitting it falls back to the calling process's cwd, which is only
|
|
@@ -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
|