v0.11.0 - Going Gold

This release earns Home Assistant's Gold quality badge. Setup is simpler, some rarely-used sensors default to off, stale devices can be pruned from the device registry, and there is a fix for token-refresh log spam after a network timeout.

Caution

Home Assistant 2026.7.0 or newer required. HACS will not offer this update on older Home Assistant installs. Update Home Assistant first, then let HACS offer this release. Your existing accounts and settings carry over.

What's new

• Reconfigure your two-factor method without re-signing in. Head to Settings > Devices & Services > ENGIE Belgium > Reconfigure and pick SMS or email. Your session and tokens are untouched. The saved preference is used the next time you actually need to re-authenticate.
• Prune stale devices from the device registry. If you removed a business agreement earlier and its device stuck around, you can now delete it from the device page without touching the parent integration.
• Automation and dashboard examples in the README. Ready-to-copy snippets for running appliances during Happy Hours, charging on negative EPEX prices, and getting notified when tomorrow's prices land.
• Known limitations documented. New README section covering the places where the integration cannot reach ENGIE data.
• Debug logging even before setup finishes. Instructions in the Troubleshooting section for turning on debug logs via configuration.yaml, so sign-in and MFA failures leave a trace even when there is no config entry to click on yet.

Changed

• Simpler setup form. The OAuth Client ID field is gone. It never had a reason to be user-editable and is now baked in. Existing installs are unaffected.
• A few sensors are now off by default to keep the entity list tidy. You can enable any of them per-entity if you want them:
  • All _excl_vat price sensors (the pre-VAT variants). Most users only care about the VAT-inclusive number they actually pay.
  • Captar monthly peak energy. The peak power (kW) sensor stays enabled since it is the value that drives your capacity tariff.
  • Captar monthly peak start and end timestamps. These are now categorised as diagnostic entities to make it clear they are contextual detail about the peak.
• Home Assistant floor bumped to 2026.7.0. See the caution above.
• Nicer confirmation message after using Reconfigure. Instead of the generic "Settings updated successfully", you now see which setting was saved and when it takes effect.

Fixed

• No more log spam after a network hiccup during a token refresh. If ENGIE processed a token refresh but your Home Assistant timed out reading the response, the stored refresh token would go stale. Every 60 seconds after that, Home Assistant would try again, get an HTTP 403, and log a "Scheduled token refresh rejected" warning. The 60-second timer is now cancelled the moment the failure is detected. You get exactly one warning and one reauthentication prompt, not one per minute until you notice.

Behind the scenes

• Home Assistant Gold quality scale. All Gold-tier rules met. The integration page in Home Assistant now shows the Gold badge.
• Icons moved into icons.json. No user-visible impact, just cleaner internals.
• Happy Hours enrolment probe now hits ENGIE's targeted boolean-feature-flags endpoint instead of the group-flags endpoint, sending less over the wire on every refresh.
• New debug field added to the token-rotation log line (refresh_token_expires_in), so future reports of "reauth needed every 24 hours" can be diagnosed faster.