Humidity Intelligence V2.0.1

🚀 Humidity Intelligence V2.0.1

Stability Patch — Deterministic Telemetry, Safer Aggregation, Cleaner Runtime

This release focuses on correctness, resilience, and configurability across the full runtime.

V2 introduced a deterministic environmental control engine.
V2.0.1 stabilises real-world edge cases—mixed units, imperfect sensor data, partial configs, and evolving setups.

---

🧠 Core Improvements

🌡️ Temperature Normalisation (Critical Fix)

• All internal temperature logic is now canonically processed in Celsius
• Fixes incorrect behaviour in:
  • averages
  • spreads
  • deltas
  • threshold comparisons
• Mixed-unit environments (°C + °F) now behave predictably and safely

---

📊 Robust Aggregate Handling

• IAQ / AQ aggregation now:
  • ignores invalid states: unknown, unavailable, non-numeric
  • only returns unknown when no valid inputs exist
• Prevents:
  • false negatives
  • broken UI states
  • unstable automation triggers

---

🔍 Full Transparency Debug Logging

• Aggregation exclusions now log explicit reasons:
  • unknown
  • unavailable
  • non_numeric
  • unit_mismatch

---

⚠️ Configuration Safety & Diagnostics

• Duplicate zone mapping detection added:
  • setup + options flow warnings
  • dedicated diagnostics sensor state
• Prevents silent misconfiguration and overlapping control logic

---

⚙️ New Runtime Mode

🟡 alert_only_mode

A new operating mode for users without output hardware.

• Disables:
  • automation/control lanes
• Keeps:
  • monitoring
  • alerts
• UI and runtime adapt accordingly

---

🧩 UI & UX Refinements

🧼 Intelligent UI Pruning

• Unconfigured elements are now fully removed, not just hidden
• Applies to:
  • outputs
  • controls
  • alert-only scenarios

---

🛠️ Alert-Only UI Fixes

• Fixed edge case with leftover conditional blocks
• Prevents broken or ghost UI elements after pruning

---

🧾 Accurate “Current Air Control” Reasoning

• In alert_only_mode, the system:
  • reports monitoring/alert context clearly
  • no longer implies missing hardware

---

🔄 Live UI Regeneration

• Changing alert_only_mode now:
  • triggers UI refresh/export regeneration
  • sends a notification

---

🔁 Configuration Flow Expansion

✏️ Post-Configuration Editing

• Users can now:
  • revisit skipped lanes
  • add/edit alerts at any time

---

🔁 Dynamic Lane Rehydration

• Previously removed lanes can now be re-added cleanly:
  • humidifier lanes
  • AQ lanes

---

📜 Telemetry Change Logging

• Lane changes now log explicit actions:
  • added
  • updated
  • removed

---

🚨 Alert System Improvements

💡 Fully Optional Alert Targets

• Light entities are now optional across the entire stack:
  • config
  • options
  • services
  • runtime

Alerts still trigger—even with no flash outputs configured

---

🔐 Hardening & Validation

• Strengthened service validation:
  • safe filename checks
  • URL/path validation
  • layout constraints
• Flash parameters are now bounded and controlled
• Diagnostics:
  • sensitive attributes are now redacted

---

🧭 What This Means

This release strengthens:

• predictability (unit consistency)
• resilience (dirty data handling)
• transparency (debug visibility)
• flexibility (config + runtime modes)

Designed for real-world Home Assistant environments, not perfect lab setups.

---

📦 Upgrade Notes

• Safe to upgrade from V2.0.0
• No breaking changes
• Existing installs automatically benefit from:
  • improved aggregation
  • UI pruning
  • diagnostics
  • validation

⚠️ Migration notes

• alert_only_mode is now available in Global Gates (setup and options). Disable it later to restore normal control entities/lane behavior.
• new computed sensor: HI Zone Mapping Duplicates (hi_<entry_id>_zone_mapping_duplicates) exposes duplicate zone mapping status and details.
• generated V2 cards now prune unresolved optional control/output entities instead of leaving stale references.
• if your dashboard uses Manual cards, re-copy/paste the latest exported YAML after changing alert_only_mode so the UI and reason panel match the selected mode.