časť 43
Dve premenovania za jeden deň
Id režimu classic sa zmenilo na principalities a predpona diceWars na audamir. Prvé slovo bolo hodnotou v dátach, druhé adresou dát, preto sa riešili inak. Čo sa čítalo, čo písalo, ako sa overilo a čo ostalo neoverené.
Dňa 2. novembra 2026 sa do vývojovej verzie hry Audamir dostali dve premenovania. Režim Kniežatstvá (Principalities) dostal id principalities namiesto classic (verzia 0.90.5). Predpona kľúčov úložiska sa zmenila z diceWars na audamir spolu s menami súborov, ktoré hra ukladá (0.92, patch 3). Hra je len vo vývojovej podobe, vo verzii 0.97.1; o nasadení pre hráčov nič netvrdím.
Obe premenovania vyzerajú rovnako: staré slovo sa nahradí novým. Rozdiel je v tom, čím staré slovo v hre bolo. **classic je hodnota v dátach: stojí v profile, histórii partií, tabuľke skóre a v uloženej hre, takže bez mapovania čítačka nevie, do ktorého režimu dáta patria. diceWars je adresa dát**: diceWars.profile je meno kľúča, pod ktorým prehliadač drží celý profil. Kto nový kľúč nenájde, nenájde nič. Hodnotu stačí pri čítaní namapovať, adresu treba presunúť a pritom nič nestratiť. Preto sa riešili inak.
Čísla sú z dokumentov hry, z git log a z pečatí overenia; čo sa nepodarilo overiť, je na konci.
Pomenovania, ktoré sa tu stretávajú
Tabuľka je glosár pre celý blog. Staré články ostávajú v starom názve ako záznam doby; nové píšu nové meno a staré v zátvorke.
| Staré meno | Nové meno | Kedy |
|---|---|---|
Klasik (Classic), id classic | Kniežatstvá (Principalities), id principalities | zobrazené meno 31. 10. 2026, id a názvy súborov 2. 11. 2026 |
| Auda Wars | Audamir | meno hry 31. 10. 2026, kľúče úložiska 2. 11. 2026 |
diceWars.* (kľúče úložiska) | audamir.* | 2. 11. 2026 |
| Hero Dice | Avatar | 1. 11. 2026 |
Pozadie mena hry je v článku Ako sa hra volá: od Dice Wars - Forever k Auda Wars.
Dve slová, dve úlohy
Kniežatstvá dostali nové zobrazené meno 31. októbra, no id classic a všetky uložené dáta ostali. Dňa 2. novembra to prestalo stačiť: do hry prišli Kmene (pozri Kmene: kópia, ktorá sa dá zmerať) a vety Kniežatstiev o „pôvodnej hre Dice Wars“ prestali byť pravdivé. Preto bolo potrebné, aby slovo classic nezostalo nikde, a aby sa diceWars volal audamir ako projekt.
classic → principalities | diceWars → audamir | |
|---|---|---|
| čím staré slovo bolo | hodnotou: id režimu v profile, histórii, skóre a uloženej hre | adresou: predpona kľúčov localStorage a mien zámkov |
| ak ho nový kód nepozná | riadky histórie sa zahodia, štatistika režimu je nula | profil sa číta ako prázdny |
| čo sa urobilo | čítajú sa oba pravopisy, píše sa nový | kópia, prečítanie späť, porovnanie, až potom zmazanie starého |
Inventár: čo sa musí nájsť
Slovo classic zmieňovalo v hre 0.86.0 309 sledovaných súborov. Nástroj odohral hráča skutočnými funkciami a našiel 15 miest v úložisku, napríklad štatistiku režimu, riadky histórie, 39 krokov úspechov, tabuľku skóre a meno kľúča rozohranej hry. Dokument ďalej vymenúva 16 tichých pascí, pri ktorých sa nič nehlási:
- riadok histórie s neznámym režimom sa zahodí, a tak zmizne až 1 500 partií,
- štatistika neznámeho režimu sa číta ako nula,
- neznáme id krokov úspechov: 39 krokov je zamknutých, získajú sa a zaplatia znova.
Pri Audamire je pascí 21 a miest 15 (K1 až K15). Dve sú pozoruhodné. Kľúč diceWars.save.classic nesie obe staré mená naraz: predponu aj id režimu. A diceWars.profile.unreadable je jediná kópia profilu, ktorý sa nepodarilo prečítať; nič ju nečíta, takže bez presunu by zostala pod menom, ktoré nikto nehľadá.
Jazyk sa číta pred úložiskom: I18n načíta nastavenia pri prvom skripte, pred Store, takže presun by prišiel neskoro. Číta si preto oba názvy sám.
Nástroj, ktorý rozozná komentár od reťazca
Slovo classic je v kóde na príliš veľa miestach v príliš rôznych úlohách na obyčajné nahradenie. tools/rename-ids.js má malý lexer JavaScriptu, takže vie, či rovnaké písmená stoja v komentári, v reťazci alebo v kóde. Z 4 675 výskytov v 266 súboroch sú dve tretiny id, teda hodnoty v dátach.
Nejasných miest bolo 45. Typický príklad je vlastnosť { coins, classic }: je to premenná aj kľúč. Riadok mapy rozhodne, že premenná sa premenuje, kľúč ostane id a zápis sa vypíše naplno (classic: principalities).
Nástroj pre Audamir (tools/audamir-rename.js) lexer nepotrebuje: staré pravopisy sú predpony a kmene, nikdy identifikátory. Id, ktoré súbor nesie, nikdy nepíše stroj: staré id sa musí ďalej čítať a niekto ho musí zaradiť do zoznamu starých.
Kniežatstvá: čítať obe, písať jeden
Premenovanie išlo po vrstvách a každá je samostatná skupina commitov, ktorú sa dá vrátiť osamote. Najprv všetky čítače čítajú oba pravopisy, a až potom sa zapisuje nové id. Vďaka tomu je otočenie jedna konštanta (LegacyIds.MODE_CANON) a dá sa vrátiť bez straty.
Pri čítačoch bolo pascí viac. Tri, ktoré dokument pomenoval:
- Poradie úspechov. Migrácie starej revízie hovoria o
classic-untouchable-N, takže premenovanie krokov musí bežať po nich. - Hash snímky kryje aj
meta.mode, preto sa stará snímka prijme alternatívnym hashom s pôvodným pravopisom. - Meno súboru záznamu obsahuje režim. Za jeden deň vznikli dve nové mená. Podľa dokumentu je to jediná zmena, ktorú hráč pri Kniežatstvách vidí.
Audamir: presun dát
Presun je zámerne opatrný. Pre každý starý kľúč, ktorý existuje:
- Prečíta sa jeho text.
- Ak nový kľúč neexistuje, zapíše sa ten istý text, prečíta sa späť a porovná. Ak zápis zlyhá (plné úložisko, odmietnutie), vrátia sa kópie z tohto behu, nič sa nezmaže a relácia ide ďalej na starých menách. Ďalší štart to skúsi znova.
- Ak nový kľúč už existuje: rovnaký text, starý zmizne; iný text, oba ostanú, nový sa používa a starý sa nečíta, nemení ani nemaže, lebo ho môže niesť zápis karty starého buildu.
- Až keď sú všetky kópie overené, odstránia sa staré kľúče.
Presun musel bežať skôr, než plán čakal: Store.migrateKeys() beží ako úplne prvé v App, pretože app.js číta nastavenia a profil už pri načítaní skriptu. Čerstvý starý zámok je signál: karta starého buildu, ktorá hru hrá, je „niekto iný“, takže nová karta ju neprevezme omylom.
Dôkazy s dátami starého kódu
Dáta nevyrobí človek rukou, vyrobí ich starý kód a načíta ich nový. Oba dôkazy (principalities-migration.js, audamir-migration.js) majú rovnaký tvar: starý strom z git archive odohrá hráča skutočnými funkciami a nový strom prečíta, čo vzniklo. Pri oboch sa výsledok zhodol s tým, čo sľúbil plán.
Dôkaz sa overil mutáciami: zámerne pokazený čítač alebo presun. Pri Audamire ukázal slabinu v samotnom dôkaze. Úložisko, ktoré odmietne už prvý nový kľúč, nezachytí presun, ktorý maže príliš skoro. Dve mutácie prežili, až kým nebolo úložisko plné od tretieho nového kľúča.
Okrem starých dát museli ostať bit po bite rovnaké aj veci, ktoré s premenovaním nesúvisia. Pečať troch stromov to potvrdzuje: 196 odtlačkov základu AI sa zhoduje a 12 zlatých záznamov a 3 zlaté mapy sú rovnaké okrem id režimu (zlaté súbory majú staré id, lebo sú to staré dáta). Pečať porovnáva aj mená testov: pri strome po premenovaní id režimu je 82 mien zo základu preč a 109 nových, a všetkých 82 „stratených“ obsahuje slovo Classic. Premenovanie slova teda mení aj názvy testov a porovnanie o tom musí vedieť.
Rozhodnutie: všetko teraz
Plán Kniežatstiev pôvodne počítal s opatrnejšou cestou: tri prenosné formáty (súbor záznamu, odkaz #R=, súbor snímky) sa mali 14 dní písať so starým id, lebo dáta mohol držať niekto iný. Rozhodnutie z 2. novembra bolo: zmeniť všetko teraz, nech sa k tomu nevraciam.
Pri Audamire platí to isté: staré mená sa čítajú navždy a nepíše ich nikto, bez lehoty. Priečinok hry sa premenoval v ten istý deň, lebo nebežali žiadne sessions.
Cena je napísaná v dokumentoch: návrat na starší build sa nepodporuje. Záloha z nového buildu v starom stratí štatistiky Kniežatstiev a po prvom štarte nového buildu sú kľúče pod audamir., ktoré starý build nečíta. Pred prvým štartom má preto vzniknúť záloha, ktorá neobsahuje mená kľúčov a dá sa importovať do každého buildu.
Poradie voči Kmeňom bolo také, že prepisy čakali na zlúčenie práce na Kmeňoch, kde bolo 56 zmenených súborov a v každom slovo. Pri Audamire bolo poradie opačné než v pláne: hlavná session dala súhlas skôr.
Kde sa to skoro pokazilo
- Prepis urobil z viet nezmysel. Slovo sa nahradilo aj vo vetách, ktoré o starom mene hovorili: riadok glosára „Principalities (was Classic)“ sa stal „Principalities (was Principalities)“ a test sa volal „Principalities is Principalities“. Opravilo sa v R3.
- Dôkaz sa zrazil s Kmeňmi. Keď pribudli štyri reťazce úspechov Kmeňov, množina id nového kódu mala osem takých, ktoré starý kód mať nemôže. Kontrola spadla a prvá oprava to nevyriešila; druhý celý beh
verify.jsto našiel. - Skúšky na kópii nachytali viac. Pri Kniežatstvách na kópii zlyhalo 14 z 534 testov. Pri Audamire po otočení na skutočnom strome zlyhalo 11 z 3 989 testov. Všetky sa opravili.
Čo sa nepodarilo overiť
Čo je rozhodnuté
Rozhodnutie: celý rozsah naraz, id principalities, bez prechodného obdobia, slot sa premenuje, predpona audamir., prípona .amr.json. Rozhodnuté: tvar identifikátorov, limit 20 znakov v tabuľke skóre, hash skrinky pod starým pravopisom a poradie stránky pred hrou.
Čo si z toho odnášam
- Najprv treba zistiť, či je slovo hodnotou, alebo adresou. Hodnota sa mapuje pri čítaní; adresa sa presúva, a pri nej hrozí prázdny profil.
- Čítače pred zápisom. Vrstva, v ktorej všetko číta oba pravopisy, robí z otočenia jednu konštantu.
- Presun má poradie: kópia, prečítanie späť, porovnanie, až potom zmazanie. Pri zlyhaní nič nemazať.
- Dôkaz sa overuje mutáciami. Aj ostrý dôkaz mal slabinu, ktorú ukázali prežité mutácie.
Zdroje a poznámky
- Dokumenty hry (repozitár
audamir, verzia 0.97.1):docs/CLASSIC-RENAME.mdadocs/AUDAMIR-RENAME.md. - Vlastné výpočty: časy z commitov a
git reflog, počty výskytov a 10 jednotiek zo 48 v pripnutom reťazci. - Súvisiace články: Ako testovať hru, ktorá sa nikdy neprestane meniť, Kmene: kópia, ktorá sa dá zmerať.