Repository navigation
v0.8.2
0.8.2 — 2026-09-08
Upgrade notes
Upgrade the server and CLI/MCP together. Reservation creation now requires
POST /api/reservations with an Idempotency-Key; legacy GET mutations return
405. Stateless CLI reservations also require PORT_LIGHT_REQUEST_KEY.
Both Basic Auth variables must be nonempty, or both must be unset.
Fixed
- Compose ranges support up to 4096 ports per declaration, with a 65536-mapping
scan budget shared across files/includes. Exceeding either limit marks the scan
incomplete instead of silently advertising dropped ports as free. Paired
short-syntax ranges preserve corresponding container ports. - Health responses omit diagnostic file paths while Basic Auth or hidden-port
access is locked, including invalid authentication configurations. - Partial or explicitly empty Basic Auth configuration fails closed with 503;
Unicode credentials and hidden-unlock passwords compare safely as UTF-8. - Reservations now atomically persist an idempotent receipt with the claim.
CLI/MCP save a private recovery key before sending and recover the same claim
and release credentials after a lost response by retrying identical arguments.
Added
port-light requestslists non-secret pending-request metadata;
port-light recover <ID>retrieves still-active claims using GET only, even
beyond the automatic retry window. Failed recovery/token saves retain the journal.- Scan warnings identify the Compose file, range and resource limit with repair
guidance in all seven languages. Diagnostics respect the hidden-data gate. - Client error codes distinguish authentication misconfiguration, unavailable
occupancy, and obsolete mutation interfaces.
Changed
- Partially released requests can recover their remaining claims through GET;
replaying POST still refuses reallocation. Malformed receipts fail closed. - Creating reservations requires
POST /api/reservationswith a secret
Idempotency-Key. Legacy mutating GET suggestions return 405. Upgrade CLI/MCP
alongside the server; read-only GET suggestions continue working. - Stateless CLI reservations (
--no-save --json) require a caller-retained
PORT_LIGHT_REQUEST_KEY. See the CLI guide for recovery and retention limits.