@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -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, {
|
|
12
|
+
repo?: unknown;
|
|
7
13
|
scope?: "project" | "global" | undefined;
|
|
8
|
-
repo_path?:
|
|
9
|
-
repo_remote_url?:
|
|
14
|
+
repo_path?: unknown;
|
|
15
|
+
repo_remote_url?: unknown;
|
|
16
|
+
baseBranch?: string | undefined;
|
|
17
|
+
baseCommit?: string | undefined;
|
|
10
18
|
}, {
|
|
19
|
+
repo?: unknown;
|
|
11
20
|
scope?: "project" | "global" | undefined;
|
|
12
|
-
repo_path?:
|
|
13
|
-
repo_remote_url?:
|
|
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,12 +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 { 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';
|
|
10
12
|
// T3.4 (F8b, D8): export half of the shareable, diffable team bible. Writes
|
|
11
13
|
// all CONFIRMED, non-superseded, non-stale project entries to
|
|
12
14
|
// <repo>/.fleet/kb-canonical.json. Registered as a real MCP tool (not just an
|
|
@@ -18,15 +20,11 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
|
18
20
|
// discretion: the export TOOL commits with its own dedicated identity
|
|
19
21
|
// (pm-kb), so no role's "no git operations" rule is violated by this
|
|
20
22
|
// 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.
|
|
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.
|
|
30
28
|
// T3.3 (F9a, D8): scope param -- 'project' (default, unchanged behavior) reads
|
|
31
29
|
// the PROJECT KB and writes .fleet/kb-canonical.json (as before); 'global'
|
|
32
30
|
// reads the GLOBAL KB (providers.global -- the shared kb.sqlite at
|
|
@@ -35,13 +33,109 @@ import { KB_CONFIG_PATH } from '../services/knowledge/kb-config.js';
|
|
|
35
33
|
// apra-fleet platform repo, committed there per D8). Same stable field set,
|
|
36
34
|
// same asciiSafeStringify + deterministic id-sorted output, and the same
|
|
37
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).
|
|
38
40
|
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
41
|
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
|
|
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,
|
|
44
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
|
+
}
|
|
45
139
|
/**
|
|
46
140
|
* Resolve HEAD, degrading gracefully to null rather than throwing: a repo with
|
|
47
141
|
* no commits yet, a non-repo directory, or a machine without git must still be
|
|
@@ -81,7 +175,7 @@ function gitOrNull(repoPath, args) {
|
|
|
81
175
|
return null;
|
|
82
176
|
try {
|
|
83
177
|
const out = execFileSync('git', args, {
|
|
84
|
-
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,
|
|
85
179
|
}).trim();
|
|
86
180
|
return out.length > 0 ? out : null;
|
|
87
181
|
}
|
|
@@ -100,7 +194,7 @@ function gitOrNull(repoPath, args) {
|
|
|
100
194
|
// ASCII too) and avoids template literals -- the pre-commit hook's
|
|
101
195
|
// backtick-n/t/r scan false-positives on template-literal escape sequences,
|
|
102
196
|
// the same gotcha T2.3's promote() fix worked around.
|
|
103
|
-
function asciiSafeStringify(value) {
|
|
197
|
+
export function asciiSafeStringify(value) {
|
|
104
198
|
const json = JSON.stringify(value, null, 2);
|
|
105
199
|
const maxAsciiCode = 127;
|
|
106
200
|
const escapePrefix = String.fromCharCode(92) + 'u'; // backslash + 'u', built at runtime
|
|
@@ -119,16 +213,14 @@ function asciiSafeStringify(value) {
|
|
|
119
213
|
}
|
|
120
214
|
return out;
|
|
121
215
|
}
|
|
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);
|
|
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);
|
|
130
222
|
}
|
|
131
|
-
return
|
|
223
|
+
return folder;
|
|
132
224
|
}
|
|
133
225
|
function autoCommitMode() {
|
|
134
226
|
try {
|
|
@@ -152,7 +244,7 @@ function autoCommitEnabled() {
|
|
|
152
244
|
return autoCommitMode() !== 'off';
|
|
153
245
|
}
|
|
154
246
|
// The entry count of the bible ALREADY on disk, read before we overwrite it.
|
|
155
|
-
// Accepts
|
|
247
|
+
// Accepts every shape (legacy bare array, v2/v3 envelope) like entriesUnchanged.
|
|
156
248
|
// null means "no comparable prior bible" -- absent file, or unparseable -- in
|
|
157
249
|
// which case there is no shrink to detect and the export is a first write.
|
|
158
250
|
function bibleEntryCount(outPath) {
|
|
@@ -173,7 +265,7 @@ function bibleEntryCount(outPath) {
|
|
|
173
265
|
export function _autoCommitEnabledForTest() {
|
|
174
266
|
return autoCommitEnabled();
|
|
175
267
|
}
|
|
176
|
-
function isGitRepo(repoPath) {
|
|
268
|
+
export function isGitRepo(repoPath) {
|
|
177
269
|
return fs.existsSync(path.join(repoPath, '.git'));
|
|
178
270
|
}
|
|
179
271
|
// "Content actually changed" (D5): git status --porcelain against the exact
|
|
@@ -181,9 +273,9 @@ function isGitRepo(repoPath) {
|
|
|
181
273
|
// already matches HEAD for this one path -- re-exporting an identical bible
|
|
182
274
|
// is a no-op, so there is nothing to commit. Any output (modified, or a
|
|
183
275
|
// brand-new untracked file on the very first export) means it changed.
|
|
184
|
-
function bibleContentChanged(repoPath, outPath) {
|
|
276
|
+
export function bibleContentChanged(repoPath, outPath) {
|
|
185
277
|
const status = execFileSync('git', ['status', '--porcelain', '--', outPath], {
|
|
186
|
-
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,
|
|
187
279
|
});
|
|
188
280
|
return status.trim().length > 0;
|
|
189
281
|
}
|
|
@@ -224,12 +316,9 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
|
|
|
224
316
|
try {
|
|
225
317
|
if (!bibleContentChanged(repoPath, outPath))
|
|
226
318
|
return false;
|
|
227
|
-
execFileSync('git', ['add', outPath], {
|
|
228
|
-
cwd: repoPath, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'],
|
|
229
|
-
});
|
|
230
319
|
const scopeLabel = scope === 'global' ? 'global knowledge bible' : 'knowledge bible';
|
|
231
320
|
const message = 'chore(kb): update ' + scopeLabel + ' -- ' + entryCount + ' confirmed entries';
|
|
232
|
-
|
|
321
|
+
commitBiblePath(repoPath, outPath, message);
|
|
233
322
|
return true;
|
|
234
323
|
}
|
|
235
324
|
catch (err) {
|
|
@@ -238,44 +327,117 @@ function maybeAutoCommitBible(repoPath, outPath, entryCount, scope = 'project',
|
|
|
238
327
|
return false;
|
|
239
328
|
}
|
|
240
329
|
}
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
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);
|
|
253
422
|
const scope = input.scope ?? 'project';
|
|
254
423
|
// Read from the SAME repo we are about to write the bible into. Resolving the
|
|
255
424
|
// source from process cwd while writing to repoPath is how repo A's entries
|
|
256
425
|
// used to end up serialised into repo B's committed bible.
|
|
257
|
-
const providers = await getKbProviders(repoPath,
|
|
258
|
-
const
|
|
259
|
-
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'] });
|
|
260
434
|
// Deterministic ordering by id so re-exports produce meaningful diffs.
|
|
261
435
|
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');
|
|
436
|
+
.map(e => toCanonicalEntry(e))
|
|
437
|
+
.sort(compareById);
|
|
274
438
|
if (!fs.existsSync(fleetDir)) {
|
|
275
439
|
fs.mkdirSync(fleetDir, { recursive: true });
|
|
276
440
|
}
|
|
277
|
-
const fileName = scope === 'global' ? 'kb-canonical-global.json' : 'kb-canonical.json';
|
|
278
|
-
const outPath = path.join(fleetDir, fileName);
|
|
279
441
|
// KB-TRUST PHASE 3a: the bible records the commit it was exported from, so a
|
|
280
442
|
// later audit can date its entries against the tree they were verified on.
|
|
281
443
|
// Before this, a bible harvested from other repositories was indistinguishable
|
|
@@ -296,15 +458,16 @@ export async function kbExport(input) {
|
|
|
296
458
|
// exists to avoid. When the entry set is unchanged the file is left exactly as
|
|
297
459
|
// it is, which also keeps the recorded commit honest: it names the tree those
|
|
298
460
|
// entries were last verified against, not the commit that stored them.
|
|
461
|
+
assertNoDuplicateBibleIds(canonical, 'kb_export');
|
|
299
462
|
const nextEntriesJson = asciiSafeStringify(canonical);
|
|
300
463
|
if (entriesUnchanged(outPath, nextEntriesJson)) {
|
|
301
464
|
return JSON.stringify({ exported: canonical.length, path: outPath, scope, committed: false });
|
|
302
465
|
}
|
|
303
466
|
const bible = {
|
|
304
|
-
version:
|
|
467
|
+
version: BIBLE_FORMAT_VERSION,
|
|
305
468
|
provenance: {
|
|
306
|
-
commit: resolveHeadCommit(repoPath),
|
|
307
|
-
branch: resolveBranch(repoPath),
|
|
469
|
+
commit: input.baseCommit ?? resolveHeadCommit(repoPath),
|
|
470
|
+
branch: input.baseBranch ?? resolveBranch(repoPath),
|
|
308
471
|
entry_count: canonical.length,
|
|
309
472
|
},
|
|
310
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,7 @@
|
|
|
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';
|
|
4
5
|
import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
5
6
|
// D5 (T2.3) pattern, DUPLICATED here rather than imported: src/tools/kb-capture.ts
|
|
6
7
|
// is touched ONLY by T1.1 per PLAN.md's shared-file sequencing, so this tool
|
|
@@ -14,13 +15,13 @@ function validateAuthor(role) {
|
|
|
14
15
|
return 'unknown';
|
|
15
16
|
}
|
|
16
17
|
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
18
|
id: z.string().min(1).describe('ID of the KB entry the feedback applies to'),
|
|
21
19
|
reason: z.string().min(1).describe('What was wrong in practice -- appended to the entry content as an ASCII feedback note'),
|
|
22
20
|
role: z.string().optional()
|
|
23
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,
|
|
24
25
|
});
|
|
25
26
|
// D7 (F8): downvote a KB entry that proved wrong in practice. Marks stale=1 +
|
|
26
27
|
// flagged_for_review=1 and appends an ASCII feedback note "[feedback <ISO>]
|
|
@@ -30,8 +31,13 @@ export const kbFeedbackSchema = z.object({
|
|
|
30
31
|
// resolves it in kb-review. EXCEPTION: an ACTIVE user-directive is flagged for
|
|
31
32
|
// review only (never staled) because directives outrank agent experience and
|
|
32
33
|
// the human decides -- see SqliteProvider.feedback() for the exact guard.
|
|
33
|
-
export async function kbFeedback(input) {
|
|
34
|
-
|
|
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);
|
|
35
41
|
const sqliteProvider = requireSqliteProject(providers.project, 'kb_feedback');
|
|
36
42
|
const author = validateAuthor(input.role);
|
|
37
43
|
const entry = await sqliteProvider.feedback(input.id, input.reason, author);
|
|
@@ -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
|