@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,7 +1,72 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Azure DevOps VCS provider
|
|
2
|
+
* Azure DevOps VCS provider -- deploys PAT credentials via git credential helper.
|
|
3
3
|
* Auth pattern: placeholder username + PAT as password (see PAT_USERNAME).
|
|
4
4
|
*/
|
|
5
5
|
import type { VcsProviderService } from './types.js';
|
|
6
|
+
/**
|
|
7
|
+
* Every host Azure DevOps serves git over, ANCHORED (a substring test would
|
|
8
|
+
* let `dev.azure.com.evil.example` claim this provider):
|
|
9
|
+
* - dev.azure.com modern https remotes
|
|
10
|
+
* - ssh.dev.azure.com modern v3 ssh remotes
|
|
11
|
+
* - <org>.visualstudio.com legacy https remotes (org = first DNS label)
|
|
12
|
+
* - vs-ssh.visualstudio.com legacy v3 ssh remotes
|
|
13
|
+
* Kept in step with src/utils/vcs-provider-detect.ts's AZURE_DEVOPS_HOST_RE
|
|
14
|
+
* and the engine-side HOST_RE in
|
|
15
|
+
* packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs.
|
|
16
|
+
*/
|
|
17
|
+
export declare const AZURE_DEVOPS_HOST_RE: RegExp;
|
|
18
|
+
/** Both git transports an Azure DevOps remote can use. A PAT only ever
|
|
19
|
+
* applies to `https`; an `ssh` remote authenticates with the member's SSH
|
|
20
|
+
* key and the PAT is deployed for REST (pull-request) calls only. */
|
|
21
|
+
export type AzureDevOpsTransport = 'https' | 'ssh';
|
|
22
|
+
export interface AzureDevOpsRepoRef {
|
|
23
|
+
org: string;
|
|
24
|
+
project: string;
|
|
25
|
+
repo: string;
|
|
26
|
+
/** Lowercased hostname the remote points at. */
|
|
27
|
+
host: string;
|
|
28
|
+
transport: AzureDevOpsTransport;
|
|
29
|
+
/** True for the legacy `<org>.visualstudio.com` / `vs-ssh.visualstudio.com` hosts. */
|
|
30
|
+
legacy: boolean;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Parse an Azure DevOps git remote URL into its { org, project, repo }
|
|
34
|
+
* coordinates -- the identity every Azure DevOps REST call needs -- plus the
|
|
35
|
+
* host and transport it was reached on. The SERVER-side twin of the engine's
|
|
36
|
+
* parseRepoRef() (packages/apra-fleet-se/fleet-sprint/vcs-providers/
|
|
37
|
+
* azure-devops.mjs); the two are kept in step by hand because the engine is
|
|
38
|
+
* a separate package that cannot import from src/.
|
|
39
|
+
*
|
|
40
|
+
* Recognized shapes:
|
|
41
|
+
* https://[user@]dev.azure.com/ORG/PROJECT/_git/REPO[.git][/]
|
|
42
|
+
* https://[user@]dev.azure.com/ORG/_git/REPO (project == repo)
|
|
43
|
+
* https://[user@]ORG.visualstudio.com/[DefaultCollection/]PROJECT/_git/REPO
|
|
44
|
+
* https://[user@]ORG.visualstudio.com/[DefaultCollection/]_git/REPO (project == repo)
|
|
45
|
+
* git@ssh.dev.azure.com:v3/ORG/PROJECT/REPO
|
|
46
|
+
* ORG@vs-ssh.visualstudio.com:v3/ORG/PROJECT/REPO
|
|
47
|
+
* ssh://git@ssh.dev.azure.com[:22]/v3/ORG/PROJECT/REPO
|
|
48
|
+
*
|
|
49
|
+
* Percent-encoded project names (Azure DevOps allows spaces) are decoded in
|
|
50
|
+
* every returned field. NEVER throws; returns null for anything that is not
|
|
51
|
+
* one of the shapes above, including a lookalike host.
|
|
52
|
+
*/
|
|
53
|
+
export declare function parseAzureDevOpsRemote(remoteUrl: unknown): AzureDevOpsRepoRef | null;
|
|
54
|
+
/**
|
|
55
|
+
* Extract the organization from an Azure DevOps org URL, accepting both
|
|
56
|
+
* hosts: "https://dev.azure.com/myorg" and the legacy
|
|
57
|
+
* "https://myorg.visualstudio.com[/...]". Falls back to the input verbatim
|
|
58
|
+
* (the historical behaviour) when neither shape matches.
|
|
59
|
+
*/
|
|
60
|
+
export declare function extractAzureDevOpsOrg(orgUrl: string): string;
|
|
61
|
+
/**
|
|
62
|
+
* The host the git credential helper is bound to for a given credential
|
|
63
|
+
* scope URL. A scope on a legacy `<org>.visualstudio.com` host binds the PAT
|
|
64
|
+
* to THAT host: git looks credentials up by the remote's own hostname, so a
|
|
65
|
+
* helper registered for dev.azure.com is never consulted for a push to
|
|
66
|
+
* `https://myorg.visualstudio.com/...`. Every other scope (the default bare
|
|
67
|
+
* `https://dev.azure.com`, an org- or repo-scoped modern URL, a non-Azure or
|
|
68
|
+
* unparseable value) keeps the modern host.
|
|
69
|
+
*/
|
|
70
|
+
export declare function credentialHostForScope(scopeUrl?: string): string;
|
|
6
71
|
export declare const azureDevOpsProvider: VcsProviderService;
|
|
7
72
|
//# sourceMappingURL=azure-devops.d.ts.map
|
|
@@ -1,8 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Azure DevOps VCS provider
|
|
2
|
+
* Azure DevOps VCS provider -- deploys PAT credentials via git credential helper.
|
|
3
3
|
* Auth pattern: placeholder username + PAT as password (see PAT_USERNAME).
|
|
4
4
|
*/
|
|
5
5
|
import { knownRepoRemoteUrl } from '../member-remote-url.js';
|
|
6
|
+
/** The modern Azure DevOps host. The git credential helper is bound to THIS
|
|
7
|
+
* host unless the credential's scope URL names a legacy host -- see
|
|
8
|
+
* credentialHostForScope(). */
|
|
6
9
|
const HOST = 'dev.azure.com';
|
|
7
10
|
// The username written into the git credential helper next to the PAT. It
|
|
8
11
|
// MUST be non-empty: with `username=` (empty) git still sends an
|
|
@@ -16,26 +19,190 @@ const HOST = 'dev.azure.com';
|
|
|
16
19
|
// is the customary placeholder. Mirrors src/services/vcs/github.ts's
|
|
17
20
|
// `x-access-token` convention of a named constant, not an inline literal.
|
|
18
21
|
const PAT_USERNAME = 'pat';
|
|
22
|
+
/**
|
|
23
|
+
* Every host Azure DevOps serves git over, ANCHORED (a substring test would
|
|
24
|
+
* let `dev.azure.com.evil.example` claim this provider):
|
|
25
|
+
* - dev.azure.com modern https remotes
|
|
26
|
+
* - ssh.dev.azure.com modern v3 ssh remotes
|
|
27
|
+
* - <org>.visualstudio.com legacy https remotes (org = first DNS label)
|
|
28
|
+
* - vs-ssh.visualstudio.com legacy v3 ssh remotes
|
|
29
|
+
* Kept in step with src/utils/vcs-provider-detect.ts's AZURE_DEVOPS_HOST_RE
|
|
30
|
+
* and the engine-side HOST_RE in
|
|
31
|
+
* packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs.
|
|
32
|
+
*/
|
|
33
|
+
export const AZURE_DEVOPS_HOST_RE = /^(?:dev\.azure\.com|ssh\.dev\.azure\.com|(?:[a-z0-9-]+\.)*visualstudio\.com)$/i;
|
|
34
|
+
/** Percent-decode one path segment; an invalid escape is left as-is because
|
|
35
|
+
* the parser must never throw. */
|
|
36
|
+
function decodeSegment(segment) {
|
|
37
|
+
try {
|
|
38
|
+
return decodeURIComponent(segment);
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return segment;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
/** Split a remote URL into { host, path, scheme } for BOTH shapes git
|
|
45
|
+
* speaks: a real scheme'd URL and the scp-like `user@host:path` shorthand
|
|
46
|
+
* `new URL()` cannot parse. */
|
|
47
|
+
function splitRemote(url) {
|
|
48
|
+
if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
|
|
49
|
+
let parsed;
|
|
50
|
+
try {
|
|
51
|
+
parsed = new URL(url);
|
|
52
|
+
}
|
|
53
|
+
catch {
|
|
54
|
+
return null;
|
|
55
|
+
}
|
|
56
|
+
if (!parsed.hostname)
|
|
57
|
+
return null;
|
|
58
|
+
return { host: parsed.hostname.toLowerCase(), path: parsed.pathname, scheme: parsed.protocol.replace(/:$/, '').toLowerCase() };
|
|
59
|
+
}
|
|
60
|
+
const scp = /^(?:[^@\s/]+@)?([^:\s/]+):(.*)$/.exec(url);
|
|
61
|
+
if (!scp)
|
|
62
|
+
return null;
|
|
63
|
+
return { host: scp[1].toLowerCase(), path: `/${scp[2]}`, scheme: 'ssh' };
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Parse an Azure DevOps git remote URL into its { org, project, repo }
|
|
67
|
+
* coordinates -- the identity every Azure DevOps REST call needs -- plus the
|
|
68
|
+
* host and transport it was reached on. The SERVER-side twin of the engine's
|
|
69
|
+
* parseRepoRef() (packages/apra-fleet-se/fleet-sprint/vcs-providers/
|
|
70
|
+
* azure-devops.mjs); the two are kept in step by hand because the engine is
|
|
71
|
+
* a separate package that cannot import from src/.
|
|
72
|
+
*
|
|
73
|
+
* Recognized shapes:
|
|
74
|
+
* https://[user@]dev.azure.com/ORG/PROJECT/_git/REPO[.git][/]
|
|
75
|
+
* https://[user@]dev.azure.com/ORG/_git/REPO (project == repo)
|
|
76
|
+
* https://[user@]ORG.visualstudio.com/[DefaultCollection/]PROJECT/_git/REPO
|
|
77
|
+
* https://[user@]ORG.visualstudio.com/[DefaultCollection/]_git/REPO (project == repo)
|
|
78
|
+
* git@ssh.dev.azure.com:v3/ORG/PROJECT/REPO
|
|
79
|
+
* ORG@vs-ssh.visualstudio.com:v3/ORG/PROJECT/REPO
|
|
80
|
+
* ssh://git@ssh.dev.azure.com[:22]/v3/ORG/PROJECT/REPO
|
|
81
|
+
*
|
|
82
|
+
* Percent-encoded project names (Azure DevOps allows spaces) are decoded in
|
|
83
|
+
* every returned field. NEVER throws; returns null for anything that is not
|
|
84
|
+
* one of the shapes above, including a lookalike host.
|
|
85
|
+
*/
|
|
86
|
+
export function parseAzureDevOpsRemote(remoteUrl) {
|
|
87
|
+
if (typeof remoteUrl !== 'string')
|
|
88
|
+
return null;
|
|
89
|
+
const url = remoteUrl.trim();
|
|
90
|
+
if (!url)
|
|
91
|
+
return null;
|
|
92
|
+
const split = splitRemote(url);
|
|
93
|
+
if (!split || !AZURE_DEVOPS_HOST_RE.test(split.host))
|
|
94
|
+
return null;
|
|
95
|
+
const raw = split.path.split('/').filter((part) => part !== '');
|
|
96
|
+
if (raw.length === 0)
|
|
97
|
+
return null;
|
|
98
|
+
raw[raw.length - 1] = raw[raw.length - 1].replace(/\.git$/i, '');
|
|
99
|
+
const segments = raw.map(decodeSegment);
|
|
100
|
+
const legacy = /visualstudio\.com$/i.test(split.host);
|
|
101
|
+
const build = (org, project, repo, transport) => {
|
|
102
|
+
if (!org || !project || !repo)
|
|
103
|
+
return null;
|
|
104
|
+
return { org, project, repo, host: split.host, transport, legacy };
|
|
105
|
+
};
|
|
106
|
+
// v3 ssh form: exactly v3/ORG/PROJECT/REPO on either ssh host.
|
|
107
|
+
if (segments[0].toLowerCase() === 'v3') {
|
|
108
|
+
if (segments.length !== 4 || split.scheme !== 'ssh')
|
|
109
|
+
return null;
|
|
110
|
+
return build(segments[1], segments[2], segments[3], 'ssh');
|
|
111
|
+
}
|
|
112
|
+
if (split.scheme !== 'https' && split.scheme !== 'http')
|
|
113
|
+
return null;
|
|
114
|
+
// The ssh-only hosts never serve the https '_git' shape.
|
|
115
|
+
if (/^(?:ssh\.dev\.azure\.com|vs-ssh\.visualstudio\.com)$/i.test(split.host))
|
|
116
|
+
return null;
|
|
117
|
+
const marker = segments.indexOf('_git');
|
|
118
|
+
if (marker === -1 || marker !== segments.length - 2)
|
|
119
|
+
return null;
|
|
120
|
+
const repo = segments[segments.length - 1];
|
|
121
|
+
let prefix = segments.slice(0, marker);
|
|
122
|
+
if (legacy) {
|
|
123
|
+
// Legacy host: the org is the first hostname label, and an explicit
|
|
124
|
+
// collection segment (historically 'DefaultCollection') may precede the
|
|
125
|
+
// project.
|
|
126
|
+
const org = split.host.split('.')[0];
|
|
127
|
+
if (!org || org.toLowerCase() === 'visualstudio' || org.toLowerCase() === 'vs-ssh')
|
|
128
|
+
return null;
|
|
129
|
+
if (prefix.length > 0 && prefix[0].toLowerCase() === 'defaultcollection')
|
|
130
|
+
prefix = prefix.slice(1);
|
|
131
|
+
if (prefix.length > 1)
|
|
132
|
+
return null;
|
|
133
|
+
return build(org, prefix[0] || repo, repo, 'https');
|
|
134
|
+
}
|
|
135
|
+
if (prefix.length < 1 || prefix.length > 2)
|
|
136
|
+
return null;
|
|
137
|
+
return build(prefix[0], prefix[1] || repo, repo, 'https');
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Extract the organization from an Azure DevOps org URL, accepting both
|
|
141
|
+
* hosts: "https://dev.azure.com/myorg" and the legacy
|
|
142
|
+
* "https://myorg.visualstudio.com[/...]". Falls back to the input verbatim
|
|
143
|
+
* (the historical behaviour) when neither shape matches.
|
|
144
|
+
*/
|
|
145
|
+
export function extractAzureDevOpsOrg(orgUrl) {
|
|
146
|
+
const modern = orgUrl.match(/^(?:https?:\/\/)?(?:[^@/]+@)?dev\.azure\.com\/([^/?#]+)/i);
|
|
147
|
+
if (modern?.[1])
|
|
148
|
+
return modern[1];
|
|
149
|
+
const legacy = orgUrl.match(/^(?:https?:\/\/)?(?:[^@/]+@)?([a-z0-9-]+)\.visualstudio\.com(?:[/?#]|$)/i);
|
|
150
|
+
if (legacy?.[1] && legacy[1].toLowerCase() !== 'vs-ssh')
|
|
151
|
+
return legacy[1];
|
|
152
|
+
return orgUrl;
|
|
153
|
+
}
|
|
19
154
|
function extractOrg(orgUrl) {
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
155
|
+
return extractAzureDevOpsOrg(orgUrl);
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* The host the git credential helper is bound to for a given credential
|
|
159
|
+
* scope URL. A scope on a legacy `<org>.visualstudio.com` host binds the PAT
|
|
160
|
+
* to THAT host: git looks credentials up by the remote's own hostname, so a
|
|
161
|
+
* helper registered for dev.azure.com is never consulted for a push to
|
|
162
|
+
* `https://myorg.visualstudio.com/...`. Every other scope (the default bare
|
|
163
|
+
* `https://dev.azure.com`, an org- or repo-scoped modern URL, a non-Azure or
|
|
164
|
+
* unparseable value) keeps the modern host.
|
|
165
|
+
*/
|
|
166
|
+
export function credentialHostForScope(scopeUrl) {
|
|
167
|
+
if (!scopeUrl)
|
|
168
|
+
return HOST;
|
|
169
|
+
let host;
|
|
170
|
+
try {
|
|
171
|
+
host = new URL(scopeUrl).hostname.toLowerCase();
|
|
172
|
+
}
|
|
173
|
+
catch {
|
|
174
|
+
return HOST;
|
|
175
|
+
}
|
|
176
|
+
if (host && AZURE_DEVOPS_HOST_RE.test(host) && /visualstudio\.com$/i.test(host)) {
|
|
177
|
+
const org = host.split('.')[0].toLowerCase();
|
|
178
|
+
if (org && org !== 'visualstudio' && org !== 'vs-ssh')
|
|
179
|
+
return host;
|
|
180
|
+
}
|
|
181
|
+
return HOST;
|
|
23
182
|
}
|
|
24
183
|
// apra-fleet-5co8.5.2 (review round 2): a candidate repo URL is only usable
|
|
25
|
-
// when it is a well-formed Azure DevOps repo URL --
|
|
26
|
-
//
|
|
27
|
-
//
|
|
28
|
-
//
|
|
29
|
-
//
|
|
30
|
-
//
|
|
31
|
-
//
|
|
32
|
-
//
|
|
33
|
-
//
|
|
184
|
+
// when it is a well-formed Azure DevOps https repo URL -- modern
|
|
185
|
+
// "https://dev.azure.com/<org>/<project>/_git/<repo>" or legacy
|
|
186
|
+
// "https://<org>.visualstudio.com/[DefaultCollection/]<project>/_git/<repo>"
|
|
187
|
+
// -- with each segment restricted to characters that can never be
|
|
188
|
+
// interpreted as shell metacharacters (percent-escapes such as %20 in a
|
|
189
|
+
// project name are allowed; a bare '%' is not). This single check closes two
|
|
190
|
+
// review defects at once: (1) knownRepoRemoteUrl is host-agnostic (see
|
|
191
|
+
// member-remote-url.ts), so without this a cross-host gitRepos entry (e.g. a
|
|
192
|
+
// github.com URL) could be ls-remote'd and reported as an Azure DevOps
|
|
193
|
+
// connectivity result -- a false success on the wrong host; (2) the derived
|
|
194
|
+
// URL is interpolated into a command string executed on the member (see
|
|
195
|
+
// below), so an unvalidated value is a command-injection vector. A bare
|
|
34
196
|
// org/project scope (the provision default, "https://dev.azure.com/<org>")
|
|
35
|
-
// deliberately fails this check -- it is not a clonable repo.
|
|
36
|
-
|
|
197
|
+
// deliberately fails this check -- it is not a clonable repo. SSH remotes
|
|
198
|
+
// also fail it: `git ls-remote` over ssh would exercise the member's SSH key,
|
|
199
|
+
// not the PAT this provider just deployed.
|
|
200
|
+
const SAFE_URL_RE = /^https:\/\/(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+(?:\/(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+)+$/;
|
|
37
201
|
function isValidAzureRepoUrl(url) {
|
|
38
|
-
|
|
202
|
+
if (!SAFE_URL_RE.test(url))
|
|
203
|
+
return false;
|
|
204
|
+
const ref = parseAzureDevOpsRemote(url);
|
|
205
|
+
return ref !== null && ref.transport === 'https';
|
|
39
206
|
}
|
|
40
207
|
export const azureDevOpsProvider = {
|
|
41
208
|
// apra-fleet-5co8.3.2: moved VERBATIM out of the provider switch in
|
|
@@ -45,9 +212,10 @@ export const azureDevOpsProvider = {
|
|
|
45
212
|
// The pat_expires_at check stays defence in depth behind the zod refine in
|
|
46
213
|
// the tool schema: tool-registry casts the MCP payload with `as any`, so a
|
|
47
214
|
// caller can bypass zod, and an unparseable expiry is worse than none at all
|
|
48
|
-
// (NaN silences every checkVcsTokenExpiry comparison
|
|
49
|
-
//
|
|
50
|
-
//
|
|
215
|
+
// (NaN silences every checkVcsTokenExpiry comparison; scheduleCredentialCleanup
|
|
216
|
+
// treats an unparseable expiresAt the same as an absent one and skips
|
|
217
|
+
// scheduling entirely, so this rejection is about the silenced-warning
|
|
218
|
+
// half of the failure mode, not an auto-revoke risk).
|
|
51
219
|
buildCredentials(input) {
|
|
52
220
|
const azPat = input.pat ?? input.token;
|
|
53
221
|
if (!input.org_url || !azPat)
|
|
@@ -69,7 +237,10 @@ export const azureDevOpsProvider = {
|
|
|
69
237
|
},
|
|
70
238
|
async deploy(_agent, cmds, exec, credentials, label, scopeUrl) {
|
|
71
239
|
const creds = credentials;
|
|
72
|
-
|
|
240
|
+
// Bind the helper to the host git will actually ask for: the legacy
|
|
241
|
+
// host when the scope names one, dev.azure.com otherwise -- see
|
|
242
|
+
// credentialHostForScope().
|
|
243
|
+
await exec(cmds.gitCredentialHelperWrite(credentialHostForScope(scopeUrl), PAT_USERNAME, creds.pat, label, scopeUrl));
|
|
73
244
|
return {
|
|
74
245
|
success: true,
|
|
75
246
|
message: 'Azure DevOps credentials deployed',
|
|
@@ -86,7 +257,7 @@ export const azureDevOpsProvider = {
|
|
|
86
257
|
};
|
|
87
258
|
},
|
|
88
259
|
async revoke(_agent, cmds, exec, label, scopeUrl) {
|
|
89
|
-
await exec(cmds.gitCredentialHelperRemove(
|
|
260
|
+
await exec(cmds.gitCredentialHelperRemove(credentialHostForScope(scopeUrl), label, scopeUrl));
|
|
90
261
|
return { success: true, message: 'Azure DevOps credentials revoked' };
|
|
91
262
|
},
|
|
92
263
|
// apra-fleet-5co8.5.2: replaces the unauthenticated curl-the-org-root stub
|
|
@@ -113,7 +113,7 @@ export interface VcsProviderService {
|
|
|
113
113
|
* return a plain error string naming the fields it requires (apra-fleet-
|
|
114
114
|
* 5co8.3.1). Pure/deterministic: validation and shaping only -- never
|
|
115
115
|
* network, filesystem or credential-store access, all of which happen
|
|
116
|
-
* before (
|
|
116
|
+
* before (secret-token resolution) or after (deploy) this call.
|
|
117
117
|
*
|
|
118
118
|
* OPTIONAL only while providers are migrated onto the seam one at a time;
|
|
119
119
|
* the tool keeps its own switch for a provider that has not implemented it.
|
|
@@ -13,7 +13,7 @@ Get the shape right before launching.
|
|
|
13
13
|
| Field | Required | Type | Default | Notes |
|
|
14
14
|
|-------|----------|------|---------|-------|
|
|
15
15
|
| `issues` | **yes** | array of strings | -- | Beads issue IDs (sprint roots), e.g. `["BD-1","BD-2"]`. Must be non-empty; every entry a non-empty string. |
|
|
16
|
-
| `branch` | **yes** | string | -- | Sprint branch name, e.g. `"feat/auth"`. Created from `origin/<base_branch>` if it does not exist. |
|
|
16
|
+
| `branch` | **yes** | string | -- | Sprint branch name, e.g. `"feat/auth"`. Created from `origin/<base_branch>` if it does not exist. Must differ from `base_branch`. |
|
|
17
17
|
| `goal` | no | string | `"P1/P2"` | Exit when no open issues at or above this priority. Must be exactly `"P1"`, `"P1/P2"`, or `"P1/P2/P3"`. |
|
|
18
18
|
| `max_cycles` | no | positive integer | `5` | Hard cycle ceiling. |
|
|
19
19
|
| `base_branch` | no | string | `"main"` | PR target branch. |
|
|
@@ -70,7 +70,7 @@ explicit `branch`.
|
|
|
70
70
|
1. **Issues exist and are open** -- `bd show <id>` for each root; a missing root hard-fails preflight.
|
|
71
71
|
2. **Ready leaf work exists** -- at least some leaves under the roots are unblocked (`bd ready`); an all-blocked backlog deadlocks and aborts.
|
|
72
72
|
3. **Branch name chosen** -- explicit `branch`, created if absent.
|
|
73
|
-
4. **`base_branch` is the intended PR target** (default `main`).
|
|
73
|
+
4. **`base_branch` is the intended PR target** (default `main`) and must differ from `branch` -- an equal pair is rejected at launch.
|
|
74
74
|
5. **Branching off latest main** -- the workflow fetches and cuts new branches from `origin/<base_branch>`; if fetch fails, launch fails. Make sure the remote is reachable.
|
|
75
75
|
|
|
76
76
|
## Common failures and the exact error you'll see
|
|
@@ -26,6 +26,9 @@ apra-fleet workflow fleet-sprint \
|
|
|
26
26
|
[--viewer-port <port>] # default 8080
|
|
27
27
|
[--budget <usd>] # default unlimited
|
|
28
28
|
[--dispatch-timeout-s <s>] # default 9000
|
|
29
|
+
[--usage-limit-max-wait-s <s>] # usage-limit pause budget; default from role-policies
|
|
30
|
+
[--usage-limit-max-reprobes <n>]# usage-limit reprobe cap; default from role-policies
|
|
31
|
+
[--skip-regression] # skip the once-per-sprint regression pass
|
|
29
32
|
[--sync] # synced-topology mode
|
|
30
33
|
```
|
|
31
34
|
|
|
@@ -42,6 +45,9 @@ on this list -- flags evolve and this skill can drift.
|
|
|
42
45
|
is invisible to the scope filter no matter what you pass -- only true
|
|
43
46
|
children are picked up. See the epics/manifest-bead guidance in
|
|
44
47
|
`packages/apra-fleet-se/fleet-sprint/docs/README.md`.
|
|
48
|
+
- `--branch` must differ from `--base` (`main` vs `origin/main` or
|
|
49
|
+
`refs/heads/main` count as the same branch); an equal pair is rejected at
|
|
50
|
+
launch.
|
|
45
51
|
- `--branch` is created from `--base` if it does not already exist. If it
|
|
46
52
|
does exist (e.g. you are resuming), it is reused as-is.
|
|
47
53
|
- **`--base` is resolved against the remote, not your local checkout.** A new
|
|
@@ -52,9 +58,20 @@ on this list -- flags evolve and this skill can drift.
|
|
|
52
58
|
package.json script) fails in ways that look unrelated.
|
|
53
59
|
- `--role-map` assigns specific members to specific roles, e.g.
|
|
54
60
|
`--role-map '{"doer":["m1","m2"],"reviewer":["m3"]}'`. Accepts inline JSON
|
|
55
|
-
or `@path/to/file.json`.
|
|
61
|
+
or `@path/to/file.json`. The `backlog` key names the member whose beads
|
|
62
|
+
clone the engine runs its own `bd`/`git` commands against. `orchestrator`
|
|
63
|
+
is its deprecated alias (works with a warning in 0.4.4, removed in v0.5) --
|
|
64
|
+
rename it to `backlog`. Without a `backlog` entry the engine picks a member
|
|
65
|
+
and logs `backlog: <member> (auto-selected: <reason>)`; check that line.
|
|
66
|
+
- `--skip-regression` skips the regression pass for this run. The skip is
|
|
67
|
+
logged and stated in the sprint analysis and the PR body.
|
|
56
68
|
- `--goal` controls which bead priorities are in scope for the run.
|
|
57
69
|
- `--budget` caps total spend in USD; the run aborts when it is exhausted.
|
|
70
|
+
- `--usage-limit-max-wait-s` / `--usage-limit-max-reprobes` bound how long a
|
|
71
|
+
dispatch that hit a provider usage/rate limit is paused (and re-probed on a
|
|
72
|
+
backoff ladder) before the run gives up with a typed abort. Both are
|
|
73
|
+
optional; omitted, the engine uses its own defaults. A resumed member
|
|
74
|
+
re-dispatches without consuming a retry attempt.
|
|
58
75
|
|
|
59
76
|
## Preconditions to check first
|
|
60
77
|
|
|
@@ -67,20 +84,45 @@ on this list -- flags evolve and this skill can drift.
|
|
|
67
84
|
2. Every `--members` name is registered with the fleet (`list_members` /
|
|
68
85
|
`mcp__apra-fleet__list_members`). An unregistered member aborts the
|
|
69
86
|
sprint unless `--allow-missing-members` is passed.
|
|
70
|
-
3. Multi-member sprints
|
|
71
|
-
|
|
72
|
-
|
|
87
|
+
3. Multi-member sprints align their members automatically: at launch every
|
|
88
|
+
member is fetched and checked out on the sprint branch (WIP preserved in a
|
|
89
|
+
named `fleet-sprint[<branch>]` stash, one `[Align]` line per member), so
|
|
90
|
+
do not align members by hand. The launch refuses, before moving any
|
|
91
|
+
member, only for an unreachable member, differing origin URLs, a base
|
|
92
|
+
missing on origin, a fetch auth failure or a diverged sprint branch --
|
|
93
|
+
fix what the message names and relaunch. See `fleet-sprint-diagram.md` in
|
|
94
|
+
the package docs.
|
|
73
95
|
4. If a member's LLM session is stale or unauthenticated (dispatch fails
|
|
74
96
|
with `empty_response`, or "member CLI likely died"), re-run
|
|
75
97
|
`provision_llm_auth` for that member before retrying.
|
|
98
|
+
5. Beads identity: before any `bd` mutation, the sprint probes every
|
|
99
|
+
member's `bd where`/`sync.remote`/git origin and prints a `Beads:`
|
|
100
|
+
banner plus one `beads ok: <member> ...` line per member. These abort
|
|
101
|
+
with `BeadsIdentityError` naming the member, cause and fix, before
|
|
102
|
+
anything is dispatched -- there is no bypass flag:
|
|
103
|
+
- MISMATCH: a field that resolved on both sides differs. Fix that
|
|
104
|
+
member's `workFolder` (wrong `.beads`) or its `sync.remote`.
|
|
105
|
+
- `bd` missing on a member (not installed or not on PATH). Fix: install
|
|
106
|
+
`bd` on that member or fix its PATH so `bd --version` works in its work
|
|
107
|
+
folder (re-running the member fleet install places it in the member's
|
|
108
|
+
fleet bin dir), then relaunch.
|
|
109
|
+
- BEADS_SETUP_FAILED: a member mapped to a beads-reading role had no beads
|
|
110
|
+
database (or no `sync.remote`), and setting it up from the expected
|
|
111
|
+
beads remote failed. Matching members are left untouched.
|
|
112
|
+
Any other probe failure (including no beads database on a member used
|
|
113
|
+
only for deployer/ci-watcher) is only a `[beads-identity] WARNING:` line (naming
|
|
114
|
+
the member, field, probe, error and the fix): that field is not compared
|
|
115
|
+
and the sprint proceeds -- read the warning and fix the member.
|
|
76
116
|
|
|
77
117
|
## Launching it
|
|
78
118
|
|
|
79
119
|
Run this on your own orchestrating machine, not on a `--members` target --
|
|
80
120
|
members are dispatch destinations, not where this command runs.
|
|
81
121
|
|
|
82
|
-
Use the
|
|
83
|
-
|
|
122
|
+
Use the installed `apra-fleet` binary. After `npm install -g` it is on
|
|
123
|
+
PATH; the standalone installer does not add it to PATH, so call it as
|
|
124
|
+
`~/.apra-fleet/bin/apra-fleet` (Windows: `$HOME\.apra-fleet\bin\apra-fleet.exe`).
|
|
125
|
+
Start it as a genuinely detached OS process. A harness-owned background
|
|
84
126
|
task can be silently killed when its owning tool call's process group ends,
|
|
85
127
|
which orphans the sprint mid-run.
|
|
86
128
|
|
package/dist/skills/pm/SKILL.md
CHANGED
|
@@ -59,7 +59,7 @@ order; a fourth phase runs once at sprint close.
|
|
|
59
59
|
files bugs for failures). Skip the whole phase if either file is absent.
|
|
60
60
|
- **Harvest** -- runs once after the cycle loop exits (goal met or cycle ceiling
|
|
61
61
|
hit): poll CI via `ci-watcher`, run a final reviewer pass, then `harvester`
|
|
62
|
-
extracts durable knowledge into `docs/` and
|
|
62
|
+
extracts durable knowledge into `docs/` and README, and raise the PR.
|
|
63
63
|
|
|
64
64
|
At the end of each cycle, check the **goal**: the sprint is done when no open
|
|
65
65
|
beads issue in the sprint-root subtree sits at or above the goal priority (default
|
|
@@ -128,7 +128,7 @@ Dispatch these only when their condition holds:
|
|
|
128
128
|
not configured / pending). [Fleet mode] PM may run `gh` CLI directly instead of
|
|
129
129
|
dispatching (R13).
|
|
130
130
|
- `harvester` -- in Harvest, at sprint close, to extract durable knowledge into
|
|
131
|
-
`docs/` and update
|
|
131
|
+
`docs/` and update README.
|
|
132
132
|
|
|
133
133
|
## Tracks and parallelism
|
|
134
134
|
|
|
@@ -322,7 +322,7 @@ via `compose_permissions` using the same tag set before every dispatch. See
|
|
|
322
322
|
|
|
323
323
|
When running via fleet, never pass raw secrets in `execute_prompt` prompts --
|
|
324
324
|
reference the credential by name only (e.g. "authenticate using credential
|
|
325
|
-
github_pat"). The member then uses `{{
|
|
325
|
+
github_pat"). The member then uses `{{secret.github_pat}}` in its own
|
|
326
326
|
`execute_command` calls. See `fleet-addendum.md` for the full reference.
|
|
327
327
|
|
|
328
328
|
## Provider awareness (fleet mode)
|
|
@@ -352,7 +352,7 @@ per cycle: Plan (planner writes beads tasks -> plan-reviewer loop) -> Develop
|
|
|
352
352
|
(doer-review loop: bd ready -> claim -> close, to a clean APPROVED)
|
|
353
353
|
-> Test (deploy + integ tests, if applicable)
|
|
354
354
|
-> goal check -> next cycle | exit
|
|
355
|
-
at close: Harvest (CI watch -> final review -> docs
|
|
355
|
+
at close: Harvest (CI watch -> final review -> docs -> PR)
|
|
356
356
|
```
|
|
357
357
|
|
|
358
358
|
For small, low-risk work (1-3 tasks, no phasing) use the lightweight path instead
|
package/dist/skills/pm/cost.md
CHANGED
|
@@ -116,9 +116,6 @@ At sprint close, after the harvester runs:
|
|
|
116
116
|
startedAt, taskAssignments, logEntries)` and write the result back to
|
|
117
117
|
`sprint-logs/calibration.json`. Commit it. This blends the actual token counts
|
|
118
118
|
into the historical averages so future quotes improve.
|
|
119
|
-
4. **Update fleet token memory**: Parse the `tuple_averages` from the updated
|
|
120
|
-
calibration object into a flat array: `const tokenEstimates = { averages: Object.values(updatedCalibration.historical?.tuple_averages || {}) }`. Then write it to the beads persistent memory:
|
|
121
|
-
`bd remember '<json_string>' --key token-estimates-json`
|
|
122
119
|
|
|
123
120
|
## Sprint log
|
|
124
121
|
|
|
@@ -107,8 +107,8 @@ Use member_detail -> llmProvider to determine the target filename:
|
|
|
107
107
|
|
|
108
108
|
Never pass raw secrets in execute_prompt prompts -- reference the credential by
|
|
109
109
|
name only (e.g. "authenticate using credential github_pat"). The member then
|
|
110
|
-
uses {{
|
|
111
|
-
{{
|
|
110
|
+
uses {{secret.github_pat}} in its own execute_command calls. The
|
|
111
|
+
{{secret.NAME}} token is substituted at launch time -- reference it bare in
|
|
112
112
|
execute_command, not inside your own quotes (it is already single-quote-escaped
|
|
113
113
|
by the fleet).
|
|
114
114
|
|
package/dist/skills/pm/index.md
CHANGED
|
@@ -11,10 +11,12 @@ code_graph, code_impact, code_query, and code_context tools.
|
|
|
11
11
|
the repo path.
|
|
12
12
|
3. Run via `execute_command` (wrap in background Agent per fleet rules):
|
|
13
13
|
```
|
|
14
|
-
npx gitnexus analyze --embeddings
|
|
14
|
+
npx gitnexus analyze --index-only --embeddings
|
|
15
15
|
```
|
|
16
16
|
- `run_from`: project repo root
|
|
17
17
|
- `timeout_s`: 300 (indexing large repos can take a minute)
|
|
18
|
+
- `--index-only` keeps the repo work tree clean: without it gitnexus
|
|
19
|
+
writes an AGENTS.md/CLAUDE.md block and skills folders into the repo.
|
|
18
20
|
4. Report the result: nodes indexed, edges, flows (gitnexus prints this on
|
|
19
21
|
completion). If gitnexus is not installed, it will be fetched automatically
|
|
20
22
|
via npx.
|
|
@@ -42,7 +44,7 @@ code_graph, code_impact, code_query, and code_context tools.
|
|
|
42
44
|
|
|
43
45
|
- **Automatically inside `/pm init`** -- runs as the final step of project initialization.
|
|
44
46
|
The worktree must exist before indexing (gitnexus needs files on disk to analyze).
|
|
45
|
-
- **Automatically at VERIFY checkpoints** -- checkpoints re-run npx gitnexus analyze to keep
|
|
47
|
+
- **Automatically at VERIFY checkpoints** -- checkpoints re-run npx gitnexus analyze --index-only to keep
|
|
46
48
|
mid-sprint symbols visible to later phases (incremental via fileHashes in .gitnexus/meta.json,
|
|
47
49
|
takes seconds).
|
|
48
50
|
- After a large merge or rebase that changes many files
|
|
@@ -4,7 +4,8 @@ Reconcile a warm local KB against a merged bible after two or more branches
|
|
|
4
4
|
land -- absorb the incoming knowledge, revive entries whose basis matches
|
|
5
5
|
the merged worktree again, mechanically settle contradictions a file hash
|
|
6
6
|
can decide, and dispatch a reconciler agent for the rest. Ends with the
|
|
7
|
-
canonical bible re-exported
|
|
7
|
+
canonical bible re-exported: confirmed entries whose cited files still match
|
|
8
|
+
their hash basis are added, so the merged branch's bible gains the merged truth.
|
|
8
9
|
|
|
9
10
|
## When to run
|
|
10
11
|
|
|
@@ -28,19 +29,26 @@ already-exposed `kb_promote` surface (which can walk any entry
|
|
|
28
29
|
way -- a bible can never smuggle an active directive; activation stays
|
|
29
30
|
CLI-only (`apra-fleet kb approve-directive`).
|
|
30
31
|
|
|
32
|
+
Run every step of this command from the operator's own session, not a fleet
|
|
33
|
+
member session: a member session without the engine's kb_maintainer grant is
|
|
34
|
+
refused an explicit `kb_import` path (`E-KB-MAINTAINER-REQUIRED`) and is not
|
|
35
|
+
served `kb_reconcile_prefilter`, `kb_resolve_contradiction` or `kb_export`.
|
|
36
|
+
|
|
31
37
|
## Steps
|
|
32
38
|
|
|
33
39
|
### Step 1: Import the merged bible
|
|
34
40
|
|
|
35
41
|
```
|
|
36
|
-
kb_import({
|
|
42
|
+
kb_import({ path: "<merged worktree path>/.fleet/kb-canonical.json" })
|
|
37
43
|
```
|
|
38
44
|
|
|
39
|
-
or the CLI equivalent, `apra-fleet kb import --
|
|
40
|
-
running this post-merge by hand.
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
45
|
+
or the CLI equivalent, `apra-fleet kb import --path <file>`, for a human
|
|
46
|
+
running this post-merge by hand. `path` names the bible FILE only: kb tools
|
|
47
|
+
take no repo/scope argument and always write the calling session's own KB (a
|
|
48
|
+
member session uses its registered work folder; any other session the fleet
|
|
49
|
+
server's working folder). Omitting `path` resolves
|
|
50
|
+
`<own folder>/.fleet/kb-canonical.json` (the trusted channel); a bible from
|
|
51
|
+
anywhere else is caller-asserted trust (see above).
|
|
44
52
|
|
|
45
53
|
Report: `{ imported, skipped, linked, flagged, sweep }`. `kb_import`
|
|
46
54
|
already runs a freshness sweep internally at the end of its own run, scoped
|
|
@@ -92,11 +100,13 @@ Report: `{ pairs, resolved, left_for_agent, skipped_directive }`.
|
|
|
92
100
|
|
|
93
101
|
If `left_for_agent` is non-empty, dispatch the `kb-reconciler` agent
|
|
94
102
|
(`agents/kb-reconciler.md`, model tier cheap/standard)
|
|
95
|
-
with that array
|
|
103
|
+
with that array, as a subagent of THIS session -- never on a fleet member: a
|
|
104
|
+
member session is not served `kb_resolve_contradiction` or `kb_export`, so the
|
|
105
|
+
agent would stop at its tool check. It reads the MERGED code via `code_context`/`code_impact`/
|
|
96
106
|
`code_query` (never Glob/Grep) for each remaining pair, resolves what the
|
|
97
107
|
code decides via `kb_resolve_contradiction`, falls back to a trust-tier
|
|
98
108
|
tiebreak (`CONFIRMED > INFERRED > UNVERIFIED`) when the code is silent, and
|
|
99
|
-
leaves genuinely undecidable pairs flagged for `/pm kb-review`. Active
|
|
109
|
+
leaves genuinely undecidable pairs flagged for `/pm kb-review`. Any `kb_query`/`kb_list` lookup of a pair's entries must pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list: the read tools default to CONFIRMED undisputed entries only, and a disputed or unpromoted side would otherwise be invisible (`kb_query({ flagged_only: true })` is exempt). Active
|
|
100
110
|
user-directives are NEVER auto-retired. See `agents/kb-reconciler.md` for the
|
|
101
111
|
full process and the single-write-path rule.
|
|
102
112
|
|
|
@@ -108,11 +118,16 @@ If `left_for_agent` is empty, skip straight to Step 5.
|
|
|
108
118
|
kb_export()
|
|
109
119
|
```
|
|
110
120
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
121
|
+
ADDS to `.fleet/kb-canonical.json` every live `CONFIRMED` project entry not
|
|
122
|
+
already in it whose cited files still match its recorded hash basis -- which
|
|
123
|
+
includes the mechanical and agent-resolved winners -- and auto-commits it
|
|
124
|
+
(pathspec-only, identity `pm-kb`, non-fatal on any git failure). This is
|
|
125
|
+
existing `kb_export` machinery; no new commit step is needed here. Push is
|
|
126
|
+
not automatic; it rides the normal sprint push cadence.
|
|
127
|
+
|
|
128
|
+
The export never removes or rewrites an entry already in the bible: a
|
|
129
|
+
superseded loser, or an entry later retired, stays there after re-export and
|
|
130
|
+
must be removed by hand.
|
|
116
131
|
|
|
117
132
|
## Report
|
|
118
133
|
|
|
@@ -21,6 +21,7 @@ Call `kb_query(flagged_only=true)`.
|
|
|
21
21
|
|
|
22
22
|
- If the response says "No flagged contradictions found -- KB is clean.", report that to the user and stop.
|
|
23
23
|
- Otherwise, collect all returned entries.
|
|
24
|
+
- `flagged_only` is exempt from the default CONFIRMED-only read filter, so it returns disputed entries of every tier. If you need to look up any other entry (for example a counterpart that is not in the flagged list), a plain `kb_query`/`kb_list` returns only CONFIRMED undisputed entries by default -- pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list to see the rest.
|
|
24
25
|
|
|
25
26
|
### Step 2: Group into contradiction pairs
|
|
26
27
|
|