Context
PR #2440 adds isolated parallel dev environments with dynamic port allocation as an opt-in (pnpm setup-dev --isolated <name>). The default pnpm setup-dev still uses docker-compose.dbs.yml with fixed ports.
This ticket covers making dynamic ports the default for all developers, retiring the fixed-port setup entirely.
Why
Simplifies the setup story — one path instead of two. Every developer gets the same isolation benefits (no port conflicts, parallel-ready) without needing the --isolated flag.
Surface areas to update
| File |
Change needed |
packages/agents-core/src/setup/setup.ts:70-73 |
Replace hardcoded REQUIRED_PORTS (5432/5433/5434) with post-startup health check |
packages/agents-core/src/auth/authz/config.ts:15 |
Remove localhost:50051 fallback — require env var |
agents-api/src/workflow/world.ts:36 |
Remove localhost:5432 fallback — require env var |
package.json (3 zed commands) |
Read SPICEDB_ENDPOINT from env instead of hardcoded localhost:50051 |
.github/workflows/ci.yml |
Dynamic port discovery in CI |
.github/workflows/cypress.yml |
Same |
.env.example |
Update examples for dynamic mode |
Dependencies
Context
PR #2440 adds isolated parallel dev environments with dynamic port allocation as an opt-in (
pnpm setup-dev --isolated <name>). The defaultpnpm setup-devstill usesdocker-compose.dbs.ymlwith fixed ports.This ticket covers making dynamic ports the default for all developers, retiring the fixed-port setup entirely.
Why
Simplifies the setup story — one path instead of two. Every developer gets the same isolation benefits (no port conflicts, parallel-ready) without needing the
--isolatedflag.Surface areas to update
packages/agents-core/src/setup/setup.ts:70-73REQUIRED_PORTS(5432/5433/5434) with post-startup health checkpackages/agents-core/src/auth/authz/config.ts:15localhost:50051fallback — require env varagents-api/src/workflow/world.ts:36localhost:5432fallback — require env varpackage.json(3 zed commands)SPICEDB_ENDPOINTfrom env instead of hardcodedlocalhost:50051.github/workflows/ci.yml.github/workflows/cypress.yml.env.exampleDependencies