@apralabs/apra-fleet 0.3.5 → 0.4.0
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 +245 -257
- package/dist/agents/backlog-groomer.md +287 -0
- package/dist/agents/deployer.md +52 -11
- package/dist/agents/doer.md +32 -7
- package/dist/agents/integ-test-runner.md +151 -61
- package/dist/agents/plan-reviewer.md +74 -17
- package/dist/agents/planner.md +94 -14
- package/dist/agents/regression-test-runner.md +216 -0
- package/dist/agents/reviewer.md +21 -6
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/integ-test-runner-output.json +34 -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 +4 -0
- 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 +44 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +604 -108
- 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/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/secret.js +8 -2
- package/dist/cli/secret.js.map +1 -1
- 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 +109 -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/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/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 +179 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +13 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +62 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +10 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +1 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +21 -1
- 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 +9 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +127 -14
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +6 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +248 -9
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +3 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +7 -0
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +3 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +8 -1
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/gemini.d.ts +3 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +11 -1
- 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 +51 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +103 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +4 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +49 -0
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +79 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +10 -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 +12 -5
- 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-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 +1 -0
- 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/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/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 +56 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +111 -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/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.map +1 -1
- package/dist/services/stall/log-path-resolver.js +8 -1
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +39 -7
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +136 -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 +55 -5
- 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 +139 -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/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +8 -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/compose-permissions.d.ts +12 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +55 -4
- 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 +11 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +22 -5
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +72 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +962 -71
- 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/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 +8 -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/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 +17 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +144 -5
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +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 +44 -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-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/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 +8 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +11 -1
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +15 -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/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 +450 -87
- package/package.json +35 -7
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +396 -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 +287 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -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 +22 -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 +18 -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/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/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 +38 -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 +142 -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 +121 -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 +857 -0
- package/packages/apra-fleet-se/bin/serve.mjs +383 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -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 +151 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -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-recovery-path-b.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -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 +222 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
- package/packages/apra-fleet-se/package.json +28 -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 +1325 -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/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 +1723 -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/permissions.md +50 -0
- package/skills/fleet/profiles/base-dev.json +1 -0
- package/skills/fleet/profiles/base-reviewer.json +1 -0
- package/skills/fleet/profiles/node.json +2 -2
- 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,25 @@
|
|
|
1
|
+
import { getPool } from './db/pool.js';
|
|
2
|
+
export async function createMember(id, workspaceId, input, pool = getPool()) {
|
|
3
|
+
const result = await pool.query(`INSERT INTO members (id, workspace_id, machine_id, name, provider, work_folder)
|
|
4
|
+
VALUES ($1, $2, $3, $4, $5, $6)
|
|
5
|
+
RETURNING *`, [id, workspaceId, input.machineId ?? null, input.name, input.provider, input.workFolder ?? null]);
|
|
6
|
+
return result.rows[0];
|
|
7
|
+
}
|
|
8
|
+
export async function listMembers(workspaceId, pool = getPool()) {
|
|
9
|
+
const result = await pool.query(`SELECT * FROM members WHERE workspace_id = $1 ORDER BY created_at`, [workspaceId]);
|
|
10
|
+
return result.rows;
|
|
11
|
+
}
|
|
12
|
+
export async function getMember(workspaceId, id, pool = getPool()) {
|
|
13
|
+
const result = await pool.query(`SELECT * FROM members WHERE workspace_id = $1 AND id = $2`, [workspaceId, id]);
|
|
14
|
+
return result.rows[0] ?? null;
|
|
15
|
+
}
|
|
16
|
+
export async function deleteMember(workspaceId, id, pool = getPool()) {
|
|
17
|
+
const result = await pool.query(`DELETE FROM members WHERE workspace_id = $1 AND id = $2`, [workspaceId, id]);
|
|
18
|
+
return (result.rowCount ?? 0) > 0;
|
|
19
|
+
}
|
|
20
|
+
/** apra-fleet-us9.5: records which jti this member's current live token
|
|
21
|
+
* carries, so a later rotation knows what to revoke. */
|
|
22
|
+
export async function setCurrentJti(workspaceId, id, jti, pool = getPool()) {
|
|
23
|
+
await pool.query(`UPDATE members SET current_jti = $3 WHERE workspace_id = $1 AND id = $2`, [workspaceId, id, jti]);
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=members.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"members.js","sourceRoot":"","sources":["../../src/hub-service/members.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAsBvC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAU,EACV,WAAmB,EACnB,KAAwB,EACxB,OAAa,OAAO,EAAE;IAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B;;iBAEa,EACb,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CACjG,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAa,OAAO,EAAE;IAC3E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,mEAAmE,EACnE,CAAC,WAAW,CAAC,CACd,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,EAAU,EACV,OAAa,OAAO,EAAE;IAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,2DAA2D,EAC3D,CAAC,WAAW,EAAE,EAAE,CAAC,CAClB,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,EAAU,EACV,OAAa,OAAO,EAAE;IAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,yDAAyD,EACzD,CAAC,WAAW,EAAE,EAAE,CAAC,CAClB,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;yDACyD;AACzD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,EAAU,EACV,GAAkB,EAClB,OAAa,OAAO,EAAE;IAEtB,MAAM,IAAI,CAAC,KAAK,CACd,yEAAyE,EACzE,CAAC,WAAW,EAAE,EAAE,EAAE,GAAG,CAAC,CACvB,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Presence tracking (apra-fleet-us9.4), backed by the UNLOGGED `presence`
|
|
3
|
+
* table (docs/adr-hub-persistence.md "presence is UNLOGGED" decision).
|
|
4
|
+
* Losing this table on a hard crash is an accepted tradeoff: spokes
|
|
5
|
+
* reconnect and re-announce as the normal recovery path, so there is no
|
|
6
|
+
* durability requirement here.
|
|
7
|
+
*/
|
|
8
|
+
import type { Pool } from 'pg';
|
|
9
|
+
export interface PresenceRow {
|
|
10
|
+
machine_id: string;
|
|
11
|
+
member_id: string;
|
|
12
|
+
status: string;
|
|
13
|
+
last_seen: string;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Upserts a member's presence for a machine. Called on every heartbeat /
|
|
17
|
+
* status change from a spoke -- idempotent by (machine_id, member_id).
|
|
18
|
+
*/
|
|
19
|
+
export declare function announce(machineId: string, memberId: string, status: string, pool?: Pool): Promise<void>;
|
|
20
|
+
/**
|
|
21
|
+
* Replaces a machine's entire presence view with a fresh snapshot
|
|
22
|
+
* (docs/hub-spoke-wire-protocol.md section 4: `presence.announce` is a full
|
|
23
|
+
* snapshot, not a diff -- whatever the spoke reports NOW is truth, so a
|
|
24
|
+
* stale member row from a crashed-and-restarted spoke cannot survive past
|
|
25
|
+
* its next announce). Deletes any row for this machine whose member_id is
|
|
26
|
+
* not in the new snapshot, then upserts every member in the snapshot.
|
|
27
|
+
*/
|
|
28
|
+
export declare function announceSnapshot(machineId: string, members: Array<{
|
|
29
|
+
memberId: string;
|
|
30
|
+
status: string;
|
|
31
|
+
}>, pool?: Pool): Promise<void>;
|
|
32
|
+
/** Reads current presence for every member on a machine. */
|
|
33
|
+
export declare function listForMachine(machineId: string, pool?: Pool): Promise<PresenceRow[]>;
|
|
34
|
+
/**
|
|
35
|
+
* A member is considered stale (likely disconnected without a clean
|
|
36
|
+
* announce) if its last_seen is older than staleMs. Callers use this to
|
|
37
|
+
* decide whether to still trust a cached "online" status.
|
|
38
|
+
*/
|
|
39
|
+
export declare function isStale(machineId: string, memberId: string, staleMs: number, pool?: Pool): Promise<boolean>;
|
|
40
|
+
//# sourceMappingURL=presence.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/hub-service/presence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG/B,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,4DAA4D;AAC5D,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAMxB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAQlB"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { getPool } from './db/pool.js';
|
|
2
|
+
/**
|
|
3
|
+
* Upserts a member's presence for a machine. Called on every heartbeat /
|
|
4
|
+
* status change from a spoke -- idempotent by (machine_id, member_id).
|
|
5
|
+
*/
|
|
6
|
+
export async function announce(machineId, memberId, status, pool = getPool()) {
|
|
7
|
+
await pool.query(`INSERT INTO presence (machine_id, member_id, status, last_seen)
|
|
8
|
+
VALUES ($1, $2, $3, now())
|
|
9
|
+
ON CONFLICT (machine_id, member_id)
|
|
10
|
+
DO UPDATE SET status = $3, last_seen = now()`, [machineId, memberId, status]);
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Replaces a machine's entire presence view with a fresh snapshot
|
|
14
|
+
* (docs/hub-spoke-wire-protocol.md section 4: `presence.announce` is a full
|
|
15
|
+
* snapshot, not a diff -- whatever the spoke reports NOW is truth, so a
|
|
16
|
+
* stale member row from a crashed-and-restarted spoke cannot survive past
|
|
17
|
+
* its next announce). Deletes any row for this machine whose member_id is
|
|
18
|
+
* not in the new snapshot, then upserts every member in the snapshot.
|
|
19
|
+
*/
|
|
20
|
+
export async function announceSnapshot(machineId, members, pool = getPool()) {
|
|
21
|
+
const memberIds = members.map((m) => m.memberId);
|
|
22
|
+
await pool.query(`DELETE FROM presence WHERE machine_id = $1 AND NOT (member_id = ANY($2::text[]))`, [machineId, memberIds]);
|
|
23
|
+
for (const m of members) {
|
|
24
|
+
await announce(machineId, m.memberId, m.status, pool);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
/** Reads current presence for every member on a machine. */
|
|
28
|
+
export async function listForMachine(machineId, pool = getPool()) {
|
|
29
|
+
const result = await pool.query(`SELECT * FROM presence WHERE machine_id = $1 ORDER BY member_id`, [machineId]);
|
|
30
|
+
return result.rows;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* A member is considered stale (likely disconnected without a clean
|
|
34
|
+
* announce) if its last_seen is older than staleMs. Callers use this to
|
|
35
|
+
* decide whether to still trust a cached "online" status.
|
|
36
|
+
*/
|
|
37
|
+
export async function isStale(machineId, memberId, staleMs, pool = getPool()) {
|
|
38
|
+
const result = await pool.query(`SELECT (last_seen + ($3::text || ' milliseconds')::interval <= now()) AS stale
|
|
39
|
+
FROM presence WHERE machine_id = $1 AND member_id = $2`, [machineId, memberId, staleMs]);
|
|
40
|
+
if (result.rows.length === 0)
|
|
41
|
+
return true;
|
|
42
|
+
return result.rows[0].stale;
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=presence.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/hub-service/presence.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAiB,EACjB,QAAgB,EAChB,MAAc,EACd,OAAa,OAAO,EAAE;IAEtB,MAAM,IAAI,CAAC,KAAK,CACd;;;kDAG8C,EAC9C,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,OAAoD,EACpD,OAAa,OAAO,EAAE;IAEtB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,CAAC,KAAK,CACd,kFAAkF,EAClF,CAAC,SAAS,EAAE,SAAS,CAAC,CACvB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,OAAa,OAAO,EAAE;IAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,iEAAiE,EACjE,CAAC,SAAS,CAAC,CACZ,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,QAAgB,EAChB,OAAe,EACf,OAAa,OAAO,EAAE;IAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B;4DACwD,EACxD,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAC/B,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9B,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Pool } from 'pg';
|
|
2
|
+
export interface ProjectView {
|
|
3
|
+
id: string;
|
|
4
|
+
name: string;
|
|
5
|
+
desc: string;
|
|
6
|
+
status: 'active' | 'paused';
|
|
7
|
+
members: string[];
|
|
8
|
+
lastActivity: number;
|
|
9
|
+
}
|
|
10
|
+
export declare function getProjectView(workspaceId: string, projectId: string, pool?: Pool): Promise<ProjectView | null>;
|
|
11
|
+
export declare function listProjectViews(workspaceId: string, pool?: Pool): Promise<ProjectView[]>;
|
|
12
|
+
//# sourceMappingURL=project-view.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project-view.d.ts","sourceRoot":"","sources":["../../src/hub-service/project-view.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG/B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAkBD,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAI7B;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,IAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAG1G"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Dashboard-facing Project view-model assembly (apra-fleet-us9.4
|
|
3
|
+
* continuation), joining the raw CRUD row (projects.ts) with its member
|
|
4
|
+
* list (project_members) into the shape @apralabs/fleet-api-contract's
|
|
5
|
+
* ProjectSchema requires. See projects.ts for the lastActivity honesty-
|
|
6
|
+
* contract note.
|
|
7
|
+
*/
|
|
8
|
+
import { getProject, listProjects, listProjectMemberIds } from './projects.js';
|
|
9
|
+
import { getPool } from './db/pool.js';
|
|
10
|
+
function secondsSince(iso) {
|
|
11
|
+
return Math.max(0, Math.floor((Date.now() - new Date(iso).getTime()) / 1000));
|
|
12
|
+
}
|
|
13
|
+
async function assembleView(project, pool) {
|
|
14
|
+
const members = await listProjectMemberIds(project.id, pool);
|
|
15
|
+
return {
|
|
16
|
+
id: project.id,
|
|
17
|
+
name: project.name,
|
|
18
|
+
desc: project.description,
|
|
19
|
+
status: project.status,
|
|
20
|
+
members,
|
|
21
|
+
lastActivity: secondsSince(project.created_at),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
export async function getProjectView(workspaceId, projectId, pool = getPool()) {
|
|
25
|
+
const project = await getProject(workspaceId, projectId, pool);
|
|
26
|
+
if (!project)
|
|
27
|
+
return null;
|
|
28
|
+
return assembleView(project, pool);
|
|
29
|
+
}
|
|
30
|
+
export async function listProjectViews(workspaceId, pool = getPool()) {
|
|
31
|
+
const projects = await listProjects(workspaceId, pool);
|
|
32
|
+
return Promise.all(projects.map(p => assembleView(p, pool)));
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=project-view.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project-view.js","sourceRoot":"","sources":["../../src/hub-service/project-view.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAAmB,MAAM,eAAe,CAAC;AAEhG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAWvC,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAmB,EAAE,IAAU;IACzD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7D,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,WAAW;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;QACP,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,SAAiB,EACjB,OAAa,OAAO,EAAE;IAEtB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,OAAa,OAAO,EAAE;IAChF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Project CRUD (apra-fleet-us9.4 continuation), data-layer only. Scoped by
|
|
3
|
+
* workspace_id throughout. Many-to-many with members via project_members
|
|
4
|
+
* (a member can work across multiple projects).
|
|
5
|
+
*
|
|
6
|
+
* Honesty contract (matching member-view.ts / the usage-ledger convention
|
|
7
|
+
* elsewhere in this codebase): `lastActivity` has no real activity source
|
|
8
|
+
* to draw from yet (GET /ws/:id/activity itself is unbuilt -- it needs its
|
|
9
|
+
* own event model, a separate piece of work). Rather than fabricate a
|
|
10
|
+
* number, this uses time-since-creation as an honest, clearly-labeled
|
|
11
|
+
* proxy: it will read as "created N seconds ago" for a project with no
|
|
12
|
+
* activity yet, not as a false claim of recent real activity.
|
|
13
|
+
*/
|
|
14
|
+
import type { Pool } from 'pg';
|
|
15
|
+
export interface ProjectRow {
|
|
16
|
+
id: string;
|
|
17
|
+
workspace_id: string;
|
|
18
|
+
name: string;
|
|
19
|
+
description: string;
|
|
20
|
+
status: 'active' | 'paused';
|
|
21
|
+
created_at: string;
|
|
22
|
+
}
|
|
23
|
+
export interface CreateProjectInput {
|
|
24
|
+
name: string;
|
|
25
|
+
description?: string;
|
|
26
|
+
memberIds?: string[];
|
|
27
|
+
}
|
|
28
|
+
export declare function createProject(id: string, workspaceId: string, input: CreateProjectInput, pool?: Pool): Promise<ProjectRow>;
|
|
29
|
+
export declare function listProjects(workspaceId: string, pool?: Pool): Promise<ProjectRow[]>;
|
|
30
|
+
export declare function getProject(workspaceId: string, id: string, pool?: Pool): Promise<ProjectRow | null>;
|
|
31
|
+
export interface UpdateProjectInput {
|
|
32
|
+
name?: string;
|
|
33
|
+
description?: string;
|
|
34
|
+
status?: 'active' | 'paused';
|
|
35
|
+
}
|
|
36
|
+
export declare function updateProject(workspaceId: string, id: string, input: UpdateProjectInput, pool?: Pool): Promise<ProjectRow | null>;
|
|
37
|
+
export declare function deleteProject(workspaceId: string, id: string, pool?: Pool): Promise<boolean>;
|
|
38
|
+
/**
|
|
39
|
+
* Both the project AND the member must belong to workspaceId -- without
|
|
40
|
+
* the member check, a member's own row-level FK (members.id exists
|
|
41
|
+
* anywhere) would let a member from a DIFFERENT workspace be attached to
|
|
42
|
+
* this project, leaking across the tenant boundary the rest of this
|
|
43
|
+
* codebase treats as inviolable.
|
|
44
|
+
*/
|
|
45
|
+
export declare function addProjectMember(workspaceId: string, projectId: string, memberId: string, pool?: Pool): Promise<boolean>;
|
|
46
|
+
export declare function removeProjectMember(workspaceId: string, projectId: string, memberId: string, pool?: Pool): Promise<boolean>;
|
|
47
|
+
export declare function listProjectMemberIds(projectId: string, pool?: Pool): Promise<string[]>;
|
|
48
|
+
//# sourceMappingURL=projects.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/hub-service/projects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAI/B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAYD,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,EACzB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,IAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAMrG;AAED,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAM5B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,EACzB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAiB5B;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,IAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMvG"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { getPool } from './db/pool.js';
|
|
2
|
+
import { getMember } from './members.js';
|
|
3
|
+
async function addMembers(projectId, memberIds, pool) {
|
|
4
|
+
for (const memberId of memberIds) {
|
|
5
|
+
await pool.query(`INSERT INTO project_members (project_id, member_id) VALUES ($1, $2)
|
|
6
|
+
ON CONFLICT (project_id, member_id) DO NOTHING`, [projectId, memberId]);
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
export async function createProject(id, workspaceId, input, pool = getPool()) {
|
|
10
|
+
const result = await pool.query(`INSERT INTO projects (id, workspace_id, name, description) VALUES ($1, $2, $3, $4) RETURNING *`, [id, workspaceId, input.name, input.description ?? '']);
|
|
11
|
+
if (input.memberIds?.length) {
|
|
12
|
+
// Same workspace-boundary check as addProjectMember: silently skip any
|
|
13
|
+
// memberId that doesn't belong to this workspace, rather than let a
|
|
14
|
+
// foreign member's row-level FK let it slip in.
|
|
15
|
+
const validated = [];
|
|
16
|
+
for (const memberId of input.memberIds) {
|
|
17
|
+
if (await getMember(workspaceId, memberId, pool))
|
|
18
|
+
validated.push(memberId);
|
|
19
|
+
}
|
|
20
|
+
await addMembers(id, validated, pool);
|
|
21
|
+
}
|
|
22
|
+
return result.rows[0];
|
|
23
|
+
}
|
|
24
|
+
export async function listProjects(workspaceId, pool = getPool()) {
|
|
25
|
+
const result = await pool.query(`SELECT * FROM projects WHERE workspace_id = $1 ORDER BY created_at`, [workspaceId]);
|
|
26
|
+
return result.rows;
|
|
27
|
+
}
|
|
28
|
+
export async function getProject(workspaceId, id, pool = getPool()) {
|
|
29
|
+
const result = await pool.query(`SELECT * FROM projects WHERE workspace_id = $1 AND id = $2`, [workspaceId, id]);
|
|
30
|
+
return result.rows[0] ?? null;
|
|
31
|
+
}
|
|
32
|
+
export async function updateProject(workspaceId, id, input, pool = getPool()) {
|
|
33
|
+
const existing = await getProject(workspaceId, id, pool);
|
|
34
|
+
if (!existing)
|
|
35
|
+
return null;
|
|
36
|
+
const result = await pool.query(`UPDATE projects SET name = $3, description = $4, status = $5
|
|
37
|
+
WHERE workspace_id = $1 AND id = $2
|
|
38
|
+
RETURNING *`, [
|
|
39
|
+
workspaceId,
|
|
40
|
+
id,
|
|
41
|
+
input.name ?? existing.name,
|
|
42
|
+
input.description ?? existing.description,
|
|
43
|
+
input.status ?? existing.status,
|
|
44
|
+
]);
|
|
45
|
+
return result.rows[0];
|
|
46
|
+
}
|
|
47
|
+
export async function deleteProject(workspaceId, id, pool = getPool()) {
|
|
48
|
+
await pool.query(`DELETE FROM project_members WHERE project_id = $1`, [id]);
|
|
49
|
+
const result = await pool.query(`DELETE FROM projects WHERE workspace_id = $1 AND id = $2`, [workspaceId, id]);
|
|
50
|
+
return (result.rowCount ?? 0) > 0;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Both the project AND the member must belong to workspaceId -- without
|
|
54
|
+
* the member check, a member's own row-level FK (members.id exists
|
|
55
|
+
* anywhere) would let a member from a DIFFERENT workspace be attached to
|
|
56
|
+
* this project, leaking across the tenant boundary the rest of this
|
|
57
|
+
* codebase treats as inviolable.
|
|
58
|
+
*/
|
|
59
|
+
export async function addProjectMember(workspaceId, projectId, memberId, pool = getPool()) {
|
|
60
|
+
const project = await getProject(workspaceId, projectId, pool);
|
|
61
|
+
if (!project)
|
|
62
|
+
return false;
|
|
63
|
+
const member = await getMember(workspaceId, memberId, pool);
|
|
64
|
+
if (!member)
|
|
65
|
+
return false;
|
|
66
|
+
await addMembers(projectId, [memberId], pool);
|
|
67
|
+
return true;
|
|
68
|
+
}
|
|
69
|
+
export async function removeProjectMember(workspaceId, projectId, memberId, pool = getPool()) {
|
|
70
|
+
const project = await getProject(workspaceId, projectId, pool);
|
|
71
|
+
if (!project)
|
|
72
|
+
return false;
|
|
73
|
+
await pool.query(`DELETE FROM project_members WHERE project_id = $1 AND member_id = $2`, [projectId, memberId]);
|
|
74
|
+
return true;
|
|
75
|
+
}
|
|
76
|
+
export async function listProjectMemberIds(projectId, pool = getPool()) {
|
|
77
|
+
const result = await pool.query(`SELECT member_id FROM project_members WHERE project_id = $1 ORDER BY added_at`, [projectId]);
|
|
78
|
+
return result.rows.map(r => r.member_id);
|
|
79
|
+
}
|
|
80
|
+
//# sourceMappingURL=projects.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/hub-service/projects.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* At-least-once message relay (apra-fleet-us9.4), backed by the
|
|
3
|
+
* `relay_queue` Postgres table (docs/adr-hub-persistence.md). This is the
|
|
4
|
+
* single most important correctness property in the hub MVP: a briefly
|
|
5
|
+
* disconnected spoke must not silently lose a queued execute_command
|
|
6
|
+
* (docs/hub-spoke-master-plan.md section 6; docs/hub-spoke-wire-protocol.md
|
|
7
|
+
* sections 5-6).
|
|
8
|
+
*
|
|
9
|
+
* State machine: pending -> delivered -> acked (terminal), or -> expired
|
|
10
|
+
* (terminal, TTL swept). "delivered but not yet acked" is intentionally
|
|
11
|
+
* re-served on every fetch -- redeliver-until-acked, not deliver-once.
|
|
12
|
+
* envelope_id is unique per (workspace_id, target_member_id): re-admitting
|
|
13
|
+
* the same envelope_id (a spoke retry after a dropped ack) is a no-op, not
|
|
14
|
+
* a duplicate deliverable.
|
|
15
|
+
*/
|
|
16
|
+
import type { Pool } from 'pg';
|
|
17
|
+
export interface RelayEnvelope {
|
|
18
|
+
id: number;
|
|
19
|
+
workspace_id: string;
|
|
20
|
+
target_member_id: string;
|
|
21
|
+
envelope_id: string;
|
|
22
|
+
kind: string;
|
|
23
|
+
payload: unknown;
|
|
24
|
+
status: 'pending' | 'delivered' | 'acked' | 'expired';
|
|
25
|
+
created_at: string;
|
|
26
|
+
ttl_ms: number;
|
|
27
|
+
acked_at: string | null;
|
|
28
|
+
origin_member_id: string | null;
|
|
29
|
+
delivered_at: string | null;
|
|
30
|
+
correlation_id: string | null;
|
|
31
|
+
}
|
|
32
|
+
/** Defensive per-(workspace_id, target_member_id) queue depth cap
|
|
33
|
+
* (docs/hub-spoke-wire-protocol.md section 6): exceeding it rejects the
|
|
34
|
+
* NEWEST admission attempt, never silently drops an older queued item. */
|
|
35
|
+
export declare const MAX_QUEUE_DEPTH = 1000;
|
|
36
|
+
export declare const MAX_QUEUE_BYTES: number;
|
|
37
|
+
export type EnqueueResult = {
|
|
38
|
+
ok: true;
|
|
39
|
+
envelope: RelayEnvelope;
|
|
40
|
+
} | {
|
|
41
|
+
ok: false;
|
|
42
|
+
reason: 'queue_full';
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* Admits an envelope. Idempotent on (workspace_id, target_member_id,
|
|
46
|
+
* envelope_id): a retried admission with the same envelope_id is a no-op
|
|
47
|
+
* and returns the ORIGINAL row, never a second deliverable copy.
|
|
48
|
+
*
|
|
49
|
+
* `originMemberId` (nullable) is whoever submitted this envelope --
|
|
50
|
+
* recorded so a TTL expiry (see sweepExpiredToFailures) can address a
|
|
51
|
+
* synthetic failure result back to them.
|
|
52
|
+
*
|
|
53
|
+
* `correlationId` (nullable) is the wire-protocol envelope's own
|
|
54
|
+
* `correlation_id` field (docs/hub-spoke-wire-protocol.md section 3): set
|
|
55
|
+
* on a response/result envelope to the envelope_id of the request it
|
|
56
|
+
* answers. MUST be persisted and forwarded on delivery -- an originating
|
|
57
|
+
* spoke (relay-request.ts, file-transfer-relay.ts) matches a delivered
|
|
58
|
+
* result back to its pending request by this field alone.
|
|
59
|
+
*/
|
|
60
|
+
export declare function enqueue(workspaceId: string, targetMemberId: string, envelopeId: string, kind: string, payload: unknown, ttlMs: number, pool?: Pool, originMemberId?: string | null, correlationId?: string | null): Promise<EnqueueResult>;
|
|
61
|
+
/** Default per docs/hub-spoke-wire-protocol.md section 5 step 5. */
|
|
62
|
+
export declare const DEFAULT_ACK_TIMEOUT_MS = 10000;
|
|
63
|
+
/**
|
|
64
|
+
* FIFO fetch of everything still deliverable to this member -- both
|
|
65
|
+
* never-yet-delivered ('pending') and delivered-but-not-yet-acked
|
|
66
|
+
* ('delivered', once `ackTimeoutMs` has elapsed since the last delivery
|
|
67
|
+
* attempt) envelopes, so a spoke that reconnects after a drop gets the full
|
|
68
|
+
* still-owed set, not just what it never saw. Excludes expired envelopes.
|
|
69
|
+
* Marks every returned row 'delivered' with a fresh `delivered_at`, so a
|
|
70
|
+
* 'delivered'-but-unacked row is not re-served again until another
|
|
71
|
+
* ack_timeout_ms window passes (section 5 step 5's redeliver-on-timeout,
|
|
72
|
+
* not redeliver-on-every-poll).
|
|
73
|
+
*
|
|
74
|
+
* WORKSPACE IRON WALL (apra-fleet-us9.11): the read is scoped by
|
|
75
|
+
* `workspaceId` as well as `target_member_id`. target_member_id alone is NOT
|
|
76
|
+
* a workspace boundary -- a compromised spoke can announce an arbitrary
|
|
77
|
+
* member_id (envelope-routes.ts's handlePresence trusts the announced
|
|
78
|
+
* snapshot), so the /ws/:id/stream route MUST NOT rely on presence membership
|
|
79
|
+
* to keep workspaces apart. Scoping here means even a foreign member_id that
|
|
80
|
+
* lands in this machine's presence view can only ever surface envelopes
|
|
81
|
+
* queued under THIS workspace, never another tenant's queue. This mirrors the
|
|
82
|
+
* write side (enqueue/ack both key on workspace_id + target_member_id) so the
|
|
83
|
+
* wall is symmetric on both read and write.
|
|
84
|
+
*/
|
|
85
|
+
export declare function fetchDeliverable(workspaceId: string, targetMemberId: string, pool?: Pool, ackTimeoutMs?: number): Promise<RelayEnvelope[]>;
|
|
86
|
+
/**
|
|
87
|
+
* Retires an envelope. Idempotent: acking an already-acked or
|
|
88
|
+
* already-expired envelope is a no-op, not an error.
|
|
89
|
+
*/
|
|
90
|
+
export declare function ack(workspaceId: string, targetMemberId: string, envelopeId: string, pool?: Pool): Promise<void>;
|
|
91
|
+
/** TTL sweep: moves anything past its deadline (measured from hub admission
|
|
92
|
+
* time, never the originator's own timestamp) to the terminal 'expired'
|
|
93
|
+
* state so it stops being served by fetchDeliverable. */
|
|
94
|
+
export declare function sweepExpired(pool?: Pool): Promise<number>;
|
|
95
|
+
/**
|
|
96
|
+
* Request-kind envelopes whose TTL expiry must produce a synthetic failure
|
|
97
|
+
* result back to the originator (docs/hub-spoke-wire-protocol.md section 6)
|
|
98
|
+
* -- mapped to the RESULT kind a caller is actually waiting on via
|
|
99
|
+
* `correlation_id`. Kinds absent from this map (results/acks/broadcasts)
|
|
100
|
+
* are terminal already or explicitly need no catch-up (section 3.1) and
|
|
101
|
+
* are simply expired with no synthetic follow-up.
|
|
102
|
+
*/
|
|
103
|
+
export declare const FAILURE_RESULT_KIND: Record<string, string>;
|
|
104
|
+
/**
|
|
105
|
+
* Sweeps TTL-expired envelopes and, for request kinds with an entry in
|
|
106
|
+
* FAILURE_RESULT_KIND, enqueues a synthetic failure result addressed back
|
|
107
|
+
* to the envelope's origin_member_id (never dropped silently -- a caller
|
|
108
|
+
* blocked on `correlation_id` gets a definite answer). Rows with no
|
|
109
|
+
* origin_member_id (should not normally happen for spoke-submitted
|
|
110
|
+
* envelopes) or an unmapped kind are simply expired with no follow-up.
|
|
111
|
+
* Returns the count of envelopes expired (not the count of synthetic
|
|
112
|
+
* failures generated, which may be fewer).
|
|
113
|
+
*/
|
|
114
|
+
export declare function sweepExpiredToFailures(pool?: Pool): Promise<number>;
|
|
115
|
+
//# sourceMappingURL=relay-queue.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relay-queue.d.ts","sourceRoot":"","sources":["../../src/hub-service/relay-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG/B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;2EAE2E;AAC3E,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,eAAe,QAAkB,CAAC;AAE/C,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAExC;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,IAAgB,EACtB,cAAc,GAAE,MAAM,GAAG,IAAW,EACpC,aAAa,GAAE,MAAM,GAAG,IAAW,GAClC,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAED,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,IAAgB,EACtB,YAAY,GAAE,MAA+B,GAC5C,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,IAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;0DAE0D;AAC1D,wBAAsB,YAAY,CAAC,IAAI,GAAE,IAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAItD,CAAC;AAUF;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,GAAE,IAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBpF"}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { getPool } from './db/pool.js';
|
|
2
|
+
/** Defensive per-(workspace_id, target_member_id) queue depth cap
|
|
3
|
+
* (docs/hub-spoke-wire-protocol.md section 6): exceeding it rejects the
|
|
4
|
+
* NEWEST admission attempt, never silently drops an older queued item. */
|
|
5
|
+
export const MAX_QUEUE_DEPTH = 1000;
|
|
6
|
+
export const MAX_QUEUE_BYTES = 8 * 1024 * 1024;
|
|
7
|
+
/**
|
|
8
|
+
* Admits an envelope. Idempotent on (workspace_id, target_member_id,
|
|
9
|
+
* envelope_id): a retried admission with the same envelope_id is a no-op
|
|
10
|
+
* and returns the ORIGINAL row, never a second deliverable copy.
|
|
11
|
+
*
|
|
12
|
+
* `originMemberId` (nullable) is whoever submitted this envelope --
|
|
13
|
+
* recorded so a TTL expiry (see sweepExpiredToFailures) can address a
|
|
14
|
+
* synthetic failure result back to them.
|
|
15
|
+
*
|
|
16
|
+
* `correlationId` (nullable) is the wire-protocol envelope's own
|
|
17
|
+
* `correlation_id` field (docs/hub-spoke-wire-protocol.md section 3): set
|
|
18
|
+
* on a response/result envelope to the envelope_id of the request it
|
|
19
|
+
* answers. MUST be persisted and forwarded on delivery -- an originating
|
|
20
|
+
* spoke (relay-request.ts, file-transfer-relay.ts) matches a delivered
|
|
21
|
+
* result back to its pending request by this field alone.
|
|
22
|
+
*/
|
|
23
|
+
export async function enqueue(workspaceId, targetMemberId, envelopeId, kind, payload, ttlMs, pool = getPool(), originMemberId = null, correlationId = null) {
|
|
24
|
+
const payloadJson = JSON.stringify(payload);
|
|
25
|
+
// Byte total computed in JS, not SQL (octet_length/length aren't
|
|
26
|
+
// available in pg-mem, the in-memory engine the test suite runs
|
|
27
|
+
// against) -- fine for a soft defensive cap, not a precise billing
|
|
28
|
+
// figure (docs/hub-spoke-wire-protocol.md section 6).
|
|
29
|
+
const depth = await pool.query(`SELECT payload FROM relay_queue
|
|
30
|
+
WHERE workspace_id = $1 AND target_member_id = $2 AND status IN ('pending', 'delivered')
|
|
31
|
+
AND envelope_id != $3`, [workspaceId, targetMemberId, envelopeId]);
|
|
32
|
+
const count = depth.rows.length;
|
|
33
|
+
const bytes = depth.rows.reduce((sum, r) => sum + Buffer.byteLength(JSON.stringify(r.payload)), 0);
|
|
34
|
+
if (count >= MAX_QUEUE_DEPTH || bytes + Buffer.byteLength(payloadJson) > MAX_QUEUE_BYTES) {
|
|
35
|
+
return { ok: false, reason: 'queue_full' };
|
|
36
|
+
}
|
|
37
|
+
const inserted = await pool.query(`INSERT INTO relay_queue (workspace_id, target_member_id, envelope_id, kind, payload, ttl_ms, origin_member_id, correlation_id)
|
|
38
|
+
VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
|
|
39
|
+
ON CONFLICT (workspace_id, target_member_id, envelope_id) DO NOTHING
|
|
40
|
+
RETURNING *`, [workspaceId, targetMemberId, envelopeId, kind, payloadJson, ttlMs, originMemberId, correlationId]);
|
|
41
|
+
if (inserted.rows[0])
|
|
42
|
+
return { ok: true, envelope: inserted.rows[0] };
|
|
43
|
+
const existing = await pool.query(`SELECT * FROM relay_queue WHERE workspace_id = $1 AND target_member_id = $2 AND envelope_id = $3`, [workspaceId, targetMemberId, envelopeId]);
|
|
44
|
+
return { ok: true, envelope: existing.rows[0] };
|
|
45
|
+
}
|
|
46
|
+
/** Default per docs/hub-spoke-wire-protocol.md section 5 step 5. */
|
|
47
|
+
export const DEFAULT_ACK_TIMEOUT_MS = 10000;
|
|
48
|
+
/**
|
|
49
|
+
* FIFO fetch of everything still deliverable to this member -- both
|
|
50
|
+
* never-yet-delivered ('pending') and delivered-but-not-yet-acked
|
|
51
|
+
* ('delivered', once `ackTimeoutMs` has elapsed since the last delivery
|
|
52
|
+
* attempt) envelopes, so a spoke that reconnects after a drop gets the full
|
|
53
|
+
* still-owed set, not just what it never saw. Excludes expired envelopes.
|
|
54
|
+
* Marks every returned row 'delivered' with a fresh `delivered_at`, so a
|
|
55
|
+
* 'delivered'-but-unacked row is not re-served again until another
|
|
56
|
+
* ack_timeout_ms window passes (section 5 step 5's redeliver-on-timeout,
|
|
57
|
+
* not redeliver-on-every-poll).
|
|
58
|
+
*
|
|
59
|
+
* WORKSPACE IRON WALL (apra-fleet-us9.11): the read is scoped by
|
|
60
|
+
* `workspaceId` as well as `target_member_id`. target_member_id alone is NOT
|
|
61
|
+
* a workspace boundary -- a compromised spoke can announce an arbitrary
|
|
62
|
+
* member_id (envelope-routes.ts's handlePresence trusts the announced
|
|
63
|
+
* snapshot), so the /ws/:id/stream route MUST NOT rely on presence membership
|
|
64
|
+
* to keep workspaces apart. Scoping here means even a foreign member_id that
|
|
65
|
+
* lands in this machine's presence view can only ever surface envelopes
|
|
66
|
+
* queued under THIS workspace, never another tenant's queue. This mirrors the
|
|
67
|
+
* write side (enqueue/ack both key on workspace_id + target_member_id) so the
|
|
68
|
+
* wall is symmetric on both read and write.
|
|
69
|
+
*/
|
|
70
|
+
export async function fetchDeliverable(workspaceId, targetMemberId, pool = getPool(), ackTimeoutMs = DEFAULT_ACK_TIMEOUT_MS) {
|
|
71
|
+
const result = await pool.query(`UPDATE relay_queue
|
|
72
|
+
SET status = 'delivered', delivered_at = now()
|
|
73
|
+
WHERE workspace_id = $1
|
|
74
|
+
AND target_member_id = $2
|
|
75
|
+
AND created_at + (ttl_ms::text || ' milliseconds')::interval > now()
|
|
76
|
+
AND (
|
|
77
|
+
status = 'pending'
|
|
78
|
+
OR (status = 'delivered' AND delivered_at + ($3::text || ' milliseconds')::interval <= now())
|
|
79
|
+
)
|
|
80
|
+
RETURNING *`, [workspaceId, targetMemberId, ackTimeoutMs]);
|
|
81
|
+
return result.rows.sort((a, b) => a.id - b.id);
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Retires an envelope. Idempotent: acking an already-acked or
|
|
85
|
+
* already-expired envelope is a no-op, not an error.
|
|
86
|
+
*/
|
|
87
|
+
export async function ack(workspaceId, targetMemberId, envelopeId, pool = getPool()) {
|
|
88
|
+
await pool.query(`UPDATE relay_queue
|
|
89
|
+
SET status = 'acked', acked_at = now()
|
|
90
|
+
WHERE workspace_id = $1 AND target_member_id = $2 AND envelope_id = $3
|
|
91
|
+
AND status IN ('pending', 'delivered')`, [workspaceId, targetMemberId, envelopeId]);
|
|
92
|
+
}
|
|
93
|
+
/** TTL sweep: moves anything past its deadline (measured from hub admission
|
|
94
|
+
* time, never the originator's own timestamp) to the terminal 'expired'
|
|
95
|
+
* state so it stops being served by fetchDeliverable. */
|
|
96
|
+
export async function sweepExpired(pool = getPool()) {
|
|
97
|
+
const result = await pool.query(`UPDATE relay_queue
|
|
98
|
+
SET status = 'expired'
|
|
99
|
+
WHERE status IN ('pending', 'delivered')
|
|
100
|
+
AND created_at + (ttl_ms::text || ' milliseconds')::interval <= now()
|
|
101
|
+
RETURNING *`);
|
|
102
|
+
return result.rowCount ?? 0;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Request-kind envelopes whose TTL expiry must produce a synthetic failure
|
|
106
|
+
* result back to the originator (docs/hub-spoke-wire-protocol.md section 6)
|
|
107
|
+
* -- mapped to the RESULT kind a caller is actually waiting on via
|
|
108
|
+
* `correlation_id`. Kinds absent from this map (results/acks/broadcasts)
|
|
109
|
+
* are terminal already or explicitly need no catch-up (section 3.1) and
|
|
110
|
+
* are simply expired with no synthetic follow-up.
|
|
111
|
+
*/
|
|
112
|
+
export const FAILURE_RESULT_KIND = {
|
|
113
|
+
'execute_command.request': 'execute_command.result',
|
|
114
|
+
'execute_prompt.request': 'execute_prompt.result',
|
|
115
|
+
'send_message.deliver': 'send_message.ack',
|
|
116
|
+
};
|
|
117
|
+
/** TTLs for the synthetic failure envelopes themselves, matching each
|
|
118
|
+
* result kind's own default in docs/hub-spoke-wire-protocol.md section 3.1. */
|
|
119
|
+
const FAILURE_TTL_MS = {
|
|
120
|
+
'execute_command.result': 60000,
|
|
121
|
+
'execute_prompt.result': 120000,
|
|
122
|
+
'send_message.ack': 15000,
|
|
123
|
+
};
|
|
124
|
+
/**
|
|
125
|
+
* Sweeps TTL-expired envelopes and, for request kinds with an entry in
|
|
126
|
+
* FAILURE_RESULT_KIND, enqueues a synthetic failure result addressed back
|
|
127
|
+
* to the envelope's origin_member_id (never dropped silently -- a caller
|
|
128
|
+
* blocked on `correlation_id` gets a definite answer). Rows with no
|
|
129
|
+
* origin_member_id (should not normally happen for spoke-submitted
|
|
130
|
+
* envelopes) or an unmapped kind are simply expired with no follow-up.
|
|
131
|
+
* Returns the count of envelopes expired (not the count of synthetic
|
|
132
|
+
* failures generated, which may be fewer).
|
|
133
|
+
*/
|
|
134
|
+
export async function sweepExpiredToFailures(pool = getPool()) {
|
|
135
|
+
const result = await pool.query(`UPDATE relay_queue
|
|
136
|
+
SET status = 'expired'
|
|
137
|
+
WHERE status IN ('pending', 'delivered')
|
|
138
|
+
AND created_at + (ttl_ms::text || ' milliseconds')::interval <= now()
|
|
139
|
+
RETURNING *`);
|
|
140
|
+
for (const row of result.rows) {
|
|
141
|
+
const failureKind = FAILURE_RESULT_KIND[row.kind];
|
|
142
|
+
if (!failureKind || !row.origin_member_id)
|
|
143
|
+
continue;
|
|
144
|
+
await enqueue(row.workspace_id, row.origin_member_id, `${row.envelope_id}.ttl-failed`, failureKind, { status: 'target_offline_ttl_expired', correlation_id: row.envelope_id }, FAILURE_TTL_MS[failureKind] ?? 60000, pool, null, row.envelope_id);
|
|
145
|
+
}
|
|
146
|
+
return result.rowCount ?? 0;
|
|
147
|
+
}
|
|
148
|
+
//# sourceMappingURL=relay-queue.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relay-queue.js","sourceRoot":"","sources":["../../src/hub-service/relay-queue.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export interface SessionClaims {
|
|
2
|
+
sub: string;
|
|
3
|
+
jti: string;
|
|
4
|
+
}
|
|
5
|
+
export declare function signSession(sub: string, secret?: string): {
|
|
6
|
+
token: string;
|
|
7
|
+
jti: string;
|
|
8
|
+
};
|
|
9
|
+
export declare function verifySession(token: string, secret?: string): SessionClaims | null;
|
|
10
|
+
//# sourceMappingURL=session-jwt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session-jwt.d.ts","sourceRoot":"","sources":["../../src/hub-service/session-jwt.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAoB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAQrG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAoB,GAAG,aAAa,GAAG,IAAI,CAiB/F"}
|