@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
|
@@ -0,0 +1,982 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- Backlog-last tree with partial-claim annotations
|
|
3
|
+
// (apra-fleet-eft.6.2, Plan Part 2.3)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// The index page (GET /, dashboard.mjs) renders one section per running sprint
|
|
7
|
+
// FIRST, then -- ALWAYS LAST -- the Backlog. The Backlog is the full issue
|
|
8
|
+
// tracker MINUS the union of every active sprint's LIVE-expanded issue scope,
|
|
9
|
+
// rendered as a TREE (parent-child hierarchy), not a flat list, with per-node
|
|
10
|
+
// claim status.
|
|
11
|
+
//
|
|
12
|
+
// WHY "minus the live-expanded union", not "minus a launch-time snapshot": a
|
|
13
|
+
// sprint's subtree grows mid-run (planners/reviewers add tasks under an
|
|
14
|
+
// already-claimed root). So the claimed set is recomputed AT RENDER TIME by
|
|
15
|
+
// re-expanding each active sprint's roots -- the exact same live-subtree
|
|
16
|
+
// question eft.5.3's expandScope() (./scope-overlap.mjs) answers for the
|
|
17
|
+
// launch-time overlap guard, but computed here IN-MEMORY (apra-fleet-c4s) via
|
|
18
|
+
// expandScopeInMemory(), walking a child-index built off the single bulk
|
|
19
|
+
// `bd list --json --limit 0` fetch this module already does per render,
|
|
20
|
+
// instead of one `bd list --parent <id>` subprocess call per discovered node.
|
|
21
|
+
// A bead created after launch, under a claimed root, is claimed the instant
|
|
22
|
+
// it exists and never leaks into the Backlog.
|
|
23
|
+
//
|
|
24
|
+
// NO DUPLICATION across the page (acceptance criterion): a claimed bead appears
|
|
25
|
+
// ONLY under its owning sprint's section, NEVER in the Backlog, and NEVER
|
|
26
|
+
// twice. Because a claimed scope is a full subtree, claiming a node claims all
|
|
27
|
+
// its descendants -- so a claimed node is dropped from the Backlog wholesale.
|
|
28
|
+
//
|
|
29
|
+
// PARTIAL-CLAIM PARENTS (the subtle case): a sprint can be rooted at SOME of an
|
|
30
|
+
// epic's children (not the epic itself). Then the epic is still FREE (unclaimed)
|
|
31
|
+
// but a strict subset of its children are claimed. The epic stays visible in the
|
|
32
|
+
// Backlog, showing ONLY its free children, and carries a partial-claim
|
|
33
|
+
// annotation naming the owning sprint(s) and the claimed/free counts -- e.g.
|
|
34
|
+
// "2 of 5 children claimed by sprint-abc123; 3 free" -- steering the operator to
|
|
35
|
+
// multi-select exactly the free children. This is UI STEERING ONLY: the server's
|
|
36
|
+
// exact-overlap launch policy (createScopeGuard in ./scope-overlap.mjs) is
|
|
37
|
+
// unchanged and still rejects any overlapping multi-select. The annotation just
|
|
38
|
+
// helps the operator pick a non-overlapping set in the first place.
|
|
39
|
+
// =============================================================================
|
|
40
|
+
|
|
41
|
+
import { escapeHtml } from '@apralabs/apra-fleet-workflow/viewer/html-utils';
|
|
42
|
+
import { WATCHDOG_STATUS } from './watchdog.mjs';
|
|
43
|
+
import { renderBeadsHtml } from '../../fleet-sprint/viewer-extensions.mjs';
|
|
44
|
+
import { sendJson } from './server.mjs';
|
|
45
|
+
import { execBdAsync } from './lib/exec-bd.mjs';
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Extract a bead's parent id from a raw `bd list --json` row. The parent-child
|
|
49
|
+
* grouping edge is a dependency whose `type` is `parent-child` and whose
|
|
50
|
+
* `issue_id` is the bead itself; `depends_on_id` is the PARENT (grouping edges
|
|
51
|
+
* point child -> parent). Returns null when the bead is a tracker root.
|
|
52
|
+
* @param {object} raw
|
|
53
|
+
* @returns {string|null}
|
|
54
|
+
*/
|
|
55
|
+
export function parentIdOf(raw) {
|
|
56
|
+
if (!raw || typeof raw !== 'object') return null;
|
|
57
|
+
if (typeof raw.parentId === 'string' && raw.parentId.length > 0) return raw.parentId;
|
|
58
|
+
if (typeof raw.parent === 'string' && raw.parent.length > 0) return raw.parent;
|
|
59
|
+
const deps = Array.isArray(raw.dependencies) ? raw.dependencies : [];
|
|
60
|
+
for (const d of deps) {
|
|
61
|
+
if (d && d.type === 'parent-child' && d.issue_id === raw.id && typeof d.depends_on_id === 'string') {
|
|
62
|
+
return d.depends_on_id;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* Normalize a raw `bd list --json` row (or an already-normalized object) into
|
|
70
|
+
* the minimal shape the tree builder/renderer needs.
|
|
71
|
+
*
|
|
72
|
+
* `priority` is preserved (not dropped) because downstream consumers filter
|
|
73
|
+
* on it: apra-fleet-x8r.4's computeSprintProgress() gates a bead's inclusion
|
|
74
|
+
* in the sprint-required set on `typeof b.priority === 'number'`, and the
|
|
75
|
+
* supervisor dashboard's default listAllBeads source (bdListAllBeads() below)
|
|
76
|
+
* is this function applied to every raw row. Dropping `priority` here made
|
|
77
|
+
* that goalMax filtering silently inert in production while still appearing
|
|
78
|
+
* to work in tests that hand-built already-normalized-shaped fixtures instead
|
|
79
|
+
* of routing raw rows through this function (apra-fleet-x8r.7). Preserved as
|
|
80
|
+
* `null` (never a numeric default like 0) when absent/non-numeric, so
|
|
81
|
+
* "no priority filtering for this bead" stays unambiguous downstream.
|
|
82
|
+
* @param {object} raw
|
|
83
|
+
* @returns {{ id: string, title: string, issueType: string, status: string, parentId: string|null, priority: number|null }}
|
|
84
|
+
*/
|
|
85
|
+
export function normalizeBead(raw) {
|
|
86
|
+
const b = raw || {};
|
|
87
|
+
const rawPriority = b.priority;
|
|
88
|
+
const normalized = {
|
|
89
|
+
id: typeof b.id === 'string' ? b.id : '',
|
|
90
|
+
title: typeof b.title === 'string' ? b.title : '',
|
|
91
|
+
issueType: b.issueType ?? b.issue_type ?? 'task',
|
|
92
|
+
status: b.status ?? 'open',
|
|
93
|
+
parentId: parentIdOf(b),
|
|
94
|
+
priority: typeof rawPriority === 'number' && Number.isFinite(rawPriority) ? rawPriority : null,
|
|
95
|
+
};
|
|
96
|
+
// A server-computed `placement` ('sprint' | 'backlog', runner.js's
|
|
97
|
+
// partitionByGoalMembership) is passed through when present: sprint-
|
|
98
|
+
// progress.mjs's computeSprintProgress() branches on it BEFORE the numeric
|
|
99
|
+
// priority filter, so dropping it here would silently change a
|
|
100
|
+
// placement-carrying row's membership. Raw `bd list` rows never carry it.
|
|
101
|
+
if (typeof b.placement === 'string') normalized.placement = b.placement;
|
|
102
|
+
return normalized;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Default full-tracker source: `bd list --json --limit 0`, normalized. One call
|
|
107
|
+
* returns every bead with its dependency edges (from which parentIdOf() derives
|
|
108
|
+
* the grouping hierarchy), so no per-node querying is needed to reconstruct the
|
|
109
|
+
* tree here.
|
|
110
|
+
* @returns {Promise<Array<ReturnType<typeof normalizeBead>>>}
|
|
111
|
+
*/
|
|
112
|
+
async function fetchAllBeadsRaw() {
|
|
113
|
+
// Routed through the shared execBdAsync() helper (apra-fleet-xuo.2) --
|
|
114
|
+
// on Windows it resolves the `bd.cmd` shim directly (no `shell: true`),
|
|
115
|
+
// avoiding both the ENOENT spawn issue a bare `execFileAsync('bd', ...)`
|
|
116
|
+
// would hit AND the metacharacter-injection risk `shell: true` carries.
|
|
117
|
+
// Every argument here is a static literal anyway (none caller-controlled),
|
|
118
|
+
// but the shared helper keeps this call consistent with scope-overlap.mjs's.
|
|
119
|
+
const { stdout } = await execBdAsync(['list', '--json', '--limit', '0']);
|
|
120
|
+
const text = stdout && stdout.trim() ? stdout : '[]';
|
|
121
|
+
let rows;
|
|
122
|
+
try {
|
|
123
|
+
rows = JSON.parse(text);
|
|
124
|
+
} catch (err) {
|
|
125
|
+
throw new Error(`[backlog] failed to parse 'bd list --json': ${err.message}`);
|
|
126
|
+
}
|
|
127
|
+
if (!Array.isArray(rows)) return [];
|
|
128
|
+
return rows.filter((b) => b && typeof b.id === 'string' && b.id.length > 0);
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* Raw `bd list --json --limit 0` rows, UNNORMALIZED -- every field `bd` emits
|
|
133
|
+
* (dependencies, priority, issue_type, metadata, description, parent, ...) is
|
|
134
|
+
* preserved. `bdListAllBeads()` below builds its minimal tree-node shape from
|
|
135
|
+
* this; `createBacklog().buildBacklogTasks()` uses the SAME call (one `bd`
|
|
136
|
+
* invocation per page render, not two) because it needs the fuller shape to
|
|
137
|
+
* feed fleet-sprint's `renderBeadsHtml()` (type/status/priority/model badges,
|
|
138
|
+
* `blocks`-edge nesting, full descriptions) unchanged.
|
|
139
|
+
* @returns {Promise<Array<object>>}
|
|
140
|
+
*/
|
|
141
|
+
export async function bdListAllBeadsRaw() {
|
|
142
|
+
return fetchAllBeadsRaw();
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export async function bdListAllBeads() {
|
|
146
|
+
const rows = await fetchAllBeadsRaw();
|
|
147
|
+
return rows.map(normalizeBead).filter((b) => b.id.length > 0);
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* Build a parent-id -> direct-child-ids index off an already-fetched, already-
|
|
152
|
+
* normalized beads list. This is the SAME technique `buildBacklogTree()`
|
|
153
|
+
* (below, `allChildrenOf`) and `computePartialClaimByBead()` already use to
|
|
154
|
+
* derive containment structure from one bulk `bd list` fetch, factored out
|
|
155
|
+
* here so `expandScopeInMemory()` can share it.
|
|
156
|
+
* @param {Array<{ id: string, parentId: string|null }>} beads - normalizeBead() shape
|
|
157
|
+
* @returns {Map<string, string[]>}
|
|
158
|
+
*/
|
|
159
|
+
export function buildChildIndex(beads) {
|
|
160
|
+
const idx = new Map();
|
|
161
|
+
for (const b of Array.isArray(beads) ? beads : []) {
|
|
162
|
+
const pid = b && b.parentId;
|
|
163
|
+
if (!pid) continue;
|
|
164
|
+
if (!idx.has(pid)) idx.set(pid, []);
|
|
165
|
+
idx.get(pid).push(b.id);
|
|
166
|
+
}
|
|
167
|
+
return idx;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
/**
|
|
171
|
+
* In-memory equivalent of `expandScope()` (./scope-overlap.mjs): expands a set
|
|
172
|
+
* of root issue ids into the full parent-child subtree they span (roots
|
|
173
|
+
* INCLUDED), via the identical breadth-first-walk logic -- but walking a
|
|
174
|
+
* `buildChildIndex()` Map built off an already-fetched flat beads list
|
|
175
|
+
* instead of issuing one `bd list --parent <id>` subprocess call per
|
|
176
|
+
* discovered node. Same roots + same beads list -> IDENTICAL result to the
|
|
177
|
+
* subprocess-based `expandScope()` (apra-fleet-c4s).
|
|
178
|
+
* @param {Iterable<string>} roots
|
|
179
|
+
* @param {Map<string, string[]>} childIndex - from buildChildIndex()
|
|
180
|
+
* @returns {Set<string>} every bead id in the subtree, roots included
|
|
181
|
+
*/
|
|
182
|
+
export function expandScopeInMemory(roots, childIndex) {
|
|
183
|
+
const idx = childIndex instanceof Map ? childIndex : new Map();
|
|
184
|
+
const scope = new Set();
|
|
185
|
+
const frontier = [];
|
|
186
|
+
for (const r of roots ?? []) {
|
|
187
|
+
if (typeof r === 'string' && r.length > 0 && !scope.has(r)) {
|
|
188
|
+
scope.add(r);
|
|
189
|
+
frontier.push(r);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
while (frontier.length > 0) {
|
|
193
|
+
const id = frontier.shift();
|
|
194
|
+
const children = idx.get(id) ?? [];
|
|
195
|
+
for (const child of children) {
|
|
196
|
+
if (typeof child === 'string' && child.length > 0 && !scope.has(child)) {
|
|
197
|
+
scope.add(child);
|
|
198
|
+
frontier.push(child);
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
return scope;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** Normalize a claimedBy value (single owner string) into an array of sprint ids. */
|
|
206
|
+
function ownersOf(value) {
|
|
207
|
+
if (Array.isArray(value)) return value.filter((v) => typeof v === 'string' && v.length > 0);
|
|
208
|
+
if (typeof value === 'string' && value.length > 0) return [value];
|
|
209
|
+
return [];
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Build the Backlog forest: the full tracker with every CLAIMED subtree pruned,
|
|
214
|
+
* preserving parent-child hierarchy. A partial-claim parent (free itself, but
|
|
215
|
+
* with a strict subset of claimed children) stays in the forest with only its
|
|
216
|
+
* free children and a `partialClaim` annotation.
|
|
217
|
+
*
|
|
218
|
+
* @param {Array<{ id: string, title: string, issueType: string, status: string, parentId: string|null }>} beads
|
|
219
|
+
* @param {Map<string, string|string[]>} claimedBy - claimed bead id -> owning sprint id(s)
|
|
220
|
+
* @returns {Array<BacklogNode>} root nodes of the free forest
|
|
221
|
+
*/
|
|
222
|
+
export function buildBacklogTree(beads, claimedBy) {
|
|
223
|
+
const list = Array.isArray(beads) ? beads : [];
|
|
224
|
+
const claims = claimedBy instanceof Map ? claimedBy : new Map();
|
|
225
|
+
const byId = new Map(list.map((b) => [b.id, b]));
|
|
226
|
+
const isClaimed = (id) => claims.has(id);
|
|
227
|
+
|
|
228
|
+
// Full-tracker child index (INCLUDING claimed children) -- buildNode()
|
|
229
|
+
// below needs the complete direct-child set to split into free/claimed,
|
|
230
|
+
// not just the free ones.
|
|
231
|
+
const allChildrenOf = new Map();
|
|
232
|
+
for (const b of list) {
|
|
233
|
+
const pid = b.parentId;
|
|
234
|
+
if (pid && byId.has(pid)) {
|
|
235
|
+
if (!allChildrenOf.has(pid)) allChildrenOf.set(pid, []);
|
|
236
|
+
allChildrenOf.get(pid).push(b);
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
// The partial-claim annotation itself (counts + owning sprints) is the
|
|
241
|
+
// SAME computation the flat beads-tree view needs (buildBacklogTasks()
|
|
242
|
+
// below) -- computePartialClaimByBead() is the one place that logic
|
|
243
|
+
// lives; this function only adds tree STRUCTURE (nesting, pruning
|
|
244
|
+
// claimed subtrees) on top of it.
|
|
245
|
+
const partialClaimById = computePartialClaimByBead(list, claims);
|
|
246
|
+
|
|
247
|
+
function buildNode(bead) {
|
|
248
|
+
const kids = allChildrenOf.get(bead.id) ?? [];
|
|
249
|
+
const freeKids = kids.filter((c) => !isClaimed(c.id));
|
|
250
|
+
return {
|
|
251
|
+
id: bead.id,
|
|
252
|
+
title: bead.title,
|
|
253
|
+
issueType: bead.issueType,
|
|
254
|
+
status: bead.status,
|
|
255
|
+
partialClaim: partialClaimById.get(bead.id) ?? null,
|
|
256
|
+
children: freeKids.map(buildNode),
|
|
257
|
+
};
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
// A free bead roots the Backlog forest when it has no parent, or its parent
|
|
261
|
+
// is claimed / absent from the tracker (defensive re-rooting: in a valid
|
|
262
|
+
// full-subtree claim a free node's parent is always free too, but never
|
|
263
|
+
// silently drop a free node whose ancestor chain is broken).
|
|
264
|
+
const roots = list.filter((b) => {
|
|
265
|
+
if (isClaimed(b.id)) return false;
|
|
266
|
+
const pid = b.parentId;
|
|
267
|
+
return !(pid && byId.has(pid) && !isClaimed(pid));
|
|
268
|
+
});
|
|
269
|
+
return roots.map(buildNode);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
/**
|
|
273
|
+
* Per-bead partial-claim lookup: `Map<freeBeadId, PartialClaim|null>`, keyed
|
|
274
|
+
* off each free bead's OWN direct children. Shared by `buildBacklogTree()`
|
|
275
|
+
* above (which attaches each entry to its tree node) and
|
|
276
|
+
* `createBacklog().buildBacklogTasks()` below (which has no containment tree
|
|
277
|
+
* to hang the annotation off -- its beads-tree view nests by `blocks` edges,
|
|
278
|
+
* not `parent` containment -- so it reads this map directly and renders the
|
|
279
|
+
* annotation inline on the flat row instead).
|
|
280
|
+
* @param {Array<{ id: string, parentId: string|null }>} beads - normalizeBead() shape
|
|
281
|
+
* @param {Map<string, string|string[]>} claimedBy
|
|
282
|
+
* @returns {Map<string, { totalCount: number, claimedCount: number, freeCount: number, sprints: Array<{ sprintId: string, count: number }> }|null>}
|
|
283
|
+
*/
|
|
284
|
+
export function computePartialClaimByBead(beads, claimedBy) {
|
|
285
|
+
const list = Array.isArray(beads) ? beads : [];
|
|
286
|
+
const claims = claimedBy instanceof Map ? claimedBy : new Map();
|
|
287
|
+
const byId = new Map(list.map((b) => [b.id, b]));
|
|
288
|
+
const isClaimed = (id) => claims.has(id);
|
|
289
|
+
|
|
290
|
+
const allChildrenOf = new Map();
|
|
291
|
+
for (const b of list) {
|
|
292
|
+
const pid = b.parentId;
|
|
293
|
+
if (pid && byId.has(pid)) {
|
|
294
|
+
if (!allChildrenOf.has(pid)) allChildrenOf.set(pid, []);
|
|
295
|
+
allChildrenOf.get(pid).push(b);
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
const result = new Map();
|
|
300
|
+
for (const b of list) {
|
|
301
|
+
if (isClaimed(b.id)) continue;
|
|
302
|
+
const kids = allChildrenOf.get(b.id) ?? [];
|
|
303
|
+
const claimedKids = kids.filter((c) => isClaimed(c.id));
|
|
304
|
+
if (claimedKids.length === 0) {
|
|
305
|
+
result.set(b.id, null);
|
|
306
|
+
continue;
|
|
307
|
+
}
|
|
308
|
+
const sprintCounts = new Map();
|
|
309
|
+
for (const c of claimedKids) {
|
|
310
|
+
for (const owner of ownersOf(claims.get(c.id))) {
|
|
311
|
+
sprintCounts.set(owner, (sprintCounts.get(owner) ?? 0) + 1);
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
result.set(b.id, {
|
|
315
|
+
totalCount: kids.length,
|
|
316
|
+
claimedCount: claimedKids.length,
|
|
317
|
+
freeCount: kids.length - claimedKids.length,
|
|
318
|
+
sprints: [...sprintCounts.entries()].map(([sprintId, count]) => ({ sprintId, count })),
|
|
319
|
+
});
|
|
320
|
+
}
|
|
321
|
+
return result;
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
/**
|
|
325
|
+
* Human-readable partial-claim annotation, e.g.
|
|
326
|
+
* "2 of 5 children claimed by sprint-abc123; 3 free".
|
|
327
|
+
* @param {{ totalCount: number, claimedCount: number, freeCount: number, sprints: Array<{ sprintId: string, count: number }> }} pc
|
|
328
|
+
* @returns {string}
|
|
329
|
+
*/
|
|
330
|
+
export function formatPartialClaim(pc) {
|
|
331
|
+
const sprintLabel = pc.sprints.length === 0
|
|
332
|
+
? 'an active sprint'
|
|
333
|
+
: pc.sprints.map((s) => (pc.sprints.length > 1 ? `${s.sprintId} (${s.count})` : s.sprintId)).join(', ');
|
|
334
|
+
return `${pc.claimedCount} of ${pc.totalCount} children claimed by ${sprintLabel}; ${pc.freeCount} free`;
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/** Renders one Backlog tree node (and its free descendants) as a nested <li>. */
|
|
338
|
+
function renderBacklogNode(node) {
|
|
339
|
+
const id = escapeHtml(node.id);
|
|
340
|
+
const title = escapeHtml(node.title || '(untitled)');
|
|
341
|
+
const type = escapeHtml(node.issueType || 'task');
|
|
342
|
+
const status = escapeHtml(node.status || 'open');
|
|
343
|
+
const annotation = node.partialClaim
|
|
344
|
+
? ' <span data-partial-claim="true" style="color:#f59e0b; font-size: 12px; font-style: italic;">(' +
|
|
345
|
+
escapeHtml(formatPartialClaim(node.partialClaim)) + ')</span>'
|
|
346
|
+
: '';
|
|
347
|
+
const childrenHtml = node.children && node.children.length > 0
|
|
348
|
+
? '<ul style="list-style: none; margin: 2px 0 2px 16px; padding: 0;">' +
|
|
349
|
+
node.children.map(renderBacklogNode).join('') + '</ul>'
|
|
350
|
+
: '';
|
|
351
|
+
return (
|
|
352
|
+
'<li data-bead-id="' + id + '" style="margin: 2px 0;">' +
|
|
353
|
+
'<span style="font-family: monospace; color:#a1a1aa;">' + id + '</span> ' +
|
|
354
|
+
'<span>' + title + '</span> ' +
|
|
355
|
+
'<span style="color:#71717a; font-size: 11px;">[' + type + ' - ' + status + ']</span>' +
|
|
356
|
+
annotation +
|
|
357
|
+
childrenHtml +
|
|
358
|
+
'</li>'
|
|
359
|
+
);
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
/**
|
|
363
|
+
* Render the full Backlog tree. An empty forest renders an explicit empty-state
|
|
364
|
+
* message (never a blank/throw). The hierarchy is nested <ul>/<li>, never a flat
|
|
365
|
+
* list (acceptance criterion).
|
|
366
|
+
* @param {BacklogNode[]} [tree]
|
|
367
|
+
* @returns {string}
|
|
368
|
+
*/
|
|
369
|
+
export function renderBacklogTreeHtml(tree) {
|
|
370
|
+
const roots = Array.isArray(tree) ? tree : [];
|
|
371
|
+
if (roots.length === 0) {
|
|
372
|
+
return '<p style="color:#71717a; font-style: italic;">No unclaimed work in the backlog.</p>';
|
|
373
|
+
}
|
|
374
|
+
return '<ul style="list-style: none; margin: 0; padding: 0;">' +
|
|
375
|
+
roots.map(renderBacklogNode).join('') + '</ul>';
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
/**
|
|
379
|
+
* @typedef {object} BacklogNode
|
|
380
|
+
* @property {string} id
|
|
381
|
+
* @property {string} title
|
|
382
|
+
* @property {string} issueType
|
|
383
|
+
* @property {string} status
|
|
384
|
+
* @property {{ totalCount: number, claimedCount: number, freeCount: number, sprints: Array<{ sprintId: string, count: number }> }|null} partialClaim
|
|
385
|
+
* @property {BacklogNode[]} children
|
|
386
|
+
*/
|
|
387
|
+
|
|
388
|
+
/**
|
|
389
|
+
* apra-fleet-7xk-style server-side narrowing: filters a flat raw-bead-row
|
|
390
|
+
* array (the same shape `bdListAllBeadsRaw()` returns, plus this module's
|
|
391
|
+
* `partialClaim` field) down to the rows matching every supplied criterion,
|
|
392
|
+
* AND reports which distinct values are actually present (so a caller can
|
|
393
|
+
* populate Type/Status/Priority/Model filter controls from real data, not a
|
|
394
|
+
* guessed enum). Pure/synchronous -- narrows the SET before it is ever handed
|
|
395
|
+
* to a renderer, not a client-side hide/show pass over an already-fetched
|
|
396
|
+
* full set (that distinction is the acceptance criterion this mirrors).
|
|
397
|
+
* After the type/status/priority/model/q narrowing, `filters.sort` (only
|
|
398
|
+
* `'created_at'` is supported today) orders the resulting rows by each row's
|
|
399
|
+
* `created_at` timestamp; `filters.dir` picks `'asc'` or `'desc'` (default
|
|
400
|
+
* `'desc'`). `created_at` is parsed defensively -- rows come straight from
|
|
401
|
+
* `bd list --json`, where it is an ISO string like `'2026-08-21T04:36:29Z'` --
|
|
402
|
+
* so a missing/unparseable value NEVER throws and always sorts last,
|
|
403
|
+
* regardless of direction. The sort is stable relative to incoming order for
|
|
404
|
+
* equal (or equally-invalid) timestamps. Omitting `filters.sort` leaves row
|
|
405
|
+
* order exactly as `bd`/the type/status/priority/model/q narrowing produced
|
|
406
|
+
* it -- no reordering is imposed.
|
|
407
|
+
* @param {Array<object>} rows
|
|
408
|
+
* @param {{ type?: string, status?: string, priority?: string|number, model?: string, q?: string, sort?: string, dir?: string }} [filters]
|
|
409
|
+
* @returns {{ tasks: object[], total: number, filterOptions: { type: string[], status: string[], priority: number[], model: string[] } }}
|
|
410
|
+
*/
|
|
411
|
+
export function applyBeadFilters(rows, filters) {
|
|
412
|
+
const list = Array.isArray(rows) ? rows : [];
|
|
413
|
+
const typeOf = (r) => (r.issue_type ?? r.issueType ?? '').toString();
|
|
414
|
+
const modelOf = (r) => (r.metadata && r.metadata.model) || '';
|
|
415
|
+
|
|
416
|
+
const filterOptions = {
|
|
417
|
+
type: [...new Set(list.map(typeOf).filter((v) => v.length > 0))].sort(),
|
|
418
|
+
status: [...new Set(list.map((r) => (r.status ?? '').toString()).filter((v) => v.length > 0))].sort(),
|
|
419
|
+
priority: [...new Set(list.map((r) => r.priority).filter((p) => typeof p === 'number' && Number.isFinite(p)))].sort((a, b) => a - b),
|
|
420
|
+
model: [...new Set(list.map(modelOf).filter((v) => v.length > 0))].sort(),
|
|
421
|
+
};
|
|
422
|
+
|
|
423
|
+
const f = filters || {};
|
|
424
|
+
const norm = (v) => (typeof v === 'string' && v.length > 0 ? v.trim().toLowerCase() : undefined);
|
|
425
|
+
const type = norm(f.type);
|
|
426
|
+
const status = norm(f.status);
|
|
427
|
+
const model = norm(f.model);
|
|
428
|
+
const q = norm(f.q);
|
|
429
|
+
const priority = f.priority !== undefined && f.priority !== null && f.priority !== ''
|
|
430
|
+
? Number(f.priority)
|
|
431
|
+
: undefined;
|
|
432
|
+
const hasPriorityFilter = priority !== undefined && Number.isFinite(priority);
|
|
433
|
+
|
|
434
|
+
const tasks = list.filter((r) => {
|
|
435
|
+
if (type && typeOf(r).toLowerCase() !== type) return false;
|
|
436
|
+
if (status && (r.status ?? '').toString().toLowerCase() !== status) return false;
|
|
437
|
+
if (hasPriorityFilter && r.priority !== priority) return false;
|
|
438
|
+
if (model && modelOf(r).toLowerCase() !== model) return false;
|
|
439
|
+
if (q) {
|
|
440
|
+
const haystack = (String(r.id) + ' ' + String(r.title ?? '')).toLowerCase();
|
|
441
|
+
if (!haystack.includes(q)) return false;
|
|
442
|
+
}
|
|
443
|
+
return true;
|
|
444
|
+
});
|
|
445
|
+
|
|
446
|
+
const sortField = norm(f.sort);
|
|
447
|
+
if (sortField === 'created_at') {
|
|
448
|
+
const dir = norm(f.dir) === 'asc' ? 'asc' : 'desc';
|
|
449
|
+
return { tasks: sortByCreatedAt(tasks, dir), total: list.length, filterOptions };
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
return { tasks, total: list.length, filterOptions };
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
/**
|
|
456
|
+
* Parse a `bd list --json` row's `created_at` into epoch millis, or `null`
|
|
457
|
+
* when the field is missing/unparseable. Never throws.
|
|
458
|
+
* @param {object} r
|
|
459
|
+
* @returns {number|null}
|
|
460
|
+
*/
|
|
461
|
+
function parseCreatedAt(r) {
|
|
462
|
+
const raw = r && r.created_at;
|
|
463
|
+
if (typeof raw !== 'string' || raw.length === 0) return null;
|
|
464
|
+
const ms = Date.parse(raw);
|
|
465
|
+
return Number.isFinite(ms) ? ms : null;
|
|
466
|
+
}
|
|
467
|
+
|
|
468
|
+
/**
|
|
469
|
+
* Stable sort of `tasks` by `created_at`, direction `'asc'|'desc'`. Rows with
|
|
470
|
+
* a missing/unparseable `created_at` always sort last regardless of
|
|
471
|
+
* direction, and this never throws on malformed input. Stable relative to
|
|
472
|
+
* incoming order for equal (or equally-invalid) timestamps -- achieved via a
|
|
473
|
+
* decorate-sort-undecorate over the original index, since `Array#sort` is not
|
|
474
|
+
* guaranteed stable across every engine this code may run on.
|
|
475
|
+
* @param {object[]} tasks
|
|
476
|
+
* @param {'asc'|'desc'} dir
|
|
477
|
+
* @returns {object[]}
|
|
478
|
+
*/
|
|
479
|
+
function sortByCreatedAt(tasks, dir) {
|
|
480
|
+
const decorated = tasks.map((r, i) => ({ r, i, ms: parseCreatedAt(r) }));
|
|
481
|
+
decorated.sort((a, b) => {
|
|
482
|
+
if (a.ms === null && b.ms === null) return a.i - b.i;
|
|
483
|
+
if (a.ms === null) return 1;
|
|
484
|
+
if (b.ms === null) return -1;
|
|
485
|
+
if (a.ms === b.ms) return a.i - b.i;
|
|
486
|
+
const cmp = a.ms - b.ms;
|
|
487
|
+
return dir === 'asc' ? cmp : -cmp;
|
|
488
|
+
});
|
|
489
|
+
return decorated.map((d) => d.r);
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
/**
|
|
493
|
+
* Injects an interactive select/search control into each of the 6 static
|
|
494
|
+
* `<th>` cells `renderBeadsHtml()` emits (ID/Title/Type/Status/Pri/Model), so
|
|
495
|
+
* the Backlog tab's filter controls live IN the column headers themselves
|
|
496
|
+
* instead of a separate filter bar above the table -- ID's header carries the
|
|
497
|
+
* free-text search (matches id OR title, same as `applyBeadFilters()`'s `q`),
|
|
498
|
+
* Title stays a plain label (search already covers title text), and Type/
|
|
499
|
+
* Status/Pri/Model become `<select>`s seeded from `filterOptions`'s REAL
|
|
500
|
+
* observed values. `currentFilters` re-selects/re-fills each control so a
|
|
501
|
+
* table re-render (collapse toggle, a fresh filtered fetch) never resets what
|
|
502
|
+
* the operator had chosen -- this function is called fresh on every
|
|
503
|
+
* `renderTable()` pass client-side, not just once at page load.
|
|
504
|
+
*
|
|
505
|
+
* A 7th header cell (apra-fleet-qoxd.2) carries the Created-at sort control:
|
|
506
|
+
* a single `<select data-sort-field="created_at">` offering a neutral
|
|
507
|
+
* 'Unsorted' option plus 'Created (newest)' (value `desc`) / 'Created
|
|
508
|
+
* (oldest)' (value `asc`), pre-selected from `currentFilters.sort`/
|
|
509
|
+
* `currentFilters.dir` so a client re-render preserves the chosen sort --
|
|
510
|
+
* same pattern the Type/Status/Pri/Model `<select>`s already follow. It is a
|
|
511
|
+
* distinct `data-sort-field` attribute (not `data-filter-field`) because this
|
|
512
|
+
* one control drives TWO `currentFilters` keys (`sort` and `dir`) at once;
|
|
513
|
+
* wiring lives in `backlogPanelClientScript()`'s `wireHeaderControls()`.
|
|
514
|
+
* @param {{ type: string[], status: string[], priority: number[], model: string[] }} filterOptions
|
|
515
|
+
* @param {{ type?: string, status?: string, priority?: string|number, model?: string, q?: string, sort?: string, dir?: string }} [currentFilters]
|
|
516
|
+
* @returns {string}
|
|
517
|
+
*/
|
|
518
|
+
function buildFilterHeaderRowHtml(filterOptions, currentFilters) {
|
|
519
|
+
const opts = filterOptions || { type: [], status: [], priority: [], model: [] };
|
|
520
|
+
const f = currentFilters || {};
|
|
521
|
+
const CTRL_STYLE = 'width: 100%; background: rgba(255,255,255,0.06); color: inherit; border: 1px solid var(--border, rgba(255,255,255,0.1)); border-radius: 4px; padding: 3px 6px; font-size: 12px;';
|
|
522
|
+
|
|
523
|
+
function selectHtml(field, allLabel, values, current, labelFn) {
|
|
524
|
+
const currentStr = current !== undefined && current !== null ? String(current) : '';
|
|
525
|
+
const optionsHtml = ['<option value="">' + escapeHtml(allLabel) + '</option>']
|
|
526
|
+
.concat((values || []).map((v) => {
|
|
527
|
+
const val = escapeHtml(String(v));
|
|
528
|
+
const label = escapeHtml(labelFn ? String(labelFn(v)) : String(v));
|
|
529
|
+
const selected = String(v) === currentStr ? ' selected' : '';
|
|
530
|
+
return '<option value="' + val + '"' + selected + '>' + label + '</option>';
|
|
531
|
+
}));
|
|
532
|
+
return '<select data-filter-field="' + field + '" style="' + CTRL_STYLE + '">' + optionsHtml.join('') + '</select>';
|
|
533
|
+
}
|
|
534
|
+
|
|
535
|
+
function sortSelectHtml(currentSort, currentDir) {
|
|
536
|
+
const isCreatedAtSort = currentSort === 'created_at';
|
|
537
|
+
const dir = isCreatedAtSort ? (currentDir === 'asc' ? 'asc' : 'desc') : '';
|
|
538
|
+
const optionsHtml = [
|
|
539
|
+
'<option value=""' + (dir === '' ? ' selected' : '') + '>Unsorted</option>',
|
|
540
|
+
'<option value="desc"' + (dir === 'desc' ? ' selected' : '') + '>Created (newest)</option>',
|
|
541
|
+
'<option value="asc"' + (dir === 'asc' ? ' selected' : '') + '>Created (oldest)</option>',
|
|
542
|
+
];
|
|
543
|
+
return '<select data-sort-field="created_at" style="' + CTRL_STYLE + '">' + optionsHtml.join('') + '</select>';
|
|
544
|
+
}
|
|
545
|
+
|
|
546
|
+
const qVal = escapeHtml(f.q || '');
|
|
547
|
+
return '<tr style="border-bottom: 1px solid rgba(255,255,255,0.1);">' +
|
|
548
|
+
'<th style="padding: 8px; width: 110px;">ID</th>' +
|
|
549
|
+
'<th style="padding: 8px;"><input type="text" data-filter-field="q" placeholder="Search ID or Title..." value="' + qVal + '" style="' + CTRL_STYLE + '"/></th>' +
|
|
550
|
+
'<th style="padding: 8px; width: 90px;">' + selectHtml('type', 'Type', opts.type, f.type) + '</th>' +
|
|
551
|
+
'<th style="padding: 8px; width: 100px;">' + selectHtml('status', 'Status', opts.status, f.status) + '</th>' +
|
|
552
|
+
'<th style="padding: 8px; width: 50px;">' + selectHtml('priority', 'Pri', opts.priority, f.priority, (p) => 'P' + p) + '</th>' +
|
|
553
|
+
'<th style="padding: 8px; width: 80px;">' + selectHtml('model', 'Model', opts.model, f.model) + '</th>' +
|
|
554
|
+
'<th style="padding: 8px; width: 130px;">' + sortSelectHtml(f.sort, f.dir) + '</th>' +
|
|
555
|
+
'</tr>';
|
|
556
|
+
}
|
|
557
|
+
|
|
558
|
+
/**
|
|
559
|
+
* Splices `headerRowHtml` in place of the static plain-label header row
|
|
560
|
+
* `renderBeadsHtml()` always emits (`<th>ID</th><th>Title</th>...`), WITHOUT
|
|
561
|
+
* modifying the shared function itself -- fleet-sprint's own live viewer
|
|
562
|
+
* calls `renderBeadsHtml()` too and must keep its plain, non-interactive
|
|
563
|
+
* header untouched. First-match-only string replace: the header row renders
|
|
564
|
+
* exactly once, at the top of the `<table>`.
|
|
565
|
+
* @param {string} tableHtml
|
|
566
|
+
* @param {string} headerRowHtml
|
|
567
|
+
* @returns {string}
|
|
568
|
+
*/
|
|
569
|
+
function injectFilterHeader(tableHtml, headerRowHtml) {
|
|
570
|
+
return tableHtml.replace(/<tr[^>]*>\s*(?:<th[^>]*>[\s\S]*?<\/th>\s*){6}<\/tr>/, headerRowHtml);
|
|
571
|
+
}
|
|
572
|
+
|
|
573
|
+
/**
|
|
574
|
+
* Injects a select-checkbox into every data row's leading ID cell (right
|
|
575
|
+
* after that cell's opening `<td>`, before the tree-toggle/id text) --
|
|
576
|
+
* again via string splice on `renderBeadsHtml()`'s OUTPUT, never by touching
|
|
577
|
+
* the shared renderer, so fleet-sprint's own viewer (which never calls this)
|
|
578
|
+
* is unaffected. `launch-form.mjs`'s client script drives selection off
|
|
579
|
+
* these checkboxes (see its 'change' listener), including cascading a
|
|
580
|
+
* parent's check state onto its visible children by walking sibling rows'
|
|
581
|
+
* indentation depth.
|
|
582
|
+
* @param {string} tableHtml
|
|
583
|
+
* @returns {string}
|
|
584
|
+
*/
|
|
585
|
+
function injectRowCheckboxes(tableHtml) {
|
|
586
|
+
return tableHtml.replace(/(<tr data-bead-id="([^"]*)"[^>]*>\s*<td[^>]*>)/g, function (match, trAndTd, id) {
|
|
587
|
+
return trAndTd + '<input type="checkbox" class="bead-select-checkbox" data-bead-id="' + id + '" style="margin-right:6px; vertical-align:middle;"/>';
|
|
588
|
+
});
|
|
589
|
+
}
|
|
590
|
+
|
|
591
|
+
/**
|
|
592
|
+
* The Backlog tab's client-side behavior: re-renders `#backlog-table` from
|
|
593
|
+
* `renderBeadsHtml()` on every collapse/expand toggle (mirrors
|
|
594
|
+
* fleet-sprint's beadsExtension client script, minus its live SSE-poll/detail-
|
|
595
|
+
* fetch machinery -- this page has no running workflow to poll and every
|
|
596
|
+
* bead's full `description` is already inlined server-side, so there is
|
|
597
|
+
* nothing to lazy-fetch), and re-fetches `GET /api/backlog/tasks` -- a real
|
|
598
|
+
* network round trip that narrows the row SET server-side (apra-fleet-7xk's
|
|
599
|
+
* "not just UI" requirement) -- whenever a filter control changes.
|
|
600
|
+
* @returns {string}
|
|
601
|
+
*/
|
|
602
|
+
function backlogPanelClientScript() {
|
|
603
|
+
return `
|
|
604
|
+
(function () {
|
|
605
|
+
var container = document.getElementById('backlog-table');
|
|
606
|
+
var indicator = document.getElementById('backlog-active-filters');
|
|
607
|
+
var totalCountEl = document.getElementById('backlog-total-count');
|
|
608
|
+
var clearBtn = document.getElementById('backlog-filter-clear');
|
|
609
|
+
if (!container) return;
|
|
610
|
+
|
|
611
|
+
// apra-fleet-eft.90: keep the persistent total-item count in sync with
|
|
612
|
+
// whatever lastTasks currently is -- called once up front (server-
|
|
613
|
+
// rendered value may already match, but this stays the single source of
|
|
614
|
+
// truth) and again every time lastTasks is reassigned below.
|
|
615
|
+
function updateTotalCount() {
|
|
616
|
+
if (totalCountEl) totalCountEl.textContent = lastTasks.length + ' bead(s)';
|
|
617
|
+
}
|
|
618
|
+
|
|
619
|
+
var collapsedBeadIds = new Set();
|
|
620
|
+
var lastTasks = window.__backlogTasks || [];
|
|
621
|
+
var filterOptions = window.__backlogFilterOptions || { type: [], status: [], priority: [], model: [] };
|
|
622
|
+
var currentFilters = {};
|
|
623
|
+
// apra-fleet-siqi.2.1: the server-embedded window.__backlogTasks above
|
|
624
|
+
// counts as this tab's initial "fetch" (a real bd query, just already
|
|
625
|
+
// resolved server-side rather than over the network) -- seeded to page-
|
|
626
|
+
// load time so a Backlog-tab activation immediately after opening the
|
|
627
|
+
// page does not force a redundant re-fetch; see applyFilters() and
|
|
628
|
+
// window.__fleetSeBacklog.refreshIfStale() below.
|
|
629
|
+
var lastBacklogFetchAt = Date.now();
|
|
630
|
+
|
|
631
|
+
${escapeHtml.toString()}
|
|
632
|
+
${renderBeadsHtml.toString()}
|
|
633
|
+
${injectRowCheckboxes.toString()}
|
|
634
|
+
${buildFilterHeaderRowHtml.toString()}
|
|
635
|
+
${injectFilterHeader.toString()}
|
|
636
|
+
|
|
637
|
+
function wireHeaderControls() {
|
|
638
|
+
container.querySelectorAll('[data-filter-field]').forEach(function (el) {
|
|
639
|
+
var field = el.getAttribute('data-filter-field');
|
|
640
|
+
var evt = el.tagName === 'SELECT' ? 'change' : 'change';
|
|
641
|
+
el.addEventListener(evt, function () {
|
|
642
|
+
currentFilters[field] = el.value;
|
|
643
|
+
applyFilters();
|
|
644
|
+
});
|
|
645
|
+
});
|
|
646
|
+
// apra-fleet-qoxd.2: the Created-at sort control drives TWO
|
|
647
|
+
// currentFilters keys (sort/dir) off one <select>'s single value, so
|
|
648
|
+
// it cannot use the generic data-filter-field wiring above (which
|
|
649
|
+
// only ever sets one key). An empty value ('Unsorted') clears both
|
|
650
|
+
// keys back out of currentFilters entirely, matching the neutral
|
|
651
|
+
// (no sort param sent) state applyBeadFilters() expects.
|
|
652
|
+
container.querySelectorAll('[data-sort-field]').forEach(function (el) {
|
|
653
|
+
el.addEventListener('change', function () {
|
|
654
|
+
if (el.value) {
|
|
655
|
+
currentFilters.sort = el.getAttribute('data-sort-field');
|
|
656
|
+
currentFilters.dir = el.value;
|
|
657
|
+
} else {
|
|
658
|
+
delete currentFilters.sort;
|
|
659
|
+
delete currentFilters.dir;
|
|
660
|
+
}
|
|
661
|
+
applyFilters();
|
|
662
|
+
});
|
|
663
|
+
});
|
|
664
|
+
}
|
|
665
|
+
|
|
666
|
+
function renderTable() {
|
|
667
|
+
var raw = renderBeadsHtml([], lastTasks, collapsedBeadIds);
|
|
668
|
+
var headerRow = buildFilterHeaderRowHtml(filterOptions, currentFilters);
|
|
669
|
+
container.innerHTML = injectRowCheckboxes(injectFilterHeader(raw, headerRow));
|
|
670
|
+
wireHeaderControls();
|
|
671
|
+
// Re-apply any launch-form checkbox selection (see launch-form.mjs)
|
|
672
|
+
// that a fresh innerHTML would otherwise wipe -- the two scripts
|
|
673
|
+
// cooperate via this one small window-scoped hook rather than
|
|
674
|
+
// sharing a closure.
|
|
675
|
+
if (window.__fleetSeLaunch && typeof window.__fleetSeLaunch.isSelected === 'function') {
|
|
676
|
+
container.querySelectorAll('input.bead-select-checkbox').forEach(function (cb) {
|
|
677
|
+
if (window.__fleetSeLaunch.isSelected(cb.getAttribute('data-bead-id'))) {
|
|
678
|
+
cb.checked = true;
|
|
679
|
+
var tr = cb.closest('tr');
|
|
680
|
+
if (tr) tr.classList.add('bead-row-selected');
|
|
681
|
+
}
|
|
682
|
+
});
|
|
683
|
+
}
|
|
684
|
+
}
|
|
685
|
+
|
|
686
|
+
container.addEventListener('click', function (e) {
|
|
687
|
+
var toggle = e.target && e.target.closest ? e.target.closest('.tree-toggle') : null;
|
|
688
|
+
if (!toggle) return;
|
|
689
|
+
var id = toggle.dataset.toggleId;
|
|
690
|
+
if (!id) return;
|
|
691
|
+
if (collapsedBeadIds.has(id)) collapsedBeadIds.delete(id);
|
|
692
|
+
else collapsedBeadIds.add(id);
|
|
693
|
+
renderTable();
|
|
694
|
+
});
|
|
695
|
+
|
|
696
|
+
function applyFilters() {
|
|
697
|
+
lastBacklogFetchAt = Date.now();
|
|
698
|
+
var params = new URLSearchParams();
|
|
699
|
+
Object.keys(currentFilters).forEach(function (k) {
|
|
700
|
+
var v = currentFilters[k];
|
|
701
|
+
if (v) params.set(k, v);
|
|
702
|
+
});
|
|
703
|
+
fetch('/api/backlog/tasks?' + params.toString())
|
|
704
|
+
.then(function (r) { return r.json(); })
|
|
705
|
+
.then(function (data) {
|
|
706
|
+
lastTasks = (data && Array.isArray(data.tasks)) ? data.tasks : [];
|
|
707
|
+
window.__backlogTasks = lastTasks;
|
|
708
|
+
if (data && data.filterOptions) filterOptions = data.filterOptions;
|
|
709
|
+
collapsedBeadIds.clear();
|
|
710
|
+
renderTable();
|
|
711
|
+
updateTotalCount();
|
|
712
|
+
var entries = Object.keys(currentFilters)
|
|
713
|
+
.filter(function (k) { return currentFilters[k]; })
|
|
714
|
+
.map(function (k) { return k + ': ' + currentFilters[k]; });
|
|
715
|
+
if (indicator) indicator.textContent = entries.length ? ('Filtering by ' + entries.join(', ') + ' -- ' + lastTasks.length + ' of ' + (data.total || lastTasks.length) + ' shown') : '';
|
|
716
|
+
})
|
|
717
|
+
.catch(function () { /* leave the last-known-good table in place */ });
|
|
718
|
+
}
|
|
719
|
+
|
|
720
|
+
if (clearBtn) {
|
|
721
|
+
clearBtn.addEventListener('click', function () {
|
|
722
|
+
currentFilters = {};
|
|
723
|
+
applyFilters();
|
|
724
|
+
});
|
|
725
|
+
}
|
|
726
|
+
|
|
727
|
+
// apra-fleet-siqi.2.1: the Backlog-tab-activation refresh hook
|
|
728
|
+
// (dashboard.mjs's DASHBOARD_TAB_SCRIPT switchTab()) reaches this SAME
|
|
729
|
+
// applyFilters()/GET /api/backlog/tasks plumbing through here -- with
|
|
730
|
+
// whatever currentFilters are already active -- never a separate
|
|
731
|
+
// one-off fetch, and only when the last fetch is stale.
|
|
732
|
+
window.__fleetSeBacklog = {
|
|
733
|
+
refreshIfStale: function (maxAgeMs) {
|
|
734
|
+
if (Date.now() - lastBacklogFetchAt >= maxAgeMs) applyFilters();
|
|
735
|
+
},
|
|
736
|
+
};
|
|
737
|
+
|
|
738
|
+
wireHeaderControls();
|
|
739
|
+
updateTotalCount();
|
|
740
|
+
})();
|
|
741
|
+
`;
|
|
742
|
+
}
|
|
743
|
+
|
|
744
|
+
/**
|
|
745
|
+
* Renders the Backlog tab's full content: the beads table itself, server-
|
|
746
|
+
* rendered via fleet-sprint's `renderBeadsHtml()` with an empty `sprintTasks`
|
|
747
|
+
* (the supervisor has no single sprint's containment tree to show here --
|
|
748
|
+
* only the cross-sprint free set), then two supervisor-only post-processing
|
|
749
|
+
* passes over that same markup: `injectFilterHeader()` swaps the plain ID/
|
|
750
|
+
* Title/Type/Status/Pri/Model header row for one carrying live filter
|
|
751
|
+
* controls (search folded into the ID column, Type/Status/Pri/Model as
|
|
752
|
+
* `<select>`s seeded from `filterOptions`'s real observed values -- apra-
|
|
753
|
+
* fleet-7xk), and `injectRowCheckboxes()` adds a select-checkbox to every row
|
|
754
|
+
* (driven by launch-form.mjs's selection/cascade logic). Neither pass touches
|
|
755
|
+
* the shared `renderBeadsHtml()` itself, so fleet-sprint's own live viewer
|
|
756
|
+
* (which also calls it) is unaffected.
|
|
757
|
+
* @param {object[]} tasks
|
|
758
|
+
* @param {{ type: string[], status: string[], priority: number[], model: string[] }} filterOptions
|
|
759
|
+
* @returns {string}
|
|
760
|
+
*/
|
|
761
|
+
export function renderBacklogPanelHtml(tasks, filterOptions) {
|
|
762
|
+
const opts = filterOptions || { type: [], status: [], priority: [], model: [] };
|
|
763
|
+
const rawTable = renderBeadsHtml([], tasks, new Set());
|
|
764
|
+
const headerRow = buildFilterHeaderRowHtml(opts, {});
|
|
765
|
+
const tableHtml = injectRowCheckboxes(injectFilterHeader(rawTable, headerRow));
|
|
766
|
+
const tasksJson = JSON.stringify(Array.isArray(tasks) ? tasks : []).replace(/</g, '\\u003c');
|
|
767
|
+
const filterOptionsJson = JSON.stringify(opts).replace(/</g, '\\u003c');
|
|
768
|
+
// apra-fleet-eft.90: a persistent total-item count, always visible at
|
|
769
|
+
// the top of the tab -- INDEPENDENT of #backlog-active-filters (which
|
|
770
|
+
// stays empty with no filter active, per that indicator's own
|
|
771
|
+
// long-standing contract). Server-rendered from `tasks` (the already-
|
|
772
|
+
// narrowed set this render actually shows, whether a filter is active or
|
|
773
|
+
// not) and kept in sync client-side by backlogPanelClientScript()'s
|
|
774
|
+
// renderTable()/applyFilters() whenever `lastTasks` changes -- so a
|
|
775
|
+
// filter change updates this number too, not just the '...shown' text
|
|
776
|
+
// inside #backlog-active-filters.
|
|
777
|
+
const totalTaskCount = Array.isArray(tasks) ? tasks.length : 0;
|
|
778
|
+
return (
|
|
779
|
+
'<div style="display:flex; justify-content:space-between; align-items:center; gap:8px; margin-bottom: 6px;">' +
|
|
780
|
+
'<span id="backlog-total-count" style="font-size: 12px; color: #a1a1aa;">' + totalTaskCount + ' bead(s)</span>' +
|
|
781
|
+
'<div style="display:flex; align-items:center; gap:8px;">' +
|
|
782
|
+
'<span id="backlog-active-filters" style="font-size: 12px; color: var(--accent, #3b82f6);"></span>' +
|
|
783
|
+
'<button type="button" id="backlog-filter-clear" class="btn btn-secondary" style="padding: 3px 10px; font-size: 12px;">Clear filters</button>' +
|
|
784
|
+
'</div>' +
|
|
785
|
+
'</div>' +
|
|
786
|
+
'<div id="backlog-table">' + tableHtml + '</div>' +
|
|
787
|
+
'<script>window.__backlogTasks = ' + tasksJson + '; window.__backlogFilterOptions = ' + filterOptionsJson + ';</script>' +
|
|
788
|
+
'<script>' + backlogPanelClientScript() + '</script>'
|
|
789
|
+
);
|
|
790
|
+
}
|
|
791
|
+
|
|
792
|
+
/**
|
|
793
|
+
* Registers `GET /api/backlog/tasks` -- the flat, filterable beads-tree data
|
|
794
|
+
* source for the Backlog tab's client-side filter re-fetch (see
|
|
795
|
+
* backlogPanelClientScript() above). Deliberately separate from the existing
|
|
796
|
+
* `GET /api/backlog` (api.mjs, the nested BacklogNode[] shape other callers
|
|
797
|
+
* may already depend on) -- this is an additive endpoint, not a replacement.
|
|
798
|
+
* @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
|
|
799
|
+
* @param {ReturnType<typeof createBacklog>} backlog
|
|
800
|
+
*/
|
|
801
|
+
export function registerBacklogRoutes(supervisor, backlog) {
|
|
802
|
+
supervisor.route('GET', '/api/backlog/tasks', async (req, res) => {
|
|
803
|
+
try {
|
|
804
|
+
const url = new URL(req.url, 'http://localhost');
|
|
805
|
+
const filters = {
|
|
806
|
+
type: url.searchParams.get('type') || undefined,
|
|
807
|
+
status: url.searchParams.get('status') || undefined,
|
|
808
|
+
priority: url.searchParams.get('priority') || undefined,
|
|
809
|
+
model: url.searchParams.get('model') || undefined,
|
|
810
|
+
q: url.searchParams.get('q') || undefined,
|
|
811
|
+
sort: url.searchParams.get('sort') || undefined,
|
|
812
|
+
dir: url.searchParams.get('dir') || undefined,
|
|
813
|
+
};
|
|
814
|
+
const result = await backlog.buildBacklogTasks(filters);
|
|
815
|
+
sendJson(res, 200, result);
|
|
816
|
+
} catch (err) {
|
|
817
|
+
sendJson(res, 500, { error: 'failed to build backlog tasks' });
|
|
818
|
+
}
|
|
819
|
+
});
|
|
820
|
+
}
|
|
821
|
+
|
|
822
|
+
/**
|
|
823
|
+
* Create the Backlog seam. Collaborators injected for unit testing without a
|
|
824
|
+
* real `bd` / live sprints.
|
|
825
|
+
*
|
|
826
|
+
* @param {{
|
|
827
|
+
* ledger: { list: () => Array<{ sprintId: string, issueRoots: string[] }> },
|
|
828
|
+
* listAllBeads?: () => Promise<Array<object>>|Array<object>,
|
|
829
|
+
* expandScope?: (roots: string[]) => Promise<Set<string>>|Set<string>,
|
|
830
|
+
* watchdog?: { classifySprint: (entry: object) => Promise<{ status: string }> },
|
|
831
|
+
* logger?: { log?: Function, error?: Function },
|
|
832
|
+
* }} deps
|
|
833
|
+
*
|
|
834
|
+
* `expandScope`, if supplied, fully overrides claimed-scope computation (used
|
|
835
|
+
* by tests to stub scope expansion deterministically without a real `bd` /
|
|
836
|
+
* beads fixture). When omitted (the production default -- apra-fleet-c4s),
|
|
837
|
+
* claimed scope is computed IN-MEMORY via `expandScopeInMemory()`, walking a
|
|
838
|
+
* `buildChildIndex()` built off the SAME `listAllBeads()` result `buildTree()`
|
|
839
|
+
* / `buildBacklogTasks()` already fetch in the same render pass -- zero extra
|
|
840
|
+
* `bd` subprocess calls, never the old per-node `expandScope()` (./scope-
|
|
841
|
+
* overlap.mjs) subprocess walker.
|
|
842
|
+
*/
|
|
843
|
+
export function createBacklog(deps = {}) {
|
|
844
|
+
const ledger = deps.ledger;
|
|
845
|
+
if (!ledger || typeof ledger.list !== 'function') {
|
|
846
|
+
throw new TypeError('createBacklog requires a ledger with a list() method');
|
|
847
|
+
}
|
|
848
|
+
const logger = deps.logger ?? console;
|
|
849
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
850
|
+
// Only used when a caller (test) explicitly overrides claimed-scope
|
|
851
|
+
// computation wholesale -- the production default path below never calls
|
|
852
|
+
// this (apra-fleet-c4s: no per-node `bd` subprocess walk on every render).
|
|
853
|
+
const explicitExpand = deps.expandScope ?? null;
|
|
854
|
+
// Raw rows by default -- buildTree() below normalizes whatever this
|
|
855
|
+
// returns itself (normalizeBead() is idempotent on already-normalized
|
|
856
|
+
// input), and buildBacklogTasks() needs the FULLER raw shape (priority,
|
|
857
|
+
// dependencies, metadata, description) that a normalized row drops. One
|
|
858
|
+
// `bd` call per render either way -- never two.
|
|
859
|
+
const listAllBeads = deps.listAllBeads ?? bdListAllBeadsRaw;
|
|
860
|
+
const watchdog = deps.watchdog ?? null;
|
|
861
|
+
|
|
862
|
+
/**
|
|
863
|
+
* The active (non-finished) reservations whose scopes are subtracted from
|
|
864
|
+
* the Backlog. When a watchdog is injected, sprints it classifies `finished`
|
|
865
|
+
* are dropped -- their beads belong back in the Backlog (their section is
|
|
866
|
+
* gone from the live stack too). A classifier error keeps the reservation
|
|
867
|
+
* (fail safe: do not surface an in-flight sprint's beads as free).
|
|
868
|
+
* @returns {Promise<Array<{ sprintId: string, issueRoots: string[] }>>}
|
|
869
|
+
*/
|
|
870
|
+
async function activeReservations() {
|
|
871
|
+
const entries = ledger.list();
|
|
872
|
+
if (!watchdog || typeof watchdog.classifySprint !== 'function') return entries;
|
|
873
|
+
const kept = [];
|
|
874
|
+
await Promise.all(entries.map(async (entry) => {
|
|
875
|
+
try {
|
|
876
|
+
const c = await watchdog.classifySprint(entry);
|
|
877
|
+
if (c.status !== WATCHDOG_STATUS.FINISHED) kept.push(entry);
|
|
878
|
+
} catch (err) {
|
|
879
|
+
logError(`[backlog] classifySprint failed for sprint '${entry.sprintId}':`, err);
|
|
880
|
+
kept.push(entry);
|
|
881
|
+
}
|
|
882
|
+
}));
|
|
883
|
+
return kept;
|
|
884
|
+
}
|
|
885
|
+
|
|
886
|
+
/**
|
|
887
|
+
* Build the claimed-id -> owning-sprint map by expanding every active
|
|
888
|
+
* sprint's roots to their live full subtree. First writer wins per id
|
|
889
|
+
* (exact-overlap policy guarantees no two active sprints share a bead
|
|
890
|
+
* anyway). A per-sprint expansion failure is isolated -- that one sprint
|
|
891
|
+
* contributes no claims rather than taking the whole Backlog down.
|
|
892
|
+
*
|
|
893
|
+
* Production default (no `deps.expandScope` override, apra-fleet-c4s):
|
|
894
|
+
* computed purely IN-MEMORY via `expandScopeInMemory()` off a
|
|
895
|
+
* `buildChildIndex()` built from `rawBeadsArg` if the caller already
|
|
896
|
+
* fetched it this render (buildTree()/buildBacklogTasks() below always
|
|
897
|
+
* do), or from one `listAllBeads()` call otherwise -- never a per-node
|
|
898
|
+
* `bd` subprocess walk.
|
|
899
|
+
* @param {Array<object>} [rawBeadsArg] - already-fetched `listAllBeads()`
|
|
900
|
+
* result, reused to avoid a second bulk fetch in the same render.
|
|
901
|
+
* @returns {Promise<Map<string, string>>}
|
|
902
|
+
*/
|
|
903
|
+
async function buildClaimedBy(rawBeadsArg) {
|
|
904
|
+
const claimedBy = new Map();
|
|
905
|
+
const reservations = await activeReservations();
|
|
906
|
+
if (reservations.length === 0) return claimedBy;
|
|
907
|
+
|
|
908
|
+
let childIndex = null;
|
|
909
|
+
if (!explicitExpand) {
|
|
910
|
+
const rawBeads = rawBeadsArg ?? await listAllBeads();
|
|
911
|
+
const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
|
|
912
|
+
childIndex = buildChildIndex(beads);
|
|
913
|
+
}
|
|
914
|
+
|
|
915
|
+
await Promise.all(reservations.map(async (r) => {
|
|
916
|
+
try {
|
|
917
|
+
const roots = r.issueRoots ?? [];
|
|
918
|
+
const scope = explicitExpand ? await explicitExpand(roots) : expandScopeInMemory(roots, childIndex);
|
|
919
|
+
for (const id of scope) {
|
|
920
|
+
if (!claimedBy.has(id)) claimedBy.set(id, r.sprintId);
|
|
921
|
+
}
|
|
922
|
+
} catch (err) {
|
|
923
|
+
logError(`[backlog] scope expansion failed for sprint '${r.sprintId}':`, err);
|
|
924
|
+
}
|
|
925
|
+
}));
|
|
926
|
+
return claimedBy;
|
|
927
|
+
}
|
|
928
|
+
|
|
929
|
+
/** Build the Backlog forest (full tracker minus live-claimed subtrees). */
|
|
930
|
+
async function buildTree() {
|
|
931
|
+
const rawBeads = await listAllBeads();
|
|
932
|
+
const claimedBy = await buildClaimedBy(rawBeads);
|
|
933
|
+
const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
|
|
934
|
+
return buildBacklogTree(beads, claimedBy);
|
|
935
|
+
}
|
|
936
|
+
|
|
937
|
+
/** Render the Backlog section HTML (never throws -- degrades to empty state). */
|
|
938
|
+
async function renderHtml() {
|
|
939
|
+
try {
|
|
940
|
+
return renderBacklogTreeHtml(await buildTree());
|
|
941
|
+
} catch (err) {
|
|
942
|
+
logError('[backlog] render failed:', err);
|
|
943
|
+
return renderBacklogTreeHtml([]);
|
|
944
|
+
}
|
|
945
|
+
}
|
|
946
|
+
|
|
947
|
+
/**
|
|
948
|
+
* The flat, unclaimed bead set -- fleet-sprint's `renderBeadsHtml()` shape
|
|
949
|
+
* (raw `bd list --json` rows, plus a `partialClaim` field this module adds
|
|
950
|
+
* so the epic-with-some-children-claimed case, eft.6.2's original point,
|
|
951
|
+
* still surfaces even though this view has no containment tree of its own
|
|
952
|
+
* to hang the annotation off). `filters` narrows the SET ITSELF (not just
|
|
953
|
+
* what gets rendered from an already-fetched set) -- see applyBeadFilters().
|
|
954
|
+
* @param {{ type?: string, status?: string, priority?: string|number, model?: string, q?: string }} [filters]
|
|
955
|
+
* @returns {Promise<{ tasks: object[], total: number, filterOptions: object }>}
|
|
956
|
+
*/
|
|
957
|
+
async function buildBacklogTasks(filters) {
|
|
958
|
+
const rawBeads = await listAllBeads();
|
|
959
|
+
const claimedBy = await buildClaimedBy(rawBeads);
|
|
960
|
+
const rows = (Array.isArray(rawBeads) ? rawBeads : [])
|
|
961
|
+
.filter((b) => b && typeof b.id === 'string' && b.id.length > 0);
|
|
962
|
+
const normalized = rows.map(normalizeBead);
|
|
963
|
+
const partialClaimById = computePartialClaimByBead(normalized, claimedBy);
|
|
964
|
+
// apra-fleet: stamp `parent` (the parent-child grouping edge,
|
|
965
|
+
// per parentIdOf's doc comment above) onto every row -- without it,
|
|
966
|
+
// renderBeadsHtml()'s Backlog branch has no containment info to nest
|
|
967
|
+
// by and every parent-child-only bead (no `blocks` edge) renders as
|
|
968
|
+
// a flat root sibling of its own epic, however deep its real nesting.
|
|
969
|
+
const free = rows
|
|
970
|
+
.filter((b) => !claimedBy.has(b.id))
|
|
971
|
+
.map((b) => ({ ...b, parent: parentIdOf(b), partialClaim: partialClaimById.get(b.id) ?? null }));
|
|
972
|
+
return applyBeadFilters(free, filters);
|
|
973
|
+
}
|
|
974
|
+
|
|
975
|
+
return {
|
|
976
|
+
name: 'backlog',
|
|
977
|
+
buildClaimedBy,
|
|
978
|
+
buildTree,
|
|
979
|
+
buildBacklogTasks,
|
|
980
|
+
renderHtml,
|
|
981
|
+
};
|
|
982
|
+
}
|