@apralabs/apra-fleet 0.4.0 → 0.4.2
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 +159 -13
- package/dist/agents/backlog-groomer.md +31 -19
- package/dist/agents/ci-watcher.md +16 -1
- package/dist/agents/deployer.md +37 -47
- package/dist/agents/doer.md +147 -114
- package/dist/agents/harvester.md +41 -34
- package/dist/agents/integ-test-runner.md +98 -114
- package/dist/agents/kb-reconciler.md +205 -0
- package/dist/agents/plan-reviewer.md +45 -44
- package/dist/agents/planner.md +121 -50
- package/dist/agents/regression-test-runner.md +84 -81
- package/dist/agents/reviewer.md +118 -44
- package/dist/agents/schemas/doer-output.json +63 -3
- package/dist/agents/schemas/harvester-output.json +59 -2
- package/dist/agents/schemas/integ-test-runner-output.json +3 -3
- package/dist/agents/schemas/kb-reconciler-output.json +87 -0
- package/dist/agents/schemas/planner-output.json +65 -0
- package/dist/agents/schemas/regression-test-runner-output.json +4 -17
- package/dist/agents/schemas/reviewer-output.json +105 -8
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +1 -2
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +3 -3
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +4 -13
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/install.d.ts +1 -0
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +141 -44
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.js +1 -1
- package/dist/cli/join.js.map +1 -1
- package/dist/cli/kb-commit.d.ts +12 -0
- package/dist/cli/kb-commit.d.ts.map +1 -0
- package/dist/cli/kb-commit.js +53 -0
- package/dist/cli/kb-commit.js.map +1 -0
- package/dist/cli/kb-directives.d.ts +17 -0
- package/dist/cli/kb-directives.d.ts.map +1 -0
- package/dist/cli/kb-directives.js +146 -0
- package/dist/cli/kb-directives.js.map +1 -0
- package/dist/cli/kb-import.d.ts +13 -0
- package/dist/cli/kb-import.d.ts.map +1 -0
- package/dist/cli/kb-import.js +56 -0
- package/dist/cli/kb-import.js.map +1 -0
- package/dist/cli/register-member.js +1 -1
- package/dist/cli/start.d.ts.map +1 -1
- package/dist/cli/start.js +7 -0
- package/dist/cli/start.js.map +1 -1
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +16 -3
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/watch.d.ts +76 -4
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +150 -17
- package/dist/cli/watch.js.map +1 -1
- package/dist/commands/kb-server.d.ts +8 -0
- package/dist/commands/kb-server.d.ts.map +1 -0
- package/dist/commands/kb-server.js +221 -0
- package/dist/commands/kb-server.js.map +1 -0
- package/dist/index.js +77 -2
- package/dist/index.js.map +1 -1
- package/dist/os/git-bash-candidates.d.ts +35 -0
- package/dist/os/git-bash-candidates.d.ts.map +1 -0
- package/dist/os/git-bash-candidates.js +46 -0
- package/dist/os/git-bash-candidates.js.map +1 -0
- package/dist/os/index.d.ts +13 -4
- package/dist/os/index.d.ts.map +1 -1
- package/dist/os/index.js +17 -2
- package/dist/os/index.js.map +1 -1
- package/dist/os/linux.d.ts +1 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +19 -2
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +12 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/os-commands.js.map +1 -1
- package/dist/os/windows-gitbash.d.ts +93 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -0
- package/dist/os/windows-gitbash.js +244 -0
- package/dist/os/windows-gitbash.js.map +1 -0
- package/dist/os/windows.d.ts +35 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +93 -35
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +15 -3
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +145 -11
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +14 -3
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +69 -22
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +14 -3
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +34 -8
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +14 -3
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +33 -8
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/email/headers.d.ts +15 -0
- package/dist/providers/email/headers.d.ts.map +1 -0
- package/dist/providers/email/headers.js +42 -0
- package/dist/providers/email/headers.js.map +1 -0
- package/dist/providers/email/index.d.ts +18 -0
- package/dist/providers/email/index.d.ts.map +1 -0
- package/dist/providers/email/index.js +60 -0
- package/dist/providers/email/index.js.map +1 -0
- package/dist/providers/email/provider.d.ts +49 -0
- package/dist/providers/email/provider.d.ts.map +1 -0
- package/dist/providers/email/provider.js +2 -0
- package/dist/providers/email/provider.js.map +1 -0
- package/dist/providers/email/sendgrid.d.ts +12 -0
- package/dist/providers/email/sendgrid.d.ts.map +1 -0
- package/dist/providers/email/sendgrid.js +67 -0
- package/dist/providers/email/sendgrid.js.map +1 -0
- package/dist/providers/email/smtp.d.ts +65 -0
- package/dist/providers/email/smtp.d.ts.map +1 -0
- package/dist/providers/email/smtp.js +373 -0
- package/dist/providers/email/smtp.js.map +1 -0
- package/dist/providers/index.d.ts +0 -1
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +0 -3
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +14 -3
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +26 -2
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +14 -3
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +60 -6
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +91 -5
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +45 -1
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +5 -8
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/cloud/activity.js +2 -2
- package/dist/services/cloud/activity.js.map +1 -1
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +3 -0
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/cloud/task-wrapper.d.ts +18 -0
- package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
- package/dist/services/cloud/task-wrapper.js +157 -0
- package/dist/services/cloud/task-wrapper.js.map +1 -1
- package/dist/services/context-admission.d.ts.map +1 -1
- package/dist/services/context-admission.js +9 -7
- package/dist/services/context-admission.js.map +1 -1
- package/dist/services/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +22 -3
- package/dist/services/credential-cleanup.js.map +1 -1
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +11 -2
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/knowledge/audn.d.ts +37 -0
- package/dist/services/knowledge/audn.d.ts.map +1 -0
- package/dist/services/knowledge/audn.js +219 -0
- package/dist/services/knowledge/audn.js.map +1 -0
- package/dist/services/knowledge/file-hash.d.ts +11 -0
- package/dist/services/knowledge/file-hash.d.ts.map +1 -0
- package/dist/services/knowledge/file-hash.js +123 -0
- package/dist/services/knowledge/file-hash.js.map +1 -0
- package/dist/services/knowledge/http-provider.d.ts +46 -0
- package/dist/services/knowledge/http-provider.d.ts.map +1 -0
- package/dist/services/knowledge/http-provider.js +254 -0
- package/dist/services/knowledge/http-provider.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +15 -0
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
- package/dist/services/knowledge/kb-providers.js +92 -0
- package/dist/services/knowledge/kb-providers.js.map +1 -0
- package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
- package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
- package/dist/services/knowledge/kb-scope-input.js +11 -0
- package/dist/services/knowledge/kb-scope-input.js.map +1 -0
- package/dist/services/knowledge/kb-service.d.ts +3 -0
- package/dist/services/knowledge/kb-service.d.ts.map +1 -0
- package/dist/services/knowledge/kb-service.js +2 -0
- package/dist/services/knowledge/kb-service.js.map +1 -0
- package/dist/services/knowledge/path-validation.d.ts +2 -0
- package/dist/services/knowledge/path-validation.d.ts.map +1 -0
- package/dist/services/knowledge/path-validation.js +13 -0
- package/dist/services/knowledge/path-validation.js.map +1 -0
- package/dist/services/knowledge/pre-init.d.ts +14 -0
- package/dist/services/knowledge/pre-init.d.ts.map +1 -0
- package/dist/services/knowledge/pre-init.js +147 -0
- package/dist/services/knowledge/pre-init.js.map +1 -0
- package/dist/services/knowledge/project-slug.d.ts +2 -0
- package/dist/services/knowledge/project-slug.d.ts.map +1 -0
- package/dist/services/knowledge/project-slug.js +49 -0
- package/dist/services/knowledge/project-slug.js.map +1 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
- package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
- package/dist/services/knowledge/sqlite-provider.js +1646 -0
- package/dist/services/knowledge/sqlite-provider.js.map +1 -0
- package/dist/services/knowledge/types.d.ts +163 -0
- package/dist/services/knowledge/types.d.ts.map +1 -0
- package/dist/services/knowledge/types.js +9 -0
- package/dist/services/knowledge/types.js.map +1 -0
- package/dist/services/member-home.d.ts +89 -0
- package/dist/services/member-home.d.ts.map +1 -0
- package/dist/services/member-home.js +259 -0
- package/dist/services/member-home.js.map +1 -0
- package/dist/services/member-remote-url.d.ts +34 -0
- package/dist/services/member-remote-url.d.ts.map +1 -0
- package/dist/services/member-remote-url.js +39 -0
- package/dist/services/member-remote-url.js.map +1 -0
- package/dist/services/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +0 -5
- package/dist/services/model-pricing.js.map +1 -1
- package/dist/services/orphan-recovery.d.ts +9 -3
- package/dist/services/orphan-recovery.d.ts.map +1 -1
- package/dist/services/orphan-recovery.js +22 -8
- package/dist/services/orphan-recovery.js.map +1 -1
- package/dist/services/preflight-check.d.ts +56 -0
- package/dist/services/preflight-check.d.ts.map +1 -0
- package/dist/services/preflight-check.js +277 -0
- package/dist/services/preflight-check.js.map +1 -0
- package/dist/services/shell-probe.d.ts +131 -0
- package/dist/services/shell-probe.d.ts.map +1 -0
- package/dist/services/shell-probe.js +210 -0
- package/dist/services/shell-probe.js.map +1 -0
- package/dist/services/singleton.d.ts +2 -0
- package/dist/services/singleton.d.ts.map +1 -1
- package/dist/services/singleton.js +1 -1
- package/dist/services/singleton.js.map +1 -1
- package/dist/services/ssh.js +2 -2
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/find-log-file.d.ts.map +1 -1
- package/dist/services/stall/find-log-file.js +22 -16
- package/dist/services/stall/find-log-file.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts +11 -8
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +17 -40
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +6 -5
- package/dist/services/stall/read-log-tail.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +32 -0
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +149 -6
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +34 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +160 -35
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts +9 -0
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +41 -7
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/tool-registry.d.ts.map +1 -1
- package/dist/services/tool-registry.js +87 -1
- package/dist/services/tool-registry.js.map +1 -1
- package/dist/services/user-config.js +1 -1
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/azure-devops.d.ts +1 -1
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +105 -10
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/bitbucket.d.ts.map +1 -1
- package/dist/services/vcs/bitbucket.js +16 -0
- package/dist/services/vcs/bitbucket.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +56 -1
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +123 -2
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/services/version-check.d.ts +22 -0
- package/dist/services/version-check.d.ts.map +1 -0
- package/dist/services/version-check.js +103 -0
- package/dist/services/version-check.js.map +1 -0
- package/dist/skills/fleet-sprint-cli/SKILL.md +15 -3
- package/dist/skills/pm/SKILL.md +0 -1
- package/dist/skills/pm/beads.md +6 -0
- package/dist/skills/pm/cost.md +0 -1
- package/dist/skills/pm/fleet-addendum.md +6 -1
- package/dist/skills/pm/index.md +56 -0
- package/dist/skills/pm/kb-reconcile.md +132 -0
- package/dist/skills/pm/kb-review.md +109 -0
- package/dist/tools/check-status.d.ts +47 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +245 -3
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/cloud-control.js +2 -2
- package/dist/tools/cloud-control.js.map +1 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
- package/dist/tools/code-intelligence-codebase-memory.js +270 -0
- package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
- package/dist/tools/code-intelligence-freshness.d.ts +2 -0
- package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
- package/dist/tools/code-intelligence-freshness.js +26 -0
- package/dist/tools/code-intelligence-freshness.js.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.js +475 -0
- package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.js +65 -0
- package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
- package/dist/tools/code-intelligence-reindex.d.ts +7 -0
- package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
- package/dist/tools/code-intelligence-reindex.js +106 -0
- package/dist/tools/code-intelligence-reindex.js.map +1 -0
- package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
- package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
- package/dist/tools/code-intelligence-telemetry.js +52 -0
- package/dist/tools/code-intelligence-telemetry.js.map +1 -0
- package/dist/tools/code-intelligence-tests.d.ts +2 -0
- package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
- package/dist/tools/code-intelligence-tests.js +24 -0
- package/dist/tools/code-intelligence-tests.js.map +1 -0
- package/dist/tools/code-intelligence.d.ts +114 -0
- package/dist/tools/code-intelligence.d.ts.map +1 -0
- package/dist/tools/code-intelligence.js +124 -0
- package/dist/tools/code-intelligence.js.map +1 -0
- package/dist/tools/compose-permissions.d.ts +26 -0
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +257 -33
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/execute-command.d.ts +2 -0
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +114 -28
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +13 -1
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +310 -61
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/kb-capture.d.ts +53 -0
- package/dist/tools/kb-capture.d.ts.map +1 -0
- package/dist/tools/kb-capture.js +130 -0
- package/dist/tools/kb-capture.js.map +1 -0
- package/dist/tools/kb-context.d.ts +17 -0
- package/dist/tools/kb-context.d.ts.map +1 -0
- package/dist/tools/kb-context.js +29 -0
- package/dist/tools/kb-context.js.map +1 -0
- package/dist/tools/kb-export.d.ts +19 -0
- package/dist/tools/kb-export.d.ts.map +1 -0
- package/dist/tools/kb-export.js +344 -0
- package/dist/tools/kb-export.js.map +1 -0
- package/dist/tools/kb-feedback.d.ts +23 -0
- package/dist/tools/kb-feedback.d.ts.map +1 -0
- package/dist/tools/kb-feedback.js +43 -0
- package/dist/tools/kb-feedback.js.map +1 -0
- package/dist/tools/kb-freshness-sweep.d.ts +14 -0
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
- package/dist/tools/kb-freshness-sweep.js +29 -0
- package/dist/tools/kb-freshness-sweep.js.map +1 -0
- package/dist/tools/kb-harvest.d.ts +20 -0
- package/dist/tools/kb-harvest.d.ts.map +1 -0
- package/dist/tools/kb-harvest.js +143 -0
- package/dist/tools/kb-harvest.js.map +1 -0
- package/dist/tools/kb-import.d.ts +44 -0
- package/dist/tools/kb-import.d.ts.map +1 -0
- package/dist/tools/kb-import.js +239 -0
- package/dist/tools/kb-import.js.map +1 -0
- package/dist/tools/kb-invalidate.d.ts +19 -0
- package/dist/tools/kb-invalidate.d.ts.map +1 -0
- package/dist/tools/kb-invalidate.js +34 -0
- package/dist/tools/kb-invalidate.js.map +1 -0
- package/dist/tools/kb-list.d.ts +32 -0
- package/dist/tools/kb-list.d.ts.map +1 -0
- package/dist/tools/kb-list.js +43 -0
- package/dist/tools/kb-list.js.map +1 -0
- package/dist/tools/kb-promote.d.ts +20 -0
- package/dist/tools/kb-promote.d.ts.map +1 -0
- package/dist/tools/kb-promote.js +20 -0
- package/dist/tools/kb-promote.js.map +1 -0
- package/dist/tools/kb-query.d.ts +35 -0
- package/dist/tools/kb-query.d.ts.map +1 -0
- package/dist/tools/kb-query.js +111 -0
- package/dist/tools/kb-query.js.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.js +26 -0
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
- package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
- package/dist/tools/kb-resolve-contradiction.js +37 -0
- package/dist/tools/kb-resolve-contradiction.js.map +1 -0
- package/dist/tools/kb-session-prime.d.ts +26 -0
- package/dist/tools/kb-session-prime.d.ts.map +1 -0
- package/dist/tools/kb-session-prime.js +392 -0
- package/dist/tools/kb-session-prime.js.map +1 -0
- package/dist/tools/kb-setup.d.ts +20 -0
- package/dist/tools/kb-setup.d.ts.map +1 -0
- package/dist/tools/kb-setup.js +49 -0
- package/dist/tools/kb-setup.js.map +1 -0
- package/dist/tools/kb-stats.d.ts +20 -0
- package/dist/tools/kb-stats.d.ts.map +1 -0
- package/dist/tools/kb-stats.js +115 -0
- package/dist/tools/kb-stats.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +13 -3
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts.map +1 -1
- package/dist/tools/member-reservation.js +13 -1
- package/dist/tools/member-reservation.js.map +1 -1
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +38 -5
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +15 -8
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +5 -2
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +58 -52
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +21 -12
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +70 -3
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +19 -5
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/report-status.d.ts.map +1 -1
- package/dist/tools/report-status.js +2 -1
- package/dist/tools/report-status.js.map +1 -1
- package/dist/tools/revoke-vcs-auth.js +2 -2
- package/dist/tools/revoke-vcs-auth.js.map +1 -1
- package/dist/tools/send-email.d.ts +69 -0
- package/dist/tools/send-email.d.ts.map +1 -0
- package/dist/tools/send-email.js +177 -0
- package/dist/tools/send-email.js.map +1 -0
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +4 -1
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/stop-prompt.js +2 -2
- package/dist/tools/stop-prompt.js.map +1 -1
- package/dist/tools/update-agent-cli.js +2 -2
- package/dist/tools/update-agent-cli.js.map +1 -1
- package/dist/tools/update-member.d.ts +21 -12
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +43 -2
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +12 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +36 -0
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +39 -1
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/platform.d.ts +7 -0
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/utils/platform.js +11 -1
- package/dist/utils/platform.js.map +1 -1
- package/dist/utils/prompt-errors.js +1 -1
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/session-caller.d.ts +28 -0
- package/dist/utils/session-caller.d.ts.map +1 -0
- package/dist/utils/session-caller.js +24 -0
- package/dist/utils/session-caller.js.map +1 -0
- package/dist/utils/work-folder-validation.d.ts +39 -0
- package/dist/utils/work-folder-validation.d.ts.map +1 -0
- package/dist/utils/work-folder-validation.js +60 -0
- package/dist/utils/work-folder-validation.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -1
- package/dist/utils/workspace-trust.js +5 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +550 -23
- package/package.json +7 -4
- package/packages/apra-fleet-client/src/client/api.mjs +210 -7
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +31 -19
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +16 -1
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -47
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +147 -114
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +41 -34
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +98 -114
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +205 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +45 -44
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +121 -50
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +84 -81
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +118 -44
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +63 -3
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +59 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +3 -3
- package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +105 -8
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +0 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +6 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +6 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
- package/packages/apra-fleet-se/bin/cli.mjs +139 -3
- package/packages/apra-fleet-se/bin/serve.mjs +49 -2
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +182 -38
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +258 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1487 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +1148 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +229 -112
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +91 -6
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2469 -238
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +154 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +15 -3
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +51 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +657 -12
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +60 -30
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +205 -2
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +164 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +141 -26
- package/packages/apra-fleet-se/package.json +1 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +294 -14
- package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +443 -35
- package/skills/fleet/SKILL.md +20 -9
- package/skills/fleet/auth-azdevops.md +44 -5
- package/skills/fleet/auth-bitbucket.md +3 -3
- package/skills/fleet/auth-github.md +2 -2
- package/skills/fleet/beads-conflict-resolution.md +141 -0
- package/skills/fleet/beads.md +16 -12
- package/skills/fleet/knowledge-agent.md +66 -0
- package/skills/fleet/onboarding.md +4 -4
- package/skills/fleet/permissions.md +32 -8
- package/skills/fleet/profiles/base-dev.json +10 -1
- package/skills/fleet/profiles/base-reviewer.json +8 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
- package/skills/fleet/skill-matrix.md +1 -1
- package/skills/fleet/troubleshooting.md +2 -1
- package/version.json +1 -1
- package/dist/providers/gemini.d.ts +0 -42
- package/dist/providers/gemini.d.ts.map +0 -1
- package/dist/providers/gemini.js +0 -202
- package/dist/providers/gemini.js.map +0 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -151
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +0 -127
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +0 -339
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +0 -360
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +0 -363
|
@@ -0,0 +1,392 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
5
|
+
import { validateFilePaths } from '../services/knowledge/path-validation.js';
|
|
6
|
+
import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
|
|
7
|
+
import { getProvider } from './code-intelligence.js';
|
|
8
|
+
import { FLEET_DIR } from '../paths.js';
|
|
9
|
+
export const kbSessionPrimeSchema = z.object({
|
|
10
|
+
...kbScopeFields,
|
|
11
|
+
session_files: z.array(z.string()).optional().describe('Files the agent expects to touch this session'),
|
|
12
|
+
hint_symbols: z.array(z.string()).optional().describe('Symbols likely to be relevant'),
|
|
13
|
+
hint_modules: z.array(z.string()).optional().describe('Module names likely to be relevant'),
|
|
14
|
+
// F4 (T1.6): repo path resolution precedence for the canonical-bible
|
|
15
|
+
// cold-seed below -- (1) this explicit repo_path input, validated (must
|
|
16
|
+
// exist and be a directory); (2) validated session context -- this
|
|
17
|
+
// process's own working directory, used ONLY when repo_path is omitted,
|
|
18
|
+
// put through the exact same existence + isDirectory check, never trusted
|
|
19
|
+
// blindly; (3) neither validates -- the cold-seed block is skipped
|
|
20
|
+
// silently (the existing non-fatal hard-skip contract: prime must never
|
|
21
|
+
// fail because the repo root could not be validated). There is no bare
|
|
22
|
+
// process.cwd() fallback: the fallback tier is validated the same way
|
|
23
|
+
// explicit input is.
|
|
24
|
+
repo_path: z.string().optional().describe('Repo root for the canonical-bible cold-seed (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to the validated session working directory; if neither validates, the cold-seed merge is skipped silently.'),
|
|
25
|
+
});
|
|
26
|
+
// Graph-neighbor expansion caps (T1.3 P4b, design D4). Exported for tests.
|
|
27
|
+
// NEIGHBOR_CAP: max distinct neighbor symbols carried into the extra KB query.
|
|
28
|
+
export const NEIGHBOR_CAP = 10;
|
|
29
|
+
// ADDED_ENTRY_CAP: max neighbor-derived KB entries appended to top_entries.
|
|
30
|
+
export const ADDED_ENTRY_CAP = 5;
|
|
31
|
+
// T3.5 (F8c, D8): fewer than this many top_entries after ALL merges above
|
|
32
|
+
// (direct hits + global-append + graph-neighbor) counts as a cold local KB,
|
|
33
|
+
// triggering the canonical-bible cold-seed below. Exported for tests.
|
|
34
|
+
export const COLD_KB_MAX = 3;
|
|
35
|
+
// A bible file on disk is one of TWO shapes, and the read path must accept
|
|
36
|
+
// both -- exactly as kb_import already does:
|
|
37
|
+
// - legacy: a bare JSON array of entries
|
|
38
|
+
// - v2 (what kb_export has written since KB-TRUST PHASE 3a):
|
|
39
|
+
// { version: 2, provenance: {commit, branch, entry_count}, entries: [...] }
|
|
40
|
+
// Accepting only the bare array silently killed the cold-start fallback for
|
|
41
|
+
// every bible the current exporter produces (apra-fleet's own bible holds 17
|
|
42
|
+
// CONFIRMED entries prime could not read). Anything else -- a non-array
|
|
43
|
+
// `entries`, a scalar, null -- yields [] so the caller's existing hard-skip
|
|
44
|
+
// contract still applies.
|
|
45
|
+
function bibleEntries(parsed) {
|
|
46
|
+
if (Array.isArray(parsed))
|
|
47
|
+
return parsed;
|
|
48
|
+
if (parsed && typeof parsed === 'object') {
|
|
49
|
+
const envelope = parsed.entries;
|
|
50
|
+
if (Array.isArray(envelope))
|
|
51
|
+
return envelope;
|
|
52
|
+
}
|
|
53
|
+
return [];
|
|
54
|
+
}
|
|
55
|
+
function isCanonicalBibleEntry(value) {
|
|
56
|
+
if (!value || typeof value !== 'object')
|
|
57
|
+
return false;
|
|
58
|
+
const e = value;
|
|
59
|
+
return (typeof e.id === 'string' &&
|
|
60
|
+
typeof e.type === 'string' &&
|
|
61
|
+
typeof e.title === 'string' &&
|
|
62
|
+
typeof e.summary === 'string' &&
|
|
63
|
+
Array.isArray(e.symbols) &&
|
|
64
|
+
Array.isArray(e.source_files));
|
|
65
|
+
}
|
|
66
|
+
// Prefer canonical entries whose symbols overlap hint_symbols, or whose
|
|
67
|
+
// source_files contain a hint_module as a substring (canonical entries carry
|
|
68
|
+
// no separate "module" field -- hint_modules in practice are path-like
|
|
69
|
+
// strings, e.g. "src/tools", that match against source_files directly).
|
|
70
|
+
function canonicalMatchesHints(entry, hintSymbols, hintModules) {
|
|
71
|
+
if (hintSymbols.length > 0 && entry.symbols.some(s => hintSymbols.includes(s)))
|
|
72
|
+
return true;
|
|
73
|
+
if (hintModules.length > 0 && entry.source_files.some(f => hintModules.some(m => f.includes(m))))
|
|
74
|
+
return true;
|
|
75
|
+
return false;
|
|
76
|
+
}
|
|
77
|
+
// F4 (T1.6): shared validation for both precedence tiers -- an explicit
|
|
78
|
+
// repo_path (tier 1) and the session working directory fallback (tier 2, used
|
|
79
|
+
// only when repo_path is omitted) go through the identical existence +
|
|
80
|
+
// isDirectory check. Neither tier is ever trusted without it. Returns null
|
|
81
|
+
// (rather than throwing) when nothing validates, so the caller can hard-skip
|
|
82
|
+
// per the existing non-fatal cold-seed contract.
|
|
83
|
+
function resolveRepoPath(explicit) {
|
|
84
|
+
const candidate = explicit || process.cwd();
|
|
85
|
+
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
|
|
86
|
+
return null;
|
|
87
|
+
return candidate;
|
|
88
|
+
}
|
|
89
|
+
// T3.5 (F9c, D8): `via` param added, defaulting to 'canonical-bible' so the
|
|
90
|
+
// existing project-bible call site below is byte-for-byte unchanged. The new
|
|
91
|
+
// global-bible cold-seed block passes via='canonical-bible-global' so those
|
|
92
|
+
// entries are distinguishable in top_entries (D8's via marker requirement).
|
|
93
|
+
function toCanonicalKBEntry(e, via = 'canonical-bible') {
|
|
94
|
+
return {
|
|
95
|
+
id: e.id,
|
|
96
|
+
type: e.type,
|
|
97
|
+
title: e.title,
|
|
98
|
+
summary: e.summary,
|
|
99
|
+
content: '',
|
|
100
|
+
source_files: e.source_files,
|
|
101
|
+
symbols: e.symbols,
|
|
102
|
+
tags: [],
|
|
103
|
+
content_hash: '',
|
|
104
|
+
content_hash_type: 'sha256',
|
|
105
|
+
stale: false,
|
|
106
|
+
flagged_for_review: false,
|
|
107
|
+
author: via,
|
|
108
|
+
source: 'promotion',
|
|
109
|
+
confidence: e.confidence ?? 'CONFIRMED',
|
|
110
|
+
created_at: e.updated_at ?? '',
|
|
111
|
+
use_count: 0,
|
|
112
|
+
via,
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
// Pull neighbor symbol names out of a code-intelligence `context` result.
|
|
116
|
+
// The provider returns a normal MCP result object -- a `content` array of text
|
|
117
|
+
// blocks plus an optional `isError` flag -- whose text block (when the symbol
|
|
118
|
+
// is found) is a JSON string of shape:
|
|
119
|
+
// { status, symbol, incoming: { calls: [{ name }] }, outgoing: { calls: [...] } }
|
|
120
|
+
// (see docs/code-intelligence-child-surface.md). Parse defensively: isError,
|
|
121
|
+
// missing/!array content, no text block, unparseable JSON, or an ambiguous
|
|
122
|
+
// candidate response (no incoming/outgoing) all mean "no neighbors".
|
|
123
|
+
function parseContextNeighbors(result) {
|
|
124
|
+
try {
|
|
125
|
+
if (!result || typeof result !== 'object')
|
|
126
|
+
return [];
|
|
127
|
+
const r = result;
|
|
128
|
+
if (r.isError)
|
|
129
|
+
return [];
|
|
130
|
+
if (!Array.isArray(r.content))
|
|
131
|
+
return [];
|
|
132
|
+
const textBlock = r.content.find((c) => !!c && typeof c === 'object' && c.type === 'text' &&
|
|
133
|
+
typeof c.text === 'string');
|
|
134
|
+
if (!textBlock)
|
|
135
|
+
return [];
|
|
136
|
+
const parsed = JSON.parse(textBlock.text);
|
|
137
|
+
const names = [];
|
|
138
|
+
for (const group of [parsed.incoming?.calls, parsed.outgoing?.calls]) {
|
|
139
|
+
if (!Array.isArray(group))
|
|
140
|
+
continue;
|
|
141
|
+
for (const call of group) {
|
|
142
|
+
const name = call?.name;
|
|
143
|
+
if (typeof name === 'string' && name.length > 0)
|
|
144
|
+
names.push(name);
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
return names;
|
|
148
|
+
}
|
|
149
|
+
catch {
|
|
150
|
+
return [];
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
export async function kbSessionPrime(input) {
|
|
154
|
+
if (input.session_files?.length)
|
|
155
|
+
validateFilePaths(input.session_files);
|
|
156
|
+
// Prime the KB belonging to the repo being primed, not the server's cwd.
|
|
157
|
+
//
|
|
158
|
+
// apra-fleet-b4g.4: an explicitly supplied repo_path is passed through
|
|
159
|
+
// VERBATIM, even when it does not exist on this host (a remote member's
|
|
160
|
+
// Windows work folder). Routing it through resolveRepoPath() here turned
|
|
161
|
+
// such a path into null and then, via `?? undefined`, into getKbProviders'
|
|
162
|
+
// `cwd ?? process.cwd()` -- so the provider serving that member ended up
|
|
163
|
+
// anchored at the FLEET SERVER'S OWN working directory while repo_remote_url
|
|
164
|
+
// pointed it at the real shared project KB, and prime re-hashed every
|
|
165
|
+
// candidate entry's basis against a tree that does not describe it. Keeping
|
|
166
|
+
// the caller's path means the anchor is honestly "a path this host cannot
|
|
167
|
+
// see", which SqliteProvider.anchorIsMissing() handles by declining to
|
|
168
|
+
// produce a freshness verdict at all. resolveRepoPath still guards the
|
|
169
|
+
// omitted-repo_path fallback (never a bare process.cwd()) and the cold-seed
|
|
170
|
+
// block below, which does need a readable directory.
|
|
171
|
+
const providers = await getKbProviders(input.repo_path ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
|
|
172
|
+
const result = await providers.project.prime({
|
|
173
|
+
session_files: input.session_files,
|
|
174
|
+
hint_symbols: input.hint_symbols,
|
|
175
|
+
hint_modules: input.hint_modules,
|
|
176
|
+
});
|
|
177
|
+
// Append up to 3 global knowledge entries. D4 (T2.1): pass raw terms (a raw
|
|
178
|
+
// session file path or a hint symbol) via fts_terms -- query() sanitizes
|
|
179
|
+
// each term through ftsSafeTerm and OR-joins them centrally, so FTS-hostile
|
|
180
|
+
// characters in a raw file path ('/', '.') cannot throw into the catch
|
|
181
|
+
// below, and multiple terms surface entries matching ANY of them instead of
|
|
182
|
+
// requiring ALL of them (implicit AND, KB finding 83726d75 / feedback.md
|
|
183
|
+
// finding 3).
|
|
184
|
+
const searchTerms = input.session_files?.length ? input.session_files : (input.hint_symbols ?? []);
|
|
185
|
+
if (searchTerms.length) {
|
|
186
|
+
try {
|
|
187
|
+
const globalResult = await providers.global.query({
|
|
188
|
+
fts_terms: searchTerms,
|
|
189
|
+
l1_only: true,
|
|
190
|
+
limit: 10,
|
|
191
|
+
include_stale: false,
|
|
192
|
+
});
|
|
193
|
+
const globalEntries = globalResult.results
|
|
194
|
+
.filter(e => e.type === 'knowledge')
|
|
195
|
+
.slice(0, 3);
|
|
196
|
+
if (globalEntries.length > 0) {
|
|
197
|
+
result.top_entries = [...(result.top_entries ?? []), ...globalEntries];
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
catch { }
|
|
201
|
+
}
|
|
202
|
+
// Graph-neighbor expansion (T1.3 P4b, design D4). Join the code-intelligence
|
|
203
|
+
// graph one layer up so it works for both KB providers without touching
|
|
204
|
+
// SqliteProvider.prime / HttpKbProvider.prime. For each hint symbol, ask the
|
|
205
|
+
// CI provider for its neighbors (callers/callees via `context`), run ONE extra
|
|
206
|
+
// KB query batch over the collected neighbors, and append the resulting
|
|
207
|
+
// entries BELOW all direct hits. The ENTIRE block is a hard-skip: any failure
|
|
208
|
+
// (graph offline, no index, unparseable response, KB query error) leaves
|
|
209
|
+
// `result` exactly as prime returned it -- no throw, no error text. Also
|
|
210
|
+
// skipped when hint_symbols is empty/absent.
|
|
211
|
+
if (input.hint_symbols?.length) {
|
|
212
|
+
try {
|
|
213
|
+
const provider = await getProvider();
|
|
214
|
+
// Collect distinct neighbor names not already in hint_symbols, capped at
|
|
215
|
+
// NEIGHBOR_CAP. A per-symbol try/catch keeps one bad symbol from aborting
|
|
216
|
+
// the sweep.
|
|
217
|
+
const seen = new Set(input.hint_symbols);
|
|
218
|
+
const neighbors = [];
|
|
219
|
+
for (const symbol of input.hint_symbols) {
|
|
220
|
+
if (neighbors.length >= NEIGHBOR_CAP)
|
|
221
|
+
break;
|
|
222
|
+
let ctxResult;
|
|
223
|
+
try {
|
|
224
|
+
ctxResult = await provider.context({ name: symbol });
|
|
225
|
+
}
|
|
226
|
+
catch {
|
|
227
|
+
continue;
|
|
228
|
+
}
|
|
229
|
+
for (const name of parseContextNeighbors(ctxResult)) {
|
|
230
|
+
if (neighbors.length >= NEIGHBOR_CAP)
|
|
231
|
+
break;
|
|
232
|
+
if (seen.has(name))
|
|
233
|
+
continue;
|
|
234
|
+
seen.add(name);
|
|
235
|
+
neighbors.push(name);
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
if (neighbors.length > 0) {
|
|
239
|
+
// D4 (T2.1): pass raw neighbor names via fts_terms -- query()
|
|
240
|
+
// sanitizes per-neighbor (a single FTS-hostile name degrades to
|
|
241
|
+
// skipping that neighbor rather than killing the whole batch query)
|
|
242
|
+
// AND OR-joins across neighbors so an entry matching ANY neighbor
|
|
243
|
+
// surfaces instead of requiring ALL of them (implicit AND).
|
|
244
|
+
const neighborResult = await providers.project.query({
|
|
245
|
+
fts_terms: neighbors,
|
|
246
|
+
l1_only: true,
|
|
247
|
+
limit: 10,
|
|
248
|
+
include_stale: false,
|
|
249
|
+
});
|
|
250
|
+
// Merge below direct hits: skip ids already present (direct + global),
|
|
251
|
+
// mark each addition via "graph-neighbor", cap at ADDED_ENTRY_CAP.
|
|
252
|
+
const existingIds = new Set((result.top_entries ?? []).map(e => e.id));
|
|
253
|
+
const additions = [];
|
|
254
|
+
for (const entry of neighborResult.results) {
|
|
255
|
+
if (additions.length >= ADDED_ENTRY_CAP)
|
|
256
|
+
break;
|
|
257
|
+
if (existingIds.has(entry.id))
|
|
258
|
+
continue;
|
|
259
|
+
existingIds.add(entry.id);
|
|
260
|
+
additions.push({ ...entry, via: 'graph-neighbor' });
|
|
261
|
+
}
|
|
262
|
+
if (additions.length > 0) {
|
|
263
|
+
result.top_entries = [...(result.top_entries ?? []), ...additions];
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
catch {
|
|
268
|
+
// Hard skip: leave `result` exactly as prime returned it.
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
// T3.5 (F8c, D8): cold-KB seed from the canonical git bible -- LAST
|
|
272
|
+
// sequenced merge, after direct hits + global-append + graph-neighbor
|
|
273
|
+
// above. When the local KB still returns few top_entries (COLD_KB_MAX),
|
|
274
|
+
// fall back to <repo>/.fleet/kb-canonical.json (written by kb_export after
|
|
275
|
+
// promotion) so a fresh clone or cold project still gets team knowledge.
|
|
276
|
+
// Entries are marked via:'canonical-bible' and always appended BELOW every
|
|
277
|
+
// live-KB hit gathered above. Non-fatal: the entire block is a hard skip --
|
|
278
|
+
// missing file, unreadable/malformed JSON, or a bad shape leaves `result`
|
|
279
|
+
// exactly as built above (same contract as the neighbor block).
|
|
280
|
+
if ((result.top_entries ?? []).length < COLD_KB_MAX) {
|
|
281
|
+
try {
|
|
282
|
+
const repoRoot = resolveRepoPath(input.repo_path);
|
|
283
|
+
const canonicalPath = repoRoot ? path.join(repoRoot, '.fleet', 'kb-canonical.json') : null;
|
|
284
|
+
if (canonicalPath && fs.existsSync(canonicalPath)) {
|
|
285
|
+
const raw = fs.readFileSync(canonicalPath, 'utf-8');
|
|
286
|
+
const entries = bibleEntries(JSON.parse(raw));
|
|
287
|
+
if (entries.length > 0) {
|
|
288
|
+
const existingIds = new Set((result.top_entries ?? []).map(e => e.id));
|
|
289
|
+
const hintSymbols = input.hint_symbols ?? [];
|
|
290
|
+
const hintModules = input.hint_modules ?? [];
|
|
291
|
+
const valid = entries
|
|
292
|
+
.filter(isCanonicalBibleEntry)
|
|
293
|
+
.filter(e => !existingIds.has(e.id));
|
|
294
|
+
let ordered = valid;
|
|
295
|
+
if (hintSymbols.length > 0 || hintModules.length > 0) {
|
|
296
|
+
const matched = valid.filter(e => canonicalMatchesHints(e, hintSymbols, hintModules));
|
|
297
|
+
const matchedIds = new Set(matched.map(e => e.id));
|
|
298
|
+
const rest = valid.filter(e => !matchedIds.has(e.id));
|
|
299
|
+
ordered = [...matched, ...rest];
|
|
300
|
+
}
|
|
301
|
+
const additions = [];
|
|
302
|
+
for (const e of ordered) {
|
|
303
|
+
if (additions.length >= ADDED_ENTRY_CAP)
|
|
304
|
+
break;
|
|
305
|
+
additions.push(toCanonicalKBEntry(e));
|
|
306
|
+
}
|
|
307
|
+
if (additions.length > 0) {
|
|
308
|
+
result.top_entries = [...(result.top_entries ?? []), ...additions];
|
|
309
|
+
// Delivery is retrieval. Live hits above were bumped by query()
|
|
310
|
+
// inside prime(); a bible entry never passes through query(), so
|
|
311
|
+
// without this it reaches an agent while staying invisible to
|
|
312
|
+
// use_count / last_accessed / kb_stats.retrieval -- which is
|
|
313
|
+
// exactly why hit_rate read 0 across six sprints. Awaited but
|
|
314
|
+
// isolated: telemetry must never cost us the priming result.
|
|
315
|
+
try {
|
|
316
|
+
await providers.project.touch(additions.map(e => e.id));
|
|
317
|
+
}
|
|
318
|
+
catch { }
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
}
|
|
323
|
+
catch {
|
|
324
|
+
// Hard skip: leave `result` exactly as built above.
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
// T3.5 (F9c, D8): global-bible cold-seed -- APPENDED AFTER the existing
|
|
328
|
+
// project-bible cold-seed block above (design Phasing note: F9 appends
|
|
329
|
+
// after the existing cold-seed block; this is deliberately the LAST merge
|
|
330
|
+
// in the whole function). Reads the INSTALLED global bible at
|
|
331
|
+
// FLEET_DIR/knowledge/global/kb-canonical-global.json -- the homedir-based
|
|
332
|
+
// machine-wide copy the T3.4 installer step places there (NOT anything
|
|
333
|
+
// under the session's repo root, unlike the project bible above). Entries
|
|
334
|
+
// are marked via:'canonical-bible-global' and ordered BELOW every
|
|
335
|
+
// project-bible entry (this block only ever appends, after the project
|
|
336
|
+
// block has already run). Re-checks the SAME shared COLD_KB_MAX threshold
|
|
337
|
+
// against top_entries as built by every merge above (direct hits + global-
|
|
338
|
+
// KB append + graph-neighbor + project-bible), so this runs only when the
|
|
339
|
+
// session is still cold after all of that. Same dedupe-by-id, same
|
|
340
|
+
// ADDED_ENTRY_CAP, and the identical hard-skip non-fatal contract as the
|
|
341
|
+
// project-bible block: missing file, unreadable/malformed JSON, or a bad
|
|
342
|
+
// shape leaves `result` exactly as built above -- warm sessions (>=
|
|
343
|
+
// COLD_KB_MAX) never reach this block at all.
|
|
344
|
+
if ((result.top_entries ?? []).length < COLD_KB_MAX) {
|
|
345
|
+
try {
|
|
346
|
+
const globalBiblePath = path.join(FLEET_DIR, 'knowledge', 'global', 'kb-canonical-global.json');
|
|
347
|
+
if (fs.existsSync(globalBiblePath)) {
|
|
348
|
+
const raw = fs.readFileSync(globalBiblePath, 'utf-8');
|
|
349
|
+
const entries = bibleEntries(JSON.parse(raw));
|
|
350
|
+
if (entries.length > 0) {
|
|
351
|
+
const existingIds = new Set((result.top_entries ?? []).map(e => e.id));
|
|
352
|
+
const hintSymbols = input.hint_symbols ?? [];
|
|
353
|
+
const hintModules = input.hint_modules ?? [];
|
|
354
|
+
const valid = entries
|
|
355
|
+
.filter(isCanonicalBibleEntry)
|
|
356
|
+
.filter(e => !existingIds.has(e.id));
|
|
357
|
+
let ordered = valid;
|
|
358
|
+
if (hintSymbols.length > 0 || hintModules.length > 0) {
|
|
359
|
+
const matched = valid.filter(e => canonicalMatchesHints(e, hintSymbols, hintModules));
|
|
360
|
+
const matchedIds = new Set(matched.map(e => e.id));
|
|
361
|
+
const rest = valid.filter(e => !matchedIds.has(e.id));
|
|
362
|
+
ordered = [...matched, ...rest];
|
|
363
|
+
}
|
|
364
|
+
const additions = [];
|
|
365
|
+
for (const e of ordered) {
|
|
366
|
+
if (additions.length >= ADDED_ENTRY_CAP)
|
|
367
|
+
break;
|
|
368
|
+
additions.push(toCanonicalKBEntry(e, 'canonical-bible-global'));
|
|
369
|
+
}
|
|
370
|
+
if (additions.length > 0) {
|
|
371
|
+
result.top_entries = [...(result.top_entries ?? []), ...additions];
|
|
372
|
+
// Delivery is retrieval. Live hits above were bumped by query()
|
|
373
|
+
// inside prime(); a bible entry never passes through query(), so
|
|
374
|
+
// without this it reaches an agent while staying invisible to
|
|
375
|
+
// use_count / last_accessed / kb_stats.retrieval -- which is
|
|
376
|
+
// exactly why hit_rate read 0 across six sprints. Awaited but
|
|
377
|
+
// isolated: telemetry must never cost us the priming result.
|
|
378
|
+
try {
|
|
379
|
+
await providers.project.touch(additions.map(e => e.id));
|
|
380
|
+
}
|
|
381
|
+
catch { }
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
catch {
|
|
387
|
+
// Hard skip: leave `result` exactly as built above.
|
|
388
|
+
}
|
|
389
|
+
}
|
|
390
|
+
return JSON.stringify(result);
|
|
391
|
+
}
|
|
392
|
+
//# sourceMappingURL=kb-session-prime.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kb-session-prime.js","sourceRoot":"","sources":["../../src/tools/kb-session-prime.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const kbSetupSchema: z.ZodObject<{
|
|
3
|
+
repo_path: z.ZodOptional<z.ZodString>;
|
|
4
|
+
provider: z.ZodOptional<z.ZodEnum<["sqlite", "http"]>>;
|
|
5
|
+
remote: z.ZodOptional<z.ZodString>;
|
|
6
|
+
token: z.ZodOptional<z.ZodString>;
|
|
7
|
+
}, "strip", z.ZodTypeAny, {
|
|
8
|
+
remote?: string | undefined;
|
|
9
|
+
provider?: "http" | "sqlite" | undefined;
|
|
10
|
+
token?: string | undefined;
|
|
11
|
+
repo_path?: string | undefined;
|
|
12
|
+
}, {
|
|
13
|
+
remote?: string | undefined;
|
|
14
|
+
provider?: "http" | "sqlite" | undefined;
|
|
15
|
+
token?: string | undefined;
|
|
16
|
+
repo_path?: string | undefined;
|
|
17
|
+
}>;
|
|
18
|
+
export type KbSetupInput = z.infer<typeof kbSetupSchema>;
|
|
19
|
+
export declare function kbSetup(input: KbSetupInput): Promise<string>;
|
|
20
|
+
//# sourceMappingURL=kb-setup.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kb-setup.d.ts","sourceRoot":"","sources":["../../src/tools/kb-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EASxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAKzD,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClE"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { FLEET_DIR } from '../paths.js';
|
|
5
|
+
import { installKbPostCommitHook } from './kb-invalidate.js';
|
|
6
|
+
import { encryptPassword } from '../utils/crypto.js';
|
|
7
|
+
export const kbSetupSchema = z.object({
|
|
8
|
+
repo_path: z.string().optional()
|
|
9
|
+
.describe('Path to git repository for post-commit hook installation (default: current directory)'),
|
|
10
|
+
provider: z.enum(['sqlite', 'http']).optional()
|
|
11
|
+
.describe('KB provider type (default: sqlite)'),
|
|
12
|
+
remote: z.string().optional()
|
|
13
|
+
.describe('Remote KB server URL (required when provider=http)'),
|
|
14
|
+
token: z.string().optional()
|
|
15
|
+
.describe('Authentication token for remote KB server (stored encrypted, never logged)'),
|
|
16
|
+
});
|
|
17
|
+
const KB_CONFIG_DIR = path.join(FLEET_DIR, 'knowledge');
|
|
18
|
+
const KB_CONFIG_PATH = path.join(KB_CONFIG_DIR, 'config.json');
|
|
19
|
+
export async function kbSetup(input) {
|
|
20
|
+
const steps = [];
|
|
21
|
+
// Install git post-commit hook
|
|
22
|
+
const repoPath = input.repo_path || process.cwd();
|
|
23
|
+
const gitDir = path.join(repoPath, '.git');
|
|
24
|
+
if (fs.existsSync(gitDir)) {
|
|
25
|
+
installKbPostCommitHook(repoPath);
|
|
26
|
+
steps.push('Installed git post-commit hook for KB invalidation');
|
|
27
|
+
}
|
|
28
|
+
else {
|
|
29
|
+
steps.push('Skipped git hook: no .git directory found at ' + repoPath);
|
|
30
|
+
}
|
|
31
|
+
// Write provider config
|
|
32
|
+
if (!fs.existsSync(KB_CONFIG_DIR)) {
|
|
33
|
+
fs.mkdirSync(KB_CONFIG_DIR, { recursive: true });
|
|
34
|
+
}
|
|
35
|
+
const config = {
|
|
36
|
+
provider: input.provider || (input.remote ? 'http' : 'sqlite'),
|
|
37
|
+
};
|
|
38
|
+
if (input.remote) {
|
|
39
|
+
config.url = input.remote;
|
|
40
|
+
}
|
|
41
|
+
if (input.token) {
|
|
42
|
+
config.token_encrypted = encryptPassword(input.token);
|
|
43
|
+
steps.push('Stored remote token encrypted (AES-256-GCM)');
|
|
44
|
+
}
|
|
45
|
+
fs.writeFileSync(KB_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
|
|
46
|
+
steps.push('Wrote KB config to ' + KB_CONFIG_PATH);
|
|
47
|
+
return JSON.stringify({ success: true, steps });
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=kb-setup.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kb-setup.js","sourceRoot":"","sources":["../../src/tools/kb-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,QAAQ,CAAC,uFAAuF,CAAC;IACpG,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC5C,QAAQ,CAAC,oCAAoC,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,QAAQ,CAAC,oDAAoD,CAAC;IACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAC,CAAC;AAIH,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAmB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+CAA+C,GAAG,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAA2B;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;KAC/D,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,cAAc,CAAC,CAAC;IAEnD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const kbStatsSchema: z.ZodObject<{
|
|
3
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodString>;
|
|
5
|
+
symbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
7
|
+
}, "strip", z.ZodTypeAny, {
|
|
8
|
+
symbols?: string[] | undefined;
|
|
9
|
+
repo_path?: string | undefined;
|
|
10
|
+
repo_remote_url?: string | undefined;
|
|
11
|
+
repo?: string | undefined;
|
|
12
|
+
}, {
|
|
13
|
+
symbols?: string[] | undefined;
|
|
14
|
+
repo_path?: string | undefined;
|
|
15
|
+
repo_remote_url?: string | undefined;
|
|
16
|
+
repo?: string | undefined;
|
|
17
|
+
}>;
|
|
18
|
+
export type KbStatsInput = z.infer<typeof kbStatsSchema>;
|
|
19
|
+
export declare function kbStats(input: KbStatsInput): Promise<string>;
|
|
20
|
+
//# sourceMappingURL=kb-stats.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kb-stats.d.ts","sourceRoot":"","sources":["../../src/tools/kb-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAexB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAezD,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlE"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
5
|
+
import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
|
|
6
|
+
// T2.1 (F5, D4): kb_stats -- a read-only aggregation tool, following the
|
|
7
|
+
// kb_list no-bump pattern (SqliteProvider.stats() never touches use_count/
|
|
8
|
+
// last_accessed). Reports the KB's health: confidence/type totals,
|
|
9
|
+
// stale/flagged/superseded counts, retrieval hit_rate, promote_ratio, canon-
|
|
10
|
+
// ical-bible drift (D5), and optional per-symbol coverage.
|
|
11
|
+
//
|
|
12
|
+
// D5 constraint (stated here per the tool description, verbatim intent):
|
|
13
|
+
// bible drift is VISIBILITY for the machine that owns the KB -- CI cannot see
|
|
14
|
+
// the local kb.sqlite, so no CI gate reads this tool or its drift number.
|
|
15
|
+
export const kbStatsSchema = z.object({
|
|
16
|
+
...kbScopeFields,
|
|
17
|
+
repo: z.string().optional()
|
|
18
|
+
.describe('Path to the repo root for the canonical-bible drift check (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to repo_path, then to the validated session working directory (same validation as kb_export/kb_session_prime); if none validates, bible.present is reported false and drift equals the full live-CONFIRMED count -- kb_stats never fails because of this.'),
|
|
19
|
+
// apra-fleet-src: every other kb_* tool (kb_list, kb_capture, kb_promote,
|
|
20
|
+
// kb_session_prime, kb_export) names this input `repo_path`. kb_stats alone
|
|
21
|
+
// took `repo`, and zod strips unknown keys silently -- so calling it the way
|
|
22
|
+
// every sibling is called did not error, it fell back to the SERVER's cwd and
|
|
23
|
+
// reported a fully-zeroed KB for a populated repo. A confidently wrong "there
|
|
24
|
+
// is nothing here" is worse than a failure, because kb_stats is exactly the
|
|
25
|
+
// tool an operator reaches for to ask whether the KB is working.
|
|
26
|
+
repo_path: z.string().optional()
|
|
27
|
+
.describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
|
|
28
|
+
symbols: z.array(z.string()).optional()
|
|
29
|
+
.describe('Symbols to check coverage for: per-symbol boolean (a live CONFIRMED entry whose symbols array contains it, exact match) plus the overall fraction.'),
|
|
30
|
+
});
|
|
31
|
+
// F4 (T1.6) precedence pattern, reused here: explicit input > validated
|
|
32
|
+
// process.cwd() > null (non-fatal -- kb_stats never throws over a bad repo
|
|
33
|
+
// path, it just reports bible.present = false).
|
|
34
|
+
function resolveRepoPath(explicit) {
|
|
35
|
+
const candidate = explicit || process.cwd();
|
|
36
|
+
if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
|
|
37
|
+
return null;
|
|
38
|
+
return candidate;
|
|
39
|
+
}
|
|
40
|
+
export async function kbStats(input) {
|
|
41
|
+
// `repo` wins over the `repo_path` alias so existing callers are unaffected.
|
|
42
|
+
const requestedRepo = input.repo ?? input.repo_path;
|
|
43
|
+
// Stats must describe the repo asked about, not the server's cwd.
|
|
44
|
+
//
|
|
45
|
+
// apra-fleet-b4g.7: an explicitly supplied repo path is passed through
|
|
46
|
+
// VERBATIM, exactly as kb_session_prime does (see the note at
|
|
47
|
+
// kb-session-prime.ts:186). Routing it through resolveRepoPath() here turned
|
|
48
|
+
// a remote member's unreachable work folder into null and then, via
|
|
49
|
+
// `?? undefined`, into getKbProviders' `cwd ?? process.cwd()` -- so the slug
|
|
50
|
+
// came from repo_remote_url (the REAL shared project KB) while the anchor
|
|
51
|
+
// became the fleet server's own working directory, and every basis hash was
|
|
52
|
+
// computed against a tree that does not describe those entries. Keeping the
|
|
53
|
+
// caller's path means the anchor is honestly "a path this host cannot see",
|
|
54
|
+
// which SqliteProvider.anchorIsMissing() handles by declining to produce a
|
|
55
|
+
// freshness verdict at all. resolveRepoPath still guards the omitted-path
|
|
56
|
+
// fallback and the bible-drift read below, which does need a readable dir.
|
|
57
|
+
const providers = await getKbProviders(requestedRepo ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
|
|
58
|
+
const providerStats = await providers.project.stats({ symbols: input.symbols });
|
|
59
|
+
// D5: bible.drift = count of live CONFIRMED entries whose updated_at
|
|
60
|
+
// (promoted_at || created_at, matching kb_export's own field) is newer than
|
|
61
|
+
// the bible's newest updated_at. Absent/unreadable/malformed file -> drift =
|
|
62
|
+
// ALL live CONFIRMED entries, present = false. list({confidence:'CONFIRMED'})
|
|
63
|
+
// already returns exactly the "live CONFIRMED" set (superseded_at IS NULL
|
|
64
|
+
// AND stale = 0 are list()'s hardcoded defaults) without bumping use_count.
|
|
65
|
+
let bible = { present: false, entries: 0, drift: 0 };
|
|
66
|
+
try {
|
|
67
|
+
const liveConfirmed = await providers.project.list({ confidence: 'CONFIRMED' });
|
|
68
|
+
const liveUpdatedAts = liveConfirmed.map(e => e.promoted_at || e.created_at);
|
|
69
|
+
// Degraded-safe fallback shared by every "can't use the bible file" path
|
|
70
|
+
// below (absent, unreadable, malformed JSON, non-array shape): drift
|
|
71
|
+
// equals ALL live CONFIRMED entries per D5, never silently lost to 0.
|
|
72
|
+
bible = { present: false, entries: 0, drift: liveConfirmed.length };
|
|
73
|
+
const repoPath = resolveRepoPath(requestedRepo);
|
|
74
|
+
const biblePath = repoPath ? path.join(repoPath, '.fleet', 'kb-canonical.json') : null;
|
|
75
|
+
if (biblePath && fs.existsSync(biblePath)) {
|
|
76
|
+
try {
|
|
77
|
+
const raw = fs.readFileSync(biblePath, 'utf-8');
|
|
78
|
+
const parsed = JSON.parse(raw);
|
|
79
|
+
// KB-TRUST PHASE 3a: the bible has two shapes -- a legacy bare array and
|
|
80
|
+
// the v2 { version, provenance, entries } envelope. Handle BOTH: reading
|
|
81
|
+
// only the array shape would silently report present:false and a drift
|
|
82
|
+
// of every live CONFIRMED entry against a perfectly good v2 bible, and
|
|
83
|
+
// this block degrades quietly by design, so that would never be noticed.
|
|
84
|
+
const entries = Array.isArray(parsed)
|
|
85
|
+
? parsed
|
|
86
|
+
: (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
|
|
87
|
+
? parsed.entries
|
|
88
|
+
: null;
|
|
89
|
+
if (entries !== null) {
|
|
90
|
+
let newest = null;
|
|
91
|
+
for (const entry of entries) {
|
|
92
|
+
const updatedAt = entry?.updated_at;
|
|
93
|
+
if (typeof updatedAt === 'string' && (!newest || updatedAt > newest))
|
|
94
|
+
newest = updatedAt;
|
|
95
|
+
}
|
|
96
|
+
const drift = newest === null
|
|
97
|
+
? liveConfirmed.length
|
|
98
|
+
: liveUpdatedAts.filter(u => u > newest).length;
|
|
99
|
+
bible = { present: true, entries: entries.length, drift };
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
catch {
|
|
103
|
+
// Malformed/unreadable bible file: leave the absent-shape fallback
|
|
104
|
+
// (drift = all live CONFIRMED) set above.
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
catch {
|
|
109
|
+
// Degraded-safe: kb_stats never throws over the bible file. Falls back to
|
|
110
|
+
// the "absent, drift 0" shape initialized above (only reachable if the
|
|
111
|
+
// list({confidence:'CONFIRMED'}) read itself failed).
|
|
112
|
+
}
|
|
113
|
+
return JSON.stringify({ ...providerStats, bible });
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=kb-stats.js.map
|