@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
// kb (self) resolution: which repo a kb_* tool call is about.
|
|
2
|
+
//
|
|
3
|
+
// No kb_* tool takes a scope parameter. The KB a call reads/writes is derived
|
|
4
|
+
// from WHO is calling:
|
|
5
|
+
//
|
|
6
|
+
// MEMBER session (?member=<uuid> or a member JWT) -- the member's registered
|
|
7
|
+
// work folder (getSessionMemberId() from the tool-scope lane).
|
|
8
|
+
// FULL session (no member identity) -- the MCP client's roots (roots/list,
|
|
9
|
+
// cached per session by src/services/session-roots.ts): the first offered
|
|
10
|
+
// root that is a git repository with an origin remote wins. The server's
|
|
11
|
+
// own working folder is used only when the client offers no roots.
|
|
12
|
+
//
|
|
13
|
+
// An HTTP server cannot see a client's cwd, so a FULL session whose client
|
|
14
|
+
// offers no roots gets the server's folder.
|
|
15
|
+
//
|
|
16
|
+
// KB identity comes from the resolved folder's origin remote, so a folder that
|
|
17
|
+
// is missing, is not a git repository, or has no origin remote is refused with
|
|
18
|
+
// a typed error carrying one line of remediation -- never silently mapped to a
|
|
19
|
+
// directory-name or 'default' KB.
|
|
20
|
+
//
|
|
21
|
+
// In-process callers that already know exactly which repo they mean (the
|
|
22
|
+
// execute_prompt post-dispatch harvest, the `kb commit` CLI) pass an explicit
|
|
23
|
+
// KbAnchor as the handler's second argument. That argument is not part of any
|
|
24
|
+
// tool's input schema, so no MCP client can supply it.
|
|
25
|
+
import fs from 'node:fs';
|
|
26
|
+
import path from 'node:path';
|
|
27
|
+
import { execFileSync } from 'node:child_process';
|
|
28
|
+
import { getSelfMemoSlot, getSessionMemberId, getSessionRoots } from '../tool-scope.js';
|
|
29
|
+
import { getAgent } from '../registry.js';
|
|
30
|
+
import { knownRepoRemoteUrl } from '../member-remote-url.js';
|
|
31
|
+
import { getKbProviders, getGlobalKbProvider, getProjectSlug, kbConfigSelectsHttp } from './kb-providers.js';
|
|
32
|
+
import { getMemberBibleView } from './member-bible-view.js';
|
|
33
|
+
import { isSqliteProject, requireSqliteProject } from './require-sqlite-project.js';
|
|
34
|
+
import { HttpKbProvider } from './http-provider.js';
|
|
35
|
+
import { gitExecutable } from '../../os/git-executable.js';
|
|
36
|
+
export class KbSelfError extends Error {
|
|
37
|
+
code;
|
|
38
|
+
folder;
|
|
39
|
+
remediation;
|
|
40
|
+
constructor(code, folder, problem, remediation) {
|
|
41
|
+
super(`${code}: ${problem} Remediation: ${remediation}`);
|
|
42
|
+
this.name = 'KbSelfError';
|
|
43
|
+
this.code = code;
|
|
44
|
+
this.folder = folder;
|
|
45
|
+
this.remediation = remediation;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
function whose(memberLabel) {
|
|
49
|
+
return memberLabel ? `member '${memberLabel}' work folder` : 'server working folder';
|
|
50
|
+
}
|
|
51
|
+
// A FULL session (no member identity) resolves from the MCP client's roots
|
|
52
|
+
// when the client offers any (see resolveSelfSession), else from the fleet
|
|
53
|
+
// SERVER's working folder -- never the client's cwd, which an HTTP server
|
|
54
|
+
// cannot see. A caller hitting a self error on the server-folder path usually
|
|
55
|
+
// expected its own directory, so the error names that cause (including
|
|
56
|
+
// whether the client offered roots) and every fix explicitly.
|
|
57
|
+
function fullSessionCause() {
|
|
58
|
+
return "This is a FULL session (no member identity) and the client offered no MCP roots, so its scope is the fleet server's own working folder, not the calling client's directory";
|
|
59
|
+
}
|
|
60
|
+
const FULL_SESSION_FIX = "Open the client in the repository (a client that offers MCP roots is scoped to its first root inside a git repository with an origin remote), restart the fleet server with its working folder set to that repository, or call from a member session (?member=<id>) of a member registered on it.";
|
|
61
|
+
function listForError(items) {
|
|
62
|
+
const shown = items.slice(0, 5).map(i => `'${i}'`).join(', ');
|
|
63
|
+
return items.length > 5 ? `${shown}, and ${items.length - 5} more` : shown;
|
|
64
|
+
}
|
|
65
|
+
function noWorkFolder(folder, memberLabel) {
|
|
66
|
+
return new KbSelfError('E-SELF-NO-WORKFOLDER', folder, `The ${whose(memberLabel)} ${folder ? `'${folder}' does not exist or is not a directory.` : 'is not set.'}`, memberLabel
|
|
67
|
+
? 'Create the folder or re-register the member with an existing work folder (register_member / update_member).'
|
|
68
|
+
: FULL_SESSION_FIX);
|
|
69
|
+
}
|
|
70
|
+
function gitOut(folder, args, opts = {}) {
|
|
71
|
+
// Same ceiling as resolveProjectSlug: the folder itself must be the repo, so a
|
|
72
|
+
// temp folder that merely sits inside some other checkout is not mistaken
|
|
73
|
+
// for that checkout.
|
|
74
|
+
const env = opts.ceiling === false ? process.env : { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(folder) };
|
|
75
|
+
try {
|
|
76
|
+
return execFileSync(gitExecutable(), args, {
|
|
77
|
+
cwd: folder, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
78
|
+
}).trim();
|
|
79
|
+
}
|
|
80
|
+
catch {
|
|
81
|
+
return null;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Validate a local folder as a (self) repo: it exists and is a git repository.
|
|
86
|
+
* Shared by kb (self) and code (self) resolution -- code tools need no origin
|
|
87
|
+
* remote (an index is keyed by folder, not by KB identity), kb tools add the
|
|
88
|
+
* remote check on top (validateSelfFolder).
|
|
89
|
+
*/
|
|
90
|
+
export function validateSelfRepoFolder(folder, memberLabel) {
|
|
91
|
+
let isDir = false;
|
|
92
|
+
try {
|
|
93
|
+
isDir = !!folder && fs.statSync(folder).isDirectory();
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
isDir = false;
|
|
97
|
+
}
|
|
98
|
+
if (!isDir)
|
|
99
|
+
throw noWorkFolder(folder, memberLabel);
|
|
100
|
+
if (gitOut(folder, ['rev-parse', '--git-dir']) === null) {
|
|
101
|
+
throw new KbSelfError('E-SELF-NOT-A-REPO', folder, memberLabel
|
|
102
|
+
? `The ${whose(memberLabel)} '${folder}' is not a git repository.`
|
|
103
|
+
: `${fullSessionCause()}; '${folder}' is not a git repository.`, memberLabel
|
|
104
|
+
? `Run 'git init' (or clone the project) in '${folder}' and add an origin remote.`
|
|
105
|
+
: `${FULL_SESSION_FIX} Or make '${folder}' itself a git repository with an origin remote.`);
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
/** Validate a local folder as a KB anchor: exists, is a git repo, has an origin remote. */
|
|
109
|
+
export function validateSelfFolder(folder, memberLabel) {
|
|
110
|
+
validateSelfRepoFolder(folder, memberLabel);
|
|
111
|
+
const remote = gitOut(folder, ['remote', 'get-url', 'origin']);
|
|
112
|
+
if (!remote) {
|
|
113
|
+
throw new KbSelfError('E-SELF-NO-REMOTE', folder, memberLabel
|
|
114
|
+
? `The ${whose(memberLabel)} '${folder}' has no origin remote, so it has no KB identity.`
|
|
115
|
+
: `${fullSessionCause()}; '${folder}' has no origin remote, so it has no KB identity.`, memberLabel
|
|
116
|
+
? `Run 'git remote add origin <url>' in '${folder}'.`
|
|
117
|
+
: `${FULL_SESSION_FIX} Or run 'git remote add origin <url>' in '${folder}'.`);
|
|
118
|
+
}
|
|
119
|
+
return { folder };
|
|
120
|
+
}
|
|
121
|
+
function hasOriginRemote(folder) {
|
|
122
|
+
return !!gitOut(folder, ['remote', 'get-url', 'origin']);
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* The top level of the git repository a client root sits in, or null when it
|
|
126
|
+
* is in none. Unlike a member's registered work folder, a root is wherever the
|
|
127
|
+
* client was opened, often a subfolder, so there is no ceiling here. A root
|
|
128
|
+
* that already is the top level keeps its spelling (git answers with resolved
|
|
129
|
+
* symlinks, short names expanded and forward slashes), so it names the same
|
|
130
|
+
* index and KB folder as before.
|
|
131
|
+
*/
|
|
132
|
+
function rootRepoTopLevel(root) {
|
|
133
|
+
const top = gitOut(root, ['rev-parse', '--show-toplevel'], { ceiling: false });
|
|
134
|
+
if (!top)
|
|
135
|
+
return null;
|
|
136
|
+
try {
|
|
137
|
+
if (fs.realpathSync.native(root) === fs.realpathSync.native(top))
|
|
138
|
+
return root;
|
|
139
|
+
}
|
|
140
|
+
catch { /* fall through to git's answer */ }
|
|
141
|
+
return path.resolve(top);
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* FULL session (self) selection (owner decision: client roots first, server
|
|
145
|
+
* working folder only when the client offers no roots). A root inside a git
|
|
146
|
+
* repository stands for that repository's top level, so a client opened in a
|
|
147
|
+
* subfolder scopes to the repository:
|
|
148
|
+
*
|
|
149
|
+
* 1. The first offered root in a git repository with an origin remote.
|
|
150
|
+
* 2. Extension for code_* only: when roots are offered and none has an
|
|
151
|
+
* origin, the first offered root in a git repository
|
|
152
|
+
* (rootWithoutOrigin: kb_* refuses it).
|
|
153
|
+
* 3. No roots offered (no roots capability or an empty list): the server
|
|
154
|
+
* working folder.
|
|
155
|
+
*
|
|
156
|
+
* Everything else is refused, never answered from the server folder: it may be
|
|
157
|
+
* an unrelated repository, and the caller could not tell.
|
|
158
|
+
* - Asking the client failed: E-SELF-NO-WORKFOLDER naming the failure; the
|
|
159
|
+
* next call asks again.
|
|
160
|
+
* - No offered root is a folder on this host (a remote client's path, a
|
|
161
|
+
* deleted folder, a non-file URI): E-SELF-NO-WORKFOLDER.
|
|
162
|
+
* - Roots on this host but none in a git repository: E-SELF-NOT-A-REPO.
|
|
163
|
+
*/
|
|
164
|
+
function selectFullSessionFolder() {
|
|
165
|
+
const roots = getSessionRoots();
|
|
166
|
+
if (roots?.fetchError !== undefined) {
|
|
167
|
+
throw new KbSelfError('E-SELF-NO-WORKFOLDER', '', `This is a FULL session (no member identity) and asking the client for its MCP roots failed (${roots.fetchError}), so the session's scope is unknown; the call was not run and the server's working folder was not used in its place.`, 'Retry the same call: each call asks the client again. If it keeps failing, restart the client or check that it answers roots/list.');
|
|
168
|
+
}
|
|
169
|
+
if (!roots || roots.offered.length === 0) {
|
|
170
|
+
return { folder: process.cwd(), source: 'cwd', ...(roots ? { roots } : {}) };
|
|
171
|
+
}
|
|
172
|
+
if (roots.folders.length === 0) {
|
|
173
|
+
throw new KbSelfError('E-SELF-NO-WORKFOLDER', roots.offered[0], `This is a FULL session (no member identity) and the client offered MCP roots, but none of them (${listForError(roots.offered)}) is a folder on this host, so the session has no KB or code scope; the server's working folder was not used in its place.`, 'Open the client on this host in a git repository with an origin remote, or call from a member session (?member=<id>) of a member registered on that folder.');
|
|
174
|
+
}
|
|
175
|
+
let firstRepo;
|
|
176
|
+
for (const root of roots.folders) {
|
|
177
|
+
const folder = rootRepoTopLevel(root);
|
|
178
|
+
if (folder === null)
|
|
179
|
+
continue;
|
|
180
|
+
if (hasOriginRemote(folder))
|
|
181
|
+
return { folder, source: 'root', roots };
|
|
182
|
+
if (firstRepo === undefined)
|
|
183
|
+
firstRepo = folder;
|
|
184
|
+
}
|
|
185
|
+
if (firstRepo !== undefined)
|
|
186
|
+
return { folder: firstRepo, source: 'root', rootWithoutOrigin: true, roots };
|
|
187
|
+
throw new KbSelfError('E-SELF-NOT-A-REPO', roots.folders[0], `This is a FULL session (no member identity) and the client offered MCP roots, but none of them (${listForError(roots.folders)}) is in a git repository, so the session has no KB or code scope.`, `Open the client in a git repository with an origin remote (or add one as a root), or run 'git init' and 'git remote add origin <url>' in '${roots.folders[0]}'.`);
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* Resolve WHICH folder the calling session means by (self): a MEMBER session's
|
|
191
|
+
* registered work folder; a FULL session's selected client root, else the
|
|
192
|
+
* server working folder (selectFullSessionFolder). A MEMBER session whose
|
|
193
|
+
* member is unregistered or has no work folder is refused with
|
|
194
|
+
* E-SELF-NO-WORKFOLDER -- it never falls back to the server folder, and never
|
|
195
|
+
* reads client roots.
|
|
196
|
+
*
|
|
197
|
+
* Inside a tool call the FULL selection is memoized for the rest of that call,
|
|
198
|
+
* so kb (self) and code (self) share one answer and cannot diverge.
|
|
199
|
+
*/
|
|
200
|
+
export function resolveSelfSession() {
|
|
201
|
+
const memberId = getSessionMemberId();
|
|
202
|
+
if (memberId === undefined) {
|
|
203
|
+
const memo = getSelfMemoSlot();
|
|
204
|
+
if (!memo)
|
|
205
|
+
return selectFullSessionFolder();
|
|
206
|
+
if (memo.error !== undefined)
|
|
207
|
+
throw memo.error;
|
|
208
|
+
if (memo.value !== undefined)
|
|
209
|
+
return memo.value;
|
|
210
|
+
try {
|
|
211
|
+
memo.value = selectFullSessionFolder();
|
|
212
|
+
return memo.value;
|
|
213
|
+
}
|
|
214
|
+
catch (e) {
|
|
215
|
+
memo.error = e;
|
|
216
|
+
throw e;
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
const agent = getAgent(memberId);
|
|
220
|
+
const label = agent?.friendlyName ?? memberId;
|
|
221
|
+
const folder = agent?.workFolder ?? '';
|
|
222
|
+
if (!agent || !folder)
|
|
223
|
+
throw noWorkFolder(folder, label);
|
|
224
|
+
return { memberId, memberLabel: label, folder, agent };
|
|
225
|
+
}
|
|
226
|
+
/**
|
|
227
|
+
* Resolve the calling session's own KB anchor (see header). Throws KbSelfError
|
|
228
|
+
* when the resolved folder cannot carry a KB identity.
|
|
229
|
+
*/
|
|
230
|
+
export function resolveSelfAnchor() {
|
|
231
|
+
const self = resolveSelfSession();
|
|
232
|
+
const { agent, folder, memberLabel: label, memberId } = self;
|
|
233
|
+
if (!agent) {
|
|
234
|
+
if (self.rootWithoutOrigin) {
|
|
235
|
+
throw new KbSelfError('E-SELF-NO-REMOTE', folder, `This is a FULL session (no member identity) and none of the client's MCP roots (${listForError(self.roots?.folders ?? [folder])}) is in a git repository with an origin remote, so the session has no KB identity (code tools use the first offered git repository, '${folder}').`, `Run 'git remote add origin <url>' in '${folder}', or open the client in a repository that has an origin remote.`);
|
|
236
|
+
}
|
|
237
|
+
return validateSelfFolder(folder);
|
|
238
|
+
}
|
|
239
|
+
if (agent.agentType !== 'local') {
|
|
240
|
+
// The work folder lives on another host: git cannot be shelled out there,
|
|
241
|
+
// so the KB identity is the member's single known origin remote.
|
|
242
|
+
const remoteUrl = knownRepoRemoteUrl(agent);
|
|
243
|
+
if (!remoteUrl) {
|
|
244
|
+
throw new KbSelfError('E-SELF-NO-REMOTE', folder, `Member '${label}' work folder '${folder}' is on another host and the member has no single known origin remote, so it has no KB identity.`, `Record the repo's origin URL on the member (update_member git_repos: ["<origin url>"]) or call kb tools from a session on the member's own host.`);
|
|
245
|
+
}
|
|
246
|
+
return { folder, remoteUrl, memberId };
|
|
247
|
+
}
|
|
248
|
+
return validateSelfFolder(folder, label);
|
|
249
|
+
}
|
|
250
|
+
/** The anchor a kb_* handler uses: the explicit in-process anchor, else (self). */
|
|
251
|
+
export function resolveKbAnchor(anchor) {
|
|
252
|
+
return anchor ?? resolveSelfAnchor();
|
|
253
|
+
}
|
|
254
|
+
/** KB providers for a kb_* handler call. */
|
|
255
|
+
export async function getSelfKbProviders(anchor) {
|
|
256
|
+
const resolved = resolveKbAnchor(anchor);
|
|
257
|
+
return getKbProviders(resolved.folder, resolved.remoteUrl);
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* The own-scope tag of the calling MEMBER session, 'member:<uuid>', or
|
|
261
|
+
* undefined for a FULL session or an in-process caller passing an explicit
|
|
262
|
+
* KbAnchor (same predicate getSelfReadKb uses to pick the bible view).
|
|
263
|
+
* MEMBER captures carry this tag, and MEMBER INFERRED/UNVERIFIED reads,
|
|
264
|
+
* kb_promote and kb_invalidate act only on entries carrying it.
|
|
265
|
+
*/
|
|
266
|
+
export function memberOwnerTag(anchor) {
|
|
267
|
+
if (anchor !== undefined)
|
|
268
|
+
return undefined;
|
|
269
|
+
const memberId = getSessionMemberId();
|
|
270
|
+
return memberId === undefined ? undefined : `member:${memberId}`;
|
|
271
|
+
}
|
|
272
|
+
export async function getSelfReadKb(anchor, confidence, opts = {}) {
|
|
273
|
+
const resolved = resolveKbAnchor(anchor);
|
|
274
|
+
const isMemberSelf = anchor === undefined && getSessionMemberId() !== undefined;
|
|
275
|
+
const namesUnconfirmedTier = (confidence ?? []).some(c => c !== 'CONFIRMED');
|
|
276
|
+
// Decided from the config, so the default (SQLite) path opens no store here.
|
|
277
|
+
if (isMemberSelf && kbConfigSelectsHttp()) {
|
|
278
|
+
const providers = await getKbProviders(resolved.folder, resolved.remoteUrl);
|
|
279
|
+
if (!isSqliteProject(providers.project)) {
|
|
280
|
+
const ownerTag = namesUnconfirmedTier || opts.ownScope ? memberOwnerTag(anchor) : undefined;
|
|
281
|
+
return { providers, anchor: resolved, memberView: false, ...(ownerTag !== undefined ? { ownerTag } : {}) };
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
if (isMemberSelf && !namesUnconfirmedTier && !opts.ownScope) {
|
|
285
|
+
const [project, global] = await Promise.all([getMemberBibleView(resolved), getGlobalKbProvider()]);
|
|
286
|
+
return {
|
|
287
|
+
providers: { project, global, projectSlug: getProjectSlug(resolved.folder, resolved.remoteUrl) },
|
|
288
|
+
anchor: resolved,
|
|
289
|
+
memberView: true,
|
|
290
|
+
};
|
|
291
|
+
}
|
|
292
|
+
const ownerTag = memberOwnerTag(anchor);
|
|
293
|
+
return {
|
|
294
|
+
providers: await getKbProviders(resolved.folder, resolved.remoteUrl),
|
|
295
|
+
anchor: resolved,
|
|
296
|
+
memberView: false,
|
|
297
|
+
...(ownerTag !== undefined ? { ownerTag } : {}),
|
|
298
|
+
};
|
|
299
|
+
}
|
|
300
|
+
/**
|
|
301
|
+
* The shared split read for a MEMBER session whose explicit tier list names
|
|
302
|
+
* CONFIRMED together with at least one other tier. Returns null for every other
|
|
303
|
+
* request, which then keeps its existing path through getSelfReadKb: a FULL
|
|
304
|
+
* session, an explicit-KbAnchor caller, a CONFIRMED-only (or omitted) tier list
|
|
305
|
+
* (bible view), and a list naming only non-CONFIRMED tiers (own captures only).
|
|
306
|
+
*
|
|
307
|
+
* Callers query each half with its own tiers and owner tag, then merge with
|
|
308
|
+
* mergeSplitById (bible copy wins) and apply their limit after the merge.
|
|
309
|
+
*
|
|
310
|
+
* HTTP per-repo provider: the own half is the KB server, owner-tagged (the
|
|
311
|
+
* http provider re-checks the tag on every entry it returns), and the
|
|
312
|
+
* CONFIRMED half is the KB server too, with no owner tag, so the mixed read is
|
|
313
|
+
* a superset of the CONFIRMED-only read, which the server also answers. Any other non-sqlite provider is refused with requireSqliteProject's
|
|
314
|
+
* error naming `callerLabel`: answering with the bible half alone would
|
|
315
|
+
* silently drop tiers the caller asked for.
|
|
316
|
+
*/
|
|
317
|
+
export async function getMemberSplitRead(anchor, confidence, callerLabel) {
|
|
318
|
+
if (anchor !== undefined || getSessionMemberId() === undefined)
|
|
319
|
+
return null;
|
|
320
|
+
const tiers = [...new Set(confidence ?? [])];
|
|
321
|
+
if (!tiers.includes('CONFIRMED') || tiers.every(t => t === 'CONFIRMED'))
|
|
322
|
+
return null;
|
|
323
|
+
const ownerTag = memberOwnerTag(anchor);
|
|
324
|
+
if (ownerTag === undefined)
|
|
325
|
+
return null;
|
|
326
|
+
const resolved = resolveKbAnchor(anchor);
|
|
327
|
+
const repo = await getKbProviders(resolved.folder, resolved.remoteUrl);
|
|
328
|
+
const ownProject = repo.project instanceof HttpKbProvider
|
|
329
|
+
? repo.project
|
|
330
|
+
: requireSqliteProject(repo.project, callerLabel);
|
|
331
|
+
// Under http the server answers the CONFIRMED half as well: the bible is
|
|
332
|
+
// never loaded (on a remote member that load would also be an SSH round trip).
|
|
333
|
+
const confirmedProject = ownProject instanceof HttpKbProvider
|
|
334
|
+
? Promise.resolve(ownProject)
|
|
335
|
+
: getMemberBibleView(resolved);
|
|
336
|
+
const [bibleProject, global] = await Promise.all([confirmedProject, getGlobalKbProvider()]);
|
|
337
|
+
return {
|
|
338
|
+
anchor: resolved,
|
|
339
|
+
projectSlug: repo.projectSlug,
|
|
340
|
+
bible: { project: bibleProject, global, tiers: ['CONFIRMED'] },
|
|
341
|
+
own: { project: ownProject, global: repo.global, tiers, ownerTag },
|
|
342
|
+
};
|
|
343
|
+
}
|
|
344
|
+
/**
|
|
345
|
+
* Merge the two halves of a split read: every `bible` row, then each `own` row
|
|
346
|
+
* whose id the bible half did not already return (the bible copy wins). An
|
|
347
|
+
* optional `order` re-sorts the merged list; `limit` is applied last.
|
|
348
|
+
*/
|
|
349
|
+
export function mergeSplitById(bible, own, opts = {}) {
|
|
350
|
+
const seen = new Set(bible.map(e => e.id));
|
|
351
|
+
let merged = [...bible, ...own.filter(e => !seen.has(e.id))];
|
|
352
|
+
if (opts.order)
|
|
353
|
+
merged = merged.sort(opts.order);
|
|
354
|
+
return opts.limit !== undefined ? merged.slice(0, opts.limit) : merged;
|
|
355
|
+
}
|
|
356
|
+
/** Appended to every kb_* tool description so callers know there is no scope argument. */
|
|
357
|
+
export const KB_SELF_NOTE = ' Scope: always the calling session\'s own KB -- a member session uses its registered work folder; any other session uses the first MCP client root (roots/list) inside a git repository with an origin remote, as that repository\'s top level, or the fleet server\'s working folder when the client offers no roots; 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).';
|
|
358
|
+
//# sourceMappingURL=kb-self.js.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { SqliteProvider } from './sqlite-provider.js';
|
|
2
|
+
import type { KbAnchor } from './kb-self.js';
|
|
3
|
+
export type KbMemberViewErrorCode = 'E-MEMBER-VIEW-REMOTE' | 'E-MEMBER-VIEW-READ-ONLY';
|
|
4
|
+
export declare class KbMemberViewError extends Error {
|
|
5
|
+
readonly code: KbMemberViewErrorCode;
|
|
6
|
+
readonly folder: string;
|
|
7
|
+
readonly remediation: string;
|
|
8
|
+
constructor(code: KbMemberViewErrorCode, folder: string, problem: string, remediation: string);
|
|
9
|
+
}
|
|
10
|
+
/** The bible file a member view is built from. */
|
|
11
|
+
export declare function memberBiblePath(folder: string): string;
|
|
12
|
+
/**
|
|
13
|
+
* The in-memory view of the anchor's checkout bible. Rebuilt when the file's
|
|
14
|
+
* mtime or size changed since the last load; otherwise the cached view.
|
|
15
|
+
*/
|
|
16
|
+
export declare function getMemberBibleView(anchor: KbAnchor): Promise<SqliteProvider>;
|
|
17
|
+
/** Number of times the view for this bible path has been (re)built. For tests. */
|
|
18
|
+
export declare function memberBibleViewLoadCount(biblePath: string): number;
|
|
19
|
+
/** Drop every cached view (what a server restart does). */
|
|
20
|
+
export declare function resetMemberBibleViews(): void;
|
|
21
|
+
//# sourceMappingURL=member-bible-view.d.ts.map
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
// Member bible view: MEMBER-session KB reads come from an in-memory SQLite view
|
|
2
|
+
// of the member's own checkout bible, (self)/.fleet/kb-canonical.json.
|
|
3
|
+
//
|
|
4
|
+
// Why a view and not the per-repo DB: several members of ONE repository share
|
|
5
|
+
// one per-repo kb.sqlite (KB identity is the origin remote), but their
|
|
6
|
+
// checkouts can sit on different branches whose bibles differ. Each member
|
|
7
|
+
// must see the CONFIRMED set its own checkout carries.
|
|
8
|
+
//
|
|
9
|
+
// How:
|
|
10
|
+
// - The bible is loaded into a SqliteProvider over DatabaseSync(':memory:')
|
|
11
|
+
// -- the SAME provider class the per-repo DB uses, so ranking, prime() and
|
|
12
|
+
// relatedClaims() behave identically. Entries go through the shared
|
|
13
|
+
// bible-import loader (import mode: bible confidence preserved, directives
|
|
14
|
+
// quarantined as pending proposals, basis check), but VERBATIM: no AUDN
|
|
15
|
+
// dedupe/update/contradiction against sibling entries, so every entry keeps
|
|
16
|
+
// its bible id and confidence and none is flagged by another. The bible is
|
|
17
|
+
// already reviewed; the view reproduces it, it does not re-curate it.
|
|
18
|
+
// - One view per bible file path, so members on different branches (different
|
|
19
|
+
// checkouts, different paths) get different views.
|
|
20
|
+
// - Each read does ONE fs.stat. When mtimeMs or size differs from the values
|
|
21
|
+
// recorded at the last load, the view is rebuilt. The file is never hashed.
|
|
22
|
+
// - The cache is process memory only: a server restart starts empty and the
|
|
23
|
+
// first read rebuilds. No file, table or column is added anywhere.
|
|
24
|
+
// - A missing bible is an empty view. A malformed bible throws KbBibleError
|
|
25
|
+
// (E-BIBLE-MALFORMED) every time it is read; it is never cached as empty.
|
|
26
|
+
// - An anchor whose folder is on another host (remoteUrl + memberId set) is
|
|
27
|
+
// served the same way: one cheap stat command over the member transport
|
|
28
|
+
// (mtime + size), and the bible text is fetched only when that changed.
|
|
29
|
+
// Cached per (member, folder). If the member cannot be reached the read
|
|
30
|
+
// fails loudly (E-MEMBER-VIEW-REMOTE); it never falls back to the per-repo DB.
|
|
31
|
+
import fs from 'node:fs';
|
|
32
|
+
import path from 'node:path';
|
|
33
|
+
import { SqliteProvider } from './sqlite-provider.js';
|
|
34
|
+
import { readBibleDocument, parseBibleDocument, excludeTombstonedEntries, importBibleEntries, } from './bible-import.js';
|
|
35
|
+
import { getAgent } from '../registry.js';
|
|
36
|
+
import { getStrategy } from '../strategy.js';
|
|
37
|
+
import { getAgentOS, getAgentShell, isPosixShell } from '../../utils/agent-helpers.js';
|
|
38
|
+
import { wrapPowerShellEncoded } from '../../os/windows.js';
|
|
39
|
+
export class KbMemberViewError extends Error {
|
|
40
|
+
code;
|
|
41
|
+
folder;
|
|
42
|
+
remediation;
|
|
43
|
+
constructor(code, folder, problem, remediation) {
|
|
44
|
+
super(`${code}: ${problem} Remediation: ${remediation}`);
|
|
45
|
+
this.name = 'KbMemberViewError';
|
|
46
|
+
this.code = code;
|
|
47
|
+
this.folder = folder;
|
|
48
|
+
this.remediation = remediation;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
/** The bible file a member view is built from. */
|
|
52
|
+
export function memberBiblePath(folder) {
|
|
53
|
+
return path.join(folder, '.fleet', 'kb-canonical.json');
|
|
54
|
+
}
|
|
55
|
+
const _views = new Map();
|
|
56
|
+
const _loadCounts = new Map();
|
|
57
|
+
function statOrMissing(biblePath) {
|
|
58
|
+
try {
|
|
59
|
+
const st = fs.statSync(biblePath);
|
|
60
|
+
return { mtimeMs: st.mtimeMs, size: st.size };
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
if (err.code === 'ENOENT')
|
|
64
|
+
return { mtimeMs: -1, size: -1 };
|
|
65
|
+
throw err;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
async function buildView(biblePath, repoRoot, missing) {
|
|
69
|
+
_loadCounts.set(biblePath, (_loadCounts.get(biblePath) ?? 0) + 1);
|
|
70
|
+
// Parse BEFORE opening the database, so a malformed bible costs nothing.
|
|
71
|
+
// DOCUMENT reader: the view must honour the bible's demotion tombstones, and
|
|
72
|
+
// the only way it can is by not listing the tombstoned entry. The provider
|
|
73
|
+
// below starts EMPTY, so there is no local row for a tombstone to demote --
|
|
74
|
+
// the import-side demotion branch is the wrong tool here and is deliberately
|
|
75
|
+
// not used.
|
|
76
|
+
const doc = missing
|
|
77
|
+
? { entries: [], demotions: [] }
|
|
78
|
+
: readBibleDocument(biblePath, 'member bible view');
|
|
79
|
+
const entries = excludeTombstonedEntries(doc.entries, doc.demotions);
|
|
80
|
+
// repoRoot anchors relative source_files exactly as the per-repo provider
|
|
81
|
+
// does, so the capture basis check and prime()'s freshness check judge the
|
|
82
|
+
// bible against the member's own checkout.
|
|
83
|
+
const provider = new SqliteProvider(':memory:', repoRoot);
|
|
84
|
+
await provider.init();
|
|
85
|
+
if (entries.length > 0)
|
|
86
|
+
await importBibleEntries(provider, entries, { verbatim: true });
|
|
87
|
+
return provider;
|
|
88
|
+
}
|
|
89
|
+
function remoteFail(folder, problem) {
|
|
90
|
+
return new KbMemberViewError('E-MEMBER-VIEW-REMOTE', folder, problem, 'Check the member is reachable (member_detail / update_member), then retry; the member must have its checkout bible at <work folder>/.fleet/kb-canonical.json.');
|
|
91
|
+
}
|
|
92
|
+
function remoteBiblePath(agent, folder) {
|
|
93
|
+
const win = getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent));
|
|
94
|
+
return win ? `${folder.replace(/[\\/]+$/, '')}\\.fleet\\kb-canonical.json` : `${folder.replace(/\/+$/, '')}/.fleet/kb-canonical.json`;
|
|
95
|
+
}
|
|
96
|
+
const REMOTE_TIMEOUT_MS = 20_000;
|
|
97
|
+
/** Command that prints "<mtime> <size>" for the bible, or MISSING. */
|
|
98
|
+
function statCommand(agent, p) {
|
|
99
|
+
if (getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent))) {
|
|
100
|
+
const q = p.replace(/'/g, "''");
|
|
101
|
+
return wrapPowerShellEncoded(`if (Test-Path -LiteralPath '${q}') { $i = Get-Item -LiteralPath '${q}'; [Console]::Out.Write("$($i.LastWriteTimeUtc.Ticks) $($i.Length)") } else { [Console]::Out.Write('MISSING') }`);
|
|
102
|
+
}
|
|
103
|
+
const q = `'${p.replace(/'/g, `'\\''`)}'`;
|
|
104
|
+
return `if [ -f ${q} ]; then (stat -c '%Y %s' ${q} 2>/dev/null || stat -f '%m %z' ${q}); else printf MISSING; fi`;
|
|
105
|
+
}
|
|
106
|
+
function catCommand(agent, p) {
|
|
107
|
+
if (getAgentOS(agent) === 'windows' && !isPosixShell('windows', getAgentShell(agent))) {
|
|
108
|
+
const q = p.replace(/'/g, "''");
|
|
109
|
+
return wrapPowerShellEncoded(`[Console]::Out.Write([System.IO.File]::ReadAllText('${q}'))`);
|
|
110
|
+
}
|
|
111
|
+
return `cat '${p.replace(/'/g, `'\\''`)}'`;
|
|
112
|
+
}
|
|
113
|
+
async function getRemoteMemberBibleView(anchor) {
|
|
114
|
+
const agent = anchor.memberId ? getAgent(anchor.memberId) : undefined;
|
|
115
|
+
if (!agent) {
|
|
116
|
+
throw remoteFail(anchor.folder, `The member for work folder '${anchor.folder}' is not registered, so its checkout bible cannot be fetched.`);
|
|
117
|
+
}
|
|
118
|
+
const strategy = getStrategy(agent);
|
|
119
|
+
const biblePath = remoteBiblePath(agent, anchor.folder);
|
|
120
|
+
const key = `remote:${agent.id}:${biblePath}`;
|
|
121
|
+
const run = async (cmd) => {
|
|
122
|
+
let r;
|
|
123
|
+
try {
|
|
124
|
+
r = await strategy.execCommand(cmd, REMOTE_TIMEOUT_MS);
|
|
125
|
+
}
|
|
126
|
+
catch (err) {
|
|
127
|
+
throw remoteFail(anchor.folder, `Could not reach member '${agent.friendlyName}' to read its checkout bible: ${err instanceof Error ? err.message : String(err)}.`);
|
|
128
|
+
}
|
|
129
|
+
if (r.code !== 0) {
|
|
130
|
+
throw remoteFail(anchor.folder, `Reading the bible on member '${agent.friendlyName}' failed (exit ${r.code}): ${r.stderr.trim()}.`);
|
|
131
|
+
}
|
|
132
|
+
return r.stdout;
|
|
133
|
+
};
|
|
134
|
+
const statOut = (await run(statCommand(agent, biblePath))).split(/\r?\n/).map(l => l.trim()).filter(Boolean).pop() ?? '';
|
|
135
|
+
let mtimeMs = -1;
|
|
136
|
+
let size = -1;
|
|
137
|
+
if (statOut !== 'MISSING') {
|
|
138
|
+
const m = /^(\d+) (\d+)$/.exec(statOut);
|
|
139
|
+
if (!m)
|
|
140
|
+
throw remoteFail(anchor.folder, `Unexpected stat output from member '${agent.friendlyName}': '${statOut.slice(0, 80)}'.`);
|
|
141
|
+
mtimeMs = Number(m[1]);
|
|
142
|
+
size = Number(m[2]);
|
|
143
|
+
}
|
|
144
|
+
const current = _views.get(key);
|
|
145
|
+
if (current && current.mtimeMs === mtimeMs && current.size === size)
|
|
146
|
+
return current.provider;
|
|
147
|
+
const build = async () => {
|
|
148
|
+
_loadCounts.set(key, (_loadCounts.get(key) ?? 0) + 1);
|
|
149
|
+
// Same tombstone rule as the local path above -- a demotion must not be
|
|
150
|
+
// visible on one transport and invisible on the other.
|
|
151
|
+
const remoteDoc = mtimeMs === -1
|
|
152
|
+
? { entries: [], demotions: [] }
|
|
153
|
+
: parseBibleDocument(await run(catCommand(agent, biblePath)), biblePath, 'member bible view');
|
|
154
|
+
const entries = excludeTombstonedEntries(remoteDoc.entries, remoteDoc.demotions);
|
|
155
|
+
// The member's checkout is on another host: nothing here can verify its
|
|
156
|
+
// source files, so import unanchored, then bind the remote folder so
|
|
157
|
+
// freshness issues no verdict (see SqliteProvider.bindRepoPath).
|
|
158
|
+
const provider = new SqliteProvider(':memory:');
|
|
159
|
+
await provider.init();
|
|
160
|
+
if (entries.length > 0)
|
|
161
|
+
await importBibleEntries(provider, entries, { verbatim: true });
|
|
162
|
+
provider.bindRepoPath(anchor.folder);
|
|
163
|
+
return provider;
|
|
164
|
+
};
|
|
165
|
+
const slot = { mtimeMs, size, provider: build() };
|
|
166
|
+
_views.set(key, slot);
|
|
167
|
+
slot.provider.catch(() => {
|
|
168
|
+
if (_views.get(key) === slot)
|
|
169
|
+
_views.delete(key);
|
|
170
|
+
});
|
|
171
|
+
return slot.provider;
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* The in-memory view of the anchor's checkout bible. Rebuilt when the file's
|
|
175
|
+
* mtime or size changed since the last load; otherwise the cached view.
|
|
176
|
+
*/
|
|
177
|
+
export async function getMemberBibleView(anchor) {
|
|
178
|
+
if (anchor.remoteUrl !== undefined)
|
|
179
|
+
return getRemoteMemberBibleView(anchor);
|
|
180
|
+
const biblePath = memberBiblePath(anchor.folder);
|
|
181
|
+
const { mtimeMs, size } = statOrMissing(biblePath);
|
|
182
|
+
const current = _views.get(biblePath);
|
|
183
|
+
if (current && current.mtimeMs === mtimeMs && current.size === size) {
|
|
184
|
+
return current.provider;
|
|
185
|
+
}
|
|
186
|
+
// The replaced view is not closed: a concurrent reader may still hold it
|
|
187
|
+
// mid-call. Dropping the reference lets it be collected.
|
|
188
|
+
const slot = { mtimeMs, size, provider: buildView(biblePath, anchor.folder, mtimeMs === -1) };
|
|
189
|
+
_views.set(biblePath, slot);
|
|
190
|
+
// Never cache a failed build (a malformed bible must fail on every read, and
|
|
191
|
+
// a fixed bible must load without a restart).
|
|
192
|
+
slot.provider.catch(() => {
|
|
193
|
+
if (_views.get(biblePath) === slot)
|
|
194
|
+
_views.delete(biblePath);
|
|
195
|
+
});
|
|
196
|
+
return slot.provider;
|
|
197
|
+
}
|
|
198
|
+
/** Number of times the view for this bible path has been (re)built. For tests. */
|
|
199
|
+
export function memberBibleViewLoadCount(biblePath) {
|
|
200
|
+
return _loadCounts.get(biblePath) ?? 0;
|
|
201
|
+
}
|
|
202
|
+
/** Drop every cached view (what a server restart does). */
|
|
203
|
+
export function resetMemberBibleViews() {
|
|
204
|
+
_views.clear();
|
|
205
|
+
_loadCounts.clear();
|
|
206
|
+
}
|
|
207
|
+
//# sourceMappingURL=member-bible-view.js.map
|
|
@@ -1,2 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* True when `file` cannot be repo-relative on ANY platform: absolute in POSIX
|
|
3
|
+
* or Windows form (leading / or \, or a drive letter), or with a '..' segment
|
|
4
|
+
* under either separator. Independent of the host OS, so a path checked here
|
|
5
|
+
* means the same on the KB server as on this machine.
|
|
6
|
+
*/
|
|
7
|
+
export declare function isAbsoluteOrTraversing(file: string): boolean;
|
|
1
8
|
export declare function validateFilePaths(files: string[]): void;
|
|
2
9
|
//# sourceMappingURL=path-validation.d.ts.map
|
|
@@ -1,4 +1,15 @@
|
|
|
1
1
|
import path from 'node:path';
|
|
2
|
+
/**
|
|
3
|
+
* True when `file` cannot be repo-relative on ANY platform: absolute in POSIX
|
|
4
|
+
* or Windows form (leading / or \, or a drive letter), or with a '..' segment
|
|
5
|
+
* under either separator. Independent of the host OS, so a path checked here
|
|
6
|
+
* means the same on the KB server as on this machine.
|
|
7
|
+
*/
|
|
8
|
+
export function isAbsoluteOrTraversing(file) {
|
|
9
|
+
if (/^[\\/]/.test(file) || /^[A-Za-z]:/.test(file))
|
|
10
|
+
return true;
|
|
11
|
+
return file.split(/[\\/]/).includes('..');
|
|
12
|
+
}
|
|
2
13
|
export function validateFilePaths(files) {
|
|
3
14
|
for (const file of files) {
|
|
4
15
|
if (path.isAbsolute(file)) {
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { execFileSync } from 'child_process';
|
|
2
2
|
import path from 'path';
|
|
3
|
+
import { gitExecutable } from '../../os/git-executable.js';
|
|
3
4
|
export function resolveProjectSlug(cwd, remoteUrl) {
|
|
4
5
|
if (remoteUrl && remoteUrl.trim()) {
|
|
5
6
|
const slug = slugify(remoteUrl);
|
|
@@ -10,8 +11,8 @@ export function resolveProjectSlug(cwd, remoteUrl) {
|
|
|
10
11
|
const env = { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(dir) };
|
|
11
12
|
// 1. git remote URL
|
|
12
13
|
try {
|
|
13
|
-
const remote = execFileSync(
|
|
14
|
-
cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
14
|
+
const remote = execFileSync(gitExecutable(), ['remote', 'get-url', 'origin'], {
|
|
15
|
+
cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
15
16
|
}).trim();
|
|
16
17
|
const slug = slugify(remote);
|
|
17
18
|
if (slug)
|
|
@@ -20,8 +21,8 @@ export function resolveProjectSlug(cwd, remoteUrl) {
|
|
|
20
21
|
catch { }
|
|
21
22
|
// 2. git repo root dir name
|
|
22
23
|
try {
|
|
23
|
-
const root = execFileSync(
|
|
24
|
-
cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
24
|
+
const root = execFileSync(gitExecutable(), ['rev-parse', '--show-toplevel'], {
|
|
25
|
+
cwd: dir, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
25
26
|
}).trim();
|
|
26
27
|
const slug = slugify(path.basename(root));
|
|
27
28
|
if (slug)
|