Skip to content

Migrate default dev setup to dynamic port allocation #2444

@vnv-varun

Description

@vnv-varun

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions