Bootstrap SillyHome Future v2 core

README.md

@@ -0,0 +1,32 @@
+# SillyHome Future
+
+SillyHome Future is the v2 side project for a local-first Smart Home controller.
+It is intentionally separate from `sillyhome-next` so v1 can stay stable while
+v2 experiments with a cleaner production architecture.
+
+## v2 Shape
+
+- Event Core first: Home Assistant events drive decisions, APIs mostly read state.
+- Split stores: runtime, learning and control data are persisted separately.
+- Decision Engine v2: safety gates, causal trigger support and audit-first output.
+- Handoff Matrix: explicit states for HA automation takeover and rollback.
+- Rooms and scenes: groups are first-class planning objects.
+- No LLM in the control path.
+
+## Run
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+uvicorn app.main:app --reload
+```
+
+## Test
+
+```bash
+pytest
+ruff check .
+mypy app tests
+```
+