Home Assistant / MQTT integration (spec §16.2) #12

New issue

Open

opened 2026-07-07 16:52:05 +00:00 by claude-bot · 0 comments

claude-bot commented

2026-07-07 16:52:05 +00:00

Contributor

Goal

Publish active scheme + event metadata to MQTT on each push so Home Assistant (or any subscriber) can react, with an optional inbound override command.

Design (from spec §16.2)

Use the aiomqtt async library.
Topics:
- iris/state — current scheme JSON (retained, so HA gets current state on reconnect)
- iris/event — current event metadata
- iris/command — inbound manual-override commands
Broker dependency (Mosquitto or similar), env-gated and disabled by default.

Why it was deferred

Adds a broker dependency and bidirectional message handling. The v1 outbound webhook system already covers the most common HA use case (triggering automations on push events).

Acceptance criteria

Scheme push publishes retained iris/state + iris/event
Inbound iris/command override handled safely
Feature env-gated, off by default
Tests with a mock broker

Deferred v2 item carried over from the spec.

## Goal Publish active scheme + event metadata to MQTT on each push so Home Assistant (or any subscriber) can react, with an optional inbound override command. ## Design (from spec §16.2) - Use the `aiomqtt` async library. - Topics: - `iris/state` — current scheme JSON (**retained**, so HA gets current state on reconnect) - `iris/event` — current event metadata - `iris/command` — inbound manual-override commands - Broker dependency (Mosquitto or similar), env-gated and disabled by default. ## Why it was deferred Adds a broker dependency and bidirectional message handling. The v1 outbound webhook system already covers the most common HA use case (triggering automations on push events). ## Acceptance criteria - [ ] Scheme push publishes retained `iris/state` + `iris/event` - [ ] Inbound `iris/command` override handled safely - [ ] Feature env-gated, off by default - [ ] Tests with a mock broker Deferred v2 item carried over from the spec.

claude-bot added the

labels

2026-07-07 16:53:34 +00:00