Skip to content

feat: série gelée + Jack Frost au profil, ?v= et CACHE_VERSION par empreinte, sous-agents - #230

Merged
CodeByHaamza merged 8 commits into
developfrom
feat/serie_gelee_assets_agents
Nov 11, 2026
Merged

CodeByHaamza merged 8 commits into
developfrom
feat/serie_gelee_assets_agents

Conversation

@CodeByHaamza

@CodeByHaamza CodeByHaamza commented Oct 20, 2026 •

Copy link
Copy Markdown
Owner

Remplace #229 : même contenu, sur une branche renommée, plus deux commits de cache.

Pourquoi

Trois idées de Hamza du 2026-10-20 (n° 1, 4 et 5), plus l'audit qui va avec dans AMELIORATIONS.md.

En creusant la n° 5, j'ai trouvé un vrai bug : le bouton Jack Frost du profil ne s'affichait pour personne. Il testait streak === 0, une valeur que le jeu n'écrit jamais. Avant que le joueur rejoue, la série locale comme global_streak gardent l'ancienne valeur : le profil affichait « 15 🔥 » pour une série morte. Après, profileStats.js la remet à 1.

Quoi

Joueur

  • Une série cassée apparaît gelée 🧊 sur le profil, avec son nombre de jours intact.
  • Juste dessous : « ❄️ Appeler Jack Frost — retour à N jours », qui ouvre la pop-up existante. Pendant le cooldown, le profil affiche à la place « 🧊 Jack Frost se repose — de retour dans N jours ».
  • Hors ligne, les pages retrouvent leurs CSS/JS en cache, même versionnés.

Technique

  1. feat(profile) : getRecoverableStreak() (pure, testée) distingue frozen (dernière partie avant hier, jours Paris) et broken (trace previousStreak).
    • Connecté, rien n'est proposé avant le premier pull cloud : un profil local venu d'un autre appareil brûlerait le crédit de 60 jours.
    • La récupération pose lastPlayed à aujourd'hui, comme le serveur, sinon la partie suivante recassait la série.
    • Le profil relit ses stats sur personadle:streak-recovered, sinon le prochain saveProfile() réécrivait l'ancienne série.
  2. chore(assets) : scripts/stamp_assets.js remplace version-all.sh et les ?v=1…21 écrits à la main. Le ?v= devient le sha256 du contenu, sur 8 caractères.
    • Le script ne versionne jamais les import, ni un module d'entrée qu'un autre module importe : js/api.js existerait sinon en deux instances.
    • Tamponné à la release, pas à chaque commit, pour éviter des conflits sur ~16 pages.
  3. chore(assets) : CACHE_VERSION de sw.js calculé (empreinte des images/sons/polices servis en cache-first) : on ne le bumpe plus à la main. Le repli hors ligne tente aussi l'URL sans ?v=.
  4. docs(agents) : 5 sous-agents dans .claude/agents/ et le protocole du superviseur au §14 de CLAUDE.md.
  5. docs : DEV_CHANGELOG 2.3, audit du 2026-10-20, chiffres de doc.

CI : assets:refs tourne sur toutes les PR (aucune page ne cite un fichier absent) ; assets:check seulement sur les PR vers main.

Vérifications

  • npm test (1577/1577) · npm run lint · npm run i18n:check · npm run docs:check · npm run pools:check · npm run data:check · npm run assets:check
  • E2E non lancé en local (Docker Hub a refusé le téléchargement des images, limite de requêtes) : c'est le job CI e2e qui fera foi
  • Rendu vérifié en mobile 390×844 (Chromium, clair) : tuile gelée, bouton, cooldown, pop-up, retour après récupération. Sombre et desktop pas capturés

Selon le type de changement

  • i18n — clés EN d'abord, puis les 5 autres langues
  • État dérivé — chemins d'écriture de stats.streak / lastPlayed tracés (profileStats, cloud-sync, streak-recovery)
  • Config partagée (CI) — deux étapes ajoutées à ci.yml, la seconde conditionnée à main

Docs

  • PersonaDLE 2.3/DEV_CHANGELOG.md — entrée du 2026-10-20
  • PersonaDLE_Update.html — section « ❄️ Série gelée » FR + EN
  • CLAUDE.md §7, §8, §14 ; DEPLOY.md (étape assets:stamp, qui remplace le bump de CACHE_VERSION)

Angles morts

  • Serveur inchangé : personadle_apply_streak_recovery() fait déjà GREATEST(global_streak, ?) et date la série d'aujourd'hui.
  • CACHE_VERSION est lu dans l'index git : il faut stager les médias avant assets:stamp (écrit dans la checklist).
  • Les dépendances d'un module d'entrée ne sont pas versionnées : c'est le no-cache du .htaccess qui les garde à jour.
  • Le .gitignore versionne désormais .claude/agents/ (réversible en une ligne).

…tée de clic

Le bouton Jack Frost du profil ne s'affichait pour personne : il testait
streak === 0, valeur que le jeu n'écrit jamais. Avant de rejouer, la série
locale comme global_streak gardent l'ancienne valeur (le profil affichait
« 15 🔥 » pour une série morte) ; après, profileStats.js la remet à 1.

getRecoverableStreak() (profile-format.js) distingue la série gelée (dernière
partie avant hier, jours Paris) de la série cassée puis repartie (trace
previousStreak). La tuile passe en glace, et sous les stats : le bouton qui
ouvre la pop-up Jack Frost, ou le nombre de jours avant son retour si le
cooldown de 60 jours court (recoveryCooldownDaysLeft()).

- Connecté, rien n'est proposé avant le premier pull cloud : un profil local
  d'un autre appareil ferait passer une série vivante pour gelée, et un clic
  brûlerait le crédit pour rien.
- La récupération pose stats.lastPlayed à aujourd'hui, comme le serveur
  (global_streak_date) : sinon une série récupérée encore gelée était recassée
  par la partie suivante.
- Le profil relit ses stats sur personadle:streak-recovered : sans ça la tuile
  restait gelée et le prochain saveProfile() réécrivait l'ancienne série.
- streak_recovery.profile_btn réécrite dans les 6 langues (« 0 → N » était
  faux) ; deux clés ajoutées.
Les ?v= des pages étaient tenus à la main (de ?v=1 à ?v=21) et la moitié des
balises n'en portait pas ; version-all.sh mettait le même numéro partout.
scripts/stamp_assets.js réécrit le ?v= de chaque JS/CSS cité par une page avec
le sha256 (8 caractères) de son contenu : il ne change que si le fichier change,
là où un SHA de commit ferait tout retélécharger à chaque déploiement.

- Jamais les specifiers d'import, ni un module d'entrée importé ailleurs :
  x.js?v=a et x.js sont deux modules pour le navigateur. js/api.js, chargé en
  <script type="module"> par compendium/friends/leaderboard et importé par tout
  le reste, aurait existé en deux instances (jeton CSRF, utilisateur courant).
- Tamponné à la release, pas à chaque commit : sinon deux branches qui
  touchent global.css se disputent ~16 pages en conflit. La CI vérifie partout
  qu'aucune page ne cite un fichier absent (assets:refs), et n'exige des ?v= à
  jour que sur les PR vers main (assets:check). Étape ajoutée à DEPLOY.md.
- Les 16 pages sont tamponnées ici, comme point de départ.
Cinq agents dans .claude/agents/ — persona-data (datasets, lore,
multi-wielders, pools), frontend (JS/CSS/i18n/responsive), backend-php (API,
migrations, déblocages serveur), test-qa (tests manquants + batterie
complète) et reviewer (lecture seule, diff confronté aux §4, §7, §9, §13).

Le superviseur est la session principale, pas un sixième agent : un
sous-agent ne peut pas en lancer un autre. C'est aussi la seule main qui
commit, ce qui tient la règle « aucune signature d'outil » à un seul endroit.
Déroulé d'un lot (cadrer, produire, prouver, relire, livrer) au §14 de
CLAUDE.md, avec le garde-fou : une tâche courte se fait sans délégation.

.gitignore passe de .claude/ à .claude/* + !.claude/agents/ : les agents sont
partagés, les réglages personnels restent ignorés.
- DEV_CHANGELOG 2.3 : entrée du lot (série gelée, ?v= par empreinte,
  sous-agents), avec ses décisions et ses angles morts.
- AMELIORATIONS.md : les deux chantiers à trancher — Cemantix/Pédantix en
  salle à part (pré-calcul hors ligne obligatoire pour le sémantique, texte
  jamais envoyé en clair pour l'article masqué) et la navigation mobile
  mesurée en 390×844 (la saisie de Classique est sous la barre du bas au
  premier écran) — puis les suggestions restantes, priorisées.
- Chiffres de doc recalculés par docs:fix (1572 tests, 87 suites, 1316 clés).
… les fichiers versionnés

Le bump manuel de CACHE_VERSION était un piège déjà payé (CLAUDE.md §7) : sans
changement de valeur, activate ne purge rien et les joueurs déjà venus gardent
les anciennes images. assets:stamp y pose désormais l'empreinte (index git) des
fichiers servis en cache-first — images, sons, polices — et la CI la vérifie
sur les PR vers main avec le reste des tampons.

Hors ligne, networkFirstWithFallback cherchait global.css?v=<empreinte> alors
que le précache stocke global.css : il tente maintenant l'URL exacte, puis la
même sans query string. Le cache-first garde la correspondance exacte.
profile-page.js : la série gelée de cette PR et la grille sans trou de #247
cohabitent. buildStreakItem() prend la largeur décidée par pairStatTiles()
et l'état gelé ; une série gelée n'est jamais pleine largeur d'office.
admin/index.html garde les polices locales de #233 et le ?v= par empreinte ;
sw.js garde le CACHE_VERSION calculé par assets:stamp.

Le test de stamp_assets devient portable sous Windows (basename() au lieu de
split("/")). L'entrée de changelog et la section joueur passent en 2.4, sans
la partie outillage local retirée du dépôt, et .claude/ redevient ignoré en
entier.
Après le merge de #234 : changelog 2.4 et chiffres de doc.
@CodeByHaamza
CodeByHaamza merged commit 6d90c1a into develop Nov 11, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant