docs: plan HOLD-state pid_heat windup fix from overshoot investigation

Records the root cause of the cold-water overshoot in docs/overshoot.png
(integral windup in pid_heat with no anti-windup engagement, since y never
saturated) and the refined fix plan: gate pid_heat by FSM state instead of
a flat yi_max clamp, which was rejected after the numbers showed it would
also cripple legitimate high-rate ramps.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KefnwbGDM8CGrhb4sFhVq9
This commit is contained in:
2026-07-04 12:31:58 +02:00
co-authored by Claude Sonnet 5
parent 8689494be0
commit 13bb011099
3 changed files with 164 additions and 0 deletions
Binary file not shown.

After

Width:  |  Height:  |  Size: 207 KiB