# Plán: první instalace a průvodce

Stav k 2026-11-19 (§2c, §2d, D39). Plán je pro agenta bez kontextu. Odškrtávej a piš sem nové poznatky. Navazuje na
`docs/plan/skin-optimization/020-tv-handover.md` (nikdy nečekat, řádky jsou soubory) a je s ním průnikem.

## 1. Zadání

Čisté Kodi → instalace doplňku → okamžitě náš skin (glass) a průvodce → plně připravený doplněk na Pro tebe.
Nikde prázdné místo, mrtvé tlačítko ani čekání bez informace, na co se čeká. Čekání co nejkratší.

## 2. Rozhodnutí Standy (2026-11-01)

| # | Rozhodnutí |
|---|---|
| D1 | Jazyk se nevolí, každý má Kodi nastavené na svůj jazyk. Texty cs, sk, en. |
| D2 | Hned po instalaci přepnout na skin.milionar (glass) a přes něj průvodce v designu skinu. Home až po průvodci. |
| D3 | Pořadí: Vítej → TMDb klíč → Webshare → AI → žánry → filmy → seriály → Home na Pro tebe. Ukazatel „Krok N z M“. |
| D4 | TMDb klíč je 100% povinný. Bez něj se doplněk ani Home nikdy nespustí. Každé spuštění doplňku bez klíče aktivuje skin a začne od Vítej, nic se nepřeskakuje. |
| D5 | Zpět v kroku TMDb: „Bez klíče Milionář nepoběží“ → Zadat klíč / Vrátit původní vzhled Kodi (čisté Estuary). |
| D6 | Webshare jde přeskočit, okno se pak otevře při prvním pokusu o přehrání. Po přihlášení ukáže VIP a do kdy, bez VIP jasnou větu. |
| D7 | AI jde přeskočit. Hra Milionář zůstává přesně jak je, klíč si řekne sama při startu hry. |
| D8 | Kráska OFF: nic nemazat, kód zakomentovat, v menu nikde, žádný kód se jí nezdrží. V nastavení u klíčů „dočasně nedostupné“. |
| D9 | Dotazník: žánry (víc najednou, alespoň jeden) → filmy z nich → seriály z nich. Vybrané jdou do Moje filmy / Moje seriály jako oblíbené, bez zhlédnuto. |
| D10 | Žánrové karty jako řádek Žánry na Home (ikona Kodi + název + fajfka). Žádné vlastní obrázky žánrů neexistují. |
| D11 | Tituly přes `wcs/quality` s globálním nastavením (výchozí Původ návrhů = Západní, služby, hodnocení), jako Pro tebe a Žánry. Plakátové karty s hodnocením, rokem, badge služeb a fajfkou. 20 nejlepších + Načíst další, tlačítko „Pokračovat (N)“, výběr může být prázdný. |
| D12 | Seznam žánrů stejný jako sekce Žánry. Vybrané žánry řadí i sekci Žánry. |
| D13 | Veškeré načítání živě v Kodi notifikaci průběhu (`DialogProgressBG`) s textem, na co se čeká. Tituly ke všem žánrům se stahují na pozadí už během výběru. |
| D14 | Home se otevře hned s prvním řádkem Pro tebe z dat dotazníku, ostatní dobíhají s notifikací „Ladím Pro tebe N/M“. |
| D15 | Návod k TMDb bez obrázků: QR kód, URL, stručný popis a důvod. Telefon jako ovladač je tip s přesným aktuálním návodem. |
| D16 | Průvodce se po zavření Kodi vrátí na poslední krok s tím, co už bylo vyplněné. |
| D17 | Nastavení i ozubené kolo otevírají stejná nová okna klíčů. Karta „Upravit, co mám rád“ jako první v Pro tebe spustí jen dotazník. Stávající uživatelé s klíčem průvodce neuvidí. |
| D18 | Instalace hlavně přes repozitář, ZIP doplňku musí fungovat stejně. |
| D19 | Na čistém Kodi se migrace nespouští, doplněk to pozná sám a nezdrží se. |
| D21 | StreamCinema se přihlašuje přes Krásku, proto se vypíná s ní stejně (zakomentovat, nemazat, „dočasně nedostupné“). Přehrává jen Webshare. |
| D22 | Vinyl se nestaví, dokud ho uživatel neaktivuje: při vstupu do sekce Vinyl dotaz s popisem, co Vinyl je, a potvrzením. Do té doby žádná jeho práce. |
| D23 | Všechny vady z baseline (6.) se musí opravit. |
| D20 | Okna klíčů a průvodce kompletně v designu skinu Milionář, nové texty, atraktivní, zábavné, jasné a jednoduché. |

## 2a. Stav k 2026-11-01 23:50 (předání)

Nasazeno 2.1.117 (skin 1.3.103). Standova TV aktualizovaná z našeho okna a v pořádku. Čistá instalace na TV
proběhla v dočasném Kodi (`scripts/install_harness/fresh_tv.py up/down`), TV je vrácená do Standova Kodi.

Ve workspace po 2.1.117, NEnasazeno a na Macu neověřeno: `engine.QUICK` menší (30/10/3, bez log), fáze v průběhu
na konci průvodce, karta D17 s textem „Upravit, co mám rád“ (35882–35884), kratší 35340, název pod plakátem
v průvodci, `activation.CARD_ART` (aurora) – tu vrátit, viz D25.

Naměřeno na TV (čisté Kodi, 2.1.117): instalace → Vítej 50,8 s (stažení 18 s, skin 5 s, přepnutí + výchozí 21 s);
ověření klíče 7,6 s; kroky 0,7 s; Filmy s kartami 2,9 s; první Pro tebe 54,4 s → po zmenšení 13,6 s (teplá
mezipaměť); Dokončit → Home čekalo 41,6 s; dolazení servisem 217,8 s.

Rozhodnutí Standy (předání):
- D24 MyTV prázdný stav je v pořádku, neměnit.
- D25 Nezapnutý Vinyl: jen hero s textem a tlačítkem Zapnout, ŽÁDNÁ karta v řádku (dnes je tam karta s nadpisem
  řádku „AI kurátor“). Vrátit `CARD_ART`, řešit bez řádku.
- D26 Pro tebe se po průvodci nesmí přestavět na jiný obsah. První řádek musí být hned správný z dat průvodce,
  co nejdřív, bez čekání na celou stránku. Dnes: rychlé sestavení ukáže jeden obsah, dolazení servisem jiný.
  Návrh: první řádek z výsledku průvodce zamknout (dolazení ho nemění), nebo dolazení nedělat a jen doplnit ostatní řádky.
- Karty Milionáře se donačítají správně, nic neměnit.

Jak testovat (oba harnessy mají návod v hlavičce souboru):
- Mac: `export MILIONAR_FRESH_ROOT=<scratchpad>/fresh`, pak `fresh_kodi.py up`, `install`, `expect 'Window.Property(ob.step)' welcome`,
  `click 11`, `typekey`, `keys …`, `shot NAME`, `log`, `down`. Kodi je česky, klíč z `~/.milionar-test/keys.json` se nevypisuje.
- TV: totéž přes `fresh_tv.py` (adb relay podle `.agents/skills/kodi-tv/SKILL.md`). Neodeslaný kód jde do testovacího
  Kodi na TV přes `adb push` do `/sdcard/milionar_fresh/.kodi/addons/plugin.video.milionar/`. Na konci vždy `down`.
- Kód průvodce: `wcs/onboarding/` (state, launch, wizard, picks), okno `resources/skins/Default/1080i/onboarding/`,
  brána `main._guide`, `service.py` (start_rest), Vinyl `wcs/vinyl/activation.py`, karta D17 `wcs/foryou/widgets._pick_card`.

Další kroky: ~~D26, D25, ověřit workspace změny na Macu~~ (2b), deploy, čistá instalace na TV
(`fresh_tv.py`, měřit Dokončit → Home), D5/ZIP/bez sítě, D12.

## 2b. Stav k 2026-11-02 00:25

- [x] D26 (Mac, izolované Kodi): průvodce staví první Pro tebe na pozadí po Filmech a znovu po každé změně seriálů
  (pauza 1,5 s, `wizard.start_build`, `engine.build(picks=…)`), Dokončit pak nečeká (Mac: 0,8 s stavba, Home asi
  0,4 s po kliknutí). Dolazení servisem (`build_now('onboarding', keep=True)`) nechá všechny viditelné řádky beze změny
  (`compose.rows(fixed=…)`), jen přidá chybějící. Později zrušeno, viz TV níže. `engine.QUICK['per_kind']` 3 → 8, aby
  rychlá stavba měla i Nově a Skryté klenoty (měřeno: 3 je nedá). První karta je po průvodci vždy „Upravit, co mám rád“.
- [x] D25 (Mac): nezapnutý Vinyl je jen hero s „Zapnout Vinyl“, žádná karta ani nadpis řádku. Karta zůstává jako zdroj
  hero, skin řádek skryje a fokus předá tlačítku (`milionar.hero.only`, `gen_cinema.HERO_ONLY_SLOTS`). Aurora z karty
  pryč. Enter zapne Vinyl, řádky naběhnou; fokus pak zůstane v menu na Vinylu.
- [x] Vsuvka Standy: obrazovky Home bez vlastního obrázku (karta akce, prázdná sekce, Vinyl) mají pozadí průvodce,
  auroru přes 60 % (`MilCinePlain` v `gen_cinema`, šablona `modern-presentation.xml`). `String.IsEmpty($VAR[…])` Kodi
  neumí, proto vlastní proměnná. Ověřeno na Pro tebe (karta „Upravit“) a Vinylu.
- Harness: `install` hned po `up` může selhat na `script.module.requests` (repozitář Kodi ještě nenačtený); stačí počkat 20 s.
- [x] `scripts/skin_harness/test_modular.py` Transition: 3 pády opravené. `transition.run` importuje `wcs.onboarding.state`
  (`xbmcgui`) až při běhu, test měl falešné moduly Kodi jen při načtení. Přidány testy: nová instalace volá
  `defaults.first_setup`, aktualizace ne. Kód v Kodi byl v pořádku.
- [x] Deploy 2.1.118 (skin 1.3.104) 2026-11-02 s D26, D25 a pozadím.
- [x] TV, čistá instalace 2.1.118 (2026-11-02 01:12): instalace → Vítej asi 48 s; Dokončit → Home 43 s (stavba po
  Filmech 32 s, znovu se seriály 14,7 s, příprava 8 řádků 9,6 s); dolazení servisem po průvodci 219 s s notifikací
  a bez viditelného přínosu (Standa: „mega pomalý“).
- [x] Opraveno a ověřeno na TV (01:26, kód pushnutý do testovacího Kodi): Dokončit → Home 12 s.
  - Stavba běží už při výběru filmů (`picks` i pro filmy), zastaralá se zastaví mezi fázemi (`engine.Cancelled`);
    hotové odpovědi se nestaví znovu.
  - Před Home jen první řádek s tituly (`wizard.prepare_rows`), ostatní dostaví servis.
  - Dolazení po průvodci zrušeno (`launch.REBUILD` pryč, `keep` pryč). Snímek z průvodce dostane razítko signálů
    (`wizard.settle_snapshot`), servis ho přestaví jen z běžných důvodů (změna denní doby, stáří, nové sledování).
  - Zbývá: posledních ~11 s je stavba se seriály s teplou mezipamětí (seznamy 3,3 s, detaily 4 s, skóre 3,1 s).
- [x] 2.1.120 na TV (čisté Kodi, 02:33): instalace → Vítej 43 s, Dokončit → Home 13,5 s; Home s aurorou, Vinyl jen
  hero s fokusem na Zapnout Vinyl. Zastaralá stavba se teď přeruší i uvnitř dotazů TMDb (2.1.121, `api.CANCELLED`).
- [x] 2.1.123 (TMDb přes keep-alive relaci, ověřeno na TV s pushnutým kódem): Dokončit → Home 7,2 s, poslední stavba
  8,8 s. Instalace → Vítej 44 s (2.1.122). Vinyl se ukazuje bez prodlevy.
- „Chyba harness“ na TV způsobil `fresh_kodi.py` (port 9191 byl přesměrovaný na TV). `fresh_tv.py` má teď port 9192.

## 2c. Průvodce pro každého, účet na začátku (Standa, 2026-11-07)

Navazuje na Účet Milionář (WEB `docs/plan/account-sync/01-decisions.md` S2, S11, S12, nově **S30**). Mění D3, D5, D17.

| # | Rozhodnutí |
|---|---|
| D27 | Průvodce dostane **každý, kdo ho nemá dokončený**, i stávající instalace s klíčem, které ho nikdy neviděly (ruší poslední větu D17). Bez klíče TMDb je průvodce vždy na řadě (D4). |
| D28 | Přihlášené zařízení se řídí účtem. **Každý účet webu má průvodce dokončený**, kromě účtu, jehož průvodce začatý při registraci ještě běží; ten Kodi dokončí od místa, kde stojí. |
| D29 | Vítej: **„Přihlásit účtem Milionář“** (fokus) a **„Pokračovat bez účtu“**. QR je krok okna průvodce (Účet), počítá se do kroků. Účet se nabízí jen na Vítej; od kroku TMDb se jede bez účtu. Už přihlášené zařízení má na Vítej „Přihlášeno jako …“ a Pokračovat. |
| D30 | Kroky splněné při otevření průvodce (klíč TMDb, Webshare, klíč AI) se přeskočí, i po přihlášení účtem. Zpět je přeskakuje taky. Krok, který uživatel v průvodci viděl, zůstává. „Krok N z M“ počítá jen kroky, které uživatel opravdu projde. |
| D31 | Průvodce je povinný, odložit nejde. Zpět z kroku Účet a z kroku TMDb vede na Vítej; Zpět na Vítej: „Bez průvodce Milionář nepoběží“ → Pokračovat (fokus; i Zpět z dialogu) / Původní vzhled (D5). |
| D32 | Průvodce se otevře, kdykoli je na řadě: start Kodi, otevření doplňku, odhlášení účtu (i z webu), přihlášení z menu na účet s nedokončeným průvodcem. Dokončí-li účet průvodce jinde (web), průvodce v Kodi skončí při dalším kroku. |
| D33 | Chybí jen klíč (průvodce už byl dokončený, klíč zmizel): průvodce vede jen ke klíči, dotazník se neopakuje. |
| D38 | Pod krytem průvodce zapíše `defaults.first_setup` výchozí hodnoty skinu, které chybí, i stávajícímu uživateli (D27). `<onload>` Home pod krytem čeká a po průvodci se Home znovu nenačte. |

Nalezeno 2026-11-09 ve Windows Kodi 21.3 (lahev Whisky „Kodi OLD“, doplněk 1.0 s klíčem TMDb, `scripts/install_harness/whisky_kodi.py`):
po Dokončit byl Home bez řádků („Doporučení se připravují…“, Filmy prázdné, staré menu) až do restartu Kodi. Příčina
nebyla ve Windows: `transition.run` volal `first_setup` jen pro `fresh()`. Oprava: `transition.run` i pro `state.covered()`,
`launch.prepare_skin` jako pojistka (skin přepnutý dřív: zapíše chybějící a skin načte ještě jednou), `first_setup` vrací,
zda něco zapsal. Ověřeno ve stejné lahvi: výchozí hodnoty zapsané před průvodcem, Dokončit → Home s Pro tebe za ~2 s,
8 řádků připravených. „Krok N z M“ teď ustoupí liště průběhu Kodi (D13), dřív se překrývaly.
Další vady téhož běhu, opravené a ověřené třetím během (log bez chyb):
- `settings.xml` „failed to load addon settings“: jednorázový návrat výchozích nastavení (8 zápisů, Kodi přepisuje celý
  soubor neatomicky) běžel vedle prvních vláken služby; teď `service.reset_defaults_first` před všemi vlákny (a před průvodcem).
- `database is locked`: `services/store.store` zapisoval cache v paralelní úloze bez ošetření; zápis je teď jako u
  ostatní cache (selhání = jen log, odpověď TMDb zůstane). `api.parallel` loguje soubor a řádek chyby.
- „Control 11 … asked to focus, but it can't“: `wizard.focus` čeká, až je prvek viditelný (`getControl(id).isVisible()`).
- Po průvodci se řádky Pro tebe nepřestavují: další průchody v logu jsou soubory módů Filmy/Seriály (`foryou.Nmovie|tv.m3u`).
- 2.1.142: Kodi se po každé změně skinu ptá „Ponechat vzhled?“ (`ApplicationSkinHandling::ReloadSkin`, Omega) a před
  průvodcem to problesklo. `transition.run` nastaví `Window(Home).Property(milionar.skin.confirming)` po dobu přepnutí
  a `_confirm`; `DialogConfirm.xml` skinu 1.3.113 dialog v té chvíli kreslí průhledně (fade 0, ovladače dál fungují).
- 2.1.143: přihlášení přímo v průvodci: lišta „Účet Milionář“ byla pod krytem vypnutá a po průvodci se nespustila;
  `launch.account_home()` ji po konci průvodce otevře (K10, `docs/plan/milionar-account/900-decisions.md`).
- Vydáno 2.1.141 (D38 a opravy výše), 2.1.142, 2.1.143 (2026-11-09). Standa otestoval upgrade z 1.0 ve Windows lahvi
  dvakrát bez účtu („první test prošel“, „další test prošel“); 2.1.143 s účtem testuje sám.

Technika:
- `wcs/onboarding/state.py`: `pending()` = bez klíče, nebo krok ≠ `done`; přihlášené zařízení s prázdným krokem = účet bez
  průvodce = dokončeno (D28). `fresh()` = nová instalace. `defaults.first_setup` běží vždy pod krytem průvodce (D38).
- `wcs/onboarding/plan.py` (čistá logika, testy): pořadí kroků, přeskočené kroky, Další, Zpět, „Krok N z M“.
- `wcs/onboarding/account_step.py`: krok Účet v okně průvodce (QR, kód, adresa, Nový kód, sloučení S28) nad společným
  párováním `wcs/account/pairing.py`, které používá i okno účtu z menu (`ui.PairWindow`).
- `wcs/onboarding/launch.py` `when_due()`: služba otevře průvodce po odhlášení a po přihlášení z menu (bez restartu Kodi).
- Krok `account` se nikdy neukládá (`onboarding_step` jde do účtu, web ho nezná); průvodce stojící na Účtu se vrátí na Vítej.

Ověření 2026-11-07 (izolované Kodi `fresh_kodi.py`, kód z workspace, `WEB/scripts/harness/sync-backend.ts --real-tmdb`):
- [x] Nová instalace: Vítej se dvěma tlačítky, fokus na Přihlásit, „Krok 1 ze 7“; bez účtu → TMDb „2 ze 7“; Zpět → Vítej;
  Zpět → dialog s fokusem na Pokračovat, Zpět z dialogu průvodce nechá. Příznak nové instalace → výchozí nastavení skinu.
- [x] Přihlásit → Účet „2 ze 8“ (QR, kód, adresa); Zpět → Vítej, kód zrušen; účet s hotovým průvodcem → Pokračovat → Home.
- [x] Účet s otevřeným průvodcem (registrace): klíče z účtu přeskočené, Žánry „3 ze 5“ → po opravě „2 ze 4“ se žánrem
  z účtu; Zpět → Vítej „Přihlášeno jako …“; restart Kodi na Žánrech pokračuje; Dokončit → Home, na serveru `done`.
- [x] Stávající instalace s klíčem a daty bez průvodce: po startu Kodi průvodce „1 ze 6“ (TMDb přeskočené), bez výchozího
  nastavení skinu (zastaralé: od 2.1.141 D38 je zapíše `first_setup`); přihlášení → sloučení přímo v průvodci → Home.
- [x] Odhlášení (z menu i z webu) zařízení s nedokončeným průvodcem → průvodce hned; s dokončeným → nic.
- [x] Přihlášení z menu na účet s otevřeným průvodcem → průvodce hned („Přihlášeno jako …“, „1 ze 4“). Dokončení na webu
  během otevřeného průvodce → další krok skončí na Home.
- [x] Účet bez průvodce (starý účet webu): žádný průvodce, na serveru se nezaloží žádný záznam.
- [x] Server neodpovídá → „Server Milionáře neodpovídá“, Nový kód / Pokračovat bez účtu; Nový kód po návratu serveru
  funguje. Restart Kodi na kroku Účet → Vítej. Chybí jen klíč (D33) → „1 ze 2“, po klíči Home.
- [x] Beze změny: dotazník z karty Pro tebe (Žánry → Filmy → Seriály, Zpět), okna klíčů TMDb a Webshare z nastavení.
- [x] Vydáno 2.1.138 (2026-11-07, Standův pokyn); Kodi na Macu po vydání bez průvodce a bez chyb. TV testuje Standa.
- [ ] Vypršení kódu živě neověřeno (10 min; stejná obrazovka jako výpadek serveru).
- Nálezy opravené během testu: lišta „Připravuji Home“ a hláška „Obnova widgetů dokončena“ už se neukazují přes průvodce
  (hláška patří jen k ručnímu obnovení řádků); dialog odchodu měl fokus na Původní vzhled a Zpět z něj vracel vzhled Kodi.
- Pád testovacího Kodi jednou v ovladači OpenGL macOS (`CGUITextureGL::End`), napodruhé stejný krok bez pádu.
- Chyba doplňku nalezená testem: průvodce držel jeden `xbmcaddon.Addon` po celou dobu a každý zápis kroku uložil jeho
  starou kopii nastavení, takže přepsal, co mezitím zapsal jiný proces (u přihlášeného zařízení synchronizace účtu).
  `Guide.addon` je teď vlastnost s čerstvým objektem; ověřeno: nastavení zapsané během průvodce přežilo jeho zápisy.
- Kvůli téže chybě se v testovacím Kodi smazalo skryté `account_server` a pět pokusů o párování šlo na Hub (jen
  dočasné kódy, nic nepotvrzeno, žádná data účtů). Po opravě a kontrole nastavení před párováním šlo vše na testovací backend.

## 2d. Žánry řídí návrhy (Standa, 2026-11-08)

Stejně v Kodi i na webu (WEB `docs/plan/rebuild/01-decisions.md` D43). Mění D11, dokončuje D12.

| # | Rozhodnutí |
|---|---|
| D34 | Filmy a seriály v dotazníku se berou **rovnoměrně ze všech vybraných žánrů**: střídavě nejznámější titul každého žánru (nejvíc hlasů na TMDb, Kvalita návrhů), takže malý žánr nezapadne pod velký. |
| D35 | Žánr, který TMDb u seriálů nemá, hledá seriály v nejbližším seriálovém žánru: Horor a Thriller → Mysteriózní + Krimi, Romantický → Drama, Historický → Válečný a politický, Hudební a TV film → Drama. |
| D36 | Vybrané žánry jsou **slabý signál vkusu Pro tebe** (slabší než zhlédnutý film, silnější než titul jen v seznamu) a řadí sekci Žánry i řádek žánrů (dokončení D12). Bez vybraných titulů staví Pro tebe z žánrů. |
| D37 | Web prochází průvodce stejně jako Kodi (D30): splněné kroky (TMDb, Webshare, AI) přeskočí, Zpět je přeskakuje, „Krok N z M“ počítá jen procházené kroky. Krok Účet má jen Kodi. |
| D39 | (Standa, 2026-11-19) Krok **AI klíč** v průvodci není, v Kodi ani na webu: vedle propojení ChatGPT mátl. Na jeho místě je krok **ChatGPT** jen jako info: co Milionář v ChatGPT umí (5 karet s příkladem: doporučí, přehraje, knihovna, MyTV, hra) a že se propojuje na webu v Nastavení → ChatGPT s účtem Milionář (adresa v nápovědě) a vpravo QR kód na návod na webu (`resources/media/onboarding/qr_chatgpt.png` = `https://hosting.pilsfree.net/chudy/milionar/login?next=/settings/chatgpt`: přihlášený telefon jde rovnou na návod, nepřihlášený po přihlášení; Standa 2026-11-19). Jediné tlačítko Pokračovat. Průvodce: … Webshare → ChatGPT → Žánry; ne v „jen klíč chybí“ (D33) ani v dotazníku. Krok `chatgpt` se neukládá (`state.STORED`, starší verze ho neznají); uložený `ai` pokračuje dalším krokem. AI klíč se dál zadává v nastavení. Nadpis „Řekni to ChatGPT. Milionář to zařídí.“ (font52_title, jeden řádek do 1040 px) a text s výhodami jako web (WEB D71). Texty 36073–36091. |

Technika:
- `wcs/onboarding/picks.py`: `Pool` má jeden proud na žánr (stejné id = jeden proud), `fill()` bere střídavě; `TV_NEAREST` (D35).
- `wcs/foryou/signals.py` `W_GENRE`, `chosen_genres()`; `wcs/foryou/score.py` `with_genres()` přidá žánry do profilu;
  `wcs/genres/catalog.py` zdroj `genre` → `like` (řazení Žánrů). Web: `shared/onboarding/plan.ts`, `picks.ts`, orákulum.

Ověření 2026-11-08:
- [x] Testy: `tests/test_onboarding_genres.py` (střídání, další stránka, vyčerpaný žánr, seriálové obdoby, slabý signál,
  řazení Žánrů), všechny testy doplňku 74/74, simulátor účtu `--seeds regress` 14/14. WEB orákulum: nabídka, profil,
  řazení a průběh průvodce dávají v TypeScriptu přesně výsledky tohoto kódu.
- [x] Izolované Kodi (`fresh_kodi.py`, bez účtu): Vítej 1/7 → TMDb → Webshare 3/7 → AI → Žánry 5/7; Animovaný + Válečný:
  filmy i seriály střídavě z obou žánrů; Dokončit → Pro tebe z odpovědí, log „guide genres 2“; řádek Žánry začíná
  Válečný, Animovaný (dřív je předběhlo Drama z označených titulů). „Upravit, co mám rád“ s Hororem: Stranger Things,
  Papírový dům (Mysteriózní + Krimi). Bez chyb v logu.
- Nález: vybrané žánry jako pouhý slabý signál v řazení Žánrů nestačily (žánry označených titulů je předběhly), proto
  `catalog.ordered(first=…)`: vybrané žánry vedou vždy, mezi sebou podle vkusu.

## 3. Testování

Akcent (2026-11-02, navazuje na `skin-milionar/180-branding-accent.md`): průvodce používá společné barvy doplňku
včetně kontrastního textu tlačítek a zvýrazněných textů. `Guide.onInit` jen zveřejní barvy; průběh a přihlášení
nemění. Všech sedm kroků zobrazeno ve skutečném Kodi přes neaktivní XML fixtures s limetovým a tmavě modrým
akcentem, bez spuštění jejich akcí. Při pozdějším restartu byl v pracovním profilu zjištěn rozpracovaný stav
„Vítej“; Kodi zastaveno. Před další kontrolou Home je potřeba Standovo rozhodnutí, zda tento stav zrušit.

- **Nikdy v Mac Kodi tohoto workspace** (`AGENTS.md`, Prostředí). Jen izolované Kodi `HOME=<scratchpad>/…`, pro každý test
  nové a po testu smazané. Běžný vývoj ostatních věcí dál ve workspace.
- Neodeslaný kód se testuje přes `release.py build` a místní repozitář na `127.0.0.1`. Instalace jde cestou uživatele:
  repozitář → `InstallAddon`, nebo ZIP.
- TMDb klíč pro testy je v `~/.milionar-test/keys.json`. Harness ho zapíše jen do izolovaného profilu a nevypisuje ho.
- Potom deploy (`release.py publish`, Mac Kodi vypnuté) a test na TV.

## 4. Fáze

### Fáze 1: Harness čisté instalace
- [x] `scripts/install_harness/fresh_kodi.py`: build, místní repozitář, izolovaný profil, instalace, snímky, log, úklid.
- [x] Baseline dnešní první instalace: snímky a seznam vad (6).
- [ ] Instalace ZIPem přes harness (Kodi na to nemá JSON-RPC, jen GUI).

### Fáze 2: Kráska OFF (D8, D21)
- [x] `wcs/provider_keys.KRASKA_AVAILABLE = False`; menu, hledání, přehrávání, sekce Home (`warm.hidden`), router s hláškou
  35800, nastavení s informací místo voleb. Nic smazáno.

### Fáze 3: Brána a start (D2, D4, D5, D19)
- [x] `wcs/onboarding/state.py` + `launch.coordinate`: bez klíče servis jen nainstaluje skin a otevře průvodce, ostatní
  (řádky, Pro tebe, tracker, `main()`) až po jeho konci. Migrace na čistém Kodi nic nedělají (prázdné seznamy).
- [x] Spuštění doplňku bez klíče (`main._guide`) vede vždy do průvodce od Vítej.
- [x] Jedno nastavení skinu: `defaults.first_setup` zapíše všechny výchozí hodnoty bez reloadů (`slots.reload_skin` je
  pod krytem vypnutý), paleta pak skin načte jednou. Home.xml má kryt „Připravuji Milionáře…“ (vlastnost
  `milionar.onboarding`) a jeho `<onload>` výchozí hodnoty pod krytem čekají. Dvě načtení skinu (přepnutí, paleta), obě pod krytem.
- [ ] D5 Vrátit původní vzhled: kód je (`wizard.restore_kodi_look`), živě neověřeno.

### Fáze 4: Průvodce (D3, D6, D7, D15, D16, D20)
- [x] Okno `onboarding/DialogMilionarOnboarding.xml` v podobě Home (hero, karty, fokus a záře řádků), texty cs/sk/en.
- [x] TMDb: QR (`resources/media/generate_onboarding_qr.py`, ověřený čtečkou macOS), URL, 3 kroky, tip s telefonem
  (Kore / Official Kodi Remote, ověřeno na webu 2026-11-01). Ověření klíče: špatný klíč, bez sítě, krátký klíč.
- [x] Návrat po restartu Kodi na poslední krok (D16) ověřen.
- [x] Okna klíčů TMDb a Webshare z nastavení a při přehrání otevírají totéž okno (`single`).
- [ ] Skutečné přihlášení Webshare a klíč AI živě neověřeny (nemám jejich testovací údaje).

### Fáze 5: Dotazník (D9–D13, D17)
- [x] Žánry ze sekce Žánry (4 sloupce, okraje lícují se záhlavím), filmy a seriály řazené podle počtu hodnocení přes
  Kvalitu návrhů (západní), služby, hodnocení, fajfky, Načíst další, stahování dopředu.
- [x] Výběr do Moje filmy / seriály jako `like`. Žánry v nastavení `onboarding_genres`.
- [x] D17: první karta Pro tebe „Upravit, co mám rád“ spustí jen dotazník (`wizard.run('taste')`), po něm přestavba s průběhem.
- [ ] D12: zvolené žánry řadí sekci Žánry jen přes vkus z oblíbených titulů, ne přímo z `onboarding_genres`.

### Fáze 6: Přechod na Home (D14)
- [x] Po Filmech běží rychlé první Pro tebe (`engine.build(quick=True)`, 6,8–8 s na Macu oproti 32,7 s), na konci
  se připraví soubory řádků Pro tebe a Home se otevře s plnými řádky. Servis pak Pro tebe doladí s notifikací (15–17 s).
- [x] Měřeno na Macu: Dokončit → Home 0,8 s, když na kroku Seriály uběhlo 6 s; 7,5 s v nejhorším případě (Dokončit hned).

### Fáze 7: Ověření
- [x] Celý průchod v izolovaném českém Kodi z repozitáře, klíč zadaný skutečnou klávesnicí (`typekey`).
- [ ] ZIP, bez sítě, Zpět v každém kroku, zavření Kodi uprostřed dotazníku.
- [x] Deploy 2.1.117 (skin 1.3.103) 2026-11-01.
- [x] TV, aktualizace 2.1.116 → 2.1.117 z okna v ozubeném kole (video `scripts/skin_harness/tv/upd117.mp4`): stažení
  100 %, nová služba za 4 s, kopie skinu 20 s s průběhem, jedno načtení skinu, „Aktualizováno 2.1.117“ samo. Log bez
  chyb, jeden `probe started`, `addons/temp` prázdné. Home celé (Pokračovat, Pro tebe s kartou „Upravit, co mám rád“),
  Vinyl zůstal zapnutý s daty. Vada: při načtení skinu asi 4 s prázdná obrazovka s pozadím.
- [ ] TV čistá instalace: dočasné čisté Kodi přes `/sdcard/xbmc_env.properties` (`xbmc.data=`), jen se Standovým souhlasem.

### Vinyl (D22)
- [x] `wcs/vinyl/activation.py`: dokud není zapnutý, nic se nenačítá (`warm.hidden`) a první řádek má kartu „Zapnout
  Vinyl“; zapnutí načte data s průběhem (asi 5 s na Macu) a karta se nahradí řádky. Stávající data = zapnuto.

## 5. Technický kontext

- Start: `service.py` → `wcs/skin/installer.run` (skin na disk, `DialogProgressBG`), `wcs/skin/service.run` (řádky,
  `transition.offer_startup` přepne skin a potvrdí dotaz Kodi, potom `library2.migration`).
- TMDb klíč: nastavení `tmdb_api_key`, dnes `wcs/login/DialogTMDbLogin.py` a XML v `resources/skins/Default/1080i/login/`.
- Návody: `wcs/ui/dialogs/guide/`, XML v `resources/skins/Default/1080i/guide/`.
- Kráska: `kraska_enabled` (výchozí vypnuto), ale `wcs/skin` má sekci `kraska` (StreamCinema), `SeriesSearch`,
  `resolver`, `user_data.check_providers_and_prompt`. StreamCinema získává token přes relaci Krásky (`SCClient.get_auth_token`).
- Moje filmy / seriály: `wcs/library2/store.set_in_list`. Žánry: `wcs/genres/catalog.py`. Kvalita: `wcs/quality`.

## 6. Poznatky

- Harness: `up` vždy přepne testovací Kodi do češtiny a vypne myš (uloženo v profilu), `typekey` vloží klíč do otevřené
  klávesnice Kodi uvnitř Kodi, `expect` čeká na stav, `click` klikne na id. Bez mačkání naslepo.
- Každé `ReloadSkin` zavře všechna okna: průvodce se smí otevřít až po posledním načtení skinu.
- `xbmcaddon.Addon` drží kopii nastavení: co zapíše jiný proces, vidí jen nový objekt (`state.has_key` čte čerstvě).
- JSON-RPC nemá builtiny ani `getControl` grouplistu z Pythonu: navigace dolů je podmíněný `<ondown>` v XML.

- 2026-11-01 harness `scripts/install_harness/fresh_kodi.py` funguje: workspace build → místní repozitář → izolované Kodi
  (JSON-RPC 9191) → `InstallAddon` se závislostmi z repozitáře Kodi. Dotaz Kodi na instalaci má fokus na Ne, potvrzuje se
  `SendClick(yesnodialog,11)`. JSON-RPC nemá builtiny, spouští je pomocný skript `script.milionar.harness` jen v testovacím profilu.
- Baseline téže instalace z workspace kódu (snímky po 3 s, 24 s), vady:
  1. Tři načtení skinu za sebou: přepnutí, výchozí nastavení skinu, barvy. Mezitím se mění lišta: nejdřív Continue watching,
     MyCinema, TMDb/ČSFD, pak zmizí.
  2. Pro tebe ukazuje „Recommendations are being prepared…“ s tlačítky Refresh a Remove this main menu item, text je useknutý
     („refresl“), hero prázdné.
  3. Potom Pro tebe ukazuje hero žánru Drama a jen řádek Žánry. TMDb klíč se nikdo neptá.
  4. Hned po instalaci běží Vinyl (`vinyl_curator` 5,9 s) a změny řádků, ačkoli uživatel ještě nic nemá.

- 2026-11-01 první instalace 2.1.116 v izolovaném Kodi: skin se přepne a Home se dvakrát načte znovu, bez klíče se nikdo
  nezeptá, log je plný `TMDB API klíč není nastaven`, Home ukazuje jen žánry.
