v2.0.0b13

🚀 Pre-Release: v2.0.0b13 (Field-Testing Beta)

• Engine Upgrade: Pinned to upstream \OWNd==2.0.0b8\ with the new HMAC authentication refactor.
• CI Modernization: 100% green CI across all 9 workflows, Python 3.14, and HA Core 2026.9.2.
• Privacy Hardening: 100% synthetic, anonymized plant test fixtures.
• Quality Scale: Platinum strict typing and \�ntry.runtime_data\ across all 9 platforms.

For feedback and logs, join the discussion: https://github.com/orgs/OpenWebNet-HA/discussions/409

v2.0.0b9

🚀 Pre-Release: v2.0.0b9 (Phase 1 Architecture Beta)

This release resolves the OpenWebNet Command Translation (WHAT=1000) frame filtering issue (#283) across platform message dispatchers and dynamic discovery.

---

🌟 Key Changes

1. Command Translation (WHAT=1000) Frame Filtering (#283, #284):

   • Entity State Preservation: In BTicino OpenWebNet networks, auxiliary controls, scenario modules, and interfaces generate Command Translation frames (*1*1000#1*53## / *1*1000#0*53##). These frames convey command translation bus traffic rather than confirmed actuator state. Platform handlers in light.py, switch.py, and cover.py now ignore translation frames, preventing light and switch entities from temporarily resetting to unknown state before actuator feedback arrives.
   • Dynamic Discovery Guarding: Prevented Command Translation frames for unconfigured bus addresses from erroneously triggering dynamic light and cover discovery.
   • Active Software Fade Protection: Software-stepped fades in MyHOMELight are shielded from translation frame cancellation.
   • Observability Retained: All Command Translation frames remain captured in BusMonitor and broadcast via the Home Assistant event bus (myhome_message_event) for debugging, diagnostics, and custom user automations.

2. OpenWebNet Golden Corpus Conformance:

   • Extended golden test schema and added verified golden fixtures for light.cmd.translation.on.53 and light.cmd.translation.off.53.
   • Verified 100% protocol conformance across the test suite.

3. Verified Stability & Standards:

   • 1,137 automated unit and integration tests passing.
   • Strict 100.0% statement test coverage verified across all modules.
   • Clean pass on Home Assistant architectural rules and Ruff static analysis.

---

📦 Quick Upgrade Instructions

In your Home Assistant terminal (or via SSH):

cd /config/custom_components
wget -O myhome_b9.zip https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b9/myhome.zip
rm -rf myhome
unzip -q myhome_b9.zip -d myhome
rm myhome_b9.zip
grep '"version"' myhome/manifest.json
ha core restart

(Verify output prints "version": "2.0.0b9" before restarting).

After restarting, perform a hard browser refresh (Ctrl + F5 / Cmd + Shift + R) to ensure frontend assets reload.

---

🔄 Safe Rollback

If you need to revert to the legacy codebase:

• Download 0.9.4 and extract into /config/custom_components/myhome/.
• All configurations remain backward-compatible.

v2.0.0b11

🚀 MyHOME v2.0.0b11 — Phase 2 Architecture Release & Real-World Trace Replay

This major release merges the complete Phase 2 Architecture, achieving strict 100.0% test coverage across 1,294 automated tests, integrating the companion OWNd 2.0.0-b6 engine with native DALI HSV color, and introducing our deterministic Trace Replay Engine with authentic on-wire physical plant fixtures.

🌟 Key Highlights & Architectural Additions:

• Strict 100.0% Test Coverage Enforcement:
  • Full suite expanded to 1,294 automated tests with 100.0% line coverage across all 25 modules (5,090 / 5,090 statements covered).
  • Enforced in CI via zero-tolerance automated coverage gate.
• Companion OWNd 2.0.0-b6 Engine:
  • Transitioned DALI color Dimension 12 to native OpenWebNet HSV encoding (*#1*WHERE*#12*H*S*V*T##) aligned with BTicino F429/F461 gateways.
  • Multi-authority Golden Corpus conformance suite.
  • Fluent CEN / CEN+ scenario pushbutton builders and thermoregulation master coordination.
• Dual-Track Trace Contribution Tooling:
  • Track A (Zero-CLI): Added myhome.sweep_bus service to safely query lighting, covers, HVAC, and RTC, allowing 1-click diagnostic exports directly from Home Assistant UI with automatic credential redaction.
  • Track B (CLI): Added scripts/record_gateway_trace.py for standalone installers and bench testers.
• Dynamic Parameterized CI Replay Engine:
  • Any real-world bus trace dropped into tests/fixtures/plants/ is automatically discovered and replayed in CI.
  • Includes authentic on-wire captures: Plant #247 (70+ devices) and MH200 Physical Plant (107 frames across 62 lights, 7 switches, 11 covers, and F422 cross-bus interface #4#02).
• Hardware-Aware Gateway Engine:
  • Dynamic multi-session concurrency, automatic keepalive, safe socket teardown, and individual profile adapters for modern and legacy gateways (MH200, F454, F461, 3578, MyHomeServer1).

v2.0.0b10

🚀 Pre-Release: v2.0.0b10 (Phase 1 Architecture Beta)

This release addresses Dry Contact & Auxiliary Binary Sensor Duplicate Devices and Unique ID Collisions (#247), resolving issues where empty ghost devices were created on startup and unique IDs collided across reboots.

---

📦 Key Changes

1. Dry Contact Address Normalization & Suffix Stripping (#247, #286):

   • Dynamic Suffix Stripping: Replaced hardcoded device class suffix parsing with dynamic ALL_DEVICE_CLASS_SUFFIXES covering all BinarySensorDeviceClass options in descending length order. Ensures that configured device classes (e.g. class: moving, class: garage_door, class: window) do not bleed into the bus address, preventing invalid bus query frames (*#25*331-moving##) and avoiding duplicate unique ID generation.
   • Single-WHO Device Identifiers: Normalized clean_dev_id when registering device info in MyHOMEEntity to prevent duplicate WHO prefixes (mac-25-31 instead of mac-25-25-31), preventing duplicate empty device creation in Home Assistant's device registry.
   • Targeted CEN/CEN+ Scenario Control Pruning Exemption: Refined empty device pruner on integration startup. Instead of blanket exempting any identifier containing "-25-", the cleanup specifically exempts genuine CEN/CEN+ scenario control models, cleanly pruning empty dry contact devices (0 entities) on reboot.
   • WHO 9 Auxiliary Sensor Restoration: Prioritized auxiliary sensor restoration before motion sensors so that auxiliary channels configured with class: motion are properly restored without unique ID collisions.

2. Verified Stability & Standards:

   • 1,140 automated unit and integration tests passing.
   • Strict 100.0% statement test coverage verified across all 25 modules.
   • Clean pass on Home Assistant architectural rules and Ruff static analysis.

---

📥 Quick Upgrade Instructions

In your Home Assistant terminal (or via SSH):

cd /config/custom_components
wget -O myhome_b10.zip https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b10/myhome.zip
rm -rf myhome
unzip -q myhome_b10.zip -d myhome
rm myhome_b10.zip
grep '"version"' myhome/manifest.json
ha core restart

(Verify output prints "version": "2.0.0b10" before restarting).

After restarting, perform a hard browser refresh (Ctrl + F5 / Cmd + Shift + R) to ensure frontend assets reload.

---

🔄 Safe Rollback

If you need to revert to a previous release:

• Download 2.0.0b9 or legacy 0.9.4 and extract into /config/custom_components/myhome/.
• All configurations remain backward-compatible.

v2.0.0b8

🚀 Hotfix Pre-Release: v2.0.0b8

This release resolves the custom element registration collision with scoped registries / polyfills (#277) and eliminates startup blocking warnings.

---

🌟 Key Changes

1. Self-Healing Custom Element Registration (#277):

   • Root Cause Resolution: When cards utilizing @webcomponents/scoped-custom-element-registry (such as scheduler-card) load after earlier frontend resources, they overwrite the global window.customElements registry with their own scoped registry. Elements registered beforehand are lost in the replacement registry, causing Home Assistant's card picker to throw Custom element not found: myhome-openwebnet-bus-monitor and stall indefinitely on a loading spinner (<ha-spinner>).
   • Active Dynamic Getter: Implemented a dynamic property getter on cardDefinition.type within window.customCards. Whenever Home Assistant's Lovelace card picker iterates over or inspects the card definition, registerCardElements() is invoked synchronously to ensure the custom elements are registered in the currently active registry.
   • Watchdog Interval: Added an active 45-second self-healing interval watcher on window to detect mid-flight registry replacements and re-register myhome-openwebnet-bus-monitor and myhome-bus-card automatically.
   • Global Class Reference: Exposed window.MyHomeBusCard globally to facilitate immediate re-instantiation across dynamic contexts.

2. Asynchronous Engine Synchronization:

   • Offloaded pkg_util.is_installed(required_pkg) in async_ensure_ownd_engine() to hass.async_add_executor_job(), resolving event loop blocking warnings during Home Assistant startup.

---

📦 Quick Upgrade Instructions

In your Home Assistant terminal (or via SSH):

cd /config/custom_components
wget -O myhome_b8.zip https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b8/myhome.zip
rm -rf myhome
unzip -q myhome_b8.zip -d myhome
rm myhome_b8.zip
grep '"version"' myhome/manifest.json
ha core restart

(Verify output prints "version": "2.0.0b8" before restarting).

After restarting, perform a hard browser refresh (Ctrl + F5 / Cmd + Shift + R) to load the updated frontend bundle.

v2.0.0b7

🚀 Hotfix Pre-Release: v2.0.0b7

This release resolves the card picker loading spinner issue (#277) and adds automatic fail-safe card synchronization.

---

🌟 Key Changes

1. Lovelace Card Picker Resolution (#277):

   • Implemented static getStubConfig() on MyHomeBusCard so Home Assistant's card picker resolves initial card configuration cleanly without timing out on element class inspection.
   • Added static getConfigForm() providing visual configuration options (title, max_frames).
   • Enabled preview: true with defensive optional chaining (?.) on all shadow DOM element bindings in _bindEvents().
   • Updated window.customCards registration with in-place deduplication to cleanly handle single-page app tab navigation and cache updates.

2. Dual-Route Static Path Registration & /config/www/ Fail-Safe Sync:

   • Enhanced _async_register_frontend() to register both /myhome_static (directory) and /myhome_static/myhome-bus-card.js (file) with robust fallback support across diverse Home Assistant HTTP server versions (StaticPathConfig).
   • Added _sync_www_card to automatically copy myhome-bus-card.js into /config/www/myhome-bus-card.js upon startup, providing zero-configuration /local/ static serving compatibility.

---

📦 Quick Upgrade Instructions

In your Home Assistant terminal (or via SSH):

cd /config/custom_components
wget -O myhome_b7.zip https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b7/myhome.zip
rm -rf myhome
unzip -q myhome_b7.zip -d myhome
rm myhome_b7.zip
grep '"version"' myhome/manifest.json
ha core restart

(Verify output prints "version": "2.0.0b7" before restarting).

After restarting, perform a hard browser refresh (Ctrl + F5 / Cmd + Shift + R) to load the updated frontend bundle.

v2.0.0b6 (Pre-release)

🚀 MyHOME v2.0.0b6 (Phase 1 Architecture Beta)

This is the sixth Phase 1 Architecture Pre-release for the modernized OpenWebNet MyHOME Home Assistant integration.

Version 2.0.0b6 fixes the duplicate Lovelace Bus Monitor card in the card picker modal, resolves UI event loop warnings, and introduces decoupled integration versioning pinning the protocol engine to OWNd==2.0.0b5.

---

🌟 Key Fixes & Enhancements in 2.0.0b6:

1. Lovelace Bus Monitor Card Picker Deduplication & Lifecycle Fix (#277):

   • Eliminate Duplicate Card Picker Entries: Fixed an issue where "MyHOME Bus Monitor" appeared twice in the dashboard card picker modal (window.customCards). Added robust deduplication and registration idempotency guards.
   • Event Loop & Timing Warnings Resolved: Refactored card registration lifecycle to prevent blocking UI event loops during Lovelace resource auto-discovery.
   • Multi-Tab / Navigation Resilience: Prevented duplicate card prototype registration across dynamic page switches and dashboard reloads.

2. Decoupled Integration & Engine Maintenance:

   • Supported independent integration bugfix and frontend releases while pinning the validated protocol engine OWNd==2.0.0b5.
   • Release validation scripts and runtime engine self-healing updated to verify engine compatibility dynamically.

3. Roadmap & Architecture Alignment:

   • Aligned project documentation and Phase 1 / Phase 2 migration roadmap with community consensus on RFC #248.

4. Verified Stability & Architectural Standards:

   • 984 automated unit and integration tests passing (100% test coverage).
   • Zero violations in Home Assistant architectural validation (scripts/verify_ha_standards.py) and Ruff static analysis.

---

📥 How to Install / Upgrade

Method 1: Terminal & SSH Add-on (⭐ Strongly Recommended)

Open the Terminal in Home Assistant and paste:

cd /config/custom_components
wget -O myhome_beta.zip https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b6/myhome.zip
rm -rf myhome
unzip -q myhome_beta.zip -d myhome
rm myhome_beta.zip
grep '"version"' myhome/manifest.json
ha core restart

(For Home Assistant Container / Docker:)

docker exec -it homeassistant bash -c 'cd /config/custom_components && wget -O myhome_beta.zip https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b6/myhome.zip && rm -rf myhome && unzip -q myhome_beta.zip -d myhome && rm myhome_beta.zip && grep "\"version\"" myhome/manifest.json'
docker restart homeassistant

Method 2: Manual Download

1. Download myhome.zip attached below.
2. Extract directly into /config/custom_components/myhome/.
3. Verify version is 2.0.0b6 in manifest.json.
4. Restart Home Assistant (Settings → System → Restart).
5. Perform a hard refresh in your browser (Ctrl + F5 / Cmd + Shift + R).

---

🔄 Safe Rollback

If you need to revert to the legacy codebase:

• Download 0.9.4 and extract into /config/custom_components/myhome/.
• All configurations remain backward-compatible.

v2.0.0b5 (Pre-release)

🚀 MyHOME v2.0.0b5 (Phase 1 Architecture Beta)

This is the fifth Phase 1 Architecture Pre-release for the modernized OpenWebNet MyHOME Home Assistant integration.

Version 2.0.0b5 delivers major enhancements to the in-band Lovelace Bus Monitor Card, generalises frame and subsystem filtering across all standard OpenWebNet WHO families, and updates the protocol engine to OWNd==2.0.0b5.

---

🌟 Key Fixes & Enhancements in 2.0.0b5:

1. Dynamic & Generalized Bus Monitor Card (myhome-bus-card.js) (#275):

   • WHO=5 Burglar Alarm Filter: Added dedicated subsystem filter and badge styling (.who-alarm deep ruby/crimson) for Burglar Alarm frames (*5*...##).
   • Master OpenWebNet Subsystem Catalog (WHO_CATALOG): Embedded the complete official WHO catalog covering all standard OpenWebNet subsystems:
     • WHO=0: Scenarios (Basic)
     • WHO=1: Lighting / Switches
     • WHO=2: Automation / Shutters
     • WHO=3: Load Control
     • WHO=4: Heating / Thermoregulation
     • WHO=5: Burglar Alarm
     • WHO=6: Door Entry / Access Control
     • WHO=7: Video Door Entry / Multimedia
     • WHO=9: Auxiliary
     • WHO=13: Gateway Management
     • WHO=14: Actuator Diagnostics & Lock
     • WHO=15: CEN Pushbuttons
     • WHO=16: Sound System
     • WHO=17: Scenario Management / MH200N
     • WHO=18: Energy Management
     • WHO=22: Sound Diffusion Extended
     • WHO=24: Lighting Management / DALI
     • WHO=25: CEN+ / Security
     • WHO=1001: Lighting Diagnostics
     • WHO=1004: Heating Diagnostics
     • WHO=1013: Gateway Diagnostics
   • On-The-Fly Dynamic WHO Auto-Registration: Historical and live stream frames with uncataloged, custom, or future firmware subsystems automatically insert themselves into the <select id="filter-who"> dropdown sorted numerically without resetting active user filters, receiving high-contrast deterministic dark-mode HSL badge colors.
   • Multi-Field Search & Prefix Filtering: Search input now scans across WHERE, WHAT, DIMENSION, and RAW frame contents. Supports explicit prefix filtering (e.g. what:1, dim:15, where:12, raw:*5*1*0##).
   • ACK / NACK Direction Filter: Added ACK (*#*1##) and NACK (*#*0##) filter options in the direction selector and backend WebSocket filter handlers to isolate acknowledgments and errors.

2. Decoupled Engine Upgrade (OWNd==2.0.0b5):

   • Pinned and synchronized with OWNd==2.0.0b5 on PyPI.
   • Includes BTicino F461 gateway profile with HMAC authentication and hardware pacing.
   • Includes DALI color temperature (dimension 14) and RGB (dimension 12) protocol primitives.
   • Seamless engine self-healing: automatically verifies and synchronizes the matching PyPI distribution during Home Assistant startup.

3. BTicino F461 Gateway Discovery:

   • Added SSDP auto-discovery for BTicino F461 DALI OpenWebNet gateways.

4. Verified Stability & Architectural Standards:

   • 984 automated unit and integration tests passing.
   • Full compliance with Home Assistant architectural rules and clean 0-violation Ruff static analysis.

---

📥 How to Install / Upgrade

Method 1: Terminal & SSH Add-on (⭐ Strongly Recommended)

Open the Terminal in Home Assistant and paste:

cd /config/custom_components
wget -O myhome_beta.zip $(curl -s https://api.github.com/repos/OpenWebNet-HA/MyHOME/releases | grep -m1 -o 'https://[^"]*myhome\.zip')
rm -rf myhome
unzip -q myhome_beta.zip -d myhome
rm myhome_beta.zip
ha core restart

(For Home Assistant Container / Docker:)

docker exec -it homeassistant bash -c 'cd /config/custom_components && wget -O myhome_beta.zip $(curl -s https://api.github.com/repos/OpenWebNet-HA/MyHOME/releases | grep -m1 -o "https://[^\"]*myhome\.zip") && rm -rf myhome && unzip -q myhome_beta.zip -d myhome && rm myhome_beta.zip'
docker restart homeassistant

Method 2: Manual Download

1. Download myhome.zip attached below.
2. Extract directly into /config/custom_components/myhome/.
3. Restart Home Assistant (Settings → System → Restart).

---

🔄 Safe Rollback

If you need to revert to the legacy codebase:

• Download 0.9.4 and extract into /config/custom_components/myhome/.
• All configurations remain backward-compatible.

v2.0.0b4 (Pre-release)

🚀 MyHOME v2.0.0b4 (Phase 1 Architecture Beta)

This is the fourth Phase 1 Architecture Pre-release for the modernized OpenWebNet MyHOME Home Assistant integration.

Version 2.0.0b4 is a consolidated release that brings together all hotfixes, migrations, and protocol enhancements from today's testing cycle into a single, cohesive milestone pinned to OWNd==2.0.0b4.

---

🌟 Key Fixes & Enhancements in 2.0.0b4:

1. Zero-Ambiguity Runtime Version Identity:

   • Startup Log Banner: Prominently logs Initializing MyHOME integration v2.0.0b4 (OWNd v2.0.0b4) on Home Assistant startup and gateway setup.
   • Enriched Diagnostics: System diagnostics exported from Home Assistant now explicitly include integration_version and ownd_version.
   • Lovelace Bus Monitor: The in-band bus monitor card now displays the exact running version in its stats header and automatically injects both the integration and OWNd versions into generated GitHub bug reports.

2. Self-Healing Button Entity Migration (#269):

   • Restored canonical unique ID format {mac}-{who}-{where}-disable and {mac}-{who}-{where}-enable matching v0.9.4.
   • On startup, the integration automatically heals duplicate _2 button entities (button.*_lock_2), pruning the duplicates and restoring user automations seamlessly.

3. Climate Friendly Name Restoration (#268):

   • Restored multi-tier friendly name resolution for climate zones defined in legacy myhome.yaml.
   • Prevents zones from reverting to generic fallback names like Climate Zone 1.

4. Temperature Probe Discovery & Dimension 15 Support (#264):

   • External temperature probes (WHERE >= 100) are now automatically discovered as native sensor temperature entities (Probe {where} Temperature).
   • Pairs with OWNd 2.0.0b4 to parse WHO=4 Dimension 15 probe telemetry (*#4*WHERE*15*VAL1*VAL2*VAL3##).
   • Prevents probes from being mistakenly created as climate entities.

5. Lovelace Card Browser Cache-Busting (#262):

   • Introduced SHA-256 content-hash versioning on the Lovelace resource URL (?v=<hash>), ensuring browsers immediately load the updated JavaScript card without needing manual browser cache flushes.

6. Verified Stability & 100% Test Coverage:

   • 974 automated unit and integration tests passing.
   • Strict 100.0% statement test coverage verified across all 25 modules (4,552 / 4,552 statements).
   • Zero violations in Home Assistant architectural validation and Ruff static analysis.

---

📥 How to Install / Upgrade

Method 1: Terminal & SSH Add-on (⭐ Strongly Recommended)

Open the Terminal in Home Assistant and paste:

cd /config/custom_components
wget https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b4/myhome.zip -O myhome_beta.zip
rm -rf myhome
unzip -q myhome_beta.zip -d myhome
rm myhome_beta.zip
ha core restart

(For Home Assistant Container / Docker:)

docker exec -it homeassistant bash -c "cd /config/custom_components && wget https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b4/myhome.zip -O myhome_beta.zip && rm -rf myhome && unzip -q myhome_beta.zip -d myhome && rm myhome_beta.zip"
docker restart homeassistant

Method 2: Manual Download

1. Download myhome.zip attached below.
2. Extract directly into /config/custom_components/myhome/.
3. Restart Home Assistant (Settings → System → Restart).

---

🔄 Safe Rollback

If you need to revert to the legacy codebase:

• Download 0.9.4 and extract into /config/custom_components/myhome/, or redownload via HACS.
• All configurations remain backward-compatible.

v2.0.0b3 (Pre-release)

🚀 MyHOME v2.0.0b3 (Phase 1 Architecture Beta)

This is the third Phase 1 Architecture Pre-release for the modernized OpenWebNet MyHOME Home Assistant integration.

🌟 Key Fixes & Improvements in 2.0.0b3:

1. Rate-Limit Logging Flood & High-Frequency Watchdog (#263):
   • Demoted non-actionable unhandled bus frame logs from WARNING to DEBUG, eliminating log spam and avoiding Python logging watchdog warnings (200 messages since last count).
   • Corrected OpenWebNet WHO=4 temperature probe filtering: external slave probes (WHERE >= 100) are no longer falsely discovered as active climate thermostat entities.
2. Fix Climate Entity Initialization Crash (#264):
   • Fixed crash (ValueError: 'unknown' is not a valid HVACMode) occurring during startup when Home Assistant restores an 'unknown' state for previously inactive climate zones.
   • Gracefully normalizes unknown restored state to HVACMode.OFF until fresh physical bus status frames arrive.
3. Lovelace Bus Monitor Card Picker & Resource Auto-Registration (#266, #262):
   • Added MyHOME Bus Monitor to the Lovelace card picker UI for easy discovery and addition to dashboards.
   • Hardened Lovelace JS resource auto-registration with delayed retry mechanisms and fallback for cold HA restarts.
4. Verified Stability & 100% Test Coverage:
   • Expanded test suite to 954 automated unit tests (100.0% statement coverage across all 25 modules).
   • Strict adherence to Home Assistant 2025/2026 architectural standards.

---

📥 How to Install / Upgrade via HACS:

1. Open HACS in Home Assistant -> Integrations -> MyHome.
2. Click the three dots (⋮) in the upper-right corner and select Redownload.
3. Enable "Show beta versions" (or ensure the beta switch entity is ON).
4. Select version 2.0.0b3 and click Download.
5. Restart Home Assistant.

---

💻 Fast Terminal One-Liner (Terminal & SSH Add-on):

cd /config/custom_components
wget https://github.com/OpenWebNet-HA/MyHOME/releases/download/2.0.0b3/myhome.zip -O myhome_beta.zip
rm -rf myhome
unzip -q myhome_beta.zip -d myhome
rm myhome_beta.zip
ha core restart

---

🔄 Safe Rollback:

If you need to revert to the legacy codebase:

1. HACS -> MyHome -> Redownload -> select 0.9.4 -> Download.
2. Restart Home Assistant.