Standards

S003 — Port Management

Canonical port table with prod/test/release offsets.

S003 — Port Management (v2026-08-02T101544Z-ab2bbdebf5) 2026-08-01 | Canonical port table with prod/test/release offsets. 1 - PORT ALLOCATION - Port allocation and management daemon/config/services.yaml port_pool services daemon/src/main.py __init__ _find_available_port Environment Variables KEVIN_PORT_DAEMON KEVIN_TEST_PORT_DAEMON KEVIN_RELEASE_PORT_DAEMON port configura… environment va… 1. Load port configuration from serv… 2. Set environment variables for eac… 3. Initialize services with their re… 4. Check if the allocated port is av… 5. Start services using the assigned… Port Configuration in services.yaml services: daemon: port: 8001 test_port: 18001 release_port: 28001 Environment Variable Example export KEVIN_PORT_DAEMON=8001 export KEVIN_TEST_PORT_DAEMON=18001 export KEVIN_RELEASE_PORT_DAEMON=28001 The source does not show any interaction with external dependencies or third-party services beyond environment variables. 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

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-08-02T101544Z
From commit
ab2bbdebf5
Watches
2 paths
  • daemon/config/services.yaml
  • daemon/docs/standards/PORT_MANAGEMENT.md