What's changed
Fix — spurious WARNING in HA logs
FLOW_TERMINATED_WITHOUT_ENTRY with mac=None was incorrectly logged at WARNING level, surfacing in the HA error dashboard. This happens during normal HA lifecycle (flow shell created but never started). Downgraded to DEBUG when _pending_mac is None. A real incomplete flow (device discovered, user bails mid-commissioning) still logs at WARNING.
Documentation
- Device discovery instructions corrected: press any button first so the switch appears in HA, then click Add
single_pressdefinition clarified: fires on the first valid signal of an interaction (press or coherent orphan release), once per interaction- Usage rules section added: simple vs advanced mode, reliability table, mixing modes warning
- Examples rewritten with all safeguards (wait_for_trigger pattern for advanced on/off, Rule 3 stop trigger for dimming)