@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-export.js
CHANGED
|
@@ -1,12 +1,16 @@
|
|
|
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 { execFileSync } from 'node:child_process';
|
|
5
6
|
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
6
|
-
import {
|
|
7
|
+
import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
|
|
7
8
|
import { logWarn } from '../utils/log-helpers.js';
|
|
8
9
|
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
9
10
|
import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
11
|
+
import { filterProjectBibleCandidates } from '../services/knowledge/bible-basis-filter.js';
|
|
12
|
+
import { extractBibleDemotions, standingAgainstTombstone } from '../services/knowledge/bible-import.js';
|
|
13
|
+
import { gitExecutable } from '../os/git-executable.js';
|
|
10
14
|
// T3.4 (F8b, D8): export half of the shareable, diffable team bible. Writes
|
|
11
15
|
// all CONFIRMED, non-superseded, non-stale project entries to
|
|
12
16
|
// <repo>/.fleet/kb-canonical.json. Registered as a real MCP tool (not just an
|
|
@@ -18,15 +22,11 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
|
18
22
|
// discretion: the export TOOL commits with its own dedicated identity
|
|
19
23
|
// (pm-kb), so no role's "no git operations" rule is violated by this
|
|
20
24
|
// automatic side effect.
|
|
21
|
-
//
|
|
22
|
-
//
|
|
23
|
-
//
|
|
24
|
-
//
|
|
25
|
-
//
|
|
26
|
-
// blindly; (3) neither validates -- kb_export refuses with a clear error
|
|
27
|
-
// rather than silently writing relative to an arbitrary path. There is no
|
|
28
|
-
// bare process.cwd() fallback: the fallback tier is validated the same way
|
|
29
|
-
// explicit input is.
|
|
25
|
+
// kb (self): the repo written to is the calling session's own folder -- the
|
|
26
|
+
// member's registered work folder for a member session, the server's working
|
|
27
|
+
// folder otherwise (src/services/knowledge/kb-self.ts). It is validated (must
|
|
28
|
+
// exist, be a git repo with an origin remote) or kb_export refuses with a
|
|
29
|
+
// typed E-SELF error; it is never a scope argument.
|
|
30
30
|
// T3.3 (F9a, D8): scope param -- 'project' (default, unchanged behavior) reads
|
|
31
31
|
// the PROJECT KB and writes .fleet/kb-canonical.json (as before); 'global'
|
|
32
32
|
// reads the GLOBAL KB (providers.global -- the shared kb.sqlite at
|
|
@@ -35,13 +35,129 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
|
35
35
|
// apra-fleet platform repo, committed there per D8). Same stable field set,
|
|
36
36
|
// same asciiSafeStringify + deterministic id-sorted output, and the same
|
|
37
37
|
// auto-commit behavior (T2.3) applies to the global file too.
|
|
38
|
+
// Provenance names the TARGET BASE branch: the branch the bible's entries will
|
|
39
|
+
// merge into, not the (typically feature) branch the export ran on. baseBranch
|
|
40
|
+
// and baseCommit let the caller say so explicitly; when omitted, provenance
|
|
41
|
+
// falls back to the export folder's own HEAD branch and commit (unchanged).
|
|
38
42
|
export const kbExportSchema = z.object({
|
|
39
|
-
...kbScopeFields,
|
|
40
|
-
repo_path: z.string().optional()
|
|
41
|
-
.describe('Path to the repo root to write the canonical bible into. Precedence: this explicit input, when given, is validated (must exist and be a directory) or the call fails; when omitted, falls back to the validated session working directory (same validation, not a blind default); if neither validates, kb_export refuses with a clear error.'),
|
|
42
43
|
scope: z.enum(['project', 'global']).optional()
|
|
43
|
-
.describe('project (default, unchanged): export the project KB to .fleet/kb-canonical.json. global: export the GLOBAL KB to .fleet/kb-canonical-global.json in the
|
|
44
|
+
.describe('project (default, unchanged): export the project KB to .fleet/kb-canonical.json. global: export the GLOBAL KB to .fleet/kb-canonical-global.json in the calling session\'s own repo (in practice the apra-fleet platform repo, committed there so the installer can distribute it -- D8).'),
|
|
45
|
+
baseBranch: z.string().min(1).optional()
|
|
46
|
+
.describe('The target base branch (the branch the entries merge into). Written to provenance.branch. Omitted: the export folder HEAD branch.'),
|
|
47
|
+
baseCommit: z.string().min(1).optional()
|
|
48
|
+
.describe('The base commit the entries were verified against. Written to provenance.commit. Omitted: the export folder HEAD commit.'),
|
|
49
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
50
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
51
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
44
52
|
});
|
|
53
|
+
/** The bible format version every writer emits. */
|
|
54
|
+
export const BIBLE_FORMAT_VERSION = 3;
|
|
55
|
+
/** A basis map with its keys in sorted order, so serialization is byte-stable. */
|
|
56
|
+
function sortedBasis(basis) {
|
|
57
|
+
const out = {};
|
|
58
|
+
for (const key of Object.keys(basis).sort())
|
|
59
|
+
out[key] = basis[key];
|
|
60
|
+
return out;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* A bible entry with `basis` attached as its source_file_hashes (keys sorted,
|
|
64
|
+
* copied verbatim -- never re-hashed); every other field is left as it is.
|
|
65
|
+
* Used by kb_bible_commit's legacy backfill.
|
|
66
|
+
*/
|
|
67
|
+
export function withSourceFileHashes(entry, basis) {
|
|
68
|
+
return { ...entry, source_file_hashes: sortedBasis(basis) };
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Map a KB entry to the bible's stable field set. Shared with kb_bible_commit.
|
|
72
|
+
* `basis` is the entry's STORED per-file hash basis (the one the bible
|
|
73
|
+
* predicate admitted it against); when given and non-empty it is written as
|
|
74
|
+
* source_file_hashes (format v3). Nothing is hashed here.
|
|
75
|
+
*/
|
|
76
|
+
/**
|
|
77
|
+
* `trustTime` is the row's bible trust time (SqliteProvider.getBibleTrustTimes)
|
|
78
|
+
* when the caller has it, so an entry this clone imported keeps the updated_at
|
|
79
|
+
* its bible carried instead of taking the local import time. null/undefined
|
|
80
|
+
* falls back to promoted_at, then created_at.
|
|
81
|
+
*/
|
|
82
|
+
export function toCanonicalEntry(e, basis, trustTime) {
|
|
83
|
+
const entry = {
|
|
84
|
+
id: e.id,
|
|
85
|
+
type: e.type,
|
|
86
|
+
title: e.title,
|
|
87
|
+
summary: e.summary,
|
|
88
|
+
symbols: e.symbols,
|
|
89
|
+
source_files: e.source_files,
|
|
90
|
+
confidence: e.confidence,
|
|
91
|
+
updated_at: trustTime || e.promoted_at || e.created_at,
|
|
92
|
+
};
|
|
93
|
+
if (basis && Object.keys(basis).length > 0)
|
|
94
|
+
entry.source_file_hashes = sortedBasis(basis);
|
|
95
|
+
return entry;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Duplicate-id guard shared by every bible writer: a bible is keyed by id, so
|
|
99
|
+
* one about to be written with two entries sharing an id is corrupt. Throws
|
|
100
|
+
* (naming the id) BEFORE anything is written, so the file on disk is untouched.
|
|
101
|
+
*/
|
|
102
|
+
export function assertNoDuplicateBibleIds(entries, toolName) {
|
|
103
|
+
const seen = new Set();
|
|
104
|
+
for (const e of entries) {
|
|
105
|
+
const id = String(e.id);
|
|
106
|
+
if (seen.has(id)) {
|
|
107
|
+
throw new Error(toolName + ': refusing to write a bible with duplicate entry id ' + JSON.stringify(id)
|
|
108
|
+
+ ' -- the bible is keyed by id; resolve the duplicate in .fleet/kb-canonical.json first');
|
|
109
|
+
}
|
|
110
|
+
seen.add(id);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
/** Deterministic id ordering so re-exports produce meaningful diffs. */
|
|
114
|
+
export function compareById(a, b) {
|
|
115
|
+
return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* The entries of the bible already on disk, in either shape (legacy bare array
|
|
119
|
+
* or v2/v3 envelope). null when the file is absent or unparseable.
|
|
120
|
+
*
|
|
121
|
+
* Entries only, exactly as before: callers that do not care about tombstones are
|
|
122
|
+
* unchanged. readBibleDocument below is the sibling reader for callers that do.
|
|
123
|
+
*/
|
|
124
|
+
export function readBibleEntries(outPath) {
|
|
125
|
+
return readBibleDocument(outPath)?.entries ?? null;
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* The entries AND the demotion tombstones of the bible already on disk. Same
|
|
129
|
+
* acceptance as readBibleEntries (both shapes; null when absent or unparseable);
|
|
130
|
+
* a bible with no demotions field yields an empty tombstone list, never a
|
|
131
|
+
* failure.
|
|
132
|
+
*/
|
|
133
|
+
export function readBibleDocument(outPath) {
|
|
134
|
+
if (!fs.existsSync(outPath))
|
|
135
|
+
return null;
|
|
136
|
+
try {
|
|
137
|
+
const parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
|
|
138
|
+
const existing = Array.isArray(parsed)
|
|
139
|
+
? parsed
|
|
140
|
+
: (parsed && Array.isArray(parsed.entries) ? parsed.entries : null);
|
|
141
|
+
if (existing === null)
|
|
142
|
+
return null;
|
|
143
|
+
return { entries: existing, demotions: extractBibleDemotions(parsed) };
|
|
144
|
+
}
|
|
145
|
+
catch {
|
|
146
|
+
return null;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* PATHSPEC-ONLY commit of the bible file with the dedicated pm-kb identity:
|
|
151
|
+
* git add <path> then a commit scoped to -- <path>, so unrelated staged or
|
|
152
|
+
* dirty working-tree state is never swept in. Throws on any git failure; the
|
|
153
|
+
* caller decides whether that is fatal. Never pushes.
|
|
154
|
+
*/
|
|
155
|
+
export function commitBiblePath(repoPath, outPath, message) {
|
|
156
|
+
execFileSync(gitExecutable(), ['add', outPath], {
|
|
157
|
+
cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
|
|
158
|
+
});
|
|
159
|
+
execFileSync(gitExecutable(), ['-c', 'user.name=pm-kb', '-c', 'user.email=kb@pm.local', 'commit', '-m', message, '--', outPath], { cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
|
|
160
|
+
}
|
|
45
161
|
/**
|
|
46
162
|
* Resolve HEAD, degrading gracefully to null rather than throwing: a repo with
|
|
47
163
|
* no commits yet, a non-repo directory, or a machine without git must still be
|
|
@@ -80,8 +196,8 @@ function gitOrNull(repoPath, args) {
|
|
|
80
196
|
if (!isGitRepo(repoPath))
|
|
81
197
|
return null;
|
|
82
198
|
try {
|
|
83
|
-
const out = execFileSync(
|
|
84
|
-
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
199
|
+
const out = execFileSync(gitExecutable(), args, {
|
|
200
|
+
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
85
201
|
}).trim();
|
|
86
202
|
return out.length > 0 ? out : null;
|
|
87
203
|
}
|
|
@@ -100,7 +216,7 @@ function gitOrNull(repoPath, args) {
|
|
|
100
216
|
// ASCII too) and avoids template literals -- the pre-commit hook's
|
|
101
217
|
// backtick-n/t/r scan false-positives on template-literal escape sequences,
|
|
102
218
|
// the same gotcha T2.3's promote() fix worked around.
|
|
103
|
-
function asciiSafeStringify(value) {
|
|
219
|
+
export function asciiSafeStringify(value) {
|
|
104
220
|
const json = JSON.stringify(value, null, 2);
|
|
105
221
|
const maxAsciiCode = 127;
|
|
106
222
|
const escapePrefix = String.fromCharCode(92) + 'u'; // backslash + 'u', built at runtime
|
|
@@ -119,16 +235,14 @@ function asciiSafeStringify(value) {
|
|
|
119
235
|
}
|
|
120
236
|
return out;
|
|
121
237
|
}
|
|
122
|
-
//
|
|
123
|
-
//
|
|
124
|
-
//
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory()) {
|
|
129
|
-
throw new Error('kb_export: repo_path does not exist or is not a directory: ' + candidate);
|
|
238
|
+
// The resolved anchor folder must exist on THIS host: kb_export writes the
|
|
239
|
+
// bible file there, so an anchor naming a folder on another host (a remote
|
|
240
|
+
// member's work folder) has nothing meaningful to do and must refuse.
|
|
241
|
+
export function requireLocalFolder(folder, toolName = 'kb_export') {
|
|
242
|
+
if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory()) {
|
|
243
|
+
throw new Error(toolName + ': repo folder does not exist or is not a directory on this host: ' + folder);
|
|
130
244
|
}
|
|
131
|
-
return
|
|
245
|
+
return folder;
|
|
132
246
|
}
|
|
133
247
|
function autoCommitMode() {
|
|
134
248
|
try {
|
|
@@ -152,7 +266,7 @@ function autoCommitEnabled() {
|
|
|
152
266
|
return autoCommitMode() !== 'off';
|
|
153
267
|
}
|
|
154
268
|
// The entry count of the bible ALREADY on disk, read before we overwrite it.
|
|
155
|
-
// Accepts
|
|
269
|
+
// Accepts every shape (legacy bare array, v2/v3 envelope) like entriesUnchanged.
|
|
156
270
|
// null means "no comparable prior bible" -- absent file, or unparseable -- in
|
|
157
271
|
// which case there is no shrink to detect and the export is a first write.
|
|
158
272
|
function bibleEntryCount(outPath) {
|
|
@@ -173,7 +287,7 @@ function bibleEntryCount(outPath) {
|
|
|
173
287
|
export function _autoCommitEnabledForTest() {
|
|
174
288
|
return autoCommitEnabled();
|
|
175
289
|
}
|
|
176
|
-
function isGitRepo(repoPath) {
|
|
290
|
+
export function isGitRepo(repoPath) {
|
|
177
291
|
return fs.existsSync(path.join(repoPath, '.git'));
|
|
178
292
|
}
|
|
179
293
|
// "Content actually changed" (D5): git status --porcelain against the exact
|
|
@@ -181,9 +295,9 @@ function isGitRepo(repoPath) {
|
|
|
181
295
|
// already matches HEAD for this one path -- re-exporting an identical bible
|
|
182
296
|
// is a no-op, so there is nothing to commit. Any output (modified, or a
|
|
183
297
|
// brand-new untracked file on the very first export) means it changed.
|
|
184
|
-
function bibleContentChanged(repoPath, outPath) {
|
|
185
|
-
const status = execFileSync(
|
|
186
|
-
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
298
|
+
export function bibleContentChanged(repoPath, outPath) {
|
|
299
|
+
const status = execFileSync(gitExecutable(), ['status', '--porcelain', '--', outPath], {
|
|
300
|
+
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
187
301
|
});
|
|
188
302
|
return status.trim().length > 0;
|
|
189
303
|
}
|
|
@@ -224,12 +338,9 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
|
|
|
224
338
|
try {
|
|
225
339
|
if (!bibleContentChanged(repoPath, outPath))
|
|
226
340
|
return false;
|
|
227
|
-
execFileSync('git', ['add', outPath], {
|
|
228
|
-
cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'],
|
|
229
|
-
});
|
|
230
341
|
const scopeLabel = scope === 'global' ? 'global knowledge bible' : 'knowledge bible';
|
|
231
342
|
const message = 'chore(kb): update ' + scopeLabel + ' -- ' + entryCount + ' confirmed entries';
|
|
232
|
-
|
|
343
|
+
commitBiblePath(repoPath, outPath, message);
|
|
233
344
|
return true;
|
|
234
345
|
}
|
|
235
346
|
catch (err) {
|
|
@@ -238,44 +349,138 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
|
|
|
238
349
|
return false;
|
|
239
350
|
}
|
|
240
351
|
}
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
352
|
+
// Id ordering for the additive project merge, whose existing bible entries are
|
|
353
|
+
// raw objects (never re-shaped) and so carry an id of unknown type.
|
|
354
|
+
function byId(a, b) {
|
|
355
|
+
const x = String(a.id);
|
|
356
|
+
const y = String(b.id);
|
|
357
|
+
return x < y ? -1 : x > y ? 1 : 0;
|
|
358
|
+
}
|
|
359
|
+
/**
|
|
360
|
+
* Entries of the bible already on disk, as raw objects (never re-shaped, so
|
|
361
|
+
* they are written back byte-for-byte equivalent). Accepts the v2/v3 envelope and
|
|
362
|
+
* the legacy bare array. An absent file is an empty bible. A file that exists
|
|
363
|
+
* but cannot be parsed as either shape THROWS: the project export is additive
|
|
364
|
+
* and must never overwrite (and so silently drop) a bible it cannot read.
|
|
365
|
+
*/
|
|
366
|
+
function readExistingBibleDocument(outPath) {
|
|
367
|
+
if (!fs.existsSync(outPath))
|
|
368
|
+
return { entries: [], demotions: [] };
|
|
369
|
+
let parsed;
|
|
370
|
+
try {
|
|
371
|
+
parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
|
|
372
|
+
}
|
|
373
|
+
catch (err) {
|
|
374
|
+
throw new Error('kb_export: existing bible is not valid JSON, refusing to overwrite it: ' + outPath
|
|
375
|
+
+ ' (' + (err instanceof Error ? err.message : String(err)) + ')');
|
|
376
|
+
}
|
|
377
|
+
const list = Array.isArray(parsed)
|
|
378
|
+
? parsed
|
|
379
|
+
: (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries)
|
|
380
|
+
? parsed.entries
|
|
381
|
+
: null);
|
|
382
|
+
if (list === null) {
|
|
383
|
+
throw new Error('kb_export: existing bible has no entries array, refusing to overwrite it: ' + outPath);
|
|
384
|
+
}
|
|
385
|
+
return { entries: list, demotions: extractBibleDemotions(parsed) };
|
|
386
|
+
}
|
|
387
|
+
// PROJECT-SCOPE EXPORT: basis filter + additive merge.
|
|
388
|
+
//
|
|
389
|
+
// Only CONFIRMED (non-superseded, non-stale -- list() already excludes those)
|
|
390
|
+
// entries whose per-file hash basis matches the files in repoPath qualify (see
|
|
391
|
+
// qualifiesForProjectBible in services/knowledge/bible-basis-filter.ts). A
|
|
392
|
+
// member-local KB routinely holds entries about files the exported tree does
|
|
393
|
+
// not contain; publishing them would leak them into the committed artifact.
|
|
394
|
+
//
|
|
395
|
+
// The merge is ADDITIVE: every entry already in the bible is kept exactly as it
|
|
396
|
+
// is (curated, possibly human-edited), qualifying entries whose id is not yet
|
|
397
|
+
// present are added, and on an id collision the existing bible entry wins.
|
|
398
|
+
// Nothing is ever removed by an export -- removal is a human (or reconcile)
|
|
399
|
+
// edit of the file. Consequently the project bible never shrinks through this
|
|
400
|
+
// path and the shrink guard in maybeAutoCommitBible only matters for global.
|
|
401
|
+
//
|
|
402
|
+
// No new id to add -> the file is not touched at all (byte-identical,
|
|
403
|
+
// provenance untouched) and nothing is committed.
|
|
404
|
+
//
|
|
405
|
+
// `exported` in the response is the number of entries in the bible as written
|
|
406
|
+
// (or as left on disk when nothing was added), not the number newly added.
|
|
407
|
+
async function exportProjectBible(source, repoPath, outPath, input) {
|
|
408
|
+
const { entries: existing, demotions } = readExistingBibleDocument(outPath);
|
|
409
|
+
const existingIds = new Set(existing.map(e => String(e.id)));
|
|
410
|
+
const tombstones = new Map(demotions.map(d => [d.id, d]));
|
|
411
|
+
const confirmed = await source.list({ confidence: ['CONFIRMED'] });
|
|
412
|
+
// TOMBSTONE GATE, before the basis filter. An id another clone demoted is not
|
|
413
|
+
// re-added just because this clone still holds it CONFIRMED -- that is how a
|
|
414
|
+
// demotion would be silently undone on the next export. The ONE exception is a
|
|
415
|
+
// row standingAgainstTombstone calls 'repromoted' -- the same rule kb_import
|
|
416
|
+
// applies -- so the entry comes back and its tombstone is cleared in the same
|
|
417
|
+
// write.
|
|
418
|
+
const notInBible = confirmed.filter(e => !existingIds.has(e.id));
|
|
419
|
+
const trustTimes = source.getBibleTrustTimes(notInBible.map(e => e.id));
|
|
420
|
+
const newCandidates = notInBible.filter(e => {
|
|
421
|
+
const tombstone = tombstones.get(e.id);
|
|
422
|
+
if (!tombstone)
|
|
423
|
+
return true;
|
|
424
|
+
return standingAgainstTombstone(trustTimes.get(e.id) ?? null, tombstone.at) === 'repromoted';
|
|
425
|
+
});
|
|
426
|
+
const bases = source.getSourceFileBases(newCandidates.map(e => e.id));
|
|
427
|
+
const qualifying = await filterProjectBibleCandidates(newCandidates, bases, repoPath);
|
|
428
|
+
if (qualifying.length === 0) {
|
|
429
|
+
return JSON.stringify({ exported: existing.length, path: outPath, scope: 'project', committed: false });
|
|
430
|
+
}
|
|
431
|
+
for (const e of qualifying)
|
|
432
|
+
tombstones.delete(e.id);
|
|
433
|
+
// Each added entry carries the exact stored basis it was just admitted against.
|
|
434
|
+
const merged = [...existing, ...qualifying.map(e => toCanonicalEntry(e, bases.get(e.id), trustTimes.get(e.id)))].sort(byId);
|
|
435
|
+
assertNoDuplicateBibleIds(merged, 'kb_export');
|
|
436
|
+
const nextDemotions = Array.from(tombstones.values()).sort(compareById);
|
|
437
|
+
const bible = {
|
|
438
|
+
version: BIBLE_FORMAT_VERSION,
|
|
439
|
+
provenance: {
|
|
440
|
+
commit: input.baseCommit ?? resolveHeadCommit(repoPath),
|
|
441
|
+
branch: input.baseBranch ?? resolveBranch(repoPath),
|
|
442
|
+
// Entries only: the tombstones below are deliberately not counted.
|
|
443
|
+
entry_count: merged.length,
|
|
444
|
+
},
|
|
445
|
+
entries: merged,
|
|
446
|
+
// Omitted entirely when there are none, so a bible that never saw a
|
|
447
|
+
// demotion is byte-identical to one written before the field existed.
|
|
448
|
+
...(nextDemotions.length > 0 ? { demotions: nextDemotions } : {}),
|
|
449
|
+
};
|
|
450
|
+
const fleetDir = path.dirname(outPath);
|
|
451
|
+
if (!fs.existsSync(fleetDir))
|
|
452
|
+
fs.mkdirSync(fleetDir, { recursive: true });
|
|
453
|
+
const previousEntryCount = bibleEntryCount(outPath);
|
|
454
|
+
fs.writeFileSync(outPath, asciiSafeStringify(bible) + '\n', 'utf-8');
|
|
455
|
+
const committed = maybeAutoCommitBible(repoPath, outPath, merged.length, 'project', previousEntryCount);
|
|
456
|
+
return JSON.stringify({ exported: merged.length, path: outPath, scope: 'project', committed });
|
|
457
|
+
}
|
|
458
|
+
export async function kbExport(input, anchor) {
|
|
459
|
+
// kb_export WRITES <folder>/.fleet/kb-canonical.json and git-commits it, so
|
|
460
|
+
// an unreachable folder has no meaningful behaviour left -- it must not
|
|
461
|
+
// proceed. An invalid anchor throws here, before getKbProviders is reached,
|
|
462
|
+
// so no provider is ever anchored somewhere the caller did not mean.
|
|
463
|
+
const resolved = resolveKbAnchor(anchor);
|
|
464
|
+
const repoPath = requireLocalFolder(resolved.folder);
|
|
253
465
|
const scope = input.scope ?? 'project';
|
|
254
466
|
// Read from the SAME repo we are about to write the bible into. Resolving the
|
|
255
467
|
// source from process cwd while writing to repoPath is how repo A's entries
|
|
256
468
|
// used to end up serialised into repo B's committed bible.
|
|
257
|
-
const providers = await getKbProviders(repoPath,
|
|
258
|
-
const
|
|
259
|
-
const
|
|
469
|
+
const providers = await getKbProviders(repoPath, resolved.remoteUrl);
|
|
470
|
+
const fleetDir = path.join(repoPath, '.fleet');
|
|
471
|
+
const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
|
|
472
|
+
const outPath = path.join(fleetDir, fileName);
|
|
473
|
+
if (scope === 'project') {
|
|
474
|
+
return exportProjectBible(requireSqliteProject(providers.project, 'kb_export'), repoPath, outPath, input);
|
|
475
|
+
}
|
|
476
|
+
const entries = await providers.global.list({ confidence: ['CONFIRMED'] });
|
|
260
477
|
// Deterministic ordering by id so re-exports produce meaningful diffs.
|
|
261
478
|
const canonical = entries
|
|
262
|
-
.map(e => (
|
|
263
|
-
|
|
264
|
-
type: e.type,
|
|
265
|
-
title: e.title,
|
|
266
|
-
summary: e.summary,
|
|
267
|
-
symbols: e.symbols,
|
|
268
|
-
source_files: e.source_files,
|
|
269
|
-
confidence: e.confidence,
|
|
270
|
-
updated_at: e.promoted_at || e.created_at,
|
|
271
|
-
}))
|
|
272
|
-
.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
|
|
273
|
-
const fleetDir = path.join(repoPath, '.fleet');
|
|
479
|
+
.map(e => toCanonicalEntry(e))
|
|
480
|
+
.sort(compareById);
|
|
274
481
|
if (!fs.existsSync(fleetDir)) {
|
|
275
482
|
fs.mkdirSync(fleetDir, { recursive: true });
|
|
276
483
|
}
|
|
277
|
-
const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
|
|
278
|
-
const outPath = path.join(fleetDir, fileName);
|
|
279
484
|
// KB-TRUST PHASE 3a: the bible records the commit it was exported from, so a
|
|
280
485
|
// later audit can date its entries against the tree they were verified on.
|
|
281
486
|
// Before this, a bible harvested from other repositories was indistinguishable
|
|
@@ -296,15 +501,16 @@ export async function kbExport(input) {
|
|
|
296
501
|
// exists to avoid. When the entry set is unchanged the file is left exactly as
|
|
297
502
|
// it is, which also keeps the recorded commit honest: it names the tree those
|
|
298
503
|
// entries were last verified against, not the commit that stored them.
|
|
504
|
+
assertNoDuplicateBibleIds(canonical, 'kb_export');
|
|
299
505
|
const nextEntriesJson = asciiSafeStringify(canonical);
|
|
300
506
|
if (entriesUnchanged(outPath, nextEntriesJson)) {
|
|
301
507
|
return JSON.stringify({ exported: canonical.length, path: outPath, scope, committed: false });
|
|
302
508
|
}
|
|
303
509
|
const bible = {
|
|
304
|
-
version:
|
|
510
|
+
version: BIBLE_FORMAT_VERSION,
|
|
305
511
|
provenance: {
|
|
306
|
-
commit: resolveHeadCommit(repoPath),
|
|
307
|
-
branch: resolveBranch(repoPath),
|
|
512
|
+
commit: input.baseCommit ?? resolveHeadCommit(repoPath),
|
|
513
|
+
branch: input.baseBranch ?? resolveBranch(repoPath),
|
|
308
514
|
entry_count: canonical.length,
|
|
309
515
|
},
|
|
310
516
|
entries: canonical,
|
|
@@ -1,23 +1,29 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
3
|
+
import type { Author } from '../services/knowledge/types.js';
|
|
4
|
+
export declare function validateAuthor(role: string | undefined): Author | 'unknown';
|
|
2
5
|
export declare const kbFeedbackSchema: z.ZodObject<{
|
|
3
|
-
repo_path: z.ZodOptional<z.
|
|
6
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
7
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
8
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
4
9
|
id: z.ZodString;
|
|
5
10
|
reason: z.ZodString;
|
|
6
11
|
role: z.ZodOptional<z.ZodString>;
|
|
7
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
8
12
|
}, "strip", z.ZodTypeAny, {
|
|
9
|
-
reason: string;
|
|
10
13
|
id: string;
|
|
14
|
+
reason: string;
|
|
11
15
|
role?: string | undefined;
|
|
12
|
-
|
|
13
|
-
|
|
16
|
+
repo?: unknown;
|
|
17
|
+
repo_path?: unknown;
|
|
18
|
+
repo_remote_url?: unknown;
|
|
14
19
|
}, {
|
|
15
|
-
reason: string;
|
|
16
20
|
id: string;
|
|
21
|
+
reason: string;
|
|
17
22
|
role?: string | undefined;
|
|
18
|
-
|
|
19
|
-
|
|
23
|
+
repo?: unknown;
|
|
24
|
+
repo_path?: unknown;
|
|
25
|
+
repo_remote_url?: unknown;
|
|
20
26
|
}>;
|
|
21
27
|
export type KbFeedbackInput = z.infer<typeof kbFeedbackSchema>;
|
|
22
|
-
export declare function kbFeedback(input: KbFeedbackInput): Promise<string>;
|
|
28
|
+
export declare function kbFeedback(input: KbFeedbackInput, anchor?: KbAnchor): Promise<string>;
|
|
23
29
|
//# sourceMappingURL=kb-feedback.d.ts.map
|
|
@@ -1,26 +1,28 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
3
|
+
import { getSelfKbProviders, memberOwnerTag } from '../services/knowledge/kb-self.js';
|
|
4
|
+
import { KbMemberViewError } from '../services/knowledge/member-bible-view.js';
|
|
5
|
+
import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
6
|
+
import { HttpKbProvider } from '../services/knowledge/http-provider.js';
|
|
5
7
|
// D5 (T2.3) pattern, DUPLICATED here rather than imported: src/tools/kb-capture.ts
|
|
6
8
|
// is touched ONLY by T1.1 per PLAN.md's shared-file sequencing, so this tool
|
|
7
9
|
// validates its own role hint against the same Author enum instead of
|
|
8
10
|
// exporting a shared helper out of a file this task must not modify.
|
|
9
11
|
const AUTHOR_VALUES = ['doer', 'reviewer', 'planner', 'plan-reviewer', 'kb-agent', 'kb-reconciler', 'harvest', 'pm', 'user'];
|
|
10
|
-
function validateAuthor(role) {
|
|
12
|
+
export function validateAuthor(role) {
|
|
11
13
|
if (role && AUTHOR_VALUES.includes(role)) {
|
|
12
14
|
return role;
|
|
13
15
|
}
|
|
14
16
|
return 'unknown';
|
|
15
17
|
}
|
|
16
18
|
export const kbFeedbackSchema = z.object({
|
|
17
|
-
...kbScopeFields,
|
|
18
|
-
repo_path: z.string().optional()
|
|
19
|
-
.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.'),
|
|
20
19
|
id: z.string().min(1).describe('ID of the KB entry the feedback applies to'),
|
|
21
20
|
reason: z.string().min(1).describe('What was wrong in practice -- appended to the entry content as an ASCII feedback note'),
|
|
22
21
|
role: z.string().optional()
|
|
23
22
|
.describe('Role hint for provenance: doer/reviewer/planner/plan-reviewer/kb-agent/harvest/pm/user. Validated server-side against the Author enum; invalid or absent stamps "unknown" in the note.'),
|
|
23
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
24
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
25
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
24
26
|
});
|
|
25
27
|
// D7 (F8): downvote a KB entry that proved wrong in practice. Marks stale=1 +
|
|
26
28
|
// flagged_for_review=1 and appends an ASCII feedback note "[feedback <ISO>]
|
|
@@ -30,11 +32,25 @@ export const kbFeedbackSchema = z.object({
|
|
|
30
32
|
// resolves it in kb-review. EXCEPTION: an ACTIVE user-directive is flagged for
|
|
31
33
|
// review only (never staled) because directives outrank agent experience and
|
|
32
34
|
// the human decides -- see SqliteProvider.feedback() for the exact guard.
|
|
33
|
-
export async function kbFeedback(input) {
|
|
34
|
-
|
|
35
|
-
|
|
35
|
+
export async function kbFeedback(input, anchor) {
|
|
36
|
+
// A MEMBER session does not downvote entries in the shared KB, under either
|
|
37
|
+
// provider: a typed no-op that touches no store (checked before any provider
|
|
38
|
+
// is opened).
|
|
39
|
+
if (memberOwnerTag(anchor) !== undefined) {
|
|
40
|
+
throw new KbMemberViewError('E-MEMBER-VIEW-READ-ONLY', '', `kb_feedback is not available in a member session: a member session does not flag entries in the shared KB (over SQLite its reads come from the read-only checkout bible; under an http KB provider the server's entries are shared by every member); entry '${input.id}' was not changed.`, 'Run kb_feedback from a FULL session (no member identity), or flag the entry for review through the maintainer.');
|
|
41
|
+
}
|
|
42
|
+
const providers = await getSelfKbProviders(anchor);
|
|
36
43
|
const author = validateAuthor(input.role);
|
|
37
|
-
|
|
44
|
+
// An HTTP-backed KB: the remote server owns the entry and decides its
|
|
45
|
+
// stale/flagged state; its response is returned as is (an unreachable
|
|
46
|
+
// server is a thrown E-KB-HTTP-UNREACHABLE; nothing is queued). Confidence is never written or invented client-side.
|
|
47
|
+
if (providers.project instanceof HttpKbProvider) {
|
|
48
|
+
return JSON.stringify(await providers.project.feedback(input.id, input.reason, author));
|
|
49
|
+
}
|
|
50
|
+
if (!isSqliteProject(providers.project)) {
|
|
51
|
+
throw new Error('kb_feedback: this operation is not supported by the configured KB provider');
|
|
52
|
+
}
|
|
53
|
+
const entry = await providers.project.feedback(input.id, input.reason, author);
|
|
38
54
|
return JSON.stringify({
|
|
39
55
|
id: entry.id,
|
|
40
56
|
stale: entry.stale,
|
|
@@ -1,14 +1,18 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbFreshnessSweepSchema: z.ZodObject<{
|
|
3
|
-
repo_path: z.ZodOptional<z.
|
|
4
|
-
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
5
7
|
}, "strip", z.ZodTypeAny, {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
+
repo?: unknown;
|
|
9
|
+
repo_path?: unknown;
|
|
10
|
+
repo_remote_url?: unknown;
|
|
8
11
|
}, {
|
|
9
|
-
|
|
10
|
-
|
|
12
|
+
repo?: unknown;
|
|
13
|
+
repo_path?: unknown;
|
|
14
|
+
repo_remote_url?: unknown;
|
|
11
15
|
}>;
|
|
12
16
|
export type KbFreshnessSweepInput = z.infer<typeof kbFreshnessSweepSchema>;
|
|
13
|
-
export declare function kbFreshnessSweep(input: KbFreshnessSweepInput): Promise<string>;
|
|
17
|
+
export declare function kbFreshnessSweep(input: KbFreshnessSweepInput, anchor?: KbAnchor): Promise<string>;
|
|
14
18
|
//# sourceMappingURL=kb-freshness-sweep.d.ts.map
|
|
@@ -1,6 +1,6 @@
|
|
|
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 { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
5
5
|
// T1.3 (F2/D2 HARDENED, resolution R2): kb_freshness_sweep -- a bounded,
|
|
6
6
|
// full-KB BIDIRECTIONAL freshness sweep. Re-hashes the stored per-file basis of
|
|
@@ -12,12 +12,12 @@ import { requireSqliteProject } from '../services/knowledge/require-sqlite-proje
|
|
|
12
12
|
// revival requires a sweep, not just a prime. Invoked standalone by the PM
|
|
13
13
|
// reconcile flow and internally by kb_import.
|
|
14
14
|
export const kbFreshnessSweepSchema = z.object({
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
16
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
17
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
18
18
|
});
|
|
19
|
-
export async function kbFreshnessSweep(input) {
|
|
20
|
-
const providers = await
|
|
19
|
+
export async function kbFreshnessSweep(input, anchor) {
|
|
20
|
+
const providers = await getSelfKbProviders(anchor);
|
|
21
21
|
// apra-fleet-b4g.4 (criterion 5): no explicit root on purpose -- freshnessSweep
|
|
22
22
|
// now defaults to the provider's OWN anchor (the root the basis was stored
|
|
23
23
|
// against), which is exactly what this call site wants. Passing a root here
|
|
@@ -1,20 +1,24 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbHarvestSchema: 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
|
session_transcript: z.ZodOptional<z.ZodString>;
|
|
5
8
|
session_id: z.ZodOptional<z.ZodString>;
|
|
6
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
7
9
|
}, "strip", z.ZodTypeAny, {
|
|
8
|
-
|
|
9
|
-
|
|
10
|
+
repo?: unknown;
|
|
11
|
+
repo_path?: unknown;
|
|
12
|
+
repo_remote_url?: unknown;
|
|
10
13
|
session_transcript?: string | undefined;
|
|
11
14
|
session_id?: string | undefined;
|
|
12
15
|
}, {
|
|
13
|
-
|
|
14
|
-
|
|
16
|
+
repo?: unknown;
|
|
17
|
+
repo_path?: unknown;
|
|
18
|
+
repo_remote_url?: unknown;
|
|
15
19
|
session_transcript?: string | undefined;
|
|
16
20
|
session_id?: string | undefined;
|
|
17
21
|
}>;
|
|
18
22
|
export type KbHarvestInput = z.infer<typeof kbHarvestSchema>;
|
|
19
|
-
export declare function kbHarvest(input: KbHarvestInput): Promise<string>;
|
|
23
|
+
export declare function kbHarvest(input: KbHarvestInput, anchor?: KbAnchor): Promise<string>;
|
|
20
24
|
//# sourceMappingURL=kb-harvest.d.ts.map
|