sillyhome-future/docs/V2_ARCHITECTURE.md

SillyHome Future v2 Architecture

Core Principle

v2 is event-first. Home Assistant state changes enter the Event Core, which updates runtime state, routes affected actuators, computes a decision, applies safety and handoff gates, then writes an audit event.

Store Split

• runtime.json: current states, audit trail and connection health
• learning.json: patterns, room profiles and scene profiles
• control.json: safety stage, handoff mode and paused automations

Control Path

LLMs are not part of the control path. Local deterministic insights may explain state, but switching decisions must remain inspectable and testable.

v2 Milestones

1. Event Core and routing index
2. Store migration and backup/restore
3. Decision Engine v2
4. Handoff Matrix
5. Rooms and scenes
6. Dashboard v2
7. Add-on hardening

Add-on Contract

The Home Assistant add-on is owned by this repository and does not copy code from sillyhome-next. It starts the v2 API with SILLYHOME_FUTURE_STORE pointing at /data/future_store, so runtime, learning and control stores are kept inside the add-on data volume.