@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
|
@@ -123,6 +123,15 @@ export function parseBeadsIdentity({ where, syncRemote, repoRemote }) {
|
|
|
123
123
|
};
|
|
124
124
|
}
|
|
125
125
|
|
|
126
|
+
// Whether the identity describes an actual beads DATABASE. `bd where` also
|
|
127
|
+
// answers a path -- and, when the tracked .beads/config.yaml carries an
|
|
128
|
+
// issue-prefix, a prefix too -- for a workspace with NO database behind it
|
|
129
|
+
// (a fresh clone of a repo that commits its beads config). Only
|
|
130
|
+
// database_path proves a database exists.
|
|
131
|
+
export function hasBeadsDatabase(id) {
|
|
132
|
+
return !!(id && id.databasePath);
|
|
133
|
+
}
|
|
134
|
+
|
|
126
135
|
export function isCompleteIdentity(id) {
|
|
127
136
|
return !!(id && id.beadsDir && id.prefix && id.syncRemote && id.repoRemote);
|
|
128
137
|
}
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Beads memory hygiene: remove token-usage memories from the beads DB at
|
|
3
|
+
// sprint start, before any dispatch.
|
|
4
|
+
//
|
|
5
|
+
// `bd prime` injects EVERY stored memory into EVERY agent session. A member
|
|
6
|
+
// running stale role prompts can write per-dispatch token-usage records as
|
|
7
|
+
// memories (`<label> [role] <model> tokens: input=<N> output=<N>`); left in
|
|
8
|
+
// the shared DB they grow without bound and bloat every session's context.
|
|
9
|
+
// This module is the engine-side defence: it lists the memories once on the
|
|
10
|
+
// backlog member and forgets
|
|
11
|
+
// - every value that matches TOKEN_MEMORY_RE (anchored to the WHOLE value),
|
|
12
|
+
// - every key in RETIRED_MEMORY_KEYS (exact key, value ignored),
|
|
13
|
+
// then pushes the beads DB once through the injected pushBeads().
|
|
14
|
+
//
|
|
15
|
+
// Deliberate policy:
|
|
16
|
+
// - a NEAR-MISS (a value that mentions `tokens: input=` but does not match
|
|
17
|
+
// the anchored rule) is warned about, never deleted;
|
|
18
|
+
// - a key outside SAFE_MEMORY_KEY_RE is skipped and warned about, never
|
|
19
|
+
// interpolated into a command;
|
|
20
|
+
// - no cap on the number of forgets;
|
|
21
|
+
// - the sweep NEVER throws: list/parse/forget/push failures are warnings
|
|
22
|
+
// and the sprint continues.
|
|
23
|
+
//
|
|
24
|
+
// Every command() call here names its member explicitly (dispatch-safety
|
|
25
|
+
// guard) and is issued failSoft + silent, like the other read-only probes in
|
|
26
|
+
// this package. pushBeads is injected so this module never imports the sync
|
|
27
|
+
// modules itself.
|
|
28
|
+
// =============================================================================
|
|
29
|
+
|
|
30
|
+
const LABEL = 'beads-hygiene';
|
|
31
|
+
export const BEADS_HYGIENE_WARNING_PREFIX = '[beads-hygiene] WARNING: ';
|
|
32
|
+
|
|
33
|
+
/** A whole memory value that is a token-usage record: label [+ role] + model, then real numbers. */
|
|
34
|
+
export const TOKEN_MEMORY_RE = /^\s*(?:\S+\s+){0,2}\S+\s+tokens:\s*input=~?\d[\d,]*\s+output=~?\d[\d,]*\s*$/i;
|
|
35
|
+
|
|
36
|
+
/** Keys forgotten by exact name regardless of value. */
|
|
37
|
+
export const RETIRED_MEMORY_KEYS = Object.freeze(['token-estimates-json']);
|
|
38
|
+
|
|
39
|
+
/** Keys are interpolated bare into a forget command; anything else is skipped. */
|
|
40
|
+
export const SAFE_MEMORY_KEY_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
|
|
41
|
+
|
|
42
|
+
const NEAR_MISS_RE = /tokens:\s*input=/i;
|
|
43
|
+
const MAX_LISTED_KEYS = 20;
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* @param {string} key
|
|
47
|
+
* @param {unknown} value
|
|
48
|
+
* @returns {'token'|'retired'|'near-miss'|'keep'}
|
|
49
|
+
*/
|
|
50
|
+
export function classifyMemory(key, value) {
|
|
51
|
+
if (RETIRED_MEMORY_KEYS.includes(key)) return 'retired';
|
|
52
|
+
if (typeof value !== 'string') return 'keep';
|
|
53
|
+
if (TOKEN_MEMORY_RE.test(value)) return 'token';
|
|
54
|
+
if (NEAR_MISS_RE.test(value)) return 'near-miss';
|
|
55
|
+
return 'keep';
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function outputOf(res) {
|
|
59
|
+
if (res && typeof res === 'object') return typeof res.output === 'string' ? res.output : '';
|
|
60
|
+
return typeof res === 'string' ? res : '';
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function failureOf(res) {
|
|
64
|
+
if (res && typeof res === 'object' && res.ok === false) return String(res.error || 'command failed');
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
function errText(err) {
|
|
69
|
+
return err && err.message ? err.message : String(err);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function summarize(text) {
|
|
73
|
+
const t = String(text || '').replace(/\s+/g, ' ').trim();
|
|
74
|
+
if (!t) return '(no output)';
|
|
75
|
+
return t.length > 200 ? `${t.slice(0, 200)}...` : t;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function listKeys(keys) {
|
|
79
|
+
if (keys.length <= MAX_LISTED_KEYS) return keys.join(', ');
|
|
80
|
+
return `${keys.slice(0, MAX_LISTED_KEYS).join(', ')} (+${keys.length - MAX_LISTED_KEYS} more)`;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
// `bd memories --json` answers a flat { key: value } object; non-string
|
|
84
|
+
// values (e.g. a schema_version field) are not memories.
|
|
85
|
+
function parseMemories(text) {
|
|
86
|
+
const trimmed = String(text || '').trim();
|
|
87
|
+
if (!trimmed) return {};
|
|
88
|
+
const parsed = JSON.parse(trimmed);
|
|
89
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
90
|
+
throw new Error('expected a JSON object of key -> value');
|
|
91
|
+
}
|
|
92
|
+
return parsed;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Lists the member's memories, forgets token-usage records and retired keys,
|
|
97
|
+
* pushes once when anything was forgotten, and logs one WARNING line
|
|
98
|
+
* summarizing it all. Never throws.
|
|
99
|
+
*
|
|
100
|
+
* @param {{ command: Function, log?: Function, member: string, pushBeads?: Function }} opts
|
|
101
|
+
* @returns {Promise<{ removed: string[], nearMisses: string[], skipped: string[], failed: string[], warnings: string[], pushed: boolean }>}
|
|
102
|
+
*/
|
|
103
|
+
export async function sweepTokenMemories({ command, log = () => {}, member, pushBeads }) {
|
|
104
|
+
const result = { removed: [], nearMisses: [], skipped: [], failed: [], warnings: [], pushed: false };
|
|
105
|
+
const warnLine = (text) => {
|
|
106
|
+
result.warnings.push(text);
|
|
107
|
+
log(`${BEADS_HYGIENE_WARNING_PREFIX}${text}`);
|
|
108
|
+
};
|
|
109
|
+
try {
|
|
110
|
+
if (typeof command !== 'function' || typeof member !== 'string' || !member) {
|
|
111
|
+
warnLine('memory sweep skipped: no command function or member was supplied.');
|
|
112
|
+
return result;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
let res;
|
|
116
|
+
try {
|
|
117
|
+
res = await command('bd memories --json', { member_name: member, silent: true, failSoft: true, label: LABEL });
|
|
118
|
+
} catch (err) {
|
|
119
|
+
res = { ok: false, output: '', error: errText(err) };
|
|
120
|
+
}
|
|
121
|
+
const listFailure = failureOf(res);
|
|
122
|
+
if (listFailure !== null) {
|
|
123
|
+
warnLine(`could not list beads memories on '${member}' (${summarize(listFailure)}); memory sweep skipped, the sprint continues.`);
|
|
124
|
+
return result;
|
|
125
|
+
}
|
|
126
|
+
let memories;
|
|
127
|
+
try {
|
|
128
|
+
memories = parseMemories(outputOf(res));
|
|
129
|
+
} catch (err) {
|
|
130
|
+
warnLine(`could not parse the beads memory list on '${member}' (${summarize(errText(err))}); memory sweep skipped, the sprint continues.`);
|
|
131
|
+
return result;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
const toForget = [];
|
|
135
|
+
for (const [key, value] of Object.entries(memories)) {
|
|
136
|
+
const kind = classifyMemory(key, value);
|
|
137
|
+
if (kind === 'keep') continue;
|
|
138
|
+
if (kind === 'near-miss') {
|
|
139
|
+
result.nearMisses.push(key);
|
|
140
|
+
continue;
|
|
141
|
+
}
|
|
142
|
+
if (!SAFE_MEMORY_KEY_RE.test(key)) {
|
|
143
|
+
result.skipped.push(key);
|
|
144
|
+
continue;
|
|
145
|
+
}
|
|
146
|
+
toForget.push(key);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
for (const key of toForget) {
|
|
150
|
+
let fres;
|
|
151
|
+
try {
|
|
152
|
+
fres = await command(`bd forget ${key}`, { member_name: member, silent: true, failSoft: true, label: LABEL });
|
|
153
|
+
} catch (err) {
|
|
154
|
+
fres = { ok: false, output: '', error: errText(err) };
|
|
155
|
+
}
|
|
156
|
+
if (failureOf(fres) !== null) result.failed.push(key);
|
|
157
|
+
else result.removed.push(key);
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
let pushError = null;
|
|
161
|
+
if (result.removed.length > 0 && typeof pushBeads === 'function') {
|
|
162
|
+
try {
|
|
163
|
+
// The real push (gitSync.syncBeadsAfter) is non-fatal: it
|
|
164
|
+
// returns a structured outcome { ok, degraded, degradedKind,
|
|
165
|
+
// detail } instead of throwing, so inspect it. A non-object
|
|
166
|
+
// return is treated as success.
|
|
167
|
+
const outcome = await pushBeads();
|
|
168
|
+
if (outcome && typeof outcome === 'object' && (outcome.degraded || outcome.ok === false)) {
|
|
169
|
+
pushError = [outcome.degradedKind, outcome.detail ?? outcome.kind].filter(Boolean).map(String).join(': ') || 'push degraded';
|
|
170
|
+
} else {
|
|
171
|
+
result.pushed = true;
|
|
172
|
+
}
|
|
173
|
+
} catch (err) {
|
|
174
|
+
pushError = errText(err);
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
if (result.removed.length || result.nearMisses.length || result.skipped.length || result.failed.length || pushError) {
|
|
179
|
+
const parts = [];
|
|
180
|
+
if (result.removed.length) {
|
|
181
|
+
parts.push(`removed ${result.removed.length} token-usage memor${result.removed.length === 1 ? 'y' : 'ies'} from the beads DB: ${listKeys(result.removed)}`);
|
|
182
|
+
}
|
|
183
|
+
if (result.failed.length) parts.push(`could not forget ${result.failed.length}: ${listKeys(result.failed)}`);
|
|
184
|
+
if (pushError) parts.push(`the beads push after the sweep failed (${summarize(pushError)}); the next beads push retries it`);
|
|
185
|
+
if (result.nearMisses.length) {
|
|
186
|
+
parts.push(`left ${result.nearMisses.length} memor${result.nearMisses.length === 1 ? 'y' : 'ies'} that mention token usage but do not match the rule (not deleted, review by hand): ${listKeys(result.nearMisses)}`);
|
|
187
|
+
}
|
|
188
|
+
if (result.skipped.length) {
|
|
189
|
+
parts.push(`skipped ${result.skipped.length} matching memor${result.skipped.length === 1 ? 'y' : 'ies'} with an unsafe key (remove by hand): ${listKeys(result.skipped.map((k) => JSON.stringify(k)))}`);
|
|
190
|
+
}
|
|
191
|
+
parts.push('a member may be running stale role prompts that store token usage as beads memories');
|
|
192
|
+
warnLine(`${parts.join('; ')}.`);
|
|
193
|
+
} else {
|
|
194
|
+
log('[beads-hygiene] no token-usage memories in the beads DB.');
|
|
195
|
+
}
|
|
196
|
+
} catch (err) {
|
|
197
|
+
// Belt and braces: the sweep must never abort a sprint.
|
|
198
|
+
warnLine(`memory sweep failed unexpectedly (${summarize(errText(err))}); the sprint continues.`);
|
|
199
|
+
}
|
|
200
|
+
return result;
|
|
201
|
+
}
|
|
@@ -312,6 +312,113 @@ export function partitionByGoalMembership(tasks, goal) {
|
|
|
312
312
|
return { sprintTasks, backlogTasks };
|
|
313
313
|
}
|
|
314
314
|
|
|
315
|
+
// ---------------------------------------------------------------------------
|
|
316
|
+
// Below-goal beads are not DISPATCHED unless they serve in-goal work
|
|
317
|
+
// ---------------------------------------------------------------------------
|
|
318
|
+
//
|
|
319
|
+
// The develop loop used to dispatch every ready leaf in scope, ordering by
|
|
320
|
+
// priority but never excluding: a P3 streak could run in round 1 of a P1/P2
|
|
321
|
+
// sprint, ahead of P1/P2 work. Exclusion uses the same "below goal" test as
|
|
322
|
+
// partitionByGoalMembership (a FINITE numeric priority strictly worse than the
|
|
323
|
+
// goal max -- a bead with no numeric priority is never excluded) and the same
|
|
324
|
+
// blocks-edge idea, made transitive: a below-goal bead stays dispatchable when
|
|
325
|
+
//
|
|
326
|
+
// - it (transitively, over 'blocks' edges) blocks an open in-goal bead --
|
|
327
|
+
// in-goal work cannot finish without it; or
|
|
328
|
+
// - this sprint already dispatched it (e.g. a reviewer reopen the
|
|
329
|
+
// worked-on exemption let through) -- the sprint is repairing its own
|
|
330
|
+
// work.
|
|
331
|
+
//
|
|
332
|
+
// Deliberately NO parent-chain exemption: a sprint's target root is normally
|
|
333
|
+
// an open in-goal epic, so "has an open in-goal ancestor" would keep every
|
|
334
|
+
// below-goal task in scope and make this filter inert.
|
|
335
|
+
//
|
|
336
|
+
// Consistent with the completion gate: that gate counts only beads at or above
|
|
337
|
+
// goal priority (`--priority-max=goalMax`), so an excluded below-goal bead
|
|
338
|
+
// never holds the sprint open.
|
|
339
|
+
|
|
340
|
+
/** A bead's `blocks` prerequisites (ids it depends on), across bd's two dependency shapes. */
|
|
341
|
+
function blocksPrereqIds(bead) {
|
|
342
|
+
const deps = bead && Array.isArray(bead.dependencies) ? bead.dependencies : [];
|
|
343
|
+
const out = [];
|
|
344
|
+
for (const d of deps) {
|
|
345
|
+
if (typeof d === 'string') { if (d) out.push(d); continue; }
|
|
346
|
+
if (!d || typeof d !== 'object') continue;
|
|
347
|
+
const type = d.type ?? d.dependency_type;
|
|
348
|
+
if (type !== undefined && type !== 'blocks') continue;
|
|
349
|
+
const id = d.depends_on_id ?? d.id;
|
|
350
|
+
if (id !== undefined && id !== null && id !== '') out.push(String(id));
|
|
351
|
+
}
|
|
352
|
+
return out;
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
/**
|
|
356
|
+
* Split ready leaf beads into those the develop loop may dispatch and the
|
|
357
|
+
* below-goal ones it must not (see the block comment above).
|
|
358
|
+
*
|
|
359
|
+
* @param {Array<object>} ready - ready leaf beads (bd list --ready shape)
|
|
360
|
+
* @param {Array<object>} scopeBeads - every in-scope bead, any status, with `dependencies` and `parent`
|
|
361
|
+
* @param {string} goal - sprint goal band, e.g. 'P1/P2'
|
|
362
|
+
* @param {{ workedOnIds?: Set<string>|Iterable<string> }} [opts]
|
|
363
|
+
* @returns {{ dispatchable: object[], excluded: Array<{ id: string, priority: number }> }}
|
|
364
|
+
*/
|
|
365
|
+
export function partitionReadyByGoal(ready, scopeBeads, goal, opts = {}) {
|
|
366
|
+
const list = Array.isArray(ready) ? ready : [];
|
|
367
|
+
const scope = Array.isArray(scopeBeads) ? scopeBeads : [];
|
|
368
|
+
const goalMaxNum = Number(goalPriorityMax(goal).slice(1));
|
|
369
|
+
const workedOn = opts.workedOnIds instanceof Set ? opts.workedOnIds : new Set(opts.workedOnIds || []);
|
|
370
|
+
const isBelowGoal = (b) =>
|
|
371
|
+
b && typeof b.priority === 'number' && Number.isFinite(b.priority) && b.priority > goalMaxNum;
|
|
372
|
+
const isOpen = (b) => b && b.status !== 'closed';
|
|
373
|
+
|
|
374
|
+
const byId = new Map();
|
|
375
|
+
for (const b of [...scope, ...list]) {
|
|
376
|
+
if (b && b.id !== undefined && b.id !== null && !byId.has(String(b.id))) byId.set(String(b.id), b);
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
// Every bead that (transitively) blocks an open in-goal bead: walk the
|
|
380
|
+
// blocks prerequisites backwards from each open in-goal bead.
|
|
381
|
+
const servesInGoal = new Set();
|
|
382
|
+
const queue = [];
|
|
383
|
+
for (const b of byId.values()) {
|
|
384
|
+
if (isOpen(b) && !isBelowGoal(b)) queue.push(String(b.id));
|
|
385
|
+
}
|
|
386
|
+
const visited = new Set(queue);
|
|
387
|
+
while (queue.length > 0) {
|
|
388
|
+
const id = queue.shift();
|
|
389
|
+
for (const pre of blocksPrereqIds(byId.get(id))) {
|
|
390
|
+
servesInGoal.add(pre);
|
|
391
|
+
if (!visited.has(pre)) { visited.add(pre); queue.push(pre); }
|
|
392
|
+
}
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
const dispatchable = [];
|
|
396
|
+
const excluded = [];
|
|
397
|
+
for (const b of list) {
|
|
398
|
+
if (!b) continue;
|
|
399
|
+
const id = String(b.id);
|
|
400
|
+
if (!isBelowGoal(b) || workedOn.has(id) || servesInGoal.has(id)) {
|
|
401
|
+
dispatchable.push(b);
|
|
402
|
+
} else {
|
|
403
|
+
excluded.push({ id, priority: b.priority });
|
|
404
|
+
}
|
|
405
|
+
}
|
|
406
|
+
return { dispatchable, excluded };
|
|
407
|
+
}
|
|
408
|
+
|
|
409
|
+
/**
|
|
410
|
+
* The run-log line for beads partitionReadyByGoal excluded from dispatch.
|
|
411
|
+
*
|
|
412
|
+
* @param {Array<{ id: string, priority: number }>} excluded
|
|
413
|
+
* @param {string} goal
|
|
414
|
+
* @returns {string}
|
|
415
|
+
*/
|
|
416
|
+
export function formatBelowGoalExclusionLog(excluded, goal) {
|
|
417
|
+
const named = excluded.map((e) => e.id + ' (P' + e.priority + ')').join(', ');
|
|
418
|
+
return `Develop dispatch: EXCLUDED ${named} -- below this sprint's goal ${goal}, not blocking any open ` +
|
|
419
|
+
'in-goal bead, and not yet worked on by this sprint -- excluded as below goal, not dispatched.';
|
|
420
|
+
}
|
|
421
|
+
|
|
315
422
|
/**
|
|
316
423
|
* Build the id->bead and parent->children indexes every scope walk needs.
|
|
317
424
|
*
|
|
@@ -470,7 +577,7 @@ export function classifyVerifySet(allBeads, targetIssues) {
|
|
|
470
577
|
* or `phase`, so every direct call -- and every helper that receives
|
|
471
578
|
* `command` via an options object -- transparently goes through them.
|
|
472
579
|
*
|
|
473
|
-
* `
|
|
580
|
+
* `getBacklogMember` is a getter, not a value, because the orchestrator
|
|
474
581
|
* member is resolved from the role->member mapping well after this client is
|
|
475
582
|
* constructed (the snapshot must exist before the `command` wrapper does,
|
|
476
583
|
* and the wrapper must exist before anything can resolve members). No fetch
|
|
@@ -481,18 +588,18 @@ export function classifyVerifySet(allBeads, targetIssues) {
|
|
|
481
588
|
* @param {string[]} opts.targetIssues - the sprint's target issue root id(s)
|
|
482
589
|
* @param {string|null} [opts.assignee] - `--assignee` narrowing for filtered queries
|
|
483
590
|
* @param {(raw: string, label: string) => any} opts.parseBdJson - bd JSON parser (injected to avoid an import cycle back into runner.js)
|
|
484
|
-
* @param {() => string} opts.
|
|
591
|
+
* @param {() => string} opts.getBacklogMember - resolves the member every read is dispatched to
|
|
485
592
|
*/
|
|
486
593
|
export function createBeadsScope(opts = {}) {
|
|
487
594
|
const targetIssues = opts.targetIssues || [];
|
|
488
595
|
const assignee = opts.assignee || null;
|
|
489
596
|
const parseBdJson = opts.parseBdJson;
|
|
490
|
-
const
|
|
597
|
+
const getBacklogMember = opts.getBacklogMember;
|
|
491
598
|
if (typeof parseBdJson !== 'function') {
|
|
492
599
|
throw new TypeError('createBeadsScope({ parseBdJson }): parseBdJson must be a function');
|
|
493
600
|
}
|
|
494
|
-
if (typeof
|
|
495
|
-
throw new TypeError('createBeadsScope({
|
|
601
|
+
if (typeof getBacklogMember !== 'function') {
|
|
602
|
+
throw new TypeError('createBeadsScope({ getBacklogMember }): getBacklogMember must be a function');
|
|
496
603
|
}
|
|
497
604
|
|
|
498
605
|
let allBeadsSnapshot = null; // { beads } -- cleared by invalidateAllBeadsCache()
|
|
@@ -575,7 +682,7 @@ export function createBeadsScope(opts = {}) {
|
|
|
575
682
|
}
|
|
576
683
|
if (!allBeadsInFlight) {
|
|
577
684
|
const allLabel = 'bd list --all --limit 0 --json';
|
|
578
|
-
allBeadsInFlight = command(allLabel, { member_name:
|
|
685
|
+
allBeadsInFlight = command(allLabel, { member_name: getBacklogMember(), silent: true })
|
|
579
686
|
.then((raw) => parseBdJson(raw, allLabel))
|
|
580
687
|
.then((beads) => {
|
|
581
688
|
allBeadsSnapshot = { beads };
|
|
@@ -623,7 +730,7 @@ export function createBeadsScope(opts = {}) {
|
|
|
623
730
|
filterArgs = `${rest} --assignee ${assignee}`;
|
|
624
731
|
}
|
|
625
732
|
const filterLabel = `bd list ${filterArgs} --limit 0`;
|
|
626
|
-
const filterRaw = await command(filterLabel, { member_name:
|
|
733
|
+
const filterRaw = await command(filterLabel, { member_name: getBacklogMember(), silent: true });
|
|
627
734
|
return parseBdJson(filterRaw, filterLabel).filter((b) => b && scopeIds.has(b.id));
|
|
628
735
|
}
|
|
629
736
|
|
|
@@ -57,7 +57,125 @@ export function isReviewerContractViolation(verdict) {
|
|
|
57
57
|
return verdict.verdict === 'CHANGES_NEEDED'
|
|
58
58
|
&& (!verdict.reopenIds || verdict.reopenIds.length === 0)
|
|
59
59
|
&& (!verdict.newTasks || verdict.newTasks.length === 0)
|
|
60
|
-
&& (!verdict.replanIds || verdict.replanIds.length === 0)
|
|
60
|
+
&& (!verdict.replanIds || verdict.replanIds.length === 0)
|
|
61
|
+
// A verdict reporting a red build/test run is actionable on its own:
|
|
62
|
+
// the orchestrator files an in-goal fix task for it (see
|
|
63
|
+
// needsRedBranchFixTask below), so it is not self-contradictory.
|
|
64
|
+
&& verdict.buildFailing !== true;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// =============================================================================
|
|
68
|
+
// RED BRANCH -> ALWAYS A FIX DISPATCH.
|
|
69
|
+
//
|
|
70
|
+
// A CHANGES_NEEDED verdict reporting a failing build or test run must always
|
|
71
|
+
// leave dispatchable work behind. Before this, a reviewer naming only
|
|
72
|
+
// below-goal reopenIds (all skipped by the goal-scope guard) -- or none at all
|
|
73
|
+
// -- left the develop loop with zero open work on a red branch: it idled or
|
|
74
|
+
// exited, and nothing ever fixed the tests. When nothing actionable survived,
|
|
75
|
+
// the orchestrator files ONE in-goal fix task carrying the reviewer's notes.
|
|
76
|
+
// =============================================================================
|
|
77
|
+
|
|
78
|
+
/** Fixed title of the orchestrator-filed red-branch fix task (also its dedupe key). */
|
|
79
|
+
export const RED_BRANCH_FIX_TITLE = 'Fix the failing build or tests on the sprint branch';
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Does this verdict need an orchestrator-filed red-branch fix task?
|
|
83
|
+
*
|
|
84
|
+
* @param {object} o
|
|
85
|
+
* @param {{ verdict: string, buildFailing?: boolean }} o.verdict
|
|
86
|
+
* @param {number} o.reopenedCount - reopens that survived the goal-scope guard
|
|
87
|
+
* @param {number} o.inGoalNewTaskCount - newTasks persisted at an in-goal priority
|
|
88
|
+
* @returns {boolean}
|
|
89
|
+
*/
|
|
90
|
+
export function needsRedBranchFixTask({ verdict, reopenedCount, inGoalNewTaskCount }) {
|
|
91
|
+
return Boolean(verdict)
|
|
92
|
+
&& verdict.verdict === 'CHANGES_NEEDED'
|
|
93
|
+
&& verdict.buildFailing === true
|
|
94
|
+
&& reopenedCount === 0
|
|
95
|
+
&& inGoalNewTaskCount === 0;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Is a newTask priority string ('P2') inside the sprint's goal band?
|
|
100
|
+
*
|
|
101
|
+
* @param {string} priority
|
|
102
|
+
* @param {number|string} goalMax
|
|
103
|
+
* @returns {boolean}
|
|
104
|
+
*/
|
|
105
|
+
export function isInGoalPriority(priority, goalMax) {
|
|
106
|
+
const p = normalizeGoalMax(String(priority));
|
|
107
|
+
const max = normalizeGoalMax(goalMax);
|
|
108
|
+
return Number.isFinite(p) && Number.isFinite(max) && p <= max;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Build the red-branch fix task: highest tier named in the goal, a fixed
|
|
113
|
+
* title, and the reviewer's notes (non-printable/non-ASCII characters
|
|
114
|
+
* replaced so newTask validation cannot reject it).
|
|
115
|
+
*
|
|
116
|
+
* @param {object} o
|
|
117
|
+
* @param {string} o.goal - e.g. 'P1/P2'
|
|
118
|
+
* @param {string} o.notes - the reviewer's notes
|
|
119
|
+
* @param {string} o.site - site label for the description, e.g. 'Review C1 R2'
|
|
120
|
+
* @param {string[]} [o.skippedReopenIds] - reopenIds the guard filtered out
|
|
121
|
+
* @returns {{ title: string, description: string, priority: string }}
|
|
122
|
+
*/
|
|
123
|
+
export function buildRedBranchFixTask({ goal, notes, site, skippedReopenIds = [] }) {
|
|
124
|
+
const tiers = String(goal || '').split('/').map((p) => Number(p.trim().replace(/^[Pp]/, ''))).filter(Number.isFinite);
|
|
125
|
+
const best = tiers.length > 0 ? Math.min(...tiers) : 1;
|
|
126
|
+
const safeNotes = String(notes || '(no reviewer notes)').replace(/[^\t\n\r\x20-\x7E]/g, '?');
|
|
127
|
+
const skipped = skippedReopenIds.length > 0
|
|
128
|
+
? `\n\nThe reviewer named these beads for rework, but none could be reopened in this sprint: ${skippedReopenIds.join(', ')}.`
|
|
129
|
+
: '';
|
|
130
|
+
return {
|
|
131
|
+
title: RED_BRANCH_FIX_TITLE,
|
|
132
|
+
priority: `P${best}`,
|
|
133
|
+
description:
|
|
134
|
+
`The reviewer (${site}) reported that the build or tests FAIL on the sprint branch, and no reopened ` +
|
|
135
|
+
`or newly filed in-goal task covers the fix. Make the project's build and full test suite pass again ` +
|
|
136
|
+
`without weakening any test, then close this task.${skipped}\n\nReviewer notes:\n${safeNotes}`,
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* File the red-branch fix task when the verdict needs one, unless an earlier
|
|
142
|
+
* one is still not closed (one open fix task at a time, never one per round).
|
|
143
|
+
*
|
|
144
|
+
* @param {object} o
|
|
145
|
+
* @param {object} o.verdict - the reviewer verdict
|
|
146
|
+
* @param {number} o.reopenedCount
|
|
147
|
+
* @param {number} o.inGoalNewTaskCount
|
|
148
|
+
* @param {string[]} [o.skippedReopenIds]
|
|
149
|
+
* @param {string} o.goal
|
|
150
|
+
* @param {string} o.site - log/description label, e.g. 'Review C1 R2'
|
|
151
|
+
* @param {(rest: string) => Promise<Array<object>>} o.bdListScoped
|
|
152
|
+
* @param {(task: {title: string, description: string, priority: string}) => Promise<any>} o.createTask - creates the bead; truthy on success
|
|
153
|
+
* @param {(msg: string) => void} o.log
|
|
154
|
+
* @returns {Promise<'not-needed'|'exists'|'created'|'failed'>}
|
|
155
|
+
*/
|
|
156
|
+
export async function ensureRedBranchFixTask(o) {
|
|
157
|
+
const { verdict, reopenedCount, inGoalNewTaskCount, skippedReopenIds = [], goal, site, bdListScoped, createTask, log } = o;
|
|
158
|
+
if (!needsRedBranchFixTask({ verdict, reopenedCount, inGoalNewTaskCount })) return 'not-needed';
|
|
159
|
+
let existing = null;
|
|
160
|
+
try {
|
|
161
|
+
const scope = await bdListScoped('');
|
|
162
|
+
existing = scope.find((b) => b && b.title === RED_BRANCH_FIX_TITLE && b.status !== 'closed') || null;
|
|
163
|
+
} catch {
|
|
164
|
+
existing = null; // lookup failed -- file the task rather than risk leaving a red branch with no work
|
|
165
|
+
}
|
|
166
|
+
if (existing) {
|
|
167
|
+
log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- red-branch fix task ${existing.id} is still open, not filing another.`);
|
|
168
|
+
return 'exists';
|
|
169
|
+
}
|
|
170
|
+
const task = buildRedBranchFixTask({ goal, notes: verdict.notes, site, skippedReopenIds });
|
|
171
|
+
const created = await createTask(task);
|
|
172
|
+
if (created) {
|
|
173
|
+
const idText = created && typeof created === 'object' && created.childId ? ` ${created.childId}` : '';
|
|
174
|
+
log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- filed in-goal red-branch fix task${idText} ("${task.title}", ${task.priority}) so the branch is never left red with zero open work.`);
|
|
175
|
+
return 'created';
|
|
176
|
+
}
|
|
177
|
+
log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- filing the red-branch fix task FAILED; see the newTask persistence log above.`);
|
|
178
|
+
return 'failed';
|
|
61
179
|
}
|
|
62
180
|
|
|
63
181
|
/**
|
|
@@ -130,18 +248,41 @@ export function normalizeGoalMax(goalMax) {
|
|
|
130
248
|
* because comparing against the raw 'P2' string is what made this guard inert
|
|
131
249
|
* (see normalizeGoalMax).
|
|
132
250
|
*
|
|
251
|
+
* WORKED-ON EXEMPTION. A below-goal bead THIS SPRINT already dispatched or
|
|
252
|
+
* closed is never deferred: the sprint's own commits for it are on the branch
|
|
253
|
+
* under review, so a reviewer reopening it is asking the sprint to repair its
|
|
254
|
+
* own work (typically a red build or test run) -- not to pull deferred scope
|
|
255
|
+
* back in. Skipping that reopen left a red branch with nothing dispatched to
|
|
256
|
+
* fix it. `belowGoal` is still reported so the caller can log WHY the bead
|
|
257
|
+
* was kept.
|
|
258
|
+
*
|
|
133
259
|
* @param {Map<string, object>|null} allowlist
|
|
134
260
|
* @param {string} id
|
|
135
261
|
* @param {number|string} goalMax - numeric ceiling, or the 'Pn' string form
|
|
136
|
-
* @
|
|
262
|
+
* @param {Set<string>|Iterable<string>|null} [workedOnIds] - bead ids this sprint dispatched or closed
|
|
263
|
+
* @returns {{ deferred: boolean, priority: number|null, belowGoal: boolean, workedOn: boolean }}
|
|
137
264
|
*/
|
|
138
|
-
export function isDeferredScopeReopen(allowlist, id, goalMax) {
|
|
265
|
+
export function isDeferredScopeReopen(allowlist, id, goalMax, workedOnIds = null) {
|
|
139
266
|
const bead = allowlist ? allowlist.get(id) : null;
|
|
140
267
|
const max = normalizeGoalMax(goalMax);
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
return { deferred:
|
|
268
|
+
const priority = bead && typeof bead.priority === 'number' ? bead.priority : null;
|
|
269
|
+
const belowGoal = Boolean(allowlist && bead && priority !== null && priority > max);
|
|
270
|
+
const workedOn = toIdSet(workedOnIds).has(id);
|
|
271
|
+
return { deferred: belowGoal && !workedOn, priority, belowGoal, workedOn };
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Normalise an optional worked-on id collection (Set, array, any iterable, or
|
|
276
|
+
* absent) to a Set. Absent means "the sprint has worked on nothing yet", which
|
|
277
|
+
* keeps the guard's historical behaviour exactly.
|
|
278
|
+
*
|
|
279
|
+
* @param {Set<string>|Iterable<string>|null|undefined} ids
|
|
280
|
+
* @returns {Set<string>}
|
|
281
|
+
*/
|
|
282
|
+
function toIdSet(ids) {
|
|
283
|
+
if (ids instanceof Set) return ids;
|
|
284
|
+
if (ids && typeof ids[Symbol.iterator] === 'function' && typeof ids !== 'string') return new Set(ids);
|
|
285
|
+
return new Set();
|
|
145
286
|
}
|
|
146
287
|
|
|
147
288
|
/**
|
|
@@ -197,12 +338,14 @@ export function parseIdWithReasonEntry(entry) {
|
|
|
197
338
|
* @param {(e: {id: string, reason: string}) => {cmd: string, label: string}|null} o.buildReopenCommand
|
|
198
339
|
* @param {(e: {id: string, reason: string}) => void} [o.onReopened] - per-bead side effects (thrash counters, feedback routing)
|
|
199
340
|
* @param {(e: {id: string, reason: string}, err: Error) => void} [o.onEntryError] - when present, a throwing entry is non-fatal and reported here
|
|
341
|
+
* @param {Set<string>|Iterable<string>} [o.workedOnIds] - bead ids this sprint dispatched or closed; a below-goal reopen of one of these is APPLIED (see isDeferredScopeReopen)
|
|
200
342
|
* @returns {Promise<string[]>} the ids ACTUALLY reopened (survived the guard)
|
|
201
343
|
*/
|
|
202
344
|
export async function applyGuardedReopens(o) {
|
|
203
345
|
const {
|
|
204
346
|
entries, bdListScoped, goalMax, goal, logPrefix, log, command, member,
|
|
205
347
|
parseEntry = parseBareIdEntry, buildReopenCommand, onReopened, onEntryError,
|
|
348
|
+
workedOnIds = null,
|
|
206
349
|
} = o;
|
|
207
350
|
|
|
208
351
|
const list = Array.isArray(entries) ? entries : [];
|
|
@@ -221,11 +364,14 @@ export async function applyGuardedReopens(o) {
|
|
|
221
364
|
continue;
|
|
222
365
|
}
|
|
223
366
|
|
|
224
|
-
const { deferred, priority } = isDeferredScopeReopen(allowlist, parsed.id, goalMax);
|
|
367
|
+
const { deferred, priority, belowGoal } = isDeferredScopeReopen(allowlist, parsed.id, goalMax, workedOnIds);
|
|
225
368
|
if (deferred) {
|
|
226
369
|
log(`${logPrefix}: SKIPPED '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal} -- deferred scope, not reopened).`);
|
|
227
370
|
continue;
|
|
228
371
|
}
|
|
372
|
+
if (belowGoal) {
|
|
373
|
+
log(`${logPrefix}: KEPT '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal}, but this sprint already dispatched or closed it -- reopening so the sprint repairs its own work).`);
|
|
374
|
+
}
|
|
229
375
|
|
|
230
376
|
try {
|
|
231
377
|
const built = buildReopenCommand(parsed);
|