@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,644 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Per-member sprint-init probe (parent bug apra-fleet-b4g.51).
|
|
3
|
+
//
|
|
4
|
+
// At sprint init, for every sprint member and in this order, each step
|
|
5
|
+
// recorded independently (a failing step records its reason and one-line fix
|
|
6
|
+
// and the probe moves on):
|
|
7
|
+
//
|
|
8
|
+
// 0. resolve -- member_detail (format:'json') on the orchestrator's own
|
|
9
|
+
// session: the member's id, type and LLM provider. Not a
|
|
10
|
+
// kb_* / code_* tool, so the orchestrator session is the
|
|
11
|
+
// right one for it.
|
|
12
|
+
// 1. server -- REMOTE members only: is the member's own fleet server
|
|
13
|
+
// running? `apra-fleet status` on the member; when it
|
|
14
|
+
// reports stopped, `apra-fleet start`. Both command strings
|
|
15
|
+
// are built here by getSeCommands(target).wrapForMember for
|
|
16
|
+
// the member's {os, shell} -- no shell-level expansion.
|
|
17
|
+
// Local members share the orchestrator's server: skipped.
|
|
18
|
+
// 2. tools -- listTools(member) on the MEMBER session must list kb_*
|
|
19
|
+
// and code_* tools; then the member's recorded fleetMcp
|
|
20
|
+
// status is refreshed server-side through member_detail
|
|
21
|
+
// with refresh:true (the server re-probes the path a
|
|
22
|
+
// dispatched session actually uses -- for a claude member
|
|
23
|
+
// the per-session member config, so no per-folder entry is
|
|
24
|
+
// required -- heals what it can (registration on the
|
|
25
|
+
// member's own install, role-file grants) and RECORDS the
|
|
26
|
+
// result; see src/tools/member-detail.ts).
|
|
27
|
+
// 3. overrides -- the member is UNVERIFIED even when its member session
|
|
28
|
+
// lists the tools when: provider opencode
|
|
29
|
+
// (no-per-tool-deny: opencode cannot deny individual tools,
|
|
30
|
+
// engine-side because the server reports opencode
|
|
31
|
+
// available); provider agy (no-per-project-mcp); the
|
|
32
|
+
// refreshed fleetMcp is unavailable or flagged unverified
|
|
33
|
+
// (e.g. mcp-entry-missing: a provider that reads the
|
|
34
|
+
// per-folder MCP entry has none ending with ?member=<uuid>;
|
|
35
|
+
// role-agents-hide-member-tools: the role files a
|
|
36
|
+
// dispatched --agent <role> session loads filter the
|
|
37
|
+
// member tools out and could not be healed).
|
|
38
|
+
// 4. count -- kb_stats AS the member: totals.by_confidence.CONFIRMED.
|
|
39
|
+
// 5. code -- code_reindex AS the member, then code_status polled until
|
|
40
|
+
// the first tick or the bound (30 s by default) elapses.
|
|
41
|
+
// A code-intelligence "disabled" answer is `unavailable`,
|
|
42
|
+
// never ok; the bound elapsing is `timeout`, not fatal.
|
|
43
|
+
// 6. maintainer-- the kb_maintainer selection made at sprint setup is READ
|
|
44
|
+
// (never re-selected): which member maintains the probed
|
|
45
|
+
// member's repository.
|
|
46
|
+
//
|
|
47
|
+
// INSTALL CURRENCY (non-gating, part of step 2): after the fleetMcp refresh,
|
|
48
|
+
// a member whose install core version (fleetMcp.version) is older than the
|
|
49
|
+
// orchestrator's (member_detail server_version), or a REMOTE member that is
|
|
50
|
+
// its repository's kb_maintainer whose install does not accept
|
|
51
|
+
// `apra-fleet call --kb-maintainer` (opts.kbMaintainerCapability -- the
|
|
52
|
+
// member-call capability probe, cached per member), gets a
|
|
53
|
+
// member-fleet-outdated problem (step 'install') and a WARN. A version check
|
|
54
|
+
// alone misses the second case (the flag landed within one core version).
|
|
55
|
+
// Never gating: it does not change verified nor the first gating problem.
|
|
56
|
+
// Local members are never probed for the CLI flag.
|
|
57
|
+
//
|
|
58
|
+
// TRANSPORT RULE: every kb_* / code_* call goes through the injected
|
|
59
|
+
// memberCall (a member-scoped session). The orchestrator's callTool is used
|
|
60
|
+
// ONLY for member_detail; this module never calls a kb_* or code_* tool on it.
|
|
61
|
+
//
|
|
62
|
+
// Never throws, never blocks: probeAll() returns one record per member even
|
|
63
|
+
// when every step of every member fails.
|
|
64
|
+
// =============================================================================
|
|
65
|
+
|
|
66
|
+
import { resolveMemberTarget } from './member-target.mjs';
|
|
67
|
+
import { getSeCommands } from './se-os-commands.mjs';
|
|
68
|
+
import { resultText } from './mcp-result.mjs';
|
|
69
|
+
|
|
70
|
+
/** Log prefix of every init line. */
|
|
71
|
+
export const MEMBER_INIT_LOG_PREFIX = '[member-init]';
|
|
72
|
+
|
|
73
|
+
/** publishState namespace for the per-member init records (viewer). */
|
|
74
|
+
export const MEMBER_INIT_STATE_NAMESPACE = 'memberInit';
|
|
75
|
+
|
|
76
|
+
/** Upper bound on waiting for the first code-index tick. */
|
|
77
|
+
export const CODE_INDEX_FIRST_TICK_BOUND_MS = 30000;
|
|
78
|
+
|
|
79
|
+
/** Delay between code_status polls. */
|
|
80
|
+
export const CODE_STATUS_POLL_MS = 2000;
|
|
81
|
+
|
|
82
|
+
/** codeIndex states. */
|
|
83
|
+
export const CODE_INDEX_STATES = Object.freeze({
|
|
84
|
+
OK: 'ok',
|
|
85
|
+
UNAVAILABLE: 'unavailable',
|
|
86
|
+
TIMEOUT: 'timeout',
|
|
87
|
+
FAILED: 'failed',
|
|
88
|
+
});
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* One-line fixes, keyed by machine-readable reason. Every non-verified record
|
|
92
|
+
* (and every recorded step failure) carries one of these.
|
|
93
|
+
*/
|
|
94
|
+
export const MEMBER_INIT_FIXES = Object.freeze({
|
|
95
|
+
'member-unresolved': 'register the member with the fleet (member_detail returned no id for it), then rerun the sprint',
|
|
96
|
+
'member-offline': 'bring the member back online (member_detail reports it offline), then rerun the sprint',
|
|
97
|
+
'server-status-failed': "'apra-fleet status' failed on the member, so its fleet install is missing or broken: run update_member with fleet_install \"auto\" for the member (or install apra-fleet on it by hand), then rerun the sprint",
|
|
98
|
+
'server-status-unreadable': "'apra-fleet status' on the member reported neither running nor stopped: run it by hand on the member and read its output, or run update_member with fleet_install \"auto\" for the member",
|
|
99
|
+
'server-start-failed': "start the member's fleet server by hand ('apra-fleet start' on the member) and read its log, then rerun the sprint",
|
|
100
|
+
'member-tools-failed': "the member session could not list tools for a reason not recognized as an old install or a refused session (see the problem detail): read it, correct that cause on the member, then rerun the sprint",
|
|
101
|
+
'member-fleet-outdated': "the member's fleet install is older than the orchestrator build (or cannot open the kb_maintainer session): run update_member with fleet_install \"auto\" for the member to upgrade it to the orchestrator build",
|
|
102
|
+
'member-fleet-too-old': "the member's apra-fleet predates member mode (it has no 'call' command): run update_member with fleet_install \"auto\" for the member to upgrade it to the orchestrator version, then rerun the sprint",
|
|
103
|
+
'member-secret-refused': "the member server refused the member access secret (HTTP 401, E-MEMBER-SECRET): the member-access.key file in the member install's own data directory is missing or does not match the one the server holds, usually because the sprint is running as a different user or with a different data directory than the member install; run the member session as the install's own user with the install's own data dir (or reinstall the member so member-access.key is regenerated), then rerun the sprint",
|
|
104
|
+
'member-session-refused': "the member server refused the member session (HTTP 403, the member id is not registered with the server the member talks to): run update_member with fleet_install \"auto\" for the member so it registers itself, then rerun the sprint",
|
|
105
|
+
'no-llm-provider': "the member has provider none but is assigned an LLM role in this sprint: set a real llm_provider on it with update_member, or take it out of the LLM roles of the role map, then rerun the sprint",
|
|
106
|
+
'member-tools-missing': "the member session does not list kb_* and code_* tools: run update_member with fleet_install \"auto\" for the member to upgrade its fleet install, then rerun the sprint",
|
|
107
|
+
'fleet-mcp-refresh-failed': 'member_detail refresh:true failed for the member, so its fleet MCP status is unknown: read the reported error, correct that cause, then re-probe with member_detail refresh:true',
|
|
108
|
+
'mcp-entry-missing': 'run compose_permissions for the member so its per-folder fleet MCP entry ends with ?member=<uuid>, then re-probe with member_detail refresh:true',
|
|
109
|
+
'role-agents-hide-member-tools': "the role agent files the member's CLI loads (--agent <role>) do not grant the kb_* and code_* tools and the automatic rewrite failed: run update_member for a remote member, or make the role files writable (or re-install apra-fleet on the orchestrator) for a local one, then re-probe with member_detail refresh:true",
|
|
110
|
+
'no-per-tool-deny': 'opencode cannot deny individual tools, so this member is never verified; use a claude member for verified knowledge-bank access',
|
|
111
|
+
'no-per-project-mcp': 'agy has no per-project MCP config, so this member is never verified; use a claude member for verified knowledge-bank access',
|
|
112
|
+
'fleet-mcp-unavailable': "the member's fleetMcp status is unavailable for a cause the server did not name: read member_detail fleetMcp.detail, correct that cause, then re-probe with member_detail refresh:true",
|
|
113
|
+
'confirmed-count-unreadable': 'kb_stats failed on the member session, so the knowledge-bank entry count is unknown: run kb_stats on the member and read its error',
|
|
114
|
+
'code-intel-disabled': 'code intelligence is off for this member; enable the gitnexus provider to get a code index',
|
|
115
|
+
'code-provider-not-supported': "the member's code-intelligence provider manages its own index; nothing to do unless gitnexus is wanted",
|
|
116
|
+
'code-index-timeout': 'the first code-index tick did not arrive within the bound; check code_status on the member (the index keeps building)',
|
|
117
|
+
'code-intel-npx-missing': "npx or node is not on the apra-fleet service PATH, so code intelligence is unavailable: reinstall the service so it records node/npx (re-run the fleet installer on the host), or add node and npx to the service PATH and restart the server, then rerun code_reindex",
|
|
118
|
+
'code-index-failed': 'code_reindex failed on the member: read its analyze log (code_status logPath) and rerun code_reindex',
|
|
119
|
+
'code-index-gitnexus-too-old': "the member's gitnexus is too old to support --index-only: upgrade gitnexus (npx -y gitnexus@latest analyze --index-only) or clear the npx cache (npm cache clean --force) on the member, then rerun code_reindex",
|
|
120
|
+
'code-index-unrecognized': 'code_reindex returned an unrecognized answer: run update_member with fleet_install "auto" for the member so its fleet install is current',
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
/** One-line fix for a reason (falls back to the fleetMcp generic fix). */
|
|
124
|
+
export function fixFor(reason) {
|
|
125
|
+
return MEMBER_INIT_FIXES[reason] || MEMBER_INIT_FIXES['fleet-mcp-unavailable'];
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* @typedef {Object} MemberInitProblem
|
|
130
|
+
* @property {string} step resolve | server | tools | fleetMcp | provider | count | code
|
|
131
|
+
* @property {string} reason machine-readable reason (a MEMBER_INIT_FIXES key or a server fleetMcp reason)
|
|
132
|
+
* @property {string} fix one human-readable line
|
|
133
|
+
* @property {string} [detail]
|
|
134
|
+
*/
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* The per-member init record. STABLE OUTPUT CONTRACT: consumed by the
|
|
138
|
+
* KNOWLEDGE BANK injection (only verified=true members count as verified) and
|
|
139
|
+
* by the lower-quality-of-service visibility work (viewer, banner).
|
|
140
|
+
*
|
|
141
|
+
* @typedef {Object} MemberInitRecord
|
|
142
|
+
* @property {string} member member name
|
|
143
|
+
* @property {string|null} memberId
|
|
144
|
+
* @property {string|null} type local | remote | relay
|
|
145
|
+
* @property {string|null} provider the member's LLM provider (claude, opencode, agy, ...)
|
|
146
|
+
* @property {boolean} verified true only when every verification check passed
|
|
147
|
+
* @property {'up'|'started'|'skipped'|'failed'} server step 1 outcome
|
|
148
|
+
* @property {{state: string, reason: string|null}|null} fleetMcp refreshed fleetMcp status
|
|
149
|
+
* @property {boolean|null} kbTools member session lists kb_* tools (null when not checked)
|
|
150
|
+
* @property {boolean|null} codeTools member session lists code_* tools (null when not checked)
|
|
151
|
+
* @property {number|null} confirmedCount CONFIRMED bible entries (null when unreadable)
|
|
152
|
+
* @property {'ok'|'unavailable'|'timeout'|'failed'} codeIndex
|
|
153
|
+
* @property {string|null} codeIndexReason null when codeIndex is ok
|
|
154
|
+
* @property {string[]} warnings non-gating one-line WARNs (e.g. a work tree carrying a previously injected gitnexus block)
|
|
155
|
+
* @property {string|null} repo normalized repository of the member's work folder
|
|
156
|
+
* @property {string|null} maintainer kb_maintainer of that repository (from the sprint-setup selection)
|
|
157
|
+
* @property {string|null} reason machine-readable; null when verified
|
|
158
|
+
* @property {string|null} fix one human-readable line; null when verified
|
|
159
|
+
* @property {MemberInitProblem[]} problems every recorded step failure, in step order
|
|
160
|
+
* @property {string[]} steps the steps actually run, in order
|
|
161
|
+
*/
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* The members that run an LLM role in this sprint. A member named ONLY in the
|
|
165
|
+
* backlog role list (roleMap.backlog) runs no LLM role: it only runs bd
|
|
166
|
+
* commands, so probing it and counting it as unverified is a false alarm.
|
|
167
|
+
* A member named in any other role list, or in no list at all, is kept.
|
|
168
|
+
* Applicability comes from the role assignment, not from the provider name.
|
|
169
|
+
*
|
|
170
|
+
* @param {string[]} members
|
|
171
|
+
* @param {Record<string,string[]>|null|undefined} roleMap
|
|
172
|
+
* @returns {string[]}
|
|
173
|
+
*/
|
|
174
|
+
export function llmRoleMembersOf(members, roleMap) {
|
|
175
|
+
const list = Array.isArray(members) ? members : [];
|
|
176
|
+
if (!roleMap || typeof roleMap !== 'object') return list.slice();
|
|
177
|
+
const backlog = new Set(Array.isArray(roleMap.backlog) ? roleMap.backlog : []);
|
|
178
|
+
const otherRole = new Set();
|
|
179
|
+
for (const [role, names] of Object.entries(roleMap)) {
|
|
180
|
+
if (role === 'backlog' || !Array.isArray(names)) continue;
|
|
181
|
+
for (const m of names) otherRole.add(m);
|
|
182
|
+
}
|
|
183
|
+
return list.filter((m) => !backlog.has(m) || otherRole.has(m));
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
function errText(err) {
|
|
187
|
+
return err && err.message ? err.message : String(err);
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/** Parse a tool result (MCP content text, a raw JSON string, or an object). */
|
|
191
|
+
export function parseToolJson(result) {
|
|
192
|
+
if (result && typeof result === 'string') { try { return JSON.parse(result); } catch { return null; } }
|
|
193
|
+
if (result && Array.isArray(result.content)) {
|
|
194
|
+
const text = resultText(result);
|
|
195
|
+
if (!text) return null;
|
|
196
|
+
try { return JSON.parse(text); } catch { return null; }
|
|
197
|
+
}
|
|
198
|
+
return (result && typeof result === 'object') ? result : null;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** Tool names out of a tools/list answer ({tools:[{name}]} or a bare array). */
|
|
202
|
+
export function toolNamesOf(list) {
|
|
203
|
+
const tools = Array.isArray(list) ? list : (list && Array.isArray(list.tools) ? list.tools : []);
|
|
204
|
+
return tools.map((t) => (typeof t === 'string' ? t : (t && t.name))).filter((n) => typeof n === 'string');
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
/** CONFIRMED count out of a kb_stats answer, or null. */
|
|
208
|
+
export function confirmedCountOf(stats) {
|
|
209
|
+
const n = stats && stats.totals && stats.totals.by_confidence && stats.totals.by_confidence.CONFIRMED;
|
|
210
|
+
return typeof n === 'number' && Number.isFinite(n) ? n : null;
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/** True when a code tool answer or error names a missing npx/node on the server PATH. */
|
|
214
|
+
function isNpxMissingText(text) {
|
|
215
|
+
return /(?:npx|node)[^.]{0,40} was not found on the apra-fleet server's PATH/i.test(String(text || ''));
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
function isDisabledError(err) {
|
|
219
|
+
return /E-CODE-INTEL-DISABLED|code intelligence is (?:off|disabled)|\bdisabled\b/i.test(errText(err));
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Classify a code_reindex answer.
|
|
224
|
+
* @returns {{ state: 'ok'|'unavailable'|'failed'|'pending', reason: string|null, detail?: string }}
|
|
225
|
+
*/
|
|
226
|
+
export function classifyReindex(res) {
|
|
227
|
+
if (!res || typeof res !== 'object' || typeof res.outcome !== 'string') {
|
|
228
|
+
return { state: 'failed', reason: 'code-index-unrecognized' };
|
|
229
|
+
}
|
|
230
|
+
if (/disabled/i.test(String(res.reason || '')) || res.disabled === true) return { state: 'unavailable', reason: 'code-intel-disabled' };
|
|
231
|
+
switch (res.outcome) {
|
|
232
|
+
case 'started':
|
|
233
|
+
case 'up-to-date':
|
|
234
|
+
case 'already-running':
|
|
235
|
+
return { state: 'ok', reason: null };
|
|
236
|
+
case 'starting':
|
|
237
|
+
return { state: 'pending', reason: null };
|
|
238
|
+
case 'not-started':
|
|
239
|
+
if (res.reason === 'npx-not-found' || isNpxMissingText(res.detail)) return { state: 'unavailable', reason: 'code-intel-npx-missing', detail: res.detail };
|
|
240
|
+
if (res.reason === 'provider-not-supported') return { state: 'unavailable', reason: 'code-provider-not-supported', detail: res.detail };
|
|
241
|
+
if (res.reason === 'gitnexus-too-old') return { state: 'failed', reason: 'code-index-gitnexus-too-old', detail: res.detail };
|
|
242
|
+
return { state: 'failed', reason: 'code-index-failed', detail: [res.reason, res.detail].filter(Boolean).join(': ') };
|
|
243
|
+
default:
|
|
244
|
+
return { state: 'failed', reason: 'code-index-unrecognized' };
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Classify a code_status answer polled after a 'starting' reindex.
|
|
250
|
+
* @returns {{ state: 'ok'|'unavailable'|'failed'|'pending', reason: string|null, detail?: string }}
|
|
251
|
+
*/
|
|
252
|
+
export function classifyStatus(res) {
|
|
253
|
+
if (!res || typeof res !== 'object') return { state: 'pending', reason: null };
|
|
254
|
+
if (res.outcome === 'not-started' && res.reason === 'provider-not-supported') return { state: 'unavailable', reason: 'code-provider-not-supported' };
|
|
255
|
+
const a = res.analyze && typeof res.analyze === 'object' ? res.analyze : null;
|
|
256
|
+
if (a && a.phase === 'done' && a.result === 'failed' && a.failureCause === 'gitnexus-too-old') {
|
|
257
|
+
return { state: 'failed', reason: 'code-index-gitnexus-too-old', detail: a.lastLine || 'gitnexus rejected --index-only' };
|
|
258
|
+
}
|
|
259
|
+
if (a && a.phase === 'done' && a.result === 'failed') return { state: 'failed', reason: 'code-index-failed', detail: a.lastLine || 'analyze failed' };
|
|
260
|
+
if (res.ready === true || res.lockHeld === true) return { state: 'ok', reason: null };
|
|
261
|
+
if (a && (a.phase === 'done' || (typeof a.lineCount === 'number' && a.lineCount > 0) || a.lockHeld === true)) return { state: 'ok', reason: null };
|
|
262
|
+
return { state: 'pending', reason: null };
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/** Classify the `apra-fleet status` output: 'running' | 'stopped' | null. */
|
|
266
|
+
export function parseServerState(text) {
|
|
267
|
+
const m = /State:\s*(running|stopped)/i.exec(String(text || ''));
|
|
268
|
+
return m ? m[1].toLowerCase() : null;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/** [major, minor, patch] of a version string ("v0.4.4_abc" -> [0, 4, 4]), or null. */
|
|
272
|
+
export function coreVersionOf(version) {
|
|
273
|
+
const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(String(version || '').trim());
|
|
274
|
+
return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
/** True when `memberVersion`'s core is older than `serverVersion`'s (false when either is unparseable). */
|
|
278
|
+
export function isCoreOlder(memberVersion, serverVersion) {
|
|
279
|
+
const a = coreVersionOf(memberVersion);
|
|
280
|
+
const b = coreVersionOf(serverVersion);
|
|
281
|
+
if (!a || !b) return false;
|
|
282
|
+
for (let i = 0; i < 3; i++) if (a[i] !== b[i]) return a[i] < b[i];
|
|
283
|
+
return false;
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
/** The one init line logged per member. */
|
|
287
|
+
export function formatMemberInitLine(rec) {
|
|
288
|
+
const warnSuffix = Array.isArray(rec.warnings) && rec.warnings.length > 0 ? `; WARN: ${rec.warnings.join(' | ')}` : '';
|
|
289
|
+
if (rec.verified) {
|
|
290
|
+
const count = rec.confirmedCount === null ? 'unreadable' : String(rec.confirmedCount);
|
|
291
|
+
const code = rec.codeIndex === CODE_INDEX_STATES.OK ? 'ok' : `${rec.codeIndex} (${rec.codeIndexReason}: ${fixFor(rec.codeIndexReason)})`;
|
|
292
|
+
const maint = rec.maintainer ? `; kb_maintainer: '${rec.maintainer}'` : '';
|
|
293
|
+
return `${MEMBER_INIT_LOG_PREFIX} OK member '${rec.member}': verified (kb_* and code_* tools on its member session); CONFIRMED entries: ${count}; code index: ${code}${maint}${warnSuffix}`;
|
|
294
|
+
}
|
|
295
|
+
return `${MEMBER_INIT_LOG_PREFIX} WARN member '${rec.member}': unverified -- reason: ${rec.reason}; fix: ${rec.fix}${warnSuffix}`;
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
/**
|
|
299
|
+
* @param {{
|
|
300
|
+
* members: string[],
|
|
301
|
+
* callTool?: (name: string, args: object) => Promise<any>, orchestrator session -- member_detail ONLY
|
|
302
|
+
* memberCall?: (member: object, tool: string, args: object) => Promise<any>,
|
|
303
|
+
* listTools?: (member: object) => Promise<any>,
|
|
304
|
+
* fleetApi?: { executeCommand: Function }, remote server start-if-down
|
|
305
|
+
* resolveTarget?: Function, defaults to resolveMemberTarget
|
|
306
|
+
* kbMaintainers?: { maintainerForMember?: Function, repoOf?: Function } | (() => object),
|
|
307
|
+
* kbMaintainerCapability?: (member: object) => Promise<'supported'|'unsupported'|'inconclusive'>,
|
|
308
|
+
* remote kb_maintainer CLI-flag probe
|
|
309
|
+
* now?: () => number,
|
|
310
|
+
* sleep?: (ms: number) => Promise<void>,
|
|
311
|
+
* codeIndexBoundMs?: number,
|
|
312
|
+
* pollMs?: number,
|
|
313
|
+
* log?: Function,
|
|
314
|
+
* }} opts
|
|
315
|
+
* @returns {{ probeMember(name: string): Promise<MemberInitRecord>, probeAll(): Promise<MemberInitRecord[]> }}
|
|
316
|
+
*/
|
|
317
|
+
export function createMemberInitProbe(opts = {}) {
|
|
318
|
+
const {
|
|
319
|
+
members: allMembers = [],
|
|
320
|
+
roleMap = null,
|
|
321
|
+
callTool,
|
|
322
|
+
memberCall,
|
|
323
|
+
listTools,
|
|
324
|
+
fleetApi,
|
|
325
|
+
kbMaintainerCapability,
|
|
326
|
+
log = () => {},
|
|
327
|
+
codeIndexBoundMs = CODE_INDEX_FIRST_TICK_BOUND_MS,
|
|
328
|
+
pollMs = CODE_STATUS_POLL_MS,
|
|
329
|
+
} = opts;
|
|
330
|
+
const members = llmRoleMembersOf(allMembers, roleMap);
|
|
331
|
+
const resolveTarget = opts.resolveTarget || resolveMemberTarget;
|
|
332
|
+
const now = opts.now || (() => Date.now());
|
|
333
|
+
const sleep = opts.sleep || ((ms) => new Promise((r) => setTimeout(r, ms)));
|
|
334
|
+
const maintainers = () => (typeof opts.kbMaintainers === 'function' ? opts.kbMaintainers() : opts.kbMaintainers) || null;
|
|
335
|
+
|
|
336
|
+
async function memberDetail(name, extra = {}) {
|
|
337
|
+
if (typeof callTool !== 'function') throw new Error('no orchestrator session to read member_detail');
|
|
338
|
+
const res = await callTool('member_detail', { member_name: name, format: 'json', ...extra });
|
|
339
|
+
if (res && res.isError) throw new Error(resultText(res) || 'member_detail returned an error');
|
|
340
|
+
const d = parseToolJson(res);
|
|
341
|
+
return d && d.member && typeof d.member === 'object' ? { ...d.member, ...d } : d;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
async function runCommand(record, script) {
|
|
345
|
+
const target = await resolveTarget({ fleetApi, member: record.name, log });
|
|
346
|
+
const command = getSeCommands(target).wrapForMember(script);
|
|
347
|
+
const res = await fleetApi.executeCommand({ member_id: record.id, command });
|
|
348
|
+
return { ok: !(res && res.isError), text: resultText(res) };
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
async function ensureServer(record, rec, problem) {
|
|
352
|
+
if (String(record.type || '').toLowerCase() === 'local') {
|
|
353
|
+
rec.server = 'skipped';
|
|
354
|
+
return;
|
|
355
|
+
}
|
|
356
|
+
rec.steps.push('server');
|
|
357
|
+
if (!fleetApi || typeof fleetApi.executeCommand !== 'function') {
|
|
358
|
+
rec.server = 'failed';
|
|
359
|
+
problem('server', 'server-status-failed', 'no member command channel');
|
|
360
|
+
return;
|
|
361
|
+
}
|
|
362
|
+
try {
|
|
363
|
+
const status = await runCommand(record, 'apra-fleet status');
|
|
364
|
+
const state = status.ok ? parseServerState(status.text) : null;
|
|
365
|
+
if (!status.ok) {
|
|
366
|
+
rec.server = 'failed';
|
|
367
|
+
problem('server', 'server-status-failed', status.text);
|
|
368
|
+
return;
|
|
369
|
+
}
|
|
370
|
+
if (state === 'running') {
|
|
371
|
+
rec.server = 'up';
|
|
372
|
+
return;
|
|
373
|
+
}
|
|
374
|
+
if (state !== 'stopped') {
|
|
375
|
+
rec.server = 'failed';
|
|
376
|
+
problem('server', 'server-status-unreadable', status.text);
|
|
377
|
+
return;
|
|
378
|
+
}
|
|
379
|
+
const started = await runCommand(record, 'apra-fleet start');
|
|
380
|
+
if (!started.ok) {
|
|
381
|
+
rec.server = 'failed';
|
|
382
|
+
problem('server', 'server-start-failed', started.text);
|
|
383
|
+
return;
|
|
384
|
+
}
|
|
385
|
+
rec.server = 'started';
|
|
386
|
+
} catch (err) {
|
|
387
|
+
rec.server = 'failed';
|
|
388
|
+
problem('server', 'server-status-failed', errText(err));
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
async function checkTools(record, rec, problem) {
|
|
393
|
+
rec.steps.push('tools');
|
|
394
|
+
try {
|
|
395
|
+
if (typeof listTools !== 'function') throw new Error('no member session channel');
|
|
396
|
+
const names = toolNamesOf(parseToolJson(await listTools(record)));
|
|
397
|
+
rec.kbTools = names.some((n) => n.startsWith('kb_'));
|
|
398
|
+
rec.codeTools = names.some((n) => n.startsWith('code_'));
|
|
399
|
+
if (!rec.kbTools || !rec.codeTools) {
|
|
400
|
+
const missing = [!rec.kbTools && 'kb_*', !rec.codeTools && 'code_*'].filter(Boolean).join(' and ');
|
|
401
|
+
problem('tools', 'member-tools-missing', `member session tools/list lacks ${missing} (got ${names.length} tools)`);
|
|
402
|
+
}
|
|
403
|
+
} catch (err) {
|
|
404
|
+
const text = errText(err);
|
|
405
|
+
if (/unknown (?:option|command) '?call\b/i.test(text)) problem('tools', 'member-fleet-too-old', text);
|
|
406
|
+
else if (/E-MEMBER-SECRET|HTTP 401/i.test(text)) problem('tools', 'member-secret-refused', text);
|
|
407
|
+
else if (/E-MEMBER-FORBIDDEN|HTTP 403|server refused member/i.test(text)) problem('tools', 'member-session-refused', text);
|
|
408
|
+
else problem('tools', 'member-tools-failed', text);
|
|
409
|
+
}
|
|
410
|
+
// Record the member's fleetMcp status from a fresh server-side probe.
|
|
411
|
+
rec.steps.push('fleetMcp');
|
|
412
|
+
try {
|
|
413
|
+
const d = await memberDetail(record.name, { refresh: true });
|
|
414
|
+
const f = d && d.fleetMcp && typeof d.fleetMcp === 'object' ? d.fleetMcp : null;
|
|
415
|
+
rec.fleetMcp = f ? { state: String(f.state || 'unavailable'), reason: f.reason ? String(f.reason) : null } : null;
|
|
416
|
+
if (!f) {
|
|
417
|
+
problem('fleetMcp', 'fleet-mcp-refresh-failed', 'member_detail refresh:true returned no fleetMcp status');
|
|
418
|
+
} else if (f.state !== 'available' || f.unverified === true) {
|
|
419
|
+
const reason = f.reason ? String(f.reason) : 'fleet-mcp-unavailable';
|
|
420
|
+
// The server owns the remedy text for its own reasons: forward it.
|
|
421
|
+
const serverFix = typeof d.fleetMcpFix === 'string' && d.fleetMcpFix.trim() ? d.fleetMcpFix.trim() : null;
|
|
422
|
+
problem('fleetMcp', reason, f.detail ? String(f.detail) : undefined, serverFix);
|
|
423
|
+
}
|
|
424
|
+
// Name the version seen when the member's install predates member mode.
|
|
425
|
+
const ver = f && f.version ? String(f.version).replace(/^v/, '') : null;
|
|
426
|
+
const old = rec.problems.find((p) => p.reason === 'member-fleet-too-old');
|
|
427
|
+
if (old && ver) old.fix = `${old.fix} (version seen on the member: ${ver})`;
|
|
428
|
+
await checkInstallCurrency(record, rec, problem, f && f.version ? String(f.version) : null, d && d.server_version ? String(d.server_version) : null);
|
|
429
|
+
} catch (err) {
|
|
430
|
+
problem('fleetMcp', 'fleet-mcp-refresh-failed', errText(err));
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
|
|
434
|
+
/**
|
|
435
|
+
* Non-gating: a member install older than the orchestrator, or a remote
|
|
436
|
+
* kb_maintainer install that cannot open the kb_maintainer session, is
|
|
437
|
+
* reported as member-fleet-outdated (problem step 'install' plus a WARN)
|
|
438
|
+
* before any maintainer call fails mid-sprint. Never throws.
|
|
439
|
+
*/
|
|
440
|
+
async function checkInstallCurrency(record, rec, problem, memberVersion, serverVersion) {
|
|
441
|
+
const causes = [];
|
|
442
|
+
if (memberVersion && serverVersion && isCoreOlder(memberVersion, serverVersion)) {
|
|
443
|
+
causes.push('its version is older than the orchestrator');
|
|
444
|
+
}
|
|
445
|
+
const isRemote = String(record.type || '').toLowerCase() !== 'local';
|
|
446
|
+
if (isRemote && rec.maintainer === record.name && typeof kbMaintainerCapability === 'function') {
|
|
447
|
+
let verdict = 'inconclusive';
|
|
448
|
+
try { verdict = await kbMaintainerCapability(record); } catch { /* inconclusive: no warning */ }
|
|
449
|
+
if (verdict === 'unsupported') causes.push("it is this repository's kb_maintainer and its call verb does not accept --kb-maintainer");
|
|
450
|
+
}
|
|
451
|
+
if (causes.length === 0) return;
|
|
452
|
+
const seen = `member version ${memberVersion || 'unknown'}, orchestrator version ${serverVersion || 'unknown'}`;
|
|
453
|
+
const fix = `${fixFor('member-fleet-outdated')} (${seen})`;
|
|
454
|
+
problem('install', 'member-fleet-outdated', causes.join('; '), fix);
|
|
455
|
+
rec.warnings.push(`member-fleet-outdated: ${causes.join('; ')}; fix: ${fix}`);
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
async function readCount(record, rec, problem) {
|
|
459
|
+
rec.steps.push('count');
|
|
460
|
+
try {
|
|
461
|
+
if (typeof memberCall !== 'function') throw new Error('no member session channel');
|
|
462
|
+
rec.confirmedCount = confirmedCountOf(parseToolJson(await memberCall(record, 'kb_stats', {})));
|
|
463
|
+
if (rec.confirmedCount === null) problem('count', 'confirmed-count-unreadable', 'kb_stats answer carried no totals.by_confidence.CONFIRMED');
|
|
464
|
+
} catch (err) {
|
|
465
|
+
problem('count', 'confirmed-count-unreadable', errText(err));
|
|
466
|
+
}
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
async function indexCode(record, rec, problem) {
|
|
470
|
+
rec.steps.push('code');
|
|
471
|
+
const setCode = (state, reason, detail) => {
|
|
472
|
+
rec.codeIndex = state;
|
|
473
|
+
rec.codeIndexReason = reason;
|
|
474
|
+
if (reason) problem('code', reason, detail);
|
|
475
|
+
};
|
|
476
|
+
const deadline = now() + codeIndexBoundMs;
|
|
477
|
+
let verdict;
|
|
478
|
+
try {
|
|
479
|
+
if (typeof memberCall !== 'function') throw new Error('no member session channel');
|
|
480
|
+
const answer = parseToolJson(await memberCall(record, 'code_reindex', {}));
|
|
481
|
+
verdict = classifyReindex(answer);
|
|
482
|
+
// Detection only (the member's own server reads its work tree): a
|
|
483
|
+
// block left by an earlier plain analyze run is reported, never edited.
|
|
484
|
+
const dirty = answer && Array.isArray(answer.injectedBlockFiles) ? answer.injectedBlockFiles.filter((f) => typeof f === 'string') : [];
|
|
485
|
+
if (dirty.length > 0) rec.warnings.push(`${dirty.join(', ')} carries a gitnexus block injected by an earlier plain 'gitnexus analyze' run; fix: remove the block between <!-- gitnexus:start --> and <!-- gitnexus:end --> and commit`);
|
|
486
|
+
} catch (err) {
|
|
487
|
+
if (isDisabledError(err)) return setCode(CODE_INDEX_STATES.UNAVAILABLE, 'code-intel-disabled', errText(err));
|
|
488
|
+
if (isNpxMissingText(errText(err))) return setCode(CODE_INDEX_STATES.UNAVAILABLE, 'code-intel-npx-missing', errText(err));
|
|
489
|
+
return setCode(CODE_INDEX_STATES.FAILED, 'code-index-failed', errText(err));
|
|
490
|
+
}
|
|
491
|
+
while (verdict.state === 'pending') {
|
|
492
|
+
if (now() >= deadline) return setCode(CODE_INDEX_STATES.TIMEOUT, 'code-index-timeout', `no first tick within ${Math.round(codeIndexBoundMs / 1000)}s`);
|
|
493
|
+
await sleep(Math.min(pollMs, Math.max(0, deadline - now())));
|
|
494
|
+
if (now() >= deadline) return setCode(CODE_INDEX_STATES.TIMEOUT, 'code-index-timeout', `no first tick within ${Math.round(codeIndexBoundMs / 1000)}s`);
|
|
495
|
+
try {
|
|
496
|
+
verdict = classifyStatus(parseToolJson(await memberCall(record, 'code_status', {})));
|
|
497
|
+
} catch (err) {
|
|
498
|
+
if (isDisabledError(err)) return setCode(CODE_INDEX_STATES.UNAVAILABLE, 'code-intel-disabled', errText(err));
|
|
499
|
+
if (isNpxMissingText(errText(err))) return setCode(CODE_INDEX_STATES.UNAVAILABLE, 'code-intel-npx-missing', errText(err));
|
|
500
|
+
return setCode(CODE_INDEX_STATES.FAILED, 'code-index-failed', errText(err));
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
if (verdict.state === 'ok') return setCode(CODE_INDEX_STATES.OK, null);
|
|
504
|
+
if (verdict.state === 'unavailable') return setCode(CODE_INDEX_STATES.UNAVAILABLE, verdict.reason, verdict.detail);
|
|
505
|
+
return setCode(CODE_INDEX_STATES.FAILED, verdict.reason || 'code-index-failed', verdict.detail);
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
function recordMaintainer(name, rec) {
|
|
509
|
+
try {
|
|
510
|
+
const sel = maintainers();
|
|
511
|
+
if (!sel) return;
|
|
512
|
+
if (typeof sel.repoOf === 'function') rec.repo = sel.repoOf(name) || null;
|
|
513
|
+
const m = typeof sel.maintainerForMember === 'function' ? sel.maintainerForMember(name) : null;
|
|
514
|
+
rec.maintainer = m && m.member ? m.member : null;
|
|
515
|
+
} catch { /* informational only */ }
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
/** Provider overrides: never verified regardless of what the session lists. */
|
|
519
|
+
function providerOverride(provider) {
|
|
520
|
+
const p = String(provider || '').toLowerCase();
|
|
521
|
+
if (p === 'opencode') return 'no-per-tool-deny';
|
|
522
|
+
if (p === 'agy') return 'no-per-project-mcp';
|
|
523
|
+
if (p === 'none') return 'no-llm-provider';
|
|
524
|
+
return null;
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
async function probeMember(name) {
|
|
528
|
+
/** @type {MemberInitRecord} */
|
|
529
|
+
const rec = {
|
|
530
|
+
member: name, memberId: null, type: null, provider: null,
|
|
531
|
+
verified: false, server: 'skipped', fleetMcp: null,
|
|
532
|
+
kbTools: null, codeTools: null, confirmedCount: null,
|
|
533
|
+
codeIndex: CODE_INDEX_STATES.FAILED, codeIndexReason: null,
|
|
534
|
+
repo: null, maintainer: null, warnings: [],
|
|
535
|
+
reason: null, fix: null, problems: [], steps: [],
|
|
536
|
+
};
|
|
537
|
+
const problem = (step, reason, detail, fix) => {
|
|
538
|
+
rec.problems.push({ step, reason, fix: fix || fixFor(reason), ...(detail ? { detail: String(detail).slice(0, 300) } : {}) });
|
|
539
|
+
};
|
|
540
|
+
try {
|
|
541
|
+
recordMaintainer(name, rec);
|
|
542
|
+
rec.steps.push('resolve');
|
|
543
|
+
let d = null;
|
|
544
|
+
try {
|
|
545
|
+
d = await memberDetail(name);
|
|
546
|
+
} catch (err) {
|
|
547
|
+
problem('resolve', 'member-unresolved', errText(err));
|
|
548
|
+
}
|
|
549
|
+
const id = d && typeof d.id === 'string' && d.id.length > 0 ? d.id : null;
|
|
550
|
+
if (!id) {
|
|
551
|
+
if (rec.problems.length === 0) problem('resolve', 'member-unresolved');
|
|
552
|
+
rec.codeIndexReason = 'member-unresolved';
|
|
553
|
+
return finish(rec);
|
|
554
|
+
}
|
|
555
|
+
rec.memberId = id;
|
|
556
|
+
rec.type = typeof d.type === 'string' ? d.type : null;
|
|
557
|
+
rec.provider = typeof d.llmProvider === 'string' ? d.llmProvider : null;
|
|
558
|
+
const override = providerOverride(rec.provider);
|
|
559
|
+
if (override) problem('provider', override, `provider ${rec.provider}`);
|
|
560
|
+
if (d.offline === true) {
|
|
561
|
+
problem('resolve', 'member-offline', d.connectivity && d.connectivity.error);
|
|
562
|
+
rec.codeIndexReason = 'member-offline';
|
|
563
|
+
return finish(rec);
|
|
564
|
+
}
|
|
565
|
+
const record = { id, name, type: rec.type || undefined };
|
|
566
|
+
await ensureServer(record, rec, problem);
|
|
567
|
+
await checkTools(record, rec, problem);
|
|
568
|
+
await readCount(record, rec, problem);
|
|
569
|
+
await indexCode(record, rec, problem);
|
|
570
|
+
} catch (err) {
|
|
571
|
+
problem('probe', 'member-tools-failed', `probe threw: ${errText(err)}`);
|
|
572
|
+
}
|
|
573
|
+
return finish(rec);
|
|
574
|
+
}
|
|
575
|
+
|
|
576
|
+
const GENERIC_FLEET_MCP_REASONS = new Set(['fleet-mcp-refresh-failed', 'fleet-mcp-unavailable']);
|
|
577
|
+
|
|
578
|
+
/** Steps whose failure makes a member unverified (count/code are reported, not gating). */
|
|
579
|
+
const GATING_STEPS = new Set(['resolve', 'provider', 'server', 'tools', 'fleetMcp', 'probe']);
|
|
580
|
+
|
|
581
|
+
function finish(rec) {
|
|
582
|
+
const gating = rec.problems.filter((p) => GATING_STEPS.has(p.step));
|
|
583
|
+
// A provider override is permanent, so it is the reason a human sees first.
|
|
584
|
+
// A cause the server named for the fleetMcp refresh supersedes the
|
|
585
|
+
// generic member-session tools failures, which are only symptoms of it.
|
|
586
|
+
const serverCause = gating.find((p) => p.step === 'fleetMcp' && !GENERIC_FLEET_MCP_REASONS.has(p.reason));
|
|
587
|
+
const symptom = (p) => p.step === 'tools' && p.reason !== 'member-session-refused' && p.reason !== 'member-secret-refused';
|
|
588
|
+
const primary = gating.find((p) => p.step === 'provider')
|
|
589
|
+
|| (serverCause && gating[0] && symptom(gating[0]) ? serverCause : null)
|
|
590
|
+
|| gating[0] || null;
|
|
591
|
+
rec.verified = !primary && rec.kbTools === true && rec.codeTools === true
|
|
592
|
+
&& !!rec.fleetMcp && rec.fleetMcp.state === 'available';
|
|
593
|
+
if (rec.verified) {
|
|
594
|
+
rec.reason = null;
|
|
595
|
+
rec.fix = null;
|
|
596
|
+
} else {
|
|
597
|
+
const p = primary || { reason: 'member-tools-failed', fix: fixFor('member-tools-failed') };
|
|
598
|
+
rec.reason = p.reason;
|
|
599
|
+
rec.fix = p.fix;
|
|
600
|
+
}
|
|
601
|
+
return rec;
|
|
602
|
+
}
|
|
603
|
+
|
|
604
|
+
return {
|
|
605
|
+
probeMember,
|
|
606
|
+
async probeAll() {
|
|
607
|
+
const out = [];
|
|
608
|
+
for (const name of members) {
|
|
609
|
+
let rec;
|
|
610
|
+
try {
|
|
611
|
+
rec = await probeMember(name);
|
|
612
|
+
} catch (err) {
|
|
613
|
+
// probeMember never throws; belt and braces for the never-block contract.
|
|
614
|
+
rec = finish({
|
|
615
|
+
member: name, memberId: null, type: null, provider: null, verified: false, server: 'skipped',
|
|
616
|
+
fleetMcp: null, kbTools: null, codeTools: null, confirmedCount: null,
|
|
617
|
+
codeIndex: CODE_INDEX_STATES.FAILED, codeIndexReason: 'member-tools-failed', repo: null, maintainer: null, warnings: [],
|
|
618
|
+
reason: null, fix: null, steps: [],
|
|
619
|
+
problems: [{ step: 'probe', reason: 'member-tools-failed', fix: fixFor('member-tools-failed'), detail: errText(err) }],
|
|
620
|
+
});
|
|
621
|
+
}
|
|
622
|
+
out.push(rec);
|
|
623
|
+
try { log(formatMemberInitLine(rec)); } catch { /* logging never blocks */ }
|
|
624
|
+
}
|
|
625
|
+
return out;
|
|
626
|
+
},
|
|
627
|
+
};
|
|
628
|
+
}
|
|
629
|
+
|
|
630
|
+
/**
|
|
631
|
+
* The per-member verified lookup the sprint context exposes
|
|
632
|
+
* (context.isMemberVerified): true only for a member whose init record says
|
|
633
|
+
* verified. A member with no init record is unverified. `getRecords` is read
|
|
634
|
+
* on every call so a later refresh of the records is seen.
|
|
635
|
+
*
|
|
636
|
+
* @param {() => Array<{member: string, verified: boolean}>} getRecords
|
|
637
|
+
* @returns {(memberName: string) => boolean}
|
|
638
|
+
*/
|
|
639
|
+
export function createMemberVerifiedLookup(getRecords) {
|
|
640
|
+
return (memberName) => {
|
|
641
|
+
const records = typeof getRecords === 'function' ? getRecords() : [];
|
|
642
|
+
return Array.isArray(records) && records.some((r) => r && r.member === memberName && r.verified === true);
|
|
643
|
+
};
|
|
644
|
+
}
|