Humidity Intelligence v2.0.0 — Deterministic Runtime Intelligence Engine

Deterministic Runtime Engine + Config UX + Canonical UI

Humidity Intelligence has been upgraded from v1 to a fully deterministic V2 runtime engine with a first-class configuration and post-configuration experience.

This release formalises the architectural shift from template logic to structured environmental runtime control.

---

🧠 Runtime Architecture

Deterministic Lane Enforcement

The control engine now resolves lanes in strict priority order:

1. CO Emergency
2. Alert Lane
3. Zone 1 Stabilisation
4. Zone 2 Stabilisation
5. Air Quality

• Only one control lane drives outputs per evaluation cycle.
• Humidifier lanes remain independent of zone/AQ ordering.
• Global gates are now integrated directly into runtime state resolution.
• Current Air Control UI reflects true runtime state (chips + border sync).

This eliminates race conditions, trigger stacking, and “last automation wins” behaviour.

---

⚙️ Configuration & User Experience

Expanded configuration flow and options flow:

• Telemetry inputs (humidity, temperature, IAQ, PM2.5, CO₂, CO, VOC)
• Global gates (time, presence, alarm states)
• Zone configuration
• Humidifier configuration
• Air Quality configuration
• Alert & CO triggers
• Temperature slope settings

Safety Guardrails

• Threshold validation for alert/CO triggers
• Fan stage normalization (auto / 33 / 66 / 100)
• Reduced misconfiguration risk through runtime validation

Engine & UI Improvements

• Dynamic entity mapping refined
• Removed hardcoded placeholder UI behaviour
• Runtime state now drives UI truth consistently

---

🧪 Stability & Regression Coverage

• Added regression coverage for:

  • Lane ordering enforcement
  • Runtime state resolution
  • Card render/mapping integrity

This release focuses on predictability, stability, and architectural correctness.

---

🎨 Branding & Documentation

• Integrated canonical header + logo directly into README
• Normalised branding assets for consistent HACS-friendly sizing
• Refined onboarding documentation for V2 configuration flow
• Expanded migration guidance

---

🔄 Migration Notice (Important)

Before installing or running V2:

1. Remove v1 backend templates/packages:

   • /config/custom_templates/humidity_intelligence.jinja
   • /config/packages/humidity_intelligence.yaml

2. Remove any legacy v1 YAML dashboards if copied manually.

3. Restart Home Assistant.

4. Install V2 via HACS as an Integration.

UI Compatibility

The classic v1 UI skin remains supported as a presentation layer on top of the V2 runtime engine.

---

📦 Versioning Note

V2 represents a structural upgrade and should be treated as a major version transition from v1.

v1.1.2 — HACS submission (Packaging + Docs)

This release packages the Advanced Humidity Intelligence backend for smooth installation and updates via HACS (Template).
What’s included
HACS Template support (hacs.json + root .jinja)
Preserved stable entity names for dashboards
humidity_constellation_series passthrough sensor for ApexCharts
Lovelace UI example provided separately (dropdown-mod / Constellation compatible)
Documentation improvements and clearer install/migration notes
Notes
Backend logic remains aligned with the v1.1.0 Advanced Intelligence feature set.
Users must map their own humidity + temperature sensors in the config section.
No vendor integrations assumed.

Advanced Humidity Intelligence

🚀 v1.1.0 — Advanced Intelligence Edition

This release locks in the advanced analysis core of Humidity-Intelligence — the part of the project that turns raw humidity numbers into actionable insight.

v1.1.0 represents the system I actually run at home, and the feature set people most often ask about: dew point awareness, condensation risk, mould scoring, and clear “what should I do now?” guidance.

✨ What’s new in v1.1.0

Advanced environmental intelligence

• Per-room dew point calculation (Magnus formula)
• Condensation spread (temperature vs dew point) per room
• Multi-factor mould risk scoring (humidity + condensation proxy)
• Worst-room detection for both condensation and mould

Actionable guidance

• Plain-language ventilation suggestions based on current conditions
• Seasonal comfort band logic (UK-friendly defaults)
• Clear “too dry / comfortable / too humid” states

House-level awareness

• Dynamic house average humidity
• 7-day drift against historical mean
• Binary danger sensors for UI badges, alerts, and automations

UI-ready backend

• Public, stable entity names designed for dashboards
• humidity_constellation_series sensor for ApexCharts
• Integrated support for the dropdown-mod / Constellation UI

---

🧠 Design philosophy

This release deliberately prioritises clarity over cleverness.

Instead of just reporting values, the system answers:

• Where is the problem?
• How serious is it?
• What should I do right now?

Everything in v1.1.0 exists to support those questions.

---

🔒 Versioning note

• v1.0.2 remains available as a stable, simpler baseline.

• v1.1.0 is the recommended release for users who want full environmental insight.

• Future v1.2.x releases will build on this advanced backend while introducing:

  • dynamic room mapping for all per-room metrics
  • tighter coupling to the new UI patterns

---

⚠️ Breaking / important notes

• Users must map their own humidity and temperature sensors to the provided template entities.
• No vendor-specific integrations are assumed.
• This release is backend-first; UI examples are provided separately.

---

🙌 Thanks

Thanks to everyone who’s contributed ideas, testing, and discussion around this project.
Special thanks to @coltondick for the UI direction and dynamic configuration work that will shape the next development cycle.

Humidity Intelligence v1.0.0

Humidity Intelligence — v1.0.0

This is the first public release of Humidity Intelligence — a complete, drop-in humidity awareness system for Home Assistant.

Instead of a single humidity number, Humidity Intelligence gives you context:

• what’s happening right now
• which room is becoming risky
• whether humidity is trending up or down
• and when it’s time to ventilate — or relax

---

🚀 What’s included

✔️ Smart badge row

• Humidity — live house average with dynamic glow
• Condensation — worst-room risk (Watch / Risk / Danger)
• Mould — worst-room risk (Watch / Risk / Danger)
• Drift — 7-day change vs historical mean

✔️ Comfort Band panel

• Target humidity range (editable)

• Clear comfort guidance:

  • too dry → humidify / reduce extraction
  • ideal → maintain steady
  • too high → ventilate 10–20 minutes

• Room call-outs for highest condensation and mould risk

✔️ Drop-down “Humidity Constellation” chart

• 24-hour multi-room humidity chart
• Smooth group-by averaging
• Shaded target band overlay
• Toggled using the floating chevron

✔️ Backend intelligence (no automations needed)

• Average humidity
• 7-day mean and drift
• Per-room risk scoring
• Danger flags to drive UI highlights

---

🛠️ Installation

Instructions are fully documented in the README:

👉 Packages setup
👉 Dependencies via HACS
👉 Card installation
👉 Entity mapping and customisation

Everything is designed to be beginner-friendly.

---

🔮 Roadmap

Planned enhancements include:

• per-room drill-down view
• seasonal comfort presets
• combined temperature + humidity overview
• HACS distribution support

Community suggestions are welcome.

---

🙏 Thanks

Thanks to everyone testing, giving feedback and watching this evolve.
If you find Humidity Intelligence useful:

⭐ Star the repository
🖼️ Share a screenshot
🐞 Report issues or ideas in Discussions / Issues