@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
|
@@ -64,6 +64,29 @@
|
|
|
64
64
|
// <base64 utf16le>` string; SePosixCommands throws
|
|
65
65
|
// (a true POSIX member has no PowerShell to hand
|
|
66
66
|
// the script to at all).
|
|
67
|
+
// ensureGitExcluded member-call.mjs runRemote's args-file cleanup and
|
|
68
|
+
// beads-identity-check.mjs member beads set-up:
|
|
69
|
+
// idempotently lists the args dir (.apra-call/) or
|
|
70
|
+
// a new untracked beads path in
|
|
71
|
+
// the member repo's git exclude file (resolved via
|
|
72
|
+
// `git rev-parse --git-path info/exclude`, so repo
|
|
73
|
+
// subdirs and linked worktrees work), silent exit-0
|
|
74
|
+
// no-op outside a git repo.
|
|
75
|
+
// removeFile member-call.mjs runRemote's engine-side args-file
|
|
76
|
+
// delete (force, never errors when absent).
|
|
77
|
+
// fileExistsProbe member-provisioning.mjs permission-config
|
|
78
|
+
// preflight: prints 'present'/'absent' for a
|
|
79
|
+
// work-folder-relative file, exit 0 either way.
|
|
80
|
+
// ensureFile beads-identity-check.mjs member beads set-up:
|
|
81
|
+
// creates a file (and parent dir) only when absent,
|
|
82
|
+
// never truncating an existing one.
|
|
83
|
+
// ensureLine beads-identity-check.mjs member beads set-up:
|
|
84
|
+
// idempotently makes a line a whole line of a file.
|
|
85
|
+
// All of these validate their work-folder-relative
|
|
86
|
+
// path against a strict charset and THROW on
|
|
87
|
+
// anything else (assertSafeRelativePath /
|
|
88
|
+
// assertSafeFileLine in se-posix.mjs); gitbash
|
|
89
|
+
// inherits the POSIX strings.
|
|
67
90
|
//
|
|
68
91
|
// Deliberately NOT included, so this stays an interface rather than a
|
|
69
92
|
// catalogue:
|
|
@@ -90,6 +113,7 @@ import { SeWindowsGitbashCommands } from './se-windows-gitbash.mjs';
|
|
|
90
113
|
export { SePosixCommands } from './se-posix.mjs';
|
|
91
114
|
export { SeWindowsCommands } from './se-windows.mjs';
|
|
92
115
|
export { SeWindowsGitbashCommands } from './se-windows-gitbash.mjs';
|
|
116
|
+
export { FILE_PROBE_PRESENT, FILE_PROBE_ABSENT } from './se-posix.mjs';
|
|
93
117
|
|
|
94
118
|
const posix = new SePosixCommands();
|
|
95
119
|
const windowsPowerShell = new SeWindowsCommands();
|
|
@@ -22,6 +22,44 @@
|
|
|
22
22
|
// read must resolve the home directory the same way the write did rather than
|
|
23
23
|
// through an independently probed path.
|
|
24
24
|
|
|
25
|
+
/**
|
|
26
|
+
* Validate a work-folder-relative path before it is interpolated into a
|
|
27
|
+
* member-bound command string. Same strict charset member-call.mjs uses for
|
|
28
|
+
* its args path (^[A-Za-z0-9._/-]+$), plus: no '..' segment (no escaping the
|
|
29
|
+
* work folder), no leading '/' (relative only) and no leading '-' (never
|
|
30
|
+
* mistakable for an option). Anything else THROWS -- it is never quoted or
|
|
31
|
+
* escaped into the string. Shared by every dialect's git-exclude/remove-file/
|
|
32
|
+
* ensure-file/ensure-line primitive.
|
|
33
|
+
* @param {string} relPath
|
|
34
|
+
* @param {string} what caller-facing name for the error message
|
|
35
|
+
* @returns {string} the validated path
|
|
36
|
+
*/
|
|
37
|
+
export function assertSafeRelativePath(relPath, what = 'path') {
|
|
38
|
+
const p = String(relPath ?? '');
|
|
39
|
+
if (!/^[A-Za-z0-9._/-]+$/.test(p) || p.startsWith('/') || p.startsWith('-') || p.split('/').includes('..')) {
|
|
40
|
+
throw new Error(`Refusing to build a member command for unsafe ${what} '${relPath}' (allowed: work-folder-relative, letters, digits, '.', '_', '-', '/'; no '..' segment, no leading '/' or '-').`);
|
|
41
|
+
}
|
|
42
|
+
return p;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Markers printed by every dialect's fileExistsProbe(). */
|
|
46
|
+
export const FILE_PROBE_PRESENT = 'present';
|
|
47
|
+
export const FILE_PROBE_ABSENT = 'absent';
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* A single file line safe to embed single-quoted in POSIX and PowerShell:
|
|
51
|
+
* no single quote, backslash, $, backtick or newline.
|
|
52
|
+
* @param {string} line
|
|
53
|
+
* @returns {string}
|
|
54
|
+
*/
|
|
55
|
+
export function assertSafeFileLine(line) {
|
|
56
|
+
const l = String(line ?? '');
|
|
57
|
+
if (!/^[A-Za-z0-9 ._~:/@+="-]+$/.test(l)) {
|
|
58
|
+
throw new Error(`Refusing to build a member command for unsafe file line '${line}' (allowed: letters, digits, space and . _ ~ : / @ + = " -).`);
|
|
59
|
+
}
|
|
60
|
+
return l;
|
|
61
|
+
}
|
|
62
|
+
|
|
25
63
|
/**
|
|
26
64
|
* POSIX command primitives. Also the base class the Git-for-Windows bash
|
|
27
65
|
* implementation extends -- a gitbash member receives bash strings, so the
|
|
@@ -137,6 +175,98 @@ export class SePosixCommands {
|
|
|
137
175
|
.replace(/"/g, '\\"');
|
|
138
176
|
}
|
|
139
177
|
|
|
178
|
+
/**
|
|
179
|
+
* Idempotently add `entry` (e.g. '.apra-call/') as a line of the git
|
|
180
|
+
* exclude file of the repo containing the member's work folder
|
|
181
|
+
* (execute_command runs in the work folder). The exclude file is resolved
|
|
182
|
+
* by git itself (`git rev-parse --git-path info/exclude`), never assumed to
|
|
183
|
+
* be <workFolder>/.git/info/exclude: the work folder may be a repo
|
|
184
|
+
* subdirectory or a linked worktree whose .git is a file. The info/ dir is
|
|
185
|
+
* created when missing, a missing trailing newline is repaired before the
|
|
186
|
+
* append, and the line is appended only when not already present. Outside
|
|
187
|
+
* a git repo (or with no git on PATH) it is a silent no-op that exits 0.
|
|
188
|
+
*
|
|
189
|
+
* The only `$` expansions are of a shell-LOCAL variable this same string
|
|
190
|
+
* assigns (`excl`) -- nothing reads the member's environment ($HOME,
|
|
191
|
+
* $VAR/path, ~/, backticks).
|
|
192
|
+
* Callers: member-call.mjs runRemote (args-file cleanup);
|
|
193
|
+
* beads-identity-check.mjs member beads set-up (new untracked beads paths
|
|
194
|
+
* are excluded so the target work tree stays clean).
|
|
195
|
+
* @param {string} entry work-folder-relative path/pattern, validated
|
|
196
|
+
* @returns {string}
|
|
197
|
+
*/
|
|
198
|
+
ensureGitExcluded(entry) {
|
|
199
|
+
const e = assertSafeRelativePath(entry, 'git-exclude entry');
|
|
200
|
+
const script = `if excl=$(git rev-parse --git-path info/exclude 2>/dev/null) && [ -n "$excl" ]; then `
|
|
201
|
+
+ `mkdir -p "$(dirname "$excl")" && `
|
|
202
|
+
+ `{ grep -qxF -- '${e}' "$excl" 2>/dev/null || { `
|
|
203
|
+
+ `if [ -s "$excl" ] && [ -n "$(tail -c 1 "$excl")" ]; then printf '\\n' >> "$excl"; fi; `
|
|
204
|
+
+ `printf '%s\\n' '${e}' >> "$excl"; }; }; fi`;
|
|
205
|
+
return this.wrapForMember(script);
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* Delete a work-folder-relative file, never erroring when it is absent.
|
|
210
|
+
* Caller: member-call.mjs runRemote (engine-side args-file delete).
|
|
211
|
+
* @param {string} relPath validated
|
|
212
|
+
* @returns {string}
|
|
213
|
+
*/
|
|
214
|
+
removeFile(relPath) {
|
|
215
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
216
|
+
return this.wrapForMember(`rm -f -- '${p}'`);
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Report whether a work-folder-relative file exists: prints exactly
|
|
221
|
+
* FILE_PROBE_PRESENT or FILE_PROBE_ABSENT and exits 0 either way, so a
|
|
222
|
+
* non-zero exit always means the probe itself failed. Read-only.
|
|
223
|
+
* Caller: member-provisioning.mjs permission-config preflight.
|
|
224
|
+
* @param {string} relPath validated
|
|
225
|
+
* @returns {string}
|
|
226
|
+
*/
|
|
227
|
+
fileExistsProbe(relPath) {
|
|
228
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
229
|
+
return this.wrapForMember(`if [ -e '${p}' ]; then echo ${FILE_PROBE_PRESENT}; else echo ${FILE_PROBE_ABSENT}; fi`);
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/**
|
|
233
|
+
* Create a work-folder-relative file (and its parent directory) when it is
|
|
234
|
+
* absent; an existing file is never truncated or modified. Idempotent.
|
|
235
|
+
* Caller: beads-identity-check.mjs member beads set-up (an empty
|
|
236
|
+
* .beads/config.yaml so `bd config set` has a workspace to write to).
|
|
237
|
+
* @param {string} relPath validated
|
|
238
|
+
* @returns {string}
|
|
239
|
+
*/
|
|
240
|
+
ensureFile(relPath) {
|
|
241
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
242
|
+
const slash = p.lastIndexOf('/');
|
|
243
|
+
const dir = slash > 0 ? p.slice(0, slash) : '';
|
|
244
|
+
const create = `{ [ -e '${p}' ] || : > '${p}'; }`;
|
|
245
|
+
return this.wrapForMember(dir ? `mkdir -p -- '${dir}' && ${create}` : create);
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Idempotently make `line` a whole line of a work-folder-relative file,
|
|
250
|
+
* creating the file (and its parent directory) when absent; nothing else in
|
|
251
|
+
* the file is touched. Same append shape as ensureGitExcluded.
|
|
252
|
+
* Caller: beads-identity-check.mjs member beads set-up (sync.remote in the
|
|
253
|
+
* untracked .beads/config.local.yaml layer).
|
|
254
|
+
* @param {string} relPath validated
|
|
255
|
+
* @param {string} line validated: letters, digits, space and . _ ~ : / @ + = " -
|
|
256
|
+
* @returns {string}
|
|
257
|
+
*/
|
|
258
|
+
ensureLine(relPath, line) {
|
|
259
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
260
|
+
const l = assertSafeFileLine(line);
|
|
261
|
+
const slash = p.lastIndexOf('/');
|
|
262
|
+
const dir = slash > 0 ? p.slice(0, slash) : '';
|
|
263
|
+
const script = `${dir ? `mkdir -p -- '${dir}' && ` : ''}{ [ -e '${p}' ] || : > '${p}'; } && `
|
|
264
|
+
+ `{ grep -qxF -- '${l}' '${p}' || { `
|
|
265
|
+
+ `if [ -s '${p}' ] && [ -n "$(tail -c 1 '${p}')" ]; then printf '\\n' >> '${p}'; fi; `
|
|
266
|
+
+ `printf '%s\\n' '${l}' >> '${p}'; }; }`;
|
|
267
|
+
return this.wrapForMember(script);
|
|
268
|
+
}
|
|
269
|
+
|
|
140
270
|
/**
|
|
141
271
|
* A POSIX member has no PowerShell -- there is nothing this method could
|
|
142
272
|
* correctly return (returning the script unchanged would hand a bash
|
|
@@ -11,6 +11,8 @@
|
|
|
11
11
|
// core's src/os/windows.ts wrapPowerShellEncoded(), not a reuse of it: this
|
|
12
12
|
// package cannot import core.
|
|
13
13
|
|
|
14
|
+
import { assertSafeRelativePath, assertSafeFileLine, FILE_PROBE_PRESENT, FILE_PROBE_ABSENT } from './se-posix.mjs';
|
|
15
|
+
|
|
14
16
|
/**
|
|
15
17
|
* PowerShell command primitives for a Windows member.
|
|
16
18
|
*/
|
|
@@ -125,6 +127,115 @@ export class SeWindowsCommands {
|
|
|
125
127
|
.replace(/"/g, `${bq}"`);
|
|
126
128
|
}
|
|
127
129
|
|
|
130
|
+
/**
|
|
131
|
+
* PowerShell twin of SePosixCommands.ensureGitExcluded: idempotently add
|
|
132
|
+
* `entry` as a line of the exclude file git itself resolves
|
|
133
|
+
* (`git rev-parse --git-path info/exclude`, run in the work folder), creating
|
|
134
|
+
* its directory if missing; silent exit-0 no-op outside a git repo or with
|
|
135
|
+
* no git on PATH.
|
|
136
|
+
*
|
|
137
|
+
* Shape notes (all load-bearing):
|
|
138
|
+
* - the git call sits in its own try/catch because wrapForMember sets
|
|
139
|
+
* $ErrorActionPreference = 'Stop', under which Windows PowerShell 5.1
|
|
140
|
+
* turns a redirected native stderr line ("fatal: not a git repository")
|
|
141
|
+
* into a terminating error;
|
|
142
|
+
* - $global:LASTEXITCODE is reset at the end so the envelope's native
|
|
143
|
+
* exit-code check does not turn git's non-repo exit 128 into a failure;
|
|
144
|
+
* - the line is written with an explicit LF ([char]10) and -NoNewline,
|
|
145
|
+
* not Add-Content's platform CRLF, and no backtick escape is used
|
|
146
|
+
* anywhere -- the only variables are script-local ones this string
|
|
147
|
+
* assigns; nothing reads the member's environment ($env:, ~/).
|
|
148
|
+
* Callers: member-call.mjs runRemote (args-file cleanup);
|
|
149
|
+
* beads-identity-check.mjs member beads set-up (new untracked beads paths
|
|
150
|
+
* are excluded so the target work tree stays clean).
|
|
151
|
+
* @param {string} entry validated
|
|
152
|
+
* @returns {string}
|
|
153
|
+
*/
|
|
154
|
+
ensureGitExcluded(entry) {
|
|
155
|
+
const e = assertSafeRelativePath(entry, 'git-exclude entry');
|
|
156
|
+
const script = [
|
|
157
|
+
`$excl = $null`,
|
|
158
|
+
`try { $out = @(git rev-parse --git-path info/exclude 2>$null); if ($LASTEXITCODE -eq 0 -and $out.Count -gt 0) { $excl = [string]$out[0] } } catch { $excl = $null }`,
|
|
159
|
+
`if ($excl) { `
|
|
160
|
+
+ `$dir = Split-Path -Parent $excl; `
|
|
161
|
+
+ `if ($dir -and -not (Test-Path -LiteralPath $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }; `
|
|
162
|
+
+ `$raw = ''; if (Test-Path -LiteralPath $excl) { $raw = [string](Get-Content -LiteralPath $excl -Raw) }; `
|
|
163
|
+
+ `if (@($raw -split '\\r?\\n') -notcontains '${e}') { `
|
|
164
|
+
+ `$lf = [string][char]10; $prefix = ''; if ($raw.Length -gt 0 -and -not $raw.EndsWith($lf)) { $prefix = $lf }; `
|
|
165
|
+
+ `Add-Content -LiteralPath $excl -NoNewline -Value ($prefix + '${e}' + $lf) } }`,
|
|
166
|
+
`$global:LASTEXITCODE = 0`,
|
|
167
|
+
].join('; ');
|
|
168
|
+
return this.wrapForMember(script);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/**
|
|
172
|
+
* Delete a work-folder-relative file, never erroring when it is absent.
|
|
173
|
+
* Caller: member-call.mjs runRemote (engine-side args-file delete).
|
|
174
|
+
* @param {string} relPath validated
|
|
175
|
+
* @returns {string}
|
|
176
|
+
*/
|
|
177
|
+
removeFile(relPath) {
|
|
178
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
179
|
+
return this.wrapForMember(`if (Test-Path -LiteralPath '${p}') { Remove-Item -LiteralPath '${p}' -Force }`);
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* PowerShell twin of SePosixCommands.fileExistsProbe: prints exactly
|
|
184
|
+
* FILE_PROBE_PRESENT or FILE_PROBE_ABSENT, literal path only, no member
|
|
185
|
+
* environment reads. Read-only.
|
|
186
|
+
* Caller: member-provisioning.mjs permission-config preflight.
|
|
187
|
+
* @param {string} relPath validated
|
|
188
|
+
* @returns {string}
|
|
189
|
+
*/
|
|
190
|
+
fileExistsProbe(relPath) {
|
|
191
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
192
|
+
return this.wrapForMember(`if (Test-Path -LiteralPath '${p}') { Write-Output '${FILE_PROBE_PRESENT}' } else { Write-Output '${FILE_PROBE_ABSENT}' }`);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* PowerShell twin of SePosixCommands.ensureFile: create the file (and its
|
|
197
|
+
* parent directory) when absent; an existing file is never truncated.
|
|
198
|
+
* Only literal paths, no member environment reads.
|
|
199
|
+
* Caller: beads-identity-check.mjs member beads set-up.
|
|
200
|
+
* @param {string} relPath validated
|
|
201
|
+
* @returns {string}
|
|
202
|
+
*/
|
|
203
|
+
ensureFile(relPath) {
|
|
204
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
205
|
+
const slash = p.lastIndexOf('/');
|
|
206
|
+
const dir = slash > 0 ? p.slice(0, slash) : '';
|
|
207
|
+
const parts = [];
|
|
208
|
+
if (dir) parts.push(`if (-not (Test-Path -LiteralPath '${dir}')) { New-Item -ItemType Directory -Force -Path '${dir}' | Out-Null }`);
|
|
209
|
+
parts.push(`if (-not (Test-Path -LiteralPath '${p}')) { New-Item -ItemType File -Path '${p}' | Out-Null }`);
|
|
210
|
+
return this.wrapForMember(parts.join('; '));
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/**
|
|
214
|
+
* PowerShell twin of SePosixCommands.ensureLine: make `line` a whole line
|
|
215
|
+
* of the file (created with its parent directory when absent), appended
|
|
216
|
+
* with an explicit LF and -NoNewline like ensureGitExcluded; nothing else
|
|
217
|
+
* in the file is touched. Only script-local variables, no environment reads.
|
|
218
|
+
* Caller: beads-identity-check.mjs member beads set-up.
|
|
219
|
+
* @param {string} relPath validated
|
|
220
|
+
* @param {string} line validated
|
|
221
|
+
* @returns {string}
|
|
222
|
+
*/
|
|
223
|
+
ensureLine(relPath, line) {
|
|
224
|
+
const p = assertSafeRelativePath(relPath, 'file path');
|
|
225
|
+
const l = assertSafeFileLine(line);
|
|
226
|
+
const slash = p.lastIndexOf('/');
|
|
227
|
+
const dir = slash > 0 ? p.slice(0, slash) : '';
|
|
228
|
+
const parts = [];
|
|
229
|
+
if (dir) parts.push(`if (-not (Test-Path -LiteralPath '${dir}')) { New-Item -ItemType Directory -Force -Path '${dir}' | Out-Null }`);
|
|
230
|
+
parts.push(
|
|
231
|
+
`$raw = ''; if (Test-Path -LiteralPath '${p}') { $raw = [string](Get-Content -LiteralPath '${p}' -Raw) }; `
|
|
232
|
+
+ `if (@($raw -split '\\r?\\n') -notcontains '${l}') { `
|
|
233
|
+
+ `$lf = [string][char]10; $prefix = ''; if ($raw.Length -gt 0 -and -not $raw.EndsWith($lf)) { $prefix = $lf }; `
|
|
234
|
+
+ `Add-Content -LiteralPath '${p}' -NoNewline -Value ($prefix + '${l}' + $lf) }`,
|
|
235
|
+
);
|
|
236
|
+
return this.wrapForMember(parts.join('; '));
|
|
237
|
+
}
|
|
238
|
+
|
|
128
239
|
/**
|
|
129
240
|
* This member's OWN shell already IS PowerShell, so a script destined for
|
|
130
241
|
* it needs no envelope at all -- returning it unchanged is what keeps
|
|
@@ -22,7 +22,18 @@ import path from 'path';
|
|
|
22
22
|
// - a leading tilde path (`~/...`) -- PowerShell and cmd.exe do not expand
|
|
23
23
|
// it the way POSIX sh does;
|
|
24
24
|
// - backtick command substitution (a literal backtick reaching the member),
|
|
25
|
-
// or its `$( ... )` POSIX equivalent
|
|
25
|
+
// or its `$( ... )` POSIX equivalent;
|
|
26
|
+
// - a POSIX shell SPECIAL PARAMETER -- `$?` `$!` `$$` `$#` `$@` `$*` and
|
|
27
|
+
// `$0`-`$9` (apra-fleet-i4ku.8). BARE_VAR_RE alone never covered these:
|
|
28
|
+
// it requires a letter/underscore immediately after the `$`, so every one
|
|
29
|
+
// of them silently passed this guard. Exactly like a named variable, a
|
|
30
|
+
// special parameter is evaluated by WHATEVER shell the member happens to
|
|
31
|
+
// run, so the exact same PowerShell-vs-POSIX ambiguity applies -- it must
|
|
32
|
+
// be resolved in JavaScript before dispatch, UNLESS the construct is
|
|
33
|
+
// deliberately meant to be evaluated by the member's own shell right
|
|
34
|
+
// after a prior command in the same dispatch (e.g. that shell's own `$?`
|
|
35
|
+
// immediately after a `kill` it just ran) -- which is exactly what the
|
|
36
|
+
// `shell-guard-allow` carve-out below exists for.
|
|
26
37
|
//
|
|
27
38
|
// Paths must instead be resolved in JavaScript BEFORE the command string is
|
|
28
39
|
// built -- via probeCommandFor(targetOs, shell) in src/services/member-home.ts,
|
|
@@ -141,6 +152,24 @@ const BRACED_VAR_RE = /\$\{/g;
|
|
|
141
152
|
const CMD_SUBST_RE = /\$\(/g;
|
|
142
153
|
// A leading tilde path.
|
|
143
154
|
const TILDE_RE = /(^|[\s'"`=(,:])~\//g;
|
|
155
|
+
// A POSIX shell SPECIAL PARAMETER: $? $! $$ $# $@ $* and $0-$9
|
|
156
|
+
// (apra-fleet-i4ku.8). None of these match BARE_VAR_RE above (it requires a
|
|
157
|
+
// letter/underscore right after the `$`), so every one of them was
|
|
158
|
+
// previously invisible to this guard -- see this file's header for why they
|
|
159
|
+
// carry the same shell-ambiguity risk as a named variable.
|
|
160
|
+
//
|
|
161
|
+
// Two deliberate exclusions so this stays a real signal rather than noise:
|
|
162
|
+
// - `$$` only counts when NOT immediately followed by `{` -- that shape is
|
|
163
|
+
// `$` + the start of a `${...}` JS template interpolation (already
|
|
164
|
+
// handled, correctly, by NOT being flagged -- see BRACED_VAR_RE/the
|
|
165
|
+
// 'template' segment-kind check below), not a literal "$$" (shell pid).
|
|
166
|
+
// - a digit only counts when NOT immediately followed by another digit or
|
|
167
|
+
// a `.` -- a genuine POSIX positional parameter is always exactly ONE
|
|
168
|
+
// digit (`$1`, never `$12`), so this excludes a dollar-amount literal
|
|
169
|
+
// like `$5.00` or `$1234` (this package's own cost-report strings, e.g.
|
|
170
|
+
// sprint-report.mjs, are full of these and are never dispatched to a
|
|
171
|
+
// shell at all).
|
|
172
|
+
const SPECIAL_PARAM_RE = /\$([?!#@*]|\$(?!\{)|[0-9](?![0-9.]))/g;
|
|
144
173
|
|
|
145
174
|
/**
|
|
146
175
|
* Scans one line of source and returns an array of { column, reason } for
|
|
@@ -165,6 +194,20 @@ export function findLineViolations(text) {
|
|
|
165
194
|
});
|
|
166
195
|
}
|
|
167
196
|
|
|
197
|
+
SPECIAL_PARAM_RE.lastIndex = 0;
|
|
198
|
+
while ((m = SPECIAL_PARAM_RE.exec(text)) !== null) {
|
|
199
|
+
if (!inString(m.index)) continue;
|
|
200
|
+
found.push({
|
|
201
|
+
column: m.index + 1,
|
|
202
|
+
reason:
|
|
203
|
+
`POSIX shell special parameter "$${m[1]}" in a command string -- the target member's shell may be ` +
|
|
204
|
+
'PowerShell, not POSIX, and even on POSIX this is evaluated by WHATEVER shell runs the dispatch; ' +
|
|
205
|
+
'resolve the value in JavaScript first, or if the MEMBER shell must evaluate it itself (e.g. its ' +
|
|
206
|
+
'own "$?" immediately after a prior command in the same dispatch), add a documented ' + // shell-guard-allow: this guard's own violation-message text names the "$?" construct it detects; it is never dispatched as a command string.
|
|
207
|
+
'"// shell-guard-allow: <reason>" comment on this line',
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
|
|
168
211
|
CMD_SUBST_RE.lastIndex = 0;
|
|
169
212
|
while ((m = CMD_SUBST_RE.exec(text)) !== null) {
|
|
170
213
|
if (!inString(m.index)) continue;
|
|
@@ -28,6 +28,7 @@ apra-fleet workflow fleet-sprint \
|
|
|
28
28
|
[--dispatch-timeout-s <s>] # default 9000
|
|
29
29
|
[--usage-limit-max-wait-s <s>] # usage-limit pause budget; default from role-policies
|
|
30
30
|
[--usage-limit-max-reprobes <n>]# usage-limit reprobe cap; default from role-policies
|
|
31
|
+
[--skip-regression] # skip the once-per-sprint regression pass
|
|
31
32
|
[--sync] # synced-topology mode
|
|
32
33
|
```
|
|
33
34
|
|
|
@@ -44,6 +45,9 @@ on this list -- flags evolve and this skill can drift.
|
|
|
44
45
|
is invisible to the scope filter no matter what you pass -- only true
|
|
45
46
|
children are picked up. See the epics/manifest-bead guidance in
|
|
46
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.
|
|
47
51
|
- `--branch` is created from `--base` if it does not already exist. If it
|
|
48
52
|
does exist (e.g. you are resuming), it is reused as-is.
|
|
49
53
|
- **`--base` is resolved against the remote, not your local checkout.** A new
|
|
@@ -54,7 +58,13 @@ on this list -- flags evolve and this skill can drift.
|
|
|
54
58
|
package.json script) fails in ways that look unrelated.
|
|
55
59
|
- `--role-map` assigns specific members to specific roles, e.g.
|
|
56
60
|
`--role-map '{"doer":["m1","m2"],"reviewer":["m3"]}'`. Accepts inline JSON
|
|
57
|
-
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.
|
|
58
68
|
- `--goal` controls which bead priorities are in scope for the run.
|
|
59
69
|
- `--budget` caps total spend in USD; the run aborts when it is exhausted.
|
|
60
70
|
- `--usage-limit-max-wait-s` / `--usage-limit-max-reprobes` bound how long a
|
|
@@ -74,31 +84,45 @@ on this list -- flags evolve and this skill can drift.
|
|
|
74
84
|
2. Every `--members` name is registered with the fleet (`list_members` /
|
|
75
85
|
`mcp__apra-fleet__list_members`). An unregistered member aborts the
|
|
76
86
|
sprint unless `--allow-missing-members` is passed.
|
|
77
|
-
3. Multi-member sprints
|
|
78
|
-
|
|
79
|
-
|
|
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.
|
|
80
95
|
4. If a member's LLM session is stale or unauthenticated (dispatch fails
|
|
81
96
|
with `empty_response`, or "member CLI likely died"), re-run
|
|
82
97
|
`provision_llm_auth` for that member before retrying.
|
|
83
98
|
5. Beads identity: before any `bd` mutation, the sprint probes every
|
|
84
99
|
member's `bd where`/`sync.remote`/git origin and prints a `Beads:`
|
|
85
|
-
banner plus one `beads ok: <member> ...` line per member.
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
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.
|
|
94
116
|
|
|
95
117
|
## Launching it
|
|
96
118
|
|
|
97
119
|
Run this on your own orchestrating machine, not on a `--members` target --
|
|
98
120
|
members are dispatch destinations, not where this command runs.
|
|
99
121
|
|
|
100
|
-
Use the
|
|
101
|
-
|
|
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
|
|
102
126
|
task can be silently killed when its owning tool call's process group ends,
|
|
103
127
|
which orphans the sprint mid-run.
|
|
104
128
|
|