@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
|
@@ -10,11 +10,13 @@
|
|
|
10
10
|
import { DatabaseSync } from 'node:sqlite';
|
|
11
11
|
import path from 'node:path';
|
|
12
12
|
import fs from 'node:fs';
|
|
13
|
-
import { randomUUID } from 'node:crypto';
|
|
13
|
+
import { createHash, randomUUID } from 'node:crypto';
|
|
14
14
|
import { FLEET_DIR } from '../../paths.js';
|
|
15
15
|
import { resolveProjectSlug } from './project-slug.js';
|
|
16
16
|
import { makeFtsQuery, makeAudnDecision, orJoinFtsTerms, } from './audn.js';
|
|
17
17
|
import { computeFileHashBatch } from './file-hash.js';
|
|
18
|
+
import { validateFilePaths } from './path-validation.js';
|
|
19
|
+
import { clampBibleTimeToNow, standingAgainstTombstone } from './bible-import.js';
|
|
18
20
|
import { KbCaptureRejected } from './types.js';
|
|
19
21
|
const CONTENT_CAP = 4000;
|
|
20
22
|
const TRUNCATION_SUFFIX = '...[truncated]';
|
|
@@ -32,12 +34,72 @@ const MIN_PROMOTE_REASON_LENGTH = 20;
|
|
|
32
34
|
function isNonTrivialPromoteReason(reason) {
|
|
33
35
|
return (reason ?? '').trim().length >= MIN_PROMOTE_REASON_LENGTH;
|
|
34
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* Minimum length of a kb_demote reason, measured AFTER newlines are collapsed
|
|
39
|
+
* to spaces and the result trimmed. Same floor as kb_promote: withdrawing
|
|
40
|
+
* trust must be as auditable as granting it, and a reason that is only
|
|
41
|
+
* whitespace/newlines collapses to the empty string and is refused.
|
|
42
|
+
*/
|
|
43
|
+
const MIN_DEMOTE_REASON_LENGTH = 20;
|
|
44
|
+
/**
|
|
45
|
+
* The single normalisation applied to a demote reason, used for BOTH the
|
|
46
|
+
* length gate and the note written into content -- so what was validated is
|
|
47
|
+
* exactly what is recorded. Every newline becomes a space (the note must stay
|
|
48
|
+
* one line, and must never be able to grow a second leading newline and so
|
|
49
|
+
* collide with the kb_feedback marker, which is two newlines + "[feedback ").
|
|
50
|
+
*/
|
|
51
|
+
function normalizeDemoteReason(reason) {
|
|
52
|
+
return (reason ?? '').replace(/[\r\n]/g, ' ').trim();
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* The ONE demotion-note format, shared by kb_demote (demote()) and the bible
|
|
56
|
+
* tombstone path (applyBibleDemotion()), so a demotion that crosses clones
|
|
57
|
+
* reads identically to one applied locally.
|
|
58
|
+
*
|
|
59
|
+
* String concatenation (not a template literal) per the ASCII pre-commit hook
|
|
60
|
+
* gotcha: backslash-n escapes inside JS template literals false-positive on the
|
|
61
|
+
* hook's non-ASCII scan (same convention as promote()'s promotionNote and
|
|
62
|
+
* feedback()'s note).
|
|
63
|
+
*
|
|
64
|
+
* EXACTLY ONE leading newline. feedback() writes TWO ('\n\n[feedback ...'), so
|
|
65
|
+
* a demote note can never be mistaken for a feedback marker by anything
|
|
66
|
+
* scanning content for one.
|
|
67
|
+
*/
|
|
68
|
+
function buildDemotionNote(normalizedReason, evidence, author) {
|
|
69
|
+
const evidenceClause = evidence.length > 0 ? ' | evidence: ' + evidence.join(', ') : '';
|
|
70
|
+
return '\n[Demoted: ' + normalizedReason + evidenceClause + ' -- ' + (author || 'unknown') + ']';
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* The reason recorded when a demotion arrives through the committed project
|
|
74
|
+
* bible rather than a local kb_demote. Must clear MIN_DEMOTE_REASON_LENGTH.
|
|
75
|
+
*/
|
|
76
|
+
export const BIBLE_DEMOTION_REASON = 'demoted in the project bible';
|
|
35
77
|
class NotImplementedError extends Error {
|
|
36
78
|
constructor(method) {
|
|
37
79
|
super(`SqliteProvider.${method}() not yet implemented`);
|
|
38
80
|
this.name = 'NotImplementedError';
|
|
39
81
|
}
|
|
40
82
|
}
|
|
83
|
+
// SQL for the opt-in retrieval-trust filters (QueryOptions.confidence /
|
|
84
|
+
// exclude_disputed), shared by query() and relatedClaims() so the direct hits
|
|
85
|
+
// and the graph-expanded claims of one kb_query obey the same rule. An empty
|
|
86
|
+
// or absent filter yields no conditions -- the default-off contract.
|
|
87
|
+
function trustFilterSql(filter) {
|
|
88
|
+
const conditions = [];
|
|
89
|
+
const params = [];
|
|
90
|
+
if (filter?.confidence?.length) {
|
|
91
|
+
conditions.push(`e.confidence IN (${filter.confidence.map(() => '?').join(',')})`);
|
|
92
|
+
params.push(...filter.confidence);
|
|
93
|
+
}
|
|
94
|
+
if (filter?.exclude_disputed) {
|
|
95
|
+
conditions.push('e.flagged_for_review = 0 AND e.contradiction_of IS NULL');
|
|
96
|
+
}
|
|
97
|
+
if (filter?.owner_tag) {
|
|
98
|
+
conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
|
|
99
|
+
params.push(filter.owner_tag);
|
|
100
|
+
}
|
|
101
|
+
return { conditions, params };
|
|
102
|
+
}
|
|
41
103
|
export class SqliteProvider {
|
|
42
104
|
db = null;
|
|
43
105
|
dbPath;
|
|
@@ -64,6 +126,15 @@ export class SqliteProvider {
|
|
|
64
126
|
this.dbPath = path.join(dir, 'kb.sqlite');
|
|
65
127
|
}
|
|
66
128
|
}
|
|
129
|
+
/**
|
|
130
|
+
* Re-anchor after loading. Used only by the remote member bible view: the
|
|
131
|
+
* member's checkout is not on this host, so entries are imported with no
|
|
132
|
+
* anchor (the basis gate cannot check files here), then the remote folder is
|
|
133
|
+
* bound so freshness reads treat the anchor as missing and issue no verdict.
|
|
134
|
+
*/
|
|
135
|
+
bindRepoPath(repoPath) {
|
|
136
|
+
this.repoPath = repoPath;
|
|
137
|
+
}
|
|
67
138
|
async init() {
|
|
68
139
|
if (this.db !== null)
|
|
69
140
|
return;
|
|
@@ -158,6 +229,86 @@ export class SqliteProvider {
|
|
|
158
229
|
this.db.exec("ALTER TABLE entries ADD COLUMN source_file_hashes TEXT NOT NULL DEFAULT '{}'");
|
|
159
230
|
}
|
|
160
231
|
catch { }
|
|
232
|
+
// Why a row was retired (superseded_at set): 'superseded' (a contradiction
|
|
233
|
+
// loser, or replaced by a capture naming it in supersedes) or 'invalidated'
|
|
234
|
+
// (discarded by id through kb_invalidate). superseded_at alone cannot tell
|
|
235
|
+
// the two apart, and kb_bible_commit reports the reason for each bible
|
|
236
|
+
// entry it removes. Internal only: never surfaced on KBEntry. Rows retired
|
|
237
|
+
// before this column existed read NULL and count as 'superseded'.
|
|
238
|
+
try {
|
|
239
|
+
this.db.exec('ALTER TABLE entries ADD COLUMN retired_reason TEXT');
|
|
240
|
+
}
|
|
241
|
+
catch { }
|
|
242
|
+
// Legacy bible import (v1/v2 entry, or a v3 entry without a valid carried
|
|
243
|
+
// map): source_file_hashes then holds THIS clone's file hashes, a
|
|
244
|
+
// freshness-only basis. 1 = that basis feeds staleness checks only and is
|
|
245
|
+
// never exported, never used for bible admission, never used for a
|
|
246
|
+
// mechanical contradiction win (getSourceFileBases / reconcile prefilter
|
|
247
|
+
// read it as no basis). Internal only: never surfaced on KBEntry. Existing
|
|
248
|
+
// rows default to 0.
|
|
249
|
+
try {
|
|
250
|
+
this.db.exec('ALTER TABLE entries ADD COLUMN local_basis_only INTEGER NOT NULL DEFAULT 0');
|
|
251
|
+
}
|
|
252
|
+
catch { }
|
|
253
|
+
// kb_demote (CONFIRMED -> INFERRED): demoted_at records WHEN trust was
|
|
254
|
+
// withdrawn, demoted_basis_hashes the sha256 of each cited source file AS
|
|
255
|
+
// IT WAS ON DISK AT DEMOTE TIME. The second column is deliberately NOT a
|
|
256
|
+
// copy of source_file_hashes (which is the CAPTURE-time basis): the
|
|
257
|
+
// ping-pong guard built on top of it asks "has the tree moved on since we
|
|
258
|
+
// demoted?", and a capture-time copy answers the wrong question, so a file
|
|
259
|
+
// edited between capture and demote would look unchanged forever. Same
|
|
260
|
+
// guarded-ALTER pattern as scope/source_file_hashes above: it runs on a
|
|
261
|
+
// fresh DB (the columns are not in CREATE TABLE) and is a caught no-op on
|
|
262
|
+
// a DB that already has them.
|
|
263
|
+
try {
|
|
264
|
+
this.db.exec('ALTER TABLE entries ADD COLUMN demoted_at TEXT');
|
|
265
|
+
}
|
|
266
|
+
catch { }
|
|
267
|
+
try {
|
|
268
|
+
this.db.exec("ALTER TABLE entries ADD COLUMN demoted_basis_hashes TEXT NOT NULL DEFAULT '{}'");
|
|
269
|
+
}
|
|
270
|
+
catch { }
|
|
271
|
+
// The updated_at a bible carried for an entry this clone imported (capture
|
|
272
|
+
// opts.carriedUpdatedAt): when the exporting clone promoted it. Tombstones
|
|
273
|
+
// are judged against it (getBibleTrustTimes), never against the local
|
|
274
|
+
// import time. Internal only: never surfaced on KBEntry. NULL on every row
|
|
275
|
+
// that was not imported, and on rows imported before the column existed.
|
|
276
|
+
try {
|
|
277
|
+
this.db.exec('ALTER TABLE entries ADD COLUMN bible_updated_at TEXT');
|
|
278
|
+
}
|
|
279
|
+
catch { }
|
|
280
|
+
// kb_import trust anchor: git blob ids of bibles the maintainer side wrote
|
|
281
|
+
// or imported (kb_bible_commit and FULL / kb_maintainer kb_import). A
|
|
282
|
+
// member session without the kb_maintainer grant imports its committed
|
|
283
|
+
// bible only when that bible's blob id is recorded here -- this hub-side
|
|
284
|
+
// database is the one place the member's own checkout cannot write. See
|
|
285
|
+
// services/knowledge/bible-blob-id.ts. Created idempotently; existing DBs
|
|
286
|
+
// start with no rows (a fresh hub is seeded by the maintainer side).
|
|
287
|
+
this.db.exec(`
|
|
288
|
+
CREATE TABLE IF NOT EXISTS trusted_bible_blobs (
|
|
289
|
+
blob_id TEXT PRIMARY KEY,
|
|
290
|
+
source TEXT NOT NULL,
|
|
291
|
+
recorded_at TEXT NOT NULL
|
|
292
|
+
);
|
|
293
|
+
`);
|
|
294
|
+
}
|
|
295
|
+
/**
|
|
296
|
+
* Record `blobId` (a git object id of a bible's bytes) as written or
|
|
297
|
+
* imported by the maintainer side. Idempotent: re-recording keeps the first
|
|
298
|
+
* row. Only trusted callers (kb_bible_commit and kb_import from a FULL or
|
|
299
|
+
* kb_maintainer session) may call this.
|
|
300
|
+
*/
|
|
301
|
+
recordTrustedBibleBlob(blobId, source) {
|
|
302
|
+
this.getDb()
|
|
303
|
+
.prepare('INSERT OR IGNORE INTO trusted_bible_blobs (blob_id, source, recorded_at) VALUES (?, ?, ?)')
|
|
304
|
+
.run(blobId.toLowerCase(), source, new Date().toISOString());
|
|
305
|
+
}
|
|
306
|
+
/** True when `blobId` was recorded by recordTrustedBibleBlob. */
|
|
307
|
+
isTrustedBibleBlob(blobId) {
|
|
308
|
+
const row = this.getDb()
|
|
309
|
+
.prepare('SELECT 1 AS ok FROM trusted_bible_blobs WHERE blob_id = ?')
|
|
310
|
+
.get(blobId.toLowerCase());
|
|
311
|
+
return row !== undefined;
|
|
161
312
|
}
|
|
162
313
|
getDb() {
|
|
163
314
|
if (!this.db)
|
|
@@ -187,11 +338,15 @@ export class SqliteProvider {
|
|
|
187
338
|
created_at: row.created_at,
|
|
188
339
|
superseded_at: row.superseded_at,
|
|
189
340
|
promoted_at: row.promoted_at,
|
|
341
|
+
// kb_demote columns. Tolerant of a row read before the migration ran
|
|
342
|
+
// (undefined) and of a legacy NULL/'' in demoted_basis_hashes.
|
|
343
|
+
demoted_at: row.demoted_at ?? undefined,
|
|
344
|
+
demoted_basis_hashes: JSON.parse(row.demoted_basis_hashes || '{}'),
|
|
190
345
|
use_count: row.use_count,
|
|
191
346
|
last_accessed: row.last_accessed,
|
|
192
347
|
};
|
|
193
348
|
}
|
|
194
|
-
insertEntry(db, id, input, content, now, sourceFileHashes = {}) {
|
|
349
|
+
insertEntry(db, id, input, content, now, sourceFileHashes = {}, localBasisOnly = false) {
|
|
195
350
|
db.prepare(`
|
|
196
351
|
INSERT INTO entries (
|
|
197
352
|
id, type, title, summary, content,
|
|
@@ -199,7 +354,7 @@ export class SqliteProvider {
|
|
|
199
354
|
content_hash, content_hash_type, stale,
|
|
200
355
|
flagged_for_review, contradiction_of,
|
|
201
356
|
author, source, confidence, scope, created_at,
|
|
202
|
-
source_file_hashes,
|
|
357
|
+
source_file_hashes, local_basis_only,
|
|
203
358
|
superseded_at, promoted_at, use_count
|
|
204
359
|
) VALUES (
|
|
205
360
|
?, ?, ?, ?, ?,
|
|
@@ -207,10 +362,10 @@ export class SqliteProvider {
|
|
|
207
362
|
?, ?, ?,
|
|
208
363
|
?, ?,
|
|
209
364
|
?, ?, ?, ?, ?,
|
|
210
|
-
?,
|
|
365
|
+
?, ?,
|
|
211
366
|
NULL, NULL, 0
|
|
212
367
|
)
|
|
213
|
-
`).run(id, input.type, input.title, input.summary, content, JSON.stringify(input.source_files ?? []), JSON.stringify(input.symbols ?? []), input.module ?? null, JSON.stringify(input.tags ?? []), input.content_hash ?? '', input.content_hash_type ?? 'sha256', 0, input.flagged_for_review ? 1 : 0, input.contradiction_of ?? null, input.author ?? '', input.source, input.confidence, input.scope ?? 'project', now, JSON.stringify(sourceFileHashes));
|
|
368
|
+
`).run(id, input.type, input.title, input.summary, content, JSON.stringify(input.source_files ?? []), JSON.stringify(input.symbols ?? []), input.module ?? null, JSON.stringify(input.tags ?? []), input.content_hash ?? '', input.content_hash_type ?? 'sha256', 0, input.flagged_for_review ? 1 : 0, input.contradiction_of ?? null, input.author ?? '', input.source, input.confidence, input.scope ?? 'project', now, JSON.stringify(sourceFileHashes), localBasisOnly ? 1 : 0);
|
|
214
369
|
}
|
|
215
370
|
/**
|
|
216
371
|
* Resolve a source_files entry for existence checking. Absolute paths pass
|
|
@@ -286,13 +441,21 @@ export class SqliteProvider {
|
|
|
286
441
|
// absent from the returned map (not an error). Bounded to the caller's own
|
|
287
442
|
// source_files list. Non-fatal: any hashing error yields an empty basis
|
|
288
443
|
// rather than failing the capture.
|
|
444
|
+
/**
|
|
445
|
+
* The ONLY way this provider hashes source files: relative paths anchor at
|
|
446
|
+
* the provider repo (never process.cwd()) when one is set. Every call site
|
|
447
|
+
* goes through here so a new call cannot forget the anchor.
|
|
448
|
+
*/
|
|
449
|
+
hashAnchored(files, anchor = this.repoPath) {
|
|
450
|
+
return computeFileHashBatch(files, anchor !== undefined ? { cwd: anchor } : undefined);
|
|
451
|
+
}
|
|
289
452
|
async computeSourceFileHashes(files) {
|
|
290
453
|
if (files.length === 0)
|
|
291
454
|
return {};
|
|
292
455
|
try {
|
|
293
456
|
// Anchor relative basis paths at this provider's repo, the same root the
|
|
294
457
|
// capture gate checked them against and the one freshnessSweep(root) uses.
|
|
295
|
-
const hashes = await
|
|
458
|
+
const hashes = await this.hashAnchored(files);
|
|
296
459
|
const map = {};
|
|
297
460
|
for (const file of Object.keys(hashes)) {
|
|
298
461
|
const result = hashes[file];
|
|
@@ -380,6 +543,137 @@ export class SqliteProvider {
|
|
|
380
543
|
return null;
|
|
381
544
|
}
|
|
382
545
|
}
|
|
546
|
+
/**
|
|
547
|
+
* Read-only accessor for the stored per-file hash basis (source_file_hashes)
|
|
548
|
+
* of the given entry ids. Each requested id maps to its parsed basis, or null
|
|
549
|
+
* when the basis is empty/unparseable or the id is unknown. Used by kb_export's
|
|
550
|
+
* project-scope bible filter and kb_bible_commit admission; internal to this
|
|
551
|
+
* provider, not an MCP surface. A local freshness-only basis
|
|
552
|
+
* (local_basis_only = 1, a legacy bible import) maps to null: it was hashed
|
|
553
|
+
* from this clone, never verified, so it must never be exported or admit an
|
|
554
|
+
* entry to the bible.
|
|
555
|
+
*/
|
|
556
|
+
getSourceFileBases(ids) {
|
|
557
|
+
const out = new Map();
|
|
558
|
+
for (const id of ids)
|
|
559
|
+
out.set(id, null);
|
|
560
|
+
if (ids.length === 0)
|
|
561
|
+
return out;
|
|
562
|
+
const db = this.getDb();
|
|
563
|
+
// Chunk to stay well under SQLite's bound-parameter limit.
|
|
564
|
+
const CHUNK = 500;
|
|
565
|
+
for (let i = 0; i < ids.length; i += CHUNK) {
|
|
566
|
+
const chunk = ids.slice(i, i + CHUNK);
|
|
567
|
+
const rows = db.prepare(`SELECT id, source_file_hashes, local_basis_only FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
|
|
568
|
+
for (const row of rows)
|
|
569
|
+
out.set(row.id, row.local_basis_only ? null : this.parseBasis(row.source_file_hashes));
|
|
570
|
+
}
|
|
571
|
+
return out;
|
|
572
|
+
}
|
|
573
|
+
/**
|
|
574
|
+
* The bible trust time of each given id that exists: when this clone's trust
|
|
575
|
+
* in the row dates from, as a bible records it. promoted_at when the row was
|
|
576
|
+
* promoted here; else the updated_at the bible carried when the row was
|
|
577
|
+
* imported (bible_updated_at); else null for an imported row from before that
|
|
578
|
+
* column existed -- its trust came from a bible, and the local import time
|
|
579
|
+
* says nothing about when it was promoted. Any other row falls back to
|
|
580
|
+
* created_at. An unknown id is absent from the map. Fed to
|
|
581
|
+
* standingAgainstTombstone (bible-import.ts) by kb_export, and used for the
|
|
582
|
+
* updated_at a bible writer records, so every clone compares the same value.
|
|
583
|
+
* Internal to this provider, not an MCP surface.
|
|
584
|
+
*/
|
|
585
|
+
getBibleTrustTimes(ids) {
|
|
586
|
+
const out = new Map();
|
|
587
|
+
if (ids.length === 0)
|
|
588
|
+
return out;
|
|
589
|
+
const db = this.getDb();
|
|
590
|
+
// Chunk to stay well under SQLite's bound-parameter limit (as above).
|
|
591
|
+
const CHUNK = 500;
|
|
592
|
+
for (let i = 0; i < ids.length; i += CHUNK) {
|
|
593
|
+
const chunk = ids.slice(i, i + CHUNK);
|
|
594
|
+
const rows = db.prepare(`SELECT id, promoted_at, bible_updated_at, source, created_at FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
|
|
595
|
+
for (const row of rows)
|
|
596
|
+
out.set(row.id, this.bibleTrustTimeOf(row));
|
|
597
|
+
}
|
|
598
|
+
return out;
|
|
599
|
+
}
|
|
600
|
+
/** getBibleTrustTimes' rule for one raw row (needs promoted_at, bible_updated_at, source, created_at). */
|
|
601
|
+
bibleTrustTimeOf(row) {
|
|
602
|
+
if (typeof row.promoted_at === 'string')
|
|
603
|
+
return row.promoted_at;
|
|
604
|
+
if (typeof row.bible_updated_at === 'string')
|
|
605
|
+
return row.bible_updated_at;
|
|
606
|
+
if (row.source === 'import')
|
|
607
|
+
return null;
|
|
608
|
+
return typeof row.created_at === 'string' ? row.created_at : null;
|
|
609
|
+
}
|
|
610
|
+
/**
|
|
611
|
+
* Read-only accessor for the demotion state of the given entry ids: the
|
|
612
|
+
* CURRENT confidence and demoted_at of each id that exists. An unknown id is
|
|
613
|
+
* simply absent from the map.
|
|
614
|
+
*
|
|
615
|
+
* Deliberately NOT routed through list(): list() excludes stale and superseded
|
|
616
|
+
* rows, and a demoted entry that later went stale is exactly the one whose
|
|
617
|
+
* tombstone other clones most need -- their bible still carries the entry.
|
|
618
|
+
* Policy (what counts as demoted enough to tombstone) lives in the caller
|
|
619
|
+
* (src/tools/kb-bible-commit.ts); this member only reports the two columns.
|
|
620
|
+
* Internal to this provider, not an MCP surface.
|
|
621
|
+
*/
|
|
622
|
+
getDemotionState(ids) {
|
|
623
|
+
const out = new Map();
|
|
624
|
+
if (ids.length === 0)
|
|
625
|
+
return out;
|
|
626
|
+
const db = this.getDb();
|
|
627
|
+
// Chunk to stay well under SQLite's bound-parameter limit (as above).
|
|
628
|
+
const CHUNK = 500;
|
|
629
|
+
for (let i = 0; i < ids.length; i += CHUNK) {
|
|
630
|
+
const chunk = ids.slice(i, i + CHUNK);
|
|
631
|
+
const rows = db.prepare(`SELECT id, confidence, demoted_at FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
|
|
632
|
+
for (const row of rows) {
|
|
633
|
+
out.set(row.id, {
|
|
634
|
+
confidence: row.confidence,
|
|
635
|
+
demoted_at: row.demoted_at ?? undefined,
|
|
636
|
+
});
|
|
637
|
+
}
|
|
638
|
+
}
|
|
639
|
+
return out;
|
|
640
|
+
}
|
|
641
|
+
/**
|
|
642
|
+
* For each of the given ids that EXISTS locally, whether that row is LIVE
|
|
643
|
+
* CONFIRMED: confidence is CONFIRMED and the row is not stale, not superseded
|
|
644
|
+
* and not flagged_for_review.
|
|
645
|
+
*
|
|
646
|
+
* An id with NO local row is simply ABSENT from the map -- the caller must be
|
|
647
|
+
* able to tell "I hold a row and it is no longer trustworthy" (do not surface
|
|
648
|
+
* the bible's version of it) from "I have never seen this id" (the cold-seed
|
|
649
|
+
* case the bible exists to serve). A boolean-only return would conflate them.
|
|
650
|
+
*
|
|
651
|
+
* ONE predicate, deliberately not a demoted_at check. A demotion is only one
|
|
652
|
+
* of the ways a row stops being live CONFIRMED; staleness, supersession and a
|
|
653
|
+
* review flag are the others, and a cold seed that re-surfaced the bible's
|
|
654
|
+
* CONFIRMED copy of any of them would be re-asserting knowledge this clone has
|
|
655
|
+
* already stopped trusting. Reads the rows DIRECTLY rather than through list(),
|
|
656
|
+
* which filters stale and superseded rows out and so cannot report them.
|
|
657
|
+
*/
|
|
658
|
+
getLiveConfirmedState(ids) {
|
|
659
|
+
const out = new Map();
|
|
660
|
+
if (ids.length === 0)
|
|
661
|
+
return out;
|
|
662
|
+
const db = this.getDb();
|
|
663
|
+
// Chunk to stay well under SQLite's bound-parameter limit (as above).
|
|
664
|
+
const CHUNK = 500;
|
|
665
|
+
for (let i = 0; i < ids.length; i += CHUNK) {
|
|
666
|
+
const chunk = ids.slice(i, i + CHUNK);
|
|
667
|
+
const rows = db.prepare(`SELECT id, confidence, stale, superseded_at, flagged_for_review FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
|
|
668
|
+
for (const row of rows) {
|
|
669
|
+
out.set(row.id, row.confidence === 'CONFIRMED'
|
|
670
|
+
&& row.stale !== 1
|
|
671
|
+
&& row.superseded_at === null
|
|
672
|
+
&& row.flagged_for_review !== 1);
|
|
673
|
+
}
|
|
674
|
+
}
|
|
675
|
+
return out;
|
|
676
|
+
}
|
|
383
677
|
// T1.3 (F2/D2 HARDENED): freshness check bounded to the primed set, now
|
|
384
678
|
// BIDIRECTIONAL. Keyed off source_files with a per-file hash basis persisted
|
|
385
679
|
// at capture time (source_file_hashes) -- NOT content_hash, which is only ever
|
|
@@ -429,7 +723,7 @@ export class SqliteProvider {
|
|
|
429
723
|
// whenever the process cwd is not the repo -- which is the normal case in
|
|
430
724
|
// the long-lived fleet server -- so every relative basis path would re-hash
|
|
431
725
|
// to a different value and prime would stale healthy entries on sight.
|
|
432
|
-
const currentHashes = await
|
|
726
|
+
const currentHashes = await this.hashAnchored([...fileSet]);
|
|
433
727
|
const staleIds = [];
|
|
434
728
|
const unstaleIds = [];
|
|
435
729
|
for (const [id, basis] of basisById) {
|
|
@@ -514,7 +808,7 @@ export class SqliteProvider {
|
|
|
514
808
|
for (const file of Object.keys(basis))
|
|
515
809
|
fileSet.add(file);
|
|
516
810
|
}
|
|
517
|
-
const currentHashes = await
|
|
811
|
+
const currentHashes = await this.hashAnchored([...fileSet], anchor || undefined);
|
|
518
812
|
const staleIds = [];
|
|
519
813
|
const unstaleIds = [];
|
|
520
814
|
let checked = 0;
|
|
@@ -569,7 +863,7 @@ export class SqliteProvider {
|
|
|
569
863
|
return [];
|
|
570
864
|
}
|
|
571
865
|
}
|
|
572
|
-
evaluateAudn(db, input, candidates, newContent, now, sourceFileHashes) {
|
|
866
|
+
evaluateAudn(db, input, candidates, newContent, now, sourceFileHashes, localBasisOnly = false, keepConfirmed = false) {
|
|
573
867
|
const decision = makeAudnDecision(input, candidates, newContent);
|
|
574
868
|
if (!decision)
|
|
575
869
|
return null;
|
|
@@ -579,13 +873,20 @@ export class SqliteProvider {
|
|
|
579
873
|
if (decision.decision === 'flagged') {
|
|
580
874
|
db.prepare('UPDATE entries SET flagged_for_review = 1 WHERE id = ?').run(decision.matchedId);
|
|
581
875
|
const newId = randomUUID();
|
|
582
|
-
this.insertEntry(db, newId, { ...input, ...decision.newEntryOverrides }, newContent, now, sourceFileHashes);
|
|
876
|
+
this.insertEntry(db, newId, { ...input, ...decision.newEntryOverrides }, newContent, now, sourceFileHashes, localBasisOnly);
|
|
583
877
|
this.wireLinks(db, newId, input);
|
|
584
878
|
return { id: newId, audn_decision: 'flagged' };
|
|
585
879
|
}
|
|
586
880
|
if (decision.decision === 'update') {
|
|
587
881
|
const newId = randomUUID();
|
|
588
|
-
|
|
882
|
+
// keepConfirmed (a member session without the kb_maintainer grant): a
|
|
883
|
+
// CONFIRMED target is never retired by supersedes -- retiring it would
|
|
884
|
+
// remove it from the bible at the next kb_bible_commit. The capture
|
|
885
|
+
// takes the IMPLICIT path below instead (both live, 'refines' link) and
|
|
886
|
+
// the target id is reported, mirroring kb_invalidate's keepConfirmed.
|
|
887
|
+
const target = candidates.find(c => c.id === decision.matchedId);
|
|
888
|
+
const supersedeRefused = keepConfirmed && input.supersedes === decision.matchedId && target?.confidence === 'CONFIRMED';
|
|
889
|
+
if (input.supersedes === decision.matchedId && !supersedeRefused) {
|
|
589
890
|
// EXPLICIT: the caller named what it replaces and AUDN independently
|
|
590
891
|
// matched it. Retire it exactly as before -- superseded_at + stale = 1.
|
|
591
892
|
// D2 (F2a): both flags are required so the old row is excluded from
|
|
@@ -594,9 +895,9 @@ export class SqliteProvider {
|
|
|
594
895
|
// flagged_for_review is deliberately NOT cleared here; that is
|
|
595
896
|
// resolveContradiction's behavior, and kb-review.md depends on the
|
|
596
897
|
// difference (a kept entry stays listed under flagged_only).
|
|
597
|
-
db.prepare(
|
|
898
|
+
db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, retired_reason = 'superseded' WHERE id = ?")
|
|
598
899
|
.run(now, decision.matchedId);
|
|
599
|
-
this.insertEntry(db, newId, input, newContent, now, sourceFileHashes);
|
|
900
|
+
this.insertEntry(db, newId, input, newContent, now, sourceFileHashes, localBasisOnly);
|
|
600
901
|
this.wireLinks(db, newId, input);
|
|
601
902
|
return { id: newId, audn_decision: 'update' };
|
|
602
903
|
}
|
|
@@ -604,10 +905,12 @@ export class SqliteProvider {
|
|
|
604
905
|
// That is a topicality signal, not consent to destroy -- two DISTINCT
|
|
605
906
|
// facts about one symbol used to eat each other. Link and keep both;
|
|
606
907
|
// curation retires what it means to retire, explicitly.
|
|
607
|
-
this.insertEntry(db, newId, input, newContent, now, sourceFileHashes);
|
|
908
|
+
this.insertEntry(db, newId, input, newContent, now, sourceFileHashes, localBasisOnly);
|
|
608
909
|
this.wireLinks(db, newId, input);
|
|
609
910
|
db.prepare('INSERT OR IGNORE INTO links (from_id, to_id, link_type) VALUES (?, ?, ?)').run(newId, decision.matchedId, 'refines');
|
|
610
|
-
return
|
|
911
|
+
return supersedeRefused
|
|
912
|
+
? { id: newId, audn_decision: 'update', refused: [decision.matchedId] }
|
|
913
|
+
: { id: newId, audn_decision: 'update' };
|
|
611
914
|
}
|
|
612
915
|
return null;
|
|
613
916
|
}
|
|
@@ -764,10 +1067,28 @@ export class SqliteProvider {
|
|
|
764
1067
|
// T2.2 (F3 PART A): capture() is the single choke point every caller
|
|
765
1068
|
// (kb_capture, kb_harvest, future paths) goes through, so every entry
|
|
766
1069
|
// gets a hash basis here regardless of type.
|
|
767
|
-
|
|
768
|
-
|
|
1070
|
+
//
|
|
1071
|
+
// Bible format v3: an IMPORT carrying a basis (opts.carriedBasis, honoured
|
|
1072
|
+
// only under importMode, which no deserialized route can set) stores that
|
|
1073
|
+
// map verbatim instead -- the basis the entry was verified against on the
|
|
1074
|
+
// exporting clone. carriedBasis null (a v1/v2 entry, or an invalid carried
|
|
1075
|
+
// map) hashes this clone's files into a LOCAL freshness-only basis
|
|
1076
|
+
// (local_basis_only = 1): it lets the entry go stale when code drifts, but
|
|
1077
|
+
// is never exported, never admits it to the bible and never wins a
|
|
1078
|
+
// contradiction mechanically. Normal captures are unaffected.
|
|
1079
|
+
const carried = opts?.importMode === true && opts.carriedBasis !== undefined;
|
|
1080
|
+
const localBasisOnly = carried && opts?.carriedBasis === null;
|
|
1081
|
+
const sourceFileHashes = carried && !localBasisOnly
|
|
1082
|
+
? { ...(opts?.carriedBasis ?? {}) }
|
|
1083
|
+
: await this.computeSourceFileHashes(input.source_files ?? []);
|
|
1084
|
+
// Verbatim (member bible view): the bible was reviewed and merged as a
|
|
1085
|
+
// whole; AUDN against its own sibling entries would flag, re-id and
|
|
1086
|
+
// demote them (a contradiction keyword in one summary disputes another
|
|
1087
|
+
// CONFIRMED entry). Skip AUDN and keep the bible id.
|
|
1088
|
+
const verbatim = opts?.verbatim === true && opts.importMode === true && opts.preferredId !== undefined;
|
|
1089
|
+
const candidates = verbatim ? [] : this.findAudnCandidates(db, input);
|
|
769
1090
|
if (candidates.length > 0) {
|
|
770
|
-
const result = this.evaluateAudn(db, input, candidates, content, now, sourceFileHashes);
|
|
1091
|
+
const result = this.evaluateAudn(db, input, candidates, content, now, sourceFileHashes, localBasisOnly, opts?.keepConfirmed === true);
|
|
771
1092
|
if (result)
|
|
772
1093
|
return result;
|
|
773
1094
|
}
|
|
@@ -778,7 +1099,10 @@ export class SqliteProvider {
|
|
|
778
1099
|
// always mint a fresh randomUUID -- an id collision with different content is
|
|
779
1100
|
// resolved by AUDN under a new id, never by overwriting the preserved id.
|
|
780
1101
|
const id = opts?.preferredId ?? randomUUID();
|
|
781
|
-
this.insertEntry(db, id, input, content, now, sourceFileHashes);
|
|
1102
|
+
this.insertEntry(db, id, input, content, now, sourceFileHashes, localBasisOnly);
|
|
1103
|
+
if (opts?.importMode === true && opts.carriedUpdatedAt !== undefined) {
|
|
1104
|
+
db.prepare('UPDATE entries SET bible_updated_at = ? WHERE id = ?').run(opts.carriedUpdatedAt, id);
|
|
1105
|
+
}
|
|
782
1106
|
this.wireLinks(db, id, input);
|
|
783
1107
|
return { id, audn_decision: 'add' };
|
|
784
1108
|
}
|
|
@@ -858,6 +1182,11 @@ export class SqliteProvider {
|
|
|
858
1182
|
conditions.push('(e.flagged_for_review = 1 OR e.contradiction_of IS NOT NULL)');
|
|
859
1183
|
}
|
|
860
1184
|
else {
|
|
1185
|
+
// Retrieval-trust filters (opt-in). Not applied to flagged_only, whose
|
|
1186
|
+
// whole purpose is listing the disputed entries these would drop.
|
|
1187
|
+
const trust = trustFilterSql(opts);
|
|
1188
|
+
conditions.push(...trust.conditions);
|
|
1189
|
+
params.push(...trust.params);
|
|
861
1190
|
// H2 (F1, D1, closes yashr-9ha): default retrieval NEVER surfaces a
|
|
862
1191
|
// pending or rejected directive PROPOSAL (type='user-directive' with
|
|
863
1192
|
// confidence != 'CONFIRMED'). Only an ACTIVE (CONFIRMED) directive
|
|
@@ -913,24 +1242,32 @@ export class SqliteProvider {
|
|
|
913
1242
|
}
|
|
914
1243
|
return { results, total: results.length, l1_only: opts.l1_only ?? false };
|
|
915
1244
|
}
|
|
916
|
-
async context(files) {
|
|
1245
|
+
async context(files, confidence, excludeDisputed, ownerTag) {
|
|
917
1246
|
const db = this.getDb();
|
|
918
1247
|
const results = [];
|
|
1248
|
+
const confClause = (confidence?.length
|
|
1249
|
+
? `AND confidence IN (${confidence.map(() => '?').join(',')})`
|
|
1250
|
+
: '') + (excludeDisputed ? ' AND flagged_for_review = 0 AND contradiction_of IS NULL' : '')
|
|
1251
|
+
+ (ownerTag ? ' AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)' : '');
|
|
1252
|
+
const confParams = confidence?.length ? [...confidence] : [];
|
|
1253
|
+
if (ownerTag)
|
|
1254
|
+
confParams.push(ownerTag);
|
|
919
1255
|
const fileEntries = new Map();
|
|
920
1256
|
for (const file of files) {
|
|
921
1257
|
const rows = db.prepare(`
|
|
922
1258
|
SELECT * FROM entries
|
|
923
1259
|
WHERE type = 'context-cache'
|
|
924
1260
|
AND superseded_at IS NULL
|
|
1261
|
+
${confClause}
|
|
925
1262
|
AND EXISTS (SELECT 1 FROM json_each(source_files) WHERE value = ?)
|
|
926
1263
|
ORDER BY created_at DESC
|
|
927
1264
|
LIMIT 1
|
|
928
|
-
`).all(file);
|
|
1265
|
+
`).all(...confParams, file);
|
|
929
1266
|
if (rows.length > 0) {
|
|
930
1267
|
fileEntries.set(file, this.rowToEntry(rows[0]));
|
|
931
1268
|
}
|
|
932
1269
|
}
|
|
933
|
-
const hashes = await
|
|
1270
|
+
const hashes = await this.hashAnchored(files);
|
|
934
1271
|
for (const file of files) {
|
|
935
1272
|
const entry = fileEntries.get(file);
|
|
936
1273
|
if (!entry) {
|
|
@@ -961,18 +1298,89 @@ export class SqliteProvider {
|
|
|
961
1298
|
}
|
|
962
1299
|
return results;
|
|
963
1300
|
}
|
|
964
|
-
async
|
|
1301
|
+
async discard(ids, opts) {
|
|
1302
|
+
const db = this.getDb();
|
|
1303
|
+
const result = { discarded: [], not_found: [], already_discarded: [] };
|
|
1304
|
+
if (opts?.keepConfirmed)
|
|
1305
|
+
result.refused = [];
|
|
1306
|
+
const now = new Date().toISOString();
|
|
1307
|
+
for (const id of new Set(ids)) {
|
|
1308
|
+
const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
|
|
1309
|
+
// An entry outside the caller's own scope is indistinguishable from an unknown id.
|
|
1310
|
+
if (!row || (opts?.ownerTag && !this.rowToEntry(row).tags.includes(opts.ownerTag))) {
|
|
1311
|
+
result.not_found.push(id);
|
|
1312
|
+
continue;
|
|
1313
|
+
}
|
|
1314
|
+
if (row.superseded_at) {
|
|
1315
|
+
result.already_discarded.push(id);
|
|
1316
|
+
continue;
|
|
1317
|
+
}
|
|
1318
|
+
// A member session without the kb_maintainer grant may not retire a
|
|
1319
|
+
// CONFIRMED entry: a discarded row is removed from the bible at the next
|
|
1320
|
+
// kb_bible_commit, so this would be a bible removal without the grant.
|
|
1321
|
+
if (opts?.keepConfirmed && row.confidence === 'CONFIRMED') {
|
|
1322
|
+
result.refused.push(id);
|
|
1323
|
+
continue;
|
|
1324
|
+
}
|
|
1325
|
+
db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, retired_reason = 'invalidated' WHERE id = ?").run(now, id);
|
|
1326
|
+
result.discarded.push(id);
|
|
1327
|
+
}
|
|
1328
|
+
return result;
|
|
1329
|
+
}
|
|
1330
|
+
/**
|
|
1331
|
+
* For each id this KB holds as RETIRED, why: 'superseded' or 'invalidated'.
|
|
1332
|
+
* Ids that are unknown, or known and not retired, are absent from the map.
|
|
1333
|
+
*
|
|
1334
|
+
* Retired means superseded_at is set (reason from retired_reason; NULL, a
|
|
1335
|
+
* row retired before that column existed, counts as 'superseded'), or
|
|
1336
|
+
* content_hash = 'invalidated' (kb_invalidate by file) -> 'invalidated'.
|
|
1337
|
+
*
|
|
1338
|
+
* A merely STALE row (stale = 1 from the freshness sweep, superseded_at
|
|
1339
|
+
* NULL, content_hash not 'invalidated') is NOT retired: staleness means the
|
|
1340
|
+
* cited files moved, which the next capture or sweep can clear, while
|
|
1341
|
+
* superseded and invalidated are explicit curation decisions. Only those two
|
|
1342
|
+
* remove an entry from the bible (kb_bible_commit).
|
|
1343
|
+
*/
|
|
1344
|
+
getRetirementReasons(ids) {
|
|
1345
|
+
const db = this.getDb();
|
|
1346
|
+
const out = new Map();
|
|
1347
|
+
const stmt = db.prepare('SELECT superseded_at, retired_reason, content_hash FROM entries WHERE id = ?');
|
|
1348
|
+
for (const id of new Set(ids)) {
|
|
1349
|
+
const row = stmt.get(id);
|
|
1350
|
+
if (!row)
|
|
1351
|
+
continue;
|
|
1352
|
+
if (row.superseded_at)
|
|
1353
|
+
out.set(id, row.retired_reason === 'invalidated' ? 'invalidated' : 'superseded');
|
|
1354
|
+
else if (row.content_hash === 'invalidated')
|
|
1355
|
+
out.set(id, 'invalidated');
|
|
1356
|
+
}
|
|
1357
|
+
return out;
|
|
1358
|
+
}
|
|
1359
|
+
async invalidate(files, opts) {
|
|
965
1360
|
const db = this.getDb();
|
|
966
1361
|
let invalidated = 0;
|
|
1362
|
+
// keepConfirmed: CONFIRMED rows are left untouched and reported (a
|
|
1363
|
+
// file-invalidated row is retired, and so removed from the bible by the
|
|
1364
|
+
// next kb_bible_commit -- see getRetirementReasons).
|
|
1365
|
+
const refused = new Set();
|
|
1366
|
+
// MEMBER own-scope: only entries carrying the caller's member tag.
|
|
1367
|
+
const ownerClause = opts?.ownerTag ? 'AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)' : '';
|
|
1368
|
+
const ownerParams = opts?.ownerTag ? [opts.ownerTag] : [];
|
|
967
1369
|
for (const file of files) {
|
|
968
|
-
const
|
|
969
|
-
SELECT id FROM entries
|
|
1370
|
+
const candidates = db.prepare(`
|
|
1371
|
+
SELECT id, confidence FROM entries
|
|
970
1372
|
WHERE type = 'context-cache'
|
|
971
1373
|
AND superseded_at IS NULL
|
|
1374
|
+
${ownerClause}
|
|
972
1375
|
AND EXISTS (
|
|
973
1376
|
SELECT 1 FROM json_each(source_files) WHERE value = ?
|
|
974
1377
|
)
|
|
975
|
-
`).all(file);
|
|
1378
|
+
`).all(...ownerParams, file);
|
|
1379
|
+
const rows = opts?.keepConfirmed ? candidates.filter(r => r.confidence !== 'CONFIRMED') : candidates;
|
|
1380
|
+
if (opts?.keepConfirmed)
|
|
1381
|
+
for (const r of candidates)
|
|
1382
|
+
if (r.confidence === 'CONFIRMED')
|
|
1383
|
+
refused.add(r.id);
|
|
976
1384
|
if (rows.length > 0) {
|
|
977
1385
|
const ids = rows.map(r => r.id);
|
|
978
1386
|
db.prepare(`
|
|
@@ -983,7 +1391,7 @@ export class SqliteProvider {
|
|
|
983
1391
|
invalidated += ids.length;
|
|
984
1392
|
}
|
|
985
1393
|
}
|
|
986
|
-
return { invalidated };
|
|
1394
|
+
return opts?.keepConfirmed ? { invalidated, refused: [...refused] } : { invalidated };
|
|
987
1395
|
}
|
|
988
1396
|
async getLinked(id) {
|
|
989
1397
|
const db = this.getDb();
|
|
@@ -1013,14 +1421,21 @@ export class SqliteProvider {
|
|
|
1013
1421
|
//
|
|
1014
1422
|
// Superseded rows are excluded (they are already retired) and the input ids are
|
|
1015
1423
|
// never echoed back. `limit` caps the total, since this rides into a prompt.
|
|
1016
|
-
|
|
1424
|
+
//
|
|
1425
|
+
// `filter` (optional) applies the same retrieval-trust filters kb_query's
|
|
1426
|
+
// direct hits use, so a CONFIRMED-only caller cannot be handed an INFERRED or
|
|
1427
|
+
// disputed claim through the graph instead.
|
|
1428
|
+
async relatedClaims(ids, limit = 5, filter) {
|
|
1017
1429
|
if (ids.length === 0)
|
|
1018
1430
|
return [];
|
|
1019
1431
|
const db = this.getDb();
|
|
1020
1432
|
const ph = ids.map(() => '?').join(',');
|
|
1433
|
+
const trust = trustFilterSql(filter);
|
|
1434
|
+
const trustWhere = trust.conditions.map(c => `AND ${c}`).join(' ');
|
|
1021
1435
|
const rows = db.prepare(`
|
|
1022
1436
|
SELECT DISTINCT e.* FROM entries e
|
|
1023
1437
|
WHERE e.superseded_at IS NULL
|
|
1438
|
+
${trustWhere}
|
|
1024
1439
|
AND e.id NOT IN (${ph})
|
|
1025
1440
|
AND (
|
|
1026
1441
|
EXISTS (
|
|
@@ -1033,13 +1448,13 @@ export class SqliteProvider {
|
|
|
1033
1448
|
OR e.id IN (SELECT contradiction_of FROM entries WHERE id IN (${ph}) AND contradiction_of IS NOT NULL)
|
|
1034
1449
|
)
|
|
1035
1450
|
LIMIT ?
|
|
1036
|
-
`).all(...ids, ...ids, ...ids, ...ids, ...ids, limit);
|
|
1451
|
+
`).all(...trust.params, ...ids, ...ids, ...ids, ...ids, ...ids, limit);
|
|
1037
1452
|
return rows.map(r => this.rowToEntry(r));
|
|
1038
1453
|
}
|
|
1039
1454
|
async prime(opts) {
|
|
1040
1455
|
this.decayConceptEntries(this.getDb(), opts.decay_after_days ?? 30);
|
|
1041
1456
|
const fileResults = opts.session_files?.length
|
|
1042
|
-
? await this.context(opts.session_files)
|
|
1457
|
+
? await this.context(opts.session_files, opts.confidence, opts.exclude_disputed, opts.owner_tag)
|
|
1043
1458
|
: [];
|
|
1044
1459
|
const stale_files = fileResults
|
|
1045
1460
|
.filter(r => r.status === 'stale' || r.status === 'missing')
|
|
@@ -1065,6 +1480,9 @@ export class SqliteProvider {
|
|
|
1065
1480
|
l1_only: true,
|
|
1066
1481
|
limit: 10,
|
|
1067
1482
|
include_stale: false,
|
|
1483
|
+
confidence: opts.confidence,
|
|
1484
|
+
exclude_disputed: opts.exclude_disputed,
|
|
1485
|
+
owner_tag: opts.owner_tag,
|
|
1068
1486
|
});
|
|
1069
1487
|
top_entries = l1.results
|
|
1070
1488
|
.filter(e => e.type !== 'context-cache')
|
|
@@ -1118,15 +1536,21 @@ export class SqliteProvider {
|
|
|
1118
1536
|
// CONFIRMED set what we think it is") which should not perturb that
|
|
1119
1537
|
// telemetry. A dedicated method keeps the two contracts textually distinct
|
|
1120
1538
|
// instead of an easy-to-miss opt-out flag threaded through query(). Always
|
|
1121
|
-
// excludes superseded and stale
|
|
1122
|
-
// audit-the-live-set tool, not a
|
|
1539
|
+
// excludes superseded entries, and stale ones unless include_stale is set
|
|
1540
|
+
// (kb_list never sets it -- it is an audit-the-live-set tool, not a
|
|
1541
|
+
// full-history query; the kb-server ownership lookup does).
|
|
1123
1542
|
async list(opts) {
|
|
1124
1543
|
const db = this.getDb();
|
|
1125
|
-
const conditions = ['e.superseded_at IS NULL'
|
|
1544
|
+
const conditions = ['e.superseded_at IS NULL'];
|
|
1545
|
+
if (!opts.include_stale)
|
|
1546
|
+
conditions.push('e.stale = 0');
|
|
1126
1547
|
const params = [];
|
|
1127
|
-
if (opts.
|
|
1128
|
-
conditions.push('e.
|
|
1129
|
-
|
|
1548
|
+
if (opts.exclude_disputed) {
|
|
1549
|
+
conditions.push('e.flagged_for_review = 0 AND e.contradiction_of IS NULL');
|
|
1550
|
+
}
|
|
1551
|
+
if (opts.confidence?.length) {
|
|
1552
|
+
conditions.push(`e.confidence IN (${opts.confidence.map(() => '?').join(',')})`);
|
|
1553
|
+
params.push(...opts.confidence);
|
|
1130
1554
|
}
|
|
1131
1555
|
if (opts.type) {
|
|
1132
1556
|
conditions.push('e.type = ?');
|
|
@@ -1144,6 +1568,10 @@ export class SqliteProvider {
|
|
|
1144
1568
|
conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
|
|
1145
1569
|
params.push(opts.tag);
|
|
1146
1570
|
}
|
|
1571
|
+
if (opts.owner_tag) {
|
|
1572
|
+
conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
|
|
1573
|
+
params.push(opts.owner_tag);
|
|
1574
|
+
}
|
|
1147
1575
|
const where = 'WHERE ' + conditions.join(' AND ');
|
|
1148
1576
|
const limitClause = opts.limit !== undefined ? 'LIMIT ?' : '';
|
|
1149
1577
|
if (opts.limit !== undefined)
|
|
@@ -1156,12 +1584,16 @@ export class SqliteProvider {
|
|
|
1156
1584
|
`).all(...params);
|
|
1157
1585
|
return rows.map(r => this.rowToEntry(r));
|
|
1158
1586
|
}
|
|
1159
|
-
async promote(id, reason) {
|
|
1587
|
+
async promote(id, reason, opts) {
|
|
1160
1588
|
const db = this.getDb();
|
|
1161
1589
|
const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
|
|
1162
1590
|
if (!row)
|
|
1163
1591
|
throw new Error(`Entry not found: ${id}`);
|
|
1164
1592
|
const entry = this.rowToEntry(row);
|
|
1593
|
+
// MEMBER own-scope: an entry the caller did not capture is indistinguishable
|
|
1594
|
+
// from an unknown id (same message, so its existence is not disclosed).
|
|
1595
|
+
if (opts?.ownerTag && !entry.tags.includes(opts.ownerTag))
|
|
1596
|
+
throw new Error(`Entry not found: ${id}`);
|
|
1165
1597
|
if (entry.superseded_at)
|
|
1166
1598
|
throw new Error(`Cannot promote superseded entry: ${id}`);
|
|
1167
1599
|
// H1 (F1, D1, closes yashr-9ha): promote() REFUSES any user-directive entry.
|
|
@@ -1225,6 +1657,235 @@ export class SqliteProvider {
|
|
|
1225
1657
|
.run(confidence_after, now, newContent, 'promotion', id);
|
|
1226
1658
|
return { id, confidence_before, confidence_after };
|
|
1227
1659
|
}
|
|
1660
|
+
/**
|
|
1661
|
+
* Evidence paths cited by a demote. Deliberately STRICTER than the basis
|
|
1662
|
+
* check promote() runs: a demote reason is an audit record, so a path that
|
|
1663
|
+
* cannot be pointed at inside this provider's anchor is refused rather than
|
|
1664
|
+
* recorded as an unverifiable string.
|
|
1665
|
+
*
|
|
1666
|
+
* Refuses, all with E-DEMOTE-EVIDENCE-UNRESOLVED:
|
|
1667
|
+
* - any path that is not anchor-relative -- an ABSOLUTE path, or one with
|
|
1668
|
+
* a '..' segment. Both are "out of the anchor": an absolute path names a
|
|
1669
|
+
* location the anchor does not contain, and was previously accepted and
|
|
1670
|
+
* recorded verbatim, which contradicted this very comment. The check is
|
|
1671
|
+
* delegated to validateFilePaths (path-validation.ts), the SAME guard
|
|
1672
|
+
* every other caller-supplied kb_* file list already runs (kb_capture,
|
|
1673
|
+
* kb_context, kb_invalidate, kb_session_prime and the HTTP routes), so
|
|
1674
|
+
* this is not a third hand-rolled path guard. It runs BEFORE existence,
|
|
1675
|
+
* so a path that happens to land on a real file outside the repo is
|
|
1676
|
+
* still refused, and it applies even on the shared-global no-anchor KB,
|
|
1677
|
+
* where nothing absolute could be verified against an anchor anyway;
|
|
1678
|
+
* - a path that does not resolve, via the SAME resolver promote uses
|
|
1679
|
+
* (unresolvableBasisFiles -> resolveBasisFile);
|
|
1680
|
+
* - a path that resolves to something that is not a regular file
|
|
1681
|
+
* (directories are not evidence).
|
|
1682
|
+
*/
|
|
1683
|
+
assertResolvableDemoteEvidence(id, files) {
|
|
1684
|
+
const refuse = (why, offenders) => {
|
|
1685
|
+
throw new Error('E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote evidence ' + why + ': '
|
|
1686
|
+
+ offenders.join(', ') + '. Entry: ' + id);
|
|
1687
|
+
};
|
|
1688
|
+
// Per-file so the message can name EVERY offender, not just the first one
|
|
1689
|
+
// validateFilePaths would throw on.
|
|
1690
|
+
const traversing = files.filter((f) => {
|
|
1691
|
+
try {
|
|
1692
|
+
validateFilePaths([f]);
|
|
1693
|
+
return false;
|
|
1694
|
+
}
|
|
1695
|
+
catch {
|
|
1696
|
+
return true;
|
|
1697
|
+
}
|
|
1698
|
+
});
|
|
1699
|
+
if (traversing.length > 0)
|
|
1700
|
+
refuse('is absolute or traverses out of the anchor', traversing);
|
|
1701
|
+
const unresolved = this.unresolvableBasisFiles(files);
|
|
1702
|
+
if (unresolved.length > 0)
|
|
1703
|
+
refuse('does not resolve', unresolved);
|
|
1704
|
+
const notFiles = files.filter((f) => {
|
|
1705
|
+
const resolved = this.resolveBasisFile(f);
|
|
1706
|
+
try {
|
|
1707
|
+
return !fs.statSync(resolved).isFile();
|
|
1708
|
+
}
|
|
1709
|
+
catch {
|
|
1710
|
+
// Unreadable here means unresolvableBasisFiles already cleared it (the
|
|
1711
|
+
// shared-global no-anchor case); nothing further to assert.
|
|
1712
|
+
return false;
|
|
1713
|
+
}
|
|
1714
|
+
});
|
|
1715
|
+
if (notFiles.length > 0)
|
|
1716
|
+
refuse('is not a file', notFiles);
|
|
1717
|
+
}
|
|
1718
|
+
/**
|
|
1719
|
+
* The demote-time basis snapshot: sha256 of each cited source file AS IT IS
|
|
1720
|
+
* ON DISK RIGHT NOW, keyed by the original (unresolved) path string, the
|
|
1721
|
+
* same key convention source_file_hashes uses.
|
|
1722
|
+
*
|
|
1723
|
+
* This MUST NOT be derived from the source_file_hashes column. That column
|
|
1724
|
+
* is the CAPTURE-time basis; copying it was the defect in the superseded
|
|
1725
|
+
* upstream attempt, and it silently breaks the ping-pong guard that asks
|
|
1726
|
+
* whether the tree has moved on SINCE the demotion. Files that cannot be
|
|
1727
|
+
* read are simply absent from the map (a demote is still allowed on an
|
|
1728
|
+
* entry whose basis has since disappeared -- unlike promote, which refuses).
|
|
1729
|
+
*
|
|
1730
|
+
* sha256 and not `git hash-object`: this snapshot is compared against a
|
|
1731
|
+
* later re-read of the same files by the same code, so it must not depend on
|
|
1732
|
+
* git being available or on the file being in a work tree.
|
|
1733
|
+
*/
|
|
1734
|
+
demoteBasisHashes(files) {
|
|
1735
|
+
const hashes = {};
|
|
1736
|
+
for (const f of files) {
|
|
1737
|
+
try {
|
|
1738
|
+
hashes[f] = createHash('sha256').update(fs.readFileSync(this.resolveBasisFile(f))).digest('hex');
|
|
1739
|
+
}
|
|
1740
|
+
catch {
|
|
1741
|
+
// Unreadable/absent basis file: no entry, never a fabricated hash.
|
|
1742
|
+
}
|
|
1743
|
+
}
|
|
1744
|
+
return hashes;
|
|
1745
|
+
}
|
|
1746
|
+
/**
|
|
1747
|
+
* kb_demote: withdraw trust from a CONFIRMED entry, CONFIRMED -> INFERRED.
|
|
1748
|
+
*
|
|
1749
|
+
* The inverse of promote() in intent but NOT its mirror image in mechanics:
|
|
1750
|
+
*
|
|
1751
|
+
* - it is NOT a ladder. Only CONFIRMED is demotable; INFERRED/UNVERIFIED
|
|
1752
|
+
* are REFUSED (E-DEMOTE-NOT-CONFIRMED), never silently returned as a
|
|
1753
|
+
* no-op, so a caller can never believe it lowered trust that was already
|
|
1754
|
+
* at the floor;
|
|
1755
|
+
* - promoted_at and source are left untouched. promote() stamps
|
|
1756
|
+
* source='promotion'; a demotion must not erase the provenance of the
|
|
1757
|
+
* promotion it is reversing, and promoted_at stays as the record of when
|
|
1758
|
+
* the (now withdrawn) trust was granted;
|
|
1759
|
+
* - a STALE entry MAY be demoted. Staleness is a freshness verdict, trust
|
|
1760
|
+
* is a separate axis, and the entries most worth demoting are exactly the
|
|
1761
|
+
* ones the sweep has already flagged;
|
|
1762
|
+
* - evidence is REQUIRED, like promote's resolvable basis: at least one
|
|
1763
|
+
* evidence file, each of which must resolve inside the anchor
|
|
1764
|
+
* (E-DEMOTE-EVIDENCE-UNRESOLVED otherwise).
|
|
1765
|
+
*
|
|
1766
|
+
* EVERY refusal is checked BEFORE any write, in the order below, and the
|
|
1767
|
+
* order is load-bearing: the own-scope/unknown-id check comes first so a
|
|
1768
|
+
* member can never learn that an entry it does not own exists by probing for
|
|
1769
|
+
* a different refusal message.
|
|
1770
|
+
*/
|
|
1771
|
+
async demote(id, reason, evidenceFiles, opts) {
|
|
1772
|
+
const db = this.getDb();
|
|
1773
|
+
const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
|
|
1774
|
+
// (1) Unknown id. MEMBER own-scope: an entry the caller did not capture is
|
|
1775
|
+
// indistinguishable from an unknown id -- the SAME message as promote(),
|
|
1776
|
+
// so its existence is not disclosed.
|
|
1777
|
+
if (!row)
|
|
1778
|
+
throw new Error('Entry not found: ' + id);
|
|
1779
|
+
const entry = this.rowToEntry(row);
|
|
1780
|
+
if (opts?.ownerTag && !entry.tags.includes(opts.ownerTag))
|
|
1781
|
+
throw new Error('Entry not found: ' + id);
|
|
1782
|
+
// (2) Superseded: the row is already out of every read path, so lowering
|
|
1783
|
+
// its confidence would be a write with no observable meaning.
|
|
1784
|
+
if (entry.superseded_at) {
|
|
1785
|
+
throw new Error('E-DEMOTE-SUPERSEDED: cannot demote a superseded entry. Entry: ' + id);
|
|
1786
|
+
}
|
|
1787
|
+
// (3) user-directive: directives are human-terminal in BOTH directions.
|
|
1788
|
+
// promote() refuses them so kb_promote cannot forge an active directive;
|
|
1789
|
+
// demote() refuses them so an agent cannot deactivate one the human set.
|
|
1790
|
+
if (entry.type === 'user-directive') {
|
|
1791
|
+
throw new Error('E-DEMOTE-REFUSED-DIRECTIVE: cannot demote a user-directive via kb_demote: directive state is '
|
|
1792
|
+
+ 'human-terminal only. Run `apra-fleet kb reject-directive ' + id + '` to discard it. Entry: ' + id);
|
|
1793
|
+
}
|
|
1794
|
+
// (4) Not CONFIRMED. A REFUSAL, not a no-op return: see the method comment.
|
|
1795
|
+
if (entry.confidence !== 'CONFIRMED') {
|
|
1796
|
+
throw new Error('E-DEMOTE-NOT-CONFIRMED: kb_demote lowers CONFIRMED to INFERRED only; this entry is '
|
|
1797
|
+
+ entry.confidence + '. Entry: ' + id);
|
|
1798
|
+
}
|
|
1799
|
+
// (5) Reason floor, measured on the normalised reason -- so a reason made
|
|
1800
|
+
// only of newlines collapses to empty and is refused here.
|
|
1801
|
+
const normalizedReason = normalizeDemoteReason(reason);
|
|
1802
|
+
if (normalizedReason.length < MIN_DEMOTE_REASON_LENGTH) {
|
|
1803
|
+
throw new Error('E-DEMOTE-REASON-REQUIRED: kb_demote requires a reason recording why trust is being withdrawn '
|
|
1804
|
+
+ '(at least ' + MIN_DEMOTE_REASON_LENGTH + ' characters after collapsing newlines and trimming). Entry: ' + id);
|
|
1805
|
+
}
|
|
1806
|
+
// (6) Evidence: REQUIRED, like promote's basis. Withdrawing trust needs a
|
|
1807
|
+
// resolvable reason to believe less, not only a written one.
|
|
1808
|
+
const evidence = evidenceFiles ?? [];
|
|
1809
|
+
if (evidence.length === 0) {
|
|
1810
|
+
throw new Error('E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote requires at least one evidence file backing the demotion '
|
|
1811
|
+
+ '(evidence_files). Entry: ' + id);
|
|
1812
|
+
}
|
|
1813
|
+
this.assertResolvableDemoteEvidence(id, evidence);
|
|
1814
|
+
// --- no refusal remains: everything below writes ---
|
|
1815
|
+
const now = new Date().toISOString();
|
|
1816
|
+
// The note format (one leading newline, ASCII-safe concatenation, the
|
|
1817
|
+
// feedback-marker collision rule) lives in buildDemotionNote, shared with
|
|
1818
|
+
// the bible tombstone path so both demotions read identically.
|
|
1819
|
+
const demotionNote = buildDemotionNote(normalizedReason, evidence, entry.author);
|
|
1820
|
+
const newContent = truncateContent(entry.content + demotionNote);
|
|
1821
|
+
const confidence_before = entry.confidence;
|
|
1822
|
+
const confidence_after = 'INFERRED';
|
|
1823
|
+
// ONE update. promoted_at and source are deliberately absent from the SET.
|
|
1824
|
+
db.prepare('UPDATE entries SET confidence = ?, demoted_at = ?, demoted_basis_hashes = ?, content = ? WHERE id = ?').run(confidence_after, now, JSON.stringify(this.demoteBasisHashes(entry.source_files)), newContent, id);
|
|
1825
|
+
return { id, confidence_before, confidence_after };
|
|
1826
|
+
}
|
|
1827
|
+
/**
|
|
1828
|
+
* Apply ONE explicit demotion tombstone from a committed project bible to the
|
|
1829
|
+
* local row, so a demotion recorded on another clone actually lands here.
|
|
1830
|
+
*
|
|
1831
|
+
* Returns true only when a row was written. Every "no" is a silent false, not
|
|
1832
|
+
* a throw: a bible carries tombstones for the whole project and most clones
|
|
1833
|
+
* hold only some of those ids, so an inapplicable tombstone is the normal
|
|
1834
|
+
* case, not an error.
|
|
1835
|
+
*
|
|
1836
|
+
* The rules, each of which silently corrupts another clone's KB if got wrong:
|
|
1837
|
+
*
|
|
1838
|
+
* - NEVER CREATE. A tombstoned id with no local row stays absent. A
|
|
1839
|
+
* tombstone withdraws trust in a row; it is not a way to author one.
|
|
1840
|
+
* - ONE RE-PROMOTION RULE. Demote only when standingAgainstTombstone
|
|
1841
|
+
* (bible-import.ts) says 'withdrawn' for the row's bible trust time
|
|
1842
|
+
* (getBibleTrustTimes): promoted_at, else the updated_at the bible carried
|
|
1843
|
+
* at import -- never the local import time. kb_export uses the same rule to
|
|
1844
|
+
* decide whether to re-add a tombstoned entry, so the two never disagree.
|
|
1845
|
+
* - demoted_at is stamped with the TOMBSTONE's value, not now(): it records
|
|
1846
|
+
* when trust was withdrawn, which happened on the other clone. That value
|
|
1847
|
+
* is clamped to now (clampBibleTimeToNow), so a future-dated tombstone
|
|
1848
|
+
* never stores a demoted_at that every later re-promotion falls before.
|
|
1849
|
+
* - NO ownerTag CHECK. Bible-imported rows carry no member tag (see
|
|
1850
|
+
* importBibleEntries, which builds its input with tags: [] and author
|
|
1851
|
+
* 'unknown'), so an owner check here would make every imported row
|
|
1852
|
+
* permanently undemotable. The trust boundary for this path is the
|
|
1853
|
+
* git-reviewed bible file, not entry ownership.
|
|
1854
|
+
*
|
|
1855
|
+
* ABSENCE IS NEVER A DEMOTION: this method is only ever called for an id that
|
|
1856
|
+
* carries an EXPLICIT tombstone. A local CONFIRMED row merely missing from the
|
|
1857
|
+
* bible (a local-only promotion, or one refused by the basis filter) is never
|
|
1858
|
+
* passed here and must stay untouched.
|
|
1859
|
+
*
|
|
1860
|
+
* Two refusals are inherited from demote() because they are invariants of the
|
|
1861
|
+
* store, not of the local/remote distinction: a superseded row is already out
|
|
1862
|
+
* of every read path (the write would have no observable meaning), and a
|
|
1863
|
+
* user-directive is human-terminal in both directions -- a bible must not be
|
|
1864
|
+
* able to deactivate a directive a human set here.
|
|
1865
|
+
*/
|
|
1866
|
+
applyBibleDemotion(id, tombstoneAt) {
|
|
1867
|
+
const db = this.getDb();
|
|
1868
|
+
const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
|
|
1869
|
+
// NEVER CREATE.
|
|
1870
|
+
if (!row)
|
|
1871
|
+
return false;
|
|
1872
|
+
const entry = this.rowToEntry(row);
|
|
1873
|
+
if (entry.confidence !== 'CONFIRMED')
|
|
1874
|
+
return false;
|
|
1875
|
+
if (entry.superseded_at)
|
|
1876
|
+
return false;
|
|
1877
|
+
if (entry.type === 'user-directive')
|
|
1878
|
+
return false;
|
|
1879
|
+
const demotedAt = clampBibleTimeToNow(tombstoneAt);
|
|
1880
|
+
if (standingAgainstTombstone(this.bibleTrustTimeOf(row), demotedAt) !== 'withdrawn')
|
|
1881
|
+
return false;
|
|
1882
|
+
const demotionNote = buildDemotionNote(BIBLE_DEMOTION_REASON, [], entry.author);
|
|
1883
|
+
const newContent = truncateContent(entry.content + demotionNote);
|
|
1884
|
+
// Same SET as demote(): promoted_at and source stay untouched, so the
|
|
1885
|
+
// provenance of the promotion being reversed survives.
|
|
1886
|
+
db.prepare('UPDATE entries SET confidence = ?, demoted_at = ?, demoted_basis_hashes = ?, content = ? WHERE id = ?').run('INFERRED', demotedAt, JSON.stringify(this.demoteBasisHashes(entry.source_files)), newContent, id);
|
|
1887
|
+
return true;
|
|
1888
|
+
}
|
|
1228
1889
|
// T3.1 (F8, D7): kb_feedback downvote path -- marks an entry stale=1 +
|
|
1229
1890
|
// flagged_for_review=1 and appends an ASCII feedback note. NEVER deletes,
|
|
1230
1891
|
// NEVER touches confidence: a downvoted CONFIRMED entry stays
|
|
@@ -1390,7 +2051,7 @@ export class SqliteProvider {
|
|
|
1390
2051
|
if (revivable) {
|
|
1391
2052
|
const basis = this.parseBasis(refreshedRow.source_file_hashes ?? null);
|
|
1392
2053
|
if (basis) {
|
|
1393
|
-
const currentHashes = await
|
|
2054
|
+
const currentHashes = await this.hashAnchored(Object.keys(basis));
|
|
1394
2055
|
if (this.basisFullyMatches(basis, currentHashes)) {
|
|
1395
2056
|
db.prepare('UPDATE entries SET stale = 0 WHERE id = ?').run(winnerId);
|
|
1396
2057
|
}
|
|
@@ -1401,7 +2062,7 @@ export class SqliteProvider {
|
|
|
1401
2062
|
// left as-is on the loser (harmless, and preserves which pair this row
|
|
1402
2063
|
// was once part of for later inspection); only flagged_for_review is
|
|
1403
2064
|
// cleared per the stated invariant.
|
|
1404
|
-
db.prepare(
|
|
2065
|
+
db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, flagged_for_review = 0, retired_reason = 'superseded' WHERE id = ?").run(now, loserId);
|
|
1405
2066
|
return { winnerId, loserId };
|
|
1406
2067
|
}
|
|
1407
2068
|
// T3.1 (F5 step 3, D4 HARDENED, resolution R1): kb_reconcile_prefilter's
|
|
@@ -1410,7 +2071,9 @@ export class SqliteProvider {
|
|
|
1410
2071
|
// union of every basis file across every pair -- same batching discipline as
|
|
1411
2072
|
// freshnessSweep): exactly one side fully matches -> that side WINS
|
|
1412
2073
|
// mechanically via resolveContradiction with the verbatim evidence string
|
|
1413
|
-
// "hash-basis match on merged worktree"
|
|
2074
|
+
// "hash-basis match on merged worktree" -- EXCEPT when the would-be loser is
|
|
2075
|
+
// CONFIRMED: a CONFIRMED entry is never retired by hash basis alone, so such
|
|
2076
|
+
// a pair is left for the reconciler agent. Both match, both mismatch, or
|
|
1414
2077
|
// EITHER side has an empty/missing basis -> left untouched for the T3.2
|
|
1415
2078
|
// reconciler agent. Directive pairs are already excluded by flaggedPairs()
|
|
1416
2079
|
// itself (MEDIUM-3 liveness contract); the explicit re-check here is
|
|
@@ -1436,9 +2099,12 @@ export class SqliteProvider {
|
|
|
1436
2099
|
const allIds = liveTouchable.flatMap(p => [p.original.id, p.challenger.id]);
|
|
1437
2100
|
const basisById = new Map();
|
|
1438
2101
|
if (allIds.length > 0) {
|
|
1439
|
-
|
|
1440
|
-
|
|
1441
|
-
|
|
2102
|
+
// A local freshness-only basis (legacy bible import) counts as no basis
|
|
2103
|
+
// here: it was never verified, so it must not win a pair mechanically.
|
|
2104
|
+
const basisRows = db.prepare(`SELECT id, source_file_hashes, local_basis_only FROM entries WHERE id IN (${allIds.map(() => '?').join(',')})`).all(...allIds);
|
|
2105
|
+
for (const row of basisRows) {
|
|
2106
|
+
basisById.set(row.id, row.local_basis_only ? null : this.parseBasis(row.source_file_hashes));
|
|
2107
|
+
}
|
|
1442
2108
|
}
|
|
1443
2109
|
const fileSet = new Set();
|
|
1444
2110
|
for (const basis of basisById.values()) {
|
|
@@ -1446,13 +2112,21 @@ export class SqliteProvider {
|
|
|
1446
2112
|
for (const file of Object.keys(basis))
|
|
1447
2113
|
fileSet.add(file);
|
|
1448
2114
|
}
|
|
1449
|
-
const currentHashes = await
|
|
2115
|
+
const currentHashes = await this.hashAnchored([...fileSet]);
|
|
1450
2116
|
for (const pair of liveTouchable) {
|
|
1451
2117
|
const originalBasis = basisById.get(pair.original.id) ?? null;
|
|
1452
2118
|
const challengerBasis = basisById.get(pair.challenger.id) ?? null;
|
|
1453
2119
|
const originalMatches = originalBasis ? this.basisFullyMatches(originalBasis, currentHashes) : false;
|
|
1454
2120
|
const challengerMatches = challengerBasis ? this.basisFullyMatches(challengerBasis, currentHashes) : false;
|
|
1455
|
-
|
|
2121
|
+
// A CONFIRMED entry is never retired by hash basis alone: a member can
|
|
2122
|
+
// capture a contradiction against a drifted CONFIRMED entry, and basis
|
|
2123
|
+
// match is no content judgement. Defer to the reconciler agent.
|
|
2124
|
+
const wouldLose = originalMatches && !challengerMatches ? pair.challenger
|
|
2125
|
+
: challengerMatches && !originalMatches ? pair.original : null;
|
|
2126
|
+
if (wouldLose && wouldLose.confidence === 'CONFIRMED') {
|
|
2127
|
+
left_for_agent.push({ originalId: pair.original.id, challengerId: pair.challenger.id });
|
|
2128
|
+
}
|
|
2129
|
+
else if (originalMatches && !challengerMatches) {
|
|
1456
2130
|
await this.resolveContradiction(pair.original.id, pair.challenger.id, 'hash-basis match on merged worktree');
|
|
1457
2131
|
resolved.push({ winnerId: pair.original.id, loserId: pair.challenger.id });
|
|
1458
2132
|
}
|