Le codeQualité et livraison5 min de lecture
Contrôles Git
Les hooks du commit et du push, le contrôle qui vérifie chaque commit envoyé en prod, les attestations pour pousser sans une garde, et ce que GitHub et pnpm ajoutent.
Husky installe trois hooks (prepare de package.json, dossier .husky/). Le premier corrige, le deuxième contrôle le message, et le troisième décide de ce qui part en prod.
Au commit
pnpm exec lint-staged
if command -v gitleaks >/dev/null 2>&1; then
gitleaks git --pre-commit --staged --no-banner --redact
else
printf '\033[33m⚠ gitleaks absent : scan de secrets ignoré (brew install gitleaks)\033[0m\n'
filint-staged (dans package.json) passe ESLint, avec ses corrections et à zéro avertissement, puis Prettier. Les deux ne tournent que sur les fichiers indexés, chacun avec la configuration de son application ou de son paquet. Ensuite, gitleaks cherche des secrets dans l’index. S’il n’est pas installé, le commit passe avec un avertissement, parce que le push le rattrapera.
commit-msg passe commitlint. Le commit doit être conventionnel, et s’il a une portée, ce doit être un module ou un sujet transverse connu (MODULE_SCOPES, CROSS_CUTTING_SCOPES, commitlint.config.ts).
La porte du push
Le hook .husky/pre-push ne vérifie que les pushes vers main, la seule branche qui se déploie. Voilà ce qu’il refuse, dans cet ordre :
- Une base inconnue. Si le
maindistant n’existe pas en local, le hook ne peut pas savoir ce que le push change. Il demande donc d’abord ungit fetch. - Une migration qui n’a pas été jouée. Un push qui touche
packages/db/prisma/migrations/est refusé sans attestation. Avec une attestation, le hook cherche, pour chaque migration touchée, le reçu quedb:pre-deployécrit pour la production : son nom et l’arbre git de son dossier au commit poussé. Un essai sur une autre base n’en laisse pas, et une migration retouchée après son reçu n’a plus le même arbre (Migrations Prisma). - Un secret. gitleaks parcourt les commits poussés avec les règles du projet (
.gitleaks.toml). S’il n’est pas installé, le push est bloqué : « Sans CI, ce scan est le dernier avant GitHub : un secret poussé est grillé, même effacé ensuite. » - Des dépendances différentes de celles du commit. Le hook crée un worktree détaché sur le commit poussé, et il refuse si son
pnpm-lock.yamlne correspond pas à l’installation. Dans ce worktree, les paquets du workspace sont reliés à leur version du commit poussé, et non à celle de l’arbre de travail. - Un client Prisma qui ne se génère pas, ou des paquets ou des jumeaux en échec (
packages:check,scripts/check-twins.mjs). - Une doc qui cite un fichier, un symbole ou un identifiant que le dépôt n’a plus (
scripts/check-doc-references.mjs). Il suffit d’un renommage dans l’ERP ou le site pour la déclencher. - Une erreur de types que
next buildrelèverait sur Vercel, dans l’ERP puis dans le site. Le hook lancetypecheck:build, c’est-à-diretsc6: TypeScript 6, le paquettypescriptque le build charge.pnpm typechecklancetsc, qui est TypeScript 7. Il est plus rapide, mais c’est un autre compilateur, et il a laissé passer une erreur que le build a refusée. - Une preuve Postgres en échec, quand le push touche du code qui parle à la base.
DATABASE_URLdoit pointer vers une base locale, etSHADOW_DATABASE_URLaussi quandprisma/change. Le hook lance alorsdb:checksiprisma/change (il vide la base d’ombre, y rejoue les migrations et la compare au schéma), puisprisma migrate deploysur la base locale, puistest:dbde l’ERP et du site. - Un lint ou un test en échec : ESLint de chaque application, puis Vitest sur ce qui a changé et sur les suites
test/etregression(Tests). - Un site trop lourd, quand le push touche ce qui entre dans son bundle. Le hook fait le build du site en priorité basse et passe
apps/site/scripts/check-bundle-size.mjs. - Des variables Vercel incomplètes, pour l’ERP puis pour le site. Celles du site ne se vérifient que si
apps/siteest lié à son projet sur le poste, sinon le contrôle saute sans rien dire (check:vercel-env, Déploiement sur Vercel).
Le worktree est supprimé à la fin, que le push parte ou non.
Les attestations
Avec trois variables, on peut pousser sans passer la garde correspondante. Elles servent aux cas que le poste ne peut pas prouver :
| Variable | Garde passée | Preuve demandée |
|---|---|---|
MIGRATION_JOUEE=1 | migration non jouée | le reçu de production de db:pre-deploy, pour le contenu de chaque migration |
MIGRATION_JOUEE=sans-recu | pareil, migration jouée ailleurs | aucune, et c’est dit clairement |
TEST_DB_JOUE=1 | preuve Postgres | aucune |
POIDS_JOUE=1 | build et poids du site | aucune |
La fonction attest du hook enregistre chaque attestation dans meublesmoriniere-attestations.log, à la racine du dépôt Git commun. Elle note l’heure, l’attestation, l’utilisateur, le commit, ce qu’elle couvre et le reçu. Si la ligne ne peut pas s’écrire, le push n’est pas bloqué, mais le hook le signale.
Le hook a lui-même son test
apps/erp/test/main-push-guard.regression.test.ts lit le hook et vérifie plusieurs choses : qu’il contrôle le commit poussé dans un worktree détaché, qu’il contrôle aussi le site, qu’il relie les paquets au commit poussé, qu’il ne laisse passer aucun cas sans le dire (base inconnue, reçu absent, dépendances d’un autre commit), qu’il nettoie son worktree, et que ses attestations laissent une trace qu’on peut relire. Ce test est dans test/, donc il tourne à chaque push.
Côté GitHub et pnpm
.github/CODEOWNERSdéclare un propriétaire pour tout le dépôt. Il est aussi nommé à part pour les hooks, les paquets, le schéma et les migrations, les seeds de l’ERP, les schémas de validation et lesnext.config.ts.- Dependabot (
.github/dependabot.yml) est réglé suropen-pull-requests-limit: 0. Aucune CI ne vérifie une pull request, et une fusion sur GitHub déploie la prod. Du coup, il n’ouvre que les correctifs de sécurité, que cette limite ne bloque pas. - pnpm (
pnpm-workspace.yaml) refuse à l’installation une version publiée trop récemment (minimumReleaseAge). Il refuse aussi une version publiée avec moins de garanties que les précédentes (trustPolicy: no-downgrade). Les exceptions sont nommées. pnpm audit:prodcherche les vulnérabilités graves dans les dépendances de production. Je le lance à la main.
Les limites
Un hook, ce n’est qu’un programme local. git push --no-verify le saute, et une fusion faite sur GitHub ne passe pas par lui. C’est pour ça que le README demande de fusionner en local, puis de pousser. En plus, il vérifie avec les outils du poste. Il faut donc que gitleaks soit installé, qu’un Postgres local soit migré et rempli, et que le CLI Vercel soit authentifié et lié aux deux projets.