Dépannage

Un commit a été bloqué

Le hook de commit lance les contrôles dans l'ordre et s'arrête au premier échec. Lisez les dernières lignes de la sortie, qui nomment le contrôle et le fichier. Les corrections habituelles :

• Sujet de commit refusé : utilisez Conventional Commits, par exemple feat(pricing): add annual plan.
• Rappel de test : vous avez modifié la logique de src/js/ sans ajouter de test. Ajoutez-en un dans tests/.
• Format ou lint : lancez bun run format et bun run lint, puis ajoutez les corrections au commit.
• Knip : un fichier ou un export n'est plus utilisé. Supprimez-le plutôt que de l'ignorer.
• Contrôle i18n : une clé, un article ou une page n'existe que dans une langue. La sortie indique exactement lesquels.

Ajoutez une ligne SKIP_<CONTRÔLE>=<raison> au message de commit pour consigner une exception voulue. Ignorer la couverture demande aussi une entrée dans AGENT_TODO.md.

Les captures ne correspondent pas

bun run screenshots:check produit une comparaison côte à côte pour chaque image modifiée. Si le changement est voulu, acceptez-le avec :

bun run screenshots:update

Si une page supprimée a encore des images de référence, l'exécution les signale comme orphelines, et bun scripts/screenshots/screenshot.mjs --prune les supprime.

Lighthouse échoue

bun run lighthouse:check exige 90 ou plus dans chaque catégorie. Revérifiez une seule page après une correction :

bun run lighthouse:check --page=/fr/tarifs/

Les causes fréquentes sont un contraste insuffisant après un changement de thème, des images sans dimensions explicites et des textes alt manquants.

Les tests navigateur échouent localement

• Lancez d'abord bun run build : les tests utilisent la version de production dans _site/.
• Les requêtes externes inattendues sont bloquées par tests/fixtures.js. Ajoutez une réponse préparée pour tout nouvel appel d'API.
• Pour voir le navigateur, lancez bunx playwright test --headed tests/checkout.spec.js.

Le total du paiement semble faux

Les prix viennent de src/_data/plans.json dans la devise choisie, et le pourcentage du code promo s'applique avant les taxes. Pour repartir de zéro, effacez site-cart du stockage local du navigateur.