REL-0.13.0 review: plainer, truer 0.13.0 changelog

Crash, not stop, for SAFETY-61; Watchdog off by default; its own
warning for the 50 W peak margin (also under a higher month peak);
"refuses power" for SAFETY-52/73; no one-house options claim.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

goodwe_controller/CHANGELOG.md

@@ -2,41 +2,47 @@
 
 ## 0.13.0
 
-**A minor bump: new behaviour, a new settings page, and six new options.**
+**A minor bump: new behaviour, a new add-on page (Home, Settings, Batteries,
-No option was removed or renamed, and no default of an existing option
+Setup), and six new options.** No option was removed or renamed, and no
-changed (77 options -> 83). The live options blob on record passes this
+default of an existing option changed (77 options -> 83). The only new
-version's validator (`tools/predeploy_check.py`, offline).
+start-up checks are on the new options, so options that start 0.12.0 also
+start 0.13.0.
 
 New options, and what they do if you leave them alone:
 
 | option | default | left alone |
 |---|---|---|
-| `peak_margin_w` | `50` | the peak guard aims 50 W below your peak limit; set `0` for the old aim ([[SAFETY-79]]) |
+| `peak_margin_w` | `50` | the peak guard aims 50 W below your peak limit, or below a higher peak already reached this month; `0` is the old aim ([[SAFETY-79]]) |
 | `battery_modes_enabled` | `false` | no battery modes, control as before ([[OPT-11]]) |
 | `pv_forecast_entity`, `pv_forecast_tomorrow_entity` | empty | no solar forecast is used ([[OPT-11]]) |
 | `solar_trust_pct` | `70` | only used with a solar forecast ([[OPT-11]]) |
 | `pv_invert_entities` | `[]` | PV readings as before ([[TEL-14]]) |
 
-⚠️ **Turn on Watchdog** on the add-on's Info tab. If control stops, the
+⚠️ **Turn on Watchdog** on the add-on's Info tab. It is off by default. If
-add-on now sets the batteries to 0 W and exits; Home Assistant only starts it
+the control loop crashes, the add-on now sets the batteries to 0 W and stops.
-again when Watchdog is on ([[SAFETY-61]], [[DOC-5]]).
+Home Assistant only starts it again when Watchdog is on ([[SAFETY-61]],
+[[DOC-5]]).
+
+⚠️ **The peak guard now starts a little earlier.** It aims 50 W below your
+peak limit, so the batteries give a bit more at peak times. Set
+`peak_margin_w: 0` for the old aim ([[SAFETY-79]]).
 
 Contents of this release, in merge order since 0.12.0 (`a45ed06`):
 
 | | |
 |---|---|
 | `fa3d237` | Docs name the right P1 age entity and a battery list that starts ([[DOC-1]]) |
-| `6e65272` | If control stops, the batteries go to 0 W and the add-on exits ([[SAFETY-61]]) |
+| `6e65272` | If the control loop crashes, the batteries go to 0 W and the add-on stops ([[SAFETY-61]]) |
-| `3e38baf` | The check tools refuse a file they cannot read, instead of saying all clear ([[SAFETY-60]], [[SAFETY-62]]) |
+| `3e38baf` | The check tools refuse a file they cannot read, instead of saying all clear (tools only) ([[SAFETY-60]], [[SAFETY-62]]) |
 | `43b2740` | A missing value in a check is a named failure (tests only) ([[TEST-26]]) |
 | `20260e8` | Docs: turn on Watchdog ([[DOC-5]]) |
 | `16c796f` | New option `pv_invert_entities`: flip the sign of a PV sensor that reads backwards ([[TEL-14]]) |
 | `6a8a5ff` | CI tests against the real inverter simulator (CI only) ([[CI-12]]) |
 | `82f032e` | CI pin checks report failures properly (CI only) ([[TOOL-9]]) |
 | `fe13251` | CI pin update (CI only) |
-| `397dd15` | Alarm cards come back after a Home Assistant restart ([[SAFETY-34]]) |
+| `397dd15` | Alarm notifications that are still active come back after a Home Assistant restart ([[SAFETY-34]]) |
 | `59415ea` | CI pin update (CI only) |
-| `2503de1` | The integrator limit is a warning, not a "bug" alarm; alarm figures are correct ([[SAFETY-40]]) |
+| `2503de1` | "Battery is not keeping up" is a warning with its own notification, not a "bug" alarm; its figures are correct ([[SAFETY-40]]) |
 | `48ef06a` | Shorter, plainer notifications ([[UX-08]]) |
 | `5c151a3` | CI pin update (CI only) |
 | `d57767f` | Shorter, plainer status rows and banners ([[UX-08]]) |
@@ -47,10 +53,10 @@ Contents of this release, in merge order since 0.12.0 (`a45ed06`):
 | `2b14b88` | Last plain-language fixes in logs and the status page ([[UX-10]]) |
 | `c4032eb` | CI pin update (CI only) |
 | `d1f7e33` | Safety log lines: one plain sentence and a code ([[UX-11]]) |
-| `652097a` | A battery that stops responding is asked for 0 W, with a 200 W test every 15 min ([[SAFETY-52]]) |
+| `652097a` | A battery that refuses power (e.g. empty) is asked for 0 W, and tried at 200 W for 34 s every 15 min ([[SAFETY-52]]) |
 | `afd6af0` | Groundwork for the new settings pages ([[UX-13]]) |
 | `a36dca6` | New page with a Home screen ([[UX-13]]) |
-| `28a49cc` | With two or more inverters, a battery that stops responding is held on its own ([[SAFETY-73]]) |
+| `28a49cc` | With two or more inverters, a battery that refuses power is held on its own; the others take over ([[SAFETY-73]]) |
 | `515c11b` | New Installer settings view ([[UX-13]]) |
 | `4de9675` | New setup wizard for installers ([[UX-13]]) |
 | `8c34647` | A new install with no inverter opens the setup wizard instead of stopping ([[UX-15]]) |
@@ -67,7 +73,7 @@ Contents of this release, in merge order since 0.12.0 (`a45ed06`):
 | `4ad8298` | Maintenance charge with two batteries no longer stalls; it gives way to the peak guard ([[SAFETY-84]]) |
 | `b8ddfd7` | The peak guard wins over the maintenance hold; the hold ends on time, with no top-up ([[SAFETY-86]]) |
 | `9358781` | With two or more batteries, the peak guard uses every battery that can still give; peak alarms no longer say control stopped ([[SAFETY-87]]) |
-| `61072ca` | No false "Battery is not keeping up" during maintenance; real shortfalls still warn; the counter counts episodes ([[SAFETY-85]]) |
+| `61072ca` | No false "Battery is not keeping up" during maintenance; real shortfalls still warn; the status row counts each episode once ([[SAFETY-85]]) |
 
 ### Known issues