Bootstrap SillyHome Future v2 core

docs/V2_ARCHITECTURE.md

@@ -0,0 +1,29 @@
+# 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
+