# Plán: bezbolestná aktualizace a žádné čekání

## 0. Stav k 2026-11-01 23:50 (předání, čti první)

Navazuje na `docs/plan/onboarding/000-plan.md` (první instalace a průvodce). Oba plány jdou spolu: měření
a optimalizace se teď dělají i na čistém Kodi, na Macu i na TV.

- Nasazeno 2.1.117 (skin 1.3.103). G1 ověřené na TV: aktualizace 2.1.116 → 2.1.117 z okna v ozubeném kole prošla
  sama až k „Aktualizováno“. Log bez chyb, Home i Vinyl celé. Vada: při načtení skinu asi 4 s prázdná obrazovka s pozadím.
- Fáze A (G1 na Macu) proběhla v izolovaném Kodi: instalace z dialogu 2,6 s. Zbytek fáze A (vadný ZIP, bez sítě,
  rozbitý `service.py`, závislosti, místo) zůstává otevřený.
- Čisté Kodi pro testy: Mac `scripts/install_harness/fresh_kodi.py`, TV `scripts/install_harness/fresh_tv.py` (dočasná
  datová složka přes `/sdcard/xbmc_env.properties`, Standovo Kodi zůstává nedotčené, `down` ho vrátí). Návod je v hlavičkách.
- Nové měření z TV (čisté Kodi): instalace → průvodce 50,8 s (stažení 18 s, přepnutí skinu a výchozí 21 s); první
  Pro tebe ve fázi průvodce 54,4 s → po `engine.QUICK` 13,6 s; dolazení Pro tebe servisem 217,8 s se studenou mezipamětí.
- Ke G2 a G5 přibylo: Pro tebe se po průvodci přestaví na jiný obsah (D26 v plánu onboarding). První řádek musí být
  hned správný a dolazení nesmí měnit, co uživatel už vidí.
- Kráska a StreamCinema jsou vypnuté (`wcs/provider_keys.KRASKA_AVAILABLE`) a nic se kvůli nim nenačítá. Vinyl se
  nenačítá, dokud ho uživatel nezapne (`wcs/vinyl/activation.py`). Obojí ubírá práci při startu.
- Pořadí další práce: D26 a D25 v plánu onboarding, pak fáze B (audit čekání) měřená na čistém Kodi (Mac i TV),
  pak C a D tohoto plánu. Zkrátit 21 s přepnutí skinu a 4 s prázdné obrazovky při načtení skinu po updatu.

## 0c. Stav k 2026-11-02 12:35 (čti první)

Nasazeno **2.1.125** (skin 1.3.107) a **Standova TV na něm běží**, aktualizovaná z našeho okna: 2.1.124 → 2.1.125
Enter → Aktualizováno **14,1 s**, „service idle after 0.0 s“, žádné čekání na vlákna ani zabití, `addons/temp`
prázdné, všechny sekce plné (video `scripts/skin_harness/tv/live_switch.mp4`). Testovací soubor z 0b uklizen.

Zamrznutí Kodi při aktualizaci (TV, ostrá i dočasná se zapnutým Vinylem) — příčina a oprava, ověřeno ve zdrojácích
Kodi 21 (`xbmc/interfaces/python/PythonInvoker.cpp`, zapsáno v `.agents/rules/kodi-python.md`): Kodi po `stop()` čeká
5 s na konec skriptu a ten skončí, až když skončí i všechna jeho vlákna (i daemon). Na TV trvá krok práce servisu
(řádek, úloha knihovny, síť) sekundy, takže po vypnutí doplňku nestihly skončit, Kodi servis zabilo a zamrzlo.
- `update_apply` nastaví `milionar.update.applying`, žádný krok práce na pozadí pak nezačne (`userfirst.give_way`,
  také řádky aktuální sekce v `journal._sweep` a `_settle`) a počká, až běžící kroky (`userfirst.working`: úlohy servisu,
  `journal.prepare`, stavba Pro tebe) doběhnou (`_drain`, nejvýš 20 s). Teprve pak vypne doplněk.
- Krok uprostřed (`breathe`) na výměnu nečeká (dřív se úloha knihovny zastavila a výměna na ni čekala 20 s).
- `service.py` po abortu počká nejvýš 4 s na svá vlákna a ve 3 s zapíše, co ještě běží (`wait_for_threads`).
- `recover` drží `applying`, aby úklid nového servisu nesmazal starou verzi před potvrzením.
- Ověřeno: TV dočasné Kodi se Vinylem 4× aktualizace v 5/15/40/90 s po startu bez zabití; ostrá TV 2.1.124 → 2.1.125.
- Přechody ze starších verzí (≤ 2.1.123) tuto ochranu nemají: na Standově TV dvakrát zamrzly, po restartu Kodi se
  doplněk pokaždé sám obnovil (`recover`).

## 0b. Stav k 2026-11-02 05:35

Nasazeno **2.1.123** (skin 1.3.107). Na Standově TV je zatím 2.1.121, aktualizaci na 2.1.123 nešlo dokončit: TV
přešla do pohotovosti (adb offline). **Pozor:** při pokusu o `fresh_tv.py up` na ní nejspíš zůstal
`/sdcard/xbmc_env.properties` (Kodi by se po zapnutí spustilo s prázdnou testovací složkou; Standova data nedotčená).
Hned po zapnutí TV: `fresh_tv.py down`. Harness nově po neúspěšném `up` uklízí sám.

Hotovo od 0a (vše ověřené, kde je uvedeno):
- C1 Logotypy služeb: dávka přepíše jen karty svých titulů (`rowfiles.apply_services`), dřív přestavba až 31 typů
  řádků. Mac: řádky mají `milionar.svc.*`, testy `test_journal`.
- C2 Označení epizody dál přestavuje řádky, které titul ukazují: nutné kvůli hero („Další epizoda“), běží na pozadí
  s přednostním uživatelem. Ponecháno záměrně.
- C3 Vinyl: první prázdná odpověď už nehlásí změnu (`vinyl/widgets.refresh`).
- C4 `_settle` při přerušení: pokryto testy journalu (older row waits / is not held back). C5 žánry: stránka staví
  řádek vždy celý, vzor chybějícího souboru tam není.
- D V1 Probliknutí: sekce s otevřeným vlastním detailem/žánrovou stránkou se skrývá sama (`MilCineOwns_*`), skupina
  2000 se už neskrývá. Video Mac před: 0,2 s hero a řádek Seriálů, po druhé úpravě 0,2 s teplé sekce Filmy; po opravě
  jen prolnutí pozadí. Návrat do sekce a zavření detailu ověřeny.
- D V2 Panel se šipkou je neprůhledný (dvě vrstvy skleněné textury), text poslední karty neprosvítá. Mac snímek.
- B W1, W3, W7 (0a). W5 zámek `_build` platí jen pro řádky bez souboru, sekce ukazují hotové soubory hned: ponecháno.
  W2/W4/W6: busy dialog jen při přehrávání (resolve), Kráska vypnutá, práce servisu ustupuje uživateli (`userfirst`).
- TMDb v Pro tebe přes jednu keep-alive relaci a klíč z mezipaměti: TV průvodce Dokončit → Home 15 s → 7,2 s,
  poslední stavba 16,7 s → 8,8 s (detaily 8,9 → 5,0 s, skóre 3,8 → 0,6 s).
- Zastaralá stavba průvodce se přeruší i uvnitř dotazů (`api.CANCELLED`): na TV 4–8 s místo až 23 s.
- Vinyl před zapnutím: předem načtený (`warm.warmable`) a hero si zdroj určí sám (`gen_cinema.source`): na TV
  0,8 s prázdné obrazovky → stejné načasování jako ostatní sekce (přechod 300 ms je animace Estuary, schválená).
- Přepnutí sekcí na TV po průvodci (řádky se dostavují): lišta, hero i řádky se mění ve stejném snímku jako u
  ostatních sekcí (video `scripts/skin_harness/tv/warm_switch2.mp4`).

Otevřené: aktualizace Standovy TV na 2.1.123 a její kontrola, úklid `xbmc_env.properties`, video prázdné obrazovky po
ReloadSkinu při aktualizaci.

## 0a. Stav k 2026-11-02 02:50

Nasazeno **2.1.121** (skin 1.3.105). Standova TV aktualizovaná z našeho okna 2.1.117 → 2.1.121 a zkontrolovaná.

| Co | Výsledek (TV, změřeno) |
|---|---|
| Čistá instalace 2.1.120 → Vítej | 43 s |
| Průvodce Dokončit → Home | 13,5 s (2.1.120); dřív 43 s |
| Aktualizace v dočasném Kodi 2.1.110 → 2.1.120, 2.1.120 → 2.1.121 | Enter → Aktualizováno 9,4 s / 10 s, `addons/temp` prázdné, přejmenování na FUSE funguje (P5) |
| Ostrá TV 2.1.117 → 2.1.121 | Enter → Aktualizováno 51 s: stažení a rozbalení 37 s (běží stará 2.1.117), výměna 3 s, kopie skinu 8 s, jeden ReloadSkin. Všechny sekce plné, Vinyl zapnutý s daty, v logu žádný Traceback ani V5 |

Hotovo v kódu (podrobnosti ve fázích A a B): rychlý návrat staré verze, instalace nových závislostí, obnova po
přerušené výměně, úklid `addons/temp`, servis skončí do 5 s, výchozí časový limit sítě, W1, novinky z `changelog.txt`,
fokus okna aktualizace na TV (dřív zůstal na Později), přerušení zastaralé stavby Pro tebe i uvnitř dotazů TMDb.

Ve workspace po 2.1.121 (nenasazeno): keymapa bez neplatného `<select>` (log „Can't find button select“).

Otevřené: B (W2, W4, W5, W6, měření přepínání pod zátěží), C celé, D: V1 neověřeno, **V2 viděno na TV** (text
epizody poslední karty zajíždí pod průhledný panel se šipkou, „S1 · E22“), V4 = D24 (neměnit), V5 čisté. Prázdná
obrazovka po ReloadSkinu na TV změřená není (záznam se nepodařil). Stažení 15 MB balíčku a rozbalení 1 047 souborů
trvá na TV 37 s, to je hlavní čekání aktualizace.

Stav k 2026-11-02 00:25: D26 a D25 hotové a ověřené na Macu v izolovaném Kodi (plán onboarding 2b). Dolazení
Pro tebe po průvodci už nemění viditelné řádky ani nenačítá skin (G2, G5): přepisuje jen soubory nových řádků
(`service.changed_rows`). Home bez obrázku má pozadí průvodce. Nasazeno 2.1.118 (skin 1.3.104). TV čistá instalace: Dokončit → Home
43 s → 12 s po opravě (plán onboarding 2b), dolazení Pro tebe po průvodci (219 s na TV) zrušeno.

Stav k 2026-11-01. Plugin 2.1.116 a skin 1.3.102 jsou publikované a nainstalované na TV. Nic není commitnuté.
Plán je pro agenta bez kontextu. Pracuj po fázích, odškrtávej a piš sem nové poznatky.

## 1. Zadání

Doplněk se musí na slabé TV chovat jako rychlá aplikace: aktualizuje se jedním klikem v našem dialogu, po aktualizaci
nic nebolí a uživatel nikdy nečeká na něco, kde už není.

| Cíl | Co Standa chce | Hotovo, když |
|---|---|---|
| **G1 Aktualizace** | Plně z našeho dialogu, i s vypnutými aktualizacemi v Kodi, bez menu Kodi. U všech lidí bez chyby, nic se nerozbije | Nainstalovat v dialogu dojde samo až k Aktualizováno. Selhání nechá funkční starou verzi a Zkusit znovu |
| **G2 Nikdy nečekat** | Žádné zaseknutí na loadingu. Přechod do jiné sekce se zobrazí ihned, i když se jinde něco načítá | Ve všech stavech z 9.3 je obsah sekce ve stejném snímku jako pohyb lišty, nejpozději do 300 ms. Odejít jde vždy |
| **G3 Bezbolestný update** | Žádné minuty sestavování řádků, které už uživatel má | Bez změny skinu žádný ReloadSkin. Řádky jsou použitelné hned, přestavba běží jen v klidu |
| **G4 Úplné řádky** | Herci v Ted Lasso a všude jinde | Každý viditelný nadpis má karty, také po updatu s otevřeným detailem |
| **G5 Žádná zbytečná práce** | Označení epizody ani změna nesmí přestavovat, co se nezměnilo. Cache všude | Mění se jen dotčené karty, bez změny dat se nic nestaví |

Standova slova ke G2: problém není přepínání, když je vše načtené, ale když je nějaká změna, akce, sestavování Pro tebe
nebo stav po aktualizaci. Okrajové případy si máš domyslet a projít sám. Všímej si každé vady na snímcích, prázdný řádek
Herci měl agent vidět sám.

## 2. Pravidla práce

- **Testuje se na macOS.** Na TV až když to Standa v daném úkolu řekne (`AGENTS.md`, `.agents/skills/kodi-tv/SKILL.md`).
- **Deploy jen na Standův pokyn** a jen `python3 scripts/release.py publish`, Mac Kodi musí být vypnuté. Commit jen na výslovnou žádost.
- Viditelnou změnu vzhledu a změnu nastavení Kodi dělej jen s jeho souhlasem. Ikony jen z Kodi.
- Generované XML neupravuj ručně, změny patří do `scripts/skin_harness/gen_*.py`.
- Texty vždy cs, sk, en. Nastavení nepřepisuj v kódu. Přihlašovací údaje nevypisuj.
- Workspace se nikdy neaktualizuje z repozitáře (`update.is_workspace`). `release.py` nikdy bez 100% zálohy `dev/current`.
- Testuj cíleně. `tests/` spouštěj po souborech, `unittest discover` dohromady padá na pořadí importů.
- Standovi piš česky a extrémně stručně, jen ověřené věci. Při předání dej číslované kroky: kde začít, co stisknout, co uvidí.
- Otázky jen prostým textem v závěrečné odpovědi. Souhlas platí jen z jeho odpovědi v chatu.

## 3. Stav

Značky: ✅ ověřeno, 🟡 jen offline testy, ❌ neověřeno, ➖ na macOS nejde.

| Položka | Kód | macOS | TV |
|---|---|---|---|
| G1 Instalace v dialogu | hotovo | ✅ izolované Kodi | ✅ 2.1.121 (2026-11-02, 51 s) |
| G1 Návrat staré verze | hotovo, rychlý (5 s) | ✅ izolované Kodi | ❌ (nezkoušeno) |
| G1 Nové závislosti ve verzi | hotovo | ✅ izolované Kodi | ❌ |
| G1 Obnova po přerušené výměně | hotovo (Home → recover) | ✅ izolované Kodi | ✅ ostrá TV 2× |
| G1 Servis skončí do 5 s | hotovo (drain, wait_for_threads) | ✅ | ✅ 2.1.125 (14,1 s) |
| G2 Přepnutí sekce v klidu | hotovo | ✅ | ✅ |
| G2 Přepnutí během přestavby | změřit | ❌ | ❌ |
| G2 Přepnutí módu Pro tebe | jen první řádek synchronně (W1) | ✅ 1,6 s bez souborů | ❌ |
| G2 Ostatní cesty W1–W7 | prověřit | ❌ | ❌ |
| G3 Bez zbytečného ReloadSkinu | hotovo | 🟡 | ❌ |
| G3 Přestavba v klidu (`_settle`) | hotovo | 🟡 | ❌ |
| G4 Řádek bez souboru se postaví | hotovo | 🟡 | ❌ |
| G5 Označení epizody | hotovo | ✅ | ✅ |
| G5 Zbytečné přestavby po změně | zbývá | ❌ | ❌ |

Na TV ověřené: fajfky a hero epizody v Ted Lasso, označení epizody změní kartu i hero, přepnutí sekce v klidu.
Herci na TV byli při posledním pohledu ve 20:54 prázdní, oprava je nainstalovaná, ale neviděl jsem ji.

## 4. Fáze

Každá fáze končí zápisem výsledků do tohoto plánu. Fáze A až D běží jen na macOS.

### Fáze A: Skutečná instalace na macOS (G1)

Workspace instalaci odmítá, proto je potřeba druhé Kodi s vlastním profilem. Jestli jde spustit přes
`HOME=<dočasná složka> /Applications/Kodi.app/Contents/MacOS/Kodi`, nebo přes `--portable` s kopií aplikace, není ověřené.

- [x] Rozjet druhé Kodi, které nesdílí profil s workspace a nezná jeho `.git` ani `.agents`.
- [x] Nainstalovat do něj release ZIP z `https://hosting.pilsfree.net/chudy/kodi/plugin.video.milionar-latest.zip`.
- [x] Snížit verzi v jeho `addon.xml`, aby dialog nabídl publikovanou verzi. Není k tomu potřeba publikovat ani TV.
- [x] Spustit Nainstalovat a ověřit předpoklady P1 až P7 z 5.1.
- [x] Bez sítě a s vadným ZIP: nic se nezmění, nabídne se Zkusit znovu.
- [x] Rozbitý `service.py` v testovací kopii: stará verze se vrátí a doplněk je zapnutý.
- [x] Zavření dialogu a Kodi během instalace: doplněk zůstane použitelný.
- [x] Nové závislosti: ZIP s novým `<import>` se dnes nainstaluje bez něj. Doplnit instalaci závislostí, nebo bezpečné odmítnutí.
- [x] Nedostatek místa a složka bez zápisu: čitelná chyba, stará verze běží.
- [x] Texty 32770, 32772, 32776 smazat, nic je nepoužívá.
- [x] Opravit nalezené a přidat testy do `scripts/skin_harness/test_update.py`.

Výstup: instalace ověřená živě na macOS, seznam rozdílů oproti Androidu.

Výsledek 2026-11-02 (Mac, izolované Kodi + `scripts/install_harness/update_lab.py`: vlastní HTTPS repozitář s certifikátem
důvěryhodným jen v testovacím profilu, varianty balíčku z workspace buildu):

| Případ | Výsledek |
|---|---|
| Běžná aktualizace z okna (Enter) | Aktualizováno za 2,7–3,2 s, servis běží, `addons/temp` prázdné, skin se nepřeinstaloval |
| Bez sítě při kontrole | za 1 s „nepodařilo ověřit“, fokus na Zkusit znovu, po návratu sítě nabídne verzi |
| Síť spadne před stažením, 404 | za 0,6 s Selhalo, stará verze běží |
| Poškozený ZIP (CRC), jiná verze v balíčku | za 0,6 s Selhalo s textem „Stažená verze je poškozená“ (nově 35752) |
| Nový `service.py` nenaběhne | dřív návrat staré verze za 95 s; nově `update_apply` čte traceback z logu: 5,2 s |
| Nová závislost | nově se nainstaluje před výměnou (`InstallAddon` + potvrzení dotazu Kodi), 6,2 s; neznámá závislost: Selhalo za 16 s s názvem doplňku (35753) |
| `addons/temp` bez zápisu | za 0,6 s Selhalo s textem o místě (35751); místo se kontroluje i před stažením (4× balíček) |
| Zavřít okno během instalace | doběhne, okno Aktualizováno se samo otevře |
| Ukončení Kodi 0,5–2,0 s po Enteru (5×) | po startu běží nová verze, `addons/temp` prázdné (nově `update.tidy` při startu servisu) |
| Aktualizace 1–11 s po startu servisu (6×) | 2,7–3,0 s, žádné zabití servisu |

Opravené vady:
- **Zamrznutí Kodi**: aktualizace do 10 s po startu servisu. `threading.Timer(10)` (start trackeru) nereagoval na
  ukončení, Kodi servis po 5 s zabíjelo a celé Kodi zamrzlo; po restartu zůstal doplněk vypnutý. Nově čekání přes
  `abort_monitor`. Pravidlo: každé vlákno servisu musí skončit do 5 s po abortu (ověřeno výpisem vláken: do 1 s).
- Sestavení Pro tebe v servisu se při abortu zastaví (`api.MONITOR`, `engine.Cancelled`).
- **Obnova po přerušené výměně** (výpadek proudu, zamrzlé Kodi): Home skinu spustí `update_apply.py recover`
  přes `RunScript` s cestou (běží i u vypnutého doplňku). Ověřeno živě: vypnutý doplněk zapnut za 0,3 s, chybějící
  složka doplňku vrácena z `temp/milionar-previous`. Builtin `EnableAddon` existuje, ale vždy se ptá dialogem (AddonBuiltins.cpp), `InstallAddon` druhý parametr ignoruje a ptá se také; `RunScript` recover je tichý a umí i chybějící složku.
- Texty 32770, 32772, 32776 a nepoužívaný 32779 smazány.
- Testy: `scripts/skin_harness/test_update.py` 29 testů (závislosti, důvody selhání, recover, tidy, rychlý návrat).

Známé: během výměny (asi 2 s) je Home za dialogem prázdné (`System.AddonIsEnabled`); okno aktualizace zůstává vidět.
Na Androidu ještě ověřit přejmenování na FUSE (P5) a časy.

Poznatky 2026-11-01 (fáze pozastavená, Standa dal přednost první instalaci; testovací profil smazán):
- Druhé Kodi jde spustit přes `HOME=<složka> /Applications/Kodi.app/Contents/MacOS/Kodi`, profil i log jsou oddělené.
- Ručně rozbalený doplněk Kodi nechá vypnutý, zapnutí přes JSON-RPC spustí servis, instalaci skinu a dva ReloadSkiny.
- Instalace 2.1.115 → 2.1.116 z dialogu prošla: `installing` → `installed` za 2,6 s, Doplňky hlásí 2.1.116 zapnutý (P1, P2, P6).
  Okno Aktualizováno (`resume`) jsem neviděl, test byl přerušen.
- 237 souborů `__pycache__` v release ZIP je záměr (`build_zip.sh` přikládá bytecode). Keymap `milionar-home.xml` hlásí `Keyboard Translator: Can't find button select`.
- Log `[DEBUG][Milionář Perf]` běží i v čistém profilu bez `perf_watch`.

### Fáze B: Audit čekání (G2)

Měř na workspace Kodi. `scripts/skin_harness/ux/scen.py LABEL 5 --stale` simuluje stav po updatu (mění čas `main.py`),
`ux/throttle.py 5` zpomalí Kodi na 1/5, `ux/video_switch.py` natáčí lištu. Je to náhrada TV, ne TV.

- [ ] Změřit přepnutí Filmy, Seriály, Vinyl během `_settle`.
- [ ] Změřit přepnutí během sestavování Pro tebe a hned po označení epizody.
- [x] W1 `journal.switch_mode`: synchronně jen do prvního řádku s kartami, zbytek dostaví pozadí (`request_mode`).
      Mac, chybějící soubory módu Filmy: ukázáno za 1,6 s, všech 8 řádků plných.
- [ ] W2 Busy dialogy Kodi: `PlayMedia`, `ActivateWindow(..., plugin://)`, `executebuiltin(..., True)`, `Container.Update`.
- [x] W3 `pages.Loading` a detail bez cache: odchod volá `pages.cancel`, běžící načtení skončí `Stale` na dalším
      kroku; každý krok má teď časový limit (W7). Ověřeno čtením kódu.
- [ ] W4 Pluginové sekce a fronta jobů Kodi: nečekají kvůli nim soubory řádků nebo obrázky?
- [ ] W5 Zámek `_build`: rozdělaná stavba drží frontu až 7 s, jde to zkrátit?
- [ ] W6 Co drží GIL: `wcs/foryou/service.py`, `wcs/skin/warm.py`, `wcs/library2/jobs.py`, tracker. Kratší kroky a ustoupení uživateli.
- [x] W7 Mrtvá síť: 30+ volání `requests` bez limitu (TMDbClient, Webshare API, UI.py, LibraryManager…). Nově
      `wcs/net.py` dá každému volání bez limitu (6 s spojení, 30 s mezi bajty), zapnuté v `main.py` i `service.py`,
      ověřeno offline (server bez odpovědi: chyba za 2 s při testovacím limitu) i v Kodi; `urlopen` má 30 s.
- [x] Při ukončení servisu (aktualizace, konec Kodi) nic nesmí běžet déle než 5 s: Timer pryč, sestavení Pro tebe
      se zastaví (fáze A).
- [x] V3 Novinky: `release.py` bere `<news>` ze záznamu verze v `changelog.txt` doplňku (dřív jen z changelogu skinu,
      kde byl automatický řádek, takže okno ukazovalo obecný text).
- [ ] Čistá instalace bez souborů řádků: co uživatel vidí a jak dlouho.
- [ ] Každý nález opravit a změřit znovu.

Výstup: tabulka stav → naměřený čas před a po. Co nejde změřit na macOS, patří do fáze F.

### Fáze C: Zbytečná práce (G3, G5)

- [x] `refresh.changed(SERVICE_ROWS)` (`wcs/skin/service.py:269`) po dávce log streamingů přestaví 31 typů řádků. Přepsat jen dotčené karty.
- [x] Po označení epizody se dál staví 3 řádky po 2,5 až 3 s. Ponecháno: hero „Další epizoda“ se mění (0b).
- [x] Vinyl hlásí `change event` při každém startu a po 15 min, i s 0 kartami. Hlásit jen skutečnou změnu.
- [x] Ověřit, že `_settle` doběhne, když ho přerušují požadavky.
- [x] Zkontrolovat stejný vzor chybějícího souboru v `wcs/genres/page.py:379`.

### Fáze D: Vady

- [x] V1 Probliknutí Filmů při odchodu ze sekce s otevřeným detailem (Seriály → MyTV) na 0,3 s přes hero předchozí
      sekce. Zdroj: animace `VisibleChange` v `gen_cinema.py` kolem řádku 275 a `MilCineOverlayHere`.
- [x] V2 Poslední viditelná karta: text `S4 · E5` překrývá panel se šipkou (`S4 · E`).
- [x] V3 Skin beze změny nemá nový changelog, takže `<news>` v dialogu zůstává staré. Novinky brát odjinud.
- [x] V4 MyTV prázdný stav nabízí Odebrat tuto položku hlavní nabídky. Záměr (D24 v plánu onboarding).
- [x] V5 Ověřit, že se v 2.1.116 neopakují `Control 50 in window 13000`, `Non-Existent Control 103` a `int() ... NoneType` v `skin_detail_row`. Log Standovy TV s 2.1.121: 0 výskytů.

Výstup: spuštěné cílené testy ze 7.2 a srovnání snímků.

### Fáze E: Vydání, jen na Standův pokyn

- [ ] Vše z A až D odškrtnuté, nebo výslovně odložené.
- [ ] Mac Kodi vypnuté a `python3 scripts/release.py publish` prošel. Výsledek převzít z JSON reportu.
- [ ] Standovi napsat, co je v release a co je potřeba ověřit na TV.

### Fáze F: TV, jen na Standův pokyn

Postup je v `.agents/skills/kodi-tv/SKILL.md`, checklist v 9.

Stav z konce minulé práce: obrazovka zůstala v Doplňky / Dostupné aktualizace, na TV leží `perf_watch`. Po návratu na Home
se může objevit Aktualizováno z předchozí instalace. Log po startu 2.1.116 jsem četl jen do 21:06:16.

- [ ] Vrátit se na Home, zkontrolovat Herci, Doporučujeme, Podobné u Ted Lasso, jiného seriálu a filmu.
- [ ] Přečíst log od startu 2.1.116: běžel `_settle`, nebyl ReloadSkin, nejsou chyby.
- [ ] Aktualizovat z dialogu a natočit celý průběh. Je to první ostrý test G1 na TV.
- [ ] Projít celý checklist 9.
- [ ] Změřit, co nejvíc brzdí pohyb po kartách, a dát Standovi volbu R1.
- [ ] Smazat `perf_watch` z TV.

### Fáze G: Závěr

- [ ] Tři aktualizace po sobě z dialogu bez kroku v menu Kodi a bez chyby v logu.
- [ ] Aktualizovat `010-native-rows.md`, `docs/plan/skin-milionar/250-update.md` a tento plán.
- [ ] Předat Standovi číslované kroky k vyzkoušení.
- [ ] Standa to potvrdil na TV.

## 5. Technický kontext

### 5.1 Aktualizace

Kodi z Pythonu neumí nainstalovat novou verzi nainstalovaného doplňku: `InstallAddon` u nainstalovaného nedělá nic a
`UpdateAddonRepos` přeskočí doplněk s vypnutými aktualizacemi. Proto se doplněk instaluje sám:

1. `wcs/skin/update.py` `install`: stáhne ZIP vedle indexu repozitáře, ukazuje procenta, zkontroluje id, verzi, povinné
   soubory, cesty a CRC a rozbalí ho do `addons/temp/milionar-update`.
2. `RunScript` spustí `wcs/skin/update_apply.py`, samostatný skript jen se stdlib, protože servis nemůže zastavit sám sebe.
   Vypne doplněk, počká na konec `milionar.service` (20 s + 2 s), přejmenuje složky, zavolá `UpdateLocalAddons` a doplněk zapne.
3. Nový servis má 90 s na nastavení `milionar.service`. Jinak se vrátí stará verze.
4. `update.resume` ukáže Aktualizováno, nebo Selhalo se Zkusit znovu.

`wcs/update_policy.py` dál brání Kodi aktualizovat doplněk samo. Podrobnosti: `docs/plan/skin-milionar/250-update.md`.

Předpoklady, které vychází jen ze znalosti zdrojáků Kodi a **nikdy neběžely naživo**:

- P1 `RunScript` s cestou běží i při vypnutém doplňku a neskončí s ním.
- P2 `Addons.SetAddonEnabled false` na běžícím doplňku projde a zastaví servis.
- P3 Co se stane s Home, když zmizí vše s `System.AddonIsEnabled(plugin.video.milionar)`. Skin má na plugin `<import>`.
- P4 Servis skončí dřív, než enable spustí druhou instanci. `CServiceAddonManager` po Stop maže záznam hned.
- P5 Kodi neskenuje `addons/temp` a přejmenování funguje na Android FUSE. Na Windows může selhat na otevřené složce.
- P6 `UpdateLocalAddons` načte novou verzi. Kontroluj ji v Doplňcích, nejen v `addon.xml`.
- P7 `reuselanguageinvoker` je zapnutý, starý interpret může chvíli žít se starými moduly.

Známá rizika: výpadek proudu mezi disable a enable nechá doplněk vypnutý. Lidé pod 2.1.116 musí jednou přejít přes
menu Kodi, protože staré tlačítko má race (`Dialog.Close` a hned `ActivateWindow`, log `Activate of window '10040' refused`);
obchází se zavřením dialogu do 4 s. Dočasná změna `general.addonupdates` je zakázaná, aktualizovala by i cizí doplňky.

### 5.2 Řádky

Řádky sekcí jsou soubory `rows/<sekce>.<slot>[mód].m3u`, které Kodi čte v C++ bez Pythonu. Servis je jen přepisuje
(`wcs/skin/rowfiles.py`, `journal.py`). Popis a limity Kodi: `010-native-rows.md`.

- Skin ukazuje řádek, když má položky, na Python nečeká. Python zdržuje jen akce a vybrání hero sekce.
- Python má v Kodi jeden společný GIL, `wcs/skin/userfirst.py` proto dává přednost uživateli.
- `journal._state_of` vrací `current`, `older` nebo `build`. `older` znamená stejná data od předchozí verze.
- `_sweep` nejdřív označí řádky se souborem, potom staví chybějící (fokus první). Nakonec `_settle` staví `older` po jednom, po 5 s
  bez klávesy, nejvýš po 30 s čekání, s pauzou do 3 s, a ustoupí každému požadavku.
- Pro tebe má soubor pro každý mód. `foryou.N ... 0 cards` v logu je jiný mód, ne ztráta dat.
- Detail `d.<media>.<id>.<sezóna|all>.<kind>`, žánry `g.<token>.<slot>`.

### 5.3 Příčina prázdných Herců

Detail Ted Lasso zůstal otevřený přes update z 2.1.112. `_publish(kinds=...)` obnovuje jen dotčené řádky, takže Herci,
Doporučujeme a Podobné nikdy nedostaly soubor. Nově `rowfiles.attach` vrátí False a `detail._publish` takový řádek postaví vždy.

### 5.4 Co už bylo vyloučeno

- Prodleva 55 s, kterou jsem v chatu přisoudil ReloadSkinu, nebyla pravda. TV celou dobu kreslila.
- Řádky nečekají na příznaky z Pythonu, Kodi soubory čte samo.
- Text „0 / 0“ v seznamu aktualizací je prázdný seznam po instalaci, ne chyba.

## 6. Měření na TV

| Co | Výsledek |
|---|---|
| Přepnutí sekce v klidu | lišta, hero i řádek ve stejném snímku videa |
| Idle Home | 0 snímků; Kodi asi 44 % jádra, hlavní vlákno 27 %, servis do 8 % |
| Pohyb po kartách | 10–12 fps, hlavní vlákno 40 %, tedy limit GPU, ne CPU |
| Hero po změně karty | animace 1,5–2,5 s |
| Označení epizody | akce do 0,6 s, karty přepsané za 0,6 s, pak 3 řádky na pozadí |
| Update na 2.1.115 (poprvé, bez souborů) | první průchod 48 s, módy Pro tebe 20 s, druhý průchod 45 s |
| Stavba jednoho řádku | po startu Pro tebe 3–5 s, Vinyl 5–7 s, později asi 1 s; Moje filmy a seriály pod 1 s |
| ReloadSkin | sám pod 1,5 s, potom 5,4 s prázdná Home (`Includes_MilionarCinema.xml` má 870 kB), stejně při startu Kodi |

Zatím neměřeno: přepnutí během přestavby, studený start, přehrávání, detail bez cache, změna módu, první spuštění, dlouhý běh.
Měření z Macu při 1/5 CPU jsou v `010-native-rows.md`. Rozhodují měření z TV.

## 7. Soubory a testy

### 7.1 Změněné soubory

- Nové: `wcs/skin/update_apply.py`, `wcs/skin/rowfiles.py`, `wcs/webshare/search_cache.py`, `scripts/skin_harness/ux/`,
  `scripts/skin_harness/tv/`, `.agents/skills/kodi-tv/`, `.agents/rules/testing.md`, `scripts/library_harness/test_search_cache.py`.
- Poslední úpravy: `wcs/skin/update.py`, `journal.py`, `rowfiles.py`, `detail.py`, `scripts/skin_harness/deploy_check.py`,
  texty 32767, 35748, 35749, `.agents/skills/kodi-skin/SKILL.md`.
- Celý strom je necommitnutý nad `efdea3c`.

### 7.2 Testy

```bash
python3 scripts/skin_harness/test_update.py
```

```bash
python3 scripts/skin_harness/test_journal.py
```

```bash
python3 scripts/skin_harness/test_detail.py
```

```bash
cd tests && python3 -m unittest test_release
```

Prošly také `test_update_policy`, `test_refresh_service`, `test_commands`, `test_userfirst`. Celá sada `scripts/` po posledních změnách
spuštěná nebyla.

## 8. Rozhodnutí pro Standu

- **R1 Plynulost karet.** Limit je GPU. Možnosti: Kodi `videoscreen.limitgui` 720p, nebo jednodušší překryvy a karty.
  Předtím změřit dočasnou úpravou XML na TV, co stojí nejvíc: hero fanart, `shade_foot`, `shade_wide`, sklo lišty.
- **R2 Sekce s detailem.** Seriály si drží otevřený detail i po odchodu. Je to záměr, změnit jen když to Standovi vadí.

## 9. Checklist na TV (fáze F)

### 9.1 Po každé instalaci
- [ ] Verze v Doplňcích souhlasí s `addon.xml`.
- [ ] V logu není `Traceback`, `EXCEPTION`, `failed to load addon settings` ani dvojí `probe started`.
- [ ] `installing skin.milionar` a `ReloadSkin` jen při změně skinu.
- [ ] Všechny sekce ukazují karty, `rows/` má jejich soubory.

### 9.2 Aktualizace
- [ ] Zkontrolovat aktualizace ukáže novou verzi a novinky.
- [ ] Nainstalovat: procenta rostou, Zavřít funguje.
- [ ] Po zavření dialogu instalace doběhne a Aktualizováno se ukáže samo.
- [ ] Během instalace nic nezamrzne ani nezmizí nastálo.
- [ ] Běží jeden servis, `addons/temp` je prázdné.
- [ ] Běžící přehrávání instalace nerozbije.
- [ ] Bez sítě: Selhalo, Zkusit znovu, stará verze běží.
- [ ] Aktualizace z detailu, z Pro tebe a hned po startu Kodi.
- [ ] Automatické aktualizace Kodi zůstaly vypnuté.

### 9.3 Přepnutí sekcí, změřit videem

Stavy: klid, po startu Kodi, během `_settle`, během sestavování Pro tebe, po označení epizody, po změně módu, během
načítání detailu bez cache, při pomalé síti.

- [ ] Filmy
- [ ] Seriály
- [ ] Pro tebe
- [ ] Vinyl
- [ ] Milionář
- [ ] Odchod z rozložené sekce zpět i do lišty

### 9.4 Detail a sledování
- [ ] Série, Epizody, Herci, Doporučujeme, Podobné jsou plné u seriálu i filmu.
- [ ] Platí to přes update, přes restart servisu i při čerstvém otevření.
- [ ] Označení: fajfka, hero, Pokračovat, karta seriálu, ostatní řádky beze změny.
- [ ] Skutečné přehrání: rozkoukáno, pruh postupu, návrat na Home.

### 9.5 Výkon
- [ ] Idle bez snímků a bez nečekané zátěže.
- [ ] Pohyb po kartách: fps před a po změně.
- [ ] Studený start: čas do ovladatelné Home.
- [ ] Hodina běhu: paměť neroste.

## 10. Historie

| Verze | Požadavek | Výsledek |
|---|---|---|
| 2.1.110 | Zaseknutí při ukončení Kodi | Monitor vzniká první v `service.py` |
| 2.1.110 | Hero žánrové karty s mezerami | sjednoceno se zbytkem skinu |
| 2.1.112 | Zhlédnuté na všech kartách, epizoda v hero | `milionar.seen/resume/percent`, `hero.episode` |
| 2.1.113 | Označení přenačítalo vše, pomalá TV | řádky jako soubory, cache Webshare 6 h |
| 2.1.114 | Sekce s kartami Estuary ztratily obrázky | `PLUGIN_SECTIONS` zůstaly pluginové |
| 2.1.115 | Dokončení řádků | detail bez blikání, sweep sleduje fokus |
| 2.1.116 | Aktualizace v dialogu, Herci, bezbolestný update | oddíly 5.1 až 5.3 |

Zařazení drobných oprav k verzím je přibližné. Celý průběh je v přepisu
`/Users/chudy/.claude/projects/-Users-chudy-Library-Application-Support-Kodi-addons-plugin-video-milionar/e6edb566-2161-4402-bbb2-786978bee6bd.jsonl`.
