@apralabs/apra-fleet 0.3.6 → 0.4.1
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 +378 -252
- package/dist/agents/backlog-groomer.md +303 -0
- package/dist/agents/ci-watcher.md +13 -1
- package/dist/agents/deployer.md +66 -13
- package/dist/agents/doer.md +67 -8
- package/dist/agents/harvester.md +22 -3
- package/dist/agents/integ-test-runner.md +166 -60
- package/dist/agents/kb-reconciler.md +216 -0
- package/dist/agents/plan-reviewer.md +88 -18
- package/dist/agents/planner.md +182 -19
- package/dist/agents/regression-test-runner.md +234 -0
- package/dist/agents/reviewer.md +125 -9
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/doer-output.json +63 -3
- package/dist/agents/schemas/harvester-output.json +59 -2
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/kb-reconciler-output.json +87 -0
- package/dist/agents/schemas/planner-output.json +65 -0
- package/dist/agents/schemas/regression-test-runner-input.json +15 -0
- package/dist/agents/schemas/regression-test-runner-output.json +50 -0
- package/dist/agents/schemas/reviewer-output.json +108 -7
- package/dist/cli/agent-transform.d.ts +1 -0
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +77 -0
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts +3 -0
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +181 -5
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +5 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +7 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/dolt-install.d.ts +91 -0
- package/dist/cli/dolt-install.d.ts.map +1 -0
- package/dist/cli/dolt-install.js +334 -0
- package/dist/cli/dolt-install.js.map +1 -0
- package/dist/cli/install-guard.d.ts +29 -0
- package/dist/cli/install-guard.d.ts.map +1 -0
- package/dist/cli/install-guard.js +153 -0
- package/dist/cli/install-guard.js.map +1 -0
- package/dist/cli/install.d.ts +45 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +736 -109
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.d.ts +12 -0
- package/dist/cli/join.d.ts.map +1 -0
- package/dist/cli/join.js +87 -0
- package/dist/cli/join.js.map +1 -0
- package/dist/cli/kb-commit.d.ts +12 -0
- package/dist/cli/kb-commit.d.ts.map +1 -0
- package/dist/cli/kb-commit.js +53 -0
- package/dist/cli/kb-commit.js.map +1 -0
- package/dist/cli/kb-directives.d.ts +17 -0
- package/dist/cli/kb-directives.d.ts.map +1 -0
- package/dist/cli/kb-directives.js +146 -0
- package/dist/cli/kb-directives.js.map +1 -0
- package/dist/cli/kb-import.d.ts +13 -0
- package/dist/cli/kb-import.d.ts.map +1 -0
- package/dist/cli/kb-import.js +56 -0
- package/dist/cli/kb-import.js.map +1 -0
- package/dist/cli/register-member.d.ts +2 -0
- package/dist/cli/register-member.d.ts.map +1 -0
- package/dist/cli/register-member.js +193 -0
- package/dist/cli/register-member.js.map +1 -0
- package/dist/cli/restart.d.ts +2 -0
- package/dist/cli/restart.d.ts.map +1 -0
- package/dist/cli/restart.js +7 -0
- package/dist/cli/restart.js.map +1 -0
- package/dist/cli/spoke.d.ts +35 -0
- package/dist/cli/spoke.d.ts.map +1 -0
- package/dist/cli/spoke.js +212 -0
- package/dist/cli/spoke.js.map +1 -0
- package/dist/cli/start.d.ts +2 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/cli/start.js +92 -0
- package/dist/cli/start.js.map +1 -0
- package/dist/cli/status.d.ts +2 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +83 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/stop.d.ts +2 -0
- package/dist/cli/stop.d.ts.map +1 -0
- package/dist/cli/stop.js +51 -0
- package/dist/cli/stop.js.map +1 -0
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +120 -9
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/update.d.ts.map +1 -1
- package/dist/cli/update.js +10 -1
- package/dist/cli/update.js.map +1 -1
- package/dist/cli/watch.d.ts +53 -4
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +118 -17
- package/dist/cli/watch.js.map +1 -1
- package/dist/cli/workflow-assets.d.ts +37 -0
- package/dist/cli/workflow-assets.d.ts.map +1 -0
- package/dist/cli/workflow-assets.js +144 -0
- package/dist/cli/workflow-assets.js.map +1 -0
- package/dist/cli/workflow.d.ts +75 -0
- package/dist/cli/workflow.d.ts.map +1 -0
- package/dist/cli/workflow.js +397 -0
- package/dist/cli/workflow.js.map +1 -0
- package/dist/commands/kb-server.d.ts +8 -0
- package/dist/commands/kb-server.d.ts.map +1 -0
- package/dist/commands/kb-server.js +221 -0
- package/dist/commands/kb-server.js.map +1 -0
- package/dist/hub-service/activity.d.ts +30 -0
- package/dist/hub-service/activity.d.ts.map +1 -0
- package/dist/hub-service/activity.js +20 -0
- package/dist/hub-service/activity.js.map +1 -0
- package/dist/hub-service/audit-log.d.ts +19 -0
- package/dist/hub-service/audit-log.d.ts.map +1 -0
- package/dist/hub-service/audit-log.js +13 -0
- package/dist/hub-service/audit-log.js.map +1 -0
- package/dist/hub-service/db/pool.d.ts +19 -0
- package/dist/hub-service/db/pool.d.ts.map +1 -0
- package/dist/hub-service/db/pool.js +53 -0
- package/dist/hub-service/db/pool.js.map +1 -0
- package/dist/hub-service/enrollment.d.ts +29 -0
- package/dist/hub-service/enrollment.d.ts.map +1 -0
- package/dist/hub-service/enrollment.js +48 -0
- package/dist/hub-service/enrollment.js.map +1 -0
- package/dist/hub-service/envelope-routes.d.ts +46 -0
- package/dist/hub-service/envelope-routes.d.ts.map +1 -0
- package/dist/hub-service/envelope-routes.js +94 -0
- package/dist/hub-service/envelope-routes.js.map +1 -0
- package/dist/hub-service/handlers/installers.d.ts +14 -0
- package/dist/hub-service/handlers/installers.d.ts.map +1 -0
- package/dist/hub-service/handlers/installers.js +8 -0
- package/dist/hub-service/handlers/installers.js.map +1 -0
- package/dist/hub-service/http-server.d.ts +31 -0
- package/dist/hub-service/http-server.d.ts.map +1 -0
- package/dist/hub-service/http-server.js +711 -0
- package/dist/hub-service/http-server.js.map +1 -0
- package/dist/hub-service/hub-jwt.d.ts +30 -0
- package/dist/hub-service/hub-jwt.d.ts.map +1 -0
- package/dist/hub-service/hub-jwt.js +105 -0
- package/dist/hub-service/hub-jwt.js.map +1 -0
- package/dist/hub-service/jwt-revocation.d.ts +20 -0
- package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
- package/dist/hub-service/jwt-revocation.js +18 -0
- package/dist/hub-service/jwt-revocation.js.map +1 -0
- package/dist/hub-service/machines.d.ts +16 -0
- package/dist/hub-service/machines.d.ts.map +1 -0
- package/dist/hub-service/machines.js +14 -0
- package/dist/hub-service/machines.js.map +1 -0
- package/dist/hub-service/main.d.ts +3 -0
- package/dist/hub-service/main.d.ts.map +1 -0
- package/dist/hub-service/main.js +64 -0
- package/dist/hub-service/main.js.map +1 -0
- package/dist/hub-service/member-tokens.d.ts +11 -0
- package/dist/hub-service/member-tokens.d.ts.map +1 -0
- package/dist/hub-service/member-tokens.js +49 -0
- package/dist/hub-service/member-tokens.js.map +1 -0
- package/dist/hub-service/member-view.d.ts +20 -0
- package/dist/hub-service/member-view.d.ts.map +1 -0
- package/dist/hub-service/member-view.js +76 -0
- package/dist/hub-service/member-view.js.map +1 -0
- package/dist/hub-service/members.d.ts +44 -0
- package/dist/hub-service/members.d.ts.map +1 -0
- package/dist/hub-service/members.js +25 -0
- package/dist/hub-service/members.js.map +1 -0
- package/dist/hub-service/presence.d.ts +40 -0
- package/dist/hub-service/presence.d.ts.map +1 -0
- package/dist/hub-service/presence.js +44 -0
- package/dist/hub-service/presence.js.map +1 -0
- package/dist/hub-service/project-view.d.ts +12 -0
- package/dist/hub-service/project-view.d.ts.map +1 -0
- package/dist/hub-service/project-view.js +34 -0
- package/dist/hub-service/project-view.js.map +1 -0
- package/dist/hub-service/projects.d.ts +48 -0
- package/dist/hub-service/projects.d.ts.map +1 -0
- package/dist/hub-service/projects.js +80 -0
- package/dist/hub-service/projects.js.map +1 -0
- package/dist/hub-service/relay-queue.d.ts +115 -0
- package/dist/hub-service/relay-queue.d.ts.map +1 -0
- package/dist/hub-service/relay-queue.js +148 -0
- package/dist/hub-service/relay-queue.js.map +1 -0
- package/dist/hub-service/session-jwt.d.ts +10 -0
- package/dist/hub-service/session-jwt.d.ts.map +1 -0
- package/dist/hub-service/session-jwt.js +69 -0
- package/dist/hub-service/session-jwt.js.map +1 -0
- package/dist/hub-service/usage.d.ts +40 -0
- package/dist/hub-service/usage.d.ts.map +1 -0
- package/dist/hub-service/usage.js +25 -0
- package/dist/hub-service/usage.js.map +1 -0
- package/dist/hub-service/users.d.ts +56 -0
- package/dist/hub-service/users.d.ts.map +1 -0
- package/dist/hub-service/users.js +72 -0
- package/dist/hub-service/users.js.map +1 -0
- package/dist/hub-service/workspaces.d.ts +20 -0
- package/dist/hub-service/workspaces.d.ts.map +1 -0
- package/dist/hub-service/workspaces.js +10 -0
- package/dist/hub-service/workspaces.js.map +1 -0
- package/dist/index.js +254 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +14 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +80 -4
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +15 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +36 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +74 -18
- package/dist/os/windows.js.map +1 -1
- package/dist/paths.d.ts +23 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +29 -0
- package/dist/paths.js.map +1 -1
- package/dist/providers/agy.d.ts +20 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +259 -21
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +16 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +283 -16
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +13 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +36 -6
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +13 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +34 -7
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/email/headers.d.ts +15 -0
- package/dist/providers/email/headers.d.ts.map +1 -0
- package/dist/providers/email/headers.js +42 -0
- package/dist/providers/email/headers.js.map +1 -0
- package/dist/providers/email/index.d.ts +18 -0
- package/dist/providers/email/index.d.ts.map +1 -0
- package/dist/providers/email/index.js +60 -0
- package/dist/providers/email/index.js.map +1 -0
- package/dist/providers/email/provider.d.ts +49 -0
- package/dist/providers/email/provider.d.ts.map +1 -0
- package/dist/providers/email/provider.js +2 -0
- package/dist/providers/email/provider.js.map +1 -0
- package/dist/providers/email/sendgrid.d.ts +12 -0
- package/dist/providers/email/sendgrid.d.ts.map +1 -0
- package/dist/providers/email/sendgrid.js +67 -0
- package/dist/providers/email/sendgrid.js.map +1 -0
- package/dist/providers/email/smtp.d.ts +65 -0
- package/dist/providers/email/smtp.d.ts.map +1 -0
- package/dist/providers/email/smtp.js +373 -0
- package/dist/providers/email/smtp.js.map +1 -0
- package/dist/providers/gemini.d.ts +13 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +49 -5
- package/dist/providers/gemini.js.map +1 -1
- package/dist/providers/index.d.ts +1 -0
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +3 -0
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +61 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +124 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +14 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +104 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +156 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +54 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts +3 -3
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +11 -7
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/auth-socket.d.ts.map +1 -1
- package/dist/services/auth-socket.js +2 -0
- package/dist/services/auth-socket.js.map +1 -1
- package/dist/services/budget-awareness.d.ts +130 -0
- package/dist/services/budget-awareness.d.ts.map +1 -0
- package/dist/services/budget-awareness.js +129 -0
- package/dist/services/budget-awareness.js.map +1 -0
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +3 -0
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/cloud/task-wrapper.d.ts +18 -0
- package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
- package/dist/services/cloud/task-wrapper.js +157 -0
- package/dist/services/cloud/task-wrapper.js.map +1 -1
- package/dist/services/cloud-sync.d.ts +35 -0
- package/dist/services/cloud-sync.d.ts.map +1 -0
- package/dist/services/cloud-sync.js +90 -0
- package/dist/services/cloud-sync.js.map +1 -0
- package/dist/services/context-admission.d.ts +82 -0
- package/dist/services/context-admission.d.ts.map +1 -0
- package/dist/services/context-admission.js +136 -0
- package/dist/services/context-admission.js.map +1 -0
- package/dist/services/event-bus.d.ts +27 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +20 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/file-chunker.d.ts +38 -0
- package/dist/services/file-chunker.d.ts.map +1 -0
- package/dist/services/file-chunker.js +63 -0
- package/dist/services/file-chunker.js.map +1 -0
- package/dist/services/file-transfer-relay.d.ts +55 -0
- package/dist/services/file-transfer-relay.d.ts.map +1 -0
- package/dist/services/file-transfer-relay.js +115 -0
- package/dist/services/file-transfer-relay.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +12 -2
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +25 -0
- package/dist/services/http-transport.d.ts.map +1 -0
- package/dist/services/http-transport.js +371 -0
- package/dist/services/http-transport.js.map +1 -0
- package/dist/services/hub-client.d.ts +69 -0
- package/dist/services/hub-client.d.ts.map +1 -0
- package/dist/services/hub-client.js +217 -0
- package/dist/services/hub-client.js.map +1 -0
- package/dist/services/jwt.d.ts +17 -0
- package/dist/services/jwt.d.ts.map +1 -0
- package/dist/services/jwt.js +70 -0
- package/dist/services/jwt.js.map +1 -0
- package/dist/services/knowledge/audn.d.ts +37 -0
- package/dist/services/knowledge/audn.d.ts.map +1 -0
- package/dist/services/knowledge/audn.js +219 -0
- package/dist/services/knowledge/audn.js.map +1 -0
- package/dist/services/knowledge/file-hash.d.ts +11 -0
- package/dist/services/knowledge/file-hash.d.ts.map +1 -0
- package/dist/services/knowledge/file-hash.js +123 -0
- package/dist/services/knowledge/file-hash.js.map +1 -0
- package/dist/services/knowledge/http-provider.d.ts +46 -0
- package/dist/services/knowledge/http-provider.d.ts.map +1 -0
- package/dist/services/knowledge/http-provider.js +254 -0
- package/dist/services/knowledge/http-provider.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +15 -0
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
- package/dist/services/knowledge/kb-providers.js +92 -0
- package/dist/services/knowledge/kb-providers.js.map +1 -0
- package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
- package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
- package/dist/services/knowledge/kb-scope-input.js +11 -0
- package/dist/services/knowledge/kb-scope-input.js.map +1 -0
- package/dist/services/knowledge/kb-service.d.ts +3 -0
- package/dist/services/knowledge/kb-service.d.ts.map +1 -0
- package/dist/services/knowledge/kb-service.js +2 -0
- package/dist/services/knowledge/kb-service.js.map +1 -0
- package/dist/services/knowledge/path-validation.d.ts +2 -0
- package/dist/services/knowledge/path-validation.d.ts.map +1 -0
- package/dist/services/knowledge/path-validation.js +13 -0
- package/dist/services/knowledge/path-validation.js.map +1 -0
- package/dist/services/knowledge/pre-init.d.ts +14 -0
- package/dist/services/knowledge/pre-init.d.ts.map +1 -0
- package/dist/services/knowledge/pre-init.js +147 -0
- package/dist/services/knowledge/pre-init.js.map +1 -0
- package/dist/services/knowledge/project-slug.d.ts +2 -0
- package/dist/services/knowledge/project-slug.d.ts.map +1 -0
- package/dist/services/knowledge/project-slug.js +49 -0
- package/dist/services/knowledge/project-slug.js.map +1 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
- package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
- package/dist/services/knowledge/sqlite-provider.js +1646 -0
- package/dist/services/knowledge/sqlite-provider.js.map +1 -0
- package/dist/services/knowledge/types.d.ts +163 -0
- package/dist/services/knowledge/types.d.ts.map +1 -0
- package/dist/services/knowledge/types.js +9 -0
- package/dist/services/knowledge/types.js.map +1 -0
- package/dist/services/known-sessions.d.ts +8 -0
- package/dist/services/known-sessions.d.ts.map +1 -0
- package/dist/services/known-sessions.js +40 -0
- package/dist/services/known-sessions.js.map +1 -0
- package/dist/services/member-home.d.ts +89 -0
- package/dist/services/member-home.d.ts.map +1 -0
- package/dist/services/member-home.js +256 -0
- package/dist/services/member-home.js.map +1 -0
- package/dist/services/member-remote-url.d.ts +34 -0
- package/dist/services/member-remote-url.d.ts.map +1 -0
- package/dist/services/member-remote-url.js +39 -0
- package/dist/services/member-remote-url.js.map +1 -0
- package/dist/services/model-pricing.d.ts +36 -0
- package/dist/services/model-pricing.d.ts.map +1 -0
- package/dist/services/model-pricing.js +108 -0
- package/dist/services/model-pricing.js.map +1 -0
- package/dist/services/orphan-recovery.d.ts +59 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +122 -0
- package/dist/services/orphan-recovery.js.map +1 -0
- package/dist/services/pending-responses.d.ts +23 -0
- package/dist/services/pending-responses.d.ts.map +1 -0
- package/dist/services/pending-responses.js +52 -0
- package/dist/services/pending-responses.js.map +1 -0
- package/dist/services/preflight-check.d.ts +56 -0
- package/dist/services/preflight-check.d.ts.map +1 -0
- package/dist/services/preflight-check.js +277 -0
- package/dist/services/preflight-check.js.map +1 -0
- package/dist/services/registry.d.ts +4 -1
- package/dist/services/registry.d.ts.map +1 -1
- package/dist/services/registry.js +3 -0
- package/dist/services/registry.js.map +1 -1
- package/dist/services/relay-context.d.ts +23 -0
- package/dist/services/relay-context.d.ts.map +1 -0
- package/dist/services/relay-context.js +8 -0
- package/dist/services/relay-context.js.map +1 -0
- package/dist/services/relay-executor.d.ts +68 -0
- package/dist/services/relay-executor.d.ts.map +1 -0
- package/dist/services/relay-executor.js +70 -0
- package/dist/services/relay-executor.js.map +1 -0
- package/dist/services/relay-request.d.ts +65 -0
- package/dist/services/relay-request.d.ts.map +1 -0
- package/dist/services/relay-request.js +129 -0
- package/dist/services/relay-request.js.map +1 -0
- package/dist/services/relay-strategy.d.ts +19 -0
- package/dist/services/relay-strategy.d.ts.map +1 -0
- package/dist/services/relay-strategy.js +111 -0
- package/dist/services/relay-strategy.js.map +1 -0
- package/dist/services/service-manager/index.d.ts +5 -0
- package/dist/services/service-manager/index.d.ts.map +1 -0
- package/dist/services/service-manager/index.js +66 -0
- package/dist/services/service-manager/index.js.map +1 -0
- package/dist/services/service-manager/linux.d.ts +10 -0
- package/dist/services/service-manager/linux.d.ts.map +1 -0
- package/dist/services/service-manager/linux.js +97 -0
- package/dist/services/service-manager/linux.js.map +1 -0
- package/dist/services/service-manager/macos.d.ts +10 -0
- package/dist/services/service-manager/macos.d.ts.map +1 -0
- package/dist/services/service-manager/macos.js +94 -0
- package/dist/services/service-manager/macos.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +18 -0
- package/dist/services/service-manager/types.d.ts.map +1 -0
- package/dist/services/service-manager/types.js +5 -0
- package/dist/services/service-manager/types.js.map +1 -0
- package/dist/services/service-manager/windows.d.ts +10 -0
- package/dist/services/service-manager/windows.d.ts.map +1 -0
- package/dist/services/service-manager/windows.js +73 -0
- package/dist/services/service-manager/windows.js.map +1 -0
- package/dist/services/session-registry.d.ts +70 -0
- package/dist/services/session-registry.d.ts.map +1 -0
- package/dist/services/session-registry.js +91 -0
- package/dist/services/session-registry.js.map +1 -0
- package/dist/services/singleton.d.ts +15 -0
- package/dist/services/singleton.d.ts.map +1 -0
- package/dist/services/singleton.js +98 -0
- package/dist/services/singleton.js.map +1 -0
- package/dist/services/sprint-coordination.d.ts +168 -0
- package/dist/services/sprint-coordination.d.ts.map +1 -0
- package/dist/services/sprint-coordination.js +564 -0
- package/dist/services/sprint-coordination.js.map +1 -0
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +70 -3
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts +11 -8
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +17 -33
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +32 -0
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +187 -12
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +50 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +268 -18
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +57 -7
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.d.ts +20 -0
- package/dist/services/substitution-engine.d.ts.map +1 -0
- package/dist/services/substitution-engine.js +92 -0
- package/dist/services/substitution-engine.js.map +1 -0
- package/dist/services/task-cleanup.d.ts.map +1 -1
- package/dist/services/task-cleanup.js +1 -9
- package/dist/services/task-cleanup.js.map +1 -1
- package/dist/services/token-issuer.d.ts +47 -0
- package/dist/services/token-issuer.d.ts.map +1 -0
- package/dist/services/token-issuer.js +63 -0
- package/dist/services/token-issuer.js.map +1 -0
- package/dist/services/tool-registry.d.ts +3 -0
- package/dist/services/tool-registry.d.ts.map +1 -0
- package/dist/services/tool-registry.js +225 -0
- package/dist/services/tool-registry.js.map +1 -0
- package/dist/services/user-config.d.ts +14 -0
- package/dist/services/user-config.d.ts.map +1 -1
- package/dist/services/user-config.js +55 -0
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +32 -1
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/services/version-check.d.ts +22 -0
- package/dist/services/version-check.d.ts.map +1 -0
- package/dist/services/version-check.js +103 -0
- package/dist/services/version-check.js.map +1 -0
- package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/dist/skills/pm/beads.md +6 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/skills/pm/fleet-addendum.md +6 -0
- package/dist/skills/pm/index.md +56 -0
- package/dist/skills/pm/kb-reconcile.md +132 -0
- package/dist/skills/pm/kb-review.md +109 -0
- package/dist/tools/check-status.d.ts +47 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +250 -2
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +45 -0
- package/dist/tools/child-id-allocator.d.ts.map +1 -0
- package/dist/tools/child-id-allocator.js +62 -0
- package/dist/tools/child-id-allocator.js.map +1 -0
- package/dist/tools/cloud-control.d.ts +2 -2
- package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
- package/dist/tools/code-intelligence-codebase-memory.js +270 -0
- package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
- package/dist/tools/code-intelligence-freshness.d.ts +2 -0
- package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
- package/dist/tools/code-intelligence-freshness.js +26 -0
- package/dist/tools/code-intelligence-freshness.js.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.js +475 -0
- package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.js +65 -0
- package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
- package/dist/tools/code-intelligence-reindex.d.ts +7 -0
- package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
- package/dist/tools/code-intelligence-reindex.js +106 -0
- package/dist/tools/code-intelligence-reindex.js.map +1 -0
- package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
- package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
- package/dist/tools/code-intelligence-telemetry.js +52 -0
- package/dist/tools/code-intelligence-telemetry.js.map +1 -0
- package/dist/tools/code-intelligence-tests.d.ts +2 -0
- package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
- package/dist/tools/code-intelligence-tests.js +24 -0
- package/dist/tools/code-intelligence-tests.js.map +1 -0
- package/dist/tools/code-intelligence.d.ts +114 -0
- package/dist/tools/code-intelligence.d.ts.map +1 -0
- package/dist/tools/code-intelligence.js +124 -0
- package/dist/tools/code-intelligence.js.map +1 -0
- package/dist/tools/compose-permissions.d.ts +38 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +295 -33
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/dolt-push-mutex.d.ts +44 -0
- package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
- package/dist/tools/dolt-push-mutex.js +83 -0
- package/dist/tools/dolt-push-mutex.js.map +1 -0
- package/dist/tools/execute-command.d.ts +13 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +108 -21
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +84 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1191 -88
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/get-member-model-pricing.d.ts +21 -0
- package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
- package/dist/tools/get-member-model-pricing.js +29 -0
- package/dist/tools/get-member-model-pricing.js.map +1 -0
- package/dist/tools/kb-capture.d.ts +53 -0
- package/dist/tools/kb-capture.d.ts.map +1 -0
- package/dist/tools/kb-capture.js +130 -0
- package/dist/tools/kb-capture.js.map +1 -0
- package/dist/tools/kb-context.d.ts +17 -0
- package/dist/tools/kb-context.d.ts.map +1 -0
- package/dist/tools/kb-context.js +29 -0
- package/dist/tools/kb-context.js.map +1 -0
- package/dist/tools/kb-export.d.ts +19 -0
- package/dist/tools/kb-export.d.ts.map +1 -0
- package/dist/tools/kb-export.js +344 -0
- package/dist/tools/kb-export.js.map +1 -0
- package/dist/tools/kb-feedback.d.ts +23 -0
- package/dist/tools/kb-feedback.d.ts.map +1 -0
- package/dist/tools/kb-feedback.js +43 -0
- package/dist/tools/kb-feedback.js.map +1 -0
- package/dist/tools/kb-freshness-sweep.d.ts +14 -0
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
- package/dist/tools/kb-freshness-sweep.js +29 -0
- package/dist/tools/kb-freshness-sweep.js.map +1 -0
- package/dist/tools/kb-harvest.d.ts +20 -0
- package/dist/tools/kb-harvest.d.ts.map +1 -0
- package/dist/tools/kb-harvest.js +143 -0
- package/dist/tools/kb-harvest.js.map +1 -0
- package/dist/tools/kb-import.d.ts +44 -0
- package/dist/tools/kb-import.d.ts.map +1 -0
- package/dist/tools/kb-import.js +239 -0
- package/dist/tools/kb-import.js.map +1 -0
- package/dist/tools/kb-invalidate.d.ts +19 -0
- package/dist/tools/kb-invalidate.d.ts.map +1 -0
- package/dist/tools/kb-invalidate.js +34 -0
- package/dist/tools/kb-invalidate.js.map +1 -0
- package/dist/tools/kb-list.d.ts +32 -0
- package/dist/tools/kb-list.d.ts.map +1 -0
- package/dist/tools/kb-list.js +43 -0
- package/dist/tools/kb-list.js.map +1 -0
- package/dist/tools/kb-promote.d.ts +20 -0
- package/dist/tools/kb-promote.d.ts.map +1 -0
- package/dist/tools/kb-promote.js +20 -0
- package/dist/tools/kb-promote.js.map +1 -0
- package/dist/tools/kb-query.d.ts +35 -0
- package/dist/tools/kb-query.d.ts.map +1 -0
- package/dist/tools/kb-query.js +111 -0
- package/dist/tools/kb-query.js.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.js +26 -0
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
- package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
- package/dist/tools/kb-resolve-contradiction.js +37 -0
- package/dist/tools/kb-resolve-contradiction.js.map +1 -0
- package/dist/tools/kb-session-prime.d.ts +26 -0
- package/dist/tools/kb-session-prime.d.ts.map +1 -0
- package/dist/tools/kb-session-prime.js +392 -0
- package/dist/tools/kb-session-prime.js.map +1 -0
- package/dist/tools/kb-setup.d.ts +20 -0
- package/dist/tools/kb-setup.d.ts.map +1 -0
- package/dist/tools/kb-setup.js +49 -0
- package/dist/tools/kb-setup.js.map +1 -0
- package/dist/tools/kb-stats.d.ts +20 -0
- package/dist/tools/kb-stats.d.ts.map +1 -0
- package/dist/tools/kb-stats.js +115 -0
- package/dist/tools/kb-stats.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +39 -7
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +16 -2
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +29 -0
- package/dist/tools/member-reservation.d.ts.map +1 -0
- package/dist/tools/member-reservation.js +71 -0
- package/dist/tools/member-reservation.js.map +1 -0
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +21 -3
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +10 -3
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +7 -7
- package/dist/tools/provision-vcs-auth.js +1 -1
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +20 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +174 -6
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +17 -3
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/report-status.d.ts +33 -0
- package/dist/tools/report-status.d.ts.map +1 -0
- package/dist/tools/report-status.js +45 -0
- package/dist/tools/report-status.js.map +1 -0
- package/dist/tools/respond-to-message.d.ts +21 -0
- package/dist/tools/respond-to-message.d.ts.map +1 -0
- package/dist/tools/respond-to-message.js +23 -0
- package/dist/tools/respond-to-message.js.map +1 -0
- package/dist/tools/send-email.d.ts +69 -0
- package/dist/tools/send-email.d.ts.map +1 -0
- package/dist/tools/send-email.js +177 -0
- package/dist/tools/send-email.js.map +1 -0
- package/dist/tools/send-files.d.ts +3 -0
- package/dist/tools/send-files.d.ts.map +1 -1
- package/dist/tools/send-files.js +88 -8
- package/dist/tools/send-files.js.map +1 -1
- package/dist/tools/send-message.d.ts +27 -0
- package/dist/tools/send-message.d.ts.map +1 -0
- package/dist/tools/send-message.js +46 -0
- package/dist/tools/send-message.js.map +1 -0
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -0
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +11 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +36 -2
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +16 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +2 -1
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +7 -2
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/pid-helpers.d.ts +15 -0
- package/dist/utils/pid-helpers.d.ts.map +1 -1
- package/dist/utils/pid-helpers.js +23 -0
- package/dist/utils/pid-helpers.js.map +1 -1
- package/dist/utils/process-utils.d.ts +3 -0
- package/dist/utils/process-utils.d.ts.map +1 -0
- package/dist/utils/process-utils.js +42 -0
- package/dist/utils/process-utils.js.map +1 -0
- package/dist/utils/prompt-errors.d.ts +2 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +13 -3
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/session-caller.d.ts +28 -0
- package/dist/utils/session-caller.d.ts.map +1 -0
- package/dist/utils/session-caller.js +24 -0
- package/dist/utils/session-caller.js.map +1 -0
- package/dist/utils/work-folder-validation.d.ts +39 -0
- package/dist/utils/work-folder-validation.d.ts.map +1 -0
- package/dist/utils/work-folder-validation.js +60 -0
- package/dist/utils/work-folder-validation.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +24 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -0
- package/dist/utils/workspace-trust.js +35 -0
- package/dist/utils/workspace-trust.js.map +1 -0
- package/dist/workflows/auto-sprint.js +994 -91
- package/package.json +40 -9
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +510 -0
- package/packages/apra-fleet-client/src/client/client.mjs +146 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
- package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
- package/packages/apra-fleet-se/apra-pm/version.json +3 -0
- package/packages/apra-fleet-se/bin/cli.mjs +864 -0
- package/packages/apra-fleet-se/bin/serve.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
- package/packages/apra-fleet-se/package.json +29 -0
- package/packages/apra-fleet-se/workflow.json +1 -0
- package/packages/apra-fleet-workflow/package.json +30 -0
- package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
- package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
- package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
- package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
- package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
- package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
- package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
- package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
- package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
- package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
- package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
- package/scripts/agy-transcript-reader.js +1 -0
- package/scripts/fleet-statusline.sh +17 -13
- package/skills/fleet/SKILL.md +37 -2
- package/skills/fleet/beads.md +14 -7
- package/skills/fleet/knowledge-agent.md +66 -0
- package/skills/fleet/permissions.md +76 -2
- package/skills/fleet/profiles/base-dev.json +11 -1
- package/skills/fleet/profiles/base-reviewer.json +9 -1
- package/skills/fleet/profiles/node.json +2 -2
- package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
- package/version.json +1 -1
- package/scripts/agy-settings-merge.js +0 -27
- /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
|
@@ -0,0 +1,395 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// =============================================================================
|
|
3
|
+
// `fleet-se serve` -- always-on fleet-sprint supervisor entry point
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// Boots the supervisor HTTP API (see ../src/supervisor/server.mjs) and keeps
|
|
7
|
+
// the process alive INDEFINITELY. The process exits ONLY when:
|
|
8
|
+
// * a client POSTs /api/shutdown, or
|
|
9
|
+
// * the operator sends SIGINT / SIGTERM.
|
|
10
|
+
// It never exits because a sprint finished or a child crashed (process model B:
|
|
11
|
+
// sprints run as detached, IPC-less children of bin/cli.mjs, spawned later by
|
|
12
|
+
// the eft.4.2 spawner seam).
|
|
13
|
+
//
|
|
14
|
+
// Every module seam (ledger, spawner, watchdog, dashboard/backlog/launch-form,
|
|
15
|
+
// the eft.4.4 sprint/member/backlog API, the id allocator, and the dolt push
|
|
16
|
+
// mutex) is wired to its REAL implementation below -- none of them are the
|
|
17
|
+
// inert server.mjs stubs anymore (eft.4.8.1).
|
|
18
|
+
// =============================================================================
|
|
19
|
+
|
|
20
|
+
import { parseArgs } from 'node:util';
|
|
21
|
+
import { pathToFileURL } from 'node:url';
|
|
22
|
+
import { createSupervisor, DEFAULT_SERVICE_PORT, readJsonBody, sendJson } from '../src/supervisor/server.mjs';
|
|
23
|
+
import { createLedger } from '../src/supervisor/ledger.mjs';
|
|
24
|
+
import { createHistory, HISTORY_EVENTS } from '../src/supervisor/history.mjs';
|
|
25
|
+
import { createSpawner } from '../src/supervisor/spawner.mjs';
|
|
26
|
+
import { createReconciler, registerReservationRoutes, killPid } from '../src/supervisor/reconcile.mjs';
|
|
27
|
+
import { createReadopter } from '../src/supervisor/readopt.mjs';
|
|
28
|
+
import { createLiveProxy, registerLiveRoutes } from '../src/supervisor/proxy.mjs';
|
|
29
|
+
import { createHistoryView, registerHistoryViewRoutes } from '../src/supervisor/history-view.mjs';
|
|
30
|
+
import { createLogView, registerLogViewRoutes } from '../src/supervisor/log-view.mjs';
|
|
31
|
+
import { installSelfLogTee, createSelfLogView, registerSelfLogRoutes } from '../src/supervisor/self-log.mjs';
|
|
32
|
+
import { createIdAllocator, registerIdAllocatorRoutes } from '../src/supervisor/id-allocator.mjs';
|
|
33
|
+
import { createDoltMutex, registerDoltMutexRoutes } from '../src/supervisor/dolt-mutex.mjs';
|
|
34
|
+
// eft.4.8.1: the operator-facing surface -- PID-liveness watchdog (eft.4.3),
|
|
35
|
+
// dashboard/backlog/launch-form (eft.6.*), and the six sprint/member/backlog
|
|
36
|
+
// operator endpoints (eft.4.4). These were fully implemented and unit-tested
|
|
37
|
+
// but never imported/registered here -- this is that wiring.
|
|
38
|
+
import { createWatchdog } from '../src/supervisor/watchdog.mjs';
|
|
39
|
+
import { createBacklog, registerBacklogRoutes } from '../src/supervisor/backlog.mjs';
|
|
40
|
+
// launch-form.mjs (renderLaunchFormHtml/buildLaunchRequestBody) has no
|
|
41
|
+
// register*Routes()/create*() seam of its own -- dashboard.mjs's
|
|
42
|
+
// renderIndexPageHtml() already imports it directly and falls back to
|
|
43
|
+
// renderLaunchFormHtml() whenever no launchFormHtml override is supplied, so
|
|
44
|
+
// constructing the real dashboard below (instead of the inert stub) is what
|
|
45
|
+
// actually wires the Launch Sprint form onto the page.
|
|
46
|
+
import { createDashboard, registerDashboardRoutes } from '../src/supervisor/dashboard.mjs';
|
|
47
|
+
import { createSprintController, registerSprintRoutes, defaultMemberOverlapGuard, ApiError } from '../src/supervisor/api.mjs';
|
|
48
|
+
import { createScopeGuard, formatScopeConflict } from '../src/supervisor/scope-overlap.mjs';
|
|
49
|
+
import { listFleetMembers, executeFleetCommand } from '../src/supervisor/fleet-members.mjs';
|
|
50
|
+
import { createDoltOrphanSweep } from '../src/supervisor/dolt-orphan-sweep.mjs';
|
|
51
|
+
import { resolveFleetServerConnection } from './cli.mjs';
|
|
52
|
+
|
|
53
|
+
const SERVE_USAGE = `
|
|
54
|
+
Usage: fleet-se serve [options]
|
|
55
|
+
|
|
56
|
+
Starts the always-on fleet-sprint supervisor. Runs until POST /api/shutdown or a
|
|
57
|
+
termination signal (Ctrl-C / SIGTERM).
|
|
58
|
+
|
|
59
|
+
Options:
|
|
60
|
+
--port <port> HTTP service port for the supervisor API. Default: ${DEFAULT_SERVICE_PORT}.
|
|
61
|
+
-h, --help Show this help message.
|
|
62
|
+
`.trim();
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* apra-fleet-k06.1: compose BOTH launch-time overlap guards api.mjs's own
|
|
66
|
+
* header comment (eft.5.2/eft.5.3) already describes as meant to run
|
|
67
|
+
* together, as a standalone/exported factory so the composition itself --
|
|
68
|
+
* not just each guard in isolation -- is directly unit-testable without
|
|
69
|
+
* booting the real supervisor process (serveMain constructs its real
|
|
70
|
+
* defaultMemberOverlapGuard/createScopeGuard collaborators and passes them
|
|
71
|
+
* here; a test can inject fakes/stubs of the SAME shape instead).
|
|
72
|
+
*
|
|
73
|
+
* Member axis runs FIRST, preserving its exact pre-existing
|
|
74
|
+
* behavior/message/status (409, field 'members') for every case it already
|
|
75
|
+
* covered. The issue-scope axis runs second, over the SAME ledger; a
|
|
76
|
+
* conflict throws the same ApiError(409, ...) shape the member guard uses
|
|
77
|
+
* (field 'issue', a formatScopeConflict() message naming the conflicting
|
|
78
|
+
* sprint(s) and overlapping bead ids) rather than an unhandled 500 --
|
|
79
|
+
* registerSprintRoutes' onApiError only translates ApiError instances into a
|
|
80
|
+
* clean JSON error response. Either guard failing rejects the whole launch; a
|
|
81
|
+
* launch overlapping on neither axis still succeeds.
|
|
82
|
+
*
|
|
83
|
+
* @param {{
|
|
84
|
+
* memberOverlapGuard: (ctx: { members: string[], issueRoots: string[] }) => Promise<void>|void,
|
|
85
|
+
* scopeGuard: { checkLaunch: (issueRoots: string[]) => Promise<{ ok: boolean, conflicts: Array<{sprintId: string, overlappingIds: string[]}> }> },
|
|
86
|
+
* }} deps
|
|
87
|
+
* @returns {(ctx: { members: string[], issueRoots: string[] }) => Promise<void>}
|
|
88
|
+
*/
|
|
89
|
+
export function composeBeforeLaunch({ memberOverlapGuard, scopeGuard }) {
|
|
90
|
+
return async ({ members, issueRoots }) => {
|
|
91
|
+
await memberOverlapGuard({ members, issueRoots });
|
|
92
|
+
const scopeResult = await scopeGuard.checkLaunch(issueRoots);
|
|
93
|
+
if (!scopeResult.ok) {
|
|
94
|
+
throw new ApiError(409, formatScopeConflict(scopeResult.conflicts), 'issue');
|
|
95
|
+
}
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function parseServeArgs(argv) {
|
|
100
|
+
try {
|
|
101
|
+
return parseArgs({
|
|
102
|
+
args: argv,
|
|
103
|
+
options: {
|
|
104
|
+
port: { type: 'string' },
|
|
105
|
+
help: { type: 'boolean', short: 'h' },
|
|
106
|
+
},
|
|
107
|
+
strict: true,
|
|
108
|
+
allowPositionals: false,
|
|
109
|
+
});
|
|
110
|
+
} catch (err) {
|
|
111
|
+
throw new Error(`Invalid command-line arguments: ${err.message}\n\n${SERVE_USAGE}`);
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
export async function serveMain(argv = process.argv.slice(2)) {
|
|
116
|
+
const { values } = parseServeArgs(argv);
|
|
117
|
+
|
|
118
|
+
if (values.help) {
|
|
119
|
+
console.log(SERVE_USAGE);
|
|
120
|
+
return { exitCode: 0 };
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
// Installed before anything else logs: every console.log/warn/error from
|
|
124
|
+
// this point on (including the seam-construction comments' own
|
|
125
|
+
// console.error calls below) is timestamped (local time, not UTC) and
|
|
126
|
+
// teed to <dataDir>/logs/supervisor.log, in addition to still reaching
|
|
127
|
+
// the original console (an interactive run or a shell redirect is
|
|
128
|
+
// unaffected). This is the supervisor's own equivalent of spawner.mjs's
|
|
129
|
+
// per-sprint-child raw log; a dashboard link to GET /supervisor/log is
|
|
130
|
+
// registered further down, once `supervisor` exists.
|
|
131
|
+
const selfLog = installSelfLogTee();
|
|
132
|
+
process.once('exit', () => selfLog.stop());
|
|
133
|
+
|
|
134
|
+
let port = DEFAULT_SERVICE_PORT;
|
|
135
|
+
if (values.port !== undefined) {
|
|
136
|
+
port = Number(values.port);
|
|
137
|
+
if (!Number.isInteger(port) || port < 1 || port > 65535) {
|
|
138
|
+
console.error(`Error: --port must be a valid TCP port number, got "${values.port}".`);
|
|
139
|
+
return { exitCode: 1 };
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
// The durable reservation ledger (eft.5.1) and its terminal-event history
|
|
144
|
+
// (eft.5.4) are the restart-surviving source of truth. Wire them as real
|
|
145
|
+
// collaborators so a restarted supervisor reconciles against on-disk state.
|
|
146
|
+
const ledger = createLedger();
|
|
147
|
+
const history = createHistory();
|
|
148
|
+
// apra-fleet-f34.1: pass this supervisor's OWN listening address so every
|
|
149
|
+
// spawned sprint child's cli.mjs receives --service-url and threads it
|
|
150
|
+
// into runner.js's HTTP-backed dolt-mutex/id-allocator clients (see
|
|
151
|
+
// spawner.mjs's buildSprintArgv/createSpawner doc comments).
|
|
152
|
+
//
|
|
153
|
+
// apra-fleet-k7b.3: onChildExit is this SAME-INSTANCE spawner's own
|
|
154
|
+
// 'exit' listener notification (Node's own exit code/signal, keyed by
|
|
155
|
+
// the launch's runId -- the SAME sprintId createSprintController claims
|
|
156
|
+
// in the ledger BEFORE spawning, apra-fleet-k7b.1). Persist it two
|
|
157
|
+
// places: (1) history records a CHILD_EXITED audit event so the exit is
|
|
158
|
+
// still visible after the reservation is eventually released; (2)
|
|
159
|
+
// ledger.recordExit() annotates the still-held reservation in place (does
|
|
160
|
+
// not release it) so the watchdog/dashboard can report e.g. "exited 1 at
|
|
161
|
+
// ..." instead of a bare "pid gone". Both are independently best-effort --
|
|
162
|
+
// a missing/already-released reservation (e.g. a force-release raced the
|
|
163
|
+
// child's own exit) must never crash this listener.
|
|
164
|
+
//
|
|
165
|
+
// apra-fleet-xuo.6.1 -- ORDER IS LOAD-BEARING, history FIRST, ledger
|
|
166
|
+
// SECOND. Both ledger.mjs and history.mjs commit their in-memory view only
|
|
167
|
+
// after their atomic persist (tmp write + rename), and every observer (the
|
|
168
|
+
// dashboard/log-view, and the ou7.3/k7b.7 integration tests) polls the
|
|
169
|
+
// LEDGER's exitCode as the "this child has exited" readiness signal and
|
|
170
|
+
// then immediately reads history. Recording the ledger first opened a
|
|
171
|
+
// window one whole history-persist wide in which the ledger already showed
|
|
172
|
+
// an exitCode while history still had zero CHILD_EXITED events for that
|
|
173
|
+
// sprint -- the ledger/history mismatch of apra-fleet-xuo.6. Writing
|
|
174
|
+
// history first makes "the ledger shows an exitCode" imply "history
|
|
175
|
+
// already carries CHILD_EXITED" for every reader. Do not swap these back.
|
|
176
|
+
//
|
|
177
|
+
// apra-fleet-ou7.1: onChildExit also carries logPath (spawner.mjs's own
|
|
178
|
+
// per-sprint raw stdout/stderr log file) through into the CHILD_EXITED
|
|
179
|
+
// history event -- the ledger already has it (recorded at claim() time,
|
|
180
|
+
// see createSprintController's launch()), but history's own copy stays
|
|
181
|
+
// discoverable even after the reservation is eventually released.
|
|
182
|
+
const spawner = createSpawner({
|
|
183
|
+
serviceUrl: `http://localhost:${port}`,
|
|
184
|
+
onChildExit: async ({ runId, exitCode, signal, at, logPath }) => {
|
|
185
|
+
if (!runId) return;
|
|
186
|
+
try {
|
|
187
|
+
await history.record({ sprintId: runId, event: HISTORY_EVENTS.CHILD_EXITED, exitCode, signal, at, logPath });
|
|
188
|
+
} catch (err) {
|
|
189
|
+
console.error(`[spawner] history.record(CHILD_EXITED) failed for '${runId}':`, err);
|
|
190
|
+
}
|
|
191
|
+
try {
|
|
192
|
+
await ledger.recordExit(runId, { exitCode, signal, at });
|
|
193
|
+
} catch (err) {
|
|
194
|
+
console.error(`[spawner] ledger.recordExit failed for '${runId}':`, err);
|
|
195
|
+
}
|
|
196
|
+
},
|
|
197
|
+
});
|
|
198
|
+
// apra-fleet-3i3.1: the real kill-signal implementation is only wired in
|
|
199
|
+
// HERE -- createReconciler()'s own default is a safe no-op (see
|
|
200
|
+
// reconcile.mjs's module doc) so nothing outside this production entry
|
|
201
|
+
// point can accidentally send a real signal to an arbitrary pid.
|
|
202
|
+
const reconciler = createReconciler({ ledger, history, killPid });
|
|
203
|
+
// eft.4.5: re-adopts still-live children by PID at startup (see below),
|
|
204
|
+
// registering their recovered --viewer-port with the spawner seam so
|
|
205
|
+
// they are tracked/watchdog-monitored/HTTP-proxyable exactly like a
|
|
206
|
+
// freshly-spawned child.
|
|
207
|
+
const readopter = createReadopter({ ledger, spawner, reconciler });
|
|
208
|
+
|
|
209
|
+
// eft.9.3: the supervisor-owned global child-id allocator. Its start()/stop()
|
|
210
|
+
// (load persisted high-water marks + the abandoned-reservation sweep) is
|
|
211
|
+
// driven by the seam machinery; its HTTP routes let detached sprint children
|
|
212
|
+
// mint collision-free child ids under a shared parent (constraint C.4).
|
|
213
|
+
const idAllocator = createIdAllocator();
|
|
214
|
+
|
|
215
|
+
// eft.9.2: the supervisor-owned global dolt push mutex -- a LOAD-BEARING v1
|
|
216
|
+
// requirement (PoC constraints C.2/C.3). Every cross-sprint `bd dolt push`
|
|
217
|
+
// serializes through this ONE instance so two sprints never push at the same
|
|
218
|
+
// time; its lease-sweep start()/stop() is driven by the seam machinery, and
|
|
219
|
+
// its HTTP routes let independent detached sprint children acquire/release
|
|
220
|
+
// over the supervisor port. Without this wiring a child's acquire() would
|
|
221
|
+
// POST to an unregistered route (404) and wedge the D-push bracket.
|
|
222
|
+
const doltMutex = createDoltMutex();
|
|
223
|
+
|
|
224
|
+
// eft.4.3: PID-liveness watchdog + four-status classifier. Its
|
|
225
|
+
// resolvePort collaborator maps a sprintId -> the live --viewer-port the
|
|
226
|
+
// spawner allocated for that sprint's still-tracked child pid (undefined
|
|
227
|
+
// once the pid bookkeeping is gone -- classifySprint() already treats an
|
|
228
|
+
// unresolvable port as "cannot verify via HTTP", never as a false
|
|
229
|
+
// "crashed"). This is the one small wiring helper this task needed: every
|
|
230
|
+
// other seam below is a direct construct-and-register of an
|
|
231
|
+
// already-implemented module.
|
|
232
|
+
const resolveSprintPort = (sprintId) => {
|
|
233
|
+
const entry = ledger.get(sprintId);
|
|
234
|
+
if (!entry || entry.childPid == null) return undefined;
|
|
235
|
+
return spawner.getLiveEntry ? spawner.getLiveEntry(entry.childPid)?.port : undefined;
|
|
236
|
+
};
|
|
237
|
+
// apra-fleet-k7b.2: `history` lets the watchdog append a durable
|
|
238
|
+
// FINISHED event (terminalReason/verdict) to sprint-history.json the
|
|
239
|
+
// first time it observes a PID-gone sprint's persisted terminal state,
|
|
240
|
+
// the same collaborator the spawner's CHILD_EXITED wiring above uses.
|
|
241
|
+
const watchdog = createWatchdog({ ledger, resolvePort: resolveSprintPort, history });
|
|
242
|
+
|
|
243
|
+
// eft.6.2: the Backlog-last tree (full tracker minus every active
|
|
244
|
+
// sprint's live-expanded scope). Reused both as the dashboard page's
|
|
245
|
+
// Backlog section (below) AND as GET /api/backlog's real listing (see the
|
|
246
|
+
// sprint controller wiring below), so there is exactly one "what does the
|
|
247
|
+
// tracker minus claimed scope look like right now" implementation.
|
|
248
|
+
const backlog = createBacklog({ ledger, watchdog });
|
|
249
|
+
|
|
250
|
+
// eft.6.1/6.3: the single-page operator dashboard -- Sprint Stack, then
|
|
251
|
+
// Backlog, then the Launch Sprint form (launch-form.mjs attaches itself
|
|
252
|
+
// via dashboard.mjs's renderIndexPageHtml default; see the import comment
|
|
253
|
+
// above for why no separate launch-form seam is constructed here).
|
|
254
|
+
const dashboard = createDashboard({ ledger, watchdog, backlog });
|
|
255
|
+
|
|
256
|
+
// docs/dolt-sync-redesign.md Part 3.3: kill any orphaned ephemeral
|
|
257
|
+
// `dolt sql-server` a mid-settle orchestrator death left behind on a
|
|
258
|
+
// member (settle's own finally covers every other path). Both
|
|
259
|
+
// collaborators use the same short-lived-MCP-connection pattern as
|
|
260
|
+
// listFleetMembers -- the supervisor never holds a standing fleet
|
|
261
|
+
// transport.
|
|
262
|
+
const doltOrphanSweep = createDoltOrphanSweep({
|
|
263
|
+
listMembers: () => listFleetMembers({ resolveConnection: resolveFleetServerConnection }),
|
|
264
|
+
execCommand: ({ member, command }) => executeFleetCommand({ member, command, resolveConnection: resolveFleetServerConnection }),
|
|
265
|
+
});
|
|
266
|
+
|
|
267
|
+
const supervisor = createSupervisor({ port, ledger, spawner, watchdog, dashboard, idAllocator, doltMutex, doltOrphanSweep });
|
|
268
|
+
registerIdAllocatorRoutes(supervisor, idAllocator, { readJsonBody, sendJson });
|
|
269
|
+
registerDoltMutexRoutes(supervisor, doltMutex, { readJsonBody, sendJson });
|
|
270
|
+
|
|
271
|
+
// eft.6.1: GET / -- the Sprint Stack + Backlog + Launch Sprint page.
|
|
272
|
+
registerDashboardRoutes(supervisor, dashboard);
|
|
273
|
+
|
|
274
|
+
// supervisor-viewer-parity: GET /api/backlog/tasks -- the flat,
|
|
275
|
+
// filterable data source the dashboard's Backlog tab re-fetches from
|
|
276
|
+
// client-side on every filter change (see backlog.mjs's
|
|
277
|
+
// backlogPanelClientScript()). Additive to GET /api/backlog below (the
|
|
278
|
+
// sprint controller's older nested-tree shape), not a replacement.
|
|
279
|
+
registerBacklogRoutes(supervisor, backlog);
|
|
280
|
+
|
|
281
|
+
// eft.4.4: the six operator-facing sprint/member/backlog endpoints.
|
|
282
|
+
// listMembers is fleet-backed (fleet-members.mjs opens a short-lived MCP
|
|
283
|
+
// connection per call -- see its module doc for why the supervisor never
|
|
284
|
+
// holds a standing fleet connection); getBacklog reuses the SAME backlog
|
|
285
|
+
// seam constructed above rather than re-deriving "tracker minus claimed
|
|
286
|
+
// scope" a second way. ledger/spawner/history are the same collaborators
|
|
287
|
+
// every other seam in this file shares.
|
|
288
|
+
const listMembersForLaunch = () => listFleetMembers({ resolveConnection: resolveFleetServerConnection });
|
|
289
|
+
|
|
290
|
+
// apra-fleet-k06.1: compose BOTH launch-time overlap guards api.mjs's own
|
|
291
|
+
// header comment (eft.5.2/eft.5.3) already describes as meant to run
|
|
292
|
+
// together. Before this, createSprintController() below was constructed
|
|
293
|
+
// with no `beforeLaunch` override, so it silently fell back to
|
|
294
|
+
// defaultMemberOverlapGuard ALONE -- the issue-scope guard
|
|
295
|
+
// (createScopeGuard, live-expanded subtree overlap) was exercised only by
|
|
296
|
+
// its own unit tests, never wired into the real POST /api/sprints path.
|
|
297
|
+
// Two sprints with disjoint member sets but overlapping/nested issue
|
|
298
|
+
// scopes (e.g. one targets an epic, another one of that epic's children)
|
|
299
|
+
// could both launch and dispatch against the same beads concurrently.
|
|
300
|
+
// See composeBeforeLaunch() above for the composition itself (ordering,
|
|
301
|
+
// error shape) -- extracted as its own export so the composition is
|
|
302
|
+
// directly unit-testable without booting this whole process.
|
|
303
|
+
const memberOverlapGuard = defaultMemberOverlapGuard(ledger, listMembersForLaunch);
|
|
304
|
+
const scopeGuard = createScopeGuard({ ledger });
|
|
305
|
+
const beforeLaunch = composeBeforeLaunch({ memberOverlapGuard, scopeGuard });
|
|
306
|
+
|
|
307
|
+
const sprintController = createSprintController({
|
|
308
|
+
ledger,
|
|
309
|
+
spawner,
|
|
310
|
+
history,
|
|
311
|
+
listMembers: listMembersForLaunch,
|
|
312
|
+
getBacklog: async () => ({ tree: await backlog.buildTree() }),
|
|
313
|
+
beforeLaunch,
|
|
314
|
+
});
|
|
315
|
+
registerSprintRoutes(supervisor, sprintController);
|
|
316
|
+
|
|
317
|
+
// eft.5.4: operator force-release of a wedged reservation.
|
|
318
|
+
registerReservationRoutes(supervisor, reconciler);
|
|
319
|
+
|
|
320
|
+
// eft.6.5: process-free History view. Always renders a finished sprint's
|
|
321
|
+
// persisted old_runs/<sprintId>.json (falling back to the legacy
|
|
322
|
+
// old_sprints/<sprintId>.json, apra-fleet-eft.37.1) through the SAME HTML
|
|
323
|
+
// template the live viewer serves, fed a frozen state object -- no live process, no
|
|
324
|
+
// /state or /events polling, Save/Stop hidden. Constructed before the live
|
|
325
|
+
// proxy below so its renderForSprint() can be wired in as that proxy's
|
|
326
|
+
// history-fallthrough renderer too (see next block).
|
|
327
|
+
const historyView = createHistoryView();
|
|
328
|
+
|
|
329
|
+
// eft.6.4: live-detail reverse proxy at /sprints/:id/live. Resolves each
|
|
330
|
+
// sprint's child --viewer-port from the ledger's childPid + the spawner's
|
|
331
|
+
// live pid->port bookkeeping, proxies HTTP + SSE through the supervisor
|
|
332
|
+
// port, and falls through to the historical view (eft.6.5's full
|
|
333
|
+
// template-based renderer, not just a minimal placeholder) once a sprint
|
|
334
|
+
// finishes -- so the SAME template serves live and history at the SAME
|
|
335
|
+
// URL. A dedicated /sprints/:id/history link (registered below) reaches
|
|
336
|
+
// the identical rendering regardless of whether the sprint is still live.
|
|
337
|
+
const liveProxy = createLiveProxy({ ledger, spawner, renderHistory: (sprintId) => historyView.renderForSprint(sprintId) });
|
|
338
|
+
registerLiveRoutes(supervisor, liveProxy);
|
|
339
|
+
registerHistoryViewRoutes(supervisor, historyView);
|
|
340
|
+
|
|
341
|
+
// apra-fleet-ou7.2: raw per-sprint stdout/stderr log, present for a live
|
|
342
|
+
// sprint AND for an ended one (finished/crashed) -- exactly where the
|
|
343
|
+
// live SSE viewer above is gone. Looks the sprint's recorded logPath up
|
|
344
|
+
// by id (ledger first, then history for a released reservation); never
|
|
345
|
+
// builds a path from the request's :id itself.
|
|
346
|
+
const logView = createLogView({ ledger, history });
|
|
347
|
+
registerLogViewRoutes(supervisor, logView);
|
|
348
|
+
|
|
349
|
+
// GET /supervisor/log -- the supervisor's OWN stdout/stderr (see
|
|
350
|
+
// installSelfLogTee() above), linked from the dashboard header.
|
|
351
|
+
const selfLogView = createSelfLogView({ logPath: selfLog.logPath });
|
|
352
|
+
registerSelfLogRoutes(supervisor, selfLogView);
|
|
353
|
+
|
|
354
|
+
// Explicit signals are the out-of-band way to stop cleanly, complementing
|
|
355
|
+
// the in-band POST /api/shutdown route.
|
|
356
|
+
const onSignal = (sig) => {
|
|
357
|
+
console.log(`[supervisor] received ${sig}`);
|
|
358
|
+
supervisor.stop(`signal:${sig}`).catch((err) => console.error(err));
|
|
359
|
+
};
|
|
360
|
+
process.once('SIGINT', () => onSignal('SIGINT'));
|
|
361
|
+
process.once('SIGTERM', () => onSignal('SIGTERM'));
|
|
362
|
+
|
|
363
|
+
await supervisor.start();
|
|
364
|
+
|
|
365
|
+
// Restart reconciliation (eft.5.4) + re-adoption (eft.4.5): the ledger
|
|
366
|
+
// seam has now loaded from disk. Start the history log, then PID-probe
|
|
367
|
+
// every reloaded entry -- dead children release both axes and are marked
|
|
368
|
+
// aborted-by-restart; live children are retained AND re-adopted (their
|
|
369
|
+
// --viewer-port recovered from the live process's own command line and
|
|
370
|
+
// registered with the spawner seam) so they resume being tracked,
|
|
371
|
+
// watchdog-monitored, and HTTP-reachable exactly like a freshly-spawned
|
|
372
|
+
// child.
|
|
373
|
+
await history.start();
|
|
374
|
+
await readopter.readopt();
|
|
375
|
+
|
|
376
|
+
// Keep the process alive until an explicit shutdown resolves. Awaiting this
|
|
377
|
+
// is what makes `fleet-se serve` "always-on" -- nothing else drives exit.
|
|
378
|
+
await supervisor.shutdownRequested;
|
|
379
|
+
return { exitCode: 0 };
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
function isMainModule() {
|
|
383
|
+
try {
|
|
384
|
+
return process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
|
|
385
|
+
} catch {
|
|
386
|
+
return false;
|
|
387
|
+
}
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
if (isMainModule()) {
|
|
391
|
+
serveMain().then(
|
|
392
|
+
({ exitCode }) => process.exit(exitCode),
|
|
393
|
+
(err) => { console.error(err); process.exit(1); },
|
|
394
|
+
);
|
|
395
|
+
}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
// apra-fleet-eft.8.12 (Plan 3.4 git conflict ladder, script-first posture).
|
|
2
|
+
//
|
|
3
|
+
// Tier 0 prevention (exclusive per-sprint branch ownership + rebase-before-
|
|
4
|
+
// push + globally sequential doer streaks, apra-fleet-eft.8.3/8.4) already
|
|
5
|
+
// keeps real content conflicts rare. This module is what runs on the rare
|
|
6
|
+
// occasions Tier 0 does not prevent one:
|
|
7
|
+
//
|
|
8
|
+
// Tier 1 (SCRIPTED, apra-fleet-eft.8.6): confirm from git's OWN
|
|
9
|
+
// `git status --porcelain` output (never inferred from a failing
|
|
10
|
+
// command's exit code/message alone) whether a failed `git pull --rebase`
|
|
11
|
+
// actually left unmerged paths, and if so restore a clean working tree via
|
|
12
|
+
// `git rebase --abort`. Script-only -- no agent is ever dispatched here.
|
|
13
|
+
//
|
|
14
|
+
// Tier 2 (agent-with-runbook, apra-fleet-eft.8.12): a git merge/rebase
|
|
15
|
+
// conflict is BY CONSTRUCTION a same-line (or same-hunk) overlap -- git's
|
|
16
|
+
// own three-way merge already auto-resolves every non-overlapping change
|
|
17
|
+
// silently; conflict markers only ever appear for the overlapping
|
|
18
|
+
// remainder a fixed, mechanical ours/theirs policy cannot arbitrate
|
|
19
|
+
// (blindly preferring one side always risks silently discarding the
|
|
20
|
+
// other's real work). So Tier 1 finding `unmergedPaths.length > 0` IS the
|
|
21
|
+
// single, documented Tier 1 -> Tier 2 escalation point: dispatch an
|
|
22
|
+
// agent, armed with an explicit runbook describing exactly which files are
|
|
23
|
+
// conflicted, to re-attempt the rebase and resolve those files with actual
|
|
24
|
+
// judgment. The agent's own claim is never trusted -- see
|
|
25
|
+
// runner.js's syncMemberAfter Tier 2 call site for the mechanical
|
|
26
|
+
// re-verification (clean porcelain + a real successful re-push) that
|
|
27
|
+
// decides whether Tier 2 actually succeeded.
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Two-letter `git status --porcelain` XY codes git reserves EXCLUSIVELY for
|
|
31
|
+
* an unresolved merge/rebase conflict (see `git status` docs). Used by
|
|
32
|
+
* parseUnmergedPaths() below to prove an ACTUAL conflict from git's own
|
|
33
|
+
* working-tree state, never inferred from a failing command's exit
|
|
34
|
+
* code/message alone.
|
|
35
|
+
*/
|
|
36
|
+
const UNMERGED_STATUS_CODES = new Set(['DD', 'AU', 'UD', 'UA', 'DU', 'AA', 'UU']);
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Parses `git status --porcelain` output and returns the paths whose XY
|
|
40
|
+
* status code marks them as unmerged (conflicted). Any other status
|
|
41
|
+
* (staged/modified/untracked/etc.) is deliberately ignored -- only these
|
|
42
|
+
* codes are unambiguous proof of an in-progress conflict.
|
|
43
|
+
*
|
|
44
|
+
* @param {string} porcelainOutput
|
|
45
|
+
* @returns {string[]}
|
|
46
|
+
*/
|
|
47
|
+
export function parseUnmergedPaths(porcelainOutput) {
|
|
48
|
+
const text = String(porcelainOutput == null ? '' : porcelainOutput);
|
|
49
|
+
const paths = [];
|
|
50
|
+
for (const line of text.split('\n')) {
|
|
51
|
+
if (!line) continue;
|
|
52
|
+
const code = line.slice(0, 2);
|
|
53
|
+
if (UNMERGED_STATUS_CODES.has(code)) {
|
|
54
|
+
paths.push(line.slice(3).trim());
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
return paths;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Tier 1 SCRIPTED conflict detection + clean-state restore. Called only
|
|
62
|
+
* after a `git pull --rebase` command has already failed (its exit code is
|
|
63
|
+
* why we're here at all). Never trusts that failing command's own exit
|
|
64
|
+
* code/message classification alone to decide whether a rebase is actually
|
|
65
|
+
* mid-conflict -- confirms via git's OWN porcelain status first (a rebase
|
|
66
|
+
* that failed for some other, non-conflict reason before ever touching the
|
|
67
|
+
* tree has nothing to abort). If unmerged paths ARE found, runs
|
|
68
|
+
* `git rebase --abort` to restore a clean working tree, then re-checks
|
|
69
|
+
* porcelain to confirm the abort actually worked (a loud log warning, never
|
|
70
|
+
* a second thrown error, if it somehow did not). Script-only: no agent is
|
|
71
|
+
* ever dispatched here -- the caller decides whether to escalate to Tier 2
|
|
72
|
+
* based on the returned unmerged paths.
|
|
73
|
+
*
|
|
74
|
+
* `runGitStep` is dependency-injected (rather than duplicated here) so this
|
|
75
|
+
* module stays git-primitive-only and shares runner.js's single transient-
|
|
76
|
+
* retry/classification implementation.
|
|
77
|
+
*
|
|
78
|
+
* @param {{
|
|
79
|
+
* command: Function, member: string, log: Function,
|
|
80
|
+
* maxTransientRetries: number, runGitStep: Function,
|
|
81
|
+
* }} opts
|
|
82
|
+
* @returns {Promise<string[]>} unmerged paths found (empty array if none)
|
|
83
|
+
*/
|
|
84
|
+
export async function detectAndAbortRebaseConflict({ command, member, log, maxTransientRetries, runGitStep }) {
|
|
85
|
+
const statusBefore = await runGitStep({
|
|
86
|
+
command, member, cmd: 'git status --porcelain',
|
|
87
|
+
label: `rebase-conflict status check for '${member}'`, log, maxTransientRetries,
|
|
88
|
+
});
|
|
89
|
+
const unmergedPaths = parseUnmergedPaths(statusBefore.output);
|
|
90
|
+
if (unmergedPaths.length === 0) {
|
|
91
|
+
return unmergedPaths;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
log(`[Sync] G-push pull-rebase for member '${member}' left unmerged path(s) (${unmergedPaths.join(', ')}) -- running 'git rebase --abort' to restore a clean working tree (Tier 1, script-only; no agent dispatched).`);
|
|
95
|
+
await command('git rebase --abort', { member_name: member, silent: true, failSoft: true, label: `G-push rebase --abort for '${member}'` });
|
|
96
|
+
|
|
97
|
+
const statusAfter = await command('git status --porcelain', { member_name: member, silent: true, failSoft: true, label: `post-abort clean-state check for '${member}'` });
|
|
98
|
+
const remaining = statusAfter && statusAfter.output ? String(statusAfter.output).trim() : '';
|
|
99
|
+
if (remaining !== '') {
|
|
100
|
+
log(`[Sync] WARNING: 'git rebase --abort' for member '${member}' did not fully restore a clean working tree -- porcelain still shows: ${remaining}`);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
return unmergedPaths;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Builds the self-contained Tier 2 runbook prompt: exactly which files are
|
|
108
|
+
* conflicted, and a fixed sequence of steps to resolve them with real
|
|
109
|
+
* judgment rather than a blind ours/theirs rule. ASCII-only per project
|
|
110
|
+
* convention.
|
|
111
|
+
*
|
|
112
|
+
* @param {{ member: string, branch: string, unmergedPaths: string[], remote?: string }} opts
|
|
113
|
+
* @returns {string}
|
|
114
|
+
*/
|
|
115
|
+
export function buildConflictResolutionRunbookPrompt({ member, branch, unmergedPaths, remote = 'origin' }) {
|
|
116
|
+
const fileList = unmergedPaths.map((p) => ` - ${p}`).join('\n');
|
|
117
|
+
return [
|
|
118
|
+
'GIT CONFLICT RESOLUTION RUNBOOK (Tier 2 of the git conflict ladder).',
|
|
119
|
+
'',
|
|
120
|
+
`A scripted 'git pull --rebase ${remote} ${branch}' on member '${member}' left the ` +
|
|
121
|
+
'following file(s) with real, same-line/same-hunk merge conflicts that a fixed ' +
|
|
122
|
+
'mechanical ours/theirs policy cannot arbitrate (git already auto-merges every ' +
|
|
123
|
+
'non-overlapping change -- these are what is left over):',
|
|
124
|
+
fileList,
|
|
125
|
+
'',
|
|
126
|
+
'Follow these steps exactly, in order:',
|
|
127
|
+
`1. Run 'git status' to confirm you are mid-rebase with the conflicted file(s) above.`,
|
|
128
|
+
' If the working tree is already clean (no conflict markers), the conflict was',
|
|
129
|
+
' already resolved by a prior attempt -- skip to step 5.',
|
|
130
|
+
'2. Open each conflicted file and resolve the <<<<<<< / ======= / >>>>>>> markers by',
|
|
131
|
+
' understanding BOTH sides of the change and combining them correctly -- never',
|
|
132
|
+
' blindly delete one side. Preserve the intent of both changes wherever they are',
|
|
133
|
+
' not truly mutually exclusive; when they are mutually exclusive, prefer the',
|
|
134
|
+
' version that keeps the codebase buildable and consistent with its surrounding',
|
|
135
|
+
' code, and note your reasoning.',
|
|
136
|
+
`3. Stage the resolved file(s) with 'git add' and run 'git rebase --continue' ` +
|
|
137
|
+
'(repeat if the rebase has more than one commit to replay).',
|
|
138
|
+
'4. Run the project build/lint/unit tests for the affected area and fix any breakage',
|
|
139
|
+
' your resolution introduced before proceeding.',
|
|
140
|
+
`5. Run 'git push ${remote} ${branch}' to publish the resolved, clean tree.`,
|
|
141
|
+
'',
|
|
142
|
+
'Do not run any `bd` command and do not touch beads in any way -- this is a pure git',
|
|
143
|
+
'conflict-resolution dispatch, not a development streak.',
|
|
144
|
+
].join('\n');
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Tier 2: dispatches an agent, armed with the runbook above, to resolve a
|
|
149
|
+
* real (same-line/same-hunk) merge conflict Tier 1 could not mechanically
|
|
150
|
+
* arbitrate. This function only DISPATCHES -- it deliberately does not
|
|
151
|
+
* itself decide whether the attempt succeeded; the caller (runner.js's
|
|
152
|
+
* syncMemberAfter) re-verifies success mechanically afterwards (clean
|
|
153
|
+
* porcelain + an actual successful re-push), exactly like Tier 1 never
|
|
154
|
+
* trusts a failing command's own message alone. Bounded: exactly one Tier 2
|
|
155
|
+
* attempt per conflict -- a genuinely unresolvable conflict still fails
|
|
156
|
+
* after this, rather than looping indefinitely (script-first posture: no
|
|
157
|
+
* unbounded agent escalation).
|
|
158
|
+
*
|
|
159
|
+
* @param {{
|
|
160
|
+
* agent: Function, member: string, branch: string, unmergedPaths: string[],
|
|
161
|
+
* log?: Function, model?: string, remote?: string,
|
|
162
|
+
* }} opts
|
|
163
|
+
* @returns {Promise<unknown>} whatever the injected agent() call resolves to
|
|
164
|
+
*/
|
|
165
|
+
export async function dispatchConflictResolutionAgent({ agent, member, branch, unmergedPaths, log = () => {}, model, remote = 'origin' }) {
|
|
166
|
+
if (typeof agent !== 'function') {
|
|
167
|
+
throw new Error('dispatchConflictResolutionAgent requires an injected agent() in opts');
|
|
168
|
+
}
|
|
169
|
+
log(`[Sync] Tier 2: dispatching a conflict-resolution runbook to member '${member}' for unmerged path(s) [${unmergedPaths.join(', ')}] -- the one documented ladder step above scripted ours/theirs.`);
|
|
170
|
+
const prompt = buildConflictResolutionRunbookPrompt({ member, branch, unmergedPaths, remote });
|
|
171
|
+
return agent(prompt, {
|
|
172
|
+
member_name: member,
|
|
173
|
+
label: `Tier 2 conflict resolution [${unmergedPaths.join(', ')}]`,
|
|
174
|
+
model,
|
|
175
|
+
timeout_s: 1800,
|
|
176
|
+
max_total_s: 1800,
|
|
177
|
+
});
|
|
178
|
+
}
|