Audamir

č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é.

· 9 min čítania

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é menoNové menoKedy
Klasik (Classic), id classicKniežatstvá (Principalities), id principalitieszobrazené meno 31. 10. 2026, id a názvy súborov 2. 11. 2026
Auda WarsAudamirmeno hry 31. 10. 2026, kľúče úložiska 2. 11. 2026
diceWars.* (kľúče úložiska)audamir.*2. 11. 2026
Hero DiceAvatar1. 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 → principalitiesdiceWars → audamir
čím staré slovo bolohodnotou: id režimu v profile, histórii, skóre a uloženej hreadresou: predpona kľúčov localStorage a mien zámkov
ak ho nový kód nepoznáriadky histórie sa zahodia, štatistika režimu je nulaprofil 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.

Kde stálo slovo classic: výskyty podľa triedyVýskyty slova classic v 266 súboroch pred premenovaním podľa triedy nástroja: id ako dáta 3 053, identifikátor 585, slovo v próze 584, súbory textov 209, úmyselne ostáva 115, kľúč textu 75, cesta k súboru 31, prvok stránky 23. Spolu 4 675.id (hodnota v dátach)3 053identifikátor v kóde585slovo v próze584súbory textov209úmyselne ostáva115kľúč textu75cesta k súboru31prvok stránky23výskyty v 266 súboroch, spolu 4 675 (hra 0.87.2, 2. 11. 2026)
Výskyty slova classic v 266 súboroch pred prepisom podľa triedy, ktorú určil nástroj rename-ids.js (hra 0.87.2, CLASSIC-RENAME). Dve tretiny sú id, teda hodnoty v dátach; tých sa týkal prvý z oboch typov premenovania.

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:

  1. Prečíta sa jeho text.
  2. 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.
  3. 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.
  4. 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.js to 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