Standards

S003 — Port Management

Canonical port table with prod/test/release offsets.

S003 — Port Management (v2026-09-30T092519Z-5e473105f4) 2026-09-30 | Canonical port table with prod/test/release offsets. 1 - PORT ALLOCATION - Port allocation and management daemon/config/services.yaml port_pool services machine_classes service_manager.py _load_start_budgets() _placement_ok() _required_port() version_verifier.py compare_build_versions() port definitio… service config… 1. Load port definitions 2. Validate service configurat… 3. Check version compatibility 4. Assign ports based on envir… 5. Start services with assigne… 6. Monitor port availability Port pool configuration prod: {start: 8000, end: 8016} test: {start: 18000, end: 18016} release: {start: 28000, end: 28016} Service configuration snippet daemon: port: 8001 test_port: 18001 release_port: 28001 env_var: KEVIN_PORT_DAEMON The daemon/config/services.yaml file is the single source of truth for port allocations. Service configurations are validated against the port pool and version requirements. Port conflicts are checked at startup to prevent service failures. Legend actor = initiates work · process = code path · store = state on disk · bus = durable queue · dashed = separate process cyan = request flow · pink = state read/write · dashed green = pull / return path · red = refusal As of 2026-09-30 09:25 UTC, from commit 5e47310

Provenance

This drawing is generated, not drawn. It is rebuilt from the source files below, so when they change the picture changes — a diagram here cannot quietly describe a system that no longer works this way.

Owner
Standards
Slug
s003-port-management
Rendered
2026-09-30T092519Z
From commit
5e473105f4
Updated
30 Sep 2026, 09:25 UTC
Sources at
5e47310
Watches
2 paths
  • daemon/config/services.yaml
  • daemon/docs/standards/PORT_MANAGEMENT.md