Updated VIBECHAT.md with important technical lessons\n\n- Added section on circular imports and how to avoid them\n- Documented versioning requirements for Home Assistant\n- Emphasized simplicity over complexity in error handling\n\nGenerated by Mistral Vibe.\nCo-Authored-By: Mistral Vibe <vibe@mistral.ai>

VIBECHAT.md

@@ -61,16 +61,33 @@
 - Type Hints verwenden
 - PEP 8 einhalten
 - Async/Await korrekt nutzen
+- **Circular Imports vermeiden**: Konstanten in das Modul verschieben, das sie primär nutzt
 
 ### Bluetooth
 - BLE bevorzugen (zuverlässiger)
 - Classic Bluetooth als Fallback
-- Zeitouts sinnvoll setzen
+- Zeitouts sinnvoll setzen (5-10 Sekunden)
+- **Fehlerbehandlung**: Klare Meldungen ohne komplexe Wiederherstellung
 
 ### Home Assistant
 - Add-on Standards einhalten
 - Konfiguration validieren
 - Logging für Debugging
+- **Versionierung**: Immer Version erhöhen, damit Änderungen erkannt werden
+
+### Wichtige Lektionen
+
+1. **Circular Imports**: Verursachen `ImportError` und verhindern den Start
+   - Lösung: Konstanten in das nutzende Modul verschieben
+   - Beispiel: `PRINTHEAD_PX` → `imaging.py`
+
+2. **Versionierung**: Jede Änderung needs neue Version (0.1.42, etc.)
+   - Home Assistant erkennt nur Änderungen mit neuer Version
+   - Immer config.yaml + api.py + CHANGELOG.md aktualisieren
+
+3. **Einfachheit**: Komplexe Logik oft Quelle von Problemen
+   - Bevorzuge direkte Verbindungen über Wiederherstellungsversuche
+   - Klare Fehler > komplexe Recovery
 
 ## Entscheidungsfindung