@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,76 +1,148 @@
|
|
|
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
6
|
import { freshnessNote } from './code-intelligence-freshness.js';
|
|
7
|
-
import { maybeScheduleReindex } from './code-intelligence-reindex.js';
|
|
7
|
+
import { maybeScheduleReindex, GITNEXUS_PACKAGE_SPEC } from './code-intelligence-reindex.js';
|
|
8
8
|
import { isTestPath } from './code-intelligence-tests.js';
|
|
9
|
+
import { codeIndexReadiness, ensureGitNexusIndexReady, indexChangedDuringCallError } from './code-intelligence-readiness.js';
|
|
10
|
+
import { indexGeneration, readGitNexusIndexState } from './code-index-state.js';
|
|
9
11
|
import { logError } from '../utils/log-helpers.js';
|
|
10
|
-
|
|
12
|
+
import { missingOnServerPathMessage, npxUnavailableReason } from '../utils/find-on-path.js';
|
|
13
|
+
let sharedEntry = null;
|
|
11
14
|
let connectionPromise = null;
|
|
15
|
+
// Index generation (indexGeneration: meta lastCommit|indexedAt) each repo had
|
|
16
|
+
// when a child last answered for it, kept per child (ClientEntry above). The
|
|
17
|
+
// child is long-lived and keeps its own handle on a repo's index; when an
|
|
18
|
+
// analyze replaces that index on disk, the old handle can read a half-old,
|
|
19
|
+
// half-new graph and resolve a name to an unrelated symbol. A changed
|
|
20
|
+
// generation therefore recycles the child before the next call.
|
|
12
21
|
// Structured, actionable "offline" result. Same shape as a normal MCP tool
|
|
13
22
|
// result (content array of text plus isError) so callers never receive an
|
|
14
23
|
// unhandled throw or a silent empty result -- mirrors the F3.1 error shape.
|
|
15
24
|
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 " +
|
|
25
|
+
"Start or reinstall it by running 'npx gitnexus analyze --index-only' in the repo " +
|
|
17
26
|
"(or /pm index), then retry.";
|
|
18
27
|
function offlineResult(detail) {
|
|
19
28
|
const text = detail ? `${OFFLINE_MESSAGE} (${detail})` : OFFLINE_MESSAGE;
|
|
20
29
|
return { content: [{ type: 'text', text }], isError: true };
|
|
21
30
|
}
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
31
|
+
function closeEntry(entry) {
|
|
32
|
+
if (entry.closed)
|
|
33
|
+
return;
|
|
34
|
+
entry.closed = true;
|
|
35
|
+
try {
|
|
36
|
+
const closing = entry.client.close?.();
|
|
37
|
+
if (closing && typeof closing.catch === 'function')
|
|
38
|
+
closing.catch(() => { });
|
|
39
|
+
}
|
|
40
|
+
catch { /* already gone */ }
|
|
28
41
|
}
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
42
|
+
/**
|
|
43
|
+
* Retire `entry`: if it is the shared child, unshare it so the next call
|
|
44
|
+
* starts a fresh one; close it now if nothing is running on it, otherwise
|
|
45
|
+
* when its last in-flight call is released.
|
|
46
|
+
*/
|
|
47
|
+
function retireEntry(entry) {
|
|
48
|
+
if (sharedEntry === entry) {
|
|
49
|
+
sharedEntry = null;
|
|
50
|
+
connectionPromise = null;
|
|
51
|
+
}
|
|
52
|
+
entry.retired = true;
|
|
53
|
+
if (entry.inFlight === 0)
|
|
54
|
+
closeEntry(entry);
|
|
33
55
|
}
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
56
|
+
/** Retire the current child (if any) so the next call starts a fresh one. */
|
|
57
|
+
function recycleConnection() {
|
|
58
|
+
if (sharedEntry)
|
|
59
|
+
retireEntry(sharedEntry);
|
|
60
|
+
}
|
|
61
|
+
function releaseEntry(entry) {
|
|
62
|
+
entry.inFlight -= 1;
|
|
63
|
+
if (entry.retired && entry.inFlight === 0)
|
|
64
|
+
closeEntry(entry);
|
|
65
|
+
}
|
|
66
|
+
async function getGitNexusEntry() {
|
|
67
|
+
if (sharedEntry)
|
|
68
|
+
return sharedEntry;
|
|
37
69
|
if (connectionPromise)
|
|
38
70
|
return connectionPromise;
|
|
39
|
-
|
|
71
|
+
// Declared before the body so the body can compare it by identity (a later
|
|
72
|
+
// recycle may have replaced connectionPromise while connect was running).
|
|
73
|
+
// eslint-disable-next-line prefer-const
|
|
74
|
+
let pending = null;
|
|
75
|
+
pending = (async () => {
|
|
76
|
+
// Fail with the cause, not a bare "spawn npx ENOENT": a service-managed
|
|
77
|
+
// server only has the PATH its service definition recorded at install.
|
|
78
|
+
const npxReason = npxUnavailableReason();
|
|
79
|
+
if (npxReason)
|
|
80
|
+
throw new Error(npxReason); // failure reset below
|
|
40
81
|
const transport = new StdioClientTransport({
|
|
41
82
|
command: 'npx',
|
|
42
|
-
args: ['-y',
|
|
83
|
+
args: ['-y', GITNEXUS_PACKAGE_SPEC, 'mcp'],
|
|
43
84
|
stderr: 'pipe',
|
|
44
85
|
});
|
|
45
86
|
const client = new Client({ name: 'apra-fleet', version: '1.0.0' }, { capabilities: {} });
|
|
87
|
+
const entry = { client, inFlight: 0, retired: false, closed: false, servedGeneration: new Map() };
|
|
46
88
|
// Transport death reset: if the child process dies (close) or the
|
|
47
|
-
// transport/client errors after a successful connect,
|
|
48
|
-
//
|
|
49
|
-
//
|
|
50
|
-
// newer connection.
|
|
89
|
+
// transport/client errors after a successful connect, stop handing it
|
|
90
|
+
// out so the next call reconnects. Guard on identity so a late handler
|
|
91
|
+
// for a child that was already replaced does not clobber a newer one.
|
|
51
92
|
const onDeath = () => {
|
|
52
|
-
if
|
|
53
|
-
|
|
54
|
-
|
|
93
|
+
// retireEntry unshares only if this entry is still the shared one, and
|
|
94
|
+
// closes it (idempotently) once nothing is running on it.
|
|
95
|
+
retireEntry(entry);
|
|
55
96
|
};
|
|
56
97
|
transport.onclose = onDeath;
|
|
57
98
|
transport.onerror = onDeath;
|
|
58
99
|
client.onclose = onDeath;
|
|
59
100
|
client.onerror = onDeath;
|
|
60
|
-
|
|
61
|
-
|
|
101
|
+
await client.connect(transport);
|
|
102
|
+
if (connectionPromise === pending) {
|
|
103
|
+
// A child that died while connecting is never shared; clear the
|
|
104
|
+
// resolved promise too, or every later call would get it back.
|
|
105
|
+
if (entry.retired)
|
|
106
|
+
connectionPromise = null;
|
|
107
|
+
else
|
|
108
|
+
sharedEntry = entry;
|
|
62
109
|
}
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
110
|
+
return entry;
|
|
111
|
+
})();
|
|
112
|
+
const settled = pending;
|
|
113
|
+
connectionPromise = settled;
|
|
114
|
+
// Failure reset: clear the poisoned promise (sharedEntry stays null) so the
|
|
115
|
+
// NEXT call attempts a brand-new connection instead of awaiting a rejected
|
|
116
|
+
// promise forever; the current caller still sees the rejection. Attached
|
|
117
|
+
// here, not inside the async body, because the npx check throws before the
|
|
118
|
+
// body's first await -- i.e. before connectionPromise is even assigned.
|
|
119
|
+
settled.catch(() => {
|
|
120
|
+
if (connectionPromise === settled)
|
|
67
121
|
connectionPromise = null;
|
|
68
|
-
|
|
122
|
+
});
|
|
123
|
+
return settled;
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Take a reference on a live, non-retired child. A child retired between its
|
|
127
|
+
* connect resolving and this continuation running (another call recycled it)
|
|
128
|
+
* is skipped, never used: it may already be closed. Bounded: a child that
|
|
129
|
+
* dies on every start (a crash-on-start gitnexus build) would otherwise make
|
|
130
|
+
* this re-spawn npx forever and the code_* call never return; after
|
|
131
|
+
* GITNEXUS_ACQUIRE_ATTEMPTS retired children it throws, and callGitNexus turns
|
|
132
|
+
* that into the offline result.
|
|
133
|
+
*/
|
|
134
|
+
const GITNEXUS_ACQUIRE_ATTEMPTS = 3;
|
|
135
|
+
async function acquireGitNexusEntry() {
|
|
136
|
+
for (let attempt = 1; attempt <= GITNEXUS_ACQUIRE_ATTEMPTS; attempt++) {
|
|
137
|
+
const entry = await getGitNexusEntry();
|
|
138
|
+
if (!entry.retired) {
|
|
139
|
+
entry.inFlight += 1;
|
|
140
|
+
return entry;
|
|
69
141
|
}
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
}
|
|
73
|
-
|
|
142
|
+
if (entry.inFlight === 0)
|
|
143
|
+
closeEntry(entry);
|
|
144
|
+
}
|
|
145
|
+
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)`);
|
|
74
146
|
}
|
|
75
147
|
// Freshness metadata (F2.2): when a call carries a `repo` param and the index
|
|
76
148
|
// exists, compare meta.json's lastCommit against the repo's current
|
|
@@ -90,7 +162,7 @@ function computeFreshnessNote(repo) {
|
|
|
90
162
|
const metaPath = join(repo, '.gitnexus', 'meta.json');
|
|
91
163
|
const meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
|
|
92
164
|
const head = execFileSync('git', ['rev-parse', 'HEAD'], {
|
|
93
|
-
cwd: repo, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
|
|
165
|
+
cwd: repo, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
94
166
|
}).trim();
|
|
95
167
|
const diverged = freshnessNote(meta.lastCommit, head) !== null;
|
|
96
168
|
let reindexScheduled = false;
|
|
@@ -129,33 +201,237 @@ function appendFreshnessNote(result, note) {
|
|
|
129
201
|
// result and the shared state is reset so the next call reconnects.
|
|
130
202
|
//
|
|
131
203
|
// Pre-flight (F3.1): when the call carries a non-empty `repo` param, verify
|
|
132
|
-
// the repo
|
|
133
|
-
//
|
|
134
|
-
//
|
|
204
|
+
// the repo's index is ready (codeIndexReadiness, code-intelligence-readiness.ts
|
|
205
|
+
// -- the one readiness check) BEFORE ever touching the child process; a
|
|
206
|
+
// not-ready index throws E-CODE-INDEX-NOT-READY. A missing or interrupted
|
|
207
|
+
// (died mid-write) index first gets a background build started
|
|
208
|
+
// (ensureGitNexusIndexReady), so a dead index heals itself instead of failing
|
|
209
|
+
// every call until someone reindexes by hand. Every code_* tool call carries the calling
|
|
210
|
+
// session's resolved (self) folder as `repo` (resolveCodeSelf in
|
|
211
|
+
// code-intelligence.ts); a direct provider call without one is forwarded
|
|
212
|
+
// untouched.
|
|
213
|
+
//
|
|
214
|
+
// Consistency fence: the index generation is read before the call; a child
|
|
215
|
+
// that last answered this repo from an older generation is recycled first.
|
|
216
|
+
// AFTER the call, readiness and the generation are checked again: if an
|
|
217
|
+
// analyze started, finished, or left the metadata inconsistent while the
|
|
218
|
+
// call ran, the answer may come from a half-rewritten index and is DISCARDED
|
|
219
|
+
// with E-CODE-INDEX-NOT-READY rather than returned.
|
|
135
220
|
async function callGitNexus(name, params) {
|
|
136
221
|
const repo = params.repo;
|
|
137
222
|
const hasRepo = typeof repo === 'string' && repo.length > 0;
|
|
223
|
+
let generation = '';
|
|
138
224
|
if (hasRepo) {
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
225
|
+
ensureGitNexusIndexReady(repo);
|
|
226
|
+
generation = indexGeneration(readGitNexusIndexState(repo));
|
|
227
|
+
const seen = sharedEntry?.servedGeneration.get(repo);
|
|
228
|
+
if (seen !== undefined && seen !== generation)
|
|
229
|
+
recycleConnection();
|
|
143
230
|
}
|
|
231
|
+
let result;
|
|
232
|
+
let entry = null;
|
|
144
233
|
try {
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
if (hasRepo) {
|
|
148
|
-
const note = computeFreshnessNote(repo);
|
|
149
|
-
if (note)
|
|
150
|
-
return appendFreshnessNote(result, note);
|
|
151
|
-
}
|
|
152
|
-
return result;
|
|
234
|
+
entry = await acquireGitNexusEntry();
|
|
235
|
+
result = await entry.client.callTool({ name, arguments: params });
|
|
153
236
|
}
|
|
154
237
|
catch (err) {
|
|
155
|
-
|
|
156
|
-
|
|
238
|
+
// Retire only the child THIS call ran on -- never a fresh child another
|
|
239
|
+
// call already swapped in. A failed connect has no entry: the connect
|
|
240
|
+
// path already cleared its poisoned promise.
|
|
241
|
+
if (entry)
|
|
242
|
+
retireEntry(entry);
|
|
243
|
+
let detail = err instanceof Error ? err.message : String(err);
|
|
244
|
+
if (/\bENOENT\b/.test(detail) && /npx/.test(detail))
|
|
245
|
+
detail = `${detail}: ${missingOnServerPathMessage('npx')}`;
|
|
157
246
|
return offlineResult(detail);
|
|
158
247
|
}
|
|
248
|
+
finally {
|
|
249
|
+
if (entry)
|
|
250
|
+
releaseEntry(entry);
|
|
251
|
+
}
|
|
252
|
+
if (!hasRepo)
|
|
253
|
+
return result;
|
|
254
|
+
const after = codeIndexReadiness('gitnexus', repo);
|
|
255
|
+
const generationAfter = indexGeneration(readGitNexusIndexState(repo));
|
|
256
|
+
if (!after.ready || generationAfter !== generation) {
|
|
257
|
+
// The child may hold a handle on the index that just changed.
|
|
258
|
+
retireEntry(entry);
|
|
259
|
+
throw indexChangedDuringCallError(repo, after);
|
|
260
|
+
}
|
|
261
|
+
entry.servedGeneration.set(repo, generation);
|
|
262
|
+
const note = computeFreshnessNote(repo);
|
|
263
|
+
return note ? appendFreshnessNote(result, note) : result;
|
|
264
|
+
}
|
|
265
|
+
const QUALIFIER_SEPS = ['.', '::', '#', ':', '/'];
|
|
266
|
+
/** True when `qualified` is `simple` or a qualified form ending in it. */
|
|
267
|
+
function endsWithSymbol(qualified, simple) {
|
|
268
|
+
if (qualified === '' || simple === '')
|
|
269
|
+
return false;
|
|
270
|
+
return qualified === simple || QUALIFIER_SEPS.some((sep) => qualified.endsWith(sep + simple));
|
|
271
|
+
}
|
|
272
|
+
/**
|
|
273
|
+
* Drop the disambiguation tags gitnexus appends to an id AFTER the qualified
|
|
274
|
+
* name, so the symbol segment can be compared with a plain name:
|
|
275
|
+
* '#<arity>' (every Method, Constructor and class-nested Function), followed
|
|
276
|
+
* by optional collision tags ('~type1,type2', '$const'), '~shape:<...>'
|
|
277
|
+
* parameter-shape tags, '~T1,T2' class template arguments and '~c:<hash>'
|
|
278
|
+
* constraints. Several of these contain a single ':' themselves, so they must
|
|
279
|
+
* go before the id is split. Only the last path segment is scanned for a '~'
|
|
280
|
+
* tag (a '~' in a directory name is not a tag), and a '~' right after '.' or
|
|
281
|
+
* ':' starts a C++ destructor name ('Foo.~Foo'), not a tag.
|
|
282
|
+
*
|
|
283
|
+
* The '#<arity>' tag is recognised only in the last path segment and only
|
|
284
|
+
* where it ends the id or is followed by a '~'/'$' tag, so a directory or
|
|
285
|
+
* file name holding '#<digit>' ('src/issue#12/b.ts') stays part of the path.
|
|
286
|
+
*
|
|
287
|
+
* gitnexus (1.6.x callable-id) also names a function-local callable by its
|
|
288
|
+
* declaration position, '<name>@<row>:<col>' ('outer.pick@1:2'). That ':' is
|
|
289
|
+
* not an id separator, so every such position suffix in the symbol segment
|
|
290
|
+
* is dropped too ('outer.pick'); an '@' in a directory ('src/@scope/pkg') is
|
|
291
|
+
* untouched.
|
|
292
|
+
*/
|
|
293
|
+
function stripIdTags(id) {
|
|
294
|
+
const lastSegment = id.lastIndexOf('/') + 1;
|
|
295
|
+
const arityMatch = /#\d+(?=$|[~$])/.exec(id.slice(lastSegment));
|
|
296
|
+
let head = arityMatch ? id.slice(0, lastSegment + arityMatch.index) : id;
|
|
297
|
+
for (let i = lastSegment; i < head.length; i++) {
|
|
298
|
+
if (head[i] !== '~')
|
|
299
|
+
continue;
|
|
300
|
+
const prev = i > 0 ? head[i - 1] : '';
|
|
301
|
+
if (prev === '.' || prev === ':')
|
|
302
|
+
continue;
|
|
303
|
+
head = head.slice(0, i);
|
|
304
|
+
break;
|
|
305
|
+
}
|
|
306
|
+
return head.slice(0, lastSegment) + head.slice(lastSegment).replace(/@\d+:\d+(?=$|[.#])/g, '');
|
|
307
|
+
}
|
|
308
|
+
/**
|
|
309
|
+
* Split a gitnexus id/uid ("Function:src/a.ts:Svc.run", "a.mjs:fn",
|
|
310
|
+
* "Function:src/a.rs:ns::fn") at its last SINGLE ':' (a '::' is part of the
|
|
311
|
+
* symbol) into the file part before it and the symbol segment after it.
|
|
312
|
+
* Returns null when the id has no single ':' -- nothing to cross-check.
|
|
313
|
+
*/
|
|
314
|
+
function splitSymbolId(rawId) {
|
|
315
|
+
const id = stripIdTags(rawId);
|
|
316
|
+
const singles = [];
|
|
317
|
+
for (let i = 0; i < id.length; i++) {
|
|
318
|
+
if (id[i] !== ':')
|
|
319
|
+
continue;
|
|
320
|
+
if (id[i + 1] === ':') {
|
|
321
|
+
i++;
|
|
322
|
+
continue;
|
|
323
|
+
}
|
|
324
|
+
singles.push(i);
|
|
325
|
+
}
|
|
326
|
+
if (singles.length === 0)
|
|
327
|
+
return null;
|
|
328
|
+
const last = singles[singles.length - 1];
|
|
329
|
+
const prev = singles.length > 1 ? singles[singles.length - 2] + 1 : 0;
|
|
330
|
+
return { file: id.slice(prev, last), symbol: id.slice(last + 1) };
|
|
331
|
+
}
|
|
332
|
+
function sameFile(a, b) {
|
|
333
|
+
return a === b || a.endsWith('/' + b) || b.endsWith('/' + a);
|
|
334
|
+
}
|
|
335
|
+
/**
|
|
336
|
+
* True when `resolved` is the symbol `requested` names: equal to its name,
|
|
337
|
+
* id (uid) or file path, or a qualified form ending in the name
|
|
338
|
+
* (Class.method, ns::fn, Class#method, file.ts:fn, dir/file.ts). A response
|
|
339
|
+
* that resolved nothing (no name and no id) has nothing to contradict.
|
|
340
|
+
*
|
|
341
|
+
* A matching name alone is not proof: a corrupt index can return the
|
|
342
|
+
* requested name on a node whose id names an unrelated symbol (name
|
|
343
|
+
* 'runUninstall', id 'beads-children.mjs:claimBeadsBatched'). So when an id
|
|
344
|
+
* is present its symbol segment must agree with the name (or, with no name,
|
|
345
|
+
* with the request), and a file part that looks like a path must agree with
|
|
346
|
+
* filePath; any disagreement is a mismatch even if the name matches.
|
|
347
|
+
*/
|
|
348
|
+
export function resolvesToRequested(requested, resolved) {
|
|
349
|
+
const req = requested.trim();
|
|
350
|
+
const name = resolved.name ?? '';
|
|
351
|
+
const id = resolved.id ?? '';
|
|
352
|
+
if (req === '' || (name === '' && id === ''))
|
|
353
|
+
return true;
|
|
354
|
+
const parts = id !== '' ? splitSymbolId(id) : null;
|
|
355
|
+
if (parts) {
|
|
356
|
+
// The id's own symbol must be the symbol the response names.
|
|
357
|
+
if (name !== '' && !endsWithSymbol(parts.symbol, name))
|
|
358
|
+
return false;
|
|
359
|
+
// A path-like file part must be the file the response names.
|
|
360
|
+
const filePath = resolved.filePath ?? '';
|
|
361
|
+
if (filePath !== '' && /[./]/.test(parts.file) && !sameFile(parts.file, filePath))
|
|
362
|
+
return false;
|
|
363
|
+
}
|
|
364
|
+
if (req === name || req === id || req === resolved.filePath)
|
|
365
|
+
return true;
|
|
366
|
+
if (name !== '')
|
|
367
|
+
return endsWithSymbol(req, name);
|
|
368
|
+
// No name: compare the request with the id's symbol segment.
|
|
369
|
+
return parts !== null && (endsWithSymbol(req, parts.symbol) || endsWithSymbol(parts.symbol, req));
|
|
370
|
+
}
|
|
371
|
+
function resolvedFrom(value) {
|
|
372
|
+
if (!value || typeof value !== 'object')
|
|
373
|
+
return null;
|
|
374
|
+
const v = value;
|
|
375
|
+
const str = (x) => (typeof x === 'string' && x !== '' ? x : undefined);
|
|
376
|
+
const out = { name: str(v.name), id: str(v.id) ?? str(v.uid), filePath: str(v.filePath) };
|
|
377
|
+
return out.name || out.id ? out : null;
|
|
378
|
+
}
|
|
379
|
+
/**
|
|
380
|
+
* Flag a code_impact ('impact', resolved symbol in payload.target) or
|
|
381
|
+
* code_context ('context', payload.symbol) result whose resolved symbol is not
|
|
382
|
+
* the requested one. Returns the result unchanged when it matches, is an
|
|
383
|
+
* error, or is not the JSON shape gitnexus returns.
|
|
384
|
+
*/
|
|
385
|
+
export function flagResolutionMismatch(result, requested, kind) {
|
|
386
|
+
if (typeof requested !== 'string' || isErrorResult(result))
|
|
387
|
+
return result;
|
|
388
|
+
if (!result || typeof result !== 'object' || !('content' in result))
|
|
389
|
+
return result;
|
|
390
|
+
const content = result.content;
|
|
391
|
+
if (!Array.isArray(content) || content.length === 0)
|
|
392
|
+
return result;
|
|
393
|
+
const first = content[0];
|
|
394
|
+
if (!first || typeof first.text !== 'string')
|
|
395
|
+
return result;
|
|
396
|
+
const sep = '\n\n---\n';
|
|
397
|
+
const cut = first.text.indexOf(sep);
|
|
398
|
+
const jsonPart = cut >= 0 ? first.text.slice(0, cut) : first.text;
|
|
399
|
+
const suffix = cut >= 0 ? first.text.slice(cut) : '';
|
|
400
|
+
let payload;
|
|
401
|
+
try {
|
|
402
|
+
const parsed = JSON.parse(jsonPart);
|
|
403
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
|
|
404
|
+
return result;
|
|
405
|
+
payload = parsed;
|
|
406
|
+
}
|
|
407
|
+
catch {
|
|
408
|
+
return result;
|
|
409
|
+
}
|
|
410
|
+
const resolved = resolvedFrom(kind === 'impact' ? payload.target : payload.symbol);
|
|
411
|
+
if (!resolved || resolvesToRequested(requested, resolved))
|
|
412
|
+
return result;
|
|
413
|
+
const mismatch = { requested, resolved };
|
|
414
|
+
const what = `${resolved.name ?? resolved.id}${resolved.filePath ? ` (${resolved.filePath})` : ''}` +
|
|
415
|
+
(resolved.name && resolved.id ? `, id ${resolved.id}` : '');
|
|
416
|
+
const warning = `[code-intelligence] RESOLUTION MISMATCH: '${requested}' resolved to a different symbol, ${what}. ` +
|
|
417
|
+
'This answer is about that symbol, not the one requested; confidence is LOW. ' +
|
|
418
|
+
'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.';
|
|
419
|
+
const patched = { ...payload, resolution_mismatch: mismatch, confidence: 'LOW' };
|
|
420
|
+
if (kind === 'impact' && 'risk' in payload) {
|
|
421
|
+
patched.unverified_risk = payload.risk;
|
|
422
|
+
patched.risk = 'UNKNOWN';
|
|
423
|
+
}
|
|
424
|
+
const rest = result;
|
|
425
|
+
return {
|
|
426
|
+
...rest,
|
|
427
|
+
content: [
|
|
428
|
+
{ ...first, text: JSON.stringify(patched, null, 2) + suffix },
|
|
429
|
+
...content.slice(1),
|
|
430
|
+
{ type: 'text', text: warning },
|
|
431
|
+
],
|
|
432
|
+
resolution_mismatch: mismatch,
|
|
433
|
+
confidence: 'LOW',
|
|
434
|
+
};
|
|
159
435
|
}
|
|
160
436
|
// Small, pure, exported so both T2.1 (code_map) and T2.2 (code_flow) can reuse
|
|
161
437
|
// it and it can be unit tested directly without mocking the MCP client.
|
|
@@ -401,13 +677,13 @@ export class GitNexusProvider {
|
|
|
401
677
|
});
|
|
402
678
|
}
|
|
403
679
|
async impact(params) {
|
|
404
|
-
return callGitNexus('impact', params);
|
|
680
|
+
return flagResolutionMismatch(await callGitNexus('impact', params), params.target, 'impact');
|
|
405
681
|
}
|
|
406
682
|
async query(params) {
|
|
407
683
|
return callGitNexus('query', params);
|
|
408
684
|
}
|
|
409
685
|
async context(params) {
|
|
410
|
-
return callGitNexus('context', params);
|
|
686
|
+
return flagResolutionMismatch(await callGitNexus('context', params), params.name, 'context');
|
|
411
687
|
}
|
|
412
688
|
// T2.1: architectural map via Community nodes (rung 2 -- compose over cypher;
|
|
413
689
|
// 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,
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { type ScheduleReindexOutcome } from './code-index-heal.js';
|
|
2
|
+
export { readGitNexusIndexState, type GitNexusIndexState } from './code-index-state.js';
|
|
3
|
+
export type CodeIntelErrorCode = 'E-CODE-INDEX-NOT-READY' | 'E-CODE-INTEL-DISABLED';
|
|
4
|
+
export declare class CodeIntelError extends Error {
|
|
5
|
+
readonly code: CodeIntelErrorCode;
|
|
6
|
+
readonly remediation: string;
|
|
7
|
+
constructor(code: CodeIntelErrorCode, problem: string, remediation: string);
|
|
8
|
+
}
|
|
9
|
+
export type CodeIndexProvider = 'gitnexus' | 'codebase-memory';
|
|
10
|
+
/**
|
|
11
|
+
* Why an index is not ready:
|
|
12
|
+
* building -- an analyze is live (this server's run, a held analyze lock,
|
|
13
|
+
* or a recorded run whose pid is alive);
|
|
14
|
+
* interrupted -- meta.json says incrementalInProgress but no analyze is live:
|
|
15
|
+
* a run died mid-write and nothing will finish it;
|
|
16
|
+
* missing -- no usable index and no analyze is live;
|
|
17
|
+
* inconsistent -- the index looks complete but its metadata disagrees with
|
|
18
|
+
* itself (gitnexus's registry, or fleet's record of its last
|
|
19
|
+
* build, names a different commit than meta.json), and no
|
|
20
|
+
* analyze is live: a torn write whose answers cannot be
|
|
21
|
+
* trusted. `detail` says which copies disagree.
|
|
22
|
+
*/
|
|
23
|
+
export type CodeIndexNotReadyState = 'missing' | 'building' | 'interrupted' | 'inconsistent';
|
|
24
|
+
export type CodeIndexReadiness = {
|
|
25
|
+
ready: true;
|
|
26
|
+
} | {
|
|
27
|
+
ready: false;
|
|
28
|
+
state: CodeIndexNotReadyState;
|
|
29
|
+
detail?: string;
|
|
30
|
+
};
|
|
31
|
+
export declare const CODEBASE_MEMORY_CACHE_DIR: string;
|
|
32
|
+
/** The commit a gitnexus answer for `repo` is served from ('' when unknown). */
|
|
33
|
+
export declare function indexedCommitOf(repo: string): string;
|
|
34
|
+
/**
|
|
35
|
+
* THE readiness check for a code index -- the one place that decides whether
|
|
36
|
+
* a provider can answer for `repo`. Never throws; any IO failure reads as
|
|
37
|
+
* not ready.
|
|
38
|
+
*
|
|
39
|
+
* gitnexus -- ready when <repo>/.gitnexus/meta.json has a non-empty
|
|
40
|
+
* lastCommit AND no incrementalInProgress flag AND no
|
|
41
|
+
* analyze is live (see 'building' below) AND the
|
|
42
|
+
* metadata is consistent (indexInconsistency). An
|
|
43
|
+
* analyze rewrites the index IN PLACE, so a complete-
|
|
44
|
+
* looking meta.json under a live analyze is NOT served:
|
|
45
|
+
* that is the fence that keeps a half-rewritten graph
|
|
46
|
+
* from answering. A placeholder meta.json
|
|
47
|
+
* (lastCommit '') is NOT an index. Not ready is
|
|
48
|
+
* 'building' while an analyze is LIVE -- this server's
|
|
49
|
+
* own run, a held analyze lock, or a status.json run
|
|
50
|
+
* (codeIndexDir) whose pid is alive, which covers a run
|
|
51
|
+
* left by a previous server instance where the gitnexus
|
|
52
|
+
* lock is a socket with no file (Windows/Linux). With no
|
|
53
|
+
* live analyze, a meta.json still flagged
|
|
54
|
+
* incrementalInProgress is 'interrupted' (a run died
|
|
55
|
+
* mid-write), anything else 'missing' -- both are dead
|
|
56
|
+
* states the code_* pre-flight heals by starting a build.
|
|
57
|
+
* codebase-memory -- ready when its cache dir holds at least one project
|
|
58
|
+
* database; it exposes no building signal.
|
|
59
|
+
*
|
|
60
|
+
* Pure: never starts anything (fleet/member health reports call it too).
|
|
61
|
+
*/
|
|
62
|
+
export declare function codeIndexReadiness(provider: CodeIndexProvider, repo?: string): CodeIndexReadiness;
|
|
63
|
+
/**
|
|
64
|
+
* What the pre-flight did about a not-ready index: the scheduler's outcome, or
|
|
65
|
+
* 'remote-member' when the work folder is not on this host (nothing can be
|
|
66
|
+
* built here). Omitted when no heal was attempted.
|
|
67
|
+
*/
|
|
68
|
+
export type IndexHealOutcome = ScheduleReindexOutcome | {
|
|
69
|
+
started: false;
|
|
70
|
+
reason: 'remote-member';
|
|
71
|
+
detail?: string;
|
|
72
|
+
};
|
|
73
|
+
/** The typed error for a readiness result that is not ready. */
|
|
74
|
+
export declare function indexNotReadyError(provider: CodeIndexProvider, repo: string | undefined, state: CodeIndexNotReadyState, heal?: IndexHealOutcome, detail?: string): CodeIntelError;
|
|
75
|
+
/**
|
|
76
|
+
* The typed error for an answer discarded because the index changed while the
|
|
77
|
+
* call ran: `after` is readiness re-read once the call returned. Not ready ->
|
|
78
|
+
* the error for that state; still ready -> the index was replaced (an analyze
|
|
79
|
+
* finished) mid-call. Either way: retry.
|
|
80
|
+
*/
|
|
81
|
+
export declare function indexChangedDuringCallError(repo: string, after: CodeIndexReadiness): CodeIntelError;
|
|
82
|
+
/** Throw E-CODE-INDEX-NOT-READY unless the provider's index for `repo` is ready. Never starts a build. */
|
|
83
|
+
export declare function assertCodeIndexReady(provider: CodeIndexProvider, repo?: string): void;
|
|
84
|
+
/**
|
|
85
|
+
* The gitnexus code_* pre-flight: return when `repo`'s index is ready, else
|
|
86
|
+
* throw E-CODE-INDEX-NOT-READY -- but first HEAL a dead index. A 'missing',
|
|
87
|
+
* 'interrupted' or 'inconsistent' index gets a background build (scheduleIndexBuild: config-,
|
|
88
|
+
* cooldown- and single-flight-gated, never throws), so a stale or crashed
|
|
89
|
+
* index recovers without anyone running analyze by hand; the error then says
|
|
90
|
+
* whether a build started or why not. Never schedules for a 'building' index,
|
|
91
|
+
* nor for a work folder that is not on this host (`remote`, or absent here):
|
|
92
|
+
* that error says so instead.
|
|
93
|
+
*/
|
|
94
|
+
export declare function ensureGitNexusIndexReady(repo: string, opts?: {
|
|
95
|
+
remote?: boolean;
|
|
96
|
+
}): void;
|
|
97
|
+
/** The typed error every NullProvider method throws. */
|
|
98
|
+
export declare function codeIntelDisabledError(method: string): CodeIntelError;
|
|
99
|
+
//# sourceMappingURL=code-intelligence-readiness.d.ts.map
|