@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,88 @@
|
|
|
1
|
+
// KB tool profiles (GitHub #759): which kb_* tools a FULL (interactive,
|
|
2
|
+
// non-member) MCP session is served.
|
|
3
|
+
//
|
|
4
|
+
// full -- every kb_* tool (the default; also what an absent setting means).
|
|
5
|
+
// developer -- the everyday set: DEVELOPER_KB_TOOLS below.
|
|
6
|
+
// custom -- an explicit list of registered kb_* tool names.
|
|
7
|
+
//
|
|
8
|
+
// The profile is install-wide (stored in FLEET_DIR/knowledge/config.json as
|
|
9
|
+
// tool_profile / tool_profile_tools, see src/services/knowledge/kb-config.ts)
|
|
10
|
+
// and is applied only to FULL sessions when they register their tools
|
|
11
|
+
// (src/services/tool-registry.ts). Member sessions -- including the engine's
|
|
12
|
+
// kb_maintainer session -- keep their own allowlists regardless of profile.
|
|
13
|
+
// Non-kb tools (code_* included) are never filtered.
|
|
14
|
+
//
|
|
15
|
+
// This is a usability control that trims the tool list, NOT a security
|
|
16
|
+
// boundary: a hidden tool is just not listed, and the profile can be changed
|
|
17
|
+
// back with `apra-fleet kb profile full`.
|
|
18
|
+
import { REGISTERED_TOOL_NAMES } from './member-tool-allowlist.js';
|
|
19
|
+
export const KB_TOOL_PROFILE_NAMES = Object.freeze(['full', 'developer', 'custom']);
|
|
20
|
+
export const FULL_KB_TOOL_PROFILE = Object.freeze({ name: 'full' });
|
|
21
|
+
/** The kb_* tools the developer profile serves. */
|
|
22
|
+
export const DEVELOPER_KB_TOOLS = Object.freeze([
|
|
23
|
+
'kb_session_prime', 'kb_query', 'kb_context', 'kb_capture', 'kb_feedback',
|
|
24
|
+
]);
|
|
25
|
+
/** Every registered kb_* tool name (the only names a custom list may hold). */
|
|
26
|
+
export function registeredKbToolNames() {
|
|
27
|
+
return REGISTERED_TOOL_NAMES.filter(isKbToolName);
|
|
28
|
+
}
|
|
29
|
+
export function isKbToolName(name) {
|
|
30
|
+
return name.startsWith('kb_');
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Validate a custom tool list: non-empty, and every entry a registered kb_*
|
|
34
|
+
* tool name. Throws an Error naming the unknown entries and the valid ones.
|
|
35
|
+
* Returns the list de-duplicated, in the caller's order.
|
|
36
|
+
*/
|
|
37
|
+
export function validateCustomKbTools(tools) {
|
|
38
|
+
const valid = registeredKbToolNames();
|
|
39
|
+
const names = tools.map(t => (typeof t === 'string' ? t.trim() : String(t))).filter(t => t.length > 0);
|
|
40
|
+
if (names.length === 0) {
|
|
41
|
+
throw new Error(`KB tool profile "custom" needs at least one kb_* tool name. Valid names: ${valid.join(', ')}`);
|
|
42
|
+
}
|
|
43
|
+
const unknown = names.filter(n => !valid.includes(n));
|
|
44
|
+
if (unknown.length > 0) {
|
|
45
|
+
throw new Error(`KB tool profile "custom" has unknown kb tool name(s): ${[...new Set(unknown)].join(', ')}. ` +
|
|
46
|
+
`Valid names: ${valid.join(', ')}`);
|
|
47
|
+
}
|
|
48
|
+
return [...new Set(names)];
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Build a profile from its name and (for custom) its list, validating both.
|
|
52
|
+
* Throws a clear Error on an unknown profile name or an invalid custom list.
|
|
53
|
+
*/
|
|
54
|
+
export function makeKbToolProfile(name, tools) {
|
|
55
|
+
if (name === 'full')
|
|
56
|
+
return FULL_KB_TOOL_PROFILE;
|
|
57
|
+
if (name === 'developer')
|
|
58
|
+
return { name: 'developer' };
|
|
59
|
+
if (name === 'custom') {
|
|
60
|
+
if (!Array.isArray(tools)) {
|
|
61
|
+
throw new Error(`KB tool profile "custom" needs a tool list. Valid names: ${registeredKbToolNames().join(', ')}`);
|
|
62
|
+
}
|
|
63
|
+
return { name: 'custom', tools: validateCustomKbTools(tools) };
|
|
64
|
+
}
|
|
65
|
+
throw new Error(`Unknown KB tool profile ${JSON.stringify(name)}; expected one of: ${KB_TOOL_PROFILE_NAMES.join(', ')}`);
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* True when `name` may be registered on a FULL session under `profile`.
|
|
69
|
+
* Non-kb tools are always allowed.
|
|
70
|
+
*/
|
|
71
|
+
export function kbToolAllowedByProfile(name, profile) {
|
|
72
|
+
if (!isKbToolName(name))
|
|
73
|
+
return true;
|
|
74
|
+
switch (profile.name) {
|
|
75
|
+
case 'full': return true;
|
|
76
|
+
case 'developer': return DEVELOPER_KB_TOOLS.includes(name);
|
|
77
|
+
case 'custom': return profile.tools.includes(name);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
/** One-line human description, e.g. for the CLI. */
|
|
81
|
+
export function describeKbToolProfile(profile) {
|
|
82
|
+
switch (profile.name) {
|
|
83
|
+
case 'full': return 'full (every kb_* tool)';
|
|
84
|
+
case 'developer': return `developer (${DEVELOPER_KB_TOOLS.join(', ')})`;
|
|
85
|
+
case 'custom': return `custom (${profile.tools.join(', ')})`;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=kb-tool-profile.js.map
|
|
@@ -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
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
export declare const OWN_BIBLE_REL = ".fleet/kb-canonical.json";
|
|
2
|
+
/**
|
|
3
|
+
* Bytes read from the object store do not hash to the blob id they were read
|
|
4
|
+
* by (replace ref, alternates, overwritten loose object, crafted pack). The
|
|
5
|
+
* caller must import nothing.
|
|
6
|
+
*/
|
|
7
|
+
export declare class BibleBlobIntegrityError extends Error {
|
|
8
|
+
readonly blobId: string;
|
|
9
|
+
readonly source: string;
|
|
10
|
+
constructor(blobId: string, source: string);
|
|
11
|
+
}
|
|
12
|
+
/** The git blob id of `bytes` in the given object format (40-hex sha1, 64-hex sha256). */
|
|
13
|
+
export declare function gitBlobId(bytes: Buffer, format: 'sha1' | 'sha256'): string;
|
|
14
|
+
/** True when `bytes` are exactly the blob `id` (format chosen by the id length). */
|
|
15
|
+
export declare function blobBytesMatchId(id: string, bytes: Buffer): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* A git rev the caller may name for the own bible (kb_import `ref`): a ref
|
|
18
|
+
* name or HEAD, never an option (leading '-') and never a rev expression
|
|
19
|
+
* (no ':', '..', '@{', '^', '~', whitespace).
|
|
20
|
+
*/
|
|
21
|
+
export declare function isSafeBibleRef(ref: string): boolean;
|
|
22
|
+
/**
|
|
23
|
+
* The bible at `rel` (default the own bible, a path relative to `folder`) as
|
|
24
|
+
* committed at `ref` (default HEAD): its blob id and its bytes, read as ONE
|
|
25
|
+
* object (the id is resolved first and the bytes are read by that id, then
|
|
26
|
+
* hashed in-process against it -- see the header). `./` resolves the path
|
|
27
|
+
* against `folder`, which need not be the repository top level. null when
|
|
28
|
+
* there is no committed copy (unresolvable or unsafe ref, unborn HEAD,
|
|
29
|
+
* bible not tracked at that ref, not a work tree, git missing). Throws
|
|
30
|
+
* BibleBlobIntegrityError when the bytes do not hash to the id.
|
|
31
|
+
*/
|
|
32
|
+
export declare function readCommittedBibleBlob(folder: string, ref?: string, rel?: string): Promise<{
|
|
33
|
+
blobId: string;
|
|
34
|
+
text: string;
|
|
35
|
+
} | null>;
|
|
36
|
+
/**
|
|
37
|
+
* The blob id git would store for `bytes` committed unfiltered in the
|
|
38
|
+
* repository containing `folder`, computed in-process (`git hash-object
|
|
39
|
+
* --no-filters` semantics; the object format comes from the repository,
|
|
40
|
+
* sha1 outside one or when git is too old to report it -- such a git reads
|
|
41
|
+
* only sha1 repositories).
|
|
42
|
+
*/
|
|
43
|
+
export declare function bibleBytesBlobId(folder: string, bytes: Buffer): Promise<string>;
|
|
44
|
+
//# sourceMappingURL=bible-blob-id.d.ts.map
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
// Git blob ids of the own bible (.fleet/kb-canonical.json), for the kb_import
|
|
2
|
+
// trust anchor.
|
|
3
|
+
//
|
|
4
|
+
// A member session without the kb_maintainer grant imports only the committed
|
|
5
|
+
// bible at HEAD. The member controls its own .git, so "committed" alone proves
|
|
6
|
+
// nothing: it can commit a hand-made bible locally, import it, and reset the
|
|
7
|
+
// commit away. The trust decision is therefore taken against a record OUTSIDE
|
|
8
|
+
// the checkout: the per-repo KB database on the hub, where the maintainer side
|
|
9
|
+
// (kb_bible_commit and FULL / kb_maintainer kb_import) records the blob id of
|
|
10
|
+
// every bible it writes or imports (SqliteProvider.recordTrustedBibleBlob). A
|
|
11
|
+
// blob id is the git object id of the bible bytes ("blob <len>\0<bytes>",
|
|
12
|
+
// hashed with the repository's object format), so the id recorded for bytes
|
|
13
|
+
// the maintainer wrote equals the HEAD:path blob id of the same bytes in any
|
|
14
|
+
// clone that checks them out.
|
|
15
|
+
//
|
|
16
|
+
// ID-TO-BYTES BINDING: the object store is member-writable too. A replace ref
|
|
17
|
+
// (git replace <trusted> <forged>), an overwritten loose object, an alternates
|
|
18
|
+
// entry or a crafted pack can all make `git cat-file blob <trusted id>` return
|
|
19
|
+
// bytes that are NOT the trusted blob. So the bytes read for an id are hashed
|
|
20
|
+
// IN-PROCESS and refused unless they hash to exactly that id; git is asked
|
|
21
|
+
// with --no-replace-objects as well (belt and braces). Ids are likewise
|
|
22
|
+
// computed in-process from the exact bytes written or parsed, never by
|
|
23
|
+
// `git hash-object` on a path (that would re-read the file and run the
|
|
24
|
+
// checkout's member-configured clean filters).
|
|
25
|
+
//
|
|
26
|
+
// Every helper runs git with array args and no shell (same on every OS) and
|
|
27
|
+
// returns null rather than throwing when git cannot answer.
|
|
28
|
+
import { execFile } from 'node:child_process';
|
|
29
|
+
import { createHash } from 'node:crypto';
|
|
30
|
+
import { gitExecutable } from '../../os/git-executable.js';
|
|
31
|
+
export const OWN_BIBLE_REL = '.fleet/kb-canonical.json';
|
|
32
|
+
function gitBuffer(args, cwd) {
|
|
33
|
+
return new Promise((resolve) => {
|
|
34
|
+
let gitBin;
|
|
35
|
+
try {
|
|
36
|
+
gitBin = gitExecutable();
|
|
37
|
+
}
|
|
38
|
+
catch {
|
|
39
|
+
resolve(null);
|
|
40
|
+
return;
|
|
41
|
+
}
|
|
42
|
+
execFile(gitBin, ['--no-replace-objects', ...args], {
|
|
43
|
+
cwd, windowsHide: true, timeout: 30_000, maxBuffer: 256 * 1024 * 1024, encoding: 'buffer',
|
|
44
|
+
}, (err, stdout) => resolve(err ? null : stdout));
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
async function git(args, cwd) {
|
|
48
|
+
const out = await gitBuffer(args, cwd);
|
|
49
|
+
return out === null ? null : out.toString('utf-8');
|
|
50
|
+
}
|
|
51
|
+
const OBJECT_ID = /^[0-9a-f]{40}([0-9a-f]{24})?$/;
|
|
52
|
+
/**
|
|
53
|
+
* Bytes read from the object store do not hash to the blob id they were read
|
|
54
|
+
* by (replace ref, alternates, overwritten loose object, crafted pack). The
|
|
55
|
+
* caller must import nothing.
|
|
56
|
+
*/
|
|
57
|
+
export class BibleBlobIntegrityError extends Error {
|
|
58
|
+
blobId;
|
|
59
|
+
source;
|
|
60
|
+
constructor(blobId, source) {
|
|
61
|
+
super(`the git object store returned bytes for ${source} (blob ${blobId}) that do not hash to that blob id -- a replace ref, an alternates entry, an overwritten loose object or a crafted pack is substituting the bible; nothing was imported`);
|
|
62
|
+
this.blobId = blobId;
|
|
63
|
+
this.source = source;
|
|
64
|
+
this.name = 'BibleBlobIntegrityError';
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
/** The git blob id of `bytes` in the given object format (40-hex sha1, 64-hex sha256). */
|
|
68
|
+
export function gitBlobId(bytes, format) {
|
|
69
|
+
return createHash(format)
|
|
70
|
+
.update(Buffer.from('blob ' + bytes.length + '\0', 'utf-8'))
|
|
71
|
+
.update(bytes)
|
|
72
|
+
.digest('hex');
|
|
73
|
+
}
|
|
74
|
+
/** True when `bytes` are exactly the blob `id` (format chosen by the id length). */
|
|
75
|
+
export function blobBytesMatchId(id, bytes) {
|
|
76
|
+
if (!OBJECT_ID.test(id))
|
|
77
|
+
return false;
|
|
78
|
+
return gitBlobId(bytes, id.length === 64 ? 'sha256' : 'sha1') === id;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* A git rev the caller may name for the own bible (kb_import `ref`): a ref
|
|
82
|
+
* name or HEAD, never an option (leading '-') and never a rev expression
|
|
83
|
+
* (no ':', '..', '@{', '^', '~', whitespace).
|
|
84
|
+
*/
|
|
85
|
+
export function isSafeBibleRef(ref) {
|
|
86
|
+
return /^[A-Za-z0-9_][A-Za-z0-9._/-]*$/.test(ref) && !ref.includes('..') && !ref.endsWith('/') && !ref.endsWith('.lock');
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* The bible at `rel` (default the own bible, a path relative to `folder`) as
|
|
90
|
+
* committed at `ref` (default HEAD): its blob id and its bytes, read as ONE
|
|
91
|
+
* object (the id is resolved first and the bytes are read by that id, then
|
|
92
|
+
* hashed in-process against it -- see the header). `./` resolves the path
|
|
93
|
+
* against `folder`, which need not be the repository top level. null when
|
|
94
|
+
* there is no committed copy (unresolvable or unsafe ref, unborn HEAD,
|
|
95
|
+
* bible not tracked at that ref, not a work tree, git missing). Throws
|
|
96
|
+
* BibleBlobIntegrityError when the bytes do not hash to the id.
|
|
97
|
+
*/
|
|
98
|
+
export async function readCommittedBibleBlob(folder, ref = 'HEAD', rel = OWN_BIBLE_REL) {
|
|
99
|
+
if (!isSafeBibleRef(ref))
|
|
100
|
+
return null;
|
|
101
|
+
const id = (await git(['rev-parse', '--verify', '--quiet', ref + ':./' + rel], folder))?.trim() ?? '';
|
|
102
|
+
if (!OBJECT_ID.test(id))
|
|
103
|
+
return null;
|
|
104
|
+
const bytes = await gitBuffer(['cat-file', 'blob', id], folder);
|
|
105
|
+
if (bytes === null)
|
|
106
|
+
return null;
|
|
107
|
+
if (!blobBytesMatchId(id, bytes))
|
|
108
|
+
throw new BibleBlobIntegrityError(id, ref + ':' + rel);
|
|
109
|
+
return { blobId: id, text: bytes.toString('utf-8') };
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* The blob id git would store for `bytes` committed unfiltered in the
|
|
113
|
+
* repository containing `folder`, computed in-process (`git hash-object
|
|
114
|
+
* --no-filters` semantics; the object format comes from the repository,
|
|
115
|
+
* sha1 outside one or when git is too old to report it -- such a git reads
|
|
116
|
+
* only sha1 repositories).
|
|
117
|
+
*/
|
|
118
|
+
export async function bibleBytesBlobId(folder, bytes) {
|
|
119
|
+
const fmt = (await git(['rev-parse', '--show-object-format'], folder))?.trim();
|
|
120
|
+
return gitBlobId(bytes, fmt === 'sha256' ? 'sha256' : 'sha1');
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=bible-blob-id.js.map
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
import type { SqliteProvider } from './sqlite-provider.js';
|
|
2
|
+
export type KbBibleErrorCode = 'E-BIBLE-MALFORMED';
|
|
3
|
+
/**
|
|
4
|
+
* A bible file that exists but cannot be read as a bible: invalid JSON, or a
|
|
5
|
+
* shape that is neither the legacy bare array nor the v2 { entries } envelope.
|
|
6
|
+
* Never treated as an empty bible.
|
|
7
|
+
*/
|
|
8
|
+
export declare class KbBibleError extends Error {
|
|
9
|
+
readonly code: KbBibleErrorCode;
|
|
10
|
+
readonly biblePath: string;
|
|
11
|
+
readonly remediation: string;
|
|
12
|
+
constructor(message: string, biblePath: string);
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* An EXPLICIT tombstone in the committed bible: this id was removed from the
|
|
16
|
+
* bible at `at`, for `reason`. Only `reason: 'demoted'` (TOMBSTONE_DEMOTED)
|
|
17
|
+
* lowers a local row on import; every reason keeps the entry out of a bible view
|
|
18
|
+
* and stops kb_export re-adding it. Readers tolerate reason strings they do not
|
|
19
|
+
* know, so new removal reasons can be added without breaking older readers.
|
|
20
|
+
*
|
|
21
|
+
* A removal is NEVER inferred from an entry merely being absent from the bible
|
|
22
|
+
* -- a clone legitimately holds CONFIRMED rows that were never exported
|
|
23
|
+
* (local-only promotions, basis_mismatch refusals), and those must never be
|
|
24
|
+
* demoted by an import.
|
|
25
|
+
*/
|
|
26
|
+
export interface BibleTombstone {
|
|
27
|
+
id: string;
|
|
28
|
+
at: string;
|
|
29
|
+
reason: string;
|
|
30
|
+
}
|
|
31
|
+
/** The tombstone reason a kb_demote produces; the only one that demotes on import. */
|
|
32
|
+
export declare const TOMBSTONE_DEMOTED = "demoted";
|
|
33
|
+
/**
|
|
34
|
+
* A parsed bible: its entries AND its tombstones. The two readers that return
|
|
35
|
+
* entries only (readBibleEntries/parseBibleText here, readBibleEntries in
|
|
36
|
+
* src/tools/kb-export.ts) keep their existing signature and are implemented on
|
|
37
|
+
* top of the document readers, so no existing caller changes shape.
|
|
38
|
+
*/
|
|
39
|
+
export interface BibleDocument {
|
|
40
|
+
entries: unknown[];
|
|
41
|
+
demotions: BibleTombstone[];
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* The tombstones of an already-parsed bible value, in id order and deduped
|
|
45
|
+
* (last wins). Only a v3 envelope may carry them: a legacy bare array or a v2
|
|
46
|
+
* envelope yields none, whatever it holds. Tolerant otherwise: the field is
|
|
47
|
+
* OPTIONAL, and a malformed tombstone is dropped individually rather than
|
|
48
|
+
* failing the whole bible -- exactly how a malformed ENTRY is treated by
|
|
49
|
+
* importBibleEntries below. kb-export.ts's reader calls this too.
|
|
50
|
+
*
|
|
51
|
+
* Each `at` is clamped to `now` (clampBibleTimeToNow): a future-dated tombstone
|
|
52
|
+
* would otherwise become a future demoted_at on import, and every later
|
|
53
|
+
* re-promotion would count as withdrawn against it.
|
|
54
|
+
*/
|
|
55
|
+
export declare function extractBibleDemotions(parsed: unknown, now?: Date): BibleTombstone[];
|
|
56
|
+
/**
|
|
57
|
+
* A bible-carried updated_at, clamped to `now`. A future-dated entry would
|
|
58
|
+
* otherwise outrank every later tombstone under standingAgainstTombstone. An
|
|
59
|
+
* unparseable value is returned unchanged (the standing rule reports it as
|
|
60
|
+
* 'unknown').
|
|
61
|
+
*/
|
|
62
|
+
export declare function clampBibleTimeToNow(time: string, now?: Date): string;
|
|
63
|
+
/**
|
|
64
|
+
* How a local row stands against a tombstone for the same id. The ONE rule both
|
|
65
|
+
* directions use -- kb_import demotes only on 'withdrawn', kb_export re-adds
|
|
66
|
+
* only on 'repromoted', and 'unknown' makes neither act.
|
|
67
|
+
*
|
|
68
|
+
* `trustTime` is the time this clone's trust in the row dates from, AS A BIBLE
|
|
69
|
+
* RECORDS IT (SqliteProvider.getBibleTrustTimes): the local promotion time, else
|
|
70
|
+
* the `updated_at` the bible carried when the row was imported -- never the
|
|
71
|
+
* local import time, which says nothing about when the entry was promoted.
|
|
72
|
+
* - null (a row imported before that time was kept) -> 'withdrawn': its trust
|
|
73
|
+
* came from a bible, and a later bible withdrew it.
|
|
74
|
+
* - strictly after `at` -> 'repromoted': newer evidence than the tombstone.
|
|
75
|
+
* - at or before `at` -> 'withdrawn'.
|
|
76
|
+
* - either time unparseable -> 'unknown'.
|
|
77
|
+
*/
|
|
78
|
+
export type TombstoneStanding = 'repromoted' | 'withdrawn' | 'unknown';
|
|
79
|
+
export declare function standingAgainstTombstone(trustTime: string | null, at: string): TombstoneStanding;
|
|
80
|
+
/** The tombstoned ids of a parsed bible, as a set for membership tests. */
|
|
81
|
+
export declare function tombstonedIds(demotions: BibleTombstone[]): Set<string>;
|
|
82
|
+
/**
|
|
83
|
+
* Drop every entry a tombstone names from a raw bible entry array.
|
|
84
|
+
*
|
|
85
|
+
* For the READ paths that build a view of the bible rather than merging it into
|
|
86
|
+
* an existing KB -- the member bible view, which imports into a FRESH empty
|
|
87
|
+
* in-memory provider. There is no local row there for a tombstone to demote, so
|
|
88
|
+
* the demotion can only be honoured by not listing the entry at all.
|
|
89
|
+
*
|
|
90
|
+
* Normally a committed bible holds no entry for a tombstoned id (kb_bible_commit
|
|
91
|
+
* removes it when it records the tombstone), so this is belt-and-braces against
|
|
92
|
+
* a hand-edited or partially merged bible -- the one place where "the file says
|
|
93
|
+
* both" must resolve to the demotion, because a view that lists a demoted entry
|
|
94
|
+
* is exactly the staleness the tombstone exists to stop.
|
|
95
|
+
*
|
|
96
|
+
* Entries too malformed to carry an id are left alone; importBibleEntries
|
|
97
|
+
* already tolerates and skips those.
|
|
98
|
+
*/
|
|
99
|
+
export declare function excludeTombstonedEntries(entries: unknown[], demotions: BibleTombstone[]): unknown[];
|
|
100
|
+
/**
|
|
101
|
+
* Read and parse a bible file into its raw entry array. Throws KbBibleError
|
|
102
|
+
* when the file is not valid JSON or not a bible shape. `label` prefixes the
|
|
103
|
+
* error message (e.g. 'kb_import'). A missing file surfaces as the fs error;
|
|
104
|
+
* callers decide whether missing is an error (kb_import) or empty (the view).
|
|
105
|
+
*
|
|
106
|
+
* The bible has THREE on-disk shapes and must accept all of them.
|
|
107
|
+
* v1 (legacy): a bare JSON array of entries.
|
|
108
|
+
* v2: { version, provenance: {commit, branch, entry_count}, entries }
|
|
109
|
+
* v3: the v2 envelope; entries may carry source_file_hashes.
|
|
110
|
+
* Selection is on Array.isArray (v2 and v3 share the envelope). The reader
|
|
111
|
+
* must never lag the writer.
|
|
112
|
+
*/
|
|
113
|
+
export declare function readBibleEntries(biblePath: string, label: string): unknown[];
|
|
114
|
+
/** Parse bible text already in memory (e.g. fetched from a remote member). */
|
|
115
|
+
export declare function parseBibleText(raw: string, biblePath: string, label: string): unknown[];
|
|
116
|
+
/** Entries AND tombstones of a bible file. Same parse, same refusals. */
|
|
117
|
+
export declare function readBibleDocument(biblePath: string, label: string): BibleDocument;
|
|
118
|
+
/** Entries AND tombstones of bible text already in memory. */
|
|
119
|
+
export declare function parseBibleDocument(raw: string, biblePath: string, label: string): BibleDocument;
|
|
120
|
+
/**
|
|
121
|
+
* The basis a v3 bible entry carries, or null when it carries none or an
|
|
122
|
+
* invalid one. Valid means: a plain object, at least one key, every key
|
|
123
|
+
* repo-relative (isRepoRelativePath), every value a non-empty string, and
|
|
124
|
+
* every cited source_file present as a key. Anything else gets no verified
|
|
125
|
+
* basis -- never a partial carried map: capture() then stores a LOCAL
|
|
126
|
+
* freshness-only basis that is never exported or used for bible admission.
|
|
127
|
+
*/
|
|
128
|
+
export declare function carriedBasisOf(entry: {
|
|
129
|
+
source_files?: unknown;
|
|
130
|
+
source_file_hashes?: unknown;
|
|
131
|
+
}): Record<string, string> | null;
|
|
132
|
+
export interface BibleImportCounts {
|
|
133
|
+
imported: number;
|
|
134
|
+
skipped: number;
|
|
135
|
+
linked: number;
|
|
136
|
+
flagged: number;
|
|
137
|
+
rejected: number;
|
|
138
|
+
/**
|
|
139
|
+
* Local rows actually taken CONFIRMED -> INFERRED by an explicit demotion
|
|
140
|
+
* tombstone in this bible. A tombstone that named no local row, or one whose
|
|
141
|
+
* row was re-promoted after the demotion, is NOT counted: this is how many
|
|
142
|
+
* rows changed, not how many tombstones were read.
|
|
143
|
+
*/
|
|
144
|
+
demoted: number;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Import raw bible entries into a SqliteProvider through capture()'s INTERNAL
|
|
148
|
+
* import mode: bible confidence preserved for non-directive types, directives
|
|
149
|
+
* quarantined as pending proposals, source='import'. Malformed entries and
|
|
150
|
+
* entries whose id already exists are skipped; entries failing the capture
|
|
151
|
+
* basis check are counted as rejected. No freshness sweep (callers decide).
|
|
152
|
+
*/
|
|
153
|
+
export interface BibleImportOptions {
|
|
154
|
+
/**
|
|
155
|
+
* Load every valid entry verbatim (no AUDN dedupe/update/contradiction):
|
|
156
|
+
* bible id and bible confidence kept exactly. For the member bible view,
|
|
157
|
+
* which must reproduce the reviewed bible rather than re-curate it.
|
|
158
|
+
*/
|
|
159
|
+
verbatim?: boolean;
|
|
160
|
+
/**
|
|
161
|
+
* The EXPLICIT demotion tombstones of the same bible (parseBibleDocument /
|
|
162
|
+
* readBibleDocument return them alongside the entries). Applied AFTER the
|
|
163
|
+
* entry loop, against rows that already existed locally.
|
|
164
|
+
*
|
|
165
|
+
* Omitted (or empty) means "this bible carries no tombstones" -- NOT "demote
|
|
166
|
+
* whatever is missing". Absence is never evidence of demotion: a clone
|
|
167
|
+
* legitimately holds CONFIRMED rows that were never exported, and an import
|
|
168
|
+
* must leave those byte-unchanged.
|
|
169
|
+
*/
|
|
170
|
+
demotions?: BibleTombstone[];
|
|
171
|
+
}
|
|
172
|
+
export declare function importBibleEntries(provider: SqliteProvider, bibleEntries: unknown[], options?: BibleImportOptions): Promise<BibleImportCounts>;
|
|
173
|
+
//# sourceMappingURL=bible-import.d.ts.map
|