Le problème

Prenons une boutique en ligne en monorepo, pilotée par moon. Les services Symfony order et stock verrouillent leurs dépendances dans leur composer.lock, le front Vue shop dans le yarn.lock du workspace. Chaque projet hérite d'une tâche audit que la quality gate exige, comme le décrit notre article sur l'héritage de tâches moon.

Un matin, un avis de sécurité est publié sur un paquet Symfony que order et stock verrouillent tous les deux. La pull request qui ajoute un champ à Reservation passe au rouge sur l'audit, tout comme celle qui corrige un test de order. Aucune des deux n'a touché une dépendance.

L'audit n'est pas une vérification comme les autres. Le lint et les tests jugent le diff : même commit, même verdict. L'audit confronte un lockfile à une base d'avis qui change sans commit : le même commit, vert la veille, est rouge ce matin.

Sans routine, la journée tourne mal. Chacun relance son job en espérant un faux positif, ou embarque un composer update complet dans sa fonctionnalité. Quelqu'un ajoute une exception sans date, puis la tâche audit est désactivée « temporairement ».

À côté, des alertes Dependabot visent un lockfile que plus rien ne lit. L'équipe apprend à ne plus les regarder.

Les options

Sortir l'audit de la quality gate

  • Ce qu'elle règle : chaque pull request ne dépend plus que de son diff. Un job planifié sur main publie le rapport.
  • Ce qu'elle coûte : un rapport que personne n'est obligé de lire. Une fusion peut ajouter une dépendance vulnérable connue sans que rien ne la retienne.

N'auditer que ce que la pull request change

  • Ce qu'elle règle : le verdict redevient fonction du diff. Sur GitHub, dependency-review-action échoue si la pull request introduit une dépendance vulnérable.
  • Ce qu'elle coûte : les vulnérabilités déjà présentes sur main ne bloquent plus rien. Sur un dépôt privé, l'action demande une licence GitHub Advanced Security.

Bloquer au-dessus d'un seuil de sévérité

  • Ce qu'elle règle : moins d'interruptions. yarn npm audit --severity high, ou ignore-severity côté Composer, laissent passer les avis mineurs.
  • Ce qu'elle coûte : la sévérité décrit le paquet, pas votre usage. Un avis moyen sur le parseur qui lit vos requêtes compte plus qu'un avis élevé dans un outil de build.

Garder l'audit bloquant, avec une routine de remédiation

  • Ce qu'elle règle : aucune vulnérabilité connue ne reste sur main au-delà de la remédiation, et chaque exception est écrite.
  • Ce qu'elle coûte : une interruption imprévisible, à traiter vite, et une routine à connaître avant d'en avoir besoin.

Notre recommandation

Garder l'audit bloquant sur l'ensemble des lockfiles, et répondre à chaque avis par une pull request de remédiation dédiée et minimale, fusionnée en priorité.

Les pull requests bloquées ne se corrigent pas une par une. Une seule pull request, qui ne touche que les paquets signalés, les débloque toutes dès sa fusion. Quand aucune version corrigée n'existe, elle porte une exception datée à la place d'une mise à jour.

Une PR de remédiation minimale débloque d'un coup toutes les PR rouges 1. Un avis est publié la base d'avis change : aucun commit, aucun diff 2. Toutes les PR affectées passent au rouge l'audit juge le lockfile, pas le diff de la PR si une version corrigée existe 3. Une PR de remédiation dédiée et minimale les seuls paquets signalés, avec leurs dépendances 4. Fusion en priorité dans main Dependabot ferme ses alertes sur la branche par défaut 5. Les PR en attente, mises à jour, repassent au vert fusion de main ou rebase ; relancer le job ne suffit pas aucune version corrigée Exception datée ID, raison, date de revue dans la PR de remédiation Revue à la date prévue si un correctif est sorti, retour à l'étape 3 Délai d'âge minimal : un correctif trop récent attend le délai, ou il est préapprouvé à sa version exacte.

Situation Geste
Version corrigée permise par les contraintes mise à jour ciblée : composer update -w -m, yarn up -R
Version corrigée hors de la plage d'un parent résolution Yarn limitée à ce parent
Aucune version corrigée exception motivée, avec une date de revue
Alerte sur un lockfile que rien ne lit suppression du lockfile orphelin
Correctif publié il y a une heure délai d'âge minimal, ou préapprobation de la version exacte

Un paquet déprécié ou abandonné arrive lui aussi sans diff, mais il n'expose à rien de neuf le jour où il est signalé. Il ne bloque donc pas la gate : le rapport planifié sur main le liste, et les mises à jour régulières le traitent.

Nous écrivons cette routine dans le fichier d'instructions du dépôt (AGENTS.md, CLAUDE.md). Un agent de code la suit, au lieu de noyer un audit rouge dans un composer update complet.

Les compromis assumés

Une pull request peut rester rouge pour une raison qui lui est étrangère. Nous l'acceptons, à condition que la remédiation passe avant toute autre fusion. Le rouge dit une chose vraie : main contient une vulnérabilité connue.

Une résolution impose une version que le parent n'a pas testée. Nous lisons ce que le parent appelle dans le paquet, puis nous lançons build et tests. La résolution disparaît dès qu'une version du parent accepte le correctif.

Une exception est un risque accepté. Elle dit pourquoi le code n'est pas exposé, et jusqu'à quand cette analyse vaut. Sans date, elle devient permanente par oubli.

Le délai d'âge retarde aussi les correctifs. Une version corrigée publiée il y a une heure est invisible pour l'installeur. Pour un avis urgent, nous préapprouvons cette version exacte, pas tout le paquet.

Le signal qui doit faire réexaminer ces choix : des remédiations qui traînent plusieurs jours, une liste d'exceptions qui grossit, une tâche audit contournée. Le seuil de sévérité ou l'audit limité au diff redeviennent alors à évaluer.

Mise en œuvre

Les exemples utilisent Composer 2.10.2 ou plus récent, Yarn 4.18, Symfony 7.4 et moon 2.

1. Une tâche audit par projet, sans cache

Notre article sur l'héritage de tâches moon définit la tâche audit : héritée de .moon/tasks/, sans cache. Sur une pull request, elle ne tourne que dans les projets affectés. Avec runInCI: always, qui audite tous les projets, la remédiation devrait corriger Composer et Yarn s'ils sont touchés ensemble, sinon elle resterait rouge.

Par défaut, yarn npm audit ne regarde que les dépendances directes du workspace ; --recursive ajoute les transitives. Yarn 4 signale aussi les paquets dépréciés, au niveau « moderate », et --no-deprecations les sort de la gate. Côté Composer, --abandoned=report, que nous ajoutons à composer audit --locked, fait de même pour les paquets abandonnés.

2. Une remédiation Composer minimale

# services/order : mettre à jour les seuls paquets signalés
packages=$(composer audit --locked --format=json | jq -r '.advisories | keys | join(" ")')
# Liste vide : ne rien lancer, un composer update sans argument met tout à jour
[ -n "$packages" ] && composer update $packages --with-dependencies --minimal-changes
composer audit --locked

Le JSON de composer audit range les avis par nom de paquet. --with-dependencies (-w) autorise la mise à jour de leurs dépendances, sauf celles que composer.json exige directement. --minimal-changes (-m, Composer 2.7) ne les modifie que si c'est indispensable.

Les paquets listés montent à la dernière version permise ; avec Flex, extra.symfony.require (7.4.*) les garde dans la version mineure. Pendant un update, Composer refuse aussi par défaut une version visée par un avis : audit.block-insecure depuis la 2.9, policy.advisories.block depuis la 2.10.

Nous lançons la même commande dans stock : les deux services finissent sur les mêmes versions, dans la même pull request. Le diff des lockfiles se limite aux paquets signalés et à ce qu'ils exigent : il se relit vite.

3. Côté Yarn : yarn up -R, puis une résolution limitée au parent

# Racine du workspace : qui tire le paquet, puis re-résoudre toutes ses plages
yarn why vulnerable-lib -R
yarn up -R vulnerable-lib
yarn npm audit --all --recursive
yarn dedupe --check

Le rapport de Yarn donne, pour chaque avis, son identifiant numérique (ID), l'URL de l'avis GitHub et les paquets qui en dépendent. yarn up -R re-résout toutes les plages qui visent le paquet, souvent vers la plus haute version permise, et n'écrit que dans le yarn.lock. Si un parent exige encore ^3.0.0 alors que le correctif n'existe qu'en 4, la commande ne peut rien.

Il faut alors une résolution, limitée au parent :

// package.json (racine du workspace, extrait)
{
  "resolutions": {
    "parent-plugin/vulnerable-lib": "^4.0.1"
  }
}

Cette clé ne remplace que la copie tirée par parent-plugin. Une clé globale, vulnerable-lib seule, remplacerait aussi les copies d'une autre version majeure, dont l'API peut différer. Yarn accepte un seul niveau de précision : parent/dep, éventuellement avec la version du parent.

Avant la fusion, nous vérifions que l'API appelée par le parent n'a pas changé, puis moon run shop:build shop:test fait le reste. Le package.json n'accepte pas de commentaire : la raison et la condition de retrait vont dans la description de la pull request.

4. Aucune version corrigée : une exception datée

// services/order/composer.json (extrait)
{
  "config": {
    "policy": {
      "advisories": {
        "ignore-id": {
          "GHSA-xxxx-xxxx-xxxx": "Aucune version corrigée. La fonction visée ne lit que notre configuration, jamais une entrée externe. Revue le 2027-01-31."
        }
      }
    }
  }
}

Le bloc policy (Composer 2.10) accepte un identifiant GHSA, CVE ou Packagist (PKSA), avec une raison libre. Depuis la 2.11, il entre dans l'empreinte du composer.lock : composer update --lock accompagne l'exception. Yarn, lui, n'accepte qu'une liste d'identifiants :

# .yarnrc.yml (extrait)
npmAuditIgnoreAdvisories:
  # unmaintained-lib <= 2.3.1 (GHSA-xxxx-xxxx-xxxx, low) : aucune version corrigée.
  # Seul parent : un plugin de build qui ne fusionne que ses propres valeurs.
  # Revue le 2027-01-31, ou dès qu'une version corrigée sort.
  - '1234567'

Yarn compare cette liste à l'identifiant numérique que renvoie le registre npm, jamais au GHSA. Le commentaire garde donc les deux. Une revue planifiée relit les dates :

#!/usr/bin/env sh
# tools/audit-exceptions-due.sh : échoue si une exception a atteint sa date de revue
set -eu
today=$(date +%F)
due=$(grep -hoE 'Revue le [0-9]{4}-[0-9]{2}-[0-9]{2}' .yarnrc.yml services/*/composer.json \
  | awk -v today="$today" '$3 <= today { print $3 }')
if [ -n "$due" ]; then
  echo "Exceptions d'audit à revoir : $due"
  exit 1
fi

Ce script tourne dans le job planifié sur main, pas dans la gate. Une date dépassée y rendrait rouges toutes les pull requests le même jour : exactement le problème de départ.

5. Chasser les lockfiles orphelins

Le graphe de dépendances de GitHub reconnaît package-lock.json, yarn.lock et composer.lock, et Dependabot alerte sur ce qu'ils déclarent. Un package-lock.json oublié dans un front géré par Yarn ne sert à aucune installation, mais produit des alertes. À l'inverse, le lockfile d'un outil sans tâche audit cache de vraies vulnérabilités à la gate.

#!/usr/bin/env sh
# tools/check-lockfiles.sh : chaque lockfile suivi doit être lu par une tâche audit
set -eu
unexpected=$(git ls-files '*composer.lock' '*package-lock.json' '*pnpm-lock.yaml' '*yarn.lock' \
  | grep -vxE 'yarn\.lock|services/[a-z-]+/composer\.lock' || true)
if [ -n "$unexpected" ]; then
  echo "Lockfiles sans tâche audit : $unexpected"
  exit 1
fi

Ce contrôle dépend du diff : il a sa place dans la gate. Chaque fichier signalé est supprimé si rien ne le lit, ou rattaché à un projet qui l'audite. Dependabot ne marque l'alerte comme corrigée qu'après une modification sur la branche par défaut, donc après la fusion.

6. Un délai d'âge minimal, et une porte pour les correctifs

# .yarnrc.yml (extrait)
npmMinimalAgeGate: 3d
npmPreapprovedPackages:
  # Correctif de GHSA-xxxx-xxxx-xxxx, publié avant la fin du délai.
  # Revue le 2027-01-31 : retirer une fois le délai passé.
  - '[email protected]'

npmMinimalAgeGate (Yarn 4.10.0, 18 septembre 2025) écarte toute version plus jeune que ce délai. Depuis Yarn 4.15.0 (19 mai 2026), il vaut un jour par défaut, mais un projet existant garde l'ancien comportement à la montée de version. Nous l'écrivons donc, avec trois jours : les 72 heures pendant lesquelles npm permet de dépublier un nouveau paquet.

Le revers : un correctif plus jeune que le délai est invisible, et yarn up -R garde la version vulnérable. npmPreapprovedPackages exempte une version exacte (paquet@version), de façon visible dans le dépôt ; --no-time-gate (Yarn 4.15) lève le délai pour une seule commande. Côté PHP, Composer 2.11.0 (29 octobre 2026) ajoute une politique cooldown, avec des exceptions par paquet et l'option --no-cooldown.

7. Débloquer les pull requests en attente

Une fois la remédiation fusionnée, relancer le job d'une pull request bloquée ne suffit pas. GitHub rejoue le même GITHUB_SHA, le commit de fusion calculé avant le correctif. Il faut mettre la branche à jour, par fusion de main ou rebase.

Si la branche modifie elle aussi un lockfile, nous rejouons sa commande (composer require, yarn add) après le rebase. Résoudre le conflit à la main produit un lockfile que personne n'a calculé.

Checklist

  • Une tâche audit par projet, sans cache, exigée par la quality gate.
  • Les paquets dépréciés ou abandonnés signalés sans bloquer (--no-deprecations, --abandoned=report).
  • Une pull request de remédiation dédiée, fusionnée avant les autres.
  • Des mises à jour ciblées : composer update <paquets> -w -m, yarn up -R <paquet>.
  • Des résolutions limitées à leur parent, retirées dès que le parent suit.
  • Des exceptions motivées et datées : GHSA ou CVE pour Composer, identifiant numérique npm pour Yarn.
  • Une revue planifiée des dates d'exception, hors de la gate.
  • Chaque lockfile suivi lu par une tâche audit, contrôlé à chaque pull request.
  • Un délai d'âge minimal explicite, et la préapprobation d'une version exacte pour un correctif urgent.
  • Les branches bloquées mises à jour depuis main, pas seulement relancées.

Sources

Versions relevées le 15 novembre 2026 : Composer 2.11.2, Yarn 4.18.1.