@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,76 +1,189 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { readFileSync } from 'fs';
|
|
2
2
|
import { execFileSync } from 'child_process';
|
|
3
3
|
import { join } from 'path';
|
|
4
4
|
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
|
|
5
5
|
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
|
|
6
|
+
import { ErrorCode } from '@modelcontextprotocol/sdk/types.js';
|
|
6
7
|
import { freshnessNote } from './code-intelligence-freshness.js';
|
|
7
|
-
import { maybeScheduleReindex } from './code-intelligence-reindex.js';
|
|
8
|
+
import { maybeScheduleReindex, GITNEXUS_PACKAGE_SPEC } from './code-intelligence-reindex.js';
|
|
9
|
+
import { scheduleIndexBuild } from './code-index-heal.js';
|
|
8
10
|
import { isTestPath } from './code-intelligence-tests.js';
|
|
11
|
+
import { codeIndexReadiness, ensureGitNexusIndexReady, indexChangedDuringCallError } from './code-intelligence-readiness.js';
|
|
12
|
+
import { indexGeneration, readGitNexusIndexState } from './code-index-state.js';
|
|
9
13
|
import { logError } from '../utils/log-helpers.js';
|
|
10
|
-
|
|
14
|
+
import { missingOnServerPathMessage, npxUnavailableReason } from '../utils/find-on-path.js';
|
|
15
|
+
import { gitExecutable } from '../os/git-executable.js';
|
|
16
|
+
import { redactKnownSecrets } from '../utils/redact-known-secrets.js';
|
|
17
|
+
let sharedEntry = null;
|
|
11
18
|
let connectionPromise = null;
|
|
19
|
+
// Index generation (indexGeneration: meta lastCommit|indexedAt) each repo had
|
|
20
|
+
// when a child last answered for it, kept per child (ClientEntry above). The
|
|
21
|
+
// child is long-lived and keeps its own handle on a repo's index; when an
|
|
22
|
+
// analyze replaces that index on disk, the old handle can read a half-old,
|
|
23
|
+
// half-new graph and resolve a name to an unrelated symbol. A changed
|
|
24
|
+
// generation therefore recycles the child before the next call.
|
|
12
25
|
// Structured, actionable "offline" result. Same shape as a normal MCP tool
|
|
13
26
|
// result (content array of text plus isError) so callers never receive an
|
|
14
27
|
// unhandled throw or a silent empty result -- mirrors the F3.1 error shape.
|
|
15
28
|
const OFFLINE_MESSAGE = "Code intelligence is offline: the gitnexus service could not be reached. " +
|
|
16
|
-
"Start or reinstall it by running 'npx gitnexus analyze' in the repo " +
|
|
29
|
+
"Start or reinstall it by running 'npx gitnexus analyze --index-only --force' in the repo " +
|
|
17
30
|
"(or /pm index), then retry.";
|
|
18
31
|
function offlineResult(detail) {
|
|
19
32
|
const text = detail ? `${OFFLINE_MESSAGE} (${detail})` : OFFLINE_MESSAGE;
|
|
20
33
|
return { content: [{ type: 'text', text }], isError: true };
|
|
21
34
|
}
|
|
22
|
-
//
|
|
23
|
-
//
|
|
24
|
-
//
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
35
|
+
// The child's stderr is the only record of why it failed (npx install errors,
|
|
36
|
+
// a crash on start). Reading it also keeps an unread pipe from stalling the
|
|
37
|
+
// child. Only the end is kept, and it is scrubbed before it is cut, so a cut
|
|
38
|
+
// cannot leave half a credential that the patterns no longer recognise.
|
|
39
|
+
const STDERR_KEEP_CHARS = 8000;
|
|
40
|
+
const STDERR_REPORT_CHARS = 2000;
|
|
41
|
+
function scrubChildText(text) {
|
|
42
|
+
return redactKnownSecrets(text, [])
|
|
43
|
+
.replace(/\x1b\[[0-9;]*[A-Za-z]/g, '')
|
|
44
|
+
.replace(/(_auth(?:Token)?|_password)(\s*[=:]\s*)\S+/gi, '$1$2****')
|
|
45
|
+
.replace(/(:\/\/)[^\s/@]+@/g, '$1****@')
|
|
46
|
+
.replace(/\b(?:npm_[A-Za-z0-9]{20,}|sk-ant-[A-Za-z0-9_-]+)/g, '****')
|
|
47
|
+
.replace(/[^\x20-\x7E]+/g, ' ');
|
|
48
|
+
}
|
|
49
|
+
function captureChildStderr(transport) {
|
|
50
|
+
let kept = '';
|
|
51
|
+
transport.stderr?.on('data', (chunk) => {
|
|
52
|
+
kept = (kept + String(chunk)).slice(-STDERR_KEEP_CHARS);
|
|
53
|
+
});
|
|
54
|
+
return () => scrubChildText(kept).slice(-STDERR_REPORT_CHARS);
|
|
55
|
+
}
|
|
56
|
+
/** Why the child failed: timeout or not, in which stage, how long it took, and its stderr. */
|
|
57
|
+
function childFailureDetail(err, stage, startedAt, stderr) {
|
|
58
|
+
const message = scrubChildText(err instanceof Error ? err.message : String(err));
|
|
59
|
+
const outcome = err?.code === ErrorCode.RequestTimeout ? 'TIMEOUT' : 'failed';
|
|
60
|
+
return `${outcome} during ${stage} after ${Date.now() - startedAt} ms: ${message}; child stderr: ${stderr || '(empty)'}`;
|
|
28
61
|
}
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
62
|
+
function closeEntry(entry) {
|
|
63
|
+
if (entry.closed)
|
|
64
|
+
return;
|
|
65
|
+
entry.closed = true;
|
|
66
|
+
try {
|
|
67
|
+
const closing = entry.client.close?.();
|
|
68
|
+
if (closing && typeof closing.catch === 'function')
|
|
69
|
+
closing.catch(() => { });
|
|
70
|
+
}
|
|
71
|
+
catch { /* already gone */ }
|
|
33
72
|
}
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
73
|
+
/**
|
|
74
|
+
* Retire `entry`: if it is the shared child, unshare it so the next call
|
|
75
|
+
* starts a fresh one; close it now if nothing is running on it, otherwise
|
|
76
|
+
* when its last in-flight call is released.
|
|
77
|
+
*/
|
|
78
|
+
function retireEntry(entry) {
|
|
79
|
+
if (sharedEntry === entry) {
|
|
80
|
+
sharedEntry = null;
|
|
81
|
+
connectionPromise = null;
|
|
82
|
+
}
|
|
83
|
+
entry.retired = true;
|
|
84
|
+
if (entry.inFlight === 0)
|
|
85
|
+
closeEntry(entry);
|
|
86
|
+
}
|
|
87
|
+
/** Retire the current child (if any) so the next call starts a fresh one. */
|
|
88
|
+
function recycleConnection() {
|
|
89
|
+
if (sharedEntry)
|
|
90
|
+
retireEntry(sharedEntry);
|
|
91
|
+
}
|
|
92
|
+
function releaseEntry(entry) {
|
|
93
|
+
entry.inFlight -= 1;
|
|
94
|
+
if (entry.retired && entry.inFlight === 0)
|
|
95
|
+
closeEntry(entry);
|
|
96
|
+
}
|
|
97
|
+
async function getGitNexusEntry() {
|
|
98
|
+
if (sharedEntry)
|
|
99
|
+
return sharedEntry;
|
|
37
100
|
if (connectionPromise)
|
|
38
101
|
return connectionPromise;
|
|
39
|
-
|
|
102
|
+
// Declared before the body so the body can compare it by identity (a later
|
|
103
|
+
// recycle may have replaced connectionPromise while connect was running).
|
|
104
|
+
// eslint-disable-next-line prefer-const
|
|
105
|
+
let pending = null;
|
|
106
|
+
pending = (async () => {
|
|
107
|
+
// Fail with the cause, not a bare "spawn npx ENOENT": a service-managed
|
|
108
|
+
// server only has the PATH its service definition recorded at install.
|
|
109
|
+
const npxReason = npxUnavailableReason();
|
|
110
|
+
if (npxReason)
|
|
111
|
+
throw new Error(npxReason); // failure reset below
|
|
40
112
|
const transport = new StdioClientTransport({
|
|
41
113
|
command: 'npx',
|
|
42
|
-
args: ['-y',
|
|
114
|
+
args: ['-y', GITNEXUS_PACKAGE_SPEC, 'mcp'],
|
|
43
115
|
stderr: 'pipe',
|
|
44
116
|
});
|
|
117
|
+
const stderrTail = captureChildStderr(transport);
|
|
45
118
|
const client = new Client({ name: 'apra-fleet', version: '1.0.0' }, { capabilities: {} });
|
|
119
|
+
const entry = { client, inFlight: 0, retired: false, closed: false, servedGeneration: new Map(), stderrTail };
|
|
46
120
|
// Transport death reset: if the child process dies (close) or the
|
|
47
|
-
// transport/client errors after a successful connect,
|
|
48
|
-
//
|
|
49
|
-
//
|
|
50
|
-
// newer connection.
|
|
121
|
+
// transport/client errors after a successful connect, stop handing it
|
|
122
|
+
// out so the next call reconnects. Guard on identity so a late handler
|
|
123
|
+
// for a child that was already replaced does not clobber a newer one.
|
|
51
124
|
const onDeath = () => {
|
|
52
|
-
if
|
|
53
|
-
|
|
54
|
-
|
|
125
|
+
// retireEntry unshares only if this entry is still the shared one, and
|
|
126
|
+
// closes it (idempotently) once nothing is running on it.
|
|
127
|
+
retireEntry(entry);
|
|
55
128
|
};
|
|
56
129
|
transport.onclose = onDeath;
|
|
57
130
|
transport.onerror = onDeath;
|
|
58
131
|
client.onclose = onDeath;
|
|
59
132
|
client.onerror = onDeath;
|
|
133
|
+
const connectStart = Date.now();
|
|
60
134
|
try {
|
|
61
135
|
await client.connect(transport);
|
|
62
136
|
}
|
|
63
137
|
catch (err) {
|
|
64
|
-
//
|
|
65
|
-
|
|
66
|
-
// rejected promise forever. Rethrow so the current caller sees failure.
|
|
67
|
-
connectionPromise = null;
|
|
68
|
-
throw err;
|
|
138
|
+
// No entry reaches callGitNexus on this path, so the reason travels in the error.
|
|
139
|
+
throw new Error(childFailureDetail(err, 'connect', connectStart, stderrTail()), { cause: err });
|
|
69
140
|
}
|
|
70
|
-
|
|
71
|
-
|
|
141
|
+
if (connectionPromise === pending) {
|
|
142
|
+
// A child that died while connecting is never shared; clear the
|
|
143
|
+
// resolved promise too, or every later call would get it back.
|
|
144
|
+
if (entry.retired)
|
|
145
|
+
connectionPromise = null;
|
|
146
|
+
else
|
|
147
|
+
sharedEntry = entry;
|
|
148
|
+
}
|
|
149
|
+
return entry;
|
|
72
150
|
})();
|
|
73
|
-
|
|
151
|
+
const settled = pending;
|
|
152
|
+
connectionPromise = settled;
|
|
153
|
+
// Failure reset: clear the poisoned promise (sharedEntry stays null) so the
|
|
154
|
+
// NEXT call attempts a brand-new connection instead of awaiting a rejected
|
|
155
|
+
// promise forever; the current caller still sees the rejection. Attached
|
|
156
|
+
// here, not inside the async body, because the npx check throws before the
|
|
157
|
+
// body's first await -- i.e. before connectionPromise is even assigned.
|
|
158
|
+
settled.catch(() => {
|
|
159
|
+
if (connectionPromise === settled)
|
|
160
|
+
connectionPromise = null;
|
|
161
|
+
});
|
|
162
|
+
return settled;
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
* Take a reference on a live, non-retired child. A child retired between its
|
|
166
|
+
* connect resolving and this continuation running (another call recycled it)
|
|
167
|
+
* is skipped, never used: it may already be closed. Bounded: a child that
|
|
168
|
+
* dies on every start (a crash-on-start gitnexus build) would otherwise make
|
|
169
|
+
* this re-spawn npx forever and the code_* call never return; after
|
|
170
|
+
* GITNEXUS_ACQUIRE_ATTEMPTS retired children it throws, and callGitNexus turns
|
|
171
|
+
* that into the offline result.
|
|
172
|
+
*/
|
|
173
|
+
const GITNEXUS_ACQUIRE_ATTEMPTS = 3;
|
|
174
|
+
async function acquireGitNexusEntry() {
|
|
175
|
+
let lastStderr = '';
|
|
176
|
+
for (let attempt = 1; attempt <= GITNEXUS_ACQUIRE_ATTEMPTS; attempt++) {
|
|
177
|
+
const entry = await getGitNexusEntry();
|
|
178
|
+
if (!entry.retired) {
|
|
179
|
+
entry.inFlight += 1;
|
|
180
|
+
return entry;
|
|
181
|
+
}
|
|
182
|
+
lastStderr = entry.stderrTail();
|
|
183
|
+
if (entry.inFlight === 0)
|
|
184
|
+
closeEntry(entry);
|
|
185
|
+
}
|
|
186
|
+
throw new Error(`gitnexus child exited or was retired ${GITNEXUS_ACQUIRE_ATTEMPTS} times in a row before it could serve a call (it is crashing on start or being recycled repeatedly); child stderr: ${lastStderr || '(empty)'}`);
|
|
74
187
|
}
|
|
75
188
|
// Freshness metadata (F2.2): when a call carries a `repo` param and the index
|
|
76
189
|
// exists, compare meta.json's lastCommit against the repo's current
|
|
@@ -89,8 +202,8 @@ function computeFreshnessNote(repo) {
|
|
|
89
202
|
try {
|
|
90
203
|
const metaPath = join(repo, '.gitnexus', 'meta.json');
|
|
91
204
|
const meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
|
|
92
|
-
const head = execFileSync(
|
|
93
|
-
cwd: repo, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
205
|
+
const head = execFileSync(gitExecutable(), ['rev-parse', 'HEAD'], {
|
|
206
|
+
cwd: repo, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
94
207
|
}).trim();
|
|
95
208
|
const diverged = freshnessNote(meta.lastCommit, head) !== null;
|
|
96
209
|
let reindexScheduled = false;
|
|
@@ -129,33 +242,351 @@ function appendFreshnessNote(result, note) {
|
|
|
129
242
|
// result and the shared state is reset so the next call reconnects.
|
|
130
243
|
//
|
|
131
244
|
// Pre-flight (F3.1): when the call carries a non-empty `repo` param, verify
|
|
132
|
-
// the repo
|
|
133
|
-
//
|
|
134
|
-
//
|
|
245
|
+
// the repo's index is ready (codeIndexReadiness, code-intelligence-readiness.ts
|
|
246
|
+
// -- the one readiness check) BEFORE ever touching the child process; a
|
|
247
|
+
// not-ready index throws E-CODE-INDEX-NOT-READY. A missing or interrupted
|
|
248
|
+
// (died mid-write) index first gets a background build started
|
|
249
|
+
// (ensureGitNexusIndexReady), so a dead index heals itself instead of failing
|
|
250
|
+
// every call until someone reindexes by hand. Every code_* tool call carries the calling
|
|
251
|
+
// session's resolved (self) folder as `repo` (resolveCodeSelf in
|
|
252
|
+
// code-intelligence.ts); a direct provider call without one is forwarded
|
|
253
|
+
// untouched.
|
|
254
|
+
//
|
|
255
|
+
// Consistency fence: the index generation is read before the call; a child
|
|
256
|
+
// that last answered this repo from an older generation is recycled first.
|
|
257
|
+
// AFTER the call, readiness and the generation are checked again: if an
|
|
258
|
+
// analyze started, finished, or left the metadata inconsistent while the
|
|
259
|
+
// call ran, the answer may come from a half-rewritten index and is DISCARDED
|
|
260
|
+
// with E-CODE-INDEX-NOT-READY rather than returned.
|
|
135
261
|
async function callGitNexus(name, params) {
|
|
136
262
|
const repo = params.repo;
|
|
137
263
|
const hasRepo = typeof repo === 'string' && repo.length > 0;
|
|
264
|
+
let generation = '';
|
|
138
265
|
if (hasRepo) {
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
266
|
+
ensureGitNexusIndexReady(repo);
|
|
267
|
+
generation = indexGeneration(readGitNexusIndexState(repo));
|
|
268
|
+
const seen = sharedEntry?.servedGeneration.get(repo);
|
|
269
|
+
if (seen !== undefined && seen !== generation)
|
|
270
|
+
recycleConnection();
|
|
143
271
|
}
|
|
272
|
+
let result;
|
|
273
|
+
let entry = null;
|
|
274
|
+
let callStart = 0;
|
|
144
275
|
try {
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
const note = computeFreshnessNote(repo);
|
|
149
|
-
if (note)
|
|
150
|
-
return appendFreshnessNote(result, note);
|
|
151
|
-
}
|
|
152
|
-
return result;
|
|
276
|
+
entry = await acquireGitNexusEntry();
|
|
277
|
+
callStart = Date.now();
|
|
278
|
+
result = await entry.client.callTool({ name, arguments: params });
|
|
153
279
|
}
|
|
154
280
|
catch (err) {
|
|
155
|
-
|
|
156
|
-
|
|
281
|
+
// Retire only the child THIS call ran on -- never a fresh child another
|
|
282
|
+
// call already swapped in. A failed connect has no entry: the connect
|
|
283
|
+
// path already cleared its poisoned promise.
|
|
284
|
+
if (entry)
|
|
285
|
+
retireEntry(entry);
|
|
286
|
+
let detail = entry
|
|
287
|
+
? childFailureDetail(err, `call of ${name}`, callStart, entry.stderrTail())
|
|
288
|
+
: err instanceof Error ? err.message : String(err);
|
|
289
|
+
// Only the spawn error itself means npx is missing. The detail also holds child
|
|
290
|
+
// stderr, where ENOENT next to an _npx cache path says nothing about PATH. Only
|
|
291
|
+
// a failed connect carries the spawn error, as the cause of its wrapper.
|
|
292
|
+
const cause = err instanceof Error ? err.cause : undefined;
|
|
293
|
+
if (!entry && cause instanceof Error && /\bspawn npx ENOENT\b/.test(cause.message)) {
|
|
294
|
+
detail = `${detail}: ${missingOnServerPathMessage('npx')}`;
|
|
295
|
+
}
|
|
157
296
|
return offlineResult(detail);
|
|
158
297
|
}
|
|
298
|
+
finally {
|
|
299
|
+
if (entry)
|
|
300
|
+
releaseEntry(entry);
|
|
301
|
+
}
|
|
302
|
+
if (!hasRepo)
|
|
303
|
+
return result;
|
|
304
|
+
const after = codeIndexReadiness('gitnexus', repo);
|
|
305
|
+
const generationAfter = indexGeneration(readGitNexusIndexState(repo));
|
|
306
|
+
if (!after.ready || generationAfter !== generation) {
|
|
307
|
+
// The child may hold a handle on the index that just changed.
|
|
308
|
+
retireEntry(entry);
|
|
309
|
+
throw indexChangedDuringCallError(repo, after);
|
|
310
|
+
}
|
|
311
|
+
entry.servedGeneration.set(repo, generation);
|
|
312
|
+
const note = computeFreshnessNote(repo);
|
|
313
|
+
return note ? appendFreshnessNote(result, note) : result;
|
|
314
|
+
}
|
|
315
|
+
const QUALIFIER_SEPS = ['.', '::', '#', ':', '/'];
|
|
316
|
+
/** True when `qualified` is `simple` or a qualified form ending in it. */
|
|
317
|
+
function endsWithSymbol(qualified, simple) {
|
|
318
|
+
if (qualified === '' || simple === '')
|
|
319
|
+
return false;
|
|
320
|
+
return qualified === simple || QUALIFIER_SEPS.some((sep) => qualified.endsWith(sep + simple));
|
|
321
|
+
}
|
|
322
|
+
/**
|
|
323
|
+
* Drop the disambiguation tags gitnexus appends to an id AFTER the qualified
|
|
324
|
+
* name, so the symbol segment can be compared with a plain name:
|
|
325
|
+
* '#<arity>' (every Method, Constructor and class-nested Function), followed
|
|
326
|
+
* by optional collision tags ('~type1,type2', '$const'), '~shape:<...>'
|
|
327
|
+
* parameter-shape tags, '~T1,T2' class template arguments and '~c:<hash>'
|
|
328
|
+
* constraints. Several of these contain a single ':' themselves, so they must
|
|
329
|
+
* go before the id is split. Only the last path segment is scanned for a '~'
|
|
330
|
+
* tag (a '~' in a directory name is not a tag), and a '~' right after '.' or
|
|
331
|
+
* ':' starts a C++ destructor name ('Foo.~Foo'), not a tag.
|
|
332
|
+
*
|
|
333
|
+
* The '#<arity>' tag is recognised only in the last path segment and only
|
|
334
|
+
* where it ends the id or is followed by a '~'/'$' tag, so a directory or
|
|
335
|
+
* file name holding '#<digit>' ('src/issue#12/b.ts') stays part of the path.
|
|
336
|
+
*
|
|
337
|
+
* gitnexus (1.6.x callable-id) also names a function-local callable by its
|
|
338
|
+
* declaration position, '<name>@<row>:<col>' ('outer.pick@1:2'). That ':' is
|
|
339
|
+
* not an id separator, so every such position suffix in the symbol segment
|
|
340
|
+
* is dropped too ('outer.pick'); an '@' in a directory ('src/@scope/pkg') is
|
|
341
|
+
* untouched.
|
|
342
|
+
*/
|
|
343
|
+
function stripIdTags(id) {
|
|
344
|
+
const lastSegment = id.lastIndexOf('/') + 1;
|
|
345
|
+
const arityMatch = /#\d+(?=$|[~$])/.exec(id.slice(lastSegment));
|
|
346
|
+
let head = arityMatch ? id.slice(0, lastSegment + arityMatch.index) : id;
|
|
347
|
+
for (let i = lastSegment; i < head.length; i++) {
|
|
348
|
+
if (head[i] !== '~')
|
|
349
|
+
continue;
|
|
350
|
+
const prev = i > 0 ? head[i - 1] : '';
|
|
351
|
+
if (prev === '.' || prev === ':')
|
|
352
|
+
continue;
|
|
353
|
+
head = head.slice(0, i);
|
|
354
|
+
break;
|
|
355
|
+
}
|
|
356
|
+
return head.slice(0, lastSegment) + head.slice(lastSegment).replace(/@\d+:\d+(?=$|[.#])/g, '');
|
|
357
|
+
}
|
|
358
|
+
/**
|
|
359
|
+
* Split a gitnexus id/uid ("Function:src/a.ts:Svc.run", "a.mjs:fn",
|
|
360
|
+
* "Function:src/a.rs:ns::fn") at its last SINGLE ':' (a '::' is part of the
|
|
361
|
+
* symbol) into the file part before it and the symbol segment after it.
|
|
362
|
+
* Returns null when the id has no single ':' -- nothing to cross-check.
|
|
363
|
+
*/
|
|
364
|
+
function splitSymbolId(rawId) {
|
|
365
|
+
const id = stripIdTags(rawId);
|
|
366
|
+
const singles = [];
|
|
367
|
+
for (let i = 0; i < id.length; i++) {
|
|
368
|
+
if (id[i] !== ':')
|
|
369
|
+
continue;
|
|
370
|
+
if (id[i + 1] === ':') {
|
|
371
|
+
i++;
|
|
372
|
+
continue;
|
|
373
|
+
}
|
|
374
|
+
singles.push(i);
|
|
375
|
+
}
|
|
376
|
+
if (singles.length === 0)
|
|
377
|
+
return null;
|
|
378
|
+
const last = singles[singles.length - 1];
|
|
379
|
+
const prev = singles.length > 1 ? singles[singles.length - 2] + 1 : 0;
|
|
380
|
+
return { file: id.slice(prev, last), symbol: id.slice(last + 1) };
|
|
381
|
+
}
|
|
382
|
+
function sameFile(a, b) {
|
|
383
|
+
return a === b || a.endsWith('/' + b) || b.endsWith('/' + a);
|
|
384
|
+
}
|
|
385
|
+
/**
|
|
386
|
+
* True when `resolved` is the symbol `requested` names: equal to its name,
|
|
387
|
+
* id (uid) or file path, or a qualified form ending in the name
|
|
388
|
+
* (Class.method, ns::fn, Class#method, file.ts:fn, dir/file.ts). A response
|
|
389
|
+
* that resolved nothing (no name and no id) has nothing to contradict.
|
|
390
|
+
*
|
|
391
|
+
* A matching name alone is not proof: a corrupt index can return the
|
|
392
|
+
* requested name on a node whose id names an unrelated symbol (name
|
|
393
|
+
* 'runUninstall', id 'beads-children.mjs:claimBeadsBatched'). So when an id
|
|
394
|
+
* is present its symbol segment must agree with the name (or, with no name,
|
|
395
|
+
* with the request), and a file part that looks like a path must agree with
|
|
396
|
+
* filePath; any disagreement is a mismatch even if the name matches.
|
|
397
|
+
*/
|
|
398
|
+
export function resolvesToRequested(requested, resolved) {
|
|
399
|
+
const req = requested.trim();
|
|
400
|
+
const name = resolved.name ?? '';
|
|
401
|
+
const id = resolved.id ?? '';
|
|
402
|
+
if (req === '' || (name === '' && id === ''))
|
|
403
|
+
return true;
|
|
404
|
+
const parts = id !== '' ? splitSymbolId(id) : null;
|
|
405
|
+
if (parts) {
|
|
406
|
+
// The id's own symbol must be the symbol the response names.
|
|
407
|
+
if (name !== '' && !endsWithSymbol(parts.symbol, name))
|
|
408
|
+
return false;
|
|
409
|
+
// A path-like file part must be the file the response names.
|
|
410
|
+
const filePath = resolved.filePath ?? '';
|
|
411
|
+
if (filePath !== '' && /[./]/.test(parts.file) && !sameFile(parts.file, filePath))
|
|
412
|
+
return false;
|
|
413
|
+
}
|
|
414
|
+
if (req === name || req === id || req === resolved.filePath)
|
|
415
|
+
return true;
|
|
416
|
+
if (name !== '')
|
|
417
|
+
return endsWithSymbol(req, name);
|
|
418
|
+
// No name: compare the request with the id's symbol segment.
|
|
419
|
+
return parts !== null && (endsWithSymbol(req, parts.symbol) || endsWithSymbol(parts.symbol, req));
|
|
420
|
+
}
|
|
421
|
+
function resolvedFrom(value) {
|
|
422
|
+
if (!value || typeof value !== 'object')
|
|
423
|
+
return null;
|
|
424
|
+
const v = value;
|
|
425
|
+
const str = (x) => (typeof x === 'string' && x !== '' ? x : undefined);
|
|
426
|
+
const out = { name: str(v.name), id: str(v.id) ?? str(v.uid), filePath: str(v.filePath) };
|
|
427
|
+
return out.name || out.id ? out : null;
|
|
428
|
+
}
|
|
429
|
+
/**
|
|
430
|
+
* Flag a code_impact ('impact', resolved symbol in payload.target) or
|
|
431
|
+
* code_context ('context', payload.symbol) result whose resolved symbol is not
|
|
432
|
+
* the requested one. Returns the result unchanged when it matches, is an
|
|
433
|
+
* error, or is not the JSON shape gitnexus returns.
|
|
434
|
+
*/
|
|
435
|
+
export function flagResolutionMismatch(result, requested, kind) {
|
|
436
|
+
if (typeof requested !== 'string' || isErrorResult(result))
|
|
437
|
+
return result;
|
|
438
|
+
if (!result || typeof result !== 'object' || !('content' in result))
|
|
439
|
+
return result;
|
|
440
|
+
const content = result.content;
|
|
441
|
+
if (!Array.isArray(content) || content.length === 0)
|
|
442
|
+
return result;
|
|
443
|
+
const first = content[0];
|
|
444
|
+
if (!first || typeof first.text !== 'string')
|
|
445
|
+
return result;
|
|
446
|
+
const sep = '\n\n---\n';
|
|
447
|
+
const cut = first.text.indexOf(sep);
|
|
448
|
+
const jsonPart = cut >= 0 ? first.text.slice(0, cut) : first.text;
|
|
449
|
+
const suffix = cut >= 0 ? first.text.slice(cut) : '';
|
|
450
|
+
let payload;
|
|
451
|
+
try {
|
|
452
|
+
const parsed = JSON.parse(jsonPart);
|
|
453
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
|
|
454
|
+
return result;
|
|
455
|
+
payload = parsed;
|
|
456
|
+
}
|
|
457
|
+
catch {
|
|
458
|
+
return result;
|
|
459
|
+
}
|
|
460
|
+
const resolved = resolvedFrom(kind === 'impact' ? payload.target : payload.symbol);
|
|
461
|
+
if (!resolved || resolvesToRequested(requested, resolved))
|
|
462
|
+
return result;
|
|
463
|
+
const mismatch = { requested, resolved };
|
|
464
|
+
const what = `${resolved.name ?? resolved.id}${resolved.filePath ? ` (${resolved.filePath})` : ''}` +
|
|
465
|
+
(resolved.name && resolved.id ? `, id ${resolved.id}` : '');
|
|
466
|
+
const warning = `[code-intelligence] RESOLUTION MISMATCH: '${requested}' resolved to a different symbol, ${what}. ` +
|
|
467
|
+
'This answer is about that symbol, not the one requested; confidence is LOW. ' +
|
|
468
|
+
'Check the name (or pass file_path), and run code_status -- an index rebuilt or left inconsistent can map a name to an unrelated symbol.';
|
|
469
|
+
const patched = { ...payload, resolution_mismatch: mismatch, confidence: 'LOW' };
|
|
470
|
+
if (kind === 'impact' && 'risk' in payload) {
|
|
471
|
+
patched.unverified_risk = payload.risk;
|
|
472
|
+
patched.risk = 'UNKNOWN';
|
|
473
|
+
}
|
|
474
|
+
const rest = result;
|
|
475
|
+
return {
|
|
476
|
+
...rest,
|
|
477
|
+
content: [
|
|
478
|
+
{ ...first, text: JSON.stringify(patched, null, 2) + suffix },
|
|
479
|
+
...content.slice(1),
|
|
480
|
+
{ type: 'text', text: warning },
|
|
481
|
+
],
|
|
482
|
+
resolution_mismatch: mismatch,
|
|
483
|
+
confidence: 'LOW',
|
|
484
|
+
};
|
|
485
|
+
}
|
|
486
|
+
// ---------------------------------------------------------------------------
|
|
487
|
+
// Corrupt-index check (code_impact / code_context "not found"). gitnexus
|
|
488
|
+
// 1.6.12's incremental analyze of a large repo rewrites rows of files it did
|
|
489
|
+
// not change. Reproduced with one one-line edit on a repo of 43297 nodes: the
|
|
490
|
+
// total stayed about the same, but only 34011 distinct ids were left (9287
|
|
491
|
+
// rows now duplicate another row, and an earlier run left 7774 blank ones).
|
|
492
|
+
// Every symbol whose row was overwritten answers "Target 'x' not found" /
|
|
493
|
+
// "Symbol 'x' not found" although it exists, and the index stays broken until
|
|
494
|
+
// a full rebuild. A healthy index has one row per id. Fleet-run analyzes are
|
|
495
|
+
// full rebuilds (GITNEXUS_ANALYZE_ARGS carries --force), but an index corrupted
|
|
496
|
+
// before that, or by an incremental analyze run by hand, still answers this
|
|
497
|
+
// way. So a not-found answer is cross-checked: when ids are not unique, the
|
|
498
|
+
// answer is marked as unreliable and a rebuild is asked for
|
|
499
|
+
// (scheduleIndexBuild: config-, cooldown- and single-flight-gated).
|
|
500
|
+
// ---------------------------------------------------------------------------
|
|
501
|
+
const NOT_FOUND_ERROR = /^(?:Target|Symbol) '([\s\S]*)' not found\.?$/;
|
|
502
|
+
// Every node of a healthy index has its own id ('<Label>:<path>[:<name>]').
|
|
503
|
+
// count(DISTINCT) folds duplicated and blank ids and skips null ones, so the
|
|
504
|
+
// difference covers all three.
|
|
505
|
+
export const INDEX_ID_UNIQUENESS_QUERY = 'MATCH (n) RETURN count(n) AS total, count(DISTINCT n.id) AS distinct_ids';
|
|
506
|
+
/** The name a code_impact / code_context result reports as not found, or null. */
|
|
507
|
+
export function notFoundName(result) {
|
|
508
|
+
const parts = splitPayload(result);
|
|
509
|
+
if (!parts)
|
|
510
|
+
return null;
|
|
511
|
+
const error = parts.payload.error;
|
|
512
|
+
if (typeof error !== 'string')
|
|
513
|
+
return null;
|
|
514
|
+
const m = NOT_FOUND_ERROR.exec(error.trim());
|
|
515
|
+
return m ? m[1] : null;
|
|
516
|
+
}
|
|
517
|
+
function splitPayload(result) {
|
|
518
|
+
if (isErrorResult(result) || !result || typeof result !== 'object' || !('content' in result))
|
|
519
|
+
return null;
|
|
520
|
+
const content = result.content;
|
|
521
|
+
if (!Array.isArray(content) || content.length === 0)
|
|
522
|
+
return null;
|
|
523
|
+
const first = content[0];
|
|
524
|
+
if (!first || typeof first.text !== 'string')
|
|
525
|
+
return null;
|
|
526
|
+
const sep = '\n\n---\n';
|
|
527
|
+
const cut = first.text.indexOf(sep);
|
|
528
|
+
try {
|
|
529
|
+
const parsed = JSON.parse(cut >= 0 ? first.text.slice(0, cut) : first.text);
|
|
530
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
|
|
531
|
+
return null;
|
|
532
|
+
return { payload: parsed, suffix: cut >= 0 ? first.text.slice(cut) : '', first, content };
|
|
533
|
+
}
|
|
534
|
+
catch {
|
|
535
|
+
return null;
|
|
536
|
+
}
|
|
537
|
+
}
|
|
538
|
+
/** Rows beyond one per distinct id in `repo`'s index, or null when it cannot be read. */
|
|
539
|
+
async function damagedRows(repo) {
|
|
540
|
+
let result;
|
|
541
|
+
try {
|
|
542
|
+
result = await callGitNexus('cypher', { query: INDEX_ID_UNIQUENESS_QUERY, repo });
|
|
543
|
+
}
|
|
544
|
+
catch {
|
|
545
|
+
return null;
|
|
546
|
+
}
|
|
547
|
+
const payload = extractCypherPayload(result);
|
|
548
|
+
if (!payload)
|
|
549
|
+
return null;
|
|
550
|
+
const row = parseMarkdownTable(payload.markdown)[0];
|
|
551
|
+
if (!row || row.total === undefined || row.distinct_ids === undefined)
|
|
552
|
+
return null;
|
|
553
|
+
const n = Number(row.total) - Number(row.distinct_ids);
|
|
554
|
+
return Number.isFinite(n) ? n : null;
|
|
555
|
+
}
|
|
556
|
+
/**
|
|
557
|
+
* When a code_impact / code_context answer is "not found" and `repo`'s index
|
|
558
|
+
* holds overwritten rows (ids that are not unique), return the answer marked as unreliable (payload
|
|
559
|
+
* index_integrity + confidence LOW, plus a warning naming the cause and what
|
|
560
|
+
* happens next) and ask for a rebuild. Any other result, or one whose
|
|
561
|
+
* index checks out, is returned unchanged.
|
|
562
|
+
*/
|
|
563
|
+
export async function flagCorruptIndexNotFound(result, repo) {
|
|
564
|
+
if (typeof repo !== 'string' || repo === '')
|
|
565
|
+
return result;
|
|
566
|
+
const name = notFoundName(result);
|
|
567
|
+
if (name === null)
|
|
568
|
+
return result;
|
|
569
|
+
const damaged = await damagedRows(repo);
|
|
570
|
+
if (damaged === null || damaged <= 0)
|
|
571
|
+
return result;
|
|
572
|
+
const rebuild = scheduleIndexBuild(repo);
|
|
573
|
+
const integrity = { corrupt: true, damaged_rows: damaged, rebuild };
|
|
574
|
+
const parts = splitPayload(result);
|
|
575
|
+
const next = rebuild.started
|
|
576
|
+
? 'A full rebuild of the index has started; retry once code_status reports it ready.'
|
|
577
|
+
: `No rebuild started (${rebuild.reason}${rebuild.detail ? `: ${rebuild.detail}` : ''}); run code_reindex, which always rebuilds the index in full.`;
|
|
578
|
+
const warning = `[code-intelligence] INDEX CORRUPT: '${name}' was not found, but ${damaged} rows in this code index ` +
|
|
579
|
+
'have overwritten other symbols, so this is NOT evidence that the symbol does not exist. ' +
|
|
580
|
+
`${next} Until then, use a text search for this symbol.`;
|
|
581
|
+
const patched = { ...parts.payload, index_integrity: integrity, confidence: 'LOW' };
|
|
582
|
+
return {
|
|
583
|
+
...result,
|
|
584
|
+
content: [
|
|
585
|
+
{ ...parts.first, text: JSON.stringify(patched, null, 2) + parts.suffix },
|
|
586
|
+
...parts.content.slice(1),
|
|
587
|
+
{ type: 'text', text: warning },
|
|
588
|
+
],
|
|
589
|
+
};
|
|
159
590
|
}
|
|
160
591
|
// Small, pure, exported so both T2.1 (code_map) and T2.2 (code_flow) can reuse
|
|
161
592
|
// it and it can be unit tested directly without mocking the MCP client.
|
|
@@ -401,13 +832,15 @@ export class GitNexusProvider {
|
|
|
401
832
|
});
|
|
402
833
|
}
|
|
403
834
|
async impact(params) {
|
|
404
|
-
|
|
835
|
+
const result = await callGitNexus('impact', params);
|
|
836
|
+
return flagResolutionMismatch(await flagCorruptIndexNotFound(result, params.repo), params.target, 'impact');
|
|
405
837
|
}
|
|
406
838
|
async query(params) {
|
|
407
839
|
return callGitNexus('query', params);
|
|
408
840
|
}
|
|
409
841
|
async context(params) {
|
|
410
|
-
|
|
842
|
+
const result = await callGitNexus('context', params);
|
|
843
|
+
return flagResolutionMismatch(await flagCorruptIndexNotFound(result, params.repo), params.name, 'context');
|
|
411
844
|
}
|
|
412
845
|
// T2.1: architectural map via Community nodes (rung 2 -- compose over cypher;
|
|
413
846
|
// no direct communities/map tool exists on gitnexus 1.6.7). See Decisions
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// P4a KB enrichment for code_context (T3.3, design D4). The gitnexus
|
|
2
2
|
// provider file (code-intelligence-gitnexus.ts) must NOT import the KB
|
|
3
3
|
// service -- that would create a src/tools <-> src/services cycle. This
|
|
4
|
-
// helper is imported ONLY by the code_context handler in src/
|
|
4
|
+
// helper is imported ONLY by the code_context handler in src/services/tool-registry.ts: the
|
|
5
5
|
// handler calls the provider, then this helper, then merges the two results.
|
|
6
6
|
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
7
7
|
const SUMMARY_TRUNCATE_LEN = 120;
|
|
@@ -33,11 +33,12 @@ export async function enrichContextWithKb(name, result, repoPath, remoteUrl) {
|
|
|
33
33
|
if (isErrorResult(result))
|
|
34
34
|
return result;
|
|
35
35
|
try {
|
|
36
|
-
// Enrich from the KB of the repo the code_context call is about
|
|
37
|
-
//
|
|
38
|
-
// another's symbols. remoteUrl
|
|
39
|
-
//
|
|
40
|
-
//
|
|
36
|
+
// Enrich from the KB of the repo the code_context call is about -- the
|
|
37
|
+
// calling session's resolved (self) folder; without this the server's cwd
|
|
38
|
+
// decides, and one repo's knowledge annotates another's symbols. remoteUrl
|
|
39
|
+
// (a remote member's single known origin remote) lets a remote member's
|
|
40
|
+
// call resolve the correct project KB even when repoPath is a path on
|
|
41
|
+
// another host that this process cannot stat.
|
|
41
42
|
const providers = await getKbProviders(repoPath, remoteUrl);
|
|
42
43
|
const kbResult = await providers.project.query({
|
|
43
44
|
query: name,
|