@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
3
|
+
export declare const kbBibleCommitSchema: z.ZodObject<{
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
7
|
+
ids: z.ZodArray<z.ZodString, "many">;
|
|
8
|
+
baseBranch: z.ZodString;
|
|
9
|
+
baseCommit: z.ZodString;
|
|
10
|
+
}, "strip", z.ZodTypeAny, {
|
|
11
|
+
baseBranch: string;
|
|
12
|
+
baseCommit: string;
|
|
13
|
+
ids: string[];
|
|
14
|
+
repo?: unknown;
|
|
15
|
+
repo_path?: unknown;
|
|
16
|
+
repo_remote_url?: unknown;
|
|
17
|
+
}, {
|
|
18
|
+
baseBranch: string;
|
|
19
|
+
baseCommit: string;
|
|
20
|
+
ids: string[];
|
|
21
|
+
repo?: unknown;
|
|
22
|
+
repo_path?: unknown;
|
|
23
|
+
repo_remote_url?: unknown;
|
|
24
|
+
}>;
|
|
25
|
+
export type KbBibleCommitInput = z.infer<typeof kbBibleCommitSchema>;
|
|
26
|
+
/**
|
|
27
|
+
* Why a requested id was not merged:
|
|
28
|
+
* - not_confirmed_or_unknown: not a live CONFIRMED entry in this KB;
|
|
29
|
+
* - no_source_files: CONFIRMED but cites no source file, so it has no basis
|
|
30
|
+
* that could ever be checked (retrying cannot change this);
|
|
31
|
+
* - basis_mismatch: CONFIRMED and cites files, but its recorded basis does not
|
|
32
|
+
* match those files at HEAD (can clear once the files or the basis agree).
|
|
33
|
+
*/
|
|
34
|
+
export type KbBibleCommitSkipReason = 'not_confirmed_or_unknown' | 'no_source_files' | 'basis_mismatch';
|
|
35
|
+
export interface KbBibleCommitSkip {
|
|
36
|
+
id: string;
|
|
37
|
+
reason: KbBibleCommitSkipReason;
|
|
38
|
+
}
|
|
39
|
+
/** Why a bible entry was removed: the maintainer KB holds it as retired. */
|
|
40
|
+
export type KbBibleCommitRemovalReason = 'superseded' | 'invalidated';
|
|
41
|
+
export interface KbBibleCommitRemoval {
|
|
42
|
+
id: string;
|
|
43
|
+
reason: KbBibleCommitRemovalReason;
|
|
44
|
+
}
|
|
45
|
+
export interface KbBibleCommitResult {
|
|
46
|
+
path: string;
|
|
47
|
+
merged: string[];
|
|
48
|
+
skipped: KbBibleCommitSkip[];
|
|
49
|
+
removed: KbBibleCommitRemoval[];
|
|
50
|
+
entry_count: number;
|
|
51
|
+
/** How many existing bible entries gained source_file_hashes (legacy backfill). */
|
|
52
|
+
backfilled: number;
|
|
53
|
+
committed: boolean;
|
|
54
|
+
}
|
|
55
|
+
export declare function kbBibleCommit(input: KbBibleCommitInput, anchor?: KbAnchor): Promise<string>;
|
|
56
|
+
/**
|
|
57
|
+
* The bible commit message. The subject counts merged and removed entries;
|
|
58
|
+
* when entries were removed, the body lists each one as '- <id> (<reason>)'.
|
|
59
|
+
* With no removals and no backfill the message is the single pre-existing
|
|
60
|
+
* subject line. A legacy backfill (existing entries that gained
|
|
61
|
+
* source_file_hashes) adds a body line 'Backfilled source_file_hashes on <n>
|
|
62
|
+
* existing entries.'; a backfill-only commit names the count in its own subject.
|
|
63
|
+
*/
|
|
64
|
+
export declare function bibleCommitMessage(mergedCount: number, removed: KbBibleCommitRemoval[], total: number, backfilled?: number): string;
|
|
65
|
+
//# sourceMappingURL=kb-bible-commit.d.ts.map
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
3
|
+
import fs from 'node:fs';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
6
|
+
import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
|
|
7
|
+
import { filterProjectBibleCandidates, hasCarriedBasis, selectLegacyBibleBackfill } from '../services/knowledge/bible-basis-filter.js';
|
|
8
|
+
import { logWarn } from '../utils/log-helpers.js';
|
|
9
|
+
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
10
|
+
import { bibleBytesBlobId } from '../services/knowledge/bible-blob-id.js';
|
|
11
|
+
import { memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
|
|
12
|
+
import { asciiSafeStringify, assertNoDuplicateBibleIds, BIBLE_FORMAT_VERSION, bibleContentChanged, commitBiblePath, compareById, isGitRepo, readBibleEntries, requireLocalFolder, toCanonicalEntry, withSourceFileHashes, } from './kb-export.js';
|
|
13
|
+
// kb_bible_commit: the kb_maintainer commits one review round's confirmations
|
|
14
|
+
// to the bible, merging at ENTRY level: the given ids are added or replaced,
|
|
15
|
+
// and every entry already in <self>/.fleet/kb-canonical.json is kept UNLESS
|
|
16
|
+
// this (the maintainer's) KB holds it as superseded or invalidated -- those
|
|
17
|
+
// are removed, and each removal (id + reason) is listed in the response and in
|
|
18
|
+
// the commit message. Removal runs at every call, also with no ids. An entry
|
|
19
|
+
// in the file but absent from the DB is never dropped, nor is one the DB holds
|
|
20
|
+
// as CONFIRMED and current. That keeps a retry after a rejected push safe: the
|
|
21
|
+
// engine resets to the new remote HEAD (which may carry another clone's
|
|
22
|
+
// entries, unknown to this DB) and calls this again with the same ids -- the
|
|
23
|
+
// result holds both sets with no manual merge.
|
|
24
|
+
//
|
|
25
|
+
// A merely STALE entry (freshness sweep: its cited files moved) is NOT removed:
|
|
26
|
+
// the owner decision names only superseded and invalidated, and staleness can
|
|
27
|
+
// clear on its own (see SqliteProvider.getRetirementReasons).
|
|
28
|
+
//
|
|
29
|
+
// kb_export is untouched by this: it stays additive-only.
|
|
30
|
+
//
|
|
31
|
+
// Legacy backfill: an entry already in the bible with no source_file_hashes
|
|
32
|
+
// (carried over from a v1/v2 bible) gains the STORED basis this KB holds for
|
|
33
|
+
// the same id, when that basis passes the bible admission predicate at HEAD and
|
|
34
|
+
// the KB entry cites exactly the bible entry's source_files
|
|
35
|
+
// (selectLegacyBibleBackfill). Only source_file_hashes is added; id, text,
|
|
36
|
+
// confidence and every other field stay as they are, and an entry that does not
|
|
37
|
+
// qualify is kept unchanged (never dropped). A backfill is a change: the bible
|
|
38
|
+
// is rewritten at the current format version and committed, and the response
|
|
39
|
+
// and the commit message report the number of backfilled entries.
|
|
40
|
+
//
|
|
41
|
+
// Provenance records the sprint's TARGET BASE branch and the base commit the
|
|
42
|
+
// entries were verified against, as given by the caller -- never the HEAD of
|
|
43
|
+
// the working folder, which is typically a feature branch.
|
|
44
|
+
//
|
|
45
|
+
// The commit is local, pathspec-scoped to the bible file, with the pm-kb
|
|
46
|
+
// identity (shared with kb_export). It is NEVER pushed.
|
|
47
|
+
//
|
|
48
|
+
// Trust anchor: when called from a FULL or kb_maintainer session, the blob id
|
|
49
|
+
// of every bible this writes is recorded in the per-repo KB DB, which is what
|
|
50
|
+
// lets a member session without the grant import that bible (kb-import.ts).
|
|
51
|
+
export const kbBibleCommitSchema = z.object({
|
|
52
|
+
ids: z.array(z.string().min(1))
|
|
53
|
+
.describe('Ids of the entries confirmed this round. Each must be a live (non-stale, non-superseded) CONFIRMED entry in this repository\'s KB whose recorded file basis still matches the cited files at the repo\'s HEAD commit (the same rule kb_export applies; uncommitted edits are ignored); any other id is skipped and reported in skipped (reason not_confirmed_or_unknown, no_source_files for a CONFIRMED entry citing no source file, or basis_mismatch). Independently of the ids, every bible entry this KB holds as superseded or invalidated is removed and reported in removed; an empty list with no such entry makes no commit.'),
|
|
54
|
+
baseBranch: z.string().min(1)
|
|
55
|
+
.describe('The sprint\'s target base branch (the branch the work merges into). Written to provenance.branch.'),
|
|
56
|
+
baseCommit: z.string().min(1)
|
|
57
|
+
.describe('The base commit the entries were verified against. Written to provenance.commit.'),
|
|
58
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
59
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
60
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
61
|
+
});
|
|
62
|
+
export async function kbBibleCommit(input, anchor) {
|
|
63
|
+
const resolved = resolveKbAnchor(anchor);
|
|
64
|
+
const repoPath = requireLocalFolder(resolved.folder, 'kb_bible_commit');
|
|
65
|
+
const outPath = path.join(repoPath, '.fleet', 'kb-canonical.json');
|
|
66
|
+
const requested = Array.from(new Set(input.ids));
|
|
67
|
+
const done = (r) => JSON.stringify({ path: outPath, ...r });
|
|
68
|
+
// No ids and no bible entry that could be removed: nothing to do, and the
|
|
69
|
+
// KB is not opened.
|
|
70
|
+
const existingAtStart = readBibleEntries(outPath);
|
|
71
|
+
if (requested.length === 0 && (existingAtStart === null || existingAtStart.length === 0)) {
|
|
72
|
+
return done({ merged: [], skipped: [], removed: [], entry_count: existingAtStart?.length ?? 0, backfilled: 0, committed: false });
|
|
73
|
+
}
|
|
74
|
+
const providers = await getKbProviders(repoPath, resolved.remoteUrl);
|
|
75
|
+
const project = requireSqliteProject(providers.project, 'kb_bible_commit');
|
|
76
|
+
const confirmedEntries = await project.list({ confidence: ['CONFIRMED'] });
|
|
77
|
+
const requestedSet = new Set(requested);
|
|
78
|
+
// ONE admission rule with kb_export (scope=project): a CONFIRMED id is
|
|
79
|
+
// admitted only if it passes the shared bible basis predicate. (With no
|
|
80
|
+
// requested ids this is empty and admission, including its git check, is
|
|
81
|
+
// not run.)
|
|
82
|
+
const requestedConfirmed = confirmedEntries.filter(e => requestedSet.has(e.id));
|
|
83
|
+
const bases = project.getSourceFileBases(requestedConfirmed.map(e => e.id));
|
|
84
|
+
const qualifying = await filterProjectBibleCandidates(requestedConfirmed, bases, repoPath);
|
|
85
|
+
const qualifyingIds = new Set(qualifying.map(e => e.id));
|
|
86
|
+
const confirmedIds = new Set(requestedConfirmed.map(e => e.id));
|
|
87
|
+
const noSourceIds = new Set(requestedConfirmed
|
|
88
|
+
.filter(e => !Array.isArray(e.source_files) || e.source_files.length === 0)
|
|
89
|
+
.map(e => e.id));
|
|
90
|
+
const confirmed = new Map();
|
|
91
|
+
// Format v3: each merged entry carries the exact stored basis it was just
|
|
92
|
+
// admitted against (never re-hashed here).
|
|
93
|
+
for (const e of qualifying)
|
|
94
|
+
confirmed.set(e.id, toCanonicalEntry(e, bases.get(e.id)));
|
|
95
|
+
const merged = [];
|
|
96
|
+
const skipped = [];
|
|
97
|
+
for (const id of requested) {
|
|
98
|
+
if (qualifyingIds.has(id))
|
|
99
|
+
merged.push(id);
|
|
100
|
+
else if (noSourceIds.has(id)) {
|
|
101
|
+
// An id already in the bible keeps its existing entry: the merge never drops entries.
|
|
102
|
+
logWarn('kb_bible_commit', 'skipping ' + id + ': no_source_files (a CONFIRMED entry citing no source file has no checkable basis)');
|
|
103
|
+
skipped.push({ id, reason: 'no_source_files' });
|
|
104
|
+
}
|
|
105
|
+
else if (confirmedIds.has(id)) {
|
|
106
|
+
// An id already in the bible keeps its existing entry: the merge never drops entries.
|
|
107
|
+
logWarn('kb_bible_commit', 'skipping ' + id + ': basis_mismatch (cited files at HEAD changed or absent, or basis absent)');
|
|
108
|
+
skipped.push({ id, reason: 'basis_mismatch' });
|
|
109
|
+
}
|
|
110
|
+
else
|
|
111
|
+
skipped.push({ id, reason: 'not_confirmed_or_unknown' });
|
|
112
|
+
}
|
|
113
|
+
// A bible file that exists but cannot be parsed must not be overwritten: its
|
|
114
|
+
// entries are unknown, and writing over it would drop all of them.
|
|
115
|
+
const existing = existingAtStart;
|
|
116
|
+
if (existing === null && fs.existsSync(outPath)) {
|
|
117
|
+
throw new Error('kb_bible_commit: existing bible is not a readable bible file, refusing to overwrite it: ' + outPath);
|
|
118
|
+
}
|
|
119
|
+
// Removals: a bible entry this KB holds as superseded or invalidated. An id
|
|
120
|
+
// unknown to this KB, or known and not retired, is kept. A merged id is never
|
|
121
|
+
// retired (merging requires a live CONFIRMED entry), so the two never clash.
|
|
122
|
+
const retired = project.getRetirementReasons((existing ?? []).map(e => e.id));
|
|
123
|
+
const removed = (existing ?? [])
|
|
124
|
+
.filter(e => retired.has(e.id))
|
|
125
|
+
.map(e => ({ id: e.id, reason: retired.get(e.id) }))
|
|
126
|
+
.sort(compareById);
|
|
127
|
+
// Legacy backfill: existing entries with no carried basis, not merged (a
|
|
128
|
+
// merged id gets its fresh entry and basis anyway) and not removed. The
|
|
129
|
+
// predicate needs a git work tree; a folder that is not one has nothing
|
|
130
|
+
// backfilled (no disk fallback) rather than failing a removal-only call.
|
|
131
|
+
const mergedSet = new Set(merged);
|
|
132
|
+
const removedSet = new Set(removed.map(r => r.id));
|
|
133
|
+
const legacy = (existing ?? []).filter(e => !hasCarriedBasis(e) && !mergedSet.has(e.id) && !removedSet.has(e.id));
|
|
134
|
+
let backfill = new Map();
|
|
135
|
+
if (legacy.length > 0 && isGitRepo(repoPath)) {
|
|
136
|
+
const legacyIds = new Set(legacy.map(e => e.id));
|
|
137
|
+
const kbLegacy = confirmedEntries.filter(e => legacyIds.has(e.id));
|
|
138
|
+
if (kbLegacy.length > 0) {
|
|
139
|
+
backfill = await selectLegacyBibleBackfill(legacy, kbLegacy, project.getSourceFileBases(kbLegacy.map(e => e.id)), repoPath);
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
const backfilled = backfill.size;
|
|
143
|
+
if (merged.length === 0 && removed.length === 0 && backfilled === 0) {
|
|
144
|
+
return done({ merged, skipped, removed, entry_count: existing?.length ?? 0, backfilled, committed: false });
|
|
145
|
+
}
|
|
146
|
+
// Duplicate-id guard: an existing file holding one id twice would otherwise
|
|
147
|
+
// be silently collapsed by the id map below (dropping an entry). Refuse
|
|
148
|
+
// before anything is written.
|
|
149
|
+
assertNoDuplicateBibleIds(existing ?? [], 'kb_bible_commit');
|
|
150
|
+
const byId = new Map();
|
|
151
|
+
for (const e of existing ?? []) {
|
|
152
|
+
const basis = backfill.get(e.id);
|
|
153
|
+
byId.set(e.id, basis ? withSourceFileHashes(e, basis) : e);
|
|
154
|
+
}
|
|
155
|
+
for (const r of removed)
|
|
156
|
+
byId.delete(r.id);
|
|
157
|
+
for (const id of merged)
|
|
158
|
+
byId.set(id, confirmed.get(id));
|
|
159
|
+
const entries = Array.from(byId.values()).sort(compareById);
|
|
160
|
+
assertNoDuplicateBibleIds(entries, 'kb_bible_commit');
|
|
161
|
+
// Entries unchanged is a no-op: no rewrite, no commit (provenance alone never
|
|
162
|
+
// counts as a change, matching kb_export).
|
|
163
|
+
if (existing !== null && asciiSafeStringify(existing) === asciiSafeStringify(entries)) {
|
|
164
|
+
return done({ merged, skipped, removed, entry_count: entries.length, backfilled, committed: false });
|
|
165
|
+
}
|
|
166
|
+
const bible = {
|
|
167
|
+
version: BIBLE_FORMAT_VERSION,
|
|
168
|
+
provenance: {
|
|
169
|
+
commit: input.baseCommit,
|
|
170
|
+
branch: input.baseBranch,
|
|
171
|
+
entry_count: entries.length,
|
|
172
|
+
},
|
|
173
|
+
entries,
|
|
174
|
+
};
|
|
175
|
+
fs.mkdirSync(path.dirname(outPath), { recursive: true });
|
|
176
|
+
const written = Buffer.from(asciiSafeStringify(bible) + '\n', 'utf-8');
|
|
177
|
+
fs.writeFileSync(outPath, written);
|
|
178
|
+
let committed = false;
|
|
179
|
+
if (isGitRepo(repoPath) && bibleContentChanged(repoPath, outPath)) {
|
|
180
|
+
const message = bibleCommitMessage(merged.length, removed, entries.length, backfilled);
|
|
181
|
+
try {
|
|
182
|
+
commitBiblePath(repoPath, outPath, message);
|
|
183
|
+
}
|
|
184
|
+
catch (err) {
|
|
185
|
+
const reason = err instanceof Error ? err.message : String(err);
|
|
186
|
+
throw new Error('kb_bible_commit: bible written but the local commit failed: ' + reason);
|
|
187
|
+
}
|
|
188
|
+
committed = true;
|
|
189
|
+
}
|
|
190
|
+
// kb_import trust anchor: record the blob id of the bible just written, so
|
|
191
|
+
// a member session without the kb_maintainer grant may import it once it is
|
|
192
|
+
// committed in (or pulled into) any checkout of this repository. Only the
|
|
193
|
+
// maintainer side records: kb_bible_commit is served to every member
|
|
194
|
+
// session, and a session without the grant merges over whatever its own
|
|
195
|
+
// work-tree bible holds (possibly hand-edited), so its output must not
|
|
196
|
+
// become trusted. A FULL session and the kb_maintainer session record.
|
|
197
|
+
if (!memberLacksKbMaintainer(anchor)) {
|
|
198
|
+
// The id of the exact bytes written (LF, unfiltered), hashed in-process:
|
|
199
|
+
// never `git hash-object` on the path, which would re-read the file and
|
|
200
|
+
// run the checkout's member-configured clean filters.
|
|
201
|
+
project.recordTrustedBibleBlob(await bibleBytesBlobId(repoPath, written), 'kb_bible_commit');
|
|
202
|
+
}
|
|
203
|
+
return done({ merged, skipped, removed, entry_count: entries.length, backfilled, committed });
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* The bible commit message. The subject counts merged and removed entries;
|
|
207
|
+
* when entries were removed, the body lists each one as '- <id> (<reason>)'.
|
|
208
|
+
* With no removals and no backfill the message is the single pre-existing
|
|
209
|
+
* subject line. A legacy backfill (existing entries that gained
|
|
210
|
+
* source_file_hashes) adds a body line 'Backfilled source_file_hashes on <n>
|
|
211
|
+
* existing entries.'; a backfill-only commit names the count in its own subject.
|
|
212
|
+
*/
|
|
213
|
+
export function bibleCommitMessage(mergedCount, removed, total, backfilled = 0) {
|
|
214
|
+
let subject;
|
|
215
|
+
if (mergedCount === 0 && removed.length === 0 && backfilled > 0) {
|
|
216
|
+
subject = 'chore(kb): backfill source_file_hashes on ' + backfilled + ' knowledge bible entries -- ' + total + ' total';
|
|
217
|
+
}
|
|
218
|
+
else if (removed.length === 0) {
|
|
219
|
+
subject = 'chore(kb): commit ' + mergedCount + ' confirmed entries to the knowledge bible -- ' + total + ' total';
|
|
220
|
+
}
|
|
221
|
+
else if (mergedCount === 0) {
|
|
222
|
+
subject = 'chore(kb): remove ' + removed.length + ' superseded/invalidated entries from the knowledge bible -- '
|
|
223
|
+
+ total + ' total';
|
|
224
|
+
}
|
|
225
|
+
else {
|
|
226
|
+
subject = 'chore(kb): commit ' + mergedCount + ' confirmed entries to the knowledge bible, remove '
|
|
227
|
+
+ removed.length + ' superseded/invalidated -- ' + total + ' total';
|
|
228
|
+
}
|
|
229
|
+
const body = [];
|
|
230
|
+
if (removed.length > 0)
|
|
231
|
+
body.push('Removed:\n' + removed.map(r => '- ' + r.id + ' (' + r.reason + ')').join('\n'));
|
|
232
|
+
// A backfill-only subject already names the count.
|
|
233
|
+
if (backfilled > 0 && (mergedCount > 0 || removed.length > 0))
|
|
234
|
+
body.push('Backfilled source_file_hashes on ' + backfilled + ' existing entries.');
|
|
235
|
+
if (body.length === 0)
|
|
236
|
+
return subject;
|
|
237
|
+
return subject + '\n\n' + body.join('\n\n');
|
|
238
|
+
}
|
|
239
|
+
//# sourceMappingURL=kb-bible-commit.js.map
|
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbCaptureSchema: 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
|
type: z.ZodEnum<["context-cache", "learning", "knowledge", "runbook", "user-directive"]>;
|
|
5
8
|
title: z.ZodString;
|
|
6
9
|
summary: z.ZodString;
|
|
@@ -14,40 +17,41 @@ export declare const kbCaptureSchema: z.ZodObject<{
|
|
|
14
17
|
confidence: z.ZodOptional<z.ZodEnum<["CONFIRMED", "INFERRED", "UNVERIFIED"]>>;
|
|
15
18
|
scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
|
|
16
19
|
supersedes: z.ZodOptional<z.ZodString>;
|
|
17
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
18
20
|
}, "strip", z.ZodTypeAny, {
|
|
19
21
|
content: string;
|
|
20
22
|
type: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive";
|
|
21
23
|
title: string;
|
|
22
24
|
summary: string;
|
|
23
|
-
role?: string | undefined;
|
|
24
25
|
tags?: string[] | undefined;
|
|
26
|
+
role?: string | undefined;
|
|
27
|
+
repo?: unknown;
|
|
25
28
|
source_files?: string[] | undefined;
|
|
26
29
|
symbols?: string[] | undefined;
|
|
27
30
|
module?: string | undefined;
|
|
28
31
|
supersedes?: string | undefined;
|
|
29
32
|
confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
|
|
30
33
|
scope?: "project" | "global" | undefined;
|
|
31
|
-
repo_path?:
|
|
32
|
-
repo_remote_url?:
|
|
34
|
+
repo_path?: unknown;
|
|
35
|
+
repo_remote_url?: unknown;
|
|
33
36
|
source_file?: string | undefined;
|
|
34
37
|
}, {
|
|
35
38
|
content: string;
|
|
36
39
|
type: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive";
|
|
37
40
|
title: string;
|
|
38
41
|
summary: string;
|
|
39
|
-
role?: string | undefined;
|
|
40
42
|
tags?: string[] | undefined;
|
|
43
|
+
role?: string | undefined;
|
|
44
|
+
repo?: unknown;
|
|
41
45
|
source_files?: string[] | undefined;
|
|
42
46
|
symbols?: string[] | undefined;
|
|
43
47
|
module?: string | undefined;
|
|
44
48
|
supersedes?: string | undefined;
|
|
45
49
|
confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
|
|
46
50
|
scope?: "project" | "global" | undefined;
|
|
47
|
-
repo_path?:
|
|
48
|
-
repo_remote_url?:
|
|
51
|
+
repo_path?: unknown;
|
|
52
|
+
repo_remote_url?: unknown;
|
|
49
53
|
source_file?: string | undefined;
|
|
50
54
|
}>;
|
|
51
55
|
export type KbCaptureInput = z.infer<typeof kbCaptureSchema>;
|
|
52
|
-
export declare function kbCapture(input: KbCaptureInput): Promise<string>;
|
|
56
|
+
export declare function kbCapture(input: KbCaptureInput, anchor?: KbAnchor): Promise<string>;
|
|
53
57
|
//# sourceMappingURL=kb-capture.d.ts.map
|
package/dist/tools/kb-capture.js
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
2
3
|
import { computeFileHash } from '../services/knowledge/kb-service.js';
|
|
3
|
-
import {
|
|
4
|
+
import { getSelfKbProviders, memberOwnerTag } from '../services/knowledge/kb-self.js';
|
|
4
5
|
import { validateFilePaths } from '../services/knowledge/path-validation.js';
|
|
5
|
-
import {
|
|
6
|
+
import { memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
|
|
7
|
+
import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
6
8
|
// D5 (T2.3): the full Author enum. Kept as a plain array (not a zod enum on
|
|
7
9
|
// the schema itself) so an invalid role hint degrades to 'unknown' at the
|
|
8
10
|
// handler rather than rejecting the whole capture call at the schema layer.
|
|
@@ -17,9 +19,6 @@ function validateAuthor(role) {
|
|
|
17
19
|
return 'unknown';
|
|
18
20
|
}
|
|
19
21
|
export const kbCaptureSchema = z.object({
|
|
20
|
-
...kbScopeFields,
|
|
21
|
-
repo_path: z.string().optional()
|
|
22
|
-
.describe('Path to the repo root this call is about. Selects WHICH project KB is read/written. When omitted, falls back to the calling process cwd, which is only correct for single-repo CLI use -- server-handled tool calls must pass it explicitly.'),
|
|
23
22
|
type: z.enum(['context-cache', 'learning', 'knowledge', 'runbook', 'user-directive'])
|
|
24
23
|
.describe('Content type: context-cache for file summaries, learning for session insights, knowledge for facts, runbook for procedures, user-directive for a standing user instruction/correction. NOTE (F1/D1): a user-directive captured here is stored as a PENDING PROPOSAL (UNVERIFIED, flagged for review, scope forced to project) -- it is NOT an active directive and does NOT gain any trust semantics until a human approves it in their own terminal via "apra-fleet kb approve-directive <id>". MCP cannot mint an active directive.'),
|
|
25
24
|
title: z.string().min(1).describe('Short description (max ~80 chars)'),
|
|
@@ -37,14 +36,17 @@ export const kbCaptureSchema = z.object({
|
|
|
37
36
|
scope: z.enum(['project', 'global']).optional()
|
|
38
37
|
.describe('Scope: project (default) or global for team-wide conventions'),
|
|
39
38
|
supersedes: z.string().optional()
|
|
40
|
-
.describe('Id of an entry this capture REPLACES. Only honored when AUDN independently matches that same entry as a same-topic candidate (same type, overlapping symbols and source_files), so it cannot retire an arbitrary entry. Omit it unless you mean to retire something -- an ordinary refinement links to its predecessor and both stay live. The KB Agent sets this when resolving a flagged pair; doer/reviewer captures should not.'),
|
|
39
|
+
.describe('Id of an entry this capture REPLACES. Only honored when AUDN independently matches that same entry as a same-topic candidate (same type, overlapping symbols and source_files), so it cannot retire an arbitrary entry. Omit it unless you mean to retire something -- an ordinary refinement links to its predecessor and both stay live. The KB Agent sets this when resolving a flagged pair; doer/reviewer captures should not. In a MEMBER session without the kb_maintainer grant a CONFIRMED target is never retired: the capture links to it (refines, both stay live) and the response lists it in refused.'),
|
|
40
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
41
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
42
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
41
43
|
});
|
|
42
|
-
export async function kbCapture(input) {
|
|
44
|
+
export async function kbCapture(input, anchor) {
|
|
43
45
|
if (input.source_files?.length)
|
|
44
46
|
validateFilePaths(input.source_files);
|
|
45
47
|
if (input.source_file)
|
|
46
48
|
validateFilePaths([input.source_file]);
|
|
47
|
-
const providers = await
|
|
49
|
+
const providers = await getSelfKbProviders(anchor);
|
|
48
50
|
let content_hash = '';
|
|
49
51
|
let content_hash_type = 'sha256';
|
|
50
52
|
if (input.type === 'context-cache' && input.source_file) {
|
|
@@ -110,6 +112,14 @@ export async function kbCapture(input) {
|
|
|
110
112
|
tags = [...tags, 'directive:pending'];
|
|
111
113
|
}
|
|
112
114
|
}
|
|
115
|
+
// A MEMBER session's capture lands in the machine's per-repo DB tagged with
|
|
116
|
+
// the caller's member:<uuid>, so its unconfirmed knowledge stays its own:
|
|
117
|
+
// MEMBER INFERRED/UNVERIFIED reads, kb_promote and kb_invalidate only ever
|
|
118
|
+
// see entries carrying that tag (kb-self.ts memberOwnerTag).
|
|
119
|
+
const ownerTag = memberOwnerTag(anchor);
|
|
120
|
+
if (ownerTag !== undefined && !tags.includes(ownerTag)) {
|
|
121
|
+
tags = [...tags, ownerTag];
|
|
122
|
+
}
|
|
113
123
|
// my-beads-db-0d3.2: derived, not set per branch. The flag used to be set
|
|
114
124
|
// only by the CONFIRMED clamp above, so a user-directive -- quarantined to
|
|
115
125
|
// UNVERIFIED just above -- reported false while its request was not
|
|
@@ -131,7 +141,18 @@ export async function kbCapture(input) {
|
|
|
131
141
|
: author === 'reviewer'
|
|
132
142
|
? 'review'
|
|
133
143
|
: 'session';
|
|
134
|
-
|
|
144
|
+
// A MEMBER session WITHOUT the kb_maintainer grant may not retire a
|
|
145
|
+
// CONFIRMED entry through supersedes (a retired entry leaves the bible at the
|
|
146
|
+
// next kb_bible_commit), whoever owns it -- AUDN matches candidates across the
|
|
147
|
+
// whole per-repo DB. Over the per-repo SqliteProvider the explicit supersede
|
|
148
|
+
// of a CONFIRMED target degrades to the implicit link (refines, both live);
|
|
149
|
+
// a non-CONFIRMED target is still retired. A remote provider cannot be told
|
|
150
|
+
// about the grant, so there supersedes is dropped (fail closed) and the id
|
|
151
|
+
// reported. `refused` (E-RETIRE-NEEDS-KB-MAINTAINER, response field, same as
|
|
152
|
+
// kb_invalidate) is present exactly when such a session passed supersedes.
|
|
153
|
+
const keepConfirmed = input.supersedes !== undefined && memberLacksKbMaintainer(anchor);
|
|
154
|
+
const remoteRefused = keepConfirmed && !isSqliteProject(target);
|
|
155
|
+
const entryInput = {
|
|
135
156
|
type: input.type,
|
|
136
157
|
title: input.title,
|
|
137
158
|
summary: input.summary,
|
|
@@ -147,8 +168,18 @@ export async function kbCapture(input) {
|
|
|
147
168
|
source,
|
|
148
169
|
confidence,
|
|
149
170
|
scope,
|
|
150
|
-
supersedes: input.supersedes,
|
|
151
|
-
}
|
|
171
|
+
supersedes: remoteRefused ? undefined : input.supersedes,
|
|
172
|
+
};
|
|
173
|
+
const result = keepConfirmed && isSqliteProject(target)
|
|
174
|
+
? await target.capture(entryInput, { keepConfirmed: true })
|
|
175
|
+
: await target.capture(entryInput);
|
|
176
|
+
const { id, audn_decision } = result;
|
|
177
|
+
if (keepConfirmed) {
|
|
178
|
+
const refused = remoteRefused
|
|
179
|
+
? [input.supersedes]
|
|
180
|
+
: ('refused' in result && Array.isArray(result.refused) ? result.refused : []);
|
|
181
|
+
return JSON.stringify({ id, audn_decision, confidence_clamped, refused });
|
|
182
|
+
}
|
|
152
183
|
return JSON.stringify({ id, audn_decision, confidence_clamped });
|
|
153
184
|
}
|
|
154
185
|
//# sourceMappingURL=kb-capture.js.map
|
|
@@ -1,17 +1,37 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbContextSchema: 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>;
|
|
7
|
+
confidence: z.ZodOptional<z.ZodArray<z.ZodEnum<["CONFIRMED", "INFERRED", "UNVERIFIED"]>, "many">>;
|
|
4
8
|
files: z.ZodArray<z.ZodString, "many">;
|
|
5
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
6
9
|
}, "strip", z.ZodTypeAny, {
|
|
7
10
|
files: string[];
|
|
8
|
-
|
|
9
|
-
|
|
11
|
+
repo?: unknown;
|
|
12
|
+
confidence?: ("CONFIRMED" | "INFERRED" | "UNVERIFIED")[] | undefined;
|
|
13
|
+
repo_path?: unknown;
|
|
14
|
+
repo_remote_url?: unknown;
|
|
10
15
|
}, {
|
|
11
16
|
files: string[];
|
|
12
|
-
|
|
13
|
-
|
|
17
|
+
repo?: unknown;
|
|
18
|
+
confidence?: ("CONFIRMED" | "INFERRED" | "UNVERIFIED")[] | undefined;
|
|
19
|
+
repo_path?: unknown;
|
|
20
|
+
repo_remote_url?: unknown;
|
|
14
21
|
}>;
|
|
15
22
|
export type KbContextInput = z.infer<typeof kbContextSchema>;
|
|
16
|
-
|
|
23
|
+
type Tier = NonNullable<KbContextInput['confidence']>[number];
|
|
24
|
+
/**
|
|
25
|
+
* kb_context's default tier set when the caller names none: CONFIRMED and
|
|
26
|
+
* INFERRED, undisputed only. Unlike kb_query/kb_list (whose default is
|
|
27
|
+
* CONFIRMED-only, because their entries are claims a reader acts on), kb_context
|
|
28
|
+
* only answers "is my cached summary of this file still current?", and that is
|
|
29
|
+
* decided mechanically by the entry's content hash against the file on disk.
|
|
30
|
+
* kb_capture stores at most INFERRED and context-cache entries are rarely
|
|
31
|
+
* promoted, so a CONFIRMED-only default reported almost every file missing.
|
|
32
|
+
* UNVERIFIED (harvest output) stays opt-in.
|
|
33
|
+
*/
|
|
34
|
+
export declare const KB_CONTEXT_DEFAULT_CONFIDENCE: readonly Tier[];
|
|
35
|
+
export declare function kbContext(input: KbContextInput, anchor?: KbAnchor): Promise<string>;
|
|
36
|
+
export {};
|
|
17
37
|
//# sourceMappingURL=kb-context.d.ts.map
|
package/dist/tools/kb-context.js
CHANGED
|
@@ -1,21 +1,72 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import {
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
3
|
+
import { getSelfReadKb } from '../services/knowledge/kb-self.js';
|
|
4
|
+
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
3
5
|
import { validateFilePaths } from '../services/knowledge/path-validation.js';
|
|
4
|
-
import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
|
|
5
6
|
export const kbContextSchema = z.object({
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
.describe('Path to the repo root this call is about. Selects WHICH project KB is read/written. When omitted, falls back to the calling process cwd, which is only correct for single-repo CLI use -- server-handled tool calls must pass it explicitly.'),
|
|
7
|
+
confidence: z.array(z.enum(['CONFIRMED', 'INFERRED', 'UNVERIFIED'])).min(1).optional()
|
|
8
|
+
.describe('Only consider cached file entries whose confidence tier is in this list. Default when omitted: ["CONFIRMED","INFERRED"], undisputed entries only -- a context-cache entry is verified by its content hash, and captures are stored at most INFERRED, so a CONFIRMED-only default would report almost every file missing. UNVERIFIED entries are considered only when listed explicitly.'),
|
|
9
9
|
files: z.array(z.string()).min(1).describe('File paths to check freshness for'),
|
|
10
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
11
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
12
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
10
13
|
});
|
|
11
|
-
|
|
14
|
+
/**
|
|
15
|
+
* kb_context's default tier set when the caller names none: CONFIRMED and
|
|
16
|
+
* INFERRED, undisputed only. Unlike kb_query/kb_list (whose default is
|
|
17
|
+
* CONFIRMED-only, because their entries are claims a reader acts on), kb_context
|
|
18
|
+
* only answers "is my cached summary of this file still current?", and that is
|
|
19
|
+
* decided mechanically by the entry's content hash against the file on disk.
|
|
20
|
+
* kb_capture stores at most INFERRED and context-cache entries are rarely
|
|
21
|
+
* promoted, so a CONFIRMED-only default reported almost every file missing.
|
|
22
|
+
* UNVERIFIED (harvest output) stays opt-in.
|
|
23
|
+
*/
|
|
24
|
+
export const KB_CONTEXT_DEFAULT_CONFIDENCE = Object.freeze(['CONFIRMED', 'INFERRED']);
|
|
25
|
+
const STATUS_RANK = { fresh: 2, stale: 1, missing: 0 };
|
|
26
|
+
/** Per file, the best of two result sets (fresh > stale > missing; first wins a tie). */
|
|
27
|
+
function mergeByFile(primary, secondary) {
|
|
28
|
+
const byFile = new Map(secondary.map(r => [r.file, r]));
|
|
29
|
+
return primary.map((r) => {
|
|
30
|
+
const other = byFile.get(r.file);
|
|
31
|
+
return other && STATUS_RANK[other.status] > STATUS_RANK[r.status] ? other : r;
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
export async function kbContext(input, anchor) {
|
|
12
35
|
validateFilePaths(input.files);
|
|
13
|
-
const
|
|
14
|
-
|
|
36
|
+
const explicit = input.confidence?.length ? input.confidence : undefined;
|
|
37
|
+
const confidence = (explicit ?? [...KB_CONTEXT_DEFAULT_CONFIDENCE]);
|
|
38
|
+
// Default-trusted read: undisputed unless a tier list is given.
|
|
39
|
+
const excludeDisputed = explicit === undefined;
|
|
40
|
+
// MEMBER session -> the checkout bible view (kb-self.ts getSelfReadKb) for
|
|
41
|
+
// the CONFIRMED tier; an INFERRED/UNVERIFIED request goes to the per-repo DB,
|
|
42
|
+
// own captures only (ownerTag).
|
|
43
|
+
const read = await getSelfReadKb(anchor, explicit);
|
|
44
|
+
const { providers } = read;
|
|
45
|
+
let results;
|
|
46
|
+
if (explicit === undefined && read.memberView) {
|
|
47
|
+
// MEMBER default: the checkout bible's CONFIRMED entries merged with the
|
|
48
|
+
// member's OWN CONFIRMED/INFERRED captures from the per-repo DB, so the
|
|
49
|
+
// INFERRED half of the default never exposes another member's captures and
|
|
50
|
+
// never hides the bible's.
|
|
51
|
+
const own = await getSelfReadKb(anchor, confidence);
|
|
52
|
+
const fromBible = await providers.project.context(input.files, ['CONFIRMED'], excludeDisputed);
|
|
53
|
+
const fromOwn = await requireSqliteProject(own.providers.project, 'kb_context')
|
|
54
|
+
.context(input.files, confidence, excludeDisputed, own.ownerTag);
|
|
55
|
+
results = mergeByFile(fromBible, fromOwn);
|
|
56
|
+
}
|
|
57
|
+
else if (read.ownerTag !== undefined) {
|
|
58
|
+
results = await requireSqliteProject(providers.project, 'kb_context').context(input.files, confidence, excludeDisputed, read.ownerTag);
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
results = await providers.project.context(input.files, confidence, excludeDisputed);
|
|
62
|
+
}
|
|
15
63
|
// Fallback to global if project has no results
|
|
16
64
|
const hasFresh = results.some(r => r.status === 'fresh');
|
|
17
65
|
if (!hasFresh) {
|
|
18
|
-
|
|
66
|
+
// A MEMBER default read keeps the global fallback CONFIRMED-only: the global
|
|
67
|
+
// KB is machine-wide, so its INFERRED tier is not the member's own.
|
|
68
|
+
const globalTiers = explicit === undefined && read.memberView ? ['CONFIRMED'] : confidence;
|
|
69
|
+
const globalResults = await providers.global.context(input.files, globalTiers, excludeDisputed, read.ownerTag);
|
|
19
70
|
const hasFreshGlobal = globalResults.some(r => r.status === 'fresh');
|
|
20
71
|
if (hasFreshGlobal) {
|
|
21
72
|
results = globalResults;
|