📖 Pilíř · Příběh

Jak vznikal SMART HOME OS

Žádný plán to nebyl. Žádný roadmap dokument. Začalo to jednou žárovkou ovládanou aplikací a postupně narostlo na 116 scriptů, 203 flow a vrstvenou architekturu, kde Brain Guardian dohlíží na ostatní automatizace.

Tady je příběh — fáze po fázi, krize po krizi.

Engineering journey

7 fází evoluce

Žádná fáze nebyla naplánovaná. Každá vznikla jako reakce na limit té předchozí.

  1. Fáze 1 · ~2023

    Začátek — první automatizace v UI

    Ruční přidávání zařízení v Homey UI. Klasické Flow přes drag & drop. „Když motion → zapni světlo." Žádná architektura, žádné stavy. Funguje pár minut, pak se to přestává škálovat — víc Flow než si pamatuju, žádný dohled.

  2. Fáze 2 · script-first přechod

    Logika do skriptů — ne do Flow

    Klíčové rozhodnutí: logika patří do HomeyScript skriptu, ne do Flow karet. Flow se stávají jen triggery — script je „mozek". Vznikla první generace sh_* skriptů: sh_morning_brain, sh_light_router, sh_audio_brain. Najednou je to verzovatelné, čitelné, debugovatelné.

  3. Fáze 3 · request architektura

    Routery a request piping

    Dům začal být složitější — víc zón, víc senzorů, víc světel. Klíčový insight: oddělit „co se má stát" od „jak se to udělá". Vznikly request proměnné (sh_light_request, sh_audio_request) a routery které je interpretují. Ranní rutina už nepíše do žárovky přímo — pošle request, router rozhodne na základě phase + sleep + presence + lux.

  4. Fáze 4 · self-healing + diagnostika

    Když systém pozná, že má problém

    Sběr eventů do Google Sheets přes Apps Script WebApp. Vznikly diagnostické skripty: sh_diag_analyzer, sh_self_healing_v4, sh_audio_pipeline_watchdog. Watchdog detekuje stuck states, self-healing je resetuje. Memory_watchdog na GitHub Actions restartuje HomeyScript app při ≥125 MB. Systém přestal vyžadovat asistenci uživatele pro běžné poruchy.

  5. Fáze 5 · Dashboard V7

    UI vrstva — jeden systém, tři obrazovky

    Sidebar nav, multi-zone tiles, V5 KPI cards, status chips, drag/drop layout editor. Tři varianty: 1024×600 RPi kiosek, 1920×1080 notebook, 2880×1800 monitor. Jeden HTML soubor + responzivní CSS layer. Edit mode umožňuje uživateli přesunout dlaždice + uložit layout do localStorage.

  6. Fáze 6 · AI integrace

    Gemini jako runtime AI vrstva

    Briefing (TTS přes Cast), comfort suggest, anomaly detection. Gemini čte event log, navrhuje akce, generuje ranní hlášení. Od reactive automatizace k proactive asistenci. AI nezasahuje do řízení — je to advisor + observer vrstva.

  7. Fáze 7 · Brain Guardian

    Supervisor nad celým systémem

    Top-level supervisor — sh_expected_state_engine definuje co by mělo být, sh_state_validator srovnává s realitou, sh_brain_guardian orchestruje, sh_release_guard hlídá deployments. Score 92/100, validator 100, drift detection live. Detekoval reálné bugy — Bug E priority engine ghost, Ložnice TRV missing, ranní rutina motion vs alarm asymetrie.

Lessons learned

Co mě systém naučil

Každá z těchto věcí měla původně jednoduché řešení v hlavě. Pak se ukázalo, že to tak nefunguje.

👻 Ghost values

Proměnná zůstane stuck v non-idle stavu, protože jeden krok pipeline crashnul. sh_priority_active='tts' 14 dní blokoval lights/audio. Fix: timestamp + auto-reset stale > 60s.

⚡ Audio race conditions

TTS request přijde dřív než předchozí stop dokončí. sh_audio_current_mode overwritten v nesprávném pořadí. Fix: pipeline watchdog co sleduje ne-mode, ale request flow.

🔁 Conflict prevention

Dva flow se hádají o stejnou žárovku. Bez priority engine se to projeví jako blikání. Fix: priority hierarchy (tts=100, light=60, audio=40) + arbitration.

🪝 Silent fail orphan refs

Po re-pair zařízení dostane nové UUID. Flow trigger karty referencující staré ID = silent fail, žádný error v UI. Fix: bulk find_orphan_device_refs scanner po každém pairu.

🧠 Proč vznikl Brain Guardian

Watchdog řeší jen jeden konkrétní failure mode. Self-healing je reactive. Brain Guardian = vrstva která ví, jak má systém vypadat, a srovnává ho s tím, co skutečně dělá. Detekuje drift dřív než uživatel.

🎯 REUSE FIRST

Tendence vytvářet nové entity místo úpravy stávajících. Vede ke chaosu duplicit. Pravidlo: každá nová věc projde testem „existuje něco podobného?" — 9× z 10 ano, refaktoruj.

Co dělá systém unikátní

4 charakteristiky, které drží pohromadě

Není to checklist „smart home" produktu. Je to způsob, jak systém myslí.

Script-first automation

Logika v HomeyScript skriptech, Flow jako pouhé triggery. Verzovatelné, debugovatelné, refaktorovatelné. Žádný drag-and-drop chaos.

Self-Healing logic

Stuck states detekované watchdogy, automatické resety, app restart při memory leak. Systém běží, i když se něco rozbije.

AI-assisted diagnostics

Gemini čte event log a navrhuje, co by mohlo být špatně. Brain Guardian validuje expected vs actual. Anomaly detection bez ML modelu — jen pravidla a state machine.

Living Operating System

Dům není dokončený produkt — je to průběžně se vyvíjející systém. Každý týden komit, každý měsíc nová verze nějakého subsystému. Není to instalace, je to kultivace.

Co bude dál

Roadmap

  • Phase 8 · Q2 2026

    Hardware expansion

    Aqara FP1E presence v ložnici, Aqara P2 jídelna door (replace SNZB-04), Shelly Plug S Gen3 pro kávovar, wake button H1 u postele. Hardware na cestě.

  • Phase 9 · Q3 2026

    Per-zone heating + occupancy v topení

    Fibaro FGT-001 do ložnice, Sonoff SNZB-02P do pracovny. Heating AI vrstvy už běží — chybí jen vstupní data ze 4. zóny.

  • Phase 10 · 2026/2027

    Brain Guardian V2 + predictive maintenance

    Pravidla → ML modely (anomaly detection na event sequences). Predikce poruch zařízení dřív, než se stanou. Long-term battery tracking, runtime stats, lifetime estimates.