UniFi Etherlighting v0.5.0

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.

UniFi Etherlighting v0.4.0

• Added native Home Assistant color pickers for VLAN/network Etherlighting colors.
• Added color pickers for FE, GbE, 2.5GbE, 5GbE, and 10GbE link speeds.
• Color writes reproduce the confirmed UniFi UI setting update and unchanged Device refresh sequence.
• Every color write is independently read back and fails closed on unexpected changes.
• Added reversible live-capture evidence, offline validation, and regression coverage.

v0.3.1

Added repository-local HACS brand artwork and completed public repository metadata.
Includes the verified Breathing and Speed/Network controls from v0.3.0.
All control writes remain exact-version-bound, single-field, and read-back verified.

Post-release validation:

• Installed through HACS and activated by a full Home Assistant restart.
• Breathing passed off -> on -> off.
• Mode passed network -> speed -> network.
• Brightness stayed unchanged throughout.
• No integration errors or active Repairs were detected.

v0.3.0

Added verified Breathing mode control.
Added verified Speed/Network mode selection.
Each change uses the confirmed full UI payload, changes exactly one allowlisted field, and is independently read back.
Network and port colors remain unchanged and unsupported.

v0.2.6

• Enables verified Etherlighting brightness writes for the exact validated compatibility tuple.
• Mirrors the live-confirmed UniFi UI initialization for the previously absent boolean field while preserving an existing value.
• Keeps full-payload projection, single-shot writes, independent read-back, and ambiguous-write blocking.
• Exposes confirmed write readiness through safe diagnostics.
• Adds regression coverage for missing, present, and invalid field values.

v0.2.5

• Brightness remains readable while production writes are explicitly blocked.
• Added defense-in-depth write gates for the Number entity, Brightness service, and Device adapter.
• Added safe diagnostics and a Repair for incomplete confirmed write configuration.
• Added regression coverage ensuring no write-related network operation is reached.
• Documented the sanitized UI field-source capture; the unresolved field is not invented or defaulted.

v0.2.4

Fixed

• Read the Network Application version from the live-confirmed $.system.version response path.
• Classify version-schema mismatches with security-safe subreasons.
• Log only allowlisted field names and JSON types, never response values or session data.
• Added regression coverage for the confirmed schema and fail-closed config-flow behavior.

No controller-write behavior was changed.

v0.2.3

• Adds safe stage-specific config-flow diagnostics for session, login, Network-version read, Device read, compatibility filtering, and logout.
• Preserves existing authentication, permission, TLS, timeout, connection, Site, and compatibility error classes.
• Logs only the validation stage, safe category, exception type, and optional numeric HTTP status.
• Adds regression coverage proving exception messages and sensitive values are not logged.

v0.2.2

• Successful controller login is no longer masked by logout failures.
• Missing UniFi account permissions are reported separately.
• Added config-flow regression coverage.

UniFi Etherlighting v0.2.1

Fix Home Assistant config flow schema serialization for the UniFi Site field.