Repository navigation
v0.5.0-beta
Pre-release
Pre-release
Added
- USB Device Monitoring: Continuous monitoring of attached USB devices with automatic reattachment on failure.
- Configurable
monitor_interval(10-300s, default 30s) for health check frequency. - Configurable
reattach_retries(0-10, default 3) for device reattachment attempts. - Cooldown period (5 minutes) between failure notifications to prevent spam.
- Home Assistant notifications on device loss and recovery.
- Configurable
- Dependent Add-on Health Monitoring: Monitors health of dependent add-ons and restarts them if they enter error state.
- Configurable
dependent_addonslist withnameandslugfor each add-on. - Configurable
restart_retries(0-10, default 3) for add-on restart attempts. - Automatic restart of failed add-ons (e.g., Zigbee2MQTT, Z-Wave JS) with notifications.
- State change tracking to avoid repeated alerts for ongoing issues.
- Configurable
- Enhanced Monitor Service: New s6 service (
monitor/run) for background device and add-on health monitoring.- Runs every
monitor_intervalseconds, checking device attachment and add-on states. - Integrates with existing event logging and notification systems.
- Runs every
- Improved Error Handling: Better handling of Supervisor API errors and device attachment failures.
- Test Coverage: Increased test coverage to 93% (from 88%) with additional unit tests for error paths.
Changed
- Version Bump: Updated to 0.5.0-beta to reflect new monitoring capabilities.
- README Updates: Added documentation for new configuration options and features.
- Monitor Integration: WebUI now displays dependent add-on health status and allows selection from discovered add-ons.
Fixed
- Dependent Add-on Restart: Fixed issue where add-ons in error state were not automatically restarted. Now properly detects error states and attempts restart with retry logic.
Summary of fixes
| Severity | Count | Key points |
|---|---|---|
| Critical | 2 | Duplicate test class (duplicate tests removed); SIGTERM was swallowed (services now correctly handle SIGTERM) |
| High | 4 | Missing API authentication; version inconsistency between components; monitor module not unit-testable; misconfigured CORS* |
| Medium | 10 | Fixed log de-duplication bug; various race conditions resolved; added missing tests; removed unnecessary Linux capabilities |
| Low | 8+ | Style fixes, updated outdated documentation, cleaned import patterns, removed extraneous emojis |
*Note: The CORS fix restricts the allowed origins for the WebUI to safe values (e.g., localhost/ingress) and prevents unintended cross-origin requests.