Events & automations

Home Keeper fires a Home Assistant bus event for every meaningful change so you can automate on it — tasks (created, updated, completed, uncompleted, completion-edited, deleted, armed, and the time-based overdue / due-soon transitions), spare parts (low stock, out of stock, restocked), and appliances (created, updated, deleted).

You can trigger on these two ways: pick a device trigger in the visual automation editor (e.g. "Task became overdue", "Spare part out of stock" — no event names to memorise), or use a plain platform: event trigger. For example, spare part out of stock → add it to the shopping list:

automation:
  - alias: "Spare out of stock → shopping list"
    trigger:
      - platform: event
        event_type: home_keeper_part_out_of_stock
    action:
      - service: todo.add_item
        target: { entity_id: todo.shopping_list }
        data:
          item: "{{ trigger.event.data.part_name }} ({{ trigger.event.data.vendor }})"

Events are edge-triggered (one event per crossing, never repeated each cycle) and silently baselined on restart (no "overdue" storm after a reboot). The full catalog — every event, its payload, and more examples — is in docs/EVENTS.md.