release: qualify the 0.9.6 notes for the explicit-choice fix and legacy stored zones

This commit is contained in:
2026-09-28 23:44:23 -04:00
parent b792ba50c1
commit 8a5872c728
+15 -5
View File
@@ -5,7 +5,8 @@
### Scope ### Scope
Patch release carrying the household time-zone fix onto `main` (PR #275, task Patch release carrying the household time-zone fix onto `main` (PR #275, task
6351b36d "Time zone errors"). 6351b36d "Time zone errors"), plus its release-review correction (PR #277, task
45243478).
### Behaviour ### Behaviour
@@ -20,8 +21,10 @@ Patch release carrying the household time-zone fix onto `main` (PR #275, task
while it is sleeping, and re-reads the stored zone before sweeping, so it no while it is sleeping, and re-reads the stored zone before sweeping, so it no
longer fires at the old (UTC) rollover. longer fires at the old (UTC) rollover.
- An admin-chosen zone — including an explicit choice of empty (API-host local) - An admin-chosen zone — including an explicit choice of empty (API-host local)
— still wins over the reported zone. An invalid reported zone is logged and — still wins over the reported zone: any admin update that supplies
ignored; the panel keeps serving on the stored settings. `timezone` is recorded as an explicit choice (`timezone_configured` true). An
invalid reported zone is logged and ignored; the panel keeps serving on the
stored settings.
### Requirements ### Requirements
@@ -33,11 +36,18 @@ Patch release carrying the household time-zone fix onto `main` (PR #275, task
database backup is required for this release. database backup is required for this release.
- Deployment note: this fix needs BOTH the API service and the HA integration - Deployment note: this fix needs BOTH the API service and the HA integration
upgraded. The integration supplies the zone and the API adopts it; upgrading upgraded. The integration supplies the zone and the API adopts it; upgrading
only one side leaves the previous behaviour. An install whose `timezone` was only one side leaves the previous behaviour. An install that sets or clears
previously set — or explicitly cleared to host-local — keeps that choice. its zone on 0.9.6 or later keeps that choice; see Known limitations for a zone
stored by an older release.
### Known limitations ### Known limitations
- A zone stored by a release before 0.9.6 without the explicit-choice marker
(for example through the previously documented
`PATCH /api/v1/admin/settings {"timezone": ...}`) is not distinguishable from
an automatically adopted value, so 0.9.6 adopts Home Assistant's reported zone
over it once. If a zone different from Home Assistant's is intended, re-save
it in the admin Preferences, which now records the explicit choice.
- If `timezone` is empty and `timezone_configured` is true (an explicit - If `timezone` is empty and `timezone_configured` is true (an explicit
"host local" choice), that choice is respected and the API host's zone (UTC "host local" choice), that choice is respected and the API host's zone (UTC
on the standard deployment) still applies until an admin selects a zone in on the standard deployment) still applies until an admin selects a zone in