Les choix d’ingénierieDécisions d’architecture3 min de lecture
0014 · Un catalogue de versions, un jour d’attente
Chaque dépendance commune a une seule version. Elle doit être publiée depuis au moins un jour, avec au moins autant de garanties que la précédente.
Statut : acceptée, après quatre renversements du délai · Décidée : 18 octobre 2026 · Sources : 5ace2c3af6, db54071ff9, c1a94ce6dd, 075114c262, 90ccdfd846, 2d30456682, d30dfaebac, pnpm-workspace.yaml
Contexte
Trois applications et leurs paquets doivent partager une seule version de React, de Next, de Zod ou de Prisma. Et chaque dépendance installée est une porte d’entrée. Le délai avant d’installer une nouvelle version a changé quatre fois : sept jours le 23 août 2026 (5ace2c3af6), retiré le 29 août (db54071ff9), rétabli le 7 septembre (c1a94ce6dd), retiré le 17 octobre (075114c262), puis fixé à un jour le 18 octobre, avec le catalogue de versions (90ccdfd846).
Contraintes
- Deux copies de React dans le même build cassent les hooks. Deux versions de Zod ou de Prisma divergent sans prévenir.
- Une version compromise publiée sur npm s’installe au premier
pnpm installqui la résout. - Un correctif urgent, pour la sécurité ou pour un plantage en prod, ne doit pas attendre.
- Aucune CI ne relit une montée de version (ADR 0010).
Alternatives
- Des versions écrites dans chaque
package.json. Chaque montée se ferait à plusieurs endroits, avec des écarts possibles. - Pas de délai, et c’est la relecture qui décide. On l’a essayé du 29 août au 7 septembre, puis le 17 octobre.
- Un délai de sept jours. On l’a essayé deux fois, et en une semaine il a bloqué six montées d’un coup (
2d30456682).
Décision
Les versions communes s’écrivent une fois, dans le catalogue de pnpm-workspace.yaml, et les applications les prennent avec catalog:. minimumReleaseAge refuse une version publiée depuis moins d’un jour, sauf les exceptions déclarées dans minimumReleaseAgeExclude (Next et ses paquets, plus kysely@0.29.7, une exception de correctif que le lock n’utilise plus : il résout kysely@0.29.9). trustPolicy: no-downgrade refuse une version publiée avec moins de garanties de provenance que les précédentes, sauf trustPolicyExclude. Et seules les dépendances listées dans onlyBuiltDependencies lancent un script d’installation.
Raisons
Confirmées
- J’ai retiré le délai le 29 août : « la relecture d’une version fraîche se fait à la PR, pas par l’attente » (
db54071ff9). Le flux par PR s’est arrêté le 17 septembre (ADR 0010). - Une exception de provenance se justifie dans le commit qui l’ajoute. C’est le cas de
chokidar, « publié par son mainteneur unique, sans provenance » (d30dfaebac).
Hypothèses
- Le délai est d’un jour parce qu’une version compromise est le plus souvent repérée et retirée peu après sa publication. C’est la raison donnée après coup. Le commit du 18 octobre n’en donne pas.
- Le délai a été retiré le 17 octobre parce qu’il fallait installer tout de suite le correctif amont du plantage d’Astro sur Vercel, livré dans le même commit (
075114c262). - Next est exempté du délai pour que ses correctifs de sécurité passent le jour même.
Compromis
- Un correctif d’une dépendance qui n’est pas exemptée attend un jour.
- Les exceptions et les versions forcées (
overrides) sont des listes de plus à relire à chaque montée. - Le délai et la provenance ne protègent pas d’une version malveillante qui reste en ligne plus d’un jour.
Conséquences
- Une montée de version se fait à un seul endroit, et chaque build n’embarque qu’une copie de React.
- Les licences sont contrôlées à chaque vérification (
check-licenses.mjs), et les secrets sont cherchés dans chaque commit poussé (Sécurité).
Risques résiduels
- Avec l’exemption de Next, la dépendance la plus centrale passe le jour même. Une version compromise de Next s’installerait sans délai. Il n’y aurait que la politique de provenance (
trustPolicy) pour l’arrêter. - Une version commune casse partout en même temps, parce que le catalogue fait monter les trois applications ensemble (ADR 0001).
Quand la revoir
- Si des versions compromises restaient en ligne plus d’un jour dans l’écosystème que le dépôt installe, on allongerait le délai. En échange, on retrouverait les montées groupées que le délai de sept jours avait provoquées (
2d30456682). - Si l’exemption de Next devenait la porte d’entrée d’une attaque, Next aurait le délai lui aussi. Ses correctifs attendraient un jour, et il aurait la même garde que le reste.
- Pour un correctif urgent d’une autre dépendance, une exception temporaire vaudrait mieux qu’une exemption durable. On l’ajoute dans le commit qui installe le correctif, et on la retire au suivant. Celle de
kysely@0.29.7n’a pas été retirée.