📋 Changelog

All notable changes are documented here. Versions follow Semantic Versioning.

[2.1.0] — Observability & Architecture

Added

  • sensor.pumpsteer_thermal_outlook — new sensor exposing PumpSteer’s internal forecast analysis: preheat worthwhile, preheat strength, warming/cooling trends, night min / day max temperature, precool risk, and effective wind-chill temperature. Primarily diagnostic in 2.1.0 — does not yet replace core preheat logic.
  • switch.pumpsteer_preheat_boost — preheat boost is now a proper dashboard switch. Previously only configurable via the options flow. Existing state is preserved across upgrades via RestoreEntity.
  • ThermalModel in thermal_model.py — passively collects indoor cooling rate samples during braking periods. Foundation for future brake safety prediction. fit() is not yet called; this is passive collection only.

Changed

  • forecast.py refactored — cleaner weather analysis, better separation between forecast retrieval and thermal analysis. ThermalOutlook dataclass introduced.
  • thermal_model.py introduced as a separate module for thermal regression logic.
  • ThermalOutlookSensor suppresses preheat_worthwhile when indoor_temp >= target_temperature to avoid unnecessary preheat signals.
  • Internal cleanup for maintainability and future extensibility.

Notes

  • No migration required. Fully backward compatible with 2.0.x.
  • All new features are additive — existing behavior is unchanged.
  • ThermalModel.fit() is identified as a future improvement; not called in 2.1.0.

[2.0.x] — Stability & Hardening

Fixed (across 2.0.x patch releases)

  • Brake ramp dt now capped at 60 seconds per step — prevents large ramp jumps after HA restarts or long gaps between polling cycles.
  • Midnight grace window (00:00–00:15) prevents stale price threshold caching before Nordpool delivers fresh data.
  • P80 guard: if P80 for the day is below ABSOLUTE_CHEAP_LIMIT, all slots are classified as cheap — no braking on days when electricity is universally cheap.
  • _forecast_is_cold() result correctly isolated from bridge_short_dip path.
  • ramp_in computed against PRICE_EXPENSIVE when upcoming=True to ensure correct ramp duration regardless of intermediate price categories.

[2.0.0] — The Big Rewrite

Added

  • PI controller as the primary control loop with integral windup protection (PID_INTEGRAL_CLAMP). Integral is frozen (not decayed or reset) during braking.
  • Smooth brake ramping — brake_factor ramps in and out over configurable minutes. No hard steps.
  • P30/P80 price classification with per-day caching. Prevents mid-slot reclassification from releasing the brake unexpectedly.
  • Pre-brake (block 5a) — pure price signal, starts ramp before the expensive slot. Independent of forecast availability.
  • Preheat-boost (block 5b) — forecast-gated, boosts heating before expensive periods when weather is cold.
  • pre_braking mode — separate from preheating for unambiguous logging and dashboard state.
  • Comfort floor per aggressiveness level — brake releases automatically when indoor temperature drops too far.
  • Brake hold time — prevents oscillation during short cheap dips within a longer expensive block.
  • Summer mode — passes through real outdoor temperature when outdoor temp exceeds threshold. Highest-priority check.
  • Safe mode — passes through real outdoor temperature when any required sensor is missing or invalid.
  • Holiday mode — lower target (16 °C default), same PI/braking logic. Scheduled via datetime helpers.
  • Ohmigo integration — pushes fake temp to Ohmigo WiFi controller with hysteresis and rate limiting.
  • Notification system — push alerts on mode transitions (braking / preheating).
  • HA 2026.2+ compatibility — uses weather.get_forecasts service call instead of deprecated state_attr(..., 'forecast').
  • Peak filter — ignores expensive price spikes shorter than PEAK_FILTER_MIN_DURATION_MINUTES (default 30 min).

Removed

  • Machine learning features from v1.x
  • very_cheap, extreme price categories — replaced with cheap, normal, expensive
  • All cloud dependencies

Breaking changes from 1.x

  • All entity IDs renamed
  • Price categories changed
  • Options flow rebuilt
  • Automations referencing old entities must be updated

[1.x] — Legacy

Version 1.x used heuristic control with ML features and cloud-optional components. No longer supported. See the Installation Guide for migration instructions.