Highlights
- Survives compatible UniFi Network 10 patch and minor updates by validating the live API contract instead of pinning one exact version.
- Fails closed on future API majors or changed/missing Device fields.
- Adds Home Assistant reauthentication when local UniFi credentials change.
- Adds safe compatibility diagnostics, Repairs guidance, public issue templates, and weekly HACS/Home Assistant validation.
Live validation
Validated after upgrading UniFi Network from 10.5.62 to 10.5.66. Brightness, breathing, mode, one network color, and one link-speed color all passed reversible write/read-back tests and were restored to their original values.
All 97 tests, Ruff, JSON checks, capture security validators, HACS validation, and Home Assistant validation passed.