@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -4,24 +4,38 @@
|
|
|
4
4
|
*
|
|
5
5
|
* Binding design doc: docs/adr-workflow-server-resolution.md (apra-fleet-7pm.6).
|
|
6
6
|
* Consumers: src/cli/workflow.ts (the `apra-fleet workflow` launcher) and
|
|
7
|
-
* packages/apra-fleet-se/bin/cli.mjs (
|
|
7
|
+
* packages/apra-fleet-se/bin/cli.mjs (fleet-sprint). Neither duplicates this logic.
|
|
8
8
|
*
|
|
9
9
|
* Resolution order (ADR Decision 1):
|
|
10
10
|
* 1. APRA_FLEET_TRANSPORT override ('http' | 'stdio').
|
|
11
11
|
* - 'stdio' -> stdio self-spawn, no probe.
|
|
12
12
|
* - APRA_FLEET_SERVER_CMD/_BIN set (and transport is not forced 'http')
|
|
13
13
|
* -> explicit stdio request, no probe.
|
|
14
|
-
* - 'http' -> probe only;
|
|
15
|
-
* - unset -> http is the product default: probe, then
|
|
14
|
+
* - 'http' -> probe only; never starts a server, never stdio.
|
|
15
|
+
* - unset -> http is the product default: probe, then step 3.
|
|
16
16
|
* 2. HTTP singleton probe -- checkRunningInstance(): ~/.apra-fleet/data/server.json
|
|
17
17
|
* {pid, url}, pid-alive check + GET <url with /mcp -> /health> (2s timeout),
|
|
18
|
-
* self-healing (deletes
|
|
18
|
+
* self-healing (deletes server.json only for a dead pid or a refused port;
|
|
19
|
+
* a live-but-unresponsive server keeps it). On success: attach over
|
|
19
20
|
* StreamableHttpTransport, spawn nothing.
|
|
20
|
-
* 3.
|
|
21
|
-
*
|
|
22
|
-
*
|
|
21
|
+
* 3. The singleton is verifiably GONE (no server.json, dead pid, or refused
|
|
22
|
+
* port): start the SHARED HTTP server exactly as `apra-fleet start` does
|
|
23
|
+
* (auto-start.mjs -- detached, user-level, outlives this client; a lock
|
|
24
|
+
* serialises racing clients; capped at N starts per M minutes), wait for
|
|
25
|
+
* /health, then attach over HTTP. An UNRESPONSIVE singleton (alive, not
|
|
26
|
+
* answering) is never replaced: actionable error. (GitHub #585 recovery;
|
|
27
|
+
* this replaced the old private stdio self-spawn, which is now only
|
|
28
|
+
* reachable via APRA_FLEET_TRANSPORT=stdio or APRA_FLEET_SERVER_CMD/_BIN.)
|
|
23
29
|
*
|
|
24
|
-
*
|
|
30
|
+
* Long-lived HTTP clients get a ReconnectingHttpTransport (connectFleet /
|
|
31
|
+
* createFleetHttpTransport): on a refused connection it re-probes, auto-starts
|
|
32
|
+
* a gone server and retries a request ONCE only when it provably never reached
|
|
33
|
+
* the server -- never an in-flight execute_prompt/execute_command.
|
|
34
|
+
*
|
|
35
|
+
* Claude Code and other MCP hosts connect by URL and never use this module;
|
|
36
|
+
* they are covered by the OS user-level service (install), not by this.
|
|
37
|
+
*
|
|
38
|
+
* Scope guard (ADR): the launcher/fleet-sprint client and the MCP server are ALWAYS
|
|
25
39
|
* separate processes. This module decides only the transport, never merges them.
|
|
26
40
|
*
|
|
27
41
|
* Every branch is unit-testable: all filesystem/env/network access goes through the
|
|
@@ -29,12 +43,22 @@
|
|
|
29
43
|
*/
|
|
30
44
|
import fs from 'node:fs';
|
|
31
45
|
import http from 'node:http';
|
|
46
|
+
import net from 'node:net';
|
|
32
47
|
import path from 'node:path';
|
|
33
48
|
import os from 'node:os';
|
|
34
49
|
import { fileURLToPath } from 'node:url';
|
|
35
50
|
import { StdioTransport, StreamableHttpTransport } from './transport.mjs';
|
|
36
51
|
import { McpClient } from './client.mjs';
|
|
37
52
|
import { ApraFleet } from './api.mjs';
|
|
53
|
+
import { autoStartFleetServer, readStoppedByUser, stoppedByUserError } from './auto-start.mjs';
|
|
54
|
+
import { ReconnectingHttpTransport } from './reconnecting-transport.mjs';
|
|
55
|
+
|
|
56
|
+
export {
|
|
57
|
+
autoStartFleetServer, resolveFleetStartCommand, lastServerLog, FleetAutoStartError,
|
|
58
|
+
readStoppedByUser, stoppedByUserError, STOPPED_BY_USER_FILE,
|
|
59
|
+
AUTOSTART_MAX_STARTS, AUTOSTART_WINDOW_MS, AUTOSTART_TIMEOUT_MS,
|
|
60
|
+
} from './auto-start.mjs';
|
|
61
|
+
export { ReconnectingHttpTransport, isNeverDeliveredError } from './reconnecting-transport.mjs';
|
|
38
62
|
|
|
39
63
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
40
64
|
|
|
@@ -66,29 +90,60 @@ function isPidAlive(pid) {
|
|
|
66
90
|
/**
|
|
67
91
|
* GET <url with a trailing /mcp replaced by /health>, 2s timeout.
|
|
68
92
|
* @param {string} url
|
|
69
|
-
* @returns {Promise<boolean>}
|
|
93
|
+
* @returns {Promise<boolean|'foreign'>} 'foreign' when something answered with a non-200
|
|
94
|
+
* (a blocked fleet server cannot answer at all, so the port belongs to someone else)
|
|
70
95
|
*/
|
|
71
96
|
function checkHealthEndpoint(url) {
|
|
72
97
|
const healthUrl = url.replace(/\/mcp$/, '/health');
|
|
73
98
|
return new Promise((resolve) => {
|
|
74
99
|
const req = http.get(healthUrl, { timeout: 2000 }, (res) => {
|
|
75
100
|
res.resume();
|
|
76
|
-
resolve(res.statusCode === 200);
|
|
101
|
+
resolve(res.statusCode === 200 ? true : 'foreign');
|
|
77
102
|
});
|
|
78
103
|
req.on('error', () => resolve(false));
|
|
79
104
|
req.on('timeout', () => { req.destroy(); resolve(false); });
|
|
80
105
|
});
|
|
81
106
|
}
|
|
82
107
|
|
|
108
|
+
/**
|
|
109
|
+
* Plain TCP connect probe (mirrors src/services/singleton.ts probeTcpPort).
|
|
110
|
+
* @param {number} port
|
|
111
|
+
* @param {string} host
|
|
112
|
+
* @returns {Promise<'open'|'refused'|'timeout'|'error'>}
|
|
113
|
+
*/
|
|
114
|
+
function probeTcpPort(port, host) {
|
|
115
|
+
return new Promise((resolve) => {
|
|
116
|
+
let settled = false;
|
|
117
|
+
const sock = net.connect({ port, host });
|
|
118
|
+
const finish = (r) => {
|
|
119
|
+
if (settled) return;
|
|
120
|
+
settled = true;
|
|
121
|
+
try { sock.destroy(); } catch { /* ignore */ }
|
|
122
|
+
resolve(r);
|
|
123
|
+
};
|
|
124
|
+
sock.setTimeout(3000); // Windows takes ~2s to report a refused loopback connect
|
|
125
|
+
sock.once('connect', () => finish('open'));
|
|
126
|
+
sock.once('timeout', () => finish('timeout'));
|
|
127
|
+
sock.once('error', (err) => finish(err && err.code === 'ECONNREFUSED' ? 'refused' : 'error'));
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
|
|
83
131
|
/**
|
|
84
132
|
* The HTTP-singleton probe. Same semantics as src/services/singleton.ts's
|
|
85
|
-
* checkRunningInstance() (pid + /health + self-heal), so the launcher's
|
|
86
|
-
* the server's own startup-dedup can never disagree.
|
|
133
|
+
* checkRunningInstance() (pid + /health + tri-state self-heal), so the launcher's
|
|
134
|
+
* probe and the server's own startup-dedup can never disagree.
|
|
135
|
+
*
|
|
136
|
+
* Tri-state: running (pid alive + /health 200), unresponsive (pid alive, /health
|
|
137
|
+
* silent, recorded port still accepts TCP -- server.json is KEPT), gone (no
|
|
138
|
+
* server.json, dead pid, or the recorded port refuses TCP -- server.json removed).
|
|
87
139
|
*
|
|
88
140
|
* @param {{ env?: Record<string, string|undefined>, readFile?: (p: string) => string,
|
|
89
141
|
* unlink?: (p: string) => void, pidAlive?: (pid: number) => boolean,
|
|
90
|
-
* health?: (url: string) => Promise<boolean
|
|
91
|
-
*
|
|
142
|
+
* health?: (url: string) => Promise<boolean>,
|
|
143
|
+
* tcpProbe?: (port: number, host: string) => Promise<'open'|'refused'|'timeout'|'error'> }} [deps]
|
|
144
|
+
* @returns {Promise<{running: true, state: 'running', url: string, pid: number}
|
|
145
|
+
* | {running: false, state: 'unresponsive', url: string, pid: number, port?: number}
|
|
146
|
+
* | {running: false, state: 'gone'}>}
|
|
92
147
|
*/
|
|
93
148
|
export async function checkRunningInstance(deps = {}) {
|
|
94
149
|
const env = deps.env || process.env;
|
|
@@ -96,6 +151,7 @@ export async function checkRunningInstance(deps = {}) {
|
|
|
96
151
|
const unlink = deps.unlink || ((p) => { try { fs.unlinkSync(p); } catch { /* already gone */ } });
|
|
97
152
|
const pidAlive = deps.pidAlive || isPidAlive;
|
|
98
153
|
const health = deps.health || checkHealthEndpoint;
|
|
154
|
+
const tcpProbe = deps.tcpProbe || probeTcpPort;
|
|
99
155
|
|
|
100
156
|
const serverInfoPath = getServerInfoPath(env);
|
|
101
157
|
|
|
@@ -103,22 +159,37 @@ export async function checkRunningInstance(deps = {}) {
|
|
|
103
159
|
try {
|
|
104
160
|
info = JSON.parse(readFile(serverInfoPath));
|
|
105
161
|
} catch {
|
|
106
|
-
return { running: false };
|
|
162
|
+
return { running: false, state: 'gone' };
|
|
107
163
|
}
|
|
108
164
|
|
|
109
|
-
if (!info || !info.pid || !info.url) return { running: false };
|
|
165
|
+
if (!info || !info.pid || !info.url) return { running: false, state: 'gone' };
|
|
110
166
|
|
|
111
167
|
if (!pidAlive(info.pid)) {
|
|
112
168
|
unlink(serverInfoPath);
|
|
113
|
-
return { running: false };
|
|
169
|
+
return { running: false, state: 'gone' };
|
|
114
170
|
}
|
|
115
171
|
|
|
116
|
-
|
|
172
|
+
const healthResult = await health(info.url);
|
|
173
|
+
if (healthResult === 'foreign') {
|
|
117
174
|
unlink(serverInfoPath);
|
|
118
|
-
return { running: false };
|
|
175
|
+
return { running: false, state: 'gone' };
|
|
176
|
+
}
|
|
177
|
+
if (healthResult !== true) {
|
|
178
|
+
let port;
|
|
179
|
+
let host = '127.0.0.1';
|
|
180
|
+
try {
|
|
181
|
+
const u = new URL(info.url);
|
|
182
|
+
port = Number(info.port) > 0 ? Number(info.port) : (Number(u.port) > 0 ? Number(u.port) : undefined);
|
|
183
|
+
host = u.hostname || host;
|
|
184
|
+
} catch { /* keep defaults */ }
|
|
185
|
+
if (port !== undefined && (await tcpProbe(port, host)) === 'refused') {
|
|
186
|
+
unlink(serverInfoPath);
|
|
187
|
+
return { running: false, state: 'gone' };
|
|
188
|
+
}
|
|
189
|
+
return { running: false, state: 'unresponsive', url: info.url, pid: info.pid, port };
|
|
119
190
|
}
|
|
120
191
|
|
|
121
|
-
return { running: true, url: info.url, pid: info.pid };
|
|
192
|
+
return { running: true, state: 'running', url: info.url, pid: info.pid };
|
|
122
193
|
}
|
|
123
194
|
|
|
124
195
|
/**
|
|
@@ -169,12 +240,15 @@ export function resolveFleetServerCommand(deps = {}) {
|
|
|
169
240
|
}
|
|
170
241
|
|
|
171
242
|
/**
|
|
172
|
-
* The ADR's resolution order
|
|
243
|
+
* The ADR's resolution order. Returns a connection descriptor; nothing is
|
|
244
|
+
* connected. The only side effect: when the shared HTTP server is verifiably
|
|
245
|
+
* gone, it is started (step 3) -- inject `autoStartFleetServer` to fake that.
|
|
173
246
|
*
|
|
174
247
|
* @param {{ env?: Record<string, string|undefined>, dirname?: string,
|
|
175
248
|
* exists?: (candidate: string) => boolean,
|
|
176
|
-
* checkRunningInstance?: (deps?: object) => Promise<object
|
|
177
|
-
*
|
|
249
|
+
* checkRunningInstance?: (deps?: object) => Promise<object>,
|
|
250
|
+
* autoStartFleetServer?: (deps: object) => Promise<{url: string, pid: number, started?: boolean}> }} [deps]
|
|
251
|
+
* @returns {Promise<{mode: 'http', url: string, pid: number, reason: string, started?: boolean}
|
|
178
252
|
* | {mode: 'stdio', command: string, args: string[], reason: string}>}
|
|
179
253
|
*/
|
|
180
254
|
export async function resolveFleetServerConnection(deps = {}) {
|
|
@@ -219,19 +293,71 @@ export async function resolveFleetServerConnection(deps = {}) {
|
|
|
219
293
|
'APRA_FLEET_TRANSPORT=http was requested, but no healthy apra-fleet HTTP singleton was found.\n' +
|
|
220
294
|
` Checked: ${getServerInfoPath(env)} (pid alive + GET /health)\n` +
|
|
221
295
|
" Start one with 'apra-fleet start' (or 'apra-fleet install'), or unset " +
|
|
222
|
-
'APRA_FLEET_TRANSPORT to
|
|
296
|
+
'APRA_FLEET_TRANSPORT to let the client start the shared server itself.',
|
|
297
|
+
);
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
// A live-but-unresponsive HTTP singleton still owns this data dir: a
|
|
301
|
+
// self-spawned stdio server beside it would split the fleet (GitHub #584).
|
|
302
|
+
if (instance && instance.state === 'unresponsive') {
|
|
303
|
+
throw new Error(
|
|
304
|
+
`The apra-fleet HTTP server (pid ${instance.pid} at ${instance.url}) is alive but not answering /health.\n` +
|
|
305
|
+
' Refusing to start a second server on the same data dir.\n' +
|
|
306
|
+
" Run 'apra-fleet stop' and retry, or set APRA_FLEET_TRANSPORT=stdio to force a private stdio server.",
|
|
223
307
|
);
|
|
224
308
|
}
|
|
225
309
|
|
|
226
|
-
// Step 3 --
|
|
227
|
-
|
|
310
|
+
// Step 3 -- the shared server is gone: start it the way 'apra-fleet start'
|
|
311
|
+
// does and attach over HTTP.
|
|
312
|
+
// A server the user stopped with 'apra-fleet stop' stays stopped: fail
|
|
313
|
+
// with the actionable error instead of starting it (also on a mid-run
|
|
314
|
+
// reconnect, which re-runs this resolution).
|
|
315
|
+
const stopped = readStoppedByUser(getFleetDataDir(env));
|
|
316
|
+
if (stopped) throw stoppedByUserError(stopped);
|
|
317
|
+
const autoStart = deps.autoStartFleetServer || autoStartFleetServer;
|
|
318
|
+
const started = await autoStart({ ...deps, env, checkRunningInstance: probe });
|
|
228
319
|
return {
|
|
229
|
-
mode: '
|
|
230
|
-
|
|
231
|
-
|
|
320
|
+
mode: 'http',
|
|
321
|
+
url: started.url,
|
|
322
|
+
pid: started.pid,
|
|
323
|
+
started: started.started !== false,
|
|
324
|
+
reason: started.started === false
|
|
325
|
+
? `attached to HTTP singleton at ${started.url} (pid ${started.pid}), started by another client`
|
|
326
|
+
: `the shared HTTP server was not running; started it and attached at ${started.url} (pid ${started.pid})`,
|
|
232
327
|
};
|
|
233
328
|
}
|
|
234
329
|
|
|
330
|
+
/**
|
|
331
|
+
* A ReconnectingHttpTransport for an http-mode resolution: on a refused
|
|
332
|
+
* connection or a lost session it re-runs the resolution (re-probe; auto-start
|
|
333
|
+
* a gone server unless APRA_FLEET_TRANSPORT=http) and reconnects.
|
|
334
|
+
*
|
|
335
|
+
* @param {{url: string}} connection an http-mode result of resolveFleetServerConnection
|
|
336
|
+
* @param {object} [deps] same bag as resolveFleetServerConnection, plus `options`
|
|
337
|
+
* (transport options) and `createTransport` (tests).
|
|
338
|
+
* @returns {ReconnectingHttpTransport}
|
|
339
|
+
*/
|
|
340
|
+
export function createFleetHttpTransport(connection, deps = {}) {
|
|
341
|
+
const env = deps.env || process.env;
|
|
342
|
+
// Every /mcp session needs the install's access secret (a FULL session as
|
|
343
|
+
// much as a ?member= one); read from the data dir the server was resolved from.
|
|
344
|
+
const authedOptions = withFleetAccessSecret(deps.options || {}, env);
|
|
345
|
+
const forcedHttp = (env.APRA_FLEET_TRANSPORT || '').trim().toLowerCase() === 'http';
|
|
346
|
+
// Reconnecting must stay on HTTP: never let the resolver pick stdio here.
|
|
347
|
+
const relocateEnv = { ...env };
|
|
348
|
+
delete relocateEnv.APRA_FLEET_SERVER_CMD;
|
|
349
|
+
delete relocateEnv.APRA_FLEET_SERVER_BIN;
|
|
350
|
+
if (!forcedHttp) delete relocateEnv.APRA_FLEET_TRANSPORT;
|
|
351
|
+
return new ReconnectingHttpTransport(connection.url, {
|
|
352
|
+
options: authedOptions,
|
|
353
|
+
createTransport: deps.createTransport,
|
|
354
|
+
relocate: async () => {
|
|
355
|
+
const r = await resolveFleetServerConnection({ ...deps, env: relocateEnv });
|
|
356
|
+
return r.url;
|
|
357
|
+
},
|
|
358
|
+
});
|
|
359
|
+
}
|
|
360
|
+
|
|
235
361
|
/**
|
|
236
362
|
* Resolve + connect, returning a live MCP client bound to whichever transport the
|
|
237
363
|
* ADR order selected.
|
|
@@ -245,7 +371,7 @@ export async function connectFleet(deps = {}) {
|
|
|
245
371
|
const options = deps.options || {};
|
|
246
372
|
|
|
247
373
|
const transport = resolution.mode === 'http'
|
|
248
|
-
?
|
|
374
|
+
? createFleetHttpTransport(resolution, { ...deps, options })
|
|
249
375
|
: new StdioTransport(resolution.command, resolution.args, options);
|
|
250
376
|
|
|
251
377
|
await transport.start();
|
|
@@ -263,3 +389,114 @@ export async function connectFleet(deps = {}) {
|
|
|
263
389
|
|
|
264
390
|
return { transport, mcpClient, fleetApi: new ApraFleet(mcpClient), mode: resolution.mode };
|
|
265
391
|
}
|
|
392
|
+
|
|
393
|
+
/** Header a `?member=` request carries the install's member access secret in
|
|
394
|
+
* (mirrors MEMBER_SECRET_HEADER in src/services/member-access-secret.ts). */
|
|
395
|
+
export const MEMBER_SECRET_HEADER = 'X-Apra-Fleet-Member-Secret';
|
|
396
|
+
|
|
397
|
+
/**
|
|
398
|
+
* The member access secret of the install whose data dir `env` names
|
|
399
|
+
* (<data dir>/member-access.key, owner-only), or null when there is none
|
|
400
|
+
* (an install older than the secret, whose server does not check it).
|
|
401
|
+
* @param {NodeJS.ProcessEnv} [env]
|
|
402
|
+
* @returns {string|null}
|
|
403
|
+
*/
|
|
404
|
+
export function readMemberAccessSecret(env = process.env) {
|
|
405
|
+
try {
|
|
406
|
+
const v = fs.readFileSync(path.join(getFleetDataDir(env), 'member-access.key'), 'utf8').trim();
|
|
407
|
+
return /^[0-9a-f]{64}$/.test(v) ? v : null;
|
|
408
|
+
} catch {
|
|
409
|
+
return null;
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
|
|
413
|
+
/**
|
|
414
|
+
* `options` with the install's access secret added as a request header (an
|
|
415
|
+
* explicit header already in `options` wins). Every http connection to the
|
|
416
|
+
* local server needs it -- the server refuses a /mcp session without a member
|
|
417
|
+
* JWT or this secret with HTTP 401. A missing secret file leaves `options`
|
|
418
|
+
* unchanged (the server then answers 401 with its own clear message).
|
|
419
|
+
* @param {object} [options] StreamableHttpTransport options
|
|
420
|
+
* @param {NodeJS.ProcessEnv} [env]
|
|
421
|
+
* @returns {object}
|
|
422
|
+
*/
|
|
423
|
+
export function withFleetAccessSecret(options = {}, env = process.env) {
|
|
424
|
+
const secret = readMemberAccessSecret(env);
|
|
425
|
+
if (!secret) return options;
|
|
426
|
+
return { ...options, headers: { [MEMBER_SECRET_HEADER]: secret, ...(options.headers || {}) } };
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
/**
|
|
430
|
+
* Resolve + connect a MEMBER session: the local HTTP singleton with
|
|
431
|
+
* `?member=<uuid>` appended, so the server scopes the session's tools to the
|
|
432
|
+
* member allowlist. A member session needs the HTTP singleton (the identity
|
|
433
|
+
* rides on the URL); a stdio self-spawn cannot carry one, so it is refused.
|
|
434
|
+
* An unregistered uuid is refused by the server with HTTP 403 at initialize;
|
|
435
|
+
* the rejection carries `.status === 403` and `.code === 'HTTP_403'`.
|
|
436
|
+
*
|
|
437
|
+
* `deps.origin === 'engine'` adds `origin=engine` to the URL: the session is
|
|
438
|
+
* the ENGINE acting as the member (memberCall, `apra-fleet call`), and the
|
|
439
|
+
* server excludes its kb_/code_ calls from the member's session_stats counts.
|
|
440
|
+
* Only those engine paths set it; any other origin value is refused.
|
|
441
|
+
*
|
|
442
|
+
* The server accepts a `?member=` session only with its install's member
|
|
443
|
+
* access secret: it is read from the same data dir the server was resolved
|
|
444
|
+
* from (readMemberAccessSecret) and sent in the MEMBER_SECRET_HEADER header
|
|
445
|
+
* on every request. Without it the server answers HTTP 401.
|
|
446
|
+
*
|
|
447
|
+
* `deps.kbMaintainer === true` (requires `origin: 'engine'`) adds
|
|
448
|
+
* `kb_maintainer=1`: the engine's kb_maintainer grant. The server then also
|
|
449
|
+
* serves kb_promote, kb_resolve_contradiction and kb_reconcile_prefilter to
|
|
450
|
+
* this member session (they mint CONFIRMED; no other member session sees
|
|
451
|
+
* them), and accepts kb_import with an explicit `path` (refused with
|
|
452
|
+
* E-KB-MAINTAINER-REQUIRED in a member session without the grant; kb_import
|
|
453
|
+
* without `path` works in every member session, but without the grant it reads
|
|
454
|
+
* the bible as committed at HEAD only), and lets kb_invalidate and kb_capture
|
|
455
|
+
* `supersedes` retire CONFIRMED entries (without the grant they are left live
|
|
456
|
+
* and listed in the response's `refused`). memberCall sets it only for
|
|
457
|
+
* the member it chose as a repository's kb_maintainer.
|
|
458
|
+
*
|
|
459
|
+
* @param {string} memberId registered member uuid
|
|
460
|
+
* @param {object} [deps] same bag as resolveFleetServerConnection, plus `options`
|
|
461
|
+
* forwarded to the transport and optional
|
|
462
|
+
* `origin: 'engine'`, and optional `kbMaintainer: true`.
|
|
463
|
+
* @returns {Promise<{transport: object, mcpClient: McpClient, mode: 'http', url: string, close: () => Promise<void>}>}
|
|
464
|
+
* Always `await close()` when done: it DELETEs the server session so no
|
|
465
|
+
* McpServer or registry entry is leaked (`transport.stop()` does not).
|
|
466
|
+
*/
|
|
467
|
+
export async function connectFleetMember(memberId, deps = {}) {
|
|
468
|
+
if (!memberId) throw new Error('connectFleetMember requires a member id.');
|
|
469
|
+
if (deps.origin !== undefined && deps.origin !== 'engine') {
|
|
470
|
+
throw new Error(`connectFleetMember: unsupported origin '${deps.origin}' (only 'engine' is accepted).`);
|
|
471
|
+
}
|
|
472
|
+
if (deps.kbMaintainer !== undefined && typeof deps.kbMaintainer !== 'boolean') {
|
|
473
|
+
throw new Error('connectFleetMember: kbMaintainer must be a boolean.');
|
|
474
|
+
}
|
|
475
|
+
if (deps.kbMaintainer === true && deps.origin !== 'engine') {
|
|
476
|
+
throw new Error("connectFleetMember: kbMaintainer requires origin 'engine' (the kb_maintainer grant is engine-only).");
|
|
477
|
+
}
|
|
478
|
+
const resolution = await resolveFleetServerConnection(deps);
|
|
479
|
+
if (resolution.mode !== 'http') {
|
|
480
|
+
throw new Error(
|
|
481
|
+
'A member session requires the local apra-fleet HTTP server, but none was resolved ' +
|
|
482
|
+
`(${resolution.reason}). Start it with 'apra-fleet start'.`,
|
|
483
|
+
);
|
|
484
|
+
}
|
|
485
|
+
const url = new URL(resolution.url);
|
|
486
|
+
url.searchParams.set('member', memberId);
|
|
487
|
+
if (deps.origin === 'engine') url.searchParams.set('origin', 'engine');
|
|
488
|
+
if (deps.kbMaintainer === true) url.searchParams.set('kb_maintainer', '1');
|
|
489
|
+
const options = { ...(deps.options || {}) };
|
|
490
|
+
const secret = readMemberAccessSecret(deps.env || process.env);
|
|
491
|
+
if (secret) options.headers = { ...(options.headers || {}), [MEMBER_SECRET_HEADER]: secret };
|
|
492
|
+
const transport = new StreamableHttpTransport(url.toString(), options);
|
|
493
|
+
await transport.start();
|
|
494
|
+
return {
|
|
495
|
+
transport,
|
|
496
|
+
mcpClient: new McpClient(transport),
|
|
497
|
+
mode: 'http',
|
|
498
|
+
url: url.toString(),
|
|
499
|
+
/** Release the server-side member session (HTTP DELETE) and stop the transport. */
|
|
500
|
+
close: () => transport.close(),
|
|
501
|
+
};
|
|
502
|
+
}
|
|
@@ -50,7 +50,7 @@ export class StdioTransport extends EventEmitter {
|
|
|
50
50
|
}
|
|
51
51
|
|
|
52
52
|
start() {
|
|
53
|
-
this.process = spawn(this.command, this.args, this.options);
|
|
53
|
+
this.process = spawn(this.command, this.args, { windowsHide: true, ...this.options });
|
|
54
54
|
|
|
55
55
|
this.process.stdout.on('data', (chunk) => {
|
|
56
56
|
this.buffer += chunk.toString();
|
|
@@ -101,6 +101,12 @@ export class StdioTransport extends EventEmitter {
|
|
|
101
101
|
this.process = null;
|
|
102
102
|
}
|
|
103
103
|
}
|
|
104
|
+
|
|
105
|
+
/** Same as stop(): a stdio server lives and dies with its process. Lets
|
|
106
|
+
* every caller end any transport with close(). */
|
|
107
|
+
async close() {
|
|
108
|
+
this.stop();
|
|
109
|
+
}
|
|
104
110
|
}
|
|
105
111
|
|
|
106
112
|
export class StreamableHttpTransport extends EventEmitter {
|
|
@@ -142,7 +148,11 @@ export class StreamableHttpTransport extends EventEmitter {
|
|
|
142
148
|
});
|
|
143
149
|
|
|
144
150
|
if (!postResponse.ok) {
|
|
145
|
-
|
|
151
|
+
const initErr = new Error(`Init POST error! status: ${postResponse.status}`);
|
|
152
|
+
// Typed so callers can tell a refused member identity (403) from a network failure.
|
|
153
|
+
initErr.status = postResponse.status;
|
|
154
|
+
initErr.code = `HTTP_${postResponse.status}`;
|
|
155
|
+
throw initErr;
|
|
146
156
|
}
|
|
147
157
|
|
|
148
158
|
this.sessionId = postResponse.headers.get('mcp-session-id');
|
|
@@ -307,7 +317,13 @@ export class StreamableHttpTransport extends EventEmitter {
|
|
|
307
317
|
}
|
|
308
318
|
|
|
309
319
|
if (!response.ok) {
|
|
310
|
-
|
|
320
|
+
// .status lets callers classify the failure (404 = unknown
|
|
321
|
+
// session, rejected before any tool ran -- see
|
|
322
|
+
// reconnecting-transport.mjs) without parsing the message.
|
|
323
|
+
const httpErr = new Error(`Failed to send message: HTTP ${response.status}`);
|
|
324
|
+
httpErr.status = response.status;
|
|
325
|
+
try { await response.body?.cancel(); } catch { /* ignore */ }
|
|
326
|
+
throw httpErr;
|
|
311
327
|
}
|
|
312
328
|
|
|
313
329
|
// The server sends the JSON-RPC response over an SSE stream in the POST response
|
|
@@ -318,6 +334,30 @@ export class StreamableHttpTransport extends EventEmitter {
|
|
|
318
334
|
});
|
|
319
335
|
}
|
|
320
336
|
|
|
337
|
+
/**
|
|
338
|
+
* Release the server-side session (HTTP DELETE with the session id, best
|
|
339
|
+
* effort and short-bounded), then stop(). stop() alone only aborts the
|
|
340
|
+
* local streams and leaves the server's session, McpServer and any member
|
|
341
|
+
* registry entry alive; short-lived callers (apra-fleet call, memberCall)
|
|
342
|
+
* must use close().
|
|
343
|
+
*/
|
|
344
|
+
async close() {
|
|
345
|
+
const sid = this.sessionId;
|
|
346
|
+
if (sid) {
|
|
347
|
+
try {
|
|
348
|
+
const res = await undiciFetch(this.url, {
|
|
349
|
+
method: 'DELETE',
|
|
350
|
+
headers: { 'mcp-session-id': sid, ...(this.options.headers || {}) },
|
|
351
|
+
signal: AbortSignal.timeout(5000),
|
|
352
|
+
dispatcher: sseDispatcher,
|
|
353
|
+
});
|
|
354
|
+
if (res && res.body) await res.body.cancel().catch(() => {});
|
|
355
|
+
} catch { /* best effort: the server may already be gone */ }
|
|
356
|
+
this.sessionId = null;
|
|
357
|
+
}
|
|
358
|
+
this.stop();
|
|
359
|
+
}
|
|
360
|
+
|
|
321
361
|
stop() {
|
|
322
362
|
if (this.controller) {
|
|
323
363
|
this.controller.abort();
|
|
@@ -10,30 +10,67 @@ You groom ONE operator's slice of the open beads backlog: what to pick up next,
|
|
|
10
10
|
to sprint together, what's a duplicate, what needs fixing before it's actionable. You
|
|
11
11
|
analyze AND mutate beads directly -- but you never touch code beyond reading it.
|
|
12
12
|
|
|
13
|
-
## Step 0 -- Knowledge Bank (
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
13
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any grooming decision)
|
|
14
|
+
|
|
15
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
16
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
17
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
18
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
19
|
+
the orchestrator fetched for the backlog you are grooming.
|
|
20
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
21
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
22
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
23
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
24
|
+
|
|
25
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
26
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
27
|
+
|
|
28
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
29
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
30
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
31
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
32
|
+
|
|
33
|
+
1. When the tools are present, call `kb_session_prime` with `hint_modules` naming the
|
|
34
|
+
subsystems the assigned beads touch. KB knowledge matters most for duplicate
|
|
35
|
+
detection and sprint-set grouping.
|
|
36
|
+
2. This role has no KB-capture channel: when grooming turns up a durable backlog fact --
|
|
37
|
+
two ids that are genuinely the same work, a dependency between beads that their text
|
|
38
|
+
does not state, or a recurring reason items land unactionable -- note it in your own
|
|
39
|
+
report. Record what stays true, not per-sprint churn.
|
|
40
|
+
|
|
41
|
+
### Persistent Memories (operational rules)
|
|
42
|
+
|
|
43
|
+
Before beginning grooming decisions, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
bd memories --json +all+
|
|
47
|
+
bd memories --json +groomer+
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
51
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+groomer+`.
|
|
52
|
+
|
|
53
|
+
**One-time key migration** (older groomer versions saved heuristics as
|
|
54
|
+
`groomer-heuristic-<slug>`, which the `+groomer+` query never returns). Run
|
|
55
|
+
`bd memories --json groomer-heuristic-` only to list keys (its JSON escapes quotes and
|
|
56
|
+
`&`, `<`, `>`, so never copy values from it); for each KEY starting with `groomer-heuristic-`:
|
|
57
|
+
|
|
58
|
+
1. Read the value with `bd recall <old key>` (raw text).
|
|
59
|
+
2. If `+groomer+:<slug>` already exists with a different value, leave both keys and
|
|
60
|
+
report the conflict in `notes`.
|
|
61
|
+
3. Otherwise `bd remember --key "+groomer+:<slug>" -- "<value>"`, quoted for your shell so
|
|
62
|
+
`$`, backticks and `&&` survive. If the value contains double quotes or other characters
|
|
63
|
+
the current shell cannot pass verbatim (e.g. Windows PowerShell 5.1 strips embedded
|
|
64
|
+
double quotes), do not migrate that key; report it in `notes` instead.
|
|
65
|
+
4. `bd forget <old key>` ONLY if `bd recall <old key>` and `bd recall "+groomer+:<slug>"`
|
|
66
|
+
print identical text; otherwise keep both keys and report the mismatch in `notes`.
|
|
67
|
+
|
|
68
|
+
Steps 3-4 write, so they follow the same gate as bead mutations: only with `dry-run: false`
|
|
69
|
+
and not in report-only "What needs grooming" mode. Otherwise run no `bd remember`/`bd forget`;
|
|
70
|
+
list each key you would migrate (old -> new) with its exact proposed `bd` commands in `notes`.
|
|
71
|
+
Report each key actually migrated in `heuristicsRecorded` (new key + value) and count them
|
|
72
|
+
in `notes`. Nothing to do when the query returns no `groomer-heuristic-` keys. Either way,
|
|
73
|
+
apply those entries in this session too.
|
|
37
74
|
|
|
38
75
|
## Usage modes
|
|
39
76
|
|
|
@@ -309,16 +346,32 @@ use), report the same fields in this JSON shape for an orchestrator caller, or a
|
|
|
309
346
|
You have no conversation memory between invocations; beads does, per-database, which is
|
|
310
347
|
the right scope since most of what you learn is calibrated to one repo's backlog.
|
|
311
348
|
|
|
312
|
-
At session start:
|
|
349
|
+
At session start: retrieve operational memories -- read and apply what past sessions recorded:
|
|
350
|
+
|
|
351
|
+
```bash
|
|
352
|
+
bd memories --json +all+
|
|
353
|
+
bd memories --json +groomer+
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
357
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+groomer+`.
|
|
313
358
|
|
|
314
359
|
At session end, if you found a durable, non-obvious pattern specific to THIS repo's
|
|
315
360
|
backlog (not a one-off, not already in this file):
|
|
316
361
|
|
|
317
362
|
```bash
|
|
318
|
-
bd remember --key groomer
|
|
363
|
+
bd remember --key "+groomer+:<short-slug>" "<one or two sentences>"
|
|
319
364
|
```
|
|
320
365
|
|
|
321
|
-
|
|
366
|
+
Key scheme: wrap every role token in `+` on both sides, then `:<slug>`. Use
|
|
367
|
+
`+groomer+:<slug>` for a groomer-only rule, `+groomer+planner+:<slug>` when other roles
|
|
368
|
+
need it too, `+all+:<slug>` when every role does. `bd memories` is a plain substring
|
|
369
|
+
search over keys and values, so a bare or one-sided prefix (`groomer:`, `reviewer:`)
|
|
370
|
+
also matches other roles' keys; never write one. Remove stale entries with `bd forget <key>`.
|
|
322
371
|
Record calibration ("P1 bugs older than 30 days with no repro steps are almost always
|
|
323
372
|
stale duplicates in this repo"), not repo-agnostic procedure (belongs in this file) or
|
|
324
373
|
transient facts. If nothing durable turned up, write nothing and say so.
|
|
374
|
+
|
|
375
|
+
## Shell command discipline
|
|
376
|
+
|
|
377
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|