Skip to content

Scheduling Manager v2.0.2: async timezone loading and timeout recovery

Choose a tag to compare

@flatsheep flatsheep released this 24 Oct 21:43

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 constructs ZoneInfo directly.
  • 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