@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,19 +1,108 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
3
|
+
import type { KBEntry } from '../services/knowledge/types.js';
|
|
2
4
|
export declare const kbExportSchema: z.ZodObject<{
|
|
3
|
-
repo_path: z.ZodOptional<z.
|
|
5
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
7
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
4
8
|
scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
|
|
5
|
-
|
|
9
|
+
baseBranch: z.ZodOptional<z.ZodString>;
|
|
10
|
+
baseCommit: z.ZodOptional<z.ZodString>;
|
|
6
11
|
}, "strip", z.ZodTypeAny, {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
12
|
+
repo?: unknown;
|
|
13
|
+
scope?: "project" | "global" | undefined;
|
|
14
|
+
repo_path?: unknown;
|
|
15
|
+
repo_remote_url?: unknown;
|
|
16
|
+
baseBranch?: string | undefined;
|
|
17
|
+
baseCommit?: string | undefined;
|
|
10
18
|
}, {
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
19
|
+
repo?: unknown;
|
|
20
|
+
scope?: "project" | "global" | undefined;
|
|
21
|
+
repo_path?: unknown;
|
|
22
|
+
repo_remote_url?: unknown;
|
|
23
|
+
baseBranch?: string | undefined;
|
|
24
|
+
baseCommit?: string | undefined;
|
|
14
25
|
}>;
|
|
15
26
|
export type KbExportInput = z.infer<typeof kbExportSchema>;
|
|
27
|
+
export interface CanonicalEntry {
|
|
28
|
+
id: string;
|
|
29
|
+
type: string;
|
|
30
|
+
title: string;
|
|
31
|
+
summary: string;
|
|
32
|
+
symbols: string[];
|
|
33
|
+
source_files: string[];
|
|
34
|
+
confidence: string;
|
|
35
|
+
updated_at: string;
|
|
36
|
+
/**
|
|
37
|
+
* Bible format v3: the per-file hash basis (repo-relative path -> hash) the
|
|
38
|
+
* entry was admitted against, copied verbatim from the exporting provider's
|
|
39
|
+
* stored basis (SqliteProvider.getSourceFileBases) -- never re-hashed at
|
|
40
|
+
* write time. Keys are sorted so the file stays byte-stable. Absent on an
|
|
41
|
+
* entry carried over from a v1/v2 bible, which has no basis to carry.
|
|
42
|
+
*/
|
|
43
|
+
source_file_hashes?: Record<string, string>;
|
|
44
|
+
}
|
|
45
|
+
/** The bible format version every writer emits. */
|
|
46
|
+
export declare const BIBLE_FORMAT_VERSION: 3;
|
|
47
|
+
/**
|
|
48
|
+
* The bible envelope. v3 (current) adds per-entry source_file_hashes; v2 is
|
|
49
|
+
* the same envelope without them. kb_import accepts v3, v2 and the legacy bare
|
|
50
|
+
* array, selecting on Array.isArray -- an older bible must keep importing.
|
|
51
|
+
*/
|
|
52
|
+
export interface CanonicalBible {
|
|
53
|
+
version: typeof BIBLE_FORMAT_VERSION;
|
|
54
|
+
provenance: {
|
|
55
|
+
/** 40-char HEAD sha, or null when the repo has no commits or git is absent. */
|
|
56
|
+
commit: string | null;
|
|
57
|
+
branch: string | null;
|
|
58
|
+
entry_count: number;
|
|
59
|
+
};
|
|
60
|
+
entries: CanonicalEntry[];
|
|
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 declare function withSourceFileHashes(entry: CanonicalEntry, basis: Record<string, string>): CanonicalEntry;
|
|
68
|
+
/**
|
|
69
|
+
* Map a KB entry to the bible's stable field set. Shared with kb_bible_commit.
|
|
70
|
+
* `basis` is the entry's STORED per-file hash basis (the one the bible
|
|
71
|
+
* predicate admitted it against); when given and non-empty it is written as
|
|
72
|
+
* source_file_hashes (format v3). Nothing is hashed here.
|
|
73
|
+
*/
|
|
74
|
+
export declare function toCanonicalEntry(e: KBEntry, basis?: Record<string, string> | null): CanonicalEntry;
|
|
75
|
+
/**
|
|
76
|
+
* Duplicate-id guard shared by every bible writer: a bible is keyed by id, so
|
|
77
|
+
* one about to be written with two entries sharing an id is corrupt. Throws
|
|
78
|
+
* (naming the id) BEFORE anything is written, so the file on disk is untouched.
|
|
79
|
+
*/
|
|
80
|
+
export declare function assertNoDuplicateBibleIds(entries: Array<{
|
|
81
|
+
id?: unknown;
|
|
82
|
+
}>, toolName: string): void;
|
|
83
|
+
/** Deterministic id ordering so re-exports produce meaningful diffs. */
|
|
84
|
+
export declare function compareById(a: {
|
|
85
|
+
id: string;
|
|
86
|
+
}, b: {
|
|
87
|
+
id: string;
|
|
88
|
+
}): number;
|
|
89
|
+
/**
|
|
90
|
+
* The entries of the bible already on disk, in either shape (legacy bare array
|
|
91
|
+
* or v2/v3 envelope). null when the file is absent or unparseable.
|
|
92
|
+
*/
|
|
93
|
+
export declare function readBibleEntries(outPath: string): CanonicalEntry[] | null;
|
|
94
|
+
/**
|
|
95
|
+
* PATHSPEC-ONLY commit of the bible file with the dedicated pm-kb identity:
|
|
96
|
+
* git add <path> then a commit scoped to -- <path>, so unrelated staged or
|
|
97
|
+
* dirty working-tree state is never swept in. Throws on any git failure; the
|
|
98
|
+
* caller decides whether that is fatal. Never pushes.
|
|
99
|
+
*/
|
|
100
|
+
export declare function commitBiblePath(repoPath: string, outPath: string, message: string): void;
|
|
101
|
+
export declare function asciiSafeStringify(value: unknown): string;
|
|
102
|
+
export declare function requireLocalFolder(folder: string, toolName?: string): string;
|
|
16
103
|
/** Test seam: the default is a trust decision, so it is asserted directly. */
|
|
17
104
|
export declare function _autoCommitEnabledForTest(): boolean;
|
|
18
|
-
export declare function
|
|
105
|
+
export declare function isGitRepo(repoPath: string): boolean;
|
|
106
|
+
export declare function bibleContentChanged(repoPath: string, outPath: string): boolean;
|
|
107
|
+
export declare function kbExport(input: KbExportInput, anchor?: KbAnchor): Promise<string>;
|
|
19
108
|
//# sourceMappingURL=kb-export.d.ts.map
|
package/dist/tools/kb-export.js
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
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 { FLEET_DIR } from '../paths.js';
|
|
7
|
+
import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
|
|
8
8
|
import { logWarn } from '../utils/log-helpers.js';
|
|
9
|
+
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
10
|
+
import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
11
|
+
import { filterProjectBibleCandidates } from '../services/knowledge/bible-basis-filter.js';
|
|
9
12
|
// T3.4 (F8b, D8): export half of the shareable, diffable team bible. Writes
|
|
10
13
|
// all CONFIRMED, non-superseded, non-stale project entries to
|
|
11
14
|
// <repo>/.fleet/kb-canonical.json. Registered as a real MCP tool (not just an
|
|
@@ -17,15 +20,11 @@ import { logWarn } from '../utils/log-helpers.js';
|
|
|
17
20
|
// discretion: the export TOOL commits with its own dedicated identity
|
|
18
21
|
// (pm-kb), so no role's "no git operations" rule is violated by this
|
|
19
22
|
// automatic side effect.
|
|
20
|
-
//
|
|
21
|
-
//
|
|
22
|
-
//
|
|
23
|
-
//
|
|
24
|
-
//
|
|
25
|
-
// blindly; (3) neither validates -- kb_export refuses with a clear error
|
|
26
|
-
// rather than silently writing relative to an arbitrary path. There is no
|
|
27
|
-
// bare process.cwd() fallback: the fallback tier is validated the same way
|
|
28
|
-
// explicit input is.
|
|
23
|
+
// kb (self): the repo written to is the calling session's own folder -- the
|
|
24
|
+
// member's registered work folder for a member session, the server's working
|
|
25
|
+
// folder otherwise (src/services/knowledge/kb-self.ts). It is validated (must
|
|
26
|
+
// exist, be a git repo with an origin remote) or kb_export refuses with a
|
|
27
|
+
// typed E-SELF error; it is never a scope argument.
|
|
29
28
|
// T3.3 (F9a, D8): scope param -- 'project' (default, unchanged behavior) reads
|
|
30
29
|
// the PROJECT KB and writes .fleet/kb-canonical.json (as before); 'global'
|
|
31
30
|
// reads the GLOBAL KB (providers.global -- the shared kb.sqlite at
|
|
@@ -34,13 +33,109 @@ import { logWarn } from '../utils/log-helpers.js';
|
|
|
34
33
|
// apra-fleet platform repo, committed there per D8). Same stable field set,
|
|
35
34
|
// same asciiSafeStringify + deterministic id-sorted output, and the same
|
|
36
35
|
// auto-commit behavior (T2.3) applies to the global file too.
|
|
36
|
+
// Provenance names the TARGET BASE branch: the branch the bible's entries will
|
|
37
|
+
// merge into, not the (typically feature) branch the export ran on. baseBranch
|
|
38
|
+
// and baseCommit let the caller say so explicitly; when omitted, provenance
|
|
39
|
+
// falls back to the export folder's own HEAD branch and commit (unchanged).
|
|
37
40
|
export const kbExportSchema = z.object({
|
|
38
|
-
...kbScopeFields,
|
|
39
|
-
repo_path: z.string().optional()
|
|
40
|
-
.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.'),
|
|
41
41
|
scope: z.enum(['project', 'global']).optional()
|
|
42
|
-
.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
|
|
42
|
+
.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).'),
|
|
43
|
+
baseBranch: z.string().min(1).optional()
|
|
44
|
+
.describe('The target base branch (the branch the entries merge into). Written to provenance.branch. Omitted: the export folder HEAD branch.'),
|
|
45
|
+
baseCommit: z.string().min(1).optional()
|
|
46
|
+
.describe('The base commit the entries were verified against. Written to provenance.commit. Omitted: the export folder HEAD commit.'),
|
|
47
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
48
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
49
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
43
50
|
});
|
|
51
|
+
/** The bible format version every writer emits. */
|
|
52
|
+
export const BIBLE_FORMAT_VERSION = 3;
|
|
53
|
+
/** A basis map with its keys in sorted order, so serialization is byte-stable. */
|
|
54
|
+
function sortedBasis(basis) {
|
|
55
|
+
const out = {};
|
|
56
|
+
for (const key of Object.keys(basis).sort())
|
|
57
|
+
out[key] = basis[key];
|
|
58
|
+
return out;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* A bible entry with `basis` attached as its source_file_hashes (keys sorted,
|
|
62
|
+
* copied verbatim -- never re-hashed); every other field is left as it is.
|
|
63
|
+
* Used by kb_bible_commit's legacy backfill.
|
|
64
|
+
*/
|
|
65
|
+
export function withSourceFileHashes(entry, basis) {
|
|
66
|
+
return { ...entry, source_file_hashes: sortedBasis(basis) };
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Map a KB entry to the bible's stable field set. Shared with kb_bible_commit.
|
|
70
|
+
* `basis` is the entry's STORED per-file hash basis (the one the bible
|
|
71
|
+
* predicate admitted it against); when given and non-empty it is written as
|
|
72
|
+
* source_file_hashes (format v3). Nothing is hashed here.
|
|
73
|
+
*/
|
|
74
|
+
export function toCanonicalEntry(e, basis) {
|
|
75
|
+
const entry = {
|
|
76
|
+
id: e.id,
|
|
77
|
+
type: e.type,
|
|
78
|
+
title: e.title,
|
|
79
|
+
summary: e.summary,
|
|
80
|
+
symbols: e.symbols,
|
|
81
|
+
source_files: e.source_files,
|
|
82
|
+
confidence: e.confidence,
|
|
83
|
+
updated_at: e.promoted_at || e.created_at,
|
|
84
|
+
};
|
|
85
|
+
if (basis && Object.keys(basis).length > 0)
|
|
86
|
+
entry.source_file_hashes = sortedBasis(basis);
|
|
87
|
+
return entry;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Duplicate-id guard shared by every bible writer: a bible is keyed by id, so
|
|
91
|
+
* one about to be written with two entries sharing an id is corrupt. Throws
|
|
92
|
+
* (naming the id) BEFORE anything is written, so the file on disk is untouched.
|
|
93
|
+
*/
|
|
94
|
+
export function assertNoDuplicateBibleIds(entries, toolName) {
|
|
95
|
+
const seen = new Set();
|
|
96
|
+
for (const e of entries) {
|
|
97
|
+
const id = String(e.id);
|
|
98
|
+
if (seen.has(id)) {
|
|
99
|
+
throw new Error(toolName + ': refusing to write a bible with duplicate entry id ' + JSON.stringify(id)
|
|
100
|
+
+ ' -- the bible is keyed by id; resolve the duplicate in .fleet/kb-canonical.json first');
|
|
101
|
+
}
|
|
102
|
+
seen.add(id);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
/** Deterministic id ordering so re-exports produce meaningful diffs. */
|
|
106
|
+
export function compareById(a, b) {
|
|
107
|
+
return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* The entries of the bible already on disk, in either shape (legacy bare array
|
|
111
|
+
* or v2/v3 envelope). null when the file is absent or unparseable.
|
|
112
|
+
*/
|
|
113
|
+
export function readBibleEntries(outPath) {
|
|
114
|
+
if (!fs.existsSync(outPath))
|
|
115
|
+
return null;
|
|
116
|
+
try {
|
|
117
|
+
const parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
|
|
118
|
+
const existing = Array.isArray(parsed)
|
|
119
|
+
? parsed
|
|
120
|
+
: (parsed && Array.isArray(parsed.entries) ? parsed.entries : null);
|
|
121
|
+
return existing;
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
return null;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* PATHSPEC-ONLY commit of the bible file with the dedicated pm-kb identity:
|
|
129
|
+
* git add <path> then a commit scoped to -- <path>, so unrelated staged or
|
|
130
|
+
* dirty working-tree state is never swept in. Throws on any git failure; the
|
|
131
|
+
* caller decides whether that is fatal. Never pushes.
|
|
132
|
+
*/
|
|
133
|
+
export function commitBiblePath(repoPath, outPath, message) {
|
|
134
|
+
execFileSync('git', ['add', outPath], {
|
|
135
|
+
cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
|
|
136
|
+
});
|
|
137
|
+
execFileSync('git', ['-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 });
|
|
138
|
+
}
|
|
44
139
|
/**
|
|
45
140
|
* Resolve HEAD, degrading gracefully to null rather than throwing: a repo with
|
|
46
141
|
* no commits yet, a non-repo directory, or a machine without git must still be
|
|
@@ -80,7 +175,7 @@ function gitOrNull(repoPath, args) {
|
|
|
80
175
|
return null;
|
|
81
176
|
try {
|
|
82
177
|
const out = execFileSync('git', args, {
|
|
83
|
-
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
178
|
+
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
84
179
|
}).trim();
|
|
85
180
|
return out.length > 0 ? out : null;
|
|
86
181
|
}
|
|
@@ -99,7 +194,7 @@ function gitOrNull(repoPath, args) {
|
|
|
99
194
|
// ASCII too) and avoids template literals -- the pre-commit hook's
|
|
100
195
|
// backtick-n/t/r scan false-positives on template-literal escape sequences,
|
|
101
196
|
// the same gotcha T2.3's promote() fix worked around.
|
|
102
|
-
function asciiSafeStringify(value) {
|
|
197
|
+
export function asciiSafeStringify(value) {
|
|
103
198
|
const json = JSON.stringify(value, null, 2);
|
|
104
199
|
const maxAsciiCode = 127;
|
|
105
200
|
const escapePrefix = String.fromCharCode(92) + 'u'; // backslash + 'u', built at runtime
|
|
@@ -118,43 +213,15 @@ function asciiSafeStringify(value) {
|
|
|
118
213
|
}
|
|
119
214
|
return out;
|
|
120
215
|
}
|
|
121
|
-
//
|
|
122
|
-
//
|
|
123
|
-
//
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory()) {
|
|
128
|
-
throw new Error('kb_export: repo_path does not exist or is not a directory: ' + candidate);
|
|
216
|
+
// The resolved anchor folder must exist on THIS host: kb_export writes the
|
|
217
|
+
// bible file there, so an anchor naming a folder on another host (a remote
|
|
218
|
+
// member's work folder) has nothing meaningful to do and must refuse.
|
|
219
|
+
export function requireLocalFolder(folder, toolName = 'kb_export') {
|
|
220
|
+
if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory()) {
|
|
221
|
+
throw new Error(toolName + ': repo folder does not exist or is not a directory on this host: ' + folder);
|
|
129
222
|
}
|
|
130
|
-
return
|
|
223
|
+
return folder;
|
|
131
224
|
}
|
|
132
|
-
// T2.3 (F6a, D5 AMENDED): switch for the auto-commit below, read from the
|
|
133
|
-
// same KB config file kb-setup.ts writes (FLEET_DIR/knowledge/config.json),
|
|
134
|
-
// under a { bible: { autoCommit?: boolean } } section.
|
|
135
|
-
//
|
|
136
|
-
// USER DIRECTIVE 2026-08-11: the default is TRUE.
|
|
137
|
-
//
|
|
138
|
-
// KB-TRUST PHASE 1 (2026-08-03) had set it FALSE, reasoning that kb_import
|
|
139
|
-
// preserves a bible's CONFIRMED confidence as its sole exemption from the D1
|
|
140
|
-
// clamp -- justified in-code because "the bible is a git-reviewed, human-merged
|
|
141
|
-
// artifact" -- and that auto-committing as pm-kb <kb@pm.local>, mid-sprint, on
|
|
142
|
-
// a feature branch made that review a bot commit nobody was asked to look at.
|
|
143
|
-
//
|
|
144
|
-
// The KB audit of 2026-08-11 showed the opposite failure was the real one: with
|
|
145
|
-
// the default off, and nothing in the pipeline calling kb_export at all, 1 of 17
|
|
146
|
-
// repositories had a bible. Knowledge that never gets written down cannot be
|
|
147
|
-
// reviewed either, and an export left uncommitted on one machine is knowledge
|
|
148
|
-
// nobody else will ever see. The auto-commit lands as a diff on the sprint's own
|
|
149
|
-
// feature branch, which a human reads in that sprint's PR -- review later in the
|
|
150
|
-
// loop than Phase 1 wanted, but review nonetheless. The commit remains
|
|
151
|
-
// pathspec-scoped to the bible file, keeps its dedicated pm-kb identity, and is
|
|
152
|
-
// still NEVER pushed automatically.
|
|
153
|
-
//
|
|
154
|
-
// Missing file and missing section degrade to the default (TRUE). A MALFORMED
|
|
155
|
-
// config still degrades to FALSE: "I could not read your settings" must not be
|
|
156
|
-
// the moment the tool starts committing on the team's behalf.
|
|
157
|
-
const KB_CONFIG_PATH = path.join(FLEET_DIR, 'knowledge', 'config.json');
|
|
158
225
|
function autoCommitMode() {
|
|
159
226
|
try {
|
|
160
227
|
if (!fs.existsSync(KB_CONFIG_PATH))
|
|
@@ -177,7 +244,7 @@ function autoCommitEnabled() {
|
|
|
177
244
|
return autoCommitMode() !== 'off';
|
|
178
245
|
}
|
|
179
246
|
// The entry count of the bible ALREADY on disk, read before we overwrite it.
|
|
180
|
-
// Accepts
|
|
247
|
+
// Accepts every shape (legacy bare array, v2/v3 envelope) like entriesUnchanged.
|
|
181
248
|
// null means "no comparable prior bible" -- absent file, or unparseable -- in
|
|
182
249
|
// which case there is no shrink to detect and the export is a first write.
|
|
183
250
|
function bibleEntryCount(outPath) {
|
|
@@ -198,7 +265,7 @@ function bibleEntryCount(outPath) {
|
|
|
198
265
|
export function _autoCommitEnabledForTest() {
|
|
199
266
|
return autoCommitEnabled();
|
|
200
267
|
}
|
|
201
|
-
function isGitRepo(repoPath) {
|
|
268
|
+
export function isGitRepo(repoPath) {
|
|
202
269
|
return fs.existsSync(path.join(repoPath, '.git'));
|
|
203
270
|
}
|
|
204
271
|
// "Content actually changed" (D5): git status --porcelain against the exact
|
|
@@ -206,9 +273,9 @@ function isGitRepo(repoPath) {
|
|
|
206
273
|
// already matches HEAD for this one path -- re-exporting an identical bible
|
|
207
274
|
// is a no-op, so there is nothing to commit. Any output (modified, or a
|
|
208
275
|
// brand-new untracked file on the very first export) means it changed.
|
|
209
|
-
function bibleContentChanged(repoPath, outPath) {
|
|
276
|
+
export function bibleContentChanged(repoPath, outPath) {
|
|
210
277
|
const status = execFileSync('git', ['status', '--porcelain', '--', outPath], {
|
|
211
|
-
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
278
|
+
cwd: repoPath, encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
212
279
|
});
|
|
213
280
|
return status.trim().length > 0;
|
|
214
281
|
}
|
|
@@ -249,12 +316,9 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
|
|
|
249
316
|
try {
|
|
250
317
|
if (!bibleContentChanged(repoPath, outPath))
|
|
251
318
|
return false;
|
|
252
|
-
execFileSync('git', ['add', outPath], {
|
|
253
|
-
cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'],
|
|
254
|
-
});
|
|
255
319
|
const scopeLabel = scope === 'global' ? 'global knowledge bible' : 'knowledge bible';
|
|
256
320
|
const message = 'chore(kb): update ' + scopeLabel + ' -- ' + entryCount + ' confirmed entries';
|
|
257
|
-
|
|
321
|
+
commitBiblePath(repoPath, outPath, message);
|
|
258
322
|
return true;
|
|
259
323
|
}
|
|
260
324
|
catch (err) {
|
|
@@ -263,44 +327,117 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
|
|
|
263
327
|
return false;
|
|
264
328
|
}
|
|
265
329
|
}
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
330
|
+
// Id ordering for the additive project merge, whose existing bible entries are
|
|
331
|
+
// raw objects (never re-shaped) and so carry an id of unknown type.
|
|
332
|
+
function byId(a, b) {
|
|
333
|
+
const x = String(a.id);
|
|
334
|
+
const y = String(b.id);
|
|
335
|
+
return x < y ? -1 : x > y ? 1 : 0;
|
|
336
|
+
}
|
|
337
|
+
/**
|
|
338
|
+
* Entries of the bible already on disk, as raw objects (never re-shaped, so
|
|
339
|
+
* they are written back byte-for-byte equivalent). Accepts the v2/v3 envelope and
|
|
340
|
+
* the legacy bare array. An absent file is an empty bible. A file that exists
|
|
341
|
+
* but cannot be parsed as either shape THROWS: the project export is additive
|
|
342
|
+
* and must never overwrite (and so silently drop) a bible it cannot read.
|
|
343
|
+
*/
|
|
344
|
+
function readExistingBibleEntries(outPath) {
|
|
345
|
+
if (!fs.existsSync(outPath))
|
|
346
|
+
return [];
|
|
347
|
+
let parsed;
|
|
348
|
+
try {
|
|
349
|
+
parsed = JSON.parse(fs.readFileSync(outPath, 'utf-8'));
|
|
350
|
+
}
|
|
351
|
+
catch (err) {
|
|
352
|
+
throw new Error('kb_export: existing bible is not valid JSON, refusing to overwrite it: ' + outPath
|
|
353
|
+
+ ' (' + (err instanceof Error ? err.message : String(err)) + ')');
|
|
354
|
+
}
|
|
355
|
+
const list = Array.isArray(parsed)
|
|
356
|
+
? parsed
|
|
357
|
+
: (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries)
|
|
358
|
+
? parsed.entries
|
|
359
|
+
: null);
|
|
360
|
+
if (list === null) {
|
|
361
|
+
throw new Error('kb_export: existing bible has no entries array, refusing to overwrite it: ' + outPath);
|
|
362
|
+
}
|
|
363
|
+
return list;
|
|
364
|
+
}
|
|
365
|
+
// PROJECT-SCOPE EXPORT: basis filter + additive merge.
|
|
366
|
+
//
|
|
367
|
+
// Only CONFIRMED (non-superseded, non-stale -- list() already excludes those)
|
|
368
|
+
// entries whose per-file hash basis matches the files in repoPath qualify (see
|
|
369
|
+
// qualifiesForProjectBible in services/knowledge/bible-basis-filter.ts). A
|
|
370
|
+
// member-local KB routinely holds entries about files the exported tree does
|
|
371
|
+
// not contain; publishing them would leak them into the committed artifact.
|
|
372
|
+
//
|
|
373
|
+
// The merge is ADDITIVE: every entry already in the bible is kept exactly as it
|
|
374
|
+
// is (curated, possibly human-edited), qualifying entries whose id is not yet
|
|
375
|
+
// present are added, and on an id collision the existing bible entry wins.
|
|
376
|
+
// Nothing is ever removed by an export -- removal is a human (or reconcile)
|
|
377
|
+
// edit of the file. Consequently the project bible never shrinks through this
|
|
378
|
+
// path and the shrink guard in maybeAutoCommitBible only matters for global.
|
|
379
|
+
//
|
|
380
|
+
// No new id to add -> the file is not touched at all (byte-identical,
|
|
381
|
+
// provenance untouched) and nothing is committed.
|
|
382
|
+
//
|
|
383
|
+
// `exported` in the response is the number of entries in the bible as written
|
|
384
|
+
// (or as left on disk when nothing was added), not the number newly added.
|
|
385
|
+
async function exportProjectBible(source, repoPath, outPath, input) {
|
|
386
|
+
const existing = readExistingBibleEntries(outPath);
|
|
387
|
+
const existingIds = new Set(existing.map(e => String(e.id)));
|
|
388
|
+
const confirmed = await source.list({ confidence: ['CONFIRMED'] });
|
|
389
|
+
const newCandidates = confirmed.filter(e => !existingIds.has(e.id));
|
|
390
|
+
const bases = source.getSourceFileBases(newCandidates.map(e => e.id));
|
|
391
|
+
const qualifying = await filterProjectBibleCandidates(newCandidates, bases, repoPath);
|
|
392
|
+
if (qualifying.length === 0) {
|
|
393
|
+
return JSON.stringify({ exported: existing.length, path: outPath, scope: 'project', committed: false });
|
|
394
|
+
}
|
|
395
|
+
// Each added entry carries the exact stored basis it was just admitted against.
|
|
396
|
+
const merged = [...existing, ...qualifying.map(e => toCanonicalEntry(e, bases.get(e.id)))].sort(byId);
|
|
397
|
+
assertNoDuplicateBibleIds(merged, 'kb_export');
|
|
398
|
+
const bible = {
|
|
399
|
+
version: BIBLE_FORMAT_VERSION,
|
|
400
|
+
provenance: {
|
|
401
|
+
commit: input.baseCommit ?? resolveHeadCommit(repoPath),
|
|
402
|
+
branch: input.baseBranch ?? resolveBranch(repoPath),
|
|
403
|
+
entry_count: merged.length,
|
|
404
|
+
},
|
|
405
|
+
entries: merged,
|
|
406
|
+
};
|
|
407
|
+
const fleetDir = path.dirname(outPath);
|
|
408
|
+
if (!fs.existsSync(fleetDir))
|
|
409
|
+
fs.mkdirSync(fleetDir, { recursive: true });
|
|
410
|
+
const previousEntryCount = bibleEntryCount(outPath);
|
|
411
|
+
fs.writeFileSync(outPath, asciiSafeStringify(bible) + '\n', 'utf-8');
|
|
412
|
+
const committed = maybeAutoCommitBible(repoPath, outPath, merged.length, 'project', previousEntryCount);
|
|
413
|
+
return JSON.stringify({ exported: merged.length, path: outPath, scope: 'project', committed });
|
|
414
|
+
}
|
|
415
|
+
export async function kbExport(input, anchor) {
|
|
416
|
+
// kb_export WRITES <folder>/.fleet/kb-canonical.json and git-commits it, so
|
|
417
|
+
// an unreachable folder has no meaningful behaviour left -- it must not
|
|
418
|
+
// proceed. An invalid anchor throws here, before getKbProviders is reached,
|
|
419
|
+
// so no provider is ever anchored somewhere the caller did not mean.
|
|
420
|
+
const resolved = resolveKbAnchor(anchor);
|
|
421
|
+
const repoPath = requireLocalFolder(resolved.folder);
|
|
278
422
|
const scope = input.scope ?? 'project';
|
|
279
423
|
// Read from the SAME repo we are about to write the bible into. Resolving the
|
|
280
424
|
// source from process cwd while writing to repoPath is how repo A's entries
|
|
281
425
|
// used to end up serialised into repo B's committed bible.
|
|
282
|
-
const providers = await getKbProviders(repoPath,
|
|
283
|
-
const
|
|
284
|
-
const
|
|
426
|
+
const providers = await getKbProviders(repoPath, resolved.remoteUrl);
|
|
427
|
+
const fleetDir = path.join(repoPath, '.fleet');
|
|
428
|
+
const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
|
|
429
|
+
const outPath = path.join(fleetDir, fileName);
|
|
430
|
+
if (scope === 'project') {
|
|
431
|
+
return exportProjectBible(requireSqliteProject(providers.project, 'kb_export'), repoPath, outPath, input);
|
|
432
|
+
}
|
|
433
|
+
const entries = await providers.global.list({ confidence: ['CONFIRMED'] });
|
|
285
434
|
// Deterministic ordering by id so re-exports produce meaningful diffs.
|
|
286
435
|
const canonical = entries
|
|
287
|
-
.map(e => (
|
|
288
|
-
|
|
289
|
-
type: e.type,
|
|
290
|
-
title: e.title,
|
|
291
|
-
summary: e.summary,
|
|
292
|
-
symbols: e.symbols,
|
|
293
|
-
source_files: e.source_files,
|
|
294
|
-
confidence: e.confidence,
|
|
295
|
-
updated_at: e.promoted_at || e.created_at,
|
|
296
|
-
}))
|
|
297
|
-
.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
|
|
298
|
-
const fleetDir = path.join(repoPath, '.fleet');
|
|
436
|
+
.map(e => toCanonicalEntry(e))
|
|
437
|
+
.sort(compareById);
|
|
299
438
|
if (!fs.existsSync(fleetDir)) {
|
|
300
439
|
fs.mkdirSync(fleetDir, { recursive: true });
|
|
301
440
|
}
|
|
302
|
-
const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
|
|
303
|
-
const outPath = path.join(fleetDir, fileName);
|
|
304
441
|
// KB-TRUST PHASE 3a: the bible records the commit it was exported from, so a
|
|
305
442
|
// later audit can date its entries against the tree they were verified on.
|
|
306
443
|
// Before this, a bible harvested from other repositories was indistinguishable
|
|
@@ -321,15 +458,16 @@ export async function kbExport(input) {
|
|
|
321
458
|
// exists to avoid. When the entry set is unchanged the file is left exactly as
|
|
322
459
|
// it is, which also keeps the recorded commit honest: it names the tree those
|
|
323
460
|
// entries were last verified against, not the commit that stored them.
|
|
461
|
+
assertNoDuplicateBibleIds(canonical, 'kb_export');
|
|
324
462
|
const nextEntriesJson = asciiSafeStringify(canonical);
|
|
325
463
|
if (entriesUnchanged(outPath, nextEntriesJson)) {
|
|
326
464
|
return JSON.stringify({ exported: canonical.length, path: outPath, scope, committed: false });
|
|
327
465
|
}
|
|
328
466
|
const bible = {
|
|
329
|
-
version:
|
|
467
|
+
version: BIBLE_FORMAT_VERSION,
|
|
330
468
|
provenance: {
|
|
331
|
-
commit: resolveHeadCommit(repoPath),
|
|
332
|
-
branch: resolveBranch(repoPath),
|
|
469
|
+
commit: input.baseCommit ?? resolveHeadCommit(repoPath),
|
|
470
|
+
branch: input.baseBranch ?? resolveBranch(repoPath),
|
|
333
471
|
entry_count: canonical.length,
|
|
334
472
|
},
|
|
335
473
|
entries: canonical,
|
|
@@ -1,23 +1,27 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbFeedbackSchema: 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
|
id: z.ZodString;
|
|
5
8
|
reason: z.ZodString;
|
|
6
9
|
role: z.ZodOptional<z.ZodString>;
|
|
7
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
8
10
|
}, "strip", z.ZodTypeAny, {
|
|
9
|
-
reason: string;
|
|
10
11
|
id: string;
|
|
12
|
+
reason: string;
|
|
11
13
|
role?: string | undefined;
|
|
12
|
-
|
|
13
|
-
|
|
14
|
+
repo?: unknown;
|
|
15
|
+
repo_path?: unknown;
|
|
16
|
+
repo_remote_url?: unknown;
|
|
14
17
|
}, {
|
|
15
|
-
reason: string;
|
|
16
18
|
id: string;
|
|
19
|
+
reason: string;
|
|
17
20
|
role?: string | undefined;
|
|
18
|
-
|
|
19
|
-
|
|
21
|
+
repo?: unknown;
|
|
22
|
+
repo_path?: unknown;
|
|
23
|
+
repo_remote_url?: unknown;
|
|
20
24
|
}>;
|
|
21
25
|
export type KbFeedbackInput = z.infer<typeof kbFeedbackSchema>;
|
|
22
|
-
export declare function kbFeedback(input: KbFeedbackInput): Promise<string>;
|
|
26
|
+
export declare function kbFeedback(input: KbFeedbackInput, anchor?: KbAnchor): Promise<string>;
|
|
23
27
|
//# sourceMappingURL=kb-feedback.d.ts.map
|
|
@@ -1,6 +1,8 @@
|
|
|
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, memberOwnerTag } from '../services/knowledge/kb-self.js';
|
|
4
|
+
import { KbMemberViewError } from '../services/knowledge/member-bible-view.js';
|
|
5
|
+
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
4
6
|
// D5 (T2.3) pattern, DUPLICATED here rather than imported: src/tools/kb-capture.ts
|
|
5
7
|
// is touched ONLY by T1.1 per PLAN.md's shared-file sequencing, so this tool
|
|
6
8
|
// validates its own role hint against the same Author enum instead of
|
|
@@ -13,13 +15,13 @@ function validateAuthor(role) {
|
|
|
13
15
|
return 'unknown';
|
|
14
16
|
}
|
|
15
17
|
export const kbFeedbackSchema = z.object({
|
|
16
|
-
...kbScopeFields,
|
|
17
|
-
repo_path: z.string().optional()
|
|
18
|
-
.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.'),
|
|
19
18
|
id: z.string().min(1).describe('ID of the KB entry the feedback applies to'),
|
|
20
19
|
reason: z.string().min(1).describe('What was wrong in practice -- appended to the entry content as an ASCII feedback note'),
|
|
21
20
|
role: z.string().optional()
|
|
22
21
|
.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.'),
|
|
22
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
23
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
24
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
23
25
|
});
|
|
24
26
|
// D7 (F8): downvote a KB entry that proved wrong in practice. Marks stale=1 +
|
|
25
27
|
// flagged_for_review=1 and appends an ASCII feedback note "[feedback <ISO>]
|
|
@@ -29,10 +31,16 @@ export const kbFeedbackSchema = z.object({
|
|
|
29
31
|
// resolves it in kb-review. EXCEPTION: an ACTIVE user-directive is flagged for
|
|
30
32
|
// review only (never staled) because directives outrank agent experience and
|
|
31
33
|
// the human decides -- see SqliteProvider.feedback() for the exact guard.
|
|
32
|
-
export async function kbFeedback(input) {
|
|
33
|
-
|
|
34
|
+
export async function kbFeedback(input, anchor) {
|
|
35
|
+
// A MEMBER session reads its checkout bible view, which is read-only: a
|
|
36
|
+
// typed no-op that touches no store (checked before any provider is opened).
|
|
37
|
+
if (memberOwnerTag(anchor) !== undefined) {
|
|
38
|
+
throw new KbMemberViewError('E-MEMBER-VIEW-READ-ONLY', '', `kb_feedback is not available in a member session: member KB reads come from the checkout bible, which is read-only; 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.');
|
|
39
|
+
}
|
|
40
|
+
const providers = await getSelfKbProviders(anchor);
|
|
41
|
+
const sqliteProvider = requireSqliteProject(providers.project, 'kb_feedback');
|
|
34
42
|
const author = validateAuthor(input.role);
|
|
35
|
-
const entry = await
|
|
43
|
+
const entry = await sqliteProvider.feedback(input.id, input.reason, author);
|
|
36
44
|
return JSON.stringify({
|
|
37
45
|
id: entry.id,
|
|
38
46
|
stale: entry.stale,
|