Controlel Home Assistant Integration v0.14.1

HACS submission readiness patch for Controlel Home Assistant Integration 0.14.1.

• Adds local Controlel brand assets for HACS.
• Removes the temporary HACS brands validation exception.
• Updates release and installation metadata.
• Keeps the exact Core dependency controlel==0.18.0.
• No Heating, Water, configuration, persistence, migration, or runtime behavior changes.

Minimum Home Assistant version: 2026.7.3.

Controlel Home Assistant Integration v0.14.0

Home Assistant integration 0.14.0.

• Exact source commit: fea69d1
• Exact Core dependency: controlel==0.18.0 (already published separately)
• Minimum Home Assistant version declared by HACS: 2026.7.3
• Installable HACS asset: controlel.zip
• SHA-256: bdf360ae114afff4f8cd0b379dc189fe14c91c7162f49df74d15319cd1e3ebec

Post-merge Tests, Packaging, Hassfest and Integration release validation passed on the exact source commit, including published-Core adapter/framework tests and HACS validation. Two Linux builds from the immutable commit export reproduce the CI ZIP byte-for-byte.

Assets contain only the integration runtime files at archive root. This release does not publish a Core package. Manual installation and lifecycle verification in a clean Home Assistant/HACS instance remain to be performed.

Controlel Home Assistant Integration v0.12.0

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.

Controlel Home Assistant Integration v0.11.0

Controlel Home Assistant Integration v0.11.0

Major notification architecture migration to Controlel Core 0.10.0.

UserActivity-driven notifications

Notifications now follow the canonical pipeline:

OperationalEvent
→ UserActivity
→ Notification

Technical runtime events are composed into human-meaningful activities before notification selection.

Improvements

• Meaningful activity-based notification semantics
• Source correction is reported as one composed activity instead of multiple technical events
• Safety grace/reconciliation bookkeeping no longer creates standalone Operational noise
• Normal heating start/stop is available at Detailed level
• Operational recipients no longer receive routine heating start/stop
• Activity lifecycle/status/outcome-aware notification deduplication
• Human-readable activity notification rendering
• UserActivity diagnostics and schema-2 notification diagnostics
• Exact Core 0.10.0 dependency

Core dependency

• Controlel Core 0.10.0

Compatibility

• Existing notification recipient configuration remains compatible
• Config-entry version remains 1
• No migration is required

Release artifacts

• controlel.zip
• controlel.zip.sha256

Controlel Home Assistant Integration v0.10.1

Controlel Home Assistant Integration v0.10.1

Presentation-only patch for M31B notifications.

Fixed

• Human-readable localized notification titles and messages
• Safe interpolation of known structured notification parameters
• Generic fallback when a translation is unavailable
• Raw notification_title_* / notification_message_* keys are no longer shown to users

Unchanged

• Notification selection and levels
• Deduplication
• Cursor and overflow accounting
• Rate limiting
• CRITICAL emergency ceiling
• Control/runtime behavior
• Entity identities
• Config-entry version

Core dependency

• Controlel Core 0.8.0

Release artifacts

• controlel.zip
• controlel.zip.sha256

Controlel Home Assistant Integration v0.10.0

Controlel Home Assistant Integration v0.10.0

Feature release adding the M31B Smart Notifications foundation.

Highlights

• Updated to immutable public controlel==0.8.0
• Added integration-owned smart notification configuration
• Added per-recipient notification levels and category filtering
• Added Home Assistant notify transport
• Notifications are disabled by default
• Added semantic deduplication and bounded rate limiting
• Added independent CRITICAL emergency anti-storm protection
• Added truthful notification source cursor and overflow accounting
• Added single coalesced notification drain task
• Added notification diagnostics with redacted transport targets
• Notification delivery is isolated from heating/control behavior
• No entity identity changes or config-entry migration

Notification levels

• Critical
• Operational
• Detailed
• Debug

Deferred

• Dedicated Controlel sidebar UI
• Notifications UI page
• Persistent notification history
• Quiet hours
• Recipient CRUD/test-notification application APIs
• Statistics/analytics

Core dependency

• Controlel Core 0.8.0

Release artifacts

• controlel.zip
• controlel.zip.sha256

Controlel Home Assistant Integration v0.9.0

Controlel Home Assistant Integration v0.9.0

Feature release adding the M31A Operational Events Foundation to Home Assistant diagnostics.

Highlights

• Updated to immutable public controlel==0.7.0
• Added bounded operational event stream to downloaded diagnostics
• Added deterministic event categories, severities, ordering, and retention metadata
• Added supervision campaign correlation across fatal → failsafe → restart → recovery
• Added normal and failsafe source-command event visibility
• Preserved strict separation between commands, reported source state, and physical operation
• Operational events remain diagnostics-only in this release
• No new entities, config migration, persistence, notifications, or statistics

Core dependency

• Controlel Core 0.7.0

Release artifacts

• controlel.zip
• controlel.zip.sha256

Controlel Home Assistant Integration v0.8.2

Controlel Home Assistant Integration v0.8.2

Stabilization release focused on Home Assistant runtime safety, source transition protection, and diagnostics usability.

Highlights

• Fixed blocking package-metadata I/O during Home Assistant setup
• Added truthful reported source transition timestamps
• Manual/external source transitions now respect minimum ON/OFF protection
• Preserved startup/reload unknown-transition conservative hold behavior
• Added authoritative EntityReference.md
• Added documentation coverage checks for public entities
• Improved binary entity presentation to YES / NO while preserving raw HA on/off semantics

Core dependency

• Controlel Core 0.6.0

Release artifacts

• controlel.zip
• controlel.zip.sha256

Controlel Home Assistant Integration v0.8.1

Controlel Home Assistant Integration v0.8.1

Stabilization release focused on runtime resilience and Home Assistant integration safety.

Highlights

• Updated to immutable public controlel==0.6.0
• Added runtime supervision and failsafe host integration
• Added truthful reported heat-source state ingestion
• Fixed Home Assistant thread-safety for entity state publication
• Added automatic bounded runtime recovery with protected failsafe operation
• Preserved config-entry version 1 and existing entity identities

Core dependency

• Controlel Core 0.6.0

Release artifacts

• controlel.zip
• controlel.zip.sha256

Controlel Home Assistant Integration v0.8.0

Controlel Home Assistant Integration v0.8.0

This release adds the M30.1C heating diagnostics and explainability layer to the Home Assistant integration.

Highlights

• Heating performance diagnostics per zone
• Shadow diagnostics pipeline health
• Bounded and stable diagnostic entities
• Improved operational observability and explainability
• Uses immutable controlel==0.5.0
• Existing config entries remain compatible (config-entry version 1)

Core dependency

• Controlel Core 0.5.0