Velair 1.1.0

Velair 1.1.0 is here.

After several weeks of work, testing, feedback, and many small refinements, this release brings a big step forward for Velair: Adaptive Preconditioning, Room Assist, and optional climate controls are now part of the stable release.

I am really happy to make this available for real Home Assistant installations. The goal is still the same: keep climate scheduling local, understandable, and useful, while giving users enough flexibility to adapt it to how their homes actually work.

Adaptive Preconditioning helps Velair start heating or cooling before a scheduled block so the room is closer to the target temperature when the block begins. Room Assist makes it possible to use a separate room temperature sensor while still controlling the real climate.* entity, which is especially useful for TRVs or devices whose built-in temperature reading does not represent the actual room. Optional climate controls add support for things like fan mode, presets, swing modes, and humidity when the climate entity supports them.

Everything continues to work locally inside Home Assistant. Velair does not send schedules, climate history, room sensor data, outdoor sensor data, or learning data to external services.

Thank you to everyone who tested the beta, asked questions, reported edge cases, and helped shape this release.

✨ Added

• Adaptive Preconditioning per managed climate, with independent local learning for heating and cooling.
• A dedicated Preconditioning tab to enable the feature, tune limits, inspect learning status, view live predictions, reset settings, and reset heat or cool learning independently.
• Optional outdoor temperature sensor context for Adaptive Preconditioning, used locally when comparing similar historical observations.
• Export and safe import of preconditioning settings and collected learning observations, matched by exact climate entity IDs.
• A Preconditioning Lovelace view.
• Room Assist for using a separate room temperature sensor while Velair still controls the real climate.* entity.
• A dedicated Room Assist tab with per-climate setup, refresh delay, maximum assist delta, and live temperature-scale status.
• Room Assist Lovelace cards, including options to hide the on/off switch, sensor picker, maximum assist delta, refresh delay, or live status for compact dashboards.
• velair.enable_room_sensor_assist and velair.disable_room_sensor_assist services for automation-driven room sensor control.
• Automation events when Room Assist applies or restores an assisted target.
• Optional climate controls in schedule blocks, templates, boosts, and velair.set_temperature, including fan mode, preset mode, swing mode, horizontal swing mode, and target humidity when supported by the climate entity.
• A velair.cancel_boost service to end an active boost early and return to the appropriate scheduled or previous climate state.

🚀 Improved

• Next events now show both the scheduled block time and the calculated preconditioning start while keeping target temperature and mode visible.
• Adaptive Preconditioning predictions now scale learned thermal behavior by the current temperature delta, so small and large future gaps can be estimated from learned room behavior.
• Partial preconditioning observations now act as conservative lower bounds without becoming permanent fake completion times.
• Heat and cool learning histories are stored separately so seasonal use in one direction does not evict data from the other.
• Adaptive Preconditioning live predictions include optional calculation details for sample counts, partial lower bounds, intermediate estimates, rounding, and final lead time.
• heat_cool scheduled blocks are classified into the effective heating or cooling preconditioning direction based on the current temperature delta.
• Room Assist can run on normal scheduled blocks and on blocks that Adaptive Preconditioning has started early.
• Room Assist aligns assisted targets with each climate entity's supported temperature step and ignores smaller movements.
• Room Assist keeps monitoring after the room reaches target, so assistance can start again if the room drifts away during the same block.
• Today's timeline opens near the current time on narrow screens and keeps useful block labels visible while scrolling.
• Overview tables, Next events, Active boosts, Today's timeline, and Zone overview now have more consistent spacing, sticky behavior, and mobile alignment.
• Optional climate controls in schedule and template blocks now use a cleaner icon-only button style.
• Lovelace card editor options now adapt to the selected card view, only showing thermostat ordering, filtering, first weekday, or Room Assist visibility options where they apply.
• Lovelace cards can limit zone-based views to selected thermostats without changing stored schedules or scheduler behavior.
• Settings now highlights climates with Adaptive Preconditioning or Room Assist enabled.
• Import/export panels now keep independent heights on larger screens.
• Velair now respects Home Assistant's 12-hour or 24-hour time format preference across date/time labels and schedule timeline text.
• Documentation now includes dedicated user and developer guides for Adaptive Preconditioning and Room Assist.

🛠️ Fixed

• Fixed Preconditioning and Room Assist Lovelace cards not persisting climate-specific setting changes made from dashboard cards.
• Fixed Room Sensor Assist not reacting to room sensor changes when the active schedule block had not created an assisted target yet.
• Fixed Room Sensor Assist recalculating against the previous schedule block while Adaptive Preconditioning or an active assisted runtime target had already started a future block early.
• Fixed Room Sensor Assist showing or recalculating against a schedule block that had already been removed.
• Fixed Room Assist live status not refreshing when the climate target temperature changes.
• Fixed Room Assist showing a later assist recalculation time instead of the original Adaptive Preconditioning start time.
• Fixed Room Assist offset help tooltips creating unnecessary horizontal scroll near the edge of the live temperature scale.
• Fixed Room Assist temperature scale labels so close temperature markers remain readable without overlapping.
• Fixed Room Assist live temperature markers so overlapping marker colors match the visible label order.
• Fixed Room Assist and Adaptive Preconditioning losing the active early-start target after schedule edits that reused the same block time.
• Fixed Adaptive Preconditioning events that should already have started so they apply immediately and remain visible in Next events until the scheduled target time.
• Fixed heat_cool scheduled blocks using Adaptive Preconditioning but not appearing under the effective Heat or Cool learning section in the Preconditioning tab.
• Fixed the schedule template selector staying on the last applied template instead of returning to the placeholder.
• Fixed templates saved from the schedule editor losing optional climate controls such as fan mode, preset, swing, or humidity.
• Fixed a Home Assistant thread-safety warning that could happen when Adaptive Preconditioning recalculated plans after temperature changes.
• Fixed several mobile layout issues in Next events, Today's timeline, empty timeline rows, sticky headers, Preconditioning, Room Assist, and optional climate controls.
• Fixed boost end and renewal behavior so Velair restores the expected climate state.
• Automation events now also cover direct velair.set_temperature actions and automatic pause endings.

🧭 Notes

• Adaptive Preconditioning needs real observations before learned predictions become useful. Early behavior uses the configured initial model until enough completed local samples exist.
• Room Assist depends on Home Assistant state updates from the selected room sensor and managed climate entity. If those entities do not publish useful updates, Velair cannot infer intermediate room movement.
• Device firmware, valve logic, compressor protection, supported HVAC modes, and min/max climate limits still apply because Velair works through Home Assistant's standard climate services.