@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,77 @@
|
|
|
1
|
+
export declare const REPOSITORY_HEADER = "X-Repository";
|
|
2
|
+
export declare const REPOSITORY_COMMIT_HEADER = "X-Repository-Commit";
|
|
3
|
+
export declare const REPOSITORY_BRANCH_HEADER = "X-Repository-Branch";
|
|
4
|
+
/** Longest X-Repository-Branch value (after percent-encoding) that is sent. */
|
|
5
|
+
export declare const MAX_BRANCH_LENGTH = 255;
|
|
6
|
+
/** Longest X-Repository value a receiving server accepts. */
|
|
7
|
+
export declare const MAX_REPOSITORY_LENGTH = 512;
|
|
8
|
+
/** The repository a provider sends with every request. */
|
|
9
|
+
export interface RepositoryIdentity {
|
|
10
|
+
/** Normalised origin remote, `host/path` (see normaliseRepositoryRemote). */
|
|
11
|
+
remote: string;
|
|
12
|
+
/** HEAD sha of the local folder; undefined when unknown. Must not throw. */
|
|
13
|
+
commitOf?: () => string | undefined;
|
|
14
|
+
/**
|
|
15
|
+
* Checked-out branch of the local folder, percent-encoded; undefined when
|
|
16
|
+
* unknown or HEAD is detached. Must not throw.
|
|
17
|
+
*/
|
|
18
|
+
branchOf?: () => string | undefined;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Normalise a git remote URL to `host/path`: no scheme, no user info or
|
|
22
|
+
* credentials, no port, no query or fragment, no trailing `.git` or `/`. The
|
|
23
|
+
* host is lowercased; the path keeps its case. ssh forms (`git@host:org/repo`,
|
|
24
|
+
* `ssh://git@host/org/repo`) map to the same value as https. Azure DevOps
|
|
25
|
+
* spellings fold to `dev.azure.com/<org>/<project>/_git/<repo>` (org
|
|
26
|
+
* lowercased), as the receiving server canonicalises them. Characters outside
|
|
27
|
+
* printable ASCII (space, non-ASCII) are percent-encoded.
|
|
28
|
+
*
|
|
29
|
+
* Returns undefined for anything that is not a network remote (a local path, a
|
|
30
|
+
* file:// URL) or that would not be a valid header value.
|
|
31
|
+
*/
|
|
32
|
+
export declare function normaliseRepositoryRemote(remoteUrl: string): string | undefined;
|
|
33
|
+
/**
|
|
34
|
+
* True when `value` is a header value a receiving server accepts: at most 512
|
|
35
|
+
* printable ASCII characters, no spaces, no scheme, no '@' before the first '/'.
|
|
36
|
+
*/
|
|
37
|
+
export declare function isValidRepositoryValue(value: string): boolean;
|
|
38
|
+
/** A full SHA-1 or SHA-256 commit id, lowercase. */
|
|
39
|
+
export declare const COMMIT_SHA: RegExp;
|
|
40
|
+
/** How long a read HEAD sha is reused before git is asked again. */
|
|
41
|
+
export declare const HEAD_COMMIT_TTL_MS = 5000;
|
|
42
|
+
/**
|
|
43
|
+
* A reader for the HEAD sha of a local folder, cached for `ttlMs` so it is not
|
|
44
|
+
* re-read on every request. Returns undefined (never throws) when the folder
|
|
45
|
+
* is not a git repository or HEAD cannot be resolved (unborn branch).
|
|
46
|
+
*/
|
|
47
|
+
export declare function headCommitReader(folder: string, ttlMs?: number): () => string | undefined;
|
|
48
|
+
/**
|
|
49
|
+
* True when `value` is an X-Repository-Branch value that may be sent: 1-255
|
|
50
|
+
* printable ASCII characters, no spaces.
|
|
51
|
+
*/
|
|
52
|
+
export declare function isValidBranchValue(value: string): boolean;
|
|
53
|
+
/**
|
|
54
|
+
* The header value for a branch name: characters outside printable ASCII
|
|
55
|
+
* (non-ASCII, control, space) percent-encoded as UTF-8. Undefined when the
|
|
56
|
+
* result is empty or longer than MAX_BRANCH_LENGTH.
|
|
57
|
+
*/
|
|
58
|
+
export declare function branchHeaderValue(branch: string): string | undefined;
|
|
59
|
+
/**
|
|
60
|
+
* A reader for the checked-out branch of a local folder (`git symbolic-ref
|
|
61
|
+
* --quiet HEAD`, with `refs/heads/` stripped), cached for `ttlMs` like
|
|
62
|
+
* headCommitReader so a branch switch shows within one TTL. `--short` is not
|
|
63
|
+
* used: it prints `heads/x` when a tag `x` also exists. Returns the header value
|
|
64
|
+
* (see branchHeaderValue), or undefined (never throws) on a detached HEAD, a HEAD
|
|
65
|
+
* not under refs/heads/, a folder that is not a git repository, a git failure or
|
|
66
|
+
* timeout, or an invalid value.
|
|
67
|
+
*/
|
|
68
|
+
export declare function headBranchReader(folder: string, ttlMs?: number): () => string | undefined;
|
|
69
|
+
/**
|
|
70
|
+
* The repository identity for a resolved KB anchor, or undefined when there is
|
|
71
|
+
* none. `remoteUrl` is set only when the folder lives on another host: then
|
|
72
|
+
* the identity is that remote and the commit and branch are unknown (git
|
|
73
|
+
* cannot run there). Otherwise the identity is the local folder's origin
|
|
74
|
+
* remote, the commit is its HEAD and the branch its checked-out branch.
|
|
75
|
+
*/
|
|
76
|
+
export declare function resolveRepositoryIdentity(folder: string, remoteUrl?: string): RepositoryIdentity | undefined;
|
|
77
|
+
//# sourceMappingURL=repository-header.d.ts.map
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
// The repository a remote KB request is about, as the HTTP provider sends it.
|
|
2
|
+
//
|
|
3
|
+
// kb_* tools take no repository argument: fleet resolves the repository from
|
|
4
|
+
// the calling session (kb-self.ts). HttpKbProvider forwards that resolved
|
|
5
|
+
// repository to a shared remote KB server as two headers, so the server can
|
|
6
|
+
// keep repositories apart:
|
|
7
|
+
//
|
|
8
|
+
// X-Repository the normalised origin remote, `host/path`
|
|
9
|
+
// X-Repository-Commit the HEAD sha of the local folder, when readable
|
|
10
|
+
// X-Repository-Branch the checked-out branch of the local folder, when on
|
|
11
|
+
// one (not detached), percent-encoded
|
|
12
|
+
//
|
|
13
|
+
// All values come ONLY from fleet's resolved anchor, never from tool input.
|
|
14
|
+
import { execFileSync } from 'node:child_process';
|
|
15
|
+
import path from 'node:path';
|
|
16
|
+
import { gitExecutable } from '../../os/git-executable.js';
|
|
17
|
+
export const REPOSITORY_HEADER = 'X-Repository';
|
|
18
|
+
export const REPOSITORY_COMMIT_HEADER = 'X-Repository-Commit';
|
|
19
|
+
export const REPOSITORY_BRANCH_HEADER = 'X-Repository-Branch';
|
|
20
|
+
/** Longest X-Repository-Branch value (after percent-encoding) that is sent. */
|
|
21
|
+
export const MAX_BRANCH_LENGTH = 255;
|
|
22
|
+
/** Longest X-Repository value a receiving server accepts. */
|
|
23
|
+
export const MAX_REPOSITORY_LENGTH = 512;
|
|
24
|
+
const AZURE_HOST = 'dev.azure.com';
|
|
25
|
+
const VISUALSTUDIO_SUFFIX = '.visualstudio.com';
|
|
26
|
+
const URL_SCHEMES = new Set(['http', 'https', 'ssh', 'git', 'git+ssh', 'ssh+git']);
|
|
27
|
+
const HOSTNAME = /^(?:[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?|\[[0-9a-f:.]+\])$/;
|
|
28
|
+
/**
|
|
29
|
+
* Normalise a git remote URL to `host/path`: no scheme, no user info or
|
|
30
|
+
* credentials, no port, no query or fragment, no trailing `.git` or `/`. The
|
|
31
|
+
* host is lowercased; the path keeps its case. ssh forms (`git@host:org/repo`,
|
|
32
|
+
* `ssh://git@host/org/repo`) map to the same value as https. Azure DevOps
|
|
33
|
+
* spellings fold to `dev.azure.com/<org>/<project>/_git/<repo>` (org
|
|
34
|
+
* lowercased), as the receiving server canonicalises them. Characters outside
|
|
35
|
+
* printable ASCII (space, non-ASCII) are percent-encoded.
|
|
36
|
+
*
|
|
37
|
+
* Returns undefined for anything that is not a network remote (a local path, a
|
|
38
|
+
* file:// URL) or that would not be a valid header value.
|
|
39
|
+
*/
|
|
40
|
+
export function normaliseRepositoryRemote(remoteUrl) {
|
|
41
|
+
const raw = remoteUrl.trim();
|
|
42
|
+
if (!raw || raw.includes('\\'))
|
|
43
|
+
return undefined;
|
|
44
|
+
let hostPart;
|
|
45
|
+
let pathPart;
|
|
46
|
+
const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):\/\/(.*)$/.exec(raw);
|
|
47
|
+
if (scheme) {
|
|
48
|
+
if (!URL_SCHEMES.has(scheme[1].toLowerCase()))
|
|
49
|
+
return undefined;
|
|
50
|
+
const rest = scheme[2];
|
|
51
|
+
const slash = rest.indexOf('/');
|
|
52
|
+
const authority = slash < 0 ? rest : rest.slice(0, slash);
|
|
53
|
+
pathPart = slash < 0 ? '' : rest.slice(slash + 1);
|
|
54
|
+
// Drop user info (and any credentials in it): everything up to the LAST '@'
|
|
55
|
+
// of the authority, then the port.
|
|
56
|
+
hostPart = authority.slice(authority.lastIndexOf('@') + 1).replace(/:\d*$/, '');
|
|
57
|
+
}
|
|
58
|
+
else {
|
|
59
|
+
// scp-like form: [user@]host:path. A single-letter "host" is a Windows
|
|
60
|
+
// drive (C:/x), and a path with no ':' before its first '/' is local.
|
|
61
|
+
const scp = /^(?:[^@/]*@)?([^@/:]+):(.*)$/.exec(raw);
|
|
62
|
+
if (!scp || scp[1].length < 2)
|
|
63
|
+
return undefined;
|
|
64
|
+
hostPart = scp[1];
|
|
65
|
+
pathPart = scp[2];
|
|
66
|
+
}
|
|
67
|
+
// Real userinfo sits in the authority and is already stripped. An '@' still in
|
|
68
|
+
// the path means the parser misread credentials as the host (a password with a
|
|
69
|
+
// numeric prefix and a '/', e.g. `https://u:1234/pw@host/o/r` turns `u:1234`
|
|
70
|
+
// into host `u` and a port). Checked before the query/fragment strip so a
|
|
71
|
+
// `#`/`?` in such a password cannot hide the '@'. Send no header.
|
|
72
|
+
if (pathPart.includes('@'))
|
|
73
|
+
return undefined;
|
|
74
|
+
// Query and fragment never identify a repository and can carry tokens.
|
|
75
|
+
pathPart = pathPart.replace(/[?#].*$/, '');
|
|
76
|
+
const host = hostPart.toLowerCase();
|
|
77
|
+
const repoPath = pathPart
|
|
78
|
+
.replace(/^\/+/, '')
|
|
79
|
+
.replace(/\/+$/, '')
|
|
80
|
+
.replace(/\.git$/i, '')
|
|
81
|
+
.replace(/\/+$/, '');
|
|
82
|
+
// The host must be a hostname or a bracketed IPv6 literal. Anything else (a
|
|
83
|
+
// password containing '/', a query before the path, a non-numeric port) means
|
|
84
|
+
// the authority was not parsed as the remote intended, and what is left could
|
|
85
|
+
// carry credentials or tokens: send no header rather than a leaking one.
|
|
86
|
+
if (!repoPath || !HOSTNAME.test(host))
|
|
87
|
+
return undefined;
|
|
88
|
+
const value = canonicaliseAzure(percentEncode(`${host}/${repoPath}`));
|
|
89
|
+
return isValidRepositoryValue(value) ? value : undefined;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* True when `value` is a header value a receiving server accepts: at most 512
|
|
93
|
+
* printable ASCII characters, no spaces, no scheme, no '@' before the first '/'.
|
|
94
|
+
*/
|
|
95
|
+
export function isValidRepositoryValue(value) {
|
|
96
|
+
if (value.length === 0 || value.length > MAX_REPOSITORY_LENGTH)
|
|
97
|
+
return false;
|
|
98
|
+
if (!/^[!-~]+$/.test(value) || value.includes('://'))
|
|
99
|
+
return false;
|
|
100
|
+
const at = value.indexOf('@');
|
|
101
|
+
const slash = value.indexOf('/');
|
|
102
|
+
return slash > 0 && (at < 0 || slash < at);
|
|
103
|
+
}
|
|
104
|
+
function percentEncode(value) {
|
|
105
|
+
let out = '';
|
|
106
|
+
for (const ch of value) {
|
|
107
|
+
out += /^[!-~]$/.test(ch)
|
|
108
|
+
? ch
|
|
109
|
+
: Array.from(Buffer.from(ch, 'utf8'), b => `%${b.toString(16).toUpperCase().padStart(2, '0')}`).join('');
|
|
110
|
+
}
|
|
111
|
+
return out;
|
|
112
|
+
}
|
|
113
|
+
function azureKey(org, project, repo) {
|
|
114
|
+
return `${AZURE_HOST}/${org.toLowerCase()}/${project}/_git/${repo}`;
|
|
115
|
+
}
|
|
116
|
+
const eq = (a, b) => a.toLowerCase() === b.toLowerCase();
|
|
117
|
+
// Mirrors the receiving server's canonicalisation of Azure DevOps spellings,
|
|
118
|
+
// so fleet sends the canonical key rather than relying on the server to fold it.
|
|
119
|
+
function canonicaliseAzure(value) {
|
|
120
|
+
const segments = value.split('/');
|
|
121
|
+
if (segments.some(s => s.length === 0))
|
|
122
|
+
return value;
|
|
123
|
+
const host = segments[0];
|
|
124
|
+
// ssh.dev.azure.com/v3/<org>/<project>/<repo>, vs-ssh.visualstudio.com/v3/...
|
|
125
|
+
if ((host === 'ssh.dev.azure.com' || host === 'vs-ssh.visualstudio.com')
|
|
126
|
+
&& segments.length === 5 && eq(segments[1], 'v3')) {
|
|
127
|
+
return azureKey(segments[2], segments[3], segments[4]);
|
|
128
|
+
}
|
|
129
|
+
// dev.azure.com/<org>/<project>/_git/<repo>
|
|
130
|
+
if (host === AZURE_HOST && segments.length === 5 && eq(segments[3], '_git')) {
|
|
131
|
+
return azureKey(segments[1], segments[2], segments[4]);
|
|
132
|
+
}
|
|
133
|
+
if (host.endsWith(VISUALSTUDIO_SUFFIX) && host.length > VISUALSTUDIO_SUFFIX.length) {
|
|
134
|
+
const org = host.slice(0, -VISUALSTUDIO_SUFFIX.length);
|
|
135
|
+
// <org>.visualstudio.com/<project>/_git/<repo>
|
|
136
|
+
if (segments.length === 4 && eq(segments[2], '_git')) {
|
|
137
|
+
return azureKey(org, segments[1], segments[3]);
|
|
138
|
+
}
|
|
139
|
+
// <org>.visualstudio.com/DefaultCollection/<project>/_git/<repo>
|
|
140
|
+
if (segments.length === 5 && eq(segments[1], 'DefaultCollection') && eq(segments[3], '_git')) {
|
|
141
|
+
return azureKey(org, segments[2], segments[4]);
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
return value;
|
|
145
|
+
}
|
|
146
|
+
function gitOut(folder, args) {
|
|
147
|
+
// Same ceiling as resolveProjectSlug / kb-self: the folder itself must be the
|
|
148
|
+
// repository, never a checkout it merely sits inside.
|
|
149
|
+
const env = { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(folder) };
|
|
150
|
+
try {
|
|
151
|
+
return execFileSync(gitExecutable(), args, {
|
|
152
|
+
cwd: folder, env, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
153
|
+
}).trim();
|
|
154
|
+
}
|
|
155
|
+
catch {
|
|
156
|
+
return undefined;
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
/** A full SHA-1 or SHA-256 commit id, lowercase. */
|
|
160
|
+
export const COMMIT_SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
|
|
161
|
+
/** How long a read HEAD sha is reused before git is asked again. */
|
|
162
|
+
export const HEAD_COMMIT_TTL_MS = 5000;
|
|
163
|
+
/**
|
|
164
|
+
* A reader for the HEAD sha of a local folder, cached for `ttlMs` so it is not
|
|
165
|
+
* re-read on every request. Returns undefined (never throws) when the folder
|
|
166
|
+
* is not a git repository or HEAD cannot be resolved (unborn branch).
|
|
167
|
+
*/
|
|
168
|
+
export function headCommitReader(folder, ttlMs = HEAD_COMMIT_TTL_MS) {
|
|
169
|
+
let cached;
|
|
170
|
+
return () => {
|
|
171
|
+
const now = Date.now();
|
|
172
|
+
if (cached && now - cached.at < ttlMs)
|
|
173
|
+
return cached.value;
|
|
174
|
+
const sha = gitOut(folder, ['rev-parse', '--verify', '--quiet', 'HEAD^{commit}'])?.toLowerCase();
|
|
175
|
+
cached = { value: sha && COMMIT_SHA.test(sha) ? sha : undefined, at: now };
|
|
176
|
+
return cached.value;
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
const BRANCH_REF_PREFIX = 'refs/heads/';
|
|
180
|
+
/**
|
|
181
|
+
* True when `value` is an X-Repository-Branch value that may be sent: 1-255
|
|
182
|
+
* printable ASCII characters, no spaces.
|
|
183
|
+
*/
|
|
184
|
+
export function isValidBranchValue(value) {
|
|
185
|
+
return value.length > 0 && value.length <= MAX_BRANCH_LENGTH && /^[!-~]+$/.test(value);
|
|
186
|
+
}
|
|
187
|
+
/**
|
|
188
|
+
* The header value for a branch name: characters outside printable ASCII
|
|
189
|
+
* (non-ASCII, control, space) percent-encoded as UTF-8. Undefined when the
|
|
190
|
+
* result is empty or longer than MAX_BRANCH_LENGTH.
|
|
191
|
+
*/
|
|
192
|
+
export function branchHeaderValue(branch) {
|
|
193
|
+
const value = percentEncode(branch);
|
|
194
|
+
return isValidBranchValue(value) ? value : undefined;
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* A reader for the checked-out branch of a local folder (`git symbolic-ref
|
|
198
|
+
* --quiet HEAD`, with `refs/heads/` stripped), cached for `ttlMs` like
|
|
199
|
+
* headCommitReader so a branch switch shows within one TTL. `--short` is not
|
|
200
|
+
* used: it prints `heads/x` when a tag `x` also exists. Returns the header value
|
|
201
|
+
* (see branchHeaderValue), or undefined (never throws) on a detached HEAD, a HEAD
|
|
202
|
+
* not under refs/heads/, a folder that is not a git repository, a git failure or
|
|
203
|
+
* timeout, or an invalid value.
|
|
204
|
+
*/
|
|
205
|
+
export function headBranchReader(folder, ttlMs = HEAD_COMMIT_TTL_MS) {
|
|
206
|
+
let cached;
|
|
207
|
+
return () => {
|
|
208
|
+
const now = Date.now();
|
|
209
|
+
if (cached && now - cached.at < ttlMs)
|
|
210
|
+
return cached.value;
|
|
211
|
+
const ref = gitOut(folder, ['symbolic-ref', '--quiet', 'HEAD']);
|
|
212
|
+
const branch = ref?.startsWith(BRANCH_REF_PREFIX) ? ref.slice(BRANCH_REF_PREFIX.length) : undefined;
|
|
213
|
+
cached = { value: branch ? branchHeaderValue(branch) : undefined, at: now };
|
|
214
|
+
return cached.value;
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
/**
|
|
218
|
+
* The repository identity for a resolved KB anchor, or undefined when there is
|
|
219
|
+
* none. `remoteUrl` is set only when the folder lives on another host: then
|
|
220
|
+
* the identity is that remote and the commit and branch are unknown (git
|
|
221
|
+
* cannot run there). Otherwise the identity is the local folder's origin
|
|
222
|
+
* remote, the commit is its HEAD and the branch its checked-out branch.
|
|
223
|
+
*/
|
|
224
|
+
export function resolveRepositoryIdentity(folder, remoteUrl) {
|
|
225
|
+
if (remoteUrl && remoteUrl.trim()) {
|
|
226
|
+
const remote = normaliseRepositoryRemote(remoteUrl);
|
|
227
|
+
return remote ? { remote } : undefined;
|
|
228
|
+
}
|
|
229
|
+
const origin = gitOut(folder, ['remote', 'get-url', 'origin']);
|
|
230
|
+
const remote = origin ? normaliseRepositoryRemote(origin) : undefined;
|
|
231
|
+
return remote ? { remote, commitOf: headCommitReader(folder), branchOf: headBranchReader(folder) } : undefined;
|
|
232
|
+
}
|
|
233
|
+
//# sourceMappingURL=repository-header.js.map
|
|
@@ -11,7 +11,7 @@ export declare function isSqliteProject(provider: MemoryProvider): provider is S
|
|
|
11
11
|
/**
|
|
12
12
|
* Narrows a project KB provider to SqliteProvider, for call sites that use
|
|
13
13
|
* SqliteProvider-only capabilities not part of the MemoryProvider interface
|
|
14
|
-
* (list,
|
|
14
|
+
* (list, freshnessSweep, reconcilePrefilter, resolveContradiction,
|
|
15
15
|
* hasEntry, the DirectiveProvider methods, and capture's second CaptureOpts
|
|
16
16
|
* argument).
|
|
17
17
|
*
|
|
@@ -12,7 +12,7 @@ export function isSqliteProject(provider) {
|
|
|
12
12
|
/**
|
|
13
13
|
* Narrows a project KB provider to SqliteProvider, for call sites that use
|
|
14
14
|
* SqliteProvider-only capabilities not part of the MemoryProvider interface
|
|
15
|
-
* (list,
|
|
15
|
+
* (list, freshnessSweep, reconcilePrefilter, resolveContradiction,
|
|
16
16
|
* hasEntry, the DirectiveProvider methods, and capture's second CaptureOpts
|
|
17
17
|
* argument).
|
|
18
18
|
*
|
|
@@ -1,4 +1,10 @@
|
|
|
1
|
-
import
|
|
1
|
+
import { type DiscardResult, type RetireOptions } from './types.js';
|
|
2
|
+
import type { MemoryProvider, KBEntry, KBEntryInput, CaptureOpts, CaptureResult, QueryOptions, EntryTrustFilter, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, Confidence, ProviderStats } from './types.js';
|
|
3
|
+
/**
|
|
4
|
+
* The reason recorded when a demotion arrives through the committed project
|
|
5
|
+
* bible rather than a local kb_demote. Must clear MIN_DEMOTE_REASON_LENGTH.
|
|
6
|
+
*/
|
|
7
|
+
export declare const BIBLE_DEMOTION_REASON = "demoted in the project bible";
|
|
2
8
|
export declare class SqliteProvider implements MemoryProvider {
|
|
3
9
|
private db;
|
|
4
10
|
readonly dbPath: string;
|
|
@@ -10,9 +16,25 @@ export declare class SqliteProvider implements MemoryProvider {
|
|
|
10
16
|
* repo-blindness failure class of apra-fleet-tm7. Undefined for the single
|
|
11
17
|
* shared global KB, which spans every repo and has no one root.
|
|
12
18
|
*/
|
|
13
|
-
|
|
19
|
+
repoPath: string | undefined;
|
|
14
20
|
constructor(dbPath?: string, repoPath?: string);
|
|
21
|
+
/**
|
|
22
|
+
* Re-anchor after loading. Used only by the remote member bible view: the
|
|
23
|
+
* member's checkout is not on this host, so entries are imported with no
|
|
24
|
+
* anchor (the basis gate cannot check files here), then the remote folder is
|
|
25
|
+
* bound so freshness reads treat the anchor as missing and issue no verdict.
|
|
26
|
+
*/
|
|
27
|
+
bindRepoPath(repoPath: string | undefined): void;
|
|
15
28
|
init(): Promise<void>;
|
|
29
|
+
/**
|
|
30
|
+
* Record `blobId` (a git object id of a bible's bytes) as written or
|
|
31
|
+
* imported by the maintainer side. Idempotent: re-recording keeps the first
|
|
32
|
+
* row. Only trusted callers (kb_bible_commit and kb_import from a FULL or
|
|
33
|
+
* kb_maintainer session) may call this.
|
|
34
|
+
*/
|
|
35
|
+
recordTrustedBibleBlob(blobId: string, source: 'kb_bible_commit' | 'kb_import'): void;
|
|
36
|
+
/** True when `blobId` was recorded by recordTrustedBibleBlob. */
|
|
37
|
+
isTrustedBibleBlob(blobId: string): boolean;
|
|
16
38
|
private getDb;
|
|
17
39
|
private rowToEntry;
|
|
18
40
|
private insertEntry;
|
|
@@ -60,11 +82,77 @@ export declare class SqliteProvider implements MemoryProvider {
|
|
|
60
82
|
* entry while unexpected failures still propagate.
|
|
61
83
|
*/
|
|
62
84
|
private assertCheckableBasis;
|
|
85
|
+
/**
|
|
86
|
+
* The ONLY way this provider hashes source files: relative paths anchor at
|
|
87
|
+
* the provider repo (never process.cwd()) when one is set. Every call site
|
|
88
|
+
* goes through here so a new call cannot forget the anchor.
|
|
89
|
+
*/
|
|
90
|
+
private hashAnchored;
|
|
63
91
|
private computeSourceFileHashes;
|
|
64
92
|
private static readonly FEEDBACK_MARKER_RE;
|
|
65
93
|
private freshnessRevivable;
|
|
66
94
|
private basisFullyMatches;
|
|
67
95
|
private parseBasis;
|
|
96
|
+
/**
|
|
97
|
+
* Read-only accessor for the stored per-file hash basis (source_file_hashes)
|
|
98
|
+
* of the given entry ids. Each requested id maps to its parsed basis, or null
|
|
99
|
+
* when the basis is empty/unparseable or the id is unknown. Used by kb_export's
|
|
100
|
+
* project-scope bible filter and kb_bible_commit admission; internal to this
|
|
101
|
+
* provider, not an MCP surface. A local freshness-only basis
|
|
102
|
+
* (local_basis_only = 1, a legacy bible import) maps to null: it was hashed
|
|
103
|
+
* from this clone, never verified, so it must never be exported or admit an
|
|
104
|
+
* entry to the bible.
|
|
105
|
+
*/
|
|
106
|
+
getSourceFileBases(ids: string[]): Map<string, Record<string, string> | null>;
|
|
107
|
+
/**
|
|
108
|
+
* The bible trust time of each given id that exists: when this clone's trust
|
|
109
|
+
* in the row dates from, as a bible records it. promoted_at when the row was
|
|
110
|
+
* promoted here; else the updated_at the bible carried when the row was
|
|
111
|
+
* imported (bible_updated_at); else null for an imported row from before that
|
|
112
|
+
* column existed -- its trust came from a bible, and the local import time
|
|
113
|
+
* says nothing about when it was promoted. Any other row falls back to
|
|
114
|
+
* created_at. An unknown id is absent from the map. Fed to
|
|
115
|
+
* standingAgainstTombstone (bible-import.ts) by kb_export, and used for the
|
|
116
|
+
* updated_at a bible writer records, so every clone compares the same value.
|
|
117
|
+
* Internal to this provider, not an MCP surface.
|
|
118
|
+
*/
|
|
119
|
+
getBibleTrustTimes(ids: string[]): Map<string, string | null>;
|
|
120
|
+
/** getBibleTrustTimes' rule for one raw row (needs promoted_at, bible_updated_at, source, created_at). */
|
|
121
|
+
private bibleTrustTimeOf;
|
|
122
|
+
/**
|
|
123
|
+
* Read-only accessor for the demotion state of the given entry ids: the
|
|
124
|
+
* CURRENT confidence and demoted_at of each id that exists. An unknown id is
|
|
125
|
+
* simply absent from the map.
|
|
126
|
+
*
|
|
127
|
+
* Deliberately NOT routed through list(): list() excludes stale and superseded
|
|
128
|
+
* rows, and a demoted entry that later went stale is exactly the one whose
|
|
129
|
+
* tombstone other clones most need -- their bible still carries the entry.
|
|
130
|
+
* Policy (what counts as demoted enough to tombstone) lives in the caller
|
|
131
|
+
* (src/tools/kb-bible-commit.ts); this member only reports the two columns.
|
|
132
|
+
* Internal to this provider, not an MCP surface.
|
|
133
|
+
*/
|
|
134
|
+
getDemotionState(ids: string[]): Map<string, {
|
|
135
|
+
confidence: Confidence;
|
|
136
|
+
demoted_at?: string;
|
|
137
|
+
}>;
|
|
138
|
+
/**
|
|
139
|
+
* For each of the given ids that EXISTS locally, whether that row is LIVE
|
|
140
|
+
* CONFIRMED: confidence is CONFIRMED and the row is not stale, not superseded
|
|
141
|
+
* and not flagged_for_review.
|
|
142
|
+
*
|
|
143
|
+
* An id with NO local row is simply ABSENT from the map -- the caller must be
|
|
144
|
+
* able to tell "I hold a row and it is no longer trustworthy" (do not surface
|
|
145
|
+
* the bible's version of it) from "I have never seen this id" (the cold-seed
|
|
146
|
+
* case the bible exists to serve). A boolean-only return would conflate them.
|
|
147
|
+
*
|
|
148
|
+
* ONE predicate, deliberately not a demoted_at check. A demotion is only one
|
|
149
|
+
* of the ways a row stops being live CONFIRMED; staleness, supersession and a
|
|
150
|
+
* review flag are the others, and a cold seed that re-surfaced the bible's
|
|
151
|
+
* CONFIRMED copy of any of them would be re-asserting knowledge this clone has
|
|
152
|
+
* already stopped trusting. Reads the rows DIRECTLY rather than through list(),
|
|
153
|
+
* which filters stale and superseded rows out and so cannot report them.
|
|
154
|
+
*/
|
|
155
|
+
getLiveConfirmedState(ids: string[]): Map<string, boolean>;
|
|
68
156
|
private checkFreshness;
|
|
69
157
|
freshnessSweep(root?: string): Promise<{
|
|
70
158
|
checked: number;
|
|
@@ -86,33 +174,167 @@ export declare class SqliteProvider implements MemoryProvider {
|
|
|
86
174
|
*/
|
|
87
175
|
private decayConceptEntries;
|
|
88
176
|
private wireLinks;
|
|
89
|
-
capture(input: KBEntryInput, opts?: CaptureOpts): Promise<
|
|
90
|
-
id: string;
|
|
91
|
-
audn_decision: AudnDecision;
|
|
92
|
-
}>;
|
|
177
|
+
capture(input: KBEntryInput, opts?: CaptureOpts): Promise<CaptureResult>;
|
|
93
178
|
hasEntry(id: string): boolean;
|
|
94
179
|
touch(ids: string[]): Promise<number>;
|
|
95
180
|
query(opts: QueryOptions): Promise<KBResult>;
|
|
96
|
-
context(files: string[]): Promise<FileContextResult[]>;
|
|
97
|
-
|
|
181
|
+
context(files: string[], confidence?: Confidence[], excludeDisputed?: boolean, ownerTag?: string): Promise<FileContextResult[]>;
|
|
182
|
+
discard(ids: string[], opts?: RetireOptions): Promise<DiscardResult>;
|
|
183
|
+
/**
|
|
184
|
+
* For each id this KB holds as RETIRED, why: 'superseded' or 'invalidated'.
|
|
185
|
+
* Ids that are unknown, or known and not retired, are absent from the map.
|
|
186
|
+
*
|
|
187
|
+
* Retired means superseded_at is set (reason from retired_reason; NULL, a
|
|
188
|
+
* row retired before that column existed, counts as 'superseded'), or
|
|
189
|
+
* content_hash = 'invalidated' (kb_invalidate by file) -> 'invalidated'.
|
|
190
|
+
*
|
|
191
|
+
* A merely STALE row (stale = 1 from the freshness sweep, superseded_at
|
|
192
|
+
* NULL, content_hash not 'invalidated') is NOT retired: staleness means the
|
|
193
|
+
* cited files moved, which the next capture or sweep can clear, while
|
|
194
|
+
* superseded and invalidated are explicit curation decisions. Only those two
|
|
195
|
+
* remove an entry from the bible (kb_bible_commit).
|
|
196
|
+
*/
|
|
197
|
+
getRetirementReasons(ids: string[]): Map<string, 'superseded' | 'invalidated'>;
|
|
198
|
+
invalidate(files: string[], opts?: RetireOptions): Promise<{
|
|
98
199
|
invalidated: number;
|
|
200
|
+
refused?: string[];
|
|
99
201
|
}>;
|
|
100
202
|
getLinked(id: string): Promise<KBEntry[]>;
|
|
101
|
-
relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
|
|
203
|
+
relatedClaims(ids: string[], limit?: number, filter?: EntryTrustFilter): Promise<KBEntry[]>;
|
|
102
204
|
prime(opts: PrimeOptions): Promise<PrimedContext>;
|
|
103
205
|
list(opts: {
|
|
104
|
-
confidence?: Confidence;
|
|
206
|
+
confidence?: Confidence[];
|
|
105
207
|
type?: KBEntry['type'];
|
|
106
208
|
module?: string;
|
|
107
209
|
symbol?: string;
|
|
108
210
|
tag?: string;
|
|
109
211
|
limit?: number;
|
|
212
|
+
exclude_disputed?: boolean;
|
|
213
|
+
/** MEMBER own-scope: only entries tagged with this value (ANDed with `tag`). */
|
|
214
|
+
owner_tag?: string;
|
|
215
|
+
/** Also list stale entries (kb_list never sets it; the kb-server ownership lookup does). */
|
|
216
|
+
include_stale?: boolean;
|
|
110
217
|
}): Promise<KBEntry[]>;
|
|
111
|
-
promote(id: string, reason?: string
|
|
218
|
+
promote(id: string, reason?: string, opts?: {
|
|
219
|
+
ownerTag?: string;
|
|
220
|
+
}): Promise<{
|
|
112
221
|
id: string;
|
|
113
222
|
confidence_before: Confidence;
|
|
114
223
|
confidence_after: Confidence;
|
|
115
224
|
}>;
|
|
225
|
+
/**
|
|
226
|
+
* Evidence paths cited by a demote. Deliberately STRICTER than the basis
|
|
227
|
+
* check promote() runs: a demote reason is an audit record, so a path that
|
|
228
|
+
* cannot be pointed at inside this provider's anchor is refused rather than
|
|
229
|
+
* recorded as an unverifiable string.
|
|
230
|
+
*
|
|
231
|
+
* Refuses, all with E-DEMOTE-EVIDENCE-UNRESOLVED:
|
|
232
|
+
* - any path that is not anchor-relative -- an ABSOLUTE path, or one with
|
|
233
|
+
* a '..' segment. Both are "out of the anchor": an absolute path names a
|
|
234
|
+
* location the anchor does not contain, and was previously accepted and
|
|
235
|
+
* recorded verbatim, which contradicted this very comment. The check is
|
|
236
|
+
* delegated to validateFilePaths (path-validation.ts), the SAME guard
|
|
237
|
+
* every other caller-supplied kb_* file list already runs (kb_capture,
|
|
238
|
+
* kb_context, kb_invalidate, kb_session_prime and the HTTP routes), so
|
|
239
|
+
* this is not a third hand-rolled path guard. It runs BEFORE existence,
|
|
240
|
+
* so a path that happens to land on a real file outside the repo is
|
|
241
|
+
* still refused, and it applies even on the shared-global no-anchor KB,
|
|
242
|
+
* where nothing absolute could be verified against an anchor anyway;
|
|
243
|
+
* - a path that does not resolve, via the SAME resolver promote uses
|
|
244
|
+
* (unresolvableBasisFiles -> resolveBasisFile);
|
|
245
|
+
* - a path that resolves to something that is not a regular file
|
|
246
|
+
* (directories are not evidence).
|
|
247
|
+
*/
|
|
248
|
+
private assertResolvableDemoteEvidence;
|
|
249
|
+
/**
|
|
250
|
+
* The demote-time basis snapshot: sha256 of each cited source file AS IT IS
|
|
251
|
+
* ON DISK RIGHT NOW, keyed by the original (unresolved) path string, the
|
|
252
|
+
* same key convention source_file_hashes uses.
|
|
253
|
+
*
|
|
254
|
+
* This MUST NOT be derived from the source_file_hashes column. That column
|
|
255
|
+
* is the CAPTURE-time basis; copying it was the defect in the superseded
|
|
256
|
+
* upstream attempt, and it silently breaks the ping-pong guard that asks
|
|
257
|
+
* whether the tree has moved on SINCE the demotion. Files that cannot be
|
|
258
|
+
* read are simply absent from the map (a demote is still allowed on an
|
|
259
|
+
* entry whose basis has since disappeared -- unlike promote, which refuses).
|
|
260
|
+
*
|
|
261
|
+
* sha256 and not `git hash-object`: this snapshot is compared against a
|
|
262
|
+
* later re-read of the same files by the same code, so it must not depend on
|
|
263
|
+
* git being available or on the file being in a work tree.
|
|
264
|
+
*/
|
|
265
|
+
private demoteBasisHashes;
|
|
266
|
+
/**
|
|
267
|
+
* kb_demote: withdraw trust from a CONFIRMED entry, CONFIRMED -> INFERRED.
|
|
268
|
+
*
|
|
269
|
+
* The inverse of promote() in intent but NOT its mirror image in mechanics:
|
|
270
|
+
*
|
|
271
|
+
* - it is NOT a ladder. Only CONFIRMED is demotable; INFERRED/UNVERIFIED
|
|
272
|
+
* are REFUSED (E-DEMOTE-NOT-CONFIRMED), never silently returned as a
|
|
273
|
+
* no-op, so a caller can never believe it lowered trust that was already
|
|
274
|
+
* at the floor;
|
|
275
|
+
* - promoted_at and source are left untouched. promote() stamps
|
|
276
|
+
* source='promotion'; a demotion must not erase the provenance of the
|
|
277
|
+
* promotion it is reversing, and promoted_at stays as the record of when
|
|
278
|
+
* the (now withdrawn) trust was granted;
|
|
279
|
+
* - a STALE entry MAY be demoted. Staleness is a freshness verdict, trust
|
|
280
|
+
* is a separate axis, and the entries most worth demoting are exactly the
|
|
281
|
+
* ones the sweep has already flagged;
|
|
282
|
+
* - evidence is REQUIRED, like promote's resolvable basis: at least one
|
|
283
|
+
* evidence file, each of which must resolve inside the anchor
|
|
284
|
+
* (E-DEMOTE-EVIDENCE-UNRESOLVED otherwise).
|
|
285
|
+
*
|
|
286
|
+
* EVERY refusal is checked BEFORE any write, in the order below, and the
|
|
287
|
+
* order is load-bearing: the own-scope/unknown-id check comes first so a
|
|
288
|
+
* member can never learn that an entry it does not own exists by probing for
|
|
289
|
+
* a different refusal message.
|
|
290
|
+
*/
|
|
291
|
+
demote(id: string, reason: string, evidenceFiles: string[], opts?: {
|
|
292
|
+
ownerTag?: string;
|
|
293
|
+
}): Promise<{
|
|
294
|
+
id: string;
|
|
295
|
+
confidence_before: Confidence;
|
|
296
|
+
confidence_after: Confidence;
|
|
297
|
+
}>;
|
|
298
|
+
/**
|
|
299
|
+
* Apply ONE explicit demotion tombstone from a committed project bible to the
|
|
300
|
+
* local row, so a demotion recorded on another clone actually lands here.
|
|
301
|
+
*
|
|
302
|
+
* Returns true only when a row was written. Every "no" is a silent false, not
|
|
303
|
+
* a throw: a bible carries tombstones for the whole project and most clones
|
|
304
|
+
* hold only some of those ids, so an inapplicable tombstone is the normal
|
|
305
|
+
* case, not an error.
|
|
306
|
+
*
|
|
307
|
+
* The rules, each of which silently corrupts another clone's KB if got wrong:
|
|
308
|
+
*
|
|
309
|
+
* - NEVER CREATE. A tombstoned id with no local row stays absent. A
|
|
310
|
+
* tombstone withdraws trust in a row; it is not a way to author one.
|
|
311
|
+
* - ONE RE-PROMOTION RULE. Demote only when standingAgainstTombstone
|
|
312
|
+
* (bible-import.ts) says 'withdrawn' for the row's bible trust time
|
|
313
|
+
* (getBibleTrustTimes): promoted_at, else the updated_at the bible carried
|
|
314
|
+
* at import -- never the local import time. kb_export uses the same rule to
|
|
315
|
+
* decide whether to re-add a tombstoned entry, so the two never disagree.
|
|
316
|
+
* - demoted_at is stamped with the TOMBSTONE's value, not now(): it records
|
|
317
|
+
* when trust was withdrawn, which happened on the other clone. That value
|
|
318
|
+
* is clamped to now (clampBibleTimeToNow), so a future-dated tombstone
|
|
319
|
+
* never stores a demoted_at that every later re-promotion falls before.
|
|
320
|
+
* - NO ownerTag CHECK. Bible-imported rows carry no member tag (see
|
|
321
|
+
* importBibleEntries, which builds its input with tags: [] and author
|
|
322
|
+
* 'unknown'), so an owner check here would make every imported row
|
|
323
|
+
* permanently undemotable. The trust boundary for this path is the
|
|
324
|
+
* git-reviewed bible file, not entry ownership.
|
|
325
|
+
*
|
|
326
|
+
* ABSENCE IS NEVER A DEMOTION: this method is only ever called for an id that
|
|
327
|
+
* carries an EXPLICIT tombstone. A local CONFIRMED row merely missing from the
|
|
328
|
+
* bible (a local-only promotion, or one refused by the basis filter) is never
|
|
329
|
+
* passed here and must stay untouched.
|
|
330
|
+
*
|
|
331
|
+
* Two refusals are inherited from demote() because they are invariants of the
|
|
332
|
+
* store, not of the local/remote distinction: a superseded row is already out
|
|
333
|
+
* of every read path (the write would have no observable meaning), and a
|
|
334
|
+
* user-directive is human-terminal in both directions -- a bible must not be
|
|
335
|
+
* able to deactivate a directive a human set here.
|
|
336
|
+
*/
|
|
337
|
+
applyBibleDemotion(id: string, tombstoneAt: string): boolean;
|
|
116
338
|
feedback(id: string, reason: string, author: string): Promise<KBEntry>;
|
|
117
339
|
flaggedPairs(): Promise<{
|
|
118
340
|
original: KBEntry;
|