@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -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
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
// Typed code_* errors and the single code-index readiness check.
|
|
2
|
+
//
|
|
3
|
+
// Kept in its own module -- NOT importing from code-intelligence.ts -- so the
|
|
4
|
+
// provider files (code-intelligence-gitnexus.ts, -codebase-memory.ts) can
|
|
5
|
+
// import it as a value without a circular import (same reason as
|
|
6
|
+
// code-intelligence-reindex.ts).
|
|
7
|
+
//
|
|
8
|
+
// Errors are THROWN, never returned as a result object: the code_* handlers
|
|
9
|
+
// JSON.stringify a provider result into an ok envelope, so a returned
|
|
10
|
+
// "error-shaped" object would read as success to the caller. A thrown error
|
|
11
|
+
// becomes an isError tool result at the MCP boundary. Each message is one
|
|
12
|
+
// line, 'CODE: problem Remediation: ...' -- the same pattern as KbSelfError
|
|
13
|
+
// (src/services/knowledge/kb-self.ts).
|
|
14
|
+
import { existsSync, readdirSync } from 'fs';
|
|
15
|
+
import { homedir } from 'os';
|
|
16
|
+
import { join } from 'path';
|
|
17
|
+
import { isRecordedAnalyzeAlive, isReindexRunning, recordedIndexBuild } from './code-intelligence-reindex.js';
|
|
18
|
+
import { indexInconsistency, readGitNexusIndexState } from './code-index-state.js';
|
|
19
|
+
import { scheduleIndexBuild } from './code-index-heal.js';
|
|
20
|
+
import { missingOnServerPathMessage } from '../utils/find-on-path.js';
|
|
21
|
+
export { readGitNexusIndexState } from './code-index-state.js';
|
|
22
|
+
export class CodeIntelError extends Error {
|
|
23
|
+
code;
|
|
24
|
+
remediation;
|
|
25
|
+
constructor(code, problem, remediation) {
|
|
26
|
+
super(`${code}: ${problem} Remediation: ${remediation}`);
|
|
27
|
+
this.name = 'CodeIntelError';
|
|
28
|
+
this.code = code;
|
|
29
|
+
this.remediation = remediation;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
// codebase-memory-mcp's default database storage directory (its README
|
|
33
|
+
// "Persistence" section: SQLite databases under ~/.cache/codebase-memory-mcp/).
|
|
34
|
+
export const CODEBASE_MEMORY_CACHE_DIR = join(homedir(), '.cache', 'codebase-memory-mcp');
|
|
35
|
+
/** The commit a gitnexus answer for `repo` is served from ('' when unknown). */
|
|
36
|
+
export function indexedCommitOf(repo) {
|
|
37
|
+
return readGitNexusIndexState(repo).lastCommit;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* THE readiness check for a code index -- the one place that decides whether
|
|
41
|
+
* a provider can answer for `repo`. Never throws; any IO failure reads as
|
|
42
|
+
* not ready.
|
|
43
|
+
*
|
|
44
|
+
* gitnexus -- ready when <repo>/.gitnexus/meta.json has a non-empty
|
|
45
|
+
* lastCommit AND no incrementalInProgress flag AND no
|
|
46
|
+
* analyze is live (see 'building' below) AND the
|
|
47
|
+
* metadata is consistent (indexInconsistency). An
|
|
48
|
+
* analyze rewrites the index IN PLACE, so a complete-
|
|
49
|
+
* looking meta.json under a live analyze is NOT served:
|
|
50
|
+
* that is the fence that keeps a half-rewritten graph
|
|
51
|
+
* from answering. A placeholder meta.json
|
|
52
|
+
* (lastCommit '') is NOT an index. Not ready is
|
|
53
|
+
* 'building' while an analyze is LIVE -- this server's
|
|
54
|
+
* own run, a held analyze lock, or a status.json run
|
|
55
|
+
* (codeIndexDir) whose pid is alive, which covers a run
|
|
56
|
+
* left by a previous server instance where the gitnexus
|
|
57
|
+
* lock is a socket with no file (Windows/Linux). With no
|
|
58
|
+
* live analyze, a meta.json still flagged
|
|
59
|
+
* incrementalInProgress is 'interrupted' (a run died
|
|
60
|
+
* mid-write), anything else 'missing' -- both are dead
|
|
61
|
+
* states the code_* pre-flight heals by starting a build.
|
|
62
|
+
* codebase-memory -- ready when its cache dir holds at least one project
|
|
63
|
+
* database; it exposes no building signal.
|
|
64
|
+
*
|
|
65
|
+
* Pure: never starts anything (fleet/member health reports call it too).
|
|
66
|
+
*/
|
|
67
|
+
export function codeIndexReadiness(provider, repo) {
|
|
68
|
+
try {
|
|
69
|
+
if (provider === 'codebase-memory') {
|
|
70
|
+
const ready = existsSync(CODEBASE_MEMORY_CACHE_DIR) && readdirSync(CODEBASE_MEMORY_CACHE_DIR).length > 0;
|
|
71
|
+
return ready ? { ready: true } : { ready: false, state: 'missing' };
|
|
72
|
+
}
|
|
73
|
+
if (!repo)
|
|
74
|
+
return { ready: true };
|
|
75
|
+
const idx = readGitNexusIndexState(repo);
|
|
76
|
+
// Live analyze first: it may be rewriting an index whose meta.json still
|
|
77
|
+
// reads as complete.
|
|
78
|
+
if (idx.lockHeld || isReindexRunning(repo) || isRecordedAnalyzeAlive(repo))
|
|
79
|
+
return { ready: false, state: 'building' };
|
|
80
|
+
if (idx.metaPresent && idx.incrementalInProgress)
|
|
81
|
+
return { ready: false, state: 'interrupted' };
|
|
82
|
+
if (!idx.metaPresent || idx.lastCommit === '')
|
|
83
|
+
return { ready: false, state: 'missing' };
|
|
84
|
+
const inconsistency = indexInconsistency(repo, idx, recordedIndexBuild(repo));
|
|
85
|
+
if (inconsistency)
|
|
86
|
+
return { ready: false, state: 'inconsistent', detail: inconsistency };
|
|
87
|
+
return { ready: true };
|
|
88
|
+
}
|
|
89
|
+
catch {
|
|
90
|
+
return { ready: false, state: 'missing' };
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
const RETRY_SOON = 'Retry the same call in a minute or so (code_status shows the build progress).';
|
|
94
|
+
/** The typed error for a readiness result that is not ready. */
|
|
95
|
+
export function indexNotReadyError(provider, repo, state, heal, detail) {
|
|
96
|
+
const where = repo ? ` for '${repo}'` : '';
|
|
97
|
+
if (provider === 'codebase-memory') {
|
|
98
|
+
return new CodeIntelError('E-CODE-INDEX-NOT-READY', `No codebase-memory code index found${where}.`, `Say "Index this project" to your agent (or run 'codebase-memory-mcp cli index_repository' on the repo), then retry.`);
|
|
99
|
+
}
|
|
100
|
+
if (state === 'building') {
|
|
101
|
+
return new CodeIntelError('E-CODE-INDEX-NOT-READY', `The gitnexus code index${where} is still being built.`, RETRY_SOON);
|
|
102
|
+
}
|
|
103
|
+
const problem = state === 'interrupted'
|
|
104
|
+
? `The gitnexus code index${where} is marked incomplete and no running analyze was found.`
|
|
105
|
+
: state === 'inconsistent'
|
|
106
|
+
? `The gitnexus code index${where} has inconsistent metadata${detail ? ` (${detail})` : ''}, so its answers cannot be trusted.`
|
|
107
|
+
: `No gitnexus code index found${where}.`;
|
|
108
|
+
const [what, remediation] = healText(heal);
|
|
109
|
+
return new CodeIntelError('E-CODE-INDEX-NOT-READY', `${problem}${what}`, remediation);
|
|
110
|
+
}
|
|
111
|
+
/** [sentence appended to the problem, remediation] for a heal outcome. */
|
|
112
|
+
function healText(heal) {
|
|
113
|
+
const detail = heal && !heal.started && heal.detail ? ` (${heal.detail})` : '';
|
|
114
|
+
if (!heal)
|
|
115
|
+
return ['', 'Call code_reindex to build the index, then retry the same call.'];
|
|
116
|
+
if (heal.started)
|
|
117
|
+
return [' An index build was requested automatically.', RETRY_SOON];
|
|
118
|
+
switch (heal.reason) {
|
|
119
|
+
case 'already-running':
|
|
120
|
+
return [' An index build is already running.', RETRY_SOON];
|
|
121
|
+
case 'paused': {
|
|
122
|
+
const p = heal.pause;
|
|
123
|
+
const last = p.lastLine ? `, last line '${p.lastLine}'` : '';
|
|
124
|
+
return [
|
|
125
|
+
` Automatic rebuilds for this folder are paused: the last automatic analyze ended '${p.result}' without a ready index (log: ${p.logPath}${last}).`,
|
|
126
|
+
'Read that log, fix the cause, then call code_reindex -- it retries the build and re-arms automatic rebuilds.',
|
|
127
|
+
];
|
|
128
|
+
}
|
|
129
|
+
case 'disabled':
|
|
130
|
+
return [
|
|
131
|
+
' Automatic index builds are off (autoReindex.enabled is false in the code-intelligence config.json).',
|
|
132
|
+
'Call code_reindex to build the index, then retry the same call.',
|
|
133
|
+
];
|
|
134
|
+
case 'cooldown':
|
|
135
|
+
return [
|
|
136
|
+
` An index build finished moments ago${detail}.`,
|
|
137
|
+
'Retry the same call in a minute or so; if it still fails, check code_status and call code_reindex.',
|
|
138
|
+
];
|
|
139
|
+
case 'npx-not-found':
|
|
140
|
+
// heal.detail is spawnAnalyze's npxUnavailableReason(): which tool is
|
|
141
|
+
// missing (npx or node), the PATH searched, and the install/refresh
|
|
142
|
+
// remedy -- the same text code_reindex reports.
|
|
143
|
+
return [
|
|
144
|
+
' The fleet server cannot start a build: a tool it needs is not on its PATH.',
|
|
145
|
+
`${heal.detail || missingOnServerPathMessage('npx')} Then retry the same call.`,
|
|
146
|
+
];
|
|
147
|
+
case 'remote-member':
|
|
148
|
+
return [
|
|
149
|
+
' The work folder is not on this host, so this server cannot build an index for it.',
|
|
150
|
+
'Use the code_* tools from a session on the host that holds the work folder (code_reindex there builds the index), then retry.',
|
|
151
|
+
];
|
|
152
|
+
default:
|
|
153
|
+
return [
|
|
154
|
+
` Starting an automatic index build failed: ${heal.reason}${detail}.`,
|
|
155
|
+
'Read the analyze log via code_status, then call code_reindex and retry.',
|
|
156
|
+
];
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* The typed error for an answer discarded because the index changed while the
|
|
161
|
+
* call ran: `after` is readiness re-read once the call returned. Not ready ->
|
|
162
|
+
* the error for that state; still ready -> the index was replaced (an analyze
|
|
163
|
+
* finished) mid-call. Either way: retry.
|
|
164
|
+
*/
|
|
165
|
+
export function indexChangedDuringCallError(repo, after) {
|
|
166
|
+
if (!after.ready && after.state !== 'building') {
|
|
167
|
+
return new CodeIntelError('E-CODE-INDEX-NOT-READY', `The gitnexus code index for '${repo}' changed while this call was answered and is now ${after.state}${after.detail ? ` (${after.detail})` : ''}; the answer was discarded.`, 'Retry the same call; it requests a rebuild if one is needed (code_status shows the index state).');
|
|
168
|
+
}
|
|
169
|
+
const why = after.ready ? 'was replaced by an index build' : 'started being rebuilt';
|
|
170
|
+
return new CodeIntelError('E-CODE-INDEX-NOT-READY', `The gitnexus code index for '${repo}' ${why} while this call was answered; the answer was discarded.`, RETRY_SOON);
|
|
171
|
+
}
|
|
172
|
+
/** Throw E-CODE-INDEX-NOT-READY unless the provider's index for `repo` is ready. Never starts a build. */
|
|
173
|
+
export function assertCodeIndexReady(provider, repo) {
|
|
174
|
+
const readiness = codeIndexReadiness(provider, repo);
|
|
175
|
+
if (!readiness.ready)
|
|
176
|
+
throw indexNotReadyError(provider, repo, readiness.state, undefined, readiness.detail);
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* The gitnexus code_* pre-flight: return when `repo`'s index is ready, else
|
|
180
|
+
* throw E-CODE-INDEX-NOT-READY -- but first HEAL a dead index. A 'missing',
|
|
181
|
+
* 'interrupted' or 'inconsistent' index gets a background build (scheduleIndexBuild: config-,
|
|
182
|
+
* cooldown- and single-flight-gated, never throws), so a stale or crashed
|
|
183
|
+
* index recovers without anyone running analyze by hand; the error then says
|
|
184
|
+
* whether a build started or why not. Never schedules for a 'building' index,
|
|
185
|
+
* nor for a work folder that is not on this host (`remote`, or absent here):
|
|
186
|
+
* that error says so instead.
|
|
187
|
+
*/
|
|
188
|
+
export function ensureGitNexusIndexReady(repo, opts = {}) {
|
|
189
|
+
const readiness = codeIndexReadiness('gitnexus', repo);
|
|
190
|
+
if (readiness.ready)
|
|
191
|
+
return;
|
|
192
|
+
if (readiness.state === 'building')
|
|
193
|
+
throw indexNotReadyError('gitnexus', repo, 'building');
|
|
194
|
+
let local = false;
|
|
195
|
+
try {
|
|
196
|
+
local = !opts.remote && existsSync(repo);
|
|
197
|
+
}
|
|
198
|
+
catch { /* treat as not local */ }
|
|
199
|
+
const heal = local ? scheduleIndexBuild(repo) : { started: false, reason: 'remote-member' };
|
|
200
|
+
throw indexNotReadyError('gitnexus', repo, readiness.state, heal, readiness.detail);
|
|
201
|
+
}
|
|
202
|
+
/** The typed error every NullProvider method throws. */
|
|
203
|
+
export function codeIntelDisabledError(method) {
|
|
204
|
+
return new CodeIntelError('E-CODE-INTEL-DISABLED', `Code intelligence is disabled (provider 'none'), so ${method} cannot be answered.`, `Pick a provider: update_member code_intel_provider ('gitnexus' or 'codebase-memory') for this member, or set "provider" in the code-intelligence config.json (apra-fleet install), then retry.`);
|
|
205
|
+
}
|
|
206
|
+
//# sourceMappingURL=code-intelligence-readiness.js.map
|
|
@@ -1,7 +1,202 @@
|
|
|
1
|
+
import { type ChildProcess } from 'child_process';
|
|
2
|
+
import { type RecordedIndexBuild } from './code-index-state.js';
|
|
3
|
+
import type { CodeIndexNotReadyState, CodeIndexReadiness } from './code-intelligence-readiness.js';
|
|
4
|
+
/** Why automatic rebuilds of a repo are paused: the automatic run that failed. */
|
|
5
|
+
export interface AutoReindexPause {
|
|
6
|
+
/** Result of that run ('failed', 'incomplete', or 'up-to-date' that still left no ready index). */
|
|
7
|
+
result: AnalyzeResult;
|
|
8
|
+
lastLine: string;
|
|
9
|
+
logPath: string;
|
|
10
|
+
finished: string;
|
|
11
|
+
}
|
|
1
12
|
export declare const DEFAULT_COOLDOWN_MS = 120000;
|
|
2
13
|
export declare function shouldStartReindex(entry: {
|
|
3
14
|
running: boolean;
|
|
4
15
|
lastFinishedAt?: number;
|
|
5
16
|
} | undefined, now: number, cooldownMs?: number): boolean;
|
|
17
|
+
/** True while a background reindex this server started for `repoPath` is still running. */
|
|
18
|
+
export declare function isReindexRunning(repoPath: string): boolean;
|
|
19
|
+
export type AnalyzePhase = 'starting' | 'running' | 'done';
|
|
20
|
+
export type AnalyzeResult = 'indexed' | 'up-to-date' | 'incomplete' | 'failed';
|
|
21
|
+
export interface AnalyzeStatus {
|
|
22
|
+
repo: string;
|
|
23
|
+
pid: number | null;
|
|
24
|
+
started: string;
|
|
25
|
+
lockHeld: boolean;
|
|
26
|
+
lastLine: string;
|
|
27
|
+
lineCount: number;
|
|
28
|
+
phase: AnalyzePhase;
|
|
29
|
+
result: AnalyzeResult | null;
|
|
30
|
+
exitCode: number | null;
|
|
31
|
+
finished?: string;
|
|
32
|
+
/** Set on a failed run whose log names a cause the fleet recognizes. */
|
|
33
|
+
failureCause?: AnalyzeFailureCause;
|
|
34
|
+
/** meta.json lastCommit when the run finished (fleet's own record of the build). */
|
|
35
|
+
indexedCommit?: string;
|
|
36
|
+
}
|
|
37
|
+
export type NotStartedReason = 'already-running' | 'npx-not-found' | 'gitnexus-not-found' | 'spawn-failed' | 'remote-member' | 'gitnexus-too-old';
|
|
38
|
+
/** Directory holding analyze.log + status.json for `repo`. */
|
|
39
|
+
export declare function codeIndexDir(repo: string): string;
|
|
40
|
+
/** Resolve an executable on PATH (PATHEXT-aware on Windows) without a shell. */
|
|
41
|
+
export declare function findOnPath(name: string): string | null;
|
|
42
|
+
/**
|
|
43
|
+
* Fleet's record of the last analyze it finished for `repo` (status.json):
|
|
44
|
+
* the commit meta.json named when that run ended. null when no finished,
|
|
45
|
+
* successful run is recorded (or it belongs to another folder sharing the
|
|
46
|
+
* slug dir). Never throws.
|
|
47
|
+
*/
|
|
48
|
+
export declare function recordedIndexBuild(repo: string): RecordedIndexBuild | null;
|
|
49
|
+
export declare const GITNEXUS_MIN_VERSION = "1.6.5";
|
|
50
|
+
export declare const GITNEXUS_PACKAGE_SPEC = "gitnexus@>=1.6.5";
|
|
51
|
+
export declare const GITNEXUS_ANALYZE_ARGS: readonly string[];
|
|
52
|
+
/**
|
|
53
|
+
* An npx argv that is safe under a shell. On Windows spawn() runs through
|
|
54
|
+
* cmd.exe (shell: true), where an unquoted `>=` is a redirection, so the
|
|
55
|
+
* version-range package spec is double-quoted there.
|
|
56
|
+
*/
|
|
57
|
+
export declare function npxArgsForShell(args: readonly string[], shell: boolean): string[];
|
|
58
|
+
/** Failure cause: the installed gitnexus rejects --index-only (too old). */
|
|
59
|
+
export type AnalyzeFailureCause = 'gitnexus-too-old';
|
|
60
|
+
/** One-line cause + fix reported wherever the too-old failure surfaces. */
|
|
61
|
+
export declare const GITNEXUS_TOO_OLD_DETAIL: string;
|
|
62
|
+
export declare const GITNEXUS_REPO_ARTIFACTS: readonly string[];
|
|
63
|
+
/**
|
|
64
|
+
* Adds each repo-relative path to `repoPath`'s git exclude file, resolved by
|
|
65
|
+
* git itself (`git rev-parse --git-path info/exclude`) so a linked worktree
|
|
66
|
+
* (where .git is a file) uses its common dir's exclude. Synchronous, never
|
|
67
|
+
* throws: a failure is logged and the caller carries on. Returns true when the
|
|
68
|
+
* exclude file holds every entry afterwards.
|
|
69
|
+
*/
|
|
70
|
+
export declare function ensureLocalGitExcluded(repoPath: string, relPaths: readonly string[]): boolean;
|
|
71
|
+
export declare const GITNEXUS_INJECTED_BLOCK_FILES: readonly string[];
|
|
72
|
+
/**
|
|
73
|
+
* Repo-relative agent docs of `repoPath` that still carry a gitnexus block
|
|
74
|
+
* injected by an earlier plain analyze run. READ-ONLY: it never edits the work
|
|
75
|
+
* tree (--index-only never removes such a block, so a clone dirtied before the
|
|
76
|
+
* fleet switched to it stays dirty until a human removes it). Never throws.
|
|
77
|
+
*/
|
|
78
|
+
export declare function detectInjectedGitnexusBlocks(repoPath: string): string[];
|
|
79
|
+
/** The one-line WARN for a non-empty detectInjectedGitnexusBlocks() result. */
|
|
80
|
+
export declare function injectedBlockWarning(files: readonly string[]): string | null;
|
|
81
|
+
export type SpawnAnalyzeOutcome = {
|
|
82
|
+
started: true;
|
|
83
|
+
child: ChildProcess;
|
|
84
|
+
dir: string;
|
|
85
|
+
} | {
|
|
86
|
+
started: false;
|
|
87
|
+
reason: NotStartedReason;
|
|
88
|
+
detail?: string;
|
|
89
|
+
};
|
|
90
|
+
/**
|
|
91
|
+
* Synchronously start `npx -y gitnexus analyze --index-only` in `repoPath` (detached off win32), with
|
|
92
|
+
* stdout+stderr going straight to analyze.log (a file descriptor, so the run
|
|
93
|
+
* outlives this server) and status.json kept current until exit. Never
|
|
94
|
+
* throws. Does NOT apply config/cooldown -- callers decide whether to start.
|
|
95
|
+
* `auto` marks an automatic run: one that ends without a ready index pauses
|
|
96
|
+
* automatic runs for the repo (see ReindexEntry.autoPaused). An explicit run
|
|
97
|
+
* (auto false, i.e. code_reindex) clears any pause when it starts.
|
|
98
|
+
*/
|
|
99
|
+
export declare function spawnAnalyze(repoPath: string, opts?: {
|
|
100
|
+
auto?: boolean;
|
|
101
|
+
}): SpawnAnalyzeOutcome;
|
|
102
|
+
/** Why an automatic reindex request did not start an analyze. */
|
|
103
|
+
export type ScheduleNotStartedReason = 'disabled' | 'cooldown' | 'paused' | NotStartedReason;
|
|
104
|
+
export type ScheduleReindexOutcome = {
|
|
105
|
+
started: true;
|
|
106
|
+
} | {
|
|
107
|
+
started: false;
|
|
108
|
+
reason: 'paused';
|
|
109
|
+
pause: AutoReindexPause;
|
|
110
|
+
detail?: string;
|
|
111
|
+
} | {
|
|
112
|
+
started: false;
|
|
113
|
+
reason: Exclude<ScheduleNotStartedReason, 'paused'>;
|
|
114
|
+
detail?: string;
|
|
115
|
+
};
|
|
116
|
+
/** The pause on automatic rebuilds of `repoPath`, or null when they are armed. */
|
|
117
|
+
export declare function autoReindexPause(repoPath: string): AutoReindexPause | null;
|
|
118
|
+
/** Re-arm automatic rebuilds of `repoPath` (an explicit code_reindex does this). */
|
|
119
|
+
export declare function clearAutoReindexPause(repoPath: string): void;
|
|
120
|
+
export declare function scheduleReindex(repoPath: string): ScheduleReindexOutcome;
|
|
121
|
+
/** Boolean form of scheduleReindex (the freshness-note trigger). Never throws. */
|
|
6
122
|
export declare function maybeScheduleReindex(repoPath: string): boolean;
|
|
123
|
+
export declare const RECORDED_ANALYZE_MAX_AGE_MS: number;
|
|
124
|
+
/**
|
|
125
|
+
* True when status.json under codeIndexDir(repo) records an analyze that has
|
|
126
|
+
* not finished and whose pid is still alive -- e.g. one started by a PREVIOUS
|
|
127
|
+
* server instance that is still running. On Windows/Linux the gitnexus lock
|
|
128
|
+
* leaves no file, so this is the cross-process signal for such a run. A
|
|
129
|
+
* finished, pid-less, dead-pid or implausibly old record is not live. Never
|
|
130
|
+
* throws.
|
|
131
|
+
*/
|
|
132
|
+
export declare function isRecordedAnalyzeAlive(repoPath: string, now?: number): boolean;
|
|
133
|
+
export declare const FIRST_TICK_BOUND_MS = 8000;
|
|
134
|
+
/** Every code_reindex response carries the commit the index is built at (null when none/remote). */
|
|
135
|
+
export type CodeReindexResult = {
|
|
136
|
+
indexedCommit: string | null;
|
|
137
|
+
injectedBlockFiles?: string[];
|
|
138
|
+
} & CodeReindexOutcome;
|
|
139
|
+
export type CodeReindexOutcome = {
|
|
140
|
+
outcome: 'started';
|
|
141
|
+
pid: number | null;
|
|
142
|
+
lastLine: string;
|
|
143
|
+
lockHeld: boolean;
|
|
144
|
+
logPath: string;
|
|
145
|
+
} | {
|
|
146
|
+
outcome: 'up-to-date';
|
|
147
|
+
lastLine: string;
|
|
148
|
+
logPath: string;
|
|
149
|
+
} | {
|
|
150
|
+
outcome: 'starting';
|
|
151
|
+
firstTick: false;
|
|
152
|
+
pid: number | null;
|
|
153
|
+
note: string;
|
|
154
|
+
logPath: string;
|
|
155
|
+
} | {
|
|
156
|
+
outcome: 'already-running';
|
|
157
|
+
reason: 'already-running';
|
|
158
|
+
detail?: string;
|
|
159
|
+
status: AnalyzeStatus | null;
|
|
160
|
+
} | {
|
|
161
|
+
outcome: 'not-started';
|
|
162
|
+
reason: NotStartedReason | 'analyze-failed';
|
|
163
|
+
detail?: string;
|
|
164
|
+
logPath?: string;
|
|
165
|
+
};
|
|
166
|
+
/**
|
|
167
|
+
* Start (or report) an analyze for `repo` and return after the FIRST TICK:
|
|
168
|
+
* analyze lock held, process alive and at least one log line; or the run
|
|
169
|
+
* ended with 'Already up to date'. Never claims 'started' without a tick: a
|
|
170
|
+
* missing npx / gitnexus, or a run that dies before ticking, is a typed
|
|
171
|
+
* 'not-started'. If the bound elapses with the process alive but silent the
|
|
172
|
+
* outcome is 'starting' (firstTick false), still not 'started'.
|
|
173
|
+
*/
|
|
174
|
+
export declare function codeReindex(repo: string, boundMs?: number): Promise<CodeReindexResult>;
|
|
175
|
+
export interface CodeStatusResult {
|
|
176
|
+
repo: string;
|
|
177
|
+
/** status.json of the last analyze run for this folder, or null if none has run. */
|
|
178
|
+
analyze: AnalyzeStatus | null;
|
|
179
|
+
ready: boolean;
|
|
180
|
+
readiness: 'ready' | CodeIndexNotReadyState;
|
|
181
|
+
/** Why the index metadata disagrees with itself (readiness 'inconsistent'); null otherwise. */
|
|
182
|
+
inconsistency: string | null;
|
|
183
|
+
indexedCommit: string | null;
|
|
184
|
+
incrementalInProgress: boolean;
|
|
185
|
+
lockHeld: boolean;
|
|
186
|
+
/** analyze.log of the last run; null when no analyze has written one under this install. */
|
|
187
|
+
logPath: string | null;
|
|
188
|
+
/** Set when an automatic run failed and automatic rebuilds are paused until code_reindex. */
|
|
189
|
+
autoReindexPaused: AutoReindexPause | null;
|
|
190
|
+
/** Agent docs still carrying a gitnexus block from an earlier plain analyze; [] when clean. */
|
|
191
|
+
injectedBlockFiles: string[];
|
|
192
|
+
/** One-line WARN naming those files and the fix; null when clean. */
|
|
193
|
+
injectedBlockWarning: string | null;
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* status.json + live readiness + the indexed commit for `repo`. `readiness` is
|
|
197
|
+
* the result of THE readiness check (codeIndexReadiness), passed in by the
|
|
198
|
+
* caller so code_status and the code_* pre-flight can never disagree (it lives
|
|
199
|
+
* in a module that imports this one). Never throws on IO.
|
|
200
|
+
*/
|
|
201
|
+
export declare function codeStatus(repo: string, readiness: CodeIndexReadiness): CodeStatusResult;
|
|
7
202
|
//# sourceMappingURL=code-intelligence-reindex.d.ts.map
|