@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import http from 'node:http';
|
|
2
2
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
3
3
|
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
|
|
4
|
+
import { type ToolScope } from './tool-scope.js';
|
|
4
5
|
interface Session {
|
|
5
6
|
server: McpServer;
|
|
6
7
|
transport: StreamableHTTPServerTransport;
|
|
@@ -8,10 +9,57 @@ interface Session {
|
|
|
8
9
|
* else the local workspace (127.0.0.1-only trust boundary). Event broadcast
|
|
9
10
|
* is scoped by this -- events never cross a workspace wall. */
|
|
10
11
|
workspaceId: string;
|
|
12
|
+
/** Identity that opened this session (see SessionOwner). Every later
|
|
13
|
+
* GET/DELETE/POST on the session id must come from the same identity. */
|
|
14
|
+
owner: SessionOwner;
|
|
11
15
|
}
|
|
16
|
+
/**
|
|
17
|
+
* The identity a /mcp request carries, derived the same way at initialize and
|
|
18
|
+
* on every later request on that session:
|
|
19
|
+
* - `jwt`: a VERIFIED member JWT (Authorization: Bearer); bound by its
|
|
20
|
+
* member_id + workspace_id claims.
|
|
21
|
+
* - `secret`: no bearer, so the pre-route gate already required this
|
|
22
|
+
* install's access secret (X-Apra-Fleet-Member-Secret). `member` is the
|
|
23
|
+
* resolved ?member= id at initialize (null for a FULL-scope session).
|
|
24
|
+
*
|
|
25
|
+
* Binding rule (apra-fleet-b4g.138.6): a JWT caller may address only a
|
|
26
|
+
* session opened with a JWT for the same member and workspace; an access-secret
|
|
27
|
+
* caller may address only a session opened with the access secret. Within the
|
|
28
|
+
* secret kind any secret-opened session is addressable, whatever ?member= the
|
|
29
|
+
* opener used: the secret holder can open a FULL-scope session (a superset of
|
|
30
|
+
* every member session) at will, and ?member= is an unauthenticated label, so
|
|
31
|
+
* binding on it would add no security boundary while breaking clients whose
|
|
32
|
+
* later requests do not repeat the initialize URL's query string.
|
|
33
|
+
*/
|
|
34
|
+
export type SessionOwner = {
|
|
35
|
+
kind: 'jwt';
|
|
36
|
+
memberId: string;
|
|
37
|
+
workspaceId: string;
|
|
38
|
+
} | {
|
|
39
|
+
kind: 'secret';
|
|
40
|
+
member: string | null;
|
|
41
|
+
engineOrigin: boolean;
|
|
42
|
+
kbMaintainer: boolean;
|
|
43
|
+
};
|
|
44
|
+
/** Why `caller` may not address a session owned by `owner`, or null when it may. */
|
|
45
|
+
export declare function sessionOwnerMismatch(owner: SessionOwner, caller: SessionOwner): string | null;
|
|
12
46
|
export interface HttpTransportOptions {
|
|
13
|
-
|
|
47
|
+
/** Registers the tool surface for ONE session. `scope` is derived from the
|
|
48
|
+
* session's identity at initialize (see the initialize branch): MEMBER for
|
|
49
|
+
* a valid member JWT or a registered ?member=, FULL otherwise. An
|
|
50
|
+
* implementation that ignores it registers whatever it always did. */
|
|
51
|
+
registerTools: (server: McpServer, scope: ToolScope) => void | Promise<void>;
|
|
14
52
|
preferredPort?: number;
|
|
53
|
+
/** The member access secret file a `?member=` request is checked against
|
|
54
|
+
* (default: <data dir>/member-access.key; created when missing). */
|
|
55
|
+
memberSecretPath?: string;
|
|
56
|
+
}
|
|
57
|
+
/** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
|
|
58
|
+
export declare class PortInUseError extends Error {
|
|
59
|
+
readonly port: number;
|
|
60
|
+
readonly host: string;
|
|
61
|
+
readonly code = "EADDRINUSE";
|
|
62
|
+
constructor(port: number, host: string);
|
|
15
63
|
}
|
|
16
64
|
export interface HttpTransportHandle {
|
|
17
65
|
httpServer: http.Server;
|
|
@@ -6,10 +6,39 @@ import { fleetEvents } from './event-bus.js';
|
|
|
6
6
|
import { getOrCreateKey } from './jwt.js';
|
|
7
7
|
import { getTokenIssuer, localWorkspaceId } from './token-issuer.js';
|
|
8
8
|
import { sessionRegistry } from './session-registry.js';
|
|
9
|
+
import { FULL_TOOL_SCOPE, memberToolScope } from './tool-scope.js';
|
|
9
10
|
import { getAgent, findAgentByName } from './registry.js';
|
|
10
|
-
import {
|
|
11
|
+
import { DEFAULT_HOST, resolveServerPort } from '../paths.js';
|
|
11
12
|
import { serverVersion } from '../version.js';
|
|
12
|
-
import { logLine } from '../utils/log-helpers.js';
|
|
13
|
+
import { logLine, shortSid } from '../utils/log-helpers.js';
|
|
14
|
+
import { recordShutdown } from './server-lifecycle.js';
|
|
15
|
+
import { getOrCreateMemberAccessSecret, memberAccessSecretMatches, memberAccessSecretPath, readMemberAccessSecret, MEMBER_SECRET_HEADER } from './member-access-secret.js';
|
|
16
|
+
/** Why `caller` may not address a session owned by `owner`, or null when it may. */
|
|
17
|
+
export function sessionOwnerMismatch(owner, caller) {
|
|
18
|
+
if (owner.kind === 'jwt') {
|
|
19
|
+
if (caller.kind !== 'jwt')
|
|
20
|
+
return 'session was opened with a member JWT; the caller presented the access secret';
|
|
21
|
+
if (caller.memberId !== owner.memberId || caller.workspaceId !== owner.workspaceId) {
|
|
22
|
+
return 'session was opened by a different member JWT';
|
|
23
|
+
}
|
|
24
|
+
return null;
|
|
25
|
+
}
|
|
26
|
+
if (caller.kind !== 'secret')
|
|
27
|
+
return 'session was opened with the access secret; the caller presented a member JWT';
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
/** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
|
|
31
|
+
export class PortInUseError extends Error {
|
|
32
|
+
port;
|
|
33
|
+
host;
|
|
34
|
+
code = 'EADDRINUSE';
|
|
35
|
+
constructor(port, host) {
|
|
36
|
+
super(`port ${port} on ${host} is already in use`);
|
|
37
|
+
this.port = port;
|
|
38
|
+
this.host = host;
|
|
39
|
+
this.name = 'PortInUseError';
|
|
40
|
+
}
|
|
41
|
+
}
|
|
13
42
|
function parseBody(req) {
|
|
14
43
|
return new Promise((resolve, reject) => {
|
|
15
44
|
const chunks = [];
|
|
@@ -99,6 +128,10 @@ function extractBearer(req) {
|
|
|
99
128
|
export async function createHttpTransport(options) {
|
|
100
129
|
const { registerTools, preferredPort } = options;
|
|
101
130
|
const sessions = new Map();
|
|
131
|
+
// Every install has its member access secret from the first server start
|
|
132
|
+
// (install creates it too): a `?member=` request must present it.
|
|
133
|
+
const memberSecretPath = options.memberSecretPath ?? memberAccessSecretPath();
|
|
134
|
+
getOrCreateMemberAccessSecret(memberSecretPath);
|
|
102
135
|
const startedAt = Date.now();
|
|
103
136
|
// LOW-1: Track event listener references for cleanup in close()
|
|
104
137
|
const eventCleanups = [];
|
|
@@ -115,8 +148,41 @@ export async function createHttpTransport(options) {
|
|
|
115
148
|
res.end('Session not found');
|
|
116
149
|
return;
|
|
117
150
|
}
|
|
151
|
+
if (refuseForeignCaller(req, res, sessionId, session))
|
|
152
|
+
return;
|
|
118
153
|
await session.transport.handleRequest(req, res);
|
|
119
154
|
}
|
|
155
|
+
/** The identity this request carries. Called only past the pre-route gate,
|
|
156
|
+
* so a bearer here has already verified (re-verified to read its claims). */
|
|
157
|
+
function callerIdentity(req) {
|
|
158
|
+
const bearer = extractBearer(req);
|
|
159
|
+
if (bearer !== null) {
|
|
160
|
+
const claims = getTokenIssuer().verify(bearer);
|
|
161
|
+
return claims ? { kind: 'jwt', memberId: claims.member_id, workspaceId: claims.workspace_id } : null;
|
|
162
|
+
}
|
|
163
|
+
const params = new URL(req.url ?? '/', 'http://localhost').searchParams;
|
|
164
|
+
return {
|
|
165
|
+
kind: 'secret',
|
|
166
|
+
member: params.get('member'),
|
|
167
|
+
engineOrigin: params.get('origin') === 'engine',
|
|
168
|
+
kbMaintainer: params.get('kb_maintainer') === '1',
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
/** 403 (and true) when the caller is not the identity that opened `session`;
|
|
172
|
+
* the session is left untouched and no session detail is returned. */
|
|
173
|
+
function refuseForeignCaller(req, res, sessionId, session) {
|
|
174
|
+
const caller = callerIdentity(req);
|
|
175
|
+
const why = caller ? sessionOwnerMismatch(session.owner, caller) : 'caller identity could not be verified';
|
|
176
|
+
if (why === null)
|
|
177
|
+
return false;
|
|
178
|
+
logLine('session', `rejected ${req.method} on sid=${shortSid(sessionId)}: caller=${caller?.kind ?? 'unverified'} owner=${session.owner.kind} (${why})`);
|
|
179
|
+
res.writeHead(403, { 'Content-Type': 'application/json' });
|
|
180
|
+
res.end(JSON.stringify({
|
|
181
|
+
error: 'session identity mismatch',
|
|
182
|
+
detail: `This MCP session belongs to a different caller identity (${why}). A session can be used only with the credential that opened it; open a new session instead.`,
|
|
183
|
+
}));
|
|
184
|
+
return true;
|
|
185
|
+
}
|
|
120
186
|
const httpServer = http.createServer(async (req, res) => {
|
|
121
187
|
const url = req.url ?? '/';
|
|
122
188
|
if (url === '/health' && req.method === 'GET') {
|
|
@@ -144,6 +210,8 @@ export async function createHttpTransport(options) {
|
|
|
144
210
|
return;
|
|
145
211
|
}
|
|
146
212
|
const body = JSON.stringify({ status: 'shutting-down' });
|
|
213
|
+
// GitHub #585: name the real cause before re-entering the SIGINT path.
|
|
214
|
+
recordShutdown('http_shutdown');
|
|
147
215
|
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
148
216
|
res.end(body);
|
|
149
217
|
setTimeout(() => {
|
|
@@ -156,11 +224,59 @@ export async function createHttpTransport(options) {
|
|
|
156
224
|
res.end();
|
|
157
225
|
return;
|
|
158
226
|
}
|
|
227
|
+
// Every /mcp request without a member JWT must present this install's
|
|
228
|
+
// member access secret (an owner-only file in its data dir). The server
|
|
229
|
+
// binds loopback, where every local user can connect; the secret is what
|
|
230
|
+
// keeps another user's session -- or one configured for another install --
|
|
231
|
+
// out. That covers the ?member= route (a session acting as that member)
|
|
232
|
+
// AND the no-member route (a FULL-scope session, which includes command
|
|
233
|
+
// execution on this install's local members). Read per request so a
|
|
234
|
+
// replaced secret takes effect at once; a missing one refuses (never fails
|
|
235
|
+
// open). A member JWT (Authorization: Bearer) is its own credential, but
|
|
236
|
+
// only a VERIFIED one replaces the secret: any bearer that fails JWT
|
|
237
|
+
// verification is refused here for every method, so `Bearer x` cannot
|
|
238
|
+
// carry a GET (SSE stream) or DELETE (session teardown) past this gate.
|
|
239
|
+
{
|
|
240
|
+
const memberRouteParam = new URL(url, 'http://localhost').searchParams.get('member');
|
|
241
|
+
const gateBearer = extractBearer(req);
|
|
242
|
+
if (gateBearer !== null) {
|
|
243
|
+
if (!getTokenIssuer().verify(gateBearer)) {
|
|
244
|
+
logLine('session', `rejected ${req.method}: jwt verify failed member_param=${memberRouteParam ?? 'none'}`);
|
|
245
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
246
|
+
res.end(JSON.stringify({ error: 'invalid token' }));
|
|
247
|
+
return;
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
else {
|
|
251
|
+
const expected = readMemberAccessSecret(memberSecretPath);
|
|
252
|
+
if (!memberAccessSecretMatches(req.headers[MEMBER_SECRET_HEADER.toLowerCase()], expected)) {
|
|
253
|
+
const why = req.headers[MEMBER_SECRET_HEADER.toLowerCase()] === undefined ? 'missing' : 'wrong';
|
|
254
|
+
const route = memberRouteParam !== null ? 'member route' : 'full-scope route';
|
|
255
|
+
logLine('session', `rejected ${req.method} on ${route}: access secret ${why} member_param=${memberRouteParam ?? 'none'}`);
|
|
256
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
257
|
+
res.end(JSON.stringify({
|
|
258
|
+
error: memberRouteParam !== null ? 'member secret required' : 'access secret required',
|
|
259
|
+
detail: `An /mcp session must present this apra-fleet install's access secret in the ${MEMBER_SECRET_HEADER} header (the secret was ${why}). It is in member-access.key in the install's data dir, readable only by the install's user; a session configured for another install or another user is refused. Re-run 'apra-fleet install' to rewrite this machine's user-scope MCP registration (a project-scope .mcp.json cannot carry the secret: remove its apra-fleet URL entry or add the header from member-access.key in a git-ignored local config)${memberRouteParam !== null ? ', or compose_permissions / update_member with fleet_install "auto" to rewrite the member MCP config' : ''}.`,
|
|
260
|
+
}));
|
|
261
|
+
return;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
}
|
|
159
265
|
if (req.method === 'POST') {
|
|
160
266
|
// JWT auth: verify Bearer token if present; unauthenticated (PM/tool) connections pass through
|
|
161
267
|
const rawToken = extractBearer(req);
|
|
162
268
|
const parsedUrl = new URL(req.url ?? '/', 'http://localhost');
|
|
163
269
|
const memberParam = parsedUrl.searchParams.get('member');
|
|
270
|
+
// origin=engine: set ONLY by the engine's own member-session paths
|
|
271
|
+
// (client connectFleetMember with { origin: 'engine' }, used by memberCall
|
|
272
|
+
// and the `apra-fleet call` verb). Recorded on the session's tool scope so
|
|
273
|
+
// its kb_/code_ calls are not counted against the member.
|
|
274
|
+
const engineOrigin = parsedUrl.searchParams.get('origin') === 'engine';
|
|
275
|
+
// kb_maintainer=1: the engine's kb_maintainer grant (client
|
|
276
|
+
// connectFleetMember with { origin: 'engine', kbMaintainer: true }, used
|
|
277
|
+
// by memberCall for the member it chose as a repository's kb_maintainer).
|
|
278
|
+
// Honoured only with origin=engine; see memberToolScope.
|
|
279
|
+
const kbMaintainerParam = parsedUrl.searchParams.get('kb_maintainer') === '1';
|
|
164
280
|
let postClaims = null;
|
|
165
281
|
if (rawToken !== null) {
|
|
166
282
|
postClaims = getTokenIssuer().verify(rawToken);
|
|
@@ -184,7 +300,10 @@ export async function createHttpTransport(options) {
|
|
|
184
300
|
return;
|
|
185
301
|
}
|
|
186
302
|
if (isInitializeRequest(parsedBody)) {
|
|
187
|
-
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'}`);
|
|
303
|
+
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'} engine_origin=${engineOrigin} kb_maintainer=${kbMaintainerParam}`);
|
|
304
|
+
if (kbMaintainerParam && !engineOrigin) {
|
|
305
|
+
logLine('session', 'kb_maintainer=1 without origin=engine ignored: the grant is engine-only');
|
|
306
|
+
}
|
|
188
307
|
const body = parsedBody;
|
|
189
308
|
const clientInfo = body?.params?.clientInfo ?? {};
|
|
190
309
|
const clientCaps = body?.params?.capabilities ?? {};
|
|
@@ -204,13 +323,23 @@ export async function createHttpTransport(options) {
|
|
|
204
323
|
// (unauthenticated local fallback) historically carried the friendly
|
|
205
324
|
// name; new URLs carry the UUID, and legacy friendly names are resolved
|
|
206
325
|
// to the UUID via the agent registry here.
|
|
326
|
+
//
|
|
327
|
+
// The param must name a REGISTERED member: an id that resolves through
|
|
328
|
+
// neither getAgent nor findAgentByName is refused with 403 rather than
|
|
329
|
+
// conjuring a member identity (and a member session) from a raw string.
|
|
207
330
|
let fallbackMemberId = null;
|
|
208
331
|
let fallbackWorkFolder = '';
|
|
209
332
|
if (postClaims === null && memberParam !== null) {
|
|
210
333
|
const agent = getAgent(memberParam) ?? findAgentByName(memberParam);
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
334
|
+
if (!agent) {
|
|
335
|
+
logLine('session', `rejected initialize: unknown member_param=${memberParam}`);
|
|
336
|
+
res.writeHead(403, { 'Content-Type': 'application/json' });
|
|
337
|
+
res.end(JSON.stringify({ error: 'unknown member' }));
|
|
338
|
+
return;
|
|
339
|
+
}
|
|
340
|
+
fallbackMemberId = agent.id;
|
|
341
|
+
fallbackWorkFolder = agent.workFolder ?? '';
|
|
342
|
+
if (agent.id !== memberParam) {
|
|
214
343
|
logLine('session', `resolved URL member param '${memberParam}' to member_id=${agent.id}`);
|
|
215
344
|
}
|
|
216
345
|
}
|
|
@@ -218,13 +347,26 @@ export async function createHttpTransport(options) {
|
|
|
218
347
|
// from this machine (server binds 127.0.0.1), so they belong to the
|
|
219
348
|
// local workspace. Authenticated sessions use the JWT's workspace_id.
|
|
220
349
|
const sessionWorkspaceId = postClaims?.workspace_id ?? localWorkspaceId();
|
|
350
|
+
// Tool scope from the identity resolved above. A valid member JWT (a
|
|
351
|
+
// doer subprocess connect-back or an interactive member) or a
|
|
352
|
+
// registered ?member= makes this a MEMBER session: the base member
|
|
353
|
+
// allowlist, plus the channel tools (respond_to_message) only when the
|
|
354
|
+
// client declared claude/channel. No member identity at all is the
|
|
355
|
+
// local orchestrator/PM/tool session and keeps the FULL set.
|
|
356
|
+
const sessionMemberId = postClaims?.member_id ?? fallbackMemberId;
|
|
357
|
+
const toolScope = sessionMemberId
|
|
358
|
+
? memberToolScope(sessionMemberId, channelCapable, engineOrigin, kbMaintainerParam)
|
|
359
|
+
: FULL_TOOL_SCOPE;
|
|
360
|
+
const sessionOwner = postClaims
|
|
361
|
+
? { kind: 'jwt', memberId: postClaims.member_id, workspaceId: postClaims.workspace_id }
|
|
362
|
+
: { kind: 'secret', member: fallbackMemberId, engineOrigin, kbMaintainer: kbMaintainerParam };
|
|
221
363
|
const sessionServer = new McpServer({ name: `apra fleet server ${serverVersion}`, version: serverVersion }, { capabilities: { logging: {}, experimental: { 'claude/channel': {} } } });
|
|
222
364
|
const sessionTransport = new StreamableHTTPServerTransport({
|
|
223
365
|
sessionIdGenerator: () => crypto.randomUUID(),
|
|
224
366
|
onsessioninitialized: (sid) => {
|
|
225
|
-
sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId });
|
|
367
|
+
sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId, owner: sessionOwner });
|
|
226
368
|
const hasMember = !!(postClaims || fallbackMemberId);
|
|
227
|
-
logLine('session', `new sid=${sid} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember}`);
|
|
369
|
+
logLine('session', `new sid=${shortSid(sid)} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember} scope=${toolScope.kind}`);
|
|
228
370
|
// Register interactive member session when JWT claims are present.
|
|
229
371
|
//
|
|
230
372
|
// apra-fleet-eft.28.5: carry forward the launch-time pid captured
|
|
@@ -253,13 +395,28 @@ export async function createHttpTransport(options) {
|
|
|
253
395
|
pid: postClaims.pid ?? priorPid,
|
|
254
396
|
channelCapable,
|
|
255
397
|
});
|
|
256
|
-
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${sid} channelCapable=${channelCapable}`);
|
|
398
|
+
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${shortSid(sid)} channelCapable=${channelCapable}`);
|
|
257
399
|
}
|
|
258
400
|
else if (fallbackMemberId) {
|
|
259
401
|
// apra-fleet-eft.50.1: same durable launch-pid fallback as the
|
|
260
402
|
// JWT branch above, so a URL-param reconnect on a retry keeps a
|
|
261
403
|
// pid for the interactive liveness check to test.
|
|
262
|
-
|
|
404
|
+
if (!channelCapable) {
|
|
405
|
+
// A tool-only member session (apra-fleet call, memberCall, a
|
|
406
|
+
// non-interactive agent's per-folder MCP entry) never touches
|
|
407
|
+
// the session registry. The registry entry is the member's
|
|
408
|
+
// interactive routing target: send_message pushes channel
|
|
409
|
+
// notifications to its server, and execute_prompt reads its
|
|
410
|
+
// launch-time pid. Registering here would replace a launch
|
|
411
|
+
// placeholder (server:null, pid set) or a missing entry with a
|
|
412
|
+
// session that cannot receive those pushes; onsessionclosed
|
|
413
|
+
// skips it for the same reason.
|
|
414
|
+
const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
415
|
+
logLine('session', `tool-only member session member_id=${fallbackMemberId} sid=${shortSid(sid)} not registered (registry entry ${existing ? 'sid=' + shortSid(existing.sessionId) : 'absent'} left as is)`);
|
|
416
|
+
return;
|
|
417
|
+
}
|
|
418
|
+
const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
419
|
+
const priorPid = existing?.pid
|
|
263
420
|
?? sessionRegistry.lastKnownPid(sessionWorkspaceId, fallbackMemberId);
|
|
264
421
|
sessionRegistry.register({
|
|
265
422
|
member_id: fallbackMemberId,
|
|
@@ -272,11 +429,11 @@ export async function createHttpTransport(options) {
|
|
|
272
429
|
pid: priorPid,
|
|
273
430
|
channelCapable,
|
|
274
431
|
});
|
|
275
|
-
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${sid} channelCapable=${channelCapable}`);
|
|
432
|
+
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${shortSid(sid)} channelCapable=${channelCapable}`);
|
|
276
433
|
}
|
|
277
434
|
},
|
|
278
435
|
onsessionclosed: (sid) => {
|
|
279
|
-
logLine('session', `closed sid=${sid}`);
|
|
436
|
+
logLine('session', `closed sid=${shortSid(sid)}`);
|
|
280
437
|
// LOW-2: Close the McpServer when its session closes
|
|
281
438
|
const s = sessions.get(sid);
|
|
282
439
|
if (s) {
|
|
@@ -292,25 +449,27 @@ export async function createHttpTransport(options) {
|
|
|
292
449
|
const current = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id);
|
|
293
450
|
if (current?.sessionId === sid) {
|
|
294
451
|
sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
|
|
295
|
-
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${sid}`);
|
|
452
|
+
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${shortSid(sid)}`);
|
|
296
453
|
}
|
|
297
454
|
else {
|
|
298
|
-
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${sid} (superseded by sid=${current?.sessionId
|
|
455
|
+
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
|
|
299
456
|
}
|
|
300
457
|
}
|
|
301
|
-
else if (fallbackMemberId) {
|
|
458
|
+
else if (fallbackMemberId && channelCapable) {
|
|
459
|
+
// A tool-only ?member= session never registered (see
|
|
460
|
+
// onsessioninitialized), so it never unregisters either.
|
|
302
461
|
const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
303
462
|
if (current?.sessionId === sid) {
|
|
304
463
|
sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
|
|
305
|
-
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${sid}`);
|
|
464
|
+
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${shortSid(sid)}`);
|
|
306
465
|
}
|
|
307
466
|
else {
|
|
308
|
-
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${sid} (superseded by sid=${current?.sessionId
|
|
467
|
+
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
|
|
309
468
|
}
|
|
310
469
|
}
|
|
311
470
|
},
|
|
312
471
|
});
|
|
313
|
-
await registerTools(sessionServer);
|
|
472
|
+
await registerTools(sessionServer, toolScope);
|
|
314
473
|
await sessionServer.connect(sessionTransport);
|
|
315
474
|
await sessionTransport.handleRequest(req, res, parsedBody);
|
|
316
475
|
return;
|
|
@@ -327,6 +486,8 @@ export async function createHttpTransport(options) {
|
|
|
327
486
|
res.end('Session not found');
|
|
328
487
|
return;
|
|
329
488
|
}
|
|
489
|
+
if (refuseForeignCaller(req, res, sessionId, session))
|
|
490
|
+
return;
|
|
330
491
|
await session.transport.handleRequest(req, res, parsedBody);
|
|
331
492
|
return;
|
|
332
493
|
}
|
|
@@ -366,28 +527,33 @@ export async function createHttpTransport(options) {
|
|
|
366
527
|
// LOW-1: Store cleanup so close() can unsubscribe
|
|
367
528
|
eventCleanups.push(() => fleetEvents.off(eventType, handler));
|
|
368
529
|
}
|
|
369
|
-
// Start listening
|
|
530
|
+
// Start listening on the preferred port (no fallback, see below).
|
|
370
531
|
// Bind host is configurable (APRA_FLEET_HOST, default 127.0.0.1) --
|
|
371
532
|
// apra-fleet-fnz.4/us9.6. Binding beyond loopback is an explicit,
|
|
372
533
|
// logged opt-in: several unauthenticated code paths in this file (the
|
|
373
534
|
// ?member= URL-param fallback, /shutdown's admin-key check) were
|
|
374
535
|
// written assuming only same-machine callers can reach this server.
|
|
375
|
-
const targetPort = preferredPort ??
|
|
536
|
+
const targetPort = preferredPort ?? resolveServerPort();
|
|
376
537
|
const bindHost = DEFAULT_HOST;
|
|
377
538
|
if (bindHost !== '127.0.0.1') {
|
|
378
539
|
logLine('session', `WARNING: binding to ${bindHost} (not loopback-only) -- unauthenticated requests (the ?member= URL-param fallback, /shutdown) are now reachable from any host that can route to this address, not just this machine. Set APRA_FLEET_HOST=127.0.0.1 (or unset it) to restore the loopback-only default.`);
|
|
379
540
|
}
|
|
541
|
+
// A busy configured port is a hard error (GitHub #584): there is no
|
|
542
|
+
// fallback to an OS-assigned port, because every configured MCP client only
|
|
543
|
+
// knows the configured port -- a silently re-homed server is unreachable and
|
|
544
|
+
// splits the fleet in two on one data dir. An explicit port 0 (callers that
|
|
545
|
+
// ask for an ephemeral port) is unaffected.
|
|
380
546
|
let port;
|
|
381
547
|
try {
|
|
382
548
|
port = await listenOnPort(httpServer, targetPort, bindHost);
|
|
383
549
|
}
|
|
384
550
|
catch (err) {
|
|
551
|
+
for (const cleanup of eventCleanups)
|
|
552
|
+
cleanup();
|
|
385
553
|
if (err.code === 'EADDRINUSE') {
|
|
386
|
-
|
|
387
|
-
}
|
|
388
|
-
else {
|
|
389
|
-
throw err;
|
|
554
|
+
throw new PortInUseError(targetPort, bindHost);
|
|
390
555
|
}
|
|
556
|
+
throw err;
|
|
391
557
|
}
|
|
392
558
|
// Same-machine callers (register_member's own local MCP connection) always
|
|
393
559
|
// use loopback -- valid regardless of bindHost, since binding to 0.0.0.0
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { FileHashResult } from './file-hash.js';
|
|
2
|
+
/**
|
|
3
|
+
* A cited/basis path must stay inside the exported repo: relative, with no
|
|
4
|
+
* '..' segment and no POSIX, drive-letter or UNC root. Anything else is never
|
|
5
|
+
* hashed and never qualifies (the bible only describes this tree).
|
|
6
|
+
*/
|
|
7
|
+
export declare function isRepoRelativePath(file: string): boolean;
|
|
8
|
+
/** The minimal entry shape the predicate reads. */
|
|
9
|
+
export interface BibleCandidate {
|
|
10
|
+
id: string;
|
|
11
|
+
confidence: string;
|
|
12
|
+
source_files: string[];
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* True when an entry qualifies for the project bible:
|
|
16
|
+
* - confidence is CONFIRMED (callers already exclude superseded/stale rows);
|
|
17
|
+
* - it cites at least one source file;
|
|
18
|
+
* - its stored basis is non-empty (null/empty/unparseable basis never matches);
|
|
19
|
+
* - every cited source file has a key in the basis;
|
|
20
|
+
* - every cited and basis path is repo-relative (isRepoRelativePath);
|
|
21
|
+
* - every basis hash equals that file's current hash (a missing file -- a
|
|
22
|
+
* null/absent current hash -- is a mismatch).
|
|
23
|
+
* Same comparison semantics as SqliteProvider.basisFullyMatches, plus the
|
|
24
|
+
* source_files coverage check.
|
|
25
|
+
*/
|
|
26
|
+
export declare function qualifiesForProjectBible(entry: BibleCandidate, basis: Record<string, string> | null | undefined, currentHashes: Record<string, Pick<FileHashResult, 'hash'> | null | undefined>): boolean;
|
|
27
|
+
/**
|
|
28
|
+
* Hash every basis file once (one batch, content at repoPath's HEAD commit)
|
|
29
|
+
* and return the entries that pass qualifiesForProjectBible, preserving input
|
|
30
|
+
* order. Throws KbHeadHashError when repoPath is not inside a git work tree.
|
|
31
|
+
*/
|
|
32
|
+
export declare function filterProjectBibleCandidates<T extends BibleCandidate>(entries: T[], basisById: Map<string, Record<string, string> | null>, repoPath: string): Promise<T[]>;
|
|
33
|
+
/** The minimal bible-entry shape the legacy backfill reads. */
|
|
34
|
+
export interface BibleFileEntry {
|
|
35
|
+
id: string;
|
|
36
|
+
source_files: string[];
|
|
37
|
+
source_file_hashes?: Record<string, string>;
|
|
38
|
+
}
|
|
39
|
+
/** True when a bible entry carries a non-empty source_file_hashes map. */
|
|
40
|
+
export declare function hasCarriedBasis(entry: BibleFileEntry): boolean;
|
|
41
|
+
/**
|
|
42
|
+
* The bible entries that gain a basis: for each entry in `bibleEntries` with
|
|
43
|
+
* no carried source_file_hashes whose id is in `kbEntries` (the writer KB's
|
|
44
|
+
* live entries) with the same source_files set and a stored basis passing
|
|
45
|
+
* qualifiesForProjectBible at repoPath's HEAD, the id mapped to that stored
|
|
46
|
+
* basis. Entries that do not qualify are simply absent from the result (the
|
|
47
|
+
* caller keeps them unchanged; nothing is ever dropped). Hashes the candidate
|
|
48
|
+
* basis files once; with no candidate nothing is hashed (so no git check).
|
|
49
|
+
* Throws KbHeadHashError when there are candidates and repoPath is not inside
|
|
50
|
+
* a git work tree.
|
|
51
|
+
*/
|
|
52
|
+
export declare function selectLegacyBibleBackfill<K extends BibleCandidate>(bibleEntries: BibleFileEntry[], kbEntries: K[], basisById: Map<string, Record<string, string> | null>, repoPath: string): Promise<Map<string, Record<string, string>>>;
|
|
53
|
+
//# sourceMappingURL=bible-basis-filter.d.ts.map
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import path from 'node:path';
|
|
2
|
+
import { computeHeadFileHashBatch } from './file-hash.js';
|
|
3
|
+
/**
|
|
4
|
+
* A cited/basis path must stay inside the exported repo: relative, with no
|
|
5
|
+
* '..' segment and no POSIX, drive-letter or UNC root. Anything else is never
|
|
6
|
+
* hashed and never qualifies (the bible only describes this tree).
|
|
7
|
+
*/
|
|
8
|
+
export function isRepoRelativePath(file) {
|
|
9
|
+
if (typeof file !== 'string' || file.length === 0)
|
|
10
|
+
return false;
|
|
11
|
+
if (path.posix.isAbsolute(file) || path.win32.isAbsolute(file) || /^[A-Za-z]:/.test(file))
|
|
12
|
+
return false;
|
|
13
|
+
return !file.split(/[\\/]+/).includes('..');
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* True when an entry qualifies for the project bible:
|
|
17
|
+
* - confidence is CONFIRMED (callers already exclude superseded/stale rows);
|
|
18
|
+
* - it cites at least one source file;
|
|
19
|
+
* - its stored basis is non-empty (null/empty/unparseable basis never matches);
|
|
20
|
+
* - every cited source file has a key in the basis;
|
|
21
|
+
* - every cited and basis path is repo-relative (isRepoRelativePath);
|
|
22
|
+
* - every basis hash equals that file's current hash (a missing file -- a
|
|
23
|
+
* null/absent current hash -- is a mismatch).
|
|
24
|
+
* Same comparison semantics as SqliteProvider.basisFullyMatches, plus the
|
|
25
|
+
* source_files coverage check.
|
|
26
|
+
*/
|
|
27
|
+
export function qualifiesForProjectBible(entry, basis, currentHashes) {
|
|
28
|
+
if (entry.confidence !== 'CONFIRMED')
|
|
29
|
+
return false;
|
|
30
|
+
if (!Array.isArray(entry.source_files) || entry.source_files.length === 0)
|
|
31
|
+
return false;
|
|
32
|
+
if (!basis || typeof basis !== 'object')
|
|
33
|
+
return false;
|
|
34
|
+
const basisFiles = Object.keys(basis);
|
|
35
|
+
if (basisFiles.length === 0)
|
|
36
|
+
return false;
|
|
37
|
+
for (const file of entry.source_files) {
|
|
38
|
+
if (!isRepoRelativePath(file))
|
|
39
|
+
return false;
|
|
40
|
+
if (!Object.prototype.hasOwnProperty.call(basis, file))
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
for (const file of basisFiles) {
|
|
44
|
+
if (!isRepoRelativePath(file))
|
|
45
|
+
return false;
|
|
46
|
+
const current = currentHashes[file];
|
|
47
|
+
if (!current || typeof basis[file] !== 'string' || current.hash !== basis[file])
|
|
48
|
+
return false;
|
|
49
|
+
}
|
|
50
|
+
return true;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Hash every basis file once (one batch, content at repoPath's HEAD commit)
|
|
54
|
+
* and return the entries that pass qualifiesForProjectBible, preserving input
|
|
55
|
+
* order. Throws KbHeadHashError when repoPath is not inside a git work tree.
|
|
56
|
+
*/
|
|
57
|
+
export async function filterProjectBibleCandidates(entries, basisById, repoPath) {
|
|
58
|
+
const fileSet = new Set();
|
|
59
|
+
for (const e of entries) {
|
|
60
|
+
const basis = basisById.get(e.id);
|
|
61
|
+
if (basis)
|
|
62
|
+
for (const f of Object.keys(basis))
|
|
63
|
+
if (isRepoRelativePath(f))
|
|
64
|
+
fileSet.add(f);
|
|
65
|
+
}
|
|
66
|
+
if (entries.length === 0)
|
|
67
|
+
return [];
|
|
68
|
+
const currentHashes = await computeHeadFileHashBatch([...fileSet], { cwd: repoPath });
|
|
69
|
+
return entries.filter(e => qualifiesForProjectBible(e, basisById.get(e.id), currentHashes));
|
|
70
|
+
}
|
|
71
|
+
/** True when a bible entry carries a non-empty source_file_hashes map. */
|
|
72
|
+
export function hasCarriedBasis(entry) {
|
|
73
|
+
const h = entry.source_file_hashes;
|
|
74
|
+
return !!h && typeof h === 'object' && !Array.isArray(h) && Object.keys(h).length > 0;
|
|
75
|
+
}
|
|
76
|
+
function sameFileSet(a, b) {
|
|
77
|
+
if (!Array.isArray(a) || !Array.isArray(b))
|
|
78
|
+
return false;
|
|
79
|
+
const sa = new Set(a);
|
|
80
|
+
const sb = new Set(b);
|
|
81
|
+
if (sa.size !== sb.size)
|
|
82
|
+
return false;
|
|
83
|
+
for (const f of sa)
|
|
84
|
+
if (!sb.has(f))
|
|
85
|
+
return false;
|
|
86
|
+
return true;
|
|
87
|
+
}
|
|
88
|
+
// Legacy-bible backfill (kb_bible_commit).
|
|
89
|
+
//
|
|
90
|
+
// A bible entry written before format v3 carries no source_file_hashes, so a
|
|
91
|
+
// clone importing it can only give it a local freshness-only basis and it is
|
|
92
|
+
// never re-published. When the bible writer's own KB holds the SAME id with a
|
|
93
|
+
// stored, verified basis, that basis can be attached to the bible entry. The
|
|
94
|
+
// rule is the admission predicate itself (qualifiesForProjectBible, cited files
|
|
95
|
+
// read at HEAD): nothing is re-hashed into the basis and no second rule is
|
|
96
|
+
// invented. One extra guard: the KB entry must cite exactly the bible entry's
|
|
97
|
+
// source_files, so the attached basis describes the files the bible entry
|
|
98
|
+
// cites and nothing else. A local freshness-only basis (from kb_import) reads
|
|
99
|
+
// as no basis (SqliteProvider.getSourceFileBases), so it never backfills.
|
|
100
|
+
/**
|
|
101
|
+
* The bible entries that gain a basis: for each entry in `bibleEntries` with
|
|
102
|
+
* no carried source_file_hashes whose id is in `kbEntries` (the writer KB's
|
|
103
|
+
* live entries) with the same source_files set and a stored basis passing
|
|
104
|
+
* qualifiesForProjectBible at repoPath's HEAD, the id mapped to that stored
|
|
105
|
+
* basis. Entries that do not qualify are simply absent from the result (the
|
|
106
|
+
* caller keeps them unchanged; nothing is ever dropped). Hashes the candidate
|
|
107
|
+
* basis files once; with no candidate nothing is hashed (so no git check).
|
|
108
|
+
* Throws KbHeadHashError when there are candidates and repoPath is not inside
|
|
109
|
+
* a git work tree.
|
|
110
|
+
*/
|
|
111
|
+
export async function selectLegacyBibleBackfill(bibleEntries, kbEntries, basisById, repoPath) {
|
|
112
|
+
const kbById = new Map();
|
|
113
|
+
for (const e of kbEntries)
|
|
114
|
+
kbById.set(e.id, e);
|
|
115
|
+
const candidates = [];
|
|
116
|
+
for (const b of bibleEntries) {
|
|
117
|
+
if (hasCarriedBasis(b))
|
|
118
|
+
continue;
|
|
119
|
+
const kb = kbById.get(b.id);
|
|
120
|
+
if (!kb || !basisById.get(b.id))
|
|
121
|
+
continue;
|
|
122
|
+
if (!sameFileSet(kb.source_files, b.source_files))
|
|
123
|
+
continue;
|
|
124
|
+
candidates.push({ id: b.id, confidence: kb.confidence, source_files: b.source_files });
|
|
125
|
+
}
|
|
126
|
+
const out = new Map();
|
|
127
|
+
if (candidates.length === 0)
|
|
128
|
+
return out;
|
|
129
|
+
const passing = await filterProjectBibleCandidates(candidates, basisById, repoPath);
|
|
130
|
+
for (const c of passing)
|
|
131
|
+
out.set(c.id, basisById.get(c.id));
|
|
132
|
+
return out;
|
|
133
|
+
}
|
|
134
|
+
//# sourceMappingURL=bible-basis-filter.js.map
|