Document de treball per a l’agent. Defineix totes les fases del projecte, en l’ordre en què s’han de fer, amb les tasques, els criteris per donar cada fase per acabada i un registre de problemes. Aquest document és l’estat de la veritat del projecte: mira’l abans de començar cap feina i actualitza’l en acabar-la.
✅ Feta. Treballa una fase a la vegada, en ordre, tret
que l’usuari digui expressament una altra cosa.[ ] → [x]) a mesura
que les completis i posa la fase 🔄 En curs.✅ Feta amb la data.- [data] Problema — com s'ha resolt (o per què queda pendent).
Si un problema es deixa per més endavant, afegeix-lo també com a tasca a la
fase que toqui.npm run typecheck i npm test en verd, commit amb
missatge descriptiu que inclogui l’actualització d’aquest AGENT.md, i
push a la branca de treball indicada per la sessió.packages/core es manté pur: sense dependències de navegador ni d’UI;
tot estat immutable i serialitzable; l’única API pública és src/index.ts
(i persistence/jsonFileStore.ts importat a banda, perquè depèn de Node).core ← ai ← engine i core ← adaptive, amb (persistence, cli, web)
al capdamunt. La IA es demana sempre a través del motor
(engine/, vegeu docs/ENGINE.md); cap codi nou no importa ai/
directament.docs/ARQUITECTURA.md, docs/REGLES.md,
docs/IA-ADAPTATIVA.md. Si una fase canvia el que hi diu, actualitza-les.| Fase | Nom | Estat |
|---|---|---|
| 1 | Estructura i motor del joc | ✅ Feta (2026-08-22, reverificada 2026-08-22) |
| 2 | Esquelet de l’aplicació web | ✅ Feta (2026-08-22) |
| 3 | Pantalla de partida jugable | ✅ Feta (2026-08-22) |
| 4 | Cicle adaptatiu complet a la web | ✅ Feta (2026-08-22) |
| 5 | Experiència d’usuari i polit | ✅ Feta (2026-08-22) |
| 6 | Motor avançat (solver òptim i regles pendents) | ✅ Feta (2026-08-22) |
| 7 | Desplegament | ✅ Feta (2026-08-22) |
Llegenda: ⬜ Pendent · 🔄 En curs · ✅ Feta (data) · ⏸️ Aturada (motiu)
La feina demanada un cop tancades les set fases s’apunta a Millores després de les fases, amb el mateix protocol.
Estat: ✅ Feta (2026-08-22)
Objectiu: monorepo amb el motor complet del joc a packages/core,
independent de la interfície, amb IA per nivells i sistema adaptatiu, tot provat.
packages/*, apps/*), TypeScript estricte.src/core/: 106 fitxes amb id únic, grups i escales
amb jokers, sortida inicial de 30 punts, reordenació de taula, robar i
passar, partida bloquejada, puntuació final. Errors com a RulesError
amb codi estable i missatge en català.applyMove retorna estat nou) i RNG amb llavor.src/ai/: un sol cercador de jugades (solver.ts) i 5 nivells
parametritzats (difficulty.ts): novell, fàcil, mitjà, avançat, expert.src/adaptive/: perfil amb Elo (K decreixent),
historial, i suggestOpponents per triar 1–3 rivals segons l’habilitat.src/persistence/: interfície KeyValueStore,
MemoryStore, JsonFileStore (Node) i ProfileRepository.npm run simulate) amb invariant de conservació.docs/.core/board.ts,
core/scoring.ts, ai/difficulty.ts, ai/aiPlayer.ts (errors “humans”
amb RNG controlat), la capa persistence/ sencera (bateria comuna per a
qualsevol KeyValueStore, JsonFileStore sobre disc i
ProfileRepository) i el contracte de src/index.ts.npm run typecheck i npm test en verd. ✔ (74/74, reverificat 2026-08-22)npm run simulate -- --games 100 acaba sempre i ordena els nivells. ✔
(Expert 59%, Mitjà 39%, Novell 2%; ~95 torns/partida)npm run simulate no reenviava els arguments: el
npm intermedi es menjava --games — resolt afegint -- final a l’script
de l’arrel (npm run simulate -w @remigi/core --).core/board.ts, ai/difficulty.ts i tota la capa persistence/ eren API
pública sense cap test. Resolt afegint-ne (38 → 74 tests).finalScores feia totalPending - 2 * pending[guanyador], de manera que en
una partida bloquejada el guanyador es penalitzava les seves pròpies
fitxes i el marcador no sumava zero (una partida d’exemple donava −36).
En victòria neta no es notava, perquè el guanyador té 0 fitxes. Resolt:
totalPending - pending[guanyador], que deixa igual la victòria neta,
quadra el bloqueig i alinea el codi amb el que ja deia docs/REGLES.md.
S’hi ha afegit l’invariant «la puntuació sempre suma zero» com a test.Estat: ✅ Feta (2026-08-22)
Objectiu: apps/web arrenca amb Vite + React + TypeScript, importa
@remigi/core del workspace i té la navegació i la persistència de base.
Encara sense partida jugable: només l’esquelet sòlid on penjar les fases 3 i 4.
apps/web (Vite 8 + React 19 + TypeScript), paquet @remigi/web,
amb @remigi/core com a dependència de workspace.main apunta a font
.ts): funciona sense àlies ni optimizeDeps — risc descartat.LocalStorageStore implementant KeyValueStore, amb createWebStore()
que comprova de debò si es pot escriure i degrada a MemoryStore si no.App.tsx, sense
router): Inici, Partida, Estadístiques.ProfileRepository sobre l’emmagatzematge del navegador.createGame real, amb els jugadors, les
fitxes de cadascun, el nivell dels bots i el sac.dev, build, preview); READMEs actualitzats.npm install net des de zero (esborrant node_modules i el lockfile);
npm run typecheck i npm test en verd. ✔ (74 core + 7 web)npm run build -w @remigi/web compila sense errors. ✔ (198 kB, 63 kB gzip)npm run dev mostra la pantalla d’inici; en recarregar, el nom del jugador
es conserva. ✔ Verificat amb Chromium (Playwright): perfil desat i recuperat,
motor repartint 14 fitxes a 3 jugadors i 64 al sac, sense errors de consola
ni desbordament horitzontal a 390 px.defineConfig importat de vite no accepta l’apartat test i
el typecheck fallava (TS2769) — resolt important-lo de vitest/config.@remigi/core
amb font TypeScript: no s’ha materialitzat. Vite el transpila com a codi
del projecte a través de l’enllaç de workspace, tant en dev com en build.
El risc queda tancat a la llista de sota.Estat: ✅ Feta (2026-08-22)
Objectiu: es pot jugar una partida sencera al navegador contra 1, 2 o 3 bots, amb totes les regles aplicades pel motor.
COLOR_LABELS per als textos d’accessibilitat).insertSmart la posa a la posició que fa vàlida la jugada.
L’arrossegar i deixar anar queda per a la Fase 5, com preveia el pla.turnDraft.ts, funcions pures); «Acabar jugada»
envia la taula sencera a applyMove dins d’un try/catch.RulesError en català i botó «Desfer canvis».decideAiMove i pausa (VITE_BOT_DELAY, 900 ms per
defecte), amb el jugador actiu ressaltat i animació a les fitxes que
acaba de baixar.finalScores, guanyador, avís si ha estat bloqueig i
botó de partida nova.apps/web/README.md.typecheck, test i build en verd. ✔ (74 core + 22 web; 212 kB, 67 kB gzip)meld, així que
comptava com una jugada més: en col·locar-hi fitxes, cadascuna anava a una
jugada nova en comptes d’ajuntar-se. Ho va destapar la prova de fer una
sortida inicial vàlida al navegador. Resolt separant-lo (new-meld sol): no
és una jugada, és el botó per crear-ne una.clearTimeout del
cleanup i una comprovació dins de setGame, que és qui té l’estat de debò.moveTile; resolt amb adjustIndex i cobert amb un test propi.insertSmart tria la primera posició que fa vàlida la jugada, que no sempre
és la que l’usuari vol en casos ambigus. L’arrossegar i deixar anar de la
Fase 5 donarà control exacte.key de cada jugada depèn de les seves fitxesEstat: ✅ Feta (2026-08-22)
Objectiu: la dificultat s’adapta de debò a l’experiència del jugador: el perfil viu al navegador, es proposa la partida segons l’Elo i cada resultat l’actualitza.
suggestOpponents
tria els nivells segons el perfil i describeSuggestion ho explica;
«Prefereixo triar-los jo» passa a manual partint de la proposta.useRecordResult la registra una sola vegada
amb els nivells realment jugats i la desa de seguida; el resultat mostra
com ha canviat l’habilitat (p. ex. «1100 → 1070 (−30)»).reset() al hook).MemoryStore, inclosa una partida jugada
de debò pel motor de punta a punta (7 tests nous, 29 en total a la web).typecheck, test i build en verd. ✔ (74 core + 29 web; 218 kB, 69 kB gzip)suggestOpponents (passar de [main-1, main] a [main, main+1]).#0d9488, que passa els sis controls sobre les dues superfícies i és
de la mateixa família.Estat: ✅ Feta (2026-08-22)
Objectiu: que jugar-hi sigui còmode i agradable a ordinador i a mòbil.
useDragTile), que
funcionen igual amb ratolí i amb dit. El «tria i col·loca» a clics de la
Fase 3 continua sent l’alternativa accessible per teclat, amb un botó
«Torna la fitxa al faristol» per al cas que el faristol sigui buit.prefers-reduced-motion.state/savedGame.ts).findRackMelds), calculada només quan està encesa.aria-live per al canvi de
torn i role="alert" per als errors, etiquetes a totes les fitxes.typecheck, test i build en verd. ✔ (74 core + 36 web; 223 kB, 71 kB gzip)touch-action: none a les fitxes, i això impedeix desplaçar la pàgina
lliscant just damunt d’una fitxa. S’ha compensat donant desplaçament propi a
la taula i al faristol, i mantenint el «tria i col·loca» a tocs, que no
necessita arrossegar gens. Queda anotat perquè és una decisió, no un descuit.Estat: ✅ Feta (2026-08-22)
Objectiu: apujar el sostre de la IA i completar les variants de regles
apuntades com a pendents a docs/REGLES.md i docs/ARQUITECTURA.md.
ai/rearrange.ts): reparteix de nou
totes les fitxes de la taula més les que calgui de la mà, quedant-se’n a
la mà les mínimes. Treballa amb recomptes per color i número (les còpies
són intercanviables) i recorre les caselles en ordre fix, de manera que
cada repartiment es genera una sola vegada. Sostre de nodes i comprovació
de la proposta abans de fer-la servir.marginFromPoints), connectat a la web des
de la puntuació final.rubberBandedMistakeRate), desactivat per
defecte i amb casella pròpia a la pantalla d’inici.docs/ actualitzats i simulador ampliat amb temps de decisió i mode duel.typecheck i test en verd. ✔ (97 core + 36 web)recordGame accepta ara boolean | GameOutcome (compatible amb
el que hi havia), decideAiMove té un quart paràmetre d’opcions, i s’hi
exporten bestRearrangement, marginFromPoints i rubberBandedMistakeRate.TILE_REMOVED) i no el
pots tocar abans d’obrir (REARRANGE_BEFORE_OPENING). No s’hi ha afegit cap
codi d’error nou: hauria estat inventar-se una restricció per tenir-la.pkill -f vite matava el propi intèrpret d’ordres, perquè la
seva línia també conté «vite». Anotat perquè no torni a passar: cal filtrar
per node.*vite.Estat: ✅ Feta (2026-08-22)
Objectiu: el joc és públic en una URL i s’hi pot jugar des de qualsevol dispositiu.
base a /rummikub/, configurable amb
BASE_PATH sense tocar codi.main, amb el desplegament oficial de Pages./rummikub/.https://segueix.github.io/rummikub/ i es van provar en un navegador:
partida sencera fins al final, habilitat 1100 → 1062, perfil conservat entre
visites, cap error de consola, bé en mòbil, manifest descarregable i joc
obrint-se amb la xarxa tallada. La resposta de la URL (200 i els fitxers
correctes sota /rummikub/assets/) es va comprovar amb curl.e2e/perfil.spec.ts,
inclosa la represa d’una partida a mitges.npm test va sortir amb codi 1, que és el que fa
fallar el pas de la CI.Amb la font de Pages en «Deploy from a branch», cada canvi a main engega dos
desplegaments: el d’aquest projecte i el generador antic de Jekyll. Els dos
publiquen al mateix lloc i guanya el que acaba l’últim.
Es va veure comparant les hores de la fusió de la PR núm. 4: el desplegament del joc va acabar a les 21:24:04 i el de Jekyll a les 21:24:11, set segons més tard. Per això el joc va aparèixer un moment i després va tornar a sortir el README.
La solució és canviar la font a «GitHub Actions», que apaga el generador antic.
El flux ho demana ell mateix amb enablement: true, però si el permís no basta
s’ha de fer des de Settings → Pages.
Símptoma per reconèixer-ho una altra vegada: el lloc publicat és el README
convertit en pàgina i, a Actions, cada canvi a main té dues execucions de
desplegament en comptes d’una.
Dues coses no es podien fer des del codi, i les va fer l’usuari: portar els
canvis a main i posar la font de Pages a «GitHub Actions».
Amb això encara no n’hi va haver prou: després de la fusió, el flux
desplega.yml constava com a registrat i actiu però no havia produït cap
execució, i el lloc continuava sent el README convertit amb Jekyll. Es va
llançar a mà (Actions → Desplega a GitHub Pages → Run workflow) i va publicar
correctament en 30 segons. Els canvis següents a main sí que l’engeguen.
vite preview compta com a serve, no com a build, així que
amb la base posada només per al build servia el lloc des de l’arrel mentre
els fitxers generats apuntaven a /rummikub/: totes les proves de
navegador fallaven de cop. Resolt aplicant la base també a preview, cosa que
a més fa que les proves comprovin exactament el que es publica.pkill -f vite matava el propi intèrpret d’ordres (la seva línia
també conté «vite»). Ja anotat a la Fase 6; aquí va tornar a passar. La manera
segura és filtrar per port: lsof -t -i:4173.main i amb la font canviada, desplega.yml figurava actiu però sense cap
execució, i el lloc seguia sent el de Jekyll. Llançant-lo a mà des d’Actions
va publicar sense problemes. Queda documentat al README perquè, si torna a
passar amb un flux acabat d’afegir, se sàpiga que la sortida és el botó «Run
workflow» i no tornar a tocar la configuració.main
engega també el generador de Jekyll, i com que acaba uns segons més tard,
sobreescriu el joc amb el README. Diagnosticat comparant les hores de les
dues execucions. Afegit enablement: true perquè el flux demani la font
correcta, i documentat el símptoma al README.ERR_CONNECTION_RESET), tot i que curl sí que hi surt.
Per verificar la publicació de debò es van baixar amb curl els fitxers que
serveix Pages, es van servir en local i s’hi van fer les proves. Comprova el
que s’ha publicat, però no el camí de xarxa; això últim es va comprovar amb
curl (codi 200 i els fitxers correctes).Les set fases estan fetes. Si es reprèn el projecte, això és el que hi ha apuntat com a següent pas natural, per ordre de profit:
ProfileRepository ja ho suporta,
només cal interfície).(cap encara)
Feina demanada un cop tancades les set fases. S’apunta aquí perquè aquest document continuï sent l’estat de la veritat, amb el mateix protocol: criteris comprovats de debò i problemes registrats.
Un jugador va provar d’obrir amb un 6 i dos 12 («sumen 30») i el joc li va respondre «en portes 0» i «una jugada necessita com a mínim 3 fitxes». Les dues coses eren certes —6+12+12 no és ni grup ni escala, i les fitxes li havien quedat en caixes separades— però cap de les dues ho explicava.
Criteris d’acceptació (verificats): dues proves de navegador noves, una per a l’explicació de l’inici i una per al cas real del jugador.
Demanat pel jugador: «marca amb un recuadre la peça que he robat a la jugada. Dona un color a cada bot i posa un marc del color del bot en el moment que posi un grup nou de peces, si aquest és modificat que perdi el color del marc o es posi el del bot que ha fet la modificació.»
Criteris d’acceptació (verificats):
npm test en verd (147 tests, 14 de nous) i npm run typecheck net.npm run test:e2e en verd: 53 proves de navegador, 10 de noves (5 × 2
projectes), en escriptori i mòbil sobre el build de producció.Decisió: qui ha jugat cada jugada no entra al motor. packages/core es
manté pur i sense estat que no siguin regles; la web ho dedueix comparant la
taula d’abans i la de després de cada moviment (apps/web/src/game/meldOwners.ts).
Demanat pel jugador: «fes que els números vermells siguin més intensos i els taronges un pel més grocs, són difícil de diferenciar a la pantalla actualment». Tenia raó i es pot mesurar: els dos colors estaven a ΔE 23, i a ΔE 6 amb daltonisme simulat, que és tant com dir el mateix color.
#cc0000), que a sobre contrasta més amb el
crema de la fitxa que abans: 5.5:1 en comptes de 4.5:1.#c47504), amb el mateix contrast d’abans (3.3:1).Criteris d’acceptació (verificats): la distància entre els dos colors passa de ΔE 23 a 46 (de 6 a 13 amb daltonisme), cap dels dos no perd contrast, i tots dos continuen lluny del blau i del negre. Comprovat també mirant-ho, amb una mà de vermells i taronges alternats en tema clar i fosc.
Demanat pel jugador: disseny en horitzontal amb el faristol a sota i la taula a sobre ocupant el màxim sense desplaçament; bots amb nom (un planter de 20-30 que canvien a cada partida) i avatar propi; i un aspecte de joc professional, sobretot la taula on es posen les fitxes.
game/bots.ts); cada partida
en tria de diferents a l’atzar. El nom viatja dins de l’estat del motor
(que només hi veu una cadena), així que les partides desades conserven els
seus rivals; l’avatar es dedueix del nom i no cal desar-lo.Criteris d’acceptació (verificats):
Decisions:
-taula). Els marcs dels bots sobre feltre són les versions
clares encara que el tema sigui clar.Demanat pel jugador: els quatre botons del torn en una sola línia amb icones estil aplicació, i que la partida s’adapti al mòbil posat en horitzontal.
components/icons.tsx, sense cap llibreria) i rètol; quan el rètol no hi
cap, s’amaga i queda la icona, com en una app. El nom accessible el porta
aria-label, així no canvia mai (i les proves tampoc).orientation: landscape i poca alçada): jugadors reduïts
a avatar i compte, faristol en una sola filera amb desplaçament
horitzontal, fitxes de taula més menudes i botons només amb icona. La
taula es queda la resta de l’alçada i la pàgina no es desplaça.Criteris d’acceptació (verificats): 60 proves de navegador en verd (3 de noves: botons en una sola línia a totes les mides amb el nom intacte, i partida encaixada al mòbil apaïsat de 851×393 amb botons de 44 px). Comprovat amb captures en escriptori, mòbil vertical i mòbil apaïsat.
Decisió: el nom dels botons viu a aria-label i el rètol visible és
decoratiu. Si el rètol s’amagués amb display: none sense aria-label, el
botó es quedaria sense nom accessible: no és una finor, és el que fa que
amagar-lo sigui possible.
(cap: el canvi ha sortit net a la primera passada de proves)
El jugador va veure que al mòbil el joc no es posava en horitzontal ni girant el telèfon, i va demanar també un botó de gir al costat dels quatre del torn, i que els noms dels bots es veiessin (en apaïsat s’havien amagat per estalviar espai).
El perquè no girava: el manifest de l’aplicació portava
"orientation": "portrait" des que es va crear, així que l’app instal·lada
quedava clavada en vertical per molt que girés el telèfon. No era cap misteri
de CSS: era una línia de configuració.
orientation: "any" al manifest: l’app gira amb el telèfon.screen.orientation.lock); als iPhone no hi és, i girar el telèfon fa
el mateix.Criteris d’acceptació (verificats): 62 proves de navegador en verd (el botó surt al projecte de mòbil i no al d’escriptori, prémer-lo no peta encara que l’emulador no pugui girar, i el recompte de botons és 5 al mòbil i 4 a l’escriptori). Captures en vertical i apaïsat amb el botó al seu lloc.
screen.orientation.lock (massa
navegadors sense suport): es comprova en temps d’execució i es tipa a mà.Demanat pel jugador: fora la pantalla d’inici (l’app entra directament a la partida), bots amb nom d’usuari i avatars més vistosos, faristol sense títol (el compte de fitxes al costat d’«Ordena») i sense «ajuda’m», i tot el que era a l’inici —nom, nivell, partida nova, historial— en un desplegable que s’obre tocant el teu jugador.
components/PlayerMenu.tsx): nom, nombre de rivals,
nivell (automàtic o fixat), «Partida nova», «Historial» i «Com es juga».Criteris d’acceptació (verificats): 60 proves de navegador en verd amb el flux nou (entrada directa, nom pel menú, partida nova des del menú, historial amb retorn, reinici que torna a crear el perfil de zero, regles dins del menú) i 102 tests de unitat. Captures de taula i menú.
Decisions:
currentSetup), perquè una partida nova des del menú quedi
ben registrada al perfil i ben desada.localStorage després de carregar era una cursa contra
els bots (que amb VITE_BOT_DELAY=0 juguen a l’instant i sobreescrivien la
partida injectada abans del reload). Resolt amb addInitScript: la llavor
s’hi posa abans que l’app arrenqui, amb un senyal perquè una recàrrega dins
de la mateixa prova no ho torni a esborrar.El jugador va topar amb un mur: amb el tacte no es podia desplaçar la taula, i
les fitxes no es podien portar a jugades que no fossin a la pantalla. La causa
era el touch-action: none de les fitxes: qualsevol lliscada que comencés
sobre una fitxa quedava segrestada per l’arrossegament — i amb la taula plena,
tot són fitxes.
touch-action: none: lliscar-hi per sobre
desplaça la taula o el faristol amb normalitat, també amb una fitxa
triada.touchmove amb un oient no passiu, que és l’única manera un cop
descartat el touch-action).Criteris d’acceptació (verificats): prova de navegador amb tocs de debò (CDP) sobre una taula de 25 jugades que no cap a la pantalla — la lliscada que comença sobre una fitxa desplaça la taula i no s’enduu res; mantenir premut aixeca la fitxa, arrossegar-la no desplaça, i la fitxa acaba dins de la jugada. 61 proves en verd.
contextmenu mentre hi ha gest en
marxa i amb user-select: none i -webkit-touch-callout: none a la fitxa.Demanat pel jugador: que el menú del jugador, la pantalla de final de partida i l’historial tinguin més color i lliguin més amb el joc.
.franja-fitxes), amb versions clares al tema fosc.Criteris d’acceptació (verificats): les 61 proves de navegador continuen en verd sense tocar-ne cap (el redisseny no canvia cap selector ni cap text que es comprovi), i captures de les tres superfícies en tema clar i fosc.
Decisió (de la guia de visualització): a les rajoles i al marcador, el color porta la identitat (vores, fons tenyits, xapes) i els números van sempre amb el color del text: el que s’ha de llegir no es tenyeix.
.stats div (especificitat 0,1,1) i les classes
.stat-* (0,1,0) no el podien guanyar. Resolt posant el valor per defecte al
pare .stats: l’herència sí que cedeix davant d’una regla pròpia de
l’element, la especificitat no.Demanat pel jugador: que el marc del color del bot surti només a les peces mogudes en el darrer moviment, i també a la jugada que baixa el jugador.
updateOwners deixa de conservar l’autoria antiga: després de cada
moviment només queden marcades les jugades noves o modificades d’aquell
moviment, atribuïdes a qui l’ha fet. Robar o passar (cap fitxa moguda) no
esborra res: l’últim moviment amb fitxes continua sent el d’abans.data-bot="0" → torquesa de taula). Tocar una jugada marcada
durant el torn li continua traient el marc a l’instant.Criteris d’acceptació (verificats): 63 proves de navegador en verd — les
del marc reescrites al comportament nou (tots els marcs de la taula són d’un
sol moviment i d’un sol color; la jugada baixada pel jugador porta el marc 0) i
13 tests de unitat de meldOwners (2 de nous: les marques d’abans s’esborren,
i un moviment sense fitxes no esborra res).
[data-bot], i quan la
jugada tocada perdia el marc, el localitzador saltava tot sol a una altra que
encara el tenia. Resolt fixant l’objectiu per posició abans de tocar-lo.«RUMMIKUB» és una marca registrada, i encara que el projecte no en faci negoci, fer servir la marca com a nom d’un joc públic pot fer creure que és l’oficial. El jugador va triar Remigi — el nom tradicional de la família del rummy—, i la descripció diu «rummy de fitxes», que és el genèric i no és de ningú.
@remigi/core i @remigi/web amb tots els
imports, ruta base /remigi/, memòria cau del service worker i claus
del navegador.rummikub:profile:local,
rummikub:game) es copien un sol cop a les noves en arrencar i
s’esborren; ningú no perd el perfil ni la partida a mitges pel canvi de
nom (storage/migrate.ts, amb tests)./remigi/. Les mencions del nom
antic al registre històric d’aquest document es queden: expliquen fets.Pendent de l’usuari: reanomenar el repositori a GitHub (rummikub →
remigi). Quan ho faci, l’adreça de Pages passa a /remigi/ tota sola (la
ruta base del build surt del nom del repositori) i cal tornar a desplegar.
L’app instal·lada al mòbil apunta a l’adreça antiga i s’haurà de tornar a
instal·lar.
(cap: el canvi ha sortit net, amb la migració coberta per tests)
Cinc demandes del jugador i un informe d’error, en una passada:
pointer: coarse).pointer-events: none) i és
decoratiu: la línia de torn ja ho anuncia als lectors de pantalla.overscroll-behavior: none.applyPlay valida cada jugada de la taula proposada abans
d’acceptar res, i ara hi ha un test de regressió que ho fixa amb el cas
exacte de l’informe (un 10 sol i una parella). El que es veia era la
còpia de treball del torn del jugador, on les fitxes soles són legals
fins a «Acabar jugada»; el que faltava era que es veiés: el marc vermell
passa a 2 px amb lluïssor, i fora de l’obertura també surt la pista que
explica què cal fer amb les jugades en vermell.Criteris d’acceptació (verificats): 157 tests i 63 proves de navegador en verd; captures de la barra lateral en apaïsat, de les fitxes soles ben marcades amb la pista nova, i de l’avís de torn sobre el build de producció (amb la pausa real de 3 segons).
.app-joc .game (0,2,0) guanyava el .game del bloc apaïsat (0,1,0) i la
graella no entrava mai — la línia de torn quedava esclafada. Resolt fent
servir el selector complet dins del bloc. Mateixa lliçó que les rajoles de
l’historial: dins d’un media query l’especificitat compta igual.Proposta demanada pel jugador (amb captura del seu mòbil): que en apaïsat la taula es vegi molt més gran i s’hi puguin veure totes les fitxes, amagant els usuaris de l’esquerra i reduint l’espai sobre el faristol i els botons.
Criteris d’acceptació (verificats): 63 proves de navegador en verd, amb la d’apaïsat reforçada (mides mínimes de la taula, tira flotant sobre el feltre, «Ordena» amagat); captures a la mida del mòbil de l’usuari (969×432) i al Pixel 5 girat, amb 9 jugades a la taula i el faristol ple.
pointer-events: none perquè el feltre de sota continuï rebent tocs, i
el menú, que n’és fill, ho heretava — no es podia clicar «Desa el nom». La
prova d’apaïsat el va caçar. Resolt retornant pointer-events: auto al menú
i al seu fons.Tres demandes del jugador:
GameScreen i es controla des de dos llocs — la
capçalera de sempre (vertical i escriptori) i el bloc compacte
.sort-mini sobre els botons (només apaïsat). Tocar l’opció activa la
desfà (torna a «com està»).auto i, quan és actiu, cada partida nova
surt de l’habilitat d’aquell moment, també des del final de partida —
que a més anuncia els rivals següents («El joc s’adapta a tu: els
pròxims rivals seran…»).Criteris d’acceptació (verificats): 64 proves de navegador en verd — les noves: l’ordenació compacta apaïsada mana de debò sobre el faristol (es comprova l’ordre de les fitxes), les fitxes de taula d’escriptori fan ≥45 px, i el final de partida anuncia els pròxims rivals.
(cap: la migració de l’estat d’ordenació i el tret auto han sortit nets)
Demanat pel jugador: veure a dalt a la dreta el nivell que té assignat, amb el nom entre parèntesis (Novell, Fàcil…), perquè es vegi pujar i baixar amb els resultats.
state/playerLevel.ts: el nivell «amb nom» del jugador és el nivell de
bot amb l’habilitat més propera a la seva, amb el mateix criteri d’empat
que el motor (en cas de dubte, el més fluix). Amb tests.Criteris d’acceptació (verificats): 66 proves de navegador i 160 tests en verd (la prova nova comprova el text exacte amb l’habilitat inicial), i captures d’escriptori i apaïsat.
(cap)
El jugador va assenyalar que en triar una dificultat no quedava clar si s’aplicava de debò, i que es barrejava el seu nivell amb el que triava. Dues arrels: el menú deia «Nivell:» a seques (semblava el nivell propi) i, en reobrir-lo, sempre tornava a mostrar «automàtic» encara que haguessis fixat una dificultat.
Criteris d’acceptació (verificats): 68 proves de navegador en verd; la nova recorre el cicle sencer — fixar Mitjà (confirmació al menú, píndola de dalt, etiqueta del bot, menú que ho recorda en reobrir-se) i tornar a l’automàtic (la píndola calla).
(cap: el gruix era d’etiquetes i d’estat que no es rellegia)
Dues demandes del jugador:
state/useTileStyle.ts) i
s’aplica amb una classe a l’arrel: tot el que és per fitxa (--tinta)
continua manant, només canvia on s’aplica el color.insertSmart
ja col·locava bé la fitxa quan la jugada resultant era vàlida; el forat
era el material d’escala a mig fer (1-2 fitxes, o desordenat), on cap
ordre no és «vàlid» i tot s’apilava per ordre d’arribada. Ara, si el que
hi ha és material d’escala (mateix color, valors sense repetir),
s’ordena per valor amb els jokers omplint forats (i els que sobren
allarguen per on es pot, 13 inclòs). Els grups no es toquen: el seu
ordre no vol dir res.Criteris d’acceptació (verificats): 165 tests (5 de nous per a l’endreçament, jokers inclosos) i 72 proves de navegador en verd — les noves: baixar 7-5-6 desordenats acaba en 5-6-7 sense marca d’error, i la tria de fitxes canvia el color del número a l’instant i sobreviu a recarregar.
(cap)
Criteris d’acceptació (verificats): 72 proves de navegador en verd — la de l’estil de fitxes comprova ara també que, amb l’invertit actiu, la mostra clàssica continua clàssica i que el botó de baix tanca el menú. Captures del menú al mòbil, a dalt i a baix.
.app-joc) porta user-select: none
(amb les variants -webkit-), -webkit-touch-callout: none i
-webkit-tap-highlight-color: transparent.input i textarea dins de la
partida tornen a user-select: text explícitament, que a WebKit
l’herència del none els deixaria sense cursor de selecció.Criteris d’acceptació (verificats): 73 proves de navegador en verd. La
nova (projecte mòbil) comprova per estil calculat que jugadors, «Ordena:» i
les jugades de la taula són user-select: none, fa un manteniment llarg de
debò (CDP, 700 ms) sobre una fitxa de la taula i confirma que no queda res
seleccionat, i que el camp del nom del menú continua sent text.
missedChances.ts): cada cop que el jugador roba (o
passa) havent-hi jugada possible, se’n guarda el moment sencer — taula,
faristol, torn, si havia obert — i la millor jugada trobada. Busca amb
chooseBestPlay sense limitacions (jokers, allargaments i reordenació:
el mateix que el nivell expert). Es desa amb la partida
(SavedGame.misses, validat com els autors) i sobreviu a recarregar..quiz-crida / .quiz-crida-neta).QuizScreen.tsx): cada oportunitat torna a posar aquella
taula i aquell faristol sobre el mateix tauler de sempre (BoardView,
feltre, faristol de fusta, tocar i arrossegar): l’intent es corregeix
amb el mateix applyMove del motor (cap regla duplicada, errors amb les
seves paraules), «Mostra la solució» ensenya la jugada en acció (les
fitxes cauen il·luminades al tauler, fitxa-revelada +
acabada-de-jugar) i el resum final compta trobades i ensenyades..quiz-cap amb pointer-events: auto).turnDraft pur, useDragTile genèric, chooseBestPlay
amb playerIndex qualsevol). La partida sintètica d’un sol jugador i sense
sac (stateFromMiss) passa per applyMove sense tocs: només createGame
exigeix 2+ jugadors.addMiss): robar
torn rere torn amb el mateix grup a la mà apuntava el mateix error cada
vegada. La identitat d’una oportunitat és el conjunt de fitxes del
faristol que baixava (missKey); es guarda el primer torn, i els
següents només si la jugada possible ha canviat (s’hi ha sumat una altra
errada o la taula permet més coses).--accent-taula, el color de les teves jugades) per a les del
faristol, daurat sòlid (--robada) per a les que ja eren a la taula i
la jugada recol·locava; les que no es movien no porten res. La regla de
«moguda» (movedBoardTileIds): una fitxa no s’ha mogut si la seva
jugada d’origen sobreviu sencera dins de la mateixa jugada nova (encara
que creixi); si s’ha desfet, totes les seves fitxes compten com a
mogudes. Els textos del quiz diuen els colors i els comptes.TileView accepta mark (‘played’ | ‘moved’, amb nota
per als lectors de pantalla) i MeldView/BoardView passen un
marks: Map. El sac de entraAmbPartida (e2e) ara es pot triar (sac).Criteris d’acceptació (verificats): 174 tests (dedupe amb creixement
d’oportunitat, allargar-no-mou, reordenació que mou l’escala sencera) i 79
proves de navegador: el camí llarg ara roba tres cops (el segon idèntic no
s’apunta: 2 al repàs, no 3) i comprova els marcs played/moved a la
trobada i a la solució; una prova nova força la reordenació (grup de sets +
escala 8-11 desfent la 7-8-9) i comprova 4 turqueses, 3 daurades i la
llegenda. Captures amb els dos marcs.
ColorShape a TileView): al racó de
dalt a la dreta, petita i en currentColor — triangle el vermell,
cercle el blau, quadrat el negre, rombe el taronja — perquè amb
daltonisme els colors també es distingeixin. En em, escala amb la
fitxa; els jokers no en porten. Les mostres del menú també la duen.useTileStyle): ara surt la fitxa de
color amb número i forma en blanc; la clàssica (crema amb número i
forma del color) queda com a alternativa. La tria desada es respecta;
la mostra predeterminada va primera al menú.--encert-taula) les fitxes amb les mateixes companyes que a la
solució (meldKeysByTile), vermell gruixut les que no; el text compta
encertades, mal col·locades i pendents. «Corregeix» (llapis) torna a
l’intent sense perdre res; cada oportunitat compta com a trobada un
sol cop (scored).history + cursor); «Desfés» i «Refés» van moviment a moviment, i
un moviment nou després de desfer estronca el que hi havia per davant.aria-label («9 blau
(baixava del faristol)»), i el selector exacte [aria-label="9 blau"] de
baixaGrup no les troba: dins del quiz les proves cliquen amb el prefix
([aria-label^="9 blau"]). El primer .rack .tile d’una partida real pot
ser un joker (sense color ni forma): les proves d’estil trien
:not(.tile-joker).Criteris d’acceptació (verificats): 174 tests i 81 proves de navegador. Les d’estil comproven el blanc per defecte, la forma a cada numèrica (14 − jokers), les mostres immunes en tots dos sentits i la persistència del clàssic triat. La del quiz fa el cicle sencer: comptador 3→2→3→2 amb desfer/refer, error del motor a mitges, «Perfecte!» amb 3 verds, grup de tres on tocava el de quatre (0 verds, 3 vermells, 1 pendent), «Corregeix» i 4 verds, i resum «2 de 2» sense comptar dos cops la corregida.
detectMissedChances, plural):
la millor jugada es parteix en grups interrelacionats — jugades de la
solució que comparteixen fitxes d’una mateixa jugada original van
juntes (union-find sobre les jugades canviades) — i cada grup és un
trencaclosques independent amb la seva solució (la resta de la taula,
intacta, també per validar-la amb el motor). Els grups d’una sola
fitxa (el quart color d’un grup, allargar una escala amb una fitxa) es
descarten: mínim 2 fitxes. Abans d’obrir no es parteix res: els 30
punts lliguen totes les jugades noves.addMiss ja treballa amb la clau del grup
(fitxes del faristol que baixa); el mateix grup en torns diferents
només s’apunta el primer cop, i si creix (s’hi suma una altra errada)
és un jeroglífic nou.useJeroglifics, remigi:jeroglifics):
cada jeroglífic nou de la partida va també a la col·lecció (dedupe per
clau, els 30 més nous). Amb 3 o més, el menú del jugador ofereix
«Jeroglífics (N)» al costat de «Partida nova»: jugar o fer
jeroglífics, en qualsevol moment; la partida continua viva a sota.QuizScreen pren closeLabel («Torna al resum» /
«Torna a la partida»).Criteris d’acceptació (verificats): 176 tests (el quart color i l’allargament d’una fitxa no són jeroglífics; dues fitxes que s’aguanten sí; grups independents separats i cadascun legal; el regal del costat no s’endú l’escala; la sortida sencera com un sol jeroglífic) i 83 proves de navegador, amb una de nova: col·lecció de 3 sembrada, «Jeroglífics (3)» al menú, se n’obre el primer i es torna a la partida.
Criteris d’acceptació (verificats): 176 tests i 85 proves de navegador, amb una de nova: l’escala de sis partida en dues de tres és «Perfecte!» amb 6 verds, sense «Corregeix» ni «Mostra la solució»; i la del jeroglífic amb recol·locació comprova que durant la prova el tauler no porta cap marc (0 daurats, 0 turqueses a la taula) i que la solució ensenyada sí.
.quiz-encert): en
resoldre un jeroglífic (legal + tantes fitxes com la millor jugada),
un gran ✓ dins d’un cercle verd apareix centrat, com l’avís de torn
(fix, sense clics, decoratiu), amb un pop d’entrada i esvaïment sol
(1,5 s). Es neteja en canviar de jeroglífic o mirar la solució.meldOwners.ts reescrit): fora els marcs de jugada sencera
(.meld.owned); ara cada fitxa que un bot acaba de posar porta el marc
del seu color individualment (.board .tile[data-bot]) — si només ha
allargat una escala, només es marca la fitxa afegida. La clau és
l’identificador de la fitxa, així que el marc la segueix encara que la
taula es reordeni o el jugador la mogui al seu torn. Les jugades del
jugador humà no es marquen (només netegen les marques velles), i robar
o passar no esborra res. El desat (SavedGame.owners) conserva la
forma [string, number][]: claus velles de jugada simplement no
casen i les partides antigues es reprenen sense marc.--marc
ja anava per selector d’atribut (.board [data-bot='N']), que serveix
igual per a fitxes que per a jugades.Criteris d’acceptació (verificats): 172 tests (updateOwners reescrit:
allargar marca només l’afegida, l’humà neteja, la reordenació del bot marca
només les de la seva mà) i 85 proves de navegador reescrites: un sol bot per
moviment i cap .meld[data-bot], les teves jugades sense marc, la partida
represa amb autors per fitxa, el marc que segueix la fitxa quan tu jugues, i
el .quiz-encert visible en resoldre (al camí normal i a l’alternatiu).
useGame.draw): amb canvis a l’esborrany
(hasChanges), robar no roba — surt l’avís «Tens fitxes a mig
col·locar: acaba la jugada o desfés els canvis abans de robar», i no
es perd ni es guanya res, com a la taula de debò. Reordenar només
fitxes de la taula (sense baixar-ne cap) no bloqueja: allà robar
restaura la taula i no toca el faristol.Criteris d’acceptació (verificats): 171 tests i 87 proves de navegador, amb la regressió nova: col·locar una fitxa, robar → avís i res no es mou (faristol 3, taula 1, torn teu); desfer canvis i robar → una fitxa i només una, amb la marca de robada.
core/test/invariants.test.ts): 5 partides
senceres simulades (3 jugadors, expert amb reordenació inclòs) i, a
cada moviment: robar dona exactament una fitxa (cap amb el sac buit) al
faristol de qui roba i a ningú més, el sac baixa d’una, i el conjunt
global de fitxes és sempre el mateix — cap duplicada, cap perduda. Si
això passa, qualsevol «m’han donat quatre fitxes» és percepció de la
interfície, no del motor.main.tsx): el registre del
service worker ara comprova si hi ha versió nova cada cop que l’app
torna a ser visible (registration.update() a visibilitychange), i
quan la versió nova pren el control (skipWaiting + claim) la pàgina es
recarrega un sol cop — la partida es desa a cada moviment, així que es
reprèn on era. El primer registre de la vida no recarrega
(hadController). Abans, una PWA oberta dies seguits no rebia mai les
correccions publicades: el probable motiu que el glitch de robar «tornés
a passar» després d’arreglat.Demanat pel jugador: abans de cap laboratori d’evolució de la IA, separar-la completament de la resta de l’app com un motor independent amb API estable, a l’estil Stockfish — sense Campió/Challenger encara, sense self-play, sense canviar ni una jugada de cap nivell.
src/engine/: createEngine({seed|rng}) amb
engine.play(state, {playerIndex, level, rubberBanding, overrides,
maxNodes}) → {move, engineVersion, level, thinkingTimeMs, nodes,
searchLimited, rearrangeUsed, foundPlay, tilesPlayed}, i
engine.analyze (millor jugada sense errors humans, determinista; l’usa
la detecció de jeroglífics). ENGINE_VERSION = "1.0.0" a version.ts.
Les implementacions segueixen modulars a ai/ — el motor és la porta,
no una còpia.stats opcional que travessa
decideAiMove → chooseBestPlay → bestRearrangement (nodes,
sostre tocat, reordenació usada, jugada trobada), i maxNodes
configurable des de fora.dist/remigi-engine.js (npm run build:engine): un únic
fitxer ESM autocontingut (esbuild, plataforma «neutral»: importar res de
Node o del navegador fa fallar el build), amb remigi-engine.d.ts i
banner de versió. Reproduïble; dist/ no es versiona.useGame fa
engine.play, missedChances fa engine.analyze, simulate.ts crea
un motor per partida (mateixa llavor → mateixa partida) i imprimeix
versió i nodes. decideAiMove/chooseBestPlay queden exportats per
compatibilitat i tests.engineRegression.test.ts les torna a jugar per l’API del motor i
exigeix el mateix moviment a cada torn (hash de trajectòria,
test/fixtures/engine-baseline.json).play ≡ decideAiMove amb el mateix RNG, diagnòstic de reordenació,
bundle en memòria sense React/DOM/Node i que juga una partida sencera
carregat com a mòdul.npm run smoke:engine -w @remigi/core):
Node pelat carrega el .js generat, hi juga dues vegades la mateixa
partida i exigeix resultats idèntics.docs/ENGINE.md (API, exemples Node i Web Worker, build,
versionat, què és públic i què intern, com regenerar el baseline) i
docs/ARQUITECTURA.md i README actualitzats.Criteris d’acceptació (verificats):
npm run typecheck, npm test (123 core + 73 web) i npm run build en
verd; npm run build:engine genera l’artefacte i smoke:engine el fa
jugar amb Node.--games 30 --seed 42 i --duel 20 --seed 7) dona
exactament els mateixos resultats abans i després de la refactorització
(mateixes victòries, mateixes puntuacions, mateixos torns), ara passant per
l’API del motor.Decisions:
createGame, applyMove,
finalScores…): el contracte estable del motor és createEngine +
ENGINE_VERSION, però un remigi-engine.js que pot fer anar partides tot
sol és el que farà possibles les simulacions massives amb Node pelat.createEngine({seed}) arrossega la
seqüència entre decisions, que és com es reprodueix una partida sencera; per
a una decisió aïllada es crea un motor nou amb la llavor.docs/ENGINE.md; fer-lo ara seria codi mort (el pitjor torn de l’expert és
~176 ms).decideAiMove de sempre amb el mateix consum de RNG.Demanat pel jugador, tot d’una tirada: «Fes que a mesura que s’hagi omplert el tauler a la versió mòbil les fitxes es vagin veient més petites per veure-les totes, fes que el jugador pugui ordenar el dock manualment. Treu el botó de robar i es robi si no has posat i dones al botó d’avançar que sempre ha d’estar actiu. Canvia color taronja per groc fort. Fes que quan es seleccioni una fitxa del dock, només es vegi la selecció d’aquesta. Posa opció de 30, 60 o 120 segons, fes que sigui visible al tauler. Quan s’acabi el temps roba i desfés el que hagi fet l’usuari si no ho ha validat. Fes que quan juguin els contrincants sigui més vistós.»
game/boardDensity.ts i game/useBoardFit.ts): després de cada canvi
de la taula es mesura si el contingut hi cap i es baixa de 3 % en 3 %
fins al primer pas que hi càpiga tot, amb un terra del 60 %; quan la
taula es buida, tornen a créixer soles. Amb això, una partida sencera
cap en un mòbil vertical sense desplaçar res, i mentre hi hagi lloc les
fitxes es queden ben grosses.game/rackOrder.ts): arrossegant
una fitxa fins al seu lloc (amb barra que diu per quin forat entrarà,
segons la meitat on la deixis) o tocant primer la que mous i després on
ha d’anar. «Per número» i «per color» deixen de ser modes: escriuen
l’ordre d’una vegada i després es continua a mà. L’ordre és una llista
d’identificadors de la vista (el motor no en sap res) i es desa amb
la partida, així que sobreviu al torn, a robar i a tancar la pestanya.#f5c518 de fitxa amb
el número gairebé negre (8,4:1) i #b58900 de tinta sobre el crema de
les clàssiques (3,1:1). La clau interna continua sent orange (és la que
hi ha desada a totes les partides), però tot el que es veu i es llegeix
diu groc.Criteris d’acceptació (verificats):
npm run typecheck net, npm test en verd (123 del motor i 105 de la
web, 32 de nous: ordre del faristol, mida de les fitxes de la taula,
rellotge i temps per torn desat) i npm run build correcte.npm run test:e2e en verd: 102 proves en escriptori i mòbil sobre el
build de producció, amb un fitxer nou (e2e/torn.spec.ts, 8 proves × 2
projectes) per al faristol a mà, el rellotge, el temps exhaurit, les fitxes
que només s’encongeixen quan ja no hi caben i l’avís de l’últim rival.Decisions:
packages/core es manté pur: com
els colors dels autors, l’ordre és informació de la pantalla, i per això viu
a GameScreen i es desa amb la partida (rackOrder), no dins de l’estat del
joc. L’esborrany del torn tampoc no el mira: només li importa quines fitxes
tens, no en quin ordre.largestFittingScale).Retocs demanats un cop vist a la pantalla:
npm run test:e2e estava vermell a main. Corregida aquí:
el nom llarg ha de contenir «Remigi» i el curt —el que queda sota la icona
de l’app— ha de ser exactament «Remigi».VITE_BOT_DELAY=0
a les proves) això passava de seguida. Ara s’apaga sol al cap de sis segons,
independentment de qui jugui.robaFinsAlFinal avançava amb pauses fixes de 20 ms i 400 voltes,
i amb una mica més de feina per moviment el pressupost no arribava al final
de la partida. Ara cada volta és un torn: el clic al botó d’avançar s’espera
sol que torni a ser el teu torn, que és més ràpid i no depèn de rellotges.@remigi/core
publica main apuntant a src/index.ts i Vite 8 el transpila com a codi del
projecte, tant en dev com en build. No calen àlies ni optimizeDeps.
Compte si algun dia es publica el paquet fora del monorepo: llavors sí que
caldrà compilar-lo i canviar main/types cap a dist.suggestOpponents tria el més fluix en
cas d’empat exacte (comportament actual del closestDifficultyIndex); és
intencionat (val més quedar-se curt que passar-se), no ho «arreglis» sense
motiu.Demanat pel jugador per fer la manipulació de fitxes més natural i evitar que un final de temps castigui una jugada que ja era correcta.
Criteris d’acceptació (verificats): CI #85 de la branca
gpt/millores-torn-escales-doble-toc en verd: npm run typecheck,
npm test, build de producció i proves de navegador Playwright.
Correcció 2026-09-20 — doble toc en mòbil:
Verificació de la correcció: CI #93 en verd, incloses les proves de navegador.
Ajust addicional 2026-09-20 — estabilitat del segon toc:
:hover que aixeca 2 px una fitxa només s’aplica a dispositius
amb hover: hover i pointer: fine; en tàctil no pot interferir amb
el segon toc.Millora 2026-09-20 — fitxa nova dins del faristol ordenat:
Correcció 2026-09-20 — l’ordre per color no pot saltar a números:
color o numero,
perquè una disposició pot coincidir accidentalment amb tots dos ordres.Demanat per poder continuar amb una habilitat coherent entre mòbil, tauleta o ordinador sense Google, compte propi ni servidor de sincronització.
https://eltauler.cat/remigi/?nivell=...&partides=...&victories=...;
mai no comparteix localhost ni una URL de GitHub Pages.click de compatibilitat,
separada del hook de gestos. Un drag, hold o lliscament no invalidava
lastTap: el toc següent podia baixar la fitxa inesperadament. A més,
dependre del click deixava el toc a mercè del retargeting del navegador.pointerup, amb tileId conservat des de
pointerdown, zona i rellotge monotònic. Es mantenen els 700 ms.findAutoMeldIndex ja resol correctament el quart 5 i les escales
parcials: no cal modificar aquesta lògica.main anterior: fallen el drag entre tocs
en escriptori i mòbil i el lliscament en mòbil (3 errors); amb la
correcció passen. No es dona per vàlid només pels tests antics.Validació: typecheck, 245 tests unitaris i build correctes; Playwright complet: 122 correctes i 8 omeses per plataforma. El Chromium estàndard no arrenca en aquest contenidor (socket restringit); execució local amb Chromium headless 153.
Millora 2026-09-21 — prioritat intel·ligent del doble toc:
Una jugadora guanyava sempre contra dos Avançats i perdia sempre contra dos Experts sense que li sortís cap jeroglífic. Mesurat amb duels de robots: el que separava els dos nivells era la reordenació de la taula, que era tot o res (Expert 100% contra Avançat; Avançat amb reordenació 100% contra Avançat), mentre que la probabilitat d’error gairebé no afebleix un bot que reordena (expert amb un 15% d’error: 48–52 contra l’expert perfecte).
rearrangeRate (proporció de torns amb reordenació) a
AiParams. L’Avançat passa a reordenar el 20% dels torns
(rearrangesTable: true); l’Expert, el 100%; la resta, mai. El 20% es va
triar simulant 0,1 / 0,2 / 0,3 (Expert 81% / 74% / 65%) i quedant-se amb
el que encaixa amb l’Elo (1600 contra 1400 → 76%).advanced).withOverrides (a difficulty.ts): una substitució que només diu
rearrangesTable vol dir sempre o mai, com abans; la fan servir
decideAiMove i el level del motor.rubberBandedRearrangeRate treu un 25% de torns
amb reordenació per cada fitxa que l’humà va endarrerit (i n’afegeix si va
davant). rubberBandedMistakeRate es manté per als nivells baixos.--ladder N (duels entre nivells consecutius, amb el que n’espera
l’Elo) i --rubber N («humà» d’Avançat contra dos experts, amb ajust i sense).ENGINE_VERSION 1.0.0 → 1.1.0 (la IA juga diferent). Baseline regenerat.IA-ADAPTATIVA.md (taula de nivells i ajust), ENGINE.md,
ARQUITECTURA.md.rearrangeRate entre nivells (138 tests al core).Validació: typecheck i tests en verd (138 core + 129 web).
npm run simulate -- --ladder 200: Fàcil–Novell 84%, Mitjà–Fàcil 99%,
Avançat–Mitjà 98%, Expert–Avançat 76% (abans 100%).
npm run simulate -- --rubber 900 --seed 9: l’«humà» guanya el 12% sense ajust,
el 12% amb l’ajust antic (només errors) i el 18% amb el nou.
maxNodes no serveix per afeblir un bot:
quan s’esgota, la reordenació es descarta sencera (Expert 100% contra un de
500 nodes). Per això la gradació és una proporció de torns i no un sostre.Estat: ✅ Feta (2026-10-08).
rating mana; els mig graons antics ja no produeixen salts de 100 punts.rating continu, errors i capacitats graduades, sense
canviar les trajectòries dels cinc nivells fixos. Força congelada amb la
partida, reutilitzada al motor, desat, historial i càlcul final.ratedGames, reinici sense esborrar totals.node --import tsx packages/core/src/cli/simulateRatings.ts 80.
640 partides completades, amb invariant de conservació de fitxes.Problemes i decisions:
tsx CLI no pot crear el seu socket IPC en aquest entorn; les simulacions
s’han executat amb node --import tsx, sense servidor IPC.
Validació: typecheck, 295 tests (163 core + 132 web) i build correctes. Baseline regenerat a consciència: les 25 partides de referència no canvien.
TurnNotice porta key={game.turn}.Validació: typecheck, 295 tests (163 core + 132 web) i 129 proves de navegador correctes. Comprovat amb Playwright sobre un build amb pausa de 2 s i tres rivals: abans, la barra dels bots 2 i 3 tenia l’animació acabada (escala 1) a 400 ms del seu torn; ara és un element nou amb l’animació en marxa (escala ≈ 0,2).
forwards),
que ja havia acabat amb el primer, no es tornava a engegar. Resolt amb la
clau del torn. No hi ha prova de navegador permanent: les proves es
construeixen amb VITE_BOT_DELAY=0 i l’avís hi dura un instant.main des del 2026-10-21 («exit code 1» a
«Instal·la Chromium»): ubuntu-latest ha passat a Ubuntu 26.04 i
Playwright 1.56.1 no hi sap instal·lar el navegador. Tipus, tests i build
passaven. Resolt fixant la feina de la CI a ubuntu-24.04; quan
s’actualitzi Playwright (la 1.64.1 ja suporta Ubuntu 26.04) es pot tornar a
ubuntu-latest.insertSmart tria, entre les posicions
vàlides, la que dona més punts: 9-10-11, 30 punts.Validació: typecheck i tests (163 core + 135 web) correctes; tres tests
nous a turnDraft.test.ts.
insertSmart agafava
la primera posició vàlida, i amb el joker és la de l’esquerra. A més, deixar
una fitxa a la seva mateixa jugada no feia res, així que no hi havia manera
de moure el joker a l’altra punta. Resolt amb les dues tasques de dalt.Validació: typecheck, 302 tests (163 core + 139 web), build i 8 proves Playwright d’actualització/publicació correctes, inclòs funcionament offline. Límit: sense connexió o amb l’app suspesa, el navegador no pot baixar una versió nova; es comprova en recuperar connexió o tornar al joc.
Validació: typecheck, 315 tests (176 core + 139 web) i build correctes.
Publicació: el domini eltauler.cat/remigi/ es construeix des de
segueix/eltauler, workflow desplega-web.yml, incorporant main de Remigi.
Cal executar també aquesta publicació; desplegar només Remigi no actualitza
el domini. Les republicacions distingeixen els artefactes per run_attempt.
Remigi i El Tauler són apps germanes (Remigi viu a eltauler.cat/remigi/).
Com Segueix! amb Segueix! Música, ara es passa d’una a l’altra lliscant el dit,
amb la mateixa animació.
src/appSwitch/appSwitch.ts (+ appSwitch.css, arrencat a main.tsx):
al mòbil (≤ 768 px), lliscar el dit cap a l’esquerra o la dreta pel mig
de la pantalla fa entrar el panell «El Tauler» (corona ♔ i nom en el
daurat d’El Tauler, sobre el feltre fosc) des del costat contrari,
seguint el dit. Passat el llindar (35 % de l’ample, mínim 110 px) diu
«Deixa anar per anar-hi» i, en deixar-lo anar, obre
https://eltauler.cat/ a la mateixa pestanya. Abans del llindar, torna..drag-layer), el gest es deixa córrer.
Oients passius: no frenen cap desplaçament.pointer-events: none). Comptador a remigi:avis-canvi-app, que no
topa amb El Tauler (comparteixen domini i localStorage). Mai a
l’ordinador.canviapp.js de segueix/eltauler (només a la
portada d’El Tauler, cap a /remigi/).Validació: typecheck i 327 tests (176 core + 151 web; 12 nous a
appSwitch.test.ts) correctes. Playwright: 139 proves correctes, entre elles
les 8 noves d’e2e/canvi-app.spec.ts amb gestos tàctils reals per CDP
(esquerra i dreta obren El Tauler; a mitges el panell entra i torna; gest curt,
vertical o des de la vora; fitxes del faristol; menú obert; avís de la mà al
mòbil i no a l’ordinador). Les proves negatives s’han comprovat traient-ne el
bloqueig: llavors fallen.
touchmove amb el touchend — una
lliscada sintètica de 150 px acabava comptant-ne ~134 i no arribava al
llindar, així que la prova del faristol passava encara que el bloqueig no hi
fos. Resolt fent-la començar a la fitxa més a la dreta i acabar a 30 px de
la vora (~280 px), i comprovant-ho traient el bloqueig.Demanat pel jugador: «Fes que quan s’obri l’app remigi apareguin tres opcions:
a l’esquerra joc lliure, partida normal. Al centre repte, on l’usuari marca un
número de partides i quan s’acabin es sumen el nombre de punts que ha fet; en
aquesta opció l’usuari pot marcar un nivell d’expertesa per a les partides. A
la dreta l’opció de lliga importada d’El Tauler, on marca el número de jugadors
per lliga i el nombre de partides per acabar la lliga; l’usuari pot decidir si
la lliga és de partides contra dos o tres adversaris; a nivell local comença a
nivell bàsic i el mundial acaba a nivell d’expert. Tres lligues A, B, C local,
comarcal, provincial… però d’A passa a C del següent nivell. Els noms, els
mateixos que a les lligues d’escacs. Tota la lògica per fer una bona lliga. Si
el jugador decideix lliure, sempre manté el nivell i el nombre d’adversaris que
havia marcat, a no ser que s’autoajusti, on el nivell seguirà on el va deixar
la darrera partida.» Disseny complet a docs/LLIGA.md.
HomeScreen.tsx), de costat també al mòbil:
joc lliure, repte i lliga, cadascuna amb el seu estat («Partida a mitges ·
torn 12», «En curs: partida 3 de 5 · +34 punts», «Lliga de Vic · Grup C ·
jornada 2/7 · 3r»). Des del menú del jugador i del final de partida es
torna a l’inici («Inici»).state/freePlay.ts, remigi:lliure): el
nombre de rivals i el nivell (automàtic o fixat) es desen a part de la
partida i sobreviuen al final de la partida i a tancar l’app. En
automàtic, la força surt de l’habilitat on la va deixar l’última partida
lliure.repte/challenge.ts, RepteScreen.tsx): 3, 5 o 10
partides, nivell de Novell a Expert, 1–3 rivals; suma dels punts de
finalScores, rècord per configuració, historial de 40 reptes, abandonar
o repetir.lliga/league.ts, LligaScreen.tsx): 7 nivells × grups C, B
i A = 21 graons de 40 punts, de Novell (800, Municipal C) a Expert (1600,
Mundial A); de la A es puja a la C del nivell següent. Rivals per partida
(2 o 3), jugadors (múltiples de la taula: 6/9/12/15 o 8/12/16) i jornades
(3–15). Calendari sencer amb llavor, que et fa trobar tots els rivals
abans de repetir-ne; resultats de les altres taules simulats amb un model
mesurat fent jugar el motor (200 partides per cel·la); punts de lliga per
enfrontament (1 per rival superat a la taula), desempats (directe,
diferència, victòries); pugen i baixen una quarta part; palmarès, final de
temporada i abandonar.nomslliga.js i localitats.js copiats com a
mòduls ES amb .d.ts; noms de lliga («Lliga Comarcal d’Osona · Grup C»),
noms i orígens dels rivals per nivell, i «On jugues?» proposat amb la
localitat de la lliga d’escacs (chess_leagueCareer.home, mateix origen a
eltauler.cat; només es llegeix).remigi:game, remigi:game:repte,
remigi:game:lliga), amb sessió per no comptar mai dues vegades la mateixa
partida de repte o jornada de lliga.botPersona).Criteris d’acceptació (verificats):
npm run typecheck net, npm test en verd (176 del motor, sense canvis, i
190 de la web: 39 de nous) i npm run build correcte.e2e/modes.spec.ts (6 proves × 2 projectes, estables repetint-les
tres vegades): les tres opcions de costat sense desbordar al mòbil; el joc
lliure que recorda 3 Experts després de recarregar sense partida; tornar a
l’inici i reprendre; un repte de 3 partides amb el total i sense moure
l’habilitat; la localitat d’El Tauler i els noms de les lligues; una temporada
sencera de 3 jornades fins a començar la següent.Decisions:
{ prefs })
però es llegien com si fossin les preferències mateixes, i la validació les
tornava als valors per defecte. Ho va caçar la prova de navegador; resolt
llegint l’embolcall i fixat amb la prova.VITE_BOT_DELAY=0) encara jugaven i la tornaven a desar.
Resolt sortint primer a l’inici, que desmunta la partida.inicials amb mides pròpies a cada lloc.exact: true.Demanat pel jugador: «Fes que de C es passi a B i després a A. Importa el
sistema de fer música il·limitada i fes el mateix estil entre partides de la
lliga que es fa en les partides de 30 segons, un minut i dos minuts per bàndol
als escacs: quan acabi una partida hi ha 30 segons de relax fins a la següent
partida. Finalment fusiona.» Detall a docs/LLIGA.md (§3 i §4).
movementText): «Puges al Grup B de la
Lliga de Vic», «Puges al Grup A…», «Puges a la Lliga Comarcal d’Osona ·
Grup C: nivell nou!». Test que recorre els 21 graons.musica/): radioambient.js d’El
Tauler copiat com a mòdul ES i carregat a demanda (16 kB comprimits, a
part). Una peça nova cada vegada, d’estil diferent i sense repetir cap de
les 200 darreres, ni tampoc les que han sonat a El Tauler (es llegeix, no
s’hi escriu). Registre «Música composta» a l’inici: escoltar en bucle,
preferides, MP3 (lamejs de cdnjs, com a El Tauler), compondre’n una de
nova, música sí/no i volum.LeagueInterlude.tsx): resultat en
curt, «JORNADA n/N» gran, compte enrere 30→0, la teva posició cara a
cara amb la dels rivals de la jornada següent i la música composta («Sona:
…», «Silencia»). A zero comença sola la jornada; «Juga ara», «Classificació»
i «Inici». El compte (i la música) s’aturen amb l’app amagada. L’última
jornada acaba amb el resum de sempre.Criteris d’acceptació (verificats):
npm run typecheck net, npm test en verd (176 del motor i 198 de la
web: 8 de nous) i npm run build correcte.inject-tauler-link-remigi.py sobre GameScreen.tsx) continua trobant la
seva marca.Decisions:
remigi:musica-registre), no el
d’El Tauler, encara que comparteixin localStorage: així cap app no omple la
llista de l’altra. Només les empremtes d’El Tauler es llegeixen, per no
repetir peces entre les dues.page.clock (rellotge simulat de Playwright), que també
fa avançar els temporitzadors del compositor.Demanat pel jugador: «Fes que el llistat de lligues es presenti en vertical i no horitzontal.»
Criteris d’acceptació (verificats): prova de navegador que comprova les 7 files, una sota l’altra i alineades, amb els noms de les lligues, els grups C, B, A en ordre i el graó actual; captures al mòbil en clar i fosc. Bateria sencera en verd.
joc.spec.ts), anterior
a aquesta feina: des que es sorteja qui comença (4e2d75b), de vegades el bot
obre abans del teu torn i la prova, que suposava la taula buida, fallava (3
de cada 20 execucions locals; a la CI la salvava el reintent). Ara espera el
teu torn i compara amb les jugades que ja hi havia: 40 de 40.spreadRatings podia passar el desplaçament de
±80 i, als graons 1, 2, 18 i 19, donar rivals de 796 o de més de 1600 (774
de 8.400 temporades generades). validSeason descartava aquestes temporades
en recarregar, amb tots els resultats. Ara el desplaçament s’encabeix a la
seva banda, la força final es limita a 800–1600 i, en carregar, una força
fora de marge es corregeix en comptes de llençar la temporada. Proves: cap
graó amb 300 llavors i tres mides surt del marge, i totes les temporades
generades es desen i es recuperen senceres.lliga/countdown.ts): en
canviar la visibilitat es torna a prendre el temps, i cap pas no descompta
més d’un segon. Proves d’unitat i de navegador (un salt de temps sense tocs
amb l’app amagada no fa començar la jornada).Demanat pel jugador: «Inverteix l’ordre: la local a baix i la mundial a dalt. Coses estètiques: Òssa va sense accent. L’usuari PolpVuitMans no hauria de ser PopVuitMans? Quan robes una fitxa groga no es veu el requadre que es veu en altres colors: és negre en lloc de groc i la part de baix està difuminada.»
OssaBruna (sense accent) i PopVuitMans. Les
partides desades amb els noms antics conserven l’avatar (RENAMED a
game/bots.ts, amb test).Criteris d’acceptació (verificats): captures de prop (×3) de la fitxa robada groga, vermella i negra, en tema clar i fosc i amb fitxes clàssiques; prova de navegador de l’escalada (mundial primera, local última, una sota l’altra); 206 tests de la web, 176 del motor, build i 155 proves de navegador en verd (17 omeses per plataforma).
Demanat pel jugador: «Fes que si un jugador surt a mitja partida d’un mode a Remigi, la partida segueixi tal com la va deixar, tant a lliure, repte o lliga. Fes que a repte les partides també s’encadenin mostrant resultats i compte enrere.»
serializeDraft) i es restaura validat contra la partida
(restoreDraft: mateix torn i jugador, exactament les mateixes fitxes,
cap fitxa de la taula al faristol); si no lliga, el torn comença net.drawnTileId) i continua marcada.useTurnClock porta el temps que queda del torn
i el desa cada segon (remigi:rellotge:<mode>); en tornar a la partida
continua per allà. De passada, obrir i tancar el menú del jugador ja no
torna a començar el torn sencer (abans sí).RepteInterlude.tsx): entre partides, 30 s de
relax com a la lliga (resultat en curt, «PARTIDA n/N», compte enrere,
total, victòries i rècord, rivals de la següent, música composta). Les
peces comunes amb la lliga són a screens/interlude.tsx.Criteris d’acceptació (verificats): el mateix recorregut real pels tres modes amb recàrrega pel mig dona ara estats idèntics abans i després (fitxa a mig col·locar, marca de robada i rellotge); 212 tests de la web (3 nous de l’esborrany, 3 del rellotge) i 176 del motor; 159 proves de navegador (17 omeses per plataforma), amb noves: represa exacta (amb recàrrega, el menú no reinicia el rellotge, i «Desfer canvis» funciona després de reprendre), el repte amb la pantalla de relax («Juga ara», «Repte» que atura el compte) i la partida següent que comença sola als 30 s (rellotge simulat). Captures en clar i fosc.
startingBudget), que també és el
que fa possible la represa.Demanat pel jugador: «Fes que comenci com a mínim a Catalunya, País Valencià…», després de la proposta de no fer començar tothom a la Lliga Local C (Novell, 800): algú de 1300 s’hi passaria unes 12 temporades guanyant rivals molt més fluixos.
START_TIER = 9: Catalana, Valenciana, Balear, Andorrana, de
la Catalunya Nord, de la Franja o Algueresa; rivals de 1160, Mitjà).placementTier,
upcomingTier): entre la C i la A d’aquesta lliga, amb els rivals uns 80
punts per sota de l’habilitat (fins a 1240: C; 1280: B; 1320: A). Qui
calibra encara (placementRating → null) comença a la C. Els Països
Catalans, l’Europea i la Mundial no es regalen.bestTier < 9): hi pugen en llegir-les (un sol cop) i la
temporada que tenien per sota es descarta per tornar-la a començar allà.Criteris d’acceptació (verificats): 217 tests de la web (5 nous: el mínim, la col·locació per habilitat, el calibratge, el descens després de la primera temporada i la migració) i 176 del motor; les 20 proves de navegador dels modes amb les expectatives noves; comprovat a Chromium amb un perfil de 1300 a Gandia («Lliga Valenciana · Grup B», rivals de 1200) i amb una trajectòria vella a la Lliga Local B (puja a la Valenciana).
Diagnòstic (2026-11-14) dels noms i dels orígens dels rivals dels nivells de
sota (levelName, rivalOrigins, dades a localitats.js, còpia d’El Tauler):
Demanat pel jugador: «Aplica proposta a Remigi i El Tauler, fusiona i fes publicar». Cap nivell no repeteix l’àrea del de sota:
originTerritory).localitats.js, nomslliga.js i
core.js d’El Tauler i copiat aquí amb el mateix convertidor (que
reprodueix exactament les còpies d’abans).Criteris d’acceptació (verificats): 220 tests de la web (3 nous: noms de les Balears, de la Catalunya Nord, d’Andorra i de l’Alguer, i rivals amb origen a tots els nivells de casa de sis territoris) i 176 del motor; El Tauler, 2.881 proves; comprovat a Chromium a les dues apps.
Demanat pel jugador: «Fes que als nivells baixos els bots tendeixin a posar alguna fitxa més perquè no s’acabi en poques rondes on ningú pot posar res. Que la lliga comenci al nivell que té el jugador, com a màxim la lliga catalana, valenciana… a la divisió que toca. Canvia Lliga A, Lliga B… per Divisió A, Divisió B. Que a totes les modalitats el perfil tingui la configuració i es pugui escollir mode fosc o clar. Si ja has començat lliga, que a la pàgina principal surti el nom de la lliga i la divisió.»
rondes.ts, forca.ts
a l’scratchpad; 40 i 300 partides): a 4 jugadors i 800, de 12 a 18 fitxes
posades per jugador, del 15% al 24% de torns amb jugada i de 16 a 19
rondes. L’ordre de força es manté (800/1000/1200: 11/34/56% de victòries;
abans 2/6/92). Baseline del motor regenerat a consciència.placementTier, placementRating): el nivell
del joc lliure automàtic (també calibrant), al graó més alt amb rivals de
la teva força o per sota, com a molt la Divisió A de la lliga del
territori. S’ha tret el mínim d’aquest matí (i la migració que hi pujava
les trajectòries).state/theme.ts): Automàtic (segueix el sistema),
Clar o Fosc, a data-theme de <html> (un script a index.html el posa
abans de pintar). El bloc Configuració (SettingsPanel: aspecte,
temps per torn i fitxes) surt al menú del jugador de la partida (lliure,
repte i lliga) i al perfil (des de l’inici, i amb «⚙️ Perfil» des del
repte i la lliga). El temps per torn és ara un valor compartit
(useSyncExternalStore): el perfil i el rellotge de la partida no es
desincronitzen.Criteris d’acceptació (verificats): 220 tests de la web i 176 del motor (baseline regenerat), build; proves de navegador noves del mode clar/fosc a totes les modalitats i del nom de la lliga a l’inici, i les de la lliga adaptades (perfil nou: Lliga Local, Divisió C).
Demanat pel jugador: «canvia música composta per música infinita». El botó de
l’inici («🎵 Música infinita») i el títol de la pantalla (MusicScreen.tsx).
La música és la mateixa: una peça nova, composta en aquell moment, cada vegada.
A El Tauler, el mateix nom a la Configuració.
Criteris d’acceptació (verificats): typecheck, tests de la web i prova de navegador de la música entre jornades (que entra pel botó nou).
Demanat pel jugador: «Al final de cada partida del repte vull saber la puntuació dels altres jugadors, per saber qui ha guanyat; i, si no és la primera, el resultat d’aquella i l’acumulat total. Així es pot jugar amb tàctica. Dona més informació interessant.»
Challenge.rivals): es trien en començar-lo i
són els mateixos a totes les partides (opponentNames); els reptes d’abans
en reben en la partida següent (withRivals).ChallengeGame.scores, per
cadires), amb les fitxes que quedaven, el guanyador, si s’ha bloquejat i
els torns. Es desa validat (si no quadra, la partida es queda amb els teus
punts).RepteStandings.tsx): entre partides, al
final i a la pantalla del repte. Primera partida: punts de cadascú i 👑;
després, partida, total acumulat i victòries, pel total. Al final, qui
guanya el repte.challengeInsights): com ha acabat
la partida, les fitxes que et quedaven, on vas i a quants punts, les
partides que queden i quant val de mitjana guanyar-ne una, i un consell.
Entre partides, «Següent: contra X i Y, nivell Mitjà».Criteris d’acceptació (verificats): 5 tests nous de la classificació (primera partida, acumulat que suma zero, informació, desat i reptes d’abans); proves de navegador del repte ampliades (el mateix rival a totes les partides, la taula entre partides amb el total des de la segona i la classificació final); captura de la classificació.
Demanat pel jugador: «Vull que sigui simplificat però molt visual a la finestra que s’obre quan acaba la partida: tres punts a baix i scroll lateral per veure més informació.»
RepteCarousel.tsx: tres pàgines amb scroll-snap (es passen fent
lliscar el dit) i tres punts a sota (es poden tocar; el de la pàgina
oberta s’allarga). 1) La partida: el guanyador en gran i barres
divergents per jugador (verd cap a la dreta, vermell cap a l’esquerra).
2) El repte: podi pel total acumulat, amb 🏆×victòries. 3)
Tàctica: challengeInsights en targetes amb icona i el rècord a batre.Criteris d’acceptació (verificats): proves de navegador del repte amb el carrusel (tres punts, pàgina activa en tocar-los i en lliscar, barres, podi amb el total, tàctica, i que no eixampla la finestra); 225 tests de la web; captures en un mòbil (390 px).
Demanat pel jugador: «Aplica-ho també a la lliga, però que la part principal sigui la mateixa; amb scrolling tindrà més informació.»
components/Carousel.tsx i components/ResultBars.tsx: el carrusel
(pàgines amb scroll-snap, tres punts, alçada de la pàgina que es veu) i
les barres del resultat, comuns al repte i a la lliga.leagueInsights: a quants punts de
l’ascens o del descens, què queda en joc i com puntua una taula). A dalt
(resultat, jornada i compte enrere) i a baix (música i botons), igual.Criteris d’acceptació (verificats): 2 tests nous (la teva taula de la jornada i la tàctica, també sense descens al primer graó); la prova de navegador de la temporada sencera passa pel carrusel (pàgina 1 la de sempre, barres, classificació i que no eixampla la finestra); 227 tests de la web; captures a 390 px.
Demanat pel jugador: «Quan acaba [el repte] també hi diu la posició que vas, però hauria de dir que ja has guanyat o la posició. A la lliga et deixa escollir les jornades però no hauries de poder: si esculls jugadors, són les jornades a jugar; com a molt, un o dos cops amb cada jugador, com anada i tornada. A les instruccions digues quants punts val un comodí i si serveix per sortir; fes el que diuen les regles del Rummikub.»
LeagueConfig.legs (1 o 2) i
leagueRounds: les jornades són les justes per trobar-te amb tots els
rivals, o el doble amb «Anada i tornada». Els desats d’abans es
conserven (vegeu docs/LLIGA.md).ComEsJuga): secció «El joker (comodí)». Com al Rummikub
—que és el que ja fa el motor—, el joker val el número que substitueix,
també per als 30 punts de la sortida (no és un valor fix de 25), i si et
queda a la mà en acabar resta 30 punts. Exemples d’escala que obre i de
grup que no arriba.Criteris d’acceptació (verificats): tests nous de configuració (voltes, desats d’abans, temporada començada que conserva les jornades) i del repte acabat; la prova de navegador de la temporada sencera comprova que no hi ha comptador i que les voltes canvien les jornades (6 → 3).
Demanat pel jugador: «Substitueix els noms i cognoms castellans de totes les lligues dins dels Països Catalans, des de les locals, a Remigi i El Tauler.»
nomsLliga.js tornat a copiar d’El Tauler (segueix/eltauler,
nomslliga.js): la barreja d’altres orígens de cada territori ja no té
noms castellans ni de l’Amèrica hispana (la seva part passa als noms del
territori), i els noms valencians i de la Franja ja no tenen formes
castellanes. Nous: isCastilianName, catalanRivalName, CATALAN_FORMS.catalanRivals (league.ts): una temporada començada amb noms
castellans els canvia per catalans del territori en carregar-la, sempre
els mateixos (llavor de la temporada); els resultats van per identificador.Criteris d’acceptació (verificats): cap nom castellà ni forma castellana del graó 0 al 14 des dels set territoris (20 llavors per graó); una temporada desada amb noms castellans es carrega amb noms catalans, la resta igual i de manera determinista; a Europa no es toca. El castellà es manté a Europa, al món i per a qui juga des de fora.
Demanat pel jugador: «Al País Valencià, Balears, Catalunya Nord i l’Alguer, a cada un posa els principals cognoms catalans del lloc, així com a les seves lligues locals. Fes que les tres targetes inicials del Remigi tinguin de fons el tauler; posa l’usuari a dalt a l’esquerra.»
nomsLliga.js tornat a copiar d’El Tauler: cognoms catalans més estesos
del País Valencià; a les Illes, els de cada illa (Mallorca, Menorca, les
Pitiüses: placeCulture); a la Catalunya Nord, en català (fora les
grafies franceses); a l’Alguer, els catalans que s’hi conserven, i els
sards (abans la majoria, com a italians) ara són la gent d’altres
orígens, en la mateixa proporció que als altres territoris..board), amb els colors de cada mode en la versió clara; el
jugador a dalt a l’esquerra i el nom del joc a la dreta.Criteris d’acceptació (verificats): test nou dels cognoms del lloc a la lliga local (Palma, Maó, Eivissa, Perpinyà, l’Alguer, Gandia); captures de l’inici a 390 i 1280 px, en clar i en fosc, amb la lliga començada.
Demanat pel jugador: «A les lligues fora de la local, indica la població de cada jugador, fent que hi hagi representació geogràfica de les diverses parts representades a la lliga.»
localitats.js i nomsLliga.js tornats a copiar d’El Tauler:
rivalOrigins dona sempre una població, repartides entre les parts de
la lliga (spreadPick); a Europa i al món, una ciutat de cada país
(COUNTRY_CITIES, cityCountry); originArea diu la part de cada
jugador (comarca, illa, territori o país).placeOf (league.ts) i la població sota el nom a la classificació,
als rivals de la jornada i entre jornades (també la teva).catalanRivalNames); i una
jornada desada es reprèn amb els noms d’ara (withOpponentNames).Criteris d’acceptació (verificats): tests de repartiment (comarques de la
província, les quatre províncies, els set territoris, ciutat · país) i de
withOpponentNames; captures de la classificació a la lliga provincial i a
la dels Països Catalans a 390 px.
Demanat pel jugador: «Quan he dit que volia que el tauler fos el fons de les tres caselles, em referia al fons de la pantalla, no de cada casella: fes que el fons inicial sigui com començar una partida lliure, però amb les tres opcions davant.»
.inici-taula, el mateix feltre de
.board, amb la marca de la casa), com la de la partida..inici-faristol, només decora), i els
botons de sempre a sota, al lloc dels de jugar.public/eltauler-192.png, sobre blanc), que obre eltauler.cat.Criteris d’acceptació (verificats): captures a 390 i 1280 px, en clar i en fosc; e2e sencer.
Demanat pel jugador: «A tot Remigi canvia la icona d’escacs per la d’El Tauler. Fes que Remigi per defecte estigui en mode fosc. Al faristol de la pàgina principal, al costat de Remigi, posa dues o tres fitxes en ventall perquè quedi clar que és com el Rummikub; i sota Remigi, «Inspirat en el Rummikub».»
appSwitch.ts) és ara la icona d’El Tauler (public/eltauler-192.png,
sobre blanc), com la de l’inici.DEFAULT_THEME a state/theme.ts i l’script
d’index.html): sense res desat, fosc; «Automàtic» també es desa (abans
era no desar res). theme-color i el fons del manifest, foscos.Criteris d’acceptació (verificats): la prova de navegador del tema comença en fosc i recorda clar, fosc i automàtic; captures de l’inici en fosc (per defecte) i en clar, a 390 i 1280 px.
Demanat pel jugador: «Fes que el tamany de les fitxes del tauler sigui harmoniós: que no es facin molt petites segons el moviment i després tornin a una mida mitjana o més gran. Que sempre es vegin a una mida, evitant passar a una mida petita.»
Mesurat en una partida real al mòbil: amb les mateixes 20 fitxes a la taula, la mida era 1 quan jugaven els rivals i 0,73 quan et tocava (i arribava a 0,52). Causes: el lloc del botó «+ Jugada nova» només es reservava al teu torn; les pistes i els errors de sota la taula li prenien alçada; i la mida tornava a créixer al mínim lloc lliure.
game/boardDensity.ts: stableScale (només s’encongeix si no hi cap,
i només torna a créixer amb lloc de sobres, GROW_MARGIN 9 %); mínim a
dos terços de la natural (MIN_SCALE 0,67, abans 0,5); en mesurar, la
partida porta .mesurant-taula i les pistes, els errors i el botó de
tornar la fitxa al faristol surten del flux (la mida no en depèn).BoardView: el lloc de «+ Jugada nova» es reserva sempre (també quan
juguen els rivals), i el botó fa l’alçada d’una jugada a la mida d’ara.Criteris d’acceptació (verificats): tests de stableScale (no rebota en
una seqüència de torns, creix quan es buida, mai per sota del mínim); la
prova de la taula plena comprova que, sense la pista, tot hi cap i que tornar
una fitxa al faristol no fa créixer les fitxes; partida real mesurada al
mòbil: 1 → 0,82 → 0,79 → 0,76 → 0,70 → 0,67, sempre baixant a poc a poc.
Demanat pel jugador: «A la pàgina principal, “el precursor del Rummikub®” en lloc d’“inspirat en”. A la icona del jugador posa sempre el senyal de configuració, del mateix estil a tota l’app. Fes que la finestra de configuració sigui més intuitiva de tancar, amb un tancament ben integrat. A la configuració posa sempre els dos modes que no s’estan jugant.»
components/PlayerAvatar.tsx: l’avatar del jugador sempre amb la roda
de configuració (.amb-config), a l’inici, la partida, el menú del
jugador, el perfil, el repte i la lliga (aquests dos, amb el xip del
jugador en comptes de «⚙️ Perfil»). La icona de la secció
«Configuració» és la mateixa roda (.icona-config).components/CloseButton.tsx: «✕ Tanca» a dalt a la dreta, sempre a la
vista (barra enganxada al menú del jugador i capçalera enganxada al
perfil), i Esc tanca (useEscapeToClose). Al perfil, també al final.
L’avís «està jugant» ja no tapa el menú obert.components/ModeSwitch.tsx: a la configuració (menú de la partida i
perfil), els altres dos modes amb el seu color i icona; des de l’inici,
tots tres. La partida que es deixa es queda desada (switchMode a App).Criteris d’acceptació (verificats): prova de navegador nova (la roda a l’inici i a la partida, «Tanca» i Esc tanquen, des del joc lliure surten repte i lliga i hi porten, des del repte surten joc lliure i lliga); captures a 390 px.