Corner Lamp Priority Renderer Implementation Plan¶

ssh haos 'KEY=$(ha addons info b9845f46_govee2mqtt --raw-json | jq -r .data.options.govee_api_key); \
  curl -s -H "Govee-API-Key: $KEY" https://openapi.api.govee.com/router/api/v1/user/devices \
  | jq -r ".data[] | select(.sku==\"H607C\") | .device"'

govee_api_key: "fake_govee_api_key"

# Govee Platform API key (Govee Home app → Settings → Apply for API Key).
# Used by rest_command.govee_corner_lamp_scene to fire native H607C scenes.
govee_api_key: "YOUR_GOVEE_API_KEY"

# Fire a native Govee scene on the Corner Lamp (H607C) in ONE Platform-API call.
# Native scenes are reachable on the API key alone (not blocked by govee2mqtt #649,
# which only gates real-time push / tap-to-run). The device id is a non-secret
# identifier (useless without the key); only the key is a !secret. See
# docs/superpowers/specs/2026-07-10-corner-lamp-renderer-design.md.
rest_command:
  govee_corner_lamp_scene:
    url: https://openapi.api.govee.com/router/api/v1/device/control
    method: POST
    content_type: "application/json"
    headers:
      Govee-API-Key: !secret govee_api_key
    payload: >-
      {"requestId":"ha-corner-lamp","payload":{"sku":"H607C","device":"<DEVICE_ID>","capability":{"type":"devices.capabilities.dynamic_scene","instance":"lightScene","value":{"id":{{ scene_id }},"paramId":{{ param_id }}}}}}

  # Manual override for the Corner Lamp renderer. On = script.corner_lamp_render
  # yields (stop) so you can free-paint the lamp in the Govee app. Cleared by the
  # dashboard toggle, the corner_lamp_auto webhook, or the morning wake (wake_house).
  corner_lamp_manual:
    name: "Corner Lamp Manual"
    icon: mdi:floor-lamp-torchiere

  # Dedupe token for the Corner Lamp renderer — the last render it applied
  # (e.g. "circadian:morning", "ticker:lava", "alert:strike", "off:away"). The
  # renderer skips re-sending an unchanged scene so the on-device animation
  # isn't restarted every 5-minute re-eval. Alerts bypass this (force).
  corner_lamp_last_render:
    name: "Corner Lamp Last Render"
    icon: mdi:history
    max: 32

# Corner Lamp renderer helpers — defined in configuration.yaml, registered after
# the next config deploy. Move to entities.txt via `make snapshot` post-deploy (#74).
input_boolean.corner_lamp_manual
input_text.corner_lamp_last_render

git add configuration.yaml secrets.yaml.template tests/fixtures/ci_secrets.yaml tests/fixtures/entities_allow.txt
git commit -m "feat(lighting): corner lamp scene rest_command + manual/dedupe helpers (#74)"

# Corner Lamp render primitives (#74). apply_scene = dedupe → power on → fire ONE
# Govee scene → store token. off = dedupe → power off → store token. The renderer
# (script.corner_lamp_render) is the only intended caller. Dedupe skips a no-op
# re-send (avoids restarting the on-device animation every 5-min re-eval); alerts
# pass force:true to always re-fire. See the design spec.
corner_lamp_apply_scene:
  alias: "Corner Lamp — apply scene"
  icon: mdi:floor-lamp-torchiere
  mode: queued
  max: 10
  fields:
    scene:
      description: "Scene as 'id,paramId' (e.g. '9633,16508')."
      example: "9633,16508"
    token:
      description: "Dedupe token stored after a successful apply."
      example: "ticker:forest"
    force:
      description: "Bypass dedupe (alerts always re-fire)."
      default: false
  sequence:
    - if: "{{ force or states('input_text.corner_lamp_last_render') != token }}"
      then:
        - action: switch.turn_on
          target:
            entity_id: switch.corner_lamp_power_switch
          continue_on_error: true
        - action: rest_command.govee_corner_lamp_scene
          data:
            scene_id: "{{ scene.split(',')[0] | trim }}"
            param_id: "{{ scene.split(',')[1] | trim }}"
        - action: input_text.set_value
          target:
            entity_id: input_text.corner_lamp_last_render
          data:
            value: "{{ token }}"

corner_lamp_off:
  alias: "Corner Lamp — off"
  icon: mdi:floor-lamp-torchiere
  mode: queued
  max: 10
  fields:
    token:
      description: "Dedupe token stored after turning off."
      example: "off:away"
  sequence:
    - if: "{{ states('input_text.corner_lamp_last_render') != token }}"
      then:
        - action: switch.turn_off
          target:
            entity_id: switch.corner_lamp_power_switch
          continue_on_error: true
        - action: input_text.set_value
          target:
            entity_id: input_text.corner_lamp_last_render
          data:
            value: "{{ token }}"

git add scripts.yaml
git commit -m "feat(lighting): corner lamp apply-scene + off render primitives (#74)"

# Corner Lamp priority renderer (#74) — owns light.corner_lamp via native Govee
# scenes. Same choose-stack pattern as script.night_lights_render. Priority (top
# wins): manual→yield · alarm→Strike · leak→Thunderstorm · away→off · asleep→off ·
# market+fresh SOFI→ticker · else→circadian. Everything is an ANIMATED scene (never
# a solid color) except off/yield. Re-render triggers: automation
# corner_lamp_render_triggers. Full design + scene-id table: the design spec.
corner_lamp_render:
  alias: "Corner Lamp — render"
  icon: mdi:floor-lamp-torchiere
  mode: restart
  sequence:
    - choose:
        # 0. Manual override → yield. You own the lamp via the Govee app until the
        #    flag clears (dashboard toggle / corner_lamp_auto webhook / morning wake).
        - conditions: "{{ is_state('input_boolean.corner_lamp_manual','on') }}"
          sequence:
            - stop: "manual override — renderer yields"
        # 1. Alarm triggered → Strike (electric lightning). force: always re-fire.
        - conditions: "{{ is_state('alarm_control_panel.blairmont_alarm','triggered') }}"
          sequence:
            - action: script.corner_lamp_apply_scene
              data:
                scene: "9693,16568"
                token: "alert:strike"
                force: true
        # 2. Leak wet → Thunderstorm (water-themed, distinct from alarm). force.
        - conditions: "{{ is_state('binary_sensor.any_leak_wet','on') }}"
          sequence:
            - action: script.corner_lamp_apply_scene
              data:
                scene: "9705,16580"
                token: "alert:thunderstorm"
                force: true
        # 3. Away (nobody home) → off. Below alerts on purpose.
        - conditions: "{{ states('zone.home') | int(0) == 0 }}"
          sequence:
            - action: script.corner_lamp_off
              data:
                token: "off:away"
        # 4. Asleep → off.
        - conditions: "{{ is_state('input_boolean.sleeping','on') }}"
          sequence:
            - action: script.corner_lamp_off
              data:
                token: "off:sleep"
        # 5. Market hours (Mon–Fri 09:30–16:00 ET) → SOFI ticker. Freshness-gated:
        #    stale/missing quote → neutral Ocean (guards the #47 stuck-value failure).
        - conditions: >-
            {{ now().weekday() < 5
               and '09:30' <= now().strftime('%H:%M') < '16:00' }}
          sequence:
            - variables:
                fresh: >-
                  {{ has_value('sensor.sofi_change_pct')
                     and states.sensor.sofi_quote is not none
                     and (now() - states.sensor.sofi_quote.last_updated).total_seconds() < 1200 }}
                pct: "{{ states('sensor.sofi_change_pct') | float(0) }}"
            - choose:
                - conditions: "{{ not fresh }}"
                  sequence:
                    - action: logbook.log
                      data:
                        name: "Corner Lamp"
                        message: "SOFI quote stale/missing — showing neutral Ocean."
                    - action: script.corner_lamp_apply_scene
                      data:
                        scene: "9635,16510"
                        token: "ticker:stale"
              default:
                - variables:
                    tier: >-
                      {% set a = pct | abs %}
                      {% if pct <= -4 %}lava
                      {% elif pct <= -2 %}fire
                      {% elif pct <= -0.5 %}sunset_glow
                      {% elif a < 0.5 %}ocean
                      {% elif pct < 2 %}rustling_leaves
                      {% elif pct < 4 %}forest
                      {% else %}green_reign{% endif %}
                    tmap:
                      lava: "9645,16520"
                      fire: "9647,16522"
                      sunset_glow: "9649,16524"
                      ocean: "9635,16510"
                      rustling_leaves: "9656,16531"
                      forest: "9634,16509"
                      green_reign: "29882,41597"
                - action: script.corner_lamp_apply_scene
                  data:
                    scene: "{{ tmap[tier | trim] }}"
                    token: "ticker:{{ tier | trim }}"
      # 6. default → circadian scene by ET time block (weekends + weekday off-hours).
      default:
        - variables:
            block: >-
              {% set h = now().hour %}
              {% if 5 <= h < 8 %}sunrise
              {% elif 8 <= h < 12 %}morning
              {% elif 12 <= h < 17 %}afternoon
              {% elif 17 <= h < 20 %}sunset
              {% elif 20 <= h < 23 %}starry_sky
              {% else %}candlelight{% endif %}
            cmap:
              sunrise: "9558,16433"
              morning: "9668,16543"
              afternoon: "9669,16544"
              sunset: "9631,16506"
              starry_sky: "9707,16582"
              candlelight: "9666,16541"
        - action: script.corner_lamp_apply_scene
          data:
            scene: "{{ cmap[block | trim] }}"
            token: "circadian:{{ block | trim }}"

git add scripts.yaml
git commit -m "feat(lighting): corner lamp priority renderer — circadian + SOFI ticker + alerts (#74)"

python3 -c "import secrets; print('manual', secrets.token_hex(16)); print('auto', secrets.token_hex(16))"

##############################################################################
# 24. Corner Lamp Renderer (#74)
##############################################################################

# Re-render the Corner Lamp on every governing signal. script.corner_lamp_render
# owns the priority stack; this just calls it. /5-min tick refreshes the market
# ticker; time triggers mark the circadian block boundaries.
- alias: "Corner Lamp — Render Triggers"
  id: corner_lamp_render_triggers
  triggers:
    - trigger: state
      entity_id:
        - input_boolean.corner_lamp_manual
        - input_boolean.sleeping
        - binary_sensor.any_leak_wet
        - alarm_control_panel.blairmont_alarm
        - zone.home
        - sensor.sofi_change_pct
    - trigger: sun
      event: sunset
    - trigger: sun
      event: sunrise
    - trigger: time
      at:
        - "05:00:00"
        - "08:00:00"
        - "12:00:00"
        - "17:00:00"
        - "20:00:00"
        - "23:00:00"
        - "09:30:00"
        - "16:00:00"
    - trigger: time_pattern
      minutes: "/5"
    - trigger: homeassistant
      event: start
  actions:
    - action: script.corner_lamp_render
  mode: single

# Manual override ON — renderer yields so you can free-paint in the Govee app.
- alias: "Corner Lamp — Manual On (webhook)"
  id: corner_lamp_manual_webhook_on
  triggers:
    - trigger: webhook
      webhook_id: <MANUAL_WEBHOOK_ID>
      allowed_methods:
        - POST
        - GET
      local_only: false
  actions:
    - action: input_boolean.turn_on
      target:
        entity_id: input_boolean.corner_lamp_manual
  mode: single

# Manual override OFF — hand the lamp back to the renderer.
- alias: "Corner Lamp — Manual Off / Auto (webhook)"
  id: corner_lamp_manual_webhook_off
  triggers:
    - trigger: webhook
      webhook_id: <AUTO_WEBHOOK_ID>
      allowed_methods:
        - POST
        - GET
      local_only: false
  actions:
    - action: input_boolean.turn_off
      target:
        entity_id: input_boolean.corner_lamp_manual
    - action: script.corner_lamp_render
  mode: single

git add automations.yaml
git commit -m "feat(lighting): corner lamp render triggers + manual on/off webhooks (#74)"

    # 3. Corner Lamp — hand it to the renderer for the day. Clear any manual override
    #    (guaranteed daily reset), then render (→ circadian/ticker; turns the power
    #    switch on itself). Replaces the old raw 3× power+segment turn-on (#65, #74).
    - action: input_boolean.turn_off
      target:
        entity_id: input_boolean.corner_lamp_manual
    - action: script.corner_lamp_render

git add scripts.yaml
git commit -m "refactor(lighting): wake_house clears corner_lamp_manual + renders (was raw turn-on) (#74)"

grep -rn "corner_lamp_cozy\|corner_lamp_sunset\|corner_lamp_fireplace\|corner_lamp_ocean\|corner_lamp_aurora\|corner_lamp_cyberpunk\|corner_lamp_lavender\|corner_lamp_focus\|corner_lamp_rainbow\|corner_lamp_gradient" \
  automations.yaml lovelace/ *.yaml 2>/dev/null

git add scripts.yaml
git commit -m "refactor(lighting): remove 10 corner_lamp gradient scripts — native scenes replace them (#74)"

git add projects/govee_floor_lamp.md projects/smart_lighting_scenes.md CLAUDE.md docs/lighting.md docs/automations.md
git commit -m "docs(lighting): document corner lamp renderer; correct native-scenes-blocked claim (#74)"

ssh haos 'grep -q "^govee_api_key:" /config/secrets.yaml || echo "govee_api_key: \"REPLACE_ME\"" >> /config/secrets.yaml; \
  grep "^govee_api_key:" /config/secrets.yaml'

ssh haos 'diff <(ha addons info b9845f46_govee2mqtt --raw-json | jq -r .data.options.govee_api_key) <(grep "^govee_api_key:" /config/secrets.yaml | sed -E "s/.*\"(.*)\".*/\1/") && echo MATCH'

git checkout main && git merge --no-ff feat/corner-lamp-renderer -m "feat(lighting): corner lamp priority renderer (#74)"
git push
gh run list --workflow=ci.yml --limit 1

gh run watch $(gh run list --workflow=ci.yml --limit 1 --json databaseId -q '.[0].databaseId')
ssh haos "ha core logs --lines 20"

ssh haos 'KEY=$(ha addons info b9845f46_govee2mqtt --raw-json | jq -r .data.options.govee_api_key); \
  DEV=$(curl -s -H "Govee-API-Key: $KEY" https://openapi.api.govee.com/router/api/v1/user/devices | jq -r ".data[]|select(.sku==\"H607C\").device"); \
  for V in "9693,16568" "9705,16580"; do \
    curl -s -X POST -H "Govee-API-Key: $KEY" -H "Content-Type: application/json" \
    -d "{\"requestId\":\"t\",\"payload\":{\"sku\":\"H607C\",\"device\":\"$DEV\",\"capability\":{\"type\":\"devices.capabilities.dynamic_scene\",\"instance\":\"lightScene\",\"value\":{\"id\":${V%,*},\"paramId\":${V#*,}}}}}" \
    https://openapi.api.govee.com/router/api/v1/device/control | jq -r .msg; sleep 10; done'

ssh haos 'jq "[.data.exposed_entities|to_entries[]|select(.value.assistants[\"cloud.alexa\"].should_expose==true)|.key]|length" /config/.storage/homeassistant.exposed_entities'

make snapshot

git add tests/fixtures/entities.txt tests/fixtures/entities_allow.txt
git commit -m "chore(snapshot): corner lamp helpers in, retired gradient scripts out (#74)"
git push