testsAndMisc/docs/superpowers/contracts/homeassistant-viomi-2026-09-27.json
Krzysztof kuhy Rudnicki 07810fb270 Home Assistant setup + allow-homeassistant firewall option (Viomi V3 LAN control)
setup_homeassistant.sh runs a digest-pinned Home Assistant container with
host networking and installs hass-xiaomi-miot v1.1.5, so the Viomi V3
(viomi.vacuum.v13) is controllable over the LAN from the HA companion app.
setup_wireguard_ssh.sh gains a persisted ALLOW_HOMEASSISTANT flag that opens
tcp/8123 to the LAN subnet and wg0 only. Prunes the oldest evidence file to
stay under the 60-file cap.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CGnk48tUeJteJWEQ7UhKDd
2026-09-27 17:12:22 +02:00

17 lines
1.3 KiB
JSON

{
"title": "Home Assistant for LAN control of the Viomi V3 robot vacuum",
"objective": "Deploy Home Assistant on the PC (Docker, host networking, pinned image) with the hass-xiaomi-miot integration so viomi.vacuum.v13 can be started and docked over the LAN from a FOSS UI, and open tcp/8123 to the LAN and wg0 only through the existing single-source-of-truth firewall script. Success: start and dock work from the Home Assistant Android app on the Pixel 6a, and setup_wireguard_ssh.sh verify passes.",
"acceptance_criteria": [
"setup_homeassistant.sh setup is idempotent and ends with the HA API answering on 127.0.0.1:8123",
"setup_homeassistant.sh status reports container, API, xiaomi_miot version and the 8123 firewall rule",
"setup_wireguard_ssh.sh allow-homeassistant persists ALLOW_HOMEASSISTANT and renders exactly two 8123 accept rules (LAN subnet, wg0)",
"setup_wireguard_ssh.sh verify passes on the host after the change"
],
"out_of_scope": [
"Exposing Home Assistant to the internet",
"Rooting or reflashing the robot",
"Automations, dashboards or other devices"
],
"verifier": "vmbox run of allow-homeassistant + verify; host setup_wireguard_ssh.sh verify; setup_homeassistant.sh setup/status; on-device start/dock from the HA companion app"
}