senyo888 · Nov 11, 2026 · Nov 8, 2026 · Nov 8, 2026 · Nov 9, 2026 · Nov 9, 2026
@@ -6,7 +6,13 @@ All notable changes to Humidity Intelligence will be documented in this file.
 
 This project follows a practical changelog format for Home Assistant and HACS users. Add new entries under a fresh `Unreleased` section before publishing a future release.
 
-## v2.1.2 — Stable source preparation
+<a id="v212--stable-source-preparation"></a>
+
+## v2.1.2 — Stable (2026-11-08)
+
+[Published release and downloads](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2). The verified
+80-file install ZIP matches the accepted Stable-instance package; final Marketplace
+discovery and installation remain separate observations.
 
 **Home Assistant 2026.11 Harmonization.** Includes component ZIP delivery,
 Marketplace/HACS observation, canonical AQ units, complete-evidence CO clearance,
@@ -62,15 +68,19 @@ The lifecycle package `8cdd3ae` passed fresh native Lab setup and manual
 Stable-instance acceptance with all 80 files verified, five valid card exports
 and no failed checks. Stalled-unload behavior has native regression coverage;
 it was not fault-injected live, and physical output response was not tested.
-Published Stable remains v2.1.1; final published delivery is still separate.
+The final `9f52a22` component passed its own Stable acceptance with 80 files
+verified, 13 passes, 3 explained warnings and no failures. Published tag `v2.1.2`
+at `7b578f5` contains those same component bytes. Final Marketplace installer
+delivery remains separate from package verification and manual acceptance.
 
 Thanks to [@Slaybcn](https://github.com/Slaybcn) for reporting the Marketplace
 installation failure and sharing logs in [#145](https://github.com/senyo888/humidity-intelligence/issues/145),
 and to [@Thorsten1982](https://github.com/Thorsten1982) for confirming the same issue.
 
 ## v2.1.2-beta.1 — Beta prerelease (2026-11-07)
 
-Opt-in prerelease from `senyo888-patch-1`; `main` and Current Stable v2.1.1 are unchanged.
+Historical opt-in prerelease from `senyo888-patch-1`; at its publication, `main`
+and then-current Stable v2.1.1 were unchanged.
 [Release and downloads](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2-beta.1).
 
 - Deliver the component through a named release ZIP, avoiding the full source

@@ -113,8 +113,8 @@ smaller Marketplace downloads, consistent air-quality units and clearer update
 status. The component-only ZIP addresses the installation failure reported in
 [#145](https://github.com/senyo888/humidity-intelligence/issues/145); Marketplace
 and legacy HACS observations remain separate from loaded code and card compatibility.
-See the [release notes and upgrade guide](docs/releases/v2.1.2.md). V2.1.2 remains
-in preparation; the published Stable is v2.1.1.
+See the [release notes and upgrade guide](docs/releases/v2.1.2.md). **V2.1.2 is
+the current Stable release**, published 8 November 2026.
 
 ---
 
@@ -507,7 +507,7 @@ must be reviewable from tracked repository files.
 ## Current Release Highlights
 
 **[v2.1.2 — Home Assistant 2026.11 Harmonization](docs/releases/v2.1.2.md)** is the
-current release preparation. It combines component-only Marketplace/HACS delivery,
+current Stable release, published 8 November 2026. It combines component-only Marketplace/HACS delivery,
 canonical air-quality units, complete-evidence CO clearance, preserved gate/slope
 settings and clearer update observations.
 
@@ -520,9 +520,8 @@ in-memory Stability history.
 
 The [release record](docs/releases/v2.1.2.md#validation-and-publication-status)
 records exact package validation and the required optional-reference generator
-correction. Published Stable remains
-[v2.1.1](#v211-current-stable). Its single-level dashboards, explained updates and
-reporting improvements continue in v2.1.2, alongside Stability Score.
+correction. The single-level dashboards, explained updates and reporting
+improvements from v2.1.1 continue in v2.1.2, alongside Stability Score.
 
 ---
 
@@ -532,12 +531,11 @@ reporting improvements continue in v2.1.2, alongside Stability Score.
 
 Requires Home Assistant **2026.5.1** or newer.
 
-Until **v2.1.2 Stable is published**, the default release is v2.1.1, whose archive
-exceeds Marketplace's download limit. For Stable, use the complete component from
-the [v2.1.1 tag](https://github.com/senyo888/humidity-intelligence/tree/v2.1.1/custom_components/humidity_intelligence)
-and follow [Option B](#option-b---manual-package-upgrade). For testing, explicitly
-select [v2.1.2-beta.1](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2-beta.1)
-before installing; it provides the smaller install ZIP.
+**[v2.1.2 is the current Stable release](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2)**,
+with a smaller integration-only ZIP. Select **v2.1.2** when your package manager
+offers it. Earlier versions retain their download limitations; see
+[exact-tag recovery](docs/release-packaging.md#earlier-versions-and-current-evidence-limits)
+if you need an older package.
 
 On **2026.11+**, open **Settings → Marketplace**, find **Humidity Intelligence**,
 select the intended available version, then **Install**. A fresh installation can
@@ -823,7 +821,11 @@ CO emergency pressure. Details are in
 
 ## Release Notes
 
-### v2.1.2 (Stable source preparation)
+<a id="v212-stable-source-preparation"></a>
+
+### v2.1.2 (Current Stable)
+
+**Current Stable: v2.1.2** — published 8 November 2026.
 
 ![Humidity Intelligence v2.1.2 — Home Assistant 2026.11 Harmonization](assets/release_banner/v2.1.2_release.png)
 
@@ -833,18 +835,25 @@ status. It also corrects optional generated-card references so unconfigured sour
 cannot bind unrelated legacy entities. Both V2 layouts advance to **revision 16**;
 refresh/export and replace complete saved cards, including beta.1 revision-14 cards.
 [Validation and upgrade details](docs/releases/v2.1.2.md) distinguish the changed
-package from earlier installer and Stable-instance evidence. Published Stable
-remains v2.1.1 pending promotion and publication.
+package from earlier installer and Stable-instance evidence.
+[Release and downloads](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2).
 
 Thanks to [@Slaybcn](https://github.com/Slaybcn) for the report and logs, and
 [@Thorsten1982](https://github.com/Thorsten1982) for confirming the Marketplace
 installation problem in [#145](https://github.com/senyo888/humidity-intelligence/issues/145).
 
+<!-- Current Stable is expanded. Earlier releases and candidates remain
+under Previous Releases; CHANGELOG.md retains the complete detailed history. -->
+<details>
+<summary>Previous Releases</summary>
+
 <a id="v211-stable-source-preparation"></a>
 
-### v2.1.1 (Current Stable)
+<a id="v211-current-stable"></a>
 
-**Current Stable: v2.1.1** — published 24 October 2026.
+### v2.1.1 (Previous Stable)
+
+**Previous Stable: v2.1.1** — published 24 October 2026.
 
 ![Humidity Intelligence v2.1.1 — single-level cards and clearer update status](assets/release_banner/v2.1.1_release.png)
 
@@ -866,11 +875,6 @@ identity. [Complete notes](docs/releases/v2.1.1.md) cover
 [Release and downloads](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.1) ·
 24 October 2026. HACS refresh and loaded package identity remain separate checks.
 
-<!-- Current Stable is expanded. Earlier releases and candidates remain
-under Previous Releases; CHANGELOG.md retains the complete detailed history. -->
-<details>
-<summary>Previous Releases</summary>
-
 ### v2.1.2-beta.1 (Beta prerelease)
 
 Published 7 November 2026 as an opt-in prerelease: Marketplace ZIP delivery,
@@ -974,7 +978,7 @@ This candidate was not published as a beta or made available through HACS.
 
 Earlier candidate entries retain their original preparation and validation scope.
 References to the published Stable at those checkpoints are historical; see
-[v2.1.1](#v211-current-stable) for the current Stable release.
+[v2.1.2](#v212-current-stable) for the current Stable release.
 
 <a id="v2012-maintenance-candidate-not-published"></a>
 

@@ -1,19 +1,19 @@
 # Home Assistant 2026.11 compatibility
 
-The `2.1.2` stable source preserves beta.1 Marketplace support, canonical
+Published Stable `2.1.2` preserves beta.1 Marketplace support, canonical
 air-quality units, complete-evidence CO clearance and bounded setup improvements.
-Published Stable remains `v2.1.1` while final stable validation is completed. Source tests, publication, installed files and
-loaded runtime behavior are separate evidence.
+[V2.1.2 was published on 8 November 2026](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2).
+Source tests, publication, installed files and loaded runtime behavior are separate evidence.
 
 ## Installation and update observations
 
 On Home Assistant 2026.11+, use **Settings → Marketplace**. On supported earlier
 versions, use HACS. The declared minimum remains 2026.5.1. The named component ZIP
 and older-release recovery limits are documented in [release packaging](release-packaging.md).
-Published **v2.1.1 exceeds Marketplace's archive limit** and can fail to download.
-The beta provides a smaller install ZIP and must be selected explicitly for testing.
-For Stable v2.1.1, use
-[exact-tag manual recovery](release-packaging.md#earlier-versions-and-current-evidence-limits) if affected.
+**Select Stable v2.1.2 when offered** to use the smaller integration-only ZIP.
+The earlier v2.1.1 source archive exceeds Marketplace's limit; use
+[exact-tag manual recovery](release-packaging.md#earlier-versions-and-current-evidence-limits)
+if you need that older release.
 Marketplace can open a fresh installation's setup flow directly; updates and manual
 package replacement require a full Home Assistant restart. A restart discards HI's
 in-memory Stability sampling history.
@@ -168,4 +168,4 @@ No automatic threshold, history, source or dashboard rollback is performed.
 - [Conditional forms](https://contributors.home-assistant.io/core/integrations/flow-steps/#fields-that-show-based-on-another-field)
 
 Native monitoring sections, section strategies, energy observations and AI support
-remain separate future work; this candidate does not implement those features.
+remain separate future work; v2.1.2 does not implement those features.
@@ -34,10 +34,10 @@ House review must assess these authority boundaries as well as internal consiste
 
 ## Canonical Version Model
 
-- `2.1.2`: stable source preparation for Home Assistant 2026.11 Harmonization. Retains beta.1 control behavior and adds the required optional-reference generator correction. Both V2 layouts advance to revision 16, superseding 1–15; stamp schema/generator remain 1. Regenerate and replace beta.1 revision-14 cards as well as earlier cards. This is no longer a metadata-only stable transition: earlier package evidence remains historical. The earlier `0d99f598` component passed fresh minimal-instance checks and Stable acceptance, with 13 passes, 3 explained warnings and no failures. The earlier CO-unit Repairs, calculated-slope and setup-guidance package `cc709769` passed its own Stable acceptance: 79 files matched, 13 passes, 3 explained warnings and no failures; both saved V2 cards now show revision 16 in browser checks. Setup/options and snapshot guidance now names Marketplace while retaining legacy HACS instructions. These copy changes are included in the verified package identity; rendered-card UI is unchanged and compatible against `5c56b278`: both layouts retain revision 16/schema 1/generator 1. The four PR #147 corrections now change component bytes beyond `cc709769`: drain evaluation on unload, truthful CO clearance reasons, staged setup defaults and identity-safe residual slope pairing. Earlier Stable acceptance is historical. The corrected `d6174038` package completed isolated native Lab setup, then its own Stable acceptance on 8 November 2026: all 79 files matched; Stable recorded 13 passes, 3 explained warnings and no failures. Both existing revision-16 cards were verified in the browser without dashboard writes. Heating controls were unchanged and heating health was excluded from the HI acceptance criteria. This does not establish published Marketplace delivery. The subsequent PR #148 flash-restoration correction changes component bytes again; its cancellation/Manual-handover regressions do not transfer earlier live acceptance to the newer package. Against `b101ef49`, card templates, generation, reason schema and rendered stamps remain compatible at revision 16/schema 1/generator 1. Existing maintainer README, website and personal-note approvals remain recorded. Required human GitHub review and promotion stay separate from tag/asset verification and publication. Current Published Stable remains v2.1.1. See [stable package and upgrade record](releases/v2.1.2.md).
+- `2.1.2`: current published Stable, released 8 November 2026 as Home Assistant 2026.11 Harmonization. Retains beta.1 control behavior and adds the required optional-reference generator correction. Both V2 layouts advance to revision 16, superseding 1–15; stamp schema/generator remain 1. Regenerate and replace beta.1 revision-14 cards as well as earlier cards. This is no longer a metadata-only stable transition: earlier package evidence remains historical. The earlier `0d99f598` component passed fresh minimal-instance checks and Stable acceptance, with 13 passes, 3 explained warnings and no failures. The earlier CO-unit Repairs, calculated-slope and setup-guidance package `cc709769` passed its own Stable acceptance: 79 files matched, 13 passes, 3 explained warnings and no failures; both saved V2 cards now show revision 16 in browser checks. Setup/options and snapshot guidance now names Marketplace while retaining legacy HACS instructions. These copy changes are included in the verified package identity; rendered-card UI is unchanged and compatible against `5c56b278`: both layouts retain revision 16/schema 1/generator 1. The four PR #147 corrections now change component bytes beyond `cc709769`: drain evaluation on unload, truthful CO clearance reasons, staged setup defaults and identity-safe residual slope pairing. Earlier Stable acceptance is historical. The corrected `d6174038` package completed isolated native Lab setup, then its own Stable acceptance on 8 November 2026: all 79 files matched; Stable recorded 13 passes, 3 explained warnings and no failures. Both existing revision-16 cards were verified in the browser without dashboard writes. Heating controls were unchanged and heating health was excluded from the HI acceptance criteria. This does not establish published Marketplace delivery. The subsequent PR #148 flash-restoration correction changes component bytes again; its cancellation/Manual-handover regressions do not transfer earlier live acceptance to the newer package. Against `b101ef49`, card templates, generation, reason schema and rendered stamps remain compatible at revision 16/schema 1/generator 1. Existing maintainer README, website and personal-note approvals remain recorded. Required human GitHub review and promotion stay separate from tag/asset verification and publication. The final `9f52a22` component completed its own Stable acceptance: all 80 files matched, 13 passes, 3 explained warnings and no failures; both saved revision-16 layouts were verified. Tag `v2.1.2` points to main `7b578f5` with the same component bytes. The named asset was verified before and after publication; final Marketplace installer delivery remains separate. See [stable package and upgrade record](releases/v2.1.2.md).
 
-- `2.1.2-beta.1`: HA 2026.11 compatibility prerelease from `senyo888-patch-1`. Includes the #145 ZIP, exact dual-provider observation, canonical AQ units, complete-evidence CO clearance, conditional gates and saved slope identities. Both V2 layouts advance to revision 14, superseding 1–13; stamp schema/generator remain 1. Update-observation schema 1 adds Marketplace/null provider values. Current Stable remains v2.1.1. See [release notes](releases/v2.1.2-beta.1.md), [compatibility and rollback](home-assistant-2026.11.md), and [packaging](release-packaging.md).
-- `2.1.1`: current Stable, dated 2026-10-24 and merged to main in PR #134. Runtime and generated-card bytes are unchanged from reviewed RC.1; manifest and packaged guidance establish a new package identity. Both layouts remain revision 13, schema/generator 1. See the [Stable compatibility record](#v211-stable-source-preparation).
+- `2.1.2-beta.1`: HA 2026.11 compatibility prerelease from `senyo888-patch-1`. Includes the #145 ZIP, exact dual-provider observation, canonical AQ units, complete-evidence CO clearance, conditional gates and saved slope identities. Both V2 layouts advance to revision 14, superseding 1–13; stamp schema/generator remain 1. Update-observation schema 1 adds Marketplace/null provider values. At the beta publication checkpoint, Stable was v2.1.1. See [release notes](releases/v2.1.2-beta.1.md), [compatibility and rollback](home-assistant-2026.11.md), and [packaging](release-packaging.md).
+- `2.1.1`: previous Stable, dated 2026-10-24 and merged to main in PR #134. Runtime and generated-card bytes are unchanged from reviewed RC.1; manifest and packaged guidance establish a new package identity. Both layouts remain revision 13, schema/generator 1. See the [Stable compatibility record](#v211-stable-source-preparation).
 - `2.1.1-rc.1`: earlier unpublished release candidate, retaining the complete beta.1–beta.4 changes and correcting self-check telemetry counts after Options changes. Both layouts retain beta.4 revision 13 and schema/generator 1; update-observation schema remains 1. Existing revision-13 cards stay compatible. See the [RC package record](#v211-rc1-package-verification).
 - `2.1.1-beta.4`: earlier unpublished candidate with a quiet no-update footer and right-aligned **Update available** cue. Both layouts advanced to revision 13, superseding 1–12; stamp schema/generator and update-observation schema remained 1. Existing skipped/progress/unverified states stayed visible. Its source preparation did not change the then-running advisory Lab observation.
 - `2.1.1-beta.3`: earlier unpublished candidate adding optional HACS-reported update status beside the independent UI revision LED. Both layouts advance to revision 12, with stamp schema/generator 1 and a separate update-observation schema 1. Install the complete package, restart, regenerate and replace saved V2 cards; no configuration migration. This source update does not publish a beta, establish HACS availability, or change the beta.2 Lab soak.
@@ -71,11 +71,12 @@ must remain aligned with the
 `custom_components/humidity_intelligence/manifest.json` version contained in the
 published GitHub Release/tag.
 
-Current Stable is **[v2.1.1](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.1)**,
-published on 24 October 2026. Its immutable tag resolves to
-`f544d4bda82f71bb03ea5405472093f826d6351a`. The
-[release and compatibility record](#v211-stable-source-preparation) preserves the
-reviewed preparation merge, final publication identity and unchanged package.
+Current Stable is **[v2.1.2](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.2)**,
+published on 8 November 2026 at 21:52:07 UTC. Its tag resolves to
+`7b578f5e1c862a798f9f7d90a0ea9b1c86c06c05`. The verified 80-file asset has SHA-256
+`e0460d79d673e0e21e5d0490044abbfaf133e68e819d5e1a8583bbc18155b407`.
+See the [release and compatibility record](releases/v2.1.2.md).
+The [v2.1.1 record](#v211-stable-source-preparation) retains its historical publication facts.
 
 Historical release: [v2.1.0](https://github.com/senyo888/humidity-intelligence/releases/tag/v2.1.0)
 was released on 2026-10-12 as a non-prerelease GitHub Release. Tag `v2.1.0` identifies