@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- 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 +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- 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 +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- 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 +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -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 +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -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 +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- 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 +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -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 +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -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 +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- 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/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- 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 +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -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 +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.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/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/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-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/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/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/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/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,27 +1,21 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
2
3
|
import fs from 'node:fs';
|
|
3
4
|
import path from 'node:path';
|
|
4
|
-
import {
|
|
5
|
+
import { getSelfReadKb } from '../services/knowledge/kb-self.js';
|
|
6
|
+
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
5
7
|
import { validateFilePaths } from '../services/knowledge/path-validation.js';
|
|
6
|
-
import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
|
|
7
8
|
import { getProvider } from './code-intelligence.js';
|
|
8
9
|
import { FLEET_DIR } from '../paths.js';
|
|
9
10
|
export const kbSessionPrimeSchema = z.object({
|
|
10
|
-
|
|
11
|
+
confidence: z.array(z.enum(['CONFIRMED', 'INFERRED', 'UNVERIFIED'])).min(1).optional()
|
|
12
|
+
.describe('Only surface entries whose confidence tier is in this list. Default when omitted: ["CONFIRMED"] (undisputed) -- INFERRED and UNVERIFIED entries are surfaced only when listed explicitly.'),
|
|
11
13
|
session_files: z.array(z.string()).optional().describe('Files the agent expects to touch this session'),
|
|
12
14
|
hint_symbols: z.array(z.string()).optional().describe('Symbols likely to be relevant'),
|
|
13
15
|
hint_modules: z.array(z.string()).optional().describe('Module names likely to be relevant'),
|
|
14
|
-
//
|
|
15
|
-
//
|
|
16
|
-
|
|
17
|
-
// process's own working directory, used ONLY when repo_path is omitted,
|
|
18
|
-
// put through the exact same existence + isDirectory check, never trusted
|
|
19
|
-
// blindly; (3) neither validates -- the cold-seed block is skipped
|
|
20
|
-
// silently (the existing non-fatal hard-skip contract: prime must never
|
|
21
|
-
// fail because the repo root could not be validated). There is no bare
|
|
22
|
-
// process.cwd() fallback: the fallback tier is validated the same way
|
|
23
|
-
// explicit input is.
|
|
24
|
-
repo_path: z.string().optional().describe('Repo root for the canonical-bible cold-seed (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to the validated session working directory; if neither validates, the cold-seed merge is skipped silently.'),
|
|
16
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
17
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
18
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
25
19
|
});
|
|
26
20
|
// Graph-neighbor expansion caps (T1.3 P4b, design D4). Exported for tests.
|
|
27
21
|
// NEIGHBOR_CAP: max distinct neighbor symbols carried into the extra KB query.
|
|
@@ -74,17 +68,14 @@ function canonicalMatchesHints(entry, hintSymbols, hintModules) {
|
|
|
74
68
|
return true;
|
|
75
69
|
return false;
|
|
76
70
|
}
|
|
77
|
-
//
|
|
78
|
-
//
|
|
79
|
-
//
|
|
80
|
-
//
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
function resolveRepoPath(explicit) {
|
|
84
|
-
const candidate = explicit || process.cwd();
|
|
85
|
-
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
|
|
71
|
+
// The cold-seed below reads <folder>/.fleet/kb-canonical.json, so it needs the
|
|
72
|
+
// anchor folder to be a readable directory on THIS host. Returns null (rather
|
|
73
|
+
// than throwing) when it is not -- a remote member's folder -- so the caller
|
|
74
|
+
// can hard-skip per the existing non-fatal cold-seed contract.
|
|
75
|
+
function localDirOrNull(folder) {
|
|
76
|
+
if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory())
|
|
86
77
|
return null;
|
|
87
|
-
return
|
|
78
|
+
return folder;
|
|
88
79
|
}
|
|
89
80
|
// T3.5 (F9c, D8): `via` param added, defaulting to 'canonical-bible' so the
|
|
90
81
|
// existing project-bible call site below is byte-for-byte unchanged. The new
|
|
@@ -150,26 +141,29 @@ function parseContextNeighbors(result) {
|
|
|
150
141
|
return [];
|
|
151
142
|
}
|
|
152
143
|
}
|
|
153
|
-
export async function kbSessionPrime(input) {
|
|
144
|
+
export async function kbSessionPrime(input, anchor) {
|
|
154
145
|
if (input.session_files?.length)
|
|
155
146
|
validateFilePaths(input.session_files);
|
|
156
|
-
// Prime the
|
|
157
|
-
//
|
|
158
|
-
//
|
|
159
|
-
//
|
|
160
|
-
//
|
|
161
|
-
//
|
|
162
|
-
//
|
|
163
|
-
//
|
|
164
|
-
//
|
|
165
|
-
//
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
//
|
|
170
|
-
|
|
171
|
-
const
|
|
147
|
+
// Prime the calling session's own KB (kb-self.ts): a member session's work
|
|
148
|
+
// folder, else the server's folder. A remote member's folder is carried
|
|
149
|
+
// verbatim even though this host cannot see it -- SqliteProvider.
|
|
150
|
+
// anchorIsMissing() then declines to produce a freshness verdict rather
|
|
151
|
+
// than re-hashing against an unrelated tree.
|
|
152
|
+
// A MEMBER session primes from its checkout bible view unless it explicitly
|
|
153
|
+
// asks for INFERRED/UNVERIFIED (kb-self.ts getSelfReadKb).
|
|
154
|
+
// That explicit request is answered from the per-repo DB with only the
|
|
155
|
+
// caller's own captures (ownerTag): every block below honours it, and the
|
|
156
|
+
// bible cold-seeds are skipped (bible entries are nobody's own capture).
|
|
157
|
+
const { providers, anchor: resolved, ownerTag } = await getSelfReadKb(anchor, input.confidence);
|
|
158
|
+
if (ownerTag !== undefined)
|
|
159
|
+
requireSqliteProject(providers.project, 'kb_session_prime');
|
|
160
|
+
// Default-trusted reads: CONFIRMED + undisputed unless the caller lists tiers.
|
|
161
|
+
const confidence = input.confidence?.length ? input.confidence : ['CONFIRMED'];
|
|
162
|
+
const exclude_disputed = !input.confidence?.length;
|
|
172
163
|
const result = await providers.project.prime({
|
|
164
|
+
confidence,
|
|
165
|
+
exclude_disputed,
|
|
166
|
+
owner_tag: ownerTag,
|
|
173
167
|
session_files: input.session_files,
|
|
174
168
|
hint_symbols: input.hint_symbols,
|
|
175
169
|
hint_modules: input.hint_modules,
|
|
@@ -189,6 +183,9 @@ export async function kbSessionPrime(input) {
|
|
|
189
183
|
l1_only: true,
|
|
190
184
|
limit: 10,
|
|
191
185
|
include_stale: false,
|
|
186
|
+
confidence,
|
|
187
|
+
exclude_disputed,
|
|
188
|
+
owner_tag: ownerTag,
|
|
192
189
|
});
|
|
193
190
|
const globalEntries = globalResult.results
|
|
194
191
|
.filter(e => e.type === 'knowledge')
|
|
@@ -246,6 +243,9 @@ export async function kbSessionPrime(input) {
|
|
|
246
243
|
l1_only: true,
|
|
247
244
|
limit: 10,
|
|
248
245
|
include_stale: false,
|
|
246
|
+
confidence,
|
|
247
|
+
exclude_disputed,
|
|
248
|
+
owner_tag: ownerTag,
|
|
249
249
|
});
|
|
250
250
|
// Merge below direct hits: skip ids already present (direct + global),
|
|
251
251
|
// mark each addition via "graph-neighbor", cap at ADDED_ENTRY_CAP.
|
|
@@ -277,9 +277,9 @@ export async function kbSessionPrime(input) {
|
|
|
277
277
|
// live-KB hit gathered above. Non-fatal: the entire block is a hard skip --
|
|
278
278
|
// missing file, unreadable/malformed JSON, or a bad shape leaves `result`
|
|
279
279
|
// exactly as built above (same contract as the neighbor block).
|
|
280
|
-
if ((result.top_entries ?? []).length < COLD_KB_MAX) {
|
|
280
|
+
if (ownerTag === undefined && (result.top_entries ?? []).length < COLD_KB_MAX) {
|
|
281
281
|
try {
|
|
282
|
-
const repoRoot =
|
|
282
|
+
const repoRoot = localDirOrNull(resolved.folder);
|
|
283
283
|
const canonicalPath = repoRoot ? path.join(repoRoot, '.fleet', 'kb-canonical.json') : null;
|
|
284
284
|
if (canonicalPath && fs.existsSync(canonicalPath)) {
|
|
285
285
|
const raw = fs.readFileSync(canonicalPath, 'utf-8');
|
|
@@ -341,7 +341,7 @@ export async function kbSessionPrime(input) {
|
|
|
341
341
|
// project-bible block: missing file, unreadable/malformed JSON, or a bad
|
|
342
342
|
// shape leaves `result` exactly as built above -- warm sessions (>=
|
|
343
343
|
// COLD_KB_MAX) never reach this block at all.
|
|
344
|
-
if ((result.top_entries ?? []).length < COLD_KB_MAX) {
|
|
344
|
+
if (ownerTag === undefined && (result.top_entries ?? []).length < COLD_KB_MAX) {
|
|
345
345
|
try {
|
|
346
346
|
const globalBiblePath = path.join(FLEET_DIR, 'knowledge', 'global', 'kb-canonical-global.json');
|
|
347
347
|
if (fs.existsSync(globalBiblePath)) {
|
package/dist/tools/kb-setup.d.ts
CHANGED
|
@@ -1,20 +1,27 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbSetupSchema: z.ZodObject<{
|
|
3
|
-
repo_path: z.ZodOptional<z.
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
4
7
|
provider: z.ZodOptional<z.ZodEnum<["sqlite", "http"]>>;
|
|
5
8
|
remote: z.ZodOptional<z.ZodString>;
|
|
6
9
|
token: z.ZodOptional<z.ZodString>;
|
|
7
10
|
}, "strip", z.ZodTypeAny, {
|
|
8
11
|
remote?: string | undefined;
|
|
12
|
+
repo?: unknown;
|
|
9
13
|
provider?: "http" | "sqlite" | undefined;
|
|
10
14
|
token?: string | undefined;
|
|
11
|
-
repo_path?:
|
|
15
|
+
repo_path?: unknown;
|
|
16
|
+
repo_remote_url?: unknown;
|
|
12
17
|
}, {
|
|
13
18
|
remote?: string | undefined;
|
|
19
|
+
repo?: unknown;
|
|
14
20
|
provider?: "http" | "sqlite" | undefined;
|
|
15
21
|
token?: string | undefined;
|
|
16
|
-
repo_path?:
|
|
22
|
+
repo_path?: unknown;
|
|
23
|
+
repo_remote_url?: unknown;
|
|
17
24
|
}>;
|
|
18
25
|
export type KbSetupInput = z.infer<typeof kbSetupSchema>;
|
|
19
|
-
export declare function kbSetup(input: KbSetupInput): Promise<string>;
|
|
26
|
+
export declare function kbSetup(input: KbSetupInput, anchor?: KbAnchor): Promise<string>;
|
|
20
27
|
//# sourceMappingURL=kb-setup.d.ts.map
|
package/dist/tools/kb-setup.js
CHANGED
|
@@ -1,49 +1,168 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
2
3
|
import fs from 'node:fs';
|
|
3
4
|
import path from 'node:path';
|
|
4
|
-
import { FLEET_DIR } from '../paths.js';
|
|
5
5
|
import { installKbPostCommitHook } from './kb-invalidate.js';
|
|
6
|
+
import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
6
7
|
import { encryptPassword } from '../utils/crypto.js';
|
|
8
|
+
import { logWarn } from '../utils/log-helpers.js';
|
|
9
|
+
import { resolveKbAnchor, KbSelfError } from '../services/knowledge/kb-self.js';
|
|
7
10
|
export const kbSetupSchema = z.object({
|
|
8
|
-
repo_path: z.string().optional()
|
|
9
|
-
.describe('Path to git repository for post-commit hook installation (default: current directory)'),
|
|
10
11
|
provider: z.enum(['sqlite', 'http']).optional()
|
|
11
12
|
.describe('KB provider type (default: sqlite)'),
|
|
12
13
|
remote: z.string().optional()
|
|
13
|
-
.describe('Remote KB server URL (required when provider=http)'),
|
|
14
|
+
.describe('Remote KB server URL, http(s) only (required when provider=http). Use https for any non-loopback host: plain http sends the token in cleartext.'),
|
|
14
15
|
token: z.string().optional()
|
|
15
16
|
.describe('Authentication token for remote KB server (stored encrypted, never logged)'),
|
|
17
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
18
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
19
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
16
20
|
});
|
|
17
|
-
const
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
21
|
+
const KB_CONFIG_FILE_MODE = 0o600;
|
|
22
|
+
// Hostnames (as URL.hostname normalizes them) that never leave this machine,
|
|
23
|
+
// so plain http to them cannot put the bearer token on the wire. 127.0.0.0/8
|
|
24
|
+
// is loopback in full; URL() already rewrites numeric forms like 2130706433
|
|
25
|
+
// or 127.1 to dotted quads. Exact matches only -- localhost.example.com is not
|
|
26
|
+
// loopback.
|
|
27
|
+
function isLoopbackHostname(hostname) {
|
|
28
|
+
const lower = hostname.toLowerCase();
|
|
29
|
+
return lower === 'localhost' || lower === '[::1]' || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(lower);
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Parse the remote KB URL and return any transport warnings. Throws when the
|
|
33
|
+
* value is not an http(s) URL. Messages name the field and at most the scheme
|
|
34
|
+
* and host -- never the raw value, which may carry user:pass@ or a query token.
|
|
35
|
+
*
|
|
36
|
+
* my-beads-db-u00.6: plain http to a non-loopback host WARNS rather than being
|
|
37
|
+
* refused. Refusing would break existing LAN deployments the next time they
|
|
38
|
+
* re-run kb_setup, and configs already on disk are never re-validated, so a
|
|
39
|
+
* refusal here would not close the hole for them anyway.
|
|
40
|
+
*/
|
|
41
|
+
function checkRemoteUrl(remote) {
|
|
42
|
+
let url;
|
|
43
|
+
try {
|
|
44
|
+
url = new URL(remote);
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
throw new Error('kb_setup: remote is not a valid URL; expected http(s)://host[:port]');
|
|
48
|
+
}
|
|
49
|
+
if (url.protocol !== 'http:' && url.protocol !== 'https:') {
|
|
50
|
+
throw new Error(`kb_setup: remote must use http or https, got scheme "${url.protocol}"`);
|
|
51
|
+
}
|
|
52
|
+
if (url.protocol === 'http:' && !isLoopbackHostname(url.hostname)) {
|
|
53
|
+
return [
|
|
54
|
+
`remote uses plain http to non-loopback host "${url.hostname}": any KB token is sent ` +
|
|
55
|
+
'in cleartext on every KB call. Use an https:// remote.',
|
|
56
|
+
];
|
|
57
|
+
}
|
|
58
|
+
return [];
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* The config kb_setup merges into. Absent -> empty. Malformed (bad JSON, or
|
|
62
|
+
* not a JSON object) -> empty plus a warning: kb_setup is the tool an operator
|
|
63
|
+
* runs to REPAIR the KB config, so an unreadable file must not make it throw.
|
|
64
|
+
*/
|
|
65
|
+
function readExistingConfig(warnings) {
|
|
66
|
+
if (!fs.existsSync(KB_CONFIG_PATH))
|
|
67
|
+
return {};
|
|
68
|
+
let parsed;
|
|
69
|
+
try {
|
|
70
|
+
parsed = JSON.parse(fs.readFileSync(KB_CONFIG_PATH, 'utf-8'));
|
|
71
|
+
}
|
|
72
|
+
catch {
|
|
73
|
+
// The parser's message quotes part of the file, which may hold the
|
|
74
|
+
// encrypted token, so it is not repeated here.
|
|
75
|
+
return discardMalformed(warnings, 'it is not valid JSON');
|
|
76
|
+
}
|
|
77
|
+
if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
78
|
+
return discardMalformed(warnings, 'it is not a JSON object');
|
|
79
|
+
}
|
|
80
|
+
return parsed;
|
|
81
|
+
}
|
|
82
|
+
function discardMalformed(warnings, reason) {
|
|
83
|
+
const warning = `existing KB config at ${KB_CONFIG_PATH} was discarded because ${reason}; ` +
|
|
84
|
+
'any other settings it held (e.g. bible.autoCommit) must be set again.';
|
|
85
|
+
logWarn('kb_setup', warning);
|
|
86
|
+
warnings.push(warning);
|
|
87
|
+
return {};
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Merge the keys kb_setup owns over the existing config; every other key is
|
|
91
|
+
* left as it was.
|
|
92
|
+
*
|
|
93
|
+
* - provider is written only when provider or remote is passed, so a bare
|
|
94
|
+
* kb_setup run to install the hook in another repo does not flip an
|
|
95
|
+
* install already pointed at a remote back to sqlite. A fresh file still
|
|
96
|
+
* gets provider "sqlite", as before.
|
|
97
|
+
* - token_encrypted is kept while the url is unchanged, so a re-run that only
|
|
98
|
+
* installs a hook or switches provider keeps working. When remote moves the
|
|
99
|
+
* url to a different server and no token is passed, the old token is
|
|
100
|
+
* dropped with a warning: sending one server's bearer token to another
|
|
101
|
+
* leaks the credential.
|
|
102
|
+
*/
|
|
103
|
+
function applySetupInput(config, input, steps, warnings) {
|
|
104
|
+
if (input.provider || input.remote) {
|
|
105
|
+
config.provider = input.provider || 'http';
|
|
106
|
+
}
|
|
107
|
+
else if (!config.provider) {
|
|
108
|
+
config.provider = 'sqlite';
|
|
109
|
+
}
|
|
38
110
|
if (input.remote) {
|
|
111
|
+
const urlChanged = config.url !== input.remote;
|
|
39
112
|
config.url = input.remote;
|
|
113
|
+
if (urlChanged && !input.token && config.token_encrypted) {
|
|
114
|
+
delete config.token_encrypted;
|
|
115
|
+
const warning = 'remote changed and no token was given: the token stored for the previous ' +
|
|
116
|
+
'remote was removed rather than sent to the new one. Re-run kb_setup with a token.';
|
|
117
|
+
logWarn('kb_setup', warning);
|
|
118
|
+
warnings.push(warning);
|
|
119
|
+
}
|
|
40
120
|
}
|
|
41
121
|
if (input.token) {
|
|
42
122
|
config.token_encrypted = encryptPassword(input.token);
|
|
43
123
|
steps.push('Stored remote token encrypted (AES-256-GCM)');
|
|
44
124
|
}
|
|
45
|
-
|
|
125
|
+
}
|
|
126
|
+
// writeFileSync's mode applies only when it CREATES the file, and a merge
|
|
127
|
+
// usually rewrites an existing one, so the mode is set explicitly as well.
|
|
128
|
+
function writeConfig(config) {
|
|
129
|
+
fs.mkdirSync(path.dirname(KB_CONFIG_PATH), { recursive: true });
|
|
130
|
+
fs.writeFileSync(KB_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: KB_CONFIG_FILE_MODE });
|
|
131
|
+
fs.chmodSync(KB_CONFIG_PATH, KB_CONFIG_FILE_MODE);
|
|
132
|
+
}
|
|
133
|
+
export async function kbSetup(input, anchor) {
|
|
134
|
+
const steps = [];
|
|
135
|
+
// Validate before any side effect, so a bad remote installs no hook and
|
|
136
|
+
// leaves any existing config untouched.
|
|
137
|
+
const warnings = input.remote ? checkRemoteUrl(input.remote) : [];
|
|
138
|
+
for (const warning of warnings) {
|
|
139
|
+
logWarn('kb_setup', warning);
|
|
140
|
+
}
|
|
141
|
+
// Install git post-commit hook into the calling session's own repo (kb-self.ts).
|
|
142
|
+
// A folder that cannot carry a KB identity skips the hook with the typed
|
|
143
|
+
// reason; the provider config below is machine-wide and is still written.
|
|
144
|
+
let repoPath = null;
|
|
145
|
+
try {
|
|
146
|
+
repoPath = resolveKbAnchor(anchor).folder;
|
|
147
|
+
}
|
|
148
|
+
catch (err) {
|
|
149
|
+
if (!(err instanceof KbSelfError))
|
|
150
|
+
throw err;
|
|
151
|
+
steps.push('Skipped git hook: ' + err.message);
|
|
152
|
+
}
|
|
153
|
+
if (repoPath !== null) {
|
|
154
|
+
if (fs.existsSync(path.join(repoPath, '.git'))) {
|
|
155
|
+
installKbPostCommitHook(repoPath);
|
|
156
|
+
steps.push('Installed git post-commit hook for KB invalidation');
|
|
157
|
+
}
|
|
158
|
+
else {
|
|
159
|
+
steps.push('Skipped git hook: no .git directory found at ' + repoPath);
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
const config = readExistingConfig(warnings);
|
|
163
|
+
applySetupInput(config, input, steps, warnings);
|
|
164
|
+
writeConfig(config);
|
|
46
165
|
steps.push('Wrote KB config to ' + KB_CONFIG_PATH);
|
|
47
|
-
return JSON.stringify({ success: true, steps });
|
|
166
|
+
return JSON.stringify({ success: true, steps, warnings });
|
|
48
167
|
}
|
|
49
168
|
//# sourceMappingURL=kb-setup.js.map
|
package/dist/tools/kb-stats.d.ts
CHANGED
|
@@ -1,20 +1,21 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbStatsSchema: z.ZodObject<{
|
|
3
|
-
|
|
4
|
-
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
5
7
|
symbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
6
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
7
8
|
}, "strip", z.ZodTypeAny, {
|
|
9
|
+
repo?: unknown;
|
|
8
10
|
symbols?: string[] | undefined;
|
|
9
|
-
repo_path?:
|
|
10
|
-
repo_remote_url?:
|
|
11
|
-
repo?: string | undefined;
|
|
11
|
+
repo_path?: unknown;
|
|
12
|
+
repo_remote_url?: unknown;
|
|
12
13
|
}, {
|
|
14
|
+
repo?: unknown;
|
|
13
15
|
symbols?: string[] | undefined;
|
|
14
|
-
repo_path?:
|
|
15
|
-
repo_remote_url?:
|
|
16
|
-
repo?: string | undefined;
|
|
16
|
+
repo_path?: unknown;
|
|
17
|
+
repo_remote_url?: unknown;
|
|
17
18
|
}>;
|
|
18
19
|
export type KbStatsInput = z.infer<typeof kbStatsSchema>;
|
|
19
|
-
export declare function kbStats(input: KbStatsInput): Promise<string>;
|
|
20
|
+
export declare function kbStats(input: KbStatsInput, anchor?: KbAnchor): Promise<string>;
|
|
20
21
|
//# sourceMappingURL=kb-stats.d.ts.map
|
package/dist/tools/kb-stats.js
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
2
3
|
import fs from 'node:fs';
|
|
3
4
|
import path from 'node:path';
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
5
|
+
import { getSelfReadKb } from '../services/knowledge/kb-self.js';
|
|
6
|
+
import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
6
7
|
// T2.1 (F5, D4): kb_stats -- a read-only aggregation tool, following the
|
|
7
8
|
// kb_list no-bump pattern (SqliteProvider.stats() never touches use_count/
|
|
8
9
|
// last_accessed). Reports the KB's health: confidence/type totals,
|
|
@@ -13,48 +14,29 @@ import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
|
|
|
13
14
|
// bible drift is VISIBILITY for the machine that owns the KB -- CI cannot see
|
|
14
15
|
// the local kb.sqlite, so no CI gate reads this tool or its drift number.
|
|
15
16
|
export const kbStatsSchema = z.object({
|
|
16
|
-
...kbScopeFields,
|
|
17
|
-
repo: z.string().optional()
|
|
18
|
-
.describe('Path to the repo root for the canonical-bible drift check (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to repo_path, then to the validated session working directory (same validation as kb_export/kb_session_prime); if none validates, bible.present is reported false and drift equals the full live-CONFIRMED count -- kb_stats never fails because of this.'),
|
|
19
|
-
// apra-fleet-src: every other kb_* tool (kb_list, kb_capture, kb_promote,
|
|
20
|
-
// kb_session_prime, kb_export) names this input `repo_path`. kb_stats alone
|
|
21
|
-
// took `repo`, and zod strips unknown keys silently -- so calling it the way
|
|
22
|
-
// every sibling is called did not error, it fell back to the SERVER's cwd and
|
|
23
|
-
// reported a fully-zeroed KB for a populated repo. A confidently wrong "there
|
|
24
|
-
// is nothing here" is worse than a failure, because kb_stats is exactly the
|
|
25
|
-
// tool an operator reaches for to ask whether the KB is working.
|
|
26
|
-
repo_path: z.string().optional()
|
|
27
|
-
.describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
|
|
28
17
|
symbols: z.array(z.string()).optional()
|
|
29
18
|
.describe('Symbols to check coverage for: per-symbol boolean (a live CONFIRMED entry whose symbols array contains it, exact match) plus the overall fraction.'),
|
|
19
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
20
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
21
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
30
22
|
});
|
|
31
|
-
//
|
|
32
|
-
//
|
|
33
|
-
//
|
|
34
|
-
function
|
|
35
|
-
|
|
36
|
-
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
|
|
23
|
+
// The bible-drift read needs the anchor folder to be a readable directory on
|
|
24
|
+
// THIS host; null (non-fatal -- kb_stats never throws over it, it just reports
|
|
25
|
+
// bible.present = false) when it is not, e.g. a remote member's folder.
|
|
26
|
+
function localDirOrNull(folder) {
|
|
27
|
+
if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory())
|
|
37
28
|
return null;
|
|
38
|
-
return
|
|
29
|
+
return folder;
|
|
39
30
|
}
|
|
40
|
-
export async function kbStats(input) {
|
|
41
|
-
//
|
|
42
|
-
|
|
43
|
-
//
|
|
44
|
-
//
|
|
45
|
-
//
|
|
46
|
-
//
|
|
47
|
-
//
|
|
48
|
-
|
|
49
|
-
// `?? undefined`, into getKbProviders' `cwd ?? process.cwd()` -- so the slug
|
|
50
|
-
// came from repo_remote_url (the REAL shared project KB) while the anchor
|
|
51
|
-
// became the fleet server's own working directory, and every basis hash was
|
|
52
|
-
// computed against a tree that does not describe those entries. Keeping the
|
|
53
|
-
// caller's path means the anchor is honestly "a path this host cannot see",
|
|
54
|
-
// which SqliteProvider.anchorIsMissing() handles by declining to produce a
|
|
55
|
-
// freshness verdict at all. resolveRepoPath still guards the omitted-path
|
|
56
|
-
// fallback and the bible-drift read below, which does need a readable dir.
|
|
57
|
-
const providers = await getKbProviders(requestedRepo ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
|
|
31
|
+
export async function kbStats(input, anchor) {
|
|
32
|
+
// Stats describe the calling session's own KB (kb-self.ts). A remote
|
|
33
|
+
// member's folder is carried verbatim even though this host cannot see it --
|
|
34
|
+
// SqliteProvider.anchorIsMissing() then declines to produce a freshness
|
|
35
|
+
// verdict rather than hashing against an unrelated tree.
|
|
36
|
+
// A MEMBER session reports on its checkout bible view (kb-self.ts
|
|
37
|
+
// getSelfReadKb): totals.by_confidence.CONFIRMED is the bible's CONFIRMED
|
|
38
|
+
// count. kb_stats takes no tier filter, so a member always gets the view.
|
|
39
|
+
const { providers, anchor: resolved } = await getSelfReadKb(anchor);
|
|
58
40
|
const providerStats = await providers.project.stats({ symbols: input.symbols });
|
|
59
41
|
// D5: bible.drift = count of live CONFIRMED entries whose updated_at
|
|
60
42
|
// (promoted_at || created_at, matching kb_export's own field) is newer than
|
|
@@ -62,53 +44,73 @@ export async function kbStats(input) {
|
|
|
62
44
|
// ALL live CONFIRMED entries, present = false. list({confidence:'CONFIRMED'})
|
|
63
45
|
// already returns exactly the "live CONFIRMED" set (superseded_at IS NULL
|
|
64
46
|
// AND stale = 0 are list()'s hardcoded defaults) without bumping use_count.
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
47
|
+
//
|
|
48
|
+
// my-beads-db-0cd.13: the SqliteProvider-only check sits OUTSIDE the
|
|
49
|
+
// degraded-safe try block below, on purpose. Previously requireSqliteProject
|
|
50
|
+
// sat INSIDE that try, so its throw over an HttpKbProvider project was
|
|
51
|
+
// swallowed by the same catch that guards a merely-missing/malformed bible
|
|
52
|
+
// file, and the tool returned the ambiguous { present: false, entries: 0,
|
|
53
|
+
// drift: 0 } -- indistinguishable from an up-to-date bible. A remote
|
|
54
|
+
// provider now gets its own distinguishable, non-throwing shape instead.
|
|
55
|
+
//
|
|
56
|
+
// my-beads-db-u00.3: kb_stats is the one SqliteProvider-only call site that
|
|
57
|
+
// DEGRADES rather than failing fast, so it asks the type question with the
|
|
58
|
+
// non-throwing isSqliteProject guard. Catching requireSqliteProject's throw
|
|
59
|
+
// as a type test would also swallow any unrelated error on that path.
|
|
60
|
+
let bible;
|
|
61
|
+
const project = providers.project;
|
|
62
|
+
if (!isSqliteProject(project)) {
|
|
63
|
+
bible = { computable: false, reason: 'bible drift is not computable over a remote HTTP provider' };
|
|
64
|
+
}
|
|
65
|
+
else {
|
|
66
|
+
bible = { present: false, entries: 0, drift: 0 };
|
|
67
|
+
try {
|
|
68
|
+
const liveConfirmed = await project.list({ confidence: ['CONFIRMED'] });
|
|
69
|
+
const liveUpdatedAts = liveConfirmed.map(e => e.promoted_at || e.created_at);
|
|
70
|
+
// Degraded-safe fallback shared by every "can't use the bible file" path
|
|
71
|
+
// below (absent, unreadable, malformed JSON, non-array shape): drift
|
|
72
|
+
// equals ALL live CONFIRMED entries per D5, never silently lost to 0.
|
|
73
|
+
bible = { present: false, entries: 0, drift: liveConfirmed.length };
|
|
74
|
+
const repoPath = localDirOrNull(resolved.folder);
|
|
75
|
+
const biblePath = repoPath ? path.join(repoPath, '.fleet', 'kb-canonical.json') : null;
|
|
76
|
+
if (biblePath && fs.existsSync(biblePath)) {
|
|
77
|
+
try {
|
|
78
|
+
const raw = fs.readFileSync(biblePath, 'utf-8');
|
|
79
|
+
const parsed = JSON.parse(raw);
|
|
80
|
+
// KB-TRUST PHASE 3a: the bible has two shapes -- a legacy bare array and
|
|
81
|
+
// the v2 { version, provenance, entries } envelope. Handle BOTH: reading
|
|
82
|
+
// only the array shape would silently report present:false and a drift
|
|
83
|
+
// of every live CONFIRMED entry against a perfectly good v2 bible, and
|
|
84
|
+
// this block degrades quietly by design, so that would never be noticed.
|
|
85
|
+
const entries = Array.isArray(parsed)
|
|
86
|
+
? parsed
|
|
87
|
+
: (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
|
|
88
|
+
? parsed.entries
|
|
89
|
+
: null;
|
|
90
|
+
if (entries !== null) {
|
|
91
|
+
let newest = null;
|
|
92
|
+
for (const entry of entries) {
|
|
93
|
+
const updatedAt = entry?.updated_at;
|
|
94
|
+
if (typeof updatedAt === 'string' && (!newest || updatedAt > newest))
|
|
95
|
+
newest = updatedAt;
|
|
96
|
+
}
|
|
97
|
+
const drift = newest === null
|
|
98
|
+
? liveConfirmed.length
|
|
99
|
+
: liveUpdatedAts.filter(u => u > newest).length;
|
|
100
|
+
bible = { present: true, entries: entries.length, drift };
|
|
95
101
|
}
|
|
96
|
-
const drift = newest === null
|
|
97
|
-
? liveConfirmed.length
|
|
98
|
-
: liveUpdatedAts.filter(u => u > newest).length;
|
|
99
|
-
bible = { present: true, entries: entries.length, drift };
|
|
100
102
|
}
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
103
|
+
catch {
|
|
104
|
+
// Malformed/unreadable bible file: leave the absent-shape fallback
|
|
105
|
+
// (drift = all live CONFIRMED) set above.
|
|
106
|
+
}
|
|
105
107
|
}
|
|
106
108
|
}
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
109
|
+
catch {
|
|
110
|
+
// Degraded-safe: kb_stats never throws over the bible file. Falls back to
|
|
111
|
+
// the "absent, drift 0" shape initialized above (only reachable if the
|
|
112
|
+
// list({confidence:'CONFIRMED'}) read itself failed).
|
|
113
|
+
}
|
|
112
114
|
}
|
|
113
115
|
return JSON.stringify({ ...providerStats, bible });
|
|
114
116
|
}
|
|
@@ -3,11 +3,11 @@ export declare const listMembersSchema: z.ZodObject<{
|
|
|
3
3
|
format: z.ZodDefault<z.ZodEnum<["compact", "json"]>>;
|
|
4
4
|
tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
5
5
|
}, "strip", z.ZodTypeAny, {
|
|
6
|
-
format: "
|
|
6
|
+
format: "json" | "compact";
|
|
7
7
|
tags?: string[] | undefined;
|
|
8
8
|
}, {
|
|
9
9
|
tags?: string[] | undefined;
|
|
10
|
-
format?: "
|
|
10
|
+
format?: "json" | "compact" | undefined;
|
|
11
11
|
}>;
|
|
12
12
|
export type ListMembersInput = z.infer<typeof listMembersSchema>;
|
|
13
13
|
export declare function listMembers(input?: ListMembersInput): Promise<string>;
|