@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
|
@@ -15,12 +15,20 @@ Check first: `curl -s -m 5 http://localhost:8787/api/sprints`. Connection
|
|
|
15
15
|
refused/timeout = not running. `{"sprints": [...]}` = already up, skip this.
|
|
16
16
|
|
|
17
17
|
Start it detached (it runs indefinitely -- exits only on `POST
|
|
18
|
-
/api/shutdown` or SIGINT/SIGTERM, never on its own)
|
|
18
|
+
/api/shutdown` or SIGINT/SIGTERM, never on its own). `apra-fleet install`
|
|
19
|
+
puts it under the user's home (needs Node.js 22.16+):
|
|
19
20
|
|
|
20
21
|
```bash
|
|
21
|
-
node
|
|
22
|
+
node ~/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs # macOS / Linux
|
|
22
23
|
```
|
|
23
24
|
|
|
25
|
+
```powershell
|
|
26
|
+
node "$HOME\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs" # Windows PowerShell
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
(From a source checkout of apra-fleet the same file is
|
|
30
|
+
`packages/apra-fleet-se/bin/serve.mjs`.)
|
|
31
|
+
|
|
24
32
|
Start it from INSIDE the target project (any folder under it): the
|
|
25
33
|
supervisor resolves the project's `.beads` by walking up from its cwd,
|
|
26
34
|
exactly like `bd`. Starting from elsewhere: pass `--beads-dir <project
|
|
@@ -31,20 +39,33 @@ top of the dashboard, and every sprint it launches is told to verify its
|
|
|
31
39
|
members against it. If NO `.beads` is found (or its probe fails) it still
|
|
32
40
|
starts, but logs `[supervisor] WARNING: no beads database found walking up
|
|
33
41
|
from <cwd> ... To fix: ...`, reports `beads: null` plus `beadsWarning` on
|
|
34
|
-
`/api/health`, shows an amber `Beads: NOT RESOLVED -- ...` header on the
|
|
35
|
-
dashboard
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
restart. `--port <n>`
|
|
42
|
+
`/api/health`, and shows an amber `Beads: NOT RESOLVED -- ...` header on the
|
|
43
|
+
dashboard. With NO `.beads` found it also has no backlog member, so every
|
|
44
|
+
launch answers `503` until you restart it from the right folder or with
|
|
45
|
+
`--beads-dir`. With a `.beads` found but a failed probe, launches still
|
|
46
|
+
work (without `--expect-beads`); fix the environment and hit
|
|
47
|
+
`GET /api/health?refresh=1` to recover without a restart. `--port <n>`
|
|
48
|
+
overrides the default (8787). Self-logs to
|
|
40
49
|
`<dataDir>/logs/supervisor.log` in addition to stdout.
|
|
41
50
|
|
|
51
|
+
**Backlog member.** At startup the supervisor ensures its own backlog
|
|
52
|
+
member: a local member with no LLM whose work folder is the project folder.
|
|
53
|
+
It adopts an LLM-less local member already registered for that folder (name
|
|
54
|
+
kept; adds the `backlog` tag and `unreservable` when missing), or registers
|
|
55
|
+
`backlog-<camelCaseFolderName>`. It logs `[supervisor] backlog member:
|
|
56
|
+
'<name>' (ready)`; `GET /api/health` reports `backlogMember: {status, name,
|
|
57
|
+
reason}`. It refuses to start (exit 1) if that name is taken by a member
|
|
58
|
+
for another folder. Fleet unreachable at startup is not fatal: status is
|
|
59
|
+
`degraded`, launches answer `503`, and a background retry fixes it.
|
|
60
|
+
|
|
42
61
|
Smoke test (a few seconds after launch -- give it time to bind):
|
|
43
62
|
```bash
|
|
44
63
|
curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
|
|
45
64
|
curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
|
|
46
|
-
curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker
|
|
65
|
+
curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker, `backlogMember.status` is "ready"
|
|
47
66
|
```
|
|
67
|
+
(Windows PowerShell 5.1: `curl` is an alias of `Invoke-WebRequest`; use
|
|
68
|
+
`curl.exe` with the same arguments, or `Invoke-RestMethod <url>`.)
|
|
48
69
|
Both must succeed before treating the supervisor as up -- a bound port with
|
|
49
70
|
a 500 on `/api/members` still means something is broken. A wrong
|
|
50
71
|
`beads.prefix` means it was started from the wrong folder: stop it and
|
|
@@ -146,15 +167,24 @@ restart command exists:
|
|
|
146
167
|
run its smoke test (`GET /api/sprints`, `GET /api/members`) to confirm the
|
|
147
168
|
new process is actually serving before treating the restart as done.
|
|
148
169
|
|
|
170
|
+
**Upgrading apra-fleet.** A running supervisor keeps the code it started
|
|
171
|
+
with. Before upgrading, let running sprints finish (or stop them) and stop
|
|
172
|
+
the supervisor; start it again afterwards. A
|
|
173
|
+
supervisor started under 0.4.3 does not send the install's access secret, so
|
|
174
|
+
a 0.4.4 fleet server refuses its requests with HTTP 401. If a sprint was
|
|
175
|
+
still running during the upgrade, the first launch may 409 on its stale
|
|
176
|
+
member reservations -- see "Common launch-time crashes" below.
|
|
177
|
+
|
|
149
178
|
## Auto-start on login/boot
|
|
150
179
|
|
|
151
|
-
Instead of a human running `
|
|
180
|
+
Instead of a human running `serve.mjs` by hand each session, the
|
|
152
181
|
supervisor can be registered with the OS to start automatically on
|
|
153
182
|
login/boot. Resolve commands per the target member's own OS (`agent.os`) --
|
|
154
183
|
do not assume the orchestrator's shell; some members run PowerShell, not
|
|
155
|
-
POSIX.
|
|
156
|
-
|
|
157
|
-
|
|
184
|
+
POSIX. A service manager does not start in your project folder, so every
|
|
185
|
+
example passes `--beads-dir`. Substitute the real paths: the user's home
|
|
186
|
+
(`/Users/<user>`, `/home/<user>` or `C:\Users\<user>`) and the target
|
|
187
|
+
project folder (`/path/to/project` or `C:\path\to\project`). After registering (any OS),
|
|
158
188
|
run the same-process smoke test from section 0 above (`GET /api/sprints`,
|
|
159
189
|
`GET /api/members`) against the newly auto-started instance to confirm it is
|
|
160
190
|
actually serving, not just that the OS accepted the registration.
|
|
@@ -166,7 +196,7 @@ user's own session):
|
|
|
166
196
|
|
|
167
197
|
Register:
|
|
168
198
|
```cmd
|
|
169
|
-
schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\
|
|
199
|
+
schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\Users\<user>\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs --beads-dir C:\path\to\project" /SC ONLOGON /RL LIMITED
|
|
170
200
|
```
|
|
171
201
|
De-register:
|
|
172
202
|
```cmd
|
|
@@ -182,8 +212,8 @@ in; requires NSSM installed and on PATH):
|
|
|
182
212
|
|
|
183
213
|
Register:
|
|
184
214
|
```cmd
|
|
185
|
-
nssm install ApraFleetSupervisor node "C:\
|
|
186
|
-
nssm set ApraFleetSupervisor AppDirectory "C:\path\to\
|
|
215
|
+
nssm install ApraFleetSupervisor node "C:\Users\<user>\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs" --beads-dir "C:\path\to\project"
|
|
216
|
+
nssm set ApraFleetSupervisor AppDirectory "C:\path\to\project"
|
|
187
217
|
nssm start ApraFleetSupervisor
|
|
188
218
|
```
|
|
189
219
|
De-register:
|
|
@@ -206,7 +236,9 @@ Create `~/Library/LaunchAgents/com.apra-fleet.supervisor.plist`:
|
|
|
206
236
|
<key>ProgramArguments</key>
|
|
207
237
|
<array>
|
|
208
238
|
<string>/usr/local/bin/node</string>
|
|
209
|
-
<string>/
|
|
239
|
+
<string>/Users/<user>/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs</string>
|
|
240
|
+
<string>--beads-dir</string>
|
|
241
|
+
<string>/path/to/project</string>
|
|
210
242
|
</array>
|
|
211
243
|
<key>RunAtLoad</key>
|
|
212
244
|
<true/>
|
|
@@ -246,9 +278,9 @@ Create `~/.config/systemd/user/apra-fleet-supervisor.service`:
|
|
|
246
278
|
Description=Apra Fleet supervisor
|
|
247
279
|
|
|
248
280
|
[Service]
|
|
249
|
-
ExecStart=/usr/bin/node /
|
|
281
|
+
ExecStart=/usr/bin/node /home/<user>/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs --beads-dir /path/to/project
|
|
250
282
|
Restart=no
|
|
251
|
-
WorkingDirectory=/path/to/
|
|
283
|
+
WorkingDirectory=/path/to/project
|
|
252
284
|
|
|
253
285
|
[Install]
|
|
254
286
|
WantedBy=default.target
|
|
@@ -279,9 +311,13 @@ start with no login (`loginctl enable-linger <username>`).
|
|
|
279
311
|
`bd dolt commit` then `bd dolt push`. Members pull their own copy; a
|
|
280
312
|
sprint launched before the push works from stale scope.
|
|
281
313
|
2. Check no conflicting sprint is already running: `GET /api/sprints`.
|
|
282
|
-
3. Multi-member sprints
|
|
283
|
-
launch
|
|
284
|
-
member
|
|
314
|
+
3. Multi-member sprints align their members to the sprint base
|
|
315
|
+
automatically at launch (WIP preserved in a named stash, one `[Align]`
|
|
316
|
+
line per member) -- do not align members by hand. The launch refuses only
|
|
317
|
+
for an unreachable member, differing origin URLs, a base missing on
|
|
318
|
+
origin, a fetch auth failure or a diverged sprint branch, naming the
|
|
319
|
+
member, cause and fix. Don't guess a member list -- ask, or default to
|
|
320
|
+
one.
|
|
285
321
|
|
|
286
322
|
## 2. Start a sprint
|
|
287
323
|
|
|
@@ -302,18 +338,24 @@ Field names, exactly as the API expects them:
|
|
|
302
338
|
| Field | Required | Notes |
|
|
303
339
|
|---|---|---|
|
|
304
340
|
| `issue` | yes | comma-separated bead root IDs (parent/epic OR a standalone leaf bead). Alias: `target_issue`. |
|
|
305
|
-
| `branch` | yes | created from `base` if it doesn't exist yet. |
|
|
341
|
+
| `branch` | yes | created from `base` if it doesn't exist yet. Must differ from `base` (an equal pair is a 400; case and `origin/`/`refs/heads/` prefixes are ignored). |
|
|
306
342
|
| `base` | yes | alias: `base_branch`. This is what the sprint branches FROM -- pass the branch you actually want, not always `main`. |
|
|
307
343
|
| `members` | yes | array of registered member names. One member = safest default. |
|
|
308
344
|
| `goal` | no | `P1`, `P1/P2` (default), or `P1/P2/P3`. |
|
|
309
345
|
| `maxCycles` | no | default 5. |
|
|
310
346
|
| `allowMissingMembers` | no | bool. |
|
|
311
|
-
| `requirementsFile` | no | path. |
|
|
312
|
-
| `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. |
|
|
347
|
+
| `requirementsFile` | no | path on the supervisor's machine; a relative path resolves against the supervisor's project folder. Not found = a run-log warning only, so prefer an absolute path. |
|
|
348
|
+
| `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. Leave out `backlog`: the supervisor injects its own backlog member; naming any other member there is a 400. `orchestrator` is the deprecated alias of `backlog` (removed in v0.5). |
|
|
313
349
|
| `budget` | no | USD cap. |
|
|
350
|
+
| `phases` | no | `{"regression": "skip"}` skips the regression pass (`"run"` is the default). Any other key or value is a 400. |
|
|
314
351
|
| `overrideRelaunchGate` | no | bool. See below. |
|
|
315
352
|
|
|
316
|
-
Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath
|
|
353
|
+
Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath`, and
|
|
354
|
+
`warnings` (e.g. the deprecation notice when `roleMap.orchestrator` was
|
|
355
|
+
used). A `503` means nothing was launched: the backlog member is not ready,
|
|
356
|
+
the fleet member list could not be read, the fleet server was stopped by its
|
|
357
|
+
user (`apra-fleet stop`), or the beads could not be verified fresh -- the
|
|
358
|
+
`error` says which.
|
|
317
359
|
**A 201 response does NOT mean the sprint is alive** -- it can crash in the
|
|
318
360
|
first few seconds (bad topology, bad member, etc). Always verify (step 3)
|
|
319
361
|
a few seconds after launch.
|
|
@@ -350,13 +392,25 @@ only use it once you know why the prior run died.
|
|
|
350
392
|
|
|
351
393
|
## Common launch-time crashes
|
|
352
394
|
|
|
353
|
-
- **Topology
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
395
|
+
- **Topology refusal**: members are aligned automatically (section 1), so
|
|
396
|
+
this names what could not be reconciled -- an unreachable member,
|
|
397
|
+
differing origin URLs, a base missing on origin, a fetch auth failure or
|
|
398
|
+
a diverged sprint branch. Fix what it names and relaunch; do not align
|
|
399
|
+
members by hand.
|
|
400
|
+
- **Beads identity** (`BeadsIdentityError`, before any dispatch): `bd`
|
|
401
|
+
missing on a member, a member resolving to a different beads project, or
|
|
402
|
+
a failed automatic beads set-up on a beads-reading member. The message
|
|
403
|
+
names the member and the fix.
|
|
357
404
|
- **Unregistered member**: `GET /api/members` to see valid names.
|
|
358
405
|
- **Stale LLM auth**: dispatch fails with `empty_response`. Re-run
|
|
359
406
|
`provision_llm_auth` for that member.
|
|
407
|
+
- **Stale member reservation** (`409 member overlap rejects launch: sprint
|
|
408
|
+
'<id or branch>' already claims [...]` while `GET /api/sprints` shows no
|
|
409
|
+
such sprint): a sprint died uncleanly (crash, or an upgrade with
|
|
410
|
+
`--ignore-running-sprints`) and left its members reserved on the fleet
|
|
411
|
+
server. Clear each listed member with the fleet MCP tool
|
|
412
|
+
`member_reservation {member_name: "<member>", action: "force_release"}`
|
|
413
|
+
(no supervisor HTTP route does this), then relaunch.
|
|
360
414
|
|
|
361
415
|
## Member layout: isolate deploy/test roles from dev roles
|
|
362
416
|
|
|
@@ -6,7 +6,9 @@
|
|
|
6
6
|
// unchanged. This is a move-only extraction: behaviour, validation order and
|
|
7
7
|
// error message text are all deliberately unchanged from the pre-move code.
|
|
8
8
|
import { normalizeRole, validateCredentialStoreName } from './contracts.mjs';
|
|
9
|
+
import { ROLE_KB_MAINTAINER } from './kb-maintainer.mjs';
|
|
9
10
|
import { parseExpectedIdentity } from './beads-identity.mjs';
|
|
11
|
+
import { resolveBacklogRoleAlias } from './backlog-role.mjs';
|
|
10
12
|
|
|
11
13
|
// ---------------------------------------------------------------------------
|
|
12
14
|
// CLI -> runner argument contract
|
|
@@ -33,7 +35,7 @@ const GOAL_PATTERN = /^P[1-3](\/P[1-3]){0,2}$/;
|
|
|
33
35
|
|
|
34
36
|
const KNOWN_ARG_KEYS = new Set([
|
|
35
37
|
'target_issues', 'target_issue', 'members', 'branch', 'base_branch',
|
|
36
|
-
'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'budget',
|
|
38
|
+
'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'roleMapWarnings', 'budget',
|
|
37
39
|
// Per-dispatch time budget (timeout_s == max_total_s at every dispatch
|
|
38
40
|
// site; integ ceiling = 2x), bounding the cost of a hung dispatch.
|
|
39
41
|
'dispatch_timeout_s',
|
|
@@ -91,6 +93,11 @@ const KNOWN_ARG_KEYS = new Set([
|
|
|
91
93
|
// itself -- see docs/fleet-sprint-cli-contract.md's "Dormant argument
|
|
92
94
|
// audit" section for the full record.
|
|
93
95
|
'assignee',
|
|
96
|
+
// Explicitly skip the once-per-sprint regression pass (launch option:
|
|
97
|
+
// the CLI's --skip-regression, the supervisor's phases.regression:"skip").
|
|
98
|
+
// Never silent: the engine logs it and the sprint report and PR body say
|
|
99
|
+
// "skipped by launch option". The integration-test phase is unaffected.
|
|
100
|
+
'skip_regression',
|
|
94
101
|
// Multi-streak worklist dispatch mode when a develop round has more ready
|
|
95
102
|
// streaks than doers. 'resume' (default): per-streak dispatches that resume
|
|
96
103
|
// the SAME doer session by explicit session id (warm-context carryover,
|
|
@@ -126,6 +133,15 @@ const KNOWN_ARG_KEYS = new Set([
|
|
|
126
133
|
// formula units). Default DEFAULT_EFFORT_THRESHOLD.
|
|
127
134
|
// No CLI flag sets this today; only test/programmatic callers pass it.
|
|
128
135
|
'worklist_effort_budget',
|
|
136
|
+
// Engine CI gate arg -- DELIBERATELY NOT WIRED (2026-10-01). ci-gate.mjs
|
|
137
|
+
// runs CI per reviewer dispatch and hands the result to the reviewer; the
|
|
138
|
+
// agreed direction is the opposite (CI never blocks or reaches doer/
|
|
139
|
+
// reviewer loops; the integ-test phase owns CI via one reopenable bead;
|
|
140
|
+
// per-push vs end-of-cycle triggering per project). Until the "fleet-sprint
|
|
141
|
+
// must also utilize CI as a resource for quality" epic (apra-fleet-dv8i)
|
|
142
|
+
// designs that flow, ci_gate is not a known arg, so passing it fails loudly
|
|
143
|
+
// as an unknown arg. The gate module stays in place, unconfigured.
|
|
144
|
+
// 'ci_gate',
|
|
129
145
|
// An optional live `(name, args) => Promise<any>` MCP tool-call function,
|
|
130
146
|
// wired by bin/cli.mjs from its already-connected `mcpClient.callTool`.
|
|
131
147
|
// Consumed by createMemberSessionGuard() to call the fleet's own
|
|
@@ -144,7 +160,7 @@ const KNOWN_ARG_KEYS = new Set([
|
|
|
144
160
|
// `--expect-beads`, env fallback FLEET_SPRINT_EXPECT_BEADS, or an already
|
|
145
161
|
// parsed record from a programmatic caller). Consumed by the
|
|
146
162
|
// verifyBeadsIdentity precondition (beads-identity-check.mjs); absent, the
|
|
147
|
-
//
|
|
163
|
+
// backlog member's own probed identity becomes the expectation.
|
|
148
164
|
'expect_beads',
|
|
149
165
|
]);
|
|
150
166
|
|
|
@@ -170,6 +186,47 @@ export function validateExpectBeads(raw) {
|
|
|
170
186
|
return parsed;
|
|
171
187
|
}
|
|
172
188
|
|
|
189
|
+
/** Default CI gate timeout (seconds) when ci_gate omits timeout_s. */
|
|
190
|
+
export const DEFAULT_CI_GATE_TIMEOUT_S = 3600;
|
|
191
|
+
// A workflow file name ("ci.yml") or numeric workflow id -- interpolated into
|
|
192
|
+
// a provider REST path, so restrictive by design.
|
|
193
|
+
const CI_GATE_WORKFLOW_PATTERN = /^[A-Za-z0-9._-]+$/;
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* Validates the optional ci_gate arg: { workflow: string, timeout_s?: positive
|
|
197
|
+
* integer (default 3600) }. Accepts the object, or its JSON string form (the
|
|
198
|
+
* CLI forwards --ci-gate verbatim). Absent -> undefined (gate not configured).
|
|
199
|
+
* @param {unknown} raw
|
|
200
|
+
* @returns {{ workflow: string, timeoutS: number }|undefined}
|
|
201
|
+
*/
|
|
202
|
+
export function validateCiGate(raw) {
|
|
203
|
+
if (raw === undefined || raw === null || raw === '') return undefined;
|
|
204
|
+
let value = raw;
|
|
205
|
+
if (typeof raw === 'string') {
|
|
206
|
+
try {
|
|
207
|
+
value = JSON.parse(raw);
|
|
208
|
+
} catch {
|
|
209
|
+
throw new Error(`[Arg Contract] Invalid ci_gate: not valid JSON (${JSON.stringify(raw).slice(0, 200)}). Expected {"workflow": "<workflow file name or id>", "timeout_s": <positive integer>}.`);
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
if (!value || typeof value !== 'object' || Array.isArray(value)) {
|
|
213
|
+
throw new Error('[Arg Contract] Invalid ci_gate: must be an object {"workflow": "<workflow file name or id>", "timeout_s": <positive integer, default 3600>}.');
|
|
214
|
+
}
|
|
215
|
+
const unknown = Object.keys(value).filter((k) => k !== 'workflow' && k !== 'timeout_s');
|
|
216
|
+
if (unknown.length > 0) {
|
|
217
|
+
throw new Error(`[Arg Contract] Invalid ci_gate: unknown key(s) ${unknown.join(', ')}. Known keys: workflow, timeout_s.`);
|
|
218
|
+
}
|
|
219
|
+
const workflow = value.workflow;
|
|
220
|
+
if (typeof workflow !== 'string' || workflow.length === 0 || !CI_GATE_WORKFLOW_PATTERN.test(workflow)) {
|
|
221
|
+
throw new Error(`[Arg Contract] Invalid ci_gate.workflow "${workflow}": required; must be a workflow file name or numeric id matching ${CI_GATE_WORKFLOW_PATTERN}.`);
|
|
222
|
+
}
|
|
223
|
+
const timeoutS = value.timeout_s === undefined ? DEFAULT_CI_GATE_TIMEOUT_S : value.timeout_s;
|
|
224
|
+
if (typeof timeoutS !== 'number' || !Number.isInteger(timeoutS) || timeoutS <= 0) {
|
|
225
|
+
throw new Error(`[Arg Contract] Invalid ci_gate.timeout_s "${timeoutS}": must be a positive integer (seconds).`);
|
|
226
|
+
}
|
|
227
|
+
return { workflow, timeoutS };
|
|
228
|
+
}
|
|
229
|
+
|
|
173
230
|
/**
|
|
174
231
|
* Validates a single issue id against the shell-injection-safe pattern.
|
|
175
232
|
* Throws with a clear message on rejection.
|
|
@@ -198,6 +255,36 @@ export function validateBranchName(name, label) {
|
|
|
198
255
|
return name;
|
|
199
256
|
}
|
|
200
257
|
|
|
258
|
+
// Strip the ref prefixes a caller may legitimately pass for the same branch
|
|
259
|
+
// (refs/heads/<b>, origin/<b>, refs/remotes/origin/<b>) so "main",
|
|
260
|
+
// "origin/main" and "refs/heads/main" all compare equal. Compared
|
|
261
|
+
// case-insensitively: a pair differing only in case is never a legitimate
|
|
262
|
+
// sprint (case-insensitive filesystems and hosts treat them as one branch).
|
|
263
|
+
function normalizeBranchForCompare(name) {
|
|
264
|
+
let n = String(name).toLowerCase();
|
|
265
|
+
for (const prefix of ['refs/remotes/origin/', 'refs/heads/', 'origin/']) {
|
|
266
|
+
if (n.startsWith(prefix)) { n = n.slice(prefix.length); break; }
|
|
267
|
+
}
|
|
268
|
+
return n;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/**
|
|
272
|
+
* Rejects a sprint whose working branch is its base branch (GitHub #613):
|
|
273
|
+
* the review range base..branch would be empty, doer commits would land
|
|
274
|
+
* directly on the base, and the closing PR could never be opened (head ==
|
|
275
|
+
* base). Shared by validateArgs, bin/cli.mjs and the supervisor launch API so
|
|
276
|
+
* every entry point refuses the same pairs with the same message.
|
|
277
|
+
*
|
|
278
|
+
* @param {string} branch
|
|
279
|
+
* @param {string} base
|
|
280
|
+
*/
|
|
281
|
+
export function validateBranchPair(branch, base) {
|
|
282
|
+
if (typeof branch !== 'string' || typeof base !== 'string') return;
|
|
283
|
+
if (normalizeBranchForCompare(branch) === normalizeBranchForCompare(base)) {
|
|
284
|
+
throw new Error(`[Arg Contract] Invalid branch "${branch}": must differ from base_branch "${base}" (the sprint works on its own branch and opens a PR into the base).`);
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
|
|
201
288
|
/**
|
|
202
289
|
* Validates and normalizes the args object passed into main(context).
|
|
203
290
|
* Rejects unknown keys and missing/malformed required keys loudly.
|
|
@@ -254,6 +341,7 @@ export function validateArgs(args) {
|
|
|
254
341
|
throw new Error('[Arg Contract] Missing required arg: base_branch (branch the sprint branch is created from and the PR targets).');
|
|
255
342
|
}
|
|
256
343
|
validateBranchName(args.base_branch, 'base_branch');
|
|
344
|
+
validateBranchPair(args.branch, args.base_branch);
|
|
257
345
|
|
|
258
346
|
// --- goal (optional, default 'P1/P2'; the priority band this sprint aims
|
|
259
347
|
// to clear, consumed by the exit-condition logic) ---
|
|
@@ -297,6 +385,41 @@ export function validateArgs(args) {
|
|
|
297
385
|
}
|
|
298
386
|
normalizedRoleMap[key] = value;
|
|
299
387
|
}
|
|
388
|
+
// kb_maintainer is an accepted roleMap key but NOT a dispatched role:
|
|
389
|
+
// it names the member(s) that receive every KB write for their own
|
|
390
|
+
// repository (kb-maintainer.mjs). Its members must be sprint members,
|
|
391
|
+
// since selection probes them through the sprint's member access.
|
|
392
|
+
if (Object.prototype.hasOwnProperty.call(normalizedRoleMap, ROLE_KB_MAINTAINER)) {
|
|
393
|
+
const list = normalizedRoleMap[ROLE_KB_MAINTAINER];
|
|
394
|
+
if (!Array.isArray(list) || list.some((m) => typeof m !== 'string' || m.length === 0)) {
|
|
395
|
+
throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: must be an array of non-empty member names.`);
|
|
396
|
+
}
|
|
397
|
+
const stray = list.filter((m) => !args.members.includes(m));
|
|
398
|
+
if (stray.length > 0) {
|
|
399
|
+
const quoted = stray.map((m) => '"' + m + '"').join(', ');
|
|
400
|
+
throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: ${quoted} not in members.`);
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
// Backlog-role alias: the deprecated 'orchestrator' key is folded into
|
|
405
|
+
// 'backlog' here (downstream readers only ever see 'backlog'); a conflict
|
|
406
|
+
// is an arg-contract error. Warnings -- plus any the CLI already collected
|
|
407
|
+
// (args.roleMapWarnings, since the CLI rewrites the key before the runner
|
|
408
|
+
// sees it) -- are surfaced on the validated object for the runner to log.
|
|
409
|
+
const roleMapWarnings = [];
|
|
410
|
+
if (normalizedRoleMap !== undefined) {
|
|
411
|
+
try {
|
|
412
|
+
const resolved = resolveBacklogRoleAlias(normalizedRoleMap);
|
|
413
|
+
normalizedRoleMap = resolved.roleMap;
|
|
414
|
+
roleMapWarnings.push(...resolved.warnings);
|
|
415
|
+
} catch (err) {
|
|
416
|
+
throw new Error(`[Arg Contract] Invalid roleMap: ${err.message}`);
|
|
417
|
+
}
|
|
418
|
+
}
|
|
419
|
+
if (Array.isArray(args.roleMapWarnings)) {
|
|
420
|
+
for (const w of args.roleMapWarnings) {
|
|
421
|
+
if (typeof w === 'string' && !roleMapWarnings.includes(w)) roleMapWarnings.push(w);
|
|
422
|
+
}
|
|
300
423
|
}
|
|
301
424
|
|
|
302
425
|
// --- budget (optional) -----------------------------------------------
|
|
@@ -379,6 +502,12 @@ export function validateArgs(args) {
|
|
|
379
502
|
throw new Error(`[Arg Contract] Invalid doer_worklist_mode "${doerWorklistMode}": must be 'resume' (default) or 'batch'.`);
|
|
380
503
|
}
|
|
381
504
|
|
|
505
|
+
// --- skip_regression (optional, default false) -------------------------
|
|
506
|
+
const skipRegression = args.skip_regression === undefined ? false : args.skip_regression;
|
|
507
|
+
if (typeof skipRegression !== 'boolean') {
|
|
508
|
+
throw new Error(`[Arg Contract] Invalid skip_regression "${skipRegression}": must be a boolean.`);
|
|
509
|
+
}
|
|
510
|
+
|
|
382
511
|
// --- resume_model_switch (optional, default false) ---------------------
|
|
383
512
|
const resumeModelSwitch = args.resume_model_switch === undefined ? false : args.resume_model_switch;
|
|
384
513
|
if (typeof resumeModelSwitch !== 'boolean') {
|
|
@@ -429,6 +558,10 @@ export function validateArgs(args) {
|
|
|
429
558
|
// --- expect_beads (optional) ------------------------------------------
|
|
430
559
|
const expectBeads = validateExpectBeads(args.expect_beads);
|
|
431
560
|
|
|
561
|
+
// --- ci_gate: NOT WIRED (see the KNOWN_ARG_KEYS note; apra-fleet-dv8i) ---
|
|
562
|
+
// const ciGate = validateCiGate(args.ci_gate);
|
|
563
|
+
const ciGate = undefined;
|
|
564
|
+
|
|
432
565
|
return {
|
|
433
566
|
targetIssues,
|
|
434
567
|
members: args.members,
|
|
@@ -438,6 +571,7 @@ export function validateArgs(args) {
|
|
|
438
571
|
maxCycles,
|
|
439
572
|
requirementsFile: args.requirementsFile,
|
|
440
573
|
roleMap: normalizedRoleMap,
|
|
574
|
+
roleMapWarnings,
|
|
441
575
|
budget: args.budget,
|
|
442
576
|
serviceUrl: args.serviceUrl,
|
|
443
577
|
runId: args.run_id,
|
|
@@ -446,9 +580,11 @@ export function validateArgs(args) {
|
|
|
446
580
|
azdevopsPatSecretName: args.azdevops_pat_secret_name,
|
|
447
581
|
doerWorklistMode,
|
|
448
582
|
resumeModelSwitch,
|
|
583
|
+
skipRegression,
|
|
449
584
|
worklistEffortBudget: args.worklist_effort_budget,
|
|
450
585
|
usageLimitMaxWaitS: args.usage_limit_max_wait_s,
|
|
451
586
|
usageLimitMaxReprobes: args.usage_limit_max_reprobes,
|
|
452
587
|
expectBeads,
|
|
588
|
+
ciGate,
|
|
453
589
|
};
|
|
454
590
|
}
|
|
@@ -11,8 +11,9 @@
|
|
|
11
11
|
// builder (module-private -- it is the body builder buildCostAnalysis
|
|
12
12
|
// and the PR text path share, so it moves with them rather than staying
|
|
13
13
|
// behind).
|
|
14
|
-
// - buildCostAnalysis: the
|
|
15
|
-
//
|
|
14
|
+
// - buildCostAnalysis: the sprint cost block (appended to analysisText and
|
|
15
|
+
// rendered in the PR body), reporting budget/spend honestly from the live
|
|
16
|
+
// `budget` object.
|
|
16
17
|
// - computeBranchSlug: the collision-resistant filesystem slug for
|
|
17
18
|
// `docs/sprint-analysis-<slug>.md`.
|
|
18
19
|
//
|
|
@@ -22,6 +23,7 @@
|
|
|
22
23
|
|
|
23
24
|
import { createHash } from 'crypto';
|
|
24
25
|
import { SAFE_TEXT_RE } from './newtask-text.mjs';
|
|
26
|
+
import { formatDispatchToolCalls } from './dispatch-accounting.mjs';
|
|
25
27
|
|
|
26
28
|
// ---------------------------------------------------------------------------
|
|
27
29
|
// PR body/title text sanitization. The final reviewer's verdict notes are LLM
|
|
@@ -64,6 +66,61 @@ export function sanitizePrText(text) {
|
|
|
64
66
|
// Finalization prompt builders
|
|
65
67
|
// ---------------------------------------------------------------------------
|
|
66
68
|
|
|
69
|
+
/**
|
|
70
|
+
* " (<part>: pass, <part>: fail)" from the playbook-defined `sections`, or
|
|
71
|
+
* from the deprecated two-part fields when an older runner returned those;
|
|
72
|
+
* '' when neither is present. The part names are the target playbook's own.
|
|
73
|
+
* @param {object} r regression-test-runner result
|
|
74
|
+
* @returns {string}
|
|
75
|
+
*/
|
|
76
|
+
export function formatRegressionParts(r) {
|
|
77
|
+
const pf = (v) => (v === true ? 'pass' : 'fail');
|
|
78
|
+
let parts = [];
|
|
79
|
+
if (Array.isArray(r.sections) && r.sections.length > 0) {
|
|
80
|
+
parts = r.sections.map((s) => `${s.name}: ${pf(s.passed)}`);
|
|
81
|
+
} else {
|
|
82
|
+
if (typeof r.suitePassed === 'boolean') parts.push(`part 1: ${pf(r.suitePassed)}`);
|
|
83
|
+
if (typeof r.smokePassed === 'boolean') parts.push(`part 2: ${pf(r.smokePassed)}`);
|
|
84
|
+
}
|
|
85
|
+
return parts.length ? ` (${parts.join(', ')})` : '';
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
const REGRESSION_VERDICTS = ['PASS', 'FAIL', 'INCONCLUSIVE'];
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* The regression verdict, or null when the runner reported none. A verdict
|
|
92
|
+
* is copied verbatim from a machine-written verdict file (see
|
|
93
|
+
* agents/regression-test-runner.md), so it outranks the boolean `passed`:
|
|
94
|
+
* INCONCLUSIVE must never be rendered as a failure.
|
|
95
|
+
* @param {object} r regression-test-runner result
|
|
96
|
+
* @returns {'PASS'|'FAIL'|'INCONCLUSIVE'|null}
|
|
97
|
+
*/
|
|
98
|
+
export function regressionVerdictOf(r) {
|
|
99
|
+
return r && REGRESSION_VERDICTS.includes(r.verdict) ? r.verdict : null;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* One-line headline for a regression result: "Regression: <VERDICT> @ <sha12>
|
|
104
|
+
* (parts) [evidence counts] <runUrl>" when a verdict is present, else the legacy
|
|
105
|
+
* "Regression pass: PASSED|FAILED (parts)". No trailing period.
|
|
106
|
+
* @param {object} r regression-test-runner result
|
|
107
|
+
* @returns {string}
|
|
108
|
+
*/
|
|
109
|
+
export function formatRegressionHeadline(r) {
|
|
110
|
+
const verdict = regressionVerdictOf(r);
|
|
111
|
+
if (verdict) {
|
|
112
|
+
const sha = typeof r.testedSha === 'string' && r.testedSha ? ` @ ${r.testedSha.slice(0, 12)}` : '';
|
|
113
|
+
const ev = r.evidence && typeof r.evidence === 'object' ? r.evidence : {};
|
|
114
|
+
const counts = [];
|
|
115
|
+
if (Array.isArray(ev.newFailures)) counts.push(`${ev.newFailures.length} new failure(s)`);
|
|
116
|
+
if (Array.isArray(ev.inventoryMissing)) counts.push(`${ev.inventoryMissing.length} inventory missing`);
|
|
117
|
+
const evText = counts.length ? ` [${counts.join(', ')}]` : '';
|
|
118
|
+
const url = typeof ev.runUrl === 'string' && ev.runUrl ? ` ${ev.runUrl}` : '';
|
|
119
|
+
return `Regression: ${verdict}${sha}${formatRegressionParts(r)}${evText}${url}`;
|
|
120
|
+
}
|
|
121
|
+
return `Regression pass: ${r.passed === true ? 'PASSED' : 'FAILED'}${formatRegressionParts(r)}`;
|
|
122
|
+
}
|
|
123
|
+
|
|
67
124
|
/**
|
|
68
125
|
* Assembles the `analysisText` block for the Harvester dispatch from this
|
|
69
126
|
* run's in-memory tracking state: cycle-by-cycle closed-bead progress,
|
|
@@ -85,17 +142,28 @@ export function buildAnalysisText({
|
|
|
85
142
|
// as "nothing was skipped".
|
|
86
143
|
finalDeferredAtGoalIds = [],
|
|
87
144
|
regressionResult = null,
|
|
145
|
+
// Set when the pass was deliberately skipped (e.g. 'launch option'), so the
|
|
146
|
+
// report says so instead of the misleading "no playbook" line.
|
|
147
|
+
regressionSkippedBy = null,
|
|
148
|
+
// Per-dispatch kb_* and code_* call records (sprint state's dispatchToolCalls,
|
|
149
|
+
// from session_stats snapshots). Omitted -> no section; an unknown count
|
|
150
|
+
// is printed as unknown, never 0.
|
|
151
|
+
dispatchToolCalls = null,
|
|
152
|
+
// The KB work client's unpublishedBible(): per repository, confirmations
|
|
153
|
+
// still not in a pushed bible commit. Rendered as a loud section only
|
|
154
|
+
// when any are, so a sprint whose bible was published reads as before.
|
|
155
|
+
kbBibleUnpublished = null,
|
|
88
156
|
}) {
|
|
89
157
|
// The once-per-sprint Regression Test phase runs after the final verdict
|
|
90
158
|
// and never gates it. Its failures are filed as parent-less carry-over
|
|
91
159
|
// beads, so they never appear in the open-at-goal count and are reported
|
|
92
160
|
// separately here.
|
|
93
|
-
const regressionLines =
|
|
161
|
+
const regressionLines = regressionSkippedBy
|
|
162
|
+
? [`Regression pass: skipped by ${regressionSkippedBy} -- not run this sprint.`]
|
|
163
|
+
: regressionResult === null
|
|
94
164
|
? ['Regression pass: not run this sprint (no regression-test-playbook.md, or the probe failed).']
|
|
95
165
|
: [
|
|
96
|
-
|
|
97
|
-
+ `(real-bd suite: ${regressionResult.suitePassed === true ? 'pass' : 'fail'}, `
|
|
98
|
-
+ `smoke test: ${regressionResult.smokePassed === true ? 'pass' : 'fail'}).`,
|
|
166
|
+
`${formatRegressionHeadline(regressionResult)}.`,
|
|
99
167
|
`Carry-over beads filed: ${(regressionResult.bugsFiled || []).join(', ') || 'none'}.`,
|
|
100
168
|
`Summary: ${regressionResult.summary || '(none reported)'}`,
|
|
101
169
|
'Informational only -- this pass ran after the final verdict and did not gate it; any bead '
|
|
@@ -141,16 +209,48 @@ export function buildAnalysisText({
|
|
|
141
209
|
'## Regression pass (once per sprint, informational)',
|
|
142
210
|
'',
|
|
143
211
|
...regressionLines,
|
|
212
|
+
...kbBibleLines(kbBibleUnpublished),
|
|
144
213
|
];
|
|
214
|
+
if (Array.isArray(dispatchToolCalls)) {
|
|
215
|
+
lines.push(
|
|
216
|
+
'',
|
|
217
|
+
'## KB and code tool calls per member per dispatch',
|
|
218
|
+
'',
|
|
219
|
+
"Counted by each member's own fleet server (session_stats before/after each dispatch; the engine's own reads are excluded). 'unknown' means the count could not be read -- it is not zero.",
|
|
220
|
+
'',
|
|
221
|
+
...formatDispatchToolCalls(dispatchToolCalls),
|
|
222
|
+
);
|
|
223
|
+
}
|
|
145
224
|
return lines.join('\n');
|
|
146
225
|
}
|
|
147
226
|
|
|
148
227
|
/**
|
|
149
|
-
*
|
|
150
|
-
*
|
|
151
|
-
*
|
|
152
|
-
*
|
|
153
|
-
*
|
|
228
|
+
* The analysis section for KB confirmations that never reached a pushed bible
|
|
229
|
+
* commit (the push kept failing, the maintainer stayed busy or unreachable, or
|
|
230
|
+
* bible commits were sealed). Empty when every confirmation was published.
|
|
231
|
+
* @param {{ repos?: Array<{ repo: string, count: number }>, sealedReason?: string|null }|null} unpublished
|
|
232
|
+
* @returns {string[]}
|
|
233
|
+
*/
|
|
234
|
+
function kbBibleLines(unpublished) {
|
|
235
|
+
const repos = unpublished && Array.isArray(unpublished.repos) ? unpublished.repos.filter((r) => r && r.count > 0) : [];
|
|
236
|
+
if (repos.length === 0) return [];
|
|
237
|
+
return [
|
|
238
|
+
'',
|
|
239
|
+
'## KB bible',
|
|
240
|
+
'',
|
|
241
|
+
'WARNING: bible not published -- these KB confirmations are not in a pushed bible commit on the sprint branch'
|
|
242
|
+
+ ' as of this analysis (the harvest round retries once more after it is written):',
|
|
243
|
+
...repos.map((r) => `- ${r.repo}: ${r.count} unpublished confirmation(s).`),
|
|
244
|
+
...(unpublished.sealedReason ? [`Bible commits were sealed: ${unpublished.sealedReason}.`] : []),
|
|
245
|
+
];
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Builds the sprint cost block (appended to the analysis document and rendered
|
|
250
|
+
* in the PR body) from the live `budget` object. Reports only what is known:
|
|
251
|
+
* an unset ceiling, an absent spent() and an unpriced-model spend gap are each
|
|
252
|
+
* stated as such rather than backfilled with a fabricated number, since the
|
|
253
|
+
* block is published verbatim and never recomputed. The remaining budget is derived from
|
|
154
254
|
* `total` and `spent()`, not read from the budget object.
|
|
155
255
|
* @param {{ total: number|null, spent?: () => number, pricingSummary?: () => { real: number, fallback: number } }} budget
|
|
156
256
|
* @param {{ spend?: number, dispatchCount?: number }} [integTestRunnerStats] -- apra-fleet-nwh.1:
|
|
@@ -137,7 +137,20 @@ export async function resolveSettleShellWith({ fleetApi, member, log = () => {}
|
|
|
137
137
|
* fleetApi: object|null,
|
|
138
138
|
* resolveMemberProvider: ((member: string) => Promise<string|undefined>)|undefined,
|
|
139
139
|
* resolveSettleShell: (opts: { member: string, log?: Function }) => Promise<string>,
|
|
140
|
+
* dispatchToolCalls: object[],
|
|
141
|
+
* memberInit: object[],
|
|
142
|
+
* startedAtMs: number,
|
|
140
143
|
* }}
|
|
144
|
+
*
|
|
145
|
+
* `dispatchToolCalls` is the sprint's per-dispatch kb_* and code_* call record
|
|
146
|
+
* list (dispatch-accounting.mjs appends one entry per member dispatch, from
|
|
147
|
+
* session_stats snapshots taken before and after it). The sprint summary and
|
|
148
|
+
* the viewer read it from here.
|
|
149
|
+
*
|
|
150
|
+
* `memberInit` holds one record per member from the sprint-init probe
|
|
151
|
+
* (member-init-probe.mjs MemberInitRecord): verified status, fleetMcp, tool
|
|
152
|
+
* presence, CONFIRMED count and code index state. Filled once at sprint init
|
|
153
|
+
* and read by the KNOWLEDGE BANK injection and the viewer.
|
|
141
154
|
*/
|
|
142
155
|
export function createSprintState({ callTool, log = () => {}, createFleetApi } = {}) {
|
|
143
156
|
const active = typeof callTool === 'function';
|
|
@@ -152,12 +165,21 @@ export function createSprintState({ callTool, log = () => {}, createFleetApi } =
|
|
|
152
165
|
// createMemberVcsProviderResolver and is unchanged by the relocation.
|
|
153
166
|
const resolveMemberProvider = active ? createMemberVcsProviderResolver({ callTool, log }) : undefined;
|
|
154
167
|
|
|
168
|
+
// The sprint's ONE start stamp, taken when the state is built at the top
|
|
169
|
+
// of runSprintCycle. Every "since this sprint started" decision reads it
|
|
170
|
+
// (the stale in_progress reclaim, the KB promotion-candidate window)
|
|
171
|
+
// rather than taking its own Date.now().
|
|
172
|
+
const startedAtMs = Date.now();
|
|
173
|
+
|
|
155
174
|
return {
|
|
175
|
+
startedAtMs,
|
|
156
176
|
callTool: active ? callTool : undefined,
|
|
157
177
|
fleetApi,
|
|
158
178
|
resolveMemberProvider,
|
|
159
179
|
resolveSettleShell({ member, log: callLog = log } = {}) {
|
|
160
180
|
return resolveSettleShellWith({ fleetApi, member, log: callLog });
|
|
161
181
|
},
|
|
182
|
+
dispatchToolCalls: [],
|
|
183
|
+
memberInit: [],
|
|
162
184
|
};
|
|
163
185
|
}
|