Skip to content

Controlel Home Assistant Integration v0.12.0

Choose a tag to compare

View all tags
@marsa99 marsa99 released this 21 Aug 19:28
· 106 commits to main since this release
v0.12.0
ae0b736

Controlel Home Assistant Integration v0.12.0

This release introduces the first public foundation for the new Controlel Setup / Discovery / Import architecture and prepares the integration for a future graphical setup workflow.

Highlights

  • Added the new module-neutral Setup foundation.
  • Added deterministic Home Assistant discovery for floors, areas, devices, and entities.
  • Added stable provider references based on Home Assistant registry identities.
  • Entity renames can now be resolved without treating them as new devices.
  • Missing, recreated, ambiguous, and ephemeral bindings are handled explicitly.
  • Added Heating recommendation and validation flow over real Home Assistant discovery data.
  • Recommendations remain advisory only and never silently become user-confirmed bindings.
  • Incomplete Heating setup drafts can be persisted and resumed later.
  • Added structured validation and activation-readiness reporting.
  • Added canonical configuration revisions with deterministic serialization, hashing, lineage, and provenance.
  • Added durable Home Assistant-backed setup persistence.
  • Added restart/resume support for incomplete setup workflows.
  • Added frontend-neutral Setup DTOs for the upcoming graphical wizard.
  • Added safe activation contracts, last-known-good rollback foundations, and explicit runtime-readiness evidence.
  • Added REAL / SHADOW configuration isolation and explicit Shadow binding substitution contracts.
  • Expanded release validation, packaging, public-Core verification, and reproducibility checks.

Home Assistant setup foundation

The new Setup backend can now:

  • discover Home Assistant registry structure;
  • recommend suitable Heating bindings;
  • preserve explicit user confirmation;
  • save incomplete configuration;
  • reopen and continue an existing draft;
  • validate configuration using structured issues;
  • canonicalize valid configuration without activating it;
  • distinguish active configuration, configuration health, and loaded runtime revision.

The graphical setup frontend is not yet part of this release.

Safety and compatibility

  • Existing version-1 Home Assistant config entries remain supported.
  • Existing legacy configuration continues through the current runtime path.
  • Canonical Setup configuration is never merged with legacy options.
  • Runtime activation of the new canonical Setup configuration is intentionally not exposed yet.
  • Existing heating safety, minimum ON/OFF, anti-cycling, recovery, and reconciliation behavior remains preserved.

Core dependency

Home Assistant Integration 0.12.0 requires:

controlel==0.12.0

The Core package is published independently on PyPI and is pinned exactly by this integration release.

Verification

This release was validated with:

  • Core/release test suite
  • Home Assistant adapter tests
  • real Home Assistant framework tests
  • Setup workflow and discovery tests
  • Shadow simulation tests
  • Ruff lint and formatting
  • release metadata validation
  • deterministic HACS archive builds
  • public immutable Core verification

Release artifact

controlel.zip

SHA-256:

01009f0c9daa09910b5fdb871b878cc9fed41505cb2767de07e8f2b72d4d4372

What's next

Upcoming work will connect the new Setup backend to the graphical Controlel setup wizard and continue building the first cohesive Home Assistant user interface.

Controlel remains free and open source.

Assets 4
Loading