Repository navigation
Scheduling Manager v2.0.2: async timezone loading and timeout recovery
Async-safe scheduling and reliable timeout recovery
This patch addresses the Home Assistant event-loop blocking issue identified in
the HACS review and includes the dashboard recovery fixes already on main.
Backend fixes
- Resolve the configured timezone with
await dt_util.async_get_time_zone(...)
and pass the resolved object through scheduling, one-offs, activity, solar and
local-deadline helpers. No integration module constructsZoneInfodirectly. - Refresh the resolved timezone through the serialized environment cutover,
discarding superseded resolutions and retaining consistent state if saving fails. - Preload Astral through Home Assistant's async import helper before synchronous
solar calculations, avoiding conditional first-use imports on the event loop. - Treat exceptions with empty messages, including service timeouts, as failures.
Failed one-off Stops remain pending across restart and complete on recovery
without repeating Start. Empty-message storage failures remain visible too.
Dashboard fixes
- Recover automatically after Home Assistant restarts, including when the browser
reuses its connection object. Reads and subscriptions retry with backoff and
show a friendly waiting status while the integration starts. - Avoid a synthetic touch click accidentally applying a newly opened time popup.
- Version both the registered loader URL and its inner card import as 2.0.2
so the release can replace a cached older loader.
Updating
For an existing 2.0 installation, update through HACS, restart Home Assistant once,
then refresh the dashboard. No integration re-add or domain migration is needed.
For upgrades from 1.x, follow the
one-time migration guide.
Do not delete the old integration entry before migration.
Integration and card versions are both 2.0.2. Minimum Home Assistant version
remains 2026.7.0. The attached ZIP is the manual-install fallback; HACS installs
the integration directory, including its bundled card.
Verification
- Release-commit CI
covers HA 2026.7.0, 2026.8.1, 2026.9.4 and 2026.10.1, frontend,
HACS and hassfest. - 237 backend tests, 26 frontend unit tests and 88 Chromium tests.
- Fresh-process native file-I/O audits cover cold timezone/Astral loading,
Save, public/activity reads, local deadlines and timezone changes. The exercised
paths have no integration loop file I/O, integration warnings/errors or HA
blocking-call reports on all four supported versions. - Local combined line/branch coverage on HA 2026.8.1: 96.29%, above the
unchanged 95.1% gate. Ruff, selected formatting, mypy and official hassfest pass. - Isolated HACS-only installation/served-card check passes. The deterministic
release ZIP contains matching payloads, public documentation and license notices;
all ZIP CRCs and paths were validated. - Verification uses temporary HA configurations and mocked services. This release
has not been deployed to the maintainer's production HA instance.
Full changelog: v2.0.1...v2.0.2