Dans le chapitre 11, je vous ai montré notre CI. Deux jours plus tard, le tableau de SonarCloud m'a montré ce qu'elle laissait passer.
Tout fonctionnait comme prévu. Les portes étaient exigées, les PR attendaient. Mais plusieurs portes Sonar étaient rouges sur main, et chaque fois pour la même famille de raisons : du code trop compliqué, des petites erreurs qu'un éditeur aurait pu signaler. La CI tenait la porte, mais elle la tenait trop tard. L'agent avait fini, la PR était ouverte, et c'est dix minutes plus tard qu'on apprenait que tout était à refaire.
Ce chapitre raconte le déplacement : de « la CI l'attrape » vers « l'erreur ne quitte pas l'éditeur ».
Ce que le tableau m'a montré
J'ai demandé à un agent de lire, dépôt par dépôt, pourquoi les portes étaient rouges. La réponse tenait en une phrase. Presque toutes échouaient sur le nouveau code, et presque toujours sur la complexité cognitive, la règle S3776 de Sonar : une fonction qui fait trop de choses imbriquées pour qu'on la relise sans effort.
Je n'ai pas baissé de seuil, et je n'ai rien marqué « ne sera pas corrigé ». Les fonctions ont été découpées, dépôt par dépôt, par des PR courtes. Dans krizaka-ui, ce même passage a révélé 37 bugs, dont seize tris sans fonction de comparaison. Un tri sans comparaison trie en texte : [10, 9, 1].sort() donne [1, 10, 9]. Personne ne l'avait vu parce que ça marchait presque toujours.
Je pouvais m'arrêter là. Mais en regardant la liste, je me suis dit que rien de tout ça n'avait besoin d'attendre Sonar. Une règle de lint trouve la même chose en une seconde, pendant que l'agent écrit.
La complexité, avant la PR
Le premier pas a été de faire entrer cette règle dans l'éditeur. @krizaka/config 0.11 ajoute la complexité cognitive à krizakaStack(), au même seuil que Sonar, 15. Elle s'accompagne d'un compteur dans notre cliquet : les fonctions qui dépassent déjà le seuil sont figées à leur nombre actuel, et la CI refuse d'en ajouter une seule.
Le principe est celui du chapitre 11. Mais là où le cliquet comptait nos règles maison, il compte maintenant une règle qui existe aussi chez Sonar. Ce que Sonar dira dans dix minutes, le lint le dit tout de suite.
Et le déploiement a cassé, bien sûr. En mettant à jour les dépôts, on a vu qu'une commande, krizaka-ratchet --update, effaçait en silence les compteurs qu'elle ne mesurait pas, par exemple celui des templates de page, propre à chaque dépôt. Rien n'échouait. Un compteur disparaissait, et avec lui la garde qu'il tenait. C'est krizaka-ts#163 : la commande garde maintenant ce qu'elle ne connaît pas, et le dit dans son rapport. Un test s'en charge.
C'est ce que j'ai retenu de cette première étape. Un outil qui efface une garde sans rien dire est pire qu'une garde qui manque.
Tout Sonar au lint
Une seule règle, ce n'était pas assez. 0.12 active le jeu complet de eslint-plugin-sonarjs, qui est le moteur des règles JavaScript et TypeScript de SonarCloud. Une erreur Sonar devient une erreur de lint.
Il y avait une dette, évidemment. Dans chaque dépôt, on a compté ce que la règle trouvait déjà et on l'a figé. Les nombres sont enregistrés dans le dépôt et ne peuvent que descendre, comme les autres. Je n'ai pas voulu tout corriger d'un coup, pour la même raison que pour les cliquets : la règle protège le nouveau code tout de suite, et la dette existante part petit à petit.
Pour Java, la même idée s'écrit autrement. Dans krizaka-build#107, le parent commun lance PMD et SpotBugs avec le plugin de sécurité dans verify, avec une base de départ par module. Et krizaka-build#106 ajoute à nos tests d'architecture ArchUnit des règles de sécurité écrites noir sur blanc dans un ADR.
Cette dernière étape a eu sa panne à elle. Un dépôt qui n'avait pas le fichier d'exclusions de SpotBugs cassait au premier build. krizaka-build#108 rend le fichier facultatif et ajoute un job canari, qui construit un projet vide avec le parent à chaque changement. On a appris à ne pas publier un parent sans le faire essayer par un consommateur.
Avant
- Sonar répond sur la PR, dix minutes plus tard
- Des barrières rouges sur le code neuf, presque toujours la complexité cognitive (S3776)
- Un passage sur krizaka-ui trouve 37 bugs, dont 16 tris sans fonction de comparaison
- L'agent est déjà passé à autre chose
Maintenant
- @krizaka/config 0.11 : la complexité cognitive au lint, seuil 15
- 0.12 : tout eslint-plugin-sonarjs, une erreur Sonar devient une erreur de lint
- La dette existante est comptée et gelée : elle ne fait que descendre
- Sonar reste, comme dernier filet
Les secrets et les workflows, au plus tôt
Il y a des choses qu'une CI ne devrait jamais avoir à attraper. Un secret poussé dans un dépôt, par exemple : une fois dans l'historique, il est brûlé.
.github#334 place gitleaks et zizmor au plus tôt. D'abord un hook à chaque commit, avec une seule configuration pour tous les dépôts. Ensuite un job de CI qui lit tout l'historique. Après viennent la protection de GitHub à l'envoi, puis la règle Sonar sur les secrets, en dernier filet. zizmor fait la même chose pour nos workflows, qui sont du code comme le reste et qui peuvent être attaqués comme lui.
Le premier passage sur les dépôts principaux n'a trouvé aucun vrai secret, seulement des valeurs de test et une valeur factice utilisée par la CI, que j'ai autorisées avec une raison écrite à côté.
En parallèle, j'ai fait un ménage moins glorieux. Dans les dépôts clonés sur nos machines, 88 tokens traînaient dans l'adresse du dépôt distant, là où un git remote -v les affiche à qui regarde par-dessus l'épaule. Ils n'ont fuité nulle part, à ma connaissance. Mais ils n'avaient rien à faire là. Je les ai retirés, et les agents utilisent maintenant un token qu'ils demandent au moment du besoin, jamais écrit dans une adresse.
Une seule source pour les règles
Déplacer les contrôles vers l'éditeur a un risque : chaque dépôt garde sa copie, et les copies divergent. On l'avait déjà vécu avec les fichiers de CI.
Le bon geste est le même qu'au chapitre 11. 0.13 de @krizaka/config livre le paquet de règles ast-grep partagé, ainsi que les commandes krizaka-sg-ratchet et krizaka-seo-family. Aucun dépôt ne devrait plus garder sa propre copie du cliquet ni de ses propres règles. Les versions 0.11, 0.12 et 0.13 sont sorties le même jour, le 27 octobre.
La course que personne ne voyait
Un jour, la branche main de Yomizaka est devenue rouge. Trente avertissements de lint pour un plafond de 27. Pourtant, chaque PR avait été verte quand on l'avait fusionnée.
L'explication est bête. Deux PR étaient vertes chacune sur une base ancienne. La première a fusionné et a fixé le plafond. La seconde, partie avant, a fusionné après sans refaire le contrôle sur le nouveau main, et a ajouté ses avertissements. Aucune PR n'était fautive, et la somme l'était.
La garde, c'est un réglage de GitHub : exiger que la branche soit à jour avant la fusion. Je l'ai mis sur Yomizaka, puis sur 12 dépôts, avec un petit script qui remet à jour les PR en attente de fusion automatique. J'avais d'abord cru que SonarCloud ne répondait que sur les PR. C'est vrai de son analyse automatique ; lancée par la CI, son analyse répond aussi sur les branches de la merge queue. Je l'ai vérifié sur un dépôt : la merge queue marche, Sonar compris. Alors on passe à la merge queue, qui garde la même promesse sans remettre les PR à jour à la main.
- Deux PR (vertes sur le même vieux main)Chacune est vérifiée contre le main d'où elle est partie.
- La première fusionne (le plafond passe à 27)Main est vert, avec ses avertissements de lint comptés.
- La seconde fusionne (sans nouvelle vérification)Partie plus tôt, elle fusionne sans être revérifiée sur le nouveau main, et ajoute ses avertissements.
- Main passe au rouge (30 avertissements, plafond 27)Aucune PR n'était fautive. C'était la somme.
- La garde (à jour avant de fusionner)Activée pour Yomizaka, puis 12 dépôts ; maintenant la merge queue, qui tient la même promesse, Sonar compris.
Un correctif sans garde n'est pas fini
J'ai rajouté une règle à notre CI, dans .github#336 : une PR qui corrige un bug doit ajouter un test qui l'aurait attrapé, ou une règle. Sans ça, le contrôle échoue.
La règle n'est pas une punition. Elle force la question que j'avais prise comme habitude au chapitre 11 : pourquoi les gardes ne l'ont pas vu ? Sans elle, je l'oublie, l'agent aussi.
Dans le même changement, les PR qui ne touchent que la documentation passent maintenant par une analyse Sonar légère, au lieu de relancer toute la CI. Une PR de texte n'a pas besoin d'un build Docker, mais elle a le droit d'être vérifiée.
Les deux chemins, dessinés
On m'a demandé de montrer le trajet et les dossiers, alors les voici : où passe un changement, et où vivent les gardes. Deux exemples réels, dessinés à partir des fichiers de workflow. Les flèches donnent l'ordre de l'histoire, la liste sous chaque dessin donne le détail.
D'abord Krizaka UI. Un changement va de l'éditeur jusqu'à npm.
- Éditeur (l'erreur se voit ici d'abord)Les types et les règles de lint répondent pendant que j'écris, avant tout commit.
- pre-commit (gitleaks, zizmor).pre-commit-config.yaml lance les deux hooks de l'organisation sur les fichiers indexés : un secret n'entre jamais dans l'historique, un workflow est lu avant d'être poussé. Krizaka UI n'a pas de hook pre-push ; Akinaza en a un, plus bas.
- Types, tests, build (turbo run check)Un turbo run check par paquet : lint (avec les règles ast-grep et leur cliquet), types, tests, build, la limite de taille, publint. Les captures Storybook sont comparées pixel à pixel aux références, et un échec envoie les différences en pièce jointe.
- Site de documentation (ui.krizaka.com)Build, lint, types, tests et le contrat SEO de la famille sur l'export. Puis le parcours d'un échantillon de pages, en trois tranches, et les contrôles de mise en page et de mouvement, dans un navigateur, en sombre et en clair, sur ordinateur et téléphone. Un dernier job, Documentation site (ui.krizaka.com), rend le verdict.
- Doublons, temps réel (deux jobs de plus)Le code dupliqué, tenu par dup-ratchet.json, et les adaptateurs temps réel testés contre un vrai PostgreSQL et un vrai Valkey.
- Scan de sécurité (gitleaks, zizmor)Les deux mêmes outils, cette fois sur toute la pull request. CodeQL tourne à côté, imposé par une règle de l'organisation.
- SonarCloud (analyse automatique)Pour Krizaka UI, Sonar analyse le dépôt de son côté, pas dans notre workflow, et sa réponse est exigée. Cette analyse automatique ne répond pas sur les branches de la merge queue ; l'analyse de la CI, si, et c'est pourquoi les dépôts y passent, comme krizaka-ts l'a déjà fait.
- Porte de fusion (merge queue, contrôles verts)La PR entre dans la merge queue. Les contrôles, Sonar compris, tournent sur la branche temporaire de la merge queue, puis elle fusionne.
- main (squash, historique linéaire)GitHub fusionne quand tout est vert. Personne ne pousse sur main.
- Version Packages (une PR de Changesets)Changesets garde à jour une PR « chore: version packages » avec les versions et les journaux de changements. La fusionner, c'est ce qui publie.
- Publication (npm, provenance)release.yml publie les paquets. Chacun essaie d'abord la publication de confiance OIDC de npm, avec provenance ; un token n'est qu'un secours journalisé pour un paquet qui n'a pas encore d'éditeur de confiance. Puis un job échoue si une version de main n'est pas sur npm.
Une chose n'est pas sur ce chemin : le job « un correctif a besoin d'une garde » de .github#336. Il appartient au pipeline Node partagé, et Krizaka UI garde son propre ci.yml. Je préfère le dire plutôt que dessiner une boîte qui n'existe pas.
Où vivent les gardes dans ce dépôt :
krizaka-ui/
├── .pre-commit-config.yaml gitleaks et zizmor, avant chaque commit
├── .github/workflows/
│ ├── ci.yml check, site de doc, doublons, temps réel
│ ├── security.yml gitleaks et zizmor sur la PR
│ ├── release.yml Version Packages, npm, provenance
│ └── update-baselines.yml renouvelle les références des captures
├── rules/ et sgconfig.yml les règles ast-grep
├── sg-ratchet.json leur dette, qui ne fait que baisser
└── dup-ratchet.json les lignes dupliquées, même idéeMaintenant l'application mobile des boutiques Akinaza, dans apps/mobile. C'est une application Expo, et le chemin est plus long du côté des tests.
- Éditeur (l'erreur se voit ici d'abord)Même idée : les types et le lint répondent pendant que j'écris.
- pre-commit (gitleaks, zizmor)Les deux mêmes hooks, depuis .pre-commit-config.yaml.
- pre-push (pnpm run check).githooks/pre-push aligne l'installation sur le lockfile, puis lance lint, types et tests. On ne pousse jamais pour voir ce que dit la CI.
- Lint, types, tests (Mobile CI, en parallèle)mobile-ci.yml appelle le pipeline Expo partagé : ESLint avec un plafond d'avertissements et le cliquet de apps/mobile/lint-ratchet.json, tsc, les tests Jest et l'export du bundle. Les quatre tournent côte à côte, et seulement quand l'application, les contrats qu'elle lit ou le workflow ont changé.
- mobile-e2e (Maestro sur un émulateur)Le workflow partagé construit un APK de release, démarre un émulateur Android et joue les parcours Maestro de apps/mobile/.maestro contre un backend jetable, connecté en propriétaire de la boutique de démonstration. Il rend toujours mobile-e2e / gate.
- Scan de sécurité (gitleaks, zizmor)Le même scan que les autres dépôts.
- CI gate (Sonar, garde du correctif)Le pipeline principal du dépôt tourne aussi sur la PR, avec son analyse Sonar de CI. Il porte SonarCloud après les tests, les doublons et le job « un correctif a besoin d'une garde », et rend un seul verdict, ci / CI gate.
- Porte de fusion (merge queue, contrôles verts)La PR entre dans la merge queue. Les contrôles, Sonar compris, tournent sur la branche temporaire de la merge queue, puis elle fusionne.
- main (squash)GitHub fusionne quand tout est vert.
- Vidéos vitrine (sur main, jamais exigées)Quand Mobile CI est verte sur main, download-videos.yml enregistre les parcours vitrine du web et du téléphone, et le workflow de l'organisation les envoie au CDN et ouvre une PR pour la page de téléchargement. S'il échoue, rien n'est bloqué.
Et où vivent les gardes :
akinaza/
├── .pre-commit-config.yaml gitleaks et zizmor, avant chaque commit
├── .githooks/pre-push lint, types et tests, avant chaque push
├── .github/workflows/
│ ├── mobile-ci.yml pipeline Expo et mobile-e2e
│ ├── ci.yml pipeline principal : Sonar, doublons, garde du correctif
│ ├── security.yml gitleaks et zizmor sur la PR
│ └── download-videos.yml vidéos vitrine, sur main
├── apps/mobile/
│ ├── lint-ratchet.json la dette de lint de l'application
│ └── .maestro/ les parcours (smoke, tabs, factures...)
├── rules/ et sg-ratchet.json règles ast-grep et leur cliquet
├── dup-ratchet.json lignes dupliquées
└── perf-budgets.json le budget de JavaScript du web par pageCe qui n'est pas réglé
Au moment où j'écris, trois portes Sonar sont encore rouges sur main : krizaka-ui, krizaka-blog et le dépôt .github lui-même. J'y travaille, et je ne les ai pas contournées.
Les règles Sonar qui demandent de suivre une donnée de bout en bout, les « taint », n'ont pas de jumeau local. On les voit dans l'éditeur par le mode connecté, et Sonar reste leur seule porte. Et certaines règles de types ne se déclenchent qu'avec la configuration TypeScript complète : c'est la suite.
Ce que j'en retiens
Une CI attrape les erreurs. Mais plus tard elle les attrape, plus elles coûtent, parce que l'agent a fini et que la PR est déjà ouverte. L'idée est de remonter chaque contrôle d'un cran, vers le commit, vers l'éditeur, vers la règle écrite une fois pour tous les dépôts.
Et quand un bug passe quand même, la question ne change pas : qu'est-ce qui aurait dû le voir, et où ? La réponse est une garde, jamais « faire plus attention ».
