HVAC Condensate-Leak Auto-Shutoff (all 3 zones) Implementation Plan¶

"""Tier 2 — Condensate Safety helpers + automations (#71).

The per-zone helpers are referenced in automations.yaml only via Jinja (derived from the
thermostat slug), so the Tier-3 literal entity-ref scan can't see them. These structural
checks are the compensating coverage. Uses the `configuration`/`automations` fixtures
from conftest.py.
"""

ZONE_SLUGS = ("office", "bedroom", "dining_room")

SENSOR_TO_CLIMATE = {
    "attic_air_handler_leak_detector": "climate.office",
    "3rd_floor_furnace_leak_detector": "climate.bedroom",
    "crawl_space_furnace_leak_detector": "climate.dining_room",
}


def test_condensate_helpers_defined(configuration):
    ib = configuration.get("input_boolean", {}) or {}
    idt = configuration.get("input_datetime", {}) or {}
    for slug in ZONE_SLUGS:
        assert f"{slug}_ac_condensate_shutoff" in ib, f"missing input_boolean for {slug}"
        assert f"{slug}_ac_condensate_last_restore" in idt, f"missing input_datetime for {slug}"
        assert idt[f"{slug}_ac_condensate_last_restore"].get("has_time") is True

  # Condensate Safety (#71) — ON while an automation is holding a zone's Ecobee OFF after an
  # air-handler condensate leak; cleared on auto-restore or a manual turn-on. No initial: (persists).
  office_ac_condensate_shutoff:
    name: "Office AC — Condensate Shutoff"
    icon: mdi:air-conditioner
  bedroom_ac_condensate_shutoff:
    name: "Master Bedroom AC — Condensate Shutoff"
    icon: mdi:air-conditioner
  dining_room_ac_condensate_shutoff:
    name: "Dining Room AC — Condensate Shutoff"
    icon: mdi:air-conditioner

  # Condensate Safety (#71) — timestamp of each zone's last auto-restore, for the 2h cooldown.
  office_ac_condensate_last_restore:
    name: "Office AC — Last Condensate Restore"
    has_date: true
    has_time: true
  bedroom_ac_condensate_last_restore:
    name: "Master Bedroom AC — Last Condensate Restore"
    has_date: true
    has_time: true
  dining_room_ac_condensate_last_restore:
    name: "Dining Room AC — Last Condensate Restore"
    has_date: true
    has_time: true

git add configuration.yaml tests/test_condensate_safety.py
git commit -m "feat(climate): add 6 condensate-safety helpers + structural test (#71)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>"

def test_condensate_automations_present(automations):
    by_id = {a.get("id"): a for a in automations}
    for aid in ("condensate_leak_hvac_shutoff",
                "condensate_leak_hvac_restore",
                "condensate_leak_hvac_override"):
        assert aid in by_id, f"missing automation {aid}"


def test_condensate_zone_map_covers_all_sensors(automations):
    by_id = {a.get("id"): a for a in automations}
    for aid in ("condensate_leak_hvac_shutoff", "condensate_leak_hvac_restore"):
        zmap = by_id[aid]["variables"]["zone_map"]
        assert set(zmap.keys()) == set(SENSOR_TO_CLIMATE), f"{aid} zone_map keys mismatch"
        for sensor, clim in SENSOR_TO_CLIMATE.items():
            assert zmap[sensor]["climate"] == clim, f"{aid}: {sensor} -> wrong climate"

# ── Condensate Safety ───────────────────────────────────────────────────────────
# Auto-shutoff each HVAC zone's Ecobee on an air-handler condensate leak, with
# dry-detect auto-restore (2h cooldown per zone). Generalized across all 3 zones via
# zone_map. SANCTIONED HVAC-write exception #2 (see projects/climate_system.md).

- alias: "Condensate Leak — HVAC Shutoff"
  id: condensate_leak_hvac_shutoff
  description: >
    An air-handler/furnace condensate pan went wet → turn OFF that zone's Ecobee so it stops
    making more condensate, and push both phones once per shutoff episode. Restore is handled
    by "Condensate Leak — HVAC Restore". Sanctioned HVAC-write exception.
  triggers:
    - trigger: state
      entity_id:
        - binary_sensor.attic_air_handler_leak_detector
        - binary_sensor.3rd_floor_furnace_leak_detector
        - binary_sensor.crawl_space_furnace_leak_detector
      to: "on"
  variables:
    zone_map:
      attic_air_handler_leak_detector: { climate: climate.office, name: "Office" }
      3rd_floor_furnace_leak_detector: { climate: climate.bedroom, name: "Master Bedroom" }
      crawl_space_furnace_leak_detector: { climate: climate.dining_room, name: "Dining Room" }
    zone: "{{ zone_map[trigger.to_state.object_id] }}"
    clim: "{{ zone.climate }}"
    zname: "{{ zone.name }}"
    slug: "{{ clim.split('.')[1] }}"
    latch: "{{ 'input_boolean.' ~ slug ~ '_ac_condensate_shutoff' }}"
  actions:
    - alias: "Turn the zone's Ecobee off (idempotent)"
      action: climate.set_hvac_mode
      target:
        entity_id: "{{ clim }}"
      data:
        hvac_mode: "off"
    - alias: "Latch + notify once per episode"
      if:
        - condition: template
          value_template: "{{ is_state(latch, 'off') }}"
      then:
        - action: input_boolean.turn_on
          target:
            entity_id: "{{ latch }}"
        - alias: "Notify Louis"
          action: notify.mobile_app_louis_iphone
          data:
            title: "🌡️ {{ zname }} AC turned off"
            message: >
              Condensate leak at the {{ zname }} air handler — turned the AC OFF so it stops
              making water. It'll auto-restore once the pan is dry (≥2h between restarts).
              Worth checking the drain line.
            data:
              tag: "condensate_{{ slug }}"
        - alias: "Notify Lindsay"
          action: notify.mobile_app_lindsays_iphone
          data:
            title: "🌡️ {{ zname }} AC turned off"
            message: >
              Condensate leak at the {{ zname }} air handler — turned the AC OFF so it stops
              making water. It'll auto-restore once the pan is dry (≥2h between restarts).
              Worth checking the drain line.
            data:
              tag: "condensate_{{ slug }}"
  mode: queued
  max: 10

- alias: "Condensate Leak — HVAC Restore"
  id: condensate_leak_hvac_restore
  description: >
    That zone's condensate pan has been dry for 10 min → after a ≥2h cooldown since the zone's
    last restore, put the Ecobee back to heat_cool. Aborts if the pan re-flooded or the owner
    already turned it back on during the wait. Sanctioned HVAC-write exception.
  triggers:
    - trigger: state
      entity_id:
        - binary_sensor.attic_air_handler_leak_detector
        - binary_sensor.3rd_floor_furnace_leak_detector
        - binary_sensor.crawl_space_furnace_leak_detector
      to: "off"
      for:
        minutes: 10
  variables:
    zone_map:
      attic_air_handler_leak_detector: { climate: climate.office, name: "Office" }
      3rd_floor_furnace_leak_detector: { climate: climate.bedroom, name: "Master Bedroom" }
      crawl_space_furnace_leak_detector: { climate: climate.dining_room, name: "Dining Room" }
    zone: "{{ zone_map[trigger.to_state.object_id] }}"
    clim: "{{ zone.climate }}"
    zname: "{{ zone.name }}"
    slug: "{{ clim.split('.')[1] }}"
    latch: "{{ 'input_boolean.' ~ slug ~ '_ac_condensate_shutoff' }}"
    ts: "{{ 'input_datetime.' ~ slug ~ '_ac_condensate_last_restore' }}"
    sensor_id: "{{ trigger.to_state.entity_id }}"
  conditions:
    - condition: template
      value_template: "{{ is_state(latch, 'on') }}"
  actions:
    - alias: "Wait out the 2h cooldown since this zone's last restore"
      wait_template: "{{ now().timestamp() - (state_attr(ts, 'timestamp') | float(0)) >= 7200 }}"
    - alias: "Abort if the pan re-flooded or the owner cleared the latch during the wait"
      condition: template
      value_template: "{{ is_state(sensor_id, 'off') and is_state(latch, 'on') }}"
    - alias: "Clear the latch FIRST (so owner-override doesn't fire on our own restore)"
      action: input_boolean.turn_off
      target:
        entity_id: "{{ latch }}"
    - alias: "Stamp this restore time for the cooldown"
      action: input_datetime.set_datetime
      target:
        entity_id: "{{ ts }}"
      data:
        timestamp: "{{ now().timestamp() }}"
    - alias: "Put the Ecobee back to heat_cool"
      action: climate.set_hvac_mode
      target:
        entity_id: "{{ clim }}"
      data:
        hvac_mode: "heat_cool"
    - alias: "Notify Louis — restored"
      action: notify.mobile_app_louis_iphone
      data:
        title: "✅ {{ zname }} AC restored"
        message: "{{ zname }} condensate pan is dry again — AC back on (heat/cool)."
        data:
          tag: "condensate_{{ slug }}"
    - alias: "Notify Lindsay — restored"
      action: notify.mobile_app_lindsays_iphone
      data:
        title: "✅ {{ zname }} AC restored"
        message: "{{ zname }} condensate pan is dry again — AC back on (heat/cool)."
        data:
          tag: "condensate_{{ slug }}"
  mode: parallel
  max: 10

- alias: "Condensate Leak — Owner Override Clear"
  id: condensate_leak_hvac_override
  description: >
    Someone manually turned a zone's Ecobee back on while we were holding it off for a condensate
    leak → clear that zone's shutoff latch so the pending auto-restore aborts (its post-wait
    re-check sees the latch off). Does NOT fire on our own restore, which clears the latch before
    setting heat_cool.
  triggers:
    - trigger: state
      entity_id:
        - climate.office
        - climate.bedroom
        - climate.dining_room
  variables:
    slug: "{{ trigger.to_state.object_id }}"
    latch: "{{ 'input_boolean.' ~ slug ~ '_ac_condensate_shutoff' }}"
    zname_map: { office: "Office", bedroom: "Master Bedroom", dining_room: "Dining Room" }
    zname: "{{ zname_map[slug] }}"
  conditions:
    - condition: template
      value_template: >
        {{ trigger.to_state.state not in ['off', 'unavailable', 'unknown']
           and is_state(latch, 'on') }}
  actions:
    - action: input_boolean.turn_off
      target:
        entity_id: "{{ latch }}"
    - alias: "Notify Louis — override"
      action: notify.mobile_app_louis_iphone
      data:
        title: "{{ zname }} AC back on"
        message: "{{ zname }} AC was turned back on manually — condensate auto-restore cancelled."
        data:
          tag: "condensate_{{ slug }}"
    - alias: "Notify Lindsay — override"
      action: notify.mobile_app_lindsays_iphone
      data:
        title: "{{ zname }} AC back on"
        message: "{{ zname }} AC was turned back on manually — condensate auto-restore cancelled."
        data:
          tag: "condensate_{{ slug }}"
  mode: queued
  max: 10

git add automations.yaml tests/test_condensate_safety.py
git commit -m "feat(climate): condensate-leak auto-shutoff/restore for all 3 HVAC zones (#71)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>"

git add CLAUDE.md projects/climate_system.md docs/notifications.md docs/automations.md
git commit -m "docs(climate): document condensate-safety automations + HVAC-write exception #2 (#71)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>"