Flag opt-in `adventure` (default off) — zero regresie non-adventure.
E0: `adventure:false` in defaultState + checkbox builder + `ADVENTURE` in orchestrator.
E1: `_lastGiven` in libJS; `checkAnswer` captureaza raspunsul; `campaignDone`
calculeaza cheia branch ('*'/text-tf/index-choice) si o adauga in payload nextRoom.
E2: `resolveBranch(idx,key)` + rutare nextRoom: 'end'→owExitUnlocked+showOverworld;
numar→owUnlocked[dest]+showOverworld(dest). Non-adventure: comportament existent.
E3: `owCheckEnter` blocheaza usi incuiate (ADVENTURE&&!owUnlocked); exit via
owExitUnlocked. `owRefreshDoors`: stil `.locked` (dim+lock). `__ow.state`:
expune owUnlocked/owExitUnlocked.
E4: `saveProgress` adauga doneList+owUnlocked+owExitUnlocked+target; `tryResume`
reconstruieste din doneList non-contiguu (nu bucla liniara 0..idx).
E5: `buildDiploma`: ADVENTURE&&!roomDone[i] → 'neexplorata' (nu stele inselatoare).
E6: Builder UI — `normalizePuzzle` garanteaza p.branch={}; `cleanState` clampa
tintele+strip branch cand !adventure; `puzzleCard` afiseaza dropdown-uri
ramificare per-puzzle (free=1, tf=2, choice=1/optiune); `data-fb` handler;
`adventure` change → renderPuzzles().
Smoke 35/35 (4 teste noi: branch-jump, resume non-contiguu, regression, tf branch).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
4.1 KiB
4.1 KiB
AGENTS.md — Escape Room Builder (root)
Generator de jocuri escape room: un singur fișier HTML, fără backend/build/dependențe.
Același set de puzzle-uri se exportă în 6 motoare de joc. Acest arbore AGENTS.md e
sursa de adevăr tehnică pentru agenți.
Protocol DOX
- Citire — înainte de a edita un path, cobori din rădăcină citind fiecare
AGENTS.mdîntâlnit; dacă un părinte indexează un copil al cărui scope conține path-ul, citești copilul. - Editare —
AGENTS.md-ul cel mai apropiat = contract local; părinții = reguli globale. Un copil NU poate slăbi o constrângere a unui părinte. - Update — după orice schimbare semnificativă, actualizezi
AGENTS.md-ul care deține zona- indexul părintelui; ștergi textul învechit.
Quick Reference
# Rulare/verificare — deschide direct în browser (merge de pe file://) sau servește local:
python3 -m http.server 8000
# Teste (Playwright; fără package.json commitat — vezi tests/AGENTS.md):
npx playwright test tests/smoke.mjs # suita completă: 35/35
npx playwright test tests/smoke.mjs --grep @regresie # regresie: 16
npx playwright test tests/smoke.mjs --grep @campanie # campanie E2E: 21
Durable Rules (repo-wide)
- Zero dependențe. Produsul (fișierele
*.html) e vanilla HTML/CSS/JS, merge offline de pefile://.node_modules/,package.json,playwright.config.mjs,scratch/,test-results/sunt gitignored — doar dev tooling, nu fac parte din produs. - Un singur fișier. Toată aplicația trăiește în
escape-builder.html(~1960 linii), pe secțiuni comentate:stare·editor·preview·template-urile jocului exportat. - Dispatch.
gameHTML(cfg)rutează pecfg.stylecătre 6 motoare:gameClassic · gameTerminal · gameArcade · gameChat · gamePoint · gameCampaign. Fiecare returnează un string HTML complet, standalone. - Cod partajat = blast radius global.
libJS(cfg)(CFG,norm,checkAnswer,starsFor,finalWord,beep,confetti) șiSNIP.*(baseCss, modal, ecran final) sunt injectate în TOATE motoarele. O schimbare aici → verifică fiecare stil în preview înainte de commit. - Backslash dublu. Motoarele sunt template literals mari: backslash-urile din codul GENERAT se
dublează (
\\u0300,\\n). Codul generat foloseștevar/functionclasic — intenționat. - Sentinel
__CFG__. Templatele per stil emit__CFG__(lacfg === '__TEMPLATE__') și se injectează prin replace-FUNCȚIE, nu string — protejează$/$&din config (D1). - Demo-urile sunt generate.
exemplu-*.html= jocuri exportate din builder, unul per stil. NU le edita manual — după modificări la motoare, regenerează prin export.index.html= doar landing care leagă builder-ul + demo-urile. - Stare. Obiectul
state(titlu, poveste, culoare,style,puzzles) se persistă înlocalStoragesub cheiaescape-builder-v1; export/import ca JSON. Editorul scrie viadata-g→onChange()→ persist +refreshPreview()(debounce 400ms) care seteazăiframe.srcdoc. - Design =
DESIGN.md. Sursă unică de adevăr vizual pentru campanie (tokens:root, intro-poster, coridor, diplomă). Note „nu se repară" (violet default,system-ui, lipsa webfonturilor pefile://) sunt deliberate — consultă fișierul înainte de schimbări vizuale.
Documente conexe (conținut, nu contracte)
DESIGN.md— contract de design campanie (vizual/interacțiune).TODOS.md— board de progres durabil + backlog. Secțiunea „▶ BOARD ACTIV" sus = sursa de adevăr pentru ce e în lucru; harness task list-ul se resetează între sesiuni, ăsta nu. La START de sesiune citește board-ul; mută[ ]→[~]→[x]→[!]pe măsură ce avansezi și commit.HANDOFF.md— handoff de sesiune (efemer; direcția curentă de lucru).README.md— descriere pentru utilizatorul final.
Child DOX Index
tests/→ tests/AGENTS.md — harness Playwright (smoke/regresie/campanie E2E).scratch/→ scratch/AGENTS.md — zonă de prototipuri & QA (gitignored, efemer).