Release v1.2.13-beta.3

Release Date: 2026-02-24

Type: Beta release - Fixes consumed energy sensor freezing when production stops.

What's Changed (since v1.2.13-beta.2)

energia_consumata freezes when production stops - The consumed energy sensor
(energia_consumata = auto_consumata + prelevata) was locked inside the sync guard
alongside energia_auto_consumata. When PV production stops (evening/night),
energia_prodotta and energia_immessa stop changing, so the sync guard stays closed.
But energia_prelevata (import from grid) keeps growing every poll. The consumed sensor
froze because it was never recalculated, even though one of its inputs kept changing.

Fix: Move energia_consumata calculation outside the sync guard so it is always
recalculated on every poll. energia_auto_consumata stays inside the guard (it needs
oscillation protection since it depends on prodotta - immessa). This is safe for
TOTAL_INCREASING because both addends (auto_consumata and prelevata) are
monotonically non-decreasing, so their sum can never dip.
Debug log spam during nighttime - The "waiting for sync" debug message fired on every
idle poll (neither sensor fresh), producing unnecessary log entries outside production hours.
Now it only fires when one sensor is actually fresh and we're waiting for the other.

Beta	Bug	Root Cause
beta.1	Over-counting in calculated energy sensors	Desynchronized `prodotta - immessa` calculation
beta.2	Idle polls poisoned sync counter	`else` branch didn't distinguish "one fresh" from "neither fresh"
beta.3	Consumed energy freezes at night	`energia_consumata` locked inside sync guard

After deploying this update:

Overnight test (critical): Monitor sensor.alfa_energy_consumed after sunset.
It should keep increasing as grid import (sensor.alfa_energy_imported) grows.
Energy Dashboard: Verify consumption = self-consumed + imported throughout the day.
Daytime (regression check): Verify sensor.alfa_energy_self_consumed still shows
smooth monotonic increase with no sawtooth dips.

Files changed: api.py (sync logic + docstring), test_api.py (+5 new tests,
1 updated), energy-oscillation-fix.md (algorithm docs)
Test coverage: 98%
CI: All 3 workflows passing (Lint, Tests, Validate)

Full Changelog:
compare/v1.2.13-beta.2...v1.2.13-beta.3