@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
package/dist/tools/kb-harvest.js
CHANGED
|
@@ -1,21 +1,24 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
3
|
+
import { getSelfKbProviders } from '../services/knowledge/kb-self.js';
|
|
4
4
|
import { KbCaptureRejected } from '../services/knowledge/types.js';
|
|
5
|
+
import { logWarn } from '../utils/log-helpers.js';
|
|
5
6
|
export const kbHarvestSchema = z.object({
|
|
6
|
-
...kbScopeFields,
|
|
7
|
-
repo_path: z.string().optional()
|
|
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.'),
|
|
9
7
|
session_transcript: z.string().optional()
|
|
10
8
|
.describe('Full session transcript text to scan for learnings'),
|
|
11
9
|
session_id: z.string().optional()
|
|
12
10
|
.describe('Session ID for attribution'),
|
|
11
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
12
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
13
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
13
14
|
});
|
|
14
15
|
const LEARNING_PATTERNS = [
|
|
15
16
|
/(?:^|\n)\s*(?:I found that|Note:|Warning:|Bug:|Gotcha:|This means)\s*[:\-]?\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
|
|
16
17
|
/(?:^|\n)\s*(?:The (?:issue|problem|fix|solution|root cause) (?:is|was))\s*[:\-]?\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
|
|
17
18
|
/(?:^|\n)\s*(?:Important:|Key insight:|Lesson learned:|TIL:)\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
|
|
18
19
|
];
|
|
20
|
+
/** Longest first_error text carried into the kb_harvest response. */
|
|
21
|
+
const MAX_FIRST_ERROR_CHARS = 500;
|
|
19
22
|
const FILE_PATH_RE = /(?:^|\s)((?:src|lib|tests?|docs?)\/[\w./-]+\.\w+)/g;
|
|
20
23
|
const SYMBOL_RE = /`(\w{2,}(?:\.\w+)?(?:\(\))?)`/g;
|
|
21
24
|
function extractFilePaths(text) {
|
|
@@ -80,17 +83,22 @@ function extractLearnings(transcript) {
|
|
|
80
83
|
// entry captured here is forced to
|
|
81
84
|
// confidence='UNVERIFIED' (never CONFIRMED, covered by the D1 clamp) with
|
|
82
85
|
// author='harvest', source='harvest' so it is distinguishable in queries.
|
|
83
|
-
export async function kbHarvest(input) {
|
|
86
|
+
export async function kbHarvest(input, anchor) {
|
|
84
87
|
if (!input.session_transcript) {
|
|
85
|
-
return JSON.stringify({ entries_captured: 0, entries_updated: 0, entries_skipped: 0, entries_rejected: 0 });
|
|
88
|
+
return JSON.stringify({ entries_captured: 0, entries_updated: 0, entries_skipped: 0, entries_rejected: 0, entries_failed: 0 });
|
|
86
89
|
}
|
|
87
|
-
const providers = await
|
|
90
|
+
const providers = await getSelfKbProviders(anchor);
|
|
88
91
|
const provider = providers.project;
|
|
89
92
|
const learnings = extractLearnings(input.session_transcript);
|
|
90
93
|
let entries_captured = 0;
|
|
91
94
|
let entries_updated = 0;
|
|
92
95
|
let entries_skipped = 0;
|
|
93
96
|
let entries_rejected = 0;
|
|
97
|
+
let entries_failed = 0;
|
|
98
|
+
// The first non-rejection failure, reported only when nothing landed, so a
|
|
99
|
+
// harvest whose every capture failed (a broken DB, a server that is down)
|
|
100
|
+
// says why instead of hiding it in the count.
|
|
101
|
+
let first_error;
|
|
94
102
|
// D5 + revised D7 (T2.3): harvested entries are UNVERIFIED, regex-extracted,
|
|
95
103
|
// low-trust captures from the execute_prompt autowire -- distinct provenance
|
|
96
104
|
// from real KB-Agent captures (author='kb-agent', source='session'/'review').
|
|
@@ -111,12 +119,15 @@ export async function kbHarvest(input) {
|
|
|
111
119
|
source,
|
|
112
120
|
confidence: 'UNVERIFIED',
|
|
113
121
|
};
|
|
114
|
-
//
|
|
115
|
-
//
|
|
116
|
-
//
|
|
117
|
-
//
|
|
118
|
-
//
|
|
119
|
-
//
|
|
122
|
+
// Isolate each capture so one failure never costs the learnings after
|
|
123
|
+
// it: an unhandled throw here would abort the remaining entries and die
|
|
124
|
+
// silently, because auto-harvest is dispatched fire-and-forget with a bare
|
|
125
|
+
// .catch() in execute-prompt.ts. A capture refused for its basis
|
|
126
|
+
// (KB-TRUST PHASE 1: harvest's regex extraction often yields no file
|
|
127
|
+
// paths) is counted as rejected. Any other failure -- e.g. a remote KB
|
|
128
|
+
// server that is down, where the http provider queues nothing -- is
|
|
129
|
+
// logged with the entry title and counted as failed, so the caller sees
|
|
130
|
+
// that the harvest must be repeated.
|
|
120
131
|
let audn_decision;
|
|
121
132
|
try {
|
|
122
133
|
({ audn_decision } = await provider.capture(entryInput));
|
|
@@ -126,7 +137,11 @@ export async function kbHarvest(input) {
|
|
|
126
137
|
entries_rejected++;
|
|
127
138
|
continue;
|
|
128
139
|
}
|
|
129
|
-
|
|
140
|
+
entries_failed++;
|
|
141
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
142
|
+
first_error ??= message.length > MAX_FIRST_ERROR_CHARS ? `${message.slice(0, MAX_FIRST_ERROR_CHARS)}...` : message;
|
|
143
|
+
logWarn('kb-harvest', `capture of "${entryInput.title}" failed and was not stored: ${message}`);
|
|
144
|
+
continue;
|
|
130
145
|
}
|
|
131
146
|
if (audn_decision === 'add' || audn_decision === 'flagged') {
|
|
132
147
|
entries_captured++;
|
|
@@ -138,6 +153,10 @@ export async function kbHarvest(input) {
|
|
|
138
153
|
entries_skipped++;
|
|
139
154
|
}
|
|
140
155
|
}
|
|
141
|
-
|
|
156
|
+
const landed = entries_captured + entries_updated + entries_skipped;
|
|
157
|
+
return JSON.stringify({
|
|
158
|
+
entries_captured, entries_updated, entries_skipped, entries_rejected, entries_failed,
|
|
159
|
+
...(landed === 0 && first_error !== undefined ? { first_error } : {}),
|
|
160
|
+
});
|
|
142
161
|
}
|
|
143
162
|
//# sourceMappingURL=kb-harvest.js.map
|
|
@@ -1,24 +1,28 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbImportSchema: z.ZodObject<{
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
3
7
|
path: z.ZodOptional<z.ZodString>;
|
|
4
|
-
|
|
5
|
-
repo_path: z.ZodOptional<z.ZodString>;
|
|
8
|
+
ref: z.ZodOptional<z.ZodString>;
|
|
6
9
|
scope: z.ZodOptional<z.ZodLiteral<"project">>;
|
|
7
10
|
skip_sweep: z.ZodOptional<z.ZodBoolean>;
|
|
8
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
9
11
|
}, "strip", z.ZodTypeAny, {
|
|
10
12
|
path?: string | undefined;
|
|
11
13
|
scope?: "project" | undefined;
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
14
|
+
repo?: unknown;
|
|
15
|
+
repo_path?: unknown;
|
|
16
|
+
repo_remote_url?: unknown;
|
|
17
|
+
ref?: string | undefined;
|
|
15
18
|
skip_sweep?: boolean | undefined;
|
|
16
19
|
}, {
|
|
17
20
|
path?: string | undefined;
|
|
18
21
|
scope?: "project" | undefined;
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
+
repo?: unknown;
|
|
23
|
+
repo_path?: unknown;
|
|
24
|
+
repo_remote_url?: unknown;
|
|
25
|
+
ref?: string | undefined;
|
|
22
26
|
skip_sweep?: boolean | undefined;
|
|
23
27
|
}>;
|
|
24
28
|
export type KbImportInput = z.infer<typeof kbImportSchema>;
|
|
@@ -34,11 +38,39 @@ export interface KbImportReport {
|
|
|
34
38
|
* bible, so re-importing an old bible deliberately drops those entries.
|
|
35
39
|
*/
|
|
36
40
|
rejected: number;
|
|
41
|
+
/**
|
|
42
|
+
* Local rows taken CONFIRMED -> INFERRED by an EXPLICIT demotion tombstone in
|
|
43
|
+
* the imported bible -- the cross-clone half of kb_demote. Counts rows
|
|
44
|
+
* actually changed, not tombstones read: a tombstone naming an id this clone
|
|
45
|
+
* does not hold, or one whose row was re-promoted after the demotion, adds
|
|
46
|
+
* nothing. An entry merely ABSENT from the bible is never demoted.
|
|
47
|
+
*/
|
|
48
|
+
demoted: number;
|
|
37
49
|
sweep: {
|
|
38
50
|
checked: number;
|
|
39
51
|
staled: number;
|
|
40
52
|
unstaled: number;
|
|
41
53
|
};
|
|
54
|
+
/**
|
|
55
|
+
* Present exactly when the bible was read from git rather than the file
|
|
56
|
+
* system: the ref read ('HEAD' for a member session without the
|
|
57
|
+
* kb_maintainer grant and no `ref`; otherwise the `ref` given).
|
|
58
|
+
*/
|
|
59
|
+
bible_source?: string;
|
|
60
|
+
/**
|
|
61
|
+
* With bible_source: true when the work-tree .fleet/kb-canonical.json
|
|
62
|
+
* differed from (or was missing versus) the committed copy, so its
|
|
63
|
+
* uncommitted content was not imported.
|
|
64
|
+
*/
|
|
65
|
+
worktree_ignored?: boolean;
|
|
66
|
+
/**
|
|
67
|
+
* Present (true) exactly when the project KB is the http provider: the KB
|
|
68
|
+
* server is the source of truth, so the bible is neither read nor imported
|
|
69
|
+
* and every count is 0. `reason` says why.
|
|
70
|
+
*/
|
|
71
|
+
bible_skipped?: true;
|
|
72
|
+
reason?: string;
|
|
42
73
|
}
|
|
43
|
-
export declare
|
|
74
|
+
export declare const KB_IMPORT_HTTP_SKIP_REASON = "bible import is not used over the http KB provider: the KB server is the source of truth";
|
|
75
|
+
export declare function kbImport(input: KbImportInput, anchor?: KbAnchor): Promise<string>;
|
|
44
76
|
//# sourceMappingURL=kb-import.d.ts.map
|
package/dist/tools/kb-import.js
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
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
5
|
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
6
|
+
import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
|
|
7
|
+
import { parseBibleDocument, importBibleEntries } from '../services/knowledge/bible-import.js';
|
|
8
|
+
import { requireSqliteProject, isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
9
|
+
import { KbMaintainerGrantError, memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
|
|
10
|
+
import { OWN_BIBLE_REL, BibleBlobIntegrityError, bibleBytesBlobId, isSafeBibleRef, readCommittedBibleBlob, } from '../services/knowledge/bible-blob-id.js';
|
|
8
11
|
// T2.1 (F4, D3 HARDENED): kb_import -- the trusted-channel write path that lets a
|
|
9
12
|
// warm local KB absorb a merged-in bible (.fleet/kb-canonical.json). The
|
|
10
13
|
// cold-seed in kb_session_prime is OUTPUT-ONLY and fires only under
|
|
@@ -30,21 +33,64 @@ import { requireSqliteProject } from '../services/knowledge/require-sqlite-proje
|
|
|
30
33
|
// .fleet/kb-canonical.json; an explicit --path bible is CALLER-ASSERTED trust.
|
|
31
34
|
// The unforgeable tier remains user-directives, which are CLI-gated -- the
|
|
32
35
|
// directive gate quarantines them either way.
|
|
36
|
+
//
|
|
37
|
+
// MEMBER sessions: because an explicit path is equivalent in power to
|
|
38
|
+
// kb_promote (it keeps bible confidence, and a v3 bible's carried hashes are
|
|
39
|
+
// stored verbatim, so a hand-made bible can later pass kb_bible_commit
|
|
40
|
+
// admission), a member session WITHOUT the kb_maintainer grant is refused an
|
|
41
|
+
// explicit path with E-KB-MAINTAINER-REQUIRED -- the same sessions that are not
|
|
42
|
+
// served kb_promote. A path naming the session's own repo-resolved bible is
|
|
43
|
+
// the trusted channel and is allowed, as is no path at all (the engine's
|
|
44
|
+
// priming import). FULL sessions and the kb_maintainer session are unchanged.
|
|
45
|
+
//
|
|
46
|
+
// The own bible is only the trusted channel AS COMMITTED: the work-tree file
|
|
47
|
+
// is member-writable, so a member agent could hand-edit it (CONFIRMED entries
|
|
48
|
+
// plus v3 hashes matching HEAD) and import it without the grant. A member
|
|
49
|
+
// session WITHOUT the grant therefore reads the committed blob
|
|
50
|
+
// (HEAD:./.fleet/kb-canonical.json, git without a shell) and never the work-
|
|
51
|
+
// tree file. A clean tree or fresh clone yields the same bytes, so priming is
|
|
52
|
+
// unchanged; uncommitted edits are ignored and reported (worktree_ignored).
|
|
53
|
+
// With no committed copy (unborn HEAD, untracked bible, no git) nothing is
|
|
54
|
+
// imported: E-KB-MAINTAINER-REQUIRED, naming the cause.
|
|
55
|
+
//
|
|
56
|
+
// TRUST ANCHOR: committed is still not trusted on its own -- the member
|
|
57
|
+
// controls its own .git, so it can commit a hand-made bible locally, import
|
|
58
|
+
// it, and reset the commit away with nothing ever pushed. Pinning to a ref
|
|
59
|
+
// does not help either: every ref lives in the member-writable checkout. So
|
|
60
|
+
// the no-grant path imports the committed bible only when its git blob id is
|
|
61
|
+
// recorded in the hub-side per-repo KB DB (trusted_bible_blobs), which the
|
|
62
|
+
// maintainer side fills: kb_bible_commit records every bible it writes, and a
|
|
63
|
+
// FULL or kb_maintainer kb_import records every bible it imports. An
|
|
64
|
+
// unrecorded blob is refused with E-KB-MAINTAINER-REQUIRED and nothing is
|
|
65
|
+
// imported. The checkout supplies only the blob id and bytes to check: the
|
|
66
|
+
// bytes are hashed in-process and must equal that id (bible-blob-id.ts), so
|
|
67
|
+
// a replace ref, alternates entry or overwritten object in the member's .git
|
|
68
|
+
// cannot pair a trusted id with forged bytes; the trust decision itself is
|
|
69
|
+
// taken against the hub-side record alone.
|
|
70
|
+
//
|
|
71
|
+
// `ref`: read the bible as committed at that git ref (hash-verified the same
|
|
72
|
+
// way) instead of the file system. For a grant session this is what makes a
|
|
73
|
+
// seeding import independent of the maintainer's work tree.
|
|
74
|
+
//
|
|
75
|
+
// Bootstrap: a fresh clone whose bible came from the pushed base branch
|
|
76
|
+
// carries a blob the maintainer wrote (kb_bible_commit on this hub) and so
|
|
77
|
+
// imports normally. A bible this hub never saw (fresh hub, bible merged from
|
|
78
|
+
// elsewhere) is seeded by the engine's sprint-start priming, which imports
|
|
79
|
+
// through the repository's kb_maintainer session (a grant session the member
|
|
80
|
+
// agent cannot open) with `ref` naming the base branch's remote-tracking ref
|
|
81
|
+
// (refs/remotes/origin/<base>). Priming runs before anything cleans the
|
|
82
|
+
// maintainer's checkout (launch alignment runs only for multi-member legacy
|
|
83
|
+
// launches, and branch-ensure runs after priming), so it must not read the
|
|
84
|
+
// work tree or HEAD: only a bible on the fetched, reviewed base branch is
|
|
85
|
+
// seeded. Residual exposure: that ref is as fresh as the member's last fetch,
|
|
86
|
+
// and like every ref it lives in the member-writable .git -- the same
|
|
87
|
+
// boundary as the grant itself (a routing guard, not a security boundary
|
|
88
|
+
// against a process on the member's host).
|
|
33
89
|
export const kbImportSchema = z.object({
|
|
34
|
-
...kbScopeFields,
|
|
35
90
|
path: z.string().optional()
|
|
36
|
-
.describe('Explicit path to a bible JSON file. When omitted, resolves to <
|
|
37
|
-
|
|
38
|
-
.describe('
|
|
39
|
-
// KB audit 2026-08-11: the apra-fleet-src trap again. Every other kb_* tool
|
|
40
|
-
// names this input `repo_path`; kb_import alone took `repo`, and zod strips
|
|
41
|
-
// unknown keys silently -- so calling it the way every sibling is called did
|
|
42
|
-
// not error, it resolved against the SERVER's cwd and imported an unrelated
|
|
43
|
-
// repo's bible. Invisible, because it still reports a successful import. The
|
|
44
|
-
// sprint engine calls this per member, which is precisely the repo-blindness
|
|
45
|
-
// class per-member path resolution exists to prevent.
|
|
46
|
-
repo_path: z.string().optional()
|
|
47
|
-
.describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
|
|
91
|
+
.describe('Explicit path to a bible JSON file (e.g. <worktree>/.fleet/kb-canonical.json). This is a file path, not a scope selector: the KB written is always the calling session\'s own (a member session -> its work folder; otherwise the server folder). When omitted, resolves to <own folder>/.fleet/kb-canonical.json. TRUST NOTE: importing the repo-resolved .fleet/kb-canonical.json as committed is the git-reviewed trusted channel; an explicit --path bible is caller-asserted trust (equivalent in power to kb_promote). In a MEMBER session without the kb_maintainer grant an explicit path other than the session\'s own .fleet/kb-canonical.json is refused with E-KB-MAINTAINER-REQUIRED and nothing is imported, and the own bible is read as committed at HEAD (never the work-tree file); with no committed copy, or when that committed bible was never written or imported by the maintainer side (kb_bible_commit, or kb_import from the kb_maintainer or a FULL session), nothing is imported (E-KB-MAINTAINER-REQUIRED). Directives are quarantined to pending proposals either way.'),
|
|
92
|
+
ref: z.string().regex(/^[A-Za-z0-9_][A-Za-z0-9._/-]*$/).optional()
|
|
93
|
+
.describe('Read the bible as COMMITTED at this git ref (a ref name such as HEAD or refs/remotes/origin/main; no rev expressions) instead of the file on disk; with path, reads that repository-relative file at the ref. The bytes are verified in-process against the git blob id before import. A ref that does not hold the bible fails with E-BIBLE-NOT-FOUND and nothing is imported. In the kb_maintainer or a FULL session the verified blob is what gets recorded as trusted, so a seeding import does not depend on the work tree; in a member session without the grant the trust check still applies. Omitted: the file on disk (or, in a member session without the grant, HEAD).'),
|
|
48
94
|
scope: z.literal('project').optional()
|
|
49
95
|
.describe('Only project scope is supported (imports into the project KB). Global bibles are a separate concern.'),
|
|
50
96
|
// KB audit 2026-08-12, found by a LIVE sprint rather than by review. The
|
|
@@ -58,160 +104,137 @@ export const kbImportSchema = z.object({
|
|
|
58
104
|
// fire", by a side door. Opt-out, defaulting to today's behaviour.
|
|
59
105
|
skip_sweep: z.boolean().optional()
|
|
60
106
|
.describe('Skip the post-import freshness sweep. The sweep re-judges EVERY entry in the KB against this worktree, which is right for a deliberate audit but wrong for a routine import: an import performed to warm the KB should not mass-stale it because unrelated files have changed since capture. prime() still runs its own bounded freshness check on the entries it actually returns, so skipping this does not surface stale claims. Default false (sweep runs, unchanged).'),
|
|
107
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
108
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
109
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
61
110
|
});
|
|
62
|
-
//
|
|
63
|
-
//
|
|
64
|
-
//
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
const candidate = explicit || process.cwd();
|
|
69
|
-
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory()) {
|
|
70
|
-
throw new Error('kb_import: repo does not exist or is not a directory: ' + candidate);
|
|
111
|
+
// The KB anchor is the calling session's own folder (kb-self.ts). kb_import
|
|
112
|
+
// reads the bible and sweeps against that folder on THIS host, so an anchor
|
|
113
|
+
// naming a folder on another host refuses rather than silently skipping.
|
|
114
|
+
function requireLocalFolder(folder) {
|
|
115
|
+
if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory()) {
|
|
116
|
+
throw new Error('kb_import: repo folder does not exist or is not a directory on this host: ' + folder);
|
|
71
117
|
}
|
|
72
|
-
return
|
|
118
|
+
return folder;
|
|
73
119
|
}
|
|
74
|
-
const
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
return
|
|
90
|
-
if (typeof r.summary !== 'string' || r.summary.length === 0)
|
|
91
|
-
return false;
|
|
92
|
-
if (typeof r.confidence !== 'string' || !VALID_CONFIDENCE.includes(r.confidence))
|
|
93
|
-
return false;
|
|
94
|
-
if (r.symbols !== undefined && !Array.isArray(r.symbols))
|
|
95
|
-
return false;
|
|
96
|
-
if (r.source_files !== undefined && !Array.isArray(r.source_files))
|
|
97
|
-
return false;
|
|
98
|
-
return true;
|
|
99
|
-
}
|
|
100
|
-
// LOW-2: bible entries carry no content field, so synthesize content
|
|
101
|
-
// DETERMINISTICALLY from the summary. Determinism matters twice: (1) a re-import
|
|
102
|
-
// of the same bible produces byte-identical content so AUDN's content-equality
|
|
103
|
-
// 'none' path can dedupe an id-collision-with-identical-content case; (2) it
|
|
104
|
-
// keeps import a pure function of the bible file.
|
|
105
|
-
function synthesizeContent(entry) {
|
|
106
|
-
return entry.summary;
|
|
107
|
-
}
|
|
108
|
-
export async function kbImport(input) {
|
|
109
|
-
// `repo` wins over the `repo_path` alias so existing callers are unaffected.
|
|
110
|
-
const repoAnchor = resolveRepoPath(input.repo ?? input.repo_path);
|
|
111
|
-
const biblePath = input.path ?? path.join(repoAnchor, '.fleet', 'kb-canonical.json');
|
|
112
|
-
// Validate the file resolves and parses to the bible array shape BEFORE
|
|
113
|
-
// importing anything (reject otherwise -- non-zero exit at the CLI).
|
|
114
|
-
if (!fs.existsSync(biblePath)) {
|
|
115
|
-
throw new Error('kb_import: bible file not found: ' + biblePath);
|
|
116
|
-
}
|
|
117
|
-
const raw = fs.readFileSync(biblePath, 'utf-8');
|
|
118
|
-
let parsed;
|
|
119
|
-
try {
|
|
120
|
-
parsed = JSON.parse(raw);
|
|
121
|
-
}
|
|
122
|
-
catch {
|
|
123
|
-
throw new Error('kb_import: bible file is not valid JSON: ' + biblePath);
|
|
120
|
+
export const KB_IMPORT_HTTP_SKIP_REASON = 'bible import is not used over the http KB provider: the KB server is the source of truth';
|
|
121
|
+
export async function kbImport(input, anchor) {
|
|
122
|
+
const resolved = resolveKbAnchor(anchor);
|
|
123
|
+
const repoAnchor = requireLocalFolder(resolved.folder);
|
|
124
|
+
const ownBible = path.join(repoAnchor, '.fleet', 'kb-canonical.json');
|
|
125
|
+
const biblePath = input.path ?? ownBible;
|
|
126
|
+
// Over http the KB server is the source of truth: the bible is not read
|
|
127
|
+
// and nothing is imported (decided before any bible read or grant check).
|
|
128
|
+
const providers = await getKbProviders(repoAnchor, resolved.remoteUrl);
|
|
129
|
+
if (!isSqliteProject(providers.project)) {
|
|
130
|
+
const skipped = {
|
|
131
|
+
imported: 0, skipped: 0, linked: 0, flagged: 0, rejected: 0, demoted: 0,
|
|
132
|
+
sweep: { checked: 0, staled: 0, unstaled: 0 },
|
|
133
|
+
bible_skipped: true, reason: KB_IMPORT_HTTP_SKIP_REASON,
|
|
134
|
+
};
|
|
135
|
+
return JSON.stringify(skipped);
|
|
124
136
|
}
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
//
|
|
130
|
-
// Selection is on Array.isArray, exactly as the design specifies. This import
|
|
131
|
-
// side ships BEFORE the export side starts writing v2 -- a v2 bible fed to an
|
|
132
|
-
// older apra-fleet throws the not-a-JSON-array error below, which is expected
|
|
133
|
-
// and acceptable, but it means the reader must never lag the writer.
|
|
134
|
-
const bibleEntries = Array.isArray(parsed)
|
|
135
|
-
? parsed
|
|
136
|
-
: (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
|
|
137
|
-
? parsed.entries
|
|
138
|
-
: null;
|
|
139
|
-
if (bibleEntries === null) {
|
|
140
|
-
throw new Error('kb_import: bible file is not a JSON array of entries: ' + biblePath);
|
|
137
|
+
const lacksGrant = memberLacksKbMaintainer(anchor);
|
|
138
|
+
const namesOwnBible = input.path === undefined || path.resolve(input.path) === path.resolve(ownBible);
|
|
139
|
+
if (!namesOwnBible && lacksGrant) {
|
|
140
|
+
throw new KbMaintainerGrantError(`kb_import with an explicit path ('${input.path}') keeps the bible's confidence, which is equivalent to kb_promote, so it needs the kb_maintainer grant; this member session does not carry it and nothing was imported.`, 'Call kb_import without path to import your own checkout bible (.fleet/kb-canonical.json), or run the import from the kb_maintainer session or a FULL session.');
|
|
141
141
|
}
|
|
142
|
-
//
|
|
143
|
-
//
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
let
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
const
|
|
158
|
-
//
|
|
159
|
-
//
|
|
160
|
-
//
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
142
|
+
// Validate the file resolves and parses to the bible array shape BEFORE
|
|
143
|
+
// importing anything (reject otherwise -- non-zero exit at the CLI).
|
|
144
|
+
// Parsing (both on-disk shapes) is shared with the member bible view
|
|
145
|
+
// (services/knowledge/bible-import.ts); a malformed file throws KbBibleError.
|
|
146
|
+
// The DOCUMENT parse, not the entries-only one: the demotion tombstones are
|
|
147
|
+
// the cross-clone half of this import and must come from the same parse.
|
|
148
|
+
let bibleDoc;
|
|
149
|
+
// Set whenever the bible was read from git (no-grant sessions always; any
|
|
150
|
+
// session passing `ref`): the ref read, the hash-verified blob id, and
|
|
151
|
+
// whether the work-tree copy differed.
|
|
152
|
+
let committedSource;
|
|
153
|
+
// Set when the bible was read from the file system (grant/FULL without ref):
|
|
154
|
+
// the exact bytes parsed, whose blob id is recorded below.
|
|
155
|
+
let fileBytes;
|
|
156
|
+
if (lacksGrant || input.ref !== undefined) {
|
|
157
|
+
const ref = input.ref ?? 'HEAD';
|
|
158
|
+
// namesOwnBible holds for a no-grant session (an explicit other path was
|
|
159
|
+
// refused above); a grant session may name another repository-relative
|
|
160
|
+
// file to read at `ref`.
|
|
161
|
+
const rel = path.relative(repoAnchor, path.resolve(biblePath)).split(path.sep).join('/');
|
|
162
|
+
const inRepo = rel !== '' && !rel.startsWith('../') && rel !== '..' && !path.isAbsolute(rel);
|
|
163
|
+
if (!isSafeBibleRef(ref)) {
|
|
164
|
+
throw new Error(`kb_import: ref '${ref}' is not a plain git ref name (no leading '-', no rev expressions); nothing was imported`);
|
|
164
165
|
}
|
|
165
|
-
|
|
166
|
-
type: entry.type,
|
|
167
|
-
title: entry.title,
|
|
168
|
-
summary: entry.summary,
|
|
169
|
-
content: synthesizeContent(entry),
|
|
170
|
-
source_files: entry.source_files ?? [],
|
|
171
|
-
symbols: entry.symbols ?? [],
|
|
172
|
-
tags: [],
|
|
173
|
-
content_hash: '',
|
|
174
|
-
content_hash_type: 'sha256',
|
|
175
|
-
flagged_for_review: false,
|
|
176
|
-
// Bible entries carry no author; the trusted channel is the provenance.
|
|
177
|
-
author: 'unknown',
|
|
178
|
-
source: 'import',
|
|
179
|
-
confidence: entry.confidence,
|
|
180
|
-
scope: 'project',
|
|
181
|
-
};
|
|
182
|
-
// Route through the AUDN choke point with the INTERNAL import mode and the
|
|
183
|
-
// preserved bible id. A user-directive is still forced through the directive
|
|
184
|
-
// gate (pending proposal) INSIDE capture() -- import mode does not bypass it.
|
|
185
|
-
// KB-TRUST PHASE 1: isolate each entry so one unfalsifiable bible entry is
|
|
186
|
-
// counted and the import continues, rather than aborting every entry after
|
|
187
|
-
// it. Import mode exempts the confidence clamp, never the basis check.
|
|
188
|
-
let audn_decision;
|
|
166
|
+
let committed;
|
|
189
167
|
try {
|
|
190
|
-
|
|
191
|
-
importMode: true,
|
|
192
|
-
preferredId: entry.id,
|
|
193
|
-
}));
|
|
168
|
+
committed = inRepo ? await readCommittedBibleBlob(repoAnchor, ref, rel) : null;
|
|
194
169
|
}
|
|
195
170
|
catch (err) {
|
|
196
|
-
if (err instanceof
|
|
197
|
-
|
|
198
|
-
continue;
|
|
199
|
-
}
|
|
171
|
+
if (err instanceof BibleBlobIntegrityError)
|
|
172
|
+
throw new Error('kb_import: ' + err.message);
|
|
200
173
|
throw err;
|
|
201
174
|
}
|
|
202
|
-
if (
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
//
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
175
|
+
if (committed === null && input.ref !== undefined) {
|
|
176
|
+
throw new Error(`kb_import: bible file not found: ${ref}:${inRepo ? rel : biblePath}`);
|
|
177
|
+
}
|
|
178
|
+
// No bible anywhere (a repo that has not adopted one): the plain
|
|
179
|
+
// not-found error, as for every other session -- not a grant problem.
|
|
180
|
+
if (committed === null && !fs.existsSync(ownBible)) {
|
|
181
|
+
throw new Error('kb_import: bible file not found: ' + ownBible);
|
|
182
|
+
}
|
|
183
|
+
if (committed === null) {
|
|
184
|
+
throw new KbMaintainerGrantError(`kb_import in a member session without the kb_maintainer grant imports only the committed ${OWN_BIBLE_REL} (HEAD), and this checkout has no committed copy (unborn HEAD, untracked bible, or git unavailable); the work-tree file is not trusted at its own confidence and nothing was imported.`, `Commit ${OWN_BIBLE_REL} (the kb_maintainer's kb_bible_commit does this), or run the import from the kb_maintainer session or a FULL session.`);
|
|
185
|
+
}
|
|
186
|
+
let worktree = null;
|
|
187
|
+
try {
|
|
188
|
+
worktree = fs.readFileSync(biblePath, 'utf-8');
|
|
189
|
+
}
|
|
190
|
+
catch {
|
|
191
|
+
worktree = null;
|
|
192
|
+
}
|
|
193
|
+
// Line endings are normalized for the comparison only (autocrlf checkouts).
|
|
194
|
+
const lf = (t) => t.replace(/\r\n/g, '\n');
|
|
195
|
+
committedSource = { ref, worktree_ignored: worktree === null || lf(worktree) !== lf(committed.text), blobId: committed.blobId };
|
|
196
|
+
bibleDoc = parseBibleDocument(committed.text, ref + ':' + rel, 'kb_import');
|
|
197
|
+
}
|
|
198
|
+
else {
|
|
199
|
+
if (!fs.existsSync(biblePath)) {
|
|
200
|
+
throw new Error('kb_import: bible file not found: ' + biblePath);
|
|
201
|
+
}
|
|
202
|
+
// Read once: the bytes parsed are the bytes whose blob id is recorded.
|
|
203
|
+
fileBytes = fs.readFileSync(biblePath);
|
|
204
|
+
bibleDoc = parseBibleDocument(fileBytes.toString('utf-8'), biblePath, 'kb_import');
|
|
205
|
+
}
|
|
206
|
+
// repoAnchor (resolved above) selects the KB, so an import 'for' repo B can
|
|
207
|
+
// never land in whichever repo the server process happens to sit in.
|
|
208
|
+
const provider = requireSqliteProject(providers.project, 'kb_import');
|
|
209
|
+
// Trust anchor (see the header): a committed bible is imported by a member
|
|
210
|
+
// session without the grant only when the maintainer side recorded its
|
|
211
|
+
// blob id in this hub-side DB. Otherwise NOTHING is imported -- refusing the
|
|
212
|
+
// whole import rather than clamping CONFIRMED entries to a lower tier,
|
|
213
|
+
// because a clamped row would occupy its id, and the id-exists skip in
|
|
214
|
+
// importBibleEntries would then keep the genuine CONFIRMED entry out when
|
|
215
|
+
// the maintainer's bible arrives later; a refusal leaves the KB untouched.
|
|
216
|
+
if (lacksGrant && committedSource && !provider.isTrustedBibleBlob(committedSource.blobId)) {
|
|
217
|
+
throw new KbMaintainerGrantError(`kb_import in a member session without the kb_maintainer grant imports the committed ${OWN_BIBLE_REL} only when the maintainer side wrote or imported that exact bible, and this checkout's committed bible (blob ${committedSource.blobId}) was never recorded by it (a bible committed only in this checkout is not trusted at its own confidence); nothing was imported.`, `Import a bible the kb_maintainer published (kb_bible_commit) -- e.g. reset ${OWN_BIBLE_REL} to the base branch -- or run the import from the kb_maintainer session or a FULL session, which records the bible it imports.`);
|
|
218
|
+
}
|
|
219
|
+
// Same entry loop the member bible view uses: import mode (bible confidence
|
|
220
|
+
// preserved, directives quarantined), id-exists skip first, per-entry
|
|
221
|
+
// isolation of capture basis rejections.
|
|
222
|
+
// Tombstones ride along in the same call so entries and demotions can never
|
|
223
|
+
// be applied from two different reads of the file.
|
|
224
|
+
const { imported, skipped, linked, flagged, rejected, demoted } = await importBibleEntries(provider, bibleDoc.entries, { demotions: bibleDoc.demotions });
|
|
225
|
+
// A FULL or kb_maintainer session is trusted to import at bible confidence,
|
|
226
|
+
// so the bible it just imported becomes trusted for member sessions too:
|
|
227
|
+
// record the blob id the bytes would have as this repo's committed own
|
|
228
|
+
// bible: the hash-verified blob id for a `ref` read, else the in-process id
|
|
229
|
+
// of the exact file bytes parsed (no `git hash-object` on the path, so no
|
|
230
|
+
// re-read and no member-configured clean filter decides the id). This is
|
|
231
|
+
// also how a hub that never saw a bible (fresh hub, bible merged from
|
|
232
|
+
// elsewhere) is seeded: the engine's sprint-start priming imports the base
|
|
233
|
+
// branch's bible through the kb_maintainer session with `ref`. A member
|
|
234
|
+
// session without the grant never records (it only reads the record).
|
|
235
|
+
if (!lacksGrant) {
|
|
236
|
+
const blobId = committedSource ? committedSource.blobId : await bibleBytesBlobId(repoAnchor, fileBytes);
|
|
237
|
+
provider.recordTrustedBibleBlob(blobId, 'kb_import');
|
|
215
238
|
}
|
|
216
239
|
// After the entry loop, run freshnessSweep() (T1.3) so imported entries whose
|
|
217
240
|
// basis does not match THIS worktree stale immediately rather than serving
|
|
@@ -234,7 +257,9 @@ export async function kbImport(input) {
|
|
|
234
257
|
const sweep = input.skip_sweep
|
|
235
258
|
? { checked: 0, staled: 0, unstaled: 0 }
|
|
236
259
|
: await provider.freshnessSweep(repoAnchor);
|
|
237
|
-
const report =
|
|
260
|
+
const report = committedSource
|
|
261
|
+
? { imported, skipped, linked, flagged, rejected, demoted, sweep, bible_source: committedSource.ref, worktree_ignored: committedSource.worktree_ignored }
|
|
262
|
+
: { imported, skipped, linked, flagged, rejected, demoted, sweep };
|
|
238
263
|
return JSON.stringify(report);
|
|
239
264
|
}
|
|
240
265
|
//# sourceMappingURL=kb-import.js.map
|
|
@@ -1,19 +1,34 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbInvalidateSchema: z.ZodObject<{
|
|
3
|
-
repo_path: z.ZodOptional<z.
|
|
4
|
-
|
|
5
|
-
repo_remote_url: 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
|
+
files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
8
|
+
ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
6
9
|
}, "strip", z.ZodTypeAny, {
|
|
7
|
-
files
|
|
8
|
-
|
|
9
|
-
|
|
10
|
+
files?: string[] | undefined;
|
|
11
|
+
repo?: unknown;
|
|
12
|
+
ids?: string[] | undefined;
|
|
13
|
+
repo_path?: unknown;
|
|
14
|
+
repo_remote_url?: unknown;
|
|
10
15
|
}, {
|
|
11
|
-
files
|
|
12
|
-
|
|
13
|
-
|
|
16
|
+
files?: string[] | undefined;
|
|
17
|
+
repo?: unknown;
|
|
18
|
+
ids?: string[] | undefined;
|
|
19
|
+
repo_path?: unknown;
|
|
20
|
+
repo_remote_url?: unknown;
|
|
14
21
|
}>;
|
|
15
22
|
export type KbInvalidateInput = z.infer<typeof kbInvalidateSchema>;
|
|
23
|
+
export declare const KB_HOOK_MARKER = "# apra-fleet KB invalidation hook";
|
|
16
24
|
export declare const KB_POST_COMMIT_HOOK = "#!/bin/sh\n# apra-fleet KB invalidation hook\n# Marks context-cache entries stale for files changed in the last commit\ngit diff-tree --no-commit-id -r --name-only HEAD | while IFS= read -r f; do\n [ -n \"$f\" ] && node dist/index.js kb invalidate \"$f\" 2>/dev/null || true\ndone\n";
|
|
17
|
-
export
|
|
18
|
-
|
|
25
|
+
export type KbHookInstallResult = {
|
|
26
|
+
installed: true;
|
|
27
|
+
hookPath: string;
|
|
28
|
+
} | {
|
|
29
|
+
installed: false;
|
|
30
|
+
reason: string;
|
|
31
|
+
};
|
|
32
|
+
export declare function installKbPostCommitHook(repoPath: string): KbHookInstallResult;
|
|
33
|
+
export declare function kbInvalidate(input: KbInvalidateInput, anchor?: KbAnchor): Promise<string>;
|
|
19
34
|
//# sourceMappingURL=kb-invalidate.d.ts.map
|