remigi

AGENT — Pla de fases del Remigi

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.

Protocol de treball de l’agent

  1. Abans de començar: llegeix aquest document i localitza la primera fase que no estigui ✅ Feta. Treballa una fase a la vegada, en ordre, tret que l’usuari digui expressament una altra cosa.
  2. Mentre treballes: marca les caselles de tasca ([ ] → [x]) a mesura que les completis i posa la fase 🔄 En curs.
  3. Per tancar una fase: han de complir-se tots els criteris d’acceptació (executa les ordres indicades i comprova-les de debò). Llavors posa la fase ✅ Feta amb la data.
  4. Problemes: qualsevol entrebanc (bug, decisió no prevista, limitació, canvi de pla) s’apunta a l’apartat Problemes trobats de la fase, amb el format: - [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.
  5. Cada lliurament: 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ó.
  6. Regles del repositori (no negociables sense parlar-ho amb l’usuari):
    • 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).
    • Les capes només depenen en aquesta direcció: 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.
    • Identificadors de codi en anglès; comentaris, docs, missatges d’error i UI en català.
    • Documentació de referència: docs/ARQUITECTURA.md, docs/REGLES.md, docs/IA-ADAPTATIVA.md. Si una fase canvia el que hi diu, actualitza-les.

Estat general

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.


Fase 1 — Estructura i motor del joc

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.

Tasques

Criteris d’acceptació (verificats)

Problemes trobats


Fase 2 — Esquelet de l’aplicació web

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.

Tasques

Criteris d’acceptació (verificats)

Problemes trobats


Fase 3 — Pantalla de partida jugable

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.

Tasques

Criteris d’acceptació (verificats)

Problemes trobats

Limitacions conegudes (per a fases següents)


Fase 4 — Cicle adaptatiu complet a la web

Estat: ✅ 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.

Tasques

Criteris d’acceptació (verificats)

Problemes trobats


Fase 5 — Experiència d’usuari i polit

Estat: ✅ Feta (2026-08-22)

Objectiu: que jugar-hi sigui còmode i agradable a ordinador i a mòbil.

Tasques

Criteris d’acceptació (verificats)

Problemes trobats


Fase 6 — Motor avançat (solver òptim i regles pendents)

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.

Tasques

Criteris d’acceptació (verificats)

Problemes trobats


Fase 7 — Desplegament

Estat: ✅ Feta (2026-08-22)

Objectiu: el joc és públic en una URL i s’hi pot jugar des de qualsevol dispositiu.

Tasques

Criteris d’acceptació (verificats)

Dos publicadors alhora: el problema que va costar més

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.

Com va anar la primera publicació

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.

Problemes trobats


El projecte, acabat

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:

Problemes trobats

(cap encara)


Millores després de les fases

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.

Explicar com s’obre ✅ Feta (2026-08-22)

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.

Qui ha jugat què ✅ Feta (2026-08-22)

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):

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).

Vermell i taronja que es distingeixin ✅ Feta (2026-08-22)

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.

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.

Problemes trobats


Taula de joc a pantalla completa, amb rivals amb cara i ulls ✅ Feta (2026-08-23)

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.

Criteris d’acceptació (verificats):

Decisions:

Problemes trobats

Botons del torn amb icona i mòbil apaïsat ✅ Feta (2026-08-23)

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.

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.

Problemes trobats

(cap: el canvi ha sortit net a la primera passada de proves)

El mòbil no girava, i el gir amb un botó ✅ Feta (2026-08-23)

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ó.

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.

Problemes trobats

Directes a la taula: menú del jugador i rivals amb nom d’usuari ✅ Feta (2026-08-23)

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.

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:

Problemes trobats

Amb el dit: lliscar desplaça, mantenir premut arrossega ✅ Feta (2026-08-23)

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.

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.

Problemes trobats

Color i integració: menú, final de partida i historial ✅ Feta (2026-08-24)

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.

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.

Problemes trobats

El marc de colors marca només l’últim moviment ✅ Feta (2026-08-24)

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.

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).

Problemes trobats

Canvi de nom: de «rummikub» a «Remigi» ✅ Feta (2026-08-24)

«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ú.

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.

Problemes trobats

(cap: el canvi ha sortit net, amb la migració coberta per tests)

Més taula, torn visible i gestos ben educats ✅ Feta (2026-08-24)

Cinc demandes del jugador i un informe d’error, en una passada:

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).

Problemes trobats

Apaïsat: la taula s’ho queda tot ✅ Feta (2026-08-25)

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.

Problemes trobats

Ordenació en apaïsat, fitxes grans a l’ordinador i adaptació tancada ✅ Feta (2026-08-25)

Tres demandes del jugador:

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.

Problemes trobats

(cap: la migració de l’estat d’ordenació i el tret auto han sortit nets)

El nivell del jugador, a la vista ✅ Feta (2026-08-25)

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.

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.

Problemes trobats

(cap)

Nivell propi i nivell dels rivals, sense confusió ✅ Feta (2026-08-25)

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).

Problemes trobats

(cap: el gruix era d’etiquetes i d’estat que no es rellegia)

Fitxes al gust i escales que s’endrecen soles ✅ Feta (2026-08-26)

Dues demandes del jugador:

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.

Problemes trobats

(cap)

Tres retocs al menú del jugador ✅ Feta (2026-08-26)

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.

Problemes trobats

Prémer una fitxa al mòbil no selecciona text ✅ Feta (2026-08-26)

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.

El repàs: quiz de les oportunitats perdudes ✅ Feta (2026-08-26)

Problemes trobats

El repàs sense repeticions i amb marcs d’origen ✅ Feta (2026-08-26)

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.

Formes per al daltonisme, quiz guiat amb correcció i desfer/refer ✅ Feta (2026-08-26)

Problemes trobats

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.

Jeroglífics de debò: interrelacionats, sense regals, i col·lecció al menú ✅ Feta (2026-08-27)

Problemes trobats

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.

Respostes alternatives bones, i el tauler del jeroglífic net ✅ Feta (2026-08-27)

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í.

El ✓ verd d’encert, i marcs fitxa a fitxa només per als bots ✅ Feta (2026-08-27)

Problemes trobats

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).

El «glitch» de robar i rebre quatre fitxes ✅ Feta (2026-08-27)

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.

Invariants del motor i actualització automàtica de l’app ✅ Feta (2026-08-27)

El motor de la IA, encapsulat i substituïble (remigi-engine) ✅ Feta (2026-08-28)

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.

Criteris d’acceptació (verificats):

Decisions:

Problemes trobats

El torn, a mida del mòbil ✅ Feta (2026-08-31)

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.»

Criteris d’acceptació (verificats):

Decisions:

Retocs demanats un cop vist a la pantalla:

Problemes trobats


Riscos coneguts (a vigilar quan toqui)


Torn cronometrat, escales i doble toc ✅ Feta (2026-09-19)

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:

Millora 2026-09-20 — fitxa nova dins del faristol ordenat:

Correcció 2026-09-20 — l’ordre per color no pot saltar a números:

Nivell entre dispositius sense compte ✅ Feta (2026-09-20)

Demanat per poder continuar amb una habilitat coherent entre mòbil, tauleta o ordinador sense Google, compte propi ni servidor de sincronització.

Doble toc amb Pointer Events — 2026-09-21

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:


Un esglaó entre Avançat i Expert, i un ajust que iguala de debò ✅ Feta (2026-10-04)

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).

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.

Problemes trobats

Nivell continu que busca l’equilibri — 2026-10-08

Estat: ✅ Feta (2026-10-08).

Problemes i decisions:

Criteris de comodins dels rivals ✅ Feta (2026-10-21)

Validació: typecheck, 295 tests (163 core + 132 web) i build correctes. Baseline regenerat a consciència: les 25 partides de referència no canvien.

La barra de l’avís de torn, també per al segon i el tercer bot ✅ Feta (2026-10-22)

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).

Problemes trobats

El joker d’una escala, a la punta que toca ✅ Feta (2026-10-22)

Validació: typecheck i tests (163 core + 135 web) correctes; tres tests nous a turnDraft.test.ts.

Problemes trobats

Actualització automàtica de cada publicació ✅ Feta (2026-10-22)

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.

El bot conserva els comodins prescindibles ✅ Feta (2026-10-23)

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.

Pas a El Tauler lliscant el dit ✅ Feta (2026-10-31)

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ó.

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.

Problemes trobats

Tres maneres de jugar: joc lliure, repte i lliga ✅ Feta (2026-11-13)

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.

Criteris d’acceptació (verificats):

Decisions:

Problemes trobats

Lliga: de la C a la B i a la A, 30 s de relax entre jornades i música composta ✅ Feta (2026-11-13)

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).

Criteris d’acceptació (verificats):

Decisions:

Problemes trobats

L’escalada de lligues, en vertical ✅ Feta (2026-11-13)

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.

Problemes trobats

Escalada al revés, noms dels bots i el marc de la fitxa robada groga ✅ Feta (2026-11-13)

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.»

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).

La partida es reprèn tal com era, i el repte s’encadena ✅ Feta (2026-11-14)

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.»

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.

Problemes trobats

La lliga comença com a mínim a la lliga del territori ✅ Feta (2026-11-14)

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.

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).

Comarques i províncies fora de Catalunya ✅ Feta (2026-11-14)

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:

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.

Rivals baixos més actius, lliga al teu nivell, divisions i mode clar/fosc ✅ Feta (2026-11-14)

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ó.»

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).

«Música composta» passa a dir-se «Música infinita» ✅ Feta (2026-11-14)

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).

Repte: la puntuació de tothom, el total acumulat i informació per jugar amb tàctica ✅ Feta (2026-11-14)

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.»

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ó.

Repte: el final de partida, simple i visual, en un carrusel de tres pàgines ✅ Feta (2026-11-14)

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ó.»

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).

Lliga: la mateixa pantalla d’entre jornades, amb dues pàgines més ✅ Feta (2026-11-14)

Demanat pel jugador: «Aplica-ho també a la lliga, però que la part principal sigui la mateixa; amb scrolling tindrà més informació.»

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.

Repte acabat, lliga sense triar jornades i el joker a les instruccions ✅ Feta (2026-11-14)

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.»

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).

Lligues dels Països Catalans sense noms castellans ✅ Feta (2026-11-14)

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.»

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.

Cognoms catalans de cada lloc i l’inici sobre el feltre ✅ Feta (2026-11-14)

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.»

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.

D’on és cada jugador, amb totes les parts de la lliga representades ✅ Feta (2026-11-14)

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.»

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.

L’inici, com en començar una partida lliure ✅ Feta (2026-11-14)

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.»

Criteris d’acceptació (verificats): captures a 390 i 1280 px, en clar i en fosc; e2e sencer.

La icona d’El Tauler a tot Remigi, fosc per defecte i el ventall de l’inici ✅ Feta (2026-11-15)

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».»

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.

Fitxes de la taula d’una mida estable ✅ Feta (2026-11-15)

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.

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.

El precursor del Rummikub®, la roda de configuració a tot arreu i canviar de mode des de la configuració ✅ Feta (2026-11-15)

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.»

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.